@vibecook/ice 0.16.0 → 0.17.0

package/dist/desk.js

@@ -101,7 +101,7 @@ import {
   withKindActs,
   withoutKind,
   writable
-} from "./chunk-REJTEK3V.js";
+} from "./chunk-M2HUDENL.js";
 import "./chunk-ENIFIUEP.js";
 import {
   BLOB_STORE,
@@ -255,9 +255,9 @@ import {
   visibleRect,
   worldBounds,
   writeChanged
-} from "./chunk-BH5AFWJX.js";
+} from "./chunk-VZEZ7CYW.js";
 import "./chunk-RTBW5AIZ.js";
-import "./chunk-Y7K6CHSF.js";
+import "./chunk-LAZIY3J7.js";
 import "./chunk-RE4GDHFJ.js";
 export {
   AMBIENT_DEFAULTS,

package/dist/devtools.js

@@ -14,7 +14,7 @@ import {
   WheelPan,
   WheelZoom,
   Wire
-} from "./chunk-Y7K6CHSF.js";
+} from "./chunk-LAZIY3J7.js";
 import "./chunk-RE4GDHFJ.js";
 
 // ../devtools/src/attach.ts

package/dist/dom.js

@@ -13,8 +13,8 @@ import {
   keyboardClaimOf,
   startRafLoop,
   wheelCede
-} from "./chunk-ZTY2VRIS.js";
-import "./chunk-Y7K6CHSF.js";
+} from "./chunk-6W2FPXR7.js";
+import "./chunk-LAZIY3J7.js";
 import "./chunk-RE4GDHFJ.js";
 export {
   CLAIM_OWNS_ESCAPE,

package/dist/index.js

@@ -14,6 +14,7 @@ import {
   Camera,
   CameraInertia,
   CameraLimits,
+  CameraZoomStep,
   CancelRequest,
   CanvasIntentScope,
   CanvasSession,
@@ -95,6 +96,7 @@ import {
   LongPressDrag,
   MarqueeBox,
   Movable,
+  MovesSelection,
   MultiTap,
   NAV_TRANSITION_DEFAULTS,
   NO_ENTITY,
@@ -157,6 +159,7 @@ import {
   STRATUM_BANDS,
   Selectable,
   Selected,
+  SelectionMovable,
   SelectionSummary,
   SelectionVersion,
   Sequence,
@@ -394,7 +397,7 @@ import {
   widgetTypeFor,
   widgets,
   writeRuntimeResource
-} from "./chunk-Y7K6CHSF.js";
+} from "./chunk-LAZIY3J7.js";
 import "./chunk-RE4GDHFJ.js";
 export {
   Accepts,
@@ -412,6 +415,7 @@ export {
   Camera,
   CameraInertia,
   CameraLimits,
+  CameraZoomStep,
   CancelRequest,
   CanvasIntentScope,
   CanvasSession,
@@ -493,6 +497,7 @@ export {
   LongPressDrag,
   MarqueeBox,
   Movable,
+  MovesSelection,
   MultiTap,
   NAV_TRANSITION_DEFAULTS,
   NO_ENTITY,
@@ -555,6 +560,7 @@ export {
   STRATUM_BANDS,
   Selectable,
   Selected,
+  SelectionMovable,
   SelectionSummary,
   SelectionVersion,
   Sequence,

package/dist/react.js

@@ -2,7 +2,7 @@ import {
   createDeskHost,
   isEditableTarget,
   keyboardClaimOf
-} from "./chunk-ZTY2VRIS.js";
+} from "./chunk-6W2FPXR7.js";
 import {
   ActiveTool,
   Container,
@@ -28,7 +28,7 @@ import {
   tools,
   trayOpen,
   widgets
-} from "./chunk-Y7K6CHSF.js";
+} from "./chunk-LAZIY3J7.js";
 import "./chunk-RE4GDHFJ.js";
 
 // ../react/src/hooks.ts

package/dist/types/packages/core/src/canvas/engine-catalog.d.ts

@@ -16,6 +16,10 @@ export interface EngineCatalogCompileOpts {
     readonly widgets?: readonly {
         readonly type: string;
     }[];
+    /** Schema compatibility only: no placement, runtime, tray, or canvas presentation. */
+    readonly retiredWidgets?: readonly {
+        readonly type: string;
+    }[];
     readonly tools?: readonly Tool[];
     readonly canvasTypes?: readonly CanvasType[];
     readonly rootCanvas?: CanvasType;
@@ -30,6 +34,8 @@ export interface EngineCatalog {
     readonly rootCanvas: CanvasType;
     readonly presentationFallback: CanvasType;
     widget(id: string): WidgetType | undefined;
+    /** A dormant schema retained for saved documents, outside the active widget catalog. */
+    retiredWidget(id: string): WidgetType | undefined;
     widgetTypes(): readonly WidgetType[];
     tool(id: string): Tool | undefined;
     toolTypes(): readonly Tool[];

package/dist/types/packages/core/src/catalog/desk.d.ts

@@ -206,11 +206,11 @@ export declare const Tray: import("@vibecook/strata-ecs").Component<import("@vib
     readonly stretch: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
     readonly wheelAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
     /**
-     * K9 (S11, D-K9-c.3): the last wheel `dy` the drawer scrolled by, and how many deltas in a row have SHRUNK while pushing the band
-     * further — a fading tail (the OS's momentum decays; a push does not, steadily). At `TRAY_INPUT.fadeDeltas` the band lets go and
-     * the rest of that tail is spent — swallowed, scroll and band untouched — until a reversal, a growing delta or quiet.
+     * @deprecated Legacy wheel-tail bookkeeping, retained for component compatibility. Wheel scrolling now stays within its
+     * bounds and consumes the OS's momentum directly; trayInput no longer reads or writes these fields.
      */
     readonly wheelDy: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    /** @deprecated See wheelDy. */
     readonly fade: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
     /** K5a: the type of the specimen under the mouse while the drawer is out ("" — none): the hover that lifts it (flux). */
     readonly hover: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
@@ -247,11 +247,11 @@ export declare const Tray: import("@vibecook/strata-ecs").Component<import("@vib
     readonly stretch: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
     readonly wheelAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
     /**
-     * K9 (S11, D-K9-c.3): the last wheel `dy` the drawer scrolled by, and how many deltas in a row have SHRUNK while pushing the band
-     * further — a fading tail (the OS's momentum decays; a push does not, steadily). At `TRAY_INPUT.fadeDeltas` the band lets go and
-     * the rest of that tail is spent — swallowed, scroll and band untouched — until a reversal, a growing delta or quiet.
+     * @deprecated Legacy wheel-tail bookkeeping, retained for component compatibility. Wheel scrolling now stays within its
+     * bounds and consumes the OS's momentum directly; trayInput no longer reads or writes these fields.
      */
     readonly wheelDy: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    /** @deprecated See wheelDy. */
     readonly fade: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
     /** K5a: the type of the specimen under the mouse while the drawer is out ("" — none): the hover that lifts it (flux). */
     readonly hover: import("@vibecook/strata-ecs").FieldSpec<"string", true>;

package/dist/types/packages/core/src/catalog/gesture.d.ts

@@ -140,6 +140,8 @@ export declare const GestureSuspended: import("@vibecook/strata-ecs").Tag;
 export declare const HadCapture: import("@vibecook/strata-ecs").Tag;
 /** Runs alongside claims without competing (wheel pan/zoom) — keeps zoom-while-dragging legal. */
 export declare const Simultaneous: import("@vibecook/strata-ecs").Tag;
+/** A group-move intent, latched at pointer-down so custom carries can yield before lifting. */
+export declare const MovesSelection: import("@vibecook/strata-ecs").Tag;
 export declare const RoutedMove: import("@vibecook/strata-ecs").Tag;
 export declare const RoutedResize: import("@vibecook/strata-ecs").Tag;
 export declare const RoutedConnect: import("@vibecook/strata-ecs").Tag;

package/dist/types/packages/core/src/catalog/selection-presence.d.ts

@@ -2,6 +2,8 @@
 export declare const Selected: import("@vibecook/strata-ecs").Tag;
 export declare const Selectable: import("@vibecook/strata-ecs").Tag;
 export declare const Movable: import("@vibecook/strata-ecs").Tag;
+/** Core moves this widget with a selection; its own driver handles a solo drag. */
+export declare const SelectionMovable: import("@vibecook/strata-ecs").Tag;
 export declare const Resizable: import("@vibecook/strata-ecs").Tag;
 export declare const SnapSource: import("@vibecook/strata-ecs").Tag;
 export declare const SnapTarget: import("@vibecook/strata-ecs").Tag;

package/dist/types/packages/core/src/catalog/settings-resources.d.ts

@@ -24,9 +24,11 @@ export declare const GestureSettings: import("@vibecook/strata-ecs").Resource<im
     readonly multiTapSlopPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
     readonly wheelZoomSensitivity: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
     readonly wheelZoomMaxStep: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
-    /** A plain wheel's job (design-015 §9, D-D11): "pan" (default, today) or the desk's "zoom" about the pointer. */
+    /** Ordinary scrolling pans by default; apps can opt into cursor-anchored wheel zoom. */
     readonly wheel: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"pan" | "zoom">, true>;
-    /** "zoom" mode's law: `zoom · exp(−Δ · wheelZoomRate)` for a plain wheel and a pinch. f64: the prototype's 0.0016, exactly. */
+    /** Pinch/modifier zoom response, independent of the plain wheel's job. */
+    readonly wheelZoomCurve: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"clamped" | "exponential">, true>;
+    /** Continuous zoom: `zoom · exp(−Δ · wheelZoomRate)`. f64 keeps the configured rate exact. */
     readonly wheelZoomRate: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
 }>, {
     readonly tapMaxMs: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
@@ -42,9 +44,11 @@ export declare const GestureSettings: import("@vibecook/strata-ecs").Resource<im
     readonly multiTapSlopPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
     readonly wheelZoomSensitivity: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
     readonly wheelZoomMaxStep: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
-    /** A plain wheel's job (design-015 §9, D-D11): "pan" (default, today) or the desk's "zoom" about the pointer. */
+    /** Ordinary scrolling pans by default; apps can opt into cursor-anchored wheel zoom. */
     readonly wheel: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"pan" | "zoom">, true>;
-    /** "zoom" mode's law: `zoom · exp(−Δ · wheelZoomRate)` for a plain wheel and a pinch. f64: the prototype's 0.0016, exactly. */
+    /** Pinch/modifier zoom response, independent of the plain wheel's job. */
+    readonly wheelZoomCurve: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"clamped" | "exponential">, true>;
+    /** Continuous zoom: `zoom · exp(−Δ · wheelZoomRate)`. f64 keeps the configured rate exact. */
     readonly wheelZoomRate: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
 }>;
 /** Pick radii + retarget dead-band live mirror (design-003 §3 L1 targeting). */

package/dist/types/packages/core/src/facade/create-canvas-engine.d.ts

@@ -47,12 +47,16 @@ import type { ByteChannel } from "../doc/channels";
 import { type Autosave, type AutosaveOpts, type AutosaveStorageWrite } from "../doc/autosave";
 import { type PresenceOpts, type PresenceSession } from "../presence/presence-kit";
 import type { EngineGpu } from "../surface/gpu-device";
-import { GESTURE_DEFAULTS, POINTER_DEFAULTS, type WheelMode } from "../settings/defaults";
+import { GESTURE_DEFAULTS, POINTER_DEFAULTS, type WheelMode, type WheelZoomCurve } from "../settings/defaults";
 export interface CanvasEngineOpts {
     /** Registered widget types (definition happens at defineWidget; this list is validated). */
     readonly widgets?: readonly {
         readonly type: string;
     }[];
+    /** Preserve these schemas in old documents without loading their runtime or showing their objects. */
+    readonly retiredWidgets?: readonly {
+        readonly type: string;
+    }[];
     /** Registered tools (definition happens at defineTool; validated). */
     readonly tools?: readonly Tool[];
     /** Explicit Canvas SDK definitions. Supplying any typed field enables typed mode. */
@@ -106,12 +110,14 @@ export interface CanvasEngineOpts {
             readonly max?: number;
         };
         /**
-         * GestureSettings seeds. `wheel` is a plain wheel's job (design-015 §9,
-         * D-D11): "pan" (default) or the desk's "zoom" about the pointer by
-         * `zoom · exp(−Δ · wheelZoomRate)` (default rate 0.0016, the prototype's).
+         * GestureSettings seeds. `wheel` selects ordinary scroll pan (default)
+         * or zoom. `wheelZoomCurve` selects pinch/modifier zoom independently.
+         * Omitted curves preserve the initial wheel mode's legacy response.
          */
-        readonly gestures?: Partial<Record<Exclude<keyof typeof GESTURE_DEFAULTS, "wheel">, number>> & {
+        readonly gestures?: Partial<Record<Exclude<keyof typeof GESTURE_DEFAULTS, "wheel" | "wheelZoomCurve">, number>> & {
             readonly wheel?: WheelMode;
+            /** Pinch and modifier-wheel response; changing `wheel` never changes this curve. */
+            readonly wheelZoomCurve?: WheelZoomCurve;
         };
         readonly pointers?: Partial<Record<keyof typeof POINTER_DEFAULTS, number>>;
         readonly snap?: {

package/dist/types/packages/core/src/index.d.ts

@@ -78,7 +78,7 @@ export type { FramePickSlot, FramePickSource, PointPick } from "./systems/l1-pic
 export { setWidgetProps } from "./widget/set-props";
 export { createWidgetRuntime, installWidgetRuntime, type WidgetRuntime } from "./widget/mount-store";
 export * from "./settings/defaults";
-export { CameraInertia, WheelZoomStep, createCameraSystems, type CameraSystems } from "./systems/camera-sim";
+export { CameraInertia, CameraZoomStep, WheelZoomStep, createCameraSystems, type CameraSystems } from "./systems/camera-sim";
 export { restoreAutosave, startAutosave, type Autosave, type AutosaveOpts, type AutosaveState, type AutosaveStatus, type AutosaveStorageRead, type AutosaveStorageWrite, type CancelScheduled, type RestoreResult, } from "./doc/autosave";
 export { attachBroadcastRelay, type BroadcastRelay, type BroadcastRelayOpts, type RelayChannel, } from "./doc/broadcast-relay";
 export { createBreakpointSystem, createSelectionChromeSystem } from "./systems/chrome";

package/dist/types/packages/core/src/ops/selection-drag.d.ts

@@ -0,0 +1,8 @@
+import { type Entity, type SystemCtx } from "@vibecook/strata-ecs";
+import type { Tool } from "../tools/define-tool";
+/**
+ * Decide ONCE at pointer-down, never during hover or rendering. Empty space in
+ * a multi-selection can carry the group; real objects, controls and handles
+ * keep their pick priority. Shift on the canvas starts an additive marquee.
+ */
+export declare function selectionDragAt(ctx: SystemCtx, target: Entity | undefined, sx: number, sy: number, tool: Tool, shift: boolean): boolean;

package/dist/types/packages/core/src/settings/defaults.d.ts

@@ -18,10 +18,12 @@ export declare const GESTURE_DEFAULTS: {
     readonly wheelZoomSensitivity: 0.01;
     readonly wheelZoomMaxStep: 10;
     readonly wheel: "pan";
+    readonly wheelZoomCurve: "clamped";
     readonly wheelZoomRate: 0.0016;
 };
 /** What a plain wheel does to the camera (`GestureSettings.wheel`, design-015 §9). */
 export type WheelMode = "pan" | "zoom";
+export type WheelZoomCurve = "clamped" | "exponential";
 /** Pick radii + retarget dead-band (design-003 §3 L1 targeting). */
 export declare const POINTER_DEFAULTS: {
     readonly radiusMousePx: 0;

package/dist/types/packages/core/src/systems/camera-sim.d.ts

@@ -40,6 +40,19 @@ export declare const WheelZoomStep: import("@vibecook/strata-ecs").Resource<impo
     readonly anchorY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
     readonly tick: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
 }>;
+/** Latest user-driven camera zoom, including touch pinch. Presentation hosts
+ * can acknowledge scale crossings without mistaking a fit, flight, document
+ * restore or zoom-through rebase for a gesture. Values describe cameraControl's
+ * zoom before later navigation systems run. Idle frames never write it. */
+export declare const CameraZoomStep: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly from: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly to: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly tick: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+}>, {
+    readonly from: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly to: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly tick: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+}>;
 export interface CameraSystems {
     cameraControl: TickSystem;
     cameraInertia: TickSystem;

package/dist/types/packages/core/src/systems/tray.d.ts

@@ -13,9 +13,9 @@
  *  - OPEN, the desk is INERT: every local pointer gets the one-tick `HandledByWidget` and `WheelHandled`, each tick, as the hand's
  *    do — so "the wheel never moves the camera" is not a rule the camera keeps; it is a fact the camera never hears about. Over the
  *    drawer the wheel scrolls it (`dy`; the OS's momentum arrives as deltas and is applied as it comes — no inertia of ours; ⌘/ctrl
- *    and a pinch are swallowed) and a press-drag scrolls it; past an end the rest is the band's `stretch` (a reversal unwinds it
- *    first), which lets go once the scroll input has been quiet `letGoMs` — or (K9) once a FADING tail has pushed it `fadeDeltas`
- *    shrinking deltas, the rest of that tail spent (the OS's momentum no longer holds it for its second). A click on the dimmed desk — pressed and released there,
+ *    and a pinch are swallowed). Wheel scrolling stays within the content: excess deltas are discarded, so a reversal responds
+ *    immediately and an uneven momentum tail cannot restart an edge bounce. Only an intentional press-drag can pull the band's
+ *    `stretch`; its spring returns on release. A click on the dimmed desk — pressed and released there,
  *    unmoved — closes it. Shut, the wheel stays the tray's until it has been quiet `letGoMs` (K9): a flick's momentum still
  *    arriving as the drawer shuts never zooms the desk.
  *  - K5b, TAKING ONE (design-017 §9): a press on a SPECIMEN is `TrayPress specimen` — its type, the grab point across the object as the
@@ -74,10 +74,11 @@ export interface TrayPoseSource {
 export interface TrayPoseSlot {
     current: TrayPoseSource | null;
 }
-/** The tray's input numbers (design-017 §7): a click's slop, how long the scroll input must be quiet before the band lets go — and (K9, D-K9-c.3) how many shrinking deltas in a row a fading tail pushes the band before it lets go. (design-018 §5: the lip's drag, handle and pad retired with it.) */
+/** The tray's input numbers: a click's slop and the quiet period for a drag's band and the wheel latch after closing. */
 export declare const TRAY_INPUT: {
     readonly slopPx: 4;
     readonly letGoMs: 120;
+    /** @deprecated Wheel input no longer estimates momentum from shrinking deltas. Kept for source compatibility. */
     readonly fadeDeltas: 3;
 };
 /** The tray's specimens (K5a): the tray entity's children tagged `Specimen`, in sibling order. */

package/dist/types/packages/core/src/tools/define-tool.d.ts

@@ -27,8 +27,8 @@ export interface ToolRoute {
     /** Drag starting on empty canvas (after device overrides: touch/space/middle → pan). */
     readonly canvasDrag?: CanvasDragRoute;
     /**
-     * The same drag with SHIFT held (design-015 §9, D-D11 — D2a-core): the desk's
-     * select tool pans the bare mat and draws its marquee on shift —
+     * The same drag with SHIFT held. For example, a custom tool can pan normally
+     * and draw its marquee on shift —
      * `{ canvasDrag: "pan", canvasDragShift: "marquee" }`. Omitted: the tool's
      * own `canvasDrag`, so shift changes nothing (every tool before this field).
      * The device conventions (touch / space / middle → pan) still sit above it.

package/dist/types/packages/core/src/widget/define-widget.d.ts

@@ -87,7 +87,8 @@ export interface WidgetBehaviorEntry {
 }
 export interface WidgetInteraction {
     readonly selectable?: boolean;
-    readonly movable?: boolean;
+    /** "selection": core moves it with a group; a custom driver owns its solo drag. */
+    readonly movable?: boolean | "selection";
     /**
      * May this widget be dropped INTO an accepting container (design-015 §9, D-D6 — D2b)?
      * `"into"` (default): yes — for a GPU object, when its centre is let go over the container's

package/dist/types/packages/desk/src/ground.d.ts

@@ -325,7 +325,8 @@ export declare class SlotPool {
  * it, then the objects stratum by stratum: within a stratum in paint order, one
  * `drawRange` per RUN of one kind (each kind counting its own records), the run
  * cut after an object with a live inside — the inside over its face (restoring
- * this slot's scissor), then that object's marks over the inside. Returns
+ * this slot's scissor), then that object's marks over the inside. The edge
+ * rulers finish the slot above its objects. Returns
  * whether it drew.
  */
 export declare function drawSlot(pass: GPURenderPassEncoder, size: {
@@ -381,7 +382,7 @@ export interface TraySlotSource {
 export declare function prepareFrame(encoder: GPUCommandEncoder, root: SlotSet, pool: SlotPool, inputs: GroundFrameInputs, grid?: GridConfig, target?: RenderTarget, traySlots?: TraySlotSource): PreparedFrame;
 /**
  * THE TRAY, drawn (design-017 §5, §8; K5a) — shared by `Ground.render` and the Node oracle: the drawer UNDER its specimens (the dim, its
- * shadows, the board to its edge, the accessories), each specimen by its own kind through the drawer's face (inside the edge — the rim
+ * shadows, the board to its edge), each specimen by its own kind through the drawer's face (inside the edge — the rim
  * laid over them all retired, design-018 §2), their name tags (the marks' pills), then the VEIL over them all at the top (design-018
  * rev 5: the plain board, whole in the header and fading out over its ramp — what hangs there fades into the board, never see-through
  * over a hole); then what the tray carries, whole. Shut (p 0) the drawer draws nothing (its pass laid no quad) and only a carried copy
@@ -502,7 +503,7 @@ export declare class Ground {
     /** When `idleTray` next lets a tray layer go (K7a — a time the host registers; ∞ — nothing to let go). */
     trayIdleAt(): number;
 }
-/** The specimens' name tags this frame (K5a): each label centred under its specimen — below a shelf's plank — in screen px. */
+/** The specimens' name tags this frame (K5a): each label centred under its specimen, in screen px. */
 export declare function tagsOf(tray: TrayFrameInputs | undefined): {
     readonly label: string;
     readonly x: number;

package/dist/types/packages/desk/src/host/layer.d.ts

@@ -256,19 +256,17 @@ export interface DeskLayerBoot {
  * The pegboard tray's door (design-017; K3) — the app's `a` and a rig's hand: the facts through core's tray ops (the one writer beside
  * the tray's input), the flux's pins and its state.
  */
-/** A specimen as the last frame drew it (K5a — the tray door's witness): its type, kind, tag and accessory, its rect and pegs on screen (CSS px), the scale its kind drew it at. */
+/** A specimen as the last frame drew it (K5a — the tray door's witness): its type, kind, tag and rect on screen (CSS px), the scale its kind drew it at. */
 export interface TraySpecimenSeen {
     readonly type: string;
     readonly kind: string;
     readonly label: string;
-    readonly accessory: string;
     readonly screen: {
         readonly x0: number;
         readonly y0: number;
         readonly x1: number;
         readonly y1: number;
     };
-    readonly pegs: readonly (readonly [number, number])[];
     readonly zoom: number;
     /** K5b: its object as drawn on screen (the fit inside the hang). */
     readonly object: {

package/dist/types/packages/desk/src/mat/layout.d.ts

@@ -16,9 +16,9 @@ import { type MatLight } from "./night";
  * attachment's texels, `CSS px · dpr` (a fragment's `@builtin(position).xy`); colours sRGB-encoded 0..1 unless marked LINEAR.
  * The fields, x · y · z · w:
  *
- * - `cam` — the camera: the world point at the attachment's top-left (x, y — UNWRAPPED world units: the projector is fixed in
- *   world), the zoom (z — CSS px per world unit, `mat_zoom`), the attachment's device px per CSS px (w — `mat_dpr`; below 1
- *   for a capture's thumbnail or the held desk copy, petition I29);
+ * - `cam` — the camera: the world point at the attachment's top-left (x, y — UNWRAPPED world units), the zoom (z — CSS px
+ *   per world unit, `mat_zoom`), the attachment's device px per CSS px (w — `mat_dpr`; below 1 for a capture's thumbnail or
+ *   the held desk copy, petition I29);
  * - `view` — the attachment's size (x, y — CSS px), the grain's clock (z — seconds), the OBJECTS' presentation opacity (w —
  *   0..1, the slot's × their own presence: what every kind multiplies its output by);
  * - `phase` — the camera wrapped to the lattice's coarse period (x, y — world units: the lattice's phase, which the lines are
@@ -39,7 +39,9 @@ import { type MatLight } from "./night";
  *   0..1) and its dark floor (w — 0..1): `sample_gobo`, `shade_mat`;
  * - `grade` — the saturation bump in shade (x); y, z, w unused;
  * - `noise` — the blue noise's offset (x, y — uv, re-rolled while the wind blows), one tile texel in uv (z — 1 / 128); w unused;
- * - `wind` — the gobo's clock (x — seconds) and the plate's wind strength (y); z, w unused;
+ * - `wind` — the gobo's clock (x — seconds), the plate's wind strength (y), and projection space (z — 0 = world,
+ *   1 = viewport); w unused. Viewport shadows use CSS px at the original origin and scale, independent of the camera
+ *   and slot light handovers. The mode uses an existing spare lane so the shared view block does not grow;
  * - `night` — the NIGHT (mat/night.ts): its amount (x — 0..1, 0 = the day's chain exactly), the Moon's illuminance (y — lux),
  *   the exposure (z — scene → display), the snow (w — display units, peak to peak): `night_mat`, `mat_colour`;
  * - `moon` — the Moon's colour as the adapted eye takes it (xyz — LINEAR sRGB, Y = 1) and the sky's share in the shadow (w —
@@ -63,7 +65,8 @@ import { type MatLight } from "./night";
  *   spacing (z); w unused;
  * - `box` — the slot's box on the attachment (x, y, w, h — CSS px): what is culled; the mat is fullscreen under the scissor;
  * - `light` — the camera the lamp's gobo is sampled under (`SlotLight`: x, y — world units at its top-left, z — its zoom) and
- *   the cross-fade toward `light2` (w — 0..1): `lit_desk`, `lit_gobo`;
+ *   the cross-fade toward `light2` (w — 0..1): `lit_desk`, `lit_gobo`. Viewport mode fixes this camera at (0, 0, 1)
+ *   with no handover, so the mat uses the same shader path as a world-space lamp;
  * - `light2` — the second light a flight hands the slot to (x, y, z as `light`'s); w unused;
  * - `presence` — the SLOT's presentation opacity (x — 0..1: what the mat itself is drawn at; `view.w` is its objects'); y, z,
  *   w unused.
@@ -112,6 +115,8 @@ export interface MatConfig {
     readonly ground: RGB;
     readonly ink: RGB;
     readonly gobo: {
+        /** World by default. Viewport keeps the projection at its original origin and 100% scale in CSS px while the canvas moves. */
+        readonly space?: "world" | "viewport";
         readonly opacity: number;
         readonly blurTexels: number;
         readonly shadeMix: number;
@@ -162,6 +167,41 @@ export declare const PLATE_SIZE = 512;
 export declare function matUniformValues(view: View & {
     readonly dpr: number;
 }, fadeIn: FadeIn, cfg: MatConfig, f: MatFrame, plateStrength: number, present?: Presentation, light?: MatLight, glyphs?: GlyphAtlasMeta, lit?: SlotLight): {
+    presence: number[];
+    light: readonly [0, 0, 1, 0];
+    light2: readonly [0, 0, 1, 0];
+    ruler: number[];
+    rulerText: number[];
+    rulerAlpha: number[];
+    rulerOrigin: number[];
+    rulerGlyph: number[];
+    rulerAtlas: number[];
+    rulerSites: number[];
+    rulerFormat: number[];
+    box: number[];
+    portals: number[];
+    clips: number[];
+    night: number[];
+    moon: number[];
+    rod: number[];
+    eigengrau: number[];
+    cam: number[];
+    view: number[];
+    phase: number[];
+    rungs: number[];
+    lod: number[];
+    line: number[];
+    grain: number[];
+    ground: number[];
+    ink: number[];
+    plane: number[];
+    goboMatrix: Mat4;
+    goboParams: number[];
+    gobo: number[];
+    grade: number[];
+    noise: number[];
+    wind: number[];
+} | {
     presence: number[];
     light: number[];
     light2: number[];

package/dist/types/packages/desk/src/mat/mat-pass.d.ts

@@ -4,6 +4,7 @@ import { type GlyphAtlasMeta, type MatConfig, type MatFrame, type PlateName, typ
 import { type MatLight } from "./night";
 import type { MatPass } from "../kit/view";
 import type { MatShaders } from "./shaders";
+import { type MatRegion } from "./ruler-regions";
 export declare class CuttingMat implements MatPass {
     readonly name = "mat/mat";
     private readonly uniforms;
@@ -22,6 +23,7 @@ export declare class CuttingMat implements MatPass {
     /** The view block as last uploaded (K7a: uploaded only when its bytes moved; a layered kind compares a layer's view by it). */
     private readonly sentView;
     private viewSent;
+    private ruler;
     private readonly device;
     private readonly shared;
     private constructor();
@@ -78,6 +80,11 @@ export declare class CuttingMat implements MatPass {
         readonly dpr: number;
     }, fadeIn: FadeIn, cfg: MatConfig, frame: MatFrame, present?: Presentation, light?: MatLight, lit?: SlotLight): boolean;
     draw(pass: GPURenderPassEncoder): void;
+    /** The mat beneath objects; enabled ruler strips are reserved for the foreground. */
+    drawSurface(pass: GPURenderPassEncoder, clip: MatRegion): void;
+    /** The edge bands and frame above every object in this slot, within its portal. */
+    drawRulers(pass: GPURenderPassEncoder, clip: MatRegion): void;
+    private drawRegions;
     /** This slot's buffers; the shared plates go with the last slot standing. */
     dispose(): void;
 }

package/dist/types/packages/desk/src/mat/ruler-regions.d.ts

@@ -0,0 +1,17 @@
+import type { View } from "../lattice/lod";
+import type { RulerConfig } from "./layout";
+export type MatRegion = readonly [number, number, number, number];
+export interface RulerRegions {
+    readonly width: number;
+    readonly height: number;
+    readonly dpr: number;
+    readonly margin: number;
+    readonly band: number;
+    readonly line: number;
+    readonly surface: readonly MatRegion[];
+    readonly edges: readonly MatRegion[];
+}
+/** Geometry changes only on resize, DPR or ruler styling; camera motion reuses it. */
+export declare function rulerRegions(view: View & {
+    readonly dpr: number;
+}, ruler: RulerConfig, previous: RulerRegions | null): RulerRegions;