@ikijs/editor 0.19.0 → 0.21.0

package/dist/index.js

@@ -62,6 +62,7 @@ __export(index_exports, {
   createLayerSetMeasurer: () => createLayerSetMeasurer,
   denseCoreOf: () => denseCoreOf,
   detectAlphaBbox: () => detectAlphaBbox,
+  forearmPoseGeometry: () => forearmPoseGeometry,
   foregroundSpan: () => foregroundSpan,
   generateIkiFromLayerSet: () => generateIkiFromLayerSet,
   headHalfOf: () => headHalfOf,
@@ -1641,7 +1642,16 @@ var ROW_RUN_ROLES = /* @__PURE__ */ new Set([
   "hair_back",
   "body",
   "arm_L",
-  "arm_R"
+  "arm_R",
+  "forearm_pose_L",
+  "forearm_pose_R",
+  "mouth_inner",
+  "lip_lower",
+  "lip_upper"
+]);
+var REST_HIDDEN_ROLES = /* @__PURE__ */ new Set([
+  "forearm_pose_L",
+  "forearm_pose_R"
 ]);
 function createLayerSetMeasurer(canvas) {
   for (const field of ["width", "height"]) {
@@ -1672,6 +1682,7 @@ function createLayerSetMeasurer(canvas) {
     if (bbox === null) return null;
     const rowLeft = new Int32Array(canvasH).fill(canvasW);
     const rowRight = new Int32Array(canvasH).fill(-1);
+    const hidden = REST_HIDDEN_ROLES.has(role);
     const rowRuns = ROW_RUN_ROLES.has(role) ? [] : void 0;
     for (let y = 0; y < canvasH; y++) {
       let runs;
@@ -1687,14 +1698,14 @@ function createLayerSetMeasurer(canvas) {
           runs.push(x);
           inRun = on;
         }
-        if (!on) continue;
+        if (!on || hidden) continue;
         opaque[p] = 1;
         if (x < rowLeft[y]) rowLeft[y] = x;
         if (x > rowRight[y]) rowRight[y] = x;
       }
       if (runs !== void 0 && inRun) runs.push(canvasW);
     }
-    rowSpansByRole.push({ role, rowLeft, rowRight });
+    if (!hidden) rowSpansByRole.push({ role, rowLeft, rowRight });
     const layer = {
       role,
       fileName,
@@ -2249,6 +2260,29 @@ function gridMesh(cols, rows) {
   }
   return { vertices, uvs, indices };
 }
+function columnMesh(b, grid) {
+  const { xs } = grid;
+  const rows = grid.ys.length - 1;
+  const vertices = [];
+  const uvs = [];
+  for (let r = 0; r <= rows; r++) {
+    for (const x of xs) {
+      const u = (x - b.x0) / bw(b);
+      vertices.push(roundTo(u - 0.5, 1e-5), roundTo(0.5 - r / rows, 1e-5));
+      uvs.push(roundTo(u, 1e-5), roundTo(r / rows, 1e-5));
+    }
+  }
+  const n = xs.length;
+  const indices = [];
+  for (let r = 0; r < rows; r++) {
+    for (let c = 0; c + 1 < n; c++) {
+      const tl = r * n + c;
+      const bl = tl + n;
+      indices.push(bl, bl + 1, tl, tl, bl + 1, tl + 1);
+    }
+  }
+  return { vertices, uvs, indices };
+}
 function meshPoints(mesh, box) {
   const out = [];
   for (let i = 0; i < mesh.vertices.length; i += 2) {
@@ -2372,10 +2406,13 @@ function browBindings(side, reach) {
   ];
 }
 var BROW_TILT = 15;
-function mouthForm(mesh, box) {
-  const a = 0.3 * bh(box);
-  const c = cx(box);
-  const half = bw(box) / 2;
+var mouthFrameOf = (box) => ({
+  c: cx(box),
+  half: bw(box) / 2,
+  amp: 0.3 * bh(box)
+});
+function mouthForm(mesh, box, frame = mouthFrameOf(box)) {
+  const { c, half, amp: a } = frame;
   return localWarp(import_format3.StandardParameter.MouthForm, mesh, box, [-1, 0, 1], ([x], v) => {
     if (v === 0) return [0, 0];
     const u = (x - c) / half;
@@ -2393,8 +2430,8 @@ function mouthOpenGrow(mesh, box) {
     ([x, y], v) => v === 1 ? [(AMPLITUDE.mouthOpenWidth - 1) * (x - c), 0] : [0, box.y1 + (y - box.y1) * 0.2 - y]
   );
 }
-function mouthWiden(mesh, box) {
-  const c = cx(box);
+function mouthWiden(mesh, box, frame = mouthFrameOf(box)) {
+  const c = frame.c;
   return localWarp(import_format3.StandardParameter.MouthOpen, mesh, box, [0, 1], ([x], v) => [
     v * (AMPLITUDE.mouthOpenWidth - 1) * (x - c),
     0
@@ -2777,40 +2814,56 @@ var ARM_IDS = {
     forearmDeformer: "forearmDeformer_R"
   }
 };
-function armGeometry(layer, bodyAxisX) {
+function endPivot(layer, end) {
   const { bbox, canvasW, canvasH, rowRuns } = layer;
-  const b = boxOfLayer(layer);
-  const span = (k) => {
+  const span = runSpan(layer);
+  const from = (k) => end === "top" ? k : bbox.h - 1 - k;
+  const painted = rowRuns?.flatMap((runs, k) => runs.length > 0 ? [k] : []) ?? [];
+  const firstK = end === "top" ? painted[0] ?? 0 : painted.at(-1) ?? bbox.h - 1;
+  const lo = Math.ceil(CAP_ROWS[0] * bbox.h);
+  const hi = Math.max(lo, Math.floor(CAP_ROWS[1] * bbox.h));
+  const widths = [];
+  for (let k = lo; k <= hi; k++) {
+    const [s2, e2] = span(from(k));
+    widths.push(e2 - s2);
+  }
+  widths.sort((p, q) => p - q);
+  const radius = widths[widths.length >> 1] / 2;
+  const ks = end === "top" ? firstK + radius : firstK - radius;
+  const [s, e] = span(Math.round(ks));
+  return {
+    point: {
+      x: roundTo((s + e) / 2 - canvasW / 2, 0.01),
+      y: roundTo(canvasH / 2 - (bbox.y + ks + 0.5), 0.01)
+    },
+    radius,
+    row: ks
+  };
+}
+function runSpan(layer) {
+  const { bbox, rowRuns } = layer;
+  return (k) => {
     const runs = rowRuns?.[k] ?? [];
     if (runs.length === 0) return [bbox.x, bbox.x + bbox.w];
-    let [s2, e2] = [runs[0], runs[1]];
+    let [s, e] = [runs[0], runs[1]];
     for (let i = 2; i < runs.length; i += 2) {
-      if (runs[i + 1] - runs[i] > e2 - s2) [s2, e2] = [runs[i], runs[i + 1]];
+      if (runs[i + 1] - runs[i] > e - s) [s, e] = [runs[i], runs[i + 1]];
     }
-    return [s2, e2];
+    return [s, e];
   };
+}
+function armGeometry(layer, bodyAxisX) {
+  const { bbox, canvasW, canvasH, rowRuns } = layer;
+  const b = boxOfLayer(layer);
+  const span = runSpan(layer);
   const centreX = (k) => {
     const [s2, e2] = span(k);
     return (s2 + e2) / 2 - canvasW / 2;
   };
   const rowY = (k) => canvasH / 2 - (bbox.y + k + 0.5);
   const painted = rowRuns?.flatMap((runs, k) => runs.length > 0 ? [k] : []) ?? [];
-  const first = painted[0] ?? 0;
   const last = painted.at(-1) ?? bbox.h - 1;
-  const lo = Math.ceil(CAP_ROWS[0] * bbox.h);
-  const hi = Math.max(lo, Math.floor(CAP_ROWS[1] * bbox.h));
-  const widths = [];
-  for (let k = lo; k <= hi; k++) {
-    const [s2, e2] = span(k);
-    widths.push(e2 - s2);
-  }
-  widths.sort((p, q) => p - q);
-  const ru = widths[widths.length >> 1] / 2;
-  const ks = first + ru;
-  const shoulder = {
-    x: roundTo(centreX(Math.round(ks)), 0.01),
-    y: roundTo(rowY(ks), 0.01)
-  };
+  const { point: shoulder, radius: ru, row: ks } = endPivot(layer, "top");
   const ke = Math.round(ks + ELBOW_AT * (last - ks));
   if (ke <= ks) {
     throw new LayerGeometryError(
@@ -2858,7 +2911,7 @@ function meshOf(vertices, indices) {
   );
   return { vertices, uvs, indices };
 }
-function armParts(role, layer, g, order) {
+function armParts(role, layer, g, order, poseSwitch) {
   const b = boxOfLayer(layer);
   const lx = (x) => roundTo((x - cx(b)) / bw(b), 1e-5);
   const ly = (y) => roundTo((y - cy(b)) / bh(b), 1e-5);
@@ -2911,7 +2964,7 @@ function armParts(role, layer, g, order) {
     const [p, q] = [ringInner + j, ringOuter + j];
     ring.push(p, q, q + 1, p, q + 1, p + 1);
   }
-  const part = (id, deformer, z, mesh) => ({
+  const part = (id, deformer, z, mesh, swaps = false) => ({
     id,
     color: [1, 1, 1, 1],
     width: bw(b),
@@ -2919,50 +2972,124 @@ function armParts(role, layer, g, order) {
     transform: { x: cx(b), y: cy(b) },
     order: z,
     deformer,
-    mesh
+    mesh,
+    ...swaps && poseSwitch !== void 0 ? {
+      bindings: [
+        {
+          parameter: poseSwitch,
+          channel: "opacity",
+          from: 1,
+          to: 0
+        }
+      ]
+    } : {}
   });
   const ids = ARM_IDS[role];
   return [
-    part(ids.cap, ids.forearmDeformer, order, {
-      vertices,
-      uvs,
-      indices: [...fan, ...ring]
-    }),
+    part(
+      ids.cap,
+      ids.forearmDeformer,
+      order,
+      {
+        vertices,
+        uvs,
+        indices: [...fan, ...ring]
+      },
+      true
+    ),
     part(role, ids.armDeformer, order + 1, meshOf(band(0.5, seam), quad)),
     part(
       ids.forearm,
       ids.forearmDeformer,
       order + 2,
-      meshOf(band(seam, -0.5), quad)
+      meshOf(band(seam, -0.5), quad),
+      true
     )
   ];
 }
+var rotateBinding = (parameter, range, sign) => ({
+  parameter,
+  channel: "rotate",
+  from: sign * range[0],
+  to: sign * range[1]
+});
 function armDeformers(role, g) {
   const ids = ARM_IDS[role];
   const params = ARM_PARAMS[role];
-  const rotate = (parameter, range, sign) => ({
-    parameter,
-    channel: "rotate",
-    from: sign * range[0],
-    to: sign * range[1]
-  });
   return [
     {
       id: ids.armDeformer,
       parent: BODY_WARP_ID,
       pivot: { ...g.shoulder },
-      bindings: [rotate(params.arm, ARM_RANGE, g.side)]
+      bindings: [rotateBinding(params.arm, ARM_RANGE, g.side)]
     },
     {
       id: ids.forearmDeformer,
       parent: ids.armDeformer,
       pivot: { ...g.elbow },
-      bindings: [rotate(params.elbow, ELBOW_RANGE, -g.side)]
+      bindings: [rotateBinding(params.elbow, ELBOW_RANGE, -g.side)]
     }
   ];
 }
 
+// src/auto-rig/forearm-pose.ts
+var import_format6 = require("@ikijs/format");
+var ARM_OF_POSE = {
+  forearm_pose_L: "arm_L",
+  forearm_pose_R: "arm_R"
+};
+var POSE_OF_ARM = {
+  arm_L: "forearm_pose_L",
+  arm_R: "forearm_pose_R"
+};
+var POSE_PARAMS = {
+  forearm_pose_L: { pose: import_format6.StandardParameter.ArmPoseLeft, angle: import_format6.StandardParameter.ArmPoseAngleLeft },
+  forearm_pose_R: { pose: import_format6.StandardParameter.ArmPoseRight, angle: import_format6.StandardParameter.ArmPoseAngleRight }
+};
+var POSE_IDS = {
+  forearm_pose_L: "armPoseDeformer_L",
+  forearm_pose_R: "armPoseDeformer_R"
+};
+var POSE_ANGLE_RANGE = [-15, 15];
+function forearmPoseGeometry(layer) {
+  const { point, radius } = endPivot(layer, "bottom");
+  const first = layer.rowRuns?.findIndex((runs) => runs.length > 0) ?? -1;
+  const k = first < 0 ? 0 : first;
+  return {
+    pivot: point,
+    radius,
+    top: roundTo(layer.canvasH / 2 - (layer.bbox.y + k + 0.5), 0.01)
+  };
+}
+function forearmPosePart(role, layer, order) {
+  const b = boxOfLayer(layer);
+  return {
+    id: role,
+    color: [1, 1, 1, 1],
+    width: bw(b),
+    height: bh(b),
+    transform: { x: cx(b), y: cy(b) },
+    order,
+    deformer: POSE_IDS[role],
+    bindings: [
+      { parameter: POSE_PARAMS[role].pose, channel: "opacity", from: 0, to: 1 }
+    ]
+  };
+}
+function forearmPoseDeformer(role, arm) {
+  return {
+    id: POSE_IDS[role],
+    parent: ARM_IDS[ARM_OF_POSE[role]].armDeformer,
+    pivot: { ...arm.elbow },
+    bindings: [
+      rotateBinding(POSE_PARAMS[role].angle, POSE_ANGLE_RANGE, -arm.side)
+    ]
+  };
+}
+
 // src/auto-rig/roles.ts
+var LIP_ROLES = ["mouth_inner", "lip_lower", "lip_upper"];
+var isLipRole = (role) => LIP_ROLES.includes(role);
 var ROLE_TABLE = [
   { role: "hair_back", family: "hair_back" },
   { role: "body", family: "body" },
@@ -2972,8 +3099,14 @@ var ROLE_TABLE = [
   { role: "blush_L", family: "face" },
   { role: "blush_R", family: "face" },
   { role: "nose", family: "nose" },
-  { role: "mouth", family: "mouth", required: true },
+  { role: "mouth", family: "mouth" },
   { role: "mouth_open", family: "mouth" },
+  // The lip set, back to front: the interior, the lower lip's skin, the upper
+  // lip and its line over both. It folds open instead of crossfading
+  // (`mouth.ts`), so it stands in for `mouth`, never beside it.
+  { role: "mouth_inner", family: "mouth" },
+  { role: "lip_lower", family: "mouth" },
+  { role: "lip_upper", family: "mouth" },
   { role: "eye_L", family: "eye_L", required: true },
   { role: "eye_R", family: "eye_R", required: true },
   { role: "iris_L", family: "eye_L" },
@@ -2988,7 +3121,10 @@ var ROLE_TABLE = [
   { role: "lash_R", family: "eye_R" },
   { role: "brow_L", family: "brow_L" },
   { role: "brow_R", family: "brow_R" },
-  { role: "hair_front", family: "hair_front" }
+  { role: "hair_front", family: "hair_front" },
+  // Drawn above the face and the hair: a raised hand passes them.
+  { role: "forearm_pose_L", family: "forearm_pose" },
+  { role: "forearm_pose_R", family: "forearm_pose" }
 ];
 var REQUIRED_ROLES = ROLE_TABLE.filter(
   (r) => r.required
@@ -3028,6 +3164,39 @@ function checkArmsHaveBody(roles) {
     );
   }
 }
+function checkMouth(roles) {
+  const has = new Set(roles);
+  const present = LIP_ROLES.filter((r) => has.has(r));
+  if (present.length === 0) {
+    if (!has.has("mouth")) {
+      throw new Error(
+        `auto-rig: missing required role mouth (or the lip set ${LIP_ROLES.join(", ")})`
+      );
+    }
+    return;
+  }
+  if (present.length < LIP_ROLES.length) {
+    throw new Error(
+      `auto-rig: the lip set is partial: missing ${LIP_ROLES.filter((r) => !has.has(r)).join(", ")}`
+    );
+  }
+  const mixed = ["mouth", "mouth_open"].filter((r) => has.has(r));
+  if (mixed.length > 0) {
+    throw new Error(
+      `auto-rig: the lip set cannot be mixed with ${mixed.join(", ")} (the lip set replaces the mouth drawings; use one or the other)`
+    );
+  }
+}
+function checkPosesHaveArms(roles) {
+  const has = new Set(roles);
+  for (const side of ["L", "R"]) {
+    if (has.has(`forearm_pose_${side}`) && !has.has(`arm_${side}`)) {
+      throw new Error(
+        `auto-rig: forearm_pose_${side} needs an arm_${side} layer (a pose forearm hangs from its arm's elbow)`
+      );
+    }
+  }
+}
 function parseLayerRoles(fileNames) {
   const seen = /* @__PURE__ */ new Map();
   const out = [];
@@ -3053,37 +3222,39 @@ function parseLayerRoles(fileNames) {
       `auto-rig: missing required role${missing.length > 1 ? "s" : ""} ${missing.join(", ")}`
     );
   }
+  checkMouth(seen.keys());
   checkArmsHaveBody(seen.keys());
+  checkPosesHaveArms(seen.keys());
   return out;
 }
 
 // src/auto-rig/generate.ts
-var import_format8 = require("@ikijs/format");
+var import_format10 = require("@ikijs/format");
 
 // src/auto-rig/animations.ts
-var import_format6 = require("@ikijs/format");
+var import_format7 = 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" }
+    { parameter: import_format7.StandardParameter.BrowLeftY, value: y, blend: "add" },
+    { parameter: import_format7.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" }
+    { parameter: import_format7.StandardParameter.BrowLeftAngle, value: innerDown, blend: "add" },
+    { parameter: import_format7.StandardParameter.BrowRightAngle, value: -innerDown, blend: "add" }
   ];
 }
 function cheek(value) {
-  return { parameter: import_format6.StandardParameter.Cheek, value, blend: "add" };
+  return { parameter: import_format7.StandardParameter.Cheek, value, blend: "add" };
 }
-var BROWS = [import_format6.StandardParameter.BrowLeftY, import_format6.StandardParameter.BrowRightY, import_format6.StandardParameter.BrowLeftAngle, import_format6.StandardParameter.BrowRightAngle];
+var BROWS = [import_format7.StandardParameter.BrowLeftY, import_format7.StandardParameter.BrowRightY, import_format7.StandardParameter.BrowLeftAngle, import_format7.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" },
+      { parameter: import_format7.StandardParameter.MouthForm, value: 1, blend: "add" },
       ...browsY(0.25),
       cheek(0.4)
     ]
@@ -3092,10 +3263,10 @@ var EXPRESSIONS = [
     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" },
+      { parameter: import_format7.StandardParameter.EyeOpenLeft, value: 0, blend: "multiply" },
+      { parameter: import_format7.StandardParameter.EyeOpenRight, value: 0, blend: "multiply" },
+      { parameter: import_format7.StandardParameter.MouthForm, value: 1, blend: "add" },
+      { parameter: import_format7.StandardParameter.MouthOpen, value: 0.8, blend: "overwrite" },
       ...browsY(0.4),
       cheek(0.65)
     ]
@@ -3107,7 +3278,7 @@ var EXPRESSIONS = [
     parameters: [
       ...browsY(-0.5),
       ...browsTilt(0.8),
-      { parameter: import_format6.StandardParameter.MouthForm, value: -0.9, blend: "add" }
+      { parameter: import_format7.StandardParameter.MouthForm, value: -0.9, blend: "add" }
     ]
   },
   {
@@ -3117,7 +3288,7 @@ var EXPRESSIONS = [
     parameters: [
       ...browsY(0.35),
       ...browsTilt(-0.8),
-      { parameter: import_format6.StandardParameter.MouthForm, value: -0.8, blend: "add" }
+      { parameter: import_format7.StandardParameter.MouthForm, value: -0.8, blend: "add" }
     ]
   },
   {
@@ -3125,18 +3296,18 @@ var EXPRESSIONS = [
     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" }
+      { parameter: import_format7.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],
+    needs: [import_format7.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" },
+      { parameter: import_format7.StandardParameter.EyeballY, value: -0.65, blend: "add" },
+      { parameter: import_format7.StandardParameter.MouthForm, value: 0.4, blend: "add" },
       ...browsTilt(-0.25)
     ]
   }
@@ -3149,14 +3320,14 @@ function defaultExpressions(declared) {
     parameters: e.parameters.filter((t) => declared.has(t.parameter))
   }));
 }
-var DEFAULT_MOTIONS = {
+var HEAD_MOTIONS = {
   Nod: [
     {
       description: "Nods yes: agreement, acknowledgement, understanding.",
       duration: 1,
       curves: [
         {
-          parameter: import_format6.StandardParameter.AngleY,
+          parameter: import_format7.StandardParameter.AngleY,
           keys: [
             [0, 0],
             [0.3, -18],
@@ -3177,7 +3348,7 @@ var DEFAULT_MOTIONS = {
       fadeIn: 0.15,
       curves: [
         {
-          parameter: import_format6.StandardParameter.AngleX,
+          parameter: import_format7.StandardParameter.AngleX,
           keys: [
             [0, 0],
             [0.2, -18],
@@ -3196,7 +3367,7 @@ var DEFAULT_MOTIONS = {
       duration: 1.4,
       curves: [
         {
-          parameter: import_format6.StandardParameter.AngleZ,
+          parameter: import_format7.StandardParameter.AngleZ,
           keys: [
             [0, 0],
             [0.35, 20],
@@ -3208,6 +3379,55 @@ var DEFAULT_MOTIONS = {
     }
   ]
 };
+var WAVE = {
+  Wave: [
+    {
+      description: "Waves hello with the right hand: greeting, goodbye, getting attention.",
+      duration: 2.2,
+      fadeIn: 0.15,
+      fadeOut: 0.15,
+      curves: [
+        {
+          parameter: import_format7.StandardParameter.ArmPoseRight,
+          interpolation: "linear",
+          keys: [
+            [0, 0],
+            [0.15, 1],
+            [2.05, 1],
+            [2.2, 0]
+          ]
+        },
+        {
+          parameter: import_format7.StandardParameter.ArmRight,
+          keys: [
+            [0, 0],
+            [0.4, 10],
+            [1.8, 10],
+            [2.2, 0]
+          ]
+        },
+        {
+          parameter: import_format7.StandardParameter.ArmPoseAngleRight,
+          keys: [
+            [0, 0],
+            [0.5, 0],
+            [0.7, 12],
+            [1, -12],
+            [1.3, 12],
+            [1.7, 0],
+            [2.2, 0]
+          ]
+        }
+      ]
+    }
+  ]
+};
+function defaultMotions(declared) {
+  const waves = [import_format7.StandardParameter.ArmRight, import_format7.StandardParameter.ArmPoseRight, import_format7.StandardParameter.ArmPoseAngleRight].every(
+    (id) => declared.has(id)
+  );
+  return waves ? { ...HEAD_MOTIONS, ...WAVE } : HEAD_MOTIONS;
+}
 
 // src/auto-rig/checks.ts
 var finite = (v) => typeof v === "number" && Number.isFinite(v);
@@ -3312,7 +3532,16 @@ function checkLayers(layers, canvas) {
   if (missing.length > 0) {
     throw new Error(`auto-rig: missing required role(s) ${missing.join(", ")}`);
   }
+  checkMouth(seen);
+  for (const l of layers) {
+    if (l.rowRuns === void 0 && isLipRole(l.role)) {
+      throw new Error(
+        `auto-rig: layer "${l.fileName}": the lip set needs rowRuns (the fold reads the opening's rows off them; measure with createLayerSetMeasurer)`
+      );
+    }
+  }
   checkArmsHaveBody(seen);
+  checkPosesHaveArms(seen);
 }
 function checkHeadEdges(edges, byRole) {
   if (edges === void 0) return;
@@ -3430,7 +3659,180 @@ function checkStrandEdges(strand, irises, hair) {
 }
 
 // src/auto-rig/context.ts
-var import_format7 = require("@ikijs/format");
+var import_format9 = require("@ikijs/format");
+
+// src/auto-rig/mouth.ts
+var import_format8 = require("@ikijs/format");
+var UPPER_SHARE = 0.3;
+var MOUTH_KNOT_PX = 4;
+var isLipSet = (byRole) => LIP_ROLES.every((r) => byRole.has(r));
+function columnRuns(layer) {
+  const cols = /* @__PURE__ */ new Map();
+  (layer.rowRuns ?? []).forEach((runs, k) => {
+    for (let i = 0; i < runs.length; i += 2) {
+      for (let c = runs[i]; c < runs[i + 1]; c++) {
+        const list = cols.get(c) ?? [];
+        const last = list[list.length - 1];
+        if (last !== void 0 && last[1] === k) last[1] = k + 1;
+        else list.push([k, k + 1]);
+        cols.set(c, list);
+      }
+    }
+  });
+  return cols;
+}
+var edgesOf = (layer, run) => ({
+  top: layer.canvasH / 2 - (layer.bbox.y + run[0]),
+  bottom: layer.canvasH / 2 - (layer.bbox.y + run[1])
+});
+function mouthOpening(byRole) {
+  const inner = byRole.get("mouth_inner");
+  const upper = byRole.get("lip_upper");
+  const lower = byRole.get("lip_lower");
+  const innerCols = columnRuns(inner);
+  if (innerCols.size === 0) {
+    throw new LayerGeometryError(
+      `auto-rig: layer "${inner.fileName}": mouth_inner has no opaque pixel (alpha \u2265 128) to read the opening off`
+    );
+  }
+  const upperCols = columnRuns(upper);
+  const lowerCols = columnRuns(lower);
+  const cols = [...innerCols.keys()];
+  const x0 = Math.min(...cols);
+  const x1 = Math.max(...cols);
+  const read = (col) => {
+    const runs = innerCols.get(col);
+    if (runs === void 0) return void 0;
+    const T = edgesOf(inner, runs[0]).top;
+    const Bb = edgesOf(inner, runs[runs.length - 1]).bottom;
+    const line = [...upperCols.get(col) ?? []].reverse().map((r) => edgesOf(upper, r)).find((e) => e.top >= T);
+    const Tu = line?.bottom ?? T;
+    const lineTop = line?.top ?? T;
+    const skin = lowerCols.get(col)?.[0];
+    return {
+      T,
+      Bb,
+      Tu,
+      lineTop,
+      lineH: lineTop - Tu,
+      Bl: skin === void 0 ? Bb : edgesOf(lower, skin).top,
+      H: T - Bb,
+      seam: T - UPPER_SHARE * (T - Bb)
+    };
+  };
+  const reads = [];
+  for (let c = x0; c <= x1; c++) {
+    let r;
+    for (let d = 0; (r = read(c - d) ?? read(c + d)) === void 0; d++) ;
+    reads.push(r);
+  }
+  const base = (col) => reads[Math.min(x1, Math.max(x0, col)) - x0];
+  const centre = Math.round((x0 + x1) / 2);
+  const w = base(centre).lineH;
+  return {
+    x0,
+    x1,
+    centre,
+    canvasW: inner.canvasW,
+    w,
+    at(col) {
+      const b = base(col);
+      return { ...b, overlap: Math.max(0, Math.min(w, b.lineH)) };
+    }
+  };
+}
+function mouthFold(role, opening) {
+  return (col, y, v) => {
+    if (v === 1) return 0;
+    if (role !== "mouth_inner" && (col < opening.x0 || col > opening.x1))
+      return 0;
+    const c = opening.at(col);
+    const k = 1 - v;
+    switch (role) {
+      case "lip_upper":
+        return (c.seam - c.Tu) * k;
+      case "lip_lower":
+        return (c.seam + c.overlap - c.Bl) * k;
+      case "mouth_inner":
+        return (c.seam + c.overlap - y) * k;
+    }
+  };
+}
+function columnOfKnot(knot, opening, role) {
+  const boundary = Math.round(knot + opening.canvasW / 2);
+  const col = boundary === opening.x1 + 1 ? opening.x1 : boundary;
+  if (col >= opening.x0 && col <= opening.x1) return col;
+  return role === "mouth_inner" ? Math.min(opening.x1, Math.max(opening.x0, col)) : void 0;
+}
+function mouthFoldWarp(role, mesh, xs, box, opening) {
+  const fold = mouthFold(role, opening);
+  return localWarp(import_format8.StandardParameter.MouthOpen, mesh, box, [0, 1], (p, v, i) => {
+    const col = columnOfKnot(xs[i % xs.length], opening, role);
+    return [0, col === void 0 ? 0 : fold(col, p[1], v)];
+  });
+}
+function mouthKnots(union, opening) {
+  const half = opening.canvasW / 2;
+  const step = MOUTH_KNOT_PX;
+  const xs = [union.x0];
+  while (xs[xs.length - 1] + step < union.x1 - 0.3 * step)
+    xs.push(xs[xs.length - 1] + step);
+  xs.push(union.x1);
+  const fixed = /* @__PURE__ */ new Set([union.x0, union.x1]);
+  for (const x of [opening.x0 - half, opening.x1 + 1 - half]) {
+    fixed.add(x);
+    if (xs.includes(x)) continue;
+    const near = xs.findIndex((v) => Math.abs(v - x) < 0.3 * step);
+    if (near >= 0 && !fixed.has(xs[near])) xs[near] = x;
+    else xs.push(x);
+  }
+  xs.sort((p, q) => p - q);
+  for (const x of xs) {
+    if (!Number.isInteger(x + half)) {
+      throw new Error(
+        `auto-rig: mouth knot ${x} is not an integer canvas boundary`
+      );
+    }
+  }
+  return xs;
+}
+function mouthMesh(box, knots) {
+  const xs = [box.x0, ...knots.filter((k) => k > box.x0 && k < box.x1), box.x1];
+  const rows = cellsFor(bh(box), MOUTH_KNOT_PX, 2, 40);
+  const ys = Array.from(
+    { length: rows + 1 },
+    (_, r) => box.y1 - bh(box) * r / rows
+  );
+  return { mesh: columnMesh(box, { xs, ys }), xs };
+}
+function buildMouthRig(byRole) {
+  const opening = mouthOpening(byRole);
+  const union = unionBoxes(LIP_ROLES.map((r) => boxOfLayer(byRole.get(r))));
+  return {
+    opening,
+    frame: mouthFrameOf(union),
+    knots: mouthKnots(union, opening),
+    union
+  };
+}
+function mouthAnchor(byRole) {
+  const box = (role) => boxOfLayer(byRole.get(role));
+  if (isLipSet(byRole)) {
+    const opening = mouthOpening(byRole);
+    return {
+      at: {
+        x: cx(box("mouth_inner")),
+        y: opening.at(opening.centre).seam
+      },
+      box: unionBoxes(LIP_ROLES.map(box))
+    };
+  }
+  const m = box("mouth");
+  return {
+    at: { x: cx(m), y: cy(m) },
+    box: byRole.has("mouth_open") ? unionBoxes([m, box("mouth_open")]) : m
+  };
+}
 
 // src/auto-rig/head.ts
 function outerEdge(runs, axisX, side) {
@@ -3510,7 +3912,7 @@ function buildHeadFrame(layers, opts) {
     return ya === void 0 || yb === void 0 ? void 0 : (ya + yb) / 2;
   };
   const eyeY = pair("iris_L", "iris_R") ?? pair("eye_L", "eye_R");
-  const mouthY = centreY("mouth");
+  const mouthY = mouthAnchor(byRole).at.y;
   const rowY = (r) => canvasH / 2 - (faceLayer.bbox.y + r + 0.5);
   const raw = filledProfile(faceLayer.rowHalfWidths);
   const profile = raw === null ? null : smoothProfile(raw);
@@ -4462,6 +4864,7 @@ function familyField(m, family) {
       return hairField(m, m.hairBack, NOD.hairBack);
     case "body":
     case "arm":
+    case "forearm_pose":
       return () => [0, 0];
   }
 }
@@ -4482,7 +4885,6 @@ function sideIrises(byRole) {
   return pair === void 0 ? {} : { left: pair.left.box, right: pair.right.box };
 }
 function solveContext(frame, byRole, options, hasNose) {
-  const box = (role) => boxOfLayer(byRole.get(role));
   const row = (s, strand2, sideSign) => {
     if (strand2 !== void 0) {
       const lo = sideSign < 0 ? strand2.irisOuter : strand2.irisInner;
@@ -4531,8 +4933,7 @@ function solveContext(frame, byRole, options, hasNose) {
     noseBox = nose.denseCore ? boxOfPixels(nose.denseCore, nose.canvasW, nose.canvasH) : boxOfLayer(nose);
     noseAt = { x: cx(noseBox), y: cy(noseBox) };
   }
-  const mouthBox = byRole.has("mouth_open") ? unionBoxes([box("mouth"), box("mouth_open")]) : box("mouth");
-  const m = box("mouth");
+  const mouth = mouthAnchor(byRole);
   return {
     frame,
     left,
@@ -4544,8 +4945,8 @@ function solveContext(frame, byRole, options, hasNose) {
     eyeBoxes: { left: eyes.left.box, right: eyes.right.box },
     noseAt,
     noseBox,
-    mouthAt: { x: cx(m), y: cy(m) },
-    mouthBox
+    mouthAt: mouth.at,
+    mouthBox: mouth.box
   };
 }
 function renderedLander(turn, parts, grids, from = /* @__PURE__ */ new Map()) {
@@ -4561,7 +4962,7 @@ function renderedLander(turn, parts, grids, from = /* @__PURE__ */ new Map()) {
     const family = roleSpec(role).family;
     const part = parts.find((p) => p.id === role);
     const g = grids.get(family);
-    const warp = part?.warps?.find((w) => w.parameter === import_format7.StandardParameter.AngleX);
+    const warp = part?.warps?.find((w) => w.parameter === import_format9.StandardParameter.AngleX);
     if (part === void 0 || part.mesh === void 0 || !g && !warp) {
       return x + field(role)(x, y, ax, 0)[0];
     }
@@ -5297,6 +5698,7 @@ var WARP_ID = {
 };
 var isGridFamily = (f) => f in WARP_ID;
 var isArm = (spec) => spec.family === "arm";
+var isPose = (spec) => spec.family === "forearm_pose";
 var GRID_PAD = 6;
 function generateIkiFromLayerSet(layers, canvas, options = {}) {
   checkLayers(layers, canvas);
@@ -5357,6 +5759,7 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
     hh: frame.hh,
     pivots: [...arms.values()].map((g) => g.shoulder)
   }) : void 0;
+  const lips = isLipSet(byRole) ? buildMouthRig(byRole) : void 0;
   const parts = [];
   const reach = /* @__PURE__ */ new Map();
   let regionOf = [];
@@ -5365,11 +5768,22 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
     const layer = byRole.get(spec.role);
     if (layer === void 0) continue;
     if (isArm(spec)) {
+      const pose = POSE_OF_ARM[spec.role];
       parts.push(
-        ...armParts(spec.role, layer, arms.get(spec.role), parts.length)
+        ...armParts(
+          spec.role,
+          layer,
+          arms.get(spec.role),
+          parts.length,
+          has(pose) ? POSE_PARAMS[pose].pose : void 0
+        )
       );
       continue;
     }
+    if (isPose(spec)) {
+      parts.push(forearmPosePart(spec.role, layer, parts.length));
+      continue;
+    }
     const built = buildPart(
       spec,
       boxOfLayer(layer),
@@ -5377,7 +5791,8 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
       frame,
       byRole,
       style,
-      landmarks.hairFrontGrid
+      landmarks.hairFrontGrid,
+      lips
     );
     if (built.region !== void 0) {
       regionOf = built.region;
@@ -5422,7 +5837,7 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
       part.mesh = bodyWarp.mesh;
       continue;
     }
-    if (family === "arm") continue;
+    if (family === "arm" || family === "forearm_pose") continue;
     part.deformer = "headDeformer";
     if (part.mesh === void 0) continue;
     const own = familyField(turn, family);
@@ -5434,17 +5849,17 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
   }
   const parameters = declareParameters(new Set(byRole.keys()));
   const model = {
-    version: import_format8.IKI_FORMAT_VERSION,
+    version: import_format10.IKI_FORMAT_VERSION,
     name: "auto-rigged",
     canvas: { width: canvas.width, height: canvas.height },
     parameters,
     parts,
-    deformers: deformers(frame, grids, bodyWarp?.deformer, arms),
+    deformers: deformers(frame, grids, bodyWarp?.deformer, arms, byRole),
     ...has("hair_front") ? { physics: hairPhysics() } : {},
     expressions: defaultExpressions(new Set(parameters.map((p) => p.id))),
-    motions: DEFAULT_MOTIONS
+    motions: defaultMotions(new Set(parameters.map((p) => p.id)))
   };
-  const valid = (0, import_format8.parseIkiModel)(model);
+  const valid = (0, import_format10.parseIkiModel)(model);
   if (hasNose && options.onTurnSolved) {
     options.onTurnSolved(
       turnReport(
@@ -5459,14 +5874,14 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
 function turnWarps(mesh, b, fieldOf) {
   return [
     localWarp(
-      import_format8.StandardParameter.AngleX,
+      import_format10.StandardParameter.AngleX,
       mesh,
       b,
       X_STOPS,
       ([x, y], v, i) => v === 0 ? [0, 0] : [fieldOf(i)(x, y, v, 0)[0], 0]
     ),
     localWarp(
-      import_format8.StandardParameter.AngleY,
+      import_format10.StandardParameter.AngleY,
       mesh,
       b,
       Y_STOPS,
@@ -5479,7 +5894,7 @@ function plateFields(turn, region, head) {
   const neck = neckField(turn);
   return (i) => region[i] === "ear" ? ear : region[i] === "neck" ? neck : head;
 }
-function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
+function buildPart(spec, b, order, frame, byRole, style, frontGrid, lips) {
   const box = (role) => boxOfLayer(byRole.get(role));
   const part = {
     id: spec.role,
@@ -5494,6 +5909,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
   const bindings = [];
   let extra = [0, 0];
   let mesh;
+  let knotXs;
   let region;
   let headStart = 0;
   if (spec.role === "face") {
@@ -5504,6 +5920,8 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
     headStart = fm.headStart;
   } else if (spec.role === "hair_front") {
     mesh = columnMesh(b, frontGrid);
+  } else if (lips !== void 0 && isLipRole(spec.role)) {
+    ({ mesh, xs: knotXs } = mouthMesh(b, lips.knots));
   } else if (spec.family !== "body") {
     const cells = MESH_CELLS[spec.role] ?? FEATURE_MESH_CELLS;
     const px = Math.min(cells.px, meshScale(spec.role, frame));
@@ -5514,7 +5932,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
   }
   if (mesh !== void 0) part.mesh = mesh;
   const side = spec.role.endsWith("_L") ? "L" : "R";
-  const eyeOpen = side === "L" ? import_format8.StandardParameter.EyeOpenLeft : import_format8.StandardParameter.EyeOpenRight;
+  const eyeOpen = side === "L" ? import_format10.StandardParameter.EyeOpenLeft : import_format10.StandardParameter.EyeOpenRight;
   const hh = frame.hh;
   switch (spec.role) {
     case "face":
@@ -5529,7 +5947,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
             headOwnRoll(byRole.has("body"))
           ),
           localWarp(
-            import_format8.StandardParameter.Breath,
+            import_format10.StandardParameter.Breath,
             mesh,
             b,
             [0, 1],
@@ -5576,8 +5994,8 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
       if (byRole.has("mouth_open")) {
         warps.push(mouthWiden(mesh, b));
         bindings.push(
-          { parameter: import_format8.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 },
-          { parameter: import_format8.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 }
+          { parameter: import_format10.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 },
+          { parameter: import_format10.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 }
         );
         extra = [(AMPLITUDE.mouthOpenWidth - 1) * (bw(b) / 2), 0];
       } else {
@@ -5587,19 +6005,19 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
         );
         bindings.push(
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format10.StandardParameter.MouthOpen,
             channel: "scaleY",
             from: 0,
             to: roundTo(grow, 0.01)
           },
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format10.StandardParameter.MouthOpen,
             channel: "scaleX",
             from: 0,
             to: roundTo(AMPLITUDE.mouthOpenWidth - 1, 0.01)
           },
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format10.StandardParameter.MouthOpen,
             channel: "translateY",
             from: 0,
             to: -roundTo(grow * bh(b) / 2, 0.01)
@@ -5611,17 +6029,26 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
     case "mouth_open":
       warps.push(mouthForm(mesh, b), mouthOpenGrow(mesh, b));
       bindings.push({
-        parameter: import_format8.StandardParameter.MouthOpen,
+        parameter: import_format10.StandardParameter.MouthOpen,
         channel: "opacity",
         from: 0,
         to: 1
       });
       extra = [(AMPLITUDE.mouthOpenWidth - 1) * (bw(b) / 2), 0];
       break;
+    case "mouth_inner":
+    case "lip_lower":
+    case "lip_upper":
+      warps.push(
+        mouthFoldWarp(spec.role, mesh, knotXs, b, lips.opening),
+        mouthForm(mesh, b, lips.frame),
+        mouthWiden(mesh, b, lips.frame)
+      );
+      break;
     case "blush_L":
     case "blush_R":
       bindings.push({
-        parameter: import_format8.StandardParameter.Cheek,
+        parameter: import_format10.StandardParameter.Cheek,
         channel: "opacity",
         from: AMPLITUDE.blushRest,
         to: 1
@@ -5632,8 +6059,8 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
       if (byRole.has("hair_front")) {
         const amp = style.sway * AMPLITUDE.sway * hh;
         warps.push(
-          hairSway(import_format8.StandardParameter.HairSwayX, mesh, b, amp),
-          hairSway(import_format8.StandardParameter.HairSwayZ, mesh, b, amp)
+          hairSway(import_format10.StandardParameter.HairSwayX, mesh, b, amp),
+          hairSway(import_format10.StandardParameter.HairSwayZ, mesh, b, amp)
         );
       }
       warps.push(tiltHang(mesh, b, pivot, hairHangWeight(frame.chinY, b.y0)));
@@ -5674,29 +6101,6 @@ function hairFrontGrid(b, frame, boxes) {
   );
   return { xs, ys };
 }
-function columnMesh(b, grid) {
-  const { xs } = grid;
-  const rows = grid.ys.length - 1;
-  const vertices = [];
-  const uvs = [];
-  for (let r = 0; r <= rows; r++) {
-    for (const x of xs) {
-      const u = (x - b.x0) / bw(b);
-      vertices.push(roundTo(u - 0.5, 1e-5), roundTo(0.5 - r / rows, 1e-5));
-      uvs.push(roundTo(u, 1e-5), roundTo(r / rows, 1e-5));
-    }
-  }
-  const n = xs.length;
-  const indices = [];
-  for (let r = 0; r < rows; r++) {
-    for (let c = 0; c + 1 < n; c++) {
-      const tl = r * n + c;
-      const bl = tl + n;
-      indices.push(bl, bl + 1, tl, tl, bl + 1, tl + 1);
-    }
-  }
-  return { vertices, uvs, indices };
-}
 function meshScale(role, frame) {
   switch (role) {
     case "hair_front":
@@ -5706,10 +6110,14 @@ function meshScale(role, frame) {
       return Infinity;
   }
 }
-function deformers(frame, grids, bodyWarp, arms) {
+function deformers(frame, grids, bodyWarp, arms, byRole) {
   const out = [];
   if (bodyWarp !== void 0) out.push(bodyWarp);
   for (const [role, g] of arms) out.push(...armDeformers(role, g));
+  for (const [role, arm] of arms) {
+    const pose = POSE_OF_ARM[role];
+    if (byRole.has(pose)) out.push(forearmPoseDeformer(pose, arm));
+  }
   const hasBody = bodyWarp !== void 0;
   const roll = headOwnRoll(hasBody);
   out.push({
@@ -5718,9 +6126,9 @@ function deformers(frame, grids, bodyWarp, arms) {
     pivot: { x: roundTo(frame.axisX, 0.01), y: roundTo(frame.chinY, 0.01) },
     bindings: [
       // AngleZ is clockwise-positive (Live2D's); a rotation is CCW-positive.
-      { parameter: import_format8.StandardParameter.AngleZ, channel: "rotate", from: roll, to: -roll },
+      { parameter: import_format10.StandardParameter.AngleZ, channel: "rotate", from: roll, to: -roll },
       {
-        parameter: import_format8.StandardParameter.Breath,
+        parameter: import_format10.StandardParameter.Breath,
         channel: "translateY",
         from: 0,
         to: roundTo(headOwnBreath(hasBody) * frame.hh, 0.01)
@@ -5738,8 +6146,8 @@ function deformers(frame, grids, bodyWarp, arms) {
         points: g.lattice.points
       },
       warp2d: {
-        parameter: import_format8.StandardParameter.AngleX,
-        parameterY: import_format8.StandardParameter.AngleY,
+        parameter: import_format10.StandardParameter.AngleX,
+        parameterY: import_format10.StandardParameter.AngleY,
         valuesX: X_STOPS,
         valuesY: Y_STOPS,
         keyforms2d: g.keyforms.map((offsets) => ({ offsets }))
@@ -5752,16 +6160,16 @@ function hairPhysics() {
   return [
     {
       id: "hairSway",
-      input: { parameter: import_format8.StandardParameter.AngleX, weight: 1 },
-      output: { parameter: import_format8.StandardParameter.HairSwayX, scale: 5 },
+      input: { parameter: import_format10.StandardParameter.AngleX, weight: 1 },
+      output: { parameter: import_format10.StandardParameter.HairSwayX, scale: 5 },
       mass: 1,
       stiffness: 30,
       damping: 3
     },
     {
       id: "hairTilt",
-      input: { parameter: import_format8.StandardParameter.AngleZ, weight: 1 },
-      output: { parameter: import_format8.StandardParameter.HairSwayZ, scale: 8 },
+      input: { parameter: import_format10.StandardParameter.AngleZ, weight: 1 },
+      output: { parameter: import_format10.StandardParameter.HairSwayZ, scale: 8 },
       mass: 1,
       stiffness: 25,
       damping: 2.5
@@ -5771,47 +6179,55 @@ function hairPhysics() {
 function declareParameters(roles) {
   const out = [];
   const add = (id, name, min, max, def) => out.push({ id, name, min, max, default: def });
-  add(import_format8.StandardParameter.AngleX, "Head Angle", -30, 30, 0);
-  add(import_format8.StandardParameter.AngleY, "Head Angle Y", -30, 30, 0);
-  add(import_format8.StandardParameter.AngleZ, "Head Angle Z", -30, 30, 0);
+  add(import_format10.StandardParameter.AngleX, "Head Angle", -30, 30, 0);
+  add(import_format10.StandardParameter.AngleY, "Head Angle Y", -30, 30, 0);
+  add(import_format10.StandardParameter.AngleZ, "Head Angle Z", -30, 30, 0);
   if (roles.has("body")) {
-    add(import_format8.StandardParameter.BodyAngleX, "Body Angle X", -10, 10, 0);
-    add(import_format8.StandardParameter.BodyAngleY, "Body Angle Y", -10, 10, 0);
-    add(import_format8.StandardParameter.BodyAngleZ, "Body Angle Z", -10, 10, 0);
+    add(import_format10.StandardParameter.BodyAngleX, "Body Angle X", -10, 10, 0);
+    add(import_format10.StandardParameter.BodyAngleY, "Body Angle Y", -10, 10, 0);
+    add(import_format10.StandardParameter.BodyAngleZ, "Body Angle Z", -10, 10, 0);
   }
+  const addPose = (side, pose, angle) => {
+    add(pose, `Arm Pose ${side}`, 0, 1, 0);
+    add(angle, `Arm Pose Angle ${side}`, ...POSE_ANGLE_RANGE, 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", elbowMin, elbowMax, 0);
+    add(import_format10.StandardParameter.ArmLeft, "Arm L", armMin, armMax, 0);
+    add(import_format10.StandardParameter.ElbowLeft, "Elbow L", elbowMin, elbowMax, 0);
+    if (roles.has("forearm_pose_L"))
+      addPose("L", import_format10.StandardParameter.ArmPoseLeft, import_format10.StandardParameter.ArmPoseAngleLeft);
   }
   if (roles.has("arm_R")) {
-    add(import_format8.StandardParameter.ArmRight, "Arm R", armMin, armMax, 0);
-    add(import_format8.StandardParameter.ElbowRight, "Elbow R", elbowMin, elbowMax, 0);
+    add(import_format10.StandardParameter.ArmRight, "Arm R", armMin, armMax, 0);
+    add(import_format10.StandardParameter.ElbowRight, "Elbow R", elbowMin, elbowMax, 0);
+    if (roles.has("forearm_pose_R"))
+      addPose("R", import_format10.StandardParameter.ArmPoseRight, import_format10.StandardParameter.ArmPoseAngleRight);
   }
-  add(import_format8.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
-  add(import_format8.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
+  add(import_format10.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
+  add(import_format10.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
   if ([...roles].some((r) => /^(iris|pupil|highlight)_/.test(r))) {
-    add(import_format8.StandardParameter.EyeballX, "Gaze X", -1, 1, 0);
-    add(import_format8.StandardParameter.EyeballY, "Gaze Y", -1, 1, 0);
+    add(import_format10.StandardParameter.EyeballX, "Gaze X", -1, 1, 0);
+    add(import_format10.StandardParameter.EyeballY, "Gaze Y", -1, 1, 0);
   }
-  add(import_format8.StandardParameter.MouthOpen, "Mouth Open", 0, 1, 0);
-  add(import_format8.StandardParameter.MouthForm, "Mouth Form", -1, 1, 0);
+  add(import_format10.StandardParameter.MouthOpen, "Mouth Open", 0, 1, 0);
+  add(import_format10.StandardParameter.MouthForm, "Mouth Form", -1, 1, 0);
   if (roles.has("brow_L")) {
-    add(import_format8.StandardParameter.BrowLeftY, "Brow L Y", -1, 1, 0);
-    add(import_format8.StandardParameter.BrowLeftAngle, "Brow L Angle", -1, 1, 0);
+    add(import_format10.StandardParameter.BrowLeftY, "Brow L Y", -1, 1, 0);
+    add(import_format10.StandardParameter.BrowLeftAngle, "Brow L Angle", -1, 1, 0);
   }
   if (roles.has("brow_R")) {
-    add(import_format8.StandardParameter.BrowRightY, "Brow R Y", -1, 1, 0);
-    add(import_format8.StandardParameter.BrowRightAngle, "Brow R Angle", -1, 1, 0);
+    add(import_format10.StandardParameter.BrowRightY, "Brow R Y", -1, 1, 0);
+    add(import_format10.StandardParameter.BrowRightAngle, "Brow R Angle", -1, 1, 0);
   }
   if (roles.has("blush_L") || roles.has("blush_R")) {
-    add(import_format8.StandardParameter.Cheek, "Cheek", 0, 1, 0);
+    add(import_format10.StandardParameter.Cheek, "Cheek", 0, 1, 0);
   }
-  add(import_format8.StandardParameter.Breath, "Breath", 0, 1, 0);
+  add(import_format10.StandardParameter.Breath, "Breath", 0, 1, 0);
   if (roles.has("hair_front")) {
-    add(import_format8.StandardParameter.HairSwayX, "Hair Sway X", -SWAY_RANGE, SWAY_RANGE, 0);
-    add(import_format8.StandardParameter.HairSwayZ, "Hair Sway Z", -SWAY_RANGE, SWAY_RANGE, 0);
+    add(import_format10.StandardParameter.HairSwayX, "Hair Sway X", -SWAY_RANGE, SWAY_RANGE, 0);
+    add(import_format10.StandardParameter.HairSwayZ, "Hair Sway Z", -SWAY_RANGE, SWAY_RANGE, 0);
   }
   return out;
 }
@@ -5859,6 +6275,7 @@ function declareParameters(roles) {
   createLayerSetMeasurer,
   denseCoreOf,
   detectAlphaBbox,
+  forearmPoseGeometry,
   foregroundSpan,
   generateIkiFromLayerSet,
   headHalfOf,