@skdx/tokens 0.27.0 → 0.28.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SkandaDX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -29,7 +29,7 @@ import { applyTheme, defaultTheme, foundationToCss } from '@skdx/tokens';
 
 // Once: the type scale, spacing, radii, shadow geometry and motion every theme shares.
 document.head.appendChild(
-  Object.assign(document.createElement('style'), { textContent: foundationToCss() })
+  Object.assign(document.createElement('style'), { textContent: foundationToCss() }),
 );
 // Per theme: colors.
 applyTheme(defaultTheme);
@@ -50,14 +50,14 @@ applyTheme(defaultTheme);
 ## The theme contract
 
 **A theme is colors.** The type scale, spacing, radii, shadow geometry and motion are identical
-in all 38 bundled themes, so they aren't part of a theme at all — they're the *foundation*,
+in all 38 bundled themes, so they aren't part of a theme at all — they're the _foundation_,
 exported once and emitted at `:root` by `foundationToCss()`.
 
-| Group                                                           | Type                | Contents                                                                                                                                              |
-| --------------------------------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `colors.primary` / `neutral` / `success` / `warning` / `danger` | `ColorScale`        | 11-step scales, `50` (lightest) → `950` (darkest)                                                                                                     |
-| `colors.semantic`                                               | `SemanticColors`    | Purpose-driven colors: `background`, `surface`, `surfaceHover`, `overlay`, `text`, `textMuted`, `textInverted`, `border`, `borderStrong`, `focusRing` |
-| `shadow`                                                        | `ThemeShadowColor`  | The color half of the shared shadow geometry: `color` (an sRGB triple like `'2 6 23'`) and `strength` (a multiplier on the shared base alphas)         |
+| Group                                                           | Type               | Contents                                                                                                                                              |
+| --------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `colors.primary` / `neutral` / `success` / `warning` / `danger` | `ColorScale`       | 11-step scales, `50` (lightest) → `950` (darkest)                                                                                                     |
+| `colors.semantic`                                               | `SemanticColors`   | Purpose-driven colors: `background`, `surface`, `surfaceHover`, `overlay`, `text`, `textMuted`, `textInverted`, `border`, `borderStrong`, `focusRing` |
+| `shadow`                                                        | `ThemeShadowColor` | The color half of the shared shadow geometry: `color` (an sRGB triple like `'2 6 23'`) and `strength` (a multiplier on the shared base alphas)        |
 
 Components should use the **semantic** colors (`colors.semantic.*`) wherever possible and reach into the raw scales only for accents — that is what lets one component tree re-brand cleanly across light and dark themes.
 
@@ -65,18 +65,18 @@ Components should use the **semantic** colors (`colors.semantic.*`) wherever pos
 
 Imported as bare named exports, not read off a theme:
 
-| Export       | Type              | Contents                                                                                                                            |
-| ------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `typography` | `ThemeTypography` | `fontFamily`, `fontFamilyMono`, `fontSize` (`xs`–`3xl`), `fontWeight` (`regular`–`bold`), `lineHeight`, `letterSpacing`             |
-| `space`      | `ThemeSpace`      | Spacing steps `1`–`16` (`0.25rem`–`4rem`)                                                                                            |
-| `radii`      | `ThemeRadii`      | `sm`, `md`, `lg`, `xl`, `full`                                                                                                       |
-| `shadows`    | `ThemeShadows`    | `sm`, `md`, `lg`, `overlay` — geometry only; each defers its color to `var(--skdx-shadow-color)` / `var(--skdx-shadow-strength)`      |
-| `motion`     | `ThemeMotion`     | `durationFast`/`Normal`/`Slow`, `easing`, plus the optional `easingExit`/`Steady`/`Linear` and the two staggers                       |
+| Export       | Type              | Contents                                                                                                                         |
+| ------------ | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `typography` | `ThemeTypography` | `fontFamily`, `fontFamilyMono`, `fontSize` (`xs`–`3xl`), `fontWeight` (`regular`–`bold`), `lineHeight`, `letterSpacing`          |
+| `space`      | `ThemeSpace`      | Spacing steps `1`–`16` (`0.25rem`–`4rem`)                                                                                        |
+| `radii`      | `ThemeRadii`      | `sm`, `md`, `lg`, `xl`, `full`                                                                                                   |
+| `shadows`    | `ThemeShadows`    | `sm`, `md`, `lg`, `overlay` — geometry only; each defers its color to `var(--skdx-shadow-color)` / `var(--skdx-shadow-strength)` |
+| `motion`     | `ThemeMotion`     | `durationFast`/`Normal`/`Slow`, `easing`, plus the optional `easingExit`/`Steady`/`Linear` and the two staggers                  |
 
 ### The two escape hatches
 
 A theme may optionally declare `typography` (just `fontFamily` / `fontFamilyMono`) and `motion`
-(just the four base tokens). Declaring one *is* the deviation — there is no wrapper to opt into,
+(just the four base tokens). Declaring one _is_ the deviation — there is no wrapper to opt into,
 and they re-emit at the theme's own higher-specificity selector so `[data-skdx-theme="material-you"]`
 beats `:root`.
 
@@ -108,7 +108,7 @@ The original twenty-two themes are unchanged (names, exports, and light-mode val
 | `emeraldBrand`    | `emerald-brand`     | Fresh greens, soft mint surfaces, tight corners                                     |
 | `midnightBrand`   | `midnight-brand`    | Dark theme — violet actions on deep indigo surfaces                                 |
 | `graphiteBrand`   | `graphite`          | Monochrome, shadcn/ui-zinc spirit: near-black actions, quiet grays                  |
-| `materialBrand`   | `material-you`      | Material Design 3 inspired: tonal purple, Roboto, M3's slower emphasized motion      |
+| `materialBrand`   | `material-you`      | Material Design 3 inspired: tonal purple, Roboto, M3's slower emphasized motion     |
 | `antBrand`        | `ant-daybreak`      | Ant Design inspired: daybreak blue, compact corners                                 |
 | `fluentBrand`     | `fluent`            | Microsoft Fluent 2 inspired: communication blue, Segoe UI                           |
 | `chakraBrand`     | `chakra-teal`       | Chakra UI inspired: teal actions, blue focus ring                                   |
@@ -146,7 +146,7 @@ The original twenty-two themes are unchanged (names, exports, and light-mode val
 `themes` exports all thirty-eight as an array — handy for theme pickers and galleries:
 
 ```ts
-import { themes, applyTheme } from '@skdx/tokens';
+import { applyTheme, themes } from '@skdx/tokens';
 
 themes.map((t) => t.name); // ['skanda-light', 'emerald-brand', ...]
 applyTheme(themes.find((t) => t.name === 'nord-dark')!);
@@ -197,7 +197,7 @@ Sets all variables as inline styles on `element` (default `document.documentElem
 Renders a theme as a CSS rule, ready to inject into a `<style>` tag or write to a file at build time:
 
 ```ts
-import { themeToCss, nordDark } from '@skdx/tokens';
+import { nordDark, themeToCss } from '@skdx/tokens';
 
 themeToCss(nordDark);
 // [data-skdx-theme="nord-dark"] {
@@ -238,7 +238,17 @@ way color is. Every theme should behave the same way, so they're exported once a
 rather than duplicated into all 38 `Theme` objects:
 
 ```ts
-import { typography, space, radii, zIndex, focusRing, borderWidth, opacity, breakpoints, foundationToCss } from '@skdx/tokens';
+import {
+  borderWidth,
+  breakpoints,
+  focusRing,
+  foundationToCss,
+  opacity,
+  radii,
+  space,
+  typography,
+  zIndex,
+} from '@skdx/tokens';
 
 typography.fontSize.md; // '1rem'
 space['4']; // '1rem'
@@ -250,7 +260,9 @@ opacity.disabled; // '0.5'
 breakpoints.lg; // 1024 (a number — see below)
 
 // Inject once. Without it the shared half of the --skdx-* surface does not exist.
-document.head.appendChild(Object.assign(document.createElement('style'), { textContent: foundationToCss() }));
+document.head.appendChild(
+  Object.assign(document.createElement('style'), { textContent: foundationToCss() }),
+);
 ```
 
 `zIndex` scale (low → high): `base`, `dropdown`, `sticky`, `overlay`, `modal`, `popover`, `toast`, `max`.
@@ -302,14 +314,21 @@ theme (see `themeToCss`).
 
 ```ts
 // Nuxt — nuxt.config.ts
-app: { head: { script: [{ innerHTML: getThemeInitScript(), tagPosition: 'head' }] } }
+app: {
+  head: {
+    script: [{ innerHTML: getThemeInitScript(), tagPosition: 'head' }];
+  }
+}
 ```
 
+<!-- prettier-ignore -->
 ```html
 <!-- SvelteKit — src/app.html; replace the placeholder from a Vite plugin at build time -->
 <head>
   %sveltekit.head%
-  <script>%skdx.themeInit%</script>
+  <script>
+    %skdx.themeInit%
+  </script>
 </head>
 ```
 
@@ -347,8 +366,8 @@ of the two blocks declares them moved.
 
 From a `Theme`, at `[data-skdx-theme="…"]`:
 
-| Theme path                     | CSS variable                         |
-| ------------------------------ | ------------------------------------ |
+| Theme path                     | CSS variable                          |
+| ------------------------------ | ------------------------------------- |
 | `colors.primary[500]`          | `--skdx-color-primary-500`            |
 | `colors.semantic.surfaceHover` | `--skdx-color-semantic-surface-hover` |
 | `shadow.color`                 | `--skdx-shadow-color`                 |
@@ -356,18 +375,18 @@ From a `Theme`, at `[data-skdx-theme="…"]`:
 
 From the foundation, at `:root`:
 
-| Foundation path             | CSS variable                     |
-| --------------------------- | -------------------------------- |
-| `typography.fontFamily`     | `--skdx-font-family`              |
-| `typography.fontSize.md`    | `--skdx-font-size-md`             |
-| `typography.fontWeight.semibold` | `--skdx-font-weight-semibold`|
-| `typography.lineHeight.tight`    | `--skdx-font-line-height-tight` |
+| Foundation path                  | CSS variable                      |
+| -------------------------------- | --------------------------------- |
+| `typography.fontFamily`          | `--skdx-font-family`              |
+| `typography.fontSize.md`         | `--skdx-font-size-md`             |
+| `typography.fontWeight.semibold` | `--skdx-font-weight-semibold`     |
+| `typography.lineHeight.tight`    | `--skdx-font-line-height-tight`   |
 | `typography.letterSpacing.wide`  | `--skdx-font-letter-spacing-wide` |
-| `space[4]`                  | `--skdx-space-4`                  |
-| `radii.md`                  | `--skdx-radius-md`                |
-| `shadows.overlay`           | `--skdx-shadow-overlay`           |
-| `motion.durationFast`       | `--skdx-motion-duration-fast`     |
-| `motion.easing`             | `--skdx-motion-easing`            |
+| `space[4]`                       | `--skdx-space-4`                  |
+| `radii.md`                       | `--skdx-radius-md`                |
+| `shadows.overlay`                | `--skdx-shadow-overlay`           |
+| `motion.durationFast`            | `--skdx-motion-duration-fast`     |
+| `motion.easing`                  | `--skdx-motion-easing`            |
 
 The pattern: section prefix (`color`, `font`, `space`, `radius`, `shadow`, `motion`) followed by the kebab-cased path within that group. When the path already starts with the section prefix (typography's `fontSize`, `fontFamily`, `fontWeight`), the prefix is not doubled — `--skdx-font-size-md`, not `--skdx-font-font-size-md`.
 
@@ -379,7 +398,8 @@ A shadow resolves across both blocks:
 
 ```css
 /* :root, from foundationToCss() */
---skdx-shadow-md: 0 4px 6px -1px rgb(var(--skdx-shadow-color) / calc(0.1 * var(--skdx-shadow-strength))), …;
+--skdx-shadow-md:
+  0 4px 6px -1px rgb(var(--skdx-shadow-color) / calc(0.1 * var(--skdx-shadow-strength))), …;
 /* [data-skdx-theme="nord-dark"], from themeToCss() */
 --skdx-shadow-color: 0 0 0;
 --skdx-shadow-strength: 4.7;
@@ -391,27 +411,27 @@ run around `5`. It's a look, not a measurement — tune it by eye.
 
 ## API summary
 
-| Export                                | Kind             | Description                                                       |
-| ------------------------------------- | ---------------- | ----------------------------------------------------------------- |
-| `defaultTheme`                        | `Theme`          | The reference theme (`skanda-light`)                              |
-| `createTheme(name, override?, base?)` | function         | Deep-merge a partial override into a base theme                   |
-| `themeToCssVars(theme)`               | function         | Theme → flat `--skdx-*` variable map                               |
-| `themeToCss(theme, options?)`         | function         | Theme → CSS rule string (scoped to `[data-skdx-theme]` by default) |
-| `applyTheme(theme, element?)`         | function         | Set variables inline on an element at runtime                     |
-| `skandaLight` … `synthwaveDark`       | `Theme` × 38     | Built-in brand themes (19 brands × light/dark)                    |
-| `watchSystemMode(options?)`           | function         | Apply a brand's theme from `prefers-color-scheme`, and on change  |
-| `getThemeInitScript(options?)`        | function         | Pre-paint snippet that stamps `data-skdx-theme`/`-mode` (no FOUC)  |
-| `zIndex`                              | `ZIndexScale`    | Non-themed overlay stacking-order scale (`base`…`max`)            |
-| `focusRing`                           | `FocusRingScale` | Non-themed focus-ring `width`/`offset`                            |
-| `borderWidth`                         | `BorderWidthScale` | Non-themed `thin`/`thick`/`thicker` border thicknesses          |
-| `opacity`                             | `OpacityScale`   | Non-themed `disabled` and `scrim` opacities                       |
-| `breakpoints`                         | `BreakpointScale` | Viewport widths in px — TS only, never emitted as CSS vars       |
-| `typography` / `space` / `radii` / `shadows` / `motion` | constants | The shared scales every theme inherits — not per-theme |
-| `foundationToCss()`                   | function         | The shared scales + `zIndex`/`focusRing`/`borderWidth`/`opacity` → a `:root` CSS block, plus its reduced-motion override |
-| `foundationToCssVars()`               | function         | The same, as a flat `--skdx-*` variable map |
-| `contrastRatio(hexA, hexB)`           | function         | WCAG relative-luminance contrast ratio between two colors         |
-| `themes`                              | `Theme[]`        | All built-in themes                                               |
-| `Theme`, `ThemeOverride`, …           | types            | The full theme contract                                           |
+| Export                                                  | Kind               | Description                                                                                                              |
+| ------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| `defaultTheme`                                          | `Theme`            | The reference theme (`skanda-light`)                                                                                     |
+| `createTheme(name, override?, base?)`                   | function           | Deep-merge a partial override into a base theme                                                                          |
+| `themeToCssVars(theme)`                                 | function           | Theme → flat `--skdx-*` variable map                                                                                     |
+| `themeToCss(theme, options?)`                           | function           | Theme → CSS rule string (scoped to `[data-skdx-theme]` by default)                                                       |
+| `applyTheme(theme, element?)`                           | function           | Set variables inline on an element at runtime                                                                            |
+| `skandaLight` … `synthwaveDark`                         | `Theme` × 38       | Built-in brand themes (19 brands × light/dark)                                                                           |
+| `watchSystemMode(options?)`                             | function           | Apply a brand's theme from `prefers-color-scheme`, and on change                                                         |
+| `getThemeInitScript(options?)`                          | function           | Pre-paint snippet that stamps `data-skdx-theme`/`-mode` (no FOUC)                                                        |
+| `zIndex`                                                | `ZIndexScale`      | Non-themed overlay stacking-order scale (`base`…`max`)                                                                   |
+| `focusRing`                                             | `FocusRingScale`   | Non-themed focus-ring `width`/`offset`                                                                                   |
+| `borderWidth`                                           | `BorderWidthScale` | Non-themed `thin`/`thick`/`thicker` border thicknesses                                                                   |
+| `opacity`                                               | `OpacityScale`     | Non-themed `disabled` and `scrim` opacities                                                                              |
+| `breakpoints`                                           | `BreakpointScale`  | Viewport widths in px — TS only, never emitted as CSS vars                                                               |
+| `typography` / `space` / `radii` / `shadows` / `motion` | constants          | The shared scales every theme inherits — not per-theme                                                                   |
+| `foundationToCss()`                                     | function           | The shared scales + `zIndex`/`focusRing`/`borderWidth`/`opacity` → a `:root` CSS block, plus its reduced-motion override |
+| `foundationToCssVars()`                                 | function           | The same, as a flat `--skdx-*` variable map                                                                              |
+| `contrastRatio(hexA, hexB)`                             | function           | WCAG relative-luminance contrast ratio between two colors                                                                |
+| `themes`                                                | `Theme[]`          | All built-in themes                                                                                                      |
+| `Theme`, `ThemeOverride`, …                             | types              | The full theme contract                                                                                                  |
 
 ## Package layout
 

package/dist/themes/AntDark.d.cts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `ant-daybreak`, following Ant Design's dark
- * algorithm surfaces (#141414 / #1f1f1f) and daybreak-blue accents.
- *
- * The accent comes from Ant's *dark* daybreak ramp rather than the light
- * one — Ant's dark algorithm re-derives the palette against #141414, and
- * the light ramp's blue-7 lands at 2.99:1 there. This takes the dark ramp's
- * seventh step, which clears the gate with dark ink on the filled state.
+ * Dark counterpart of Ant Design dark surfaces (#141414 / #1f1f1f)
+ * with daybreak blue accents. Uses the dark-derived blue; the light ramp's
+ * blue reaches only 2.99:1 contrast on dark backgrounds.
  *
  * @public
  */

package/dist/themes/AntDark.d.ts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `ant-daybreak`, following Ant Design's dark
- * algorithm surfaces (#141414 / #1f1f1f) and daybreak-blue accents.
- *
- * The accent comes from Ant's *dark* daybreak ramp rather than the light
- * one — Ant's dark algorithm re-derives the palette against #141414, and
- * the light ramp's blue-7 lands at 2.99:1 there. This takes the dark ramp's
- * seventh step, which clears the gate with dark ink on the filled state.
+ * Dark counterpart of Ant Design dark surfaces (#141414 / #1f1f1f)
+ * with daybreak blue accents. Uses the dark-derived blue; the light ramp's
+ * blue reaches only 2.99:1 contrast on dark backgrounds.
  *
  * @public
  */

package/dist/themes/ChakraDark.d.cts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `chakra-teal`, following Chakra UI's dark gray.800
- * body background.
- *
- * `primary-600` is Chakra's `teal.300` rather than the light theme's
- * `teal.600`: Chakra's own dark-mode components step the accent up the
- * scale (`teal.200`/`teal.300`) so it reads against `gray.800`, and ink on
- * the filled state becomes `gray.800` in turn.
+ * Dark counterpart of `chakra-teal`, with Chakra UI's dark gray backgrounds.
+ * Uses `teal.300` instead of the light theme's `teal.600` for contrast on
+ * dark surfaces.
  *
  * @public
  */

package/dist/themes/ChakraDark.d.ts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `chakra-teal`, following Chakra UI's dark gray.800
- * body background.
- *
- * `primary-600` is Chakra's `teal.300` rather than the light theme's
- * `teal.600`: Chakra's own dark-mode components step the accent up the
- * scale (`teal.200`/`teal.300`) so it reads against `gray.800`, and ink on
- * the filled state becomes `gray.800` in turn.
+ * Dark counterpart of `chakra-teal`, with Chakra UI's dark gray backgrounds.
+ * Uses `teal.300` instead of the light theme's `teal.600` for contrast on
+ * dark surfaces.
  *
  * @public
  */

package/dist/themes/DefaultTheme.d.cts

@@ -5,8 +5,7 @@ import { type Theme, type ThemeOverride } from '../utils/theme.cjs';
  * produces) is created as a `ThemeOverride` of this base via {@link createTheme}.
  *
  * Colors and a shadow tint, nothing else — the type scale, spacing, radii,
- * shadow geometry and motion this theme used to restate are shared by every
- * theme and live in `utils/foundation.ts`.
+ * shadow geometry and motion are shared by every theme and live in `utils/foundation.ts`.
  *
  * @public
  */

package/dist/themes/DefaultTheme.d.ts

@@ -5,8 +5,7 @@ import { type Theme, type ThemeOverride } from '../utils/theme.js';
  * produces) is created as a `ThemeOverride` of this base via {@link createTheme}.
  *
  * Colors and a shadow tint, nothing else — the type scale, spacing, radii,
- * shadow geometry and motion this theme used to restate are shared by every
- * theme and live in `utils/foundation.ts`.
+ * shadow geometry and motion are shared by every theme and live in `utils/foundation.ts`.
  *
  * @public
  */

package/dist/themes/DraculaLight.d.cts

@@ -1,13 +1,5 @@
 /**
- * Light counterpart of `dracula` — **Alucard**, Dracula's own light theme,
- * rather than an inversion of the dark one. Alucard is a distinct published
- * palette: a warm `#fffbeb` paper, `#1f1f1f` ink, and a deeper `#644ac9`
- * purple in place of Dracula's `#bd93f9`.
- *
- * This previously promoted Dracula's *foreground* (`#f8f8f2`) to the page
- * background and darkened the dark theme's purple to clear AA, which is not
- * a palette Dracula publishes — the two modes read as one theme at two
- * brightnesses instead of as Dracula and Alucard.
+ * Light counterpart of `dracula` — Alucard's published palette, not an inversion of the dark theme.
  *
  * @public
  */

package/dist/themes/DraculaLight.d.ts

@@ -1,13 +1,5 @@
 /**
- * Light counterpart of `dracula` — **Alucard**, Dracula's own light theme,
- * rather than an inversion of the dark one. Alucard is a distinct published
- * palette: a warm `#fffbeb` paper, `#1f1f1f` ink, and a deeper `#644ac9`
- * purple in place of Dracula's `#bd93f9`.
- *
- * This previously promoted Dracula's *foreground* (`#f8f8f2`) to the page
- * background and darkened the dark theme's purple to clear AA, which is not
- * a palette Dracula publishes — the two modes read as one theme at two
- * brightnesses instead of as Dracula and Alucard.
+ * Light counterpart of `dracula` — Alucard's published palette, not an inversion of the dark theme.
  *
  * @public
  */

package/dist/themes/EverforestDark.d.cts

@@ -1,8 +1,7 @@
 import type { Theme } from '../utils/theme.cjs';
 /**
- * Everforest Dark inspired theme: comfortable green-on-forest palette with
+ * Everforest Dark inspired theme: green-on-forest palette with
  * warm cream text, sage green actions, and aqua/yellow/red status hues.
- * Palette source: sainnhe/everforest (MIT).
  *
  * @public
  */

package/dist/themes/EverforestDark.d.ts

@@ -1,8 +1,7 @@
 import type { Theme } from '../utils/theme.js';
 /**
- * Everforest Dark inspired theme: comfortable green-on-forest palette with
+ * Everforest Dark inspired theme: green-on-forest palette with
  * warm cream text, sage green actions, and aqua/yellow/red status hues.
- * Palette source: sainnhe/everforest (MIT).
  *
  * @public
  */

package/dist/themes/EverforestLight.d.cts

@@ -1,12 +1,8 @@
 /**
- * Light counterpart of `everforest-dark`, built on Everforest's light
- * palette (#fdf6e3 background, sage greens). Palette source:
- * sainnhe/everforest (MIT).
- *
- * `primary-500` is Everforest light's own green (#8da101), an olive that
- * shares no channel with the dark palette's sage #a7c080 — the upstream
- * light and dark foregrounds are separately specified, not one ramp read at
- * two depths. 600 darkens it to clear white label text.
+ * Light counterpart of `everforest-dark`, with Everforest's light palette
+ * (#fdf6e3 background, sage greens). Uses Everforest's light-specific green
+ * (#8da101), not a derivative of the dark palette. At 600 it clears
+ * white label text.
  *
  * @public
  */

package/dist/themes/EverforestLight.d.ts

@@ -1,12 +1,8 @@
 /**
- * Light counterpart of `everforest-dark`, built on Everforest's light
- * palette (#fdf6e3 background, sage greens). Palette source:
- * sainnhe/everforest (MIT).
- *
- * `primary-500` is Everforest light's own green (#8da101), an olive that
- * shares no channel with the dark palette's sage #a7c080 — the upstream
- * light and dark foregrounds are separately specified, not one ramp read at
- * two depths. 600 darkens it to clear white label text.
+ * Light counterpart of `everforest-dark`, with Everforest's light palette
+ * (#fdf6e3 background, sage greens). Uses Everforest's light-specific green
+ * (#8da101), not a derivative of the dark palette. At 600 it clears
+ * white label text.
  *
  * @public
  */

package/dist/themes/FluentDark.d.cts

@@ -1,10 +1,6 @@
 /**
- * Dark counterpart of `fluent`, following Microsoft Fluent 2 dark neutral
- * backgrounds (#1f1f1f / #292929) with the brighter Fluent blue.
- *
- * `primary-600` is Fluent's `brand[100]` (#479ef5) — the shade Fluent's own
- * dark theme points `colorBrandForeground1` at, where light points it at
- * `brand[80]`. Ink is `brand[10]`, the darkest rung of the same ramp.
+ * Dark counterpart of `fluent`, with Fluent 2 dark neutral backgrounds
+ * (#1f1f1f / #292929) and the brighter Fluent blue shade.
  *
  * @public
  */

package/dist/themes/FluentDark.d.ts

@@ -1,10 +1,6 @@
 /**
- * Dark counterpart of `fluent`, following Microsoft Fluent 2 dark neutral
- * backgrounds (#1f1f1f / #292929) with the brighter Fluent blue.
- *
- * `primary-600` is Fluent's `brand[100]` (#479ef5) — the shade Fluent's own
- * dark theme points `colorBrandForeground1` at, where light points it at
- * `brand[80]`. Ink is `brand[10]`, the darkest rung of the same ramp.
+ * Dark counterpart of `fluent`, with Fluent 2 dark neutral backgrounds
+ * (#1f1f1f / #292929) and the brighter Fluent blue shade.
  *
  * @public
  */

package/dist/themes/GruvboxLight.d.cts

@@ -1,7 +1,6 @@
 /**
  * Light counterpart of `gruvbox-dark`, built on Gruvbox's light palette
- * (#fbf1c7 cream background, warm gray text). Palette source:
- * morhetz/gruvbox (MIT/X11).
+ * (#fbf1c7 cream background, warm gray text).
  *
  * Gruvbox ships three blues and picks between them by mode: `bright_blue`
  * (#83a598) for dark, `faded_blue` (#076678) for light, with `neutral_blue`

package/dist/themes/GruvboxLight.d.ts

@@ -1,7 +1,6 @@
 /**
  * Light counterpart of `gruvbox-dark`, built on Gruvbox's light palette
- * (#fbf1c7 cream background, warm gray text). Palette source:
- * morhetz/gruvbox (MIT/X11).
+ * (#fbf1c7 cream background, warm gray text).
  *
  * Gruvbox ships three blues and picks between them by mode: `bright_blue`
  * (#83a598) for dark, `faded_blue` (#076678) for light, with `neutral_blue`

package/dist/themes/MaterialBrand.d.cts

@@ -1,3 +1,3 @@
 import type { Theme } from '../utils/theme.cjs';
-/** Material Design 3 inspired: tonal purple, generous shape scale, emphasized easing. @public */
+/** Tonal purple light theme. @public */
 export declare const materialBrand: Theme;

package/dist/themes/MaterialBrand.d.ts

@@ -1,3 +1,3 @@
 import type { Theme } from '../utils/theme.js';
-/** Material Design 3 inspired: tonal purple, generous shape scale, emphasized easing. @public */
+/** Tonal purple light theme. @public */
 export declare const materialBrand: Theme;

package/dist/themes/MaterialDark.d.cts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `material-you`, following Material Design 3 dark
- * surfaces (#1c1b1f) with the M3 light-lavender primary accent.
- *
- * `primary-600` is M3's `Primary80` (#d0bcff) and `textInverted` its paired
- * `onPrimary` for dark (#381e72) — the baseline scheme moves the primary
- * role from tone 40 in light to tone 80 in dark, so reusing the light
- * theme's tone-40 violet here left the accent invisible on M3's own surface.
+ * Dark counterpart of Material Design 3 dark surfaces (#1c1b1f)
+ * with light-lavender accents. The dark theme shifts primary from tone 40
+ * to tone 80; using light's tone-40 left the accent invisible.
  *
  * @public
  */

package/dist/themes/MaterialDark.d.ts

@@ -1,11 +1,7 @@
 /**
- * Dark counterpart of `material-you`, following Material Design 3 dark
- * surfaces (#1c1b1f) with the M3 light-lavender primary accent.
- *
- * `primary-600` is M3's `Primary80` (#d0bcff) and `textInverted` its paired
- * `onPrimary` for dark (#381e72) — the baseline scheme moves the primary
- * role from tone 40 in light to tone 80 in dark, so reusing the light
- * theme's tone-40 violet here left the accent invisible on M3's own surface.
+ * Dark counterpart of Material Design 3 dark surfaces (#1c1b1f)
+ * with light-lavender accents. The dark theme shifts primary from tone 40
+ * to tone 80; using light's tone-40 left the accent invisible.
  *
  * @public
  */

package/dist/themes/MidnightBrand.d.cts

@@ -1,10 +1,7 @@
 /**
  * Midnight purple dark theme: violet actions on deep indigo surfaces.
- *
- * The first brand generated from a `BrandSeed` rather than hand-written — its
- * ramps and semantic roles come out of {@link createBrandTheme}, which drives
- * every WCAG AA pair to threshold instead of leaving it to review. Only the
- * dark shadow stack is hand-kept, since shadow alpha isn't derived from hue.
+ * Generated from `BrandSeed` via {@link createBrandTheme}, which drives
+ * every WCAG AA pair to threshold. Shadow stack is hand-tuned.
  *
  * @public
  */

package/dist/themes/MidnightBrand.d.ts

@@ -1,10 +1,7 @@
 /**
  * Midnight purple dark theme: violet actions on deep indigo surfaces.
- *
- * The first brand generated from a `BrandSeed` rather than hand-written — its
- * ramps and semantic roles come out of {@link createBrandTheme}, which drives
- * every WCAG AA pair to threshold instead of leaving it to review. Only the
- * dark shadow stack is hand-kept, since shadow alpha isn't derived from hue.
+ * Generated from `BrandSeed` via {@link createBrandTheme}, which drives
+ * every WCAG AA pair to threshold. Shadow stack is hand-tuned.
  *
  * @public
  */

package/dist/themes/MidnightLight.d.cts

@@ -1,9 +1,6 @@
 /**
- * Light counterpart of `midnight-brand` — the same violet primary ramp on
- * white surfaces with lavender-tinted borders. Generated from the same seed
- * as its dark twin (only `mode` differs), so the two modes cannot drift apart
- * the way two hand-written files can. Its shadow stack is the default one, so
- * unlike the dark theme it needs no override at all.
+ * Light counterpart of `midnight-brand` — violet primary ramp on white surfaces
+ * with lavender-tinted borders. Generated from the same seed as its dark twin.
  *
  * @public
  */

package/dist/themes/MidnightLight.d.ts

@@ -1,9 +1,6 @@
 /**
- * Light counterpart of `midnight-brand` — the same violet primary ramp on
- * white surfaces with lavender-tinted borders. Generated from the same seed
- * as its dark twin (only `mode` differs), so the two modes cannot drift apart
- * the way two hand-written files can. Its shadow stack is the default one, so
- * unlike the dark theme it needs no override at all.
+ * Light counterpart of `midnight-brand` — violet primary ramp on white surfaces
+ * with lavender-tinted borders. Generated from the same seed as its dark twin.
  *
  * @public
  */

package/dist/themes/NordLight.d.cts

@@ -1,7 +1,6 @@
 /**
  * Light counterpart of `nord-dark`, built on Nord's Snow Storm palette
- * (#eceff4 / #e5e9f0 / #d8dee9) with Polar Night text. Palette source:
- * nordtheme/nord (MIT).
+ * (#eceff4 / #e5e9f0 / #d8dee9) with Polar Night text.
  *
  * Nord publishes no light theme, so the mode split is made inside Frost
  * rather than invented: light takes `nord10` (#5e81ac), the deepest Frost

package/dist/themes/NordLight.d.ts

@@ -1,7 +1,6 @@
 /**
  * Light counterpart of `nord-dark`, built on Nord's Snow Storm palette
- * (#eceff4 / #e5e9f0 / #d8dee9) with Polar Night text. Palette source:
- * nordtheme/nord (MIT).
+ * (#eceff4 / #e5e9f0 / #d8dee9) with Polar Night text.
  *
  * Nord publishes no light theme, so the mode split is made inside Frost
  * rather than invented: light takes `nord10` (#5e81ac), the deepest Frost