@elytracms/studio 0.0.95 → 0.0.97

package/dist/components/cms/draft-commit.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft-commit.js","sourceRoot":"","sources":["../../../src/components/cms/draft-commit.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatValuePath } from '@elytracms/core/cms-core'\nimport type { ValuePath } from '@elytracms/core/cms-core'\nimport type { CommitPolicy } from './commit-policy'\nimport { IDLE_COMMIT_MS } from './commit-policy'\n\n/**\n * EC-595 A2 — the editor's COMMIT-ON-QUIESCENCE core (pure, clock injected; the house\n * pattern: no DOM, no React).\n *\n * The editor's draft changes per keystroke (live validation reads it); what is\n * COMMITTED — handed to the persister as patches — follows each field's\n * {@link CommitPolicy}. This core tracks the uncommitted positions and decides when\n * each is committed:\n *\n * - an edit of a `change`-policy field commits at once;\n * - an edit of the FOCUSED field waits for its blur, Enter (`blur-or-enter`) or idle\n *   pause (`blur-or-idle`, re-armed on every edit — {@link Scheduler});\n * - an edit of a field that does NOT have focus (a derived value — the auto-slug\n *   following the title, fill-from-base) rides along with the focused field's next\n *   commit, or commits at once when no field has focus;\n * - {@link DraftCommitter.commitAll} is the FORCED commit (publish, unmount, tab hide,\n *   duplicate, an AI proposal, transfer) — everything uncommitted, now.\n *\n * `commit` receives the positions; the caller builds the patches from its latest draft\n * (the value AT commit time, so a committed value is never a stale keystroke).\n */\n\n/** The injected clock: timers for the idle pause. */\nexport interface Scheduler {\n  setTimeout(callback: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\n\n/** The real clock (the editor's default). */\nexport const browserScheduler: Scheduler = {\n  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n  clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n}\n\n/** One uncommitted position and the field (by name) whose control wrote it. */\nexport interface UncommittedPosition {\n  readonly field: string\n  readonly path: ValuePath\n  /**\n   * The revision the user's view was at when they STARTED editing this position — the\n   * patch's base. A colleague's change of the same position that arrives (by\n   * subscription) while the user is still typing is therefore refused on that field at\n   * commit, never overwritten (EC-595 point 7: \"local wins until flushed, then the\n   * per-path check decides\").\n   */\n  readonly base: number | undefined\n}\n\nexport interface DraftCommitter {\n  /** A field's control wrote `path`. */\n  edited(field: string, path: ValuePath): void\n  /** Focus entered a field's control. */\n  focused(field: string): void\n  /** Focus left a field's control (commits it and what rode along). */\n  blurred(field: string): void\n  /** Enter in a single-line control (commits it). */\n  entered(field: string): void\n  /** The forced commit: everything uncommitted, now. */\n  commitAll(): void\n  /** The uncommitted positions (the editor overlays them on a rebased draft). */\n  uncommitted(): readonly UncommittedPosition[]\n  /** The field that has focus, if any. */\n  focusedField(): string | undefined\n  /** Cancel the idle timers (unmount). */\n  dispose(): void\n}\n\nexport interface DraftCommitterOptions {\n  policyOf: (field: string) => CommitPolicy\n  /** The revision the session's view is at now (captured as a position's base on its first edit). */\n  baseOf?: () => number | undefined\n  commit: (positions: readonly UncommittedPosition[]) => void\n  scheduler?: Scheduler\n  idleMs?: number\n}\n\nexport function createDraftCommitter(options: DraftCommitterOptions): DraftCommitter {\n  const scheduler = options.scheduler ?? browserScheduler\n  const idleMs = options.idleMs ?? IDLE_COMMIT_MS\n  /** Uncommitted positions by path key (one per position — a re-edit keeps one entry). */\n  const pending = new Map<string, UncommittedPosition>()\n  const idleTimers = new Map<string, unknown>()\n  let focus: string | undefined\n\n  const cancelIdle = (field: string) => {\n    const handle = idleTimers.get(field)\n    if (handle !== undefined) scheduler.clearTimeout(handle)\n    idleTimers.delete(field)\n  }\n\n  /** Commit `field`'s positions plus every position of a field that does not have focus. */\n  const commitField = (field: string) => {\n    cancelIdle(field)\n    const batch = [...pending.entries()].filter(\n      ([, position]) => position.field === field || position.field !== focus,\n    )\n    if (batch.length === 0) return\n    for (const [key] of batch) pending.delete(key)\n    options.commit(batch.map(([, position]) => position))\n  }\n\n  return {\n    edited(field, path) {\n      const key = formatValuePath(path)\n      const previous = pending.get(key)\n      pending.set(key, { field, path, base: previous ? previous.base : options.baseOf?.() })\n      const policy = options.policyOf(field)\n      if (policy === 'change' || focus === undefined) {\n        commitField(field)\n        return\n      }\n      if (focus !== field) return // rides along with the focused field's commit\n      if (policy === 'blur-or-idle') {\n        cancelIdle(field)\n        idleTimers.set(\n          field,\n          scheduler.setTimeout(() => {\n            idleTimers.delete(field)\n            commitField(field)\n          }, idleMs),\n        )\n      }\n    },\n    focused(field) {\n      if (focus !== undefined && focus !== field) commitField(focus)\n      focus = field\n    },\n    blurred(field) {\n      if (focus === field) focus = undefined\n      commitField(field)\n    },\n    entered(field) {\n      if (options.policyOf(field) === 'blur-or-enter') commitField(field)\n    },\n    commitAll() {\n      for (const field of [...idleTimers.keys()]) cancelIdle(field)\n      if (pending.size === 0) return\n      const batch = [...pending.values()]\n      pending.clear()\n      options.commit(batch)\n    },\n    uncommitted: () => [...pending.values()],\n    focusedField: () => focus,\n    dispose() {\n      for (const field of [...idleTimers.keys()]) cancelIdle(field)\n    },\n  }\n}\n"]}
+{"version":3,"file":"draft-commit.js","sourceRoot":"","sources":["../../../src/components/cms/draft-commit.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatValuePath } from '@elytracms/core/cms-core'\nimport type { ValuePath } from '@elytracms/core/cms-core'\nimport type { CommitPolicy } from './commit-policy'\nimport { IDLE_COMMIT_MS } from './commit-policy'\n\n/**\n * EC-595 A2 — the editor's COMMIT-ON-QUIESCENCE core (pure, clock injected; the house\n * pattern: no DOM, no React).\n *\n * The editor's draft changes per keystroke (live validation reads it); what is\n * COMMITTED — handed to the persister as patches — follows each field's\n * {@link CommitPolicy}. This core tracks the uncommitted positions and decides when\n * each is committed:\n *\n * - an edit of a `change`-policy field commits at once;\n * - an edit of the FOCUSED field waits for its blur, Enter (`blur-or-enter`) or idle\n *   pause (`blur-or-idle`, re-armed on every edit — {@link Scheduler});\n * - an edit of a field that does NOT have focus (a derived value — the auto-slug\n *   following the title, fill-from-base) rides along with the focused field's next\n *   commit, or commits at once when no field has focus;\n * - {@link DraftCommitter.commitAll} is the FORCED commit (publish, unmount, tab hide,\n *   duplicate, an AI proposal, transfer) — everything uncommitted, now.\n *\n * `commit` receives the positions; the caller builds the patches from its latest draft\n * (the value AT commit time, so a committed value is never a stale keystroke).\n */\n\n/** The injected clock: timers for the idle pause. */\nexport interface Scheduler {\n  setTimeout(callback: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\n\n/** The real clock (the editor's default). */\nexport const browserScheduler: Scheduler = {\n  setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n  clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n}\n\n/** One uncommitted position and the field (by name) whose control wrote it. */\nexport interface UncommittedPosition {\n  readonly field: string\n  readonly path: ValuePath\n  /**\n   * The revision the user's view was at when they STARTED editing this position — the\n   * patch's base. A colleague's change of the same position that arrives (by\n   * subscription) while the user is still typing is therefore refused on that field at\n   * commit, never overwritten (EC-595 point 7: \"local wins until flushed, then the\n   * per-path check decides\").\n   */\n  readonly base: number | undefined\n}\n\nexport interface DraftCommitter {\n  /**\n   * A field's control wrote `path`. `authored` — the revision the edit was authored\n   * against when the writer knows it better than the draft does (EC-647: a canvas\n   * inspector control's burst is authored on the CANVAS's value, whose revision can trail\n   * the draft's); absent → {@link DraftCommitterOptions.baseOf}. A re-edit of an\n   * uncommitted position keeps the base of its first edit either way.\n   */\n  edited(field: string, path: ValuePath, authored?: { readonly base: number | undefined }): void\n  /** Focus entered a field's control. */\n  focused(field: string): void\n  /** Focus left a field's control (commits it and what rode along). */\n  blurred(field: string): void\n  /** Enter in a single-line control (commits it). */\n  entered(field: string): void\n  /** The forced commit: everything uncommitted, now. */\n  commitAll(): void\n  /** The uncommitted positions (the editor overlays them on a rebased draft). */\n  uncommitted(): readonly UncommittedPosition[]\n  /** The field that has focus, if any. */\n  focusedField(): string | undefined\n  /** Cancel the idle timers (unmount). */\n  dispose(): void\n}\n\nexport interface DraftCommitterOptions {\n  policyOf: (field: string) => CommitPolicy\n  /**\n   * The revision the editor's draft is at now — the revision of the view a field's edit\n   * is authored on (captured as a position's base on its first edit). EC-647: the\n   * draft's, never the session's tracked one (which may hold a change the draft has not\n   * rebased onto yet).\n   */\n  baseOf?: () => number | undefined\n  commit: (positions: readonly UncommittedPosition[]) => void\n  scheduler?: Scheduler\n  idleMs?: number\n}\n\nexport function createDraftCommitter(options: DraftCommitterOptions): DraftCommitter {\n  const scheduler = options.scheduler ?? browserScheduler\n  const idleMs = options.idleMs ?? IDLE_COMMIT_MS\n  /** Uncommitted positions by path key (one per position — a re-edit keeps one entry). */\n  const pending = new Map<string, UncommittedPosition>()\n  const idleTimers = new Map<string, unknown>()\n  let focus: string | undefined\n\n  const cancelIdle = (field: string) => {\n    const handle = idleTimers.get(field)\n    if (handle !== undefined) scheduler.clearTimeout(handle)\n    idleTimers.delete(field)\n  }\n\n  /** Commit `field`'s positions plus every position of a field that does not have focus. */\n  const commitField = (field: string) => {\n    cancelIdle(field)\n    const batch = [...pending.entries()].filter(\n      ([, position]) => position.field === field || position.field !== focus,\n    )\n    if (batch.length === 0) return\n    for (const [key] of batch) pending.delete(key)\n    options.commit(batch.map(([, position]) => position))\n  }\n\n  return {\n    edited(field, path, authored) {\n      const key = formatValuePath(path)\n      const previous = pending.get(key)\n      const base = previous ? previous.base : authored ? authored.base : options.baseOf?.()\n      pending.set(key, { field, path, base })\n      const policy = options.policyOf(field)\n      if (policy === 'change' || focus === undefined) {\n        commitField(field)\n        return\n      }\n      if (focus !== field) return // rides along with the focused field's commit\n      if (policy === 'blur-or-idle') {\n        cancelIdle(field)\n        idleTimers.set(\n          field,\n          scheduler.setTimeout(() => {\n            idleTimers.delete(field)\n            commitField(field)\n          }, idleMs),\n        )\n      }\n    },\n    focused(field) {\n      if (focus !== undefined && focus !== field) commitField(focus)\n      focus = field\n    },\n    blurred(field) {\n      if (focus === field) focus = undefined\n      commitField(field)\n    },\n    entered(field) {\n      if (options.policyOf(field) === 'blur-or-enter') commitField(field)\n    },\n    commitAll() {\n      for (const field of [...idleTimers.keys()]) cancelIdle(field)\n      if (pending.size === 0) return\n      const batch = [...pending.values()]\n      pending.clear()\n      options.commit(batch)\n    },\n    uncommitted: () => [...pending.values()],\n    focusedField: () => focus,\n    dispose() {\n      for (const field of [...idleTimers.keys()]) cancelIdle(field)\n    },\n  }\n}\n"]}

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

@@ -1,10 +1,10 @@
 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 { CollectionViewSource, DocumentWrites } from '../../lib/collection-view/collection-view-source.js';
+import type { CanvasFieldChange, CanvasLift } 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';
+import type { CanvasControl, CanvasControlPosition } from './canvas-commit.js';
+import type { DraftCommitter, Scheduler, UncommittedPosition } from './draft-commit.js';
 /**
  * EC-595 A2 — the detail editor's draft over the revisioned document (and, for the
  * explicit-save rails, over a record).
@@ -40,6 +40,59 @@ export interface VisibilitySource {
     onHidden(onHidden: () => void): () => void;
 }
 export declare const documentVisibility: VisibilitySource;
+/**
+ * EC-647 — the editor's draft and the revision of the session view it was last rebased
+ * onto, as ONE value: every edit made on the draft was authored against that revision (an
+ * uncommitted position keeps the revision its first keystroke saw). `undefined`: the view
+ * had no revision (a fixture session, a record rail, a document still being created).
+ *
+ * EC-667 — that session view is a COMPOSITE while it shows a pending write (Codex F18):
+ * `revision` is its whole-document token (the EARLIEST authoring revision of any position
+ * — what a whole-document writer, the slot alias or the translation, writes at), and
+ * `shown` is the view itself, the token a position's edit reads ITS provenance from at
+ * the first keystroke ({@link positionBase}).
+ */
+export interface DraftView {
+    readonly document: CmsDocument;
+    readonly revision: number | undefined;
+    /** EC-667 — the session view the draft was last rebased onto (absent: none — a fixture, a record rail). */
+    readonly shown?: CmsDocument;
+}
+/** What a draft reads its tokens from: the write model's view registry (EC-647 / EC-667). */
+export type ViewTokens = Pick<DocumentWrites, 'revisionOfView'>;
+/** EC-667 — the draft of a session view as it is shown (pure): its value, its whole-document token, the view itself. */
+export declare function sessionDraftView(doc: CmsDocument, tokens: ViewTokens | undefined): DraftView;
+/**
+ * EC-667 — the base an edit of `path` that STARTS now on `draft` is authored against
+ * (pure; the committer captures it at the first keystroke): the revision the content at
+ * that position of the shown session view was authored against — under a pending
+ * whole-document snapshot the snapshot's revision, under a pending own write that write's
+ * base — never the revision of a row adopted underneath it. Captured at the start, it
+ * survives the pending write's refusal or failure (looking it up when the commit arrives
+ * would be too late). Without a view token: the draft's whole-document revision.
+ */
+export declare function positionBase(draft: DraftView, path: ValuePath, tokens: ViewTokens | undefined): number | undefined;
+/**
+ * THE draft rebase as one value (pure — what the editor runs when the session's document
+ * changes): the session view with the uncommitted positions laid over it ({@link
+ * rebaseDraft}), its whole-document token, the view itself (EC-647 → EC-667: the rebase
+ * moves the value AND its tokens), and — when the screen has a canvas — the token of the
+ * canvas field's position, which the canvas's next edit is authored at.
+ */
+export declare function rebaseDraftView(doc: CmsDocument, previous: DraftView, uncommitted: readonly UncommittedPosition[], tokens: ViewTokens, canvasPath?: ValuePath): {
+    view: DraftView;
+    canvasRevision: number | undefined;
+};
+/**
+ * EC-647 — the slot alias write (pure): the draft with `alias` set (or removed), written
+ * whole AT THE DRAFT'S REVISION — never the session's tracked one, which may already hold
+ * a colleague's change the draft has not absorbed (Codex F10). There is no identity-
+ * metadata operation for the alias (the value-position grammar has no position for it,
+ * measured on the base), so it stays a whole-document `replace` with its precondition.
+ */
+export declare function aliasWrite(draft: DraftView, alias: string | undefined, writes: {
+    replace(doc: CmsDocument, revision: number | undefined): void;
+}): CmsDocument;
 /** The patch that writes the value `doc` holds at `path` (unset when absent). */
 export declare function positionPatch(doc: CmsDocument, path: ValuePath): DocumentPatch;
 /**
@@ -74,8 +127,43 @@ export declare function canvasWrite(input: {
  * 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.
+ *
+ * EC-647: it carries `revision`, the revision the draft is at after the rebase, and is
+ * reported when only THAT moved too (`from` ≡ `to`): the canvas's agreed value is valid
+ * at the newer revision, so its next edit is authored there — the revision follows the
+ * value, never runs ahead of it.
+ *
+ * EC-667: `revision` is the token of the canvas FIELD's position in the shown view
+ * ({@link rebaseDraftView}) — under a pending snapshot the snapshot's revision. The canvas
+ * mounts at the draft's whole-document token (the earliest, possibly earlier than its
+ * field's), so the first rebase with a token reports it even when nothing moved.
+ */
+export declare function canvasFieldChange(previous: CmsDocument, next: CmsDocument, path: ValuePath, last: CanvasFieldChange | undefined, revision: number | undefined): CanvasFieldChange | undefined;
+/**
+ * EC-647 — the canvas's write path (pure; what {@link DocumentDraft.setCanvasValue} runs):
+ * the canvas writer's delta into the draft ({@link canvasWrite}, handed to `apply`), then
+ * routed ({@link routeCanvasWrite}) — committed at once, or held as a focused inspector
+ * control's uncommitted position — and in both cases paired with the revision of the
+ * canvas value the edit was authored on (`lift.revision`), never the draft's: the draft
+ * may already hold a colleague's change the canvas has not been rebased onto (Codex F12),
+ * and the store must check the edit from the canvas's revision to refuse it where it
+ * overlaps that change. `commit` absent → a draft without a revisioned write model (the
+ * draft moves, nothing is committed). `undefined` when the canvas changed nothing.
  */
-export declare function canvasFieldChange(previous: CmsDocument, next: CmsDocument, path: ValuePath, last: CanvasFieldChange | undefined): CanvasFieldChange | undefined;
+export declare function canvasCommit(input: {
+    collection: CollectionDef;
+    draft: CmsDocument;
+    field: string;
+    locale: Locale;
+    lift: CanvasLift;
+    lookupManifest: PropFieldLookup;
+    /** The focused canvas inspector control, if focus is on one. */
+    focused: CanvasControl | undefined;
+    committer: DraftCommitter;
+    /** The draft takes the canvas's write (before it is routed — a forced commit reads it). */
+    apply: (next: CmsDocument) => void;
+    commit?: (patches: readonly DocumentPatch[], bases: readonly (number | undefined)[]) => void;
+}): 'deferred' | 'committed' | 'draft' | 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
@@ -87,6 +175,13 @@ export declare function canvasFieldChange(previous: CmsDocument, next: CmsDocume
 export declare function presenceReaderNow(entries: readonly PresenceEntry[], sessionId: string, fallback: string): string;
 export interface DocumentDraft {
     draft: CmsDocument;
+    /**
+     * EC-647 — the revision of the session view the draft was last rebased onto (see
+     * {@link DraftView}): a writer that authors from {@link draft} (the translation) writes
+     * at this revision. EC-667: the view's WHOLE-DOCUMENT token — the earliest authoring
+     * revision of any position it shows (a field's own edit reads its position's token).
+     */
+    revision: number | undefined;
     /** Uncommitted (document model) / unsaved (record model) edits exist. */
     dirty: boolean;
     /** The record model: the editor renders a Save button + navigation guard. */
@@ -96,12 +191,14 @@ export interface DocumentDraft {
     /** 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). `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).
+     * The canvas emitted a new value for its field (node patches, committed at once). The
+     * lift's `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); its `revision` is the revision that value was agreed at — the revision the
+     * edit is committed at (EC-647, {@link canvasCommit}).
      */
-    setCanvasValue(field: FieldDef, value: unknown, base: unknown): void;
+    setCanvasValue(field: FieldDef, lift: CanvasLift): 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. */

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

@@ -47,6 +47,51 @@ export const documentVisibility = {
         return () => document.removeEventListener('visibilitychange', listener);
     },
 };
+/** EC-667 — the draft of a session view as it is shown (pure): its value, its whole-document token, the view itself. */
+export function sessionDraftView(doc, tokens) {
+    return { document: doc, revision: tokens?.revisionOfView(doc), shown: doc };
+}
+/**
+ * EC-667 — the base an edit of `path` that STARTS now on `draft` is authored against
+ * (pure; the committer captures it at the first keystroke): the revision the content at
+ * that position of the shown session view was authored against — under a pending
+ * whole-document snapshot the snapshot's revision, under a pending own write that write's
+ * base — never the revision of a row adopted underneath it. Captured at the start, it
+ * survives the pending write's refusal or failure (looking it up when the commit arrives
+ * would be too late). Without a view token: the draft's whole-document revision.
+ */
+export function positionBase(draft, path, tokens) {
+    return tokens && draft.shown ? tokens.revisionOfView(draft.shown, path) : draft.revision;
+}
+/**
+ * THE draft rebase as one value (pure — what the editor runs when the session's document
+ * changes): the session view with the uncommitted positions laid over it ({@link
+ * rebaseDraft}), its whole-document token, the view itself (EC-647 → EC-667: the rebase
+ * moves the value AND its tokens), and — when the screen has a canvas — the token of the
+ * canvas field's position, which the canvas's next edit is authored at.
+ */
+export function rebaseDraftView(doc, previous, uncommitted, tokens, canvasPath) {
+    return {
+        view: { document: rebaseDraft(doc, previous.document, uncommitted), revision: tokens.revisionOfView(doc), shown: doc },
+        canvasRevision: canvasPath ? tokens.revisionOfView(doc, canvasPath) : undefined,
+    };
+}
+/**
+ * EC-647 — the slot alias write (pure): the draft with `alias` set (or removed), written
+ * whole AT THE DRAFT'S REVISION — never the session's tracked one, which may already hold
+ * a colleague's change the draft has not absorbed (Codex F10). There is no identity-
+ * metadata operation for the alias (the value-position grammar has no position for it,
+ * measured on the base), so it stays a whole-document `replace` with its precondition.
+ */
+export function aliasWrite(draft, alias, writes) {
+    const next = { ...draft.document };
+    if (alias === undefined)
+        delete next.alias;
+    else
+        next.alias = alias;
+    writes.replace(next, draft.revision);
+    return next;
+}
 /** The patch that writes the value `doc` holds at `path` (unset when absent). */
 export function positionPatch(doc, path) {
     const value = readValueAt(doc, path);
@@ -87,11 +132,61 @@ export function canvasWrite(input) {
  * 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.
+ *
+ * EC-647: it carries `revision`, the revision the draft is at after the rebase, and is
+ * reported when only THAT moved too (`from` ≡ `to`): the canvas's agreed value is valid
+ * at the newer revision, so its next edit is authored there — the revision follows the
+ * value, never runs ahead of it.
+ *
+ * EC-667: `revision` is the token of the canvas FIELD's position in the shown view
+ * ({@link rebaseDraftView}) — under a pending snapshot the snapshot's revision. The canvas
+ * mounts at the draft's whole-document token (the earliest, possibly earlier than its
+ * field's), so the first rebase with a token reports it even when nothing moved.
  */
-export function canvasFieldChange(previous, next, path, last) {
+export function canvasFieldChange(previous, next, path, last, revision) {
     const from = readValueAt(previous, path);
     const to = readValueAt(next, path);
-    return semanticValueEqual(from, to) ? undefined : { from, to, seq: (last?.seq ?? 0) + 1 };
+    const tokenHeld = last === undefined ? revision === undefined : last.revision === revision;
+    if (semanticValueEqual(from, to) && tokenHeld)
+        return undefined;
+    return { from, to, seq: (last?.seq ?? 0) + 1, revision };
+}
+/**
+ * EC-647 — the canvas's write path (pure; what {@link DocumentDraft.setCanvasValue} runs):
+ * the canvas writer's delta into the draft ({@link canvasWrite}, handed to `apply`), then
+ * routed ({@link routeCanvasWrite}) — committed at once, or held as a focused inspector
+ * control's uncommitted position — and in both cases paired with the revision of the
+ * canvas value the edit was authored on (`lift.revision`), never the draft's: the draft
+ * may already hold a colleague's change the canvas has not been rebased onto (Codex F12),
+ * and the store must check the edit from the canvas's revision to refuse it where it
+ * overlaps that change. `commit` absent → a draft without a revisioned write model (the
+ * draft moves, nothing is committed). `undefined` when the canvas changed nothing.
+ */
+export function canvasCommit(input) {
+    const { lift, commit } = input;
+    const write = canvasWrite({
+        collection: input.collection,
+        draft: input.draft,
+        field: input.field,
+        locale: input.locale,
+        value: lift.value,
+        base: lift.base,
+        lookupManifest: input.lookupManifest,
+    });
+    if (!write)
+        return undefined;
+    input.apply(write.next);
+    if (!commit)
+        return 'draft';
+    // 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.
+    return routeCanvasWrite({
+        patches: write.patches,
+        focused: input.focused,
+        committer: input.committer,
+        revision: lift.revision,
+        commitNow: (patches) => commit(patches, patches.map(() => lift.revision)),
+    });
 }
 /**
  * The reader's "now" for presence liveness: THIS session's own latest heartbeat `at`
@@ -118,18 +213,23 @@ export function useDocumentDraft(input) {
     const writes = source.writes;
     const documentModel = writes.kind === 'document' ? writes : undefined;
     const ref = useMemo(() => ({ collection: doc.collection, id: doc.id }), [doc.collection, doc.id]);
-    const [draft, setDraftState] = useState(doc);
-    const draftRef = useRef(draft);
+    // EC-647: the draft and the revision of the view it rebased onto travel as ONE value
+    // (EC-667: with the view itself — the per-position token).
+    const [view, setViewState] = useState(() => sessionDraftView(doc, documentModel));
+    const draft = view.document;
+    const draftRef = useRef(view);
     // EC-616: the record as the editor opened it (or as of their last successful save) — the
     // BASE a record rail diffs a save against, so it writes only the editor's changes. It moves
     // only while the draft equals the source's value (at open, and once a save is reflected
     // back): another writer's change arriving mid-edit never becomes the editor's base.
     const baseRef = useRef(doc);
-    baseRef.current = recordSaveBase(baseRef.current, draftRef.current, doc);
-    const setDraft = useCallback((next) => {
+    baseRef.current = recordSaveBase(baseRef.current, draftRef.current.document, doc);
+    const setView = useCallback((next) => {
         draftRef.current = next;
-        setDraftState(next);
+        setViewState(next);
     }, []);
+    /** An edit of the draft: its value moves, the tokens it is authored against do not. */
+    const setDraft = useCallback((next) => setView({ ...draftRef.current, document: next }), [setView]);
     const scheduler = input.scheduler ?? browserScheduler;
     const now = input.now ?? (() => new Date().toISOString());
     const fieldsByName = useMemo(() => new Map(collection.fields.map((f) => [f.name, f])), [collection]);
@@ -149,9 +249,14 @@ export function useDocumentDraft(input) {
             const target = writesRef.current;
             if (!target)
                 return;
-            void target.commit(ref, positions.map((position) => positionPatch(draftRef.current, position.path)), positions.map((position) => position.base));
+            void target.commit(ref, positions.map((position) => positionPatch(draftRef.current.document, position.path)), positions.map((position) => position.base));
         },
-        baseOf: () => writesRef.current?.revisionOf(ref),
+        // EC-647: a position's base is the revision of the DRAFT its first keystroke was
+        // made on — never the session's tracked revision, which may already hold a
+        // colleague's change the draft has not rebased onto yet. EC-667: the form's
+        // writers name the POSITION's token ({@link positionBase}, passed to `edited`);
+        // this whole-document token (the earliest) is the fallback.
+        baseOf: () => draftRef.current.revision,
         scheduler,
     }), 
     // One committer per open document (the editor is keyed by it).
@@ -178,63 +283,71 @@ export function useDocumentDraft(input) {
         }
         if (!documentModel)
             return;
-        const previous = draftRef.current;
-        const next = rebaseDraft(doc, previous, committer.uncommitted());
-        setDraft(next);
+        const previous = draftRef.current.document;
+        // EC-647: the rebase moves the value AND the revision — the session view's own
+        // (EC-667: its tokens, whole-document and per position).
+        const { view: next, canvasRevision } = rebaseDraftView(doc, draftRef.current, committer.uncommitted(), documentModel, canvasPath);
+        setView(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).
+        // committed, and the draft overlays every position it has not). EC-647: the change
+        // carries the revision — EC-667: the canvas FIELD's token — so the canvas's next edit
+        // is authored where its value is.
         if (!canvasPath)
             return;
-        setCanvasChange((last) => canvasFieldChange(previous, next, canvasPath, last) ?? last);
+        setCanvasChange((last) => canvasFieldChange(previous, next.document, canvasPath, last, canvasRevision) ?? last);
     }, [doc]);
     // --- Writers ----------------------------------------------------------------------------
     const setFieldValue = useCallback((field, value) => {
-        const next = writeField(collection, draftRef.current, field.name, locale, value, { lookupManifest });
+        // EC-667: the position's token is read BEFORE the draft moves — from the view this
+        // keystroke was made on (a re-edit keeps its first keystroke's either way).
+        const path = fieldPositionPath(collection, field.name, locale);
+        const authored = { base: positionBase(draftRef.current, path, documentModel) };
+        const next = writeField(collection, draftRef.current.document, field.name, locale, value, { lookupManifest });
         setDraft(next);
         if (documentModel)
-            committer.edited(field.name, fieldPositionPath(collection, field.name, locale));
+            committer.edited(field.name, path, authored);
     }, [collection, locale, lookupManifest, setDraft, documentModel, committer]);
     const editField = useCallback((field, update) => {
-        setDraft(update(draftRef.current));
+        const path = fieldPositionPath(collection, field.name, locale);
+        const authored = { base: positionBase(draftRef.current, path, documentModel) };
+        setDraft(update(draftRef.current.document));
         if (documentModel)
-            committer.edited(field.name, fieldPositionPath(collection, field.name, locale));
+            committer.edited(field.name, path, authored);
     }, [collection, locale, setDraft, documentModel, committer]);
-    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;
-        // 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 setCanvasValue = useCallback((field, lift) => {
         const focus = committer.focusedField();
-        routeCanvasWrite({
-            patches: write.patches,
+        canvasCommit({
+            collection,
+            draft: draftRef.current.document,
+            field: field.name,
+            locale,
+            lift,
+            lookupManifest,
             focused: focus === undefined ? undefined : canvasControls.current.get(focus),
             committer,
-            commitNow: (patches) => void documentModel.commit(ref, patches),
+            apply: setDraft,
+            ...(documentModel
+                ? { commit: (patches, bases) => void documentModel.commit(ref, patches, bases) }
+                : {}),
         });
     }, [collection, locale, lookupManifest, setDraft, documentModel, ref, committer]);
     const setAlias = useCallback((alias) => {
-        const next = { ...draftRef.current };
-        if (alias === undefined)
-            delete next.alias;
-        else
-            next.alias = alias;
-        setDraft(next);
-        if (!documentModel)
+        if (!documentModel) {
+            aliasWrite(draftRef.current, alias, { replace: (next) => setDraft(next) });
             return;
+        }
+        // The uncommitted positions first (the snapshot holds them), then the snapshot AT
+        // THE DRAFT'S REVISION (EC-647 — Codex F10).
         committer.commitAll();
-        documentModel.replace(next);
+        setDraft(aliasWrite(draftRef.current, alias, documentModel));
     }, [setDraft, documentModel, committer]);
     // --- Forced flush ----------------------------------------------------------------------
     const save = useCallback(() => {
         if (documentModel)
             committer.commitAll();
         else if (writes.kind === 'record')
-            writes.save(draftRef.current, baseRef.current);
+            writes.save(draftRef.current.document, baseRef.current);
     }, [documentModel, committer, writes]);
     const flush = useCallback(async () => {
         save();
@@ -334,16 +447,18 @@ export function useDocumentDraft(input) {
     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);
+        const moved = canvasPath && !semanticValueEqual(readValueAt(draftRef.current.document, canvasPath), readValueAt(next, canvasPath));
+        // EC-647: the restored value comes with the revision the session showed it at.
+        setView(sessionDraftView(next, documentModel));
         if (moved)
             setCanvasNonce((n) => n + 1);
     }, 
     // The path is keyed by its string form.
-    [setDraft, canvasPathKey]);
+    [setView, documentModel, canvasPathKey]);
     const dirty = useMemo(() => !semanticValueEqual(draft, doc), [draft, doc]);
     return {
         draft,
+        revision: view.revision,
         dirty,
         explicitSave: writes.kind === 'record',
         setFieldValue,