@elytracms/studio 0.0.17 → 0.0.18

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

@@ -1,153 +1,118 @@
 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 { 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('/');
-}
-/** 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`;
-        }
-        if (parse([...item.deepLink]) === null) {
-            return `deep-link "${item.deepLink.join('/')}" does not resolve in module "${item.moduleId}"`;
-        }
+/** Every view in the rail (top-level + group children), in rail order. */
+function railViews(nodes) {
+    const views = [];
+    for (const node of nodes) {
+        if (node.kind === 'view')
+            views.push(node.view);
+        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.
  */
-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) {
+    const nodes = entries ?? defaultRail();
+    const railOrderViews = railViews(nodes);
+    // 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 };
+        const view = toRailView(node.view);
+        if (view)
+            railNodes.push(view);
+    }
+    return { nodes: railNodes, registry, issues: resolved.issues };
 }
-/** The active module id parsed from a studio pathname `/<projectId>/<module>[/…]`. */
-export function activeModuleFromPath(pathname) {
+function isRailView(view) {
+    return view !== null;
+}
+/** 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) {
+    return useMemo(() => resolveSidebar(resolveDeploymentSidebar(), project), [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 { resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace'\nimport {\n  firstAvailableView,\n  moduleAvailability,\n  viewNode,\n  type AppViewModule,\n  type SidebarNode,\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}\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/** Every view in the rail (top-level + group children), in rail order. */\nfunction railViews(nodes: readonly SidebarNode[]): AppViewModule[] {\n  const views: AppViewModule[] = []\n  for (const node of nodes) {\n    if (node.kind === 'view') views.push(node.view)\n    else if (node.kind === 'group') for (const child of node.children) views.push(child.view)\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 */\nexport function resolveSidebar(\n  entries: readonly SidebarNode[] | undefined,\n  project: Project,\n): StudioNav {\n  const nodes = entries ?? defaultRail()\n  const railOrderViews = railViews(nodes)\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    const view = toRailView(node.view)\n    if (view) 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  return useMemo(() => resolveSidebar(resolveDeploymentSidebar(), project), [project])\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/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 {};

package/dist/components/cms/field-control.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronDown, ChevronUp, Image, Link2, Pencil, Plus, Trash2, X } from 'lucide-react';
 import { useMemo, useRef, useState } from 'react';
-import { descendantIds, isFieldHidden, parentRelationField } from '@elytracms/core/cms-core';
+import { BUILTIN_FIELD_CONTROLS, descendantIds, isFieldHidden, parentRelationField } from '@elytracms/core/cms-core';
 import { Badge, Button, Card, Code, Field, Input, Row, Select, Spacer, Stack, Text } from '@elytracms/studio/ui';
 import { applyAssetSelection, assetIdsOf, singleAssetIdOf } from '../assets/asset-selection';
 import { fieldLabel, useCms } from './cms-store';
@@ -11,22 +11,33 @@ import { RelationPicker } from './relation-picker';
 import { AssetPicker } from './asset-picker';
 import { FieldRendererBoundary, FieldRendererIssue, useFieldRenderers, } from './field-renderer';
 /**
- * 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 function FieldControl(props) {
     const renderers = useFieldRenderers();
     const builtIn = _jsx(BuiltInFieldControl, { ...props });
-    const Custom = renderers.get(props.field.type);
+    const control = props.field.form?.control;
+    const Custom = control ? renderers.get(control) : undefined;
     if (Custom) {
         return (_jsx(FieldRendererBoundary, { fallback: builtIn, issue: _jsx(FieldRendererIssue, { message: "Custom renderer crashed \u2014 showing the built-in control." }), children: _jsx(Custom, { ...props }) }));
     }
-    const rejected = renderers.issues.find((issue) => issue.id === props.field.type);
-    if (rejected) {
-        return (_jsxs(Stack, { gap: "1", children: [_jsx(FieldRendererIssue, { message: rejected.message }), builtIn] }));
+    if (control) {
+        const rejected = renderers.issues.find((issue) => issue.id === control);
+        if (rejected) {
+            return (_jsxs(Stack, { gap: "1", children: [_jsx(FieldRendererIssue, { message: rejected.message }), builtIn] }));
+        }
+        // The field asks for a control with no registered renderer and no built-in
+        // name — surface it (a typo'd `control` would otherwise read as a plain input).
+        if (!BUILTIN_FIELD_CONTROLS.includes(control)) {
+            return (_jsxs(Stack, { gap: "1", children: [_jsx(FieldRendererIssue, { message: `No field renderer registered for control “${control}”.` }), builtIn] }));
+        }
     }
     return builtIn;
 }