@adminiumjs/ui 0.2.9 → 0.3.0-rc.0

package/dist/lib/tones.d.ts

@@ -1,6 +1,6 @@
 /**
  * lib/tones.ts — the canonical home of the semantic tone vocabulary and the
- * status→tone registry (03-component-library.md §3.3, §7.6).
+ * status→tone registry.
  *
  * The SINGLE source of truth: components/icon-tile, components/badge and
  * components/status-pill re-export from here (their wave-1 local copies are
@@ -49,20 +49,21 @@ export declare const toneSoftClasses: Record<Tone, string>;
 export declare const toneSolidClasses: Record<Tone, string>;
 /**
  * Tone → `color-mix` border utilities used by Alert/Banner callouts
- * (tone-soft bg + 30%-mixed tone border, research/design-system.md §3 Tier 3).
+ * (tone-soft bg + 30%-mixed tone border, research/design-system.md
+ * Tier 3).
  */
 export declare const toneMixBorderClasses: Record<Tone, string>;
 /**
- * Sticky translucent bar recipe (03-component-library.md §7.5) —
- * used by `Topbar`, `WizardLayout` footer and sticky table headers. Exported
- * from here so the color-mix recipe lives in exactly one place.
+ * Sticky translucent bar recipe — used by `Topbar`, `WizardLayout` footer
+ * and sticky table headers. Exported from here so the color-mix recipe lives
+ * in exactly one place.
  */
 export declare const glassBar = "sticky top-0 z-40 border-b border-border bg-[color-mix(in_srgb,var(--surface)_82%,transparent)] backdrop-blur-[8px]";
 /**
- * Default status→tone registry (03-component-library.md §7.6).
- * Extended at runtime via `registerStatusTones` (widgets/manifests register
- * domain statuses); tints always derive from the tone — never hardcoded per
- * feature (the "Ticket Queue hardcoded priority tint" defect fix).
+ * Default status→tone registry. Extended at runtime via
+ * `registerStatusTones` (widgets/manifests register domain statuses); tints
+ * always derive from the tone — never hardcoded per feature (the "Ticket
+ * Queue hardcoded priority tint" defect fix).
  */
 export declare const DEFAULT_STATUS_TONES: Readonly<Record<string, Tone>>;
 /** Idempotent merge of domain statuses into the status→tone registry. */

package/dist/lib/tones.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tones.d.ts","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E,kEAAkE;AAClE,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAA2D,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOhD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,wHACkG,CAAC;AAExH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAyB9D,CAAC;AAIH,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAInE;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAgB,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"tones.d.ts","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E,kEAAkE;AAClE,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAA2D,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOhD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,wHACkG,CAAC;AAExH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAyB9D,CAAC;AAIH,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAInE;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAgB,GAAG,IAAI,CAE3E"}

package/dist/lib/tones.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
  * lib/tones.ts — the canonical home of the semantic tone vocabulary and the
- * status→tone registry (03-component-library.md §3.3, §7.6).
+ * status→tone registry.
  *
  * The SINGLE source of truth: components/icon-tile, components/badge and
  * components/status-pill re-export from here (their wave-1 local copies are
@@ -62,7 +62,8 @@ export const toneSolidClasses = {
 };
 /**
  * Tone → `color-mix` border utilities used by Alert/Banner callouts
- * (tone-soft bg + 30%-mixed tone border, research/design-system.md §3 Tier 3).
+ * (tone-soft bg + 30%-mixed tone border, research/design-system.md
+ * Tier 3).
  */
 export const toneMixBorderClasses = {
     neutral: 'border-border',
@@ -73,16 +74,16 @@ export const toneMixBorderClasses = {
     info: 'border-[color-mix(in_srgb,var(--info)_30%,transparent)]',
 };
 /**
- * Sticky translucent bar recipe (03-component-library.md §7.5) —
- * used by `Topbar`, `WizardLayout` footer and sticky table headers. Exported
- * from here so the color-mix recipe lives in exactly one place.
+ * Sticky translucent bar recipe — used by `Topbar`, `WizardLayout` footer
+ * and sticky table headers. Exported from here so the color-mix recipe lives
+ * in exactly one place.
  */
 export const glassBar = 'sticky top-0 z-40 border-b border-border bg-[color-mix(in_srgb,var(--surface)_82%,transparent)] backdrop-blur-[8px]';
 /**
- * Default status→tone registry (03-component-library.md §7.6).
- * Extended at runtime via `registerStatusTones` (widgets/manifests register
- * domain statuses); tints always derive from the tone — never hardcoded per
- * feature (the "Ticket Queue hardcoded priority tint" defect fix).
+ * Default status→tone registry. Extended at runtime via
+ * `registerStatusTones` (widgets/manifests register domain statuses); tints
+ * always derive from the tone — never hardcoded per feature (the "Ticket
+ * Queue hardcoded priority tint" defect fix).
  */
 export const DEFAULT_STATUS_TONES = Object.freeze({
     paid: 'pos',

package/dist/lib/tones.js.map

@@ -1 +1 @@
-{"version":3,"file":"tones.js","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;;GAQG;AAKH,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,OAAO,EAAE,4BAA4B;IACrC,MAAM,EAAE,kCAAkC;IAC1C,GAAG,EAAE,4BAA4B;IACjC,IAAI,EAAE,8BAA8B;IACpC,MAAM,EAAE,kCAAkC;IAC1C,IAAI,EAAE,8BAA8B;CACrC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,0BAA0B;IAClC,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE,0BAA0B;IAClC,IAAI,EAAE,wBAAwB;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,2DAA2D;IACnE,GAAG,EAAE,wDAAwD;IAC7D,IAAI,EAAE,yDAAyD;IAC/D,MAAM,EAAE,2DAA2D;IACnE,IAAI,EAAE,yDAAyD;CAChE,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GACnB,qHAAqH,CAAC;AAExH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmC,MAAM,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACpB,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAe,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE7E,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,GAAyB;IAC3D,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAiB,SAAS;IACnE,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,QAAQ,CAAC;AACxD,CAAC"}
+{"version":3,"file":"tones.js","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;;GAQG;AAKH,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,OAAO,EAAE,4BAA4B;IACrC,MAAM,EAAE,kCAAkC;IAC1C,GAAG,EAAE,4BAA4B;IACjC,IAAI,EAAE,8BAA8B;IACpC,MAAM,EAAE,kCAAkC;IAC1C,IAAI,EAAE,8BAA8B;CACrC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,0BAA0B;IAClC,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE,0BAA0B;IAClC,IAAI,EAAE,wBAAwB;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,2DAA2D;IACnE,GAAG,EAAE,wDAAwD;IAC7D,IAAI,EAAE,yDAAyD;IAC/D,MAAM,EAAE,2DAA2D;IACnE,IAAI,EAAE,yDAAyD;CAChE,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GACnB,qHAAqH,CAAC;AAExH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmC,MAAM,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACpB,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAe,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE7E,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,GAAyB;IAC3D,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAiB,SAAS;IACnE,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,QAAQ,CAAC;AACxD,CAAC"}

package/dist/lib/week.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WHERE THE WEEK STARTS, and what the days are called.
+ *
+ * Two products in this repo need the same answer — the quick-create date pills
+ * and the month calendar — and two copies of it is how one screen puts Monday
+ * first while the screen beside it puts Sunday there. It lives here, in the
+ * package both of them already depend on.
+ */
+/**
+ * The reader's first day of the week, as `Date#getDay` counts (Sunday = 0).
+ *
+ * `Intl.Locale`'s week info answers it where the runtime has it; Monday is the
+ * fallback, because it is what the ISO calendar says and what most of the
+ * world's locales use.
+ */
+export declare function firstDayOfWeek(locale: string | undefined): number;
+/**
+ * The seven weekday initials, starting where this reader's week does.
+ *
+ * `narrow` is the one-letter form every locale defines — and in several of
+ * them two days share a letter (English's T and S, the comp's own `M T W T F S
+ * S`), which is correct rather than a bug: the column position is what
+ * disambiguates, and inventing a second letter would be inventing a locale.
+ */
+export declare function weekdayInitials(locale: string | undefined): string[];
+/**
+ * The cells of a month grid: leading blanks for the days before the 1st, then
+ * every day of the month.
+ *
+ * Returned as `null` for a blank rather than as a Date outside the month,
+ * because the comp draws those cells empty (634–652) and a caller that had a
+ * date in hand would sooner or later render it.
+ */
+export declare function monthGrid(year: number, month: number, locale: string | undefined): (Date | null)[];
+/** `YYYY-MM-DD` for a Date, in the reader's own zone — never `toISOString`. */
+export declare function dayKey(date: Date): string;
+//# sourceMappingURL=week.d.ts.map

package/dist/lib/week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"week.d.ts","sourceRoot":"","sources":["../../src/lib/week.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAajE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAQpE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAUlG;AAED,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGzC"}

package/dist/lib/week.js

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WHERE THE WEEK STARTS, and what the days are called.
+ *
+ * Two products in this repo need the same answer — the quick-create date pills
+ * and the month calendar — and two copies of it is how one screen puts Monday
+ * first while the screen beside it puts Sunday there. It lives here, in the
+ * package both of them already depend on.
+ */
+/**
+ * The reader's first day of the week, as `Date#getDay` counts (Sunday = 0).
+ *
+ * `Intl.Locale`'s week info answers it where the runtime has it; Monday is the
+ * fallback, because it is what the ISO calendar says and what most of the
+ * world's locales use.
+ */
+export function firstDayOfWeek(locale) {
+    try {
+        const info = new Intl.Locale(locale ?? 'en-US');
+        const first = info.getWeekInfo?.().firstDay ?? info.weekInfo?.firstDay;
+        // `Intl` counts Monday as 1 … Sunday as 7; `Date#getDay` counts Sunday as 0.
+        if (typeof first === 'number')
+            return first % 7;
+    }
+    catch {
+        /* an older runtime, or a locale it does not know */
+    }
+    return 1;
+}
+/**
+ * The seven weekday initials, starting where this reader's week does.
+ *
+ * `narrow` is the one-letter form every locale defines — and in several of
+ * them two days share a letter (English's T and S, the comp's own `M T W T F S
+ * S`), which is correct rather than a bug: the column position is what
+ * disambiguates, and inventing a second letter would be inventing a locale.
+ */
+export function weekdayInitials(locale) {
+    const first = firstDayOfWeek(locale);
+    const format = new Intl.DateTimeFormat(locale ?? 'en-US', { weekday: 'narrow' });
+    // 2026-02-01 is a Sunday, so `getDay()` and the offset line up with no
+    // arithmetic about which epoch day was which.
+    return Array.from({ length: 7 }, (_, index) => format.format(new Date(Date.UTC(2026, 1, 1 + ((first + index) % 7)))));
+}
+/**
+ * The cells of a month grid: leading blanks for the days before the 1st, then
+ * every day of the month.
+ *
+ * Returned as `null` for a blank rather than as a Date outside the month,
+ * because the comp draws those cells empty (634–652) and a caller that had a
+ * date in hand would sooner or later render it.
+ */
+export function monthGrid(year, month, locale) {
+    const first = new Date(year, month, 1);
+    const lead = (first.getDay() - firstDayOfWeek(locale) + 7) % 7;
+    const days = new Date(year, month + 1, 0).getDate();
+    const cells = Array.from({ length: lead }, () => null);
+    for (let day = 1; day <= days; day += 1)
+        cells.push(new Date(year, month, day));
+    // Fill the last row, so the grid is a rectangle and the legend below it does
+    // not jump a line between a 28-day month and a 31-day one.
+    while (cells.length % 7 !== 0)
+        cells.push(null);
+    return cells;
+}
+/** `YYYY-MM-DD` for a Date, in the reader's own zone — never `toISOString`. */
+export function dayKey(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${String(date.getFullYear()).padStart(4, '0')}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+//# sourceMappingURL=week.js.map

package/dist/lib/week.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"week.js","sourceRoot":"","sources":["../../src/lib/week.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,CAG7C,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACvE,6EAA6E;QAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,uEAAuE;IACvE,8CAA8C;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,MAA0B;IAC/E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpD,MAAM,KAAK,GAAoB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACxE,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAChF,6EAA6E;IAC7E,2DAA2D;IAC3D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,MAAM,CAAC,IAAU;IAC/B,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC"}

package/dist/theme/ThemeProvider.d.ts

@@ -11,11 +11,10 @@ export interface ThemeProviderProps {
     /** Persistence hook for `setPref` (M8 wires `PATCH /api/v1/me/prefs` here). */
     onPrefChange?: ThemePrefChangeHandler;
     /**
-     * Direction resolver for locales this package cannot know about
-     * (23 §5.4). The app injects one backed by `@adminium/i18n`'s runtime
-     * registry; return `null` to defer to the compiled table and the cached
-     * axis. Absent in Storybook and in tests, where only the eight compiled
-     * locales exist.
+     * Direction resolver for locales this package cannot know about. The
+     * app injects one backed by `@adminium/i18n`'s runtime registry; return
+     * `null` to defer to the compiled table and the cached axis. Absent in
+     * Storybook and in tests, where only the eight compiled locales exist.
      */
     resolveDir?: (locale: Locale) => Dir | null;
     children: ReactNode;

package/dist/theme/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EASL,KAAK,GAAG,EACT,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAIL,KAAK,MAAM,EAEX,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAIpB,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAC9D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,UAAU,KACd,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAqFD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAmHlE"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EASL,KAAK,GAAG,EACT,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAIL,KAAK,MAAM,EAEX,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAIpB,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAC9D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,UAAU,KACd,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAqFD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAqHlE"}

package/dist/theme/ThemeProvider.js

@@ -1,22 +1,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * ThemeProvider — runtime for the four theming axes (theme/accent/density/locale→dir),
- * per 02-design-system.md §4 and 03-component-library.md §3.6.
+ * ThemeProvider — runtime for the four theming axes (theme/accent/density/locale→dir).
  *
  * Responsibilities:
- * 1. Resolve effective prefs per-axis (§4.2): baseline ← localStorage pre-paint
- *    cache ← `globalDefaults` (adminium_settings) ← `userPrefs`
- *    (adminium_user_prefs) ← in-session `setPref` calls. localStorage is a
- *    cache, not a preference source: it only fills axes the server props do
- *    not supply (pre-auth surfaces), and server-resolved values always win.
- *    The `setPref` layer (`sessionPrefs`) is optimistic and transient: an entry
- *    is reconciled away once the server-resolved props catch up to it (same
- *    value), and can be dropped explicitly via `clearSessionPref` when the
- *    caller resets an axis server-side (M8 reset-to-default) — otherwise a
- *    stale optimistic value would keep masking the refetched default until a
- *    reload. Entries whose value still differs from the props are treated as
- *    in flight and keep winning (§4 behavior 4).
+ * 1. Resolve effective prefs per-axis: baseline ← localStorage pre-paint cache
+ * ← `globalDefaults` (adminium_settings) ← `userPrefs` (adminium_user_prefs) ←
+ * in-session `setPref` calls. localStorage is a cache, not a preference source:
+ * it only fills axes the server props do not supply (pre-auth surfaces), and
+ * server-resolved values always win. The `setPref` layer (`sessionPrefs`) is
+ * optimistic and transient: an entry is reconciled away once the
+ * server-resolved props catch up to it (same value), and can be dropped
+ * explicitly via `clearSessionPref` when the caller resets an axis server-side
+ * (M8 reset-to-default) — otherwise a stale optimistic value would keep masking
+ * the refetched default until a reload. Entries whose value still differs from
+ * the props are treated as in flight and keep winning (behavior 4).
  * 2. Stamp `THEME_ATTRIBUTES` on `document.documentElement` (`data-theme` with
  *    the RESOLVED light/dark, `data-accent`, `data-density`, `dir`, `lang`).
  *    This is the only place theming attributes are set after pre-hydration.
@@ -56,7 +54,7 @@ function readStorageCache() {
         if (density !== null && DENSITIES.includes(density)) {
             cache.density = density;
         }
-        // SHAPE check, not membership (23 §5.2): a cached preference may name an
+        // SHAPE check, not membership: a cached preference may name an
         // admin-created locale this build does not compile in, and dropping it
         // would strand that user on en-US on every cold load.
         const locale = window.localStorage.getItem(STORAGE_KEYS.locale);
@@ -73,7 +71,7 @@ function readStorageCache() {
 const LOCALE_ID_SHAPE = /^[a-z]{2,3}(_[A-Za-z0-9]{2,8}){0,2}$/;
 /**
  * The `dir` the last resolved paint cached — an INDEPENDENT axis, not
- * re-derived from the locale (23 §5.4).
+ * re-derived from the locale.
  *
  * Without this, a custom RTL locale paints `rtl` from the pre-hydration
  * script and snaps to `ltr` at hydration on every signed-out screen: this
@@ -128,7 +126,7 @@ export function ThemeProvider(props) {
     const [sessionPrefs, setSessionPrefs] = useState({});
     const [prefersDark, setPrefersDark] = useState(systemPrefersDark);
     // Everything resolvable from the server props (+ pre-paint cache), WITHOUT the
-    // optimistic session layer. `sessionPrefs` rides on top of this (§4.2).
+    // optimistic session layer. `sessionPrefs` rides on top of this.
     const propsResolved = useMemo(() => ({
         ...BASELINE_PREFS,
         ...storageCache,
@@ -146,7 +144,8 @@ export function ThemeProvider(props) {
         setSessionPrefs((prev) => reconcileSessionPrefs(prev, propsResolved));
     }
     const prefs = useMemo(() => ({ ...propsResolved, ...sessionPrefs }), [propsResolved, sessionPrefs]);
-    // Live system-theme tracking, attached only while the pref is `system` (§4 behavior 2).
+    // Live system-theme tracking, attached only while the pref is `system`
+    // (behavior 2).
     useEffect(() => {
         if (prefs.theme !== 'system')
             return;
@@ -169,7 +168,8 @@ export function ThemeProvider(props) {
         locale: prefs.locale,
         dir: dirForLocale(prefs.locale, { resolve: resolveDir, cached: cachedDir }),
     }), [prefs, prefersDark, resolveDir, cachedDir]);
-    // Stamp <html>, write the cache back, then notify listeners (§4 behaviors 1/3/5).
+    // Stamp <html>, write the cache back, then notify listeners (behaviors
+    // 1/3/5).
     useLayoutEffect(() => {
         const el = document.documentElement;
         el.setAttribute(THEME_ATTRIBUTES.theme, resolved.theme);

package/dist/theme/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"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"}

package/dist/theme/context.d.ts

@@ -1,16 +1,17 @@
 import type { ResolvedTheme, ThemePrefs } from './types.js';
-/** `setPref` updates one axis optimistically (02-design-system.md §4 behavior 4). */
+/** `setPref` updates one axis optimistically (behavior 4). */
 export type SetThemePref = <K extends keyof ThemePrefs>(key: K, value: ThemePrefs[K]) => void;
 /**
  * Drop the optimistic session override for one axis so the resolved value falls
- * back through to the server-resolved props (§4.2). The Preferences page calls
- * this on "Reset to workspace default" — clearing an axis server-side does not
- * change the in-session `setPref` layer, which would otherwise keep masking the
+ * back through to the server-resolved props. The Preferences page calls this on
+ * "Reset to workspace default" — clearing an axis server-side does not change
+ * the in-session `setPref` layer, which would otherwise keep masking the
  * refetched default until a reload.
  */
 export type ClearSessionPref = (key: keyof ThemePrefs) => void;
 export interface ThemeContextValue {
-    /** Effective preferences after the resolution order (§4.2); `theme` may be `system`. */
+    /** Effective preferences after the resolution order; `theme` may be `system`.
+     * */
     prefs: ThemePrefs;
     /** Resolved values as stamped on `<html>`. */
     resolved: ResolvedTheme;

package/dist/theme/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,qFAAqF;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,UAAU,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,KAAK,EAAE,UAAU,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,eAAO,MAAM,YAAY,mDAAgD,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,UAAU,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC;SACK;IACL,KAAK,EAAE,UAAU,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,eAAO,MAAM,YAAY,mDAAgD,CAAC"}

package/dist/theme/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAyBtC,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA0BtC,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC"}

package/dist/theme/subscribe.d.ts

@@ -1,7 +1,7 @@
 /**
- * Non-React theme subscription (02-design-system.md §4.1) — for
- * Leaflet tile swaps, chart re-tints, Electron `nativeTheme` mirroring.
- * ThemeProvider emits AFTER the DOM attributes are committed (§4 behavior 5).
+ * Non-React theme subscription — for Leaflet tile swaps, chart
+ * re-tints, Electron `nativeTheme` mirroring. ThemeProvider emits AFTER
+ * the DOM attributes are committed (behavior 5).
  */
 import type { ResolvedTheme } from './types.js';
 export type ThemeListener = (theme: ResolvedTheme) => void;
@@ -11,7 +11,7 @@ export declare function subscribeTheme(listener: ThemeListener): () => void;
  * @internal Called by ThemeProvider after stamping `<html>`. Not part of the
  * public API.
  *
- * Each listener is isolated (23 §4.4). This runs inside ThemeProvider's
+ * Each listener is isolated. This runs inside ThemeProvider's
  * `useLayoutEffect`, so an unguarded throw from ONE subscriber does not just
  * lose that subscriber — it skips every listener after it (the i18n language
  * bridge, the chart-direction bridge, the Electron `nativeTheme` mirror) and

package/dist/theme/subscribe.js

@@ -10,7 +10,7 @@ export function subscribeTheme(listener) {
  * @internal Called by ThemeProvider after stamping `<html>`. Not part of the
  * public API.
  *
- * Each listener is isolated (23 §4.4). This runs inside ThemeProvider's
+ * Each listener is isolated. This runs inside ThemeProvider's
  * `useLayoutEffect`, so an unguarded throw from ONE subscriber does not just
  * lose that subscriber — it skips every listener after it (the i18n language
  * bridge, the chart-direction bridge, the Electron `nativeTheme` mirror) and

package/dist/theme/types.d.ts

@@ -1,17 +1,17 @@
 /**
- * Theming axis types for ThemeProvider (02-design-system.md §4.1).
- * Axis value unions come from `@adminium/tokens` so the DOM attributes,
- * Storybook toolbar and provider can never drift apart; the locale union and
- * the pref/resolved shapes live here because they are UI-runtime concerns.
+ * Theming axis types for ThemeProvider. Axis value unions come from
+ * `@adminium/tokens` so the DOM attributes, Storybook toolbar and provider
+ * can never drift apart; the locale union and the pref/resolved shapes live
+ * here because they are UI-runtime concerns.
  */
 import type { Accent, Density, Dir, ResolvedTheme as ResolvedThemeMode, ThemePref } from '@adminium/tokens';
-/** The 8 COMPILED locales (02-design-system.md §4.1). */
+/** The 8 COMPILED locales. */
 export declare const LOCALES: readonly ["en_US", "de_DE", "ar_EG", "zh_CN", "zh_TW", "cs_CZ", "da_DK", "fr_FR"];
 export type BuiltinLocale = (typeof LOCALES)[number];
 /**
  * Any locale the instance may resolve to — the compiled eight plus whatever
- * an admin created at runtime (23-runtime-translations.md §5). `(string & {})`
- * keeps literal autocomplete for the eight.
+ * an admin created at runtime. `(string & {})` keeps literal autocomplete for
+ * the eight.
  *
  * This package deliberately does NOT depend on `@adminium/i18n`, so it cannot
  * look a custom locale up. Direction therefore arrives one of two ways — an
@@ -34,7 +34,7 @@ export interface ResolvedTheme {
     locale: Locale;
     dir: Dir;
 }
-/** Baseline of the resolution order (BRIEF §7 via `@adminium/tokens`). */
+/** Baseline of the resolution order (BRIEF via `@adminium/tokens`). */
 export declare const BASELINE_PREFS: ThemePrefs;
 /** Direction of the COMPILED locales; `null` for anything else. */
 export declare function builtinLocaleDir(locale: string): Dir | null;
@@ -46,7 +46,7 @@ export declare function builtinLocaleDir(locale: string): Dir | null;
  * order is: an injected resolver (the app has the registry) → the compiled
  * table → the cached `dir` axis from the last resolved paint → `ltr`. The
  * cached axis is what keeps a custom RTL locale from flashing on pre-auth
- * screens, where no bootstrap payload exists yet (23 §5.4).
+ * screens, where no bootstrap payload exists yet.
  */
 export declare function dirForLocale(locale: Locale, opts?: {
     resolve?: ((locale: Locale) => Dir | null) | undefined;
@@ -55,7 +55,7 @@ export declare function dirForLocale(locale: Locale, opts?: {
 /**
  * BCP-47 form of a locale for the `lang` attribute (`ar_EG` → `ar-EG`).
  * Replaces EVERY underscore: a single replacement leaves `zh-Hant_TW`, which
- * is not a valid tag (23 §5.5).
+ * is not a valid tag.
  */
 export declare function langForLocale(locale: Locale): string;
 //# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,GAAG,EACH,aAAa,IAAI,iBAAiB,EAClC,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,yDAAyD;AACzD,eAAO,MAAM,OAAO,mFASV,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnD,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;CACV;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,UAAiC,CAAC;AAE/D,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAG3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,SAAS,CAAA;CAAO,GAC9F,GAAG,CAEL;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,GAAG,EACH,aAAa,IAAI,iBAAiB,EAClC,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,8BAA8B;AAC9B,eAAO,MAAM,OAAO,mFASV,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnD,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;CACV;AAED,uEAAuE;AACvE,eAAO,MAAM,cAAc,EAAE,UAAiC,CAAC;AAE/D,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAG3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,SAAS,CAAA;CAAO,GAC9F,GAAG,CAEL;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/theme/types.js

@@ -1,5 +1,5 @@
 import { DEFAULT_PREFS } from '@adminium/tokens';
-/** The 8 COMPILED locales (02-design-system.md §4.1). */
+/** The 8 COMPILED locales. */
 export const LOCALES = [
     'en_US',
     'de_DE',
@@ -10,7 +10,7 @@ export const LOCALES = [
     'da_DK',
     'fr_FR',
 ];
-/** Baseline of the resolution order (BRIEF §7 via `@adminium/tokens`). */
+/** Baseline of the resolution order (BRIEF via `@adminium/tokens`). */
 export const BASELINE_PREFS = { ...DEFAULT_PREFS };
 /** Direction of the COMPILED locales; `null` for anything else. */
 export function builtinLocaleDir(locale) {
@@ -26,7 +26,7 @@ export function builtinLocaleDir(locale) {
  * order is: an injected resolver (the app has the registry) → the compiled
  * table → the cached `dir` axis from the last resolved paint → `ltr`. The
  * cached axis is what keeps a custom RTL locale from flashing on pre-auth
- * screens, where no bootstrap payload exists yet (23 §5.4).
+ * screens, where no bootstrap payload exists yet.
  */
 export function dirForLocale(locale, opts = {}) {
     return opts.resolve?.(locale) ?? builtinLocaleDir(locale) ?? opts.cached ?? 'ltr';
@@ -34,7 +34,7 @@ export function dirForLocale(locale, opts = {}) {
 /**
  * BCP-47 form of a locale for the `lang` attribute (`ar_EG` → `ar-EG`).
  * Replaces EVERY underscore: a single replacement leaves `zh-Hant_TW`, which
- * is not a valid tag (23 §5.5).
+ * is not a valid tag.
  */
 export function langForLocale(locale) {
     return locale.replaceAll('_', '-');

package/dist/theme/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,yDAAyD;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAgCX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAe,EAAE,GAAG,aAAa,EAAE,CAAC;AAE/D,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAE,OAA6B,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,OAA6F,EAAE;IAE/F,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAgCX,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAe,EAAE,GAAG,aAAa,EAAE,CAAC;AAE/D,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAE,OAA6B,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,OAA6F,EAAE;IAE/F,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/theme/useTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU5D,4FAA4F;AAC5F,wBAAgB,QAAQ,IAAI,aAAa,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAGA"}
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU5D,4FAA4F;AAC5F,wBAAgB,QAAQ,IAAI,aAAa,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAGA"}

package/dist/theme/useTheme.js

@@ -1,8 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * Theme hooks (02-design-system.md §4.1).
- * `useTheme` → resolved values for rendering; `useThemePrefs` → raw prefs +
- * `setPref` for the appearance settings UI.
+ * Theme hooks. `useTheme` → resolved values for rendering; `useThemePrefs`
+ * → raw prefs + `setPref` for the appearance settings UI.
  */
 import { useContext } from 'react';
 import { ThemeContext } from './context.js';

package/dist/theme/useTheme.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAA4C,MAAM,cAAc,CAAC;AAGtF,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,QAAQ;IACtB,OAAO,uBAAuB,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAK3B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAA4C,MAAM,cAAc,CAAC;AAGtF,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,QAAQ;IACtB,OAAO,uBAAuB,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAK3B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminiumjs/ui",
-  "version": "0.2.9",
+  "version": "0.3.0-rc.0",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
@@ -23,7 +23,7 @@
     }
   },
   "dependencies": {
-    "@adminium/tokens": "npm:@adminiumjs/tokens@0.2.9",
+    "@adminium/tokens": "npm:@adminiumjs/tokens@0.3.0-rc.0",
     "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-direction": "^1.1.1",