design-constraint-validator 1.1.0 → 2.1.0

package/cli/constraints-loader.js

@@ -1,58 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use constraint-registry.ts instead.
- *
- * Phase 3A (Architectural Cleanup): This file contains legacy runtime constraint
- * loading logic that has been replaced by the centralized constraint-registry.ts module.
- *
- * Migration: Replace attachRuntimeConstraints() with setupConstraints() from constraint-registry.ts
- *
- * This file will be removed in a future major version.
- */
-import { loadCrossAxisPlugin } from '../core/cross-axis-config.js';
-import { ThresholdPlugin } from '../core/constraints/threshold.js';
-/**
- * Attach runtime constraints that depend on project files or built-in policies:
- * - Cross-axis rules from themes/cross-axis*.rules.json
- * - Built-in threshold rules (e.g., control.size.min >= 44px)
- *
- * @deprecated Use setupConstraints() from constraint-registry.ts instead.
- * This function will be removed in a future major version.
- */
-export function attachRuntimeConstraints(engine, opts) {
-    const { knownIds, bp, crossAxisDebug, config } = opts;
-    // Cross-axis rules: global + optional breakpoint-specific
-    try {
-        engine.use(loadCrossAxisPlugin('themes/cross-axis.rules.json', bp, {
-            debug: !!crossAxisDebug,
-            knownIds,
-        }));
-        if (bp) {
-            const bpRulesPath = `themes/cross-axis.${bp}.rules.json`;
-            engine.use(loadCrossAxisPlugin(bpRulesPath, bp, {
-                debug: !!crossAxisDebug,
-                knownIds,
-            }));
-        }
-    }
-    catch {
-        // If cross-axis configuration fails, continue with other constraints.
-    }
-    const constraintsCfg = config.constraints ?? {};
-    // Built-in threshold rule for touch targets (configurable)
-    const enableBuiltInThreshold = constraintsCfg.enableBuiltInThreshold === undefined ? true : !!constraintsCfg.enableBuiltInThreshold;
-    if (enableBuiltInThreshold) {
-        try {
-            engine.use(ThresholdPlugin([
-                {
-                    id: 'control.size.min',
-                    op: '>=',
-                    valuePx: 44,
-                    where: 'Touch target (WCAG / Apple HIG)',
-                },
-            ], 'threshold'));
-        }
-        catch {
-            // Threshold attachment is best-effort; failures should not abort validation.
-        }
-    }
-}

package/cli/constraints-loader.ts

@@ -1,83 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use constraint-registry.ts instead.
- *
- * Phase 3A (Architectural Cleanup): This file contains legacy runtime constraint
- * loading logic that has been replaced by the centralized constraint-registry.ts module.
- *
- * Migration: Replace attachRuntimeConstraints() with setupConstraints() from constraint-registry.ts
- *
- * This file will be removed in a future major version.
- */
-
-import type { Engine } from '../core/engine.js';
-import { loadCrossAxisPlugin } from '../core/cross-axis-config.js';
-import { ThresholdPlugin } from '../core/constraints/threshold.js';
-import type { Breakpoint } from '../core/breakpoints.js';
-import type { DcvConfig } from './types.js';
-
-type AttachRuntimeOpts = {
-  config: DcvConfig;
-  knownIds: Set<string>;
-  bp?: Breakpoint;
-  crossAxisDebug?: boolean;
-};
-
-/**
- * Attach runtime constraints that depend on project files or built-in policies:
- * - Cross-axis rules from themes/cross-axis*.rules.json
- * - Built-in threshold rules (e.g., control.size.min >= 44px)
- *
- * @deprecated Use setupConstraints() from constraint-registry.ts instead.
- * This function will be removed in a future major version.
- */
-export function attachRuntimeConstraints(engine: Engine, opts: AttachRuntimeOpts): void {
-  const { knownIds, bp, crossAxisDebug, config } = opts;
-
-  // Cross-axis rules: global + optional breakpoint-specific
-  try {
-    engine.use(
-      loadCrossAxisPlugin('themes/cross-axis.rules.json', bp, {
-        debug: !!crossAxisDebug,
-        knownIds,
-      }),
-    );
-
-    if (bp) {
-      const bpRulesPath = `themes/cross-axis.${bp}.rules.json`;
-      engine.use(
-        loadCrossAxisPlugin(bpRulesPath, bp, {
-          debug: !!crossAxisDebug,
-          knownIds,
-        }),
-      );
-    }
-  } catch {
-    // If cross-axis configuration fails, continue with other constraints.
-  }
-
-  const constraintsCfg = config.constraints ?? {};
-
-  // Built-in threshold rule for touch targets (configurable)
-  const enableBuiltInThreshold =
-    constraintsCfg.enableBuiltInThreshold === undefined ? true : !!constraintsCfg.enableBuiltInThreshold;
-
-  if (enableBuiltInThreshold) {
-    try {
-      engine.use(
-        ThresholdPlugin(
-          [
-            {
-              id: 'control.size.min',
-              op: '>=',
-              valuePx: 44,
-              where: 'Touch target (WCAG / Apple HIG)',
-            },
-          ],
-          'threshold',
-        ),
-      );
-    } catch {
-      // Threshold attachment is best-effort; failures should not abort validation.
-    }
-  }
-}

package/cli/engine-helpers.d.ts

@@ -1,41 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use constraint-registry.ts instead.
- *
- * Phase 3A (Architectural Cleanup): This file contains legacy constraint loading logic
- * that has been replaced by the centralized constraint-registry.ts module.
- *
- * Migration guide:
- * - Replace createEngine() or createValidationEngine() with:
- *   ```ts
- *   import { Engine } from '../core/engine.js';
- *   import { flattenTokens, type FlatToken } from '../core/flatten.js';
- *   import { setupConstraints } from './constraint-registry.js';
- *
- *   const { flat, edges } = flattenTokens(tokens);
- *   const init = {};
- *   for (const t of Object.values(flat)) {
- *     init[(t as FlatToken).id] = (t as FlatToken).value;
- *   }
- *   const engine = new Engine(init, edges);
- *   const knownIds = new Set(Object.keys(init));
- *   setupConstraints(engine, { config, bp }, { knownIds });
- *   ```
- *
- * This file will be removed in a future major version.
- */
-import { type TokenNode } from '../core/flatten.js';
-import { Engine } from '../core/engine.js';
-import { loadTokensWithBreakpoint, type Breakpoint } from '../core/breakpoints.js';
-import type { DcvConfig } from './types.js';
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export declare function createEngine(tokensRoot: TokenNode, config?: DcvConfig): Engine;
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export declare function createValidationEngine(tokensRoot: TokenNode, bp: Breakpoint | undefined, config: DcvConfig): Engine;
-export { loadTokensWithBreakpoint };
-//# sourceMappingURL=engine-helpers.d.ts.map

package/cli/engine-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-helpers.d.ts","sourceRoot":"","sources":["engine-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAkB,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,OAAO,EAA8B,wBAAwB,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgE5C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,GAAE,SAAc,GAAG,MAAM,CAQlF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAgBnH;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/cli/engine-helpers.js

@@ -1,135 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use constraint-registry.ts instead.
- *
- * Phase 3A (Architectural Cleanup): This file contains legacy constraint loading logic
- * that has been replaced by the centralized constraint-registry.ts module.
- *
- * Migration guide:
- * - Replace createEngine() or createValidationEngine() with:
- *   ```ts
- *   import { Engine } from '../core/engine.js';
- *   import { flattenTokens, type FlatToken } from '../core/flatten.js';
- *   import { setupConstraints } from './constraint-registry.js';
- *
- *   const { flat, edges } = flattenTokens(tokens);
- *   const init = {};
- *   for (const t of Object.values(flat)) {
- *     init[(t as FlatToken).id] = (t as FlatToken).value;
- *   }
- *   const engine = new Engine(init, edges);
- *   const knownIds = new Set(Object.keys(init));
- *   setupConstraints(engine, { config, bp }, { knownIds });
- *   ```
- *
- * This file will be removed in a future major version.
- */
-import { flattenTokens } from '../core/flatten.js';
-import { Engine } from '../core/engine.js';
-import { MonotonicPlugin, parseSize as parseSizePx } from '../core/constraints/monotonic.js';
-import { MonotonicLightness } from '../core/constraints/monotonic-lightness.js';
-import { WcagContrastPlugin } from '../core/constraints/wcag.js';
-import { loadOrders as loadOrdersBP, loadTokensWithBreakpoint } from '../core/breakpoints.js';
-function applyMonotonicPlugins(engine, bp) {
-    function loadOrders(path) {
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            return JSON.parse(require('node:fs').readFileSync(path, 'utf8')).order;
-        }
-        catch {
-            return [];
-        }
-    }
-    const suffix = bp ? `.${bp}` : '';
-    const typOrders = loadOrders(`themes/typography${suffix}.order.json`);
-    const spacingOrders = loadOrders(`themes/spacing${suffix}.order.json`);
-    const layoutOrders = loadOrders(`themes/layout${suffix}.order.json`);
-    const colorOrders = loadOrders(`themes/color${suffix}.order.json`);
-    if (typOrders.length)
-        engine.use(MonotonicPlugin(typOrders, parseSizePx, 'monotonic-typography'));
-    if (spacingOrders.length)
-        engine.use(MonotonicPlugin(spacingOrders, parseSizePx, 'monotonic-spacing'));
-    if (layoutOrders.length)
-        engine.use(MonotonicPlugin(layoutOrders, parseSizePx, 'monotonic-layout'));
-    if (colorOrders.length)
-        engine.use(MonotonicLightness(colorOrders));
-}
-function applyWcagPlugins(engine, config) {
-    const constraintsCfg = config.constraints ?? {};
-    if (constraintsCfg.wcag) {
-        const wcagRules = constraintsCfg.wcag.map((r) => ({
-            fg: r.foreground,
-            bg: r.background,
-            min: r.ratio || 4.5,
-            where: r.description || 'Unknown',
-        }));
-        engine.use(WcagContrastPlugin(wcagRules));
-    }
-    const enableDefaults = constraintsCfg.enableBuiltInWcagDefaults === undefined
-        ? true
-        : !!constraintsCfg.enableBuiltInWcagDefaults;
-    if (enableDefaults) {
-        const defaultWcagPairs = [
-            {
-                fg: 'color.role.text.default',
-                bg: 'color.role.bg.surface',
-                min: 4.5,
-                where: 'Body text on surface',
-            },
-            {
-                fg: 'color.role.accent.default',
-                bg: 'color.role.bg.surface',
-                min: 3.0,
-                where: 'Accent on surface',
-            },
-            {
-                fg: 'color.role.focus.ring',
-                bg: 'color.role.bg.surface',
-                min: 3.0,
-                where: 'Focus ring on surface',
-                backdrop: '#ffffff',
-            },
-        ];
-        engine.use(WcagContrastPlugin(defaultWcagPairs));
-    }
-}
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export function createEngine(tokensRoot, config = {}) {
-    const { flat, edges } = flattenTokens(tokensRoot);
-    const init = {};
-    for (const [id, token] of Object.entries(flat))
-        init[id] = token.value;
-    const engine = new Engine(init, edges);
-    applyMonotonicPlugins(engine, undefined);
-    applyWcagPlugins(engine, config);
-    return engine;
-}
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export function createValidationEngine(tokensRoot, bp, config) {
-    const { flat, edges } = flattenTokens(tokensRoot);
-    const init = {};
-    for (const t of Object.values(flat))
-        init[t.id] = t.value;
-    const engine = new Engine(init, edges);
-    // Use breakpoint-aware order loading where available
-    const typ = loadOrdersBP('typography', bp);
-    const spc = loadOrdersBP('spacing', bp);
-    const lay = loadOrdersBP('layout', bp);
-    const col = loadOrdersBP('color', bp);
-    if (typ.length)
-        engine.use(MonotonicPlugin(typ, parseSizePx, 'monotonic-typography'));
-    if (spc.length)
-        engine.use(MonotonicPlugin(spc, parseSizePx, 'monotonic-spacing'));
-    if (lay.length)
-        engine.use(MonotonicPlugin(lay, parseSizePx, 'monotonic-layout'));
-    if (col.length)
-        engine.use(MonotonicLightness(col));
-    applyWcagPlugins(engine, config);
-    return engine;
-}
-export { loadTokensWithBreakpoint };

package/cli/engine-helpers.ts

@@ -1,133 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use constraint-registry.ts instead.
- *
- * Phase 3A (Architectural Cleanup): This file contains legacy constraint loading logic
- * that has been replaced by the centralized constraint-registry.ts module.
- *
- * Migration guide:
- * - Replace createEngine() or createValidationEngine() with:
- *   ```ts
- *   import { Engine } from '../core/engine.js';
- *   import { flattenTokens, type FlatToken } from '../core/flatten.js';
- *   import { setupConstraints } from './constraint-registry.js';
- *
- *   const { flat, edges } = flattenTokens(tokens);
- *   const init = {};
- *   for (const t of Object.values(flat)) {
- *     init[(t as FlatToken).id] = (t as FlatToken).value;
- *   }
- *   const engine = new Engine(init, edges);
- *   const knownIds = new Set(Object.keys(init));
- *   setupConstraints(engine, { config, bp }, { knownIds });
- *   ```
- *
- * This file will be removed in a future major version.
- */
-
-import { flattenTokens, type TokenNode, type FlatToken } from '../core/flatten.js';
-import { Engine } from '../core/engine.js';
-import { MonotonicPlugin, parseSize as parseSizePx } from '../core/constraints/monotonic.js';
-import { MonotonicLightness } from '../core/constraints/monotonic-lightness.js';
-import { WcagContrastPlugin } from '../core/constraints/wcag.js';
-import { loadOrders as loadOrdersBP, loadTokensWithBreakpoint, type Breakpoint } from '../core/breakpoints.js';
-import type { DcvConfig } from './types.js';
-
-function applyMonotonicPlugins(engine: Engine, bp: Breakpoint | undefined): void {
-  function loadOrders(path: string) {
-    try { 
-      // eslint-disable-next-line @typescript-eslint/no-require-imports
-      return JSON.parse(require('node:fs').readFileSync(path, 'utf8')).order as [string, '<='|'>=', string][]; 
-    } catch { return []; }
-  }
-  const suffix = bp ? `.${bp}` : '';
-  const typOrders = loadOrders(`themes/typography${suffix}.order.json`);
-  const spacingOrders = loadOrders(`themes/spacing${suffix}.order.json`);
-  const layoutOrders = loadOrders(`themes/layout${suffix}.order.json`);
-  const colorOrders = loadOrders(`themes/color${suffix}.order.json`);
-  if (typOrders.length) engine.use(MonotonicPlugin(typOrders, parseSizePx, 'monotonic-typography'));
-  if (spacingOrders.length) engine.use(MonotonicPlugin(spacingOrders, parseSizePx, 'monotonic-spacing'));
-  if (layoutOrders.length) engine.use(MonotonicPlugin(layoutOrders, parseSizePx, 'monotonic-layout'));
-  if (colorOrders.length) engine.use(MonotonicLightness(colorOrders));
-}
-
-function applyWcagPlugins(engine: Engine, config: DcvConfig): void {
-  const constraintsCfg = config.constraints ?? {};
-
-  if (constraintsCfg.wcag) {
-    const wcagRules = constraintsCfg.wcag.map((r: any) => ({
-      fg: r.foreground,
-      bg: r.background,
-      min: r.ratio || 4.5,
-      where: r.description || 'Unknown',
-    }));
-    engine.use(WcagContrastPlugin(wcagRules));
-  }
-
-  const enableDefaults =
-    constraintsCfg.enableBuiltInWcagDefaults === undefined
-      ? true
-      : !!constraintsCfg.enableBuiltInWcagDefaults;
-
-  if (enableDefaults) {
-    const defaultWcagPairs = [
-      {
-        fg: 'color.role.text.default',
-        bg: 'color.role.bg.surface',
-        min: 4.5,
-        where: 'Body text on surface',
-      },
-      {
-        fg: 'color.role.accent.default',
-        bg: 'color.role.bg.surface',
-        min: 3.0,
-        where: 'Accent on surface',
-      },
-      {
-        fg: 'color.role.focus.ring',
-        bg: 'color.role.bg.surface',
-        min: 3.0,
-        where: 'Focus ring on surface',
-        backdrop: '#ffffff',
-      },
-    ];
-    engine.use(WcagContrastPlugin(defaultWcagPairs));
-  }
-}
-
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export function createEngine(tokensRoot: TokenNode, config: DcvConfig = {}): Engine {
-  const { flat, edges } = flattenTokens(tokensRoot);
-  const init: Record<string, string | number> = {};
-  for (const [id, token] of Object.entries(flat)) init[id] = (token as FlatToken).value;
-  const engine = new Engine(init, edges);
-  applyMonotonicPlugins(engine, undefined);
-  applyWcagPlugins(engine, config);
-  return engine;
-}
-
-/**
- * @deprecated Use constraint-registry.ts setupConstraints() instead.
- * This function will be removed in a future major version.
- */
-export function createValidationEngine(tokensRoot: TokenNode, bp: Breakpoint | undefined, config: DcvConfig): Engine {
-  const { flat, edges } = flattenTokens(tokensRoot);
-  const init: Record<string, string | number> = {};
-  for (const t of Object.values(flat)) init[(t as FlatToken).id] = (t as FlatToken).value;
-  const engine = new Engine(init, edges);
-  // Use breakpoint-aware order loading where available
-  const typ = loadOrdersBP('typography', bp);
-  const spc = loadOrdersBP('spacing', bp);
-  const lay = loadOrdersBP('layout', bp);
-  const col = loadOrdersBP('color', bp);
-  if (typ.length) engine.use(MonotonicPlugin(typ, parseSizePx, 'monotonic-typography'));
-  if (spc.length) engine.use(MonotonicPlugin(spc, parseSizePx, 'monotonic-spacing'));
-  if (lay.length) engine.use(MonotonicPlugin(lay, parseSizePx, 'monotonic-layout'));
-  if (col.length) engine.use(MonotonicLightness(col));
-  applyWcagPlugins(engine, config);
-  return engine;
-}
-
-export { loadTokensWithBreakpoint };

package/core/cross-axis-config.d.ts

@@ -1,34 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use cli/cross-axis-loader.ts instead.
- *
- * Phase 3B (Filesystem Separation): This file contains filesystem access logic
- * that has been moved to the CLI layer (cli/cross-axis-loader.ts).
- *
- * Core modules should not import from node:fs. Instead:
- * - CLI code uses cli/cross-axis-loader.ts to read and parse rules
- * - Core plugin (core/constraints/cross-axis.ts) accepts pre-parsed rules
- *
- * Migration:
- * ```ts
- * // OLD (core reads filesystem):
- * import { loadCrossAxisPlugin } from './core/cross-axis-config.js';
- * engine.use(loadCrossAxisPlugin(path, bp, { knownIds }));
- *
- * // NEW (CLI reads, core receives data):
- * import { loadCrossAxisRules } from './cli/cross-axis-loader.js';
- * import { CrossAxisPlugin } from './core/constraints/cross-axis.js';
- * const rules = loadCrossAxisRules(path, { bp, knownIds });
- * engine.use(CrossAxisPlugin(rules, bp));
- * ```
- *
- * This file will be removed in a future major version.
- */
-/**
- * @deprecated Use cli/cross-axis-loader.ts loadCrossAxisRules() + CrossAxisPlugin() instead.
- * This function will be removed in a future major version.
- */
-export declare function loadCrossAxisPlugin(path: string, bp?: string, opts?: {
-    debug?: boolean;
-    knownIds?: Set<string>;
-}): import("./engine.js").ConstraintPlugin;
-//# sourceMappingURL=cross-axis-config.d.ts.map

package/core/cross-axis-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-axis-config.d.ts","sourceRoot":"","sources":["cross-axis-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,0CA2HnD"}

package/core/cross-axis-config.js

@@ -1,173 +0,0 @@
-/**
- * @deprecated This module is deprecated. Use cli/cross-axis-loader.ts instead.
- *
- * Phase 3B (Filesystem Separation): This file contains filesystem access logic
- * that has been moved to the CLI layer (cli/cross-axis-loader.ts).
- *
- * Core modules should not import from node:fs. Instead:
- * - CLI code uses cli/cross-axis-loader.ts to read and parse rules
- * - Core plugin (core/constraints/cross-axis.ts) accepts pre-parsed rules
- *
- * Migration:
- * ```ts
- * // OLD (core reads filesystem):
- * import { loadCrossAxisPlugin } from './core/cross-axis-config.js';
- * engine.use(loadCrossAxisPlugin(path, bp, { knownIds }));
- *
- * // NEW (CLI reads, core receives data):
- * import { loadCrossAxisRules } from './cli/cross-axis-loader.js';
- * import { CrossAxisPlugin } from './core/constraints/cross-axis.js';
- * const rules = loadCrossAxisRules(path, { bp, knownIds });
- * engine.use(CrossAxisPlugin(rules, bp));
- * ```
- *
- * This file will be removed in a future major version.
- */
-import fs from "node:fs";
-import { CrossAxisPlugin } from "./constraints/cross-axis.js";
-/**
- * @deprecated Use cli/cross-axis-loader.ts loadCrossAxisRules() + CrossAxisPlugin() instead.
- * This function will be removed in a future major version.
- */
-export function loadCrossAxisPlugin(path, bp, opts) {
-    const debug = !!opts?.debug;
-    const known = opts?.knownIds ?? new Set();
-    const log = (...args) => { if (debug)
-        console.log("[cross-axis]", ...args); };
-    if (!fs.existsSync(path)) {
-        log(`no rules file at ${path} (bp=${bp ?? "global"})`);
-        return CrossAxisPlugin([], bp);
-    }
-    const raw = JSON.parse(fs.readFileSync(path, "utf8"));
-    const rules = [];
-    const unknownIds = new Set();
-    const skipped = [];
-    // Fuzzy suggestion helpers (lightweight Levenshtein)
-    function levenshtein(a, b) {
-        const dp = Array(b.length + 1).fill(0).map((_, j) => j);
-        for (let i = 1; i <= a.length; i++) {
-            let prev = i - 1, cur = i;
-            for (let j = 1; j <= b.length; j++) {
-                const tmp = cur;
-                const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-                cur = Math.min(dp[j] + 1, cur + 1, prev + cost);
-                dp[j] = tmp;
-                prev = tmp;
-            }
-            dp[b.length] = cur;
-        }
-        return dp[b.length];
-    }
-    function suggest(id, k = 3) {
-        return [...known].map(c => ({ id: c, d: levenshtein(id, c) }))
-            .sort((a, b) => a.d - b.d)
-            .slice(0, k);
-    }
-    const needId = (id) => {
-        if (!id)
-            return false;
-        if (!known.has(id)) {
-            unknownIds.add(id);
-        }
-        return true;
-    };
-    for (const r of raw.rules || []) {
-        if (r.bp && bp && r.bp !== bp) {
-            continue;
-        }
-        if (r.bp && !bp) { // rule targets specific breakpoint; skip in global run
-            continue;
-        }
-        try {
-            if (r.when && r.require) {
-                // Validate IDs
-                needId(r.when.id);
-                needId(r.require.id);
-                if (r.require.ref)
-                    needId(r.require.ref);
-                rules.push({
-                    id: r.id, level: r.level, where: r.where,
-                    when: { id: r.when.id, test: makeOp(r.when.op, r.when.value) },
-                    require: {
-                        id: r.require.id,
-                        test: (v, ctx) => {
-                            const rhs = valueOrRef(ctx, r.require.ref, r.require.fallback);
-                            return cmp(v, rhs, r.require.op);
-                        },
-                        msg: (v, ctx) => {
-                            const rhs = valueOrRef(ctx, r.require.ref, r.require.fallback);
-                            return `${r.require.id} ${prettyFail(r.require.op)} ${fmt(rhs)} (was ${fmt(v)})`;
-                        }
-                    }
-                });
-            }
-            else if (r.compare) {
-                needId(r.compare.a);
-                needId(r.compare.b);
-                rules.push({
-                    id: r.id, level: r.level, where: r.where,
-                    when: { id: r.compare.a, test: () => true },
-                    require: {
-                        id: r.compare.a,
-                        test: (_, ctx) => {
-                            const a = ctx.getPx(r.compare.a) ?? NaN;
-                            const b = ctx.getPx(r.compare.b) ?? NaN;
-                            const delta = px(r.compare.delta ?? 0);
-                            if (Number.isNaN(a) || Number.isNaN(b))
-                                return true; // skip check if missing
-                            return cmp(a, b + delta, r.compare.op);
-                        },
-                        msg: (_, ctx) => {
-                            const a = ctx.getPx(r.compare.a);
-                            const b = ctx.getPx(r.compare.b);
-                            const delta = px(r.compare.delta ?? 0);
-                            return `${r.compare.a} ${prettyFail(r.compare.op)} ${fmt((b ?? 0) + delta)} (was ${fmt(a ?? NaN)})`;
-                        }
-                    }
-                });
-            }
-            else {
-                skipped.push({ id: r.id, reason: "neither when+require nor compare present" });
-            }
-        }
-        catch (e) {
-            skipped.push({ id: r.id, reason: `exception: ${e?.message ?? e}` });
-        }
-    }
-    log(`loaded ${rules.length} rule(s) from ${path}${bp ? ` [bp=${bp}]` : ""}`);
-    if (unknownIds.size) {
-        log(`unknown ids referenced:`, [...unknownIds].join(", "));
-        for (const u of unknownIds) {
-            const s = suggest(u, 3);
-            if (s.length)
-                log(`  did you mean: ${s.map(x => `${x.id} (d=${x.d})`).join(', ')}`);
-        }
-    }
-    if (skipped.length) {
-        for (const s of skipped)
-            log(`skipped rule ${s.id ?? "(no id)"} — ${s.reason}`);
-    }
-    // Extra hint for common anchor pitfall
-    for (const r of raw.rules || []) {
-        if (r.require?.ref && !known.has(r.require.ref)) {
-            log(`anchor missing: ${r.require.ref} → will use fallback=${JSON.stringify(r.require.fallback)} when evaluating`);
-        }
-    }
-    return CrossAxisPlugin(rules, bp);
-}
-// helpers
-const px = (v) => typeof v === "number" ? v : parseFloat(String(v)) * (String(v).trim().endsWith("rem") ? 16 : 1);
-const cmp = (a, b, op) => op === ">=" ? a >= b : op === ">" ? a > b : op === "<=" ? a <= b : op === "<" ? a < b : op === "==" ? a === b : a !== b;
-const prettyFail = (op) => ({ ">=": "<", ">": "≤", "<=": ">", "<": "≥", "==": "≠", "!=": "=" }[op] || "≠");
-const fmt = (v) => Number.isFinite(Number(v)) ? `${Number(v)}px` : String(v);
-function valueOrRef(ctx, ref, fallback) {
-    if (ref) {
-        const v = ctx.getPx(ref);
-        if (v != null)
-            return v;
-    }
-    return typeof fallback === "number" ? fallback : px(fallback ?? 0);
-}
-function makeOp(op, rhs) {
-    return (v) => cmp(v, rhs, op);
-}