@wzrhine/tokens 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog · @wzrhine/tokens
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。token **重命名或删除**视为破坏性变更；**色值调整**会注明对比度验证结果。
+
+## [Unreleased]
+
+## [0.2.0] - 2026-10-14
+
+与四个组件 / 契约包保持同一版本线。本包没有删除或重命名 token，既有 token 的取值未变。
+
+### Added
+- 分类色 `--rl-category-1` … `--rl-category-8`：展示性分类（工具类别、材料分类等）的色调，随 `publicTokens` 纳入冻结合约（ADR-0013：展示性分类只驱动标签、图标与色调，不驱动行为）。
+- `--rl-danger-hover`：危险操作悬停背景。浅色 `#bf3a34`（5.01:1）、深色 `#ffaba3`（9.92:1），system 主题同名重定义并登记对比度配对。
+
+### Fixed
+- 危险按钮悬停背景此前透明，因为对应的悬停 token 缺失；补齐后由 `@wzrhine/react` 的 Button `tone="danger"` 使用，组件侧修复见该包 changelog。
+
+## [0.1.0] - 2026-10-12
+
+首次发布。
+
+### Added
+- `.rl-theme` 作用域下的语义 CSS 变量：背景、前景、边框、研究橙信号、状态色、焦点、字体角色、4px 间距、圆角、边框宽度、密度、动效时长与缓动。不修改 `:root`。
+- 明 / 暗 / system 三套主题（`data-rl-theme`），以及 compact 密度（`data-rl-density`）和强制减动（`data-rl-motion="reduce"`）。
+- 类型化的 manifest（`colorGroups`、`typeRoles`、`spaceScale`、`motionDurations`、`contrastPairs` 等）和 `contrastRatio()` 工具。
+- 随组件逐步新增的 token：字段（`--rl-bg-readonly`、`--rl-field-label-width`）、浮层宽度与层级、`--rl-fg-on-danger`、`--rl-orbit-size`。
+- **M5**：通过 `dist/` 发布 ESM 与 `.d.ts`；`./styles.css` 导出。
+- **M6 · 稳定主题契约**：`publicTokens`（按用途分组）、`allPublicTokens`、`themedPublicTokens`、`themeAttributes`、类型 `PublicToken` / `TokenCategory`，以及 `tokenVar(name, fallback?)`。测试保证 `tokens.css` 定义的变量与契约完全一致（114 个），且 dark / system 主题恰好重定义全部颜色与阴影 token。此后删除或重命名契约内的 token 视为破坏性变更。
+
+### Changed
+- **M1-A（ADR-0003）**：浅色 `--rl-fg-muted`、`--rl-fg-subtle`、`--rl-accent-text` 与各状态色较 STYLE.md Draft 0.1 有所加深，以满足 WCAG 2.2 AA。`--rl-focus` 改为独立的蓝墨色。所有组合由测试在三种主题下验证。
+
+### Fixed
+- **M6**：system 主题块中 `--rl-bg-readonly` 重复声明（值相同，无视觉变化）；新增测试禁止任何块内重复声明。
+
+升级步骤见 [UPGRADING.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/development/UPGRADING.md)。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WhiteZhi
+
+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

@@ -1,3 +1,28 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @wzrhine/tokens
+
+WzRhineLab UI 的语义设计变量：`--rl-*` CSS 自定义属性（作用域为 `.rl-theme`，不修改 `:root`），以及一份类型化的 token 清单和对比度工具。
+
+> 原创配色，不是任何游戏的官方色板。MIT 许可证。
+
+```sh
+pnpm add @wzrhine/tokens
+```
+
+```ts
+import '@wzrhine/tokens/styles.css';
+import { contrastRatio, motionDurations } from '@wzrhine/tokens';
+```
+
+```html
+<div class="rl-theme" data-rl-theme="dark" data-rl-density="compact">…</div>
+```
+
+- 主题：`data-rl-theme="light" | "dark" | "system"`
+- 密度：`data-rl-density="comfortable" | "compact"`
+- 强制减动：`data-rl-motion="reduce"`
+
+所有组件实际用到的前景/背景组合，都由测试在三种主题下验证 WCAG 2.2 AA。
+
+- API 参考（自动生成）：[docs/api/tokens.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/api/tokens.md)
+- 变更记录：[CHANGELOG.md](./CHANGELOG.md)
+- 许可证：[MIT](./LICENSE)

package/dist/contract.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Stable theme contract (M6).
+ *
+ * The complete list of public `--rl-*` custom properties defined by `tokens.css`, grouped by
+ * purpose, plus the data attributes that switch theme, density and motion. Tests assert that
+ * `tokens.css` defines exactly this set, so the list cannot drift silently:
+ *
+ * - Removing or renaming a token, or an attribute value, is a breaking change (CHANGELOG + migration).
+ * - Adding a token is a minor change and must be added here in the same commit.
+ * - Changing a colour value is allowed in a patch release if every `contrastPairs` entry still passes.
+ *
+ * Variables named after a component (`--rl-button-*`, `--rl-toast-*` set inside component CSS)
+ * are internal to `@wzrhine/react` and are not part of this contract.
+ */
+export declare const themeAttributes: {
+    readonly theme: {
+        readonly attribute: "data-rl-theme";
+        readonly values: readonly ["light", "dark", "system"];
+    };
+    readonly density: {
+        readonly attribute: "data-rl-density";
+        readonly values: readonly ["comfortable", "compact"];
+    };
+    readonly motion: {
+        readonly attribute: "data-rl-motion";
+        readonly values: readonly ["reduce"];
+    };
+};
+export declare const publicTokens: {
+    /** Redefined by every theme. */
+    readonly color: readonly ["--rl-bg-canvas", "--rl-bg-surface", "--rl-bg-subtle", "--rl-bg-raised", "--rl-bg-hover", "--rl-bg-pressed", "--rl-bg-inverse", "--rl-bg-disabled", "--rl-bg-readonly", "--rl-fg-primary", "--rl-fg-muted", "--rl-fg-subtle", "--rl-fg-inverse", "--rl-fg-on-accent", "--rl-fg-on-danger", "--rl-fg-disabled", "--rl-border-subtle", "--rl-border-default", "--rl-border-strong", "--rl-accent", "--rl-accent-hover", "--rl-accent-subtle", "--rl-accent-text", "--rl-accent-amber", "--rl-info", "--rl-info-subtle", "--rl-success", "--rl-success-subtle", "--rl-warning", "--rl-warning-subtle", "--rl-danger", "--rl-danger-hover", "--rl-danger-subtle", "--rl-category-1", "--rl-category-2", "--rl-category-3", "--rl-category-4", "--rl-category-5", "--rl-category-6", "--rl-category-7", "--rl-category-8", "--rl-focus", "--rl-inverse-hover"];
+    /** Redefined by every theme. */
+    readonly elevation: readonly ["--rl-shadow-raised", "--rl-shadow-floating"];
+    readonly typography: readonly ["--rl-font-body", "--rl-font-mono", "--rl-type-display", "--rl-type-heading-1", "--rl-type-heading-2", "--rl-type-heading-3", "--rl-type-body", "--rl-type-body-sm", "--rl-type-label", "--rl-type-label-sm", "--rl-type-meta", "--rl-type-mono", "--rl-tracking-display", "--rl-tracking-caps", "--rl-tracking-mono"];
+    readonly space: readonly ["--rl-space-0", "--rl-space-1", "--rl-space-2", "--rl-space-3", "--rl-space-4", "--rl-space-6", "--rl-space-8", "--rl-space-12", "--rl-space-16"];
+    readonly shape: readonly ["--rl-radius-none", "--rl-radius-xs", "--rl-radius-sm", "--rl-radius-md", "--rl-radius-lg", "--rl-radius-round", "--rl-border-width", "--rl-border-width-strong"];
+    readonly focus: readonly ["--rl-focus-width", "--rl-focus-offset", "--rl-focus-ring"];
+    /** Redefined by `data-rl-density="compact"` (only the control and surface entries). */
+    readonly size: readonly ["--rl-control-height-sm", "--rl-control-height-md", "--rl-control-height-lg", "--rl-control-padding-x-sm", "--rl-control-padding-x-md", "--rl-control-padding-x-lg", "--rl-control-gap", "--rl-surface-padding", "--rl-icon-size-sm", "--rl-icon-size-md", "--rl-icon-size-lg", "--rl-badge-height-sm", "--rl-badge-height-md", "--rl-indicator-size", "--rl-field-label-width", "--rl-dialog-width-sm", "--rl-dialog-width-md", "--rl-dialog-width-lg", "--rl-tooltip-max-width", "--rl-popup-max-height", "--rl-popup-offset", "--rl-popover-width-sm", "--rl-popover-width-md", "--rl-popover-width-lg", "--rl-menu-min-width", "--rl-toast-width", "--rl-orbit-size"];
+    readonly layer: readonly ["--rl-z-overlay", "--rl-z-dialog", "--rl-z-popover", "--rl-z-tooltip", "--rl-z-toast"];
+    /** Durations collapse to 0ms under reduced motion (except `--rl-motion-loop`, whose users stop looping). */
+    readonly motion: readonly ["--rl-motion-instant", "--rl-motion-press", "--rl-motion-fast", "--rl-motion-base", "--rl-motion-panel", "--rl-motion-scene", "--rl-motion-showcase", "--rl-motion-loop", "--rl-ease-out", "--rl-ease-in-out", "--rl-ease-linear"];
+};
+export type TokenCategory = keyof typeof publicTokens;
+export type PublicToken = (typeof publicTokens)[TokenCategory][number];
+/** Every public token, in contract order. */
+export declare const allPublicTokens: readonly PublicToken[];
+export type ThemedToken = (typeof publicTokens)['color' | 'elevation'][number];
+/** Tokens each theme block (`dark`, `system`) must redefine. */
+export declare const themedPublicTokens: readonly ThemedToken[];
+/**
+ * `var(--rl-…)` for a contract token. Typed, so a renamed or misspelled token fails to compile
+ * in CSS-in-JS or inline styles instead of silently resolving to nothing.
+ */
+export declare function tokenVar(name: PublicToken, fallback?: string): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAIlB,CAAC;AAEX,eAAO,MAAM,YAAY;IACvB,gCAAgC;;IA8ChC,gCAAgC;;;;;;IAyChC,uFAAuF;;;IA+BvF,4GAA4G;;CAcpG,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,6CAA6C;AAC7C,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAAuC,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAAuD,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/contract.js

@@ -0,0 +1,165 @@
+/**
+ * Stable theme contract (M6).
+ *
+ * The complete list of public `--rl-*` custom properties defined by `tokens.css`, grouped by
+ * purpose, plus the data attributes that switch theme, density and motion. Tests assert that
+ * `tokens.css` defines exactly this set, so the list cannot drift silently:
+ *
+ * - Removing or renaming a token, or an attribute value, is a breaking change (CHANGELOG + migration).
+ * - Adding a token is a minor change and must be added here in the same commit.
+ * - Changing a colour value is allowed in a patch release if every `contrastPairs` entry still passes.
+ *
+ * Variables named after a component (`--rl-button-*`, `--rl-toast-*` set inside component CSS)
+ * are internal to `@wzrhine/react` and are not part of this contract.
+ */
+export const themeAttributes = {
+    theme: { attribute: 'data-rl-theme', values: ['light', 'dark', 'system'] },
+    density: { attribute: 'data-rl-density', values: ['comfortable', 'compact'] },
+    motion: { attribute: 'data-rl-motion', values: ['reduce'] },
+};
+export const publicTokens = {
+    /** Redefined by every theme. */
+    color: [
+        '--rl-bg-canvas',
+        '--rl-bg-surface',
+        '--rl-bg-subtle',
+        '--rl-bg-raised',
+        '--rl-bg-hover',
+        '--rl-bg-pressed',
+        '--rl-bg-inverse',
+        '--rl-bg-disabled',
+        '--rl-bg-readonly',
+        '--rl-fg-primary',
+        '--rl-fg-muted',
+        '--rl-fg-subtle',
+        '--rl-fg-inverse',
+        '--rl-fg-on-accent',
+        '--rl-fg-on-danger',
+        '--rl-fg-disabled',
+        '--rl-border-subtle',
+        '--rl-border-default',
+        '--rl-border-strong',
+        '--rl-accent',
+        '--rl-accent-hover',
+        '--rl-accent-subtle',
+        '--rl-accent-text',
+        '--rl-accent-amber',
+        '--rl-info',
+        '--rl-info-subtle',
+        '--rl-success',
+        '--rl-success-subtle',
+        '--rl-warning',
+        '--rl-warning-subtle',
+        '--rl-danger',
+        '--rl-danger-hover',
+        '--rl-danger-subtle',
+        '--rl-category-1',
+        '--rl-category-2',
+        '--rl-category-3',
+        '--rl-category-4',
+        '--rl-category-5',
+        '--rl-category-6',
+        '--rl-category-7',
+        '--rl-category-8',
+        '--rl-focus',
+        '--rl-inverse-hover',
+    ],
+    /** Redefined by every theme. */
+    elevation: ['--rl-shadow-raised', '--rl-shadow-floating'],
+    typography: [
+        '--rl-font-body',
+        '--rl-font-mono',
+        '--rl-type-display',
+        '--rl-type-heading-1',
+        '--rl-type-heading-2',
+        '--rl-type-heading-3',
+        '--rl-type-body',
+        '--rl-type-body-sm',
+        '--rl-type-label',
+        '--rl-type-label-sm',
+        '--rl-type-meta',
+        '--rl-type-mono',
+        '--rl-tracking-display',
+        '--rl-tracking-caps',
+        '--rl-tracking-mono',
+    ],
+    space: [
+        '--rl-space-0',
+        '--rl-space-1',
+        '--rl-space-2',
+        '--rl-space-3',
+        '--rl-space-4',
+        '--rl-space-6',
+        '--rl-space-8',
+        '--rl-space-12',
+        '--rl-space-16',
+    ],
+    shape: [
+        '--rl-radius-none',
+        '--rl-radius-xs',
+        '--rl-radius-sm',
+        '--rl-radius-md',
+        '--rl-radius-lg',
+        '--rl-radius-round',
+        '--rl-border-width',
+        '--rl-border-width-strong',
+    ],
+    focus: ['--rl-focus-width', '--rl-focus-offset', '--rl-focus-ring'],
+    /** Redefined by `data-rl-density="compact"` (only the control and surface entries). */
+    size: [
+        '--rl-control-height-sm',
+        '--rl-control-height-md',
+        '--rl-control-height-lg',
+        '--rl-control-padding-x-sm',
+        '--rl-control-padding-x-md',
+        '--rl-control-padding-x-lg',
+        '--rl-control-gap',
+        '--rl-surface-padding',
+        '--rl-icon-size-sm',
+        '--rl-icon-size-md',
+        '--rl-icon-size-lg',
+        '--rl-badge-height-sm',
+        '--rl-badge-height-md',
+        '--rl-indicator-size',
+        '--rl-field-label-width',
+        '--rl-dialog-width-sm',
+        '--rl-dialog-width-md',
+        '--rl-dialog-width-lg',
+        '--rl-tooltip-max-width',
+        '--rl-popup-max-height',
+        '--rl-popup-offset',
+        '--rl-popover-width-sm',
+        '--rl-popover-width-md',
+        '--rl-popover-width-lg',
+        '--rl-menu-min-width',
+        '--rl-toast-width',
+        '--rl-orbit-size',
+    ],
+    layer: ['--rl-z-overlay', '--rl-z-dialog', '--rl-z-popover', '--rl-z-tooltip', '--rl-z-toast'],
+    /** Durations collapse to 0ms under reduced motion (except `--rl-motion-loop`, whose users stop looping). */
+    motion: [
+        '--rl-motion-instant',
+        '--rl-motion-press',
+        '--rl-motion-fast',
+        '--rl-motion-base',
+        '--rl-motion-panel',
+        '--rl-motion-scene',
+        '--rl-motion-showcase',
+        '--rl-motion-loop',
+        '--rl-ease-out',
+        '--rl-ease-in-out',
+        '--rl-ease-linear',
+    ],
+};
+/** Every public token, in contract order. */
+export const allPublicTokens = Object.values(publicTokens).flat();
+/** Tokens each theme block (`dark`, `system`) must redefine. */
+export const themedPublicTokens = [...publicTokens.color, ...publicTokens.elevation];
+/**
+ * `var(--rl-…)` for a contract token. Typed, so a renamed or misspelled token fails to compile
+ * in CSS-in-JS or inline styles instead of silently resolving to nothing.
+ */
+export function tokenVar(name, fallback) {
+    return fallback === undefined ? `var(${name})` : `var(${name}, ${fallback})`;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/contrast.d.ts

@@ -0,0 +1,10 @@
+/** WCAG 2.x relative luminance and contrast ratio for opaque sRGB colours. */
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+}
+export declare function parseColor(input: string): Rgb | null;
+export declare function relativeLuminance({ r, g, b }: Rgb): number;
+export declare function contrastRatio(a: string, b: string): number;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAkBpD;AAOD,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAE1D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1D"}

package/dist/contrast.js

@@ -0,0 +1,39 @@
+/** WCAG 2.x relative luminance and contrast ratio for opaque sRGB colours. */
+export function parseColor(input) {
+    const value = input.trim().toLowerCase();
+    const hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/.exec(value);
+    if (hex) {
+        const digits = hex[1];
+        const full = digits.length === 3 ? [...digits].map((d) => d + d).join('') : digits;
+        return {
+            r: Number.parseInt(full.slice(0, 2), 16),
+            g: Number.parseInt(full.slice(2, 4), 16),
+            b: Number.parseInt(full.slice(4, 6), 16),
+        };
+    }
+    const rgb = /^rgba?\(\s*(\d+(?:\.\d+)?)[\s,]+(\d+(?:\.\d+)?)[\s,]+(\d+(?:\.\d+)?)(?:[\s,/]+(\d*\.?\d+))?\s*\)$/.exec(value);
+    if (rgb) {
+        if (rgb[4] !== undefined && Number(rgb[4]) < 1)
+            return null;
+        return { r: Number(rgb[1]), g: Number(rgb[2]), b: Number(rgb[3]) };
+    }
+    return null;
+}
+function channel(value) {
+    const c = value / 255;
+    return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+export function relativeLuminance({ r, g, b }) {
+    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);
+}
+export function contrastRatio(a, b) {
+    const ca = parseColor(a);
+    const cb = parseColor(b);
+    if (!ca || !cb)
+        return Number.NaN;
+    const la = relativeLuminance(ca);
+    const lb = relativeLuminance(cb);
+    const [hi, lo] = la > lb ? [la, lb] : [lb, la];
+    return (hi + 0.05) / (lo + 0.05);
+}
+//# sourceMappingURL=contrast.js.map

package/dist/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAQ9E,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACnF,OAAO;YACL,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACxC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACxC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;SACzC,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,mGAAmG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5H,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IACtB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAO;IAChD,OAAO,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAClC,MAAM,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './manifest.js';
+export { contrastRatio, parseColor, relativeLuminance } from './contrast.js';
+export type { Rgb } from './contrast.js';
+export { allPublicTokens, publicTokens, themeAttributes, themedPublicTokens, tokenVar } from './contract.js';
+export type { PublicToken, ThemedToken, TokenCategory } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './manifest.js';
+export { contrastRatio, parseColor, relativeLuminance } from './contrast.js';
+export { allPublicTokens, publicTokens, themeAttributes, themedPublicTokens, tokenVar } from './contract.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}