@breadstone-infrastructure/token-linter 0.0.231

package/rules/rule-options.d.ts

@@ -0,0 +1,158 @@
+import type { TokenValueType } from './value-type.rule.js';
+/**
+ * @description Base constraint for rule option objects.
+ * @public
+ */
+export interface IRuleOptionValues {
+    readonly [key: string]: unknown;
+}
+/**
+ * @description Shape returned by every rule-options factory function.
+ * Maps the rule name to its typed options object.
+ * @public
+ */
+export type IRuleOptionsEntry = Readonly<Record<string, Readonly<IRuleOptionValues>>>;
+/**
+ * @description Options for the `empty-json` rule.
+ * @public
+ */
+export interface IEmptyJsonRuleOptions extends IRuleOptionValues {
+    /**
+     * @description When `true`, files that contain only `$includes` (but no token keys) are not flagged.
+     * @default false
+     */
+    readonly allowIncludes?: boolean;
+}
+/**
+ * @description Options for the `forbidden-key` rule.
+ * @public
+ */
+export interface IForbiddenKeyRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Keys that are forbidden in component token files. Overrides the built-in default list.
+     * @default ['transition', 'shadow']
+     */
+    readonly keys?: ReadonlyArray<string>;
+    /**
+     * @description If set, only these themes are checked for forbidden keys.
+     * @default undefined (all themes)
+     */
+    readonly themes?: ReadonlyArray<string>;
+}
+/**
+ * @description Options for the `forbidden-value` rule.
+ * @public
+ */
+export interface IForbiddenValueRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Values that are forbidden in token definitions. Overrides the built-in default list.
+     * @default ['unset', '0px', 'all']
+     */
+    readonly values?: ReadonlyArray<string>;
+}
+/**
+ * @description Options for the `nested-depth` rule.
+ * @public
+ */
+export interface INestedDepthRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Maximum allowed nesting depth for token objects.
+     * @default 2
+     */
+    readonly maxDepth?: number;
+}
+/**
+ * @description Options for the `required-includes` rule.
+ * @public
+ */
+export interface IRequiredIncludesRuleOptions extends IRuleOptionValues {
+    /**
+     * @description List of mixin names that every component must include. Overrides the built-in default list.
+     * @default ['font', 'padding', 'gap', 'transition', 'translate', 'shadow']
+     */
+    readonly includes?: ReadonlyArray<string>;
+}
+/**
+ * @description Options for the `value-type` rule.
+ * @public
+ */
+export interface IValueTypeRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Mapping of token key names to their required value type. Overrides the built-in defaults.
+     * @default { transitionProperty: 'array', tooltipTransitionProperty: 'array' }
+     */
+    readonly types?: Readonly<Record<string, TokenValueType>>;
+}
+/**
+ * @description Creates typed rule options for the `empty-json` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...emptyJsonOptions({ allowIncludes: true }),
+ * }
+ * ```
+ */
+export declare function emptyJsonOptions(options: IEmptyJsonRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Creates typed rule options for the `forbidden-key` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenKeyOptions({ keys: ['transition', 'shadow'], themes: ['joy'] }),
+ * }
+ * ```
+ */
+export declare function forbiddenKeyOptions(options: IForbiddenKeyRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Creates typed rule options for the `forbidden-value` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenValueOptions({ values: ['unset', '0px', 'none'] }),
+ * }
+ * ```
+ */
+export declare function forbiddenValueOptions(options: IForbiddenValueRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Creates typed rule options for the `nested-depth` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...nestedDepthOptions({ maxDepth: 3 }),
+ * }
+ * ```
+ */
+export declare function nestedDepthOptions(options: INestedDepthRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Creates typed rule options for the `required-includes` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...requiredIncludesOptions({ includes: ['font', 'padding', 'gap'] }),
+ * }
+ * ```
+ */
+export declare function requiredIncludesOptions(options: IRequiredIncludesRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Creates typed rule options for the `value-type` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...valueTypeOptions({ types: { transitionProperty: 'array' } }),
+ * }
+ * ```
+ */
+export declare function valueTypeOptions(options: IValueTypeRuleOptions): IRuleOptionsEntry;
+//# sourceMappingURL=rule-options.d.ts.map

package/rules/rule-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-options.d.ts","sourceRoot":"","sources":["../../src/rules/rule-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAMtF;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAE5D;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IAE/D;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IAEjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAE9D;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IAEnE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAE5D;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC7D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAElF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAExF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,0BAA0B,GAAG,iBAAiB,CAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB,CAEtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,GAAG,iBAAiB,CAEhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAElF"}

package/rules/rule-options.js

@@ -0,0 +1,89 @@
+// #region Imports
+// #endregion
+// #region Functions
+/**
+ * @description Creates typed rule options for the `empty-json` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...emptyJsonOptions({ allowIncludes: true }),
+ * }
+ * ```
+ */
+export function emptyJsonOptions(options) {
+    return { 'empty-json': options };
+}
+/**
+ * @description Creates typed rule options for the `forbidden-key` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenKeyOptions({ keys: ['transition', 'shadow'], themes: ['joy'] }),
+ * }
+ * ```
+ */
+export function forbiddenKeyOptions(options) {
+    return { 'forbidden-key': options };
+}
+/**
+ * @description Creates typed rule options for the `forbidden-value` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...forbiddenValueOptions({ values: ['unset', '0px', 'none'] }),
+ * }
+ * ```
+ */
+export function forbiddenValueOptions(options) {
+    return { 'forbidden-value': options };
+}
+/**
+ * @description Creates typed rule options for the `nested-depth` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...nestedDepthOptions({ maxDepth: 3 }),
+ * }
+ * ```
+ */
+export function nestedDepthOptions(options) {
+    return { 'nested-depth': options };
+}
+/**
+ * @description Creates typed rule options for the `required-includes` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...requiredIncludesOptions({ includes: ['font', 'padding', 'gap'] }),
+ * }
+ * ```
+ */
+export function requiredIncludesOptions(options) {
+    return { 'required-includes': options };
+}
+/**
+ * @description Creates typed rule options for the `value-type` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...valueTypeOptions({ types: { transitionProperty: 'array' } }),
+ * }
+ * ```
+ */
+export function valueTypeOptions(options) {
+    return { 'value-type': options };
+}
+// #endregion
+//# sourceMappingURL=rule-options.js.map

package/rules/rule-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-options.js","sourceRoot":"","sources":["../../src/rules/rule-options.ts"],"names":[],"mappings":"AAAA,kBAAkB;AA+GlB,aAAa;AAEb,oBAAoB;AAEpB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA8B;IAC3D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACjE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAmC;IACrE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IAC/D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAqC;IACzE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA8B;IAC3D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,aAAa"}

package/rules/value-consistency.rule.d.ts

@@ -0,0 +1,17 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Detects value pattern inconsistencies across themes, e.g. var() in most themes but hardcoded in one.
+ * @public
+ */
+export declare class ValueConsistencyRule implements IRule {
+    readonly name = "value-consistency";
+    readonly description = "Detects value pattern inconsistencies across themes (e.g., var() in most themes but hardcoded in one).";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+}
+//# sourceMappingURL=value-consistency.rule.d.ts.map

package/rules/value-consistency.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-consistency.rule.d.ts","sourceRoot":"","sources":["../../src/rules/value-consistency.rule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM1D;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,KAAK;IAI9C,SAAgB,IAAI,uBAAuB;IAC3C,SAAgB,WAAW,4GAA4G;IACvI,SAAgB,eAAe,EAAE,YAAY,CAAqB;IAClE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;CA+DjD"}

package/rules/value-consistency.rule.js

@@ -0,0 +1,69 @@
+// #region Imports
+import { RuleSeverity } from '../models/rule-severity.js';
+import { flattenTokenEntries, groupByComponent } from '../utils.js';
+// #endregion
+/**
+ * @description Detects value pattern inconsistencies across themes, e.g. var() in most themes but hardcoded in one.
+ * @public
+ */
+export class ValueConsistencyRule {
+    // #region Fields
+    name = 'value-consistency';
+    description = 'Detects value pattern inconsistencies across themes (e.g., var() in most themes but hardcoded in one).';
+    defaultSeverity = RuleSeverity.Info;
+    fixable = false;
+    interactive = false;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        const grouped = groupByComponent(context.entries);
+        for (const [component, entries] of grouped.entries()) {
+            const allKeys = new Set();
+            const entryFlat = new Map();
+            for (const entry of entries) {
+                const flat = flattenTokenEntries(entry.content);
+                const keyMap = new Map();
+                for (const { key, value } of flat) {
+                    if (typeof value === 'string') {
+                        keyMap.set(key, value);
+                        allKeys.add(key);
+                    }
+                }
+                entryFlat.set(entry.theme, keyMap);
+            }
+            for (const key of allKeys) {
+                const themeValues = new Map();
+                for (const entry of entries) {
+                    const value = entryFlat.get(entry.theme)?.get(key);
+                    if (value !== undefined) {
+                        themeValues.set(entry.theme, value);
+                    }
+                }
+                if (themeValues.size < 2) {
+                    continue;
+                }
+                const varCount = Array.from(themeValues.values()).filter(v => v.startsWith('var(')).length;
+                const literalCount = themeValues.size - varCount;
+                // Flag if most themes use var() but some use hardcoded values
+                if (varCount > 0 && literalCount > 0 && varCount > literalCount) {
+                    for (const [theme, value] of themeValues.entries()) {
+                        if (!value.startsWith('var(')) {
+                            findings.push({
+                                component,
+                                theme,
+                                key,
+                                message: `Key '${key}' uses hardcoded value '${value}' while other themes use var() references.`,
+                                severity: this.defaultSeverity,
+                                filePath: entries.find(e => e.theme === theme)?.filePath,
+                                fixed: false,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+}
+//# sourceMappingURL=value-consistency.rule.js.map

package/rules/value-consistency.rule.js.map

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

package/rules/value-schema.rule.d.ts

@@ -0,0 +1,18 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+/**
+ * @description Validates token values follow expected CSS patterns (var(), calc(), units, colors).
+ * @public
+ */
+export declare class ValueSchemaRule implements IRule {
+    readonly name = "value-schema";
+    readonly description = "Validates token values follow expected CSS patterns (var(), calc(), units, colors).";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = false;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+    private isValidTokenValue;
+}
+//# sourceMappingURL=value-schema.rule.d.ts.map

package/rules/value-schema.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-schema.rule.d.ts","sourceRoot":"","sources":["../../src/rules/value-schema.rule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AA6B1D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,KAAK;IAIzC,SAAgB,IAAI,kBAAkB;IACtC,SAAgB,WAAW,yFAAyF;IACpH,SAAgB,eAAe,EAAE,YAAY,CAAqB;IAClE,SAAgB,OAAO,SAAS;IAChC,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IA4B9C,OAAO,CAAC,iBAAiB;CA2D5B"}

package/rules/value-schema.rule.js

@@ -0,0 +1,108 @@
+// #region Imports
+import { RuleSeverity } from '../models/rule-severity.js';
+import { flattenTokenEntries } from '../utils.js';
+// #endregion
+// #region Constants
+const CSS_VAR_PATTERN = /^var\(--[\w-]+\)$/;
+const CSS_CALC_PATTERN = /^calc\(.+\)$/;
+const CSS_COLOR_HEX_PATTERN = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const CSS_UNIT_PATTERN = /^-?\d+(\.\d+)?(px|em|rem|%|vh|vw|vmin|vmax|ch|ex|cm|mm|in|pt|pc|s|ms|deg|rad|turn|fr)$/;
+const CSS_NUMBER_PATTERN = /^-?\d+(\.\d+)?$/;
+const SAFE_LITERAL_VALUES = [
+    'auto', 'none', 'inherit', 'initial', 'transparent', 'currentColor',
+    'solid', 'dashed', 'dotted', 'normal', 'bold', 'italic',
+    'underline', 'uppercase', 'lowercase', 'capitalize',
+    'nowrap', 'wrap', 'hidden', 'visible', 'scroll',
+    'flex', 'grid', 'block', 'inline', 'inline-block', 'inline-flex',
+    'ease', 'ease-in', 'ease-out', 'ease-in-out', 'linear',
+    'center', 'left', 'right', 'top', 'bottom', 'start', 'end',
+    'stretch', 'baseline', 'space-between', 'space-around', 'space-evenly',
+    'row', 'column', 'row-reverse', 'column-reverse',
+    'absolute', 'relative', 'fixed', 'sticky', 'static',
+    'pointer', 'default', 'not-allowed', 'grab', 'grabbing',
+    'unset', 'revert', 'all',
+];
+// #endregion
+/**
+ * @description Validates token values follow expected CSS patterns (var(), calc(), units, colors).
+ * @public
+ */
+export class ValueSchemaRule {
+    // #region Fields
+    name = 'value-schema';
+    description = 'Validates token values follow expected CSS patterns (var(), calc(), units, colors).';
+    defaultSeverity = RuleSeverity.Info;
+    fixable = false;
+    interactive = false;
+    // #endregion
+    // #region Methods
+    run(context) {
+        const findings = [];
+        for (const entry of context.entries) {
+            const flatEntries = flattenTokenEntries(entry.content);
+            for (const { key, value } of flatEntries) {
+                if (typeof value !== 'string') {
+                    continue;
+                }
+                if (!this.isValidTokenValue(value.trim())) {
+                    findings.push({
+                        component: entry.component,
+                        theme: entry.theme,
+                        key,
+                        message: `Value '${value}' for key '${key}' does not match known CSS patterns.`,
+                        severity: this.defaultSeverity,
+                        filePath: entry.filePath,
+                        fixed: false,
+                    });
+                }
+            }
+        }
+        return { ruleName: this.name, findings, duration: 0 };
+    }
+    isValidTokenValue(value) {
+        if (value === '') {
+            return false;
+        }
+        // Check exact patterns
+        if (CSS_VAR_PATTERN.test(value)) {
+            return true;
+        }
+        if (CSS_CALC_PATTERN.test(value)) {
+            return true;
+        }
+        if (CSS_COLOR_HEX_PATTERN.test(value)) {
+            return true;
+        }
+        if (CSS_UNIT_PATTERN.test(value)) {
+            return true;
+        }
+        if (CSS_NUMBER_PATTERN.test(value)) {
+            return true;
+        }
+        if (SAFE_LITERAL_VALUES.includes(value)) {
+            return true;
+        }
+        // Allow complex var() with fallbacks: var(--x, fallback)
+        if (value.startsWith('var(') && value.endsWith(')')) {
+            return true;
+        }
+        // Allow complex calc() expressions
+        if (value.startsWith('calc(') && value.endsWith(')')) {
+            return true;
+        }
+        // Allow CSS functions like rgb(), rgba(), hsl(), hsla(), url(), gradients
+        if (/^(rgb|rgba|hsl|hsla|url|linear-gradient|radial-gradient|conic-gradient)\(/.test(value)) {
+            return true;
+        }
+        // Allow comma-separated font families
+        if (value.includes(',') && /^[\w\s,"-]+$/.test(value)) {
+            return true;
+        }
+        // Allow quoted strings
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=value-schema.rule.js.map

package/rules/value-schema.rule.js.map

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

package/rules/value-type.rule.d.ts

@@ -0,0 +1,71 @@
+import type { IRule } from '../core/rule.js';
+import type { IRuleContext } from '../models/rule-context.js';
+import type { IRuleFinding } from '../models/rule-finding.js';
+import type { IRuleResult } from '../models/rule-result.js';
+import { RuleSeverity } from '../models/rule-severity.js';
+import type { IRuleOptionValues, IRuleOptionsEntry } from '../models/token-linter-config.js';
+/**
+ * @description Allowed value types for token values.
+ * @public
+ */
+export type TokenValueType = 'string' | 'array' | 'number';
+/**
+ * @description Options for the `value-type` rule.
+ * @public
+ */
+export interface IValueTypeRuleOptions extends IRuleOptionValues {
+    /**
+     * @description Mapping of token key names to their required value type. Overrides the built-in defaults.
+     * @default { transitionProperty: 'array', tooltipTransitionProperty: 'array' }
+     */
+    readonly types?: Readonly<Record<string, TokenValueType>>;
+}
+/**
+ * @description Creates typed rule options for the `value-type` rule.
+ * @public
+ *
+ * @example
+ * ```js
+ * ruleOptions: {
+ *     ...valueTypeRuleOptions({ types: { transitionProperty: 'array' } }),
+ * }
+ * ```
+ */
+export declare function valueTypeRuleOptions(options: IValueTypeRuleOptions): IRuleOptionsEntry;
+/**
+ * @description Enforces that specific token keys have values of a required type (string, array, or number).
+ * When auto-fix is enabled, values are coerced to the expected type where possible
+ * (e.g. a string is wrapped into a single-element array).
+ *
+ * The type constraints default to `{ transitionProperty: 'array', tooltipTransitionProperty: 'array' }`
+ * and can be overridden via `ruleOptions`:
+ *
+ * @example Configuration
+ * ```js
+ * export default defineConfig({
+ *     rules: { 'value-type': 'error' },
+ *     ruleOptions: {
+ *         'value-type': {
+ *             types: {
+ *                 transitionProperty: 'array',
+ *                 tooltipTransitionProperty: 'array',
+ *             },
+ *         },
+ *     },
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare class ValueTypeRule implements IRule {
+    readonly name = "value-type";
+    readonly description = "Enforces that specific token keys have values of a required type (string, array, number).";
+    readonly defaultSeverity: RuleSeverity;
+    readonly fixable = true;
+    readonly interactive = false;
+    run(context: IRuleContext): IRuleResult;
+    fix(context: IRuleContext, findings: ReadonlyArray<IRuleFinding>): IRuleFinding[];
+    private _getValueType;
+    private _coerceValue;
+}
+//# sourceMappingURL=value-type.rule.d.ts.map

package/rules/value-type.rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-type.rule.d.ts","sourceRoot":"","sources":["../../src/rules/value-type.rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAO7F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAoB3D;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAE5D;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC7D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAEtF;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAc,YAAW,KAAK;IAIvC,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,WAAW,+FAA+F;IAC1H,SAAgB,eAAe,EAAE,YAAY,CAAsB;IACnE,SAAgB,OAAO,QAAQ;IAC/B,SAAgB,WAAW,SAAS;IAM7B,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAuCvC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE;IAmDxF,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;CAmCvB"}