@ikijs/editor 0.5.0 → 0.6.0

package/README.md

@@ -92,7 +92,10 @@ is still the furthest out after it turns.
 It takes **already-decoded** layer geometry (`LayerInput`), never pixels, which
 is what keeps this package free of any image dependency: the editor app
 decodes with canvas, `@ikijs/mcp` decodes with `sharp`, and both feed the same
-pure function.
+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.
 
 `*_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

@@ -875,6 +875,19 @@ interface LayerInput {
     cropW: number;
     /** Cropped image height = bbox.h. */
     cropH: number;
+    /**
+     * The layer's painted half-width on every CROP row, top → bottom, one entry
+     * per row (`cropH` of them): half the row's opaque span in canvas px under
+     * the same alpha ≥ 128 rule the head's `headEdges` are measured with
+     * (`@ikijs/mcp`'s `measure-turn`), 0 for a row with no opaque pixel.
+     * Optional, and only the FACE's is read: it gives the face plate a
+     * row-dependent turn radius and a chin swing (`faceRowProfile`,
+     * `turnSurface`); absent — as the editor's own import leaves it — the plate
+     * turns on one radius on every row. Validated before anything reads it: an
+     * array of length `cropH` whose every entry is a finite number in
+     * [0, cropW / 2], the most an inclusive span inside the crop can be.
+     */
+    rowHalfWidths?: number[];
 }
 /**
  * Map an array of raw filenames to canonical `{ role, fileName }` pairs.
@@ -983,16 +996,23 @@ interface TurnSolveReport {
  *
  *   - Validate all inputs before deriving anything.
  *   - Place parts at source-derived positions (bboxToTransform, unshifted).
- *   - Emit the standard parameters (same ids/ranges as sample-model.ts), plus a
- *     conditional HairSwayX descriptor + hair-sway physics rig when a hair_front
- *     layer is present.
+ *   - Emit the standard parameters (STANDARD_PARAMETERS), plus a conditional
+ *     HairSwayX/Z pair + hair-sway physics rigs when a hair_front layer is
+ *     present.
+ *   - Size every turn group's grid to its own members and the virtual lattice
+ *     to those grids, then solve the turn on them (turnSetup, solveTurnModel):
+ *     one surface — radius, travel, the head-level nod radius — that every
+ *     bake below samples.
  *   - Build headDeformer (matrix, neck pivot, nod/tilt/breath bindings — the
- *     turn translates nothing rigidly; its travel is in the face warp),
+ *     turn translates nothing rigidly; its travel is in the group grids), one
+ *     warp deformer per turn group present — `faceWarp` for the plate,
+ *     `eyeWarp_L/R`, `mouthWarp`, `noseWarp`, `browWarp_L/R`, `blushWarp_L/R`
+ *     — each a warp2d over its own grid baked from that surface with the
+ *     family's solved depth as keyform geometry (bakeTurnGroupWarp2D), and
  *     bodyDeformer when a body layer is present (matrix, torso-base pivot,
- *     AngleX follow + Breath follow), and faceWarp (warp, FACE_GRID_CELLS²,
- *     baked cylinder warp center-relative on faceCenterX).
+ *     AngleX follow + Breath follow).
  *   - Mesh parts (spec.mesh===true) → width:1, height:1, pixel grid mesh sized by
- *     meshCellsFor + role bindings.
+ *     meshCellsFor + role bindings, each face-family part on its group's warp.
  *   - Static parts (spec.mesh===false) → width:cropW, height:cropH, no mesh.
  *   - Part ids equal the role string (deterministic, no crypto.randomUUID).
  *   - Return parseIkiModel(structuredClone(model)) — every caller gets a

package/dist/index.d.ts

@@ -875,6 +875,19 @@ interface LayerInput {
     cropW: number;
     /** Cropped image height = bbox.h. */
     cropH: number;
+    /**
+     * The layer's painted half-width on every CROP row, top → bottom, one entry
+     * per row (`cropH` of them): half the row's opaque span in canvas px under
+     * the same alpha ≥ 128 rule the head's `headEdges` are measured with
+     * (`@ikijs/mcp`'s `measure-turn`), 0 for a row with no opaque pixel.
+     * Optional, and only the FACE's is read: it gives the face plate a
+     * row-dependent turn radius and a chin swing (`faceRowProfile`,
+     * `turnSurface`); absent — as the editor's own import leaves it — the plate
+     * turns on one radius on every row. Validated before anything reads it: an
+     * array of length `cropH` whose every entry is a finite number in
+     * [0, cropW / 2], the most an inclusive span inside the crop can be.
+     */
+    rowHalfWidths?: number[];
 }
 /**
  * Map an array of raw filenames to canonical `{ role, fileName }` pairs.
@@ -983,16 +996,23 @@ interface TurnSolveReport {
  *
  *   - Validate all inputs before deriving anything.
  *   - Place parts at source-derived positions (bboxToTransform, unshifted).
- *   - Emit the standard parameters (same ids/ranges as sample-model.ts), plus a
- *     conditional HairSwayX descriptor + hair-sway physics rig when a hair_front
- *     layer is present.
+ *   - Emit the standard parameters (STANDARD_PARAMETERS), plus a conditional
+ *     HairSwayX/Z pair + hair-sway physics rigs when a hair_front layer is
+ *     present.
+ *   - Size every turn group's grid to its own members and the virtual lattice
+ *     to those grids, then solve the turn on them (turnSetup, solveTurnModel):
+ *     one surface — radius, travel, the head-level nod radius — that every
+ *     bake below samples.
  *   - Build headDeformer (matrix, neck pivot, nod/tilt/breath bindings — the
- *     turn translates nothing rigidly; its travel is in the face warp),
+ *     turn translates nothing rigidly; its travel is in the group grids), one
+ *     warp deformer per turn group present — `faceWarp` for the plate,
+ *     `eyeWarp_L/R`, `mouthWarp`, `noseWarp`, `browWarp_L/R`, `blushWarp_L/R`
+ *     — each a warp2d over its own grid baked from that surface with the
+ *     family's solved depth as keyform geometry (bakeTurnGroupWarp2D), and
  *     bodyDeformer when a body layer is present (matrix, torso-base pivot,
- *     AngleX follow + Breath follow), and faceWarp (warp, FACE_GRID_CELLS²,
- *     baked cylinder warp center-relative on faceCenterX).
+ *     AngleX follow + Breath follow).
  *   - Mesh parts (spec.mesh===true) → width:1, height:1, pixel grid mesh sized by
- *     meshCellsFor + role bindings.
+ *     meshCellsFor + role bindings, each face-family part on its group's warp.
  *   - Static parts (spec.mesh===false) → width:cropW, height:cropH, no mesh.
  *   - Part ids equal the role string (deterministic, no crypto.randomUUID).
  *   - Return parseIkiModel(structuredClone(model)) — every caller gets a