@odla-ai/chapter 0.21.0 → 0.22.0

package/dist/{types-CXDiDj_s.d.ts → types-CgWUQ2MH.d.ts}

@@ -50,8 +50,22 @@ interface ChapterBrandTokens {
     danger?: string;
     chart1?: string;
     chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
     chartPositive?: string;
     chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
 }
 /** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
 interface ChapterBrand {

package/dist/ui/admin/index.d.ts

@@ -1,8 +1,37 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { CrmClient, Crm, CrmRecord } from '@odla-ai/crm';
-import { C as Chapter } from '../../types-CXDiDj_s.js';
-import { RecordPanelTab, CrmWorkspaceRecordContext } from '@odla-ai/crm/ui';
+import { C as Chapter } from '../../types-CgWUQ2MH.js';
+import { CrmLifecycleAdapter, CrmWorkspaceMasterContext, CrmWorkspaceRecordContext, RecordPanelTab } from '@odla-ai/crm/ui';
+
+/** Normalized public auth configuration consumed by the Clerk gate. */
+interface ChapterAdminAuthConfig {
+    publishableKey: string | null;
+}
+/** Normalized current-user data retained for workspace visibility decisions. */
+interface ChapterAdminUser extends Record<string, unknown> {
+    authorized?: boolean;
+    email?: string | null;
+}
+/** Inputs supplied to custom admin configuration and current-user loaders. */
+interface ChapterAdminAuthLoadContext {
+    apiBase: string;
+    getToken?: () => Promise<string | null>;
+}
+/** Existing-site adapter for auth endpoint names and response shapes. */
+interface ChapterAdminAuthAdapter {
+    configPath?: string;
+    currentUserPath?: string;
+    loadConfig?: (context: ChapterAdminAuthLoadContext) => Promise<ChapterAdminAuthConfig>;
+    loadCurrentUser?: (context: Required<ChapterAdminAuthLoadContext>) => Promise<ChapterAdminUser>;
+    mapConfig?: (body: Record<string, unknown>) => ChapterAdminAuthConfig;
+    mapCurrentUser?: (body: Record<string, unknown>) => ChapterAdminUser;
+    isAuthorized?: (user: ChapterAdminUser) => boolean;
+}
+/** Load and normalize the public authentication configuration. */
+declare function loadChapterAdminConfig(adapter: ChapterAdminAuthAdapter, apiBase: string): Promise<ChapterAdminAuthConfig>;
+/** Load and normalize the authenticated user used by admin workspaces. */
+declare function loadChapterAdminUser(adapter: ChapterAdminAuthAdapter, apiBase: string, getToken: () => Promise<string | null>): Promise<ChapterAdminUser>;
 
 type Brand = {
     name: string;
@@ -40,6 +69,7 @@ type AdminRouteTarget = string | {
 interface AdminSectionContext {
     client: CrmClient;
     getToken: () => Promise<string | null>;
+    currentUser?: Record<string, unknown>;
     route: AdminRouteState;
     navigate: (target: AdminRouteTarget) => void;
     href: (target: AdminRouteTarget) => string;
@@ -48,12 +78,28 @@ interface AdminSectionContext {
 interface AdminWorkspace {
     id: string;
     label: string;
+    /** Canonical nested view used when a workspace is opened without one. */
+    defaultViewId?: string;
     render: (ctx: AdminSectionContext) => ReactNode;
 }
 /** Legacy name for a top-level workspace. @deprecated Use AdminWorkspace. */
 type AdminSection = AdminWorkspace;
-/** Built-in shell presentation: editorial, legacy top bar, or host-owned. */
-type AdminChrome = "editorial" | "topbar" | "none";
+/** Built-in shell presentation; embedded preserves site-owned chrome. */
+type AdminChrome = "embedded" | "standalone" | "editorial" | "topbar" | "none";
+/** Identity and sign-out services supplied to host-owned account controls. */
+interface AdminAccountMenuProps {
+    brand: Brand;
+    email: string | null;
+    currentUser?: Record<string, unknown>;
+    signOut: () => void;
+}
+/** Workspace route and navigation services supplied to host-owned navigation. */
+interface AdminWorkspaceNavProps {
+    workspaces: readonly AdminWorkspace[];
+    route: AdminRouteState;
+    navigate: (target: AdminRouteTarget) => void;
+    href: (target: AdminRouteTarget) => string;
+}
 interface AdminShellProps {
     workspaces: AdminWorkspace[];
     basePath: string;
@@ -62,13 +108,12 @@ interface AdminShellProps {
     getToken: () => Promise<string | null>;
     signOut: () => void;
     email: string | null;
+    currentUser?: Record<string, unknown>;
     routing?: AdminRouting;
     chrome?: AdminChrome;
-    renderHeader?: (props: {
-        brand: Brand;
-        email: string | null;
-        signOut: () => void;
-    }) => ReactNode;
+    renderHeader?: (props: AdminAccountMenuProps) => ReactNode;
+    renderAccountMenu?: (props: AdminAccountMenuProps) => ReactNode;
+    renderWorkspaceNav?: (props: AdminWorkspaceNavProps) => ReactNode;
 }
 
 /** Configuration for the Clerk-gated, brand-scoped Chapter admin console. */
@@ -84,9 +129,13 @@ interface ChapterAdminProps {
     apiBase?: string;
     /** Default fragment: `/admin/#people/person/record-id/profile`. */
     routing?: AdminRouting;
-    /** Default editorial. Topbar retains the legacy global-nav shell. */
+    /** Default embedded. Standalone adds packaged global chrome. */
     chrome?: AdminChrome;
     renderHeader?: AdminShellProps["renderHeader"];
+    renderAccountMenu?: (props: AdminAccountMenuProps) => ReactNode;
+    renderWorkspaceNav?: (props: AdminWorkspaceNavProps) => ReactNode;
+    /** Adapt existing config/current-user endpoints without rewriting auth. */
+    auth?: ChapterAdminAuthAdapter;
 }
 /** Render the complete authenticated admin application from one Chapter config. */
 declare function ChapterAdmin(props: ChapterAdminProps): react.JSX.Element;
@@ -97,6 +146,9 @@ declare function defaultAdminWorkspaces(chapter: Chapter): AdminWorkspace[];
 /** Legacy default catalog. @deprecated Use defaultAdminWorkspaces. */
 declare function defaultAdminSections(chapter: Chapter): AdminSection[];
 
+/** Application-authoritative stage transitions used by Chapter collections. */
+declare function applicationLifecycleAdapter(ctx: Pick<AdminSectionContext, "getToken">): CrmLifecycleAdapter;
+
 /** Configuration for the person-collection compatibility preset. */
 interface PeopleSectionOptions {
     crm: Crm;
@@ -113,6 +165,13 @@ interface CollectionSectionOptions {
     lifecycle?: boolean;
     roles?: readonly string[];
     networkSharing?: boolean;
+    lifecycleAdapter?: (CrmLifecycleAdapter | ((ctx: AdminSectionContext) => CrmLifecycleAdapter));
+    requireLifecycleAdapter?: boolean;
+    renderSummary?: (context: CrmWorkspaceMasterContext, ctx: AdminSectionContext) => ReactNode;
+    renderMaster?: (context: CrmWorkspaceMasterContext, ctx: AdminSectionContext) => ReactNode;
+    renderDetailHeader?: (context: CrmWorkspaceRecordContext, ctx: AdminSectionContext) => ReactNode;
+    renderEmptyDetail?: (context: CrmWorkspaceMasterContext, ctx: AdminSectionContext) => ReactNode;
+    hrefForRecord?: (record: CrmRecord, ctx: AdminSectionContext) => string;
     extendRecordTabs?: (tabs: readonly RecordPanelTab[], context: CrmWorkspaceRecordContext) => readonly RecordPanelTab[];
 }
 /** Build one CRM collection as an admin workspace. */
@@ -121,6 +180,13 @@ declare function collectionSection(options: CollectionSectionOptions): AdminSect
 declare function peopleSection(options: PeopleSectionOptions & {
     roles?: readonly string[];
     networkSharing?: boolean;
+    lifecycleAdapter?: CollectionSectionOptions["lifecycleAdapter"];
+    requireLifecycleAdapter?: boolean;
+    renderSummary?: CollectionSectionOptions["renderSummary"];
+    renderMaster?: CollectionSectionOptions["renderMaster"];
+    renderDetailHeader?: CollectionSectionOptions["renderDetailHeader"];
+    renderEmptyDetail?: CollectionSectionOptions["renderEmptyDetail"];
+    hrefForRecord?: CollectionSectionOptions["hrefForRecord"];
     extendRecordTabs?: CollectionSectionOptions["extendRecordTabs"];
 }): AdminSection;
 
@@ -223,4 +289,4 @@ declare function AdminNote({ children }: {
     children: ReactNode;
 }): react.JSX.Element;
 
-export { type AdminChrome, AdminNote, AdminPage, type AdminResource, type AdminRouteState, type AdminRouteTarget, type AdminRouting, type AdminSection, type AdminSectionContext, type AdminWorkspace, type AvailabilitySectionOptions, type BillingSectionOptions, ChapterAdmin, type ChapterAdminProps, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, type MeetingsSectionOptions, NetworkShareActions, type NetworkShareActionsProps, Panel, type PeopleSectionOptions, RecordActions, type RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, meetingsSection, peopleSection, useAdminResource };
+export { type AdminAccountMenuProps, type AdminChrome, AdminNote, AdminPage, type AdminResource, type AdminRouteState, type AdminRouteTarget, type AdminRouting, type AdminSection, type AdminSectionContext, type AdminWorkspace, type AdminWorkspaceNavProps, type AvailabilitySectionOptions, type BillingSectionOptions, ChapterAdmin, type ChapterAdminAuthAdapter, type ChapterAdminAuthConfig, type ChapterAdminAuthLoadContext, type ChapterAdminProps, type ChapterAdminUser, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, type MeetingsSectionOptions, NetworkShareActions, type NetworkShareActionsProps, Panel, type PeopleSectionOptions, RecordActions, type RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, peopleSection, useAdminResource };

package/dist/ui/admin/index.js

@@ -11,6 +11,7 @@ import {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
   collectionSection,
@@ -18,11 +19,13 @@ import {
   defaultAdminSections,
   defaultAdminWorkspaces,
   emailSection,
+  loadChapterAdminConfig,
+  loadChapterAdminUser,
   meetingsSection,
   peopleSection,
   useAdminResource
-} from "../../chunk-AOTWFOH4.js";
-import "../../chunk-3JG5X2LT.js";
+} from "../../chunk-IWW5VAAC.js";
+import "../../chunk-VZPBTTO3.js";
 export {
   AdminNote,
   AdminPage,
@@ -36,6 +39,7 @@ export {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
   collectionSection,
@@ -43,6 +47,8 @@ export {
   defaultAdminSections,
   defaultAdminWorkspaces,
   emailSection,
+  loadChapterAdminConfig,
+  loadChapterAdminUser,
   meetingsSection,
   peopleSection,
   useAdminResource

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
-export { AdminChrome, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminProps, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, MeetingsSectionOptions, NetworkShareActions, NetworkShareActionsProps, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, meetingsSection, peopleSection, useAdminResource } from './admin/index.js';
+export { AdminAccountMenuProps, AdminChrome, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AdminWorkspaceNavProps, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminAuthAdapter, ChapterAdminAuthConfig, ChapterAdminAuthLoadContext, ChapterAdminProps, ChapterAdminUser, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, MeetingsSectionOptions, NetworkShareActions, NetworkShareActionsProps, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, peopleSection, useAdminResource } from './admin/index.js';
 export { ApiFn, BrandStyle, BrandStyleProps, JoinConfig, JoinIsland, JoinIslandProps, MembersArea, MembersAreaProps, PaymentStep, PaymentStepProps, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, timeLabel, tzShort } from './member/index.js';
 import 'react';
 import '@odla-ai/crm';
-import '../types-CXDiDj_s.js';
+import '../types-CgWUQ2MH.js';
 import '@odla-ai/crm/ui';

package/dist/ui/index.js

@@ -26,6 +26,7 @@ import {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
   collectionSection,
@@ -33,13 +34,15 @@ import {
   defaultAdminSections,
   defaultAdminWorkspaces,
   emailSection,
+  loadChapterAdminConfig,
+  loadChapterAdminUser,
   meetingsSection,
   peopleSection,
   useAdminResource
-} from "../chunk-AOTWFOH4.js";
+} from "../chunk-IWW5VAAC.js";
 import {
   BrandStyle
-} from "../chunk-3JG5X2LT.js";
+} from "../chunk-VZPBTTO3.js";
 export {
   AdminNote,
   AdminPage,
@@ -59,6 +62,7 @@ export {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
   collectionSection,
@@ -72,6 +76,8 @@ export {
   fmtMoney,
   fullLabel,
   groupSlotsByDay,
+  loadChapterAdminConfig,
+  loadChapterAdminUser,
   meetingsSection,
   peopleSection,
   timeLabel,

package/dist/ui/member/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { a as ChapterBrand } from '../../types-CXDiDj_s.js';
+import { a as ChapterBrand } from '../../types-CgWUQ2MH.js';
 import '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */

package/dist/ui/member/index.js

@@ -15,7 +15,7 @@ import {
 } from "../../chunk-ILGUJXSB.js";
 import {
   BrandStyle
-} from "../../chunk-3JG5X2LT.js";
+} from "../../chunk-VZPBTTO3.js";
 export {
   BrandStyle,
   JoinIsland,

package/dist/worker/index.d.cts

@@ -51,8 +51,22 @@ interface ChapterBrandTokens {
     danger?: string;
     chart1?: string;
     chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
     chartPositive?: string;
     chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
 }
 /** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
 interface ChapterBrand {

package/dist/worker/index.d.ts

@@ -51,8 +51,22 @@ interface ChapterBrandTokens {
     danger?: string;
     chart1?: string;
     chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
     chartPositive?: string;
     chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
 }
 /** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
 interface ChapterBrand {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odla-ai/chapter",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "A leader/follower foundation for branded membership sites: shared CRM, admin, auth, payments, booking, and explicit record delivery from one defineChapter config.",
   "license": "MIT",
   "homepage": "https://odla.ai/docs/packages/chapter",
@@ -70,13 +70,13 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@odla-ai/crm": "^0.2.0",
+    "@odla-ai/crm": "^0.3.0",
     "jose": "^6.2.3"
   },
   "peerDependencies": {
     "@odla-ai/calendar": ">=0.2.0 <1.0.0",
     "@odla-ai/db": ">=0.6.0 <1.0.0",
-    "@odla-ai/ui": ">=0.11.0 <1.0.0",
+    "@odla-ai/ui": ">=0.12.0 <1.0.0",
     "react": ">=18"
   },
   "peerDependenciesMeta": {

package/runbooks/adopt-existing.md

@@ -118,7 +118,7 @@ npx @odla-ai/cli@0.17.1 capabilities --json
 
 Pin the exact known-good package matrix from the installed Chapter README.
 For this runbook, first require
-`npm view @odla-ai/chapter@0.21.0 version` to succeed. Install every runtime,
+`npm view @odla-ai/chapter@0.22.0 version` to succeed. Install every runtime,
 toolchain, CLI, and security package with the exact versions in that README;
 never use `latest`, a range, or `--legacy-peer-deps`.
 
@@ -356,9 +356,18 @@ fixture. Compare markup/behavior and the Phase 0 screenshots before deletion.
 - Replace join orchestration with `JoinIsland`, member behavior with
   `MembersArea`, and admin with `<ChapterAdmin chapter={chapter}/>` only after
   field/auth/action parity.
-- Preserve the site's global header with `chrome="none"` or `renderHeader`.
-  Chapter mode defaults to Dashboard, People, and Settings; move former global
-  Billing, Calendar, Email, and per-record operations into nested tabs.
+- Preserve the site's global header with the default `chrome="embedded"`;
+  use `chrome="standalone"` only when Chapter should supply the masthead, or
+  `renderHeader` when the header belongs inside the Chapter scope. Chapter mode
+  defaults to Dashboard, People, and Settings; move former global Billing,
+  Calendar, Email, and per-record operations into nested tabs.
+- Preserve a distinctive People summary, rail, and record heading with
+  `collectionSection`'s `renderSummary`, `renderMaster`, and
+  `renderDetailHeader` slots. Replace specialized record tabs rather than
+  flattening them into global navigation.
+- Application-backed pipeline changes must use a lifecycle adapter that invokes
+  the authoritative application endpoints. Prove approve/refund/manual
+  transition side effects; a raw CRM `setStage` is not parity.
 - Accept old query/path admin links as inbound compatibility URLs, but generate
   canonical fragment links such as
   `/admin/#people/person/record-id/profile`. Prove refresh, back/forward, and

package/runbooks/greenfield.md

@@ -117,13 +117,13 @@ npx @odla-ai/cli@0.17.1 setup
 
 Verify every release target exists, then install the exact known-good React
 host matrix. Do not copy these commands into a pre-release branch where
-`@odla-ai/chapter@0.21.0` is not yet on npm.
+`@odla-ai/chapter@0.22.0` is not yet on npm.
 
 ```sh
-npm view @odla-ai/chapter@0.21.0 version
+npm view @odla-ai/chapter@0.22.0 version
 npm install --save-exact \
-  @odla-ai/chapter@0.21.0 @odla-ai/ui@0.11.0 \
-  @odla-ai/crm@0.2.0 @odla-ai/db@0.6.6 \
+  @odla-ai/chapter@0.22.0 @odla-ai/ui@0.12.0 \
+  @odla-ai/crm@0.3.0 @odla-ai/db@0.6.6 \
   @odla-ai/calendar@0.2.0 @odla-ai/email@0.3.1 \
   @odla-ai/auth-clerk@0.4.0 @odla-ai/o11y@2.2.2 \
   jose@6.2.3 react@19.2.7 react-dom@19.2.7

package/dist/chunk-3JG5X2LT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/brand.ts","../src/ui/brand-style.tsx"],"sourcesContent":["// Brand tokens (H4). defineChapter accepts a `brand` block; this turns it into a\n// `:root { --…: … }` CSS block, so a chapter re-skins the WHOLE UI — the\n// @odla-ai/ui components, the admin shell, and the member islands, which all read\n// --ui-* design tokens — from one config instead of hand-writing inline CSS.\n//\n// Pure string generation, so it is unit-testable and can be emitted at\n// build/SSR time into the page <head> (no flash of unstyled content), or via the\n// <BrandStyle> component from @odla-ai/chapter/ui.\nimport type { ChapterBrand, ChapterBrandTokens } from \"./types\";\n\n// A palette entry is either a direct custom property (already `--…`, e.g.\n// `--ui-accent` to retheme components) or a bare name we expose as `--<name>`\n// (e.g. `moss` → `--moss`, for a site to reference in its own CSS).\nfunction paletteVar(key: string): string {\n  return key.startsWith(\"--\") ? key : `--${key}`;\n}\n\n// Strip characters that could break out of a `--var: value;` declaration or the\n// surrounding <style>. Brand config is trusted author input, so this is a\n// belt-and-suspenders guard, not a security boundary.\nfunction cleanValue(value: string): string {\n  return value.replace(/[<>{};]/g, \"\").trim();\n}\n\nfunction paletteDecls(palette: Record<string, string> | undefined): string[] {\n  const decls: string[] = [];\n  for (const [key, value] of Object.entries(palette ?? {})) {\n    if (typeof value === \"string\" && value.trim()) decls.push(`${paletteVar(key)}: ${cleanValue(value)};`);\n  }\n  return decls;\n}\n\nconst TOKEN_VARS: Record<keyof ChapterBrandTokens, string> = {\n  background: \"--ui-bg\",\n  surface: \"--ui-surface\",\n  surface2: \"--ui-surface-2\",\n  text: \"--ui-text\",\n  textMuted: \"--ui-text-muted\",\n  textFaint: \"--ui-text-faint\",\n  border: \"--ui-border\",\n  borderStrong: \"--ui-border-strong\",\n  accent: \"--ui-accent\",\n  accentStrong: \"--ui-accent-strong\",\n  accentSoft: \"--ui-accent-soft\",\n  onAccent: \"--ui-on-accent\",\n  good: \"--ui-good\",\n  warn: \"--ui-warn\",\n  danger: \"--ui-danger\",\n  chart1: \"--ui-chart-1\",\n  chart2: \"--ui-chart-2\",\n  chartPositive: \"--ui-chart-pos\",\n  chartNegative: \"--ui-chart-neg\",\n};\n\nfunction semanticDecls(tokens: ChapterBrandTokens | undefined): string[] {\n  return Object.entries(tokens ?? {}).flatMap(([key, value]) =>\n    typeof value === \"string\" && value.trim()\n      ? [`${TOKEN_VARS[key as keyof ChapterBrandTokens]}: ${cleanValue(value)};`]\n      : [],\n  );\n}\n\n/**\n * Build the CSS that maps a chapter's brand onto the design tokens the UI reads:\n * each `palette` entry becomes a custom property (light, and dark unless\n * `paletteDark` overrides), and `fonts` (display/body/numeral) map to\n * `--ui-font-display` / `--ui-font-sans` / `--ui-font-numeral`. The dark block is\n * emitted under both `:root[data-theme=\"dark\"]` (the odla-ui theme toggle) and\n * `@media (prefers-color-scheme: dark)`. Returns \"\" when there is nothing to\n * theme. These are brand OVERRIDES on top of a base theme — they do not replace\n * the theme layer the components need (see {@link brandTokens} usage in the docs).\n */\nexport function brandTokens(\n  brand: ChapterBrand | undefined,\n  options: { selector?: string } = {},\n): string {\n  if (!brand) return \"\";\n  const light = [...paletteDecls(brand.palette), ...semanticDecls(brand.tokens)];\n  const fonts = brand.fonts;\n  if (fonts?.display) light.push(`--ui-font-display: ${cleanValue(fonts.display)};`);\n  if (fonts?.body) light.push(`--ui-font-sans: ${cleanValue(fonts.body)};`);\n  if (fonts?.numeral) light.push(`--ui-font-numeral: ${cleanValue(fonts.numeral)};`);\n  const dark = [...paletteDecls(brand.paletteDark), ...semanticDecls(brand.tokensDark)];\n  const selector = options.selector ?? \":root\";\n  const darkSelector = selector === \":root\" ? ':root[data-theme=\"dark\"]' : `${selector}[data-theme=\"dark\"]`;\n  const systemSelector = selector === \":root\"\n    ? ':root:not([data-theme=\"light\"])'\n    : `${selector}:not([data-theme=\"light\"])`;\n\n  let css = light.length ? `${selector} {\\n  ${light.join(\"\\n  \")}\\n}\\n` : \"\";\n  if (dark.length) {\n    const block = `{\\n  ${dark.join(\"\\n  \")}\\n}`;\n    css += `${darkSelector} ${block}\\n@media (prefers-color-scheme: dark) {\\n  ${systemSelector} ${block}\\n}\\n`;\n  }\n  return css;\n}\n","// Client-side convenience for brand tokens: render the chapter's brand as a\n// <style> tag. Prefer emitting brandTokens() into the page <head> at build/SSR\n// time (no flash); use this when that isn't available (e.g. a pure SPA mount).\nimport { brandTokens } from \"../brand.js\";\nimport type { ChapterBrand } from \"../types\";\n\n/** Props for {@link BrandStyle}. */\nexport interface BrandStyleProps {\n  brand: ChapterBrand | undefined;\n  /** CSS selector receiving the variables. Default `:root`. */\n  selector?: string;\n}\n\n/** Render a chapter's brand tokens as an inline <style> block (or nothing when\n *  there is no brand to theme). */\nexport function BrandStyle(props: BrandStyleProps) {\n  const css = brandTokens(props.brand, { selector: props.selector });\n  if (!css) return null;\n  return <style>{css}</style>;\n}\n"],"mappings":";AAaA,SAAS,WAAW,KAAqB;AACvC,SAAO,IAAI,WAAW,IAAI,IAAI,MAAM,KAAK,GAAG;AAC9C;AAKA,SAAS,WAAW,OAAuB;AACzC,SAAO,MAAM,QAAQ,YAAY,EAAE,EAAE,KAAK;AAC5C;AAEA,SAAS,aAAa,SAAuD;AAC3E,QAAM,QAAkB,CAAC;AACzB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,CAAC,CAAC,GAAG;AACxD,QAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAG,OAAM,KAAK,GAAG,WAAW,GAAG,CAAC,KAAK,WAAW,KAAK,CAAC,GAAG;AAAA,EACvG;AACA,SAAO;AACT;AAEA,IAAM,aAAuD;AAAA,EAC3D,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,WAAW;AAAA,EACX,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,eAAe;AAAA,EACf,eAAe;AACjB;AAEA,SAAS,cAAc,QAAkD;AACvE,SAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,EAAE;AAAA,IAAQ,CAAC,CAAC,KAAK,KAAK,MACtD,OAAO,UAAU,YAAY,MAAM,KAAK,IACpC,CAAC,GAAG,WAAW,GAA+B,CAAC,KAAK,WAAW,KAAK,CAAC,GAAG,IACxE,CAAC;AAAA,EACP;AACF;AAYO,SAAS,YACd,OACA,UAAiC,CAAC,GAC1B;AACR,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,CAAC,GAAG,aAAa,MAAM,OAAO,GAAG,GAAG,cAAc,MAAM,MAAM,CAAC;AAC7E,QAAM,QAAQ,MAAM;AACpB,MAAI,OAAO,QAAS,OAAM,KAAK,sBAAsB,WAAW,MAAM,OAAO,CAAC,GAAG;AACjF,MAAI,OAAO,KAAM,OAAM,KAAK,mBAAmB,WAAW,MAAM,IAAI,CAAC,GAAG;AACxE,MAAI,OAAO,QAAS,OAAM,KAAK,sBAAsB,WAAW,MAAM,OAAO,CAAC,GAAG;AACjF,QAAM,OAAO,CAAC,GAAG,aAAa,MAAM,WAAW,GAAG,GAAG,cAAc,MAAM,UAAU,CAAC;AACpF,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,eAAe,aAAa,UAAU,6BAA6B,GAAG,QAAQ;AACpF,QAAM,iBAAiB,aAAa,UAChC,oCACA,GAAG,QAAQ;AAEf,MAAI,MAAM,MAAM,SAAS,GAAG,QAAQ;AAAA,IAAS,MAAM,KAAK,MAAM,CAAC;AAAA;AAAA,IAAU;AACzE,MAAI,KAAK,QAAQ;AACf,UAAM,QAAQ;AAAA,IAAQ,KAAK,KAAK,MAAM,CAAC;AAAA;AACvC,WAAO,GAAG,YAAY,IAAI,KAAK;AAAA;AAAA,IAA8C,cAAc,IAAI,KAAK;AAAA;AAAA;AAAA,EACtG;AACA,SAAO;AACT;;;AC7ES;AAHF,SAAS,WAAW,OAAwB;AACjD,QAAM,MAAM,YAAY,MAAM,OAAO,EAAE,UAAU,MAAM,SAAS,CAAC;AACjE,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,oBAAC,WAAO,eAAI;AACrB;","names":[]}