basalt-ui 1.41.0 → 2.0.0

package/dist/tokens/derive.d.ts

@@ -1,4 +1,4 @@
-import type { ColorPair } from './index.js';
+import type { ColorPair } from './core.js';
 export type DeriveConfig = {
     /**
      * Seed hex — the one color a consumer picks. Drives the entire accent family + `onAccent`.

package/dist/tokens/derive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/tokens/derive.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C;kGAC8F;IAC9F,UAAU,EAAE,MAAM,CAAA;IAClB;mDAC+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAE,YAOnC,CAAA;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEnE;AAuHD,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,CAAA;AA6DZ,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,OAAO,GACP,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,CAAA;AA2Bd,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAUvD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAS/C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAA;IACvB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;8BAC8B;AAC9B,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAA;IACjB,WAAW,EAAE,SAAS,CAAA;IACtB,UAAU,EAAE,SAAS,CAAA;IACrB,eAAe,EAAE,SAAS,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IACnC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;CACrC,CAAA;AAED;;8DAE8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAQjE;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC,EAChD,MAAM,EAAE,YAAY,GACnB,cAAc,CA+GhB"}
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/tokens/derive.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEvC,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;;;OAQG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C;kGAC8F;IAC9F,UAAU,EAAE,MAAM,CAAA;IAClB;mDAC+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAE,YAOnC,CAAA;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEnE;AAuHD,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,CAAA;AA6DZ,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,OAAO,GACP,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,CAAA;AA2Bd,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAUvD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAS/C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAA;IACvB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;8BAC8B;AAC9B,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAA;IACjB,WAAW,EAAE,SAAS,CAAA;IACtB,UAAU,EAAE,SAAS,CAAA;IACrB,eAAe,EAAE,SAAS,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IACnC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;CACrC,CAAA;AAED;;8DAE8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAQjE;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC,EAChD,MAAM,EAAE,YAAY,GACnB,cAAc,CA+GhB"}

package/dist/tokens/index.d.ts

@@ -1,377 +1,9 @@
 /**
- * Mantine-free token + palette layer.
- *
- * This module is PURE DATA + string helpers — ZERO `@mantine/*` imports (lint-enforced).
- * Colors are CSS custom properties under the `--vx-*` prefix (do NOT rename the prefix).
- * They resolve per color scheme in CSS, so `VX.*` works in components AND in non-component
- * files. Apply opacity via `alpha(token, a)` (never raw `rgba()`) so the hue keeps resolving.
- *
- * Grounded in argo `packages/charts/src/{tokens,palette,theme-vars,utils/color}.ts`.
+ * `basalt-ui/tokens` — the Mantine-free token layer's public surface. The implementation lives in
+ * `./core` (internal: the provider, CLI and theme import it from there); only what a consumer
+ * names is re-exported here.
  */
-import type { PaletteData, RadiusValues, SpaceValues } from './palette.js';
 export { BP, p } from './palette.js';
-export { DEFAULT_DERIVE_CONFIG, deriveTokens, resolveDeriveConfig } from './derive.js';
-export type { DeriveConfig, DerivedPalette } from './derive.js';
-export { deriveRadius } from './palette.js';
-export type { RadiusValues } from './palette.js';
-export { deriveSpacing } from './palette.js';
-export type { SpaceValues } from './palette.js';
-export { CONTAINER_CLASSES, CONTAINER_GRID_BREAKPOINTS, CONTAINER_KEYS, resolveContainerClass, SIZE_CLASSES, } from './size-classes.js';
-export type { ContainerClass } from './size-classes.js';
-/** A per-theme color pair: a hue keeps its identity but shifts shade across schemes. */
-export type ColorPair = {
-    light: string;
-    dark: string;
-};
-/** A map of token name → per-theme color pair (the input shape for series/group builders). */
-export type SeriesMap = Record<string, ColorPair>;
-/**
- * Apply opacity to any palette token, theme-aware. Use instead of raw `rgba()` so the
- * underlying hue still resolves per color scheme.
- *
- *   alpha(VX.neutral, 0.5)        // muted hairline
- *   alpha(VX.status.warn, 0.1)    // zone-band fill
- */
-export declare const alpha: (token: string, a: number) => string;
-export declare const VX: {
-    readonly lineWidth: 2.5;
-    readonly line2Width: 2;
-    readonly axisFont: 11;
-    readonly dotR: number;
-    readonly dashArray: "6 4";
-    readonly legendGap: number;
-    readonly legendFontSize: 13.5;
-    readonly text: {
-        readonly nano: 10;
-        readonly micro: 11;
-        readonly xs: 12.5;
-        readonly sm: 13.5;
-        readonly md: 15;
-        readonly lg: 16;
-        readonly xl: 18;
-        readonly h2: 21;
-        readonly kpi: 24;
-        readonly h1: 26;
-        readonly display: 30;
-    };
-    readonly radiusCard: "var(--vx-radius-card)";
-    readonly radiusCtrl: "var(--vx-radius-ctrl)";
-    readonly radiusPill: "var(--vx-radius-pill)";
-    readonly hit: "var(--vx-hit)";
-    readonly space: {
-        readonly controlHeightTag: "var(--vx-space-control-height-tag)";
-        readonly controlHeightWidget: "var(--vx-space-control-height-widget)";
-        readonly controlHeightCtl: "var(--vx-space-control-height-ctl)";
-        readonly pageBarRowHeight: "var(--vx-space-page-bar-row-height)";
-        readonly sectionHeaderHeight: "var(--vx-space-section-header-height)";
-        readonly widgetHeaderHeight: "var(--vx-space-widget-header-height)";
-        readonly sidebarBlockRowHeight: "var(--vx-space-sidebar-block-row-height)";
-        readonly controlGap: "var(--vx-space-control-gap)";
-        readonly sheetRowHeight: "var(--vx-space-sheet-row-height)";
-    };
-    readonly line2Dark: "var(--vx-line2)";
-    readonly good: "var(--vx-good)";
-    readonly goodSoft: "var(--vx-good-soft)";
-    readonly bad: "var(--vx-bad)";
-    readonly warn: "var(--vx-warn)";
-    readonly goodSolid: "var(--vx-good-solid)";
-    readonly badSolid: "var(--vx-bad-solid)";
-    readonly warnSolid: "var(--vx-warn-solid)";
-    readonly goodRef: "var(--vx-good-ref)";
-    readonly badRef: "var(--vx-bad-ref)";
-    readonly warnRef: "var(--vx-warn-ref)";
-    readonly line: "var(--vx-line)";
-    readonly line2: "var(--vx-line2)";
-    readonly axis: "var(--vx-axis)";
-    readonly axisStroke: "var(--vx-axis-stroke)";
-    readonly grid: "var(--vx-grid)";
-    readonly crosshair: "var(--vx-crosshair)";
-    readonly dotStroke: "var(--vx-dot-stroke)";
-    readonly legendText: "var(--vx-legend-text)";
-    readonly tooltipMuted: "var(--vx-tooltip-muted)";
-    readonly neutral: "var(--vx-neutral)";
-    readonly ink: "var(--vx-ink)";
-    readonly ink2: "var(--vx-ink2)";
-    readonly muted: "var(--vx-muted)";
-    readonly faint: "var(--vx-faint)";
-    readonly accent: "var(--vx-accent)";
-    readonly accentHover: "var(--vx-accent-hover)";
-    readonly accentFill: "var(--vx-accent-fill)";
-    readonly accentFillHover: "var(--vx-accent-fill-hover)";
-    readonly onAccent: "var(--vx-on-accent)";
-    readonly divider: "var(--vx-divider)";
-    readonly shadowCard: "var(--vx-shadow-card)";
-    readonly shadowCtrl: "var(--vx-shadow-ctrl)";
-    readonly shadowRaised: "var(--vx-shadow-raised)";
-    readonly shadowOverlay: "var(--vx-shadow-overlay)";
-    readonly surface: {
-        readonly bg: "var(--vx-surface-bg)";
-        readonly panel: "var(--vx-surface-panel)";
-        readonly panelHover: "var(--vx-surface-panel-hover)";
-        readonly elevated: "var(--vx-surface-elevated)";
-        readonly subtle: "var(--vx-surface-subtle)";
-        readonly overlay: "var(--vx-surface-overlay)";
-        readonly field: "var(--vx-surface-field)";
-        readonly border: "var(--vx-surface-border)";
-        readonly hairline: "var(--vx-surface-hairline)";
-    };
-    readonly status: {
-        readonly excellent: "var(--vx-status-excellent)";
-        readonly good: "var(--vx-status-good)";
-        readonly warn: "var(--vx-status-warn)";
-        readonly bad: "var(--vx-status-bad)";
-        readonly neutral: "var(--vx-status-neutral)";
-    };
-    readonly margin: {
-        readonly top: number;
-        readonly right: number;
-        readonly bottom: number;
-        readonly left: number;
-    };
-    readonly minPxPerTick: 55;
-    /**
-     * Floor on a chart's plot rect height, in px (`ChartFrame`). A legend wrapping to five rows at
-     * phone width used to eat a fixed `height={240}` toward zero and the plot simply stopped
-     * rendering — the plot never shrinks past this, the frame grows instead (or, under `fill`, the
-     * legend rolls up).
-     */
-    readonly minPlotHeight: 120;
-    /** Every floating chart overlay portalled to `document.body` — a pinned tooltip, the legend's
-     * `All N` disclosure and its backdrop — shares one stacking value, so they always stack the same
-     * way relative to page chrome and to each other. */
-    readonly zIndexFloating: 9999;
-};
-/**
- * Layout breakpoints, in px, for the places CSS cannot read a custom property.
- *
- * A `@media` query's condition is resolved before custom properties exist, so
- * `@media (max-width: var(--x))` is invalid CSS — a stylesheet with a responsive rule has no
- * choice but to write the number. This constant is the other half of that literal: the CSS states
- * the number and names the token beside it, and a test asserts the two agree
- * (`content/article-layout.breakpoint.test.ts`, the same "literal must match the token" idiom as
- * `styles.floor.test.ts`).
- *
- * Only breakpoints that are genuinely a CSS-authored `@media` belong here. A component that can
- * measure its own box uses the measurement instead (`CONTAINER_CLASSES`), and Mantine chrome uses
- * `theme.breakpoints`.
- */
-export declare const BREAKPOINTS: {
-    /**
-     * `content/article-layout.module.css` — below this the TOC rail is dropped and the article
-     * collapses to a single centred column. Well above the `sm` (52.5em/840px) shell breakpoint on
-     * purpose: the rail needs the prose measure PLUS its own width plus the column gap, which runs
-     * out long before the shell goes mobile.
-     */
-    readonly article: 1200;
-};
-/** Resolved chart plot-area margins — the return shape of {@link chartMargin}. */
-export type ChartMargin = {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-};
-/**
- * Chart plot-area margins — `VX.margin` widened for an `AxisRightNumeric`'s tick labels, and/or
- * overridden per side. A token can't express "only when a right axis is rendered", so this is a
- * function, not a second static token — also the seam that could one day track `density`
- * (`VX.margin` itself is frozen at the level-0 snapshot; see `deriveSpacing`'s JSDoc).
- *
- * Law, applied in this order: start from `VX.margin`; when `rightAxis` is true, widen `right` to
- * `Math.max(VX.margin.right, <right-axis minimum>)` (`SPACE_STEP.chartMarginRightAxis`); then any
- * explicitly passed side wins last (including overriding `rightAxis`'s widened `right`).
- * `chartMargin()` with no args deep-equals `VX.margin`.
- *
- * Returns a NEW object every call — memoize at the call site (`useMemo`), the same way `Bars`
- * already memoizes its own margin.
- */
-export declare function chartMargin(opts?: {
-    /** Reserve room for an `AxisRightNumeric`'s tick labels. */
-    rightAxis?: boolean;
-    top?: number;
-    right?: number;
-    bottom?: number;
-    left?: number;
-}): ChartMargin;
-/**
- * A px number expressed as the plain rem STRING literal (16px base: `pxRem(6)` → `'0.375rem'`) —
- * NOT Mantine's own `rem()` helper, which instead emits a `calc(...)` expression bound to
- * `--mantine-scale` (a different value; that scaling happens at the Mantine-coupled call site
- * instead — see `theme/index.ts`'s `Input.extend` `vars` for why `--vx-space-input-height` needs
- * both halves). The SINGLE source for this conversion — `theme/index.ts` imports this instead of
- * keeping its own copy, so the radius/spacing size-scale steps and this module's own rem-emitting
- * vars (`--vx-space-input-height`) can never compute the conversion two different ways.
- */
-export declare function pxRem(px: number): string;
-/**
- * Wrap a map of `{ name: ColorPair }` into `var(--vx-<prefix><name>)` token refs — the runtime
- * companion to `buildPaletteCss`. Lets a consumer define its own series and read stable refs.
- *
- * Returns an exact-keyed object: the return type mirrors the keys of the input map, so a renamed
- * or removed key becomes a tsc error rather than silently widening to `Record<string, string>`.
- */
-export declare function seriesTokens<const T extends SeriesMap>(map: T, prefix?: string): {
-    [K in keyof T]: string;
-};
-/**
- * Define a named series map. Identity passthrough — gives consumers a typed authoring entry
- * point and preserves the exact literal keys of the input (const-generic so callers get back T,
- * not the widened SeriesMap, enabling downstream exact-key checks in groupTokens / seriesTokens).
- */
-export declare function defineSeries<const T extends SeriesMap>(map: T): T;
-/**
- * Build a single namespaced group's token refs (`var(--vx-<name>-<key>)`).
- *
- * Returns an exact-keyed object matching the keys of `map` — a stale or renamed key is a tsc
- * error at the call site rather than a silent `Record<string, string>` widening.
- */
-export declare function groupTokens<const T extends SeriesMap>(name: string, map: T): {
-    [K in keyof T]: string;
-};
-/**
- * The attribute + values the per-scheme blocks key off. Defaults reproduce Mantine's own toggle
- * (`data-mantine-color-scheme` = `dark` / `light`), so a consumer only names the axis it differs
- * on. Supplying this object at all switches the emitter onto the framework-neutral selector shape
- * — see {@link BuildPaletteOpts.scheme}.
- */
-export type ColorSchemeSelector = {
-    attribute?: string;
-    darkValue?: string;
-    lightValue?: string;
-};
-/** Options for {@link buildPaletteCss}. */
-export type BuildPaletteOpts = {
-    /** Extra named series maps to emit under the given prefixes (e.g. `{ '': SERIES, 'activity-': ACTIVITY }`). */
-    groups?: Record<string, SeriesMap>;
-    /** Theme-independent derived declarations (gradients, semantic fills) emitted once on `:root`. */
-    derived?: string[];
-    /**
-     * Attribute + values the per-scheme blocks key off — for a consumer whose scheme toggle is not
-     * Mantine's (a static site on `data-theme`, say). Default: Mantine's own
-     * `data-mantine-color-scheme` = `dark` / `light`.
-     *
-     * Setting ANY of `scheme` / `defaultScheme` / `mediaFallback` moves the emitter off the legacy
-     * `html[…]` selector onto `:root[…]`. That is deliberate and load-bearing, NOT cosmetic:
-     *
-     *   `:root[data-theme='dark']`   0-2-0   ← what this path emits
-     *   `html[data-theme='dark']`    0-1-1
-     *   `[data-theme='dark']`        0-1-0   ← same as a bare `:root`, so source order decides
-     *
-     * A light-default site whose own `:root` block happens to come last would beat the third form
-     * outright — dark mode silently does nothing. `:root[…]` sits above both a bare `:root` and
-     * `html[…]`, and carries no assumption about the element the attribute lands on.
-     *
-     * The no-options path keeps emitting `html[data-mantine-color-scheme='…']` verbatim, because a
-     * basalt consumer may already override `--vx-*` under that exact selector — raising basalt's own
-     * specificity would silently win over their override.
-     */
-    scheme?: ColorSchemeSelector;
-    /**
-     * Which scheme rides along on the bare `:root` block — the one that applies when the attribute
-     * is absent. Default: `'dark'` (the framework's own default scheme).
-     *
-     * `'none'` emits no bare-`:root` primitives at all: each scheme gets only its attribute block,
-     * and an unattributed document falls back to the theme-independent scalars alone. Pair it with
-     * `mediaFallback` unless the consumer always sets the attribute.
-     */
-    defaultScheme?: 'dark' | 'light' | 'none';
-    /**
-     * Also emit an `@media (prefers-color-scheme: …)` block for every scheme that is not the bare
-     * `:root` default, so a document with no attribute set follows the OS. Default: `false`.
-     *
-     * The block is a bare `:root` (0-1-0), so an explicit attribute block (0-2-0) always wins over
-     * it regardless of source order — the OS preference is a fallback, never an override.
-     */
-    mediaFallback?: boolean;
-    /**
-     * How much of the SPACING set to emit. Default: `'all'` (every one of the 108 `--vx-space-*`
-     * declarations the framework's own components read).
-     *
-     * `'core'` keeps the 9 generic anchors — the stack rhythm, the two control heights, the row
-     * insets — and drops the 99 named for a specific basalt component
-     * (`--vx-space-agent-transcript-inset`, `--vx-space-toc-sub-indent`, …), taking the emitted set
-     * from 204 variables to 105. Nothing outside basalt's own React components reads those, so a
-     * framework-free consumer is carrying them for nothing.
-     *
-     * This is a SPACING filter only: color, radius, shadow, type and status variables are identical
-     * in both modes. The partition is derived from the `SPACE` key set rather than a maintained list
-     * — see {@link CORE_SPACE_VARS}.
-     */
-    only?: 'core' | 'all';
-    /**
-     * Whether to also emit the 32 deprecated camelCase aliases (`--vx-accentFill`, `--vx-tooltipBg`,
-     * `--vx-fillHover-gray`, …) alongside the canonical kebab-case names the 1.4.0 normalization
-     * introduced. Default: `true`, so an existing consumer's hand-written CSS referencing a
-     * camelCase name keeps resolving. Each alias is defined as `var(--vx-<canonical>)` — it can
-     * never drift from the value it aliases. Pass `false` once every reference in your own code has
-     * migrated to the kebab names to drop the extra 32 lines.
-     */
-    legacyAliases?: boolean;
-};
-/**
- * Emit the `--vx-*` stylesheet: a `:root` block of theme-independent scalars, then the
- * dark (default) and light primitive blocks under `html[data-mantine-color-scheme='…']`.
- *
- * The framework chrome (STATUS/SEMANTIC/SURFACE pairs + the framework DERIVED defaults) is
- * built in, so an empty `buildPaletteCss()` already emits every framework var. Consumer
- * `opts.groups` / `opts.derived` append on top (e.g. argo's domain SERIES/ACTIVITY/USAGE).
- *
- * `data` defaults to the static, shipped palette (`buildPaletteData()` at `DEFAULT_DERIVE_CONFIG`)
- * — pass the result of `buildPaletteData(config)` to emit CSS for a retuned derive config instead
- * (this is how `BasaltProvider` follows `createBasaltTheme`'s `{ derive }` option; see `../theme`
- * and `../provider`).
- *
- * Dark is the default (`:root`) since the framework defaults to dark; the
- * `[data-mantine-color-scheme]` selectors track Mantine's toggle on `<html>`.
- *
- * A non-Mantine consumer retargets all three of those choices — the attribute, which scheme rides
- * the bare `:root`, and whether the OS preference is honoured — via `opts.scheme` /
- * `opts.defaultScheme` / `opts.mediaFallback`. Setting any of them also moves the per-scheme
- * selector from `html[…]` to the framework-neutral, higher-specificity `:root[…]`; see
- * `BuildPaletteOpts.scheme` for why that is not cosmetic. With none of them set the output is
- * byte-identical to what the framework has always emitted (pinned by
- * `tests/palette-css.test.ts`).
- */
-export declare function buildPaletteCss(opts?: BuildPaletteOpts, data?: PaletteData): string;
-/**
- * The `fonts` option's resolved shape — a full CSS font-family stack string per slot (with its own
- * fallback chain), riding the `--basalt-font-sans/head/mono` override seam `styles.css` ships
- * fallbacks for. Omitted keys keep the shipped fallback untouched. Lives here (not in `../theme`,
- * which only RE-EXPORTS it) because its builder `buildFontsCss` below is a pure, Mantine-free
- * string builder that belongs in the tokens layer — see `../theme`'s
- * `CreateBasaltThemeOptions.fonts` for the production entry point that sets it.
- */
-export type BasaltFontsConfig = {
-    sans?: string;
-    head?: string;
-    mono?: string;
-};
-/**
- * Build the `:root` block of `--basalt-font-*` declarations for a resolved `basaltFonts` config —
- * only for the keys the consumer actually set (`createBasaltTheme(overrides, { fonts })`); an
- * omitted key keeps the shipped `styles.css` fallback chain untouched. Empty string when `fonts` is
- * absent or every key is omitted, so callers can unconditionally concatenate the result. Importable
- * from `basalt-ui/tokens` — `BasaltProvider`'s bridge (`../provider`) calls this directly to append
- * declarations to its injected `<style>`; an SSR/custom-injection consumer with
- * `injectPalette={false}` calls it themselves (see the JSDoc on that prop).
- */
-export declare function buildFontsCss(fonts: BasaltFontsConfig | undefined): string;
-/**
- * Build the `:root` block of overriding `--vx-radius-*` declarations for a resolved
- * `basaltRadius` value (`createBasaltTheme(overrides, { radius })`) — analog of {@link buildFontsCss}.
- * Empty string when `radius` is absent (the default level-0 path never sets `theme.other.basaltRadius`
- * in the first place), so callers can unconditionally concatenate the result. Importable from
- * `basalt-ui/tokens`, same SSR/custom-injection use as `buildFontsCss` above.
- */
-export declare function buildRadiusCss(radius: RadiusValues | undefined): string;
-/**
- * Build the `:root` block of overriding `--vx-space-*` declarations for a resolved `basaltDensity`
- * value (`createBasaltTheme(overrides, { density })`) — analog of {@link buildRadiusCss}, reusing
- * the SAME `spaceDecls` list `frameworkDerived` emits the shipped defaults from (so the two can
- * never drift). Empty string when `space` is absent (the default level-0 path never sets
- * `theme.other.basaltDensity` in the first place), so callers can unconditionally concatenate the
- * result. Importable from `basalt-ui/tokens`, same SSR/custom-injection use as `buildRadiusCss`
- * above.
- */
-export declare function buildDensityCss(space: SpaceValues | undefined): string;
+export { CONTAINER_CLASSES, CONTAINER_GRID_BREAKPOINTS, CONTAINER_KEYS } from './size-classes.js';
+export { alpha, buildPaletteCss, defineSeries, groupTokens, seriesTokens, VX, type ColorPair, type SeriesGroup, type SeriesMap, } from './core.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9F,OAAO,EACL,KAAK,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,EAAE,EACF,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,QAAQ,CAAA"}