@hale-bopp/valentino-engine 1.0.0

package/AGENTS.md

@@ -0,0 +1,49 @@
+# Agents that use Valentino Engine
+
+## Direct MCP Integration
+
+| Agent | Level | How it uses Valentino Engine |
+|-------|-------|-----------------------------|
+| **Agent Valentino** | L3 | Primary consumer — validates page specs, audits CSS, runs probes |
+| **Agent Valentino Design** | L1 | CRO review — uses contrast checker, hero contract validation |
+| **Agent Scrummaster** | L2 | Sprint QA — runs `probe all` on changed page specs |
+| **Agent GEDI** | L1 | Architectural review — consulted by probes via escalation |
+
+## CLI Usage
+
+Any agent with shell access can invoke:
+
+```bash
+npx @hale-bopp/valentino audit <file.css>
+npx @hale-bopp/valentino probe all <spec.json>
+npx @hale-bopp/valentino contrast "#000" "#fff" AA
+```
+
+## MCP Configuration
+
+```json
+{
+  "mcp_servers": {
+    "valentino-engine": {
+      "command": "npx",
+      "args": ["@hale-bopp/valentino-engine", "mcp"]
+    }
+  }
+}
+```
+
+## 13 MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `valentino_audit_css` | Audit CSS for hardcoded px, hex/rgba, and named colors |
+| `valentino_validate_pagespec` | Validate PageSpecV1 contract |
+| `valentino_check_contrast` | WCAG 2.1 contrast ratio check |
+| `valentino_probe_rhythm` | Section sequence rhythm validation |
+| `valentino_probe_hero` | Hero contract enforcement |
+| `valentino_probe_integrity` | Per-type structural validation |
+| `valentino_probe_all` | All probes combined |
+| `valentino_resolve_catalog` | Resolve spec with catalog |
+| `valentino_resolve_route` | Resolve URL route to page ID |
+| `valentino_get_skill` | Get design skill rules |
+| `valentino_list_guardrails` | List 10 Sovereign Guardrails |

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## [1.0.0] — 2026-03-23
+
+### Added
+- **Core Type System**: Full PageSpecV1 type system (18 section types, catalog, manifest, navigation)
+- **Catalog Resolver**: `resolvePageSpecWithCatalog` with blueprint, template, and preset resolution + governance checks
+- **Presentation Resolver**: `resolvePresentation`, `inferRhythmProfile`, `DEFAULT_PRESENTATION`
+- **Manifest Resolver**: `normalizePathname`, `resolvePageIdByRoute`
+- **CSS Guardrails**: `checkNoHardcodedPx`, `checkNoHardcodedColor`, `checkNoNamedColor` (148 CSS colors)
+- **WCAG Contrast**: `checkWcagContrast` with AA/AAA levels
+- **Rhythm Probe**: hero-first, no consecutive same rhythm, spacer rules
+- **Hero Contract**: CTA discipline, single decorative source, copy density, action rail geometry
+- **Section Integrity**: per-type structural validation for 8 section types
+- **CLI**: 7 commands (`audit`, `validate`, `guardrails`, `probe`, `contrast`, `catalog resolve`, `manifest resolve`)
+- **MCP Server**: 13 tools covering all engine capabilities
+- **Test Suite**: 109 tests across 9 suites
+
+### Architecture
+- Zero DOM, zero fetch — pure functions only
+- Framework-agnostic: consumers load data, engine resolves/validates/probes
+- Type system extracted from easyway-portal (single source of truth)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EasyWay Platform Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# Valentino Engine
+
+> **Antifragile Open Source UI Design Engine** — part of the [HALE-BOPP](https://dev.azure.com/EasyWayData/EasyWay-DataPortal/_git/hale-bopp-valentino-engine) family.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![npm](https://img.shields.io/npm/v/@hale-bopp/valentino-engine)](https://www.npmjs.com/package/@hale-bopp/valentino-engine)
+
+## What is Valentino Engine?
+
+Valentino Engine validates, resolves, and probes **Runtime PageSpec JSON** — the contract that drives UI rendering. It enforces Design Tokens, checks WCAG accessibility, validates page structure, and resolves catalog blueprints — all without framework lock-in.
+
+**Zero DOM. Zero fetch. Pure functions only.** You load data, the engine validates and resolves it.
+
+## Quickstart
+
+```bash
+# Audit CSS for guardrail violations (px, hex, named colors)
+npx @hale-bopp/valentino audit ./styles/theme.css
+
+# Validate a PageSpec JSON
+npx @hale-bopp/valentino validate ./pages/home.json
+
+# Run all structural probes on a page
+npx @hale-bopp/valentino probe all ./pages/home.json
+
+# Check WCAG contrast ratio
+npx @hale-bopp/valentino contrast "#333333" "#ffffff" AA
+
+# Resolve a spec with a catalog
+npx @hale-bopp/valentino catalog resolve ./pages/home.json --catalog ./catalog.json
+
+# List the 10 Sovereign Guardrails
+npx @hale-bopp/valentino guardrails
+```
+
+## Library API
+
+```typescript
+import {
+  // Types (18 section types, full PageSpecV1)
+  type PageSpecV1, type SectionSpec, type ValentinoCatalogV1,
+
+  // Validation
+  validatePageSpec, checkWcagContrast,
+
+  // CSS Guardrails
+  checkNoHardcodedPx, checkNoHardcodedColor, checkNoNamedColor,
+
+  // Probes
+  probeRhythm, probeHeroContract, probeSectionIntegrity,
+
+  // Catalog & Presentation
+  resolvePageSpecWithCatalog, resolvePresentation, inferRhythmProfile,
+
+  // Manifest
+  resolvePageIdByRoute,
+} from '@hale-bopp/valentino-engine';
+```
+
+## MCP Server (13 Tools)
+
+Any MCP-compatible AI agent can connect to Valentino Engine:
+
+```json
+{
+  "mcp_servers": {
+    "valentino-engine": {
+      "command": "npx",
+      "args": ["@hale-bopp/valentino-engine", "mcp"]
+    }
+  }
+}
+```
+
+| Tool | Description |
+|------|-------------|
+| `valentino_audit_css` | Audit CSS for hardcoded px, hex/rgba, and named colors |
+| `valentino_validate_pagespec` | Validate PageSpecV1 contract |
+| `valentino_check_contrast` | WCAG 2.1 contrast ratio (AA/AAA) |
+| `valentino_probe_rhythm` | Section sequence rhythm validation |
+| `valentino_probe_hero` | Hero contract (CTA discipline, copy density) |
+| `valentino_probe_integrity` | Per-type structural validation |
+| `valentino_probe_all` | All probes combined |
+| `valentino_resolve_catalog` | Resolve spec with catalog (blueprints, presets) |
+| `valentino_resolve_route` | Resolve URL route to page ID |
+| `valentino_get_skill` | Get design skill rules |
+| `valentino_list_guardrails` | List 10 Sovereign Guardrails |
+
+## The 10 Sovereign Guardrails
+
+1. **WhatIf di Layout** — Wireframe first, code second
+2. **Component Boundary & Fallbacks** — Error Boundaries on all API bridges
+3. **Design Token System** — No hardcoded colors or px values
+4. **L3 Audit before Commit** — ARIA, performance, and dependency check
+5. **Escalation to GEDI** — Consult GEDI on architectural trade-offs
+6. **Zero UI-Debt** — Reuse before creating
+7. **Electrical Socket Pattern** — CSS root variables for all colors
+8. **Testudo Formation** — No inline padding/margin overrides on containers
+9. **Tangible Legacy** — No redundant CSS blocks
+10. **Visual Live Audit** — Playwright MCP or `npm run test:e2e:valentino`
+
+## Contributing
+
+PRs welcome! Please link your PR to an ADO Work Item under [Epic #480](https://dev.azure.com/EasyWayData/EasyWay-DataPortal/_workitems/edit/480).
+
+## License
+
+[MIT](./LICENSE) — EasyWay Platform Team

package/dist/bin/commands/audit.d.ts

@@ -0,0 +1,2 @@
+export declare function runAudit(args: string[]): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/bin/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/audit.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmB7C"}

package/dist/bin/commands/audit.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'fs';
+import { checkNoHardcodedPx, checkNoHardcodedColor, checkNoNamedColor } from '../../core/guardrails.js';
+export function runAudit(args) {
+    const file = args[0];
+    if (!file) {
+        console.error('Usage: valentino audit <path-to-css-file>');
+        process.exit(1);
+    }
+    const css = readFileSync(file, 'utf-8');
+    const all = [
+        ...checkNoHardcodedPx(css),
+        ...checkNoHardcodedColor(css),
+        ...checkNoNamedColor(css),
+    ];
+    if (all.length === 0) {
+        console.log('✅ No guardrail violations found.');
+    }
+    else {
+        console.log(`❌ ${all.length} violation(s) found:\n`);
+        all.forEach(v => console.log('  •', v));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/bin/commands/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/bin/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAExG,MAAM,UAAU,QAAQ,CAAC,IAAc;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG;QACR,GAAG,kBAAkB,CAAC,GAAG,CAAC;QAC1B,GAAG,qBAAqB,CAAC,GAAG,CAAC;QAC7B,GAAG,iBAAiB,CAAC,GAAG,CAAC;KAC5B,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,wBAAwB,CAAC,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/bin/commands/catalog.d.ts

@@ -0,0 +1,2 @@
+export declare function runCatalogResolve(args: string[]): void;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/bin/commands/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/catalog.ts"],"names":[],"mappings":"AAKA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAoBtD"}

package/dist/bin/commands/catalog.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'fs';
+import { validatePageSpec } from '../../core/page-spec.js';
+import { resolvePageSpecWithCatalog } from '../../core/catalog.js';
+export function runCatalogResolve(args) {
+    const specFile = args[0];
+    const catalogIdx = args.indexOf('--catalog');
+    const catalogFile = catalogIdx >= 0 ? args[catalogIdx + 1] : undefined;
+    if (!specFile || !catalogFile) {
+        console.error('Usage: valentino catalog resolve <spec.json> --catalog <catalog.json>');
+        process.exit(1);
+    }
+    const specJson = JSON.parse(readFileSync(specFile, 'utf-8'));
+    if (!validatePageSpec(specJson)) {
+        console.error('❌ spec file is not a valid PageSpecV1.');
+        process.exit(1);
+    }
+    const catalog = JSON.parse(readFileSync(catalogFile, 'utf-8'));
+    const resolved = resolvePageSpecWithCatalog(specJson, catalog);
+    console.log(JSON.stringify(resolved, null, 2));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/bin/commands/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/bin/commands/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAuB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,0BAA0B,CAAC,QAAsB,EAAE,OAAO,CAAC,CAAC;IAE7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/bin/commands/contrast.d.ts

@@ -0,0 +1,2 @@
+export declare function runContrast(args: string[]): void;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/bin/commands/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/contrast.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuBhD"}

package/dist/bin/commands/contrast.js

@@ -0,0 +1,22 @@
+import { checkWcagContrast } from '../../core/contrast.js';
+export function runContrast(args) {
+    const fg = args[0];
+    const bg = args[1];
+    const level = args[2] || 'AA';
+    if (!fg || !bg) {
+        console.error('Usage: valentino contrast <foreground> <background> [AA|AAA]');
+        process.exit(1);
+    }
+    const result = checkWcagContrast(fg, bg, level);
+    if (result.ratio === 0) {
+        console.error('❌ Could not parse colors. Use #hex or rgb(r,g,b) format.');
+        process.exit(1);
+    }
+    const status = result.passes ? '✅ PASS' : '❌ FAIL';
+    console.log(`${status} — ${result.ratio}:1 (${level} requires ${level === 'AAA' ? '7.0' : '4.5'}:1)`);
+    console.log(`  Foreground: ${fg}`);
+    console.log(`  Background: ${bg}`);
+    if (!result.passes)
+        process.exit(1);
+}
+//# sourceMappingURL=contrast.js.map

package/dist/bin/commands/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../../src/bin/commands/contrast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,UAAU,WAAW,CAAC,IAAc;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,KAAK,GAAI,IAAI,CAAC,CAAC,CAAmB,IAAI,IAAI,CAAC;IAEjD,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,MAAM,MAAM,CAAC,KAAK,OAAO,KAAK,aAAa,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IACtG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/bin/commands/guardrails.d.ts

@@ -0,0 +1,2 @@
+export declare function runGuardrails(): void;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/bin/commands/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/guardrails.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,IAAI,IAAI,CAgBpC"}

package/dist/bin/commands/guardrails.js

@@ -0,0 +1,18 @@
+export function runGuardrails() {
+    const guardrails = [
+        '1. WhatIf di Layout — Wireframe first, code second',
+        '2. Component Boundary & Fallbacks — Error Boundaries on all API bridges',
+        '3. Design Token System — No hardcoded colors or px values',
+        '4. L3 Audit before Commit — ARIA, performance, and dependency check',
+        '5. Escalation to GEDI — Consult GEDI on architectural trade-offs',
+        '6. Zero UI-Debt — Reuse before creating',
+        '7. Electrical Socket Pattern — CSS root variables for all colors',
+        '8. Testudo Formation — No inline padding/margin overrides on containers',
+        '9. Tangible Legacy — No redundant CSS blocks',
+        '10. Visual Live Audit — Use MCP browser_screenshot or npm run test:e2e:valentino',
+    ];
+    console.log('\n🛡️  Valentino Engine — 10 Sovereign Guardrails\n');
+    guardrails.forEach(g => console.log(' ', g));
+    console.log();
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/bin/commands/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../../src/bin/commands/guardrails.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa;IACzB,MAAM,UAAU,GAAG;QACf,oDAAoD;QACpD,yEAAyE;QACzE,2DAA2D;QAC3D,qEAAqE;QACrE,kEAAkE;QAClE,yCAAyC;QACzC,kEAAkE;QAClE,yEAAyE;QACzE,8CAA8C;QAC9C,kFAAkF;KACrF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,CAAC;AAClB,CAAC"}

package/dist/bin/commands/manifest.d.ts

@@ -0,0 +1,2 @@
+export declare function runManifestResolve(args: string[]): void;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/bin/commands/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/manifest.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmBvD"}

package/dist/bin/commands/manifest.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'fs';
+import { resolvePageIdByRoute } from '../../core/manifest.js';
+export function runManifestResolve(args) {
+    const manifestFile = args[0];
+    const routeIdx = args.indexOf('--route');
+    const route = routeIdx >= 0 ? args[routeIdx + 1] : undefined;
+    if (!manifestFile || !route) {
+        console.error('Usage: valentino manifest resolve <manifest.json> --route /path');
+        process.exit(1);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const pageId = resolvePageIdByRoute(manifest, route);
+    if (pageId) {
+        console.log(`✅ Route "${route}" → pageId: "${pageId}"`);
+    }
+    else {
+        console.error(`❌ No page found for route "${route}"`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/bin/commands/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/bin/commands/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAErD,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,gBAAgB,MAAM,GAAG,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,8BAA8B,KAAK,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/bin/commands/probe.d.ts

@@ -0,0 +1,2 @@
+export declare function runProbe(subcommand: string, args: string[]): void;
+//# sourceMappingURL=probe.d.ts.map

package/dist/bin/commands/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/probe.ts"],"names":[],"mappings":"AA0BA,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAoCjE"}

package/dist/bin/commands/probe.js

@@ -0,0 +1,59 @@
+import { readFileSync } from 'fs';
+import { validatePageSpec } from '../../core/page-spec.js';
+import { probeRhythm } from '../../core/rhythm.js';
+import { probeHeroContract } from '../../core/hero-contract.js';
+import { probeSectionIntegrity } from '../../core/section-integrity.js';
+function loadSpec(file) {
+    const json = JSON.parse(readFileSync(file, 'utf-8'));
+    if (!validatePageSpec(json)) {
+        console.error('❌ File is not a valid PageSpecV1.');
+        process.exit(1);
+    }
+    return json;
+}
+function printWarnings(label, warnings) {
+    if (warnings.length === 0) {
+        console.log(`  ✅ ${label}: no issues`);
+        return true;
+    }
+    console.log(`  ❌ ${label}: ${warnings.length} issue(s)`);
+    warnings.forEach(w => console.log(`     • [${w.rule}] ${w.message}`));
+    return false;
+}
+export function runProbe(subcommand, args) {
+    const file = args[0];
+    if (!file) {
+        console.error('Usage: valentino probe <rhythm|hero|integrity|all> <path-to-spec.json>');
+        process.exit(1);
+    }
+    const spec = loadSpec(file);
+    let allValid = true;
+    console.log(`\n🔍 Valentino Probe — ${file}\n`);
+    if (subcommand === 'rhythm' || subcommand === 'all') {
+        const result = probeRhythm(spec);
+        if (!printWarnings('Rhythm', result.warnings))
+            allValid = false;
+    }
+    if (subcommand === 'hero' || subcommand === 'all') {
+        const heroes = spec.sections.filter((s) => s.type === 'hero');
+        if (heroes.length === 0) {
+            console.log('  ⏭️  Hero: no hero section found');
+        }
+        else {
+            for (const hero of heroes) {
+                const result = probeHeroContract(hero);
+                if (!printWarnings(`Hero (${hero.titleKey})`, result.warnings))
+                    allValid = false;
+            }
+        }
+    }
+    if (subcommand === 'integrity' || subcommand === 'all') {
+        const result = probeSectionIntegrity(spec.sections);
+        if (!printWarnings('Section Integrity', result.warnings))
+            allValid = false;
+    }
+    console.log();
+    if (!allValid)
+        process.exit(1);
+}
+//# sourceMappingURL=probe.js.map

package/dist/bin/commands/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/bin/commands/probe.ts"],"names":[],"mappings":"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"}

package/dist/bin/commands/validate.d.ts

@@ -0,0 +1,2 @@
+export declare function runValidate(args: string[]): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/bin/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/validate.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAchD"}

package/dist/bin/commands/validate.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'fs';
+import { validatePageSpec } from '../../core/page-spec.js';
+export function runValidate(args) {
+    const file = args[0];
+    if (!file) {
+        console.error('Usage: valentino validate <path-to-pagespec.json>');
+        process.exit(1);
+    }
+    const json = JSON.parse(readFileSync(file, 'utf-8'));
+    const valid = validatePageSpec(json);
+    if (valid) {
+        console.log('✅ PageSpec is valid (V1).');
+    }
+    else {
+        console.error('❌ PageSpec is invalid — requires version: "1", id (string), sections (array).');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/bin/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/bin/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,UAAU,WAAW,CAAC,IAAc;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/bin/valentino.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Valentino CLI — command router
+ * `npx @hale-bopp/valentino <command> [args]`
+ */
+export {};
+//# sourceMappingURL=valentino.d.ts.map

package/dist/bin/valentino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valentino.d.ts","sourceRoot":"","sources":["../../src/bin/valentino.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/bin/valentino.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Valentino CLI — command router
+ * `npx @hale-bopp/valentino <command> [args]`
+ */
+import { runAudit } from './commands/audit.js';
+import { runValidate } from './commands/validate.js';
+import { runGuardrails } from './commands/guardrails.js';
+import { runProbe } from './commands/probe.js';
+import { runCatalogResolve } from './commands/catalog.js';
+import { runManifestResolve } from './commands/manifest.js';
+import { runContrast } from './commands/contrast.js';
+const [, , command, ...args] = process.argv;
+switch (command) {
+    case 'audit':
+        runAudit(args);
+        break;
+    case 'validate':
+        runValidate(args);
+        break;
+    case 'guardrails':
+        runGuardrails();
+        break;
+    case 'probe':
+        runProbe(args[0] || 'all', args.slice(1));
+        break;
+    case 'catalog':
+        if (args[0] === 'resolve')
+            runCatalogResolve(args.slice(1));
+        else {
+            console.error('Usage: valentino catalog resolve <spec.json> --catalog <catalog.json>');
+            process.exit(1);
+        }
+        break;
+    case 'manifest':
+        if (args[0] === 'resolve')
+            runManifestResolve(args.slice(1));
+        else {
+            console.error('Usage: valentino manifest resolve <manifest.json> --route /path');
+            process.exit(1);
+        }
+        break;
+    case 'contrast':
+        runContrast(args);
+        break;
+    default:
+        console.log(`
+🎨 Valentino Engine v0.1.0 — Antifragile Open Source UI Design Engine
+
+Usage:
+  valentino audit <file.css>                                    Audit CSS for guardrail violations
+  valentino validate <spec.json>                                Validate a Runtime PageSpec JSON (V1)
+  valentino guardrails                                          List all 10 Sovereign Guardrails
+  valentino probe <rhythm|hero|integrity|all> <spec.json>       Run validation probes
+  valentino contrast <foreground> <background> [AA|AAA]         Check WCAG contrast ratio
+  valentino catalog resolve <spec.json> --catalog <catalog.json> Resolve spec with catalog
+  valentino manifest resolve <manifest.json> --route /path      Resolve route to page ID
+
+Epic: https://dev.azure.com/EasyWayData/EasyWay-DataPortal/_workitems/edit/480
+`);
+}
+//# sourceMappingURL=valentino.js.map

package/dist/bin/valentino.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valentino.js","sourceRoot":"","sources":["../../src/bin/valentino.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,CAAC,EAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAE3C,QAAQ,OAAO,EAAE,CAAC;IACd,KAAK,OAAO;QACR,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,MAAM;IAEV,KAAK,UAAU;QACX,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM;IAEV,KAAK,YAAY;QACb,aAAa,EAAE,CAAC;QAChB,MAAM;IAEV,KAAK,OAAO;QACR,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM;IAEV,KAAK,SAAS;QACV,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvD,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,MAAM;IAEV,KAAK,UAAU;QACX,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACxD,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,MAAM;IAEV,KAAK,UAAU;QACX,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM;IAEV;QACI,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAanB,CAAC,CAAC;AACH,CAAC"}

package/dist/core/catalog.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Catalog Resolver — resolves PageSpec against a ValentinoCatalog.
+ * Pure functions, no fetch, no DOM. Consumer loads the catalog.
+ * Extracted from easyway-portal (src/utils/valentino-catalog.ts).
+ */
+import type { PageSpecV1, SectionPresentationSpec, SectionSpec, ValentinoCatalogV1, PageProfileSpec } from './types.js';
+export declare function mergePresentation(presetPresentation: SectionPresentationSpec | undefined, transitionPresentation: SectionPresentationSpec | undefined, inlinePresentation: SectionPresentationSpec | undefined): SectionPresentationSpec | undefined;
+export declare function isGovernanceAllowed(sectionType: SectionSpec['type'], pageProfile: PageProfileSpec | undefined, governance?: {
+    allowedPageProfiles?: PageProfileSpec[];
+    allowedSectionTypes?: SectionSpec['type'][];
+}): boolean;
+export declare function resolvePageSpecWithCatalog(pageSpec: PageSpecV1, catalog: ValentinoCatalogV1): PageSpecV1;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/core/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/core/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,UAAU,EACV,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,eAAe,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAC7B,kBAAkB,EAAE,uBAAuB,GAAG,SAAS,EACvD,sBAAsB,EAAE,uBAAuB,GAAG,SAAS,EAC3D,kBAAkB,EAAE,uBAAuB,GAAG,SAAS,GACxD,uBAAuB,GAAG,SAAS,CAOrC;AAED,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,UAAU,CAAC,EAAE;IACT,mBAAmB,CAAC,EAAE,eAAe,EAAE,CAAC;IACxC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;CAC/C,GACF,OAAO,CAYT;AA+BD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,GAAG,UAAU,CAqBxG"}