@hale-bopp/valentino-engine 2.1.0 → 2.3.0

package/dist/core/theme-audit.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Theme Audit — static contrast analysis for theme-packs against surfaces.
+ *
+ * Crosses every text token in a theme-pack with every Valentino surface
+ * background and reports WCAG contrast violations.
+ * Pure function, zero DOM, zero fetch.
+ */
+import { type ContrastLevel } from './contrast.js';
+export type SurfaceKind = 'light' | 'dark';
+export type SurfaceDefinition = {
+    /** Surface name matching data-surface attribute (e.g. 'default', 'muted') */
+    name: string;
+    /** Flat background color for contrast calculation (hex). For gradients, use the lightest stop. */
+    background: string;
+    /** Whether this surface is light or dark — determines which tokens are at risk */
+    kind: SurfaceKind;
+};
+export type ThemePackTokens = {
+    /** Theme-pack id (e.g. 'accoglienza') */
+    id: string;
+    /** CSS variable overrides: key = var name, value = color string */
+    cssVars: Record<string, string>;
+};
+export type TokenRole = 'text' | 'background' | 'border' | 'accent' | 'unknown';
+export type ThemeAuditViolation = {
+    /** CSS variable name (e.g. '--text-secondary') */
+    token: string;
+    /** Role inferred from token name */
+    role: TokenRole;
+    /** The color value from the theme-pack */
+    value: string;
+    /** Surface where the violation occurs */
+    surface: string;
+    /** Background color of that surface */
+    surfaceBackground: string;
+    /** Computed contrast ratio */
+    ratio: number;
+    /** Required minimum ratio */
+    required: number;
+    /** WCAG level tested */
+    level: ContrastLevel;
+};
+export type ThemeAuditResult = {
+    themePackId: string;
+    level: ContrastLevel;
+    violations: ThemeAuditViolation[];
+    checked: number;
+    passed: boolean;
+};
+/**
+ * Default Valentino surface backgrounds.
+ * For gradients, we use the lightest color (worst-case for dark text)
+ * or darkest color (worst-case for light text).
+ */
+export declare const VALENTINO_SURFACES: SurfaceDefinition[];
+export declare function inferTokenRole(varName: string): TokenRole;
+/**
+ * Audit a theme-pack's text tokens against all surfaces.
+ *
+ * For each text token (--text-*, --font-* excluded since fonts aren't colors):
+ * - Check contrast on every light surface (text on light bg)
+ * - Check contrast on every dark surface (text on dark bg)
+ *
+ * Accent tokens are also checked since they may be used as interactive text.
+ *
+ * If `foundationTokens` is provided, tokens NOT overridden by the theme-pack
+ * are checked using the foundation (CSS :root) value. This catches the case
+ * where the base theme defines a color that fails on a surface, and no
+ * theme-pack overrides it.
+ */
+export declare function auditThemePack(themePack: ThemePackTokens, options?: {
+    surfaces?: SurfaceDefinition[];
+    level?: ContrastLevel;
+    /** Foundation :root tokens (base theme). Tokens not in the theme-pack are checked from here. */
+    foundationTokens?: Record<string, string>;
+}): ThemeAuditResult;
+export type RegistryViolation = {
+    token: string;
+    themePackId: string;
+    reason: string;
+};
+/**
+ * Validate that a theme-pack only overrides tokens allowed by the registry
+ * and that overridden values are parseable colors.
+ */
+export declare function validateThemePackAgainstRegistry(themePack: ThemePackTokens, registry: {
+    mutableTokens: string[];
+}): RegistryViolation[];
+export type BatchAuditResult = {
+    results: ThemeAuditResult[];
+    registryViolations: RegistryViolation[];
+    allPassed: boolean;
+};
+/**
+ * Audit multiple theme-packs at once, optionally validating against the registry.
+ */
+export declare function auditThemePacks(themePacks: ThemePackTokens[], options?: {
+    surfaces?: SurfaceDefinition[];
+    level?: ContrastLevel;
+    registry?: {
+        mutableTokens: string[];
+    };
+}): BatchAuditResult;
+//# sourceMappingURL=theme-audit.d.ts.map

package/dist/core/theme-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-audit.d.ts","sourceRoot":"","sources":["../../src/core/theme-audit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAIlF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG;IAC5B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAQjD,CAAC;AAIF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAWzD;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE;IACN,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,GACF,gBAAgB,CA+ClB;AAID,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,GACtC,iBAAiB,EAAE,CAerB;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAC3B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE;IACN,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1C,GACF,gBAAgB,CAWlB"}

package/dist/core/theme-audit.js

@@ -0,0 +1,127 @@
+/**
+ * Theme Audit — static contrast analysis for theme-packs against surfaces.
+ *
+ * Crosses every text token in a theme-pack with every Valentino surface
+ * background and reports WCAG contrast violations.
+ * Pure function, zero DOM, zero fetch.
+ */
+import { checkWcagContrast, parseColor } from './contrast.js';
+// ── Default surface map ──────────────────────────────────────────────────────
+/**
+ * Default Valentino surface backgrounds.
+ * For gradients, we use the lightest color (worst-case for dark text)
+ * or darkest color (worst-case for light text).
+ */
+export const VALENTINO_SURFACES = [
+    { name: 'default', background: '#ffffff', kind: 'light' },
+    { name: 'muted', background: '#f8fafc', kind: 'light' },
+    { name: 'accent', background: '#fff7fb', kind: 'light' },
+    { name: 'reading-light', background: '#ffffff', kind: 'light' },
+    { name: 'ops-light', background: '#f8fafc', kind: 'light' },
+    { name: 'dark', background: '#020617', kind: 'dark' },
+    { name: 'shell-dark', background: '#020617', kind: 'dark' },
+];
+// ── Token role inference ─────────────────────────────────────────────────────
+export function inferTokenRole(varName) {
+    const lower = varName.toLowerCase();
+    if (lower.includes('text') || lower.includes('font') || lower.includes('color'))
+        return 'text';
+    if (lower.includes('bg') || lower.includes('background') || lower.includes('surface'))
+        return 'background';
+    if (lower.includes('border') || lower.includes('glass-border'))
+        return 'border';
+    if (lower.includes('accent') || lower.includes('gold') || lower.includes('cyan') || lower.includes('violet'))
+        return 'accent';
+    return 'unknown';
+}
+// ── Core audit function ──────────────────────────────────────────────────────
+/**
+ * Audit a theme-pack's text tokens against all surfaces.
+ *
+ * For each text token (--text-*, --font-* excluded since fonts aren't colors):
+ * - Check contrast on every light surface (text on light bg)
+ * - Check contrast on every dark surface (text on dark bg)
+ *
+ * Accent tokens are also checked since they may be used as interactive text.
+ *
+ * If `foundationTokens` is provided, tokens NOT overridden by the theme-pack
+ * are checked using the foundation (CSS :root) value. This catches the case
+ * where the base theme defines a color that fails on a surface, and no
+ * theme-pack overrides it.
+ */
+export function auditThemePack(themePack, options) {
+    const surfaces = options?.surfaces ?? VALENTINO_SURFACES;
+    const level = options?.level ?? 'AA';
+    const violations = [];
+    let checked = 0;
+    // Merge: theme-pack overrides foundation
+    const effectiveTokens = {
+        ...(options?.foundationTokens ?? {}),
+        ...themePack.cssVars,
+    };
+    for (const [varName, value] of Object.entries(effectiveTokens)) {
+        const role = inferTokenRole(varName);
+        // Only check tokens that are used as foreground text/accent
+        if (role !== 'text' && role !== 'accent')
+            continue;
+        // Skip non-color values (e.g. font-family)
+        if (!parseColor(value))
+            continue;
+        for (const surface of surfaces) {
+            checked++;
+            const result = checkWcagContrast(value, surface.background, level);
+            if (!result.passes) {
+                violations.push({
+                    token: varName,
+                    role,
+                    value,
+                    surface: surface.name,
+                    surfaceBackground: surface.background,
+                    ratio: result.ratio,
+                    required: level === 'AAA' ? 7.0 : 4.5,
+                    level,
+                });
+            }
+        }
+    }
+    return {
+        themePackId: themePack.id,
+        level,
+        violations,
+        checked,
+        passed: violations.length === 0,
+    };
+}
+/**
+ * Validate that a theme-pack only overrides tokens allowed by the registry
+ * and that overridden values are parseable colors.
+ */
+export function validateThemePackAgainstRegistry(themePack, registry) {
+    const violations = [];
+    const allowed = new Set(registry.mutableTokens);
+    for (const varName of Object.keys(themePack.cssVars)) {
+        if (!allowed.has(varName)) {
+            violations.push({
+                token: varName,
+                themePackId: themePack.id,
+                reason: `Token "${varName}" is not in the registry's mutableTokens list`,
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Audit multiple theme-packs at once, optionally validating against the registry.
+ */
+export function auditThemePacks(themePacks, options) {
+    const results = themePacks.map(tp => auditThemePack(tp, options));
+    const registryViolations = options?.registry
+        ? themePacks.flatMap(tp => validateThemePackAgainstRegistry(tp, options.registry))
+        : [];
+    return {
+        results,
+        registryViolations,
+        allPassed: results.every(r => r.passed) && registryViolations.length === 0,
+    };
+}
+//# sourceMappingURL=theme-audit.js.map

package/dist/core/theme-audit.js.map

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

package/dist/core/theme-audit.test.d.ts

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

package/dist/core/theme-audit.test.d.ts.map

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

package/dist/core/theme-audit.test.js

@@ -0,0 +1,198 @@
+import { describe, it, expect } from 'vitest';
+import { auditThemePack, auditThemePacks, validateThemePackAgainstRegistry, inferTokenRole, VALENTINO_SURFACES, } from './theme-audit.js';
+// ── inferTokenRole ───────────────────────────────────────────────────────────
+describe('inferTokenRole', () => {
+    it('classifies --text-secondary as text', () => {
+        expect(inferTokenRole('--text-secondary')).toBe('text');
+    });
+    it('classifies --text-primary as text', () => {
+        expect(inferTokenRole('--text-primary')).toBe('text');
+    });
+    it('classifies --text-sovereign-gold as text', () => {
+        expect(inferTokenRole('--text-sovereign-gold')).toBe('text');
+    });
+    it('classifies --accent-neural-cyan as accent', () => {
+        expect(inferTokenRole('--accent-neural-cyan')).toBe('accent');
+    });
+    it('classifies --bg-deep-void as background', () => {
+        expect(inferTokenRole('--bg-deep-void')).toBe('background');
+    });
+    it('classifies --glass-border as border', () => {
+        expect(inferTokenRole('--glass-border')).toBe('border');
+    });
+    it('classifies --font-family as text', () => {
+        expect(inferTokenRole('--font-family')).toBe('text');
+    });
+});
+// ── auditThemePack ──────────────────────────────────────────────────────────
+describe('auditThemePack', () => {
+    const accoglienza = {
+        id: 'accoglienza',
+        cssVars: {
+            '--bg-deep-void': '#0b1221',
+            '--text-sovereign-gold': '#fbbf24',
+            '--accent-neural-cyan': '#60a5fa',
+            '--glass-border': 'rgba(96, 165, 250, 0.22)',
+            '--glass-bg': 'rgba(11, 18, 33, 0.72)',
+            '--text-primary': '#f8fafc',
+            '--text-secondary': '#d1d5db',
+            '--font-family': 'system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif',
+        },
+    };
+    it('detects --text-secondary failing on light surfaces', () => {
+        const result = auditThemePack(accoglienza);
+        const textSecondaryFails = result.violations.filter(v => v.token === '--text-secondary');
+        expect(textSecondaryFails.length).toBeGreaterThan(0);
+        // Should fail on all 5 light surfaces
+        const lightSurfaces = textSecondaryFails.map(v => v.surface);
+        expect(lightSurfaces).toContain('default');
+        expect(lightSurfaces).toContain('muted');
+    });
+    it('detects --text-primary failing on light surfaces (light text on white)', () => {
+        const result = auditThemePack(accoglienza);
+        const textPrimaryFails = result.violations.filter(v => v.token === '--text-primary');
+        // #f8fafc on #ffffff → ~1.01:1, should fail
+        expect(textPrimaryFails.length).toBeGreaterThan(0);
+    });
+    it('passes a well-configured dark-only theme-pack on dark surfaces only', () => {
+        const result = auditThemePack(accoglienza, {
+            surfaces: VALENTINO_SURFACES.filter(s => s.kind === 'dark'),
+        });
+        // --text-primary (#f8fafc) and --text-secondary (#d1d5db) should pass on dark (#020617)
+        const textFails = result.violations.filter(v => v.token.startsWith('--text'));
+        expect(textFails).toEqual([]);
+    });
+    it('skips non-color values like font-family', () => {
+        const result = auditThemePack(accoglienza);
+        const fontFails = result.violations.filter(v => v.token === '--font-family');
+        expect(fontFails).toEqual([]);
+    });
+    it('skips background/border tokens', () => {
+        const result = auditThemePack(accoglienza);
+        const bgFails = result.violations.filter(v => v.token === '--bg-deep-void');
+        const borderFails = result.violations.filter(v => v.token === '--glass-border');
+        expect(bgFails).toEqual([]);
+        expect(borderFails).toEqual([]);
+    });
+    it('supports AAA level', () => {
+        const result = auditThemePack(accoglienza, { level: 'AAA' });
+        // AAA requires 7.0:1, should have more violations than AA
+        const aaResult = auditThemePack(accoglienza, { level: 'AA' });
+        expect(result.violations.length).toBeGreaterThanOrEqual(aaResult.violations.length);
+    });
+    it('reports correct ratio and required values', () => {
+        const result = auditThemePack(accoglienza);
+        for (const v of result.violations) {
+            expect(v.ratio).toBeGreaterThan(0);
+            expect(v.required).toBe(4.5);
+            expect(v.level).toBe('AA');
+        }
+    });
+    it('passes a theme-pack with high-contrast text tokens', () => {
+        const highContrast = {
+            id: 'high-contrast',
+            cssVars: {
+                '--text-primary': '#000000',
+                '--text-secondary': '#333333',
+            },
+        };
+        const result = auditThemePack(highContrast);
+        // #000000 and #333333 on any bg should pass (or at worst #333333 on dark)
+        const lightFails = result.violations.filter(v => VALENTINO_SURFACES.find(s => s.name === v.surface)?.kind === 'light');
+        expect(lightFails).toEqual([]);
+    });
+});
+// ── validateThemePackAgainstRegistry ─────────────────────────────────────────
+describe('validateThemePackAgainstRegistry', () => {
+    const registry = {
+        mutableTokens: [
+            '--bg-deep-void', '--text-sovereign-gold', '--accent-neural-cyan',
+            '--glass-border', '--glass-bg', '--text-primary', '--text-secondary',
+            '--font-family',
+        ],
+    };
+    it('passes when all tokens are in the allowed list', () => {
+        const tp = {
+            id: 'test',
+            cssVars: { '--text-primary': '#000', '--text-secondary': '#333' },
+        };
+        expect(validateThemePackAgainstRegistry(tp, registry)).toEqual([]);
+    });
+    it('reports unauthorized tokens', () => {
+        const tp = {
+            id: 'rogue',
+            cssVars: { '--text-primary': '#000', '--custom-sneaky': '#f00' },
+        };
+        const violations = validateThemePackAgainstRegistry(tp, registry);
+        expect(violations).toHaveLength(1);
+        expect(violations[0].token).toBe('--custom-sneaky');
+    });
+});
+// ── foundationTokens (base theme fallback) ──────────────────────────────────
+describe('auditThemePack with foundationTokens', () => {
+    const foundation = {
+        '--text-primary': '#f8fafc',
+        '--text-secondary': '#cbd5e1',
+        '--accent-neural-cyan': '#0cd6c7',
+    };
+    it('checks foundation tokens when no theme-pack overrides them', () => {
+        const emptyPack = { id: 'empty', cssVars: {} };
+        const result = auditThemePack(emptyPack, { foundationTokens: foundation });
+        // --text-primary (#f8fafc) and --text-secondary (#cbd5e1) fail on light
+        const lightFails = result.violations.filter(v => VALENTINO_SURFACES.find(s => s.name === v.surface)?.kind === 'light');
+        expect(lightFails.length).toBeGreaterThan(0);
+    });
+    it('theme-pack override takes precedence over foundation', () => {
+        const overridePack = {
+            id: 'override',
+            cssVars: { '--text-secondary': '#333333' },
+        };
+        const result = auditThemePack(overridePack, { foundationTokens: foundation });
+        // --text-secondary is now #333333 (from pack), not #cbd5e1 (from foundation)
+        const textSecLight = result.violations.filter(v => v.token === '--text-secondary' && VALENTINO_SURFACES.find(s => s.name === v.surface)?.kind === 'light');
+        expect(textSecLight).toEqual([]);
+    });
+    it('foundation tokens not in theme-pack are still checked', () => {
+        const partialPack = {
+            id: 'partial',
+            cssVars: { '--text-secondary': '#333333' },
+        };
+        const result = auditThemePack(partialPack, { foundationTokens: foundation });
+        // --text-primary (#f8fafc from foundation) still fails on light
+        const textPrimaryFails = result.violations.filter(v => v.token === '--text-primary');
+        expect(textPrimaryFails.length).toBeGreaterThan(0);
+    });
+    it('checked count includes both foundation and theme-pack tokens', () => {
+        const emptyPack = { id: 'empty', cssVars: {} };
+        const result = auditThemePack(emptyPack, { foundationTokens: foundation });
+        // 3 tokens × 7 surfaces = 21 checks
+        expect(result.checked).toBe(21);
+    });
+});
+// ── auditThemePacks (batch) ─────────────────────────────────────────────────
+describe('auditThemePacks', () => {
+    it('audits multiple theme-packs and aggregates results', () => {
+        const packs = [
+            { id: 'a', cssVars: { '--text-secondary': '#cbd5e1' } },
+            { id: 'b', cssVars: { '--text-secondary': '#333333' } },
+        ];
+        const result = auditThemePacks(packs);
+        expect(result.results).toHaveLength(2);
+        // Pack 'a' should fail on light, pack 'b' should pass on light
+        expect(result.results[0].passed).toBe(false);
+        // Pack 'b' #333333 on dark (#020617) might also fail, so just check light violations
+        const bLightViolations = result.results[1].violations.filter(v => VALENTINO_SURFACES.find(s => s.name === v.surface)?.kind === 'light');
+        expect(bLightViolations).toEqual([]);
+    });
+});
+// ── VALENTINO_SURFACES ──────────────────────────────────────────────────────
+describe('VALENTINO_SURFACES', () => {
+    it('has 7 surfaces', () => {
+        expect(VALENTINO_SURFACES).toHaveLength(7);
+    });
+    it('has 5 light and 2 dark surfaces', () => {
+        expect(VALENTINO_SURFACES.filter(s => s.kind === 'light')).toHaveLength(5);
+        expect(VALENTINO_SURFACES.filter(s => s.kind === 'dark')).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=theme-audit.test.js.map

package/dist/core/theme-audit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-audit.test.js","sourceRoot":"","sources":["../../src/core/theme-audit.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACH,cAAc,EACd,eAAe,EACf,gCAAgC,EAChC,cAAc,EACd,kBAAkB,GAErB,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAEhF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC5B,MAAM,WAAW,GAAoB;QACjC,EAAE,EAAE,aAAa;QACjB,OAAO,EAAE;YACL,gBAAgB,EAAE,SAAS;YAC3B,uBAAuB,EAAE,SAAS;YAClC,sBAAsB,EAAE,SAAS;YACjC,gBAAgB,EAAE,0BAA0B;YAC5C,YAAY,EAAE,wBAAwB;YACtC,gBAAgB,EAAE,SAAS;YAC3B,kBAAkB,EAAE,SAAS;YAC7B,eAAe,EAAE,+DAA+D;SACnF;KACJ,CAAC;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,kBAAkB,CAAC,CAAC;QACzF,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACrD,sCAAsC;QACtC,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAC9E,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC;QACrF,4CAA4C;QAC5C,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE;YACvC,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAC9D,CAAC,CAAC;QACH,wFAAwF;QACxF,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,eAAe,CAAC,CAAC;QAC7E,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC;QAChF,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,YAAY,GAAoB;YAClC,EAAE,EAAE,eAAe;YACnB,OAAO,EAAE;gBACL,gBAAgB,EAAE,SAAS;gBAC3B,kBAAkB,EAAE,SAAS;aAChC;SACJ,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC5C,0EAA0E;QAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,OAAO,CAC5E,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC9C,MAAM,QAAQ,GAAG;QACb,aAAa,EAAE;YACX,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB;YACjE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB;YACpE,eAAe;SAClB;KACJ,CAAC;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,EAAE,GAAoB;YACxB,EAAE,EAAE,MAAM;YACV,OAAO,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE;SACpE,CAAC;QACF,MAAM,CAAC,gCAAgC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,GAAoB;YACxB,EAAE,EAAE,OAAO;YACX,OAAO,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE;SACnE,CAAC;QACF,MAAM,UAAU,GAAG,gCAAgC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAClD,MAAM,UAAU,GAA2B;QACvC,gBAAgB,EAAE,SAAS;QAC3B,kBAAkB,EAAE,SAAS;QAC7B,sBAAsB,EAAE,SAAS;KACpC,CAAC;IAEF,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QAClE,MAAM,SAAS,GAAoB,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3E,wEAAwE;QACxE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,OAAO,CAC5E,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC5D,MAAM,YAAY,GAAoB;YAClC,EAAE,EAAE,UAAU;YACd,OAAO,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE;SAC7C,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9E,6EAA6E;QAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,kBAAkB,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,OAAO,CAC9G,CAAC;QACF,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,WAAW,GAAoB;YACjC,EAAE,EAAE,SAAS;YACb,OAAO,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE;SAC7C,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7E,gEAAgE;QAChE,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC;QACrF,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACpE,MAAM,SAAS,GAAoB,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3E,oCAAoC;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAsB;YAC7B,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE;YACvD,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE;SAC1D,CAAC;QACF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,+DAA+D;QAC/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,qFAAqF;QACrF,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CACxD,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,OAAO,CAC5E,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACtB,MAAM,CAAC,kBAAkB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/core/url-import.d.ts

@@ -0,0 +1,41 @@
+/**
+ * URL Import — Fetch web page → screenshot → PageSpecV1.
+ * Feature #784 (Il Sarto Copia), PBI #786.
+ *
+ * Two modes:
+ * - Playwright mode: headless browser screenshot → vision LLM (best quality)
+ * - HTML mode: fetch HTML → LLM text analysis (fallback, no Playwright needed)
+ *
+ * Zero hard dependencies on Playwright — dynamic import, graceful fallback.
+ */
+import type { VisionLlmCallback, VisualImportResult, VisualImportOptions } from './visual-import.js';
+export type UrlImportResult = VisualImportResult & {
+    mode: 'playwright' | 'html-fallback';
+    url: string;
+    /** Page title extracted from HTML */
+    pageTitle?: string;
+};
+export type UrlImportOptions = VisualImportOptions & {
+    /** Viewport width for screenshot (default: 1440) */
+    viewportWidth?: number;
+    /** Viewport height for screenshot (default: 900) */
+    viewportHeight?: number;
+    /** Wait time in ms after page load (default: 2000) */
+    waitAfterLoad?: number;
+    /** Force HTML fallback even if Playwright is available */
+    forceHtmlFallback?: boolean;
+};
+export type HtmlLlmCallback = (systemPrompt: string, userPrompt: string) => Promise<string>;
+/**
+ * Import a web page by URL → PageSpecV1.
+ *
+ * Tries Playwright screenshot first (best quality).
+ * Falls back to HTML fetch + LLM text analysis.
+ *
+ * @param url - The web page URL to import
+ * @param visionLlm - Vision LLM callback (for screenshot mode)
+ * @param htmlLlm - Text LLM callback (for HTML fallback mode)
+ * @param options - Import options
+ */
+export declare function importFromUrl(url: string, visionLlm: VisionLlmCallback, htmlLlm: HtmlLlmCallback, options: UrlImportOptions): Promise<UrlImportResult>;
+//# sourceMappingURL=url-import.d.ts.map

package/dist/core/url-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-import.d.ts","sourceRoot":"","sources":["../../src/core/url-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQrG,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IAC/C,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG;IACjD,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC1B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC,CAAC;AA+LrB;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAwB1B"}