@batterai/editor-shell 0.1.0

package/dist/model/layout-columns.js

@@ -0,0 +1,74 @@
+import { literal, unwrapProp } from "./prop-access.js";
+/**
+ * The `layout.columns` block's nesting is canonical `BlockNode.children` (plan
+ * §1 D1): each column is a `layout.column` `BlockNode` (its inner blocks are
+ * that node's `children`), and the grid geometry — `colstart`/`colspan`/
+ * `rowstart`/`rowspan`/`order` — rides a `{kind:"literal"}` `props["grid"]`
+ * array on the parent layout node, one `GridCell` per column id. This module
+ * is the ONE bridge between the canonical children/grid representation the tree
+ * engine operates on and the flat `LayoutColumnView` the layout editor renders.
+ */
+export const LAYOUT_COLUMNS_TYPE = "layout.columns";
+export const LAYOUT_COLUMN_TYPE = "layout.column";
+/** Reserved literal-prop key on a layout node carrying its per-column grid
+ * geometry (D1). One cell per column child, keyed by the column node id. */
+export const GRID_PROP = "grid";
+/** Is this a canonical layout node (its columns live in `children` + `grid`)? */
+export function isLayoutColumnsNode(node) {
+    return node.kind === "block" && node.blockType === LAYOUT_COLUMNS_TYPE;
+}
+function readGridCells(node) {
+    const raw = unwrapProp(node.props[GRID_PROP]);
+    return Array.isArray(raw) ? raw : [];
+}
+/**
+ * The `LayoutColumnView[]` the layout editor consumes, derived from a layout
+ * node's `children` (the column nodes) + `props.grid` (the geometry). A column
+ * with no matching grid cell falls back to a full-width single-row cell so a
+ * malformed page still renders rather than dropping the column.
+ */
+export function columnsView(node) {
+    const cells = readGridCells(node);
+    const byId = new Map(cells.map((cell) => [cell.id, cell]));
+    return (node.children ?? []).map((child, index) => {
+        const cell = byId.get(child.id);
+        const children = child.kind === "block" ? (child.children ?? []) : [];
+        return {
+            id: child.id,
+            colstart: cell?.colstart ?? 1,
+            colspan: cell?.colspan ?? 12,
+            rowstart: cell?.rowstart ?? 1,
+            rowspan: cell?.rowspan ?? 1,
+            order: cell?.order ?? index,
+            children,
+        };
+    });
+}
+/**
+ * Fold a whole-array `LayoutColumnView[]` replace (a geometry/content edit from
+ * the layout editor) back onto a layout `BlockNode`: rebuild the column
+ * children from each view's `children` and re-derive the `grid` literal. The
+ * ONE writer of a layout node's structure.
+ */
+export function withColumns(node, columns) {
+    const children = columns.map((column) => ({
+        id: column.id,
+        kind: "block",
+        blockType: LAYOUT_COLUMN_TYPE,
+        props: {},
+        children: column.children,
+    }));
+    const grid = literal(columns.map(cellOf));
+    return { ...node, props: { ...node.props, [GRID_PROP]: grid }, children };
+}
+function cellOf(column) {
+    return {
+        id: column.id,
+        colstart: column.colstart,
+        colspan: column.colspan,
+        rowstart: column.rowstart,
+        rowspan: column.rowspan,
+        order: column.order,
+    };
+}
+//# sourceMappingURL=layout-columns.js.map

package/dist/model/layout-columns.js.map

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

package/dist/model/page-topology.d.ts

@@ -0,0 +1,20 @@
+import type { PageNode } from "@batterai/bind-core";
+import type { CanvasPage } from "../types";
+export interface PageTopology {
+    readonly pageById: ReadonlyMap<string, CanvasPage>;
+    readonly childrenByParent: ReadonlyMap<string, readonly CanvasPage[]>;
+    readonly roots: readonly CanvasPage[];
+    readonly preorder: readonly CanvasPage[];
+    readonly pagesByRoot: ReadonlyMap<string, readonly CanvasPage[]>;
+    readonly depthById: ReadonlyMap<string, number>;
+    readonly topLevelAncestorById: ReadonlyMap<string, string>;
+    readonly blockOwnerPageId: ReadonlyMap<string, string>;
+    readonly nodeById: ReadonlyMap<string, PageNode>;
+}
+/**
+ * Builds every page and block lookup used by the board in one O(pages + nodes)
+ * pass. Invalid graphs are rejected instead of being silently promoted to
+ * roots; untrusted documents must already have passed the contract parser.
+ */
+export declare function buildPageTopology(pages: readonly CanvasPage[]): PageTopology;
+//# sourceMappingURL=page-topology.d.ts.map

package/dist/model/page-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-topology.d.ts","sourceRoot":"","sources":["../../src/model/page-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,YAAY,CAkF5E"}

package/dist/model/page-topology.js

@@ -0,0 +1,94 @@
+import { deriveCanvasPageParents } from "@batterai/contract";
+/**
+ * Builds every page and block lookup used by the board in one O(pages + nodes)
+ * pass. Invalid graphs are rejected instead of being silently promoted to
+ * roots; untrusted documents must already have passed the contract parser.
+ */
+export function buildPageTopology(pages) {
+    const hierarchyPages = deriveCanvasPageParents(pages);
+    const pageById = new Map();
+    const childrenByParent = new Map();
+    const roots = [];
+    for (const page of hierarchyPages) {
+        if (pageById.has(page.id))
+            throw new Error(`Duplicate Canvas page id: ${page.id}`);
+        pageById.set(page.id, page);
+    }
+    for (const page of hierarchyPages) {
+        if (page.parentId === null || page.parentId === undefined) {
+            roots.push(page);
+            continue;
+        }
+        if (!pageById.has(page.parentId)) {
+            throw new Error(`Canvas page ${page.id} references missing parent ${page.parentId}`);
+        }
+        const children = childrenByParent.get(page.parentId) ?? [];
+        children.push(page);
+        childrenByParent.set(page.parentId, children);
+    }
+    const preorder = [];
+    const pagesByRoot = new Map();
+    const depthById = new Map();
+    const topLevelAncestorById = new Map();
+    const visiting = new Set();
+    const visited = new Set();
+    function visit(page, rootId, depth, column) {
+        if (visiting.has(page.id))
+            throw new Error(`Canvas page parent cycle includes ${page.id}`);
+        if (visited.has(page.id))
+            throw new Error(`Canvas page ${page.id} occurs more than once in the graph`);
+        visiting.add(page.id);
+        visited.add(page.id);
+        depthById.set(page.id, depth);
+        topLevelAncestorById.set(page.id, rootId);
+        preorder.push(page);
+        column.push(page);
+        for (const child of childrenByParent.get(page.id) ?? [])
+            visit(child, rootId, depth + 1, column);
+        visiting.delete(page.id);
+    }
+    for (const root of roots) {
+        const column = [];
+        visit(root, root.id, 0, column);
+        pagesByRoot.set(root.id, column);
+    }
+    if (visited.size !== hierarchyPages.length) {
+        const unresolved = hierarchyPages.find((page) => !visited.has(page.id));
+        throw new Error(`Canvas page parent cycle includes ${unresolved?.id ?? "unknown"}`);
+    }
+    const blockOwnerPageId = new Map();
+    const nodeById = new Map();
+    const activeObjects = new WeakSet();
+    function indexNode(node, pageId) {
+        if (activeObjects.has(node))
+            throw new Error(`Canvas node object cycle includes ${node.id}`);
+        if (nodeById.has(node.id))
+            throw new Error(`Duplicate Canvas node id: ${node.id}`);
+        activeObjects.add(node);
+        nodeById.set(node.id, node);
+        blockOwnerPageId.set(node.id, pageId);
+        if (node.kind === "block") {
+            for (const child of node.children ?? [])
+                indexNode(child, pageId);
+        }
+        else {
+            indexNode(node.itemTemplate, pageId);
+        }
+        activeObjects.delete(node);
+    }
+    for (const page of hierarchyPages)
+        for (const node of page.root)
+            indexNode(node, page.id);
+    return {
+        pageById,
+        childrenByParent,
+        roots,
+        preorder,
+        pagesByRoot,
+        depthById,
+        topLevelAncestorById,
+        blockOwnerPageId,
+        nodeById,
+    };
+}
+//# sourceMappingURL=page-topology.js.map

package/dist/model/page-topology.js.map

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

package/dist/model/page-tree-bridge.d.ts

@@ -0,0 +1,81 @@
+import { type BlockNode, type PageNode } from "@batterai/bind-core";
+import type { CanvasPage } from "../types";
+import { type LayoutColumnView } from "./layout-columns";
+/**
+ * The ONE adapter between the in-memory `CanvasPage` and bind-core's
+ * `page-tree.ts` (D5 / A2). The tree is now canonical (`CanvasPage.root` is
+ * `PageNode[]`), so every mutation — insert, move, remove, duplicate, patch —
+ * runs the single `page-tree.ts` engine directly on `page.root`; there is no
+ * per-mutation model round-trip and no second tree walker in the app
+ * (`pageActions`/`pagesActions`/`editorClipboard` all funnel through here).
+ *
+ * Node ids are carried verbatim, so collab lock targets (`nodeId`) stay valid
+ * across every mutation (S5).
+ */
+type Root = readonly PageNode[];
+/** Locate a block node anywhere in the tree (null = not present / not a block). */
+export declare function findNode(page: CanvasPage, blockId: string | null): BlockNode | null;
+/** The immediate parent id of a block (null = top level), or undefined if the
+ * block is not on the page. */
+export declare function parentIdOf(root: Root, blockId: string): string | null | undefined;
+/** Ordered child ids of a parent (null parent = top-level ids). */
+export declare function childIdsOf(root: Root, parentId: string | null): string[];
+/** Insert nodes at `index` within `parentId`, preserving their order. */
+export declare function insertNodesAt(page: CanvasPage, parentId: string | null, index: number, nodes: PageNode[]): CanvasPage;
+/** Insert nodes directly after an anchor block (append when the anchor is
+ * missing), matching the old `insertBlocksAfter` semantics. */
+export declare function insertNodesAfter(page: CanvasPage, anchorId: string | null, nodes: PageNode[]): CanvasPage;
+/**
+ * Move a block under `parentId`, inserting it at `insertIndex` measured against
+ * the destination list AFTER the block has been removed (the post-removal
+ * splice index). `movePageNode` removes-then-inserts, so this is the natural,
+ * unambiguous index; callers that hold a pre-removal "drop index" adjust before
+ * calling (see `moveBlockToTopLevel`/`moveBlockToColumn`).
+ */
+export declare function moveNodeTo(page: CanvasPage, blockId: string, parentId: string | null, insertIndex: number): CanvasPage;
+/** The post-removal insertion index for a "drop at `index` in the current
+ * list" gesture: dropping past the block's own slot in the SAME parent shifts
+ * the tail left by one once the block is removed (the old drop correction). */
+export declare function dropIndexToInsertIndex(page: CanvasPage, blockId: string, parentId: string | null, index: number): number;
+/** Remove a block (top-level or nested) from the page. */
+export declare function removeNode(page: CanvasPage, blockId: string): CanvasPage;
+/** Insert a freshly-minted copy of `blockId` immediately after it (same parent);
+ * `mint` supplies the fresh-id copy (an app concern, not a tree concern). */
+export declare function duplicateNode(page: CanvasPage, blockId: string, mint: (block: BlockNode) => BlockNode): CanvasPage;
+/** Patch a block's props (plain values wrapped as literals). */
+export declare function patchNodeProps(page: CanvasPage, blockId: string, patch: Record<string, unknown>): CanvasPage;
+/**
+ * Replace a `layout.columns` block's whole column structure from the layout
+ * editor's `LayoutColumnView[]` (a geometry/content edit). Rebuilds the column
+ * `children` + `grid` literal via `withColumns` (D1); routing this through the
+ * generic prop-patch would not touch `children`. Layout blocks never nest, so
+ * the target is always top-level — no tree walk beyond the top row is needed.
+ */
+export declare function setLayoutColumns(page: CanvasPage, blockId: string, columns: readonly LayoutColumnView[]): CanvasPage;
+/** Replace a block in place with another (kept for the swap/replace drop
+ * choices). Preserves the target's slot; the replacement carries its own id. */
+export declare function replaceNode(page: CanvasPage, blockId: string, replacement: BlockNode): CanvasPage;
+/**
+ * Substitute the node at `blockId` in place with `replacement`, keeping its
+ * slot (position + parent) via `page-tree.ts`'s `replacePageNode`. A no-op when
+ * the block is not on this page (so it can be applied to every page
+ * unconditionally); the cross-page "replace" drop composes it.
+ */
+export declare function substituteNode(page: CanvasPage, blockId: string, replacement: BlockNode): CanvasPage;
+/**
+ * Swap two blocks' positions within one page via `page-tree.ts`'s single-pass
+ * `swapPageNodes` (matches each against its ORIGINAL id, so it never
+ * double-applies the way two sequential substitutes would). A no-op unless both
+ * ids live on this page — the cross-page swap handles the split case itself.
+ */
+export declare function swapNodes(page: CanvasPage, aId: string, bId: string): CanvasPage;
+/**
+ * Remove the node at `removeId` and, in the same pass, substitute the node at
+ * `keepAtId` with `replacement` — the "replace" drop choice (source takes the
+ * target's slot, source's own slot is dropped). A no-op unless both ids live on
+ * this page, so it is safe to apply to every page. */
+export declare function pullNodeInto(page: CanvasPage, removeId: string, keepAtId: string, replacement: BlockNode): CanvasPage;
+/** Every block id under a subtree, in document order (top-level then nested). */
+export declare function collectBlockIds(root: Root): string[];
+export {};
+//# sourceMappingURL=page-tree-bridge.d.ts.map

package/dist/model/page-tree-bridge.d.ts.map

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

package/dist/model/page-tree-bridge.js

@@ -0,0 +1,234 @@
+import { findPageNode, insertPageNode, movePageNode, patchPageBlockProps, removePageNode, replacePageNode, swapPageNodes, } from "@batterai/bind-core";
+import { withColumns } from "./layout-columns.js";
+import { literal } from "./prop-access.js";
+/** Run a pure transform of the canonical root and fold the result back onto the
+ * page. A transform returning the same root (a rejected mutation) is a no-op. */
+function withRoot(page, transform) {
+    const nextRoot = transform(page.root);
+    if (nextRoot === page.root)
+        return page;
+    return { ...page, root: nextRoot };
+}
+/** Locate a block node anywhere in the tree (null = not present / not a block). */
+export function findNode(page, blockId) {
+    if (!blockId)
+        return null;
+    const match = findPageNode(page.root, blockId);
+    return match && match.node.kind === "block" ? match.node : null;
+}
+/** The immediate parent id of a block (null = top level), or undefined if the
+ * block is not on the page. */
+export function parentIdOf(root, blockId) {
+    const match = findPageNode(root, blockId);
+    return match ? match.parentId : undefined;
+}
+/** Ordered child ids of a parent (null parent = top-level ids). */
+export function childIdsOf(root, parentId) {
+    if (parentId === null)
+        return root.map((node) => node.id);
+    const parent = findPageNode(root, parentId)?.node;
+    if (!parent || parent.kind !== "block")
+        return [];
+    return (parent.children ?? []).map((node) => node.id);
+}
+/**
+ * Turn an insertion index within a parent's sibling list into the anchor
+ * `page-tree.ts` expects. Index 0 of a non-empty list must PREPEND (`beforeId`
+ * the current head); the middle/end uses `afterId` the preceding sibling; an
+ * empty list appends (no anchor). This is why bind-core's insert grew a
+ * `beforeId`: `afterId` alone can only append, never prepend.
+ */
+function anchorForIndex(siblingIds, index) {
+    const clamped = Math.max(0, Math.min(index, siblingIds.length));
+    if (clamped === 0) {
+        const head = siblingIds[0];
+        return head === undefined ? {} : { beforeId: head };
+    }
+    return { afterId: siblingIds[clamped - 1] };
+}
+/** Insert nodes at `index` within `parentId`, preserving their order. */
+export function insertNodesAt(page, parentId, index, nodes) {
+    if (nodes.length === 0)
+        return page;
+    return withRoot(page, (root) => insertBlocksIntoRoot(root, parentId, index, nodes));
+}
+/** Insert nodes directly after an anchor block (append when the anchor is
+ * missing), matching the old `insertBlocksAfter` semantics. */
+export function insertNodesAfter(page, anchorId, nodes) {
+    if (nodes.length === 0)
+        return page;
+    return withRoot(page, (root) => {
+        if (!anchorId)
+            return appendToRoot(root, null, nodes);
+        const parentId = parentIdOf(root, anchorId);
+        if (parentId === undefined)
+            return appendToRoot(root, null, nodes);
+        return sequentialInsert(root, parentId, { afterId: anchorId }, nodes);
+    });
+}
+function insertBlocksIntoRoot(root, parentId, index, nodes) {
+    return sequentialInsert(root, parentId, anchorForIndex(childIdsOf(root, parentId), index), nodes);
+}
+function appendToRoot(root, parentId, nodes) {
+    const afterId = childIdsOf(root, parentId).at(-1);
+    return sequentialInsert(root, parentId, { afterId }, nodes);
+}
+/** Insert a run of nodes at an anchor, threading each inserted id as the
+ * `afterId` for the next so the run keeps its order (the first honors the
+ * given anchor, which may be a `beforeId` prepend). */
+function sequentialInsert(root, parentId, anchor, nodes) {
+    let current = root;
+    let next = anchor;
+    for (const node of nodes) {
+        const result = insertPageNode(current, { parentId, ...next }, node);
+        if (!result.ok)
+            return root;
+        current = result.root;
+        next = { afterId: node.id };
+    }
+    return current;
+}
+/**
+ * Move a block under `parentId`, inserting it at `insertIndex` measured against
+ * the destination list AFTER the block has been removed (the post-removal
+ * splice index). `movePageNode` removes-then-inserts, so this is the natural,
+ * unambiguous index; callers that hold a pre-removal "drop index" adjust before
+ * calling (see `moveBlockToTopLevel`/`moveBlockToColumn`).
+ */
+export function moveNodeTo(page, blockId, parentId, insertIndex) {
+    return withRoot(page, (root) => {
+        const siblingIds = childIdsOf(root, parentId).filter((id) => id !== blockId);
+        const anchor = anchorForIndex(siblingIds, insertIndex);
+        const result = movePageNode(root, blockId, { parentId, ...anchor });
+        return result.ok ? result.root : root;
+    });
+}
+/** The post-removal insertion index for a "drop at `index` in the current
+ * list" gesture: dropping past the block's own slot in the SAME parent shifts
+ * the tail left by one once the block is removed (the old drop correction). */
+export function dropIndexToInsertIndex(page, blockId, parentId, index) {
+    const root = page.root;
+    const currentParent = parentIdOf(root, blockId);
+    const currentIndex = childIdsOf(root, parentId).indexOf(blockId);
+    const sameParent = currentParent === parentId && currentIndex >= 0;
+    return sameParent && currentIndex < index ? index - 1 : index;
+}
+/** Remove a block (top-level or nested) from the page. */
+export function removeNode(page, blockId) {
+    return withRoot(page, (root) => {
+        const result = removePageNode(root, blockId);
+        return result.ok ? result.root : root;
+    });
+}
+/** Insert a freshly-minted copy of `blockId` immediately after it (same parent);
+ * `mint` supplies the fresh-id copy (an app concern, not a tree concern). */
+export function duplicateNode(page, blockId, mint) {
+    const original = findNode(page, blockId);
+    if (!original)
+        return page;
+    const copy = mint(original);
+    return withRoot(page, (root) => {
+        const parentId = parentIdOf(root, blockId);
+        if (parentId === undefined)
+            return root;
+        const result = insertPageNode(root, { parentId, afterId: blockId }, copy);
+        return result.ok ? result.root : root;
+    });
+}
+/** Patch a block's props (plain values wrapped as literals). */
+export function patchNodeProps(page, blockId, patch) {
+    return withRoot(page, (root) => {
+        const props = {};
+        for (const [key, value] of Object.entries(patch))
+            props[key] = literal(value);
+        const result = patchPageBlockProps(root, blockId, props);
+        return result.ok ? result.root : root;
+    });
+}
+/**
+ * Replace a `layout.columns` block's whole column structure from the layout
+ * editor's `LayoutColumnView[]` (a geometry/content edit). Rebuilds the column
+ * `children` + `grid` literal via `withColumns` (D1); routing this through the
+ * generic prop-patch would not touch `children`. Layout blocks never nest, so
+ * the target is always top-level — no tree walk beyond the top row is needed.
+ */
+export function setLayoutColumns(page, blockId, columns) {
+    return withRoot(page, (root) => root.map((node) => node.id === blockId && node.kind === "block" ? withColumns(node, columns) : node));
+}
+/** Replace a block in place with another (kept for the swap/replace drop
+ * choices). Preserves the target's slot; the replacement carries its own id. */
+export function replaceNode(page, blockId, replacement) {
+    return withRoot(page, (root) => {
+        const parentId = parentIdOf(root, blockId);
+        if (parentId === undefined)
+            return root;
+        const index = childIdsOf(root, parentId).indexOf(blockId);
+        const removed = removePageNode(root, blockId);
+        if (!removed.ok)
+            return root;
+        // Address the freed slot against the post-removal sibling list.
+        const anchor = anchorForIndex(childIdsOf(removed.root, parentId), index);
+        const inserted = insertPageNode(removed.root, { parentId, ...anchor }, replacement);
+        return inserted.ok ? inserted.root : root;
+    });
+}
+/**
+ * Substitute the node at `blockId` in place with `replacement`, keeping its
+ * slot (position + parent) via `page-tree.ts`'s `replacePageNode`. A no-op when
+ * the block is not on this page (so it can be applied to every page
+ * unconditionally); the cross-page "replace" drop composes it.
+ */
+export function substituteNode(page, blockId, replacement) {
+    return withRoot(page, (root) => {
+        if (!findPageNode(root, blockId))
+            return root;
+        const result = replacePageNode(root, blockId, replacement);
+        return result.ok ? result.root : root;
+    });
+}
+/**
+ * Swap two blocks' positions within one page via `page-tree.ts`'s single-pass
+ * `swapPageNodes` (matches each against its ORIGINAL id, so it never
+ * double-applies the way two sequential substitutes would). A no-op unless both
+ * ids live on this page — the cross-page swap handles the split case itself.
+ */
+export function swapNodes(page, aId, bId) {
+    return withRoot(page, (root) => {
+        if (!findPageNode(root, aId) || !findPageNode(root, bId))
+            return root;
+        const result = swapPageNodes(root, aId, bId);
+        return result.ok ? result.root : root;
+    });
+}
+/**
+ * Remove the node at `removeId` and, in the same pass, substitute the node at
+ * `keepAtId` with `replacement` — the "replace" drop choice (source takes the
+ * target's slot, source's own slot is dropped). A no-op unless both ids live on
+ * this page, so it is safe to apply to every page. */
+export function pullNodeInto(page, removeId, keepAtId, replacement) {
+    return withRoot(page, (root) => {
+        if (!findPageNode(root, removeId) || !findPageNode(root, keepAtId))
+            return root;
+        const removed = removePageNode(root, removeId);
+        if (!removed.ok)
+            return root;
+        const substituted = replacePageNode(removed.root, keepAtId, replacement);
+        return substituted.ok ? substituted.root : root;
+    });
+}
+/** Every block id under a subtree, in document order (top-level then nested). */
+export function collectBlockIds(root) {
+    const ids = [];
+    const walk = (nodes) => {
+        for (const node of nodes) {
+            if (node.kind !== "block")
+                continue;
+            ids.push(node.id);
+            if (node.children?.length)
+                walk(node.children);
+        }
+    };
+    walk(root);
+    return ids;
+}
+//# sourceMappingURL=page-tree-bridge.js.map

package/dist/model/page-tree-bridge.js.map

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

package/dist/model/prop-access.d.ts

@@ -0,0 +1,69 @@
+import type { BlockNode, PropValue } from "@batterai/bind-core";
+/** Reserved portable block prop for Canvas design settings. */
+export declare const DESIGN_PROP = "design";
+/**
+ * The ONE block-prop accessor. Every block-prop read in the app routes through
+ * `readProp` and every write through `writeProp`, so the canonical
+ * `BlockNode.props` (`PropValue` union) has a single bridge to the plain
+ * values the UI works with. A missed direct read renders `[object Object]`; a
+ * missed direct write silently drops an edit — hence the grep gate on
+ * `.props.<key>`.
+ *
+ * The in-memory tree is now canonical (Phase 2 keystone): a page's `root` is
+ * `PageNode[]` with props as `PropValue`. The accessor stays
+ * representation-tolerant — it unwraps a `PropValue` wrapper AND returns a raw
+ * value verbatim — so a legacy raw block (e.g. one still crossing the wire, or
+ * a fixture) reads through the very same function.
+ */
+/** A block whose props are readable by the accessor. Canonically a
+ * `BlockNode`; a raw `{ props }` record is also accepted so legacy/wire blocks
+ * read identically. */
+export type PropBearer = {
+    readonly props: Readonly<Record<string, unknown>>;
+};
+/**
+ * Unwrap a stored prop to its plain value. Mirrors proof's `propDisplayValue`
+ * (apps/proof/src/editor-app.ts): a literal yields its value; a rich value
+ * yields its plain text; a binding yields "" (unresolved at the editor edge —
+ * live resolution happens through the resolver, never here). A raw value is
+ * returned verbatim. This is a DATA accessor, not a renderer: it never escapes
+ * or sanitizes — the single escaping boundary stays at the render sink
+ * (EditableText display / bind-core `escape.ts`), preserving invariant S1.
+ */
+export declare function unwrapProp(stored: unknown): unknown;
+/** Wrap a plain value as a `{kind:"literal"}` PropValue (ingest direction). */
+export declare function literal<T = unknown>(value: T): PropValue<T>;
+/** Wrap a whole raw prop record as `{kind:"literal"}` PropValues — the
+ * canonical props for a `BlockNode` built from a raw source (block definition
+ * defaults, a preset, a wire block). */
+export declare function literalProps(raw: Readonly<Record<string, unknown>>): Record<string, PropValue>;
+/**
+ * Unwrap a `BlockNode`'s whole prop record to plain values — the multi-key
+ * form of `readProp`, for the few consumers that need a raw props object
+ * (`@batterai/block-sdk`'s `BlockConfig.props`, the login-copy reader, the
+ * unknown-block JSON dump, the collection-list config reader).
+ */
+export declare function rawProps(block: PropBearer): Record<string, unknown>;
+/**
+ * Read a block prop by key — the ONE read accessor. Returns the plain value
+ * (unwrapped from a `PropValue`, or a raw value verbatim), exactly as the
+ * pre-convergence `block.props[key]` did, so every downstream guard
+ * (`asString`, `typeof x === "string"`, `Array.isArray`, …) keeps working
+ * unchanged.
+ */
+export declare function readProp(block: PropBearer | null | undefined, key: string): unknown;
+/**
+ * Write a block prop by key — the ONE write accessor. Returns a NEW `BlockNode`
+ * with `props[key]` set to a `{kind:"literal"}` PropValue (immutable update;
+ * the input is not mutated). `undefined` deletes the key.
+ */
+export declare function writeProp(block: BlockNode, key: string, value: unknown): BlockNode;
+/** Merge a patch of plain values in one immutable write — the multi-key form of
+ * `writeProp`, used by the inspector's props-patch path. Each value is wrapped
+ * as a literal `PropValue`; `undefined` deletes the key. */
+export declare function writeProps(block: BlockNode, patch: Record<string, unknown>): BlockNode;
+/** Whether a block carries a value for `key` (presence, not truthiness) —
+ * routes the `"key" in block.props` / `hasOwnProperty` checks through the
+ * accessor without collapsing a stored empty string to "absent". */
+export declare function hasProp(block: PropBearer, key: string): boolean;
+//# sourceMappingURL=prop-access.d.ts.map

package/dist/model/prop-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prop-access.d.ts","sourceRoot":"","sources":["../../src/model/prop-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE,+DAA+D;AAC/D,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AAEH;;uBAEuB;AACvB,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,CAAC;AAQ/E;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CASnD;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAE3D;AAED;;wCAEwC;AACxC,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAI9F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAInE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGnF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAElF;AAED;;4DAE4D;AAC5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOtF;AAED;;oEAEoE;AACpE,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/D"}