@elytracms/studio 0.0.100 → 0.0.101

package/dist/components/builder/reuse.js

@@ -1,6 +1,6 @@
-import { manifestPropFields, manifestSlots } from '@elytracms/core/component-registry';
-import { fieldAllowList, itemLimit, readDocumentRef, referenceNode, seedDefaults, titleFieldOf, writeField, } from '@elytracms/core/cms-core';
-import { editBlockRoots, isStaticProp, replacePlacementRefusal, valuePlacementRefusal } from '@elytracms/core/project-graph';
+import { manifestPropFields } from '@elytracms/core/component-registry';
+import { documentKey, fieldAllowList, itemLimit, readDocumentRef, referenceNode, seedDefaults, titleFieldOf, writeField, } from '@elytracms/core/cms-core';
+import { editBlockRoots, isStaticProp, replacePlacementRefusal, staticProp, valuePlacementRefusal, } from '@elytracms/core/project-graph';
 import { slugify } from '../../lib/utils.js';
 import { fieldLabel } from '../cms/cms-labels.js';
 /** The customization point name stamped onto every reuse issue (EC-236 locator). */
@@ -11,13 +11,7 @@ function relationPropsOf(manifest) {
     for (const field of manifestPropFields(manifest)) {
         if (field.type !== 'relation')
             continue;
-        const hidden = field.form?.hidden;
-        props.push({
-            name: field.name,
-            target: field.target,
-            multiple: field.multiple === true,
-            conditional: hidden !== undefined && hidden !== false,
-        });
+        props.push({ name: field.name, target: field.target, multiple: field.multiple === true });
     }
     return props;
 }
@@ -47,7 +41,6 @@ const REUSE_KEYS = {
     ambiguousRelationProp: 'builder.reuse.config.ambiguousRelationProp',
     unknownCollection: 'builder.reuse.config.unknownCollection',
     noBlocksField: 'builder.reuse.config.noBlocksField',
-    ambiguousInference: 'builder.reuse.config.ambiguousInference',
 };
 function reuseIssue(code, severity, message, messageRef, id) {
     return {
@@ -64,54 +57,11 @@ function quotedList(names) {
     return names.map((name) => `"${name}"`).join(', ');
 }
 /**
- * The components whose SHAPE makes them plausible reuse embeds (the zero-config
- * heuristic + EC-462's disqualifiers), in manifest order. Exported for the tests
- * and for issue copy; the resolution rule lives in {@link resolveReuse}.
- */
-export function inferredEmbedCandidates(manifests, collections) {
-    const matches = [];
-    for (const manifest of manifests) {
-        // EC-591 (COMPOSITION #15): the DERIVED slots — a `blocks` prop is a child
-        // region (`manifestSlots`), so a manifest with `slots: []` and a blocks prop is
-        // NOT slot-less; reading raw `manifest.slots` inferred it as a reuse embed.
-        if (manifestSlots(manifest).length > 0)
-            continue;
-        // EC-462: a `listing` manifest is a query host by its own declaration — its
-        // relation prop is the filter source, never an embed pointer.
-        if (manifest.listing)
-            continue;
-        // The heuristic requires the relation to be UNAMBIGUOUS within the manifest:
-        // exactly ONE relation prop of any kind, which must then be targeted,
-        // cardinality-one and unconditional. (Counting all relation props — not just
-        // the embeddable ones — is deliberate: a component with a second, list-valued
-        // relation is not the single-purpose shape the heuristic is allowed to claim.)
-        const relations = relationPropsOf(manifest);
-        const relation = relations.length === 1 ? relations[0] : undefined;
-        if (!relation || relation.target === undefined || relation.multiple || relation.conditional)
-            continue;
-        const collection = collections.find((c) => c.id === relation.target);
-        if (!collection)
-            continue;
-        const blocksField = blocksFieldOf(collection);
-        if (!blocksField)
-            continue;
-        matches.push({
-            embedComponentId: manifest.id,
-            relationProp: relation.name,
-            collectionId: collection.id,
-            contentField: blocksField.name,
-            contentCardinality: itemLimit(blocksField) === 1 ? 'one' : 'many',
-        });
-    }
-    return matches;
-}
-/**
- * Resolve the DECLARED embed (EC-467, AD-b). An explicit declaration is the
- * developer's authority, so the inference disqualifiers are NOT applied here: a
- * declared component may have slots, may declare `listing`, and its relation prop
- * may be `form.hidden` — those exist to stop the engine GUESSING, not to overrule
- * a stated intent. Only structural impossibilities are issues (see AD-c row 2):
- * an unknown component id, no usable relation prop (or an ambiguous set with no
+ * Resolve the DECLARED embed (EC-467, AD-b). The declaration is the developer's
+ * authority: a declared component may have slots, may declare `listing`, and its
+ * relation prop may be `form.hidden` — the engine does not second-guess a stated
+ * intent. Only structural impossibilities are issues (see AD-c row 2): an unknown
+ * component id, no usable relation prop (or an ambiguous set with no
  * `relationProp`), an undefined target collection, or a target with no `blocks`
  * field — each of which would leave nothing coherent to transclude.
  */
@@ -126,7 +76,7 @@ function resolveDeclaredReuse(declaration, manifests, collections) {
         return {
             capability: null,
             issues: [
-                reuseIssue('unknown-override-target', 'error', `Reusable elements: studio config declares reuse.component "${component}", which is not a registered component. Fix the id, or remove the reuse block to let the studio infer the embed.`, { key: REUSE_KEYS.unknownComponent, vars: { component } }, component),
+                reuseIssue('unknown-override-target', 'error', `Reusable elements: studio config declares reuse.component "${component}", which is not a registered component. Fix the id to name your embed component — until then the reuse gestures are off.`, { key: REUSE_KEYS.unknownComponent, vars: { component } }, component),
             ],
         };
     }
@@ -181,51 +131,30 @@ function resolveDeclaredReuse(declaration, manifests, collections) {
     };
 }
 /**
- * Resolve the project's ONE reuse capability (AD-a) plus any config issues —
- * EC-467's full matrix (AD-c):
- *
- * | Declaration | Candidates | Result |
- * | --- | --- | --- |
- * | present, resolves | any | the declared capability, no issue |
- * | present, does not resolve | any | `null` + an ERROR issue (misconfiguration) |
- * | absent | exactly 1 | that candidate, no issue (the zero-config default) |
- * | absent | 2 or more | `null` + a WARNING issue naming every candidate |
- * | absent | 0 | `null`, **no issue** — a project need not use reusable elements |
+ * Resolve the project's ONE reuse capability (AD-a) plus any config issues — EC-728's
+ * matrix (declare, never infer):
  *
- * Severity is the honest split: a declaration that cannot resolve is broken
- * config the developer asked for (error); inference ambiguity is nothing broken —
- * the engine declines to guess and asks for one line (warning). Both disable the
- * gestures, and both render identically in the rail's issue list.
+ * | Declaration | Result |
+ * | --- | --- |
+ * | present, resolves | the declared capability, no issue |
+ * | present, does not resolve | `null` + an ERROR issue (misconfiguration) |
+ * | absent | `null`, **no issue** — the project has no reusable elements |
  *
- * The zero-candidate row is deliberately silent: crying wolf at every project
- * that has no reusable elements would train developers to ignore the surface.
+ * The absent row is deliberately silent: a project need not use reusable elements,
+ * and naming a component that "looks like an embed" would be the guess again, as
+ * advice (EC-728). An unresolvable declaration disables the gestures and is reported
+ * once, in the header Issues popover.
  */
 export function resolveReuse(manifests, collections, declaration) {
-    if (declaration)
-        return resolveDeclaredReuse(declaration, manifests, collections);
-    const candidates = inferredEmbedCandidates(manifests, collections);
-    if (candidates.length === 1)
-        return { capability: candidates[0], issues: [] };
-    if (candidates.length === 0)
+    if (!declaration)
         return { capability: null, issues: [] };
-    return {
-        capability: null,
-        issues: [
-            reuseIssue('ambiguous-inference', 'warning', `Reusable elements: ${candidates.length} components have the reusable-embed shape (${quotedList(candidates.map((c) => c.embedComponentId))}). A project has exactly one reusable-element embed, so the studio will not guess — declare it in studio.config as reuse: { component: '<id>' }. Until then the reuse gestures are off.`, {
-                key: REUSE_KEYS.ambiguousInference,
-                vars: {
-                    count: candidates.length,
-                    components: quotedList(candidates.map((c) => c.embedComponentId)),
-                },
-            }),
-        ],
-    };
+    return resolveDeclaredReuse(declaration, manifests, collections);
 }
 /**
- * The project's reuse capability alone, or `null` when it is absent, ambiguous, or
+ * The project's reuse capability alone, or `null` when it is undeclared or
  * misdeclared — for callers that act on the capability and do not surface config
- * issues themselves (the publish-integrity walk). The issues are surfaced ONCE, by
- * the shell rail; see {@link resolveReuse}.
+ * issues themselves (the gestures, the canvas placeholder). The issues are surfaced
+ * ONCE, by the shell; see {@link resolveReuse}.
  */
 export function resolveReuseCapability(manifests, collections, declaration) {
     return resolveReuse(manifests, collections, declaration).capability;
@@ -241,7 +170,7 @@ export function uniqueSlug(name, taken) {
 /**
  * The values for a new reusable document promoted from `node` (EC-282): seeded
  * defaults, the given `name` on the title field, the node on the content field,
- * and a collision-safe slug on any UNIQUE text field (e.g. Konditorei's
+ * and a collision-safe slug on any UNIQUE text field (e.g. a production site's
  * `internalId`) so the created document is publish-valid without hardcoding that
  * field's name. Other required fields, if any, are completed by the editor when
  * they open the new reusable.
@@ -285,17 +214,23 @@ export function reuseEmbedRef(node, capability) {
     const ref = isStaticProp(prop) ? readDocumentRef(prop.value) : undefined;
     return ref ?? null;
 }
-/** The `Reusable` embed node referencing the new document (id minted by the action). */
+/**
+ * The `Reusable` embed node referencing the new document (id minted by the action).
+ *
+ * EC-728 — CANONICAL from the first write: the prop is core's `staticProp` (bare `{ value }`,
+ * EC-312), never `{ kind: 'static', value }`. The canvas commits its node patches raw, while
+ * the draft takes the same write through the self-typing lens, which strips a redundant
+ * `kind`; a non-canonical node therefore made the two views of the canvas field disagree, the
+ * draft reported the disagreement as a change made underneath the canvas, and the rebase
+ * dropped *Make reusable*'s own undo step (`reuse-undo.test.ts`).
+ */
 export function makeEmbedNode(capability, documentId) {
     return {
         id: 'reuse-embed',
         componentId: capability.embedComponentId,
         props: {
-            [capability.relationProp]: {
-                kind: 'static',
-                // EC-589 / EC-586: a reference is a typed envelope from the first write.
-                value: referenceNode({ collection: capability.collectionId, id: documentId }),
-            },
+            // EC-589 / EC-586: a reference is a typed envelope from the first write.
+            [capability.relationProp]: staticProp(referenceNode({ collection: capability.collectionId, id: documentId })),
         },
     };
 }
@@ -339,8 +274,9 @@ export function detachRefusal(args) {
 /**
  * Run "Make reusable" (EC-282) — the preflight first (EC-584: a refusal creates,
  * publishes and replaces NOTHING), then ONE insert-if-absent create of the reusable
- * document (EC-595 A2), the in-place swap for the embed, and the chosen publish,
- * whose success notice is shown only when the document is actually published.
+ * document (EC-595 A2), the in-place swap for the embed — one canvas history entry that
+ * records the created document (EC-728) — and the chosen publish, whose success notice is
+ * shown only when the document is actually published.
  */
 export async function runPromote(args) {
     const { root, nodeId, node, name, capability, collection, placement, canvasFieldLabel, effects } = args;
@@ -351,8 +287,9 @@ export async function runPromote(args) {
     }
     const ref = { collection: capability.collectionId, id: effects.newDocumentId() };
     const content = buildReusableValues(collection, capability, name, node, args.existing, args.locales);
-    effects.insertDocument({ ...ref, ...content });
-    effects.replaceInCanvas(nodeId, makeEmbedNode(capability, ref.id));
+    const document = { ...ref, ...content };
+    effects.insertDocument(document);
+    effects.replaceInCanvas(nodeId, makeEmbedNode(capability, ref.id), { kind: 'reusable-created', ref, name, document });
     if (!args.publish) {
         effects.madeDraft(name);
         return 'draft';
@@ -365,4 +302,84 @@ export async function runPromote(args) {
     effects.publishFailed(name);
     return 'publish-failed';
 }
+/**
+ * EC-728 — Undo of *Make reusable*, the document side. The created document is deleted ONLY
+ * when every authoritative fact at Undo time says nobody else has it: never published (the
+ * record), referenced nowhere — after the page's own restore has landed — (the reference
+ * index, both variants), and unchanged since its create (the delete's revision precondition,
+ * checked by the store in its own step, which also refuses a strict referrer). Anything else
+ * keeps it, with the reason. A read that throws keeps it too: an unproven fact never deletes.
+ */
+export async function undoPromote(effect, deps) {
+    try {
+        await deps.flush();
+        const record = await deps.read(effect.ref);
+        if (!record)
+            return 'gone';
+        if (record.published)
+            return 'published';
+        if ((await deps.referrers(effect.ref)) > 0)
+            return 'referenced';
+        switch (await deps.deleteCreated(effect.ref)) {
+            case 'deleted':
+                return 'deleted';
+            case 'gone':
+                return 'gone';
+            case 'changed':
+                return 'edited';
+            case 'referenced':
+                return 'referenced';
+            default:
+                return 'failed';
+        }
+    }
+    catch {
+        return 'failed';
+    }
+}
+/** The notice for a KEPT document (EC-728 — it names the document and why); none when it went. */
+export function undoPromoteNotice(outcome) {
+    switch (outcome) {
+        case 'published':
+            return 'builder.reuse.undoKeptPublished';
+        case 'edited':
+            return 'builder.reuse.undoKeptEdited';
+        case 'referenced':
+            return 'builder.reuse.undoKeptReferenced';
+        case 'failed':
+            return 'builder.reuse.undoKeptFailed';
+        default:
+            return undefined;
+    }
+}
+/**
+ * EC-728 — the document side of every Undo/Redo that crosses a *Make reusable* step, for one
+ * canvas. Crossings run strictly in order (a Redo waits for the Undo before it), so a fast
+ * Undo → Redo never re-inserts a document whose removal is still in flight. Redo re-inserts
+ * (the same id, insert-if-absent) exactly the documents ITS Undo removed or found gone — never
+ * one Undo kept (it is still there) — and the canvas entry re-swaps the embed.
+ */
+export function createPromoteHistory(deps) {
+    const removed = new Set();
+    let chain = Promise.resolve();
+    return {
+        crossed(step) {
+            chain = chain.then(async () => {
+                const key = documentKey(step.effect.ref);
+                if (step.direction === 'redo') {
+                    if (removed.delete(key))
+                        deps.insert(step.effect.document);
+                    return;
+                }
+                const outcome = await undoPromote(step.effect, deps);
+                if (outcome === 'deleted' || outcome === 'gone')
+                    removed.add(key);
+                const notice = undoPromoteNotice(outcome);
+                if (notice)
+                    deps.notify(notice, step.effect.name);
+            });
+            return chain;
+        },
+    };
+}
 //# sourceMappingURL=reuse.js.map

package/dist/components/builder/reuse.js.map

@@ -1 +1 @@
-{"version":3,"file":"reuse.js","sourceRoot":"","sources":["../../../src/components/builder/reuse.ts"],"names":[],"mappings":"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","sourcesContent":["import { manifestPropFields, manifestSlots } from '@elytracms/core/component-registry'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport {\n  fieldAllowList,\n  itemLimit,\n  readDocumentRef,\n  referenceNode,\n  seedDefaults,\n  titleFieldOf,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef, LocaleConfig } from '@elytracms/core/cms-core'\nimport { editBlockRoots, isStaticProp, replacePlacementRefusal, valuePlacementRefusal } from '@elytracms/core/project-graph'\nimport type { ComponentNode, PlacementScope, PlacementVerdict } from '@elytracms/core/project-graph'\nimport type { CustomizationIssue, CustomizationMessageRef } from '@elytracms/core/studio-core'\nimport { slugify } from '../../lib/utils'\nimport { fieldLabel } from '../cms/cms-labels'\n\n/**\n * The reuse capability (EC-282): the engine-generic description of how a project\n * models reusable elements. **AD-a (EC-467): reusable elements are SINGULAR per\n * project** — exactly one embed component and exactly one reusable collection.\n * Multiple reuse collections are deliberately not supported, which is why this is\n * one value and never a list.\n *\n * The capability is normally DERIVED from config (manifests + collections) — no\n * declaration needed, so a consumer that already has a transcluding embed gets the\n * in-canvas gestures for free (the EC-296 \"works automatically\" pattern). The\n * derivation predicate for a \"reusable embed\" component: it contributes no slots of\n * its own and has exactly ONE `relation` prop (cardinality `one`) whose target\n * collection holds a `blocks` field — i.e. it embeds a single document and renders\n * that document's composition by transclusion (EC-254/EC-281). For Konditorei that\n * is uniquely `project.Reusable` → `element` → `reusable.content`.\n *\n * EC-462 — the predicate additionally DISQUALIFIES a candidate whose own manifest\n * explicitly declares its relation prop to be something other than an embed\n * pointer. The shape test alone proved unsound the moment a relation prop's\n * target collection gains a `blocks` field of its own (a category/page with a\n * canvas — a completely natural content shape): the EC-276 sprint's ProductGrid\n * and the demo's OptionBox were both claimed as \"the embed\", so their ordinary\n * relation picks rendered the reusable-element placeholder, grew Detach/Make-\n * reusable gestures, and fed embed-worded publish-integrity issues. Two\n * explicit-declaration disqualifiers close the observed class:\n *\n * - a manifest with a `listing` declaration is a QUERY host (EC-255) — its\n *   relation prop feeds the query (a `{ prop }` operand of `listing.where`),\n *   never a transclusion pointer;\n * - a relation prop with `form.hidden` (predicate or `true`) is conditional/\n *   auxiliary — EC-394 strips a hidden relation's ref at publish, so it cannot\n *   coherently be what the component transcludes.\n *\n * Both read only the CANDIDATE manifest's own declarations (never the target's\n * contents) and can only EXCLUDE, so a genuine pure embed (which declares\n * neither) is always kept. EC-462's residual — a bare unconditional\n * single-relation display component (e.g. a page teaser) is at rest\n * indistinguishable from a genuine embed — is closed by EC-467's optional\n * {@link StudioReuseConfig} declaration: a project that hits ambiguity declares\n * its way out, and the ambiguity is LOUD instead of silently disabling the\n * gestures. See {@link resolveReuse}.\n */\nexport interface ReuseCapability {\n  /** The embed component, e.g. `project.Reusable`. */\n  embedComponentId: string\n  /** The embed's relation prop that points at the reusable document, e.g. `element`. */\n  relationProp: string\n  /** The collection reusable documents live in, e.g. `reusable`. */\n  collectionId: string\n  /** The collection's composition field the embed transcludes, e.g. `content`. */\n  contentField: string\n  /** Whether that field holds a single block or a list. */\n  contentCardinality: 'one' | 'many'\n}\n\n/**\n * EC-467 (AD-b) — the OPTIONAL studio-config declaration of the reuse embed:\n * `defineStudio({ reuse: { component: 'project.Reusable' } })`. See\n * {@link import('../app-views/studio-config').StudioConfig.reuse} for the\n * consumer-facing contract; this is the shape {@link resolveReuse} consumes.\n *\n * One identifier is enough because the rest DERIVES from it (its single-document\n * relation prop → that prop's target collection → that collection's `blocks`\n * field), and because reusable elements are singular per project (AD-a).\n */\nexport interface StudioReuseConfig {\n  /** The embed component's registry id, e.g. `'project.Reusable'`. */\n  component: string\n  /**\n   * Which relation prop points at the reusable document. Needed ONLY when the\n   * declared component legitimately has more than one single-document relation\n   * prop — otherwise the sole one is derived.\n   */\n  relationProp?: string\n}\n\n/**\n * EC-467 — the resolution of the project's reuse capability: the capability (or\n * `null`), plus the config issues a developer must SEE.\n *\n * The issues ride the EC-236 {@link CustomizationIssue} surface (`point: 'reuse'`),\n * exactly like the sidebar's and the field renderers' — so they render at the\n * studio rail foot on every surface, which is the studio's home for\n * project-CONFIGURATION problems (the document-scoped Issues pane is the wrong\n * home: this is not a content problem in one document).\n *\n * EC-478: each issue carries a `messageRef` (catalog key + identifier values)\n * alongside its prebuilt English, so the rail foot renders it in the active UI\n * locale. This module stays pure — it names a key, it never calls `translate`;\n * `lib/persona/labels.ts` resolves it at the render site. That is what makes the\n * whole list localize together, which is the mixed-language outcome EC-467\n * declined to create by localizing only its own half.\n */\nexport interface ReuseResolution {\n  capability: ReuseCapability | null\n  /** Empty whenever the capability is unambiguous — including \"this project has none\". */\n  issues: CustomizationIssue[]\n}\n\n/** The customization point name stamped onto every reuse issue (EC-236 locator). */\nconst REUSE_POINT = 'reuse'\n\n/** A `relation` prop of a manifest, normalized for both resolution paths. */\ninterface RelationProp {\n  name: string\n  /** The target collection id; `undefined` when the manifest declares none. */\n  target: string | undefined\n  multiple: boolean\n  /** EC-462: `form.hidden` present and not literally `false` (predicate or `true`). */\n  conditional: boolean\n}\n\n/** Every `relation` prop of a manifest, in declaration order. */\nfunction relationPropsOf(manifest: ComponentManifest): RelationProp[] {\n  const props: RelationProp[] = []\n  for (const field of manifestPropFields(manifest)) {\n    if (field.type !== 'relation') continue\n    const hidden = field.form?.hidden\n    props.push({\n      name: field.name,\n      target: field.target,\n      multiple: field.multiple === true,\n      conditional: hidden !== undefined && hidden !== false,\n    })\n  }\n  return props\n}\n\n/**\n * The relation props a DECLARED embed could plausibly transclude through: targeted\n * and cardinality-one. A cardinality-`many` (or targetless) relation is excluded\n * structurally, not heuristically — an embed transcludes exactly one document and\n * {@link makeEmbedNode} writes exactly one `{collection,id}`, which a list-valued\n * or target-less prop cannot hold.\n */\nfunction embeddableRelationProps(manifest: ComponentManifest): TargetedRelationProp[] {\n  return relationPropsOf(manifest).filter(\n    (r): r is TargetedRelationProp => r.target !== undefined && !r.multiple,\n  )\n}\ntype TargetedRelationProp = RelationProp & { target: string }\n\n/** The collection's first composition field — what an embed of it transcludes. */\nfunction blocksFieldOf(collection: CollectionDef) {\n  const field = collection.fields.find((f) => f.type === 'blocks')\n  return field?.type === 'blocks' ? field : undefined\n}\n\n/**\n * The catalog keys for the reuse config issues (EC-478), in the `builder.reuse.config.*`\n * namespace. Named here so the producer and the catalog-parity test agree on one list.\n */\nconst REUSE_KEYS = {\n  unknownComponent: 'builder.reuse.config.unknownComponent',\n  noRelationProp: 'builder.reuse.config.noRelationProp',\n  unknownRelationProp: 'builder.reuse.config.unknownRelationProp',\n  ambiguousRelationProp: 'builder.reuse.config.ambiguousRelationProp',\n  unknownCollection: 'builder.reuse.config.unknownCollection',\n  noBlocksField: 'builder.reuse.config.noBlocksField',\n  ambiguousInference: 'builder.reuse.config.ambiguousInference',\n} as const\n\nfunction reuseIssue(\n  code: CustomizationIssue['code'],\n  severity: CustomizationIssue['severity'],\n  message: string,\n  messageRef: CustomizationMessageRef,\n  id?: string,\n): CustomizationIssue {\n  return {\n    code,\n    severity,\n    message,\n    messageRef,\n    point: REUSE_POINT,\n    ...(id === undefined ? {} : { id }),\n  }\n}\n\n/** `\"a\", \"b\"` — a readable list of prop/component ids for an issue message. */\nfunction quotedList(names: readonly string[]): string {\n  return names.map((name) => `\"${name}\"`).join(', ')\n}\n\n/**\n * The components whose SHAPE makes them plausible reuse embeds (the zero-config\n * heuristic + EC-462's disqualifiers), in manifest order. Exported for the tests\n * and for issue copy; the resolution rule lives in {@link resolveReuse}.\n */\nexport function inferredEmbedCandidates(\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n): ReuseCapability[] {\n  const matches: ReuseCapability[] = []\n  for (const manifest of manifests) {\n    // EC-591 (COMPOSITION #15): the DERIVED slots — a `blocks` prop is a child\n    // region (`manifestSlots`), so a manifest with `slots: []` and a blocks prop is\n    // NOT slot-less; reading raw `manifest.slots` inferred it as a reuse embed.\n    if (manifestSlots(manifest).length > 0) continue\n    // EC-462: a `listing` manifest is a query host by its own declaration — its\n    // relation prop is the filter source, never an embed pointer.\n    if (manifest.listing) continue\n    // The heuristic requires the relation to be UNAMBIGUOUS within the manifest:\n    // exactly ONE relation prop of any kind, which must then be targeted,\n    // cardinality-one and unconditional. (Counting all relation props — not just\n    // the embeddable ones — is deliberate: a component with a second, list-valued\n    // relation is not the single-purpose shape the heuristic is allowed to claim.)\n    const relations = relationPropsOf(manifest)\n    const relation = relations.length === 1 ? relations[0]! : undefined\n    if (!relation || relation.target === undefined || relation.multiple || relation.conditional)\n      continue\n    const collection = collections.find((c) => c.id === relation.target)\n    if (!collection) continue\n    const blocksField = blocksFieldOf(collection)\n    if (!blocksField) continue\n    matches.push({\n      embedComponentId: manifest.id,\n      relationProp: relation.name,\n      collectionId: collection.id,\n      contentField: blocksField.name,\n      contentCardinality: itemLimit(blocksField) === 1 ? 'one' : 'many',\n    })\n  }\n  return matches\n}\n\n/**\n * Resolve the DECLARED embed (EC-467, AD-b). An explicit declaration is the\n * developer's authority, so the inference disqualifiers are NOT applied here: a\n * declared component may have slots, may declare `listing`, and its relation prop\n * may be `form.hidden` — those exist to stop the engine GUESSING, not to overrule\n * a stated intent. Only structural impossibilities are issues (see AD-c row 2):\n * an unknown component id, no usable relation prop (or an ambiguous set with no\n * `relationProp`), an undefined target collection, or a target with no `blocks`\n * field — each of which would leave nothing coherent to transclude.\n */\nfunction resolveDeclaredReuse(\n  declaration: StudioReuseConfig,\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n): ReuseResolution {\n  const { component, relationProp } = declaration\n  const fail = (message: string, messageRef: CustomizationMessageRef): ReuseResolution => ({\n    capability: null,\n    issues: [reuseIssue('invalid-override', 'error', message, messageRef, component)],\n  })\n\n  const manifest = manifests.find((m) => m.id === component)\n  if (!manifest) {\n    return {\n      capability: null,\n      issues: [\n        reuseIssue(\n          'unknown-override-target',\n          'error',\n          `Reusable elements: studio config declares reuse.component \"${component}\", which is not a registered component. Fix the id, or remove the reuse block to let the studio infer the embed.`,\n          { key: REUSE_KEYS.unknownComponent, vars: { component } },\n          component,\n        ),\n      ],\n    }\n  }\n\n  const relations = embeddableRelationProps(manifest)\n  if (relations.length === 0) {\n    return fail(\n      `Reusable elements: the declared embed \"${component}\" has no single-document relation prop, so it cannot point at a reusable document. An embed needs one relation prop with cardinality one.`,\n      { key: REUSE_KEYS.noRelationProp, vars: { component } },\n    )\n  }\n  const names = relations.map((r) => r.name)\n  let relation: TargetedRelationProp\n  if (relationProp !== undefined) {\n    const named = relations.find((r) => r.name === relationProp)\n    if (!named) {\n      return fail(\n        `Reusable elements: the declared embed \"${component}\" has no single-document relation prop named \"${relationProp}\". Its relation props are: ${quotedList(names)}.`,\n        {\n          key: REUSE_KEYS.unknownRelationProp,\n          vars: { component, relationProp, props: quotedList(names) },\n        },\n      )\n    }\n    relation = named\n  } else if (relations.length === 1) {\n    relation = relations[0]!\n  } else {\n    return fail(\n      `Reusable elements: the declared embed \"${component}\" has ${relations.length} single-document relation props (${quotedList(names)}) — add reuse.relationProp to say which one points at the reusable document.`,\n      {\n        key: REUSE_KEYS.ambiguousRelationProp,\n        vars: { component, count: relations.length, props: quotedList(names) },\n      },\n    )\n  }\n\n  const collection = collections.find((c) => c.id === relation.target)\n  if (!collection) {\n    return fail(\n      `Reusable elements: \"${component}.${relation.name}\" targets the collection \"${relation.target}\", which this project does not define.`,\n      {\n        key: REUSE_KEYS.unknownCollection,\n        vars: { component, relationProp: relation.name, collection: relation.target },\n      },\n    )\n  }\n  const blocksField = blocksFieldOf(collection)\n  if (!blocksField) {\n    return fail(\n      `Reusable elements: the collection \"${collection.id}\" behind \"${component}.${relation.name}\" has no blocks (composition) field, so there is nothing for the embed to transclude.`,\n      {\n        key: REUSE_KEYS.noBlocksField,\n        vars: { component, relationProp: relation.name, collection: collection.id },\n      },\n    )\n  }\n\n  return {\n    capability: {\n      embedComponentId: manifest.id,\n      relationProp: relation.name,\n      collectionId: collection.id,\n      contentField: blocksField.name,\n      contentCardinality: itemLimit(blocksField) === 1 ? 'one' : 'many',\n    },\n    issues: [],\n  }\n}\n\n/**\n * Resolve the project's ONE reuse capability (AD-a) plus any config issues —\n * EC-467's full matrix (AD-c):\n *\n * | Declaration | Candidates | Result |\n * | --- | --- | --- |\n * | present, resolves | any | the declared capability, no issue |\n * | present, does not resolve | any | `null` + an ERROR issue (misconfiguration) |\n * | absent | exactly 1 | that candidate, no issue (the zero-config default) |\n * | absent | 2 or more | `null` + a WARNING issue naming every candidate |\n * | absent | 0 | `null`, **no issue** — a project need not use reusable elements |\n *\n * Severity is the honest split: a declaration that cannot resolve is broken\n * config the developer asked for (error); inference ambiguity is nothing broken —\n * the engine declines to guess and asks for one line (warning). Both disable the\n * gestures, and both render identically in the rail's issue list.\n *\n * The zero-candidate row is deliberately silent: crying wolf at every project\n * that has no reusable elements would train developers to ignore the surface.\n */\nexport function resolveReuse(\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n  declaration?: StudioReuseConfig,\n): ReuseResolution {\n  if (declaration) return resolveDeclaredReuse(declaration, manifests, collections)\n\n  const candidates = inferredEmbedCandidates(manifests, collections)\n  if (candidates.length === 1) return { capability: candidates[0]!, issues: [] }\n  if (candidates.length === 0) return { capability: null, issues: [] }\n  return {\n    capability: null,\n    issues: [\n      reuseIssue(\n        'ambiguous-inference',\n        'warning',\n        `Reusable elements: ${candidates.length} components have the reusable-embed shape (${quotedList(\n          candidates.map((c) => c.embedComponentId),\n        )}). A project has exactly one reusable-element embed, so the studio will not guess — declare it in studio.config as reuse: { component: '<id>' }. Until then the reuse gestures are off.`,\n        {\n          key: REUSE_KEYS.ambiguousInference,\n          vars: {\n            count: candidates.length,\n            components: quotedList(candidates.map((c) => c.embedComponentId)),\n          },\n        },\n      ),\n    ],\n  }\n}\n\n/**\n * The project's reuse capability alone, or `null` when it is absent, ambiguous, or\n * misdeclared — for callers that act on the capability and do not surface config\n * issues themselves (the publish-integrity walk). The issues are surfaced ONCE, by\n * the shell rail; see {@link resolveReuse}.\n */\nexport function resolveReuseCapability(\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n  declaration?: StudioReuseConfig,\n): ReuseCapability | null {\n  return resolveReuse(manifests, collections, declaration).capability\n}\n\n/** A slug for `name`, suffixed `-2`/`-3`/… until it is free among `taken`. */\nexport function uniqueSlug(name: string, taken: ReadonlySet<string>): string {\n  const base = slugify(name) || 'element'\n  let id = base\n  for (let n = 2; taken.has(id); n += 1) id = `${base}-${n}`\n  return id\n}\n\n/**\n * The values for a new reusable document promoted from `node` (EC-282): seeded\n * defaults, the given `name` on the title field, the node on the content field,\n * and a collision-safe slug on any UNIQUE text field (e.g. Konditorei's\n * `internalId`) so the created document is publish-valid without hardcoding that\n * field's name. Other required fields, if any, are completed by the editor when\n * they open the new reusable.\n *\n * EC-580: every write goes through core's `writeField` in the project's DEFAULT\n * locale — the new document is created in its default bucket, so a localized title\n * or content field lands under `localized[default]`, never on the shared bag.\n */\nexport function buildReusableValues(\n  collection: CollectionDef,\n  capability: ReuseCapability,\n  name: string,\n  node: ComponentNode,\n  existing: readonly { values?: Record<string, unknown> }[],\n  locales: LocaleConfig,\n): Pick<CmsDocument, 'values' | 'localized'> {\n  const at = locales.default\n  let doc: CmsDocument = { collection: collection.id, id: '', ...seedDefaults(collection, locales) }\n  const titleField = titleFieldOf(collection)?.name\n  if (titleField) doc = writeField(collection, doc, titleField, at, name)\n  for (const field of collection.fields) {\n    if (\n      field.type === 'text' &&\n      field.validation?.unique === true &&\n      field.name !== titleField &&\n      field.name !== capability.contentField\n    ) {\n      const taken = new Set(\n        existing\n          .map((d) => d.values?.[field.name])\n          .filter((v): v is string => typeof v === 'string'),\n      )\n      doc = writeField(collection, doc, field.name, at, uniqueSlug(name, taken))\n    }\n  }\n  // EC-576: the converged v2 sequence holding the tagged node, through the core\n  // write path — never the pre-0.0.84 bare node/array. Cardinality is a\n  // constraint over that one shape, not a second shape (EC-500 D2).\n  doc = writeField(collection, doc, capability.contentField, at, editBlockRoots(undefined, () => [node]))\n  return { values: doc.values, ...(doc.localized !== undefined ? { localized: doc.localized } : {}) }\n}\n\n/**\n * The document a reuse-embed `node` targets (EC-300), or null when `node` is not the\n * embed component or has no static pick yet. Lets the canvas detect a HARD reference\n * whose target doesn't resolve (→ placeholder) without reaching into prop internals.\n */\nexport function reuseEmbedRef(node: ComponentNode, capability: ReuseCapability): DocumentRef | null {\n  if (node.componentId !== capability.embedComponentId) return null\n  const prop = node.props?.[capability.relationProp]\n  const ref = isStaticProp(prop) ? readDocumentRef(prop.value) : undefined\n  return ref ?? null\n}\n\n/** The `Reusable` embed node referencing the new document (id minted by the action). */\nexport function makeEmbedNode(capability: ReuseCapability, documentId: string): ComponentNode {\n  return {\n    id: 'reuse-embed',\n    componentId: capability.embedComponentId,\n    props: {\n      [capability.relationProp]: {\n        kind: 'static',\n        // EC-589 / EC-586: a reference is a typed envelope from the first write.\n        value: referenceNode({ collection: capability.collectionId, id: documentId }),\n      },\n    },\n  }\n}\n\n// --- The placement preflight (EC-584, closes EC-560) --------------------------------\n\n/**\n * Why a reuse gesture is refused before it does anything: the one core placement\n * judge's verdict, and the label of the FIELD it names when the refusal is at a\n * field's top level (the canvas field, or the reusable collection's content field).\n */\nexport interface ReuseRefusal {\n  verdict: PlacementVerdict\n  fieldLabel: string\n}\n\n/**\n * EC-584 / EC-560 — \"Make reusable\" preflight, run BEFORE any side effect (the\n * reusable document is created — and maybe published — before the canvas swaps the\n * block for the embed). Two placements, both judged by the one core judge the\n * builder reducer enforces:\n *\n * 1. the EMBED lands where the promoted block was (the canvas field's `allow` at the\n *    root, or the slot's `allow` when the block sits in a slot);\n * 2. the promoted BLOCK lands at the top level of the reusable collection's content\n *    field (that field's effective vocabulary, `fieldAllowList`).\n *\n * `null` when both are admitted. The reducer still enforces (1) on its own.\n */\nexport function promoteRefusal(args: {\n  root: ComponentNode\n  nodeId: string\n  node: ComponentNode\n  capability: ReuseCapability\n  collection: CollectionDef\n  placement: PlacementScope\n  canvasFieldLabel: string\n}): ReuseRefusal | null {\n  const { root, nodeId, node, capability, collection, placement, canvasFieldLabel } = args\n  const embed = replacePlacementRefusal(root, nodeId, [makeEmbedNode(capability, 'preflight')], placement)\n  if (embed) return { verdict: embed, fieldLabel: canvasFieldLabel }\n  const contentField = collection.fields.find((field) => field.name === capability.contentField)\n  const contentAllow = contentField ? fieldAllowList(contentField) : undefined\n  if (contentField && contentAllow) {\n    const into = valuePlacementRefusal([node], { components: placement.components, fieldAllow: contentAllow })\n    if (into) return { verdict: into, fieldLabel: fieldLabel(contentField) }\n  }\n  return null\n}\n\n/**\n * EC-584 / EC-560 — \"Detach to local copy\" preflight: the reusable's content blocks\n * land where the embed was. Refusing the WHOLE gesture when one inlined block is\n * outside the vocabulary keeps the reference in place (EC-560's frame: refuse\n * visibly, dispatch nothing) — the editor sees why and decides.\n */\nexport function detachRefusal(args: {\n  root: ComponentNode\n  nodeId: string\n  blocks: readonly ComponentNode[]\n  placement: PlacementScope\n  canvasFieldLabel: string\n}): ReuseRefusal | null {\n  const verdict = replacePlacementRefusal(args.root, args.nodeId, args.blocks, args.placement)\n  return verdict ? { verdict, fieldLabel: args.canvasFieldLabel } : null\n}\n\n/** The effects \"Make reusable\" performs — injected, so the order and the refusal are testable. */\nexport interface PromoteEffects {\n  newDocumentId(): string\n  insertDocument(doc: CmsDocument): void\n  replaceInCanvas(nodeId: string, embed: ComponentNode): void\n  /** Publish the new reusable; resolves `true` only when the document IS published afterwards. */\n  publish(ref: DocumentRef): Promise<boolean>\n  refused(refusal: ReuseRefusal): void\n  madeDraft(name: string): void\n  madePublished(name: string): void\n  publishFailed(name: string): void\n}\n\n/**\n * Run \"Make reusable\" (EC-282) — the preflight first (EC-584: a refusal creates,\n * publishes and replaces NOTHING), then ONE insert-if-absent create of the reusable\n * document (EC-595 A2), the in-place swap for the embed, and the chosen publish,\n * whose success notice is shown only when the document is actually published.\n */\nexport async function runPromote(args: {\n  root: ComponentNode\n  nodeId: string\n  node: ComponentNode\n  name: string\n  publish: boolean\n  capability: ReuseCapability\n  collection: CollectionDef\n  existing: readonly { values?: Record<string, unknown> }[]\n  locales: LocaleConfig\n  placement: PlacementScope\n  canvasFieldLabel: string\n  effects: PromoteEffects\n}): Promise<'refused' | 'draft' | 'published' | 'publish-failed'> {\n  const { root, nodeId, node, name, capability, collection, placement, canvasFieldLabel, effects } = args\n  const refusal = promoteRefusal({ root, nodeId, node, capability, collection, placement, canvasFieldLabel })\n  if (refusal) {\n    effects.refused(refusal)\n    return 'refused'\n  }\n  const ref = { collection: capability.collectionId, id: effects.newDocumentId() }\n  const content = buildReusableValues(collection, capability, name, node, args.existing, args.locales)\n  effects.insertDocument({ ...ref, ...content })\n  effects.replaceInCanvas(nodeId, makeEmbedNode(capability, ref.id))\n  if (!args.publish) {\n    effects.madeDraft(name)\n    return 'draft'\n  }\n  const published = await effects.publish(ref).catch(() => false)\n  if (published) {\n    effects.madePublished(name)\n    return 'published'\n  }\n  effects.publishFailed(name)\n  return 'publish-failed'\n}\n"]}
+{"version":3,"file":"reuse.js","sourceRoot":"","sources":["../../../src/components/builder/reuse.ts"],"names":[],"mappings":"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","sourcesContent":["import { manifestPropFields } from '@elytracms/core/component-registry'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport {\n  documentKey,\n  fieldAllowList,\n  itemLimit,\n  readDocumentRef,\n  referenceNode,\n  seedDefaults,\n  titleFieldOf,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef, LocaleConfig } from '@elytracms/core/cms-core'\nimport {\n  editBlockRoots,\n  isStaticProp,\n  replacePlacementRefusal,\n  staticProp,\n  valuePlacementRefusal,\n} from '@elytracms/core/project-graph'\nimport type { ComponentNode, PlacementScope, PlacementVerdict } from '@elytracms/core/project-graph'\nimport type { CustomizationIssue, CustomizationMessageRef } from '@elytracms/core/studio-core'\nimport type { DeleteCreatedOutcome } from '../../lib/operations/cms-persistence'\nimport type { CanvasHistoryEffect } from './builder-store'\nimport { slugify } from '../../lib/utils'\nimport { fieldLabel } from '../cms/cms-labels'\n\n/**\n * The reuse capability (EC-282): the engine-generic description of how a project\n * models reusable elements. **AD-a (EC-467): reusable elements are SINGULAR per\n * project** — exactly one embed component and exactly one reusable collection.\n * Multiple reuse collections are deliberately not supported, which is why this is\n * one value and never a list.\n *\n * **EC-728 (owner ruling 2026-10-31, \"Declare, never infer\"): the capability exists\n * only when the project DECLARES its embed** — `defineStudio({ reuse: { component } })`\n * ({@link StudioReuseConfig}). The engine never guesses one from a component's shape.\n * The shape test it used to run (no slots, exactly one cardinality-one `relation`\n * prop whose target collection holds a `blocks` field) cannot tell an embed from an\n * ordinary card that links to a page with a canvas: EC-462 refused the guess when two\n * components matched, and EC-728 measured the one-candidate guess crowning a \"read\n * next\" link card — *Make reusable* then moved a block's content into a new document\n * and left a link card in its place. A guess with a destructive gesture attached is\n * the bug, so there is no guess.\n *\n * What the capability drives (and therefore what an undeclared project does not get):\n * the in-canvas gestures (*Make reusable* / *Detach to local copy*), the canvas\n * placeholder for an embed whose target is a draft or missing (EC-300), and the reuse\n * config issues. Transclusion itself does not depend on it — the runtime renderer\n * injects `renderBlocks` for every manifest that consumes relations.\n */\nexport interface ReuseCapability {\n  /** The embed component, e.g. `project.Reusable`. */\n  embedComponentId: string\n  /** The embed's relation prop that points at the reusable document, e.g. `element`. */\n  relationProp: string\n  /** The collection reusable documents live in, e.g. `reusable`. */\n  collectionId: string\n  /** The collection's composition field the embed transcludes, e.g. `content`. */\n  contentField: string\n  /** Whether that field holds a single block or a list. */\n  contentCardinality: 'one' | 'many'\n}\n\n/**\n * EC-467 (AD-b) → EC-728 — THE declaration of the reuse embed (absent: the project has\n * no reusable elements): `defineStudio({ reuse: { component: 'project.Reusable' } })`. See\n * {@link import('../app-views/studio-config').StudioConfig.reuse} for the\n * consumer-facing contract; this is the shape {@link resolveReuse} consumes.\n *\n * One identifier is enough because the rest DERIVES from it (its single-document\n * relation prop → that prop's target collection → that collection's `blocks`\n * field), and because reusable elements are singular per project (AD-a).\n */\nexport interface StudioReuseConfig {\n  /** The embed component's registry id, e.g. `'project.Reusable'`. */\n  component: string\n  /**\n   * Which relation prop points at the reusable document. Needed ONLY when the\n   * declared component legitimately has more than one single-document relation\n   * prop — otherwise the sole one is derived.\n   */\n  relationProp?: string\n}\n\n/**\n * EC-467 — the resolution of the project's reuse capability: the capability (or\n * `null`), plus the config issues a developer must SEE (a declaration that cannot\n * resolve).\n *\n * The issues ride the EC-236 {@link CustomizationIssue} surface (`point: 'reuse'`),\n * exactly like the sidebar's and the field renderers' — so they render in the header\n * Issues popover on every surface (EC-690's one issues tray), the studio's home for\n * project-CONFIGURATION problems (the document-scoped Issues pane is the wrong\n * home: this is not a content problem in one document).\n *\n * EC-478: each issue carries a `messageRef` (catalog key + identifier values)\n * alongside its prebuilt English, so the tray renders it in the active UI\n * locale. This module stays pure — it names a key, it never calls `translate`;\n * `lib/persona/labels.ts` resolves it at the render site. That is what makes the\n * whole list localize together, which is the mixed-language outcome EC-467\n * declined to create by localizing only its own half.\n */\nexport interface ReuseResolution {\n  capability: ReuseCapability | null\n  /** Empty whenever the declaration resolves — and when there is none (\"this project has none\"). */\n  issues: CustomizationIssue[]\n}\n\n/** The customization point name stamped onto every reuse issue (EC-236 locator). */\nconst REUSE_POINT = 'reuse'\n\n/** A `relation` prop of a manifest. */\ninterface RelationProp {\n  name: string\n  /** The target collection id; `undefined` when the manifest declares none. */\n  target: string | undefined\n  multiple: boolean\n}\n\n/** Every `relation` prop of a manifest, in declaration order. */\nfunction relationPropsOf(manifest: ComponentManifest): RelationProp[] {\n  const props: RelationProp[] = []\n  for (const field of manifestPropFields(manifest)) {\n    if (field.type !== 'relation') continue\n    props.push({ name: field.name, target: field.target, multiple: field.multiple === true })\n  }\n  return props\n}\n\n/**\n * The relation props a DECLARED embed could plausibly transclude through: targeted\n * and cardinality-one. A cardinality-`many` (or targetless) relation is excluded\n * structurally, not heuristically — an embed transcludes exactly one document and\n * {@link makeEmbedNode} writes exactly one `{collection,id}`, which a list-valued\n * or target-less prop cannot hold.\n */\nfunction embeddableRelationProps(manifest: ComponentManifest): TargetedRelationProp[] {\n  return relationPropsOf(manifest).filter(\n    (r): r is TargetedRelationProp => r.target !== undefined && !r.multiple,\n  )\n}\ntype TargetedRelationProp = RelationProp & { target: string }\n\n/** The collection's first composition field — what an embed of it transcludes. */\nfunction blocksFieldOf(collection: CollectionDef) {\n  const field = collection.fields.find((f) => f.type === 'blocks')\n  return field?.type === 'blocks' ? field : undefined\n}\n\n/**\n * The catalog keys for the reuse config issues (EC-478), in the `builder.reuse.config.*`\n * namespace. Named here so the producer and the catalog-parity test agree on one list.\n */\nconst REUSE_KEYS = {\n  unknownComponent: 'builder.reuse.config.unknownComponent',\n  noRelationProp: 'builder.reuse.config.noRelationProp',\n  unknownRelationProp: 'builder.reuse.config.unknownRelationProp',\n  ambiguousRelationProp: 'builder.reuse.config.ambiguousRelationProp',\n  unknownCollection: 'builder.reuse.config.unknownCollection',\n  noBlocksField: 'builder.reuse.config.noBlocksField',\n} as const\n\nfunction reuseIssue(\n  code: CustomizationIssue['code'],\n  severity: CustomizationIssue['severity'],\n  message: string,\n  messageRef: CustomizationMessageRef,\n  id?: string,\n): CustomizationIssue {\n  return {\n    code,\n    severity,\n    message,\n    messageRef,\n    point: REUSE_POINT,\n    ...(id === undefined ? {} : { id }),\n  }\n}\n\n/** `\"a\", \"b\"` — a readable list of prop/component ids for an issue message. */\nfunction quotedList(names: readonly string[]): string {\n  return names.map((name) => `\"${name}\"`).join(', ')\n}\n\n/**\n * Resolve the DECLARED embed (EC-467, AD-b). The declaration is the developer's\n * authority: a declared component may have slots, may declare `listing`, and its\n * relation prop may be `form.hidden` — the engine does not second-guess a stated\n * intent. Only structural impossibilities are issues (see AD-c row 2): an unknown\n * component id, no usable relation prop (or an ambiguous set with no\n * `relationProp`), an undefined target collection, or a target with no `blocks`\n * field — each of which would leave nothing coherent to transclude.\n */\nfunction resolveDeclaredReuse(\n  declaration: StudioReuseConfig,\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n): ReuseResolution {\n  const { component, relationProp } = declaration\n  const fail = (message: string, messageRef: CustomizationMessageRef): ReuseResolution => ({\n    capability: null,\n    issues: [reuseIssue('invalid-override', 'error', message, messageRef, component)],\n  })\n\n  const manifest = manifests.find((m) => m.id === component)\n  if (!manifest) {\n    return {\n      capability: null,\n      issues: [\n        reuseIssue(\n          'unknown-override-target',\n          'error',\n          `Reusable elements: studio config declares reuse.component \"${component}\", which is not a registered component. Fix the id to name your embed component — until then the reuse gestures are off.`,\n          { key: REUSE_KEYS.unknownComponent, vars: { component } },\n          component,\n        ),\n      ],\n    }\n  }\n\n  const relations = embeddableRelationProps(manifest)\n  if (relations.length === 0) {\n    return fail(\n      `Reusable elements: the declared embed \"${component}\" has no single-document relation prop, so it cannot point at a reusable document. An embed needs one relation prop with cardinality one.`,\n      { key: REUSE_KEYS.noRelationProp, vars: { component } },\n    )\n  }\n  const names = relations.map((r) => r.name)\n  let relation: TargetedRelationProp\n  if (relationProp !== undefined) {\n    const named = relations.find((r) => r.name === relationProp)\n    if (!named) {\n      return fail(\n        `Reusable elements: the declared embed \"${component}\" has no single-document relation prop named \"${relationProp}\". Its relation props are: ${quotedList(names)}.`,\n        {\n          key: REUSE_KEYS.unknownRelationProp,\n          vars: { component, relationProp, props: quotedList(names) },\n        },\n      )\n    }\n    relation = named\n  } else if (relations.length === 1) {\n    relation = relations[0]!\n  } else {\n    return fail(\n      `Reusable elements: the declared embed \"${component}\" has ${relations.length} single-document relation props (${quotedList(names)}) — add reuse.relationProp to say which one points at the reusable document.`,\n      {\n        key: REUSE_KEYS.ambiguousRelationProp,\n        vars: { component, count: relations.length, props: quotedList(names) },\n      },\n    )\n  }\n\n  const collection = collections.find((c) => c.id === relation.target)\n  if (!collection) {\n    return fail(\n      `Reusable elements: \"${component}.${relation.name}\" targets the collection \"${relation.target}\", which this project does not define.`,\n      {\n        key: REUSE_KEYS.unknownCollection,\n        vars: { component, relationProp: relation.name, collection: relation.target },\n      },\n    )\n  }\n  const blocksField = blocksFieldOf(collection)\n  if (!blocksField) {\n    return fail(\n      `Reusable elements: the collection \"${collection.id}\" behind \"${component}.${relation.name}\" has no blocks (composition) field, so there is nothing for the embed to transclude.`,\n      {\n        key: REUSE_KEYS.noBlocksField,\n        vars: { component, relationProp: relation.name, collection: collection.id },\n      },\n    )\n  }\n\n  return {\n    capability: {\n      embedComponentId: manifest.id,\n      relationProp: relation.name,\n      collectionId: collection.id,\n      contentField: blocksField.name,\n      contentCardinality: itemLimit(blocksField) === 1 ? 'one' : 'many',\n    },\n    issues: [],\n  }\n}\n\n/**\n * Resolve the project's ONE reuse capability (AD-a) plus any config issues — EC-728's\n * matrix (declare, never infer):\n *\n * | Declaration | Result |\n * | --- | --- |\n * | present, resolves | the declared capability, no issue |\n * | present, does not resolve | `null` + an ERROR issue (misconfiguration) |\n * | absent | `null`, **no issue** — the project has no reusable elements |\n *\n * The absent row is deliberately silent: a project need not use reusable elements,\n * and naming a component that \"looks like an embed\" would be the guess again, as\n * advice (EC-728). An unresolvable declaration disables the gestures and is reported\n * once, in the header Issues popover.\n */\nexport function resolveReuse(\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n  declaration?: StudioReuseConfig,\n): ReuseResolution {\n  if (!declaration) return { capability: null, issues: [] }\n  return resolveDeclaredReuse(declaration, manifests, collections)\n}\n\n/**\n * The project's reuse capability alone, or `null` when it is undeclared or\n * misdeclared — for callers that act on the capability and do not surface config\n * issues themselves (the gestures, the canvas placeholder). The issues are surfaced\n * ONCE, by the shell; see {@link resolveReuse}.\n */\nexport function resolveReuseCapability(\n  manifests: readonly ComponentManifest[],\n  collections: readonly CollectionDef[],\n  declaration?: StudioReuseConfig,\n): ReuseCapability | null {\n  return resolveReuse(manifests, collections, declaration).capability\n}\n\n/** A slug for `name`, suffixed `-2`/`-3`/… until it is free among `taken`. */\nexport function uniqueSlug(name: string, taken: ReadonlySet<string>): string {\n  const base = slugify(name) || 'element'\n  let id = base\n  for (let n = 2; taken.has(id); n += 1) id = `${base}-${n}`\n  return id\n}\n\n/**\n * The values for a new reusable document promoted from `node` (EC-282): seeded\n * defaults, the given `name` on the title field, the node on the content field,\n * and a collision-safe slug on any UNIQUE text field (e.g. a production site's\n * `internalId`) so the created document is publish-valid without hardcoding that\n * field's name. Other required fields, if any, are completed by the editor when\n * they open the new reusable.\n *\n * EC-580: every write goes through core's `writeField` in the project's DEFAULT\n * locale — the new document is created in its default bucket, so a localized title\n * or content field lands under `localized[default]`, never on the shared bag.\n */\nexport function buildReusableValues(\n  collection: CollectionDef,\n  capability: ReuseCapability,\n  name: string,\n  node: ComponentNode,\n  existing: readonly { values?: Record<string, unknown> }[],\n  locales: LocaleConfig,\n): Pick<CmsDocument, 'values' | 'localized'> {\n  const at = locales.default\n  let doc: CmsDocument = { collection: collection.id, id: '', ...seedDefaults(collection, locales) }\n  const titleField = titleFieldOf(collection)?.name\n  if (titleField) doc = writeField(collection, doc, titleField, at, name)\n  for (const field of collection.fields) {\n    if (\n      field.type === 'text' &&\n      field.validation?.unique === true &&\n      field.name !== titleField &&\n      field.name !== capability.contentField\n    ) {\n      const taken = new Set(\n        existing\n          .map((d) => d.values?.[field.name])\n          .filter((v): v is string => typeof v === 'string'),\n      )\n      doc = writeField(collection, doc, field.name, at, uniqueSlug(name, taken))\n    }\n  }\n  // EC-576: the converged v2 sequence holding the tagged node, through the core\n  // write path — never the pre-0.0.84 bare node/array. Cardinality is a\n  // constraint over that one shape, not a second shape (EC-500 D2).\n  doc = writeField(collection, doc, capability.contentField, at, editBlockRoots(undefined, () => [node]))\n  return { values: doc.values, ...(doc.localized !== undefined ? { localized: doc.localized } : {}) }\n}\n\n/**\n * The document a reuse-embed `node` targets (EC-300), or null when `node` is not the\n * embed component or has no static pick yet. Lets the canvas detect a HARD reference\n * whose target doesn't resolve (→ placeholder) without reaching into prop internals.\n */\nexport function reuseEmbedRef(node: ComponentNode, capability: ReuseCapability): DocumentRef | null {\n  if (node.componentId !== capability.embedComponentId) return null\n  const prop = node.props?.[capability.relationProp]\n  const ref = isStaticProp(prop) ? readDocumentRef(prop.value) : undefined\n  return ref ?? null\n}\n\n/**\n * The `Reusable` embed node referencing the new document (id minted by the action).\n *\n * EC-728 — CANONICAL from the first write: the prop is core's `staticProp` (bare `{ value }`,\n * EC-312), never `{ kind: 'static', value }`. The canvas commits its node patches raw, while\n * the draft takes the same write through the self-typing lens, which strips a redundant\n * `kind`; a non-canonical node therefore made the two views of the canvas field disagree, the\n * draft reported the disagreement as a change made underneath the canvas, and the rebase\n * dropped *Make reusable*'s own undo step (`reuse-undo.test.ts`).\n */\nexport function makeEmbedNode(capability: ReuseCapability, documentId: string): ComponentNode {\n  return {\n    id: 'reuse-embed',\n    componentId: capability.embedComponentId,\n    props: {\n      // EC-589 / EC-586: a reference is a typed envelope from the first write.\n      [capability.relationProp]: staticProp(referenceNode({ collection: capability.collectionId, id: documentId })),\n    },\n  }\n}\n\n// --- The placement preflight (EC-584, closes EC-560) --------------------------------\n\n/**\n * Why a reuse gesture is refused before it does anything: the one core placement\n * judge's verdict, and the label of the FIELD it names when the refusal is at a\n * field's top level (the canvas field, or the reusable collection's content field).\n */\nexport interface ReuseRefusal {\n  verdict: PlacementVerdict\n  fieldLabel: string\n}\n\n/**\n * EC-584 / EC-560 — \"Make reusable\" preflight, run BEFORE any side effect (the\n * reusable document is created — and maybe published — before the canvas swaps the\n * block for the embed). Two placements, both judged by the one core judge the\n * builder reducer enforces:\n *\n * 1. the EMBED lands where the promoted block was (the canvas field's `allow` at the\n *    root, or the slot's `allow` when the block sits in a slot);\n * 2. the promoted BLOCK lands at the top level of the reusable collection's content\n *    field (that field's effective vocabulary, `fieldAllowList`).\n *\n * `null` when both are admitted. The reducer still enforces (1) on its own.\n */\nexport function promoteRefusal(args: {\n  root: ComponentNode\n  nodeId: string\n  node: ComponentNode\n  capability: ReuseCapability\n  collection: CollectionDef\n  placement: PlacementScope\n  canvasFieldLabel: string\n}): ReuseRefusal | null {\n  const { root, nodeId, node, capability, collection, placement, canvasFieldLabel } = args\n  const embed = replacePlacementRefusal(root, nodeId, [makeEmbedNode(capability, 'preflight')], placement)\n  if (embed) return { verdict: embed, fieldLabel: canvasFieldLabel }\n  const contentField = collection.fields.find((field) => field.name === capability.contentField)\n  const contentAllow = contentField ? fieldAllowList(contentField) : undefined\n  if (contentField && contentAllow) {\n    const into = valuePlacementRefusal([node], { components: placement.components, fieldAllow: contentAllow })\n    if (into) return { verdict: into, fieldLabel: fieldLabel(contentField) }\n  }\n  return null\n}\n\n/**\n * EC-584 / EC-560 — \"Detach to local copy\" preflight: the reusable's content blocks\n * land where the embed was. Refusing the WHOLE gesture when one inlined block is\n * outside the vocabulary keeps the reference in place (EC-560's frame: refuse\n * visibly, dispatch nothing) — the editor sees why and decides.\n */\nexport function detachRefusal(args: {\n  root: ComponentNode\n  nodeId: string\n  blocks: readonly ComponentNode[]\n  placement: PlacementScope\n  canvasFieldLabel: string\n}): ReuseRefusal | null {\n  const verdict = replacePlacementRefusal(args.root, args.nodeId, args.blocks, args.placement)\n  return verdict ? { verdict, fieldLabel: args.canvasFieldLabel } : null\n}\n\n/** The effects \"Make reusable\" performs — injected, so the order and the refusal are testable. */\nexport interface PromoteEffects {\n  newDocumentId(): string\n  insertDocument(doc: CmsDocument): void\n  /**\n   * The in-place swap — ONE history entry carrying `effect` (EC-728: the created document, so\n   * Undo can remove it when that is safe and Redo can re-insert it).\n   */\n  replaceInCanvas(nodeId: string, embed: ComponentNode, effect: CanvasHistoryEffect): void\n  /** Publish the new reusable; resolves `true` only when the document IS published afterwards. */\n  publish(ref: DocumentRef): Promise<boolean>\n  refused(refusal: ReuseRefusal): void\n  madeDraft(name: string): void\n  madePublished(name: string): void\n  publishFailed(name: string): void\n}\n\n/**\n * Run \"Make reusable\" (EC-282) — the preflight first (EC-584: a refusal creates,\n * publishes and replaces NOTHING), then ONE insert-if-absent create of the reusable\n * document (EC-595 A2), the in-place swap for the embed — one canvas history entry that\n * records the created document (EC-728) — and the chosen publish, whose success notice is\n * shown only when the document is actually published.\n */\nexport async function runPromote(args: {\n  root: ComponentNode\n  nodeId: string\n  node: ComponentNode\n  name: string\n  publish: boolean\n  capability: ReuseCapability\n  collection: CollectionDef\n  existing: readonly { values?: Record<string, unknown> }[]\n  locales: LocaleConfig\n  placement: PlacementScope\n  canvasFieldLabel: string\n  effects: PromoteEffects\n}): Promise<'refused' | 'draft' | 'published' | 'publish-failed'> {\n  const { root, nodeId, node, name, capability, collection, placement, canvasFieldLabel, effects } = args\n  const refusal = promoteRefusal({ root, nodeId, node, capability, collection, placement, canvasFieldLabel })\n  if (refusal) {\n    effects.refused(refusal)\n    return 'refused'\n  }\n  const ref = { collection: capability.collectionId, id: effects.newDocumentId() }\n  const content = buildReusableValues(collection, capability, name, node, args.existing, args.locales)\n  const document: CmsDocument = { ...ref, ...content }\n  effects.insertDocument(document)\n  effects.replaceInCanvas(nodeId, makeEmbedNode(capability, ref.id), { kind: 'reusable-created', ref, name, document })\n  if (!args.publish) {\n    effects.madeDraft(name)\n    return 'draft'\n  }\n  const published = await effects.publish(ref).catch(() => false)\n  if (published) {\n    effects.madePublished(name)\n    return 'published'\n  }\n  effects.publishFailed(name)\n  return 'publish-failed'\n}\n\n// --- Undo / Redo of \"Make reusable\" (EC-728) ------------------------------------------\n\n/**\n * What Undo did with the document *Make reusable* created: `deleted`, or already `gone`, or\n * KEPT — because it is `published`, was `edited` since it was made, is `referenced` elsewhere,\n * or the removal `failed`. The block is restored in every case (the canvas entry is a snapshot).\n */\nexport type PromoteUndoOutcome = 'deleted' | 'gone' | 'published' | 'edited' | 'referenced' | 'failed'\n\n/** The authoritative reads and the one write Undo needs — injected, so every branch is testable. */\nexport interface PromoteUndoDeps {\n  /** Await every queued write: the page's restored value lands before anything is judged. */\n  flush(): Promise<void>\n  /** The document's record now (`undefined`: it no longer exists). */\n  read(ref: DocumentRef): Promise<{ published: boolean } | undefined>\n  /** How many reference-index entries (draft or published, any document) point at it now. */\n  referrers(ref: DocumentRef): Promise<number>\n  /** The conditional delete — at the revision this session's create landed at (`CmsPersister.deleteCreated`). */\n  deleteCreated(ref: DocumentRef): Promise<DeleteCreatedOutcome>\n}\n\n/**\n * EC-728 — Undo of *Make reusable*, the document side. The created document is deleted ONLY\n * when every authoritative fact at Undo time says nobody else has it: never published (the\n * record), referenced nowhere — after the page's own restore has landed — (the reference\n * index, both variants), and unchanged since its create (the delete's revision precondition,\n * checked by the store in its own step, which also refuses a strict referrer). Anything else\n * keeps it, with the reason. A read that throws keeps it too: an unproven fact never deletes.\n */\nexport async function undoPromote(effect: CanvasHistoryEffect, deps: PromoteUndoDeps): Promise<PromoteUndoOutcome> {\n  try {\n    await deps.flush()\n    const record = await deps.read(effect.ref)\n    if (!record) return 'gone'\n    if (record.published) return 'published'\n    if ((await deps.referrers(effect.ref)) > 0) return 'referenced'\n    switch (await deps.deleteCreated(effect.ref)) {\n      case 'deleted':\n        return 'deleted'\n      case 'gone':\n        return 'gone'\n      case 'changed':\n        return 'edited'\n      case 'referenced':\n        return 'referenced'\n      default:\n        return 'failed'\n    }\n  } catch {\n    return 'failed'\n  }\n}\n\n/** The catalog keys of the kept-document notices (EN + DE in the studio catalogs). */\nexport type ReuseUndoNoticeKey =\n  | 'builder.reuse.undoKeptPublished'\n  | 'builder.reuse.undoKeptEdited'\n  | 'builder.reuse.undoKeptReferenced'\n  | 'builder.reuse.undoKeptFailed'\n\n/** The notice for a KEPT document (EC-728 — it names the document and why); none when it went. */\nexport function undoPromoteNotice(outcome: PromoteUndoOutcome): ReuseUndoNoticeKey | undefined {\n  switch (outcome) {\n    case 'published':\n      return 'builder.reuse.undoKeptPublished'\n    case 'edited':\n      return 'builder.reuse.undoKeptEdited'\n    case 'referenced':\n      return 'builder.reuse.undoKeptReferenced'\n    case 'failed':\n      return 'builder.reuse.undoKeptFailed'\n    default:\n      return undefined\n  }\n}\n\n/**\n * EC-728 — the document side of every Undo/Redo that crosses a *Make reusable* step, for one\n * canvas. Crossings run strictly in order (a Redo waits for the Undo before it), so a fast\n * Undo → Redo never re-inserts a document whose removal is still in flight. Redo re-inserts\n * (the same id, insert-if-absent) exactly the documents ITS Undo removed or found gone — never\n * one Undo kept (it is still there) — and the canvas entry re-swaps the embed.\n */\nexport function createPromoteHistory(\n  deps: PromoteUndoDeps & {\n    insert(document: CmsDocument): void\n    notify(key: ReuseUndoNoticeKey, name: string): void\n  },\n): { crossed(step: { direction: 'undo' | 'redo'; effect: CanvasHistoryEffect }): Promise<void> } {\n  const removed = new Set<string>()\n  let chain: Promise<void> = Promise.resolve()\n  return {\n    crossed(step) {\n      chain = chain.then(async () => {\n        const key = documentKey(step.effect.ref)\n        if (step.direction === 'redo') {\n          if (removed.delete(key)) deps.insert(step.effect.document)\n          return\n        }\n        const outcome = await undoPromote(step.effect, deps)\n        if (outcome === 'deleted' || outcome === 'gone') removed.add(key)\n        const notice = undoPromoteNotice(outcome)\n        if (notice) deps.notify(notice, step.effect.name)\n      })\n      return chain\n    },\n  }\n}\n"]}

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

@@ -2,7 +2,7 @@ import type { ReactNode } from 'react';
 import type { CmsDocument, CmsValidationIssue, CollectionDef, CollectionRegistry, DocumentPatch, DocumentRef, FieldDef, ValuePath, Locale, LocaleConfig, LocalizedString, RestoreScope, ValidateDocumentOptions } from '@elytracms/core/cms-core';
 import type { CmsDocumentRecord, DocumentVersionRecord, IdFactory, PresenceEntry } from '@elytracms/core/persistence';
 import type { ImportRejection } from './import-batch.js';
-import type { CommitOutcome, DocumentConflict, OperationError, OperationsClient } from '../../lib/operations/index.js';
+import type { CommitOutcome, DeleteCreatedOutcome, DocumentConflict, OperationError, OperationsClient } from '../../lib/operations/index.js';
 import type { TableViewState } from '../../lib/cms-views/index.js';
 import type { CellCommitInput, CellCommitOutcome } from './cell-edit.js';
 import type { BulkAction, BulkReport, BulkSetField } from './bulk-actions.js';
@@ -123,6 +123,14 @@ export interface CmsStore {
      */
     replaceDocument(doc: CmsDocument, revision: number | undefined, authoredOn?: CmsDocument): void;
     deleteDocument(ref: DocumentRef): void;
+    /**
+     * EC-728 — delete a document this session created, only while it is exactly as created
+     * (the persister's `deleteCreated`: conditioned on its create receipt, refused by the
+     * store on any write since or a strict referrer). The session drops it only once deleted;
+     * a refusal is returned, never reported. A fixture session (no persister) answers
+     * `not-created` — nothing is judged there, so nothing is deleted.
+     */
+    deleteCreatedDocument(ref: DocumentRef): Promise<DeleteCreatedOutcome>;
     /**
      * Is this document currently published? Sourced from the version POINTER
      * (EC-224), not the flat `state` enum — seeded from hydration and updated by

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

@@ -1053,6 +1053,7 @@ function CmsSession({ children, projectId, initialCollections, initialDocuments,
         persistError,
         clearPersistError: () => setPersistError(null),
         flushPersistence: (ref) => persisterRef.current?.flush(ref) ?? Promise.resolve(),
+        deleteCreatedDocument: (ref) => persisterRef.current?.deleteCreated(ref) ?? Promise.resolve('not-created'),
     }), [
         projectId,
         collections,