@hale-bopp/valentino-engine 1.0.0

package/dist/core/catalog.js

@@ -0,0 +1,63 @@
+/**
+ * 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).
+ */
+export function mergePresentation(presetPresentation, transitionPresentation, inlinePresentation) {
+    const merged = {
+        ...(presetPresentation || {}),
+        ...(transitionPresentation || {}),
+        ...(inlinePresentation || {}),
+    };
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+export function isGovernanceAllowed(sectionType, pageProfile, governance) {
+    if (!governance)
+        return true;
+    if (governance.allowedPageProfiles?.length && (!pageProfile || !governance.allowedPageProfiles.includes(pageProfile))) {
+        return false;
+    }
+    if (governance.allowedSectionTypes?.length && !governance.allowedSectionTypes.includes(sectionType)) {
+        return false;
+    }
+    return true;
+}
+function resolveSectionWithCatalog(section, pageProfile, catalog) {
+    const presentation = section.presentation;
+    const presetId = presentation?.presetId;
+    const transitionProfileId = presentation?.transitionProfileId;
+    const presetEntry = presetId ? catalog.sectionPresets[presetId] : undefined;
+    const transitionEntry = transitionProfileId ? catalog.transitionProfiles[transitionProfileId] : undefined;
+    if (presetEntry && !isGovernanceAllowed(section.type, pageProfile, presetEntry.governance)) {
+        console.warn(`[ValentinoCatalog] Preset '${presetId}' is outside the approved perimeter for page profile '${pageProfile || 'n/a'}' and section '${section.type}'`);
+    }
+    if (transitionEntry && !isGovernanceAllowed(section.type, pageProfile, transitionEntry.governance)) {
+        console.warn(`[ValentinoCatalog] Transition profile '${transitionProfileId}' is outside the approved perimeter for page profile '${pageProfile || 'n/a'}' and section '${section.type}'`);
+    }
+    return {
+        ...section,
+        presentation: mergePresentation(presetEntry?.presentation, transitionEntry?.presentation, presentation),
+    };
+}
+export function resolvePageSpecWithCatalog(pageSpec, catalog) {
+    const blueprintEntry = pageSpec.blueprintId ? catalog.pageBlueprints[pageSpec.blueprintId] : undefined;
+    const blueprintSpec = blueprintEntry?.spec;
+    const templateId = pageSpec.templateId || blueprintSpec?.templateId;
+    const templateEntry = templateId ? catalog.templates[templateId] : undefined;
+    const resolvedProfile = pageSpec.profile || blueprintSpec?.profile || templateEntry?.page?.profile;
+    const resolvedSections = Array.isArray(pageSpec.sections) && pageSpec.sections.length > 0
+        ? pageSpec.sections
+        : (blueprintSpec?.sections || []);
+    return {
+        ...blueprintSpec,
+        ...pageSpec,
+        id: pageSpec.id,
+        templateId,
+        profile: resolvedProfile,
+        titleKey: pageSpec.titleKey || blueprintSpec?.titleKey,
+        themeId: pageSpec.themeId || blueprintSpec?.themeId || templateEntry?.page?.themeId,
+        chrome: pageSpec.chrome || blueprintSpec?.chrome || templateEntry?.page?.chrome,
+        sections: resolvedSections.map((section) => resolveSectionWithCatalog(section, resolvedProfile, catalog)),
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/core/catalog.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.test.d.ts","sourceRoot":"","sources":["../../src/core/catalog.test.ts"],"names":[],"mappings":""}

package/dist/core/catalog.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect } from 'vitest';
+import { mergePresentation, isGovernanceAllowed, resolvePageSpecWithCatalog } from './catalog.js';
+const emptyCatalog = {
+    version: '1',
+    templates: {},
+    sectionPresets: {},
+    transitionProfiles: {},
+    pageBlueprints: {},
+};
+describe('mergePresentation', () => {
+    it('returns undefined when all inputs are undefined', () => {
+        expect(mergePresentation(undefined, undefined, undefined)).toBeUndefined();
+    });
+    it('merges preset + inline', () => {
+        const result = mergePresentation({ surface: 'muted', tone: 'default' }, undefined, { tone: 'elevated' });
+        expect(result).toEqual({ surface: 'muted', tone: 'elevated' });
+    });
+    it('inline overrides transition overrides preset', () => {
+        const result = mergePresentation({ surface: 'muted' }, { surface: 'accent' }, { surface: 'dark' });
+        expect(result?.surface).toBe('dark');
+    });
+});
+describe('isGovernanceAllowed', () => {
+    it('allows everything when no governance', () => {
+        expect(isGovernanceAllowed('hero', 'home-signature')).toBe(true);
+    });
+    it('blocks section type not in allowedSectionTypes', () => {
+        expect(isGovernanceAllowed('hero', 'home-signature', {
+            allowedSectionTypes: ['cards', 'cta'],
+        })).toBe(false);
+    });
+    it('allows section type in allowedSectionTypes', () => {
+        expect(isGovernanceAllowed('cards', 'home-signature', {
+            allowedSectionTypes: ['cards', 'cta'],
+        })).toBe(true);
+    });
+    it('blocks page profile not in allowedPageProfiles', () => {
+        expect(isGovernanceAllowed('hero', 'conversion-form', {
+            allowedPageProfiles: ['home-signature'],
+        })).toBe(false);
+    });
+    it('allows page profile in allowedPageProfiles', () => {
+        expect(isGovernanceAllowed('hero', 'home-signature', {
+            allowedPageProfiles: ['home-signature'],
+        })).toBe(true);
+    });
+    it('blocks when page profile is undefined', () => {
+        expect(isGovernanceAllowed('hero', undefined, {
+            allowedPageProfiles: ['home-signature'],
+        })).toBe(false);
+    });
+});
+describe('resolvePageSpecWithCatalog', () => {
+    it('passes through a spec with no catalog refs', () => {
+        const spec = {
+            version: '1',
+            id: 'test',
+            sections: [{ type: 'hero', titleKey: 'h1' }],
+        };
+        const resolved = resolvePageSpecWithCatalog(spec, emptyCatalog);
+        expect(resolved.id).toBe('test');
+        expect(resolved.sections).toHaveLength(1);
+    });
+    it('resolves preset presentation', () => {
+        const catalog = {
+            ...emptyCatalog,
+            sectionPresets: {
+                'hero-home': { presentation: { surface: 'shell-dark', tone: 'immersive' } },
+            },
+        };
+        const spec = {
+            version: '1',
+            id: 'test',
+            sections: [{
+                    type: 'hero',
+                    titleKey: 'h1',
+                    presentation: { presetId: 'hero-home' },
+                }],
+        };
+        const resolved = resolvePageSpecWithCatalog(spec, catalog);
+        expect(resolved.sections[0].presentation?.surface).toBe('shell-dark');
+        expect(resolved.sections[0].presentation?.tone).toBe('immersive');
+    });
+    it('resolves template and blueprint', () => {
+        const catalog = {
+            ...emptyCatalog,
+            templates: {
+                'product-tpl': { page: { profile: 'product-surface', themeId: 'dark' } },
+            },
+            pageBlueprints: {
+                'product-bp': {
+                    spec: {
+                        version: '1',
+                        id: 'blueprint',
+                        templateId: 'product-tpl',
+                        sections: [{ type: 'hero', titleKey: 'bp.hero' }],
+                    },
+                },
+            },
+        };
+        const spec = {
+            version: '1',
+            id: 'my-page',
+            blueprintId: 'product-bp',
+            sections: [],
+        };
+        const resolved = resolvePageSpecWithCatalog(spec, catalog);
+        expect(resolved.id).toBe('my-page');
+        expect(resolved.profile).toBe('product-surface');
+        expect(resolved.themeId).toBe('dark');
+        expect(resolved.sections).toHaveLength(1);
+        expect(resolved.sections[0].titleKey).toBe('bp.hero');
+    });
+});
+//# sourceMappingURL=catalog.test.js.map

package/dist/core/catalog.test.js.map

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

package/dist/core/contrast.d.ts

@@ -0,0 +1,42 @@
+/**
+ * WCAG Contrast Checker — pure luminance-based contrast ratio calculation.
+ * Implements WCAG 2.1 relative luminance and contrast ratio formulas.
+ * No DOM, no canvas.
+ */
+export type ContrastLevel = 'AA' | 'AAA';
+export type ContrastResult = {
+    ratio: number;
+    passes: boolean;
+    level: ContrastLevel;
+    foreground: string;
+    background: string;
+};
+/**
+ * Parse a hex color string to [r, g, b] (0-255).
+ * Supports #RGB, #RRGGBB, #RRGGBBAA.
+ */
+export declare function parseHexColor(hex: string): [number, number, number] | null;
+/**
+ * Parse rgb(r, g, b) or rgba(r, g, b, a) to [r, g, b].
+ */
+export declare function parseRgbColor(rgb: string): [number, number, number] | null;
+/**
+ * Parse a color string (hex or rgb/rgba) to [r, g, b].
+ */
+export declare function parseColor(color: string): [number, number, number] | null;
+/**
+ * Compute relative luminance per WCAG 2.1.
+ * https://www.w3.org/TR/WCAG21/#dfn-relative-luminance
+ */
+export declare function relativeLuminance(r: number, g: number, b: number): number;
+/**
+ * Compute contrast ratio between two luminance values.
+ * https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio
+ */
+export declare function contrastRatio(l1: number, l2: number): number;
+/**
+ * Check WCAG contrast between two colors.
+ * Returns ratio, pass/fail, and the level tested.
+ */
+export declare function checkWcagContrast(foreground: string, background: string, level?: ContrastLevel): ContrastResult;
+//# sourceMappingURL=contrast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/core/contrast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,KAAK,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiB1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI5D;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,aAAoB,GAC5B,cAAc,CAmBhB"}

package/dist/core/contrast.js

@@ -0,0 +1,98 @@
+/**
+ * WCAG Contrast Checker — pure luminance-based contrast ratio calculation.
+ * Implements WCAG 2.1 relative luminance and contrast ratio formulas.
+ * No DOM, no canvas.
+ */
+/**
+ * Parse a hex color string to [r, g, b] (0-255).
+ * Supports #RGB, #RRGGBB, #RRGGBBAA.
+ */
+export function parseHexColor(hex) {
+    const clean = hex.replace('#', '');
+    if (clean.length === 3) {
+        return [
+            parseInt(clean[0] + clean[0], 16),
+            parseInt(clean[1] + clean[1], 16),
+            parseInt(clean[2] + clean[2], 16),
+        ];
+    }
+    if (clean.length === 6 || clean.length === 8) {
+        return [
+            parseInt(clean.slice(0, 2), 16),
+            parseInt(clean.slice(2, 4), 16),
+            parseInt(clean.slice(4, 6), 16),
+        ];
+    }
+    return null;
+}
+/**
+ * Parse rgb(r, g, b) or rgba(r, g, b, a) to [r, g, b].
+ */
+export function parseRgbColor(rgb) {
+    const match = rgb.match(/rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/);
+    if (!match)
+        return null;
+    return [parseInt(match[1]), parseInt(match[2]), parseInt(match[3])];
+}
+/**
+ * Parse a color string (hex or rgb/rgba) to [r, g, b].
+ */
+export function parseColor(color) {
+    const trimmed = color.trim().toLowerCase();
+    if (trimmed.startsWith('#'))
+        return parseHexColor(trimmed);
+    if (trimmed.startsWith('rgb'))
+        return parseRgbColor(trimmed);
+    return null;
+}
+/**
+ * Compute relative luminance per WCAG 2.1.
+ * https://www.w3.org/TR/WCAG21/#dfn-relative-luminance
+ */
+export function relativeLuminance(r, g, b) {
+    const [rs, gs, bs] = [r, g, b].map(c => {
+        const sRGB = c / 255;
+        return sRGB <= 0.04045
+            ? sRGB / 12.92
+            : Math.pow((sRGB + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+}
+/**
+ * Compute contrast ratio between two luminance values.
+ * https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio
+ */
+export function contrastRatio(l1, l2) {
+    const lighter = Math.max(l1, l2);
+    const darker = Math.min(l1, l2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Minimum contrast ratios per WCAG 2.1 for normal text.
+ */
+const MIN_RATIO = {
+    AA: 4.5,
+    AAA: 7.0,
+};
+/**
+ * Check WCAG contrast between two colors.
+ * Returns ratio, pass/fail, and the level tested.
+ */
+export function checkWcagContrast(foreground, background, level = 'AA') {
+    const fg = parseColor(foreground);
+    const bg = parseColor(background);
+    if (!fg || !bg) {
+        return { ratio: 0, passes: false, level, foreground, background };
+    }
+    const fgLum = relativeLuminance(...fg);
+    const bgLum = relativeLuminance(...bg);
+    const ratio = contrastRatio(fgLum, bgLum);
+    return {
+        ratio: Math.round(ratio * 100) / 100,
+        passes: ratio >= MIN_RATIO[level],
+        level,
+        foreground,
+        background,
+    };
+}
+//# sourceMappingURL=contrast.js.map

package/dist/core/contrast.js.map

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

package/dist/core/contrast.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contrast.test.d.ts.map

package/dist/core/contrast.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.test.d.ts","sourceRoot":"","sources":["../../src/core/contrast.test.ts"],"names":[],"mappings":""}

package/dist/core/contrast.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect } from 'vitest';
+import { parseHexColor, parseRgbColor, parseColor, relativeLuminance, contrastRatio, checkWcagContrast, } from './contrast.js';
+describe('parseHexColor', () => {
+    it('parses #RGB shorthand', () => {
+        expect(parseHexColor('#fff')).toEqual([255, 255, 255]);
+        expect(parseHexColor('#000')).toEqual([0, 0, 0]);
+    });
+    it('parses #RRGGBB', () => {
+        expect(parseHexColor('#ff0000')).toEqual([255, 0, 0]);
+        expect(parseHexColor('#00ff00')).toEqual([0, 255, 0]);
+    });
+    it('parses #RRGGBBAA (ignores alpha)', () => {
+        expect(parseHexColor('#ff000080')).toEqual([255, 0, 0]);
+    });
+    it('returns null for invalid', () => {
+        expect(parseHexColor('#gg')).toBeNull();
+    });
+});
+describe('parseRgbColor', () => {
+    it('parses rgb()', () => {
+        expect(parseRgbColor('rgb(255, 0, 0)')).toEqual([255, 0, 0]);
+    });
+    it('parses rgba()', () => {
+        expect(parseRgbColor('rgba(0, 128, 255, 0.5)')).toEqual([0, 128, 255]);
+    });
+    it('returns null for invalid', () => {
+        expect(parseRgbColor('hsl(0, 100%, 50%)')).toBeNull();
+    });
+});
+describe('parseColor', () => {
+    it('delegates to hex parser', () => {
+        expect(parseColor('#f00')).toEqual([255, 0, 0]);
+    });
+    it('delegates to rgb parser', () => {
+        expect(parseColor('rgb(0, 0, 0)')).toEqual([0, 0, 0]);
+    });
+    it('returns null for unsupported', () => {
+        expect(parseColor('red')).toBeNull();
+    });
+});
+describe('relativeLuminance', () => {
+    it('white has luminance ~1', () => {
+        expect(relativeLuminance(255, 255, 255)).toBeCloseTo(1.0, 2);
+    });
+    it('black has luminance 0', () => {
+        expect(relativeLuminance(0, 0, 0)).toBe(0);
+    });
+});
+describe('contrastRatio', () => {
+    it('black on white = 21:1', () => {
+        const ratio = contrastRatio(1.0, 0.0);
+        expect(ratio).toBeCloseTo(21, 0);
+    });
+    it('same color = 1:1', () => {
+        expect(contrastRatio(0.5, 0.5)).toBeCloseTo(1, 1);
+    });
+});
+describe('checkWcagContrast', () => {
+    it('black on white passes AA', () => {
+        const result = checkWcagContrast('#000000', '#ffffff', 'AA');
+        expect(result.passes).toBe(true);
+        expect(result.ratio).toBeGreaterThan(20);
+    });
+    it('black on white passes AAA', () => {
+        const result = checkWcagContrast('#000', '#fff', 'AAA');
+        expect(result.passes).toBe(true);
+    });
+    it('light gray on white fails AA', () => {
+        const result = checkWcagContrast('#cccccc', '#ffffff', 'AA');
+        expect(result.passes).toBe(false);
+    });
+    it('returns ratio 0 for unparseable colors', () => {
+        const result = checkWcagContrast('invalid', '#fff');
+        expect(result.ratio).toBe(0);
+        expect(result.passes).toBe(false);
+    });
+    it('defaults to AA level', () => {
+        const result = checkWcagContrast('#000', '#fff');
+        expect(result.level).toBe('AA');
+    });
+});
+//# sourceMappingURL=contrast.test.js.map

package/dist/core/contrast.test.js.map

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

package/dist/core/css-named-colors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CSS Named Colors — the 148 standard CSS color keywords.
+ * Used by checkNoNamedColor() to detect hardcoded color names in CSS.
+ * Source: https://www.w3.org/TR/css-color-4/#named-colors + transparent/currentcolor
+ */
+export declare const CSS_NAMED_COLORS: Set<string>;
+//# sourceMappingURL=css-named-colors.d.ts.map

package/dist/core/css-named-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-named-colors.d.ts","sourceRoot":"","sources":["../../src/core/css-named-colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB,aAsC3B,CAAC"}

package/dist/core/css-named-colors.js

@@ -0,0 +1,45 @@
+/**
+ * CSS Named Colors — the 148 standard CSS color keywords.
+ * Used by checkNoNamedColor() to detect hardcoded color names in CSS.
+ * Source: https://www.w3.org/TR/css-color-4/#named-colors + transparent/currentcolor
+ */
+export const CSS_NAMED_COLORS = new Set([
+    'aliceblue', 'antiquewhite', 'aqua', 'aquamarine', 'azure',
+    'beige', 'bisque', 'black', 'blanchedalmond', 'blue',
+    'blueviolet', 'brown', 'burlywood',
+    'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue',
+    'cornsilk', 'crimson', 'cyan',
+    'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen',
+    'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange',
+    'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue',
+    'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet',
+    'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue',
+    'firebrick', 'floralwhite', 'forestgreen', 'fuchsia',
+    'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'gray', 'green',
+    'greenyellow', 'grey',
+    'honeydew', 'hotpink',
+    'indianred', 'indigo', 'ivory',
+    'khaki',
+    'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue',
+    'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen',
+    'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue',
+    'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow',
+    'lime', 'limegreen', 'linen',
+    'magenta', 'maroon', 'mediumaquamarine', 'mediumblue', 'mediumorchid',
+    'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen',
+    'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream',
+    'mistyrose', 'moccasin',
+    'navajowhite', 'navy',
+    'oldlace', 'olive', 'olivedrab', 'orange', 'orangered', 'orchid',
+    'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip',
+    'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'purple',
+    'rebeccapurple', 'red', 'rosybrown', 'royalblue',
+    'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna',
+    'silver', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow',
+    'springgreen', 'steelblue',
+    'tan', 'teal', 'thistle', 'tomato', 'turquoise',
+    'violet',
+    'wheat', 'white', 'whitesmoke',
+    'yellow', 'yellowgreen',
+]);
+//# sourceMappingURL=css-named-colors.js.map

package/dist/core/css-named-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-named-colors.js","sourceRoot":"","sources":["../../src/core/css-named-colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IACtC,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO;IAC1D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM;IACpD,YAAY,EAAE,OAAO,EAAE,WAAW;IAClC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB;IACjE,UAAU,EAAE,SAAS,EAAE,MAAM;IAC7B,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW;IAChE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY;IACtE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe;IACtE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY;IAC/D,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY;IAC7D,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS;IACpD,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO;IAC/D,aAAa,EAAE,MAAM;IACrB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,QAAQ,EAAE,OAAO;IAC9B,OAAO;IACP,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW;IACrE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY;IAC5E,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc;IACxE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa;IACnE,MAAM,EAAE,WAAW,EAAE,OAAO;IAC5B,SAAS,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc;IACrE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB;IACxE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW;IACjE,WAAW,EAAE,UAAU;IACvB,aAAa,EAAE,MAAM;IACrB,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ;IAChE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY;IAC5E,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ;IAC3D,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW;IAChD,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ;IACvE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;IAClE,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW;IAC/C,QAAQ;IACR,OAAO,EAAE,OAAO,EAAE,YAAY;IAC9B,QAAQ,EAAE,aAAa;CACxB,CAAC,CAAC"}

package/dist/core/guardrails.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core Guardrails — the 10 Sovereign Laws of Valentino Engine.
+ * Each law is a programmatic check, not just documentation.
+ */
+export declare const GUARDRAILS: {
+    /** G1: No hardcoded px values in component overrides */
+    readonly NO_HARDCODED_PX: RegExp;
+    /** G2: No RGBA or HEX hardcoded colors */
+    readonly NO_HARDCODED_COLOR: RegExp;
+    /** G3: No direct DOM style manipulation */
+    readonly NO_INLINE_STYLE: RegExp;
+};
+export declare function checkNoHardcodedPx(css: string): string[];
+export declare function checkNoHardcodedColor(css: string): string[];
+export declare function checkNoNamedColor(css: string): string[];
+//# sourceMappingURL=guardrails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,UAAU;IACrB,wDAAwD;;IAGxD,0CAA0C;;IAG1C,2CAA2C;;CAEnC,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAS3D;AASD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD"}

package/dist/core/guardrails.js

@@ -0,0 +1,55 @@
+/**
+ * Core Guardrails — the 10 Sovereign Laws of Valentino Engine.
+ * Each law is a programmatic check, not just documentation.
+ */
+import { CSS_NAMED_COLORS } from './css-named-colors.js';
+export const GUARDRAILS = {
+    /** G1: No hardcoded px values in component overrides */
+    NO_HARDCODED_PX: /(?<!\d)(\d+)px(?!\s*[/*])/,
+    /** G2: No RGBA or HEX hardcoded colors */
+    NO_HARDCODED_COLOR: /#[0-9a-fA-F]{3,8}|rgba?\(/,
+    /** G3: No direct DOM style manipulation */
+    NO_INLINE_STYLE: /\.style\.(padding|margin|color|background)\s*=/,
+};
+export function checkNoHardcodedPx(css) {
+    const violations = [];
+    const lines = css.split('\n');
+    lines.forEach((line, i) => {
+        if (GUARDRAILS.NO_HARDCODED_PX.test(line)) {
+            violations.push(`Line ${i + 1}: Hardcoded px detected — use --valentino-rhythm-* variables. "${line.trim()}"`);
+        }
+    });
+    return violations;
+}
+export function checkNoHardcodedColor(css) {
+    const violations = [];
+    const lines = css.split('\n');
+    lines.forEach((line, i) => {
+        if (GUARDRAILS.NO_HARDCODED_COLOR.test(line)) {
+            violations.push(`Line ${i + 1}: Hardcoded color detected — use CSS root variables. "${line.trim()}"`);
+        }
+    });
+    return violations;
+}
+/**
+ * Detect CSS named colors (red, blue, navy, etc.) used as property values.
+ * Matches after a colon in CSS declarations to avoid false positives in
+ * selectors, comments, or class names.
+ */
+const CSS_VALUE_WORD_RE = /:\s*([a-z]+)\s*[;!}]/gi;
+export function checkNoNamedColor(css) {
+    const violations = [];
+    const lines = css.split('\n');
+    lines.forEach((line, i) => {
+        CSS_VALUE_WORD_RE.lastIndex = 0;
+        let match;
+        while ((match = CSS_VALUE_WORD_RE.exec(line)) !== null) {
+            const word = match[1].toLowerCase();
+            if (CSS_NAMED_COLORS.has(word)) {
+                violations.push(`Line ${i + 1}: Named CSS color "${word}" detected — use CSS root variables. "${line.trim()}"`);
+            }
+        }
+    });
+    return violations;
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/core/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wDAAwD;IACxD,eAAe,EAAE,2BAA2B;IAE5C,0CAA0C;IAC1C,kBAAkB,EAAE,2BAA2B;IAE/C,2CAA2C;IAC3C,eAAe,EAAE,gDAAgD;CACzD,CAAC;AAEX,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,kEAAkE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,IAAI,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,yDAAyD,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxG,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,iBAAiB,CAAC,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,IAAI,yCAAyC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/guardrails.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guardrails.test.d.ts.map

package/dist/core/guardrails.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.test.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.test.ts"],"names":[],"mappings":""}