design-constraint-validator 1.0.0 → 2.0.1

package/core/why.ts

@@ -1,63 +1,63 @@
-import type { FlatToken } from "./flatten.js";
-
-export type WhyReport = {
-  id: string;
-  value: string | number | undefined;
-  raw?: string | number;
-  refs?: string[];
-  provenance: "base" | "theme" | "override" | "unknown";
-  dependsOn: string[];     // immediate refs (parents)
-  dependents: string[];    // immediate children
-  chain?: string[];        // simple linear chain if raw is a single {ref} repeated
-};
-
-export function makeReverseEdges(edges: Array<[string,string]>): Map<string, Set<string>> {
-  const rev = new Map<string, Set<string>>();
-  for (const [from, to] of edges) {
-    if (!rev.has(to)) rev.set(to, new Set());
-    rev.get(to)!.add(from);
-    if (!rev.has(from)) rev.set(from, new Set());
-  }
-  return rev;
-}
-
-export function explain(
-  id: string,
-  flat: Record<string, FlatToken>,
-  edges: Array<[string,string]>,
-  layers: { overrides?: Record<string, unknown>, theme?: Record<string, unknown> } = {}
-): WhyReport {
-  const node = flat[id];
-  const rev = makeReverseEdges(edges);
-  const dependsOn = Array.from(rev.get(id) ?? []);
-  const dependents = edges.filter(([from, _to]) => from === id).map(([_, to]) => to);
-
-  const prov: WhyReport["provenance"] =
-    layers.overrides && id in layers.overrides ? "override" :
-    layers.theme     && id in layers.theme     ? "theme"    :
-    flat[id] ? "base" : "unknown";
-
-  // Try to produce a simple chain if it's a 1→1 alias chain
-  const chain: string[] = [id];
-  let cursor = id; let guard = 0;
-  while (guard++ < 32) {
-    const f = flat[cursor];
-    if (!f || !Array.isArray(f.refs) || f.refs.length !== 1) break;
-    const next = f.refs[0];
-    chain.push(next);
-    cursor = next;
-    const nxt = flat[next];
-    if (!nxt || !nxt.refs?.length) break;
-  }
-
-  return {
-    id,
-    value: node?.value,
-    raw: node?.raw,
-    refs: node?.refs,
-    provenance: prov,
-    dependsOn,
-    dependents,
-    chain: chain.length > 1 ? chain : undefined
-  };
-}
+import type { FlatToken } from "./flatten.js";
+
+export type WhyReport = {
+  id: string;
+  value: string | number | undefined;
+  raw?: string | number;
+  refs?: string[];
+  provenance: "base" | "theme" | "override" | "unknown";
+  dependsOn: string[];     // immediate refs (parents)
+  dependents: string[];    // immediate children
+  chain?: string[];        // simple linear chain if raw is a single {ref} repeated
+};
+
+export function makeReverseEdges(edges: Array<[string,string]>): Map<string, Set<string>> {
+  const rev = new Map<string, Set<string>>();
+  for (const [from, to] of edges) {
+    if (!rev.has(to)) rev.set(to, new Set());
+    rev.get(to)!.add(from);
+    if (!rev.has(from)) rev.set(from, new Set());
+  }
+  return rev;
+}
+
+export function explain(
+  id: string,
+  flat: Record<string, FlatToken>,
+  edges: Array<[string,string]>,
+  layers: { overrides?: Record<string, unknown>, theme?: Record<string, unknown> } = {}
+): WhyReport {
+  const node = flat[id];
+  const rev = makeReverseEdges(edges);
+  const dependsOn = Array.from(rev.get(id) ?? []);
+  const dependents = edges.filter(([from, _to]) => from === id).map(([_, to]) => to);
+
+  const prov: WhyReport["provenance"] =
+    layers.overrides && id in layers.overrides ? "override" :
+    layers.theme     && id in layers.theme     ? "theme"    :
+    flat[id] ? "base" : "unknown";
+
+  // Try to produce a simple chain if it's a 1→1 alias chain
+  const chain: string[] = [id];
+  let cursor = id; let guard = 0;
+  while (guard++ < 32) {
+    const f = flat[cursor];
+    if (!f || !Array.isArray(f.refs) || f.refs.length !== 1) break;
+    const next = f.refs[0];
+    chain.push(next);
+    cursor = next;
+    const nxt = flat[next];
+    if (!nxt || !nxt.refs?.length) break;
+  }
+
+  return {
+    id,
+    value: node?.value,
+    raw: node?.raw,
+    refs: node?.refs,
+    provenance: prov,
+    dependsOn,
+    dependents,
+    chain: chain.length > 1 ? chain : undefined
+  };
+}

package/package.json

@@ -1,90 +1,96 @@
-{
-  "name": "design-constraint-validator",
-  "version": "1.0.0",
-  "description": "Mathematical constraint validator for design systems — ensuring consistency, accessibility, and logical coherence",
-  "type": "module",
-  "engines": {
-    "node": ">=18"
-  },
-  "main": "core/index.js",
-  "types": "core/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./core/index.d.ts",
-      "import": "./core/index.js"
-    },
-    "./core/*": "./core/*",
-    "./cli/*": "./cli/*"
-  },
-  "bin": {
-    "dcv": "./cli/index.js",
-    "design-constraint-validator": "./cli/index.js"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "build": "tsc",
-    "lint": "eslint . --ext .js,.ts,.mjs,.cjs",
-    "format": "prettier -w .",
-    "check": "npm run typecheck && npm run lint && npm test",
-    "prepublishOnly": "npm run check && npm run build",
-    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
-    "release:notes": "npm run changelog && git add CHANGELOG.md && git commit -m \"docs(changelog): update\"",
-    "release:patch": "npm version patch && git push && git push --tags && echo '\n⚠️  Now run: npm publish'",
-    "release:minor": "npm version minor && git push && git push --tags && echo '\n⚠️  Now run: npm publish'",
-    "release:major": "npm version major && git push && git push --tags && echo '\n⚠️  Now run: npm publish'"
-  },
-  "keywords": [
-    "design-constraints",
-    "design-systems",
-    "constraint-validation",
-    "design-tokens",
-    "accessibility",
-    "wcag",
-    "mathematical-validation",
-    "typography",
-    "color",
-    "monotonicity",
-    "cli-tool"
-  ],
-  "author": "Cseperke Papp",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/CseperkePapp/design-constraint-validator.git"
-  },
-  "bugs": {
-    "url": "https://github.com/CseperkePapp/design-constraint-validator/issues"
-  },
-  "homepage": "https://github.com/CseperkePapp/design-constraint-validator#readme",
-  "dependencies": {
-    "yargs": "^17.0.0",
-    "zod": "^3.0.0",
-    "fast-glob": "^3.3.2"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/yargs": "^17.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
-    "eslint": "^9.0.0",
-    "eslint-config-prettier": "^9.0.0",
-    "prettier": "^3.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^3.0.0",
-    "conventional-changelog-cli": "^2.2.2"
-  },
-  "files": [
-    "adapters",
-    
-    "dist",
-    "cli",
-    "core",
-    "themes",
-    "tokens",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "design-constraint-validator",
+  "version": "2.0.1",
+  "description": "Mathematical constraint validator for design systems — ensuring consistency, accessibility, and logical coherence",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "core/index.js",
+  "types": "core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./core/index.d.ts",
+      "import": "./core/index.js"
+    },
+    "./core/*": "./core/*",
+    "./cli/*": "./cli/*"
+  },
+  "bin": {
+    "dcv": "./cli/index.js",
+    "design-constraint-validator": "./cli/index.js"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "lint": "eslint . --ext .js,.ts,.mjs,.cjs",
+    "format": "prettier -w .",
+    "check": "npm run typecheck && npm run lint && npm test",
+    "prepublishOnly": "npm run check && npm run build",
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
+    "release:notes": "npm run changelog && git add CHANGELOG.md && git commit -m \"docs(changelog): update\"",
+    "release:patch": "npm version patch && git push && git push --tags && echo '\n⚠️  Now run: npm publish'",
+    "release:minor": "npm version minor && git push && git push --tags && echo '\n⚠️  Now run: npm publish'",
+    "release:major": "npm version major && git push && git push --tags && echo '\n⚠️  Now run: npm publish'",
+    "demo": "cd ../designLab-DEMO && npm run dev",
+    "demo:build": "cd ../designLab-DEMO && npm run build",
+    "demo:v2": "cd designLab-v2 && npm run dev",
+    "demo:v2:build": "cd designLab-v2 && npm run build"
+  },
+  "keywords": [
+    "design-constraints",
+    "design-systems",
+    "constraint-validation",
+    "design-tokens",
+    "accessibility",
+    "wcag",
+    "mathematical-validation",
+    "typography",
+    "color",
+    "monotonicity",
+    "cli-tool"
+  ],
+  "author": "Cseperke Papp",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CseperkePapp/design-constraint-validator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/CseperkePapp/design-constraint-validator/issues"
+  },
+  "homepage": "https://github.com/CseperkePapp/design-constraint-validator#readme",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.2",
+    "yargs": "^17.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/yargs": "^17.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "conventional-changelog-cli": "^2.2.2",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "pdf-parse": "^2.4.5",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "cli/",
+    "core/",
+    "adapters/",
+    "themes/",
+    "LICENSE",
+    "README.md"
+  ]
+}

package/themes/color.lg.order.json

@@ -1,15 +1,15 @@
-{
-  "$description": "Color lightness hierarchy constraints - LG breakpoint specific",
-  "order": [
-    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
-    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
-    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
-
-    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
-    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
-    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
-    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
-
-    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
-  ]
-}
+{
+  "$description": "Color lightness hierarchy constraints - LG breakpoint specific",
+  "order": [
+    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
+    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
+    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
+
+    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
+    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
+    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
+    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
+
+    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
+  ]
+}

package/themes/color.md.order.json

@@ -1,15 +1,15 @@
-{
-  "$description": "Color lightness hierarchy constraints - MD breakpoint specific",
-  "order": [
-    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
-    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
-    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
-
-    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
-    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
-    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
-    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
-
-    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
-  ]
-}
+{
+  "$description": "Color lightness hierarchy constraints - MD breakpoint specific",
+  "order": [
+    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
+    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
+    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
+
+    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
+    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
+    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
+    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
+
+    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
+  ]
+}

package/themes/color.order.json

@@ -1,15 +1,15 @@
-{
-  "$description": "Color lightness hierarchy constraints - comprehensive brand and gray ladders with bridge constraints",
-  "order": [
-    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
-    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
-    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
-
-    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
-    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
-    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
-    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
-
-    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
-  ]
-}
+{
+  "$description": "Color lightness hierarchy constraints - comprehensive brand and gray ladders with bridge constraints",
+  "order": [
+    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
+    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
+    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
+
+    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
+    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
+    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
+    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
+
+    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
+  ]
+}

package/themes/color.sm.order.json

@@ -1,15 +1,15 @@
-{
-  "$description": "Color lightness hierarchy constraints - SM breakpoint specific",
-  "order": [
-    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
-    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
-    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
-
-    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
-    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
-    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
-    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
-
-    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
-  ]
-}
+{
+  "$description": "Color lightness hierarchy constraints - SM breakpoint specific",
+  "order": [
+    ["color.palette.brand.400", ">=", "color.palette.brand.500"],
+    ["color.palette.brand.500", ">=", "color.palette.brand.600"],
+    ["color.palette.brand.600", ">=", "color.palette.brand.700"],
+
+    ["color.palette.gray.300", ">=", "color.palette.gray.400"],
+    ["color.palette.gray.400", ">=", "color.palette.gray.500"],
+    ["color.palette.gray.500", ">=", "color.palette.gray.600"],
+    ["color.palette.gray.600", ">=", "color.palette.gray.900"],
+
+    ["color.palette.brand.600", ">=", "color.palette.gray.500"]
+  ]
+}

package/themes/cross-axis.rules.json

@@ -1,36 +1,36 @@
-{
-  "rules": [
-    {
-      "id": "body-weight-vs-size",
-      "level": "error",
-      "where": "Body legibility",
-      "when": { "id": "typography.weight.body", "op": "<=", "value": 400 },
-      "require": { "id": "typography.size.body", "op": ">=", "fallback": "16px" }
-    },
-    {
-      "id": "emphasis-weight-size-balance",
-      "level": "warn",
-      "where": "Legibility emphasis",
-      "when": { "id": "typography.weight.emphasis", "op": ">=", "value": 600 },
-      "require": { "id": "typography.size.body", "op": ">=", "fallback": "15px" }
-    },
-    {
-      "id": "heading-emphasis-h2",
-      "level": "warn",
-      "where": "Heading emphasis",
-      "compare": { "a": "typography.size.h2", "op": ">=", "b": "typography.size.body", "delta": "2px" }
-    },
-    {
-      "id": "heading-emphasis-h3",
-      "level": "warn",
-      "where": "Heading emphasis",
-      "compare": { "a": "typography.size.h3", "op": ">=", "b": "typography.size.body", "delta": "2px" }
-    },
-    {
-      "id": "layout-padding-vs-container",
-      "level": "warn",
-      "where": "Layout density",
-      "compare": { "a": "layout.padding.section", "op": "<=", "b": "layout.container.sm", "delta": "-560px" }
-    }
-  ]
+{
+  "rules": [
+    {
+      "id": "body-weight-vs-size",
+      "level": "error",
+      "where": "Body legibility",
+      "when": { "id": "typography.weight.body", "op": "<=", "value": 400 },
+      "require": { "id": "typography.size.body", "op": ">=", "fallback": "16px" }
+    },
+    {
+      "id": "emphasis-weight-size-balance",
+      "level": "warn",
+      "where": "Legibility emphasis",
+      "when": { "id": "typography.weight.emphasis", "op": ">=", "value": 600 },
+      "require": { "id": "typography.size.body", "op": ">=", "fallback": "15px" }
+    },
+    {
+      "id": "heading-emphasis-h2",
+      "level": "warn",
+      "where": "Heading emphasis",
+      "compare": { "a": "typography.size.h2", "op": ">=", "b": "typography.size.body", "delta": "2px" }
+    },
+    {
+      "id": "heading-emphasis-h3",
+      "level": "warn",
+      "where": "Heading emphasis",
+      "compare": { "a": "typography.size.h3", "op": ">=", "b": "typography.size.body", "delta": "2px" }
+    },
+    {
+      "id": "layout-padding-vs-container",
+      "level": "warn",
+      "where": "Layout density",
+      "compare": { "a": "layout.padding.section", "op": "<=", "b": "layout.container.sm", "delta": "-560px" }
+    }
+  ]
 }

package/themes/cross-axis.sm.rules.json

@@ -1,12 +1,12 @@
-{
-  "rules": [
-    {
-      "id": "body-size-min-sm",
-      "bp": "sm",
-      "level": "warn",
-      "where": "Small screen legibility",
-      "when": { "id": "typography.size.body", "op": ">=", "value": 0 },
-      "require": { "id": "typography.size.body", "op": ">=", "fallback": "15px" }
-    }
-  ]
-}
+{
+  "rules": [
+    {
+      "id": "body-size-min-sm",
+      "bp": "sm",
+      "level": "warn",
+      "where": "Small screen legibility",
+      "when": { "id": "typography.size.body", "op": ">=", "value": 0 },
+      "require": { "id": "typography.size.body", "op": ">=", "fallback": "15px" }
+    }
+  ]
+}

package/themes/layout.lg.order.json

@@ -1,18 +1,18 @@
-{
-  "$description": "Layout hierarchy order constraints - LG breakpoint specific",
-  "order": [
-    ["layout.container.xs", "<=", "layout.container.sm"],
-    ["layout.container.sm", "<=", "layout.container.md"],
-    ["layout.container.md", "<=", "layout.container.lg"],
-    ["layout.container.lg", "<=", "layout.container.xl"],
-
-    ["layout.padding.page", ">=", "layout.padding.section"],
-    ["layout.padding.section", ">=", "layout.padding.card"],
-    ["layout.padding.card", ">=", "layout.padding.chip"],
-
-    ["layout.grid.gutter", "<=", "layout.padding.section"],
-    ["layout.grid.gutter", "<=", "layout.padding.card"],
-
-    ["control.size.min", ">=", "layout.padding.card"]
-  ]
-}
+{
+  "$description": "Layout hierarchy order constraints - LG breakpoint specific",
+  "order": [
+    ["layout.container.xs", "<=", "layout.container.sm"],
+    ["layout.container.sm", "<=", "layout.container.md"],
+    ["layout.container.md", "<=", "layout.container.lg"],
+    ["layout.container.lg", "<=", "layout.container.xl"],
+
+    ["layout.padding.page", ">=", "layout.padding.section"],
+    ["layout.padding.section", ">=", "layout.padding.card"],
+    ["layout.padding.card", ">=", "layout.padding.chip"],
+
+    ["layout.grid.gutter", "<=", "layout.padding.section"],
+    ["layout.grid.gutter", "<=", "layout.padding.card"],
+
+    ["control.size.min", ">=", "layout.padding.card"]
+  ]
+}

package/themes/layout.md.order.json

@@ -1,18 +1,18 @@
-{
-  "$description": "Layout hierarchy order constraints - MD breakpoint specific",
-  "order": [
-    ["layout.container.xs", "<=", "layout.container.sm"],
-    ["layout.container.sm", "<=", "layout.container.md"],
-    ["layout.container.md", "<=", "layout.container.lg"],
-    ["layout.container.lg", "<=", "layout.container.xl"],
-
-    ["layout.padding.page", ">=", "layout.padding.section"],
-    ["layout.padding.section", ">=", "layout.padding.card"],
-    ["layout.padding.card", ">=", "layout.padding.chip"],
-
-    ["layout.grid.gutter", "<=", "layout.padding.section"],
-    ["layout.grid.gutter", "<=", "layout.padding.card"],
-
-    ["control.size.min", ">=", "layout.padding.card"]
-  ]
-}
+{
+  "$description": "Layout hierarchy order constraints - MD breakpoint specific",
+  "order": [
+    ["layout.container.xs", "<=", "layout.container.sm"],
+    ["layout.container.sm", "<=", "layout.container.md"],
+    ["layout.container.md", "<=", "layout.container.lg"],
+    ["layout.container.lg", "<=", "layout.container.xl"],
+
+    ["layout.padding.page", ">=", "layout.padding.section"],
+    ["layout.padding.section", ">=", "layout.padding.card"],
+    ["layout.padding.card", ">=", "layout.padding.chip"],
+
+    ["layout.grid.gutter", "<=", "layout.padding.section"],
+    ["layout.grid.gutter", "<=", "layout.padding.card"],
+
+    ["control.size.min", ">=", "layout.padding.card"]
+  ]
+}