@elytracms/studio 0.0.24 → 0.0.26

package/dist/components/cms/versions-pane.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions-pane.js","sourceRoot":"","sources":["../../../src/components/cms/versions-pane.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { Eye, RotateCcw } from 'lucide-react'\nimport { Badge, Button, Code, Row, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport { useCms } from './cms-store'\nimport type { DocumentVersionsView } from './cms-store'\nimport { useDocumentEditor } from './document-editor-context'\nimport { formatVersionTimestamp, snapshotMatchesDraft } from './versions-model'\n\n/**\n * EC-224 — the document-level **Versions** inspector pane. Re-homes the EC-180\n * VersionsPanel at the document level (the Sanity model): the continuous draft\n * on top with **Publish**, then the recorded version history (the live pin\n * badged), each older version **restorable** into the draft.\n *\n * Publish routes through the same pointer op as the header control\n * (`cms.publishDocument`); restore loads a recorded snapshot as the new working\n * draft (the operation snapshots the current draft first, so a rollback is\n * itself undoable) and the open editor adopts it via `replaceDraft`. Unpublish\n * deliberately stays in the header — it routes through the EC-173\n * reference-aware confirmation, which this pane does not duplicate.\n */\nexport function VersionsPane() {\n  const cms = useCms()\n  const { docRef, draft, dirty, hasErrors, viewReadOnly, save, replaceDraft } = useDocumentEditor()\n  const [view, setView] = useState<DocumentVersionsView | null>(null)\n  const [busy, setBusy] = useState(false)\n  const published = cms.isPublished(docRef)\n\n  const reload = useCallback(async () => {\n    // Flush any queued publish/save so the listed history is authoritative\n    // regardless of which surface (header or pane) triggered the change.\n    await cms.flushPersistence()\n    setView(await cms.loadDocumentVersions(docRef))\n  }, [cms, docRef])\n\n  useEffect(() => {\n    void reload()\n    // Re-load when publish-ness flips from anywhere (e.g. the header control).\n  }, [reload, published])\n\n  const liveSnapshot =\n    view?.publishedVersion !== undefined\n      ? view.versions.find((v) => v.version === view.publishedVersion)?.snapshot\n      : undefined\n  // Value-equality (key-order-insensitive) so a just-published, unchanged doc\n  // doesn't read as \"unpublished changes\" — see snapshotMatchesDraft.\n  const liveMatchesDraft = liveSnapshot !== undefined && snapshotMatchesDraft(liveSnapshot, draft)\n  const canPublish = !liveMatchesDraft\n\n  const handlePublish = useCallback(async () => {\n    setBusy(true)\n    try {\n      // Publish snapshots the SAVED draft — capture any unsaved edits first so\n      // the published version is exactly what the editor shows. Await the\n      // publish (it flushes + reconciles the pin, EC-225) before re-reading the\n      // version list so the new version shows.\n      if (dirty) save()\n      await cms.publishDocument(docRef)\n      await reload()\n    } finally {\n      setBusy(false)\n    }\n  }, [cms, docRef, dirty, save, reload])\n\n  const handleRestore = useCallback(\n    async (version: number) => {\n      setBusy(true)\n      try {\n        // Capture any unsaved buffer edits FIRST so the operation's pre-restore\n        // snapshot records them — otherwise they'd be lost and the rollback\n        // wouldn't be undoable (restore snapshots the persisted draft).\n        if (dirty) save()\n        const restored = await cms.restoreDocumentVersion(docRef, version)\n        if (restored) replaceDraft(restored)\n        await reload()\n      } finally {\n        setBusy(false)\n      }\n    },\n    [cms, docRef, dirty, save, replaceDraft, reload],\n  )\n\n  return (\n    <Stack gap=\"3\" className=\"p-3\">\n      {canPublish ? (\n        <Row gap=\"2\" align=\"center\" className=\"rounded-md border border-primary/40 bg-primary/5 px-2.5 py-2\">\n          <Stack gap=\"none\" className=\"min-w-0\">\n            <Text size=\"sm\" weight=\"medium\">\n              Draft\n            </Text>\n            <Text size=\"xs\" tone=\"muted\">\n              {published ? 'Unpublished changes' : 'Not published yet'}\n            </Text>\n          </Stack>\n          <Spacer />\n          <Button\n            size=\"sm\"\n            onClick={handlePublish}\n            disabled={busy || hasErrors || viewReadOnly}\n            title={\n              viewReadOnly\n                ? 'Switch to Draft to publish'\n                : hasErrors\n                  ? 'Fix the document’s validation issues to publish'\n                  : undefined\n            }\n          >\n            <Eye /> Publish\n          </Button>\n        </Row>\n      ) : (\n        <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n          The live version is up to date — nothing to publish.\n        </Text>\n      )}\n\n      <Stack gap=\"1\">\n        {view === null ? (\n          <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n            Loading…\n          </Text>\n        ) : view.versions.length === 0 ? (\n          <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n            No published versions yet.\n          </Text>\n        ) : (\n          view.versions.map((entry) => {\n            const isLive = entry.version === view.publishedVersion\n            return (\n              <Row\n                key={entry.version}\n                gap=\"2\"\n                align=\"center\"\n                className=\"rounded-md border border-border/60 px-2.5 py-1.5\"\n              >\n                <Code tone={isLive ? 'primary' : 'muted'}>v{entry.version}</Code>\n                {isLive ? <Badge variant=\"success\">Published</Badge> : null}\n                <Text size=\"xs\" tone=\"subtle\" mono className=\"truncate\">\n                  {formatVersionTimestamp(entry.createdAt)}\n                </Text>\n                <Spacer />\n                {isLive ? null : (\n                  <Button\n                    size=\"sm\"\n                    variant=\"outline\"\n                    onClick={() => void handleRestore(entry.version)}\n                    disabled={busy || viewReadOnly}\n                    title={viewReadOnly ? 'Switch to Draft to restore' : undefined}\n                  >\n                    <RotateCcw /> Restore\n                  </Button>\n                )}\n              </Row>\n            )\n          })\n        )}\n      </Stack>\n    </Stack>\n  )\n}\n"]}
+{"version":3,"file":"versions-pane.js","sourceRoot":"","sources":["../../../src/components/cms/versions-pane.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport { Eye, RotateCcw } from 'lucide-react'\nimport { Badge, Button, Code, Row, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { useCms } from './cms-store'\nimport type { DocumentVersionsView } from './cms-store'\nimport { useDocumentEditor } from './document-editor-context'\nimport { formatVersionTimestamp, snapshotMatchesDraft } from './versions-model'\n\n/** Recorded-version freshness: any document command (publish/restore/upsert)\n *  may change the history, so re-read on the whole `documents` domain. */\nconst VERSION_RELOAD_OPS = ['documents'] as const\n\n/**\n * EC-224 — the document-level **Versions** inspector pane. Re-homes the EC-180\n * VersionsPanel at the document level (the Sanity model): the continuous draft\n * on top with **Publish**, then the recorded version history (the live pin\n * badged), each older version **restorable** into the draft.\n *\n * Publish routes through the same pointer op as the header control\n * (`cms.publishDocument`); restore loads a recorded snapshot as the new working\n * draft (the operation snapshots the current draft first, so a rollback is\n * itself undoable) and the open editor adopts it via `replaceDraft`. Unpublish\n * deliberately stays in the header — it routes through the EC-173\n * reference-aware confirmation, which this pane does not duplicate.\n */\nexport function VersionsPane() {\n  const cms = useCms()\n  const { docRef, draft, dirty, hasErrors, viewReadOnly, save, replaceDraft } = useDocumentEditor()\n  const [busy, setBusy] = useState(false)\n  const published = cms.isPublished(docRef)\n  const cache = useOperationCache()\n\n  // The recorded version history, read through the one operations-backed query\n  // cache (EC-308/AD-17). The flush-before-read ordering (so the listed history\n  // is authoritative regardless of which surface triggered the change) lives IN\n  // the loader, so every fetch — initial, invalidated, or a manual refetch —\n  // is correctly sequenced. `invalidateOn: documents` refreshes it whenever a\n  // publish/restore/save lands from anywhere (replacing the old `published`-flip\n  // reload). The editor draft/dirty/busy state stays local — it is not server\n  // state (principle 12).\n  const versionKey = useMemo(\n    () => ['documentVersions', cms.projectId ?? '∅', docRef.collection, docRef.id],\n    [cms.projectId, docRef.collection, docRef.id],\n  )\n  const versionsQuery = useOperationQuery<DocumentVersionsView>({\n    queryKey: versionKey,\n    loader: async () => {\n      await cms.flushPersistence()\n      return cms.loadDocumentVersions(docRef)\n    },\n    invalidateOn: VERSION_RELOAD_OPS,\n  })\n  const view = versionsQuery.data ?? null\n\n  const liveSnapshot =\n    view?.publishedVersion !== undefined\n      ? view.versions.find((v) => v.version === view.publishedVersion)?.snapshot\n      : undefined\n  // Value-equality (key-order-insensitive) so a just-published, unchanged doc\n  // doesn't read as \"unpublished changes\" — see snapshotMatchesDraft.\n  const liveMatchesDraft = liveSnapshot !== undefined && snapshotMatchesDraft(liveSnapshot, draft)\n  const canPublish = !liveMatchesDraft\n\n  const handlePublish = useCallback(async () => {\n    setBusy(true)\n    try {\n      // Publish snapshots the SAVED draft — capture any unsaved edits first so\n      // the published version is exactly what the editor shows. Await the\n      // publish (it flushes + reconciles the pin, EC-225) before re-reading the\n      // version list so the new version shows.\n      if (dirty) save()\n      await cms.publishDocument(docRef)\n      await cache.invalidate(versionKey)\n    } finally {\n      setBusy(false)\n    }\n  }, [cms, docRef, dirty, save, cache, versionKey])\n\n  const handleRestore = useCallback(\n    async (version: number) => {\n      setBusy(true)\n      try {\n        // Capture any unsaved buffer edits FIRST so the operation's pre-restore\n        // snapshot records them — otherwise they'd be lost and the rollback\n        // wouldn't be undoable (restore snapshots the persisted draft).\n        if (dirty) save()\n        const restored = await cms.restoreDocumentVersion(docRef, version)\n        if (restored) replaceDraft(restored)\n        await cache.invalidate(versionKey)\n      } finally {\n        setBusy(false)\n      }\n    },\n    [cms, docRef, dirty, save, replaceDraft, cache, versionKey],\n  )\n\n  return (\n    <Stack gap=\"3\" className=\"p-3\">\n      {canPublish ? (\n        <Row gap=\"2\" align=\"center\" className=\"rounded-md border border-primary/40 bg-primary/5 px-2.5 py-2\">\n          <Stack gap=\"none\" className=\"min-w-0\">\n            <Text size=\"sm\" weight=\"medium\">\n              Draft\n            </Text>\n            <Text size=\"xs\" tone=\"muted\">\n              {published ? 'Unpublished changes' : 'Not published yet'}\n            </Text>\n          </Stack>\n          <Spacer />\n          <Button\n            size=\"sm\"\n            onClick={handlePublish}\n            disabled={busy || hasErrors || viewReadOnly}\n            title={\n              viewReadOnly\n                ? 'Switch to Draft to publish'\n                : hasErrors\n                  ? 'Fix the document’s validation issues to publish'\n                  : undefined\n            }\n          >\n            <Eye /> Publish\n          </Button>\n        </Row>\n      ) : (\n        <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n          The live version is up to date — nothing to publish.\n        </Text>\n      )}\n\n      <Stack gap=\"1\">\n        {view === null ? (\n          <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n            Loading…\n          </Text>\n        ) : view.versions.length === 0 ? (\n          <Text size=\"xs\" tone=\"muted\" className=\"px-0.5\">\n            No published versions yet.\n          </Text>\n        ) : (\n          view.versions.map((entry) => {\n            const isLive = entry.version === view.publishedVersion\n            return (\n              <Row\n                key={entry.version}\n                gap=\"2\"\n                align=\"center\"\n                className=\"rounded-md border border-border/60 px-2.5 py-1.5\"\n              >\n                <Code tone={isLive ? 'primary' : 'muted'}>v{entry.version}</Code>\n                {isLive ? <Badge variant=\"success\">Published</Badge> : null}\n                <Text size=\"xs\" tone=\"subtle\" mono className=\"truncate\">\n                  {formatVersionTimestamp(entry.createdAt)}\n                </Text>\n                <Spacer />\n                {isLive ? null : (\n                  <Button\n                    size=\"sm\"\n                    variant=\"outline\"\n                    onClick={() => void handleRestore(entry.version)}\n                    disabled={busy || viewReadOnly}\n                    title={viewReadOnly ? 'Switch to Draft to restore' : undefined}\n                  >\n                    <RotateCcw /> Restore\n                  </Button>\n                )}\n              </Row>\n            )\n          })\n        )}\n      </Stack>\n    </Stack>\n  )\n}\n"]}

package/dist/components/project-session.d.ts

@@ -19,6 +19,17 @@ import type { HydratedCms, HydratedProjectSession, OperationResult } from '@elyt
  * (`lib/data/collection-content`) is pointed at the hydrated documents
  * BEFORE children render, so "Preview with" lists and section previews show
  * live entries, not fixture titles.
+ *
+ * EC-308/AD-17 note — this gate deliberately does NOT read through the
+ * `useOperationQuery` cache seam. It is boot/session orchestration, not a
+ * cacheable server read: (1) the synchronous playground first-render is the
+ * EC-138 determinism contract (a pull-query is async even when disabled);
+ * (2) `configureContentSession` must run synchronously BEFORE children mount,
+ * which a post-render query effect cannot guarantee; (3) `CmsSessionGate` is
+ * intentionally fresh-per-visit (it remounts to show edits persisted since
+ * project open) — the opposite of a cached read. It still reads through the
+ * operations client (no transport bypass), and uses a user-driven retry epoch,
+ * not freshness machinery — so it is outside the patchwork AD-17 retires.
  */
 export interface ProjectSessionStore {
     /** Hydrated persisted state (Convex mode); `null` in playground (fixtures). */

package/dist/components/project-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-session.js","sourceRoot":"","sources":["../../src/components/project-session.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useCallback, useContext, useEffect, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { Button, Stack, Text } from '@elytracms/studio/ui'\nimport { getStudioOperations, loadHydratedCms, loadProjectSession } from '@elytracms/studio/lib/operations'\nimport type {\n  HydratedCms,\n  HydratedProjectSession,\n  OperationError,\n  OperationResult,\n} from '@elytracms/studio/lib/operations'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { configureContentSession } from '@elytracms/studio/lib/data'\nimport { resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace'\nimport { OperationErrorBanner } from './operation-error'\n\n/**\n * Project-session hydration gate (Milestone B sign-off fix, EC-177 gap 1).\n *\n * In Convex mode every project session must BOOT from persistence: the\n * builder from the latest persisted graph revision, the CMS from the saved\n * schema + documents, publishing from the persisted environment states.\n * This provider runs the `@elytracms/core/operations` hydration queries\n * (`lib/operations/session-hydration`) and — like `BackendGate` — gates its\n * children on a deterministic loading state, so fixture content never\n * flashes (and is never editable) before the persisted state arrives.\n *\n * Playground mode renders children synchronously with `session: null`\n * (fixtures), byte-identical to the pre-hydration behavior — the EC-138\n * determinism contract.\n *\n * Side effect on hydration: the content preview engine\n * (`lib/data/collection-content`) is pointed at the hydrated documents\n * BEFORE children render, so \"Preview with\" lists and section previews show\n * live entries, not fixture titles.\n */\n\nexport interface ProjectSessionStore {\n  /** Hydrated persisted state (Convex mode); `null` in playground (fixtures). */\n  session: HydratedProjectSession | null\n  /**\n   * Load the CURRENT persisted CMS state (fresh query — the CMS section\n   * remounts per visit and must show edits persisted since project open).\n   * Playground resolves `null` immediately (fixtures).\n   */\n  loadCms(): Promise<OperationResult<HydratedCms | null>>\n}\n\nconst ProjectSessionContext = createContext<ProjectSessionStore | null>(null)\n\ntype Phase =\n  | { kind: 'loading' }\n  | { kind: 'ready'; session: HydratedProjectSession | null }\n  | { kind: 'error'; error: OperationError }\n\nexport function ProjectSessionProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const playground = isPlaygroundMode()\n  // Playground renders children on the FIRST render (no effect round-trip):\n  // fixture boots stay synchronous and deterministic.\n  const [phase, setPhase] = useState<Phase>(() =>\n    playground ? { kind: 'ready', session: null } : { kind: 'loading' },\n  )\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    if (playground) {\n      configureContentSession(null)\n      return\n    }\n    let cancelled = false\n    setPhase({ kind: 'loading' })\n    void getStudioOperations()\n      .then(({ operations }) => loadProjectSession(operations, projectId))\n      .then((result) => {\n        if (cancelled) return\n        if (!result.ok) {\n          setPhase({ kind: 'error', error: result.error })\n          return\n        }\n        // Point the preview content engine at the hydrated documents before\n        // any child renders (panels read it module-level, synchronously). EC-291:\n        // include the config-sourced routes so the canvas `resolveLink` derives a\n        // rich-text link's URL exactly as delivery does.\n        configureContentSession(\n          result.value.cms\n            ? { ...result.value.cms, routes: resolveDeploymentRoutes() }\n            : null,\n        )\n        setPhase({ kind: 'ready', session: result.value })\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [projectId, playground, attempt])\n\n  // Leaving the project resets the preview engine to fixtures; the next\n  // project's gate reconfigures it before rendering its own children.\n  useEffect(() => () => configureContentSession(null), [])\n\n  const loadCms = useCallback(async (): Promise<OperationResult<HydratedCms | null>> => {\n    if (playground) return { ok: true, value: null }\n    const { operations } = await getStudioOperations()\n    const result = await loadHydratedCms(operations, projectId)\n    // Keep the preview engine in sync with the freshest persisted content.\n    if (result.ok && result.value !== null)\n      configureContentSession({ ...result.value, routes: resolveDeploymentRoutes() })\n    return result\n  }, [playground, projectId])\n\n  if (phase.kind === 'loading') return <SessionHydrating />\n  if (phase.kind === 'error') {\n    return (\n      <SessionHydrationError error={phase.error} onRetry={() => setAttempt((n) => n + 1)} />\n    )\n  }\n  return (\n    <ProjectSessionContext.Provider value={{ session: phase.session, loadCms }}>\n      {children}\n    </ProjectSessionContext.Provider>\n  )\n}\n\nexport function useProjectSession(): ProjectSessionStore {\n  const store = useContext(ProjectSessionContext)\n  if (!store) {\n    throw new Error('useProjectSession must be used within a <ProjectSessionProvider>.')\n  }\n  return store\n}\n\n/**\n * Gate one CMS surface mount on a FRESH persisted CMS load (Convex mode).\n * Render-prop: hands the hydrated content (or `null` → fixture fallback,\n * first-run) to the caller once it resolved. Playground renders synchronously\n * with `null`.\n */\nexport function CmsSessionGate({\n  children,\n}: {\n  children: (cms: HydratedCms | null) => ReactNode\n}) {\n  const { loadCms } = useProjectSession()\n  const playground = isPlaygroundMode()\n  const [phase, setPhase] = useState<\n    | { kind: 'loading' }\n    | { kind: 'ready'; cms: HydratedCms | null }\n    | { kind: 'error'; error: OperationError }\n  >(() => (playground ? { kind: 'ready', cms: null } : { kind: 'loading' }))\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    if (playground) return\n    let cancelled = false\n    setPhase({ kind: 'loading' })\n    void loadCms().then((result) => {\n      if (cancelled) return\n      setPhase(result.ok ? { kind: 'ready', cms: result.value } : { kind: 'error', error: result.error })\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [playground, loadCms, attempt])\n\n  if (phase.kind === 'loading') return <SessionHydrating />\n  if (phase.kind === 'error') {\n    return (\n      <SessionHydrationError error={phase.error} onRetry={() => setAttempt((n) => n + 1)} />\n    )\n  }\n  return <>{children(phase.cms)}</>\n}\n\n/** Deterministic loading frame while persisted state is fetched (mirrors BackendGate). */\nfunction SessionHydrating() {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\" data-testid=\"session-hydrating\">\n      <Text size=\"sm\" tone=\"muted\">\n        Loading project…\n      </Text>\n    </div>\n  )\n}\n\n/** A failed hydration is a visible, retryable state — never a fixture fallback. */\nfunction SessionHydrationError({\n  error,\n  onRetry,\n}: {\n  error: OperationError\n  onRetry: () => void\n}) {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\">\n      <Stack gap=\"3\" className=\"w-full max-w-xl\">\n        <Text size=\"sm\" weight=\"semibold\">\n          Couldn’t load this project’s saved state\n        </Text>\n        <OperationErrorBanner error={error} />\n        <Text size=\"xs\" tone=\"muted\">\n          The studio never falls back to sample content against a live backend — your data is\n          safe; retry once the backend is reachable.\n        </Text>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry} className=\"self-start\">\n          Retry\n        </Button>\n      </Stack>\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"project-session.js","sourceRoot":"","sources":["../../src/components/project-session.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useCallback, useContext, useEffect, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { Button, Stack, Text } from '@elytracms/studio/ui'\nimport { getStudioOperations, loadHydratedCms, loadProjectSession } from '@elytracms/studio/lib/operations'\nimport type {\n  HydratedCms,\n  HydratedProjectSession,\n  OperationError,\n  OperationResult,\n} from '@elytracms/studio/lib/operations'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { configureContentSession } from '@elytracms/studio/lib/data'\nimport { resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace'\nimport { OperationErrorBanner } from './operation-error'\n\n/**\n * Project-session hydration gate (Milestone B sign-off fix, EC-177 gap 1).\n *\n * In Convex mode every project session must BOOT from persistence: the\n * builder from the latest persisted graph revision, the CMS from the saved\n * schema + documents, publishing from the persisted environment states.\n * This provider runs the `@elytracms/core/operations` hydration queries\n * (`lib/operations/session-hydration`) and — like `BackendGate` — gates its\n * children on a deterministic loading state, so fixture content never\n * flashes (and is never editable) before the persisted state arrives.\n *\n * Playground mode renders children synchronously with `session: null`\n * (fixtures), byte-identical to the pre-hydration behavior — the EC-138\n * determinism contract.\n *\n * Side effect on hydration: the content preview engine\n * (`lib/data/collection-content`) is pointed at the hydrated documents\n * BEFORE children render, so \"Preview with\" lists and section previews show\n * live entries, not fixture titles.\n *\n * EC-308/AD-17 note — this gate deliberately does NOT read through the\n * `useOperationQuery` cache seam. It is boot/session orchestration, not a\n * cacheable server read: (1) the synchronous playground first-render is the\n * EC-138 determinism contract (a pull-query is async even when disabled);\n * (2) `configureContentSession` must run synchronously BEFORE children mount,\n * which a post-render query effect cannot guarantee; (3) `CmsSessionGate` is\n * intentionally fresh-per-visit (it remounts to show edits persisted since\n * project open) — the opposite of a cached read. It still reads through the\n * operations client (no transport bypass), and uses a user-driven retry epoch,\n * not freshness machinery — so it is outside the patchwork AD-17 retires.\n */\n\nexport interface ProjectSessionStore {\n  /** Hydrated persisted state (Convex mode); `null` in playground (fixtures). */\n  session: HydratedProjectSession | null\n  /**\n   * Load the CURRENT persisted CMS state (fresh query — the CMS section\n   * remounts per visit and must show edits persisted since project open).\n   * Playground resolves `null` immediately (fixtures).\n   */\n  loadCms(): Promise<OperationResult<HydratedCms | null>>\n}\n\nconst ProjectSessionContext = createContext<ProjectSessionStore | null>(null)\n\ntype Phase =\n  | { kind: 'loading' }\n  | { kind: 'ready'; session: HydratedProjectSession | null }\n  | { kind: 'error'; error: OperationError }\n\nexport function ProjectSessionProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const playground = isPlaygroundMode()\n  // Playground renders children on the FIRST render (no effect round-trip):\n  // fixture boots stay synchronous and deterministic.\n  const [phase, setPhase] = useState<Phase>(() =>\n    playground ? { kind: 'ready', session: null } : { kind: 'loading' },\n  )\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    if (playground) {\n      configureContentSession(null)\n      return\n    }\n    let cancelled = false\n    setPhase({ kind: 'loading' })\n    void getStudioOperations()\n      .then(({ operations }) => loadProjectSession(operations, projectId))\n      .then((result) => {\n        if (cancelled) return\n        if (!result.ok) {\n          setPhase({ kind: 'error', error: result.error })\n          return\n        }\n        // Point the preview content engine at the hydrated documents before\n        // any child renders (panels read it module-level, synchronously). EC-291:\n        // include the config-sourced routes so the canvas `resolveLink` derives a\n        // rich-text link's URL exactly as delivery does.\n        configureContentSession(\n          result.value.cms\n            ? { ...result.value.cms, routes: resolveDeploymentRoutes() }\n            : null,\n        )\n        setPhase({ kind: 'ready', session: result.value })\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [projectId, playground, attempt])\n\n  // Leaving the project resets the preview engine to fixtures; the next\n  // project's gate reconfigures it before rendering its own children.\n  useEffect(() => () => configureContentSession(null), [])\n\n  const loadCms = useCallback(async (): Promise<OperationResult<HydratedCms | null>> => {\n    if (playground) return { ok: true, value: null }\n    const { operations } = await getStudioOperations()\n    const result = await loadHydratedCms(operations, projectId)\n    // Keep the preview engine in sync with the freshest persisted content.\n    if (result.ok && result.value !== null)\n      configureContentSession({ ...result.value, routes: resolveDeploymentRoutes() })\n    return result\n  }, [playground, projectId])\n\n  if (phase.kind === 'loading') return <SessionHydrating />\n  if (phase.kind === 'error') {\n    return (\n      <SessionHydrationError error={phase.error} onRetry={() => setAttempt((n) => n + 1)} />\n    )\n  }\n  return (\n    <ProjectSessionContext.Provider value={{ session: phase.session, loadCms }}>\n      {children}\n    </ProjectSessionContext.Provider>\n  )\n}\n\nexport function useProjectSession(): ProjectSessionStore {\n  const store = useContext(ProjectSessionContext)\n  if (!store) {\n    throw new Error('useProjectSession must be used within a <ProjectSessionProvider>.')\n  }\n  return store\n}\n\n/**\n * Gate one CMS surface mount on a FRESH persisted CMS load (Convex mode).\n * Render-prop: hands the hydrated content (or `null` → fixture fallback,\n * first-run) to the caller once it resolved. Playground renders synchronously\n * with `null`.\n */\nexport function CmsSessionGate({\n  children,\n}: {\n  children: (cms: HydratedCms | null) => ReactNode\n}) {\n  const { loadCms } = useProjectSession()\n  const playground = isPlaygroundMode()\n  const [phase, setPhase] = useState<\n    | { kind: 'loading' }\n    | { kind: 'ready'; cms: HydratedCms | null }\n    | { kind: 'error'; error: OperationError }\n  >(() => (playground ? { kind: 'ready', cms: null } : { kind: 'loading' }))\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    if (playground) return\n    let cancelled = false\n    setPhase({ kind: 'loading' })\n    void loadCms().then((result) => {\n      if (cancelled) return\n      setPhase(result.ok ? { kind: 'ready', cms: result.value } : { kind: 'error', error: result.error })\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [playground, loadCms, attempt])\n\n  if (phase.kind === 'loading') return <SessionHydrating />\n  if (phase.kind === 'error') {\n    return (\n      <SessionHydrationError error={phase.error} onRetry={() => setAttempt((n) => n + 1)} />\n    )\n  }\n  return <>{children(phase.cms)}</>\n}\n\n/** Deterministic loading frame while persisted state is fetched (mirrors BackendGate). */\nfunction SessionHydrating() {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\" data-testid=\"session-hydrating\">\n      <Text size=\"sm\" tone=\"muted\">\n        Loading project…\n      </Text>\n    </div>\n  )\n}\n\n/** A failed hydration is a visible, retryable state — never a fixture fallback. */\nfunction SessionHydrationError({\n  error,\n  onRetry,\n}: {\n  error: OperationError\n  onRetry: () => void\n}) {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\">\n      <Stack gap=\"3\" className=\"w-full max-w-xl\">\n        <Text size=\"sm\" weight=\"semibold\">\n          Couldn’t load this project’s saved state\n        </Text>\n        <OperationErrorBanner error={error} />\n        <Text size=\"xs\" tone=\"muted\">\n          The studio never falls back to sample content against a live backend — your data is\n          safe; retry once the backend is reachable.\n        </Text>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry} className=\"self-start\">\n          Retry\n        </Button>\n      </Stack>\n    </div>\n  )\n}\n"]}

package/dist/components/routes/routes-shell.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useMemo } from 'react';
 import { createRouter } from '@elytracms/core/cms-core';
 import { Badge, Heading, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
-import { getStudioOperations } from '@elytracms/studio/lib/operations';
+import { useOperationQuery } from '@elytracms/studio/lib/query';
 import { conflictsByRoute } from '@elytracms/studio/lib/routing';
 import { resolveDeploymentRedirects, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace';
 import { OperationErrorBanner } from '../operation-error';
@@ -10,6 +10,9 @@ import { RouteList } from './route-list';
 import { RedirectManager } from './redirect-manager';
 /** The body-is-a-canvas page collection (EC-187): routable page documents. */
 const PAGE_COLLECTION = 'page';
+/** Page-label freshness: re-read the labels when any document command lands. */
+const PAGE_LABEL_RELOAD_OPS = ['documents'];
+const EMPTY_PAGES = [];
 /**
  * Routable pages come from the `page` CMS collection (EC-192) — the documents an
  * editor actually creates — not the builder's single synthetic working page.
@@ -22,6 +25,12 @@ function pageSummaries(records) {
         return { id: document.id, name: typeof name === 'string' && name.length > 0 ? name : document.id };
     });
 }
+async function loadPageLabels(operations, projectId) {
+    const result = await operations.documents.list({ projectId, collection: PAGE_COLLECTION });
+    if (result.ok)
+        return { pages: pageSummaries(result.value), error: null };
+    return { pages: [], error: result.error };
+}
 /**
  * The Routes surface (EC-170, made read-only by EC-207 "routes as code"):
  * every route and redirect of the project, with the engine's structured issues
@@ -38,31 +47,22 @@ export function RoutesShell({ project }) {
     // the active `elytra.config.ts` project, never fetched from the backend.
     const routes = useMemo(() => resolveDeploymentRoutes(), []);
     const redirects = useMemo(() => resolveDeploymentRedirects(), []);
-    const [pages, setPages] = useState([]);
-    const [loadError, setLoadError] = useState(null);
-    // Page documents feed the route target labels (read-only display). A failure
-    // here is non-fatal: the routes still render; the page labels just fall back
-    // to ids. The error banner surfaces any connection problem.
-    const reloadPages = useCallback(async () => {
-        const { operations } = await getStudioOperations();
-        const pageDocs = await operations.documents.list({ projectId, collection: PAGE_COLLECTION });
-        if (pageDocs.ok) {
-            setPages(pageSummaries(pageDocs.value));
-            setLoadError(null);
-        }
-        else {
-            setLoadError(pageDocs.error);
-        }
-    }, [projectId]);
-    useEffect(() => {
-        void reloadPages();
-    }, [reloadPages]);
+    // Page documents feed the route target labels (read-only display), read through
+    // the one operations-backed query cache (EC-308/AD-17) and kept fresh as
+    // documents change. A failure is non-fatal — see `loadPageLabels`.
+    const pagesQuery = useOperationQuery({
+        queryKey: ['routePageLabels', projectId],
+        loader: (operations) => loadPageLabels(operations, projectId),
+        invalidateOn: PAGE_LABEL_RELOAD_OPS,
+    });
+    const pages = pagesQuery.data?.pages ?? EMPTY_PAGES;
+    const loadError = pagesQuery.data?.error ?? null;
     // The engine: one router over the config-resolved records. Its structured
     // issues are the single source of conflict/loop truth for this surface.
     const router = useMemo(() => createRouter(routes, redirects, {
         defaultLocale: project.settings.defaultLocale,
     }), [routes, redirects, project.settings.defaultLocale]);
     const conflicts = useMemo(() => conflictsByRoute(router.issues), [router]);
-    return (_jsxs(Stack, { gap: "none", className: "min-h-full", "data-testid": "routes-shell", children: [_jsxs(Row, { gap: "3", className: "shrink-0 border-b border-border px-4 py-3 sm:px-6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { level: 2, size: "h3", children: "Routes & redirects" }), _jsxs(Text, { size: "xs", tone: "muted", children: ["Routes & redirects are defined in ", _jsx("code", { children: "elytra.config.ts" }), ". Conflicts and loops are detected by the canonical route engine \u2014 never silently."] })] }), _jsx(Spacer, {}), loadError ? (_jsx(OperationErrorBanner, { error: loadError, onDismiss: () => void reloadPages() })) : null, router.issues.length > 0 ? (_jsxs(Badge, { variant: "error", "data-testid": "routing-issue-count", children: [router.issues.length, " issue", router.issues.length === 1 ? '' : 's'] })) : (_jsx(Badge, { variant: "success", children: "no issues" }))] }), _jsxs("div", { className: "grid min-h-0 flex-1 grid-cols-1 xl:grid-cols-[minmax(0,5fr)_minmax(0,4fr)]", children: [_jsx("section", { "aria-label": "Routes", className: "min-w-0 border-b border-border xl:border-b-0 xl:border-r", children: _jsx(RouteList, { projectId: projectId, routes: routes, conflicts: conflicts, pages: pages }) }), _jsx("section", { "aria-label": "Redirects", className: "min-w-0", children: _jsx(RedirectManager, { redirects: redirects, followRedirects: router.followRedirects }) })] })] }));
+    return (_jsxs(Stack, { gap: "none", className: "min-h-full", "data-testid": "routes-shell", children: [_jsxs(Row, { gap: "3", className: "shrink-0 border-b border-border px-4 py-3 sm:px-6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { level: 2, size: "h3", children: "Routes & redirects" }), _jsxs(Text, { size: "xs", tone: "muted", children: ["Routes & redirects are defined in ", _jsx("code", { children: "elytra.config.ts" }), ". Conflicts and loops are detected by the canonical route engine \u2014 never silently."] })] }), _jsx(Spacer, {}), loadError ? (_jsx(OperationErrorBanner, { error: loadError, onDismiss: () => void pagesQuery.refetch() })) : null, router.issues.length > 0 ? (_jsxs(Badge, { variant: "error", "data-testid": "routing-issue-count", children: [router.issues.length, " issue", router.issues.length === 1 ? '' : 's'] })) : (_jsx(Badge, { variant: "success", children: "no issues" }))] }), _jsxs("div", { className: "grid min-h-0 flex-1 grid-cols-1 xl:grid-cols-[minmax(0,5fr)_minmax(0,4fr)]", children: [_jsx("section", { "aria-label": "Routes", className: "min-w-0 border-b border-border xl:border-b-0 xl:border-r", children: _jsx(RouteList, { projectId: projectId, routes: routes, conflicts: conflicts, pages: pages }) }), _jsx("section", { "aria-label": "Redirects", className: "min-w-0", children: _jsx(RedirectManager, { redirects: redirects, followRedirects: router.followRedirects }) })] })] }));
 }
 //# sourceMappingURL=routes-shell.js.map

package/dist/components/routes/routes-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-shell.js","sourceRoot":"","sources":["../../../src/components/routes/routes-shell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react'\nimport { createRouter } from '@elytracms/core/cms-core'\nimport type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { Project } from '@elytracms/core/studio-core'\nimport { Badge, Heading, Row, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationError } from '@elytracms/studio/lib/operations'\nimport { conflictsByRoute } from '@elytracms/studio/lib/routing'\nimport { resolveDeploymentRedirects, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace'\nimport { OperationErrorBanner } from '../operation-error'\nimport { RouteList } from './route-list'\nimport type { PageSummary } from './route-list'\nimport { RedirectManager } from './redirect-manager'\n\n/** The body-is-a-canvas page collection (EC-187): routable page documents. */\nconst PAGE_COLLECTION = 'page'\n\n/**\n * Routable pages come from the `page` CMS collection (EC-192) — the documents an\n * editor actually creates — not the builder's single synthetic working page.\n * `documents.list` returns persisted records wrapping each document; map each to\n * a `{ id, name }` summary for the route target labels.\n */\nfunction pageSummaries(records: ReadonlyArray<{ document: CmsDocument }>): PageSummary[] {\n  return records.map(({ document }) => {\n    const name = document.values?.['name']\n    return { id: document.id, name: typeof name === 'string' && name.length > 0 ? name : document.id }\n  })\n}\n\n/**\n * The Routes surface (EC-170, made read-only by EC-207 \"routes as code\"):\n * every route and redirect of the project, with the engine's structured issues\n * (route conflicts, redirect loops) rendered inline. Routes and redirects are\n * authored in `elytra.config.ts` and read from the resolved config project\n * (`resolveDeploymentRoutes`/`resolveDeploymentRedirects`) — NEVER from the\n * backend. This surface only views them; conflict/loop detection comes from the\n * canonical `@elytracms/core/cms-core` router, never from parallel UI-side logic. The\n * page list (CMS `page` collection) is read only to label route targets.\n */\nexport function RoutesShell({ project }: { project: Project }) {\n  const projectId = project.id\n\n  // Routes & redirects are config-sourced (EC-207): resolved synchronously from\n  // the active `elytra.config.ts` project, never fetched from the backend.\n  const routes = useMemo(() => resolveDeploymentRoutes(), [])\n  const redirects = useMemo(() => resolveDeploymentRedirects(), [])\n\n  const [pages, setPages] = useState<PageSummary[]>([])\n  const [loadError, setLoadError] = useState<OperationError | null>(null)\n\n  // Page documents feed the route target labels (read-only display). A failure\n  // here is non-fatal: the routes still render; the page labels just fall back\n  // to ids. The error banner surfaces any connection problem.\n  const reloadPages = useCallback(async () => {\n    const { operations } = await getStudioOperations()\n    const pageDocs = await operations.documents.list({ projectId, collection: PAGE_COLLECTION })\n    if (pageDocs.ok) {\n      setPages(pageSummaries(pageDocs.value))\n      setLoadError(null)\n    } else {\n      setLoadError(pageDocs.error)\n    }\n  }, [projectId])\n\n  useEffect(() => {\n    void reloadPages()\n  }, [reloadPages])\n\n  // The engine: one router over the config-resolved records. Its structured\n  // issues are the single source of conflict/loop truth for this surface.\n  const router = useMemo(\n    () =>\n      createRouter(routes, redirects, {\n        defaultLocale: project.settings.defaultLocale,\n      }),\n    [routes, redirects, project.settings.defaultLocale],\n  )\n  const conflicts = useMemo(() => conflictsByRoute(router.issues), [router])\n\n  return (\n    <Stack gap=\"none\" className=\"min-h-full\" data-testid=\"routes-shell\">\n      <Row gap=\"3\" className=\"shrink-0 border-b border-border px-4 py-3 sm:px-6\">\n        <Stack gap=\"1\">\n          <Heading level={2} size=\"h3\">\n            Routes &amp; redirects\n          </Heading>\n          <Text size=\"xs\" tone=\"muted\">\n            Routes &amp; redirects are defined in <code>elytra.config.ts</code>. Conflicts and loops\n            are detected by the canonical route engine — never silently.\n          </Text>\n        </Stack>\n        <Spacer />\n        {loadError ? (\n          <OperationErrorBanner error={loadError} onDismiss={() => void reloadPages()} />\n        ) : null}\n        {router.issues.length > 0 ? (\n          <Badge variant=\"error\" data-testid=\"routing-issue-count\">\n            {router.issues.length} issue{router.issues.length === 1 ? '' : 's'}\n          </Badge>\n        ) : (\n          <Badge variant=\"success\">no issues</Badge>\n        )}\n      </Row>\n\n      <div className=\"grid min-h-0 flex-1 grid-cols-1 xl:grid-cols-[minmax(0,5fr)_minmax(0,4fr)]\">\n        <section\n          aria-label=\"Routes\"\n          className=\"min-w-0 border-b border-border xl:border-b-0 xl:border-r\"\n        >\n          <RouteList projectId={projectId} routes={routes} conflicts={conflicts} pages={pages} />\n        </section>\n        <section aria-label=\"Redirects\" className=\"min-w-0\">\n          <RedirectManager redirects={redirects} followRedirects={router.followRedirects} />\n        </section>\n      </div>\n    </Stack>\n  )\n}\n"]}
+{"version":3,"file":"routes-shell.js","sourceRoot":"","sources":["../../../src/components/routes/routes-shell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { createRouter } from '@elytracms/core/cms-core'\nimport type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { Project } from '@elytracms/core/studio-core'\nimport { Badge, Heading, Row, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport type { OperationError, OperationsClient } from '@elytracms/studio/lib/operations'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport { conflictsByRoute } from '@elytracms/studio/lib/routing'\nimport { resolveDeploymentRedirects, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace'\nimport { OperationErrorBanner } from '../operation-error'\nimport { RouteList } from './route-list'\nimport type { PageSummary } from './route-list'\nimport { RedirectManager } from './redirect-manager'\n\n/** The body-is-a-canvas page collection (EC-187): routable page documents. */\nconst PAGE_COLLECTION = 'page'\n\n/** Page-label freshness: re-read the labels when any document command lands. */\nconst PAGE_LABEL_RELOAD_OPS = ['documents'] as const\nconst EMPTY_PAGES: readonly PageSummary[] = []\n\n/**\n * Routable pages come from the `page` CMS collection (EC-192) — the documents an\n * editor actually creates — not the builder's single synthetic working page.\n * `documents.list` returns persisted records wrapping each document; map each to\n * a `{ id, name }` summary for the route target labels.\n */\nfunction pageSummaries(records: ReadonlyArray<{ document: CmsDocument }>): PageSummary[] {\n  return records.map(({ document }) => {\n    const name = document.values?.['name']\n    return { id: document.id, name: typeof name === 'string' && name.length > 0 ? name : document.id }\n  })\n}\n\n/** The page-label load result. A read failure is non-fatal (EC-207): the routes\n *  still render; the labels fall back to ids and the structured error surfaces in\n *  a dismissible banner. So the failure rides IN the data, not as a thrown query\n *  error that would collapse the surface. */\ninterface PageLabelData {\n  pages: PageSummary[]\n  error: OperationError | null\n}\n\nasync function loadPageLabels(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<PageLabelData> {\n  const result = await operations.documents.list({ projectId, collection: PAGE_COLLECTION })\n  if (result.ok) return { pages: pageSummaries(result.value), error: null }\n  return { pages: [], error: result.error }\n}\n\n/**\n * The Routes surface (EC-170, made read-only by EC-207 \"routes as code\"):\n * every route and redirect of the project, with the engine's structured issues\n * (route conflicts, redirect loops) rendered inline. Routes and redirects are\n * authored in `elytra.config.ts` and read from the resolved config project\n * (`resolveDeploymentRoutes`/`resolveDeploymentRedirects`) — NEVER from the\n * backend. This surface only views them; conflict/loop detection comes from the\n * canonical `@elytracms/core/cms-core` router, never from parallel UI-side logic. The\n * page list (CMS `page` collection) is read only to label route targets.\n */\nexport function RoutesShell({ project }: { project: Project }) {\n  const projectId = project.id\n\n  // Routes & redirects are config-sourced (EC-207): resolved synchronously from\n  // the active `elytra.config.ts` project, never fetched from the backend.\n  const routes = useMemo(() => resolveDeploymentRoutes(), [])\n  const redirects = useMemo(() => resolveDeploymentRedirects(), [])\n\n  // Page documents feed the route target labels (read-only display), read through\n  // the one operations-backed query cache (EC-308/AD-17) and kept fresh as\n  // documents change. A failure is non-fatal — see `loadPageLabels`.\n  const pagesQuery = useOperationQuery<PageLabelData>({\n    queryKey: ['routePageLabels', projectId],\n    loader: (operations) => loadPageLabels(operations, projectId),\n    invalidateOn: PAGE_LABEL_RELOAD_OPS,\n  })\n  const pages = pagesQuery.data?.pages ?? EMPTY_PAGES\n  const loadError = pagesQuery.data?.error ?? null\n\n  // The engine: one router over the config-resolved records. Its structured\n  // issues are the single source of conflict/loop truth for this surface.\n  const router = useMemo(\n    () =>\n      createRouter(routes, redirects, {\n        defaultLocale: project.settings.defaultLocale,\n      }),\n    [routes, redirects, project.settings.defaultLocale],\n  )\n  const conflicts = useMemo(() => conflictsByRoute(router.issues), [router])\n\n  return (\n    <Stack gap=\"none\" className=\"min-h-full\" data-testid=\"routes-shell\">\n      <Row gap=\"3\" className=\"shrink-0 border-b border-border px-4 py-3 sm:px-6\">\n        <Stack gap=\"1\">\n          <Heading level={2} size=\"h3\">\n            Routes &amp; redirects\n          </Heading>\n          <Text size=\"xs\" tone=\"muted\">\n            Routes &amp; redirects are defined in <code>elytra.config.ts</code>. Conflicts and loops\n            are detected by the canonical route engine — never silently.\n          </Text>\n        </Stack>\n        <Spacer />\n        {loadError ? (\n          <OperationErrorBanner error={loadError} onDismiss={() => void pagesQuery.refetch()} />\n        ) : null}\n        {router.issues.length > 0 ? (\n          <Badge variant=\"error\" data-testid=\"routing-issue-count\">\n            {router.issues.length} issue{router.issues.length === 1 ? '' : 's'}\n          </Badge>\n        ) : (\n          <Badge variant=\"success\">no issues</Badge>\n        )}\n      </Row>\n\n      <div className=\"grid min-h-0 flex-1 grid-cols-1 xl:grid-cols-[minmax(0,5fr)_minmax(0,4fr)]\">\n        <section\n          aria-label=\"Routes\"\n          className=\"min-w-0 border-b border-border xl:border-b-0 xl:border-r\"\n        >\n          <RouteList projectId={projectId} routes={routes} conflicts={conflicts} pages={pages} />\n        </section>\n        <section aria-label=\"Redirects\" className=\"min-w-0\">\n          <RedirectManager redirects={redirects} followRedirects={router.followRedirects} />\n        </section>\n      </div>\n    </Stack>\n  )\n}\n"]}

package/dist/components/studio-context.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useMemo, useState } from 'react';
 import { activateProject, configProject, emptyContext } from '@elytracms/core/studio-core';
 import { getWorkspaceState } from '@elytracms/studio/lib/workspace';
+import { StudioQueryProvider } from '@elytracms/studio/lib/query';
 const StudioContext = createContext(null);
 /** Resolve the config-declared projects into studio `Project`s (slug-keyed). */
 function configProjects() {
@@ -37,7 +38,10 @@ export function StudioProvider({ children }) {
         setContext((prev) => (prev.activeProjectId === id ? prev : activateProject(prev, id)));
     }, []);
     const store = useMemo(() => ({ projects, context, getProject, activate }), [projects, context, getProject, activate]);
-    return _jsx(StudioContext.Provider, { value: store, children: children });
+    // EC-308/AD-17: the single client query cache mounts here (package-owned,
+    // above every per-project provider, surviving project switches) so every
+    // studio server read flows through `useOperationQuery`.
+    return (_jsx(StudioContext.Provider, { value: store, children: _jsx(StudioQueryProvider, { children: children }) }));
 }
 export function useStudio() {
     const store = useContext(StudioContext);

package/dist/components/studio-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio-context.js","sourceRoot":"","sources":["../../src/components/studio-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEjF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAoBnE,MAAM,aAAa,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAE7D,gFAAgF;AAChF,SAAS,cAAc;IACrB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAA;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACpC,oEAAoE;QACpE,mEAAmE;QACnE,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE;gBACR,GAAG,OAAO,CAAC,QAAQ;gBACnB,mBAAmB,EAAE;oBACnB,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB;oBACvC,UAAU,EAAE,aAAa;iBAC1B;aACF;SACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAA2B;IAClE,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAA;IACvE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAuB,YAAY,CAAC,CAAA;IAE1E,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,EAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEhG,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAa,EAAE,EAAE;QAC7C,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACxF,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EACnD,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAC1C,CAAA;IAED,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAChF,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { activateProject, configProject, emptyContext } from '@elytracms/core/studio-core'\nimport type { ActiveProjectContext, Project, ProjectId } from '@elytracms/core/studio-core'\nimport { getWorkspaceState } from '@elytracms/studio/lib/workspace'\n\n/**\n * Project read store (vision AD-8). Project *identity* is owned by\n * `elytra.config.ts` — the studio reads the project list from the resolved\n * workspace config, never from the backend. The active project id is route-\n * driven; this store holds the config-derived list + the recents context.\n * Lifecycle (create/rename/archive/delete) lives in code/CLI, not the UI.\n */\n\nexport interface StudioStore {\n  /** Projects declared in `elytra.config.ts`, in config order. */\n  projects: readonly Project[]\n  /** Active-project context (recents); the active id itself is route-driven. */\n  context: ActiveProjectContext\n  getProject(id: ProjectId): Project | undefined\n  /** Record a project as active + most-recent (idempotent). */\n  activate(id: ProjectId): void\n}\n\nconst StudioContext = createContext<StudioStore | null>(null)\n\n/** Resolve the config-declared projects into studio `Project`s (slug-keyed). */\nfunction configProjects(): readonly Project[] {\n  const state = getWorkspaceState()\n  if (state.kind !== 'config') return []\n  return state.projects.map((entry) => {\n    const project = configProject(entry)\n    // EC-221: the plugin marketplace UI is cut from v1 (vision §5). The\n    // Extensions surface is pulled from the nav by marking the section\n    // unavailable — the rail omits unavailable sections. The @elytracms/plugins\n    // package, ExtensionsView, and the `/extensions` route all remain in the tree\n    // for Milestone E revival (reachable by URL, just not advertised in the nav).\n    return {\n      ...project,\n      settings: {\n        ...project.settings,\n        sectionAvailability: {\n          ...project.settings.sectionAvailability,\n          extensions: 'unavailable',\n        },\n      },\n    }\n  })\n}\n\nexport function StudioProvider({ children }: { children: ReactNode }) {\n  // The workspace config is static for the app's lifetime (bundled at build or\n  // injected via env), so the project list is computed once.\n  const [projects] = useState<readonly Project[]>(() => configProjects())\n  const [context, setContext] = useState<ActiveProjectContext>(emptyContext)\n\n  const getProject = useCallback((id: ProjectId) => projects.find((p) => p.id === id), [projects])\n\n  const activate = useCallback((id: ProjectId) => {\n    setContext((prev) => (prev.activeProjectId === id ? prev : activateProject(prev, id)))\n  }, [])\n\n  const store = useMemo<StudioStore>(\n    () => ({ projects, context, getProject, activate }),\n    [projects, context, getProject, activate],\n  )\n\n  return <StudioContext.Provider value={store}>{children}</StudioContext.Provider>\n}\n\nexport function useStudio(): StudioStore {\n  const store = useContext(StudioContext)\n  if (!store) throw new Error('useStudio must be used within a <StudioProvider>.')\n  return store\n}\n"]}
+{"version":3,"file":"studio-context.js","sourceRoot":"","sources":["../../src/components/studio-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEjF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAoBjE,MAAM,aAAa,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAE7D,gFAAgF;AAChF,SAAS,cAAc;IACrB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAA;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACpC,oEAAoE;QACpE,mEAAmE;QACnE,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE;gBACR,GAAG,OAAO,CAAC,QAAQ;gBACnB,mBAAmB,EAAE;oBACnB,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB;oBACvC,UAAU,EAAE,aAAa;iBAC1B;aACF;SACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAA2B;IAClE,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAA;IACvE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAuB,YAAY,CAAC,CAAA;IAE1E,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,EAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEhG,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAa,EAAE,EAAE;QAC7C,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACxF,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EACnD,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAC1C,CAAA;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,wDAAwD;IACxD,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAClC,KAAC,mBAAmB,cAAE,QAAQ,GAAuB,GAC9B,CAC1B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAChF,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { activateProject, configProject, emptyContext } from '@elytracms/core/studio-core'\nimport type { ActiveProjectContext, Project, ProjectId } from '@elytracms/core/studio-core'\nimport { getWorkspaceState } from '@elytracms/studio/lib/workspace'\nimport { StudioQueryProvider } from '@elytracms/studio/lib/query'\n\n/**\n * Project read store (vision AD-8). Project *identity* is owned by\n * `elytra.config.ts` — the studio reads the project list from the resolved\n * workspace config, never from the backend. The active project id is route-\n * driven; this store holds the config-derived list + the recents context.\n * Lifecycle (create/rename/archive/delete) lives in code/CLI, not the UI.\n */\n\nexport interface StudioStore {\n  /** Projects declared in `elytra.config.ts`, in config order. */\n  projects: readonly Project[]\n  /** Active-project context (recents); the active id itself is route-driven. */\n  context: ActiveProjectContext\n  getProject(id: ProjectId): Project | undefined\n  /** Record a project as active + most-recent (idempotent). */\n  activate(id: ProjectId): void\n}\n\nconst StudioContext = createContext<StudioStore | null>(null)\n\n/** Resolve the config-declared projects into studio `Project`s (slug-keyed). */\nfunction configProjects(): readonly Project[] {\n  const state = getWorkspaceState()\n  if (state.kind !== 'config') return []\n  return state.projects.map((entry) => {\n    const project = configProject(entry)\n    // EC-221: the plugin marketplace UI is cut from v1 (vision §5). The\n    // Extensions surface is pulled from the nav by marking the section\n    // unavailable — the rail omits unavailable sections. The @elytracms/plugins\n    // package, ExtensionsView, and the `/extensions` route all remain in the tree\n    // for Milestone E revival (reachable by URL, just not advertised in the nav).\n    return {\n      ...project,\n      settings: {\n        ...project.settings,\n        sectionAvailability: {\n          ...project.settings.sectionAvailability,\n          extensions: 'unavailable',\n        },\n      },\n    }\n  })\n}\n\nexport function StudioProvider({ children }: { children: ReactNode }) {\n  // The workspace config is static for the app's lifetime (bundled at build or\n  // injected via env), so the project list is computed once.\n  const [projects] = useState<readonly Project[]>(() => configProjects())\n  const [context, setContext] = useState<ActiveProjectContext>(emptyContext)\n\n  const getProject = useCallback((id: ProjectId) => projects.find((p) => p.id === id), [projects])\n\n  const activate = useCallback((id: ProjectId) => {\n    setContext((prev) => (prev.activeProjectId === id ? prev : activateProject(prev, id)))\n  }, [])\n\n  const store = useMemo<StudioStore>(\n    () => ({ projects, context, getProject, activate }),\n    [projects, context, getProject, activate],\n  )\n\n  // EC-308/AD-17: the single client query cache mounts here (package-owned,\n  // above every per-project provider, surviving project switches) so every\n  // studio server read flows through `useOperationQuery`.\n  return (\n    <StudioContext.Provider value={store}>\n      <StudioQueryProvider>{children}</StudioQueryProvider>\n    </StudioContext.Provider>\n  )\n}\n\nexport function useStudio(): StudioStore {\n  const store = useContext(StudioContext)\n  if (!store) throw new Error('useStudio must be used within a <StudioProvider>.')\n  return store\n}\n"]}

package/dist/lib/assets/delete-asset.js

@@ -4,9 +4,13 @@ export async function deleteAsset(deps, projectId, assetId, options = {}) {
         const asset = await deps.assets.findAsset(projectId, assetId);
         if (!asset)
             return { outcome: 'not-found' };
-        const usageCount = await assetUsageCount(deps, projectId, assetId);
-        if (usageCount > 0 && options.confirmInUse !== true) {
-            return { outcome: 'blocked', usageCount };
+        // Only consult the reference index when the caller has NOT already confirmed.
+        // The delete dialog enumerates usages up-front and confirms with `confirmInUse`,
+        // so a confirmed delete skips this redundant inbound query entirely (EC-301 perf).
+        if (options.confirmInUse !== true) {
+            const usageCount = await assetUsageCount(deps, projectId, assetId);
+            if (usageCount > 0)
+                return { outcome: 'blocked', usageCount };
         }
         // Bytes first, metadata last: a failure midway leaves a visible metadata
         // record (re-deletable) rather than invisible orphaned bytes.

package/dist/lib/assets/delete-asset.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-asset.js","sourceRoot":"","sources":["../../../src/lib/assets/delete-asset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAoCjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB,EACrB,SAAiB,EACjB,OAAe,EACf,UAA8B,EAAE;IAEhC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC7D,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;QAE3C,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;QAClE,IAAI,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;QAC3C,CAAC;QAED,yEAAyE;QACzE,8DAA8D;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAmB;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;QACzE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;IAC9F,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,IAAqB,EACrB,SAAiB,EACjB,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IACxF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAChF,CAAA;IACD,OAAO,QAAQ,CAAC,IAAI,CAAA;AACtB,CAAC","sourcesContent":["import { RecordNotFoundError } from '@elytracms/core/persistence'\nimport type {\n  AssetRepository,\n  BlobStorageAdapter,\n  ReferenceIndexRepository,\n} from '@elytracms/core/persistence'\n\n/**\n * Reference-respecting asset deletion (EC-151, reworked EC-202). Deleting an\n * asset that is referenced is blocked until explicitly confirmed; the usage\n * count comes from the **EC-155 reference index** (`references.inbound` for the\n * `{ type: 'asset' }` target) — index-accurate, replacing the interim string\n * scan (`find-asset-usages`), which could miss rich-text asset hrefs and\n * false-positive on unrelated strings. Deleting an unused asset removes bytes\n * (blob) AND the metadata record. Results are structured data — never throws.\n */\n\nexport interface DeleteAssetDeps {\n  assets: AssetRepository\n  blobs: BlobStorageAdapter\n  /** The EC-155 reference index — the accurate inbound-usage source (EC-202). */\n  references: Pick<ReferenceIndexRepository, 'inbound'>\n}\n\nexport type DeleteAssetResult =\n  | { outcome: 'deleted' }\n  /** The asset is referenced and `confirmInUse` was not set: nothing was removed. */\n  | { outcome: 'blocked'; usageCount: number }\n  | { outcome: 'not-found' }\n  | { outcome: 'error'; message: string }\n\nexport interface DeleteAssetOptions {\n  /** Caller has seen the usage count and explicitly confirmed deletion. */\n  confirmInUse?: boolean\n}\n\nexport async function deleteAsset(\n  deps: DeleteAssetDeps,\n  projectId: string,\n  assetId: string,\n  options: DeleteAssetOptions = {},\n): Promise<DeleteAssetResult> {\n  try {\n    const asset = await deps.assets.findAsset(projectId, assetId)\n    if (!asset) return { outcome: 'not-found' }\n\n    const usageCount = await assetUsageCount(deps, projectId, assetId)\n    if (usageCount > 0 && options.confirmInUse !== true) {\n      return { outcome: 'blocked', usageCount }\n    }\n\n    // Bytes first, metadata last: a failure midway leaves a visible metadata\n    // record (re-deletable) rather than invisible orphaned bytes.\n    await deps.blobs.delete(asset.storageKey)\n    await deps.assets.removeAsset(projectId, assetId)\n    return { outcome: 'deleted' }\n  } catch (error) {\n    if (error instanceof RecordNotFoundError) return { outcome: 'not-found' }\n    return { outcome: 'error', message: error instanceof Error ? error.message : String(error) }\n  }\n}\n\n/**\n * Distinct inbound usages of an asset from the reference index (EC-202). One\n * `source + path` (e.g. `post:hello · values/cover`) can carry both a draft and\n * a published index entry — that is a single usage, so variants collapse before\n * counting (the gate is \"is this referenced\", not \"how many index rows\").\n */\nasync function assetUsageCount(\n  deps: DeleteAssetDeps,\n  projectId: string,\n  assetId: string,\n): Promise<number> {\n  const inbound = await deps.references.inbound(projectId, { type: 'asset', id: assetId })\n  const distinct = new Set(\n    inbound.map((entry) => `${entry.source.type}:${entry.source.id}:${entry.path}`),\n  )\n  return distinct.size\n}\n"]}
+{"version":3,"file":"delete-asset.js","sourceRoot":"","sources":["../../../src/lib/assets/delete-asset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAoCjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB,EACrB,SAAiB,EACjB,OAAe,EACf,UAA8B,EAAE;IAEhC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC7D,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;QAE3C,8EAA8E;QAC9E,iFAAiF;QACjF,mFAAmF;QACnF,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;YAClE,IAAI,UAAU,GAAG,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;QAC/D,CAAC;QAED,yEAAyE;QACzE,8DAA8D;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAmB;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;QACzE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;IAC9F,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,IAAqB,EACrB,SAAiB,EACjB,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IACxF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAChF,CAAA;IACD,OAAO,QAAQ,CAAC,IAAI,CAAA;AACtB,CAAC","sourcesContent":["import { RecordNotFoundError } from '@elytracms/core/persistence'\nimport type {\n  AssetRepository,\n  BlobStorageAdapter,\n  ReferenceIndexRepository,\n} from '@elytracms/core/persistence'\n\n/**\n * Reference-respecting asset deletion (EC-151, reworked EC-202). Deleting an\n * asset that is referenced is blocked until explicitly confirmed; the usage\n * count comes from the **EC-155 reference index** (`references.inbound` for the\n * `{ type: 'asset' }` target) — index-accurate, replacing the interim string\n * scan (`find-asset-usages`), which could miss rich-text asset hrefs and\n * false-positive on unrelated strings. Deleting an unused asset removes bytes\n * (blob) AND the metadata record. Results are structured data — never throws.\n */\n\nexport interface DeleteAssetDeps {\n  assets: AssetRepository\n  blobs: BlobStorageAdapter\n  /** The EC-155 reference index — the accurate inbound-usage source (EC-202). */\n  references: Pick<ReferenceIndexRepository, 'inbound'>\n}\n\nexport type DeleteAssetResult =\n  | { outcome: 'deleted' }\n  /** The asset is referenced and `confirmInUse` was not set: nothing was removed. */\n  | { outcome: 'blocked'; usageCount: number }\n  | { outcome: 'not-found' }\n  | { outcome: 'error'; message: string }\n\nexport interface DeleteAssetOptions {\n  /** Caller has seen the usage count and explicitly confirmed deletion. */\n  confirmInUse?: boolean\n}\n\nexport async function deleteAsset(\n  deps: DeleteAssetDeps,\n  projectId: string,\n  assetId: string,\n  options: DeleteAssetOptions = {},\n): Promise<DeleteAssetResult> {\n  try {\n    const asset = await deps.assets.findAsset(projectId, assetId)\n    if (!asset) return { outcome: 'not-found' }\n\n    // Only consult the reference index when the caller has NOT already confirmed.\n    // The delete dialog enumerates usages up-front and confirms with `confirmInUse`,\n    // so a confirmed delete skips this redundant inbound query entirely (EC-301 perf).\n    if (options.confirmInUse !== true) {\n      const usageCount = await assetUsageCount(deps, projectId, assetId)\n      if (usageCount > 0) return { outcome: 'blocked', usageCount }\n    }\n\n    // Bytes first, metadata last: a failure midway leaves a visible metadata\n    // record (re-deletable) rather than invisible orphaned bytes.\n    await deps.blobs.delete(asset.storageKey)\n    await deps.assets.removeAsset(projectId, assetId)\n    return { outcome: 'deleted' }\n  } catch (error) {\n    if (error instanceof RecordNotFoundError) return { outcome: 'not-found' }\n    return { outcome: 'error', message: error instanceof Error ? error.message : String(error) }\n  }\n}\n\n/**\n * Distinct inbound usages of an asset from the reference index (EC-202). One\n * `source + path` (e.g. `post:hello · values/cover`) can carry both a draft and\n * a published index entry — that is a single usage, so variants collapse before\n * counting (the gate is \"is this referenced\", not \"how many index rows\").\n */\nasync function assetUsageCount(\n  deps: DeleteAssetDeps,\n  projectId: string,\n  assetId: string,\n): Promise<number> {\n  const inbound = await deps.references.inbound(projectId, { type: 'asset', id: assetId })\n  const distinct = new Set(\n    inbound.map((entry) => `${entry.source.type}:${entry.source.id}:${entry.path}`),\n  )\n  return distinct.size\n}\n"]}

package/dist/lib/cms/published-documents.d.ts

@@ -9,11 +9,10 @@ import type { OperationsClient } from '../operations';
  * pool is exactly the set the live site would serve, so composing a nested page's
  * URL from these ancestors yields the URL the live site actually resolves.
  *
- * Loaded lazily; reloaded only when a publish/unpublish/restore/delete command
+ * EC-308/AD-17: loaded + kept fresh through the one `useOperationQuery` cache
+ * seam — invalidated only when a publish/unpublish/restore/delete command
  * succeeds (NOT on every autosave upsert — a draft edit doesn't change what's
- * published). Cost: one `listVersions` per published document (there is no bulk
- * published-content query yet) — fine for v1 collections; a bulk
- * `documents.listPublished` is the perf follow-up for large collections.
+ * published). Cost: ONE bulk `documents.listPublished` read (EC-307).
  */
 export interface PublishedDocuments {
     /** Pinned published snapshot per published document id. Empty while loading. */
@@ -23,8 +22,9 @@ export interface PublishedDocuments {
 /**
  * Build the published pool of a collection (pure over the operations client): the
  * pinned published snapshot of every currently-published document, keyed by id.
- * The `publishedVersion` pointer comes from the document record; its snapshot
- * from the recorded versions. Read failures degrade to an empty pool.
+ * EC-307: one bulk `documents.listPublished` read — the backend resolves each
+ * `publishedVersion` pointer to its recorded snapshot — instead of a `list` plus a
+ * per-document `listVersions` fan-out. Read failures degrade to an empty pool.
  */
 export declare function loadPublishedDocuments(operations: OperationsClient, projectId: string, collectionId: string): Promise<Map<string, CmsDocument>>;
 export declare function usePublishedDocuments(projectId: string | undefined, collectionId: string): PublishedDocuments;

package/dist/lib/cms/published-documents.js

@@ -1,75 +1,38 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { getStudioOperations } from '../operations';
+import { useOperationQuery } from '@elytracms/studio/lib/query';
 /** Commands that change which version is pinned live (and thus the pool). */
-const RELOAD_OPS = new Set([
+const PUBLISHED_RELOAD_OPS = [
     'documents.publish',
     'documents.unpublish',
     'documents.restore',
     'documents.delete',
-]);
+];
+const EMPTY_POOL = new Map();
 /**
  * Build the published pool of a collection (pure over the operations client): the
  * pinned published snapshot of every currently-published document, keyed by id.
- * The `publishedVersion` pointer comes from the document record; its snapshot
- * from the recorded versions. Read failures degrade to an empty pool.
+ * EC-307: one bulk `documents.listPublished` read — the backend resolves each
+ * `publishedVersion` pointer to its recorded snapshot — instead of a `list` plus a
+ * per-document `listVersions` fan-out. Read failures degrade to an empty pool.
  */
 export async function loadPublishedDocuments(operations, projectId, collectionId) {
-    const listed = await operations.documents.list({ projectId, collection: collectionId });
-    if (!listed.ok)
+    const result = await operations.documents.listPublished({ projectId, collection: collectionId });
+    if (!result.ok)
         return new Map();
-    const published = listed.value.filter((record) => record.publishedVersion !== undefined);
-    const snapshots = await Promise.all(published.map(async (record) => {
-        const ref = { collection: record.document.collection, id: record.document.id };
-        const versions = await operations.documents.listVersions({ projectId, ref });
-        if (!versions.ok)
-            return null;
-        return versions.value.find((v) => v.version === record.publishedVersion)?.snapshot ?? null;
-    }));
     const byId = new Map();
-    for (const snapshot of snapshots)
-        if (snapshot)
-            byId.set(snapshot.id, snapshot);
+    for (const snapshot of result.value)
+        byId.set(snapshot.id, snapshot);
     return byId;
 }
 export function usePublishedDocuments(projectId, collectionId) {
-    const [state, setState] = useState({ byId: new Map(), status: 'loading' });
-    const epochRef = useRef(0);
-    const load = useCallback(async () => {
-        const epoch = ++epochRef.current;
-        const settle = (byId) => {
-            if (epochRef.current === epoch)
-                setState({ byId, status: 'ready' });
-        };
-        // Playground/fixture mode (no backend): nothing is published via versions.
-        if (projectId === undefined) {
-            settle(new Map());
-            return;
-        }
-        const { operations } = await getStudioOperations();
-        settle(await loadPublishedDocuments(operations, projectId, collectionId));
-    }, [projectId, collectionId]);
-    useEffect(() => {
-        setState((prev) => ({ byId: prev.byId, status: 'loading' }));
-        void load();
-        let disposed = false;
-        let unsubscribe;
-        void getStudioOperations().then((studio) => {
-            if (disposed)
-                return;
-            unsubscribe = studio.operations.events.subscribe((event) => {
-                if (event.kind !== 'command' || event.status !== 'succeeded')
-                    return;
-                if (!RELOAD_OPS.has(event.operation))
-                    return;
-                void load();
-            });
-        });
-        return () => {
-            disposed = true;
-            epochRef.current += 1;
-            unsubscribe?.();
-        };
-    }, [load]);
-    return state;
+    const query = useOperationQuery({
+        // Playground/fixture mode (no backend) is `enabled: false` → never queried.
+        queryKey: ['publishedDocuments', projectId ?? '∅', collectionId],
+        loader: (operations) => loadPublishedDocuments(operations, projectId, collectionId),
+        invalidateOn: PUBLISHED_RELOAD_OPS,
+        enabled: projectId !== undefined,
+    });
+    if (projectId === undefined)
+        return { byId: EMPTY_POOL, status: 'ready' };
+    return { byId: query.data ?? EMPTY_POOL, status: query.isPending ? 'loading' : 'ready' };
 }
 //# sourceMappingURL=published-documents.js.map

package/dist/lib/cms/published-documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"published-documents.js","sourceRoot":"","sources":["../../../src/lib/cms/published-documents.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\nimport type { CmsDocument } from '@elytracms/core/cms-core'\nimport { getStudioOperations } from '../operations'\nimport type { OperationsClient } from '../operations'\n\n/**\n * The PUBLISHED-perspective documents of a collection (EC-205, \"live = published\")\n * — the pinned published snapshot of each currently-published document, keyed by\n * id. Live surfaces (a document's live URL + \"View live\", EC-216) MUST derive\n * from this, never from the draft rows the studio edits: an unpublished document,\n * or an unpublished `slug`/`parent` edit, must never leak into a \"live\" URL. The\n * pool is exactly the set the live site would serve, so composing a nested page's\n * URL from these ancestors yields the URL the live site actually resolves.\n *\n * Loaded lazily; reloaded only when a publish/unpublish/restore/delete command\n * succeeds (NOT on every autosave upsert — a draft edit doesn't change what's\n * published). Cost: one `listVersions` per published document (there is no bulk\n * published-content query yet) — fine for v1 collections; a bulk\n * `documents.listPublished` is the perf follow-up for large collections.\n */\nexport interface PublishedDocuments {\n  /** Pinned published snapshot per published document id. Empty while loading. */\n  byId: ReadonlyMap<string, CmsDocument>\n  status: 'loading' | 'ready'\n}\n\n/** Commands that change which version is pinned live (and thus the pool). */\nconst RELOAD_OPS: ReadonlySet<string> = new Set([\n  'documents.publish',\n  'documents.unpublish',\n  'documents.restore',\n  'documents.delete',\n])\n\n/**\n * Build the published pool of a collection (pure over the operations client): the\n * pinned published snapshot of every currently-published document, keyed by id.\n * The `publishedVersion` pointer comes from the document record; its snapshot\n * from the recorded versions. Read failures degrade to an empty pool.\n */\nexport async function loadPublishedDocuments(\n  operations: OperationsClient,\n  projectId: string,\n  collectionId: string,\n): Promise<Map<string, CmsDocument>> {\n  const listed = await operations.documents.list({ projectId, collection: collectionId })\n  if (!listed.ok) return new Map()\n  const published = listed.value.filter((record) => record.publishedVersion !== undefined)\n  const snapshots = await Promise.all(\n    published.map(async (record) => {\n      const ref = { collection: record.document.collection, id: record.document.id }\n      const versions = await operations.documents.listVersions({ projectId, ref })\n      if (!versions.ok) return null\n      return versions.value.find((v) => v.version === record.publishedVersion)?.snapshot ?? null\n    }),\n  )\n  const byId = new Map<string, CmsDocument>()\n  for (const snapshot of snapshots) if (snapshot) byId.set(snapshot.id, snapshot)\n  return byId\n}\n\nexport function usePublishedDocuments(\n  projectId: string | undefined,\n  collectionId: string,\n): PublishedDocuments {\n  const [state, setState] = useState<PublishedDocuments>({ byId: new Map(), status: 'loading' })\n  const epochRef = useRef(0)\n\n  const load = useCallback(async () => {\n    const epoch = ++epochRef.current\n    const settle = (byId: Map<string, CmsDocument>) => {\n      if (epochRef.current === epoch) setState({ byId, status: 'ready' })\n    }\n    // Playground/fixture mode (no backend): nothing is published via versions.\n    if (projectId === undefined) {\n      settle(new Map())\n      return\n    }\n    const { operations } = await getStudioOperations()\n    settle(await loadPublishedDocuments(operations, projectId, collectionId))\n  }, [projectId, collectionId])\n\n  useEffect(() => {\n    setState((prev) => ({ byId: prev.byId, status: 'loading' }))\n    void load()\n    let disposed = false\n    let unsubscribe: (() => void) | undefined\n    void getStudioOperations().then((studio) => {\n      if (disposed) return\n      unsubscribe = studio.operations.events.subscribe((event) => {\n        if (event.kind !== 'command' || event.status !== 'succeeded') return\n        if (!RELOAD_OPS.has(event.operation)) return\n        void load()\n      })\n    })\n    return () => {\n      disposed = true\n      epochRef.current += 1\n      unsubscribe?.()\n    }\n  }, [load])\n\n  return state\n}\n"]}
+{"version":3,"file":"published-documents.js","sourceRoot":"","sources":["../../../src/lib/cms/published-documents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAsB/D,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG;IAC3B,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;CACV,CAAA;AAEV,MAAM,UAAU,GAAqC,IAAI,GAAG,EAAE,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA4B,EAC5B,SAAiB,EACjB,YAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAA;IAChG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC3C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAA6B,EAC7B,YAAoB;IAEpB,MAAM,KAAK,GAAG,iBAAiB,CAA2B;QACxD,4EAA4E;QAC5E,QAAQ,EAAE,CAAC,oBAAoB,EAAE,SAAS,IAAI,GAAG,EAAE,YAAY,CAAC;QAChE,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAmB,EAAE,YAAY,CAAC;QAC7F,YAAY,EAAE,oBAAoB;QAClC,OAAO,EAAE,SAAS,KAAK,SAAS;KACjC,CAAC,CAAA;IACF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACzE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAC1F,CAAC","sourcesContent":["import type { CmsDocument } from '@elytracms/core/cms-core'\nimport type { OperationsClient } from '../operations'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\n\n/**\n * The PUBLISHED-perspective documents of a collection (EC-205, \"live = published\")\n * — the pinned published snapshot of each currently-published document, keyed by\n * id. Live surfaces (a document's live URL + \"View live\", EC-216) MUST derive\n * from this, never from the draft rows the studio edits: an unpublished document,\n * or an unpublished `slug`/`parent` edit, must never leak into a \"live\" URL. The\n * pool is exactly the set the live site would serve, so composing a nested page's\n * URL from these ancestors yields the URL the live site actually resolves.\n *\n * EC-308/AD-17: loaded + kept fresh through the one `useOperationQuery` cache\n * seam — invalidated only when a publish/unpublish/restore/delete command\n * succeeds (NOT on every autosave upsert — a draft edit doesn't change what's\n * published). Cost: ONE bulk `documents.listPublished` read (EC-307).\n */\nexport interface PublishedDocuments {\n  /** Pinned published snapshot per published document id. Empty while loading. */\n  byId: ReadonlyMap<string, CmsDocument>\n  status: 'loading' | 'ready'\n}\n\n/** Commands that change which version is pinned live (and thus the pool). */\nconst PUBLISHED_RELOAD_OPS = [\n  'documents.publish',\n  'documents.unpublish',\n  'documents.restore',\n  'documents.delete',\n] as const\n\nconst EMPTY_POOL: ReadonlyMap<string, CmsDocument> = new Map()\n\n/**\n * Build the published pool of a collection (pure over the operations client): the\n * pinned published snapshot of every currently-published document, keyed by id.\n * EC-307: one bulk `documents.listPublished` read — the backend resolves each\n * `publishedVersion` pointer to its recorded snapshot — instead of a `list` plus a\n * per-document `listVersions` fan-out. Read failures degrade to an empty pool.\n */\nexport async function loadPublishedDocuments(\n  operations: OperationsClient,\n  projectId: string,\n  collectionId: string,\n): Promise<Map<string, CmsDocument>> {\n  const result = await operations.documents.listPublished({ projectId, collection: collectionId })\n  if (!result.ok) return new Map()\n  const byId = new Map<string, CmsDocument>()\n  for (const snapshot of result.value) byId.set(snapshot.id, snapshot)\n  return byId\n}\n\nexport function usePublishedDocuments(\n  projectId: string | undefined,\n  collectionId: string,\n): PublishedDocuments {\n  const query = useOperationQuery<Map<string, CmsDocument>>({\n    // Playground/fixture mode (no backend) is `enabled: false` → never queried.\n    queryKey: ['publishedDocuments', projectId ?? '∅', collectionId],\n    loader: (operations) => loadPublishedDocuments(operations, projectId as string, collectionId),\n    invalidateOn: PUBLISHED_RELOAD_OPS,\n    enabled: projectId !== undefined,\n  })\n  if (projectId === undefined) return { byId: EMPTY_POOL, status: 'ready' }\n  return { byId: query.data ?? EMPTY_POOL, status: query.isPending ? 'loading' : 'ready' }\n}\n"]}

package/dist/lib/cms-views/view-model.d.ts

@@ -167,9 +167,13 @@ export declare function resolveColumns(collection: CollectionDef, state: TableVi
 /** The visible columns of a view, in render order (EC-213). */
 export declare function visibleColumns(collection: CollectionDef, state: TableViewState): string[];
 /**
- * The title/link column: the first visible column (EC-213 — there is no
- * separate primary-column selector). Falls back to the schema title field, then
- * the first field, then `id`, for the degenerate "everything hidden" case.
+ * The title/link column — the document IDENTITY column (EC-242): the schema title
+ * field, shown as the leftmost linked cell whose content is `resolveDocumentTitle`
+ * (a string `titleField` or a function pattern). Always present regardless of
+ * column visibility — it is the document's identity, not a toggleable data column —
+ * and excluded from the data columns so the title never shows twice. Falls back to
+ * the first visible column, then the first field, then `id`, when no title field
+ * is resolvable (e.g. a function title with no backing `title` field).
  */
 export declare function primaryColumn(collection: CollectionDef, state: TableViewState): string;
 /**

package/dist/lib/cms-views/view-model.js

@@ -289,13 +289,19 @@ export function visibleColumns(collection, state) {
         .map((column) => column.field);
 }
 /**
- * The title/link column: the first visible column (EC-213 — there is no
- * separate primary-column selector). Falls back to the schema title field, then
- * the first field, then `id`, for the degenerate "everything hidden" case.
+ * The title/link column — the document IDENTITY column (EC-242): the schema title
+ * field, shown as the leftmost linked cell whose content is `resolveDocumentTitle`
+ * (a string `titleField` or a function pattern). Always present regardless of
+ * column visibility — it is the document's identity, not a toggleable data column —
+ * and excluded from the data columns so the title never shows twice. Falls back to
+ * the first visible column, then the first field, then `id`, when no title field
+ * is resolvable (e.g. a function title with no backing `title` field).
  */
 export function primaryColumn(collection, state) {
-    const visible = visibleColumns(collection, state);
-    return (visible[0] ?? titleFieldOf(collection)?.name ?? collection.fields[0]?.name ?? 'id');
+    return (titleFieldOf(collection)?.name ??
+        visibleColumns(collection, state)[0] ??
+        collection.fields[0]?.name ??
+        'id');
 }
 /**
  * Reconcile `columns` to the full resolved order so column edits operate on a