@elytracms/studio 0.0.86 → 0.0.88

package/dist/lib/clipboard/paste-issues.d.ts

@@ -2,19 +2,24 @@ import type { ComponentNode } from '@elytracms/core/project-graph';
 /**
  * Permissive-paste validation (EC-175): pasting NEVER refuses a structurally
  * valid fragment. Instead, the inserted subtree is diffed against the TARGET
- * project's registry and data sources at paste time (cross-project semantics:
- * the fragment's source project is irrelevant — what matters is what *this*
- * project can resolve), and every mismatch becomes a visible, node-addressed
- * issue the notice deep-links. The renderer's existing fallbacks keep the
- * pasted nodes visible meanwhile.
+ * project's registry at paste time (cross-project semantics: the fragment's
+ * source project is irrelevant — what matters is what *this* project can
+ * resolve), and every mismatch becomes a visible, node-addressed issue the
+ * notice deep-links. The renderer's existing fallbacks keep the pasted nodes
+ * visible meanwhile.
  *
- * EC-494: this diff runs STUDIO-side (it needs the target registry and the session's
- * data sources), so it holds the active locale and can call `translate` directly —
- * no message ref has to cross a boundary, unlike the engine-built clipboard errors
- * in `@elytracms/core/clipboard`.
+ * EC-574: the second half of this diff — binding source ids the target could
+ * not resolve — went with the data-binding subsystem. A pasted node carrying a
+ * retired binding member is reported by the composition validator
+ * (`legacy-node-member`) when the document is validated, not here.
+ *
+ * EC-494: this diff runs STUDIO-side (it needs the target registry), so it holds
+ * the active locale and can call `translate` directly — no message ref has to
+ * cross a boundary, unlike the engine-built clipboard errors in
+ * `@elytracms/core/clipboard`.
  */
 export interface PasteIssue {
-    kind: 'missing-component' | 'unresolved-binding';
+    kind: 'missing-component';
     message: string;
     /** The inserted node carrying the problem — deep-link target. */
     nodeId: string;
@@ -22,18 +27,15 @@ export interface PasteIssue {
 export interface PasteDiff {
     /** Distinct component ids absent from the target registry. */
     missingComponents: string[];
-    /** Distinct binding source ids the target cannot resolve. */
-    unresolvedBindings: string[];
     issues: PasteIssue[];
 }
 /**
  * Diff an inserted subtree (with its final, session-assigned node ids)
- * against the target project's registry + known data sources.
+ * against the target project's registry.
  */
 export declare function diffPastedSubtree(args: {
     node: ComponentNode;
     hasComponent: (componentId: string) => boolean;
-    knownSourceIds: ReadonlySet<string>;
 }): PasteDiff;
-/** “Pasted — 2 bindings unresolved, 1 component missing”, or just “Pasted”. */
+/** “Pasted — 1 component missing”, or just “Pasted”. */
 export declare function pasteSummaryMessage(diff: PasteDiff): string;

package/dist/lib/clipboard/paste-issues.js

@@ -8,62 +8,25 @@ function walk(node, visit) {
 }
 /**
  * Diff an inserted subtree (with its final, session-assigned node ids)
- * against the target project's registry + known data sources.
+ * against the target project's registry.
  */
 export function diffPastedSubtree(args) {
     const missingComponents = new Map(); // componentId -> first nodeId
-    const unresolvedBindings = new Map(); // nodeId+sourceId -> issue
-    const unresolvedSourceIds = new Set();
     walk(args.node, (node) => {
         if (!args.hasComponent(node.componentId) && !missingComponents.has(node.componentId)) {
             missingComponents.set(node.componentId, node.id);
         }
-        const bindings = [];
-        for (const value of Object.values(node.props ?? {})) {
-            if (value.kind === 'binding')
-                bindings.push(value.binding);
-        }
-        if (node.condition)
-            bindings.push(node.condition.source);
-        for (const binding of bindings) {
-            if (args.knownSourceIds.has(binding.sourceId))
-                continue;
-            unresolvedSourceIds.add(binding.sourceId);
-            const key = `${node.id} ${binding.sourceId}`;
-            if (!unresolvedBindings.has(key)) {
-                unresolvedBindings.set(key, {
-                    kind: 'unresolved-binding',
-                    message: translate('builder.clipboard.issue.unresolvedBinding', {
-                        sourceId: binding.sourceId,
-                    }),
-                    nodeId: node.id,
-                });
-            }
-        }
     });
-    const issues = [
-        ...[...unresolvedBindings.values()],
-        ...[...missingComponents.entries()].map(([componentId, nodeId]) => ({
-            kind: 'missing-component',
-            message: translate('builder.clipboard.issue.missingComponent', { componentId }),
-            nodeId,
-        })),
-    ];
-    return {
-        missingComponents: [...missingComponents.keys()],
-        unresolvedBindings: [...unresolvedSourceIds],
-        issues,
-    };
+    const issues = [...missingComponents.entries()].map(([componentId, nodeId]) => ({
+        kind: 'missing-component',
+        message: translate('builder.clipboard.issue.missingComponent', { componentId }),
+        nodeId,
+    }));
+    return { missingComponents: [...missingComponents.keys()], issues };
 }
-/** “Pasted — 2 bindings unresolved, 1 component missing”, or just “Pasted”. */
+/** “Pasted — 1 component missing”, or just “Pasted”. */
 export function pasteSummaryMessage(diff) {
     const parts = [];
-    const bindings = diff.issues.filter((i) => i.kind === 'unresolved-binding').length;
-    if (bindings > 0) {
-        parts.push(translate(bindings === 1
-            ? 'builder.clipboard.summary.bindingUnresolvedOne'
-            : 'builder.clipboard.summary.bindingsUnresolved', { count: bindings }));
-    }
     if (diff.missingComponents.length > 0) {
         const n = diff.missingComponents.length;
         parts.push(translate(n === 1

package/dist/lib/clipboard/paste-issues.js.map

@@ -1 +1 @@
-{"version":3,"file":"paste-issues.js","sourceRoot":"","sources":["../../../src/lib/clipboard/paste-issues.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BindingReference, ComponentNode } from '@elytracms/core/project-graph'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Permissive-paste validation (EC-175): pasting NEVER refuses a structurally\n * valid fragment. Instead, the inserted subtree is diffed against the TARGET\n * project's registry and data sources at paste time (cross-project semantics:\n * the fragment's source project is irrelevant — what matters is what *this*\n * project can resolve), and every mismatch becomes a visible, node-addressed\n * issue the notice deep-links. The renderer's existing fallbacks keep the\n * pasted nodes visible meanwhile.\n *\n * EC-494: this diff runs STUDIO-side (it needs the target registry and the session's\n * data sources), so it holds the active locale and can call `translate` directly —\n * no message ref has to cross a boundary, unlike the engine-built clipboard errors\n * in `@elytracms/core/clipboard`.\n */\n\nexport interface PasteIssue {\n  kind: 'missing-component' | 'unresolved-binding'\n  message: string\n  /** The inserted node carrying the problem — deep-link target. */\n  nodeId: string\n}\n\nexport interface PasteDiff {\n  /** Distinct component ids absent from the target registry. */\n  missingComponents: string[]\n  /** Distinct binding source ids the target cannot resolve. */\n  unresolvedBindings: string[]\n  issues: PasteIssue[]\n}\n\nfunction walk(node: ComponentNode, visit: (node: ComponentNode) => void): void {\n  visit(node)\n  for (const children of Object.values(node.slots ?? {})) {\n    for (const child of children) walk(child, visit)\n  }\n}\n\n/**\n * Diff an inserted subtree (with its final, session-assigned node ids)\n * against the target project's registry + known data sources.\n */\nexport function diffPastedSubtree(args: {\n  node: ComponentNode\n  hasComponent: (componentId: string) => boolean\n  knownSourceIds: ReadonlySet<string>\n}): PasteDiff {\n  const missingComponents = new Map<string, string>() // componentId -> first nodeId\n  const unresolvedBindings = new Map<string, PasteIssue>() // nodeId+sourceId -> issue\n  const unresolvedSourceIds = new Set<string>()\n  walk(args.node, (node) => {\n    if (!args.hasComponent(node.componentId) && !missingComponents.has(node.componentId)) {\n      missingComponents.set(node.componentId, node.id)\n    }\n    const bindings: BindingReference[] = []\n    for (const value of Object.values(node.props ?? {})) {\n      if (value.kind === 'binding') bindings.push(value.binding)\n    }\n    if (node.condition) bindings.push(node.condition.source)\n    for (const binding of bindings) {\n      if (args.knownSourceIds.has(binding.sourceId)) continue\n      unresolvedSourceIds.add(binding.sourceId)\n      const key = `${node.id} ${binding.sourceId}`\n      if (!unresolvedBindings.has(key)) {\n        unresolvedBindings.set(key, {\n          kind: 'unresolved-binding',\n          message: translate('builder.clipboard.issue.unresolvedBinding', {\n            sourceId: binding.sourceId,\n          }),\n          nodeId: node.id,\n        })\n      }\n    }\n  })\n  const issues: PasteIssue[] = [\n    ...[...unresolvedBindings.values()],\n    ...[...missingComponents.entries()].map(\n      ([componentId, nodeId]): PasteIssue => ({\n        kind: 'missing-component',\n        message: translate('builder.clipboard.issue.missingComponent', { componentId }),\n        nodeId,\n      }),\n    ),\n  ]\n  return {\n    missingComponents: [...missingComponents.keys()],\n    unresolvedBindings: [...unresolvedSourceIds],\n    issues,\n  }\n}\n\n/** “Pasted — 2 bindings unresolved, 1 component missing”, or just “Pasted”. */\nexport function pasteSummaryMessage(diff: PasteDiff): string {\n  const parts: string[] = []\n  const bindings = diff.issues.filter((i) => i.kind === 'unresolved-binding').length\n  if (bindings > 0) {\n    parts.push(\n      translate(\n        bindings === 1\n          ? 'builder.clipboard.summary.bindingUnresolvedOne'\n          : 'builder.clipboard.summary.bindingsUnresolved',\n        { count: bindings },\n      ),\n    )\n  }\n  if (diff.missingComponents.length > 0) {\n    const n = diff.missingComponents.length\n    parts.push(\n      translate(\n        n === 1\n          ? 'builder.clipboard.summary.componentMissingOne'\n          : 'builder.clipboard.summary.componentsMissing',\n        { count: n },\n      ),\n    )\n  }\n  return parts.length > 0\n    ? translate('builder.clipboard.summary.pastedWith', { parts: parts.join(', ') })\n    : translate('builder.clipboard.summary.pasted')\n}\n"]}
+{"version":3,"file":"paste-issues.js","sourceRoot":"","sources":["../../../src/lib/clipboard/paste-issues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAmCtD,SAAS,IAAI,CAAC,IAAmB,EAAE,KAAoC;IACrE,KAAK,CAAC,IAAI,CAAC,CAAA;IACX,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,QAAQ;YAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAGjC;IACC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAA,CAAC,8BAA8B;IAClF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACrF,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QAClD,CAAC;IACH,CAAC,CAAC,CAAA;IACF,MAAM,MAAM,GAAiB,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAC/D,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,EAAc,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,SAAS,CAAC,0CAA0C,EAAE,EAAE,WAAW,EAAE,CAAC;QAC/E,MAAM;KACP,CAAC,CACH,CAAA;IACD,OAAO,EAAE,iBAAiB,EAAE,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAA;QACvC,KAAK,CAAC,IAAI,CACR,SAAS,CACP,CAAC,KAAK,CAAC;YACL,CAAC,CAAC,+CAA+C;YACjD,CAAC,CAAC,6CAA6C,EACjD,EAAE,KAAK,EAAE,CAAC,EAAE,CACb,CACF,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,SAAS,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChF,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAA;AACnD,CAAC","sourcesContent":["import type { ComponentNode } from '@elytracms/core/project-graph'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Permissive-paste validation (EC-175): pasting NEVER refuses a structurally\n * valid fragment. Instead, the inserted subtree is diffed against the TARGET\n * project's registry at paste time (cross-project semantics: the fragment's\n * source project is irrelevant — what matters is what *this* project can\n * resolve), and every mismatch becomes a visible, node-addressed issue the\n * notice deep-links. The renderer's existing fallbacks keep the pasted nodes\n * visible meanwhile.\n *\n * EC-574: the second half of this diff — binding source ids the target could\n * not resolve — went with the data-binding subsystem. A pasted node carrying a\n * retired binding member is reported by the composition validator\n * (`legacy-node-member`) when the document is validated, not here.\n *\n * EC-494: this diff runs STUDIO-side (it needs the target registry), so it holds\n * the active locale and can call `translate` directly — no message ref has to\n * cross a boundary, unlike the engine-built clipboard errors in\n * `@elytracms/core/clipboard`.\n */\n\nexport interface PasteIssue {\n  kind: 'missing-component'\n  message: string\n  /** The inserted node carrying the problem — deep-link target. */\n  nodeId: string\n}\n\nexport interface PasteDiff {\n  /** Distinct component ids absent from the target registry. */\n  missingComponents: string[]\n  issues: PasteIssue[]\n}\n\nfunction walk(node: ComponentNode, visit: (node: ComponentNode) => void): void {\n  visit(node)\n  for (const children of Object.values(node.slots ?? {})) {\n    for (const child of children) walk(child, visit)\n  }\n}\n\n/**\n * Diff an inserted subtree (with its final, session-assigned node ids)\n * against the target project's registry.\n */\nexport function diffPastedSubtree(args: {\n  node: ComponentNode\n  hasComponent: (componentId: string) => boolean\n}): PasteDiff {\n  const missingComponents = new Map<string, string>() // componentId -> first nodeId\n  walk(args.node, (node) => {\n    if (!args.hasComponent(node.componentId) && !missingComponents.has(node.componentId)) {\n      missingComponents.set(node.componentId, node.id)\n    }\n  })\n  const issues: PasteIssue[] = [...missingComponents.entries()].map(\n    ([componentId, nodeId]): PasteIssue => ({\n      kind: 'missing-component',\n      message: translate('builder.clipboard.issue.missingComponent', { componentId }),\n      nodeId,\n    }),\n  )\n  return { missingComponents: [...missingComponents.keys()], issues }\n}\n\n/** “Pasted — 1 component missing”, or just “Pasted”. */\nexport function pasteSummaryMessage(diff: PasteDiff): string {\n  const parts: string[] = []\n  if (diff.missingComponents.length > 0) {\n    const n = diff.missingComponents.length\n    parts.push(\n      translate(\n        n === 1\n          ? 'builder.clipboard.summary.componentMissingOne'\n          : 'builder.clipboard.summary.componentsMissing',\n        { count: n },\n      ),\n    )\n  }\n  return parts.length > 0\n    ? translate('builder.clipboard.summary.pastedWith', { parts: parts.join(', ') })\n    : translate('builder.clipboard.summary.pasted')\n}\n"]}

package/dist/lib/clipboard/paste-target.d.ts

@@ -14,6 +14,11 @@ import type { ComponentManifest } from '@elytracms/core/component-registry';
  * separate member of the result union, not a flag beside the target). Nested
  * validity of the pasted subtree stays with the publish gate, exactly like a
  * drop.
+ *
+ * EC-554: the composition FIELD's top-level `allow` is checked here too, through
+ * the same `placementRefusal` → `fieldAllowAt` the drop rule and the insert offer
+ * read — a paste that lands as a direct child of the composition root must be in
+ * the field's vocabulary.
  */
 export interface PasteTarget {
     ok: true;
@@ -21,7 +26,8 @@ export interface PasteTarget {
     /** Human label of where the paste lands (notices/debugging). */
     destinationLabel: string;
 }
-export interface PasteRejection {
+/** The resolved slot's own `allow` list excludes the pasted root (EC-545). */
+export interface PasteSlotRejection {
     ok: false;
     code: 'not-allowed';
     /** The pasted root the slot refuses. */
@@ -31,6 +37,19 @@ export interface PasteRejection {
     /** Human label of the refused destination (`Section · body`). */
     destinationLabel: string;
 }
+/**
+ * The composition field's top-level `allow` excludes the pasted root (EC-554).
+ * Deliberately carries NO slot/destination label: the refused slot is the
+ * invisible synthetic root's (`Stack · children`), and the reason to show is the
+ * FIELD — the notice names it from the editor's field scope.
+ */
+export interface PasteFieldRejection {
+    ok: false;
+    code: 'field-not-allowed';
+    /** The pasted root the field vocabulary refuses. */
+    componentId: string;
+}
+export type PasteRejection = PasteSlotRejection | PasteFieldRejection;
 export type PasteResolution = PasteTarget | PasteRejection;
 export declare function resolvePasteTarget(args: {
     root: ComponentNode;
@@ -39,4 +58,9 @@ export declare function resolvePasteTarget(args: {
     /** The pasted subtree's root component — the id the slot leash judges. */
     componentId: string;
     getManifest: (componentId: string) => ComponentManifest | undefined;
+    /**
+     * The composition field's top-level `allow` (EC-554) — `undefined` when the
+     * field declares none. Required so no caller can forget to pass it.
+     */
+    fieldAllow: readonly string[] | undefined;
 }): PasteResolution;

package/dist/lib/clipboard/paste-target.js

@@ -1,13 +1,18 @@
 import { getNode, getParentInfo } from '@elytracms/core/project-graph';
-import { manifestRules, primaryInsertSlot, slotAllows } from '@elytracms/studio/lib/dnd/drop-rules';
+import { manifestRules, placementRefusal, primaryInsertSlot } from '@elytracms/studio/lib/dnd/drop-rules';
 import { shortId } from '@elytracms/studio/lib/persona/labels';
 export function resolvePasteTarget(args) {
-    const { root, componentId, getManifest } = args;
+    const { root, componentId, getManifest, fieldAllow } = args;
     const anchor = args.anchorId !== null ? getNode(root, args.anchorId) : undefined;
     const node = anchor ?? root;
-    const leashed = (slot, slotRule, target, destinationLabel) => slotAllows(slotRule, componentId)
-        ? { ok: true, target, destinationLabel }
-        : { ok: false, code: 'not-allowed', componentId, slot, destinationLabel };
+    const leashed = (slot, slotRule, target, destinationLabel) => {
+        const refusal = placementRefusal({ root, parentId: target.parentId, slot: slotRule, fieldAllow, componentId });
+        if (refusal === 'field')
+            return { ok: false, code: 'field-not-allowed', componentId };
+        if (refusal === 'slot')
+            return { ok: false, code: 'not-allowed', componentId, slot, destinationLabel };
+        return { ok: true, target, destinationLabel };
+    };
     // EC-386: the shared slot rule (`primaryInsertSlot` over the merged
     // `manifestRules` vocabulary) — a blocks-prop region (e.g. a Section's `body`)
     // receives the paste exactly like the insert dialog and a DnD `into`.
@@ -25,6 +30,8 @@ export function resolvePasteTarget(args) {
         return leashed(info.slot, parentSlot, { parentId: info.parent.id, slot: info.slot, index: info.index + 1 }, `${shortId(info.parent.componentId)} · ${info.slot}`);
     }
     // Leaf root with no declared slots (degenerate graphs): append to `children`.
-    return { ok: true, target: { parentId: root.id, slot: 'children' }, destinationLabel: 'root' };
+    // No slot rule exists, but the paste still lands at the root — the field leash
+    // applies.
+    return leashed('children', undefined, { parentId: root.id, slot: 'children' }, 'root');
 }
 //# sourceMappingURL=paste-target.js.map

package/dist/lib/clipboard/paste-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"paste-target.js","sourceRoot":"","sources":["../../../src/lib/clipboard/paste-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAGtE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAA;AAEnG,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAA;AAsC9D,MAAM,UAAU,kBAAkB,CAAC,IAOlC;IACC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAChF,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAA;IAE3B,MAAM,OAAO,GAAG,CACd,IAAY,EACZ,QAA8B,EAC9B,MAAoB,EACpB,gBAAwB,EACP,EAAE,CACnB,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC/B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE;QACxC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAA;IAE7E,oEAAoE;IACpE,+EAA+E;IAC/E,sEAAsE;IACtE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC5D,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,OAAO,CACZ,SAAS,CAAC,IAAI,EACd,SAAS,EACT,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,EAC3C,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CACnD,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,0EAA0E;QAC1E,wEAAwE;QACxE,8BAA8B;QAC9B,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/G,OAAO,OAAO,CACZ,IAAI,CAAC,IAAI,EACT,UAAU,EACV,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,EACpE,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CACrD,CAAA;IACH,CAAC;IAED,8EAA8E;IAC9E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;AAChG,CAAC","sourcesContent":["import { getNode, getParentInfo } from '@elytracms/core/project-graph'\nimport type { ComponentNode, InsertTarget } from '@elytracms/core/project-graph'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport { manifestRules, primaryInsertSlot, slotAllows } from '@elytracms/studio/lib/dnd/drop-rules'\nimport type { SlotRule } from '@elytracms/studio/lib/dnd/drop-rules'\nimport { shortId } from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Paste landing-spot resolution (EC-175) — the same placement rule the Insert\n * dialog uses (`insert-context.ts`): a pasted subtree lands *into*\n * the anchor node's child slot when it has one, else *after* the anchor as a\n * sibling, else appended to the page root. Pure and selection-driven so the\n * canvas, the page tree, and keyboard paste all share one rule.\n *\n * EC-545: the resolved slot's `allow` leash is checked HERE, for the pasted\n * subtree's root, through the same `slotAllows` the drop rule reads — so a\n * component drag-and-drop refuses is refused by clipboard too, and a caller\n * cannot reach an `InsertTarget` without passing the check (the rejection is a\n * separate member of the result union, not a flag beside the target). Nested\n * validity of the pasted subtree stays with the publish gate, exactly like a\n * drop.\n */\n\nexport interface PasteTarget {\n  ok: true\n  target: InsertTarget\n  /** Human label of where the paste lands (notices/debugging). */\n  destinationLabel: string\n}\n\nexport interface PasteRejection {\n  ok: false\n  code: 'not-allowed'\n  /** The pasted root the slot refuses. */\n  componentId: string\n  /** The resolved slot whose `allow` list excludes it. */\n  slot: string\n  /** Human label of the refused destination (`Section · body`). */\n  destinationLabel: string\n}\n\nexport type PasteResolution = PasteTarget | PasteRejection\n\nexport function resolvePasteTarget(args: {\n  root: ComponentNode\n  /** The anchor node (usually the selection); `null` falls back to the root. */\n  anchorId: string | null\n  /** The pasted subtree's root component — the id the slot leash judges. */\n  componentId: string\n  getManifest: (componentId: string) => ComponentManifest | undefined\n}): PasteResolution {\n  const { root, componentId, getManifest } = args\n  const anchor = args.anchorId !== null ? getNode(root, args.anchorId) : undefined\n  const node = anchor ?? root\n\n  const leashed = (\n    slot: string,\n    slotRule: SlotRule | undefined,\n    target: InsertTarget,\n    destinationLabel: string,\n  ): PasteResolution =>\n    slotAllows(slotRule, componentId)\n      ? { ok: true, target, destinationLabel }\n      : { ok: false, code: 'not-allowed', componentId, slot, destinationLabel }\n\n  // EC-386: the shared slot rule (`primaryInsertSlot` over the merged\n  // `manifestRules` vocabulary) — a blocks-prop region (e.g. a Section's `body`)\n  // receives the paste exactly like the insert dialog and a DnD `into`.\n  const manifest = getManifest(node.componentId)\n  const childSlot = primaryInsertSlot(manifestRules(manifest))\n  if (childSlot) {\n    return leashed(\n      childSlot.name,\n      childSlot,\n      { parentId: node.id, slot: childSlot.name },\n      `${shortId(node.componentId)} · ${childSlot.name}`,\n    )\n  }\n\n  const info = getParentInfo(root, node.id)\n  if (info) {\n    // A sibling paste is governed by the PARENT's slot leash (the drop rule's\n    // before/after case). An unknown parent manifest imposes no allow-list;\n    // validation owns that issue.\n    const parentSlot = manifestRules(getManifest(info.parent.componentId))?.slots.find((s) => s.name === info.slot)\n    return leashed(\n      info.slot,\n      parentSlot,\n      { parentId: info.parent.id, slot: info.slot, index: info.index + 1 },\n      `${shortId(info.parent.componentId)} · ${info.slot}`,\n    )\n  }\n\n  // Leaf root with no declared slots (degenerate graphs): append to `children`.\n  return { ok: true, target: { parentId: root.id, slot: 'children' }, destinationLabel: 'root' }\n}\n"]}
+{"version":3,"file":"paste-target.js","sourceRoot":"","sources":["../../../src/lib/clipboard/paste-target.ts"],"names":[],"mappings":"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","sourcesContent":["import { getNode, getParentInfo } from '@elytracms/core/project-graph'\nimport type { ComponentNode, InsertTarget } from '@elytracms/core/project-graph'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport { manifestRules, placementRefusal, primaryInsertSlot } from '@elytracms/studio/lib/dnd/drop-rules'\nimport type { SlotRule } from '@elytracms/studio/lib/dnd/drop-rules'\nimport { shortId } from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Paste landing-spot resolution (EC-175) — the same placement rule the Insert\n * dialog uses (`insert-context.ts`): a pasted subtree lands *into*\n * the anchor node's child slot when it has one, else *after* the anchor as a\n * sibling, else appended to the page root. Pure and selection-driven so the\n * canvas, the page tree, and keyboard paste all share one rule.\n *\n * EC-545: the resolved slot's `allow` leash is checked HERE, for the pasted\n * subtree's root, through the same `slotAllows` the drop rule reads — so a\n * component drag-and-drop refuses is refused by clipboard too, and a caller\n * cannot reach an `InsertTarget` without passing the check (the rejection is a\n * separate member of the result union, not a flag beside the target). Nested\n * validity of the pasted subtree stays with the publish gate, exactly like a\n * drop.\n *\n * EC-554: the composition FIELD's top-level `allow` is checked here too, through\n * the same `placementRefusal` → `fieldAllowAt` the drop rule and the insert offer\n * read — a paste that lands as a direct child of the composition root must be in\n * the field's vocabulary.\n */\n\nexport interface PasteTarget {\n  ok: true\n  target: InsertTarget\n  /** Human label of where the paste lands (notices/debugging). */\n  destinationLabel: string\n}\n\n/** The resolved slot's own `allow` list excludes the pasted root (EC-545). */\nexport interface PasteSlotRejection {\n  ok: false\n  code: 'not-allowed'\n  /** The pasted root the slot refuses. */\n  componentId: string\n  /** The resolved slot whose `allow` list excludes it. */\n  slot: string\n  /** Human label of the refused destination (`Section · body`). */\n  destinationLabel: string\n}\n\n/**\n * The composition field's top-level `allow` excludes the pasted root (EC-554).\n * Deliberately carries NO slot/destination label: the refused slot is the\n * invisible synthetic root's (`Stack · children`), and the reason to show is the\n * FIELD — the notice names it from the editor's field scope.\n */\nexport interface PasteFieldRejection {\n  ok: false\n  code: 'field-not-allowed'\n  /** The pasted root the field vocabulary refuses. */\n  componentId: string\n}\n\nexport type PasteRejection = PasteSlotRejection | PasteFieldRejection\n\nexport type PasteResolution = PasteTarget | PasteRejection\n\nexport function resolvePasteTarget(args: {\n  root: ComponentNode\n  /** The anchor node (usually the selection); `null` falls back to the root. */\n  anchorId: string | null\n  /** The pasted subtree's root component — the id the slot leash judges. */\n  componentId: string\n  getManifest: (componentId: string) => ComponentManifest | undefined\n  /**\n   * The composition field's top-level `allow` (EC-554) — `undefined` when the\n   * field declares none. Required so no caller can forget to pass it.\n   */\n  fieldAllow: readonly string[] | undefined\n}): PasteResolution {\n  const { root, componentId, getManifest, fieldAllow } = args\n  const anchor = args.anchorId !== null ? getNode(root, args.anchorId) : undefined\n  const node = anchor ?? root\n\n  const leashed = (\n    slot: string,\n    slotRule: SlotRule | undefined,\n    target: InsertTarget,\n    destinationLabel: string,\n  ): PasteResolution => {\n    const refusal = placementRefusal({ root, parentId: target.parentId, slot: slotRule, fieldAllow, componentId })\n    if (refusal === 'field') return { ok: false, code: 'field-not-allowed', componentId }\n    if (refusal === 'slot') return { ok: false, code: 'not-allowed', componentId, slot, destinationLabel }\n    return { ok: true, target, destinationLabel }\n  }\n\n  // EC-386: the shared slot rule (`primaryInsertSlot` over the merged\n  // `manifestRules` vocabulary) — a blocks-prop region (e.g. a Section's `body`)\n  // receives the paste exactly like the insert dialog and a DnD `into`.\n  const manifest = getManifest(node.componentId)\n  const childSlot = primaryInsertSlot(manifestRules(manifest))\n  if (childSlot) {\n    return leashed(\n      childSlot.name,\n      childSlot,\n      { parentId: node.id, slot: childSlot.name },\n      `${shortId(node.componentId)} · ${childSlot.name}`,\n    )\n  }\n\n  const info = getParentInfo(root, node.id)\n  if (info) {\n    // A sibling paste is governed by the PARENT's slot leash (the drop rule's\n    // before/after case). An unknown parent manifest imposes no allow-list;\n    // validation owns that issue.\n    const parentSlot = manifestRules(getManifest(info.parent.componentId))?.slots.find((s) => s.name === info.slot)\n    return leashed(\n      info.slot,\n      parentSlot,\n      { parentId: info.parent.id, slot: info.slot, index: info.index + 1 },\n      `${shortId(info.parent.componentId)} · ${info.slot}`,\n    )\n  }\n\n  // Leaf root with no declared slots (degenerate graphs): append to `children`.\n  // No slot rule exists, but the paste still lands at the root — the field leash\n  // applies.\n  return leashed('children', undefined, { parentId: root.id, slot: 'children' }, 'root')\n}\n"]}

package/dist/lib/cms/published-documents.js

@@ -5,6 +5,7 @@ const PUBLISHED_RELOAD_OPS = [
     'documents.unpublish',
     'documents.restore',
     'documents.delete',
+    'documents.clear',
 ];
 const EMPTY_POOL = new Map();
 /**

package/dist/lib/cms/published-documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"published-documents.js","sourceRoot":"","sources":["../../../src/lib/cms/published-documents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAsB/D,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG;IAC3B,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;CACV,CAAA;AAEV,MAAM,UAAU,GAAqC,IAAI,GAAG,EAAE,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA4B,EAC5B,SAAiB,EACjB,YAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAA;IAChG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC3C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAA6B,EAC7B,YAAoB;IAEpB,MAAM,KAAK,GAAG,iBAAiB,CAA2B;QACxD,4EAA4E;QAC5E,QAAQ,EAAE,CAAC,oBAAoB,EAAE,SAAS,IAAI,GAAG,EAAE,YAAY,CAAC;QAChE,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAmB,EAAE,YAAY,CAAC;QAC7F,YAAY,EAAE,oBAAoB;QAClC,OAAO,EAAE,SAAS,KAAK,SAAS;KACjC,CAAC,CAAA;IACF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACzE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAC1F,CAAC","sourcesContent":["import type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { OperationsClient } from '../operations'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\n\n/**\n * The PUBLISHED-perspective documents of a collection (EC-205, \"live = published\")\n * — the pinned published snapshot of each currently-published document, keyed by\n * id. Live surfaces (a document's live URL + \"View live\", EC-216) MUST derive\n * from this, never from the draft rows the studio edits: an unpublished document,\n * or an unpublished `slug`/`parent` edit, must never leak into a \"live\" URL. The\n * pool is exactly the set the live site would serve, so composing a nested page's\n * URL from these ancestors yields the URL the live site actually resolves.\n *\n * EC-308/AD-17: loaded + kept fresh through the one `useOperationQuery` cache\n * seam — invalidated only when a publish/unpublish/restore/delete command\n * succeeds (NOT on every autosave upsert — a draft edit doesn't change what's\n * published). Cost: ONE bulk `documents.listPublished` read (EC-307).\n */\nexport interface PublishedDocuments {\n  /** Pinned published snapshot per published document id. Empty while loading. */\n  byId: ReadonlyMap<string, CmsDocument>\n  status: 'loading' | 'ready'\n}\n\n/** Commands that change which version is pinned live (and thus the pool). */\nconst PUBLISHED_RELOAD_OPS = [\n  'documents.publish',\n  'documents.unpublish',\n  'documents.restore',\n  'documents.delete',\n] as const\n\nconst EMPTY_POOL: ReadonlyMap<string, CmsDocument> = new Map()\n\n/**\n * Build the published pool of a collection (pure over the operations client): the\n * pinned published snapshot of every currently-published document, keyed by id.\n * EC-307: one bulk `documents.listPublished` read — the backend resolves each\n * `publishedVersion` pointer to its recorded snapshot — instead of a `list` plus a\n * per-document `listVersions` fan-out. Read failures degrade to an empty pool.\n */\nexport async function loadPublishedDocuments(\n  operations: OperationsClient,\n  projectId: string,\n  collectionId: string,\n): Promise<Map<string, CmsDocument>> {\n  const result = await operations.documents.listPublished({ projectId, collection: collectionId })\n  if (!result.ok) return new Map()\n  const byId = new Map<string, CmsDocument>()\n  for (const snapshot of result.value) byId.set(snapshot.id, snapshot)\n  return byId\n}\n\nexport function usePublishedDocuments(\n  projectId: string | undefined,\n  collectionId: string,\n): PublishedDocuments {\n  const query = useOperationQuery<Map<string, CmsDocument>>({\n    // Playground/fixture mode (no backend) is `enabled: false` → never queried.\n    queryKey: ['publishedDocuments', projectId ?? '∅', collectionId],\n    loader: (operations) => loadPublishedDocuments(operations, projectId as string, collectionId),\n    invalidateOn: PUBLISHED_RELOAD_OPS,\n    enabled: projectId !== undefined,\n  })\n  if (projectId === undefined) return { byId: EMPTY_POOL, status: 'ready' }\n  return { byId: query.data ?? EMPTY_POOL, status: query.isPending ? 'loading' : 'ready' }\n}\n"]}
+{"version":3,"file":"published-documents.js","sourceRoot":"","sources":["../../../src/lib/cms/published-documents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAsB/D,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG;IAC3B,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;CACT,CAAA;AAEV,MAAM,UAAU,GAAqC,IAAI,GAAG,EAAE,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA4B,EAC5B,SAAiB,EACjB,YAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAA;IAChG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC3C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAA6B,EAC7B,YAAoB;IAEpB,MAAM,KAAK,GAAG,iBAAiB,CAA2B;QACxD,4EAA4E;QAC5E,QAAQ,EAAE,CAAC,oBAAoB,EAAE,SAAS,IAAI,GAAG,EAAE,YAAY,CAAC;QAChE,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAmB,EAAE,YAAY,CAAC;QAC7F,YAAY,EAAE,oBAAoB;QAClC,OAAO,EAAE,SAAS,KAAK,SAAS;KACjC,CAAC,CAAA;IACF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACzE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAC1F,CAAC","sourcesContent":["import type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { OperationsClient } from '../operations'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\n\n/**\n * The PUBLISHED-perspective documents of a collection (EC-205, \"live = published\")\n * — the pinned published snapshot of each currently-published document, keyed by\n * id. Live surfaces (a document's live URL + \"View live\", EC-216) MUST derive\n * from this, never from the draft rows the studio edits: an unpublished document,\n * or an unpublished `slug`/`parent` edit, must never leak into a \"live\" URL. The\n * pool is exactly the set the live site would serve, so composing a nested page's\n * URL from these ancestors yields the URL the live site actually resolves.\n *\n * EC-308/AD-17: loaded + kept fresh through the one `useOperationQuery` cache\n * seam — invalidated only when a publish/unpublish/restore/delete command\n * succeeds (NOT on every autosave upsert — a draft edit doesn't change what's\n * published). Cost: ONE bulk `documents.listPublished` read (EC-307).\n */\nexport interface PublishedDocuments {\n  /** Pinned published snapshot per published document id. Empty while loading. */\n  byId: ReadonlyMap<string, CmsDocument>\n  status: 'loading' | 'ready'\n}\n\n/** Commands that change which version is pinned live (and thus the pool). */\nconst PUBLISHED_RELOAD_OPS = [\n  'documents.publish',\n  'documents.unpublish',\n  'documents.restore',\n  'documents.delete',\n  'documents.clear',\n] as const\n\nconst EMPTY_POOL: ReadonlyMap<string, CmsDocument> = new Map()\n\n/**\n * Build the published pool of a collection (pure over the operations client): the\n * pinned published snapshot of every currently-published document, keyed by id.\n * EC-307: one bulk `documents.listPublished` read — the backend resolves each\n * `publishedVersion` pointer to its recorded snapshot — instead of a `list` plus a\n * per-document `listVersions` fan-out. Read failures degrade to an empty pool.\n */\nexport async function loadPublishedDocuments(\n  operations: OperationsClient,\n  projectId: string,\n  collectionId: string,\n): Promise<Map<string, CmsDocument>> {\n  const result = await operations.documents.listPublished({ projectId, collection: collectionId })\n  if (!result.ok) return new Map()\n  const byId = new Map<string, CmsDocument>()\n  for (const snapshot of result.value) byId.set(snapshot.id, snapshot)\n  return byId\n}\n\nexport function usePublishedDocuments(\n  projectId: string | undefined,\n  collectionId: string,\n): PublishedDocuments {\n  const query = useOperationQuery<Map<string, CmsDocument>>({\n    // Playground/fixture mode (no backend) is `enabled: false` → never queried.\n    queryKey: ['publishedDocuments', projectId ?? '∅', collectionId],\n    loader: (operations) => loadPublishedDocuments(operations, projectId as string, collectionId),\n    invalidateOn: PUBLISHED_RELOAD_OPS,\n    enabled: projectId !== undefined,\n  })\n  if (projectId === undefined) return { byId: EMPTY_POOL, status: 'ready' }\n  return { byId: query.data ?? EMPTY_POOL, status: query.isPending ? 'loading' : 'ready' }\n}\n"]}

package/dist/lib/cms-views/view-model.d.ts

@@ -38,8 +38,8 @@ export type FilterClause = z.infer<typeof filterClauseSchema>;
 export declare const viewSortSchema: z.ZodObject<{
     field: z.ZodString;
     dir: z.ZodEnum<{
-        asc: "asc";
         desc: "desc";
+        asc: "asc";
     }>;
 }, z.core.$strip>;
 export type ViewSort = z.infer<typeof viewSortSchema>;
@@ -63,8 +63,8 @@ export declare const tableViewStateSchema: z.ZodObject<{
     sort: z.ZodNullable<z.ZodObject<{
         field: z.ZodString;
         dir: z.ZodEnum<{
-            asc: "asc";
             desc: "desc";
+            asc: "asc";
         }>;
     }, z.core.$strip>>;
     columns: z.ZodArray<z.ZodString>;
@@ -305,8 +305,8 @@ export declare const configViewSchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         field: z.ZodString;
         dir: z.ZodEnum<{
-            asc: "asc";
             desc: "desc";
+            asc: "asc";
         }>;
     }, z.core.$strip>>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/lib/data/collection-content.d.ts

@@ -1,5 +1,5 @@
 import type { ContentQueryError, GetDocumentResult, ListDocumentsQuery, ListDocumentsResult, ResolvedDocument } from '@elytracms/core/content';
-import type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig, RouteRecord } from '@elytracms/core/cms-core';
+import type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig, OrphanedCollection, RouteRecord } from '@elytracms/core/cms-core';
 import type { AssetRecord } from '@elytracms/core/persistence';
 import type { ListingQuery } from '@elytracms/core/runtime-renderer';
 /**
@@ -58,6 +58,17 @@ export interface ContentSessionState {
      * (playground/tests) → assets come only from `asset`-collection fixture docs.
      */
     assets?: readonly AssetRecord[];
+    /**
+     * EC-606 — the stored rows the session does NOT serve: per undeclared collection,
+     * how many rows and how many published (`HydratedCms.orphans`, carried here by
+     * `contentSessionOf`'s spread). The preview engine never reads it. It rides this
+     * session because this is the one hydrated-content channel that reaches the
+     * section rail in both modes: the rail renders outside `ProjectSessionProvider`,
+     * so it cannot read the project session context, and a second documents query
+     * would be a parallel data flow (AD-17). Read via {@link contentSessionOrphans}.
+     * Absent (a kit session, tests) → none.
+     */
+    orphans?: readonly OrphanedCollection[];
 }
 /**
  * Default (no-session) collection schema: EMPTY. The studio ships no demo content
@@ -93,6 +104,16 @@ export declare function subscribeContentSession(listener: () => void): () => voi
 export declare function configureContentSession(next: ContentSessionState | null): void;
 /** Whether a hydrated content session is configured (Convex mode). */
 export declare function hasContentSession(): boolean;
+/**
+ * The active session's orphaned collections (EC-606), or an empty list with no
+ * session. Referentially stable between `configureContentSession` calls (the
+ * session's own array, or one shared empty constant), so it is a valid
+ * `useSyncExternalStore(subscribeContentSession, contentSessionOrphans, …)`
+ * snapshot — the rail foot reads it exactly that way.
+ */
+export declare function contentSessionOrphans(): readonly OrphanedCollection[];
+/** The server snapshot for {@link contentSessionOrphans}: no session exists during SSR. */
+export declare function serverContentSessionOrphans(): readonly OrphanedCollection[];
 /** Resolve a collection in the active content session (fixtures in playground). */
 export declare function playgroundCollection(id: string): CollectionDef | undefined;
 /**

package/dist/lib/data/collection-content.js

@@ -54,6 +54,21 @@ export function configureContentSession(next) {
 export function hasContentSession() {
     return contentSession !== null;
 }
+const NO_ORPHANS = [];
+/**
+ * The active session's orphaned collections (EC-606), or an empty list with no
+ * session. Referentially stable between `configureContentSession` calls (the
+ * session's own array, or one shared empty constant), so it is a valid
+ * `useSyncExternalStore(subscribeContentSession, contentSessionOrphans, …)`
+ * snapshot — the rail foot reads it exactly that way.
+ */
+export function contentSessionOrphans() {
+    return contentSession?.orphans ?? NO_ORPHANS;
+}
+/** The server snapshot for {@link contentSessionOrphans}: no session exists during SSR. */
+export function serverContentSessionOrphans() {
+    return NO_ORPHANS;
+}
 /** The collections the preview engine currently serves (session or fixtures). */
 function activeCollections() {
     return contentSession?.collections ?? playgroundCollections;

package/dist/lib/data/collection-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-content.js","sourceRoot":"","sources":["../../../src/lib/data/collection-content.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createContentClient,\n  createContentContext,\n  queryError,\n  validateLimit,\n  validateSort,\n  validateWhere,\n} from '@elytracms/core/content'\nimport type {\n  ContentClient,\n  ContentDocumentSource,\n  ContentLookup,\n  ContentQueryError,\n  GetDocumentResult,\n  ListDocumentsQuery,\n  ListDocumentsResult,\n  ResolvedDocument,\n} from '@elytracms/core/content'\nimport { documentKey, resolveDocumentTitle } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentRef,\n  Locale,\n  LocaleConfig,\n  RouteRecord,\n} from '@elytracms/core/cms-core'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport type { ListingQuery } from '@elytracms/core/runtime-renderer'\nimport { getStudioLocale, getStudioLocaleConfig } from '../locale/locale-store'\n\n/**\n * The studio's content delivery engine for canvas previews (EC-166).\n *\n * Repeating sections and template pages preview *delivery-shaped* documents —\n * the exact shape `@elytracms/core/content` serves in production — so the canvas\n * shows what publishing will show. This module wires the canonical content\n * client (closed AD-3 query vocabulary, published perspective, EC-018 locale\n * fallback, depth-1 population, resolved assets) over a **content session**:\n *\n * - Convex mode: the project-session gate (`components/studio/project-session`)\n *   configures the session with the project's HYDRATED schema + documents, so\n *   \"Preview with\" lists and section previews show the live content — never\n *   fixture titles (EC-177 gap 1).\n * - Playground mode (EC-361): the SAME hydration loader runs over the seeded\n *   in-memory adapter (through operations — AD-17), so canvas listing/relation\n *   population resolves from the in-memory session documents with identical\n *   semantics. With no session configured (tests, boot instants, no persisted\n *   content) the engine serves nothing.\n *\n * Nothing here invents query semantics; both modes go through the same\n * canonical client.\n */\n\n/** The schema + documents the preview engine serves (one project session). */\nexport interface ContentSessionState {\n  collections: readonly CollectionDef[]\n  documents: readonly CmsDocument[]\n  /**\n   * Published document keys via the version POINTER (EC-224). When present, the\n   * preview's published perspective resolves by the pin — never the flat\n   * `state` enum — so it matches what delivery serves. Absent (playground\n   * fixtures / tests) → the rows' own `state` gates the perspective, unchanged.\n   */\n  publishedKeys?: readonly string[]\n  /**\n   * Locale config of the session content — the project's own, composed by\n   * `contentSessionOf` from `elytra.config.ts`. Absent (a kit session, tests) →\n   * the ambient studio config, then the single locale being asked for; EC-479\n   * retired the engine's `sampleLocaleConfig` fallback here.\n   */\n  localeConfig?: LocaleConfig\n  /**\n   * The project's config-sourced routes (EC-207). Wired into the content client so\n   * the canvas preview's `resolveLink` (EC-291) derives a rich-text link's URL from\n   * the SAME routes delivery serves — the studio-live half of the host link bake.\n   * Absent (playground/tests) → no routes, so `resolveLink` returns null and a\n   * reference link degrades to the visible `unresolved-ref` issue.\n   */\n  routes?: readonly RouteRecord[]\n  /**\n   * The project's asset records (assets table). Wired into the lookup so the\n   * content client resolves `asset`-typed FIELDS on listing/relation results\n   * (e.g. a ProductGrid product's `gallery`) to delivery shape — the same assets\n   * the renderer's `resolveAsset` reads for static props (EC-262). Absent\n   * (playground/tests) → assets come only from `asset`-collection fixture docs.\n   */\n  assets?: readonly AssetRecord[]\n}\n\n/**\n * Default (no-session) collection schema: EMPTY. The studio ships no demo content\n * (Oli, 2026-06-19) — with no backend/content session configured, there is nothing\n * to preview, and the studio says so rather than serving fixtures. A real project's\n * collections + documents arrive via {@link configureContentSession} in BOTH modes\n * (EC-361): Convex hydration, or the playground's seeded in-memory adapter through\n * the same loader.\n */\nexport const playgroundCollections: readonly CollectionDef[] = []\n\n/**\n * The perspective a canvas preview resolves references against (EC-300/AD-16). The\n * canvas is draft-coherent: the editable Draft view resolves references to their\n * `'draft'` targets (so a just-made reusable shows immediately), the read-only\n * Published view resolves `'published'` (an honest preview of what delivery serves;\n * an unpublished hard ref shows the in-canvas placeholder). Delivery stays\n * published-only — this does not weaken `live-is-published-only`.\n */\nexport type CanvasPerspective = 'draft' | 'published'\n\nlet contentSession: ContentSessionState | null = null\nlet lookup: ContentLookup = createLookup(playgroundCollections, [], [])\n// Keyed by locale + perspective (EC-300) + the resolved locale CONFIG (EC-479) —\n// one deterministic client per distinct resolution context. See `clientFor`.\nconst clients = new Map<string, ContentClient>()\n\n// EC-460: a monotonically increasing session epoch + listener set, so a REACT\n// surface (the canvas render context) can re-render when the session is\n// re-pointed at fresher content. The session itself stays a module global (the\n// EC-361 design); this only makes \"it changed\" observable — `configureContentSession`\n// remains the single setter.\nlet sessionEpoch = 0\nconst sessionListeners = new Set<() => void>()\n\n/** The current content-session epoch — bumps on every `configureContentSession`. */\nexport function contentSessionEpoch(): number {\n  return sessionEpoch\n}\n\n/**\n * Subscribe to content-session swaps (EC-460). The listener fires after every\n * `configureContentSession`; returns the unsubscribe. Shaped for\n * `useSyncExternalStore(subscribeContentSession, contentSessionEpoch)`.\n */\nexport function subscribeContentSession(listener: () => void): () => void {\n  sessionListeners.add(listener)\n  return () => sessionListeners.delete(listener)\n}\n\n/**\n * Point the preview engine at a project's hydrated content — Convex hydration\n * or the playground's in-memory persisted state (EC-361), both through the same\n * `loadHydratedCms` loader — or back at the empty no-session default (`null`).\n */\nexport function configureContentSession(next: ContentSessionState | null): void {\n  contentSession = next\n  lookup = next\n    ? createLookup(next.collections, next.documents, next.publishedKeys, next.assets)\n    : createLookup(playgroundCollections, [], [])\n  clients.clear()\n  sessionEpoch += 1\n  for (const listener of [...sessionListeners]) listener()\n}\n\n/** Whether a hydrated content session is configured (Convex mode). */\nexport function hasContentSession(): boolean {\n  return contentSession !== null\n}\n\n/** The collections the preview engine currently serves (session or fixtures). */\nfunction activeCollections(): readonly CollectionDef[] {\n  return contentSession?.collections ?? playgroundCollections\n}\n\n/**\n * The sentinel {@link previewLocale} yields when NOTHING has declared a locale —\n * no ambient studio config, no content session. It is not a locale code and\n * matches no stored key, which is the point: with no session the lookup is empty\n * (`playgroundCollections` is `[]`), so every query already resolves to nothing\n * and this only fills `CacheTags.locale`, which no studio surface reads. EC-479:\n * the engine used to answer this question with its `sampleLocaleConfig` fixture's\n * `en` — a locale nobody chose, standing in for the project's own.\n */\nconst NO_LOCALE = ''\n\n/**\n * The locale a canvas preview resolves in, when the caller names none: the\n * ambient studio locale (installed from the PROJECT's config by `CmsProvider`),\n * else the active content session's own declared default (surfaces that render\n * outside a CMS session — the Components view's previews — still resolve in the\n * project's locale), else {@link NO_LOCALE}. Never an engine fixture.\n */\nfunction previewLocale(): Locale {\n  return getStudioLocale() ?? contentSession?.localeConfig?.default ?? NO_LOCALE\n}\n\n/**\n * The locale set a preview resolves fallbacks against (EC-018): the session's own\n * declaration, else the ambient studio config (the project's, via `elytra.config.ts`),\n * else the single locale actually being asked for.\n *\n * That last step is a DERIVATION, not an invention — it says \"the only locale we\n * know of is the one you named\", so `documentDefaultLocale` falls back to the\n * document's own `defaultLocale` and then to `doc.values`. Before EC-479 this line\n * read `?? sampleLocaleConfig`, which silently declared every locale-less studio\n * bilingual `en/de` and resolved fallbacks through an `en` no project had chosen.\n */\nfunction activeLocaleConfig(locale: Locale): LocaleConfig {\n  return (\n    contentSession?.localeConfig ??\n    getStudioLocaleConfig() ?? { default: locale, locales: [locale] }\n  )\n}\n\n/** Resolve a collection in the active content session (fixtures in playground). */\nexport function playgroundCollection(id: string): CollectionDef | undefined {\n  return activeCollections().find((collection) => collection.id === id)\n}\n\n/**\n * Overlay the active session's canonical `filterable` declarations onto a\n * schema that doesn't carry any of its own. The inspector hands the Content\n * tab fixture collection defs; the filter/sort pickers must offer exactly the\n * EC-143 declaration set the delivery engine enforces, so both ends agree. A\n * collection that declares its own filterable fields is left untouched.\n */\nexport function withPlaygroundFilterable(\n  collections: readonly CollectionDef[],\n): readonly CollectionDef[] {\n  return collections.map((collection) => {\n    if (collection.fields.some((field) => field.filterable === true)) return collection\n    const counterpart = playgroundCollection(collection.id)\n    if (counterpart === undefined) return collection\n    const flagged = new Set(\n      counterpart.fields.filter((field) => field.filterable === true).map((field) => field.name),\n    )\n    if (flagged.size === 0) return collection\n    return {\n      ...collection,\n      fields: collection.fields.map((field) =>\n        flagged.has(field.name) ? { ...field, filterable: true } : field,\n      ),\n    }\n  })\n}\n\n/** Synthesize the persistence-shaped asset record the asset resolver reads. */\nfunction assetRecordOf(doc: CmsDocument): AssetRecord {\n  const values = doc.values\n  const alt = doc.localized?.en?.alt\n  return {\n    id: doc.id,\n    projectId: 'playground',\n    filename: typeof values.filename === 'string' ? values.filename : doc.id,\n    contentType: 'image/png',\n    byteSize: 0,\n    alt: typeof alt === 'string' ? alt : undefined,\n    storageKey: typeof values.url === 'string' ? values.url : doc.id,\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  }\n}\n\nfunction createLookup(\n  collectionDefs: readonly CollectionDef[],\n  documents: readonly CmsDocument[],\n  publishedKeys?: readonly string[],\n  assetRecords?: readonly AssetRecord[],\n): ContentLookup {\n  const collections = new Map(collectionDefs.map((c) => [c.id, c]))\n  // EC-224: published-ness is the version POINTER, not the flat `state` enum.\n  // A hydrated session hands `publishedKeys` (the pinned set) → wrap each row as\n  // a `DocumentHistory` so the published perspective resolves by the pin (the\n  // live row is always a draft now) with ZERO dependence on `state`. Without a\n  // pointer set (playground fixtures / tests) we keep bare rows, whose own\n  // `state` gates the published perspective — byte-identical to before.\n  const published = publishedKeys ? new Set(publishedKeys) : null\n  const toSource = (doc: CmsDocument): ContentDocumentSource => {\n    if (!published) return doc\n    return published.has(documentKey({ collection: doc.collection, id: doc.id }))\n      ? { draft: doc, published: doc, versions: [] }\n      : { draft: doc, published: undefined, versions: [] }\n  }\n  const byKey = new Map(\n    documents.map((doc) => [`${doc.collection}:${doc.id}`, toSource(doc)] as const),\n  )\n  // Asset resolution source for `asset`-typed FIELDS on resolved documents\n  // (listing/relation results, e.g. a product's `gallery`). Two sources, real\n  // records last so they win: (1) `asset`-collection fixture documents — how\n  // playground/tests model assets; (2) the project's real asset-table records\n  // (EC-262) — a Convex session has its assets here, NOT as `asset` documents,\n  // so without these the content client resolves no nested image.\n  const assets = new Map<string, AssetRecord>()\n  for (const doc of documents) {\n    if (doc.collection === 'asset') assets.set(doc.id, assetRecordOf(doc))\n  }\n  for (const record of assetRecords ?? []) assets.set(record.id, record)\n  return {\n    collection: (id) => collections.get(id),\n    document: (ref) => byKey.get(`${ref.collection}:${ref.id}`),\n    documents: (collectionId) =>\n      documents.filter((doc) => doc.collection === collectionId).map(toSource),\n    asset: (id) => assets.get(id),\n    // Prefer the record's resolved servable `url` — the one the renderer's\n    // resolveAsset reads (EC-262). Real asset-table records carry a Convex blob\n    // locator in `storageKey` and the servable URL in `url`; fixture/`asset`-document\n    // records (assetRecordOf) leave `url` unset and store the servable url in\n    // `storageKey`. Falling back keeps both correct.\n    assetUrl: (asset) => asset.url ?? asset.storageKey,\n  }\n}\n\n/**\n * One deterministic client per (locale, perspective): EC-018 locale fallback,\n * draft-or-published perspective (EC-300/AD-16, default `'published'`). The studio's\n * ambient active locale (EC-176, `lib/locale`) picks the locale at query time, so the\n * canvas previews follow the locale switcher exactly like delivery would; the canvas's\n * Draft/Published view picks the perspective. The cache resets whenever the content\n * session changes.\n */\nfunction clientFor(locale: Locale, perspective: CanvasPerspective = 'published'): ContentClient {\n  const locales = activeLocaleConfig(locale)\n  // EC-479: the locale CONFIG is part of the client's identity now — it may come\n  // from the ambient studio store, which changes independently of the session the\n  // cache is cleared on, so keying by locale alone could serve a client built\n  // against a superseded locale set.\n  const key = `${locale}:${perspective}:${locales.default}|${locales.locales.join(',')}`\n  const existing = clients.get(key)\n  if (existing) return existing\n  const client = createContentClient({\n    lookup,\n    context: createContentContext({\n      locale,\n      perspective,\n      locales,\n    }),\n    // EC-291: the routes a rich-text link resolves against (config-sourced) — the\n    // studio-live half of the host link bake.\n    routes: contentSession?.routes ?? [],\n  })\n  clients.set(key, client)\n  return client\n}\n\n/**\n * Run a closed-vocabulary list query (AD-3: eq/in/lt/lte/gt/gte, AND-only,\n * filterable fields only) and return the delivery-shaped result. Invalid\n * queries come back as structured errors — never thrown, never silently\n * widened. Resolves in the studio's active locale unless one is passed.\n */\nexport function runCollectionListQuery(\n  collectionId: string,\n  query: ListDocumentsQuery = {},\n  locale: Locale = previewLocale(),\n): ListDocumentsResult {\n  return clientFor(locale).listDocuments(collectionId, query)\n}\n\n/** Resolve one document (by id or slug) into delivery shape. */\nexport function getCollectionDocument(\n  collectionId: string,\n  idOrSlug: string,\n  locale: Locale = previewLocale(),\n): GetDocumentResult {\n  return clientFor(locale).getDocument(collectionId, idOrSlug)\n}\n\n/**\n * Populate a composition-node `relation` prop to delivery shape for the canvas\n * (EC-254) — the studio analog of the host's baked relations map. Resolves the\n * ref through the active session's client (published perspective, active locale),\n * so the canvas previews a block's picked documents (a ProductGrid's products, a\n * Reusable's element) exactly as delivery renders them. `null` when the target is\n * missing or not visible → the block degrades to its own empty state.\n */\nexport function resolveCanvasRelation(\n  ref: DocumentRef,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): ResolvedDocument | null {\n  return clientFor(locale, perspective).resolveRelation(ref)\n}\n\n/**\n * Resolve a listing block's query to its documents for the canvas (EC-255) — the\n * studio analog of the host's baked listings map. Runs the query (collection +\n * AND-only filter, optional sort/limit) through the active session's client\n * (published perspective, active locale), so the canvas previews a dynamic grid (a\n * ProductGrid keyed to a category) exactly as delivery renders it. An invalid query\n * (structured, never thrown) or a non-list lookup yields `[]` → the block's empty\n * state. Reuses the same `listDocuments` path as `runCollectionListQuery`.\n */\nexport function resolveCanvasListing(\n  query: ListingQuery,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): ResolvedDocument[] {\n  const result = clientFor(locale, perspective).listDocuments(query.collection, {\n    where: query.where,\n    ...(query.sort ? { sort: query.sort } : {}),\n    ...(query.limit !== undefined ? { limit: query.limit } : {}),\n  })\n  return result.ok ? result.documents : []\n}\n\n/**\n * Statically validate a listing block's query against the ACTIVE session schema\n * (EC-460, the never-silent rule): the exact `validateWhere`/`validateSort`/\n * `validateLimit` checks `listDocuments` runs, WITHOUT executing the query — so\n * the canvas can surface a config-invalid listing (a filter/sort field the\n * collection doesn't declare `filterable`, an unknown collection) as a visible\n * notice instead of the block's indistinguishable empty state. With no content\n * session configured (boot instants, fixtures) there is no schema to judge\n * against, so it reports nothing rather than false-flagging every listing.\n */\nexport function validateCanvasListingQuery(query: ListingQuery): ContentQueryError[] {\n  if (contentSession === null) return []\n  const collection = playgroundCollection(query.collection)\n  if (!collection) {\n    return [\n      queryError(\n        'unknown-collection',\n        `Collection \"${query.collection}\" is not defined.`,\n        ['collection'],\n        undefined,\n        { key: 'content.queryError.unknownCollection', vars: { collection: query.collection } },\n      ),\n    ]\n  }\n  return [\n    ...validateWhere(collection, query.where),\n    ...(query.sort ? validateSort(collection, query.sort) : []),\n    ...(query.limit !== undefined ? validateLimit(query.limit) : []),\n  ]\n}\n\n/**\n * Resolve a rich-text internal link's target document to its URL path for the canvas\n * (EC-291) — the studio analog of the host's baked links map. Derives the URL through\n * the active session's client (published perspective, active locale, config-sourced\n * routes), so the canvas previews a `{type:'reference'}` link's `href` exactly as\n * delivery serves it. `null` when the target is unpublished, missing, or addressed by\n * no route → the rich-text renderer shows the EC-290 `unresolved-ref` issue. Reuses\n * the same `resolveLink` path as the host bake, so both agree on the derived URL.\n */\nexport function resolveCanvasLink(\n  ref: DocumentRef,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): string | null {\n  return clientFor(locale, perspective).resolveLink(ref)\n}\n\n/** A pickable entry of a collection (the template-page preview switcher). */\nexport interface CollectionEntrySummary {\n  id: string\n  label: string\n}\n\n/** Published entries of a collection, labeled by the schema's title field. */\nexport function listCollectionEntries(collectionId: string): CollectionEntrySummary[] {\n  const collection = playgroundCollection(collectionId)\n  const result = runCollectionListQuery(collectionId)\n  if (!result.ok) return []\n  // EC-242: label via the shared identity resolver (string `titleField` or a\n  // function pattern), over the delivery-shape values; falls back to the id.\n  return result.documents.map((doc) => ({\n    id: doc.id,\n    label: collection ? resolveDocumentTitle(collection, doc, doc.id) : doc.id,\n  }))\n}\n"]}
+{"version":3,"file":"collection-content.js","sourceRoot":"","sources":["../../../src/lib/data/collection-content.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createContentClient,\n  createContentContext,\n  queryError,\n  validateLimit,\n  validateSort,\n  validateWhere,\n} from '@elytracms/core/content'\nimport type {\n  ContentClient,\n  ContentDocumentSource,\n  ContentLookup,\n  ContentQueryError,\n  GetDocumentResult,\n  ListDocumentsQuery,\n  ListDocumentsResult,\n  ResolvedDocument,\n} from '@elytracms/core/content'\nimport { documentKey, resolveDocumentTitle } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentRef,\n  Locale,\n  LocaleConfig,\n  OrphanedCollection,\n  RouteRecord,\n} from '@elytracms/core/cms-core'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport type { ListingQuery } from '@elytracms/core/runtime-renderer'\nimport { getStudioLocale, getStudioLocaleConfig } from '../locale/locale-store'\n\n/**\n * The studio's content delivery engine for canvas previews (EC-166).\n *\n * Repeating sections and template pages preview *delivery-shaped* documents —\n * the exact shape `@elytracms/core/content` serves in production — so the canvas\n * shows what publishing will show. This module wires the canonical content\n * client (closed AD-3 query vocabulary, published perspective, EC-018 locale\n * fallback, depth-1 population, resolved assets) over a **content session**:\n *\n * - Convex mode: the project-session gate (`components/studio/project-session`)\n *   configures the session with the project's HYDRATED schema + documents, so\n *   \"Preview with\" lists and section previews show the live content — never\n *   fixture titles (EC-177 gap 1).\n * - Playground mode (EC-361): the SAME hydration loader runs over the seeded\n *   in-memory adapter (through operations — AD-17), so canvas listing/relation\n *   population resolves from the in-memory session documents with identical\n *   semantics. With no session configured (tests, boot instants, no persisted\n *   content) the engine serves nothing.\n *\n * Nothing here invents query semantics; both modes go through the same\n * canonical client.\n */\n\n/** The schema + documents the preview engine serves (one project session). */\nexport interface ContentSessionState {\n  collections: readonly CollectionDef[]\n  documents: readonly CmsDocument[]\n  /**\n   * Published document keys via the version POINTER (EC-224). When present, the\n   * preview's published perspective resolves by the pin — never the flat\n   * `state` enum — so it matches what delivery serves. Absent (playground\n   * fixtures / tests) → the rows' own `state` gates the perspective, unchanged.\n   */\n  publishedKeys?: readonly string[]\n  /**\n   * Locale config of the session content — the project's own, composed by\n   * `contentSessionOf` from `elytra.config.ts`. Absent (a kit session, tests) →\n   * the ambient studio config, then the single locale being asked for; EC-479\n   * retired the engine's `sampleLocaleConfig` fallback here.\n   */\n  localeConfig?: LocaleConfig\n  /**\n   * The project's config-sourced routes (EC-207). Wired into the content client so\n   * the canvas preview's `resolveLink` (EC-291) derives a rich-text link's URL from\n   * the SAME routes delivery serves — the studio-live half of the host link bake.\n   * Absent (playground/tests) → no routes, so `resolveLink` returns null and a\n   * reference link degrades to the visible `unresolved-ref` issue.\n   */\n  routes?: readonly RouteRecord[]\n  /**\n   * The project's asset records (assets table). Wired into the lookup so the\n   * content client resolves `asset`-typed FIELDS on listing/relation results\n   * (e.g. a ProductGrid product's `gallery`) to delivery shape — the same assets\n   * the renderer's `resolveAsset` reads for static props (EC-262). Absent\n   * (playground/tests) → assets come only from `asset`-collection fixture docs.\n   */\n  assets?: readonly AssetRecord[]\n  /**\n   * EC-606 — the stored rows the session does NOT serve: per undeclared collection,\n   * how many rows and how many published (`HydratedCms.orphans`, carried here by\n   * `contentSessionOf`'s spread). The preview engine never reads it. It rides this\n   * session because this is the one hydrated-content channel that reaches the\n   * section rail in both modes: the rail renders outside `ProjectSessionProvider`,\n   * so it cannot read the project session context, and a second documents query\n   * would be a parallel data flow (AD-17). Read via {@link contentSessionOrphans}.\n   * Absent (a kit session, tests) → none.\n   */\n  orphans?: readonly OrphanedCollection[]\n}\n\n/**\n * Default (no-session) collection schema: EMPTY. The studio ships no demo content\n * (Oli, 2026-06-19) — with no backend/content session configured, there is nothing\n * to preview, and the studio says so rather than serving fixtures. A real project's\n * collections + documents arrive via {@link configureContentSession} in BOTH modes\n * (EC-361): Convex hydration, or the playground's seeded in-memory adapter through\n * the same loader.\n */\nexport const playgroundCollections: readonly CollectionDef[] = []\n\n/**\n * The perspective a canvas preview resolves references against (EC-300/AD-16). The\n * canvas is draft-coherent: the editable Draft view resolves references to their\n * `'draft'` targets (so a just-made reusable shows immediately), the read-only\n * Published view resolves `'published'` (an honest preview of what delivery serves;\n * an unpublished hard ref shows the in-canvas placeholder). Delivery stays\n * published-only — this does not weaken `live-is-published-only`.\n */\nexport type CanvasPerspective = 'draft' | 'published'\n\nlet contentSession: ContentSessionState | null = null\nlet lookup: ContentLookup = createLookup(playgroundCollections, [], [])\n// Keyed by locale + perspective (EC-300) + the resolved locale CONFIG (EC-479) —\n// one deterministic client per distinct resolution context. See `clientFor`.\nconst clients = new Map<string, ContentClient>()\n\n// EC-460: a monotonically increasing session epoch + listener set, so a REACT\n// surface (the canvas render context) can re-render when the session is\n// re-pointed at fresher content. The session itself stays a module global (the\n// EC-361 design); this only makes \"it changed\" observable — `configureContentSession`\n// remains the single setter.\nlet sessionEpoch = 0\nconst sessionListeners = new Set<() => void>()\n\n/** The current content-session epoch — bumps on every `configureContentSession`. */\nexport function contentSessionEpoch(): number {\n  return sessionEpoch\n}\n\n/**\n * Subscribe to content-session swaps (EC-460). The listener fires after every\n * `configureContentSession`; returns the unsubscribe. Shaped for\n * `useSyncExternalStore(subscribeContentSession, contentSessionEpoch)`.\n */\nexport function subscribeContentSession(listener: () => void): () => void {\n  sessionListeners.add(listener)\n  return () => sessionListeners.delete(listener)\n}\n\n/**\n * Point the preview engine at a project's hydrated content — Convex hydration\n * or the playground's in-memory persisted state (EC-361), both through the same\n * `loadHydratedCms` loader — or back at the empty no-session default (`null`).\n */\nexport function configureContentSession(next: ContentSessionState | null): void {\n  contentSession = next\n  lookup = next\n    ? createLookup(next.collections, next.documents, next.publishedKeys, next.assets)\n    : createLookup(playgroundCollections, [], [])\n  clients.clear()\n  sessionEpoch += 1\n  for (const listener of [...sessionListeners]) listener()\n}\n\n/** Whether a hydrated content session is configured (Convex mode). */\nexport function hasContentSession(): boolean {\n  return contentSession !== null\n}\n\nconst NO_ORPHANS: readonly OrphanedCollection[] = []\n\n/**\n * The active session's orphaned collections (EC-606), or an empty list with no\n * session. Referentially stable between `configureContentSession` calls (the\n * session's own array, or one shared empty constant), so it is a valid\n * `useSyncExternalStore(subscribeContentSession, contentSessionOrphans, …)`\n * snapshot — the rail foot reads it exactly that way.\n */\nexport function contentSessionOrphans(): readonly OrphanedCollection[] {\n  return contentSession?.orphans ?? NO_ORPHANS\n}\n\n/** The server snapshot for {@link contentSessionOrphans}: no session exists during SSR. */\nexport function serverContentSessionOrphans(): readonly OrphanedCollection[] {\n  return NO_ORPHANS\n}\n\n/** The collections the preview engine currently serves (session or fixtures). */\nfunction activeCollections(): readonly CollectionDef[] {\n  return contentSession?.collections ?? playgroundCollections\n}\n\n/**\n * The sentinel {@link previewLocale} yields when NOTHING has declared a locale —\n * no ambient studio config, no content session. It is not a locale code and\n * matches no stored key, which is the point: with no session the lookup is empty\n * (`playgroundCollections` is `[]`), so every query already resolves to nothing\n * and this only fills `CacheTags.locale`, which no studio surface reads. EC-479:\n * the engine used to answer this question with its `sampleLocaleConfig` fixture's\n * `en` — a locale nobody chose, standing in for the project's own.\n */\nconst NO_LOCALE = ''\n\n/**\n * The locale a canvas preview resolves in, when the caller names none: the\n * ambient studio locale (installed from the PROJECT's config by `CmsProvider`),\n * else the active content session's own declared default (surfaces that render\n * outside a CMS session — the Components view's previews — still resolve in the\n * project's locale), else {@link NO_LOCALE}. Never an engine fixture.\n */\nfunction previewLocale(): Locale {\n  return getStudioLocale() ?? contentSession?.localeConfig?.default ?? NO_LOCALE\n}\n\n/**\n * The locale set a preview resolves fallbacks against (EC-018): the session's own\n * declaration, else the ambient studio config (the project's, via `elytra.config.ts`),\n * else the single locale actually being asked for.\n *\n * That last step is a DERIVATION, not an invention — it says \"the only locale we\n * know of is the one you named\", so `documentDefaultLocale` falls back to the\n * document's own `defaultLocale` and then to `doc.values`. Before EC-479 this line\n * read `?? sampleLocaleConfig`, which silently declared every locale-less studio\n * bilingual `en/de` and resolved fallbacks through an `en` no project had chosen.\n */\nfunction activeLocaleConfig(locale: Locale): LocaleConfig {\n  return (\n    contentSession?.localeConfig ??\n    getStudioLocaleConfig() ?? { default: locale, locales: [locale] }\n  )\n}\n\n/** Resolve a collection in the active content session (fixtures in playground). */\nexport function playgroundCollection(id: string): CollectionDef | undefined {\n  return activeCollections().find((collection) => collection.id === id)\n}\n\n/**\n * Overlay the active session's canonical `filterable` declarations onto a\n * schema that doesn't carry any of its own. The inspector hands the Content\n * tab fixture collection defs; the filter/sort pickers must offer exactly the\n * EC-143 declaration set the delivery engine enforces, so both ends agree. A\n * collection that declares its own filterable fields is left untouched.\n */\nexport function withPlaygroundFilterable(\n  collections: readonly CollectionDef[],\n): readonly CollectionDef[] {\n  return collections.map((collection) => {\n    if (collection.fields.some((field) => field.filterable === true)) return collection\n    const counterpart = playgroundCollection(collection.id)\n    if (counterpart === undefined) return collection\n    const flagged = new Set(\n      counterpart.fields.filter((field) => field.filterable === true).map((field) => field.name),\n    )\n    if (flagged.size === 0) return collection\n    return {\n      ...collection,\n      fields: collection.fields.map((field) =>\n        flagged.has(field.name) ? { ...field, filterable: true } : field,\n      ),\n    }\n  })\n}\n\n/** Synthesize the persistence-shaped asset record the asset resolver reads. */\nfunction assetRecordOf(doc: CmsDocument): AssetRecord {\n  const values = doc.values\n  const alt = doc.localized?.en?.alt\n  return {\n    id: doc.id,\n    projectId: 'playground',\n    filename: typeof values.filename === 'string' ? values.filename : doc.id,\n    contentType: 'image/png',\n    byteSize: 0,\n    alt: typeof alt === 'string' ? alt : undefined,\n    storageKey: typeof values.url === 'string' ? values.url : doc.id,\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  }\n}\n\nfunction createLookup(\n  collectionDefs: readonly CollectionDef[],\n  documents: readonly CmsDocument[],\n  publishedKeys?: readonly string[],\n  assetRecords?: readonly AssetRecord[],\n): ContentLookup {\n  const collections = new Map(collectionDefs.map((c) => [c.id, c]))\n  // EC-224: published-ness is the version POINTER, not the flat `state` enum.\n  // A hydrated session hands `publishedKeys` (the pinned set) → wrap each row as\n  // a `DocumentHistory` so the published perspective resolves by the pin (the\n  // live row is always a draft now) with ZERO dependence on `state`. Without a\n  // pointer set (playground fixtures / tests) we keep bare rows, whose own\n  // `state` gates the published perspective — byte-identical to before.\n  const published = publishedKeys ? new Set(publishedKeys) : null\n  const toSource = (doc: CmsDocument): ContentDocumentSource => {\n    if (!published) return doc\n    return published.has(documentKey({ collection: doc.collection, id: doc.id }))\n      ? { draft: doc, published: doc, versions: [] }\n      : { draft: doc, published: undefined, versions: [] }\n  }\n  const byKey = new Map(\n    documents.map((doc) => [`${doc.collection}:${doc.id}`, toSource(doc)] as const),\n  )\n  // Asset resolution source for `asset`-typed FIELDS on resolved documents\n  // (listing/relation results, e.g. a product's `gallery`). Two sources, real\n  // records last so they win: (1) `asset`-collection fixture documents — how\n  // playground/tests model assets; (2) the project's real asset-table records\n  // (EC-262) — a Convex session has its assets here, NOT as `asset` documents,\n  // so without these the content client resolves no nested image.\n  const assets = new Map<string, AssetRecord>()\n  for (const doc of documents) {\n    if (doc.collection === 'asset') assets.set(doc.id, assetRecordOf(doc))\n  }\n  for (const record of assetRecords ?? []) assets.set(record.id, record)\n  return {\n    collection: (id) => collections.get(id),\n    document: (ref) => byKey.get(`${ref.collection}:${ref.id}`),\n    documents: (collectionId) =>\n      documents.filter((doc) => doc.collection === collectionId).map(toSource),\n    asset: (id) => assets.get(id),\n    // Prefer the record's resolved servable `url` — the one the renderer's\n    // resolveAsset reads (EC-262). Real asset-table records carry a Convex blob\n    // locator in `storageKey` and the servable URL in `url`; fixture/`asset`-document\n    // records (assetRecordOf) leave `url` unset and store the servable url in\n    // `storageKey`. Falling back keeps both correct.\n    assetUrl: (asset) => asset.url ?? asset.storageKey,\n  }\n}\n\n/**\n * One deterministic client per (locale, perspective): EC-018 locale fallback,\n * draft-or-published perspective (EC-300/AD-16, default `'published'`). The studio's\n * ambient active locale (EC-176, `lib/locale`) picks the locale at query time, so the\n * canvas previews follow the locale switcher exactly like delivery would; the canvas's\n * Draft/Published view picks the perspective. The cache resets whenever the content\n * session changes.\n */\nfunction clientFor(locale: Locale, perspective: CanvasPerspective = 'published'): ContentClient {\n  const locales = activeLocaleConfig(locale)\n  // EC-479: the locale CONFIG is part of the client's identity now — it may come\n  // from the ambient studio store, which changes independently of the session the\n  // cache is cleared on, so keying by locale alone could serve a client built\n  // against a superseded locale set.\n  const key = `${locale}:${perspective}:${locales.default}|${locales.locales.join(',')}`\n  const existing = clients.get(key)\n  if (existing) return existing\n  const client = createContentClient({\n    lookup,\n    context: createContentContext({\n      locale,\n      perspective,\n      locales,\n    }),\n    // EC-291: the routes a rich-text link resolves against (config-sourced) — the\n    // studio-live half of the host link bake.\n    routes: contentSession?.routes ?? [],\n  })\n  clients.set(key, client)\n  return client\n}\n\n/**\n * Run a closed-vocabulary list query (AD-3: eq/in/lt/lte/gt/gte, AND-only,\n * filterable fields only) and return the delivery-shaped result. Invalid\n * queries come back as structured errors — never thrown, never silently\n * widened. Resolves in the studio's active locale unless one is passed.\n */\nexport function runCollectionListQuery(\n  collectionId: string,\n  query: ListDocumentsQuery = {},\n  locale: Locale = previewLocale(),\n): ListDocumentsResult {\n  return clientFor(locale).listDocuments(collectionId, query)\n}\n\n/** Resolve one document (by id or slug) into delivery shape. */\nexport function getCollectionDocument(\n  collectionId: string,\n  idOrSlug: string,\n  locale: Locale = previewLocale(),\n): GetDocumentResult {\n  return clientFor(locale).getDocument(collectionId, idOrSlug)\n}\n\n/**\n * Populate a composition-node `relation` prop to delivery shape for the canvas\n * (EC-254) — the studio analog of the host's baked relations map. Resolves the\n * ref through the active session's client (published perspective, active locale),\n * so the canvas previews a block's picked documents (a ProductGrid's products, a\n * Reusable's element) exactly as delivery renders them. `null` when the target is\n * missing or not visible → the block degrades to its own empty state.\n */\nexport function resolveCanvasRelation(\n  ref: DocumentRef,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): ResolvedDocument | null {\n  return clientFor(locale, perspective).resolveRelation(ref)\n}\n\n/**\n * Resolve a listing block's query to its documents for the canvas (EC-255) — the\n * studio analog of the host's baked listings map. Runs the query (collection +\n * AND-only filter, optional sort/limit) through the active session's client\n * (published perspective, active locale), so the canvas previews a dynamic grid (a\n * ProductGrid keyed to a category) exactly as delivery renders it. An invalid query\n * (structured, never thrown) or a non-list lookup yields `[]` → the block's empty\n * state. Reuses the same `listDocuments` path as `runCollectionListQuery`.\n */\nexport function resolveCanvasListing(\n  query: ListingQuery,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): ResolvedDocument[] {\n  const result = clientFor(locale, perspective).listDocuments(query.collection, {\n    where: query.where,\n    ...(query.sort ? { sort: query.sort } : {}),\n    ...(query.limit !== undefined ? { limit: query.limit } : {}),\n  })\n  return result.ok ? result.documents : []\n}\n\n/**\n * Statically validate a listing block's query against the ACTIVE session schema\n * (EC-460, the never-silent rule): the exact `validateWhere`/`validateSort`/\n * `validateLimit` checks `listDocuments` runs, WITHOUT executing the query — so\n * the canvas can surface a config-invalid listing (a filter/sort field the\n * collection doesn't declare `filterable`, an unknown collection) as a visible\n * notice instead of the block's indistinguishable empty state. With no content\n * session configured (boot instants, fixtures) there is no schema to judge\n * against, so it reports nothing rather than false-flagging every listing.\n */\nexport function validateCanvasListingQuery(query: ListingQuery): ContentQueryError[] {\n  if (contentSession === null) return []\n  const collection = playgroundCollection(query.collection)\n  if (!collection) {\n    return [\n      queryError(\n        'unknown-collection',\n        `Collection \"${query.collection}\" is not defined.`,\n        ['collection'],\n        undefined,\n        { key: 'content.queryError.unknownCollection', vars: { collection: query.collection } },\n      ),\n    ]\n  }\n  return [\n    ...validateWhere(collection, query.where),\n    ...(query.sort ? validateSort(collection, query.sort) : []),\n    ...(query.limit !== undefined ? validateLimit(query.limit) : []),\n  ]\n}\n\n/**\n * Resolve a rich-text internal link's target document to its URL path for the canvas\n * (EC-291) — the studio analog of the host's baked links map. Derives the URL through\n * the active session's client (published perspective, active locale, config-sourced\n * routes), so the canvas previews a `{type:'reference'}` link's `href` exactly as\n * delivery serves it. `null` when the target is unpublished, missing, or addressed by\n * no route → the rich-text renderer shows the EC-290 `unresolved-ref` issue. Reuses\n * the same `resolveLink` path as the host bake, so both agree on the derived URL.\n */\nexport function resolveCanvasLink(\n  ref: DocumentRef,\n  locale: Locale = previewLocale(),\n  perspective: CanvasPerspective = 'published',\n): string | null {\n  return clientFor(locale, perspective).resolveLink(ref)\n}\n\n/** A pickable entry of a collection (the template-page preview switcher). */\nexport interface CollectionEntrySummary {\n  id: string\n  label: string\n}\n\n/** Published entries of a collection, labeled by the schema's title field. */\nexport function listCollectionEntries(collectionId: string): CollectionEntrySummary[] {\n  const collection = playgroundCollection(collectionId)\n  const result = runCollectionListQuery(collectionId)\n  if (!result.ok) return []\n  // EC-242: label via the shared identity resolver (string `titleField` or a\n  // function pattern), over the delivery-shape values; falls back to the id.\n  return result.documents.map((doc) => ({\n    id: doc.id,\n    label: collection ? resolveDocumentTitle(collection, doc, doc.id) : doc.id,\n  }))\n}\n"]}

package/dist/lib/data/index.d.ts

@@ -1,6 +1,3 @@
-export * from './data-store.js';
-export * from './sample-capture.js';
-export * from './sources-store.js';
 export * from './collection-content.js';
 export * from './content-session-refresh.js';
 export * from './playground-unload-guard.js';

package/dist/lib/data/index.js

@@ -1,10 +1,8 @@
-export * from './data-store.js';
-export * from './sample-capture.js';
-export * from './sources-store.js';
+// EC-574: the data-source store, sample capture, providers and sources-store that
+// used to live here went with the data-binding subsystem. What remains is the
+// canvas's content session (collection-content), its write-sync refresh and the
+// playground unload guard.
 export * from './collection-content.js';
 export * from './content-session-refresh.js';
 export * from './playground-unload-guard.js';
-// Data providers (EC-167) are imported from './providers' directly: the module
-// exports a `DataProvider` domain type that would collide with the store's
-// `<DataProvider>` React provider in a wildcard barrel.
 //# sourceMappingURL=index.js.map

package/dist/lib/data/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,+EAA+E;AAC/E,2EAA2E;AAC3E,wDAAwD","sourcesContent":["export * from './data-store'\nexport * from './sample-capture'\nexport * from './sources-store'\nexport * from './collection-content'\nexport * from './content-session-refresh'\nexport * from './playground-unload-guard'\n// Data providers (EC-167) are imported from './providers' directly: the module\n// exports a `DataProvider` domain type that would collide with the store's\n// `<DataProvider>` React provider in a wildcard barrel.\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/data/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,8EAA8E;AAC9E,gFAAgF;AAChF,2BAA2B;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA","sourcesContent":["// EC-574: the data-source store, sample capture, providers and sources-store that\n// used to live here went with the data-binding subsystem. What remains is the\n// canvas's content session (collection-content), its write-sync refresh and the\n// playground unload guard.\nexport * from './collection-content'\nexport * from './content-session-refresh'\nexport * from './playground-unload-guard'\n"]}