@elytracms/studio 0.0.38 → 0.0.39

package/dist/components/cms/rich-text/lazy.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, lazy } from 'react';
+import { translate } from '@elytracms/studio/lib/i18n';
+/**
+ * Lazy boundary for the CMS rich-text editor (EC-322 load-time pass).
+ *
+ * The TipTap editor + its ProseMirror runtime and extension set is a large
+ * dependency, and `field-control` sits on the critical path of *every* CMS view.
+ * Importing the editor statically pulled all of TipTap into the studio's main
+ * route chunk even for documents with no `richText` field on screen. Splitting it
+ * behind {@link lazy} moves the whole editor subtree into an on-demand chunk that
+ * only downloads when a `richText` field actually renders — the field control's
+ * seam is unchanged (it still imports `RichTextEditor` from `./rich-text`).
+ *
+ * The fallback mirrors the loaded editor's outer frame (same border/rounding + a
+ * toolbar-and-body min-height) so the swap-in is layout-jank-free, and carries an
+ * accessible loading label from the message catalog.
+ */
+const RichTextEditorImpl = lazy(() => import('./editor').then((module) => ({ default: module.RichTextEditor })));
+function RichTextEditorFallback() {
+    return (_jsx("div", { className: "ec-rte min-h-[7.5rem] animate-pulse rounded-md border border-input bg-muted/20 shadow-sm", role: "status", "aria-busy": "true", children: _jsx("span", { className: "sr-only", children: translate('richText.loading') }) }));
+}
+export function RichTextEditor(props) {
+    return (_jsx(Suspense, { fallback: _jsx(RichTextEditorFallback, {}), children: _jsx(RichTextEditorImpl, { ...props }) }));
+}
+//# sourceMappingURL=lazy.js.map

package/dist/components/cms/rich-text/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../../../src/components/cms/rich-text/lazy.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CACnC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAC1E,CAAA;AAED,SAAS,sBAAsB;IAC7B,OAAO,CACL,cACE,SAAS,EAAC,0FAA0F,EACpG,IAAI,EAAC,QAAQ,eACH,MAAM,YAEhB,eAAM,SAAS,EAAC,SAAS,YAAE,SAAS,CAAC,kBAAkB,CAAC,GAAQ,GAC5D,CACP,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgD;IAC7E,OAAO,CACL,KAAC,QAAQ,IAAC,QAAQ,EAAE,KAAC,sBAAsB,KAAG,YAC5C,KAAC,kBAAkB,OAAK,KAAK,GAAI,GACxB,CACZ,CAAA;AACH,CAAC","sourcesContent":["import { Suspense, lazy } from 'react'\nimport type { ComponentProps } from 'react'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Lazy boundary for the CMS rich-text editor (EC-322 load-time pass).\n *\n * The TipTap editor + its ProseMirror runtime and extension set is a large\n * dependency, and `field-control` sits on the critical path of *every* CMS view.\n * Importing the editor statically pulled all of TipTap into the studio's main\n * route chunk even for documents with no `richText` field on screen. Splitting it\n * behind {@link lazy} moves the whole editor subtree into an on-demand chunk that\n * only downloads when a `richText` field actually renders — the field control's\n * seam is unchanged (it still imports `RichTextEditor` from `./rich-text`).\n *\n * The fallback mirrors the loaded editor's outer frame (same border/rounding + a\n * toolbar-and-body min-height) so the swap-in is layout-jank-free, and carries an\n * accessible loading label from the message catalog.\n */\nconst RichTextEditorImpl = lazy(() =>\n  import('./editor').then((module) => ({ default: module.RichTextEditor })),\n)\n\nfunction RichTextEditorFallback() {\n  return (\n    <div\n      className=\"ec-rte min-h-[7.5rem] animate-pulse rounded-md border border-input bg-muted/20 shadow-sm\"\n      role=\"status\"\n      aria-busy=\"true\"\n    >\n      <span className=\"sr-only\">{translate('richText.loading')}</span>\n    </div>\n  )\n}\n\nexport function RichTextEditor(props: ComponentProps<typeof RichTextEditorImpl>) {\n  return (\n    <Suspense fallback={<RichTextEditorFallback />}>\n      <RichTextEditorImpl {...props} />\n    </Suspense>\n  )\n}\n"]}

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

@@ -0,0 +1,28 @@
+import type { CollectionViewCapabilities } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/**
+ * EC-316 — the right-edge row `⋮` menu's action vocabulary: the SAME bulk-action
+ * set the toolbar's selection actions offer (`bulk-actions.ts`'s `BulkAction`),
+ * minus `set-field` (a bulk-only composer over a multi-row selection — a single
+ * row edits its fields directly in the table), plus `open` (jump to the detail
+ * editor — the row's own affordance the primary-column link already offers, but
+ * explicit in the menu for a keyboard/menu-driven workflow).
+ */
+export type RowAction = 'open' | 'publish' | 'unpublish' | 'delete';
+export interface RowActionsInput {
+    /** The rail's capability matrix (AD-19) — the SAME gate the list/edit shells use. */
+    capabilities: Pick<CollectionViewCapabilities, 'publish' | 'remove'>;
+    /** Whether this row has a navigable detail route (a rail with no detail surface omits it). */
+    hasDetailPath: boolean;
+    /** Whether this document IS published — decides `publish` vs `unpublish`. */
+    published: boolean;
+}
+/**
+ * The gated action list for one row (EC-316). Every entry mirrors a capability
+ * the rail actually declares — a source without `publish` never offers
+ * publish/unpublish, one without `remove` never offers delete, and a rail with
+ * no detail surface never offers `open` — so the SAME menu serves the users
+ * rail (EC-240), redirects, and any future `CollectionViewSource` without a
+ * bespoke per-rail menu. An empty result means the row menu itself renders
+ * nothing (never an empty, useless trigger).
+ */
+export declare function rowActionsFor({ capabilities, hasDetailPath, published }: RowActionsInput): RowAction[];

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

@@ -0,0 +1,20 @@
+/**
+ * The gated action list for one row (EC-316). Every entry mirrors a capability
+ * the rail actually declares — a source without `publish` never offers
+ * publish/unpublish, one without `remove` never offers delete, and a rail with
+ * no detail surface never offers `open` — so the SAME menu serves the users
+ * rail (EC-240), redirects, and any future `CollectionViewSource` without a
+ * bespoke per-rail menu. An empty result means the row menu itself renders
+ * nothing (never an empty, useless trigger).
+ */
+export function rowActionsFor({ capabilities, hasDetailPath, published }) {
+    const actions = [];
+    if (hasDetailPath)
+        actions.push('open');
+    if (capabilities.publish)
+        actions.push(published ? 'unpublish' : 'publish');
+    if (capabilities.remove)
+        actions.push('delete');
+    return actions;
+}
+//# sourceMappingURL=row-actions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"row-actions.js","sourceRoot":"","sources":["../../../src/components/cms/row-actions.ts"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAmB;IACvF,MAAM,OAAO,GAAgB,EAAE,CAAA;IAC/B,IAAI,aAAa;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,YAAY,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3E,IAAI,YAAY,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import type { CollectionViewCapabilities } from '@elytracms/studio/lib/collection-view/collection-view-source'\n\n/**\n * EC-316 — the right-edge row `⋮` menu's action vocabulary: the SAME bulk-action\n * set the toolbar's selection actions offer (`bulk-actions.ts`'s `BulkAction`),\n * minus `set-field` (a bulk-only composer over a multi-row selection — a single\n * row edits its fields directly in the table), plus `open` (jump to the detail\n * editor — the row's own affordance the primary-column link already offers, but\n * explicit in the menu for a keyboard/menu-driven workflow).\n */\nexport type RowAction = 'open' | 'publish' | 'unpublish' | 'delete'\n\nexport interface RowActionsInput {\n  /** The rail's capability matrix (AD-19) — the SAME gate the list/edit shells use. */\n  capabilities: Pick<CollectionViewCapabilities, 'publish' | 'remove'>\n  /** Whether this row has a navigable detail route (a rail with no detail surface omits it). */\n  hasDetailPath: boolean\n  /** Whether this document IS published — decides `publish` vs `unpublish`. */\n  published: boolean\n}\n\n/**\n * The gated action list for one row (EC-316). Every entry mirrors a capability\n * the rail actually declares — a source without `publish` never offers\n * publish/unpublish, one without `remove` never offers delete, and a rail with\n * no detail surface never offers `open` — so the SAME menu serves the users\n * rail (EC-240), redirects, and any future `CollectionViewSource` without a\n * bespoke per-rail menu. An empty result means the row menu itself renders\n * nothing (never an empty, useless trigger).\n */\nexport function rowActionsFor({ capabilities, hasDetailPath, published }: RowActionsInput): RowAction[] {\n  const actions: RowAction[] = []\n  if (hasDetailPath) actions.push('open')\n  if (capabilities.publish) actions.push(published ? 'unpublish' : 'publish')\n  if (capabilities.remove) actions.push('delete')\n  return actions\n}\n"]}

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

@@ -9,8 +9,15 @@ export declare function documentVersionsKey(projectId: string | undefined, ref:
  * so every fetch — initial, invalidated, or refetch — lists an authoritative
  * history regardless of which surface triggered the change. Two mounts with the
  * same document share one fetch (TanStack dedup on the key).
+ *
+ * `enabled` (EC-316, default `true`) lets a caller that only needs this for a
+ * gating check — e.g. the header's Discard-draft enablement, which isn't
+ * otherwise on the version-browsing path — skip the fetch until it actually
+ * applies (an unpublished/non-versioned document never needs its history).
  */
-export declare function useDocumentVersionsQuery(ref: DocumentRef): {
+export declare function useDocumentVersionsQuery(ref: DocumentRef, options?: {
+    enabled?: boolean;
+}): {
     versionsQuery: import("@tanstack/react-query").UseQueryResult<DocumentVersionsView>;
     versionKey: readonly ["documentVersions", string, string, string];
 };

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

@@ -1,9 +1,30 @@
 import { useMemo } from 'react';
 import { useOperationQuery } from '@elytracms/studio/lib/query';
 import { useCollectionView } from '../collection-view/collection-view-context';
-/** Recorded-version freshness: any document command (publish/restore/upsert) may
- *  change the history, so re-read on the whole `documents` domain. */
-const VERSION_RELOAD_OPS = ['documents'];
+/**
+ * Recorded-version freshness (EC-322): re-read on exactly the commands that
+ * change a document's version history or its live pin — NOT the whole `documents`
+ * domain. The draft the editor types (`documents.upsert`, fired per keystroke by
+ * autosave) creates no version and moves no pin (versions are appended only on
+ * publish/snapshot/restore — see `documentVersions` in `convex/schema.ts`), so
+ * listening on the whole domain refetched `listDocumentVersions` on every
+ * keystroke while the Versions pane was open. The comparison the pane shows
+ * (`liveMatchesDraft`) reads the live snapshot from THIS query and the draft from
+ * local editor state, so a draft edit re-renders it without any refetch.
+ *
+ * Every command that DOES change the view is enumerated (a new version-affecting
+ * op must be added here): `snapshot`/`restore` append a version; `publish` appends
+ * one and moves the pin; `unpublish`/`pinVersion` move the pin; `delete` cascades
+ * the history away.
+ */
+const VERSION_RELOAD_OPS = [
+    'documents.snapshot',
+    'documents.publish',
+    'documents.unpublish',
+    'documents.pinVersion',
+    'documents.restore',
+    'documents.delete',
+];
 /** The one cache key for a document's version history — shared so the Versions
  *  pane and the EC-298 compare view read through a single deduped query. */
 export function documentVersionsKey(projectId, ref) {
@@ -15,8 +36,13 @@ export function documentVersionsKey(projectId, ref) {
  * so every fetch — initial, invalidated, or refetch — lists an authoritative
  * history regardless of which surface triggered the change. Two mounts with the
  * same document share one fetch (TanStack dedup on the key).
+ *
+ * `enabled` (EC-316, default `true`) lets a caller that only needs this for a
+ * gating check — e.g. the header's Discard-draft enablement, which isn't
+ * otherwise on the version-browsing path — skip the fetch until it actually
+ * applies (an unpublished/non-versioned document never needs its history).
  */
-export function useDocumentVersionsQuery(ref) {
+export function useDocumentVersionsQuery(ref, options) {
     const source = useCollectionView();
     const versionKey = useMemo(() => documentVersionsKey(source.projectId, ref), [source.projectId, ref.collection, ref.id]);
     const versionsQuery = useOperationQuery({
@@ -25,6 +51,7 @@ export function useDocumentVersionsQuery(ref) {
         // without versions (never mounts this) degrades to an empty history.
         loader: async () => (await source.versioning?.load(ref)) ?? { versions: [] },
         invalidateOn: VERSION_RELOAD_OPS,
+        ...(options?.enabled !== undefined ? { enabled: options.enabled } : {}),
     });
     return { versionsQuery, versionKey };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"use-document-versions.js","sourceRoot":"","sources":["../../../src/components/cms/use-document-versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AAG9E;sEACsE;AACtE,MAAM,kBAAkB,GAAG,CAAC,WAAW,CAAU,CAAA;AAEjD;4EAC4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,SAA6B,EAAE,GAAgB;IACjF,OAAO,CAAC,kBAAkB,EAAE,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAU,CAAA;AAChF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAgB;IACvD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAChD,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,CAC3C,CAAA;IACD,MAAM,aAAa,GAAG,iBAAiB,CAAuB;QAC5D,QAAQ,EAAE,UAAU;QACpB,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5E,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAA;IACF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAA;AACtC,CAAC","sourcesContent":["import { useMemo } from 'react'\nimport type { DocumentRef } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport type { DocumentVersionsView } from './cms-store'\n\n/** Recorded-version freshness: any document command (publish/restore/upsert) may\n *  change the history, so re-read on the whole `documents` domain. */\nconst VERSION_RELOAD_OPS = ['documents'] as const\n\n/** The one cache key for a document's version history — shared so the Versions\n *  pane and the EC-298 compare view read through a single deduped query. */\nexport function documentVersionsKey(projectId: string | undefined, ref: DocumentRef) {\n  return ['documentVersions', projectId ?? '∅', ref.collection, ref.id] as const\n}\n\n/**\n * A document's recorded version history, read through the one operations-backed\n * query cache (EC-308/AD-17). The flush-before-read ordering lives IN the loader,\n * so every fetch — initial, invalidated, or refetch — lists an authoritative\n * history regardless of which surface triggered the change. Two mounts with the\n * same document share one fetch (TanStack dedup on the key).\n */\nexport function useDocumentVersionsQuery(ref: DocumentRef) {\n  const source = useCollectionView()\n  const versionKey = useMemo(\n    () => documentVersionsKey(source.projectId, ref),\n    [source.projectId, ref.collection, ref.id],\n  )\n  const versionsQuery = useOperationQuery<DocumentVersionsView>({\n    queryKey: versionKey,\n    // The versioning capability owns the flush-before-read ordering; a source\n    // without versions (never mounts this) degrades to an empty history.\n    loader: async () => (await source.versioning?.load(ref)) ?? { versions: [] },\n    invalidateOn: VERSION_RELOAD_OPS,\n  })\n  return { versionsQuery, versionKey }\n}\n"]}
+{"version":3,"file":"use-document-versions.js","sourceRoot":"","sources":["../../../src/components/cms/use-document-versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AAG9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,kBAAkB,GAAG;IACzB,oBAAoB;IACpB,mBAAmB;IACnB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;CACV,CAAA;AAEV;4EAC4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,SAA6B,EAAE,GAAgB;IACjF,OAAO,CAAC,kBAAkB,EAAE,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAU,CAAA;AAChF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAgB,EAAE,OAA+B;IACxF,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAChD,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,CAC3C,CAAA;IACD,MAAM,aAAa,GAAG,iBAAiB,CAAuB;QAC5D,QAAQ,EAAE,UAAU;QACpB,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5E,YAAY,EAAE,kBAAkB;QAChC,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC,CAAA;IACF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAA;AACtC,CAAC","sourcesContent":["import { useMemo } from 'react'\nimport type { DocumentRef } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport type { DocumentVersionsView } from './cms-store'\n\n/**\n * Recorded-version freshness (EC-322): re-read on exactly the commands that\n * change a document's version history or its live pin — NOT the whole `documents`\n * domain. The draft the editor types (`documents.upsert`, fired per keystroke by\n * autosave) creates no version and moves no pin (versions are appended only on\n * publish/snapshot/restore — see `documentVersions` in `convex/schema.ts`), so\n * listening on the whole domain refetched `listDocumentVersions` on every\n * keystroke while the Versions pane was open. The comparison the pane shows\n * (`liveMatchesDraft`) reads the live snapshot from THIS query and the draft from\n * local editor state, so a draft edit re-renders it without any refetch.\n *\n * Every command that DOES change the view is enumerated (a new version-affecting\n * op must be added here): `snapshot`/`restore` append a version; `publish` appends\n * one and moves the pin; `unpublish`/`pinVersion` move the pin; `delete` cascades\n * the history away.\n */\nconst VERSION_RELOAD_OPS = [\n  'documents.snapshot',\n  'documents.publish',\n  'documents.unpublish',\n  'documents.pinVersion',\n  'documents.restore',\n  'documents.delete',\n] as const\n\n/** The one cache key for a document's version history — shared so the Versions\n *  pane and the EC-298 compare view read through a single deduped query. */\nexport function documentVersionsKey(projectId: string | undefined, ref: DocumentRef) {\n  return ['documentVersions', projectId ?? '∅', ref.collection, ref.id] as const\n}\n\n/**\n * A document's recorded version history, read through the one operations-backed\n * query cache (EC-308/AD-17). The flush-before-read ordering lives IN the loader,\n * so every fetch — initial, invalidated, or refetch — lists an authoritative\n * history regardless of which surface triggered the change. Two mounts with the\n * same document share one fetch (TanStack dedup on the key).\n *\n * `enabled` (EC-316, default `true`) lets a caller that only needs this for a\n * gating check — e.g. the header's Discard-draft enablement, which isn't\n * otherwise on the version-browsing path — skip the fetch until it actually\n * applies (an unpublished/non-versioned document never needs its history).\n */\nexport function useDocumentVersionsQuery(ref: DocumentRef, options?: { enabled?: boolean }) {\n  const source = useCollectionView()\n  const versionKey = useMemo(\n    () => documentVersionsKey(source.projectId, ref),\n    [source.projectId, ref.collection, ref.id],\n  )\n  const versionsQuery = useOperationQuery<DocumentVersionsView>({\n    queryKey: versionKey,\n    // The versioning capability owns the flush-before-read ordering; a source\n    // without versions (never mounts this) degrades to an empty history.\n    loader: async () => (await source.versioning?.load(ref)) ?? { versions: [] },\n    invalidateOn: VERSION_RELOAD_OPS,\n    ...(options?.enabled !== undefined ? { enabled: options.enabled } : {}),\n  })\n  return { versionsQuery, versionKey }\n}\n"]}

package/dist/components/cms/version-compare-lazy.d.ts

@@ -0,0 +1 @@
+export declare function VersionCompare(): import("react").JSX.Element;

package/dist/components/cms/version-compare-lazy.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, lazy } from 'react';
+import { Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+/**
+ * Lazy boundary for the version-compare surface (EC-322 load-time pass).
+ *
+ * The compare view is a large, genuinely occasional surface — it only renders on
+ * the detail editor's Compare tab. Importing it statically kept its whole diff UI
+ * on the CMS detail-view critical path for every document, most of which are never
+ * compared. Splitting it behind {@link lazy} defers it to the moment the tab opens.
+ *
+ * The shared `@elytracms/core/content` diff engine it uses stays eager (many other
+ * critical-path modules import it), so what defers here is the compare UI itself.
+ */
+const VersionCompareImpl = lazy(() => import('./version-compare').then((module) => ({ default: module.VersionCompare })));
+function CompareFallback() {
+    return (_jsx("div", { className: "grid min-h-0 flex-1 place-items-center p-8", children: _jsx(Text, { size: "sm", tone: "muted", children: translate('cms.version.loadingCompare') }) }));
+}
+export function VersionCompare() {
+    return (_jsx(Suspense, { fallback: _jsx(CompareFallback, {}), children: _jsx(VersionCompareImpl, {}) }));
+}
+//# sourceMappingURL=version-compare-lazy.js.map

package/dist/components/cms/version-compare-lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare-lazy.js","sourceRoot":"","sources":["../../../src/components/cms/version-compare-lazy.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CACnC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CACnF,CAAA;AAED,SAAS,eAAe;IACtB,OAAO,CACL,cAAK,SAAS,EAAC,4CAA4C,YACzD,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,4BAA4B,CAAC,GACnC,GACH,CACP,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CACL,KAAC,QAAQ,IAAC,QAAQ,EAAE,KAAC,eAAe,KAAG,YACrC,KAAC,kBAAkB,KAAG,GACb,CACZ,CAAA;AACH,CAAC","sourcesContent":["import { Suspense, lazy } from 'react'\nimport { Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Lazy boundary for the version-compare surface (EC-322 load-time pass).\n *\n * The compare view is a large, genuinely occasional surface — it only renders on\n * the detail editor's Compare tab. Importing it statically kept its whole diff UI\n * on the CMS detail-view critical path for every document, most of which are never\n * compared. Splitting it behind {@link lazy} defers it to the moment the tab opens.\n *\n * The shared `@elytracms/core/content` diff engine it uses stays eager (many other\n * critical-path modules import it), so what defers here is the compare UI itself.\n */\nconst VersionCompareImpl = lazy(() =>\n  import('./version-compare').then((module) => ({ default: module.VersionCompare })),\n)\n\nfunction CompareFallback() {\n  return (\n    <div className=\"grid min-h-0 flex-1 place-items-center p-8\">\n      <Text size=\"sm\" tone=\"muted\">\n        {translate('cms.version.loadingCompare')}\n      </Text>\n    </div>\n  )\n}\n\nexport function VersionCompare() {\n  return (\n    <Suspense fallback={<CompareFallback />}>\n      <VersionCompareImpl />\n    </Suspense>\n  )\n}\n"]}

package/dist/components/cms/version-compare-text.d.ts

@@ -7,6 +7,12 @@ export interface WordToken {
     text: string;
     changed: boolean;
 }
+/** A token in the EC-317 unified (single-lane) prose diff: `same` reads plain,
+ *  `removed`/`added` are the struck/highlighted halves of a changed run. */
+export interface MergedDiffToken {
+    text: string;
+    kind: 'same' | 'removed' | 'added';
+}
 /**
  * Word-level LCS diff (prose, not code): tokens NOT on the longest common
  * subsequence are marked — removed on the before side, added on the after side.
@@ -16,6 +22,46 @@ export declare function wordDiff(before: string, after: string): {
     before: WordToken[];
     after: WordToken[];
 };
+/**
+ * Merge a {@link wordDiff} pair into ONE reading lane (EC-317 unified view) —
+ * a single stream of `same` / `removed` / `added` tokens instead of two
+ * columns. Sound by construction: `wordDiff` pushes an `unchanged` token to
+ * BOTH sides in the SAME loop iteration (so the Nth unchanged token in
+ * `before` and the Nth unchanged token in `after` are always the same anchor),
+ * and every stretch between two anchors is a contiguous `changed` run on
+ * either side (possibly empty on one, or both — a pure add/remove — or both
+ * nonempty — a replace). Walking both arrays in lockstep and draining each
+ * side's changed run between anchors reconstructs that reading order exactly.
+ */
+export declare function mergeWordDiff(before: WordToken[], after: WordToken[]): MergedDiffToken[];
+/**
+ * A sensible default length threshold (characters) past which the EC-317
+ * compare view collapses a value behind a per-row "Show more" — long enough to
+ * read a couple of sentences at a glance, short enough that a full rich-text
+ * body doesn't dominate the change-list.
+ */
+export declare const DIFF_TRUNCATE_THRESHOLD = 400;
+/**
+ * Collapse a plain text value for display (EC-317) — presentation only, never
+ * touching the semantic/identity diff underneath: the caller always has the
+ * full string, this just decides how much of it to render.
+ */
+export declare function truncateText(text: string, expanded: boolean, threshold?: number): {
+    shown: string;
+    isLong: boolean;
+};
+/**
+ * The token-array counterpart of {@link truncateText} — used for word-diff /
+ * merged-diff token streams so a collapsed row still ends on a whole token
+ * (never mid-word) and the change markers (`changed`/`kind`) it slices off
+ * are simply not rendered, not recomputed.
+ */
+export declare function truncateTokens<T extends {
+    text: string;
+}>(tokens: readonly T[], expanded: boolean, threshold?: number): {
+    shown: T[];
+    isLong: boolean;
+};
 /**
  * A "rich text" value as readable text for the prose diff — FORMAT-AGNOSTIC, since
  * the stored value can be anything the field's editor writes: a plain/HTML STRING

package/dist/components/cms/version-compare-text.js

@@ -55,6 +55,84 @@ export function wordDiff(before, after) {
         afterTokens.push({ text: b[j++], changed: true });
     return { before: beforeTokens, after: afterTokens };
 }
+/**
+ * Merge a {@link wordDiff} pair into ONE reading lane (EC-317 unified view) —
+ * a single stream of `same` / `removed` / `added` tokens instead of two
+ * columns. Sound by construction: `wordDiff` pushes an `unchanged` token to
+ * BOTH sides in the SAME loop iteration (so the Nth unchanged token in
+ * `before` and the Nth unchanged token in `after` are always the same anchor),
+ * and every stretch between two anchors is a contiguous `changed` run on
+ * either side (possibly empty on one, or both — a pure add/remove — or both
+ * nonempty — a replace). Walking both arrays in lockstep and draining each
+ * side's changed run between anchors reconstructs that reading order exactly.
+ */
+export function mergeWordDiff(before, after) {
+    const merged = [];
+    let i = 0;
+    let j = 0;
+    while (i < before.length && j < after.length) {
+        if (!before[i].changed && !after[j].changed) {
+            merged.push({ text: before[i].text, kind: 'same' });
+            i++;
+            j++;
+            continue;
+        }
+        while (i < before.length && before[i].changed) {
+            merged.push({ text: before[i].text, kind: 'removed' });
+            i++;
+        }
+        while (j < after.length && after[j].changed) {
+            merged.push({ text: after[j].text, kind: 'added' });
+            j++;
+        }
+    }
+    // A trailing changed run on whichever side still has tokens once the other
+    // is exhausted (wordDiff's own trailing while-loops produce exactly this).
+    while (i < before.length)
+        merged.push({ text: before[i++].text, kind: 'removed' });
+    while (j < after.length)
+        merged.push({ text: after[j++].text, kind: 'added' });
+    return merged;
+}
+/**
+ * A sensible default length threshold (characters) past which the EC-317
+ * compare view collapses a value behind a per-row "Show more" — long enough to
+ * read a couple of sentences at a glance, short enough that a full rich-text
+ * body doesn't dominate the change-list.
+ */
+export const DIFF_TRUNCATE_THRESHOLD = 400;
+/**
+ * Collapse a plain text value for display (EC-317) — presentation only, never
+ * touching the semantic/identity diff underneath: the caller always has the
+ * full string, this just decides how much of it to render.
+ */
+export function truncateText(text, expanded, threshold = DIFF_TRUNCATE_THRESHOLD) {
+    const isLong = text.length > threshold;
+    if (expanded || !isLong)
+        return { shown: text, isLong };
+    return { shown: `${text.slice(0, threshold).trimEnd()}…`, isLong };
+}
+/**
+ * The token-array counterpart of {@link truncateText} — used for word-diff /
+ * merged-diff token streams so a collapsed row still ends on a whole token
+ * (never mid-word) and the change markers (`changed`/`kind`) it slices off
+ * are simply not rendered, not recomputed.
+ */
+export function truncateTokens(tokens, expanded, threshold = DIFF_TRUNCATE_THRESHOLD) {
+    const totalLength = tokens.reduce((sum, token) => sum + token.text.length, 0);
+    const isLong = totalLength > threshold;
+    if (expanded || !isLong)
+        return { shown: [...tokens], isLong };
+    const shown = [];
+    let used = 0;
+    for (const token of tokens) {
+        if (used >= threshold)
+            break;
+        shown.push(token);
+        used += token.text.length;
+    }
+    return { shown, isLong };
+}
 /**
  * A "rich text" value as readable text for the prose diff — FORMAT-AGNOSTIC, since
  * the stored value can be anything the field's editor writes: a plain/HTML STRING

package/dist/components/cms/version-compare-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-compare-text.js","sourceRoot":"","sources":["../../../src/components/cms/version-compare-text.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure text helpers for the EC-298 compare view — extracted so the fiddly bits\n * (word-level LCS, format-agnostic \"rich text\" extraction) are unit-tested apart\n * from the React surface.\n */\n\nexport interface WordToken {\n  text: string\n  changed: boolean\n}\n\nfunction tokenize(s: string): string[] {\n  return s.split(/(\\s+)/).filter((t) => t.length > 0)\n}\n\n/**\n * Word-level LCS diff (prose, not code): tokens NOT on the longest common\n * subsequence are marked — removed on the before side, added on the after side.\n * Whitespace tokens participate, so spacing is preserved on render.\n */\nexport function wordDiff(before: string, after: string): { before: WordToken[]; after: WordToken[] } {\n  const a = tokenize(before)\n  const b = tokenize(after)\n  // Bound the DP so a pathological pair can't stall the editor.\n  if (a.length + b.length > 4000) {\n    return {\n      before: a.map((text) => ({ text, changed: true })),\n      after: b.map((text) => ({ text, changed: true })),\n    }\n  }\n  const m = a.length\n  const n = b.length\n  const dp: number[][] = Array.from({ length: m + 1 }, () => new Array<number>(n + 1).fill(0))\n  for (let i = m - 1; i >= 0; i--) {\n    for (let j = n - 1; j >= 0; j--) {\n      dp[i]![j] = a[i] === b[j] ? dp[i + 1]![j + 1]! + 1 : Math.max(dp[i + 1]![j]!, dp[i]![j + 1]!)\n    }\n  }\n  const beforeTokens: WordToken[] = []\n  const afterTokens: WordToken[] = []\n  let i = 0\n  let j = 0\n  while (i < m && j < n) {\n    if (a[i] === b[j]) {\n      beforeTokens.push({ text: a[i]!, changed: false })\n      afterTokens.push({ text: b[j]!, changed: false })\n      i++\n      j++\n    } else if (dp[i + 1]![j]! >= dp[i]![j + 1]!) {\n      beforeTokens.push({ text: a[i]!, changed: true })\n      i++\n    } else {\n      afterTokens.push({ text: b[j]!, changed: true })\n      j++\n    }\n  }\n  while (i < m) beforeTokens.push({ text: a[i++]!, changed: true })\n  while (j < n) afterTokens.push({ text: b[j++]!, changed: true })\n  return { before: beforeTokens, after: afterTokens }\n}\n\n/**\n * A \"rich text\" value as readable text for the prose diff — FORMAT-AGNOSTIC, since\n * the stored value can be anything the field's editor writes: a plain/HTML STRING\n * (a simple text input), a TipTap `{version, doc}` tree, or a bare doc. We show\n * whatever is entered rather than assuming a structure (EC-298).\n */\nexport function richTextToText(value: unknown): string {\n  if (typeof value === 'string') return looksLikeHtml(value) ? htmlToText(value) : value\n  if (value && typeof value === 'object') {\n    const wrapper = value as { doc?: unknown; content?: unknown }\n    const doc = (wrapper.doc ?? wrapper) as { content?: unknown }\n    if (Array.isArray(doc.content)) return plainTextFromNodes(doc.content)\n  }\n  return ''\n}\n\nexport function looksLikeHtml(s: string): boolean {\n  return /<[a-z!/][\\s\\S]*>/i.test(s)\n}\n\n/** Strip HTML to readable text, keeping block breaks so paragraphs still separate. */\nexport function htmlToText(html: string): string {\n  return html\n    .replace(/<\\s*br\\s*\\/?>/gi, '\\n')\n    .replace(/<\\/(p|div|h[1-6]|blockquote)\\s*>/gi, '\\n\\n')\n    .replace(/<\\/(li|tr|ul|ol)\\s*>/gi, '\\n')\n    .replace(/<[^>]+>/g, '')\n    .replace(/&nbsp;/gi, ' ')\n    .replace(/&amp;/gi, '&')\n    .replace(/&lt;/gi, '<')\n    .replace(/&gt;/gi, '>')\n    .replace(/&quot;/gi, '\"')\n    .replace(/&#39;/gi, \"'\")\n    .replace(/[ \\t]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n}\n\n/** Plain text from ProseMirror/TipTap nodes: text runs joined, blocks separated. */\nexport function plainTextFromNodes(nodes: unknown[]): string {\n  const blockText = (node: unknown): string => {\n    const parts: string[] = []\n    const walk = (n: unknown) => {\n      if (!n || typeof n !== 'object') return\n      const rec = n as { text?: unknown; content?: unknown }\n      if (typeof rec.text === 'string') parts.push(rec.text)\n      if (Array.isArray(rec.content)) rec.content.forEach(walk)\n    }\n    walk(node)\n    return parts.join('')\n  }\n  return nodes.map(blockText).filter(Boolean).join('\\n\\n')\n}\n"]}
+{"version":3,"file":"version-compare-text.js","sourceRoot":"","sources":["../../../src/components/cms/version-compare-text.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure text helpers for the EC-298 compare view — extracted so the fiddly bits\n * (word-level LCS, format-agnostic \"rich text\" extraction) are unit-tested apart\n * from the React surface.\n */\n\nexport interface WordToken {\n  text: string\n  changed: boolean\n}\n\n/** A token in the EC-317 unified (single-lane) prose diff: `same` reads plain,\n *  `removed`/`added` are the struck/highlighted halves of a changed run. */\nexport interface MergedDiffToken {\n  text: string\n  kind: 'same' | 'removed' | 'added'\n}\n\nfunction tokenize(s: string): string[] {\n  return s.split(/(\\s+)/).filter((t) => t.length > 0)\n}\n\n/**\n * Word-level LCS diff (prose, not code): tokens NOT on the longest common\n * subsequence are marked — removed on the before side, added on the after side.\n * Whitespace tokens participate, so spacing is preserved on render.\n */\nexport function wordDiff(before: string, after: string): { before: WordToken[]; after: WordToken[] } {\n  const a = tokenize(before)\n  const b = tokenize(after)\n  // Bound the DP so a pathological pair can't stall the editor.\n  if (a.length + b.length > 4000) {\n    return {\n      before: a.map((text) => ({ text, changed: true })),\n      after: b.map((text) => ({ text, changed: true })),\n    }\n  }\n  const m = a.length\n  const n = b.length\n  const dp: number[][] = Array.from({ length: m + 1 }, () => new Array<number>(n + 1).fill(0))\n  for (let i = m - 1; i >= 0; i--) {\n    for (let j = n - 1; j >= 0; j--) {\n      dp[i]![j] = a[i] === b[j] ? dp[i + 1]![j + 1]! + 1 : Math.max(dp[i + 1]![j]!, dp[i]![j + 1]!)\n    }\n  }\n  const beforeTokens: WordToken[] = []\n  const afterTokens: WordToken[] = []\n  let i = 0\n  let j = 0\n  while (i < m && j < n) {\n    if (a[i] === b[j]) {\n      beforeTokens.push({ text: a[i]!, changed: false })\n      afterTokens.push({ text: b[j]!, changed: false })\n      i++\n      j++\n    } else if (dp[i + 1]![j]! >= dp[i]![j + 1]!) {\n      beforeTokens.push({ text: a[i]!, changed: true })\n      i++\n    } else {\n      afterTokens.push({ text: b[j]!, changed: true })\n      j++\n    }\n  }\n  while (i < m) beforeTokens.push({ text: a[i++]!, changed: true })\n  while (j < n) afterTokens.push({ text: b[j++]!, changed: true })\n  return { before: beforeTokens, after: afterTokens }\n}\n\n/**\n * Merge a {@link wordDiff} pair into ONE reading lane (EC-317 unified view) —\n * a single stream of `same` / `removed` / `added` tokens instead of two\n * columns. Sound by construction: `wordDiff` pushes an `unchanged` token to\n * BOTH sides in the SAME loop iteration (so the Nth unchanged token in\n * `before` and the Nth unchanged token in `after` are always the same anchor),\n * and every stretch between two anchors is a contiguous `changed` run on\n * either side (possibly empty on one, or both — a pure add/remove — or both\n * nonempty — a replace). Walking both arrays in lockstep and draining each\n * side's changed run between anchors reconstructs that reading order exactly.\n */\nexport function mergeWordDiff(before: WordToken[], after: WordToken[]): MergedDiffToken[] {\n  const merged: MergedDiffToken[] = []\n  let i = 0\n  let j = 0\n  while (i < before.length && j < after.length) {\n    if (!before[i]!.changed && !after[j]!.changed) {\n      merged.push({ text: before[i]!.text, kind: 'same' })\n      i++\n      j++\n      continue\n    }\n    while (i < before.length && before[i]!.changed) {\n      merged.push({ text: before[i]!.text, kind: 'removed' })\n      i++\n    }\n    while (j < after.length && after[j]!.changed) {\n      merged.push({ text: after[j]!.text, kind: 'added' })\n      j++\n    }\n  }\n  // A trailing changed run on whichever side still has tokens once the other\n  // is exhausted (wordDiff's own trailing while-loops produce exactly this).\n  while (i < before.length) merged.push({ text: before[i++]!.text, kind: 'removed' })\n  while (j < after.length) merged.push({ text: after[j++]!.text, kind: 'added' })\n  return merged\n}\n\n/**\n * A sensible default length threshold (characters) past which the EC-317\n * compare view collapses a value behind a per-row \"Show more\" — long enough to\n * read a couple of sentences at a glance, short enough that a full rich-text\n * body doesn't dominate the change-list.\n */\nexport const DIFF_TRUNCATE_THRESHOLD = 400\n\n/**\n * Collapse a plain text value for display (EC-317) — presentation only, never\n * touching the semantic/identity diff underneath: the caller always has the\n * full string, this just decides how much of it to render.\n */\nexport function truncateText(\n  text: string,\n  expanded: boolean,\n  threshold = DIFF_TRUNCATE_THRESHOLD,\n): { shown: string; isLong: boolean } {\n  const isLong = text.length > threshold\n  if (expanded || !isLong) return { shown: text, isLong }\n  return { shown: `${text.slice(0, threshold).trimEnd()}…`, isLong }\n}\n\n/**\n * The token-array counterpart of {@link truncateText} — used for word-diff /\n * merged-diff token streams so a collapsed row still ends on a whole token\n * (never mid-word) and the change markers (`changed`/`kind`) it slices off\n * are simply not rendered, not recomputed.\n */\nexport function truncateTokens<T extends { text: string }>(\n  tokens: readonly T[],\n  expanded: boolean,\n  threshold = DIFF_TRUNCATE_THRESHOLD,\n): { shown: T[]; isLong: boolean } {\n  const totalLength = tokens.reduce((sum, token) => sum + token.text.length, 0)\n  const isLong = totalLength > threshold\n  if (expanded || !isLong) return { shown: [...tokens], isLong }\n  const shown: T[] = []\n  let used = 0\n  for (const token of tokens) {\n    if (used >= threshold) break\n    shown.push(token)\n    used += token.text.length\n  }\n  return { shown, isLong }\n}\n\n/**\n * A \"rich text\" value as readable text for the prose diff — FORMAT-AGNOSTIC, since\n * the stored value can be anything the field's editor writes: a plain/HTML STRING\n * (a simple text input), a TipTap `{version, doc}` tree, or a bare doc. We show\n * whatever is entered rather than assuming a structure (EC-298).\n */\nexport function richTextToText(value: unknown): string {\n  if (typeof value === 'string') return looksLikeHtml(value) ? htmlToText(value) : value\n  if (value && typeof value === 'object') {\n    const wrapper = value as { doc?: unknown; content?: unknown }\n    const doc = (wrapper.doc ?? wrapper) as { content?: unknown }\n    if (Array.isArray(doc.content)) return plainTextFromNodes(doc.content)\n  }\n  return ''\n}\n\nexport function looksLikeHtml(s: string): boolean {\n  return /<[a-z!/][\\s\\S]*>/i.test(s)\n}\n\n/** Strip HTML to readable text, keeping block breaks so paragraphs still separate. */\nexport function htmlToText(html: string): string {\n  return html\n    .replace(/<\\s*br\\s*\\/?>/gi, '\\n')\n    .replace(/<\\/(p|div|h[1-6]|blockquote)\\s*>/gi, '\\n\\n')\n    .replace(/<\\/(li|tr|ul|ol)\\s*>/gi, '\\n')\n    .replace(/<[^>]+>/g, '')\n    .replace(/&nbsp;/gi, ' ')\n    .replace(/&amp;/gi, '&')\n    .replace(/&lt;/gi, '<')\n    .replace(/&gt;/gi, '>')\n    .replace(/&quot;/gi, '\"')\n    .replace(/&#39;/gi, \"'\")\n    .replace(/[ \\t]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n}\n\n/** Plain text from ProseMirror/TipTap nodes: text runs joined, blocks separated. */\nexport function plainTextFromNodes(nodes: unknown[]): string {\n  const blockText = (node: unknown): string => {\n    const parts: string[] = []\n    const walk = (n: unknown) => {\n      if (!n || typeof n !== 'object') return\n      const rec = n as { text?: unknown; content?: unknown }\n      if (typeof rec.text === 'string') parts.push(rec.text)\n      if (Array.isArray(rec.content)) rec.content.forEach(walk)\n    }\n    walk(node)\n    return parts.join('')\n  }\n  return nodes.map(blockText).filter(Boolean).join('\\n\\n')\n}\n"]}

package/dist/components/cms/version-compare.d.ts

@@ -3,10 +3,14 @@
  * (the Versions sidebar pane stays on as the navigator).
  *
  * A calm change-list grouped BY FIELD (a localized field's per-locale variants sit
- * together): before | after across ONE continuous central divider. Text reads as a
- * prose diff (changed words lit in place — rich text via its markdown projection so
- * the content, not just "changed", is visible); assets as thumbnails; relations as
- * titles. Each field/locale (and each block, at property level) restores back to the
- * base version with a single ↩.
+ * together): a left **descriptor lane** (EC-317 — field label + locale) identifies
+ * each row, next to its before | after value (or one merged **unified** lane —
+ * a persisted transient view preference, EC-317). Text reads as a prose diff
+ * (changed words lit in place — rich text via its markdown projection); assets as
+ * thumbnails; relations as titles. A value past a length threshold collapses
+ * behind a per-row "Show more" (+ a global "Expand/Collapse all") — presentation
+ * only, the semantic/identity diff underneath (EC-298) is never touched. Rows
+ * zebra-stripe for scanability. Each field/locale (and each block, at property
+ * level) restores back to the base version with a single ↩.
  */
 export declare function VersionCompare(): import("react").JSX.Element | null;