@elytracms/studio 0.0.14 → 0.0.16

package/dist/components/app-views/sidebar.d.ts

@@ -0,0 +1,95 @@
+import type { LucideIcon } from 'lucide-react';
+import type { CustomizationIssue, Project, SectionAvailability } from '@elytracms/core/studio-core';
+import { type ResolvedAppViews } from './module';
+/**
+ * EC-237 — the configurable sidebar, an instance of the EC-236 customization seam.
+ *
+ * The section rail is a consumer-extendable ARRAY of nav entries — items (each
+ * targeting an EC-239 app-view module, optionally deep-linked to a resource),
+ * groups of sub-items, and separators. A consuming repo supplies its own array
+ * through `config.sidebar`; omitted → the studio derives the default rail from its
+ * module registry (every non-hidden module, in order). The supplied array is
+ * resolved through the shared {@link resolveOverrides} core: a duplicate id, an
+ * item whose target module isn't registered ("unknown view"), or a deep-link that
+ * doesn't resolve becomes a visible {@link CustomizationIssue} and the entry is
+ * dropped — never a silent failure. Sub-views (a focused "Taxonomy") are EC-239
+ * modules; this file decides only how the rail PRESENTS and orders them.
+ */
+/** A nav item targeting an app-view module, optionally deep-linked to a resource. */
+export interface SidebarItemConfig {
+    kind: 'item';
+    /** Stable id (defaults to `moduleId` via {@link navItem}). */
+    id: string;
+    /** The app-view module this item mounts — must be in the registry. */
+    moduleId: string;
+    /** Overrides the module's rail label. */
+    label?: string;
+    /** Overrides the module's rail icon. */
+    icon?: LucideIcon;
+    /** Trailing path segments targeting a specific resource, e.g. `['category']`. */
+    deepLink?: readonly string[];
+}
+export interface SidebarGroupConfig {
+    kind: 'group';
+    id: string;
+    label: string;
+    items: SidebarItemConfig[];
+}
+export interface SidebarSeparatorConfig {
+    kind: 'separator';
+    id?: string;
+}
+export type SidebarNodeConfig = SidebarItemConfig | SidebarGroupConfig | SidebarSeparatorConfig;
+export interface ResolvedSidebarItem {
+    kind: 'item';
+    id: string;
+    moduleId: string;
+    label: string;
+    icon: LucideIcon;
+    /** The `_splat` to navigate to (moduleId + deep-link segments). */
+    path: string;
+    availability: SectionAvailability;
+}
+export interface ResolvedSidebarGroup {
+    kind: 'group';
+    id: string;
+    label: string;
+    items: ResolvedSidebarItem[];
+}
+export interface ResolvedSidebarSeparator {
+    kind: 'separator';
+    id: string;
+}
+export type ResolvedSidebarNode = ResolvedSidebarItem | ResolvedSidebarGroup | ResolvedSidebarSeparator;
+export interface ResolvedSidebar {
+    nodes: ResolvedSidebarNode[];
+    issues: CustomizationIssue[];
+}
+/** A nav item; `id` defaults to `moduleId` when omitted. */
+export declare function navItem(config: Omit<SidebarItemConfig, 'kind' | 'id'> & {
+    id?: string;
+}): SidebarItemConfig;
+/** A labelled group of sub-items; `id` defaults to a slug of the label. */
+export declare function navGroup(label: string, items: SidebarItemConfig[], opts?: {
+    id?: string;
+}): SidebarGroupConfig;
+/** A divider between rail sections. */
+export declare function navSeparator(id?: string): SidebarSeparatorConfig;
+/** Identity helper that types a consumer's `config.sidebar` array. */
+export declare function defineSidebar(nodes: SidebarNodeConfig[]): SidebarNodeConfig[];
+/**
+ * Resolve a consumer sidebar (or the default rail) over the app-view registry
+ * through the shared customization core (EC-236). Every node — items, group
+ * headers, nested items, separators — is keyed by id and run through
+ * {@link resolveOverrides} for dedup + per-node validation, so a duplicate id or
+ * an invalid item is a visible issue and is dropped; the surviving nodes are
+ * rebuilt into the rail tree (groups keep their surviving sub-items).
+ */
+export declare function resolveSidebar(registry: ResolvedAppViews, project: Project, entries?: readonly SidebarNodeConfig[]): ResolvedSidebar;
+/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */
+export declare function activeModuleFromPath(pathname: string): string | null;
+/**
+ * The active project's resolved sidebar — the default rail or `config.sidebar`,
+ * resolved over the module registry through the EC-236 seam (static per boot).
+ */
+export declare function useSidebar(project: Project): ResolvedSidebar;

package/dist/components/app-views/sidebar.js

@@ -0,0 +1,153 @@
+import { useMemo } from 'react';
+import { resolveOverrides } from '@elytracms/core/studio-core';
+import { resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace';
+import { moduleAvailability } from './module';
+import { useAppViews } from './default-modules';
+// --- Builder helpers (the typed consumer API; carry live icons) ---
+/** A nav item; `id` defaults to `moduleId` when omitted. */
+export function navItem(config) {
+    return {
+        kind: 'item',
+        id: config.id ?? config.moduleId,
+        moduleId: config.moduleId,
+        ...(config.label !== undefined ? { label: config.label } : {}),
+        ...(config.icon !== undefined ? { icon: config.icon } : {}),
+        ...(config.deepLink !== undefined ? { deepLink: config.deepLink } : {}),
+    };
+}
+/** A labelled group of sub-items; `id` defaults to a slug of the label. */
+export function navGroup(label, items, opts = {}) {
+    return { kind: 'group', id: opts.id ?? slugify(label), label, items };
+}
+/** A divider between rail sections. */
+export function navSeparator(id) {
+    return { kind: 'separator', ...(id !== undefined ? { id } : {}) };
+}
+/** Identity helper that types a consumer's `config.sidebar` array. */
+export function defineSidebar(nodes) {
+    return nodes;
+}
+function slugify(label) {
+    return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'group';
+}
+// --- Resolution (EC-236 seam) ---
+/** The default rail: every non-hidden module as a plain item, in registry order. */
+function defaultSidebar(modules) {
+    return modules
+        .filter((module) => !module.hidden)
+        .map((module) => ({ kind: 'item', id: module.id, moduleId: module.id }));
+}
+/** The `_splat` path for an item (module id + its deep-link segments). */
+function itemPath(item) {
+    return [item.moduleId, ...(item.deepLink ?? [])].join('/');
+}
+/** Validate one item against the registry — unknown module or unresolvable deep-link. */
+function validateItem(registry, item) {
+    const module = registry.get(item.moduleId);
+    if (!module)
+        return `targets module "${item.moduleId}", which is not registered`;
+    if (item.deepLink && item.deepLink.length > 0) {
+        const parse = module.parsePath;
+        if (!parse) {
+            return `deep-links into module "${item.moduleId}", which takes no path`;
+        }
+        if (parse([...item.deepLink]) === null) {
+            return `deep-link "${item.deepLink.join('/')}" does not resolve in module "${item.moduleId}"`;
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a consumer sidebar (or the default rail) over the app-view registry
+ * through the shared customization core (EC-236). Every node — items, group
+ * headers, nested items, separators — is keyed by id and run through
+ * {@link resolveOverrides} for dedup + per-node validation, so a duplicate id or
+ * an invalid item is a visible issue and is dropped; the surviving nodes are
+ * rebuilt into the rail tree (groups keep their surviving sub-items).
+ */
+export function resolveSidebar(registry, project, entries) {
+    const config = entries ?? defaultSidebar(registry.modules);
+    const flat = [];
+    config.forEach((node, index) => {
+        if (node.kind === 'separator') {
+            flat.push({ id: node.id ?? `__separator:${index}`, value: { node, isItem: false } });
+            return;
+        }
+        if (node.kind === 'group') {
+            flat.push({ id: node.id, value: { node, isItem: false } });
+            node.items.forEach((item) => flat.push({ id: item.id, value: { node: item, isItem: true } }));
+            return;
+        }
+        flat.push({ id: node.id, value: { node, isItem: true } });
+    });
+    const resolved = resolveOverrides({
+        point: 'sidebar',
+        defaults: [],
+        overrides: flat,
+        allowNew: true,
+        validate: (entry) => entry.value.isItem
+            ? validateItem(registry, entry.value.node)
+            : null,
+    });
+    const survived = (id) => resolved.get(id) !== undefined;
+    const toItem = (item) => {
+        const module = registry.get(item.moduleId);
+        return {
+            kind: 'item',
+            id: item.id,
+            moduleId: item.moduleId,
+            label: item.label ?? module.label,
+            icon: item.icon ?? module.icon,
+            path: itemPath(item),
+            availability: moduleAvailability(project, module),
+        };
+    };
+    // Emit each surviving id at most once — `resolveOverrides` keeps the first of a
+    // duplicate, so the rebuild must skip later occurrences of that same id too.
+    const emitted = new Set();
+    const claim = (id) => {
+        if (!survived(id) || emitted.has(id))
+            return false;
+        emitted.add(id);
+        return true;
+    };
+    const nodes = [];
+    config.forEach((node, index) => {
+        if (node.kind === 'separator') {
+            const id = node.id ?? `__separator:${index}`;
+            if (claim(id))
+                nodes.push({ kind: 'separator', id });
+            return;
+        }
+        if (node.kind === 'group') {
+            if (!claim(node.id))
+                return;
+            const groupItems = node.items.filter((item) => claim(item.id)).map(toItem);
+            if (groupItems.length > 0) {
+                nodes.push({ kind: 'group', id: node.id, label: node.label, items: groupItems });
+            }
+            return;
+        }
+        if (claim(node.id))
+            nodes.push(toItem(node));
+    });
+    return { nodes, issues: resolved.issues };
+}
+/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */
+export function activeModuleFromPath(pathname) {
+    return pathname.split('/')[2] || null;
+}
+/**
+ * The active project's resolved sidebar — the default rail or `config.sidebar`,
+ * resolved over the module registry through the EC-236 seam (static per boot).
+ */
+export function useSidebar(project) {
+    const registry = useAppViews();
+    return useMemo(() => {
+        // Config carries the sidebar opaquely (`SidebarEntry` = object); the studio
+        // owns + validates the rich item/group/separator shape, so cast it back here.
+        const entries = resolveDeploymentSidebar();
+        return resolveSidebar(registry, project, entries);
+    }, [registry, project]);
+}
+//# sourceMappingURL=sidebar.js.map

package/dist/components/app-views/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../../src/components/app-views/sidebar.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport { resolveOverrides } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue, Project, SectionAvailability } from '@elytracms/core/studio-core'\nimport { resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace'\nimport { moduleAvailability, type AppViewModule, type ResolvedAppViews } from './module'\nimport { useAppViews } from './default-modules'\n\n/**\n * EC-237 — the configurable sidebar, an instance of the EC-236 customization seam.\n *\n * The section rail is a consumer-extendable ARRAY of nav entries — items (each\n * targeting an EC-239 app-view module, optionally deep-linked to a resource),\n * groups of sub-items, and separators. A consuming repo supplies its own array\n * through `config.sidebar`; omitted → the studio derives the default rail from its\n * module registry (every non-hidden module, in order). The supplied array is\n * resolved through the shared {@link resolveOverrides} core: a duplicate id, an\n * item whose target module isn't registered (\"unknown view\"), or a deep-link that\n * doesn't resolve becomes a visible {@link CustomizationIssue} and the entry is\n * dropped — never a silent failure. Sub-views (a focused \"Taxonomy\") are EC-239\n * modules; this file decides only how the rail PRESENTS and orders them.\n */\n\n// --- Consumer config shapes (typed builder helpers below) ---\n\n/** A nav item targeting an app-view module, optionally deep-linked to a resource. */\nexport interface SidebarItemConfig {\n  kind: 'item'\n  /** Stable id (defaults to `moduleId` via {@link navItem}). */\n  id: string\n  /** The app-view module this item mounts — must be in the registry. */\n  moduleId: string\n  /** Overrides the module's rail label. */\n  label?: string\n  /** Overrides the module's rail icon. */\n  icon?: LucideIcon\n  /** Trailing path segments targeting a specific resource, e.g. `['category']`. */\n  deepLink?: readonly string[]\n}\n\nexport interface SidebarGroupConfig {\n  kind: 'group'\n  id: string\n  label: string\n  items: SidebarItemConfig[]\n}\n\nexport interface SidebarSeparatorConfig {\n  kind: 'separator'\n  id?: string\n}\n\nexport type SidebarNodeConfig = SidebarItemConfig | SidebarGroupConfig | SidebarSeparatorConfig\n\n// --- Resolved (rail-ready) shapes ---\n\nexport interface ResolvedSidebarItem {\n  kind: 'item'\n  id: string\n  moduleId: string\n  label: string\n  icon: LucideIcon\n  /** The `_splat` to navigate to (moduleId + deep-link segments). */\n  path: string\n  availability: SectionAvailability\n}\nexport interface ResolvedSidebarGroup {\n  kind: 'group'\n  id: string\n  label: string\n  items: ResolvedSidebarItem[]\n}\nexport interface ResolvedSidebarSeparator {\n  kind: 'separator'\n  id: string\n}\nexport type ResolvedSidebarNode =\n  | ResolvedSidebarItem\n  | ResolvedSidebarGroup\n  | ResolvedSidebarSeparator\n\nexport interface ResolvedSidebar {\n  nodes: ResolvedSidebarNode[]\n  issues: CustomizationIssue[]\n}\n\n// --- Builder helpers (the typed consumer API; carry live icons) ---\n\n/** A nav item; `id` defaults to `moduleId` when omitted. */\nexport function navItem(\n  config: Omit<SidebarItemConfig, 'kind' | 'id'> & { id?: string },\n): SidebarItemConfig {\n  return {\n    kind: 'item',\n    id: config.id ?? config.moduleId,\n    moduleId: config.moduleId,\n    ...(config.label !== undefined ? { label: config.label } : {}),\n    ...(config.icon !== undefined ? { icon: config.icon } : {}),\n    ...(config.deepLink !== undefined ? { deepLink: config.deepLink } : {}),\n  }\n}\n\n/** A labelled group of sub-items; `id` defaults to a slug of the label. */\nexport function navGroup(\n  label: string,\n  items: SidebarItemConfig[],\n  opts: { id?: string } = {},\n): SidebarGroupConfig {\n  return { kind: 'group', id: opts.id ?? slugify(label), label, items }\n}\n\n/** A divider between rail sections. */\nexport function navSeparator(id?: string): SidebarSeparatorConfig {\n  return { kind: 'separator', ...(id !== undefined ? { id } : {}) }\n}\n\n/** Identity helper that types a consumer's `config.sidebar` array. */\nexport function defineSidebar(nodes: SidebarNodeConfig[]): SidebarNodeConfig[] {\n  return nodes\n}\n\nfunction slugify(label: string): string {\n  return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'group'\n}\n\n// --- Resolution (EC-236 seam) ---\n\n/** The default rail: every non-hidden module as a plain item, in registry order. */\nfunction defaultSidebar(modules: readonly AppViewModule[]): SidebarItemConfig[] {\n  return modules\n    .filter((module) => !module.hidden)\n    .map((module) => ({ kind: 'item', id: module.id, moduleId: module.id }))\n}\n\n/** The `_splat` path for an item (module id + its deep-link segments). */\nfunction itemPath(item: SidebarItemConfig): string {\n  return [item.moduleId, ...(item.deepLink ?? [])].join('/')\n}\n\n/** Validate one item against the registry — unknown module or unresolvable deep-link. */\nfunction validateItem(registry: ResolvedAppViews, item: SidebarItemConfig): string | null {\n  const module = registry.get(item.moduleId)\n  if (!module) return `targets module \"${item.moduleId}\", which is not registered`\n  if (item.deepLink && item.deepLink.length > 0) {\n    const parse = module.parsePath\n    if (!parse) {\n      return `deep-links into module \"${item.moduleId}\", which takes no path`\n    }\n    if (parse([...item.deepLink]) === null) {\n      return `deep-link \"${item.deepLink.join('/')}\" does not resolve in module \"${item.moduleId}\"`\n    }\n  }\n  return null\n}\n\n/**\n * Resolve a consumer sidebar (or the default rail) over the app-view registry\n * through the shared customization core (EC-236). Every node — items, group\n * headers, nested items, separators — is keyed by id and run through\n * {@link resolveOverrides} for dedup + per-node validation, so a duplicate id or\n * an invalid item is a visible issue and is dropped; the surviving nodes are\n * rebuilt into the rail tree (groups keep their surviving sub-items).\n */\nexport function resolveSidebar(\n  registry: ResolvedAppViews,\n  project: Project,\n  entries?: readonly SidebarNodeConfig[],\n): ResolvedSidebar {\n  const config = entries ?? defaultSidebar(registry.modules)\n\n  // Flatten the tree into a single keyspace so dedup + validation route through\n  // the shared core. Separators without an id get a positional one (never a user\n  // collision); groups + items keep theirs. `value` carries the node for validate.\n  type Flat = { node: SidebarNodeConfig; isItem: boolean }\n  const flat: { id: string; value: Flat }[] = []\n  config.forEach((node, index) => {\n    if (node.kind === 'separator') {\n      flat.push({ id: node.id ?? `__separator:${index}`, value: { node, isItem: false } })\n      return\n    }\n    if (node.kind === 'group') {\n      flat.push({ id: node.id, value: { node, isItem: false } })\n      node.items.forEach((item) => flat.push({ id: item.id, value: { node: item, isItem: true } }))\n      return\n    }\n    flat.push({ id: node.id, value: { node, isItem: true } })\n  })\n\n  const resolved = resolveOverrides<Flat>({\n    point: 'sidebar',\n    defaults: [],\n    overrides: flat,\n    allowNew: true,\n    validate: (entry) =>\n      entry.value.isItem\n        ? validateItem(registry, entry.value.node as SidebarItemConfig)\n        : null,\n  })\n  const survived = (id: string) => resolved.get(id) !== undefined\n\n  const toItem = (item: SidebarItemConfig): ResolvedSidebarItem => {\n    const module = registry.get(item.moduleId)!\n    return {\n      kind: 'item',\n      id: item.id,\n      moduleId: item.moduleId,\n      label: item.label ?? module.label,\n      icon: item.icon ?? module.icon,\n      path: itemPath(item),\n      availability: moduleAvailability(project, module),\n    }\n  }\n\n  // Emit each surviving id at most once — `resolveOverrides` keeps the first of a\n  // duplicate, so the rebuild must skip later occurrences of that same id too.\n  const emitted = new Set<string>()\n  const claim = (id: string) => {\n    if (!survived(id) || emitted.has(id)) return false\n    emitted.add(id)\n    return true\n  }\n\n  const nodes: ResolvedSidebarNode[] = []\n  config.forEach((node, index) => {\n    if (node.kind === 'separator') {\n      const id = node.id ?? `__separator:${index}`\n      if (claim(id)) nodes.push({ kind: 'separator', id })\n      return\n    }\n    if (node.kind === 'group') {\n      if (!claim(node.id)) return\n      const groupItems = node.items.filter((item) => claim(item.id)).map(toItem)\n      if (groupItems.length > 0) {\n        nodes.push({ kind: 'group', id: node.id, label: node.label, items: groupItems })\n      }\n      return\n    }\n    if (claim(node.id)) nodes.push(toItem(node))\n  })\n\n  return { nodes, issues: resolved.issues }\n}\n\n/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */\nexport function activeModuleFromPath(pathname: string): string | null {\n  return pathname.split('/')[2] || null\n}\n\n/**\n * The active project's resolved sidebar — the default rail or `config.sidebar`,\n * resolved over the module registry through the EC-236 seam (static per boot).\n */\nexport function useSidebar(project: Project): ResolvedSidebar {\n  const registry = useAppViews()\n  return useMemo(() => {\n    // Config carries the sidebar opaquely (`SidebarEntry` = object); the studio\n    // owns + validates the rich item/group/separator shape, so cast it back here.\n    const entries = resolveDeploymentSidebar() as readonly SidebarNodeConfig[] | undefined\n    return resolveSidebar(registry, project, entries)\n  }, [registry, project])\n}\n"]}

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

@@ -1,13 +1,87 @@
 import type { ReactNode } from 'react';
-import type { ComponentNode, ProjectGraph } from '@elytracms/core/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';
+import type { ComponentNode, InsertTarget, PropValue } from '@elytracms/core/project-graph';
+/**
+ * A canvas preview-width key (EC-250): `'full'` (unconstrained) or a configured
+ * breakpoint name (`'sm'`, `'md'`, …). Dynamic because the set is sourced from
+ * the consuming site's breakpoints, so it is a string, not a fixed union — the
+ * switcher resolves the available options via {@link resolveCanvasViewports}.
+ */
+export type Viewport = string;
+/**
+ * The builder store's action union. EC-287 retired the DB-resident project graph
+ * and its persistence mirror, so these actions are pure in-memory editor state —
+ * no action maps to a persisted `graph.*` command anymore. The block-field editor
+ * lifts committed edits into the CMS document via `onChange`
+ * (`composition-field-editor`); nothing persists a graph.
+ */
+export type BuilderAction = {
+    type: 'select';
+    id: string | null;
+} | {
+    type: 'hover';
+    id: string | null;
+} | {
+    type: 'viewport';
+    viewport: Viewport;
+} | {
+    type: 'undo';
+} | {
+    type: 'redo';
+} | {
+    type: 'insert';
+    target: InsertTarget;
+    node: ComponentNode;
+    select?: boolean;
+} | {
+    type: 'remove';
+    id: string;
+} | {
+    type: 'duplicate';
+    id: string;
+} | {
+    type: 'reorder';
+    id: string;
+    delta: -1 | 1;
+} | {
+    type: 'move';
+    id: string;
+    target: InsertTarget;
+}
+/**
+ * EC-162 layout gesture: wrap the reference node and the dragged subject in
+ * a two-column Grid container as ONE atomic structural edit (one undo step).
+ */
+ | {
+    type: 'wrap';
+    referenceId: string;
+    side: 'left' | 'right';
+    subject: {
+        kind: 'node';
+        nodeId: string;
+    } | {
+        kind: 'component';
+        node: ComponentNode;
+    };
+} | {
+    type: 'setProp';
+    id: string;
+    name: string;
+    value: PropValue;
+    coalesceKey?: string;
+} | {
+    type: 'removeProp';
+    id: string;
+    name: string;
+};
 export interface BuilderState {
-    past: WorkingGraph[];
-    present: WorkingGraph;
-    future: WorkingGraph[];
-    pageId: string;
+    /**
+     * 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.
+     */
+    past: ComponentNode[];
+    present: ComponentNode;
+    future: ComponentNode[];
     selectedId: string | null;
     hoveredId: string | null;
     viewport: Viewport;
@@ -28,41 +102,19 @@ export interface BuilderStore extends BuilderState {
     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;
+export declare function initialBuilderState(composition: ComponentNode): 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.
+ * 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
+ * graph and its append-only revision log, so the store no longer mirrors edits onto a
+ * persistence layer: it is a pure in-memory editor. The block-field editor lifts
+ * 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({ 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;
+export declare function BuilderProvider({ composition, children, }: {
+    /** The composition root to edit (the composition-field editor's synthetic root). */
+    composition: ComponentNode;
     children: ReactNode;
 }): import("react").JSX.Element;
 export declare function useBuilder(): BuilderStore;