@elytracms/studio 0.0.42 → 0.0.44

package/dist/components/studio-context.js

@@ -1,9 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 import { activateProject, configProject, emptyContext } from '@elytracms/core/studio-core';
 import { getWorkspaceState } from '@elytracms/studio/lib/workspace';
 import { StudioQueryProvider } from '@elytracms/studio/lib/query';
-const StudioContext = createContext(null);
+import { createRequiredContext } from '@elytracms/studio/lib/required-context';
+const { Context: StudioContext, useRequired: useStudio } = createRequiredContext('Studio');
 /** Resolve the config-declared projects into studio `Project`s (slug-keyed). */
 function configProjects() {
     const state = getWorkspaceState();
@@ -43,10 +44,5 @@ export function StudioProvider({ children }) {
     // studio server read flows through `useOperationQuery`.
     return (_jsx(StudioContext.Provider, { value: store, children: _jsx(StudioQueryProvider, { children: children }) }));
 }
-export function useStudio() {
-    const store = useContext(StudioContext);
-    if (!store)
-        throw new Error('useStudio must be used within a <StudioProvider>.');
-    return store;
-}
+export { useStudio };
 //# sourceMappingURL=studio-context.js.map

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

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

package/dist/components/studio-shell.js

@@ -36,7 +36,7 @@ export function StudioShell({ project, children }) {
             return next;
         });
     }, []);
-    return (_jsxs(BreadcrumbProvider, { children: [_jsxs("div", { className: "flex h-dvh flex-col bg-background", children: [_jsxs("header", { className: "flex h-12 shrink-0 items-center gap-2 border-b border-border px-3", children: [_jsx(Link, { to: "/", className: "grid size-6 shrink-0 place-items-center", "aria-label": translate('shell.allProjects'), children: _jsx("span", { className: "size-5 rounded-[5px] bg-primary shadow-sm" }) }), _jsx(ProjectSwitcher, { activeProject: project }), _jsx(HeaderBreadcrumb, { project: project, activeViewId: activeViewId }), _jsx(Spacer, {}), _jsx(PlaygroundBadge, {}), _jsx(DevLoginBadge, {}), _jsx(CurrentUserMenu, { projectId: project.id })] }), _jsx(DeliveryHealthBanner, {}), _jsxs("div", { className: "flex min-h-0 flex-1", children: [_jsx(SectionNav, { project: project, collapsed: railCollapsed, onToggleCollapsed: toggleRail }), _jsx("main", { className: "flex min-w-0 flex-1 flex-col overflow-hidden", children: _jsx("div", { className: "min-h-0 flex-1 overflow-auto", children: children }) })] })] }), _jsx(Toaster, {})] }));
+    return (_jsxs(BreadcrumbProvider, { children: [_jsxs("div", { className: "flex h-dvh flex-col bg-background", children: [_jsxs("header", { className: "flex h-12 shrink-0 items-center gap-2 border-b border-border px-3", children: [_jsx(Link, { to: "/", className: "grid size-6 shrink-0 place-items-center", "aria-label": translate('shell.allProjects'), children: _jsx("span", { className: "size-5 rounded-[5px] bg-primary shadow-sm" }) }), _jsx(ProjectSwitcher, { activeProject: project }), _jsx(HeaderBreadcrumb, { project: project, activeViewId: activeViewId }), _jsx(Spacer, {}), _jsx(PlaygroundBadge, {}), _jsx(DevLoginBadge, {}), _jsx(CurrentUserMenu, { projectId: project.id })] }), _jsx(DeliveryHealthBanner, { projectId: project.id }), _jsxs("div", { className: "flex min-h-0 flex-1", children: [_jsx(SectionNav, { project: project, collapsed: railCollapsed, onToggleCollapsed: toggleRail }), _jsx("main", { className: "flex min-w-0 flex-1 flex-col overflow-hidden", children: _jsx("div", { className: "min-h-0 flex-1 overflow-auto", children: children }) })] })] }), _jsx(Toaster, {})] }));
 }
 const CRUMB_LINK = 'max-w-[12rem] truncate text-muted-foreground transition-colors hover:text-foreground';
 const CRUMB_CURRENT = 'max-w-[16rem] truncate font-medium text-foreground';

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

@@ -1 +1 @@
-{"version":3,"file":"studio-shell.js","sourceRoot":"","sources":["../../src/components/studio-shell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router'\nimport { ChevronRight } from 'lucide-react'\nimport { useCallback, useEffect, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { Project, ProjectId } from '@elytracms/core/studio-core'\nimport { Row, Spacer, Toaster } from '@elytracms/studio/ui'\nimport { readRailCollapsed, storeRailCollapsed } from '@elytracms/studio/lib/rail'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { CurrentUserMenu } from './current-user-menu'\nimport { DeliveryHealthBanner } from './delivery-health-banner'\nimport { PlaygroundBadge } from './playground-badge'\nimport { DevLoginBadge } from './dev-login-badge'\nimport { ProjectSwitcher } from './project-switcher'\nimport { SectionNav } from './section-nav'\nimport { activeViewIdFromPath, useStudioNav } from './app-views/sidebar'\nimport { BreadcrumbProvider, useBreadcrumbTrail } from './breadcrumb-context'\n\nexport interface StudioShellProps {\n  project: Project\n  children: ReactNode\n}\n\n/**\n * The Studio shell (brief §4.3, §8.1): a persistent top bar + section rail that\n * preserve the active project while the user moves between surfaces. The top bar\n * carries the single global breadcrumb reaching the active record (EC-214) — no\n * secondary band, no per-view title repeating the section. Responsive and\n * overflow-safe.\n */\nexport function StudioShell({ project, children }: StudioShellProps) {\n  const { pathname } = useLocation()\n  const activeViewId = activeViewIdFromPath(pathname)\n\n  // User-toggled, persisted rail collapse (EC-214). Defaults to expanded; the\n  // stored preference is read after mount (no flash script needed for a rail).\n  const [railCollapsed, setRailCollapsed] = useState(false)\n  useEffect(() => {\n    setRailCollapsed(readRailCollapsed())\n  }, [])\n  const toggleRail = useCallback(() => {\n    setRailCollapsed((prev) => {\n      const next = !prev\n      storeRailCollapsed(next)\n      return next\n    })\n  }, [])\n\n  return (\n    <BreadcrumbProvider>\n      <div className=\"flex h-dvh flex-col bg-background\">\n        {/* Top bar — global controls + the one breadcrumb to the active record. */}\n        <header className=\"flex h-12 shrink-0 items-center gap-2 border-b border-border px-3\">\n          <Link to=\"/\" className=\"grid size-6 shrink-0 place-items-center\" aria-label={translate('shell.allProjects')}>\n            <span className=\"size-5 rounded-[5px] bg-primary shadow-sm\" />\n          </Link>\n          <ProjectSwitcher activeProject={project} />\n          <HeaderBreadcrumb project={project} activeViewId={activeViewId} />\n          <Spacer />\n          {/* EC-153: explicit playground-mode marker (renders nothing on Convex). */}\n          <PlaygroundBadge />\n          {/* Dev-only unattended-auth marker (renders nothing in prod / when unset). */}\n          <DevLoginBadge />\n          {/* EC-150: signed-in user + their role on this project + sign-out. */}\n          <CurrentUserMenu projectId={project.id} />\n        </header>\n\n        {/* EC-268: warns when instant-publish env is incomplete (connected mode only). */}\n        <DeliveryHealthBanner />\n\n        <div className=\"flex min-h-0 flex-1\">\n          <SectionNav\n            project={project}\n            collapsed={railCollapsed}\n            onToggleCollapsed={toggleRail}\n          />\n\n          <main className=\"flex min-w-0 flex-1 flex-col overflow-hidden\">\n            <div className=\"min-h-0 flex-1 overflow-auto\">{children}</div>\n          </main>\n        </div>\n      </div>\n      {/* EC-268: transient action feedback (e.g. a publish that fails at transport). */}\n      <Toaster />\n    </BreadcrumbProvider>\n  )\n}\n\nconst CRUMB_LINK =\n  'max-w-[12rem] truncate text-muted-foreground transition-colors hover:text-foreground'\nconst CRUMB_CURRENT = 'max-w-[16rem] truncate font-medium text-foreground'\n\n/**\n * The single global breadcrumb (EC-214): project (the switcher) › section › …the\n * active record. The section crumb is the active VIEW's label (EC-237/239, resolved\n * from the rail-derived registry); deeper crumbs are contributed by the active\n * surface via {@link useBreadcrumbTrail}. The last crumb is the current page (plain\n * text); earlier crumbs link back.\n */\nfunction HeaderBreadcrumb({\n  project,\n  activeViewId,\n}: {\n  project: Project\n  activeViewId: string | null\n}) {\n  const projectId: ProjectId = project.id\n  const nav = useStudioNav(project)\n  const extra = useBreadcrumbTrail()\n  const view = activeViewId ? nav.registry.get(activeViewId) : undefined\n  if (!view) return null\n  const sectionIsLast = extra.length === 0\n\n  return (\n    <Row gap=\"1\" className=\"min-w-0 text-sm\" aria-label={translate('shell.breadcrumb.label')}>\n      <ChevronRight className=\"size-3.5 shrink-0 text-muted-foreground/50\" aria-hidden />\n      {sectionIsLast ? (\n        <span className={CRUMB_CURRENT}>{view.label}</span>\n      ) : (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: view.id }}\n          className={CRUMB_LINK}\n        >\n          {view.label}\n        </Link>\n      )}\n      {extra.map((item, index) => {\n        const isLast = index === extra.length - 1\n        return (\n          <Row gap=\"1\" key={`${item.label}-${index}`} className=\"min-w-0\">\n            <ChevronRight className=\"size-3.5 shrink-0 text-muted-foreground/50\" aria-hidden />\n            {!isLast && item.to ? (\n              // `to` and `params` are always contributed as a unit (the type\n              // pairs them); the assertion satisfies the route's required params.\n              <Link to={item.to} params={item.params!} className={CRUMB_LINK}>\n                {item.label}\n              </Link>\n            ) : (\n              <span className={isLast ? CRUMB_CURRENT : CRUMB_LINK}>{item.label}</span>\n            )}\n          </Row>\n        )\n      })}\n    </Row>\n  )\n}\n"]}
+{"version":3,"file":"studio-shell.js","sourceRoot":"","sources":["../../src/components/studio-shell.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router'\nimport { ChevronRight } from 'lucide-react'\nimport { useCallback, useEffect, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { Project, ProjectId } from '@elytracms/core/studio-core'\nimport { Row, Spacer, Toaster } from '@elytracms/studio/ui'\nimport { readRailCollapsed, storeRailCollapsed } from '@elytracms/studio/lib/rail'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { CurrentUserMenu } from './current-user-menu'\nimport { DeliveryHealthBanner } from './delivery-health-banner'\nimport { PlaygroundBadge } from './playground-badge'\nimport { DevLoginBadge } from './dev-login-badge'\nimport { ProjectSwitcher } from './project-switcher'\nimport { SectionNav } from './section-nav'\nimport { activeViewIdFromPath, useStudioNav } from './app-views/sidebar'\nimport { BreadcrumbProvider, useBreadcrumbTrail } from './breadcrumb-context'\n\nexport interface StudioShellProps {\n  project: Project\n  children: ReactNode\n}\n\n/**\n * The Studio shell (brief §4.3, §8.1): a persistent top bar + section rail that\n * preserve the active project while the user moves between surfaces. The top bar\n * carries the single global breadcrumb reaching the active record (EC-214) — no\n * secondary band, no per-view title repeating the section. Responsive and\n * overflow-safe.\n */\nexport function StudioShell({ project, children }: StudioShellProps) {\n  const { pathname } = useLocation()\n  const activeViewId = activeViewIdFromPath(pathname)\n\n  // User-toggled, persisted rail collapse (EC-214). Defaults to expanded; the\n  // stored preference is read after mount (no flash script needed for a rail).\n  const [railCollapsed, setRailCollapsed] = useState(false)\n  useEffect(() => {\n    setRailCollapsed(readRailCollapsed())\n  }, [])\n  const toggleRail = useCallback(() => {\n    setRailCollapsed((prev) => {\n      const next = !prev\n      storeRailCollapsed(next)\n      return next\n    })\n  }, [])\n\n  return (\n    <BreadcrumbProvider>\n      <div className=\"flex h-dvh flex-col bg-background\">\n        {/* Top bar — global controls + the one breadcrumb to the active record. */}\n        <header className=\"flex h-12 shrink-0 items-center gap-2 border-b border-border px-3\">\n          <Link to=\"/\" className=\"grid size-6 shrink-0 place-items-center\" aria-label={translate('shell.allProjects')}>\n            <span className=\"size-5 rounded-[5px] bg-primary shadow-sm\" />\n          </Link>\n          <ProjectSwitcher activeProject={project} />\n          <HeaderBreadcrumb project={project} activeViewId={activeViewId} />\n          <Spacer />\n          {/* EC-153: explicit playground-mode marker (renders nothing on Convex). */}\n          <PlaygroundBadge />\n          {/* Dev-only unattended-auth marker (renders nothing in prod / when unset). */}\n          <DevLoginBadge />\n          {/* EC-150: signed-in user + their role on this project + sign-out. */}\n          <CurrentUserMenu projectId={project.id} />\n        </header>\n\n        {/* EC-268: warns when instant-publish env is incomplete (connected mode only). */}\n        <DeliveryHealthBanner projectId={project.id} />\n\n        <div className=\"flex min-h-0 flex-1\">\n          <SectionNav\n            project={project}\n            collapsed={railCollapsed}\n            onToggleCollapsed={toggleRail}\n          />\n\n          <main className=\"flex min-w-0 flex-1 flex-col overflow-hidden\">\n            <div className=\"min-h-0 flex-1 overflow-auto\">{children}</div>\n          </main>\n        </div>\n      </div>\n      {/* EC-268: transient action feedback (e.g. a publish that fails at transport). */}\n      <Toaster />\n    </BreadcrumbProvider>\n  )\n}\n\nconst CRUMB_LINK =\n  'max-w-[12rem] truncate text-muted-foreground transition-colors hover:text-foreground'\nconst CRUMB_CURRENT = 'max-w-[16rem] truncate font-medium text-foreground'\n\n/**\n * The single global breadcrumb (EC-214): project (the switcher) › section › …the\n * active record. The section crumb is the active VIEW's label (EC-237/239, resolved\n * from the rail-derived registry); deeper crumbs are contributed by the active\n * surface via {@link useBreadcrumbTrail}. The last crumb is the current page (plain\n * text); earlier crumbs link back.\n */\nfunction HeaderBreadcrumb({\n  project,\n  activeViewId,\n}: {\n  project: Project\n  activeViewId: string | null\n}) {\n  const projectId: ProjectId = project.id\n  const nav = useStudioNav(project)\n  const extra = useBreadcrumbTrail()\n  const view = activeViewId ? nav.registry.get(activeViewId) : undefined\n  if (!view) return null\n  const sectionIsLast = extra.length === 0\n\n  return (\n    <Row gap=\"1\" className=\"min-w-0 text-sm\" aria-label={translate('shell.breadcrumb.label')}>\n      <ChevronRight className=\"size-3.5 shrink-0 text-muted-foreground/50\" aria-hidden />\n      {sectionIsLast ? (\n        <span className={CRUMB_CURRENT}>{view.label}</span>\n      ) : (\n        <Link\n          to={STUDIO_PROJECT_ROUTE}\n          params={{ projectId, _splat: view.id }}\n          className={CRUMB_LINK}\n        >\n          {view.label}\n        </Link>\n      )}\n      {extra.map((item, index) => {\n        const isLast = index === extra.length - 1\n        return (\n          <Row gap=\"1\" key={`${item.label}-${index}`} className=\"min-w-0\">\n            <ChevronRight className=\"size-3.5 shrink-0 text-muted-foreground/50\" aria-hidden />\n            {!isLast && item.to ? (\n              // `to` and `params` are always contributed as a unit (the type\n              // pairs them); the assertion satisfies the route's required params.\n              <Link to={item.to} params={item.params!} className={CRUMB_LINK}>\n                {item.label}\n              </Link>\n            ) : (\n              <span className={isLast ? CRUMB_CURRENT : CRUMB_LINK}>{item.label}</span>\n            )}\n          </Row>\n        )\n      })}\n    </Row>\n  )\n}\n"]}

package/dist/components/theme-context.d.ts

@@ -11,7 +11,8 @@ export interface ThemeStore {
     setTheme: (theme: Theme) => void;
     toggle: () => void;
 }
+declare const useTheme: () => ThemeStore;
 export declare function ThemeProvider({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
-export declare function useTheme(): ThemeStore;
+export { useTheme };

package/dist/components/theme-context.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { DEFAULT_THEME, applyTheme, readStoredTheme, storeTheme } from '@elytracms/studio/lib/theme';
-const ThemeContext = createContext(null);
+import { createRequiredContext } from '@elytracms/studio/lib/required-context';
+const { Context: ThemeContext, useRequired: useTheme } = createRequiredContext('Theme');
 export function ThemeProvider({ children }) {
     const [theme, setThemeState] = useState(DEFAULT_THEME);
     // Sync state to whatever the pre-hydration script already applied.
@@ -17,10 +18,5 @@ export function ThemeProvider({ children }) {
     const store = useMemo(() => ({ theme, setTheme, toggle: () => setTheme(theme === 'dark' ? 'light' : 'dark') }), [theme, setTheme]);
     return _jsx(ThemeContext.Provider, { value: store, children: children });
 }
-export function useTheme() {
-    const store = useContext(ThemeContext);
-    if (!store)
-        throw new Error('useTheme must be used within a <ThemeProvider>.');
-    return store;
-}
+export { useTheme };
 //# sourceMappingURL=theme-context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme-context.js","sourceRoot":"","sources":["../../src/components/theme-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE5F,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAepG,MAAM,YAAY,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAA;AAE3D,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAA2B;IACjE,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAQ,aAAa,CAAC,CAAA;IAE7D,mEAAmE;IACnE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,aAAa,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACnG,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAAW,EAAE,EAAE;QAC3C,aAAa,CAAC,IAAI,CAAC,CAAA;QACnB,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IAC5C,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EACxF,CAAC,KAAK,EAAE,QAAQ,CAAC,CAClB,CAAA;IAED,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAC9E,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { DEFAULT_THEME, applyTheme, readStoredTheme, storeTheme } from '@elytracms/studio/lib/theme'\nimport type { Theme } from '@elytracms/studio/lib/theme'\n\n/**\n * Theme store: owns the active light/dark theme, persists the choice, and keeps\n * the `dark` class on the document element in sync. The pre-hydration script\n * (THEME_INIT_SCRIPT) sets the initial class; this provider syncs React state to\n * it on mount so toggling is reactive.\n */\nexport interface ThemeStore {\n  theme: Theme\n  setTheme: (theme: Theme) => void\n  toggle: () => void\n}\n\nconst ThemeContext = createContext<ThemeStore | null>(null)\n\nexport function ThemeProvider({ children }: { children: ReactNode }) {\n  const [theme, setThemeState] = useState<Theme>(DEFAULT_THEME)\n\n  // Sync state to whatever the pre-hydration script already applied.\n  useEffect(() => {\n    const stored = readStoredTheme()\n    setThemeState(stored ?? (document.documentElement.classList.contains('dark') ? 'dark' : 'light'))\n  }, [])\n\n  const setTheme = useCallback((next: Theme) => {\n    setThemeState(next)\n    storeTheme(next)\n    applyTheme(next, document.documentElement)\n  }, [])\n\n  const store = useMemo<ThemeStore>(\n    () => ({ theme, setTheme, toggle: () => setTheme(theme === 'dark' ? 'light' : 'dark') }),\n    [theme, setTheme],\n  )\n\n  return <ThemeContext.Provider value={store}>{children}</ThemeContext.Provider>\n}\n\nexport function useTheme(): ThemeStore {\n  const store = useContext(ThemeContext)\n  if (!store) throw new Error('useTheme must be used within a <ThemeProvider>.')\n  return store\n}\n"]}
+{"version":3,"file":"theme-context.js","sourceRoot":"","sources":["../../src/components/theme-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEjE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAEpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAA;AAc9E,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAAa,OAAO,CAAC,CAAA;AAEnG,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAA2B;IACjE,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAQ,aAAa,CAAC,CAAA;IAE7D,mEAAmE;IACnE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,aAAa,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACnG,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAAW,EAAE,EAAE;QAC3C,aAAa,CAAC,IAAI,CAAC,CAAA;QACnB,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IAC5C,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EACxF,CAAC,KAAK,EAAE,QAAQ,CAAC,CAClB,CAAA;IAED,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAA;AAChF,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA","sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { DEFAULT_THEME, applyTheme, readStoredTheme, storeTheme } from '@elytracms/studio/lib/theme'\nimport type { Theme } from '@elytracms/studio/lib/theme'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\n/**\n * Theme store: owns the active light/dark theme, persists the choice, and keeps\n * the `dark` class on the document element in sync. The pre-hydration script\n * (THEME_INIT_SCRIPT) sets the initial class; this provider syncs React state to\n * it on mount so toggling is reactive.\n */\nexport interface ThemeStore {\n  theme: Theme\n  setTheme: (theme: Theme) => void\n  toggle: () => void\n}\n\nconst { Context: ThemeContext, useRequired: useTheme } = createRequiredContext<ThemeStore>('Theme')\n\nexport function ThemeProvider({ children }: { children: ReactNode }) {\n  const [theme, setThemeState] = useState<Theme>(DEFAULT_THEME)\n\n  // Sync state to whatever the pre-hydration script already applied.\n  useEffect(() => {\n    const stored = readStoredTheme()\n    setThemeState(stored ?? (document.documentElement.classList.contains('dark') ? 'dark' : 'light'))\n  }, [])\n\n  const setTheme = useCallback((next: Theme) => {\n    setThemeState(next)\n    storeTheme(next)\n    applyTheme(next, document.documentElement)\n  }, [])\n\n  const store = useMemo<ThemeStore>(\n    () => ({ theme, setTheme, toggle: () => setTheme(theme === 'dark' ? 'light' : 'dark') }),\n    [theme, setTheme],\n  )\n\n  return <ThemeContext.Provider value={store}>{children}</ThemeContext.Provider>\n}\n\nexport { useTheme }\n"]}

package/dist/components/use-hydration-phase.d.ts

@@ -0,0 +1,65 @@
+import type { ReactNode } from 'react';
+import type { OperationError, OperationResult } from '@elytracms/studio/lib/operations';
+/**
+ * The shared hydration state machine (EC-329) behind both
+ * `ProjectSessionProvider` and `CmsSessionGate`: playground short-circuit,
+ * phase union, attempt-driven retry, cancelled-flag cleanup — a specific
+ * multi-part shape the two providers used to hand-roll identically. Real
+ * asymmetries between them stay explicit HOOK OPTIONS rather than being
+ * flattened away:
+ *
+ * - `ProjectSessionProvider`'s playground branch calls its `onResolved` side
+ *   effect (`configureContentSession(null)`); `CmsSessionGate` passes no
+ *   `onResolved` at all (it owns no such side effect — `loadCms`'s own body
+ *   already calls it). `enabled` toggles whether `onResolved` fires in the
+ *   playground fast-path — the ONE point of divergence between the two.
+ * - `onResolved` runs synchronously BEFORE the phase flips to `'ready'` (both
+ *   the playground fast-path and the real load), so children reading a
+ *   module global (e.g. `configureContentSession`) see it updated on the
+ *   SAME render they first see `'ready'` — a bare `loader().then(setPhase)`
+ *   cannot guarantee that ordering.
+ */
+export type HydrationPhase<T> = {
+    kind: 'loading';
+} | {
+    kind: 'ready';
+    value: T;
+} | {
+    kind: 'error';
+    error: OperationError;
+};
+export interface UseHydrationPhaseOptions<T> {
+    /** Playground (fixture) sessions resolve synchronously to `playgroundValue` — no loader call. */
+    playground: boolean;
+    /** The value `phase` resolves to in playground mode. */
+    playgroundValue: T;
+    /** Call `onResolved` for the playground fast-path too (default `false`). */
+    enabled?: boolean;
+    /**
+     * Run synchronously before the phase flips to `'ready'` — in BOTH the
+     * playground fast-path (when `enabled`) and the real load. Read via a ref
+     * internally, so an inline (non-memoized) callback never re-triggers a fetch.
+     */
+    onResolved?: (value: T) => void;
+}
+export interface UseHydrationPhaseResult<T> {
+    phase: HydrationPhase<T>;
+    /** Re-run the loader (the retry button's handler). */
+    retry: () => void;
+}
+/**
+ * `loader`'s IDENTITY is the refetch trigger — memoize it (`useCallback`) over
+ * whatever inputs should re-hydrate (e.g. `projectId`), exactly like the
+ * original two effects keyed their dependency arrays.
+ */
+export declare function useHydrationPhase<T>(loader: () => Promise<OperationResult<T>>, options: UseHydrationPhaseOptions<T>): UseHydrationPhaseResult<T>;
+/**
+ * Renders `phase`'s loading/error frames, or `children(value)` once ready —
+ * the identical 3-way branch both `ProjectSessionProvider` and
+ * `CmsSessionGate` used to repeat verbatim.
+ */
+export declare function HydrationBoundary<T>({ phase, retry, children, }: {
+    phase: HydrationPhase<T>;
+    retry: () => void;
+    children: (value: T) => ReactNode;
+}): ReactNode;

package/dist/components/use-hydration-phase.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Button, Stack, Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+import { OperationErrorBanner } from './operation-error';
+/**
+ * `loader`'s IDENTITY is the refetch trigger — memoize it (`useCallback`) over
+ * whatever inputs should re-hydrate (e.g. `projectId`), exactly like the
+ * original two effects keyed their dependency arrays.
+ */
+export function useHydrationPhase(loader, options) {
+    const { playground, playgroundValue, enabled = false } = options;
+    const onResolvedRef = useRef(options.onResolved);
+    onResolvedRef.current = options.onResolved;
+    const [phase, setPhase] = useState(() => playground ? { kind: 'ready', value: playgroundValue } : { kind: 'loading' });
+    const [attempt, setAttempt] = useState(0);
+    useEffect(() => {
+        if (playground) {
+            if (enabled)
+                onResolvedRef.current?.(playgroundValue);
+            return;
+        }
+        let cancelled = false;
+        setPhase({ kind: 'loading' });
+        void loader().then((result) => {
+            if (cancelled)
+                return;
+            if (!result.ok) {
+                setPhase({ kind: 'error', error: result.error });
+                return;
+            }
+            onResolvedRef.current?.(result.value);
+            setPhase({ kind: 'ready', value: result.value });
+        });
+        return () => {
+            cancelled = true;
+        };
+        // `onResolved` is read via the ref above (see the doc comment) — its
+        // identity intentionally does not retrigger this effect.
+    }, [loader, playground, attempt, enabled, playgroundValue]);
+    const retry = useCallback(() => setAttempt((n) => n + 1), []);
+    return { phase, retry };
+}
+/**
+ * Renders `phase`'s loading/error frames, or `children(value)` once ready —
+ * the identical 3-way branch both `ProjectSessionProvider` and
+ * `CmsSessionGate` used to repeat verbatim.
+ */
+export function HydrationBoundary({ phase, retry, children, }) {
+    if (phase.kind === 'loading')
+        return _jsx(SessionHydrating, {});
+    if (phase.kind === 'error')
+        return _jsx(SessionHydrationError, { error: phase.error, onRetry: retry });
+    return _jsx(_Fragment, { children: children(phase.value) });
+}
+/** Deterministic loading frame while persisted state is fetched (mirrors BackendGate). */
+function SessionHydrating() {
+    return (_jsx("div", { className: "grid h-full min-h-64 flex-1 place-items-center p-8", "data-testid": "session-hydrating", children: _jsx(Text, { size: "sm", tone: "muted", children: translate('shell.session.loading') }) }));
+}
+/** A failed hydration is a visible, retryable state — never a fixture fallback. */
+function SessionHydrationError({ error, onRetry, }) {
+    return (_jsx("div", { className: "grid h-full min-h-64 flex-1 place-items-center p-8", children: _jsxs(Stack, { gap: "3", className: "w-full max-w-xl", children: [_jsx(Text, { size: "sm", weight: "semibold", children: translate('shell.session.error.title') }), _jsx(OperationErrorBanner, { error: error }), _jsx(Text, { size: "xs", tone: "muted", children: translate('shell.session.error.body') }), _jsx(Button, { variant: "outline", size: "sm", onClick: onRetry, className: "self-start", children: translate('common.retry') })] }) }));
+}
+//# sourceMappingURL=use-hydration-phase.js.map

package/dist/components/use-hydration-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hydration-phase.js","sourceRoot":"","sources":["../../src/components/use-hydration-phase.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { Button, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport type { OperationError, OperationResult } from '@elytracms/studio/lib/operations'\nimport { OperationErrorBanner } from './operation-error'\n\n/**\n * The shared hydration state machine (EC-329) behind both\n * `ProjectSessionProvider` and `CmsSessionGate`: playground short-circuit,\n * phase union, attempt-driven retry, cancelled-flag cleanup — a specific\n * multi-part shape the two providers used to hand-roll identically. Real\n * asymmetries between them stay explicit HOOK OPTIONS rather than being\n * flattened away:\n *\n * - `ProjectSessionProvider`'s playground branch calls its `onResolved` side\n *   effect (`configureContentSession(null)`); `CmsSessionGate` passes no\n *   `onResolved` at all (it owns no such side effect — `loadCms`'s own body\n *   already calls it). `enabled` toggles whether `onResolved` fires in the\n *   playground fast-path — the ONE point of divergence between the two.\n * - `onResolved` runs synchronously BEFORE the phase flips to `'ready'` (both\n *   the playground fast-path and the real load), so children reading a\n *   module global (e.g. `configureContentSession`) see it updated on the\n *   SAME render they first see `'ready'` — a bare `loader().then(setPhase)`\n *   cannot guarantee that ordering.\n */\nexport type HydrationPhase<T> =\n  | { kind: 'loading' }\n  | { kind: 'ready'; value: T }\n  | { kind: 'error'; error: OperationError }\n\nexport interface UseHydrationPhaseOptions<T> {\n  /** Playground (fixture) sessions resolve synchronously to `playgroundValue` — no loader call. */\n  playground: boolean\n  /** The value `phase` resolves to in playground mode. */\n  playgroundValue: T\n  /** Call `onResolved` for the playground fast-path too (default `false`). */\n  enabled?: boolean\n  /**\n   * Run synchronously before the phase flips to `'ready'` — in BOTH the\n   * playground fast-path (when `enabled`) and the real load. Read via a ref\n   * internally, so an inline (non-memoized) callback never re-triggers a fetch.\n   */\n  onResolved?: (value: T) => void\n}\n\nexport interface UseHydrationPhaseResult<T> {\n  phase: HydrationPhase<T>\n  /** Re-run the loader (the retry button's handler). */\n  retry: () => void\n}\n\n/**\n * `loader`'s IDENTITY is the refetch trigger — memoize it (`useCallback`) over\n * whatever inputs should re-hydrate (e.g. `projectId`), exactly like the\n * original two effects keyed their dependency arrays.\n */\nexport function useHydrationPhase<T>(\n  loader: () => Promise<OperationResult<T>>,\n  options: UseHydrationPhaseOptions<T>,\n): UseHydrationPhaseResult<T> {\n  const { playground, playgroundValue, enabled = false } = options\n  const onResolvedRef = useRef(options.onResolved)\n  onResolvedRef.current = options.onResolved\n\n  const [phase, setPhase] = useState<HydrationPhase<T>>(() =>\n    playground ? { kind: 'ready', value: playgroundValue } : { kind: 'loading' },\n  )\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    if (playground) {\n      if (enabled) onResolvedRef.current?.(playgroundValue)\n      return\n    }\n    let cancelled = false\n    setPhase({ kind: 'loading' })\n    void loader().then((result) => {\n      if (cancelled) return\n      if (!result.ok) {\n        setPhase({ kind: 'error', error: result.error })\n        return\n      }\n      onResolvedRef.current?.(result.value)\n      setPhase({ kind: 'ready', value: result.value })\n    })\n    return () => {\n      cancelled = true\n    }\n    // `onResolved` is read via the ref above (see the doc comment) — its\n    // identity intentionally does not retrigger this effect.\n  }, [loader, playground, attempt, enabled, playgroundValue])\n\n  const retry = useCallback(() => setAttempt((n) => n + 1), [])\n  return { phase, retry }\n}\n\n/**\n * Renders `phase`'s loading/error frames, or `children(value)` once ready —\n * the identical 3-way branch both `ProjectSessionProvider` and\n * `CmsSessionGate` used to repeat verbatim.\n */\nexport function HydrationBoundary<T>({\n  phase,\n  retry,\n  children,\n}: {\n  phase: HydrationPhase<T>\n  retry: () => void\n  children: (value: T) => ReactNode\n}): ReactNode {\n  if (phase.kind === 'loading') return <SessionHydrating />\n  if (phase.kind === 'error') return <SessionHydrationError error={phase.error} onRetry={retry} />\n  return <>{children(phase.value)}</>\n}\n\n/** Deterministic loading frame while persisted state is fetched (mirrors BackendGate). */\nfunction SessionHydrating() {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\" data-testid=\"session-hydrating\">\n      <Text size=\"sm\" tone=\"muted\">\n        {translate('shell.session.loading')}\n      </Text>\n    </div>\n  )\n}\n\n/** A failed hydration is a visible, retryable state — never a fixture fallback. */\nfunction SessionHydrationError({\n  error,\n  onRetry,\n}: {\n  error: OperationError\n  onRetry: () => void\n}) {\n  return (\n    <div className=\"grid h-full min-h-64 flex-1 place-items-center p-8\">\n      <Stack gap=\"3\" className=\"w-full max-w-xl\">\n        <Text size=\"sm\" weight=\"semibold\">\n          {translate('shell.session.error.title')}\n        </Text>\n        <OperationErrorBanner error={error} />\n        <Text size=\"xs\" tone=\"muted\">\n          {translate('shell.session.error.body')}\n        </Text>\n        <Button variant=\"outline\" size=\"sm\" onClick={onRetry} className=\"self-start\">\n          {translate('common.retry')}\n        </Button>\n      </Stack>\n    </div>\n  )\n}\n"]}

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

@@ -1,6 +1,14 @@
 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';
+import type { CollectionViewCapabilities, CollectionViewSource, FieldAccess } from '@elytracms/studio/lib/collection-view/collection-view-source';
+/**
+ * The capability profile of the users rail (EC-240): admin-only, no
+ * publish/versions/create/import (identities are minted by sign-up and their
+ * bytes are auth-owned), remove allowed (revoke membership). Hoisted to a
+ * module-level constant (no prop/state dependency, EC-327) — mirrors
+ * `ASSET_COLLECTION_CAPABILITIES`.
+ */
+export declare const USER_COLLECTION_CAPABILITIES: CollectionViewCapabilities;
 /** Project the auth-identity + membership join into the lens's `values` shape. */
 export declare function userToDocument(record: UserRecord): CmsDocument;
 /**
@@ -24,5 +32,9 @@ export declare function documentToSaveInput(doc: CmsDocument): SaveUserInput;
  * read-only; an admin edits a member's role (and future custom `meta` fields).
  *
  * Must be mounted under a `UsersProvider` (for {@link useUsers}).
+ *
+ * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`
+ * plumbing and the assembled source; this hook supplies only the users-store
+ * reads/writes, the capability profile, and the principal-based `fieldAccess`.
  */
 export declare function useUsersCollectionViewSource(projectId: string): CollectionViewSource;

package/dist/components/users/users-collection-view-source.js

@@ -1,12 +1,32 @@
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback } from 'react';
 import { studioPath } from '@elytracms/studio/router';
-import { defaultViewState } from '@elytracms/studio/lib/cms-views';
 import { useAuth } from '../auth-context';
 import { useUsers } from './users-store';
 import { usersCollectionDef } from './users-schema';
+import { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source';
 /** The users rail is not localized — one implicit locale keeps the lens honest. */
 const USERS_LOCALE = 'en';
 const USERS_LOCALE_CONFIG = { default: USERS_LOCALE, locales: [USERS_LOCALE] };
+/**
+ * The capability profile of the users rail (EC-240): admin-only, no
+ * publish/versions/create/import (identities are minted by sign-up and their
+ * bytes are auth-owned), remove allowed (revoke membership). Hoisted to a
+ * module-level constant (no prop/state dependency, EC-327) — mirrors
+ * `ASSET_COLLECTION_CAPABILITIES`.
+ */
+export const USER_COLLECTION_CAPABILITIES = {
+    publish: false,
+    versions: false,
+    locales: false,
+    inlineEdit: false,
+    create: false, // identities are minted by sign-up, never here
+    remove: true, // revoke membership (does not delete the auth identity)
+    bulk: false,
+    liveUrl: false,
+    hierarchy: false,
+    importExport: false, // credential records are never dumped to raw JSON
+    adminOnly: true,
+};
 /** The built-in field names — everything else in `values` is a custom `meta` field. */
 const IDENTITY_FIELDS = new Set(['name', 'email', 'role']);
 /** Project the auth-identity + membership join into the lens's `values` shape. */
@@ -41,14 +61,21 @@ export function userFieldAccess(field, record, currentUserId) {
 /** Map an edited lens document back to the write contract (role + custom `meta`). */
 export function documentToSaveInput(doc) {
     const values = doc.values ?? {};
-    const meta = {};
-    for (const [key, value] of Object.entries(values)) {
-        if (!IDENTITY_FIELDS.has(key))
-            meta[key] = value;
-    }
+    const meta = metaBagProjection(values, IDENTITY_FIELDS);
     const role = typeof values.role === 'string' ? values.role : 'viewer';
     return { id: doc.id, roles: [role], ...(Object.keys(meta).length > 0 ? { meta } : {}) };
 }
+/** `validate` for the users rail: no-op — a member's identity fields aren't
+ *  schema-validated the way CMS documents are (240a-era; a registry-driven
+ *  validation may land alongside a future custom-field schema). */
+function noValidation() {
+    return [];
+}
+/** `create` when `capabilities.create === false` — never reached (identities
+ *  are minted by sign-up, not the users rail). */
+function createUnsupported() {
+    throw new Error('users are created by sign-up, not the users rail');
+}
 /**
  * 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`
@@ -59,6 +86,10 @@ export function documentToSaveInput(doc) {
  * read-only; an admin edits a member's role (and future custom `meta` fields).
  *
  * Must be mounted under a `UsersProvider` (for {@link useUsers}).
+ *
+ * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`
+ * plumbing and the assembled source; this hook supplies only the users-store
+ * reads/writes, the capability profile, and the principal-based `fieldAccess`.
  */
 export function useUsersCollectionViewSource(projectId) {
     const users = useUsers();
@@ -66,8 +97,6 @@ export function useUsersCollectionViewSource(projectId) {
     // their OWN record (self ≠ other; the server floor enforces it regardless).
     const auth = useAuth();
     const currentUserId = auth.session?.user?.id;
-    const [viewState, setViewStateRaw] = useState(() => defaultViewState(usersCollectionDef));
-    const [lastError, setLastError] = useState(null);
     const documents = useCallback(() => users.users.map(userToDocument), [users.users]);
     const get = useCallback((ref) => {
         const record = users.users.find((u) => u.id === ref.id);
@@ -77,81 +106,33 @@ export function useUsersCollectionViewSource(projectId) {
         const record = users.users.find((u) => u.id === ref.id);
         return record?.name || record?.email || ref.id;
     }, [users.users]);
-    const setViewState = useCallback((update) => {
-        setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update));
-    }, []);
-    const save = useCallback((doc) => {
-        void users.save(documentToSaveInput(doc)).then((result) => {
-            if (!result.ok)
-                setLastError({ code: 'unknown', message: result.message });
-        });
-    }, [users]);
-    const remove = useCallback((ref) => {
-        void users.remove(ref.id).then((result) => {
-            if (!result.ok)
-                setLastError({ code: 'unknown', message: result.message });
-        });
-    }, [users]);
-    return useMemo(() => {
-        const capabilities = {
-            publish: false,
-            versions: false,
-            locales: false,
-            inlineEdit: false,
-            create: false, // identities are minted by sign-up, never here
-            remove: true, // revoke membership (does not delete the auth identity)
-            bulk: false,
-            liveUrl: false,
-            hierarchy: false,
-            importExport: false, // credential records are never dumped to raw JSON
-            adminOnly: true,
-        };
-        const source = {
-            collectionId: usersCollectionDef.id,
-            schema: usersCollectionDef,
-            capabilities,
-            projectId,
-            localeConfig: USERS_LOCALE_CONFIG,
-            activeLocale: USERS_LOCALE,
-            documents,
-            get,
-            titleOf,
-            // Users carry no relation fields in v1, so there are no cross-collection
-            // candidates to resolve; the lens is the only collection in scope.
-            referenceCandidates: () => [],
-            collections: [usersCollectionDef],
-            // The users rail now has a per-member detail surface (EC-240): rows link to
-            // it, and the edit shell's back-crumb / post-delete nav return to the list.
-            detailPath: (id) => studioPath.user(id),
-            listPath: studioPath.users(),
-            isFieldReadOnly: (field) => field.form?.readOnly ?? false,
-            // Principal-based tri-state: `role` is read-only for self, editable for an
-            // admin acting on another; identity fields follow their schema readOnly.
-            fieldAccess: (field, record) => userFieldAccess(field, record, currentUserId),
-            validate: () => [],
-            lastError,
-            clearLastError: () => setLastError(null),
-            viewState: () => viewState,
-            setViewState,
-            // create is gated off (capabilities.create === false); never reached.
-            create: () => {
-                throw new Error('users are created by sign-up, not the users rail');
-            },
-            save,
-            remove,
-        };
-        return source;
-    }, [
+    const fieldAccess = useCallback((field, record) => userFieldAccess(field, record, currentUserId), [currentUserId]);
+    const save = useCallback((doc) => users.save(documentToSaveInput(doc)), [users]);
+    const remove = useCallback((ref) => users.remove(ref.id), [users]);
+    return useRailViewSource({
         projectId,
-        currentUserId,
+        schema: usersCollectionDef,
+        capabilities: USER_COLLECTION_CAPABILITIES,
+        localeConfig: USERS_LOCALE_CONFIG,
         documents,
         get,
         titleOf,
-        setViewState,
+        // No `referenceCandidates`/`collections` override: users carry no relation
+        // fields in v1, so there are no cross-collection candidates to resolve; the
+        // lens is the only collection in scope (both factory defaults apply).
+        // The users rail now has a per-member detail surface (EC-240): rows link to
+        // it, and the edit shell's back-crumb / post-delete nav return to the list.
+        detailPath: (id) => studioPath.user(id),
+        listPath: studioPath.users(),
+        // Principal-based tri-state: `role` is read-only for self, editable for an
+        // admin acting on another; identity fields follow their schema readOnly.
+        fieldAccess,
+        validate: noValidation,
+        create: createUnsupported,
         save,
         remove,
-        viewState,
-        lastError,
-    ]);
+        normalizeSaveResult: normalizeOkResult,
+        normalizeRemoveResult: normalizeOkResult,
+    });
 }
 //# sourceMappingURL=users-collection-view-source.js.map

package/dist/components/users/users-collection-view-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"users-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/users/users-collection-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type { CmsDocument, DocumentRef, FieldDef, Locale, LocaleConfig } from '@elytracms/core/cms-core'\nimport type { ProjectRole, SaveUserInput, UserRecord } from '@elytracms/core/persistence'\nimport type { OperationError } from '@elytracms/core/operations'\nimport { studioPath } from '@elytracms/studio/router'\nimport { defaultViewState } from '@elytracms/studio/lib/cms-views'\nimport type { TableViewState } from '@elytracms/studio/lib/cms-views'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n  FieldAccess,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useAuth } from '../auth-context'\nimport { useUsers } from './users-store'\nimport { usersCollectionDef } from './users-schema'\n\n/** The users rail is not localized — one implicit locale keeps the lens honest. */\nconst USERS_LOCALE: Locale = 'en'\nconst USERS_LOCALE_CONFIG: LocaleConfig = { default: USERS_LOCALE, locales: [USERS_LOCALE] }\n\n/** The built-in field names — everything else in `values` is a custom `meta` field. */\nconst IDENTITY_FIELDS = new Set(['name', 'email', 'role'])\n\n/** Project the auth-identity + membership join into the lens's `values` shape. */\nexport function userToDocument(record: UserRecord): CmsDocument {\n  return {\n    collection: usersCollectionDef.id,\n    id: record.id,\n    values: {\n      // Display title falls through empties (name → email → id) so a nameless,\n      // blank-email member never renders as a blank row; `email` keeps its real value.\n      name: record.name || record.email || record.id,\n      email: record.email,\n      role: record.roles[0] ?? 'viewer',\n      ...(record.meta ?? {}),\n    },\n  }\n}\n\n/**\n * Principal-based field access for the users rail (EC-240, AD-18). `role` is\n * authority: **read-only when you are editing YOURSELF** — you don't change your\n * own role (the server integrity floor also guards it) — and **editable otherwise**\n * (the rail is admin-only, so a non-self editor is an admin acting on someone else).\n * Identity fields (name/email) follow their schema `form.readOnly`; everything else\n * is editable. Pure, so the self/other rule is unit-testable without the auth hook.\n */\nexport function userFieldAccess(\n  field: FieldDef,\n  record: CmsDocument | undefined,\n  currentUserId: string | undefined,\n): FieldAccess {\n  if (field.name === 'role') {\n    return record?.id === currentUserId ? 'read' : 'edit'\n  }\n  return field.form?.readOnly ? 'read' : 'edit'\n}\n\n/** Map an edited lens document back to the write contract (role + custom `meta`). */\nexport function documentToSaveInput(doc: CmsDocument): SaveUserInput {\n  const values = doc.values ?? {}\n  const meta: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(values)) {\n    if (!IDENTITY_FIELDS.has(key)) meta[key] = value\n  }\n  const role = typeof values.role === 'string' ? (values.role as ProjectRole) : 'viewer'\n  return { id: doc.id, roles: [role], ...(Object.keys(meta).length > 0 ? { meta } : {}) }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **users rail** (EC-240, AD-19) —\n * the reuse proof that the portable list/edit surfaces serve a non-`cmsDocuments`\n * rail. Mirrors {@link useCmsCollectionViewSource}, over the users store instead of\n * the CMS store, with the users capability profile: admin-only, no\n * publish/versions/create/import (identities are minted by sign-up and their bytes\n * are auth-owned), remove allowed (revoke membership). Identity fields are\n * read-only; an admin edits a member's role (and future custom `meta` fields).\n *\n * Must be mounted under a `UsersProvider` (for {@link useUsers}).\n */\nexport function useUsersCollectionViewSource(projectId: string): CollectionViewSource {\n  const users = useUsers()\n  // The signed-in principal — so `role` locks to read-only when an admin opens\n  // their OWN record (self ≠ other; the server floor enforces it regardless).\n  const auth = useAuth()\n  const currentUserId = auth.session?.user?.id\n  const [viewState, setViewStateRaw] = useState<TableViewState>(() =>\n    defaultViewState(usersCollectionDef),\n  )\n  const [lastError, setLastError] = useState<OperationError | null>(null)\n\n  const documents = useCallback(() => users.users.map(userToDocument), [users.users])\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = users.users.find((u) => u.id === ref.id)\n      return record ? userToDocument(record) : undefined\n    },\n    [users.users],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => {\n      const record = users.users.find((u) => u.id === ref.id)\n      return record?.name || record?.email || ref.id\n    },\n    [users.users],\n  )\n  const setViewState = useCallback<CollectionViewSource['setViewState']>((update) => {\n    setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update))\n  }, [])\n\n  const save = useCallback(\n    (doc: CmsDocument) => {\n      void users.save(documentToSaveInput(doc)).then((result) => {\n        if (!result.ok) setLastError({ code: 'unknown', message: result.message })\n      })\n    },\n    [users],\n  )\n  const remove = useCallback(\n    (ref: DocumentRef) => {\n      void users.remove(ref.id).then((result) => {\n        if (!result.ok) setLastError({ code: 'unknown', message: result.message })\n      })\n    },\n    [users],\n  )\n\n  return useMemo(() => {\n    const capabilities: CollectionViewCapabilities = {\n      publish: false,\n      versions: false,\n      locales: false,\n      inlineEdit: false,\n      create: false, // identities are minted by sign-up, never here\n      remove: true, // revoke membership (does not delete the auth identity)\n      bulk: false,\n      liveUrl: false,\n      hierarchy: false,\n      importExport: false, // credential records are never dumped to raw JSON\n      adminOnly: true,\n    }\n    const source: CollectionViewSource = {\n      collectionId: usersCollectionDef.id,\n      schema: usersCollectionDef,\n      capabilities,\n      projectId,\n      localeConfig: USERS_LOCALE_CONFIG,\n      activeLocale: USERS_LOCALE,\n      documents,\n      get,\n      titleOf,\n      // Users carry no relation fields in v1, so there are no cross-collection\n      // candidates to resolve; the lens is the only collection in scope.\n      referenceCandidates: () => [],\n      collections: [usersCollectionDef],\n      // The users rail now has a per-member detail surface (EC-240): rows link to\n      // it, and the edit shell's back-crumb / post-delete nav return to the list.\n      detailPath: (id: string) => studioPath.user(id),\n      listPath: studioPath.users(),\n      isFieldReadOnly: (field: FieldDef) => field.form?.readOnly ?? false,\n      // Principal-based tri-state: `role` is read-only for self, editable for an\n      // admin acting on another; identity fields follow their schema readOnly.\n      fieldAccess: (field: FieldDef, record?: CmsDocument): FieldAccess =>\n        userFieldAccess(field, record, currentUserId),\n      validate: () => [],\n      lastError,\n      clearLastError: () => setLastError(null),\n      viewState: () => viewState,\n      setViewState,\n      // create is gated off (capabilities.create === false); never reached.\n      create: () => {\n        throw new Error('users are created by sign-up, not the users rail')\n      },\n      save,\n      remove,\n    }\n    return source\n  }, [\n    projectId,\n    currentUserId,\n    documents,\n    get,\n    titleOf,\n    setViewState,\n    save,\n    remove,\n    viewState,\n    lastError,\n  ])\n}\n"]}
+{"version":3,"file":"users-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/users/users-collection-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback } from 'react'\nimport type { CmsDocument, CmsValidationIssue, DocumentRef, FieldDef, Locale, LocaleConfig } from '@elytracms/core/cms-core'\nimport type { ProjectRole, SaveUserInput, UserRecord } from '@elytracms/core/persistence'\nimport { studioPath } from '@elytracms/studio/router'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n  FieldAccess,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useAuth } from '../auth-context'\nimport { useUsers } from './users-store'\nimport { usersCollectionDef } from './users-schema'\nimport { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source'\n\n/** The users rail is not localized — one implicit locale keeps the lens honest. */\nconst USERS_LOCALE: Locale = 'en'\nconst USERS_LOCALE_CONFIG: LocaleConfig = { default: USERS_LOCALE, locales: [USERS_LOCALE] }\n\n/**\n * The capability profile of the users rail (EC-240): admin-only, no\n * publish/versions/create/import (identities are minted by sign-up and their\n * bytes are auth-owned), remove allowed (revoke membership). Hoisted to a\n * module-level constant (no prop/state dependency, EC-327) — mirrors\n * `ASSET_COLLECTION_CAPABILITIES`.\n */\nexport const USER_COLLECTION_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: false, // identities are minted by sign-up, never here\n  remove: true, // revoke membership (does not delete the auth identity)\n  bulk: false,\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false, // credential records are never dumped to raw JSON\n  adminOnly: true,\n}\n\n/** The built-in field names — everything else in `values` is a custom `meta` field. */\nconst IDENTITY_FIELDS = new Set(['name', 'email', 'role'])\n\n/** Project the auth-identity + membership join into the lens's `values` shape. */\nexport function userToDocument(record: UserRecord): CmsDocument {\n  return {\n    collection: usersCollectionDef.id,\n    id: record.id,\n    values: {\n      // Display title falls through empties (name → email → id) so a nameless,\n      // blank-email member never renders as a blank row; `email` keeps its real value.\n      name: record.name || record.email || record.id,\n      email: record.email,\n      role: record.roles[0] ?? 'viewer',\n      ...(record.meta ?? {}),\n    },\n  }\n}\n\n/**\n * Principal-based field access for the users rail (EC-240, AD-18). `role` is\n * authority: **read-only when you are editing YOURSELF** — you don't change your\n * own role (the server integrity floor also guards it) — and **editable otherwise**\n * (the rail is admin-only, so a non-self editor is an admin acting on someone else).\n * Identity fields (name/email) follow their schema `form.readOnly`; everything else\n * is editable. Pure, so the self/other rule is unit-testable without the auth hook.\n */\nexport function userFieldAccess(\n  field: FieldDef,\n  record: CmsDocument | undefined,\n  currentUserId: string | undefined,\n): FieldAccess {\n  if (field.name === 'role') {\n    return record?.id === currentUserId ? 'read' : 'edit'\n  }\n  return field.form?.readOnly ? 'read' : 'edit'\n}\n\n/** Map an edited lens document back to the write contract (role + custom `meta`). */\nexport function documentToSaveInput(doc: CmsDocument): SaveUserInput {\n  const values = doc.values ?? {}\n  const meta = metaBagProjection(values, IDENTITY_FIELDS)\n  const role = typeof values.role === 'string' ? (values.role as ProjectRole) : 'viewer'\n  return { id: doc.id, roles: [role], ...(Object.keys(meta).length > 0 ? { meta } : {}) }\n}\n\n/** `validate` for the users rail: no-op — a member's identity fields aren't\n *  schema-validated the way CMS documents are (240a-era; a registry-driven\n *  validation may land alongside a future custom-field schema). */\nfunction noValidation(): CmsValidationIssue[] {\n  return []\n}\n\n/** `create` when `capabilities.create === false` — never reached (identities\n *  are minted by sign-up, not the users rail). */\nfunction createUnsupported(): DocumentRef {\n  throw new Error('users are created by sign-up, not the users rail')\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **users rail** (EC-240, AD-19) —\n * the reuse proof that the portable list/edit surfaces serve a non-`cmsDocuments`\n * rail. Mirrors {@link useCmsCollectionViewSource}, over the users store instead of\n * the CMS store, with the users capability profile: admin-only, no\n * publish/versions/create/import (identities are minted by sign-up and their bytes\n * are auth-owned), remove allowed (revoke membership). Identity fields are\n * read-only; an admin edits a member's role (and future custom `meta` fields).\n *\n * Must be mounted under a `UsersProvider` (for {@link useUsers}).\n *\n * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`\n * plumbing and the assembled source; this hook supplies only the users-store\n * reads/writes, the capability profile, and the principal-based `fieldAccess`.\n */\nexport function useUsersCollectionViewSource(projectId: string): CollectionViewSource {\n  const users = useUsers()\n  // The signed-in principal — so `role` locks to read-only when an admin opens\n  // their OWN record (self ≠ other; the server floor enforces it regardless).\n  const auth = useAuth()\n  const currentUserId = auth.session?.user?.id\n\n  const documents = useCallback(() => users.users.map(userToDocument), [users.users])\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = users.users.find((u) => u.id === ref.id)\n      return record ? userToDocument(record) : undefined\n    },\n    [users.users],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => {\n      const record = users.users.find((u) => u.id === ref.id)\n      return record?.name || record?.email || ref.id\n    },\n    [users.users],\n  )\n  const fieldAccess = useCallback(\n    (field: FieldDef, record?: CmsDocument): FieldAccess => userFieldAccess(field, record, currentUserId),\n    [currentUserId],\n  )\n  const save = useCallback((doc: CmsDocument) => users.save(documentToSaveInput(doc)), [users])\n  const remove = useCallback((ref: DocumentRef) => users.remove(ref.id), [users])\n\n  return useRailViewSource({\n    projectId,\n    schema: usersCollectionDef,\n    capabilities: USER_COLLECTION_CAPABILITIES,\n    localeConfig: USERS_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    // No `referenceCandidates`/`collections` override: users carry no relation\n    // fields in v1, so there are no cross-collection candidates to resolve; the\n    // lens is the only collection in scope (both factory defaults apply).\n    // The users rail now has a per-member detail surface (EC-240): rows link to\n    // it, and the edit shell's back-crumb / post-delete nav return to the list.\n    detailPath: (id: string) => studioPath.user(id),\n    listPath: studioPath.users(),\n    // Principal-based tri-state: `role` is read-only for self, editable for an\n    // admin acting on another; identity fields follow their schema readOnly.\n    fieldAccess,\n    validate: noValidation,\n    create: createUnsupported,\n    save,\n    remove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeOkResult,\n  })\n}\n"]}

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

@@ -33,8 +33,9 @@ export interface UsersStore {
     /** Re-list from the backend (the public escape hatch). */
     refresh(): Promise<void>;
 }
+declare const useUsers: () => UsersStore;
 export declare function UsersProvider({ projectId, children, }: {
     projectId: string;
     children: ReactNode;
 }): import("react").JSX.Element;
-export declare function useUsers(): UsersStore;
+export { useUsers };