feat(language): editor support for the grip directive

Author: a-baran-orhan

editors/vscode/syntaxes/posecode.tmLanguage.json

@@ -29,7 +29,7 @@
     },
     "keywords": {
       "name": "keyword.control.posecode",
-      "match": "\\b(posecode|rig|pose|start|step|repeat|ground-lock|cue|hold)\\b"
+      "match": "\\b(posecode|rig|prop|pose|start|step|repeat|clip|ground-lock|reach|pin|grip|turn|travel|cue|hold)\\b"
     },
     "kinds": {
       "name": "storage.type.posecode",

packages/posecode-language/src/completion.ts

@@ -51,7 +51,7 @@ function contextFor(prefix: string, line: number): Context {
   if (/^\s*pose\s+start\s*=\s*[\w-]*$/.test(prefix)) return "pose";
   if (/^\s*step\s+"[^"]*"\s+[0-9.]+s\s+[\w-]*$/.test(prefix)) return "easing";
   if (/^\s*ground-lock\s*:\s*[\w,\s-]*$/.test(prefix)) return "effector";
-  if (/^\s*(reach|pin)\s*:\s*[\w-]*$/.test(prefix)) return "reach-effector";
+  if (/^\s*(reach|pin|grip)\s*:\s*[\w-]*$/.test(prefix)) return "reach-effector";
   if (/^\s*[\w-]+\s*:\s*[\w-]*$/.test(prefix)) return "action";
 
   if (/^\s*[\w-]*$/.test(prefix)) {

packages/posecode-language/src/vocab.ts

@@ -32,7 +32,7 @@ export const PROPS = ["chair", "wall", "bar", "box", "dip-bars"];
 export const TOP_KEYWORDS = ["rig", "prop", "pose", "clip", "step", "repeat"];
 
 /** Keywords valid as step children. */
-export const CHILD_KEYWORDS = ["ground-lock", "reach", "pin", "turn", "travel", "cue"];
+export const CHILD_KEYWORDS = ["ground-lock", "reach", "pin", "grip", "turn", "travel", "cue"];
 
 /** Short docs surfaced on hover and as completion detail. */
 export const KEYWORD_DOCS: Record<string, string> = {
@@ -53,6 +53,7 @@ export const KEYWORD_DOCS: Record<string, string> = {
   reach:
     "Drives an effector to a target via ROM-constrained IK: `reach: hand_left ankle_left`, `reach: hands floor`.",
   pin: "Moves the body so an effector sits on an anchor: `pin: hands bar` (hang, pull up, step up, dip).",
+  grip: "Holds a bar/rail: `grip: hands bar`. Each hand gets its own two-point anchor (bar_left/bar_right), the arm bends via IK onto it, and the fingers wrap the bar. Use for pull-up, dead-hang, hanging knee raise.",
   turn: "Turns the figure to face a new direction: `turn: 360` (degrees, yaw about vertical). Absolute, carried across phases. Standing poses only.",
   travel: "Moves the figure across the floor: `travel: 0.4 0` (world x z metres from the start spot). Absolute, carried across phases. Standing poses only.",
   cue: "A short coaching cue shown while this phase plays.",

packages/posecode-language/test/language.test.ts

@@ -135,3 +135,26 @@ describe("timing modes (L2)", () => {
     expect(hint?.message).toContain("settle");
   });
 });
+
+describe("grip directive (L3.2)", () => {
+  it("offers grip as a step child keyword", () => {
+    const doc = ['posecode exercise "x"', "  rig humanoid", '  step "Hang" 1s flow:', "    "].join("\n");
+    const line = doc.split("\n")[3]!;
+    const labels = getCompletions(doc, 3, line.length).map((i) => i.label);
+    expect(labels).toContain("grip");
+  });
+
+  it("completes effectors after `grip:`", () => {
+    const doc = ['posecode exercise "x"', "  rig humanoid", '  step "Hang" 1s flow:', "    grip: "].join("\n");
+    const line = doc.split("\n")[3]!;
+    const labels = getCompletions(doc, 3, line.length).map((i) => i.label);
+    expect(labels).toContain("hands");
+  });
+
+  it("hovers grip with its doc", () => {
+    const doc = ['posecode exercise "x"', "  rig humanoid", '  step "Hang" 1s flow:', "    grip: hands bar"].join("\n");
+    const line = doc.split("\n")[3]!;
+    const h = getHover(doc, 3, line.indexOf("grip") + 1);
+    expect(h?.contents.toLowerCase()).toContain("bar");
+  });
+});