design-constraint-validator 1.1.0 → 2.0.1

package/README.md

@@ -146,6 +146,20 @@ Full adapter documentation: **[Adapters](docs/Adapters.md)**
 
 ---
 
+## DCV & DecisionThemes
+
+DCV is the **standalone validation engine** — use it for any token system.
+
+**DecisionThemes** (coming 2026) is a complete design system framework built on DCV:
+- **5-axis decision model** (Tone, Emphasis, Size, Density, Shape)
+- **VT/DT pipeline** (Value Themes + Decision Themes → deterministic CSS configs)
+- **Studio UI** + **Hub marketplace** for sharing Decision Systems
+
+DCV powers DecisionThemes' validation layer — but works perfectly standalone.
+Preview: [www.decisionthemes.com](https://www.decisionthemes.com)
+
+---
+
 ## Method & Prior Art
 
 The Design Constraint Validator engine is based on a theming and validation method published as **defensive prior art**.

package/adapters/decisionthemes.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DecisionThemes Adapter (Placeholder)
+ *
+ * This adapter will integrate with the DecisionThemes framework (coming 2026).
+ * It transforms VT (Value Themes) + DT (Decision Themes) into flat tokens for DCV validation.
+ *
+ * @see https://www.decisionthemes.com
+ * @see docs/Adapters.md for implementation details
+ *
+ * @example
+ * ```typescript
+ * import { decisionthemesAdapter } from './adapters/decisionthemes.js';
+ *
+ * const { tokens, policy } = decisionthemesAdapter({
+ *   vt: { ... }, // Value Themes (raw values)
+ *   dt: { ... }  // Decision Themes (formulas)
+ * });
+ *
+ * // tokens = flat token object for DCV validation
+ * // policy = auto-generated constraints from 5-axis model
+ * ```
+ */
+export interface VT {
+    [key: string]: any;
+}
+export interface DT {
+    [key: string]: any;
+}
+export interface DecisionThemesInput {
+    vt: VT;
+    dt: DT;
+}
+export interface DecisionThemesOutput {
+    tokens: Record<string, any>;
+    policy?: string;
+}
+/**
+ * Transform DecisionThemes (VT+DT) into DCV-compatible tokens
+ *
+ * @param input - VT (values) + DT (decisions)
+ * @returns Flat tokens + optional policy JSON
+ */
+export declare function decisionthemesAdapter(_input: DecisionThemesInput): DecisionThemesOutput;
+//# sourceMappingURL=decisionthemes.d.ts.map

package/adapters/decisionthemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionthemes.d.ts","sourceRoot":"","sources":["decisionthemes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,EAAE;IAEjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,EAAE;IAEjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,EAAE,CAAC;IACP,EAAE,EAAE,EAAE,CAAC;CACR;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CASvF"}

package/adapters/decisionthemes.js

@@ -0,0 +1,35 @@
+/**
+ * DecisionThemes Adapter (Placeholder)
+ *
+ * This adapter will integrate with the DecisionThemes framework (coming 2026).
+ * It transforms VT (Value Themes) + DT (Decision Themes) into flat tokens for DCV validation.
+ *
+ * @see https://www.decisionthemes.com
+ * @see docs/Adapters.md for implementation details
+ *
+ * @example
+ * ```typescript
+ * import { decisionthemesAdapter } from './adapters/decisionthemes.js';
+ *
+ * const { tokens, policy } = decisionthemesAdapter({
+ *   vt: { ... }, // Value Themes (raw values)
+ *   dt: { ... }  // Decision Themes (formulas)
+ * });
+ *
+ * // tokens = flat token object for DCV validation
+ * // policy = auto-generated constraints from 5-axis model
+ * ```
+ */
+/**
+ * Transform DecisionThemes (VT+DT) into DCV-compatible tokens
+ *
+ * @param input - VT (values) + DT (decisions)
+ * @returns Flat tokens + optional policy JSON
+ */
+export function decisionthemesAdapter(_input) {
+    // TODO: Implement when DecisionThemes integration is ready
+    // This will call the DecisionThemes resolver/compute engine to process _input
+    throw new Error('DecisionThemes adapter not yet implemented. ' +
+        'This is a placeholder for future integration with the DecisionThemes framework. ' +
+        'See https://www.decisionthemes.com for updates.');
+}

package/adapters/decisionthemes.ts

@@ -0,0 +1,59 @@
+/**
+ * DecisionThemes Adapter (Placeholder)
+ *
+ * This adapter will integrate with the DecisionThemes framework (coming 2026).
+ * It transforms VT (Value Themes) + DT (Decision Themes) into flat tokens for DCV validation.
+ *
+ * @see https://www.decisionthemes.com
+ * @see docs/Adapters.md for implementation details
+ *
+ * @example
+ * ```typescript
+ * import { decisionthemesAdapter } from './adapters/decisionthemes.js';
+ *
+ * const { tokens, policy } = decisionthemesAdapter({
+ *   vt: { ... }, // Value Themes (raw values)
+ *   dt: { ... }  // Decision Themes (formulas)
+ * });
+ *
+ * // tokens = flat token object for DCV validation
+ * // policy = auto-generated constraints from 5-axis model
+ * ```
+ */
+
+export interface VT {
+  // Value Themes - raw design values
+  [key: string]: any;
+}
+
+export interface DT {
+  // Decision Themes - formulas and decision mappings
+  [key: string]: any;
+}
+
+export interface DecisionThemesInput {
+  vt: VT;
+  dt: DT;
+}
+
+export interface DecisionThemesOutput {
+  tokens: Record<string, any>;
+  policy?: string;
+}
+
+/**
+ * Transform DecisionThemes (VT+DT) into DCV-compatible tokens
+ *
+ * @param input - VT (values) + DT (decisions)
+ * @returns Flat tokens + optional policy JSON
+ */
+export function decisionthemesAdapter(_input: DecisionThemesInput): DecisionThemesOutput {
+  // TODO: Implement when DecisionThemes integration is ready
+  // This will call the DecisionThemes resolver/compute engine to process _input
+
+  throw new Error(
+    'DecisionThemes adapter not yet implemented. ' +
+    'This is a placeholder for future integration with the DecisionThemes framework. ' +
+    'See https://www.decisionthemes.com for updates.'
+  );
+}

package/cli/commands/graph.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { flattenTokens } from '../../core/flatten.js';
 import { exportGraphImage } from '../../core/image-export.js';
-import { attachRuntimeConstraints } from '../constraints-loader.js';
+import { setupConstraints } from '../constraint-registry.js';
 import { loadConfig } from '../config.js';
 // Local helper for non-poset dependency graphs
 function generateDependencyGraph(edges, format) {
@@ -127,7 +127,7 @@ export async function graphCommand(options) {
                     if (cfgRes.ok) {
                         const config = cfgRes.value;
                         const knownIds = new Set(Object.keys(flat));
-                        attachRuntimeConstraints(engine, { config, knownIds, bp: breakpoint });
+                        setupConstraints(engine, { config, bp: breakpoint }, { knownIds });
                         const runtimeIssues = engine.evaluate(allIdsInHasse);
                         issues.push(...runtimeIssues);
                     }

package/cli/commands/graph.ts

@@ -2,7 +2,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import type { GraphOptions } from '../types.js';
 import { flattenTokens, type FlatToken } from '../../core/flatten.js';
 import { exportGraphImage } from '../../core/image-export.js';
-import { attachRuntimeConstraints } from '../constraints-loader.js';
+import { setupConstraints } from '../constraint-registry.js';
 import { loadConfig } from '../config.js';
 
 // Local helper for non-poset dependency graphs
@@ -98,7 +98,7 @@ export async function graphCommand(options: GraphOptions): Promise<void> {
           if (cfgRes.ok) {
             const config = cfgRes.value;
             const knownIds = new Set(Object.keys(flat as Record<string, FlatToken>));
-            attachRuntimeConstraints(engine, { config, knownIds, bp: breakpoint });
+            setupConstraints(engine, { config, bp: breakpoint }, { knownIds });
             const runtimeIssues = engine.evaluate(allIdsInHasse);
             issues.push(...runtimeIssues);
           }

package/cli/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoK9E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOnD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuK9E"}

package/cli/commands/validate.js

@@ -6,7 +6,10 @@ import { createValidationResult, createValidationReceipt, writeJsonOutput } from
 import { readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { setupConstraints } from '../constraint-registry.js';
+import { printVersionBanner } from '../version-banner.js';
 export async function validateCommand(_options) {
+    // Show version banner (subtle, dimmed)
+    printVersionBanner({ quiet: _options.format === 'json' });
     try {
         const bps = parseBreakpoints(process.argv);
         const crossAxisDebug = process.argv.includes('--cross-axis-debug');

package/cli/commands/validate.ts

@@ -8,8 +8,12 @@ import { createValidationResult, createValidationReceipt, writeJsonOutput } from
 import { readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { setupConstraints } from '../constraint-registry.js';
+import { printVersionBanner } from '../version-banner.js';
 
 export async function validateCommand(_options: ValidateOptions): Promise<void> {
+  // Show version banner (subtle, dimmed)
+  printVersionBanner({ quiet: _options.format === 'json' });
+
   try {
     const bps = parseBreakpoints(process.argv);
     const crossAxisDebug = process.argv.includes('--cross-axis-debug');

package/cli/json-output.d.ts

@@ -26,6 +26,11 @@ export interface ValidationResult {
         engineVersion: string;
         timestamp: string;
     };
+    dcv: {
+        name: string;
+        version: string;
+        repository: string;
+    };
 }
 export interface ValidationReceipt extends ValidationResult {
     environment: {

package/cli/json-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["json-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAiB3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EAAE,EACzB,QAAQ,EAAE,eAAe,EAAE,EAC3B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAmBlB;AAcD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAC/B,iBAAiB,CAoCnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CASxE"}
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["json-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAiB3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EAAE,EACzB,QAAQ,EAAE,eAAe,EAAE,EAC3B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAoBlB;AAcD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAC/B,iBAAiB,CAoCnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CASxE"}

package/cli/json-output.js

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { createHash } from 'node:crypto';
+import { getVersionInfo } from './version-banner.js';
 /**
  * Convert internal ConstraintIssue to standardized ConstraintViolation format
  */
@@ -39,6 +40,7 @@ export function createValidationResult(errors, warnings, durationMs, engineVersi
             engineVersion,
             timestamp: new Date().toISOString(),
         },
+        dcv: getVersionInfo(),
     };
 }
 /**

package/cli/json-output.ts

@@ -2,6 +2,7 @@ import type { ConstraintIssue } from '../core/engine.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { createHash } from 'node:crypto';
+import { getVersionInfo } from './version-banner.js';
 
 export interface ConstraintViolation {
   ruleId: string;
@@ -31,6 +32,11 @@ export interface ValidationResult {
     engineVersion: string;
     timestamp: string;
   };
+  dcv: {
+    name: string;
+    version: string;
+    repository: string;
+  };
 }
 
 export interface ValidationReceipt extends ValidationResult {
@@ -100,6 +106,7 @@ export function createValidationResult(
       engineVersion,
       timestamp: new Date().toISOString(),
     },
+    dcv: getVersionInfo(),
   };
 }
 

package/cli/version-banner.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Version banner utility
+ * Displays DCV version info when validation runs
+ */
+/**
+ * Print DCV version banner
+ * Shows: DCV v{version} | {repo_url}
+ */
+export declare function printVersionBanner(options?: {
+    quiet?: boolean;
+}): void;
+/**
+ * Get version string for JSON output
+ */
+export declare function getVersionInfo(): {
+    name: string;
+    version: string;
+    repository: string;
+};
+//# sourceMappingURL=version-banner.d.ts.map

package/cli/version-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-banner.d.ts","sourceRoot":"","sources":["version-banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAOtE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAOtF"}

package/cli/version-banner.js

@@ -0,0 +1,49 @@
+/**
+ * Version banner utility
+ * Displays DCV version info when validation runs
+ */
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cachedPkg = null;
+function getPackageInfo() {
+    if (cachedPkg)
+        return cachedPkg;
+    try {
+        const pkgPath = join(__dirname, '../package.json');
+        const pkgContent = readFileSync(pkgPath, 'utf-8');
+        cachedPkg = JSON.parse(pkgContent);
+        return cachedPkg;
+    }
+    catch {
+        // Fallback if package.json not found
+        return {
+            name: 'design-constraint-validator',
+            version: '2.0.0',
+            homepage: 'https://github.com/CseperkePapp/design-constraint-validator'
+        };
+    }
+}
+/**
+ * Print DCV version banner
+ * Shows: DCV v{version} | {repo_url}
+ */
+export function printVersionBanner(options) {
+    if (options?.quiet)
+        return;
+    const pkg = getPackageInfo();
+    const repoUrl = pkg.homepage || 'https://github.com/CseperkePapp/design-constraint-validator';
+    console.log(`\x1b[2m${pkg.name} v${pkg.version} | ${repoUrl}\x1b[0m`);
+}
+/**
+ * Get version string for JSON output
+ */
+export function getVersionInfo() {
+    const pkg = getPackageInfo();
+    return {
+        name: pkg.name,
+        version: pkg.version,
+        repository: pkg.homepage || 'https://github.com/CseperkePapp/design-constraint-validator'
+    };
+}

package/cli/version-banner.ts

@@ -0,0 +1,61 @@
+/**
+ * Version banner utility
+ * Displays DCV version info when validation runs
+ */
+
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+interface PackageJson {
+  name: string;
+  version: string;
+  homepage?: string;
+}
+
+let cachedPkg: PackageJson | null = null;
+
+function getPackageInfo(): PackageJson {
+  if (cachedPkg) return cachedPkg;
+
+  try {
+    const pkgPath = join(__dirname, '../package.json');
+    const pkgContent = readFileSync(pkgPath, 'utf-8');
+    cachedPkg = JSON.parse(pkgContent);
+    return cachedPkg!;
+  } catch {
+    // Fallback if package.json not found
+    return {
+      name: 'design-constraint-validator',
+      version: '2.0.0',
+      homepage: 'https://github.com/CseperkePapp/design-constraint-validator'
+    };
+  }
+}
+
+/**
+ * Print DCV version banner
+ * Shows: DCV v{version} | {repo_url}
+ */
+export function printVersionBanner(options?: { quiet?: boolean }): void {
+  if (options?.quiet) return;
+
+  const pkg = getPackageInfo();
+  const repoUrl = pkg.homepage || 'https://github.com/CseperkePapp/design-constraint-validator';
+
+  console.log(`\x1b[2m${pkg.name} v${pkg.version} | ${repoUrl}\x1b[0m`);
+}
+
+/**
+ * Get version string for JSON output
+ */
+export function getVersionInfo(): { name: string; version: string; repository: string } {
+  const pkg = getPackageInfo();
+  return {
+    name: pkg.name,
+    version: pkg.version,
+    repository: pkg.homepage || 'https://github.com/CseperkePapp/design-constraint-validator'
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "design-constraint-validator",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "description": "Mathematical constraint validator for design systems — ensuring consistency, accessibility, and logical coherence",
   "type": "module",
   "engines": {

package/cli/constraints-loader.d.ts

@@ -1,30 +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 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 declare function attachRuntimeConstraints(engine: Engine, opts: AttachRuntimeOpts): void;
-export {};
-//# sourceMappingURL=constraints-loader.d.ts.map

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