@chenzy-design/tokens 0.1.0

package/dist/contrast-check.js

@@ -0,0 +1,140 @@
+/**
+ * WCAG contrast audit for Alias tokens.
+ *
+ * Computes the relative-luminance contrast ratio for the body-level
+ * foreground/background token pairs that components actually render, and
+ * fails the build (non-zero exit) when any non-exempt pair is below the
+ * WCAG 2.1 AA threshold for normal text (4.5:1).
+ *
+ * Run: `pnpm -C packages/tokens a11y:contrast` (after `pnpm build`).
+ *
+ * Pairs marked `exempt` are reported (EXEMPT-FAIL) but never break the build.
+ * This now includes the solid status fills (success/warning/danger) carrying
+ * white text: the library targets 100% Semi Design color parity, and Semi's
+ * status colors paired with white text do NOT clear WCAG AA. That tradeoff is
+ * accepted, so those pairs are exempt. Semi-compliant pairs that DO clear AA
+ * (primary/link/text) remain hard gates.
+ */
+import { palette } from './global/color.js';
+import { aliasLight, aliasDark } from './alias/index.js';
+const AA_NORMAL = 4.5;
+/** Resolve an alias token to a concrete color for a given theme (dark inherits light). */
+function resolve(token, theme) {
+    const v = theme === 'dark' ? (aliasDark[token] ?? aliasLight[token]) : aliasLight[token];
+    return v;
+}
+/** Parse #rrggbb / #rgb / rgb()/rgba() into RGBA (0-255 channels, 0-1 alpha). */
+function parse(color) {
+    const c = color.trim();
+    if (c.startsWith('#')) {
+        let h = c.slice(1);
+        if (h.length === 3)
+            h = h.split('').map((x) => x + x).join('');
+        return {
+            r: parseInt(h.slice(0, 2), 16),
+            g: parseInt(h.slice(2, 4), 16),
+            b: parseInt(h.slice(4, 6), 16),
+            a: 1,
+        };
+    }
+    const m = c.match(/rgba?\(([^)]+)\)/i);
+    if (!m || !m[1])
+        throw new Error(`unparseable color: ${color}`);
+    const parts = m[1].split(',').map((s) => parseFloat(s.trim()));
+    return { r: parts[0] ?? 0, g: parts[1] ?? 0, b: parts[2] ?? 0, a: parts[3] ?? 1 };
+}
+/** Composite a (possibly translucent) foreground over an opaque background. */
+function over(fg, bg) {
+    const a = fg.a;
+    return {
+        r: fg.r * a + bg.r * (1 - a),
+        g: fg.g * a + bg.g * (1 - a),
+        b: fg.b * a + bg.b * (1 - a),
+        a: 1,
+    };
+}
+function channel(c) {
+    const s = c / 255;
+    return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+}
+function luminance(c) {
+    return 0.2126 * channel(c.r) + 0.7152 * channel(c.g) + 0.0722 * channel(c.b);
+}
+function contrast(fgColor, bgColor) {
+    const bg = parse(bgColor);
+    const fg = over(parse(fgColor), bg);
+    const l1 = luminance(fg);
+    const l2 = luminance(bg);
+    const hi = Math.max(l1, l2);
+    const lo = Math.min(l1, l2);
+    return (hi + 0.05) / (lo + 0.05);
+}
+/**
+ * Body-level token pairs that render real text. Secondary text (text-2) is
+ * audited only against the surfaces it actually sits on (bg-0 base canvas and
+ * bg-1 low fill); the higher elevation fills (bg-2/bg-3) are exempt because
+ * secondary text is not placed on them as body copy.
+ *
+ * The solid status fills (success/warning/danger with white text) are exempt:
+ * they mirror Semi Design exactly, and Semi's status colors with white text do
+ * not reach AA. We accept that to preserve 100% Semi color parity.
+ */
+const PAIRS = [
+    // --- light: secondary text on surfaces ---
+    { theme: 'light', label: 'text-2 on bg-0', fg: 'color-text-2', bg: 'color-bg-0' },
+    { theme: 'light', label: 'text-2 on bg-1', fg: 'color-text-2', bg: 'color-bg-1' },
+    { theme: 'light', label: 'text-2 on bg-2', fg: 'color-text-2', bg: 'color-bg-2', exempt: true },
+    { theme: 'light', label: 'text-2 on bg-3', fg: 'color-text-2', bg: 'color-bg-3', exempt: true },
+    // --- light: solid status buttons (white inverse text) — Semi-parity tradeoff ---
+    { theme: 'light', label: 'text-inverse on success', fg: 'color-text-inverse', bg: 'color-success', exempt: true },
+    { theme: 'light', label: 'text-inverse on warning', fg: 'color-text-inverse', bg: 'color-warning', exempt: true },
+    { theme: 'light', label: 'text-inverse on danger', fg: 'color-text-inverse', bg: 'color-danger', exempt: true },
+    // --- dark: solid primary/status buttons (white inverse text) ---
+    // Semi's dark-mode primary fill is a bright blue (#54a9ff) that, like the
+    // status fills, does not clear AA under white text. Exempt for Semi parity.
+    { theme: 'dark', label: 'text-inverse on primary', fg: 'color-text-inverse', bg: 'color-primary', exempt: true },
+    { theme: 'dark', label: 'text-inverse on primary-hover', fg: 'color-text-inverse', bg: 'color-primary-hover', exempt: true },
+    { theme: 'dark', label: 'text-inverse on primary-active', fg: 'color-text-inverse', bg: 'color-primary-active', exempt: true },
+    { theme: 'dark', label: 'text-inverse on info', fg: 'color-text-inverse', bg: 'color-info', exempt: true },
+    { theme: 'dark', label: 'text-inverse on success', fg: 'color-text-inverse', bg: 'color-success', exempt: true },
+    { theme: 'dark', label: 'text-inverse on warning', fg: 'color-text-inverse', bg: 'color-warning', exempt: true },
+    { theme: 'dark', label: 'text-inverse on danger', fg: 'color-text-inverse', bg: 'color-danger', exempt: true },
+    // --- dark: primary as link/foreground on surfaces ---
+    { theme: 'dark', label: 'primary link on bg-0', fg: 'color-primary', bg: 'color-bg-0' },
+    { theme: 'dark', label: 'primary link on bg-1', fg: 'color-primary', bg: 'color-bg-1' },
+    // --- component consumption: solid status fills (Switch / Tag / Badge) ---
+    // White text on Semi status fills; exempt for Semi parity (see above).
+    { theme: 'light', label: 'solid primary fill text', fg: 'color-text-inverse', bg: 'color-primary' },
+    { theme: 'light', label: 'solid success fill text', fg: 'color-text-inverse', bg: 'color-success', exempt: true },
+    { theme: 'light', label: 'solid warning fill text', fg: 'color-text-inverse', bg: 'color-warning', exempt: true },
+    { theme: 'light', label: 'solid danger fill text', fg: 'color-text-inverse', bg: 'color-danger', exempt: true },
+    { theme: 'dark', label: 'solid success fill text', fg: 'color-text-inverse', bg: 'color-success', exempt: true },
+    { theme: 'dark', label: 'solid warning fill text', fg: 'color-text-inverse', bg: 'color-warning', exempt: true },
+    { theme: 'dark', label: 'solid danger fill text', fg: 'color-text-inverse', bg: 'color-danger', exempt: true },
+];
+let bodyFailures = 0;
+const lines = [];
+for (const p of PAIRS) {
+    const fg = resolve(p.fg, p.theme);
+    const bg = resolve(p.bg, p.theme);
+    const ratio = contrast(fg, bg);
+    const ok = ratio >= AA_NORMAL;
+    let status;
+    if (ok)
+        status = 'PASS';
+    else if (p.exempt)
+        status = 'EXEMPT-FAIL';
+    else {
+        status = 'FAIL';
+        bodyFailures += 1;
+    }
+    lines.push(`[${p.theme}] ${status.padEnd(11)} ${ratio.toFixed(2).padStart(5)}:1  ${p.label} ` +
+        `(${fg} on ${bg})`);
+}
+console.log('WCAG AA contrast audit (normal text ≥ 4.5:1)\n');
+console.log(lines.join('\n'));
+console.log(`\n${bodyFailures === 0 ? 'OK' : 'FAILED'}: ${bodyFailures} body-level violation(s).`);
+// keep palette imported for potential future direct-palette audits
+void palette;
+process.exit(bodyFailures === 0 ? 0 : 1);
+//# sourceMappingURL=contrast-check.js.map

package/dist/contrast-check.js.map

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

package/dist/global/color.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Global color palette — raw atomic values, no semantics.
+ * Component code must NEVER reference these directly; consume Alias tokens instead.
+ * See specs/00-foundation/tokens.spec.md.
+ *
+ * Values are the real Semi Design palette (0 lightest → 9 darkest), captured
+ * from the Semi Design reference. The library targets 100% Semi color parity;
+ * note grey-0 is #f9f9f9 (not pure white) per Semi.
+ */
+export declare const palette: {
+    readonly 'grey-0': "#f9f9f9";
+    readonly 'grey-1': "#e6e8ea";
+    readonly 'grey-2': "#c6cacd";
+    readonly 'grey-3': "#a7abb0";
+    readonly 'grey-4': "#888d92";
+    readonly 'grey-5': "#6b7075";
+    readonly 'grey-6': "#555b61";
+    readonly 'grey-7': "#41464c";
+    readonly 'grey-8': "#2e3238";
+    readonly 'grey-9': "#1c1f23";
+    readonly 'blue-0': "#eaf5ff";
+    readonly 'blue-1': "#cbe7fe";
+    readonly 'blue-2': "#98cdfd";
+    readonly 'blue-3': "#65b2fc";
+    readonly 'blue-4': "#3295fb";
+    readonly 'blue-5': "#0064fa";
+    readonly 'blue-6': "#0062d6";
+    readonly 'blue-7': "#004fb3";
+    readonly 'blue-8': "#003d8f";
+    readonly 'blue-9': "#002c6b";
+    readonly 'green-0': "#ecf7ec";
+    readonly 'green-1': "#d0f0d1";
+    readonly 'green-2': "#a4e0a7";
+    readonly 'green-3': "#7dd182";
+    readonly 'green-4': "#5ac262";
+    readonly 'green-5': "#3bb346";
+    readonly 'green-6': "#30953b";
+    readonly 'green-7': "#25772f";
+    readonly 'green-8': "#1b5924";
+    readonly 'green-9': "#113c18";
+    readonly 'red-0': "#fef2ed";
+    readonly 'red-1': "#feddd2";
+    readonly 'red-2': "#fdb7a5";
+    readonly 'red-3': "#fb9078";
+    readonly 'red-4': "#fa664c";
+    readonly 'red-5': "#f93920";
+    readonly 'red-6': "#d52515";
+    readonly 'red-7': "#b2140c";
+    readonly 'red-8': "#8e0805";
+    readonly 'red-9': "#6a0103";
+    readonly 'orange-0': "#fff8ea";
+    readonly 'orange-1': "#feeecc";
+    readonly 'orange-2': "#fed998";
+    readonly 'orange-3': "#fdc165";
+    readonly 'orange-4': "#fda633";
+    readonly 'orange-5': "#fc8800";
+    readonly 'orange-6': "#d26700";
+    readonly 'orange-7': "#a84a00";
+    readonly 'orange-8': "#7e3100";
+    readonly 'orange-9': "#541d00";
+};
+export type GlobalColorKey = keyof typeof palette;
+//# sourceMappingURL=color.d.ts.map

package/dist/global/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/global/color.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDV,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,OAAO,CAAC"}

package/dist/global/color.js

@@ -0,0 +1,67 @@
+/**
+ * Global color palette — raw atomic values, no semantics.
+ * Component code must NEVER reference these directly; consume Alias tokens instead.
+ * See specs/00-foundation/tokens.spec.md.
+ *
+ * Values are the real Semi Design palette (0 lightest → 9 darkest), captured
+ * from the Semi Design reference. The library targets 100% Semi color parity;
+ * note grey-0 is #f9f9f9 (not pure white) per Semi.
+ */
+export const palette = {
+    // Neutral / grey scale (0 lightest → 9 darkest)
+    'grey-0': '#f9f9f9',
+    'grey-1': '#e6e8ea',
+    'grey-2': '#c6cacd',
+    'grey-3': '#a7abb0',
+    'grey-4': '#888d92',
+    'grey-5': '#6b7075',
+    'grey-6': '#555b61',
+    'grey-7': '#41464c',
+    'grey-8': '#2e3238',
+    'grey-9': '#1c1f23',
+    // Brand blue
+    'blue-0': '#eaf5ff',
+    'blue-1': '#cbe7fe',
+    'blue-2': '#98cdfd',
+    'blue-3': '#65b2fc',
+    'blue-4': '#3295fb',
+    'blue-5': '#0064fa',
+    'blue-6': '#0062d6',
+    'blue-7': '#004fb3',
+    'blue-8': '#003d8f',
+    'blue-9': '#002c6b',
+    // Green (success)
+    'green-0': '#ecf7ec',
+    'green-1': '#d0f0d1',
+    'green-2': '#a4e0a7',
+    'green-3': '#7dd182',
+    'green-4': '#5ac262',
+    'green-5': '#3bb346',
+    'green-6': '#30953b',
+    'green-7': '#25772f',
+    'green-8': '#1b5924',
+    'green-9': '#113c18',
+    // Red (danger)
+    'red-0': '#fef2ed',
+    'red-1': '#feddd2',
+    'red-2': '#fdb7a5',
+    'red-3': '#fb9078',
+    'red-4': '#fa664c',
+    'red-5': '#f93920',
+    'red-6': '#d52515',
+    'red-7': '#b2140c',
+    'red-8': '#8e0805',
+    'red-9': '#6a0103',
+    // Orange (warning) — Semi's warning ramp is orange, not yellow
+    'orange-0': '#fff8ea',
+    'orange-1': '#feeecc',
+    'orange-2': '#fed998',
+    'orange-3': '#fdc165',
+    'orange-4': '#fda633',
+    'orange-5': '#fc8800',
+    'orange-6': '#d26700',
+    'orange-7': '#a84a00',
+    'orange-8': '#7e3100',
+    'orange-9': '#541d00',
+};
+//# sourceMappingURL=color.js.map

package/dist/global/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/global/color.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gDAAgD;IAChD,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,aAAa;IACb,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,kBAAkB;IAClB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,eAAe;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,+DAA+D;IAC/D,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;CACb,CAAC"}

package/dist/global/scales.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Global non-color scales — spacing, radius, typography, shadow, motion, z-index.
+ * Atomic values only. Consume via Alias / Component tokens.
+ */
+export declare const spacing: {
+    readonly '1': "4px";
+    readonly '2': "8px";
+    readonly '3': "12px";
+    readonly '4': "16px";
+    readonly '5': "20px";
+    readonly '6': "24px";
+    readonly '8': "32px";
+    readonly '10': "40px";
+    readonly '12': "48px";
+};
+export declare const radius: {
+    readonly '1': "3px";
+    readonly '2': "6px";
+    readonly '3': "12px";
+    readonly full: "9999px";
+};
+export declare const fontSize: {
+    readonly '1': "12px";
+    readonly '2': "14px";
+    readonly '3': "16px";
+    readonly '4': "20px";
+    readonly '5': "24px";
+    readonly '6': "32px";
+};
+export declare const fontWeight: {
+    readonly regular: "400";
+    readonly medium: "500";
+    readonly semibold: "600";
+};
+export declare const lineHeight: {
+    readonly tight: "1.3";
+    readonly normal: "1.5";
+    readonly loose: "1.7";
+};
+export declare const shadow: {
+    readonly '1': "0 1px 2px rgba(0,0,0,.08)";
+    readonly '2': "0 4px 12px rgba(0,0,0,.12)";
+    readonly '3': "0 8px 24px rgba(0,0,0,.16)";
+};
+export declare const motion: {
+    readonly 'duration-fast': "120ms";
+    readonly 'duration-mid': "200ms";
+    readonly 'duration-slow': "320ms";
+    readonly 'ease-standard': "cubic-bezier(.4,0,.2,1)";
+};
+export declare const zIndex: {
+    readonly affix: "10";
+    readonly sticky: "900";
+    readonly dropdown: "1050";
+    readonly modal: "1000";
+    readonly popover: "1030";
+    readonly toast: "1080";
+    readonly tooltip: "1070";
+};
+/** Responsive breakpoints (min-width). Emitted as CSS vars AND used as build-time
+ *  constants for media queries (CSS @media cannot use var()). See Grid/Layout specs. */
+export declare const breakpoint: {
+    readonly sm: "576px";
+    readonly md: "768px";
+    readonly lg: "992px";
+    readonly xl: "1200px";
+    readonly xxl: "1600px";
+};
+//# sourceMappingURL=scales.d.ts.map

package/dist/global/scales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../src/global/scales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC;AAEX,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;;;CAQT,CAAC;AAEX;wFACwF;AACxF,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC"}

package/dist/global/scales.js

@@ -0,0 +1,69 @@
+/**
+ * Global non-color scales — spacing, radius, typography, shadow, motion, z-index.
+ * Atomic values only. Consume via Alias / Component tokens.
+ */
+export const spacing = {
+    '1': '4px',
+    '2': '8px',
+    '3': '12px',
+    '4': '16px',
+    '5': '20px',
+    '6': '24px',
+    '8': '32px',
+    '10': '40px',
+    '12': '48px',
+};
+export const radius = {
+    '1': '3px',
+    '2': '6px',
+    '3': '12px',
+    full: '9999px',
+};
+export const fontSize = {
+    '1': '12px',
+    '2': '14px',
+    '3': '16px',
+    '4': '20px',
+    '5': '24px',
+    '6': '32px',
+};
+export const fontWeight = {
+    regular: '400',
+    medium: '500',
+    semibold: '600',
+};
+export const lineHeight = {
+    tight: '1.3',
+    normal: '1.5',
+    loose: '1.7',
+};
+export const shadow = {
+    '1': '0 1px 2px rgba(0,0,0,.08)',
+    '2': '0 4px 12px rgba(0,0,0,.12)',
+    '3': '0 8px 24px rgba(0,0,0,.16)',
+};
+export const motion = {
+    'duration-fast': '120ms',
+    'duration-mid': '200ms',
+    'duration-slow': '320ms',
+    'ease-standard': 'cubic-bezier(.4,0,.2,1)',
+};
+export const zIndex = {
+    affix: '10',
+    sticky: '900',
+    dropdown: '1050',
+    modal: '1000',
+    popover: '1030',
+    toast: '1080',
+    tooltip: '1070',
+};
+/** Responsive breakpoints (min-width). Emitted as CSS vars AND used as build-time
+ *  constants for media queries (CSS @media cannot use var()). See Grid/Layout specs. */
+export const breakpoint = {
+    sm: '576px',
+    md: '768px',
+    lg: '992px',
+    xl: '1200px',
+    xxl: '1600px',
+};
+//# sourceMappingURL=scales.js.map

package/dist/global/scales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scales.js","sourceRoot":"","sources":["../../src/global/scales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,QAAQ;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,2BAA2B;IAChC,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,4BAA4B;CACzB,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,OAAO;IACvB,eAAe,EAAE,OAAO;IACxB,eAAe,EAAE,yBAAyB;CAClC,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;CACP,CAAC;AAEX;wFACwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,QAAQ;CACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public token API: typed key union + var() resolver.
+ * The actual values live in tokens.css (generated). Consumers reference vars.
+ */
+import { aliasLight } from './alias/index.js';
+import { componentTokens } from './components/index.js';
+export declare const prefix: "--cd-";
+export type AliasTokenKey = keyof typeof aliasLight;
+export type ComponentTokenKey = keyof typeof componentTokens;
+export type TokenKey = AliasTokenKey | ComponentTokenKey;
+/** resolve a semantic/component token name to its CSS var() reference */
+export declare function tk(name: TokenKey): string;
+export { palette } from './global/color.js';
+export { aliasLight, aliasDark } from './alias/index.js';
+export { breakpoint } from './global/scales.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;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,eAAO,MAAM,MAAM,EAAG,OAAgB,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,UAAU,CAAC;AACpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAC7D,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEzD,yEAAyE;AACzE,wBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEzC;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Public token API: typed key union + var() resolver.
+ * The actual values live in tokens.css (generated). Consumers reference vars.
+ */
+import { aliasLight } from './alias/index.js';
+import { componentTokens } from './components/index.js';
+export const prefix = '--cd-';
+/** resolve a semantic/component token name to its CSS var() reference */
+export function tk(name) {
+    return `var(${prefix}${name})`;
+}
+export { palette } from './global/color.js';
+export { aliasLight, aliasDark } from './alias/index.js';
+export { breakpoint } from './global/scales.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;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,MAAM,GAAG,OAAgB,CAAC;AAMvC,yEAAyE;AACzE,MAAM,UAAU,EAAE,CAAC,IAAc;IAC/B,OAAO,OAAO,MAAM,GAAG,IAAI,GAAG,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}