feat: broaden examples across domains + add roadmap

Add physiotherapy, desk/posture, yoga, and mobility examples (neck
rotation, posture reset, spinal twist, chair pose, side bend); tag
presets by domain and group them in the gallery + playground dropdown.
Add ROADMAP.md mapping target domains and a future props/apparatus
library (bench, pull-up bar, rings, mat, bands, …).

Author: a-baran-orhan

ROADMAP.md

@@ -0,0 +1,69 @@
+# Movit — domains & roadmap
+
+Movit's vision is broad: **describe any single-person movement as text and render it
+safely in 3D.** The *protocol* is general; the *current renderer* is deliberately
+scoped (one figure, forward kinematics, ground-locked hands/feet, no props). This
+doc maps the domains Movit can serve, what already works, and what each remaining
+domain needs — so contributions land where they unlock the most.
+
+## Where Movit fits
+
+| Domain | Example uses | Status |
+| --- | --- | --- |
+| **Physiotherapy / rehab** | Range-of-motion demos, home-exercise programs, post-op protocols, cervical/shoulder mobility | ✅ Strong fit today — the ROM safety clamp is a clinical feature. Many moves render now; equipment (bands, balls) is future. |
+| **Ergonomics / desk & posture** | Posture resets, seated/standing stretch breaks, "do this every hour" prompts | ✅ Works today for standing variants; true *seated* needs a chair prop (below). |
+| **Yoga & mobility** | Standing poses (chair, side bend, twist), flows, mobility drills | ✅ Standing poses work; floor/inversion/lying poses need lying base poses + a mat. |
+| **Movement education / anatomy** | Demonstrate joint actions ("what is shoulder abduction?"), biomechanics teaching | ✅ Excellent fit — single-joint demos are exactly what the rig does. |
+| **Fitness / strength** | Body-weight and free-form movement coaching | ✅ Core today (squat, curl, raise). Barbell/dumbbell/machine work needs props + grip. |
+| **Functional / elderly care** | Sit-to-stand, balance, gentle ROM, fall-prevention drills | 🟡 Partial — sit-to-stand works; reaching/balance need reach-IK + props. |
+| **Sports technique** | Golf swing, tennis serve, throwing, kicking | 🟡 Partial — needs trunk rotation fidelity, weight shift, and implements (club/racket/ball). |
+| **Dance / choreography** | Notating sequences, port de bras, simple phrases | 🟡 Simple gestures work; precise reach + partner work are future. |
+| **Martial arts** | Stances, strikes, basic forms | 🟡 Stances/strikes partly work; contact and weapons are future. |
+| **Sign language / gesture** | Finger-spelling, signs, expressive gesture | ⛔ Needs a hand/finger rig (the rig currently ends at the wrist). |
+
+## Engine capabilities that widen the scope
+
+These are the unlocks, roughly in order of leverage:
+
+1. **Hip / waist hinge primitive** — today deadlift / forward-fold are faked as a
+   spinal roll-down. A true hip hinge unlocks deadlift, row, good-morning, hinge-based
+   yoga, and bending to interact with props.
+2. **Reach-IK (reach a world target)** — touch your toes, hand-to-opposite-knee,
+   grab a bar, place a hand on a wall. Unlocks a huge share of physio, yoga, and any
+   prop interaction.
+3. **Scene props with contact anchors** — objects the figure can stand on, sit on,
+   hang from, or push against, plus ground-lock-style anchors to them.
+4. **Lying & seated base poses** — supine / prone / quadruped / seated starting poses
+   (for floor yoga, mat Pilates, bed-based rehab, sit-to-stand on a real seat).
+5. **Hand / finger articulation** — grip and gesture (sign language, grasping props).
+6. **Two-person + collision** — partner stretches, assisted rehab, contact sports
+   (already noted as deferred in the spec).
+
+## Prop / equipment library (future)
+
+Each prop is a small scene object + an anchor type; movements then reference it
+(e.g. `ground-lock: bar` or a future `reach: bar`). Candidates, and what they unlock:
+
+| Prop | Unlocks |
+| --- | --- |
+| **Chair / stool / bench** | Seated desk & rehab work, sit-to-stand, step-ups, bench press, box squats |
+| **Pull-up bar** | Pull-ups, dead hangs, hanging knee raises (needs grip + reach-IK) |
+| **Gymnastic rings** | Rows, dips, support holds, skin-the-cat (grip + reach-IK + two-anchor) |
+| **Yoga mat + blocks / strap / bolster** | Floor poses, supported stretches, props-assisted mobility |
+| **Bed / table** | Bed-based rehab, supine exercises, clinical assessments |
+| **Wall** | Wall sits, wall push-ups, calf/shoulder stretches against a surface |
+| **Resistance band** | Band pull-aparts, banded rehab, mobility with tension |
+| **Dumbbell / barbell / kettlebell** | Loaded strength patterns (needs grip + load cues) |
+| **Ball (stability / medicine)** | Core work, balance, throws |
+| **Parallettes / dip station** | Dips, L-sits, push-up variations at height |
+| **Foam roller** | Self-myofascial release, mobility drills |
+
+## Current limitations (honest)
+
+- One figure only; no props or external objects yet.
+- Forward kinematics + ground-locked hands/feet; **no reach-to-target IK**.
+- Hip/waist hinge is approximated by spinal flexion (so deadlift-class moves look
+  like a roll-down — curate around this until the hinge primitive lands).
+- Rig ends at the wrist (no fingers) and the head (no facial articulation).
+
+> Range-of-motion values are general literature data, not medical advice.

playground/index.html

@@ -53,9 +53,10 @@ <h1 class="headline">
           Human movement,<br />written as <span class="hl">text</span>.
         </h1>
         <p class="subhead">
-          Movit is a tiny language an LLM can write — exercises, stretches, posture —
-          that renders to an animated 3D figure in the browser. Every joint is clamped
-          to a safe range of motion, so the result is always anatomically plausible.
+          Movit is a tiny language an LLM can write — for physiotherapy, mobility,
+          posture, yoga, and training — that renders to an animated 3D figure in the
+          browser. Every joint is clamped to a safe range of motion, so the result is
+          always anatomically plausible.
         </p>
         <div class="hero-cta">
           <a class="btn primary lg" href="./play.html">Open the playground&nbsp;→</a>
@@ -122,9 +123,10 @@ <h3>Cheap &amp; client-side</h3>
     <section id="examples" class="examples">
       <header class="section-head reveal">
         <p class="eyebrow">See it move</p>
-        <h2>Six movements, one click away</h2>
+        <h2>One language, many practices</h2>
         <p class="section-sub">
-          Each opens in the playground — editable, shareable, rendered live.
+          From physiotherapy and posture to yoga, mobility, and the gym — each opens
+          in the playground, editable and shareable.
         </p>
       </header>
       <div id="examples-grid" class="examples-grid"></div>

playground/src/landing.ts

@@ -49,12 +49,11 @@ if ("requestIdleCallback" in window) {
 const grid = document.getElementById("examples-grid");
 if (grid) {
   for (const preset of PRESETS) {
-    const kind = parse(preset.source).ir?.kind ?? "movement";
     const card = document.createElement("a");
     card.className = "example-card";
     card.href = `play.html${buildShareHash(preset.source)}`;
     card.innerHTML = `
-      <span class="example-kind">${kind}</span>
+      <span class="example-kind">${preset.domain}</span>
       <span class="example-name">${preset.label}</span>
       <span class="example-go">Open in playground →</span>`;
     grid.append(card);

playground/src/main.ts

@@ -167,12 +167,20 @@ function recompile(): void {
   }
 }
 
-// --- Presets ---
+// --- 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);
+  }
   const opt = document.createElement("option");
   opt.value = p.id;
   opt.textContent = p.label;
-  presetSel.append(opt);
+  group.append(opt);
 }
 presetSel.addEventListener("change", () => {
   const preset = PRESETS.find((p) => p.id === presetSel.value);

playground/src/presets.ts

@@ -4,17 +4,32 @@ import biceps from "../../spec/examples/biceps-curl.movit?raw";
 import lateral from "../../spec/examples/lateral-raise.movit?raw";
 import shoulder from "../../spec/examples/shoulder-stretch.movit?raw";
 import fold from "../../spec/examples/forward-fold.movit?raw";
+import neck from "../../spec/examples/neck-rotation.movit?raw";
+import posture from "../../spec/examples/posture-reset.movit?raw";
+import twist from "../../spec/examples/spinal-twist.movit?raw";
+import chair from "../../spec/examples/chair-pose.movit?raw";
+import sideBend from "../../spec/examples/side-bend.movit?raw";
 
 export interface Preset {
   id: string;
   label: string;
+  /** Use-case domain, surfaced in the gallery/dropdown to show breadth. */
+  domain: string;
   source: string;
 }
 
+// Ordered so the first gallery row spans several domains at a glance. The first
+// entry is also the playground default and the landing hero, so it leads with a
+// strong, full-body movement (the squat).
 export const PRESETS: Preset[] = [
-  { id: "squat", label: "Body-weight squat", source: squat },
-  { id: "biceps", label: "Biceps curl", source: biceps },
-  { id: "lateral", label: "Lateral raise", source: lateral },
-  { id: "shoulder", label: "Overhead reach", source: shoulder },
-  { id: "fold", label: "Standing roll-down", source: fold },
+  { id: "squat", label: "Body-weight squat", domain: "Fitness", source: squat },
+  { id: "neck", label: "Neck rotation", domain: "Physiotherapy", source: neck },
+  { id: "posture", label: "Desk posture reset", domain: "Desk & posture", source: posture },
+  { id: "chair", label: "Chair pose", domain: "Yoga", source: chair },
+  { id: "fold", label: "Standing roll-down", domain: "Mobility", source: fold },
+  { id: "twist", label: "Standing spinal twist", domain: "Desk & posture", source: twist },
+  { id: "sidebend", label: "Standing side bend", domain: "Yoga", source: sideBend },
+  { id: "shoulder", label: "Shoulder flexion (ROM)", domain: "Physiotherapy", source: shoulder },
+  { id: "biceps", label: "Biceps curl", domain: "Fitness", source: biceps },
+  { id: "lateral", label: "Lateral raise", domain: "Fitness", source: lateral },
 ];

spec/examples/chair-pose.movit

@@ -0,0 +1,23 @@
+movit posture "Chair pose"
+  rig humanoid
+  pose start = standing
+
+  step "Sink" 3s ease-in-out:
+    hips: flex 55
+    knees: flex 70
+    ankles: dorsiflex 12
+    shoulders: flex 170
+    spine: flex 10
+    ground-lock: feet
+    cue "Sit the hips back and down, reach the arms overhead"
+
+  step "Rise" 2s ease-out:
+    hips: flex 0
+    knees: flex 0
+    ankles: dorsiflex 0
+    shoulders: flex 0
+    spine: flex 0
+    ground-lock: feet
+    cue "Press through the feet to stand, arms float down"
+
+  repeat 4

spec/examples/neck-rotation.movit

@@ -0,0 +1,20 @@
+movit stretch "Neck rotation"
+  rig humanoid
+  pose start = standing
+
+  step "Look right" 2s ease-in-out:
+    neck: rotate-out 60
+    ground-lock: feet
+    cue "Turn slowly to look over the right shoulder"
+
+  step "Look left" 2.4s ease-in-out:
+    neck: rotate-in 60
+    ground-lock: feet
+    cue "Pass through center and turn to the left"
+
+  step "Center" 1.6s ease-out:
+    neck: rotate-in 0
+    ground-lock: feet
+    cue "Return the head to neutral"
+
+  repeat 4

spec/examples/posture-reset.movit

@@ -0,0 +1,21 @@
+movit posture "Desk posture reset"
+  rig humanoid
+  pose start = standing
+
+  step "Slouch" 2.5s ease-in-out:
+    spine: flex 22
+    chest: flex 16
+    neck: flex 28
+    shoulders: flex 22
+    ground-lock: feet
+    cue "The collapsed desk posture — rounded back, head drifting forward"
+
+  step "Stack tall" 2.5s ease-in-out:
+    spine: flex 0
+    chest: extend 8
+    neck: flex 0
+    shoulders: flex 0
+    ground-lock: feet
+    cue "Stack head over ribs over hips, chest open, shoulders soft"
+
+  repeat 4

spec/examples/side-bend.movit

@@ -0,0 +1,17 @@
+movit stretch "Standing side bend"
+  rig humanoid
+  pose start = standing
+
+  step "Reach over" 3s ease-in-out:
+    shoulders: flex 175
+    spine: abduct 30
+    ground-lock: feet
+    cue "Reach tall, then arc gently over to one side"
+
+  step "Return" 2.5s ease-in-out:
+    shoulders: flex 0
+    spine: abduct 0
+    ground-lock: feet
+    cue "Lengthen back up through the crown of the head"
+
+  repeat 3

spec/examples/spinal-twist.movit

@@ -0,0 +1,27 @@
+movit stretch "Standing spinal twist"
+  rig humanoid
+  pose start = standing
+
+  step "Twist right" 2.5s ease-in-out:
+    spine: rotate-out 40
+    chest: rotate-out 30
+    shoulders: abduct 80
+    elbows: flex 90
+    ground-lock: feet
+    cue "Rotate through the mid-back, arms at shoulder height, hips facing forward"
+
+  step "Twist left" 3s ease-in-out:
+    spine: rotate-in 40
+    chest: rotate-in 30
+    ground-lock: feet
+    cue "Pass through center and rotate to the other side"
+
+  step "Center" 1.6s ease-out:
+    spine: rotate-in 0
+    chest: rotate-in 0
+    shoulders: abduct 0
+    elbows: flex 0
+    ground-lock: feet
+    cue "Unwind back to center"
+
+  repeat 3