@odla-ai/chapter 0.18.0 → 0.19.0

package/README.md

@@ -64,12 +64,36 @@ npm i @odla-ai/chapter
     presentational component without the Clerk browser SDK. (A bundle-graph test
     enforces this.)
   - `@odla-ai/chapter/ui/admin` — the Clerk-gated console `ChapterAdmin` + the
-    section catalog (`peopleSection`). This one does need auth-clerk + crm/ui.
+    section catalog: `collectionSection` (the generic CRM kit — one per record
+    type a site runs: members, deals, investments) with role/approve/refund
+    wired, plus `dashboardSection`, `billingSection`, `emailSection`,
+    `meetingsSection`, `availabilitySection`. This one needs auth-clerk + crm/ui.
   - `@odla-ai/chapter/ui` — the full barrel, for back-compat.
 
   Authored against React, rendered as Preact via `preact/compat` in the reference
   sites. Brand tokens (`brandTokens`/`<BrandStyle>`) re-skin all of it from
-  `brand`.
+  `brand` (now light **and** dark, via `brand.palette` + `brand.paletteDark`).
+
+### Theme tokens (or the console renders broken)
+
+The UI reads its colors from `--ui-*` design tokens whose **values come from a
+theme layer, not `@odla-ai/ui/index.css`.** Load `index.css` (or `odla-ui.css`)
+*alone* and the tokens a theme normally supplies are undefined — panels go
+transparent and the whole console renders dark-on-dark. This failure is silent,
+so it burns people. Import a theme **before** the component sheet:
+
+```ts
+import "@odla-ai/ui/themes/salt/tokens.css"; // the token values (light + dark)
+import "@odla-ai/ui/themes/salt/ui.css";     // the theme's component styling
+import "@odla-ai/ui/index.css";              // the odla-ui components
+```
+
+`ChapterAdmin` guards against this at runtime: if a `.panel` has no background
+(the theme layer is missing), it renders a **loud red banner** at the top of the
+console instead of failing silently. To brand it, pass `brand.palette` /
+`brand.paletteDark` — `brandTokens(brand)` emits both a `:root` block and a
+`[data-theme="dark"]` / `prefers-color-scheme: dark` block, so your accent/colors
+override the theme in both modes.
 
 ## Quick start