@urbicon-ui/design-engine 6.1.8

package/README.md

@@ -0,0 +1,36 @@
+# @urbicon-ui/design-engine
+
+The deterministic core of the Urbicon UI **design loop** — extracted from
+`@urbicon-ui/mcp-server` so one engine can back the MCP server, a CLI, and editor
+hooks alike.
+
+**Zero runtime dependencies.** Pure TypeScript over Web/Node built-ins; no framework,
+no parser, no third-party packages.
+
+## Modules
+
+Each module is independent and also available as a subpath export.
+
+| Import                               | What it does                                                                                                                                                                                                                                 | Question it answers                         |
+| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
+| `@urbicon-ui/design-engine/linter`   | Two-axis design linter: deterministic **correctness** rules (token whitelist, `dark:`/`focus:`, z-index, dynamic classes) + system-agnostic **slop-floor** heuristics (generic fonts, animated dimensions, grey-on-colour, touch targets, …) | _Is it correct — and does it look generic?_ |
+| `@urbicon-ui/design-engine/manifest` | Parse/edit `design.manifest.md` (product intent, token overrides, pattern usages, ADRs) + the validation-history ndjson; scan `data-design-pattern` markers                                                                                  | _What has this project decided?_            |
+| `@urbicon-ui/design-engine/rubric`   | The eight-criterion design-quality rubric                                                                                                                                                                                                    | _Is it good?_ (judged)                      |
+
+The package root (`@urbicon-ui/design-engine`) re-exports all three.
+
+```ts
+import { lintDesign } from '@urbicon-ui/design-engine/linter';
+import { parseManifest, scanMarkers } from '@urbicon-ui/design-engine/manifest';
+import { RUBRIC_CRITERIA, renderRubric } from '@urbicon-ui/design-engine/rubric';
+```
+
+## Notes
+
+- Shipped as TypeScript source (no build step), like the rest of the Urbicon UI
+  tooling — consume it with a TypeScript-aware runtime (Bun) or bundler.
+- The linter's token whitelist is drift-guarded against the real CSS sources via a
+  test; keep it in sync when foundation/semantic tokens change.
+
+See [docs/internal/DESIGN-MCP.md](../../docs/internal/DESIGN-MCP.md) (as-built design loop)
+and [DESIGN-MCP-V2.md](../../docs/internal/DESIGN-MCP-V2.md) (package-centric architecture).

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@urbicon-ui/design-engine",
+  "version": "6.1.8",
+  "description": "Deterministic design engine for Urbicon UI — the zero-dependency design linter, manifest parser and quality rubric that power the design loop (validate · context · judge).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://codeberg.org/urbicon/ui.git",
+    "directory": "packages/design-engine"
+  },
+  "homepage": "https://ui.urbicon.de",
+  "bugs": "https://codeberg.org/urbicon/ui/issues",
+  "keywords": [
+    "design-system",
+    "linter",
+    "design-tokens",
+    "urbicon-ui",
+    "ai"
+  ],
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./linter": "./src/linter/index.ts",
+    "./manifest": "./src/manifest/index.ts",
+    "./rubric": "./src/rubric/index.ts",
+    "./search": "./src/search/index.ts"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "echo 'no build needed — Bun runs TypeScript directly'",
+    "check": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@types/node": "^25.9.3",
+    "vitest": "^4.1.9"
+  },
+  "author": "Urbicon UI Team"
+}

package/src/index.ts

@@ -0,0 +1,23 @@
+/**
+ * `@urbicon-ui/design-engine` — the deterministic core of the Urbicon UI design loop.
+ *
+ * Zero runtime dependencies. Three independent modules, each also available as a
+ * subpath export (`@urbicon-ui/design-engine/{linter,manifest,rubric}`):
+ *
+ * - **linter**   — the engine behind `validate_design`: deterministic rules + the
+ *                  token whitelist + distribution heuristics ("is it correct?").
+ * - **manifest** — the persistent design-intent layer: parse/edit `design.manifest.md`
+ *                  and scan `data-design-pattern` markers ("what has this project decided?").
+ * - **rubric**   — the eight-criterion design-quality rubric ("is it good?", judged).
+ * - **search**   — the component-catalog schema, discovery ranker, and `llm.txt`
+ *                  section parser shared by the CLI's `find`/`get-component` and the
+ *                  MCP server's `find_components`/`get_component`.
+ *
+ * Extracted from `@urbicon-ui/mcp-server` so the same engine can back the MCP server,
+ * a CLI, and editor hooks. See docs/internal/DESIGN-MCP-V2.md.
+ */
+
+export * from './linter/index.js';
+export * from './manifest/index.js';
+export * from './rubric/index.js';
+export * from './search/index.js';