@elytracms/studio 0.0.79 → 0.0.81

package/dist/components/redirects/redirects-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\n/**\n * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302\n * forwards — read + written through the shared operations client (`redirects.*`),\n * the same seam the users/assets stores use. Content-gated (a viewer reads, an\n * editor writes); no draft/published split — a saved+enabled redirect is live.\n *\n * The \"New\" flow keeps an unsaved redirect as a LOCAL draft (memory only) until\n * the first explicit save persists it — so an abandoned \"New\" never writes a stub\n * to the backend and never shows in the list. Drafts are reachable via {@link\n * RedirectsStore.get} (the detail editor loads one), never listed.\n */\n\nexport interface RedirectsStore {\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */\n  redirects: readonly RedirectEntry[]\n  /** One redirect: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RedirectEntry | undefined\n  /** Mint a blank in-memory draft and return its id (the \"New\" navigation target). */\n  createDraft(): string\n  /** Persist a create/modify; drops the matching draft on success. */\n  save(\n    input: SaveRedirectInput,\n  ): Promise<{ ok: true; redirect: RedirectEntry } | { ok: false; message: string }>\n  /** Delete a persisted redirect, or silently discard an unsaved draft. */\n  remove(id: string): Promise<{ ok: true } | { ok: false; message: string }>\n  /** Re-list from the backend. */\n  refresh(): Promise<void>\n}\n\nconst { Context: RedirectsContext, useRequired: useRedirects } =\n  createRequiredContext<RedirectsStore>('Redirects')\n\nconst EMPTY_REDIRECTS: readonly RedirectEntry[] = []\n\nlet draftCounter = 0\n/** A collision-resistant client id for a new redirect (used as its real id on save). */\nfunction newDraftId(): string {\n  draftCounter += 1\n  return `redirect_${Date.now().toString(36)}_${draftCounter}`\n}\n\nfunction redirectsQueryKey(projectId: string): readonly [string, string] {\n  return ['redirects', projectId]\n}\n\nasync function loadRedirects(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<RedirectEntry[]> {\n  const result = await operations.redirects.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\nfunction byFrom(a: RedirectEntry, b: RedirectEntry): number {\n  return a.from < b.from ? -1 : a.from > b.from ? 1 : 0\n}\n\nexport function RedirectsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useOperationQuery<RedirectEntry[]>({\n    queryKey: redirectsQueryKey(projectId),\n    loader: (operations) => loadRedirects(operations, projectId),\n  })\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const persisted = query.data ?? EMPTY_REDIRECTS\n  const { status, errorMessage } = listStoreState(query)\n\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RedirectEntry>>({})\n\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback<RedirectsStore['get']>(\n    (id) => drafts[id] ?? persisted.find((r) => r.id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback<RedirectsStore['createDraft']>(() => {\n    const id = newDraftId()\n    const now = new Date().toISOString()\n    const draft: RedirectEntry = {\n      id,\n      projectId,\n      from: '',\n      to: '',\n      permanent: true,\n      // New redirects default to enabled — the reason you create one is for it to\n      // work; `enabled` is really the switch for *pausing* an existing redirect. A\n      // half-filled draft can't go live anyway (save requires from/to).\n      enabled: true,\n      createdAt: now,\n      updatedAt: now,\n    }\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [projectId])\n\n  const save = useCallback<RedirectsStore['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.save({\n        projectId,\n        ...(input.id !== undefined ? { id: input.id } : {}),\n        from: input.from,\n        to: input.to,\n        ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),\n        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),\n        ...(input.meta !== undefined ? { meta: input.meta } : {}),\n      })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) => {\n        const rest = (prev ?? []).filter((r) => r.id !== saved.id)\n        return [...rest, saved].sort(byFrom)\n      })\n      // The record is now persisted — drop any matching draft.\n      setDrafts((prev) => {\n        if (!(saved.id in prev)) return prev\n        const next = { ...prev }\n        delete next[saved.id]\n        return next\n      })\n      return { ok: true, redirect: saved }\n    },\n    [projectId, cache],\n  )\n\n  const remove = useCallback<RedirectsStore['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (drafts[id]) {\n        setDrafts((prev) => {\n          const next = { ...prev }\n          delete next[id]\n          return next\n        })\n        return { ok: true }\n      }\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) =>\n        (prev ?? []).filter((r) => r.id !== id),\n      )\n      return { ok: true }\n    },\n    [projectId, cache, drafts],\n  )\n\n  const store = useMemo<RedirectsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      redirects: persisted,\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RedirectsContext.Provider value={store}>{children}</RedirectsContext.Provider>\n}\n\nexport { useRedirects }\n"]}
+{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\n/**\n * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302\n * forwards — read + written through the shared operations client (`redirects.*`),\n * the same seam the users/assets stores use. Content-gated (a viewer reads, an\n * editor writes); no draft/published split — a saved+enabled redirect is live.\n *\n * The \"New\" flow keeps an unsaved redirect as a LOCAL draft (memory only) until\n * the first explicit save persists it — so an abandoned \"New\" never writes a stub\n * to the backend and never shows in the list. Drafts are reachable via {@link\n * RedirectsStore.get} (the detail editor loads one), never listed.\n */\n\nexport interface RedirectsStore {\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */\n  redirects: readonly RedirectEntry[]\n  /** One redirect: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RedirectEntry | undefined\n  /** Mint a blank in-memory draft and return its id (the \"New\" navigation target). */\n  createDraft(): string\n  /** Persist a create/modify; drops the matching draft on success. */\n  save(\n    input: SaveRedirectInput,\n  ): Promise<{ ok: true; redirect: RedirectEntry } | { ok: false; message: string }>\n  /** Delete a persisted redirect, or silently discard an unsaved draft. */\n  remove(id: string): Promise<{ ok: true } | { ok: false; message: string }>\n  /** Re-list from the backend. */\n  refresh(): Promise<void>\n}\n\nconst { Context: RedirectsContext, useRequired: useRedirects } =\n  createRequiredContext<RedirectsStore>('Redirects')\n\nconst EMPTY_REDIRECTS: readonly RedirectEntry[] = []\n\nlet draftCounter = 0\n/** A collision-resistant client id for a new redirect (used as its real id on save). */\nfunction newDraftId(): string {\n  draftCounter += 1\n  return `redirect_${Date.now().toString(36)}_${draftCounter}`\n}\n\nfunction redirectsQueryKey(projectId: string): readonly [string, string] {\n  return ['redirects', projectId]\n}\n\nasync function loadRedirects(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<RedirectEntry[]> {\n  const result = await operations.redirects.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\n/**\n * The project's redirects, read through the shared operations cache — the ONE query\n * this rail uses, without needing {@link RedirectsProvider}.\n *\n * Extracted (EC-469) so the section rail's URL-map validation can read redirects from\n * outside the redirects module while sharing this exact query key. One key, one cache\n * entry (AD-17): the rail's foot and the rail itself are the same query, so opening\n * Redirects hits a warm cache, and `save`/`remove`'s `cache.patch` below updates both\n * at once — a fixed loop stops being reported the moment it is fixed.\n */\nexport function useRedirectList(projectId: string) {\n  return useOperationQuery<RedirectEntry[]>({\n    queryKey: redirectsQueryKey(projectId),\n    loader: (operations) => loadRedirects(operations, projectId),\n  })\n}\n\nfunction byFrom(a: RedirectEntry, b: RedirectEntry): number {\n  return a.from < b.from ? -1 : a.from > b.from ? 1 : 0\n}\n\nexport function RedirectsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useRedirectList(projectId)\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const persisted = query.data ?? EMPTY_REDIRECTS\n  const { status, errorMessage } = listStoreState(query)\n\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RedirectEntry>>({})\n\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback<RedirectsStore['get']>(\n    (id) => drafts[id] ?? persisted.find((r) => r.id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback<RedirectsStore['createDraft']>(() => {\n    const id = newDraftId()\n    const now = new Date().toISOString()\n    const draft: RedirectEntry = {\n      id,\n      projectId,\n      from: '',\n      to: '',\n      permanent: true,\n      // New redirects default to enabled — the reason you create one is for it to\n      // work; `enabled` is really the switch for *pausing* an existing redirect. A\n      // half-filled draft can't go live anyway (save requires from/to).\n      enabled: true,\n      createdAt: now,\n      updatedAt: now,\n    }\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [projectId])\n\n  const save = useCallback<RedirectsStore['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.save({\n        projectId,\n        ...(input.id !== undefined ? { id: input.id } : {}),\n        from: input.from,\n        to: input.to,\n        ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),\n        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),\n        ...(input.meta !== undefined ? { meta: input.meta } : {}),\n      })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) => {\n        const rest = (prev ?? []).filter((r) => r.id !== saved.id)\n        return [...rest, saved].sort(byFrom)\n      })\n      // The record is now persisted — drop any matching draft.\n      setDrafts((prev) => {\n        if (!(saved.id in prev)) return prev\n        const next = { ...prev }\n        delete next[saved.id]\n        return next\n      })\n      return { ok: true, redirect: saved }\n    },\n    [projectId, cache],\n  )\n\n  const remove = useCallback<RedirectsStore['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (drafts[id]) {\n        setDrafts((prev) => {\n          const next = { ...prev }\n          delete next[id]\n          return next\n        })\n        return { ok: true }\n      }\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) =>\n        (prev ?? []).filter((r) => r.id !== id),\n      )\n      return { ok: true }\n    },\n    [projectId, cache, drafts],\n  )\n\n  const store = useMemo<RedirectsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      redirects: persisted,\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RedirectsContext.Provider value={store}>{children}</RedirectsContext.Provider>\n}\n\nexport { useRedirects }\n"]}

package/dist/components/section-nav.js

@@ -1,14 +1,34 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Fragment, useCallback, useEffect, useState } from 'react';
+import { Fragment, useCallback, useEffect, useMemo, useState } from 'react';
 import { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router';
 import { AlertTriangle, ChevronDown, PanelLeftClose, PanelLeftOpen } from 'lucide-react';
 import { cn } from '@elytracms/studio/lib/utils';
 import { readCollapsedViews, storeCollapsedViews } from '@elytracms/studio/lib/rail';
+import { getStudioRegistry } from '@elytracms/studio/lib/registry';
+import { projectConfigIssues, resolveDeploymentCollections, resolveDeploymentReuse, resolveDeploymentRoutes, } from '@elytracms/studio/lib/workspace';
+import { routeValidationIssues } from '@elytracms/studio/lib/routes/route-issues';
 import { translate } from '@elytracms/studio/lib/i18n';
+import { cmsIssueLabel, cmsValidationIssueMessage, customizationIssueMessage, } from '@elytracms/studio/lib/persona/labels';
 import { Text } from '@elytracms/studio/ui';
 import { activeViewIdFromPath, isNavViewVisible, useStudioNav } from './app-views/sidebar.js';
+import { resolveReuse } from './builder/reuse.js';
+import { useRedirectList } from './redirects/redirects-store.js';
 import { useFieldRenderers } from './cms/field-renderer.js';
 import { useProjectRole } from './auth-context.js';
+/**
+ * Customization issues, as rail-foot items — localized (EC-478). The producers
+ * (`studio-core/customization.ts`, `default-modules.tsx`, `builder/reuse.ts`) emit a
+ * catalog key + identifier values rather than a sentence, because the EC-236 seam
+ * lives in `packages/core` and may not import the studio catalog;
+ * {@link customizationIssueMessage} resolves them here, so this list renders wholly in
+ * the active locale instead of half of it.
+ */
+function customizationItems(issues) {
+    return issues.map((issue, index) => ({
+        key: `${issue.point}:${issue.id ?? index}`,
+        message: customizationIssueMessage(issue),
+    }));
+}
 /**
  * Vertical section rail (brief §8.1), driven by the configurable sidebar (EC-237):
  * a consumer-extendable tree of views / groups / separators resolved over the
@@ -24,8 +44,16 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
     const activeViewId = activeViewIdFromPath(pathname);
     const { nodes, issues: navIssues } = useStudioNav(project);
     const { issues: rendererIssues } = useFieldRenderers();
-    const issues = [...navIssues, ...rendererIssues];
+    const configIssues = useProjectConfigIssues();
+    const reuseIssues = useReuseIssues();
     const projectId = project.id;
+    const routeIssues = useRouteIssues(projectId);
+    // Config issues lead: "this project declares no collections" explains every
+    // other emptiness on the screen, so it is the first thing to read.
+    const issues = [
+        ...customizationItems([...configIssues, ...navIssues, ...rendererIssues, ...reuseIssues]),
+        ...routeIssues,
+    ];
     // EC-240 (AD-18): per-nav-item, default-open permission gating. The signed-in
     // user's role drives an OPTIONAL `visible` predicate on any view; absent →
     // visible. UI reflection only — the server chokepoint stays the real boundary,
@@ -78,6 +106,73 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
                             : node.children?.filter(isVisible).map((child) => (_jsx(NavViewLink, { projectId: projectId, view: child, activeViewId: activeViewId, collapsed: collapsed, nested: true }, child.id)))] }, node.id));
             }), _jsxs("div", { className: "mt-auto flex flex-col gap-0.5", children: [issues.length > 0 ? _jsx(NavIssues, { issues: issues, collapsed: collapsed }) : null, _jsx("button", { type: "button", onClick: onToggleCollapsed, "aria-label": collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse'), "aria-pressed": collapsed, title: collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse'), className: cn('flex h-9 items-center gap-2.5 rounded-md text-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground', collapsed ? 'justify-center px-0' : 'px-3'), children: collapsed ? (_jsx(PanelLeftOpen, { className: "size-4 shrink-0" })) : (_jsxs(_Fragment, { children: [_jsx(PanelLeftClose, { className: "size-4 shrink-0" }), _jsx("span", { className: "min-w-0 flex-1 truncate text-left", children: translate('shell.sidebar.collapseLabel') })] })) })] })] }));
 }
+/**
+ * EC-479 — what the project has not declared but the studio cannot work without.
+ *
+ * Joins the rail foot for the same reason EC-467's and EC-469's findings do: it is a
+ * project-CONFIGURATION problem, not a content problem in one document, and the rail
+ * is on every studio surface. It exists at all because the engine used to hide this
+ * state behind its own `cms-core` fixtures — an unconfigured studio showed sample
+ * collections and sample documents as if they were the project's. Removing that
+ * fallback without reporting the absence would just trade a wrong screen for a blank
+ * one, which the house rule bans equally.
+ *
+ * Read from the config holder alone (static per studio boot, like `useReuseIssues`),
+ * so it needs no CMS provider and is memoised once. The pure decision core is
+ * `projectConfigIssues`.
+ */
+function useProjectConfigIssues() {
+    return useMemo(() => projectConfigIssues(resolveDeploymentCollections()), []);
+}
+/**
+ * EC-467 — the project's reusable-elements config issues: a declaration that
+ * cannot resolve, or an ambiguous inference the studio refuses to guess through.
+ * They join the rail foot because they are project-CONFIGURATION problems (like the
+ * rail's own and the field renderers'), not content problems in one document — and
+ * the rail is on every studio surface, so the developer cannot miss them. A project
+ * with an unambiguous embed, or with none at all, contributes nothing here.
+ *
+ * Resolved from the config holders alone (registry + config collections + studio
+ * config), all static per studio boot, so this needs no CMS provider and is
+ * memoised once. The pure decision core is `resolveReuse`.
+ */
+function useReuseIssues() {
+    return useMemo(() => resolveReuse(getStudioRegistry().registry.list(), resolveDeploymentCollections(), resolveDeploymentReuse()).issues, []);
+}
+/**
+ * EC-469 — the project's URL-map issues: two routes that match the same URLs, or a
+ * redirect chain that loops.
+ *
+ * They join the rail foot for the same reason EC-467's reusable-elements issues do:
+ * they are project-level problems, not content problems in one document, so the
+ * document-scoped issues pane has no place for them — and the rail is on every studio
+ * surface, so the developer cannot miss them. This is emphatically not a revived
+ * Routes view (EC-303 retired that, correctly): nothing here is editable, it is
+ * validation of the code + data the studio already reads.
+ *
+ * The two halves come from different planes, which is why only the studio can show
+ * both: routes are CODE (config, static per boot) while redirects are editorial DATA
+ * (the rail, live). The redirects read shares the rail's own query key, so a loop
+ * disappears from the foot the moment it is fixed — and while that query is loading or
+ * failed, `data` is absent and only the code-side conflicts are reported. That is
+ * honest: the rail itself surfaces its own load error.
+ *
+ * Copy follows the issues-pane convention (EC-192): the localized plain-language
+ * label, then the detail — both localized since EC-487, which gave `CmsValidationIssue`
+ * the same catalog-reference carriage EC-478 gave `CustomizationIssue`. Before that the
+ * label was German beside an English sentence, in the same list as the (already
+ * localized) customization issues.
+ */
+function useRouteIssues(projectId) {
+    const redirects = useRedirectList(projectId).data;
+    return useMemo(() => {
+        const issues = routeValidationIssues(resolveDeploymentRoutes(), redirects ?? []);
+        return issues.map((issue, index) => ({
+            key: `route-issue:${issue.code}:${issue.path.join('/') || index}`,
+            message: `${cmsIssueLabel(issue.code)} — ${cmsValidationIssueMessage(issue)}`,
+        }));
+    }, [redirects]);
+}
 /** One rail view (top-level or nested) — a Link to its home route, active by view id. */
 function NavViewLink({ projectId, view, activeViewId, collapsed, nested = false, hasActiveChild = false, collapsible = false, expanded = true, onToggleExpanded, }) {
     const isActive = view.id === activeViewId;
@@ -98,11 +193,14 @@ function NavViewLink({ projectId, view, activeViewId, collapsed, nested = false,
                     name: view.label,
                 }), "aria-expanded": expanded, className: "absolute right-1 top-1/2 grid size-6 -translate-y-1/2 place-items-center rounded text-muted-foreground/70 transition-colors hover:bg-background hover:text-foreground", children: _jsx(ChevronDown, { className: cn('size-3.5 transition-transform', expanded ? '' : '-rotate-90'), "aria-hidden": true }) })] }));
 }
-/** Visible customization issues at the rail foot — the seam's "never silent" (EC-236). */
+/**
+ * Visible project-level issues at the rail foot — the seam's "never silent" (EC-236,
+ * extended by EC-467's reuse issues and EC-469's URL-map issues).
+ */
 function NavIssues({ issues, collapsed }) {
     if (collapsed) {
         return (_jsx("div", { className: "grid h-9 place-items-center text-amber-600 dark:text-amber-400", title: issues.map((issue) => issue.message).join('\n'), children: _jsx(AlertTriangle, { className: "size-4", "aria-label": translate('shell.nav.issuesCount', { count: issues.length }) }) }));
     }
-    return (_jsx("div", { className: "mb-1 flex flex-col gap-1 rounded-md border border-amber-500/30 bg-amber-500/5 p-2", children: issues.map((issue, index) => (_jsxs("div", { className: "flex items-start gap-1.5 text-amber-600 dark:text-amber-400", title: issue.message, children: [_jsx(AlertTriangle, { className: "mt-0.5 size-3.5 shrink-0", "aria-hidden": true }), _jsx(Text, { size: "xs", className: "min-w-0 leading-snug", children: issue.message })] }, `${issue.point}:${issue.id ?? index}`))) }));
+    return (_jsx("div", { className: "mb-1 flex flex-col gap-1 rounded-md border border-amber-500/30 bg-amber-500/5 p-2", children: issues.map((issue) => (_jsxs("div", { className: "flex items-start gap-1.5 text-amber-600 dark:text-amber-400", title: issue.message, children: [_jsx(AlertTriangle, { className: "mt-0.5 size-3.5 shrink-0", "aria-hidden": true }), _jsx(Text, { size: "xs", className: "min-w-0 leading-snug", children: issue.message })] }, issue.key))) }));
 }
 //# sourceMappingURL=section-nav.js.map

package/dist/components/section-nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-nav.js","sourceRoot":"","sources":["../../src/components/section-nav.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Fragment, useCallback, useEffect, useState } from 'react'\nimport { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router'\nimport { AlertTriangle, ChevronDown, PanelLeftClose, PanelLeftOpen } from 'lucide-react'\nimport type { Project } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\nimport { cn } from '@elytracms/studio/lib/utils'\nimport { readCollapsedViews, storeCollapsedViews } from '@elytracms/studio/lib/rail'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { Text } from '@elytracms/studio/ui'\nimport { activeViewIdFromPath, isNavViewVisible, useStudioNav } from './app-views/sidebar'\nimport type { ResolvedRailView } from './app-views/sidebar'\nimport { useFieldRenderers } from './cms/field-renderer'\nimport { useProjectRole } from './auth-context'\nimport type { NavPermissionContext } from './app-views/module'\n\nexport interface SectionNavProps {\n  project: Project\n  /** User-toggled collapse (EC-214) — icons only when collapsed, persisted by the shell. */\n  collapsed: boolean\n  onToggleCollapsed: () => void\n}\n\n/**\n * Vertical section rail (brief §8.1), driven by the configurable sidebar (EC-237):\n * a consumer-extendable tree of views / groups / separators resolved over the\n * built-in views (EC-239). Availability-aware (`unavailable` items are absent per\n * EC-221); the active item is matched by the VIEW ID in the URL, so two views\n * backed by the same surface (Content vs. a focused Categories) highlight\n * independently. The preference-persisted collapse and the strong active marker\n * (EC-214) are preserved. Customization issues (duplicate view id, invalid view,\n * non-component renderers) render at the rail foot — visible, never silent.\n */\nexport function SectionNav({ project, collapsed, onToggleCollapsed }: SectionNavProps) {\n  const { pathname } = useLocation()\n  const activeViewId = activeViewIdFromPath(pathname)\n  const { nodes, issues: navIssues } = useStudioNav(project)\n  const { issues: rendererIssues } = useFieldRenderers()\n  const issues = [...navIssues, ...rendererIssues]\n  const projectId = project.id\n\n  // EC-240 (AD-18): per-nav-item, default-open permission gating. The signed-in\n  // user's role drives an OPTIONAL `visible` predicate on any view; absent →\n  // visible. UI reflection only — the server chokepoint stays the real boundary,\n  // and a permission-hidden view is still reachable by URL (EC-221).\n  const role = useProjectRole(projectId)\n  const navCtx: NavPermissionContext = { project, role }\n  const isVisible = (view: ResolvedRailView) => isNavViewVisible(view, navCtx)\n\n  // EC-293: per-parent collapse of nested sub-views, persisted (read after mount,\n  // like the rail-collapse pref — no flash script needed). A collapsed parent hides\n  // its children but stays a navigable link.\n  const [collapsedViews, setCollapsedViews] = useState<Set<string>>(() => new Set())\n  useEffect(() => {\n    setCollapsedViews(readCollapsedViews())\n  }, [])\n  const toggleViewCollapsed = useCallback((id: string) => {\n    setCollapsedViews((prev) => {\n      const next = new Set(prev)\n      if (next.has(id)) next.delete(id)\n      else next.add(id)\n      storeCollapsedViews(next)\n      return next\n    })\n  }, [])\n\n  return (\n    <nav\n      aria-label={translate('shell.nav.label')}\n      className={cn(\n        'flex shrink-0 flex-col gap-0.5 border-r border-border bg-card/40 p-2 transition-[width] duration-150',\n        collapsed ? 'w-[3.5rem]' : 'w-56',\n      )}\n    >\n      {nodes.map((node, index) => {\n        if (node.kind === 'separator') {\n          return <div key={`sep-${index}`} className=\"my-1.5 border-t border-border/60\" aria-hidden />\n        }\n        if (node.kind === 'group') {\n          const views = node.views.filter(\n            (view) => view.availability !== 'unavailable' && isVisible(view),\n          )\n          if (views.length === 0) return null\n          return (\n            <div key={`group-${node.label}-${index}`} className=\"mt-2 first:mt-0\">\n              {collapsed ? (\n                <div className=\"my-1 border-t border-border/60\" aria-hidden />\n              ) : (\n                <Text\n                  size=\"xs\"\n                  tone=\"subtle\"\n                  className=\"px-3 pb-1 pt-1 font-medium uppercase tracking-wide\"\n                >\n                  {node.label}\n                </Text>\n              )}\n              {views.map((view) => (\n                <NavViewLink\n                  key={view.id}\n                  projectId={projectId}\n                  view={view}\n                  activeViewId={activeViewId}\n                  collapsed={collapsed}\n                />\n              ))}\n            </div>\n          )\n        }\n        // EC-221: an unavailable view is absent from the rail (not greyed) — it\n        // stays reachable by URL, the rail simply doesn't advertise it. EC-240: a\n        // permission-hidden view is likewise absent-but-addressable.\n        if (node.availability === 'unavailable' || !isVisible(node)) return null\n        // EC-293: a view may nest its sub-views (CMS collections). The parent renders\n        // as a link with a disclosure chevron; its children render indented below,\n        // hidden when the rail is collapsed OR this parent is collapsed. The parent\n        // gets a subtle active hint when one of its children is the active view.\n        const hasChildren = (node.children?.length ?? 0) > 0\n        const hasActiveChild = node.children?.some((child) => child.id === activeViewId) ?? false\n        const viewCollapsed = collapsedViews.has(node.id)\n        return (\n          <Fragment key={node.id}>\n            <NavViewLink\n              projectId={projectId}\n              view={node}\n              activeViewId={activeViewId}\n              collapsed={collapsed}\n              hasActiveChild={hasActiveChild}\n              collapsible={hasChildren && !collapsed}\n              expanded={!viewCollapsed}\n              onToggleExpanded={() => toggleViewCollapsed(node.id)}\n            />\n            {collapsed || viewCollapsed\n              ? null\n              : node.children?.filter(isVisible).map((child) => (\n                  <NavViewLink\n                    key={child.id}\n                    projectId={projectId}\n                    view={child}\n                    activeViewId={activeViewId}\n                    collapsed={collapsed}\n                    nested\n                  />\n                ))}\n          </Fragment>\n        )\n      })}\n\n      <div className=\"mt-auto flex flex-col gap-0.5\">\n        {issues.length > 0 ? <NavIssues issues={issues} collapsed={collapsed} /> : null}\n\n        {/* Collapse toggle pinned to the rail foot (EC-214). */}\n        <button\n          type=\"button\"\n          onClick={onToggleCollapsed}\n          aria-label={collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse')}\n          aria-pressed={collapsed}\n          title={collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse')}\n          className={cn(\n            'flex h-9 items-center gap-2.5 rounded-md text-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground',\n            collapsed ? 'justify-center px-0' : 'px-3',\n          )}\n        >\n          {collapsed ? (\n            <PanelLeftOpen className=\"size-4 shrink-0\" />\n          ) : (\n            <>\n              <PanelLeftClose className=\"size-4 shrink-0\" />\n              <span className=\"min-w-0 flex-1 truncate text-left\">{translate('shell.sidebar.collapseLabel')}</span>\n            </>\n          )}\n        </button>\n      </div>\n    </nav>\n  )\n}\n\n/** One rail view (top-level or nested) — a Link to its home route, active by view id. */\nfunction NavViewLink({\n  projectId,\n  view,\n  activeViewId,\n  collapsed,\n  nested = false,\n  hasActiveChild = false,\n  collapsible = false,\n  expanded = true,\n  onToggleExpanded,\n}: {\n  projectId: string\n  view: ResolvedRailView\n  activeViewId: string | null\n  collapsed: boolean\n  nested?: boolean\n  /** EC-293: this parent's a child is the active view → a subtle (non-accent) hint. */\n  hasActiveChild?: boolean\n  /** EC-293: this parent has nested children → render a disclosure chevron. */\n  collapsible?: boolean\n  /** Whether the nested children are shown (chevron points down) or hidden. */\n  expanded?: boolean\n  /** Toggle this parent's collapse (the chevron click — does not navigate). */\n  onToggleExpanded?: () => void\n}) {\n  const isActive = view.id === activeViewId\n  const Icon = view.icon\n  const link = (\n    <Link\n      to={STUDIO_PROJECT_ROUTE}\n      params={{ projectId, _splat: view.path }}\n      title={view.label}\n      aria-current={isActive ? 'page' : undefined}\n      className={cn(\n        'group relative flex h-9 items-center gap-2.5 rounded-md text-sm transition-colors',\n        // Collapsible parents reserve room on the right for the chevron toggle.\n        collapsed ? 'justify-center px-0' : nested ? 'pl-7 pr-3' : collapsible ? 'pl-3 pr-9' : 'px-3',\n        isActive\n          ? 'bg-accent font-medium text-accent-foreground'\n          : hasActiveChild\n            ? 'text-foreground hover:bg-muted'\n            : 'text-muted-foreground hover:bg-muted hover:text-foreground',\n      )}\n    >\n      {/* Strong active marker: a leading accent bar (EC-214). */}\n      {isActive ? (\n        <span className=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\" aria-hidden />\n      ) : null}\n      <Icon className=\"size-4 shrink-0\" />\n      {collapsed ? null : <span className=\"min-w-0 flex-1 truncate\">{view.label}</span>}\n      {view.availability === 'planned' && !collapsed ? (\n        <span className=\"size-1.5 shrink-0 rounded-full bg-warning\" aria-hidden title={translate('shell.nav.planned')} />\n      ) : null}\n    </Link>\n  )\n  // A leaf (or the collapsed icons-only rail) is just the link.\n  if (!collapsible) return link\n  // A parent pairs the link with a sibling chevron toggle (so the chevron collapses\n  // without navigating, and the link still navigates to the parent surface).\n  return (\n    <div className=\"relative\">\n      {link}\n      <button\n        type=\"button\"\n        onClick={onToggleExpanded}\n        aria-label={translate(expanded ? 'shell.nav.collapseView' : 'shell.nav.expandView', {\n          name: view.label,\n        })}\n        aria-expanded={expanded}\n        className=\"absolute right-1 top-1/2 grid size-6 -translate-y-1/2 place-items-center rounded text-muted-foreground/70 transition-colors hover:bg-background hover:text-foreground\"\n      >\n        <ChevronDown\n          className={cn('size-3.5 transition-transform', expanded ? '' : '-rotate-90')}\n          aria-hidden\n        />\n      </button>\n    </div>\n  )\n}\n\n/** Visible customization issues at the rail foot — the seam's \"never silent\" (EC-236). */\nfunction NavIssues({ issues, collapsed }: { issues: CustomizationIssue[]; collapsed: boolean }) {\n  if (collapsed) {\n    return (\n      <div\n        className=\"grid h-9 place-items-center text-amber-600 dark:text-amber-400\"\n        title={issues.map((issue) => issue.message).join('\\n')}\n      >\n        <AlertTriangle className=\"size-4\" aria-label={translate('shell.nav.issuesCount', { count: issues.length })} />\n      </div>\n    )\n  }\n  return (\n    <div className=\"mb-1 flex flex-col gap-1 rounded-md border border-amber-500/30 bg-amber-500/5 p-2\">\n      {issues.map((issue, index) => (\n        <div\n          key={`${issue.point}:${issue.id ?? index}`}\n          className=\"flex items-start gap-1.5 text-amber-600 dark:text-amber-400\"\n          title={issue.message}\n        >\n          <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0\" aria-hidden />\n          <Text size=\"xs\" className=\"min-w-0 leading-snug\">\n            {issue.message}\n          </Text>\n        </div>\n      ))}\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"section-nav.js","sourceRoot":"","sources":["../../src/components/section-nav.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Fragment, useCallback, useEffect, useMemo, useState } from 'react'\nimport { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router'\nimport { AlertTriangle, ChevronDown, PanelLeftClose, PanelLeftOpen } from 'lucide-react'\nimport type { Project } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\nimport { cn } from '@elytracms/studio/lib/utils'\nimport { readCollapsedViews, storeCollapsedViews } from '@elytracms/studio/lib/rail'\nimport { getStudioRegistry } from '@elytracms/studio/lib/registry'\nimport {\n  projectConfigIssues,\n  resolveDeploymentCollections,\n  resolveDeploymentReuse,\n  resolveDeploymentRoutes,\n} from '@elytracms/studio/lib/workspace'\nimport { routeValidationIssues } from '@elytracms/studio/lib/routes/route-issues'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport {\n  cmsIssueLabel,\n  cmsValidationIssueMessage,\n  customizationIssueMessage,\n} from '@elytracms/studio/lib/persona/labels'\nimport { Text } from '@elytracms/studio/ui'\nimport { activeViewIdFromPath, isNavViewVisible, useStudioNav } from './app-views/sidebar'\nimport type { ResolvedRailView } from './app-views/sidebar'\nimport { resolveReuse } from './builder/reuse'\nimport { useRedirectList } from './redirects/redirects-store'\nimport { useFieldRenderers } from './cms/field-renderer'\nimport { useProjectRole } from './auth-context'\nimport type { NavPermissionContext } from './app-views/module'\n\nexport interface SectionNavProps {\n  project: Project\n  /** User-toggled collapse (EC-214) — icons only when collapsed, persisted by the shell. */\n  collapsed: boolean\n  onToggleCollapsed: () => void\n}\n\n/**\n * What the rail foot needs to render one finding: a stable key and a message. The\n * least common shape across its contributing sources — customization issues\n * (`CustomizationIssue`) and URL-map validation (`CmsValidationIssue`, EC-469) — so a\n * new source joins by mapping to this, not by pretending to be a customization issue.\n */\ninterface NavIssueItem {\n  key: string\n  message: string\n}\n\n/**\n * Customization issues, as rail-foot items — localized (EC-478). The producers\n * (`studio-core/customization.ts`, `default-modules.tsx`, `builder/reuse.ts`) emit a\n * catalog key + identifier values rather than a sentence, because the EC-236 seam\n * lives in `packages/core` and may not import the studio catalog;\n * {@link customizationIssueMessage} resolves them here, so this list renders wholly in\n * the active locale instead of half of it.\n */\nfunction customizationItems(issues: readonly CustomizationIssue[]): NavIssueItem[] {\n  return issues.map((issue, index) => ({\n    key: `${issue.point}:${issue.id ?? index}`,\n    message: customizationIssueMessage(issue),\n  }))\n}\n\n/**\n * Vertical section rail (brief §8.1), driven by the configurable sidebar (EC-237):\n * a consumer-extendable tree of views / groups / separators resolved over the\n * built-in views (EC-239). Availability-aware (`unavailable` items are absent per\n * EC-221); the active item is matched by the VIEW ID in the URL, so two views\n * backed by the same surface (Content vs. a focused Categories) highlight\n * independently. The preference-persisted collapse and the strong active marker\n * (EC-214) are preserved. Customization issues (duplicate view id, invalid view,\n * non-component renderers) render at the rail foot — visible, never silent.\n */\nexport function SectionNav({ project, collapsed, onToggleCollapsed }: SectionNavProps) {\n  const { pathname } = useLocation()\n  const activeViewId = activeViewIdFromPath(pathname)\n  const { nodes, issues: navIssues } = useStudioNav(project)\n  const { issues: rendererIssues } = useFieldRenderers()\n  const configIssues = useProjectConfigIssues()\n  const reuseIssues = useReuseIssues()\n  const projectId = project.id\n  const routeIssues = useRouteIssues(projectId)\n  // Config issues lead: \"this project declares no collections\" explains every\n  // other emptiness on the screen, so it is the first thing to read.\n  const issues = [\n    ...customizationItems([...configIssues, ...navIssues, ...rendererIssues, ...reuseIssues]),\n    ...routeIssues,\n  ]\n\n  // EC-240 (AD-18): per-nav-item, default-open permission gating. The signed-in\n  // user's role drives an OPTIONAL `visible` predicate on any view; absent →\n  // visible. UI reflection only — the server chokepoint stays the real boundary,\n  // and a permission-hidden view is still reachable by URL (EC-221).\n  const role = useProjectRole(projectId)\n  const navCtx: NavPermissionContext = { project, role }\n  const isVisible = (view: ResolvedRailView) => isNavViewVisible(view, navCtx)\n\n  // EC-293: per-parent collapse of nested sub-views, persisted (read after mount,\n  // like the rail-collapse pref — no flash script needed). A collapsed parent hides\n  // its children but stays a navigable link.\n  const [collapsedViews, setCollapsedViews] = useState<Set<string>>(() => new Set())\n  useEffect(() => {\n    setCollapsedViews(readCollapsedViews())\n  }, [])\n  const toggleViewCollapsed = useCallback((id: string) => {\n    setCollapsedViews((prev) => {\n      const next = new Set(prev)\n      if (next.has(id)) next.delete(id)\n      else next.add(id)\n      storeCollapsedViews(next)\n      return next\n    })\n  }, [])\n\n  return (\n    <nav\n      aria-label={translate('shell.nav.label')}\n      className={cn(\n        'flex shrink-0 flex-col gap-0.5 border-r border-border bg-card/40 p-2 transition-[width] duration-150',\n        collapsed ? 'w-[3.5rem]' : 'w-56',\n      )}\n    >\n      {nodes.map((node, index) => {\n        if (node.kind === 'separator') {\n          return <div key={`sep-${index}`} className=\"my-1.5 border-t border-border/60\" aria-hidden />\n        }\n        if (node.kind === 'group') {\n          const views = node.views.filter(\n            (view) => view.availability !== 'unavailable' && isVisible(view),\n          )\n          if (views.length === 0) return null\n          return (\n            <div key={`group-${node.label}-${index}`} className=\"mt-2 first:mt-0\">\n              {collapsed ? (\n                <div className=\"my-1 border-t border-border/60\" aria-hidden />\n              ) : (\n                <Text\n                  size=\"xs\"\n                  tone=\"subtle\"\n                  className=\"px-3 pb-1 pt-1 font-medium uppercase tracking-wide\"\n                >\n                  {node.label}\n                </Text>\n              )}\n              {views.map((view) => (\n                <NavViewLink\n                  key={view.id}\n                  projectId={projectId}\n                  view={view}\n                  activeViewId={activeViewId}\n                  collapsed={collapsed}\n                />\n              ))}\n            </div>\n          )\n        }\n        // EC-221: an unavailable view is absent from the rail (not greyed) — it\n        // stays reachable by URL, the rail simply doesn't advertise it. EC-240: a\n        // permission-hidden view is likewise absent-but-addressable.\n        if (node.availability === 'unavailable' || !isVisible(node)) return null\n        // EC-293: a view may nest its sub-views (CMS collections). The parent renders\n        // as a link with a disclosure chevron; its children render indented below,\n        // hidden when the rail is collapsed OR this parent is collapsed. The parent\n        // gets a subtle active hint when one of its children is the active view.\n        const hasChildren = (node.children?.length ?? 0) > 0\n        const hasActiveChild = node.children?.some((child) => child.id === activeViewId) ?? false\n        const viewCollapsed = collapsedViews.has(node.id)\n        return (\n          <Fragment key={node.id}>\n            <NavViewLink\n              projectId={projectId}\n              view={node}\n              activeViewId={activeViewId}\n              collapsed={collapsed}\n              hasActiveChild={hasActiveChild}\n              collapsible={hasChildren && !collapsed}\n              expanded={!viewCollapsed}\n              onToggleExpanded={() => toggleViewCollapsed(node.id)}\n            />\n            {collapsed || viewCollapsed\n              ? null\n              : node.children?.filter(isVisible).map((child) => (\n                  <NavViewLink\n                    key={child.id}\n                    projectId={projectId}\n                    view={child}\n                    activeViewId={activeViewId}\n                    collapsed={collapsed}\n                    nested\n                  />\n                ))}\n          </Fragment>\n        )\n      })}\n\n      <div className=\"mt-auto flex flex-col gap-0.5\">\n        {issues.length > 0 ? <NavIssues issues={issues} collapsed={collapsed} /> : null}\n\n        {/* Collapse toggle pinned to the rail foot (EC-214). */}\n        <button\n          type=\"button\"\n          onClick={onToggleCollapsed}\n          aria-label={collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse')}\n          aria-pressed={collapsed}\n          title={collapsed ? translate('shell.sidebar.expand') : translate('shell.sidebar.collapse')}\n          className={cn(\n            'flex h-9 items-center gap-2.5 rounded-md text-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground',\n            collapsed ? 'justify-center px-0' : 'px-3',\n          )}\n        >\n          {collapsed ? (\n            <PanelLeftOpen className=\"size-4 shrink-0\" />\n          ) : (\n            <>\n              <PanelLeftClose className=\"size-4 shrink-0\" />\n              <span className=\"min-w-0 flex-1 truncate text-left\">{translate('shell.sidebar.collapseLabel')}</span>\n            </>\n          )}\n        </button>\n      </div>\n    </nav>\n  )\n}\n\n/**\n * EC-479 — what the project has not declared but the studio cannot work without.\n *\n * Joins the rail foot for the same reason EC-467's and EC-469's findings do: it is a\n * project-CONFIGURATION problem, not a content problem in one document, and the rail\n * is on every studio surface. It exists at all because the engine used to hide this\n * state behind its own `cms-core` fixtures — an unconfigured studio showed sample\n * collections and sample documents as if they were the project's. Removing that\n * fallback without reporting the absence would just trade a wrong screen for a blank\n * one, which the house rule bans equally.\n *\n * Read from the config holder alone (static per studio boot, like `useReuseIssues`),\n * so it needs no CMS provider and is memoised once. The pure decision core is\n * `projectConfigIssues`.\n */\nfunction useProjectConfigIssues(): CustomizationIssue[] {\n  return useMemo(() => projectConfigIssues(resolveDeploymentCollections()), [])\n}\n\n/**\n * EC-467 — the project's reusable-elements config issues: a declaration that\n * cannot resolve, or an ambiguous inference the studio refuses to guess through.\n * They join the rail foot because they are project-CONFIGURATION problems (like the\n * rail's own and the field renderers'), not content problems in one document — and\n * the rail is on every studio surface, so the developer cannot miss them. A project\n * with an unambiguous embed, or with none at all, contributes nothing here.\n *\n * Resolved from the config holders alone (registry + config collections + studio\n * config), all static per studio boot, so this needs no CMS provider and is\n * memoised once. The pure decision core is `resolveReuse`.\n */\nfunction useReuseIssues(): CustomizationIssue[] {\n  return useMemo(\n    () =>\n      resolveReuse(\n        getStudioRegistry().registry.list(),\n        resolveDeploymentCollections(),\n        resolveDeploymentReuse(),\n      ).issues,\n    [],\n  )\n}\n\n/**\n * EC-469 — the project's URL-map issues: two routes that match the same URLs, or a\n * redirect chain that loops.\n *\n * They join the rail foot for the same reason EC-467's reusable-elements issues do:\n * they are project-level problems, not content problems in one document, so the\n * document-scoped issues pane has no place for them — and the rail is on every studio\n * surface, so the developer cannot miss them. This is emphatically not a revived\n * Routes view (EC-303 retired that, correctly): nothing here is editable, it is\n * validation of the code + data the studio already reads.\n *\n * The two halves come from different planes, which is why only the studio can show\n * both: routes are CODE (config, static per boot) while redirects are editorial DATA\n * (the rail, live). The redirects read shares the rail's own query key, so a loop\n * disappears from the foot the moment it is fixed — and while that query is loading or\n * failed, `data` is absent and only the code-side conflicts are reported. That is\n * honest: the rail itself surfaces its own load error.\n *\n * Copy follows the issues-pane convention (EC-192): the localized plain-language\n * label, then the detail — both localized since EC-487, which gave `CmsValidationIssue`\n * the same catalog-reference carriage EC-478 gave `CustomizationIssue`. Before that the\n * label was German beside an English sentence, in the same list as the (already\n * localized) customization issues.\n */\nfunction useRouteIssues(projectId: string): NavIssueItem[] {\n  const redirects = useRedirectList(projectId).data\n  return useMemo(() => {\n    const issues = routeValidationIssues(resolveDeploymentRoutes(), redirects ?? [])\n    return issues.map((issue, index) => ({\n      key: `route-issue:${issue.code}:${issue.path.join('/') || index}`,\n      message: `${cmsIssueLabel(issue.code)} — ${cmsValidationIssueMessage(issue)}`,\n    }))\n  }, [redirects])\n}\n\n/** One rail view (top-level or nested) — a Link to its home route, active by view id. */\nfunction NavViewLink({\n  projectId,\n  view,\n  activeViewId,\n  collapsed,\n  nested = false,\n  hasActiveChild = false,\n  collapsible = false,\n  expanded = true,\n  onToggleExpanded,\n}: {\n  projectId: string\n  view: ResolvedRailView\n  activeViewId: string | null\n  collapsed: boolean\n  nested?: boolean\n  /** EC-293: this parent's a child is the active view → a subtle (non-accent) hint. */\n  hasActiveChild?: boolean\n  /** EC-293: this parent has nested children → render a disclosure chevron. */\n  collapsible?: boolean\n  /** Whether the nested children are shown (chevron points down) or hidden. */\n  expanded?: boolean\n  /** Toggle this parent's collapse (the chevron click — does not navigate). */\n  onToggleExpanded?: () => void\n}) {\n  const isActive = view.id === activeViewId\n  const Icon = view.icon\n  const link = (\n    <Link\n      to={STUDIO_PROJECT_ROUTE}\n      params={{ projectId, _splat: view.path }}\n      title={view.label}\n      aria-current={isActive ? 'page' : undefined}\n      className={cn(\n        'group relative flex h-9 items-center gap-2.5 rounded-md text-sm transition-colors',\n        // Collapsible parents reserve room on the right for the chevron toggle.\n        collapsed ? 'justify-center px-0' : nested ? 'pl-7 pr-3' : collapsible ? 'pl-3 pr-9' : 'px-3',\n        isActive\n          ? 'bg-accent font-medium text-accent-foreground'\n          : hasActiveChild\n            ? 'text-foreground hover:bg-muted'\n            : 'text-muted-foreground hover:bg-muted hover:text-foreground',\n      )}\n    >\n      {/* Strong active marker: a leading accent bar (EC-214). */}\n      {isActive ? (\n        <span className=\"absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary\" aria-hidden />\n      ) : null}\n      <Icon className=\"size-4 shrink-0\" />\n      {collapsed ? null : <span className=\"min-w-0 flex-1 truncate\">{view.label}</span>}\n      {view.availability === 'planned' && !collapsed ? (\n        <span className=\"size-1.5 shrink-0 rounded-full bg-warning\" aria-hidden title={translate('shell.nav.planned')} />\n      ) : null}\n    </Link>\n  )\n  // A leaf (or the collapsed icons-only rail) is just the link.\n  if (!collapsible) return link\n  // A parent pairs the link with a sibling chevron toggle (so the chevron collapses\n  // without navigating, and the link still navigates to the parent surface).\n  return (\n    <div className=\"relative\">\n      {link}\n      <button\n        type=\"button\"\n        onClick={onToggleExpanded}\n        aria-label={translate(expanded ? 'shell.nav.collapseView' : 'shell.nav.expandView', {\n          name: view.label,\n        })}\n        aria-expanded={expanded}\n        className=\"absolute right-1 top-1/2 grid size-6 -translate-y-1/2 place-items-center rounded text-muted-foreground/70 transition-colors hover:bg-background hover:text-foreground\"\n      >\n        <ChevronDown\n          className={cn('size-3.5 transition-transform', expanded ? '' : '-rotate-90')}\n          aria-hidden\n        />\n      </button>\n    </div>\n  )\n}\n\n/**\n * Visible project-level issues at the rail foot — the seam's \"never silent\" (EC-236,\n * extended by EC-467's reuse issues and EC-469's URL-map issues).\n */\nfunction NavIssues({ issues, collapsed }: { issues: NavIssueItem[]; collapsed: boolean }) {\n  if (collapsed) {\n    return (\n      <div\n        className=\"grid h-9 place-items-center text-amber-600 dark:text-amber-400\"\n        title={issues.map((issue) => issue.message).join('\\n')}\n      >\n        <AlertTriangle className=\"size-4\" aria-label={translate('shell.nav.issuesCount', { count: issues.length })} />\n      </div>\n    )\n  }\n  return (\n    <div className=\"mb-1 flex flex-col gap-1 rounded-md border border-amber-500/30 bg-amber-500/5 p-2\">\n      {issues.map((issue) => (\n        <div\n          key={issue.key}\n          className=\"flex items-start gap-1.5 text-amber-600 dark:text-amber-400\"\n          title={issue.message}\n        >\n          <AlertTriangle className=\"mt-0.5 size-3.5 shrink-0\" aria-hidden />\n          <Text size=\"xs\" className=\"min-w-0 leading-snug\">\n            {issue.message}\n          </Text>\n        </div>\n      ))}\n    </div>\n  )\n}\n"]}

package/dist/customization.d.ts

@@ -48,6 +48,13 @@ export type { StudioConfig, StudioCanvasTheme, StudioPreviewsConfig, CustomField
  * render an icon+name placeholder.
  */
 export type { GeneratedPreviewLookup } from './components/builder/blocks-model.js';
+/**
+ * Reusable elements (EC-467): the OPTIONAL one-line declaration of which component
+ * is the project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.
+ * Absence means INFER (the zero-config default), not off. Reusable elements are
+ * singular per project: one embed component, one reusable collection.
+ */
+export type { StudioReuseConfig } from './components/builder/reuse.js';
 /**
  * The EC-440 previews-manifest adapter: `elytra previews` writes
  * `studio/elytra-previews.json` + images under `public/elytra-previews/`; the

package/dist/customization.js.map

@@ -1 +1 @@
-{"version":3,"file":"customization.js","sourceRoot":"","sources":["../src/customization.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAgBnE;;;;;;GAMG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAK1E,OAAO,EAAE,GAAG,EAAE,MAAM,wCAAwC,CAAA;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,oFAAoF;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA","sourcesContent":["/**\n * `@elytracms/studio/customization` — the public customization API for a consuming\n * repo's `studio.config.tsx` (EC-236/237/238/239).\n *\n * Everything a repo customizes about the builder UI is **live studio code passed by\n * reference** through `defineStudio({...})` — the section rail (`nav.*`), custom\n * field renderers, and (in time) branding. This config is studio-only: it is handed\n * to `createStudio(config, studioConfig)` at the mount and never enters the shared\n * `elytra.config.ts` / the `frontend/` delivery bundle. The customization principle\n * in one import surface: direct values, no registries, no string ids — the lone\n * string seam is `fieldRenderers`' control key, which the delivery-shared schema\n * references via `form.control`.\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n *\n * // router.tsx (the mount)\n * import { createStudio } from '@elytracms/studio/customization'\n * import config from '../../elytra.config'\n * import studioConfig from './studio.config'\n * createStudio(config, studioConfig)\n * ```\n */\nexport { defineStudio } from './components/app-views/studio-config'\nexport type {\n  StudioConfig,\n  StudioCanvasTheme,\n  StudioPreviewsConfig,\n  CustomFieldRenderer,\n  CustomFieldRendererProps,\n} from './components/app-views/studio-config'\n/**\n * The generated-preview seam (EC-439, filled by EC-440's `elytra previews`):\n * `defineStudio({ previews: { generated } })` supplies a pure\n * `componentId + fixtureName → URL` lookup for build-time fixture preview\n * images. Curated `manifest.previewImage` wins over it; without either, tiles\n * render an icon+name placeholder.\n */\nexport type { GeneratedPreviewLookup } from './components/builder/blocks-model'\n/**\n * The EC-440 previews-manifest adapter: `elytra previews` writes\n * `studio/elytra-previews.json` + images under `public/elytra-previews/`; the\n * consumer wires the seam in two lines —\n * `import previewsManifest from './elytra-previews.json'` and\n * `previews: { generated: generatedPreviewsFromManifest(previewsManifest) }`.\n */\nexport { generatedPreviewsFromManifest } from './previews/manifest-format'\nexport type {\n  GeneratedPreviewsManifest,\n  GeneratedPreviewsManifestEntry,\n} from './previews/manifest-format'\nexport { nav } from './components/app-views/default-modules'\nexport type {\n  CmsViewConfig,\n  BuiltinViewConfig,\n  CustomViewConfig,\n} from './components/app-views/default-modules'\nexport type { AppViewContext, AppViewModule, SidebarNode } from './components/app-views/module'\nexport { createStudio } from './lib/workspace'\n/** A ready-made example renderer; a consuming repo may use it or author its own. */\nexport { colorFieldRenderer } from './components/cms/field-renderer'\n/**\n * Studio-UI localization (EC-241): author a translation catalog for `defineStudio({\n * i18n })`. `msg` is only needed to build an in-repo *source* catalog with translator\n * hints; a plain `MessageCatalog` (flat key → string) is all a consumer supplies.\n * Prefer `TranslationCatalog` (EC-398) when authoring: it is typed against the EN key\n * set, so unknown/stale keys fail typecheck — engine-shipped locales\n * (`@elytracms/studio/locales/de`) and spread-overrides of them use it.\n */\nexport { msg } from './lib/i18n'\nexport type {\n  MessageCatalog,\n  MessageKey,\n  SourceMessage,\n  StudioI18nConfig,\n  TranslationCatalog,\n} from './lib/i18n'\n"]}
+{"version":3,"file":"customization.js","sourceRoot":"","sources":["../src/customization.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAuBnE;;;;;;GAMG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAK1E,OAAO,EAAE,GAAG,EAAE,MAAM,wCAAwC,CAAA;AAO5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,oFAAoF;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA","sourcesContent":["/**\n * `@elytracms/studio/customization` — the public customization API for a consuming\n * repo's `studio.config.tsx` (EC-236/237/238/239).\n *\n * Everything a repo customizes about the builder UI is **live studio code passed by\n * reference** through `defineStudio({...})` — the section rail (`nav.*`), custom\n * field renderers, and (in time) branding. This config is studio-only: it is handed\n * to `createStudio(config, studioConfig)` at the mount and never enters the shared\n * `elytra.config.ts` / the `frontend/` delivery bundle. The customization principle\n * in one import surface: direct values, no registries, no string ids — the lone\n * string seam is `fieldRenderers`' control key, which the delivery-shared schema\n * references via `form.control`.\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n *\n * // router.tsx (the mount)\n * import { createStudio } from '@elytracms/studio/customization'\n * import config from '../../elytra.config'\n * import studioConfig from './studio.config'\n * createStudio(config, studioConfig)\n * ```\n */\nexport { defineStudio } from './components/app-views/studio-config'\nexport type {\n  StudioConfig,\n  StudioCanvasTheme,\n  StudioPreviewsConfig,\n  CustomFieldRenderer,\n  CustomFieldRendererProps,\n} from './components/app-views/studio-config'\n/**\n * The generated-preview seam (EC-439, filled by EC-440's `elytra previews`):\n * `defineStudio({ previews: { generated } })` supplies a pure\n * `componentId + fixtureName → URL` lookup for build-time fixture preview\n * images. Curated `manifest.previewImage` wins over it; without either, tiles\n * render an icon+name placeholder.\n */\nexport type { GeneratedPreviewLookup } from './components/builder/blocks-model'\n/**\n * Reusable elements (EC-467): the OPTIONAL one-line declaration of which component\n * is the project's reuse embed — `defineStudio({ reuse: { component: 'project.Reusable' } })`.\n * Absence means INFER (the zero-config default), not off. Reusable elements are\n * singular per project: one embed component, one reusable collection.\n */\nexport type { StudioReuseConfig } from './components/builder/reuse'\n/**\n * The EC-440 previews-manifest adapter: `elytra previews` writes\n * `studio/elytra-previews.json` + images under `public/elytra-previews/`; the\n * consumer wires the seam in two lines —\n * `import previewsManifest from './elytra-previews.json'` and\n * `previews: { generated: generatedPreviewsFromManifest(previewsManifest) }`.\n */\nexport { generatedPreviewsFromManifest } from './previews/manifest-format'\nexport type {\n  GeneratedPreviewsManifest,\n  GeneratedPreviewsManifestEntry,\n} from './previews/manifest-format'\nexport { nav } from './components/app-views/default-modules'\nexport type {\n  CmsViewConfig,\n  BuiltinViewConfig,\n  CustomViewConfig,\n} from './components/app-views/default-modules'\nexport type { AppViewContext, AppViewModule, SidebarNode } from './components/app-views/module'\nexport { createStudio } from './lib/workspace'\n/** A ready-made example renderer; a consuming repo may use it or author its own. */\nexport { colorFieldRenderer } from './components/cms/field-renderer'\n/**\n * Studio-UI localization (EC-241): author a translation catalog for `defineStudio({\n * i18n })`. `msg` is only needed to build an in-repo *source* catalog with translator\n * hints; a plain `MessageCatalog` (flat key → string) is all a consumer supplies.\n * Prefer `TranslationCatalog` (EC-398) when authoring: it is typed against the EN key\n * set, so unknown/stale keys fail typecheck — engine-shipped locales\n * (`@elytracms/studio/locales/de`) and spread-overrides of them use it.\n */\nexport { msg } from './lib/i18n'\nexport type {\n  MessageCatalog,\n  MessageKey,\n  SourceMessage,\n  StudioI18nConfig,\n  TranslationCatalog,\n} from './lib/i18n'\n"]}

package/dist/lib/data/collection-content.d.ts

@@ -35,7 +35,12 @@ export interface ContentSessionState {
      * fixtures / tests) → the rows' own `state` gates the perspective, unchanged.
      */
     publishedKeys?: readonly string[];
-    /** Locale config of the session content; defaults to the sample config. */
+    /**
+     * Locale config of the session content — the project's own, composed by
+     * `contentSessionOf` from `elytra.config.ts`. Absent (a kit session, tests) →
+     * the ambient studio config, then the single locale being asked for; EC-479
+     * retired the engine's `sampleLocaleConfig` fallback here.
+     */
     localeConfig?: LocaleConfig;
     /**
      * The project's config-sourced routes (EC-207). Wired into the content client so

package/dist/lib/data/collection-content.js

@@ -1,6 +1,6 @@
 import { createContentClient, createContentContext, queryError, validateLimit, validateSort, validateWhere, } from '@elytracms/core/content';
-import { documentKey, resolveDocumentTitle, sampleLocaleConfig } from '@elytracms/core/cms-core';
-import { getStudioLocale } from '../locale/locale-store.js';
+import { documentKey, resolveDocumentTitle } from '@elytracms/core/cms-core';
+import { getStudioLocale, getStudioLocaleConfig } from '../locale/locale-store.js';
 /**
  * Default (no-session) collection schema: EMPTY. The studio ships no demo content
  * (Oli, 2026-06-19) — with no backend/content session configured, there is nothing
@@ -12,7 +12,8 @@ import { getStudioLocale } from '../locale/locale-store.js';
 export const playgroundCollections = [];
 let contentSession = null;
 let lookup = createLookup(playgroundCollections, [], []);
-// Keyed by `${locale}:${perspective}` (EC-300) — one deterministic client per pair.
+// Keyed by locale + perspective (EC-300) + the resolved locale CONFIG (EC-479) —
+// one deterministic client per distinct resolution context. See `clientFor`.
 const clients = new Map();
 // EC-460: a monotonically increasing session epoch + listener set, so a REACT
 // surface (the canvas render context) can re-render when the session is
@@ -57,8 +58,40 @@ export function hasContentSession() {
 function activeCollections() {
     return contentSession?.collections ?? playgroundCollections;
 }
-function activeLocaleConfig() {
-    return contentSession?.localeConfig ?? sampleLocaleConfig;
+/**
+ * The sentinel {@link previewLocale} yields when NOTHING has declared a locale —
+ * no ambient studio config, no content session. It is not a locale code and
+ * matches no stored key, which is the point: with no session the lookup is empty
+ * (`playgroundCollections` is `[]`), so every query already resolves to nothing
+ * and this only fills `CacheTags.locale`, which no studio surface reads. EC-479:
+ * the engine used to answer this question with its `sampleLocaleConfig` fixture's
+ * `en` — a locale nobody chose, standing in for the project's own.
+ */
+const NO_LOCALE = '';
+/**
+ * The locale a canvas preview resolves in, when the caller names none: the
+ * ambient studio locale (installed from the PROJECT's config by `CmsProvider`),
+ * else the active content session's own declared default (surfaces that render
+ * outside a CMS session — the Components view's previews — still resolve in the
+ * project's locale), else {@link NO_LOCALE}. Never an engine fixture.
+ */
+function previewLocale() {
+    return getStudioLocale() ?? contentSession?.localeConfig?.default ?? NO_LOCALE;
+}
+/**
+ * The locale set a preview resolves fallbacks against (EC-018): the session's own
+ * declaration, else the ambient studio config (the project's, via `elytra.config.ts`),
+ * else the single locale actually being asked for.
+ *
+ * That last step is a DERIVATION, not an invention — it says "the only locale we
+ * know of is the one you named", so `documentDefaultLocale` falls back to the
+ * document's own `defaultLocale` and then to `doc.values`. Before EC-479 this line
+ * read `?? sampleLocaleConfig`, which silently declared every locale-less studio
+ * bilingual `en/de` and resolved fallbacks through an `en` no project had chosen.
+ */
+function activeLocaleConfig(locale) {
+    return (contentSession?.localeConfig ??
+        getStudioLocaleConfig() ?? { default: locale, locales: [locale] });
 }
 /** Resolve a collection in the active content session (fixtures in playground). */
 export function playgroundCollection(id) {
@@ -155,7 +188,12 @@ function createLookup(collectionDefs, documents, publishedKeys, assetRecords) {
  * session changes.
  */
 function clientFor(locale, perspective = 'published') {
-    const key = `${locale}:${perspective}`;
+    const locales = activeLocaleConfig(locale);
+    // EC-479: the locale CONFIG is part of the client's identity now — it may come
+    // from the ambient studio store, which changes independently of the session the
+    // cache is cleared on, so keying by locale alone could serve a client built
+    // against a superseded locale set.
+    const key = `${locale}:${perspective}:${locales.default}|${locales.locales.join(',')}`;
     const existing = clients.get(key);
     if (existing)
         return existing;
@@ -164,7 +202,7 @@ function clientFor(locale, perspective = 'published') {
         context: createContentContext({
             locale,
             perspective,
-            locales: activeLocaleConfig(),
+            locales,
         }),
         // EC-291: the routes a rich-text link resolves against (config-sourced) — the
         // studio-live half of the host link bake.
@@ -179,11 +217,11 @@ function clientFor(locale, perspective = 'published') {
  * queries come back as structured errors — never thrown, never silently
  * widened. Resolves in the studio's active locale unless one is passed.
  */
-export function runCollectionListQuery(collectionId, query = {}, locale = getStudioLocale()) {
+export function runCollectionListQuery(collectionId, query = {}, locale = previewLocale()) {
     return clientFor(locale).listDocuments(collectionId, query);
 }
 /** Resolve one document (by id or slug) into delivery shape. */
-export function getCollectionDocument(collectionId, idOrSlug, locale = getStudioLocale()) {
+export function getCollectionDocument(collectionId, idOrSlug, locale = previewLocale()) {
     return clientFor(locale).getDocument(collectionId, idOrSlug);
 }
 /**
@@ -194,7 +232,7 @@ export function getCollectionDocument(collectionId, idOrSlug, locale = getStudio
  * Reusable's element) exactly as delivery renders them. `null` when the target is
  * missing or not visible → the block degrades to its own empty state.
  */
-export function resolveCanvasRelation(ref, locale = getStudioLocale(), perspective = 'published') {
+export function resolveCanvasRelation(ref, locale = previewLocale(), perspective = 'published') {
     return clientFor(locale, perspective).resolveRelation(ref);
 }
 /**
@@ -206,7 +244,7 @@ export function resolveCanvasRelation(ref, locale = getStudioLocale(), perspecti
  * (structured, never thrown) or a non-list lookup yields `[]` → the block's empty
  * state. Reuses the same `listDocuments` path as `runCollectionListQuery`.
  */
-export function resolveCanvasListing(query, locale = getStudioLocale(), perspective = 'published') {
+export function resolveCanvasListing(query, locale = previewLocale(), perspective = 'published') {
     const result = clientFor(locale, perspective).listDocuments(query.collection, {
         where: query.where,
         ...(query.sort ? { sort: query.sort } : {}),
@@ -250,7 +288,7 @@ export function validateCanvasListingQuery(query) {
  * no route → the rich-text renderer shows the EC-290 `unresolved-ref` issue. Reuses
  * the same `resolveLink` path as the host bake, so both agree on the derived URL.
  */
-export function resolveCanvasLink(ref, locale = getStudioLocale(), perspective = 'published') {
+export function resolveCanvasLink(ref, locale = previewLocale(), perspective = 'published') {
     return clientFor(locale, perspective).resolveLink(ref);
 }
 /** Published entries of a collection, labeled by the schema's title field. */