@elytracms/studio 0.0.92 → 0.0.94

package/dist/components/records/record-rail.d.ts

@@ -0,0 +1,86 @@
+import type { ReactNode } from 'react';
+import type { CollectionDef } from '@elytracms/core/cms-core';
+import type { AnyRecordKind, RecordEntryOf, RecordWriteOf } from '@elytracms/core/persistence';
+import type { CollectionViewCapabilities, CollectionViewSource } from '../../lib/collection-view/collection-view-source.js';
+/** The default capability profile of a record rail: create, edit, remove, bulk delete — content, not administration. */
+export declare const RECORD_RAIL_CAPABILITIES: CollectionViewCapabilities;
+/** The one query key of a kind's records in a project. */
+export declare function recordListKey(kind: AnyRecordKind, projectId: string): readonly [string, string, string];
+/**
+ * A kind's records in a project, read through the shared operations cache — the ONE query
+ * a rail and any reader outside it (the rail foot's URL-map validation reads redirects)
+ * share. One key, one cache entry: a save's `cache.patch` updates both at once.
+ */
+export declare function useRecordList<K extends AnyRecordKind>(kind: K, projectId: string): import("@tanstack/react-query").UseQueryResult<RecordEntryOf<K>[]>;
+export interface RecordRailStore<K extends AnyRecordKind = AnyRecordKind> {
+    kind: K;
+    projectId: string;
+    status: 'loading' | 'ready' | 'error';
+    errorMessage?: string;
+    /** The persisted records, in the kind's order. Unsaved drafts are excluded. */
+    records: readonly RecordEntryOf<K>[];
+    /** One record: a local unsaved draft if present, else a persisted record. */
+    get(id: string): RecordEntryOf<K> | undefined;
+    /** Mint a blank in-memory draft and return its id (the "New" navigation target). */
+    createDraft(): string;
+    /** Persist a create/modify; drops the matching draft on success. */
+    save(input: RecordWriteOf<K>): Promise<{
+        ok: true;
+        record: RecordEntryOf<K>;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Delete a persisted record, or silently discard an unsaved draft. */
+    remove(id: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Re-list from the backend. */
+    refresh(): Promise<void>;
+}
+/** The record rail store of the nearest {@link RecordRailProvider}. */
+export declare function useRecordRail<K extends AnyRecordKind>(): RecordRailStore<K>;
+export declare function RecordRailProvider<K extends AnyRecordKind>({ kind, projectId, children, }: {
+    kind: K;
+    projectId: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * The columns a blank "New" draft shows: each column's CREATE default (a new redirect
+ * reads enabled + permanent — the reason you create one is for it to work), and `''` for
+ * a required text column. The save then sends what the editor saw; the adapter still
+ * applies the defaults itself for a write that leaves them out (EC-577).
+ */
+export declare function recordDraftColumns(kind: AnyRecordKind): Record<string, unknown>;
+/** How a rail addresses its list and one record's detail (the view's own route segment). */
+export interface RecordRailPaths {
+    listPath: string;
+    detailPath(id: string): string;
+}
+/**
+ * The {@link CollectionViewSource} of a record rail (must be mounted under its
+ * {@link RecordRailProvider}). `schema` is the rail's lens — the kind's default lens or a
+ * mount-customized one (EC-311 overrides by name; additive fields persist in `meta`).
+ */
+export declare function useRecordCollectionViewSource<K extends AnyRecordKind>(kind: K, projectId: string, schema: CollectionDef, paths: RecordRailPaths, capabilities?: CollectionViewCapabilities): CollectionViewSource;
+export interface RecordRailModuleProps<K extends AnyRecordKind> {
+    kind: K;
+    projectId: string;
+    /** `null` → the list; an id → that record's detail. */
+    recordId: string | null;
+    schema: CollectionDef;
+    paths: RecordRailPaths;
+    capabilities?: CollectionViewCapabilities;
+    /** The rail's label, for its loading / failure states. */
+    label: string;
+    /** Optional copy for the loading / failure states (default: the generic catalog keys). */
+    messages?: {
+        loading?: () => string;
+        loadFailed?: () => string;
+    };
+}
+/** The surface of a record rail: the portable list, or one record's detail. */
+export declare function RecordRailModule<K extends AnyRecordKind>(props: RecordRailModuleProps<K>): import("react").JSX.Element;

package/dist/components/records/record-rail.js

@@ -0,0 +1,241 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef, useState } from 'react';
+import { createCollectionRegistry, parseLocaleConfig, validateDocument } from '@elytracms/core/cms-core';
+import { createUuidIdFactory } from '@elytracms/core/determinism';
+import { getStudioOperations } from '../../lib/operations/index.js';
+import { listStoreState, useOperationCache, useOperationQuery } from '../../lib/query/index.js';
+import { createRequiredContext } from '../../lib/required-context.js';
+import { localizedLabel, translate } from '../../lib/i18n/index.js';
+import { normalizeOkResult, useRailViewSource } from '../rail-view-source.js';
+import { RailStoreStatus } from '../rail-store-status.js';
+import { CollectionViewSurface } from '../collection-view/collection-view-surface.js';
+import { lensDocumentToRecordWrite, recordToLensDocument } from './record-lens.js';
+/**
+ * EC-616 — the generic RECORD RAIL: a record kind (`defineRecordKind`) on the portable
+ * list/edit surfaces (AD-19), read and written through the operations chokepoint
+ * (`operations.records(kind)`) and the one query cache (AD-17). A rail is `nav.rail(kind)`;
+ * the engine's redirects rail is exactly this over `redirectRecordKind`.
+ *
+ * - **Store** ({@link RecordRailProvider}): the kind's records through ONE query key per
+ *   kind and project ({@link useRecordList} — the rail foot and the rail share it); the
+ *   "New" flow keeps an unsaved record as a LOCAL draft until the first explicit save, so
+ *   an abandoned "New" never writes a stub and never shows in the list.
+ * - **Source** ({@link useRecordCollectionViewSource}): the lens projections
+ *   (`record-lens.ts`), the lens's own validation, the rail's capabilities.
+ * - **Surface** ({@link RecordRailModule}): the list, or one record's detail.
+ */
+/** A record rail is not localized — one implicit locale keeps the lens honest. */
+const RAIL_LOCALE = 'en';
+const RAIL_LOCALE_CONFIG = parseLocaleConfig({ default: RAIL_LOCALE, locales: [RAIL_LOCALE] });
+/** The default capability profile of a record rail: create, edit, remove, bulk delete — content, not administration. */
+export const RECORD_RAIL_CAPABILITIES = {
+    publish: false,
+    versions: false,
+    locales: false,
+    inlineEdit: false,
+    create: true,
+    duplicate: false,
+    remove: true,
+    bulk: true,
+    liveUrl: false,
+    hierarchy: false,
+    importExport: false,
+    adminOnly: false,
+};
+/** The one query key of a kind's records in a project. */
+export function recordListKey(kind, projectId) {
+    return ['records', kind.kind, projectId];
+}
+/**
+ * A kind's records in a project, read through the shared operations cache — the ONE query
+ * a rail and any reader outside it (the rail foot's URL-map validation reads redirects)
+ * share. One key, one cache entry: a save's `cache.patch` updates both at once.
+ */
+export function useRecordList(kind, projectId) {
+    return useOperationQuery({
+        queryKey: recordListKey(kind, projectId),
+        loader: async (operations) => {
+            const result = await operations.records(kind).list({ projectId });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            return [...result.value];
+        },
+    });
+}
+const { Context: RecordRailContext, useRequired: useRecordRailContext } = createRequiredContext('RecordRail', { article: 'a' });
+/** The record rail store of the nearest {@link RecordRailProvider}. */
+export function useRecordRail() {
+    return useRecordRailContext();
+}
+let mintDraftUuid;
+export function RecordRailProvider({ kind, projectId, children, }) {
+    const query = useRecordList(kind, projectId);
+    const cache = useOperationCache();
+    const persisted = query.data ?? EMPTY;
+    const { status, errorMessage } = listStoreState(query);
+    // In-memory unsaved "New" drafts, keyed by id. Not listed; only get()-able.
+    const [drafts, setDrafts] = useState({});
+    const draftsRef = useRef(drafts);
+    draftsRef.current = drafts;
+    const refetch = query.refetch;
+    const refresh = useCallback(async () => {
+        await refetch();
+    }, [refetch]);
+    const get = useCallback((id) => drafts[id] ?? persisted.find((record) => record.id === id), [drafts, persisted]);
+    const createDraft = useCallback(() => {
+        // The draft id becomes the record's real id on its first save: the production id
+        // factory (EC-578 — never a clock or a per-session counter, which collide).
+        mintDraftUuid ??= createUuidIdFactory();
+        const id = `${kind.idPrefix}_${mintDraftUuid()}`;
+        const now = new Date().toISOString();
+        const draft = { ...recordDraftColumns(kind), id, projectId, createdAt: now, updatedAt: now };
+        setDrafts((prev) => ({ ...prev, [id]: draft }));
+        return id;
+    }, [kind, projectId]);
+    const save = useCallback(async (input) => {
+        const { operations } = await getStudioOperations();
+        const result = await operations.records(kind).save({ projectId, ...input });
+        if (!result.ok)
+            return { ok: false, message: result.error.message };
+        const saved = result.value;
+        const savedId = saved.id;
+        // The server returns the kind's order on the next read; place the save now and
+        // let the patched list keep its order key (re-read on the next fetch).
+        cache.patch(recordListKey(kind, projectId), (prev) => {
+            const rest = (prev ?? []).filter((record) => record.id !== savedId);
+            return sortForRail(kind, [...rest, saved]);
+        });
+        setDrafts((prev) => {
+            if (!(savedId in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[savedId];
+            return next;
+        });
+        return { ok: true, record: saved };
+    }, [kind, projectId, cache]);
+    const remove = useCallback(async (id) => {
+        // An unsaved draft was never persisted — discard it locally, no backend call.
+        if (draftsRef.current[id]) {
+            setDrafts((prev) => {
+                const next = { ...prev };
+                delete next[id];
+                return next;
+            });
+            return { ok: true };
+        }
+        const { operations } = await getStudioOperations();
+        const result = await operations.records(kind).remove({ projectId, id });
+        if (!result.ok)
+            return { ok: false, message: result.error.message };
+        cache.patch(recordListKey(kind, projectId), (prev) => (prev ?? []).filter((record) => record.id !== id));
+        return { ok: true };
+    }, [kind, projectId, cache]);
+    const store = useMemo(() => ({
+        kind,
+        projectId,
+        status,
+        ...(errorMessage !== undefined ? { errorMessage } : {}),
+        records: persisted,
+        get,
+        createDraft,
+        save,
+        remove,
+        refresh,
+    }), [kind, projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh]);
+    return _jsx(RecordRailContext.Provider, { value: store, children: children });
+}
+const EMPTY = [];
+/**
+ * The columns a blank "New" draft shows: each column's CREATE default (a new redirect
+ * reads enabled + permanent — the reason you create one is for it to work), and `''` for
+ * a required text column. The save then sends what the editor saw; the adapter still
+ * applies the defaults itself for a write that leaves them out (EC-577).
+ */
+export function recordDraftColumns(kind) {
+    const columns = {};
+    for (const [name, field] of Object.entries(kind.fields)) {
+        const parsed = field.safeParse(undefined);
+        if (parsed.success && parsed.data !== undefined)
+            columns[name] = parsed.data;
+        else if (field._zod.def.type === 'string')
+            columns[name] = '';
+    }
+    return columns;
+}
+/** The kind's own list order for a locally patched list (`orderBy`, else creation time). */
+function sortForRail(kind, records) {
+    const column = kind.orderBy ?? 'createdAt';
+    return [...records].sort((a, b) => {
+        const left = String(a[column] ?? '');
+        const right = String(b[column] ?? '');
+        return left < right ? -1 : left > right ? 1 : 0;
+    });
+}
+/**
+ * The {@link CollectionViewSource} of a record rail (must be mounted under its
+ * {@link RecordRailProvider}). `schema` is the rail's lens — the kind's default lens or a
+ * mount-customized one (EC-311 overrides by name; additive fields persist in `meta`).
+ */
+export function useRecordCollectionViewSource(kind, projectId, schema, paths, capabilities = RECORD_RAIL_CAPABILITIES) {
+    const store = useRecordRail();
+    // Run the (possibly customized) lens's validation — required/pattern and custom
+    // `validate` fns on an overridden field must actually fire in the editor (EC-311).
+    const registry = useMemo(() => createCollectionRegistry([schema]), [schema]);
+    const singular = schema.form?.labelSingular;
+    const titleField = typeof schema.titleField === 'string' ? schema.titleField : undefined;
+    const documents = useCallback(() => store.records.map((record) => recordToLensDocument(kind, record)), [kind, store.records]);
+    const get = useCallback((ref) => {
+        const record = store.get(ref.id);
+        return record ? recordToLensDocument(kind, record) : undefined;
+    }, [kind, store]);
+    const titleOf = useCallback((ref) => {
+        const record = store.get(ref.id);
+        const title = titleField ? record?.[titleField] : undefined;
+        if (typeof title === 'string' && title.length > 0)
+            return title;
+        return translate('records.untitled', { label: localizedLabel(singular) ?? kind.kind });
+    }, [store, titleField, singular, kind]);
+    const validate = useCallback((doc) => validateDocument(registry, doc, { localeConfig: RAIL_LOCALE_CONFIG }), [registry]);
+    const create = useCallback(() => ({ collection: kind.kind, id: store.createDraft() }), [kind, store]);
+    // EC-616 (multi-session): an edit of a STORED record writes only what the editor changed
+    // against the record they opened (`base`, from the edit shell) — the EC-577 rule keeps every
+    // other column, so another writer's change made meanwhile survives this save. A record the
+    // editor is creating (an unsaved draft) is written whole.
+    const save = useCallback((doc, base) => {
+        const stored = store.records.some((record) => record.id === doc.id);
+        return store.save(lensDocumentToRecordWrite(kind, doc, stored ? base : undefined));
+    }, [kind, store]);
+    const remove = useCallback((ref) => store.remove(ref.id), [store]);
+    return useRailViewSource({
+        projectId,
+        schema,
+        capabilities,
+        localeConfig: RAIL_LOCALE_CONFIG,
+        documents,
+        get,
+        titleOf,
+        detailPath: paths.detailPath,
+        listPath: paths.listPath,
+        validate,
+        create,
+        save,
+        remove,
+        normalizeSaveResult: normalizeOkResult,
+        normalizeRemoveResult: normalizeOkResult,
+    });
+}
+/** The surface of a record rail: the portable list, or one record's detail. */
+export function RecordRailModule(props) {
+    return (_jsx(RecordRailProvider, { kind: props.kind, projectId: props.projectId, children: _jsx(RecordRailSurface, { ...props }) }));
+}
+function RecordRailSurface({ kind, projectId, recordId, schema, paths, capabilities, label, messages, }) {
+    const store = useRecordRail();
+    const source = useRecordCollectionViewSource(kind, projectId, schema, paths, capabilities);
+    if (store.status !== 'ready') {
+        return (_jsx(RailStoreStatus, { store: store, errorLabel: messages?.loadFailed?.() ?? translate('records.loadFailed', { label }), loadingLabel: messages?.loading?.() ?? translate('records.loading', { label }), errorTestId: `${kind.kind}-rail-error` }));
+    }
+    // One record's detail opens in the portable edit shell (AD-19); the list otherwise.
+    return _jsx(CollectionViewSurface, { source: source, projectId: projectId, documentId: recordId });
+}
+//# sourceMappingURL=record-rail.js.map

package/dist/components/records/record-rail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-rail.js","sourceRoot":"","sources":["../../../src/components/records/record-rail.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { createCollectionRegistry, parseLocaleConfig, validateDocument } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig } from '@elytracms/core/cms-core'\nimport type { AnyRecordKind, RecordEntryOf, RecordWriteOf } from '@elytracms/core/persistence'\nimport { createUuidIdFactory } from '@elytracms/core/determinism'\nimport { getStudioOperations } from '../../lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '../../lib/query'\nimport { createRequiredContext } from '../../lib/required-context'\nimport { localizedLabel, translate } from '../../lib/i18n'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n} from '../../lib/collection-view/collection-view-source'\nimport { normalizeOkResult, useRailViewSource } from '../rail-view-source'\nimport { RailStoreStatus } from '../rail-store-status'\nimport { CollectionViewSurface } from '../collection-view/collection-view-surface'\nimport { lensDocumentToRecordWrite, recordToLensDocument } from './record-lens'\n\n/**\n * EC-616 — the generic RECORD RAIL: a record kind (`defineRecordKind`) on the portable\n * list/edit surfaces (AD-19), read and written through the operations chokepoint\n * (`operations.records(kind)`) and the one query cache (AD-17). A rail is `nav.rail(kind)`;\n * the engine's redirects rail is exactly this over `redirectRecordKind`.\n *\n * - **Store** ({@link RecordRailProvider}): the kind's records through ONE query key per\n *   kind and project ({@link useRecordList} — the rail foot and the rail share it); the\n *   \"New\" flow keeps an unsaved record as a LOCAL draft until the first explicit save, so\n *   an abandoned \"New\" never writes a stub and never shows in the list.\n * - **Source** ({@link useRecordCollectionViewSource}): the lens projections\n *   (`record-lens.ts`), the lens's own validation, the rail's capabilities.\n * - **Surface** ({@link RecordRailModule}): the list, or one record's detail.\n */\n\n/** A record rail is not localized — one implicit locale keeps the lens honest. */\nconst RAIL_LOCALE: Locale = 'en'\nconst RAIL_LOCALE_CONFIG: LocaleConfig = parseLocaleConfig({ default: RAIL_LOCALE, locales: [RAIL_LOCALE] })\n\n/** The default capability profile of a record rail: create, edit, remove, bulk delete — content, not administration. */\nexport const RECORD_RAIL_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: true,\n  duplicate: false,\n  remove: true,\n  bulk: true,\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false,\n  adminOnly: false,\n}\n\n/** The one query key of a kind's records in a project. */\nexport function recordListKey(kind: AnyRecordKind, projectId: string): readonly [string, string, string] {\n  return ['records', kind.kind, projectId]\n}\n\n/**\n * A kind's records in a project, read through the shared operations cache — the ONE query\n * a rail and any reader outside it (the rail foot's URL-map validation reads redirects)\n * share. One key, one cache entry: a save's `cache.patch` updates both at once.\n */\nexport function useRecordList<K extends AnyRecordKind>(kind: K, projectId: string) {\n  return useOperationQuery<RecordEntryOf<K>[]>({\n    queryKey: recordListKey(kind, projectId),\n    loader: async (operations) => {\n      const result = await operations.records(kind).list({ projectId })\n      if (!result.ok) throw new Error(result.error.message)\n      return [...result.value]\n    },\n  })\n}\n\nexport interface RecordRailStore<K extends AnyRecordKind = AnyRecordKind> {\n  kind: K\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted records, in the kind's order. Unsaved drafts are excluded. */\n  records: readonly RecordEntryOf<K>[]\n  /** One record: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RecordEntryOf<K> | 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(input: RecordWriteOf<K>): Promise<{ ok: true; record: RecordEntryOf<K> } | { ok: false; message: string }>\n  /** Delete a persisted record, 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: RecordRailContext, useRequired: useRecordRailContext } =\n  createRequiredContext<RecordRailStore>('RecordRail', { article: 'a' })\n\n/** The record rail store of the nearest {@link RecordRailProvider}. */\nexport function useRecordRail<K extends AnyRecordKind>(): RecordRailStore<K> {\n  return useRecordRailContext() as unknown as RecordRailStore<K>\n}\n\nlet mintDraftUuid: (() => string) | undefined\n\nexport function RecordRailProvider<K extends AnyRecordKind>({\n  kind,\n  projectId,\n  children,\n}: {\n  kind: K\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useRecordList(kind, projectId)\n  const cache = useOperationCache()\n  const persisted = query.data ?? EMPTY\n  const { status, errorMessage } = listStoreState(query)\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RecordEntryOf<K>>>({})\n  const draftsRef = useRef(drafts)\n  draftsRef.current = drafts\n\n  const refetch = query.refetch\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback(\n    (id: string) =>\n      drafts[id] ?? (persisted as RecordEntryOf<K>[]).find((record) => (record as { id: string }).id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback(() => {\n    // The draft id becomes the record's real id on its first save: the production id\n    // factory (EC-578 — never a clock or a per-session counter, which collide).\n    mintDraftUuid ??= createUuidIdFactory()\n    const id = `${kind.idPrefix}_${mintDraftUuid()}`\n    const now = new Date().toISOString()\n    const draft = { ...recordDraftColumns(kind), id, projectId, createdAt: now, updatedAt: now } as unknown as RecordEntryOf<K>\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [kind, projectId])\n\n  const save = useCallback<RecordRailStore<K>['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.records(kind).save({ projectId, ...input } as never)\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value as RecordEntryOf<K>\n      const savedId = (saved as { id: string }).id\n      // The server returns the kind's order on the next read; place the save now and\n      // let the patched list keep its order key (re-read on the next fetch).\n      cache.patch<RecordEntryOf<K>[]>(recordListKey(kind, projectId), (prev) => {\n        const rest = (prev ?? []).filter((record) => (record as { id: string }).id !== savedId)\n        return sortForRail(kind, [...rest, saved])\n      })\n      setDrafts((prev) => {\n        if (!(savedId in prev)) return prev\n        const next = { ...prev }\n        delete next[savedId]\n        return next\n      })\n      return { ok: true, record: saved }\n    },\n    [kind, projectId, cache],\n  )\n\n  const remove = useCallback<RecordRailStore<K>['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (draftsRef.current[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.records(kind).remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RecordEntryOf<K>[]>(recordListKey(kind, projectId), (prev) =>\n        (prev ?? []).filter((record) => record.id !== id),\n      )\n      return { ok: true }\n    },\n    [kind, projectId, cache],\n  )\n\n  const store = useMemo<RecordRailStore<K>>(\n    () => ({\n      kind,\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      records: persisted as RecordEntryOf<K>[],\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [kind, projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RecordRailContext.Provider value={store as unknown as RecordRailStore}>{children}</RecordRailContext.Provider>\n}\n\nconst EMPTY: readonly never[] = []\n\n/**\n * The columns a blank \"New\" draft shows: each column's CREATE default (a new redirect\n * reads enabled + permanent — the reason you create one is for it to work), and `''` for\n * a required text column. The save then sends what the editor saw; the adapter still\n * applies the defaults itself for a write that leaves them out (EC-577).\n */\nexport function recordDraftColumns(kind: AnyRecordKind): Record<string, unknown> {\n  const columns: Record<string, unknown> = {}\n  for (const [name, field] of Object.entries(kind.fields)) {\n    const parsed = (field as { safeParse(value: unknown): { success: boolean; data?: unknown } }).safeParse(undefined)\n    if (parsed.success && parsed.data !== undefined) columns[name] = parsed.data\n    else if ((field as { _zod: { def: { type: string } } })._zod.def.type === 'string') columns[name] = ''\n  }\n  return columns\n}\n\n/** The kind's own list order for a locally patched list (`orderBy`, else creation time). */\nfunction sortForRail<R>(kind: AnyRecordKind, records: R[]): R[] {\n  const column = kind.orderBy ?? 'createdAt'\n  return [...records].sort((a, b) => {\n    const left = String((a as Record<string, unknown>)[column] ?? '')\n    const right = String((b as Record<string, unknown>)[column] ?? '')\n    return left < right ? -1 : left > right ? 1 : 0\n  })\n}\n\n/** How a rail addresses its list and one record's detail (the view's own route segment). */\nexport interface RecordRailPaths {\n  listPath: string\n  detailPath(id: string): string\n}\n\n/**\n * The {@link CollectionViewSource} of a record rail (must be mounted under its\n * {@link RecordRailProvider}). `schema` is the rail's lens — the kind's default lens or a\n * mount-customized one (EC-311 overrides by name; additive fields persist in `meta`).\n */\nexport function useRecordCollectionViewSource<K extends AnyRecordKind>(\n  kind: K,\n  projectId: string,\n  schema: CollectionDef,\n  paths: RecordRailPaths,\n  capabilities: CollectionViewCapabilities = RECORD_RAIL_CAPABILITIES,\n): CollectionViewSource {\n  const store = useRecordRail<K>()\n  // Run the (possibly customized) lens's validation — required/pattern and custom\n  // `validate` fns on an overridden field must actually fire in the editor (EC-311).\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n  const singular = schema.form?.labelSingular\n  const titleField = typeof schema.titleField === 'string' ? schema.titleField : undefined\n\n  const documents = useCallback(\n    () => store.records.map((record) => recordToLensDocument(kind, record)),\n    [kind, store.records],\n  )\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.get(ref.id)\n      return record ? recordToLensDocument(kind, record) : undefined\n    },\n    [kind, store],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => {\n      const record = store.get(ref.id) as Record<string, unknown> | undefined\n      const title = titleField ? record?.[titleField] : undefined\n      if (typeof title === 'string' && title.length > 0) return title\n      return translate('records.untitled', { label: localizedLabel(singular) ?? kind.kind })\n    },\n    [store, titleField, singular, kind],\n  )\n  const validate = useCallback(\n    (doc: CmsDocument) => validateDocument(registry, doc, { localeConfig: RAIL_LOCALE_CONFIG }),\n    [registry],\n  )\n  const create = useCallback((): DocumentRef => ({ collection: kind.kind, id: store.createDraft() }), [kind, store])\n  // EC-616 (multi-session): an edit of a STORED record writes only what the editor changed\n  // against the record they opened (`base`, from the edit shell) — the EC-577 rule keeps every\n  // other column, so another writer's change made meanwhile survives this save. A record the\n  // editor is creating (an unsaved draft) is written whole.\n  const save = useCallback(\n    (doc: CmsDocument, base?: CmsDocument) => {\n      const stored = store.records.some((record) => (record as { id: string }).id === doc.id)\n      return store.save(lensDocumentToRecordWrite(kind, doc, stored ? base : undefined))\n    },\n    [kind, store],\n  )\n  const remove = useCallback((ref: DocumentRef) => store.remove(ref.id), [store])\n\n  return useRailViewSource({\n    projectId,\n    schema,\n    capabilities,\n    localeConfig: RAIL_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    detailPath: paths.detailPath,\n    listPath: paths.listPath,\n    validate,\n    create,\n    save,\n    remove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeOkResult,\n  })\n}\n\nexport interface RecordRailModuleProps<K extends AnyRecordKind> {\n  kind: K\n  projectId: string\n  /** `null` → the list; an id → that record's detail. */\n  recordId: string | null\n  schema: CollectionDef\n  paths: RecordRailPaths\n  capabilities?: CollectionViewCapabilities\n  /** The rail's label, for its loading / failure states. */\n  label: string\n  /** Optional copy for the loading / failure states (default: the generic catalog keys). */\n  messages?: { loading?: () => string; loadFailed?: () => string }\n}\n\n/** The surface of a record rail: the portable list, or one record's detail. */\nexport function RecordRailModule<K extends AnyRecordKind>(props: RecordRailModuleProps<K>) {\n  return (\n    <RecordRailProvider kind={props.kind} projectId={props.projectId}>\n      <RecordRailSurface {...props} />\n    </RecordRailProvider>\n  )\n}\n\nfunction RecordRailSurface<K extends AnyRecordKind>({\n  kind,\n  projectId,\n  recordId,\n  schema,\n  paths,\n  capabilities,\n  label,\n  messages,\n}: RecordRailModuleProps<K>) {\n  const store = useRecordRail<K>()\n  const source = useRecordCollectionViewSource(kind, projectId, schema, paths, capabilities)\n\n  if (store.status !== 'ready') {\n    return (\n      <RailStoreStatus\n        store={store}\n        errorLabel={messages?.loadFailed?.() ?? translate('records.loadFailed', { label })}\n        loadingLabel={messages?.loading?.() ?? translate('records.loading', { label })}\n        errorTestId={`${kind.kind}-rail-error`}\n      />\n    )\n  }\n  // One record's detail opens in the portable edit shell (AD-19); the list otherwise.\n  return <CollectionViewSurface source={source} projectId={projectId} documentId={recordId} />\n}\n"]}

package/dist/components/redirects/redirects-schema.js

@@ -1,5 +1,5 @@
 import { collectionDefSchema } from '@elytracms/core/cms-core';
-import { msgLabel } from '@elytracms/studio/lib/i18n';
+import { msgLabel } from '../../lib/i18n/index.js';
 /**
  * The built-in **redirects** field lens (EC-303). Redirects are a separate
  * editorial rail — NOT a `cmsDocuments` collection — so this `CollectionDef`

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

@@ -1 +1 @@
-{"version":3,"file":"redirects-schema.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,mBAAmB,CAAC,KAAK,CAAC;IAC7E,EAAE,EAAE,UAAU;IACd,4EAA4E;IAC5E,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,MAAM;IAClB,qFAAqF;IACrF,mFAAmF;IACnF,yEAAyE;IACzE,2DAA2D;IAC3D,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,8BAA8B,CAAC,EAAE;IAC1G,MAAM,EAAE;QACN;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,6CAA6C,EAAE;SAC7G;QACD;YACE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,0BAA0B,CAAC,EAAE,IAAI,EAAE,8CAA8C,EAAE;SAC5G;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,iCAAiC,CAAC,EAAE,IAAI,EAAE,0CAA0C,EAAE;SAC/G;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EAAE,IAAI,EAAE,qDAAqD,EAAE;SACxH;KACF;CACF,CAAC,CAAA","sourcesContent":["import { collectionDefSchema } from '@elytracms/core/cms-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { msgLabel } from '@elytracms/studio/lib/i18n'\n\n/**\n * The built-in **redirects** field lens (EC-303). Redirects are a separate\n * editorial rail — NOT a `cmsDocuments` collection — so this `CollectionDef`\n * exists only to drive the portable list/edit surfaces over the redirects\n * {@link CollectionViewSource}. The rail's semantics (content-gated, no\n * publish/versions/locales, create + remove) come from the source's\n * capabilities, never the schema `kind`. The title identity is the `from` path.\n */\nexport const redirectsCollectionDef: CollectionDef = collectionDefSchema.parse({\n  id: 'redirect',\n  // Redirects aren't a CMS `kind`; 'document' just satisfies the lens schema.\n  kind: 'document',\n  titleField: 'from',\n  // EC-241: the built-in rail's labels resolve through the message catalog (msgLabel),\n  // so a consumer's translation catalog localizes them — no per-rail EC-311 override\n  // needed just to translate. EC-311 field overrides still win for genuine\n  // customization (renaming, readOnly, control, validation).\n  form: { label: msgLabel('redirects.rail.label'), labelSingular: msgLabel('redirects.rail.labelSingular') },\n  fields: [\n    {\n      name: 'from',\n      type: 'text',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.from.label'), help: 'The source path to forward, e.g. /old-page.' },\n    },\n    {\n      name: 'to',\n      type: 'text',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.to.label'), help: 'The destination path or URL, e.g. /new-page.' },\n    },\n    {\n      name: 'permanent',\n      type: 'boolean',\n      form: { label: msgLabel('redirects.field.permanent.label'), help: 'On → 301 permanent; off → 302 temporary.' },\n    },\n    {\n      name: 'enabled',\n      type: 'boolean',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.enabled.label'), help: 'Only enabled redirects are served on the live site.' },\n    },\n  ],\n})\n"]}
+{"version":3,"file":"redirects-schema.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,mBAAmB,CAAC,KAAK,CAAC;IAC7E,EAAE,EAAE,UAAU;IACd,4EAA4E;IAC5E,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,MAAM;IAClB,qFAAqF;IACrF,mFAAmF;IACnF,yEAAyE;IACzE,2DAA2D;IAC3D,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,8BAA8B,CAAC,EAAE;IAC1G,MAAM,EAAE;QACN;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,6CAA6C,EAAE;SAC7G;QACD;YACE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,0BAA0B,CAAC,EAAE,IAAI,EAAE,8CAA8C,EAAE;SAC5G;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,iCAAiC,CAAC,EAAE,IAAI,EAAE,0CAA0C,EAAE;SAC/G;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EAAE,IAAI,EAAE,qDAAqD,EAAE;SACxH;KACF;CACF,CAAC,CAAA","sourcesContent":["import { collectionDefSchema } from '@elytracms/core/cms-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { msgLabel } from '../../lib/i18n'\n\n/**\n * The built-in **redirects** field lens (EC-303). Redirects are a separate\n * editorial rail — NOT a `cmsDocuments` collection — so this `CollectionDef`\n * exists only to drive the portable list/edit surfaces over the redirects\n * {@link CollectionViewSource}. The rail's semantics (content-gated, no\n * publish/versions/locales, create + remove) come from the source's\n * capabilities, never the schema `kind`. The title identity is the `from` path.\n */\nexport const redirectsCollectionDef: CollectionDef = collectionDefSchema.parse({\n  id: 'redirect',\n  // Redirects aren't a CMS `kind`; 'document' just satisfies the lens schema.\n  kind: 'document',\n  titleField: 'from',\n  // EC-241: the built-in rail's labels resolve through the message catalog (msgLabel),\n  // so a consumer's translation catalog localizes them — no per-rail EC-311 override\n  // needed just to translate. EC-311 field overrides still win for genuine\n  // customization (renaming, readOnly, control, validation).\n  form: { label: msgLabel('redirects.rail.label'), labelSingular: msgLabel('redirects.rail.labelSingular') },\n  fields: [\n    {\n      name: 'from',\n      type: 'text',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.from.label'), help: 'The source path to forward, e.g. /old-page.' },\n    },\n    {\n      name: 'to',\n      type: 'text',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.to.label'), help: 'The destination path or URL, e.g. /new-page.' },\n    },\n    {\n      name: 'permanent',\n      type: 'boolean',\n      form: { label: msgLabel('redirects.field.permanent.label'), help: 'On → 301 permanent; off → 302 temporary.' },\n    },\n    {\n      name: 'enabled',\n      type: 'boolean',\n      filterable: true,\n      form: { label: msgLabel('redirects.field.enabled.label'), help: 'Only enabled redirects are served on the live site.' },\n    },\n  ],\n})\n"]}

package/dist/components/references/references-panel.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
 import { AlertTriangle, ArrowDownLeft, ArrowUpRight, Link2, RotateCcw } from 'lucide-react';
-import { useReferencePanel } from '@elytracms/studio/lib/references';
+import { useReferencePanel } from '../../lib/references/index.js';
 import { Badge, Button, Panel, PanelHeader, Row, RowItem, Spacer, Stack, Text } from '@elytracms/studio/ui';
-import { translate } from '@elytracms/studio/lib/i18n';
+import { translate } from '../../lib/i18n/index.js';
 /**
  * The shared "References / Used by" panel (EC-172) — one generic component,
  * three hosts (CMS document detail, asset library, component detail). Entries

package/dist/components/references/references-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"references-panel.js","sourceRoot":"","sources":["../../../src/components/references/references-panel.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { AlertTriangle, ArrowDownLeft, ArrowUpRight, Link2, RotateCcw } from 'lucide-react'\nimport type { ReactNode } from 'react'\nimport type { ReferenceSource, ReferenceTarget } from '@elytracms/core/persistence'\nimport { useReferencePanel } from '@elytracms/studio/lib/references'\nimport type { ReferenceDeepLink, ReferenceEntryView } from '@elytracms/studio/lib/references'\nimport { Badge, Button, Panel, PanelHeader, Row, RowItem, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * The shared \"References / Used by\" panel (EC-172) — one generic component,\n * three hosts (CMS document detail, asset library, component detail). Entries\n * are served entirely by `@elytracms/core/operations` reference queries over the\n * EC-155 index; every entry deep-links to the exact field control or graph\n * node its index path identifies, and draft-only entries are visibly\n * distinguished from published (live) ones.\n */\nexport function ReferencesPanel({\n  projectId,\n  source,\n  target,\n  className,\n}: {\n  projectId: string\n  /** The holding entity — enables the outbound \"References\" section. */\n  source?: ReferenceSource\n  /** The referenced entity — enables the inbound \"Used by\" section. */\n  target?: ReferenceTarget\n  className?: string\n}) {\n  const panel = useReferencePanel({ projectId, source, target })\n  const total =\n    panel.data === null ? null : panel.data.outbound.length + panel.data.inbound.length\n\n  return (\n    <Panel className={className} data-testid=\"references-panel\">\n      <PanelHeader>\n        <Link2 className=\"size-4 text-primary\" />\n        <Text size=\"sm\" weight=\"semibold\">\n          {translate('references.title')}\n        </Text>\n        {total !== null ? <Badge variant=\"outline\">{total}</Badge> : null}\n        <Spacer />\n      </PanelHeader>\n      <Stack gap=\"4\" className=\"p-4\">\n        {panel.status === 'loading' ? (\n          <ReferencesLoading />\n        ) : panel.status === 'error' ? (\n          <ReferencesError message={panel.errorMessage} onRetry={panel.refresh} />\n        ) : (\n          <>\n            {source ? (\n              <ReferenceSection\n                title={translate('references.title')}\n                icon={<ArrowUpRight className=\"size-3.5\" />}\n                hint={translate('references.hintOutbound')}\n                direction=\"outbound\"\n                projectId={projectId}\n                entries={panel.data?.outbound ?? []}\n                error={panel.data?.outboundError ?? null}\n                emptyLabel={translate('references.emptyOutbound')}\n              />\n            ) : null}\n            {target ? (\n              <ReferenceSection\n                title={translate('references.usedBy')}\n                icon={<ArrowDownLeft className=\"size-3.5\" />}\n                hint={translate('references.hintInbound')}\n                direction=\"inbound\"\n                projectId={projectId}\n                entries={panel.data?.inbound ?? []}\n                error={panel.data?.inboundError ?? null}\n                emptyLabel={translate('references.emptyInbound')}\n              />\n            ) : null}\n          </>\n        )}\n      </Stack>\n    </Panel>\n  )\n}\n\n/** Named loading state, consistent with existing studio panels. */\nfunction ReferencesLoading() {\n  return (\n    <Text size=\"sm\" tone=\"muted\" data-testid=\"references-loading\">\n      {translate('references.loading')}\n    </Text>\n  )\n}\n\n/** Named error state with retry — never a silent failure. */\nfunction ReferencesError({\n  message,\n  onRetry,\n}: {\n  message: string | null\n  onRetry: () => void\n}) {\n  return (\n    <Stack gap=\"2\" data-testid=\"references-error\">\n      <Row gap=\"2\">\n        <AlertTriangle className=\"size-4 text-destructive\" />\n        <Text size=\"sm\" weight=\"semibold\">\n          {translate('references.loadFailed')}\n        </Text>\n      </Row>\n      <Text size=\"xs\" tone=\"muted\">\n        {message ?? translate('references.indexUnreachable')}\n      </Text>\n      <Row>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry}>\n          <RotateCcw /> {translate('common.retry')}\n        </Button>\n      </Row>\n    </Stack>\n  )\n}\n\nfunction ReferenceSection({\n  title,\n  icon,\n  hint,\n  direction,\n  projectId,\n  entries,\n  error,\n  emptyLabel,\n}: {\n  title: string\n  icon: ReactNode\n  hint: string\n  direction: 'outbound' | 'inbound'\n  projectId: string\n  entries: readonly ReferenceEntryView[]\n  /** EC-205: this direction's read failed — shown inline, the panel stays usable. */\n  error?: string | null\n  emptyLabel: string\n}) {\n  return (\n    <Stack gap=\"2\" data-testid={`references-${direction}`}>\n      <Row gap=\"2\">\n        <span className=\"text-muted-foreground\">{icon}</span>\n        <Text size=\"xs\" weight=\"semibold\" tone=\"muted\" className=\"uppercase tracking-wide\">\n          {title}\n        </Text>\n        <Badge variant=\"outline\">{entries.length}</Badge>\n      </Row>\n      {error ? (\n        <Row gap=\"2\" data-testid={`references-${direction}-error`}>\n          <AlertTriangle className=\"size-3.5 shrink-0 text-destructive\" />\n          <Text size=\"xs\" tone=\"muted\">\n            {translate('references.sectionLoadError', { error })}\n          </Text>\n        </Row>\n      ) : entries.length === 0 ? (\n        <Text size=\"sm\" tone=\"muted\" data-testid={`references-${direction}-empty`}>\n          {emptyLabel}\n        </Text>\n      ) : (\n        <Stack gap=\"2\" title={hint}>\n          {entries.map((entry) => (\n            <ReferenceEntryRow\n              key={entry.key}\n              entry={entry}\n              direction={direction}\n              projectId={projectId}\n            />\n          ))}\n        </Stack>\n      )}\n    </Stack>\n  )\n}\n\n/**\n * One entry row. Inbound rows lead with the *source* (where it is used) and\n * deep-link to the exact location; outbound rows lead with the *target* and\n * keep the exact-field link on the location line.\n */\nfunction ReferenceEntryRow({\n  entry,\n  direction,\n  projectId,\n}: {\n  entry: ReferenceEntryView\n  direction: 'outbound' | 'inbound'\n  projectId: string\n}) {\n  const primary =\n    direction === 'inbound'\n      ? { label: entry.sourceLabel, link: entry.sourceLink }\n      : { label: entry.targetLabel, link: entry.targetLink }\n  return (\n    <RowItem\n      data-testid=\"reference-entry\"\n      actions={\n        <>\n          <Badge variant=\"outline\">{entry.kindLabel}</Badge>\n          <VariantBadges draft={entry.draft} published={entry.published} />\n        </>\n      }\n    >\n      <Stack gap=\"1\" className=\"min-w-0\">\n        <Row gap=\"2\" className=\"min-w-0\">\n          <DeepLinkText projectId={projectId} link={primary.link} label={primary.label} primary />\n        </Row>\n        <Row gap=\"1\" className=\"min-w-0\">\n          <Text size=\"xs\" tone=\"muted\" className=\"shrink-0\">\n            {translate('references.locationPrefix')}\n          </Text>\n          <DeepLinkText\n            projectId={projectId}\n            link={entry.sourceLink}\n            label={entry.locationLabel}\n          />\n        </Row>\n      </Stack>\n    </RowItem>\n  )\n}\n\n/** Draft/published visibility (the Sanity hidden-draft-reference case, AD-6). */\nfunction VariantBadges({ draft, published }: { draft: boolean; published: boolean }) {\n  return (\n    <Row gap=\"1\" className=\"shrink-0\" data-testid=\"reference-variants\">\n      {draft ? <Badge variant=\"warning\">{translate('references.badgeDraft')}</Badge> : null}\n      {published ? <Badge variant=\"success\">{translate('references.badgePublished')}</Badge> : null}\n    </Row>\n  )\n}\n\n/** Render a deep-link descriptor as a router link (plain text when unresolvable). */\nfunction DeepLinkText({\n  projectId,\n  link,\n  label,\n  primary = false,\n}: {\n  projectId: string\n  link: ReferenceDeepLink | null\n  label: string\n  primary?: boolean\n}) {\n  const className = primary\n    ? 'min-w-0 truncate text-sm font-medium text-foreground hover:text-primary hover:underline'\n    : 'min-w-0 truncate text-xs text-muted-foreground hover:text-primary hover:underline'\n  if (link === null) {\n    return primary ? (\n      <Text size=\"sm\" weight=\"medium\" className=\"min-w-0 truncate\">\n        {label}\n      </Text>\n    ) : (\n      <Text size=\"xs\" tone=\"muted\" className=\"min-w-0 truncate\">\n        {label}\n      </Text>\n    )\n  }\n  switch (link.kind) {\n    case 'cms-field':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.cmsDocument(link.collectionId, link.documentId) }}\n          search={link.fieldPath !== undefined ? { field: link.fieldPath } : {}}\n          className={className}\n          data-testid=\"reference-link-cms\"\n        >\n          {label}\n        </Link>\n      )\n    case 'builder-node':\n      // The builder redirect (EC-187) only reads `?page=`; the page-graph-only\n      // `node` has no home in the document editor and is dropped.\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.builder() }}\n          search={link.pageId !== undefined ? { page: link.pageId } : {}}\n          className={className}\n          data-testid=\"reference-link-builder\"\n        >\n          {label}\n        </Link>\n      )\n    case 'component':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.component(link.componentId) }}\n          className={className}\n          data-testid=\"reference-link-component\"\n        >\n          {label}\n        </Link>\n      )\n    case 'asset':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.assets() }}\n          search={{ asset: link.assetId }}\n          className={className}\n          data-testid=\"reference-link-asset\"\n        >\n          {label}\n        </Link>\n      )\n  }\n}\n"]}
+{"version":3,"file":"references-panel.js","sourceRoot":"","sources":["../../../src/components/references/references-panel.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { AlertTriangle, ArrowDownLeft, ArrowUpRight, Link2, RotateCcw } from 'lucide-react'\nimport type { ReactNode } from 'react'\nimport type { ReferenceSource, ReferenceTarget } from '@elytracms/core/persistence'\nimport { useReferencePanel } from '../../lib/references'\nimport type { ReferenceDeepLink, ReferenceEntryView } from '../../lib/references'\nimport { Badge, Button, Panel, PanelHeader, Row, RowItem, Spacer, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\n\n/**\n * The shared \"References / Used by\" panel (EC-172) — one generic component,\n * three hosts (CMS document detail, asset library, component detail). Entries\n * are served entirely by `@elytracms/core/operations` reference queries over the\n * EC-155 index; every entry deep-links to the exact field control or graph\n * node its index path identifies, and draft-only entries are visibly\n * distinguished from published (live) ones.\n */\nexport function ReferencesPanel({\n  projectId,\n  source,\n  target,\n  className,\n}: {\n  projectId: string\n  /** The holding entity — enables the outbound \"References\" section. */\n  source?: ReferenceSource\n  /** The referenced entity — enables the inbound \"Used by\" section. */\n  target?: ReferenceTarget\n  className?: string\n}) {\n  const panel = useReferencePanel({ projectId, source, target })\n  const total =\n    panel.data === null ? null : panel.data.outbound.length + panel.data.inbound.length\n\n  return (\n    <Panel className={className} data-testid=\"references-panel\">\n      <PanelHeader>\n        <Link2 className=\"size-4 text-primary\" />\n        <Text size=\"sm\" weight=\"semibold\">\n          {translate('references.title')}\n        </Text>\n        {total !== null ? <Badge variant=\"outline\">{total}</Badge> : null}\n        <Spacer />\n      </PanelHeader>\n      <Stack gap=\"4\" className=\"p-4\">\n        {panel.status === 'loading' ? (\n          <ReferencesLoading />\n        ) : panel.status === 'error' ? (\n          <ReferencesError message={panel.errorMessage} onRetry={panel.refresh} />\n        ) : (\n          <>\n            {source ? (\n              <ReferenceSection\n                title={translate('references.title')}\n                icon={<ArrowUpRight className=\"size-3.5\" />}\n                hint={translate('references.hintOutbound')}\n                direction=\"outbound\"\n                projectId={projectId}\n                entries={panel.data?.outbound ?? []}\n                error={panel.data?.outboundError ?? null}\n                emptyLabel={translate('references.emptyOutbound')}\n              />\n            ) : null}\n            {target ? (\n              <ReferenceSection\n                title={translate('references.usedBy')}\n                icon={<ArrowDownLeft className=\"size-3.5\" />}\n                hint={translate('references.hintInbound')}\n                direction=\"inbound\"\n                projectId={projectId}\n                entries={panel.data?.inbound ?? []}\n                error={panel.data?.inboundError ?? null}\n                emptyLabel={translate('references.emptyInbound')}\n              />\n            ) : null}\n          </>\n        )}\n      </Stack>\n    </Panel>\n  )\n}\n\n/** Named loading state, consistent with existing studio panels. */\nfunction ReferencesLoading() {\n  return (\n    <Text size=\"sm\" tone=\"muted\" data-testid=\"references-loading\">\n      {translate('references.loading')}\n    </Text>\n  )\n}\n\n/** Named error state with retry — never a silent failure. */\nfunction ReferencesError({\n  message,\n  onRetry,\n}: {\n  message: string | null\n  onRetry: () => void\n}) {\n  return (\n    <Stack gap=\"2\" data-testid=\"references-error\">\n      <Row gap=\"2\">\n        <AlertTriangle className=\"size-4 text-destructive\" />\n        <Text size=\"sm\" weight=\"semibold\">\n          {translate('references.loadFailed')}\n        </Text>\n      </Row>\n      <Text size=\"xs\" tone=\"muted\">\n        {message ?? translate('references.indexUnreachable')}\n      </Text>\n      <Row>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry}>\n          <RotateCcw /> {translate('common.retry')}\n        </Button>\n      </Row>\n    </Stack>\n  )\n}\n\nfunction ReferenceSection({\n  title,\n  icon,\n  hint,\n  direction,\n  projectId,\n  entries,\n  error,\n  emptyLabel,\n}: {\n  title: string\n  icon: ReactNode\n  hint: string\n  direction: 'outbound' | 'inbound'\n  projectId: string\n  entries: readonly ReferenceEntryView[]\n  /** EC-205: this direction's read failed — shown inline, the panel stays usable. */\n  error?: string | null\n  emptyLabel: string\n}) {\n  return (\n    <Stack gap=\"2\" data-testid={`references-${direction}`}>\n      <Row gap=\"2\">\n        <span className=\"text-muted-foreground\">{icon}</span>\n        <Text size=\"xs\" weight=\"semibold\" tone=\"muted\" className=\"uppercase tracking-wide\">\n          {title}\n        </Text>\n        <Badge variant=\"outline\">{entries.length}</Badge>\n      </Row>\n      {error ? (\n        <Row gap=\"2\" data-testid={`references-${direction}-error`}>\n          <AlertTriangle className=\"size-3.5 shrink-0 text-destructive\" />\n          <Text size=\"xs\" tone=\"muted\">\n            {translate('references.sectionLoadError', { error })}\n          </Text>\n        </Row>\n      ) : entries.length === 0 ? (\n        <Text size=\"sm\" tone=\"muted\" data-testid={`references-${direction}-empty`}>\n          {emptyLabel}\n        </Text>\n      ) : (\n        <Stack gap=\"2\" title={hint}>\n          {entries.map((entry) => (\n            <ReferenceEntryRow\n              key={entry.key}\n              entry={entry}\n              direction={direction}\n              projectId={projectId}\n            />\n          ))}\n        </Stack>\n      )}\n    </Stack>\n  )\n}\n\n/**\n * One entry row. Inbound rows lead with the *source* (where it is used) and\n * deep-link to the exact location; outbound rows lead with the *target* and\n * keep the exact-field link on the location line.\n */\nfunction ReferenceEntryRow({\n  entry,\n  direction,\n  projectId,\n}: {\n  entry: ReferenceEntryView\n  direction: 'outbound' | 'inbound'\n  projectId: string\n}) {\n  const primary =\n    direction === 'inbound'\n      ? { label: entry.sourceLabel, link: entry.sourceLink }\n      : { label: entry.targetLabel, link: entry.targetLink }\n  return (\n    <RowItem\n      data-testid=\"reference-entry\"\n      actions={\n        <>\n          <Badge variant=\"outline\">{entry.kindLabel}</Badge>\n          <VariantBadges draft={entry.draft} published={entry.published} />\n        </>\n      }\n    >\n      <Stack gap=\"1\" className=\"min-w-0\">\n        <Row gap=\"2\" className=\"min-w-0\">\n          <DeepLinkText projectId={projectId} link={primary.link} label={primary.label} primary />\n        </Row>\n        <Row gap=\"1\" className=\"min-w-0\">\n          <Text size=\"xs\" tone=\"muted\" className=\"shrink-0\">\n            {translate('references.locationPrefix')}\n          </Text>\n          <DeepLinkText\n            projectId={projectId}\n            link={entry.sourceLink}\n            label={entry.locationLabel}\n          />\n        </Row>\n      </Stack>\n    </RowItem>\n  )\n}\n\n/** Draft/published visibility (the Sanity hidden-draft-reference case, AD-6). */\nfunction VariantBadges({ draft, published }: { draft: boolean; published: boolean }) {\n  return (\n    <Row gap=\"1\" className=\"shrink-0\" data-testid=\"reference-variants\">\n      {draft ? <Badge variant=\"warning\">{translate('references.badgeDraft')}</Badge> : null}\n      {published ? <Badge variant=\"success\">{translate('references.badgePublished')}</Badge> : null}\n    </Row>\n  )\n}\n\n/** Render a deep-link descriptor as a router link (plain text when unresolvable). */\nfunction DeepLinkText({\n  projectId,\n  link,\n  label,\n  primary = false,\n}: {\n  projectId: string\n  link: ReferenceDeepLink | null\n  label: string\n  primary?: boolean\n}) {\n  const className = primary\n    ? 'min-w-0 truncate text-sm font-medium text-foreground hover:text-primary hover:underline'\n    : 'min-w-0 truncate text-xs text-muted-foreground hover:text-primary hover:underline'\n  if (link === null) {\n    return primary ? (\n      <Text size=\"sm\" weight=\"medium\" className=\"min-w-0 truncate\">\n        {label}\n      </Text>\n    ) : (\n      <Text size=\"xs\" tone=\"muted\" className=\"min-w-0 truncate\">\n        {label}\n      </Text>\n    )\n  }\n  switch (link.kind) {\n    case 'cms-field':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.cmsDocument(link.collectionId, link.documentId) }}\n          search={link.fieldPath !== undefined ? { field: link.fieldPath } : {}}\n          className={className}\n          data-testid=\"reference-link-cms\"\n        >\n          {label}\n        </Link>\n      )\n    case 'builder-node':\n      // The builder redirect (EC-187) only reads `?page=`; the page-graph-only\n      // `node` has no home in the document editor and is dropped.\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.builder() }}\n          search={link.pageId !== undefined ? { page: link.pageId } : {}}\n          className={className}\n          data-testid=\"reference-link-builder\"\n        >\n          {label}\n        </Link>\n      )\n    case 'component':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.component(link.componentId) }}\n          className={className}\n          data-testid=\"reference-link-component\"\n        >\n          {label}\n        </Link>\n      )\n    case 'asset':\n      return (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: studioPath.assets() }}\n          search={{ asset: link.assetId }}\n          className={className}\n          data-testid=\"reference-link-asset\"\n        >\n          {label}\n        </Link>\n      )\n  }\n}\n"]}

package/dist/components/section-nav.js

@@ -2,18 +2,20 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Fragment, useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react';
 import { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router';
 import { 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 { contentSessionOrphans, serverContentSessionOrphans, subscribeContentSession, } from '@elytracms/studio/lib/data';
-import { translate } from '@elytracms/studio/lib/i18n';
+import { cn } from '../lib/utils.js';
+import { readCollapsedViews, storeCollapsedViews } from '../lib/rail.js';
+import { getStudioRegistry } from '../lib/registry/index.js';
+import { projectConfigIssues, resolveDeploymentCollections, resolveDeploymentReuse, resolveDeploymentRoutes, } from '../lib/workspace/index.js';
+import { routeValidationIssues } from '../lib/routes/route-issues.js';
+import { contentSessionOrphans, serverContentSessionOrphans, subscribeContentSession, } from '../lib/data/index.js';
+import { translate } from '../lib/i18n/index.js';
 import { Text } from '@elytracms/studio/ui';
 import { NavIssues, customizationItems, orphanedCollectionItems, routeIssueItems } from './nav-issues.js';
 import { activeViewIdFromPath, isNavViewVisible, useStudioNav } from './app-views/sidebar.js';
 import { resolveReuse } from './builder/reuse.js';
-import { useRedirectList } from './redirects/redirects-store.js';
+import { redirectRecordKind } from '@elytracms/core/persistence';
+import { useRecordList } from './records/record-rail.js';
+import { useContributedNavIssues, useNavIssues } from './nav-issues-registry.js';
 import { useFieldRenderers } from './cms/field-renderer.js';
 import { useProjectRole } from './auth-context.js';
 /**
@@ -29,19 +31,24 @@ import { useProjectRole } from './auth-context.js';
 export function SectionNav({ project, collapsed, onToggleCollapsed }) {
     const { pathname } = useLocation();
     const activeViewId = activeViewIdFromPath(pathname);
-    const { nodes, issues: navIssues } = useStudioNav(project);
+    const { nodes, issues: navIssues, registry } = useStudioNav(project);
     const { issues: rendererIssues } = useFieldRenderers();
     const configIssues = useProjectConfigIssues();
     const reuseIssues = useReuseIssues();
     const projectId = project.id;
     const routeIssues = useRouteIssues(projectId);
     const orphanIssues = useOrphanedCollectionIssues();
+    // EC-616: findings contributed by views and addons (`useNavIssues`), and the views that
+    // declare always-on findings (`useIssues`) — mounted below, whether or not they are open.
+    const contributedIssues = useContributedNavIssues();
+    const issueViews = useMemo(() => registry.views.filter((view) => view.useIssues), [registry]);
     // 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,
         ...orphanIssues,
+        ...contributedIssues,
     ];
     // 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 →
@@ -93,7 +100,7 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
                 return (_jsxs(Fragment, { children: [_jsx(NavViewLink, { projectId: projectId, view: node, activeViewId: activeViewId, collapsed: collapsed, hasActiveChild: hasActiveChild, collapsible: hasChildren && !collapsed, expanded: !viewCollapsed, onToggleExpanded: () => toggleViewCollapsed(node.id) }), collapsed || viewCollapsed
                             ? null
                             : 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') })] })) })] })] }));
+            }), issueViews.map((view) => (_jsx(ViewIssuesProbe, { view: view, project: project }, view.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.
@@ -150,7 +157,7 @@ function useReuseIssues() {
  * {@link routeIssueItems} — severity included since EC-493.
  */
 function useRouteIssues(projectId) {
-    const redirects = useRedirectList(projectId).data;
+    const redirects = useRecordList(redirectRecordKind, projectId).data;
     return useMemo(() => routeIssueItems(routeValidationIssues({ routes: resolveDeploymentRoutes(), collections: resolveDeploymentCollections() }, redirects ?? [])), [redirects]);
 }
 /**
@@ -174,6 +181,15 @@ function useOrphanedCollectionIssues() {
     const orphans = useSyncExternalStore(subscribeContentSession, contentSessionOrphans, serverContentSessionOrphans);
     return useMemo(() => orphanedCollectionItems(orphans), [orphans]);
 }
+/**
+ * EC-616 — runs one view's always-on findings hook (`useIssues`) and publishes what it
+ * returns to the foot. One component per view, so each hook keeps its own hook order.
+ */
+function ViewIssuesProbe({ view, project }) {
+    const issues = view.useIssues({ project, projectId: project.id });
+    useNavIssues(`view:`, issues);
+    return null;
+}
 /** 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;