@weasel-js/theme 1.6.0 → 1.6.1

package/dist/{themes-bTfTZjCh.d.ts → definition-DLdTdFWs.d.ts}

@@ -39,195 +39,6 @@ interface RawToken {
  *  prefix). Still unresolved — see `ResolvedTokenMap` for the output side. */
 type FlatTokens = Record<string, RawToken>;
 
-/**
- * A theme ready to resolve: its axes and its tokens, each plain or varying by
- * axis, references intact. A `by` that leaves a value out contributes nothing
- * for that selection, so the theme it extends supplies it.
- */
-interface Theme {
-    readonly name: string;
-    readonly extends: Theme | null;
-    readonly axes: AxisDefs;
-    readonly tokens: Readonly<Record<string, Varying<RawToken>>>;
-    /** Ramp name → step names in order, for the ramps this theme declares itself. */
-    readonly ramps?: Readonly<Record<string, readonly string[]>>;
-    /** The colors a `tone` index picks from. Absent: the nearest theme it extends that has one. */
-    readonly tones?: SerializableColorList;
-}
-/** What `defineTheme` accepts: a definition whose `extends` is a `Theme`, holding pins and components only. */
-type ThemeInput = Omit<ThemeDefinition, 'extends'> & {
-    readonly extends?: Theme | null;
-};
-/** The built-in theme, from the baked output of themes/weasel.json. */
-declare const weaselTheme: Theme;
-/**
- * Build a theme from pins. Unless `extends` says otherwise the result layers
- * onto `weaselTheme`, so a theme only names what it changes. A definition with
- * seeds, ramps, scales or semantics needs deriving first.
- */
-declare function defineTheme(input: ThemeInput): Theme;
-
-/** The output of `resolveTheme`: every token of a theme, for one selection, keyed
- *  by CSS custom-property name and flattened to a final CSS value. */
-type ResolvedTheme = Readonly<Record<TokenName, string>>;
-/** Every axis the chain declares. An axis declared more than once keeps every value; a descendant's value entries and default win. */
-declare function themeAxes(theme: Theme): AxisDefs;
-/**
- * Merge the extends chain at a selection, resolve every alias, and key the
- * result by CSS custom-property name. A missing or unknown axis value takes the
- * axis default.
- *
- * Pure — no DOM. An unresolvable reference throws rather than falling back.
- */
-declare function resolveTheme(theme: Theme, selection?: Selection): ResolvedTheme;
-
-/** The categorical generator the swatch ramp uses, asked for `count` colors. */
-interface GeneratedColors {
-    readonly generate: {
-        readonly count: number;
-        readonly gates?: CategoricalRampDef['gates'];
-    };
-}
-/** A ramp of the active theme, by name — `{ ramp: 'swatch' }` walks its steps in order. */
-interface RampColors {
-    readonly ramp: string;
-}
-/** The forms a theme definition can hold: everything but a function. */
-type SerializableColorList = readonly string[] | GeneratedColors | RampColors;
-/**
- * Several colors, read by index with `colorAt`, wrapping. Literals; the swatch
- * ramp's generator; a ramp of the active theme, which follows the mode; or a
- * function of the index.
- */
-type ColorList = SerializableColorList | ((i: number) => string);
-/** What a `ColorList` resolves against. `useTheme()`'s value is one. */
-interface ColorContext {
-    readonly theme: Theme;
-    readonly resolved: ResolvedTheme;
-}
-/** A ramp's step names, from the nearest theme in the chain that declares it. */
-declare function rampSteps(theme: Theme, ramp: string): readonly string[];
-/** The tone list a theme declares, from the nearest theme in its chain that has one. */
-declare function themeTones(theme: Theme): ColorList;
-/** The `i`th color of `list`, wrapping. A ramp list reads the resolved theme, so the answer follows its mode. */
-declare function colorAt(list: ColorList, i: number, ctx?: ColorContext): string;
-/**
- * As `colorAt`, but a ramp list answers with its custom property —
- * `var(--wzl-swatch-sky)` — so a color written into CSS follows a mode change
- * without re-rendering, provider or not.
- */
-declare function colorCssAt(list: ColorList, i: number, ctx?: ColorContext): string;
-/** How many distinct colors `list` holds before it wraps; `undefined` for a function, which never does. */
-declare function colorCount(list: ColorList, ctx?: ColorContext): number | undefined;
-
-/** A number, or `{seeds.name}`. */
-type NumberParam = Varying<number | string>;
-interface PinObject {
-    readonly value: TokenValue;
-    readonly type?: string;
-    readonly description?: string;
-    readonly alpha?: number;
-}
-/** A bare value or `{ value, type?, description?, alpha? }`. The value may be a `{token}` reference. */
-type PinValue = TokenValue | PinObject;
-interface LightnessRampDef {
-    readonly kind: 'lightness';
-    readonly steps: Varying<readonly string[]>;
-    /** First and last step's OKLCH lightness. */
-    readonly lightness: Varying<readonly [NumberParam, NumberParam]>;
-    /** 0 walks evenly; 1 follows a smoothstep S. */
-    readonly curve?: NumberParam;
-    /** Degrees. Ignored when an anchor is given. */
-    readonly hue?: NumberParam;
-    readonly chroma?: Varying<{
-        readonly peak: NumberParam;
-        readonly lightBias?: NumberParam;
-        readonly darkBias?: NumberParam;
-    }>;
-    /**
-     * Step name → exact hex (or `{seeds.name}`). An anchor's hue and chroma replace `hue` and `chroma.peak`; with several,
-     * both blend by step between consecutive anchors, and steps outside them take the nearest anchor's.
-     */
-    readonly anchor?: Varying<Readonly<Record<string, Varying<string>>>>;
-    readonly description?: string;
-    readonly describe?: Readonly<Record<string, string>>;
-}
-interface CategoricalRampDef {
-    readonly kind: 'categorical';
-    readonly steps: Varying<readonly string[]>;
-    /** Any of the palette generator's `Constraints` except `count` and `anchors`. */
-    readonly gates?: Varying<Readonly<Record<string, Varying<number | string>>>>;
-    readonly anchors?: readonly {
-        readonly name: string;
-        readonly hue: number;
-        readonly lightness: number;
-        readonly chroma?: number;
-    }[];
-    readonly description?: string;
-    readonly describe?: Readonly<Record<string, string>>;
-}
-type RampDef = LightnessRampDef | CategoricalRampDef;
-interface ScaleDef {
-    readonly steps: Varying<readonly string[]>;
-    readonly base: NumberParam;
-    /** Linear: `base + step × i`. */
-    readonly step?: NumberParam;
-    /** Geometric: `base × ratio^i`. */
-    readonly ratio?: NumberParam;
-    /** Explicit: `base × factors[i]`, one per step. For a ramp no single rule fits. */
-    readonly factors?: Varying<readonly NumberParam[]>;
-    readonly description?: string;
-    readonly describe?: Readonly<Record<string, string>>;
-}
-interface SemanticCommon {
-    readonly type?: string;
-    readonly description?: string;
-    /** Audited, never applied. */
-    readonly check?: {
-        readonly contrast: number;
-        readonly against: readonly string[];
-    };
-}
-type StepRule = SemanticCommon & {
-    readonly ramp: string;
-    readonly step: Varying<string>;
-};
-type OffsetRule = SemanticCommon & {
-    readonly from: string;
-    readonly offset: number;
-    readonly dir: 'lighter' | 'darker' | 'away';
-};
-type ContrastRule = SemanticCommon & {
-    readonly ramp: string;
-    readonly contrast: {
-        readonly min: number;
-        readonly against: readonly string[];
-    };
-};
-type RefRule = SemanticCommon & {
-    readonly ref: string;
-    readonly alpha?: number;
-};
-type LiteralRule = SemanticCommon & {
-    readonly value: TokenValue;
-};
-type SemanticRule = StepRule | OffsetRule | ContrastRule | RefRule | LiteralRule;
-interface ThemeDefinition {
-    readonly name: string;
-    /** Another definition's name. Absent or null: extends nothing. */
-    readonly extends?: string | null;
-    readonly description?: string;
-    readonly axes?: AxisDefs;
-    readonly seeds?: Readonly<Record<string, Varying<number | string>>>;
-    readonly ramps?: Readonly<Record<string, RampDef>>;
-    readonly scales?: Readonly<Record<string, ScaleDef>>;
-    readonly semantics?: Readonly<Record<string, Varying<SemanticRule>>>;
-    readonly components?: Readonly<Record<string, Varying<PinValue>>>;
-    readonly pins?: Readonly<Record<string, Varying<PinValue>>>;
-    /** The colors a `tone` index picks from. Absent: the nearest theme it extends that has one, else the swatch ramp. */
-    readonly tones?: SerializableColorList;
-}
-
 type Lookup = (name: string) => ThemeDefinition | undefined;
 /** The definition with its whole `extends` chain folded in, child entries winning. */
 declare function mergeChain(def: ThemeDefinition, lookup?: Lookup, seen?: ReadonlySet<string>): ThemeDefinition;
@@ -1296,4 +1107,193 @@ declare const THEME_SOURCES: Readonly<Record<string, ThemeDefinition>>;
  *  what `weaselTheme` is built from, so the runtime entry bundles no generator. */
 declare const BAKED_THEMES: Readonly<Record<string, BakedTheme>>;
 
-export { mergeChain as $, type AxisDef as A, BAKED_THEMES as B, type ColorContext as C, themeAxes as D, themeTones as E, type FlatTokens as F, type GeneratedColors as G, weaselTheme as H, type CategoricalRampDef as I, type ContrastRule as J, type LightnessRampDef as K, type Lookup as L, type LiteralRule as M, type NumberParam as N, type OffsetRule as O, type PinObject as P, type RampDef as Q, type ResolvedTheme as R, type Selection as S, type TokenName as T, type RefRule as U, type Varying as V, type ScaleDef as W, type SemanticRule as X, type StepRule as Y, bake as Z, bakeChain as _, type Theme as a, type TokenValue as b, type AxisDefs as c, type AxisValue as d, type BakedTheme as e, type ByAxis as f, type ColorList as g, type GeneratedTheme as h, type PinValue as i, type RampColors as j, type RawToken as k, type SerializableColorList as l, THEMES as m, THEME_SOURCES as n, type ThemeDefinition as o, type ThemeInput as p, colorAt as q, colorCount as r, colorCssAt as s, defineTheme as t, enumerateSelections as u, fullSelection as v, isByAxis as w, rampSteps as x, resolveTheme as y, selectionKey as z };
+/**
+ * A theme ready to resolve: its axes and its tokens, each plain or varying by
+ * axis, references intact. A `by` that leaves a value out contributes nothing
+ * for that selection, so the theme it extends supplies it.
+ */
+interface Theme {
+    readonly name: string;
+    readonly extends: Theme | null;
+    readonly axes: AxisDefs;
+    readonly tokens: Readonly<Record<string, Varying<RawToken>>>;
+    /** Ramp name → step names in order, for the ramps this theme declares itself. */
+    readonly ramps?: Readonly<Record<string, readonly string[]>>;
+    /** The colors a `tone` index picks from. Absent: the nearest theme it extends that has one. */
+    readonly tones?: SerializableColorList;
+}
+/** What `defineTheme` accepts: a definition whose `extends` is a `Theme`, holding pins and components only. */
+type ThemeInput = Omit<ThemeDefinition, 'extends'> & {
+    readonly extends?: Theme | null;
+};
+/** The built-in theme, from the baked output of themes/weasel.json. */
+declare const weaselTheme: Theme;
+/**
+ * Build a theme from pins. Unless `extends` says otherwise the result layers
+ * onto `weaselTheme`, so a theme only names what it changes. A definition with
+ * seeds, ramps, scales or semantics needs deriving first.
+ */
+declare function defineTheme(input: ThemeInput): Theme;
+
+/** The output of `resolveTheme`: every token of a theme, for one selection, keyed
+ *  by CSS custom-property name and flattened to a final CSS value. */
+type ResolvedTheme = Readonly<Record<TokenName, string>>;
+/** Every axis the chain declares. An axis declared more than once keeps every value; a descendant's value entries and default win. */
+declare function themeAxes(theme: Theme): AxisDefs;
+/**
+ * Merge the extends chain at a selection, resolve every alias, and key the
+ * result by CSS custom-property name. A missing or unknown axis value takes the
+ * axis default.
+ *
+ * Pure — no DOM. An unresolvable reference throws rather than falling back.
+ */
+declare function resolveTheme(theme: Theme, selection?: Selection): ResolvedTheme;
+
+/** The categorical generator the swatch ramp uses, asked for `count` colors. */
+interface GeneratedColors {
+    readonly generate: {
+        readonly count: number;
+        readonly gates?: CategoricalRampDef['gates'];
+    };
+}
+/** A ramp of the active theme, by name — `{ ramp: 'swatch' }` walks its steps in order. */
+interface RampColors {
+    readonly ramp: string;
+}
+/** The forms a theme definition can hold: everything but a function. */
+type SerializableColorList = readonly string[] | GeneratedColors | RampColors;
+/**
+ * Several colors, read by index with `colorAt`, wrapping. Literals; the swatch
+ * ramp's generator; a ramp of the active theme, which follows the mode; or a
+ * function of the index.
+ */
+type ColorList = SerializableColorList | ((i: number) => string);
+/** What a `ColorList` resolves against. `useTheme()`'s value is one. */
+interface ColorContext {
+    readonly theme: Theme;
+    readonly resolved: ResolvedTheme;
+}
+/** A ramp's step names, from the nearest theme in the chain that declares it. */
+declare function rampSteps(theme: Theme, ramp: string): readonly string[];
+/** The tone list a theme declares, from the nearest theme in its chain that has one. */
+declare function themeTones(theme: Theme): ColorList;
+/** The `i`th color of `list`, wrapping. A ramp list reads the resolved theme, so the answer follows its mode. */
+declare function colorAt(list: ColorList, i: number, ctx?: ColorContext): string;
+/**
+ * As `colorAt`, but a ramp list answers with its custom property —
+ * `var(--wzl-swatch-sky)` — so a color written into CSS follows a mode change
+ * without re-rendering, provider or not.
+ */
+declare function colorCssAt(list: ColorList, i: number, ctx?: ColorContext): string;
+/** How many distinct colors `list` holds before it wraps; `undefined` for a function, which never does. */
+declare function colorCount(list: ColorList, ctx?: ColorContext): number | undefined;
+
+/** A number, or `{seeds.name}`. */
+type NumberParam = Varying<number | string>;
+interface PinObject {
+    readonly value: TokenValue;
+    readonly type?: string;
+    readonly description?: string;
+    readonly alpha?: number;
+}
+/** A bare value or `{ value, type?, description?, alpha? }`. The value may be a `{token}` reference. */
+type PinValue = TokenValue | PinObject;
+interface LightnessRampDef {
+    readonly kind: 'lightness';
+    readonly steps: Varying<readonly string[]>;
+    /** First and last step's OKLCH lightness. */
+    readonly lightness: Varying<readonly [NumberParam, NumberParam]>;
+    /** 0 walks evenly; 1 follows a smoothstep S. */
+    readonly curve?: NumberParam;
+    /** Degrees. Ignored when an anchor is given. */
+    readonly hue?: NumberParam;
+    readonly chroma?: Varying<{
+        readonly peak: NumberParam;
+        readonly lightBias?: NumberParam;
+        readonly darkBias?: NumberParam;
+    }>;
+    /**
+     * Step name → exact hex (or `{seeds.name}`). An anchor's hue and chroma replace `hue` and `chroma.peak`; with several,
+     * both blend by step between consecutive anchors, and steps outside them take the nearest anchor's.
+     */
+    readonly anchor?: Varying<Readonly<Record<string, Varying<string>>>>;
+    readonly description?: string;
+    readonly describe?: Readonly<Record<string, string>>;
+}
+interface CategoricalRampDef {
+    readonly kind: 'categorical';
+    readonly steps: Varying<readonly string[]>;
+    /** Any of the palette generator's `Constraints` except `count` and `anchors`. */
+    readonly gates?: Varying<Readonly<Record<string, Varying<number | string>>>>;
+    readonly anchors?: readonly {
+        readonly name: string;
+        readonly hue: number;
+        readonly lightness: number;
+        readonly chroma?: number;
+    }[];
+    readonly description?: string;
+    readonly describe?: Readonly<Record<string, string>>;
+}
+type RampDef = LightnessRampDef | CategoricalRampDef;
+interface ScaleDef {
+    readonly steps: Varying<readonly string[]>;
+    readonly base: NumberParam;
+    /** Linear: `base + step × i`. */
+    readonly step?: NumberParam;
+    /** Geometric: `base × ratio^i`. */
+    readonly ratio?: NumberParam;
+    /** Explicit: `base × factors[i]`, one per step. For a ramp no single rule fits. */
+    readonly factors?: Varying<readonly NumberParam[]>;
+    readonly description?: string;
+    readonly describe?: Readonly<Record<string, string>>;
+}
+interface SemanticCommon {
+    readonly type?: string;
+    readonly description?: string;
+    /** Audited, never applied. */
+    readonly check?: {
+        readonly contrast: number;
+        readonly against: readonly string[];
+    };
+}
+type StepRule = SemanticCommon & {
+    readonly ramp: string;
+    readonly step: Varying<string>;
+};
+type OffsetRule = SemanticCommon & {
+    readonly from: string;
+    readonly offset: number;
+    readonly dir: 'lighter' | 'darker' | 'away';
+};
+type ContrastRule = SemanticCommon & {
+    readonly ramp: string;
+    readonly contrast: {
+        readonly min: number;
+        readonly against: readonly string[];
+    };
+};
+type RefRule = SemanticCommon & {
+    readonly ref: string;
+    readonly alpha?: number;
+};
+type LiteralRule = SemanticCommon & {
+    readonly value: TokenValue;
+};
+type SemanticRule = StepRule | OffsetRule | ContrastRule | RefRule | LiteralRule;
+interface ThemeDefinition {
+    readonly name: string;
+    /** Another definition's name. Absent or null: extends nothing. */
+    readonly extends?: string | null;
+    readonly description?: string;
+    readonly axes?: AxisDefs;
+    readonly seeds?: Readonly<Record<string, Varying<number | string>>>;
+    readonly ramps?: Readonly<Record<string, RampDef>>;
+    readonly scales?: Readonly<Record<string, ScaleDef>>;
+    readonly semantics?: Readonly<Record<string, Varying<SemanticRule>>>;
+    readonly components?: Readonly<Record<string, Varying<PinValue>>>;
+    readonly pins?: Readonly<Record<string, Varying<PinValue>>>;
+    /** The colors a `tone` index picks from. Absent: the nearest theme it extends that has one, else the swatch ramp. */
+    readonly tones?: SerializableColorList;
+}
+
+export { weaselTheme as $, type AxisDefs as A, type BakedTheme as B, type CategoricalRampDef as C, THEME_SOURCES as D, type ThemeInput as E, type FlatTokens as F, type GeneratedColors as G, colorAt as H, colorCount as I, colorCssAt as J, defineTheme as K, type Lookup as L, enumerateSelections as M, type NumberParam as N, type OffsetRule as O, type PinObject as P, fullSelection as Q, type RawToken as R, type Selection as S, type ThemeDefinition as T, isByAxis as U, type Varying as V, rampSteps as W, resolveTheme as X, selectionKey as Y, themeAxes as Z, themeTones as _, type Theme as a, type ContrastRule as b, type LightnessRampDef as c, type LiteralRule as d, type PinValue as e, type RampDef as f, type RefRule as g, type ScaleDef as h, type SemanticRule as i, type StepRule as j, bake as k, bakeChain as l, mergeChain as m, type TokenName as n, type ResolvedTheme as o, type TokenValue as p, type AxisDef as q, type AxisValue as r, BAKED_THEMES as s, type ByAxis as t, type ColorContext as u, type ColorList as v, type GeneratedTheme as w, type RampColors as x, type SerializableColorList as y, THEMES as z };

package/dist/engine.d.ts

@@ -1,6 +1,6 @@
 import { OklchDeg, oklchDegToHex } from '@weasel-js/paint';
-import { o as ThemeDefinition, L as Lookup, F as FlatTokens, k as RawToken, S as Selection, e as BakedTheme, c as AxisDefs, a as Theme } from './themes-bTfTZjCh.js';
-export { I as CategoricalRampDef, J as ContrastRule, K as LightnessRampDef, M as LiteralRule, N as NumberParam, O as OffsetRule, P as PinObject, i as PinValue, Q as RampDef, U as RefRule, W as ScaleDef, X as SemanticRule, Y as StepRule, Z as bake, _ as bakeChain, $ as mergeChain } from './themes-bTfTZjCh.js';
+import { T as ThemeDefinition, L as Lookup, F as FlatTokens, R as RawToken, S as Selection, B as BakedTheme, A as AxisDefs, a as Theme } from './definition-DLdTdFWs.js';
+export { C as CategoricalRampDef, b as ContrastRule, c as LightnessRampDef, d as LiteralRule, N as NumberParam, O as OffsetRule, P as PinObject, e as PinValue, f as RampDef, g as RefRule, h as ScaleDef, i as SemanticRule, j as StepRule, k as bake, l as bakeChain, m as mergeChain } from './definition-DLdTdFWs.js';
 
 /** A color in OKLCH: lightness 0–1, chroma, hue in degrees. paint's own type,
  *  under the name this engine has always called it. */

package/dist/engine.js

@@ -1,6 +1,6 @@
-import { overrideKey, AXES_EXT, ALPHA_EXT } from './chunk-GI7ZAXIB.js';
-import { mergeAxes, toLch, toHex, generate, DEFAULT_CONSTRAINTS, fullSelection, pick, enumerateSelections, resolveTokens, pickAll, themeAxes, selectionKey, isByAxis, contrast } from './chunk-QKRFHBRB.js';
-export { CHROMA_WEIGHT, DEFAULT_CONSTRAINTS, anchorFromHex, chromaCap, contrast, deltaE, floorDegrees, generate, hexToRgb, hueGap, hueName, luminance, toHex, toHexPreview, toLab, toLch, vividAt } from './chunk-QKRFHBRB.js';
+import { overrideKey, AXES_EXT, ALPHA_EXT } from './chunk-EINHFDWI.js';
+import { mergeAxes, toLch, toHex, generate, DEFAULT_CONSTRAINTS, fullSelection, pick, enumerateSelections, resolveTokens, pickAll, themeAxes, selectionKey, isByAxis, contrast } from './chunk-C3S4A65R.js';
+export { CHROMA_WEIGHT, DEFAULT_CONSTRAINTS, anchorFromHex, chromaCap, contrast, deltaE, floorDegrees, generate, hexToRgb, hueGap, hueName, luminance, toHex, toHexPreview, toLab, toLch, vividAt } from './chunk-C3S4A65R.js';
 
 // src/engine/steps.ts
 var stepList = (x) => Array.isArray(x) ? [...new Set(x.filter((s) => typeof s === "string"))] : [];
@@ -1459,9 +1459,9 @@ ${body}
   return [
     "// GENERATED by packages/theme/scripts/build-tokens.ts \u2014 do not edit.",
     "",
-    "import type { AxisDefs } from '../axes';",
-    "import type { ThemeDefinition } from '../definition';",
-    "import type { BakedTheme } from '../engine/bake';",
+    "import type { AxisDefs } from '../axes.ts';",
+    "import type { ThemeDefinition } from '../definition.ts';",
+    "import type { BakedTheme } from '../engine/bake.ts';",
     "",
     "/** Every design token the built-in themes declare, spelled as the CSS",
     " *  custom property it becomes. */",