@terrazzo/parser 0.1.3 → 0.2.1

package/dist/lint/plugin-core/rules/consistent-naming.js

@@ -0,0 +1,49 @@
+import { camelCase, kebabCase, pascalCase, snakeCase } from 'scule';
+import { docsLink } from '../lib/docs.js';
+export const CONSISTENT_NAMING = 'core/consistent-naming';
+export const ERROR_WRONG_FORMAT = 'ERROR_WRONG_FORMAT';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_WRONG_FORMAT]: '{{ id }} doesn’t match format {{ format }}',
+        },
+        docs: {
+            description: 'Enforce consistent naming for tokens.',
+            url: docsLink(CONSISTENT_NAMING),
+        },
+    },
+    defaultOptions: { format: 'kebab-case' },
+    create({ tokens, options, report }) {
+        const basicFormatter = {
+            'kebab-case': kebabCase,
+            camelCase,
+            PascalCase: pascalCase,
+            snake_case: snakeCase,
+            SCREAMING_SNAKE_CASE: (name) => snakeCase(name).toLocaleUpperCase(),
+        }[String(options.format)];
+        for (const t of Object.values(tokens)) {
+            if (basicFormatter) {
+                const parts = t.id.split('.');
+                if (!parts.every((part) => basicFormatter(part) === part)) {
+                    report({
+                        messageId: ERROR_WRONG_FORMAT,
+                        data: { id: t.id, format: options.format },
+                        node: t.source.node,
+                    });
+                }
+            }
+            else if (typeof options.format === 'function') {
+                const result = options.format(t.id);
+                if (result) {
+                    report({
+                        messageId: ERROR_WRONG_FORMAT,
+                        data: { id: t.id, format: '(custom)' },
+                        node: t.source.node,
+                    });
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=consistent-naming.js.map

package/dist/lint/plugin-core/rules/consistent-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent-naming.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/consistent-naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAevD,MAAM,IAAI,GAAqE;IAC7E,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,CAAC,kBAAkB,CAAC,EAAE,4CAA4C;SACnE;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,uCAAuC;YACpD,GAAG,EAAE,QAAQ,CAAC,iBAAiB,CAAC;SACjC;KACF;IACD,cAAc,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;IACxC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,SAAS;YACvB,SAAS;YACT,UAAU,EAAE,UAAU;YACtB,UAAU,EAAE,SAAS;YACrB,oBAAoB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE;SAC5E,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAE1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;oBAC1D,MAAM,CAAC;wBACL,SAAS,EAAE,kBAAkB;wBAC7B,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;wBAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpC,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC;wBACL,SAAS,EAAE,kBAAkB;wBAC7B,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;wBACtC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { LintRule } from '../../../types.js';
+export declare const DESCRIPTIONS = "core/descriptions";
+export interface RuleDescriptionsOptions {
+    /** Token IDs to ignore. Supports globs (`*`). */
+    ignore?: string[];
+}
+declare const ERROR_MISSING_DESCRIPTION = "MISSING_DESCRIPTION";
+declare const rule: LintRule<typeof ERROR_MISSING_DESCRIPTION, RuleDescriptionsOptions>;
+export default rule;

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

@@ -0,0 +1,32 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const DESCRIPTIONS = 'core/descriptions';
+const ERROR_MISSING_DESCRIPTION = 'MISSING_DESCRIPTION';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_MISSING_DESCRIPTION]: '{{ id }} missing description',
+        },
+        docs: {
+            description: 'Enforce tokens have descriptions.',
+            url: docsLink(DESCRIPTIONS),
+        },
+    },
+    defaultOptions: {},
+    create({ tokens, options, report }) {
+        for (const t of Object.values(tokens)) {
+            if (options.ignore && isTokenMatch(t.id, options.ignore)) {
+                continue;
+            }
+            if (!t.$description) {
+                report({
+                    messageId: ERROR_MISSING_DESCRIPTION,
+                    data: { id: t.id },
+                    node: t.source.node,
+                });
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=descriptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptions.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAOhD,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAExD,MAAM,IAAI,GAAwE;IAChF,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,CAAC,yBAAyB,CAAC,EAAE,8BAA8B;SAC5D;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,mCAAmC;YAChD,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC;SAC5B;KACF;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,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;YACD,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM,CAAC;oBACL,SAAS,EAAE,yBAAyB;oBACpC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;oBAClB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lint/plugin-core/rules/duplicate-values.d.ts

@@ -0,0 +1,9 @@
+import type { LintRule } from '../../../types.js';
+export declare const DUPLICATE_VALUES = "core/duplicate-values";
+export interface RuleDuplicateValueOptions {
+    /** Token IDs to ignore. Supports globs (`*`). */
+    ignore?: string[];
+}
+declare const ERROR_DUPLICATE_VALUE = "ERROR_DUPLICATE_VALUE";
+declare const rule: LintRule<typeof ERROR_DUPLICATE_VALUE, RuleDuplicateValueOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/duplicate-values.js

@@ -0,0 +1,65 @@
+import { isAlias, isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const DUPLICATE_VALUES = 'core/duplicate-values';
+const ERROR_DUPLICATE_VALUE = 'ERROR_DUPLICATE_VALUE';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_DUPLICATE_VALUE]: '{{ id }} declared a duplicate value',
+        },
+        docs: {
+            description: 'Enforce tokens can’t redeclare the same value (excludes aliases).',
+            url: docsLink(DUPLICATE_VALUES),
+        },
+    },
+    defaultOptions: {},
+    create({ report, tokens, options }) {
+        const values = {};
+        for (const t of Object.values(tokens)) {
+            // skip ignored tokens
+            if (options.ignore && isTokenMatch(t.id, options.ignore)) {
+                continue;
+            }
+            if (!values[t.$type]) {
+                values[t.$type] = new Set();
+            }
+            // primitives: direct comparison is easy
+            if (t.$type === 'boolean' ||
+                t.$type === 'duration' ||
+                t.$type === 'fontWeight' ||
+                t.$type === 'link' ||
+                t.$type === 'number' ||
+                t.$type === 'string') {
+                // skip aliases (note: $value will be resolved)
+                if (isAlias(t.aliasOf)) {
+                    continue;
+                }
+                if (values[t.$type]?.has(t.$value)) {
+                    report({
+                        messageId: ERROR_DUPLICATE_VALUE,
+                        data: { id: t.id },
+                        node: t.source.node,
+                    });
+                }
+                values[t.$type]?.add(t.$value);
+            }
+            else {
+                // everything else: use deepEqual
+                for (const v of values[t.$type].values() ?? []) {
+                    // TODO: don’t JSON.stringify
+                    if (JSON.stringify(t.$value) === JSON.stringify(v)) {
+                        report({
+                            messageId: ERROR_DUPLICATE_VALUE,
+                            data: { id: t.id },
+                            node: t.source.node,
+                        });
+                        break;
+                    }
+                }
+                values[t.$type].add(t.$value);
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=duplicate-values.js.map

package/dist/lint/plugin-core/rules/duplicate-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-values.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/duplicate-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAOxD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,MAAM,IAAI,GAAsE;IAC9E,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,CAAC,qBAAqB,CAAC,EAAE,qCAAqC;SAC/D;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,mEAAmE;YAChF,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC;SAChC;KACF;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAChC,MAAM,MAAM,GAA6B,EAAE,CAAC;QAE5C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,sBAAsB;YACtB,IAAI,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;YAC9B,CAAC;YAED,wCAAwC;YACxC,IACE,CAAC,CAAC,KAAK,KAAK,SAAS;gBACrB,CAAC,CAAC,KAAK,KAAK,UAAU;gBACtB,CAAC,CAAC,KAAK,KAAK,YAAY;gBACxB,CAAC,CAAC,KAAK,KAAK,MAAM;gBAClB,CAAC,CAAC,KAAK,KAAK,QAAQ;gBACpB,CAAC,CAAC,KAAK,KAAK,QAAQ,EACpB,CAAC;gBACD,+CAA+C;gBAC/C,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvB,SAAS;gBACX,CAAC;gBAED,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;oBACnC,MAAM,CAAC;wBACL,SAAS,EAAE,qBAAqB;wBAChC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;wBAClB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,iCAAiC;gBACjC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;oBAChD,6BAA6B;oBAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;wBACnD,MAAM,CAAC;4BACL,SAAS,EAAE,qBAAqB;4BAChC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;4BAClB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;yBACpB,CAAC,CAAC;wBACH,MAAM;oBACR,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,CAAC,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lint/plugin-core/rules/max-gamut.d.ts

@@ -0,0 +1,14 @@
+import type { LintRule } from '../../../types.js';
+export declare const MAX_GAMUT = "core/max-gamut";
+export interface RuleMaxGamutOptions {
+    /** Gamut to constrain color tokens to. */
+    gamut: 'srgb' | 'p3' | 'rec2020';
+    /** (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, RuleMaxGamutOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/max-gamut.js

@@ -0,0 +1,101 @@
+import { isTokenMatch, tokenToCulori } from '@terrazzo/token-tools';
+import { clampChroma } from 'culori';
+import { docsLink } from '../lib/docs.js';
+export const MAX_GAMUT = 'core/max-gamut';
+const TOLERANCE = 0.000001; // threshold above which it counts as an error (take rounding errors into account)
+/** is a Culori-parseable color within the specified gamut? */
+function isWithinGamut(color, gamut) {
+    const parsed = tokenToCulori(color);
+    if (!parsed) {
+        return false;
+    }
+    if (['rgb', 'hsl', 'hsv', 'hwb'].includes(parsed.mode)) {
+        return true;
+    }
+    const clamped = clampChroma(parsed, parsed.mode, gamut === 'srgb' ? 'rgb' : gamut);
+    return isWithinThreshold(parsed, clamped);
+}
+/** is Color A close enough to Color B? */
+function isWithinThreshold(a, b, tolerance = TOLERANCE) {
+    for (const k in a) {
+        if (k === 'mode' || k === 'alpha') {
+            continue;
+        }
+        if (!(k in b)) {
+            throw new Error(`Can’t compare ${a.mode} to ${b.mode}`);
+        }
+        if (Math.abs(a[k] - b[k]) > tolerance) {
+            return false;
+        }
+    }
+    return true;
+}
+const ERROR_COLOR = 'COLOR';
+const ERROR_BORDER = 'BORDER';
+const ERROR_GRADIENT = 'GRADIENT';
+const ERROR_SHADOW = 'SHADOW';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_COLOR]: 'Color {{ id }} is outside {{ gamut }} gamut',
+            [ERROR_BORDER]: 'Border {{ id }} is outside {{ gamut }} gamut',
+            [ERROR_GRADIENT]: 'Gradient {{ id }} is outside {{ gamut }} gamut',
+            [ERROR_SHADOW]: 'Shadow {{ id }} is outside {{ gamut }} gamut',
+        },
+        docs: {
+            description: 'Enforce colors are within the specified gamut.',
+            url: docsLink(MAX_GAMUT),
+        },
+    },
+    defaultOptions: { gamut: 'rec2020' },
+    create({ tokens, options, report }) {
+        if (!options?.gamut) {
+            return;
+        }
+        if (options.gamut !== 'srgb' && options.gamut !== 'p3' && options.gamut !== 'rec2020') {
+            throw new Error(`Unknown gamut "${options.gamut}". Options are "srgb", "p3", or "rec2020"`);
+        }
+        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 (!isWithinGamut(t.$value, options.gamut)) {
+                        report({ messageId: ERROR_COLOR, data: { id: t.id, gamut: options.gamut }, node: t.source.node });
+                    }
+                    break;
+                }
+                case 'border': {
+                    if (!t.partialAliasOf?.color && !isWithinGamut(t.$value.color, options.gamut)) {
+                        report({ messageId: ERROR_BORDER, data: { id: t.id, gamut: options.gamut }, node: t.source.node });
+                    }
+                    break;
+                }
+                case 'gradient': {
+                    for (let stopI = 0; stopI < t.$value.length; stopI++) {
+                        if (!t.partialAliasOf?.[stopI]?.color && !isWithinGamut(t.$value[stopI].color, options.gamut)) {
+                            report({ messageId: ERROR_GRADIENT, data: { id: t.id, gamut: options.gamut }, node: t.source.node });
+                        }
+                    }
+                    break;
+                }
+                case 'shadow': {
+                    for (let shadowI = 0; shadowI < t.$value.length; shadowI++) {
+                        if (!t.partialAliasOf?.[shadowI]?.color && !isWithinGamut(t.$value[shadowI].color, options.gamut)) {
+                            report({ messageId: ERROR_SHADOW, data: { id: t.id, gamut: options.gamut }, node: t.source.node });
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=max-gamut.js.map

package/dist/lint/plugin-core/rules/max-gamut.js.map

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

package/dist/lint/plugin-core/rules/required-children.d.ts

@@ -0,0 +1,18 @@
+import type { LintRule } from '../../../types.js';
+export declare const REQUIRED_CHILDREN = "core/required-children";
+export interface RequiredChildrenMatch {
+    /** Glob of tokens/groups to match */
+    match: string[];
+    /** Required token IDs to match (this only looks at the very last segment of a token ID!) */
+    requiredTokens?: string[];
+    /** Required groups to match (this only looks at the beginning/middle segments of a token ID!) */
+    requiredGroups?: string[];
+}
+export interface RuleRequiredChildrenOptions {
+    matches: RequiredChildrenMatch[];
+}
+export declare const ERROR_EMPTY_MATCH = "EMPTY_MATCH";
+export declare const ERROR_MISSING_REQUIRED_TOKENS = "MISSING_REQUIRED_TOKENS";
+export declare const ERROR_MISSING_REQUIRED_GROUP = "MISSING_REQUIRED_GROUP";
+declare const rule: LintRule<typeof ERROR_EMPTY_MATCH | typeof ERROR_MISSING_REQUIRED_TOKENS | typeof ERROR_MISSING_REQUIRED_GROUP, RuleRequiredChildrenOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/required-children.js

@@ -0,0 +1,78 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const REQUIRED_CHILDREN = 'core/required-children';
+export const ERROR_EMPTY_MATCH = 'EMPTY_MATCH';
+export const ERROR_MISSING_REQUIRED_TOKENS = 'MISSING_REQUIRED_TOKENS';
+export const ERROR_MISSING_REQUIRED_GROUP = 'MISSING_REQUIRED_GROUP';
+const rule = {
+    meta: {
+        messages: {
+            [ERROR_EMPTY_MATCH]: 'No tokens matched {{ matcher }}',
+            [ERROR_MISSING_REQUIRED_TOKENS]: 'Match {{ index }}: some groups missing required token "{{ token }}"',
+            [ERROR_MISSING_REQUIRED_GROUP]: 'Match {{ index }}: some tokens missing required group "{{ group }}"',
+        },
+        docs: {
+            description: 'Enforce token groups have specific children, whether tokens and/or groups.',
+            url: docsLink(REQUIRED_CHILDREN),
+        },
+    },
+    defaultOptions: { matches: [] },
+    create({ tokens, options, report }) {
+        if (!options.matches?.length) {
+            throw new Error('Invalid config. Missing `matches: […]`');
+        }
+        // note: in many other rules, the operation can be completed in one iteration through all tokens
+        // in this rule, however, we have to scan all tokens every time per-match, because they may overlap
+        for (let matchI = 0; matchI < options.matches.length; matchI++) {
+            const { match, requiredTokens, requiredGroups } = options.matches[matchI];
+            // validate
+            if (!match.length) {
+                throw new Error(`Match ${matchI}: must declare \`match: […]\``);
+            }
+            if (!requiredTokens?.length && !requiredGroups?.length) {
+                throw new Error(`Match ${matchI}: must declare either \`requiredTokens: […]\` or \`requiredGroups: […]\``);
+            }
+            const matchGroups = [];
+            const matchTokens = [];
+            let tokensMatched = false;
+            for (const t of Object.values(tokens)) {
+                if (!isTokenMatch(t.id, match)) {
+                    continue;
+                }
+                tokensMatched = true;
+                const groups = t.id.split('.');
+                matchTokens.push(groups.pop());
+                matchGroups.push(...groups);
+            }
+            if (!tokensMatched) {
+                report({
+                    messageId: ERROR_EMPTY_MATCH,
+                    data: { matcher: JSON.stringify(match) },
+                });
+                continue;
+            }
+            if (requiredTokens) {
+                for (const id of requiredTokens) {
+                    if (!matchTokens.includes(id)) {
+                        report({
+                            messageId: ERROR_MISSING_REQUIRED_TOKENS,
+                            data: { index: matchI, token: id },
+                        });
+                    }
+                }
+            }
+            if (requiredGroups) {
+                for (const groupName of requiredGroups) {
+                    if (!matchGroups.includes(groupName)) {
+                        report({
+                            messageId: ERROR_MISSING_REQUIRED_GROUP,
+                            data: { index: matchI, group: groupName },
+                        });
+                    }
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=required-children.js.map

package/dist/lint/plugin-core/rules/required-children.js.map

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

package/dist/lint/plugin-core/rules/required-modes.d.ts

@@ -0,0 +1,13 @@
+import type { LintRule } from '../../../types.js';
+export declare const REQUIRED_MODES = "core/required-modes";
+export type RequiredModesMatch = {
+    /** Glob of tokens/groups to match */
+    match: string[];
+    /** Required modes */
+    modes: string[];
+};
+export interface RuleRequiredModesOptions {
+    matches: RequiredModesMatch[];
+}
+declare const rule: LintRule<never, RuleRequiredModesOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/required-modes.js

@@ -0,0 +1,52 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const REQUIRED_MODES = 'core/required-modes';
+const rule = {
+    meta: {
+        docs: {
+            description: 'Enforce certain tokens have specific modes.',
+            url: docsLink(REQUIRED_MODES),
+        },
+    },
+    defaultOptions: { matches: [] },
+    create({ tokens, options, report }) {
+        if (!options?.matches?.length) {
+            throw new Error('Invalid config. Missing `matches: […]`');
+        }
+        // note: in many other rules, the operation can be completed in one iteration through all tokens
+        // in this rule, however, we have to scan all tokens every time per-match, because they may overlap
+        for (let matchI = 0; matchI < options.matches.length; matchI++) {
+            const { match, modes } = options.matches[matchI];
+            // validate
+            if (!match.length) {
+                throw new Error(`Match ${matchI}: must declare \`match: […]\``);
+            }
+            if (!modes?.length) {
+                throw new Error(`Match ${matchI}: must declare \`modes: […]\``);
+            }
+            let tokensMatched = false;
+            for (const t of Object.values(tokens)) {
+                if (!isTokenMatch(t.id, match)) {
+                    continue;
+                }
+                tokensMatched = true;
+                for (const mode of modes) {
+                    if (!t.mode?.[mode]) {
+                        report({
+                            message: `Token ${t.id}: missing required mode "${mode}"`,
+                            node: t.source.node,
+                        });
+                    }
+                }
+                if (!tokensMatched) {
+                    report({
+                        message: `Match "${matchI}": no tokens matched ${JSON.stringify(match)}`,
+                        node: t.source.node,
+                    });
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=required-modes.js.map

package/dist/lint/plugin-core/rules/required-modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-modes.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/required-modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAapD,MAAM,IAAI,GAA8C;IACtD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,WAAW,EAAE,6CAA6C;YAC1D,GAAG,EAAE,QAAQ,CAAC,cAAc,CAAC;SAC9B;KACF;IACD,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,gGAAgG;QAChG,mGAAmG;QACnG,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;YAC/D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAE,CAAC;YAElD,WAAW;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,+BAA+B,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,+BAA+B,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,aAAa,GAAG,KAAK,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC/B,SAAS;gBACX,CAAC;gBACD,aAAa,GAAG,IAAI,CAAC;gBAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpB,MAAM,CAAC;4BACL,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,4BAA4B,IAAI,GAAG;4BACzD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,MAAM,CAAC;wBACL,OAAO,EAAE,UAAU,MAAM,wBAAwB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;wBACxE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lint/plugin-core/rules/required-typography-properties.d.ts

@@ -0,0 +1,10 @@
+import type { LintRule } from '../../../types.js';
+export declare const REQUIRED_TYPOGRAPHY_PROPERTIES = "core/required-typography-properties";
+export interface RuleRequiredTypographyPropertiesOptions {
+    /** Required typography properties */
+    properties: string[];
+    /** Token globs to ignore */
+    ignore?: string[];
+}
+declare const rule: LintRule<never, RuleRequiredTypographyPropertiesOptions>;
+export default rule;

package/dist/lint/plugin-core/rules/required-typography-properties.js

@@ -0,0 +1,38 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import { docsLink } from '../lib/docs.js';
+export const REQUIRED_TYPOGRAPHY_PROPERTIES = 'core/required-typography-properties';
+const rule = {
+    meta: {
+        docs: {
+            description: 'Enforce typography tokens have required properties.',
+            url: docsLink(REQUIRED_TYPOGRAPHY_PROPERTIES),
+        },
+    },
+    defaultOptions: { properties: [] },
+    create({ tokens, options, report }) {
+        if (!options) {
+            return;
+        }
+        if (!options.properties.length) {
+            throw new Error(`"properties" can’t be empty`);
+        }
+        for (const t of Object.values(tokens)) {
+            if (options.ignore && isTokenMatch(t.id, options.ignore)) {
+                continue;
+            }
+            if (t.$type !== 'typography') {
+                continue;
+            }
+            if (t.aliasOf) {
+                continue;
+            }
+            for (const p of options.properties) {
+                if (!t.partialAliasOf?.[p] && !(p in t.$value)) {
+                    report({ message: `${t.id} missing required typographic property "${p}"`, node: t.source.node });
+                }
+            }
+        }
+    },
+};
+export default rule;
+//# sourceMappingURL=required-typography-properties.js.map

package/dist/lint/plugin-core/rules/required-typography-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-typography-properties.js","sourceRoot":"","sources":["../../../../src/lint/plugin-core/rules/required-typography-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AASpF,MAAM,IAAI,GAA6D;IACrE,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,WAAW,EAAE,qDAAqD;YAClE,GAAG,EAAE,QAAQ,CAAC,8BAA8B,CAAC;SAC9C;KACF;IACD,cAAc,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,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,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/C,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,2CAA2C,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,76 @@
+import type { AnyNode } from '@humanwhocodes/momoa';
+export declare const LOG_ORDER: readonly ["error", "warn", "info", "debug"];
+export type LogSeverity = 'error' | 'warn' | 'info' | 'debug';
+export type LogLevel = LogSeverity | 'silent';
+export type LogGroup = 'parser' | 'plugin';
+export interface LogEntry {
+    /** Error message to be logged */
+    message: string;
+    /** Prefix message with label */
+    label?: string;
+    /** File in disk */
+    filename?: URL;
+    /**
+     * Continue on error?
+     * @default false
+     */
+    continueOnError?: boolean;
+    /** Show a code frame for the erring node */
+    node?: AnyNode;
+    /** Originator of log message */
+    group?: LogGroup;
+    /** To show a code frame, provide the original source code */
+    src?: string;
+}
+export interface DebugEntry {
+    group: LogGroup;
+    /** Error message to be logged */
+    message: string;
+    /** Current subtask or submodule */
+    label?: string;
+    /** Show code below message */
+    codeFrame?: {
+        src: string;
+        line: number;
+        column: number;
+    };
+    /** Display performance timing */
+    timing?: number;
+}
+/**
+ * @param {Entry} entry
+ * @param {Severity} severity
+ * @return {string}
+ */
+export declare function formatMessage(entry: LogEntry, severity: LogSeverity): string;
+export default class Logger {
+    level: LogLevel;
+    debugScope: string;
+    errorCount: number;
+    warnCount: number;
+    infoCount: number;
+    debugCount: number;
+    constructor(options?: {
+        level?: LogLevel;
+        debugScope?: string;
+    });
+    setLevel(level: LogLevel): void;
+    /** Log an error message (always; can’t be silenced) */
+    error(entry: LogEntry): void;
+    /** Log an info message (if logging level permits) */
+    info(entry: LogEntry): void;
+    /** Log a warning message (if logging level permits) */
+    warn(entry: LogEntry): void;
+    /** Log a diagnostics message (if logging level permits) */
+    debug(entry: DebugEntry): void;
+    /** Get stats for current logger instance */
+    stats(): {
+        errorCount: number;
+        warnCount: number;
+        infoCount: number;
+        debugCount: number;
+    };
+}
+export declare class TokensJSONError extends Error {
+    constructor(message: string);
+}