spine-rigc 2.57.0 → 2.58.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-rigc",
-  "version": "2.57.0",
+  "version": "2.58.0",
   "description": "AI-authored 2D rigging and animation, verified before it is written. rigc compiles a rig spec into skeleton data in the Spine 4.3 format, gates it with named assertions held to a spine-core round trip's verdicts, and emits nothing that fails. Ships as an agent skill.",
   "type": "module",
   "bin": {

package/skills/rigc/SKILL.md

@@ -18,7 +18,9 @@ whole interface, and this skill only says which of them to open.
 ` (see rigc guide <RULE>)`. Run that command first, before reading anything else:
 it prints that rule's row of the shipped guide and nothing else, and `rigc guide §<n>`
 (and `§<n>.<m>`, `§<n>.<m>.<k>`)
-prints one section of `docs/AUTHORING.md` — a compile error points at `§5.1`.
+prints one section of `docs/AUTHORING.md` — a compile error points at its stable `CE_` code row. `rigc guide §5.1.<k>`
+prints a numbered compile-error group of at most 30,000 UTF-8 bytes; only legacy
+uncoded library errors point at `§5.1`.
 
 ## Non-negotiables
 

package/skills/rigc-face/SKILL.md

@@ -16,7 +16,9 @@ it will not do for you.
 ` (see rigc guide <RULE>)`. Run that command first, before reading anything else:
 it prints that rule's row of the shipped guide and nothing else, and `rigc guide §<n>`
 (and `§<n>.<m>`, `§<n>.<m>.<k>`)
-prints one section of `docs/AUTHORING.md` — a compile error points at `§5.1`.
+prints one section of `docs/AUTHORING.md` — a compile error points at its stable `CE_` code row. `rigc guide §5.1.<k>`
+prints a numbered compile-error group of at most 30,000 UTF-8 bytes; only legacy
+uncoded library errors point at `§5.1`.
 
 ## Non-negotiables
 

package/skills/rigc-ingest/SKILL.md

@@ -17,7 +17,9 @@ not do for you.
 ` (see rigc guide <RULE>)`. Run that command first, before reading anything else:
 it prints that rule's row of the shipped guide and nothing else, and `rigc guide §<n>`
 (and `§<n>.<m>`, `§<n>.<m>.<k>`)
-prints one section of `docs/AUTHORING.md` — a compile error points at `§5.1`.
+prints one section of `docs/AUTHORING.md` — a compile error points at its stable `CE_` code row. `rigc guide §5.1.<k>`
+prints a numbered compile-error group of at most 30,000 UTF-8 bytes; only legacy
+uncoded library errors point at `§5.1`.
 
 ## Non-negotiables
 

package/skills/rigc-motion/SKILL.md

@@ -17,7 +17,9 @@ not do for you.
 ` (see rigc guide <RULE>)`. Run that command first, before reading anything else:
 it prints that rule's row of the shipped guide and nothing else, and `rigc guide §<n>`
 (and `§<n>.<m>`, `§<n>.<m>.<k>`)
-prints one section of `docs/AUTHORING.md` — a compile error points at `§5.1`.
+prints one section of `docs/AUTHORING.md` — a compile error points at its stable `CE_` code row. `rigc guide §5.1.<k>`
+prints a numbered compile-error group of at most 30,000 UTF-8 bytes; only legacy
+uncoded library errors point at `§5.1`.
 
 ## Non-negotiables
 

package/skills/rigc-rigging/SKILL.md

@@ -16,7 +16,9 @@ will not do for you.
 ` (see rigc guide <RULE>)`. Run that command first, before reading anything else:
 it prints that rule's row of the shipped guide and nothing else, and `rigc guide §<n>`
 (and `§<n>.<m>`, `§<n>.<m>.<k>`)
-prints one section of `docs/AUTHORING.md` — a compile error points at `§5.1`.
+prints one section of `docs/AUTHORING.md` — a compile error points at its stable `CE_` code row. `rigc guide §5.1.<k>`
+prints a numbered compile-error group of at most 30,000 UTF-8 bytes; only legacy
+uncoded library errors point at `§5.1`.
 
 ## Non-negotiables
 

package/src/atlas.ts

@@ -1998,7 +1998,7 @@ function packOnePageByFootprint(
       if (shapesMeet(shape, put.x, put.y, other.shape, other.x, other.y)) {
         throw new CompileError(
           `internal: the footprint pass placed a ${shape.width}x${shape.height} cell at ${put.x},${put.y} over ` +
-            `the footprint of the ${other.shape.width}x${other.shape.height} cell at ${other.x},${other.y}`,
+            `the footprint of the ${other.shape.width}x${other.shape.height} cell at ${other.x},${other.y}`, 'CE_ATLAS_INTERNAL_FOOTPRINT_OVERLAP',
         );
       }
     }
@@ -2313,7 +2313,7 @@ function layoutPack(
         // Unreachable: every cell was proven to fit an empty page above. Kept as
         // a named stop rather than an infinite loop if that ever stops holding.
         throw new CompileError(
-          `packing stalled with ${remaining.length} region(s) left and an empty ${maxEdge}x${maxEdge} page`,
+          `packing stalled with ${remaining.length} region(s) left and an empty ${maxEdge}x${maxEdge} page`, 'CE_ATLAS_PACKING_STALLED',
         );
       }
       // ⭐ Then the page is written at the smallest power-of-two pair that holds
@@ -2337,7 +2337,7 @@ function layoutPack(
       if (shrunk === null) {
         // Unreachable for the same reason as the stall above: these cells were
         // just placed on a maxEdge page.
-        throw new CompileError(`page ${pageIndex + 1} of the spill holds ${onPage.length} region(s) that no page fits`);
+        throw new CompileError(`page ${pageIndex + 1} of the spill holds ${onPage.length} region(s) that no page fits`, 'CE_ATLAS_SPILL_UNPACKABLE');
       }
       const onThisPage: Placement[] = [];
       shrunk.rects.forEach((rect, i) => {
@@ -2460,19 +2460,19 @@ export function packAtlas(inputs: PackInput[], opts: PackOptions = {}): PackResu
   const stem = opts.pageStem ?? 'skeleton';
   const pageEdges = opts.pageEdges ?? DEFAULT_PAGE_EDGES;
   if (!PAGE_EDGES.includes(pageEdges)) {
-    throw new CompileError(`--page-edges ${JSON.stringify(String(opts.pageEdges))}; known values: ${PAGE_EDGES.join(', ')}`);
+    throw new CompileError(`--page-edges ${JSON.stringify(String(opts.pageEdges))}; known values: ${PAGE_EDGES.join(', ')}`, 'CE_ATLAS_PAGE_EDGES_VALUE');
   }
   const shape = opts.shape ?? DEFAULT_PACK_SHAPE;
   if (!PACK_SHAPES.includes(shape)) {
-    throw new CompileError(`--pack-shape ${JSON.stringify(String(opts.shape))}; known values: ${PACK_SHAPES.join(', ')}`);
+    throw new CompileError(`--pack-shape ${JSON.stringify(String(opts.shape))}; known values: ${PACK_SHAPES.join(', ')}`, 'CE_ATLAS_PACK_SHAPE_VALUE');
   }
   if (!Number.isInteger(pageSize) || pageSize < 1) {
-    throw new CompileError(`--page-size must be a positive integer, got ${String(opts.pageSize)}`);
+    throw new CompileError(`--page-size must be a positive integer, got ${String(opts.pageSize)}`, 'CE_ATLAS_PAGE_SIZE_POSITIVE_INTEGER');
   }
   if (!Number.isInteger(padding) || padding < 0) {
-    throw new CompileError(`--padding must be a non-negative integer, got ${String(opts.padding)}`);
+    throw new CompileError(`--padding must be a non-negative integer, got ${String(opts.padding)}`, 'CE_ATLAS_PADDING_NONNEGATIVE_INTEGER');
   }
-  if (inputs.length === 0) throw new CompileError('nothing to pack: this compile emitted no images');
+  if (inputs.length === 0) throw new CompileError('nothing to pack: this compile emitted no images', 'CE_ATLAS_IMAGES_REQUIRED');
 
   const maxEdge = floorPowerOfTwo(pageSize);
 
@@ -2485,7 +2485,7 @@ export function packAtlas(inputs: PackInput[], opts: PackOptions = {}): PackResu
       `"${sorted[i].region}" is ${sorted[i].width}x${sorted[i].height} and with --padding ${padding} needs a ` +
         `${cells[i].w}x${cells[i].h} cell, which does not fit a ${maxEdge}x${maxEdge} page ` +
         `(${sorted[i].absPath}). Raise --page-size, lower --padding, or leave this build unpacked — a packer ` +
-        'cannot split one drawing across two pages.',
+        'cannot split one drawing across two pages.', 'CE_ATLAS_REGION_EXCEEDS_PAGE',
     );
   }
 
@@ -2542,7 +2542,7 @@ export function packAtlas(inputs: PackInput[], opts: PackOptions = {}): PackResu
         // two reads, or one of the two readers is wrong about it.
         throw new CompileError(
           `"${place.region}" measured ${input.width}x${input.height} from its PNG header and decodes to ` +
-            `${source.width}x${source.height} (${input.absPath})`,
+            `${source.width}x${source.height} (${input.absPath})`, 'CE_ATLAS_IMAGE_DIMENSIONS_CHANGED',
         );
       }
       extrudeCell(plate, source, place.x - padding, place.y - padding, padding);

package/src/cli/shared.ts

@@ -2956,8 +2956,8 @@ function refuse(err: unknown, command: string | undefined, USAGE: string, entry:
     process.exit(2);
   }
   if (err instanceof CompileError) {
-    // Ends with ` (see rigc guide §5.1)` (issue #1397): a compile error names no rule, so it points at the section.
-    console.error(compileErrorLine(err.message));
+    // The site's code points at its one AUTHORING row; uncoded library errors keep the legacy section.
+    console.error(compileErrorLine(err.message, err.code));
     // The drops the compile recorded before it stopped, in the same line the
     // green build prints (issue #671). They were reported from the compile
     // RESULT alone, so the run that failed BECAUSE a file was missing was the