@memobit/themes 1.3.0 → 2.0.0

package/README.md

@@ -1,24 +1,87 @@
 # @memobit/themes
 
-68 themes for the Memobit apps. Each is published as its own stylesheet, so an app loads
-only the one it is showing instead of all of them.
+Themes for the Memobit apps, in two forms:
+
+- **Authored** (new in 2.0): a hand-made theme written as its design choices — ink and text
+  tiers, paper surfaces, lines, the accent and status colours, how a selection looks, the
+  voice of titles and labels, shadows and glass. The build derives every component value
+  from those choices through one shared bridge, so badges, chips, inputs and toasts behave
+  the same way in every theme while each keeps its own look.
+- **Classic**: the 49 hand-written themes, each setting ~230 component values directly and
+  published as its own stylesheet. They keep working unchanged while apps move over.
 
 Extracted from [`@memobit/libs`](https://github.com/CristeaIulian/memobit-react-library) in
 v3.0.0 of that library.
 
-## Why
+## Authored themes
+
+```ts
+import '@memobit/themes/authored.css';
+import { applyAuthoredEngine, clearAuthoredEngine } from '@memobit/themes';
+
+applyAuthoredEngine(); // the authored version of whatever data-theme names, where one exists
+clearAuthoredEngine(); // back to the classic theme
+```
+
+An authored theme applies under its classic theme's `data-theme` while the root carries
+`data-theme-engine="authored"`, so an app can flip between the two. Where no authored
+version exists, the classic theme shows through.
+
+### Layers
+
+1. **The theme** (`src/authored/<id>.ts`): about 20 required choices and some optional
+   ones, typed by `src/authored/contract.ts`. Written by hand or with Claude Design.
+2. **Roles** (`scripts/authored/derive.ts`): turns the choices into semantic roles
+   (`--surface-*`, `--text-*`, `--border-*`, `--field-*`, `--tone-*`, `--selected-*`). An
+   optional choice left out gets the obvious derivation, e.g. a hover is the solid pushed
+   towards the ink.
+3. **Bridge** (`scripts/authored/bridge.ts`): maps the roles onto every component token
+   `@memobit/libs` reads (`--button-info-background-color`, `--dropdown-header-color`…).
+4. **Recipes** (`src/authored/recipes.css`): Badge and Chip share one tone recipe.
+
+Every tone (neutral, accent, success, warning, danger) exposes the same roles: `solid`,
+`solid-hover`, `on-solid`, `soft`, `soft-hover`, `on-soft`, `border`, `text`. Buttons,
+badges, chips, toasts, progress bars and tabs all read them, which is what keeps a
+"success" the same colour everywhere. The lib's `info` variant is its primary action and
+maps to the accent tone. Every field (text inputs, dropdowns, date pickers, sliders) reads
+the same `--field-*` roles, and the `selection` choice (`ink`, `soft`, `solid`) decides how
+selected chips, tabs and ticked checkboxes look.
+
+### Checks
+
+`npm run build:authored` fails when
+
+- a token some classic theme sets is not produced by the bridge, since it would leak
+  through from the classic theme still loaded underneath, or
+- a role the bridge or recipes read is not produced by a theme.
+
+It also reports text/background pairs below their contrast target (4.5:1, 3:1 for
+placeholders) without failing, while authored themes reproduce classic ones as they were.
+
+### Adding a theme
+
+1. Add `src/authored/<id>.ts` exporting an `AuthoredTheme`, with the classic theme's id.
+2. Add it to `AUTHORED_THEMES` in `scripts/build-authored.ts`.
+3. Run `npm run build`. Its stylesheet lands in `dist/authored/<id>.css` and in
+   `dist/authored.css`.
+
+The theme's fonts are still loaded through the classic theme's `THEME_CONFIGS` entry.
+
+## Classic themes
+
+### Why
 
 Themes used to ship as a single aggregate stylesheet that every app imported wholesale —
 ~618 KB of which exactly one theme is ever active. Splitting them took one app's CSS from
 866 KB to 295 KB.
 
-## Install
+### Install
 
 ```bash
 npm install @memobit/themes
 ```
 
-## Usage
+### Usage
 
 Add the Vite plugin. It emits each theme as a separate asset and tells `@memobit/libs`
 where to find them, so `ThemeProvider` fetches the selected theme and nothing else.
@@ -46,7 +109,7 @@ import '@memobit/libs/dist/styles/base.scss';
 import '@memobit/libs/dist/styles/scrollbars.scss';
 ```
 
-## Exports
+### Exports
 
 ```ts
 import {
@@ -63,7 +126,7 @@ import {
 whose stylesheet is not loaded. It is generated from the compiled CSS, because ten themes
 build their tokens through the `_profile-theme` mixin rather than declaring them literally.
 
-## Adding a theme
+### Adding a theme
 
 1. Add `src/theming/<name>.scss`, scoped to `[data-theme='<name>']`.
 2. Add a `@use` line in `src/themes.scss`.

package/dist/authored/sandy-parchment.css

@@ -0,0 +1,83 @@
+:root[data-theme-engine='authored'][data-theme='sandy-parchment']{color-scheme:light;--font-body:'Figtree', 'Avenir Next', sans-serif;--font-display:'Newsreader', Georgia, serif;--font-mono:ui-monospace, SFMono-Regular, 'JetBrains Mono', Menlo, Consolas, monospace;--display-style:italic;--display-weight:500;--display-size:var(--font-size-xl);--display-transform:none;--display-tracking:normal;--label-weight:500;--label-transform:uppercase;--label-tracking:0.18em;--header-weight:500;--canvas-layers:radial-gradient(120% 100% at 0% 0%, #f8ecd0 0%, #e8d7af 45%, #cbb383 100%);--surface-canvas:#f4ecdc;--surface-card:rgba(255, 248, 230, 0.95);--surface-raised:#f4ead2;--surface-raised-alt:rgba(255, 241, 207, 0.42);--surface-overlay:#f4ead2;--surface-overlay-card:rgba(255, 248, 230, 0.72);--surface-sunken:#e4d4a7;--control-hover:#ead8ae;--surface-hover:color-mix(in oklab, #c66f22 8%, transparent);--surface-stripe:#efe0bd;--rating-empty:color-mix(in oklab, #e4d4a7 85%, #20160d);--surface-selected:color-mix(in oklab, #c66f22 18%, transparent);--surface-blur:blur(22px) saturate(1.4);--text-strong:#20160d;--text-default:#423929;--text-soft:#635847;--text-muted:#7e725f;--text-subtle:#817664;--text-link:#a85b1c;--text-link-hover:#cf792c;--border-subtle:rgba(90, 68, 34, 0.18);--border-default:rgba(88, 67, 34, 0.22);--border-strong:rgba(88, 67, 34, 0.22);--border-card:rgba(255, 252, 240, 0.8);--border-card-hover:rgba(255, 252, 240, 0.8);--field-bg:#f4ead2;--field-bg-focus:#f8efd8;--field-bg-disabled:color-mix(in oklab, #f4ead2 94%, #20160d);--field-fg:#423929;--field-border:rgba(88, 67, 34, 0.28);--field-border-hover:#b7884d;--field-border-focus:#c66f22;--field-placeholder:#817664;--field-label:#7e725f;--field-ring:color-mix(in oklab, #c66f22 24%, transparent);--tone-neutral-solid:#20160d;--tone-neutral-solid-hover:color-mix(in oklab, #20160d 70%, #423929);--tone-neutral-on-solid:#fff8e9;--tone-neutral-soft:#ead8ae;--tone-neutral-soft-hover:color-mix(in oklab, #ead8ae 92%, #20160d);--tone-neutral-on-soft:#20160d;--tone-neutral-border:rgba(88, 67, 34, 0.22);--tone-neutral-text:#635847;--tone-accent-solid:#c66f22;--tone-accent-solid-hover:#a85618;--tone-accent-on-solid:#fff8e9;--tone-accent-soft:color-mix(in oklab, #c66f22 16%, transparent);--tone-accent-soft-hover:color-mix(in oklab, #c66f22 24%, transparent);--tone-accent-on-soft:color-mix(in oklab, #c66f22 80%, #20160d);--tone-accent-border:color-mix(in oklab, #c66f22 40%, transparent);--tone-accent-text:#c66f22;--tone-success-solid:#3f7d45;--tone-success-solid-hover:#326738;--tone-success-on-solid:#fff8e9;--tone-success-soft:color-mix(in oklab, #3f7d45 16%, transparent);--tone-success-soft-hover:color-mix(in oklab, #3f7d45 24%, transparent);--tone-success-on-soft:color-mix(in oklab, #3f7d45 80%, #20160d);--tone-success-border:color-mix(in oklab, #3f7d45 40%, transparent);--tone-success-text:#3f7d45;--tone-warning-solid:#b68432;--tone-warning-solid-hover:#9a6a25;--tone-warning-on-solid:#fff8e9;--tone-warning-soft:color-mix(in oklab, #b68432 16%, transparent);--tone-warning-soft-hover:color-mix(in oklab, #b68432 24%, transparent);--tone-warning-on-soft:#8a5f1e;--tone-warning-border:color-mix(in oklab, #b68432 40%, transparent);--tone-warning-text:#8a5f1e;--tone-danger-solid:#9f2f2f;--tone-danger-solid-hover:#842525;--tone-danger-on-solid:#fff8e9;--tone-danger-soft:color-mix(in oklab, #9f2f2f 16%, transparent);--tone-danger-soft-hover:color-mix(in oklab, #9f2f2f 24%, transparent);--tone-danger-on-soft:color-mix(in oklab, #9f2f2f 80%, #20160d);--tone-danger-border:color-mix(in oklab, #9f2f2f 40%, transparent);--tone-danger-text:#9f2f2f;--accent-glow:#df9048;--selected-bg:var(--tone-neutral-solid);--selected-bg-hover:var(--tone-neutral-solid-hover);--selected-fg:var(--tone-neutral-on-solid);--selected-border:var(--tone-neutral-solid);--selected-solid:var(--tone-neutral-solid);--selected-solid-fg:var(--tone-neutral-on-solid);--shadow-color:color-mix(in oklab, #20160d 18%, transparent);--shadow-color-strong:color-mix(in oklab, #20160d 28%, transparent);--shadow-sm:0 1px 0 rgba(255, 252, 240, 0.9) inset, 0 0 0 1px rgba(31, 24, 17, 0.08), 0 18px 40px -20px rgba(60, 40, 20, 0.45);--shadow-md:0 18px 40px rgba(68, 50, 23, 0.14), 0 2px 8px rgba(68, 50, 23, 0.1);--shadow-lg:0 28px 80px rgba(34, 29, 22, 0.32), 0 6px 18px rgba(34, 29, 22, 0.2);--scrim:rgba(34, 29, 22, 0.42);--body-background:var(--canvas-layers), var(--surface-canvas);--body-background-base:var(--surface-canvas);--body-background-wash:var(--canvas-layers), var(--surface-canvas);--body-background-glow:none;--body-color:var(--text-default);--body-color-accent:var(--text-strong);--body-color-muted:var(--text-muted);--body-title-color:var(--text-strong);--body-sub-title-color:var(--text-soft);--body-accent-color:var(--tone-accent-text);--body-danger-color:var(--tone-danger-text);--backdrop-color:var(--scrim);--box-shadow:var(--shadow-color);--text-shadow:var(--shadow-color);--border-color:var(--border-strong);--delimiter-color:var(--border-subtle);--links-color:var(--text-link);--links-hover-color:var(--text-link-hover);--font-family:var(--font-body);--font-family-sans:var(--font-body);--font-family-display:var(--font-display);--font-family-mono:var(--font-mono);--header-background-color:var(--surface-raised);--header-border-bottom-color:var(--border-subtle);--header-color:var(--text-strong);--header-font-weight:var(--header-weight);--button-default-background-color:var(--surface-raised);--button-default-border-color:var(--border-default);--button-default-color:var(--text-default);--button-default-hover-background-color:var(--control-hover);--button-default-hover-border-color:var(--field-border-hover);--button-default-hover-color:var(--text-strong);--button-ghost-background-color:transparent;--button-ghost-border-color:transparent;--button-ghost-color:var(--text-soft);--button-ghost-hover-background-color:var(--control-hover);--button-ghost-hover-border-color:transparent;--button-ghost-hover-color:var(--text-strong);--button-plain-color:var(--text-soft);--button-plain-hover-color:var(--text-strong);--button-info-background-color:var(--tone-accent-solid);--button-info-border-color:var(--tone-accent-solid);--button-info-color:var(--tone-accent-on-solid);--button-info-hover-background-color:var(--tone-accent-solid-hover);--button-info-hover-border-color:var(--tone-accent-solid-hover);--button-info-hover-color:var(--tone-accent-on-solid);--toast-info-background-color:#c66f22;--toast-info-border-color:color-mix(in oklab, #c66f22 75%, #fff8e9);--toast-info-color:#fff8e9;--progress-info-bar-border-color:var(--tone-accent-solid);--progress-info-bar-fill-color:var(--tone-accent-solid);--rating-color-info:var(--tone-accent-solid);--card-tint-info-background:var(--tone-accent-soft);--button-success-background-color:var(--tone-success-solid);--button-success-border-color:var(--tone-success-solid);--button-success-color:var(--tone-success-on-solid);--button-success-hover-background-color:var(--tone-success-solid-hover);--button-success-hover-border-color:var(--tone-success-solid-hover);--button-success-hover-color:var(--tone-success-on-solid);--toast-success-background-color:#3f7d45;--toast-success-border-color:color-mix(in oklab, #3f7d45 75%, #fff8e9);--toast-success-color:#fff8e9;--progress-success-bar-border-color:var(--tone-success-solid);--progress-success-bar-fill-color:var(--tone-success-solid);--rating-color-success:var(--tone-success-solid);--card-tint-success-background:var(--tone-success-soft);--button-warning-background-color:var(--tone-warning-solid);--button-warning-border-color:var(--tone-warning-solid);--button-warning-color:var(--tone-warning-on-solid);--button-warning-hover-background-color:var(--tone-warning-solid-hover);--button-warning-hover-border-color:var(--tone-warning-solid-hover);--button-warning-hover-color:var(--tone-warning-on-solid);--toast-warning-background-color:#b68432;--toast-warning-border-color:color-mix(in oklab, #b68432 75%, #fff8e9);--toast-warning-color:#fff8e9;--progress-warning-bar-border-color:var(--tone-warning-solid);--progress-warning-bar-fill-color:var(--tone-warning-solid);--rating-color-warning:var(--tone-warning-solid);--card-tint-warning-background:var(--tone-warning-soft);--button-danger-background-color:var(--tone-danger-solid);--button-danger-border-color:var(--tone-danger-solid);--button-danger-color:var(--tone-danger-on-solid);--button-danger-hover-background-color:var(--tone-danger-solid-hover);--button-danger-hover-border-color:var(--tone-danger-solid-hover);--button-danger-hover-color:var(--tone-danger-on-solid);--toast-danger-background-color:#9f2f2f;--toast-danger-border-color:color-mix(in oklab, #9f2f2f 75%, #fff8e9);--toast-danger-color:#fff8e9;--progress-danger-bar-border-color:var(--tone-danger-solid);--progress-danger-bar-fill-color:var(--tone-danger-solid);--rating-color-danger:var(--tone-danger-solid);--card-tint-danger-background:var(--tone-danger-soft);--progress-bar-background-color:var(--surface-sunken);--progress-bar-color:var(--text-default);--progress-default-bar-border-color:var(--border-strong);--progress-default-bar-fill-color:var(--tone-neutral-solid);--rating-empty-color:var(--rating-empty);--rating-empty-label-color:var(--text-muted);--rating-half-rate-empty-color:var(--rating-empty);--card-tint-default-background:var(--surface-raised-alt);--card-accent-color:var(--tone-accent-text);--card-backdrop-filter:var(--surface-blur);--card-background-accent-color:var(--surface-raised-alt);--card-background-color:var(--surface-card);--card-border-accent-color:var(--tone-accent-solid);--card-border-color:var(--border-card);--card-box-shadow:var(--shadow-md);--card-color:var(--text-default);--card-footer-background-color:var(--surface-raised-alt);--card-footer-color:var(--text-soft);--card-hover-border-color:var(--border-card-hover);--card-surface-box-shadow:var(--shadow-sm);--card-title-color:var(--text-strong);--card-title-font-family:var(--font-display);--card-title-font-size:var(--display-size);--card-title-font-style:var(--display-style);--card-title-font-weight:var(--display-weight);--card-title-letter-spacing:var(--display-tracking);--card-title-text-transform:var(--display-transform);--modal-backdrop-filter:var(--surface-blur);--modal-background-color:var(--surface-overlay-card);--modal-body-color:var(--text-default);--modal-border-color:var(--border-card);--modal-box-shadow:var(--shadow-lg);--modal-box-shadow-hover:var(--shadow-lg);--modal-color:var(--text-default);--modal-footer-background-color:var(--surface-raised-alt);--modal-header-background-color:var(--surface-raised-alt);--modal-header-color:var(--text-strong);--modal-surface-box-shadow:var(--shadow-lg);--modal-title-color:var(--text-strong);--modal-title-font-family:var(--font-body);--modal-title-font-size:var(--font-size-sm);--modal-title-font-style:normal;--modal-title-font-weight:500;--modal-title-letter-spacing:0.18em;--modal-title-text-transform:uppercase;--drawer-background-color:var(--surface-overlay-card);--drawer-header-background-color:var(--surface-raised-alt);--drawer-border-color:var(--border-card);--drawer-shadow:var(--shadow-lg);--form-control-background-color:var(--field-bg);--form-control-border-color:var(--field-border);--form-control-color:var(--field-fg);--form-control-focus-background-color:var(--field-bg-focus);--form-control-focus-border-color:var(--field-border-focus);--form-control-focus-color:var(--field-fg);--form-control-focus-ring:var(--field-ring);--form-control-error-background-color:color-mix(in oklab, var(--tone-danger-solid) 6%, var(--field-bg));--form-control-error-border-color:var(--tone-danger-solid);--form-control-error-color:var(--tone-danger-text);--form-control-success-background-color:color-mix(in oklab, var(--tone-success-solid) 7%, var(--field-bg));--form-control-success-border-color:var(--tone-success-solid);--form-control-success-color:var(--tone-success-text);--form-control-font-family:var(--font-body);--form-control-label-color:var(--field-label);--form-control-label-font-size:var(--font-size-xs);--form-control-label-font-weight:var(--label-weight);--form-control-label-letter-spacing:var(--label-tracking);--form-control-label-text-transform:var(--label-transform);--form-control-placeholder-color:var(--field-placeholder);--form-control-selection-background-color:var(--selected-solid);--form-control-selection-border-color:var(--selected-solid);--form-control-selection-color:var(--selected-solid-fg);--form-control-selection-label-color:var(--text-default);--datepicker-input-background-color:var(--field-bg);--dropdown-border-color:var(--field-border);--dropdown-header-background-color:var(--field-bg);--dropdown-header-border-focus-color:var(--field-border-focus);--dropdown-header-color:var(--field-fg);--dropdown-options-background-color:var(--surface-overlay);--dropdown-options-color:var(--text-default);--dropdown-options-hover-background-color:var(--surface-hover);--dropdown-options-hover-color:var(--text-strong);--dropdown-options-selected-background-color:var(--surface-selected);--dropdown-options-selected-color:var(--text-strong);--dropdown-action-background-color:var(--surface-raised-alt);--dropdown-action-color:var(--text-link);--dropdown-action-hover-background-color:var(--surface-hover);--dropdown-action-hover-color:var(--text-link-hover);--dropdown-chips-background-color:var(--selected-bg);--dropdown-chips-border-color:var(--selected-border);--dropdown-chips-color:var(--selected-fg);--dropdown-chips-hover-background-color:var(--selected-bg-hover);--slider-track-background-color:var(--surface-sunken);--slider-track-border-color:var(--field-border);--slider-track-hover-background-color:var(--control-hover);--slider-track-hover-border-color:var(--field-border-hover);--slider-thumb-background-color:var(--tone-accent-solid);--slider-thumb-border-color:var(--tone-accent-solid);--slider-thumb-hover-background-color:var(--tone-accent-solid-hover);--slider-thumb-hover-border-color:var(--tone-accent-solid-hover);--calendar-background-color:var(--surface-overlay);--calendar-border-color:var(--border-default);--calendar-day-color:var(--text-soft);--calendar-day-disabled-color:var(--text-subtle);--calendar-day-hover-background-color:var(--control-hover);--calendar-day-selected-background-color:var(--tone-accent-solid);--calendar-day-selected-color:var(--tone-accent-on-solid);--calendar-day-today-border-color:var(--tone-accent-solid);--calendar-day-weekend-color:var(--text-muted);--calendar-header-background-color:var(--surface-raised-alt);--calendar-header-color:var(--text-strong);--chip-hover-background-color:var(--surface-hover);--chip-hover-border-color:var(--border-strong);--chip-hover-color:var(--text-strong);--chip-selected-background-color:var(--selected-bg);--chip-selected-border-color:var(--selected-border);--chip-selected-color:var(--selected-fg);--chip-selected-count-color:color-mix(in oklab, var(--selected-fg) 72%, transparent);--list-alternate-background-color:var(--surface-stripe);--list-hover-background-color:var(--surface-hover);--tabs-active-background-color:var(--selected-bg);--tabs-active-color:var(--selected-fg);--tabs-inactive-background-color:transparent;--tabs-inactive-color:var(--text-muted);--tooltip-background-color:var(--tone-neutral-solid);--tooltip-border-color:var(--tone-neutral-solid);--tooltip-color:var(--tone-neutral-on-solid);--popover-background-color:var(--surface-overlay);--popover-border-color:var(--border-default);--popover-color:var(--text-default);--popover-arrow-color:var(--border-default);--loader-border-color:var(--tone-accent-soft);--loader-border-top-color:var(--tone-accent-solid);--tour-hud-accent-color:var(--tone-accent-solid);--note-container-effect-background-color:var(--tone-accent-soft);--note-container-effect-color:var(--tone-accent-on-soft);--note-container-effect-border-left-color:var(--tone-accent-solid);--glow-box-shadow-color:0 0 16px color-mix(in oklab, var(--tone-accent-solid) 45%, transparent);--glow-hover-border-color:var(--tone-accent-border);--infuse-effect-before-background:linear-gradient(90deg, var(--tone-accent-solid), var(--accent-glow));--infuse-effect-hover-border-color:var(--tone-accent-solid);--infuse-effect-hover-box-shadow-color:color-mix(in oklab, var(--tone-accent-solid) 35%, transparent);--up-lift-effect-before-background:linear-gradient(135deg, var(--tone-accent-solid), var(--accent-glow));--up-lift-effect-box-shadow-color:var(--shadow-color-strong);--up-lift-effect-hover-border-color:var(--tone-accent-solid);--up-lift-effect-hover-box-shadow-color:color-mix(in oklab, var(--tone-accent-solid) 35%, transparent)}
+/*
+ * Component recipes for the authored themes. Badge and Chip take a tone and one shared set
+ * of roles (soft background, ink on soft, border), so a "success" badge, a selected
+ * "success" chip and a success toast carry the same three colours.
+ *
+ * These rules sit here rather than in @memobit/libs while the classic themes still drive
+ * the same components. Once the classic themes are retired they move into the lib.
+ */
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .badge-variant--default {
+    --recipe-soft: var(--tone-neutral-soft);
+    --recipe-soft-hover: var(--tone-neutral-soft-hover);
+    --recipe-on-soft: var(--tone-neutral-on-soft);
+    --recipe-border: var(--tone-neutral-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--info, .chip--info) {
+    --recipe-soft: var(--tone-accent-soft);
+    --recipe-soft-hover: var(--tone-accent-soft-hover);
+    --recipe-on-soft: var(--tone-accent-on-soft);
+    --recipe-border: var(--tone-accent-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--success, .chip--success) {
+    --recipe-soft: var(--tone-success-soft);
+    --recipe-soft-hover: var(--tone-success-soft-hover);
+    --recipe-on-soft: var(--tone-success-on-soft);
+    --recipe-border: var(--tone-success-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--warning, .chip--warning) {
+    --recipe-soft: var(--tone-warning-soft);
+    --recipe-soft-hover: var(--tone-warning-soft-hover);
+    --recipe-on-soft: var(--tone-warning-on-soft);
+    --recipe-border: var(--tone-warning-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--danger, .chip--danger) {
+    --recipe-soft: var(--tone-danger-soft);
+    --recipe-soft-hover: var(--tone-danger-soft-hover);
+    --recipe-on-soft: var(--tone-danger-on-soft);
+    --recipe-border: var(--tone-danger-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment']
+    .badge:is(.badge-variant--default, .badge-variant--info, .badge-variant--success, .badge-variant--warning, .badge-variant--danger) {
+    border-color: var(--recipe-border);
+    background-color: var(--recipe-soft);
+    color: var(--recipe-on-soft);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger) {
+    border-color: var(--border-default);
+    background: transparent;
+    color: var(--text-default);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger):hover:not(:disabled) {
+    border-color: var(--recipe-border);
+    background: var(--surface-hover);
+    color: var(--text-strong);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger).chip--selected {
+    border-color: var(--recipe-border);
+    background: var(--recipe-soft);
+    color: var(--recipe-on-soft);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger).chip--selected:hover:not(:disabled) {
+    border-color: var(--recipe-border);
+    background: var(--recipe-soft-hover);
+    color: var(--recipe-on-soft);
+}
+
+/* A default chip carries no tone, so its selected state is the theme's selection style. */
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip.chip--default {
+    --recipe-soft: var(--selected-bg);
+    --recipe-soft-hover: var(--selected-bg-hover);
+    --recipe-on-soft: var(--selected-fg);
+    --recipe-border: var(--selected-border);
+}

package/dist/authored.css

@@ -0,0 +1,83 @@
+:root[data-theme-engine='authored'][data-theme='sandy-parchment']{color-scheme:light;--font-body:'Figtree', 'Avenir Next', sans-serif;--font-display:'Newsreader', Georgia, serif;--font-mono:ui-monospace, SFMono-Regular, 'JetBrains Mono', Menlo, Consolas, monospace;--display-style:italic;--display-weight:500;--display-size:var(--font-size-xl);--display-transform:none;--display-tracking:normal;--label-weight:500;--label-transform:uppercase;--label-tracking:0.18em;--header-weight:500;--canvas-layers:radial-gradient(120% 100% at 0% 0%, #f8ecd0 0%, #e8d7af 45%, #cbb383 100%);--surface-canvas:#f4ecdc;--surface-card:rgba(255, 248, 230, 0.95);--surface-raised:#f4ead2;--surface-raised-alt:rgba(255, 241, 207, 0.42);--surface-overlay:#f4ead2;--surface-overlay-card:rgba(255, 248, 230, 0.72);--surface-sunken:#e4d4a7;--control-hover:#ead8ae;--surface-hover:color-mix(in oklab, #c66f22 8%, transparent);--surface-stripe:#efe0bd;--rating-empty:color-mix(in oklab, #e4d4a7 85%, #20160d);--surface-selected:color-mix(in oklab, #c66f22 18%, transparent);--surface-blur:blur(22px) saturate(1.4);--text-strong:#20160d;--text-default:#423929;--text-soft:#635847;--text-muted:#7e725f;--text-subtle:#817664;--text-link:#a85b1c;--text-link-hover:#cf792c;--border-subtle:rgba(90, 68, 34, 0.18);--border-default:rgba(88, 67, 34, 0.22);--border-strong:rgba(88, 67, 34, 0.22);--border-card:rgba(255, 252, 240, 0.8);--border-card-hover:rgba(255, 252, 240, 0.8);--field-bg:#f4ead2;--field-bg-focus:#f8efd8;--field-bg-disabled:color-mix(in oklab, #f4ead2 94%, #20160d);--field-fg:#423929;--field-border:rgba(88, 67, 34, 0.28);--field-border-hover:#b7884d;--field-border-focus:#c66f22;--field-placeholder:#817664;--field-label:#7e725f;--field-ring:color-mix(in oklab, #c66f22 24%, transparent);--tone-neutral-solid:#20160d;--tone-neutral-solid-hover:color-mix(in oklab, #20160d 70%, #423929);--tone-neutral-on-solid:#fff8e9;--tone-neutral-soft:#ead8ae;--tone-neutral-soft-hover:color-mix(in oklab, #ead8ae 92%, #20160d);--tone-neutral-on-soft:#20160d;--tone-neutral-border:rgba(88, 67, 34, 0.22);--tone-neutral-text:#635847;--tone-accent-solid:#c66f22;--tone-accent-solid-hover:#a85618;--tone-accent-on-solid:#fff8e9;--tone-accent-soft:color-mix(in oklab, #c66f22 16%, transparent);--tone-accent-soft-hover:color-mix(in oklab, #c66f22 24%, transparent);--tone-accent-on-soft:color-mix(in oklab, #c66f22 80%, #20160d);--tone-accent-border:color-mix(in oklab, #c66f22 40%, transparent);--tone-accent-text:#c66f22;--tone-success-solid:#3f7d45;--tone-success-solid-hover:#326738;--tone-success-on-solid:#fff8e9;--tone-success-soft:color-mix(in oklab, #3f7d45 16%, transparent);--tone-success-soft-hover:color-mix(in oklab, #3f7d45 24%, transparent);--tone-success-on-soft:color-mix(in oklab, #3f7d45 80%, #20160d);--tone-success-border:color-mix(in oklab, #3f7d45 40%, transparent);--tone-success-text:#3f7d45;--tone-warning-solid:#b68432;--tone-warning-solid-hover:#9a6a25;--tone-warning-on-solid:#fff8e9;--tone-warning-soft:color-mix(in oklab, #b68432 16%, transparent);--tone-warning-soft-hover:color-mix(in oklab, #b68432 24%, transparent);--tone-warning-on-soft:#8a5f1e;--tone-warning-border:color-mix(in oklab, #b68432 40%, transparent);--tone-warning-text:#8a5f1e;--tone-danger-solid:#9f2f2f;--tone-danger-solid-hover:#842525;--tone-danger-on-solid:#fff8e9;--tone-danger-soft:color-mix(in oklab, #9f2f2f 16%, transparent);--tone-danger-soft-hover:color-mix(in oklab, #9f2f2f 24%, transparent);--tone-danger-on-soft:color-mix(in oklab, #9f2f2f 80%, #20160d);--tone-danger-border:color-mix(in oklab, #9f2f2f 40%, transparent);--tone-danger-text:#9f2f2f;--accent-glow:#df9048;--selected-bg:var(--tone-neutral-solid);--selected-bg-hover:var(--tone-neutral-solid-hover);--selected-fg:var(--tone-neutral-on-solid);--selected-border:var(--tone-neutral-solid);--selected-solid:var(--tone-neutral-solid);--selected-solid-fg:var(--tone-neutral-on-solid);--shadow-color:color-mix(in oklab, #20160d 18%, transparent);--shadow-color-strong:color-mix(in oklab, #20160d 28%, transparent);--shadow-sm:0 1px 0 rgba(255, 252, 240, 0.9) inset, 0 0 0 1px rgba(31, 24, 17, 0.08), 0 18px 40px -20px rgba(60, 40, 20, 0.45);--shadow-md:0 18px 40px rgba(68, 50, 23, 0.14), 0 2px 8px rgba(68, 50, 23, 0.1);--shadow-lg:0 28px 80px rgba(34, 29, 22, 0.32), 0 6px 18px rgba(34, 29, 22, 0.2);--scrim:rgba(34, 29, 22, 0.42);--body-background:var(--canvas-layers), var(--surface-canvas);--body-background-base:var(--surface-canvas);--body-background-wash:var(--canvas-layers), var(--surface-canvas);--body-background-glow:none;--body-color:var(--text-default);--body-color-accent:var(--text-strong);--body-color-muted:var(--text-muted);--body-title-color:var(--text-strong);--body-sub-title-color:var(--text-soft);--body-accent-color:var(--tone-accent-text);--body-danger-color:var(--tone-danger-text);--backdrop-color:var(--scrim);--box-shadow:var(--shadow-color);--text-shadow:var(--shadow-color);--border-color:var(--border-strong);--delimiter-color:var(--border-subtle);--links-color:var(--text-link);--links-hover-color:var(--text-link-hover);--font-family:var(--font-body);--font-family-sans:var(--font-body);--font-family-display:var(--font-display);--font-family-mono:var(--font-mono);--header-background-color:var(--surface-raised);--header-border-bottom-color:var(--border-subtle);--header-color:var(--text-strong);--header-font-weight:var(--header-weight);--button-default-background-color:var(--surface-raised);--button-default-border-color:var(--border-default);--button-default-color:var(--text-default);--button-default-hover-background-color:var(--control-hover);--button-default-hover-border-color:var(--field-border-hover);--button-default-hover-color:var(--text-strong);--button-ghost-background-color:transparent;--button-ghost-border-color:transparent;--button-ghost-color:var(--text-soft);--button-ghost-hover-background-color:var(--control-hover);--button-ghost-hover-border-color:transparent;--button-ghost-hover-color:var(--text-strong);--button-plain-color:var(--text-soft);--button-plain-hover-color:var(--text-strong);--button-info-background-color:var(--tone-accent-solid);--button-info-border-color:var(--tone-accent-solid);--button-info-color:var(--tone-accent-on-solid);--button-info-hover-background-color:var(--tone-accent-solid-hover);--button-info-hover-border-color:var(--tone-accent-solid-hover);--button-info-hover-color:var(--tone-accent-on-solid);--toast-info-background-color:#c66f22;--toast-info-border-color:color-mix(in oklab, #c66f22 75%, #fff8e9);--toast-info-color:#fff8e9;--progress-info-bar-border-color:var(--tone-accent-solid);--progress-info-bar-fill-color:var(--tone-accent-solid);--rating-color-info:var(--tone-accent-solid);--card-tint-info-background:var(--tone-accent-soft);--button-success-background-color:var(--tone-success-solid);--button-success-border-color:var(--tone-success-solid);--button-success-color:var(--tone-success-on-solid);--button-success-hover-background-color:var(--tone-success-solid-hover);--button-success-hover-border-color:var(--tone-success-solid-hover);--button-success-hover-color:var(--tone-success-on-solid);--toast-success-background-color:#3f7d45;--toast-success-border-color:color-mix(in oklab, #3f7d45 75%, #fff8e9);--toast-success-color:#fff8e9;--progress-success-bar-border-color:var(--tone-success-solid);--progress-success-bar-fill-color:var(--tone-success-solid);--rating-color-success:var(--tone-success-solid);--card-tint-success-background:var(--tone-success-soft);--button-warning-background-color:var(--tone-warning-solid);--button-warning-border-color:var(--tone-warning-solid);--button-warning-color:var(--tone-warning-on-solid);--button-warning-hover-background-color:var(--tone-warning-solid-hover);--button-warning-hover-border-color:var(--tone-warning-solid-hover);--button-warning-hover-color:var(--tone-warning-on-solid);--toast-warning-background-color:#b68432;--toast-warning-border-color:color-mix(in oklab, #b68432 75%, #fff8e9);--toast-warning-color:#fff8e9;--progress-warning-bar-border-color:var(--tone-warning-solid);--progress-warning-bar-fill-color:var(--tone-warning-solid);--rating-color-warning:var(--tone-warning-solid);--card-tint-warning-background:var(--tone-warning-soft);--button-danger-background-color:var(--tone-danger-solid);--button-danger-border-color:var(--tone-danger-solid);--button-danger-color:var(--tone-danger-on-solid);--button-danger-hover-background-color:var(--tone-danger-solid-hover);--button-danger-hover-border-color:var(--tone-danger-solid-hover);--button-danger-hover-color:var(--tone-danger-on-solid);--toast-danger-background-color:#9f2f2f;--toast-danger-border-color:color-mix(in oklab, #9f2f2f 75%, #fff8e9);--toast-danger-color:#fff8e9;--progress-danger-bar-border-color:var(--tone-danger-solid);--progress-danger-bar-fill-color:var(--tone-danger-solid);--rating-color-danger:var(--tone-danger-solid);--card-tint-danger-background:var(--tone-danger-soft);--progress-bar-background-color:var(--surface-sunken);--progress-bar-color:var(--text-default);--progress-default-bar-border-color:var(--border-strong);--progress-default-bar-fill-color:var(--tone-neutral-solid);--rating-empty-color:var(--rating-empty);--rating-empty-label-color:var(--text-muted);--rating-half-rate-empty-color:var(--rating-empty);--card-tint-default-background:var(--surface-raised-alt);--card-accent-color:var(--tone-accent-text);--card-backdrop-filter:var(--surface-blur);--card-background-accent-color:var(--surface-raised-alt);--card-background-color:var(--surface-card);--card-border-accent-color:var(--tone-accent-solid);--card-border-color:var(--border-card);--card-box-shadow:var(--shadow-md);--card-color:var(--text-default);--card-footer-background-color:var(--surface-raised-alt);--card-footer-color:var(--text-soft);--card-hover-border-color:var(--border-card-hover);--card-surface-box-shadow:var(--shadow-sm);--card-title-color:var(--text-strong);--card-title-font-family:var(--font-display);--card-title-font-size:var(--display-size);--card-title-font-style:var(--display-style);--card-title-font-weight:var(--display-weight);--card-title-letter-spacing:var(--display-tracking);--card-title-text-transform:var(--display-transform);--modal-backdrop-filter:var(--surface-blur);--modal-background-color:var(--surface-overlay-card);--modal-body-color:var(--text-default);--modal-border-color:var(--border-card);--modal-box-shadow:var(--shadow-lg);--modal-box-shadow-hover:var(--shadow-lg);--modal-color:var(--text-default);--modal-footer-background-color:var(--surface-raised-alt);--modal-header-background-color:var(--surface-raised-alt);--modal-header-color:var(--text-strong);--modal-surface-box-shadow:var(--shadow-lg);--modal-title-color:var(--text-strong);--modal-title-font-family:var(--font-body);--modal-title-font-size:var(--font-size-sm);--modal-title-font-style:normal;--modal-title-font-weight:500;--modal-title-letter-spacing:0.18em;--modal-title-text-transform:uppercase;--drawer-background-color:var(--surface-overlay-card);--drawer-header-background-color:var(--surface-raised-alt);--drawer-border-color:var(--border-card);--drawer-shadow:var(--shadow-lg);--form-control-background-color:var(--field-bg);--form-control-border-color:var(--field-border);--form-control-color:var(--field-fg);--form-control-focus-background-color:var(--field-bg-focus);--form-control-focus-border-color:var(--field-border-focus);--form-control-focus-color:var(--field-fg);--form-control-focus-ring:var(--field-ring);--form-control-error-background-color:color-mix(in oklab, var(--tone-danger-solid) 6%, var(--field-bg));--form-control-error-border-color:var(--tone-danger-solid);--form-control-error-color:var(--tone-danger-text);--form-control-success-background-color:color-mix(in oklab, var(--tone-success-solid) 7%, var(--field-bg));--form-control-success-border-color:var(--tone-success-solid);--form-control-success-color:var(--tone-success-text);--form-control-font-family:var(--font-body);--form-control-label-color:var(--field-label);--form-control-label-font-size:var(--font-size-xs);--form-control-label-font-weight:var(--label-weight);--form-control-label-letter-spacing:var(--label-tracking);--form-control-label-text-transform:var(--label-transform);--form-control-placeholder-color:var(--field-placeholder);--form-control-selection-background-color:var(--selected-solid);--form-control-selection-border-color:var(--selected-solid);--form-control-selection-color:var(--selected-solid-fg);--form-control-selection-label-color:var(--text-default);--datepicker-input-background-color:var(--field-bg);--dropdown-border-color:var(--field-border);--dropdown-header-background-color:var(--field-bg);--dropdown-header-border-focus-color:var(--field-border-focus);--dropdown-header-color:var(--field-fg);--dropdown-options-background-color:var(--surface-overlay);--dropdown-options-color:var(--text-default);--dropdown-options-hover-background-color:var(--surface-hover);--dropdown-options-hover-color:var(--text-strong);--dropdown-options-selected-background-color:var(--surface-selected);--dropdown-options-selected-color:var(--text-strong);--dropdown-action-background-color:var(--surface-raised-alt);--dropdown-action-color:var(--text-link);--dropdown-action-hover-background-color:var(--surface-hover);--dropdown-action-hover-color:var(--text-link-hover);--dropdown-chips-background-color:var(--selected-bg);--dropdown-chips-border-color:var(--selected-border);--dropdown-chips-color:var(--selected-fg);--dropdown-chips-hover-background-color:var(--selected-bg-hover);--slider-track-background-color:var(--surface-sunken);--slider-track-border-color:var(--field-border);--slider-track-hover-background-color:var(--control-hover);--slider-track-hover-border-color:var(--field-border-hover);--slider-thumb-background-color:var(--tone-accent-solid);--slider-thumb-border-color:var(--tone-accent-solid);--slider-thumb-hover-background-color:var(--tone-accent-solid-hover);--slider-thumb-hover-border-color:var(--tone-accent-solid-hover);--calendar-background-color:var(--surface-overlay);--calendar-border-color:var(--border-default);--calendar-day-color:var(--text-soft);--calendar-day-disabled-color:var(--text-subtle);--calendar-day-hover-background-color:var(--control-hover);--calendar-day-selected-background-color:var(--tone-accent-solid);--calendar-day-selected-color:var(--tone-accent-on-solid);--calendar-day-today-border-color:var(--tone-accent-solid);--calendar-day-weekend-color:var(--text-muted);--calendar-header-background-color:var(--surface-raised-alt);--calendar-header-color:var(--text-strong);--chip-hover-background-color:var(--surface-hover);--chip-hover-border-color:var(--border-strong);--chip-hover-color:var(--text-strong);--chip-selected-background-color:var(--selected-bg);--chip-selected-border-color:var(--selected-border);--chip-selected-color:var(--selected-fg);--chip-selected-count-color:color-mix(in oklab, var(--selected-fg) 72%, transparent);--list-alternate-background-color:var(--surface-stripe);--list-hover-background-color:var(--surface-hover);--tabs-active-background-color:var(--selected-bg);--tabs-active-color:var(--selected-fg);--tabs-inactive-background-color:transparent;--tabs-inactive-color:var(--text-muted);--tooltip-background-color:var(--tone-neutral-solid);--tooltip-border-color:var(--tone-neutral-solid);--tooltip-color:var(--tone-neutral-on-solid);--popover-background-color:var(--surface-overlay);--popover-border-color:var(--border-default);--popover-color:var(--text-default);--popover-arrow-color:var(--border-default);--loader-border-color:var(--tone-accent-soft);--loader-border-top-color:var(--tone-accent-solid);--tour-hud-accent-color:var(--tone-accent-solid);--note-container-effect-background-color:var(--tone-accent-soft);--note-container-effect-color:var(--tone-accent-on-soft);--note-container-effect-border-left-color:var(--tone-accent-solid);--glow-box-shadow-color:0 0 16px color-mix(in oklab, var(--tone-accent-solid) 45%, transparent);--glow-hover-border-color:var(--tone-accent-border);--infuse-effect-before-background:linear-gradient(90deg, var(--tone-accent-solid), var(--accent-glow));--infuse-effect-hover-border-color:var(--tone-accent-solid);--infuse-effect-hover-box-shadow-color:color-mix(in oklab, var(--tone-accent-solid) 35%, transparent);--up-lift-effect-before-background:linear-gradient(135deg, var(--tone-accent-solid), var(--accent-glow));--up-lift-effect-box-shadow-color:var(--shadow-color-strong);--up-lift-effect-hover-border-color:var(--tone-accent-solid);--up-lift-effect-hover-box-shadow-color:color-mix(in oklab, var(--tone-accent-solid) 35%, transparent)}
+/*
+ * Component recipes for the authored themes. Badge and Chip take a tone and one shared set
+ * of roles (soft background, ink on soft, border), so a "success" badge, a selected
+ * "success" chip and a success toast carry the same three colours.
+ *
+ * These rules sit here rather than in @memobit/libs while the classic themes still drive
+ * the same components. Once the classic themes are retired they move into the lib.
+ */
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .badge-variant--default {
+    --recipe-soft: var(--tone-neutral-soft);
+    --recipe-soft-hover: var(--tone-neutral-soft-hover);
+    --recipe-on-soft: var(--tone-neutral-on-soft);
+    --recipe-border: var(--tone-neutral-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--info, .chip--info) {
+    --recipe-soft: var(--tone-accent-soft);
+    --recipe-soft-hover: var(--tone-accent-soft-hover);
+    --recipe-on-soft: var(--tone-accent-on-soft);
+    --recipe-border: var(--tone-accent-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--success, .chip--success) {
+    --recipe-soft: var(--tone-success-soft);
+    --recipe-soft-hover: var(--tone-success-soft-hover);
+    --recipe-on-soft: var(--tone-success-on-soft);
+    --recipe-border: var(--tone-success-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--warning, .chip--warning) {
+    --recipe-soft: var(--tone-warning-soft);
+    --recipe-soft-hover: var(--tone-warning-soft-hover);
+    --recipe-on-soft: var(--tone-warning-on-soft);
+    --recipe-border: var(--tone-warning-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] :is(.badge-variant--danger, .chip--danger) {
+    --recipe-soft: var(--tone-danger-soft);
+    --recipe-soft-hover: var(--tone-danger-soft-hover);
+    --recipe-on-soft: var(--tone-danger-on-soft);
+    --recipe-border: var(--tone-danger-border);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment']
+    .badge:is(.badge-variant--default, .badge-variant--info, .badge-variant--success, .badge-variant--warning, .badge-variant--danger) {
+    border-color: var(--recipe-border);
+    background-color: var(--recipe-soft);
+    color: var(--recipe-on-soft);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger) {
+    border-color: var(--border-default);
+    background: transparent;
+    color: var(--text-default);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger):hover:not(:disabled) {
+    border-color: var(--recipe-border);
+    background: var(--surface-hover);
+    color: var(--text-strong);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger).chip--selected {
+    border-color: var(--recipe-border);
+    background: var(--recipe-soft);
+    color: var(--recipe-on-soft);
+}
+
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip:is(.chip--default, .chip--info, .chip--success, .chip--warning, .chip--danger).chip--selected:hover:not(:disabled) {
+    border-color: var(--recipe-border);
+    background: var(--recipe-soft-hover);
+    color: var(--recipe-on-soft);
+}
+
+/* A default chip carries no tone, so its selected state is the theme's selection style. */
+:root[data-theme-engine='authored'][data-theme='sandy-parchment'] .chip.chip--default {
+    --recipe-soft: var(--selected-bg);
+    --recipe-soft-hover: var(--selected-bg-hover);
+    --recipe-on-soft: var(--selected-fg);
+    --recipe-border: var(--selected-border);
+}

package/dist/authoredEngine.d.ts

@@ -0,0 +1,11 @@
+/** Present on the root while the authored themes are on. Every authored rule is scoped to it. */
+export declare const THEME_ENGINE_ATTRIBUTE = "data-theme-engine";
+export declare const AUTHORED_ENGINE_VALUE = "authored";
+/**
+ * Switches `root` to the hand-made themes (`@memobit/themes/authored.css`). The theme itself
+ * stays whatever `data-theme` names; the authored version applies wherever one exists, and
+ * the classic theme shows through where it does not.
+ */
+export declare const applyAuthoredEngine: (root?: HTMLElement) => void;
+/** Hands `root` back to the classic themes. */
+export declare const clearAuthoredEngine: (root?: HTMLElement) => void;

package/dist/authoredEngine.js

@@ -0,0 +1,17 @@
+// src/authoredEngine.ts
+/** Present on the root while the authored themes are on. Every authored rule is scoped to it. */
+var THEME_ENGINE_ATTRIBUTE = "data-theme-engine";
+var AUTHORED_ENGINE_VALUE = "authored";
+/**
+* Switches `root` to the hand-made themes (`@memobit/themes/authored.css`). The theme itself
+* stays whatever `data-theme` names; the authored version applies wherever one exists, and
+* the classic theme shows through where it does not.
+*/
+var applyAuthoredEngine = (root = document.documentElement) => {
+	root.setAttribute(THEME_ENGINE_ATTRIBUTE, AUTHORED_ENGINE_VALUE);
+};
+/** Hands `root` back to the classic themes. */
+var clearAuthoredEngine = (root = document.documentElement) => {
+	root.removeAttribute(THEME_ENGINE_ATTRIBUTE);
+};
+export { AUTHORED_ENGINE_VALUE, THEME_ENGINE_ATTRIBUTE, applyAuthoredEngine, clearAuthoredEngine };

package/dist/authoredThemes.d.ts

@@ -0,0 +1,4 @@
+export declare const AUTHORED_THEMES: readonly [{
+    readonly id: "sandy-parchment";
+    readonly label: "Sandy Parchment";
+}];

package/dist/authoredThemes.js

@@ -0,0 +1,6 @@
+// src/authoredThemes.ts
+var AUTHORED_THEMES = [{
+	id: "sandy-parchment",
+	label: "Sandy Parchment"
+}];
+export { AUTHORED_THEMES };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { applyAuthoredEngine, AUTHORED_ENGINE_VALUE, clearAuthoredEngine, THEME_ENGINE_ATTRIBUTE } from './authoredEngine';
+export { AUTHORED_THEMES } from './authoredThemes';
 export { previewPalettes, type PreviewToken } from './previewPalettes';
 export { FAVORITE_THEMES, getThemeAppearance, getThemeConfig, LIGHT_THEMES, THEME_CONFIGS, type ThemeAppearance, type ThemeConfig } from './themeConfig';
 /** Where the Vite plugin writes each theme's stylesheet, relative to the app's base URL. */

package/dist/index.js

@@ -1,7 +1,8 @@
+import { AUTHORED_ENGINE_VALUE, THEME_ENGINE_ATTRIBUTE, applyAuthoredEngine, clearAuthoredEngine } from "./authoredEngine.js";
+import { AUTHORED_THEMES } from "./authoredThemes.js";
 import { previewPalettes } from "./previewPalettes.js";
 import { FAVORITE_THEMES, LIGHT_THEMES, THEME_CONFIGS, getThemeAppearance, getThemeConfig } from "./themeConfig.js";
-//#region src/index.ts
+// src/index.ts
 /** Where the Vite plugin writes each theme's stylesheet, relative to the app's base URL. */
 var THEME_ASSET_DIR = "memobit-themes";
-//#endregion
-export { FAVORITE_THEMES, LIGHT_THEMES, THEME_ASSET_DIR, THEME_CONFIGS, getThemeAppearance, getThemeConfig, previewPalettes };
+export { AUTHORED_ENGINE_VALUE, AUTHORED_THEMES, FAVORITE_THEMES, LIGHT_THEMES, THEME_ASSET_DIR, THEME_CONFIGS, THEME_ENGINE_ATTRIBUTE, applyAuthoredEngine, clearAuthoredEngine, getThemeAppearance, getThemeConfig, previewPalettes };