@ikijs/editor 0.7.0 → 0.8.0

package/README.md

@@ -123,7 +123,12 @@ decodes with canvas, `@ikijs/mcp` decodes with `sharp`, and both feed the same
 pure function — including the optional `rowHalfWidths` (one entry per crop row,
 half that row's opaque span in canvas px), which `@ikijs/mcp` measures for the
 face so the plate turns on a radius that varies by row; absent, it turns on one
-constant radius.
+constant radius. It also takes the optional `denseCore`, the tight box of a
+layer's alpha ≥ 128 pixels in image coords, not grown, which `@ikijs/mcp`
+measures for the nose: its centre and width are the nose's turn landmark, so a
+shaded nose is fitted by its drawing rather than its soft feather, and its top
+edge at its centre x is the bridge top the nose tilts 6° about on the turn, its
+tip toward the far side; absent, the crop stands in for both.
 
 `*_L` / `*_R` are the **character's** sides — `eye_L` is the character's left
 eye, which appears on the viewer's right.

package/dist/index.d.mts

@@ -888,6 +888,24 @@ interface LayerInput {
      * [0, cropW / 2], the most an inclusive span inside the crop can be.
      */
     rowHalfWidths?: number[];
+    /**
+     * The tight box of the layer's alpha ≥ 128 pixels, in image coords like
+     * `bbox` and NOT grown: the drawing a viewer reads inside a soft feather,
+     * which the crop's alpha ≥ 8 rule takes in whole. Optional, and only the
+     * NOSE's is read: its centre and width are the nose's turn landmark
+     * (`turnLandmarks`), so a shaded nose is fitted by the drawing rather than
+     * by its feather, and its top edge at its centre x is the bridge top the
+     * nose tilts about on the turn (`NOSE_TURN_TILT_DEG`). Absent — as the
+     * editor's own import leaves it — the crop stands in for both. Validated
+     * before anything reads it: a plain object whose x, y, w and h are finite,
+     * w and h positive, and the box inside `bbox`.
+     */
+    denseCore?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
 }
 /**
  * Map an array of raw filenames to canonical `{ role, fileName }` pairs.

package/dist/index.d.ts

@@ -888,6 +888,24 @@ interface LayerInput {
      * [0, cropW / 2], the most an inclusive span inside the crop can be.
      */
     rowHalfWidths?: number[];
+    /**
+     * The tight box of the layer's alpha ≥ 128 pixels, in image coords like
+     * `bbox` and NOT grown: the drawing a viewer reads inside a soft feather,
+     * which the crop's alpha ≥ 8 rule takes in whole. Optional, and only the
+     * NOSE's is read: its centre and width are the nose's turn landmark
+     * (`turnLandmarks`), so a shaded nose is fitted by the drawing rather than
+     * by its feather, and its top edge at its centre x is the bridge top the
+     * nose tilts about on the turn (`NOSE_TURN_TILT_DEG`). Absent — as the
+     * editor's own import leaves it — the crop stands in for both. Validated
+     * before anything reads it: a plain object whose x, y, w and h are finite,
+     * w and h positive, and the box inside `bbox`.
+     */
+    denseCore?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
 }
 /**
  * Map an array of raw filenames to canonical `{ role, fileName }` pairs.

package/dist/index.js

@@ -1837,6 +1837,45 @@ function validateLayerInputs(layers, canvas) {
         }
       }
     }
+    if (layer.denseCore !== void 0) {
+      const where = `auto-rig: validateLayerInputs: role "${role}" denseCore`;
+      const core = layer.denseCore;
+      if (typeof core !== "object" || core === null || Array.isArray(core)) {
+        throw new Error(`${where} must be a plain object { x, y, w, h }`);
+      }
+      for (const field of ["x", "y", "w", "h"]) {
+        const v = core[field];
+        const size = field === "w" || field === "h";
+        if (typeof v !== "number" || !Number.isFinite(v) || size && v <= 0) {
+          throw new Error(
+            `${where}.${field} is ${String(v)}, not a finite number${size ? " > 0" : ""}`
+          );
+        }
+      }
+      const { x, y, w, h } = layer.denseCore;
+      const right = bbox.x + bbox.w;
+      const bottom = bbox.y + bbox.h;
+      if (x < bbox.x) {
+        throw new Error(
+          `${where}.x (${x}) lies left of the bbox's left edge (${bbox.x})`
+        );
+      }
+      if (y < bbox.y) {
+        throw new Error(
+          `${where}.y (${y}) lies above the bbox's top edge (${bbox.y})`
+        );
+      }
+      if (x + w > right) {
+        throw new Error(
+          `${where}.w (${w}) puts its right edge at ${x + w}, past the bbox's right edge (${right})`
+        );
+      }
+      if (y + h > bottom) {
+        throw new Error(
+          `${where}.h (${h}) puts its bottom edge at ${y + h}, past the bbox's bottom edge (${bottom})`
+        );
+      }
+    }
   }
 }
 function validateStrandEdges(layers, strandEdges) {
@@ -2391,12 +2430,17 @@ function resolveTurnTargets(targets = {}) {
     defaulted
   };
 }
+function noseDrawnBox(layer) {
+  return layer.denseCore ?? layer.bbox;
+}
 function turnLandmarks(layers, carriers) {
   const markOf = (role) => {
     const layer = layers.find((l) => l.role === role);
     if (!layer) return void 0;
-    const t = bboxToTransform(layer.bbox, layer.canvasW, layer.canvasH, role);
-    const mark = { x: t.x, y: t.y, w: layer.cropW };
+    const drawn = role === "nose" ? noseDrawnBox(layer) : layer.bbox;
+    const t = bboxToTransform(drawn, layer.canvasW, layer.canvasH, role);
+    const w = drawn === layer.bbox ? layer.cropW : drawn.w;
+    const mark = { x: t.x, y: t.y, w };
     const carrier = carriers?.get(role);
     if (carrier !== void 0) mark.carrier = carrier;
     return mark;
@@ -3347,6 +3391,7 @@ function solveTurnModel(targets, landmarks, lattice, faceCenterX, faceHalfWidth,
 var EYE_STACK_PREFIXES = ["eye_", "iris_", "pupil_", "highlight_"];
 var HAIR_FRONT_DEPTH = 0.1;
 var MOUTH_TURN_TILT_DEG = 5;
+var NOSE_TURN_TILT_DEG = 6;
 var NOD_TRAVEL = 30;
 var NOD_BEND = 0.5;
 var HAIR_BACK_NOD_DEPTH = -0.135;
@@ -3959,11 +4004,31 @@ function turnSetup(layers) {
     y: mouthAt.y,
     tiltDeg: MOUTH_TURN_TILT_DEG
   };
+  const noseLayer = layers.find((l) => l.role === "nose");
+  let noseAnchor;
+  if (noseLayer) {
+    const drawn = noseDrawnBox(noseLayer);
+    const at = bboxToTransform(
+      drawn,
+      noseLayer.canvasW,
+      noseLayer.canvasH,
+      "nose"
+    );
+    noseAnchor = {
+      x: at.x,
+      y: at.y + drawn.h / 2,
+      tiltDeg: NOSE_TURN_TILT_DEG
+    };
+  }
   const carriers = new Map(
-    members.map((m) => [
-      m.role,
-      m.group === "mouthWarp" ? { grid: groupGrids.get(m.group), part: m.part, anchor: mouthAnchor } : { grid: groupGrids.get(m.group), part: m.part }
-    ])
+    members.map((m) => {
+      const grid = groupGrids.get(m.group);
+      const anchor = m.group === "mouthWarp" ? mouthAnchor : m.group === "noseWarp" ? noseAnchor : void 0;
+      return [
+        m.role,
+        anchor === void 0 ? { grid, part: m.part } : { grid, part: m.part, anchor }
+      ];
+    })
   );
   const maxShift = Math.max(turnShift.eye, turnShift.nose, turnShift.mouth);
   let reach = 0;