@hale-bopp/valentino-engine 2.0.0 → 2.2.0

package/dist/core/gallery.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Template Gallery — Pure helpers for enumerating catalog entries.
+ * PBI #610 — Provides gallery-ready metadata from ValentinoCatalogV1.
+ *
+ * No DOM, no fetch — pure functions only.
+ * The consumer (portal) renders the gallery UI.
+ */
+import type { ValentinoCatalogV1, PageSpecV1, PagesManifestV1 } from './types.js';
+export type GalleryEntryKind = 'blueprint' | 'template' | 'page';
+export type GalleryEntry = {
+    /** Unique key (blueprint ID, template ID, or page ID) */
+    id: string;
+    kind: GalleryEntryKind;
+    /** Display name (derived from ID) */
+    name: string;
+    /** Description for the gallery card */
+    description: string;
+    /** Page profile (if available) */
+    profile?: string;
+    /** Theme ID (if available) */
+    themeId?: string;
+    /** Number of sections in the blueprint/page */
+    sectionCount: number;
+    /** Section types present (for preview/filtering) */
+    sectionTypes: string[];
+    /** Governance tier (if available) */
+    governanceTier?: string;
+};
+export type GalleryFilter = {
+    kind?: GalleryEntryKind | GalleryEntryKind[];
+    profile?: string;
+    sectionType?: string;
+    search?: string;
+};
+/**
+ * List all gallery entries from a catalog.
+ * Returns blueprints first, then templates.
+ */
+export declare function listCatalogEntries(catalog: ValentinoCatalogV1): GalleryEntry[];
+/**
+ * List gallery entries from a pages manifest (existing pages as starting points).
+ * Optionally provide a specs map (pageId -> PageSpecV1) for richer metadata.
+ */
+export declare function listPageEntries(manifest: PagesManifestV1, specs?: Map<string, PageSpecV1>): GalleryEntry[];
+/**
+ * List all gallery entries: catalog + manifest pages.
+ */
+export declare function listAllGalleryEntries(catalog: ValentinoCatalogV1, manifest?: PagesManifestV1, specs?: Map<string, PageSpecV1>): GalleryEntry[];
+/**
+ * Filter gallery entries by criteria.
+ */
+export declare function filterGalleryEntries(entries: GalleryEntry[], filter: GalleryFilter): GalleryEntry[];
+//# sourceMappingURL=gallery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/core/gallery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAGlB,UAAU,EACV,eAAe,EAGlB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG;IACvB,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAqEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAY9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EACzB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,YAAY,EAAE,CAIhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EAAE,eAAe,EAC1B,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,YAAY,EAAE,CAMhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,aAAa,GACtB,YAAY,EAAE,CAgBhB"}

package/dist/core/gallery.js

@@ -0,0 +1,123 @@
+/**
+ * Template Gallery — Pure helpers for enumerating catalog entries.
+ * PBI #610 — Provides gallery-ready metadata from ValentinoCatalogV1.
+ *
+ * No DOM, no fetch — pure functions only.
+ * The consumer (portal) renders the gallery UI.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Convert a kebab-case or camelCase ID to a human-readable name */
+function humanize(id) {
+    return id
+        .replace(/[-_]/g, ' ')
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/\b\w/g, c => c.toUpperCase())
+        .trim();
+}
+function uniqueSectionTypes(sections) {
+    return [...new Set(sections.map(s => s.type))];
+}
+// ---------------------------------------------------------------------------
+// Entry builders
+// ---------------------------------------------------------------------------
+function blueprintToEntry(id, entry) {
+    const spec = entry.spec;
+    return {
+        id,
+        kind: 'blueprint',
+        name: humanize(id),
+        description: `Blueprint: ${spec.sections.length} sections, profile ${spec.profile || 'generic'}`,
+        profile: spec.profile,
+        themeId: spec.themeId,
+        sectionCount: spec.sections.length,
+        sectionTypes: uniqueSectionTypes(spec.sections),
+        governanceTier: entry.governance?.tier,
+    };
+}
+function templateToEntry(id, entry) {
+    return {
+        id,
+        kind: 'template',
+        name: humanize(id),
+        description: `Template: profile ${entry.page?.profile || 'generic'}`,
+        profile: entry.page?.profile,
+        themeId: entry.page?.themeId,
+        sectionCount: 0,
+        sectionTypes: [],
+    };
+}
+function manifestPageToEntry(page, pageSpec) {
+    const sections = pageSpec?.sections || [];
+    return {
+        id: page.id,
+        kind: 'page',
+        name: humanize(page.id),
+        description: `Page: ${page.route}`,
+        profile: pageSpec?.profile,
+        themeId: pageSpec?.themeId,
+        sectionCount: sections.length,
+        sectionTypes: uniqueSectionTypes(sections),
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * List all gallery entries from a catalog.
+ * Returns blueprints first, then templates.
+ */
+export function listCatalogEntries(catalog) {
+    const entries = [];
+    for (const [id, entry] of Object.entries(catalog.pageBlueprints)) {
+        entries.push(blueprintToEntry(id, entry));
+    }
+    for (const [id, entry] of Object.entries(catalog.templates)) {
+        entries.push(templateToEntry(id, entry));
+    }
+    return entries;
+}
+/**
+ * List gallery entries from a pages manifest (existing pages as starting points).
+ * Optionally provide a specs map (pageId -> PageSpecV1) for richer metadata.
+ */
+export function listPageEntries(manifest, specs) {
+    return manifest.pages
+        .filter(p => p.status === 'published')
+        .map(p => manifestPageToEntry(p, specs?.get(p.id)));
+}
+/**
+ * List all gallery entries: catalog + manifest pages.
+ */
+export function listAllGalleryEntries(catalog, manifest, specs) {
+    const entries = listCatalogEntries(catalog);
+    if (manifest) {
+        entries.push(...listPageEntries(manifest, specs));
+    }
+    return entries;
+}
+/**
+ * Filter gallery entries by criteria.
+ */
+export function filterGalleryEntries(entries, filter) {
+    return entries.filter(entry => {
+        if (filter.kind) {
+            const kinds = Array.isArray(filter.kind) ? filter.kind : [filter.kind];
+            if (!kinds.includes(entry.kind))
+                return false;
+        }
+        if (filter.profile && entry.profile !== filter.profile)
+            return false;
+        if (filter.sectionType && !entry.sectionTypes.includes(filter.sectionType))
+            return false;
+        if (filter.search) {
+            const q = filter.search.toLowerCase();
+            if (!entry.name.toLowerCase().includes(q) && !entry.description.toLowerCase().includes(q)) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=gallery.js.map

package/dist/core/gallery.js.map

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

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

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

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

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

package/dist/core/gallery.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect } from 'vitest';
+import { listCatalogEntries, listPageEntries, listAllGalleryEntries, filterGalleryEntries } from './gallery.js';
+const catalog = {
+    version: '1',
+    templates: {
+        'product-tpl': { page: { profile: 'product-surface', themeId: 'dark' } },
+    },
+    sectionPresets: {},
+    transitionProfiles: {},
+    pageBlueprints: {
+        'landing-bp': {
+            spec: {
+                version: '1',
+                id: 'landing-bp',
+                profile: 'home-signature',
+                sections: [
+                    { type: 'hero', titleKey: 'bp.hero.title' },
+                    { type: 'cards', variant: 'catalog', items: [{ titleKey: 'bp.card1' }] },
+                    { type: 'cta', titleKey: 'bp.cta.title' },
+                ],
+            },
+        },
+        'about-bp': {
+            spec: {
+                version: '1',
+                id: 'about-bp',
+                profile: 'reading-manifesto',
+                sections: [
+                    { type: 'hero', titleKey: 'about.hero.title' },
+                    { type: 'manifesto', contentPrefix: 'about.manifesto' },
+                ],
+            },
+            governance: { tier: 'standard' },
+        },
+    },
+};
+const manifest = {
+    version: '1',
+    pages: [
+        { id: 'home', route: '/', spec: 'home.json', status: 'published' },
+        { id: 'draft-page', route: '/draft', spec: 'draft.json', status: 'draft' },
+        { id: 'about', route: '/about', spec: 'about.json', status: 'published' },
+    ],
+};
+describe('listCatalogEntries', () => {
+    it('returns blueprints and templates', () => {
+        const entries = listCatalogEntries(catalog);
+        expect(entries).toHaveLength(3); // 2 blueprints + 1 template
+    });
+    it('blueprints have section metadata', () => {
+        const entries = listCatalogEntries(catalog);
+        const landing = entries.find(e => e.id === 'landing-bp');
+        expect(landing).toBeDefined();
+        expect(landing.kind).toBe('blueprint');
+        expect(landing.sectionCount).toBe(3);
+        expect(landing.sectionTypes).toContain('hero');
+        expect(landing.sectionTypes).toContain('cards');
+        expect(landing.sectionTypes).toContain('cta');
+    });
+    it('templates have kind template', () => {
+        const entries = listCatalogEntries(catalog);
+        const tpl = entries.find(e => e.id === 'product-tpl');
+        expect(tpl).toBeDefined();
+        expect(tpl.kind).toBe('template');
+        expect(tpl.profile).toBe('product-surface');
+    });
+    it('includes governance tier', () => {
+        const entries = listCatalogEntries(catalog);
+        const about = entries.find(e => e.id === 'about-bp');
+        expect(about.governanceTier).toBe('standard');
+    });
+});
+describe('listPageEntries', () => {
+    it('returns only published pages', () => {
+        const entries = listPageEntries(manifest);
+        expect(entries).toHaveLength(2);
+        expect(entries.map(e => e.id)).toContain('home');
+        expect(entries.map(e => e.id)).toContain('about');
+        expect(entries.map(e => e.id)).not.toContain('draft-page');
+    });
+    it('entries have kind page', () => {
+        const entries = listPageEntries(manifest);
+        expect(entries.every(e => e.kind === 'page')).toBe(true);
+    });
+});
+describe('listAllGalleryEntries', () => {
+    it('combines catalog and manifest', () => {
+        const entries = listAllGalleryEntries(catalog, manifest);
+        expect(entries.length).toBe(5); // 2 bp + 1 tpl + 2 published pages
+    });
+    it('works with catalog only', () => {
+        const entries = listAllGalleryEntries(catalog);
+        expect(entries).toHaveLength(3);
+    });
+});
+describe('filterGalleryEntries', () => {
+    const all = listAllGalleryEntries(catalog, manifest);
+    it('filters by kind', () => {
+        const blueprints = filterGalleryEntries(all, { kind: 'blueprint' });
+        expect(blueprints).toHaveLength(2);
+        expect(blueprints.every(e => e.kind === 'blueprint')).toBe(true);
+    });
+    it('filters by multiple kinds', () => {
+        const result = filterGalleryEntries(all, { kind: ['blueprint', 'template'] });
+        expect(result).toHaveLength(3);
+    });
+    it('filters by profile', () => {
+        const result = filterGalleryEntries(all, { profile: 'home-signature' });
+        expect(result.length).toBeGreaterThanOrEqual(1);
+        expect(result.every(e => e.profile === 'home-signature')).toBe(true);
+    });
+    it('filters by section type', () => {
+        const result = filterGalleryEntries(all, { sectionType: 'manifesto' });
+        expect(result.length).toBeGreaterThanOrEqual(1);
+        expect(result.every(e => e.sectionTypes.includes('manifesto'))).toBe(true);
+    });
+    it('filters by search text', () => {
+        const result = filterGalleryEntries(all, { search: 'landing' });
+        expect(result.length).toBeGreaterThanOrEqual(1);
+    });
+    it('combines filters', () => {
+        const result = filterGalleryEntries(all, { kind: 'blueprint', profile: 'home-signature' });
+        expect(result).toHaveLength(1);
+        expect(result[0].id).toBe('landing-bp');
+    });
+});
+//# sourceMappingURL=gallery.test.js.map

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

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

package/dist/core/guardrails-cms.d.ts

@@ -1,12 +1,13 @@
 /**
  * CMS Guardrails — Pure validation rules for CMS capabilities.
  * Migrated from easyway-portal scripts/guardrails-cms.mjs (PBI #606).
+ * Extended with media, language, breadcrumb, and route checks (PBI #605).
  * No I/O (no fs, no fetch) — works on pre-loaded data only.
- * I/O-dependent checks (media orphans, SEO from disk, encoding) stay in the consumer.
  */
 import type { PagesManifestV1 } from './types.js';
 import type { RedirectRule } from './redirects.js';
 import type { SeoSpec } from './seo.js';
+import type { MediaManifest } from './media.js';
 export type CmsWarning = {
     type: string;
     severity: 'warning' | 'error';
@@ -30,11 +31,40 @@ export declare function checkRedirects(manifest: PagesManifestV1, rules: Redirec
 export declare function checkSeoCompleteness(manifest: PagesManifestV1, specsById: Map<string, {
     seo?: SeoSpec;
 }>): CmsWarning[];
+/**
+ * Check that ogImage in page specs references an existing media key.
+ * Requires pre-loaded specs and media manifest.
+ */
+export declare function checkOgImageExists(specsById: Map<string, {
+    seo?: SeoSpec;
+}>, mediaManifest: MediaManifest): CmsWarning[];
+/**
+ * Find media assets not referenced by any page spec.
+ * Scans all spec sections for media keys in known fields.
+ */
+export declare function checkMediaOrphans(specsById: Map<string, {
+    seo?: SeoSpec;
+    sections?: Array<Record<string, any>>;
+}>, mediaManifest: MediaManifest): CmsWarning[];
+/** Warn about media assets without alt text (accessibility). */
+export declare function checkMediaMissingAlt(mediaManifest: MediaManifest): CmsWarning[];
+/** Warn about pages with deep routes (3+ segments) that may need intermediate breadcrumb pages. */
+export declare function checkBreadcrumbDepth(manifest: PagesManifestV1): CmsWarning[];
+/**
+ * Check language coverage: keys in one language map missing from another.
+ * Accepts flattened key sets (consumer handles the JSON loading/flattening).
+ */
+export declare function checkLanguageCoverage(contentByLang: Map<string, Set<string>>): CmsWarning[];
+/** Error if manifest has duplicate routes. */
+export declare function checkDuplicateRoutes(manifest: PagesManifestV1): CmsWarning[];
 /** Run all pure CMS guardrails. Returns combined warnings. */
 export declare function collectPureCmsWarnings(manifest: PagesManifestV1, options?: {
     redirectRules?: RedirectRule[];
     specsById?: Map<string, {
         seo?: SeoSpec;
+        sections?: Array<Record<string, any>>;
     }>;
+    mediaManifest?: MediaManifest;
+    contentByLang?: Map<string, Set<string>>;
 }): CmsWarning[];
 //# sourceMappingURL=guardrails-cms.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"guardrails-cms.d.ts","sourceRoot":"","sources":["../../src/core/guardrails-cms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAazE;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAyB/E;AAED,yCAAyC;AACzC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAUhF;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAWtE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAyB7F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC1C,UAAU,EAAE,CAsBd;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE;IACN,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9C,GACF,UAAU,EAAE,CASd"}
+{"version":3,"file":"guardrails-cms.d.ts","sourceRoot":"","sources":["../../src/core/guardrails-cms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAazE;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAyB/E;AAED,yCAAyC;AACzC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAUhF;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAWtE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAyB7F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC1C,UAAU,EAAE,CAsBd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACzC,aAAa,EAAE,aAAa,GAC7B,UAAU,EAAE,CAmBd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE,CAAC,EAChF,aAAa,EAAE,aAAa,GAC7B,UAAU,EAAE,CAiCd;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,EAAE,CAa/E;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAmB5E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GACxC,UAAU,EAAE,CAkCd;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAkB5E;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE;IACN,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5C,GACF,UAAU,EAAE,CAed"}

package/dist/core/guardrails-cms.js

@@ -125,6 +125,160 @@ export function checkSeoCompleteness(manifest, specsById) {
     }
     return warnings;
 }
+/**
+ * Check that ogImage in page specs references an existing media key.
+ * Requires pre-loaded specs and media manifest.
+ */
+export function checkOgImageExists(specsById, mediaManifest) {
+    const warnings = [];
+    const mediaKeys = new Set(mediaManifest.assets.map((a) => a.key));
+    for (const [pageId, spec] of specsById) {
+        const ogImage = spec.seo?.ogImage;
+        if (!ogImage)
+            continue;
+        // Skip if it looks like a path/URL (only validate media key references)
+        if (ogImage.includes('/') || ogImage.includes('.'))
+            continue;
+        if (!mediaKeys.has(ogImage)) {
+            warnings.push({
+                type: 'cms-og-image-missing',
+                severity: 'warning',
+                file: `/pages/${pageId}.json`,
+                message: `Page "${pageId}" has seo.ogImage="${ogImage}" but no matching media asset found`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Find media assets not referenced by any page spec.
+ * Scans all spec sections for media keys in known fields.
+ */
+export function checkMediaOrphans(specsById, mediaManifest) {
+    const warnings = [];
+    if (!mediaManifest.assets.length)
+        return warnings;
+    // Collect all referenced media keys from specs
+    const referencedKeys = new Set();
+    for (const [, spec] of specsById) {
+        // OG image
+        if (spec.seo?.ogImage)
+            referencedKeys.add(spec.seo.ogImage);
+        // Scan sections for common media fields
+        for (const section of spec.sections ?? []) {
+            const json = JSON.stringify(section);
+            for (const asset of mediaManifest.assets) {
+                if (json.includes(asset.key) || json.includes(asset.file)) {
+                    referencedKeys.add(asset.key);
+                }
+            }
+        }
+    }
+    for (const asset of mediaManifest.assets) {
+        if (!referencedKeys.has(asset.key)) {
+            warnings.push({
+                type: 'cms-media-orphan',
+                severity: 'warning',
+                file: 'media.manifest.json',
+                message: `Media asset "${asset.key}" (${asset.file}) is not referenced by any page spec`,
+            });
+        }
+    }
+    return warnings;
+}
+/** Warn about media assets without alt text (accessibility). */
+export function checkMediaMissingAlt(mediaManifest) {
+    const warnings = [];
+    for (const asset of mediaManifest.assets) {
+        if (!asset.alt || !asset.alt.trim()) {
+            warnings.push({
+                type: 'cms-media-missing-alt',
+                severity: 'warning',
+                file: 'media.manifest.json',
+                message: `Media asset "${asset.key}" has no alt text — accessibility issue`,
+            });
+        }
+    }
+    return warnings;
+}
+/** Warn about pages with deep routes (3+ segments) that may need intermediate breadcrumb pages. */
+export function checkBreadcrumbDepth(manifest) {
+    const warnings = [];
+    const routes = new Set(manifest.pages.map((p) => p.route));
+    for (const page of manifest.pages) {
+        const segments = page.route.split('/').filter(Boolean);
+        if (segments.length < 3)
+            continue;
+        // Check if parent route exists
+        const parentRoute = '/' + segments.slice(0, -1).join('/');
+        if (!routes.has(parentRoute)) {
+            warnings.push({
+                type: 'cms-breadcrumb-depth',
+                severity: 'warning',
+                file: 'pages.manifest.json',
+                message: `Page "${page.id}" has deep route "${page.route}" but parent "${parentRoute}" doesn't exist — breadcrumb will have gaps`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Check language coverage: keys in one language map missing from another.
+ * Accepts flattened key sets (consumer handles the JSON loading/flattening).
+ */
+export function checkLanguageCoverage(contentByLang) {
+    const warnings = [];
+    const langs = [...contentByLang.keys()];
+    for (let i = 0; i < langs.length; i++) {
+        for (let j = i + 1; j < langs.length; j++) {
+            const langA = langs[i];
+            const langB = langs[j];
+            const keysA = contentByLang.get(langA);
+            const keysB = contentByLang.get(langB);
+            for (const key of keysA) {
+                if (!keysB.has(key)) {
+                    warnings.push({
+                        type: 'cms-language-coverage',
+                        severity: 'warning',
+                        file: `content/${langA}.json`,
+                        message: `Key "${key}" exists in ${langA.toUpperCase()} but not in ${langB.toUpperCase()}`,
+                    });
+                }
+            }
+            for (const key of keysB) {
+                if (!keysA.has(key)) {
+                    warnings.push({
+                        type: 'cms-language-coverage',
+                        severity: 'warning',
+                        file: `content/${langB}.json`,
+                        message: `Key "${key}" exists in ${langB.toUpperCase()} but not in ${langA.toUpperCase()}`,
+                    });
+                }
+            }
+        }
+    }
+    return warnings;
+}
+/** Error if manifest has duplicate routes. */
+export function checkDuplicateRoutes(manifest) {
+    const warnings = [];
+    const seen = new Map();
+    for (const page of manifest.pages) {
+        const existing = seen.get(page.route);
+        if (existing) {
+            warnings.push({
+                type: 'cms-duplicate-route',
+                severity: 'error',
+                file: 'pages.manifest.json',
+                message: `Route "${page.route}" is claimed by both "${existing}" and "${page.id}"`,
+            });
+        }
+        else {
+            seen.set(page.route, page.id);
+        }
+    }
+    return warnings;
+}
 /** Run all pure CMS guardrails. Returns combined warnings. */
 export function collectPureCmsWarnings(manifest, options) {
     return [
@@ -132,8 +286,14 @@ export function collectPureCmsWarnings(manifest, options) {
         ...checkPublishAtCoherence(manifest),
         ...checkMaintenanceModeLeak(manifest),
         ...check404Exists(manifest),
+        ...checkDuplicateRoutes(manifest),
+        ...checkBreadcrumbDepth(manifest),
         ...checkRedirects(manifest, options?.redirectRules ?? []),
         ...(options?.specsById ? checkSeoCompleteness(manifest, options.specsById) : []),
+        ...(options?.specsById && options?.mediaManifest ? checkOgImageExists(options.specsById, options.mediaManifest) : []),
+        ...(options?.specsById && options?.mediaManifest ? checkMediaOrphans(options.specsById, options.mediaManifest) : []),
+        ...(options?.mediaManifest ? checkMediaMissingAlt(options.mediaManifest) : []),
+        ...(options?.contentByLang ? checkLanguageCoverage(options.contentByLang) : []),
     ];
 }
 //# sourceMappingURL=guardrails-cms.js.map

package/dist/core/guardrails-cms.js.map

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

package/dist/core/llms-generator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LLMs.txt Generator — Pure functions to produce llms.txt and llms-full.txt
+ * from a PagesManifest and optional content/spec data.
+ * No I/O — the consumer provides the loaded data.
+ *
+ * llms.txt  = L0 Matrioska (max ~50 lines, site index for LLM agents)
+ * llms-full.txt = L1 Matrioska (detailed per-page breakdown)
+ *
+ * Follows the emerging llms.txt standard (like robots.txt for AI crawlers).
+ */
+import type { PagesManifestV1, PageSpecV1 } from './types.js';
+export type LlmsGeneratorOptions = {
+    /** Site name displayed in the header */
+    siteName: string;
+    /** One-line tagline / description */
+    tagline?: string;
+    /** Base URL (e.g. https://example.com) — used in llms-full.txt links */
+    baseUrl?: string;
+    /** Capabilities bullet points */
+    capabilities?: string[];
+    /** Content resolver: given a content key, returns the string value (or undefined) */
+    resolveContent?: (key: string) => string | undefined;
+    /** Pre-loaded page specs by page id (for llms-full.txt section details) */
+    specsById?: Map<string, PageSpecV1>;
+};
+/**
+ * Generate llms.txt — compact site index (L0 Matrioska).
+ * Max ~50 lines: header, pages list, capabilities.
+ */
+export declare function generateLlmsTxt(manifest: PagesManifestV1, options: LlmsGeneratorOptions): string;
+/**
+ * Generate llms-full.txt — detailed per-page breakdown (L1 Matrioska).
+ * Includes section types, SEO metadata, and page purpose.
+ */
+export declare function generateLlmsFullTxt(manifest: PagesManifestV1, options: LlmsGeneratorOptions): string;
+//# sourceMappingURL=llms-generator.d.ts.map

package/dist/core/llms-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-generator.d.ts","sourceRoot":"","sources":["../../src/core/llms-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,MAAM,oBAAoB,GAAG;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qFAAqF;IACrF,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,2EAA2E;IAC3E,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC9B,MAAM,CAwCR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC9B,MAAM,CAuDR"}