@baukit/ui-tokens 0.1.0

package/LICENSE

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

@@ -0,0 +1,80 @@
+# `@baukit/ui-tokens`
+
+A dependency-free design-token schema, validator, accessibility checker, and deterministic compiler for web and React Native.
+
+This package shares semantic values such as `color.background.primary`; it is deliberately not a design system or cross-platform component library. DOM/React Native components, interaction behavior, raw brand-palette decisions, and product-specific themes remain outside the package.
+
+## Define and validate tokens
+
+```ts
+import { checkContrast, parseTokens, type DesignTokens } from '@baukit/ui-tokens';
+
+const tokens = parseTokens(untrustedJson);
+const violations = checkContrast(tokens);
+```
+
+Colors are opaque `#RGB` or `#RRGGBB` sRGB values with light and dark variants. Color leaves require at least a semantic group and name. Typography, space, radius, motion, and elevation are named scales. `contrastPairs` declares foreground/background semantic paths; normal text must reach 4.5:1 and entries marked `largeText` must reach 3:1 in both themes. Validation errors include paths such as `$.color.text.primary.light`, while contrast failures include the calculated ratio.
+
+Validation is handwritten rather than Zod-based: the schema is small, this keeps production dependencies at zero, and it enables diagnostics tailored to semantic token paths.
+
+## Compile
+
+```ts
+import { toCssVariables, toReactNative } from '@baukit/ui-tokens';
+
+const css = toCssVariables(tokens);
+const nativeModule = toReactNative(tokens);
+```
+
+`toCssVariables` emits sorted `--bk-*` declarations in `:root`, then dark color overrides under `[data-theme="dark"]`. `toReactNative` emits a sorted nested `tokens` constant with an inferred `Tokens` type. Accessibility declarations are build metadata and are omitted from generated runtime constants. `exampleTokens` is available as a test fixture demonstrating every group; it is intentionally not a Baukit visual language.
+
+## Enforce tokens with `no-raw-color`
+
+The design-token schema is only worth having if colors stay out of components.
+`@baukit/ui-tokens/eslint` ships an ESLint flat-config plugin that reports CSS
+colors written directly in application code.
+
+```js
+import uiTokens from '@baukit/ui-tokens/eslint';
+
+export default [
+  {
+    plugins: { '@baukit/ui-tokens': uiTokens },
+    rules: {
+      '@baukit/ui-tokens/no-raw-color': [
+        'error',
+        { allowedFiles: ['src/theme/tokens.ts', 'src/theme/**'] },
+      ],
+    },
+  },
+];
+```
+
+`configs.recommended` turns the rule on with defaults when a product needs no
+options:
+
+```js
+import { configs } from '@baukit/ui-tokens/eslint';
+
+export default [configs.recommended];
+```
+
+The rule reports `#rgb`, `#rrggbb`, and `#rrggbbaa` hex values plus
+`rgb()`, `rgba()`, `hsl()`, and `hsla()` anywhere they appear, in string and
+template literals alike. CSS color keywords such as `crimson` are reported only
+in a style-like position: a color-named property, a `StyleSheet.create` call, a
+`style`, `color`, or `fill` JSX attribute, a `css` tagged template, or a
+variable whose name ends in `style`, `theme`, `palette`, or `colors`. That
+restriction keeps route names, test ids, and ordinary prose off the report.
+
+Options:
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `allowedFiles` | `[]` | Glob-like paths that may declare raw colors. `*` matches inside a path segment, `**` across segments. Put the token definition here. |
+| `allowedValues` | `transparent`, `currentColor`, `inherit`, `none` | Literals allowed everywhere. Entries add to the defaults. |
+| `additionalStyleProperties` | `[]` | Extra property or attribute names treated as style-like. |
+| `reportKeywords` | `true` | Set to `false` to report only hex and functional notations. |
+
+eslint is an optional peer dependency. Importing `@baukit/ui-tokens` itself
+never loads it.

package/dist/color-literals.d.ts

@@ -0,0 +1,16 @@
+/** Kind of raw color found in a literal, used to pick the report message. */
+export type RawColorKind = 'hex' | 'function' | 'keyword';
+/** A raw color match with the exact text that triggered it. */
+export interface RawColorMatch {
+    readonly kind: RawColorKind;
+    readonly text: string;
+}
+/**
+ * Finds the first raw CSS color in a string. Hex and functional notations are
+ * unambiguous anywhere; keyword matches are only meaningful in a style-like
+ * context, which the caller decides.
+ */
+export declare function findRawColor(value: string, includeKeywords: boolean): RawColorMatch | undefined;
+/** True when the value is a CSS color keyword on its own. */
+export declare function isCssColorKeyword(value: string): boolean;
+//# sourceMappingURL=color-literals.d.ts.map

package/dist/color-literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-literals.d.ts","sourceRoot":"","sources":["../src/color-literals.ts"],"names":[],"mappings":"AA+JA,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAU/F;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/color-literals.js

@@ -0,0 +1,186 @@
+/**
+ * CSS color keywords recognized as raw colors. Keywords that double as ordinary
+ * English words in prop values are handled by requiring a style-like context.
+ */
+const CSS_COLOR_KEYWORDS = new Set([
+    'aliceblue',
+    'antiquewhite',
+    'aqua',
+    'aquamarine',
+    'azure',
+    'beige',
+    'bisque',
+    'black',
+    'blanchedalmond',
+    'blue',
+    'blueviolet',
+    'brown',
+    'burlywood',
+    'cadetblue',
+    'chartreuse',
+    'chocolate',
+    'coral',
+    'cornflowerblue',
+    'cornsilk',
+    'crimson',
+    'cyan',
+    'darkblue',
+    'darkcyan',
+    'darkgoldenrod',
+    'darkgray',
+    'darkgreen',
+    'darkgrey',
+    'darkkhaki',
+    'darkmagenta',
+    'darkolivegreen',
+    'darkorange',
+    'darkorchid',
+    'darkred',
+    'darksalmon',
+    'darkseagreen',
+    'darkslateblue',
+    'darkslategray',
+    'darkslategrey',
+    'darkturquoise',
+    'darkviolet',
+    'deeppink',
+    'deepskyblue',
+    'dimgray',
+    'dimgrey',
+    'dodgerblue',
+    'firebrick',
+    'floralwhite',
+    'forestgreen',
+    'fuchsia',
+    'gainsboro',
+    'ghostwhite',
+    'gold',
+    'goldenrod',
+    'gray',
+    'green',
+    'greenyellow',
+    'grey',
+    'honeydew',
+    'hotpink',
+    'indianred',
+    'indigo',
+    'ivory',
+    'khaki',
+    'lavender',
+    'lavenderblush',
+    'lawngreen',
+    'lemonchiffon',
+    'lightblue',
+    'lightcoral',
+    'lightcyan',
+    'lightgoldenrodyellow',
+    'lightgray',
+    'lightgreen',
+    'lightgrey',
+    'lightpink',
+    'lightsalmon',
+    'lightseagreen',
+    'lightskyblue',
+    'lightslategray',
+    'lightslategrey',
+    'lightsteelblue',
+    'lightyellow',
+    'lime',
+    'limegreen',
+    'linen',
+    'magenta',
+    'maroon',
+    'mediumaquamarine',
+    'mediumblue',
+    'mediumorchid',
+    'mediumpurple',
+    'mediumseagreen',
+    'mediumslateblue',
+    'mediumspringgreen',
+    'mediumturquoise',
+    'mediumvioletred',
+    'midnightblue',
+    'mintcream',
+    'mistyrose',
+    'moccasin',
+    'navajowhite',
+    'navy',
+    'oldlace',
+    'olive',
+    'olivedrab',
+    'orange',
+    'orangered',
+    'orchid',
+    'palegoldenrod',
+    'palegreen',
+    'paleturquoise',
+    'palevioletred',
+    'papayawhip',
+    'peachpuff',
+    'peru',
+    'pink',
+    'plum',
+    'powderblue',
+    'purple',
+    'rebeccapurple',
+    'red',
+    'rosybrown',
+    'royalblue',
+    'saddlebrown',
+    'salmon',
+    'sandybrown',
+    'seagreen',
+    'seashell',
+    'sienna',
+    'silver',
+    'skyblue',
+    'slateblue',
+    'slategray',
+    'slategrey',
+    'snow',
+    'springgreen',
+    'steelblue',
+    'tan',
+    'teal',
+    'thistle',
+    'tomato',
+    'turquoise',
+    'violet',
+    'wheat',
+    'white',
+    'whitesmoke',
+    'yellow',
+    'yellowgreen',
+]);
+const HEX_PATTERN = /#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})\b/i;
+const FUNCTIONAL_PATTERN = /\b(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\s*\(/i;
+const KEYWORD_SPLIT_PATTERN = /[^a-z]+/i;
+function findKeyword(value) {
+    for (const word of value.split(KEYWORD_SPLIT_PATTERN)) {
+        if (word !== '' && CSS_COLOR_KEYWORDS.has(word.toLowerCase()))
+            return word;
+    }
+    return undefined;
+}
+/**
+ * Finds the first raw CSS color in a string. Hex and functional notations are
+ * unambiguous anywhere; keyword matches are only meaningful in a style-like
+ * context, which the caller decides.
+ */
+export function findRawColor(value, includeKeywords) {
+    const hex = HEX_PATTERN.exec(value);
+    if (hex)
+        return { kind: 'hex', text: hex[0] };
+    const functional = FUNCTIONAL_PATTERN.exec(value);
+    if (functional)
+        return { kind: 'function', text: functional[0].replace(/\s*\($/, '') };
+    if (!includeKeywords)
+        return undefined;
+    const keyword = findKeyword(value);
+    return keyword === undefined ? undefined : { kind: 'keyword', text: keyword };
+}
+/** True when the value is a CSS color keyword on its own. */
+export function isCssColorKeyword(value) {
+    return CSS_COLOR_KEYWORDS.has(value.trim().toLowerCase());
+}
+//# sourceMappingURL=color-literals.js.map

package/dist/color-literals.js.map

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

package/dist/compiler.d.ts

@@ -0,0 +1,6 @@
+import type { DesignTokens } from './schema.js';
+/** Compiles a deterministic light root and dark-theme override block. */
+export declare function toCssVariables(tokens: DesignTokens): string;
+/** Compiles deterministic, nested TypeScript constants for React Native. */
+export declare function toReactNative(tokens: DesignTokens): string;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAwD5D,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAqB3D;AAgBD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAW1D"}

package/dist/compiler.js

@@ -0,0 +1,84 @@
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isThemeColor(value) {
+    return isRecord(value) && typeof value['light'] === 'string' && typeof value['dark'] === 'string';
+}
+function flattenColors(value, path, theme, output) {
+    if (isThemeColor(value)) {
+        output.push({ path: path.join('-'), value: value[theme] });
+        return;
+    }
+    if (isRecord(value)) {
+        for (const key of Object.keys(value).sort()) {
+            flattenColors(value[key], [...path, key], theme, output);
+        }
+    }
+}
+function flattenScalars(value, path, output) {
+    if (typeof value === 'string' || typeof value === 'number') {
+        output.push({ path: path.join('-'), value });
+        return;
+    }
+    if (isRecord(value)) {
+        for (const key of Object.keys(value).sort()) {
+            flattenScalars(value[key], [...path, key], output);
+        }
+    }
+}
+function kebabCase(path) {
+    return path.replaceAll(/([a-z\d])([A-Z])/gu, '$1-$2').toLowerCase();
+}
+function declaration(token) {
+    return `  --bk-${kebabCase(token.path)}: ${String(token.value)};`;
+}
+function comparePaths(left, right) {
+    return left.path < right.path ? -1 : left.path > right.path ? 1 : 0;
+}
+/** Compiles a deterministic light root and dark-theme override block. */
+export function toCssVariables(tokens) {
+    const light = [];
+    const dark = [];
+    flattenColors(tokens.color, ['color'], 'light', light);
+    flattenColors(tokens.color, ['color'], 'dark', dark);
+    for (const group of ['typography', 'space', 'radius', 'motion', 'elevation']) {
+        flattenScalars(tokens[group], [group], light);
+    }
+    light.sort(comparePaths);
+    dark.sort(comparePaths);
+    return [
+        ':root {',
+        ...light.map(declaration),
+        '}',
+        '',
+        '[data-theme="dark"] {',
+        ...dark.map(declaration),
+        '}',
+        '',
+    ].join('\n');
+}
+function sortDeep(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => sortDeep(item));
+    }
+    if (isRecord(value)) {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((key) => [key, sortDeep(value[key])]));
+    }
+    return value;
+}
+/** Compiles deterministic, nested TypeScript constants for React Native. */
+export function toReactNative(tokens) {
+    const runtimeTokens = {
+        color: tokens.color,
+        typography: tokens.typography,
+        space: tokens.space,
+        radius: tokens.radius,
+        motion: tokens.motion,
+        elevation: tokens.elevation,
+    };
+    const json = JSON.stringify(sortDeep(runtimeTokens), undefined, 2);
+    return `// Generated by @baukit/ui-tokens. Do not edit.\nexport const tokens = ${json} as const;\n\nexport type Tokens = typeof tokens;\n`;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

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

package/dist/contrast.d.ts

@@ -0,0 +1,16 @@
+import type { DesignTokens } from './schema.js';
+export type ThemeName = 'light' | 'dark';
+export interface ContrastViolation {
+    readonly foreground: string;
+    readonly background: string;
+    readonly theme: ThemeName;
+    readonly ratio: number;
+    readonly requiredRatio: 3 | 4.5;
+}
+/** WCAG 2.x relative luminance for an opaque hexadecimal sRGB color. */
+export declare function relativeLuminance(color: string): number;
+/** WCAG contrast ratio, always between 1 and 21 inclusive. */
+export declare function contrastRatio(foreground: string, background: string): number;
+/** Checks every declared pair in both themes and returns only failures. */
+export declare function checkContrast(tokens: DesignTokens): ContrastViolation[];
+//# 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,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,GAAG,CAAC;CACjC;AAkBD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM5E;AAYD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAoBvE"}

package/dist/contrast.js

@@ -0,0 +1,59 @@
+function expandHex(color) {
+    const match = /^#([\dA-Fa-f]{3}|[\dA-Fa-f]{6})$/u.exec(color);
+    if (match?.[1] === undefined) {
+        throw new TypeError(`Unsupported color ${color}; expected #RGB or #RRGGBB.`);
+    }
+    const digits = match[1];
+    return digits.length === 3
+        ? `${digits.charAt(0)}${digits.charAt(0)}${digits.charAt(1)}${digits.charAt(1)}${digits.charAt(2)}${digits.charAt(2)}`
+        : digits;
+}
+function channel(hex, offset) {
+    const value = Number.parseInt(hex.slice(offset, offset + 2), 16) / 255;
+    return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+}
+/** WCAG 2.x relative luminance for an opaque hexadecimal sRGB color. */
+export function relativeLuminance(color) {
+    const hex = expandHex(color);
+    return 0.2126 * channel(hex, 0) + 0.7152 * channel(hex, 2) + 0.0722 * channel(hex, 4);
+}
+/** WCAG contrast ratio, always between 1 and 21 inclusive. */
+export function contrastRatio(foreground, background) {
+    const foregroundLuminance = relativeLuminance(foreground);
+    const backgroundLuminance = relativeLuminance(background);
+    const lighter = Math.max(foregroundLuminance, backgroundLuminance);
+    const darker = Math.min(foregroundLuminance, backgroundLuminance);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+function colorAt(tokens, path) {
+    const segments = path.split('.');
+    segments.shift();
+    let current = tokens.color;
+    for (const segment of segments) {
+        current = current[segment];
+    }
+    return current;
+}
+/** Checks every declared pair in both themes and returns only failures. */
+export function checkContrast(tokens) {
+    const violations = [];
+    for (const pair of tokens.contrastPairs) {
+        const foreground = colorAt(tokens, pair.foreground);
+        const background = colorAt(tokens, pair.background);
+        const requiredRatio = pair.largeText === true ? 3 : 4.5;
+        for (const theme of ['light', 'dark']) {
+            const ratio = contrastRatio(foreground[theme], background[theme]);
+            if (ratio < requiredRatio) {
+                violations.push({
+                    foreground: pair.foreground,
+                    background: pair.background,
+                    theme,
+                    ratio,
+                    requiredRatio,
+                });
+            }
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=contrast.js.map

package/dist/contrast.js.map

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

package/dist/eslint.d.ts

@@ -0,0 +1,50 @@
+import type { Rule } from 'eslint';
+/** Options accepted by the `no-raw-color` rule. */
+export interface NoRawColorOptions {
+    /**
+     * Glob-like file patterns whose contents may declare raw colors. A token
+     * definition file belongs here. `*` matches within a path segment, `**`
+     * across segments.
+     */
+    readonly allowedFiles?: readonly string[];
+    /** Exact literal values that stay allowed everywhere, such as `transparent`. */
+    readonly allowedValues?: readonly string[];
+    /** Extra property or attribute names treated as style-like. */
+    readonly additionalStyleProperties?: readonly string[];
+    /** Report CSS color keywords such as `red`. Defaults to `true`. */
+    readonly reportKeywords?: boolean;
+}
+/**
+ * Reports CSS colors written directly in application code. Colors belong in the
+ * token definition, which the `allowedFiles` option exempts.
+ */
+export declare const noRawColor: Rule.RuleModule;
+/** Rules exported by this plugin, keyed by rule name. */
+export declare const rules: {
+    'no-raw-color': Rule.RuleModule;
+};
+declare const plugin: {
+    rules: {
+        'no-raw-color': Rule.RuleModule;
+    };
+};
+/**
+ * Ready-made flat config. Spread it into a product's `eslint.config.js` and pass
+ * `allowedFiles` so the token definition may keep its color literals.
+ */
+export declare const configs: {
+    readonly recommended: {
+        readonly plugins: {
+            readonly '@baukit/ui-tokens': {
+                rules: {
+                    'no-raw-color': Rule.RuleModule;
+                };
+            };
+        };
+        readonly rules: {
+            readonly '@baukit/ui-tokens/no-raw-color': "error";
+        };
+    };
+};
+export default plugin;
+//# sourceMappingURL=eslint.d.ts.map

package/dist/eslint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAKnC,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,+DAA+D;IAC/D,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvD,mEAAmE;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AA8KD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,IAAI,CAAC,UAmE7B,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,KAAK;;CAAiC,CAAC;AAEpD,QAAA,MAAM,MAAM;;;;CAAY,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAKV,CAAC;AAEX,eAAe,MAAM,CAAC"}