@elytracms/studio 0.0.1

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

@@ -0,0 +1,69 @@
+import type { ReactNode } from 'react';
+import type { ComponentNode, ProjectGraph } from '@elytracms/project-graph';
+import type { BuilderAction, OperationError } from '@elytracms/studio/lib/operations';
+import type { WorkingGraph } from '@elytracms/studio/lib/working-graph';
+export type Viewport = 'desktop' | 'tablet' | 'mobile';
+export interface BuilderState {
+    past: WorkingGraph[];
+    present: WorkingGraph;
+    future: WorkingGraph[];
+    pageId: string;
+    selectedId: string | null;
+    hoveredId: string | null;
+    viewport: Viewport;
+    /** Monotonic counter feeding fresh node ids. */
+    nodeSeq: number;
+    /** Coalescing key of the last edit (consecutive same-key edits don't stack history). */
+    lastCoalesceKey: string | 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.
+ */
+export declare function builderReducer(state: BuilderState, action: Action): BuilderState;
+export interface BuilderStore extends BuilderState {
+    canUndo: boolean;
+    canRedo: boolean;
+    selectedNode: ComponentNode | null;
+    dispatch: (action: Action) => void;
+    /**
+     * Most recent failed/denied persisted mutation (structured, from the
+     * operation result). Rendered by the shell — never a silent failure.
+     */
+    persistError: OperationError | null;
+    clearPersistError: () => void;
+    /** Await all queued persisted mutations (publish flows, tests). */
+    flushPersistence: () => Promise<void>;
+}
+export declare function initialBuilderState(graph: ProjectGraph | WorkingGraph): BuilderState;
+/**
+ * Undo/redo design (EC-141): the history stack stays *UI state* — an
+ * in-memory stack of working-graph snapshots, exactly as before. The graph
+ * domain is append-only (load-latest → edit → save-revision), so a persisted
+ * "undo" cannot rewind the timeline; instead every committed edit is mirrored
+ * onto the operations layer as the matching `graph.*` command, and an
+ * undo/redo persists the restored snapshot as a *new* revision
+ * (`graph.save`, message "Undo"/"Redo"). This is the honest mapping of a
+ * linear session history onto an append-only revision log: the session and
+ * the persisted latest revision always agree, and the persisted timeline
+ * records that an undo happened rather than pretending it didn't.
+ *
+ * Without a `projectId` (styleguide, isolated tests) the store is a pure
+ * in-memory editor and persists nothing.
+ */
+export declare function BuilderProvider({ graph, workingGraph, projectId, children, }: {
+    /** Canonical (layouts-only) project graph; lifted into a working graph. */
+    graph?: ProjectGraph;
+    /**
+     * A pre-built working graph (the composition-field editor's synthetic page);
+     * used as-is when present, overriding `graph`.
+     */
+    workingGraph?: WorkingGraph;
+    /** Enables persistence through the shared operations client. */
+    projectId?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useBuilder(): BuilderStore;
+export {};

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

@@ -0,0 +1,294 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useRef, useState } from 'react';
+import { cloneWithNewIds, duplicateNode, getNode, getParentInfo, insertNode, maxNodeIdSeq, moveNode, normalizeContainers, removeNode, removeNodeProp, reorderNode, setNodeCondition, setNodeProp, validSampleGraph, } from '@elytracms/project-graph';
+import { applyWrap } from '@elytracms/studio/lib/dnd/drop-rules';
+import { createGraphPersister, getStudioOperations } from '@elytracms/studio/lib/operations';
+import { normalizeWorkingGraph, setWorkingPageSeo, toWorkingGraph } from '@elytracms/studio/lib/working-graph';
+const HISTORY_LIMIT = 100;
+function activeRoot(state) {
+    const page = state.present.pages.find((p) => p.id === state.pageId);
+    return page.root;
+}
+function withRoot(graph, pageId, root) {
+    return { ...graph, pages: graph.pages.map((p) => (p.id === pageId ? { ...p, root } : p)) };
+}
+/**
+ * The highest minted-id sequence already present in the working graph (EC-203).
+ * `nodeSeq` is a single session-wide counter feeding inserts on every page, so it
+ * must clear the max across ALL pages' roots — never just the active one — or
+ * switching pages and inserting would re-mint a collision on another page.
+ */
+function maxGraphNodeSeq(graph) {
+    return graph.pages.reduce((max, page) => Math.max(max, maxNodeIdSeq(page.root)), 0);
+}
+function counter(start) {
+    const c = {
+        count: start,
+        genId: () => {
+            c.count += 1;
+            return `node-${c.count}`;
+        },
+    };
+    return c;
+}
+/**
+ * Push a new graph onto history, coalescing consecutive edits with the same key.
+ *
+ * Every commit normalizes layout containers (EC-162 ledger fix): the
+ * operations layer normalizes every persisted `graph.*` write (EC-161), so
+ * the optimistic working graph must apply the same `normalizeContainers` pass
+ * or the UI state diverges from the persisted revision after
+ * container-emptying moves/removes. The mirrored command stays un-normalized
+ * (`graphInvocationFor` sees the raw action); both sides normalize
+ * identically, so they land on the same graph.
+ */
+function commit(state, root, opts = {}) {
+    const normalized = normalizeContainers(root);
+    const present = withRoot(state.present, state.pageId, normalized);
+    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;
+    return {
+        ...state,
+        past: coalesce ? state.past : [...state.past, state.present].slice(-HISTORY_LIMIT),
+        present,
+        future: [],
+        nodeSeq: opts.nodeSeq ?? state.nodeSeq,
+        lastCoalesceKey: opts.coalesceKey ?? null,
+        selectedId,
+    };
+}
+/**
+ * The pure state transition. Exported (with `initialBuilderState`) for unit
+ * tests — gesture determinism and normalization lockstep are reducer-level
+ * properties, not render behavior.
+ */
+export function builderReducer(state, action) {
+    const root = activeRoot(state);
+    switch (action.type) {
+        case 'select': {
+            // Optional page switch (reference deep links, EC-172): only onto pages
+            // that exist in the working graph; selection stays a pure-UI action.
+            const pageId = action.pageId !== undefined && state.present.pages.some((p) => p.id === action.pageId)
+                ? action.pageId
+                : state.pageId;
+            return { ...state, selectedId: action.id, pageId };
+        }
+        case 'hover':
+            return state.hoveredId === action.id ? state : { ...state, hoveredId: action.id };
+        case 'viewport':
+            return { ...state, viewport: action.viewport };
+        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.pages.find((p) => p.id === state.pageId).root, state.selectedId ?? '')
+                    ? state.selectedId
+                    : null,
+            };
+        }
+        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.pages.find((p) => p.id === state.pageId).root, state.selectedId ?? '')
+                    ? state.selectedId
+                    : null,
+            };
+        }
+        case 'insert': {
+            const c = counter(state.nodeSeq);
+            const node = cloneWithNewIds(action.node, c.genId);
+            const next = insertNode(root, action.target, node);
+            return commit(state, next, {
+                nodeSeq: c.count,
+                selectedId: action.select === false ? state.selectedId : node.id,
+            });
+        }
+        case 'remove': {
+            const parent = getParentInfo(root, action.id);
+            const next = removeNode(root, action.id);
+            const selectedId = state.selectedId === action.id ? (parent?.parent.id ?? null) : state.selectedId;
+            return commit(state, next, { selectedId });
+        }
+        case 'duplicate': {
+            const c = counter(state.nodeSeq);
+            const { root: next, newId } = duplicateNode(root, action.id, c.genId);
+            return commit(state, next, { nodeSeq: c.count, selectedId: newId ?? state.selectedId });
+        }
+        case 'reorder':
+            return commit(state, reorderNode(root, action.id, action.delta));
+        case 'move':
+            return commit(state, moveNode(root, action.id, action.target));
+        case 'wrap': {
+            // Layout gesture (EC-162): the reference and the dragged subject become
+            // the two columns of a new Grid container — ONE structural edit, one
+            // history entry, one mirrored command, so a single undo dissolves the
+            // whole gesture.
+            const c = counter(state.nodeSeq);
+            const partner = action.subject.kind === 'node'
+                ? { kind: 'node', nodeId: action.subject.nodeId }
+                : { kind: 'subtree', node: cloneWithNewIds(action.subject.node, c.genId) };
+            const containerId = c.genId();
+            const wrapped = applyWrap({
+                root,
+                referenceId: action.referenceId,
+                side: action.side,
+                partner,
+                containerId,
+            });
+            if (!wrapped)
+                return state;
+            return commit(state, wrapped.root, { nodeSeq: c.count, selectedId: containerId });
+        }
+        case 'setProp':
+            return commit(state, setNodeProp(root, action.id, action.name, action.value), {
+                coalesceKey: action.coalesceKey,
+            });
+        case 'removeProp':
+            return commit(state, removeNodeProp(root, action.id, action.name));
+        case 'setCondition':
+            return commit(state, setNodeCondition(root, action.id, action.condition));
+        case 'setPageSeo': {
+            // Legacy page SEO (EC-171), in-memory only: update the working page's
+            // `seo` block. Undoable; selection unchanged; never persisted as a node
+            // op (page SEO lives on the page CMS document now).
+            const next = setWorkingPageSeo(state.present, action.pageId, action.seo);
+            if (next === state.present)
+                return state;
+            return {
+                ...state,
+                past: [...state.past, state.present].slice(-HISTORY_LIMIT),
+                present: next,
+                future: [],
+                lastCoalesceKey: null,
+            };
+        }
+        case 'loadGraph': {
+            // Replace the whole working graph (e.g. restoring a saved revision).
+            // `action.graph` is a CANONICAL layouts-only ProjectGraph (a restore from
+            // the append-only revision log); lift it into a WorkingGraph so the
+            // root-bearing editor has an editable page. Undoable, selection
+            // re-validated, normalized like the persisted graph.save it mirrors.
+            const graph = normalizeWorkingGraph(toWorkingGraph(action.graph));
+            const pageId = graph.pages.find((p) => p.id === state.pageId)
+                ? state.pageId
+                : graph.pages[0].id;
+            const nextRoot = graph.pages.find((p) => p.id === pageId).root;
+            return {
+                ...state,
+                past: [...state.past, state.present].slice(-HISTORY_LIMIT),
+                present: graph,
+                future: [],
+                pageId,
+                // Advance past the restored graph's ids too (EC-203), never backwards:
+                // a restore swaps in a fresh node namespace under the same counter.
+                nodeSeq: Math.max(state.nodeSeq, maxGraphNodeSeq(graph)),
+                lastCoalesceKey: null,
+                selectedId: getNode(nextRoot, state.selectedId ?? '') ? state.selectedId : nextRoot.id,
+            };
+        }
+        default:
+            return state;
+    }
+}
+const BuilderContext = createContext(null);
+export function initialBuilderState(graph) {
+    // Lift a canonical (layouts-only) ProjectGraph into a root-bearing
+    // WorkingGraph; a WorkingGraph (synthetic composition surface) is used as-is.
+    // Start container-normal (idempotent on healthy graphs) so the session and
+    // the persisted baseline agree from the first edit.
+    const working = 'pages' in graph ? graph : toWorkingGraph(graph);
+    const present = normalizeWorkingGraph(working);
+    return {
+        past: [],
+        present,
+        future: [],
+        pageId: present.pages[0].id,
+        selectedId: present.pages[0].root.id,
+        hoveredId: null,
+        viewport: 'desktop',
+        // Seed past the ids the hydrated graph already carries (EC-203): a restored
+        // page holds minted `node-<n>` ids, so starting at 0 would re-mint `node-1`
+        // on the first insert and produce a duplicate-node-id.
+        nodeSeq: maxGraphNodeSeq(present),
+        lastCoalesceKey: null,
+    };
+}
+/**
+ * Undo/redo design (EC-141): the history stack stays *UI state* — an
+ * in-memory stack of working-graph snapshots, exactly as before. The graph
+ * domain is append-only (load-latest → edit → save-revision), so a persisted
+ * "undo" cannot rewind the timeline; instead every committed edit is mirrored
+ * onto the operations layer as the matching `graph.*` command, and an
+ * undo/redo persists the restored snapshot as a *new* revision
+ * (`graph.save`, message "Undo"/"Redo"). This is the honest mapping of a
+ * linear session history onto an append-only revision log: the session and
+ * the persisted latest revision always agree, and the persisted timeline
+ * records that an undo happened rather than pretending it didn't.
+ *
+ * Without a `projectId` (styleguide, isolated tests) the store is a pure
+ * in-memory editor and persists nothing.
+ */
+export function BuilderProvider({ graph = validSampleGraph, workingGraph, projectId, children, }) {
+    const [state, setState] = useState(() => initialBuilderState(workingGraph ?? graph));
+    const [persistError, setPersistError] = useState(null);
+    const stateRef = useRef(state);
+    const persisterRef = useRef(null);
+    if (persisterRef.current === null && projectId !== undefined) {
+        persisterRef.current = createGraphPersister({
+            projectId,
+            getOperations: async () => (await getStudioOperations()).operations,
+            onError: setPersistError,
+        });
+    }
+    // Plain-function dispatch (not `useReducer`) so each action sees the
+    // pre/post state synchronously — the persister derives the mirrored
+    // `graph.*` command from exactly that transition.
+    const dispatch = useCallback((action) => {
+        const prev = stateRef.current;
+        const next = builderReducer(prev, action);
+        stateRef.current = next;
+        setState(next);
+        persisterRef.current?.enqueue(action, { present: prev.present, pageId: prev.pageId, nodeSeq: prev.nodeSeq }, { present: next.present });
+    }, []);
+    const flushPersistence = useCallback(async () => persisterRef.current?.flush() ?? Promise.resolve(), []);
+    const clearPersistError = useCallback(() => setPersistError(null), []);
+    const store = useMemo(() => {
+        const selectedNode = state.selectedId
+            ? (getNode(activeRoot(state), state.selectedId) ?? null)
+            : null;
+        return {
+            ...state,
+            canUndo: state.past.length > 0,
+            canRedo: state.future.length > 0,
+            selectedNode,
+            dispatch,
+            persistError,
+            clearPersistError,
+            flushPersistence,
+        };
+    }, [state, dispatch, persistError, clearPersistError, flushPersistence]);
+    return _jsx(BuilderContext.Provider, { value: store, children: children });
+}
+export function useBuilder() {
+    const store = useContext(BuilderContext);
+    if (!store)
+        throw new Error('useBuilder must be used within a <BuilderProvider>.');
+    return store;
+}
+//# sourceMappingURL=builder-store.js.map

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

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

package/dist/components/builder/canvas-stylesheet.d.ts

@@ -0,0 +1,4 @@
+/** The consuming app supplies its compiled studio CSS URL at mount. */
+export declare function setCanvasStylesheetUrl(url: string): void;
+/** The injected stylesheet URL, or `null` when the app has not supplied one. */
+export declare function getCanvasStylesheetUrl(): string | null;

package/dist/components/builder/canvas-stylesheet.js

@@ -0,0 +1,24 @@
+/**
+ * The PREVIEW stylesheet URL, injected into the canvas iframe (EC-117 / EC-223 Stage 4).
+ * The canvas renders the project graph inside an ISOLATED iframe, so this stylesheet is
+ * scoped to that document alone — it is NOT the studio chrome stylesheet, and reusing the
+ * chrome's stylesheet here is a mistake (it makes the consuming app's delivery CSS and the
+ * studio UI share one file, the only way a leak between them becomes possible). The preview
+ * stylesheet should carry: (1) the consuming app's DELIVERY CSS, since the rendered blocks
+ * are the consuming app's own components styled by its delivery theme; and (2) the studio
+ * CSS, since the inline editing controls (RichTextToolbar, SpacingHandles) are portaled
+ * INTO this iframe. Both are BUILD artifacts of the consuming app (its Tailwind build picks
+ * up the package's `@source`), so the package cannot import them — the app injects its own
+ * compiled URL once at mount via {@link setCanvasStylesheetUrl}, and the canvas reads it
+ * here. Unset (e.g. tests / SSR) → the canvas simply skips the stylesheet link.
+ */
+let stylesheetUrl = null;
+/** The consuming app supplies its compiled studio CSS URL at mount. */
+export function setCanvasStylesheetUrl(url) {
+    stylesheetUrl = url;
+}
+/** The injected stylesheet URL, or `null` when the app has not supplied one. */
+export function getCanvasStylesheetUrl() {
+    return stylesheetUrl;
+}
+//# sourceMappingURL=canvas-stylesheet.js.map

package/dist/components/builder/canvas-stylesheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-stylesheet.js","sourceRoot":"","sources":["../../../src/components/builder/canvas-stylesheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,IAAI,aAAa,GAAkB,IAAI,CAAA;AAEvC,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,aAAa,GAAG,GAAG,CAAA;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/components/builder/canvas.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Iframe-isolated page preview (brief §8.2, EC-061, EC-064). The graph renders
+ * into a same-origin iframe via a React portal — true style isolation + true
+ * responsive widths. Each node is wrapped with an editable marker so clicks
+ * select and hover/selection draw outlines. Native listeners bridge the iframe
+ * boundary (React's synthetic events don't cross frames).
+ */
+export declare function BuilderCanvas(): import("react").JSX.Element;