@vibecook/ice 0.10.0 → 0.11.0

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

@@ -48,8 +48,8 @@ export interface GroundOptions {
     /**
      * Magnet pole sources (design-010 §3.3) — live app-authored objects, so they
      * live HERE, not in the plain-data GridConfig. Nothing wired ⇒ the magnet
-     * field (if enabled) is widget-only; with magnet off they cost one gated
-     * no-op subscription each.
+     * field is widget-only. The classic implementation accepts this same
+     * GroundOptions contract and ignores the sources.
      */
     readonly poles?: PoleSource | readonly PoleSource[];
     /** Extra app passes, rendered after the built-ins (renderOrder ≥ 3 is yours). */

package/dist/types/packages/ground/src/passes/grid-contract.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared contract for build-time-selectable grid implementations.
+ *
+ * Both classic and magnet factories accept the same config and dependency
+ * shape. `grid.ts` wires exactly one factory into the production entry graph,
+ * so selecting an implementation is an import change, never a runtime mode.
+ */
+import { type GridConfig } from "../../../core/src/index";
+import type { GroundPass } from "../pass";
+import type { PoleSource } from "../poles";
+import type { ReadSpatial } from "./magnet-collect";
+export interface GridPass extends GroundPass {
+    /** Live re-tune (the react `grid` prop seam) — partial merge over current values. */
+    configure(cfg: Partial<GridConfig>): void;
+}
+/**
+ * Superset of implementation dependencies. Classic deliberately ignores
+ * these; magnet consumes them. Keeping one signature makes the wired factory
+ * interchangeable without changing its parent.
+ */
+export interface GridPassDeps {
+    readonly poles?: readonly PoleSource[];
+    readonly readSpatial?: ReadSpatial;
+}
+export type GridPassFactory = (initial?: Partial<GridConfig>, deps?: GridPassDeps) => GridPass;
+/** Shallow grid merge + one-level merge of the optional magnet tuning block. */
+export declare function mergeGridConfig(base: GridConfig, next: Partial<GridConfig>): GridConfig;
+export declare function resolveInitialGridConfig(initial: Partial<GridConfig>): GridConfig;

package/dist/types/packages/ground/src/passes/grid-magnet-pass.d.ts

@@ -0,0 +1,2 @@
+import { type GridPassFactory } from "./grid-contract";
+export declare const createGridPass: GridPassFactory;

package/dist/types/packages/ground/src/passes/grid-magnet.d.ts

@@ -11,8 +11,8 @@
  *    D4); the mouse uniform / `mouseOn` branch are deleted.
  *  - fade ladder, level weight and dotAlpha are CPU-baked into ONE per-level
  *    alpha (they are per-level constants per frame — magnet-collect owns them).
- *  - dot rest radius comes from `GridConfig.dotRadius[0]` (config continuity
- *    with the classic grid), not the WGSL's hardcoded `halfLen·0.16`.
+ *  - dot rest radius comes from `GridConfig.dotRadius[0]` (shared config
+ *    continuity), not the WGSL's hardcoded `halfLen·0.16`.
  *  - coincidence skip (§5.4): sites shared with a visible coarser level drop
  *    out (integer spacing ratios), replicating the classic max-composite look.
  *  - NDC is computed from CSS-px directly (the WGSL path) — glyph sizes are

package/dist/types/packages/ground/src/passes/grid.d.ts

@@ -1,28 +1,10 @@
 /**
- * The grid pass — a MODE FACADE since design-010: the classic analytic dot
- * grid (grid-classic.ts, the default — byte-identical to pre-magnet builds)
- * and the magnet field lattice (grid-magnet.ts + magnet-collect.ts) behind
- * ONE `GridPass` contract. `configure` deep-merges the `magnet` key one level
- * (§3.1) so partial re-tunes never clobber the block.
+ * Production grid wiring — BUILD-TIME selection, not a runtime mode facade.
  *
- * Wake graph (all magnet wakes gated on `enabled` — the idle-scene zero-frame
- * guarantee is untouched when off): camera/resize are layer-owned;
- * `SpatialVersion` re-collects widget sources (gated on `widgets` too);
- * injected pole sources wake through their own subscriptions (D5 — the pass
- * observes no pointer/cursor/presence vocabulary). The magnet renderer is
- * built LAZILY on first enable: classic-only apps pay zero magnet cost.
+ * Keep this module intentionally tiny and import exactly one implementation.
+ * The unselected renderer then has no path from the package entry graph and
+ * is absent from the production bundle. To restore the classic grid, change
+ * only the implementation path below to `./grid-classic-pass`.
  */
-import { type GridConfig } from "../../../core/src/index";
-import type { GroundPass } from "../pass";
-import type { PoleSource } from "../poles";
-import { type ReadSpatial } from "./magnet-collect";
-export interface GridPass extends GroundPass {
-    /** Live re-tune (the react `grid` prop seam) — partial merge over current values. */
-    configure(cfg: Partial<GridConfig>): void;
-}
-/** Injected magnet inputs (design-010 §3.2) — absent pieces disable their sources. */
-export interface GridPassDeps {
-    readonly poles?: readonly PoleSource[];
-    readonly readSpatial?: ReadSpatial;
-}
-export declare function createGridPass(initial?: Partial<GridConfig>, deps?: GridPassDeps): GridPass;
+export { createGridPass } from "./grid-magnet-pass";
+export type { GridPass, GridPassDeps, GridPassFactory } from "./grid-contract";

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

@@ -24,8 +24,8 @@ export interface PoleSource {
     /** Called during collect — read-only world access (GroundPass.collect rules). */
     read(world: World): readonly Pole[];
     /**
-     * Called during arm — `wake` marks the grid pass dirty (the pass gates it on
-     * `magnet.enabled`, so idle scenes stay at zero frames). Returns unsubscriber.
+     * Called during arm — `wake` marks the wired magnet grid dirty. The classic
+     * implementation never subscribes. Returns an unsubscriber.
      */
     subscribe(world: World, wake: () => void): () => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/ice",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "ICE — infinite canvas engine. Figma-grade infinite-canvas UX as a framework: defineWidget turns React/R3F components into canvas citizens — selectable, movable, resizable, wired into node graphs, CRDT-synced, undoable per gesture.",
   "license": "MIT",
   "author": "James Yong <me@jamesyong42.com>",

package/dist/types/packages/ground/src/passes/grid-classic.d.ts

@@ -1,30 +0,0 @@
-/**
- * The CLASSIC dot-grid renderer — extracted VERBATIM from grid.ts when the
- * magnet mode arrived (design-010 D1: classic stays the default and the
- * pixel-exact baseline; the pass facade in grid.ts owns mode switching).
- *
- * TSL port of the raw-WebGL grid (itself verbatim from v1 GridRenderer.ts;
- * the fragment math below is that shader re-expressed as a node graph, level
- * loop unrolled in JS). Screen-space: a fullscreen triangle whose vertex
- * stage passes clip coords through; the fragment reconstructs world position
- * from `screenCoordinate` (top-left device px on BOTH backends — three
- * normalizes, so the old manual y-flip is gone) + camera uniforms.
- *
- * One deliberate re-expression: the GLSL if/else fade ladder became the
- * closed form `clamp(min(rise, fall), 0, 1)` — identical piecewise output
- * (rise 0→1 across fadeIn, plateau 1, fall 1→0 across fadeOut) with no
- * branching. Everything else (fract-distance dots, 0.5-device-px AA,
- * max-composited levels) matches term for term.
- */
-import type { GridConfig } from "../../../core/src/index";
-import { Mesh } from "three/webgpu";
-import type { GroundFrame } from "../pass";
-export interface ClassicGridRenderer {
-    readonly mesh: Mesh;
-    /** Layer-written each collect. */
-    setCamera(frame: GroundFrame): void;
-    /** Config-written (the configure seam). */
-    configure(cfg: GridConfig): void;
-    dispose(): void;
-}
-export declare function createClassicGrid(cfg: GridConfig): ClassicGridRenderer;