@elytracms/studio 0.0.43 → 0.0.45

package/dist/components/cms/document-staging.js

@@ -1,41 +1,101 @@
 import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
 /**
- * EC-320 — a tiny cross-mount handoff for a freshly created document.
+ * EC-320 (0.0.44 follow-up) — a tiny cross-mount handoff for a freshly created
+ * (or freshly appended-to) document.
  *
- * The "Use in document…" transfer creates a draft in the Components view, then
- * navigates to that document's CMS editor — a FRESH `CmsProvider` mount. In
- * **Convex** mode the new provider re-hydrates from persistence (the transfer's
- * `saveDocument` already upserted it), so nothing more is needed. In the
- * **playground**, though, `CmsSessionGate` renders synchronously with `null`
- * (fixtures) and never reads back the seeded adapter, so a doc created in one
- * mount is invisible to the next.
+ * The "Use in document…" transfer creates/updates a draft in the Components
+ * view, then navigates to that document's CMS editor — a FRESH `CmsProvider`
+ * mount. That fresh mount seeds its documents from whatever hydration/kit
+ * snapshot its `CmsSessionGate` resolves, and in BOTH modes that snapshot can
+ * miss a document the transfer just wrote — for two DIFFERENT reasons:
  *
- * This module bridges exactly that gap: the transfer STAGES the built document,
- * and the next `CmsProvider` for the same project merges any staged docs into its
- * initial set (staged wins by id). It is deliberately **playground-only** — under
- * Convex, hydration is the source of truth and staging would risk shadowing a
- * newer persisted revision. Reads are non-destructive (StrictMode-safe: a double
- * mount sees the same doc both times); the buffer is session-scoped dev state.
+ * - **Playground**: `CmsSessionGate` renders synchronously with `session:
+ *   null` (the EC-138 determinism contract) — it never queries anything, so
+ *   the seeded set is always the STATIC kit/fixture baseline, forever. It
+ *   never reflects a write, on the first mount or the hundredth.
+ * - **Convex**: the seeded set comes from a REAL fresh-per-mount query
+ *   (`loadCms()`), so it usually catches up — but there is no synchronous
+ *   guarantee it observes a write from a moment earlier (belt and braces: the
+ *   transfer also AWAITS its own write landing — see `transfer-dialog.tsx` —
+ *   but staging covers the mount regardless of that timing).
+ *
+ * A previous version of this module gated `stageDocument` itself on
+ * `isPlaygroundMode()`, reasoning that Convex mode "re-hydrates from
+ * persistence" per mount and so never needs staging. That reasoning was
+ * wrong — a fresh query has no synchronous ordering guarantee against a write
+ * from moments earlier — and the gate was exactly why the Convex-mode
+ * transfer 404'd (EC-320 follow-up finding). Staging now runs in every mode.
+ *
+ * The two modes DO still genuinely differ on the read side, though — not by a
+ * wrong assumption this time, but structurally:
+ *
+ * - Playground's seeded set can NEVER be "fresher" than a staged write (it
+ *   never changes at all), so a staged entry always wins over it — exactly
+ *   the original, working behavior, now also covering "insert into an
+ *   EXISTING document" (whose key was already in the static baseline before
+ *   the edit — the append would otherwise be invisible).
+ * - Convex's seeded set is a genuine live signal, so a staged entry only
+ *   fills a GAP it doesn't already carry; once it does, the seeded set wins
+ *   outright (the newer-or-equal persisted truth) and the stale staged entry
+ *   is dropped — so it can never resurrect on a later mount and shadow a
+ *   revision made after the transfer (e.g. a subsequent edit, once persisted
+ *   and re-hydrated).
+ *
+ * Reads that don't drop anything are non-destructive (StrictMode-safe: a
+ * double mount computes the identical merge both times); the buffer itself is
+ * in-memory, session-scoped runtime state — never persisted, never a
+ * substitute for the real write.
  */
 const staged = new Map();
 function docKey(doc) {
     return `${doc.collection}/${doc.id}`;
 }
-/** Stage a document for the next `CmsProvider` mount of `projectId` (playground only). */
+/** Stage a document for the next `CmsProvider` mount of `projectId` (any mode). */
 export function stageDocument(projectId, doc) {
-    if (!isPlaygroundMode())
-        return;
     const list = staged.get(projectId) ?? [];
     // Replace any prior staging of the same doc key so a re-transfer wins.
     const next = list.filter((d) => docKey(d) !== docKey(doc));
     next.push(doc);
     staged.set(projectId, next);
 }
-/** The documents staged for `projectId` (a copy; non-destructive). */
-export function stagedDocuments(projectId) {
+/**
+ * Merge any documents staged for `projectId` into a fresh mount's
+ * seeded/hydrated document list. See the module doc for why the merge rule
+ * itself is mode-aware (playground: staged always wins; Convex: staged fills
+ * gaps only, dropped once superseded).
+ */
+export function consumeStagedDocuments(projectId, seeded) {
     if (projectId === undefined)
-        return [];
-    return (staged.get(projectId) ?? []).map((d) => structuredClone(d));
+        return [...seeded];
+    const list = staged.get(projectId);
+    if (!list || list.length === 0)
+        return [...seeded];
+    if (isPlaygroundMode()) {
+        // The seeded set is a static kit/fixture baseline that never reflects a
+        // write on its own — a staged doc always wins for its key, matching the
+        // ONLY mechanism that ever represents a live edit across mounts here.
+        const byKey = new Map(seeded.map((d) => [docKey(d), d]));
+        for (const d of list)
+            byKey.set(docKey(d), structuredClone(d));
+        return [...byKey.values()];
+    }
+    // Convex: `seeded` is a fresh per-mount hydration query — a real signal of
+    // the current persisted truth. A staged doc only fills a gap that snapshot
+    // doesn't already carry; a key it DOES carry is superseded and dropped from
+    // the buffer so it can never resurrect on a later mount.
+    const seededKeys = new Set(seeded.map(docKey));
+    const superseded = list.filter((d) => seededKeys.has(docKey(d)));
+    if (superseded.length > 0) {
+        const remaining = list.filter((d) => !superseded.some((s) => docKey(s) === docKey(d)));
+        if (remaining.length > 0)
+            staged.set(projectId, remaining);
+        else
+            staged.delete(projectId);
+    }
+    const gap = list.filter((d) => !seededKeys.has(docKey(d)));
+    if (gap.length === 0)
+        return [...seeded];
+    return [...seeded, ...gap.map((d) => structuredClone(d))];
 }
 /** Test seam: drop all staged documents. */
 export function clearStagedDocuments() {

package/dist/components/cms/document-staging.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-staging.js","sourceRoot":"","sources":["../../../src/components/cms/document-staging.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAA;AAE/C,SAAS,MAAM,CAAC,GAAgB;IAC9B,OAAO,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,EAAE,CAAA;AACtC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,GAAgB;IAC/D,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAM;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;IACxC,uEAAuE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACd,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AAC7B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,SAA6B;IAC3D,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,oBAAoB;IAClC,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC","sourcesContent":["import type { CmsDocument } from '@elytracms/core/cms-core'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\n\n/**\n * EC-320 — a tiny cross-mount handoff for a freshly created document.\n *\n * The \"Use in document…\" transfer creates a draft in the Components view, then\n * navigates to that document's CMS editor — a FRESH `CmsProvider` mount. In\n * **Convex** mode the new provider re-hydrates from persistence (the transfer's\n * `saveDocument` already upserted it), so nothing more is needed. In the\n * **playground**, though, `CmsSessionGate` renders synchronously with `null`\n * (fixtures) and never reads back the seeded adapter, so a doc created in one\n * mount is invisible to the next.\n *\n * This module bridges exactly that gap: the transfer STAGES the built document,\n * and the next `CmsProvider` for the same project merges any staged docs into its\n * initial set (staged wins by id). It is deliberately **playground-only** — under\n * Convex, hydration is the source of truth and staging would risk shadowing a\n * newer persisted revision. Reads are non-destructive (StrictMode-safe: a double\n * mount sees the same doc both times); the buffer is session-scoped dev state.\n */\n\nconst staged = new Map<string, CmsDocument[]>()\n\nfunction docKey(doc: CmsDocument): string {\n  return `${doc.collection}/${doc.id}`\n}\n\n/** Stage a document for the next `CmsProvider` mount of `projectId` (playground only). */\nexport function stageDocument(projectId: string, doc: CmsDocument): void {\n  if (!isPlaygroundMode()) return\n  const list = staged.get(projectId) ?? []\n  // Replace any prior staging of the same doc key so a re-transfer wins.\n  const next = list.filter((d) => docKey(d) !== docKey(doc))\n  next.push(doc)\n  staged.set(projectId, next)\n}\n\n/** The documents staged for `projectId` (a copy; non-destructive). */\nexport function stagedDocuments(projectId: string | undefined): CmsDocument[] {\n  if (projectId === undefined) return []\n  return (staged.get(projectId) ?? []).map((d) => structuredClone(d))\n}\n\n/** Test seam: drop all staged documents. */\nexport function clearStagedDocuments(): void {\n  staged.clear()\n}\n"]}
+{"version":3,"file":"document-staging.js","sourceRoot":"","sources":["../../../src/components/cms/document-staging.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CmsDocument } from '@elytracms/core/cms-core'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\n\n/**\n * EC-320 (0.0.44 follow-up) — a tiny cross-mount handoff for a freshly created\n * (or freshly appended-to) document.\n *\n * The \"Use in document…\" transfer creates/updates a draft in the Components\n * view, then navigates to that document's CMS editor — a FRESH `CmsProvider`\n * mount. That fresh mount seeds its documents from whatever hydration/kit\n * snapshot its `CmsSessionGate` resolves, and in BOTH modes that snapshot can\n * miss a document the transfer just wrote — for two DIFFERENT reasons:\n *\n * - **Playground**: `CmsSessionGate` renders synchronously with `session:\n *   null` (the EC-138 determinism contract) — it never queries anything, so\n *   the seeded set is always the STATIC kit/fixture baseline, forever. It\n *   never reflects a write, on the first mount or the hundredth.\n * - **Convex**: the seeded set comes from a REAL fresh-per-mount query\n *   (`loadCms()`), so it usually catches up — but there is no synchronous\n *   guarantee it observes a write from a moment earlier (belt and braces: the\n *   transfer also AWAITS its own write landing — see `transfer-dialog.tsx` —\n *   but staging covers the mount regardless of that timing).\n *\n * A previous version of this module gated `stageDocument` itself on\n * `isPlaygroundMode()`, reasoning that Convex mode \"re-hydrates from\n * persistence\" per mount and so never needs staging. That reasoning was\n * wrong — a fresh query has no synchronous ordering guarantee against a write\n * from moments earlier — and the gate was exactly why the Convex-mode\n * transfer 404'd (EC-320 follow-up finding). Staging now runs in every mode.\n *\n * The two modes DO still genuinely differ on the read side, though — not by a\n * wrong assumption this time, but structurally:\n *\n * - Playground's seeded set can NEVER be \"fresher\" than a staged write (it\n *   never changes at all), so a staged entry always wins over it — exactly\n *   the original, working behavior, now also covering \"insert into an\n *   EXISTING document\" (whose key was already in the static baseline before\n *   the edit — the append would otherwise be invisible).\n * - Convex's seeded set is a genuine live signal, so a staged entry only\n *   fills a GAP it doesn't already carry; once it does, the seeded set wins\n *   outright (the newer-or-equal persisted truth) and the stale staged entry\n *   is dropped — so it can never resurrect on a later mount and shadow a\n *   revision made after the transfer (e.g. a subsequent edit, once persisted\n *   and re-hydrated).\n *\n * Reads that don't drop anything are non-destructive (StrictMode-safe: a\n * double mount computes the identical merge both times); the buffer itself is\n * in-memory, session-scoped runtime state — never persisted, never a\n * substitute for the real write.\n */\n\nconst staged = new Map<string, CmsDocument[]>()\n\nfunction docKey(doc: CmsDocument): string {\n  return `${doc.collection}/${doc.id}`\n}\n\n/** Stage a document for the next `CmsProvider` mount of `projectId` (any mode). */\nexport function stageDocument(projectId: string, doc: CmsDocument): void {\n  const list = staged.get(projectId) ?? []\n  // Replace any prior staging of the same doc key so a re-transfer wins.\n  const next = list.filter((d) => docKey(d) !== docKey(doc))\n  next.push(doc)\n  staged.set(projectId, next)\n}\n\n/**\n * Merge any documents staged for `projectId` into a fresh mount's\n * seeded/hydrated document list. See the module doc for why the merge rule\n * itself is mode-aware (playground: staged always wins; Convex: staged fills\n * gaps only, dropped once superseded).\n */\nexport function consumeStagedDocuments(\n  projectId: string | undefined,\n  seeded: readonly CmsDocument[],\n): CmsDocument[] {\n  if (projectId === undefined) return [...seeded]\n  const list = staged.get(projectId)\n  if (!list || list.length === 0) return [...seeded]\n\n  if (isPlaygroundMode()) {\n    // The seeded set is a static kit/fixture baseline that never reflects a\n    // write on its own — a staged doc always wins for its key, matching the\n    // ONLY mechanism that ever represents a live edit across mounts here.\n    const byKey = new Map(seeded.map((d) => [docKey(d), d]))\n    for (const d of list) byKey.set(docKey(d), structuredClone(d))\n    return [...byKey.values()]\n  }\n\n  // Convex: `seeded` is a fresh per-mount hydration query — a real signal of\n  // the current persisted truth. A staged doc only fills a gap that snapshot\n  // doesn't already carry; a key it DOES carry is superseded and dropped from\n  // the buffer so it can never resurrect on a later mount.\n  const seededKeys = new Set(seeded.map(docKey))\n  const superseded = list.filter((d) => seededKeys.has(docKey(d)))\n  if (superseded.length > 0) {\n    const remaining = list.filter((d) => !superseded.some((s) => docKey(s) === docKey(d)))\n    if (remaining.length > 0) staged.set(projectId, remaining)\n    else staged.delete(projectId)\n  }\n\n  const gap = list.filter((d) => !seededKeys.has(docKey(d)))\n  if (gap.length === 0) return [...seeded]\n  return [...seeded, ...gap.map((d) => structuredClone(d))]\n}\n\n/** Test seam: drop all staged documents. */\nexport function clearStagedDocuments(): void {\n  staged.clear()\n}\n"]}

package/dist/components/cms/use-compare-selection.d.ts

@@ -0,0 +1,27 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { CompareState } from './document-editor-context';
+export interface CompareSelection {
+    /** The open version comparison, or null when none (the sticky Compare tab). */
+    compare: CompareState | null;
+    /** Open (or refocus) the Compare tab with `base` vs the current draft. */
+    startCompare: (base: number) => void;
+    /** Change which recorded version is the (older) base side. */
+    setCompareBase: (base: number) => void;
+    /** Change what the base is compared against (a version, or the live draft). */
+    setCompareTarget: (target: number | 'draft') => void;
+    /** Leave compare mode, back to the first content tab. */
+    exitCompare: () => void;
+}
+/**
+ * EC-298 — the version-compare selection. The Compare tab is STICKY: opening it
+ * sets the selection, focuses the tab and the Versions pane; tabbing to the real
+ * fields keeps the comparison open (the selection persists) so an editor can flip
+ * between diff and fields; only its ✕ closes it. Owns the selection; the tab focus
+ * and the inspector pane it drives are threaded in from the editor shell.
+ */
+export declare function useCompareSelection(input: {
+    tabs: string[];
+    compareTab: string;
+    setActiveTab: Dispatch<SetStateAction<string>>;
+    setInspectorPaneId: (id: string | undefined) => void;
+}): CompareSelection;

package/dist/components/cms/use-compare-selection.js

@@ -0,0 +1,29 @@
+import { useCallback, useState } from 'react';
+/**
+ * EC-298 — the version-compare selection. The Compare tab is STICKY: opening it
+ * sets the selection, focuses the tab and the Versions pane; tabbing to the real
+ * fields keeps the comparison open (the selection persists) so an editor can flip
+ * between diff and fields; only its ✕ closes it. Owns the selection; the tab focus
+ * and the inspector pane it drives are threaded in from the editor shell.
+ */
+export function useCompareSelection(input) {
+    const { tabs, compareTab, setActiveTab, setInspectorPaneId } = input;
+    const [compare, setCompare] = useState(null);
+    const startCompare = useCallback((base) => {
+        setCompare({ base, target: 'draft' });
+        setActiveTab(compareTab);
+        setInspectorPaneId('versions');
+    }, [compareTab, setActiveTab, setInspectorPaneId]);
+    const setCompareBase = useCallback((base) => {
+        setCompare((c) => (c ? { ...c, base } : { base, target: 'draft' }));
+    }, []);
+    const setCompareTarget = useCallback((target) => {
+        setCompare((c) => (c ? { ...c, target } : c));
+    }, []);
+    const exitCompare = useCallback(() => {
+        setCompare(null);
+        setActiveTab((prev) => (prev === compareTab ? tabs[0] : prev));
+    }, [tabs, compareTab, setActiveTab]);
+    return { compare, startCompare, setCompareBase, setCompareTarget, exitCompare };
+}
+//# sourceMappingURL=use-compare-selection.js.map

package/dist/components/cms/use-compare-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-compare-selection.js","sourceRoot":"","sources":["../../../src/components/cms/use-compare-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAiB7C;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAKnC;IACC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;IACpE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAsB,IAAI,CAAC,CAAA;IACjE,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,EAAE;QACf,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;QACrC,YAAY,CAAC,UAAU,CAAC,CAAA;QACxB,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAChC,CAAC,EACD,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAC/C,CAAA;IACD,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,IAAY,EAAE,EAAE;QAClD,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IACrE,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,MAAwB,EAAE,EAAE;QAChE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACjE,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAA;IAEpC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAA;AACjF,CAAC","sourcesContent":["import { useCallback, useState } from 'react'\nimport type { Dispatch, SetStateAction } from 'react'\nimport type { CompareState } from './document-editor-context'\n\nexport interface CompareSelection {\n  /** The open version comparison, or null when none (the sticky Compare tab). */\n  compare: CompareState | null\n  /** Open (or refocus) the Compare tab with `base` vs the current draft. */\n  startCompare: (base: number) => void\n  /** Change which recorded version is the (older) base side. */\n  setCompareBase: (base: number) => void\n  /** Change what the base is compared against (a version, or the live draft). */\n  setCompareTarget: (target: number | 'draft') => void\n  /** Leave compare mode, back to the first content tab. */\n  exitCompare: () => void\n}\n\n/**\n * EC-298 — the version-compare selection. The Compare tab is STICKY: opening it\n * sets the selection, focuses the tab and the Versions pane; tabbing to the real\n * fields keeps the comparison open (the selection persists) so an editor can flip\n * between diff and fields; only its ✕ closes it. Owns the selection; the tab focus\n * and the inspector pane it drives are threaded in from the editor shell.\n */\nexport function useCompareSelection(input: {\n  tabs: string[]\n  compareTab: string\n  setActiveTab: Dispatch<SetStateAction<string>>\n  setInspectorPaneId: (id: string | undefined) => void\n}): CompareSelection {\n  const { tabs, compareTab, setActiveTab, setInspectorPaneId } = input\n  const [compare, setCompare] = useState<CompareState | null>(null)\n  const startCompare = useCallback(\n    (base: number) => {\n      setCompare({ base, target: 'draft' })\n      setActiveTab(compareTab)\n      setInspectorPaneId('versions')\n    },\n    [compareTab, setActiveTab, setInspectorPaneId],\n  )\n  const setCompareBase = useCallback((base: number) => {\n    setCompare((c) => (c ? { ...c, base } : { base, target: 'draft' }))\n  }, [])\n  const setCompareTarget = useCallback((target: number | 'draft') => {\n    setCompare((c) => (c ? { ...c, target } : c))\n  }, [])\n  const exitCompare = useCallback(() => {\n    setCompare(null)\n    setActiveTab((prev) => (prev === compareTab ? tabs[0]! : prev))\n  }, [tabs, compareTab, setActiveTab])\n\n  return { compare, startCompare, setCompareBase, setCompareTarget, exitCompare }\n}\n"]}

package/dist/components/cms/use-discard-controller.d.ts

@@ -0,0 +1,44 @@
+import type { QueryKey } from '@tanstack/react-query';
+import type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core';
+import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+import type { DiscardDraftStatus } from './discard-draft';
+export interface DiscardController {
+    status: DiscardDraftStatus;
+    /** The hint shown when the item is disabled (view-read-only / up-to-date / loading). */
+    disabledReason: string | undefined;
+    /** Is the confirmation dialog open? */
+    confirmOpen: boolean;
+    setConfirmOpen: (open: boolean) => void;
+    /** Is a discard restore round-tripping (gates the dialog buttons)? */
+    busy: boolean;
+    /** Confirm the discard: flush → restore the pinned published version whole. */
+    discard: () => Promise<void>;
+}
+/**
+ * EC-316 / EC-325 — the "Discard changes" controller. Reverting the draft to the
+ * published content IS a whole-document restore of the pinned published version,
+ * so it routes through the SAME shared restore sequence
+ * ({@link useRestoreVersion}) the Compare view's and Versions pane's restores use
+ * — never a parallel write path. That sequence flushes a dirty in-memory buffer
+ * FIRST (`documents.restore` snapshots whatever is currently PERSISTED), closing
+ * the undo-guarantee gap the header's discard used to have.
+ *
+ * The enablement is the pure `discardDraftStatus` decision (tested in
+ * `discard-draft.test.ts`); its semantic-equality edge is the SAME comparator the
+ * Versions pane's publish gate uses, so the two never contradict (EC-298).
+ */
+export declare function useDiscardController(input: {
+    canDiscard: boolean;
+    published: boolean;
+    viewReadOnly: boolean;
+    publishedSnapshotDoc: CmsDocument | undefined;
+    publishedVersionNumber: number | undefined;
+    versionKey: QueryKey;
+    collection: CollectionDef;
+    draft: CmsDocument;
+    source: CollectionViewSource;
+    docRef: DocumentRef;
+    replaceDraft: (doc: CmsDocument) => void;
+    dirty: boolean;
+    save: () => void;
+}): DiscardController;

package/dist/components/cms/use-discard-controller.js

@@ -0,0 +1,51 @@
+import { useCallback, useState } from 'react';
+import { translate } from '@elytracms/studio/lib/i18n';
+import { discardDraftStatus } from './discard-draft';
+import { useRestoreVersion } from './use-restore-version';
+/**
+ * EC-316 / EC-325 — the "Discard changes" controller. Reverting the draft to the
+ * published content IS a whole-document restore of the pinned published version,
+ * so it routes through the SAME shared restore sequence
+ * ({@link useRestoreVersion}) the Compare view's and Versions pane's restores use
+ * — never a parallel write path. That sequence flushes a dirty in-memory buffer
+ * FIRST (`documents.restore` snapshots whatever is currently PERSISTED), closing
+ * the undo-guarantee gap the header's discard used to have.
+ *
+ * The enablement is the pure `discardDraftStatus` decision (tested in
+ * `discard-draft.test.ts`); its semantic-equality edge is the SAME comparator the
+ * Versions pane's publish gate uses, so the two never contradict (EC-298).
+ */
+export function useDiscardController(input) {
+    const { canDiscard, published, viewReadOnly, publishedSnapshotDoc, publishedVersionNumber, versionKey, collection, draft, source, docRef, replaceDraft, dirty, save, } = input;
+    const [confirmOpen, setConfirmOpen] = useState(false);
+    const { restore, busy } = useRestoreVersion({ source, docRef, versionKey, dirty, save, replaceDraft });
+    const status = discardDraftStatus({
+        canDiscard,
+        published,
+        viewReadOnly,
+        publishedSnapshot: publishedSnapshotDoc,
+        collection,
+        draft,
+    });
+    const disabledReason = status === 'view-read-only'
+        ? translate('cms.editor.switchToDraftToDiscard')
+        : status === 'up-to-date'
+            ? translate('cms.editor.discardDraftUpToDateHint')
+            : status === 'loading'
+                ? translate('common.loading')
+                : undefined;
+    const discard = useCallback(async () => {
+        if (publishedVersionNumber === undefined)
+            return;
+        try {
+            // Whole-document restore of the pinned published version (the shared helper
+            // flushes any dirty buffer first, mirroring the Versions pane / Compare view).
+            await restore(publishedVersionNumber, { kind: 'all' });
+        }
+        finally {
+            setConfirmOpen(false);
+        }
+    }, [publishedVersionNumber, restore]);
+    return { status, disabledReason, confirmOpen, setConfirmOpen, busy, discard };
+}
+//# sourceMappingURL=use-discard-controller.js.map

package/dist/components/cms/use-discard-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-discard-controller.js","sourceRoot":"","sources":["../../../src/components/cms/use-discard-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAI7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAezD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAcpC;IACC,MAAM,EACJ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,EACZ,KAAK,EACL,IAAI,GACL,GAAG,KAAK,CAAA;IAET,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;IAEtG,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,UAAU;QACV,SAAS;QACT,YAAY;QACZ,iBAAiB,EAAE,oBAAoB;QACvC,UAAU;QACV,KAAK;KACN,CAAC,CAAA;IACF,MAAM,cAAc,GAClB,MAAM,KAAK,gBAAgB;QACzB,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC;QAChD,CAAC,CAAC,MAAM,KAAK,YAAY;YACvB,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC;YAClD,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC;gBAC7B,CAAC,CAAC,SAAS,CAAA;IAEnB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,sBAAsB,KAAK,SAAS;YAAE,OAAM;QAChD,IAAI,CAAC;YACH,4EAA4E;YAC5E,+EAA+E;YAC/E,MAAM,OAAO,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACxD,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;IACH,CAAC,EAAE,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAA;IAErC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC/E,CAAC","sourcesContent":["import { useCallback, useState } from 'react'\nimport type { QueryKey } from '@tanstack/react-query'\nimport type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { discardDraftStatus } from './discard-draft'\nimport type { DiscardDraftStatus } from './discard-draft'\nimport { useRestoreVersion } from './use-restore-version'\n\nexport interface DiscardController {\n  status: DiscardDraftStatus\n  /** The hint shown when the item is disabled (view-read-only / up-to-date / loading). */\n  disabledReason: string | undefined\n  /** Is the confirmation dialog open? */\n  confirmOpen: boolean\n  setConfirmOpen: (open: boolean) => void\n  /** Is a discard restore round-tripping (gates the dialog buttons)? */\n  busy: boolean\n  /** Confirm the discard: flush → restore the pinned published version whole. */\n  discard: () => Promise<void>\n}\n\n/**\n * EC-316 / EC-325 — the \"Discard changes\" controller. Reverting the draft to the\n * published content IS a whole-document restore of the pinned published version,\n * so it routes through the SAME shared restore sequence\n * ({@link useRestoreVersion}) the Compare view's and Versions pane's restores use\n * — never a parallel write path. That sequence flushes a dirty in-memory buffer\n * FIRST (`documents.restore` snapshots whatever is currently PERSISTED), closing\n * the undo-guarantee gap the header's discard used to have.\n *\n * The enablement is the pure `discardDraftStatus` decision (tested in\n * `discard-draft.test.ts`); its semantic-equality edge is the SAME comparator the\n * Versions pane's publish gate uses, so the two never contradict (EC-298).\n */\nexport function useDiscardController(input: {\n  canDiscard: boolean\n  published: boolean\n  viewReadOnly: boolean\n  publishedSnapshotDoc: CmsDocument | undefined\n  publishedVersionNumber: number | undefined\n  versionKey: QueryKey\n  collection: CollectionDef\n  draft: CmsDocument\n  source: CollectionViewSource\n  docRef: DocumentRef\n  replaceDraft: (doc: CmsDocument) => void\n  dirty: boolean\n  save: () => void\n}): DiscardController {\n  const {\n    canDiscard,\n    published,\n    viewReadOnly,\n    publishedSnapshotDoc,\n    publishedVersionNumber,\n    versionKey,\n    collection,\n    draft,\n    source,\n    docRef,\n    replaceDraft,\n    dirty,\n    save,\n  } = input\n\n  const [confirmOpen, setConfirmOpen] = useState(false)\n  const { restore, busy } = useRestoreVersion({ source, docRef, versionKey, dirty, save, replaceDraft })\n\n  const status = discardDraftStatus({\n    canDiscard,\n    published,\n    viewReadOnly,\n    publishedSnapshot: publishedSnapshotDoc,\n    collection,\n    draft,\n  })\n  const disabledReason =\n    status === 'view-read-only'\n      ? translate('cms.editor.switchToDraftToDiscard')\n      : status === 'up-to-date'\n        ? translate('cms.editor.discardDraftUpToDateHint')\n        : status === 'loading'\n          ? translate('common.loading')\n          : undefined\n\n  const discard = useCallback(async () => {\n    if (publishedVersionNumber === undefined) return\n    try {\n      // Whole-document restore of the pinned published version (the shared helper\n      // flushes any dirty buffer first, mirroring the Versions pane / Compare view).\n      await restore(publishedVersionNumber, { kind: 'all' })\n    } finally {\n      setConfirmOpen(false)\n    }\n  }, [publishedVersionNumber, restore])\n\n  return { status, disabledReason, confirmOpen, setConfirmOpen, busy, discard }\n}\n"]}

package/dist/components/cms/use-embed-inspector-host.d.ts

@@ -0,0 +1,12 @@
+import type { EmbedInspectorApi, EmbedInspectorPayload } from './rich-text/embed-inspector-context';
+/**
+ * 0.0.41 — the selection-driven embed-inspector host. A `componentEmbed` node
+ * selection in a rich-text field swaps the inspector sidebar for the embed's prop
+ * form; deselect returns the normal inspector. `clearActiveEmbed` keys on the node
+ * id so a fast A→B reselect can't let A's deselect wipe B (the selection race). Fed
+ * by the rich-text field through the EmbedInspector context (the returned api).
+ */
+export declare function useEmbedInspectorHost(): {
+    activeEmbed: EmbedInspectorPayload | null;
+    embedInspectorApi: EmbedInspectorApi;
+};

package/dist/components/cms/use-embed-inspector-host.js

@@ -0,0 +1,17 @@
+import { useMemo, useState } from 'react';
+/**
+ * 0.0.41 — the selection-driven embed-inspector host. A `componentEmbed` node
+ * selection in a rich-text field swaps the inspector sidebar for the embed's prop
+ * form; deselect returns the normal inspector. `clearActiveEmbed` keys on the node
+ * id so a fast A→B reselect can't let A's deselect wipe B (the selection race). Fed
+ * by the rich-text field through the EmbedInspector context (the returned api).
+ */
+export function useEmbedInspectorHost() {
+    const [activeEmbed, setActiveEmbed] = useState(null);
+    const embedInspectorApi = useMemo(() => ({
+        setActiveEmbed: (payload) => setActiveEmbed(payload),
+        clearActiveEmbed: (nodeId) => setActiveEmbed((prev) => (prev?.nodeId === nodeId ? null : prev)),
+    }), []);
+    return { activeEmbed, embedInspectorApi };
+}
+//# sourceMappingURL=use-embed-inspector-host.js.map

package/dist/components/cms/use-embed-inspector-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-embed-inspector-host.js","sourceRoot":"","sources":["../../../src/components/cms/use-embed-inspector-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGzC;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IAInC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA+B,IAAI,CAAC,CAAA;IAClF,MAAM,iBAAiB,GAAG,OAAO,CAC/B,GAAG,EAAE,CAAC,CAAC;QACL,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC;QACpD,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAChG,CAAC,EACF,EAAE,CACH,CAAA;IACD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAA;AAC3C,CAAC","sourcesContent":["import { useMemo, useState } from 'react'\nimport type { EmbedInspectorApi, EmbedInspectorPayload } from './rich-text/embed-inspector-context'\n\n/**\n * 0.0.41 — the selection-driven embed-inspector host. A `componentEmbed` node\n * selection in a rich-text field swaps the inspector sidebar for the embed's prop\n * form; deselect returns the normal inspector. `clearActiveEmbed` keys on the node\n * id so a fast A→B reselect can't let A's deselect wipe B (the selection race). Fed\n * by the rich-text field through the EmbedInspector context (the returned api).\n */\nexport function useEmbedInspectorHost(): {\n  activeEmbed: EmbedInspectorPayload | null\n  embedInspectorApi: EmbedInspectorApi\n} {\n  const [activeEmbed, setActiveEmbed] = useState<EmbedInspectorPayload | null>(null)\n  const embedInspectorApi = useMemo<EmbedInspectorApi>(\n    () => ({\n      setActiveEmbed: (payload) => setActiveEmbed(payload),\n      clearActiveEmbed: (nodeId) => setActiveEmbed((prev) => (prev?.nodeId === nodeId ? null : prev)),\n    }),\n    [],\n  )\n  return { activeEmbed, embedInspectorApi }\n}\n"]}

package/dist/components/cms/use-field-focus.d.ts

@@ -0,0 +1,38 @@
+import type { CollectionDef, FieldDef } from '@elytracms/core/cms-core';
+import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/**
+ * EC-283 / EC-285 — where a jump-to-field lands, as a pure decision. A field in
+ * the reserved `sidebar` group renders in the Details inspector pane (open that
+ * pane, EC-285); any other field lives on a content tab (switch to it). Returns
+ * `null` for an unknown field name (no-op). Directly testable, no DOM.
+ */
+export declare function focusTarget(collection: CollectionDef, fieldName: string): {
+    field: FieldDef;
+    paneId: 'details';
+} | {
+    field: FieldDef;
+    tab: string;
+} | null;
+export interface FieldFocus {
+    /** The field ring-highlighted right now (or null). */
+    highlightedField: string | null;
+    /** The inspector sidebar's active pane, controlled so a jump can open Details. */
+    inspectorPaneId: string | undefined;
+    setInspectorPaneId: (id: string | undefined) => void;
+    /** Focus a field by name: switch to its tab/pane (+ locale), scroll, highlight. */
+    focusField: (fieldName: string, localeHint?: string) => void;
+}
+/**
+ * EC-172 / EC-283 — the field-focus/highlight controller. Focusing a field
+ * switches to its tab (or opens the Details pane for a sidebar field) and the
+ * given locale, scrolls its control into view, and ring-highlights it briefly.
+ * Shared by the reference deep-link (`focusPath`) and the Issues pane's
+ * jump-to-field. Owns the highlight + inspector-pane state and the scroll/clear
+ * timers (cleaned up on unmount, and cleared between back-to-back jumps).
+ */
+export declare function useFieldFocus(input: {
+    collection: CollectionDef;
+    source: CollectionViewSource;
+    focusPath: string | undefined;
+    setActiveTab: (tab: string) => void;
+}): FieldFocus;

package/dist/components/cms/use-field-focus.js

@@ -0,0 +1,70 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { SIDEBAR_FIELD_GROUP, tabOrder } from '@elytracms/core/cms-core';
+import { setStudioLocale } from '@elytracms/studio/lib/locale';
+import { parseDocumentFieldPath } from '@elytracms/studio/lib/references';
+/**
+ * EC-283 / EC-285 — where a jump-to-field lands, as a pure decision. A field in
+ * the reserved `sidebar` group renders in the Details inspector pane (open that
+ * pane, EC-285); any other field lives on a content tab (switch to it). Returns
+ * `null` for an unknown field name (no-op). Directly testable, no DOM.
+ */
+export function focusTarget(collection, fieldName) {
+    const field = collection.fields.find((f) => f.name === fieldName);
+    if (!field)
+        return null;
+    if (field.form?.group === SIDEBAR_FIELD_GROUP)
+        return { field, paneId: 'details' };
+    const fieldTabs = tabOrder(collection.form);
+    return { field, tab: field.form?.tab ?? fieldTabs[0] ?? 'main' };
+}
+/**
+ * EC-172 / EC-283 — the field-focus/highlight controller. Focusing a field
+ * switches to its tab (or opens the Details pane for a sidebar field) and the
+ * given locale, scrolls its control into view, and ring-highlights it briefly.
+ * Shared by the reference deep-link (`focusPath`) and the Issues pane's
+ * jump-to-field. Owns the highlight + inspector-pane state and the scroll/clear
+ * timers (cleaned up on unmount, and cleared between back-to-back jumps).
+ */
+export function useFieldFocus(input) {
+    const { collection, source, focusPath, setActiveTab } = input;
+    const [highlightedField, setHighlightedField] = useState(null);
+    const [inspectorPaneId, setInspectorPaneId] = useState();
+    const focusTimersRef = useRef([]);
+    const focusField = useCallback((fieldName, localeHint) => {
+        const target = focusTarget(collection, fieldName);
+        if (!target)
+            return;
+        // A sidebar-group field renders in the Details pane; any other on its tab.
+        if ('paneId' in target)
+            setInspectorPaneId(target.paneId);
+        else
+            setActiveTab(target.tab);
+        if (localeHint !== undefined && source.localeConfig.locales.includes(localeHint)) {
+            setStudioLocale(localeHint);
+        }
+        setHighlightedField(target.field.name);
+        // Clear any timers from a prior jump so back-to-back jumps don't fight.
+        focusTimersRef.current.forEach((t) => window.clearTimeout(t));
+        const scrollTimer = window.setTimeout(() => {
+            // Some controls (relation/asset pickers) don't render the input id —
+            // the field label (`htmlFor`) is always present.
+            const control = document.getElementById(`f-${target.field.name}`) ??
+                document.querySelector(`label[for="${CSS.escape(`f-${target.field.name}`)}"]`);
+            control?.scrollIntoView({ block: 'center', behavior: 'smooth' });
+        }, 60);
+        const clearTimer = window.setTimeout(() => setHighlightedField(null), 3200);
+        focusTimersRef.current = [scrollTimer, clearTimer];
+    }, [collection, source.localeConfig, setActiveTab]);
+    useEffect(() => () => focusTimersRef.current.forEach((t) => window.clearTimeout(t)), []);
+    // Reference deep links (EC-172): `?field=<index path>` pinpoints the exact field.
+    useEffect(() => {
+        if (!focusPath)
+            return;
+        const parsed = parseDocumentFieldPath(focusPath);
+        if (!parsed)
+            return;
+        focusField(parsed.field, parsed.locale);
+    }, [focusPath, focusField]);
+    return { highlightedField, inspectorPaneId, setInspectorPaneId, focusField };
+}
+//# sourceMappingURL=use-field-focus.js.map

package/dist/components/cms/use-field-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-focus.js","sourceRoot":"","sources":["../../../src/components/cms/use-field-focus.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\nimport { SIDEBAR_FIELD_GROUP, tabOrder } from '@elytracms/core/cms-core'\nimport type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { setStudioLocale } from '@elytracms/studio/lib/locale'\nimport { parseDocumentFieldPath } from '@elytracms/studio/lib/references'\n\n/**\n * EC-283 / EC-285 — where a jump-to-field lands, as a pure decision. A field in\n * the reserved `sidebar` group renders in the Details inspector pane (open that\n * pane, EC-285); any other field lives on a content tab (switch to it). Returns\n * `null` for an unknown field name (no-op). Directly testable, no DOM.\n */\nexport function focusTarget(\n  collection: CollectionDef,\n  fieldName: string,\n): { field: FieldDef; paneId: 'details' } | { field: FieldDef; tab: string } | null {\n  const field = collection.fields.find((f) => f.name === fieldName)\n  if (!field) return null\n  if (field.form?.group === SIDEBAR_FIELD_GROUP) return { field, paneId: 'details' }\n  const fieldTabs = tabOrder(collection.form)\n  return { field, tab: field.form?.tab ?? fieldTabs[0] ?? 'main' }\n}\n\nexport interface FieldFocus {\n  /** The field ring-highlighted right now (or null). */\n  highlightedField: string | null\n  /** The inspector sidebar's active pane, controlled so a jump can open Details. */\n  inspectorPaneId: string | undefined\n  setInspectorPaneId: (id: string | undefined) => void\n  /** Focus a field by name: switch to its tab/pane (+ locale), scroll, highlight. */\n  focusField: (fieldName: string, localeHint?: string) => void\n}\n\n/**\n * EC-172 / EC-283 — the field-focus/highlight controller. Focusing a field\n * switches to its tab (or opens the Details pane for a sidebar field) and the\n * given locale, scrolls its control into view, and ring-highlights it briefly.\n * Shared by the reference deep-link (`focusPath`) and the Issues pane's\n * jump-to-field. Owns the highlight + inspector-pane state and the scroll/clear\n * timers (cleaned up on unmount, and cleared between back-to-back jumps).\n */\nexport function useFieldFocus(input: {\n  collection: CollectionDef\n  source: CollectionViewSource\n  focusPath: string | undefined\n  setActiveTab: (tab: string) => void\n}): FieldFocus {\n  const { collection, source, focusPath, setActiveTab } = input\n  const [highlightedField, setHighlightedField] = useState<string | null>(null)\n  const [inspectorPaneId, setInspectorPaneId] = useState<string>()\n  const focusTimersRef = useRef<number[]>([])\n\n  const focusField = useCallback(\n    (fieldName: string, localeHint?: string) => {\n      const target = focusTarget(collection, fieldName)\n      if (!target) return\n      // A sidebar-group field renders in the Details pane; any other on its tab.\n      if ('paneId' in target) setInspectorPaneId(target.paneId)\n      else setActiveTab(target.tab)\n      if (localeHint !== undefined && source.localeConfig.locales.includes(localeHint)) {\n        setStudioLocale(localeHint)\n      }\n      setHighlightedField(target.field.name)\n      // Clear any timers from a prior jump so back-to-back jumps don't fight.\n      focusTimersRef.current.forEach((t) => window.clearTimeout(t))\n      const scrollTimer = window.setTimeout(() => {\n        // Some controls (relation/asset pickers) don't render the input id —\n        // the field label (`htmlFor`) is always present.\n        const control =\n          document.getElementById(`f-${target.field.name}`) ??\n          document.querySelector(`label[for=\"${CSS.escape(`f-${target.field.name}`)}\"]`)\n        control?.scrollIntoView({ block: 'center', behavior: 'smooth' })\n      }, 60)\n      const clearTimer = window.setTimeout(() => setHighlightedField(null), 3200)\n      focusTimersRef.current = [scrollTimer, clearTimer]\n    },\n    [collection, source.localeConfig, setActiveTab],\n  )\n  useEffect(() => () => focusTimersRef.current.forEach((t) => window.clearTimeout(t)), [])\n\n  // Reference deep links (EC-172): `?field=<index path>` pinpoints the exact field.\n  useEffect(() => {\n    if (!focusPath) return\n    const parsed = parseDocumentFieldPath(focusPath)\n    if (!parsed) return\n    focusField(parsed.field, parsed.locale)\n  }, [focusPath, focusField])\n\n  return { highlightedField, inspectorPaneId, setInspectorPaneId, focusField }\n}\n"]}

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

@@ -0,0 +1,41 @@
+import type { CmsDocument, CollectionDef, Locale } from '@elytracms/core/cms-core';
+import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/** The header's live-link descriptor: an `href` (open live) + a title, or a muted
+ *  reason-only title while it isn't openable (loading / publish-first / no frontendUrl). */
+export interface HeaderLive {
+    href?: string;
+    title: string;
+}
+/**
+ * 0.0.42 (round 3) — the header composed-URL row's open-live affordance, as a pure
+ * decision. Only a routable collection shows the row; its leaf opens the live page
+ * when the doc is published AND a frontendUrl is set (an absolute `href`),
+ * otherwise it is a muted icon whose tooltip explains WHY (still loading, publish
+ * first, or set the frontendUrl). The draft-derived path itself updates as you
+ * type — only the OPEN-live action is published-gated, preserving draft/live.
+ */
+export declare function resolveHeaderLive(input: {
+    routableCollection: boolean;
+    liveUrl: {
+        href?: string;
+        path: string;
+    } | undefined;
+    loading: boolean;
+    published: boolean;
+}): HeaderLive | undefined;
+/**
+ * EC-205 / EC-216 — the LIVE URL derives strictly from PUBLISHED data (the pinned
+ * published snapshot + its published ancestors), never the draft, so an unpublished
+ * slug/parent edit can't leak into the live URL. Resolves the header's live-link
+ * descriptor for the composed-URL row; `undefined` for a non-routable collection.
+ */
+export declare function useLiveUrl(input: {
+    source: CollectionViewSource;
+    collection: CollectionDef;
+    doc: CmsDocument;
+    locale: Locale;
+    published: boolean;
+    routableCollection: boolean;
+}): {
+    headerLive: HeaderLive | undefined;
+};

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

@@ -0,0 +1,55 @@
+import { useMemo } from 'react';
+import { urlForDocument } from '@elytracms/core/cms-core';
+import { translate } from '@elytracms/studio/lib/i18n';
+import { resolveDeploymentFrontendUrl, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace';
+import { usePublishedDocuments } from '@elytracms/studio/lib/cms/published-documents';
+/**
+ * 0.0.42 (round 3) — the header composed-URL row's open-live affordance, as a pure
+ * decision. Only a routable collection shows the row; its leaf opens the live page
+ * when the doc is published AND a frontendUrl is set (an absolute `href`),
+ * otherwise it is a muted icon whose tooltip explains WHY (still loading, publish
+ * first, or set the frontendUrl). The draft-derived path itself updates as you
+ * type — only the OPEN-live action is published-gated, preserving draft/live.
+ */
+export function resolveHeaderLive(input) {
+    if (!input.routableCollection)
+        return undefined;
+    if (input.liveUrl?.href) {
+        return { href: input.liveUrl.href, title: translate('cms.editor.openLiveUrl', { path: input.liveUrl.path }) };
+    }
+    return {
+        title: input.loading
+            ? translate('cms.editor.loadingLiveUrl')
+            : !input.published
+                ? translate('cms.editor.publishToViewLive')
+                : translate('cms.editor.setFrontendUrlHint'),
+    };
+}
+/**
+ * EC-205 / EC-216 — the LIVE URL derives strictly from PUBLISHED data (the pinned
+ * published snapshot + its published ancestors), never the draft, so an unpublished
+ * slug/parent edit can't leak into the live URL. Resolves the header's live-link
+ * descriptor for the composed-URL row; `undefined` for a non-routable collection.
+ */
+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 (!publishedDoc)
+            return undefined;
+        return urlForDocument({
+            routes: resolveDeploymentRoutes(),
+            frontendUrl: resolveDeploymentFrontendUrl(),
+            localeConfig: source.localeConfig,
+        }, collection, publishedDoc, { siblings: [...publishedDocs.byId.values()], locale });
+    }, [publishedDocs, collection, doc.id, locale, source.localeConfig]);
+    const headerLive = resolveHeaderLive({
+        routableCollection,
+        liveUrl,
+        loading: publishedDocs.status === 'loading',
+        published,
+    });
+    return { headerLive };
+}
+//# sourceMappingURL=use-live-url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-url.js","sourceRoot":"","sources":["../../../src/components/cms/use-live-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAGzD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACvG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAA;AASrF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAKjC;IACC,IAAI,CAAC,KAAK,CAAC,kBAAkB;QAAE,OAAO,SAAS,CAAA;IAC/C,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;IAC/G,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,OAAO;YAClB,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC;YACxC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS;gBAChB,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC;gBAC3C,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC;KACjD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAO1B;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;IAChF,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnD,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAA;QACnC,OAAO,cAAc,CACnB;YACE,MAAM,EAAE,uBAAuB,EAAE;YACjC,WAAW,EAAE,4BAA4B,EAAE;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,EACD,UAAU,EACV,YAAY,EACZ,EAAE,QAAQ,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CACvD,CAAA;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;IAEpE,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,kBAAkB;QAClB,OAAO;QACP,OAAO,EAAE,aAAa,CAAC,MAAM,KAAK,SAAS;QAC3C,SAAS;KACV,CAAC,CAAA;IACF,OAAO,EAAE,UAAU,EAAE,CAAA;AACvB,CAAC","sourcesContent":["import { useMemo } from 'react'\nimport { urlForDocument } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, Locale } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { resolveDeploymentFrontendUrl, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace'\nimport { usePublishedDocuments } from '@elytracms/studio/lib/cms/published-documents'\n\n/** The header's live-link descriptor: an `href` (open live) + a title, or a muted\n *  reason-only title while it isn't openable (loading / publish-first / no frontendUrl). */\nexport interface HeaderLive {\n  href?: string\n  title: string\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 */\nexport function resolveHeaderLive(input: {\n  routableCollection: boolean\n  liveUrl: { href?: string; path: string } | undefined\n  loading: boolean\n  published: boolean\n}): HeaderLive | undefined {\n  if (!input.routableCollection) return undefined\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-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 urlForDocument(\n      {\n        routes: resolveDeploymentRoutes(),\n        frontendUrl: resolveDeploymentFrontendUrl(),\n        localeConfig: source.localeConfig,\n      },\n      collection,\n      publishedDoc,\n      { siblings: [...publishedDocs.byId.values()], 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"]}