@elytracms/studio 0.0.91 → 0.0.93

package/dist/components/cms/bulk-actions.d.ts

@@ -6,7 +6,7 @@ import type { OperationError, OperationResult } from '@elytracms/studio/lib/oper
  *
  * Each selected document gets its OWN operations command
  * (`documents.publish` / `documents.unpublish` / `documents.delete`, EC-224;
- * `documents.upsert` for a set-field, EC-247), awaited in selection order, and
+ * one field patch for a set-field, EC-247 → EC-595 A2), awaited in selection order, and
  * its own per-item outcome. The report enumerates every failure with its
  * reason (validation gate, authorization denial, not-found, …) — a partial
  * failure is never silent and never collapsed into one toast. Session state is
@@ -61,22 +61,6 @@ export interface BulkContext {
      * when the action is `set-field`; unused otherwise.
      */
     applySetField?(ref: DocumentRef, set: BulkSetField): void;
-    /**
-     * EC-425: the publish-time hidden-strip (EC-273 clearHiddenValues + EC-394
-     * clearHiddenProps, the SAME shared clean step the single-document `doPublish`
-     * runs) — returns the document a publish should snapshot. Identity-preserving:
-     * returns the input when nothing clears. Absent ⇒ publish the draft as stored
-     * (fixture harnesses without a clean point).
-     */
-    cleanForPublish?(doc: CmsDocument): CmsDocument;
-    /**
-     * EC-425: land a cleaned draft (session + persistence) BEFORE its publish
-     * command dispatches, so the snapshot the publish pins — and the reference
-     * index derived from the stored draft (EC-286) — are clean. Awaited; only
-     * called when {@link cleanForPublish} actually changed the document
-     * (save-if-changed, mirroring `doPublish`).
-     */
-    applyCleaned?(ref: DocumentRef, doc: CmsDocument): Promise<void> | void;
     /**
      * Dispatch the ONE operations command for an item. Absent in fixture-only
      * sessions (no project scope) — items then mutate the session directly.
@@ -87,9 +71,9 @@ export interface BulkContext {
  * Run one bulk action over a selection, item by item:
  * 1. publish gates on validation — an invalid document fails with its issues
  *    and dispatches NOTHING (a set-field is a draft edit, EC-225 — never gated),
- * 2. publish joins the single-document clean point (EC-425): the hidden-strip
- *    runs per item and a changed draft is saved (awaited) BEFORE the publish
- *    command, so bulk-published snapshots go out as clean as editor publishes,
+ * 2. the hidden-strip is NOT a step here (EC-585): it runs inside the one publish
+ *    operation the dispatch calls, so a bulk-published snapshot is exactly as clean
+ *    as an editor publish by construction (EC-425 used to run a clean step per item),
  * 3. each remaining item dispatches exactly one operations command, awaited,
  * 4. only succeeded items mutate the session,
  * 5. the report carries one honest outcome per item, in selection order.

package/dist/components/cms/bulk-actions.js

@@ -25,9 +25,9 @@ const ACTION_STATE = {
  * Run one bulk action over a selection, item by item:
  * 1. publish gates on validation — an invalid document fails with its issues
  *    and dispatches NOTHING (a set-field is a draft edit, EC-225 — never gated),
- * 2. publish joins the single-document clean point (EC-425): the hidden-strip
- *    runs per item and a changed draft is saved (awaited) BEFORE the publish
- *    command, so bulk-published snapshots go out as clean as editor publishes,
+ * 2. the hidden-strip is NOT a step here (EC-585): it runs inside the one publish
+ *    operation the dispatch calls, so a bulk-published snapshot is exactly as clean
+ *    as an editor publish by construction (EC-425 used to run a clean step per item),
  * 3. each remaining item dispatches exactly one operations command, awaited,
  * 4. only succeeded items mutate the session,
  * 5. the report carries one honest outcome per item, in selection order.
@@ -64,27 +64,6 @@ export async function runBulkAction(context, collectionId, ids, action, setField
                 });
                 continue;
             }
-            // EC-425: the SAME clean-then-save sequence the single-document `doPublish`
-            // runs, per item — validation gated on the live draft above (matching the
-            // editor's pre-strip gate), then the hidden-strip; a changed draft lands
-            // (awaited) before the publish command so the pinned snapshot and the
-            // EC-286-derived reference index are clean. A failing save is an honest
-            // per-item failure and the publish never dispatches on the dirty draft.
-            if (context.cleanForPublish) {
-                const cleaned = context.cleanForPublish(doc);
-                if (cleaned !== doc) {
-                    try {
-                        await context.applyCleaned?.(ref, cleaned);
-                    }
-                    catch (cause) {
-                        fail({
-                            code: 'unknown',
-                            message: cause instanceof Error ? cause.message : String(cause),
-                        });
-                        continue;
-                    }
-                }
-            }
         }
         if (context.dispatch) {
             let result;

package/dist/components/cms/bulk-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-actions.js","sourceRoot":"","sources":["../../../src/components/cms/bulk-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CmsDocument,\n  CmsValidationIssue,\n  DocumentRef,\n  PublicationState,\n} from '@elytracms/core/cms-core'\nimport type { FilterScalar } from '@elytracms/core/content'\nimport type { OperationError, OperationResult } from '@elytracms/studio/lib/operations'\nimport { matchesRef } from './document-ref-utils'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport {\n  cmsValidationIssueMessage,\n  operationErrorMessage,\n  operationIssueMessage,\n} from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Bulk actions over a table selection (EC-169) — the pure half.\n *\n * Each selected document gets its OWN operations command\n * (`documents.publish` / `documents.unpublish` / `documents.delete`, EC-224;\n * `documents.upsert` for a set-field, EC-247), awaited in selection order, and\n * its own per-item outcome. The report enumerates every failure with its\n * reason (validation gate, authorization denial, not-found, …) — a partial\n * failure is never silent and never collapsed into one toast. Session state is\n * only updated for items whose command succeeded.\n */\n\nexport type BulkAction = 'publish' | 'unpublish' | 'delete' | 'set-field'\n\n/**\n * The payload of a `set-field` bulk action (EC-247): assign one filterable\n * scalar field the same value across every selected document. The value is\n * folded into each document the locale-aware way (`applyCellValue`) by the\n * caller's `applySetField`/`dispatch`; this module only carries it.\n */\nexport interface BulkSetField {\n  field: string\n  value: FilterScalar\n}\n\n/** The outcome of one document's command within a bulk run. */\nexport interface BulkItemOutcome {\n  ref: DocumentRef\n  /** Display title at dispatch time (deleted docs still get named in the report). */\n  title: string\n  ok: boolean\n  /** Human-readable failure reason — present exactly when `ok` is false. */\n  reason?: string\n  /** The structured error behind the reason (operation result / validation gate). */\n  error?: OperationError\n}\n\nexport interface BulkReport {\n  action: BulkAction\n  /** Present for `set-field`: the field + value that was applied (report label). */\n  setField?: BulkSetField\n  results: BulkItemOutcome[]\n}\n\nexport function bulkSummary(report: BulkReport): { succeeded: number; failed: number } {\n  let succeeded = 0\n  for (const result of report.results) if (result.ok) succeeded += 1\n  return { succeeded, failed: report.results.length - succeeded }\n}\n\n/** The failure reason a report row shows: validation issues beat the envelope. */\nexport function bulkErrorReason(error: OperationError): string {\n  // EC-494: resolve the carried catalog refs — a bulk publish rejected by the\n  // SERVER-side field-rule gate reports in the editor's language, not English.\n  if (error.code === 'validation' && error.issues.length > 0) {\n    return error.issues.map((issue) => operationIssueMessage(issue)).join(' · ')\n  }\n  return operationErrorMessage(error)\n}\n\nexport interface BulkContext {\n  /** Current session documents (lookup + validation input). */\n  documents: readonly CmsDocument[]\n  titleOf(ref: DocumentRef): string\n  /** Full document validation — gates publish: invalid documents never dispatch. */\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  /** Apply one succeeded state transition to the session. */\n  applyState(ref: DocumentRef, state: PublicationState): void\n  /** Apply one succeeded delete to the session. */\n  applyDelete(ref: DocumentRef): void\n  /**\n   * Apply one succeeded set-field to the session (locale-aware fold). Required\n   * when the action is `set-field`; unused otherwise.\n   */\n  applySetField?(ref: DocumentRef, set: BulkSetField): void\n  /**\n   * EC-425: the publish-time hidden-strip (EC-273 clearHiddenValues + EC-394\n   * clearHiddenProps, the SAME shared clean step the single-document `doPublish`\n   * runs) — returns the document a publish should snapshot. Identity-preserving:\n   * returns the input when nothing clears. Absent ⇒ publish the draft as stored\n   * (fixture harnesses without a clean point).\n   */\n  cleanForPublish?(doc: CmsDocument): CmsDocument\n  /**\n   * EC-425: land a cleaned draft (session + persistence) BEFORE its publish\n   * command dispatches, so the snapshot the publish pins — and the reference\n   * index derived from the stored draft (EC-286) — are clean. Awaited; only\n   * called when {@link cleanForPublish} actually changed the document\n   * (save-if-changed, mirroring `doPublish`).\n   */\n  applyCleaned?(ref: DocumentRef, doc: CmsDocument): Promise<void> | void\n  /**\n   * Dispatch the ONE operations command for an item. Absent in fixture-only\n   * sessions (no project scope) — items then mutate the session directly.\n   */\n  dispatch?: (action: BulkAction, ref: DocumentRef) => Promise<OperationResult<unknown>>\n}\n\nconst ACTION_STATE: Record<'publish' | 'unpublish', PublicationState> = {\n  publish: 'published',\n  unpublish: 'draft',\n}\n\n/**\n * Run one bulk action over a selection, item by item:\n * 1. publish gates on validation — an invalid document fails with its issues\n *    and dispatches NOTHING (a set-field is a draft edit, EC-225 — never gated),\n * 2. publish joins the single-document clean point (EC-425): the hidden-strip\n *    runs per item and a changed draft is saved (awaited) BEFORE the publish\n *    command, so bulk-published snapshots go out as clean as editor publishes,\n * 3. each remaining item dispatches exactly one operations command, awaited,\n * 4. only succeeded items mutate the session,\n * 5. the report carries one honest outcome per item, in selection order.\n */\nexport async function runBulkAction(\n  context: BulkContext,\n  collectionId: string,\n  ids: readonly string[],\n  action: BulkAction,\n  setField?: BulkSetField,\n): Promise<BulkReport> {\n  const results: BulkItemOutcome[] = []\n\n  for (const id of ids) {\n    const ref: DocumentRef = { collection: collectionId, id }\n    const title = context.titleOf(ref)\n    const fail = (error: OperationError) =>\n      results.push({ ref, title, ok: false, reason: bulkErrorReason(error), error })\n\n    const doc = context.documents.find((d) => matchesRef(d, ref))\n    if (!doc) {\n      fail({\n        code: 'not-found',\n        message: translate('cms.list.bulk.error.notInSession'),\n        entity: 'cms-document',\n        key: `${collectionId}:${id}`,\n      })\n      continue\n    }\n\n    if (action === 'publish') {\n      const errors = context.validate(doc).filter((issue) => issue.severity === 'error')\n      if (errors.length > 0) {\n        fail({\n          code: 'validation',\n          message: translate('cms.list.bulk.error.notValidToPublish'),\n          issues: errors.map((issue) => ({\n            code: issue.code,\n            // EC-487 — resolved here, the last point that still has the structured issue.\n            message: cmsValidationIssueMessage(issue),\n            path: [...issue.path],\n            domain: 'cms',\n          })),\n        })\n        continue\n      }\n      // EC-425: the SAME clean-then-save sequence the single-document `doPublish`\n      // runs, per item — validation gated on the live draft above (matching the\n      // editor's pre-strip gate), then the hidden-strip; a changed draft lands\n      // (awaited) before the publish command so the pinned snapshot and the\n      // EC-286-derived reference index are clean. A failing save is an honest\n      // per-item failure and the publish never dispatches on the dirty draft.\n      if (context.cleanForPublish) {\n        const cleaned = context.cleanForPublish(doc)\n        if (cleaned !== doc) {\n          try {\n            await context.applyCleaned?.(ref, cleaned)\n          } catch (cause) {\n            fail({\n              code: 'unknown',\n              message: cause instanceof Error ? cause.message : String(cause),\n            })\n            continue\n          }\n        }\n      }\n    }\n\n    if (context.dispatch) {\n      let result: OperationResult<unknown>\n      try {\n        result = await context.dispatch(action, ref)\n      } catch (cause) {\n        // Operations never throw by contract; a broken transport still becomes\n        // a visible per-item failure instead of an aborted bulk run.\n        result = {\n          ok: false,\n          error: {\n            code: 'unknown',\n            message: cause instanceof Error ? cause.message : String(cause),\n          },\n        }\n      }\n      if (!result.ok) {\n        // Idempotent delete: the document was never persisted (e.g. a draft\n        // whose baseline upsert was rejected) or another editor already\n        // deleted it. The desired end state — gone — holds, so removing it\n        // from the session is the honest outcome, not a failure.\n        const idempotentDelete = action === 'delete' && result.error.code === 'not-found'\n        if (!idempotentDelete) {\n          fail(result.error)\n          continue\n        }\n      }\n    }\n\n    if (action === 'delete') context.applyDelete(ref)\n    else if (action === 'set-field') {\n      if (setField) context.applySetField?.(ref, setField)\n    } else context.applyState(ref, ACTION_STATE[action])\n    results.push({ ref, title, ok: true })\n  }\n\n  return { action, ...(setField ? { setField } : {}), results }\n}\n"]}
+{"version":3,"file":"bulk-actions.js","sourceRoot":"","sources":["../../../src/components/cms/bulk-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CmsDocument,\n  CmsValidationIssue,\n  DocumentRef,\n  PublicationState,\n} from '@elytracms/core/cms-core'\nimport type { FilterScalar } from '@elytracms/core/content'\nimport type { OperationError, OperationResult } from '@elytracms/studio/lib/operations'\nimport { matchesRef } from './document-ref-utils'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport {\n  cmsValidationIssueMessage,\n  operationErrorMessage,\n  operationIssueMessage,\n} from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Bulk actions over a table selection (EC-169) — the pure half.\n *\n * Each selected document gets its OWN operations command\n * (`documents.publish` / `documents.unpublish` / `documents.delete`, EC-224;\n * one field patch for a set-field, EC-247 → EC-595 A2), awaited in selection order, and\n * its own per-item outcome. The report enumerates every failure with its\n * reason (validation gate, authorization denial, not-found, …) — a partial\n * failure is never silent and never collapsed into one toast. Session state is\n * only updated for items whose command succeeded.\n */\n\nexport type BulkAction = 'publish' | 'unpublish' | 'delete' | 'set-field'\n\n/**\n * The payload of a `set-field` bulk action (EC-247): assign one filterable\n * scalar field the same value across every selected document. The value is\n * folded into each document the locale-aware way (`applyCellValue`) by the\n * caller's `applySetField`/`dispatch`; this module only carries it.\n */\nexport interface BulkSetField {\n  field: string\n  value: FilterScalar\n}\n\n/** The outcome of one document's command within a bulk run. */\nexport interface BulkItemOutcome {\n  ref: DocumentRef\n  /** Display title at dispatch time (deleted docs still get named in the report). */\n  title: string\n  ok: boolean\n  /** Human-readable failure reason — present exactly when `ok` is false. */\n  reason?: string\n  /** The structured error behind the reason (operation result / validation gate). */\n  error?: OperationError\n}\n\nexport interface BulkReport {\n  action: BulkAction\n  /** Present for `set-field`: the field + value that was applied (report label). */\n  setField?: BulkSetField\n  results: BulkItemOutcome[]\n}\n\nexport function bulkSummary(report: BulkReport): { succeeded: number; failed: number } {\n  let succeeded = 0\n  for (const result of report.results) if (result.ok) succeeded += 1\n  return { succeeded, failed: report.results.length - succeeded }\n}\n\n/** The failure reason a report row shows: validation issues beat the envelope. */\nexport function bulkErrorReason(error: OperationError): string {\n  // EC-494: resolve the carried catalog refs — a bulk publish rejected by the\n  // SERVER-side field-rule gate reports in the editor's language, not English.\n  if (error.code === 'validation' && error.issues.length > 0) {\n    return error.issues.map((issue) => operationIssueMessage(issue)).join(' · ')\n  }\n  return operationErrorMessage(error)\n}\n\nexport interface BulkContext {\n  /** Current session documents (lookup + validation input). */\n  documents: readonly CmsDocument[]\n  titleOf(ref: DocumentRef): string\n  /** Full document validation — gates publish: invalid documents never dispatch. */\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  /** Apply one succeeded state transition to the session. */\n  applyState(ref: DocumentRef, state: PublicationState): void\n  /** Apply one succeeded delete to the session. */\n  applyDelete(ref: DocumentRef): void\n  /**\n   * Apply one succeeded set-field to the session (locale-aware fold). Required\n   * when the action is `set-field`; unused otherwise.\n   */\n  applySetField?(ref: DocumentRef, set: BulkSetField): void\n  /**\n   * Dispatch the ONE operations command for an item. Absent in fixture-only\n   * sessions (no project scope) — items then mutate the session directly.\n   */\n  dispatch?: (action: BulkAction, ref: DocumentRef) => Promise<OperationResult<unknown>>\n}\n\nconst ACTION_STATE: Record<'publish' | 'unpublish', PublicationState> = {\n  publish: 'published',\n  unpublish: 'draft',\n}\n\n/**\n * Run one bulk action over a selection, item by item:\n * 1. publish gates on validation — an invalid document fails with its issues\n *    and dispatches NOTHING (a set-field is a draft edit, EC-225 — never gated),\n * 2. the hidden-strip is NOT a step here (EC-585): it runs inside the one publish\n *    operation the dispatch calls, so a bulk-published snapshot is exactly as clean\n *    as an editor publish by construction (EC-425 used to run a clean step per item),\n * 3. each remaining item dispatches exactly one operations command, awaited,\n * 4. only succeeded items mutate the session,\n * 5. the report carries one honest outcome per item, in selection order.\n */\nexport async function runBulkAction(\n  context: BulkContext,\n  collectionId: string,\n  ids: readonly string[],\n  action: BulkAction,\n  setField?: BulkSetField,\n): Promise<BulkReport> {\n  const results: BulkItemOutcome[] = []\n\n  for (const id of ids) {\n    const ref: DocumentRef = { collection: collectionId, id }\n    const title = context.titleOf(ref)\n    const fail = (error: OperationError) =>\n      results.push({ ref, title, ok: false, reason: bulkErrorReason(error), error })\n\n    const doc = context.documents.find((d) => matchesRef(d, ref))\n    if (!doc) {\n      fail({\n        code: 'not-found',\n        message: translate('cms.list.bulk.error.notInSession'),\n        entity: 'cms-document',\n        key: `${collectionId}:${id}`,\n      })\n      continue\n    }\n\n    if (action === 'publish') {\n      const errors = context.validate(doc).filter((issue) => issue.severity === 'error')\n      if (errors.length > 0) {\n        fail({\n          code: 'validation',\n          message: translate('cms.list.bulk.error.notValidToPublish'),\n          issues: errors.map((issue) => ({\n            code: issue.code,\n            // EC-487 — resolved here, the last point that still has the structured issue.\n            message: cmsValidationIssueMessage(issue),\n            path: [...issue.path],\n            domain: 'cms',\n          })),\n        })\n        continue\n      }\n    }\n\n    if (context.dispatch) {\n      let result: OperationResult<unknown>\n      try {\n        result = await context.dispatch(action, ref)\n      } catch (cause) {\n        // Operations never throw by contract; a broken transport still becomes\n        // a visible per-item failure instead of an aborted bulk run.\n        result = {\n          ok: false,\n          error: {\n            code: 'unknown',\n            message: cause instanceof Error ? cause.message : String(cause),\n          },\n        }\n      }\n      if (!result.ok) {\n        // Idempotent delete: the document was never persisted (e.g. a draft\n        // whose baseline upsert was rejected) or another editor already\n        // deleted it. The desired end state — gone — holds, so removing it\n        // from the session is the honest outcome, not a failure.\n        const idempotentDelete = action === 'delete' && result.error.code === 'not-found'\n        if (!idempotentDelete) {\n          fail(result.error)\n          continue\n        }\n      }\n    }\n\n    if (action === 'delete') context.applyDelete(ref)\n    else if (action === 'set-field') {\n      if (setField) context.applySetField?.(ref, setField)\n    } else context.applyState(ref, ACTION_STATE[action])\n    results.push({ ref, title, ok: true })\n  }\n\n  return { action, ...(setField ? { setField } : {}), results }\n}\n"]}

package/dist/components/cms/cell-edit.d.ts

@@ -7,8 +7,8 @@ import type { OperationError, OperationResult } from '@elytracms/studio/lib/oper
  * Everything here is plain data + functions so the cell-edit state machine is
  * testable without a DOM: which cells are editable, how Tab/Enter advance,
  * how a draft value is folded into a document (active locale only), and how a
- * commit flows through exactly one `documents.upsert` operations command with
- * optimistic apply + rollback on rejection.
+ * commit flows through exactly one field patch (`documents.patch`, through the
+ * session's persister queue — EC-595 A2) with optimistic apply + rollback on rejection.
  */
 /** A cell in the collection table: one document × one field column. */
 export interface CellCoord {
@@ -90,9 +90,9 @@ export interface CellCommitContext extends CellEditOracles {
     /** Restore the pre-edit document after a rejected dispatch. */
     rollbackSession: (previous: CmsDocument) => void;
     /**
-     * Dispatch the ONE operations command for this commit
-     * (`documents.upsert`, EC-141). Absent in fixture-only sessions
-     * (no project scope) — the commit is session-only then.
+     * Dispatch the ONE write for this commit — the field's patch through the persister's
+     * queue (`documents.patch`, EC-595 A2). Absent in fixture-only sessions (no project
+     * scope) — the commit is session-only then.
      */
     dispatch?: (next: CmsDocument) => Promise<OperationResult<unknown>>;
 }

package/dist/components/cms/cell-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"cell-edit.js","sourceRoot":"","sources":["../../../src/components/cms/cell-edit.ts"],"names":[],"mappings":"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","sourcesContent":["import { createDocumentStore, isFieldLocalized, validateDocument, writeField } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\n  DocumentRef,\n  FieldDef,\n  Locale,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport { gateValidateOptions } from './gate-validation'\nimport type { FindAsset } from './gate-validation'\nimport { anchorFieldName } from './inline-field-errors'\nimport type { OperationError, OperationResult } from '@elytracms/studio/lib/operations'\nimport { replaceDoc } from './document-ref-utils'\nimport {\n  cmsValidationIssueMessage,\n  operationErrorMessage,\n  operationIssueMessage,\n} from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Inline cell editing for the collection table (EC-168) — the pure half.\n *\n * Everything here is plain data + functions so the cell-edit state machine is\n * testable without a DOM: which cells are editable, how Tab/Enter advance,\n * how a draft value is folded into a document (active locale only), and how a\n * commit flows through exactly one `documents.upsert` operations command with\n * optimistic apply + rollback on rejection.\n */\n\n// --- Cell identity -----------------------------------------------------------\n\n/** A cell in the collection table: one document × one field column. */\nexport interface CellCoord {\n  docId: string\n  field: string\n}\n\n/** Stable key for a cell (state maps, DOM lookups). */\nexport function cellKey(coord: CellCoord): string {\n  return `${coord.docId}::${coord.field}`\n}\n\n// --- Editability -------------------------------------------------------------\n\n/** How a cell edits: inline control, anchored picker dialog, or not at all. */\nexport type CellEditKind = 'inline' | 'picker' | 'none'\n\nconst INLINE_TYPES: ReadonlySet<FieldDef['type']> = new Set([\n  'text',\n  'number',\n  'boolean',\n  'select',\n  'date',\n])\n\n/**\n * Classify a field's in-table editing surface. Rich text is deliberately not\n * inline-editable (the detail editor owns it); read-only fields never edit.\n */\nexport function cellEditKind(field: FieldDef, readOnly: boolean): CellEditKind {\n  if (readOnly) return 'none'\n  if (field.type === 'relation' || field.type === 'asset') return 'picker'\n  return INLINE_TYPES.has(field.type) ? 'inline' : 'none'\n}\n\n// --- Keyboard advance --------------------------------------------------------\n\n/** Where a committed edit moves next: Tab → next, Shift-Tab → prev, Enter → down. */\nexport type AdvanceDirection = 'next' | 'prev' | 'down'\n\n/**\n * The next editable cell in the table grid, or `null` at a boundary.\n * `docIds` is the rendered row order; `fields` the editable column order.\n * 'next'/'prev' walk row-major (wrapping across rows); 'down' stays in the\n * same column.\n */\nexport function nextEditableCell(\n  docIds: readonly string[],\n  fields: readonly string[],\n  current: CellCoord,\n  direction: AdvanceDirection,\n): CellCoord | null {\n  const row = docIds.indexOf(current.docId)\n  const col = fields.indexOf(current.field)\n  if (row < 0 || col < 0 || fields.length === 0) return null\n  if (direction === 'down') {\n    const nextDoc = docIds[row + 1]\n    return nextDoc === undefined ? null : { docId: nextDoc, field: current.field }\n  }\n  const flat = row * fields.length + col + (direction === 'next' ? 1 : -1)\n  if (flat < 0 || flat >= docIds.length * fields.length) return null\n  const docId = docIds[Math.floor(flat / fields.length)]!\n  return { docId, field: fields[flat % fields.length]! }\n}\n\n// --- Applying a draft value ----------------------------------------------------\n\n// Folding one field value into a document — localized fields write ONLY the given\n// locale's bag (EC-018), shared fields the `values` bag, `undefined` clears — is\n// core's `writeField` (EC-580); this module's `applyCellValue` was a copy of it.\n\n// --- Validation gate -----------------------------------------------------------\n\n/**\n * Error-severity issues that the edited cell itself caused. Localized fields\n * only reject on issues for the edited locale — a missing translation in some\n * *other* locale must not block this commit.\n *\n * EC-497: validates with THE bag (`gateValidateOptions`), not the `store` +\n * `localeConfig` subset it used to assemble here. A cell edit is not a weaker\n * KIND of validation — it is the same validation, FILTERED to the cell being\n * committed, which is the whole option-set contract in one function: surfaces\n * differ in what they do with the issues, never in what they validated with.\n *\n * EC-516: an issue belongs to the edited cell when the TOP-LEVEL field its\n * `path` resolves to is the edited column — `anchorFieldName`, the grammar the\n * document form's inline errors already use. `meta.field` is never compared\n * here: `validateObject` stamps it with the LEAF subfield name, so a broken\n * `items[0].title` used to pass for a `title` issue and block an unrelated\n * `title` edit (and the owning `items` column saw nothing).\n */\nexport function cellEditIssues(\n  registry: CollectionRegistry,\n  documents: readonly CmsDocument[],\n  localeConfig: LocaleConfig,\n  collection: CollectionDef,\n  next: CmsDocument,\n  fieldName: string,\n  locale: Locale,\n  oracles: CellEditOracles = {},\n): CmsValidationIssue[] {\n  // Validate against the session with the edited document swapped in, so\n  // self-relations and same-document targets resolve.\n  const store = createDocumentStore(replaceDoc(documents, next))\n  const issues = validateDocument(\n    registry,\n    next,\n    gateValidateOptions({\n      store,\n      localeConfig,\n      isPublished: oracles.isPublished ?? (() => false),\n      ...(oracles.findAsset ? { findAsset: oracles.findAsset } : {}),\n    }),\n  )\n  const localized = isFieldLocalized(collection, fieldName)\n  return issues.filter((issue) => {\n    if (issue.severity !== 'error') return false\n    if (anchorFieldName(collection, issue) !== fieldName) return false\n    if (!localized) return true\n    // Localized field paths are ['documents', key, 'localized', <locale>, <field>, …].\n    const at = issue.path.indexOf('localized')\n    return at < 0 || issue.path[at + 1] === locale\n  })\n}\n\n// --- Commit pipeline -------------------------------------------------------------\n\n/** Outcome of one cell commit: the new document, or a structured rejection. */\nexport type CellCommitOutcome =\n  | { ok: true; doc: CmsDocument }\n  | { ok: false; error: OperationError }\n\nexport interface CellCommitInput {\n  collection: CollectionDef\n  /** The document as currently rendered (the rollback target). */\n  doc: CmsDocument\n  field: FieldDef\n  /** The active locale at the point of edit (table locale resolution). */\n  locale: Locale\n  /** The committed draft value (`undefined` clears the field). */\n  value: unknown\n}\n\n/**\n * The session oracles the canonical option bag needs beyond the store + locales\n * (EC-497). Optional so a fixture-only caller still gets the rest of the bag;\n * absent `isPublished` means \"nothing is published\", the engine's own default.\n */\nexport interface CellEditOracles {\n  isPublished?: (ref: DocumentRef) => boolean\n  /** The asset-library oracle (EC-588) — record lookup; absent = no asset checks. */\n  findAsset?: FindAsset\n}\n\nexport interface CellCommitContext extends CellEditOracles {\n  registry: CollectionRegistry\n  /** Current session documents (relation/asset target resolution). */\n  documents: readonly CmsDocument[]\n  localeConfig: LocaleConfig\n  /** Optimistically apply the edited document to the session. */\n  applySession: (next: CmsDocument) => void\n  /** Restore the pre-edit document after a rejected dispatch. */\n  rollbackSession: (previous: CmsDocument) => void\n  /**\n   * Dispatch the ONE operations command for this commit\n   * (`documents.upsert`, EC-141). Absent in fixture-only sessions\n   * (no project scope) — the commit is session-only then.\n   */\n  dispatch?: (next: CmsDocument) => Promise<OperationResult<unknown>>\n}\n\n/**\n * Commit one cell edit:\n * 1. fold the value into the document (active locale only),\n * 2. gate on field validation — rejected edits dispatch NOTHING and report a\n *    structured validation error for the cell,\n * 3. apply optimistically, dispatch exactly one operations command,\n * 4. roll the session back when the operation result is a rejection.\n */\nexport async function commitCellEdit(\n  context: CellCommitContext,\n  input: CellCommitInput,\n): Promise<CellCommitOutcome> {\n  const next = writeField(input.collection, input.doc, input.field.name, input.locale, input.value)\n\n  const issues = cellEditIssues(\n    context.registry,\n    context.documents,\n    context.localeConfig,\n    input.collection,\n    next,\n    input.field.name,\n    input.locale,\n    {\n      ...(context.isPublished ? { isPublished: context.isPublished } : {}),\n      ...(context.findAsset ? { findAsset: context.findAsset } : {}),\n    },\n  )\n  if (issues.length > 0) {\n    return {\n      ok: false,\n      error: {\n        code: 'validation',\n        // EC-487/EC-494: this producer is CLIENT-side and already holds the structured\n        // issue, so it resolves the message here. (Since EC-494 the wire also carries\n        // the ref, which is what makes the SERVER-side publish gate localize.)\n        message: cmsValidationIssueMessage(issues[0]!),\n        issues: issues.map((issue) => ({\n          code: issue.code,\n          message: cmsValidationIssueMessage(issue),\n          path: [...issue.path],\n          domain: 'cms',\n        })),\n      },\n    }\n  }\n\n  context.applySession(next)\n  if (context.dispatch) {\n    let result: OperationResult<unknown>\n    try {\n      result = await context.dispatch(next)\n    } catch (cause) {\n      // Operations never throw by contract; treat a broken transport the same\n      // as a failed command so the cell still rolls back visibly.\n      result = {\n        ok: false,\n        error: { code: 'unknown', message: cause instanceof Error ? cause.message : String(cause) },\n      }\n    }\n    if (!result.ok) {\n      context.rollbackSession(input.doc)\n      return { ok: false, error: result.error }\n    }\n  }\n  return { ok: true, doc: next }\n}\n\n/** The message the cell renders for a rejection: the first issue beats the envelope. */\nexport function cellErrorMessage(error: OperationError): string {\n  // EC-494: an OperationIssue now carries its catalog ref across the wire, so a\n  // rejection built SERVER-SIDE (the publish gate) localizes here too — not only the\n  // studio-built ones above.\n  if (error.code === 'validation' && error.issues.length > 0)\n    return operationIssueMessage(error.issues[0]!)\n  return operationErrorMessage(error)\n}\n"]}
+{"version":3,"file":"cell-edit.js","sourceRoot":"","sources":["../../../src/components/cms/cell-edit.ts"],"names":[],"mappings":"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","sourcesContent":["import { createDocumentStore, isFieldLocalized, validateDocument, writeField } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\n  DocumentRef,\n  FieldDef,\n  Locale,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport { gateValidateOptions } from './gate-validation'\nimport type { FindAsset } from './gate-validation'\nimport { anchorFieldName } from './inline-field-errors'\nimport type { OperationError, OperationResult } from '@elytracms/studio/lib/operations'\nimport { replaceDoc } from './document-ref-utils'\nimport {\n  cmsValidationIssueMessage,\n  operationErrorMessage,\n  operationIssueMessage,\n} from '@elytracms/studio/lib/persona/labels'\n\n/**\n * Inline cell editing for the collection table (EC-168) — the pure half.\n *\n * Everything here is plain data + functions so the cell-edit state machine is\n * testable without a DOM: which cells are editable, how Tab/Enter advance,\n * how a draft value is folded into a document (active locale only), and how a\n * commit flows through exactly one field patch (`documents.patch`, through the\n * session's persister queue — EC-595 A2) with optimistic apply + rollback on rejection.\n */\n\n// --- Cell identity -----------------------------------------------------------\n\n/** A cell in the collection table: one document × one field column. */\nexport interface CellCoord {\n  docId: string\n  field: string\n}\n\n/** Stable key for a cell (state maps, DOM lookups). */\nexport function cellKey(coord: CellCoord): string {\n  return `${coord.docId}::${coord.field}`\n}\n\n// --- Editability -------------------------------------------------------------\n\n/** How a cell edits: inline control, anchored picker dialog, or not at all. */\nexport type CellEditKind = 'inline' | 'picker' | 'none'\n\nconst INLINE_TYPES: ReadonlySet<FieldDef['type']> = new Set([\n  'text',\n  'number',\n  'boolean',\n  'select',\n  'date',\n])\n\n/**\n * Classify a field's in-table editing surface. Rich text is deliberately not\n * inline-editable (the detail editor owns it); read-only fields never edit.\n */\nexport function cellEditKind(field: FieldDef, readOnly: boolean): CellEditKind {\n  if (readOnly) return 'none'\n  if (field.type === 'relation' || field.type === 'asset') return 'picker'\n  return INLINE_TYPES.has(field.type) ? 'inline' : 'none'\n}\n\n// --- Keyboard advance --------------------------------------------------------\n\n/** Where a committed edit moves next: Tab → next, Shift-Tab → prev, Enter → down. */\nexport type AdvanceDirection = 'next' | 'prev' | 'down'\n\n/**\n * The next editable cell in the table grid, or `null` at a boundary.\n * `docIds` is the rendered row order; `fields` the editable column order.\n * 'next'/'prev' walk row-major (wrapping across rows); 'down' stays in the\n * same column.\n */\nexport function nextEditableCell(\n  docIds: readonly string[],\n  fields: readonly string[],\n  current: CellCoord,\n  direction: AdvanceDirection,\n): CellCoord | null {\n  const row = docIds.indexOf(current.docId)\n  const col = fields.indexOf(current.field)\n  if (row < 0 || col < 0 || fields.length === 0) return null\n  if (direction === 'down') {\n    const nextDoc = docIds[row + 1]\n    return nextDoc === undefined ? null : { docId: nextDoc, field: current.field }\n  }\n  const flat = row * fields.length + col + (direction === 'next' ? 1 : -1)\n  if (flat < 0 || flat >= docIds.length * fields.length) return null\n  const docId = docIds[Math.floor(flat / fields.length)]!\n  return { docId, field: fields[flat % fields.length]! }\n}\n\n// --- Applying a draft value ----------------------------------------------------\n\n// Folding one field value into a document — localized fields write ONLY the given\n// locale's bag (EC-018), shared fields the `values` bag, `undefined` clears — is\n// core's `writeField` (EC-580); this module's `applyCellValue` was a copy of it.\n\n// --- Validation gate -----------------------------------------------------------\n\n/**\n * Error-severity issues that the edited cell itself caused. Localized fields\n * only reject on issues for the edited locale — a missing translation in some\n * *other* locale must not block this commit.\n *\n * EC-497: validates with THE bag (`gateValidateOptions`), not the `store` +\n * `localeConfig` subset it used to assemble here. A cell edit is not a weaker\n * KIND of validation — it is the same validation, FILTERED to the cell being\n * committed, which is the whole option-set contract in one function: surfaces\n * differ in what they do with the issues, never in what they validated with.\n *\n * EC-516: an issue belongs to the edited cell when the TOP-LEVEL field its\n * `path` resolves to is the edited column — `anchorFieldName`, the grammar the\n * document form's inline errors already use. `meta.field` is never compared\n * here: `validateObject` stamps it with the LEAF subfield name, so a broken\n * `items[0].title` used to pass for a `title` issue and block an unrelated\n * `title` edit (and the owning `items` column saw nothing).\n */\nexport function cellEditIssues(\n  registry: CollectionRegistry,\n  documents: readonly CmsDocument[],\n  localeConfig: LocaleConfig,\n  collection: CollectionDef,\n  next: CmsDocument,\n  fieldName: string,\n  locale: Locale,\n  oracles: CellEditOracles = {},\n): CmsValidationIssue[] {\n  // Validate against the session with the edited document swapped in, so\n  // self-relations and same-document targets resolve.\n  const store = createDocumentStore(replaceDoc(documents, next))\n  const issues = validateDocument(\n    registry,\n    next,\n    gateValidateOptions({\n      store,\n      localeConfig,\n      isPublished: oracles.isPublished ?? (() => false),\n      ...(oracles.findAsset ? { findAsset: oracles.findAsset } : {}),\n    }),\n  )\n  const localized = isFieldLocalized(collection, fieldName)\n  return issues.filter((issue) => {\n    if (issue.severity !== 'error') return false\n    if (anchorFieldName(collection, issue) !== fieldName) return false\n    if (!localized) return true\n    // Localized field paths are ['documents', key, 'localized', <locale>, <field>, …].\n    const at = issue.path.indexOf('localized')\n    return at < 0 || issue.path[at + 1] === locale\n  })\n}\n\n// --- Commit pipeline -------------------------------------------------------------\n\n/** Outcome of one cell commit: the new document, or a structured rejection. */\nexport type CellCommitOutcome =\n  | { ok: true; doc: CmsDocument }\n  | { ok: false; error: OperationError }\n\nexport interface CellCommitInput {\n  collection: CollectionDef\n  /** The document as currently rendered (the rollback target). */\n  doc: CmsDocument\n  field: FieldDef\n  /** The active locale at the point of edit (table locale resolution). */\n  locale: Locale\n  /** The committed draft value (`undefined` clears the field). */\n  value: unknown\n}\n\n/**\n * The session oracles the canonical option bag needs beyond the store + locales\n * (EC-497). Optional so a fixture-only caller still gets the rest of the bag;\n * absent `isPublished` means \"nothing is published\", the engine's own default.\n */\nexport interface CellEditOracles {\n  isPublished?: (ref: DocumentRef) => boolean\n  /** The asset-library oracle (EC-588) — record lookup; absent = no asset checks. */\n  findAsset?: FindAsset\n}\n\nexport interface CellCommitContext extends CellEditOracles {\n  registry: CollectionRegistry\n  /** Current session documents (relation/asset target resolution). */\n  documents: readonly CmsDocument[]\n  localeConfig: LocaleConfig\n  /** Optimistically apply the edited document to the session. */\n  applySession: (next: CmsDocument) => void\n  /** Restore the pre-edit document after a rejected dispatch. */\n  rollbackSession: (previous: CmsDocument) => void\n  /**\n   * Dispatch the ONE write for this commit — the field's patch through the persister's\n   * queue (`documents.patch`, EC-595 A2). Absent in fixture-only sessions (no project\n   * scope) — the commit is session-only then.\n   */\n  dispatch?: (next: CmsDocument) => Promise<OperationResult<unknown>>\n}\n\n/**\n * Commit one cell edit:\n * 1. fold the value into the document (active locale only),\n * 2. gate on field validation — rejected edits dispatch NOTHING and report a\n *    structured validation error for the cell,\n * 3. apply optimistically, dispatch exactly one operations command,\n * 4. roll the session back when the operation result is a rejection.\n */\nexport async function commitCellEdit(\n  context: CellCommitContext,\n  input: CellCommitInput,\n): Promise<CellCommitOutcome> {\n  const next = writeField(input.collection, input.doc, input.field.name, input.locale, input.value)\n\n  const issues = cellEditIssues(\n    context.registry,\n    context.documents,\n    context.localeConfig,\n    input.collection,\n    next,\n    input.field.name,\n    input.locale,\n    {\n      ...(context.isPublished ? { isPublished: context.isPublished } : {}),\n      ...(context.findAsset ? { findAsset: context.findAsset } : {}),\n    },\n  )\n  if (issues.length > 0) {\n    return {\n      ok: false,\n      error: {\n        code: 'validation',\n        // EC-487/EC-494: this producer is CLIENT-side and already holds the structured\n        // issue, so it resolves the message here. (Since EC-494 the wire also carries\n        // the ref, which is what makes the SERVER-side publish gate localize.)\n        message: cmsValidationIssueMessage(issues[0]!),\n        issues: issues.map((issue) => ({\n          code: issue.code,\n          message: cmsValidationIssueMessage(issue),\n          path: [...issue.path],\n          domain: 'cms',\n        })),\n      },\n    }\n  }\n\n  context.applySession(next)\n  if (context.dispatch) {\n    let result: OperationResult<unknown>\n    try {\n      result = await context.dispatch(next)\n    } catch (cause) {\n      // Operations never throw by contract; treat a broken transport the same\n      // as a failed command so the cell still rolls back visibly.\n      result = {\n        ok: false,\n        error: { code: 'unknown', message: cause instanceof Error ? cause.message : String(cause) },\n      }\n    }\n    if (!result.ok) {\n      context.rollbackSession(input.doc)\n      return { ok: false, error: result.error }\n    }\n  }\n  return { ok: true, doc: next }\n}\n\n/** The message the cell renders for a rejection: the first issue beats the envelope. */\nexport function cellErrorMessage(error: OperationError): string {\n  // EC-494: an OperationIssue now carries its catalog ref across the wire, so a\n  // rejection built SERVER-SIDE (the publish gate) localizes here too — not only the\n  // studio-built ones above.\n  if (error.code === 'validation' && error.issues.length > 0)\n    return operationIssueMessage(error.issues[0]!)\n  return operationErrorMessage(error)\n}\n"]}

package/dist/components/cms/cell.js.map

@@ -1 +1 @@
-{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../../src/components/cms/cell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Boxes, Check, Image, Link2, Minus } from 'lucide-react'\nimport { readAssetId, readDocumentRef } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef, FieldDef } from '@elytracms/core/cms-core'\nimport { blockRootsOf } from '@elytracms/core/project-graph'\nimport { richTextPlainText } from '@elytracms/core/rich-text'\nimport { Badge, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { localeChipLabel, resolveDisplayedValue } from '@elytracms/studio/lib/locale'\nimport type { DisplayedFallback } from '@elytracms/studio/lib/locale'\nimport type { ResolvedAsset } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { isDisplayableAssetUrl } from '@elytracms/studio/lib/assets'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport { AssetThumb, useAssetRecord } from '../assets/asset-thumb'\n\n/**\n * Render a document's field value for a table cell, by field type (brief\n * §8.4, EC-070), resolved in the studio's ambient active locale (EC-176).\n * A value served via EC-018 locale fallback carries a visible chip — never\n * silently mixed in as if it were translated.\n */\nexport function CellValue({\n  collection,\n  doc,\n  field,\n}: {\n  collection: CollectionDef\n  doc: CmsDocument\n  field: FieldDef\n}) {\n  const source = useCollectionView()\n  const { value, fallback } = resolveDisplayedValue(\n    collection,\n    doc,\n    field.name,\n    source.activeLocale,\n    source.localeConfig,\n  )\n\n  if (value === undefined || value === null || value === '') {\n    return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  }\n\n  return (\n    <span className=\"inline-flex min-w-0 max-w-full items-center gap-1.5\">\n      <TypedCellValue field={field} value={value} />\n      <FallbackChip fallback={fallback} testId={`cell-fallback-${doc.id}-${field.name}`} />\n    </span>\n  )\n}\n\n/**\n * Subtle source-locale chip on a fallback-displayed value (EC-176): e.g. a\n * German view showing untranslated English content gets an \"EN\" marker.\n */\nexport function FallbackChip({\n  fallback,\n  testId,\n}: {\n  fallback: DisplayedFallback | null\n  testId: string\n}) {\n  if (fallback === null) return null\n  return (\n    <Badge\n      variant=\"outline\"\n      data-testid={testId}\n      title={fallbackTitle(fallback)}\n      className=\"shrink-0 px-1 py-0 text-[0.6rem] uppercase tracking-wide text-muted-foreground\"\n    >\n      {localeChipLabel(fallback.sourceLocale)}\n    </Badge>\n  )\n}\n\n/** Plain-language tooltip of a fallback chip. */\nexport function fallbackTitle(fallback: DisplayedFallback): string {\n  return translate('cms.cell.fallbackTitle', {\n    source: localeChipLabel(fallback.sourceLocale),\n    requested: localeChipLabel(fallback.requestedLocale),\n  })\n}\n\nfunction TypedCellValue({ field, value }: { field: FieldDef; value: unknown }) {\n  switch (field.type) {\n    case 'boolean':\n      return value === true ? (\n        <Check className=\"size-4 text-success\" />\n      ) : (\n        <Minus className=\"size-3.5 text-muted-foreground/50\" />\n      )\n    case 'select':\n      return <Badge variant=\"outline\">{String(value)}</Badge>\n    case 'number':\n      return <Text size=\"sm\" mono>{String(value)}</Text>\n    case 'date':\n      return (\n        <Text size=\"sm\" tone=\"muted\" mono>\n          {String(value).slice(0, 10)}\n        </Text>\n      )\n    case 'richText':\n      return (\n        <Text size=\"xs\" tone=\"subtle\">\n          {richTextCellSummary(value).slice(0, 40) || translate('cms.cell.richText')}\n        </Text>\n      )\n    case 'relation':\n      return <RelationCell value={value} />\n    case 'asset':\n      return <AssetCell value={value} />\n    case 'blocks':\n      return <BlocksCell value={value} />\n    case 'object': {\n      // EC-253: list-view summary, never `[object Object]`. A repeater shows its\n      // item count; a single object is edited in the detail form, not the cell.\n      if (field.multiple) {\n        const count = Array.isArray(value) ? value.length : 0\n        return (\n          <Badge variant=\"outline\">\n            {translate(count === 1 ? 'cms.cell.itemCount.one' : 'cms.cell.itemCount.other', { count })}\n          </Badge>\n        )\n      }\n      return (\n        <Text size=\"xs\" tone=\"subtle\">\n          {value && typeof value === 'object' ? translate('cms.cell.object') : '—'}\n        </Text>\n      )\n    }\n    default:\n      return (\n        <Text size=\"sm\" className=\"truncate\">\n          {String(value)}\n        </Text>\n      )\n  }\n}\n\nfunction RelationCell({ value }: { value: unknown }) {\n  const source = useCollectionView()\n  const refs = toRefArray(value)\n  if (refs.length === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  // EC-246c: calm de-pilled read — a single muted link glyph + the title(s), not\n  // a row of info pills. Matches the relation FIELD's row treatment; the pill was\n  // a design cue the list doesn't need.\n  return (\n    <span className=\"inline-flex min-w-0 items-center gap-1.5 text-sm\">\n      <Link2 className=\"size-3.5 shrink-0 text-muted-foreground\" />\n      <span className=\"min-w-0 truncate\">\n        {refs.slice(0, 3).map((ref) => source.titleOf(ref)).join(', ')}\n      </span>\n      {refs.length > 3 ? (\n        <Text size=\"xs\" tone=\"subtle\" className=\"shrink-0\">\n          +{refs.length - 3}\n        </Text>\n      ) : null}\n    </span>\n  )\n}\n\n/**\n * A blocks/composition cell: a count of TOP-LEVEL blocks (EC-212) — matching\n * what the canvas/page-tree present as the block list, never `[object Object]`.\n */\nfunction BlocksCell({ value }: { value: unknown }) {\n  const count = blockRootsOf(value).length\n  if (count === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  return (\n    <Badge variant=\"outline\">\n      <Boxes className=\"size-3\" />{' '}\n      {translate(count === 1 ? 'cms.cell.blockCount.one' : 'cms.cell.blockCount.other', { count })}\n    </Badge>\n  )\n}\n\nfunction AssetCell({ value }: { value: unknown }) {\n  const source = useCollectionView()\n  const assetCollectionId = source.assetCollectionId ?? 'asset'\n  // EC-277: tolerate self-typed `{ type:'asset', id }` envelopes and legacy bare ids.\n  const ids = (Array.isArray(value) ? value : [value])\n    .map(readAssetId)\n    .filter((id): id is string => id !== undefined)\n  if (ids.length === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  // EC-346: multiple assets show the first, plus a \"+N\" count for the rest —\n  // this IS the field cell, not a gallery editor.\n  const first = ids[0]!\n  return (\n    <div className=\"flex flex-wrap items-center gap-1.5\">\n      <AssetFieldThumb assetId={first} assetCollectionId={assetCollectionId} />\n      {ids.length > 1 ? <Text size=\"xs\" tone=\"subtle\">+{ids.length - 1}</Text> : null}\n    </div>\n  )\n}\n\n/**\n * EC-346 — an asset-type FIELD column's cell in a document list: a small\n * thumbnail (`size-8`, matching the 0.0.39 filename-column pattern), reusing the\n * SAME {@link AssetThumb} the assets rail uses so a focal point (EC-230/248)\n * crops the preview identically everywhere it appears. Resolves the full record\n * from the ambient asset library (`useAssetRecord` — ProjectProviders already\n * mounts an `<AssetsProvider>` at the project level, EC-195, so every CMS list\n * surface sees it) and prefers it over the source's own summary because only the\n * ambient record carries the focal point. Falls back to the source's\n * `resolveAsset` label/best-effort-image (the AD-19 \"no `<AssetsProvider>`\"\n * degradation a portable rail — or a test double — without a mounted library\n * still needs) so this never regresses the prior behaviour. Never crashes on an\n * id that resolves to nothing — both paths render a placeholder, never a badge\n * defaulted from a missing record.\n */\nfunction AssetFieldThumb({\n  assetId,\n  assetCollectionId,\n}: {\n  assetId: string\n  assetCollectionId: string\n}) {\n  const source = useCollectionView()\n  const ambient = useAssetRecord(assetId)\n  if (ambient) return <AssetThumb record={ambient} className=\"size-8 shrink-0\" />\n  const resolved = source.resolveAsset?.(assetId)\n  const label =\n    resolved?.title ?? resolved?.filename ?? source.titleOf({ collection: assetCollectionId, id: assetId })\n  return <AssetPreview record={resolved} label={label} />\n}\n\n/**\n * The pre-EC-346 fallback preview: an image thumbnail for image assets with a\n * resolvable URL (EC-212), otherwise the labelled icon badge (and the same\n * badge whenever the source can't resolve the record — e.g. no asset backend).\n * Used only when no ambient asset library is mounted (see {@link AssetFieldThumb}).\n */\nfunction AssetPreview({ record, label }: { record: ResolvedAsset | undefined; label: string }) {\n  const isImage = record?.contentType?.startsWith('image/') ?? false\n  const url = record?.url\n  if (isImage && isDisplayableAssetUrl(url)) {\n    return (\n      <span className=\"inline-flex min-w-0 items-center gap-1.5\">\n        <img\n          src={url}\n          alt={record?.alt ?? label}\n          loading=\"lazy\"\n          className=\"size-7 shrink-0 rounded border border-border bg-muted object-cover\"\n        />\n        <Text size=\"xs\" tone=\"subtle\" className=\"max-w-[10rem] truncate\">\n          {label}\n        </Text>\n      </span>\n    )\n  }\n  return (\n    <Badge variant=\"outline\">\n      <Image className=\"size-3\" /> {label}\n    </Badge>\n  )\n}\n\n/**\n * Normalize a relation value (single ref or array of refs) into an array of\n * `DocumentRef`s. EC-277: unwraps self-typed `{ type:'reference', ... }` envelopes\n * and legacy bare `{ collection, id }` via the shared tolerant reader.\n */\nexport function toRefArray(value: unknown): DocumentRef[] {\n  const list = Array.isArray(value) ? value : [value]\n  return list.map(readDocumentRef).filter((ref): ref is DocumentRef => ref !== undefined)\n}\n\nfunction stripHtml(html: string): string {\n  return html.replace(/<[^>]*>/g, ' ').replace(/\\s+/g, ' ').trim()\n}\n\n/**\n * EC-348 — a richText field's stored value is the rich-text envelope\n * (`{ version, doc }` TipTap JSON, EC-314), not an HTML string: `stripHtml`\n * alone here yielded the literal `[object Object]`. Fallback chain: a valid\n * envelope extracts to plain text (`richTextPlainText`); a legacy plain/HTML\n * string (pre-EC-314 content, or any other non-envelope string) still goes\n * through `stripHtml` as before; anything else (garbage, wrong field-type data)\n * yields `''` so the cell's placeholder shows — never a crash, never\n * `[object Object]`.\n */\nfunction richTextCellSummary(value: unknown): string {\n  const extracted = richTextPlainText(value)\n  if (extracted !== undefined) return extracted\n  return typeof value === 'string' ? stripHtml(value) : ''\n}\n"]}
+{"version":3,"file":"cell.js","sourceRoot":"","sources":["../../../src/components/cms/cell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Boxes, Check, Image, Link2, Minus } from 'lucide-react'\nimport { readAssetId, readDocumentRef } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef, FieldDef } from '@elytracms/core/cms-core'\nimport { blockRootsOf } from '@elytracms/core/project-graph'\nimport { richTextPlainText } from '@elytracms/core/rich-text'\nimport { Badge, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { localeChipLabel, resolveDisplayedValue } from '@elytracms/studio/lib/locale'\nimport type { DisplayedFallback } from '@elytracms/studio/lib/locale'\nimport type { AssetDisplay } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { isDisplayableAssetUrl } from '@elytracms/studio/lib/assets'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport { AssetThumb, useAssetRecord } from '../assets/asset-thumb'\n\n/**\n * Render a document's field value for a table cell, by field type (brief\n * §8.4, EC-070), resolved in the studio's ambient active locale (EC-176).\n * A value served via EC-018 locale fallback carries a visible chip — never\n * silently mixed in as if it were translated.\n */\nexport function CellValue({\n  collection,\n  doc,\n  field,\n}: {\n  collection: CollectionDef\n  doc: CmsDocument\n  field: FieldDef\n}) {\n  const source = useCollectionView()\n  const { value, fallback } = resolveDisplayedValue(\n    collection,\n    doc,\n    field.name,\n    source.activeLocale,\n    source.localeConfig,\n  )\n\n  if (value === undefined || value === null || value === '') {\n    return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  }\n\n  return (\n    <span className=\"inline-flex min-w-0 max-w-full items-center gap-1.5\">\n      <TypedCellValue field={field} value={value} />\n      <FallbackChip fallback={fallback} testId={`cell-fallback-${doc.id}-${field.name}`} />\n    </span>\n  )\n}\n\n/**\n * Subtle source-locale chip on a fallback-displayed value (EC-176): e.g. a\n * German view showing untranslated English content gets an \"EN\" marker.\n */\nexport function FallbackChip({\n  fallback,\n  testId,\n}: {\n  fallback: DisplayedFallback | null\n  testId: string\n}) {\n  if (fallback === null) return null\n  return (\n    <Badge\n      variant=\"outline\"\n      data-testid={testId}\n      title={fallbackTitle(fallback)}\n      className=\"shrink-0 px-1 py-0 text-[0.6rem] uppercase tracking-wide text-muted-foreground\"\n    >\n      {localeChipLabel(fallback.sourceLocale)}\n    </Badge>\n  )\n}\n\n/** Plain-language tooltip of a fallback chip. */\nexport function fallbackTitle(fallback: DisplayedFallback): string {\n  return translate('cms.cell.fallbackTitle', {\n    source: localeChipLabel(fallback.sourceLocale),\n    requested: localeChipLabel(fallback.requestedLocale),\n  })\n}\n\nfunction TypedCellValue({ field, value }: { field: FieldDef; value: unknown }) {\n  switch (field.type) {\n    case 'boolean':\n      return value === true ? (\n        <Check className=\"size-4 text-success\" />\n      ) : (\n        <Minus className=\"size-3.5 text-muted-foreground/50\" />\n      )\n    case 'select':\n      return <Badge variant=\"outline\">{String(value)}</Badge>\n    case 'number':\n      return <Text size=\"sm\" mono>{String(value)}</Text>\n    case 'date':\n      return (\n        <Text size=\"sm\" tone=\"muted\" mono>\n          {String(value).slice(0, 10)}\n        </Text>\n      )\n    case 'richText':\n      return (\n        <Text size=\"xs\" tone=\"subtle\">\n          {richTextCellSummary(value).slice(0, 40) || translate('cms.cell.richText')}\n        </Text>\n      )\n    case 'relation':\n      return <RelationCell value={value} />\n    case 'asset':\n      return <AssetCell value={value} />\n    case 'blocks':\n      return <BlocksCell value={value} />\n    case 'object': {\n      // EC-253: list-view summary, never `[object Object]`. A repeater shows its\n      // item count; a single object is edited in the detail form, not the cell.\n      if (field.multiple) {\n        const count = Array.isArray(value) ? value.length : 0\n        return (\n          <Badge variant=\"outline\">\n            {translate(count === 1 ? 'cms.cell.itemCount.one' : 'cms.cell.itemCount.other', { count })}\n          </Badge>\n        )\n      }\n      return (\n        <Text size=\"xs\" tone=\"subtle\">\n          {value && typeof value === 'object' ? translate('cms.cell.object') : '—'}\n        </Text>\n      )\n    }\n    default:\n      return (\n        <Text size=\"sm\" className=\"truncate\">\n          {String(value)}\n        </Text>\n      )\n  }\n}\n\nfunction RelationCell({ value }: { value: unknown }) {\n  const source = useCollectionView()\n  const refs = toRefArray(value)\n  if (refs.length === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  // EC-246c: calm de-pilled read — a single muted link glyph + the title(s), not\n  // a row of info pills. Matches the relation FIELD's row treatment; the pill was\n  // a design cue the list doesn't need.\n  return (\n    <span className=\"inline-flex min-w-0 items-center gap-1.5 text-sm\">\n      <Link2 className=\"size-3.5 shrink-0 text-muted-foreground\" />\n      <span className=\"min-w-0 truncate\">\n        {refs.slice(0, 3).map((ref) => source.titleOf(ref)).join(', ')}\n      </span>\n      {refs.length > 3 ? (\n        <Text size=\"xs\" tone=\"subtle\" className=\"shrink-0\">\n          +{refs.length - 3}\n        </Text>\n      ) : null}\n    </span>\n  )\n}\n\n/**\n * A blocks/composition cell: a count of TOP-LEVEL blocks (EC-212) — matching\n * what the canvas/page-tree present as the block list, never `[object Object]`.\n */\nfunction BlocksCell({ value }: { value: unknown }) {\n  const count = blockRootsOf(value).length\n  if (count === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  return (\n    <Badge variant=\"outline\">\n      <Boxes className=\"size-3\" />{' '}\n      {translate(count === 1 ? 'cms.cell.blockCount.one' : 'cms.cell.blockCount.other', { count })}\n    </Badge>\n  )\n}\n\nfunction AssetCell({ value }: { value: unknown }) {\n  const source = useCollectionView()\n  const assetCollectionId = source.assetCollectionId ?? 'asset'\n  // EC-277: tolerate self-typed `{ type:'asset', id }` envelopes and legacy bare ids.\n  const ids = (Array.isArray(value) ? value : [value])\n    .map(readAssetId)\n    .filter((id): id is string => id !== undefined)\n  if (ids.length === 0) return <Minus className=\"size-3.5 text-muted-foreground/50\" />\n  // EC-346: multiple assets show the first, plus a \"+N\" count for the rest —\n  // this IS the field cell, not a gallery editor.\n  const first = ids[0]!\n  return (\n    <div className=\"flex flex-wrap items-center gap-1.5\">\n      <AssetFieldThumb assetId={first} assetCollectionId={assetCollectionId} />\n      {ids.length > 1 ? <Text size=\"xs\" tone=\"subtle\">+{ids.length - 1}</Text> : null}\n    </div>\n  )\n}\n\n/**\n * EC-346 — an asset-type FIELD column's cell in a document list: a small\n * thumbnail (`size-8`, matching the 0.0.39 filename-column pattern), reusing the\n * SAME {@link AssetThumb} the assets rail uses so a focal point (EC-230/248)\n * crops the preview identically everywhere it appears. Resolves the full record\n * from the ambient asset library (`useAssetRecord` — ProjectProviders already\n * mounts an `<AssetsProvider>` at the project level, EC-195, so every CMS list\n * surface sees it) and prefers it over the source's own summary because only the\n * ambient record carries the focal point. Falls back to the source's\n * `resolveAsset` label/best-effort-image (the AD-19 \"no `<AssetsProvider>`\"\n * degradation a portable rail — or a test double — without a mounted library\n * still needs) so this never regresses the prior behaviour. Never crashes on an\n * id that resolves to nothing — both paths render a placeholder, never a badge\n * defaulted from a missing record.\n */\nfunction AssetFieldThumb({\n  assetId,\n  assetCollectionId,\n}: {\n  assetId: string\n  assetCollectionId: string\n}) {\n  const source = useCollectionView()\n  const ambient = useAssetRecord(assetId)\n  if (ambient) return <AssetThumb record={ambient} className=\"size-8 shrink-0\" />\n  const resolved = source.resolveAsset?.(assetId)\n  const label =\n    resolved?.title ?? resolved?.filename ?? source.titleOf({ collection: assetCollectionId, id: assetId })\n  return <AssetPreview record={resolved} label={label} />\n}\n\n/**\n * The pre-EC-346 fallback preview: an image thumbnail for image assets with a\n * resolvable URL (EC-212), otherwise the labelled icon badge (and the same\n * badge whenever the source can't resolve the record — e.g. no asset backend).\n * Used only when no ambient asset library is mounted (see {@link AssetFieldThumb}).\n */\nfunction AssetPreview({ record, label }: { record: AssetDisplay | undefined; label: string }) {\n  const isImage = record?.contentType?.startsWith('image/') ?? false\n  const url = record?.url\n  if (isImage && isDisplayableAssetUrl(url)) {\n    return (\n      <span className=\"inline-flex min-w-0 items-center gap-1.5\">\n        <img\n          src={url}\n          alt={record?.alt ?? label}\n          loading=\"lazy\"\n          className=\"size-7 shrink-0 rounded border border-border bg-muted object-cover\"\n        />\n        <Text size=\"xs\" tone=\"subtle\" className=\"max-w-[10rem] truncate\">\n          {label}\n        </Text>\n      </span>\n    )\n  }\n  return (\n    <Badge variant=\"outline\">\n      <Image className=\"size-3\" /> {label}\n    </Badge>\n  )\n}\n\n/**\n * Normalize a relation value (single ref or array of refs) into an array of\n * `DocumentRef`s. EC-277: unwraps self-typed `{ type:'reference', ... }` envelopes\n * and legacy bare `{ collection, id }` via the shared tolerant reader.\n */\nexport function toRefArray(value: unknown): DocumentRef[] {\n  const list = Array.isArray(value) ? value : [value]\n  return list.map(readDocumentRef).filter((ref): ref is DocumentRef => ref !== undefined)\n}\n\nfunction stripHtml(html: string): string {\n  return html.replace(/<[^>]*>/g, ' ').replace(/\\s+/g, ' ').trim()\n}\n\n/**\n * EC-348 — a richText field's stored value is the rich-text envelope\n * (`{ version, doc }` TipTap JSON, EC-314), not an HTML string: `stripHtml`\n * alone here yielded the literal `[object Object]`. Fallback chain: a valid\n * envelope extracts to plain text (`richTextPlainText`); a legacy plain/HTML\n * string (pre-EC-314 content, or any other non-envelope string) still goes\n * through `stripHtml` as before; anything else (garbage, wrong field-type data)\n * yields `''` so the cell's placeholder shows — never a crash, never\n * `[object Object]`.\n */\nfunction richTextCellSummary(value: unknown): string {\n  const extracted = richTextPlainText(value)\n  if (extracted !== undefined) return extracted\n  return typeof value === 'string' ? stripHtml(value) : ''\n}\n"]}

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

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
-import type { CmsDocument, CmsValidationIssue, CollectionDef, CollectionRegistry, DocumentRef, FieldDef, Locale, LocaleConfig, LocalizedString, RestoreScope, ValidateDocumentOptions } from '@elytracms/core/cms-core';
-import type { DocumentVersionRecord } from '@elytracms/core/persistence';
-import type { OperationError } from '@elytracms/studio/lib/operations';
+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 { CommitOutcome, DocumentConflict, OperationError, OperationsClient } from '@elytracms/studio/lib/operations';
 import type { TableViewState } from '@elytracms/studio/lib/cms-views';
 import type { CellCommitInput, CellCommitOutcome } from './cell-edit.js';
 import type { BulkAction, BulkReport, BulkSetField } from './bulk-actions.js';
@@ -54,22 +54,59 @@ export interface CmsStore {
     getDocument(ref: DocumentRef): CmsDocument | undefined;
     /** Resolve a relation/asset target's display title. */
     titleOf(ref: DocumentRef): string;
-    saveDocument(doc: CmsDocument): void;
     /**
-     * Commit ONE field edit from the table (EC-168): optimistic session apply +
-     * exactly one `documents.upsert` operations command, awaited. Validation
-     * failures and operation rejections return a structured error (the caller
-     * renders it on the cell) and leave the session rolled back.
+     * EC-595 A2 — commit the patches a writer made to a document (the form's field
+     * paths, the canvas's node patches, an AI proposal's changes, …): the session's view
+     * updates at once and the patches persist through `documents.patch` against the
+     * revision the view was at. A refused path becomes a per-field conflict
+     * ({@link documentConflicts}); a failure, {@link persistError}. Resolves with the
+     * commit's outcome once acknowledged (fixture sessions: applied locally, at once).
+     */
+    commitPatches(ref: DocumentRef, patches: readonly DocumentPatch[], bases?: readonly (number | undefined)[]): Promise<CommitOutcome | undefined>;
+    /** EC-595 A2 — the revision the session's view of a document is at (the next patch's base). */
+    revisionOf(ref: DocumentRef): number | undefined;
+    /**
+     * EC-595 A2 / EC-578 — create a document from a whole value (duplicate, import of a
+     * new row, an AI create, a transfer, a reuse promote): insert-if-absent
+     * (`documents.replace` `{ ifAbsent: true }`), never an overwrite.
+     */
+    insertDocument(doc: CmsDocument): void;
+    /** EC-578 — a fresh document id from the session's injected id factory (UUIDs in the studio). */
+    newDocumentId(): string;
+    /**
+     * Commit ONE field edit from the table (EC-168): optimistic session apply + exactly
+     * one field patch through the persister's queue (EC-595 A2 — no longer a side
+     * channel past it), awaited. Validation failures and refusals return a structured
+     * error (the caller renders it on the cell).
      */
     commitFieldEdit(input: CellCommitInput): Promise<CellCommitOutcome>;
     createDocument(collectionId: string): DocumentRef;
     /**
-     * Ensure a singleton collection's lone document exists and return its ref
-     * (EC-274). Resolves the existing single document, or creates one with a normal
-     * generated id (never the collection id). Idempotent. The singleton route opens
-     * through this so the one document always exists to edit.
+     * Ensure a singleton collection's lone document exists (EC-274 → EC-595 A2): when the
+     * session holds none, `documents.create({ singleton: true })` — the store's
+     * `ifCollectionEmpty` precondition, so two sessions opening an empty singleton make
+     * ONE document; the loser adopts the winner's from the conflict. The singleton gate
+     * re-resolves once the document lands in the session.
+     */
+    ensureSingletonDocument(collectionId: string): void;
+    /** EC-595 A2 — the open per-field conflicts on a document ("changed by X — take theirs / keep mine"). */
+    documentConflicts(ref: DocumentRef): readonly DocumentConflict[];
+    /** EC-595 A2 — resolve one: `theirs` adopts the server value, `mine` re-sends at the current base. */
+    resolveConflict(ref: DocumentRef, conflictId: string, choice: 'theirs' | 'mine'): void;
+    /**
+     * EC-595 A2 (point 7) — adopt a row the open editor's document subscription pushed:
+     * applied under unflushed local edits, which win on their paths until flushed.
      */
-    ensureSingletonDocument(collectionId: string): DocumentRef;
+    adoptDocumentSnapshot(ref: DocumentRef, record: CmsDocumentRecord | undefined): void;
+    /** EC-595 point 7 — follow one open document (rows to the persister, presence to the caller). */
+    subscribeDocument(ref: DocumentRef, onPresence: (presence: readonly PresenceEntry[]) => void): () => void;
+    /** EC-595 thin presence — this tab's heartbeat on a document (the focused field's path). */
+    reportPresence(ref: DocumentRef, path: ValuePath | undefined): void;
+    clearPresence(ref: DocumentRef): void;
+    /** This tab's presence id. */
+    presenceSessionId: string;
+    /** Write a whole document at the session's revision (a document-level key — the alias). */
+    replaceDocument(doc: CmsDocument): void;
     deleteDocument(ref: DocumentRef): void;
     /**
      * Is this document currently published? Sourced from the version POINTER
@@ -105,10 +142,11 @@ export interface CmsStore {
      */
     documentHasUnpublishedChanges(ref: DocumentRef): boolean;
     /**
-     * Publish: snapshot the draft as a new version and pin it live (EC-224).
-     * Flips published-ness optimistically, then reconciles against the backend
-     * record (EC-225) so the badge can never claim a publish the backend refused
-     * (e.g. blocked by publish-time field validation).
+     * Publish: the ONE publish operation (EC-585) — it clears the draft's hidden values,
+     * validates, and pins a new version (EC-224). Flips published-ness optimistically,
+     * then reconciles against the backend record (EC-225) so the badge can never claim a
+     * publish the backend refused — and a refusal REJECTS (`PublishRefusedError`, after
+     * reporting it on the persist banner), so no caller shows success for it.
      */
     publishDocument(ref: DocumentRef): Promise<void>;
     /**
@@ -182,41 +220,37 @@ export interface CmsStore {
      */
     persistError: OperationError | null;
     clearPersistError(): void;
-    /** Seed the persisted baseline now (e.g. before applying an AI changeset). */
-    ensurePersistedBaseline(): Promise<void>;
-    /** Await all queued persisted mutations (tests, publish flows). */
-    flushPersistence(): Promise<void>;
+    /**
+     * Await every queued persisted write (of one document, or all) — the persistence half
+     * of the FORCED FLUSH (publish, duplicate, transfer, an AI proposal, unmount, tab hide).
+     */
+    flushPersistence(ref?: DocumentRef): Promise<void>;
 }
 declare const useCms: () => CmsStore;
 declare function primaryField(collection: CollectionDef): string;
 /**
- * EC-316 (bug fix) — mint a fresh, COLLISION-FREE document id for `+ New`.
- *
- * `seq` is an in-memory, per-session counter (reset to 0 on every reload). A
- * document minted `new-<collection>-<n>` in a PRIOR session can already occupy
- * whatever `n` this session's counter would next reissue — the pre-fix bug:
- * `+ New` on a `post` collection that already held a (possibly published)
- * `new-post-1` handed out that SAME id again, silently opening the existing
- * document for editing instead of creating a fresh draft. Walking the counter
- * past every id already in `existingIds` makes the mint collision-free
- * regardless of what a prior session left behind.
+ * Build a fresh document for `collectionId` (EC-297 / EC-578): an id from THE injected
+ * id factory — UUIDs in the studio, so two sessions can never mint the same id (the old
+ * per-session `new-<collection>-<n>` counter minted `new-post-1` in both, and the second
+ * create overwrote the first) — and the collection's declared field defaults
+ * (`seedDefaults`; a localized default lands in the project's default-locale bucket,
+ * EC-580). Pure — unit-testable without a `CmsProvider`.
  */
-export declare function mintDocumentId(collectionId: string, seq: {
-    current: number;
-}, existingIds: ReadonlySet<string>): string;
+export declare function buildNewDocument(collectionId: string, registry: CollectionRegistry, newId: IdFactory, locales: LocaleConfig): CmsDocument;
 /**
- * Build a fresh document for `collectionId`: a collision-free id (EC-316, via
- * {@link mintDocumentId} against every id `existingDocs` already holds for
- * this collection) and the collection's declared field defaults (EC-297, via
- * `seedDefaults` — a localized default lands in the project's default-locale
- * bucket, EC-580). Pure — the sensitive part of the insert sequence shared by
- * `createDocument` and `ensureSingletonDocument`'s empty branch (via the
- * private `insertNewDocument` below), factored out so it's unit-testable
- * without a `CmsProvider`.
+ * EC-274 → EC-595 A2 (critic correction 9) — a singleton's first document:
+ * `documents.create({ singleton: true })` (the store's `ifCollectionEmpty`
+ * precondition). The race loser's `conflict` carries the winner's row, which it ADOPTS
+ * — two sessions opening an empty singleton end up on ONE document. Exported for tests.
  */
-export declare function buildNewDocument(collectionId: string, registry: CollectionRegistry, seq: {
-    current: number;
-}, existingDocs: readonly CmsDocument[], locales: LocaleConfig): CmsDocument;
+export declare function createOrAdoptSingleton(operations: OperationsClient, projectId: string, collectionId: string, seeded: Pick<CmsDocument, 'values' | 'localized'>): Promise<{
+    ok: true;
+    record: CmsDocumentRecord;
+    adopted: boolean;
+} | {
+    ok: false;
+    error: OperationError;
+}>;
 /**
  * Does `docs` already hold a document for `collectionId`? `ensureSingletonDocument`'s
  * empty branch re-checks this INSIDE the `setDocuments` updater (against the
@@ -278,6 +312,14 @@ export interface CmsProviderProps {
      * returned records. Absent (playground / kit) → empty set.
      */
     initialChangedKeys?: readonly string[];
+    /**
+     * EC-595 A2 — each document's hydrated revision (`documentKey` → revision): the base
+     * the session's patches are made against (the persister's `track`). Absent (fixture
+     * sessions) → a document is read once before its first patch.
+     */
+    initialRevisions?: Record<string, number>;
+    /** EC-578 — the document-id factory. Defaults to UUIDs; fixtures inject a sequential one. */
+    idFactory?: IdFactory;
     /**
      * Locale config for this session — the PROJECT's own (config-declared locales,
      * or its persisted settings; see `resolveCmsInitialLocaleConfig`). Absent → the