@elytracms/studio 0.0.92 → 0.0.93

package/dist/components/builder/builder-store.d.ts

@@ -1,6 +1,7 @@
 import type { ReactNode } from 'react';
-import type { ComponentNode, InsertTarget, LayoutContainerIds, PropValue } from '@elytracms/core/project-graph';
+import type { AllowList, ComponentLookup, ComponentNode, InsertTarget, LayoutContainerIds, PlacementScope, PlacementVerdict, PropValue } from '@elytracms/core/project-graph';
 import type { IdFactory } from '@elytracms/core/persistence';
+import type { PreservedItem } from './canvas-runs.js';
 /**
  * A canvas preview-width key (EC-250): `'full'` (unconstrained) or a configured
  * breakpoint name (`'sm'`, `'md'`, …). Dynamic because the set is sourced from
@@ -93,17 +94,72 @@ export type BuilderAction = {
     type: 'removeProp';
     id: string;
     name: string;
+}
+/** EC-584: the editor dismissed the visible refusal ({@link BuilderState.refusal}). */
+ | {
+    type: 'clearRefusal';
+}
+/**
+ * EC-549 — select a typography RUN by its key (`canvas-runs.ts`: the index of its
+ * first preserved item); `null` clears it. A run and a node are never both selected.
+ */
+ | {
+    type: 'selectRun';
+    run: number | null;
+}
+/** EC-549 — delete a typography run: a real, undoable edit of the preserved list. */
+ | {
+    type: 'removeRun';
+    run: number;
+}
+/**
+ * EC-549 — replace a run's typography with `content` (the inspector's rich-text
+ * editor on that run; consecutive same-key edits coalesce into one undo step). Empty
+ * `content` deletes the run.
+ */
+ | {
+    type: 'setRun';
+    run: number;
+    content: readonly unknown[];
+    coalesceKey?: string;
 };
+/** The structural actions the placement judge rules on (EC-584): every node that enters or moves. */
+export type PlacingAction = Extract<BuilderAction, {
+    type: 'insert' | 'replace' | 'move' | 'wrap' | 'duplicate';
+}>;
+/** A refused placement (EC-584): the judge's verdict and the action it refused. */
+export interface PlacementRefusal {
+    action: PlacingAction['type'];
+    verdict: PlacementVerdict;
+}
+/**
+ * One history entry (EC-549): the component tree AND the preserved typography — so a
+ * run's deletion or edit is undone exactly like a block's.
+ */
+export interface CanvasSnapshot {
+    root: ComponentNode;
+    preserved: readonly PreservedItem[];
+}
 export interface BuilderState {
     /**
      * The edited composition: one root-bearing component tree (EC-287). The canvas
      * wraps a page document's `body` blocks into a synthetic root and edits it
-     * directly — no page/layout wrapper. Undo/redo snapshot this root.
+     * directly — no page/layout wrapper. Undo/redo snapshot it with the preserved
+     * typography ({@link CanvasSnapshot}).
      */
-    past: ComponentNode[];
+    past: CanvasSnapshot[];
     present: ComponentNode;
-    future: ComponentNode[];
+    future: CanvasSnapshot[];
+    /**
+     * EC-549 — the field value's typography items (no ids, EC-500 D1), each anchored by
+     * how many component roots preceded it (`componentPrefix`); the field value is
+     * `mergeBlockRoots(present's roots, preserved)`. In the store, so selecting,
+     * deleting and editing a run is a real action with truthful undo.
+     */
+    preserved: readonly PreservedItem[];
     selectedId: string | null;
+    /** EC-549 — the selected typography run's key, or `null` (exclusive with {@link selectedId}). */
+    selectedRun: number | null;
     hoveredId: string | null;
     viewport: Viewport;
     /**
@@ -121,14 +177,36 @@ export interface BuilderState {
      * Stack/Grid, and the Grid the wrap gesture builds. No hardcoded engine id.
      */
     layout: LayoutContainerIds;
+    /**
+     * EC-584 — the last REFUSED placement, with its reason: the reducer judged an
+     * `insert`/`replace`/`move`/`wrap`/`duplicate` against the field and slot
+     * vocabularies and canvas eligibility (the core placement judge) and left the
+     * composition unchanged. Transient — the next edit, selection, undo or redo clears
+     * it — and never silent: the canvas shows it (`PlacementRefusalNotice`). A refused
+     * action changes no tree, so it adds no history entry and emits no canvas patch.
+     */
+    refusal: PlacementRefusal | null;
 }
 type Action = BuilderAction;
 /**
- * The pure state transition. Exported (with `initialBuilderState`) for unit
- * tests — gesture determinism and normalization lockstep are reducer-level
- * properties, not render behavior.
+ * The builder's pure state transition, CONSTRUCTED with the placement scope it judges
+ * by (EC-584, owner-ratified 4a): the field's effective top-level vocabulary and the
+ * manifest lookup. The scope is static per store and deliberately not reducer STATE
+ * (it is the declaration the tree is judged against, not part of the tree) — the
+ * reducer RECEIVES it, so there is no `(state, action)` to call without it.
+ *
+ * Every structural action that places a node — `insert`, `replace`, `move`, `wrap`,
+ * `duplicate` — runs the ONE core judge (`subtreePlacementRefusal`) over every node
+ * that enters or moves, BEFORE committing. A refusal returns the composition
+ * unchanged, with the verdict in {@link BuilderState.refusal}: so no gesture — a
+ * forgotten pre-check, promote, detach, a fixture's `slotChildren`, a server-only
+ * paste — can place what the field, a slot or canvas eligibility forbids, and the
+ * publish gate (which calls the same judge) cannot disagree with the canvas.
+ *
+ * Exported (with `initialBuilderState`) for unit tests — gesture determinism and
+ * normalization lockstep are reducer-level properties, not render behavior.
  */
-export declare function builderReducer(state: BuilderState, action: Action): BuilderState;
+export declare function createBuilderReducer(placement: PlacementScope): (state: BuilderState, action: Action) => BuilderState;
 /**
  * The composition FIELD whose value the store edits (EC-554). Static for the
  * store's lifetime and deliberately NOT reducer state: it is the declaration the
@@ -142,12 +220,11 @@ export interface CompositionFieldScope {
     /** The field's display label — what a refusal notice names (e.g. "Canvas"). */
     label: string;
     /**
-     * The field's top-level `allow` vocabulary (EC-188; a closed set per EC-544),
-     * or `undefined` when the field declares none (any registered component).
-     * Applied only through `fieldAllowAt` (`lib/dnd/drop-rules`), which scopes it
-     * to direct children of the composition root.
+     * The field's EFFECTIVE top-level vocabulary (EC-188; EC-584 — `fieldAllowList(field)`:
+     * its `allow`, else the `blocks` type's default). The judge applies it only to
+     * direct children of the composition root (`allowAt`, core `placement.ts`).
      */
-    allow: readonly string[] | undefined;
+    allow: AllowList;
 }
 export interface BuilderStore extends BuilderState {
     canUndo: boolean;
@@ -155,10 +232,18 @@ export interface BuilderStore extends BuilderState {
     selectedNode: ComponentNode | null;
     /** The composition field being edited (EC-554) — see {@link CompositionFieldScope}. */
     field: CompositionFieldScope;
+    /**
+     * EC-584 — what the reducer judges every placement by: the manifest lookup and the
+     * field's vocabulary. The gestures' own pre-checks (drag-and-drop, paste, the insert
+     * offer, the reuse preflight) read the SAME scope, so an indicator and the sink agree.
+     */
+    placement: PlacementScope;
     dispatch: (action: Action) => void;
 }
 declare const useBuilder: () => BuilderStore;
-export declare function initialBuilderState(composition: ComponentNode, layout: LayoutContainerIds, newId: IdFactory): BuilderState;
+export declare function initialBuilderState(composition: ComponentNode, layout: LayoutContainerIds, newId: IdFactory, 
+/** EC-549 — the field value's typography items with their anchors (`splitBlockRoots`). */
+preserved?: readonly PreservedItem[]): BuilderState;
 /**
  * Undo/redo design (EC-141): the history stack is *UI state* — an in-memory
  * stack of composition-root snapshots. EC-287 retired the DB-resident project
@@ -167,11 +252,15 @@ export declare function initialBuilderState(composition: ComponentNode, layout:
  * its committed composition into the open CMS document via `onChange`
  * (`composition-field-editor`); the document's own Save persists it as content.
  */
-export declare function BuilderProvider({ composition, field, layout, idFactory, children, }: {
+export declare function BuilderProvider({ composition, preserved, field, components, layout, idFactory, children, }: {
     /** The composition root to edit (the composition-field editor's synthetic root). */
     composition: ComponentNode;
+    /** EC-549 — the field value's typography items (`splitBlockRoots(value).preserved`). */
+    preserved?: readonly PreservedItem[];
     /** The field the composition is the value of (EC-554) — required, never defaulted. */
     field: CompositionFieldScope;
+    /** The manifest lookup the placement judge reads (EC-584, `registry.lookup`) — required. */
+    components: ComponentLookup;
     /** The layout-role component ids (EC-591, `ComponentRegistry.layout`) — required. */
     layout: LayoutContainerIds;
     /**

package/dist/components/builder/builder-store.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo, useReducer, useState } from 'react';
-import { cloneWithNewIds, duplicateNode, getNode, getParentInfo, insertNode, moveNode, normalizeContainers, removeNode, removeNodeProp, reorderNode, replaceNode, setNodeProp, } from '@elytracms/core/project-graph';
+import { DEFAULT_SLOT, cloneWithNewIds, duplicateNode, getNode, getParentInfo, gridContainerNode, insertNode, moveNode, normalizeContainers, removeNode, removeNodeProp, reorderNode, replaceNode, replacePlacementRefusal, setNodeProp, subtreePlacementRefusal, } from '@elytracms/core/project-graph';
 import { createUuidIdFactory } from '@elytracms/core/persistence';
-import { applyWrap } from '@elytracms/studio/lib/dnd/drop-rules';
+import { WRAP_GRID_OPTIONS, applyWrap } from '@elytracms/studio/lib/dnd/drop-rules';
+import { replaceRun, runByKey } from './canvas-runs.js';
 import { createRequiredContext } from '@elytracms/studio/lib/required-context';
 const HISTORY_LIMIT = 100;
 /**
@@ -19,62 +20,128 @@ const HISTORY_LIMIT = 100;
 function commit(state, root, opts = {}) {
     const normalized = normalizeContainers(root, state.layout);
     const present = normalized;
+    const preserved = opts.preserved ?? state.preserved;
     const coalesce = opts.coalesceKey != null && opts.coalesceKey === state.lastCoalesceKey;
     // Normalization can dissolve the node a caller wanted selected (e.g. the
     // parent container of a removed child) — selection never points at a ghost.
     const desired = opts.selectedId !== undefined ? opts.selectedId : state.selectedId;
     const selectedId = desired !== null && getNode(normalized, desired) ? desired : null;
+    const desiredRun = opts.selectedRun !== undefined ? opts.selectedRun : state.selectedRun;
     return {
         ...state,
-        past: coalesce ? state.past : [...state.past, state.present].slice(-HISTORY_LIMIT),
+        past: coalesce ? state.past : [...state.past, snapshotOf(state)].slice(-HISTORY_LIMIT),
         present,
+        preserved,
         future: [],
         lastCoalesceKey: opts.coalesceKey ?? null,
         selectedId,
+        selectedRun: liveRun(present, preserved, desiredRun),
+        refusal: null,
     };
 }
+function snapshotOf(state) {
+    return { root: state.present, preserved: state.preserved };
+}
+/** The run key if that run still exists in this state, else `null` (never a ghost selection). */
+function liveRun(root, preserved, run) {
+    if (run === null)
+        return null;
+    return runByKey(rootCount(root), preserved, run) ? run : null;
+}
+/** How many component roots the composition has (the synthetic root's children). */
+function rootCount(root) {
+    return root.slots?.[DEFAULT_SLOT]?.length ?? 0;
+}
+/** Restore a history entry (undo/redo), keeping a selection only where it still exists. */
+function restore(state, to, past, future) {
+    return {
+        ...state,
+        past,
+        present: to.root,
+        preserved: to.preserved,
+        future,
+        lastCoalesceKey: null,
+        selectedId: getNode(to.root, state.selectedId ?? '') ? state.selectedId : null,
+        selectedRun: liveRun(to.root, to.preserved, state.selectedRun),
+        refusal: null,
+    };
+}
+/** Leave the composition untouched and say why (EC-584 — never a silent no-op). */
+function refuse(state, action, verdict) {
+    return { ...state, refusal: { action: action.type, verdict } };
+}
 /**
- * The pure state transition. Exported (with `initialBuilderState`) for unit
- * tests — gesture determinism and normalization lockstep are reducer-level
- * properties, not render behavior.
+ * The builder's pure state transition, CONSTRUCTED with the placement scope it judges
+ * by (EC-584, owner-ratified 4a): the field's effective top-level vocabulary and the
+ * manifest lookup. The scope is static per store and deliberately not reducer STATE
+ * (it is the declaration the tree is judged against, not part of the tree) — the
+ * reducer RECEIVES it, so there is no `(state, action)` to call without it.
+ *
+ * Every structural action that places a node — `insert`, `replace`, `move`, `wrap`,
+ * `duplicate` — runs the ONE core judge (`subtreePlacementRefusal`) over every node
+ * that enters or moves, BEFORE committing. A refusal returns the composition
+ * unchanged, with the verdict in {@link BuilderState.refusal}: so no gesture — a
+ * forgotten pre-check, promote, detach, a fixture's `slotChildren`, a server-only
+ * paste — can place what the field, a slot or canvas eligibility forbids, and the
+ * publish gate (which calls the same judge) cannot disagree with the canvas.
+ *
+ * Exported (with `initialBuilderState`) for unit tests — gesture determinism and
+ * normalization lockstep are reducer-level properties, not render behavior.
  */
-export function builderReducer(state, action) {
+export function createBuilderReducer(placement) {
+    return (state, action) => transition(state, action, placement);
+}
+function transition(state, action, placement) {
     const root = state.present;
     switch (action.type) {
         case 'select':
-            return { ...state, selectedId: action.id };
+            return { ...state, selectedId: action.id, selectedRun: action.id === null ? state.selectedRun : null, refusal: null };
+        case 'selectRun':
+            return {
+                ...state,
+                selectedRun: liveRun(root, state.preserved, action.run),
+                selectedId: action.run === null ? state.selectedId : null,
+                refusal: null,
+            };
+        case 'removeRun': {
+            const run = runByKey(rootCount(root), state.preserved, action.run);
+            if (!run)
+                return state;
+            return commit(state, root, { preserved: replaceRun(state.preserved, run, []), selectedRun: null });
+        }
+        case 'setRun': {
+            const run = runByKey(rootCount(root), state.preserved, action.run);
+            if (!run)
+                return state;
+            return commit(state, root, {
+                preserved: replaceRun(state.preserved, run, action.content),
+                coalesceKey: action.coalesceKey,
+                selectedRun: action.content.length > 0 ? action.run : null,
+            });
+        }
         case 'hover':
             return state.hoveredId === action.id ? state : { ...state, hoveredId: action.id };
         case 'viewport':
             return { ...state, viewport: action.viewport };
+        case 'clearRefusal':
+            return state.refusal === null ? state : { ...state, refusal: null };
         case 'undo': {
             const prev = state.past.at(-1);
             if (!prev)
                 return state;
-            return {
-                ...state,
-                past: state.past.slice(0, -1),
-                present: prev,
-                future: [state.present, ...state.future],
-                lastCoalesceKey: null,
-                selectedId: getNode(prev, state.selectedId ?? '') ? state.selectedId : null,
-            };
+            return restore(state, prev, state.past.slice(0, -1), [snapshotOf(state), ...state.future]);
         }
         case 'redo': {
             const next = state.future[0];
             if (!next)
                 return state;
-            return {
-                ...state,
-                past: [...state.past, state.present],
-                present: next,
-                future: state.future.slice(1),
-                lastCoalesceKey: null,
-                selectedId: getNode(next, state.selectedId ?? '') ? state.selectedId : null,
-            };
+            return restore(state, next, [...state.past, snapshotOf(state)], state.future.slice(1));
         }
         case 'insert': {
             const node = action.minted ? action.node : cloneWithNewIds(action.node, state.newId);
+            const verdict = subtreePlacementRefusal(root, node, landingOf(action.target), placement);
+            if (verdict)
+                return refuse(state, action, verdict);
             const next = insertNode(root, action.target, node);
             return commit(state, next, {
                 selectedId: action.select === false ? state.selectedId : node.id,
@@ -87,18 +154,45 @@ export function builderReducer(state, action) {
             return commit(state, next, { selectedId });
         }
         case 'duplicate': {
+            // The copy (and every node of its subtree) ENTERS beside the original.
+            const info = getParentInfo(root, action.id);
+            const source = getNode(root, action.id);
+            if (info && source) {
+                const verdict = subtreePlacementRefusal(root, source, { parentId: info.parent.id, slot: info.slot }, placement);
+                if (verdict)
+                    return refuse(state, action, verdict);
+            }
             const { root: next, newId } = duplicateNode(root, action.id, state.newId);
             return commit(state, next, { selectedId: newId ?? state.selectedId });
         }
         case 'reorder':
+            // Same parent, same slot: the placement does not change — nothing to judge.
             return commit(state, reorderNode(root, action.id, action.delta));
-        case 'move':
+        case 'move': {
+            // A node that changes parent or slot lands somewhere new (its descendants keep
+            // their own slots, so only it is judged); a move within its own slot is a
+            // reorder and leaves the placement as it was.
+            const info = getParentInfo(root, action.id);
+            const node = getNode(root, action.id);
+            const relocates = !info || info.parent.id !== action.target.parentId || info.slot !== action.target.slot;
+            if (node && relocates) {
+                const verdict = subtreePlacementRefusal(root, withoutSlots(node), landingOf(action.target), placement);
+                if (verdict)
+                    return refuse(state, action, verdict);
+            }
             return commit(state, moveNode(root, action.id, action.target));
+        }
         case 'replace': {
             // Mint fresh ids for the incoming nodes (page-local namespace) so a detached
             // copy never collides with the page, and a promoted block's source subtree
             // (kept for the new reusable document) stays untouched.
             const cloned = action.nodes.map((n) => cloneWithNewIds(n, state.newId));
+            // EC-560: promote (one embed) and detach (the reusable's content) land where the
+            // replaced node was — judged there like any insert (the reuse preflight asks the
+            // same `replacePlacementRefusal` before any side effect).
+            const verdict = replacePlacementRefusal(root, action.id, cloned, placement);
+            if (verdict)
+                return refuse(state, action, verdict);
             const next = replaceNode(root, action.id, cloned);
             if (next === root)
                 return state; // root or absent id — no-op
@@ -119,6 +213,19 @@ export function builderReducer(state, action) {
             const gridComponentId = state.layout.grid;
             if (gridComponentId === undefined)
                 return state;
+            // EC-584: the Grid lands where the reference is; the reference and the partner
+            // land in the Grid's column slot. A moved partner keeps its own subtree (only it
+            // relocates); a new one (a blocks-panel tile) enters whole.
+            const reference = getNode(root, action.referenceId);
+            const referenceInfo = getParentInfo(root, action.referenceId);
+            const partnerNode = partner.kind === 'node' ? getNode(root, partner.nodeId) : partner.node;
+            if (reference && referenceInfo && partnerNode) {
+                const columns = [withoutSlots(reference), partner.kind === 'node' ? withoutSlots(partnerNode) : partnerNode];
+                const probe = gridContainerNode(gridComponentId, 'wrap', WRAP_GRID_OPTIONS, columns);
+                const verdict = subtreePlacementRefusal(root, probe, { parentId: referenceInfo.parent.id, slot: referenceInfo.slot }, placement);
+                if (verdict)
+                    return refuse(state, action, verdict);
+            }
             const containerId = state.newId();
             const wrapped = applyWrap({
                 root,
@@ -142,8 +249,18 @@ export function builderReducer(state, action) {
             return state;
     }
 }
+function landingOf(target) {
+    return { parentId: target.parentId, slot: target.slot };
+}
+/** The node alone — a move relocates it; its descendants keep their own slots. */
+function withoutSlots(node) {
+    const { slots: _slots, ...rest } = node;
+    return rest;
+}
 const { Context: BuilderContext, useRequired: useBuilder } = createRequiredContext('Builder');
-export function initialBuilderState(composition, layout, newId) {
+export function initialBuilderState(composition, layout, newId, 
+/** EC-549 — the field value's typography items with their anchors (`splitBlockRoots`). */
+preserved = []) {
     // Start container-normal (idempotent on healthy trees) so the session and the
     // lifted baseline agree from the first edit.
     const present = normalizeContainers(composition, layout);
@@ -151,7 +268,9 @@ export function initialBuilderState(composition, layout, newId) {
         past: [],
         present,
         future: [],
+        preserved,
         selectedId: present.id,
+        selectedRun: null,
         hoveredId: null,
         viewport: 'full',
         // EC-578: fresh ids come from the injected factory — never a counter seeded past
@@ -159,6 +278,7 @@ export function initialBuilderState(composition, layout, newId) {
         newId,
         lastCoalesceKey: null,
         layout,
+        refusal: null,
     };
 }
 /**
@@ -169,13 +289,17 @@ export function initialBuilderState(composition, layout, newId) {
  * its committed composition into the open CMS document via `onChange`
  * (`composition-field-editor`); the document's own Save persists it as content.
  */
-export function BuilderProvider({ composition, field, layout, idFactory, children, }) {
+export function BuilderProvider({ composition, preserved, field, components, layout, idFactory, children, }) {
     const [newId] = useState(() => idFactory ?? createUuidIdFactory());
+    // EC-584: the reducer is constructed ONCE with the scope it judges by — the field
+    // and the lookup are static for the store's lifetime (a remount re-reads them).
+    const [placement] = useState(() => ({ components, fieldAllow: field.allow }));
+    const [reducer] = useState(() => createBuilderReducer(placement));
     // EC-287: nothing persists a graph — committed edits are lifted into the CMS
     // document by the composition-field editor's `onChange`. `useReducer` drives the
-    // pure `builderReducer` (consecutive dispatches in one gesture apply in sequence);
-    // the store below decorates the state with the derived undo/redo + selection flags.
-    const [state, dispatch] = useReducer(builderReducer, { composition, layout, newId }, (init) => initialBuilderState(init.composition, init.layout, init.newId));
+    // pure reducer (consecutive dispatches in one gesture apply in sequence); the
+    // store below decorates the state with the derived undo/redo + selection flags.
+    const [state, dispatch] = useReducer(reducer, { composition, layout, newId, preserved }, (init) => initialBuilderState(init.composition, init.layout, init.newId, init.preserved));
     const store = useMemo(() => {
         const selectedNode = state.selectedId
             ? (getNode(state.present, state.selectedId) ?? null)
@@ -186,9 +310,10 @@ export function BuilderProvider({ composition, field, layout, idFactory, childre
             canRedo: state.future.length > 0,
             selectedNode,
             field,
+            placement,
             dispatch,
         };
-    }, [state, field, dispatch]);
+    }, [state, field, placement, dispatch]);
     return _jsx(BuilderContext.Provider, { value: store, children: children });
 }
 export { useBuilder };

package/dist/components/builder/builder-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder-store.js","sourceRoot":"","sources":["../../../src/components/builder/builder-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useReducer, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport {\n  cloneWithNewIds,\n  duplicateNode,\n  getNode,\n  getParentInfo,\n  insertNode,\n  moveNode,\n  normalizeContainers,\n  removeNode,\n  removeNodeProp,\n  reorderNode,\n  replaceNode,\n  setNodeProp,\n} from '@elytracms/core/project-graph'\nimport type { ComponentNode, InsertTarget, LayoutContainerIds, PropValue } from '@elytracms/core/project-graph'\nimport { createUuidIdFactory } from '@elytracms/core/persistence'\nimport type { IdFactory } from '@elytracms/core/persistence'\nimport { applyWrap } from '@elytracms/studio/lib/dnd/drop-rules'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\nconst HISTORY_LIMIT = 100\n\n/**\n * A canvas preview-width key (EC-250): `'full'` (unconstrained) or a configured\n * breakpoint name (`'sm'`, `'md'`, …). Dynamic because the set is sourced from\n * the consuming site's breakpoints, so it is a string, not a fixed union — the\n * switcher resolves the available options via {@link resolveCanvasViewports}.\n */\nexport type Viewport = string\n\n/**\n * The builder store's action union. EC-287 retired the DB-resident project graph\n * and its persistence mirror, so these actions are pure in-memory editor state —\n * no action maps to a persisted `graph.*` command anymore. The block-field editor\n * lifts committed edits into the CMS document via `onChange`\n * (`composition-field-editor`); nothing persists a graph.\n */\nexport type BuilderAction =\n  | { type: 'select'; id: string | null }\n  | { type: 'hover'; id: string | null }\n  | { type: 'viewport'; viewport: Viewport }\n  | { type: 'undo' }\n  | { type: 'redo' }\n  /**\n   * Insert a node (its subtree re-id'd from the store's id factory). `minted` — the\n   * node ALREADY carries fresh ids from the same factory (the paste path mints first\n   * so its issue deep links name exactly the ids that land); the reducer then inserts\n   * it as given.\n   */\n  | { type: 'insert'; target: InsertTarget; node: ComponentNode; select?: boolean; minted?: true }\n  | { type: 'remove'; id: string }\n  | { type: 'duplicate'; id: string }\n  | { type: 'reorder'; id: string; delta: -1 | 1 }\n  | { type: 'move'; id: string; target: InsertTarget }\n  /**\n   * EC-282 reuse gesture: replace a node with zero or more nodes at its\n   * position (clone-with-fresh-ids, like `insert`). Promote → 1 embed node;\n   * detach → the referenced element's inline blocks. One atomic structural\n   * edit, one undo step.\n   */\n  | { type: 'replace'; id: string; nodes: ComponentNode[]; select?: boolean }\n  /**\n   * EC-162 layout gesture: wrap the reference node and the dragged subject in\n   * a two-column Grid container as ONE atomic structural edit (one undo step).\n   */\n  | {\n      type: 'wrap'\n      referenceId: string\n      side: 'left' | 'right'\n      subject: { kind: 'node'; nodeId: string } | { kind: 'component'; node: ComponentNode }\n    }\n  | { type: 'setProp'; id: string; name: string; value: PropValue; coalesceKey?: string }\n  | { type: 'removeProp'; id: string; name: string }\n\nexport interface BuilderState {\n  /**\n   * The edited composition: one root-bearing component tree (EC-287). The canvas\n   * wraps a page document's `body` blocks into a synthetic root and edits it\n   * directly — no page/layout wrapper. Undo/redo snapshot this root.\n   */\n  past: ComponentNode[]\n  present: ComponentNode\n  future: ComponentNode[]\n  selectedId: string | null\n  hoveredId: string | null\n  viewport: Viewport\n  /**\n   * EC-578 / EC-595 A2 — THE node-id factory (injected; UUIDs in the studio, a\n   * sequential factory in fixtures). It replaced the per-session `node-<n>` counter,\n   * which two sessions editing one page advanced identically — both minted the same\n   * next id, a `duplicate-node-id` on the second save. Stored ids are untouched.\n   */\n  newId: IdFactory\n  /** Coalescing key of the last edit (consecutive same-key edits don't stack history). */\n  lastCoalesceKey: string | null\n  /**\n   * The components filling the layout roles (EC-591, `ComponentRegistry.layout`),\n   * fixed for the store's lifetime: which nodes container normalization treats as\n   * Stack/Grid, and the Grid the wrap gesture builds. No hardcoded engine id.\n   */\n  layout: LayoutContainerIds\n}\n\ntype Action = BuilderAction\n\n/**\n * Push a new graph onto history, coalescing consecutive edits with the same key.\n *\n * Every commit normalizes layout containers (EC-162 ledger fix): the\n * operations layer normalizes every persisted `graph.*` write (EC-161), so\n * the optimistic working graph must apply the same `normalizeContainers` pass\n * or the UI state diverges from the persisted revision after\n * container-emptying moves/removes. The mirrored command stays un-normalized\n * (`graphInvocationFor` sees the raw action); both sides normalize\n * identically, so they land on the same graph.\n */\nfunction commit(\n  state: BuilderState,\n  root: ComponentNode,\n  opts: { coalesceKey?: string; selectedId?: string | null } = {},\n): BuilderState {\n  const normalized = normalizeContainers(root, state.layout)\n  const present = normalized\n  const coalesce = opts.coalesceKey != null && opts.coalesceKey === state.lastCoalesceKey\n  // Normalization can dissolve the node a caller wanted selected (e.g. the\n  // parent container of a removed child) — selection never points at a ghost.\n  const desired = opts.selectedId !== undefined ? opts.selectedId : state.selectedId\n  const selectedId = desired !== null && getNode(normalized, desired) ? desired : null\n  return {\n    ...state,\n    past: coalesce ? state.past : [...state.past, state.present].slice(-HISTORY_LIMIT),\n    present,\n    future: [],\n    lastCoalesceKey: opts.coalesceKey ?? null,\n    selectedId,\n  }\n}\n\n/**\n * The pure state transition. Exported (with `initialBuilderState`) for unit\n * tests — gesture determinism and normalization lockstep are reducer-level\n * properties, not render behavior.\n */\nexport function builderReducer(state: BuilderState, action: Action): BuilderState {\n  const root = state.present\n  switch (action.type) {\n    case 'select':\n      return { ...state, selectedId: action.id }\n    case 'hover':\n      return state.hoveredId === action.id ? state : { ...state, hoveredId: action.id }\n    case 'viewport':\n      return { ...state, viewport: action.viewport }\n\n    case 'undo': {\n      const prev = state.past.at(-1)\n      if (!prev) return state\n      return {\n        ...state,\n        past: state.past.slice(0, -1),\n        present: prev,\n        future: [state.present, ...state.future],\n        lastCoalesceKey: null,\n        selectedId: getNode(prev, state.selectedId ?? '') ? state.selectedId : null,\n      }\n    }\n    case 'redo': {\n      const next = state.future[0]\n      if (!next) return state\n      return {\n        ...state,\n        past: [...state.past, state.present],\n        present: next,\n        future: state.future.slice(1),\n        lastCoalesceKey: null,\n        selectedId: getNode(next, state.selectedId ?? '') ? state.selectedId : null,\n      }\n    }\n\n    case 'insert': {\n      const node = action.minted ? action.node : cloneWithNewIds(action.node, state.newId)\n      const next = insertNode(root, action.target, node)\n      return commit(state, next, {\n        selectedId: action.select === false ? state.selectedId : node.id,\n      })\n    }\n    case 'remove': {\n      const parent = getParentInfo(root, action.id)\n      const next = removeNode(root, action.id)\n      const selectedId =\n        state.selectedId === action.id ? (parent?.parent.id ?? null) : state.selectedId\n      return commit(state, next, { selectedId })\n    }\n    case 'duplicate': {\n      const { root: next, newId } = duplicateNode(root, action.id, state.newId)\n      return commit(state, next, { selectedId: newId ?? state.selectedId })\n    }\n    case 'reorder':\n      return commit(state, reorderNode(root, action.id, action.delta))\n    case 'move':\n      return commit(state, moveNode(root, action.id, action.target))\n    case 'replace': {\n      // Mint fresh ids for the incoming nodes (page-local namespace) so a detached\n      // copy never collides with the page, and a promoted block's source subtree\n      // (kept for the new reusable document) stays untouched.\n      const cloned = action.nodes.map((n) => cloneWithNewIds(n, state.newId))\n      const next = replaceNode(root, action.id, cloned)\n      if (next === root) return state // root or absent id — no-op\n      return commit(state, next, {\n        selectedId: action.select === false ? state.selectedId : (cloned[0]?.id ?? state.selectedId),\n      })\n    }\n    case 'wrap': {\n      // Layout gesture (EC-162): the reference and the dragged subject become\n      // the two columns of a new Grid container — ONE structural edit, one\n      // history entry, one mirrored command, so a single undo dissolves the\n      // whole gesture.\n      const partner =\n        action.subject.kind === 'node'\n          ? { kind: 'node' as const, nodeId: action.subject.nodeId }\n          : { kind: 'subtree' as const, node: cloneWithNewIds(action.subject.node, state.newId) }\n      // EC-591: the gesture builds the `layout.grid` component; with none, it is off\n      // (the drop rules refuse it before dispatch — this guard keeps the reducer total).\n      const gridComponentId = state.layout.grid\n      if (gridComponentId === undefined) return state\n      const containerId = state.newId()\n      const wrapped = applyWrap({\n        root,\n        gridComponentId,\n        referenceId: action.referenceId,\n        side: action.side,\n        partner,\n        containerId,\n      })\n      if (!wrapped) return state\n      return commit(state, wrapped.root, { selectedId: containerId })\n    }\n    case 'setProp':\n      return commit(state, setNodeProp(root, action.id, action.name, action.value), {\n        coalesceKey: action.coalesceKey,\n      })\n    case 'removeProp':\n      return commit(state, removeNodeProp(root, action.id, action.name))\n    default:\n      return state\n  }\n}\n\n/**\n * The composition FIELD whose value the store edits (EC-554). Static for the\n * store's lifetime and deliberately NOT reducer state: it is the declaration the\n * edited tree is judged against, not part of the tree. It travels WITH the store\n * so every placement surface under the provider — the canvas and page-tree\n * drag-and-drop, paste (canvas, tree, keyboard), and the insert offer — reads the\n * same value from the one context it already requires; none can be mounted\n * without it, and `BuilderProvider` cannot be mounted without declaring it.\n */\nexport interface CompositionFieldScope {\n  /** The field's display label — what a refusal notice names (e.g. \"Canvas\"). */\n  label: string\n  /**\n   * The field's top-level `allow` vocabulary (EC-188; a closed set per EC-544),\n   * or `undefined` when the field declares none (any registered component).\n   * Applied only through `fieldAllowAt` (`lib/dnd/drop-rules`), which scopes it\n   * to direct children of the composition root.\n   */\n  allow: readonly string[] | undefined\n}\n\nexport interface BuilderStore extends BuilderState {\n  canUndo: boolean\n  canRedo: boolean\n  selectedNode: ComponentNode | null\n  /** The composition field being edited (EC-554) — see {@link CompositionFieldScope}. */\n  field: CompositionFieldScope\n  dispatch: (action: Action) => void\n}\n\nconst { Context: BuilderContext, useRequired: useBuilder } =\n  createRequiredContext<BuilderStore>('Builder')\n\nexport function initialBuilderState(\n  composition: ComponentNode,\n  layout: LayoutContainerIds,\n  newId: IdFactory,\n): BuilderState {\n  // Start container-normal (idempotent on healthy trees) so the session and the\n  // lifted baseline agree from the first edit.\n  const present = normalizeContainers(composition, layout)\n  return {\n    past: [],\n    present,\n    future: [],\n    selectedId: present.id,\n    hoveredId: null,\n    viewport: 'full',\n    // EC-578: fresh ids come from the injected factory — never a counter seeded past\n    // the tree's `node-<n>` ids (EC-203), which two sessions advanced identically.\n    newId,\n    lastCoalesceKey: null,\n    layout,\n  }\n}\n\n/**\n * Undo/redo design (EC-141): the history stack is *UI state* — an in-memory\n * stack of composition-root snapshots. EC-287 retired the DB-resident project\n * graph and its append-only revision log, so the store no longer mirrors edits onto a\n * persistence layer: it is a pure in-memory editor. The block-field editor lifts\n * its committed composition into the open CMS document via `onChange`\n * (`composition-field-editor`); the document's own Save persists it as content.\n */\nexport function BuilderProvider({\n  composition,\n  field,\n  layout,\n  idFactory,\n  children,\n}: {\n  /** The composition root to edit (the composition-field editor's synthetic root). */\n  composition: ComponentNode\n  /** The field the composition is the value of (EC-554) — required, never defaulted. */\n  field: CompositionFieldScope\n  /** The layout-role component ids (EC-591, `ComponentRegistry.layout`) — required. */\n  layout: LayoutContainerIds\n  /**\n   * EC-578 — the node-id factory. Defaults to UUIDs (`createUuidIdFactory`, one per\n   * store); fixtures inject a deterministic factory.\n   */\n  idFactory?: IdFactory\n  children: ReactNode\n}) {\n  const [newId] = useState<IdFactory>(() => idFactory ?? createUuidIdFactory())\n  // EC-287: nothing persists a graph — committed edits are lifted into the CMS\n  // document by the composition-field editor's `onChange`. `useReducer` drives the\n  // pure `builderReducer` (consecutive dispatches in one gesture apply in sequence);\n  // the store below decorates the state with the derived undo/redo + selection flags.\n  const [state, dispatch] = useReducer(builderReducer, { composition, layout, newId }, (init) =>\n    initialBuilderState(init.composition, init.layout, init.newId),\n  )\n\n  const store = useMemo<BuilderStore>(() => {\n    const selectedNode = state.selectedId\n      ? (getNode(state.present, state.selectedId) ?? null)\n      : null\n    return {\n      ...state,\n      canUndo: state.past.length > 0,\n      canRedo: state.future.length > 0,\n      selectedNode,\n      field,\n      dispatch,\n    }\n  }, [state, field, dispatch])\n\n  return <BuilderContext.Provider value={store}>{children}</BuilderContext.Provider>\n}\n\nexport { useBuilder }\n"]}
+{"version":3,"file":"builder-store.js","sourceRoot":"","sources":["../../../src/components/builder/builder-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useReducer, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport {\n  DEFAULT_SLOT,\n  cloneWithNewIds,\n  duplicateNode,\n  getNode,\n  getParentInfo,\n  gridContainerNode,\n  insertNode,\n  moveNode,\n  normalizeContainers,\n  removeNode,\n  removeNodeProp,\n  reorderNode,\n  replaceNode,\n  replacePlacementRefusal,\n  setNodeProp,\n  subtreePlacementRefusal,\n} from '@elytracms/core/project-graph'\nimport type {\n  AllowList,\n  ComponentLookup,\n  ComponentNode,\n  InsertTarget,\n  LayoutContainerIds,\n  PlacementScope,\n  PlacementVerdict,\n  PropValue,\n} from '@elytracms/core/project-graph'\nimport { createUuidIdFactory } from '@elytracms/core/persistence'\nimport type { IdFactory } from '@elytracms/core/persistence'\nimport { WRAP_GRID_OPTIONS, applyWrap } from '@elytracms/studio/lib/dnd/drop-rules'\nimport { replaceRun, runByKey } from './canvas-runs'\nimport type { PreservedItem } from './canvas-runs'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\nconst HISTORY_LIMIT = 100\n\n/**\n * A canvas preview-width key (EC-250): `'full'` (unconstrained) or a configured\n * breakpoint name (`'sm'`, `'md'`, …). Dynamic because the set is sourced from\n * the consuming site's breakpoints, so it is a string, not a fixed union — the\n * switcher resolves the available options via {@link resolveCanvasViewports}.\n */\nexport type Viewport = string\n\n/**\n * The builder store's action union. EC-287 retired the DB-resident project graph\n * and its persistence mirror, so these actions are pure in-memory editor state —\n * no action maps to a persisted `graph.*` command anymore. The block-field editor\n * lifts committed edits into the CMS document via `onChange`\n * (`composition-field-editor`); nothing persists a graph.\n */\nexport type BuilderAction =\n  | { type: 'select'; id: string | null }\n  | { type: 'hover'; id: string | null }\n  | { type: 'viewport'; viewport: Viewport }\n  | { type: 'undo' }\n  | { type: 'redo' }\n  /**\n   * Insert a node (its subtree re-id'd from the store's id factory). `minted` — the\n   * node ALREADY carries fresh ids from the same factory (the paste path mints first\n   * so its issue deep links name exactly the ids that land); the reducer then inserts\n   * it as given.\n   */\n  | { type: 'insert'; target: InsertTarget; node: ComponentNode; select?: boolean; minted?: true }\n  | { type: 'remove'; id: string }\n  | { type: 'duplicate'; id: string }\n  | { type: 'reorder'; id: string; delta: -1 | 1 }\n  | { type: 'move'; id: string; target: InsertTarget }\n  /**\n   * EC-282 reuse gesture: replace a node with zero or more nodes at its\n   * position (clone-with-fresh-ids, like `insert`). Promote → 1 embed node;\n   * detach → the referenced element's inline blocks. One atomic structural\n   * edit, one undo step.\n   */\n  | { type: 'replace'; id: string; nodes: ComponentNode[]; select?: boolean }\n  /**\n   * EC-162 layout gesture: wrap the reference node and the dragged subject in\n   * a two-column Grid container as ONE atomic structural edit (one undo step).\n   */\n  | {\n      type: 'wrap'\n      referenceId: string\n      side: 'left' | 'right'\n      subject: { kind: 'node'; nodeId: string } | { kind: 'component'; node: ComponentNode }\n    }\n  | { type: 'setProp'; id: string; name: string; value: PropValue; coalesceKey?: string }\n  | { type: 'removeProp'; id: string; name: string }\n  /** EC-584: the editor dismissed the visible refusal ({@link BuilderState.refusal}). */\n  | { type: 'clearRefusal' }\n  /**\n   * EC-549 — select a typography RUN by its key (`canvas-runs.ts`: the index of its\n   * first preserved item); `null` clears it. A run and a node are never both selected.\n   */\n  | { type: 'selectRun'; run: number | null }\n  /** EC-549 — delete a typography run: a real, undoable edit of the preserved list. */\n  | { type: 'removeRun'; run: number }\n  /**\n   * EC-549 — replace a run's typography with `content` (the inspector's rich-text\n   * editor on that run; consecutive same-key edits coalesce into one undo step). Empty\n   * `content` deletes the run.\n   */\n  | { type: 'setRun'; run: number; content: readonly unknown[]; coalesceKey?: string }\n\n/** The structural actions the placement judge rules on (EC-584): every node that enters or moves. */\nexport type PlacingAction = Extract<BuilderAction, { type: 'insert' | 'replace' | 'move' | 'wrap' | 'duplicate' }>\n\n/** A refused placement (EC-584): the judge's verdict and the action it refused. */\nexport interface PlacementRefusal {\n  action: PlacingAction['type']\n  verdict: PlacementVerdict\n}\n\n/**\n * One history entry (EC-549): the component tree AND the preserved typography — so a\n * run's deletion or edit is undone exactly like a block's.\n */\nexport interface CanvasSnapshot {\n  root: ComponentNode\n  preserved: readonly PreservedItem[]\n}\n\nexport interface BuilderState {\n  /**\n   * The edited composition: one root-bearing component tree (EC-287). The canvas\n   * wraps a page document's `body` blocks into a synthetic root and edits it\n   * directly — no page/layout wrapper. Undo/redo snapshot it with the preserved\n   * typography ({@link CanvasSnapshot}).\n   */\n  past: CanvasSnapshot[]\n  present: ComponentNode\n  future: CanvasSnapshot[]\n  /**\n   * EC-549 — the field value's typography items (no ids, EC-500 D1), each anchored by\n   * how many component roots preceded it (`componentPrefix`); the field value is\n   * `mergeBlockRoots(present's roots, preserved)`. In the store, so selecting,\n   * deleting and editing a run is a real action with truthful undo.\n   */\n  preserved: readonly PreservedItem[]\n  selectedId: string | null\n  /** EC-549 — the selected typography run's key, or `null` (exclusive with {@link selectedId}). */\n  selectedRun: number | null\n  hoveredId: string | null\n  viewport: Viewport\n  /**\n   * EC-578 / EC-595 A2 — THE node-id factory (injected; UUIDs in the studio, a\n   * sequential factory in fixtures). It replaced the per-session `node-<n>` counter,\n   * which two sessions editing one page advanced identically — both minted the same\n   * next id, a `duplicate-node-id` on the second save. Stored ids are untouched.\n   */\n  newId: IdFactory\n  /** Coalescing key of the last edit (consecutive same-key edits don't stack history). */\n  lastCoalesceKey: string | null\n  /**\n   * The components filling the layout roles (EC-591, `ComponentRegistry.layout`),\n   * fixed for the store's lifetime: which nodes container normalization treats as\n   * Stack/Grid, and the Grid the wrap gesture builds. No hardcoded engine id.\n   */\n  layout: LayoutContainerIds\n  /**\n   * EC-584 — the last REFUSED placement, with its reason: the reducer judged an\n   * `insert`/`replace`/`move`/`wrap`/`duplicate` against the field and slot\n   * vocabularies and canvas eligibility (the core placement judge) and left the\n   * composition unchanged. Transient — the next edit, selection, undo or redo clears\n   * it — and never silent: the canvas shows it (`PlacementRefusalNotice`). A refused\n   * action changes no tree, so it adds no history entry and emits no canvas patch.\n   */\n  refusal: PlacementRefusal | null\n}\n\ntype Action = BuilderAction\n\n/**\n * Push a new graph onto history, coalescing consecutive edits with the same key.\n *\n * Every commit normalizes layout containers (EC-162 ledger fix): the\n * operations layer normalizes every persisted `graph.*` write (EC-161), so\n * the optimistic working graph must apply the same `normalizeContainers` pass\n * or the UI state diverges from the persisted revision after\n * container-emptying moves/removes. The mirrored command stays un-normalized\n * (`graphInvocationFor` sees the raw action); both sides normalize\n * identically, so they land on the same graph.\n */\nfunction commit(\n  state: BuilderState,\n  root: ComponentNode,\n  opts: {\n    coalesceKey?: string\n    selectedId?: string | null\n    preserved?: readonly PreservedItem[]\n    selectedRun?: number | null\n  } = {},\n): BuilderState {\n  const normalized = normalizeContainers(root, state.layout)\n  const present = normalized\n  const preserved = opts.preserved ?? state.preserved\n  const coalesce = opts.coalesceKey != null && opts.coalesceKey === state.lastCoalesceKey\n  // Normalization can dissolve the node a caller wanted selected (e.g. the\n  // parent container of a removed child) — selection never points at a ghost.\n  const desired = opts.selectedId !== undefined ? opts.selectedId : state.selectedId\n  const selectedId = desired !== null && getNode(normalized, desired) ? desired : null\n  const desiredRun = opts.selectedRun !== undefined ? opts.selectedRun : state.selectedRun\n  return {\n    ...state,\n    past: coalesce ? state.past : [...state.past, snapshotOf(state)].slice(-HISTORY_LIMIT),\n    present,\n    preserved,\n    future: [],\n    lastCoalesceKey: opts.coalesceKey ?? null,\n    selectedId,\n    selectedRun: liveRun(present, preserved, desiredRun),\n    refusal: null,\n  }\n}\n\nfunction snapshotOf(state: BuilderState): CanvasSnapshot {\n  return { root: state.present, preserved: state.preserved }\n}\n\n/** The run key if that run still exists in this state, else `null` (never a ghost selection). */\nfunction liveRun(root: ComponentNode, preserved: readonly PreservedItem[], run: number | null): number | null {\n  if (run === null) return null\n  return runByKey(rootCount(root), preserved, run) ? run : null\n}\n\n/** How many component roots the composition has (the synthetic root's children). */\nfunction rootCount(root: ComponentNode): number {\n  return root.slots?.[DEFAULT_SLOT]?.length ?? 0\n}\n\n/** Restore a history entry (undo/redo), keeping a selection only where it still exists. */\nfunction restore(state: BuilderState, to: CanvasSnapshot, past: CanvasSnapshot[], future: CanvasSnapshot[]): BuilderState {\n  return {\n    ...state,\n    past,\n    present: to.root,\n    preserved: to.preserved,\n    future,\n    lastCoalesceKey: null,\n    selectedId: getNode(to.root, state.selectedId ?? '') ? state.selectedId : null,\n    selectedRun: liveRun(to.root, to.preserved, state.selectedRun),\n    refusal: null,\n  }\n}\n\n/** Leave the composition untouched and say why (EC-584 — never a silent no-op). */\nfunction refuse(state: BuilderState, action: PlacingAction, verdict: PlacementVerdict): BuilderState {\n  return { ...state, refusal: { action: action.type, verdict } }\n}\n\n/**\n * The builder's pure state transition, CONSTRUCTED with the placement scope it judges\n * by (EC-584, owner-ratified 4a): the field's effective top-level vocabulary and the\n * manifest lookup. The scope is static per store and deliberately not reducer STATE\n * (it is the declaration the tree is judged against, not part of the tree) — the\n * reducer RECEIVES it, so there is no `(state, action)` to call without it.\n *\n * Every structural action that places a node — `insert`, `replace`, `move`, `wrap`,\n * `duplicate` — runs the ONE core judge (`subtreePlacementRefusal`) over every node\n * that enters or moves, BEFORE committing. A refusal returns the composition\n * unchanged, with the verdict in {@link BuilderState.refusal}: so no gesture — a\n * forgotten pre-check, promote, detach, a fixture's `slotChildren`, a server-only\n * paste — can place what the field, a slot or canvas eligibility forbids, and the\n * publish gate (which calls the same judge) cannot disagree with the canvas.\n *\n * Exported (with `initialBuilderState`) for unit tests — gesture determinism and\n * normalization lockstep are reducer-level properties, not render behavior.\n */\nexport function createBuilderReducer(\n  placement: PlacementScope,\n): (state: BuilderState, action: Action) => BuilderState {\n  return (state, action) => transition(state, action, placement)\n}\n\nfunction transition(state: BuilderState, action: Action, placement: PlacementScope): BuilderState {\n  const root = state.present\n  switch (action.type) {\n    case 'select':\n      return { ...state, selectedId: action.id, selectedRun: action.id === null ? state.selectedRun : null, refusal: null }\n    case 'selectRun':\n      return {\n        ...state,\n        selectedRun: liveRun(root, state.preserved, action.run),\n        selectedId: action.run === null ? state.selectedId : null,\n        refusal: null,\n      }\n    case 'removeRun': {\n      const run = runByKey(rootCount(root), state.preserved, action.run)\n      if (!run) return state\n      return commit(state, root, { preserved: replaceRun(state.preserved, run, []), selectedRun: null })\n    }\n    case 'setRun': {\n      const run = runByKey(rootCount(root), state.preserved, action.run)\n      if (!run) return state\n      return commit(state, root, {\n        preserved: replaceRun(state.preserved, run, action.content),\n        coalesceKey: action.coalesceKey,\n        selectedRun: action.content.length > 0 ? action.run : null,\n      })\n    }\n    case 'hover':\n      return state.hoveredId === action.id ? state : { ...state, hoveredId: action.id }\n    case 'viewport':\n      return { ...state, viewport: action.viewport }\n    case 'clearRefusal':\n      return state.refusal === null ? state : { ...state, refusal: null }\n\n    case 'undo': {\n      const prev = state.past.at(-1)\n      if (!prev) return state\n      return restore(state, prev, state.past.slice(0, -1), [snapshotOf(state), ...state.future])\n    }\n    case 'redo': {\n      const next = state.future[0]\n      if (!next) return state\n      return restore(state, next, [...state.past, snapshotOf(state)], state.future.slice(1))\n    }\n\n    case 'insert': {\n      const node = action.minted ? action.node : cloneWithNewIds(action.node, state.newId)\n      const verdict = subtreePlacementRefusal(root, node, landingOf(action.target), placement)\n      if (verdict) return refuse(state, action, verdict)\n      const next = insertNode(root, action.target, node)\n      return commit(state, next, {\n        selectedId: action.select === false ? state.selectedId : node.id,\n      })\n    }\n    case 'remove': {\n      const parent = getParentInfo(root, action.id)\n      const next = removeNode(root, action.id)\n      const selectedId =\n        state.selectedId === action.id ? (parent?.parent.id ?? null) : state.selectedId\n      return commit(state, next, { selectedId })\n    }\n    case 'duplicate': {\n      // The copy (and every node of its subtree) ENTERS beside the original.\n      const info = getParentInfo(root, action.id)\n      const source = getNode(root, action.id)\n      if (info && source) {\n        const verdict = subtreePlacementRefusal(root, source, { parentId: info.parent.id, slot: info.slot }, placement)\n        if (verdict) return refuse(state, action, verdict)\n      }\n      const { root: next, newId } = duplicateNode(root, action.id, state.newId)\n      return commit(state, next, { selectedId: newId ?? state.selectedId })\n    }\n    case 'reorder':\n      // Same parent, same slot: the placement does not change — nothing to judge.\n      return commit(state, reorderNode(root, action.id, action.delta))\n    case 'move': {\n      // A node that changes parent or slot lands somewhere new (its descendants keep\n      // their own slots, so only it is judged); a move within its own slot is a\n      // reorder and leaves the placement as it was.\n      const info = getParentInfo(root, action.id)\n      const node = getNode(root, action.id)\n      const relocates = !info || info.parent.id !== action.target.parentId || info.slot !== action.target.slot\n      if (node && relocates) {\n        const verdict = subtreePlacementRefusal(root, withoutSlots(node), landingOf(action.target), placement)\n        if (verdict) return refuse(state, action, verdict)\n      }\n      return commit(state, moveNode(root, action.id, action.target))\n    }\n    case 'replace': {\n      // Mint fresh ids for the incoming nodes (page-local namespace) so a detached\n      // copy never collides with the page, and a promoted block's source subtree\n      // (kept for the new reusable document) stays untouched.\n      const cloned = action.nodes.map((n) => cloneWithNewIds(n, state.newId))\n      // EC-560: promote (one embed) and detach (the reusable's content) land where the\n      // replaced node was — judged there like any insert (the reuse preflight asks the\n      // same `replacePlacementRefusal` before any side effect).\n      const verdict = replacePlacementRefusal(root, action.id, cloned, placement)\n      if (verdict) return refuse(state, action, verdict)\n      const next = replaceNode(root, action.id, cloned)\n      if (next === root) return state // root or absent id — no-op\n      return commit(state, next, {\n        selectedId: action.select === false ? state.selectedId : (cloned[0]?.id ?? state.selectedId),\n      })\n    }\n    case 'wrap': {\n      // Layout gesture (EC-162): the reference and the dragged subject become\n      // the two columns of a new Grid container — ONE structural edit, one\n      // history entry, one mirrored command, so a single undo dissolves the\n      // whole gesture.\n      const partner =\n        action.subject.kind === 'node'\n          ? { kind: 'node' as const, nodeId: action.subject.nodeId }\n          : { kind: 'subtree' as const, node: cloneWithNewIds(action.subject.node, state.newId) }\n      // EC-591: the gesture builds the `layout.grid` component; with none, it is off\n      // (the drop rules refuse it before dispatch — this guard keeps the reducer total).\n      const gridComponentId = state.layout.grid\n      if (gridComponentId === undefined) return state\n      // EC-584: the Grid lands where the reference is; the reference and the partner\n      // land in the Grid's column slot. A moved partner keeps its own subtree (only it\n      // relocates); a new one (a blocks-panel tile) enters whole.\n      const reference = getNode(root, action.referenceId)\n      const referenceInfo = getParentInfo(root, action.referenceId)\n      const partnerNode = partner.kind === 'node' ? getNode(root, partner.nodeId) : partner.node\n      if (reference && referenceInfo && partnerNode) {\n        const columns = [withoutSlots(reference), partner.kind === 'node' ? withoutSlots(partnerNode) : partnerNode]\n        const probe = gridContainerNode(gridComponentId, 'wrap', WRAP_GRID_OPTIONS, columns)\n        const verdict = subtreePlacementRefusal(\n          root,\n          probe,\n          { parentId: referenceInfo.parent.id, slot: referenceInfo.slot },\n          placement,\n        )\n        if (verdict) return refuse(state, action, verdict)\n      }\n      const containerId = state.newId()\n      const wrapped = applyWrap({\n        root,\n        gridComponentId,\n        referenceId: action.referenceId,\n        side: action.side,\n        partner,\n        containerId,\n      })\n      if (!wrapped) return state\n      return commit(state, wrapped.root, { selectedId: containerId })\n    }\n    case 'setProp':\n      return commit(state, setNodeProp(root, action.id, action.name, action.value), {\n        coalesceKey: action.coalesceKey,\n      })\n    case 'removeProp':\n      return commit(state, removeNodeProp(root, action.id, action.name))\n    default:\n      return state\n  }\n}\n\nfunction landingOf(target: InsertTarget): { parentId: string; slot?: string } {\n  return { parentId: target.parentId, slot: target.slot }\n}\n\n/** The node alone — a move relocates it; its descendants keep their own slots. */\nfunction withoutSlots(node: ComponentNode): ComponentNode {\n  const { slots: _slots, ...rest } = node\n  return rest\n}\n\n/**\n * The composition FIELD whose value the store edits (EC-554). Static for the\n * store's lifetime and deliberately NOT reducer state: it is the declaration the\n * edited tree is judged against, not part of the tree. It travels WITH the store\n * so every placement surface under the provider — the canvas and page-tree\n * drag-and-drop, paste (canvas, tree, keyboard), and the insert offer — reads the\n * same value from the one context it already requires; none can be mounted\n * without it, and `BuilderProvider` cannot be mounted without declaring it.\n */\nexport interface CompositionFieldScope {\n  /** The field's display label — what a refusal notice names (e.g. \"Canvas\"). */\n  label: string\n  /**\n   * The field's EFFECTIVE top-level vocabulary (EC-188; EC-584 — `fieldAllowList(field)`:\n   * its `allow`, else the `blocks` type's default). The judge applies it only to\n   * direct children of the composition root (`allowAt`, core `placement.ts`).\n   */\n  allow: AllowList\n}\n\nexport interface BuilderStore extends BuilderState {\n  canUndo: boolean\n  canRedo: boolean\n  selectedNode: ComponentNode | null\n  /** The composition field being edited (EC-554) — see {@link CompositionFieldScope}. */\n  field: CompositionFieldScope\n  /**\n   * EC-584 — what the reducer judges every placement by: the manifest lookup and the\n   * field's vocabulary. The gestures' own pre-checks (drag-and-drop, paste, the insert\n   * offer, the reuse preflight) read the SAME scope, so an indicator and the sink agree.\n   */\n  placement: PlacementScope\n  dispatch: (action: Action) => void\n}\n\nconst { Context: BuilderContext, useRequired: useBuilder } =\n  createRequiredContext<BuilderStore>('Builder')\n\nexport function initialBuilderState(\n  composition: ComponentNode,\n  layout: LayoutContainerIds,\n  newId: IdFactory,\n  /** EC-549 — the field value's typography items with their anchors (`splitBlockRoots`). */\n  preserved: readonly PreservedItem[] = [],\n): BuilderState {\n  // Start container-normal (idempotent on healthy trees) so the session and the\n  // lifted baseline agree from the first edit.\n  const present = normalizeContainers(composition, layout)\n  return {\n    past: [],\n    present,\n    future: [],\n    preserved,\n    selectedId: present.id,\n    selectedRun: null,\n    hoveredId: null,\n    viewport: 'full',\n    // EC-578: fresh ids come from the injected factory — never a counter seeded past\n    // the tree's `node-<n>` ids (EC-203), which two sessions advanced identically.\n    newId,\n    lastCoalesceKey: null,\n    layout,\n    refusal: null,\n  }\n}\n\n/**\n * Undo/redo design (EC-141): the history stack is *UI state* — an in-memory\n * stack of composition-root snapshots. EC-287 retired the DB-resident project\n * graph and its append-only revision log, so the store no longer mirrors edits onto a\n * persistence layer: it is a pure in-memory editor. The block-field editor lifts\n * its committed composition into the open CMS document via `onChange`\n * (`composition-field-editor`); the document's own Save persists it as content.\n */\nexport function BuilderProvider({\n  composition,\n  preserved,\n  field,\n  components,\n  layout,\n  idFactory,\n  children,\n}: {\n  /** The composition root to edit (the composition-field editor's synthetic root). */\n  composition: ComponentNode\n  /** EC-549 — the field value's typography items (`splitBlockRoots(value).preserved`). */\n  preserved?: readonly PreservedItem[]\n  /** The field the composition is the value of (EC-554) — required, never defaulted. */\n  field: CompositionFieldScope\n  /** The manifest lookup the placement judge reads (EC-584, `registry.lookup`) — required. */\n  components: ComponentLookup\n  /** The layout-role component ids (EC-591, `ComponentRegistry.layout`) — required. */\n  layout: LayoutContainerIds\n  /**\n   * EC-578 — the node-id factory. Defaults to UUIDs (`createUuidIdFactory`, one per\n   * store); fixtures inject a deterministic factory.\n   */\n  idFactory?: IdFactory\n  children: ReactNode\n}) {\n  const [newId] = useState<IdFactory>(() => idFactory ?? createUuidIdFactory())\n  // EC-584: the reducer is constructed ONCE with the scope it judges by — the field\n  // and the lookup are static for the store's lifetime (a remount re-reads them).\n  const [placement] = useState<PlacementScope>(() => ({ components, fieldAllow: field.allow }))\n  const [reducer] = useState(() => createBuilderReducer(placement))\n  // EC-287: nothing persists a graph — committed edits are lifted into the CMS\n  // document by the composition-field editor's `onChange`. `useReducer` drives the\n  // pure reducer (consecutive dispatches in one gesture apply in sequence); the\n  // store below decorates the state with the derived undo/redo + selection flags.\n  const [state, dispatch] = useReducer(reducer, { composition, layout, newId, preserved }, (init) =>\n    initialBuilderState(init.composition, init.layout, init.newId, init.preserved),\n  )\n\n  const store = useMemo<BuilderStore>(() => {\n    const selectedNode = state.selectedId\n      ? (getNode(state.present, state.selectedId) ?? null)\n      : null\n    return {\n      ...state,\n      canUndo: state.past.length > 0,\n      canRedo: state.future.length > 0,\n      selectedNode,\n      field,\n      placement,\n      dispatch,\n    }\n  }, [state, field, placement, dispatch])\n\n  return <BuilderContext.Provider value={store}>{children}</BuilderContext.Provider>\n}\n\nexport { useBuilder }\n"]}