@elytracms/studio 0.0.42 → 0.0.44

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"]}

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

@@ -0,0 +1,49 @@
+import type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core';
+import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+export type PublishState = 'idle' | 'pending' | 'success';
+/**
+ * EC-268 / 0.0.39 — the split Publish button's shared gate, computed once so the
+ * primary "Publish" and the "Publish & close" item can never diverge. A pure
+ * decision (directly testable): the Published perspective is read-only (switch to
+ * Draft to publish), schema errors block (with a count-aware hint), and an
+ * in-flight publish disables re-entry.
+ */
+export declare function publishGate(input: {
+    hasErrors: boolean;
+    viewReadOnly: boolean;
+    publishState: PublishState;
+    errorCount: number;
+}): {
+    disabled: boolean;
+    title: string | undefined;
+};
+export interface PublishController {
+    publishState: PublishState;
+    /** Is the confirm-through dialog (unpublished hard refs) open? */
+    publishConfirm: boolean;
+    /** Publish (opening the confirm-through dialog first if there are unpublished refs). */
+    handlePublish: () => void;
+    /** Publish and, on success, return to the rail's list (0.0.39 "Publish & close"). */
+    handlePublishAndClose: () => void;
+    /** Confirm-through: publish despite the unpublished hard references. */
+    confirmPublish: () => void;
+    /** Dismiss the confirm-through dialog (also clears a pending "& close" intent). */
+    cancelPublishConfirm: () => void;
+}
+/**
+ * EC-268 / EC-300 / 0.0.39 — the publish controller. Owns the publish indicator
+ * state, the EC-300 confirm-through guard (unpublished hard references would render
+ * empty on the live site, so publishing confirms rather than blocks), and the
+ * 0.0.39 "Publish & close" navigation (remembered across the confirm dialog via a
+ * ref, so a successful publish returns to the rail-owned list).
+ */
+export declare function usePublishController(input: {
+    source: CollectionViewSource;
+    docRef: DocumentRef;
+    collection: CollectionDef;
+    projectId: string;
+    draft: CmsDocument;
+    setDraft: (doc: CmsDocument) => void;
+    dirty: boolean;
+    hasUnpublishedRefs: boolean;
+}): PublishController;

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

@@ -0,0 +1,102 @@
+import { useCallback, useRef, useState } from 'react';
+import { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router';
+import { clearHiddenValues } from '@elytracms/core/cms-core';
+import { toast } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+/**
+ * EC-268 / 0.0.39 — the split Publish button's shared gate, computed once so the
+ * primary "Publish" and the "Publish & close" item can never diverge. A pure
+ * decision (directly testable): the Published perspective is read-only (switch to
+ * Draft to publish), schema errors block (with a count-aware hint), and an
+ * in-flight publish disables re-entry.
+ */
+export function publishGate(input) {
+    const disabled = input.hasErrors || input.viewReadOnly || input.publishState === 'pending';
+    const title = input.viewReadOnly
+        ? translate('cms.editor.switchToDraftToPublish')
+        : input.hasErrors
+            ? translate(input.errorCount === 1
+                ? 'cms.editor.fixIssuesToPublish.one'
+                : 'cms.editor.fixIssuesToPublish.other', { count: input.errorCount })
+            : undefined;
+    return { disabled, title };
+}
+/**
+ * EC-268 / EC-300 / 0.0.39 — the publish controller. Owns the publish indicator
+ * state, the EC-300 confirm-through guard (unpublished hard references would render
+ * empty on the live site, so publishing confirms rather than blocks), and the
+ * 0.0.39 "Publish & close" navigation (remembered across the confirm dialog via a
+ * ref, so a successful publish returns to the rail-owned list).
+ */
+export function usePublishController(input) {
+    const { source, docRef, collection, projectId, draft, setDraft, dirty, hasUnpublishedRefs } = input;
+    const navigate = useNavigate();
+    const [publishState, setPublishState] = useState('idle');
+    const [publishConfirm, setPublishConfirm] = useState(false);
+    // The split-button "Publish & close" intent — remembered across the confirm-through
+    // dialog so a successful publish returns to the list. Cleared on cancel or failure.
+    const closeAfterPublishRef = useRef(false);
+    const doPublish = useCallback(async () => {
+        // EC-273: clean conditionally-hidden values from the draft AT PUBLISH TIME —
+        // into the draft AND the snapshot, so both go clean together. Also captures the
+        // latest edit if Publish fires inside the autosave debounce window; the serial
+        // persister runs the upsert before the publish so the snapshot is this draft.
+        const cleaned = clearHiddenValues(collection, draft);
+        if (cleaned !== draft)
+            setDraft(cleaned);
+        if (cleaned !== draft || dirty)
+            source.save(cleaned);
+        setPublishState('pending');
+        try {
+            await source.publishing?.publish(docRef);
+            setPublishState('success');
+            setTimeout(() => setPublishState('idle'), 1800);
+            // "Publish & close": return to the list once the publish landed (never on a
+            // failure). Rail-owned `listPath`, falling back to the project index (AD-19).
+            if (closeAfterPublishRef.current) {
+                closeAfterPublishRef.current = false;
+                void navigate({
+                    to: STUDIO_PROJECT_ROUTE,
+                    params: { projectId, _splat: source.listPath ?? studioPath.index() },
+                });
+            }
+        }
+        catch (error) {
+            closeAfterPublishRef.current = false;
+            setPublishState('idle');
+            toast.error(error instanceof Error
+                ? translate('cms.editor.publishFailedReason', { error: error.message })
+                : translate('cms.editor.publishFailed'));
+        }
+    }, [collection, draft, setDraft, dirty, source, docRef, navigate, projectId]);
+    // Gate publish on the confirm-through dialog when there are unpublished hard
+    // references; schema errors already disable the button, so they never reach here.
+    const handlePublish = useCallback(() => {
+        if (hasUnpublishedRefs) {
+            setPublishConfirm(true);
+            return;
+        }
+        void doPublish();
+    }, [hasUnpublishedRefs, doPublish]);
+    const handlePublishAndClose = useCallback(() => {
+        closeAfterPublishRef.current = true;
+        handlePublish();
+    }, [handlePublish]);
+    const confirmPublish = useCallback(() => {
+        setPublishConfirm(false);
+        void doPublish();
+    }, [doPublish]);
+    const cancelPublishConfirm = useCallback(() => {
+        setPublishConfirm(false);
+        closeAfterPublishRef.current = false;
+    }, []);
+    return {
+        publishState,
+        publishConfirm,
+        handlePublish,
+        handlePublishAndClose,
+        confirmPublish,
+        cancelPublishConfirm,
+    };
+}
+//# sourceMappingURL=use-publish-controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-publish-controller.js","sourceRoot":"","sources":["../../../src/components/cms/use-publish-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useRef, useState } from 'react'\nimport { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router'\nimport { clearHiddenValues } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { toast } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\nexport type PublishState = 'idle' | 'pending' | 'success'\n\n/**\n * EC-268 / 0.0.39 — the split Publish button's shared gate, computed once so the\n * primary \"Publish\" and the \"Publish & close\" item can never diverge. A pure\n * decision (directly testable): the Published perspective is read-only (switch to\n * Draft to publish), schema errors block (with a count-aware hint), and an\n * in-flight publish disables re-entry.\n */\nexport function publishGate(input: {\n  hasErrors: boolean\n  viewReadOnly: boolean\n  publishState: PublishState\n  errorCount: number\n}): { disabled: boolean; title: string | undefined } {\n  const disabled = input.hasErrors || input.viewReadOnly || input.publishState === 'pending'\n  const title = input.viewReadOnly\n    ? translate('cms.editor.switchToDraftToPublish')\n    : input.hasErrors\n      ? translate(\n          input.errorCount === 1\n            ? 'cms.editor.fixIssuesToPublish.one'\n            : 'cms.editor.fixIssuesToPublish.other',\n          { count: input.errorCount },\n        )\n      : undefined\n  return { disabled, title }\n}\n\nexport interface PublishController {\n  publishState: PublishState\n  /** Is the confirm-through dialog (unpublished hard refs) open? */\n  publishConfirm: boolean\n  /** Publish (opening the confirm-through dialog first if there are unpublished refs). */\n  handlePublish: () => void\n  /** Publish and, on success, return to the rail's list (0.0.39 \"Publish & close\"). */\n  handlePublishAndClose: () => void\n  /** Confirm-through: publish despite the unpublished hard references. */\n  confirmPublish: () => void\n  /** Dismiss the confirm-through dialog (also clears a pending \"& close\" intent). */\n  cancelPublishConfirm: () => void\n}\n\n/**\n * EC-268 / EC-300 / 0.0.39 — the publish controller. Owns the publish indicator\n * state, the EC-300 confirm-through guard (unpublished hard references would render\n * empty on the live site, so publishing confirms rather than blocks), and the\n * 0.0.39 \"Publish & close\" navigation (remembered across the confirm dialog via a\n * ref, so a successful publish returns to the rail-owned list).\n */\nexport function usePublishController(input: {\n  source: CollectionViewSource\n  docRef: DocumentRef\n  collection: CollectionDef\n  projectId: string\n  draft: CmsDocument\n  setDraft: (doc: CmsDocument) => void\n  dirty: boolean\n  hasUnpublishedRefs: boolean\n}): PublishController {\n  const { source, docRef, collection, projectId, draft, setDraft, dirty, hasUnpublishedRefs } = input\n  const navigate = useNavigate()\n  const [publishState, setPublishState] = useState<PublishState>('idle')\n  const [publishConfirm, setPublishConfirm] = useState(false)\n  // The split-button \"Publish & close\" intent — remembered across the confirm-through\n  // dialog so a successful publish returns to the list. Cleared on cancel or failure.\n  const closeAfterPublishRef = useRef(false)\n\n  const doPublish = useCallback(async () => {\n    // EC-273: clean conditionally-hidden values from the draft AT PUBLISH TIME —\n    // into the draft AND the snapshot, so both go clean together. Also captures the\n    // latest edit if Publish fires inside the autosave debounce window; the serial\n    // persister runs the upsert before the publish so the snapshot is this draft.\n    const cleaned = clearHiddenValues(collection, draft)\n    if (cleaned !== draft) setDraft(cleaned)\n    if (cleaned !== draft || dirty) source.save(cleaned)\n    setPublishState('pending')\n    try {\n      await source.publishing?.publish(docRef)\n      setPublishState('success')\n      setTimeout(() => setPublishState('idle'), 1800)\n      // \"Publish & close\": return to the list once the publish landed (never on a\n      // failure). Rail-owned `listPath`, falling back to the project index (AD-19).\n      if (closeAfterPublishRef.current) {\n        closeAfterPublishRef.current = false\n        void navigate({\n          to: STUDIO_PROJECT_ROUTE,\n          params: { projectId, _splat: source.listPath ?? studioPath.index() },\n        })\n      }\n    } catch (error) {\n      closeAfterPublishRef.current = false\n      setPublishState('idle')\n      toast.error(\n        error instanceof Error\n          ? translate('cms.editor.publishFailedReason', { error: error.message })\n          : translate('cms.editor.publishFailed'),\n      )\n    }\n  }, [collection, draft, setDraft, dirty, source, docRef, navigate, projectId])\n\n  // Gate publish on the confirm-through dialog when there are unpublished hard\n  // references; schema errors already disable the button, so they never reach here.\n  const handlePublish = useCallback(() => {\n    if (hasUnpublishedRefs) {\n      setPublishConfirm(true)\n      return\n    }\n    void doPublish()\n  }, [hasUnpublishedRefs, doPublish])\n\n  const handlePublishAndClose = useCallback(() => {\n    closeAfterPublishRef.current = true\n    handlePublish()\n  }, [handlePublish])\n\n  const confirmPublish = useCallback(() => {\n    setPublishConfirm(false)\n    void doPublish()\n  }, [doPublish])\n\n  const cancelPublishConfirm = useCallback(() => {\n    setPublishConfirm(false)\n    closeAfterPublishRef.current = false\n  }, [])\n\n  return {\n    publishState,\n    publishConfirm,\n    handlePublish,\n    handlePublishAndClose,\n    confirmPublish,\n    cancelPublishConfirm,\n  }\n}\n"]}

package/dist/components/cms/use-published-perspective.d.ts

@@ -0,0 +1,67 @@
+import type { QueryKey } from '@tanstack/react-query';
+import type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core';
+import type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source';
+import type { DocumentVersionsView } from './cms-store';
+import type { PublishedSnapshotState } from './versions-model';
+export type Perspective = 'draft' | 'published';
+/**
+ * EC-226 — which document the fieldset renders, given the active perspective and
+ * the pinned published snapshot's load state. A pure decision so "never present
+ * the draft AS published" is single-sourced and directly testable:
+ *
+ * - Draft perspective → the live draft, editable.
+ * - Published perspective, snapshot READY → the pinned snapshot, read-only.
+ * - Published perspective, snapshot NOT ready → still the draft as the fallback
+ *   render target, but flagged `publishedPending` so the shell shows a placeholder
+ *   instead (the draft must never be shown labelled as the published content).
+ */
+export declare function resolveViewDoc(input: {
+    perspective: Perspective;
+    publishedSnapshot: PublishedSnapshotState;
+    draft: CmsDocument;
+}): {
+    viewReadOnly: boolean;
+    viewDoc: CmsDocument;
+    publishedPending: boolean;
+};
+export interface PublishedPerspective {
+    perspective: Perspective;
+    setPerspective: (perspective: Perspective) => void;
+    /** Is the document published (a version pointer is set)? */
+    published: boolean;
+    /** A publishing AND versioned rail — gates the version-history query + Discard. */
+    canDiscard: boolean;
+    /** The recorded version history (null while loading / disabled). */
+    versionsView: DocumentVersionsView | null;
+    /** The shared version-history cache key ({@link documentVersionsKey}). */
+    versionKey: QueryKey;
+    /** The pinned published version number, or undefined while loading / none pinned. */
+    publishedVersionNumber: number | undefined;
+    /** The pinned published version's snapshot, or undefined while loading / none. */
+    publishedSnapshotDoc: CmsDocument | undefined;
+    /** The loaded state of the pinned published snapshot. */
+    publishedSnapshot: PublishedSnapshotState;
+    /** Is the editor viewing the read-only Published snapshot? */
+    viewReadOnly: boolean;
+    /** The document the fieldset renders (draft or the pinned snapshot). */
+    viewDoc: CmsDocument;
+    /** Is the Published snapshot still loading (show a placeholder, not the draft)? */
+    publishedPending: boolean;
+}
+/**
+ * EC-226 / EC-316 / EC-325 — the Draft/Published VIEW perspective plus the pinned
+ * published snapshot, both derived from the ONE shared version-history query
+ * (AD-17: the single operations-backed cache, `use-document-versions.ts` — no raw
+ * `source.versioning.load` call). The Discard-draft gating and the Published
+ * perspective read exactly the same `versions`/`publishedVersion` shape, so a
+ * second bespoke fetch on perspective switch would just re-read this. Gated the
+ * same way Discard always was — a publishing + versioned rail AND a published
+ * document — which is also exactly when the Published perspective is reachable.
+ */
+export declare function usePublishedPerspective(input: {
+    ref: DocumentRef;
+    source: CollectionViewSource;
+    canPublish: boolean;
+    canVersions: boolean;
+    draft: CmsDocument;
+}): PublishedPerspective;

package/dist/components/cms/use-published-perspective.js

@@ -0,0 +1,67 @@
+import { useEffect, useState } from 'react';
+import { useDocumentVersionsQuery } from './use-document-versions';
+import { derivePublishedSnapshot, publishedVersionSnapshot } from './versions-model';
+/**
+ * EC-226 — which document the fieldset renders, given the active perspective and
+ * the pinned published snapshot's load state. A pure decision so "never present
+ * the draft AS published" is single-sourced and directly testable:
+ *
+ * - Draft perspective → the live draft, editable.
+ * - Published perspective, snapshot READY → the pinned snapshot, read-only.
+ * - Published perspective, snapshot NOT ready → still the draft as the fallback
+ *   render target, but flagged `publishedPending` so the shell shows a placeholder
+ *   instead (the draft must never be shown labelled as the published content).
+ */
+export function resolveViewDoc(input) {
+    const viewReadOnly = input.perspective === 'published';
+    const ready = input.publishedSnapshot.status === 'ready';
+    return {
+        viewReadOnly,
+        viewDoc: viewReadOnly && input.publishedSnapshot.status === 'ready' ? input.publishedSnapshot.doc : input.draft,
+        publishedPending: viewReadOnly && !ready,
+    };
+}
+/**
+ * EC-226 / EC-316 / EC-325 — the Draft/Published VIEW perspective plus the pinned
+ * published snapshot, both derived from the ONE shared version-history query
+ * (AD-17: the single operations-backed cache, `use-document-versions.ts` — no raw
+ * `source.versioning.load` call). The Discard-draft gating and the Published
+ * perspective read exactly the same `versions`/`publishedVersion` shape, so a
+ * second bespoke fetch on perspective switch would just re-read this. Gated the
+ * same way Discard always was — a publishing + versioned rail AND a published
+ * document — which is also exactly when the Published perspective is reachable.
+ */
+export function usePublishedPerspective(input) {
+    const { ref, source, canPublish, canVersions, draft } = input;
+    const published = source.publishing?.isPublished(ref) ?? false;
+    const [perspective, setPerspective] = useState('draft');
+    // Snap back to Draft if the document is unpublished while viewing Published.
+    useEffect(() => {
+        if (!published)
+            setPerspective('draft');
+    }, [published]);
+    const canDiscard = canPublish && canVersions;
+    const { versionsQuery, versionKey } = useDocumentVersionsQuery(ref, {
+        enabled: canDiscard && published,
+    });
+    const versionsView = versionsQuery.data ?? null;
+    const publishedVersionNumber = versionsView?.publishedVersion;
+    const publishedSnapshotDoc = publishedVersionSnapshot(versionsView);
+    const publishedSnapshot = derivePublishedSnapshot(versionsView);
+    const { viewReadOnly, viewDoc, publishedPending } = resolveViewDoc({ perspective, publishedSnapshot, draft });
+    return {
+        perspective,
+        setPerspective,
+        published,
+        canDiscard,
+        versionsView,
+        versionKey,
+        publishedVersionNumber,
+        publishedSnapshotDoc,
+        publishedSnapshot,
+        viewReadOnly,
+        viewDoc,
+        publishedPending,
+    };
+}
+//# sourceMappingURL=use-published-perspective.js.map

package/dist/components/cms/use-published-perspective.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-published-perspective.js","sourceRoot":"","sources":["../../../src/components/cms/use-published-perspective.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAK3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAKpF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAI9B;IACC,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,KAAK,WAAW,CAAA;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,KAAK,OAAO,CAAA;IACxD,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;QAC/G,gBAAgB,EAAE,YAAY,IAAI,CAAC,KAAK;KACzC,CAAA;AACH,CAAC;AA2BD;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAMvC;IACC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,KAAK,CAAA;IAC9D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAc,OAAO,CAAC,CAAA;IACpE,6EAA6E;IAC7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAEf,MAAM,UAAU,GAAG,UAAU,IAAI,WAAW,CAAA;IAC5C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,wBAAwB,CAAC,GAAG,EAAE;QAClE,OAAO,EAAE,UAAU,IAAI,SAAS;KACjC,CAAC,CAAA;IACF,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,IAAI,IAAI,CAAA;IAC/C,MAAM,sBAAsB,GAAG,YAAY,EAAE,gBAAgB,CAAA;IAC7D,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAA;IACnE,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAA;IAC/D,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,cAAc,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAA;IAE7G,OAAO;QACL,WAAW;QACX,cAAc;QACd,SAAS;QACT,UAAU;QACV,YAAY;QACZ,UAAU;QACV,sBAAsB;QACtB,oBAAoB;QACpB,iBAAiB;QACjB,YAAY;QACZ,OAAO;QACP,gBAAgB;KACjB,CAAA;AACH,CAAC","sourcesContent":["import { useEffect, useState } from 'react'\nimport type { QueryKey } from '@tanstack/react-query'\nimport type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport type { DocumentVersionsView } from './cms-store'\nimport { useDocumentVersionsQuery } from './use-document-versions'\nimport { derivePublishedSnapshot, publishedVersionSnapshot } from './versions-model'\nimport type { PublishedSnapshotState } from './versions-model'\n\nexport type Perspective = 'draft' | 'published'\n\n/**\n * EC-226 — which document the fieldset renders, given the active perspective and\n * the pinned published snapshot's load state. A pure decision so \"never present\n * the draft AS published\" is single-sourced and directly testable:\n *\n * - Draft perspective → the live draft, editable.\n * - Published perspective, snapshot READY → the pinned snapshot, read-only.\n * - Published perspective, snapshot NOT ready → still the draft as the fallback\n *   render target, but flagged `publishedPending` so the shell shows a placeholder\n *   instead (the draft must never be shown labelled as the published content).\n */\nexport function resolveViewDoc(input: {\n  perspective: Perspective\n  publishedSnapshot: PublishedSnapshotState\n  draft: CmsDocument\n}): { viewReadOnly: boolean; viewDoc: CmsDocument; publishedPending: boolean } {\n  const viewReadOnly = input.perspective === 'published'\n  const ready = input.publishedSnapshot.status === 'ready'\n  return {\n    viewReadOnly,\n    viewDoc: viewReadOnly && input.publishedSnapshot.status === 'ready' ? input.publishedSnapshot.doc : input.draft,\n    publishedPending: viewReadOnly && !ready,\n  }\n}\n\nexport interface PublishedPerspective {\n  perspective: Perspective\n  setPerspective: (perspective: Perspective) => void\n  /** Is the document published (a version pointer is set)? */\n  published: boolean\n  /** A publishing AND versioned rail — gates the version-history query + Discard. */\n  canDiscard: boolean\n  /** The recorded version history (null while loading / disabled). */\n  versionsView: DocumentVersionsView | null\n  /** The shared version-history cache key ({@link documentVersionsKey}). */\n  versionKey: QueryKey\n  /** The pinned published version number, or undefined while loading / none pinned. */\n  publishedVersionNumber: number | undefined\n  /** The pinned published version's snapshot, or undefined while loading / none. */\n  publishedSnapshotDoc: CmsDocument | undefined\n  /** The loaded state of the pinned published snapshot. */\n  publishedSnapshot: PublishedSnapshotState\n  /** Is the editor viewing the read-only Published snapshot? */\n  viewReadOnly: boolean\n  /** The document the fieldset renders (draft or the pinned snapshot). */\n  viewDoc: CmsDocument\n  /** Is the Published snapshot still loading (show a placeholder, not the draft)? */\n  publishedPending: boolean\n}\n\n/**\n * EC-226 / EC-316 / EC-325 — the Draft/Published VIEW perspective plus the pinned\n * published snapshot, both derived from the ONE shared version-history query\n * (AD-17: the single operations-backed cache, `use-document-versions.ts` — no raw\n * `source.versioning.load` call). The Discard-draft gating and the Published\n * perspective read exactly the same `versions`/`publishedVersion` shape, so a\n * second bespoke fetch on perspective switch would just re-read this. Gated the\n * same way Discard always was — a publishing + versioned rail AND a published\n * document — which is also exactly when the Published perspective is reachable.\n */\nexport function usePublishedPerspective(input: {\n  ref: DocumentRef\n  source: CollectionViewSource\n  canPublish: boolean\n  canVersions: boolean\n  draft: CmsDocument\n}): PublishedPerspective {\n  const { ref, source, canPublish, canVersions, draft } = input\n  const published = source.publishing?.isPublished(ref) ?? false\n  const [perspective, setPerspective] = useState<Perspective>('draft')\n  // Snap back to Draft if the document is unpublished while viewing Published.\n  useEffect(() => {\n    if (!published) setPerspective('draft')\n  }, [published])\n\n  const canDiscard = canPublish && canVersions\n  const { versionsQuery, versionKey } = useDocumentVersionsQuery(ref, {\n    enabled: canDiscard && published,\n  })\n  const versionsView = versionsQuery.data ?? null\n  const publishedVersionNumber = versionsView?.publishedVersion\n  const publishedSnapshotDoc = publishedVersionSnapshot(versionsView)\n  const publishedSnapshot = derivePublishedSnapshot(versionsView)\n  const { viewReadOnly, viewDoc, publishedPending } = resolveViewDoc({ perspective, publishedSnapshot, draft })\n\n  return {\n    perspective,\n    setPerspective,\n    published,\n    canDiscard,\n    versionsView,\n    versionKey,\n    publishedVersionNumber,\n    publishedSnapshotDoc,\n    publishedSnapshot,\n    viewReadOnly,\n    viewDoc,\n    publishedPending,\n  }\n}\n"]}