@odla-ai/chapter 0.21.0 → 0.22.1

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,13 +1,42 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
+import * as preact from 'preact';
+import { ComponentChildren, JSX } from 'preact';
 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;
     badge?: string;
-    wordmark?: ReactNode;
+    wordmark?: ComponentChildren;
 };
 
 /** Typed URL state for the admin's nested in-page workspaces. */
@@ -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;
-    render: (ctx: AdminSectionContext) => ReactNode;
+    /** Canonical nested view used when a workspace is opened without one. */
+    defaultViewId?: string;
+    render: (ctx: AdminSectionContext) => ComponentChildren;
 }
 /** 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) => ComponentChildren;
+    renderAccountMenu?: (props: AdminAccountMenuProps) => ComponentChildren;
+    renderWorkspaceNav?: (props: AdminWorkspaceNavProps) => ComponentChildren;
 }
 
 /** Configuration for the Clerk-gated, brand-scoped Chapter admin console. */
@@ -84,12 +129,16 @@ 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) => ComponentChildren;
+    renderWorkspaceNav?: (props: AdminWorkspaceNavProps) => ComponentChildren;
+    /** 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;
+declare function ChapterAdmin(props: ChapterAdminProps): preact.JSX.Element;
 
 /** Default follower grammar: three workspaces with nested operational views. */
 declare function defaultAdminWorkspaces(chapter: Chapter): AdminWorkspace[];
@@ -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) => ComponentChildren;
+    renderMaster?: (context: CrmWorkspaceMasterContext, ctx: AdminSectionContext) => ComponentChildren;
+    renderDetailHeader?: (context: CrmWorkspaceRecordContext, ctx: AdminSectionContext) => ComponentChildren;
+    renderEmptyDetail?: (context: CrmWorkspaceMasterContext, ctx: AdminSectionContext) => ComponentChildren;
+    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;
 
@@ -179,7 +245,7 @@ interface RecordActionsProps {
 }
 /** The role/approve/refund controls for one person record. Renders only the
  *  actions the record supports. */
-declare function RecordActions({ getToken, record, roles, onChanged }: RecordActionsProps): react.JSX.Element | null;
+declare function RecordActions({ getToken, record, roles, onChanged }: RecordActionsProps): preact.JSX.Element | null;
 
 /** Props for {@link NetworkShareActions}. */
 interface NetworkShareActionsProps {
@@ -189,7 +255,7 @@ interface NetworkShareActionsProps {
 }
 /** Render follower delivery buttons when this chapter configured network
  * targets. Targets with an explicit type allowlist hide incompatible records. */
-declare function NetworkShareActions(props: NetworkShareActionsProps): react.JSX.Element | null;
+declare function NetworkShareActions(props: NetworkShareActionsProps): preact.JSX.Element | null;
 
 /** Fetch a JSON `/api/admin/*` route with the admin bearer token. Throws on a
  *  non-2xx (the body's `error`, else the status). */
@@ -202,25 +268,25 @@ interface AdminResource<T> {
     /** Re-fetch (e.g. after a mutation). */
     refresh: () => void;
 }
-/** Load a `/api/admin/*` GET route into React state, re-fetching on `refresh()`
+/** Load a `/api/admin/*` GET route into Preact state, re-fetching on `refresh()`
  *  or when `path` changes. */
 declare function useAdminResource<T = unknown>(getToken: () => Promise<string | null>, path: string): AdminResource<T>;
 
 /** The centered content column every admin section renders into. */
 declare function AdminPage({ children }: {
-    children: ReactNode;
-}): react.JSX.Element;
+    children: ComponentChildren;
+}): JSX.Element;
 /** An odla-ui `.panel` card with an optional heading + trailing actions. */
 declare function Panel({ title, actions, children }: {
-    title?: ReactNode;
-    actions?: ReactNode;
-    children: ReactNode;
-}): react.JSX.Element;
+    title?: ComponentChildren;
+    actions?: ComponentChildren;
+    children: ComponentChildren;
+}): JSX.Element;
 /** A loud banner when the odla-ui theme token layer is missing. */
-declare function ThemeWarning(): react.JSX.Element | null;
+declare function ThemeWarning(): JSX.Element | null;
 /** A centered status line for loading / empty / error states. */
 declare function AdminNote({ children }: {
-    children: ReactNode;
-}): react.JSX.Element;
+    children: ComponentChildren;
+}): 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-C4XQSRW7.js";
+import "../../chunk-3QKGKUTX.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 'preact';
 import '@odla-ai/crm';
-import '../types-CXDiDj_s.js';
+import '../types-CgWUQ2MH.js';
 import '@odla-ai/crm/ui';

package/dist/ui/index.js

@@ -12,7 +12,7 @@ import {
   groupSlotsByDay,
   timeLabel,
   tzShort
-} from "../chunk-ILGUJXSB.js";
+} from "../chunk-4COPR4SY.js";
 import {
   AdminNote,
   AdminPage,
@@ -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-C4XQSRW7.js";
 import {
   BrandStyle
-} from "../chunk-3JG5X2LT.js";
+} from "../chunk-3QKGKUTX.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 * as preact from 'preact';
+import { ComponentChildren, JSX } from 'preact';
+import { a as ChapterBrand } from '../../types-CgWUQ2MH.js';
 import '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */
@@ -54,7 +54,7 @@ interface SlotPickerProps<T extends Slot = Slot> {
 /** A day-chips + time-grid slot picker. Presentational and `onPick`-driven: it
  *  owns only the active-day selection; the caller owns slot data, the chosen
  *  slot, and booking. Shared by the join booking step and the member reschedule. */
-declare function SlotPicker<T extends Slot = Slot>(props: SlotPickerProps<T>): react.JSX.Element;
+declare function SlotPicker<T extends Slot = Slot>(props: SlotPickerProps<T>): preact.JSX.Element;
 
 /** Issue an authenticated request and parse the JSON response. Throws on a
  *  non-2xx status (the islands catch and surface a friendly message). */
@@ -70,11 +70,11 @@ interface MembersAreaProps {
     /** Where an accountless member goes to apply. Default "/join.html". */
     applyHref?: string;
     /** What a full (non-provisional) member sees below the account header. */
-    memberContent?: ReactNode;
+    memberContent?: ComponentChildren;
 }
 /** The signed-in member area. Loads /api/me on mount and renders the account
  *  header plus the provisional application card or the full-member content. */
-declare function MembersArea(props: MembersAreaProps): react.JSX.Element;
+declare function MembersArea(props: MembersAreaProps): preact.JSX.Element;
 
 /** Props for {@link Rescheduler}. */
 interface RescheduleProps {
@@ -88,7 +88,7 @@ interface RescheduleProps {
 }
 /** A collapsed "change your time" link that expands into a {@link SlotPicker} and
  *  rebooks on pick. Degrades to a message when scheduling is unavailable. */
-declare function Rescheduler(props: RescheduleProps): react.JSX.Element;
+declare function Rescheduler(props: RescheduleProps): preact.JSX.Element;
 
 /** The public join config (the shape `GET /api/join-config` returns). */
 interface JoinConfig {
@@ -102,13 +102,13 @@ interface JoinIslandProps {
     config: JoinConfig;
     /** The site's application form fields — inputs with `name` attributes; their
      *  values are collected via FormData and posted to /api/applications. */
-    children: ReactNode;
+    children: ComponentChildren;
     /** Where the confirmation links after booking. Default "/members/". */
     membersHref?: string;
 }
 /** The signup island. Renders the site's form, then drives payment (when the
  *  chapter charges) and booking (when a calendar is connected) to confirmation. */
-declare function JoinIsland(props: JoinIslandProps): react.JSX.Element;
+declare function JoinIsland(props: JoinIslandProps): JSX.Element;
 
 /** Props for {@link PaymentStep}. */
 interface PaymentStepProps {
@@ -121,7 +121,7 @@ interface PaymentStepProps {
 }
 /** The card-entry step: acknowledge the refund policy → create the subscription
  *  → mount Stripe Elements → confirm. */
-declare function PaymentStep(props: PaymentStepProps): react.JSX.Element;
+declare function PaymentStep(props: PaymentStepProps): preact.JSX.Element;
 
 /** Props for {@link BrandStyle}. */
 interface BrandStyleProps {
@@ -131,6 +131,6 @@ interface BrandStyleProps {
 }
 /** Render a chapter's brand tokens as an inline <style> block (or nothing when
  *  there is no brand to theme). */
-declare function BrandStyle(props: BrandStyleProps): react.JSX.Element | null;
+declare function BrandStyle(props: BrandStyleProps): preact.JSX.Element | null;
 
 export { type ApiFn, BrandStyle, type BrandStyleProps, type JoinConfig, JoinIsland, type JoinIslandProps, MembersArea, type MembersAreaProps, PaymentStep, type PaymentStepProps, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, timeLabel, tzShort };

package/dist/ui/member/index.js

@@ -12,10 +12,10 @@ import {
   groupSlotsByDay,
   timeLabel,
   tzShort
-} from "../../chunk-ILGUJXSB.js";
+} from "../../chunk-4COPR4SY.js";
 import {
   BrandStyle
-} from "../../chunk-3JG5X2LT.js";
+} from "../../chunk-3QKGKUTX.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.1",
   "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,16 +70,20 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@odla-ai/crm": "^0.2.0",
+    "@odla-ai/crm": "^0.3.1",
     "jose": "^6.2.3"
   },
   "peerDependencies": {
+    "@odla-ai/auth-clerk": ">=0.4.1 <1.0.0",
     "@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",
-    "react": ">=18"
+    "@odla-ai/db": ">=0.6.7 <1.0.0",
+    "@odla-ai/ui": ">=0.12.1 <1.0.0",
+    "preact": ">=10.29.7 <11"
   },
   "peerDependenciesMeta": {
+    "@odla-ai/auth-clerk": {
+      "optional": true
+    },
     "@odla-ai/calendar": {
       "optional": true
     },
@@ -88,9 +92,6 @@
     },
     "@odla-ai/ui": {
       "optional": true
-    },
-    "react": {
-      "optional": true
     }
   },
   "devDependencies": {
@@ -99,10 +100,9 @@
     "@odla-ai/db": "*",
     "@odla-ai/ui": "*",
     "@types/node": "^26.1.0",
-    "@types/react": "^19.2.7",
     "@vitest/coverage-v8": "^4.1.9",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
+    "preact": "10.29.7",
+    "preact-render-to-string": "6.7.0",
     "tsup": "^8.3.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"

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

@@ -18,12 +18,12 @@ Chapter supplies:
 - the validated `defineChapter()` engine and generated schema/rules/seed;
 - the Cloudflare Worker API through `chapterWorker()`;
 - the join, payment, booking, member, admin, CRM, and network behavior;
-- member-facing React components and the complete Clerk-gated admin console;
+- member-facing Preact components and the complete Clerk-gated admin console;
 - the provisioning descriptor consumed by `@odla-ai/cli`.
 
 Chapter does **not** generate a website. The host still owns:
 
-- `package.json`, Vite/React or Vite/Preact, HTML entries, routing, and CSS;
+- `package.json`, Vite/Preact, HTML entries, routing, and CSS;
 - public pages, navigation, copy, imagery, SEO, legal text, and the join form;
 - the member auth wrapper that gives `MembersArea` an authenticated `api`;
 - Wrangler configuration, observability wrapping, provider setup, and tests.
@@ -115,31 +115,30 @@ npm init -y
 npx @odla-ai/cli@0.17.1 setup
 ```
 
-Verify every release target exists, then install the exact known-good React
+Verify every release target exists, then install the exact known-good Preact
 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.1` is not yet on npm.
 
 ```sh
-npm view @odla-ai/chapter@0.21.0 version
+npm view @odla-ai/chapter@0.22.1 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.1 @odla-ai/ui@0.12.1 \
+  @odla-ai/crm@0.3.1 @odla-ai/db@0.6.7 \
   @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
+  @odla-ai/auth-clerk@0.4.1 @odla-ai/o11y@2.2.2 \
+  jose@6.2.3 preact@10.29.7
 npm install --save-dev --save-exact \
   @odla-ai/cli@0.17.1 @odla-ai/security@0.3.1 \
   @cloudflare/workers-types@4.20260702.1 \
-  @types/react@19.2.17 @types/react-dom@19.2.3 \
-  @vitejs/plugin-react@6.0.3 typescript@6.0.3 \
+  typescript@6.0.3 \
   vite@8.1.4 vitest@4.1.10 wrangler@4.107.0
 npx odla-ai capabilities --json
 ```
 
 The parent `README.md` repeats this version matrix. This runbook standardizes on
-React; a Preact host needs its own exact, tested compatibility matrix. Install
-auth-clerk explicitly: it is deliberately not a Chapter peer because
-worker-only and member-only consumers do not need it.
+Preact. Install auth-clerk explicitly when adopting the admin entry; it is an
+optional Chapter peer because worker-only and member-only consumers do not need
+it.
 
 Required host scripts:
 

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":[]}