rig-parts 1.63.0 → 1.64.0

package/docs/AUTHORING.md

@@ -1016,7 +1016,7 @@ still judges the mesh before the rig stage publishes anything.
 
 `segments` is required in this mode too, but names bones directly: first the
 accepted slot bone, then any other weighted bones. All weight bones must be
-listed. A declared stopped link may be named by its emitted `<link>_d` name; no other unknown name resolves by suffix. Chain shorthand and coordinate segments are refused here. These names
+listed. A declared stopped link may be named by its emitted `<link>_d` name; no other unknown name resolves by suffix (`RIG_EXPLICIT_BINDING` refuses a raw stopped link that `stops` would rewrite). When the part is also in `turn.depths` (issue #740), state `segments`, `weights` and any island `bone` in those pre-turn bone names; `turn` wraps them into `turn_<part>_<bone>` at zero offset (`x: 0, y: 0`) after the stop-binding check, leaving the bone-local bind coordinates `(x, y, weight)` unchanged. Chain shorthand and coordinate segments are refused here. These names
 are bindings, not a recipe to generate geometry. Do not supply `r`, `grid`,
 `contour`, `auto`, `influence`, `exponent`, `rule`, `ribs`, `influences` or `stray`
 beside `explicit` (`CONFIG_EXPLICIT_MODE`). `gather: false` retains its usual
@@ -3841,7 +3841,7 @@ says why each requirement exists and what breaks without it.
 | <a id="RIG_LAYOUT_CONFLICT"></a>`RIG_LAYOUT_CONFLICT` | layout declarations share a moving slot, use a moving slot as a target, target themselves, form a reciprocal/chained pair, or partially overlap a shared target block; both field paths are printed | move each participating slot in at most one placement, and share only a stationary target block |
 | <a id="RIG_STILL_ROW_INSIDE_PART"></a><a id="RIG_STILL_ROW_CLEAR"></a><a id="RIG_STILL_PIECES_HAVE_ART"></a><a id="RIG_STILL_NAME_FREE"></a>`RIG_STILL_ROW_INSIDE_PART`, `RIG_STILL_ROW_CLEAR`, `RIG_STILL_PIECES_HAVE_ART`, `RIG_STILL_NAME_FREE` | a `motion.blink.still` row that is not strictly inside the part, that crosses art (a cut through art changes the render even at rest), that leaves one piece with no art, or whose `<part>_still` slot name another part already has | that entry's `row` — a row with no art between the crease and the lash line — or rename the other part |
 | <a id="RIG_SET_COVERS_BONE"></a>`RIG_SET_COVERS_BONE` | `assemble.alternates[i].drawn.<bone>` (issue #476): a subset set in `parts.json` `alternates` (`parts` present) states a `drawn` world angle for a bone none of its covered slots ride; the detail names the bone, the set, and the covered bones | remove the uncovered bone from that set's `drawn`, or add the part that rides it to `parts` |
-| <a id="RIG_EXPLICIT_BINDING"></a>`RIG_EXPLICIT_BINDING` | the declared stops or turn would change the accepted payload's bindings | transfer the accepted final emitted bone names and local coordinates, or use a generated mesh; no normalization is applied |
+| <a id="RIG_EXPLICIT_BINDING"></a>`RIG_EXPLICIT_BINDING` | the declared stops would change the accepted payload's bindings | transfer the accepted final emitted bone names and local coordinates, or use a generated mesh; no normalization is applied |
 | <a id="RIG_EXPLICIT_IMAGE_HASH"></a>`RIG_EXPLICIT_IMAGE_HASH` | the decoded part RGBA differs from `explicit.image_sha256`; both digests are named | restore the accepted image or transfer its matching accepted payload and guard; nothing is written |
 | <a id="RIG_EXPLICIT_REGION_HASH"></a>`RIG_EXPLICIT_REGION_HASH` | the canvas or placed part rectangle differs from `explicit.region_sha256`; both digests are named | restore the accepted region or transfer a payload bound to this placement; nothing is written |
 | <a id="RIG_EXPLICIT_ISLAND_COUNT"></a>`RIG_EXPLICIT_ISLAND_COUNT` | `explicit.islands.length` differs from the non-dust 4-connected art island count of `parts/<part>.png`; the missing or extra `<part>__island<N>` slot names and island pixel counts are named | supply one `explicit.islands` entry per non-dust art island (`<part>`, `<part>__island2`, …); nothing is written |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rig-parts",
-  "version": "1.63.0",
+  "version": "1.64.0",
   "description": "AI-authored 2D character parts from one anime painting and its See-through layer decomposition: measured parts, weighted-mesh rig specs, verified through rig-c before anything is written. A CLI for agents that cannot see the image.",
   "type": "module",
   "bin": {

package/src/rig.ts

@@ -2774,6 +2774,35 @@ export function buildRig(
   // from the drawn link `<link>_d` above it, and slots and weights on a stopped link bind `<link>_d`.
   const rebound = frontSlots.length === 0 ? slots : [...slots, ...frontSlots];
   const stops = cfg.stops === undefined ? null : applyStops(cfg.stops, chains, bones, rebound, skin, (original, emitted) => layoutAlias(explicitLayout.plan, original, emitted));
+  for (const [part, mesh] of Object.entries(cfg.meshes)) if ('explicit' in mesh) {
+    const defaultBone = typeof mesh.segments[0] === 'string' ? mesh.segments[0] : mesh.segments[0][0];
+    if (mesh.explicit.islands !== undefined) {
+      mesh.explicit.islands.forEach((isl, i) => {
+        const att = skin[isl.slot]?.[isl.slot];
+        const slotEntry = slots.find((s) => s.name === isl.slot);
+        const expectedBone = isl.bone ?? defaultBone;
+        const weightsChanged =
+          att !== undefined &&
+          'type' in att &&
+          JSON.stringify(att.weights) !== JSON.stringify(isl.weights.map(row => row.map(w => ({ bone: w.bone, x: w.x, y: w.y, weight: w.weight }))));
+        const boneChanged = slotEntry !== undefined && slotEntry.bone !== expectedBone;
+        if (weightsChanged || boneChanged) {
+          fail('RIG_EXPLICIT_BINDING', `config.meshes.${part}.explicit.islands[${i}].weights`, 'the declared stops would change these accepted bindings; supply the accepted final emitted bone names and bind coordinates, or use a generated mesh; no payload is normalized');
+        }
+      });
+      continue;
+    }
+    const att = skin[part]?.[part];
+    const slotEntry = slots.find((s) => s.name === part);
+    const weightsChanged =
+      att !== undefined &&
+      'type' in att &&
+      JSON.stringify(att.weights) !== JSON.stringify((mesh.explicit.weights ?? []).map(row => row.map(w => ({ bone: w.bone, x: w.x, y: w.y, weight: w.weight }))));
+    const boneChanged = slotEntry !== undefined && slotEntry.bone !== defaultBone;
+    if (weightsChanged || boneChanged) {
+      fail('RIG_EXPLICIT_BINDING', `config.meshes.${part}.explicit.weights`, 'the declared stops would change these accepted bindings; supply the accepted final emitted bone names and bind coordinates, or use a generated mesh; no payload is normalized');
+    }
+  }
   // ---- the turn control (issue #251) -------------------------------------
   // Only when the config has `turn`: every other build adds nothing here, so no byte moves.
   if (cfg.turn !== undefined) refuseIfAny(turnRiderProblems(cfg.turn, cfg, parts.parts));
@@ -2795,30 +2824,6 @@ export function buildRig(
     const att = skin[row.part]?.[row.part];
     if (att !== undefined && 'type' in att) row.bones = meshBoundBones(att);
   }
-
-  for (const [part, mesh] of Object.entries(cfg.meshes)) if ('explicit' in mesh) {
-    const defaultBone = typeof mesh.segments[0] === 'string' ? mesh.segments[0] : mesh.segments[0][0];
-    if (mesh.explicit.islands !== undefined) {
-      mesh.explicit.islands.forEach((isl, i) => {
-        const att = skin[isl.slot]?.[isl.slot];
-        const slotEntry = slots.find((s) => s.name === isl.slot);
-        const expectedBone = isl.bone ?? defaultBone;
-        const weightsChanged =
-          att !== undefined &&
-          'type' in att &&
-          JSON.stringify(att.weights) !== JSON.stringify(isl.weights.map(row => row.map(w => ({ bone: w.bone, x: w.x, y: w.y, weight: w.weight }))));
-        const boneChanged = slotEntry !== undefined && slotEntry.bone !== expectedBone;
-        if (weightsChanged || boneChanged) {
-          fail('RIG_EXPLICIT_BINDING', `config.meshes.${part}.explicit.islands[${i}].weights`, 'the declared stops or turn would change these accepted bindings; supply the accepted final emitted bone names and bind coordinates, or use a generated mesh; no payload is normalized');
-        }
-      });
-      continue;
-    }
-    const att = skin[part]?.[part];
-    if (att !== undefined && 'type' in att && JSON.stringify(att.weights) !== JSON.stringify((mesh.explicit.weights ?? []).map(row => row.map(w => ({ bone: w.bone, x: w.x, y: w.y, weight: w.weight }))))) {
-      fail('RIG_EXPLICIT_BINDING', `config.meshes.${part}.explicit.weights`, 'the declared stops or turn would change these accepted bindings; supply the accepted final emitted bone names and bind coordinates, or use a generated mesh; no payload is normalized');
-    }
-  }
   refuseIfAny(problems);
   const name = `${cfg.key}_painting`;
   const rig: RigSpec = {