@baukit/ui-tokens 0.1.0

package/dist/eslint.js

@@ -0,0 +1,233 @@
+import { findRawColor, isCssColorKeyword } from './color-literals.js';
+const DEFAULT_ALLOWED_VALUES = ['transparent', 'currentColor', 'inherit', 'none'];
+/**
+ * Property and attribute names whose values are styling input. Keyword matching
+ * is limited to these so that a route name or a test id is never reported.
+ */
+const STYLE_PROPERTY_NAMES = new Set([
+    'backgroundColor',
+    'background',
+    'borderColor',
+    'borderBottomColor',
+    'borderLeftColor',
+    'borderRightColor',
+    'borderTopColor',
+    'borderStartColor',
+    'borderEndColor',
+    'color',
+    'fill',
+    'stroke',
+    'shadowColor',
+    'textShadowColor',
+    'textDecorationColor',
+    'tintColor',
+    'placeholderTextColor',
+    'selectionColor',
+    'underlayColor',
+    'outlineColor',
+    'caretColor',
+    'colors',
+    'style',
+    'styles',
+    'theme',
+    'palette',
+    'gradient',
+    'boxShadow',
+    'textShadow',
+    'borderTop',
+    'borderBottom',
+    'borderLeft',
+    'borderRight',
+    'border',
+    'outline',
+]);
+/** Tagged-template tags whose contents are CSS. */
+const CSS_TEMPLATE_TAGS = new Set([
+    'css',
+    'styled',
+    'createGlobalStyle',
+    'keyframes',
+    'injectGlobal',
+]);
+function globToRegExp(pattern) {
+    let source = '';
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === '*') {
+            if (pattern[index + 1] === '*') {
+                source += '.*';
+                index += 1;
+            }
+            else {
+                source += '[^/]*';
+            }
+            continue;
+        }
+        if (character === '?') {
+            source += '[^/]';
+            continue;
+        }
+        source += character?.replace(/[.+^${}()|[\]\\]/g, '\\$&') ?? '';
+    }
+    return new RegExp(`(?:^|/)(?:${source})$`);
+}
+function isAllowedFile(filename, patterns) {
+    const normalized = filename.replaceAll('\\', '/');
+    return patterns.some((pattern) => globToRegExp(pattern).test(normalized));
+}
+function propertyKeyName(node) {
+    const parent = node.parent;
+    if (parent === undefined || parent === null)
+        return undefined;
+    if (parent.type === 'Property' && parent.value === node) {
+        const key = parent.key;
+        if (key.type === 'Identifier')
+            return key.name;
+        if (key.type === 'Literal' && typeof key.value === 'string')
+            return key.value;
+    }
+    return undefined;
+}
+/**
+ * Walks up from a literal to decide whether it lands in a styling position: a
+ * style-named property or JSX attribute, a CSS tagged template, or a nested
+ * object or array under one of those.
+ */
+function isStyleContext(node, styleNames) {
+    let current = node;
+    let child;
+    while (current !== undefined && current !== null) {
+        if (current.type === 'TaggedTemplateExpression') {
+            const tag = current.tag;
+            if (tag.type === 'Identifier' && CSS_TEMPLATE_TAGS.has(tag.name))
+                return true;
+            if (tag.type === 'MemberExpression' &&
+                tag.object.type === 'Identifier' &&
+                CSS_TEMPLATE_TAGS.has(tag.object.name)) {
+                return true;
+            }
+        }
+        if (current.type === 'Property' && child !== undefined && current.value === child) {
+            const name = propertyKeyName(child);
+            if (name !== undefined && styleNames.has(name))
+                return true;
+        }
+        const jsxName = jsxAttributeName(current);
+        if (jsxName !== undefined && styleNames.has(jsxName))
+            return true;
+        if (current.type === 'VariableDeclarator') {
+            const id = current.id;
+            if (id.type === 'Identifier' && looksLikeStyleName(id.name))
+                return true;
+        }
+        if (isStyleSheetCall(current))
+            return true;
+        child = current;
+        current = current.parent;
+    }
+    return false;
+}
+function jsxAttributeName(current) {
+    const candidate = current;
+    return candidate.type === 'JSXAttribute' ? candidate.name?.name : undefined;
+}
+function looksLikeStyleName(name) {
+    return /(^|[a-z])(style|styles|theme|palette|colors?)$/i.test(name);
+}
+function isStyleSheetCall(node) {
+    if (node.type !== 'CallExpression')
+        return false;
+    const callee = node.callee;
+    return (callee.type === 'MemberExpression' &&
+        callee.object.type === 'Identifier' &&
+        callee.object.name === 'StyleSheet' &&
+        callee.property.type === 'Identifier' &&
+        callee.property.name === 'create');
+}
+const MESSAGE_IDS = {
+    hex: 'rawHex',
+    function: 'rawFunction',
+    keyword: 'rawKeyword',
+};
+/**
+ * Reports CSS colors written directly in application code. Colors belong in the
+ * token definition, which the `allowedFiles` option exempts.
+ */
+export const noRawColor = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow raw CSS colors outside the design-token definition',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    allowedFiles: { type: 'array', items: { type: 'string' } },
+                    allowedValues: { type: 'array', items: { type: 'string' } },
+                    additionalStyleProperties: { type: 'array', items: { type: 'string' } },
+                    reportKeywords: { type: 'boolean' },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            rawHex: 'Raw hex color "{{value}}". Use a design token instead.',
+            rawFunction: 'Raw {{value}}() color. Use a design token instead.',
+            rawKeyword: 'Raw CSS color keyword "{{value}}". Use a design token instead.',
+        },
+    },
+    create(context) {
+        const options = (context.options[0] ?? {});
+        const allowedFiles = options.allowedFiles ?? [];
+        const allowedValues = new Set([...DEFAULT_ALLOWED_VALUES, ...(options.allowedValues ?? [])].map((value) => value.toLowerCase()));
+        const styleNames = new Set([
+            ...STYLE_PROPERTY_NAMES,
+            ...(options.additionalStyleProperties ?? []),
+        ]);
+        const reportKeywords = options.reportKeywords ?? true;
+        if (isAllowedFile(context.filename, allowedFiles))
+            return {};
+        const check = (node, value) => {
+            if (allowedValues.has(value.trim().toLowerCase()))
+                return;
+            const styled = isStyleContext(node, styleNames);
+            const keywordsHere = reportKeywords && styled;
+            const match = findRawColor(value, keywordsHere);
+            if (match === undefined)
+                return;
+            if (match.kind === 'keyword' && !isCssColorKeyword(value) && !styled)
+                return;
+            context.report({
+                node,
+                messageId: MESSAGE_IDS[match.kind],
+                data: { value: match.text },
+            });
+        };
+        return {
+            Literal(node) {
+                if (typeof node.value === 'string')
+                    check(node, node.value);
+            },
+            TemplateLiteral(node) {
+                const raw = node.quasis.map((quasi) => quasi.value.cooked ?? quasi.value.raw).join(' ');
+                check(node, raw);
+            },
+        };
+    },
+};
+/** Rules exported by this plugin, keyed by rule name. */
+export const rules = { 'no-raw-color': noRawColor };
+const plugin = { rules };
+/**
+ * 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 const configs = {
+    recommended: {
+        plugins: { '@baukit/ui-tokens': plugin },
+        rules: { '@baukit/ui-tokens/no-raw-color': 'error' },
+    },
+};
+export default plugin;
+//# sourceMappingURL=eslint.js.map

package/dist/eslint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.js","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAqB,MAAM,qBAAqB,CAAC;AAkBzF,MAAM,sBAAsB,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAElF;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,OAAO;IACP,MAAM;IACN,QAAQ;IACR,aAAa;IACb,iBAAiB;IACjB,qBAAqB;IACrB,WAAW;IACX,sBAAsB;IACtB,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,SAAS;IACT,UAAU;IACV,WAAW;IACX,YAAY;IACZ,WAAW;IACX,cAAc;IACd,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,KAAK;IACL,QAAQ;IACR,mBAAmB;IACnB,WAAW;IACX,cAAc;CACf,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC/B,MAAM,IAAI,IAAI,CAAC;gBACf,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,OAAO,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,MAAM,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,aAAa,MAAM,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,QAA2B;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5E,CAAC;AAQD,SAAS,eAAe,CAAC,IAAgB;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,KAAK,KAAM,IAAa,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAiB,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC;QAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAChF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAgB,EAAE,UAA+B;IACvE,IAAI,OAAO,GAAkC,IAAI,CAAC;IAClD,IAAI,KAA6B,CAAC;IAElC,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAiB,CAAC;YACtC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9E,IACE,GAAG,CAAC,IAAI,KAAK,kBAAkB;gBAC/B,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;gBAChC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EACtC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAM,KAAc,EAAE,CAAC;YAC5F,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC9D,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAElE,IAAI,OAAO,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,OAAO,CAAC,EAAgB,CAAC;YACpC,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,kBAAkB,CAAC,EAAE,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3E,CAAC;QAED,IAAI,gBAAgB,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,KAAK,GAAG,OAAO,CAAC;QAChB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,SAAS,gBAAgB,CAAC,OAAmB;IAC3C,MAAM,SAAS,GAAG,OAAsC,CAAC;IACzD,OAAO,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAgB;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAoB,CAAC;IACzC,OAAO,CACL,MAAM,CAAC,IAAI,KAAK,kBAAkB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;QACnC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;QACrC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAkE;IACjF,GAAG,EAAE,QAAQ;IACb,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,6DAA6D;SAC3E;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC1D,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC3D,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACvE,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBACpC;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,wDAAwD;YAChE,WAAW,EAAE,oDAAoD;YACjE,UAAU,EAAE,gEAAgE;SAC7E;KACF;IAED,MAAM,CAAC,OAAyB;QAC9B,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAsB,CAAC;QAChE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,CAAC,GAAG,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1E,KAAK,CAAC,WAAW,EAAE,CACpB,CACF,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;YACzB,GAAG,oBAAoB;YACvB,GAAG,CAAC,OAAO,CAAC,yBAAyB,IAAI,EAAE,CAAC;SAC7C,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QAEtD,IAAI,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE7D,MAAM,KAAK,GAAG,CAAC,IAAgB,EAAE,KAAa,EAAQ,EAAE;YACtD,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO;YAE1D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,cAAc,IAAI,MAAM,CAAC;YAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAChD,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO;YAChC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAE7E,OAAO,CAAC,MAAM,CAAC;gBACb,IAAI;gBACJ,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;gBAClC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;aAC5B,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO;YACL,OAAO,CAAC,IAAI;gBACV,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9D,CAAC;YACD,eAAe,CAAC,IAAI;gBAClB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxF,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnB,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AAEpD,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE;QACxC,KAAK,EAAE,EAAE,gCAAgC,EAAE,OAAO,EAAE;KACrD;CACO,CAAC;AAEX,eAAe,MAAM,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,70 @@
+/** A deliberately small fixture that demonstrates the pipeline, not a design system. */
+export declare const exampleTokens: {
+    readonly color: {
+        readonly background: {
+            readonly primary: {
+                readonly light: "#ffffff";
+                readonly dark: "#111111";
+            };
+            readonly accent: {
+                readonly light: "#005fcc";
+                readonly dark: "#66aaff";
+            };
+        };
+        readonly text: {
+            readonly primary: {
+                readonly light: "#111111";
+                readonly dark: "#ffffff";
+            };
+            readonly onAccent: {
+                readonly light: "#ffffff";
+                readonly dark: "#111111";
+            };
+        };
+    };
+    readonly typography: {
+        readonly family: {
+            readonly body: "Inter, sans-serif";
+        };
+        readonly size: {
+            readonly body: "1rem";
+            readonly title: "2rem";
+        };
+        readonly weight: {
+            readonly regular: 400;
+            readonly bold: 700;
+        };
+        readonly lineHeight: {
+            readonly body: 1.5;
+            readonly title: 1.2;
+        };
+    };
+    readonly space: {
+        readonly small: 8;
+        readonly medium: 16;
+    };
+    readonly radius: {
+        readonly small: 4;
+        readonly pill: 999;
+    };
+    readonly motion: {
+        readonly duration: {
+            readonly fast: "120ms";
+            readonly normal: "240ms";
+        };
+        readonly easing: {
+            readonly standard: "cubic-bezier(0.2, 0, 0, 1)";
+        };
+    };
+    readonly elevation: {
+        readonly raised: "0 2px 8px rgb(0 0 0 / 0.2)";
+    };
+    readonly contrastPairs: readonly [{
+        readonly foreground: "color.text.primary";
+        readonly background: "color.background.primary";
+    }, {
+        readonly foreground: "color.text.onAccent";
+        readonly background: "color.background.accent";
+    }];
+};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BO,CAAC"}

package/dist/example.js

@@ -0,0 +1,31 @@
+/** A deliberately small fixture that demonstrates the pipeline, not a design system. */
+export const exampleTokens = {
+    color: {
+        background: {
+            primary: { light: '#ffffff', dark: '#111111' },
+            accent: { light: '#005fcc', dark: '#66aaff' },
+        },
+        text: {
+            primary: { light: '#111111', dark: '#ffffff' },
+            onAccent: { light: '#ffffff', dark: '#111111' },
+        },
+    },
+    typography: {
+        family: { body: 'Inter, sans-serif' },
+        size: { body: '1rem', title: '2rem' },
+        weight: { regular: 400, bold: 700 },
+        lineHeight: { body: 1.5, title: 1.2 },
+    },
+    space: { small: 8, medium: 16 },
+    radius: { small: 4, pill: 999 },
+    motion: {
+        duration: { fast: '120ms', normal: '240ms' },
+        easing: { standard: 'cubic-bezier(0.2, 0, 0, 1)' },
+    },
+    elevation: { raised: '0 2px 8px rgb(0 0 0 / 0.2)' },
+    contrastPairs: [
+        { foreground: 'color.text.primary', background: 'color.background.primary' },
+        { foreground: 'color.text.onAccent', background: 'color.background.accent' },
+    ],
+};
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE;QACL,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SAC9C;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SAChD;KACF;IACD,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;QACrC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;QACrC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;QACnC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE;KACtC;IACD,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAC/B,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;IAC/B,MAAM,EAAE;QACN,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAC5C,MAAM,EAAE,EAAE,QAAQ,EAAE,4BAA4B,EAAE;KACnD;IACD,SAAS,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE;IACnD,aAAa,EAAE;QACb,EAAE,UAAU,EAAE,oBAAoB,EAAE,UAAU,EAAE,0BAA0B,EAAE;QAC5E,EAAE,UAAU,EAAE,qBAAqB,EAAE,UAAU,EAAE,yBAAyB,EAAE;KAC7E;CAC8B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './compiler.js';
+export * from './contrast.js';
+export * from './example.js';
+export * from './layout.js';
+export * from './schema.js';
+export * from './validation.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,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './compiler.js';
+export * from './contrast.js';
+export * from './example.js';
+export * from './layout.js';
+export * from './schema.js';
+export * from './validation.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,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Layout mode arithmetic over a product's own breakpoint numbers. The rules are
+ * shared; the numbers are not, so every function takes them as an argument.
+ */
+export type LayoutMode = 'compact' | 'medium' | 'expanded';
+export interface LayoutBreakpoints {
+    /** Width at or above which the layout is `medium`. */
+    readonly medium: number;
+    /** Width at or above which the layout is `expanded`. */
+    readonly expanded: number;
+}
+export type ScreenMaxWidths = Readonly<Record<string, number>>;
+export interface ScreenMaxWidthOptions<Widths extends ScreenMaxWidths> {
+    readonly maxWidths: Widths;
+    /** Key used when a wide screen is requested below the `expanded` mode. */
+    readonly narrowFallback: keyof Widths;
+    /** Keys that only reach their full width in the `expanded` mode. */
+    readonly expandedOnly: readonly (keyof Widths)[];
+}
+/** Classifies a viewport width. Ties go to the wider mode. */
+export declare function getLayoutMode(width: number, breakpoints: LayoutBreakpoints): LayoutMode;
+/** Resolves a named content width, narrowing expanded-only keys below that mode. */
+export declare function getScreenMaxWidth<Widths extends ScreenMaxWidths>(screen: keyof Widths, layoutMode: LayoutMode, { maxWidths, narrowFallback, expandedOnly }: ScreenMaxWidthOptions<Widths>): number;
+/** Bottom padding that keeps content clear of a mobile tab bar and the safe area. */
+export declare function getTabContentInset(layoutMode: LayoutMode, safeAreaBottom: number, tabBarHeight: number): number;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,eAAe;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,CAAC;CAClD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,UAAU,CAIvF;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,eAAe,EAC9D,MAAM,EAAE,MAAM,MAAM,EACpB,UAAU,EAAE,UAAU,EACtB,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACzE,MAAM,CAOR;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR"}

package/dist/layout.js

@@ -0,0 +1,28 @@
+/**
+ * Layout mode arithmetic over a product's own breakpoint numbers. The rules are
+ * shared; the numbers are not, so every function takes them as an argument.
+ */
+/** Classifies a viewport width. Ties go to the wider mode. */
+export function getLayoutMode(width, breakpoints) {
+    if (width >= breakpoints.expanded)
+        return 'expanded';
+    if (width >= breakpoints.medium)
+        return 'medium';
+    return 'compact';
+}
+/** Resolves a named content width, narrowing expanded-only keys below that mode. */
+export function getScreenMaxWidth(screen, layoutMode, { maxWidths, narrowFallback, expandedOnly }) {
+    const key = layoutMode !== 'expanded' && expandedOnly.includes(screen) ? narrowFallback : screen;
+    const width = maxWidths[key];
+    if (width === undefined) {
+        throw new Error(`unknown screen max width: ${String(key)}`);
+    }
+    return width;
+}
+/** Bottom padding that keeps content clear of a mobile tab bar and the safe area. */
+export function getTabContentInset(layoutMode, safeAreaBottom, tabBarHeight) {
+    if (layoutMode === 'expanded')
+        return 0;
+    return tabBarHeight + Math.max(0, safeAreaBottom);
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,WAA8B;IACzE,IAAI,KAAK,IAAI,WAAW,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACrD,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,UAAsB,EACtB,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAiC;IAE1E,MAAM,GAAG,GAAG,UAAU,KAAK,UAAU,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC;IACjG,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EACtB,cAAsB,EACtB,YAAoB;IAEpB,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC;IACxC,OAAO,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AACpD,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,40 @@
+export interface ThemeColor {
+    /** A three- or six-digit hexadecimal sRGB color. */
+    readonly light: string;
+    /** A three- or six-digit hexadecimal sRGB color. */
+    readonly dark: string;
+}
+export interface ColorTokenGroup {
+    readonly [name: string]: ColorTokenGroup | ThemeColor;
+}
+export type TokenScale<T> = Readonly<Record<string, T>>;
+export type DimensionValue = number | string;
+export interface TypographyTokens {
+    readonly family: TokenScale<string>;
+    readonly size: TokenScale<DimensionValue>;
+    readonly weight: TokenScale<number>;
+    readonly lineHeight: TokenScale<DimensionValue>;
+}
+export interface MotionTokens {
+    readonly duration: TokenScale<DimensionValue>;
+    readonly easing: TokenScale<string>;
+}
+export interface ContrastPair {
+    /** A complete semantic path such as `color.text.primary`. */
+    readonly foreground: string;
+    /** A complete semantic path such as `color.background.primary`. */
+    readonly background: string;
+    /** Large text uses WCAG's 3:1 threshold instead of 4.5:1. */
+    readonly largeText?: boolean;
+}
+/** Cross-platform token source. It intentionally contains no component definitions. */
+export interface DesignTokens {
+    readonly color: ColorTokenGroup;
+    readonly typography: TypographyTokens;
+    readonly space: TokenScale<DimensionValue>;
+    readonly radius: TokenScale<DimensionValue>;
+    readonly motion: MotionTokens;
+    readonly elevation: TokenScale<DimensionValue>;
+    readonly contrastPairs: readonly ContrastPair[];
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;CACvD;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;CACjD"}

package/dist/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,14 @@
+import type { DesignTokens } from './schema.js';
+export interface ValidationIssue {
+    readonly path: string;
+    readonly message: string;
+}
+/** Returns every structural problem with a path rooted at `$`. */
+export declare function validateTokens(input: unknown): ValidationIssue[];
+export declare class TokenValidationError extends Error {
+    readonly issues: readonly ValidationIssue[];
+    constructor(issues: readonly ValidationIssue[]);
+}
+/** Validates unknown input and returns it with the design-token type. */
+export declare function parseTokens(input: unknown): DesignTokens;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA+LD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAoBhE;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;gBAEhC,MAAM,EAAE,SAAS,eAAe,EAAE;CAKtD;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAMxD"}