@elytracms/studio 0.0.26 → 0.0.28

package/dist/components/redirects/redirects-store.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from 'react';
+import type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence';
+/**
+ * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302
+ * forwards — read + written through the shared operations client (`redirects.*`),
+ * the same seam the users/assets stores use. Content-gated (a viewer reads, an
+ * editor writes); no draft/published split — a saved+enabled redirect is live.
+ *
+ * The "New" flow keeps an unsaved redirect as a LOCAL draft (memory only) until
+ * the first explicit save persists it — so an abandoned "New" never writes a stub
+ * to the backend and never shows in the list. Drafts are reachable via {@link
+ * RedirectsStore.get} (the detail editor loads one), never listed.
+ */
+export interface RedirectsStore {
+    projectId: string;
+    status: 'loading' | 'ready' | 'error';
+    errorMessage?: string;
+    /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */
+    redirects: readonly RedirectEntry[];
+    /** One redirect: a local unsaved draft if present, else a persisted record. */
+    get(id: string): RedirectEntry | 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: SaveRedirectInput): Promise<{
+        ok: true;
+        redirect: RedirectEntry;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Delete a persisted redirect, or silently discard an unsaved draft. */
+    remove(id: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Re-list from the backend. */
+    refresh(): Promise<void>;
+}
+export declare function RedirectsProvider({ projectId, children, }: {
+    projectId: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useRedirects(): RedirectsStore;

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

@@ -0,0 +1,124 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { getStudioOperations } from '@elytracms/studio/lib/operations';
+import { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query';
+const RedirectsContext = createContext(null);
+const EMPTY_REDIRECTS = [];
+let draftCounter = 0;
+/** A collision-resistant client id for a new redirect (used as its real id on save). */
+function newDraftId() {
+    draftCounter += 1;
+    return `redirect_${Date.now().toString(36)}_${draftCounter}`;
+}
+function redirectsQueryKey(projectId) {
+    return ['redirects', projectId];
+}
+async function loadRedirects(operations, projectId) {
+    const result = await operations.redirects.list({ projectId });
+    if (!result.ok)
+        throw new Error(result.error.message);
+    return [...result.value];
+}
+function byFrom(a, b) {
+    return a.from < b.from ? -1 : a.from > b.from ? 1 : 0;
+}
+export function RedirectsProvider({ projectId, children, }) {
+    const query = useOperationQuery({
+        queryKey: redirectsQueryKey(projectId),
+        loader: (operations) => loadRedirects(operations, projectId),
+    });
+    const cache = useOperationCache();
+    const refetch = query.refetch;
+    const persisted = query.data ?? EMPTY_REDIRECTS;
+    const status = query.isPending
+        ? 'loading'
+        : query.isError
+            ? 'error'
+            : 'ready';
+    const errorMessage = query.isError && query.error instanceof Error ? query.error.message : undefined;
+    // In-memory unsaved "New" drafts, keyed by id. Not listed; only get()-able.
+    const [drafts, setDrafts] = useState({});
+    const refresh = useCallback(async () => {
+        await refetch();
+    }, [refetch]);
+    const get = useCallback((id) => drafts[id] ?? persisted.find((r) => r.id === id), [drafts, persisted]);
+    const createDraft = useCallback(() => {
+        const id = newDraftId();
+        const now = new Date().toISOString();
+        const draft = {
+            id,
+            projectId,
+            from: '',
+            to: '',
+            permanent: true,
+            enabled: false,
+            createdAt: now,
+            updatedAt: now,
+        };
+        setDrafts((prev) => ({ ...prev, [id]: draft }));
+        return id;
+    }, [projectId]);
+    const save = useCallback(async (input) => {
+        const { operations } = await getStudioOperations();
+        const result = await operations.redirects.save({
+            projectId,
+            ...(input.id !== undefined ? { id: input.id } : {}),
+            from: input.from,
+            to: input.to,
+            ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),
+            ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
+        });
+        if (!result.ok)
+            return { ok: false, message: result.error.message };
+        const saved = result.value;
+        cache.patch(redirectsQueryKey(projectId), (prev) => {
+            const rest = (prev ?? []).filter((r) => r.id !== saved.id);
+            return [...rest, saved].sort(byFrom);
+        });
+        // The record is now persisted — drop any matching draft.
+        setDrafts((prev) => {
+            if (!(saved.id in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[saved.id];
+            return next;
+        });
+        return { ok: true, redirect: saved };
+    }, [projectId, cache]);
+    const remove = useCallback(async (id) => {
+        // An unsaved draft was never persisted — discard it locally, no backend call.
+        if (drafts[id]) {
+            setDrafts((prev) => {
+                const next = { ...prev };
+                delete next[id];
+                return next;
+            });
+            return { ok: true };
+        }
+        const { operations } = await getStudioOperations();
+        const result = await operations.redirects.remove({ projectId, id });
+        if (!result.ok)
+            return { ok: false, message: result.error.message };
+        cache.patch(redirectsQueryKey(projectId), (prev) => (prev ?? []).filter((r) => r.id !== id));
+        return { ok: true };
+    }, [projectId, cache, drafts]);
+    const store = useMemo(() => ({
+        projectId,
+        status,
+        ...(errorMessage !== undefined ? { errorMessage } : {}),
+        redirects: persisted,
+        get,
+        createDraft,
+        save,
+        remove,
+        refresh,
+    }), [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh]);
+    return _jsx(RedirectsContext.Provider, { value: store, children: children });
+}
+export function useRedirects() {
+    const store = useContext(RedirectsContext);
+    if (!store)
+        throw new Error('useRedirects must be used within a <RedirectsProvider>.');
+    return store;
+}
+//# sourceMappingURL=redirects-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useCallback, useContext, 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 { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\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 RedirectsContext = createContext<RedirectsStore | null>(null)\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: RedirectsStore['status'] = query.isPending\n    ? 'loading'\n    : query.isError\n      ? 'error'\n      : 'ready'\n  const errorMessage =\n    query.isError && query.error instanceof Error ? query.error.message : undefined\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      enabled: false,\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      })\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 function useRedirects(): RedirectsStore {\n  const store = useContext(RedirectsContext)\n  if (!store) throw new Error('useRedirects must be used within a <RedirectsProvider>.')\n  return store\n}\n"]}

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

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 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 { Badge, Button, Panel, PanelHeader, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { Badge, Button, Panel, PanelHeader, Row, RowItem, Spacer, Stack, Text } from '@elytracms/studio/ui';
 /**
  * The shared "References / Used by" panel (EC-172) — one generic component,
  * three hosts (CMS document detail, asset library, component detail). Entries
@@ -36,7 +36,7 @@ function ReferenceEntryRow({ entry, direction, projectId, }) {
     const primary = direction === 'inbound'
         ? { label: entry.sourceLabel, link: entry.sourceLink }
         : { label: entry.targetLabel, link: entry.targetLink };
-    return (_jsxs(Row, { gap: "2", className: "rounded-md border border-border/70 bg-background/40 px-2.5 py-2", "data-testid": "reference-entry", children: [_jsxs(Stack, { gap: "1", className: "min-w-0 flex-1", children: [_jsx(Row, { gap: "2", className: "min-w-0", children: _jsx(DeepLinkText, { projectId: projectId, link: primary.link, label: primary.label, primary: true }) }), _jsxs(Row, { gap: "1", className: "min-w-0", children: [_jsx(Text, { size: "xs", tone: "muted", className: "shrink-0", children: "at" }), _jsx(DeepLinkText, { projectId: projectId, link: entry.sourceLink, label: entry.locationLabel })] })] }), _jsx(Badge, { variant: "outline", className: "shrink-0", children: entry.kindLabel }), _jsx(VariantBadges, { draft: entry.draft, published: entry.published })] }));
+    return (_jsx(RowItem, { "data-testid": "reference-entry", actions: _jsxs(_Fragment, { children: [_jsx(Badge, { variant: "outline", children: entry.kindLabel }), _jsx(VariantBadges, { draft: entry.draft, published: entry.published })] }), children: _jsxs(Stack, { gap: "1", className: "min-w-0", children: [_jsx(Row, { gap: "2", className: "min-w-0", children: _jsx(DeepLinkText, { projectId: projectId, link: primary.link, label: primary.label, primary: true }) }), _jsxs(Row, { gap: "1", className: "min-w-0", children: [_jsx(Text, { size: "xs", tone: "muted", className: "shrink-0", children: "at" }), _jsx(DeepLinkText, { projectId: projectId, link: entry.sourceLink, label: entry.locationLabel })] })] }) }));
 }
 /** Draft/published visibility (the Sanity hidden-draft-reference case, AD-6). */
 function VariantBadges({ draft, published }) {

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, Spacer, Stack, Text } from '@elytracms/studio/ui'\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          References\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=\"References\"\n                icon={<ArrowUpRight className=\"size-3.5\" />}\n                hint=\"What this entry points at — click to jump to the target, or to the exact field.\"\n                direction=\"outbound\"\n                projectId={projectId}\n                entries={panel.data?.outbound ?? []}\n                error={panel.data?.outboundError ?? null}\n                emptyLabel=\"No outbound references.\"\n              />\n            ) : null}\n            {target ? (\n              <ReferenceSection\n                title=\"Used by\"\n                icon={<ArrowDownLeft className=\"size-3.5\" />}\n                hint=\"Everything referencing this entry — click to jump to the exact field or node.\"\n                direction=\"inbound\"\n                projectId={projectId}\n                entries={panel.data?.inbound ?? []}\n                error={panel.data?.inboundError ?? null}\n                emptyLabel=\"Not referenced anywhere.\"\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      Loading references…\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          References failed to load\n        </Text>\n      </Row>\n      <Text size=\"xs\" tone=\"muted\">\n        {message ?? 'The reference index is unreachable.'}\n      </Text>\n      <Row>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry}>\n          <RotateCcw /> 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            Couldn’t load this section: {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    <Row\n      gap=\"2\"\n      className=\"rounded-md border border-border/70 bg-background/40 px-2.5 py-2\"\n      data-testid=\"reference-entry\"\n    >\n      <Stack gap=\"1\" className=\"min-w-0 flex-1\">\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            at\n          </Text>\n          <DeepLinkText\n            projectId={projectId}\n            link={entry.sourceLink}\n            label={entry.locationLabel}\n          />\n        </Row>\n      </Stack>\n      <Badge variant=\"outline\" className=\"shrink-0\">\n        {entry.kindLabel}\n      </Badge>\n      <VariantBadges draft={entry.draft} published={entry.published} />\n    </Row>\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\">draft</Badge> : null}\n      {published ? <Badge variant=\"success\">published</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 '@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'\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          References\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=\"References\"\n                icon={<ArrowUpRight className=\"size-3.5\" />}\n                hint=\"What this entry points at — click to jump to the target, or to the exact field.\"\n                direction=\"outbound\"\n                projectId={projectId}\n                entries={panel.data?.outbound ?? []}\n                error={panel.data?.outboundError ?? null}\n                emptyLabel=\"No outbound references.\"\n              />\n            ) : null}\n            {target ? (\n              <ReferenceSection\n                title=\"Used by\"\n                icon={<ArrowDownLeft className=\"size-3.5\" />}\n                hint=\"Everything referencing this entry — click to jump to the exact field or node.\"\n                direction=\"inbound\"\n                projectId={projectId}\n                entries={panel.data?.inbound ?? []}\n                error={panel.data?.inboundError ?? null}\n                emptyLabel=\"Not referenced anywhere.\"\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      Loading references…\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          References failed to load\n        </Text>\n      </Row>\n      <Text size=\"xs\" tone=\"muted\">\n        {message ?? 'The reference index is unreachable.'}\n      </Text>\n      <Row>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry}>\n          <RotateCcw /> 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            Couldn’t load this section: {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            at\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\">draft</Badge> : null}\n      {published ? <Badge variant=\"success\">published</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

@@ -5,8 +5,9 @@ import { AlertTriangle, ChevronDown, PanelLeftClose, PanelLeftOpen } from 'lucid
 import { cn } from '@elytracms/studio/lib/utils';
 import { readCollapsedViews, storeCollapsedViews } from '@elytracms/studio/lib/rail';
 import { Text } from '@elytracms/studio/ui';
-import { activeViewIdFromPath, useStudioNav } from './app-views/sidebar';
+import { activeViewIdFromPath, isNavViewVisible, useStudioNav } from './app-views/sidebar';
 import { useFieldRenderers } from './cms/field-renderer';
+import { useProjectRole } from './auth-context';
 /**
  * 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,6 +25,13 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
     const { issues: rendererIssues } = useFieldRenderers();
     const issues = [...navIssues, ...rendererIssues];
     const projectId = project.id;
+    // 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,
+    // and a permission-hidden view is still reachable by URL (EC-221).
+    const role = useProjectRole(projectId);
+    const navCtx = { project, role };
+    const isVisible = (view) => isNavViewVisible(view, navCtx);
     // EC-293: per-parent collapse of nested sub-views, persisted (read after mount,
     // like the rail-collapse pref — no flash script needed). A collapsed parent hides
     // its children but stays a navigable link.
@@ -47,14 +55,15 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
                     return _jsx("div", { className: "my-1.5 border-t border-border/60", "aria-hidden": true }, `sep-${index}`);
                 }
                 if (node.kind === 'group') {
-                    const views = node.views.filter((view) => view.availability !== 'unavailable');
+                    const views = node.views.filter((view) => view.availability !== 'unavailable' && isVisible(view));
                     if (views.length === 0)
                         return null;
                     return (_jsxs("div", { className: "mt-2 first:mt-0", children: [collapsed ? (_jsx("div", { className: "my-1 border-t border-border/60", "aria-hidden": true })) : (_jsx(Text, { size: "xs", tone: "subtle", className: "px-3 pb-1 pt-1 font-medium uppercase tracking-wide", children: node.label })), views.map((view) => (_jsx(NavViewLink, { projectId: projectId, view: view, activeViewId: activeViewId, collapsed: collapsed }, view.id)))] }, `group-${node.label}-${index}`));
                 }
                 // EC-221: an unavailable view is absent from the rail (not greyed) — it
-                // stays reachable by URL, the rail simply doesn't advertise it.
-                if (node.availability === 'unavailable')
+                // stays reachable by URL, the rail simply doesn't advertise it. EC-240: a
+                // permission-hidden view is likewise absent-but-addressable.
+                if (node.availability === 'unavailable' || !isVisible(node))
                     return null;
                 // EC-293: a view may nest its sub-views (CMS collections). The parent renders
                 // as a link with a disclosure chevron; its children render indented below,
@@ -65,7 +74,7 @@ export function SectionNav({ project, collapsed, onToggleCollapsed }) {
                 const viewCollapsed = collapsedViews.has(node.id);
                 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?.map((child) => (_jsx(NavViewLink, { projectId: projectId, view: child, activeViewId: activeViewId, collapsed: collapsed, nested: true }, child.id)))] }, node.id));
+                            : 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 ? 'Expand sidebar' : 'Collapse sidebar', "aria-pressed": collapsed, title: collapsed ? 'Expand sidebar' : 'Collapse sidebar', 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: "Collapse" })] })) })] })] }));
 }
 /** One rail view (top-level or nested) — a Link to its home route, active by view id. */

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 { Text } from '@elytracms/studio/ui'\nimport { activeViewIdFromPath, useStudioNav } from './app-views/sidebar'\nimport type { ResolvedRailView } from './app-views/sidebar'\nimport { useFieldRenderers } from './cms/field-renderer'\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-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=\"Sections\"\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((view) => view.availability !== 'unavailable')\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.\n        if (node.availability === 'unavailable') 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?.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 ? 'Expand sidebar' : 'Collapse sidebar'}\n          aria-pressed={collapsed}\n          title={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}\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\">Collapse</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=\"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={`${expanded ? 'Collapse' : 'Expand'} ${view.label}`}\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={`${issues.length} sidebar issues`} />\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, 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 { 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=\"Sections\"\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 ? 'Expand sidebar' : 'Collapse sidebar'}\n          aria-pressed={collapsed}\n          title={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}\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\">Collapse</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=\"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={`${expanded ? 'Collapse' : 'Expand'} ${view.label}`}\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={`${issues.length} sidebar issues`} />\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"]}

package/dist/components/users/user-search.d.ts

@@ -0,0 +1,8 @@
+import type { UserRecord } from '@elytracms/core/persistence';
+/**
+ * Free-text filter over the studio users roster (EC-240, 240b) — matches a query
+ * against a user's name, email, id, or any of their roles, case-insensitively.
+ * Pure + deterministic (mirrors `asset-search.ts`), so the roster's search state
+ * is reproducible from fixtures.
+ */
+export declare function filterUsers(users: readonly UserRecord[], query: string): readonly UserRecord[];

package/dist/components/users/user-search.js

@@ -0,0 +1,13 @@
+/**
+ * Free-text filter over the studio users roster (EC-240, 240b) — matches a query
+ * against a user's name, email, id, or any of their roles, case-insensitively.
+ * Pure + deterministic (mirrors `asset-search.ts`), so the roster's search state
+ * is reproducible from fixtures.
+ */
+export function filterUsers(users, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return users;
+    return users.filter((user) => [user.name ?? '', user.email, user.id, ...user.roles].some((field) => field.toLowerCase().includes(q)));
+}
+//# sourceMappingURL=user-search.js.map

package/dist/components/users/user-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-search.js","sourceRoot":"","sources":["../../../src/components/users/user-search.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAA4B,EAAE,KAAa;IACrE,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACpB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACnE,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAChC,CACF,CAAA;AACH,CAAC","sourcesContent":["import type { UserRecord } from '@elytracms/core/persistence'\n\n/**\n * Free-text filter over the studio users roster (EC-240, 240b) — matches a query\n * against a user's name, email, id, or any of their roles, case-insensitively.\n * Pure + deterministic (mirrors `asset-search.ts`), so the roster's search state\n * is reproducible from fixtures.\n */\nexport function filterUsers(users: readonly UserRecord[], query: string): readonly UserRecord[] {\n  const q = query.trim().toLowerCase()\n  if (!q) return users\n  return users.filter((user) =>\n    [user.name ?? '', user.email, user.id, ...user.roles].some((field) =>\n      field.toLowerCase().includes(q),\n    ),\n  )\n}\n"]}

package/dist/components/users/users-collection-view-source.d.ts

@@ -0,0 +1,28 @@
+import type { CmsDocument, FieldDef } from '@elytracms/core/cms-core';
+import type { SaveUserInput, UserRecord } from '@elytracms/core/persistence';
+import type { CollectionViewSource, FieldAccess } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/** Project the auth-identity + membership join into the lens's `values` shape. */
+export declare function userToDocument(record: UserRecord): CmsDocument;
+/**
+ * Principal-based field access for the users rail (EC-240, AD-18). `role` is
+ * authority: **read-only when you are editing YOURSELF** — you don't change your
+ * own role (the server integrity floor also guards it) — and **editable otherwise**
+ * (the rail is admin-only, so a non-self editor is an admin acting on someone else).
+ * Identity fields (name/email) follow their schema `form.readOnly`; everything else
+ * is editable. Pure, so the self/other rule is unit-testable without the auth hook.
+ */
+export declare function userFieldAccess(field: FieldDef, record: CmsDocument | undefined, currentUserId: string | undefined): FieldAccess;
+/** Map an edited lens document back to the write contract (role + custom `meta`). */
+export declare function documentToSaveInput(doc: CmsDocument): SaveUserInput;
+/**
+ * Assemble a {@link CollectionViewSource} for the **users rail** (EC-240, AD-19) —
+ * the reuse proof that the portable list/edit surfaces serve a non-`cmsDocuments`
+ * rail. Mirrors {@link useCmsCollectionViewSource}, over the users store instead of
+ * the CMS store, with the users capability profile: admin-only, no
+ * publish/versions/create/import (identities are minted by sign-up and their bytes
+ * are auth-owned), remove allowed (revoke membership). Identity fields are
+ * read-only; an admin edits a member's role (and future custom `meta` fields).
+ *
+ * Must be mounted under a `UsersProvider` (for {@link useUsers}).
+ */
+export declare function useUsersCollectionViewSource(projectId: string): CollectionViewSource;