rig-parts 1.79.0 → 1.79.1

package/docs/AUTHORING.md

@@ -5772,7 +5772,14 @@ Assembly uses the actual run registration, source-copy/composite coordinates,
 merge ownership and final crop. Scalar bilinear sampling at pixel centres is
 quantized half up at each intermediate copy/composite grid, then again at
 final part registration. PAD4 repeats the resulting u8 edge values. There is no
-universal half-level total-error bound across those operators. No art-color
+universal half-level total-error bound across those operators. The drawing warp rounds its inverse coordinates to
+1/32 px and uses bilinear or bicubic support; scalar sampling keeps its existing
+unrounded inverse map plus the half-pixel centre. Visible final-grid samples
+less than one source pixel outside a registered crop retain the edge texel.
+At one pixel or more outside on either axis, `DEPTH_PART_SUPPORT` still refuses.
+Assembly logs and neck-draft notes report the clamped visible sample count per
+part, counting a corner once. Transparent cells are excluded from that count.
+No source sheet is padded or inferred. No art-color
 premultiplication or local min/max rescaling is applied. The rig sheet receives the drawing's PAD4 with
 explicit rectangular edge clamping. Original source hashes, rectangles, medians
 and declared units accompany the optional `parts.json` part `depth` reference.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rig-parts",
-  "version": "1.79.0",
+  "version": "1.79.1",
   "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/assemble.ts

@@ -4445,6 +4445,8 @@ export interface AssembleResult {
   seamRule: SeamRule;
   projectRule: ProjectRule;
   depthReadings?: Array<{ from: string; reading: import('./depthsheets.ts').DepthReading }>;
+  /** Visible registered samples clamped within <1 source pixel of a crop. */
+  depthClamps?: Array<{ part: string; samples: number }>;
   /** Issue #492: head-canvas pixels filled by `config.assemble.head_face_underfill: true` when > 0. */
   headFaceUnderfillPx?: number;
   /** Issue #587: what each `exclude` entry took, in entry order; empty without one. */
@@ -5397,6 +5399,7 @@ export function assemble(input: AssembleInput): AssembleResult {
   });
 
   const planned: Array<PlacedPart | null> = plan.map(() => null);
+  const depthClamps: NonNullable<AssembleResult['depthClamps']> = [];
   const cutPlaced: Array<PlacedPart | null> = cuts.map(() => null);
   // A cut's piece records the plan part it was cut from (issue #230): parts.json is in draw order, so a piece drawn
   // "back" comes before its base, and nothing else in the file says which of the two is the piece.
@@ -5472,6 +5475,7 @@ export function assemble(input: AssembleInput): AssembleResult {
       ...((limb?.cap?.image_px ?? 0) > 0 || (limb?.cap?.lower_px ?? 0) > 0 ? { unsupported: `cap copies ${(limb?.cap?.image_px ?? 0) + (limb?.cap?.lower_px ?? 0)} pixels from a separate cap image whose scalar grid is undeclared` } : {}),
     });
     if (scalar !== undefined) record.depth = scalar.reference;
+    if (scalar !== undefined && scalar.clampedSamples > 0) depthClamps.push({ part: name, samples: scalar.clampedSamples });
     set({ record, image, ...(scalar === undefined ? {} : { depthImage: scalar.image }) });
   });
   refuseIfAny(empty);
@@ -5528,6 +5532,7 @@ export function assemble(input: AssembleInput): AssembleResult {
     },
     images: placed,
     ...(registeredDepth.size === 0 ? {} : { depthReadings: ([['full', depthFullInput], ...(single ? [] : [['head', depthHeadInput]])] as Array<['full' | 'head', LayerSet]>).flatMap(([run, set]) => set.layers.flatMap(layer => layer.depthSheet === undefined ? [] : [{ from: `${run}:${layer.name}`, reading: layer.depthSheet.reading }])) }),
+    ...(depthClamps.length === 0 ? {} : { depthClamps }),
     recomposite: can,
     errorMap: recompositeErrorMap(can, srcr, placed, inside),
     figure: inside === null ? null : figureImage(inside, W, H),

package/src/build.ts

@@ -384,7 +384,7 @@ export function assembleStage(input: AssembleStageInput, outs: AssembleOutputs,
   }
 
   const altProblems: Problem[] = [];
-  const altBuilt: Array<{ record: AlternatePartsRecord; images: Array<{ name: string; image: Raster }>; excluded: ExcludedCount[]; islands: IslandCount[]; splits: SplitCount[]; capSplits: SplitCount[] }> = [];
+  const altBuilt: Array<{ record: AlternatePartsRecord; images: Array<{ name: string; image: Raster }>; excluded: ExcludedCount[]; islands: IslandCount[]; splits: SplitCount[]; capSplits: SplitCount[]; depthClamps: AssembleResult['depthClamps'] }> = [];
   const baseSlots = result.parts.parts.map((p) => p.name);
   // Issue #664: each limb segment part with a declared front slot -> the part its front slot follows.
   const frontAfter = new Map<string, string>();
@@ -724,6 +724,7 @@ export function assembleStage(input: AssembleStageInput, outs: AssembleOutputs,
       islands: altRes.islands,
       splits: altRes.splits,
       capSplits: altRes.capSplits,
+      depthClamps: altRes.depthClamps,
     });
   }
   const emittedAssets = [
@@ -762,6 +763,8 @@ export function assembleStage(input: AssembleStageInput, outs: AssembleOutputs,
     if (depthImage !== undefined && record.depth !== undefined) writePng(join(outs.partsDir, record.depth.image), depthImage);
   }
   for (const row of result.depthReadings ?? []) log(`  depth reading ${row.from}: ${row.reading.relation}; ordering median ${row.reading.orderingMedian}, source-sheet median ${row.reading.sheetMedian} (half-level quantization; reading only, polarity declared)`);
+  for (const row of result.depthClamps ?? []) log(`  depth edge clamp ${row.part}: ${row.samples} visible samples less than 1 source pixel outside the crop; edge texels retained`);
+  for (const b of altBuilt) for (const row of b.depthClamps ?? []) log(`  set "${b.record.name}" depth edge clamp ${row.part}: ${row.samples} visible samples less than 1 source pixel outside the crop; edge texels retained`);
   for (const b of altBuilt) {
     for (const { name, image } of b.images) writePng(join(outs.partsDir, `${name}.png`), image);
   }

package/src/depthsheets.ts

@@ -207,6 +207,10 @@ export interface DepthTransport {
 }
 /** Resample on the FINAL unpadded part grid. Visible synthesized/unsupported
  * material refuses; transparent cells and later PAD4 use explicit edge clamp.
+ * Registered art filtering can reach less than one source pixel beyond its
+ * crop. Keep that edge texel; a visible sample >=1px outside still refuses.
+ * clampedSamples counts visible samples outside the half-open crop, once per
+ * output pixel even at a corner. It is a reading, not emitted provenance.
  * No geometry, art pixels, source field or calibration are changed here.
  */
 export function transportPartDepth(
@@ -214,13 +218,14 @@ export function transportPartDepth(
   art: Raster,
   registered: ReadonlyMap<string, RegisteredDepth>,
   transport: DepthTransport,
-): { reference: PartDepthReference; image: Raster } | undefined {
+): { reference: PartDepthReference; image: Raster; clampedSamples: number } | undefined {
   const keys = [part.from, ...transport.extend];
   const initial = keys.map(k => registered.get(k)).find((s): s is RegisteredDepth => s !== undefined);
   if (initial === undefined) return undefined;
   const fail = (detail: string): never => { throw new PartsError([{ code: 'DEPTH_PART_SUPPORT', object: `part "${part.name}"`, detail }]); };
   if (transport.unsupported !== undefined) fail(`${transport.unsupported}; an exact source-bound scalar transport is required`);
   const image = newRaster(part.w, part.h), used = new Map<string, RegisteredDepth>();
+  let clampedSamples = 0;
   for (let y = 0; y < part.h; y++) for (let x = 0; x < part.w; x++) {
     const rx = part.x + x, ry = part.y + y, pos = ry * transport.width + rx;
     const visible = art.data[(y * part.w + x) * 4 + 3] > 0;
@@ -233,12 +238,13 @@ export function transportPartDepth(
     const sourceKey = source === undefined ? keys.find(k => registered.get(k) === initial) as string : key;
     const run = sourceKey.startsWith('head:') ? 'head' : 'full';
     const m = transport.map(run), px = (rx - m.tx) / m.sx - input.layer.left + 0.5, py = (ry - m.ty) / m.sx - input.layer.top + 0.5;
-    if (visible && (px < 0 || py < 0 || px > input.sheet.pixels.width || py > input.sheet.pixels.height)) fail(`rig pixel (${rx},${ry}) maps to source (${px},${py}) outside ${input.sheet.pixels.width}x${input.sheet.pixels.height}; source art filtering/generated material has no declared depth there`);
+    if (visible && (px <= -1 || py <= -1 || px >= input.sheet.pixels.width + 1 || py >= input.sheet.pixels.height + 1)) fail(`rig pixel (${rx},${ry}) maps to source (${px},${py}) outside ${input.sheet.pixels.width}x${input.sheet.pixels.height}; source art filtering/generated material has no declared depth there`);
+    if (visible && (px < 0 || py < 0 || px >= input.sheet.pixels.width || py >= input.sheet.pixels.height)) clampedSamples++;
     const level = sampleDepthLevel(input.sheet.pixels, px, py);
     image.data.set([level, level, level, 255], (y * part.w + x) * 4);
     if (visible && source !== undefined) used.set(key, source);
   }
-  return { image, reference: {
+  return { image, clampedSamples, reference: {
     image: `${part.name}_depth.png`, near: initial.near, zScale: initial.zScale,
     sources: [...new Map([...used].flatMap(([from, s]) => s.sheet.sources ?? [{ from, image: s.sheet.file, sha256: s.sheet.sha256, crop: [s.layer.left, s.layer.top, s.layer.right, s.layer.bottom] as [number, number, number, number], reading: s.sheet.reading }]).map(s => [`${s.from}:${s.sha256}`, s])).values()],
   } };

package/src/neckdraft.ts

@@ -51,6 +51,7 @@ export function draftIndependentNeck(input: { config: CharacterConfig; source: R
   body.roles[part] = 'unit';
   // Stage fields now see the new role before any color/fringe ownership operation.
   const assembled = assemble({ source: input.source, full: input.full, head: input.head, ...stageFields(cfg), under: input.under, caps: input.caps, seamRule: 'near-white', projectRule: 'core', depth: cfg.depth, depthBase: input.base });
+  for (const row of assembled.depthClamps ?? []) notes.push(`depth edge clamp ${row.part}: ${row.samples} visible samples less than 1 source pixel outside the crop; edge texels retained`);
   const rec = assembled.parts.parts.find(p => p.name === part)!;
   const image = assembled.images.find(p => p.record.name === part)!.image;
   const own = assembled.images.find(p => p.record.name === part)!;