@elytracms/studio 0.0.53 → 0.0.55

package/dist/components/app-views/default-modules.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import type { LucideIcon } from 'lucide-react';
-import type { CollectionDef, CollectionFieldOverride, CollectionFormMeta } from '@elytracms/core/cms-core';
-import type { SectionId } from '@elytracms/core/studio-core';
+import type { CollectionDef, CollectionFieldOverride, CollectionFormMeta, LocaleConfig } from '@elytracms/core/cms-core';
+import type { Project, SectionId } from '@elytracms/core/studio-core';
 import type { InstantiatedKit } from '@elytracms/core/starter-kits';
 import type { HydratedCms } from '@elytracms/studio/lib/operations';
 import { type AppViewContext, type AppViewDeepLink, type AppViewModule, type NavPermission, type SidebarViewNode } from './module.js';
@@ -206,3 +206,17 @@ export declare const nav: {
  * without stubbing the env (same seam as `resolveBackendConfig`).
  */
 export declare function resolveCmsInitialCollections(cms: HydratedCms | null, kit: InstantiatedKit | undefined, playground?: boolean): CollectionDef[] | undefined;
+/**
+ * The CMS locale config for a project mount (EC-357 finding #3). Locales are
+ * structure and structure is code: when the active `elytra.config.ts` project
+ * declares locales, they drive the ambient locale switcher in EVERY mode. The old
+ * wiring only applied the project's locale settings on a HYDRATED session, so a
+ * playground boot — or a connected FIRST RUN with nothing persisted yet — fell
+ * back to a kit's locales or the core's sample `en/de` fixture and the switcher
+ * showed `EN·/DE` against a `locales: ['de']` config. Without a config project
+ * (env-only wiring) the previous ladder is unchanged: hydrated project settings,
+ * then the kit's locales, then the sample fixture (via `CmsProvider`'s default).
+ * `configLocales` is a parameter purely so the ladder is unit-testable (same seam
+ * pattern as {@link resolveCmsInitialCollections}).
+ */
+export declare function resolveCmsInitialLocaleConfig(cms: HydratedCms | null, kit: InstantiatedKit | undefined, project: Project, configLocales?: LocaleConfig | undefined): LocaleConfig | undefined;

package/dist/components/app-views/default-modules.js

@@ -7,7 +7,7 @@ import { Text } from '@elytracms/studio/ui';
 import { localizedLabel, translate } from '@elytracms/studio/lib/i18n';
 import { getInstantiatedKit } from '@elytracms/studio/lib/starters/kit-session';
 import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
-import { resolveDeploymentCollections } from '@elytracms/studio/lib/workspace';
+import { resolveDeploymentCollections, resolveDeploymentLocaleConfig } from '@elytracms/studio/lib/workspace';
 import { cmsDeepLink, componentsDeepLink, usersDeepLink, redirectsDeepLink, assetsDeepLink, groupNode, separatorNode, viewNode, } from './module.js';
 import { SectionSurface } from '../section-surface.js';
 import { SectionStateView } from '../section-state.js';
@@ -374,6 +374,26 @@ function ComponentsScreen({ projectId, componentId, state, }) {
 export function resolveCmsInitialCollections(cms, kit, playground = isPlaygroundMode()) {
     return cms?.collections ?? kit?.collections ?? (playground ? resolveDeploymentCollections() : undefined);
 }
+/**
+ * The CMS locale config for a project mount (EC-357 finding #3). Locales are
+ * structure and structure is code: when the active `elytra.config.ts` project
+ * declares locales, they drive the ambient locale switcher in EVERY mode. The old
+ * wiring only applied the project's locale settings on a HYDRATED session, so a
+ * playground boot — or a connected FIRST RUN with nothing persisted yet — fell
+ * back to a kit's locales or the core's sample `en/de` fixture and the switcher
+ * showed `EN·/DE` against a `locales: ['de']` config. Without a config project
+ * (env-only wiring) the previous ladder is unchanged: hydrated project settings,
+ * then the kit's locales, then the sample fixture (via `CmsProvider`'s default).
+ * `configLocales` is a parameter purely so the ladder is unit-testable (same seam
+ * pattern as {@link resolveCmsInitialCollections}).
+ */
+export function resolveCmsInitialLocaleConfig(cms, kit, project, configLocales = resolveDeploymentLocaleConfig()) {
+    if (configLocales)
+        return configLocales;
+    if (cms)
+        return { default: project.settings.defaultLocale, locales: [...project.settings.locales] };
+    return kit?.localeConfig;
+}
 /**
  * CMS section: hydrates the persisted (or kit-seeded) collections + documents, then
  * renders the active screen full-width (index, a collection table, or a document
@@ -389,10 +409,7 @@ function CmsScreen({ project, collectionId, documentId, state, field, focusColle
     }
     // A project created from a starter kit (EC-119) opens the CMS on the kit's schemas + content.
     const kit = getInstantiatedKit(projectId);
-    return (_jsx(CmsSessionGate, { children: (cms) => (_jsx(CmsProvider, { projectId: projectId, initialCollections: resolveCmsInitialCollections(cms, kit), initialDocuments: cms?.documents ?? kit?.documents, initialPublishedKeys: cms?.publishedKeys, initialLocaleConfig: cms
-                ? // Hydrated sessions follow the project's persisted locale settings.
-                    { default: project.settings.defaultLocale, locales: [...project.settings.locales] }
-                : kit?.localeConfig, children: _jsxs("div", { className: "flex h-full min-h-0 flex-col", children: [_jsx(CmsPersistErrorBanner, {}), _jsxs("div", { className: "flex min-h-0 flex-1 overflow-hidden", children: [_jsx("div", { className: "min-w-0 flex-1 overflow-hidden", children: _jsx(CmsContent, { projectId: projectId, collectionId: collectionId, documentId: documentId, field: field, focusCollections: focusCollections }) }), _jsx(AiCmsPanel, {})] })] }) }, projectId)) }));
+    return (_jsx(CmsSessionGate, { children: (cms) => (_jsx(CmsProvider, { projectId: projectId, initialCollections: resolveCmsInitialCollections(cms, kit), initialDocuments: cms?.documents ?? kit?.documents, initialPublishedKeys: cms?.publishedKeys, initialLocaleConfig: resolveCmsInitialLocaleConfig(cms, kit, project), children: _jsxs("div", { className: "flex h-full min-h-0 flex-col", children: [_jsx(CmsPersistErrorBanner, {}), _jsxs("div", { className: "flex min-h-0 flex-1 overflow-hidden", children: [_jsx("div", { className: "min-w-0 flex-1 overflow-hidden", children: _jsx(CmsContent, { projectId: projectId, collectionId: collectionId, documentId: documentId, field: field, focusCollections: focusCollections }) }), _jsx(AiCmsPanel, {})] })] }) }, projectId)) }));
 }
 /** Resolves the active CMS screen inside the provider (needs the live store). */
 function CmsContent({ projectId, collectionId, documentId, field, focusCollections, }) {

package/dist/components/app-views/default-modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-modules.js","sourceRoot":"","sources":["../../../src/components/app-views/default-modules.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect } from 'react'\nimport type { ReactNode } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport {\n  Blocks,\n  Database,\n  FileCog,\n  Image,\n  LayoutGrid,\n  Puzzle,\n  Settings as SettingsIcon,\n  Signpost,\n  Users,\n} from 'lucide-react'\nimport {\n  assetCollection,\n  extendCollectionDef,\n  isSingleton,\n  resolveSingletonDocument,\n} from '@elytracms/core/cms-core'\nimport type {\n  CollectionDef,\n  CollectionFieldOverride,\n  CollectionFormMeta,\n} from '@elytracms/core/cms-core'\nimport type { Project, SectionId, SectionState } from '@elytracms/core/studio-core'\nimport { Navigate, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { Text } from '@elytracms/studio/ui'\nimport { localizedLabel, translate } from '@elytracms/studio/lib/i18n'\nimport { getInstantiatedKit } from '@elytracms/studio/lib/starters/kit-session'\nimport type { InstantiatedKit } from '@elytracms/core/starter-kits'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { resolveDeploymentCollections } from '@elytracms/studio/lib/workspace'\nimport type { HydratedCms } from '@elytracms/studio/lib/operations'\nimport {\n  cmsDeepLink,\n  componentsDeepLink,\n  usersDeepLink,\n  redirectsDeepLink,\n  assetsDeepLink,\n  groupNode,\n  separatorNode,\n  viewNode,\n  type AppViewContext,\n  type AppViewDeepLink,\n  type AppViewModule,\n  type NavPermission,\n  type SidebarViewNode,\n} from './module'\nimport { SectionSurface } from '../section-surface'\nimport { SectionStateView } from '../section-state'\nimport { SettingsForm } from '../settings-form'\nimport { AssetsModule } from '../assets/assets-module'\nimport { UsersModule } from '../users/users-module'\nimport { RedirectsModule } from '../redirects/redirects-module'\nimport { redirectsCollectionDef } from '../redirects/redirects-schema'\nimport { ExtensionsView } from '../extensions/extensions-view'\nimport { RegistryBrowser } from '../components/registry-browser'\nimport { ComponentsIndex } from '../components/components-index'\nimport { ComponentDetail } from '../components/component-detail'\nimport { CmsSessionGate } from '../project-session'\nimport { CmsProvider, useCms } from '../cms/cms-store'\nimport { AiCmsPanel } from '../ai/ai-cms-panel'\nimport { focusCollectionList } from '../cms/collection-focus'\nimport { CmsIndex } from '../cms/cms-index'\nimport { CollectionTable } from '../cms/collection-table'\nimport { DetailEditor } from '../cms/detail-editor'\nimport { OperationErrorBanner } from '../operation-error'\n\n/**\n * EC-237/239 — the studio's BUILT-IN views + the consumer-facing `nav` namespace,\n * an instance of the EC-236 customization seam.\n *\n * Each built-in surface (the former `StudioSectionResolver` case body) is promoted\n * to a self-contained {@link AppViewModule} factory. The `nav` namespace is the\n * single, typed builder a consuming repo's `studio.config.tsx` uses to declare its\n * section rail — `nav.cms(...)`, `nav.group(...)`, `nav.view(...)` — passing the\n * view objects (and a focus config) DIRECTLY, never a string id. The CMS surface\n * is a factory ({@link cmsView}) so a focused view (\"Catalog\", \"Categories\") is the\n * SAME surface instantiated with config, not a copy — the EC-239 reuse proof.\n */\n\n// --- The CMS surface, reusable via a config factory (the EC-239 reuse seam) ---\n\n/** Config for a CMS-backed view — `collections`/`collection` focus the lens (EC-239). */\nexport interface CmsViewConfig {\n  /** Explicit stable id (the route segment). Omitted → derived from the focus. */\n  id?: string\n  label?: string\n  description?: string\n  icon?: LucideIcon\n  /**\n   * Scope the rail auto-expansion (EC-293) to these collection ids, in order. The\n   * parent expands into one focused-lens child per id; the parent index shows the\n   * same subset. Omitted → every collection. Ignored for a single-collection lens.\n   */\n  collections?: readonly string[]\n  /** Single-collection lens: a LEAF rail item that opens straight into this collection. */\n  collection?: string\n  /**\n   * EC-293 escape hatch: explicit rail children for this CMS parent, overriding the\n   * default per-collection auto-expansion. Ignored for a single-collection lens.\n   */\n  children?: SidebarViewNode[]\n  /** The availability section this view rides on (EC-221); defaults to `cms`. */\n  availabilitySection?: SectionId\n  /** OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18). See {@link BuiltinViewConfig.visible}. */\n  visible?: NavPermission\n}\n\n/** Common label/icon overrides for a built-in view (`nav.redirects({ label: 'URLs' })`). */\nexport interface BuiltinViewConfig {\n  label?: string\n  icon?: LucideIcon\n  /**\n   * OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18): hide this\n   * rail item for principals it returns `false` for; absent → always visible. The\n   * policy (which roles) lives in the consuming project, never the engine. E.g.\n   * `nav.users({ visible: ({ role }) => role === 'admin' })`.\n   */\n  visible?: NavPermission\n}\n\n/**\n * Config for the **redirects** rail (EC-311) — a built-in view whose engine-owned\n * schema is customizable. Beyond the shared label/icon/visible, a mount may rename\n * the rail (`form`) and **override built-in fields by equal name** (`fields`):\n * naming, permissions (`form.readOnly`), rendering (`form.control` → `fieldRenderers`)\n * and validation. The canonical `from`/`to`/`permanent`/`enabled` names+types are\n * contract-locked (a type change on one is a loud config error), but a *net-new*\n * field is allowed (EC-311 Tier 2): it's appended and persists in the redirect\n * record's `meta` bag — editorial only, so it never reaches delivery/routing.\n */\nexport interface RedirectsViewConfig extends BuiltinViewConfig {\n  /** Rename the rail (e.g. `{ label: 'URLs' }`). */\n  form?: Partial<CollectionFormMeta>\n  /** Override built-in redirect fields, matched by `name`. */\n  fields?: readonly CollectionFieldOverride[]\n}\n\n/**\n * Config for the **assets** rail (EC-319), customizable by the SAME EC-311\n * mechanism as redirects (`form`/`fields`) — but the BASE schema it overrides is\n * different in kind: redirects' base is an engine-owned, fixed `CollectionDef`\n * known at config-build time; the assets base is the DEPLOYMENT's own\n * `kind:'asset'` collection (a project's `cms/collections/asset.ts`), only\n * knowable once the deployment resolves (hydrated session → kit → playground\n * config — see {@link resolveAssetsSchema}). So the merge runs at RENDER time\n * (inside `assetsView`'s `CmsSessionGate`), not at `nav.assets(config)` call\n * time: a locked-violation override (e.g. changing a declared field's type)\n * surfaces the first time the Assets section renders, not at `defineStudio`\n * mount — the one place this rail's customization contract differs from\n * redirects', a direct consequence of its base schema being project-declared.\n */\nexport interface AssetsViewConfig extends BuiltinViewConfig {\n  /** Rename the rail (e.g. `{ label: 'Media' }`). */\n  form?: Partial<CollectionFormMeta>\n  /** Override the project's declared asset fields, matched by `name`. */\n  fields?: readonly CollectionFieldOverride[]\n}\n\n/** Config for a fully custom view (`nav.view({...})`) — the net-new surface escape hatch. */\nexport interface CustomViewConfig {\n  /** Explicit stable id (the route segment). Omitted → a slug of the label. */\n  id?: string\n  label: string\n  description?: string\n  icon?: LucideIcon\n  render: (ctx: AppViewContext) => ReactNode\n  parsePath?: (segments: string[]) => AppViewDeepLink | null\n  availabilitySection?: SectionId\n  /** OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18). See {@link BuiltinViewConfig.visible}. */\n  visible?: NavPermission\n}\n\nfunction slugify(label: string): string {\n  return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'view'\n}\n\n/** Derive a stable, deterministic id from the CMS focus (overridable via `config.id`). */\nfunction cmsViewId(config: CmsViewConfig): string {\n  if (config.id) return config.id\n  if (config.collection) return `cms:${config.collection}`\n  if (config.collections && config.collections.length > 0) {\n    return `cms:${[...config.collections].join('-')}`\n  }\n  return 'cms'\n}\n\n/**\n * Build a CMS view — the default `cms` view, or a focused instance. Every instance\n * shares one surface ({@link CmsScreen}); `collections` narrows the sidebar + index\n * to a subset, `collection` is a single-collection lens that opens straight into\n * that collection's list. The id is derived from the focus (deterministic, stable\n * across rail reorders) unless `id` is given — so two focused views never collide.\n */\nexport function cmsView(config: CmsViewConfig = {}): AppViewModule {\n  const single = config.collection\n  const focus = single ? [single] : config.collections\n  return {\n    id: cmsViewId(config),\n    // Lazy label/description (EC-241): the sidebar is built when the consumer's\n    // `studio.config` module loads — BEFORE `createStudio` seeds the i18n config — so\n    // resolving here would bake English. A getter defers resolution to render, when\n    // the config is present and the browser locale is known.\n    get label() {\n      return config.label ?? translate('nav.cms.label')\n    },\n    get description() {\n      return config.description ?? translate('nav.cms.description')\n    },\n    icon: config.icon ?? Database,\n    availabilitySection: config.availabilitySection ?? 'cms',\n    // A single-collection lens routes `[]`→that collection, `[d]`→its document;\n    // an unfocused / multi-collection view uses the full index/collection/document arity.\n    parsePath: single\n      ? (segments) =>\n          segments.length === 0\n            ? { collectionId: single, documentId: null }\n            : segments.length === 1\n              ? { collectionId: single, documentId: segments[0]! }\n              : null\n      : cmsDeepLink,\n    render: (ctx) => (\n      <CmsScreen\n        project={ctx.project}\n        collectionId={ctx.deepLink.collectionId ?? null}\n        documentId={ctx.deepLink.documentId ?? null}\n        state={ctx.search.state}\n        field={ctx.search.field}\n        focusCollections={focus}\n      />\n    ),\n  }\n}\n\n/**\n * A focused-lens rail child for one collection (EC-293) — the SAME `cms:<id>` view a\n * single-collection `nav.cms({ collection })` produces, carrying the collection's own\n * label + a singleton-aware icon (the former `CollectionsSidebar` row, lifted into\n * the rail). CMS auto-expansion maps the project's collections through this.\n */\nfunction cmsCollectionLeaf(collection: CollectionDef): SidebarViewNode {\n  const singleton = isSingleton(collection)\n  return viewNode(\n    cmsView({\n      collection: collection.id,\n      // Non-hook `localizedLabel` resolves the (possibly `{ en, de }`) collection label\n      // against the active UI locale, so a German editor sees German collection names.\n      label: localizedLabel(collection.form?.label, collection.id),\n      icon: singleton ? FileCog : collection.kind === 'asset' ? Image : Database,\n    }),\n  )\n}\n\n/** The components registry browser view. */\nexport function componentsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'components',\n    get label() {\n      return config.label ?? translate('nav.components.label')\n    },\n    get description() {\n      return translate('nav.components.description')\n    },\n    icon: config.icon ?? Blocks,\n    availabilitySection: 'components',\n    parsePath: componentsDeepLink,\n    render: (ctx) => (\n      <ComponentsScreen\n        projectId={ctx.projectId}\n        componentId={ctx.deepLink.componentId ?? null}\n        state={ctx.search.state}\n      />\n    ),\n  }\n}\n\n/**\n * The Redirects view (EC-303) — editorial redirects as DATA, an editor-owned CRUD\n * surface (create/edit/delete) over the portable list/edit surfaces. Routes are no\n * longer shown in the admin (they're code; native `next.config`/`vercel` own static\n * forwards, evaluated before these). Rides on the CMS availability (a content/\n * routing concern). `[]` is the list; `[redirectId]` opens that redirect's detail.\n */\nexport function redirectsView(config: RedirectsViewConfig = {}): AppViewModule {\n  // EC-311: merge any field/label overrides over the engine-owned def ONCE, at config\n  // build (config-as-code — a locked violation throws here, at `defineStudio` mount).\n  // Tier 2: `additiveFields: 'allow'` — a net-new field is appended and persists in the\n  // redirect record's `meta` bag (the canonical from/to/permanent/enabled stay locked).\n  const schema = extendCollectionDef(redirectsCollectionDef, config, { additiveFields: 'allow' })\n  return {\n    id: 'redirects',\n    get label() {\n      // Prefer an explicit rail label, then a consumer-*customized* collection label,\n      // else the localized catalog nav label. Never let the built-in English schema\n      // label ('Redirects') preempt translation — compare against the built-in default.\n      const customized = localizedLabel(schema.form?.label)\n      const builtin = localizedLabel(redirectsCollectionDef.form?.label)\n      return (\n        config.label ??\n        (customized && customized !== builtin ? customized : translate('nav.redirects.label'))\n      )\n    },\n    get description() {\n      return translate('nav.redirects.description')\n    },\n    icon: config.icon ?? Signpost,\n    availabilitySection: 'cms',\n    parsePath: redirectsDeepLink,\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.redirects.label')} />\n      ) : (\n        <RedirectsModule\n          projectId={ctx.projectId}\n          redirectId={ctx.deepLink.redirectId ?? null}\n          schema={schema}\n        />\n      ),\n  }\n}\n\n/**\n * Resolve the assets rail's EFFECTIVE schema (EC-319/EC-311): the deployment's\n * OWN `kind:'asset'` collection — hydrated session → kit → playground config,\n * the exact same precedence {@link resolveCmsInitialCollections} gives every\n * other CMS collection — falling back to the engine's `assetCollection` fixture\n * only when nothing resolves (mirroring `CmsProvider`'s own fallback). A mount's\n * `nav.assets({ form, fields })` then merges over THAT base (EC-311, additive\n * fields allowed — a project's asset record already carries an open `meta` bag,\n * EC-301). Pure — no React — so it's unit-testable without `CmsSessionGate`.\n */\nexport function resolveAssetsSchema(\n  collections: readonly CollectionDef[] | undefined,\n  config: AssetsViewConfig,\n): CollectionDef {\n  const base = collections?.find((c) => c.kind === 'asset') ?? assetCollection\n  return extendCollectionDef(base, config, { additiveFields: 'allow' })\n}\n\n/**\n * The Assets view (EC-319) — the universal list (+ grid/list toggle) and a\n * bespoke per-asset detail surface, over the asset library store. `[]` is the\n * list; `[assetId]` opens that asset's detail (routed via `studioPath.asset`).\n * A `?asset=` deep link (EC-172 \"used by\" links) redirects straight to the\n * asset's detail — the surface those links used to scroll a card into and\n * auto-open, now a first-class route.\n */\nexport function assetsView(config: AssetsViewConfig = {}): AppViewModule {\n  return {\n    id: 'assets',\n    get label() {\n      return config.label ?? translate('nav.assets.label')\n    },\n    get description() {\n      return translate('nav.assets.description')\n    },\n    icon: config.icon ?? Image,\n    availabilitySection: 'assets',\n    parsePath: assetsDeepLink,\n    render: (ctx) => (\n      <SectionSurface project={ctx.project} section=\"assets\" forcedState={ctx.search.state}>\n        {ctx.deepLink.assetId === null && ctx.search.asset ? (\n          <Navigate\n            to={STUDIO_PROJECT_ROUTE}\n            params={{ projectId: ctx.projectId, _splat: studioPath.asset(ctx.search.asset) }}\n            replace\n          />\n        ) : (\n          // The AssetsProvider is mounted at the project level (EC-195).\n          <CmsSessionGate>\n            {(cms) => {\n              const kit = getInstantiatedKit(ctx.projectId)\n              const schema = resolveAssetsSchema(resolveCmsInitialCollections(cms, kit), config)\n              return (\n                <AssetsModule\n                  projectId={ctx.projectId}\n                  assetId={ctx.deepLink.assetId ?? null}\n                  schema={schema}\n                />\n              )\n            }}\n          </CmsSessionGate>\n        )}\n      </SectionSurface>\n    ),\n  }\n}\n\n/**\n * The studio Users view (EC-240) — an admin-only roster of who has access to this\n * deployment and their role. A first-class section (its own rail entry), modeled\n * like the Assets library; the surface itself gates to admins and renders a\n * \"restricted\" state otherwise. Rides on the `settings` availability (an\n * admin/config concern, so it appears/hides with a project's settings surface).\n */\nexport function usersView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'users',\n    get label() {\n      return config.label ?? translate('nav.users.label')\n    },\n    get description() {\n      return translate('nav.users.description')\n    },\n    icon: config.icon ?? Users,\n    availabilitySection: 'users',\n    // EC-240: `[]` is the roster; `[userId]` opens that member in the portable edit\n    // shell (AD-19 reuse — the same `DetailEditor` body over the users source).\n    parsePath: usersDeepLink,\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.users.label')} />\n      ) : (\n        <UsersModule projectId={ctx.projectId} userId={ctx.deepLink.userId ?? null} />\n      ),\n  }\n}\n\n/** The extensions marketplace view. */\nexport function extensionsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'extensions',\n    get label() {\n      return config.label ?? translate('nav.extensions.label')\n    },\n    get description() {\n      return translate('nav.extensions.description')\n    },\n    icon: config.icon ?? Puzzle,\n    availabilitySection: 'extensions',\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.extensions.label')} />\n      ) : (\n        <ExtensionsView />\n      ),\n  }\n}\n\n/** The project settings view. */\nexport function settingsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'settings',\n    get label() {\n      return config.label ?? translate('nav.settings.label')\n    },\n    get description() {\n      return translate('nav.settings.description')\n    },\n    icon: config.icon ?? SettingsIcon,\n    availabilitySection: 'settings',\n    render: (ctx) => (\n      <SectionSurface project={ctx.project} section=\"settings\" forcedState={ctx.search.state}>\n        <SettingsForm project={ctx.project} />\n      </SectionSurface>\n    ),\n  }\n}\n\n/** The legacy `builder` redirect — a hidden, routable view (so `/builder?page=` still lands). */\nexport function builderView(): AppViewModule {\n  return {\n    id: 'builder',\n    label: 'Builder',\n    description: 'Legacy builder route — redirects to the page document editor.',\n    icon: Blocks,\n    hidden: true,\n    render: (ctx) => (\n      // Retired surface (EC-187 slice 6): a page is a document in the `page`\n      // collection. `?page=<id>` lands on that document; else the page list.\n      <Navigate\n        to={STUDIO_PROJECT_ROUTE}\n        params={{\n          projectId: ctx.projectId,\n          _splat: ctx.search.page\n            ? studioPath.cmsDocument('page', ctx.search.page)\n            : studioPath.cmsCollection('page'),\n        }}\n        replace\n      />\n    ),\n  }\n}\n\n/** Build a fully custom view (the `nav.view(...)` escape hatch). */\nexport function customView(config: CustomViewConfig): AppViewModule {\n  return {\n    id: config.id ?? slugify(config.label),\n    label: config.label,\n    description: config.description ?? config.label,\n    icon: config.icon ?? LayoutGrid,\n    render: config.render,\n    ...(config.parsePath ? { parsePath: config.parsePath } : {}),\n    ...(config.availabilitySection ? { availabilitySection: config.availabilitySection } : {}),\n  }\n}\n\n/**\n * The studio's built-in views in canonical rail order (components · CMS · routes ·\n * assets · extensions · settings), plus the hidden `builder` redirect (routable but\n * unlisted). The default rail (no `defineStudio({ sidebar })`) is these as plain\n * entries; the router registry always includes them so deep-links resolve even\n * when a consumer's rail omits one.\n */\nexport const DEFAULT_VIEWS: readonly AppViewModule[] = [\n  componentsView(),\n  cmsView(),\n  redirectsView(),\n  assetsView(),\n  extensionsView(),\n  usersView(),\n  settingsView(),\n  builderView(),\n]\n\n/**\n * The `nav` namespace — the single typed builder for `studio.config.tsx`'s section\n * rail. Each call returns a {@link SidebarViewNode} (or a group / separator) that\n * carries its view DIRECTLY: `nav.cms({ collection })` is a focused CMS view,\n * `nav.view({ render })` a net-new surface, `nav.group(label, [...])` a header with\n * sub-views, `nav.separator()` a divider. No string ids, no `moduleId` — the rail\n * is the views.\n */\n/**\n * Forward the OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18)\n * from a `nav.*` config onto the built view, so gating is settable on EVERY nav\n * item — not just Users. Absent → the view is unchanged (always visible).\n */\nfunction withNavPermission(view: AppViewModule, config: { visible?: NavPermission }): AppViewModule {\n  if (!config.visible) return view\n  // Copy property DESCRIPTORS (not a spread) so a built-in view's lazy `label`/\n  // `description` getters (EC-241) survive — a spread would invoke them at build time,\n  // baking English before `createStudio` seeds the i18n config.\n  return Object.defineProperties({} as AppViewModule, {\n    ...Object.getOwnPropertyDescriptors(view),\n    visible: { value: config.visible, enumerable: true, configurable: true, writable: true },\n  })\n}\n\nexport const nav = {\n  /**\n   * The CMS view. `nav.cms()` / `nav.cms({ collections })` is a PARENT that nests its\n   * collections in the rail (each a focused `cms:<id>` lens); `nav.cms({ collection })`\n   * is a single-collection LEAF; `nav.cms({ children })` supplies explicit children.\n   */\n  cms: (config: CmsViewConfig = {}): SidebarViewNode => {\n    const view = withNavPermission(cmsView(config), config)\n    // A single-collection lens is a leaf — it opens that collection directly.\n    if (config.collection) return viewNode(view)\n    // Otherwise a parent that expands its collections as nested rail children (EC-293).\n    const node: SidebarViewNode = { kind: 'view', view }\n    if (config.children) node.children = config.children\n    else\n      node.expand = (collections) =>\n        focusCollectionList(collections, config.collections).map(cmsCollectionLeaf)\n    return node\n  },\n  /** The component registry browser. */\n  components: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(componentsView(config), config)),\n  /** The assets rail — the universal list/grid + detail (EC-319); built-in\n   *  fields customizable by name (EC-311), the same shape as `nav.redirects`. */\n  assets: (config: AssetsViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(assetsView(config), config)),\n  /** Editorial redirects (EC-303); built-in fields customizable by name (EC-311). */\n  redirects: (config: RedirectsViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(redirectsView(config), config)),\n  /** Project settings. */\n  settings: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(settingsView(config), config)),\n  /** The extensions marketplace. */\n  extensions: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(extensionsView(config), config)),\n  /** The admin users roster (EC-240). */\n  users: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(usersView(config), config)),\n  /** A fully custom view — pass your own `render` (and optional `parsePath`). */\n  view: (config: CustomViewConfig): SidebarViewNode =>\n    viewNode(withNavPermission(customView(config), config)),\n  /** A labelled group of views (a header with sub-entries). */\n  group: (label: string, children: SidebarViewNode[]) => groupNode(label, children),\n  /** A divider between rail sections. */\n  separator: () => separatorNode(),\n} as const\n\n// --- Surfaces (the view render bodies; CMS gains a focus lens) ---\n\n/**\n * Components section (EC-050): a registry-browser sidebar beside the active\n * screen — the index (no selection) or a component's detail. Forced states\n * (?state=) replace the whole surface.\n */\nfunction ComponentsScreen({\n  projectId,\n  componentId,\n  state,\n}: {\n  projectId: string\n  componentId: string | null\n  state?: SectionState\n}) {\n  if (state && state !== 'working') {\n    return <SectionStateView state={state} title={translate('nav.components.label')} />\n  }\n  return (\n    <div className=\"flex h-full min-h-0\">\n      <aside className=\"hidden h-full min-h-0 w-[300px] shrink-0 border-r border-border md:block\">\n        <RegistryBrowser projectId={projectId} activeComponentId={componentId ?? undefined} />\n      </aside>\n      <div className=\"min-h-0 flex-1 overflow-auto\">\n        {componentId === null ? (\n          <ComponentsIndex projectId={projectId} />\n        ) : (\n          <ComponentDetail projectId={projectId} componentId={componentId} />\n        )}\n      </div>\n    </div>\n  )\n}\n\n/**\n * The CMS schema source for a project mount (bug fix, playground-collections):\n * a hydrated session wins (Convex), then a kit's imported schema (EC-119), then —\n * in playground mode only — the active project's config-declared collections\n * (AD-11, `resolveDeploymentCollections`). Without this last fallback, a non-kit\n * playground project has no hydrated session (`null`, by design — see\n * `project-session.tsx`) and no kit, so `CmsProvider` fell through to the core's\n * hardcoded `sampleFilterableCollections` fixture instead of the project's own\n * on-disk schema. Convex mode's first-run `null` is untouched — it still seeds\n * from the fixture there, as before. `playground` defaults to the live\n * {@link isPlaygroundMode} but is overridable so this stays unit testable\n * without stubbing the env (same seam as `resolveBackendConfig`).\n */\nexport function resolveCmsInitialCollections(\n  cms: HydratedCms | null,\n  kit: InstantiatedKit | undefined,\n  playground: boolean = isPlaygroundMode(),\n): CollectionDef[] | undefined {\n  return cms?.collections ?? kit?.collections ?? (playground ? resolveDeploymentCollections() : undefined)\n}\n\n/**\n * CMS section: hydrates the persisted (or kit-seeded) collections + documents, then\n * renders the active screen full-width (index, a collection table, or a document\n * editor). EC-293: the collection list lives in the section rail (nested under the\n * CMS view), so there is no in-surface collections sidebar. Forced states (?state=)\n * replace the whole surface. `focusCollections` (EC-239) narrows the index to a\n * subset, so a focused view (\"Catalog\") reuses this surface with config.\n */\nfunction CmsScreen({\n  project,\n  collectionId,\n  documentId,\n  state,\n  field,\n  focusCollections,\n}: {\n  project: Project\n  collectionId: string | null\n  documentId: string | null\n  state?: SectionState\n  field?: string\n  focusCollections?: readonly string[]\n}) {\n  const projectId = project.id\n  if (state && state !== 'working') {\n    return <SectionStateView state={state} title={translate('nav.cms.label')} />\n  }\n\n  // A project created from a starter kit (EC-119) opens the CMS on the kit's schemas + content.\n  const kit = getInstantiatedKit(projectId)\n\n  return (\n    // EC-177 gap 1: in Convex mode every CMS mount loads the CURRENT persisted\n    // schema + documents (fixtures only when nothing is persisted — first run).\n    // Playground renders synchronously with `null` → fixture seeds, as before.\n    <CmsSessionGate>\n      {(cms) => (\n        <CmsProvider\n          key={projectId}\n          projectId={projectId}\n          initialCollections={resolveCmsInitialCollections(cms, kit)}\n          initialDocuments={cms?.documents ?? kit?.documents}\n          initialPublishedKeys={cms?.publishedKeys}\n          initialLocaleConfig={\n            cms\n              ? // Hydrated sessions follow the project's persisted locale settings.\n                { default: project.settings.defaultLocale, locales: [...project.settings.locales] }\n              : kit?.localeConfig\n          }\n        >\n          <div className=\"flex h-full min-h-0 flex-col\">\n            <CmsPersistErrorBanner />\n            {/* EC-293: the collection list now lives in the section rail (nested\n                under the CMS view), so the surface is full-width — the old 240px\n                CollectionsSidebar aside is gone. EC-199: the AI assistant mounts as\n                a right-hand sibling (both list + editor), so the content is a row. */}\n            <div className=\"flex min-h-0 flex-1 overflow-hidden\">\n              <div className=\"min-w-0 flex-1 overflow-hidden\">\n                <CmsContent\n                  projectId={projectId}\n                  collectionId={collectionId}\n                  documentId={documentId}\n                  field={field}\n                  focusCollections={focusCollections}\n                />\n              </div>\n              <AiCmsPanel />\n            </div>\n          </div>\n        </CmsProvider>\n      )}\n    </CmsSessionGate>\n  )\n}\n\n/** Resolves the active CMS screen inside the provider (needs the live store). */\nfunction CmsContent({\n  projectId,\n  collectionId,\n  documentId,\n  field,\n  focusCollections,\n}: {\n  projectId: string\n  collectionId: string | null\n  documentId: string | null\n  field?: string\n  focusCollections?: readonly string[]\n}) {\n  const cms = useCms()\n\n  if (collectionId === null) return <CmsIndex projectId={projectId} focusCollections={focusCollections} />\n\n  if (documentId === null) {\n    const collection = cms.getCollection(collectionId)\n    // EC-274: a singleton is a UI lens — at the collection URL it opens its one\n    // document directly *while in its expected shape*, but degrades to the list\n    // (with a \"for review\" lane) on drift. SingletonGate decides per the data.\n    if (collection && isSingleton(collection)) {\n      return <SingletonGate projectId={projectId} collectionId={collectionId} />\n    }\n    return <CollectionTable projectId={projectId} collectionId={collectionId} />\n  }\n\n  return (\n    <DetailEditor\n      projectId={projectId}\n      collectionId={collectionId}\n      documentId={documentId}\n      focusPath={field}\n    />\n  )\n}\n\n/**\n * EC-274 — the singleton lens gate. At a singleton collection's URL, resolve its\n * lone document and open it directly; on drift (> 1 document) fall back to the\n * list with the \"for review\" lane so an editor can resolve the conflict.\n */\nfunction SingletonGate({ projectId, collectionId }: { projectId: string; collectionId: string }) {\n  const cms = useCms()\n  const collection = cms.getCollection(collectionId)\n  const docs = cms.documentsOf(collectionId)\n  const resolution = collection\n    ? resolveSingletonDocument(collection, docs)\n    : ({ kind: 'empty' } as const)\n\n  // Materialize the lone document on first visit (an empty draft, persisted like\n  // any create). Idempotent in the store; only fires while genuinely empty.\n  useEffect(() => {\n    if (resolution.kind === 'empty') cms.ensureSingletonDocument(collectionId)\n  }, [resolution.kind, cms, collectionId])\n\n  if (resolution.kind === 'ready') {\n    return (\n      <DetailEditor projectId={projectId} collectionId={collectionId} documentId={resolution.doc.id} />\n    )\n  }\n  if (resolution.kind === 'drift') {\n    return <CollectionTable projectId={projectId} collectionId={collectionId} />\n  }\n  return (\n    <div className=\"grid h-full place-items-center p-8\">\n      <Text size=\"sm\" tone=\"muted\">\n        {translate('appViews.singleton.opening', {\n          label: localizedLabel(collection?.form?.label, collectionId),\n        })}\n      </Text>\n    </div>\n  )\n}\n\n/** Failed/denied persisted CMS mutations are always visible (EC-141). */\nfunction CmsPersistErrorBanner() {\n  const cms = useCms()\n  if (!cms.persistError) return null\n  return (\n    <div className=\"shrink-0 border-b border-border p-2\">\n      <OperationErrorBanner error={cms.persistError} onDismiss={cms.clearPersistError} />\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"default-modules.js","sourceRoot":"","sources":["../../../src/components/app-views/default-modules.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect } from 'react'\nimport type { ReactNode } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport {\n  Blocks,\n  Database,\n  FileCog,\n  Image,\n  LayoutGrid,\n  Puzzle,\n  Settings as SettingsIcon,\n  Signpost,\n  Users,\n} from 'lucide-react'\nimport {\n  assetCollection,\n  extendCollectionDef,\n  isSingleton,\n  resolveSingletonDocument,\n} from '@elytracms/core/cms-core'\nimport type {\n  CollectionDef,\n  CollectionFieldOverride,\n  CollectionFormMeta,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport type { Project, SectionId, SectionState } from '@elytracms/core/studio-core'\nimport { Navigate, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { Text } from '@elytracms/studio/ui'\nimport { localizedLabel, translate } from '@elytracms/studio/lib/i18n'\nimport { getInstantiatedKit } from '@elytracms/studio/lib/starters/kit-session'\nimport type { InstantiatedKit } from '@elytracms/core/starter-kits'\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport { resolveDeploymentCollections, resolveDeploymentLocaleConfig } from '@elytracms/studio/lib/workspace'\nimport type { HydratedCms } from '@elytracms/studio/lib/operations'\nimport {\n  cmsDeepLink,\n  componentsDeepLink,\n  usersDeepLink,\n  redirectsDeepLink,\n  assetsDeepLink,\n  groupNode,\n  separatorNode,\n  viewNode,\n  type AppViewContext,\n  type AppViewDeepLink,\n  type AppViewModule,\n  type NavPermission,\n  type SidebarViewNode,\n} from './module'\nimport { SectionSurface } from '../section-surface'\nimport { SectionStateView } from '../section-state'\nimport { SettingsForm } from '../settings-form'\nimport { AssetsModule } from '../assets/assets-module'\nimport { UsersModule } from '../users/users-module'\nimport { RedirectsModule } from '../redirects/redirects-module'\nimport { redirectsCollectionDef } from '../redirects/redirects-schema'\nimport { ExtensionsView } from '../extensions/extensions-view'\nimport { RegistryBrowser } from '../components/registry-browser'\nimport { ComponentsIndex } from '../components/components-index'\nimport { ComponentDetail } from '../components/component-detail'\nimport { CmsSessionGate } from '../project-session'\nimport { CmsProvider, useCms } from '../cms/cms-store'\nimport { AiCmsPanel } from '../ai/ai-cms-panel'\nimport { focusCollectionList } from '../cms/collection-focus'\nimport { CmsIndex } from '../cms/cms-index'\nimport { CollectionTable } from '../cms/collection-table'\nimport { DetailEditor } from '../cms/detail-editor'\nimport { OperationErrorBanner } from '../operation-error'\n\n/**\n * EC-237/239 — the studio's BUILT-IN views + the consumer-facing `nav` namespace,\n * an instance of the EC-236 customization seam.\n *\n * Each built-in surface (the former `StudioSectionResolver` case body) is promoted\n * to a self-contained {@link AppViewModule} factory. The `nav` namespace is the\n * single, typed builder a consuming repo's `studio.config.tsx` uses to declare its\n * section rail — `nav.cms(...)`, `nav.group(...)`, `nav.view(...)` — passing the\n * view objects (and a focus config) DIRECTLY, never a string id. The CMS surface\n * is a factory ({@link cmsView}) so a focused view (\"Catalog\", \"Categories\") is the\n * SAME surface instantiated with config, not a copy — the EC-239 reuse proof.\n */\n\n// --- The CMS surface, reusable via a config factory (the EC-239 reuse seam) ---\n\n/** Config for a CMS-backed view — `collections`/`collection` focus the lens (EC-239). */\nexport interface CmsViewConfig {\n  /** Explicit stable id (the route segment). Omitted → derived from the focus. */\n  id?: string\n  label?: string\n  description?: string\n  icon?: LucideIcon\n  /**\n   * Scope the rail auto-expansion (EC-293) to these collection ids, in order. The\n   * parent expands into one focused-lens child per id; the parent index shows the\n   * same subset. Omitted → every collection. Ignored for a single-collection lens.\n   */\n  collections?: readonly string[]\n  /** Single-collection lens: a LEAF rail item that opens straight into this collection. */\n  collection?: string\n  /**\n   * EC-293 escape hatch: explicit rail children for this CMS parent, overriding the\n   * default per-collection auto-expansion. Ignored for a single-collection lens.\n   */\n  children?: SidebarViewNode[]\n  /** The availability section this view rides on (EC-221); defaults to `cms`. */\n  availabilitySection?: SectionId\n  /** OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18). See {@link BuiltinViewConfig.visible}. */\n  visible?: NavPermission\n}\n\n/** Common label/icon overrides for a built-in view (`nav.redirects({ label: 'URLs' })`). */\nexport interface BuiltinViewConfig {\n  label?: string\n  icon?: LucideIcon\n  /**\n   * OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18): hide this\n   * rail item for principals it returns `false` for; absent → always visible. The\n   * policy (which roles) lives in the consuming project, never the engine. E.g.\n   * `nav.users({ visible: ({ role }) => role === 'admin' })`.\n   */\n  visible?: NavPermission\n}\n\n/**\n * Config for the **redirects** rail (EC-311) — a built-in view whose engine-owned\n * schema is customizable. Beyond the shared label/icon/visible, a mount may rename\n * the rail (`form`) and **override built-in fields by equal name** (`fields`):\n * naming, permissions (`form.readOnly`), rendering (`form.control` → `fieldRenderers`)\n * and validation. The canonical `from`/`to`/`permanent`/`enabled` names+types are\n * contract-locked (a type change on one is a loud config error), but a *net-new*\n * field is allowed (EC-311 Tier 2): it's appended and persists in the redirect\n * record's `meta` bag — editorial only, so it never reaches delivery/routing.\n */\nexport interface RedirectsViewConfig extends BuiltinViewConfig {\n  /** Rename the rail (e.g. `{ label: 'URLs' }`). */\n  form?: Partial<CollectionFormMeta>\n  /** Override built-in redirect fields, matched by `name`. */\n  fields?: readonly CollectionFieldOverride[]\n}\n\n/**\n * Config for the **assets** rail (EC-319), customizable by the SAME EC-311\n * mechanism as redirects (`form`/`fields`) — but the BASE schema it overrides is\n * different in kind: redirects' base is an engine-owned, fixed `CollectionDef`\n * known at config-build time; the assets base is the DEPLOYMENT's own\n * `kind:'asset'` collection (a project's `cms/collections/asset.ts`), only\n * knowable once the deployment resolves (hydrated session → kit → playground\n * config — see {@link resolveAssetsSchema}). So the merge runs at RENDER time\n * (inside `assetsView`'s `CmsSessionGate`), not at `nav.assets(config)` call\n * time: a locked-violation override (e.g. changing a declared field's type)\n * surfaces the first time the Assets section renders, not at `defineStudio`\n * mount — the one place this rail's customization contract differs from\n * redirects', a direct consequence of its base schema being project-declared.\n */\nexport interface AssetsViewConfig extends BuiltinViewConfig {\n  /** Rename the rail (e.g. `{ label: 'Media' }`). */\n  form?: Partial<CollectionFormMeta>\n  /** Override the project's declared asset fields, matched by `name`. */\n  fields?: readonly CollectionFieldOverride[]\n}\n\n/** Config for a fully custom view (`nav.view({...})`) — the net-new surface escape hatch. */\nexport interface CustomViewConfig {\n  /** Explicit stable id (the route segment). Omitted → a slug of the label. */\n  id?: string\n  label: string\n  description?: string\n  icon?: LucideIcon\n  render: (ctx: AppViewContext) => ReactNode\n  parsePath?: (segments: string[]) => AppViewDeepLink | null\n  availabilitySection?: SectionId\n  /** OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18). See {@link BuiltinViewConfig.visible}. */\n  visible?: NavPermission\n}\n\nfunction slugify(label: string): string {\n  return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'view'\n}\n\n/** Derive a stable, deterministic id from the CMS focus (overridable via `config.id`). */\nfunction cmsViewId(config: CmsViewConfig): string {\n  if (config.id) return config.id\n  if (config.collection) return `cms:${config.collection}`\n  if (config.collections && config.collections.length > 0) {\n    return `cms:${[...config.collections].join('-')}`\n  }\n  return 'cms'\n}\n\n/**\n * Build a CMS view — the default `cms` view, or a focused instance. Every instance\n * shares one surface ({@link CmsScreen}); `collections` narrows the sidebar + index\n * to a subset, `collection` is a single-collection lens that opens straight into\n * that collection's list. The id is derived from the focus (deterministic, stable\n * across rail reorders) unless `id` is given — so two focused views never collide.\n */\nexport function cmsView(config: CmsViewConfig = {}): AppViewModule {\n  const single = config.collection\n  const focus = single ? [single] : config.collections\n  return {\n    id: cmsViewId(config),\n    // Lazy label/description (EC-241): the sidebar is built when the consumer's\n    // `studio.config` module loads — BEFORE `createStudio` seeds the i18n config — so\n    // resolving here would bake English. A getter defers resolution to render, when\n    // the config is present and the browser locale is known.\n    get label() {\n      return config.label ?? translate('nav.cms.label')\n    },\n    get description() {\n      return config.description ?? translate('nav.cms.description')\n    },\n    icon: config.icon ?? Database,\n    availabilitySection: config.availabilitySection ?? 'cms',\n    // A single-collection lens routes `[]`→that collection, `[d]`→its document;\n    // an unfocused / multi-collection view uses the full index/collection/document arity.\n    parsePath: single\n      ? (segments) =>\n          segments.length === 0\n            ? { collectionId: single, documentId: null }\n            : segments.length === 1\n              ? { collectionId: single, documentId: segments[0]! }\n              : null\n      : cmsDeepLink,\n    render: (ctx) => (\n      <CmsScreen\n        project={ctx.project}\n        collectionId={ctx.deepLink.collectionId ?? null}\n        documentId={ctx.deepLink.documentId ?? null}\n        state={ctx.search.state}\n        field={ctx.search.field}\n        focusCollections={focus}\n      />\n    ),\n  }\n}\n\n/**\n * A focused-lens rail child for one collection (EC-293) — the SAME `cms:<id>` view a\n * single-collection `nav.cms({ collection })` produces, carrying the collection's own\n * label + a singleton-aware icon (the former `CollectionsSidebar` row, lifted into\n * the rail). CMS auto-expansion maps the project's collections through this.\n */\nfunction cmsCollectionLeaf(collection: CollectionDef): SidebarViewNode {\n  const singleton = isSingleton(collection)\n  return viewNode(\n    cmsView({\n      collection: collection.id,\n      // Non-hook `localizedLabel` resolves the (possibly `{ en, de }`) collection label\n      // against the active UI locale, so a German editor sees German collection names.\n      label: localizedLabel(collection.form?.label, collection.id),\n      icon: singleton ? FileCog : collection.kind === 'asset' ? Image : Database,\n    }),\n  )\n}\n\n/** The components registry browser view. */\nexport function componentsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'components',\n    get label() {\n      return config.label ?? translate('nav.components.label')\n    },\n    get description() {\n      return translate('nav.components.description')\n    },\n    icon: config.icon ?? Blocks,\n    availabilitySection: 'components',\n    parsePath: componentsDeepLink,\n    render: (ctx) => (\n      <ComponentsScreen\n        projectId={ctx.projectId}\n        componentId={ctx.deepLink.componentId ?? null}\n        state={ctx.search.state}\n      />\n    ),\n  }\n}\n\n/**\n * The Redirects view (EC-303) — editorial redirects as DATA, an editor-owned CRUD\n * surface (create/edit/delete) over the portable list/edit surfaces. Routes are no\n * longer shown in the admin (they're code; native `next.config`/`vercel` own static\n * forwards, evaluated before these). Rides on the CMS availability (a content/\n * routing concern). `[]` is the list; `[redirectId]` opens that redirect's detail.\n */\nexport function redirectsView(config: RedirectsViewConfig = {}): AppViewModule {\n  // EC-311: merge any field/label overrides over the engine-owned def ONCE, at config\n  // build (config-as-code — a locked violation throws here, at `defineStudio` mount).\n  // Tier 2: `additiveFields: 'allow'` — a net-new field is appended and persists in the\n  // redirect record's `meta` bag (the canonical from/to/permanent/enabled stay locked).\n  const schema = extendCollectionDef(redirectsCollectionDef, config, { additiveFields: 'allow' })\n  return {\n    id: 'redirects',\n    get label() {\n      // Prefer an explicit rail label, then a consumer-*customized* collection label,\n      // else the localized catalog nav label. Never let the built-in English schema\n      // label ('Redirects') preempt translation — compare against the built-in default.\n      const customized = localizedLabel(schema.form?.label)\n      const builtin = localizedLabel(redirectsCollectionDef.form?.label)\n      return (\n        config.label ??\n        (customized && customized !== builtin ? customized : translate('nav.redirects.label'))\n      )\n    },\n    get description() {\n      return translate('nav.redirects.description')\n    },\n    icon: config.icon ?? Signpost,\n    availabilitySection: 'cms',\n    parsePath: redirectsDeepLink,\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.redirects.label')} />\n      ) : (\n        <RedirectsModule\n          projectId={ctx.projectId}\n          redirectId={ctx.deepLink.redirectId ?? null}\n          schema={schema}\n        />\n      ),\n  }\n}\n\n/**\n * Resolve the assets rail's EFFECTIVE schema (EC-319/EC-311): the deployment's\n * OWN `kind:'asset'` collection — hydrated session → kit → playground config,\n * the exact same precedence {@link resolveCmsInitialCollections} gives every\n * other CMS collection — falling back to the engine's `assetCollection` fixture\n * only when nothing resolves (mirroring `CmsProvider`'s own fallback). A mount's\n * `nav.assets({ form, fields })` then merges over THAT base (EC-311, additive\n * fields allowed — a project's asset record already carries an open `meta` bag,\n * EC-301). Pure — no React — so it's unit-testable without `CmsSessionGate`.\n */\nexport function resolveAssetsSchema(\n  collections: readonly CollectionDef[] | undefined,\n  config: AssetsViewConfig,\n): CollectionDef {\n  const base = collections?.find((c) => c.kind === 'asset') ?? assetCollection\n  return extendCollectionDef(base, config, { additiveFields: 'allow' })\n}\n\n/**\n * The Assets view (EC-319) — the universal list (+ grid/list toggle) and a\n * bespoke per-asset detail surface, over the asset library store. `[]` is the\n * list; `[assetId]` opens that asset's detail (routed via `studioPath.asset`).\n * A `?asset=` deep link (EC-172 \"used by\" links) redirects straight to the\n * asset's detail — the surface those links used to scroll a card into and\n * auto-open, now a first-class route.\n */\nexport function assetsView(config: AssetsViewConfig = {}): AppViewModule {\n  return {\n    id: 'assets',\n    get label() {\n      return config.label ?? translate('nav.assets.label')\n    },\n    get description() {\n      return translate('nav.assets.description')\n    },\n    icon: config.icon ?? Image,\n    availabilitySection: 'assets',\n    parsePath: assetsDeepLink,\n    render: (ctx) => (\n      <SectionSurface project={ctx.project} section=\"assets\" forcedState={ctx.search.state}>\n        {ctx.deepLink.assetId === null && ctx.search.asset ? (\n          <Navigate\n            to={STUDIO_PROJECT_ROUTE}\n            params={{ projectId: ctx.projectId, _splat: studioPath.asset(ctx.search.asset) }}\n            replace\n          />\n        ) : (\n          // The AssetsProvider is mounted at the project level (EC-195).\n          <CmsSessionGate>\n            {(cms) => {\n              const kit = getInstantiatedKit(ctx.projectId)\n              const schema = resolveAssetsSchema(resolveCmsInitialCollections(cms, kit), config)\n              return (\n                <AssetsModule\n                  projectId={ctx.projectId}\n                  assetId={ctx.deepLink.assetId ?? null}\n                  schema={schema}\n                />\n              )\n            }}\n          </CmsSessionGate>\n        )}\n      </SectionSurface>\n    ),\n  }\n}\n\n/**\n * The studio Users view (EC-240) — an admin-only roster of who has access to this\n * deployment and their role. A first-class section (its own rail entry), modeled\n * like the Assets library; the surface itself gates to admins and renders a\n * \"restricted\" state otherwise. Rides on the `settings` availability (an\n * admin/config concern, so it appears/hides with a project's settings surface).\n */\nexport function usersView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'users',\n    get label() {\n      return config.label ?? translate('nav.users.label')\n    },\n    get description() {\n      return translate('nav.users.description')\n    },\n    icon: config.icon ?? Users,\n    availabilitySection: 'users',\n    // EC-240: `[]` is the roster; `[userId]` opens that member in the portable edit\n    // shell (AD-19 reuse — the same `DetailEditor` body over the users source).\n    parsePath: usersDeepLink,\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.users.label')} />\n      ) : (\n        <UsersModule projectId={ctx.projectId} userId={ctx.deepLink.userId ?? null} />\n      ),\n  }\n}\n\n/** The extensions marketplace view. */\nexport function extensionsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'extensions',\n    get label() {\n      return config.label ?? translate('nav.extensions.label')\n    },\n    get description() {\n      return translate('nav.extensions.description')\n    },\n    icon: config.icon ?? Puzzle,\n    availabilitySection: 'extensions',\n    render: (ctx) =>\n      ctx.search.state && ctx.search.state !== 'working' ? (\n        <SectionStateView state={ctx.search.state} title={translate('nav.extensions.label')} />\n      ) : (\n        <ExtensionsView />\n      ),\n  }\n}\n\n/** The project settings view. */\nexport function settingsView(config: BuiltinViewConfig = {}): AppViewModule {\n  return {\n    id: 'settings',\n    get label() {\n      return config.label ?? translate('nav.settings.label')\n    },\n    get description() {\n      return translate('nav.settings.description')\n    },\n    icon: config.icon ?? SettingsIcon,\n    availabilitySection: 'settings',\n    render: (ctx) => (\n      <SectionSurface project={ctx.project} section=\"settings\" forcedState={ctx.search.state}>\n        <SettingsForm project={ctx.project} />\n      </SectionSurface>\n    ),\n  }\n}\n\n/** The legacy `builder` redirect — a hidden, routable view (so `/builder?page=` still lands). */\nexport function builderView(): AppViewModule {\n  return {\n    id: 'builder',\n    label: 'Builder',\n    description: 'Legacy builder route — redirects to the page document editor.',\n    icon: Blocks,\n    hidden: true,\n    render: (ctx) => (\n      // Retired surface (EC-187 slice 6): a page is a document in the `page`\n      // collection. `?page=<id>` lands on that document; else the page list.\n      <Navigate\n        to={STUDIO_PROJECT_ROUTE}\n        params={{\n          projectId: ctx.projectId,\n          _splat: ctx.search.page\n            ? studioPath.cmsDocument('page', ctx.search.page)\n            : studioPath.cmsCollection('page'),\n        }}\n        replace\n      />\n    ),\n  }\n}\n\n/** Build a fully custom view (the `nav.view(...)` escape hatch). */\nexport function customView(config: CustomViewConfig): AppViewModule {\n  return {\n    id: config.id ?? slugify(config.label),\n    label: config.label,\n    description: config.description ?? config.label,\n    icon: config.icon ?? LayoutGrid,\n    render: config.render,\n    ...(config.parsePath ? { parsePath: config.parsePath } : {}),\n    ...(config.availabilitySection ? { availabilitySection: config.availabilitySection } : {}),\n  }\n}\n\n/**\n * The studio's built-in views in canonical rail order (components · CMS · routes ·\n * assets · extensions · settings), plus the hidden `builder` redirect (routable but\n * unlisted). The default rail (no `defineStudio({ sidebar })`) is these as plain\n * entries; the router registry always includes them so deep-links resolve even\n * when a consumer's rail omits one.\n */\nexport const DEFAULT_VIEWS: readonly AppViewModule[] = [\n  componentsView(),\n  cmsView(),\n  redirectsView(),\n  assetsView(),\n  extensionsView(),\n  usersView(),\n  settingsView(),\n  builderView(),\n]\n\n/**\n * The `nav` namespace — the single typed builder for `studio.config.tsx`'s section\n * rail. Each call returns a {@link SidebarViewNode} (or a group / separator) that\n * carries its view DIRECTLY: `nav.cms({ collection })` is a focused CMS view,\n * `nav.view({ render })` a net-new surface, `nav.group(label, [...])` a header with\n * sub-views, `nav.separator()` a divider. No string ids, no `moduleId` — the rail\n * is the views.\n */\n/**\n * Forward the OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18)\n * from a `nav.*` config onto the built view, so gating is settable on EVERY nav\n * item — not just Users. Absent → the view is unchanged (always visible).\n */\nfunction withNavPermission(view: AppViewModule, config: { visible?: NavPermission }): AppViewModule {\n  if (!config.visible) return view\n  // Copy property DESCRIPTORS (not a spread) so a built-in view's lazy `label`/\n  // `description` getters (EC-241) survive — a spread would invoke them at build time,\n  // baking English before `createStudio` seeds the i18n config.\n  return Object.defineProperties({} as AppViewModule, {\n    ...Object.getOwnPropertyDescriptors(view),\n    visible: { value: config.visible, enumerable: true, configurable: true, writable: true },\n  })\n}\n\nexport const nav = {\n  /**\n   * The CMS view. `nav.cms()` / `nav.cms({ collections })` is a PARENT that nests its\n   * collections in the rail (each a focused `cms:<id>` lens); `nav.cms({ collection })`\n   * is a single-collection LEAF; `nav.cms({ children })` supplies explicit children.\n   */\n  cms: (config: CmsViewConfig = {}): SidebarViewNode => {\n    const view = withNavPermission(cmsView(config), config)\n    // A single-collection lens is a leaf — it opens that collection directly.\n    if (config.collection) return viewNode(view)\n    // Otherwise a parent that expands its collections as nested rail children (EC-293).\n    const node: SidebarViewNode = { kind: 'view', view }\n    if (config.children) node.children = config.children\n    else\n      node.expand = (collections) =>\n        focusCollectionList(collections, config.collections).map(cmsCollectionLeaf)\n    return node\n  },\n  /** The component registry browser. */\n  components: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(componentsView(config), config)),\n  /** The assets rail — the universal list/grid + detail (EC-319); built-in\n   *  fields customizable by name (EC-311), the same shape as `nav.redirects`. */\n  assets: (config: AssetsViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(assetsView(config), config)),\n  /** Editorial redirects (EC-303); built-in fields customizable by name (EC-311). */\n  redirects: (config: RedirectsViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(redirectsView(config), config)),\n  /** Project settings. */\n  settings: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(settingsView(config), config)),\n  /** The extensions marketplace. */\n  extensions: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(extensionsView(config), config)),\n  /** The admin users roster (EC-240). */\n  users: (config: BuiltinViewConfig = {}): SidebarViewNode =>\n    viewNode(withNavPermission(usersView(config), config)),\n  /** A fully custom view — pass your own `render` (and optional `parsePath`). */\n  view: (config: CustomViewConfig): SidebarViewNode =>\n    viewNode(withNavPermission(customView(config), config)),\n  /** A labelled group of views (a header with sub-entries). */\n  group: (label: string, children: SidebarViewNode[]) => groupNode(label, children),\n  /** A divider between rail sections. */\n  separator: () => separatorNode(),\n} as const\n\n// --- Surfaces (the view render bodies; CMS gains a focus lens) ---\n\n/**\n * Components section (EC-050): a registry-browser sidebar beside the active\n * screen — the index (no selection) or a component's detail. Forced states\n * (?state=) replace the whole surface.\n */\nfunction ComponentsScreen({\n  projectId,\n  componentId,\n  state,\n}: {\n  projectId: string\n  componentId: string | null\n  state?: SectionState\n}) {\n  if (state && state !== 'working') {\n    return <SectionStateView state={state} title={translate('nav.components.label')} />\n  }\n  return (\n    <div className=\"flex h-full min-h-0\">\n      <aside className=\"hidden h-full min-h-0 w-[300px] shrink-0 border-r border-border md:block\">\n        <RegistryBrowser projectId={projectId} activeComponentId={componentId ?? undefined} />\n      </aside>\n      <div className=\"min-h-0 flex-1 overflow-auto\">\n        {componentId === null ? (\n          <ComponentsIndex projectId={projectId} />\n        ) : (\n          <ComponentDetail projectId={projectId} componentId={componentId} />\n        )}\n      </div>\n    </div>\n  )\n}\n\n/**\n * The CMS schema source for a project mount (bug fix, playground-collections):\n * a hydrated session wins (Convex), then a kit's imported schema (EC-119), then —\n * in playground mode only — the active project's config-declared collections\n * (AD-11, `resolveDeploymentCollections`). Without this last fallback, a non-kit\n * playground project has no hydrated session (`null`, by design — see\n * `project-session.tsx`) and no kit, so `CmsProvider` fell through to the core's\n * hardcoded `sampleFilterableCollections` fixture instead of the project's own\n * on-disk schema. Convex mode's first-run `null` is untouched — it still seeds\n * from the fixture there, as before. `playground` defaults to the live\n * {@link isPlaygroundMode} but is overridable so this stays unit testable\n * without stubbing the env (same seam as `resolveBackendConfig`).\n */\nexport function resolveCmsInitialCollections(\n  cms: HydratedCms | null,\n  kit: InstantiatedKit | undefined,\n  playground: boolean = isPlaygroundMode(),\n): CollectionDef[] | undefined {\n  return cms?.collections ?? kit?.collections ?? (playground ? resolveDeploymentCollections() : undefined)\n}\n\n/**\n * The CMS locale config for a project mount (EC-357 finding #3). Locales are\n * structure and structure is code: when the active `elytra.config.ts` project\n * declares locales, they drive the ambient locale switcher in EVERY mode. The old\n * wiring only applied the project's locale settings on a HYDRATED session, so a\n * playground boot — or a connected FIRST RUN with nothing persisted yet — fell\n * back to a kit's locales or the core's sample `en/de` fixture and the switcher\n * showed `EN·/DE` against a `locales: ['de']` config. Without a config project\n * (env-only wiring) the previous ladder is unchanged: hydrated project settings,\n * then the kit's locales, then the sample fixture (via `CmsProvider`'s default).\n * `configLocales` is a parameter purely so the ladder is unit-testable (same seam\n * pattern as {@link resolveCmsInitialCollections}).\n */\nexport function resolveCmsInitialLocaleConfig(\n  cms: HydratedCms | null,\n  kit: InstantiatedKit | undefined,\n  project: Project,\n  configLocales: LocaleConfig | undefined = resolveDeploymentLocaleConfig(),\n): LocaleConfig | undefined {\n  if (configLocales) return configLocales\n  if (cms) return { default: project.settings.defaultLocale, locales: [...project.settings.locales] }\n  return kit?.localeConfig\n}\n\n/**\n * CMS section: hydrates the persisted (or kit-seeded) collections + documents, then\n * renders the active screen full-width (index, a collection table, or a document\n * editor). EC-293: the collection list lives in the section rail (nested under the\n * CMS view), so there is no in-surface collections sidebar. Forced states (?state=)\n * replace the whole surface. `focusCollections` (EC-239) narrows the index to a\n * subset, so a focused view (\"Catalog\") reuses this surface with config.\n */\nfunction CmsScreen({\n  project,\n  collectionId,\n  documentId,\n  state,\n  field,\n  focusCollections,\n}: {\n  project: Project\n  collectionId: string | null\n  documentId: string | null\n  state?: SectionState\n  field?: string\n  focusCollections?: readonly string[]\n}) {\n  const projectId = project.id\n  if (state && state !== 'working') {\n    return <SectionStateView state={state} title={translate('nav.cms.label')} />\n  }\n\n  // A project created from a starter kit (EC-119) opens the CMS on the kit's schemas + content.\n  const kit = getInstantiatedKit(projectId)\n\n  return (\n    // EC-177 gap 1: in Convex mode every CMS mount loads the CURRENT persisted\n    // schema + documents (fixtures only when nothing is persisted — first run).\n    // Playground renders synchronously with `null` → fixture seeds, as before.\n    <CmsSessionGate>\n      {(cms) => (\n        <CmsProvider\n          key={projectId}\n          projectId={projectId}\n          initialCollections={resolveCmsInitialCollections(cms, kit)}\n          initialDocuments={cms?.documents ?? kit?.documents}\n          initialPublishedKeys={cms?.publishedKeys}\n          initialLocaleConfig={resolveCmsInitialLocaleConfig(cms, kit, project)}\n        >\n          <div className=\"flex h-full min-h-0 flex-col\">\n            <CmsPersistErrorBanner />\n            {/* EC-293: the collection list now lives in the section rail (nested\n                under the CMS view), so the surface is full-width — the old 240px\n                CollectionsSidebar aside is gone. EC-199: the AI assistant mounts as\n                a right-hand sibling (both list + editor), so the content is a row. */}\n            <div className=\"flex min-h-0 flex-1 overflow-hidden\">\n              <div className=\"min-w-0 flex-1 overflow-hidden\">\n                <CmsContent\n                  projectId={projectId}\n                  collectionId={collectionId}\n                  documentId={documentId}\n                  field={field}\n                  focusCollections={focusCollections}\n                />\n              </div>\n              <AiCmsPanel />\n            </div>\n          </div>\n        </CmsProvider>\n      )}\n    </CmsSessionGate>\n  )\n}\n\n/** Resolves the active CMS screen inside the provider (needs the live store). */\nfunction CmsContent({\n  projectId,\n  collectionId,\n  documentId,\n  field,\n  focusCollections,\n}: {\n  projectId: string\n  collectionId: string | null\n  documentId: string | null\n  field?: string\n  focusCollections?: readonly string[]\n}) {\n  const cms = useCms()\n\n  if (collectionId === null) return <CmsIndex projectId={projectId} focusCollections={focusCollections} />\n\n  if (documentId === null) {\n    const collection = cms.getCollection(collectionId)\n    // EC-274: a singleton is a UI lens — at the collection URL it opens its one\n    // document directly *while in its expected shape*, but degrades to the list\n    // (with a \"for review\" lane) on drift. SingletonGate decides per the data.\n    if (collection && isSingleton(collection)) {\n      return <SingletonGate projectId={projectId} collectionId={collectionId} />\n    }\n    return <CollectionTable projectId={projectId} collectionId={collectionId} />\n  }\n\n  return (\n    <DetailEditor\n      projectId={projectId}\n      collectionId={collectionId}\n      documentId={documentId}\n      focusPath={field}\n    />\n  )\n}\n\n/**\n * EC-274 — the singleton lens gate. At a singleton collection's URL, resolve its\n * lone document and open it directly; on drift (> 1 document) fall back to the\n * list with the \"for review\" lane so an editor can resolve the conflict.\n */\nfunction SingletonGate({ projectId, collectionId }: { projectId: string; collectionId: string }) {\n  const cms = useCms()\n  const collection = cms.getCollection(collectionId)\n  const docs = cms.documentsOf(collectionId)\n  const resolution = collection\n    ? resolveSingletonDocument(collection, docs)\n    : ({ kind: 'empty' } as const)\n\n  // Materialize the lone document on first visit (an empty draft, persisted like\n  // any create). Idempotent in the store; only fires while genuinely empty.\n  useEffect(() => {\n    if (resolution.kind === 'empty') cms.ensureSingletonDocument(collectionId)\n  }, [resolution.kind, cms, collectionId])\n\n  if (resolution.kind === 'ready') {\n    return (\n      <DetailEditor projectId={projectId} collectionId={collectionId} documentId={resolution.doc.id} />\n    )\n  }\n  if (resolution.kind === 'drift') {\n    return <CollectionTable projectId={projectId} collectionId={collectionId} />\n  }\n  return (\n    <div className=\"grid h-full place-items-center p-8\">\n      <Text size=\"sm\" tone=\"muted\">\n        {translate('appViews.singleton.opening', {\n          label: localizedLabel(collection?.form?.label, collectionId),\n        })}\n      </Text>\n    </div>\n  )\n}\n\n/** Failed/denied persisted CMS mutations are always visible (EC-141). */\nfunction CmsPersistErrorBanner() {\n  const cms = useCms()\n  if (!cms.persistError) return null\n  return (\n    <div className=\"shrink-0 border-b border-border p-2\">\n      <OperationErrorBanner error={cms.persistError} onDismiss={cms.clearPersistError} />\n    </div>\n  )\n}\n"]}

package/dist/components/sign-in-view.d.ts

@@ -0,0 +1,41 @@
+import type { ReactNode } from 'react';
+import { LOCAL_DEV_CREDENTIALS } from '@elytracms/studio/lib/auth';
+import type { SignInResult } from '@elytracms/studio/lib/auth';
+type AuthMode = 'signin' | 'signup';
+/** A seeded dev-credential entry surfaced in playground mode (fixtures, not secrets). */
+type DevCredential = (typeof LOCAL_DEV_CREDENTIALS)[number];
+export interface SignInViewProps {
+    /**
+     * Brand mark rendered above the heading. Defaults to the neutral studio
+     * placeholder square — a future logo just passes a node here (e.g.
+     * `component: () => <SignInView brandMark={<Logo />} />`), no engine change.
+     */
+    brandMark?: ReactNode;
+    /** Product name in the "Sign in to …" heading. Default: `'Elytra'`. */
+    productName?: string;
+}
+/**
+ * The `/sign-in` route component. Container: reads the router (post-sign-in
+ * redirect target from the route search) + auth seams and hands the pure
+ * presentational screen its data plus an `authenticate` callback.
+ */
+export declare function SignInView({ brandMark, productName }: SignInViewProps): import("react").JSX.Element;
+interface SignInScreenProps {
+    projectName: string | null;
+    /** Whether to offer the sign-in ↔ create-account toggle (convex mode only). */
+    showModeToggle: boolean;
+    /** Seeded dev accounts to list (playground mode), or null to hide the hint. */
+    devCredentials: readonly DevCredential[] | null;
+    brandMark?: ReactNode;
+    productName?: string;
+    /** Attempt auth for the chosen mode. The container maps this to signIn/signUp. */
+    authenticate: (mode: AuthMode, email: string, password: string) => Promise<SignInResult>;
+    /** Called once, after a successful authentication (the container navigates). */
+    onAuthenticated: () => void | Promise<void>;
+}
+/**
+ * Provider-free presentational sign-in screen. Owns only local form state and
+ * calls injected callbacks — no context hooks — so it static-renders in tests.
+ */
+export declare function SignInScreen({ projectName, showModeToggle, devCredentials, brandMark, productName, authenticate, onAuthenticated, }: SignInScreenProps): import("react").JSX.Element;
+export {};

package/dist/components/sign-in-view.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { useNavigate, useSearch } from '@tanstack/react-router';
+import { Button, Card, CardContent, Field, Heading, Input, Stack, Text } from '@elytracms/studio/ui';
+import { useAuth } from '@elytracms/studio/components/auth-context';
+import { LOCAL_DEV_CREDENTIALS, authMode, postSignInTarget } from '@elytracms/studio/lib/auth';
+import { getActiveProjectSlug, getWorkspaceState } from '@elytracms/studio/lib/workspace';
+/** The project whose backend this sign-in authenticates against (EC-179). */
+function activeProjectName() {
+    const state = getWorkspaceState();
+    if (state.kind !== 'config')
+        return null;
+    const slug = getActiveProjectSlug();
+    const project = (slug && state.projects.find((p) => p.slug === slug)) || state.projects[0];
+    return project?.name ?? null;
+}
+/**
+ * The `/sign-in` route component. Container: reads the router (post-sign-in
+ * redirect target from the route search) + auth seams and hands the pure
+ * presentational screen its data plus an `authenticate` callback.
+ */
+export function SignInView({ brandMark, productName }) {
+    const auth = useAuth();
+    const navigate = useNavigate();
+    // Self-source the redirect (loose search — the consumer route's `validateSearch`
+    // guarantees `{ redirect?: string }`), so the route file needs no wrapper.
+    const search = useSearch({ strict: false });
+    const redirect = search.redirect;
+    return (_jsx(SignInScreen, { projectName: activeProjectName(), showModeToggle: authMode() === 'convex', devCredentials: authMode() === 'playground' ? LOCAL_DEV_CREDENTIALS : null, brandMark: brandMark, productName: productName, authenticate: (mode, email, password) => mode === 'signup' ? auth.signUp(email, password) : auth.signIn(email, password), onAuthenticated: () => navigate({ to: postSignInTarget(redirect) }) }));
+}
+/**
+ * Provider-free presentational sign-in screen. Owns only local form state and
+ * calls injected callbacks — no context hooks — so it static-renders in tests.
+ */
+export function SignInScreen({ projectName, showModeToggle, devCredentials, brandMark, productName = 'Elytra', authenticate, onAuthenticated, }) {
+    const [email, setEmail] = useState('');
+    const [password, setPassword] = useState('');
+    const [phase, setPhase] = useState('idle');
+    const [mode, setMode] = useState('signin');
+    const [error, setError] = useState(null);
+    async function handleSubmit(event) {
+        event.preventDefault();
+        setPhase('submitting');
+        setError(null);
+        const result = await authenticate(mode, email, password);
+        if (result.ok) {
+            await onAuthenticated();
+            return;
+        }
+        // A fresh backend has no account yet: nudge sign-in → create, and vice versa.
+        if (result.reason === 'account-exists')
+            setMode('signin');
+        setError(result.message);
+        setPhase('idle');
+    }
+    const submitting = phase === 'submitting';
+    const creating = mode === 'signup';
+    return (_jsx("div", { className: "grid min-h-dvh place-items-center bg-background p-6", children: _jsxs(Stack, { gap: "4", className: "w-full max-w-sm", children: [_jsxs(Stack, { gap: "1", align: "center", children: [brandMark ?? _jsx("span", { className: "size-8 rounded-lg bg-primary shadow-sm", "aria-hidden": true }), _jsx(Heading, { size: "h2", children: creating ? 'Create your account' : `Sign in to ${productName}` }), _jsx(Text, { size: "sm", tone: "muted", children: projectName
+                                ? `${creating ? 'Register on' : 'Continue to'} ${projectName}.`
+                                : 'Use your studio account to continue.' })] }), _jsx(Card, { children: _jsx(CardContent, { className: "pt-5", children: _jsx("form", { onSubmit: handleSubmit, noValidate: true, children: _jsxs(Stack, { gap: "4", children: [_jsx(Field, { label: "Email", htmlFor: "sign-in-email", required: true, children: _jsx(Input, { id: "sign-in-email", type: "email", autoComplete: "email", value: email, onChange: (e) => setEmail(e.target.value), placeholder: "you@example.com", disabled: submitting }) }), _jsx(Field, { label: "Password", htmlFor: "sign-in-password", required: true, error: error, children: _jsx(Input, { id: "sign-in-password", type: "password", autoComplete: creating ? 'new-password' : 'current-password', value: password, onChange: (e) => setPassword(e.target.value), disabled: submitting }) }), _jsx(Button, { type: "submit", disabled: submitting, className: "w-full", children: submitting
+                                            ? creating
+                                                ? 'Creating account…'
+                                                : 'Signing in…'
+                                            : creating
+                                                ? 'Create account'
+                                                : 'Sign in' })] }) }) }) }), showModeToggle ? (_jsxs(Text, { size: "sm", tone: "muted", className: "text-center", children: [creating ? 'Already have an account on this backend? ' : 'First time on this backend? ', _jsx("button", { type: "button", className: "font-medium text-primary underline-offset-2 hover:underline", onClick: () => {
+                                setMode(creating ? 'signin' : 'signup');
+                                setError(null);
+                            }, children: creating ? 'Sign in' : 'Create an account' })] })) : null, devCredentials ? _jsx(DevCredentialsHint, { entries: devCredentials }) : null] }) }));
+}
+/** Seeded dev accounts for the explicit playground mode — fixtures, not secrets. */
+function DevCredentialsHint({ entries }) {
+    return (_jsx(Card, { className: "border-dashed", children: _jsx(CardContent, { className: "pt-4", children: _jsxs(Stack, { gap: "1", children: [_jsx(Text, { size: "xs", tone: "muted", className: "font-medium", children: "Playground mode \u2014 seeded dev accounts" }), entries.map((entry) => (_jsxs(Text, { size: "xs", tone: "muted", className: "font-mono", children: [entry.user.email, " / ", entry.password] }, entry.user.id)))] }) }) }));
+}
+//# sourceMappingURL=sign-in-view.js.map

package/dist/components/sign-in-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-in-view.js","sourceRoot":"","sources":["../../src/components/sign-in-view.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useState } from 'react'\nimport type { FormEvent, ReactNode } from 'react'\nimport { useNavigate, useSearch } from '@tanstack/react-router'\nimport { Button, Card, CardContent, Field, Heading, Input, Stack, Text } from '@elytracms/studio/ui'\nimport { useAuth } from '@elytracms/studio/components/auth-context'\nimport { LOCAL_DEV_CREDENTIALS, authMode, postSignInTarget } from '@elytracms/studio/lib/auth'\nimport type { SignInResult } from '@elytracms/studio/lib/auth'\nimport { getActiveProjectSlug, getWorkspaceState } from '@elytracms/studio/lib/workspace'\n\n/**\n * Engine-shipped `/sign-in` screen (EC-150; consolidated from the copy-pasted\n * consumer route by EC-375, EC-369 finding #8). The consumer route file keeps\n * only the route object — `createFileRoute('/sign-in')({ validateSearch,\n * component: SignInView })` — because TanStack Router requires the route object\n * to live in the consumer's route tree; the ~140-line body lives here so a\n * copy never drifts.\n *\n * Deterministic states: idle → submitting → (signed-in redirect | inline\n * structured failure). Invalid credentials are a rendered state, never a silent\n * failure or crash. In playground (in-memory) mode the seeded dev credentials\n * are listed so the whole flow works offline.\n *\n * Split into a `SignInView` container (owns the router + auth seams) and a\n * provider-free `SignInScreen` (pure local form state + injected callbacks) so\n * the screen static-renders in a node smoke test without the full provider tree.\n */\n\ntype FormPhase = 'idle' | 'submitting'\ntype AuthMode = 'signin' | 'signup'\n\n/** A seeded dev-credential entry surfaced in playground mode (fixtures, not secrets). */\ntype DevCredential = (typeof LOCAL_DEV_CREDENTIALS)[number]\n\nexport interface SignInViewProps {\n  /**\n   * Brand mark rendered above the heading. Defaults to the neutral studio\n   * placeholder square — a future logo just passes a node here (e.g.\n   * `component: () => <SignInView brandMark={<Logo />} />`), no engine change.\n   */\n  brandMark?: ReactNode\n  /** Product name in the \"Sign in to …\" heading. Default: `'Elytra'`. */\n  productName?: string\n}\n\n/** The project whose backend this sign-in authenticates against (EC-179). */\nfunction activeProjectName(): string | null {\n  const state = getWorkspaceState()\n  if (state.kind !== 'config') return null\n  const slug = getActiveProjectSlug()\n  const project = (slug && state.projects.find((p) => p.slug === slug)) || state.projects[0]\n  return project?.name ?? null\n}\n\n/**\n * The `/sign-in` route component. Container: reads the router (post-sign-in\n * redirect target from the route search) + auth seams and hands the pure\n * presentational screen its data plus an `authenticate` callback.\n */\nexport function SignInView({ brandMark, productName }: SignInViewProps) {\n  const auth = useAuth()\n  const navigate = useNavigate()\n  // Self-source the redirect (loose search — the consumer route's `validateSearch`\n  // guarantees `{ redirect?: string }`), so the route file needs no wrapper.\n  const search = useSearch({ strict: false }) as { redirect?: string }\n  const redirect = search.redirect\n\n  return (\n    <SignInScreen\n      projectName={activeProjectName()}\n      showModeToggle={authMode() === 'convex'}\n      devCredentials={authMode() === 'playground' ? LOCAL_DEV_CREDENTIALS : null}\n      brandMark={brandMark}\n      productName={productName}\n      authenticate={(mode, email, password) =>\n        mode === 'signup' ? auth.signUp(email, password) : auth.signIn(email, password)\n      }\n      onAuthenticated={() => navigate({ to: postSignInTarget(redirect) })}\n    />\n  )\n}\n\ninterface SignInScreenProps {\n  projectName: string | null\n  /** Whether to offer the sign-in ↔ create-account toggle (convex mode only). */\n  showModeToggle: boolean\n  /** Seeded dev accounts to list (playground mode), or null to hide the hint. */\n  devCredentials: readonly DevCredential[] | null\n  brandMark?: ReactNode\n  productName?: string\n  /** Attempt auth for the chosen mode. The container maps this to signIn/signUp. */\n  authenticate: (mode: AuthMode, email: string, password: string) => Promise<SignInResult>\n  /** Called once, after a successful authentication (the container navigates). */\n  onAuthenticated: () => void | Promise<void>\n}\n\n/**\n * Provider-free presentational sign-in screen. Owns only local form state and\n * calls injected callbacks — no context hooks — so it static-renders in tests.\n */\nexport function SignInScreen({\n  projectName,\n  showModeToggle,\n  devCredentials,\n  brandMark,\n  productName = 'Elytra',\n  authenticate,\n  onAuthenticated,\n}: SignInScreenProps) {\n  const [email, setEmail] = useState('')\n  const [password, setPassword] = useState('')\n  const [phase, setPhase] = useState<FormPhase>('idle')\n  const [mode, setMode] = useState<AuthMode>('signin')\n  const [error, setError] = useState<string | null>(null)\n\n  async function handleSubmit(event: FormEvent<HTMLFormElement>) {\n    event.preventDefault()\n    setPhase('submitting')\n    setError(null)\n    const result = await authenticate(mode, email, password)\n    if (result.ok) {\n      await onAuthenticated()\n      return\n    }\n    // A fresh backend has no account yet: nudge sign-in → create, and vice versa.\n    if (result.reason === 'account-exists') setMode('signin')\n    setError(result.message)\n    setPhase('idle')\n  }\n\n  const submitting = phase === 'submitting'\n  const creating = mode === 'signup'\n\n  return (\n    <div className=\"grid min-h-dvh place-items-center bg-background p-6\">\n      <Stack gap=\"4\" className=\"w-full max-w-sm\">\n        <Stack gap=\"1\" align=\"center\">\n          {brandMark ?? <span className=\"size-8 rounded-lg bg-primary shadow-sm\" aria-hidden />}\n          <Heading size=\"h2\">\n            {creating ? 'Create your account' : `Sign in to ${productName}`}\n          </Heading>\n          <Text size=\"sm\" tone=\"muted\">\n            {projectName\n              ? `${creating ? 'Register on' : 'Continue to'} ${projectName}.`\n              : 'Use your studio account to continue.'}\n          </Text>\n        </Stack>\n\n        <Card>\n          <CardContent className=\"pt-5\">\n            <form onSubmit={handleSubmit} noValidate>\n              <Stack gap=\"4\">\n                <Field label=\"Email\" htmlFor=\"sign-in-email\" required>\n                  <Input\n                    id=\"sign-in-email\"\n                    type=\"email\"\n                    autoComplete=\"email\"\n                    value={email}\n                    onChange={(e) => setEmail(e.target.value)}\n                    placeholder=\"you@example.com\"\n                    disabled={submitting}\n                  />\n                </Field>\n                <Field label=\"Password\" htmlFor=\"sign-in-password\" required error={error}>\n                  <Input\n                    id=\"sign-in-password\"\n                    type=\"password\"\n                    autoComplete={creating ? 'new-password' : 'current-password'}\n                    value={password}\n                    onChange={(e) => setPassword(e.target.value)}\n                    disabled={submitting}\n                  />\n                </Field>\n                <Button type=\"submit\" disabled={submitting} className=\"w-full\">\n                  {submitting\n                    ? creating\n                      ? 'Creating account…'\n                      : 'Signing in…'\n                    : creating\n                      ? 'Create account'\n                      : 'Sign in'}\n                </Button>\n              </Stack>\n            </form>\n          </CardContent>\n        </Card>\n\n        {showModeToggle ? (\n          <Text size=\"sm\" tone=\"muted\" className=\"text-center\">\n            {creating ? 'Already have an account on this backend? ' : 'First time on this backend? '}\n            <button\n              type=\"button\"\n              className=\"font-medium text-primary underline-offset-2 hover:underline\"\n              onClick={() => {\n                setMode(creating ? 'signin' : 'signup')\n                setError(null)\n              }}\n            >\n              {creating ? 'Sign in' : 'Create an account'}\n            </button>\n          </Text>\n        ) : null}\n\n        {devCredentials ? <DevCredentialsHint entries={devCredentials} /> : null}\n      </Stack>\n    </div>\n  )\n}\n\n/** Seeded dev accounts for the explicit playground mode — fixtures, not secrets. */\nfunction DevCredentialsHint({ entries }: { entries: readonly DevCredential[] }) {\n  return (\n    <Card className=\"border-dashed\">\n      <CardContent className=\"pt-4\">\n        <Stack gap=\"1\">\n          <Text size=\"xs\" tone=\"muted\" className=\"font-medium\">\n            Playground mode — seeded dev accounts\n          </Text>\n          {entries.map((entry) => (\n            <Text key={entry.user.id} size=\"xs\" tone=\"muted\" className=\"font-mono\">\n              {entry.user.email} / {entry.password}\n            </Text>\n          ))}\n        </Stack>\n      </CardContent>\n    </Card>\n  )\n}\n"]}

package/dist/lib/ai/convex-session-headers.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `createConvexSessionHeaders` — the CLIENT half of the engine-default AI session
+ * gate (EC-371). It supplies the `headers` thunk `createRouteProvider` re-evaluates
+ * per request, attaching the signed-in user's Convex Auth JWT as
+ * `authorization: Bearer <token>` so the route's {@link createConvexJwtSessionResolver}
+ * can verify it against the deployment's JWKS.
+ *
+ * Two storage conventions, owned HERE and nowhere else:
+ *
+ * 1. **The engine's own session store (primary).** The studio's `ConvexAuthAdapter`
+ *    (`lib/auth`) persists the JWT in `sessionStorage` under
+ *    `elytra.convex-auth.jwt` / `elytra.convex-auth.jwt::<deployment-url>`
+ *    (per-backend sessions, EC-179). This covers every engine studio sign-in,
+ *    including the dev-login path. The prefix is pinned against `tokenStorageKey()`
+ *    by a drift test in `convex-session-headers.test.ts` — if `lib/auth` ever
+ *    renames it, that test fails loudly.
+ * 2. **The `@convex-dev/auth` react-client store (fallback).** Hosts that mount the
+ *    official `ConvexAuthProvider` get the JWT persisted in `localStorage` under a
+ *    key starting with `__convexAuthJWT` — an INTERNAL convention of that package,
+ *    not a public API. If a future upgrade renames it, the token is simply not
+ *    found and the assistant fails CLOSED (401) — never open.
+ *
+ * A playground/local studio has no Convex session, so the thunk returns `undefined`
+ * (no auth header); the route then rejects unless the loud dev-only opt-in on
+ * `createAiDevPlugin` is active. Browser-only reads; SSR yields no header.
+ *
+ * Note on multiple per-backend sessions: the scan returns the first token found;
+ * a token minted by a DIFFERENT deployment fails the route's issuer/JWKS check and
+ * yields 401 (fail-closed), never a cross-deployment pass.
+ */
+/**
+ * The engine `ConvexAuthAdapter` sessionStorage key prefix (`lib/auth`,
+ * `tokenStorageKey()`), duplicated here so `lib/ai` carries no runtime edge into
+ * the auth adapter (which pulls the Convex client). Drift-pinned by test.
+ */
+export declare const ELYTRA_CONVEX_JWT_STORAGE_PREFIX = "elytra.convex-auth.jwt";
+/** The `@convex-dev/auth`-internal localStorage key prefix carrying the fresh JWT. */
+export declare const CONVEX_AUTH_JWT_STORAGE_PREFIX = "__convexAuthJWT";
+/** The read-only subset of DOM `Storage` the token scan needs (test seam). */
+export interface TokenStorageLike {
+    readonly length: number;
+    key(index: number): string | null;
+    getItem(key: string): string | null;
+}
+/** First non-empty value under a key starting with `prefix`; `null` when absent. */
+export declare function readTokenByPrefix(storage: TokenStorageLike | null | undefined, prefix: string): string | null;
+export interface ConvexSessionStorages {
+    /** The engine adapter's store (default: `window.sessionStorage`). */
+    sessionStorage?: TokenStorageLike | null;
+    /** The @convex-dev/auth react-client store (default: `window.localStorage`). */
+    localStorage?: TokenStorageLike | null;
+}
+/**
+ * Read the current Convex Auth JWT: the engine's sessionStorage convention first,
+ * then the `@convex-dev/auth` localStorage convention. Pure over the injected
+ * storages; `null` when signed out (or outside a browser).
+ */
+export declare function readConvexAuthToken(storages: ConvexSessionStorages): string | null;
+export interface ConvexSessionHeadersOptions {
+    /** Storage accessor override (default: the browser's session/local storages). */
+    storages?: () => ConvexSessionStorages;
+}
+/**
+ * Build the `headers` thunk for `createRouteProvider({ headers })`. Re-evaluated on
+ * every request, so a refreshed token is picked up automatically; `undefined` (no
+ * header) when no session token exists.
+ */
+export declare function createConvexSessionHeaders(options?: ConvexSessionHeadersOptions): () => HeadersInit | undefined;