@elytracms/studio 0.0.86 → 0.0.87

package/dist/components/builder/clipboard-actions.d.ts

@@ -1,5 +1,5 @@
 import type { ClipboardFragment } from '@elytracms/core/clipboard';
-import type { AsyncClipboard, PasteIssue } from '@elytracms/studio/lib/clipboard';
+import type { AsyncClipboard, PasteIssue, PasteRejection } from '@elytracms/studio/lib/clipboard';
 /**
  * Copy/cut/paste everywhere (EC-175, vision 3.3/3.7).
  *
@@ -22,11 +22,12 @@ import type { AsyncClipboard, PasteIssue } from '@elytracms/studio/lib/clipboard
  * issues deep-link to the inserted nodes. Only structurally invalid clipboard
  * content is reported as a non-blocking error, never a crash or silent no-op.
  *
- * The one thing paste REFUSES is the slot leash (EC-545): a pasted root the
- * resolved slot's `allow` excludes is rejected with a visible notice and no
- * dispatch — the same `slotAllows` verdict drag-and-drop gives. Permissiveness
- * is about what the target project can *resolve*; the leash is what the
- * component author *declared*.
+ * The one thing paste REFUSES is the leash: a pasted root the resolved slot's
+ * `allow` excludes (EC-545), or — landing as a direct child of the composition
+ * root — the composition field's top-level `allow` excludes (EC-554), is
+ * rejected with a visible notice and no dispatch — the same verdict
+ * drag-and-drop gives. Permissiveness is about what the target project can
+ * *resolve*; the leash is what the component and field authors *declared*.
  */
 export type ClipboardNotice = {
     kind: 'copied';
@@ -69,6 +70,13 @@ export interface StudioClipboard {
     pasteFromClipboard(anchorId?: string | null, asyncClipboard?: AsyncClipboard): Promise<void>;
 }
 export declare function useStudioClipboard(): StudioClipboard;
+/**
+ * The visible reason a refused paste shows (EC-545) — pure, so the notice
+ * wording per refusal is pinned without mounting the hook. EC-554: a field-leash
+ * refusal names the FIELD (`fieldLabel`), never the invisible synthetic root's
+ * slot — the rejection carries no destination label to misuse.
+ */
+export declare function pasteRejectionMessage(rejection: PasteRejection, fieldLabel: string): string;
 export interface ClipboardListenerOptions {
     clipboard: StudioClipboard;
     /** Current selection: the copy/cut subject and the paste anchor. */

package/dist/components/builder/clipboard-actions.js

@@ -7,8 +7,7 @@ import { readFragmentFromClipboard, readFragmentFromDataTransfer, resolvePasteTa
 import { getStudioRegistry } from '@elytracms/studio/lib/registry';
 import { clipboardErrorMessage, shortId } from '@elytracms/studio/lib/persona/labels';
 import { translate } from '@elytracms/studio/lib/i18n';
-import { useData } from '@elytracms/studio/lib/data';
-import { useCollab } from '../collab/collab-context.js';
+import { useProjectSession } from '../project-session.js';
 import { Badge, Row, Text } from '@elytracms/studio/ui';
 import { makeNodeIdCounter, useBuilder } from './builder-store.js';
 let currentNotice = null;
@@ -49,12 +48,11 @@ export function clipboardEventBlocked(target) {
 }
 export function useStudioClipboard() {
     const builder = useBuilder();
-    const data = useData();
-    const collab = useCollab();
+    const { projectId } = useProjectSession();
     const studio = getStudioRegistry();
     // Event listeners outlive renders; refs keep them on the current state.
-    const stateRef = useRef({ builder, data, projectId: collab.projectId });
-    stateRef.current = { builder, data, projectId: collab.projectId };
+    const stateRef = useRef({ builder, projectId });
+    stateRef.current = { builder, projectId };
     return useMemo(() => {
         const fragmentFor = (nodeId) => {
             const { builder: b, projectId } = stateRef.current;
@@ -85,7 +83,7 @@ export function useStudioClipboard() {
             return b.present;
         };
         const applyPaste = (result, anchorId) => {
-            const { builder: b, data: d } = stateRef.current;
+            const { builder: b } = stateRef.current;
             if (!result.ok) {
                 publishClipboardNotice({ kind: 'error', message: clipboardErrorMessage(result.error) });
                 return;
@@ -98,17 +96,13 @@ export function useStudioClipboard() {
                 anchorId: anchorId !== undefined ? anchorId : b.selectedId,
                 componentId: result.fragment.payload.root.componentId,
                 getManifest: (id) => studio.registry.getManifest(id),
+                // EC-554: the composition field's top-level vocabulary, from the store.
+                fieldAllow: b.field.allow,
             });
             if (!resolution.ok) {
-                // EC-545: the slot leash refuses the pasted root — the same `slotAllows`
-                // verdict a drop gets, made visible. Nothing is dispatched.
-                publishClipboardNotice({
-                    kind: 'error',
-                    message: translate('builder.clipboard.notAllowed', {
-                        component: shortId(resolution.componentId),
-                        destination: resolution.destinationLabel,
-                    }),
-                });
+                // EC-545 / EC-554: the slot leash or the field leash refuses the pasted
+                // root — the same verdict a drop gets, made visible. Nothing is dispatched.
+                publishClipboardNotice({ kind: 'error', message: pasteRejectionMessage(resolution, b.field.label) });
                 return;
             }
             const { target, destinationLabel } = resolution;
@@ -121,7 +115,6 @@ export function useStudioClipboard() {
             const diff = diffPastedSubtree({
                 node: inserted,
                 hasComponent: (id) => studio.registry.getManifest(id) !== undefined,
-                knownSourceIds: d.knownSourceIds,
             });
             publishClipboardNotice({
                 kind: 'pasted',
@@ -162,6 +155,24 @@ export function useStudioClipboard() {
         };
     }, [studio]);
 }
+/**
+ * The visible reason a refused paste shows (EC-545) — pure, so the notice
+ * wording per refusal is pinned without mounting the hook. EC-554: a field-leash
+ * refusal names the FIELD (`fieldLabel`), never the invisible synthetic root's
+ * slot — the rejection carries no destination label to misuse.
+ */
+export function pasteRejectionMessage(rejection, fieldLabel) {
+    if (rejection.code === 'field-not-allowed') {
+        return translate('builder.clipboard.notAllowedByField', {
+            component: shortId(rejection.componentId),
+            field: fieldLabel,
+        });
+    }
+    return translate('builder.clipboard.notAllowed', {
+        component: shortId(rejection.componentId),
+        destination: rejection.destinationLabel,
+    });
+}
 /**
  * Wire Cmd/Ctrl+C/X/V plus native copy/cut/paste ClipboardEvents.
  *
@@ -252,8 +263,6 @@ export function ClipboardNoticeOverlay() {
                                             summary: notice.summary,
                                             destination: notice.destinationLabel,
                                         })
-                                        : notice.message }), _jsx("button", { type: "button", "aria-label": translate('common.dismiss'), onClick: () => publishClipboardNotice(null), className: "shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground", children: _jsx(X, { className: "size-3.5" }) })] }), notice.kind === 'pasted' && notice.issues.length > 0 ? (_jsx("div", { className: "mt-1.5 flex flex-col gap-1", children: notice.issues.map((issue, i) => (_jsxs("button", { type: "button", "data-testid": "clipboard-notice-issue", onClick: () => builder.dispatch({ type: 'select', id: issue.nodeId }), className: "flex w-full items-center gap-2 rounded-md p-1 text-left transition-colors hover:bg-muted", children: [_jsx(Badge, { variant: "warning", className: "shrink-0", children: issue.kind === 'missing-component'
-                                    ? translate('builder.clipboard.issueComponent')
-                                    : translate('builder.clipboard.issueBinding') }), _jsx(Text, { size: "xs", tone: "muted", className: "min-w-0 flex-1 truncate", children: issue.message }), _jsx(Crosshair, { className: "size-3.5 shrink-0 text-muted-foreground", "aria-hidden": true })] }, `${issue.nodeId}-${i}`))) })) : null] }) }));
+                                        : notice.message }), _jsx("button", { type: "button", "aria-label": translate('common.dismiss'), onClick: () => publishClipboardNotice(null), className: "shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground", children: _jsx(X, { className: "size-3.5" }) })] }), notice.kind === 'pasted' && notice.issues.length > 0 ? (_jsx("div", { className: "mt-1.5 flex flex-col gap-1", children: notice.issues.map((issue, i) => (_jsxs("button", { type: "button", "data-testid": "clipboard-notice-issue", onClick: () => builder.dispatch({ type: 'select', id: issue.nodeId }), className: "flex w-full items-center gap-2 rounded-md p-1 text-left transition-colors hover:bg-muted", children: [_jsx(Badge, { variant: "warning", className: "shrink-0", children: translate('builder.clipboard.issueComponent') }), _jsx(Text, { size: "xs", tone: "muted", className: "min-w-0 flex-1 truncate", children: issue.message }), _jsx(Crosshair, { className: "size-3.5 shrink-0 text-muted-foreground", "aria-hidden": true })] }, `${issue.nodeId}-${i}`))) })) : null] }) }));
 }
 //# sourceMappingURL=clipboard-actions.js.map

package/dist/components/builder/clipboard-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard-actions.js","sourceRoot":"","sources":["../../../src/components/builder/clipboard-actions.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useRef, useSyncExternalStore } from 'react'\nimport { AlertTriangle, CircleCheck, Crosshair, X } from 'lucide-react'\nimport { cloneWithNewIds } from '@elytracms/core/project-graph'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { buildFragmentFromComposition } from '@elytracms/core/clipboard'\nimport type { ClipboardFragment, ParseFragmentResult } from '@elytracms/core/clipboard'\nimport {\n  readFragmentFromClipboard,\n  readFragmentFromDataTransfer,\n  resolvePasteTarget,\n  diffPastedSubtree,\n  pasteSummaryMessage,\n  writeFragmentToClipboard,\n  writeFragmentToDataTransfer,\n} from '@elytracms/studio/lib/clipboard'\nimport type { AsyncClipboard, PasteIssue } from '@elytracms/studio/lib/clipboard'\nimport { getStudioRegistry } from '@elytracms/studio/lib/registry'\nimport { clipboardErrorMessage, shortId } from '@elytracms/studio/lib/persona/labels'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { useData } from '@elytracms/studio/lib/data'\nimport { useCollab } from '../collab/collab-context'\nimport { Badge, Row, Text } from '@elytracms/studio/ui'\nimport { makeNodeIdCounter, useBuilder } from './builder-store'\n\n/**\n * Copy/cut/paste everywhere (EC-175, vision 3.3/3.7).\n *\n * One hook ({@link useStudioClipboard}) backs every affordance — canvas\n * keyboard shortcuts (wired inside the iframe by the canvas), page-tree\n * shortcuts and row buttons, and the blocks panel's \"copy exact\n * configuration\" — so they all produce/consume the same EC-174 fragment via\n * the OS clipboard (`lib/clipboard/os-clipboard`), never an app-internal\n * buffer. That is what makes paste work across documents, pages, projects,\n * and browser tabs.\n *\n * Dispatch contract: a paste is exactly ONE `insert` action (the fragment\n * root is a single subtree) → one history entry → one mirrored\n * `graph.insertNode` command — one undo step removes everything the paste\n * inserted. A cut is copy + exactly one `remove`; one undo restores it.\n *\n * Paste is PERMISSIVE: missing components and unresolvable bindings insert\n * anyway (the renderer's fallbacks keep them visible) and surface in a\n * notice — \"Pasted — 2 bindings unresolved, 1 component missing\" — whose\n * issues deep-link to the inserted nodes. Only structurally invalid clipboard\n * content is reported as a non-blocking error, never a crash or silent no-op.\n *\n * The one thing paste REFUSES is the slot leash (EC-545): a pasted root the\n * resolved slot's `allow` excludes is rejected with a visible notice and no\n * dispatch — the same `slotAllows` verdict drag-and-drop gives. Permissiveness\n * is about what the target project can *resolve*; the leash is what the\n * component author *declared*.\n */\n\n// ---------------------------------------------------------------------------\n// Notice store — module-level pub/sub (the drag-session pattern) so any\n// surface can publish and the canvas overlay renders it.\n// ---------------------------------------------------------------------------\n\nexport type ClipboardNotice =\n  | { kind: 'copied'; label: string }\n  | { kind: 'cut'; label: string }\n  | { kind: 'pasted'; summary: string; destinationLabel: string; issues: PasteIssue[] }\n  | { kind: 'error'; message: string }\n\nlet currentNotice: ClipboardNotice | null = null\nconst noticeListeners = new Set<() => void>()\n\nexport function publishClipboardNotice(notice: ClipboardNotice | null): void {\n  currentNotice = notice\n  for (const listener of [...noticeListeners]) listener()\n}\n\nfunction subscribeNotice(listener: () => void): () => void {\n  noticeListeners.add(listener)\n  return () => noticeListeners.delete(listener)\n}\n\nfunction getNotice(): ClipboardNotice | null {\n  return currentNotice\n}\n\nexport function useClipboardNotice(): ClipboardNotice | null {\n  return useSyncExternalStore(subscribeNotice, getNotice, getNotice)\n}\n\n// ---------------------------------------------------------------------------\n// Shortcut scoping\n// ---------------------------------------------------------------------------\n\n/**\n * Whether a clipboard shortcut/event must stay inert for this target: form\n * fields and any contenteditable (which includes the EC-158/EC-159 inline\n * editors) own their own native clipboard behaviour.\n */\nexport function clipboardEventBlocked(target: EventTarget | null): boolean {\n  const el = target as HTMLElement | null\n  if (!el) return false\n  const tag = el.tagName\n  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') return true\n  if (typeof el.closest === 'function' && el.closest('[contenteditable]')) return true\n  return el.isContentEditable === true\n}\n\n// ---------------------------------------------------------------------------\n// The clipboard surface\n// ---------------------------------------------------------------------------\n\nexport interface StudioClipboard {\n  /**\n   * Copy a canvas/tree node's subtree. Writes synchronously when a\n   * ClipboardEvent's DataTransfer is given, else via the async Clipboard API\n   * (`asyncClipboard` lets the canvas pass the iframe's own navigator —\n   * Chromium scopes clipboard access to the *focused* document).\n   */\n  copyNode(nodeId: string, dt?: DataTransfer | null, asyncClipboard?: AsyncClipboard): void\n  /** Copy, then remove the source in exactly one dispatch (one undo restores). */\n  cutNode(nodeId: string, dt?: DataTransfer | null, asyncClipboard?: AsyncClipboard): void\n  /** Copy a prebuilt fragment (blocks-panel \"copy exact configuration\"). */\n  copyFragment(fragment: ClipboardFragment, label: string): void\n  /** Paste from a paste event's DataTransfer (no permissions needed). */\n  pasteFromDataTransfer(dt: DataTransfer, anchorId?: string | null): void\n  /** Paste via the async Clipboard API (explicit affordances + shortcuts). */\n  pasteFromClipboard(anchorId?: string | null, asyncClipboard?: AsyncClipboard): Promise<void>\n}\n\nexport function useStudioClipboard(): StudioClipboard {\n  const builder = useBuilder()\n  const data = useData()\n  const collab = useCollab()\n  const studio = getStudioRegistry()\n\n  // Event listeners outlive renders; refs keep them on the current state.\n  const stateRef = useRef({ builder, data, projectId: collab.projectId })\n  stateRef.current = { builder, data, projectId: collab.projectId }\n\n  return useMemo<StudioClipboard>(() => {\n    const fragmentFor = (nodeId: string): { fragment: ClipboardFragment; label: string } | null => {\n      const { builder: b, projectId } = stateRef.current\n      const built = buildFragmentFromComposition(b.present, nodeId, { source: { projectId } })\n      if (!built.ok) {\n        // EC-494: the engine's clipboard errors carry a catalog ref, so the notice\n        // reads in the active studio locale instead of English inside German chrome.\n        publishClipboardNotice({ kind: 'error', message: clipboardErrorMessage(built.error) })\n        return null\n      }\n      return { fragment: built.fragment, label: shortId(built.fragment.payload.root.componentId) }\n    }\n\n    const write = (\n      fragment: ClipboardFragment,\n      label: string,\n      kind: 'copied' | 'cut',\n      dt?: DataTransfer | null,\n      asyncClipboard?: AsyncClipboard,\n    ): void => {\n      if (dt) {\n        writeFragmentToDataTransfer(dt, fragment)\n        publishClipboardNotice({ kind, label })\n        return\n      }\n      writeFragmentToClipboard(asyncClipboard ?? navigator.clipboard, fragment)\n        .then(() => publishClipboardNotice({ kind, label }))\n        .catch((cause: unknown) => {\n          const detail = cause instanceof Error ? cause.message : String(cause)\n          publishClipboardNotice({ kind: 'error', message: translate('builder.clipboard.writeError', { detail }) })\n        })\n    }\n\n    const currentRoot = (): ComponentNode | undefined => {\n      const { builder: b } = stateRef.current\n      return b.present\n    }\n\n    const applyPaste = (result: ParseFragmentResult, anchorId?: string | null): void => {\n      const { builder: b, data: d } = stateRef.current\n      if (!result.ok) {\n        publishClipboardNotice({ kind: 'error', message: clipboardErrorMessage(result.error) })\n        return\n      }\n      const root = currentRoot()\n      if (!root) return\n      const resolution = resolvePasteTarget({\n        root,\n        anchorId: anchorId !== undefined ? anchorId : b.selectedId,\n        componentId: result.fragment.payload.root.componentId,\n        getManifest: (id) => studio.registry.getManifest(id),\n      })\n      if (!resolution.ok) {\n        // EC-545: the slot leash refuses the pasted root — the same `slotAllows`\n        // verdict a drop gets, made visible. Nothing is dispatched.\n        publishClipboardNotice({\n          kind: 'error',\n          message: translate('builder.clipboard.notAllowed', {\n            component: shortId(resolution.componentId),\n            destination: resolution.destinationLabel,\n          }),\n        })\n        return\n      }\n      const { target, destinationLabel } = resolution\n      // Mirror the reducer's deterministic re-id so the issue deep links point\n      // at exactly the node ids the inserted subtree will carry — the SAME counter\n      // the reducer uses (`makeNodeIdCounter`), so the mirror can never diverge.\n      const inserted = cloneWithNewIds(result.fragment.payload.root, makeNodeIdCounter(b.nodeSeq).genId)\n      // ONE dispatch: one history entry, one graph.insertNode command, one undo.\n      b.dispatch({ type: 'insert', target, node: result.fragment.payload.root })\n      const diff = diffPastedSubtree({\n        node: inserted,\n        hasComponent: (id) => studio.registry.getManifest(id) !== undefined,\n        knownSourceIds: d.knownSourceIds,\n      })\n      publishClipboardNotice({\n        kind: 'pasted',\n        summary: pasteSummaryMessage(diff),\n        destinationLabel,\n        issues: diff.issues,\n      })\n    }\n\n    return {\n      copyNode(nodeId, dt, asyncClipboard) {\n        const built = fragmentFor(nodeId)\n        if (built) write(built.fragment, built.label, 'copied', dt, asyncClipboard)\n      },\n      cutNode(nodeId, dt, asyncClipboard) {\n        const { builder: b } = stateRef.current\n        const root = currentRoot()\n        if (root && nodeId === root.id) {\n          publishClipboardNotice({ kind: 'error', message: translate('builder.clipboard.rootCannotBeCut') })\n          return\n        }\n        const built = fragmentFor(nodeId)\n        if (!built) return\n        write(built.fragment, built.label, 'cut', dt, asyncClipboard)\n        // Exactly one structural dispatch: a single undo restores the cut node.\n        b.dispatch({ type: 'remove', id: nodeId })\n      },\n      copyFragment(fragment, label) {\n        write(fragment, label, 'copied')\n      },\n      pasteFromDataTransfer(dt, anchorId) {\n        applyPaste(readFragmentFromDataTransfer(dt), anchorId)\n      },\n      async pasteFromClipboard(anchorId, asyncClipboard) {\n        applyPaste(await readFragmentFromClipboard(asyncClipboard ?? navigator.clipboard), anchorId)\n      },\n    }\n  }, [studio])\n}\n\n// ---------------------------------------------------------------------------\n// Listener wiring — one implementation for the page-tree window and the\n// canvas iframe document (events never cross the frame boundary).\n// ---------------------------------------------------------------------------\n\nexport interface ClipboardListenerOptions {\n  clipboard: StudioClipboard\n  /** Current selection: the copy/cut subject and the paste anchor. */\n  getSelectedId: () => string | null\n  /** Extra guard (e.g. the canvas's live inline-edit session). */\n  isBlocked?: (target: EventTarget | null) => boolean\n  /** The async Clipboard API of the listening document's own window. */\n  asyncClipboard?: AsyncClipboard\n  /** The listening document's selection — real text selections stay native. */\n  getSelection?: () => Selection | null\n}\n\ninterface ListenerTarget {\n  addEventListener(type: string, listener: (e: Event) => void): void\n  removeEventListener(type: string, listener: (e: Event) => void): void\n}\n\n/**\n * Wire Cmd/Ctrl+C/X/V plus native copy/cut/paste ClipboardEvents.\n *\n * Shortcuts are handled on `keydown` (a selected node has no text selection,\n * so the browser would not fire native clipboard events for it); the\n * `preventDefault` there suppresses the native event, so the ClipboardEvent\n * listeners only ever see *other* triggers — context-menu copy/paste and\n * synthetic events — and the two paths can never double-handle one gesture.\n * Everything stays inert in form fields and inside the inline editors.\n */\nexport function attachClipboardListeners(target: ListenerTarget, opts: ClipboardListenerOptions): () => void {\n  const blocked = (t: EventTarget | null): boolean =>\n    clipboardEventBlocked(t) || (opts.isBlocked?.(t) ?? false)\n  const hasTextSelection = (): boolean => {\n    const selection = opts.getSelection?.()\n    return selection !== null && selection !== undefined && !selection.isCollapsed\n  }\n\n  const onKeyDown = (e: Event) => {\n    const event = e as KeyboardEvent\n    if (!(event.metaKey || event.ctrlKey) || event.altKey || event.shiftKey) return\n    const key = event.key.toLowerCase()\n    if (key !== 'c' && key !== 'x' && key !== 'v') return\n    if (blocked(event.target)) return\n    if ((key === 'c' || key === 'x') && hasTextSelection()) return\n    const selectedId = opts.getSelectedId()\n    if (key === 'v') {\n      event.preventDefault()\n      void opts.clipboard.pasteFromClipboard(selectedId, opts.asyncClipboard)\n      return\n    }\n    if (!selectedId) return\n    event.preventDefault()\n    if (key === 'c') opts.clipboard.copyNode(selectedId, null, opts.asyncClipboard)\n    else opts.clipboard.cutNode(selectedId, null, opts.asyncClipboard)\n  }\n\n  const onCopyOrCut = (e: Event) => {\n    const event = e as ClipboardEvent\n    if (blocked(event.target) || hasTextSelection()) return\n    const selectedId = opts.getSelectedId()\n    if (!selectedId || !event.clipboardData) return\n    event.preventDefault()\n    if (event.type === 'copy') opts.clipboard.copyNode(selectedId, event.clipboardData)\n    else opts.clipboard.cutNode(selectedId, event.clipboardData)\n  }\n\n  const onPaste = (e: Event) => {\n    const event = e as ClipboardEvent\n    if (blocked(event.target) || !event.clipboardData) return\n    event.preventDefault()\n    opts.clipboard.pasteFromDataTransfer(event.clipboardData, opts.getSelectedId())\n  }\n\n  target.addEventListener('keydown', onKeyDown)\n  target.addEventListener('copy', onCopyOrCut)\n  target.addEventListener('cut', onCopyOrCut)\n  target.addEventListener('paste', onPaste)\n  return () => {\n    target.removeEventListener('keydown', onKeyDown)\n    target.removeEventListener('copy', onCopyOrCut)\n    target.removeEventListener('cut', onCopyOrCut)\n    target.removeEventListener('paste', onPaste)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Notice overlay — rendered by the canvas; issues deep-link to their nodes.\n// ---------------------------------------------------------------------------\n\nexport function ClipboardNoticeOverlay() {\n  const notice = useClipboardNotice()\n  const builder = useBuilder()\n  if (!notice) return null\n\n  const tone =\n    notice.kind === 'error' ? 'error' : notice.kind === 'pasted' && notice.issues.length > 0 ? 'warning' : 'success'\n\n  return (\n    <div\n      data-testid=\"clipboard-notice\"\n      data-notice-kind={notice.kind}\n      className=\"absolute bottom-4 left-1/2 z-20 w-max max-w-[min(420px,90%)] -translate-x-1/2\"\n    >\n      <div className=\"rounded-lg border border-border bg-popover p-2 text-popover-foreground shadow-lg\">\n        <Row gap=\"2\" align=\"start\">\n          {tone === 'error' ? (\n            <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0 text-destructive\" aria-hidden />\n          ) : tone === 'warning' ? (\n            <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0 text-warning\" aria-hidden />\n          ) : (\n            <CircleCheck className=\"mt-0.5 size-3.5 shrink-0 text-success\" aria-hidden />\n          )}\n          <Text size=\"xs\" className=\"min-w-0 flex-1\">\n            {notice.kind === 'copied'\n              ? translate('builder.clipboard.copied', { label: notice.label })\n              : notice.kind === 'cut'\n                ? translate('builder.clipboard.cutNotice', { label: notice.label })\n                : notice.kind === 'pasted'\n                  ? translate('builder.clipboard.pastedInto', {\n                      summary: notice.summary,\n                      destination: notice.destinationLabel,\n                    })\n                  : notice.message}\n          </Text>\n          <button\n            type=\"button\"\n            aria-label={translate('common.dismiss')}\n            onClick={() => publishClipboardNotice(null)}\n            className=\"shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground\"\n          >\n            <X className=\"size-3.5\" />\n          </button>\n        </Row>\n        {notice.kind === 'pasted' && notice.issues.length > 0 ? (\n          <div className=\"mt-1.5 flex flex-col gap-1\">\n            {notice.issues.map((issue, i) => (\n              <button\n                key={`${issue.nodeId}-${i}`}\n                type=\"button\"\n                data-testid=\"clipboard-notice-issue\"\n                onClick={() => builder.dispatch({ type: 'select', id: issue.nodeId })}\n                className=\"flex w-full items-center gap-2 rounded-md p-1 text-left transition-colors hover:bg-muted\"\n              >\n                <Badge variant=\"warning\" className=\"shrink-0\">\n                  {issue.kind === 'missing-component'\n                    ? translate('builder.clipboard.issueComponent')\n                    : translate('builder.clipboard.issueBinding')}\n                </Badge>\n                <Text size=\"xs\" tone=\"muted\" className=\"min-w-0 flex-1 truncate\">\n                  {issue.message}\n                </Text>\n                <Crosshair className=\"size-3.5 shrink-0 text-muted-foreground\" aria-hidden />\n              </button>\n            ))}\n          </div>\n        ) : null}\n      </div>\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"clipboard-actions.js","sourceRoot":"","sources":["../../../src/components/builder/clipboard-actions.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useRef, useSyncExternalStore } from 'react'\nimport { AlertTriangle, CircleCheck, Crosshair, X } from 'lucide-react'\nimport { cloneWithNewIds } from '@elytracms/core/project-graph'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport { buildFragmentFromComposition } from '@elytracms/core/clipboard'\nimport type { ClipboardFragment, ParseFragmentResult } from '@elytracms/core/clipboard'\nimport {\n  readFragmentFromClipboard,\n  readFragmentFromDataTransfer,\n  resolvePasteTarget,\n  diffPastedSubtree,\n  pasteSummaryMessage,\n  writeFragmentToClipboard,\n  writeFragmentToDataTransfer,\n} from '@elytracms/studio/lib/clipboard'\nimport type { AsyncClipboard, PasteIssue, PasteRejection } from '@elytracms/studio/lib/clipboard'\nimport { getStudioRegistry } from '@elytracms/studio/lib/registry'\nimport { clipboardErrorMessage, shortId } from '@elytracms/studio/lib/persona/labels'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { useProjectSession } from '../project-session'\nimport { Badge, Row, Text } from '@elytracms/studio/ui'\nimport { makeNodeIdCounter, useBuilder } from './builder-store'\n\n/**\n * Copy/cut/paste everywhere (EC-175, vision 3.3/3.7).\n *\n * One hook ({@link useStudioClipboard}) backs every affordance — canvas\n * keyboard shortcuts (wired inside the iframe by the canvas), page-tree\n * shortcuts and row buttons, and the blocks panel's \"copy exact\n * configuration\" — so they all produce/consume the same EC-174 fragment via\n * the OS clipboard (`lib/clipboard/os-clipboard`), never an app-internal\n * buffer. That is what makes paste work across documents, pages, projects,\n * and browser tabs.\n *\n * Dispatch contract: a paste is exactly ONE `insert` action (the fragment\n * root is a single subtree) → one history entry → one mirrored\n * `graph.insertNode` command — one undo step removes everything the paste\n * inserted. A cut is copy + exactly one `remove`; one undo restores it.\n *\n * Paste is PERMISSIVE: missing components and unresolvable bindings insert\n * anyway (the renderer's fallbacks keep them visible) and surface in a\n * notice — \"Pasted — 2 bindings unresolved, 1 component missing\" — whose\n * issues deep-link to the inserted nodes. Only structurally invalid clipboard\n * content is reported as a non-blocking error, never a crash or silent no-op.\n *\n * The one thing paste REFUSES is the leash: a pasted root the resolved slot's\n * `allow` excludes (EC-545), or — landing as a direct child of the composition\n * root — the composition field's top-level `allow` excludes (EC-554), is\n * rejected with a visible notice and no dispatch — the same verdict\n * drag-and-drop gives. Permissiveness is about what the target project can\n * *resolve*; the leash is what the component and field authors *declared*.\n */\n\n// ---------------------------------------------------------------------------\n// Notice store — module-level pub/sub (the drag-session pattern) so any\n// surface can publish and the canvas overlay renders it.\n// ---------------------------------------------------------------------------\n\nexport type ClipboardNotice =\n  | { kind: 'copied'; label: string }\n  | { kind: 'cut'; label: string }\n  | { kind: 'pasted'; summary: string; destinationLabel: string; issues: PasteIssue[] }\n  | { kind: 'error'; message: string }\n\nlet currentNotice: ClipboardNotice | null = null\nconst noticeListeners = new Set<() => void>()\n\nexport function publishClipboardNotice(notice: ClipboardNotice | null): void {\n  currentNotice = notice\n  for (const listener of [...noticeListeners]) listener()\n}\n\nfunction subscribeNotice(listener: () => void): () => void {\n  noticeListeners.add(listener)\n  return () => noticeListeners.delete(listener)\n}\n\nfunction getNotice(): ClipboardNotice | null {\n  return currentNotice\n}\n\nexport function useClipboardNotice(): ClipboardNotice | null {\n  return useSyncExternalStore(subscribeNotice, getNotice, getNotice)\n}\n\n// ---------------------------------------------------------------------------\n// Shortcut scoping\n// ---------------------------------------------------------------------------\n\n/**\n * Whether a clipboard shortcut/event must stay inert for this target: form\n * fields and any contenteditable (which includes the EC-158/EC-159 inline\n * editors) own their own native clipboard behaviour.\n */\nexport function clipboardEventBlocked(target: EventTarget | null): boolean {\n  const el = target as HTMLElement | null\n  if (!el) return false\n  const tag = el.tagName\n  if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') return true\n  if (typeof el.closest === 'function' && el.closest('[contenteditable]')) return true\n  return el.isContentEditable === true\n}\n\n// ---------------------------------------------------------------------------\n// The clipboard surface\n// ---------------------------------------------------------------------------\n\nexport interface StudioClipboard {\n  /**\n   * Copy a canvas/tree node's subtree. Writes synchronously when a\n   * ClipboardEvent's DataTransfer is given, else via the async Clipboard API\n   * (`asyncClipboard` lets the canvas pass the iframe's own navigator —\n   * Chromium scopes clipboard access to the *focused* document).\n   */\n  copyNode(nodeId: string, dt?: DataTransfer | null, asyncClipboard?: AsyncClipboard): void\n  /** Copy, then remove the source in exactly one dispatch (one undo restores). */\n  cutNode(nodeId: string, dt?: DataTransfer | null, asyncClipboard?: AsyncClipboard): void\n  /** Copy a prebuilt fragment (blocks-panel \"copy exact configuration\"). */\n  copyFragment(fragment: ClipboardFragment, label: string): void\n  /** Paste from a paste event's DataTransfer (no permissions needed). */\n  pasteFromDataTransfer(dt: DataTransfer, anchorId?: string | null): void\n  /** Paste via the async Clipboard API (explicit affordances + shortcuts). */\n  pasteFromClipboard(anchorId?: string | null, asyncClipboard?: AsyncClipboard): Promise<void>\n}\n\nexport function useStudioClipboard(): StudioClipboard {\n  const builder = useBuilder()\n  const { projectId } = useProjectSession()\n  const studio = getStudioRegistry()\n\n  // Event listeners outlive renders; refs keep them on the current state.\n  const stateRef = useRef({ builder, projectId })\n  stateRef.current = { builder, projectId }\n\n  return useMemo<StudioClipboard>(() => {\n    const fragmentFor = (nodeId: string): { fragment: ClipboardFragment; label: string } | null => {\n      const { builder: b, projectId } = stateRef.current\n      const built = buildFragmentFromComposition(b.present, nodeId, { source: { projectId } })\n      if (!built.ok) {\n        // EC-494: the engine's clipboard errors carry a catalog ref, so the notice\n        // reads in the active studio locale instead of English inside German chrome.\n        publishClipboardNotice({ kind: 'error', message: clipboardErrorMessage(built.error) })\n        return null\n      }\n      return { fragment: built.fragment, label: shortId(built.fragment.payload.root.componentId) }\n    }\n\n    const write = (\n      fragment: ClipboardFragment,\n      label: string,\n      kind: 'copied' | 'cut',\n      dt?: DataTransfer | null,\n      asyncClipboard?: AsyncClipboard,\n    ): void => {\n      if (dt) {\n        writeFragmentToDataTransfer(dt, fragment)\n        publishClipboardNotice({ kind, label })\n        return\n      }\n      writeFragmentToClipboard(asyncClipboard ?? navigator.clipboard, fragment)\n        .then(() => publishClipboardNotice({ kind, label }))\n        .catch((cause: unknown) => {\n          const detail = cause instanceof Error ? cause.message : String(cause)\n          publishClipboardNotice({ kind: 'error', message: translate('builder.clipboard.writeError', { detail }) })\n        })\n    }\n\n    const currentRoot = (): ComponentNode | undefined => {\n      const { builder: b } = stateRef.current\n      return b.present\n    }\n\n    const applyPaste = (result: ParseFragmentResult, anchorId?: string | null): void => {\n      const { builder: b } = stateRef.current\n      if (!result.ok) {\n        publishClipboardNotice({ kind: 'error', message: clipboardErrorMessage(result.error) })\n        return\n      }\n      const root = currentRoot()\n      if (!root) return\n      const resolution = resolvePasteTarget({\n        root,\n        anchorId: anchorId !== undefined ? anchorId : b.selectedId,\n        componentId: result.fragment.payload.root.componentId,\n        getManifest: (id) => studio.registry.getManifest(id),\n        // EC-554: the composition field's top-level vocabulary, from the store.\n        fieldAllow: b.field.allow,\n      })\n      if (!resolution.ok) {\n        // EC-545 / EC-554: the slot leash or the field leash refuses the pasted\n        // root — the same verdict a drop gets, made visible. Nothing is dispatched.\n        publishClipboardNotice({ kind: 'error', message: pasteRejectionMessage(resolution, b.field.label) })\n        return\n      }\n      const { target, destinationLabel } = resolution\n      // Mirror the reducer's deterministic re-id so the issue deep links point\n      // at exactly the node ids the inserted subtree will carry — the SAME counter\n      // the reducer uses (`makeNodeIdCounter`), so the mirror can never diverge.\n      const inserted = cloneWithNewIds(result.fragment.payload.root, makeNodeIdCounter(b.nodeSeq).genId)\n      // ONE dispatch: one history entry, one graph.insertNode command, one undo.\n      b.dispatch({ type: 'insert', target, node: result.fragment.payload.root })\n      const diff = diffPastedSubtree({\n        node: inserted,\n        hasComponent: (id) => studio.registry.getManifest(id) !== undefined,\n      })\n      publishClipboardNotice({\n        kind: 'pasted',\n        summary: pasteSummaryMessage(diff),\n        destinationLabel,\n        issues: diff.issues,\n      })\n    }\n\n    return {\n      copyNode(nodeId, dt, asyncClipboard) {\n        const built = fragmentFor(nodeId)\n        if (built) write(built.fragment, built.label, 'copied', dt, asyncClipboard)\n      },\n      cutNode(nodeId, dt, asyncClipboard) {\n        const { builder: b } = stateRef.current\n        const root = currentRoot()\n        if (root && nodeId === root.id) {\n          publishClipboardNotice({ kind: 'error', message: translate('builder.clipboard.rootCannotBeCut') })\n          return\n        }\n        const built = fragmentFor(nodeId)\n        if (!built) return\n        write(built.fragment, built.label, 'cut', dt, asyncClipboard)\n        // Exactly one structural dispatch: a single undo restores the cut node.\n        b.dispatch({ type: 'remove', id: nodeId })\n      },\n      copyFragment(fragment, label) {\n        write(fragment, label, 'copied')\n      },\n      pasteFromDataTransfer(dt, anchorId) {\n        applyPaste(readFragmentFromDataTransfer(dt), anchorId)\n      },\n      async pasteFromClipboard(anchorId, asyncClipboard) {\n        applyPaste(await readFragmentFromClipboard(asyncClipboard ?? navigator.clipboard), anchorId)\n      },\n    }\n  }, [studio])\n}\n\n/**\n * The visible reason a refused paste shows (EC-545) — pure, so the notice\n * wording per refusal is pinned without mounting the hook. EC-554: a field-leash\n * refusal names the FIELD (`fieldLabel`), never the invisible synthetic root's\n * slot — the rejection carries no destination label to misuse.\n */\nexport function pasteRejectionMessage(rejection: PasteRejection, fieldLabel: string): string {\n  if (rejection.code === 'field-not-allowed') {\n    return translate('builder.clipboard.notAllowedByField', {\n      component: shortId(rejection.componentId),\n      field: fieldLabel,\n    })\n  }\n  return translate('builder.clipboard.notAllowed', {\n    component: shortId(rejection.componentId),\n    destination: rejection.destinationLabel,\n  })\n}\n\n// ---------------------------------------------------------------------------\n// Listener wiring — one implementation for the page-tree window and the\n// canvas iframe document (events never cross the frame boundary).\n// ---------------------------------------------------------------------------\n\nexport interface ClipboardListenerOptions {\n  clipboard: StudioClipboard\n  /** Current selection: the copy/cut subject and the paste anchor. */\n  getSelectedId: () => string | null\n  /** Extra guard (e.g. the canvas's live inline-edit session). */\n  isBlocked?: (target: EventTarget | null) => boolean\n  /** The async Clipboard API of the listening document's own window. */\n  asyncClipboard?: AsyncClipboard\n  /** The listening document's selection — real text selections stay native. */\n  getSelection?: () => Selection | null\n}\n\ninterface ListenerTarget {\n  addEventListener(type: string, listener: (e: Event) => void): void\n  removeEventListener(type: string, listener: (e: Event) => void): void\n}\n\n/**\n * Wire Cmd/Ctrl+C/X/V plus native copy/cut/paste ClipboardEvents.\n *\n * Shortcuts are handled on `keydown` (a selected node has no text selection,\n * so the browser would not fire native clipboard events for it); the\n * `preventDefault` there suppresses the native event, so the ClipboardEvent\n * listeners only ever see *other* triggers — context-menu copy/paste and\n * synthetic events — and the two paths can never double-handle one gesture.\n * Everything stays inert in form fields and inside the inline editors.\n */\nexport function attachClipboardListeners(target: ListenerTarget, opts: ClipboardListenerOptions): () => void {\n  const blocked = (t: EventTarget | null): boolean =>\n    clipboardEventBlocked(t) || (opts.isBlocked?.(t) ?? false)\n  const hasTextSelection = (): boolean => {\n    const selection = opts.getSelection?.()\n    return selection !== null && selection !== undefined && !selection.isCollapsed\n  }\n\n  const onKeyDown = (e: Event) => {\n    const event = e as KeyboardEvent\n    if (!(event.metaKey || event.ctrlKey) || event.altKey || event.shiftKey) return\n    const key = event.key.toLowerCase()\n    if (key !== 'c' && key !== 'x' && key !== 'v') return\n    if (blocked(event.target)) return\n    if ((key === 'c' || key === 'x') && hasTextSelection()) return\n    const selectedId = opts.getSelectedId()\n    if (key === 'v') {\n      event.preventDefault()\n      void opts.clipboard.pasteFromClipboard(selectedId, opts.asyncClipboard)\n      return\n    }\n    if (!selectedId) return\n    event.preventDefault()\n    if (key === 'c') opts.clipboard.copyNode(selectedId, null, opts.asyncClipboard)\n    else opts.clipboard.cutNode(selectedId, null, opts.asyncClipboard)\n  }\n\n  const onCopyOrCut = (e: Event) => {\n    const event = e as ClipboardEvent\n    if (blocked(event.target) || hasTextSelection()) return\n    const selectedId = opts.getSelectedId()\n    if (!selectedId || !event.clipboardData) return\n    event.preventDefault()\n    if (event.type === 'copy') opts.clipboard.copyNode(selectedId, event.clipboardData)\n    else opts.clipboard.cutNode(selectedId, event.clipboardData)\n  }\n\n  const onPaste = (e: Event) => {\n    const event = e as ClipboardEvent\n    if (blocked(event.target) || !event.clipboardData) return\n    event.preventDefault()\n    opts.clipboard.pasteFromDataTransfer(event.clipboardData, opts.getSelectedId())\n  }\n\n  target.addEventListener('keydown', onKeyDown)\n  target.addEventListener('copy', onCopyOrCut)\n  target.addEventListener('cut', onCopyOrCut)\n  target.addEventListener('paste', onPaste)\n  return () => {\n    target.removeEventListener('keydown', onKeyDown)\n    target.removeEventListener('copy', onCopyOrCut)\n    target.removeEventListener('cut', onCopyOrCut)\n    target.removeEventListener('paste', onPaste)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Notice overlay — rendered by the canvas; issues deep-link to their nodes.\n// ---------------------------------------------------------------------------\n\nexport function ClipboardNoticeOverlay() {\n  const notice = useClipboardNotice()\n  const builder = useBuilder()\n  if (!notice) return null\n\n  const tone =\n    notice.kind === 'error' ? 'error' : notice.kind === 'pasted' && notice.issues.length > 0 ? 'warning' : 'success'\n\n  return (\n    <div\n      data-testid=\"clipboard-notice\"\n      data-notice-kind={notice.kind}\n      className=\"absolute bottom-4 left-1/2 z-20 w-max max-w-[min(420px,90%)] -translate-x-1/2\"\n    >\n      <div className=\"rounded-lg border border-border bg-popover p-2 text-popover-foreground shadow-lg\">\n        <Row gap=\"2\" align=\"start\">\n          {tone === 'error' ? (\n            <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0 text-destructive\" aria-hidden />\n          ) : tone === 'warning' ? (\n            <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0 text-warning\" aria-hidden />\n          ) : (\n            <CircleCheck className=\"mt-0.5 size-3.5 shrink-0 text-success\" aria-hidden />\n          )}\n          <Text size=\"xs\" className=\"min-w-0 flex-1\">\n            {notice.kind === 'copied'\n              ? translate('builder.clipboard.copied', { label: notice.label })\n              : notice.kind === 'cut'\n                ? translate('builder.clipboard.cutNotice', { label: notice.label })\n                : notice.kind === 'pasted'\n                  ? translate('builder.clipboard.pastedInto', {\n                      summary: notice.summary,\n                      destination: notice.destinationLabel,\n                    })\n                  : notice.message}\n          </Text>\n          <button\n            type=\"button\"\n            aria-label={translate('common.dismiss')}\n            onClick={() => publishClipboardNotice(null)}\n            className=\"shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground\"\n          >\n            <X className=\"size-3.5\" />\n          </button>\n        </Row>\n        {notice.kind === 'pasted' && notice.issues.length > 0 ? (\n          <div className=\"mt-1.5 flex flex-col gap-1\">\n            {notice.issues.map((issue, i) => (\n              <button\n                key={`${issue.nodeId}-${i}`}\n                type=\"button\"\n                data-testid=\"clipboard-notice-issue\"\n                onClick={() => builder.dispatch({ type: 'select', id: issue.nodeId })}\n                className=\"flex w-full items-center gap-2 rounded-md p-1 text-left transition-colors hover:bg-muted\"\n              >\n                <Badge variant=\"warning\" className=\"shrink-0\">\n                  {translate('builder.clipboard.issueComponent')}\n                </Badge>\n                <Text size=\"xs\" tone=\"muted\" className=\"min-w-0 flex-1 truncate\">\n                  {issue.message}\n                </Text>\n                <Crosshair className=\"size-3.5 shrink-0 text-muted-foreground\" aria-hidden />\n              </button>\n            ))}\n          </div>\n        ) : null}\n      </div>\n    </div>\n  )\n}\n"]}

package/dist/components/builder/composition-field-editor.d.ts

@@ -1,6 +1,7 @@
-import type { ComponentNode } from '@elytracms/core/project-graph';
+import type { ComponentNode, PreservedSequenceItem, SplitBlockRoots } from '@elytracms/core/project-graph';
 import type { BlocksFieldDef } from '@elytracms/core/cms-core';
 import type { BlockNode, BlockSequenceValue } from '@elytracms/core/rich-text';
+import type { CompositionFieldScope } from './builder-store.js';
 import type { InspectorPane } from '../inspector/inspector-sidebar.js';
 /**
  * A sequence item the canvas does not natively edit (EC-547 / EC-500 D3):
@@ -10,44 +11,36 @@ import type { InspectorPane } from '../inspector/inspector-sidebar.js';
  * `componentPrefix` records how many component nodes preceded the item in the
  * original sequence — the anchor {@link mergeCompositionValue} splices by.
  */
-export interface PreservedBlockNode {
-    node: BlockNode;
-    componentPrefix: number;
-}
+export type PreservedBlockNode = PreservedSequenceItem<BlockNode>;
 /** A field value split for canvas editing: component roots + everything else. */
-export interface SplitCompositionValue {
-    roots: ComponentNode[];
-    preserved: PreservedBlockNode[];
-}
+export type SplitCompositionValue = SplitBlockRoots<BlockNode>;
 /**
  * Split a stored blocks-field value into the component nodes the canvas edits
  * and the sequence items it must preserve (EC-547, the EC-500 round-trip law:
  * a projection may only rewrite nodes it natively edits). Typography items are
  * deliberately NOT surfaced as editable canvas blocks in v1 (EC-500 D3) — they
  * survive the editing session and keep their order on write-back.
+ *
+ * EC-576: the logic is core's {@link splitBlockRoots} — the ONE reader every
+ * blocks writer shares. This is the canvas's typed view of it: project-graph
+ * sits below rich-text and cannot name {@link BlockNode}, so the carried items
+ * arrive `unknown`; they are typed here, not checked (preservation over parsing).
  */
 export declare function splitCompositionValue(value: unknown): SplitCompositionValue;
 /**
  * Merge canvas-edited component roots back into the stored sequence (EC-547).
- *
- * The merge rule, exactly: each preserved item re-enters the sequence after
- * `min(componentPrefix, roots.length)` component roots — it stays anchored to
- * its ORDINAL position between components, not to any component's identity.
- * Consequences, all deliberate:
- *  - no canvas edit ⇒ the original sequence is reproduced exactly;
- *  - reordering components on canvas reorders them WITHIN the component
- *    positions while preserved items stay put between those positions;
- *  - deleting components clamps now-out-of-range items to the sequence end;
- *  - a component appended on canvas takes the NEXT component position; a
- *    trailing typography item is anchored after all prior components, so the
- *    appended component lands after it — anchors hold, positions fill.
- * Preserved items keep their relative order (their prefixes are non-decreasing
- * by construction in {@link splitCompositionValue}).
- *
- * Every component root is passed through `componentBlockNode`, so the write is
- * v2-native even when the roots were read from a legacy untagged value.
+ * The merge rule — preserved items anchored to their ordinal position between
+ * components, every root tagged, the write always v2 — is core's
+ * {@link mergeBlockRoots} (EC-576: the same merge every blocks writer goes
+ * through, via `editBlockRoots`). Typed here as the rich-text value.
  */
 export declare function mergeCompositionValue(roots: readonly ComponentNode[], preserved: readonly PreservedBlockNode[]): BlockSequenceValue;
+/**
+ * The field scope the editor's store carries (EC-554): the field's label (named
+ * by refusal notices) and its top-level `allow`, passed through verbatim — an
+ * omitted `allow` stays `undefined` (EC-544: any registered component).
+ */
+export declare function compositionFieldScope(field: BlocksFieldDef): CompositionFieldScope;
 export declare function CompositionFieldEditor({ field, value, onChange, readOnly, trailingPanes, }: {
     field: BlocksFieldDef;
     value: unknown;

package/dist/components/builder/composition-field-editor.js

@@ -1,8 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { AlertTriangle, Pilcrow, Plus, Redo2, SlidersHorizontal, Undo2 } from 'lucide-react';
-import { DEFAULT_SLOT, isComponentBlockNode, isComponentNode } from '@elytracms/core/project-graph';
-import { componentBlockNode, createBlockSequenceValue, isBlockSequenceValueShape } from '@elytracms/core/rich-text';
+import { DEFAULT_SLOT, mergeBlockRoots, splitBlockRoots } from '@elytracms/core/project-graph';
 import { Button, Panel, Row, Spacer, Text, Toolbar, ToolbarGroup, ToolbarSeparator } from '@elytracms/studio/ui';
 import { cn } from '@elytracms/studio/lib/utils';
 import { translate } from '@elytracms/studio/lib/i18n';
@@ -17,6 +16,7 @@ import { insertablePositions, resolveInsertContext, resolveInsertContextAt } fro
 import { InsertAffordanceProvider } from './insert-affordance-context.js';
 import { PropSyncProvider } from './prop-sync-context.js';
 import { ReuseProvider } from './reuse-context.js';
+import { fieldLabel } from '../cms/cms-labels.js';
 /**
  * EC-188 — the block-field surface: one canvas engine mounted on a composition
  * **field value** (AD-12), not the project graph.
@@ -48,61 +48,32 @@ const SYNTH_ROOT_COMPONENT = 'base.Stack';
  * a projection may only rewrite nodes it natively edits). Typography items are
  * deliberately NOT surfaced as editable canvas blocks in v1 (EC-500 D3) — they
  * survive the editing session and keep their order on write-back.
+ *
+ * EC-576: the logic is core's {@link splitBlockRoots} — the ONE reader every
+ * blocks writer shares. This is the canvas's typed view of it: project-graph
+ * sits below rich-text and cannot name {@link BlockNode}, so the carried items
+ * arrive `unknown`; they are typed here, not checked (preservation over parsing).
  */
 export function splitCompositionValue(value) {
-    if (isBlockSequenceValueShape(value)) {
-        const roots = [];
-        const preserved = [];
-        for (const item of value.content) {
-            if (isComponentBlockNode(item))
-                roots.push(item);
-            // Preservation over parsing: an item the schema would reject still rides
-            // along untouched (validation reports it; the canvas must not destroy it).
-            else
-                preserved.push({ node: item, componentPrefix: roots.length });
-        }
-        return { roots, preserved };
-    }
-    // EC-547 staging: dies at the tightening commit — legacy bare values (a
-    // single ComponentNode for cardinality one, an array for many) are still
-    // accepted on READ because fixtures haven't flipped; write-back is v2 always.
-    if (Array.isArray(value))
-        return { roots: value.filter(isComponentNode), preserved: [] };
-    return { roots: isComponentNode(value) ? [value] : [], preserved: [] };
+    return splitBlockRoots(value);
 }
 /**
  * Merge canvas-edited component roots back into the stored sequence (EC-547).
- *
- * The merge rule, exactly: each preserved item re-enters the sequence after
- * `min(componentPrefix, roots.length)` component roots — it stays anchored to
- * its ORDINAL position between components, not to any component's identity.
- * Consequences, all deliberate:
- *  - no canvas edit ⇒ the original sequence is reproduced exactly;
- *  - reordering components on canvas reorders them WITHIN the component
- *    positions while preserved items stay put between those positions;
- *  - deleting components clamps now-out-of-range items to the sequence end;
- *  - a component appended on canvas takes the NEXT component position; a
- *    trailing typography item is anchored after all prior components, so the
- *    appended component lands after it — anchors hold, positions fill.
- * Preserved items keep their relative order (their prefixes are non-decreasing
- * by construction in {@link splitCompositionValue}).
- *
- * Every component root is passed through `componentBlockNode`, so the write is
- * v2-native even when the roots were read from a legacy untagged value.
+ * The merge rule — preserved items anchored to their ordinal position between
+ * components, every root tagged, the write always v2 — is core's
+ * {@link mergeBlockRoots} (EC-576: the same merge every blocks writer goes
+ * through, via `editBlockRoots`). Typed here as the rich-text value.
  */
 export function mergeCompositionValue(roots, preserved) {
-    const content = [];
-    let next = 0;
-    for (let position = 0; position <= roots.length; position++) {
-        while (next < preserved.length &&
-            Math.min(preserved[next].componentPrefix, roots.length) === position) {
-            content.push(preserved[next].node);
-            next += 1;
-        }
-        if (position < roots.length)
-            content.push(componentBlockNode(roots[position]));
-    }
-    return createBlockSequenceValue(content);
+    return mergeBlockRoots(roots, preserved);
+}
+/**
+ * The field scope the editor's store carries (EC-554): the field's label (named
+ * by refusal notices) and its top-level `allow`, passed through verbatim — an
+ * omitted `allow` stays `undefined` (EC-544: any registered component).
+ */
+export function compositionFieldScope(field) {
+    return { label: fieldLabel(field), allow: field.allow };
 }
 /**
  * Wrap the field value's component roots in a synthetic root container (EC-287).
@@ -125,7 +96,10 @@ export function CompositionFieldEditor({ field, value, onChange, readOnly, trail
     // so later prop changes are ignored regardless.)
     const initial = useMemo(() => splitCompositionValue(value), []);
     const initialRoot = useMemo(() => buildSyntheticRoot(initial.roots), [initial]);
-    return (_jsxs(BuilderProvider, { composition: initialRoot, children: [_jsx(CompositionLift, { preserved: initial.preserved, onChange: onChange, readOnly: readOnly }), _jsx(ReuseProvider, { children: _jsx(PropSyncProvider, { children: _jsx(CompositionEditorShell, { readOnly: readOnly, fieldAllow: field.allow, trailingPanes: trailingPanes, preservedCount: initial.preserved.length }) }) })] }));
+    // EC-554: the field's `allow` travels WITH the store, so every placement
+    // surface (canvas + tree DnD, paste, the insert offer) judges the same value.
+    const fieldScope = useMemo(() => compositionFieldScope(field), [field]);
+    return (_jsxs(BuilderProvider, { composition: initialRoot, field: fieldScope, children: [_jsx(CompositionLift, { preserved: initial.preserved, onChange: onChange, readOnly: readOnly }), _jsx(ReuseProvider, { children: _jsx(PropSyncProvider, { children: _jsx(CompositionEditorShell, { readOnly: readOnly, trailingPanes: trailingPanes, preservedCount: initial.preserved.length }) }) })] }));
 }
 /**
  * EC-549 interim (scope item 3, the honesty floor): a mixed sequence's typography
@@ -203,9 +177,13 @@ function BreakpointSwitcher() {
  * field. It keeps spatial/preview controls — including the breakpoint
  * preview-width switcher (EC-211), a canvas concern, not a lifecycle one.
  */
-function CompositionEditorShell({ readOnly, fieldAllow, trailingPanes, preservedCount = 0, }) {
+function CompositionEditorShell({ readOnly, trailingPanes, preservedCount = 0, }) {
     const builder = useBuilder();
     const dispatch = builder.dispatch;
+    // The field's top-level component vocabulary (EC-188) — the leash applied to
+    // inserts at the composition root so forbidden components aren't even offered.
+    // Read from the store's field scope (EC-554), the same value DnD and paste judge.
+    const fieldAllow = builder.field.allow;
     const [insertContext, setInsertContext] = useState(null);
     const [insertOpen, setInsertOpen] = useState(false);
     const rootId = builder.present.id;