@ikijs/editor 0.13.0 → 0.15.0

package/README.md

@@ -57,10 +57,15 @@ leaves the document untouched.
 ## Auto-rig
 
 `generateIkiFromLayerSet` turns role-named layers (`face`, `eye_L`, `eye_R`,
-`mouth`, plus optional `iris_*`, `brow_*`, `lash_*`, `hair_front`, `hair_back`,
+`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

@@ -861,7 +861,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: {

package/dist/index.d.ts

@@ -861,7 +861,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: {

package/dist/index.js

@@ -1983,7 +1983,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 +2071,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. */
@@ -2131,6 +2134,8 @@ var ROLE_TABLE = [
   { role: "pupil_R", family: "eye_R" },
   { role: "highlight_L", family: "eye_L" },
   { role: "highlight_R", family: "eye_R" },
+  { role: "lash_lower_L", family: "eye_L" },
+  { role: "lash_lower_R", family: "eye_R" },
   { role: "lash_L", family: "eye_L" },
   { role: "lash_R", family: "eye_R" },
   { role: "brow_L", family: "brow_L" },
@@ -2185,7 +2190,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) {
@@ -2480,7 +2634,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];
@@ -3696,7 +3850,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];
     }
@@ -4406,7 +4560,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;
@@ -4458,12 +4612,12 @@ function motionReach(warps, mesh, box, extra = [0, 0]) {
   }
   return out;
 }
-function blinkFold(param, mesh, eye, travel) {
+function blinkFold(param, mesh, box, travel, eye = box) {
   const yc = eye.y1 - travel * bh(eye);
   return localWarp(
     param,
     mesh,
-    eye,
+    box,
     [0, 1],
     ([, y], v) => v === 1 ? [0, 0] : [0, yc - y]
   );
@@ -4484,13 +4638,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)
@@ -4504,8 +4658,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,
@@ -4521,7 +4675,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;
@@ -4531,7 +4685,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],
@@ -4540,7 +4694,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
   ]);
@@ -4558,7 +4712,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);
@@ -4711,16 +4865,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(
@@ -4735,14 +4892,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,
@@ -4790,7 +4947,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":
@@ -4799,7 +4956,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],
@@ -4812,6 +4969,10 @@ function buildPart(spec, b, order, frame, byRole, style, frontGrid) {
     case "eye_R":
       warps.push(blinkFold(eyeOpen, mesh, b, style.blink));
       break;
+    case "lash_lower_L":
+    case "lash_lower_R":
+      warps.push(blinkFold(eyeOpen, mesh, b, style.blink, box(`eye_${side}`)));
+      break;
     case "lash_L":
     case "lash_R":
       warps.push(lashFold(eyeOpen, mesh, b, box(`eye_${side}`), style.blink));
@@ -4842,8 +5003,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 {
@@ -4853,19 +5014,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)
@@ -4877,20 +5038,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)));
@@ -4971,7 +5141,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)
@@ -4984,9 +5154,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)
@@ -5004,8 +5174,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 }))
@@ -5018,16 +5188,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
@@ -5037,29 +5207,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;
 }