paperlab 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -30,197 +30,73 @@ var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: tr
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AGENT_PAYLOAD_VERSION: () => AGENT_PAYLOAD_VERSION,
   AUTO_CEILING: () => AUTO_CEILING,
-  ClothSim: () => ClothSim,
   DropZone: () => DropZone,
-  DropZoneRegistry: () => DropZoneRegistry,
   FLAT_SEGMENTS: () => FLAT_SEGMENTS,
   LightRig: () => LightRig,
-  ON_TWOS_FPS: () => ON_TWOS_FPS,
   PARITY_EPSILON: () => PARITY_EPSILON,
   Paper: () => Paper,
-  PaperFallback: () => PaperFallback,
   PaperField: () => PaperField,
   PaperFieldMesh: () => PaperFieldMesh,
   PaperLighting: () => PaperLighting,
-  PaperMaterial: () => PaperMaterial,
   PaperMesh: () => PaperMesh,
-  PaperMirror: () => PaperMirror,
-  PaperStateMachine: () => PaperStateMachine,
   SAG_TOL: () => SAG_TOL,
-  SHEET_LIFT: () => SHEET_LIFT,
-  TRANSMISSION_GAIN: () => TRANSMISSION_GAIN,
-  accordion: () => accordion,
-  applyDeformerStack: () => applyDeformerStack,
-  atlasGrid: () => atlasGrid,
-  backContentSchema: () => backContentSchema,
-  barcodeBars: () => barcodeBars,
   behaviorConfigSchema: () => behaviorConfigSchema,
-  bend: () => bend,
-  bendOptionsSchema: () => bendOptionsSchema,
-  book: () => book,
   buildAgentPayload: () => buildAgentPayload,
-  buildDisplacementGLSL: () => buildDisplacementGLSL,
   buildFieldAgentPayload: () => buildFieldAgentPayload,
   buildFieldComponentSource: () => buildFieldComponentSource,
-  buildFieldFragmentShader: () => buildFieldFragmentShader,
-  buildFieldVertexShader: () => buildFieldVertexShader,
   buildJsxSnippet: () => buildJsxSnippet,
-  cardContentSchema: () => cardContentSchema,
-  carry: () => carry,
-  carryDrive: () => carryDrive,
-  carryOptionsSchema: () => carryOptionsSchema,
   clothConfigSchema: () => clothConfigSchema,
-  colonnade: () => colonnade,
-  composeSurface: () => composeSurface,
-  contentSchema: () => contentSchema,
-  contentText: () => contentText,
   coreStateNames: () => coreStateNames,
-  cornerNames: () => cornerNames,
-  createSheetGeometry: () => createSheetGeometry,
-  crumple: () => crumple,
-  crumpleBehavior: () => crumpleBehavior,
-  crumpleBehaviorOptionsSchema: () => crumpleBehaviorOptionsSchema,
-  crumpleOptionsSchema: () => crumpleOptionsSchema,
-  curl: () => curl,
-  curlOptionsSchema: () => curlOptionsSchema,
-  dampTo: () => dampTo,
-  deformerInstanceSchema: () => deformerInstanceSchema,
   describeConfig: () => describeConfig,
   describeFieldConfig: () => describeFieldConfig,
   diffConfig: () => diffConfig,
   diffFieldProps: () => diffFieldProps,
-  displacePoint: () => displacePoint,
-  distinctFieldPresets: () => distinctFieldPresets,
-  drape: () => drape,
-  drapeOptionsSchema: () => drapeOptionsSchema,
-  drawBacking: () => drawBacking,
-  fall: () => fall,
-  fallOptionsSchema: () => fallOptionsSchema,
-  fan: () => fan,
-  fieldBounds: () => fieldBounds,
-  fieldKeyboardStep: () => fieldKeyboardStep,
-  filmNames: () => filmNames,
-  fitCamera: () => fitCamera,
-  flattenNumeric: () => flattenNumeric,
-  flight: () => flight,
-  flightOptionsSchema: () => flightOptionsSchema,
-  flightPose: () => flightPose,
-  flip: () => flip,
-  flipOptionsSchema: () => flipOptionsSchema,
-  fly: () => fly,
-  flyOptionsSchema: () => flyOptionsSchema,
-  fold: () => fold,
-  foldOptionsSchema: () => foldOptionsSchema,
   getBehavior: () => getBehavior,
   getDeformer: () => getDeformer,
-  getIdlePreset: () => getIdlePreset,
   getLayout: () => getLayout,
-  getLightingPreset: () => getLightingPreset,
   getPreset: () => getPreset,
   getStock: () => getStock,
-  groupFieldPapers: () => groupFieldPapers,
-  gust: () => gust,
-  hang: () => hang,
-  hangOptionsSchema: () => hangOptionsSchema,
   idleNames: () => idleNames,
-  idlePresets: () => idlePresets,
   isBuiltinPreset: () => isBuiltinPreset,
-  letterFold: () => letterFold,
-  letterFoldOptionsSchema: () => letterFoldOptionsSchema,
   lightAngles: () => lightAngles,
-  lightPosition: () => lightPosition,
   lightSchema: () => lightSchema,
-  lightenHex: () => lightenHex,
   lightingNames: () => lightingNames,
-  lightingPresets: () => lightingPresets,
   listBehaviors: () => listBehaviors,
   listDeformers: () => listDeformers,
   listLayouts: () => listLayouts,
   listPresets: () => listPresets,
-  makeGoboTexture: () => makeGoboTexture,
   mergeConfig: () => mergeConfig,
   mergeWithDeletes: () => mergeWithDeletes,
-  outwardCorner: () => outwardCorner,
   paperConfigSchema: () => paperConfigSchema,
   paperEdges: () => paperEdges,
   paperStatesSchema: () => paperStatesSchema,
   parityCases: () => parityCases,
   parsePreset: () => parsePreset,
-  peel: () => peel,
-  peelOptionsSchema: () => peelOptionsSchema,
   physicsNames: () => physicsNames,
-  physicsSchema: () => physicsSchema,
-  pile: () => pile,
-  quantizeProgress: () => quantizeProgress,
   quantizeSegments: () => quantizeSegments,
-  quantizeTime: () => quantizeTime,
-  rack: () => rack,
-  receiptContentSchema: () => receiptContentSchema,
-  receiptTotals: () => receiptTotals,
   recordStateOverride: () => recordStateOverride,
   registerBehavior: () => registerBehavior,
   registerDeformer: () => registerDeformer,
   registerLayout: () => registerLayout,
   registerPreset: () => registerPreset,
-  resolveConfig: () => resolveConfig,
-  resolveDeformerStack: () => resolveDeformerStack,
-  resolveFieldSlotConfig: () => resolveFieldSlotConfig,
   resolveLighting: () => resolveLighting,
-  resolveMode: () => resolveMode,
-  resolveSegments: () => resolveSegments,
   resolveStateConfig: () => resolveStateConfig,
-  ribbon: () => ribbon,
-  ribbonOptionsSchema: () => ribbonOptionsSchema,
-  ring: () => ring,
-  roll: () => roll,
-  rollOptionsSchema: () => rollOptionsSchema,
   runParityHarness: () => runParityHarness,
-  sceneSchema: () => sceneSchema,
   segmentsForArc: () => segmentsForArc,
   segmentsForSine: () => segmentsForSine,
   serializePreset: () => serializePreset,
-  settle: () => settle,
-  settleOptionsSchema: () => settleOptionsSchema,
-  sheet: () => sheet,
-  sheetBackingSize: () => sheetBackingSize,
   sheetLayoutSchema: () => sheetLayoutSchema,
-  sheetSchema: () => sheetSchema,
-  sheetSlotXY: () => sheetSlotXY,
-  silhouetteRects: () => silhouetteRects,
   spanAlong: () => spanAlong,
-  spill: () => spill,
-  spread: () => spread,
-  stackAutoSegments: () => stackAutoSegments,
-  stackMinSegments: () => stackMinSegments,
-  stackUniformValues: () => stackUniformValues,
   stateDefSchema: () => stateDefSchema,
-  stateEventTransitions: () => stateEventTransitions,
-  stateTransitionSchema: () => stateTransitionSchema,
   stockNames: () => stockNames,
-  stockSchema: () => stockSchema,
   stocks: () => stocks,
-  stripStates: () => stripStates,
   supportsWebGL: () => supportsWebGL,
-  surfaceSchema: () => surfaceSchema,
-  sweep: () => sweep,
-  tornEdgesOnDetach: () => tornEdgesOnDetach,
-  translucencyUniforms: () => translucencyUniforms,
-  translucencyValues: () => translucencyValues,
   uniquePresetName: () => uniquePresetName,
   unregisterPreset: () => unregisterPreset,
-  unroll: () => unroll,
-  unrollOptionsSchema: () => unrollOptionsSchema,
-  useContentAtlas: () => useContentAtlas,
   usePaperStates: () => usePaperStates,
   usePrefersReducedMotion: () => usePrefersReducedMotion,
-  wall: () => wall,
-  wave: () => wave,
-  waveOptionsSchema: () => waveOptionsSchema,
-  withSheetCellFromPaper: () => withSheetCellFromPaper,
-  wrapLines: () => wrapLines,
-  zoneAccepts: () => zoneAccepts
+  wrapLines: () => wrapLines
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1394,7 +1270,7 @@ var paperConfigSchema = import_zod14.z.object({
   physics: physicsSchema.default("none"),
   scene: sceneSchema.default({}),
   onTwos: import_zod14.z.boolean().default(false),
-  /** Interaction state machine — overrides-on-base diffs (spec M6 §1). */
+  /** Interaction state machine — overrides-on-base diffs. */
   states: paperStatesSchema.optional()
 }).superRefine((config, ctx) => {
   if (typeof config.physics === "object" && (config.behavior || config.deformers)) {
@@ -1757,7 +1633,7 @@ var builtins = {
     meta: { name: "Blank sheet", tags: ["starter"] },
     stock: "printer"
   },
-  // The M6 driving use case: one stamp of the 2×5 block. Hover peels the
+  // The driving use case: one stamp of the 2×5 block. Hover peels the
   // outward-facing corner ('auto' resolves per sheet slot), pressing deepens
   // the peel; the perforation tears when it detaches (field auto-wiring).
   "postage-stamp": {
@@ -3623,7 +3499,7 @@ void plPerforation(inout vec4 color) {
     float cell = mod(a + uPerfSpacing * 0.5, uPerfSpacing) - uPerfSpacing * 0.5;
     if (uPerfTorn[e] < 0.5) {
       // Intact: clean semicircular punches on the edge line (alphaTest, not
-      // blending \u2014 shadow correctness per v0.2 \xA74.5).
+      // blending \u2014 shadow correctness).
       if (length(vec2(cell, d)) < uPerfRadius) color.a = 0.0;
     } else {
       // Torn: ripped profile following the hole rhythm \u2014 alternating tabs and
@@ -6975,307 +6851,6 @@ var PaperField = (0, import_react16.forwardRef)(function PaperField2({ children,
   ] }) });
 });
 
-// src/field/parity.ts
-var THREE16 = __toESM(require("three"), 1);
-var GRID = 48;
-var PARITY_EPSILON = 5e-4;
-var parityCases = [
-  {
-    name: "roll: defaults",
-    stack: [{ type: "roll", options: { angle: 90, boundary: 0, radius: 0.12, spiral: 0.015 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "roll: tight receipt roll, rolling down",
-    stack: [{ type: "roll", options: { angle: 270, boundary: -0.4, radius: 0.07, spiral: 0.02 } }],
-    sheet: { width: 1, height: 2.6 },
-    t: 0
-  },
-  {
-    name: "curl: bottom-right peel",
-    stack: [{ type: "curl", options: { corner: "bottom-right", amount: 0.45, radius: 0.2, skew: 0 } }],
-    sheet: { width: 1.5, height: 1 },
-    t: 0
-  },
-  {
-    name: "curl: skewed top-left",
-    stack: [{ type: "curl", options: { corner: "top-left", amount: 0.7, radius: 0.3, skew: 15 } }],
-    sheet: { width: 1, height: 1 },
-    t: 0
-  },
-  {
-    name: "bend: positive arc at an angle",
-    stack: [{ type: "bend", options: { curvature: 1.2, angle: 33 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    /**
-     * The gentle end, which nothing used to cover: the gate only ever tried
-     * |curvature| ≥ 0.6, and `photo-print` — the field starter preset — bends
-     * at 0.35. That band is where the arc's float32 evaluation loses its
-     * cancellation, and where the two paths were 6e-4 apart until `bend` was
-     * rewritten in cancellation-free form. Keep a case down here.
-     */
-    name: "bend: barely-there arc (the band photo-print lives in)",
-    stack: [{ type: "bend", options: { curvature: 0.35, angle: 0 } }],
-    sheet: { width: 1.2, height: 0.9 },
-    t: 0
-  },
-  {
-    name: "bend: the gentlest arc the schema allows",
-    stack: [{ type: "bend", options: { curvature: 0.02, angle: 61 } }],
-    sheet: { width: 2, height: 2.6 },
-    t: 0
-  },
-  {
-    name: "bend: negative arc",
-    stack: [{ type: "bend", options: { curvature: -0.8, angle: 0 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "fold: 90\xB0 hinge",
-    stack: [{ type: "fold", options: { angle: 90, offset: 0, foldAngle: 90, radius: 0.06 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "fold: deep fold, travelling down",
-    stack: [{ type: "fold", options: { angle: 270, offset: 0.2, foldAngle: 165, radius: 0.04 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "wave: free ripple at t=1.234",
-    stack: [
-      {
-        type: "wave",
-        options: { amplitude: 0.05, wavelength: 0.5, speed: 1, angle: 20, pinnedEdge: "none" }
-      }
-    ],
-    sheet: { width: 1, height: 1 },
-    t: 1.234
-  },
-  {
-    name: "wave: pinned top at t=2.5",
-    stack: [
-      {
-        type: "wave",
-        options: { amplitude: 0.04, wavelength: 0.4, speed: 1.5, angle: 80, pinnedEdge: "top" }
-      }
-    ],
-    sheet: { width: 1.2, height: 1.5 },
-    t: 2.5
-  },
-  {
-    name: "drape: banner hung from the top",
-    stack: [
-      {
-        type: "drape",
-        options: { amplitude: 0.17, folds: 5, falloff: 1.6, irregular: 0.45, gather: 0.5, pinnedEdge: "top" }
-      }
-    ],
-    sheet: { width: 1.5, height: 8.5 },
-    t: 0
-  },
-  {
-    name: "drape: deep irregular folds pinned at the bottom",
-    stack: [
-      {
-        type: "drape",
-        options: { amplitude: 0.55, folds: 11, falloff: 0.4, irregular: 1, gather: 1, pinnedEdge: "bottom" }
-      }
-    ],
-    sheet: { width: 2.2, height: 3 },
-    t: 0
-  },
-  {
-    name: "crumple: defaults",
-    stack: [{ type: "crumple", options: { amount: 0.35, scale: 3, pull: 0.4, seed: 0 } }],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    // The adversarial one. `fract` is a sawtooth, so the two halves disagree
-    // hardest where a crease lands exactly on a sample — a fine scale and a
-    // seed whose fold directions are near-axis puts the most creases in
-    // reach of the grid.
-    name: "crumple: fully crushed, fine creases, off-axis seed",
-    stack: [{ type: "crumple", options: { amount: 1, scale: 7.5, pull: 1, seed: 5 } }],
-    sheet: { width: 1.3, height: 0.9 },
-    t: 0
-  },
-  {
-    // Crush then curl, which is the order the crumple BEHAVIOR stacks them:
-    // the creases have to be placed on the flat sheet, not on a bent one.
-    name: "stacked: crumple \u2218 bend (the crumple behavior)",
-    stack: [
-      { type: "crumple", options: { amount: 0.62, scale: 3.3, pull: 0.5, seed: 2 } },
-      { type: "bend", options: { curvature: 0.31, angle: 35 } }
-    ],
-    sheet: { width: 1.1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "stacked: letter-fold pair (fold \u2218 fold)",
-    stack: [
-      { type: "fold", options: { angle: 270, offset: 0.2333, foldAngle: 120, radius: 0.05 } },
-      { type: "fold", options: { angle: 90, offset: 0.2333, foldAngle: 100, radius: 0.08 } }
-    ],
-    sheet: { width: 1, height: 1.4 },
-    t: 0
-  },
-  {
-    name: "stacked: bend \u2218 roll \u2218 wave",
-    stack: [
-      { type: "bend", options: { curvature: 0.6, angle: 0 } },
-      { type: "roll", options: { angle: 90, boundary: 0.1, radius: 0.15, spiral: 0 } },
-      {
-        type: "wave",
-        options: { amplitude: 0.02, wavelength: 0.6, speed: 0.7, angle: 45, pinnedEdge: "none" }
-      }
-    ],
-    sheet: { width: 1, height: 1.4 },
-    t: 0.8
-  }
-];
-function buildParityFragment(stack, sheet2) {
-  const composed = buildDisplacementGLSL(stack, sheet2);
-  return (
-    /* glsl */
-    `#version 300 es
-precision highp float;
-uniform float uPlTime;
-uniform float uPlBias;
-${composed.functionsSrc}
-${composed.displaceSrc}
-out vec4 outColor;
-void main() {
-  vec2 uv = (gl_FragCoord.xy - 0.5) / float(${GRID - 1});
-  vec3 p = vec3((uv - 0.5) * uSheet, 0.0);
-  outColor = vec4(plDisplace(p, uv, uPlTime, uPlBias), 1.0);
-}
-`
-  );
-}
-var VERT = `#version 300 es
-in vec2 aPos;
-void main() { gl_Position = vec4(aPos, 0.0, 1.0); }
-`;
-function compile(gl, type, src) {
-  const shader = gl.createShader(type);
-  gl.shaderSource(shader, src);
-  gl.compileShader(shader);
-  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
-    throw new Error(`[paperlab parity] shader compile failed: ${gl.getShaderInfoLog(shader)}`);
-  }
-  return shader;
-}
-function runCaseOnGPU(gl, c, bias = 1) {
-  const composed = buildDisplacementGLSL(c.stack, c.sheet);
-  const program = gl.createProgram();
-  gl.attachShader(program, compile(gl, gl.VERTEX_SHADER, VERT));
-  gl.attachShader(program, compile(gl, gl.FRAGMENT_SHADER, buildParityFragment(c.stack, c.sheet)));
-  gl.linkProgram(program);
-  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
-    throw new Error(`[paperlab parity] link failed: ${gl.getProgramInfoLog(program)}`);
-  }
-  gl.useProgram(program);
-  for (const [name, value] of Object.entries(composed.uniforms)) {
-    const loc = gl.getUniformLocation(program, name);
-    if (!loc) continue;
-    if (typeof value === "number") gl.uniform1f(loc, value);
-    else if (value.length === 2) gl.uniform2f(loc, value[0], value[1]);
-    else if (value.length === 3) gl.uniform3f(loc, value[0], value[1], value[2]);
-    else gl.uniform4f(loc, value[0], value[1], value[2], value[3]);
-  }
-  const timeLoc = gl.getUniformLocation(program, "uPlTime");
-  if (timeLoc) gl.uniform1f(timeLoc, c.t);
-  const biasLoc = gl.getUniformLocation(program, "uPlBias");
-  if (biasLoc) gl.uniform1f(biasLoc, bias);
-  const quad = gl.createBuffer();
-  gl.bindBuffer(gl.ARRAY_BUFFER, quad);
-  gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);
-  const posLoc = gl.getAttribLocation(program, "aPos");
-  gl.enableVertexAttribArray(posLoc);
-  gl.vertexAttribPointer(posLoc, 2, gl.FLOAT, false, 0, 0);
-  const tex = gl.createTexture();
-  gl.bindTexture(gl.TEXTURE_2D, tex);
-  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA32F, GRID, GRID, 0, gl.RGBA, gl.FLOAT, null);
-  const fbo = gl.createFramebuffer();
-  gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
-  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, tex, 0);
-  gl.viewport(0, 0, GRID, GRID);
-  gl.drawArrays(gl.TRIANGLES, 0, 3);
-  const out = new Float32Array(GRID * GRID * 4);
-  gl.readPixels(0, 0, GRID, GRID, gl.RGBA, gl.FLOAT, out);
-  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
-  return out;
-}
-function runBiasCases(gl) {
-  const results = [];
-  for (const c of parityCases) {
-    const strengths = c.stack.map((i) => getDeformer(i.type).glsl?.strength !== void 0);
-    if (!strengths.every((h) => h === strengths[0])) continue;
-    const scales = strengths[0];
-    const at0 = runCaseOnGPU(gl, c, 0);
-    const reference = scales ? null : runCaseOnGPU(gl, c, 1);
-    let maxError = 0;
-    for (let row = 0; row < GRID; row++) {
-      for (let col = 0; col < GRID; col++) {
-        const i4 = (row * GRID + col) * 4;
-        const ex = reference ? reference[i4] : (col / (GRID - 1) - 0.5) * c.sheet.width;
-        const ey = reference ? reference[i4 + 1] : (row / (GRID - 1) - 0.5) * c.sheet.height;
-        const ez = reference ? reference[i4 + 2] : 0;
-        maxError = Math.max(
-          maxError,
-          Math.abs(at0[i4] - ex),
-          Math.abs(at0[i4 + 1] - ey),
-          Math.abs(at0[i4 + 2] - ez)
-        );
-      }
-    }
-    results.push({
-      name: `bias: ${c.name} \u2192 ${scales ? "flat at 0" : "ignores bias"}`,
-      maxError,
-      pass: maxError < PARITY_EPSILON
-    });
-  }
-  return results;
-}
-function runParityHarness(canvas) {
-  const cnv = canvas ?? document.createElement("canvas");
-  const gl = cnv.getContext("webgl2");
-  if (!gl) throw new Error("[paperlab parity] WebGL2 unavailable");
-  if (!gl.getExtension("EXT_color_buffer_float")) {
-    throw new Error("[paperlab parity] EXT_color_buffer_float unavailable");
-  }
-  const point = new THREE16.Vector3();
-  const parity = parityCases.map((c) => {
-    const gpu = runCaseOnGPU(gl, c);
-    let maxError = 0;
-    for (let row = 0; row < GRID; row++) {
-      for (let col = 0; col < GRID; col++) {
-        const u = col / (GRID - 1);
-        const v = row / (GRID - 1);
-        point.set((u - 0.5) * c.sheet.width, (v - 0.5) * c.sheet.height, 0);
-        displacePoint(point, u, v, c.stack, { t: c.t, sheet: c.sheet });
-        const i4 = (row * GRID + col) * 4;
-        maxError = Math.max(
-          maxError,
-          Math.abs(gpu[i4] - point.x),
-          Math.abs(gpu[i4 + 1] - point.y),
-          Math.abs(gpu[i4 + 2] - point.z)
-        );
-      }
-    }
-    return { name: c.name, maxError, pass: maxError < PARITY_EPSILON };
-  });
-  return [...parity, ...runBiasCases(gl)];
-}
-
 // src/config/diff.ts
 function isPlainObject(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
@@ -7378,40 +6953,218 @@ function describeConfig(config) {
       `torn (deckled) ${config.surface.deckle.edges.join(" and ")} edge${config.surface.deckle.edges.length > 1 ? "s" : ""}`
     );
   }
-  if ((config.surface.aging ?? 0) > 0.3) parts.push("visibly aged and yellowed");
-  return parts.join(", ");
-}
-function componentName(config) {
-  const raw = config.meta.name === "untitled" ? "PaperlabPaper" : config.meta.name;
-  const pascal = raw.replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toUpperCase()).replace(/[^a-zA-Z0-9]/g, "");
-  return /^[A-Za-z]/.test(pascal) ? pascal : `Paper${pascal}`;
+  if ((config.surface.aging ?? 0) > 0.3) parts.push("visibly aged and yellowed");
+  return parts.join(", ");
+}
+function componentName(config) {
+  const raw = config.meta.name === "untitled" ? "PaperlabPaper" : config.meta.name;
+  const pascal = raw.replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toUpperCase()).replace(/[^a-zA-Z0-9]/g, "");
+  return /^[A-Za-z]/.test(pascal) ? pascal : `Paper${pascal}`;
+}
+function buildAgentPayload(config) {
+  const name = componentName(config);
+  const preset = JSON.stringify(diffConfig(config), null, 2);
+  return `Integrate a Paperlab paper component into this project. (paperlab agent-payload v${AGENT_PAYLOAD_VERSION})
+
+1. Install the dependencies:
+
+   npm i paperlab three @react-three/fiber gsap
+
+2. Create the component below as \`components/${name}.tsx\` (or the project's
+   component convention). It is self-contained and owns its own <Canvas>:
+
+\`\`\`tsx
+import { Paper, type PaperConfigInput } from 'paperlab'
+
+const preset = ${preset.replace(/\n/g, "\n")} satisfies PaperConfigInput
+
+export function ${name}() {
+  return <Paper preset={preset} />
+}
+\`\`\`
+
+3. Sizing: the component fills its parent container. Place it where I ask;
+   give the parent an explicit height.
+
+4. Verify: run the dev server. You should see ${describeConfig(config)}.
+   If the canvas is blank, the parent container almost certainly has no height \u2014
+   give it one (this is the classic React Three Fiber integration bug, not a
+   paperlab bug).
+
+Constraints: don't modify the preset values; three >= 0.160 and React 19 are
+required; the component needs no props.`;
+}
+
+// src/config/field-export.ts
+var MOTION_DEFAULTS = { driver: "autoplay", speed: 0.5 };
+var ENTRANCE_DEFAULTS = { type: "rise", stagger: 0.06, duration: 0.9 };
+function camel(name) {
+  const id = name.replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase()).replace(/[^a-zA-Z0-9]/g, "");
+  const safe = /^[A-Za-z]/.test(id) ? id : `preset${id}`;
+  return safe.charAt(0).toLowerCase() + safe.slice(1);
+}
+function distinctFieldPresets(input) {
+  const byKey = /* @__PURE__ */ new Map();
+  const usedNames = /* @__PURE__ */ new Set();
+  for (const paper of input.papers) {
+    const key = JSON.stringify(paper.preset);
+    if (byKey.has(key)) continue;
+    let varName = camel(paper.presetName);
+    while (usedNames.has(varName)) varName += "2";
+    usedNames.add(varName);
+    byKey.set(key, { varName, presetName: paper.presetName, preset: paper.preset });
+  }
+  return [...byKey.values()];
+}
+function nonDefault(value, defaults) {
+  const out = {};
+  for (const [k, v] of Object.entries(value ?? {})) {
+    if (v !== void 0 && v !== defaults[k]) out[k] = v;
+  }
+  return out;
+}
+function diffFieldProps(input) {
+  const out = { layout: input.layout };
+  const layout = getLayout(input.layout);
+  const layoutOptions = nonDefault(input.layoutOptions ?? {}, layout.defaults);
+  if (Object.keys(layoutOptions).length > 0) out.layoutOptions = layoutOptions;
+  const motion = nonDefault(input.motion, MOTION_DEFAULTS);
+  if (Object.keys(motion).length > 0) out.motion = motion;
+  const entrance = nonDefault(input.entrance, ENTRANCE_DEFAULTS);
+  if (Object.keys(entrance).length > 0) out.entrance = entrance;
+  return out;
+}
+var LAYOUT_PHRASES = {
+  ring: "a ring you can see around",
+  fan: "a fanned swatch deck hinged at one corner",
+  spread: "a stack slid sideways, each sheet bowing further than the last",
+  pile: "a heap on a desk, the sheets underneath pressed flat",
+  wall: "a pinned studio wall of sheets, none hanging quite square",
+  spill: "a dropped stack caught mid-air, each sheet bent its own way",
+  sweep: "a specimen chart of one sheet at every stage of its deformation",
+  book: "an open book, its pages splayed from a shared spine",
+  accordion: "one continuous strip folded into a concertina",
+  rack: "prints stood in a row and leaning back against a wall",
+  sheet: "a stamp-block grid on a shared backing sheet"
+};
+function describeFieldConfig(input) {
+  const n = input.papers.length;
+  const stateful = input.papers.some((p) => p.preset.states || p.states);
+  const zones = input.zones ?? [];
+  const parts = [];
+  if (input.layout === "sheet") {
+    const rows = Number(input.layoutOptions?.rows ?? 2);
+    const columns = Number(input.layoutOptions?.columns ?? 5);
+    parts.push(`a ${rows}\xD7${columns} sheet of papers on a shared backing`);
+  } else {
+    const layoutPhrase = LAYOUT_PHRASES[input.layout] ?? `a ${input.layout} layout`;
+    parts.push(`${n} papers arranged in ${layoutPhrase}`);
+  }
+  const driver = input.motion?.driver ?? "autoplay";
+  if (stateful) {
+    parts.push("hovering peels/reacts per paper (interaction states)");
+    if (zones.length > 0) {
+      parts.push(
+        `dragging one past its tear threshold detaches it to carry to the ${zones.map((z26) => z26.id).join(" or ")} zone (release elsewhere flutters it back)`
+      );
+    }
+  } else {
+    if (driver === "autoplay") parts.push("slowly orbiting on their own");
+    if (driver === "drag") parts.push("draggable sideways with the pointer");
+    if (zones.length > 0) parts.push(`${zones.length} drop zone${zones.length > 1 ? "s" : ""}`);
+  }
+  const distinct = distinctFieldPresets(input);
+  if (distinct.length > 1) {
+    parts.push(`mixing ${distinct.length} paper presets (${distinct.map((d) => d.presetName).join(", ")})`);
+  }
+  return parts.join(", ");
+}
+function buildFieldComponentSource(input) {
+  const distinct = distinctFieldPresets(input);
+  const varByKey = new Map(distinct.map((d) => [JSON.stringify(d.preset), d.varName]));
+  const consts = distinct.map(
+    (d) => `const ${d.varName} = ${JSON.stringify(diffConfig(d.preset), null, 2)} satisfies PaperConfigInput`
+  ).join("\n\n");
+  const slots = input.papers.map((paper) => {
+    const varName = varByKey.get(JSON.stringify(paper.preset));
+    const content = paper.content ? `, content: ${JSON.stringify(paper.content)}` : "";
+    const states = paper.states ? `, states: ${JSON.stringify(paper.states)}` : "";
+    return `  { preset: ${varName}${content}${states} },`;
+  }).join("\n");
+  const props = Object.entries(diffFieldProps(input)).map(
+    ([key, value]) => typeof value === "string" ? `      ${key}="${value}"` : `      ${key}={${JSON.stringify(value)}}`
+  ).join("\n");
+  const zones = input.zones ?? [];
+  const zoneImport = zones.length > 0 ? ", DropZone" : "";
+  const zoneChildren = zones.map((zone) => {
+    const accept = zone.accept ? ` accept={${JSON.stringify(zone.accept)}}` : "";
+    const highlight = zone.highlight && zone.highlight !== "glow" ? ` highlight="${zone.highlight}"` : "";
+    return `      <DropZone
+        id="${zone.id}"${accept}
+        bounds={${JSON.stringify(zone.bounds)}}${highlight}
+        onPlace={(paper, zone) => {
+          // First-run smoke test \u2014 you should see this in the console on drop:
+          console.log(paper.presetName, '\u2192', zone.id)
+          // Then replace it: stamp a postmark, advance the flow, persist the placement, \u2026
+        }}
+      />`;
+  }).join("\n");
+  if (zones.length === 0) {
+    return `import { PaperField, type FieldPaperSlot, type PaperConfigInput${zoneImport} } from 'paperlab'
+
+${consts}
+
+const papers: FieldPaperSlot[] = [
+${slots}
+]
+
+export function PaperGallery() {
+  return (
+    <PaperField
+      papers={papers}
+${props}
+    />
+  )
+}`;
+  }
+  return `import { PaperField, type FieldPaperSlot, type PaperConfigInput${zoneImport} } from 'paperlab'
+
+${consts}
+
+const papers: FieldPaperSlot[] = [
+${slots}
+]
+
+export function PaperGallery() {
+  return (
+    <PaperField
+      papers={papers}
+${props}
+    >
+${zoneChildren}
+    </PaperField>
+  )
+}`;
 }
-function buildAgentPayload(config) {
-  const name = componentName(config);
-  const preset = JSON.stringify(diffConfig(config), null, 2);
-  return `Integrate a Paperlab paper component into this project. (paperlab agent-payload v${AGENT_PAYLOAD_VERSION})
+function buildFieldAgentPayload(input) {
+  return `Integrate a Paperlab paper gallery into this project. (paperlab agent-payload v${AGENT_PAYLOAD_VERSION})
 
 1. Install the dependencies:
 
    npm i paperlab three @react-three/fiber gsap
 
-2. Create the component below as \`components/${name}.tsx\` (or the project's
-   component convention). It is self-contained and owns its own <Canvas>:
+2. Create the component below as \`components/PaperGallery.tsx\` (or the
+   project's component convention). It is self-contained \u2014 every preset it
+   uses is inlined, and it owns its own <Canvas>:
 
 \`\`\`tsx
-import { Paper, type PaperConfigInput } from 'paperlab'
-
-const preset = ${preset.replace(/\n/g, "\n")} satisfies PaperConfigInput
-
-export function ${name}() {
-  return <Paper preset={preset} />
-}
+${buildFieldComponentSource(input)}
 \`\`\`
 
 3. Sizing: the component fills its parent container. Place it where I ask;
    give the parent an explicit height.
 
-4. Verify: run the dev server. You should see ${describeConfig(config)}.
+4. Verify: run the dev server. You should see ${describeFieldConfig(input)}.
    If the canvas is blank, the parent container almost certainly has no height \u2014
    give it one (this is the classic React Three Fiber integration bug, not a
    paperlab bug).
@@ -7420,382 +7173,374 @@ Constraints: don't modify the preset values; three >= 0.160 and React 19 are
 required; the component needs no props.`;
 }
 
-// src/config/field-export.ts
-var MOTION_DEFAULTS = { driver: "autoplay", speed: 0.5 };
-var ENTRANCE_DEFAULTS = { type: "rise", stagger: 0.06, duration: 0.9 };
-function camel(name) {
-  const id = name.replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase()).replace(/[^a-zA-Z0-9]/g, "");
-  const safe = /^[A-Za-z]/.test(id) ? id : `preset${id}`;
-  return safe.charAt(0).toLowerCase() + safe.slice(1);
-}
-function distinctFieldPresets(input) {
-  const byKey = /* @__PURE__ */ new Map();
-  const usedNames = /* @__PURE__ */ new Set();
-  for (const paper of input.papers) {
-    const key = JSON.stringify(paper.preset);
-    if (byKey.has(key)) continue;
-    let varName = camel(paper.presetName);
-    while (usedNames.has(varName)) varName += "2";
-    usedNames.add(varName);
-    byKey.set(key, { varName, presetName: paper.presetName, preset: paper.preset });
+// src/field/parity.ts
+var THREE16 = __toESM(require("three"), 1);
+var GRID = 48;
+var PARITY_EPSILON = 5e-4;
+var parityCases = [
+  {
+    name: "roll: defaults",
+    stack: [{ type: "roll", options: { angle: 90, boundary: 0, radius: 0.12, spiral: 0.015 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "roll: tight receipt roll, rolling down",
+    stack: [{ type: "roll", options: { angle: 270, boundary: -0.4, radius: 0.07, spiral: 0.02 } }],
+    sheet: { width: 1, height: 2.6 },
+    t: 0
+  },
+  {
+    name: "curl: bottom-right peel",
+    stack: [{ type: "curl", options: { corner: "bottom-right", amount: 0.45, radius: 0.2, skew: 0 } }],
+    sheet: { width: 1.5, height: 1 },
+    t: 0
+  },
+  {
+    name: "curl: skewed top-left",
+    stack: [{ type: "curl", options: { corner: "top-left", amount: 0.7, radius: 0.3, skew: 15 } }],
+    sheet: { width: 1, height: 1 },
+    t: 0
+  },
+  {
+    name: "bend: positive arc at an angle",
+    stack: [{ type: "bend", options: { curvature: 1.2, angle: 33 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    /**
+     * The gentle end, which nothing used to cover: the gate only ever tried
+     * |curvature| ≥ 0.6, and `photo-print` — the field starter preset — bends
+     * at 0.35. That band is where the arc's float32 evaluation loses its
+     * cancellation, and where the two paths were 6e-4 apart until `bend` was
+     * rewritten in cancellation-free form. Keep a case down here.
+     */
+    name: "bend: barely-there arc (the band photo-print lives in)",
+    stack: [{ type: "bend", options: { curvature: 0.35, angle: 0 } }],
+    sheet: { width: 1.2, height: 0.9 },
+    t: 0
+  },
+  {
+    name: "bend: the gentlest arc the schema allows",
+    stack: [{ type: "bend", options: { curvature: 0.02, angle: 61 } }],
+    sheet: { width: 2, height: 2.6 },
+    t: 0
+  },
+  {
+    name: "bend: negative arc",
+    stack: [{ type: "bend", options: { curvature: -0.8, angle: 0 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "fold: 90\xB0 hinge",
+    stack: [{ type: "fold", options: { angle: 90, offset: 0, foldAngle: 90, radius: 0.06 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "fold: deep fold, travelling down",
+    stack: [{ type: "fold", options: { angle: 270, offset: 0.2, foldAngle: 165, radius: 0.04 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "wave: free ripple at t=1.234",
+    stack: [
+      {
+        type: "wave",
+        options: { amplitude: 0.05, wavelength: 0.5, speed: 1, angle: 20, pinnedEdge: "none" }
+      }
+    ],
+    sheet: { width: 1, height: 1 },
+    t: 1.234
+  },
+  {
+    name: "wave: pinned top at t=2.5",
+    stack: [
+      {
+        type: "wave",
+        options: { amplitude: 0.04, wavelength: 0.4, speed: 1.5, angle: 80, pinnedEdge: "top" }
+      }
+    ],
+    sheet: { width: 1.2, height: 1.5 },
+    t: 2.5
+  },
+  {
+    name: "drape: banner hung from the top",
+    stack: [
+      {
+        type: "drape",
+        options: { amplitude: 0.17, folds: 5, falloff: 1.6, irregular: 0.45, gather: 0.5, pinnedEdge: "top" }
+      }
+    ],
+    sheet: { width: 1.5, height: 8.5 },
+    t: 0
+  },
+  {
+    name: "drape: deep irregular folds pinned at the bottom",
+    stack: [
+      {
+        type: "drape",
+        options: { amplitude: 0.55, folds: 11, falloff: 0.4, irregular: 1, gather: 1, pinnedEdge: "bottom" }
+      }
+    ],
+    sheet: { width: 2.2, height: 3 },
+    t: 0
+  },
+  {
+    name: "crumple: defaults",
+    stack: [{ type: "crumple", options: { amount: 0.35, scale: 3, pull: 0.4, seed: 0 } }],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    // The adversarial one. `fract` is a sawtooth, so the two halves disagree
+    // hardest where a crease lands exactly on a sample — a fine scale and a
+    // seed whose fold directions are near-axis puts the most creases in
+    // reach of the grid.
+    name: "crumple: fully crushed, fine creases, off-axis seed",
+    stack: [{ type: "crumple", options: { amount: 1, scale: 7.5, pull: 1, seed: 5 } }],
+    sheet: { width: 1.3, height: 0.9 },
+    t: 0
+  },
+  {
+    // Crush then curl, which is the order the crumple BEHAVIOR stacks them:
+    // the creases have to be placed on the flat sheet, not on a bent one.
+    name: "stacked: crumple \u2218 bend (the crumple behavior)",
+    stack: [
+      { type: "crumple", options: { amount: 0.62, scale: 3.3, pull: 0.5, seed: 2 } },
+      { type: "bend", options: { curvature: 0.31, angle: 35 } }
+    ],
+    sheet: { width: 1.1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "stacked: letter-fold pair (fold \u2218 fold)",
+    stack: [
+      { type: "fold", options: { angle: 270, offset: 0.2333, foldAngle: 120, radius: 0.05 } },
+      { type: "fold", options: { angle: 90, offset: 0.2333, foldAngle: 100, radius: 0.08 } }
+    ],
+    sheet: { width: 1, height: 1.4 },
+    t: 0
+  },
+  {
+    name: "stacked: bend \u2218 roll \u2218 wave",
+    stack: [
+      { type: "bend", options: { curvature: 0.6, angle: 0 } },
+      { type: "roll", options: { angle: 90, boundary: 0.1, radius: 0.15, spiral: 0 } },
+      {
+        type: "wave",
+        options: { amplitude: 0.02, wavelength: 0.6, speed: 0.7, angle: 45, pinnedEdge: "none" }
+      }
+    ],
+    sheet: { width: 1, height: 1.4 },
+    t: 0.8
   }
-  return [...byKey.values()];
+];
+function buildParityFragment(stack, sheet2) {
+  const composed = buildDisplacementGLSL(stack, sheet2);
+  return (
+    /* glsl */
+    `#version 300 es
+precision highp float;
+uniform float uPlTime;
+uniform float uPlBias;
+${composed.functionsSrc}
+${composed.displaceSrc}
+out vec4 outColor;
+void main() {
+  vec2 uv = (gl_FragCoord.xy - 0.5) / float(${GRID - 1});
+  vec3 p = vec3((uv - 0.5) * uSheet, 0.0);
+  outColor = vec4(plDisplace(p, uv, uPlTime, uPlBias), 1.0);
+}
+`
+  );
 }
-function nonDefault(value, defaults) {
-  const out = {};
-  for (const [k, v] of Object.entries(value ?? {})) {
-    if (v !== void 0 && v !== defaults[k]) out[k] = v;
+var VERT = `#version 300 es
+in vec2 aPos;
+void main() { gl_Position = vec4(aPos, 0.0, 1.0); }
+`;
+function compile(gl, type, src) {
+  const shader = gl.createShader(type);
+  gl.shaderSource(shader, src);
+  gl.compileShader(shader);
+  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+    throw new Error(`[paperlab parity] shader compile failed: ${gl.getShaderInfoLog(shader)}`);
   }
-  return out;
+  return shader;
 }
-function diffFieldProps(input) {
-  const out = { layout: input.layout };
-  const layout = getLayout(input.layout);
-  const layoutOptions = nonDefault(input.layoutOptions ?? {}, layout.defaults);
-  if (Object.keys(layoutOptions).length > 0) out.layoutOptions = layoutOptions;
-  const motion = nonDefault(input.motion, MOTION_DEFAULTS);
-  if (Object.keys(motion).length > 0) out.motion = motion;
-  const entrance = nonDefault(input.entrance, ENTRANCE_DEFAULTS);
-  if (Object.keys(entrance).length > 0) out.entrance = entrance;
+function runCaseOnGPU(gl, c, bias = 1) {
+  const composed = buildDisplacementGLSL(c.stack, c.sheet);
+  const program = gl.createProgram();
+  gl.attachShader(program, compile(gl, gl.VERTEX_SHADER, VERT));
+  gl.attachShader(program, compile(gl, gl.FRAGMENT_SHADER, buildParityFragment(c.stack, c.sheet)));
+  gl.linkProgram(program);
+  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    throw new Error(`[paperlab parity] link failed: ${gl.getProgramInfoLog(program)}`);
+  }
+  gl.useProgram(program);
+  for (const [name, value] of Object.entries(composed.uniforms)) {
+    const loc = gl.getUniformLocation(program, name);
+    if (!loc) continue;
+    if (typeof value === "number") gl.uniform1f(loc, value);
+    else if (value.length === 2) gl.uniform2f(loc, value[0], value[1]);
+    else if (value.length === 3) gl.uniform3f(loc, value[0], value[1], value[2]);
+    else gl.uniform4f(loc, value[0], value[1], value[2], value[3]);
+  }
+  const timeLoc = gl.getUniformLocation(program, "uPlTime");
+  if (timeLoc) gl.uniform1f(timeLoc, c.t);
+  const biasLoc = gl.getUniformLocation(program, "uPlBias");
+  if (biasLoc) gl.uniform1f(biasLoc, bias);
+  const quad = gl.createBuffer();
+  gl.bindBuffer(gl.ARRAY_BUFFER, quad);
+  gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);
+  const posLoc = gl.getAttribLocation(program, "aPos");
+  gl.enableVertexAttribArray(posLoc);
+  gl.vertexAttribPointer(posLoc, 2, gl.FLOAT, false, 0, 0);
+  const tex = gl.createTexture();
+  gl.bindTexture(gl.TEXTURE_2D, tex);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA32F, GRID, GRID, 0, gl.RGBA, gl.FLOAT, null);
+  const fbo = gl.createFramebuffer();
+  gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, tex, 0);
+  gl.viewport(0, 0, GRID, GRID);
+  gl.drawArrays(gl.TRIANGLES, 0, 3);
+  const out = new Float32Array(GRID * GRID * 4);
+  gl.readPixels(0, 0, GRID, GRID, gl.RGBA, gl.FLOAT, out);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
   return out;
 }
-var LAYOUT_PHRASES = {
-  ring: "a ring you can see around",
-  fan: "a fanned swatch deck hinged at one corner",
-  spread: "a stack slid sideways, each sheet bowing further than the last",
-  pile: "a heap on a desk, the sheets underneath pressed flat",
-  wall: "a pinned studio wall of sheets, none hanging quite square",
-  spill: "a dropped stack caught mid-air, each sheet bent its own way",
-  sweep: "a specimen chart of one sheet at every stage of its deformation",
-  book: "an open book, its pages splayed from a shared spine",
-  accordion: "one continuous strip folded into a concertina",
-  rack: "prints stood in a row and leaning back against a wall",
-  sheet: "a stamp-block grid on a shared backing sheet"
-};
-function describeFieldConfig(input) {
-  const n = input.papers.length;
-  const stateful = input.papers.some((p) => p.preset.states || p.states);
-  const zones = input.zones ?? [];
-  const parts = [];
-  if (input.layout === "sheet") {
-    const rows = Number(input.layoutOptions?.rows ?? 2);
-    const columns = Number(input.layoutOptions?.columns ?? 5);
-    parts.push(`a ${rows}\xD7${columns} sheet of papers on a shared backing`);
-  } else {
-    const layoutPhrase = LAYOUT_PHRASES[input.layout] ?? `a ${input.layout} layout`;
-    parts.push(`${n} papers arranged in ${layoutPhrase}`);
-  }
-  const driver = input.motion?.driver ?? "autoplay";
-  if (stateful) {
-    parts.push("hovering peels/reacts per paper (interaction states)");
-    if (zones.length > 0) {
-      parts.push(
-        `dragging one past its tear threshold detaches it to carry to the ${zones.map((z26) => z26.id).join(" or ")} zone (release elsewhere flutters it back)`
-      );
+function runBiasCases(gl) {
+  const results = [];
+  for (const c of parityCases) {
+    const strengths = c.stack.map((i) => getDeformer(i.type).glsl?.strength !== void 0);
+    if (!strengths.every((h) => h === strengths[0])) continue;
+    const scales = strengths[0];
+    const at0 = runCaseOnGPU(gl, c, 0);
+    const reference = scales ? null : runCaseOnGPU(gl, c, 1);
+    let maxError = 0;
+    for (let row = 0; row < GRID; row++) {
+      for (let col = 0; col < GRID; col++) {
+        const i4 = (row * GRID + col) * 4;
+        const ex = reference ? reference[i4] : (col / (GRID - 1) - 0.5) * c.sheet.width;
+        const ey = reference ? reference[i4 + 1] : (row / (GRID - 1) - 0.5) * c.sheet.height;
+        const ez = reference ? reference[i4 + 2] : 0;
+        maxError = Math.max(
+          maxError,
+          Math.abs(at0[i4] - ex),
+          Math.abs(at0[i4 + 1] - ey),
+          Math.abs(at0[i4 + 2] - ez)
+        );
+      }
     }
-  } else {
-    if (driver === "autoplay") parts.push("slowly orbiting on their own");
-    if (driver === "drag") parts.push("draggable sideways with the pointer");
-    if (zones.length > 0) parts.push(`${zones.length} drop zone${zones.length > 1 ? "s" : ""}`);
-  }
-  const distinct = distinctFieldPresets(input);
-  if (distinct.length > 1) {
-    parts.push(`mixing ${distinct.length} paper presets (${distinct.map((d) => d.presetName).join(", ")})`);
+    results.push({
+      name: `bias: ${c.name} \u2192 ${scales ? "flat at 0" : "ignores bias"}`,
+      maxError,
+      pass: maxError < PARITY_EPSILON
+    });
   }
-  return parts.join(", ");
+  return results;
 }
-function buildFieldComponentSource(input) {
-  const distinct = distinctFieldPresets(input);
-  const varByKey = new Map(distinct.map((d) => [JSON.stringify(d.preset), d.varName]));
-  const consts = distinct.map(
-    (d) => `const ${d.varName} = ${JSON.stringify(diffConfig(d.preset), null, 2)} satisfies PaperConfigInput`
-  ).join("\n\n");
-  const slots = input.papers.map((paper) => {
-    const varName = varByKey.get(JSON.stringify(paper.preset));
-    const content = paper.content ? `, content: ${JSON.stringify(paper.content)}` : "";
-    const states = paper.states ? `, states: ${JSON.stringify(paper.states)}` : "";
-    return `  { preset: ${varName}${content}${states} },`;
-  }).join("\n");
-  const props = Object.entries(diffFieldProps(input)).map(
-    ([key, value]) => typeof value === "string" ? `      ${key}="${value}"` : `      ${key}={${JSON.stringify(value)}}`
-  ).join("\n");
-  const zones = input.zones ?? [];
-  const zoneImport = zones.length > 0 ? ", DropZone" : "";
-  const zoneChildren = zones.map((zone) => {
-    const accept = zone.accept ? ` accept={${JSON.stringify(zone.accept)}}` : "";
-    const highlight = zone.highlight && zone.highlight !== "glow" ? ` highlight="${zone.highlight}"` : "";
-    return `      <DropZone
-        id="${zone.id}"${accept}
-        bounds={${JSON.stringify(zone.bounds)}}${highlight}
-        onPlace={(paper, zone) => {
-          // First-run smoke test \u2014 you should see this in the console on drop:
-          console.log(paper.presetName, '\u2192', zone.id)
-          // Then replace it: stamp a postmark, advance the flow, persist the placement, \u2026
-        }}
-      />`;
-  }).join("\n");
-  if (zones.length === 0) {
-    return `import { PaperField, type FieldPaperSlot, type PaperConfigInput${zoneImport} } from 'paperlab'
-
-${consts}
-
-const papers: FieldPaperSlot[] = [
-${slots}
-]
-
-export function PaperGallery() {
-  return (
-    <PaperField
-      papers={papers}
-${props}
-    />
-  )
-}`;
+function runParityHarness(canvas) {
+  const cnv = canvas ?? document.createElement("canvas");
+  const gl = cnv.getContext("webgl2");
+  if (!gl) throw new Error("[paperlab parity] WebGL2 unavailable");
+  if (!gl.getExtension("EXT_color_buffer_float")) {
+    throw new Error("[paperlab parity] EXT_color_buffer_float unavailable");
   }
-  return `import { PaperField, type FieldPaperSlot, type PaperConfigInput${zoneImport} } from 'paperlab'
-
-${consts}
-
-const papers: FieldPaperSlot[] = [
-${slots}
-]
-
-export function PaperGallery() {
-  return (
-    <PaperField
-      papers={papers}
-${props}
-    >
-${zoneChildren}
-    </PaperField>
-  )
-}`;
-}
-function buildFieldAgentPayload(input) {
-  return `Integrate a Paperlab paper gallery into this project. (paperlab agent-payload v${AGENT_PAYLOAD_VERSION})
-
-1. Install the dependencies:
-
-   npm i paperlab three @react-three/fiber gsap
-
-2. Create the component below as \`components/PaperGallery.tsx\` (or the
-   project's component convention). It is self-contained \u2014 every preset it
-   uses is inlined, and it owns its own <Canvas>:
-
-\`\`\`tsx
-${buildFieldComponentSource(input)}
-\`\`\`
-
-3. Sizing: the component fills its parent container. Place it where I ask;
-   give the parent an explicit height.
-
-4. Verify: run the dev server. You should see ${describeFieldConfig(input)}.
-   If the canvas is blank, the parent container almost certainly has no height \u2014
-   give it one (this is the classic React Three Fiber integration bug, not a
-   paperlab bug).
-
-Constraints: don't modify the preset values; three >= 0.160 and React 19 are
-required; the component needs no props.`;
-}
-
-// src/core/modes.ts
-function resolveMode(requested, ctx) {
-  if (requested !== "auto") return requested;
-  if (ctx.interactive || ctx.physics !== "none" || ctx.count <= 10) return "hero";
-  return "field";
+  const point = new THREE16.Vector3();
+  const parity = parityCases.map((c) => {
+    const gpu = runCaseOnGPU(gl, c);
+    let maxError = 0;
+    for (let row = 0; row < GRID; row++) {
+      for (let col = 0; col < GRID; col++) {
+        const u = col / (GRID - 1);
+        const v = row / (GRID - 1);
+        point.set((u - 0.5) * c.sheet.width, (v - 0.5) * c.sheet.height, 0);
+        displacePoint(point, u, v, c.stack, { t: c.t, sheet: c.sheet });
+        const i4 = (row * GRID + col) * 4;
+        maxError = Math.max(
+          maxError,
+          Math.abs(gpu[i4] - point.x),
+          Math.abs(gpu[i4 + 1] - point.y),
+          Math.abs(gpu[i4 + 2] - point.z)
+        );
+      }
+    }
+    return { name: c.name, maxError, pass: maxError < PARITY_EPSILON };
+  });
+  return [...parity, ...runBiasCases(gl)];
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AGENT_PAYLOAD_VERSION,
   AUTO_CEILING,
-  ClothSim,
   DropZone,
-  DropZoneRegistry,
   FLAT_SEGMENTS,
   LightRig,
-  ON_TWOS_FPS,
   PARITY_EPSILON,
   Paper,
-  PaperFallback,
   PaperField,
   PaperFieldMesh,
   PaperLighting,
-  PaperMaterial,
   PaperMesh,
-  PaperMirror,
-  PaperStateMachine,
   SAG_TOL,
-  SHEET_LIFT,
-  TRANSMISSION_GAIN,
-  accordion,
-  applyDeformerStack,
-  atlasGrid,
-  backContentSchema,
-  barcodeBars,
   behaviorConfigSchema,
-  bend,
-  bendOptionsSchema,
-  book,
   buildAgentPayload,
-  buildDisplacementGLSL,
   buildFieldAgentPayload,
   buildFieldComponentSource,
-  buildFieldFragmentShader,
-  buildFieldVertexShader,
   buildJsxSnippet,
-  cardContentSchema,
-  carry,
-  carryDrive,
-  carryOptionsSchema,
   clothConfigSchema,
-  colonnade,
-  composeSurface,
-  contentSchema,
-  contentText,
   coreStateNames,
-  cornerNames,
-  createSheetGeometry,
-  crumple,
-  crumpleBehavior,
-  crumpleBehaviorOptionsSchema,
-  crumpleOptionsSchema,
-  curl,
-  curlOptionsSchema,
-  dampTo,
-  deformerInstanceSchema,
   describeConfig,
   describeFieldConfig,
   diffConfig,
   diffFieldProps,
-  displacePoint,
-  distinctFieldPresets,
-  drape,
-  drapeOptionsSchema,
-  drawBacking,
-  fall,
-  fallOptionsSchema,
-  fan,
-  fieldBounds,
-  fieldKeyboardStep,
-  filmNames,
-  fitCamera,
-  flattenNumeric,
-  flight,
-  flightOptionsSchema,
-  flightPose,
-  flip,
-  flipOptionsSchema,
-  fly,
-  flyOptionsSchema,
-  fold,
-  foldOptionsSchema,
   getBehavior,
   getDeformer,
-  getIdlePreset,
   getLayout,
-  getLightingPreset,
   getPreset,
   getStock,
-  groupFieldPapers,
-  gust,
-  hang,
-  hangOptionsSchema,
   idleNames,
-  idlePresets,
   isBuiltinPreset,
-  letterFold,
-  letterFoldOptionsSchema,
   lightAngles,
-  lightPosition,
   lightSchema,
-  lightenHex,
   lightingNames,
-  lightingPresets,
   listBehaviors,
   listDeformers,
   listLayouts,
   listPresets,
-  makeGoboTexture,
   mergeConfig,
   mergeWithDeletes,
-  outwardCorner,
   paperConfigSchema,
   paperEdges,
   paperStatesSchema,
   parityCases,
   parsePreset,
-  peel,
-  peelOptionsSchema,
   physicsNames,
-  physicsSchema,
-  pile,
-  quantizeProgress,
   quantizeSegments,
-  quantizeTime,
-  rack,
-  receiptContentSchema,
-  receiptTotals,
   recordStateOverride,
   registerBehavior,
   registerDeformer,
   registerLayout,
   registerPreset,
-  resolveConfig,
-  resolveDeformerStack,
-  resolveFieldSlotConfig,
   resolveLighting,
-  resolveMode,
-  resolveSegments,
   resolveStateConfig,
-  ribbon,
-  ribbonOptionsSchema,
-  ring,
-  roll,
-  rollOptionsSchema,
   runParityHarness,
-  sceneSchema,
   segmentsForArc,
   segmentsForSine,
   serializePreset,
-  settle,
-  settleOptionsSchema,
-  sheet,
-  sheetBackingSize,
   sheetLayoutSchema,
-  sheetSchema,
-  sheetSlotXY,
-  silhouetteRects,
   spanAlong,
-  spill,
-  spread,
-  stackAutoSegments,
-  stackMinSegments,
-  stackUniformValues,
   stateDefSchema,
-  stateEventTransitions,
-  stateTransitionSchema,
   stockNames,
-  stockSchema,
   stocks,
-  stripStates,
   supportsWebGL,
-  surfaceSchema,
-  sweep,
-  tornEdgesOnDetach,
-  translucencyUniforms,
-  translucencyValues,
   uniquePresetName,
   unregisterPreset,
-  unroll,
-  unrollOptionsSchema,
-  useContentAtlas,
   usePaperStates,
   usePrefersReducedMotion,
-  wall,
-  wave,
-  waveOptionsSchema,
-  withSheetCellFromPaper,
-  wrapLines,
-  zoneAccepts
+  wrapLines
 });
 //# sourceMappingURL=index.cjs.map