@ikijs/editor 0.18.0 → 0.20.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,13 @@ var ROW_RUN_ROLES = /* @__PURE__ */ new Set([
   "hair_back",
   "body",
   "arm_L",
-  "arm_R"
+  "arm_R",
+  "forearm_pose_L",
+  "forearm_pose_R"
+]);
+var REST_HIDDEN_ROLES = /* @__PURE__ */ new Set([
+  "forearm_pose_L",
+  "forearm_pose_R"
 ]);
 function createLayerSetMeasurer(canvas) {
   for (const field of ["width", "height"]) {
@@ -1672,6 +1679,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 +1695,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,
@@ -2754,7 +2762,11 @@ 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_format5.StandardParameter.ArmLeft, elbow: import_format5.StandardParameter.ElbowLeft },
   arm_R: { arm: import_format5.StandardParameter.ArmRight, elbow: import_format5.StandardParameter.ElbowRight }
@@ -2762,49 +2774,67 @@ var ARM_PARAMS = {
 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"
   }
 };
-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(
@@ -2819,11 +2849,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
   };
 }
@@ -2833,84 +2882,188 @@ 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);
   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, swaps = false) => ({
     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
+    mesh,
+    ...swaps && poseSwitch !== void 0 ? {
+      bindings: [
+        {
+          parameter: poseSwitch,
+          channel: "opacity",
+          from: 1,
+          to: 0
+        }
+      ]
+    } : {}
   });
   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]
+      },
+      true
+    ),
+    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),
+      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) => ({
-    parameter,
-    channel: "rotate",
-    from: g.side * ARM_RANGE[0],
-    to: g.side * ARM_RANGE[1]
-  });
   return [
     {
       id: ids.armDeformer,
       parent: BODY_WARP_ID,
       pivot: { ...g.shoulder },
-      bindings: [rotate(params.arm)]
+      bindings: [rotateBinding(params.arm, ARM_RANGE, g.side)]
     },
     {
       id: ids.forearmDeformer,
       parent: ids.armDeformer,
       pivot: { ...g.elbow },
-      bindings: [rotate(params.elbow)]
+      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 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: "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" },
@@ -2931,7 +3084,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
@@ -2971,6 +3127,16 @@ function checkArmsHaveBody(roles) {
     );
   }
 }
+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 = [];
@@ -2997,36 +3163,37 @@ function parseLayerRoles(fileNames) {
     );
   }
   checkArmsHaveBody(seen.keys());
+  checkPosesHaveArms(seen.keys());
   return out;
 }
 
 // src/auto-rig/generate.ts
-var import_format8 = require("@ikijs/format");
+var import_format9 = 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)
     ]
@@ -3035,10 +3202,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)
     ]
@@ -3050,7 +3217,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" }
     ]
   },
   {
@@ -3060,7 +3227,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" }
     ]
   },
   {
@@ -3068,18 +3235,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)
     ]
   }
@@ -3092,14 +3259,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],
@@ -3120,7 +3287,7 @@ var DEFAULT_MOTIONS = {
       fadeIn: 0.15,
       curves: [
         {
-          parameter: import_format6.StandardParameter.AngleX,
+          parameter: import_format7.StandardParameter.AngleX,
           keys: [
             [0, 0],
             [0.2, -18],
@@ -3139,7 +3306,7 @@ var DEFAULT_MOTIONS = {
       duration: 1.4,
       curves: [
         {
-          parameter: import_format6.StandardParameter.AngleZ,
+          parameter: import_format7.StandardParameter.AngleZ,
           keys: [
             [0, 0],
             [0.35, 20],
@@ -3151,6 +3318,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);
@@ -3256,6 +3472,7 @@ function checkLayers(layers, canvas) {
     throw new Error(`auto-rig: missing required role(s) ${missing.join(", ")}`);
   }
   checkArmsHaveBody(seen);
+  checkPosesHaveArms(seen);
 }
 function checkHeadEdges(edges, byRole) {
   if (edges === void 0) return;
@@ -3373,7 +3590,7 @@ function checkStrandEdges(strand, irises, hair) {
 }
 
 // src/auto-rig/context.ts
-var import_format7 = require("@ikijs/format");
+var import_format8 = require("@ikijs/format");
 
 // src/auto-rig/head.ts
 function outerEdge(runs, axisX, side) {
@@ -4405,6 +4622,7 @@ function familyField(m, family) {
       return hairField(m, m.hairBack, NOD.hairBack);
     case "body":
     case "arm":
+    case "forearm_pose":
       return () => [0, 0];
   }
 }
@@ -4504,7 +4722,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_format8.StandardParameter.AngleX);
     if (part === void 0 || part.mesh === void 0 || !g && !warp) {
       return x + field(role)(x, y, ax, 0)[0];
     }
@@ -5240,6 +5458,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);
@@ -5308,11 +5527,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),
@@ -5365,7 +5595,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);
@@ -5377,17 +5607,17 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
   }
   const parameters = declareParameters(new Set(byRole.keys()));
   const model = {
-    version: import_format8.IKI_FORMAT_VERSION,
+    version: import_format9.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_format9.parseIkiModel)(model);
   if (hasNose && options.onTurnSolved) {
     options.onTurnSolved(
       turnReport(
@@ -5402,14 +5632,14 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
 function turnWarps(mesh, b, fieldOf) {
   return [
     localWarp(
-      import_format8.StandardParameter.AngleX,
+      import_format9.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_format9.StandardParameter.AngleY,
       mesh,
       b,
       Y_STOPS,
@@ -5457,7 +5687,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_format9.StandardParameter.EyeOpenLeft : import_format9.StandardParameter.EyeOpenRight;
   const hh = frame.hh;
   switch (spec.role) {
     case "face":
@@ -5472,7 +5702,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
             headOwnRoll(byRole.has("body"))
           ),
           localWarp(
-            import_format8.StandardParameter.Breath,
+            import_format9.StandardParameter.Breath,
             mesh,
             b,
             [0, 1],
@@ -5519,8 +5749,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_format9.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 },
+          { parameter: import_format9.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 }
         );
         extra = [(AMPLITUDE.mouthOpenWidth - 1) * (bw(b) / 2), 0];
       } else {
@@ -5530,19 +5760,19 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
         );
         bindings.push(
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format9.StandardParameter.MouthOpen,
             channel: "scaleY",
             from: 0,
             to: roundTo(grow, 0.01)
           },
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format9.StandardParameter.MouthOpen,
             channel: "scaleX",
             from: 0,
             to: roundTo(AMPLITUDE.mouthOpenWidth - 1, 0.01)
           },
           {
-            parameter: import_format8.StandardParameter.MouthOpen,
+            parameter: import_format9.StandardParameter.MouthOpen,
             channel: "translateY",
             from: 0,
             to: -roundTo(grow * bh(b) / 2, 0.01)
@@ -5554,7 +5784,7 @@ 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_format9.StandardParameter.MouthOpen,
         channel: "opacity",
         from: 0,
         to: 1
@@ -5564,7 +5794,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
     case "blush_L":
     case "blush_R":
       bindings.push({
-        parameter: import_format8.StandardParameter.Cheek,
+        parameter: import_format9.StandardParameter.Cheek,
         channel: "opacity",
         from: AMPLITUDE.blushRest,
         to: 1
@@ -5575,8 +5805,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_format9.StandardParameter.HairSwayX, mesh, b, amp),
+          hairSway(import_format9.StandardParameter.HairSwayZ, mesh, b, amp)
         );
       }
       warps.push(tiltHang(mesh, b, pivot, hairHangWeight(frame.chinY, b.y0)));
@@ -5649,10 +5879,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({
@@ -5661,9 +5895,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_format9.StandardParameter.AngleZ, channel: "rotate", from: roll, to: -roll },
       {
-        parameter: import_format8.StandardParameter.Breath,
+        parameter: import_format9.StandardParameter.Breath,
         channel: "translateY",
         from: 0,
         to: roundTo(headOwnBreath(hasBody) * frame.hh, 0.01)
@@ -5681,8 +5915,8 @@ function deformers(frame, grids, bodyWarp, arms) {
         points: g.lattice.points
       },
       warp2d: {
-        parameter: import_format8.StandardParameter.AngleX,
-        parameterY: import_format8.StandardParameter.AngleY,
+        parameter: import_format9.StandardParameter.AngleX,
+        parameterY: import_format9.StandardParameter.AngleY,
         valuesX: X_STOPS,
         valuesY: Y_STOPS,
         keyforms2d: g.keyforms.map((offsets) => ({ offsets }))
@@ -5695,16 +5929,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_format9.StandardParameter.AngleX, weight: 1 },
+      output: { parameter: import_format9.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_format9.StandardParameter.AngleZ, weight: 1 },
+      output: { parameter: import_format9.StandardParameter.HairSwayZ, scale: 8 },
       mass: 1,
       stiffness: 25,
       damping: 2.5
@@ -5714,46 +5948,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_format9.StandardParameter.AngleX, "Head Angle", -30, 30, 0);
+  add(import_format9.StandardParameter.AngleY, "Head Angle Y", -30, 30, 0);
+  add(import_format9.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_format9.StandardParameter.BodyAngleX, "Body Angle X", -10, 10, 0);
+    add(import_format9.StandardParameter.BodyAngleY, "Body Angle Y", -10, 10, 0);
+    add(import_format9.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", armMin, armMax, 0);
+    add(import_format9.StandardParameter.ArmLeft, "Arm L", armMin, armMax, 0);
+    add(import_format9.StandardParameter.ElbowLeft, "Elbow L", elbowMin, elbowMax, 0);
+    if (roles.has("forearm_pose_L"))
+      addPose("L", import_format9.StandardParameter.ArmPoseLeft, import_format9.StandardParameter.ArmPoseAngleLeft);
   }
   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_format9.StandardParameter.ArmRight, "Arm R", armMin, armMax, 0);
+    add(import_format9.StandardParameter.ElbowRight, "Elbow R", elbowMin, elbowMax, 0);
+    if (roles.has("forearm_pose_R"))
+      addPose("R", import_format9.StandardParameter.ArmPoseRight, import_format9.StandardParameter.ArmPoseAngleRight);
   }
-  add(import_format8.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
-  add(import_format8.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
+  add(import_format9.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
+  add(import_format9.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_format9.StandardParameter.EyeballX, "Gaze X", -1, 1, 0);
+    add(import_format9.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_format9.StandardParameter.MouthOpen, "Mouth Open", 0, 1, 0);
+  add(import_format9.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_format9.StandardParameter.BrowLeftY, "Brow L Y", -1, 1, 0);
+    add(import_format9.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_format9.StandardParameter.BrowRightY, "Brow R Y", -1, 1, 0);
+    add(import_format9.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_format9.StandardParameter.Cheek, "Cheek", 0, 1, 0);
   }
-  add(import_format8.StandardParameter.Breath, "Breath", 0, 1, 0);
+  add(import_format9.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_format9.StandardParameter.HairSwayX, "Hair Sway X", -SWAY_RANGE, SWAY_RANGE, 0);
+    add(import_format9.StandardParameter.HairSwayZ, "Hair Sway Z", -SWAY_RANGE, SWAY_RANGE, 0);
   }
   return out;
 }
@@ -5801,6 +6044,7 @@ function declareParameters(roles) {
   createLayerSetMeasurer,
   denseCoreOf,
   detectAlphaBbox,
+  forearmPoseGeometry,
   foregroundSpan,
   generateIkiFromLayerSet,
   headHalfOf,