@dsgraph/rules 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Reznik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @dsgraph/rules
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Rule engine and built-in rules. Parse diagnostics are reported as findings too; every severity is configurable.
+
+| Rule | Default |
+|---|---|
+| `token/deprecated-reference` | warning |
+| `naming/normalized-collision` | warning |
+| `color/hex-mismatch` | warning |
+| `color/out-of-gamut` | info |
+| `palette/non-monotonic`, `palette/duplicate-stops` | warning |
+| `a11y/contrast-matrix` | off — set `text`, `surfaces`, `min`, `acknowledged` |
+| `layer/alias-depth`, `layer/allowed-sources` | off — on in the `two-layer` preset |
+
+Presets (architecture patterns only): `recommended`, `dtcg-strict`, `two-layer`.
+
+```ts
+import { check } from '@dsgraph/rules'
+const findings = await check(graph, { extends: ['recommended'], rules: { 'color/out-of-gamut': 'off' } })
+```

package/dist/check.d.ts

@@ -0,0 +1,18 @@
+import { type CodeIndex, type Config, type DsGraph, type Finding, type Severity } from '@dsgraph/core';
+import type { Rule } from './types.js';
+export declare const RULES: readonly Rule[];
+export interface Setting {
+    severity: Severity | 'off';
+    options: Record<string, unknown>;
+}
+/** Rule defaults → presets from `extends` (in order) → `rules` from the config. */
+export declare function resolveSettings(config: Config, rules?: readonly Rule[]): Map<string, Setting>;
+/**
+ * Runs the rules over a graph. Parse diagnostics of the snapshot are reported as findings too;
+ * their severity can be overridden (or turned off) by code in `rules`.
+ */
+export declare function check(graph: DsGraph, config?: Config, extraRules?: readonly Rule[], opts?: {
+    code?: CodeIndex;
+}): Promise<Finding[]>;
+export declare function countBySeverity(findings: readonly Finding[]): Record<Severity, number>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,MAAM,EAEX,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAA;AAatB,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,YAAY,CAAA;AAEnD,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAehC,CAAA;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAID,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,IAAI,EAAU,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBpG;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,MAAW,EACnB,UAAU,GAAE,SAAS,IAAI,EAAO,EAChC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAO,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,CAiEpB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAItF"}

package/dist/check.js

@@ -0,0 +1,122 @@
+import { canonicalize, sha256Hex, VarMatcher, } from '@dsgraph/core';
+import { PRESETS } from './presets.js';
+import { deprecatedUsage, hardcodedColor, offScale, unknownToken, unusedToken } from './rules/code.js';
+import { aliasDepth, allowedSources } from './rules/layers.js';
+import { contrastMatrix, deprecatedReference, duplicateStops, hexMismatch, nonMonotonicPalette, normalizedCollision, outOfGamut, } from './rules/tokens.js';
+export const RULES = [
+    deprecatedReference,
+    normalizedCollision,
+    hexMismatch,
+    outOfGamut,
+    nonMonotonicPalette,
+    duplicateStops,
+    contrastMatrix,
+    aliasDepth,
+    allowedSources,
+    hardcodedColor,
+    offScale,
+    deprecatedUsage,
+    unknownToken,
+    unusedToken,
+];
+const RANK = { error: 3, warning: 2, info: 1 };
+/** Rule defaults → presets from `extends` (in order) → `rules` from the config. */
+export function resolveSettings(config, rules = RULES) {
+    const settings = new Map();
+    for (const r of rules)
+        settings.set(r.id, { severity: r.defaultSeverity, options: {} });
+    const apply = (entries) => {
+        for (const [id, value] of Object.entries(entries)) {
+            const prev = settings.get(id) ?? { severity: 'warning', options: {} };
+            if (Array.isArray(value))
+                settings.set(id, {
+                    severity: value[0],
+                    options: { ...prev.options, ...value[1] },
+                });
+            else
+                settings.set(id, { ...prev, severity: value });
+        }
+    };
+    for (const name of config.extends ?? ['recommended']) {
+        const preset = PRESETS[name];
+        if (!preset)
+            throw new Error(`Unknown preset "${name}". Available: ${Object.keys(PRESETS).join(', ')}`);
+        apply(preset);
+    }
+    apply(config.rules ?? {});
+    return settings;
+}
+/**
+ * Runs the rules over a graph. Parse diagnostics of the snapshot are reported as findings too;
+ * their severity can be overridden (or turned off) by code in `rules`.
+ */
+export async function check(graph, config = {}, extraRules = [], opts = {}) {
+    const rules = [...RULES, ...extraRules];
+    const settings = resolveSettings(config, rules);
+    const code = opts.code;
+    const vars = code
+        ? new VarMatcher(graph, code.uses.map((u) => u.name), config.code?.prefix)
+        : undefined;
+    const drafts = [];
+    const byOrigin = new Map();
+    for (const t of graph.tokens())
+        byOrigin.set(`${t.origin.file}#${t.origin.pointer}`, t.id);
+    for (const d of graph.snapshot.diagnostics) {
+        const severity = settings.get(d.code)?.severity ?? d.severity;
+        if (severity === 'off')
+            continue;
+        const node = d.loc ? byOrigin.get(`${d.loc.file}#${d.loc.pointer}`) : undefined;
+        const f = { rule: d.code, severity, message: d.message, nodes: node ? [node] : [] };
+        if (d.loc)
+            f.loc = d.loc;
+        drafts.push(f);
+    }
+    for (const rule of rules) {
+        const setting = settings.get(rule.id);
+        if (setting.severity === 'off')
+            continue;
+        const ctx = {
+            graph,
+            options: setting.options,
+            config,
+            ...(code && vars ? { code, vars } : {}),
+            report(r) {
+                const f = {
+                    rule: rule.id,
+                    severity: r.severity && RANK[r.severity] < RANK[setting.severity]
+                        ? r.severity
+                        : setting.severity,
+                    message: r.message,
+                    nodes: r.nodes,
+                };
+                if (r.evidence)
+                    f.evidence = r.evidence;
+                if (r.when)
+                    f.when = r.when;
+                if (r.loc)
+                    f.loc = r.loc;
+                else if (r.token)
+                    f.loc = r.token.origin;
+                drafts.push(f);
+            },
+        };
+        rule.run(ctx);
+    }
+    const findings = [];
+    for (const d of drafts)
+        findings.push({
+            // Findings in code differ by position; findings on tokens keep the ids they had.
+            id: `${d.rule}#${(await sha256Hex(canonicalize(d.loc?.line ? { n: d.nodes, w: d.when, m: d.message, l: d.loc } : { n: d.nodes, w: d.when, m: d.message }))).slice(0, 12)}`,
+            ...d,
+        });
+    return findings.sort((a, b) => RANK[b.severity] - RANK[a.severity] ||
+        a.rule.localeCompare(b.rule) ||
+        a.message.localeCompare(b.message));
+}
+export function countBySeverity(findings) {
+    const out = { error: 0, warning: 0, info: 0 };
+    for (const f of findings)
+        out[f.severity]++;
+    return out;
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,8 @@
+import { type ColorValue } from '@dsgraph/core';
+type Rgba = [number, number, number, number];
+/** sRGB channels (0–1, clamped) and alpha of a canonical color value. */
+export declare function rgba(c: ColorValue): Rgba;
+/** WCAG 2.x contrast ratio of text over a surface; translucent surfaces sit on white. */
+export declare function contrastRatio(text: ColorValue, surface: ColorValue): number;
+export {};
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAY,MAAM,eAAe,CAAA;AAIzD,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5C,yEAAyE;AACzE,wBAAgB,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAIxC;AAYD,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAK3E"}

package/dist/color.js

@@ -0,0 +1,25 @@
+import { toCulori } from '@dsgraph/core';
+import { converter } from 'culori';
+const toRgb = converter('rgb');
+/** sRGB channels (0–1, clamped) and alpha of a canonical color value. */
+export function rgba(c) {
+    const rgb = toRgb(toCulori(c));
+    const clamp = (v) => Math.min(1, Math.max(0, v ?? 0));
+    return [clamp(rgb.r), clamp(rgb.g), clamp(rgb.b), c.alpha];
+}
+/** Composites `top` over an opaque `bottom`. */
+function over(top, bottom) {
+    return [0, 1, 2].map((i) => top[i] * top[3] + bottom[i] * (1 - top[3]));
+}
+function luminance([r, g, b]) {
+    const lin = (v) => (v <= 0.04045 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4);
+    return 0.2126 * lin(r) + 0.7152 * lin(g) + 0.0722 * lin(b);
+}
+/** WCAG 2.x contrast ratio of text over a surface; translucent surfaces sit on white. */
+export function contrastRatio(text, surface) {
+    const bg = over(rgba(surface), [1, 1, 1]);
+    const fg = over(rgba(text), bg);
+    const [l1, l2] = [luminance(fg), luminance(bg)].sort((a, b) => b - a);
+    return (l1 + 0.05) / (l2 + 0.05);
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,QAAQ,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;AAG9B,yEAAyE;AACzE,MAAM,UAAU,IAAI,CAAC,CAAa;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAsD,CAAA;IACnF,MAAM,KAAK,GAAG,CAAC,CAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;AAC5D,CAAC;AAED,gDAAgD;AAChD,SAAS,IAAI,CAAC,GAAS,EAAE,MAAgC;IACvD,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAA6B,CAAA;AACvG,CAAC;AAED,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAA2B;IACpD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;IACpF,OAAO,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,OAAmB;IACjE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAqB,CAAA;IACzF,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { check, countBySeverity, RULES, resolveSettings, type Setting } from './check.js';
+export { contrastRatio, rgba } from './color.js';
+export { PRESETS } from './presets.js';
+export type { Finding, Rule, RuleContext } from './types.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,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AACzF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { check, countBySeverity, RULES, resolveSettings } from './check.js';
+export { contrastRatio, rgba } from './color.js';
+export { PRESETS } from './presets.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,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAA;AACzF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/presets.d.ts

@@ -0,0 +1,4 @@
+import type { RuleSetting } from '@dsgraph/core';
+/** Presets follow architecture patterns only — never specific design systems (neutrality principle). */
+export declare const PRESETS: Record<string, Record<string, RuleSetting>>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,wGAAwG;AACxG,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAwB/D,CAAA"}

package/dist/presets.js

@@ -0,0 +1,27 @@
+/** Presets follow architecture patterns only — never specific design systems (neutrality principle). */
+export const PRESETS = {
+    /** Sensible defaults; equal to the rules' default severities. */
+    recommended: {
+        'token/deprecated-reference': 'warning',
+        'naming/normalized-collision': 'warning',
+        'color/hex-mismatch': 'warning',
+        'color/out-of-gamut': 'info',
+        'palette/non-monotonic': 'warning',
+        'palette/duplicate-stops': 'warning',
+    },
+    /** Only what DTCG 2025.10 requires: legacy syntax and non-standard values become errors. */
+    'dtcg-strict': {
+        'dtcg/legacy-syntax': 'error',
+        'dtcg/invalid-unit': 'error',
+        'dtcg/invalid-font-weight': 'error',
+        'dtcg/unknown-type': 'error',
+        'dtcg/typography-missing-field': 'error',
+        'tokens/non-json': 'error',
+    },
+    /** Two layers: `core` holds raw values and aliases nothing; `semantic` references `core` directly. */
+    'two-layer': {
+        'layer/allowed-sources': ['warning', { allow: { core: [], semantic: ['core', 'semantic'] } }],
+        'layer/alias-depth': ['warning', { layer: 'semantic', max: 0 }],
+    },
+};
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAEA,wGAAwG;AACxG,MAAM,CAAC,MAAM,OAAO,GAAgD;IAClE,iEAAiE;IACjE,WAAW,EAAE;QACX,4BAA4B,EAAE,SAAS;QACvC,6BAA6B,EAAE,SAAS;QACxC,oBAAoB,EAAE,SAAS;QAC/B,oBAAoB,EAAE,MAAM;QAC5B,uBAAuB,EAAE,SAAS;QAClC,yBAAyB,EAAE,SAAS;KACrC;IACD,4FAA4F;IAC5F,aAAa,EAAE;QACb,oBAAoB,EAAE,OAAO;QAC7B,mBAAmB,EAAE,OAAO;QAC5B,0BAA0B,EAAE,OAAO;QACnC,mBAAmB,EAAE,OAAO;QAC5B,+BAA+B,EAAE,OAAO;QACxC,iBAAiB,EAAE,OAAO;KAC3B;IACD,sGAAsG;IACtG,WAAW,EAAE;QACX,uBAAuB,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;QAC7F,mBAAmB,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;KAChE;CACF,CAAA"}

package/dist/rules/code.d.ts

@@ -0,0 +1,9 @@
+import type { Rule, RuleContext } from '../types.js';
+export declare const hardcodedColor: Rule;
+export declare const offScale: Rule;
+export declare const deprecatedUsage: Rule;
+export declare const unknownToken: Rule;
+/** Tokens the code reads, with everything they take their values from. */
+export declare function usedTokens(ctx: Pick<RuleContext, 'graph' | 'code' | 'vars'>): Set<string>;
+export declare const unusedToken: Rule;
+//# sourceMappingURL=code.d.ts.map

package/dist/rules/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/rules/code.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAoDpD,eAAO,MAAM,cAAc,EAAE,IA8B5B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,IAiCtB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,IAoB7B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,IAkB1B,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CASzF;AAED,eAAO,MAAM,WAAW,EAAE,IAazB,CAAA"}

package/dist/rules/code.js

@@ -0,0 +1,188 @@
+import { matchGlob, nearestTokens, normalizeName, } from '@dsgraph/core';
+const asArray = (v) => Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+/** `exceptions: { files: ["src/legacy/**"], values: ["#000", "100%"] }` */
+function excepted(options) {
+    const ex = (options.exceptions ?? {});
+    const files = asArray(ex.files);
+    const values = new Set(asArray(ex.values).map((v) => v.toLowerCase()));
+    return (l) => (files.length > 0 && matchGlob(l.file, files)) ||
+        (l.text !== undefined && values.has(l.text.toLowerCase()));
+}
+const locOf = (l) => ({
+    file: l.file,
+    line: l.line,
+    column: l.column,
+});
+/**
+ * Which scale a property takes values from, by token names. Spacing falls back to every dimension
+ * when names say nothing; radii and font sizes are not compared with spacing.
+ */
+const FAMILIES = [
+    { property: /radius$/i, names: /(^|\.)(radius|radii|rounded|corner|round)(\.|$)/, strict: true },
+    { property: /^font-size$/i, names: /(^|\.)(font|text|type|typography)(\.|$)/, strict: true },
+    {
+        property: /.*/,
+        names: /(^|\.)(space|spacing|spacer|gap|gutter|inset|size|sizing|stack|layout)(\.|$)/,
+        strict: false,
+    },
+];
+function scaleOf(graph, property, cache) {
+    const family = FAMILIES.find((f) => f.property.test(property));
+    let tokens = cache.get(family.names);
+    if (!tokens) {
+        const all = graph.tokens({ type: 'dimension' });
+        const named = all.filter((t) => family.names.test(normalizeName(t.id)));
+        tokens = named.length || family.strict ? named : all;
+        cache.set(family.names, tokens);
+    }
+    return tokens;
+}
+function nearestIn(graph, l, among) {
+    const all = nearestTokens(graph, { type: l.type, value: l.value }, graph.defaultInput(), among ? 10_000 : 1);
+    return among ? all.find((m) => among.has(m.token.id)) : all[0];
+}
+export const hardcodedColor = {
+    id: 'style/hardcoded-color',
+    description: 'A color in a style is written by hand instead of taken from a token.',
+    defaultSeverity: 'warning',
+    run({ graph, code, options, report }) {
+        if (!code || graph.tokens({ type: 'color' }).length === 0)
+            return;
+        const skip = excepted(options);
+        const memo = new Map();
+        for (const l of code.literals) {
+            if (l.type !== 'color' || skip(l))
+                continue;
+            const key = l.text.toLowerCase();
+            if (!memo.has(key))
+                memo.set(key, nearestIn(graph, l));
+            const near = memo.get(key);
+            if (!near)
+                continue;
+            report({
+                message: near.exact
+                    ? `Color "${l.text}" in ${l.property} is written by hand; use "${near.token.id}"`
+                    : `Color "${l.text}" in ${l.property} is not in the palette; closest is "${near.token.id}" (ΔE ${near.distance})`,
+                nodes: [near.token.id],
+                evidence: {
+                    value: l.text,
+                    property: l.property,
+                    selector: l.selector,
+                    token: near.token.id,
+                    deltaE: near.distance,
+                },
+                loc: locOf(l),
+            });
+        }
+    },
+};
+export const offScale = {
+    id: 'style/off-scale',
+    description: 'A spacing, radius or font size in a style is written by hand: on the scale (use the token) or off it.',
+    defaultSeverity: 'warning',
+    run({ graph, code, options, report }) {
+        if (!code || graph.tokens({ type: 'dimension' }).length === 0)
+            return;
+        const skip = excepted(options);
+        const scales = new Map();
+        for (const l of code.literals) {
+            if (l.type !== 'dimension' || skip(l))
+                continue;
+            const scale = scaleOf(graph, l.property, scales);
+            const near = nearestIn(graph, l, new Set(scale.map((t) => t.id)));
+            if (!near)
+                continue;
+            const px = near.value;
+            report({
+                message: near.exact
+                    ? `"${l.text}" in ${l.property} is on the scale; use "${near.token.id}"`
+                    : `"${l.text}" in ${l.property} is off the scale; closest is "${near.token.id}" (${px.value}${px.unit})`,
+                nodes: [near.token.id],
+                evidence: {
+                    value: l.text,
+                    property: l.property,
+                    selector: l.selector,
+                    token: near.token.id,
+                    distance: near.distance,
+                },
+                loc: locOf(l),
+                // A value that has a token is a quick fix; one that has none is a design question.
+                ...(near.exact ? { severity: 'info' } : {}),
+            });
+        }
+    },
+};
+export const deprecatedUsage = {
+    id: 'usage/deprecated',
+    description: 'The code uses a deprecated token.',
+    defaultSeverity: 'warning',
+    run({ code, vars, options, report }) {
+        if (!code || !vars)
+            return;
+        const skip = excepted(options);
+        for (const u of code.uses) {
+            if (skip(u))
+                continue;
+            const t = vars.token(u.name);
+            if (!t?.deprecated)
+                continue;
+            const replacement = t.deprecated.replacement;
+            report({
+                message: `"${u.name}" is deprecated${replacement ? `; use "${replacement}"` : ''}`,
+                nodes: [t.id],
+                evidence: { reason: t.deprecated.reason, replacement, property: u.property },
+                loc: locOf(u),
+            });
+        }
+    },
+};
+export const unknownToken = {
+    id: 'usage/unknown-token',
+    description: "The code uses a design-system variable that is not in the tokens (removed, renamed or misspelled). Needs the system's prefix, configured or learned.",
+    defaultSeverity: 'error',
+    run({ code, vars, options, report }) {
+        if (!code || !vars)
+            return;
+        const skip = excepted(options);
+        for (const u of code.uses) {
+            if (skip(u) || !vars.isSystemName(u.name) || vars.token(u.name))
+                continue;
+            report({
+                message: `"${u.name}" is not a token${u.fallback ? `; the fallback "${u.fallback}" is used instead` : ''}`,
+                nodes: [],
+                evidence: { property: u.property, fallback: u.fallback },
+                loc: locOf(u),
+            });
+        }
+    },
+};
+/** Tokens the code reads, with everything they take their values from. */
+export function usedTokens(ctx) {
+    const used = new Set();
+    for (const u of ctx.code?.uses ?? []) {
+        const t = ctx.vars?.token(u.name);
+        if (!t || used.has(t.id))
+            continue;
+        used.add(t.id);
+        for (const d of ctx.graph.dependencies(t.id, { transitive: true }))
+            used.add(d);
+    }
+    return used;
+}
+export const unusedToken = {
+    id: 'token/unused',
+    description: 'A token is not used by the code, directly or through another token.',
+    defaultSeverity: 'info',
+    run(ctx) {
+        const { graph, code, report } = ctx;
+        if (!code || code.uses.length === 0)
+            return;
+        const used = usedTokens(ctx);
+        for (const t of graph.tokens()) {
+            if (used.has(t.id) || t.deprecated)
+                continue;
+            report({ message: `"${t.id}" is not used in the code`, nodes: [t.id], token: t });
+        }
+    },
+};
+//# sourceMappingURL=code.js.map

package/dist/rules/code.js.map

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

package/dist/rules/layers.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from '../types.js';
+export declare const aliasDepth: Rule;
+export declare const allowedSources: Rule;
+//# sourceMappingURL=layers.d.ts.map

package/dist/rules/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/rules/layers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAWvC,eAAO,MAAM,UAAU,EAAE,IAkCxB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,IAqB5B,CAAA"}

package/dist/rules/layers.js

@@ -0,0 +1,70 @@
+import { matchPath } from '@dsgraph/core';
+/** Whole-value alias targets of a token across all its contexts. */
+function wholeTargets(graph, id) {
+    const t = graph.token(id);
+    if (!t)
+        return [];
+    return [
+        ...new Set(t.values.flatMap((v) => v.refs.filter((r) => !r.property && !r.targetPath).map((r) => r.to))),
+    ];
+}
+export const aliasDepth = {
+    id: 'layer/alias-depth',
+    description: 'Tokens of a layer reference tokens of the same layer deeper than allowed.',
+    defaultSeverity: 'off',
+    run({ graph, options, report }) {
+        const layer = typeof options.layer === 'string' ? options.layer : 'semantic';
+        const max = typeof options.max === 'number' ? options.max : 0;
+        const allow = (Array.isArray(options.allow) ? options.allow : [])
+            .filter((a) => typeof a === 'string')
+            .map((a) => a.split('->').map((s) => s.trim()));
+        const allowed = (from, to) => allow.some(([f, t]) => matchPath(from, f) && matchPath(to, t));
+        const memo = new Map();
+        const depth = (id, seen) => {
+            if (memo.has(id))
+                return memo.get(id);
+            let d = 0;
+            for (const to of wholeTargets(graph, id)) {
+                if (graph.token(to)?.layer !== layer || seen.has(to) || allowed(id, to))
+                    continue;
+                d = Math.max(d, 1 + depth(to, new Set([...seen, to])));
+            }
+            memo.set(id, d);
+            return d;
+        };
+        for (const t of graph.tokens({ layer })) {
+            const d = depth(t.id, new Set([t.id]));
+            if (d > max)
+                report({
+                    message: `"${t.id}" goes through ${d} ${layer} alias${d > 1 ? 'es' : ''} (max ${max})`,
+                    nodes: [t.id, ...wholeTargets(graph, t.id)],
+                    evidence: { depth: d, max, chain: graph.chain(t.id) },
+                    token: t,
+                });
+        }
+    },
+};
+export const allowedSources = {
+    id: 'layer/allowed-sources',
+    description: 'Tokens of a layer reference only the layers allowed for it.',
+    defaultSeverity: 'off',
+    run({ graph, options, report }) {
+        const allow = (options.allow ?? {});
+        for (const [, from, to] of graph.edges('aliases')) {
+            const source = graph.token(from);
+            const target = graph.token(to);
+            const fromLayer = source?.layer;
+            if (!source || !target || !fromLayer || !(fromLayer in allow))
+                continue;
+            const permitted = Array.isArray(allow[fromLayer]) ? allow[fromLayer] : [];
+            if (!permitted.includes(target.layer ?? ''))
+                report({
+                    message: `"${from}" (${fromLayer}) references "${to}" (${target.layer ?? 'no layer'}); ${fromLayer} may reference ${permitted.length ? permitted.join(', ') : 'nothing'}`,
+                    nodes: [from, to],
+                    evidence: { fromLayer, toLayer: target.layer, allowed: permitted },
+                    token: source,
+                });
+        }
+    },
+};
+//# sourceMappingURL=layers.js.map

package/dist/rules/layers.js.map

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

package/dist/rules/tokens.d.ts

@@ -0,0 +1,9 @@
+import type { Rule } from '../types.js';
+export declare const deprecatedReference: Rule;
+export declare const normalizedCollision: Rule;
+export declare const hexMismatch: Rule;
+export declare const outOfGamut: Rule;
+export declare const nonMonotonicPalette: Rule;
+export declare const duplicateStops: Rule;
+export declare const contrastMatrix: Rule;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/rules/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/rules/tokens.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAKvC,eAAO,MAAM,mBAAmB,EAAE,IAkBjC,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,IAkBjC,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,IA2BzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,IAkBxB,CAAA;AAiBD,eAAO,MAAM,mBAAmB,EAAE,IA2BjC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,IAiB5B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,IA2C5B,CAAA"}

package/dist/rules/tokens.js

@@ -0,0 +1,195 @@
+import { colorToHex, compareValues, isInSrgbGamut, matchPath, normalizeName, toOklab, } from '@dsgraph/core';
+import { contrastRatio } from '../color.js';
+const asArray = (v) => Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+export const deprecatedReference = {
+    id: 'token/deprecated-reference',
+    description: 'A token references a deprecated token.',
+    defaultSeverity: 'warning',
+    run({ graph, report }) {
+        for (const [, from, to] of graph.edges('aliases')) {
+            const source = graph.token(from);
+            const target = graph.token(to);
+            if (!source || !target?.deprecated || source.deprecated)
+                continue;
+            const replacement = target.deprecated.replacement;
+            report({
+                message: `"${from}" references deprecated "${to}"${replacement ? `; use "${replacement}"` : ''}`,
+                nodes: [from, to],
+                evidence: { reason: target.deprecated.reason, replacement },
+                token: source,
+            });
+        }
+    },
+};
+export const normalizedCollision = {
+    id: 'naming/normalized-collision',
+    description: 'Different tokens map to the same name in code (CSS, Figma) after normalization.',
+    defaultSeverity: 'warning',
+    run({ graph, report }) {
+        const byName = new Map();
+        for (const t of graph.tokens()) {
+            const n = normalizeName(t.id);
+            byName.set(n, [...(byName.get(n) ?? []), t.id]);
+        }
+        for (const [name, ids] of byName)
+            if (ids.length > 1)
+                report({
+                    message: `${ids.map((i) => `"${i}"`).join(', ')} all normalize to "${name}"`,
+                    nodes: ids,
+                    evidence: { name },
+                });
+    },
+};
+export const hexMismatch = {
+    id: 'color/hex-mismatch',
+    description: 'The hex fallback of a color does not match its components.',
+    defaultSeverity: 'warning',
+    run({ graph, report }) {
+        for (const t of graph.tokens({ type: 'color' })) {
+            for (const v of t.values) {
+                const c = v.value;
+                if (!c?.hex)
+                    continue;
+                const actual = colorToHex(c);
+                const diff = [1, 3, 5].some((i) => Math.abs(Number.parseInt(actual.slice(i, i + 2), 16) - Number.parseInt(c.hex.slice(i, i + 2), 16)) > 1);
+                if (diff)
+                    report({
+                        message: `"${t.id}": hex ${c.hex} does not match the color (${actual})`,
+                        nodes: [t.id],
+                        evidence: { hex: c.hex, computed: actual },
+                        when: v.when,
+                        token: t,
+                    });
+            }
+        }
+    },
+};
+export const outOfGamut = {
+    id: 'color/out-of-gamut',
+    description: 'A wide-gamut color is outside sRGB and has no hex fallback.',
+    defaultSeverity: 'info',
+    run({ graph, report }) {
+        for (const t of graph.tokens({ type: 'color' }))
+            for (const v of t.values) {
+                const c = v.value;
+                if (c && !c.hex && !isInSrgbGamut(c))
+                    report({
+                        message: `"${t.id}" is outside sRGB; add a hex fallback for sRGB targets`,
+                        nodes: [t.id],
+                        evidence: { space: c.space },
+                        when: v.when,
+                        token: t,
+                    });
+            }
+    },
+};
+/** Color ramps: siblings whose last name segment is a number (`blue.100`, `blue-500`), at least 3 stops. */
+function ramps(graph) {
+    const groups = new Map();
+    for (const t of graph.tokens({ type: 'color' })) {
+        const segs = normalizeName(t.id).split('.');
+        const step = Number(segs.at(-1));
+        if (segs.length < 2 || !/^\d+$/.test(segs.at(-1)) || !Number.isFinite(step))
+            continue;
+        const key = segs.slice(0, -1).join('.');
+        groups.set(key, [...(groups.get(key) ?? []), { id: t.id, step }]);
+    }
+    return [...groups]
+        .filter(([, stops]) => stops.length >= 3)
+        .map(([name, stops]) => ({ name, stops: stops.sort((a, b) => a.step - b.step) }));
+}
+export const nonMonotonicPalette = {
+    id: 'palette/non-monotonic',
+    description: 'Lightness of a numeric color ramp does not change in one direction.',
+    defaultSeverity: 'warning',
+    run({ graph, report }) {
+        for (const { name, stops } of ramps(graph)) {
+            const l = stops.map((s) => {
+                const v = graph.value(s.id);
+                return v ? toOklab(v)[0] : Number.NaN;
+            });
+            const dir = Math.sign(l.at(-1) - l[0]);
+            for (let i = 1; i < stops.length; i++) {
+                const step = l[i] - l[i - 1];
+                if (Number.isNaN(step) || Math.abs(step) < 1e-4)
+                    continue;
+                if (Math.sign(step) !== dir)
+                    report({
+                        message: `Ramp "${name}": lightness goes the wrong way from ${stops[i - 1].step} to ${stops[i].step}`,
+                        nodes: [stops[i - 1].id, stops[i].id],
+                        evidence: {
+                            ramp: name,
+                            from: Math.round(l[i - 1] * 1000) / 1000,
+                            to: Math.round(l[i] * 1000) / 1000,
+                        },
+                    });
+            }
+        }
+    },
+};
+export const duplicateStops = {
+    id: 'palette/duplicate-stops',
+    description: 'Two steps of a numeric color ramp have the same color.',
+    defaultSeverity: 'warning',
+    run({ graph, report }) {
+        for (const { name, stops } of ramps(graph))
+            for (let i = 1; i < stops.length; i++) {
+                const a = graph.value(stops[i - 1].id);
+                const b = graph.value(stops[i].id);
+                if (a && b && compareValues('color', a, b).result !== 'changed')
+                    report({
+                        message: `Ramp "${name}": steps ${stops[i - 1].step} and ${stops[i].step} are the same color`,
+                        nodes: [stops[i - 1].id, stops[i].id],
+                        evidence: { ramp: name },
+                    });
+            }
+    },
+};
+export const contrastMatrix = {
+    id: 'a11y/contrast-matrix',
+    description: 'Every text role over every surface role meets the minimum WCAG contrast in every context.',
+    defaultSeverity: 'off',
+    run({ graph, options, report }) {
+        const text = asArray(options.text);
+        const surfaces = asArray(options.surfaces);
+        const min = typeof options.min === 'number' ? options.min : 4.5;
+        const acknowledged = new Set(asArray(options.acknowledged));
+        if (text.length === 0 || surfaces.length === 0)
+            return;
+        const textTokens = graph.tokens({ type: 'color' }).filter((t) => text.some((p) => matchPath(t.id, p)));
+        const surfaceTokens = graph
+            .tokens({ type: 'color' })
+            .filter((t) => surfaces.some((p) => matchPath(t.id, p)));
+        const inputs = graph.inputs().slice(0, 64);
+        for (const fg of textTokens)
+            for (const bg of surfaceTokens) {
+                if (fg.id === bg.id)
+                    continue;
+                const failing = new Map();
+                for (const input of inputs) {
+                    const f = graph.value(fg.id, input);
+                    const b = graph.value(bg.id, input);
+                    if (!f || !b)
+                        continue;
+                    const ratio = Math.round(contrastRatio(f, b) * 100) / 100;
+                    if (ratio < min)
+                        failing.set(JSON.stringify(input), { when: input, ratio });
+                }
+                if (failing.size === 0)
+                    continue;
+                const pair = `${fg.id} × ${bg.id}`;
+                const worst = [...failing.values()].sort((a, b) => a.ratio - b.ratio)[0];
+                const all = failing.size === inputs.length;
+                const finding = {
+                    message: `${pair}: contrast ${worst.ratio} is below ${min}${all ? '' : ` in ${failing.size} of ${inputs.length} contexts`}`,
+                    nodes: [fg.id, bg.id],
+                    evidence: { ratio: worst.ratio, min, contexts: [...failing.values()].map((f) => f.when) },
+                    ...(all ? {} : { when: worst.when }),
+                };
+                report(acknowledged.has(pair)
+                    ? { ...finding, severity: 'info', message: `${finding.message} (acknowledged)` }
+                    : finding);
+            }
+    },
+};
+//# sourceMappingURL=tokens.js.map

package/dist/rules/tokens.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+import type { CodeIndex, Config, DsGraph, Finding, Loc, Severity, Token, VarMatcher, When } from '@dsgraph/core';
+export interface RuleContext {
+    graph: DsGraph;
+    options: Record<string, unknown>;
+    config: Config;
+    /** The project's code, when checked with it (`--code`, `code` in the config). */
+    code?: CodeIndex;
+    /** Custom property names in the code to tokens; present with `code`. */
+    vars?: VarMatcher;
+    report(finding: {
+        message: string;
+        nodes: string[];
+        evidence?: Record<string, unknown>;
+        when?: When;
+        token?: Token;
+        /** Where in the code; takes precedence over the token's origin. */
+        loc?: Loc;
+        severity?: Severity;
+    }): void;
+}
+/** A rule is a pure function of the graph and its options (spec section 7.4). */
+export interface Rule {
+    id: string;
+    description: string;
+    defaultSeverity: Severity | 'off';
+    run(ctx: RuleContext): void;
+}
+export type { Finding };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,OAAO,EACP,OAAO,EACP,GAAG,EACH,QAAQ,EACR,KAAK,EACL,UAAU,EACV,IAAI,EACL,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,OAAO,EAAE;QACd,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,EAAE,IAAI,CAAA;QACX,KAAK,CAAC,EAAE,KAAK,CAAA;QACb,mEAAmE;QACnE,GAAG,CAAC,EAAE,GAAG,CAAA;QACT,QAAQ,CAAC,EAAE,QAAQ,CAAA;KACpB,GAAG,IAAI,CAAA;CACT;AAED,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,QAAQ,GAAG,KAAK,CAAA;IACjC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B;AAED,YAAY,EAAE,OAAO,EAAE,CAAA"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@dsgraph/rules",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Rule engine and built-in rules for dsgraph: layers, contrast, palettes, deprecations, naming.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/specsure/specsure.git",
+    "directory": "packages/dsgraph-rules"
+  },
+  "homepage": "https://github.com/specsure/specsure/tree/main/packages/dsgraph-rules#readme",
+  "bugs": {
+    "url": "https://github.com/specsure/specsure/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "dependencies": {
+    "@dsgraph/core": "0.3.0",
+    "culori": "4.0.2"
+  },
+  "devDependencies": {
+    "@types/culori": "4.0.1"
+  }
+}