@elytracms/studio 0.0.17 → 0.0.19

package/dist/components/app-views/sidebar.js

@@ -1,153 +1,148 @@
 import { useMemo } from 'react';
 import { resolveOverrides } from '@elytracms/core/studio-core';
-import { resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace';
-import { moduleAvailability } from './module';
-import { useAppViews } from './default-modules';
-// --- Builder helpers (the typed consumer API; carry live icons) ---
-/** A nav item; `id` defaults to `moduleId` when omitted. */
-export function navItem(config) {
-    return {
-        kind: 'item',
-        id: config.id ?? config.moduleId,
-        moduleId: config.moduleId,
-        ...(config.label !== undefined ? { label: config.label } : {}),
-        ...(config.icon !== undefined ? { icon: config.icon } : {}),
-        ...(config.deepLink !== undefined ? { deepLink: config.deepLink } : {}),
-    };
-}
-/** A labelled group of sub-items; `id` defaults to a slug of the label. */
-export function navGroup(label, items, opts = {}) {
-    return { kind: 'group', id: opts.id ?? slugify(label), label, items };
-}
-/** A divider between rail sections. */
-export function navSeparator(id) {
-    return { kind: 'separator', ...(id !== undefined ? { id } : {}) };
-}
-/** Identity helper that types a consumer's `config.sidebar` array. */
-export function defineSidebar(nodes) {
-    return nodes;
-}
-function slugify(label) {
-    return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'group';
-}
-// --- Resolution (EC-236 seam) ---
-/** The default rail: every non-hidden module as a plain item, in registry order. */
-function defaultSidebar(modules) {
-    return modules
-        .filter((module) => !module.hidden)
-        .map((module) => ({ kind: 'item', id: module.id, moduleId: module.id }));
+import { resolveDeploymentCollections, resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace';
+import { firstAvailableView, moduleAvailability, viewNode, } from './module';
+import { DEFAULT_VIEWS } from './default-modules';
+/** The default rail: every non-hidden built-in view as a plain entry, in canonical order. */
+function defaultRail() {
+    return DEFAULT_VIEWS.filter((view) => !view.hidden).map(viewNode);
 }
-/** The `_splat` path for an item (module id + its deep-link segments). */
-function itemPath(item) {
-    return [item.moduleId, ...(item.deepLink ?? [])].join('/');
+/**
+ * The sub-views a view node contributes (EC-293): explicit `children`, else
+ * `expand(collections)` (CMS auto-expansion), else none. Groups never nest, so this
+ * applies to top-level view nodes only.
+ */
+function childNodesOf(node, collections) {
+    return node.children ?? node.expand?.(collections) ?? [];
 }
-/** Validate one item against the registry — unknown module or unresolvable deep-link. */
-function validateItem(registry, item) {
-    const module = registry.get(item.moduleId);
-    if (!module)
-        return `targets module "${item.moduleId}", which is not registered`;
-    if (item.deepLink && item.deepLink.length > 0) {
-        const parse = module.parsePath;
-        if (!parse) {
-            return `deep-links into module "${item.moduleId}", which takes no path`;
+/**
+ * Every view the rail references, in rail order: each top-level view, then its nested
+ * children, then group children (groups are flat — their children never nest). This
+ * is the set fed to `resolveOverrides` + the derived registry.
+ */
+function railViews(nodes, collections) {
+    const views = [];
+    for (const node of nodes) {
+        if (node.kind === 'view') {
+            views.push(node.view);
+            for (const child of childNodesOf(node, collections))
+                views.push(child.view);
         }
-        if (parse([...item.deepLink]) === null) {
-            return `deep-link "${item.deepLink.join('/')}" does not resolve in module "${item.moduleId}"`;
+        else if (node.kind === 'group') {
+            for (const child of node.children)
+                views.push(child.view);
         }
     }
-    return null;
+    return views;
 }
 /**
- * Resolve a consumer sidebar (or the default rail) over the app-view registry
- * through the shared customization core (EC-236). Every node — items, group
- * headers, nested items, separators — is keyed by id and run through
- * {@link resolveOverrides} for dedup + per-node validation, so a duplicate id or
- * an invalid item is a visible issue and is dropped; the surviving nodes are
- * rebuilt into the rail tree (groups keep their surviving sub-items).
+ * Resolve a consumer rail (or the default rail) into the display tree + the router
+ * registry through the EC-236 seam. Views are resolved over the built-in defaults
+ * (so an omitted built-in stays routable and a rail `cms` REPLACES the default
+ * one); groups/separators pass through as presentation.
+ *
+ * EC-293: a view node may nest. `collections` (config-sourced) materialises a CMS
+ * parent's per-collection children; every child view joins the override pass + the
+ * derived registry, so a nested `cms:<id>` lens routes and highlights like any view.
  */
-export function resolveSidebar(registry, project, entries) {
-    const config = entries ?? defaultSidebar(registry.modules);
-    const flat = [];
-    config.forEach((node, index) => {
-        if (node.kind === 'separator') {
-            flat.push({ id: node.id ?? `__separator:${index}`, value: { node, isItem: false } });
-            return;
-        }
-        if (node.kind === 'group') {
-            flat.push({ id: node.id, value: { node, isItem: false } });
-            node.items.forEach((item) => flat.push({ id: item.id, value: { node: item, isItem: true } }));
-            return;
-        }
-        flat.push({ id: node.id, value: { node, isItem: true } });
-    });
+export function resolveSidebar(entries, project, collections = []) {
+    const nodes = entries ?? defaultRail();
+    const railOrderViews = railViews(nodes, collections);
+    // Resolve the rail views over the built-in registry: dedup by id + contract
+    // check. Built-ins are the defaults (so omitted ones stay routable); rail views
+    // are overrides (a same-id rail view replaces the default; a new id is added).
     const resolved = resolveOverrides({
         point: 'sidebar',
-        defaults: [],
-        overrides: flat,
+        defaults: DEFAULT_VIEWS.map((view) => ({ id: view.id, value: view })),
+        overrides: railOrderViews.map((view) => ({ id: view.id, value: view })),
         allowNew: true,
-        validate: (entry) => entry.value.isItem
-            ? validateItem(registry, entry.value.node)
-            : null,
+        validate: (entry) => {
+            const view = entry.value;
+            if (typeof view.render !== 'function')
+                return 'the view has no render function';
+            if (typeof view.label !== 'string' || view.label.trim().length === 0)
+                return 'the view has no label';
+            return null;
+        },
     });
-    const survived = (id) => resolved.get(id) !== undefined;
-    const toItem = (item) => {
-        const module = registry.get(item.moduleId);
+    // Rail order for landing: each rail view (resolved), deduped, then the built-ins
+    // not in the rail (so Settings — always available — is the final landing fallback).
+    const inRail = new Set();
+    const landing = [];
+    for (const view of railOrderViews) {
+        const resolvedView = resolved.get(view.id);
+        if (resolvedView && !inRail.has(resolvedView.id)) {
+            inRail.add(resolvedView.id);
+            landing.push(resolvedView);
+        }
+    }
+    for (const view of DEFAULT_VIEWS)
+        if (!inRail.has(view.id))
+            landing.push(view);
+    const registry = { get: (id) => resolved.get(id), views: landing };
+    // Build the display tree. Each view id is emitted at most once (the first of a
+    // duplicate wins, matching `resolveOverrides`); a view dropped by validation is
+    // skipped here too.
+    const emitted = new Set();
+    const toRailView = (view) => {
+        const resolvedView = resolved.get(view.id);
+        if (!resolvedView || emitted.has(resolvedView.id))
+            return null;
+        emitted.add(resolvedView.id);
         return {
-            kind: 'item',
-            id: item.id,
-            moduleId: item.moduleId,
-            label: item.label ?? module.label,
-            icon: item.icon ?? module.icon,
-            path: itemPath(item),
-            availability: moduleAvailability(project, module),
+            kind: 'view',
+            id: resolvedView.id,
+            label: resolvedView.label,
+            icon: resolvedView.icon,
+            path: resolvedView.id,
+            availability: moduleAvailability(project, resolvedView),
         };
     };
-    // Emit each surviving id at most once — `resolveOverrides` keeps the first of a
-    // duplicate, so the rebuild must skip later occurrences of that same id too.
-    const emitted = new Set();
-    const claim = (id) => {
-        if (!survived(id) || emitted.has(id))
-            return false;
-        emitted.add(id);
-        return true;
-    };
-    const nodes = [];
-    config.forEach((node, index) => {
+    const railNodes = [];
+    for (const node of nodes) {
         if (node.kind === 'separator') {
-            const id = node.id ?? `__separator:${index}`;
-            if (claim(id))
-                nodes.push({ kind: 'separator', id });
-            return;
+            railNodes.push({ kind: 'separator' });
+            continue;
         }
         if (node.kind === 'group') {
-            if (!claim(node.id))
-                return;
-            const groupItems = node.items.filter((item) => claim(item.id)).map(toItem);
-            if (groupItems.length > 0) {
-                nodes.push({ kind: 'group', id: node.id, label: node.label, items: groupItems });
-            }
-            return;
+            const views = node.children.map((child) => toRailView(child.view)).filter(isRailView);
+            if (views.length > 0)
+                railNodes.push({ kind: 'group', label: node.label, views });
+            continue;
         }
-        if (claim(node.id))
-            nodes.push(toItem(node));
-    });
-    return { nodes, issues: resolved.issues };
+        // A top-level view, with its nested children (CMS collections) attached. The
+        // parent is emitted first so its id wins any duplicate; children follow in order.
+        const view = toRailView(node.view);
+        if (!view)
+            continue;
+        const children = childNodesOf(node, collections)
+            .map((child) => toRailView(child.view))
+            .filter(isRailView);
+        if (children.length > 0)
+            view.children = children;
+        railNodes.push(view);
+    }
+    return { nodes: railNodes, registry, issues: resolved.issues };
+}
+function isRailView(view) {
+    return view !== null;
 }
-/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */
-export function activeModuleFromPath(pathname) {
+/** The active view id parsed from a studio pathname `/<projectId>/<viewId>[/…]`. */
+export function activeViewIdFromPath(pathname) {
     return pathname.split('/')[2] || null;
 }
+/** The view a bare project URL should open to: the first navigable rail view (EC-221). */
+export function landingViewId(nav, project) {
+    return firstAvailableView(nav.registry.views, project)?.id ?? 'settings';
+}
 /**
- * The active project's resolved sidebar — the default rail or `config.sidebar`,
- * resolved over the module registry through the EC-236 seam (static per boot).
+ * The active project's resolved studio nav — the default rail or
+ * `studioConfig.sidebar`, resolved over the built-in views through the EC-236 seam
+ * (static per studio boot).
  */
-export function useSidebar(project) {
-    const registry = useAppViews();
-    return useMemo(() => {
-        // Config carries the sidebar opaquely (`SidebarEntry` = object); the studio
-        // owns + validates the rich item/group/separator shape, so cast it back here.
-        const entries = resolveDeploymentSidebar();
-        return resolveSidebar(registry, project, entries);
-    }, [registry, project]);
+export function useStudioNav(project) {
+    // `resolveDeploymentSidebar`/`resolveDeploymentCollections` are config-holder reads
+    // (stable per studio boot), so keying the memo on `project` alone is correct.
+    return useMemo(() => resolveSidebar(resolveDeploymentSidebar(), project, resolveDeploymentCollections()), [project]);
 }
 //# sourceMappingURL=sidebar.js.map

package/dist/components/app-views/sidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../../src/components/app-views/sidebar.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport { resolveOverrides } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue, Project, SectionAvailability } from '@elytracms/core/studio-core'\nimport { resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace'\nimport { moduleAvailability, type AppViewModule, type ResolvedAppViews } from './module'\nimport { useAppViews } from './default-modules'\n\n/**\n * EC-237 — the configurable sidebar, an instance of the EC-236 customization seam.\n *\n * The section rail is a consumer-extendable ARRAY of nav entries — items (each\n * targeting an EC-239 app-view module, optionally deep-linked to a resource),\n * groups of sub-items, and separators. A consuming repo supplies its own array\n * through `config.sidebar`; omitted → the studio derives the default rail from its\n * module registry (every non-hidden module, in order). The supplied array is\n * resolved through the shared {@link resolveOverrides} core: a duplicate id, an\n * item whose target module isn't registered (\"unknown view\"), or a deep-link that\n * doesn't resolve becomes a visible {@link CustomizationIssue} and the entry is\n * dropped — never a silent failure. Sub-views (a focused \"Taxonomy\") are EC-239\n * modules; this file decides only how the rail PRESENTS and orders them.\n */\n\n// --- Consumer config shapes (typed builder helpers below) ---\n\n/** A nav item targeting an app-view module, optionally deep-linked to a resource. */\nexport interface SidebarItemConfig {\n  kind: 'item'\n  /** Stable id (defaults to `moduleId` via {@link navItem}). */\n  id: string\n  /** The app-view module this item mounts — must be in the registry. */\n  moduleId: string\n  /** Overrides the module's rail label. */\n  label?: string\n  /** Overrides the module's rail icon. */\n  icon?: LucideIcon\n  /** Trailing path segments targeting a specific resource, e.g. `['category']`. */\n  deepLink?: readonly string[]\n}\n\nexport interface SidebarGroupConfig {\n  kind: 'group'\n  id: string\n  label: string\n  items: SidebarItemConfig[]\n}\n\nexport interface SidebarSeparatorConfig {\n  kind: 'separator'\n  id?: string\n}\n\nexport type SidebarNodeConfig = SidebarItemConfig | SidebarGroupConfig | SidebarSeparatorConfig\n\n// --- Resolved (rail-ready) shapes ---\n\nexport interface ResolvedSidebarItem {\n  kind: 'item'\n  id: string\n  moduleId: string\n  label: string\n  icon: LucideIcon\n  /** The `_splat` to navigate to (moduleId + deep-link segments). */\n  path: string\n  availability: SectionAvailability\n}\nexport interface ResolvedSidebarGroup {\n  kind: 'group'\n  id: string\n  label: string\n  items: ResolvedSidebarItem[]\n}\nexport interface ResolvedSidebarSeparator {\n  kind: 'separator'\n  id: string\n}\nexport type ResolvedSidebarNode =\n  | ResolvedSidebarItem\n  | ResolvedSidebarGroup\n  | ResolvedSidebarSeparator\n\nexport interface ResolvedSidebar {\n  nodes: ResolvedSidebarNode[]\n  issues: CustomizationIssue[]\n}\n\n// --- Builder helpers (the typed consumer API; carry live icons) ---\n\n/** A nav item; `id` defaults to `moduleId` when omitted. */\nexport function navItem(\n  config: Omit<SidebarItemConfig, 'kind' | 'id'> & { id?: string },\n): SidebarItemConfig {\n  return {\n    kind: 'item',\n    id: config.id ?? config.moduleId,\n    moduleId: config.moduleId,\n    ...(config.label !== undefined ? { label: config.label } : {}),\n    ...(config.icon !== undefined ? { icon: config.icon } : {}),\n    ...(config.deepLink !== undefined ? { deepLink: config.deepLink } : {}),\n  }\n}\n\n/** A labelled group of sub-items; `id` defaults to a slug of the label. */\nexport function navGroup(\n  label: string,\n  items: SidebarItemConfig[],\n  opts: { id?: string } = {},\n): SidebarGroupConfig {\n  return { kind: 'group', id: opts.id ?? slugify(label), label, items }\n}\n\n/** A divider between rail sections. */\nexport function navSeparator(id?: string): SidebarSeparatorConfig {\n  return { kind: 'separator', ...(id !== undefined ? { id } : {}) }\n}\n\n/** Identity helper that types a consumer's `config.sidebar` array. */\nexport function defineSidebar(nodes: SidebarNodeConfig[]): SidebarNodeConfig[] {\n  return nodes\n}\n\nfunction slugify(label: string): string {\n  return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'group'\n}\n\n// --- Resolution (EC-236 seam) ---\n\n/** The default rail: every non-hidden module as a plain item, in registry order. */\nfunction defaultSidebar(modules: readonly AppViewModule[]): SidebarItemConfig[] {\n  return modules\n    .filter((module) => !module.hidden)\n    .map((module) => ({ kind: 'item', id: module.id, moduleId: module.id }))\n}\n\n/** The `_splat` path for an item (module id + its deep-link segments). */\nfunction itemPath(item: SidebarItemConfig): string {\n  return [item.moduleId, ...(item.deepLink ?? [])].join('/')\n}\n\n/** Validate one item against the registry — unknown module or unresolvable deep-link. */\nfunction validateItem(registry: ResolvedAppViews, item: SidebarItemConfig): string | null {\n  const module = registry.get(item.moduleId)\n  if (!module) return `targets module \"${item.moduleId}\", which is not registered`\n  if (item.deepLink && item.deepLink.length > 0) {\n    const parse = module.parsePath\n    if (!parse) {\n      return `deep-links into module \"${item.moduleId}\", which takes no path`\n    }\n    if (parse([...item.deepLink]) === null) {\n      return `deep-link \"${item.deepLink.join('/')}\" does not resolve in module \"${item.moduleId}\"`\n    }\n  }\n  return null\n}\n\n/**\n * Resolve a consumer sidebar (or the default rail) over the app-view registry\n * through the shared customization core (EC-236). Every node — items, group\n * headers, nested items, separators — is keyed by id and run through\n * {@link resolveOverrides} for dedup + per-node validation, so a duplicate id or\n * an invalid item is a visible issue and is dropped; the surviving nodes are\n * rebuilt into the rail tree (groups keep their surviving sub-items).\n */\nexport function resolveSidebar(\n  registry: ResolvedAppViews,\n  project: Project,\n  entries?: readonly SidebarNodeConfig[],\n): ResolvedSidebar {\n  const config = entries ?? defaultSidebar(registry.modules)\n\n  // Flatten the tree into a single keyspace so dedup + validation route through\n  // the shared core. Separators without an id get a positional one (never a user\n  // collision); groups + items keep theirs. `value` carries the node for validate.\n  type Flat = { node: SidebarNodeConfig; isItem: boolean }\n  const flat: { id: string; value: Flat }[] = []\n  config.forEach((node, index) => {\n    if (node.kind === 'separator') {\n      flat.push({ id: node.id ?? `__separator:${index}`, value: { node, isItem: false } })\n      return\n    }\n    if (node.kind === 'group') {\n      flat.push({ id: node.id, value: { node, isItem: false } })\n      node.items.forEach((item) => flat.push({ id: item.id, value: { node: item, isItem: true } }))\n      return\n    }\n    flat.push({ id: node.id, value: { node, isItem: true } })\n  })\n\n  const resolved = resolveOverrides<Flat>({\n    point: 'sidebar',\n    defaults: [],\n    overrides: flat,\n    allowNew: true,\n    validate: (entry) =>\n      entry.value.isItem\n        ? validateItem(registry, entry.value.node as SidebarItemConfig)\n        : null,\n  })\n  const survived = (id: string) => resolved.get(id) !== undefined\n\n  const toItem = (item: SidebarItemConfig): ResolvedSidebarItem => {\n    const module = registry.get(item.moduleId)!\n    return {\n      kind: 'item',\n      id: item.id,\n      moduleId: item.moduleId,\n      label: item.label ?? module.label,\n      icon: item.icon ?? module.icon,\n      path: itemPath(item),\n      availability: moduleAvailability(project, module),\n    }\n  }\n\n  // Emit each surviving id at most once — `resolveOverrides` keeps the first of a\n  // duplicate, so the rebuild must skip later occurrences of that same id too.\n  const emitted = new Set<string>()\n  const claim = (id: string) => {\n    if (!survived(id) || emitted.has(id)) return false\n    emitted.add(id)\n    return true\n  }\n\n  const nodes: ResolvedSidebarNode[] = []\n  config.forEach((node, index) => {\n    if (node.kind === 'separator') {\n      const id = node.id ?? `__separator:${index}`\n      if (claim(id)) nodes.push({ kind: 'separator', id })\n      return\n    }\n    if (node.kind === 'group') {\n      if (!claim(node.id)) return\n      const groupItems = node.items.filter((item) => claim(item.id)).map(toItem)\n      if (groupItems.length > 0) {\n        nodes.push({ kind: 'group', id: node.id, label: node.label, items: groupItems })\n      }\n      return\n    }\n    if (claim(node.id)) nodes.push(toItem(node))\n  })\n\n  return { nodes, issues: resolved.issues }\n}\n\n/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */\nexport function activeModuleFromPath(pathname: string): string | null {\n  return pathname.split('/')[2] || null\n}\n\n/**\n * The active project's resolved sidebar — the default rail or `config.sidebar`,\n * resolved over the module registry through the EC-236 seam (static per boot).\n */\nexport function useSidebar(project: Project): ResolvedSidebar {\n  const registry = useAppViews()\n  return useMemo(() => {\n    // Config carries the sidebar opaquely (`SidebarEntry` = object); the studio\n    // owns + validates the rich item/group/separator shape, so cast it back here.\n    const entries = resolveDeploymentSidebar() as readonly SidebarNodeConfig[] | undefined\n    return resolveSidebar(registry, project, entries)\n  }, [registry, project])\n}\n"]}
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../../src/components/app-views/sidebar.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport { resolveOverrides } from '@elytracms/core/studio-core'\nimport type { CustomizationIssue, Project, SectionAvailability } from '@elytracms/core/studio-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { resolveDeploymentCollections, resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace'\nimport {\n  firstAvailableView,\n  moduleAvailability,\n  viewNode,\n  type AppViewModule,\n  type SidebarNode,\n  type SidebarViewNode,\n} from './module'\nimport { DEFAULT_VIEWS } from './default-modules'\n\n/**\n * EC-237 — resolving the configurable section rail, an instance of the EC-236\n * customization seam.\n *\n * A consuming repo supplies its rail as a `SidebarNode[]` (built from `nav.*`);\n * omitted → the studio derives the default rail from its built-in views. The rail\n * IS the set of views — each view node carries its view object directly — so this\n * resolver does two things at once:\n *\n *   1. **Renders the rail.** Walk the nodes into display-ready entries (views,\n *      groups, separators) with per-view availability (EC-221) and a route path.\n *   2. **Derives the router registry.** Collect every rail view + the always-on\n *      built-ins (so deep-links resolve even for views a rail omits), keyed by id.\n *\n * Only VIEWS occupy the id-keyspace; groups + separators are presentation with no\n * id, so a group label can never collide with a view (the old duplicate-id bug).\n * Views resolve through the shared {@link resolveOverrides} core: a duplicate view\n * id or a view missing `render`/`label` is a visible {@link CustomizationIssue} and\n * is dropped — never silent. The active rail item is matched by the view id in the\n * URL, so two views backed by the same surface (Content vs. a focused Categories)\n * highlight independently.\n */\n\n// --- Resolved (rail-ready) shapes ---\n\nexport interface ResolvedRailView {\n  kind: 'view'\n  /** The view id — the route segment and the active-state key. */\n  id: string\n  label: string\n  icon: LucideIcon\n  /** The `_splat` to navigate to (the view's home route = its id). */\n  path: string\n  availability: SectionAvailability\n  /**\n   * EC-293: nested sub-views (e.g. a CMS view's collections), rendered indented\n   * under this view. Present only on a parent that expanded; leaves omit it.\n   */\n  children?: ResolvedRailView[]\n}\nexport interface ResolvedRailGroup {\n  kind: 'group'\n  label: string\n  views: ResolvedRailView[]\n}\nexport interface ResolvedRailSeparator {\n  kind: 'separator'\n}\nexport type ResolvedRailNode = ResolvedRailView | ResolvedRailGroup | ResolvedRailSeparator\n\n/** The router registry derived from the rail: id → view, plus the landing order. */\nexport interface ViewRegistry {\n  /** Resolve a view id to its module (rail views + always-on built-ins). */\n  get(id: string): AppViewModule | undefined\n  /** Views in landing order (rail order first, then non-rail built-ins). */\n  views: AppViewModule[]\n}\n\nexport interface StudioNav {\n  /** The display-ready rail (for {@link import('../section-nav').SectionNav}). */\n  nodes: ResolvedRailNode[]\n  /** The router registry (for the screen resolver + breadcrumb). */\n  registry: ViewRegistry\n  /** Customization issues (duplicate view id, invalid view) — visible, never silent. */\n  issues: CustomizationIssue[]\n}\n\n/** The default rail: every non-hidden built-in view as a plain entry, in canonical order. */\nfunction defaultRail(): SidebarNode[] {\n  return DEFAULT_VIEWS.filter((view) => !view.hidden).map(viewNode)\n}\n\n/**\n * The sub-views a view node contributes (EC-293): explicit `children`, else\n * `expand(collections)` (CMS auto-expansion), else none. Groups never nest, so this\n * applies to top-level view nodes only.\n */\nfunction childNodesOf(\n  node: SidebarViewNode,\n  collections: readonly CollectionDef[],\n): SidebarViewNode[] {\n  return node.children ?? node.expand?.(collections) ?? []\n}\n\n/**\n * Every view the rail references, in rail order: each top-level view, then its nested\n * children, then group children (groups are flat — their children never nest). This\n * is the set fed to `resolveOverrides` + the derived registry.\n */\nfunction railViews(\n  nodes: readonly SidebarNode[],\n  collections: readonly CollectionDef[],\n): AppViewModule[] {\n  const views: AppViewModule[] = []\n  for (const node of nodes) {\n    if (node.kind === 'view') {\n      views.push(node.view)\n      for (const child of childNodesOf(node, collections)) views.push(child.view)\n    } else if (node.kind === 'group') {\n      for (const child of node.children) views.push(child.view)\n    }\n  }\n  return views\n}\n\n/**\n * Resolve a consumer rail (or the default rail) into the display tree + the router\n * registry through the EC-236 seam. Views are resolved over the built-in defaults\n * (so an omitted built-in stays routable and a rail `cms` REPLACES the default\n * one); groups/separators pass through as presentation.\n *\n * EC-293: a view node may nest. `collections` (config-sourced) materialises a CMS\n * parent's per-collection children; every child view joins the override pass + the\n * derived registry, so a nested `cms:<id>` lens routes and highlights like any view.\n */\nexport function resolveSidebar(\n  entries: readonly SidebarNode[] | undefined,\n  project: Project,\n  collections: readonly CollectionDef[] = [],\n): StudioNav {\n  const nodes = entries ?? defaultRail()\n  const railOrderViews = railViews(nodes, collections)\n\n  // Resolve the rail views over the built-in registry: dedup by id + contract\n  // check. Built-ins are the defaults (so omitted ones stay routable); rail views\n  // are overrides (a same-id rail view replaces the default; a new id is added).\n  const resolved = resolveOverrides<AppViewModule>({\n    point: 'sidebar',\n    defaults: DEFAULT_VIEWS.map((view) => ({ id: view.id, value: view })),\n    overrides: railOrderViews.map((view) => ({ id: view.id, value: view })),\n    allowNew: true,\n    validate: (entry) => {\n      const view = entry.value\n      if (typeof view.render !== 'function') return 'the view has no render function'\n      if (typeof view.label !== 'string' || view.label.trim().length === 0)\n        return 'the view has no label'\n      return null\n    },\n  })\n\n  // Rail order for landing: each rail view (resolved), deduped, then the built-ins\n  // not in the rail (so Settings — always available — is the final landing fallback).\n  const inRail = new Set<string>()\n  const landing: AppViewModule[] = []\n  for (const view of railOrderViews) {\n    const resolvedView = resolved.get(view.id)\n    if (resolvedView && !inRail.has(resolvedView.id)) {\n      inRail.add(resolvedView.id)\n      landing.push(resolvedView)\n    }\n  }\n  for (const view of DEFAULT_VIEWS) if (!inRail.has(view.id)) landing.push(view)\n\n  const registry: ViewRegistry = { get: (id) => resolved.get(id), views: landing }\n\n  // Build the display tree. Each view id is emitted at most once (the first of a\n  // duplicate wins, matching `resolveOverrides`); a view dropped by validation is\n  // skipped here too.\n  const emitted = new Set<string>()\n  const toRailView = (view: AppViewModule): ResolvedRailView | null => {\n    const resolvedView = resolved.get(view.id)\n    if (!resolvedView || emitted.has(resolvedView.id)) return null\n    emitted.add(resolvedView.id)\n    return {\n      kind: 'view',\n      id: resolvedView.id,\n      label: resolvedView.label,\n      icon: resolvedView.icon,\n      path: resolvedView.id,\n      availability: moduleAvailability(project, resolvedView),\n    }\n  }\n\n  const railNodes: ResolvedRailNode[] = []\n  for (const node of nodes) {\n    if (node.kind === 'separator') {\n      railNodes.push({ kind: 'separator' })\n      continue\n    }\n    if (node.kind === 'group') {\n      const views = node.children.map((child) => toRailView(child.view)).filter(isRailView)\n      if (views.length > 0) railNodes.push({ kind: 'group', label: node.label, views })\n      continue\n    }\n    // A top-level view, with its nested children (CMS collections) attached. The\n    // parent is emitted first so its id wins any duplicate; children follow in order.\n    const view = toRailView(node.view)\n    if (!view) continue\n    const children = childNodesOf(node, collections)\n      .map((child) => toRailView(child.view))\n      .filter(isRailView)\n    if (children.length > 0) view.children = children\n    railNodes.push(view)\n  }\n\n  return { nodes: railNodes, registry, issues: resolved.issues }\n}\n\nfunction isRailView(view: ResolvedRailView | null): view is ResolvedRailView {\n  return view !== null\n}\n\n/** The active view id parsed from a studio pathname `/<projectId>/<viewId>[/…]`. */\nexport function activeViewIdFromPath(pathname: string): string | null {\n  return pathname.split('/')[2] || null\n}\n\n/** The view a bare project URL should open to: the first navigable rail view (EC-221). */\nexport function landingViewId(nav: StudioNav, project: Project): string {\n  return firstAvailableView(nav.registry.views, project)?.id ?? 'settings'\n}\n\n/**\n * The active project's resolved studio nav — the default rail or\n * `studioConfig.sidebar`, resolved over the built-in views through the EC-236 seam\n * (static per studio boot).\n */\nexport function useStudioNav(project: Project): StudioNav {\n  // `resolveDeploymentSidebar`/`resolveDeploymentCollections` are config-holder reads\n  // (stable per studio boot), so keying the memo on `project` alone is correct.\n  return useMemo(\n    () => resolveSidebar(resolveDeploymentSidebar(), project, resolveDeploymentCollections()),\n    [project],\n  )\n}\n"]}

package/dist/components/app-views/studio-config.d.ts

@@ -0,0 +1,77 @@
+import type { ReactNode } from 'react';
+import type { FieldDef } from '@elytracms/core/cms-core';
+import type { SidebarNode } from './module';
+/**
+ * EC-236 — the studio customization config: the single, studio-only home for
+ * everything a consuming repo customizes about the builder UI.
+ *
+ * This is the "separate studio-only config solution": it lives in the consumer's
+ * `studio.config.tsx`, is `defineStudio({...})`-typed, and is passed to
+ * `createStudio(config, studioConfig)` at the mount — NEVER mixed into the shared
+ * `elytra.config.ts`, so the live React it carries (views, icons, field renderers,
+ * future branding) never reaches the `frontend/` delivery bundle.
+ *
+ * The customization PRINCIPLE it embodies: customization is **code passed
+ * directly**, not data referenced by a string key. Every field here holds live
+ * values/components by reference — `sidebar` is built from `nav.*` view objects,
+ * `fieldRenderers` maps a control name to a component. The only string indirection
+ * in the whole surface is `fieldRenderers`' key, and ONLY because its other end
+ * (`form.control` on a field) lives in the delivery-shared serializable schema and
+ * cannot import studio code. This config grows by adding direct-value keys
+ * (branding/logo/panels/theme), never by adding registries.
+ */
+export interface StudioConfig {
+    /**
+     * The section rail (EC-237) as an ordered list of `nav.*` nodes — views, groups,
+     * and separators. Omitted → the studio derives the default rail from its built-in
+     * views. A rail node carries its view object directly; there are no string ids to
+     * keep in sync.
+     */
+    sidebar?: SidebarNode[];
+    /**
+     * Custom field renderers (EC-238) keyed by CONTROL name (`form.control`), each a
+     * React component replacing the built-in document-editor control. A field opts in
+     * per-field via `form: { control: '<name>' }` — so a renderer targets exactly the
+     * fields that ask for it, not every field of a datatype. This is the one
+     * boundary-crossing seam: the field names its control by string in the shared
+     * schema, this map binds that name to a studio-only component.
+     */
+    fieldRenderers?: Record<string, CustomFieldRenderer>;
+}
+/** The props a custom field renderer receives — identical to the built-in control. */
+export interface CustomFieldRendererProps {
+    field: FieldDef;
+    value: unknown;
+    onChange: (value: unknown) => void;
+    readOnly: boolean;
+    id: string;
+}
+export type CustomFieldRenderer = (props: CustomFieldRendererProps) => ReactNode;
+/**
+ * Typed identity helper for `studio.config.tsx` — keeps the config declarative
+ * (like {@link import('@elytracms/core/studio-core').defineElytraConfig}). No
+ * validation here; the studio resolves + validates the sidebar and field renderers
+ * through the EC-236 seam at mount, surfacing every issue visibly (never throws).
+ *
+ * @example
+ * ```tsx
+ * // studio.config.tsx
+ * import { defineStudio, nav } from '@elytracms/studio/customization'
+ * import { ColorField } from './fields/color'
+ *
+ * export default defineStudio({
+ *   sidebar: [
+ *     nav.cms({ label: 'Content' }),
+ *     nav.group('Catalog', [
+ *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),
+ *       nav.cms({ label: 'Categories', collection: 'productCategory' }),
+ *     ]),
+ *     nav.separator(),
+ *     nav.assets(),
+ *     nav.settings(),
+ *   ],
+ *   fieldRenderers: { color: ColorField },
+ * })
+ * ```
+ */
+export declare function defineStudio(config: StudioConfig): StudioConfig;

package/dist/components/app-views/studio-config.js

@@ -0,0 +1,31 @@
+/**
+ * Typed identity helper for `studio.config.tsx` — keeps the config declarative
+ * (like {@link import('@elytracms/core/studio-core').defineElytraConfig}). No
+ * validation here; the studio resolves + validates the sidebar and field renderers
+ * through the EC-236 seam at mount, surfacing every issue visibly (never throws).
+ *
+ * @example
+ * ```tsx
+ * // studio.config.tsx
+ * import { defineStudio, nav } from '@elytracms/studio/customization'
+ * import { ColorField } from './fields/color'
+ *
+ * export default defineStudio({
+ *   sidebar: [
+ *     nav.cms({ label: 'Content' }),
+ *     nav.group('Catalog', [
+ *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),
+ *       nav.cms({ label: 'Categories', collection: 'productCategory' }),
+ *     ]),
+ *     nav.separator(),
+ *     nav.assets(),
+ *     nav.settings(),
+ *   ],
+ *   fieldRenderers: { color: ColorField },
+ * })
+ * ```
+ */
+export function defineStudio(config) {
+    return config;
+}
+//# sourceMappingURL=studio-config.js.map

package/dist/components/app-views/studio-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-config.js","sourceRoot":"","sources":["../../../src/components/app-views/studio-config.ts"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import type { ReactNode } from 'react'\nimport type { FieldDef } from '@elytracms/core/cms-core'\nimport type { SidebarNode } from './module'\n\n/**\n * EC-236 — the studio customization config: the single, studio-only home for\n * everything a consuming repo customizes about the builder UI.\n *\n * This is the \"separate studio-only config solution\": it lives in the consumer's\n * `studio.config.tsx`, is `defineStudio({...})`-typed, and is passed to\n * `createStudio(config, studioConfig)` at the mount — NEVER mixed into the shared\n * `elytra.config.ts`, so the live React it carries (views, icons, field renderers,\n * future branding) never reaches the `frontend/` delivery bundle.\n *\n * The customization PRINCIPLE it embodies: customization is **code passed\n * directly**, not data referenced by a string key. Every field here holds live\n * values/components by reference — `sidebar` is built from `nav.*` view objects,\n * `fieldRenderers` maps a control name to a component. The only string indirection\n * in the whole surface is `fieldRenderers`' key, and ONLY because its other end\n * (`form.control` on a field) lives in the delivery-shared serializable schema and\n * cannot import studio code. This config grows by adding direct-value keys\n * (branding/logo/panels/theme), never by adding registries.\n */\nexport interface StudioConfig {\n  /**\n   * The section rail (EC-237) as an ordered list of `nav.*` nodes — views, groups,\n   * and separators. Omitted → the studio derives the default rail from its built-in\n   * views. A rail node carries its view object directly; there are no string ids to\n   * keep in sync.\n   */\n  sidebar?: SidebarNode[]\n  /**\n   * Custom field renderers (EC-238) keyed by CONTROL name (`form.control`), each a\n   * React component replacing the built-in document-editor control. A field opts in\n   * per-field via `form: { control: '<name>' }` — so a renderer targets exactly the\n   * fields that ask for it, not every field of a datatype. This is the one\n   * boundary-crossing seam: the field names its control by string in the shared\n   * schema, this map binds that name to a studio-only component.\n   */\n  fieldRenderers?: Record<string, CustomFieldRenderer>\n}\n\n/** The props a custom field renderer receives — identical to the built-in control. */\nexport interface CustomFieldRendererProps {\n  field: FieldDef\n  value: unknown\n  onChange: (value: unknown) => void\n  readOnly: boolean\n  id: string\n}\nexport type CustomFieldRenderer = (props: CustomFieldRendererProps) => ReactNode\n\n/**\n * Typed identity helper for `studio.config.tsx` — keeps the config declarative\n * (like {@link import('@elytracms/core/studio-core').defineElytraConfig}). No\n * validation here; the studio resolves + validates the sidebar and field renderers\n * through the EC-236 seam at mount, surfacing every issue visibly (never throws).\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n * ```\n */\nexport function defineStudio(config: StudioConfig): StudioConfig {\n  return config\n}\n"]}

package/dist/components/cms/cms-index.js

@@ -3,7 +3,7 @@ import { Database, FileCog } from 'lucide-react';
 import { isSingleton } from '@elytracms/core/cms-core';
 import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
 import { useCms } from '@elytracms/studio/components/cms/cms-store';
-import { CollectionsSidebar, focusCollectionList, } from '@elytracms/studio/components/cms/collections-sidebar';
+import { focusCollectionList } from './collection-focus';
 import { Card, Code, Heading, Spacer, Stack, Text } from '@elytracms/studio/ui';
 /**
  * The CMS section landing view (EC-223 Stage 6): the collection grid, shown when
@@ -14,12 +14,12 @@ import { Card, Code, Heading, Spacer, Stack, Text } from '@elytracms/studio/ui';
 export function CmsIndex({ projectId, focusCollections, }) {
     const cms = useCms();
     const collections = focusCollectionList(cms.collections, focusCollections);
-    return (_jsxs("div", { className: "mx-auto w-full max-w-3xl p-4 sm:p-6", children: [_jsx("div", { className: "mb-6 h-72 overflow-hidden rounded-lg border border-border md:hidden", children: _jsx(CollectionsSidebar, { projectId: projectId, focusCollections: focusCollections }) }), _jsxs(Stack, { gap: "6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { size: "display", children: "Content" }), _jsx(Text, { tone: "muted", children: "Schema-driven collections. Open a collection to browse its documents as a table and edit them in the detail editor." })] }), _jsx("div", { className: "grid gap-3 sm:grid-cols-2", children: collections.map((collection) => {
-                            // EC-217: a singleton reads as one fixed document — a distinct icon
-                            // and a "Single document" note instead of a (always-1) row count.
-                            const singleton = isSingleton(collection);
-                            const Icon = singleton ? FileCog : Database;
-                            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.cmsCollection(collection.id) }, children: _jsxs(Card, { className: "flex items-center gap-3 p-4 transition-colors hover:border-primary/30", children: [_jsx("span", { className: "grid size-9 shrink-0 place-items-center rounded-lg bg-muted text-muted-foreground", children: _jsx(Icon, { className: "size-4" }) }), _jsxs(Stack, { gap: "none", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", className: "truncate", children: collection.form?.label ?? collection.id }), _jsxs(Code, { tone: "muted", className: "w-fit", children: [collection.id, " \u00B7 ", collection.fields.length, " fields"] })] }), _jsx(Spacer, {}), singleton ? (_jsx(Text, { size: "xs", tone: "muted", className: "whitespace-nowrap", children: "Single document" })) : (_jsx(Text, { size: "sm", tone: "muted", mono: true, children: cms.documentsOf(collection.id).length }))] }) }, collection.id));
-                        }) })] })] }));
+    return (_jsx("div", { className: "mx-auto w-full max-w-3xl p-4 sm:p-6", children: _jsxs(Stack, { gap: "6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { size: "display", children: "Content" }), _jsx(Text, { tone: "muted", children: "Schema-driven collections. Open a collection to browse its documents as a table and edit them in the detail editor." })] }), _jsx("div", { className: "grid gap-3 sm:grid-cols-2", children: collections.map((collection) => {
+                        // EC-217: a singleton reads as one fixed document — a distinct icon
+                        // and a "Single document" note instead of a (always-1) row count.
+                        const singleton = isSingleton(collection);
+                        const Icon = singleton ? FileCog : Database;
+                        return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.cmsCollection(collection.id) }, children: _jsxs(Card, { className: "flex items-center gap-3 p-4 transition-colors hover:border-primary/30", children: [_jsx("span", { className: "grid size-9 shrink-0 place-items-center rounded-lg bg-muted text-muted-foreground", children: _jsx(Icon, { className: "size-4" }) }), _jsxs(Stack, { gap: "none", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", className: "truncate", children: collection.form?.label ?? collection.id }), _jsxs(Code, { tone: "muted", className: "w-fit", children: [collection.id, " \u00B7 ", collection.fields.length, " fields"] })] }), _jsx(Spacer, {}), singleton ? (_jsx(Text, { size: "xs", tone: "muted", className: "whitespace-nowrap", children: "Single document" })) : (_jsx(Text, { size: "sm", tone: "muted", mono: true, children: cms.documentsOf(collection.id).length }))] }) }, collection.id));
+                    }) })] }) }));
 }
 //# sourceMappingURL=cms-index.js.map

package/dist/components/cms/cms-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"cms-index.js","sourceRoot":"","sources":["../../../src/components/cms/cms-index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAA;AACnE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,SAAS,EACT,gBAAgB,GAIjB;IACC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IACpB,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IAE1E,OAAO,CACL,eAAK,SAAS,EAAC,qCAAqC,aAClD,cAAK,SAAS,EAAC,qEAAqE,YAClF,KAAC,kBAAkB,IAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,GAAI,GAC5E,EACN,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,KAAC,OAAO,IAAC,IAAI,EAAC,SAAS,wBAAkB,EACzC,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,oIAGX,IACD,EACR,cAAK,SAAS,EAAC,2BAA2B,YACvC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;4BAC9B,oEAAoE;4BACpE,kEAAkE;4BAClE,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;4BACzC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;4BAC3C,OAAO,CACL,KAAC,IAAI,IAEH,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,YAEtE,MAAC,IAAI,IAAC,SAAS,EAAC,uEAAuE,aACrF,eAAM,SAAS,EAAC,mFAAmF,YACjG,KAAC,IAAI,IAAC,SAAS,EAAC,QAAQ,GAAG,GACtB,EACP,MAAC,KAAK,IAAC,GAAG,EAAC,MAAM,EAAC,SAAS,EAAC,SAAS,aACnC,KAAC,IAAI,IAAC,MAAM,EAAC,UAAU,EAAC,SAAS,EAAC,UAAU,YACzC,UAAU,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,EAAE,GACnC,EACP,MAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,OAAO,aACjC,UAAU,CAAC,EAAE,cAAK,UAAU,CAAC,MAAM,CAAC,MAAM,eACtC,IACD,EACR,KAAC,MAAM,KAAG,EACT,SAAS,CAAC,CAAC,CAAC,CACX,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,mBAAmB,gCAEnD,CACR,CAAC,CAAC,CAAC,CACF,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,IAAI,kBAC9B,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,GACjC,CACR,IACI,IA1BF,UAAU,CAAC,EAAE,CA2Bb,CACR,CAAA;wBACH,CAAC,CAAC,GACE,IACA,IACJ,CACP,CAAA;AACH,CAAC","sourcesContent":["import { Database, FileCog } from 'lucide-react'\nimport { isSingleton } from '@elytracms/core/cms-core'\nimport { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { useCms } from '@elytracms/studio/components/cms/cms-store'\nimport {\n  CollectionsSidebar,\n  focusCollectionList,\n} from '@elytracms/studio/components/cms/collections-sidebar'\nimport { Card, Code, Heading, Spacer, Stack, Text } from '@elytracms/studio/ui'\n\n/**\n * The CMS section landing view (EC-223 Stage 6): the collection grid, shown when\n * no collection is selected. Takes `projectId` as a prop; the splat resolver\n * mounts it inside the CMS provider so {@link useCms} resolves. `focusCollections`\n * (EC-239) narrows the grid for a focused CMS module instance.\n */\nexport function CmsIndex({\n  projectId,\n  focusCollections,\n}: {\n  projectId: string\n  focusCollections?: readonly string[]\n}) {\n  const cms = useCms()\n  const collections = focusCollectionList(cms.collections, focusCollections)\n\n  return (\n    <div className=\"mx-auto w-full max-w-3xl p-4 sm:p-6\">\n      <div className=\"mb-6 h-72 overflow-hidden rounded-lg border border-border md:hidden\">\n        <CollectionsSidebar projectId={projectId} focusCollections={focusCollections} />\n      </div>\n      <Stack gap=\"6\">\n        <Stack gap=\"1\">\n          <Heading size=\"display\">Content</Heading>\n          <Text tone=\"muted\">\n            Schema-driven collections. Open a collection to browse its documents as a table and edit\n            them in the detail editor.\n          </Text>\n        </Stack>\n        <div className=\"grid gap-3 sm:grid-cols-2\">\n          {collections.map((collection) => {\n            // EC-217: a singleton reads as one fixed document — a distinct icon\n            // and a \"Single document\" note instead of a (always-1) row count.\n            const singleton = isSingleton(collection)\n            const Icon = singleton ? FileCog : Database\n            return (\n              <Link\n                key={collection.id}\n                to={STUDIO_PROJECT_ROUTE}\n                params={{ projectId, _splat: studioPath.cmsCollection(collection.id) }}\n              >\n                <Card className=\"flex items-center gap-3 p-4 transition-colors hover:border-primary/30\">\n                  <span className=\"grid size-9 shrink-0 place-items-center rounded-lg bg-muted text-muted-foreground\">\n                    <Icon className=\"size-4\" />\n                  </span>\n                  <Stack gap=\"none\" className=\"min-w-0\">\n                    <Text weight=\"semibold\" className=\"truncate\">\n                      {collection.form?.label ?? collection.id}\n                    </Text>\n                    <Code tone=\"muted\" className=\"w-fit\">\n                      {collection.id} · {collection.fields.length} fields\n                    </Code>\n                  </Stack>\n                  <Spacer />\n                  {singleton ? (\n                    <Text size=\"xs\" tone=\"muted\" className=\"whitespace-nowrap\">\n                      Single document\n                    </Text>\n                  ) : (\n                    <Text size=\"sm\" tone=\"muted\" mono>\n                      {cms.documentsOf(collection.id).length}\n                    </Text>\n                  )}\n                </Card>\n              </Link>\n            )\n          })}\n        </div>\n      </Stack>\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"cms-index.js","sourceRoot":"","sources":["../../../src/components/cms/cms-index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,SAAS,EACT,gBAAgB,GAIjB;IACC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IACpB,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IAE1E,OAAO,CACL,cAAK,SAAS,EAAC,qCAAqC,YAClD,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,KAAC,OAAO,IAAC,IAAI,EAAC,SAAS,wBAAkB,EACzC,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,oIAGX,IACD,EACR,cAAK,SAAS,EAAC,2BAA2B,YACvC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;wBAC9B,oEAAoE;wBACpE,kEAAkE;wBAClE,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;wBACzC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;wBAC3C,OAAO,CACL,KAAC,IAAI,IAEH,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,YAEtE,MAAC,IAAI,IAAC,SAAS,EAAC,uEAAuE,aACrF,eAAM,SAAS,EAAC,mFAAmF,YACjG,KAAC,IAAI,IAAC,SAAS,EAAC,QAAQ,GAAG,GACtB,EACP,MAAC,KAAK,IAAC,GAAG,EAAC,MAAM,EAAC,SAAS,EAAC,SAAS,aACnC,KAAC,IAAI,IAAC,MAAM,EAAC,UAAU,EAAC,SAAS,EAAC,UAAU,YACzC,UAAU,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,EAAE,GACnC,EACP,MAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,OAAO,aACjC,UAAU,CAAC,EAAE,cAAK,UAAU,CAAC,MAAM,CAAC,MAAM,eACtC,IACD,EACR,KAAC,MAAM,KAAG,EACT,SAAS,CAAC,CAAC,CAAC,CACX,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,mBAAmB,gCAEnD,CACR,CAAC,CAAC,CAAC,CACF,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,IAAI,kBAC9B,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,GACjC,CACR,IACI,IA1BF,UAAU,CAAC,EAAE,CA2Bb,CACR,CAAA;oBACH,CAAC,CAAC,GACE,IACA,GACJ,CACP,CAAA;AACH,CAAC","sourcesContent":["import { Database, FileCog } from 'lucide-react'\nimport { isSingleton } from '@elytracms/core/cms-core'\nimport { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router'\nimport { useCms } from '@elytracms/studio/components/cms/cms-store'\nimport { focusCollectionList } from './collection-focus'\nimport { Card, Code, Heading, Spacer, Stack, Text } from '@elytracms/studio/ui'\n\n/**\n * The CMS section landing view (EC-223 Stage 6): the collection grid, shown when\n * no collection is selected. Takes `projectId` as a prop; the splat resolver\n * mounts it inside the CMS provider so {@link useCms} resolves. `focusCollections`\n * (EC-239) narrows the grid for a focused CMS module instance.\n */\nexport function CmsIndex({\n  projectId,\n  focusCollections,\n}: {\n  projectId: string\n  focusCollections?: readonly string[]\n}) {\n  const cms = useCms()\n  const collections = focusCollectionList(cms.collections, focusCollections)\n\n  return (\n    <div className=\"mx-auto w-full max-w-3xl p-4 sm:p-6\">\n      <Stack gap=\"6\">\n        <Stack gap=\"1\">\n          <Heading size=\"display\">Content</Heading>\n          <Text tone=\"muted\">\n            Schema-driven collections. Open a collection to browse its documents as a table and edit\n            them in the detail editor.\n          </Text>\n        </Stack>\n        <div className=\"grid gap-3 sm:grid-cols-2\">\n          {collections.map((collection) => {\n            // EC-217: a singleton reads as one fixed document — a distinct icon\n            // and a \"Single document\" note instead of a (always-1) row count.\n            const singleton = isSingleton(collection)\n            const Icon = singleton ? FileCog : Database\n            return (\n              <Link\n                key={collection.id}\n                to={STUDIO_PROJECT_ROUTE}\n                params={{ projectId, _splat: studioPath.cmsCollection(collection.id) }}\n              >\n                <Card className=\"flex items-center gap-3 p-4 transition-colors hover:border-primary/30\">\n                  <span className=\"grid size-9 shrink-0 place-items-center rounded-lg bg-muted text-muted-foreground\">\n                    <Icon className=\"size-4\" />\n                  </span>\n                  <Stack gap=\"none\" className=\"min-w-0\">\n                    <Text weight=\"semibold\" className=\"truncate\">\n                      {collection.form?.label ?? collection.id}\n                    </Text>\n                    <Code tone=\"muted\" className=\"w-fit\">\n                      {collection.id} · {collection.fields.length} fields\n                    </Code>\n                  </Stack>\n                  <Spacer />\n                  {singleton ? (\n                    <Text size=\"xs\" tone=\"muted\" className=\"whitespace-nowrap\">\n                      Single document\n                    </Text>\n                  ) : (\n                    <Text size=\"sm\" tone=\"muted\" mono>\n                      {cms.documentsOf(collection.id).length}\n                    </Text>\n                  )}\n                </Card>\n              </Link>\n            )\n          })}\n        </div>\n      </Stack>\n    </div>\n  )\n}\n"]}

package/dist/components/cms/collection-focus.d.ts

@@ -0,0 +1,10 @@
+/**
+ * EC-239 focus lens (EC-293: relocated here from the retired `collections-sidebar`).
+ *
+ * A focused CMS view shows only `focus` collections, in that order (config order is
+ * honoured); ids not present are dropped. Unset → all collections. Used by the CMS
+ * index grid and by the rail's collection auto-expansion (`nav.cms`).
+ */
+export declare function focusCollectionList<T extends {
+    id: string;
+}>(all: readonly T[], focus?: readonly string[]): T[];

package/dist/components/cms/collection-focus.js

@@ -0,0 +1,16 @@
+/**
+ * EC-239 focus lens (EC-293: relocated here from the retired `collections-sidebar`).
+ *
+ * A focused CMS view shows only `focus` collections, in that order (config order is
+ * honoured); ids not present are dropped. Unset → all collections. Used by the CMS
+ * index grid and by the rail's collection auto-expansion (`nav.cms`).
+ */
+export function focusCollectionList(all, focus) {
+    if (!focus)
+        return [...all];
+    const byId = new Map(all.map((collection) => [collection.id, collection]));
+    return focus
+        .map((id) => byId.get(id))
+        .filter((collection) => collection !== undefined);
+}
+//# sourceMappingURL=collection-focus.js.map

package/dist/components/cms/collection-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-focus.js","sourceRoot":"","sources":["../../../src/components/cms/collection-focus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAiB,EACjB,KAAyB;IAEzB,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAC1E,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACzB,MAAM,CAAC,CAAC,UAAU,EAAmB,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAA;AACtE,CAAC","sourcesContent":["/**\n * EC-239 focus lens (EC-293: relocated here from the retired `collections-sidebar`).\n *\n * A focused CMS view shows only `focus` collections, in that order (config order is\n * honoured); ids not present are dropped. Unset → all collections. Used by the CMS\n * index grid and by the rail's collection auto-expansion (`nav.cms`).\n */\nexport function focusCollectionList<T extends { id: string }>(\n  all: readonly T[],\n  focus?: readonly string[],\n): T[] {\n  if (!focus) return [...all]\n  const byId = new Map(all.map((collection) => [collection.id, collection]))\n  return focus\n    .map((id) => byId.get(id))\n    .filter((collection): collection is T => collection !== undefined)\n}\n"]}

package/dist/components/cms/field-control.d.ts

@@ -7,11 +7,14 @@ interface FieldControlProps {
     id: string;
 }
 /**
- * The document-editor field control. Resolves a project's custom renderer for the
- * field type (EC-238, customization seam EC-236) and falls back to the built-in
- * control: a registered renderer renders inside an error boundary (a throw → the
- * built-in + a visible issue); a rejected registration (unknown type / non-component)
- * shows the built-in with the issue above it; otherwise the built-in renders alone.
+ * The document-editor field control. Resolves a project's custom renderer by the
+ * field's `form.control` (EC-238, customization seam EC-236) and falls back to the
+ * built-in control for the field's datatype: a registered renderer renders inside
+ * an error boundary (a throw → the built-in + a visible issue); a rejected
+ * registration (non-component) shows the built-in with the issue above it; a field
+ * naming a control with NO renderer and NO built-in name (a typo) shows the
+ * built-in with a loud issue — never a silent fall-through; otherwise the built-in
+ * renders alone.
  */
 export declare function FieldControl(props: FieldControlProps): import("react").JSX.Element;
 export {};