@elytracms/studio 0.0.94 → 0.0.95

package/dist/components/cms/use-document-draft.d.ts

@@ -1,6 +1,9 @@
 import type { PresenceEntry } from '@elytracms/core/persistence';
 import type { CmsDocument, CollectionDef, DocumentPatch, FieldDef, Locale, PropFieldLookup, ValuePath } from '@elytracms/core/cms-core';
 import type { CollectionViewSource } from '../../lib/collection-view/collection-view-source.js';
+import type { CanvasFieldChange } from '../builder/canvas-rebase.js';
+import type { CommitPolicy } from './commit-policy.js';
+import type { CanvasControlPosition } from './canvas-commit.js';
 import type { Scheduler, UncommittedPosition } from './draft-commit.js';
 /**
  * EC-595 A2 — the detail editor's draft over the revisioned document (and, for the
@@ -10,7 +13,9 @@ import type { Scheduler, UncommittedPosition } from './draft-commit.js';
  * reads it); a field's edit is COMMITTED per its control kind's policy
  * ({@link commitPolicyOf} / {@link createDraftCommitter}) as the patch of the position it
  * wrote — never a document. The canvas commits each action's node patches at once
- * (`compositionPatches`). The draft REBASES whenever the session's document changes
+ * (`compositionPatches`); a burst of typing in one of its inspector controls is that
+ * control's uncommitted position, committed on its kind's policy like a form field
+ * (EC-630, `canvas-commit.ts`). The draft REBASES whenever the session's document changes
  * (a write result, a colleague's change by subscription, a resolved conflict): it is the
  * session's document with this editor's uncommitted positions laid over it — local wins
  * until committed, then the per-path check decides (EC-595 point 7).
@@ -42,6 +47,35 @@ export declare function positionPatch(doc: CmsDocument, path: ValuePath): Docume
  * over it, values from the editor's current draft.
  */
 export declare function rebaseDraft(sessionDoc: CmsDocument, draft: CmsDocument, uncommitted: readonly UncommittedPosition[]): CmsDocument;
+/**
+ * EC-630 — the canvas's write into the draft (pure). The canvas writer's node patches,
+ * keyed by node id, are the canvas's OWN delta: from `base`, the value it last agreed on
+ * with the draft, to `value` — never a document diff, and never measured against the
+ * draft's CURRENT value (a colleague's change that reached the draft a moment before the
+ * edit lifted would read as part of the edit, and its patches would revert it). The draft
+ * takes the delta over whatever it holds now (normally `base` itself) and canonicalises the
+ * field through the write lens. `undefined` when the canvas changed nothing.
+ */
+export declare function canvasWrite(input: {
+    collection: CollectionDef;
+    draft: CmsDocument;
+    field: string;
+    locale: Locale;
+    value: unknown;
+    base: unknown;
+    lookupManifest: PropFieldLookup;
+}): {
+    next: CmsDocument;
+    patches: DocumentPatch[];
+} | undefined;
+/**
+ * EC-630 — the change of the canvas field made UNDERNEATH the canvas when the draft
+ * rebased from `previous` to `next` (pure), numbered after `last`; `undefined` when the
+ * field did not move. The canvas's own edits are in both values (the session's view holds
+ * every patch it committed, the draft overlays every position it has not), so the change
+ * is someone else's: a colleague's patch, a write's canonical row, a resolved conflict.
+ */
+export declare function canvasFieldChange(previous: CmsDocument, next: CmsDocument, path: ValuePath, last: CanvasFieldChange | undefined): CanvasFieldChange | undefined;
 /**
  * The reader's "now" for presence liveness: THIS session's own latest heartbeat `at`
  * (written by the same store clock as everyone else's — the playground store runs a
@@ -61,22 +95,46 @@ export interface DocumentDraft {
     setFieldValue(field: FieldDef, value: unknown): void;
     /** A writer that transforms ONE field position (fill / reset from base). */
     editField(field: FieldDef, update: (draft: CmsDocument) => CmsDocument): void;
-    /** The canvas emitted a new value for its field (node patches, committed at once). */
-    setCanvasValue(field: FieldDef, value: unknown): void;
+    /**
+     * The canvas emitted a new value for its field (node patches, committed at once). `base`
+     * is the value the canvas last agreed on with the draft: the canvas writer's delta is
+     * `base` → `value`, applied over whatever the draft holds now (EC-630 — a change that
+     * landed underneath meanwhile is never reverted by the canvas's own write).
+     */
+    setCanvasValue(field: FieldDef, value: unknown, base: unknown): void;
     /** The slot alias (a document-level key: a whole-document write at the held revision). */
     setAlias(alias: string | undefined): void;
     /** Field boundary events (focus / blur / Enter) — the commit policy's triggers. */
     focused(field: FieldDef): void;
     blurred(field: FieldDef): void;
     entered(field: FieldDef): void;
+    /**
+     * EC-630 — the canvas inspector's boundary events: a control writing `position` of the
+     * canvas field `field`, committing on `policy` (THE declaration for its kind). A burst of
+     * typing in it is its uncommitted position until blur / Enter / the idle pause.
+     */
+    canvasFocused(field: FieldDef, position: CanvasControlPosition, policy: CommitPolicy): void;
+    canvasBlurred(field: FieldDef, position: CanvasControlPosition): void;
+    canvasEntered(field: FieldDef, position: CanvasControlPosition): void;
     /** The forced commit (sync; the persister serialises what follows) / the record model's Save. */
     save(): void;
     /** The FORCED FLUSH: commit everything uncommitted and await persistence. */
     flush(): Promise<void>;
     /** Adopt a draft from outside (a restored version). */
     replaceDraft(next: CmsDocument): void;
-    /** Bumped when the canvas must remount from the draft (a restore, a colleague's change). */
+    /**
+     * Bumped when the canvas must remount from the draft: a restored version replaced the
+     * document, or a locale switch pointed the canvas at another bucket. (A change made
+     * underneath the canvas is NOT a remount — {@link canvasChange}.)
+     */
     canvasNonce: number;
+    /**
+     * EC-630 — the latest change of the canvas field's value made UNDERNEATH the canvas (a
+     * colleague's patch by subscription, a write's canonical row, a resolved conflict): the
+     * draft's value before and after it. The canvas REBASES onto it — the change lands, its
+     * undo history and selection survive — where it used to remount and lose both.
+     */
+    canvasChange: CanvasFieldChange | undefined;
     /** The OTHER sessions present on this document, live by the reader's clock. */
     presence: readonly PresenceEntry[];
 }

package/dist/components/cms/use-document-draft.js

@@ -4,6 +4,7 @@ import { applyDocumentPatches, formatValuePath, readValueAt, semanticValueEqual,
 import { fieldPositionPath } from '../../lib/cms/field-patch.js';
 import { compositionPatches } from '../builder/composition-patches.js';
 import { commitPolicyOf } from './commit-policy.js';
+import { canvasControl, routeCanvasWrite } from './canvas-commit.js';
 import { browserScheduler, createDraftCommitter } from './draft-commit.js';
 /**
  * EC-595 A2 — the detail editor's draft over the revisioned document (and, for the
@@ -13,7 +14,9 @@ import { browserScheduler, createDraftCommitter } from './draft-commit.js';
  * reads it); a field's edit is COMMITTED per its control kind's policy
  * ({@link commitPolicyOf} / {@link createDraftCommitter}) as the patch of the position it
  * wrote — never a document. The canvas commits each action's node patches at once
- * (`compositionPatches`). The draft REBASES whenever the session's document changes
+ * (`compositionPatches`); a burst of typing in one of its inspector controls is that
+ * control's uncommitted position, committed on its kind's policy like a form field
+ * (EC-630, `canvas-commit.ts`). The draft REBASES whenever the session's document changes
  * (a write result, a colleague's change by subscription, a resolved conflict): it is the
  * session's document with this editor's uncommitted positions laid over it — local wins
  * until committed, then the per-path check decides (EC-595 point 7).
@@ -59,6 +62,37 @@ export function rebaseDraft(sessionDoc, draft, uncommitted) {
     const patches = uncommitted.map((position) => positionPatch(draft, position.path));
     return applyDocumentPatches({ document: sessionDoc, patches, since: [] }).document;
 }
+/**
+ * EC-630 — the canvas's write into the draft (pure). The canvas writer's node patches,
+ * keyed by node id, are the canvas's OWN delta: from `base`, the value it last agreed on
+ * with the draft, to `value` — never a document diff, and never measured against the
+ * draft's CURRENT value (a colleague's change that reached the draft a moment before the
+ * edit lifted would read as part of the edit, and its patches would revert it). The draft
+ * takes the delta over whatever it holds now (normally `base` itself) and canonicalises the
+ * field through the write lens. `undefined` when the canvas changed nothing.
+ */
+export function canvasWrite(input) {
+    const { collection, draft, field, locale, lookupManifest } = input;
+    const path = fieldPositionPath(collection, field, locale);
+    const localized = path.length > 1 ? locale : undefined;
+    const patches = compositionPatches(input.base, input.value, field, localized);
+    if (patches.length === 0)
+        return undefined;
+    const applied = applyDocumentPatches({ document: draft, patches, since: [] }).document;
+    return { next: writeField(collection, draft, field, locale, readValueAt(applied, path), { lookupManifest }), patches };
+}
+/**
+ * EC-630 — the change of the canvas field made UNDERNEATH the canvas when the draft
+ * rebased from `previous` to `next` (pure), numbered after `last`; `undefined` when the
+ * field did not move. The canvas's own edits are in both values (the session's view holds
+ * every patch it committed, the draft overlays every position it has not), so the change
+ * is someone else's: a colleague's patch, a write's canonical row, a resolved conflict.
+ */
+export function canvasFieldChange(previous, next, path, last) {
+    const from = readValueAt(previous, path);
+    const to = readValueAt(next, path);
+    return semanticValueEqual(from, to) ? undefined : { from, to, seq: (last?.seq ?? 0) + 1 };
+}
 /**
  * The reader's "now" for presence liveness: THIS session's own latest heartbeat `at`
  * (written by the same store clock as everyone else's — the playground store runs a
@@ -102,10 +136,14 @@ export function useDocumentDraft(input) {
     // --- Committing --------------------------------------------------------------------
     const writesRef = useRef(documentModel);
     writesRef.current = documentModel;
+    /** EC-630 — the canvas inspector controls that took focus, by committer key (their position + policy). */
+    const canvasControls = useRef(new Map());
     const committer = useMemo(() => createDraftCommitter({
         policyOf: (name) => {
             const field = fieldsByName.get(name);
-            return field ? commitPolicyOf(field) : 'blur-or-idle';
+            if (field)
+                return commitPolicyOf(field);
+            return canvasControls.current.get(name)?.policy ?? 'blur-or-idle';
         },
         commit: (positions) => {
             const target = writesRef.current;
@@ -118,29 +156,17 @@ export function useDocumentDraft(input) {
     }), 
     // One committer per open document (the editor is keyed by it).
     [ref]);
-    // --- The canvas's value and its remount ---------------------------------------------
+    // --- The canvas's value: its remount and its rebase ------------------------------------
     const canvasPath = canvasField ? fieldPositionPath(collection, canvasField.name, locale) : undefined;
     const canvasPathKey = canvasPath ? formatValuePath(canvasPath) : '';
-    const canvasValueRef = useRef(canvasPath ? readValueAt(draft, canvasPath) : undefined);
     const [canvasNonce, setCanvasNonce] = useState(0);
-    const syncCanvas = useCallback((next) => {
-        if (!canvasPath)
-            return;
-        const value = readValueAt(next, canvasPath);
-        if (semanticValueEqual(value, canvasValueRef.current))
-            return;
-        canvasValueRef.current = value;
-        setCanvasNonce((n) => n + 1);
-    }, 
-    // The path is keyed by its string form.
-    [canvasPathKey]);
+    const [canvasChange, setCanvasChange] = useState(undefined);
     // A locale switch points the canvas at another bucket: remount from it.
     const lastCanvasPathKey = useRef(canvasPathKey);
     useEffect(() => {
         if (lastCanvasPathKey.current === canvasPathKey)
             return;
         lastCanvasPathKey.current = canvasPathKey;
-        canvasValueRef.current = canvasPath ? readValueAt(draftRef.current, canvasPath) : undefined;
         setCanvasNonce((n) => n + 1);
     }, [canvasPathKey]);
     // --- The rebase (document model) -------------------------------------------------------
@@ -152,9 +178,15 @@ export function useDocumentDraft(input) {
         }
         if (!documentModel)
             return;
-        const next = rebaseDraft(doc, draftRef.current, committer.uncommitted());
+        const previous = draftRef.current;
+        const next = rebaseDraft(doc, previous, committer.uncommitted());
         setDraft(next);
-        syncCanvas(next);
+        // EC-630: the canvas field moved underneath the canvas — the canvas rebases onto the
+        // change (its own edits are in both values: the session's view holds every patch it
+        // committed, and the draft overlays every position it has not).
+        if (!canvasPath)
+            return;
+        setCanvasChange((last) => canvasFieldChange(previous, next, canvasPath, last) ?? last);
     }, [doc]);
     // --- Writers ----------------------------------------------------------------------------
     const setFieldValue = useCallback((field, value) => {
@@ -168,20 +200,23 @@ export function useDocumentDraft(input) {
         if (documentModel)
             committer.edited(field.name, fieldPositionPath(collection, field.name, locale));
     }, [collection, locale, setDraft, documentModel, committer]);
-    const setCanvasValue = useCallback((field, value) => {
-        const path = fieldPositionPath(collection, field.name, locale);
-        const before = readValueAt(draftRef.current, path);
-        const next = writeField(collection, draftRef.current, field.name, locale, value, { lookupManifest });
-        const after = readValueAt(next, path);
-        setDraft(next);
-        canvasValueRef.current = after;
+    const setCanvasValue = useCallback((field, value, base) => {
+        const write = canvasWrite({ collection, draft: draftRef.current, field: field.name, locale, value, base, lookupManifest });
+        if (!write)
+            return;
+        setDraft(write.next);
         if (!documentModel)
             return;
-        // The canvas writer's node patches, keyed by node id (computed here, in its write
-        // path, from the canonical values before and after the action — never a document diff).
-        const localized = path.length > 1 ? locale : undefined;
-        void documentModel.commit(ref, compositionPatches(before, after, field.name, localized));
-    }, [collection, locale, lookupManifest, setDraft, documentModel, ref]);
+        // EC-630: a burst of typing in a focused inspector control is that control's
+        // uncommitted position (its policy commits it); a canvas action commits now.
+        const focus = committer.focusedField();
+        routeCanvasWrite({
+            patches: write.patches,
+            focused: focus === undefined ? undefined : canvasControls.current.get(focus),
+            committer,
+            commitNow: (patches) => void documentModel.commit(ref, patches),
+        });
+    }, [collection, locale, lookupManifest, setDraft, documentModel, ref, committer]);
     const setAlias = useCallback((alias) => {
         const next = { ...draftRef.current };
         if (alias === undefined)
@@ -271,10 +306,41 @@ export function useDocumentDraft(input) {
         if (documentModel)
             committer.entered(field.name);
     }, [documentModel, committer]);
+    // EC-630 — the canvas inspector's commit boundary: a control at a position of the canvas
+    // field gained focus, lost it, or saw Enter. Its policy is THE declaration's for its kind.
+    const canvasControlOf = useCallback((field, position, policy) => canvasControl(fieldPositionPath(collection, field.name, locale), position, policy), [collection, locale]);
+    const canvasFocused = useCallback((field, position, policy) => {
+        if (!documentModel)
+            return;
+        const control = canvasControlOf(field, position, policy);
+        canvasControls.current.set(control.key, control);
+        committer.focused(control.key);
+        focusedPathRef.current = control.path;
+        heartbeat();
+    }, [documentModel, committer, canvasControlOf, heartbeat]);
+    const canvasBlurred = useCallback((field, position) => {
+        if (!documentModel)
+            return;
+        const key = canvasControlOf(field, position, 'change').key;
+        committer.blurred(key);
+        canvasControls.current.delete(key);
+        focusedPathRef.current = undefined;
+        heartbeat();
+    }, [documentModel, committer, canvasControlOf, heartbeat]);
+    const canvasEntered = useCallback((field, position) => {
+        if (documentModel)
+            committer.entered(canvasControlOf(field, position, 'change').key);
+    }, [documentModel, committer, canvasControlOf]);
     const replaceDraft = useCallback((next) => {
+        // A restored version replaces the document: when it moved the canvas field, the
+        // canvas remounts from it (its history belonged to the replaced value).
+        const moved = canvasPath && !semanticValueEqual(readValueAt(draftRef.current, canvasPath), readValueAt(next, canvasPath));
         setDraft(next);
-        syncCanvas(next);
-    }, [setDraft, syncCanvas]);
+        if (moved)
+            setCanvasNonce((n) => n + 1);
+    }, 
+    // The path is keyed by its string form.
+    [setDraft, canvasPathKey]);
     const dirty = useMemo(() => !semanticValueEqual(draft, doc), [draft, doc]);
     return {
         draft,
@@ -287,10 +353,14 @@ export function useDocumentDraft(input) {
         focused,
         blurred,
         entered,
+        canvasFocused,
+        canvasBlurred,
+        canvasEntered,
         save,
         flush,
         replaceDraft,
         canvasNonce,
+        canvasChange,
         presence,
     };
 }

package/dist/components/cms/use-document-draft.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-document-draft.js","sourceRoot":"","sources":["../../../src/components/cms/use-document-draft.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  PRESENCE_TTL_MS,\n  livePresence,\n} from '@elytracms/core/persistence'\nimport type { PresenceEntry } from '@elytracms/core/persistence'\nimport {\n  applyDocumentPatches,\n  formatValuePath,\n  readValueAt,\n  semanticValueEqual,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentPatch,\n  DocumentRef,\n  FieldDef,\n  Locale,\n  PropFieldLookup,\n  ValuePath,\n} from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '../../lib/collection-view/collection-view-source'\nimport { fieldPositionPath } from '../../lib/cms/field-patch'\nimport { compositionPatches } from '../builder/composition-patches'\nimport { commitPolicyOf } from './commit-policy'\nimport { browserScheduler, createDraftCommitter } from './draft-commit'\nimport type { DraftCommitter, Scheduler, UncommittedPosition } from './draft-commit'\n\n/**\n * EC-595 A2 — the detail editor's draft over the revisioned document (and, for the\n * explicit-save rails, over a record).\n *\n * **Document write model** (the CMS): the draft changes per keystroke (live validation\n * reads it); a field's edit is COMMITTED per its control kind's policy\n * ({@link commitPolicyOf} / {@link createDraftCommitter}) as the patch of the position it\n * wrote — never a document. The canvas commits each action's node patches at once\n * (`compositionPatches`). The draft REBASES whenever the session's document changes\n * (a write result, a colleague's change by subscription, a resolved conflict): it is the\n * session's document with this editor's uncommitted positions laid over it — local wins\n * until committed, then the per-path check decides (EC-595 point 7).\n *\n * **Forced flushes** (the ruling: before unmount, tab hide, publish, preview, an AI\n * proposal, duplicate, transfer): {@link DocumentDraft.flush} commits every uncommitted\n * position and awaits the persister. Unmount and tab hide run it here; the editor's\n * publish, duplicate and the AI tap call it.\n *\n * **Thin presence** (Stage A): a heartbeat naming the focused field's path on focus\n * change and every {@link PRESENCE_HEARTBEAT_MS} (under the 30 s TTL), cleared on\n * unmount; the other sessions' live heartbeats arrive with the subscription.\n *\n * **Record write model** (users, redirects, assets, the account): the draft is edited\n * in place and written whole on the editor's Save button (EC-240) — unchanged.\n */\n\n/** The presence heartbeat interval — under {@link PRESENCE_TTL_MS} so a present editor never lapses. */\nexport const PRESENCE_HEARTBEAT_MS = 10_000\n\n/** An injectable visibility source (the tab-hide flush; tests drive it). */\nexport interface VisibilitySource {\n  /** Call `onHidden` whenever the tab becomes hidden; returns the unsubscribe. */\n  onHidden(onHidden: () => void): () => void\n}\n\nexport const documentVisibility: VisibilitySource = {\n  onHidden(onHidden) {\n    if (typeof document === 'undefined') return () => {}\n    const listener = () => {\n      if (document.visibilityState === 'hidden') onHidden()\n    }\n    document.addEventListener('visibilitychange', listener)\n    return () => document.removeEventListener('visibilitychange', listener)\n  },\n}\n\n/** The patch that writes the value `doc` holds at `path` (unset when absent). */\nexport function positionPatch(doc: CmsDocument, path: ValuePath): DocumentPatch {\n  const value = readValueAt(doc, path)\n  return value === undefined ? { op: 'unset', path } : { op: 'set', path, value }\n}\n\n/**\n * THE rebase (pure): the session's document with the editor's uncommitted positions laid\n * over it, values from the editor's current draft.\n */\nexport function rebaseDraft(\n  sessionDoc: CmsDocument,\n  draft: CmsDocument,\n  uncommitted: readonly UncommittedPosition[],\n): CmsDocument {\n  if (uncommitted.length === 0) return sessionDoc\n  const patches = uncommitted.map((position) => positionPatch(draft, position.path))\n  return applyDocumentPatches({ document: sessionDoc, patches, since: [] }).document\n}\n\n/**\n * The reader's \"now\" for presence liveness: THIS session's own latest heartbeat `at`\n * (written by the same store clock as everyone else's — the playground store runs a\n * deterministic sequential clock, Convex the writers' wall clocks), falling back to the\n * injected clock before the first heartbeat lands. Comparing others' `at` against a\n * different time base would call every colleague stale (measured live in the\n * playground: the store's clock is months behind the browser's).\n */\nexport function presenceReaderNow(\n  entries: readonly PresenceEntry[],\n  sessionId: string,\n  fallback: string,\n): string {\n  const own = entries.filter((entry) => entry.sessionId === sessionId).map((entry) => entry.at)\n  return own.length > 0 ? own.sort().at(-1)! : fallback\n}\n\nexport interface DocumentDraft {\n  draft: CmsDocument\n  /** Uncommitted (document model) / unsaved (record model) edits exist. */\n  dirty: boolean\n  /** The record model: the editor renders a Save button + navigation guard. */\n  explicitSave: boolean\n  /** A field's control wrote `value` (the active locale for a localized field). */\n  setFieldValue(field: FieldDef, value: unknown): void\n  /** A writer that transforms ONE field position (fill / reset from base). */\n  editField(field: FieldDef, update: (draft: CmsDocument) => CmsDocument): void\n  /** The canvas emitted a new value for its field (node patches, committed at once). */\n  setCanvasValue(field: FieldDef, value: unknown): void\n  /** The slot alias (a document-level key: a whole-document write at the held revision). */\n  setAlias(alias: string | undefined): void\n  /** Field boundary events (focus / blur / Enter) — the commit policy's triggers. */\n  focused(field: FieldDef): void\n  blurred(field: FieldDef): void\n  entered(field: FieldDef): void\n  /** The forced commit (sync; the persister serialises what follows) / the record model's Save. */\n  save(): void\n  /** The FORCED FLUSH: commit everything uncommitted and await persistence. */\n  flush(): Promise<void>\n  /** Adopt a draft from outside (a restored version). */\n  replaceDraft(next: CmsDocument): void\n  /** Bumped when the canvas must remount from the draft (a restore, a colleague's change). */\n  canvasNonce: number\n  /** The OTHER sessions present on this document, live by the reader's clock. */\n  presence: readonly PresenceEntry[]\n}\n\nexport interface UseDocumentDraftInput {\n  source: CollectionViewSource\n  collection: CollectionDef\n  doc: CmsDocument\n  locale: Locale\n  lookupManifest: PropFieldLookup\n  /** The composition field the canvas edits on this screen, if any. */\n  canvasField?: FieldDef\n  scheduler?: Scheduler\n  visibility?: VisibilitySource\n  /** The reader's clock for presence liveness (ISO); `new Date().toISOString()` by default. */\n  now?: () => string\n}\n\n/**\n * EC-616 — the base a record save is diffed against: the source's value whenever the draft\n * equals it (the record as opened, or as a save came back), else the previous base (the\n * editor has unsaved changes; a change from another writer meanwhile is not theirs). Pure.\n */\nexport function recordSaveBase(previous: CmsDocument, draft: CmsDocument, doc: CmsDocument): CmsDocument {\n  return semanticValueEqual(draft, doc) ? doc : previous\n}\n\nexport function useDocumentDraft(input: UseDocumentDraftInput): DocumentDraft {\n  const { source, collection, doc, locale, lookupManifest, canvasField } = input\n  const writes = source.writes\n  const documentModel = writes.kind === 'document' ? writes : undefined\n  const ref: DocumentRef = useMemo(() => ({ collection: doc.collection, id: doc.id }), [doc.collection, doc.id])\n  const [draft, setDraftState] = useState<CmsDocument>(doc)\n  const draftRef = useRef(draft)\n  // EC-616: the record as the editor opened it (or as of their last successful save) — the\n  // BASE a record rail diffs a save against, so it writes only the editor's changes. It moves\n  // only while the draft equals the source's value (at open, and once a save is reflected\n  // back): another writer's change arriving mid-edit never becomes the editor's base.\n  const baseRef = useRef<CmsDocument>(doc)\n  baseRef.current = recordSaveBase(baseRef.current, draftRef.current, doc)\n  const setDraft = useCallback((next: CmsDocument) => {\n    draftRef.current = next\n    setDraftState(next)\n  }, [])\n  const scheduler = input.scheduler ?? browserScheduler\n  const now = input.now ?? (() => new Date().toISOString())\n  const fieldsByName = useMemo(() => new Map(collection.fields.map((f) => [f.name, f])), [collection])\n\n  // --- Committing --------------------------------------------------------------------\n  const writesRef = useRef(documentModel)\n  writesRef.current = documentModel\n  const committer = useMemo<DraftCommitter>(\n    () =>\n      createDraftCommitter({\n        policyOf: (name) => {\n          const field = fieldsByName.get(name)\n          return field ? commitPolicyOf(field) : 'blur-or-idle'\n        },\n        commit: (positions) => {\n          const target = writesRef.current\n          if (!target) return\n          void target.commit(\n            ref,\n            positions.map((position) => positionPatch(draftRef.current, position.path)),\n            positions.map((position) => position.base),\n          )\n        },\n        baseOf: () => writesRef.current?.revisionOf(ref),\n        scheduler,\n      }),\n    // One committer per open document (the editor is keyed by it).\n    [ref],\n  )\n\n  // --- The canvas's value and its remount ---------------------------------------------\n  const canvasPath = canvasField ? fieldPositionPath(collection, canvasField.name, locale) : undefined\n  const canvasPathKey = canvasPath ? formatValuePath(canvasPath) : ''\n  const canvasValueRef = useRef<unknown>(canvasPath ? readValueAt(draft, canvasPath) : undefined)\n  const [canvasNonce, setCanvasNonce] = useState(0)\n  const syncCanvas = useCallback(\n    (next: CmsDocument) => {\n      if (!canvasPath) return\n      const value = readValueAt(next, canvasPath)\n      if (semanticValueEqual(value, canvasValueRef.current)) return\n      canvasValueRef.current = value\n      setCanvasNonce((n) => n + 1)\n    },\n    // The path is keyed by its string form.\n    [canvasPathKey],\n  )\n  // A locale switch points the canvas at another bucket: remount from it.\n  const lastCanvasPathKey = useRef(canvasPathKey)\n  useEffect(() => {\n    if (lastCanvasPathKey.current === canvasPathKey) return\n    lastCanvasPathKey.current = canvasPathKey\n    canvasValueRef.current = canvasPath ? readValueAt(draftRef.current, canvasPath) : undefined\n    setCanvasNonce((n) => n + 1)\n  }, [canvasPathKey])\n\n  // --- The rebase (document model) -------------------------------------------------------\n  const firstDoc = useRef(true)\n  useEffect(() => {\n    if (firstDoc.current) {\n      firstDoc.current = false\n      return\n    }\n    if (!documentModel) return\n    const next = rebaseDraft(doc, draftRef.current, committer.uncommitted())\n    setDraft(next)\n    syncCanvas(next)\n  }, [doc])\n\n  // --- Writers ----------------------------------------------------------------------------\n  const setFieldValue = useCallback(\n    (field: FieldDef, value: unknown) => {\n      const next = writeField(collection, draftRef.current, field.name, locale, value, { lookupManifest })\n      setDraft(next)\n      if (documentModel) committer.edited(field.name, fieldPositionPath(collection, field.name, locale))\n    },\n    [collection, locale, lookupManifest, setDraft, documentModel, committer],\n  )\n  const editField = useCallback(\n    (field: FieldDef, update: (current: CmsDocument) => CmsDocument) => {\n      setDraft(update(draftRef.current))\n      if (documentModel) committer.edited(field.name, fieldPositionPath(collection, field.name, locale))\n    },\n    [collection, locale, setDraft, documentModel, committer],\n  )\n  const setCanvasValue = useCallback(\n    (field: FieldDef, value: unknown) => {\n      const path = fieldPositionPath(collection, field.name, locale)\n      const before = readValueAt(draftRef.current, path)\n      const next = writeField(collection, draftRef.current, field.name, locale, value, { lookupManifest })\n      const after = readValueAt(next, path)\n      setDraft(next)\n      canvasValueRef.current = after\n      if (!documentModel) return\n      // The canvas writer's node patches, keyed by node id (computed here, in its write\n      // path, from the canonical values before and after the action — never a document diff).\n      const localized = path.length > 1 ? locale : undefined\n      void documentModel.commit(ref, compositionPatches(before, after, field.name, localized))\n    },\n    [collection, locale, lookupManifest, setDraft, documentModel, ref],\n  )\n  const setAlias = useCallback(\n    (alias: string | undefined) => {\n      const next = { ...draftRef.current }\n      if (alias === undefined) delete next.alias\n      else next.alias = alias\n      setDraft(next)\n      if (!documentModel) return\n      committer.commitAll()\n      documentModel.replace(next)\n    },\n    [setDraft, documentModel, committer],\n  )\n\n  // --- Forced flush ----------------------------------------------------------------------\n  const save = useCallback(() => {\n    if (documentModel) committer.commitAll()\n    else if (writes.kind === 'record') writes.save(draftRef.current, baseRef.current)\n  }, [documentModel, committer, writes])\n  const flush = useCallback(async () => {\n    save()\n    if (documentModel) await documentModel.flush(ref)\n  }, [save, documentModel, ref])\n\n  // Tab hide: commit and flush. Unmount: the same, and leave the document.\n  const visibility = input.visibility ?? documentVisibility\n  useEffect(() => {\n    if (!documentModel) return\n    return visibility.onHidden(() => {\n      committer.commitAll()\n      void documentModel.flush(ref)\n    })\n  }, [ref])\n  useEffect(\n    () => () => {\n      const target = writesRef.current\n      if (!target) return\n      committer.commitAll()\n      committer.dispose()\n      void target.flush(ref)\n      target.clearPresence(ref)\n    },\n    [ref],\n  )\n\n  // --- Subscription + presence ------------------------------------------------------------\n  const [presenceEntries, setPresenceEntries] = useState<readonly PresenceEntry[]>([])\n  const [clock, setClock] = useState(now)\n  useEffect(() => {\n    if (!documentModel) return\n    return documentModel.subscribe(ref, setPresenceEntries)\n  }, [ref])\n  const focusedPathRef = useRef<ValuePath | undefined>(undefined)\n  const heartbeat = useCallback(() => {\n    writesRef.current?.reportPresence(ref, focusedPathRef.current)\n    setClock(now())\n  }, [ref])\n  useEffect(() => {\n    if (!documentModel) return\n    heartbeat()\n    let handle: unknown\n    const tick = () => {\n      heartbeat()\n      handle = scheduler.setTimeout(tick, PRESENCE_HEARTBEAT_MS)\n    }\n    handle = scheduler.setTimeout(tick, PRESENCE_HEARTBEAT_MS)\n    return () => scheduler.clearTimeout(handle)\n  }, [ref])\n  const presence = useMemo(\n    () =>\n      documentModel\n        ? livePresence(\n            presenceEntries,\n            presenceReaderNow(presenceEntries, documentModel.presenceSessionId, clock),\n            PRESENCE_TTL_MS,\n          ).filter((entry) => entry.sessionId !== documentModel.presenceSessionId)\n        : [],\n    [presenceEntries, clock, documentModel],\n  )\n\n  const focused = useCallback(\n    (field: FieldDef) => {\n      if (!documentModel) return\n      committer.focused(field.name)\n      focusedPathRef.current = fieldPositionPath(collection, field.name, locale)\n      heartbeat()\n    },\n    [documentModel, committer, collection, locale, heartbeat],\n  )\n  const blurred = useCallback(\n    (field: FieldDef) => {\n      if (!documentModel) return\n      committer.blurred(field.name)\n      focusedPathRef.current = undefined\n      heartbeat()\n    },\n    [documentModel, committer, heartbeat],\n  )\n  const entered = useCallback(\n    (field: FieldDef) => {\n      if (documentModel) committer.entered(field.name)\n    },\n    [documentModel, committer],\n  )\n\n  const replaceDraft = useCallback(\n    (next: CmsDocument) => {\n      setDraft(next)\n      syncCanvas(next)\n    },\n    [setDraft, syncCanvas],\n  )\n\n  const dirty = useMemo(() => !semanticValueEqual(draft, doc), [draft, doc])\n\n  return {\n    draft,\n    dirty,\n    explicitSave: writes.kind === 'record',\n    setFieldValue,\n    editField,\n    setCanvasValue,\n    setAlias,\n    focused,\n    blurred,\n    entered,\n    save,\n    flush,\n    replaceDraft,\n    canvasNonce,\n    presence,\n  }\n}\n"]}
+{"version":3,"file":"use-document-draft.js","sourceRoot":"","sources":["../../../src/components/cms/use-document-draft.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  PRESENCE_TTL_MS,\n  livePresence,\n} from '@elytracms/core/persistence'\nimport type { PresenceEntry } from '@elytracms/core/persistence'\nimport {\n  applyDocumentPatches,\n  formatValuePath,\n  readValueAt,\n  semanticValueEqual,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentPatch,\n  DocumentRef,\n  FieldDef,\n  Locale,\n  PropFieldLookup,\n  ValuePath,\n} from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '../../lib/collection-view/collection-view-source'\nimport { fieldPositionPath } from '../../lib/cms/field-patch'\nimport { compositionPatches } from '../builder/composition-patches'\nimport type { CanvasFieldChange } from '../builder/canvas-rebase'\nimport { commitPolicyOf } from './commit-policy'\nimport type { CommitPolicy } from './commit-policy'\nimport { canvasControl, routeCanvasWrite } from './canvas-commit'\nimport type { CanvasControl, CanvasControlPosition } from './canvas-commit'\nimport { browserScheduler, createDraftCommitter } from './draft-commit'\nimport type { DraftCommitter, Scheduler, UncommittedPosition } from './draft-commit'\n\n/**\n * EC-595 A2 — the detail editor's draft over the revisioned document (and, for the\n * explicit-save rails, over a record).\n *\n * **Document write model** (the CMS): the draft changes per keystroke (live validation\n * reads it); a field's edit is COMMITTED per its control kind's policy\n * ({@link commitPolicyOf} / {@link createDraftCommitter}) as the patch of the position it\n * wrote — never a document. The canvas commits each action's node patches at once\n * (`compositionPatches`); a burst of typing in one of its inspector controls is that\n * control's uncommitted position, committed on its kind's policy like a form field\n * (EC-630, `canvas-commit.ts`). The draft REBASES whenever the session's document changes\n * (a write result, a colleague's change by subscription, a resolved conflict): it is the\n * session's document with this editor's uncommitted positions laid over it — local wins\n * until committed, then the per-path check decides (EC-595 point 7).\n *\n * **Forced flushes** (the ruling: before unmount, tab hide, publish, preview, an AI\n * proposal, duplicate, transfer): {@link DocumentDraft.flush} commits every uncommitted\n * position and awaits the persister. Unmount and tab hide run it here; the editor's\n * publish, duplicate and the AI tap call it.\n *\n * **Thin presence** (Stage A): a heartbeat naming the focused field's path on focus\n * change and every {@link PRESENCE_HEARTBEAT_MS} (under the 30 s TTL), cleared on\n * unmount; the other sessions' live heartbeats arrive with the subscription.\n *\n * **Record write model** (users, redirects, assets, the account): the draft is edited\n * in place and written whole on the editor's Save button (EC-240) — unchanged.\n */\n\n/** The presence heartbeat interval — under {@link PRESENCE_TTL_MS} so a present editor never lapses. */\nexport const PRESENCE_HEARTBEAT_MS = 10_000\n\n/** An injectable visibility source (the tab-hide flush; tests drive it). */\nexport interface VisibilitySource {\n  /** Call `onHidden` whenever the tab becomes hidden; returns the unsubscribe. */\n  onHidden(onHidden: () => void): () => void\n}\n\nexport const documentVisibility: VisibilitySource = {\n  onHidden(onHidden) {\n    if (typeof document === 'undefined') return () => {}\n    const listener = () => {\n      if (document.visibilityState === 'hidden') onHidden()\n    }\n    document.addEventListener('visibilitychange', listener)\n    return () => document.removeEventListener('visibilitychange', listener)\n  },\n}\n\n/** The patch that writes the value `doc` holds at `path` (unset when absent). */\nexport function positionPatch(doc: CmsDocument, path: ValuePath): DocumentPatch {\n  const value = readValueAt(doc, path)\n  return value === undefined ? { op: 'unset', path } : { op: 'set', path, value }\n}\n\n/**\n * THE rebase (pure): the session's document with the editor's uncommitted positions laid\n * over it, values from the editor's current draft.\n */\nexport function rebaseDraft(\n  sessionDoc: CmsDocument,\n  draft: CmsDocument,\n  uncommitted: readonly UncommittedPosition[],\n): CmsDocument {\n  if (uncommitted.length === 0) return sessionDoc\n  const patches = uncommitted.map((position) => positionPatch(draft, position.path))\n  return applyDocumentPatches({ document: sessionDoc, patches, since: [] }).document\n}\n\n/**\n * EC-630 — the canvas's write into the draft (pure). The canvas writer's node patches,\n * keyed by node id, are the canvas's OWN delta: from `base`, the value it last agreed on\n * with the draft, to `value` — never a document diff, and never measured against the\n * draft's CURRENT value (a colleague's change that reached the draft a moment before the\n * edit lifted would read as part of the edit, and its patches would revert it). The draft\n * takes the delta over whatever it holds now (normally `base` itself) and canonicalises the\n * field through the write lens. `undefined` when the canvas changed nothing.\n */\nexport function canvasWrite(input: {\n  collection: CollectionDef\n  draft: CmsDocument\n  field: string\n  locale: Locale\n  value: unknown\n  base: unknown\n  lookupManifest: PropFieldLookup\n}): { next: CmsDocument; patches: DocumentPatch[] } | undefined {\n  const { collection, draft, field, locale, lookupManifest } = input\n  const path = fieldPositionPath(collection, field, locale)\n  const localized = path.length > 1 ? locale : undefined\n  const patches = compositionPatches(input.base, input.value, field, localized)\n  if (patches.length === 0) return undefined\n  const applied = applyDocumentPatches({ document: draft, patches, since: [] }).document\n  return { next: writeField(collection, draft, field, locale, readValueAt(applied, path), { lookupManifest }), patches }\n}\n\n/**\n * EC-630 — the change of the canvas field made UNDERNEATH the canvas when the draft\n * rebased from `previous` to `next` (pure), numbered after `last`; `undefined` when the\n * field did not move. The canvas's own edits are in both values (the session's view holds\n * every patch it committed, the draft overlays every position it has not), so the change\n * is someone else's: a colleague's patch, a write's canonical row, a resolved conflict.\n */\nexport function canvasFieldChange(\n  previous: CmsDocument,\n  next: CmsDocument,\n  path: ValuePath,\n  last: CanvasFieldChange | undefined,\n): CanvasFieldChange | undefined {\n  const from = readValueAt(previous, path)\n  const to = readValueAt(next, path)\n  return semanticValueEqual(from, to) ? undefined : { from, to, seq: (last?.seq ?? 0) + 1 }\n}\n\n/**\n * The reader's \"now\" for presence liveness: THIS session's own latest heartbeat `at`\n * (written by the same store clock as everyone else's — the playground store runs a\n * deterministic sequential clock, Convex the writers' wall clocks), falling back to the\n * injected clock before the first heartbeat lands. Comparing others' `at` against a\n * different time base would call every colleague stale (measured live in the\n * playground: the store's clock is months behind the browser's).\n */\nexport function presenceReaderNow(\n  entries: readonly PresenceEntry[],\n  sessionId: string,\n  fallback: string,\n): string {\n  const own = entries.filter((entry) => entry.sessionId === sessionId).map((entry) => entry.at)\n  return own.length > 0 ? own.sort().at(-1)! : fallback\n}\n\nexport interface DocumentDraft {\n  draft: CmsDocument\n  /** Uncommitted (document model) / unsaved (record model) edits exist. */\n  dirty: boolean\n  /** The record model: the editor renders a Save button + navigation guard. */\n  explicitSave: boolean\n  /** A field's control wrote `value` (the active locale for a localized field). */\n  setFieldValue(field: FieldDef, value: unknown): void\n  /** A writer that transforms ONE field position (fill / reset from base). */\n  editField(field: FieldDef, update: (draft: CmsDocument) => CmsDocument): void\n  /**\n   * The canvas emitted a new value for its field (node patches, committed at once). `base`\n   * is the value the canvas last agreed on with the draft: the canvas writer's delta is\n   * `base` → `value`, applied over whatever the draft holds now (EC-630 — a change that\n   * landed underneath meanwhile is never reverted by the canvas's own write).\n   */\n  setCanvasValue(field: FieldDef, value: unknown, base: unknown): void\n  /** The slot alias (a document-level key: a whole-document write at the held revision). */\n  setAlias(alias: string | undefined): void\n  /** Field boundary events (focus / blur / Enter) — the commit policy's triggers. */\n  focused(field: FieldDef): void\n  blurred(field: FieldDef): void\n  entered(field: FieldDef): void\n  /**\n   * EC-630 — the canvas inspector's boundary events: a control writing `position` of the\n   * canvas field `field`, committing on `policy` (THE declaration for its kind). A burst of\n   * typing in it is its uncommitted position until blur / Enter / the idle pause.\n   */\n  canvasFocused(field: FieldDef, position: CanvasControlPosition, policy: CommitPolicy): void\n  canvasBlurred(field: FieldDef, position: CanvasControlPosition): void\n  canvasEntered(field: FieldDef, position: CanvasControlPosition): void\n  /** The forced commit (sync; the persister serialises what follows) / the record model's Save. */\n  save(): void\n  /** The FORCED FLUSH: commit everything uncommitted and await persistence. */\n  flush(): Promise<void>\n  /** Adopt a draft from outside (a restored version). */\n  replaceDraft(next: CmsDocument): void\n  /**\n   * Bumped when the canvas must remount from the draft: a restored version replaced the\n   * document, or a locale switch pointed the canvas at another bucket. (A change made\n   * underneath the canvas is NOT a remount — {@link canvasChange}.)\n   */\n  canvasNonce: number\n  /**\n   * EC-630 — the latest change of the canvas field's value made UNDERNEATH the canvas (a\n   * colleague's patch by subscription, a write's canonical row, a resolved conflict): the\n   * draft's value before and after it. The canvas REBASES onto it — the change lands, its\n   * undo history and selection survive — where it used to remount and lose both.\n   */\n  canvasChange: CanvasFieldChange | undefined\n  /** The OTHER sessions present on this document, live by the reader's clock. */\n  presence: readonly PresenceEntry[]\n}\n\nexport interface UseDocumentDraftInput {\n  source: CollectionViewSource\n  collection: CollectionDef\n  doc: CmsDocument\n  locale: Locale\n  lookupManifest: PropFieldLookup\n  /** The composition field the canvas edits on this screen, if any. */\n  canvasField?: FieldDef\n  scheduler?: Scheduler\n  visibility?: VisibilitySource\n  /** The reader's clock for presence liveness (ISO); `new Date().toISOString()` by default. */\n  now?: () => string\n}\n\n/**\n * EC-616 — the base a record save is diffed against: the source's value whenever the draft\n * equals it (the record as opened, or as a save came back), else the previous base (the\n * editor has unsaved changes; a change from another writer meanwhile is not theirs). Pure.\n */\nexport function recordSaveBase(previous: CmsDocument, draft: CmsDocument, doc: CmsDocument): CmsDocument {\n  return semanticValueEqual(draft, doc) ? doc : previous\n}\n\nexport function useDocumentDraft(input: UseDocumentDraftInput): DocumentDraft {\n  const { source, collection, doc, locale, lookupManifest, canvasField } = input\n  const writes = source.writes\n  const documentModel = writes.kind === 'document' ? writes : undefined\n  const ref: DocumentRef = useMemo(() => ({ collection: doc.collection, id: doc.id }), [doc.collection, doc.id])\n  const [draft, setDraftState] = useState<CmsDocument>(doc)\n  const draftRef = useRef(draft)\n  // EC-616: the record as the editor opened it (or as of their last successful save) — the\n  // BASE a record rail diffs a save against, so it writes only the editor's changes. It moves\n  // only while the draft equals the source's value (at open, and once a save is reflected\n  // back): another writer's change arriving mid-edit never becomes the editor's base.\n  const baseRef = useRef<CmsDocument>(doc)\n  baseRef.current = recordSaveBase(baseRef.current, draftRef.current, doc)\n  const setDraft = useCallback((next: CmsDocument) => {\n    draftRef.current = next\n    setDraftState(next)\n  }, [])\n  const scheduler = input.scheduler ?? browserScheduler\n  const now = input.now ?? (() => new Date().toISOString())\n  const fieldsByName = useMemo(() => new Map(collection.fields.map((f) => [f.name, f])), [collection])\n\n  // --- Committing --------------------------------------------------------------------\n  const writesRef = useRef(documentModel)\n  writesRef.current = documentModel\n  /** EC-630 — the canvas inspector controls that took focus, by committer key (their position + policy). */\n  const canvasControls = useRef(new Map<string, CanvasControl>())\n  const committer = useMemo<DraftCommitter>(\n    () =>\n      createDraftCommitter({\n        policyOf: (name) => {\n          const field = fieldsByName.get(name)\n          if (field) return commitPolicyOf(field)\n          return canvasControls.current.get(name)?.policy ?? 'blur-or-idle'\n        },\n        commit: (positions) => {\n          const target = writesRef.current\n          if (!target) return\n          void target.commit(\n            ref,\n            positions.map((position) => positionPatch(draftRef.current, position.path)),\n            positions.map((position) => position.base),\n          )\n        },\n        baseOf: () => writesRef.current?.revisionOf(ref),\n        scheduler,\n      }),\n    // One committer per open document (the editor is keyed by it).\n    [ref],\n  )\n\n  // --- The canvas's value: its remount and its rebase ------------------------------------\n  const canvasPath = canvasField ? fieldPositionPath(collection, canvasField.name, locale) : undefined\n  const canvasPathKey = canvasPath ? formatValuePath(canvasPath) : ''\n  const [canvasNonce, setCanvasNonce] = useState(0)\n  const [canvasChange, setCanvasChange] = useState<CanvasFieldChange | undefined>(undefined)\n  // A locale switch points the canvas at another bucket: remount from it.\n  const lastCanvasPathKey = useRef(canvasPathKey)\n  useEffect(() => {\n    if (lastCanvasPathKey.current === canvasPathKey) return\n    lastCanvasPathKey.current = canvasPathKey\n    setCanvasNonce((n) => n + 1)\n  }, [canvasPathKey])\n\n  // --- The rebase (document model) -------------------------------------------------------\n  const firstDoc = useRef(true)\n  useEffect(() => {\n    if (firstDoc.current) {\n      firstDoc.current = false\n      return\n    }\n    if (!documentModel) return\n    const previous = draftRef.current\n    const next = rebaseDraft(doc, previous, committer.uncommitted())\n    setDraft(next)\n    // EC-630: the canvas field moved underneath the canvas — the canvas rebases onto the\n    // change (its own edits are in both values: the session's view holds every patch it\n    // committed, and the draft overlays every position it has not).\n    if (!canvasPath) return\n    setCanvasChange((last) => canvasFieldChange(previous, next, canvasPath, last) ?? last)\n  }, [doc])\n\n  // --- Writers ----------------------------------------------------------------------------\n  const setFieldValue = useCallback(\n    (field: FieldDef, value: unknown) => {\n      const next = writeField(collection, draftRef.current, field.name, locale, value, { lookupManifest })\n      setDraft(next)\n      if (documentModel) committer.edited(field.name, fieldPositionPath(collection, field.name, locale))\n    },\n    [collection, locale, lookupManifest, setDraft, documentModel, committer],\n  )\n  const editField = useCallback(\n    (field: FieldDef, update: (current: CmsDocument) => CmsDocument) => {\n      setDraft(update(draftRef.current))\n      if (documentModel) committer.edited(field.name, fieldPositionPath(collection, field.name, locale))\n    },\n    [collection, locale, setDraft, documentModel, committer],\n  )\n  const setCanvasValue = useCallback(\n    (field: FieldDef, value: unknown, base: unknown) => {\n      const write = canvasWrite({ collection, draft: draftRef.current, field: field.name, locale, value, base, lookupManifest })\n      if (!write) return\n      setDraft(write.next)\n      if (!documentModel) return\n      // EC-630: a burst of typing in a focused inspector control is that control's\n      // uncommitted position (its policy commits it); a canvas action commits now.\n      const focus = committer.focusedField()\n      routeCanvasWrite({\n        patches: write.patches,\n        focused: focus === undefined ? undefined : canvasControls.current.get(focus),\n        committer,\n        commitNow: (patches) => void documentModel.commit(ref, patches),\n      })\n    },\n    [collection, locale, lookupManifest, setDraft, documentModel, ref, committer],\n  )\n  const setAlias = useCallback(\n    (alias: string | undefined) => {\n      const next = { ...draftRef.current }\n      if (alias === undefined) delete next.alias\n      else next.alias = alias\n      setDraft(next)\n      if (!documentModel) return\n      committer.commitAll()\n      documentModel.replace(next)\n    },\n    [setDraft, documentModel, committer],\n  )\n\n  // --- Forced flush ----------------------------------------------------------------------\n  const save = useCallback(() => {\n    if (documentModel) committer.commitAll()\n    else if (writes.kind === 'record') writes.save(draftRef.current, baseRef.current)\n  }, [documentModel, committer, writes])\n  const flush = useCallback(async () => {\n    save()\n    if (documentModel) await documentModel.flush(ref)\n  }, [save, documentModel, ref])\n\n  // Tab hide: commit and flush. Unmount: the same, and leave the document.\n  const visibility = input.visibility ?? documentVisibility\n  useEffect(() => {\n    if (!documentModel) return\n    return visibility.onHidden(() => {\n      committer.commitAll()\n      void documentModel.flush(ref)\n    })\n  }, [ref])\n  useEffect(\n    () => () => {\n      const target = writesRef.current\n      if (!target) return\n      committer.commitAll()\n      committer.dispose()\n      void target.flush(ref)\n      target.clearPresence(ref)\n    },\n    [ref],\n  )\n\n  // --- Subscription + presence ------------------------------------------------------------\n  const [presenceEntries, setPresenceEntries] = useState<readonly PresenceEntry[]>([])\n  const [clock, setClock] = useState(now)\n  useEffect(() => {\n    if (!documentModel) return\n    return documentModel.subscribe(ref, setPresenceEntries)\n  }, [ref])\n  const focusedPathRef = useRef<ValuePath | undefined>(undefined)\n  const heartbeat = useCallback(() => {\n    writesRef.current?.reportPresence(ref, focusedPathRef.current)\n    setClock(now())\n  }, [ref])\n  useEffect(() => {\n    if (!documentModel) return\n    heartbeat()\n    let handle: unknown\n    const tick = () => {\n      heartbeat()\n      handle = scheduler.setTimeout(tick, PRESENCE_HEARTBEAT_MS)\n    }\n    handle = scheduler.setTimeout(tick, PRESENCE_HEARTBEAT_MS)\n    return () => scheduler.clearTimeout(handle)\n  }, [ref])\n  const presence = useMemo(\n    () =>\n      documentModel\n        ? livePresence(\n            presenceEntries,\n            presenceReaderNow(presenceEntries, documentModel.presenceSessionId, clock),\n            PRESENCE_TTL_MS,\n          ).filter((entry) => entry.sessionId !== documentModel.presenceSessionId)\n        : [],\n    [presenceEntries, clock, documentModel],\n  )\n\n  const focused = useCallback(\n    (field: FieldDef) => {\n      if (!documentModel) return\n      committer.focused(field.name)\n      focusedPathRef.current = fieldPositionPath(collection, field.name, locale)\n      heartbeat()\n    },\n    [documentModel, committer, collection, locale, heartbeat],\n  )\n  const blurred = useCallback(\n    (field: FieldDef) => {\n      if (!documentModel) return\n      committer.blurred(field.name)\n      focusedPathRef.current = undefined\n      heartbeat()\n    },\n    [documentModel, committer, heartbeat],\n  )\n  const entered = useCallback(\n    (field: FieldDef) => {\n      if (documentModel) committer.entered(field.name)\n    },\n    [documentModel, committer],\n  )\n\n  // EC-630 — the canvas inspector's commit boundary: a control at a position of the canvas\n  // field gained focus, lost it, or saw Enter. Its policy is THE declaration's for its kind.\n  const canvasControlOf = useCallback(\n    (field: FieldDef, position: CanvasControlPosition, policy: CommitPolicy) =>\n      canvasControl(fieldPositionPath(collection, field.name, locale), position, policy),\n    [collection, locale],\n  )\n  const canvasFocused = useCallback(\n    (field: FieldDef, position: CanvasControlPosition, policy: CommitPolicy) => {\n      if (!documentModel) return\n      const control = canvasControlOf(field, position, policy)\n      canvasControls.current.set(control.key, control)\n      committer.focused(control.key)\n      focusedPathRef.current = control.path\n      heartbeat()\n    },\n    [documentModel, committer, canvasControlOf, heartbeat],\n  )\n  const canvasBlurred = useCallback(\n    (field: FieldDef, position: CanvasControlPosition) => {\n      if (!documentModel) return\n      const key = canvasControlOf(field, position, 'change').key\n      committer.blurred(key)\n      canvasControls.current.delete(key)\n      focusedPathRef.current = undefined\n      heartbeat()\n    },\n    [documentModel, committer, canvasControlOf, heartbeat],\n  )\n  const canvasEntered = useCallback(\n    (field: FieldDef, position: CanvasControlPosition) => {\n      if (documentModel) committer.entered(canvasControlOf(field, position, 'change').key)\n    },\n    [documentModel, committer, canvasControlOf],\n  )\n\n  const replaceDraft = useCallback(\n    (next: CmsDocument) => {\n      // A restored version replaces the document: when it moved the canvas field, the\n      // canvas remounts from it (its history belonged to the replaced value).\n      const moved = canvasPath && !semanticValueEqual(readValueAt(draftRef.current, canvasPath), readValueAt(next, canvasPath))\n      setDraft(next)\n      if (moved) setCanvasNonce((n) => n + 1)\n    },\n    // The path is keyed by its string form.\n    [setDraft, canvasPathKey],\n  )\n\n  const dirty = useMemo(() => !semanticValueEqual(draft, doc), [draft, doc])\n\n  return {\n    draft,\n    dirty,\n    explicitSave: writes.kind === 'record',\n    setFieldValue,\n    editField,\n    setCanvasValue,\n    setAlias,\n    focused,\n    blurred,\n    entered,\n    canvasFocused,\n    canvasBlurred,\n    canvasEntered,\n    save,\n    flush,\n    replaceDraft,\n    canvasNonce,\n    canvasChange,\n    presence,\n  }\n}\n"]}

package/dist/components/cms/use-live-url.d.ts

@@ -1,5 +1,6 @@
 import type { CmsDocument, CollectionDef, DocumentUrl, Locale, LocaleConfig, RouteRecord } from '@elytracms/core/cms-core';
 import type { CollectionViewSource } from '../../lib/collection-view/collection-view-source.js';
+import type { ReadState } from '../../lib/query/index.js';
 import type { IssueSeverity } from '../issue-severity.js';
 /**
  * The header's live-link descriptor: an `href` (open live) + a title, or a
@@ -28,11 +29,15 @@ export interface HeaderLive {
  * consumed, not re-derived: the row shows the same `warning` the Issues pane shows
  * for it (`document-reachability.ts`), because a link titled "Open /de" a few
  * pixels from that warning is the stronger signal, and it is the wrong one.
+ *
+ * EC-628 — `pool` is the published pool's read state. A FAILED read is an `error`
+ * finding with the pool's sentence, whatever the document's own state: what is live
+ * cannot be known, and the old empty pool answered with a lifecycle hint instead.
  */
 export declare function resolveHeaderLive(input: {
     routableCollection: boolean;
     liveUrl: Pick<DocumentUrl, 'href' | 'path' | 'addressable'> | undefined;
-    loading: boolean;
+    pool: ReadState<unknown>;
     published: boolean;
 }): HeaderLive | undefined;
 /**

package/dist/components/cms/use-live-url.js

@@ -17,10 +17,16 @@ import { usePublishedDocuments } from '../../lib/cms/published-documents.js';
  * consumed, not re-derived: the row shows the same `warning` the Issues pane shows
  * for it (`document-reachability.ts`), because a link titled "Open /de" a few
  * pixels from that warning is the stronger signal, and it is the wrong one.
+ *
+ * EC-628 — `pool` is the published pool's read state. A FAILED read is an `error`
+ * finding with the pool's sentence, whatever the document's own state: what is live
+ * cannot be known, and the old empty pool answered with a lifecycle hint instead.
  */
 export function resolveHeaderLive(input) {
     if (!input.routableCollection)
         return undefined;
+    if (input.pool.status === 'error')
+        return { title: input.pool.message, severity: 'error' };
     if (input.liveUrl && !input.liveUrl.addressable) {
         return { title: translate('cms.issue.unaddressable-url'), severity: 'warning' };
     }
@@ -28,7 +34,7 @@ export function resolveHeaderLive(input) {
         return { href: input.liveUrl.href, title: translate('cms.editor.openLiveUrl', { path: input.liveUrl.path }) };
     }
     return {
-        title: input.loading
+        title: input.pool.status === 'loading'
             ? translate('cms.editor.loadingLiveUrl')
             : !input.published
                 ? translate('cms.editor.publishToViewLive')
@@ -64,7 +70,9 @@ export function useLiveUrl(input) {
     const { source, collection, doc, locale, published, routableCollection } = input;
     const publishedDocs = usePublishedDocuments(source.projectId, collection.id);
     const liveUrl = useMemo(() => {
-        const publishedDoc = publishedDocs.byId.get(doc.id);
+        if (publishedDocs.status !== 'ready')
+            return undefined;
+        const publishedDoc = publishedDocs.value.get(doc.id);
         if (!publishedDoc)
             return undefined;
         return resolveDocumentLiveUrl({
@@ -73,16 +81,11 @@ export function useLiveUrl(input) {
             frontendUrl: resolveDeploymentFrontendUrl(),
             collection,
             doc: publishedDoc,
-            siblings: [...publishedDocs.byId.values()],
+            siblings: [...publishedDocs.value.values()],
             locale,
         });
     }, [publishedDocs, collection, doc.id, locale, source.localeConfig]);
-    const headerLive = resolveHeaderLive({
-        routableCollection,
-        liveUrl,
-        loading: publishedDocs.status === 'loading',
-        published,
-    });
+    const headerLive = resolveHeaderLive({ routableCollection, liveUrl, pool: publishedDocs, published });
     return { headerLive };
 }
 //# sourceMappingURL=use-live-url.js.map

package/dist/components/cms/use-live-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-url.js","sourceRoot":"","sources":["../../../src/components/cms/use-live-url.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { createRouter } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentUrl,\n  Locale,\n  LocaleConfig,\n  RouteRecord,\n} from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '../../lib/collection-view/collection-view-source'\nimport { translate } from '../../lib/i18n'\nimport { resolveDeploymentFrontendUrl, resolveDeploymentRoutes } from '../../lib/workspace'\nimport { usePublishedDocuments } from '../../lib/cms/published-documents'\nimport type { IssueSeverity } from '../issue-severity'\n\n/**\n * The header's live-link descriptor: an `href` (open live) + a title, or a\n * reason-only title while it isn't openable (loading / publish-first / no\n * frontendUrl). `severity` is set when the reason is a FINDING about the URL\n * rather than a lifecycle state — the renderer then shows the shared issue glyph\n * (EC-507) in place of the muted open-live icon, so the row and the Issues pane\n * say the same thing (EC-518).\n */\nexport interface HeaderLive {\n  href?: string\n  title: string\n  severity?: IssueSeverity\n}\n\n/**\n * 0.0.42 (round 3) — the header composed-URL row's open-live affordance, as a pure\n * decision. Only a routable collection shows the row; its leaf opens the live page\n * when the doc is published AND a frontendUrl is set (an absolute `href`),\n * otherwise it is a muted icon whose tooltip explains WHY (still loading, publish\n * first, or set the frontendUrl). The draft-derived path itself updates as you\n * type — only the OPEN-live action is published-gated, preserving draft/live.\n *\n * EC-518 — a URL the engine has computed as NOT `addressable` (EC-492: the host\n * re-derives a different `{locale, path}` pair from it, so no request reaches the\n * document) never becomes an `href`, frontendUrl or not. The engine's verdict is\n * consumed, not re-derived: the row shows the same `warning` the Issues pane shows\n * for it (`document-reachability.ts`), because a link titled \"Open /de\" a few\n * pixels from that warning is the stronger signal, and it is the wrong one.\n */\nexport function resolveHeaderLive(input: {\n  routableCollection: boolean\n  liveUrl: Pick<DocumentUrl, 'href' | 'path' | 'addressable'> | undefined\n  loading: boolean\n  published: boolean\n}): HeaderLive | undefined {\n  if (!input.routableCollection) return undefined\n  if (input.liveUrl && !input.liveUrl.addressable) {\n    return { title: translate('cms.issue.unaddressable-url'), severity: 'warning' }\n  }\n  if (input.liveUrl?.href) {\n    return { href: input.liveUrl.href, title: translate('cms.editor.openLiveUrl', { path: input.liveUrl.path }) }\n  }\n  return {\n    title: input.loading\n      ? translate('cms.editor.loadingLiveUrl')\n      : !input.published\n        ? translate('cms.editor.publishToViewLive')\n        : translate('cms.editor.setFrontendUrlHint'),\n  }\n}\n\n/**\n * EC-590 — derive a published document's live URL through THE router\n * (`createRouter(...).urlFor`), the same reverse direction delivery's links and sitemap\n * read, in the one precedence order — so the studio's live link can no longer advertise a\n * URL the site 404s (IDENTITY M4). The project's routes as declared: the engine derives no\n * home route any more (the former `mergeRouteRecords` + `fallbackHomeRoutes` merge went\n * with it). Pure (no React), so it is unit-tested directly rather than through the hook.\n */\nexport function resolveDocumentLiveUrl(input: {\n  routes: readonly RouteRecord[]\n  localeConfig: LocaleConfig\n  frontendUrl: string | undefined\n  collection: CollectionDef\n  doc: CmsDocument\n  siblings: readonly CmsDocument[]\n  locale: Locale\n}): DocumentUrl | undefined {\n  return createRouter({\n    routes: input.routes,\n    collections: [input.collection],\n    locales: input.localeConfig,\n  }).urlFor(input.doc, {\n    siblings: input.siblings,\n    locale: input.locale,\n    ...(input.frontendUrl !== undefined ? { frontendUrl: input.frontendUrl } : {}),\n  })\n}\n\n/**\n * EC-205 / EC-216 — the LIVE URL derives strictly from PUBLISHED data (the pinned\n * published snapshot + its published ancestors), never the draft, so an unpublished\n * slug/parent edit can't leak into the live URL. Resolves the header's live-link\n * descriptor for the composed-URL row; `undefined` for a non-routable collection.\n */\nexport function useLiveUrl(input: {\n  source: CollectionViewSource\n  collection: CollectionDef\n  doc: CmsDocument\n  locale: Locale\n  published: boolean\n  routableCollection: boolean\n}): { headerLive: HeaderLive | undefined } {\n  const { source, collection, doc, locale, published, routableCollection } = input\n  const publishedDocs = usePublishedDocuments(source.projectId, collection.id)\n  const liveUrl = useMemo(() => {\n    const publishedDoc = publishedDocs.byId.get(doc.id)\n    if (!publishedDoc) return undefined\n    return resolveDocumentLiveUrl({\n      routes: resolveDeploymentRoutes(),\n      localeConfig: source.localeConfig,\n      frontendUrl: resolveDeploymentFrontendUrl(),\n      collection,\n      doc: publishedDoc,\n      siblings: [...publishedDocs.byId.values()],\n      locale,\n    })\n  }, [publishedDocs, collection, doc.id, locale, source.localeConfig])\n\n  const headerLive = resolveHeaderLive({\n    routableCollection,\n    liveUrl,\n    loading: publishedDocs.status === 'loading',\n    published,\n  })\n  return { headerLive }\n}\n"]}
+{"version":3,"file":"use-live-url.js","sourceRoot":"","sources":["../../../src/components/cms/use-live-url.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { createRouter } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  DocumentUrl,\n  Locale,\n  LocaleConfig,\n  RouteRecord,\n} from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '../../lib/collection-view/collection-view-source'\nimport { translate } from '../../lib/i18n'\nimport { resolveDeploymentFrontendUrl, resolveDeploymentRoutes } from '../../lib/workspace'\nimport { usePublishedDocuments } from '../../lib/cms/published-documents'\nimport type { ReadState } from '../../lib/query'\nimport type { IssueSeverity } from '../issue-severity'\n\n/**\n * The header's live-link descriptor: an `href` (open live) + a title, or a\n * reason-only title while it isn't openable (loading / publish-first / no\n * frontendUrl). `severity` is set when the reason is a FINDING about the URL\n * rather than a lifecycle state — the renderer then shows the shared issue glyph\n * (EC-507) in place of the muted open-live icon, so the row and the Issues pane\n * say the same thing (EC-518).\n */\nexport interface HeaderLive {\n  href?: string\n  title: string\n  severity?: IssueSeverity\n}\n\n/**\n * 0.0.42 (round 3) — the header composed-URL row's open-live affordance, as a pure\n * decision. Only a routable collection shows the row; its leaf opens the live page\n * when the doc is published AND a frontendUrl is set (an absolute `href`),\n * otherwise it is a muted icon whose tooltip explains WHY (still loading, publish\n * first, or set the frontendUrl). The draft-derived path itself updates as you\n * type — only the OPEN-live action is published-gated, preserving draft/live.\n *\n * EC-518 — a URL the engine has computed as NOT `addressable` (EC-492: the host\n * re-derives a different `{locale, path}` pair from it, so no request reaches the\n * document) never becomes an `href`, frontendUrl or not. The engine's verdict is\n * consumed, not re-derived: the row shows the same `warning` the Issues pane shows\n * for it (`document-reachability.ts`), because a link titled \"Open /de\" a few\n * pixels from that warning is the stronger signal, and it is the wrong one.\n *\n * EC-628 — `pool` is the published pool's read state. A FAILED read is an `error`\n * finding with the pool's sentence, whatever the document's own state: what is live\n * cannot be known, and the old empty pool answered with a lifecycle hint instead.\n */\nexport function resolveHeaderLive(input: {\n  routableCollection: boolean\n  liveUrl: Pick<DocumentUrl, 'href' | 'path' | 'addressable'> | undefined\n  pool: ReadState<unknown>\n  published: boolean\n}): HeaderLive | undefined {\n  if (!input.routableCollection) return undefined\n  if (input.pool.status === 'error') return { title: input.pool.message, severity: 'error' }\n  if (input.liveUrl && !input.liveUrl.addressable) {\n    return { title: translate('cms.issue.unaddressable-url'), severity: 'warning' }\n  }\n  if (input.liveUrl?.href) {\n    return { href: input.liveUrl.href, title: translate('cms.editor.openLiveUrl', { path: input.liveUrl.path }) }\n  }\n  return {\n    title: input.pool.status === 'loading'\n      ? translate('cms.editor.loadingLiveUrl')\n      : !input.published\n        ? translate('cms.editor.publishToViewLive')\n        : translate('cms.editor.setFrontendUrlHint'),\n  }\n}\n\n/**\n * EC-590 — derive a published document's live URL through THE router\n * (`createRouter(...).urlFor`), the same reverse direction delivery's links and sitemap\n * read, in the one precedence order — so the studio's live link can no longer advertise a\n * URL the site 404s (IDENTITY M4). The project's routes as declared: the engine derives no\n * home route any more (the former `mergeRouteRecords` + `fallbackHomeRoutes` merge went\n * with it). Pure (no React), so it is unit-tested directly rather than through the hook.\n */\nexport function resolveDocumentLiveUrl(input: {\n  routes: readonly RouteRecord[]\n  localeConfig: LocaleConfig\n  frontendUrl: string | undefined\n  collection: CollectionDef\n  doc: CmsDocument\n  siblings: readonly CmsDocument[]\n  locale: Locale\n}): DocumentUrl | undefined {\n  return createRouter({\n    routes: input.routes,\n    collections: [input.collection],\n    locales: input.localeConfig,\n  }).urlFor(input.doc, {\n    siblings: input.siblings,\n    locale: input.locale,\n    ...(input.frontendUrl !== undefined ? { frontendUrl: input.frontendUrl } : {}),\n  })\n}\n\n/**\n * EC-205 / EC-216 — the LIVE URL derives strictly from PUBLISHED data (the pinned\n * published snapshot + its published ancestors), never the draft, so an unpublished\n * slug/parent edit can't leak into the live URL. Resolves the header's live-link\n * descriptor for the composed-URL row; `undefined` for a non-routable collection.\n */\nexport function useLiveUrl(input: {\n  source: CollectionViewSource\n  collection: CollectionDef\n  doc: CmsDocument\n  locale: Locale\n  published: boolean\n  routableCollection: boolean\n}): { headerLive: HeaderLive | undefined } {\n  const { source, collection, doc, locale, published, routableCollection } = input\n  const publishedDocs = usePublishedDocuments(source.projectId, collection.id)\n  const liveUrl = useMemo(() => {\n    if (publishedDocs.status !== 'ready') return undefined\n    const publishedDoc = publishedDocs.value.get(doc.id)\n    if (!publishedDoc) return undefined\n    return resolveDocumentLiveUrl({\n      routes: resolveDeploymentRoutes(),\n      localeConfig: source.localeConfig,\n      frontendUrl: resolveDeploymentFrontendUrl(),\n      collection,\n      doc: publishedDoc,\n      siblings: [...publishedDocs.value.values()],\n      locale,\n    })\n  }, [publishedDocs, collection, doc.id, locale, source.localeConfig])\n\n  const headerLive = resolveHeaderLive({ routableCollection, liveUrl, pool: publishedDocs, published })\n  return { headerLive }\n}\n"]}