Catalogue upgrade: movement metadata, filterable gallery, +12 movements

Inspired by standard exercise-dataset taxonomy (used only as a coverage/schema
yardstick — no third-party media or records copied; all movements authored and
ROM-validated here).

- Metadata: extend Preset with bodyPart / target muscle / equipment / difficulty
  and backfill all presets, so the library is tagged like an exercise DB.
- Filterable gallery: Area / Gear / Level filters in the playground that narrow
  the Example dropdown (options derived from the data), with a live match count.
- Coverage-gap batch (docs/coverage-gap.md): 12 new body-weight/prop movements
  filling the biggest renderable holes — plank-hold, mountain-climber, crunch,
  bicycle-crunch, lying leg raise, superman, forward-lunge, step-up, single-leg
  calf raise, triceps dips, jumping jacks, standing quad stretch — plus the
  previously-unregistered push-up. Doubles chest/core/back coverage.

All ROM-clean (137 tests, examples auto-validated); playground build green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018WCktDrKYZpJjCb2apbqWp

Author: claude

docs/coverage-gap.md

@@ -0,0 +1,61 @@
+# Movement coverage — gap analysis
+
+> Benchmarks Movit's curated library against a standard fitness taxonomy
+> (body-part × equipment × target muscle), the structure popularised by public
+> exercise datasets. **We use those datasets only as a yardstick for *coverage and
+> taxonomy* — never their copyrighted media, instructions, or records.** Every
+> Movit movement is authored from scratch and ROM-validated.
+
+The point of this doc: find the holes in our library that the **current engine can
+already render**, so we author exactly the right movements next.
+
+## What the engine can render today
+
+Renderable: **body-weight** movements, plus our props **chair / wall / bar**, on a
+single FK figure with ground-lock, reach-IK, hip-hinge, lying/seated poses, and a
+single-DOF hand rig.
+
+Not yet renderable (so *not* counted as gaps — they're roadmap items): dumbbell /
+barbell / cable / machine / band work (needs load + grip-to-implement), and
+anything needing a second person. In a typical exercise dataset these are the
+majority; the **body-weight subset (~25%)** is our addressable universe.
+
+## Movit library today, by body part (51 movements)
+
+| Body part | Have | Count | Verdict |
+| --- | --- | --- | --- |
+| Upper legs (quads/hams/glutes) | squat, deadlift, good-morning, hamstring-curl, hip-abduction, glute-bridge, box-squat, wall-sit, sit-to-stand, demi-plié, hip/knee ROM | ~12 | Strong, but **no lunges or step-ups** |
+| Core / waist | dead-bug, glute-bridge, hanging-knee-raise, spinal-twist, side-bend, cross-body-reach | ~6 | **No crunch / plank / leg-raise / climber** |
+| Shoulders | lateral-raise, shoulder-flexion, shoulder-abduction, shoulder-rolls, overhead-reach, arm-circles, port-de-bras | ~7 | Good |
+| Back | bent-over-row, deadlift, good-morning, cobra, dead-hang | ~5 | **No superman / extension holds** |
+| Chest | chest-opener (stretch only) | 1 | **Weak — push-up not even registered** |
+| Upper arms | biceps-curl, elbow-forearm | 2 | **No triceps work** |
+| Lower legs | heel-raises, relevé | 2 | Thin |
+| Neck | neck-rotation, neck-side-stretch | 2 | Fine for scope |
+| Hands | make-a-fist, pinch-grip, finger-spell, hand-wave | 4 | Fine for scope |
+| Full body / conditioning | front-kick, jab-cross, horse-stance, dance-phrase | ~4 | **No jacks / climbers / burpee-family** |
+
+## Biggest renderable gaps → the authoring queue
+
+Ordered by gap size × how cleanly the engine renders it:
+
+1. **Core** — `plank-hold`, `mountain-climber` (plank pose), `crunch`,
+   `bicycle-crunch`, `supine-leg-raise` (supine pose). Highest-value, cleanest.
+2. **Chest** — register the existing `push-up`, add `wall-pushup` (wall prop).
+3. **Back** — `superman` (prone pose).
+4. **Upper legs** — `forward-lunge`, `step-up` (chair prop).
+5. **Upper arms** — `triceps-dips` (chair/bar prop).
+6. **Lower legs** — `single-leg-calf-raise`.
+7. **Conditioning / mobility** — `jumping-jacks`, `standing-quad-stretch`
+   (single-leg + reach-IK).
+
+These 13–14 movements roughly **double our chest/core/back coverage** and close the
+most glaring holes — all on today's engine, no new primitives required.
+
+## Metadata gap (drives the catalogue work)
+
+A real exercise record carries `body-part, equipment, primary target, secondary
+muscles, difficulty`. Movit presets carried only `id, label, domain`. We now add
+`bodyPart / target / equipment / difficulty` to every preset and a **filterable
+gallery**, so the library is searchable like a proper exercise explorer — see
+`playground/src/presets.ts` and the filter row in the playground.

playground/play.html

@@ -27,8 +27,20 @@
         <span class="tag">playground</span>
       </a>
       <div class="topbar-actions">
+        <label class="field filter">
+          <span>Area</span>
+          <div class="select-wrap sm"><select id="f-body"></select></div>
+        </label>
+        <label class="field filter">
+          <span>Gear</span>
+          <div class="select-wrap sm"><select id="f-equip"></select></div>
+        </label>
+        <label class="field filter">
+          <span>Level</span>
+          <div class="select-wrap sm"><select id="f-level"></select></div>
+        </label>
         <label class="field">
-          <span>Example</span>
+          <span>Example <span id="preset-count" class="count"></span></span>
           <div class="select-wrap">
             <select id="preset"></select>
           </div>

playground/src/main.ts

@@ -167,21 +167,77 @@ function recompile(): void {
   }
 }
 
-// --- Presets (grouped by domain so the dropdown shows the breadth) ---
-const presetGroups = new Map<string, HTMLOptGroupElement>();
-for (const p of PRESETS) {
-  let group = presetGroups.get(p.domain);
-  if (!group) {
-    group = document.createElement("optgroup");
-    group.label = p.domain;
-    presetGroups.set(p.domain, group);
-    presetSel.append(group);
+// --- Presets: a filterable gallery (body part / equipment / difficulty) ---
+// The catalogue is tagged like a standard exercise DB, so the dropdown can be
+// narrowed the way an exercise explorer would. Options for each filter are
+// derived from the data so they never drift.
+const fBody = $<HTMLSelectElement>("f-body");
+const fEquip = $<HTMLSelectElement>("f-equip");
+const fLevel = $<HTMLSelectElement>("f-level");
+const presetCount = $<HTMLSpanElement>("preset-count");
+
+function fillFilter(sel: HTMLSelectElement, values: string[], allLabel: string): void {
+  sel.innerHTML = "";
+  const all = document.createElement("option");
+  all.value = "";
+  all.textContent = allLabel;
+  sel.append(all);
+  for (const v of [...new Set(values)].sort()) {
+    const opt = document.createElement("option");
+    opt.value = v;
+    opt.textContent = v;
+    sel.append(opt);
   }
-  const opt = document.createElement("option");
-  opt.value = p.id;
-  opt.textContent = p.label;
-  group.append(opt);
 }
+fillFilter(fBody, PRESETS.map((p) => p.bodyPart), "All areas");
+fillFilter(fEquip, PRESETS.map((p) => p.equipment), "All gear");
+fillFilter(fLevel, PRESETS.map((p) => p.difficulty), "All levels");
+
+/** Rebuild the Example dropdown from the presets matching the active filters. */
+function rebuildPresetOptions(): void {
+  const matches = PRESETS.filter(
+    (p) =>
+      (!fBody.value || p.bodyPart === fBody.value) &&
+      (!fEquip.value || p.equipment === fEquip.value) &&
+      (!fLevel.value || p.difficulty === fLevel.value),
+  );
+  presetSel.innerHTML = "";
+  const groups = new Map<string, HTMLOptGroupElement>();
+  for (const p of matches) {
+    let group = groups.get(p.domain);
+    if (!group) {
+      group = document.createElement("optgroup");
+      group.label = p.domain;
+      groups.set(p.domain, group);
+      presetSel.append(group);
+    }
+    const opt = document.createElement("option");
+    opt.value = p.id;
+    opt.textContent = `${p.label} · ${p.target}`;
+    group.append(opt);
+  }
+  presetCount.textContent = `(${matches.length})`;
+  if (matches.length === 0) {
+    const opt = document.createElement("option");
+    opt.textContent = "No matches — clear filters";
+    opt.disabled = true;
+    presetSel.append(opt);
+  }
+}
+rebuildPresetOptions();
+
+for (const f of [fBody, fEquip, fLevel]) {
+  f.addEventListener("change", () => {
+    rebuildPresetOptions();
+    // Auto-load the first match so the viewer always reflects the filter.
+    const first = PRESETS.find((p) => p.id === presetSel.value);
+    if (first) {
+      editorApi.setValue(first.source);
+      recompile();
+    }
+  });
+}
+
 presetSel.addEventListener("change", () => {
   const preset = PRESETS.find((p) => p.id === presetSel.value);
   if (preset) {