@terrazzo/parser 0.1.3 → 0.2.0

package/dist/lib/code-frame.js

@@ -0,0 +1,108 @@
+// This is copied from @babel/code-frame package but without the heavyweight color highlighting
+// (note: Babel loads both chalk AND picocolors, and doesn’t treeshake well)
+// Babel is MIT-licensed and unaffiliated with this project.
+/**
+ * Extract what lines should be marked and highlighted.
+ */
+function getMarkerLines(loc, source, opts = {}) {
+    const startLoc = {
+        // @ts-ignore this is fine
+        column: 0,
+        // @ts-ignore this is fine
+        line: -1,
+        ...loc.start,
+    };
+    const endLoc = {
+        ...startLoc,
+        ...loc.end,
+    };
+    const { linesAbove = 2, linesBelow = 3 } = opts || {};
+    const startLine = startLoc.line;
+    const startColumn = startLoc.column;
+    const endLine = endLoc.line;
+    const endColumn = endLoc.column;
+    let start = Math.max(startLine - (linesAbove + 1), 0);
+    let end = Math.min(source.length, endLine + linesBelow);
+    if (startLine === -1) {
+        start = 0;
+    }
+    if (endLine === -1) {
+        end = source.length;
+    }
+    const lineDiff = endLine - startLine;
+    const markerLines = {};
+    if (lineDiff) {
+        for (let i = 0; i <= lineDiff; i++) {
+            const lineNumber = i + startLine;
+            if (!startColumn) {
+                markerLines[lineNumber] = true;
+            }
+            else if (i === 0) {
+                const sourceLength = source[lineNumber - 1].length;
+                markerLines[lineNumber] = [startColumn, sourceLength - startColumn + 1];
+            }
+            else if (i === lineDiff) {
+                markerLines[lineNumber] = [0, endColumn];
+            }
+            else {
+                const sourceLength = source[lineNumber - i].length;
+                markerLines[lineNumber] = [0, sourceLength];
+            }
+        }
+    }
+    else {
+        if (startColumn === endColumn) {
+            if (startColumn) {
+                markerLines[startLine] = [startColumn, 0];
+            }
+            else {
+                markerLines[startLine] = true;
+            }
+        }
+        else {
+            markerLines[startLine] = [startColumn, endColumn - startColumn];
+        }
+    }
+    return { start, end, markerLines };
+}
+/**
+ * RegExp to test for newlines in terminal.
+ */
+const NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
+export function codeFrameColumns(rawLines, loc, opts = {}) {
+    const lines = rawLines.split(NEWLINE);
+    const { start, end, markerLines } = getMarkerLines(loc, lines, opts);
+    const hasColumns = loc.start && typeof loc.start.column === 'number';
+    const numberMaxWidth = String(end).length;
+    let frame = rawLines
+        .split(NEWLINE, end)
+        .slice(start, end)
+        .map((line, index) => {
+        const number = start + 1 + index;
+        const paddedNumber = ` ${number}`.slice(-numberMaxWidth);
+        const gutter = ` ${paddedNumber} |`;
+        const hasMarker = markerLines[number];
+        const lastMarkerLine = !markerLines[number + 1];
+        if (hasMarker) {
+            let markerLine = '';
+            if (Array.isArray(hasMarker)) {
+                const markerSpacing = line.slice(0, Math.max(hasMarker[0] - 1, 0)).replace(/[^\t]/g, ' ');
+                const numberOfMarkers = hasMarker[1] || 1;
+                markerLine = ['\n ', gutter.replace(/\d/g, ' '), ' ', markerSpacing, '^'.repeat(numberOfMarkers)].join('');
+                if (lastMarkerLine && opts.message) {
+                    markerLine += ` ${opts.message}`;
+                }
+            }
+            return ['>', gutter, line.length > 0 ? ` ${line}` : '', markerLine].join('');
+        }
+        else {
+            return ` ${gutter}${line.length > 0 ? ` ${line}` : ''}`;
+        }
+    })
+        .join('\n');
+    if (opts.message && !hasColumns) {
+        frame = `${' '.repeat(numberMaxWidth + 1)}${opts.message}\n${frame}`;
+    }
+    return frame;
+}
+//# sourceMappingURL=code-frame.js.map

package/dist/lib/code-frame.js.map

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

package/dist/lint/index.d.ts

@@ -0,0 +1,11 @@
+import { type TokenNormalized } from '@terrazzo/token-tools';
+import type { default as Logger } from '../logger.js';
+import type { ConfigInit } from '../types.js';
+export interface LintRunnerOptions {
+    tokens: Record<string, TokenNormalized>;
+    filename?: URL;
+    config: ConfigInit;
+    src: string;
+    logger: Logger;
+}
+export default function lintRunner({ tokens, filename, config, src, logger, }: LintRunnerOptions): Promise<void>;

package/dist/lint/index.js

@@ -0,0 +1,102 @@
+import { pluralize } from '@terrazzo/token-tools';
+import { merge } from 'merge-anything';
+const listFormat = new Intl.ListFormat('en-us');
+export default async function lintRunner({ tokens, filename, config = {}, src, logger, }) {
+    const { plugins = [], lint } = config;
+    const unusedLintRules = Object.keys(lint?.rules ?? {});
+    for (const plugin of plugins) {
+        if (typeof plugin.lint === 'function') {
+            const s = performance.now();
+            logger.debug({ group: 'plugin', label: plugin.name, message: 'Start linting' });
+            const linter = plugin.lint();
+            const errors = [];
+            const warnings = [];
+            await Promise.all(Object.entries(linter).map(async ([id, rule]) => {
+                if (!(id in lint.rules) || lint.rules[id] === null) {
+                    return;
+                }
+                const [severity, options] = lint.rules[id];
+                if (severity === 'off') {
+                    return;
+                }
+                // note: this usually isn’t a Promise, but it _might_ be!
+                await rule.create({
+                    id,
+                    report(descriptor) {
+                        let message = '';
+                        if (!descriptor.message && !descriptor.messageId) {
+                            logger.error({
+                                label: `[plugin] ${plugin.name} › lint › ${id}`,
+                                message: 'Unable to report error: missing message or messageId',
+                            });
+                        }
+                        // handle message or messageId
+                        if (descriptor.message) {
+                            message = descriptor.message;
+                        }
+                        else {
+                            if (!(descriptor.messageId in (rule.meta?.messages ?? {}))) {
+                                logger.error({
+                                    label: `[plugin] ${plugin.name} › lint › ${id}`,
+                                    message: `messageId "${descriptor.messageId}" does not exist`,
+                                });
+                            }
+                            message = rule.meta?.messages?.[descriptor.messageId] ?? '';
+                        }
+                        // replace with descriptor.data (if any)
+                        if (descriptor.data && typeof descriptor.data === 'object') {
+                            for (const [k, v] of Object.entries(descriptor.data)) {
+                                // lazy formatting
+                                const formatted = ['string', 'number', 'boolean'].includes(typeof v) ? String(v) : JSON.stringify(v);
+                                message = message.replace(/{{[^}]+}}/g, (inner) => {
+                                    const key = inner.substring(2, inner.length - 2).trim();
+                                    return key === k ? formatted : inner;
+                                });
+                            }
+                        }
+                        (severity === 'error' ? errors : warnings).push({
+                            label: id,
+                            message,
+                            filename,
+                            node: descriptor.node,
+                            src: descriptor.source?.src,
+                        });
+                    },
+                    tokens,
+                    filename,
+                    src,
+                    options: merge(rule.meta?.defaultOptions ?? [], rule.defaultOptions ?? [], // Note: is this the correct order to merge in?
+                    options),
+                });
+                // tick off used rule
+                const unusedLintRuleI = unusedLintRules.indexOf(id);
+                if (unusedLintRuleI !== -1) {
+                    unusedLintRules.splice(unusedLintRuleI, 1);
+                }
+            }));
+            for (const error of errors) {
+                logger.error({ ...error, continueOnError: true }); // print out all errors before exiting here
+            }
+            for (const warning of warnings) {
+                logger.warn(warning);
+            }
+            logger.debug({ group: 'plugin', label: plugin.name, message: 'Finish linting', timing: performance.now() - s });
+            if (errors.length) {
+                const counts = [pluralize(errors.length, 'error', 'errors')];
+                if (warnings.length) {
+                    counts.push(pluralize(warnings.length, 'warning', 'warnings'));
+                }
+                logger.error({
+                    message: `Lint failed with ${listFormat.format(counts)}`,
+                    label: plugin.name,
+                    continueOnError: false,
+                });
+            }
+        }
+    }
+    // warn user if they have unused lint rules (they might have meant to configure something!)
+    for (const unusedRule of unusedLintRules) {
+        logger.warn({ group: 'parser', label: 'lint', message: `Unknown lint rule "${unusedRule}"` });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lint/index.js.map

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

package/dist/lint/plugin-core/index.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from '../../types.js';
+export * from './rules/a11y-min-contrast.js';
+export * from './rules/a11y-min-font-size.js';
+export * from './rules/colorspace.js';
+export * from './rules/consistent-naming.js';
+export * from './rules/descriptions.js';
+export * from './rules/duplicate-values.js';
+export * from './rules/max-gamut.js';
+export * from './rules/required-children.js';
+export * from './rules/required-modes.js';
+export * from './rules/required-typography-properties.js';
+export default function coreLintPlugin(): Plugin;

package/dist/lint/plugin-core/index.js

@@ -0,0 +1,40 @@
+export * from './rules/a11y-min-contrast.js';
+export * from './rules/a11y-min-font-size.js';
+export * from './rules/colorspace.js';
+export * from './rules/consistent-naming.js';
+export * from './rules/descriptions.js';
+export * from './rules/duplicate-values.js';
+export * from './rules/max-gamut.js';
+export * from './rules/required-children.js';
+export * from './rules/required-modes.js';
+export * from './rules/required-typography-properties.js';
+import a11yMinContrast, { A11Y_MIN_CONTRAST } from './rules/a11y-min-contrast.js';
+import a11yMinFontSize, { A11Y_MIN_FONT_SIZE } from './rules/a11y-min-font-size.js';
+import colorspace, { COLORSPACE } from './rules/colorspace.js';
+import consistentNaming, { CONSISTENT_NAMING } from './rules/consistent-naming.js';
+import descriptions, { DESCRIPTIONS } from './rules/descriptions.js';
+import duplicateValues, { DUPLICATE_VALUES } from './rules/duplicate-values.js';
+import maxGamut, { MAX_GAMUT } from './rules/max-gamut.js';
+import requiredChidlren, { REQUIRED_CHILDREN } from './rules/required-children.js';
+import requiredModes, { REQUIRED_MODES } from './rules/required-modes.js';
+import requiredTypographyProperties, { REQUIRED_TYPOGRAPHY_PROPERTIES, } from './rules/required-typography-properties.js';
+export default function coreLintPlugin() {
+    return {
+        name: '@terrazzo/plugin-lint-core',
+        lint() {
+            return {
+                [COLORSPACE]: colorspace,
+                [CONSISTENT_NAMING]: consistentNaming,
+                [DESCRIPTIONS]: descriptions,
+                [DUPLICATE_VALUES]: duplicateValues,
+                [MAX_GAMUT]: maxGamut,
+                [REQUIRED_CHILDREN]: requiredChidlren,
+                [REQUIRED_MODES]: requiredModes,
+                [REQUIRED_TYPOGRAPHY_PROPERTIES]: requiredTypographyProperties,
+                [A11Y_MIN_CONTRAST]: a11yMinContrast,
+                [A11Y_MIN_FONT_SIZE]: a11yMinFontSize,
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lint/plugin-core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lint/plugin-core/index.ts"],"names":[],"mappings":"AAIA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2CAA2C,CAAC;AAE1D,OAAO,eAAe,EAAE,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,eAAe,EAAE,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,UAAU,EAAE,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,gBAAgB,EAAE,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,eAAe,EAAE,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,gBAAgB,EAAE,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,aAAa,EAAE,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,4BAA4B,EAAE,EACnC,8BAA8B,GAC/B,MAAM,2CAA2C,CAAC;AAEnD,MAAM,CAAC,OAAO,UAAU,cAAc;IACpC,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,IAAI;YACF,OAAO;gBACL,CAAC,UAAU,CAAC,EAAE,UAAU;gBACxB,CAAC,iBAAiB,CAAC,EAAE,gBAAgB;gBACrC,CAAC,YAAY,CAAC,EAAE,YAAY;gBAC5B,CAAC,gBAAgB,CAAC,EAAE,eAAe;gBACnC,CAAC,SAAS,CAAC,EAAE,QAAQ;gBACrB,CAAC,iBAAiB,CAAC,EAAE,gBAAgB;gBACrC,CAAC,cAAc,CAAC,EAAE,aAAa;gBAC/B,CAAC,8BAA8B,CAAC,EAAE,4BAA4B;gBAC9D,CAAC,iBAAiB,CAAC,EAAE,eAAe;gBACpC,CAAC,kBAAkB,CAAC,EAAE,eAAe;aACtC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/plugin-core/lib/docs.d.ts

@@ -0,0 +1 @@
+export declare function docsLink(ruleName: string): string;

package/dist/lint/plugin-core/lib/docs.js

@@ -0,0 +1,4 @@
+export function docsLink(ruleName) {
+    return `https://terrazzo.app/docs/cli/lint#${ruleName.replaceAll('/', '-')}`;
+}
+//# sourceMappingURL=docs.js.map

package/dist/lint/plugin-core/lib/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/lib/docs.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,sCAAsC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/lint/plugin-core/rules/a11y-min-contrast.d.ts

@@ -0,0 +1,39 @@
+import type { LintRule } from '../../../types.js';
+export declare const A11Y_MIN_CONTRAST = "a11y/min-contrast";
+export interface RuleA11yMinContrastOptions {
+    /**
+     * Whether to adhere to AA (minimum) or AAA (enhanced) contrast levels.
+     * @default "AA"
+     */
+    level?: 'AA' | 'AAA';
+    /** Pairs of color tokens (and optionally typography) to test */
+    pairs: ContrastPair[];
+}
+export interface ContrastPair {
+    /** The foreground color token ID */
+    foreground: string;
+    /** The background color token ID */
+    background: string;
+    /**
+     * Is this pair for large text? Large text allows a smaller contrast ratio.
+     *
+     * Note: while WCAG has _suggested_ sizes and weights, those are merely
+     * suggestions. It’s always more reliable to determine what constitutes “large
+     * text” for your designs yourself, based on your typographic stack.
+     * @see https://www.w3.org/WAI/WCAG22/quickref/#contrast-minimum
+     */
+    largeText?: boolean;
+}
+export declare const WCAG2_MIN_CONTRAST: {
+    AA: {
+        default: number;
+        large: number;
+    };
+    AAA: {
+        default: number;
+        large: number;
+    };
+};
+export declare const ERROR_INSUFFICIENT_CONTRAST = "INSUFFICIENT_CONTRAST";
+declare const rule: LintRule<typeof ERROR_INSUFFICIENT_CONTRAST, RuleA11yMinContrastOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/a11y-min-contrast.js

@@ -0,0 +1,58 @@
+import { tokenToCulori } from '@terrazzo/token-tools';
+import { wcagContrast } from 'culori';
+import { docsLink } from '../lib/docs.js';
+export const A11Y_MIN_CONTRAST = 'a11y/min-contrast';
+export const WCAG2_MIN_CONTRAST = {
+    AA: { default: 4.5, large: 3 },
+    AAA: { default: 7, large: 4.5 },
+};
+export const ERROR_INSUFFICIENT_CONTRAST = 'INSUFFICIENT_CONTRAST';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_INSUFFICIENT_CONTRAST]: 'Pair {{ index }} failed; expected {{ expected }}, got {{ actual }} ({{ level }})',
+        },
+        docs: {
+            description: 'Enforce colors meet minimum contrast checks for WCAG 2.',
+            url: docsLink(A11Y_MIN_CONTRAST),
+        },
+    },
+    defaultOptions: { level: 'AA', pairs: [] },
+    create({ tokens, options, report }) {
+        for (let i = 0; i < options.pairs.length; i++) {
+            const { foreground, background, largeText } = options.pairs[i];
+            if (!tokens[foreground]) {
+                throw new Error(`Token ${foreground} does not exist`);
+            }
+            if (tokens[foreground].$type !== 'color') {
+                throw new Error(`Token ${foreground} isn’t a color`);
+            }
+            if (!tokens[background]) {
+                throw new Error(`Token ${background} does not exist`);
+            }
+            if (tokens[background].$type !== 'color') {
+                throw new Error(`Token ${background} isn’t a color`);
+            }
+            // Note: if these culors were unparseable, they would have already thrown an error before the linter
+            const a = tokenToCulori(tokens[foreground].$value);
+            const b = tokenToCulori(tokens[background].$value);
+            // Note: for the purposes of WCAG 2, foreground and background don’t
+            // matter. But in other contrast algorithms, they do.
+            const contrast = wcagContrast(a, b);
+            const min = WCAG2_MIN_CONTRAST[options.level ?? 'AA'][largeText ? 'large' : 'default'];
+            if (contrast < min) {
+                report({
+                    messageId: ERROR_INSUFFICIENT_CONTRAST,
+                    data: {
+                        index: i + 1,
+                        expected: min,
+                        actual: Math.round(contrast * 100) / 100,
+                        level: options.level,
+                    },
+                });
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=a11y-min-contrast.js.map

package/dist/lint/plugin-core/rules/a11y-min-contrast.js.map

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

package/dist/lint/plugin-core/rules/a11y-min-font-size.d.ts

@@ -0,0 +1,13 @@
+import type { LintRule } from '../../../types.js';
+export declare const A11Y_MIN_FONT_SIZE = "a11y/min-font-size";
+export interface RuleA11yMinFontSizeOptions {
+    /** Minimum font size (pixels) */
+    minSizePx?: number;
+    /** Minimum font size (rems) */
+    minSizeRem?: number;
+    /** Token IDs to ignore. Accepts globs. */
+    ignore?: string[];
+}
+export declare const ERROR_TOO_SMALL = "TOO_SMALL";
+declare const rule: LintRule<typeof ERROR_TOO_SMALL, RuleA11yMinFontSizeOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/a11y-min-font-size.js

@@ -0,0 +1,45 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const A11Y_MIN_FONT_SIZE = 'a11y/min-font-size';
+export const ERROR_TOO_SMALL = 'TOO_SMALL';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_TOO_SMALL]: '{{ id }} font size too small. Expected minimum of {{ min }}',
+        },
+        docs: {
+            description: 'Enforce font sizes are no smaller than the given value.',
+            url: docsLink(A11Y_MIN_FONT_SIZE),
+        },
+    },
+    defaultOptions: {},
+    create({ tokens, options, report }) {
+        if (!options.minSizePx && !options.minSizeRem) {
+            throw new Error('Must specify at least one of minSizePx or minSizeRem');
+        }
+        for (const t of Object.values(tokens)) {
+            if (options.ignore && isTokenMatch(t.id, options.ignore)) {
+                continue;
+            }
+            // skip aliases
+            if (t.aliasOf) {
+                continue;
+            }
+            if (t.$type === 'typography' && 'fontSize' in t.$value) {
+                const fontSize = t.$value.fontSize;
+                if ((fontSize.unit === 'px' && options.minSizePx && fontSize.value < options.minSizePx) ||
+                    (fontSize.unit === 'rem' && options.minSizeRem && fontSize.value < options.minSizeRem)) {
+                    report({
+                        messageId: ERROR_TOO_SMALL,
+                        data: {
+                            id: t.id,
+                            min: options.minSizePx ? `${options.minSizePx}px` : `${options.minSizeRem}rem`,
+                        },
+                    });
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=a11y-min-font-size.js.map

package/dist/lint/plugin-core/rules/a11y-min-font-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-min-font-size.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/a11y-min-font-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAWvD,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,MAAM,IAAI,GAAiE;IACzE,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,CAAC,eAAe,CAAC,EAAE,6DAA6D;SACjF;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,yDAAyD;YACtE,GAAG,EAAE,QAAQ,CAAC,kBAAkB,CAAC;SAClC;KACF;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,IAAI,UAAU,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,QAAS,CAAC;gBAEpC,IACE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;oBACnF,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,EACtF,CAAC;oBACD,MAAM,CAAC;wBACL,SAAS,EAAE,eAAe;wBAC1B,IAAI,EAAE;4BACJ,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,KAAK;yBAC/E;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lint/plugin-core/rules/colorspace.d.ts

@@ -0,0 +1,14 @@
+import { type ColorValueNormalized } from '@terrazzo/token-tools';
+import type { LintRule } from '../../../types.js';
+export declare const COLORSPACE = "core/colorspace";
+export interface RuleColorspaceOptions {
+    colorSpace: ColorValueNormalized['colorSpace'];
+    /** (optional) Token IDs to ignore. Supports globs (`*`). */
+    ignore?: string[];
+}
+declare const ERROR_COLOR = "COLOR";
+declare const ERROR_BORDER = "BORDER";
+declare const ERROR_GRADIENT = "GRADIENT";
+declare const ERROR_SHADOW = "SHADOW";
+declare const rule: LintRule<typeof ERROR_COLOR | typeof ERROR_BORDER | typeof ERROR_GRADIENT | typeof ERROR_SHADOW, RuleColorspaceOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/colorspace.js

@@ -0,0 +1,85 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const COLORSPACE = 'core/colorspace';
+const ERROR_COLOR = 'COLOR';
+const ERROR_BORDER = 'BORDER';
+const ERROR_GRADIENT = 'GRADIENT';
+const ERROR_SHADOW = 'SHADOW';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_COLOR]: 'Color {{ id }} not in colorspace {{ colorSpace }}',
+            [ERROR_BORDER]: 'Border {{ id }} not in colorspace {{ colorSpace }}',
+            [ERROR_GRADIENT]: 'Gradient {{ id }} not in colorspace {{ colorSpace }}',
+            [ERROR_SHADOW]: 'Shadow {{ id }} not in colorspace {{ colorSpace }}',
+        },
+        docs: {
+            description: 'Enforce that all colors are in a specific colorspace.',
+            url: docsLink(COLORSPACE),
+        },
+    },
+    defaultOptions: { colorSpace: 'srgb' },
+    create({ tokens, options, report }) {
+        if (!options.colorSpace) {
+            return;
+        }
+        for (const t of Object.values(tokens)) {
+            // skip ignored tokens
+            if (options?.ignore && isTokenMatch(t.id, options.ignore)) {
+                continue;
+            }
+            // skip aliases
+            if (t.aliasOf) {
+                continue;
+            }
+            switch (t.$type) {
+                case 'color': {
+                    if (t.$value.colorSpace !== options.colorSpace) {
+                        report({
+                            messageId: ERROR_COLOR,
+                            data: { id: t.id, colorSpace: options.colorSpace },
+                            node: t.source.node,
+                        });
+                    }
+                    break;
+                }
+                case 'border': {
+                    if (!t.partialAliasOf?.color && t.$value.color.colorSpace !== options.colorSpace) {
+                        report({
+                            messageId: ERROR_BORDER,
+                            data: { id: t.id, colorSpace: options.colorSpace },
+                            node: t.source.node,
+                        });
+                    }
+                    break;
+                }
+                case 'gradient': {
+                    for (let stopI = 0; stopI < t.$value.length; stopI++) {
+                        if (!t.partialAliasOf?.[stopI]?.color && t.$value[stopI].color.colorSpace !== options.colorSpace) {
+                            report({
+                                messageId: ERROR_GRADIENT,
+                                data: { id: t.id, colorSpace: options.colorSpace },
+                                node: t.source.node,
+                            });
+                        }
+                    }
+                    break;
+                }
+                case 'shadow': {
+                    for (let shadowI = 0; shadowI < t.$value.length; shadowI++) {
+                        if (!t.partialAliasOf?.[shadowI]?.color && t.$value[shadowI].color.colorSpace !== options.colorSpace) {
+                            report({
+                                messageId: ERROR_SHADOW,
+                                data: { id: t.id, colorSpace: options.colorSpace },
+                                node: t.source.node,
+                            });
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=colorspace.js.map

package/dist/lint/plugin-core/rules/colorspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorspace.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/colorspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAQ5C,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,cAAc,GAAG,UAAU,CAAC;AAClC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,MAAM,IAAI,GAGN;IACF,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,CAAC,WAAW,CAAC,EAAE,mDAAmD;YAClE,CAAC,YAAY,CAAC,EAAE,oDAAoD;YACpE,CAAC,cAAc,CAAC,EAAE,sDAAsD;YACxE,CAAC,YAAY,CAAC,EAAE,oDAAoD;SACrE;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,uDAAuD;YACpE,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC;SAC1B;KACF;IACD,cAAc,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,sBAAsB;YACtB,IAAI,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;wBAC/C,MAAM,CAAC;4BACL,SAAS,EAAE,WAAW;4BACtB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;4BAClD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;yBACpB,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;wBACjF,MAAM,CAAC;4BACL,SAAS,EAAE,YAAY;4BACvB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;4BAClD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;yBACpB,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;wBACrD,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;4BAClG,MAAM,CAAC;gCACL,SAAS,EAAE,cAAc;gCACzB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;gCAClD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;6BACpB,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;wBAC3D,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAE,CAAC,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;4BACtG,MAAM,CAAC;gCACL,SAAS,EAAE,YAAY;gCACvB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;gCAClD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;6BACpB,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lint/plugin-core/rules/consistent-naming.d.ts

@@ -0,0 +1,11 @@
+import type { LintRule } from '../../../types.js';
+export declare const CONSISTENT_NAMING = "core/consistent-naming";
+export declare const ERROR_WRONG_FORMAT = "ERROR_WRONG_FORMAT";
+export interface RuleConsistentNamingOptions {
+    /** Specify format, or custom naming validator */
+    format: 'kebab-case' | 'camelCase' | 'PascalCase' | 'snake_case' | 'SCREAMING_SNAKE_CASE' | ((tokenID: string) => boolean);
+    /** Token IDs to ignore. Supports globs (`*`). */
+    ignore?: string[];
+}
+declare const rule: LintRule<typeof ERROR_WRONG_FORMAT, RuleConsistentNamingOptions>;
+export default rule;