system-canvas 0.1.0 → 0.1.1

package/dist/lanes.js

@@ -0,0 +1,129 @@
+/**
+ * Find the lane (if any) that contains the given position along its axis.
+ *
+ * For `columns`, pass the node's x (or x + width/2). For `rows`, pass y.
+ * Returns the first matching lane, or null if the position sits outside
+ * every lane.
+ */
+export function findLaneAt(pos, lanes) {
+    if (!lanes || lanes.length === 0)
+        return null;
+    for (const lane of lanes) {
+        if (pos >= lane.start && pos < lane.start + lane.size)
+            return lane;
+    }
+    return null;
+}
+/**
+ * Snap a position to a lane boundary.
+ *
+ * `edge: 'start'` (default) snaps to the lane's start edge — useful for
+ * snapping a node's x/y when you want nodes to left/top-align in their lane.
+ * `edge: 'center'` snaps so an object of the given `size` is centered
+ * within the lane — useful when nodes sit visually centered in their row
+ * or column. Requires `size` to behave as expected; falls back to `start`
+ * behavior when `size` is 0.
+ * `edge: 'nearest'` snaps to whichever boundary (start, end, or any interior
+ * divider between two adjacent lanes) is closest — useful when the user
+ * drags across lane borders.
+ *
+ * If `size` is provided, the input is treated as the leading edge of an
+ * object of that size, and the snap target accounts for keeping the object
+ * fully inside a single lane when possible.
+ *
+ * Returns `pos` unchanged when `lanes` is empty or the position falls
+ * outside every lane (nothing meaningful to snap to).
+ */
+export function snapToLane(pos, lanes, options = {}) {
+    if (!lanes || lanes.length === 0)
+        return pos;
+    const edge = options.edge ?? 'start';
+    const size = options.size ?? 0;
+    if (edge === 'start' || edge === 'center') {
+        // Use the object's center for lane selection so a node doesn't flip
+        // into the neighbor lane just because its top/left edge crosses a
+        // divider. Prefer the lane whose body contains the center; fall back
+        // to nearest-start by center.
+        const center = pos + size / 2;
+        const containing = findLaneAt(center, lanes);
+        let target;
+        if (containing) {
+            target = containing;
+        }
+        else {
+            let best = lanes[0];
+            let bestDist = Math.abs(center - (best.start + best.size / 2));
+            for (const lane of lanes) {
+                const d = Math.abs(center - (lane.start + lane.size / 2));
+                if (d < bestDist) {
+                    best = lane;
+                    bestDist = d;
+                }
+            }
+            target = best;
+        }
+        if (edge === 'center') {
+            return target.start + (target.size - size) / 2;
+        }
+        return target.start;
+    }
+    // 'nearest': consider every lane boundary (start of each lane, plus end
+    // of the last lane) and pick the closest.
+    const boundaries = [];
+    for (const lane of lanes)
+        boundaries.push(lane.start);
+    const last = lanes[lanes.length - 1];
+    boundaries.push(last.start + last.size);
+    // When size is given, the object's right/bottom edge is `pos + size`.
+    // We want `pos` itself to snap to a boundary — simple nearest is fine.
+    let best = boundaries[0];
+    let bestDist = Math.abs(pos - best);
+    for (const b of boundaries) {
+        const d = Math.abs(pos - b);
+        if (d < bestDist) {
+            best = b;
+            bestDist = d;
+        }
+    }
+    // If snapping would overflow the last lane given the object size, pull
+    // back to keep the object inside.
+    if (size > 0) {
+        const maxStart = last.start + last.size - size;
+        if (best > maxStart)
+            best = maxStart;
+    }
+    return best;
+}
+/**
+ * Convenience: produce a set of equally-sized lanes from an array of labels.
+ *
+ * Consumers that don't want to compute pixel positions can write
+ * `evenLanes(['Now', 'Next', 'Later'])` and get three 400-wide lanes
+ * starting at x = 0.
+ */
+export function evenLanes(labels, size = 400, start = 0) {
+    return labels.map((label, i) => ({
+        id: label,
+        label,
+        start: start + i * size,
+        size,
+    }));
+}
+/**
+ * Total extent covered by a lane list (from first.start to last end).
+ * Returns 0 when the list is empty.
+ */
+export function lanesExtent(lanes) {
+    if (!lanes || lanes.length === 0)
+        return { start: 0, end: 0 };
+    let start = Infinity;
+    let end = -Infinity;
+    for (const lane of lanes) {
+        if (lane.start < start)
+            start = lane.start;
+        if (lane.start + lane.size > end)
+            end = lane.start + lane.size;
+    }
+    return { start, end };
+}
+//# sourceMappingURL=lanes.js.map

package/dist/lanes.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimal dot-path utilities used by the form editor to read/write nested
+ * fields like `customData.status`. Dependency-free; no array-index syntax.
+ *
+ * `getAtPath({customData: {status: 'done'}}, 'customData.status') === 'done'`
+ * `setAtPath({}, 'customData.status', 'done')` → `{customData: {status: 'done'}}`
+ */
+export declare function getAtPath(obj: unknown, path: string): unknown;
+/**
+ * Set a value at the given dot-path, returning a new object with the value
+ * applied. Existing branches are shallow-cloned along the path; siblings
+ * are preserved by reference. Does not mutate `obj`.
+ */
+export declare function setAtPath<T extends Record<string, any>>(obj: T | undefined, path: string, value: unknown): T;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,GAAG,EAAE,CAAC,GAAG,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,CAAC,CAgBH"}

package/dist/paths.js

@@ -0,0 +1,41 @@
+/**
+ * Minimal dot-path utilities used by the form editor to read/write nested
+ * fields like `customData.status`. Dependency-free; no array-index syntax.
+ *
+ * `getAtPath({customData: {status: 'done'}}, 'customData.status') === 'done'`
+ * `setAtPath({}, 'customData.status', 'done')` → `{customData: {status: 'done'}}`
+ */
+export function getAtPath(obj, path) {
+    if (obj == null)
+        return undefined;
+    const parts = path.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+/**
+ * Set a value at the given dot-path, returning a new object with the value
+ * applied. Existing branches are shallow-cloned along the path; siblings
+ * are preserved by reference. Does not mutate `obj`.
+ */
+export function setAtPath(obj, path, value) {
+    const parts = path.split('.');
+    const root = obj ? { ...obj } : {};
+    let cur = root;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const next = cur[key];
+        const cloned = next != null && typeof next === 'object' && !Array.isArray(next)
+            ? { ...next }
+            : {};
+        cur[key] = cloned;
+        cur = cloned;
+    }
+    cur[parts[parts.length - 1]] = value;
+    return root;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAY;IAClD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG,GAAQ,GAAG,CAAA;IAClB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QAC5D,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;IACd,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,GAAkB,EAClB,IAAY,EACZ,KAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAwB,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvD,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACrB,MAAM,MAAM,GACV,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC9D,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE;YACb,CAAC,CAAC,EAAE,CAAA;QACR,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;QACjB,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IACpC,OAAO,IAAS,CAAA;AAClB,CAAC"}

package/dist/rendering/index.d.ts

@@ -1,4 +1,5 @@
 export { computeAnchorPoint, inferSide } from './anchor-points.js';
 export { computeEdgePath, computeEdgeMidpoint } from './edge-routing.js';
-export { computeBoundingBox, fitToBounds, screenToCanvas, canvasToScreen, } from './viewport-math.js';
+export { computeBoundingBox, fitToBounds, fitBoundsIntoRect, canvasRectToScreenRect, screenToCanvas, canvasToScreen, } from './viewport-math.js';
+export type { Rect } from './viewport-math.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/rendering/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/rendering/index.js

@@ -1,4 +1,4 @@
 export { computeAnchorPoint, inferSide } from './anchor-points.js';
 export { computeEdgePath, computeEdgeMidpoint } from './edge-routing.js';
-export { computeBoundingBox, fitToBounds, screenToCanvas, canvasToScreen, } from './viewport-math.js';
+export { computeBoundingBox, fitToBounds, fitBoundsIntoRect, canvasRectToScreenRect, screenToCanvas, canvasToScreen, } from './viewport-math.js';
 //# sourceMappingURL=index.js.map

package/dist/rendering/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAA"}

package/dist/rendering/viewport-math.d.ts

@@ -22,4 +22,32 @@ export declare function canvasToScreen(canvasX: number, canvasY: number, viewpor
     x: number;
     y: number;
 };
+/**
+ * Axis-aligned rectangle in either canvas-space or screen-space.
+ */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Compute a viewport transform that places the given canvas-space bounds
+ * (`bounds`) so that they fit inside the given screen-space rect
+ * (`targetScreenRect`), preserving aspect ratio (contain). When the aspect
+ * ratios differ, the bounds are letterboxed (centered) on the shorter axis.
+ *
+ * `padding` (in screen pixels) insets the target rect on all sides before
+ * fitting, giving the content visual breathing room.
+ *
+ * This is the core "seamless handoff" math: given a parent node's on-screen
+ * rect and a child canvas's bounding box, it returns the new viewport
+ * transform that makes the child canvas appear exactly where the parent
+ * node was.
+ */
+export declare function fitBoundsIntoRect(bounds: BoundingBox, targetScreenRect: Rect, padding?: number): ViewportState;
+/**
+ * Compute the on-screen rect of a canvas-space rect under the given viewport.
+ */
+export declare function canvasRectToScreenRect(canvasRect: Rect, viewport: ViewportState): Rect;
 //# sourceMappingURL=viewport-math.d.ts.map

package/dist/rendering/viewport-math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewport-math.d.ts","sourceRoot":"","sources":["../../src/rendering/viewport-math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,WAAW,CAyBrE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EAAE,EACrB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,MAAW,GACnB,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}
+{"version":3,"file":"viewport-math.d.ts","sourceRoot":"","sources":["../../src/rendering/viewport-math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,WAAW,CAyBrE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EAAE,EACrB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,MAAW,GACnB,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,IAAI,EACtB,OAAO,GAAE,MAAU,GAClB,aAAa,CA4Bf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,IAAI,EAChB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAON"}

package/dist/rendering/viewport-math.js

@@ -63,4 +63,53 @@ export function canvasToScreen(canvasX, canvasY, viewport) {
         y: canvasY * viewport.zoom + viewport.y,
     };
 }
+/**
+ * Compute a viewport transform that places the given canvas-space bounds
+ * (`bounds`) so that they fit inside the given screen-space rect
+ * (`targetScreenRect`), preserving aspect ratio (contain). When the aspect
+ * ratios differ, the bounds are letterboxed (centered) on the shorter axis.
+ *
+ * `padding` (in screen pixels) insets the target rect on all sides before
+ * fitting, giving the content visual breathing room.
+ *
+ * This is the core "seamless handoff" math: given a parent node's on-screen
+ * rect and a child canvas's bounding box, it returns the new viewport
+ * transform that makes the child canvas appear exactly where the parent
+ * node was.
+ */
+export function fitBoundsIntoRect(bounds, targetScreenRect, padding = 0) {
+    if (bounds.width === 0 || bounds.height === 0) {
+        // Degenerate bounds — center the single point in the target rect at 1x.
+        return {
+            x: targetScreenRect.x + targetScreenRect.width / 2 - bounds.minX,
+            y: targetScreenRect.y + targetScreenRect.height / 2 - bounds.minY,
+            zoom: 1,
+        };
+    }
+    const availW = Math.max(1, targetScreenRect.width - padding * 2);
+    const availH = Math.max(1, targetScreenRect.height - padding * 2);
+    const scaleX = availW / bounds.width;
+    const scaleY = availH / bounds.height;
+    // Contain (fit-inside): use the smaller scale so both dimensions fit.
+    const zoom = Math.min(scaleX, scaleY);
+    // Center the scaled bounds inside the padded target rect.
+    const scaledW = bounds.width * zoom;
+    const scaledH = bounds.height * zoom;
+    const offsetX = padding + (availW - scaledW) / 2;
+    const offsetY = padding + (availH - scaledH) / 2;
+    const x = targetScreenRect.x + offsetX - bounds.minX * zoom;
+    const y = targetScreenRect.y + offsetY - bounds.minY * zoom;
+    return { x, y, zoom };
+}
+/**
+ * Compute the on-screen rect of a canvas-space rect under the given viewport.
+ */
+export function canvasRectToScreenRect(canvasRect, viewport) {
+    return {
+        x: canvasRect.x * viewport.zoom + viewport.x,
+        y: canvasRect.y * viewport.zoom + viewport.y,
+        width: canvasRect.width * viewport.zoom,
+        height: canvasRect.height * viewport.zoom,
+    };
+}
 //# sourceMappingURL=viewport-math.js.map

package/dist/rendering/viewport-math.js.map

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

package/dist/rollup.d.ts

@@ -0,0 +1,23 @@
+import type { CanvasData, CanvasNode, RollupResult } from './types.js';
+/**
+ * Count how many direct children of `canvas` match `predicate`, and return
+ * a `RollupResult` with `total`, `matched`, and `fraction`.
+ *
+ * Safe on `undefined` / empty canvases: returns `{ total: 0, matched: 0,
+ * fraction: 0 }`. This is the ergonomic fallback used by slot accessors
+ * when a node's sub-canvas hasn't resolved yet.
+ *
+ * Only counts direct children. For recursive counts through nested
+ * sub-canvases, use `rollupNodesDeep`.
+ */
+export declare function rollupNodes(canvas: CanvasData | undefined, predicate: (node: CanvasNode) => boolean): RollupResult;
+/**
+ * Recursive version of `rollupNodes`. For each node that has a `ref`,
+ * looks up its sub-canvas via `getSubCanvas` and counts its descendants as
+ * well. Nodes with refs but unresolved sub-canvases still count as a single
+ * node (themselves) in `total`.
+ *
+ * Cycle-safe: each canvas ref is visited at most once per rollup.
+ */
+export declare function rollupNodesDeep(canvas: CanvasData | undefined, predicate: (node: CanvasNode) => boolean, getSubCanvas: (ref: string) => CanvasData | undefined): RollupResult;
+//# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,GACvC,YAAY,CASd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,EACxC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,GACpD,YAAY,CAuBd"}

package/dist/rollup.js

@@ -0,0 +1,56 @@
+/**
+ * Count how many direct children of `canvas` match `predicate`, and return
+ * a `RollupResult` with `total`, `matched`, and `fraction`.
+ *
+ * Safe on `undefined` / empty canvases: returns `{ total: 0, matched: 0,
+ * fraction: 0 }`. This is the ergonomic fallback used by slot accessors
+ * when a node's sub-canvas hasn't resolved yet.
+ *
+ * Only counts direct children. For recursive counts through nested
+ * sub-canvases, use `rollupNodesDeep`.
+ */
+export function rollupNodes(canvas, predicate) {
+    const nodes = canvas?.nodes ?? [];
+    const total = nodes.length;
+    if (total === 0)
+        return { total: 0, matched: 0, fraction: 0 };
+    let matched = 0;
+    for (const n of nodes) {
+        if (predicate(n))
+            matched++;
+    }
+    return { total, matched, fraction: matched / total };
+}
+/**
+ * Recursive version of `rollupNodes`. For each node that has a `ref`,
+ * looks up its sub-canvas via `getSubCanvas` and counts its descendants as
+ * well. Nodes with refs but unresolved sub-canvases still count as a single
+ * node (themselves) in `total`.
+ *
+ * Cycle-safe: each canvas ref is visited at most once per rollup.
+ */
+export function rollupNodesDeep(canvas, predicate, getSubCanvas) {
+    const visited = new Set();
+    let total = 0;
+    let matched = 0;
+    const walk = (c) => {
+        if (!c)
+            return;
+        for (const n of c.nodes ?? []) {
+            total++;
+            if (predicate(n))
+                matched++;
+            if (n.ref && !visited.has(n.ref)) {
+                visited.add(n.ref);
+                walk(getSubCanvas(n.ref));
+            }
+        }
+    };
+    walk(canvas);
+    return {
+        total,
+        matched,
+        fraction: total === 0 ? 0 : matched / total,
+    };
+}
+//# sourceMappingURL=rollup.js.map

package/dist/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,MAA8B,EAC9B,SAAwC;IAExC,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;IAC1B,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IAC7D,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAA;IAC7B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,EAAE,CAAA;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA8B,EAC9B,SAAwC,EACxC,YAAqD;IAErD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,IAAI,GAAG,CAAC,CAAyB,EAAE,EAAE;QACzC,IAAI,CAAC,CAAC;YAAE,OAAM;QACd,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YAC9B,KAAK,EAAE,CAAA;YACP,IAAI,SAAS,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAA;YAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;gBAClB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,IAAI,CAAC,MAAM,CAAC,CAAA;IACZ,OAAO;QACL,KAAK;QACL,OAAO;QACP,QAAQ,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK;KAC5C,CAAA;AACH,CAAC"}

package/dist/slots.d.ts

@@ -0,0 +1,65 @@
+import type { CanvasTheme, CategorySlots, NodeAccessor, ResolvedNode, SlotContext, SlotPosition, SlotRect, SlotSpec } from './types.js';
+/**
+ * Compute the region rect (in canvas-space) for every slot position on a
+ * resolved node. Pure geometry — no knowledge of which slots are actually
+ * in use. Callers index by `SlotPosition`.
+ */
+export declare function computeCategorySlotRegions(node: ResolvedNode, theme: CanvasTheme, slots?: CategorySlots): Record<SlotPosition, SlotRect>;
+/**
+ * Resolve an accessor against a `SlotContext`. Function accessors are
+ * called; static values are returned as-is.
+ */
+export declare function resolveAccessor<T>(accessor: NodeAccessor<T>, ctx: SlotContext): T;
+/**
+ * Resolve an accessor with a fallback for the function case. Useful when
+ * a slot renders a default from the theme but allows per-call overrides.
+ */
+export declare function resolveAccessorOr<T>(accessor: NodeAccessor<T> | undefined, fallback: T, ctx: SlotContext): T;
+/**
+ * Look up the slots map for a node's category. Returns undefined when the
+ * node has no category, or the category has no slots declared.
+ */
+export declare function getCategorySlots(node: ResolvedNode, theme: CanvasTheme): CategorySlots | undefined;
+type Corner = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+/**
+ * Pick a corner for the ref indicator given which slots are occupied.
+ *
+ * If the default corner is free, it wins. Otherwise we try the diagonally
+ * opposite corner, then the remaining two corners in clockwise order from
+ * the default. If all four corners are occupied we keep the default
+ * position — the caller can decide whether to log a dev warning.
+ *
+ * Corners occupied by `header` or `footer` count as occupied on *both*
+ * corners of that row: a header in the top strip blocks both `topLeft` and
+ * `topRight` (the indicator would overlap the header text strip anyway).
+ */
+export declare function pickRefIndicatorCorner(defaultCorner: Corner, slots: CategorySlots | undefined): Corner;
+/**
+ * Iterate over a slots map in a deterministic order. Returns entries as
+ * `[position, spec]` pairs. Order matches the `SlotPosition` definition —
+ * stable across runs so SVG paint order is stable.
+ */
+export declare function slotEntries(slots: CategorySlots): Array<[SlotPosition, SlotSpec]>;
+export interface ReflowReservations {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * Compute how many pixels of the node's content box must be reserved on
+ * each side for library-owned slots so node text/icons can be reflowed
+ * without colliding with slots.
+ *
+ *   - `header`  → shift text down by header region height + inset
+ *   - `footer`  → shrink text vertical extent by footer region height + inset
+ *   - `leftEdge` / `rightEdge` → inset text by the edge strip width
+ *
+ * Top/bottom edges and corner slots don't reflow text (they're thin strips
+ * or small badges that sit over the existing layout). If the node is so
+ * short that reservations would leave less than `fontSize` vertical space
+ * for text, the reflow is skipped (text stays centered).
+ */
+export declare function computeReflowReservations(node: ResolvedNode, theme: CanvasTheme, slots: CategorySlots | undefined): ReflowReservations;
+export {};
+//# sourceMappingURL=slots.d.ts.map

package/dist/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,EACT,MAAM,YAAY,CAAA;AAmCnB;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,aAAa,GACpB,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAmHhC;AAsCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,CAAC,CAEjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EACrC,QAAQ,EAAE,CAAC,EACX,GAAG,EAAE,WAAW,GACf,CAAC,CAGH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,GACjB,aAAa,GAAG,SAAS,CAI3B;AAMD,KAAK,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,MAAM,CAyBR;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,GACnB,KAAK,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAwBjC;AAMD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,kBAAkB,CAEpB"}