@elytracms/studio 0.0.93 → 0.0.94

package/dist/components/app-views/module.d.ts

@@ -4,6 +4,11 @@ import type { Project, SectionAvailability, SectionId } from '@elytracms/core/st
 import type { CollectionDef } from '@elytracms/core/cms-core';
 import type { ProjectRole } from '@elytracms/core/persistence';
 import type { StudioSearch } from '@elytracms/studio/router/search';
+import type { Locale } from '@elytracms/core/cms-core';
+import type { OperationsClient } from '@elytracms/core/operations';
+import type { AuthUser } from '../../lib/auth/index.js';
+import type { useOperationCache, useOperationQuery } from '../../lib/query/index.js';
+import type { NavIssue } from '../nav-issues-registry.js';
 /**
  * The studio **view** contract + the **sidebar node** model — the internal types
  * the consumer-facing `nav.*` builders (EC-237/239, customization seam EC-236)
@@ -47,7 +52,19 @@ export interface NavPermissionContext {
  * stays the real boundary, and hidden views remain URL-addressable (EC-221).
  */
 export type NavPermission = (ctx: NavPermissionContext) => boolean;
-/** Everything a view's surface needs to render (EC-239). */
+/**
+ * Everything a view's surface needs to render (EC-239), and — since EC-616 — what an
+ * addon's view reaches the studio through, instead of importing internals: the
+ * operations client (the one chokepoint every read and write goes through), the query
+ * hooks over the one cache (AD-17), the ambient content locale, and the signed-in user
+ * with their role on this project.
+ *
+ * **The chrome contract** (ruling § 6b item 1): the SHELL draws the top bar, the
+ * breadcrumb (its section crumb is the view's `label`; deeper crumbs are contributed with
+ * `useSetBreadcrumb`), the rail with its issues foot (contributed with `useNavIssues`),
+ * the banners and the theme. The VIEW owns the whole scrollable content area under it,
+ * including its own title header — the shell adds no frame, title or padding.
+ */
 export interface AppViewContext {
     project: Project;
     projectId: string;
@@ -55,7 +72,33 @@ export interface AppViewContext {
     deepLink: AppViewDeepLink;
     /** The validated `?…` search (forced state, focused field/asset, …). */
     search: StudioSearch;
+    /** The studio's operations client — every read and write, authorized at the chokepoint. */
+    operations(): Promise<OperationsClient>;
+    /** The query hooks over the studio's one operations-backed cache (AD-17). */
+    query: AppViewQueryHooks;
+    /** The ambient content locale (`null` until the project's locale config is installed). */
+    locale: Locale | null;
+    /** The signed-in user (`null` while signed out). */
+    user: AuthUser | null;
+    /** The user's role on this project (`null` while it loads, or for a non-member). */
+    role: ProjectRole | null;
+}
+/** The cache hooks a view reads and writes through (`useOperationQuery` / `useOperationCache`). */
+export interface AppViewQueryHooks {
+    useOperationQuery: typeof useOperationQuery;
+    useOperationCache: typeof useOperationCache;
 }
+/**
+ * EC-616 — a view's ALWAYS-ON rail-foot findings: a React hook the rail mounts for every
+ * view in it that declares one (whether or not the view is open), publishing what it
+ * returns through `useNavIssues`. Use it for a problem the developer must see from any
+ * surface (an addon's broken configuration); a finding that only matters while the view
+ * is open is published from the view with `useNavIssues` directly.
+ */
+export type NavIssuesHook = (ctx: {
+    project: Project;
+    projectId: string;
+}) => readonly NavIssue[];
 /**
  * EC-476/477 — how a view's id came to be, when the builder **derived** it instead of
  * taking an explicit `config.id`.
@@ -125,6 +168,8 @@ export interface AppViewModule {
     visible?: NavPermission;
     /** A redirect-only / utility view the stock rail does not list (e.g. `builder`). */
     hidden?: boolean;
+    /** EC-616 — always-on rail-foot findings (see {@link NavIssuesHook}). */
+    useIssues?: NavIssuesHook;
 }
 /**
  * A rail entry that mounts a view. Carries the view object directly — no string id.
@@ -177,8 +222,13 @@ export declare function cmsDeepLink(segments: string[]): AppViewDeepLink | null;
 export declare function componentsDeepLink(segments: string[]): AppViewDeepLink | null;
 /** Users arity (EC-240): `[]` list · `[userId]` member detail; deeper is not-found. */
 export declare function usersDeepLink(segments: string[]): AppViewDeepLink | null;
-/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found. */
-export declare function redirectsDeepLink(segments: string[]): AppViewDeepLink | null;
+/**
+ * A record rail's arity (EC-616): `[]` list · `[id]` one record's detail, under the kind's
+ * `idKey`; deeper is not-found.
+ */
+export declare function recordDeepLink(idKey: string): (segments: string[]) => AppViewDeepLink | null;
+/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found — the redirect kind's {@link recordDeepLink}. */
+export declare const redirectsDeepLink: (segments: string[]) => AppViewDeepLink | null;
 /** Assets arity (EC-319): `[]` list · `[assetId]` detail; deeper is not-found. */
 export declare function assetsDeepLink(segments: string[]): AppViewDeepLink | null;
 /**

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

@@ -42,14 +42,21 @@ export function usersDeepLink(segments) {
         return { userId: segments[0] };
     return null;
 }
-/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found. */
-export function redirectsDeepLink(segments) {
-    if (segments.length === 0)
-        return { redirectId: null };
-    if (segments.length === 1)
-        return { redirectId: segments[0] };
-    return null;
+/**
+ * A record rail's arity (EC-616): `[]` list · `[id]` one record's detail, under the kind's
+ * `idKey`; deeper is not-found.
+ */
+export function recordDeepLink(idKey) {
+    return (segments) => {
+        if (segments.length === 0)
+            return { [idKey]: null };
+        if (segments.length === 1)
+            return { [idKey]: segments[0] };
+        return null;
+    };
 }
+/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found — the redirect kind's {@link recordDeepLink}. */
+export const redirectsDeepLink = recordDeepLink('redirectId');
 /** Assets arity (EC-319): `[]` list · `[assetId]` detail; deeper is not-found. */
 export function assetsDeepLink(segments) {
     if (segments.length === 0)

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

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/components/app-views/module.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { ReactNode } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport { availabilityOf } from '@elytracms/core/studio-core'\nimport type { Project, SectionAvailability, SectionId } from '@elytracms/core/studio-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport type { ProjectRole } from '@elytracms/core/persistence'\nimport type { StudioSearch } from '@elytracms/studio/router/search'\n\n/**\n * The studio **view** contract + the **sidebar node** model — the internal types\n * the consumer-facing `nav.*` builders (EC-237/239, customization seam EC-236)\n * produce.\n *\n * A studio surface (the CMS, Routes, Assets view, or a net-new one) is a\n * self-contained {@link AppViewModule}: a stable id + display metadata + a React\n * `render` + an optional deep-link parser. A {@link SidebarNode} is one rail entry\n * — a view, a labelled group of views, or a separator — and a **view node carries\n * its view object DIRECTLY**, not a string id. This is the redesign's core: there\n * is no separate \"register a view, then reference it by `moduleId`\" indirection\n * and no shared id-keyspace, so the section rail IS the set of views, the router\n * registry is DERIVED from it, and the duplicate-id / both-highlighted class of\n * bug is gone by construction.\n *\n * The boundary principle: everything here is studio-only live code passed by\n * reference (no string keys). A string only crosses the serializable boundary for\n * field controls (`form.control`), where the field lives in delivery-shared schema.\n *\n * Reuse-not-copy (EC-239): a focused view like \"Catalog\" is the CMS surface\n * instantiated with config (`nav.cms({ collections })`), not a fork — the same\n * surface code backs many views, each its own addressable node.\n */\n\n/** The deep-link a view parses out of its trailing path segments (e.g. `{ collectionId, documentId }`). */\nexport type AppViewDeepLink = Record<string, string | null>\n\n/**\n * What an OPTIONAL nav-permission predicate sees (EC-240, vision AD-18): the\n * project + the signed-in user's resolved role (`null` while it loads, or for a\n * non-member). Kept minimal — policy that needs more should live server-side.\n */\nexport interface NavPermissionContext {\n  project: Project\n  role: ProjectRole | null\n}\n\n/**\n * An OPTIONAL, **default-open** per-nav-item visibility predicate (AD-18). Returns\n * `false` to HIDE the item for this principal; absent ⇒ visible. Permissions\n * RESTRICT — they never grant a baseline. This is the general mechanism (applies\n * to EVERY nav item, not a Users special-case); the concrete policy ships in the\n * starter project, never the engine. UI reflection only — the server chokepoint\n * stays the real boundary, and hidden views remain URL-addressable (EC-221).\n */\nexport type NavPermission = (ctx: NavPermissionContext) => boolean\n\n/** Everything a view's surface needs to render (EC-239). */\nexport interface AppViewContext {\n  project: Project\n  projectId: string\n  /** The view's parsed deep-link; `{}` for a flat view with no nested resource. */\n  deepLink: AppViewDeepLink\n  /** The validated `?…` search (forced state, focused field/asset, …). */\n  search: StudioSearch\n}\n\n/**\n * EC-476/477 — how a view's id came to be, when the builder **derived** it instead of\n * taking an explicit `config.id`.\n *\n * Diagnostics only: nothing routes, renders or resolves on this. It exists because the\n * derived-vs-explicit distinction is otherwise UNRECOVERABLE downstream, and the two\n * must not behave the same. `nav.view({ id: 'cms' })` names a built-in on purpose —\n * that is the documented override feature (EC-236). `nav.view({ label: 'CMS' })` names\n * a *label*, and `slugify` happening to produce `cms` is an accident that costs an\n * entire built-in surface. `resolveSidebar` cannot tell those apart from the finished\n * view: every built-in's own English label slugifies onto its own id\n * (`settingsView().label` = \"Settings\" → `settings`), so inferring \"was this derived?\"\n * by re-slugifying the label misfires on the DEFAULT RAIL. Hence a carried marker.\n *\n * Present only on a derived id — an explicit `config.id` leaves it absent, which is\n * what makes \"the developer meant it\" checkable.\n */\nexport type DerivedViewId =\n  /** Slugified from a custom view's LABEL (`nav.view({ label })`); the label is carried for the message. */\n  | { from: 'label'; label: string }\n  /**\n   * Joined from a MULTI-collection CMS focus with the `-` separator\n   * (`nav.cms({ collections: ['a','b'] })` → `cms:a-b`). The single-collection leaf and\n   * the one-item `cms-group:` parent are deliberately NOT marked: their ids are\n   * unambiguous by construction (EC-468), so there is nothing to diagnose.\n   */\n  | { from: 'collection-join'; collections: readonly string[] }\n\nexport interface AppViewModule {\n  /** Stable id — the first path segment under the project + the registry key. */\n  id: string\n  /**\n   * EC-476/477 — DIAGNOSTIC provenance for an id the builder DERIVED rather than took\n   * from an explicit `config.id`. Absent → the id was declared. See {@link DerivedViewId}.\n   */\n  derivedId?: DerivedViewId\n  label: string\n  description: string\n  icon: LucideIcon\n  /** Render the surface; it mounts its own providers/gates. */\n  render: (ctx: AppViewContext) => ReactNode\n  /**\n   * Parse this view's trailing path segments into a deep-link, or `null` for an\n   * unroutable path (→ not-found). Omitted → a FLAT view ({@link flatPath}): only\n   * the bare path is valid, any trailing segment is not-found.\n   */\n  parsePath?: (segments: string[]) => AppViewDeepLink | null\n  /**\n   * The availability section this view rides on (EC-221 gating): an `unavailable`\n   * section hides the view from the rail. Omitted → always available (a custom\n   * view defaults to visible).\n   */\n  availabilitySection?: SectionId\n  /**\n   * OPTIONAL, default-open per-nav-item visibility (EC-240, vision AD-18). Absent\n   * → visible. Evaluated with the signed-in user's role so devs can configure\n   * role-based sidebars for ANY nav item (not just Users). Distinct from\n   * {@link availabilitySection} (project-config gating): this is per-principal.\n   * See {@link NavPermission}. (Phase-0 contract; the rail wires it in EC-240c —\n   * `resolveSidebar`/`SectionNav` thread the role through and honour a `false`.)\n   */\n  visible?: NavPermission\n  /** A redirect-only / utility view the stock rail does not list (e.g. `builder`). */\n  hidden?: boolean\n}\n\n// --- The sidebar node model (what `nav.*` produces) ---\n\n/**\n * A rail entry that mounts a view. Carries the view object directly — no string id.\n *\n * EC-293: a view node may NEST one level. `children` is a static list of sub-views;\n * `expand` derives them at resolve time from the project's collections (CMS\n * auto-expand). Children render indented under the parent — indentation signals\n * parent→child, distinct from a flat labelled {@link SidebarGroupNode}. `children`\n * (explicit) wins over `expand` when both are set.\n */\nexport interface SidebarViewNode {\n  kind: 'view'\n  view: AppViewModule\n  /** Static sub-views, rendered indented under this view (one level of nesting). */\n  children?: SidebarViewNode[]\n  /**\n   * Resolve-time children from the project's collections (e.g. CMS expanding each\n   * collection into a focused-lens child). Run by `resolveSidebar` with the\n   * config-sourced collections; the result renders as {@link children}.\n   */\n  expand?: (collections: readonly CollectionDef[]) => SidebarViewNode[]\n}\n/**\n * A labelled group of view entries. Groups are presentation only — never routable,\n * and **flat**: their children render aligned with the top-level items (the heading\n * is the only grouping signal). Group children do not nest — use a parent-with-\n * children ({@link SidebarViewNode.expand}/`children`) for nesting (EC-293).\n */\nexport interface SidebarGroupNode {\n  kind: 'group'\n  label: string\n  children: SidebarViewNode[]\n}\n/** A divider between rail sections. */\nexport interface SidebarSeparatorNode {\n  kind: 'separator'\n}\nexport type SidebarNode = SidebarViewNode | SidebarGroupNode | SidebarSeparatorNode\n\n/** Wrap a view as a rail entry. */\nexport function viewNode(view: AppViewModule): SidebarViewNode {\n  return { kind: 'view', view }\n}\n/** A labelled group of view entries (sub-views under a header). */\nexport function groupNode(label: string, children: SidebarViewNode[]): SidebarGroupNode {\n  return { kind: 'group', label, children }\n}\n/** A rail divider. */\nexport function separatorNode(): SidebarSeparatorNode {\n  return { kind: 'separator' }\n}\n\n// --- Deep-link parsers (shared by the built-in views + reused by factories) ---\n\n/** A flat view: only the bare path resolves; any trailing segment is not-found. */\nexport function flatPath(segments: string[]): AppViewDeepLink | null {\n  return segments.length === 0 ? {} : null\n}\n\n/** CMS arity: `[]` index · `[c]` collection · `[c, d]` document; deeper is not-found. */\nexport function cmsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { collectionId: null, documentId: null }\n  if (segments.length === 1) return { collectionId: segments[0]!, documentId: null }\n  if (segments.length === 2) return { collectionId: segments[0]!, documentId: segments[1]! }\n  return null\n}\n\n/** Components arity: `[]` index · `[id]` detail; deeper is not-found. */\nexport function componentsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { componentId: null }\n  if (segments.length === 1) return { componentId: segments[0]! }\n  return null\n}\n\n/** Users arity (EC-240): `[]` list · `[userId]` member detail; deeper is not-found. */\nexport function usersDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { userId: null }\n  if (segments.length === 1) return { userId: segments[0]! }\n  return null\n}\n\n/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found. */\nexport function redirectsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { redirectId: null }\n  if (segments.length === 1) return { redirectId: segments[0]! }\n  return null\n}\n\n/** Assets arity (EC-319): `[]` list · `[assetId]` detail; deeper is not-found. */\nexport function assetsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { assetId: null }\n  if (segments.length === 1) return { assetId: segments[0]! }\n  return null\n}\n\n// --- Availability (EC-221) ---\n\n/**\n * A view's availability for a project (EC-221): the section it rides on, or always\n * `available` when it declares none (a custom view). Drives both the rail (hide\n * `unavailable`) and the bare-project landing target.\n */\nexport function moduleAvailability(project: Project, module: AppViewModule): SectionAvailability {\n  return module.availabilitySection\n    ? availabilityOf(project.settings.sectionAvailability, module.availabilitySection)\n    : 'available'\n}\n\n/**\n * The view a project should open to from its bare URL: the first listed\n * (non-hidden), non-`unavailable` view in rail order. Callers pass the resolved\n * registry's view list (rail order); `undefined` only if every view is\n * hidden/unavailable (the resolver guarantees Settings, so in practice never).\n */\nexport function firstAvailableView(\n  views: readonly AppViewModule[],\n  project: Project,\n): AppViewModule | undefined {\n  return views.find(\n    (view) => !view.hidden && moduleAvailability(project, view) !== 'unavailable',\n  )\n}\n"]}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/components/app-views/module.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { ReactNode } from 'react'\nimport type { LucideIcon } from 'lucide-react'\nimport { availabilityOf } from '@elytracms/core/studio-core'\nimport type { Project, SectionAvailability, SectionId } from '@elytracms/core/studio-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport type { ProjectRole } from '@elytracms/core/persistence'\nimport type { StudioSearch } from '@elytracms/studio/router/search'\nimport type { Locale } from '@elytracms/core/cms-core'\nimport type { OperationsClient } from '@elytracms/core/operations'\nimport type { AuthUser } from '../../lib/auth'\nimport type { useOperationCache, useOperationQuery } from '../../lib/query'\nimport type { NavIssue } from '../nav-issues-registry'\n\n/**\n * The studio **view** contract + the **sidebar node** model — the internal types\n * the consumer-facing `nav.*` builders (EC-237/239, customization seam EC-236)\n * produce.\n *\n * A studio surface (the CMS, Routes, Assets view, or a net-new one) is a\n * self-contained {@link AppViewModule}: a stable id + display metadata + a React\n * `render` + an optional deep-link parser. A {@link SidebarNode} is one rail entry\n * — a view, a labelled group of views, or a separator — and a **view node carries\n * its view object DIRECTLY**, not a string id. This is the redesign's core: there\n * is no separate \"register a view, then reference it by `moduleId`\" indirection\n * and no shared id-keyspace, so the section rail IS the set of views, the router\n * registry is DERIVED from it, and the duplicate-id / both-highlighted class of\n * bug is gone by construction.\n *\n * The boundary principle: everything here is studio-only live code passed by\n * reference (no string keys). A string only crosses the serializable boundary for\n * field controls (`form.control`), where the field lives in delivery-shared schema.\n *\n * Reuse-not-copy (EC-239): a focused view like \"Catalog\" is the CMS surface\n * instantiated with config (`nav.cms({ collections })`), not a fork — the same\n * surface code backs many views, each its own addressable node.\n */\n\n/** The deep-link a view parses out of its trailing path segments (e.g. `{ collectionId, documentId }`). */\nexport type AppViewDeepLink = Record<string, string | null>\n\n/**\n * What an OPTIONAL nav-permission predicate sees (EC-240, vision AD-18): the\n * project + the signed-in user's resolved role (`null` while it loads, or for a\n * non-member). Kept minimal — policy that needs more should live server-side.\n */\nexport interface NavPermissionContext {\n  project: Project\n  role: ProjectRole | null\n}\n\n/**\n * An OPTIONAL, **default-open** per-nav-item visibility predicate (AD-18). Returns\n * `false` to HIDE the item for this principal; absent ⇒ visible. Permissions\n * RESTRICT — they never grant a baseline. This is the general mechanism (applies\n * to EVERY nav item, not a Users special-case); the concrete policy ships in the\n * starter project, never the engine. UI reflection only — the server chokepoint\n * stays the real boundary, and hidden views remain URL-addressable (EC-221).\n */\nexport type NavPermission = (ctx: NavPermissionContext) => boolean\n\n/**\n * Everything a view's surface needs to render (EC-239), and — since EC-616 — what an\n * addon's view reaches the studio through, instead of importing internals: the\n * operations client (the one chokepoint every read and write goes through), the query\n * hooks over the one cache (AD-17), the ambient content locale, and the signed-in user\n * with their role on this project.\n *\n * **The chrome contract** (ruling § 6b item 1): the SHELL draws the top bar, the\n * breadcrumb (its section crumb is the view's `label`; deeper crumbs are contributed with\n * `useSetBreadcrumb`), the rail with its issues foot (contributed with `useNavIssues`),\n * the banners and the theme. The VIEW owns the whole scrollable content area under it,\n * including its own title header — the shell adds no frame, title or padding.\n */\nexport interface AppViewContext {\n  project: Project\n  projectId: string\n  /** The view's parsed deep-link; `{}` for a flat view with no nested resource. */\n  deepLink: AppViewDeepLink\n  /** The validated `?…` search (forced state, focused field/asset, …). */\n  search: StudioSearch\n  /** The studio's operations client — every read and write, authorized at the chokepoint. */\n  operations(): Promise<OperationsClient>\n  /** The query hooks over the studio's one operations-backed cache (AD-17). */\n  query: AppViewQueryHooks\n  /** The ambient content locale (`null` until the project's locale config is installed). */\n  locale: Locale | null\n  /** The signed-in user (`null` while signed out). */\n  user: AuthUser | null\n  /** The user's role on this project (`null` while it loads, or for a non-member). */\n  role: ProjectRole | null\n}\n\n/** The cache hooks a view reads and writes through (`useOperationQuery` / `useOperationCache`). */\nexport interface AppViewQueryHooks {\n  useOperationQuery: typeof useOperationQuery\n  useOperationCache: typeof useOperationCache\n}\n\n/**\n * EC-616 — a view's ALWAYS-ON rail-foot findings: a React hook the rail mounts for every\n * view in it that declares one (whether or not the view is open), publishing what it\n * returns through `useNavIssues`. Use it for a problem the developer must see from any\n * surface (an addon's broken configuration); a finding that only matters while the view\n * is open is published from the view with `useNavIssues` directly.\n */\nexport type NavIssuesHook = (ctx: { project: Project; projectId: string }) => readonly NavIssue[]\n\n/**\n * EC-476/477 — how a view's id came to be, when the builder **derived** it instead of\n * taking an explicit `config.id`.\n *\n * Diagnostics only: nothing routes, renders or resolves on this. It exists because the\n * derived-vs-explicit distinction is otherwise UNRECOVERABLE downstream, and the two\n * must not behave the same. `nav.view({ id: 'cms' })` names a built-in on purpose —\n * that is the documented override feature (EC-236). `nav.view({ label: 'CMS' })` names\n * a *label*, and `slugify` happening to produce `cms` is an accident that costs an\n * entire built-in surface. `resolveSidebar` cannot tell those apart from the finished\n * view: every built-in's own English label slugifies onto its own id\n * (`settingsView().label` = \"Settings\" → `settings`), so inferring \"was this derived?\"\n * by re-slugifying the label misfires on the DEFAULT RAIL. Hence a carried marker.\n *\n * Present only on a derived id — an explicit `config.id` leaves it absent, which is\n * what makes \"the developer meant it\" checkable.\n */\nexport type DerivedViewId =\n  /** Slugified from a custom view's LABEL (`nav.view({ label })`); the label is carried for the message. */\n  | { from: 'label'; label: string }\n  /**\n   * Joined from a MULTI-collection CMS focus with the `-` separator\n   * (`nav.cms({ collections: ['a','b'] })` → `cms:a-b`). The single-collection leaf and\n   * the one-item `cms-group:` parent are deliberately NOT marked: their ids are\n   * unambiguous by construction (EC-468), so there is nothing to diagnose.\n   */\n  | { from: 'collection-join'; collections: readonly string[] }\n\nexport interface AppViewModule {\n  /** Stable id — the first path segment under the project + the registry key. */\n  id: string\n  /**\n   * EC-476/477 — DIAGNOSTIC provenance for an id the builder DERIVED rather than took\n   * from an explicit `config.id`. Absent → the id was declared. See {@link DerivedViewId}.\n   */\n  derivedId?: DerivedViewId\n  label: string\n  description: string\n  icon: LucideIcon\n  /** Render the surface; it mounts its own providers/gates. */\n  render: (ctx: AppViewContext) => ReactNode\n  /**\n   * Parse this view's trailing path segments into a deep-link, or `null` for an\n   * unroutable path (→ not-found). Omitted → a FLAT view ({@link flatPath}): only\n   * the bare path is valid, any trailing segment is not-found.\n   */\n  parsePath?: (segments: string[]) => AppViewDeepLink | null\n  /**\n   * The availability section this view rides on (EC-221 gating): an `unavailable`\n   * section hides the view from the rail. Omitted → always available (a custom\n   * view defaults to visible).\n   */\n  availabilitySection?: SectionId\n  /**\n   * OPTIONAL, default-open per-nav-item visibility (EC-240, vision AD-18). Absent\n   * → visible. Evaluated with the signed-in user's role so devs can configure\n   * role-based sidebars for ANY nav item (not just Users). Distinct from\n   * {@link availabilitySection} (project-config gating): this is per-principal.\n   * See {@link NavPermission}. (Phase-0 contract; the rail wires it in EC-240c —\n   * `resolveSidebar`/`SectionNav` thread the role through and honour a `false`.)\n   */\n  visible?: NavPermission\n  /** A redirect-only / utility view the stock rail does not list (e.g. `builder`). */\n  hidden?: boolean\n  /** EC-616 — always-on rail-foot findings (see {@link NavIssuesHook}). */\n  useIssues?: NavIssuesHook\n}\n\n// --- The sidebar node model (what `nav.*` produces) ---\n\n/**\n * A rail entry that mounts a view. Carries the view object directly — no string id.\n *\n * EC-293: a view node may NEST one level. `children` is a static list of sub-views;\n * `expand` derives them at resolve time from the project's collections (CMS\n * auto-expand). Children render indented under the parent — indentation signals\n * parent→child, distinct from a flat labelled {@link SidebarGroupNode}. `children`\n * (explicit) wins over `expand` when both are set.\n */\nexport interface SidebarViewNode {\n  kind: 'view'\n  view: AppViewModule\n  /** Static sub-views, rendered indented under this view (one level of nesting). */\n  children?: SidebarViewNode[]\n  /**\n   * Resolve-time children from the project's collections (e.g. CMS expanding each\n   * collection into a focused-lens child). Run by `resolveSidebar` with the\n   * config-sourced collections; the result renders as {@link children}.\n   */\n  expand?: (collections: readonly CollectionDef[]) => SidebarViewNode[]\n}\n/**\n * A labelled group of view entries. Groups are presentation only — never routable,\n * and **flat**: their children render aligned with the top-level items (the heading\n * is the only grouping signal). Group children do not nest — use a parent-with-\n * children ({@link SidebarViewNode.expand}/`children`) for nesting (EC-293).\n */\nexport interface SidebarGroupNode {\n  kind: 'group'\n  label: string\n  children: SidebarViewNode[]\n}\n/** A divider between rail sections. */\nexport interface SidebarSeparatorNode {\n  kind: 'separator'\n}\nexport type SidebarNode = SidebarViewNode | SidebarGroupNode | SidebarSeparatorNode\n\n/** Wrap a view as a rail entry. */\nexport function viewNode(view: AppViewModule): SidebarViewNode {\n  return { kind: 'view', view }\n}\n/** A labelled group of view entries (sub-views under a header). */\nexport function groupNode(label: string, children: SidebarViewNode[]): SidebarGroupNode {\n  return { kind: 'group', label, children }\n}\n/** A rail divider. */\nexport function separatorNode(): SidebarSeparatorNode {\n  return { kind: 'separator' }\n}\n\n// --- Deep-link parsers (shared by the built-in views + reused by factories) ---\n\n/** A flat view: only the bare path resolves; any trailing segment is not-found. */\nexport function flatPath(segments: string[]): AppViewDeepLink | null {\n  return segments.length === 0 ? {} : null\n}\n\n/** CMS arity: `[]` index · `[c]` collection · `[c, d]` document; deeper is not-found. */\nexport function cmsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { collectionId: null, documentId: null }\n  if (segments.length === 1) return { collectionId: segments[0]!, documentId: null }\n  if (segments.length === 2) return { collectionId: segments[0]!, documentId: segments[1]! }\n  return null\n}\n\n/** Components arity: `[]` index · `[id]` detail; deeper is not-found. */\nexport function componentsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { componentId: null }\n  if (segments.length === 1) return { componentId: segments[0]! }\n  return null\n}\n\n/** Users arity (EC-240): `[]` list · `[userId]` member detail; deeper is not-found. */\nexport function usersDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { userId: null }\n  if (segments.length === 1) return { userId: segments[0]! }\n  return null\n}\n\n/**\n * A record rail's arity (EC-616): `[]` list · `[id]` one record's detail, under the kind's\n * `idKey`; deeper is not-found.\n */\nexport function recordDeepLink(idKey: string): (segments: string[]) => AppViewDeepLink | null {\n  return (segments) => {\n    if (segments.length === 0) return { [idKey]: null }\n    if (segments.length === 1) return { [idKey]: segments[0]! }\n    return null\n  }\n}\n\n/** Redirects arity (EC-303): `[]` list · `[redirectId]` detail; deeper is not-found — the redirect kind's {@link recordDeepLink}. */\nexport const redirectsDeepLink = recordDeepLink('redirectId')\n\n/** Assets arity (EC-319): `[]` list · `[assetId]` detail; deeper is not-found. */\nexport function assetsDeepLink(segments: string[]): AppViewDeepLink | null {\n  if (segments.length === 0) return { assetId: null }\n  if (segments.length === 1) return { assetId: segments[0]! }\n  return null\n}\n\n// --- Availability (EC-221) ---\n\n/**\n * A view's availability for a project (EC-221): the section it rides on, or always\n * `available` when it declares none (a custom view). Drives both the rail (hide\n * `unavailable`) and the bare-project landing target.\n */\nexport function moduleAvailability(project: Project, module: AppViewModule): SectionAvailability {\n  return module.availabilitySection\n    ? availabilityOf(project.settings.sectionAvailability, module.availabilitySection)\n    : 'available'\n}\n\n/**\n * The view a project should open to from its bare URL: the first listed\n * (non-hidden), non-`unavailable` view in rail order. Callers pass the resolved\n * registry's view list (rail order); `undefined` only if every view is\n * hidden/unavailable (the resolver guarantees Settings, so in practice never).\n */\nexport function firstAvailableView(\n  views: readonly AppViewModule[],\n  project: Project,\n): AppViewModule | undefined {\n  return views.find(\n    (view) => !view.hidden && moduleAvailability(project, view) !== 'unavailable',\n  )\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { useMemo } from 'react';
 import { resolveOverrides } from '@elytracms/core/studio-core';
-import { resolveDeploymentCollections, resolveDeploymentSidebar } from '@elytracms/studio/lib/workspace';
+import { resolveDeploymentCollections, resolveDeploymentSidebar } from '../../lib/workspace/index.js';
 import { firstAvailableView, moduleAvailability, viewNode, } from './module.js';
 import { DEFAULT_VIEWS, checkSidebarIdKeyspace } from './default-modules.js';
 /** The default rail: every non-hidden built-in view as a plain entry, in canonical order. */

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 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 NavPermission,\n  type NavPermissionContext,\n  type SidebarNode,\n  type SidebarViewNode,\n} from './module'\nimport { DEFAULT_VIEWS, checkSidebarIdKeyspace } 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. Ids the builders DERIVED are screened BEFORE that core\n * ({@link checkSidebarIdKeyspace}, EC-476/477): to a generic seam an id is just a\n * string, so a slug that happened to equal a built-in id read as an intentional\n * replacement and swallowed the surface. 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-240 (AD-18): the view's OPTIONAL, default-open nav-permission predicate,\n   * carried through resolution so the rail can evaluate it against the live role\n   * (which resolution — memoised on `project` alone — does not have). Absent →\n   * always visible.\n   */\n  visible?: NavPermission\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, derived-id collision) — 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  // EC-476/477: an id a builder DERIVED is not a request to replace whatever it happens\n  // to equal. Screened BEFORE the seam, which sees only strings and so cannot tell an\n  // intentional override from a coincidence of spelling (see `checkSidebarIdKeyspace`).\n  const keyspace = checkSidebarIdKeyspace(railOrderViews, 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: keyspace.views.map((view) => ({ id: view.id, value: view })),\n    allowNew: true,\n    // EC-478: a rejection carries its catalog key as well as its English, so the\n    // `{reason}` half of `invalid-override` localizes with the sentence around it.\n    validate: (entry) => {\n      const view = entry.value\n      if (typeof view.render !== 'function')\n        return {\n          message: 'the view has no render function',\n          key: 'customization.issue.reason.viewNoRender',\n        }\n      if (typeof view.label !== 'string' || view.label.trim().length === 0)\n        return { message: 'the view has no label', key: 'customization.issue.reason.viewNoLabel' }\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      ...(resolvedView.visible ? { visible: resolvedView.visible } : {}),\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  // Keyspace findings first: a derived-id collision is the CAUSE of any duplicate that\n  // follows it, so it reads before the symptom at the rail foot.\n  return { nodes: railNodes, registry, issues: [...keyspace.issues, ...resolved.issues] }\n}\n\nfunction isRailView(view: ResolvedRailView | null): view is ResolvedRailView {\n  return view !== null\n}\n\n/**\n * Evaluate a rail view's OPTIONAL nav-permission predicate (EC-240, AD-18):\n * default-open — absent → visible; present → the predicate decides against the\n * live role. UI reflection only; the server chokepoint is the real boundary and\n * a hidden view stays URL-addressable (EC-221).\n */\nexport function isNavViewVisible(\n  view: Pick<ResolvedRailView, 'visible'>,\n  ctx: NavPermissionContext,\n): boolean {\n  return view.visible ? view.visible(ctx) : true\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"]}
+{"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 '../../lib/workspace'\nimport {\n  firstAvailableView,\n  moduleAvailability,\n  viewNode,\n  type AppViewModule,\n  type NavPermission,\n  type NavPermissionContext,\n  type SidebarNode,\n  type SidebarViewNode,\n} from './module'\nimport { DEFAULT_VIEWS, checkSidebarIdKeyspace } 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. Ids the builders DERIVED are screened BEFORE that core\n * ({@link checkSidebarIdKeyspace}, EC-476/477): to a generic seam an id is just a\n * string, so a slug that happened to equal a built-in id read as an intentional\n * replacement and swallowed the surface. 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-240 (AD-18): the view's OPTIONAL, default-open nav-permission predicate,\n   * carried through resolution so the rail can evaluate it against the live role\n   * (which resolution — memoised on `project` alone — does not have). Absent →\n   * always visible.\n   */\n  visible?: NavPermission\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, derived-id collision) — 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  // EC-476/477: an id a builder DERIVED is not a request to replace whatever it happens\n  // to equal. Screened BEFORE the seam, which sees only strings and so cannot tell an\n  // intentional override from a coincidence of spelling (see `checkSidebarIdKeyspace`).\n  const keyspace = checkSidebarIdKeyspace(railOrderViews, 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: keyspace.views.map((view) => ({ id: view.id, value: view })),\n    allowNew: true,\n    // EC-478: a rejection carries its catalog key as well as its English, so the\n    // `{reason}` half of `invalid-override` localizes with the sentence around it.\n    validate: (entry) => {\n      const view = entry.value\n      if (typeof view.render !== 'function')\n        return {\n          message: 'the view has no render function',\n          key: 'customization.issue.reason.viewNoRender',\n        }\n      if (typeof view.label !== 'string' || view.label.trim().length === 0)\n        return { message: 'the view has no label', key: 'customization.issue.reason.viewNoLabel' }\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      ...(resolvedView.visible ? { visible: resolvedView.visible } : {}),\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  // Keyspace findings first: a derived-id collision is the CAUSE of any duplicate that\n  // follows it, so it reads before the symptom at the rail foot.\n  return { nodes: railNodes, registry, issues: [...keyspace.issues, ...resolved.issues] }\n}\n\nfunction isRailView(view: ResolvedRailView | null): view is ResolvedRailView {\n  return view !== null\n}\n\n/**\n * Evaluate a rail view's OPTIONAL nav-permission predicate (EC-240, AD-18):\n * default-open — absent → visible; present → the predicate decides against the\n * live role. UI reflection only; the server chokepoint is the real boundary and\n * a hidden view stays URL-addressable (EC-221).\n */\nexport function isNavViewVisible(\n  view: Pick<ResolvedRailView, 'visible'>,\n  ctx: NavPermissionContext,\n): boolean {\n  return view.visible ? view.visible(ctx) : true\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

@@ -1,10 +1,11 @@
 import type { ReactNode } from 'react';
 import type { FieldDef } from '@elytracms/core/cms-core';
-import type { StudioI18nConfig } from '@elytracms/studio/lib/i18n';
-import type { StudioAiConfig } from '@elytracms/studio/lib/ai';
+import type { StudioI18nConfig } from '../../lib/i18n/index.js';
+import type { StudioAiConfig } from '../../lib/ai/index.js';
 import type { GeneratedPreviewLookup } from '../builder/blocks-model.js';
 import type { StudioReuseConfig } from '../builder/reuse.js';
 import type { SidebarNode } from './module.js';
+import type { DocumentPane } from '../inspector/document-panes.js';
 /**
  * EC-236 — the studio customization config: the single, studio-only home for
  * everything a consuming repo customizes about the builder UI.
@@ -107,6 +108,14 @@ export interface StudioConfig {
      * validation issue, never a silent fallback to guessing.
      */
     reuse?: StudioReuseConfig;
+    /**
+     * Panes contributed to the document editor's inspector (EC-618 — AD-19's edit-shell
+     * slot), beside the frame's own Details / Versions / Issues: direct values, built with
+     * `documentPane({ id, label, render })` from `@elytracms/studio/addon` or exported by an
+     * addon (`analyticsDocumentPane`). CMS documents only; a pane's `collections` narrows it.
+     * Studio-only, like every key here.
+     */
+    documentPanes?: DocumentPane[];
 }
 /**
  * The generated-preview seam (EC-439 AD-2). `generated` is a PURE lookup —

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

@@ -1 +1 @@
-{"version":3,"file":"studio-config.js","sourceRoot":"","sources":["../../../src/components/app-views/studio-config.ts"],"names":[],"mappings":"AA8JA;;;;;;;;;;;;;;;;;;;;;;;;;;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 { StudioI18nConfig } from '@elytracms/studio/lib/i18n'\nimport type { StudioAiConfig } from '@elytracms/studio/lib/ai'\nimport type { GeneratedPreviewLookup } from '../builder/blocks-model'\nimport type { StudioReuseConfig } from '../builder/reuse'\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   * Studio-UI localization (EC-241): the default locale + imported translation\n   * catalogs. English is the built-in source; a consumer adds e.g.\n   * `i18n: { locales: { de: deMessages } }` and the studio chrome renders in the\n   * browser's preferred locale (no persisted selector in v1). Studio-only — never\n   * reaches the delivery bundle. Schema labels localize separately, via a\n   * `LocalizedString` on the field/collection def.\n   */\n  i18n?: StudioI18nConfig\n  /**\n   * AI platform (EC-331): provider, project knowledge, and soft limits. The block's\n   * PRESENCE enables the AI feature; its ABSENCE means the feature is fully absent —\n   * no AI UI and no AI dependencies on the critical path (the runtime lives behind a\n   * lazy boundary in `@elytracms/studio/lib/ai`, only reached when configured).\n   * `enabled: false` is a temporary kill-switch. Studio-only live code (holds the\n   * provider adapter + knowledge functions) — never reaches the delivery bundle.\n   * Validated at load by `resolveAiConfig` (capability gate: tool calling + structured\n   * output required, fail-loud).\n   */\n  ai?: StudioAiConfig\n  /**\n   * Canvas page-surface theming (EC-389): make the preview iframe wear the SITE's\n   * chrome. Direct values (no registries): body classes + raw CSS, injected LAST\n   * into the canvas iframe — after the studio defaults — so consumer values win\n   * the cascade. This themes the canvas\n   * PAGE surface only, never the studio chrome (branding/logo theming is a future,\n   * separate key).\n   */\n  canvas?: StudioCanvasTheme\n  /**\n   * Insert-menu preview artifacts (EC-439, the seam EC-440 fills): where the\n   * studio's blocks panel finds GENERATED preview images for component\n   * fixtures. Studio-only (from `defineStudio`, never the delivery bundle) and\n   * fully optional — absent, tiles fall back from a curated\n   * `manifest.previewImage` straight to the icon+name placeholder. The EC-440\n   * CLI (`elytra previews`) renders fixtures headlessly against the consumer\n   * theme and writes a previews manifest; the consumer adapts that manifest\n   * into `previews.generated` here.\n   */\n  previews?: StudioPreviewsConfig\n  /**\n   * Reusable elements (EC-467, AD-b): WHICH component is this project's\n   * reusable-element embed. One line, and only when needed —\n   * `reuse: { component: 'project.Reusable' }`.\n   *\n   * **ABSENCE MEANS INFER, not off.** Unlike the `ai?` precedent, omitting this\n   * block does not disable anything: the studio derives the embed from config as\n   * it always has (a slot-less component with one cardinality-one `relation` prop\n   * whose target collection holds a `blocks` field), so the zero-config promise is\n   * untouched and no existing consumer needs to change anything. Declare it only\n   * when the inference cannot decide — the studio then says so, by name, in the\n   * rail's issue list rather than silently switching the reuse gestures off.\n   *\n   * **Reusable elements are singular per project (AD-a):** exactly one embed\n   * component and exactly one reusable collection. This is one value, never a\n   * list. The collection and the composition field DERIVE from the declared\n   * component (its sole single-document relation prop → that prop's target\n   * collection → that collection's `blocks` field), which is why the declaration\n   * stays a single identifier.\n   *\n   * Studio-only, like every key here — the whole feature is studio-side (canvas\n   * gestures + publish integrity), so it has zero delivery-wire surface and never\n   * reaches the `frontend/` bundle. A declaration that cannot resolve is a visible\n   * validation issue, never a silent fallback to guessing.\n   */\n  reuse?: StudioReuseConfig\n}\n\n/**\n * The generated-preview seam (EC-439 AD-2). `generated` is a PURE lookup —\n * component id + fixture name → image URL (`undefined` = no artifact). A\n * fixture-less component's single implicit variant is looked up under the\n * fixture name `'Default'`. Curated `manifest.previewImage` always wins over\n * this lookup; the lookup wins over the placeholder.\n */\nexport interface StudioPreviewsConfig {\n  generated?: GeneratedPreviewLookup\n}\n\n/**\n * The canvas page-surface theme (EC-389). Both knobs target the preview iframe\n * document — the isolated page the builder renders into — so a site whose theme\n * styles `body` (background, color, font) previews exactly as it delivers.\n */\nexport interface StudioCanvasTheme {\n  /**\n   * REPLACES the studio's default canvas body classes\n   * (`bg-background text-foreground font-sans`). The default's utility classes\n   * out-cascade a site theme's `@layer base body` rules (Tailwind layers lose to\n   * later layers/un-layered styles), which is exactly how a site's page background\n   * used to paint white in the canvas — pass `''` to drop the default entirely and\n   * let the site's own `body` rules (from the canvas stylesheet) take over, or\n   * pass your own classes. Omitted → the studio default stays.\n   */\n  bodyClassName?: string\n  /**\n   * Raw CSS injected into the canvas iframe as the LAST style element — after the\n   * canvas stylesheet and the studio editing chrome — so it wins the cascade over\n   * both (an un-layered `body { background: … }` or a `:root { --token: … }`\n   * override both work).\n   */\n  tokensCss?: string\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/config').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"]}
+{"version":3,"file":"studio-config.js","sourceRoot":"","sources":["../../../src/components/app-views/studio-config.ts"],"names":[],"mappings":"AAuKA;;;;;;;;;;;;;;;;;;;;;;;;;;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 { StudioI18nConfig } from '../../lib/i18n'\nimport type { StudioAiConfig } from '../../lib/ai'\nimport type { GeneratedPreviewLookup } from '../builder/blocks-model'\nimport type { StudioReuseConfig } from '../builder/reuse'\nimport type { SidebarNode } from './module'\nimport type { DocumentPane } from '../inspector/document-panes'\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   * Studio-UI localization (EC-241): the default locale + imported translation\n   * catalogs. English is the built-in source; a consumer adds e.g.\n   * `i18n: { locales: { de: deMessages } }` and the studio chrome renders in the\n   * browser's preferred locale (no persisted selector in v1). Studio-only — never\n   * reaches the delivery bundle. Schema labels localize separately, via a\n   * `LocalizedString` on the field/collection def.\n   */\n  i18n?: StudioI18nConfig\n  /**\n   * AI platform (EC-331): provider, project knowledge, and soft limits. The block's\n   * PRESENCE enables the AI feature; its ABSENCE means the feature is fully absent —\n   * no AI UI and no AI dependencies on the critical path (the runtime lives behind a\n   * lazy boundary in `@elytracms/studio/lib/ai`, only reached when configured).\n   * `enabled: false` is a temporary kill-switch. Studio-only live code (holds the\n   * provider adapter + knowledge functions) — never reaches the delivery bundle.\n   * Validated at load by `resolveAiConfig` (capability gate: tool calling + structured\n   * output required, fail-loud).\n   */\n  ai?: StudioAiConfig\n  /**\n   * Canvas page-surface theming (EC-389): make the preview iframe wear the SITE's\n   * chrome. Direct values (no registries): body classes + raw CSS, injected LAST\n   * into the canvas iframe — after the studio defaults — so consumer values win\n   * the cascade. This themes the canvas\n   * PAGE surface only, never the studio chrome (branding/logo theming is a future,\n   * separate key).\n   */\n  canvas?: StudioCanvasTheme\n  /**\n   * Insert-menu preview artifacts (EC-439, the seam EC-440 fills): where the\n   * studio's blocks panel finds GENERATED preview images for component\n   * fixtures. Studio-only (from `defineStudio`, never the delivery bundle) and\n   * fully optional — absent, tiles fall back from a curated\n   * `manifest.previewImage` straight to the icon+name placeholder. The EC-440\n   * CLI (`elytra previews`) renders fixtures headlessly against the consumer\n   * theme and writes a previews manifest; the consumer adapts that manifest\n   * into `previews.generated` here.\n   */\n  previews?: StudioPreviewsConfig\n  /**\n   * Reusable elements (EC-467, AD-b): WHICH component is this project's\n   * reusable-element embed. One line, and only when needed —\n   * `reuse: { component: 'project.Reusable' }`.\n   *\n   * **ABSENCE MEANS INFER, not off.** Unlike the `ai?` precedent, omitting this\n   * block does not disable anything: the studio derives the embed from config as\n   * it always has (a slot-less component with one cardinality-one `relation` prop\n   * whose target collection holds a `blocks` field), so the zero-config promise is\n   * untouched and no existing consumer needs to change anything. Declare it only\n   * when the inference cannot decide — the studio then says so, by name, in the\n   * rail's issue list rather than silently switching the reuse gestures off.\n   *\n   * **Reusable elements are singular per project (AD-a):** exactly one embed\n   * component and exactly one reusable collection. This is one value, never a\n   * list. The collection and the composition field DERIVE from the declared\n   * component (its sole single-document relation prop → that prop's target\n   * collection → that collection's `blocks` field), which is why the declaration\n   * stays a single identifier.\n   *\n   * Studio-only, like every key here — the whole feature is studio-side (canvas\n   * gestures + publish integrity), so it has zero delivery-wire surface and never\n   * reaches the `frontend/` bundle. A declaration that cannot resolve is a visible\n   * validation issue, never a silent fallback to guessing.\n   */\n  reuse?: StudioReuseConfig\n  /**\n   * Panes contributed to the document editor's inspector (EC-618 — AD-19's edit-shell\n   * slot), beside the frame's own Details / Versions / Issues: direct values, built with\n   * `documentPane({ id, label, render })` from `@elytracms/studio/addon` or exported by an\n   * addon (`analyticsDocumentPane`). CMS documents only; a pane's `collections` narrows it.\n   * Studio-only, like every key here.\n   */\n  documentPanes?: DocumentPane[]\n}\n\n/**\n * The generated-preview seam (EC-439 AD-2). `generated` is a PURE lookup —\n * component id + fixture name → image URL (`undefined` = no artifact). A\n * fixture-less component's single implicit variant is looked up under the\n * fixture name `'Default'`. Curated `manifest.previewImage` always wins over\n * this lookup; the lookup wins over the placeholder.\n */\nexport interface StudioPreviewsConfig {\n  generated?: GeneratedPreviewLookup\n}\n\n/**\n * The canvas page-surface theme (EC-389). Both knobs target the preview iframe\n * document — the isolated page the builder renders into — so a site whose theme\n * styles `body` (background, color, font) previews exactly as it delivers.\n */\nexport interface StudioCanvasTheme {\n  /**\n   * REPLACES the studio's default canvas body classes\n   * (`bg-background text-foreground font-sans`). The default's utility classes\n   * out-cascade a site theme's `@layer base body` rules (Tailwind layers lose to\n   * later layers/un-layered styles), which is exactly how a site's page background\n   * used to paint white in the canvas — pass `''` to drop the default entirely and\n   * let the site's own `body` rules (from the canvas stylesheet) take over, or\n   * pass your own classes. Omitted → the studio default stays.\n   */\n  bodyClassName?: string\n  /**\n   * Raw CSS injected into the canvas iframe as the LAST style element — after the\n   * canvas stylesheet and the studio editing chrome — so it wins the cascade over\n   * both (an un-layered `body { background: … }` or a `:root { --token: … }`\n   * override both work).\n   */\n  tokensCss?: string\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/config').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/assets/asset-detail.js

@@ -2,8 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useMemo, useState } from 'react';
 import { AlertTriangle, Link2, RotateCcw, Trash2 } from 'lucide-react';
 import { Link, STUDIO_PROJECT_ROUTE, useNavigate } from '@elytracms/studio/router';
-import { localizedLabel, translate } from '@elytracms/studio/lib/i18n';
-import { buildAssetReferenceImpact, loadInboundAssetReferenceViews } from '@elytracms/studio/lib/references';
+import { localizedLabel, translate } from '../../lib/i18n/index.js';
+import { buildAssetReferenceImpact, loadInboundAssetReferenceViews } from '../../lib/references/index.js';
 import { Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Field, Heading, Panel, PanelBody, PanelHeader, Row, Spacer, Stack, Text, } from '@elytracms/studio/ui';
 import { FieldControl } from '../cms/field-control.js';
 import { fieldLabel } from '../cms/cms-labels.js';

package/dist/components/assets/asset-detail.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-detail.js","sourceRoot":"","sources":["../../../src/components/assets/asset-detail.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { AlertTriangle, Link2, RotateCcw, Trash2 } from 'lucide-react'\nimport type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport { Link, STUDIO_PROJECT_ROUTE, useNavigate } from '@elytracms/studio/router'\nimport { localizedLabel, translate } from '@elytracms/studio/lib/i18n'\nimport { buildAssetReferenceImpact, loadInboundAssetReferenceViews } from '@elytracms/studio/lib/references'\nimport type { ReferenceEntryView } from '@elytracms/studio/lib/references'\nimport {\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Field,\n  Heading,\n  Panel,\n  PanelBody,\n  PanelHeader,\n  Row,\n  Spacer,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { FieldControl } from '../cms/field-control'\nimport { fieldLabel } from '../cms/cms-labels'\nimport { ReferenceImpactRows } from '../cms/reference-confirm'\nimport { ReferencesPanel } from '../references/references-panel'\nimport { useSetBreadcrumb } from '../breadcrumb-context'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport { FocalCropPreviews, FocalPointPicker, useAssetRecord } from './asset-thumb'\nimport type { FocalPoint } from './focal-point'\nimport { assetMetaFieldsOf, assetMetaSeed, formatBytes, pruneMeta } from './asset-metadata'\nimport { useAssets } from './assets-store'\nimport { ReplaceFileButton } from './replace-file'\n\n/**\n * The assets rail's DETAIL surface (EC-319). Pragmatic call: assets don't fit\n * the portable `PortableDetailEditor` shell cleanly — there's no dirty/Save/\n * Publish document model here (an asset record isn't a `cmsDocument`), and the\n * focal-point picker is a bespoke drag interaction over the image, not a\n * scalar field value a generic form row can host without contortions. So this\n * is a bespoke surface (mirrors the CMS document editor's shape: a header +\n * panels), reached via the SAME rail-owned `detailPath`/`listPath` seam every\n * other rail uses (AD-19) — only the body differs.\n *\n * Unifies what were two divergent asset-edit UIs before this task: the plain\n * alt/title dialog on the old asset library card, and the richer schema-driven\n * + focal-point \"image options\" dialog opened from an `asset` field elsewhere\n * (`field-control.tsx`). This page reuses the LATTER (richer) content, so\n * editing an asset here is never a downgrade from editing it via a field.\n *\n * Deletion keeps the EC-202 reference-index safe-delete path (`assets-store.tsx`\n * → `deleteAsset`, keyed on `{ type: 'asset' }`). Since EC-433 the universal\n * table's row/bulk delete runs the SAME asset-shaped reference check (the\n * source's `referenceTarget`) and the same confirmed store delete — the two\n * surfaces share one delete semantics, not two divergent ones.\n */\nexport function AssetDetail({ projectId, assetId }: { projectId: string; assetId: string }) {\n  const source = useCollectionView()\n  const store = useAssets()\n  const record = useAssetRecord(assetId)\n  const collection = source.schema\n\n  const collectionLabel = localizedLabel(collection.form?.label, collection.id)\n  useSetBreadcrumb(\n    useMemo(() => {\n      if (source.listPath === undefined) return [{ label: collectionLabel }]\n      const title = record?.title ?? record?.filename ?? assetId\n      return [\n        { label: collectionLabel, to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: source.listPath } },\n        { label: title },\n      ]\n    }, [collectionLabel, source.listPath, record, projectId, assetId]),\n  )\n\n  if (record === undefined) {\n    if (store.status === 'loading') {\n      return (\n        <Stack className=\"h-full place-items-center p-8\" align=\"center\" justify=\"center\">\n          <Text size=\"sm\" tone=\"muted\">\n            {translate('assets.loading')}\n          </Text>\n        </Stack>\n      )\n    }\n    return (\n      <div className=\"grid h-full place-items-center p-8\">\n        <Stack gap=\"3\" align=\"center\" className=\"text-center\">\n          <Heading level={2} size=\"h2\">\n            {translate('cms.editor.notFoundTitle')}\n          </Heading>\n          {source.listPath !== undefined ? (\n            <Link\n              to={STUDIO_PROJECT_ROUTE}\n              params={{ projectId, _splat: source.listPath }}\n              className=\"text-sm text-primary hover:underline\"\n            >\n              {translate('cms.editor.backToList', { label: collectionLabel })}\n            </Link>\n          ) : null}\n        </Stack>\n      </div>\n    )\n  }\n\n  // Remount per asset (the surface's own key, set by the caller) resets every\n  // local buffer below cleanly when navigating from one asset's detail to\n  // another — no stale-state carryover to guard against by hand.\n  return <AssetDetailBody projectId={projectId} record={record} collection={source.schema} />\n}\n\nfunction AssetDetailBody({\n  projectId,\n  record,\n  collection,\n}: {\n  projectId: string\n  record: AssetRecord\n  collection: CollectionDef\n}) {\n  const store = useAssets()\n  const metaFields = useMemo(() => assetMetaFieldsOf(collection), [collection])\n\n  // Metadata buffers locally and commits explicitly (Save) — an asset record has\n  // no dirty/Save document model of its own to piggyback on. The focal point\n  // commits immediately (it drives a live visual), matching the field's options\n  // dialog (`field-control.tsx`).\n  // EC-587: the bag the editor starts from has a legacy `alt` column lifted in, so a\n  // not-yet-migrated asset shows its alt and the save moves it to `meta.alt`.\n  const [meta, setMeta] = useState<Record<string, unknown>>(() => assetMetaSeed(record))\n  const [focal, setFocal] = useState<FocalPoint | undefined>(record.focalPoint)\n  const [dirty, setDirty] = useState(false)\n  const [saving, setSaving] = useState(false)\n  const [saveError, setSaveError] = useState<string | null>(null)\n  // EC-568: after a file replace the focal point is KEPT (the ticket's recommendation),\n  // but it was chosen on the old pixels — say so beside the picker.\n  const [replaced, setReplaced] = useState(false)\n\n  function onReplaced(asset: AssetRecord) {\n    // The new file may have brought metadata: start the buffer from the stored record.\n    setMeta(assetMetaSeed(asset))\n    setFocal(asset.focalPoint)\n    setDirty(false)\n    setReplaced(true)\n  }\n\n  function setField(name: string, value: unknown) {\n    setDirty(true)\n    setMeta((m) => ({ ...m, [name]: value }))\n  }\n\n  async function save() {\n    setSaving(true)\n    setSaveError(null)\n    const result = await store.updateMetadata(record.id, { meta: pruneMeta(meta) })\n    setSaving(false)\n    if (result.ok) setDirty(false)\n    else setSaveError(result.message)\n  }\n\n  function commitFocal(point: FocalPoint | null) {\n    setFocal(point ?? undefined)\n    void store.updateMetadata(record.id, { focalPoint: point })\n  }\n\n  return (\n    <Stack gap=\"4\" className=\"mx-auto max-w-3xl p-4 pb-10 sm:p-6\">\n      <AssetDetailHeader\n        projectId={projectId}\n        record={record}\n        replace={\n          <ReplaceFileButton\n            record={record}\n            disabled={dirty}\n            disabledHint={translate('cms.asset.replaceSaveFirst')}\n            onReplaced={onReplaced}\n          />\n        }\n      />\n\n      <Panel>\n        <PanelHeader>\n          <Row align=\"center\" className=\"w-full\">\n            <Text size=\"xs\" weight=\"semibold\" tone=\"muted\">\n              {translate('cms.asset.focalPoint')}\n            </Text>\n            <Spacer />\n            {focal ? (\n              <Button variant=\"ghost\" size=\"sm\" onClick={() => commitFocal(null)}>\n                <RotateCcw /> {translate('cms.asset.resetToCentre')}\n              </Button>\n            ) : null}\n          </Row>\n        </PanelHeader>\n        <PanelBody>\n          <Stack gap=\"2\">\n            <FocalPointPicker record={record} point={focal} onChange={commitFocal} onPreview={setFocal} />\n            {replaced ? (\n              <Text size=\"xs\" className=\"font-medium\" data-testid=\"asset-replaced-check-focal\">\n                {translate('cms.asset.replacedCheckFocal')}\n              </Text>\n            ) : null}\n            <Text size=\"xs\" tone=\"subtle\">\n              {translate('cms.asset.focalPointHint')}\n            </Text>\n            <FocalCropPreviews record={record} point={focal} />\n          </Stack>\n        </PanelBody>\n      </Panel>\n\n      <Panel data-testid=\"asset-detail-meta\">\n        <PanelHeader>\n          <Text size=\"xs\" weight=\"semibold\" tone=\"muted\">\n            {translate('assets.detail.metadataHeading')}\n          </Text>\n        </PanelHeader>\n        <PanelBody>\n          <Stack gap=\"3\">\n            {metaFields.map((f: FieldDef) => (\n              <Field\n                key={f.name}\n                label={fieldLabel(f)}\n                hint={localizedLabel(f.form?.description) || undefined}\n              >\n                <FieldControl\n                  id={`asset-detail-${f.name}`}\n                  field={f}\n                  value={meta[f.name]}\n                  readOnly={false}\n                  onChange={(v) => setField(f.name, v)}\n                />\n              </Field>\n            ))}\n            {metaFields.length === 0 ? (\n              <Text size=\"sm\" tone=\"subtle\">\n                {translate('cms.asset.noMetaFields', { code1: 'alt', code2: 'copyright' })}\n              </Text>\n            ) : null}\n            {saveError ? (\n              <Text size=\"sm\" className=\"text-destructive\" data-testid=\"asset-detail-save-error\">\n                {saveError}\n              </Text>\n            ) : null}\n            {metaFields.length > 0 ? (\n              <Row gap=\"2\">\n                <Spacer />\n                <Button\n                  size=\"sm\"\n                  onClick={() => void save()}\n                  disabled={!dirty || saving}\n                  data-testid=\"asset-detail-save\"\n                >\n                  {saving ? translate('common.saving') : translate('common.save')}\n                </Button>\n              </Row>\n            ) : null}\n          </Stack>\n        </PanelBody>\n      </Panel>\n    </Stack>\n  )\n}\n\n/** Filename/title heading + system info (content type, dimensions, size) + actions. */\nfunction AssetDetailHeader({\n  projectId,\n  record,\n  replace,\n}: {\n  projectId: string\n  record: AssetRecord\n  replace?: ReactNode\n}) {\n  const dims = record.width && record.height ? `${record.width}×${record.height}` : null\n  const info = [record.contentType, dims, formatBytes(record.byteSize)].filter(Boolean).join(' · ')\n  return (\n    <Row gap=\"3\" align=\"start\" wrap>\n      <Stack gap=\"1\" className=\"min-w-0 flex-1\">\n        <Heading level={2} size=\"h2\" className=\"truncate\" title={record.title ?? record.filename}>\n          {record.title ?? record.filename}\n        </Heading>\n        {record.title ? (\n          <Text size=\"sm\" tone=\"muted\" className=\"truncate\">\n            {record.filename}\n          </Text>\n        ) : null}\n        <Text size=\"xs\" tone=\"subtle\">\n          {info}\n        </Text>\n      </Stack>\n      <Row gap=\"2\" wrap>\n        {replace}\n        <AssetReferencesButton projectId={projectId} record={record} />\n        <AssetDeleteButton projectId={projectId} record={record} />\n      </Row>\n    </Row>\n  )\n}\n\n/** \"Where is this asset used?\" (EC-172): the shared references panel, EC-155-backed. */\nfunction AssetReferencesButton({ projectId, record }: { projectId: string; record: AssetRecord }) {\n  const [open, setOpen] = useState(false)\n  return (\n    <>\n      <Button\n        variant=\"outline\"\n        size=\"sm\"\n        onClick={() => setOpen(true)}\n        data-testid=\"asset-detail-references\"\n      >\n        <Link2 /> {translate('assets.references.buttonLabel')}\n      </Button>\n      <Dialog open={open} onOpenChange={setOpen}>\n        <DialogContent className=\"max-w-lg\">\n          <DialogHeader>\n            <DialogTitle>\n              {translate('assets.references.title', { name: record.title ?? record.filename })}\n            </DialogTitle>\n            <DialogDescription>{translate('assets.references.description')}</DialogDescription>\n          </DialogHeader>\n          {open ? (\n            <ReferencesPanel projectId={projectId} target={{ type: 'asset', id: record.id }} />\n          ) : null}\n        </DialogContent>\n      </Dialog>\n    </>\n  )\n}\n\n/**\n * Reference-respecting delete (EC-151, EC-202): enumerates the exact inbound\n * references — index-accurate, with deep links to the field/node — before\n * removing. Deleting a referenced asset is weak-by-default (allowed with an\n * explicit \"delete anyway\"); every reference dangles into a visible validation\n * issue rather than silently breaking. On success, returns to the list.\n */\nfunction AssetDeleteButton({ projectId, record }: { projectId: string; record: AssetRecord }) {\n  const source = useCollectionView()\n  const store = useAssets()\n  const navigate = useNavigate()\n  const [open, setOpen] = useState(false)\n  const [usages, setUsages] = useState<ReferenceEntryView[] | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n\n  const openDialog = async () => {\n    setOpen(true)\n    setError(null)\n    setUsages(null)\n    try {\n      setUsages(await loadInboundAssetReferenceViews(projectId, record.id))\n    } catch (cause) {\n      setError(cause instanceof Error ? cause.message : String(cause))\n    }\n  }\n\n  const confirm = async () => {\n    setBusy(true)\n    setError(null)\n    // The dialog has already enumerated usages (or shown there are none) and the\n    // user is confirming either way — confirm unconditionally, skipping the\n    // redundant inbound re-check (EC-301 perf). Weak-by-default: a still-\n    // referenced asset deletes anyway, dangling into a visible issue.\n    const result = await store.remove(record.id, { confirmInUse: true })\n    setBusy(false)\n    if (result.outcome === 'deleted' || result.outcome === 'not-found') {\n      setOpen(false)\n      if (source.listPath !== undefined) {\n        void navigate({ to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: source.listPath } })\n      }\n    } else if (result.outcome === 'blocked') {\n      setError(\n        translate(\n          result.usageCount === 1 ? 'assets.delete.raceError.one' : 'assets.delete.raceError.other',\n          { count: result.usageCount },\n        ),\n      )\n    } else {\n      setError(result.message)\n    }\n  }\n\n  const impact = usages ? buildAssetReferenceImpact(usages) : null\n  const usageCount = impact?.broken.length ?? 0\n  return (\n    <>\n      <Button\n        variant=\"outline\"\n        size=\"sm\"\n        onClick={() => void openDialog()}\n        data-testid=\"asset-detail-delete\"\n      >\n        <Trash2 /> {translate('common.delete')}\n      </Button>\n      <Dialog open={open} onOpenChange={setOpen}>\n        <DialogContent className=\"max-h-[80vh] max-w-md overflow-y-auto\">\n          <DialogHeader>\n            <DialogTitle>{translate('assets.delete.title', { filename: record.filename })}</DialogTitle>\n            <DialogDescription>{translate('assets.delete.description')}</DialogDescription>\n          </DialogHeader>\n          {usages === null && error === null ? (\n            <Text size=\"sm\" tone=\"muted\">\n              {translate('assets.delete.checking')}\n            </Text>\n          ) : usageCount > 0 ? (\n            <Stack gap=\"2\" data-testid=\"asset-usage-warning\">\n              <Row gap=\"2\">\n                <AlertTriangle className=\"size-4 text-warning\" />\n                <Text size=\"sm\" weight=\"semibold\">\n                  {translate(usageCount === 1 ? 'assets.delete.inUse.one' : 'assets.delete.inUse.other', {\n                    count: usageCount,\n                  })}\n                </Text>\n              </Row>\n              <ReferenceImpactRows\n                projectId={projectId}\n                broken={impact!.broken}\n                onNavigate={() => setOpen(false)}\n              />\n              <Text size=\"xs\" tone=\"muted\">\n                {translate('assets.delete.brokenWarning')}\n              </Text>\n            </Stack>\n          ) : (\n            <Text size=\"sm\" tone=\"muted\">\n              {translate('assets.delete.noReferences')}\n            </Text>\n          )}\n          {error ? (\n            <Text size=\"sm\" className=\"text-destructive\" data-testid=\"asset-delete-error\">\n              {error}\n            </Text>\n          ) : null}\n          <DialogFooter>\n            <Button variant=\"ghost\" size=\"sm\" onClick={() => setOpen(false)} disabled={busy}>\n              {translate('common.cancel')}\n            </Button>\n            <Button\n              variant=\"destructive\"\n              size=\"sm\"\n              onClick={() => void confirm()}\n              disabled={busy || usages === null}\n              data-testid=\"asset-delete-confirm\"\n            >\n              {usageCount > 0 ? translate('assets.delete.confirmAnyway') : translate('common.delete')}\n            </Button>\n          </DialogFooter>\n        </DialogContent>\n      </Dialog>\n    </>\n  )\n}\n"]}
+{"version":3,"file":"asset-detail.js","sourceRoot":"","sources":["../../../src/components/assets/asset-detail.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAEhG,OAAO,EACL,MAAM,EACN,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,EACL,OAAO,EACP,KAAK,EACL,SAAS,EACT,WAAW,EACX,GAAG,EACH,MAAM,EACN,KAAK,EACL,IAAI,GACL,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,SAAS,EAAE,OAAO,EAA0C;IACxF,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;IACzB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAA;IAEhC,MAAM,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IAC7E,gBAAgB,CACd,OAAO,CAAC,GAAG,EAAE;QACX,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAA;QAC1D,OAAO;YACL,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE;YACpG,EAAE,KAAK,EAAE,KAAK,EAAE;SACjB,CAAA;IACH,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CACnE,CAAA;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CACL,KAAC,KAAK,IAAC,SAAS,EAAC,+BAA+B,EAAC,KAAK,EAAC,QAAQ,EAAC,OAAO,EAAC,QAAQ,YAC9E,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,gBAAgB,CAAC,GACvB,GACD,CACT,CAAA;QACH,CAAC;QACD,OAAO,CACL,cAAK,SAAS,EAAC,oCAAoC,YACjD,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,EAAC,KAAK,EAAC,QAAQ,EAAC,SAAS,EAAC,aAAa,aACnD,KAAC,OAAO,IAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAC,IAAI,YACzB,SAAS,CAAC,0BAA0B,CAAC,GAC9B,EACT,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAC/B,KAAC,IAAI,IACH,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAC9C,SAAS,EAAC,sCAAsC,YAE/C,SAAS,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,GAC1D,CACR,CAAC,CAAC,CAAC,IAAI,IACF,GACJ,CACP,CAAA;IACH,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,+DAA+D;IAC/D,OAAO,KAAC,eAAe,IAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,GAAI,CAAA;AAC7F,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,SAAS,EACT,MAAM,EACN,UAAU,GAKX;IACC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAE7E,+EAA+E;IAC/E,2EAA2E;IAC3E,8EAA8E;IAC9E,gCAAgC;IAChC,mFAAmF;IACnF,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA0B,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACtF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAC/D,sFAAsF;IACtF,kEAAkE;IAClE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE/C,SAAS,UAAU,CAAC,KAAkB;QACpC,mFAAmF;QACnF,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7B,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAC1B,QAAQ,CAAC,KAAK,CAAC,CAAA;QACf,WAAW,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc;QAC5C,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,SAAS,CAAC,IAAI,CAAC,CAAA;QACf,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/E,SAAS,CAAC,KAAK,CAAC,CAAA;QAChB,IAAI,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;;YACzB,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,SAAS,WAAW,CAAC,KAAwB;QAC3C,QAAQ,CAAC,KAAK,IAAI,SAAS,CAAC,CAAA;QAC5B,KAAK,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,OAAO,CACL,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,EAAC,SAAS,EAAC,oCAAoC,aAC3D,KAAC,iBAAiB,IAChB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EACL,KAAC,iBAAiB,IAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,EACf,YAAY,EAAE,SAAS,CAAC,4BAA4B,CAAC,EACrD,UAAU,EAAE,UAAU,GACtB,GAEJ,EAEF,MAAC,KAAK,eACJ,KAAC,WAAW,cACV,MAAC,GAAG,IAAC,KAAK,EAAC,QAAQ,EAAC,SAAS,EAAC,QAAQ,aACpC,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,OAAO,YAC3C,SAAS,CAAC,sBAAsB,CAAC,GAC7B,EACP,KAAC,MAAM,KAAG,EACT,KAAK,CAAC,CAAC,CAAC,CACP,MAAC,MAAM,IAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,aAChE,KAAC,SAAS,KAAG,OAAE,SAAS,CAAC,yBAAyB,CAAC,IAC5C,CACV,CAAC,CAAC,CAAC,IAAI,IACJ,GACM,EACd,KAAC,SAAS,cACR,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,KAAC,gBAAgB,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,GAAI,EAC7F,QAAQ,CAAC,CAAC,CAAC,CACV,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,aAAa,iBAAa,4BAA4B,YAC7E,SAAS,CAAC,8BAA8B,CAAC,GACrC,CACR,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,YAC1B,SAAS,CAAC,0BAA0B,CAAC,GACjC,EACP,KAAC,iBAAiB,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAI,IAC7C,GACE,IACN,EAER,MAAC,KAAK,mBAAa,mBAAmB,aACpC,KAAC,WAAW,cACV,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,UAAU,EAAC,IAAI,EAAC,OAAO,YAC3C,SAAS,CAAC,+BAA+B,CAAC,GACtC,GACK,EACd,KAAC,SAAS,cACR,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACX,UAAU,CAAC,GAAG,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAC/B,KAAC,KAAK,IAEJ,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,SAAS,YAEtD,KAAC,YAAY,IACX,EAAE,EAAE,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAC5B,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EACnB,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GACpC,IAVG,CAAC,CAAC,IAAI,CAWL,CACT,CAAC,EACD,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACzB,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,YAC1B,SAAS,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,GACrE,CACR,CAAC,CAAC,CAAC,IAAI,EACP,SAAS,CAAC,CAAC,CAAC,CACX,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,kBAAkB,iBAAa,yBAAyB,YAC/E,SAAS,GACL,CACR,CAAC,CAAC,CAAC,IAAI,EACP,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CACvB,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,aACV,KAAC,MAAM,KAAG,EACV,KAAC,MAAM,IACL,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAC1B,QAAQ,EAAE,CAAC,KAAK,IAAI,MAAM,iBACd,mBAAmB,YAE9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,GACxD,IACL,CACP,CAAC,CAAC,CAAC,IAAI,IACF,GACE,IACN,IACF,CACT,CAAA;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,MAAM,EACN,OAAO,GAKR;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACtF,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjG,OAAO,CACL,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,mBAC7B,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,EAAC,SAAS,EAAC,gBAAgB,aACvC,KAAC,OAAO,IAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,UAAU,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,YACrF,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,GACxB,EACT,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACd,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,UAAU,YAC9C,MAAM,CAAC,QAAQ,GACX,CACR,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,YAC1B,IAAI,GACA,IACD,EACR,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,EAAC,IAAI,mBACd,OAAO,EACR,KAAC,qBAAqB,IAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAI,EAC/D,KAAC,iBAAiB,IAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAI,IACvD,IACF,CACP,CAAA;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAA8C;IAC9F,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvC,OAAO,CACL,8BACE,MAAC,MAAM,IACL,OAAO,EAAC,SAAS,EACjB,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,iBAChB,yBAAyB,aAErC,KAAC,KAAK,KAAG,OAAE,SAAS,CAAC,+BAA+B,CAAC,IAC9C,EACT,KAAC,MAAM,IAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,YACvC,MAAC,aAAa,IAAC,SAAS,EAAC,UAAU,aACjC,MAAC,YAAY,eACX,KAAC,WAAW,cACT,SAAS,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,GACpE,EACd,KAAC,iBAAiB,cAAE,SAAS,CAAC,+BAA+B,CAAC,GAAqB,IACtE,EACd,IAAI,CAAC,CAAC,CAAC,CACN,KAAC,eAAe,IAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAI,CACpF,CAAC,CAAC,CAAC,IAAI,IACM,GACT,IACR,CACJ,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,EAA8C;IAC1F,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;IACzB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAA;IACvE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IACvD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEvC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAA;QACb,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,SAAS,CAAC,IAAI,CAAC,CAAA;QACf,IAAI,CAAC;YACH,SAAS,CAAC,MAAM,8BAA8B,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAClE,CAAC;IACH,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,OAAO,CAAC,IAAI,CAAC,CAAA;QACb,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,6EAA6E;QAC7E,wEAAwE;QACxE,sEAAsE;QACtE,kEAAkE;QAClE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;QACpE,OAAO,CAAC,KAAK,CAAC,CAAA;QACd,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,CAAA;YACd,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,KAAK,QAAQ,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;YAC7F,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACxC,QAAQ,CACN,SAAS,CACP,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,+BAA+B,EACzF,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAC7B,CACF,CAAA;QACH,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAChE,MAAM,UAAU,GAAG,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAA;IAC7C,OAAO,CACL,8BACE,MAAC,MAAM,IACL,OAAO,EAAC,SAAS,EACjB,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,UAAU,EAAE,iBACpB,qBAAqB,aAEjC,KAAC,MAAM,KAAG,OAAE,SAAS,CAAC,eAAe,CAAC,IAC/B,EACT,KAAC,MAAM,IAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,YACvC,MAAC,aAAa,IAAC,SAAS,EAAC,uCAAuC,aAC9D,MAAC,YAAY,eACX,KAAC,WAAW,cAAE,SAAS,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAe,EAC5F,KAAC,iBAAiB,cAAE,SAAS,CAAC,2BAA2B,CAAC,GAAqB,IAClE,EACd,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CACnC,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,wBAAwB,CAAC,GAC/B,CACR,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CACnB,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,iBAAa,qBAAqB,aAC9C,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,aACV,KAAC,aAAa,IAAC,SAAS,EAAC,qBAAqB,GAAG,EACjD,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,UAAU,YAC9B,SAAS,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,2BAA2B,EAAE;gDACrF,KAAK,EAAE,UAAU;6CAClB,CAAC,GACG,IACH,EACN,KAAC,mBAAmB,IAClB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAO,CAAC,MAAM,EACtB,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAChC,EACF,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,6BAA6B,CAAC,GACpC,IACD,CACT,CAAC,CAAC,CAAC,CACF,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,4BAA4B,CAAC,GACnC,CACR,EACA,KAAK,CAAC,CAAC,CAAC,CACP,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,kBAAkB,iBAAa,oBAAoB,YAC1E,KAAK,GACD,CACR,CAAC,CAAC,CAAC,IAAI,EACR,MAAC,YAAY,eACX,KAAC,MAAM,IAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,YAC5E,SAAS,CAAC,eAAe,CAAC,GACpB,EACT,KAAC,MAAM,IACL,OAAO,EAAC,aAAa,EACrB,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,EAC7B,QAAQ,EAAE,IAAI,IAAI,MAAM,KAAK,IAAI,iBACrB,sBAAsB,YAEjC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,GAChF,IACI,IACD,GACT,IACR,CACJ,CAAA;AACH,CAAC","sourcesContent":["import { useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { AlertTriangle, Link2, RotateCcw, Trash2 } from 'lucide-react'\nimport type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport { Link, STUDIO_PROJECT_ROUTE, useNavigate } from '@elytracms/studio/router'\nimport { localizedLabel, translate } from '../../lib/i18n'\nimport { buildAssetReferenceImpact, loadInboundAssetReferenceViews } from '../../lib/references'\nimport type { ReferenceEntryView } from '../../lib/references'\nimport {\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Field,\n  Heading,\n  Panel,\n  PanelBody,\n  PanelHeader,\n  Row,\n  Spacer,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { FieldControl } from '../cms/field-control'\nimport { fieldLabel } from '../cms/cms-labels'\nimport { ReferenceImpactRows } from '../cms/reference-confirm'\nimport { ReferencesPanel } from '../references/references-panel'\nimport { useSetBreadcrumb } from '../breadcrumb-context'\nimport { useCollectionView } from '../collection-view/collection-view-context'\nimport { FocalCropPreviews, FocalPointPicker, useAssetRecord } from './asset-thumb'\nimport type { FocalPoint } from './focal-point'\nimport { assetMetaFieldsOf, assetMetaSeed, formatBytes, pruneMeta } from './asset-metadata'\nimport { useAssets } from './assets-store'\nimport { ReplaceFileButton } from './replace-file'\n\n/**\n * The assets rail's DETAIL surface (EC-319). Pragmatic call: assets don't fit\n * the portable `PortableDetailEditor` shell cleanly — there's no dirty/Save/\n * Publish document model here (an asset record isn't a `cmsDocument`), and the\n * focal-point picker is a bespoke drag interaction over the image, not a\n * scalar field value a generic form row can host without contortions. So this\n * is a bespoke surface (mirrors the CMS document editor's shape: a header +\n * panels), reached via the SAME rail-owned `detailPath`/`listPath` seam every\n * other rail uses (AD-19) — only the body differs.\n *\n * Unifies what were two divergent asset-edit UIs before this task: the plain\n * alt/title dialog on the old asset library card, and the richer schema-driven\n * + focal-point \"image options\" dialog opened from an `asset` field elsewhere\n * (`field-control.tsx`). This page reuses the LATTER (richer) content, so\n * editing an asset here is never a downgrade from editing it via a field.\n *\n * Deletion keeps the EC-202 reference-index safe-delete path (`assets-store.tsx`\n * → `deleteAsset`, keyed on `{ type: 'asset' }`). Since EC-433 the universal\n * table's row/bulk delete runs the SAME asset-shaped reference check (the\n * source's `referenceTarget`) and the same confirmed store delete — the two\n * surfaces share one delete semantics, not two divergent ones.\n */\nexport function AssetDetail({ projectId, assetId }: { projectId: string; assetId: string }) {\n  const source = useCollectionView()\n  const store = useAssets()\n  const record = useAssetRecord(assetId)\n  const collection = source.schema\n\n  const collectionLabel = localizedLabel(collection.form?.label, collection.id)\n  useSetBreadcrumb(\n    useMemo(() => {\n      if (source.listPath === undefined) return [{ label: collectionLabel }]\n      const title = record?.title ?? record?.filename ?? assetId\n      return [\n        { label: collectionLabel, to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: source.listPath } },\n        { label: title },\n      ]\n    }, [collectionLabel, source.listPath, record, projectId, assetId]),\n  )\n\n  if (record === undefined) {\n    if (store.status === 'loading') {\n      return (\n        <Stack className=\"h-full place-items-center p-8\" align=\"center\" justify=\"center\">\n          <Text size=\"sm\" tone=\"muted\">\n            {translate('assets.loading')}\n          </Text>\n        </Stack>\n      )\n    }\n    return (\n      <div className=\"grid h-full place-items-center p-8\">\n        <Stack gap=\"3\" align=\"center\" className=\"text-center\">\n          <Heading level={2} size=\"h2\">\n            {translate('cms.editor.notFoundTitle')}\n          </Heading>\n          {source.listPath !== undefined ? (\n            <Link\n              to={STUDIO_PROJECT_ROUTE}\n              params={{ projectId, _splat: source.listPath }}\n              className=\"text-sm text-primary hover:underline\"\n            >\n              {translate('cms.editor.backToList', { label: collectionLabel })}\n            </Link>\n          ) : null}\n        </Stack>\n      </div>\n    )\n  }\n\n  // Remount per asset (the surface's own key, set by the caller) resets every\n  // local buffer below cleanly when navigating from one asset's detail to\n  // another — no stale-state carryover to guard against by hand.\n  return <AssetDetailBody projectId={projectId} record={record} collection={source.schema} />\n}\n\nfunction AssetDetailBody({\n  projectId,\n  record,\n  collection,\n}: {\n  projectId: string\n  record: AssetRecord\n  collection: CollectionDef\n}) {\n  const store = useAssets()\n  const metaFields = useMemo(() => assetMetaFieldsOf(collection), [collection])\n\n  // Metadata buffers locally and commits explicitly (Save) — an asset record has\n  // no dirty/Save document model of its own to piggyback on. The focal point\n  // commits immediately (it drives a live visual), matching the field's options\n  // dialog (`field-control.tsx`).\n  // EC-587: the bag the editor starts from has a legacy `alt` column lifted in, so a\n  // not-yet-migrated asset shows its alt and the save moves it to `meta.alt`.\n  const [meta, setMeta] = useState<Record<string, unknown>>(() => assetMetaSeed(record))\n  const [focal, setFocal] = useState<FocalPoint | undefined>(record.focalPoint)\n  const [dirty, setDirty] = useState(false)\n  const [saving, setSaving] = useState(false)\n  const [saveError, setSaveError] = useState<string | null>(null)\n  // EC-568: after a file replace the focal point is KEPT (the ticket's recommendation),\n  // but it was chosen on the old pixels — say so beside the picker.\n  const [replaced, setReplaced] = useState(false)\n\n  function onReplaced(asset: AssetRecord) {\n    // The new file may have brought metadata: start the buffer from the stored record.\n    setMeta(assetMetaSeed(asset))\n    setFocal(asset.focalPoint)\n    setDirty(false)\n    setReplaced(true)\n  }\n\n  function setField(name: string, value: unknown) {\n    setDirty(true)\n    setMeta((m) => ({ ...m, [name]: value }))\n  }\n\n  async function save() {\n    setSaving(true)\n    setSaveError(null)\n    const result = await store.updateMetadata(record.id, { meta: pruneMeta(meta) })\n    setSaving(false)\n    if (result.ok) setDirty(false)\n    else setSaveError(result.message)\n  }\n\n  function commitFocal(point: FocalPoint | null) {\n    setFocal(point ?? undefined)\n    void store.updateMetadata(record.id, { focalPoint: point })\n  }\n\n  return (\n    <Stack gap=\"4\" className=\"mx-auto max-w-3xl p-4 pb-10 sm:p-6\">\n      <AssetDetailHeader\n        projectId={projectId}\n        record={record}\n        replace={\n          <ReplaceFileButton\n            record={record}\n            disabled={dirty}\n            disabledHint={translate('cms.asset.replaceSaveFirst')}\n            onReplaced={onReplaced}\n          />\n        }\n      />\n\n      <Panel>\n        <PanelHeader>\n          <Row align=\"center\" className=\"w-full\">\n            <Text size=\"xs\" weight=\"semibold\" tone=\"muted\">\n              {translate('cms.asset.focalPoint')}\n            </Text>\n            <Spacer />\n            {focal ? (\n              <Button variant=\"ghost\" size=\"sm\" onClick={() => commitFocal(null)}>\n                <RotateCcw /> {translate('cms.asset.resetToCentre')}\n              </Button>\n            ) : null}\n          </Row>\n        </PanelHeader>\n        <PanelBody>\n          <Stack gap=\"2\">\n            <FocalPointPicker record={record} point={focal} onChange={commitFocal} onPreview={setFocal} />\n            {replaced ? (\n              <Text size=\"xs\" className=\"font-medium\" data-testid=\"asset-replaced-check-focal\">\n                {translate('cms.asset.replacedCheckFocal')}\n              </Text>\n            ) : null}\n            <Text size=\"xs\" tone=\"subtle\">\n              {translate('cms.asset.focalPointHint')}\n            </Text>\n            <FocalCropPreviews record={record} point={focal} />\n          </Stack>\n        </PanelBody>\n      </Panel>\n\n      <Panel data-testid=\"asset-detail-meta\">\n        <PanelHeader>\n          <Text size=\"xs\" weight=\"semibold\" tone=\"muted\">\n            {translate('assets.detail.metadataHeading')}\n          </Text>\n        </PanelHeader>\n        <PanelBody>\n          <Stack gap=\"3\">\n            {metaFields.map((f: FieldDef) => (\n              <Field\n                key={f.name}\n                label={fieldLabel(f)}\n                hint={localizedLabel(f.form?.description) || undefined}\n              >\n                <FieldControl\n                  id={`asset-detail-${f.name}`}\n                  field={f}\n                  value={meta[f.name]}\n                  readOnly={false}\n                  onChange={(v) => setField(f.name, v)}\n                />\n              </Field>\n            ))}\n            {metaFields.length === 0 ? (\n              <Text size=\"sm\" tone=\"subtle\">\n                {translate('cms.asset.noMetaFields', { code1: 'alt', code2: 'copyright' })}\n              </Text>\n            ) : null}\n            {saveError ? (\n              <Text size=\"sm\" className=\"text-destructive\" data-testid=\"asset-detail-save-error\">\n                {saveError}\n              </Text>\n            ) : null}\n            {metaFields.length > 0 ? (\n              <Row gap=\"2\">\n                <Spacer />\n                <Button\n                  size=\"sm\"\n                  onClick={() => void save()}\n                  disabled={!dirty || saving}\n                  data-testid=\"asset-detail-save\"\n                >\n                  {saving ? translate('common.saving') : translate('common.save')}\n                </Button>\n              </Row>\n            ) : null}\n          </Stack>\n        </PanelBody>\n      </Panel>\n    </Stack>\n  )\n}\n\n/** Filename/title heading + system info (content type, dimensions, size) + actions. */\nfunction AssetDetailHeader({\n  projectId,\n  record,\n  replace,\n}: {\n  projectId: string\n  record: AssetRecord\n  replace?: ReactNode\n}) {\n  const dims = record.width && record.height ? `${record.width}×${record.height}` : null\n  const info = [record.contentType, dims, formatBytes(record.byteSize)].filter(Boolean).join(' · ')\n  return (\n    <Row gap=\"3\" align=\"start\" wrap>\n      <Stack gap=\"1\" className=\"min-w-0 flex-1\">\n        <Heading level={2} size=\"h2\" className=\"truncate\" title={record.title ?? record.filename}>\n          {record.title ?? record.filename}\n        </Heading>\n        {record.title ? (\n          <Text size=\"sm\" tone=\"muted\" className=\"truncate\">\n            {record.filename}\n          </Text>\n        ) : null}\n        <Text size=\"xs\" tone=\"subtle\">\n          {info}\n        </Text>\n      </Stack>\n      <Row gap=\"2\" wrap>\n        {replace}\n        <AssetReferencesButton projectId={projectId} record={record} />\n        <AssetDeleteButton projectId={projectId} record={record} />\n      </Row>\n    </Row>\n  )\n}\n\n/** \"Where is this asset used?\" (EC-172): the shared references panel, EC-155-backed. */\nfunction AssetReferencesButton({ projectId, record }: { projectId: string; record: AssetRecord }) {\n  const [open, setOpen] = useState(false)\n  return (\n    <>\n      <Button\n        variant=\"outline\"\n        size=\"sm\"\n        onClick={() => setOpen(true)}\n        data-testid=\"asset-detail-references\"\n      >\n        <Link2 /> {translate('assets.references.buttonLabel')}\n      </Button>\n      <Dialog open={open} onOpenChange={setOpen}>\n        <DialogContent className=\"max-w-lg\">\n          <DialogHeader>\n            <DialogTitle>\n              {translate('assets.references.title', { name: record.title ?? record.filename })}\n            </DialogTitle>\n            <DialogDescription>{translate('assets.references.description')}</DialogDescription>\n          </DialogHeader>\n          {open ? (\n            <ReferencesPanel projectId={projectId} target={{ type: 'asset', id: record.id }} />\n          ) : null}\n        </DialogContent>\n      </Dialog>\n    </>\n  )\n}\n\n/**\n * Reference-respecting delete (EC-151, EC-202): enumerates the exact inbound\n * references — index-accurate, with deep links to the field/node — before\n * removing. Deleting a referenced asset is weak-by-default (allowed with an\n * explicit \"delete anyway\"); every reference dangles into a visible validation\n * issue rather than silently breaking. On success, returns to the list.\n */\nfunction AssetDeleteButton({ projectId, record }: { projectId: string; record: AssetRecord }) {\n  const source = useCollectionView()\n  const store = useAssets()\n  const navigate = useNavigate()\n  const [open, setOpen] = useState(false)\n  const [usages, setUsages] = useState<ReferenceEntryView[] | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n\n  const openDialog = async () => {\n    setOpen(true)\n    setError(null)\n    setUsages(null)\n    try {\n      setUsages(await loadInboundAssetReferenceViews(projectId, record.id))\n    } catch (cause) {\n      setError(cause instanceof Error ? cause.message : String(cause))\n    }\n  }\n\n  const confirm = async () => {\n    setBusy(true)\n    setError(null)\n    // The dialog has already enumerated usages (or shown there are none) and the\n    // user is confirming either way — confirm unconditionally, skipping the\n    // redundant inbound re-check (EC-301 perf). Weak-by-default: a still-\n    // referenced asset deletes anyway, dangling into a visible issue.\n    const result = await store.remove(record.id, { confirmInUse: true })\n    setBusy(false)\n    if (result.outcome === 'deleted' || result.outcome === 'not-found') {\n      setOpen(false)\n      if (source.listPath !== undefined) {\n        void navigate({ to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: source.listPath } })\n      }\n    } else if (result.outcome === 'blocked') {\n      setError(\n        translate(\n          result.usageCount === 1 ? 'assets.delete.raceError.one' : 'assets.delete.raceError.other',\n          { count: result.usageCount },\n        ),\n      )\n    } else {\n      setError(result.message)\n    }\n  }\n\n  const impact = usages ? buildAssetReferenceImpact(usages) : null\n  const usageCount = impact?.broken.length ?? 0\n  return (\n    <>\n      <Button\n        variant=\"outline\"\n        size=\"sm\"\n        onClick={() => void openDialog()}\n        data-testid=\"asset-detail-delete\"\n      >\n        <Trash2 /> {translate('common.delete')}\n      </Button>\n      <Dialog open={open} onOpenChange={setOpen}>\n        <DialogContent className=\"max-h-[80vh] max-w-md overflow-y-auto\">\n          <DialogHeader>\n            <DialogTitle>{translate('assets.delete.title', { filename: record.filename })}</DialogTitle>\n            <DialogDescription>{translate('assets.delete.description')}</DialogDescription>\n          </DialogHeader>\n          {usages === null && error === null ? (\n            <Text size=\"sm\" tone=\"muted\">\n              {translate('assets.delete.checking')}\n            </Text>\n          ) : usageCount > 0 ? (\n            <Stack gap=\"2\" data-testid=\"asset-usage-warning\">\n              <Row gap=\"2\">\n                <AlertTriangle className=\"size-4 text-warning\" />\n                <Text size=\"sm\" weight=\"semibold\">\n                  {translate(usageCount === 1 ? 'assets.delete.inUse.one' : 'assets.delete.inUse.other', {\n                    count: usageCount,\n                  })}\n                </Text>\n              </Row>\n              <ReferenceImpactRows\n                projectId={projectId}\n                broken={impact!.broken}\n                onNavigate={() => setOpen(false)}\n              />\n              <Text size=\"xs\" tone=\"muted\">\n                {translate('assets.delete.brokenWarning')}\n              </Text>\n            </Stack>\n          ) : (\n            <Text size=\"sm\" tone=\"muted\">\n              {translate('assets.delete.noReferences')}\n            </Text>\n          )}\n          {error ? (\n            <Text size=\"sm\" className=\"text-destructive\" data-testid=\"asset-delete-error\">\n              {error}\n            </Text>\n          ) : null}\n          <DialogFooter>\n            <Button variant=\"ghost\" size=\"sm\" onClick={() => setOpen(false)} disabled={busy}>\n              {translate('common.cancel')}\n            </Button>\n            <Button\n              variant=\"destructive\"\n              size=\"sm\"\n              onClick={() => void confirm()}\n              disabled={busy || usages === null}\n              data-testid=\"asset-delete-confirm\"\n            >\n              {usageCount > 0 ? translate('assets.delete.confirmAnyway') : translate('common.delete')}\n            </Button>\n          </DialogFooter>\n        </DialogContent>\n      </Dialog>\n    </>\n  )\n}\n"]}

package/dist/components/assets/asset-grid.js

@@ -2,8 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo } from 'react';
 import { Image as ImageIcon } from 'lucide-react';
 import { Link, STUDIO_PROJECT_ROUTE } from '@elytracms/studio/router';
-import { applyViewState } from '@elytracms/studio/lib/cms-views';
-import { localizedLabel, translate } from '@elytracms/studio/lib/i18n';
+import { applyViewState } from '../../lib/cms-views/index.js';
+import { localizedLabel, translate } from '../../lib/i18n/index.js';
 import { Code, Grid, Panel, Row, Separator, Spacer, Stack, Text } from '@elytracms/studio/ui';
 import { FilterControl } from '../cms/filter-builder.js';
 import { ViewTabs } from '../cms/view-bar.js';