@eifi1/ui-kit 0.32.2 → 0.33.1

package/dist/shell/top-bar-brand.d.ts

@@ -1,19 +1,24 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { e1 as KitLinkProps, e0 as KitLinkComponent } from '../delete-account-setting-Dy4kJgUm.js';
+import { e2 as KitLinkProps, e1 as KitLinkComponent } from '../delete-account-setting-DAgGBrbn.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';
-import '../data-table-labels-kpAAVi6g.js';
+import '../data-table-labels-BJ5JE_X2.js';
 import '../components/data-table-sort.js';
 import '../components/swipeable-row.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../components/stat-tile.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-parts.js';
+import '../components/write-lock.js';
 import '../components/mini-calendar.js';
 import '../components/calendar-heatmap.js';
 import '../components/popover.js';
 import '../hooks/use-breakpoint.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
 import '../components/field-sync.js';
 import '../wizard/types.js';
 import '../tour/tour.js';
@@ -25,7 +30,6 @@ import '../components/page-contents.js';
 import '../components/series-chart-labels.js';
 import '../components/pie-chart-labels.js';
 import '../components/sparkline.js';
-import '../components/stat-tile.js';
 import '../components/signature-pad.js';
 import '../components/password-strength.js';
 import '../components/swatch-picker.js';
@@ -37,9 +41,6 @@ import '../hooks/use-search-param-state.js';
 import '../components/measured-grid.js';
 import '../components/user-avatar.js';
 import '../lib/person-name.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
 import './topbar-action-menu.js';
 import '../components/menu-item.js';
 import '../components/floating-panel.js';
@@ -55,7 +56,6 @@ import '../components/error-boundary.js';
 import '../components/authed-image.js';
 import '../components/image-grid.js';
 import '../components/lightbox.js';
-import '../components/write-lock.js';
 import '../auth/sign-in-form.js';
 import '../landing/access.js';
 import '../landing/landing-labels.js';
@@ -82,6 +82,7 @@ import '../admin/admin-parts.js';
 import '../admin/admin-action-log.js';
 import '../settings/settings-labels.js';
 import '../demo/demo-labels.js';
+import '../i18n/plurals.js';
 import '../components/appearance-labels.js';
 import '../theme/contrast.js';
 import '../theme/text-size.js';

package/dist/shell/topbar-action-menu.d.ts

@@ -13,6 +13,7 @@ import '../components/field-parts.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';
+import '../components/write-lock.js';
 
 /**
  * One row of a {@link TopBarActionMenu}. An `action` (default) runs `onSelect`, a

package/dist/shell.d.ts

@@ -1,6 +1,6 @@
 export { LanguageMenu, LanguageOption, PaletteMenu, TOPBAR_MENU_ITEM_CLASS, TOPBAR_TRIGGER_CLASS, ThemeToggle } from './shell/topbar-controls.js';
 export { TopBar, TopBarProps } from './shell/top-bar.js';
-export { bA as AppShell, bC as AppShellMoreLabels, bD as AppShellNavItem, bE as AppShellProps, bF as AppShellSidebarFooterItem, bG as AppShellSubItem, co as DEFAULT_APP_SHELL_MORE_LABELS, cG as DEFAULT_MOBILE_BAR_MAX, fZ as splitMobileBar } from './delete-account-setting-Dy4kJgUm.js';
+export { bA as AppShell, bC as AppShellMoreLabels, bD as AppShellNavItem, bE as AppShellProps, bF as AppShellSidebarFooterItem, bG as AppShellSubItem, co as DEFAULT_APP_SHELL_MORE_LABELS, cG as DEFAULT_MOBILE_BAR_MAX, ga as splitMobileBar } from './delete-account-setting-DAgGBrbn.js';
 export { OptionSwitcherMenu, OptionSwitcherOption } from './shell/option-switcher-menu.js';
 export { RoleSwitcher, RoleSwitcherProps } from './shell/role-switcher.js';
 export { TopBarActionMenu, TopBarMenuEntry, TopBarMenuHeader } from './shell/topbar-action-menu.js';
@@ -24,16 +24,21 @@ import 'zustand';
 import './components/tooltip.js';
 import './hooks/use-anchored-rect.js';
 import './lib/clipping.js';
-import './data-table-labels-kpAAVi6g.js';
+import './data-table-labels-BJ5JE_X2.js';
 import './components/data-table-sort.js';
 import './components/swipeable-row.js';
+import './components/status-dot.js';
+import './components/progress-bar.js';
+import './components/signed-amount.js';
+import './components/stat-tile.js';
+import './components/chip.js';
+import 'lucide-react';
+import './components/field-parts.js';
+import './components/write-lock.js';
 import './components/mini-calendar.js';
 import './components/calendar-heatmap.js';
 import './components/popover.js';
 import './hooks/use-breakpoint.js';
-import './components/chip.js';
-import 'lucide-react';
-import './components/field-parts.js';
 import './components/field-sync.js';
 import './wizard/types.js';
 import './tour/tour.js';
@@ -45,7 +50,6 @@ import './components/page-contents.js';
 import './components/series-chart-labels.js';
 import './components/pie-chart-labels.js';
 import './components/sparkline.js';
-import './components/stat-tile.js';
 import './components/signature-pad.js';
 import './components/password-strength.js';
 import './components/swatch-picker.js';
@@ -57,9 +61,6 @@ import './hooks/use-search-param-state.js';
 import './components/measured-grid.js';
 import './components/user-avatar.js';
 import './lib/person-name.js';
-import './components/status-dot.js';
-import './components/progress-bar.js';
-import './components/signed-amount.js';
 import './components/floating-panel.js';
 import './hooks/use-authed-src.js';
 import './components/account-settings-labels.js';
@@ -73,7 +74,6 @@ import './components/error-boundary.js';
 import './components/authed-image.js';
 import './components/image-grid.js';
 import './components/lightbox.js';
-import './components/write-lock.js';
 import './auth/sign-in-form.js';
 import './landing/access.js';
 import './landing/landing-labels.js';
@@ -94,6 +94,7 @@ import './admin/admin-parts.js';
 import './admin/admin-action-log.js';
 import './settings/settings-labels.js';
 import './demo/demo-labels.js';
+import './i18n/plurals.js';
 import './components/appearance-labels.js';
 import './theme/contrast.js';
 import './theme/text-size.js';

package/dist/testing/css-variables.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The guard against an undeclared CSS custom property (0.33,
+ * docs/colour-roles-harmonization.md §8, §12.5).
+ *
+ * A `var(--name)` with no fallback, where nothing declares `--name`, makes the whole
+ * declaration invalid at computed-value time: `fill` inherits, `color` inherits, a
+ * background goes transparent. Kurvenschmiede's control diagram painted
+ * `fill-[var(--surface)]` — a token that never existed (the kit's is `--bg-surface`) —
+ * and drew black boxes on a public page. The class compiled, the build passed, the type
+ * checker had no opinion, and nothing in any suite noticed. This is the check that
+ * notices, run from an app's own test over the source texts the app collects.
+ *
+ * Browser-safe on purpose, like the rest of the kit: it takes TEXTS, not paths, so an app
+ * reads its files however its setup allows (`import.meta.glob` with `?raw`, or `node:fs`)
+ * and the kit carries no `node:fs`.
+ */
+/** Every custom property the installed kit declares or publishes to apps.
+ *
+ *  Generated from `tokens.css` when the kit is built (scripts/gen-kit-css-variables.mjs),
+ *  so it is always the installed version's, and an app never searches `node_modules`.
+ *  It leaves out two kinds of name on purpose:
+ *  - a name declared only in an `@theme inline` block (`--text-color-muted`,
+ *    `--background-color-surface`): Tailwind emits no variable for it, so
+ *    `var(--text-color-muted)` would pass a guard that counted it and paint nothing;
+ *  - AppShell's measured `--app-nav-h`, which exists only while an AppShell is mounted —
+ *    on a landing, legal, sign-in or pay page it is undefined. Read it with a fallback,
+ *    `var(--app-nav-h,0px)`, as every kit read does.
+ *  Everything `applyTokenSet` and More contrast write on `<html>` is in, through the
+ *  stylesheet's `:root` / `.dark` mirror. Component internals (`--slider-fill`, `--fp-*`,
+ *  `--icon-button-tone`, `--label-strip-edge`) are not: an app that reads one depends on
+ *  the kit's internals, and the guard says so. */
+declare const KIT_CSS_VARIABLES: ReadonlySet<string>;
+interface UndeclaredCssVariablesOptions {
+    /** Variables a library writes at runtime, as names or patterns:
+     *  `["--radix-collapsible-content-height"]`. An app's own writes are found in its
+     *  source and need no listing. */
+    runtime?: readonly (string | RegExp)[];
+    /** Also check `var(--x, …)`. Off by default: a fallback says what happens when the
+     *  name is missing. `--app-nav-h` counts as declared only here. */
+    checkFallbacks?: boolean;
+    /** Report Tailwind palette variables (`--color-red-500`, `--color-white`) although
+     *  they resolve. Default false. */
+    refusePalette?: boolean;
+}
+/**
+ * Every custom property a stylesheet declares (`--name:`), in any block — except a name
+ * declared only inside `@theme inline`, which Tailwind never emits as a variable. Comments
+ * are skipped. The same rule builds {@link KIT_CSS_VARIABLES} from `tokens.css`.
+ */
+declare function declaredCustomProperties(css: string): Set<string>;
+/**
+ * Every `var(--name)` without a fallback that nothing declares, as `"path:line --name"`.
+ *
+ * `sources` maps a path to its text: the app's `.ts`, `.tsx` and `.css` source, tests
+ * left out. A name counts as declared when it is:
+ * 1. the kit's ({@link KIT_CSS_VARIABLES});
+ * 2. declared in any `.css` entry of `sources` (outside `@theme inline`);
+ * 3. written by the source at runtime (`setProperty`, a style key, `[--name:…]`);
+ * 4. one of Tailwind's theme variables — unless `refusePalette` and it is a palette colour;
+ * 5. a chart series' `--color-<key>`, in a file with a `<key>: {` entry;
+ * 6. listed in `options.runtime`.
+ *
+ * Not counted: comments; a use with a fallback, unless `checkFallbacks`; a name built at
+ * runtime (`` `var(--chart-${n})` `` — a name must be followed by `)` or `,`).
+ *
+ * It REFUSES A VACUOUS RUN: it throws when `sources` holds fewer than ten files, or when
+ * a `.css` entry is empty. Vitest stubs every stylesheet with an empty string by default,
+ * `?raw` included, so an app that reads its CSS that way without opting it out of the stub
+ * (`test.css.include`) would otherwise lose every declaration and every use in it, and
+ * this would pass or fail for the wrong reason.
+ */
+declare function undeclaredCssVariables(sources: Record<string, string>, options?: UndeclaredCssVariablesOptions): string[];
+
+export { KIT_CSS_VARIABLES, type UndeclaredCssVariablesOptions, declaredCustomProperties, undeclaredCssVariables };

package/dist/testing/css-variables.generated.d.ts

@@ -0,0 +1,7 @@
+/** Every custom property tokens.css declares, `@theme inline` names and `--app-nav-h`
+ *  left out (100 names). */
+declare const KIT_NAMES: string;
+/** The theme variables of Tailwind 4.3.3's `theme.css` (413 names). */
+declare const TAILWIND_THEME_NAMES: string;
+
+export { KIT_NAMES, TAILWIND_THEME_NAMES };

package/dist/testing/css-variables.generated.js

@@ -0,0 +1,8 @@
+"use client";
+const KIT_NAMES = "--bg-active --bg-hover --bg-inverse --bg-page --bg-surface --bg-surface-2 --border --border-strong --brand --brand-bg --brand-bg-hover --brand-contrast --brand-hover --brand-muted --breakpoint-3xl --chart-1 --chart-2 --chart-3 --chart-4 --chart-5 --chart-6 --chart-7 --chart-8 --chart-9 --danger --danger-bg --danger-border --danger-border-strong --danger-contrast --danger-hover --flyout-from --focus-ring-width --hue-blue --hue-blue-bg --hue-blue-border --hue-blue-contrast --hue-indigo --hue-indigo-bg --hue-indigo-border --hue-indigo-contrast --hue-orange --hue-orange-bg --hue-orange-border --hue-orange-contrast --hue-purple --hue-purple-bg --hue-purple-border --hue-purple-contrast --hue-teal --hue-teal-bg --hue-teal-border --hue-teal-contrast --info --info-bg --info-border --info-contrast --media-ink --media-scrim --media-scrim-hover --money-expense --money-expense-contrast --money-income --money-income-contrast --money-net --money-net-contrast --money-neutral --money-neutral-contrast --neutral --neutral-contrast --status-edited --status-error --status-pending --status-synced --success --success-bg --success-border --success-contrast --text-caption --text-inverse --text-micro --text-muted --text-placeholder --text-primary --text-secondary --toast-action-bg --toast-action-fg --toast-danger-bg --toast-danger-border --toast-info-bg --toast-info-border --toast-success-bg --toast-success-border --toast-warning-bg --toast-warning-border --warning --warning-bg --warning-border --warning-border-strong --warning-contrast --z-toast";
+const TAILWIND_THEME_NAMES = "--animate-bounce --animate-ping --animate-pulse --animate-spin --aspect-video --blur-2xl --blur-3xl --blur-lg --blur-md --blur-sm --blur-xl --blur-xs --breakpoint-2xl --breakpoint-lg --breakpoint-md --breakpoint-sm --breakpoint-xl --color-amber-100 --color-amber-200 --color-amber-300 --color-amber-400 --color-amber-50 --color-amber-500 --color-amber-600 --color-amber-700 --color-amber-800 --color-amber-900 --color-amber-950 --color-black --color-blue-100 --color-blue-200 --color-blue-300 --color-blue-400 --color-blue-50 --color-blue-500 --color-blue-600 --color-blue-700 --color-blue-800 --color-blue-900 --color-blue-950 --color-cyan-100 --color-cyan-200 --color-cyan-300 --color-cyan-400 --color-cyan-50 --color-cyan-500 --color-cyan-600 --color-cyan-700 --color-cyan-800 --color-cyan-900 --color-cyan-950 --color-emerald-100 --color-emerald-200 --color-emerald-300 --color-emerald-400 --color-emerald-50 --color-emerald-500 --color-emerald-600 --color-emerald-700 --color-emerald-800 --color-emerald-900 --color-emerald-950 --color-fuchsia-100 --color-fuchsia-200 --color-fuchsia-300 --color-fuchsia-400 --color-fuchsia-50 --color-fuchsia-500 --color-fuchsia-600 --color-fuchsia-700 --color-fuchsia-800 --color-fuchsia-900 --color-fuchsia-950 --color-gray-100 --color-gray-200 --color-gray-300 --color-gray-400 --color-gray-50 --color-gray-500 --color-gray-600 --color-gray-700 --color-gray-800 --color-gray-900 --color-gray-950 --color-green-100 --color-green-200 --color-green-300 --color-green-400 --color-green-50 --color-green-500 --color-green-600 --color-green-700 --color-green-800 --color-green-900 --color-green-950 --color-indigo-100 --color-indigo-200 --color-indigo-300 --color-indigo-400 --color-indigo-50 --color-indigo-500 --color-indigo-600 --color-indigo-700 --color-indigo-800 --color-indigo-900 --color-indigo-950 --color-lime-100 --color-lime-200 --color-lime-300 --color-lime-400 --color-lime-50 --color-lime-500 --color-lime-600 --color-lime-700 --color-lime-800 --color-lime-900 --color-lime-950 --color-mauve-100 --color-mauve-200 --color-mauve-300 --color-mauve-400 --color-mauve-50 --color-mauve-500 --color-mauve-600 --color-mauve-700 --color-mauve-800 --color-mauve-900 --color-mauve-950 --color-mist-100 --color-mist-200 --color-mist-300 --color-mist-400 --color-mist-50 --color-mist-500 --color-mist-600 --color-mist-700 --color-mist-800 --color-mist-900 --color-mist-950 --color-neutral-100 --color-neutral-200 --color-neutral-300 --color-neutral-400 --color-neutral-50 --color-neutral-500 --color-neutral-600 --color-neutral-700 --color-neutral-800 --color-neutral-900 --color-neutral-950 --color-olive-100 --color-olive-200 --color-olive-300 --color-olive-400 --color-olive-50 --color-olive-500 --color-olive-600 --color-olive-700 --color-olive-800 --color-olive-900 --color-olive-950 --color-orange-100 --color-orange-200 --color-orange-300 --color-orange-400 --color-orange-50 --color-orange-500 --color-orange-600 --color-orange-700 --color-orange-800 --color-orange-900 --color-orange-950 --color-pink-100 --color-pink-200 --color-pink-300 --color-pink-400 --color-pink-50 --color-pink-500 --color-pink-600 --color-pink-700 --color-pink-800 --color-pink-900 --color-pink-950 --color-purple-100 --color-purple-200 --color-purple-300 --color-purple-400 --color-purple-50 --color-purple-500 --color-purple-600 --color-purple-700 --color-purple-800 --color-purple-900 --color-purple-950 --color-red-100 --color-red-200 --color-red-300 --color-red-400 --color-red-50 --color-red-500 --color-red-600 --color-red-700 --color-red-800 --color-red-900 --color-red-950 --color-rose-100 --color-rose-200 --color-rose-300 --color-rose-400 --color-rose-50 --color-rose-500 --color-rose-600 --color-rose-700 --color-rose-800 --color-rose-900 --color-rose-950 --color-sky-100 --color-sky-200 --color-sky-300 --color-sky-400 --color-sky-50 --color-sky-500 --color-sky-600 --color-sky-700 --color-sky-800 --color-sky-900 --color-sky-950 --color-slate-100 --color-slate-200 --color-slate-300 --color-slate-400 --color-slate-50 --color-slate-500 --color-slate-600 --color-slate-700 --color-slate-800 --color-slate-900 --color-slate-950 --color-stone-100 --color-stone-200 --color-stone-300 --color-stone-400 --color-stone-50 --color-stone-500 --color-stone-600 --color-stone-700 --color-stone-800 --color-stone-900 --color-stone-950 --color-taupe-100 --color-taupe-200 --color-taupe-300 --color-taupe-400 --color-taupe-50 --color-taupe-500 --color-taupe-600 --color-taupe-700 --color-taupe-800 --color-taupe-900 --color-taupe-950 --color-teal-100 --color-teal-200 --color-teal-300 --color-teal-400 --color-teal-50 --color-teal-500 --color-teal-600 --color-teal-700 --color-teal-800 --color-teal-900 --color-teal-950 --color-violet-100 --color-violet-200 --color-violet-300 --color-violet-400 --color-violet-50 --color-violet-500 --color-violet-600 --color-violet-700 --color-violet-800 --color-violet-900 --color-violet-950 --color-white --color-yellow-100 --color-yellow-200 --color-yellow-300 --color-yellow-400 --color-yellow-50 --color-yellow-500 --color-yellow-600 --color-yellow-700 --color-yellow-800 --color-yellow-900 --color-yellow-950 --color-zinc-100 --color-zinc-200 --color-zinc-300 --color-zinc-400 --color-zinc-50 --color-zinc-500 --color-zinc-600 --color-zinc-700 --color-zinc-800 --color-zinc-900 --color-zinc-950 --container-2xl --container-2xs --container-3xl --container-3xs --container-4xl --container-5xl --container-6xl --container-7xl --container-lg --container-md --container-sm --container-xl --container-xs --default-font-family --default-font-feature-settings --default-font-variation-settings --default-mono-font-family --default-mono-font-feature-settings --default-mono-font-variation-settings --default-transition-duration --default-transition-timing-function --drop-shadow-2xl --drop-shadow-lg --drop-shadow-md --drop-shadow-sm --drop-shadow-xl --drop-shadow-xs --ease-in --ease-in-out --ease-out --font-mono --font-sans --font-serif --font-weight-black --font-weight-bold --font-weight-extrabold --font-weight-extralight --font-weight-light --font-weight-medium --font-weight-normal --font-weight-semibold --font-weight-thin --inset-shadow-2xs --inset-shadow-sm --inset-shadow-xs --leading-loose --leading-normal --leading-relaxed --leading-snug --leading-tight --perspective-distant --perspective-dramatic --perspective-midrange --perspective-near --perspective-normal --radius-2xl --radius-3xl --radius-4xl --radius-lg --radius-md --radius-sm --radius-xl --radius-xs --shadow-2xl --shadow-2xs --shadow-lg --shadow-md --shadow-sm --shadow-xl --shadow-xs --spacing --text-2xl --text-2xl--line-height --text-3xl --text-3xl--line-height --text-4xl --text-4xl--line-height --text-5xl --text-5xl--line-height --text-6xl --text-6xl--line-height --text-7xl --text-7xl--line-height --text-8xl --text-8xl--line-height --text-9xl --text-9xl--line-height --text-base --text-base--line-height --text-lg --text-lg--line-height --text-shadow-2xs --text-shadow-lg --text-shadow-md --text-shadow-sm --text-shadow-xs --text-sm --text-sm--line-height --text-xl --text-xl--line-height --text-xs --text-xs--line-height --tracking-normal --tracking-tight --tracking-tighter --tracking-wide --tracking-wider --tracking-widest";
+export {
+  KIT_NAMES,
+  TAILWIND_THEME_NAMES
+};
+//# sourceMappingURL=css-variables.generated.js.map

package/dist/testing/css-variables.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/css-variables.generated.ts"],"sourcesContent":["// GENERATED by scripts/gen-kit-css-variables.mjs — do not edit by hand. Re-run it after\n// changing tokens.css or upgrading Tailwind; src/__tests__/token-vars-declared.test.ts\n// fails while this is stale.\n\n/** Every custom property tokens.css declares, `@theme inline` names and `--app-nav-h`\n *  left out (100 names). */\nexport const KIT_NAMES =\n  \"--bg-active --bg-hover --bg-inverse --bg-page --bg-surface --bg-surface-2 --border \" +\n  \"--border-strong --brand --brand-bg --brand-bg-hover --brand-contrast --brand-hover --brand-muted \" +\n  \"--breakpoint-3xl --chart-1 --chart-2 --chart-3 --chart-4 --chart-5 --chart-6 --chart-7 --chart-8 \" +\n  \"--chart-9 --danger --danger-bg --danger-border --danger-border-strong --danger-contrast \" +\n  \"--danger-hover --flyout-from --focus-ring-width --hue-blue --hue-blue-bg --hue-blue-border \" +\n  \"--hue-blue-contrast --hue-indigo --hue-indigo-bg --hue-indigo-border --hue-indigo-contrast \" +\n  \"--hue-orange --hue-orange-bg --hue-orange-border --hue-orange-contrast --hue-purple \" +\n  \"--hue-purple-bg --hue-purple-border --hue-purple-contrast --hue-teal --hue-teal-bg \" +\n  \"--hue-teal-border --hue-teal-contrast --info --info-bg --info-border --info-contrast --media-ink \" +\n  \"--media-scrim --media-scrim-hover --money-expense --money-expense-contrast --money-income \" +\n  \"--money-income-contrast --money-net --money-net-contrast --money-neutral \" +\n  \"--money-neutral-contrast --neutral --neutral-contrast --status-edited --status-error \" +\n  \"--status-pending --status-synced --success --success-bg --success-border --success-contrast \" +\n  \"--text-caption --text-inverse --text-micro --text-muted --text-placeholder --text-primary \" +\n  \"--text-secondary --toast-action-bg --toast-action-fg --toast-danger-bg --toast-danger-border \" +\n  \"--toast-info-bg --toast-info-border --toast-success-bg --toast-success-border --toast-warning-bg \" +\n  \"--toast-warning-border --warning --warning-bg --warning-border --warning-border-strong \" +\n  \"--warning-contrast --z-toast\";\n\n/** The theme variables of Tailwind 4.3.3's `theme.css` (413 names). */\nexport const TAILWIND_THEME_NAMES =\n  \"--animate-bounce --animate-ping --animate-pulse --animate-spin --aspect-video --blur-2xl \" +\n  \"--blur-3xl --blur-lg --blur-md --blur-sm --blur-xl --blur-xs --breakpoint-2xl --breakpoint-lg \" +\n  \"--breakpoint-md --breakpoint-sm --breakpoint-xl --color-amber-100 --color-amber-200 \" +\n  \"--color-amber-300 --color-amber-400 --color-amber-50 --color-amber-500 --color-amber-600 \" +\n  \"--color-amber-700 --color-amber-800 --color-amber-900 --color-amber-950 --color-black \" +\n  \"--color-blue-100 --color-blue-200 --color-blue-300 --color-blue-400 --color-blue-50 \" +\n  \"--color-blue-500 --color-blue-600 --color-blue-700 --color-blue-800 --color-blue-900 \" +\n  \"--color-blue-950 --color-cyan-100 --color-cyan-200 --color-cyan-300 --color-cyan-400 \" +\n  \"--color-cyan-50 --color-cyan-500 --color-cyan-600 --color-cyan-700 --color-cyan-800 \" +\n  \"--color-cyan-900 --color-cyan-950 --color-emerald-100 --color-emerald-200 --color-emerald-300 \" +\n  \"--color-emerald-400 --color-emerald-50 --color-emerald-500 --color-emerald-600 \" +\n  \"--color-emerald-700 --color-emerald-800 --color-emerald-900 --color-emerald-950 \" +\n  \"--color-fuchsia-100 --color-fuchsia-200 --color-fuchsia-300 --color-fuchsia-400 \" +\n  \"--color-fuchsia-50 --color-fuchsia-500 --color-fuchsia-600 --color-fuchsia-700 \" +\n  \"--color-fuchsia-800 --color-fuchsia-900 --color-fuchsia-950 --color-gray-100 --color-gray-200 \" +\n  \"--color-gray-300 --color-gray-400 --color-gray-50 --color-gray-500 --color-gray-600 \" +\n  \"--color-gray-700 --color-gray-800 --color-gray-900 --color-gray-950 --color-green-100 \" +\n  \"--color-green-200 --color-green-300 --color-green-400 --color-green-50 --color-green-500 \" +\n  \"--color-green-600 --color-green-700 --color-green-800 --color-green-900 --color-green-950 \" +\n  \"--color-indigo-100 --color-indigo-200 --color-indigo-300 --color-indigo-400 --color-indigo-50 \" +\n  \"--color-indigo-500 --color-indigo-600 --color-indigo-700 --color-indigo-800 --color-indigo-900 \" +\n  \"--color-indigo-950 --color-lime-100 --color-lime-200 --color-lime-300 --color-lime-400 \" +\n  \"--color-lime-50 --color-lime-500 --color-lime-600 --color-lime-700 --color-lime-800 \" +\n  \"--color-lime-900 --color-lime-950 --color-mauve-100 --color-mauve-200 --color-mauve-300 \" +\n  \"--color-mauve-400 --color-mauve-50 --color-mauve-500 --color-mauve-600 --color-mauve-700 \" +\n  \"--color-mauve-800 --color-mauve-900 --color-mauve-950 --color-mist-100 --color-mist-200 \" +\n  \"--color-mist-300 --color-mist-400 --color-mist-50 --color-mist-500 --color-mist-600 \" +\n  \"--color-mist-700 --color-mist-800 --color-mist-900 --color-mist-950 --color-neutral-100 \" +\n  \"--color-neutral-200 --color-neutral-300 --color-neutral-400 --color-neutral-50 \" +\n  \"--color-neutral-500 --color-neutral-600 --color-neutral-700 --color-neutral-800 \" +\n  \"--color-neutral-900 --color-neutral-950 --color-olive-100 --color-olive-200 --color-olive-300 \" +\n  \"--color-olive-400 --color-olive-50 --color-olive-500 --color-olive-600 --color-olive-700 \" +\n  \"--color-olive-800 --color-olive-900 --color-olive-950 --color-orange-100 --color-orange-200 \" +\n  \"--color-orange-300 --color-orange-400 --color-orange-50 --color-orange-500 --color-orange-600 \" +\n  \"--color-orange-700 --color-orange-800 --color-orange-900 --color-orange-950 --color-pink-100 \" +\n  \"--color-pink-200 --color-pink-300 --color-pink-400 --color-pink-50 --color-pink-500 \" +\n  \"--color-pink-600 --color-pink-700 --color-pink-800 --color-pink-900 --color-pink-950 \" +\n  \"--color-purple-100 --color-purple-200 --color-purple-300 --color-purple-400 --color-purple-50 \" +\n  \"--color-purple-500 --color-purple-600 --color-purple-700 --color-purple-800 --color-purple-900 \" +\n  \"--color-purple-950 --color-red-100 --color-red-200 --color-red-300 --color-red-400 \" +\n  \"--color-red-50 --color-red-500 --color-red-600 --color-red-700 --color-red-800 --color-red-900 \" +\n  \"--color-red-950 --color-rose-100 --color-rose-200 --color-rose-300 --color-rose-400 \" +\n  \"--color-rose-50 --color-rose-500 --color-rose-600 --color-rose-700 --color-rose-800 \" +\n  \"--color-rose-900 --color-rose-950 --color-sky-100 --color-sky-200 --color-sky-300 \" +\n  \"--color-sky-400 --color-sky-50 --color-sky-500 --color-sky-600 --color-sky-700 --color-sky-800 \" +\n  \"--color-sky-900 --color-sky-950 --color-slate-100 --color-slate-200 --color-slate-300 \" +\n  \"--color-slate-400 --color-slate-50 --color-slate-500 --color-slate-600 --color-slate-700 \" +\n  \"--color-slate-800 --color-slate-900 --color-slate-950 --color-stone-100 --color-stone-200 \" +\n  \"--color-stone-300 --color-stone-400 --color-stone-50 --color-stone-500 --color-stone-600 \" +\n  \"--color-stone-700 --color-stone-800 --color-stone-900 --color-stone-950 --color-taupe-100 \" +\n  \"--color-taupe-200 --color-taupe-300 --color-taupe-400 --color-taupe-50 --color-taupe-500 \" +\n  \"--color-taupe-600 --color-taupe-700 --color-taupe-800 --color-taupe-900 --color-taupe-950 \" +\n  \"--color-teal-100 --color-teal-200 --color-teal-300 --color-teal-400 --color-teal-50 \" +\n  \"--color-teal-500 --color-teal-600 --color-teal-700 --color-teal-800 --color-teal-900 \" +\n  \"--color-teal-950 --color-violet-100 --color-violet-200 --color-violet-300 --color-violet-400 \" +\n  \"--color-violet-50 --color-violet-500 --color-violet-600 --color-violet-700 --color-violet-800 \" +\n  \"--color-violet-900 --color-violet-950 --color-white --color-yellow-100 --color-yellow-200 \" +\n  \"--color-yellow-300 --color-yellow-400 --color-yellow-50 --color-yellow-500 --color-yellow-600 \" +\n  \"--color-yellow-700 --color-yellow-800 --color-yellow-900 --color-yellow-950 --color-zinc-100 \" +\n  \"--color-zinc-200 --color-zinc-300 --color-zinc-400 --color-zinc-50 --color-zinc-500 \" +\n  \"--color-zinc-600 --color-zinc-700 --color-zinc-800 --color-zinc-900 --color-zinc-950 \" +\n  \"--container-2xl --container-2xs --container-3xl --container-3xs --container-4xl --container-5xl \" +\n  \"--container-6xl --container-7xl --container-lg --container-md --container-sm --container-xl \" +\n  \"--container-xs --default-font-family --default-font-feature-settings \" +\n  \"--default-font-variation-settings --default-mono-font-family \" +\n  \"--default-mono-font-feature-settings --default-mono-font-variation-settings \" +\n  \"--default-transition-duration --default-transition-timing-function --drop-shadow-2xl \" +\n  \"--drop-shadow-lg --drop-shadow-md --drop-shadow-sm --drop-shadow-xl --drop-shadow-xs --ease-in \" +\n  \"--ease-in-out --ease-out --font-mono --font-sans --font-serif --font-weight-black \" +\n  \"--font-weight-bold --font-weight-extrabold --font-weight-extralight --font-weight-light \" +\n  \"--font-weight-medium --font-weight-normal --font-weight-semibold --font-weight-thin \" +\n  \"--inset-shadow-2xs --inset-shadow-sm --inset-shadow-xs --leading-loose --leading-normal \" +\n  \"--leading-relaxed --leading-snug --leading-tight --perspective-distant --perspective-dramatic \" +\n  \"--perspective-midrange --perspective-near --perspective-normal --radius-2xl --radius-3xl \" +\n  \"--radius-4xl --radius-lg --radius-md --radius-sm --radius-xl --radius-xs --shadow-2xl \" +\n  \"--shadow-2xs --shadow-lg --shadow-md --shadow-sm --shadow-xl --shadow-xs --spacing --text-2xl \" +\n  \"--text-2xl--line-height --text-3xl --text-3xl--line-height --text-4xl --text-4xl--line-height \" +\n  \"--text-5xl --text-5xl--line-height --text-6xl --text-6xl--line-height --text-7xl \" +\n  \"--text-7xl--line-height --text-8xl --text-8xl--line-height --text-9xl --text-9xl--line-height \" +\n  \"--text-base --text-base--line-height --text-lg --text-lg--line-height --text-shadow-2xs \" +\n  \"--text-shadow-lg --text-shadow-md --text-shadow-sm --text-shadow-xs --text-sm \" +\n  \"--text-sm--line-height --text-xl --text-xl--line-height --text-xs --text-xs--line-height \" +\n  \"--tracking-normal --tracking-tight --tracking-tighter --tracking-wide --tracking-wider \" +\n  \"--tracking-widest\";\n"],"mappings":";AAMO,MAAM,YACX;AAoBK,MAAM,uBACX;","names":[]}

package/dist/testing/css-variables.js

@@ -0,0 +1,93 @@
+"use client";
+import { KIT_NAMES, TAILWIND_THEME_NAMES } from "./css-variables.generated.js";
+const KIT_CSS_VARIABLES = new Set(KIT_NAMES.split(" "));
+const TAILWIND_THEME = new Set(TAILWIND_THEME_NAMES.split(" "));
+const PALETTE_VARIABLE = /^--color-(?:[a-z]+-\d{2,3}|black|white)$/;
+const APP_NAV_H = "--app-nav-h";
+function stripComments(text, isCss) {
+  const blank = (m) => m.replace(/[^\n]/g, " ");
+  const noBlocks = text.replace(/\/\*[\s\S]*?\*\//g, blank);
+  return isCss ? noBlocks : noBlocks.replace(/(^|[^:])(\/\/[^\n]*)/g, (_, pre, c) => pre + blank(c));
+}
+function withoutInlineTheme(css) {
+  let out = css;
+  for (const m of css.matchAll(/@theme\b[^{;]*\binline\b[^{;]*\{/g)) {
+    let depth = 0;
+    let end = m.index + m[0].length - 1;
+    for (; end < css.length; end++) {
+      if (css[end] === "{") depth++;
+      else if (css[end] === "}" && --depth === 0) break;
+    }
+    out = out.slice(0, m.index) + css.slice(m.index, end + 1).replace(/[^\n]/g, " ") + out.slice(end + 1);
+  }
+  return out;
+}
+function declaredCustomProperties(css) {
+  const code = withoutInlineTheme(stripComments(css, true));
+  return new Set([...code.matchAll(/(--[a-zA-Z0-9_-]+)\s*:/g)].map((m) => m[1]));
+}
+function runtimeWrites(code) {
+  return [
+    ...code.matchAll(/setProperty\(\s*["'`](--[a-zA-Z0-9_-]+)["'`]/g),
+    ...code.matchAll(/["'](--[a-zA-Z0-9_-]+)["']\s*:/g),
+    ...code.matchAll(/\[(--[a-zA-Z0-9_-]+):/g)
+  ].map((m) => m[1]);
+}
+function chartKeys(code) {
+  return new Set([...code.matchAll(/(?:^|[\s{,])["']?([A-Za-z_][\w-]*)["']?\s*:\s*\{/g)].map((m) => m[1]));
+}
+const isCssPath = (path) => /\.css(?:\?|$)/.test(path);
+function undeclaredCssVariables(sources, options = {}) {
+  const { runtime = [], checkFallbacks = false, refusePalette = false } = options;
+  const entries = Object.entries(sources);
+  if (entries.length < 10) {
+    throw new Error(
+      `undeclaredCssVariables: only ${entries.length} source file(s) \u2014 the glob or the file list found (almost) nothing, and a check over nothing passes. Pass the app's .ts/.tsx/.css source.`
+    );
+  }
+  const emptyCss = entries.filter(([path, text]) => isCssPath(path) && text.trim() === "").map(([path]) => path);
+  if (emptyCss.length) {
+    throw new Error(
+      `undeclaredCssVariables: ${emptyCss.join(", ")} read as empty. Vitest stubs stylesheets with "" (\`?raw\` too) unless the file is listed in \`test.css.include\`.`
+    );
+  }
+  const code = entries.map(([path, text]) => [path, stripComments(text, isCssPath(path))]);
+  const declared = /* @__PURE__ */ new Set();
+  for (const [path, text] of code) {
+    if (isCssPath(path)) for (const name of declaredCustomProperties(text)) declared.add(name);
+    for (const name of runtimeWrites(text)) declared.add(name);
+  }
+  const listed = (name) => runtime.some((r) => typeof r === "string" ? r === name : r.test(name));
+  const out = [];
+  for (const [path, text] of code) {
+    let keys = null;
+    for (const m of text.matchAll(/var\(\s*(--[a-zA-Z0-9_-]+)\s*([,)])/g)) {
+      const [, name, next] = m;
+      const fallback = next === ",";
+      if (fallback && !checkFallbacks) continue;
+      if (KIT_CSS_VARIABLES.has(name) || declared.has(name) || listed(name)) continue;
+      if (fallback && name === APP_NAV_H) continue;
+      if (TAILWIND_THEME.has(name)) {
+        if (refusePalette && PALETTE_VARIABLE.test(name)) {
+          out.push(`${path}:${lineOf(text, m.index)} ${name} (a Tailwind palette colour; refusePalette is on)`);
+        }
+        continue;
+      }
+      const chart = /^--color-([A-Za-z_][\w-]*)$/.exec(name);
+      if (chart && (keys ??= chartKeys(text)).has(chart[1])) continue;
+      out.push(`${path}:${lineOf(text, m.index)} ${name}`);
+    }
+  }
+  return out;
+}
+function lineOf(text, index) {
+  let line = 1;
+  for (let i = 0; i < index; i++) if (text.charCodeAt(i) === 10) line++;
+  return line;
+}
+export {
+  KIT_CSS_VARIABLES,
+  declaredCustomProperties,
+  undeclaredCssVariables
+};
+//# sourceMappingURL=css-variables.js.map

package/dist/testing/css-variables.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/css-variables.ts"],"sourcesContent":["import { KIT_NAMES, TAILWIND_THEME_NAMES } from \"./css-variables.generated\";\n\n/**\n * The guard against an undeclared CSS custom property (0.33,\n * docs/colour-roles-harmonization.md §8, §12.5).\n *\n * A `var(--name)` with no fallback, where nothing declares `--name`, makes the whole\n * declaration invalid at computed-value time: `fill` inherits, `color` inherits, a\n * background goes transparent. Kurvenschmiede's control diagram painted\n * `fill-[var(--surface)]` — a token that never existed (the kit's is `--bg-surface`) —\n * and drew black boxes on a public page. The class compiled, the build passed, the type\n * checker had no opinion, and nothing in any suite noticed. This is the check that\n * notices, run from an app's own test over the source texts the app collects.\n *\n * Browser-safe on purpose, like the rest of the kit: it takes TEXTS, not paths, so an app\n * reads its files however its setup allows (`import.meta.glob` with `?raw`, or `node:fs`)\n * and the kit carries no `node:fs`.\n */\n\n/** Every custom property the installed kit declares or publishes to apps.\n *\n *  Generated from `tokens.css` when the kit is built (scripts/gen-kit-css-variables.mjs),\n *  so it is always the installed version's, and an app never searches `node_modules`.\n *  It leaves out two kinds of name on purpose:\n *  - a name declared only in an `@theme inline` block (`--text-color-muted`,\n *    `--background-color-surface`): Tailwind emits no variable for it, so\n *    `var(--text-color-muted)` would pass a guard that counted it and paint nothing;\n *  - AppShell's measured `--app-nav-h`, which exists only while an AppShell is mounted —\n *    on a landing, legal, sign-in or pay page it is undefined. Read it with a fallback,\n *    `var(--app-nav-h,0px)`, as every kit read does.\n *  Everything `applyTokenSet` and More contrast write on `<html>` is in, through the\n *  stylesheet's `:root` / `.dark` mirror. Component internals (`--slider-fill`, `--fp-*`,\n *  `--icon-button-tone`, `--label-strip-edge`) are not: an app that reads one depends on\n *  the kit's internals, and the guard says so. */\nexport const KIT_CSS_VARIABLES: ReadonlySet<string> = new Set(KIT_NAMES.split(\" \"));\n\n/** Tailwind's own theme variables (`--color-rose-500`, `--spacing`, `--text-sm` …), from\n *  the `tailwindcss/theme.css` the kit builds with. Tailwind emits one when a scanned file\n *  names it, so a `var()` of it resolves. */\nconst TAILWIND_THEME: ReadonlySet<string> = new Set(TAILWIND_THEME_NAMES.split(\" \"));\n\n/** A Tailwind PALETTE colour: a hue with a shade, black or white. `refusePalette` reports\n *  these although they resolve — an app that has no palette lint asks this test to be\n *  its refusal. */\nconst PALETTE_VARIABLE = /^--color-(?:[a-z]+-\\d{2,3}|black|white)$/;\n\n/** Read only where it is set: the guard accepts it in a fallback use, never bare. */\nconst APP_NAV_H = \"--app-nav-h\";\n\nexport interface UndeclaredCssVariablesOptions {\n  /** Variables a library writes at runtime, as names or patterns:\n   *  `[\"--radix-collapsible-content-height\"]`. An app's own writes are found in its\n   *  source and need no listing. */\n  runtime?: readonly (string | RegExp)[];\n  /** Also check `var(--x, …)`. Off by default: a fallback says what happens when the\n   *  name is missing. `--app-nav-h` counts as declared only here. */\n  checkFallbacks?: boolean;\n  /** Report Tailwind palette variables (`--color-red-500`, `--color-white`) although\n   *  they resolve. Default false. */\n  refusePalette?: boolean;\n}\n\n/** Comments are not CSS. `/* *\\/` in both; `//` in TS only (not after a `:`, so a URL in a\n *  string survives). Replaced by spaces of the same shape, so line numbers hold. */\nfunction stripComments(text: string, isCss: boolean): string {\n  const blank = (m: string) => m.replace(/[^\\n]/g, \" \");\n  const noBlocks = text.replace(/\\/\\*[\\s\\S]*?\\*\\//g, blank);\n  return isCss ? noBlocks : noBlocks.replace(/(^|[^:])(\\/\\/[^\\n]*)/g, (_, pre: string, c: string) => pre + blank(c));\n}\n\n/** The text with every `@theme … inline … { … }` block blanked out, braces and all. */\nfunction withoutInlineTheme(css: string): string {\n  let out = css;\n  for (const m of css.matchAll(/@theme\\b[^{;]*\\binline\\b[^{;]*\\{/g)) {\n    let depth = 0;\n    let end = m.index + m[0].length - 1;\n    for (; end < css.length; end++) {\n      if (css[end] === \"{\") depth++;\n      else if (css[end] === \"}\" && --depth === 0) break;\n    }\n    out = out.slice(0, m.index) + css.slice(m.index, end + 1).replace(/[^\\n]/g, \" \") + out.slice(end + 1);\n  }\n  return out;\n}\n\n/**\n * Every custom property a stylesheet declares (`--name:`), in any block — except a name\n * declared only inside `@theme inline`, which Tailwind never emits as a variable. Comments\n * are skipped. The same rule builds {@link KIT_CSS_VARIABLES} from `tokens.css`.\n */\nexport function declaredCustomProperties(css: string): Set<string> {\n  const code = withoutInlineTheme(stripComments(css, true));\n  return new Set([...code.matchAll(/(--[a-zA-Z0-9_-]+)\\s*:/g)].map((m) => m[1]));\n}\n\n/** What an app's source writes at runtime: `setProperty(\"--name\"`, a React style key\n *  `\"--name\":`, a Tailwind arbitrary property `[--name:…]`. */\nfunction runtimeWrites(code: string): string[] {\n  return [\n    ...code.matchAll(/setProperty\\(\\s*[\"'`](--[a-zA-Z0-9_-]+)[\"'`]/g),\n    ...code.matchAll(/[\"'](--[a-zA-Z0-9_-]+)[\"']\\s*:/g),\n    ...code.matchAll(/\\[(--[a-zA-Z0-9_-]+):/g),\n  ].map((m) => m[1]);\n}\n\n/** A chart series' colour (`var(--color-total)`) is declared in a file with a `total: {`\n *  config entry: the kit's ChartContainer writes `--color-<key>` for each key. */\nfunction chartKeys(code: string): Set<string> {\n  return new Set([...code.matchAll(/(?:^|[\\s{,])[\"']?([A-Za-z_][\\w-]*)[\"']?\\s*:\\s*\\{/g)].map((m) => m[1]));\n}\n\nconst isCssPath = (path: string) => /\\.css(?:\\?|$)/.test(path);\n\n/**\n * Every `var(--name)` without a fallback that nothing declares, as `\"path:line --name\"`.\n *\n * `sources` maps a path to its text: the app's `.ts`, `.tsx` and `.css` source, tests\n * left out. A name counts as declared when it is:\n * 1. the kit's ({@link KIT_CSS_VARIABLES});\n * 2. declared in any `.css` entry of `sources` (outside `@theme inline`);\n * 3. written by the source at runtime (`setProperty`, a style key, `[--name:…]`);\n * 4. one of Tailwind's theme variables — unless `refusePalette` and it is a palette colour;\n * 5. a chart series' `--color-<key>`, in a file with a `<key>: {` entry;\n * 6. listed in `options.runtime`.\n *\n * Not counted: comments; a use with a fallback, unless `checkFallbacks`; a name built at\n * runtime (`` `var(--chart-${n})` `` — a name must be followed by `)` or `,`).\n *\n * It REFUSES A VACUOUS RUN: it throws when `sources` holds fewer than ten files, or when\n * a `.css` entry is empty. Vitest stubs every stylesheet with an empty string by default,\n * `?raw` included, so an app that reads its CSS that way without opting it out of the stub\n * (`test.css.include`) would otherwise lose every declaration and every use in it, and\n * this would pass or fail for the wrong reason.\n */\nexport function undeclaredCssVariables(\n  sources: Record<string, string>,\n  options: UndeclaredCssVariablesOptions = {},\n): string[] {\n  const { runtime = [], checkFallbacks = false, refusePalette = false } = options;\n  const entries = Object.entries(sources);\n  if (entries.length < 10) {\n    throw new Error(\n      `undeclaredCssVariables: only ${entries.length} source file(s) — the glob or the file list found ` +\n        `(almost) nothing, and a check over nothing passes. Pass the app's .ts/.tsx/.css source.`,\n    );\n  }\n  const emptyCss = entries.filter(([path, text]) => isCssPath(path) && text.trim() === \"\").map(([path]) => path);\n  if (emptyCss.length) {\n    throw new Error(\n      `undeclaredCssVariables: ${emptyCss.join(\", \")} read as empty. Vitest stubs stylesheets with \"\" ` +\n        `(\\`?raw\\` too) unless the file is listed in \\`test.css.include\\`.`,\n    );\n  }\n\n  const code = entries.map(([path, text]) => [path, stripComments(text, isCssPath(path))] as const);\n  const declared = new Set<string>();\n  for (const [path, text] of code) {\n    if (isCssPath(path)) for (const name of declaredCustomProperties(text)) declared.add(name);\n    for (const name of runtimeWrites(text)) declared.add(name);\n  }\n  const listed = (name: string) =>\n    runtime.some((r) => (typeof r === \"string\" ? r === name : r.test(name)));\n\n  const out: string[] = [];\n  for (const [path, text] of code) {\n    let keys: Set<string> | null = null;\n    for (const m of text.matchAll(/var\\(\\s*(--[a-zA-Z0-9_-]+)\\s*([,)])/g)) {\n      const [, name, next] = m;\n      const fallback = next === \",\";\n      if (fallback && !checkFallbacks) continue;\n      if (KIT_CSS_VARIABLES.has(name) || declared.has(name) || listed(name)) continue;\n      if (fallback && name === APP_NAV_H) continue;\n      if (TAILWIND_THEME.has(name)) {\n        if (refusePalette && PALETTE_VARIABLE.test(name)) {\n          out.push(`${path}:${lineOf(text, m.index)} ${name} (a Tailwind palette colour; refusePalette is on)`);\n        }\n        continue;\n      }\n      const chart = /^--color-([A-Za-z_][\\w-]*)$/.exec(name);\n      if (chart && (keys ??= chartKeys(text)).has(chart[1])) continue;\n      out.push(`${path}:${lineOf(text, m.index)} ${name}`);\n    }\n  }\n  return out;\n}\n\nfunction lineOf(text: string, index: number): number {\n  let line = 1;\n  for (let i = 0; i < index; i++) if (text.charCodeAt(i) === 10) line++;\n  return line;\n}\n"],"mappings":"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","names":[]}

package/dist/testing/index.d.ts

@@ -0,0 +1 @@
+export { KIT_CSS_VARIABLES, UndeclaredCssVariablesOptions, declaredCustomProperties, undeclaredCssVariables } from './css-variables.js';

package/dist/testing/index.js

@@ -0,0 +1,12 @@
+"use client";
+import {
+  KIT_CSS_VARIABLES,
+  declaredCustomProperties,
+  undeclaredCssVariables
+} from "./css-variables.js";
+export {
+  KIT_CSS_VARIABLES,
+  declaredCustomProperties,
+  undeclaredCssVariables
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).\n//\n// Not part of the main barrel: nothing here renders, and an app's production bundle has\n// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each\n// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as\n// its setup allows. The first content is the guard against undeclared CSS custom\n// properties (docs/colour-roles-harmonization.md §8).\nexport {\n  KIT_CSS_VARIABLES,\n  declaredCustomProperties,\n  undeclaredCssVariables,\n  type UndeclaredCssVariablesOptions,\n} from \"./css-variables\";\n"],"mappings":";AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}

package/dist/theme/contrast-tokens.d.ts

@@ -30,6 +30,49 @@ interface ContrastStep {
     textPlaceholder: string;
     border: string;
 }
+/** `color-mix(in oklab, a p, b)` as a hex — the same formula tokens.css's derived roles
+ *  use, so a stepped value sits where the stylesheet would have put it. A colour that is
+ *  not hex (a consumer's own token set) comes back unmixed. The deriver mixes with it
+ *  too (`--bg-hover`, `--brand-muted`, `--brand-bg`, `--brand-bg-hover`). */
+declare function mix(a: string, b: string, p: number): string;
+/**
+ * `--bg-hover` in tokens.css: this share of `--text-primary` mixed into `--bg-surface`.
+ *
+ * 5.5 %, down from 7 % in 0.33 (docs/colour-roles-harmonization.md §12.10): a hovered row
+ * on a card is the darkest fill (in dark, the lightest) that text sits on, and at 7 % the
+ * light status colours, the money colours and Ink/Moss/Plum's muted text fell to
+ * 4.25–4.49:1 on it. The status literals are fixed, the same in every preset, so the
+ * hover moved instead: text wins over the hover's step. At 5.5 % the step from the card
+ * is still 1.09–1.13:1, above the 1.08:1 the kit's hover rule asks (§12.2). The deriver
+ * solves the money colours against this fill, and tokens-css-audit.test.ts measures
+ * every text role on it in every shipped preset, so the two cannot part.
+ */
+declare const HOVER_INK = 0.055;
+/** The card's hover fill (`--bg-hover`) for `t`, as tokens.css mixes it. */
+declare function hoverFill(t: Pick<TokenSet, "textPrimary" | "bgSurface">): string;
+/**
+ * `--brand-muted` in tokens.css: this share of `--brand` mixed into `--text-primary`.
+ *
+ * 62 %, down from 70 % in 0.33 (docs/colour-roles-harmonization.md §12.11): the brand as
+ * text sits on its soft chip HOVERED too (`--brand-bg-hover` — ButtonGroupLink's current
+ * page, a selected day), and at 70 % it read 4.08–4.42:1 there in Default and Moss light
+ * and in Ink, Moss, Plum and Contrast dark. The brand could not move instead: the dark
+ * brands would have flipped their white label to the dark ink. Nor could the chip's hover
+ * lighten: by the time the text cleared 4.5:1 the hover sat 1.00:1 from the chip it
+ * hovers. So the text moves toward the ink, as `--bg-hover` moved for its text.
+ */
+declare const BRAND_MUTED_SHARE = 0.62;
+/** `--brand-bg` and `--brand-bg-hover` in tokens.css: these shares of `--brand` mixed
+ *  into `--bg-surface`. */
+declare const BRAND_BG_SHARE = 0.14;
+declare const BRAND_BG_HOVER_SHARE = 0.24;
+/** `--brand-muted`, `--brand-bg` and `--brand-bg-hover` for `t`, as tokens.css mixes them.
+ *  tokens-css-audit.test.ts holds the three shares equal to the stylesheet's. */
+declare function brandSoft(t: Pick<TokenSet, "brand" | "textPrimary" | "bgSurface">): {
+    brandMuted: string;
+    brandBg: string;
+    brandBgHover: string;
+};
 /** The four stepped values for `t`. Pure. */
 declare function contrastStep(t: TokenSet): ContrastStep;
 /** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */
@@ -38,4 +81,4 @@ declare function rememberTokenSet(el: HTMLElement, t: TokenSet): void;
  *  without the palette layer, whose base tokens come from tokens.css. */
 declare function rememberedTokenSet(el: HTMLElement): TokenSet | undefined;
 
-export { CONTRAST_STEPPED_VARS, type ContrastStep, contrastStep, rememberTokenSet, rememberedTokenSet };
+export { BRAND_BG_HOVER_SHARE, BRAND_BG_SHARE, BRAND_MUTED_SHARE, CONTRAST_STEPPED_VARS, type ContrastStep, HOVER_INK, brandSoft, contrastStep, hoverFill, mix, rememberTokenSet, rememberedTokenSet };

package/dist/theme/contrast-tokens.js

@@ -19,6 +19,20 @@ function mix(a, b, p) {
   const h = c < 1e-6 ? 0 : (Math.atan2(y, x) * 180 / Math.PI + 360) % 360;
   return toHex(oklchToRgb({ l, c, h }));
 }
+const HOVER_INK = 0.055;
+function hoverFill(t) {
+  return mix(t.textPrimary, t.bgSurface, HOVER_INK);
+}
+const BRAND_MUTED_SHARE = 0.62;
+const BRAND_BG_SHARE = 0.14;
+const BRAND_BG_HOVER_SHARE = 0.24;
+function brandSoft(t) {
+  return {
+    brandMuted: mix(t.brand, t.textPrimary, BRAND_MUTED_SHARE),
+    brandBg: mix(t.brand, t.bgSurface, BRAND_BG_SHARE),
+    brandBgHover: mix(t.brand, t.bgSurface, BRAND_BG_HOVER_SHARE)
+  };
+}
 const BORDER_TARGET = 3;
 const BORDER_STRONG_SHARE = 0.45;
 function worstContrast(color, t) {
@@ -51,8 +65,15 @@ function rememberedTokenSet(el) {
   return lastWritten.get(el);
 }
 export {
+  BRAND_BG_HOVER_SHARE,
+  BRAND_BG_SHARE,
+  BRAND_MUTED_SHARE,
   CONTRAST_STEPPED_VARS,
+  HOVER_INK,
+  brandSoft,
   contrastStep,
+  hoverFill,
+  mix,
   rememberTokenSet,
   rememberedTokenSet
 };

package/dist/theme/contrast-tokens.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/contrast-tokens.ts"],"sourcesContent":["import { contrast, oklchToRgb, parseHex, rgbToOklch, toHex } from \"./color\";\nimport type { TokenSet } from \"./palette-presets\";\n\n/**\n * The \"More contrast\" step on a token set (docs/text-size-harmonization.md §5, §10.5).\n * INTERNAL — `applyTokenSet` and the contrast layer share it; it is not re-exported.\n *\n * The step happens HERE, in JS, because the tokens it changes are written inline on\n * `<html>` by `applyTokenSet`: an inline value beats any `[data-contrast=more]` rule and\n * any `@media (prefers-contrast: more)` block, so a stylesheet cannot do it (§10.5, the\n * keksdose review). `--text-placeholder` is a CSS-derived token, and it is written inline\n * here too rather than redefined per attribute in tokens.css.\n *\n * What moves (§5):\n * - `--text-muted` becomes the set's `--text-secondary`;\n * - `--text-secondary` moves halfway to `--text-primary`;\n * - `--text-placeholder` becomes the set's `--text-muted` (4.6–5.5:1 on every shipped\n *   preset, where the CSS formula gives 2.4–2.8:1) — the order primary > secondary >\n *   muted > placeholder survives the step;\n * - `--border` moves toward `--text-primary` until it clears 3:1 against the worst of the\n *   three surfaces (WCAG 1.4.11, a field's boundary), and never less far than\n *   `--border-strong`'s 45 % — so every border is at least as strong as a \"strong\" one was.\n *   `--border-strong` stays derived in tokens.css and grows with it.\n */\n\n/** The custom properties a contrast step writes. */\nexport const CONTRAST_STEPPED_VARS = [\"--text-secondary\", \"--text-muted\", \"--text-placeholder\", \"--border\"] as const;\n\nexport interface ContrastStep {\n  textSecondary: string;\n  textMuted: string;\n  textPlaceholder: string;\n  border: string;\n}\n\ninterface Lab {\n  l: number;\n  a: number;\n  b: number;\n}\n\nfunction toLab(hex: string): Lab | null {\n  const rgb = parseHex(hex);\n  if (!rgb) return null;\n  const { l, c, h } = rgbToOklch(rgb);\n  const rad = (h * Math.PI) / 180;\n  return { l, a: c * Math.cos(rad), b: c * Math.sin(rad) };\n}\n\n/** `color-mix(in oklab, a p, b)` as a hex — the same formula tokens.css's derived roles\n *  use, so a stepped value sits where the stylesheet would have put it. A colour that is\n *  not hex (a consumer's own token set) comes back unmixed. */\nfunction mix(a: string, b: string, p: number): string {\n  const A = toLab(a);\n  const B = toLab(b);\n  if (!A || !B) return a;\n  const l = A.l * p + B.l * (1 - p);\n  const x = A.a * p + B.a * (1 - p);\n  const y = A.b * p + B.b * (1 - p);\n  const c = Math.hypot(x, y);\n  const h = c < 1e-6 ? 0 : ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;\n  return toHex(oklchToRgb({ l, c, h }));\n}\n\n/** WCAG 1.4.11 for a component's boundary. */\nconst BORDER_TARGET = 3;\n/** `--border-strong` in tokens.css: 55 % border, 45 % text. */\nconst BORDER_STRONG_SHARE = 0.45;\n\nfunction worstContrast(color: string, t: TokenSet): number {\n  return Math.min(contrast(color, t.bgPage), contrast(color, t.bgSurface), contrast(color, t.bgSurface2));\n}\n\nfunction steppedBorder(t: TokenSet): string {\n  // The share of `--text-primary` in the border: at least --border-strong's, more until\n  // 3:1. Monotonic in the share (the mix walks from the border to the text, away from\n  // every surface), so a bisection finds the least that clears it.\n  let lo = BORDER_STRONG_SHARE;\n  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t) >= BORDER_TARGET) return mix(t.border, t.textPrimary, 1 - lo);\n  let hi = 1;\n  for (let i = 0; i < 16; i++) {\n    const mid = (lo + hi) / 2;\n    if (worstContrast(mix(t.border, t.textPrimary, 1 - mid), t) >= BORDER_TARGET) hi = mid;\n    else lo = mid;\n  }\n  return mix(t.border, t.textPrimary, 1 - hi);\n}\n\n/** The four stepped values for `t`. Pure. */\nexport function contrastStep(t: TokenSet): ContrastStep {\n  return {\n    textSecondary: mix(t.textSecondary, t.textPrimary, 0.5),\n    textMuted: t.textSecondary,\n    textPlaceholder: t.textMuted,\n    border: steppedBorder(t),\n  };\n}\n\n/* ── The token set last written to an element ───────────────────────────── */\n\nconst lastWritten = new WeakMap<HTMLElement, TokenSet>();\n\n/** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */\nexport function rememberTokenSet(el: HTMLElement, t: TokenSet): void {\n  lastWritten.set(el, t);\n}\n\n/** The set `applyTokenSet` last wrote to `el`, or undefined when nothing did — an app\n *  without the palette layer, whose base tokens come from tokens.css. */\nexport function rememberedTokenSet(el: HTMLElement): TokenSet | undefined {\n  return lastWritten.get(el);\n}\n"],"mappings":";AAAA,SAAS,UAAU,YAAY,UAAU,YAAY,aAAa;AA0B3D,MAAM,wBAAwB,CAAC,oBAAoB,gBAAgB,sBAAsB,UAAU;AAe1G,SAAS,MAAM,KAAyB;AACtC,QAAM,MAAM,SAAS,GAAG;AACxB,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,EAAE,GAAG,GAAG,EAAE,IAAI,WAAW,GAAG;AAClC,QAAM,MAAO,IAAI,KAAK,KAAM;AAC5B,SAAO,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,EAAE;AACzD;AAKA,SAAS,IAAI,GAAW,GAAW,GAAmB;AACpD,QAAM,IAAI,MAAM,CAAC;AACjB,QAAM,IAAI,MAAM,CAAC;AACjB,MAAI,CAAC,KAAK,CAAC,EAAG,QAAO;AACrB,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,KAAK,MAAM,GAAG,CAAC;AACzB,QAAM,IAAI,IAAI,OAAO,KAAM,KAAK,MAAM,GAAG,CAAC,IAAI,MAAO,KAAK,KAAK,OAAO;AACtE,SAAO,MAAM,WAAW,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AACtC;AAGA,MAAM,gBAAgB;AAEtB,MAAM,sBAAsB;AAE5B,SAAS,cAAc,OAAe,GAAqB;AACzD,SAAO,KAAK,IAAI,SAAS,OAAO,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,SAAS,GAAG,SAAS,OAAO,EAAE,UAAU,CAAC;AACxG;AAEA,SAAS,cAAc,GAAqB;AAI1C,MAAI,KAAK;AACT,MAAI,cAAc,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE,GAAG,CAAC,KAAK,cAAe,QAAO,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE;AACvH,MAAI,KAAK;AACT,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,OAAO,KAAK,MAAM;AACxB,QAAI,cAAc,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,GAAG,GAAG,CAAC,KAAK,cAAe,MAAK;AAAA,QAC9E,MAAK;AAAA,EACZ;AACA,SAAO,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE;AAC5C;AAGO,SAAS,aAAa,GAA2B;AACtD,SAAO;AAAA,IACL,eAAe,IAAI,EAAE,eAAe,EAAE,aAAa,GAAG;AAAA,IACtD,WAAW,EAAE;AAAA,IACb,iBAAiB,EAAE;AAAA,IACnB,QAAQ,cAAc,CAAC;AAAA,EACzB;AACF;AAIA,MAAM,cAAc,oBAAI,QAA+B;AAGhD,SAAS,iBAAiB,IAAiB,GAAmB;AACnE,cAAY,IAAI,IAAI,CAAC;AACvB;AAIO,SAAS,mBAAmB,IAAuC;AACxE,SAAO,YAAY,IAAI,EAAE;AAC3B;","names":[]}
+{"version":3,"sources":["../../src/theme/contrast-tokens.ts"],"sourcesContent":["import { contrast, oklchToRgb, parseHex, rgbToOklch, toHex } from \"./color\";\nimport type { TokenSet } from \"./palette-presets\";\n\n/**\n * The \"More contrast\" step on a token set (docs/text-size-harmonization.md §5, §10.5).\n * INTERNAL — `applyTokenSet` and the contrast layer share it; it is not re-exported.\n *\n * The step happens HERE, in JS, because the tokens it changes are written inline on\n * `<html>` by `applyTokenSet`: an inline value beats any `[data-contrast=more]` rule and\n * any `@media (prefers-contrast: more)` block, so a stylesheet cannot do it (§10.5, the\n * keksdose review). `--text-placeholder` is a CSS-derived token, and it is written inline\n * here too rather than redefined per attribute in tokens.css.\n *\n * What moves (§5):\n * - `--text-muted` becomes the set's `--text-secondary`;\n * - `--text-secondary` moves halfway to `--text-primary`;\n * - `--text-placeholder` becomes the set's `--text-muted` (4.6–5.5:1 on every shipped\n *   preset, where the CSS formula gives 2.4–2.8:1) — the order primary > secondary >\n *   muted > placeholder survives the step;\n * - `--border` moves toward `--text-primary` until it clears 3:1 against the worst of the\n *   three surfaces (WCAG 1.4.11, a field's boundary), and never less far than\n *   `--border-strong`'s 45 % — so every border is at least as strong as a \"strong\" one was.\n *   `--border-strong` stays derived in tokens.css and grows with it.\n */\n\n/** The custom properties a contrast step writes. */\nexport const CONTRAST_STEPPED_VARS = [\"--text-secondary\", \"--text-muted\", \"--text-placeholder\", \"--border\"] as const;\n\nexport interface ContrastStep {\n  textSecondary: string;\n  textMuted: string;\n  textPlaceholder: string;\n  border: string;\n}\n\ninterface Lab {\n  l: number;\n  a: number;\n  b: number;\n}\n\nfunction toLab(hex: string): Lab | null {\n  const rgb = parseHex(hex);\n  if (!rgb) return null;\n  const { l, c, h } = rgbToOklch(rgb);\n  const rad = (h * Math.PI) / 180;\n  return { l, a: c * Math.cos(rad), b: c * Math.sin(rad) };\n}\n\n/** `color-mix(in oklab, a p, b)` as a hex — the same formula tokens.css's derived roles\n *  use, so a stepped value sits where the stylesheet would have put it. A colour that is\n *  not hex (a consumer's own token set) comes back unmixed. The deriver mixes with it\n *  too (`--bg-hover`, `--brand-muted`, `--brand-bg`, `--brand-bg-hover`). */\nexport function mix(a: string, b: string, p: number): string {\n  const A = toLab(a);\n  const B = toLab(b);\n  if (!A || !B) return a;\n  const l = A.l * p + B.l * (1 - p);\n  const x = A.a * p + B.a * (1 - p);\n  const y = A.b * p + B.b * (1 - p);\n  const c = Math.hypot(x, y);\n  const h = c < 1e-6 ? 0 : ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;\n  return toHex(oklchToRgb({ l, c, h }));\n}\n\n/**\n * `--bg-hover` in tokens.css: this share of `--text-primary` mixed into `--bg-surface`.\n *\n * 5.5 %, down from 7 % in 0.33 (docs/colour-roles-harmonization.md §12.10): a hovered row\n * on a card is the darkest fill (in dark, the lightest) that text sits on, and at 7 % the\n * light status colours, the money colours and Ink/Moss/Plum's muted text fell to\n * 4.25–4.49:1 on it. The status literals are fixed, the same in every preset, so the\n * hover moved instead: text wins over the hover's step. At 5.5 % the step from the card\n * is still 1.09–1.13:1, above the 1.08:1 the kit's hover rule asks (§12.2). The deriver\n * solves the money colours against this fill, and tokens-css-audit.test.ts measures\n * every text role on it in every shipped preset, so the two cannot part.\n */\nexport const HOVER_INK = 0.055;\n\n/** The card's hover fill (`--bg-hover`) for `t`, as tokens.css mixes it. */\nexport function hoverFill(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): string {\n  return mix(t.textPrimary, t.bgSurface, HOVER_INK);\n}\n\n/**\n * `--brand-muted` in tokens.css: this share of `--brand` mixed into `--text-primary`.\n *\n * 62 %, down from 70 % in 0.33 (docs/colour-roles-harmonization.md §12.11): the brand as\n * text sits on its soft chip HOVERED too (`--brand-bg-hover` — ButtonGroupLink's current\n * page, a selected day), and at 70 % it read 4.08–4.42:1 there in Default and Moss light\n * and in Ink, Moss, Plum and Contrast dark. The brand could not move instead: the dark\n * brands would have flipped their white label to the dark ink. Nor could the chip's hover\n * lighten: by the time the text cleared 4.5:1 the hover sat 1.00:1 from the chip it\n * hovers. So the text moves toward the ink, as `--bg-hover` moved for its text.\n */\nexport const BRAND_MUTED_SHARE = 0.62;\n/** `--brand-bg` and `--brand-bg-hover` in tokens.css: these shares of `--brand` mixed\n *  into `--bg-surface`. */\nexport const BRAND_BG_SHARE = 0.14;\nexport const BRAND_BG_HOVER_SHARE = 0.24;\n\n/** `--brand-muted`, `--brand-bg` and `--brand-bg-hover` for `t`, as tokens.css mixes them.\n *  tokens-css-audit.test.ts holds the three shares equal to the stylesheet's. */\nexport function brandSoft(t: Pick<TokenSet, \"brand\" | \"textPrimary\" | \"bgSurface\">): {\n  brandMuted: string;\n  brandBg: string;\n  brandBgHover: string;\n} {\n  return {\n    brandMuted: mix(t.brand, t.textPrimary, BRAND_MUTED_SHARE),\n    brandBg: mix(t.brand, t.bgSurface, BRAND_BG_SHARE),\n    brandBgHover: mix(t.brand, t.bgSurface, BRAND_BG_HOVER_SHARE),\n  };\n}\n\n/** WCAG 1.4.11 for a component's boundary. */\nconst BORDER_TARGET = 3;\n/** `--border-strong` in tokens.css: 55 % border, 45 % text. */\nconst BORDER_STRONG_SHARE = 0.45;\n\nfunction worstContrast(color: string, t: TokenSet): number {\n  return Math.min(contrast(color, t.bgPage), contrast(color, t.bgSurface), contrast(color, t.bgSurface2));\n}\n\nfunction steppedBorder(t: TokenSet): string {\n  // The share of `--text-primary` in the border: at least --border-strong's, more until\n  // 3:1. Monotonic in the share (the mix walks from the border to the text, away from\n  // every surface), so a bisection finds the least that clears it.\n  let lo = BORDER_STRONG_SHARE;\n  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t) >= BORDER_TARGET) return mix(t.border, t.textPrimary, 1 - lo);\n  let hi = 1;\n  for (let i = 0; i < 16; i++) {\n    const mid = (lo + hi) / 2;\n    if (worstContrast(mix(t.border, t.textPrimary, 1 - mid), t) >= BORDER_TARGET) hi = mid;\n    else lo = mid;\n  }\n  return mix(t.border, t.textPrimary, 1 - hi);\n}\n\n/** The four stepped values for `t`. Pure. */\nexport function contrastStep(t: TokenSet): ContrastStep {\n  return {\n    textSecondary: mix(t.textSecondary, t.textPrimary, 0.5),\n    textMuted: t.textSecondary,\n    textPlaceholder: t.textMuted,\n    border: steppedBorder(t),\n  };\n}\n\n/* ── The token set last written to an element ───────────────────────────── */\n\nconst lastWritten = new WeakMap<HTMLElement, TokenSet>();\n\n/** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */\nexport function rememberTokenSet(el: HTMLElement, t: TokenSet): void {\n  lastWritten.set(el, t);\n}\n\n/** The set `applyTokenSet` last wrote to `el`, or undefined when nothing did — an app\n *  without the palette layer, whose base tokens come from tokens.css. */\nexport function rememberedTokenSet(el: HTMLElement): TokenSet | undefined {\n  return lastWritten.get(el);\n}\n"],"mappings":";AAAA,SAAS,UAAU,YAAY,UAAU,YAAY,aAAa;AA0B3D,MAAM,wBAAwB,CAAC,oBAAoB,gBAAgB,sBAAsB,UAAU;AAe1G,SAAS,MAAM,KAAyB;AACtC,QAAM,MAAM,SAAS,GAAG;AACxB,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,EAAE,GAAG,GAAG,EAAE,IAAI,WAAW,GAAG;AAClC,QAAM,MAAO,IAAI,KAAK,KAAM;AAC5B,SAAO,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,EAAE;AACzD;AAMO,SAAS,IAAI,GAAW,GAAW,GAAmB;AAC3D,QAAM,IAAI,MAAM,CAAC;AACjB,QAAM,IAAI,MAAM,CAAC;AACjB,MAAI,CAAC,KAAK,CAAC,EAAG,QAAO;AACrB,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI;AAC/B,QAAM,IAAI,KAAK,MAAM,GAAG,CAAC;AACzB,QAAM,IAAI,IAAI,OAAO,KAAM,KAAK,MAAM,GAAG,CAAC,IAAI,MAAO,KAAK,KAAK,OAAO;AACtE,SAAO,MAAM,WAAW,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AACtC;AAcO,MAAM,YAAY;AAGlB,SAAS,UAAU,GAAwD;AAChF,SAAO,IAAI,EAAE,aAAa,EAAE,WAAW,SAAS;AAClD;AAaO,MAAM,oBAAoB;AAG1B,MAAM,iBAAiB;AACvB,MAAM,uBAAuB;AAI7B,SAAS,UAAU,GAIxB;AACA,SAAO;AAAA,IACL,YAAY,IAAI,EAAE,OAAO,EAAE,aAAa,iBAAiB;AAAA,IACzD,SAAS,IAAI,EAAE,OAAO,EAAE,WAAW,cAAc;AAAA,IACjD,cAAc,IAAI,EAAE,OAAO,EAAE,WAAW,oBAAoB;AAAA,EAC9D;AACF;AAGA,MAAM,gBAAgB;AAEtB,MAAM,sBAAsB;AAE5B,SAAS,cAAc,OAAe,GAAqB;AACzD,SAAO,KAAK,IAAI,SAAS,OAAO,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,SAAS,GAAG,SAAS,OAAO,EAAE,UAAU,CAAC;AACxG;AAEA,SAAS,cAAc,GAAqB;AAI1C,MAAI,KAAK;AACT,MAAI,cAAc,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE,GAAG,CAAC,KAAK,cAAe,QAAO,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE;AACvH,MAAI,KAAK;AACT,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,OAAO,KAAK,MAAM;AACxB,QAAI,cAAc,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,GAAG,GAAG,CAAC,KAAK,cAAe,MAAK;AAAA,QAC9E,MAAK;AAAA,EACZ;AACA,SAAO,IAAI,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE;AAC5C;AAGO,SAAS,aAAa,GAA2B;AACtD,SAAO;AAAA,IACL,eAAe,IAAI,EAAE,eAAe,EAAE,aAAa,GAAG;AAAA,IACtD,WAAW,EAAE;AAAA,IACb,iBAAiB,EAAE;AAAA,IACnB,QAAQ,cAAc,CAAC;AAAA,EACzB;AACF;AAIA,MAAM,cAAc,oBAAI,QAA+B;AAGhD,SAAS,iBAAiB,IAAiB,GAAmB;AACnE,cAAY,IAAI,IAAI,CAAC;AACvB;AAIO,SAAS,mBAAmB,IAAuC;AACxE,SAAO,YAAY,IAAI,EAAE;AAC3B;","names":[]}

package/dist/theme/contrast.d.ts

@@ -91,7 +91,7 @@ declare function createContrastStore(storageKey: string): {
         setState(state: ContrastState | ((state: ContrastState) => ContrastState), replace: true): unknown;
         persist: {
             setOptions: (options: Partial<zustand_middleware.PersistOptions<ContrastState, {
-                contrast: "more" | "system" | "standard" | null;
+                contrast: "standard" | "more" | "system" | null;
             }, unknown>>) => void;
             clearStorage: () => void;
             rehydrate: () => Promise<void> | void;
@@ -99,7 +99,7 @@ declare function createContrastStore(storageKey: string): {
             onHydrate: (fn: (state: ContrastState) => void) => () => void;
             onFinishHydration: (fn: (state: ContrastState) => void) => () => void;
             getOptions: () => Partial<zustand_middleware.PersistOptions<ContrastState, {
-                contrast: "more" | "system" | "standard" | null;
+                contrast: "standard" | "more" | "system" | null;
             }, unknown>>;
         };
     }>;