feat(eventToShortText): label each composite field, snap to nearest stop

formatComposite now emits 'Field: Value' for each present field (e.g.
'Height: High · Firmness: Soft · Openness: Open') so the tooltip names
the dimension. For continuous numeric values that fall between option
stops (e.g. Mira imports stored at 0.13, 0.62), snap to the nearest
stop's localised label instead of showing the raw decimal — so the
text reads 'Low' / 'Medium' / 'High' regardless of the source method's
precision.

New tests EST19c (off-stop snap) and EST19d (mid-range → Medium).

Author: perki

tests/eventToShortText.test.js

@@ -322,14 +322,14 @@ describe('[ESTX] eventToShortText', () => {
     assert.equal(result, 'Ibuprofen — 400 mg, oral');
   });
 
-  it('[EST19] cervix-position composite joins selected option labels', () => {
+  it('[EST19] cervix-position composite labels each field', () => {
     const event = {
       content: { height: 1.0, firmness: 0.0, openness: 0.5 },
       streamIds: ['body-vulva-cervix-position'],
       type: 'cervix-position/3d-vectors'
     };
     const result = eventToShortText(event);
-    assert.equal(result, 'High · Firm · Medium');
+    assert.equal(result, 'Height: High · Firmness: Firm · Openness: Medium');
   });
 
   it('[EST19b] cervix-position composite skips missing fields', () => {
@@ -339,7 +339,27 @@ describe('[ESTX] eventToShortText', () => {
       type: 'cervix-position/3d-vectors'
     };
     const result = eventToShortText(event);
-    assert.equal(result, 'Low');
+    assert.equal(result, 'Height: Low');
+  });
+
+  it('[EST19c] cervix-position composite snaps continuous values to nearest stop', () => {
+    const event = {
+      content: { height: 0.13, firmness: 0.07, openness: 0.02 },
+      streamIds: ['body-vulva-cervix-position'],
+      type: 'cervix-position/3d-vectors'
+    };
+    const result = eventToShortText(event);
+    assert.equal(result, 'Height: Low · Firmness: Firm · Openness: Closed');
+  });
+
+  it('[EST19d] cervix-position composite snaps mid-range to Medium', () => {
+    const event = {
+      content: { height: 0.45, firmness: 0.6 },
+      streamIds: ['body-vulva-cervix-position'],
+      type: 'cervix-position/3d-vectors'
+    };
+    const result = eventToShortText(event);
+    assert.equal(result, 'Height: Medium · Firmness: Medium');
   });
 
   // ─── Convertible: mood ───────────────────────────────────────────

ts/HDSModel/eventToShortText.ts

@@ -201,9 +201,15 @@ function formatSlider (content: any, itemDef: any): string {
 
 /**
  * Format a composite event by walking the itemDef's `composite` block. Only
- * applies when every field is a `select` with options — joins the localised
- * option labels with " · ". Used e.g. for `body-vulva-cervix-position`
- * (`{ height, firmness, openness }` → "High · Soft · Open").
+ * applies when every field is a `select` with options — emits "Field: Label"
+ * for each present field, joined by " · ". The field label uses the
+ * composite entry's localised `label`; the value resolves to the option's
+ * localised label when a discrete match exists, otherwise falls back to the
+ * raw value (e.g. continuous imports stored at non-canonical numeric values).
+ *
+ * Used e.g. for `body-vulva-cervix-position` so tooltips read
+ * "Height: High · Firmness: Soft · Openness: Open" — the dimension is named
+ * even when the imported value falls between option stops.
  *
  * Falls through to `formatObject` for free-form composites (e.g.
  * medication/basic with `name`/`doseValue`/`doseUnit`/`route`) so existing
@@ -222,13 +228,31 @@ function formatComposite (content: any, itemDef: any): string | null {
   for (const field of fieldKeys) {
     const value = content[field];
     if (value === undefined || value === null) continue;
-    const opt = composite[field].options.find((o: any) => o.value === value);
+    const fieldDef = composite[field];
+    const fieldLabel = typeof fieldDef.label === 'string'
+      ? fieldDef.label
+      : (localizeText(fieldDef.label) || field);
+    // Prefer exact option match; for continuous numeric values that fall
+    // between stops (e.g. Mira imports), snap to the nearest option so the
+    // tooltip shows a meaningful label instead of a raw number.
+    let opt = fieldDef.options.find((o: any) => o.value === value);
+    if (!opt && typeof value === 'number') {
+      let nearest: any = null;
+      let bestDist = Infinity;
+      for (const o of fieldDef.options) {
+        if (typeof o.value !== 'number') continue;
+        const d = Math.abs(o.value - value);
+        if (d < bestDist) { bestDist = d; nearest = o; }
+      }
+      opt = nearest;
+    }
+    let valueText: string;
     if (opt?.label) {
-      const text = typeof opt.label === 'string' ? opt.label : (localizeText(opt.label) || String(value));
-      parts.push(text);
+      valueText = typeof opt.label === 'string' ? opt.label : (localizeText(opt.label) || String(value));
     } else {
-      parts.push(String(value));
+      valueText = String(value);
     }
+    parts.push(`${fieldLabel}: ${valueText}`);
   }
   return parts.length > 0 ? parts.join(' · ') : formatObject(content);
 }