@hale-bopp/valentino-engine 1.0.0

package/dist/mcp/index.js

@@ -0,0 +1,126 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { checkNoHardcodedPx, checkNoHardcodedColor, checkNoNamedColor } from '../core/guardrails.js';
+import { validatePageSpec } from '../core/page-spec.js';
+import { premiumDesignSkill, webGuardrailsSkill, designGuidelinesSkill } from '../skills/index.js';
+import { checkWcagContrast } from '../core/contrast.js';
+import { probeRhythm } from '../core/rhythm.js';
+import { probeHeroContract } from '../core/hero-contract.js';
+import { probeSectionIntegrity } from '../core/section-integrity.js';
+import { resolvePageSpecWithCatalog } from '../core/catalog.js';
+import { resolvePageIdByRoute } from '../core/manifest.js';
+const server = new McpServer({
+    name: 'valentino-engine',
+    version: '0.2.0',
+});
+function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+function parseSpec(spec) {
+    const parsed = JSON.parse(spec);
+    if (!validatePageSpec(parsed))
+        throw new Error('Invalid PageSpecV1: requires version "1", id, sections[]');
+    return parsed;
+}
+// ─── Audit ────────────────────────────────────────────────────────────────────
+server.tool('valentino_audit_css', 'Audit a CSS string for hardcoded px values, hex/rgba colors, and named CSS colors.', { css: z.string().describe('CSS content to audit') }, async ({ css }) => {
+    const violations = [
+        ...checkNoHardcodedPx(css),
+        ...checkNoHardcodedColor(css),
+        ...checkNoNamedColor(css),
+    ];
+    return jsonResult(violations.length === 0
+        ? { valid: true, message: 'No guardrail violations found.' }
+        : { valid: false, violations });
+});
+// ─── Validate ─────────────────────────────────────────────────────────────────
+server.tool('valentino_validate_pagespec', 'Validate a Runtime PageSpec JSON against PageSpecV1 contract (version "1", id, sections[]).', { spec: z.string().describe('PageSpec JSON string') }, async ({ spec }) => {
+    try {
+        const parsed = JSON.parse(spec);
+        const valid = validatePageSpec(parsed);
+        return jsonResult({ valid, message: valid ? 'PageSpec is valid (V1).' : 'Invalid: requires version "1", id (string), sections (array).' });
+    }
+    catch (e) {
+        return jsonResult({ valid: false, message: `Invalid JSON: ${String(e)}` });
+    }
+});
+// ─── Contrast ─────────────────────────────────────────────────────────────────
+server.tool('valentino_check_contrast', 'Check WCAG 2.1 contrast ratio between two colors. Returns ratio and pass/fail.', {
+    foreground: z.string().describe('Foreground color (#hex or rgb())'),
+    background: z.string().describe('Background color (#hex or rgb())'),
+    level: z.enum(['AA', 'AAA']).optional().describe('WCAG level (default: AA)'),
+}, async ({ foreground, background, level }) => {
+    return jsonResult(checkWcagContrast(foreground, background, level || 'AA'));
+});
+// ─── Probes ───────────────────────────────────────────────────────────────────
+server.tool('valentino_probe_rhythm', 'Validate section sequence rhythm: hero-first, no consecutive same rhythm, spacer rules.', { spec: z.string().describe('PageSpec JSON string') }, async ({ spec }) => jsonResult(probeRhythm(parseSpec(spec))));
+server.tool('valentino_probe_hero', 'Validate hero section contract: CTA discipline, single decorative source, copy density.', { spec: z.string().describe('PageSpec JSON string') }, async ({ spec }) => {
+    const pageSpec = parseSpec(spec);
+    const heroes = pageSpec.sections.filter((s) => s.type === 'hero');
+    if (heroes.length === 0)
+        return jsonResult({ valid: true, message: 'No hero sections found.' });
+    return jsonResult(heroes.map(h => ({ titleKey: h.titleKey, ...probeHeroContract(h) })));
+});
+server.tool('valentino_probe_integrity', 'Validate structural integrity of all sections (cards items, form fields, etc.).', { spec: z.string().describe('PageSpec JSON string') }, async ({ spec }) => jsonResult(probeSectionIntegrity(parseSpec(spec).sections)));
+server.tool('valentino_probe_all', 'Run all validation probes (rhythm + hero + integrity) on a PageSpec.', { spec: z.string().describe('PageSpec JSON string') }, async ({ spec }) => {
+    const pageSpec = parseSpec(spec);
+    const heroes = pageSpec.sections.filter((s) => s.type === 'hero');
+    return jsonResult({
+        rhythm: probeRhythm(pageSpec),
+        hero: heroes.map(h => ({ titleKey: h.titleKey, ...probeHeroContract(h) })),
+        integrity: probeSectionIntegrity(pageSpec.sections),
+    });
+});
+// ─── Catalog ──────────────────────────────────────────────────────────────────
+server.tool('valentino_resolve_catalog', 'Resolve a PageSpec against a Valentino catalog (blueprints, presets, templates).', {
+    spec: z.string().describe('PageSpec JSON string'),
+    catalog: z.string().describe('ValentinoCatalogV1 JSON string'),
+}, async ({ spec, catalog }) => {
+    const pageSpec = parseSpec(spec);
+    const cat = JSON.parse(catalog);
+    return jsonResult(resolvePageSpecWithCatalog(pageSpec, cat));
+});
+// ─── Manifest ─────────────────────────────────────────────────────────────────
+server.tool('valentino_resolve_route', 'Resolve a URL route to a page ID using a pages manifest.', {
+    manifest: z.string().describe('PagesManifestV1 JSON string'),
+    route: z.string().describe('URL pathname to resolve (e.g., /pricing)'),
+}, async ({ manifest, route }) => {
+    const man = JSON.parse(manifest);
+    const pageId = resolvePageIdByRoute(man, route);
+    return jsonResult(pageId
+        ? { found: true, pageId }
+        : { found: false, message: `No page found for route "${route}"` });
+});
+// ─── Skills ───────────────────────────────────────────────────────────────────
+server.tool('valentino_get_skill', 'Get the rules for a Valentino Engine design skill.', { skill: z.enum(['premium-design', 'web-guardrails', 'design-guidelines']).describe('Skill name') }, async ({ skill }) => {
+    const map = { 'premium-design': premiumDesignSkill, 'web-guardrails': webGuardrailsSkill, 'design-guidelines': designGuidelinesSkill };
+    return jsonResult(map[skill]);
+});
+server.tool('valentino_list_guardrails', 'List all 10 Sovereign Guardrails of Valentino Engine.', {}, async () => {
+    const guardrails = [
+        '1. WhatIf di Layout — Never generate code without a conceptual wireframe first',
+        '2. Component Boundary & Fallbacks — All API bridges must include Error Boundaries',
+        '3. Design Token System — No magic numbers or hardcoded hex/rgba values',
+        '4. L3 Audit before Commit — Check for dependency bloat and ARIA compliance',
+        '5. Escalation to GEDI — Consult GEDI on architectural trade-offs',
+        '6. Zero UI-Debt — Always scan for reusable components before creating new ones',
+        '7. Electrical Socket Pattern — Colors via CSS root variables only',
+        '8. Testudo Formation — Respect parent container padding, no inline overrides',
+        '9. Tangible Legacy — No redundant CSS blocks; use utility classes',
+        '10. Visual Live Audit — Use MCP browser_screenshot or npm run test:e2e:valentino',
+    ];
+    return { content: [{ type: 'text', text: guardrails.join('\n') }] };
+});
+// ─── Start ────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('valentino-engine MCP server running on stdio (13 tools)');
+    process.stdin.resume();
+}
+main().catch((err) => {
+    console.error('MCP server error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/skills/design-guidelines.d.ts

@@ -0,0 +1,6 @@
+export declare const designGuidelinesSkill: {
+    readonly name: "web-design-guidelines";
+    readonly description: "Provide a unified baseline for web ergonomics, typography, and responsive layouts.";
+    readonly rules: readonly ["Mobile-first layout architecture", "Use only CSS token variables for font sizes (--text-step-*)", "No hardcoded container widths — use fluid max-width with clamp()", "Spacing scales must follow the 8-point grid system via CSS variables"];
+};
+//# sourceMappingURL=design-guidelines.d.ts.map

package/dist/skills/design-guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-guidelines.d.ts","sourceRoot":"","sources":["../../src/skills/design-guidelines.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;CASxB,CAAC"}

package/dist/skills/design-guidelines.js

@@ -0,0 +1,11 @@
+export const designGuidelinesSkill = {
+    name: 'web-design-guidelines',
+    description: 'Provide a unified baseline for web ergonomics, typography, and responsive layouts.',
+    rules: [
+        'Mobile-first layout architecture',
+        'Use only CSS token variables for font sizes (--text-step-*)',
+        'No hardcoded container widths — use fluid max-width with clamp()',
+        'Spacing scales must follow the 8-point grid system via CSS variables',
+    ],
+};
+//# sourceMappingURL=design-guidelines.js.map

package/dist/skills/design-guidelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-guidelines.js","sourceRoot":"","sources":["../../src/skills/design-guidelines.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,oFAAoF;IACjG,KAAK,EAAE;QACL,kCAAkC;QAClC,6DAA6D;QAC7D,kEAAkE;QAClE,sEAAsE;KACvE;CACO,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Skills index — re-exports all loadable skill definitions.
+ */
+export { premiumDesignSkill } from './premium-design.js';
+export { webGuardrailsSkill } from './web-guardrails.js';
+export { designGuidelinesSkill } from './design-guidelines.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,7 @@
+/**
+ * Skills index — re-exports all loadable skill definitions.
+ */
+export { premiumDesignSkill } from './premium-design.js';
+export { webGuardrailsSkill } from './web-guardrails.js';
+export { designGuidelinesSkill } from './design-guidelines.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/skills/premium-design.d.ts

@@ -0,0 +1,6 @@
+export declare const premiumDesignSkill: {
+    readonly name: "valentino-premium-design";
+    readonly description: "Enforce premium visual standards: micro-animations, soft gradients, modern typography, generous negative space.";
+    readonly rules: readonly ["Use Inter or Outfit as the primary font family", "Prefer subtle gradients over flat solid backgrounds", "Maintain minimum spacing of var(--valentino-rhythm-space-block-md)", "Add transition: all 0.2s ease on all interactive elements"];
+};
+//# sourceMappingURL=premium-design.d.ts.map

package/dist/skills/premium-design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-design.d.ts","sourceRoot":"","sources":["../../src/skills/premium-design.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;CASrB,CAAC"}

package/dist/skills/premium-design.js

@@ -0,0 +1,11 @@
+export const premiumDesignSkill = {
+    name: 'valentino-premium-design',
+    description: 'Enforce premium visual standards: micro-animations, soft gradients, modern typography, generous negative space.',
+    rules: [
+        'Use Inter or Outfit as the primary font family',
+        'Prefer subtle gradients over flat solid backgrounds',
+        'Maintain minimum spacing of var(--valentino-rhythm-space-block-md)',
+        'Add transition: all 0.2s ease on all interactive elements',
+    ],
+};
+//# sourceMappingURL=premium-design.js.map

package/dist/skills/premium-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-design.js","sourceRoot":"","sources":["../../src/skills/premium-design.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,iHAAiH;IAC9H,KAAK,EAAE;QACL,gDAAgD;QAChD,qDAAqD;QACrD,oEAAoE;QACpE,2DAA2D;KAC5D;CACO,CAAC"}

package/dist/skills/web-guardrails.d.ts

@@ -0,0 +1,6 @@
+export declare const webGuardrailsSkill: {
+    readonly name: "valentino-web-guardrails";
+    readonly description: "Enforce ARIA, semantic HTML, and performance compliance on all generated components.";
+    readonly rules: readonly ["Every interactive element must have an aria-label or labelKey", "Images must have alt text", "Avoid layout-triggering CSS properties (width, height) in animations", "Respect OPS vs Product UI boundary"];
+};
+//# sourceMappingURL=web-guardrails.d.ts.map

package/dist/skills/web-guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-guardrails.d.ts","sourceRoot":"","sources":["../../src/skills/web-guardrails.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;CASrB,CAAC"}

package/dist/skills/web-guardrails.js

@@ -0,0 +1,11 @@
+export const webGuardrailsSkill = {
+    name: 'valentino-web-guardrails',
+    description: 'Enforce ARIA, semantic HTML, and performance compliance on all generated components.',
+    rules: [
+        'Every interactive element must have an aria-label or labelKey',
+        'Images must have alt text',
+        'Avoid layout-triggering CSS properties (width, height) in animations',
+        'Respect OPS vs Product UI boundary',
+    ],
+};
+//# sourceMappingURL=web-guardrails.js.map

package/dist/skills/web-guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-guardrails.js","sourceRoot":"","sources":["../../src/skills/web-guardrails.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,sFAAsF;IACnG,KAAK,EAAE;QACL,+DAA+D;QAC/D,2BAA2B;QAC3B,sEAAsE;QACtE,oCAAoC;KACrC;CACO,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@hale-bopp/valentino-engine",
+  "version": "1.0.0",
+  "description": "Antifragile Open Source UI Design Engine — generates Runtime PageSpec JSON, validates accessibility, enforces Design Tokens, and consults GEDI for architectural decisions.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js"
+    }
+  },
+  "bin": {
+    "valentino": "dist/bin/valentino.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "AGENTS.md",
+    "skills"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "test": "vitest run",
+    "mcp": "tsx src/mcp/index.ts",
+    "audit": "tsx src/bin/valentino.ts audit",
+    "probe": "tsx src/bin/valentino.ts probe",
+    "contrast": "tsx src/bin/valentino.ts contrast"
+  },
+  "keywords": [
+    "ui",
+    "design-system",
+    "mcp",
+    "agent",
+    "antifragile",
+    "accessibility",
+    "open-source"
+  ],
+  "license": "MIT",
+  "author": "EasyWay Platform Team",
+  "repository": {
+    "type": "git",
+    "url": "https://dev.azure.com/EasyWayData/EasyWay-DataPortal/_git/hale-bopp-valentino-engine"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsx": "^4.19.0",
+    "vitest": "^2.1.0",
+    "@types/node": "^22.10.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/skills/valentino-premium-design.md

@@ -0,0 +1,10 @@
+# Skill: Valentino Premium Design
+
+## Objective
+Garantisci che ogni implementazione UI rispondi a requisiti estetici "Premium".
+
+## Guidelines
+1. I contrasti devono essere bilanciati e accessibili.
+2. Prediligi i gradienti soft o effetti glassmorphism se il contesto lo richiede.
+3. Lo spazio negativo è fondamentale: usa sempre le variabili `--valentino-rhythm-*` per donare respiro all'interfaccia.
+4. Non usare mai grigi piatti (es. `#eee`), ma sempre colori semantici root o neural palette scalati.

package/skills/valentino-web-guardrails.md

@@ -0,0 +1,9 @@
+# Skill: Valentino Web Guardrails
+
+## Objective
+Enforce strict performance, accessibility, and platform compliance parameters on all generated frontend code.
+
+## Guidelines
+1. ARIA labels obbligatori su ogni elemento interattivo.
+2. Controllare le performance di reflow CSS.
+3. Applicare rigorosamente la distinzione tra OPS (Operations) e PRODUCT UI.

package/skills/web-design-guidelines.md

@@ -0,0 +1,9 @@
+# Skill: Web Design Guidelines
+
+## Objective
+Provide a unified baseline for web ergonomics and typography.
+
+## Guidelines
+1. Usa solo i token CSS pre-configurati nei framework (es. `--text-step-0`).
+2. Sostieni i form factor fluidi ed eludi width statiche (no hardcoded px widths per i container).
+3. Mobile-first design architecture.