@griddle/core 0.1.0

package/dist/pan.js

@@ -0,0 +1,174 @@
+// PanController — headless camera for loop mode. No DOM, no timers.
+//
+// The controller owns an unbounded 2D camera offset. Three inputs move it:
+// - dragStart/dragMove/dragEnd: pointer-driven panning. While dragging, the
+//   target follows the pointer 1:1 (inverted — content follows the finger)
+//   and a velocity estimate is kept; on release the target keeps coasting
+//   under exponential friction (inertia/fling).
+// - scrollBy: external deltas (wheel/trackpad). Applied directly to both
+//   camera and target — the browser already smooths these.
+// - tick(now): advances easing + inertia. Adapters call this from their rAF
+//   loop and apply the camera to the plane's CSS transform.
+//
+// All rates are per-second (exponential, frame-rate independent).
+const SETTLE_DISTANCE = 0.1; // px
+const SETTLE_VELOCITY = 5; // px/s
+const VELOCITY_WINDOW_MS = 100;
+export class PanController {
+    constructor(physics = {}) {
+        this.x = 0;
+        this.y = 0;
+        this.targetX = 0;
+        this.targetY = 0;
+        this.vx = 0;
+        this.vy = 0;
+        this.dragging = false;
+        this.lastPointer = null;
+        this.samples = [];
+        this.lastTick = null;
+        this.friction = physics.friction ?? 4;
+        this.ease = physics.ease ?? 12;
+        this.maxVelocity = physics.maxVelocity ?? 6000;
+    }
+    setPhysics(physics) {
+        if (physics.friction !== undefined)
+            this.friction = physics.friction;
+        if (physics.ease !== undefined)
+            this.ease = physics.ease;
+        if (physics.maxVelocity !== undefined)
+            this.maxVelocity = physics.maxVelocity;
+    }
+    state() {
+        const settled = Math.abs(this.targetX - this.x) < SETTLE_DISTANCE &&
+            Math.abs(this.targetY - this.y) < SETTLE_DISTANCE &&
+            Math.abs(this.vx) < SETTLE_VELOCITY &&
+            Math.abs(this.vy) < SETTLE_VELOCITY;
+        return {
+            x: this.x,
+            y: this.y,
+            vx: this.vx,
+            vy: this.vy,
+            isMoving: this.dragging || !settled,
+            isDragging: this.dragging,
+        };
+    }
+    /** Begin a pan gesture at pointer position (px, py), in any stable pixel space. */
+    dragStart(px, py, now) {
+        this.dragging = true;
+        this.lastPointer = { x: px, y: py };
+        this.samples = [{ t: now, x: px, y: py }];
+        // Grabbing the plane stops any in-flight coast.
+        this.vx = 0;
+        this.vy = 0;
+        this.targetX = this.x;
+        this.targetY = this.y;
+    }
+    /** Pointer moved during a pan gesture. */
+    dragMove(px, py, now) {
+        if (!this.dragging || !this.lastPointer)
+            return;
+        // Content follows the finger: camera moves opposite the pointer delta.
+        this.targetX -= px - this.lastPointer.x;
+        this.targetY -= py - this.lastPointer.y;
+        this.lastPointer = { x: px, y: py };
+        this.samples.push({ t: now, x: px, y: py });
+        while (this.samples.length > 2 && now - this.samples[0].t > VELOCITY_WINDOW_MS) {
+            this.samples.shift();
+        }
+    }
+    /** End the pan gesture, converting recent pointer motion into a fling. */
+    dragEnd(now) {
+        if (!this.dragging)
+            return;
+        this.dragging = false;
+        this.lastPointer = null;
+        const first = this.samples[0];
+        const last = this.samples[this.samples.length - 1];
+        if (first && last && last.t > first.t) {
+            const dt = (last.t - first.t) / 1000;
+            // Pointer velocity, inverted into camera space.
+            let vx = -(last.x - first.x) / dt;
+            let vy = -(last.y - first.y) / dt;
+            const speed = Math.hypot(vx, vy);
+            if (speed > this.maxVelocity) {
+                const s = this.maxVelocity / speed;
+                vx *= s;
+                vy *= s;
+            }
+            this.vx = vx;
+            this.vy = vy;
+        }
+        this.samples = [];
+    }
+    /** Abort a drag without inertia. */
+    dragCancel() {
+        this.dragging = false;
+        this.lastPointer = null;
+        this.samples = [];
+        this.vx = 0;
+        this.vy = 0;
+    }
+    /** External scroll delta (native scroll / wheel). Applied directly. */
+    scrollBy(dx, dy) {
+        this.x += dx;
+        this.y += dy;
+        this.targetX += dx;
+        this.targetY += dy;
+    }
+    /** Jump the camera (and target) to an absolute offset. Kills motion. */
+    moveTo(x, y) {
+        this.x = x;
+        this.y = y;
+        this.targetX = x;
+        this.targetY = y;
+        this.vx = 0;
+        this.vy = 0;
+    }
+    /** Stop all motion at the current offset. */
+    stop() {
+        this.targetX = this.x;
+        this.targetY = this.y;
+        this.vx = 0;
+        this.vy = 0;
+    }
+    /**
+     * Advance the simulation to time `now` (ms). Returns the camera state.
+     * Call once per animation frame.
+     */
+    tick(now) {
+        const last = this.lastTick ?? now;
+        this.lastTick = now;
+        let dt = (now - last) / 1000;
+        if (dt <= 0)
+            return this.state();
+        if (dt > 0.1)
+            dt = 0.1; // clamp long gaps (tab switch) to avoid jumps
+        if (!this.dragging) {
+            // Inertia: the target coasts and the velocity decays exponentially.
+            const decay = Math.exp(-this.friction * dt);
+            if (Math.abs(this.vx) > SETTLE_VELOCITY || Math.abs(this.vy) > SETTLE_VELOCITY) {
+                // Integrate v over the step: x += v/friction * (1 - decay)
+                const integral = this.friction > 0 ? (1 - decay) / this.friction : dt;
+                this.targetX += this.vx * integral;
+                this.targetY += this.vy * integral;
+                this.vx *= decay;
+                this.vy *= decay;
+            }
+            else {
+                this.vx = 0;
+                this.vy = 0;
+            }
+        }
+        // Ease the camera toward the target (frame-rate independent lerp).
+        const k = 1 - Math.exp(-this.ease * dt);
+        this.x += (this.targetX - this.x) * k;
+        this.y += (this.targetY - this.y) * k;
+        if (Math.abs(this.targetX - this.x) < SETTLE_DISTANCE &&
+            Math.abs(this.targetY - this.y) < SETTLE_DISTANCE) {
+            this.x = this.targetX;
+            this.y = this.targetY;
+        }
+        return this.state();
+    }
+}
+//# sourceMappingURL=pan.js.map

package/dist/pan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pan.js","sourceRoot":"","sources":["../src/pan.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,gDAAgD;AAChD,yEAAyE;AACzE,2DAA2D;AAC3D,4EAA4E;AAC5E,4DAA4D;AAC5D,EAAE;AACF,kEAAkE;AA8BlE,MAAM,eAAe,GAAG,GAAG,CAAC,CAAC,KAAK;AAClC,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,OAAO;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,OAAO,aAAa;IAiBxB,YAAY,UAA6B,EAAE;QAZnC,MAAC,GAAG,CAAC,CAAC;QACN,MAAC,GAAG,CAAC,CAAC;QACN,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,CAAC,CAAC;QACZ,OAAE,GAAG,CAAC,CAAC;QACP,OAAE,GAAG,CAAC,CAAC;QAEP,aAAQ,GAAG,KAAK,CAAC;QACjB,gBAAW,GAAoC,IAAI,CAAC;QACpD,YAAO,GAAa,EAAE,CAAC;QACvB,aAAQ,GAAkB,IAAI,CAAC;QAGrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,OAA0B;QACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAChF,CAAC;IAED,KAAK;QACH,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe;YACjD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe;YACjD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,eAAe;YACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC;QACtC,OAAO;YACL,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;YACnC,UAAU,EAAE,IAAI,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,SAAS,CAAC,EAAU,EAAE,EAAU,EAAE,GAAW;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,gDAAgD;QAChD,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,0CAA0C;IAC1C,QAAQ,CAAC,EAAU,EAAE,EAAU,EAAE,GAAW;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAChD,uEAAuE;QACvE,IAAI,CAAC,OAAO,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,kBAAkB,EAAE,CAAC;YAChF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,OAAO,CAAC,GAAW;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACrC,gDAAgD;YAChD,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAClC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACnC,EAAE,IAAI,CAAC,CAAC;gBACR,EAAE,IAAI,CAAC,CAAC;YACV,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACf,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,oCAAoC;IACpC,UAAU;QACR,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,QAAQ,CAAC,EAAU,EAAE,EAAU;QAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,CAAS,EAAE,CAAS;QACzB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAW;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,EAAE,GAAG,GAAG;YAAE,EAAE,GAAG,GAAG,CAAC,CAAC,8CAA8C;QAEtE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,oEAAoE;YACpE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;YAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;gBAC/E,2DAA2D;gBAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC;gBACnC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC;gBACnC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC;gBACjB,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;gBACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtC,IACE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe;YACjD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe,EACjD,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACtB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/positioning.d.ts

@@ -0,0 +1,117 @@
+import type { GridConfig, Tile } from './types.js';
+/**
+ * Whether a tile participates in grid layout. `static`, `relative`, `sticky`,
+ * and tiles with no `position` set are all in flow. `absolute` and `fixed`
+ * tiles are not.
+ */
+export declare function isInFlow(tile: Tile): boolean;
+/** True for tiles that the engine should ignore for collisions and displacement. */
+export declare function isOutOfFlow(tile: Tile): boolean;
+/**
+ * Convert `pinned` (in the configured `pinUnits`) to raw pixels. Used by
+ * adapters to compute `left/top` for absolute and fixed tiles.
+ */
+export declare function pinnedToPixels(pinned: {
+    x: number;
+    y: number;
+}, config: GridConfig): {
+    x: number;
+    y: number;
+};
+/** Inverse of `pinnedToPixels`. Convert pixels back to the configured pin-unit space. */
+export declare function pixelsToPin(pixels: {
+    x: number;
+    y: number;
+}, config: GridConfig): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert `offset` (in the configured `relativeUnits`) to raw pixels. Used by
+ * adapters to compute the visual nudge for `relative` tiles.
+ */
+export declare function offsetToPixels(offset: {
+    x: number;
+    y: number;
+}, config: GridConfig): {
+    x: number;
+    y: number;
+};
+/** Inverse of `offsetToPixels`. */
+export declare function pixelsToOffset(pixels: {
+    x: number;
+    y: number;
+}, config: GridConfig): {
+    x: number;
+    y: number;
+};
+/**
+ * Inputs to `computeTileLayout`. The adapter supplies live viewport/scroll
+ * values so sticky and fixed tiles can react to scrolling.
+ */
+export interface TileLayoutInput {
+    tile: {
+        col: number;
+        row: number;
+        w: number;
+        h: number;
+        position?: import('./types.js').TilePosition;
+        pinned?: {
+            x: number;
+            y: number;
+        };
+        offset?: {
+            x: number;
+            y: number;
+        };
+        sticky?: import('./types.js').StickyConfig;
+    };
+    config: import('./types.js').GridConfig;
+    scrollX: number;
+    scrollY: number;
+    viewportWidth: number;
+    viewportHeight: number;
+}
+export interface TileLayout {
+    /** Left edge in pixels relative to the scroll content origin. */
+    left: number;
+    /** Top edge in pixels relative to the scroll content origin. */
+    top: number;
+    /** Rendered width in pixels (derived from w + cellSize + gap). */
+    width: number;
+    /** Rendered height in pixels. */
+    height: number;
+    /** Optional CSS transform — currently used for `relative` offsets. */
+    transform?: string;
+    /** Stacking hint. Static tiles 1, sticky 40, absolute 30, fixed 50. */
+    zIndex: number;
+    /**
+     * The effective position mode that was applied (after honoring
+     * `enablePositioning`). Useful for adapters that want to add classes.
+     */
+    effective: 'static' | 'relative' | 'absolute' | 'fixed' | 'sticky';
+}
+/**
+ * Compute where a tile should render in the scroll content, given current
+ * scroll/viewport state. Encapsulates the math for relative offsets, absolute
+ * pinned coords (in the configured pinUnits), fixed (anchored to the
+ * scrollable viewport via `pinned + scroll` math), and sticky (pins at an
+ * edge once scrolled past `threshold`). When `GridConfig.enablePositioning`
+ * is false, every tile is treated as `static`.
+ */
+export declare function computeTileLayout(input: TileLayoutInput): TileLayout;
+/**
+ * Adjust pre-computed layouts so multiple sticky tiles pinned to the same edge
+ * stack instead of overlapping — the natural CSS-sticky behavior where, as you
+ * scroll, a later sticky element pushes the previous one off-screen by taking
+ * its pinned spot.
+ *
+ * Pass the array of {tile, layout} pairs (in any order); this mutates the
+ * `layout.left`/`layout.top` values for sticky tiles in place. Run it AFTER
+ * `computeTileLayout` and BEFORE rendering. Non-sticky entries are skipped.
+ */
+export declare function resolveStickyStacking(entries: {
+    tile: TileLayoutInput['tile'];
+    layout: TileLayout;
+}[]): void;
+//# sourceMappingURL=positioning.d.ts.map

package/dist/positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.d.ts","sourceRoot":"","sources":["../src/positioning.ts"],"names":[],"mappings":"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"}

package/dist/positioning.js

@@ -0,0 +1,251 @@
+// Positioning helpers — pure functions, no state.
+//
+// Tiles can opt out of grid flow by setting `position: 'absolute'` or `'fixed'`.
+// Out-of-flow tiles keep their `col/row/w/h` fields (so they can fall back to
+// in-flow if the user toggles position back to 'static') but the layout engine
+// ignores them — they don't displace neighbors and they don't get displaced.
+//
+// Coordinate translation between the configured unit space (pixels / subcell /
+// cells) and raw pixels lives here so adapters and engine share one source of
+// truth.
+/**
+ * Whether a tile participates in grid layout. `static`, `relative`, `sticky`,
+ * and tiles with no `position` set are all in flow. `absolute` and `fixed`
+ * tiles are not.
+ */
+export function isInFlow(tile) {
+    const p = tile.position;
+    return !p || p === 'static' || p === 'relative' || p === 'sticky';
+}
+/** True for tiles that the engine should ignore for collisions and displacement. */
+export function isOutOfFlow(tile) {
+    return !isInFlow(tile);
+}
+/**
+ * Convert `pinned` (in the configured `pinUnits`) to raw pixels. Used by
+ * adapters to compute `left/top` for absolute and fixed tiles.
+ */
+export function pinnedToPixels(pinned, config) {
+    const colSize = config.unitWidth + (config.gap ?? 0);
+    const rowSize = config.unitHeight + (config.gap ?? 0);
+    switch (config.pinUnits ?? 'pixels') {
+        case 'pixels':
+            return { x: pinned.x, y: pinned.y };
+        case 'subcell':
+            return { x: pinned.x * colSize, y: pinned.y * rowSize };
+        case 'cells':
+            return { x: Math.round(pinned.x) * colSize, y: Math.round(pinned.y) * rowSize };
+    }
+}
+/** Inverse of `pinnedToPixels`. Convert pixels back to the configured pin-unit space. */
+export function pixelsToPin(pixels, config) {
+    const colSize = config.unitWidth + (config.gap ?? 0);
+    const rowSize = config.unitHeight + (config.gap ?? 0);
+    switch (config.pinUnits ?? 'pixels') {
+        case 'pixels':
+            return { x: pixels.x, y: pixels.y };
+        case 'subcell':
+            return { x: pixels.x / colSize, y: pixels.y / rowSize };
+        case 'cells':
+            return { x: Math.round(pixels.x / colSize), y: Math.round(pixels.y / rowSize) };
+    }
+}
+/**
+ * Convert `offset` (in the configured `relativeUnits`) to raw pixels. Used by
+ * adapters to compute the visual nudge for `relative` tiles.
+ */
+export function offsetToPixels(offset, config) {
+    const colSize = config.unitWidth + (config.gap ?? 0);
+    const rowSize = config.unitHeight + (config.gap ?? 0);
+    if ((config.relativeUnits ?? 'pixels') === 'pixels') {
+        return { x: offset.x, y: offset.y };
+    }
+    return { x: offset.x * colSize, y: offset.y * rowSize };
+}
+/** Inverse of `offsetToPixels`. */
+export function pixelsToOffset(pixels, config) {
+    const colSize = config.unitWidth + (config.gap ?? 0);
+    const rowSize = config.unitHeight + (config.gap ?? 0);
+    if ((config.relativeUnits ?? 'pixels') === 'pixels') {
+        return { x: pixels.x, y: pixels.y };
+    }
+    return { x: pixels.x / colSize, y: pixels.y / rowSize };
+}
+/**
+ * Compute where a tile should render in the scroll content, given current
+ * scroll/viewport state. Encapsulates the math for relative offsets, absolute
+ * pinned coords (in the configured pinUnits), fixed (anchored to the
+ * scrollable viewport via `pinned + scroll` math), and sticky (pins at an
+ * edge once scrolled past `threshold`). When `GridConfig.enablePositioning`
+ * is false, every tile is treated as `static`.
+ */
+export function computeTileLayout(input) {
+    const { tile, config, scrollX, scrollY, viewportWidth, viewportHeight } = input;
+    const gap = config.gap ?? 0;
+    const halfGap = gap / 2;
+    const colSize = config.unitWidth + gap;
+    const rowSize = config.unitHeight + gap;
+    const width = tile.w * config.unitWidth + (tile.w - 1) * gap;
+    const height = tile.h * config.unitHeight + (tile.h - 1) * gap;
+    const enabled = config.enablePositioning ?? false;
+    const pos = enabled ? (tile.position ?? 'static') : 'static';
+    if (pos === 'absolute') {
+        const px = pinnedToPixels(tile.pinned ?? { x: 0, y: 0 }, config);
+        return { left: px.x, top: px.y, width, height, zIndex: 30, effective: 'absolute' };
+    }
+    if (pos === 'fixed') {
+        const px = pinnedToPixels(tile.pinned ?? { x: 0, y: 0 }, config);
+        return {
+            left: px.x + scrollX,
+            top: px.y + scrollY,
+            width,
+            height,
+            zIndex: 50,
+            effective: 'fixed',
+        };
+    }
+    if (pos === 'sticky') {
+        const sticky = tile.sticky ?? { edge: 'top', threshold: 0 };
+        const threshold = sticky.threshold ?? 0;
+        let left = tile.col * colSize + halfGap;
+        let top = tile.row * rowSize + halfGap;
+        if (sticky.edge === 'top') {
+            const stickyTop = scrollY + threshold;
+            if (top < stickyTop)
+                top = stickyTop;
+        }
+        else if (sticky.edge === 'bottom') {
+            const stickyBottom = scrollY + viewportHeight - height - threshold;
+            if (top > stickyBottom)
+                top = stickyBottom;
+        }
+        else if (sticky.edge === 'left') {
+            const stickyLeft = scrollX + threshold;
+            if (left < stickyLeft)
+                left = stickyLeft;
+        }
+        else if (sticky.edge === 'right') {
+            const stickyRight = scrollX + viewportWidth - width - threshold;
+            if (left > stickyRight)
+                left = stickyRight;
+        }
+        return { left, top, width, height, zIndex: 40, effective: 'sticky' };
+    }
+    // static / relative — tile is centered in its cell with halfGap inset
+    const baseLeft = tile.col * colSize + halfGap;
+    const baseTop = tile.row * rowSize + halfGap;
+    if (pos === 'relative' && tile.offset) {
+        const off = offsetToPixels(tile.offset, config);
+        return {
+            left: baseLeft,
+            top: baseTop,
+            width,
+            height,
+            transform: `translate(${off.x}px, ${off.y}px)`,
+            zIndex: 1,
+            effective: 'relative',
+        };
+    }
+    return { left: baseLeft, top: baseTop, width, height, zIndex: 1, effective: 'static' };
+}
+/**
+ * Adjust pre-computed layouts so multiple sticky tiles pinned to the same edge
+ * stack instead of overlapping — the natural CSS-sticky behavior where, as you
+ * scroll, a later sticky element pushes the previous one off-screen by taking
+ * its pinned spot.
+ *
+ * Pass the array of {tile, layout} pairs (in any order); this mutates the
+ * `layout.left`/`layout.top` values for sticky tiles in place. Run it AFTER
+ * `computeTileLayout` and BEFORE rendering. Non-sticky entries are skipped.
+ */
+export function resolveStickyStacking(entries) {
+    const tops = [];
+    const bots = [];
+    const lefts = [];
+    const rights = [];
+    for (const e of entries) {
+        if (e.layout.effective !== 'sticky')
+            continue;
+        const edge = e.tile.sticky?.edge ?? 'top';
+        if (edge === 'top')
+            tops.push(e);
+        else if (edge === 'bottom')
+            bots.push(e);
+        else if (edge === 'left')
+            lefts.push(e);
+        else
+            rights.push(e);
+    }
+    // Top: sort by natural row ascending. A later (larger-row) sticky whose
+    // current rendered top intrudes on an earlier one pushes it up off-screen.
+    tops.sort((a, b) => a.tile.row - b.tile.row);
+    for (let i = 0; i < tops.length; i++) {
+        const a = tops[i];
+        if (!a)
+            continue;
+        for (let j = i + 1; j < tops.length; j++) {
+            const b = tops[j];
+            if (!b)
+                continue;
+            const aBottom = a.layout.top + a.layout.height;
+            if (b.layout.top < aBottom) {
+                a.layout.top = b.layout.top - a.layout.height;
+                break;
+            }
+        }
+    }
+    // Bottom: mirror of top — sort by natural row descending.
+    bots.sort((a, b) => b.tile.row - a.tile.row);
+    for (let i = 0; i < bots.length; i++) {
+        const a = bots[i];
+        if (!a)
+            continue;
+        for (let j = i + 1; j < bots.length; j++) {
+            const b = bots[j];
+            if (!b)
+                continue;
+            const aTop = a.layout.top;
+            const bBottom = b.layout.top + b.layout.height;
+            if (bBottom > aTop) {
+                a.layout.top = bBottom;
+                break;
+            }
+        }
+    }
+    // Left: mirror of top along the col axis.
+    lefts.sort((a, b) => a.tile.col - b.tile.col);
+    for (let i = 0; i < lefts.length; i++) {
+        const a = lefts[i];
+        if (!a)
+            continue;
+        for (let j = i + 1; j < lefts.length; j++) {
+            const b = lefts[j];
+            if (!b)
+                continue;
+            const aRight = a.layout.left + a.layout.width;
+            if (b.layout.left < aRight) {
+                a.layout.left = b.layout.left - a.layout.width;
+                break;
+            }
+        }
+    }
+    // Right: mirror of bottom along the col axis.
+    rights.sort((a, b) => b.tile.col - a.tile.col);
+    for (let i = 0; i < rights.length; i++) {
+        const a = rights[i];
+        if (!a)
+            continue;
+        for (let j = i + 1; j < rights.length; j++) {
+            const b = rights[j];
+            if (!b)
+                continue;
+            const aLeft = a.layout.left;
+            const bRight = b.layout.left + b.layout.width;
+            if (bRight > aLeft) {
+                a.layout.left = bRight;
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=positioning.js.map

package/dist/positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.js","sourceRoot":"","sources":["../src/positioning.ts"],"names":[],"mappings":"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"}

package/dist/repack.d.ts

@@ -0,0 +1,4 @@
+import type { CellPos, CellRect } from './types.js';
+import type { Grid } from './grid.js';
+export declare function solvePushBFS(grid: Grid, tileId: string, target: CellPos, originRect: CellRect): boolean;
+//# sourceMappingURL=repack.d.ts.map

package/dist/repack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repack.d.ts","sourceRoot":"","sources":["../src/repack.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiBtC,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,QAAQ,GACnB,OAAO,CAoHT"}