@ikijs/editor 0.17.0 → 0.19.0

package/dist/index.js

@@ -52,6 +52,7 @@ __export(index_exports, {
   SetPhysicsRig: () => SetPhysicsRig,
   TurnTargetError: () => TurnTargetError,
   UV_INSET_PX: () => UV_INSET_PX,
+  armGeometry: () => armGeometry,
   captureBindingEndpoint: () => captureBindingEndpoint,
   computeGridOffsets: () => computeGridOffsets,
   createDefaultMatrixDeformer: () => createDefaultMatrixDeformer,
@@ -2180,258 +2181,11 @@ var DEFAULT_TURN_TARGETS = Object.freeze({
   silhouetteRatio: 1
 });
 
-// src/auto-rig/roles.ts
-var ROLE_TABLE = [
-  { role: "hair_back", family: "hair_back" },
-  { role: "body", family: "body" },
-  { role: "arm_L", family: "arm", parts: ["arm_L", "forearm_L"] },
-  { role: "arm_R", family: "arm", parts: ["arm_R", "forearm_R"] },
-  { role: "face", family: "face", required: true },
-  { role: "blush_L", family: "face" },
-  { role: "blush_R", family: "face" },
-  { role: "nose", family: "nose" },
-  { role: "mouth", family: "mouth", required: true },
-  { role: "mouth_open", family: "mouth" },
-  { role: "eye_L", family: "eye_L", required: true },
-  { role: "eye_R", family: "eye_R", required: true },
-  { role: "iris_L", family: "eye_L" },
-  { role: "iris_R", family: "eye_R" },
-  { role: "pupil_L", family: "eye_L" },
-  { role: "pupil_R", family: "eye_R" },
-  { role: "highlight_L", family: "eye_L" },
-  { role: "highlight_R", family: "eye_R" },
-  { role: "lash_lower_L", family: "eye_L" },
-  { role: "lash_lower_R", family: "eye_R" },
-  { role: "lash_L", family: "eye_L" },
-  { role: "lash_R", family: "eye_R" },
-  { role: "brow_L", family: "brow_L" },
-  { role: "brow_R", family: "brow_R" },
-  { role: "hair_front", family: "hair_front" }
-];
-var REQUIRED_ROLES = ROLE_TABLE.filter(
-  (r) => r.required
-).map((r) => r.role);
-var SPEC_BY_ROLE = new Map(ROLE_TABLE.map((r, i) => [r.role, { ...r, i }]));
-function roleSpec(role) {
-  const spec = SPEC_BY_ROLE.get(role);
-  if (spec === void 0) throw new Error(`auto-rig: unknown role "${role}"`);
-  return spec;
-}
-function partIdsOfRole(role) {
-  return roleSpec(role).parts ?? [role];
-}
-var ROLE_BY_PART = new Map(
-  ROLE_TABLE.flatMap((r) => (r.parts ?? []).map((p) => [p, r.role]))
-);
-function roleOfPart(partId) {
-  return ROLE_BY_PART.get(partId) ?? partId;
-}
-var ALIASES = {
-  eyebrow_L: "brow_L",
-  eyebrow_R: "brow_R",
-  eye_white_L: "eye_L",
-  eye_white_R: "eye_R"
-};
-function roleOf(fileName) {
-  const role = fileName.replace(/\.[^.]+$/, "").toLowerCase().replace(/[-\s]+/g, "_").replace(/_([lr])$/, (_, s) => `_${s.toUpperCase()}`);
-  return ALIASES[role] ?? role;
-}
-function checkArmsHaveBody(roles) {
-  const has = new Set(roles);
-  if (has.has("body")) return;
-  const arm = ROLE_TABLE.find((r) => r.family === "arm" && has.has(r.role));
-  if (arm !== void 0) {
-    throw new Error(
-      `auto-rig: ${arm.role} needs a body layer (an arm hangs from the body's shoulder)`
-    );
-  }
-}
-function parseLayerRoles(fileNames) {
-  const seen = /* @__PURE__ */ new Map();
-  const out = [];
-  for (const fileName of fileNames) {
-    const role = roleOf(fileName);
-    if (!SPEC_BY_ROLE.has(role)) {
-      throw new Error(
-        `auto-rig: "${fileName}" names no known role (expected one of ${ROLE_TABLE.map((r) => r.role).join(", ")})`
-      );
-    }
-    const prior = seen.get(role);
-    if (prior !== void 0) {
-      throw new Error(
-        `auto-rig: role "${role}" is named twice ("${prior}" and "${fileName}")`
-      );
-    }
-    seen.set(role, fileName);
-    out.push({ role, fileName });
-  }
-  const missing = REQUIRED_ROLES.filter((r) => !seen.has(r));
-  if (missing.length > 0) {
-    throw new Error(
-      `auto-rig: missing required role${missing.length > 1 ? "s" : ""} ${missing.join(", ")}`
-    );
-  }
-  checkArmsHaveBody(seen.keys());
-  return out;
-}
-
-// src/auto-rig/generate.ts
-var import_format8 = require("@ikijs/format");
-
-// src/auto-rig/animations.ts
-var import_format3 = require("@ikijs/format");
-function browsY(y) {
-  return [
-    { parameter: import_format3.StandardParameter.BrowLeftY, value: y, blend: "add" },
-    { parameter: import_format3.StandardParameter.BrowRightY, value: y, blend: "add" }
-  ];
-}
-function browsTilt(innerDown) {
-  return [
-    { parameter: import_format3.StandardParameter.BrowLeftAngle, value: innerDown, blend: "add" },
-    { parameter: import_format3.StandardParameter.BrowRightAngle, value: -innerDown, blend: "add" }
-  ];
-}
-function cheek(value) {
-  return { parameter: import_format3.StandardParameter.Cheek, value, blend: "add" };
-}
-var BROWS = [import_format3.StandardParameter.BrowLeftY, import_format3.StandardParameter.BrowRightY, import_format3.StandardParameter.BrowLeftAngle, import_format3.StandardParameter.BrowRightAngle];
-var EXPRESSIONS = [
-  {
-    id: "smile",
-    description: "Smiling and pleased: warm, friendly, content. For greetings, thanks, agreement and gentle happiness.",
-    parameters: [
-      { parameter: import_format3.StandardParameter.MouthForm, value: 1, blend: "add" },
-      ...browsY(0.25),
-      cheek(0.4)
-    ]
-  },
-  {
-    id: "laugh",
-    description: "Laughing, eyes shut and mouth open: delighted, amused. For jokes, playfulness and big joy.",
-    parameters: [
-      { parameter: import_format3.StandardParameter.EyeOpenLeft, value: 0, blend: "multiply" },
-      { parameter: import_format3.StandardParameter.EyeOpenRight, value: 0, blend: "multiply" },
-      { parameter: import_format3.StandardParameter.MouthForm, value: 1, blend: "add" },
-      { parameter: import_format3.StandardParameter.MouthOpen, value: 0.8, blend: "overwrite" },
-      ...browsY(0.4),
-      cheek(0.65)
-    ]
-  },
-  {
-    id: "angry",
-    description: "Angry or annoyed, frowning. For irritation, frustration, indignation or scolding.",
-    needs: BROWS,
-    parameters: [
-      ...browsY(-0.5),
-      ...browsTilt(0.8),
-      { parameter: import_format3.StandardParameter.MouthForm, value: -0.9, blend: "add" }
-    ]
-  },
-  {
-    id: "sad",
-    description: "Sad or disappointed, downcast. For sorrow, regret, apology or sympathy.",
-    needs: BROWS,
-    parameters: [
-      ...browsY(0.35),
-      ...browsTilt(-0.8),
-      { parameter: import_format3.StandardParameter.MouthForm, value: -0.8, blend: "add" }
-    ]
-  },
-  {
-    id: "surprised",
-    description: "Surprised, mouth dropped open: startled, amazed. For shock, sudden news or disbelief.",
-    parameters: [
-      ...browsY(0.8),
-      { parameter: import_format3.StandardParameter.MouthOpen, value: 0.9, blend: "overwrite" }
-    ]
-  },
-  {
-    id: "shy",
-    description: "Shy or embarrassed: bashful, flustered. For being praised, teased or caught off guard.",
-    needs: [import_format3.StandardParameter.Cheek],
-    parameters: [
-      cheek(1),
-      // Gaze down.
-      { parameter: import_format3.StandardParameter.EyeballY, value: -0.65, blend: "add" },
-      { parameter: import_format3.StandardParameter.MouthForm, value: 0.4, blend: "add" },
-      ...browsTilt(-0.25)
-    ]
-  }
-];
-function defaultExpressions(declared) {
-  return EXPRESSIONS.filter(
-    (e) => e.needs === void 0 || e.needs.some((id) => declared.has(id))
-  ).map(({ needs: _needs, ...e }) => ({
-    ...e,
-    parameters: e.parameters.filter((t) => declared.has(t.parameter))
-  }));
-}
-var DEFAULT_MOTIONS = {
-  Nod: [
-    {
-      description: "Nods yes: agreement, acknowledgement, understanding.",
-      duration: 1,
-      curves: [
-        {
-          parameter: import_format3.StandardParameter.AngleY,
-          keys: [
-            [0, 0],
-            [0.3, -18],
-            [0.6, 4],
-            [0.8, -1],
-            [1, 0]
-          ]
-        }
-      ]
-    }
-  ],
-  Shake: [
-    {
-      description: "Shakes the head no: disagreement, refusal, disbelief.",
-      duration: 1.2,
-      // The first swing peaks at 0.2 s, which the default fade would still
-      // be damping.
-      fadeIn: 0.15,
-      curves: [
-        {
-          parameter: import_format3.StandardParameter.AngleX,
-          keys: [
-            [0, 0],
-            [0.2, -18],
-            [0.45, 18],
-            [0.7, -16],
-            [0.95, 10],
-            [1.2, 0]
-          ]
-        }
-      ]
-    }
-  ],
-  Tilt: [
-    {
-      description: "Tilts the head to one side and back: curiosity, puzzlement, a question.",
-      duration: 1.4,
-      curves: [
-        {
-          parameter: import_format3.StandardParameter.AngleZ,
-          keys: [
-            [0, 0],
-            [0.35, 20],
-            [1, 20],
-            [1.4, 0]
-          ]
-        }
-      ]
-    }
-  ]
-};
-
 // src/auto-rig/arms.ts
-var import_format6 = require("@ikijs/format");
+var import_format5 = require("@ikijs/format");
 
 // src/auto-rig/body.ts
-var import_format5 = require("@ikijs/format");
+var import_format4 = require("@ikijs/format");
 
 // src/auto-rig/layout.ts
 function boxOfLayer(layer) {
@@ -2507,7 +2261,7 @@ function meshPoints(mesh, box) {
 }
 
 // src/auto-rig/drivers.ts
-var import_format4 = require("@ikijs/format");
+var import_format3 = require("@ikijs/format");
 var SWAY_RANGE = 20;
 var SWAY_CURVE = 1.4;
 var HAIR_HANG = 0.35;
@@ -2585,13 +2339,13 @@ function gazeBindings(irisW, share = 1) {
   const gy = AMPLITUDE.gazeY * irisW * share;
   return [
     {
-      parameter: import_format4.StandardParameter.EyeballX,
+      parameter: import_format3.StandardParameter.EyeballX,
       channel: "translateX",
       from: -round1(gx),
       to: round1(gx)
     },
     {
-      parameter: import_format4.StandardParameter.EyeballY,
+      parameter: import_format3.StandardParameter.EyeballY,
       channel: "translateY",
       from: -round1(gy),
       to: round1(gy)
@@ -2605,8 +2359,8 @@ function browReach(hh) {
   return AMPLITUDE.brow * hh;
 }
 function browBindings(side, reach) {
-  const y = side === "L" ? import_format4.StandardParameter.BrowLeftY : import_format4.StandardParameter.BrowRightY;
-  const a = side === "L" ? import_format4.StandardParameter.BrowLeftAngle : import_format4.StandardParameter.BrowRightAngle;
+  const y = side === "L" ? import_format3.StandardParameter.BrowLeftY : import_format3.StandardParameter.BrowRightY;
+  const a = side === "L" ? import_format3.StandardParameter.BrowLeftAngle : import_format3.StandardParameter.BrowRightAngle;
   return [
     {
       parameter: y,
@@ -2622,7 +2376,7 @@ function mouthForm(mesh, box) {
   const a = 0.3 * bh(box);
   const c = cx(box);
   const half = bw(box) / 2;
-  return localWarp(import_format4.StandardParameter.MouthForm, mesh, box, [-1, 0, 1], ([x], v) => {
+  return localWarp(import_format3.StandardParameter.MouthForm, mesh, box, [-1, 0, 1], ([x], v) => {
     if (v === 0) return [0, 0];
     const u = (x - c) / half;
     const widen = v > 0 ? 0.05 : 0.03;
@@ -2632,7 +2386,7 @@ function mouthForm(mesh, box) {
 function mouthOpenGrow(mesh, box) {
   const c = cx(box);
   return localWarp(
-    import_format4.StandardParameter.MouthOpen,
+    import_format3.StandardParameter.MouthOpen,
     mesh,
     box,
     [0, 1],
@@ -2641,7 +2395,7 @@ function mouthOpenGrow(mesh, box) {
 }
 function mouthWiden(mesh, box) {
   const c = cx(box);
-  return localWarp(import_format4.StandardParameter.MouthOpen, mesh, box, [0, 1], ([x], v) => [
+  return localWarp(import_format3.StandardParameter.MouthOpen, mesh, box, [0, 1], ([x], v) => [
     v * (AMPLITUDE.mouthOpenWidth - 1) * (x - c),
     0
   ]);
@@ -2659,7 +2413,7 @@ function hairSway(param, mesh, box, amp) {
   );
 }
 function tiltHang(mesh, box, pivot, weight, deg = ROLL_DEG) {
-  return localWarp(import_format4.StandardParameter.AngleZ, mesh, box, Z_STOPS, ([x, y], v, i) => {
+  return localWarp(import_format3.StandardParameter.AngleZ, mesh, box, Z_STOPS, ([x, y], v, i) => {
     const g = weight(y, i);
     if (g === 0 || v === 0) return [0, 0];
     const a = -g * rollOf(v, deg);
@@ -2908,16 +2662,16 @@ function buildBodyWarp({
       points: ys.flatMap((y) => xs.flatMap((x) => [x, y]))
     },
     warps: [
-      warp(import_format5.StandardParameter.BodyAngleX, BODY_STOPS, (x, _y, t) => [turn(x, t), 0]),
-      warp(import_format5.StandardParameter.BodyAngleY, BODY_STOPS, (_x, _y, t) => [0, t * BODY.bow * hh]),
+      warp(import_format4.StandardParameter.BodyAngleX, BODY_STOPS, (x, _y, t) => [turn(x, t), 0]),
+      warp(import_format4.StandardParameter.BodyAngleY, BODY_STOPS, (_x, _y, t) => [0, t * BODY.bow * hh]),
       warp(
-        import_format5.StandardParameter.BodyAngleZ,
+        import_format4.StandardParameter.BodyAngleZ,
         BODY_STOPS,
         (x, y, t) => roll(x, y, -t * BODY.rollDeg)
       ),
-      warp(import_format5.StandardParameter.AngleX, X_STOPS, (x, _y, t) => [BODY.followX * turn(x, t), 0]),
-      warp(import_format5.StandardParameter.AngleZ, Z_STOPS, (x, y, t) => roll(x, y, -t * BODY.followRoll)),
-      warp(import_format5.StandardParameter.Breath, [0, 1], (_x, _y, t) => [0, t * AMPLITUDE.breathBody * hh])
+      warp(import_format4.StandardParameter.AngleX, X_STOPS, (x, _y, t) => [BODY.followX * turn(x, t), 0]),
+      warp(import_format4.StandardParameter.AngleZ, Z_STOPS, (x, y, t) => roll(x, y, -t * BODY.followRoll)),
+      warp(import_format4.StandardParameter.Breath, [0, 1], (_x, _y, t) => [0, t * AMPLITUDE.breathBody * hh])
     ]
   };
   refuseFold(body, deformer, anchor, [chin, ...pivots]);
@@ -3000,19 +2754,25 @@ function headOwnBreath(hasBody) {
 var ELBOW_AT = 0.42;
 var CAP_ROWS = [0.1, 0.3];
 var CAP_SEGMENTS = 12;
-var ARM_RANGE = [-30, 150];
+var CAP_INSET = 3;
+var capInset = (i) => Math.round(CAP_INSET * Math.min(1, Math.min(i, CAP_SEGMENTS - i) / 2));
+var CAP_RIM = 0.25;
+var ARM_RANGE = [-8, 32];
+var ELBOW_RANGE = [-10, 90];
 var ARM_PARAMS = {
-  arm_L: { arm: import_format6.StandardParameter.ArmLeft, elbow: import_format6.StandardParameter.ElbowLeft },
-  arm_R: { arm: import_format6.StandardParameter.ArmRight, elbow: import_format6.StandardParameter.ElbowRight }
+  arm_L: { arm: import_format5.StandardParameter.ArmLeft, elbow: import_format5.StandardParameter.ElbowLeft },
+  arm_R: { arm: import_format5.StandardParameter.ArmRight, elbow: import_format5.StandardParameter.ElbowRight }
 };
 var ARM_IDS = {
   arm_L: {
     forearm: "forearm_L",
+    cap: "elbow_L",
     armDeformer: "armDeformer_L",
     forearmDeformer: "forearmDeformer_L"
   },
   arm_R: {
     forearm: "forearm_R",
+    cap: "elbow_R",
     armDeformer: "armDeformer_R",
     forearmDeformer: "forearmDeformer_R"
   }
@@ -3065,11 +2825,30 @@ function armGeometry(layer, bodyAxisX) {
     b.x1 - elbow.x,
     b.y1 - elbow.y
   );
+  const inside = (x, y) => {
+    const k = Math.floor(y) - bbox.y;
+    if (k < 0 || k >= bbox.h) return false;
+    const [rs, re] = span(k);
+    return rs < x && x < re;
+  };
+  const capRays = Array.from({ length: CAP_SEGMENTS + 1 }, (_, i) => {
+    const a = Math.PI * i / CAP_SEGMENTS;
+    let t = 1;
+    while (t <= capRadius + CAP_INSET && inside(
+      elbow.x + canvasW / 2 + t * Math.cos(a),
+      canvasH / 2 - elbow.y - t * Math.sin(a)
+    )) {
+      t++;
+    }
+    return Math.min(capRadius, Math.max(1, t - capInset(i)));
+  });
   return {
     shoulder,
     shoulderRadius: ru,
     elbow,
     capRadius,
+    capRays,
+    seamRun: [s - bbox.x, e - bbox.x],
     side: shoulder.x > bodyAxisX ? 1 : -1
   };
 }
@@ -3084,72 +2863,351 @@ function armParts(role, layer, g, order) {
   const lx = (x) => roundTo((x - cx(b)) / bw(b), 1e-5);
   const ly = (y) => roundTo((y - cy(b)) / bh(b), 1e-5);
   const seam = ly(g.elbow.y);
-  const band = (top, bottom) => [
+  const band = (top2, bottom) => [
     -0.5,
-    top,
+    top2,
     0.5,
-    top,
+    top2,
     -0.5,
     bottom,
     0.5,
     bottom
   ];
   const quad = [2, 3, 0, 0, 3, 1];
-  const cap = [lx(g.elbow.x), seam];
+  const rays = g.capRays.length;
+  const top = (rays - 1) / 2;
+  const at = (i, r) => {
+    const a = Math.PI * i / (rays - 1);
+    return [lx(g.elbow.x + r * Math.cos(a)), ly(g.elbow.y + r * Math.sin(a))];
+  };
+  const width = (i) => Math.min(CAP_RIM * g.capRadius, g.capRays[i] / 2);
+  const ringRays = Array.from({ length: rays }, (_, i) => i);
+  ringRays.splice(top, 0, top);
+  const vertices = [lx(g.elbow.x), seam];
+  for (let i = 0; i < rays; i++) {
+    vertices.push(...at(i, g.capRays[i] - width(i)));
+  }
+  const ringInner = vertices.length / 2;
+  for (const i of ringRays) vertices.push(...at(i, g.capRays[i] - width(i)));
+  const ringOuter = vertices.length / 2;
+  for (const i of ringRays) vertices.push(...at(i, g.capRays[i]));
+  const { uvs } = meshOf(vertices, []);
+  const col = (c) => roundTo(Math.min(Math.max(c + 0.5, 0.5), bw(b) - 0.5) / bw(b), 1e-5);
+  const v = roundTo(0.5 - seam, 1e-5);
+  ringRays.forEach((i, j) => {
+    const right = j <= top;
+    const outer = right ? g.seamRun[1] : g.seamRun[0] - 1;
+    const step = right ? -width(i) : width(i);
+    uvs[(ringInner + j) * 2] = col(outer + step);
+    uvs[(ringInner + j) * 2 + 1] = v;
+    uvs[(ringOuter + j) * 2] = col(outer);
+    uvs[(ringOuter + j) * 2 + 1] = v;
+  });
   const fan = [];
-  for (let i = 0; i <= CAP_SEGMENTS; i++) {
-    const a = Math.PI * i / CAP_SEGMENTS;
-    cap.push(
-      lx(g.elbow.x + g.capRadius * Math.cos(a)),
-      ly(g.elbow.y + g.capRadius * Math.sin(a))
-    );
-    if (i > 0) fan.push(4, 4 + i, 5 + i);
-  }
-  const part = (id, deformer, at, mesh) => ({
+  for (let i = 0; i < rays - 1; i++) fan.push(0, 1 + i, 2 + i);
+  const ring = [];
+  for (let j = 0; j < ringRays.length - 1; j++) {
+    if (j === top) continue;
+    const [p, q] = [ringInner + j, ringOuter + j];
+    ring.push(p, q, q + 1, p, q + 1, p + 1);
+  }
+  const part = (id, deformer, z, mesh) => ({
     id,
     color: [1, 1, 1, 1],
     width: bw(b),
     height: bh(b),
     transform: { x: cx(b), y: cy(b) },
-    order: at,
+    order: z,
     deformer,
     mesh
   });
   const ids = ARM_IDS[role];
   return [
-    part(role, ids.armDeformer, order, meshOf(band(0.5, seam), quad)),
+    part(ids.cap, ids.forearmDeformer, order, {
+      vertices,
+      uvs,
+      indices: [...fan, ...ring]
+    }),
+    part(role, ids.armDeformer, order + 1, meshOf(band(0.5, seam), quad)),
     part(
       ids.forearm,
       ids.forearmDeformer,
-      order + 1,
-      meshOf([...band(seam, -0.5), ...cap], [...quad, ...fan])
+      order + 2,
+      meshOf(band(seam, -0.5), quad)
     )
   ];
 }
 function armDeformers(role, g) {
   const ids = ARM_IDS[role];
   const params = ARM_PARAMS[role];
-  const rotate = (parameter) => ({
+  const rotate = (parameter, range, sign) => ({
     parameter,
     channel: "rotate",
-    from: g.side * ARM_RANGE[0],
-    to: g.side * ARM_RANGE[1]
+    from: sign * range[0],
+    to: sign * range[1]
   });
   return [
     {
       id: ids.armDeformer,
       parent: BODY_WARP_ID,
       pivot: { ...g.shoulder },
-      bindings: [rotate(params.arm)]
+      bindings: [rotate(params.arm, ARM_RANGE, g.side)]
     },
     {
       id: ids.forearmDeformer,
       parent: ids.armDeformer,
       pivot: { ...g.elbow },
-      bindings: [rotate(params.elbow)]
+      bindings: [rotate(params.elbow, ELBOW_RANGE, -g.side)]
+    }
+  ];
+}
+
+// src/auto-rig/roles.ts
+var ROLE_TABLE = [
+  { role: "hair_back", family: "hair_back" },
+  { role: "body", family: "body" },
+  { role: "arm_L", family: "arm", parts: ["elbow_L", "arm_L", "forearm_L"] },
+  { role: "arm_R", family: "arm", parts: ["elbow_R", "arm_R", "forearm_R"] },
+  { role: "face", family: "face", required: true },
+  { role: "blush_L", family: "face" },
+  { role: "blush_R", family: "face" },
+  { role: "nose", family: "nose" },
+  { role: "mouth", family: "mouth", required: true },
+  { role: "mouth_open", family: "mouth" },
+  { role: "eye_L", family: "eye_L", required: true },
+  { role: "eye_R", family: "eye_R", required: true },
+  { role: "iris_L", family: "eye_L" },
+  { role: "iris_R", family: "eye_R" },
+  { role: "pupil_L", family: "eye_L" },
+  { role: "pupil_R", family: "eye_R" },
+  { role: "highlight_L", family: "eye_L" },
+  { role: "highlight_R", family: "eye_R" },
+  { role: "lash_lower_L", family: "eye_L" },
+  { role: "lash_lower_R", family: "eye_R" },
+  { role: "lash_L", family: "eye_L" },
+  { role: "lash_R", family: "eye_R" },
+  { role: "brow_L", family: "brow_L" },
+  { role: "brow_R", family: "brow_R" },
+  { role: "hair_front", family: "hair_front" }
+];
+var REQUIRED_ROLES = ROLE_TABLE.filter(
+  (r) => r.required
+).map((r) => r.role);
+var SPEC_BY_ROLE = new Map(ROLE_TABLE.map((r, i) => [r.role, { ...r, i }]));
+function roleSpec(role) {
+  const spec = SPEC_BY_ROLE.get(role);
+  if (spec === void 0) throw new Error(`auto-rig: unknown role "${role}"`);
+  return spec;
+}
+function partIdsOfRole(role) {
+  return roleSpec(role).parts ?? [role];
+}
+var ROLE_BY_PART = new Map(
+  ROLE_TABLE.flatMap((r) => (r.parts ?? []).map((p) => [p, r.role]))
+);
+function roleOfPart(partId) {
+  return ROLE_BY_PART.get(partId) ?? partId;
+}
+var ALIASES = {
+  eyebrow_L: "brow_L",
+  eyebrow_R: "brow_R",
+  eye_white_L: "eye_L",
+  eye_white_R: "eye_R"
+};
+function roleOf(fileName) {
+  const role = fileName.replace(/\.[^.]+$/, "").toLowerCase().replace(/[-\s]+/g, "_").replace(/_([lr])$/, (_, s) => `_${s.toUpperCase()}`);
+  return ALIASES[role] ?? role;
+}
+function checkArmsHaveBody(roles) {
+  const has = new Set(roles);
+  if (has.has("body")) return;
+  const arm = ROLE_TABLE.find((r) => r.family === "arm" && has.has(r.role));
+  if (arm !== void 0) {
+    throw new Error(
+      `auto-rig: ${arm.role} needs a body layer (an arm hangs from the body's shoulder)`
+    );
+  }
+}
+function parseLayerRoles(fileNames) {
+  const seen = /* @__PURE__ */ new Map();
+  const out = [];
+  for (const fileName of fileNames) {
+    const role = roleOf(fileName);
+    if (!SPEC_BY_ROLE.has(role)) {
+      throw new Error(
+        `auto-rig: "${fileName}" names no known role (expected one of ${ROLE_TABLE.map((r) => r.role).join(", ")})`
+      );
+    }
+    const prior = seen.get(role);
+    if (prior !== void 0) {
+      throw new Error(
+        `auto-rig: role "${role}" is named twice ("${prior}" and "${fileName}")`
+      );
     }
+    seen.set(role, fileName);
+    out.push({ role, fileName });
+  }
+  const missing = REQUIRED_ROLES.filter((r) => !seen.has(r));
+  if (missing.length > 0) {
+    throw new Error(
+      `auto-rig: missing required role${missing.length > 1 ? "s" : ""} ${missing.join(", ")}`
+    );
+  }
+  checkArmsHaveBody(seen.keys());
+  return out;
+}
+
+// src/auto-rig/generate.ts
+var import_format8 = require("@ikijs/format");
+
+// src/auto-rig/animations.ts
+var import_format6 = require("@ikijs/format");
+function browsY(y) {
+  return [
+    { parameter: import_format6.StandardParameter.BrowLeftY, value: y, blend: "add" },
+    { parameter: import_format6.StandardParameter.BrowRightY, value: y, blend: "add" }
   ];
 }
+function browsTilt(innerDown) {
+  return [
+    { parameter: import_format6.StandardParameter.BrowLeftAngle, value: innerDown, blend: "add" },
+    { parameter: import_format6.StandardParameter.BrowRightAngle, value: -innerDown, blend: "add" }
+  ];
+}
+function cheek(value) {
+  return { parameter: import_format6.StandardParameter.Cheek, value, blend: "add" };
+}
+var BROWS = [import_format6.StandardParameter.BrowLeftY, import_format6.StandardParameter.BrowRightY, import_format6.StandardParameter.BrowLeftAngle, import_format6.StandardParameter.BrowRightAngle];
+var EXPRESSIONS = [
+  {
+    id: "smile",
+    description: "Smiling and pleased: warm, friendly, content. For greetings, thanks, agreement and gentle happiness.",
+    parameters: [
+      { parameter: import_format6.StandardParameter.MouthForm, value: 1, blend: "add" },
+      ...browsY(0.25),
+      cheek(0.4)
+    ]
+  },
+  {
+    id: "laugh",
+    description: "Laughing, eyes shut and mouth open: delighted, amused. For jokes, playfulness and big joy.",
+    parameters: [
+      { parameter: import_format6.StandardParameter.EyeOpenLeft, value: 0, blend: "multiply" },
+      { parameter: import_format6.StandardParameter.EyeOpenRight, value: 0, blend: "multiply" },
+      { parameter: import_format6.StandardParameter.MouthForm, value: 1, blend: "add" },
+      { parameter: import_format6.StandardParameter.MouthOpen, value: 0.8, blend: "overwrite" },
+      ...browsY(0.4),
+      cheek(0.65)
+    ]
+  },
+  {
+    id: "angry",
+    description: "Angry or annoyed, frowning. For irritation, frustration, indignation or scolding.",
+    needs: BROWS,
+    parameters: [
+      ...browsY(-0.5),
+      ...browsTilt(0.8),
+      { parameter: import_format6.StandardParameter.MouthForm, value: -0.9, blend: "add" }
+    ]
+  },
+  {
+    id: "sad",
+    description: "Sad or disappointed, downcast. For sorrow, regret, apology or sympathy.",
+    needs: BROWS,
+    parameters: [
+      ...browsY(0.35),
+      ...browsTilt(-0.8),
+      { parameter: import_format6.StandardParameter.MouthForm, value: -0.8, blend: "add" }
+    ]
+  },
+  {
+    id: "surprised",
+    description: "Surprised, mouth dropped open: startled, amazed. For shock, sudden news or disbelief.",
+    parameters: [
+      ...browsY(0.8),
+      { parameter: import_format6.StandardParameter.MouthOpen, value: 0.9, blend: "overwrite" }
+    ]
+  },
+  {
+    id: "shy",
+    description: "Shy or embarrassed: bashful, flustered. For being praised, teased or caught off guard.",
+    needs: [import_format6.StandardParameter.Cheek],
+    parameters: [
+      cheek(1),
+      // Gaze down.
+      { parameter: import_format6.StandardParameter.EyeballY, value: -0.65, blend: "add" },
+      { parameter: import_format6.StandardParameter.MouthForm, value: 0.4, blend: "add" },
+      ...browsTilt(-0.25)
+    ]
+  }
+];
+function defaultExpressions(declared) {
+  return EXPRESSIONS.filter(
+    (e) => e.needs === void 0 || e.needs.some((id) => declared.has(id))
+  ).map(({ needs: _needs, ...e }) => ({
+    ...e,
+    parameters: e.parameters.filter((t) => declared.has(t.parameter))
+  }));
+}
+var DEFAULT_MOTIONS = {
+  Nod: [
+    {
+      description: "Nods yes: agreement, acknowledgement, understanding.",
+      duration: 1,
+      curves: [
+        {
+          parameter: import_format6.StandardParameter.AngleY,
+          keys: [
+            [0, 0],
+            [0.3, -18],
+            [0.6, 4],
+            [0.8, -1],
+            [1, 0]
+          ]
+        }
+      ]
+    }
+  ],
+  Shake: [
+    {
+      description: "Shakes the head no: disagreement, refusal, disbelief.",
+      duration: 1.2,
+      // The first swing peaks at 0.2 s, which the default fade would still
+      // be damping.
+      fadeIn: 0.15,
+      curves: [
+        {
+          parameter: import_format6.StandardParameter.AngleX,
+          keys: [
+            [0, 0],
+            [0.2, -18],
+            [0.45, 18],
+            [0.7, -16],
+            [0.95, 10],
+            [1.2, 0]
+          ]
+        }
+      ]
+    }
+  ],
+  Tilt: [
+    {
+      description: "Tilts the head to one side and back: curiosity, puzzlement, a question.",
+      duration: 1.4,
+      curves: [
+        {
+          parameter: import_format6.StandardParameter.AngleZ,
+          keys: [
+            [0, 0],
+            [0.35, 20],
+            [1, 20],
+            [1.4, 0]
+          ]
+        }
+      ]
+    }
+  ]
+};
 
 // src/auto-rig/checks.ts
 var finite = (v) => typeof v === "number" && Number.isFinite(v);
@@ -5722,13 +5780,14 @@ function declareParameters(roles) {
     add(import_format8.StandardParameter.BodyAngleZ, "Body Angle Z", -10, 10, 0);
   }
   const [armMin, armMax] = ARM_RANGE;
+  const [elbowMin, elbowMax] = ELBOW_RANGE;
   if (roles.has("arm_L")) {
     add(import_format8.StandardParameter.ArmLeft, "Arm L", armMin, armMax, 0);
-    add(import_format8.StandardParameter.ElbowLeft, "Elbow L", armMin, armMax, 0);
+    add(import_format8.StandardParameter.ElbowLeft, "Elbow L", elbowMin, elbowMax, 0);
   }
   if (roles.has("arm_R")) {
     add(import_format8.StandardParameter.ArmRight, "Arm R", armMin, armMax, 0);
-    add(import_format8.StandardParameter.ElbowRight, "Elbow R", armMin, armMax, 0);
+    add(import_format8.StandardParameter.ElbowRight, "Elbow R", elbowMin, elbowMax, 0);
   }
   add(import_format8.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
   add(import_format8.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
@@ -5790,6 +5849,7 @@ function declareParameters(roles) {
   SetPhysicsRig,
   TurnTargetError,
   UV_INSET_PX,
+  armGeometry,
   captureBindingEndpoint,
   computeGridOffsets,
   createDefaultMatrixDeformer,