paperlab 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -1,19 +1,19 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import * as THREE from 'three';
-import { P as PaperConfig, S as StateName, a as PaperConfigInput, b as SheetConfig, c as StockName, C as ContentConfigInput, B as BehaviorConfigInput, D as DeformerInstanceConfigInput, d as SurfaceConfigInput, e as SceneConfigInput, f as PhysicsConfigInput, g as PaperEdge, F as FieldPaperSlot, L as LightingName, h as FilmName, i as ContentConfig, j as SurfaceConfig, k as PaperStatesInput } from './slots-D0Nc_5dq.cjs';
-export { l as BackContentConfig, m as BehaviorConfig, n as ClothConfig, o as CoreStateName, p as DeformerInstanceConfig, q as FieldGroupData, r as PaperStates, s as PhysicsConfig, t as SceneConfig, u as StateDef, v as StateTransitionConfig, w as backContentSchema, x as behaviorConfigSchema, y as cardContentSchema, z as clothConfigSchema, A as contentSchema, E as coreStateNames, G as deformerInstanceSchema, H as filmNames, I as groupFieldPapers, J as lightingNames, K as paperConfigSchema, M as paperEdges, N as paperStatesSchema, O as physicsNames, Q as physicsSchema, R as receiptContentSchema, T as resolveFieldSlotConfig, U as sceneSchema, V as sheetSchema, W as stateDefSchema, X as stateTransitionSchema, Y as stockNames, Z as stockSchema, _ as surfaceSchema } from './slots-D0Nc_5dq.cjs';
+import { P as PaperConfig, S as StateName, a as PaperConfigInput, b as SheetConfig, c as StockName, C as ContentConfigInput, B as BehaviorConfigInput, D as DeformerInstanceConfigInput, d as SurfaceConfigInput, e as SceneConfigInput, f as PhysicsConfigInput, g as PaperEdge, F as FieldPaperSlot, L as LightingName, h as FilmName, i as ContentConfig, j as SurfaceConfig, k as PaperStatesInput } from './slots-DUMR64HB.cjs';
+export { l as BackContentConfig, m as BehaviorConfig, n as ClothConfig, o as CoreStateName, p as DeformerInstanceConfig, q as FieldGroupData, r as PaperStates, s as PhysicsConfig, t as SceneConfig, u as StateDef, v as StateTransitionConfig, w as backContentSchema, x as behaviorConfigSchema, y as cardContentSchema, z as clothConfigSchema, A as contentSchema, E as coreStateNames, G as deformerInstanceSchema, H as filmNames, I as groupFieldPapers, J as lightingNames, K as paperConfigSchema, M as paperEdges, N as paperStatesSchema, O as physicsNames, Q as physicsSchema, R as receiptContentSchema, T as resolveFieldSlotConfig, U as sceneSchema, V as sheetSchema, W as stateDefSchema, X as stateTransitionSchema, Y as stockNames, Z as stockSchema, _ as surfaceSchema } from './slots-DUMR64HB.cjs';
 import { z } from 'zod';
 
 /**
  * The interaction-state engine. A state is a set of parameter overrides on
- * the base preset — never a separate preset (spec M6 §1.1). The machine
+ * the base preset — never a separate preset. The machine
  * resolves each state to a full config (base + overrides), keeps ONE live
  * tween target of flattened numeric leaves, and always tweens FROM CURRENT
  * VALUES: a pointer that enters/leaves rapidly retargets the same tween
  * values instead of stacking or snapping.
  *
- * Delivery split (spec v0.2 §4: GSAP owns values, useFrame owns uploads):
+ * Delivery split (GSAP owns values, useFrame owns uploads):
  * GSAP animates the STABLE `flat` object in place; per-tick values are polled
  * off `liveConfig` by the consumer's frame loop, never pushed through React.
  * `onChange` fires only on STRUCTURAL boundaries (a transition's start and
@@ -301,7 +301,7 @@ interface DeformerContext {
  * A deformer is a pure vertex-mapping function. The JS implementation is the
  * CPU path (hero mode) and must be allocation-free in the loop: it mutates
  * `out` in place. The mirrored GLSL implementation (GPU path, field mode)
- * lands in M4 — golden-vector parity tests will enforce identical results.
+ * lands with field mode — golden-vector parity tests will enforce identical results.
  */
 interface Deformer<O = Record<string, unknown>> {
     id: string;
@@ -310,7 +310,7 @@ interface Deformer<O = Record<string, unknown>> {
     optionsSchema: z.ZodType<O, z.ZodTypeDef, unknown>;
     /** Mutate `out` (sheet-local space; flat sheet is the XY plane facing +Z). */
     displace(out: THREE.Vector3, uv: THREE.Vector2, o: O, ctx: DeformerContext): void;
-    /** GPU path — arrives with field mode (M4). */
+    /** GPU path — arrives with field mode. */
     glsl?: {
         chunk: string;
         uniforms(o: O): Record<string, unknown>;
@@ -461,8 +461,8 @@ declare function sheetBackingSize(o: SheetLayoutOptions): {
 };
 type Corner = CurlOptions['corner'];
 /**
- * The corner facing away from the sheet's center — what a thumb would find
- * (spec M6 §1.3). A tie (an odd grid's exact-center row/column, where the
+ * The corner facing away from the sheet's center — what a thumb would find.
+ * A tie (an odd grid's exact-center row/column, where the
  * cell straddles the midline) breaks outward-and-down: strict `<` on both
  * axes sends the center right and down, so a dead-center cell peels
  * bottom-right — the standalone peel default.
@@ -494,7 +494,7 @@ interface KeyboardStepResult {
     handled: boolean;
 }
 /**
- * The M6 §6 keyboard flow as a pure step (so it's testable without a DOM):
+ * The keyboard flow as a pure step (so it's testable without a DOM):
  * given the current carry state, the focused paper `slot`, and the pressed
  * `key`, it drives the field `controller` (pick → move between zones → place /
  * cancel) and returns the next carry state. All side effects go through
@@ -1245,7 +1245,7 @@ type CrumpleOptions = z.infer<typeof crumpleOptionsSchema>;
 declare const crumple: Deformer<CrumpleOptions>;
 
 /**
- * The shared fake-aerodynamics core (spec M6 §4): velocity-linked lift +
+ * The shared fake-aerodynamics core: velocity-linked lift +
  * curated noise, per v0.2's "reads more real than a true sim" doctrine.
  * Pure math, no three.js, no allocation in the per-frame paths — `carry`
  * and `flight` both source their motion here.
@@ -1609,7 +1609,7 @@ declare const carryOptionsSchema: z.ZodObject<{
 }>;
 type CarryOptions = z.infer<typeof carryOptionsSchema>;
 /**
- * A held paper, alive from motion (spec M6 §4.1, the field/cheap path):
+ * A held paper, alive from motion (the field/cheap path):
  * droop away from the grab point + drag-velocity flutter. The hero path —
  * cloth with a single pin following the cursor — is the existing
  * `physics: 'cloth'` grab; this behavior is what fields and exports run.
@@ -1644,7 +1644,7 @@ declare const flightOptionsSchema: z.ZodObject<{
 }>;
 type FlightOptions = z.infer<typeof flightOptionsSchema>;
 /**
- * Untethered paper carried across the scene on the wind (spec M6 §4.2) —
+ * Untethered paper carried across the scene on the wind —
  * the falling-leaf tumble core + directional travel + lift. Transform +
  * deformer based, so it's instancing-safe: a `scatter` layout + `flight`
  * idle = papers blowing through a hero section.

package/dist/index.d.ts

@@ -1,19 +1,19 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import * as THREE from 'three';
-import { P as PaperConfig, S as StateName, a as PaperConfigInput, b as SheetConfig, c as StockName, C as ContentConfigInput, B as BehaviorConfigInput, D as DeformerInstanceConfigInput, d as SurfaceConfigInput, e as SceneConfigInput, f as PhysicsConfigInput, g as PaperEdge, F as FieldPaperSlot, L as LightingName, h as FilmName, i as ContentConfig, j as SurfaceConfig, k as PaperStatesInput } from './slots-D0Nc_5dq.js';
-export { l as BackContentConfig, m as BehaviorConfig, n as ClothConfig, o as CoreStateName, p as DeformerInstanceConfig, q as FieldGroupData, r as PaperStates, s as PhysicsConfig, t as SceneConfig, u as StateDef, v as StateTransitionConfig, w as backContentSchema, x as behaviorConfigSchema, y as cardContentSchema, z as clothConfigSchema, A as contentSchema, E as coreStateNames, G as deformerInstanceSchema, H as filmNames, I as groupFieldPapers, J as lightingNames, K as paperConfigSchema, M as paperEdges, N as paperStatesSchema, O as physicsNames, Q as physicsSchema, R as receiptContentSchema, T as resolveFieldSlotConfig, U as sceneSchema, V as sheetSchema, W as stateDefSchema, X as stateTransitionSchema, Y as stockNames, Z as stockSchema, _ as surfaceSchema } from './slots-D0Nc_5dq.js';
+import { P as PaperConfig, S as StateName, a as PaperConfigInput, b as SheetConfig, c as StockName, C as ContentConfigInput, B as BehaviorConfigInput, D as DeformerInstanceConfigInput, d as SurfaceConfigInput, e as SceneConfigInput, f as PhysicsConfigInput, g as PaperEdge, F as FieldPaperSlot, L as LightingName, h as FilmName, i as ContentConfig, j as SurfaceConfig, k as PaperStatesInput } from './slots-DUMR64HB.js';
+export { l as BackContentConfig, m as BehaviorConfig, n as ClothConfig, o as CoreStateName, p as DeformerInstanceConfig, q as FieldGroupData, r as PaperStates, s as PhysicsConfig, t as SceneConfig, u as StateDef, v as StateTransitionConfig, w as backContentSchema, x as behaviorConfigSchema, y as cardContentSchema, z as clothConfigSchema, A as contentSchema, E as coreStateNames, G as deformerInstanceSchema, H as filmNames, I as groupFieldPapers, J as lightingNames, K as paperConfigSchema, M as paperEdges, N as paperStatesSchema, O as physicsNames, Q as physicsSchema, R as receiptContentSchema, T as resolveFieldSlotConfig, U as sceneSchema, V as sheetSchema, W as stateDefSchema, X as stateTransitionSchema, Y as stockNames, Z as stockSchema, _ as surfaceSchema } from './slots-DUMR64HB.js';
 import { z } from 'zod';
 
 /**
  * The interaction-state engine. A state is a set of parameter overrides on
- * the base preset — never a separate preset (spec M6 §1.1). The machine
+ * the base preset — never a separate preset. The machine
  * resolves each state to a full config (base + overrides), keeps ONE live
  * tween target of flattened numeric leaves, and always tweens FROM CURRENT
  * VALUES: a pointer that enters/leaves rapidly retargets the same tween
  * values instead of stacking or snapping.
  *
- * Delivery split (spec v0.2 §4: GSAP owns values, useFrame owns uploads):
+ * Delivery split (GSAP owns values, useFrame owns uploads):
  * GSAP animates the STABLE `flat` object in place; per-tick values are polled
  * off `liveConfig` by the consumer's frame loop, never pushed through React.
  * `onChange` fires only on STRUCTURAL boundaries (a transition's start and
@@ -301,7 +301,7 @@ interface DeformerContext {
  * A deformer is a pure vertex-mapping function. The JS implementation is the
  * CPU path (hero mode) and must be allocation-free in the loop: it mutates
  * `out` in place. The mirrored GLSL implementation (GPU path, field mode)
- * lands in M4 — golden-vector parity tests will enforce identical results.
+ * lands with field mode — golden-vector parity tests will enforce identical results.
  */
 interface Deformer<O = Record<string, unknown>> {
     id: string;
@@ -310,7 +310,7 @@ interface Deformer<O = Record<string, unknown>> {
     optionsSchema: z.ZodType<O, z.ZodTypeDef, unknown>;
     /** Mutate `out` (sheet-local space; flat sheet is the XY plane facing +Z). */
     displace(out: THREE.Vector3, uv: THREE.Vector2, o: O, ctx: DeformerContext): void;
-    /** GPU path — arrives with field mode (M4). */
+    /** GPU path — arrives with field mode. */
     glsl?: {
         chunk: string;
         uniforms(o: O): Record<string, unknown>;
@@ -461,8 +461,8 @@ declare function sheetBackingSize(o: SheetLayoutOptions): {
 };
 type Corner = CurlOptions['corner'];
 /**
- * The corner facing away from the sheet's center — what a thumb would find
- * (spec M6 §1.3). A tie (an odd grid's exact-center row/column, where the
+ * The corner facing away from the sheet's center — what a thumb would find.
+ * A tie (an odd grid's exact-center row/column, where the
  * cell straddles the midline) breaks outward-and-down: strict `<` on both
  * axes sends the center right and down, so a dead-center cell peels
  * bottom-right — the standalone peel default.
@@ -494,7 +494,7 @@ interface KeyboardStepResult {
     handled: boolean;
 }
 /**
- * The M6 §6 keyboard flow as a pure step (so it's testable without a DOM):
+ * The keyboard flow as a pure step (so it's testable without a DOM):
  * given the current carry state, the focused paper `slot`, and the pressed
  * `key`, it drives the field `controller` (pick → move between zones → place /
  * cancel) and returns the next carry state. All side effects go through
@@ -1245,7 +1245,7 @@ type CrumpleOptions = z.infer<typeof crumpleOptionsSchema>;
 declare const crumple: Deformer<CrumpleOptions>;
 
 /**
- * The shared fake-aerodynamics core (spec M6 §4): velocity-linked lift +
+ * The shared fake-aerodynamics core: velocity-linked lift +
  * curated noise, per v0.2's "reads more real than a true sim" doctrine.
  * Pure math, no three.js, no allocation in the per-frame paths — `carry`
  * and `flight` both source their motion here.
@@ -1609,7 +1609,7 @@ declare const carryOptionsSchema: z.ZodObject<{
 }>;
 type CarryOptions = z.infer<typeof carryOptionsSchema>;
 /**
- * A held paper, alive from motion (spec M6 §4.1, the field/cheap path):
+ * A held paper, alive from motion (the field/cheap path):
  * droop away from the grab point + drag-velocity flutter. The hero path —
  * cloth with a single pin following the cursor — is the existing
  * `physics: 'cloth'` grab; this behavior is what fields and exports run.
@@ -1644,7 +1644,7 @@ declare const flightOptionsSchema: z.ZodObject<{
 }>;
 type FlightOptions = z.infer<typeof flightOptionsSchema>;
 /**
- * Untethered paper carried across the scene on the wind (spec M6 §4.2) —
+ * Untethered paper carried across the scene on the wind —
  * the falling-leaf tumble core + directional travel + lift. Transform +
  * deformer based, so it's instancing-safe: a `scatter` layout + `flight`
  * idle = papers blowing through a hero section.

package/dist/index.js

@@ -181,7 +181,7 @@ import {
   withSheetCellFromPaper,
   wrapLines,
   zoneAccepts
-} from "./chunk-3IMUEESH.js";
+} from "./chunk-XE4E43MD.js";
 
 // src/Paper.tsx
 import { Canvas } from "@react-three/fiber";

package/dist/{slots-D0Nc_5dq.d.cts → slots-DUMR64HB.d.cts}

@@ -4958,7 +4958,7 @@ declare const paperConfigSchema: z.ZodEffects<z.ZodObject<{
         lighting?: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox" | undefined;
     }>>;
     onTwos: z.ZodDefault<z.ZodBoolean>;
-    /** Interaction state machine — overrides-on-base diffs (spec M6 §1). */
+    /** Interaction state machine — overrides-on-base diffs. */
     states: z.ZodOptional<z.ZodObject<{
         initial: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
         states: z.ZodEffects<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -6639,7 +6639,7 @@ interface FieldPaperSlot {
      * (`contentSchema.parse`) so consumers downstream still get a full config.
      */
     content?: ContentConfigInput;
-    /** Per-instance state overrides, merged over the preset's states (spec M6 §1.1). */
+    /** Per-instance state overrides, merged over the preset's states. */
     states?: PaperStatesInput;
 }
 interface FieldGroupData {

package/dist/{slots-D0Nc_5dq.d.ts → slots-DUMR64HB.d.ts}

@@ -4958,7 +4958,7 @@ declare const paperConfigSchema: z.ZodEffects<z.ZodObject<{
         lighting?: "studio" | "window" | "leaves" | "goldenhour" | "noir" | "nave" | "raking" | "lightbox" | undefined;
     }>>;
     onTwos: z.ZodDefault<z.ZodBoolean>;
-    /** Interaction state machine — overrides-on-base diffs (spec M6 §1). */
+    /** Interaction state machine — overrides-on-base diffs. */
     states: z.ZodOptional<z.ZodObject<{
         initial: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
         states: z.ZodEffects<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -6639,7 +6639,7 @@ interface FieldPaperSlot {
      * (`contentSchema.parse`) so consumers downstream still get a full config.
      */
     content?: ContentConfigInput;
-    /** Per-instance state overrides, merged over the preset's states (spec M6 §1.1). */
+    /** Per-instance state overrides, merged over the preset's states. */
     states?: PaperStatesInput;
 }
 interface FieldGroupData {

package/dist/stage.cjs

@@ -1515,7 +1515,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)) {
@@ -1784,7 +1784,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": {
@@ -3537,7 +3537,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