@hale-bopp/valentino-engine 1.0.0 → 2.1.0

package/dist/bin/commands/validate.js

@@ -1,19 +1,160 @@
-import { readFileSync } from 'fs';
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
 import { validatePageSpec } from '../../core/page-spec.js';
+import { collectPureCmsWarnings } from '../../core/guardrails-cms.js';
+function findProjectRoot(startDir) {
+    let dir = resolve(startDir);
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(resolve(dir, 'valentino.config.json')))
+            return dir;
+        if (existsSync(resolve(dir, 'valentino.guardrails.json')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function loadGuardrailsProfile(projectRoot) {
+    const filePath = resolve(projectRoot, 'valentino.guardrails.json');
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function loadJSON(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function filterByProfile(warnings, profile) {
+    return warnings.filter((w) => {
+        // Map warning type to guardrail key
+        const key = mapWarningTypeToKey(w.type);
+        const override = profile.guardrails[key];
+        if (!override)
+            return true; // No override → keep as-is
+        if (override.severity === 'off')
+            return false; // Disabled
+        // Upgrade/downgrade severity
+        if (override.severity === 'error')
+            w.severity = 'error';
+        if (override.severity === 'warning')
+            w.severity = 'warning';
+        return true;
+    });
+}
+function mapWarningTypeToKey(type) {
+    const map = {
+        'cms-draft-orphan': 'draft-orphan',
+        'cms-publishat-invalid': 'publishAt',
+        'cms-publishat-past': 'publishAt',
+        'cms-maintenance-mode-active': 'maintenance',
+        'cms-no-404-page': '404',
+        'cms-redirect-target-missing': 'redirect',
+        'cms-redirect-chain': 'redirect',
+        'cms-seo-missing': 'seo',
+        'cms-language-coverage': 'i18n',
+        'cms-media-orphan': 'media',
+        'cms-media-missing-alt': 'media',
+        'cms-media-oversize': 'media',
+        'cms-media-format-legacy': 'media',
+    };
+    return map[type] || type;
+}
 export function runValidate(args) {
-    const file = args[0];
-    if (!file) {
-        console.error('Usage: valentino validate <path-to-pagespec.json>');
+    const files = args.filter((a) => !a.startsWith('-'));
+    const cmsMode = args.includes('--cms') || args.includes('--all');
+    const quietMode = args.includes('--quiet');
+    if (!files.length) {
+        console.error('Usage: valentino validate <spec.json> [spec2.json ...] [--cms] [--all] [--quiet]');
         process.exit(1);
     }
-    const json = JSON.parse(readFileSync(file, 'utf-8'));
-    const valid = validatePageSpec(json);
-    if (valid) {
-        console.log('✅ PageSpec is valid (V1).');
+    // Find project root and guardrails profile
+    const projectRoot = findProjectRoot(process.cwd()) || findProjectRoot(dirname(resolve(files[0])));
+    const profile = projectRoot ? loadGuardrailsProfile(projectRoot) : null;
+    let hasErrors = false;
+    let totalWarnings = 0;
+    let totalErrors = 0;
+    // 1. Validate each page spec
+    for (const file of files) {
+        const json = loadJSON(resolve(file));
+        if (!json) {
+            console.error(`  ❌ Cannot read: ${file}`);
+            hasErrors = true;
+            continue;
+        }
+        const valid = validatePageSpec(json);
+        if (!valid) {
+            console.error(`  ❌ Invalid PageSpec: ${file}`);
+            hasErrors = true;
+        }
+        else if (!quietMode) {
+            console.log(`  ✅ ${file}`);
+        }
     }
-    else {
-        console.error('❌ PageSpec is invalid — requires version: "1", id (string), sections (array).');
-        process.exit(1);
+    // 2. CMS guardrails (if --cms/--all or if guardrails profile exists)
+    if (cmsMode || profile) {
+        const manifestPath = projectRoot
+            ? resolve(projectRoot, 'public/pages/pages.manifest.json')
+            : null;
+        if (manifestPath && existsSync(manifestPath)) {
+            const manifest = loadJSON(manifestPath);
+            if (manifest) {
+                // Load redirects
+                const redirectsPath = resolve(dirname(manifestPath), '..', 'redirects.json');
+                const redirectsData = loadJSON(redirectsPath);
+                // Load specs for SEO check
+                const specsById = new Map();
+                for (const page of manifest.pages) {
+                    const specPath = resolve(dirname(manifestPath), '..', page.spec.replace(/^\//, ''));
+                    const spec = loadJSON(specPath);
+                    if (spec)
+                        specsById.set(page.id, spec);
+                }
+                let warnings = collectPureCmsWarnings(manifest, {
+                    redirectRules: redirectsData?.rules,
+                    specsById,
+                });
+                // Apply guardrails profile
+                if (profile) {
+                    warnings = filterByProfile(warnings, profile);
+                }
+                for (const w of warnings) {
+                    if (w.severity === 'error') {
+                        console.error(`  ❌ [${w.type}] ${w.message}`);
+                        totalErrors++;
+                        hasErrors = true;
+                    }
+                    else {
+                        console.log(`  ⚠  [${w.type}] ${w.message}`);
+                        totalWarnings++;
+                    }
+                }
+            }
+        }
+    }
+    // Summary
+    if (!quietMode) {
+        const profileLabel = profile ? ` (profile: ${profile.template})` : '';
+        if (totalErrors > 0 || totalWarnings > 0) {
+            console.log(`\n  ${totalErrors} error(s), ${totalWarnings} warning(s)${profileLabel}`);
+        }
+        else if (cmsMode || profile) {
+            console.log(`\n  All checks passed${profileLabel}`);
+        }
     }
+    if (hasErrors)
+        process.exit(1);
 }
 //# sourceMappingURL=validate.js.map

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

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

package/dist/bin/valentino.js

@@ -10,8 +10,13 @@ import { runProbe } from './commands/probe.js';
 import { runCatalogResolve } from './commands/catalog.js';
 import { runManifestResolve } from './commands/manifest.js';
 import { runContrast } from './commands/contrast.js';
+import { runInit } from './commands/init.js';
+import { runLlms } from './commands/llms.js';
 const [, , command, ...args] = process.argv;
 switch (command) {
+    case 'init':
+        runInit(args);
+        break;
     case 'audit':
         runAudit(args);
         break;
@@ -43,11 +48,15 @@ switch (command) {
     case 'contrast':
         runContrast(args);
         break;
+    case 'llms':
+        runLlms(args);
+        break;
     default:
         console.log(`
 🎨 Valentino Engine v0.1.0 — Antifragile Open Source UI Design Engine
 
 Usage:
+  valentino init [name] [--template id] [--lang code] [--git url]  Create a new project
   valentino audit <file.css>                                    Audit CSS for guardrail violations
   valentino validate <spec.json>                                Validate a Runtime PageSpec JSON (V1)
   valentino guardrails                                          List all 10 Sovereign Guardrails
@@ -55,6 +64,7 @@ Usage:
   valentino contrast <foreground> <background> [AA|AAA]         Check WCAG contrast ratio
   valentino catalog resolve <spec.json> --catalog <catalog.json> Resolve spec with catalog
   valentino manifest resolve <manifest.json> --route /path      Resolve route to page ID
+  valentino llms <manifest.json> [--content c.json] [--site N]  Generate llms.txt + llms-full.txt
 
 Epic: https://dev.azure.com/EasyWayData/EasyWay-DataPortal/_workitems/edit/480
 `);

package/dist/bin/valentino.js.map

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

package/dist/core/animation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Animation Presets — Validation and CSS generation for declarative section animations.
+ * No DOM — pure functions only. The consumer applies CSS/IntersectionObserver.
+ * PBI #611.
+ */
+import type { AnimationPreset, AnimationSpec, SectionSpec } from './types.js';
+export type AnimationWarning = {
+    type: string;
+    section: number;
+    message: string;
+};
+/** Validate animation specs across all sections of a page. */
+export declare function probeAnimations(sections: SectionSpec[]): AnimationWarning[];
+/** Resolve animation to CSS custom properties for a section. */
+export declare function resolveAnimationCSS(anim: AnimationSpec): Record<string, string>;
+/** List of all valid animation presets. */
+export declare const ANIMATION_PRESETS: readonly AnimationPreset[];
+//# sourceMappingURL=animation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/core/animation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAsD3E;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoC/E;AAED,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAA4E,CAAC"}

package/dist/core/animation.js

@@ -0,0 +1,91 @@
+const VALID_PRESETS = new Set(['fade-up', 'fade-in', 'slide-left', 'slide-right', 'scale-in', 'none']);
+const VALID_DELAYS = new Set(['none', 'stagger']);
+const VALID_TRIGGERS = new Set(['viewport', 'immediate']);
+/** Validate animation specs across all sections of a page. */
+export function probeAnimations(sections) {
+    const warnings = [];
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        const anim = section.animation;
+        if (!anim)
+            continue;
+        if (anim.entrance && !VALID_PRESETS.has(anim.entrance)) {
+            warnings.push({
+                type: 'animation-invalid-preset',
+                section: i,
+                message: `Section ${i} (${section.type}): unknown animation preset "${anim.entrance}". Valid: ${[...VALID_PRESETS].join(', ')}`,
+            });
+        }
+        if (anim.delay && !VALID_DELAYS.has(anim.delay)) {
+            warnings.push({
+                type: 'animation-invalid-delay',
+                section: i,
+                message: `Section ${i} (${section.type}): unknown delay "${anim.delay}". Valid: ${[...VALID_DELAYS].join(', ')}`,
+            });
+        }
+        if (anim.trigger && !VALID_TRIGGERS.has(anim.trigger)) {
+            warnings.push({
+                type: 'animation-invalid-trigger',
+                section: i,
+                message: `Section ${i} (${section.type}): unknown trigger "${anim.trigger}". Valid: ${[...VALID_TRIGGERS].join(', ')}`,
+            });
+        }
+        if (anim.duration !== undefined && (anim.duration < 0 || anim.duration > 5000)) {
+            warnings.push({
+                type: 'animation-duration-out-of-range',
+                section: i,
+                message: `Section ${i} (${section.type}): duration ${anim.duration}ms is out of range (0-5000)`,
+            });
+        }
+        // Stagger on non-list sections is a no-op warning
+        if (anim.delay === 'stagger') {
+            const listTypes = new Set(['cards', 'stats', 'how-it-works', 'data-list', 'component-showcase']);
+            if (!listTypes.has(section.type)) {
+                warnings.push({
+                    type: 'animation-stagger-no-effect',
+                    section: i,
+                    message: `Section ${i} (${section.type}): "stagger" delay has no effect on non-list sections`,
+                });
+            }
+        }
+    }
+    return warnings;
+}
+/** Resolve animation to CSS custom properties for a section. */
+export function resolveAnimationCSS(anim) {
+    const preset = anim.entrance || 'none';
+    const duration = anim.duration || 400;
+    const delay = anim.delay || 'none';
+    if (preset === 'none')
+        return {};
+    const css = {
+        '--v-anim-duration': `${duration}ms`,
+        '--v-anim-delay-mode': delay,
+    };
+    switch (preset) {
+        case 'fade-up':
+            css['--v-anim-opacity'] = '0';
+            css['--v-anim-transform'] = 'translateY(20px)';
+            break;
+        case 'fade-in':
+            css['--v-anim-opacity'] = '0';
+            css['--v-anim-transform'] = 'none';
+            break;
+        case 'slide-left':
+            css['--v-anim-opacity'] = '0';
+            css['--v-anim-transform'] = 'translateX(40px)';
+            break;
+        case 'slide-right':
+            css['--v-anim-opacity'] = '0';
+            css['--v-anim-transform'] = 'translateX(-40px)';
+            break;
+        case 'scale-in':
+            css['--v-anim-opacity'] = '0';
+            css['--v-anim-transform'] = 'scale(0.95)';
+            break;
+    }
+    return css;
+}
+/** List of all valid animation presets. */
+export const ANIMATION_PRESETS = ['fade-up', 'fade-in', 'slide-left', 'slide-right', 'scale-in', 'none'];
+//# sourceMappingURL=animation.js.map

package/dist/core/animation.js.map

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

package/dist/core/encoding.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Encoding Guardrail — Mojibake detection and typographic validation.
+ * Pure functions: takes content strings, returns warnings.
+ * No I/O — consumer loads the content files.
+ * PBI #629.
+ */
+export type EncodingWarning = {
+    type: 'mojibake' | 'typography';
+    severity: 'error' | 'warning';
+    file: string;
+    key: string;
+    message: string;
+    match: string;
+};
+/**
+ * Detect mojibake in content strings.
+ * Returns errors for each mojibake pattern found.
+ */
+export declare function checkMojibake(contentByFile: Map<string, Map<string, string>>): EncodingWarning[];
+/**
+ * Check typographic issues in content strings.
+ * Filters rules by language ('*' matches all).
+ */
+export declare function checkTypography(contentByFile: Map<string, Map<string, string>>, lang?: string): EncodingWarning[];
+/**
+ * Run all encoding checks (mojibake + typography).
+ */
+export declare function checkEncoding(contentByFile: Map<string, Map<string, string>>, lang?: string): EncodingWarning[];
+/** Exported constants for consumer use. */
+export declare const MOJIBAKE_PATTERN_COUNT: number;
+export declare const TYPO_RULE_COUNT: number;
+//# sourceMappingURL=encoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/core/encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAmDF;;;GAGG;AACH,wBAAgB,aAAa,CACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAChD,eAAe,EAAE,CAwBnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/C,IAAI,CAAC,EAAE,MAAM,GACd,eAAe,EAAE,CA0BnB;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/C,IAAI,CAAC,EAAE,MAAM,GACd,eAAe,EAAE,CAKnB;AAED,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAC/D,eAAO,MAAM,eAAe,QAAoB,CAAC"}

package/dist/core/encoding.js

@@ -0,0 +1,112 @@
+/**
+ * Encoding Guardrail — Mojibake detection and typographic validation.
+ * Pure functions: takes content strings, returns warnings.
+ * No I/O — consumer loads the content files.
+ * PBI #629.
+ */
+const MOJIBAKE_PATTERNS = [
+    { pattern: /è/g, label: 'è (Latin-1→UTF-8)', fix: 'è' },
+    { pattern: /é/g, label: 'é (Latin-1→UTF-8)', fix: 'é' },
+    { pattern: /Ã /g, label: 'à (Latin-1→UTF-8)', fix: 'à' },
+    { pattern: /ù/g, label: 'ù (Latin-1→UTF-8)', fix: 'ù' },
+    { pattern: /ò/g, label: 'ò (Latin-1→UTF-8)', fix: 'ò' },
+    { pattern: /ì/g, label: 'ì (Latin-1→UTF-8)', fix: 'ì' },
+    { pattern: /ö/g, label: 'ö (Latin-1→UTF-8)', fix: 'ö' },
+    { pattern: /ü/g, label: 'ü (Latin-1→UTF-8)', fix: 'ü' },
+    { pattern: /ä/g, label: 'ä (Latin-1→UTF-8)', fix: 'ä' },
+    { pattern: /ñ/g, label: 'ñ (Latin-1→UTF-8)', fix: 'ñ' },
+    { pattern: /ç/g, label: 'ç (Latin-1→UTF-8)', fix: 'ç' },
+    { pattern: /’/g, label: 'right single quote (Win-1252)', fix: '\u2019' },
+    { pattern: /“/g, label: 'left double quote (Win-1252)', fix: '\u201C' },
+    { pattern: /â€\u009D/g, label: 'right double quote (Win-1252)', fix: '\u201D' },
+];
+const TYPO_RULES = [
+    // Italian
+    { pattern: /\bE'\s/g, lang: 'it', label: "E' instead of È", suggestion: 'Use È (capital E with accent)' },
+    { pattern: /\bperche'\b/gi, lang: 'it', label: "perche' instead of perché", suggestion: 'Use perché' },
+    { pattern: /\bperche\b(?!')/gi, lang: 'it', label: "perche without accent", suggestion: 'Use perché' },
+    { pattern: /\bpiu'\b/gi, lang: 'it', label: "piu' instead of più", suggestion: 'Use più' },
+    { pattern: /\bcioe'\b/gi, lang: 'it', label: "cioe' instead of cioè", suggestion: 'Use cioè' },
+    { pattern: /\bpuo'\b/gi, lang: 'it', label: "puo' instead of può", suggestion: 'Use può' },
+    { pattern: /\bgiacche'\b/gi, lang: 'it', label: "giacche' instead of giacché", suggestion: 'Use giacché' },
+    // General typography
+    { pattern: /\.\.\./g, lang: '*', label: 'ASCII ellipsis', suggestion: 'Use … (U+2026)' },
+    { pattern: /--/g, lang: '*', label: 'double hyphen', suggestion: 'Use — (em dash) or – (en dash)' },
+    { pattern: /\s'/g, lang: '*', label: "space before apostrophe", suggestion: 'Remove space before apostrophe' },
+    { pattern: /"([^"]*)"/g, lang: '*', label: 'straight double quotes', suggestion: 'Use \u201C\u201D (curly quotes)' },
+    // French
+    { pattern: /\b(\w+)\s*\?/g, lang: 'fr', label: 'missing space before ?', suggestion: 'French requires a space before ?' },
+    { pattern: /\b(\w+)\s*!/g, lang: 'fr', label: 'missing space before !', suggestion: 'French requires a space before !' },
+    // German
+    { pattern: /\bfuer\b/gi, lang: 'de', label: 'fuer instead of für', suggestion: 'Use für' },
+    { pattern: /\bueber\b/gi, lang: 'de', label: 'ueber instead of über', suggestion: 'Use über' },
+    // Spanish
+    { pattern: /\banio\b/gi, lang: 'es', label: 'anio instead of año', suggestion: 'Use año' },
+];
+/**
+ * Detect mojibake in content strings.
+ * Returns errors for each mojibake pattern found.
+ */
+export function checkMojibake(contentByFile) {
+    const warnings = [];
+    for (const [file, entries] of contentByFile) {
+        for (const [key, value] of entries) {
+            for (const { pattern, label } of MOJIBAKE_PATTERNS) {
+                // Reset lastIndex for global patterns
+                pattern.lastIndex = 0;
+                const match = pattern.exec(value);
+                if (match) {
+                    warnings.push({
+                        type: 'mojibake',
+                        severity: 'error',
+                        file,
+                        key,
+                        message: `Mojibake detected: ${label}`,
+                        match: match[0],
+                    });
+                }
+            }
+        }
+    }
+    return warnings;
+}
+/**
+ * Check typographic issues in content strings.
+ * Filters rules by language ('*' matches all).
+ */
+export function checkTypography(contentByFile, lang) {
+    const warnings = [];
+    const applicableRules = TYPO_RULES.filter((r) => r.lang === '*' || (lang && r.lang === lang));
+    for (const [file, entries] of contentByFile) {
+        for (const [key, value] of entries) {
+            for (const rule of applicableRules) {
+                rule.pattern.lastIndex = 0;
+                const match = rule.pattern.exec(value);
+                if (match) {
+                    warnings.push({
+                        type: 'typography',
+                        severity: 'warning',
+                        file,
+                        key,
+                        message: `${rule.label} — ${rule.suggestion}`,
+                        match: match[0],
+                    });
+                }
+            }
+        }
+    }
+    return warnings;
+}
+/**
+ * Run all encoding checks (mojibake + typography).
+ */
+export function checkEncoding(contentByFile, lang) {
+    return [
+        ...checkMojibake(contentByFile),
+        ...checkTypography(contentByFile, lang),
+    ];
+}
+/** Exported constants for consumer use. */
+export const MOJIBAKE_PATTERN_COUNT = MOJIBAKE_PATTERNS.length;
+export const TYPO_RULE_COUNT = TYPO_RULES.length;
+//# sourceMappingURL=encoding.js.map

package/dist/core/encoding.js.map

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

package/dist/core/extension-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Extension Registry — Plugin system for valentino-engine consumers.
+ * Allows custom section types, guardrails, status values, content/media resolvers,
+ * and editor panels to be registered by the consumer without modifying the engine.
+ *
+ * PBI #606 — Extension points for valentino-engine as standalone product.
+ */
+import type { SectionSpec } from './types.js';
+import type { CmsWarning } from './guardrails-cms.js';
+/** Custom section renderer — consumer provides how to render unknown section types. */
+export type CustomSectionRenderer = (section: SectionSpec, container: unknown) => void;
+/** Custom guardrail — consumer provides additional validation rules. */
+export type CustomGuardrail = (context: GuardrailContext) => CmsWarning[];
+export type GuardrailContext = {
+    manifest: unknown;
+    specs?: Map<string, unknown>;
+    redirectRules?: unknown[];
+    [key: string]: unknown;
+};
+/** Custom content resolver — consumer provides how to load content by key. */
+export type ContentResolver = (key: string, lang?: string) => string | undefined;
+/** Custom media resolver — consumer provides how to resolve media by key. */
+export type MediaResolver = (key: string) => {
+    url: string;
+    alt?: string;
+} | null;
+/** Custom editor panel definition. */
+export type EditorPanelDef = {
+    id: string;
+    label: string;
+    sectionTypes: string[];
+    render: (section: SectionSpec, container: unknown) => void;
+};
+export type ExtensionRegistry = {
+    sectionRenderers: Map<string, CustomSectionRenderer>;
+    guardrails: Map<string, CustomGuardrail>;
+    customStatuses: Set<string>;
+    contentResolver: ContentResolver | null;
+    mediaResolver: MediaResolver | null;
+    editorPanels: Map<string, EditorPanelDef>;
+};
+/** Create a fresh, empty registry. */
+export declare function createExtensionRegistry(): ExtensionRegistry;
+/** Register a custom section renderer for a given section type. */
+export declare function registerSectionRenderer(registry: ExtensionRegistry, sectionType: string, renderer: CustomSectionRenderer): void;
+/** Register a custom guardrail rule. */
+export declare function registerGuardrail(registry: ExtensionRegistry, name: string, guardrail: CustomGuardrail): void;
+/** Register a custom page status value beyond draft/published/scheduled. */
+export declare function registerCustomStatus(registry: ExtensionRegistry, status: string): void;
+/** Set the content resolver (replaces any existing one). */
+export declare function setContentResolver(registry: ExtensionRegistry, resolver: ContentResolver): void;
+/** Set the media resolver (replaces any existing one). */
+export declare function setMediaResolver(registry: ExtensionRegistry, resolver: MediaResolver): void;
+/** Register an editor panel for specific section types. */
+export declare function registerEditorPanel(registry: ExtensionRegistry, panel: EditorPanelDef): void;
+/** Check if a section type has a custom renderer. */
+export declare function hasCustomRenderer(registry: ExtensionRegistry, sectionType: string): boolean;
+/** Get a custom renderer for a section type (or undefined). */
+export declare function getCustomRenderer(registry: ExtensionRegistry, sectionType: string): CustomSectionRenderer | undefined;
+/** Run all custom guardrails and return combined warnings. */
+export declare function runCustomGuardrails(registry: ExtensionRegistry, context: GuardrailContext): CmsWarning[];
+/** Get editor panels applicable to a given section type. */
+export declare function getEditorPanels(registry: ExtensionRegistry, sectionType: string): EditorPanelDef[];
+//# sourceMappingURL=extension-registry.d.ts.map

package/dist/core/extension-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry.d.ts","sourceRoot":"","sources":["../../src/core/extension-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvF,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,UAAU,EAAE,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAElF,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9D,CAAC;AAMF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C,CAAC;AAEF,sCAAsC;AACtC,wBAAgB,uBAAuB,IAAI,iBAAiB,CAS3D;AAMD,mEAAmE;AACnE,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,qBAAqB,GAChC,IAAI,CAEN;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,GAC3B,IAAI,CAEN;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,GACf,IAAI,CAEN;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,eAAe,GAC1B,IAAI,CAEN;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,aAAa,GACxB,IAAI,CAEN;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,cAAc,GACtB,IAAI,CAEN;AAMD,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3F;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAErH;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAMxG;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAElG"}