@origostudio/origo-design 0.0.0

package/packages/core/src/validator/serializer.ts

@@ -0,0 +1,120 @@
+import { CanonicalAST } from '../types/ast';
+import { validateAST, MAX_AST_DEPTH } from './ast-validator';
+import { ValidationError } from '../types/validation';
+
+/**
+ * Deep clones and canonically sorts an object/array.
+ * Also detects circular references and unsupported types.
+ */
+function canonicalize(
+  obj: unknown,
+  seen = new WeakSet(),
+  errors: ValidationError[] = [],
+  depth = 1
+): unknown {
+  if (depth > MAX_AST_DEPTH) {
+    errors.push({
+      type: 'MAX_DEPTH_EXCEEDED',
+      message: `Maximum AST depth exceeded (${MAX_AST_DEPTH}) during canonicalization`,
+    });
+    return null;
+  }
+
+  if (obj === null || typeof obj !== 'object') {
+    return obj;
+  }
+
+  if (seen.has(obj)) {
+    errors.push({
+      type: 'CIRCULAR_REFERENCE',
+      message: 'Invalid AST: Circular reference detected during canonicalization',
+    });
+    return null;
+  }
+
+  if (Object.prototype.toString.call(obj) !== '[object Object]' && !Array.isArray(obj)) {
+    errors.push({
+      type: 'INVALID_TYPE',
+      message: `Invalid AST: Unsupported type ${obj.constructor?.name || typeof obj}`,
+    });
+    return null;
+  }
+
+  seen.add(obj);
+
+  if (Array.isArray(obj)) {
+    // Process children first
+    const mapped = obj.map(item => canonicalize(item, seen, errors, depth + 1));
+
+    // Sort deterministically
+    mapped.sort((a, b) => {
+      const aIsObj = typeof a === 'object' && a !== null;
+      const bIsObj = typeof b === 'object' && b !== null;
+
+      if (aIsObj && bIsObj) {
+        if ('id' in a && 'id' in b) {
+          const idA = String(a.id);
+          const idB = String(b.id);
+          return idA < idB ? -1 : idA > idB ? 1 : 0;
+        }
+        if ('name' in a && 'name' in b) {
+          const nameA = String(a.name);
+          const nameB = String(b.name);
+          return nameA < nameB ? -1 : nameA > nameB ? 1 : 0;
+        }
+      }
+
+      // Fallback for primitives, heterogeneous objects, or objects without id/name
+      const strA = JSON.stringify(a);
+      const strB = JSON.stringify(b);
+      return strA < strB ? -1 : strA > strB ? 1 : 0;
+    });
+
+    seen.delete(obj);
+    return mapped;
+  }
+
+  // It is an object, sort its keys
+  const objAsRecord = obj as Record<string, unknown>;
+  const sortedKeys = Object.keys(objAsRecord).sort();
+  const result: Record<string, unknown> = {};
+  for (const key of sortedKeys) {
+    result[key] = canonicalize(objAsRecord[key], seen, errors, depth + 1);
+  }
+
+  seen.delete(obj);
+  return result;
+}
+
+/**
+ * Serializes the parsed memory model into a canonical JSON AST.
+ * Enforces `schemaVersion`, stable key ordering, and stable array ordering.
+ *
+ * @param ast The canonical AST to serialize
+ * @returns Byte-for-byte deterministic JSON string
+ * @throws {ASTValidationError} If validation or canonicalization fails
+ */
+export function serializeAST(ast: CanonicalAST): [string | null, ValidationError[]] {
+  if (!ast || !ast.schemaVersion) {
+    return [null, [{ type: 'INVALID_FORMAT', message: 'Invalid AST: Missing schemaVersion' }]];
+  }
+
+  if (!Array.isArray(ast.domains)) {
+    return [null, [{ type: 'INVALID_FORMAT', message: 'Invalid AST: domains must be an array' }]];
+  }
+
+  // Validate semantics before serializing
+  const errors = validateAST(ast);
+  if (errors.length > 0) {
+    return [null, errors];
+  }
+
+  const canonicalErrors: ValidationError[] = [];
+  const canonical = canonicalize(ast, new WeakSet(), canonicalErrors, 1);
+
+  if (canonicalErrors.length > 0) {
+    return [null, canonicalErrors];
+  }
+
+  return [JSON.stringify(canonical), []];
+}

package/packages/core/test/fixtures/target-page.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": "1.0.0",
+  "domains": [
+    {
+      "id": "domain-core",
+      "name": "Core System",
+      "version": "1.0.0",
+      "domain": "core",
+      "contracts": [
+        {
+          "id": "contract-viewable",
+          "name": "Viewable",
+          "description": "Can be viewed",
+          "requiredFields": [{ "name": "title", "type": "string" }],
+          "requiredCapabilities": [{ "name": "read", "type": "read" }]
+        }
+      ],
+      "entities": [
+        {
+          "id": "entity-page",
+          "name": "Page",
+          "fields": [
+            {
+              "id": "field-title",
+              "name": "title",
+              "type": "string",
+              "label": "Title",
+              "validation": [],
+              "metadata_path": "page.title"
+            },
+            {
+              "id": "field-author",
+              "name": "author",
+              "type": "string",
+              "references": "entity-user",
+              "label": "Author",
+              "validation": [],
+              "metadata_path": "page.author"
+            }
+          ],
+          "implements": ["contract-viewable"]
+        },
+        {
+          "id": "entity-user",
+          "name": "User",
+          "fields": [
+            {
+              "id": "field-username",
+              "name": "username",
+              "type": "string",
+              "label": "Username",
+              "validation": [],
+              "metadata_path": "user.username"
+            }
+          ]
+        }
+      ],
+      "capabilities": [
+        {
+          "id": "cap-read-page",
+          "name": "read",
+          "type": "read",
+          "entityId": "entity-page",
+          "permissions": [{ "role": "viewer", "access": "grant" }]
+        },
+        {
+          "id": "cap-edit-page",
+          "name": "update",
+          "type": "update",
+          "entityId": "entity-page",
+          "permissions": [
+            { "role": "editor", "access": "grant" },
+            { "role": "guest", "access": "deny" }
+          ]
+        }
+      ],
+      "extensions": [
+        {
+          "id": "ext-seo-metadata",
+          "name": "seo-plugin",
+          "plugin_version_range": "^1.0.0",
+          "implements": ["contract-viewable"]
+        }
+      ]
+    }
+  ]
+}

package/packages/design-tokens/CHANGELOG.md

@@ -0,0 +1,273 @@
+## 0.0.22 (2026-09-04)
+
+### 🚀 Features
+
+- scaffold playground application and e2e testing suite with initial editor component and schema registry ([f097894](https://github.com/OrigoStudio/origo-design/commit/f097894))
+- add GitHub Actions workflow to automate library releases using Nx Release ([3d6651f](https://github.com/OrigoStudio/origo-design/commit/3d6651f))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.21 (2026-09-02)
+
+### 🚀 Features
+
+- add centralized test registry tool with validation logic, CI integration, and documentation artifacts ([384c1c7](https://github.com/OrigoStudio/origo-design/commit/384c1c7))
+- implement central test registry with validation tools and CI integration ([02cf656](https://github.com/OrigoStudio/origo-design/commit/02cf656))
+- initialize negative testing story and update sprint status tracking ([bbe5fdc](https://github.com/OrigoStudio/origo-design/commit/bbe5fdc))
+- implement CLI framework with validation, testing, and CI/CD workflows ([ff6ce55](https://github.com/OrigoStudio/origo-design/commit/ff6ce55))
+- implement validate command and schema validation logic for BADL files ([4f9e41d](https://github.com/OrigoStudio/origo-design/commit/4f9e41d))
+- implement path traversal guards, remove process termination from library logic, and enable error cause preservation in @origo/cli ([0854f78](https://github.com/OrigoStudio/origo-design/commit/0854f78))
+- initialize web-based editor component and track security remediation tasks in implementation artifacts ([65716bd](https://github.com/OrigoStudio/origo-design/commit/65716bd))
+- document e2e npm verification plan for cli package releases ([22dab4c](https://github.com/OrigoStudio/origo-design/commit/22dab4c))
+- initialize sprint status tracking and retrospective verification story for npm packaging ([c326751](https://github.com/OrigoStudio/origo-design/commit/c326751))
+- add generated bundle for epic7-worker-csp spike ([16ca492](https://github.com/OrigoStudio/origo-design/commit/16ca492))
+- add web worker CSP spike and associated implementation documentation ([ebf5aa4](https://github.com/OrigoStudio/origo-design/commit/ebf5aa4))
+- implement web worker CSP spike with supporting documentation and harness tools ([f57b1e5](https://github.com/OrigoStudio/origo-design/commit/f57b1e5))
+- add technical spike story for Epic 7 web worker CSP validation and ADR planning ([c977487](https://github.com/OrigoStudio/origo-design/commit/c977487))
+- initialize sprint status tracking and create Epic 7 discovery research story ([b37b967](https://github.com/OrigoStudio/origo-design/commit/b37b967))
+- implement entity generator command with template customization and ejection support ([02a3193](https://github.com/OrigoStudio/origo-design/commit/02a3193))
+- implement entity generator command and template ejection logic in CLI ([d7d519a](https://github.com/OrigoStudio/origo-design/commit/d7d519a))
+- implementation of 6-2-local-schema-validation ([45e67f6](https://github.com/OrigoStudio/origo-design/commit/45e67f6))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.20 (2026-08-25)
+
+### 🚀 Features
+
+- implementation of 6-1-cli-initialization-and-scaffolding ([f6aca9e](https://github.com/OrigoStudio/origo-design/commit/f6aca9e))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.19 (2026-08-23)
+
+### 🚀 Features
+
+- 5.5-5-define-secure-by-default-boilerplate-templates ([0eb6dde](https://github.com/OrigoStudio/origo-design/commit/0eb6dde))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.18 (2026-08-23)
+
+### 🚀 Features
+
+- 5.5-4-verify-core-compiler-source-map-preservation ([a3b0d9b](https://github.com/OrigoStudio/origo-design/commit/a3b0d9b))
+
+### 🩹 Fixes
+
+- pipeline issue ([c1bbe47](https://github.com/OrigoStudio/origo-design/commit/c1bbe47))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.17 (2026-08-21)
+
+### 🚀 Features
+
+- 5.5-3-resolve-recursive-schema-resolution-tech-debt ([943e2e7](https://github.com/OrigoStudio/origo-design/commit/943e2e7))
+- 5.5-2-establish-end-to-end-qa-protocols ([d8990ae](https://github.com/OrigoStudio/origo-design/commit/d8990ae))
+- 5.5-2-establish-end-to-end-qa-protocols ([a31d97a](https://github.com/OrigoStudio/origo-design/commit/a31d97a))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.16 (2026-08-21)
+
+### 🚀 Features
+
+- 5.5-1-create-usability-quickstart-guide ([e740a1a](https://github.com/OrigoStudio/origo-design/commit/e740a1a))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.15 (2026-08-20)
+
+### 🚀 Features
+
+- code-review 5-5-reactive-state-event-binding ([b235951](https://github.com/OrigoStudio/origo-design/commit/b235951))
+- implementation of 5-5-reactive-state-event-binding ([3a5948a](https://github.com/OrigoStudio/origo-design/commit/3a5948a))
+- story creation 5-5-reactive-state-event-binding ([21104c6](https://github.com/OrigoStudio/origo-design/commit/21104c6))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.14 (2026-08-19)
+
+### 🚀 Features
+
+- 5-4-design-token-consumption ([c1f64ed](https://github.com/OrigoStudio/origo-design/commit/c1f64ed))
+- add sprint status update and design token consumption story documentation ([49aec07](https://github.com/OrigoStudio/origo-design/commit/49aec07))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.13 (2026-08-18)
+
+### 🚀 Features
+
+- implement core primitives (Button, VBox, TextInput) with improved property coercion and accessibility support ([1be1def](https://github.com/OrigoStudio/origo-design/commit/1be1def))
+- implement VBox, TextInput, and Button core primitives with accessibility testing and improved adapter coercion ([532417f](https://github.com/OrigoStudio/origo-design/commit/532417f))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.12 (2026-08-17)
+
+### 🚀 Features
+
+- implement InteractionContract-based OrigoAdapter and transition angular-renderer architecture to web adapter pattern ([1a8ea32](https://github.com/OrigoStudio/origo-design/commit/1a8ea32))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.11 (2026-08-14)
+
+### 🚀 Features
+
+- implement angular-renderer package with AST-based dynamic component instantiation and registry support ([500f396](https://github.com/OrigoStudio/origo-design/commit/500f396))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.10 (2026-08-14)
+
+### 🚀 Features
+
+- implement extension API scaffolding, define Angular signals patterns, and add renderer test utilities ([d2adbed](https://github.com/OrigoStudio/origo-design/commit/d2adbed))
+- mark Epic 4 as complete and record its retrospective action items in sprint status ([37c2caa](https://github.com/OrigoStudio/origo-design/commit/37c2caa))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.9 (2026-08-14)
+
+### 🚀 Features
+
+- implement extension manager with manifest validation, permission security, and dependency resolution ([154b0d4](https://github.com/OrigoStudio/origo-design/commit/154b0d4))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.8 (2026-08-14)
+
+### 🚀 Features
+
+- implement formal extension manifest, capability negotiation, and lifecycle management in core extension-api ([808f113](https://github.com/OrigoStudio/origo-design/commit/808f113))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.7 (2026-08-14)
+
+### 🚀 Features
+
+- implement behavior validation test suite and expand AST validator test coverage ([d4c79ef](https://github.com/OrigoStudio/origo-design/commit/d4c79ef))
+- register behavior validation suite story and update sprint status tracking ([798ec74](https://github.com/OrigoStudio/origo-design/commit/798ec74))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.6 (2026-08-13)
+
+### 🚀 Features
+
+- implement AST validation engine with support for circular dependency detection and reference integrity checks ([afd48c9](https://github.com/OrigoStudio/origo-design/commit/afd48c9))
+- initialize sprint-status.yaml to track project development and retrospective action items ([66c6cdf](https://github.com/OrigoStudio/origo-design/commit/66c6cdf))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.5 (2026-08-13)
+
+### 🚀 Features
+
+- **core:** implement security and permissions engine ([d066d90](https://github.com/OrigoStudio/origo-design/commit/d066d90))
+- add story 4.3 for security and permissions engine and update sprint status ([3eb4aae](https://github.com/OrigoStudio/origo-design/commit/3eb4aae))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.4 (2026-08-13)
+
+### 🚀 Features
+
+- implement semantic AST validator with domain, entity, and contract schema definitions ([e969466](https://github.com/OrigoStudio/origo-design/commit/e969466))
+- update sprint status and initialize story 4-2 contracts and implementations documentation ([4b37c59](https://github.com/OrigoStudio/origo-design/commit/4b37c59))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.3 (2026-08-13)
+
+### 🚀 Features
+
+- 4-1-capabilities-schema-parsing ([869c872](https://github.com/OrigoStudio/origo-design/commit/869c872))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
+## 0.0.2 (2026-08-12)
+
+### 🚀 Features
+
+- implement defensive AST validation with depth limiting, circular reference detection, and graceful error reporting ([d2f5f98](https://github.com/OrigoStudio/origo-design/commit/d2f5f98))
+- initialize 3-5-3-defensive-ast-traversal story and update sprint status ([4f82702](https://github.com/OrigoStudio/origo-design/commit/4f82702))
+- enforce JSON import standard and document AST validator ([162db09](https://github.com/OrigoStudio/origo-design/commit/162db09))
+- implement automated semantic versioning with Nx release and commitlint enforcement ([5e7a25e](https://github.com/OrigoStudio/origo-design/commit/5e7a25e))
+- implement AST validation engine and documentation for semantic versioning workflow ([838e472](https://github.com/OrigoStudio/origo-design/commit/838e472))
+- implement AST validation engine and associated implementation artifacts ([49cbdf0](https://github.com/OrigoStudio/origo-design/commit/49cbdf0))
+- implement deterministic canonical AST serialization and interfaces in @origo/core ([c35a2c9](https://github.com/OrigoStudio/origo-design/commit/c35a2c9))
+- implement domain and entity schema parser with Ajv-based validation and circular dependency detection in new @origo/core package ([4165b5f](https://github.com/OrigoStudio/origo-design/commit/4165b5f))
+- add design tokens documentation and update Starlight navigation configuration ([ba2404a](https://github.com/OrigoStudio/origo-design/commit/ba2404a))
+- initialize Epic 3 planning and document Epic 2 retrospective findings ([4cc46f9](https://github.com/OrigoStudio/origo-design/commit/4cc46f9))
+- implement runtime theme fetching, injection, and Angular renderer integration to complete the token resolution contract ([87f583e](https://github.com/OrigoStudio/origo-design/commit/87f583e))
+- implement theme-fetcher runtime utility and create angular-renderer package with theme initialization provider ([1d5b7ab](https://github.com/OrigoStudio/origo-design/commit/1d5b7ab))
+- implement secure theme injection with CSS token validation and scope management ([a708825](https://github.com/OrigoStudio/origo-design/commit/a708825))
+- implement runtime theme injector for parsing and applying CSS variables ([969fed5](https://github.com/OrigoStudio/origo-design/commit/969fed5))
+- add astro, @astrojs/starlight, and sharp dependencies to package.json ([1c40a92](https://github.com/OrigoStudio/origo-design/commit/1c40a92))
+- implement design token compilation pipeline with CSS variable parsing and generation ([0ffe822](https://github.com/OrigoStudio/origo-design/commit/0ffe822))
+- **nx-cloud:** setup nx cloud workspace ([ee09042](https://github.com/OrigoStudio/origo-design/commit/ee09042))
+- **design-tokens:** implement css compilation pipeline ([7bd632d](https://github.com/OrigoStudio/origo-design/commit/7bd632d))
+- add script to generate automated LLM review prompts from git diffs ([1ddbd39](https://github.com/OrigoStudio/origo-design/commit/1ddbd39))
+- scaffold @origo/design-tokens package with JSON schema validation and Nx configuration ([ae61244](https://github.com/OrigoStudio/origo-design/commit/ae61244))
+- scaffold @origo/design-tokens library with JSON schema validation and initial token definitions ([efbecc9](https://github.com/OrigoStudio/origo-design/commit/efbecc9))
+- initialize Astro documentation site and relocate internal project scripts to the tools directory. ([1cd8e71](https://github.com/OrigoStudio/origo-design/commit/1cd8e71))
+- add documentation story spec and update epic-1 status to done ([b612ea3](https://github.com/OrigoStudio/origo-design/commit/b612ea3))
+- initialize and populate agent skill definitions, workflows, and technical knowledge resources ([8668c52](https://github.com/OrigoStudio/origo-design/commit/8668c52))
+- initialize Starlight documentation site within the monorepo and add benchmark tools ([9a16b03](https://github.com/OrigoStudio/origo-design/commit/9a16b03))
+- implement performance benchmark harness with regression and SLA gate logic ([350d472](https://github.com/OrigoStudio/origo-design/commit/350d472))
+- implement performance benchmark harness with CI regression gating and SLA validation ([3230ac9](https://github.com/OrigoStudio/origo-design/commit/3230ac9))
+- implement Husky pre-commit hooks and Nx-based lint-staged configuration ([9181885](https://github.com/OrigoStudio/origo-design/commit/9181885))
+- add GitHub Actions CI workflow, Husky pre-commit hooks, and update package.json with necessary configuration ([95b8bf1](https://github.com/OrigoStudio/origo-design/commit/95b8bf1))
+- configure Husky, lint-staged, and GitHub CI workflow for automated quality enforcement ([b6bf597](https://github.com/OrigoStudio/origo-design/commit/b6bf597))
+- initialize Nx monorepo workspace with core configuration and tooling ([fd0665a](https://github.com/OrigoStudio/origo-design/commit/fd0665a))
+- add sprint tracking artifacts and automation script for project bootstrapping ([ddc6149](https://github.com/OrigoStudio/origo-design/commit/ddc6149))
+- document Origo Design functional requirements and architectural scope ([d1e0b7f](https://github.com/OrigoStudio/origo-design/commit/d1e0b7f))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse

package/packages/design-tokens/README.md

@@ -0,0 +1,11 @@
+# design-tokens
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build design-tokens` to build the library.
+
+## Running unit tests
+
+Run `nx test design-tokens` to execute the unit tests via [Jest](https://jestjs.io).

package/packages/design-tokens/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@origo/design-tokens",
+  "version": "0.0.22",
+  "private": false,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./runtime": {
+      "types": "./src/runtime/index.d.ts",
+      "default": "./src/runtime/index.js"
+    },
+    "./tokens.css": "./tokens.css",
+    "./tokens.json": "./tokens.json",
+    "./tokens.js": "./tokens.js"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0"
+  },
+  "devDependencies": {}
+}

package/packages/design-tokens/src/build.ts

@@ -0,0 +1,97 @@
+export function parseTokens(
+  tokens: Record<string, unknown>,
+  prefix: string
+): Record<string, string> {
+  const result: Record<string, string> = {};
+
+  function traverse(obj: unknown, currentPath: string[]) {
+    if (!obj || typeof obj !== 'object') return;
+    for (const [key, value] of Object.entries(obj)) {
+      if (value && typeof value === 'object' && !Array.isArray(value)) {
+        if ('$value' in value) {
+          const sanitizedPath = currentPath.concat(key).map(k => k.replace(/[^a-zA-Z0-9-]/g, '-'));
+          const varName = `--${prefix}-${sanitizedPath.join('-')}`;
+
+          const tokenObj = value as Record<string, unknown>;
+          const val = tokenObj['$value'];
+          let valStr: string;
+
+          if (Array.isArray(val)) {
+            valStr = val.join(', ');
+          } else if (typeof val === 'object' && val !== null) {
+            valStr = JSON.stringify(val);
+          } else {
+            valStr = String(val);
+          }
+
+          result[varName] = valStr;
+        } else {
+          traverse(value, currentPath.concat(key));
+        }
+      }
+    }
+  }
+
+  traverse(tokens, []);
+
+  let changed = true;
+  let iterations = 0;
+  const maxIterations = 10;
+
+  while (changed && iterations < maxIterations) {
+    changed = false;
+    iterations++;
+    for (const [key, val] of Object.entries(result)) {
+      if (typeof val === 'string' && val.includes('{')) {
+        const newVal = val.replace(/\{([^}]+)\}/g, (match, refPath) => {
+          if (!refPath.trim()) throw new Error('Empty reference in token');
+          const sanitizedRefPath = refPath
+            .split('.')
+            .map((k: string) => k.replace(/[^a-zA-Z0-9-]/g, '-'))
+            .join('-');
+          const refVarName = `--${prefix}-${sanitizedRefPath}`;
+          if (refVarName === key) throw new Error(`Circular reference detected: ${key}`);
+          return `var(${refVarName})`;
+        });
+        if (newVal !== val) {
+          result[key] = newVal;
+          changed = true;
+        }
+      }
+    }
+  }
+
+  return result;
+}
+
+export function generateCssVariables(
+  baseTokensMap: Record<string, string>,
+  semanticTokensMap?: Record<string, string>
+): string {
+  let css = ':root{';
+
+  const usedBaseTokens = new Set<string>();
+  if (semanticTokensMap) {
+    for (const val of Object.values(semanticTokensMap)) {
+      const matches = val.match(/var\((--[^)]+)\)/g);
+      if (matches) {
+        matches.forEach(m => usedBaseTokens.add(m.slice(4, -1)));
+      }
+    }
+  }
+
+  for (const [key, value] of Object.entries(baseTokensMap)) {
+    if (!semanticTokensMap || usedBaseTokens.has(key)) {
+      css += `${key}:${value};`;
+    }
+  }
+
+  if (semanticTokensMap) {
+    for (const [key, value] of Object.entries(semanticTokensMap)) {
+      css += `${key}:${value};`;
+    }
+  }
+
+  css += '}';
+  return css;
+}

package/packages/design-tokens/src/compile.ts

@@ -0,0 +1,60 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { parseTokens, generateCssVariables } from './build';
+import Ajv2020 from 'ajv/dist/2020';
+
+function loadJson(path: string): Record<string, unknown> {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch (e: unknown) {
+    throw new Error(`Failed to read or parse JSON at ${path}: ${(e as Error).message}`);
+  }
+}
+
+function main() {
+  const baseJsonPath = join(__dirname, 'tokens/base.json');
+  const semanticJsonPath = join(__dirname, 'tokens/semantic.json');
+  const baseSchemaPath = join(__dirname, 'schemas/base-tokens.schema.json');
+  const semanticSchemaPath = join(__dirname, 'schemas/semantic-tokens.schema.json');
+
+  const baseJson = loadJson(baseJsonPath);
+  const semanticJson = loadJson(semanticJsonPath);
+  const baseSchema = loadJson(baseSchemaPath);
+  const semanticSchema = loadJson(semanticSchemaPath);
+
+  const ajv = new Ajv2020({ allErrors: true, strict: false });
+  if (!ajv.validate(baseSchema, baseJson)) {
+    throw new Error(`Base tokens failed validation: ${ajv.errorsText()}`);
+  }
+  if (!ajv.validate(semanticSchema, semanticJson)) {
+    throw new Error(`Semantic tokens failed validation: ${ajv.errorsText()}`);
+  }
+
+  const baseTokens = parseTokens(baseJson, 'origo');
+  const semanticTokens = parseTokens(semanticJson, 'origo');
+
+  const css = generateCssVariables(baseTokens, semanticTokens);
+
+  const allTokens = { ...baseTokens, ...semanticTokens };
+
+  const outDir = join(__dirname, '..');
+  mkdirSync(outDir, { recursive: true });
+
+  // Write CSS
+  writeFileSync(join(outDir, 'tokens.css'), css, 'utf8');
+
+  // Write JSON
+  writeFileSync(join(outDir, 'tokens.json'), JSON.stringify(allTokens, null, 2), 'utf8');
+
+  // Write JS
+  const jsContent = `module.exports = ${JSON.stringify(allTokens, null, 2)};`;
+  writeFileSync(join(outDir, 'tokens.js'), jsContent, 'utf8');
+
+  // Write TS definitions
+  const tsContent = `declare const tokens: Record<string, string>;\nexport default tokens;`;
+  writeFileSync(join(outDir, 'tokens.d.ts'), tsContent, 'utf8');
+
+  console.log(`Successfully compiled design tokens to ${outDir}`);
+}
+
+main();