@ikijs/editor 0.14.0 → 0.16.0

package/README.md

@@ -60,7 +60,12 @@ leaves the document untouched.
 `mouth`, plus optional `iris_*`, `brow_*`, `lash_*`, `lash_lower_*`, `hair_front`, `hair_back`,
 …) into a rigged model that blinks, gazes, opens its mouth, turns its head over
 a torso that breathes, and emotes with its brows — including a
-hair-sway physics rig when a `hair_front` layer is present.
+hair-sway physics rig when a `hair_front` layer is present. With a `blush_*`
+layer it declares `ParamCheek`, which fades the blush from faint at rest to
+as drawn. Every rigged model also declares the head motions Nod, Shake and
+Tilt and up to six default expressions (smile, laugh, angry, sad, surprised,
+shy; shy needs a blush, angry and sad need brows), each with a description a
+host picks by (`AUTO-RIG.md`).
 
 The rig turns the head by parallax, not a reshaped face, with values of our
 own picked by eye (`auto-rig/profile.ts`, `AUTO-RIG.md`). The face plate

package/dist/index.d.mts

@@ -185,7 +185,8 @@ declare class SetDeformerBindings implements EditCommand {
 /**
  * Reparent a deformer (matrix or warp) under a new parent, or promote it to
  * root (`newParentId === undefined`). Calls {@link validateDeformerReparent}
- * FIRST so invalid reparents (cycles, warp parent, unknown id) throw before any
+ * FIRST so invalid reparents (cycles, warp-under-warp, a pivot outside the new
+ * warp parent's grid, unknown id) throw before any
  * capture or mutation — a throwing apply leaves the model and undo stack
  * untouched.
  *
@@ -861,7 +862,9 @@ declare function parseLayerRoles(fileNames: string[]): {
  * plate, the hair and the blush moved by per-vertex keyforms of their own —
  * the plate as up to four islands of one drawing: a head that slides, a neck
  * that stays and two ears that lag. Blink, gaze, brows, mouth, breath and
- * hair sway are part warps and bindings under those.
+ * hair sway are part warps and bindings under those. The model also declares
+ * the default expressions and the Nod, Shake and Tilt motions
+ * (`animations.ts`).
  */
 
 declare function generateIkiFromLayerSet(layers: LayerInput[], canvas: {
@@ -1179,8 +1182,10 @@ declare function uvRectFor(placement: AtlasPlacement, page: {
 /**
  * Validate that reparenting `deformerId` under `newParentId` keeps the deformer
  * hierarchy valid. Pass `newParentId === undefined` to move to root (always legal).
- * Checks: existence, self-reference, undeclared parent, kind constraint (warp
- * deformers cannot be parents), and cycle detection via the proposed edge.
+ * Checks: existence, self-reference, undeclared parent, kind constraint (a warp
+ * deformer cannot be the parent of another warp deformer), a matrix deformer's
+ * pivot inside its new warp parent's rest grid, and cycle detection via the
+ * proposed edge.
  */
 declare function validateDeformerReparent(deformers: IkiDeformer[], deformerId: string, newParentId: string | undefined): void;
 /**

package/dist/index.d.ts

@@ -185,7 +185,8 @@ declare class SetDeformerBindings implements EditCommand {
 /**
  * Reparent a deformer (matrix or warp) under a new parent, or promote it to
  * root (`newParentId === undefined`). Calls {@link validateDeformerReparent}
- * FIRST so invalid reparents (cycles, warp parent, unknown id) throw before any
+ * FIRST so invalid reparents (cycles, warp-under-warp, a pivot outside the new
+ * warp parent's grid, unknown id) throw before any
  * capture or mutation — a throwing apply leaves the model and undo stack
  * untouched.
  *
@@ -861,7 +862,9 @@ declare function parseLayerRoles(fileNames: string[]): {
  * plate, the hair and the blush moved by per-vertex keyforms of their own —
  * the plate as up to four islands of one drawing: a head that slides, a neck
  * that stays and two ears that lag. Blink, gaze, brows, mouth, breath and
- * hair sway are part warps and bindings under those.
+ * hair sway are part warps and bindings under those. The model also declares
+ * the default expressions and the Nod, Shake and Tilt motions
+ * (`animations.ts`).
  */
 
 declare function generateIkiFromLayerSet(layers: LayerInput[], canvas: {
@@ -1179,8 +1182,10 @@ declare function uvRectFor(placement: AtlasPlacement, page: {
 /**
  * Validate that reparenting `deformerId` under `newParentId` keeps the deformer
  * hierarchy valid. Pass `newParentId === undefined` to move to root (always legal).
- * Checks: existence, self-reference, undeclared parent, kind constraint (warp
- * deformers cannot be parents), and cycle detection via the proposed edge.
+ * Checks: existence, self-reference, undeclared parent, kind constraint (a warp
+ * deformer cannot be the parent of another warp deformer), a matrix deformer's
+ * pivot inside its new warp parent's rest grid, and cycle detection via the
+ * proposed edge.
  */
 declare function validateDeformerReparent(deformers: IkiDeformer[], deformerId: string, newParentId: string | undefined): void;
 /**

package/dist/index.js

@@ -520,11 +520,24 @@ function validateDeformerReparent(deformers2, deformerId, newParentId) {
       `deformers."${deformerId}".parent "${newParentId}" is not a declared deformer`
     );
   }
-  if (kindOf(parent) === "warp") {
+  if (kindOf(parent) === "warp" && kindOf(target) === "warp") {
     throw new Error(
-      `deformers."${deformerId}".parent "${newParentId}" must be a matrix deformer (warp deformers cannot be parents)`
+      `deformers."${deformerId}".parent "${newParentId}" must be a matrix deformer (warp deformers cannot be nested under a warp deformer)`
     );
   }
+  if (parent.kind === "warp" && target.kind !== "warp") {
+    const { pivot } = target;
+    const { cols, rows, points } = parent.grid;
+    const xMin = points[0];
+    const xMax = points[2 * cols];
+    const yMax = points[1];
+    const yMin = points[rows * (cols + 1) * 2 + 1];
+    if (pivot.x < xMin || pivot.x > xMax || pivot.y < yMin || pivot.y > yMax) {
+      throw new Error(
+        `deformers."${deformerId}".pivot (${pivot.x}, ${pivot.y}) lies outside its warp parent "${newParentId}" rest grid x ${xMin}..${xMax}, y ${yMin}..${yMax}`
+      );
+    }
+  }
   const parentOf = /* @__PURE__ */ new Map();
   for (const d of deformers2) {
     if (d.parent !== void 0) parentOf.set(d.id, d.parent);
@@ -1983,7 +1996,8 @@ var PROFILE_VALUES = {
   mouthWiden: 1.2,
   brow: 0.15,
   breath: 0.03,
-  sway: 0.08
+  sway: 0.08,
+  blushRest: 0.4
 };
 function deriveProfile(v) {
   const farLead = v.lead * (1 - v.fore / 2);
@@ -2070,6 +2084,8 @@ function deriveProfile(v) {
     breathHead: v.breath * 2 / 3,
     /** Hair tip travel at full sway (±20), hh. */
     sway: v.sway,
+    /** The blush's opacity at Cheek 0; at Cheek 1 it is as drawn. */
+    blushRest: v.blushRest,
     /** The neck under the face reaches this far above the jaw, hh — what the
      *  chin uncovers as it slides off it: half again the chin's full-turn
      *  slide, to the next 0.05. */
@@ -2187,7 +2203,156 @@ function parseLayerRoles(fileNames) {
 }
 
 // src/auto-rig/generate.ts
-var import_format5 = require("@ikijs/format");
+var import_format6 = 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/layout.ts
 function boxOfLayer(layer) {
@@ -2482,7 +2647,7 @@ function checkStrandEdges(strand, irises, hair) {
 }
 
 // src/auto-rig/context.ts
-var import_format3 = require("@ikijs/format");
+var import_format4 = require("@ikijs/format");
 
 // src/auto-rig/grid.ts
 var X_STOPS = [-30, 0, 30];
@@ -3698,7 +3863,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_format3.StandardParameter.AngleX);
+    const warp = part?.warps?.find((w) => w.parameter === import_format4.StandardParameter.AngleX);
     if (part === void 0 || part.mesh === void 0 || !g && !warp) {
       return x + field(role)(x, y, ax, 0)[0];
     }
@@ -4408,7 +4573,7 @@ function buildTurn(frame, landmarks, q) {
 }
 
 // src/auto-rig/drivers.ts
-var import_format4 = require("@ikijs/format");
+var import_format5 = require("@ikijs/format");
 var SWAY_RANGE = 20;
 var SWAY_CURVE = 1.4;
 var HAIR_HANG = 0.35;
@@ -4486,13 +4651,13 @@ function gazeBindings(irisW, share = 1) {
   const gy = AMPLITUDE.gazeY * irisW * share;
   return [
     {
-      parameter: import_format4.StandardParameter.EyeballX,
+      parameter: import_format5.StandardParameter.EyeballX,
       channel: "translateX",
       from: -round1(gx),
       to: round1(gx)
     },
     {
-      parameter: import_format4.StandardParameter.EyeballY,
+      parameter: import_format5.StandardParameter.EyeballY,
       channel: "translateY",
       from: -round1(gy),
       to: round1(gy)
@@ -4506,8 +4671,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_format5.StandardParameter.BrowLeftY : import_format5.StandardParameter.BrowRightY;
+  const a = side === "L" ? import_format5.StandardParameter.BrowLeftAngle : import_format5.StandardParameter.BrowRightAngle;
   return [
     {
       parameter: y,
@@ -4523,7 +4688,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_format5.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;
@@ -4533,7 +4698,7 @@ function mouthForm(mesh, box) {
 function mouthOpenGrow(mesh, box) {
   const c = cx(box);
   return localWarp(
-    import_format4.StandardParameter.MouthOpen,
+    import_format5.StandardParameter.MouthOpen,
     mesh,
     box,
     [0, 1],
@@ -4542,7 +4707,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_format5.StandardParameter.MouthOpen, mesh, box, [0, 1], ([x], v) => [
     v * (AMPLITUDE.mouthOpenWidth - 1) * (x - c),
     0
   ]);
@@ -4560,7 +4725,7 @@ function hairSway(param, mesh, box, amp) {
   );
 }
 function tiltHang(mesh, box, pivot, weight) {
-  return localWarp(import_format4.StandardParameter.AngleZ, mesh, box, Z_STOPS, ([x, y], v, i) => {
+  return localWarp(import_format5.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);
@@ -4713,16 +4878,19 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
       ...part.warps ?? []
     ];
   }
+  const parameters = declareParameters(new Set(byRole.keys()));
   const model = {
-    version: import_format5.IKI_FORMAT_VERSION,
+    version: import_format6.IKI_FORMAT_VERSION,
     name: "auto-rigged",
     canvas: { width: canvas.width, height: canvas.height },
-    parameters: declareParameters(new Set(byRole.keys())),
+    parameters,
     parts,
     deformers: deformers(frame, grids, has("body") ? box("body") : void 0),
-    ...has("hair_front") ? { physics: hairPhysics() } : {}
+    ...has("hair_front") ? { physics: hairPhysics() } : {},
+    expressions: defaultExpressions(new Set(parameters.map((p) => p.id))),
+    motions: DEFAULT_MOTIONS
   };
-  const valid = (0, import_format5.parseIkiModel)(model);
+  const valid = (0, import_format6.parseIkiModel)(model);
   if (hasNose && options.onTurnSolved) {
     options.onTurnSolved(
       turnReport(
@@ -4737,14 +4905,14 @@ function generateIkiFromLayerSet(layers, canvas, options = {}) {
 function turnWarps(mesh, b, fieldOf) {
   return [
     localWarp(
-      import_format5.StandardParameter.AngleX,
+      import_format6.StandardParameter.AngleX,
       mesh,
       b,
       X_STOPS,
       ([x, y], v, i) => v === 0 ? [0, 0] : [fieldOf(i)(x, y, v, 0)[0], 0]
     ),
     localWarp(
-      import_format5.StandardParameter.AngleY,
+      import_format6.StandardParameter.AngleY,
       mesh,
       b,
       Y_STOPS,
@@ -4792,7 +4960,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_format5.StandardParameter.EyeOpenLeft : import_format5.StandardParameter.EyeOpenRight;
+  const eyeOpen = side === "L" ? import_format6.StandardParameter.EyeOpenLeft : import_format6.StandardParameter.EyeOpenRight;
   const hh = frame.hh;
   switch (spec.role) {
     case "face":
@@ -4801,7 +4969,7 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
         warps.push(
           tiltHang(mesh, b, pivot, (_y, i) => isNeck[i] ? 1 : 0),
           localWarp(
-            import_format5.StandardParameter.Breath,
+            import_format6.StandardParameter.Breath,
             mesh,
             b,
             [0, 1],
@@ -4848,8 +5016,8 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
       if (byRole.has("mouth_open")) {
         warps.push(mouthWiden(mesh, b));
         bindings.push(
-          { parameter: import_format5.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 },
-          { parameter: import_format5.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 }
+          { parameter: import_format6.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 },
+          { parameter: import_format6.StandardParameter.MouthOpen, channel: "opacity", from: 1, to: 0 }
         );
         extra = [(AMPLITUDE.mouthOpenWidth - 1) * (bw(b) / 2), 0];
       } else {
@@ -4859,19 +5027,19 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
         );
         bindings.push(
           {
-            parameter: import_format5.StandardParameter.MouthOpen,
+            parameter: import_format6.StandardParameter.MouthOpen,
             channel: "scaleY",
             from: 0,
             to: roundTo(grow, 0.01)
           },
           {
-            parameter: import_format5.StandardParameter.MouthOpen,
+            parameter: import_format6.StandardParameter.MouthOpen,
             channel: "scaleX",
             from: 0,
             to: roundTo(AMPLITUDE.mouthOpenWidth - 1, 0.01)
           },
           {
-            parameter: import_format5.StandardParameter.MouthOpen,
+            parameter: import_format6.StandardParameter.MouthOpen,
             channel: "translateY",
             from: 0,
             to: -roundTo(grow * bh(b) / 2, 0.01)
@@ -4883,20 +5051,29 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
     case "mouth_open":
       warps.push(mouthForm(mesh, b), mouthOpenGrow(mesh, b));
       bindings.push({
-        parameter: import_format5.StandardParameter.MouthOpen,
+        parameter: import_format6.StandardParameter.MouthOpen,
         channel: "opacity",
         from: 0,
         to: 1
       });
       extra = [(AMPLITUDE.mouthOpenWidth - 1) * (bw(b) / 2), 0];
       break;
+    case "blush_L":
+    case "blush_R":
+      bindings.push({
+        parameter: import_format6.StandardParameter.Cheek,
+        channel: "opacity",
+        from: AMPLITUDE.blushRest,
+        to: 1
+      });
+      break;
     case "hair_front":
     case "hair_back":
       if (byRole.has("hair_front")) {
         const amp = style.sway * AMPLITUDE.sway * hh;
         warps.push(
-          hairSway(import_format5.StandardParameter.HairSwayX, mesh, b, amp),
-          hairSway(import_format5.StandardParameter.HairSwayZ, mesh, b, amp)
+          hairSway(import_format6.StandardParameter.HairSwayX, mesh, b, amp),
+          hairSway(import_format6.StandardParameter.HairSwayZ, mesh, b, amp)
         );
       }
       warps.push(tiltHang(mesh, b, pivot, hairHangWeight(frame.chinY, b.y0)));
@@ -4977,7 +5154,7 @@ function deformers(frame, grids, body) {
       pivot: { x: roundTo(cx(body), 0.01), y: roundTo(body.y1, 0.01) },
       bindings: [
         {
-          parameter: import_format5.StandardParameter.Breath,
+          parameter: import_format6.StandardParameter.Breath,
           channel: "translateY",
           from: 0,
           to: roundTo(AMPLITUDE.breathBody * frame.hh, 0.01)
@@ -4990,9 +5167,9 @@ function deformers(frame, grids, body) {
     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_format5.StandardParameter.AngleZ, channel: "rotate", from: ROLL_DEG, to: -ROLL_DEG },
+      { parameter: import_format6.StandardParameter.AngleZ, channel: "rotate", from: ROLL_DEG, to: -ROLL_DEG },
       {
-        parameter: import_format5.StandardParameter.Breath,
+        parameter: import_format6.StandardParameter.Breath,
         channel: "translateY",
         from: 0,
         to: roundTo(AMPLITUDE.breathHead * frame.hh, 0.01)
@@ -5010,8 +5187,8 @@ function deformers(frame, grids, body) {
         points: g.lattice.points
       },
       warp2d: {
-        parameter: import_format5.StandardParameter.AngleX,
-        parameterY: import_format5.StandardParameter.AngleY,
+        parameter: import_format6.StandardParameter.AngleX,
+        parameterY: import_format6.StandardParameter.AngleY,
         valuesX: X_STOPS,
         valuesY: Y_STOPS,
         keyforms2d: g.keyforms.map((offsets) => ({ offsets }))
@@ -5024,16 +5201,16 @@ function hairPhysics() {
   return [
     {
       id: "hairSway",
-      input: { parameter: import_format5.StandardParameter.AngleX, weight: 1 },
-      output: { parameter: import_format5.StandardParameter.HairSwayX, scale: 5 },
+      input: { parameter: import_format6.StandardParameter.AngleX, weight: 1 },
+      output: { parameter: import_format6.StandardParameter.HairSwayX, scale: 5 },
       mass: 1,
       stiffness: 30,
       damping: 3
     },
     {
       id: "hairTilt",
-      input: { parameter: import_format5.StandardParameter.AngleZ, weight: 1 },
-      output: { parameter: import_format5.StandardParameter.HairSwayZ, scale: 8 },
+      input: { parameter: import_format6.StandardParameter.AngleZ, weight: 1 },
+      output: { parameter: import_format6.StandardParameter.HairSwayZ, scale: 8 },
       mass: 1,
       stiffness: 25,
       damping: 2.5
@@ -5043,29 +5220,32 @@ function hairPhysics() {
 function declareParameters(roles) {
   const out = [];
   const add = (id, name, min, max, def) => out.push({ id, name, min, max, default: def });
-  add(import_format5.StandardParameter.AngleX, "Head Angle", -30, 30, 0);
-  add(import_format5.StandardParameter.AngleY, "Head Angle Y", -30, 30, 0);
-  add(import_format5.StandardParameter.AngleZ, "Head Angle Z", -30, 30, 0);
-  add(import_format5.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
-  add(import_format5.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
+  add(import_format6.StandardParameter.AngleX, "Head Angle", -30, 30, 0);
+  add(import_format6.StandardParameter.AngleY, "Head Angle Y", -30, 30, 0);
+  add(import_format6.StandardParameter.AngleZ, "Head Angle Z", -30, 30, 0);
+  add(import_format6.StandardParameter.EyeOpenLeft, "Eye L", 0, 1, 1);
+  add(import_format6.StandardParameter.EyeOpenRight, "Eye R", 0, 1, 1);
   if ([...roles].some((r) => /^(iris|pupil|highlight)_/.test(r))) {
-    add(import_format5.StandardParameter.EyeballX, "Gaze X", -1, 1, 0);
-    add(import_format5.StandardParameter.EyeballY, "Gaze Y", -1, 1, 0);
+    add(import_format6.StandardParameter.EyeballX, "Gaze X", -1, 1, 0);
+    add(import_format6.StandardParameter.EyeballY, "Gaze Y", -1, 1, 0);
   }
-  add(import_format5.StandardParameter.MouthOpen, "Mouth Open", 0, 1, 0);
-  add(import_format5.StandardParameter.MouthForm, "Mouth Form", -1, 1, 0);
+  add(import_format6.StandardParameter.MouthOpen, "Mouth Open", 0, 1, 0);
+  add(import_format6.StandardParameter.MouthForm, "Mouth Form", -1, 1, 0);
   if (roles.has("brow_L")) {
-    add(import_format5.StandardParameter.BrowLeftY, "Brow L Y", -1, 1, 0);
-    add(import_format5.StandardParameter.BrowLeftAngle, "Brow L Angle", -1, 1, 0);
+    add(import_format6.StandardParameter.BrowLeftY, "Brow L Y", -1, 1, 0);
+    add(import_format6.StandardParameter.BrowLeftAngle, "Brow L Angle", -1, 1, 0);
   }
   if (roles.has("brow_R")) {
-    add(import_format5.StandardParameter.BrowRightY, "Brow R Y", -1, 1, 0);
-    add(import_format5.StandardParameter.BrowRightAngle, "Brow R Angle", -1, 1, 0);
+    add(import_format6.StandardParameter.BrowRightY, "Brow R Y", -1, 1, 0);
+    add(import_format6.StandardParameter.BrowRightAngle, "Brow R Angle", -1, 1, 0);
+  }
+  if (roles.has("blush_L") || roles.has("blush_R")) {
+    add(import_format6.StandardParameter.Cheek, "Cheek", 0, 1, 0);
   }
-  add(import_format5.StandardParameter.Breath, "Breath", 0, 1, 0);
+  add(import_format6.StandardParameter.Breath, "Breath", 0, 1, 0);
   if (roles.has("hair_front")) {
-    add(import_format5.StandardParameter.HairSwayX, "Hair Sway X", -SWAY_RANGE, SWAY_RANGE, 0);
-    add(import_format5.StandardParameter.HairSwayZ, "Hair Sway Z", -SWAY_RANGE, SWAY_RANGE, 0);
+    add(import_format6.StandardParameter.HairSwayX, "Hair Sway X", -SWAY_RANGE, SWAY_RANGE, 0);
+    add(import_format6.StandardParameter.HairSwayZ, "Hair Sway Z", -SWAY_RANGE, SWAY_RANGE, 0);
   }
   return out;
 }