@xtyle/core 0.5.0

package/dist/series.js

@@ -0,0 +1,207 @@
+import { toOklchColor, oklch, formatCss, clampToGamut, hueDelta } from "./color.js";
+export const SERIES_SCHEMES = [
+    "accents",
+    "skittles",
+    "statuses",
+    "thermal",
+    "status",
+];
+/** Every register token the built-in schemes read. A browser consumer that only has the applied
+ * CSS custom properties (no derived register) reads these off the document to reconstruct the
+ * minimal register `seriesPalette` needs. */
+export const SERIES_TOKENS = [
+    "--accent",
+    "--accent-2",
+    "--accent-3",
+    "--accent-4",
+    "--success",
+    "--warn",
+    "--danger",
+    "--info",
+    "--neutral",
+    "--red",
+    "--orange",
+    "--yellow",
+    "--green",
+    "--cyan",
+    "--blue",
+    "--purple",
+    "--pink",
+];
+/**
+ * The semantic status tones behind the `statuses` scheme: the outcome→register-token map, named so a
+ * discrete-status chart can pin each datum to its meaning *by name* rather than by position. The
+ * positional scheme mis-colors the moment a category is absent (a filtered zero-value slice shifts
+ * every survivor down a tone); a `tone` key resolved through this map is stable under filtering.
+ */
+export const STATUS_TONES = {
+    success: "--success",
+    failed: "--danger",
+    warn: "--warn",
+    info: "--info",
+    skipped: "--neutral",
+    live: "--accent",
+};
+export const STATUS_TONE_KEYS = Object.keys(STATUS_TONES);
+/** Resolves the register color for a named status `tone`; `undefined` for an unknown key. The by-name
+ * companion to the positional `statuses` scheme. */
+export function statusToneColor(tone, register) {
+    const token = STATUS_TONES[tone];
+    return token ? register[token] : undefined;
+}
+/** Categorical schemes: a set of distinct hues, taken in order (accents, statuses) or evenly
+ * sampled for maximum separation (skittles). `ordered` keeps a ranked palette in its authored
+ * order. `statuses` pins each outcome to its own semantic tone (success / failed / warn / info /
+ * skipped / live) so a discrete-status chart reads by meaning, not an arbitrary ramp; its token order
+ * is `STATUS_TONES`, the single source the by-name `seriesColorsFor` path shares. */
+const CATEGORICAL = {
+    accents: { tokens: ["--accent", "--accent-2", "--accent-3", "--accent-4", "--neutral"], ordered: true },
+    skittles: {
+        tokens: ["--red", "--orange", "--yellow", "--green", "--cyan", "--blue", "--purple", "--pink"],
+        ordered: false,
+    },
+    statuses: {
+        tokens: [...Object.values(STATUS_TONES)],
+        ordered: true,
+    },
+};
+/** Sequential schemes: anchor stops interpolated in OKLCH across exactly `count` steps. */
+const SEQUENTIAL = {
+    thermal: ["--blue", "--cyan", "--yellow", "--red"],
+    status: ["--success", "--warn", "--danger"],
+};
+function resolve(tokens, register) {
+    return tokens.map((name) => register[name]).filter((value) => Boolean(value));
+}
+/** Evenly spaced indices into a `length`-long array, endpoints included, for `count` picks. */
+function evenIndices(length, count) {
+    if (count <= 1)
+        return [0];
+    return Array.from({ length: count }, (_, i) => Math.round((i * (length - 1)) / (count - 1)));
+}
+function categorical(colors, count, ordered) {
+    if (count <= 0 || colors.length === 0)
+        return [];
+    if (count > colors.length) {
+        return Array.from({ length: count }, (_, i) => colors[i % colors.length]);
+    }
+    const indices = ordered
+        ? Array.from({ length: count }, (_, i) => i)
+        : evenIndices(colors.length, count);
+    return indices.map((i) => colors[i]);
+}
+function lerpOklch(from, to, t) {
+    const a = toOklchColor(from);
+    const b = toOklchColor(to);
+    const h = a.h + hueDelta(a.h, b.h) * t;
+    const mixed = oklch(a.l + (b.l - a.l) * t, a.c + (b.c - a.c) * t, ((h % 360) + 360) % 360);
+    return formatCss(clampToGamut(mixed));
+}
+function sequential(colors, count) {
+    if (count <= 0 || colors.length === 0)
+        return [];
+    if (colors.length === 1)
+        return Array.from({ length: count }, () => colors[0]);
+    if (count === 1)
+        return [lerpOklch(colors[0], colors[colors.length - 1], 0.5)];
+    const segments = colors.length - 1;
+    return Array.from({ length: count }, (_, i) => {
+        const position = (i / (count - 1)) * segments;
+        const seg = Math.min(Math.floor(position), segments - 1);
+        return lerpOklch(colors[seg], colors[seg + 1], position - seg);
+    });
+}
+const RAMP_ANCHORS = {
+    accent: ["--bg-2", "--accent"],
+    thermal: SEQUENTIAL.thermal,
+    status: SEQUENTIAL.status,
+};
+export const RAMP_SCHEMES = ["accent", "thermal", "status"];
+/** Every register token a built-in ramp reads, so a browser consumer with only the applied CSS
+ * custom properties can reconstruct the minimal register `rampColor` needs. */
+export const RAMP_TOKENS = [
+    "--bg-2",
+    "--accent",
+    "--blue",
+    "--cyan",
+    "--yellow",
+    "--red",
+    "--success",
+    "--warn",
+    "--danger",
+];
+function clamp01(t) {
+    return t < 0 ? 0 : t > 1 ? 1 : Number.isFinite(t) ? t : 0;
+}
+/**
+ * Resolves a single color at normalized position `t` (0..1) along a ramp: a built-in `RampScheme`
+ * (a faint-to-accent wash or a sequential scale) derived off the register, or an explicit list of
+ * stop colors, interpolated in OKLCH. `reverse` flips the ramp. The continuous sibling of
+ * `seriesPalette`, for a scalar intensity rather than N discrete series.
+ */
+export function rampColor(scheme, t, register, options = {}) {
+    const stops = Array.isArray(scheme) ? scheme : resolve(RAMP_ANCHORS[scheme] ?? RAMP_ANCHORS.accent, register);
+    if (stops.length === 0)
+        return "currentColor";
+    if (stops.length === 1)
+        return stops[0];
+    const clamped = clamp01(t);
+    const tt = options.reverse ? 1 - clamped : clamped;
+    const segments = stops.length - 1;
+    const pos = tt * segments;
+    const seg = Math.min(Math.floor(pos), segments - 1);
+    return lerpOklch(stops[seg], stops[seg + 1], pos - seg);
+}
+/** The default drop-shadow blur (in px) a full-strength glow cell reaches. */
+export const GLOW_MAX_BLUR = 7;
+/**
+ * The drop-shadow `filter` value for a heatmap cell's secondary glow channel at normalized
+ * intensity `t` (0..1), rendered in `color` with a full-strength blur of `maxBlur` px. Returns
+ * `null` at or below zero so a cell with no glow renders no filter at all. The visual sibling of
+ * `rampColor`: where the ramp drives a cell's fill by one metric, the glow drives a halo around it
+ * by a second, so one grid can carry two signals. `maxBlur` tunes the halo's reach so it reads on a
+ * dense grid without bleeding into neighbors on a sparse one.
+ */
+export function glowFilter(t, color, maxBlur = GLOW_MAX_BLUR) {
+    const clamped = clamp01(t);
+    if (clamped <= 0)
+        return null;
+    const blur = (clamped * maxBlur).toFixed(1);
+    return `drop-shadow(0 0 ${blur}px ${color})`;
+}
+/**
+ * Resolves `count` series colors for a chart. Pass a built-in `SeriesScheme` to derive them
+ * from the active theme's register, or a `string[]` to use explicit colors (cycled to `count`).
+ * Categorical schemes return distinct hues; sequential schemes return an interpolated scale.
+ * Set `reverse` to flip any scheme end for end.
+ */
+export function seriesPalette(scheme, count, register, options = {}) {
+    let colors;
+    if (Array.isArray(scheme))
+        colors = categorical(scheme, count, true);
+    else if (scheme in CATEGORICAL) {
+        const spec = CATEGORICAL[scheme];
+        colors = categorical(resolve(spec.tokens, register), count, spec.ordered);
+    }
+    else {
+        colors = sequential(resolve(SEQUENTIAL[scheme], register), count);
+    }
+    return options.reverse ? colors.reverse() : colors;
+}
+/**
+ * Resolves a color per data item, honoring an optional semantic `tone` key when the scheme supports
+ * by-name mapping. Under `statuses`, an item carrying a known `tone` pins to that outcome's token
+ * directly, so filtering an absent category out never shifts the meaning→tone mapping (the positional
+ * scheme's failure mode). Items without a `tone`, an explicit `string[]`, and every other scheme fall
+ * back to positional `seriesPalette`; the count-based call stays right when items carry no semantics.
+ */
+export function seriesColorsFor(scheme, items, register, options = {}) {
+    const positional = seriesPalette(scheme, items.length, register, options);
+    if (Array.isArray(scheme) || scheme !== "statuses")
+        return positional;
+    return items.map((item, i) => {
+        const named = item.tone ? statusToneColor(item.tone, register) : undefined;
+        return named ?? positional[i] ?? "currentColor";
+    });
+}
+//# sourceMappingURL=series.js.map

package/dist/series.js.map

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

package/dist/theme-file.d.ts

@@ -0,0 +1,53 @@
+import type { TokenRegister } from "./types.js";
+export declare const THEME_FILE_FORMAT: "xtyle-theme";
+export declare const THEME_FILE_VERSION: 1;
+export declare const THEME_FILE_SCHEMA_URL = "https://xtyle.dev/schema/theme.v1.json";
+/**
+ * Provenance for a materialized theme. Identifying fields only — no store id or
+ * timestamps, so a shared file carries what it is and nothing about where it was kept.
+ */
+export interface ThemeFileMeta {
+    name: string;
+    description?: string;
+    tags?: string[];
+    generator?: string;
+}
+/**
+ * The re-derivable half of a theme file: the algorithm and the layered inputs that
+ * print its tokens. Knobs and overrides stay loosely typed here — their precise
+ * shape belongs to whatever authored the recipe (the bench's recipe, a CLI call) —
+ * so the engine owns the envelope without owning any one front-end's input model.
+ */
+export interface ThemeRecipe {
+    algorithm: string;
+    knobs?: object;
+    overrides?: TokenRegister;
+}
+/**
+ * The canonical, self-describing xtyle theme artifact. `recipe` is the source of
+ * truth (re-derive it to reproduce `tokens`); `tokens` is the materialized register,
+ * a cache so a consumer can apply the theme without ever running the engine.
+ */
+export interface XtyleThemeFile {
+    $schema?: string;
+    format: typeof THEME_FILE_FORMAT;
+    version: number;
+    meta: ThemeFileMeta;
+    recipe: ThemeRecipe;
+    tokens: TokenRegister;
+}
+export declare function buildThemeFile(input: {
+    meta: ThemeFileMeta;
+    recipe: ThemeRecipe;
+    register: TokenRegister;
+}): XtyleThemeFile;
+export declare function serializeThemeFile(file: XtyleThemeFile): string;
+/** A strict check for the canonical envelope — format marker plus a usable recipe. */
+export declare function isThemeFile(value: unknown): value is XtyleThemeFile;
+/**
+ * Parse a canonical theme file from text or a value. Strict by design: it accepts
+ * only the `xtyle-theme` envelope. Looser coercion (bare recipes, raw token maps,
+ * legacy docs) is a front-end concern, since only the front end knows its own input model.
+ */
+export declare function parseThemeFile(input: string | unknown): XtyleThemeFile | null;
+//# sourceMappingURL=theme-file.d.ts.map

package/dist/theme-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-file.d.ts","sourceRoot":"","sources":["../src/theme-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,iBAAiB,EAAG,aAAsB,CAAC;AACxD,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC;AAC7C,eAAO,MAAM,qBAAqB,2CAA2C,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,iBAAiB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;CACtB;AAcD,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACxB,GAAG,cAAc,CASjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAOnE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,IAAI,CAU7E"}

package/dist/theme-file.js

@@ -0,0 +1,51 @@
+export const THEME_FILE_FORMAT = "xtyle-theme";
+export const THEME_FILE_VERSION = 1;
+export const THEME_FILE_SCHEMA_URL = "https://xtyle.dev/schema/theme.v1.json";
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+function sortTokens(register) {
+    const flat = {};
+    for (const name of Object.keys(register).sort()) {
+        flat[name] = register[name];
+    }
+    return flat;
+}
+export function buildThemeFile(input) {
+    return {
+        $schema: THEME_FILE_SCHEMA_URL,
+        format: THEME_FILE_FORMAT,
+        version: THEME_FILE_VERSION,
+        meta: input.meta,
+        recipe: input.recipe,
+        tokens: sortTokens(input.register),
+    };
+}
+export function serializeThemeFile(file) {
+    return `${JSON.stringify(file, null, 2)}\n`;
+}
+/** A strict check for the canonical envelope — format marker plus a usable recipe. */
+export function isThemeFile(value) {
+    return (isObject(value) &&
+        value.format === THEME_FILE_FORMAT &&
+        isObject(value.recipe) &&
+        typeof value.recipe.algorithm === "string");
+}
+/**
+ * Parse a canonical theme file from text or a value. Strict by design: it accepts
+ * only the `xtyle-theme` envelope. Looser coercion (bare recipes, raw token maps,
+ * legacy docs) is a front-end concern, since only the front end knows its own input model.
+ */
+export function parseThemeFile(input) {
+    let value = input;
+    if (typeof input === "string") {
+        try {
+            value = JSON.parse(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    return isThemeFile(value) ? value : null;
+}
+//# sourceMappingURL=theme-file.js.map

package/dist/theme-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-file.js","sourceRoot":"","sources":["../src/theme-file.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAsB,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,wCAAwC,CAAC;AAuC9E,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,QAAuB;IAC1C,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAW,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAI9B;IACA,OAAO;QACN,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;KAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAoB;IACtD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,OAAO,CACN,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,MAAM,KAAK,iBAAiB;QAClC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QACtB,OAAQ,KAAK,CAAC,MAAkC,CAAC,SAAS,KAAK,QAAQ,CACvE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAuB;IACrD,IAAI,KAAK,GAAY,KAAK,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}

package/dist/timeseries.d.ts

@@ -0,0 +1,26 @@
+/** The default sliding-window width for a time-windowed series: five minutes. */
+export declare const DEFAULT_SPARK_WINDOW_MS = 300000;
+/** One timestamped sample: `at` is epoch ms or a date string, paired with a numeric value. */
+export interface TimeSample {
+    at: number | string;
+    value: number;
+}
+export interface WindowedPlotOptions {
+    /** The sliding window width in ms, ending at `now`; ignored when `domain` is set. Defaults to 5 minutes. */
+    window?: number;
+    /** An explicit `[start, end]` span (epoch ms or date strings) instead of a sliding window. */
+    domain?: [number | string, number | string] | null;
+    /** The "now" the sliding window ends at, epoch ms. Passed in so the shaping stays pure and testable. */
+    now: number;
+}
+/**
+ * Maps timestamped samples onto a normalized x (0..1) across a sliding window or an explicit domain,
+ * dropping any that fall outside it, and sorts them by time. The time-series sibling of `seriesPalette`:
+ * pure data shaping a time-series component (a sparkline, a strip) turns into a plotted series, with no
+ * DOM and no clock of its own (the caller passes `now`). Returns `{ x, value }[]` ready to render.
+ */
+export declare function windowedPlot(points: TimeSample[], opts: WindowedPlotOptions): {
+    x: number;
+    value: number;
+}[];
+//# sourceMappingURL=timeseries.d.ts.map

package/dist/timeseries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries.d.ts","sourceRoot":"","sources":["../src/timeseries.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,8FAA8F;AAC9F,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IACnD,wGAAwG;IACxG,GAAG,EAAE,MAAM,CAAC;CACZ;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,mBAAmB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAW5G"}

package/dist/timeseries.js

@@ -0,0 +1,23 @@
+/** The default sliding-window width for a time-windowed series: five minutes. */
+export const DEFAULT_SPARK_WINDOW_MS = 300_000;
+function toMs(at) {
+    return typeof at === "number" ? at : Date.parse(at);
+}
+/**
+ * Maps timestamped samples onto a normalized x (0..1) across a sliding window or an explicit domain,
+ * dropping any that fall outside it, and sorts them by time. The time-series sibling of `seriesPalette`:
+ * pure data shaping a time-series component (a sparkline, a strip) turns into a plotted series, with no
+ * DOM and no clock of its own (the caller passes `now`). Returns `{ x, value }[]` ready to render.
+ */
+export function windowedPlot(points, opts) {
+    const domain = opts.domain;
+    const [start, end] = domain && domain.length === 2
+        ? [toMs(domain[0]), toMs(domain[1])]
+        : [opts.now - (opts.window ?? DEFAULT_SPARK_WINDOW_MS), opts.now];
+    const span = end - start || 1;
+    return points
+        .map((p) => ({ x: (toMs(p.at) - start) / span, value: Number(p.value) }))
+        .filter((p) => Number.isFinite(p.x) && Number.isFinite(p.value) && p.x >= 0 && p.x <= 1)
+        .sort((a, b) => a.x - b.x);
+}
+//# sourceMappingURL=timeseries.js.map

package/dist/timeseries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries.js","sourceRoot":"","sources":["../src/timeseries.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAiB/C,SAAS,IAAI,CAAC,EAAmB;IAChC,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,IAAyB;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GACjB,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,uBAAuB,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACxE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACvF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/token-meta.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The descriptive catalog for the core token vocabulary: a human description and a set of search
+ * tags (synonyms / intent words) for each token the blessed algorithms produce. This is the
+ * canonical home for that data — the engine owns its tokens, so it owns what they mean — and any
+ * surface (the bench's token editor, docs, a future inspector) reads from here rather than
+ * re-describing tokens locally. Author-declared tokens (the open register) fall back to a derived
+ * description; an authored algorithm can ship its own metadata the same shape.
+ */
+export interface TokenMeta {
+    /** A one-line, human description of what the token is for. */
+    description: string;
+    /** Synonyms and intent words so a search matches on meaning, not just the literal name. */
+    tags: string[];
+}
+/** The description + tags for a token. Unknown (author-declared) tokens get a name-derived fallback. */
+export declare function tokenMeta(name: string): TokenMeta;
+/** The full lowercase searchable text for a token: its name, group title, description, and tags. */
+export declare function tokenSearchText(name: string, groupTitle: string): string;
+//# sourceMappingURL=token-meta.d.ts.map

package/dist/token-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-meta.d.ts","sourceRoot":"","sources":["../src/token-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACzB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAsED,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAKjD;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGxE"}

package/dist/token-meta.js

@@ -0,0 +1,74 @@
+/**
+ * The descriptive catalog for the core token vocabulary: a human description and a set of search
+ * tags (synonyms / intent words) for each token the blessed algorithms produce. This is the
+ * canonical home for that data — the engine owns its tokens, so it owns what they mean — and any
+ * surface (the bench's token editor, docs, a future inspector) reads from here rather than
+ * re-describing tokens locally. Author-declared tokens (the open register) fall back to a derived
+ * description; an authored algorithm can ship its own metadata the same shape.
+ */
+/** Resolved most-specific-first: the first rule whose pattern matches wins. */
+const RULES = [
+    { test: /^--body-bg$/, describe: () => "The page's own background — the canvas everything else sits on.", tags: ["background", "surface", "page", "canvas", "body"] },
+    { test: /^--bg-sunken$/, describe: () => "A recessed surface that reads below the page — wells, insets, code blocks.", tags: ["background", "surface", "sunken", "inset", "well", "recessed"] },
+    { test: /^--bg-0$/, describe: () => "The base surface — the default panel color and the seed the whole surface ladder steps from.", tags: ["background", "surface", "base", "panel"] },
+    { test: /^--bg-([1-3])$/, describe: (n) => `Surface elevation ${n.match(/(\d)/)?.[1]} — a panel raised this many steps above the base.`, tags: ["background", "surface", "panel", "elevation", "raised", "card"] },
+    { test: /^--surface-overlay-border$/, describe: () => "The hairline around a floating overlay (menu, popover, tooltip).", tags: ["background", "surface", "overlay", "border", "popover", "menu"] },
+    { test: /^--surface-overlay$/, describe: () => "The surface of a floating overlay — menus, popovers, tooltips.", tags: ["background", "surface", "overlay", "popover", "menu", "tooltip"] },
+    { test: /^--scrim$/, describe: () => "The dimming wash behind a modal — darkens the page while a dialog is open.", tags: ["background", "scrim", "overlay", "modal", "backdrop", "dim"] },
+    { test: /^--fg-0$/, describe: () => "Primary text — the most legible ink, for body copy and headings.", tags: ["foreground", "text", "ink", "content", "body", "primary"] },
+    { test: /^--fg-([1-3])$/, describe: (n) => `Secondary text, tier ${n.match(/(\d)/)?.[1]} — progressively quieter than primary, still readable.`, tags: ["foreground", "text", "ink", "secondary", "muted", "subtle"] },
+    { test: /^--fg-disabled$/, describe: () => "Disabled text — dimmed to read as inactive while staying perceptible.", tags: ["foreground", "text", "disabled", "inactive", "dim"] },
+    { test: /^--placeholder$/, describe: () => "Placeholder text in an empty field — a hint, lighter than real input.", tags: ["foreground", "text", "placeholder", "hint", "field", "input"] },
+    { test: /^--line-2$/, describe: () => "A stronger divider — section breaks and emphasized rules.", tags: ["border", "divider", "line", "rule", "separator", "stroke"] },
+    { test: /^--line$/, describe: () => "The default divider — hairlines, card edges, table rules.", tags: ["border", "divider", "line", "rule", "separator", "stroke", "edge"] },
+    { test: /^--ring-bg$/, describe: () => "The soft halo behind a focus ring — a faint accent wash around the crisp ring.", tags: ["focus", "ring", "outline", "halo", "accent"] },
+    { test: /^--ring$/, describe: () => "The focus ring — the accent outline on a keyboard-focused control.", tags: ["focus", "ring", "outline", "accent", "keyboard"] },
+    { test: /^--field-border$/, describe: () => "The border of an input field — separates the field from its surface.", tags: ["border", "field", "input", "form", "edge"] },
+    { test: /^--field-bg$/, describe: () => "The interior of an input field — the surface text is typed onto.", tags: ["background", "surface", "field", "input", "form"] },
+    { test: /^--accent-2-vivid$|^--accent-[234]-vivid$/, describe: () => "A secondary accent's vivid on-surface ink — punchy text/icons on a panel.", tags: ["accent", "vivid", "ink", "secondary", "harmony"] },
+    { test: /^--accent-([234])(-(bg|fg|text|vivid))?$/, describe: (n) => { const i = n.match(/accent-([234])/)?.[1]; const role = n.match(/-(bg|fg|text|vivid)$/)?.[1]; return role ? `Secondary accent ${i} — its ${{ bg: "soft tint", fg: "on-solid ink", text: "on-surface ink", vivid: "vivid ink" }[role]}.` : `Secondary accent ${i} — part of the accent harmony fanned off the brand color.`; }, tags: ["accent", "harmony", "secondary", "brand"] },
+    { test: /^--accent-(hover|active)$/, describe: (n) => `The accent on ${n.includes("hover") ? "hover" : "press"} — a small shift for interaction feedback.`, tags: ["accent", "hover", "active", "press", "interaction", "state"] },
+    { test: /^--accent-bg$/, describe: () => "The soft accent tint — a faint accent wash for selected/subtle accent surfaces.", tags: ["accent", "tint", "background", "soft", "subtle"] },
+    { test: /^--accent-fg$/, describe: () => "Text/icons on a solid accent fill — reads against a filled accent button.", tags: ["accent", "foreground", "ink", "on-accent", "button"] },
+    { test: /^--accent-text$/, describe: () => "Accent-colored text on the page — emphasis ink that still clears contrast.", tags: ["accent", "text", "ink", "emphasis", "link"] },
+    { test: /^--accent-shift-step$/, describe: () => "The hue step (degrees) the accent harmony fans by — a tuning value, not a color.", tags: ["accent", "harmony", "hue", "step", "tuning"] },
+    { test: /^--accent$/, describe: () => "The brand color — primary buttons, focus, links, the theme's signature.", tags: ["accent", "brand", "primary", "highlight"] },
+    { test: /^--neutral(-(bg|fg|text|vivid))?$/, describe: (n) => { const role = n.match(/-(bg|fg|text|vivid)$/)?.[1]; return role ? `The neutral tone — its ${{ bg: "soft tint", fg: "on-solid ink", text: "on-surface ink", vivid: "vivid ink" }[role]}.` : "A near-gray tone for secondary fills — quiet chips, muted buttons."; }, tags: ["neutral", "gray", "grey", "muted", "subtle", "secondary"] },
+    { test: /^--(success|warn|danger|info)(-(bg|fg|text|vivid))?$/, describe: (n) => { const role = n.match(/-(success|warn|danger|info)/)?.[1]; const part = n.match(/-(bg|fg|text|vivid)$/)?.[1]; const word = { success: "success / positive", warn: "warning / caution", danger: "error / destructive", info: "informational" }[role]; return part ? `The ${word} status — its ${{ bg: "soft tint", fg: "on-solid ink", text: "on-surface ink", vivid: "vivid ink" }[part]}.` : `The ${word} status fill.`; }, tags: ["status", "semantic"] },
+    { test: /^--state-/, describe: (n) => `The ${n.replace("--state-", "")} state overlay — a translucent wash layered on a control while it is ${n.replace("--state-", "")}.`, tags: ["state", "overlay", "hover", "press", "selected", "disabled", "drag", "interaction"] },
+    { test: /^--link-hover$/, describe: () => "A link on hover.", tags: ["link", "hover", "anchor", "href", "interaction"] },
+    { test: /^--link$/, describe: () => "Hyperlink text.", tags: ["link", "anchor", "href"] },
+    { test: /^--selection$/, describe: () => "The highlight behind selected text.", tags: ["selection", "highlight", "select", "mark"] },
+    { test: /^--highlight$/, describe: () => "A marker highlight — the wash behind emphasized/searched text.", tags: ["highlight", "mark", "marker", "search"] },
+    { test: /^--selection-cue$/, describe: () => "How a selection is signalled (tint vs marker) — an intent value, not a color.", tags: ["selection", "cue", "intent", "accessibility"] },
+    { test: /^--color-([a-z]+)-(subtle|muted|base|strong|contrast)$/, describe: (n) => { const m = n.match(/^--color-([a-z]+)-([a-z]+)$/); return `The ${m?.[2]} stop of the ${m?.[1]} ramp — a named-color swatch step.`; }, tags: ["palette", "named", "crayola", "color", "hue", "ramp", "swatch"] },
+    { test: /^--color-([a-z]+)$/, describe: (n) => `The ${n.replace("--color-", "")} swatch — the base of its named-color ramp.`, tags: ["palette", "named", "crayola", "color", "hue", "swatch"] },
+    { test: /^--(red|orange|yellow|green|blue|purple|brown|pink|cyan|gray|white|black)(-(bg|fg|text|vivid))?$/, describe: (n) => { const hue = n.match(/^--([a-z]+)/)?.[1]; const role = n.match(/-(bg|fg|text|vivid)$/)?.[1]; return role ? `The ${hue} tone — its ${{ bg: "soft tint", fg: "on-solid ink", text: "on-surface ink", vivid: "vivid ink" }[role]}.` : `The ${hue} tone — a named color usable anywhere a tone is.`; }, tags: ["palette", "named", "crayola", "color", "hue", "tone"] },
+    { test: /^--code-/, describe: (n) => `Syntax color for the \`${n.replace("--code-", "")}\` scope in highlighted code.`, tags: ["code", "syntax", "highlight", "editor"] },
+    { test: /^--font-/, describe: (n) => `The ${n.replace("--font-", "")} font stack.`, tags: ["type", "font", "typography", "family"] },
+    { test: /^--text-/, describe: (n) => `The ${n.replace("--text-", "")} font size on the type scale.`, tags: ["type", "text", "size", "scale", "typography"] },
+    { test: /^--leading-/, describe: (n) => `${n.replace("--leading-", "")} line height.`, tags: ["type", "leading", "line-height", "typography"] },
+    { test: /^--weight-/, describe: (n) => `The ${n.replace("--weight-", "")} font weight.`, tags: ["type", "weight", "bold", "typography"] },
+    { test: /^--radius-/, describe: (n) => `The ${n.replace("--radius-", "")} corner radius.`, tags: ["geometry", "radius", "corner", "rounding"] },
+    { test: /^--border-/, describe: (n) => `The ${n.replace("--border-", "")} border width.`, tags: ["geometry", "border", "width", "stroke"] },
+    { test: /^--duration-/, describe: (n) => `The ${n.replace("--duration-", "")} animation duration.`, tags: ["motion", "duration", "animation", "transition", "timing"] },
+    { test: /^--ease-/, describe: (n) => `The ${n.replace("--ease-", "")} easing curve.`, tags: ["motion", "ease", "easing", "curve", "timing"] },
+    { test: /^--elevation-/, describe: (n) => `Elevation ${n.replace("--elevation-", "")} — the shadow for a surface raised this far.`, tags: ["elevation", "shadow", "depth", "raised"] },
+    { test: /^--shadow$/, describe: () => "The default drop shadow.", tags: ["shadow", "elevation", "depth"] },
+    { test: /^--space-/, describe: (n) => `Spacing step ${n.replace("--space-", "")} on the spacing scale.`, tags: ["spacing", "space", "gap", "padding", "margin"] },
+    { test: /^--scheme$/, describe: () => "Whether the theme is light or dark — an intent value, not a color.", tags: ["scheme", "light", "dark", "mode"] },
+];
+/** The description + tags for a token. Unknown (author-declared) tokens get a name-derived fallback. */
+export function tokenMeta(name) {
+    for (const rule of RULES) {
+        if (rule.test.test(name))
+            return { description: rule.describe(name), tags: rule.tags };
+    }
+    return { description: "", tags: name.replace(/^--/, "").split("-").filter(Boolean) };
+}
+/** The full lowercase searchable text for a token: its name, group title, description, and tags. */
+export function tokenSearchText(name, groupTitle) {
+    const meta = tokenMeta(name);
+    return `${name} ${groupTitle} ${meta.description} ${meta.tags.join(" ")}`.toLowerCase();
+}
+//# sourceMappingURL=token-meta.js.map

package/dist/token-meta.js.map

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