@hale-bopp/valentino-engine 2.2.0 → 2.3.0

package/dist/core/cockpit-repl.js.map

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

package/dist/core/contrast-usage-probe.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Contrast Usage Probe — static CSS analysis for unremediated text variables.
+ *
+ * Scans CSS to find text/accent CSS variables used in selectors that could
+ * render on light surfaces WITHOUT being remapped by a surface-aware override.
+ *
+ * Catches: `.card-desc { color: var(--text-secondary) }` used inside
+ * `.valentino-section-shell[data-surface='default']` where --text-secondary
+ * is NOT remapped to a surface-safe value.
+ *
+ * Pure function, zero DOM.
+ */
+export type ContrastUsageWarning = {
+    /** CSS variable used as foreground color */
+    token: string;
+    /** The CSS selector where it's used */
+    selector: string;
+    /** Line number in the CSS file */
+    line: number;
+    /** Surfaces where the token is NOT remapped */
+    unremappedSurfaces: string[];
+    /** Severity: error if used on light surfaces without remap */
+    severity: 'warning' | 'error';
+    message: string;
+};
+export type ContrastUsageProbeResult = {
+    warnings: ContrastUsageWarning[];
+    /** Tokens that ARE properly remapped per surface */
+    remappedTokens: Map<string, string[]>;
+    valid: boolean;
+};
+/**
+ * Parse which tokens are remapped in each surface block.
+ * Returns: Map<tokenName, surfaceName[]>
+ */
+export declare function parseRemappedTokens(css: string): Map<string, string[]>;
+/**
+ * Find all text/accent CSS variable usages outside of surface remap blocks.
+ * Returns: Array of {token, selector, line}
+ */
+export declare function parseTextTokenUsages(css: string): Array<{
+    token: string;
+    selector: string;
+    line: number;
+}>;
+/**
+ * Probe CSS for text/accent variables that are used on elements which could
+ * appear inside light surfaces, but are NOT remapped in those surface blocks.
+ *
+ * @param css - Full CSS content (e.g., framework.css)
+ * @param options.textTokens - Specific tokens to check. If omitted, discovers all var(--text-*) usages.
+ */
+export declare function probeContrastUsage(css: string): ContrastUsageProbeResult;
+/**
+ * Extract CSS from Shadow DOM Web Component source files.
+ * Looks for tagged template literals containing <style> blocks,
+ * which is the standard pattern for Lit/vanilla Shadow DOM components.
+ *
+ * Returns array of { componentName, css } for each component found.
+ */
+export declare function extractShadowDomStyles(source: string, fileName?: string): Array<{
+    componentName: string;
+    css: string;
+}>;
+export type ContrastUsageMultiResult = {
+    /** Combined warnings from all sources */
+    warnings: ContrastUsageWarning[];
+    /** Per-source results for reporting */
+    sources: Array<{
+        source: string;
+        warningCount: number;
+    }>;
+    valid: boolean;
+};
+/**
+ * Probe multiple CSS sources at once (framework.css + Shadow DOM components).
+ * Surface remaps are read from the primary CSS (framework.css).
+ * Token usages are collected from ALL sources (framework + components).
+ */
+export declare function probeContrastUsageMulti(primaryCss: string, additionalSources?: Array<{
+    name: string;
+    css: string;
+}>): ContrastUsageMultiResult;
+//# sourceMappingURL=contrast-usage-probe.d.ts.map

package/dist/core/contrast-usage-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-usage-probe.d.ts","sourceRoot":"","sources":["../../src/core/contrast-usage-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,oDAAoD;IACpD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AA6CF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAoBtE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D1G;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAuCxE;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB,KAAK,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAc/C;AAID,MAAM,MAAM,wBAAwB,GAAG;IACnC,yCAAyC;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD,wBAAwB,CAiD1B"}

package/dist/core/contrast-usage-probe.js

@@ -0,0 +1,244 @@
+/**
+ * Contrast Usage Probe — static CSS analysis for unremediated text variables.
+ *
+ * Scans CSS to find text/accent CSS variables used in selectors that could
+ * render on light surfaces WITHOUT being remapped by a surface-aware override.
+ *
+ * Catches: `.card-desc { color: var(--text-secondary) }` used inside
+ * `.valentino-section-shell[data-surface='default']` where --text-secondary
+ * is NOT remapped to a surface-safe value.
+ *
+ * Pure function, zero DOM.
+ */
+import { inferTokenRole } from './theme-audit.js';
+// ── Surface detection ────────────────────────────────────────────────────────
+const LIGHT_SURFACES = ['default', 'muted', 'accent', 'reading-light', 'ops-light'];
+const DARK_SURFACES = ['dark', 'shell-dark'];
+/** Pattern to find surface-scoped blocks that remap a variable */
+const SURFACE_REMAP_RE = /\.valentino-section-shell\[data-surface=['"]([^'"]+)['"]\]\s*\{([^}]+)\}/g;
+/** Pattern to find var(--token) usage in CSS property values */
+const VAR_USAGE_RE = /:\s*var\((--[a-z][a-z0-9-]*)\)/g;
+/** Pattern to find rgba(var(--rgb-*), alpha) usage — common for glow/shadow on interactive states */
+const RGBA_VAR_USAGE_RE = /rgba\(\s*var\((--rgb-[a-z][a-z0-9-]*)\)/g;
+/**
+ * Tokens that contain "text" or "font" in their name but are NOT colors.
+ * These are size/typography tokens and should be excluded from contrast checks.
+ */
+function isNonColorToken(token) {
+    const lower = token.toLowerCase();
+    // Font family, size steps, line heights, letter spacing
+    if (lower.includes('font-family') || lower.includes('font-size') || lower.includes('font-weight'))
+        return true;
+    if (/--text-step-\d/.test(lower))
+        return true;
+    if (lower.includes('leading') || lower.includes('tracking') || lower.includes('measure'))
+        return true;
+    return false;
+}
+/**
+ * Tokens scoped to a specific surface kind in their name (e.g., --action-widget-dark-*)
+ * should not be checked against the opposite surface kind.
+ */
+function isSurfaceScopedToken(token) {
+    const lower = token.toLowerCase();
+    if (lower.includes('-dark-'))
+        return 'dark';
+    if (lower.includes('-light-'))
+        return 'light';
+    return null;
+}
+/** Pattern to find variable definitions (--token: value) */
+const VAR_DEFINE_RE = /(--[a-z][a-z0-9-]*):\s*var\((--[a-z][a-z0-9-]*)\)|(-[a-z][a-z0-9-]*):\s*([^;]+)/g;
+// ── Core probe ───────────────────────────────────────────────────────────────
+/**
+ * Parse which tokens are remapped in each surface block.
+ * Returns: Map<tokenName, surfaceName[]>
+ */
+export function parseRemappedTokens(css) {
+    const remaps = new Map();
+    let match;
+    SURFACE_REMAP_RE.lastIndex = 0;
+    while ((match = SURFACE_REMAP_RE.exec(css)) !== null) {
+        const surfaceName = match[1];
+        const blockContent = match[2];
+        // Find all variable definitions in this surface block
+        const defRe = /(--[a-z][a-z0-9-]*):/g;
+        let defMatch;
+        while ((defMatch = defRe.exec(blockContent)) !== null) {
+            const token = defMatch[1];
+            if (!remaps.has(token))
+                remaps.set(token, []);
+            remaps.get(token).push(surfaceName);
+        }
+    }
+    return remaps;
+}
+/**
+ * Find all text/accent CSS variable usages outside of surface remap blocks.
+ * Returns: Array of {token, selector, line}
+ */
+export function parseTextTokenUsages(css) {
+    const usages = [];
+    const lines = css.split('\n');
+    // Track which line ranges are inside surface remap blocks (skip those)
+    const surfaceBlockRanges = [];
+    SURFACE_REMAP_RE.lastIndex = 0;
+    let blockMatch;
+    while ((blockMatch = SURFACE_REMAP_RE.exec(css)) !== null) {
+        const startOffset = blockMatch.index;
+        const endOffset = startOffset + blockMatch[0].length;
+        const startLine = css.substring(0, startOffset).split('\n').length;
+        const endLine = css.substring(0, endOffset).split('\n').length;
+        surfaceBlockRanges.push({ start: startLine, end: endLine });
+    }
+    function isInsideSurfaceBlock(lineNum) {
+        return surfaceBlockRanges.some(r => lineNum >= r.start && lineNum <= r.end);
+    }
+    // Simple CSS selector tracker
+    let currentSelector = '';
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        const line = lines[i].trim();
+        // Skip lines inside surface remap blocks
+        if (isInsideSurfaceBlock(lineNum))
+            continue;
+        // Track selectors (crude but effective for this purpose)
+        if (line.includes('{') && !line.startsWith('/*')) {
+            currentSelector = line.replace(/\s*\{.*/, '').trim();
+        }
+        // Find var(--token) usages
+        VAR_USAGE_RE.lastIndex = 0;
+        let varMatch;
+        while ((varMatch = VAR_USAGE_RE.exec(line)) !== null) {
+            const token = varMatch[1];
+            if (isNonColorToken(token))
+                continue;
+            const role = inferTokenRole(token);
+            if (role === 'text' || role === 'accent') {
+                usages.push({ token, selector: currentSelector, line: lineNum });
+            }
+        }
+        // Also catch rgba(var(--rgb-*)) pattern — map --rgb-X to its parent --X token
+        RGBA_VAR_USAGE_RE.lastIndex = 0;
+        let rgbaMatch;
+        while ((rgbaMatch = RGBA_VAR_USAGE_RE.exec(line)) !== null) {
+            const rgbToken = rgbaMatch[1]; // e.g. --rgb-neural-cyan
+            // Infer the parent token: --rgb-neural-cyan → --accent-neural-cyan
+            // These are used in color/background contexts so they're accent-like
+            usages.push({ token: rgbToken, selector: currentSelector, line: lineNum });
+        }
+    }
+    return usages;
+}
+/**
+ * Probe CSS for text/accent variables that are used on elements which could
+ * appear inside light surfaces, but are NOT remapped in those surface blocks.
+ *
+ * @param css - Full CSS content (e.g., framework.css)
+ * @param options.textTokens - Specific tokens to check. If omitted, discovers all var(--text-*) usages.
+ */
+export function probeContrastUsage(css) {
+    const remappedTokens = parseRemappedTokens(css);
+    const usages = parseTextTokenUsages(css);
+    const warnings = [];
+    // For each text token usage, check if it's remapped in all light surfaces
+    const checkedTokens = new Set();
+    for (const usage of usages) {
+        // Only warn once per token (not per usage)
+        if (checkedTokens.has(usage.token))
+            continue;
+        checkedTokens.add(usage.token);
+        const remappedIn = remappedTokens.get(usage.token) ?? [];
+        // Skip tokens scoped to a specific surface kind (e.g., --action-widget-dark-text)
+        const scopedKind = isSurfaceScopedToken(usage.token);
+        if (scopedKind === 'dark')
+            continue; // Dark-scoped tokens don't need light remaps
+        const surfacesToCheck = scopedKind === 'light' ? LIGHT_SURFACES : LIGHT_SURFACES;
+        const missingLightSurfaces = surfacesToCheck.filter(s => !remappedIn.includes(s));
+        if (missingLightSurfaces.length > 0) {
+            warnings.push({
+                token: usage.token,
+                selector: usage.selector,
+                line: usage.line,
+                unremappedSurfaces: missingLightSurfaces,
+                severity: 'error',
+                message: `"${usage.token}" used in "${usage.selector}" (line ${usage.line}) is not remapped in light surfaces: ${missingLightSurfaces.join(', ')}. Text may be invisible on white backgrounds.`,
+            });
+        }
+    }
+    return {
+        warnings,
+        remappedTokens,
+        valid: warnings.length === 0,
+    };
+}
+// ── Shadow DOM extraction ────────────────────────────────────────────────────
+/**
+ * Extract CSS from Shadow DOM Web Component source files.
+ * Looks for tagged template literals containing <style> blocks,
+ * which is the standard pattern for Lit/vanilla Shadow DOM components.
+ *
+ * Returns array of { componentName, css } for each component found.
+ */
+export function extractShadowDomStyles(source, fileName) {
+    const results = [];
+    // Match <style>...</style> inside template literals
+    const styleRe = /<style>([\s\S]*?)<\/style>/g;
+    let match;
+    while ((match = styleRe.exec(source)) !== null) {
+        results.push({
+            componentName: fileName ?? 'unknown-component',
+            css: match[1],
+        });
+    }
+    return results;
+}
+/**
+ * Probe multiple CSS sources at once (framework.css + Shadow DOM components).
+ * Surface remaps are read from the primary CSS (framework.css).
+ * Token usages are collected from ALL sources (framework + components).
+ */
+export function probeContrastUsageMulti(primaryCss, additionalSources) {
+    // Remaps only come from the primary CSS (framework.css has the surface blocks)
+    const remappedTokens = parseRemappedTokens(primaryCss);
+    // Collect usages from all sources
+    const allSources = [
+        { name: 'framework.css', css: primaryCss },
+        ...(additionalSources ?? []),
+    ];
+    const warnings = [];
+    const checkedTokens = new Set();
+    const sourceSummary = [];
+    for (const { name, css } of allSources) {
+        const usages = parseTextTokenUsages(css);
+        let sourceWarnings = 0;
+        for (const usage of usages) {
+            if (checkedTokens.has(usage.token))
+                continue;
+            checkedTokens.add(usage.token);
+            const remappedIn = remappedTokens.get(usage.token) ?? [];
+            const scopedKind = isSurfaceScopedToken(usage.token);
+            if (scopedKind === 'dark')
+                continue;
+            const missingLightSurfaces = LIGHT_SURFACES.filter(s => !remappedIn.includes(s));
+            if (missingLightSurfaces.length > 0) {
+                sourceWarnings++;
+                warnings.push({
+                    token: usage.token,
+                    selector: usage.selector,
+                    line: usage.line,
+                    unremappedSurfaces: missingLightSurfaces,
+                    severity: 'error',
+                    message: `[${name}] "${usage.token}" used in "${usage.selector}" (line ${usage.line}) is not remapped in light surfaces: ${missingLightSurfaces.join(', ')}`,
+                });
+            }
+        }
+        sourceSummary.push({ source: name, warningCount: sourceWarnings });
+    }
+    return {
+        warnings,
+        sources: sourceSummary,
+        valid: warnings.length === 0,
+    };
+}
+//# sourceMappingURL=contrast-usage-probe.js.map

package/dist/core/contrast-usage-probe.js.map

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

package/dist/core/contrast-usage-probe.test.d.ts

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

package/dist/core/contrast-usage-probe.test.d.ts.map

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

package/dist/core/contrast-usage-probe.test.js

@@ -0,0 +1,186 @@
+import { describe, it, expect } from 'vitest';
+import { probeContrastUsage, probeContrastUsageMulti, parseRemappedTokens, parseTextTokenUsages, extractShadowDomStyles, } from './contrast-usage-probe.js';
+// ── parseRemappedTokens ──────────────────────────────────────────────────────
+describe('parseRemappedTokens', () => {
+    it('detects tokens remapped in surface blocks', () => {
+        const css = `
+.valentino-section-shell[data-surface='default'] {
+    --valentino-surface-bg: #ffffff;
+    --text-secondary: var(--valentino-surface-default-text-muted);
+}
+.valentino-section-shell[data-surface='muted'] {
+    --text-secondary: var(--valentino-surface-muted-text-muted);
+}`;
+        const result = parseRemappedTokens(css);
+        expect(result.get('--text-secondary')).toContain('default');
+        expect(result.get('--text-secondary')).toContain('muted');
+    });
+    it('returns empty map for CSS without surface blocks', () => {
+        const css = `.nav-links a { color: var(--text-secondary); }`;
+        const result = parseRemappedTokens(css);
+        expect(result.size).toBe(0);
+    });
+});
+// ── parseTextTokenUsages ─────────────────────────────────────────────────────
+describe('parseTextTokenUsages', () => {
+    it('finds text token usages outside surface blocks', () => {
+        const css = `.nav-links a { color: var(--text-secondary); }`;
+        const usages = parseTextTokenUsages(css);
+        expect(usages).toHaveLength(1);
+        expect(usages[0].token).toBe('--text-secondary');
+    });
+    it('skips usages inside surface remap blocks', () => {
+        const css = `
+.valentino-section-shell[data-surface='default'] {
+    --text-secondary: var(--valentino-surface-default-text-muted);
+}
+.card-desc { color: var(--text-secondary); }`;
+        const usages = parseTextTokenUsages(css);
+        // Only the .card-desc usage, not the remap inside the surface block
+        expect(usages).toHaveLength(1);
+        expect(usages[0].selector).toContain('card-desc');
+    });
+    it('ignores background tokens', () => {
+        const css = `.hero { background: var(--bg-deep-void); }`;
+        const usages = parseTextTokenUsages(css);
+        expect(usages).toHaveLength(0);
+    });
+    it('finds accent tokens', () => {
+        const css = `.link:hover { color: var(--accent-neural-cyan); }`;
+        const usages = parseTextTokenUsages(css);
+        expect(usages).toHaveLength(1);
+        expect(usages[0].token).toBe('--accent-neural-cyan');
+    });
+});
+// ── probeContrastUsage ───────────────────────────────────────────────────────
+describe('probeContrastUsage', () => {
+    it('warns when --text-secondary is used but not remapped in light surfaces', () => {
+        const css = `
+.valentino-section-shell[data-surface='default'] {
+    --valentino-surface-bg: #ffffff;
+    --valentino-surface-text: #0f172a;
+}
+.nav-links a { color: var(--text-secondary); }`;
+        const result = probeContrastUsage(css);
+        expect(result.valid).toBe(false);
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0].token).toBe('--text-secondary');
+        expect(result.warnings[0].unremappedSurfaces).toContain('default');
+    });
+    it('passes when --text-secondary is remapped in all light surfaces', () => {
+        const css = `
+.valentino-section-shell[data-surface='default'] { --text-secondary: #475569; }
+.valentino-section-shell[data-surface='muted'] { --text-secondary: #475569; }
+.valentino-section-shell[data-surface='accent'] { --text-secondary: #4b5563; }
+.valentino-section-shell[data-surface='reading-light'] { --text-secondary: #334155; }
+.valentino-section-shell[data-surface='ops-light'] { --text-secondary: #475569; }
+.nav-links a { color: var(--text-secondary); }`;
+        const result = probeContrastUsage(css);
+        expect(result.valid).toBe(true);
+    });
+    it('warns for multiple tokens independently', () => {
+        const css = `
+.hero h1 { color: var(--text-primary); }
+.card-desc { color: var(--text-secondary); }`;
+        const result = probeContrastUsage(css);
+        expect(result.warnings).toHaveLength(2);
+        const tokens = result.warnings.map(w => w.token);
+        expect(tokens).toContain('--text-primary');
+        expect(tokens).toContain('--text-secondary');
+    });
+    it('only warns once per token even if used multiple times', () => {
+        const css = `
+.nav-links a { color: var(--text-secondary); }
+.card-desc { color: var(--text-secondary); }
+.hero p.tagline { color: var(--text-secondary); }`;
+        const result = probeContrastUsage(css);
+        expect(result.warnings).toHaveLength(1);
+    });
+    it('no warnings for CSS with no text token usage', () => {
+        const css = `.hero { background: var(--bg-deep-void); padding: 2rem; }`;
+        const result = probeContrastUsage(css);
+        expect(result.valid).toBe(true);
+        expect(result.warnings).toHaveLength(0);
+    });
+    it('catches rgba(var(--rgb-*)) pattern used in hover states', () => {
+        const css = `.btn:hover { box-shadow: 0 0 10px rgba(var(--rgb-neural-cyan), 0.4); }`;
+        const result = probeContrastUsage(css);
+        const rgbWarnings = result.warnings.filter(w => w.token === '--rgb-neural-cyan');
+        expect(rgbWarnings.length).toBeGreaterThan(0);
+    });
+    it('skips dark-scoped tokens even with rgba pattern', () => {
+        const css = `.widget { color: var(--action-widget-dark-text); }`;
+        const result = probeContrastUsage(css);
+        const darkWarnings = result.warnings.filter(w => w.token === '--action-widget-dark-text');
+        expect(darkWarnings).toHaveLength(0);
+    });
+});
+// ── extractShadowDomStyles ───────────────────────────────────────────────────
+describe('extractShadowDomStyles', () => {
+    it('extracts CSS from <style> blocks in template literals', () => {
+        const source = `
+class MyComponent extends HTMLElement {
+    connectedCallback() {
+        this.attachShadow({ mode: 'open' });
+        this.shadowRoot.innerHTML = \`
+            <style>
+                .footer-col a { color: var(--text-secondary); }
+                .footer-col a:hover { color: var(--accent-neural-cyan); }
+            </style>
+            <div class="footer-col"><a href="/">Home</a></div>
+        \`;
+    }
+}`;
+        const styles = extractShadowDomStyles(source, 'my-component.ts');
+        expect(styles).toHaveLength(1);
+        expect(styles[0].componentName).toBe('my-component.ts');
+        expect(styles[0].css).toContain('--text-secondary');
+        expect(styles[0].css).toContain('--accent-neural-cyan');
+    });
+    it('extracts multiple <style> blocks', () => {
+        const source = `
+            <style>.a { color: var(--text-primary); }</style>
+            <style>.b { color: var(--text-secondary); }</style>
+        `;
+        const styles = extractShadowDomStyles(source, 'multi.ts');
+        expect(styles).toHaveLength(2);
+    });
+    it('returns empty for files without <style> blocks', () => {
+        const source = `export function helper() { return 42; }`;
+        expect(extractShadowDomStyles(source)).toEqual([]);
+    });
+});
+// ── probeContrastUsageMulti ──────────────────────────────────────────────────
+describe('probeContrastUsageMulti', () => {
+    const primaryCss = `
+.valentino-section-shell[data-surface='default'] {
+    --valentino-surface-bg: #ffffff;
+}
+.nav-links a { color: var(--text-secondary); }`;
+    it('finds warnings from primary CSS', () => {
+        const result = probeContrastUsageMulti(primaryCss);
+        expect(result.warnings.length).toBeGreaterThan(0);
+        expect(result.sources).toHaveLength(1);
+    });
+    it('finds warnings from additional Shadow DOM sources', () => {
+        const componentCss = `.footer-col a { color: var(--text-muted); }`;
+        const result = probeContrastUsageMulti(primaryCss, [
+            { name: 'sovereign-footer.ts', css: componentCss },
+        ]);
+        // --text-secondary from primary + --text-muted from component
+        const tokens = result.warnings.map(w => w.token);
+        expect(tokens).toContain('--text-secondary');
+        expect(tokens).toContain('--text-muted');
+        expect(result.sources).toHaveLength(2);
+    });
+    it('deduplicates tokens across sources', () => {
+        const componentCss = `.link { color: var(--text-secondary); }`;
+        const result = probeContrastUsageMulti(primaryCss, [
+            { name: 'component.ts', css: componentCss },
+        ]);
+        // --text-secondary appears in both but should warn only once
+        const textSecWarnings = result.warnings.filter(w => w.token === '--text-secondary');
+        expect(textSecWarnings).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=contrast-usage-probe.test.js.map

package/dist/core/contrast-usage-probe.test.js.map

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

package/dist/core/intent-parser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Intent Parser — Natural language → CockpitAction.
+ * Feature #778 (Il Sarto Parla), PBI #780 (Phase 1).
+ *
+ * Two modes:
+ * - Local (rule-based): regex patterns for IT/EN, always works, zero API.
+ * - LLM (callback): delegates to external LLM, validates output, falls back to local.
+ *
+ * Pure functions, no I/O, no LLM client.
+ */
+import type { CockpitAction } from './cockpit-api.js';
+import type { SectionSpec, PageSpecV1 } from './types.js';
+export type ParsedIntent = {
+    action: CockpitAction;
+    confidence: 'high' | 'medium' | 'low';
+    description: string;
+};
+export type IntentParseResult = {
+    intent: ParsedIntent | null;
+    mode: 'local' | 'llm';
+    raw: string;
+    fallbackReason?: string;
+};
+export type IntentLlmCallback = (prompt: string, context: IntentLlmContext) => Promise<unknown>;
+export type IntentLlmContext = {
+    pageSpec: PageSpecV1;
+    actionSchema: object;
+    sectionSchemas: Record<string, object>;
+    sectionSummary: Array<{
+        index: number;
+        type: string;
+        titleKey?: string;
+    }>;
+};
+declare function resolveSectionType(raw: string): string | null;
+declare function parseIndex(raw: string, totalSections: number): number | null;
+declare function buildMinimalSection(sectionType: string): SectionSpec;
+declare function buildSectionSummary(spec: PageSpecV1): Array<{
+    index: number;
+    type: string;
+    titleKey?: string;
+}>;
+/**
+ * Parse a natural language operator request into a CockpitAction.
+ *
+ * Supports IT and EN. If `llm` callback is provided, tries LLM first
+ * with automatic fallback to local rule-based parser.
+ *
+ * @example
+ * ```ts
+ * // Local mode
+ * const result = parseIntent("mostrami le sezioni", pageSpec);
+ *
+ * // LLM mode with fallback
+ * const result = await parseIntent("aggiungi una hero", pageSpec, myLlm);
+ * ```
+ */
+export declare function parseIntent(input: string, spec: PageSpecV1, llm?: IntentLlmCallback): Promise<IntentParseResult>;
+/**
+ * Synchronous local-only parsing. No LLM, always works.
+ */
+export declare function parseIntentLocal(input: string, spec: PageSpecV1): IntentParseResult;
+/**
+ * Exported for testing.
+ */
+export { resolveSectionType, parseIndex, buildMinimalSection, buildSectionSummary };
+//# sourceMappingURL=intent-parser.d.ts.map

package/dist/core/intent-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-parser.d.ts","sourceRoot":"","sources":["../../src/core/intent-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ1D,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,KACxB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,cAAc,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E,CAAC;AAiCF,iBAAS,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItD;AAgBD,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBrE;AAiQD,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAgC7D;AAyDD,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxG;AA4DD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,EAChB,GAAG,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAEnF;AAED;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}