@hale-bopp/valentino-engine 2.1.0 → 2.2.0

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/page-generator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AI Page Generator — Pure prompt-to-PageSpec engine.
+ * PBI #608 — Generates valid PageSpecV1 from natural language prompts.
+ *
+ * Two modes:
+ * - Local (rule-based): parses prompt, composes sections from templates. Always works, zero API.
+ * - LLM (callback): delegates to an external LLM via user-provided function, validates output.
+ *
+ * No fetch, no DOM, no LLM client — pure functions only.
+ * The consumer wires in the LLM integration (portal uses llm-client.mjs).
+ */
+import type { PageSpecV1, SectionSpec, PageProfileSpec, ValentinoCatalogV1 } from './types.js';
+export type PageIntent = {
+    /** Detected page type */
+    pageType: 'landing' | 'product' | 'service' | 'about' | 'generic';
+    /** Detected profile mapping */
+    profile: PageProfileSpec;
+    /** Sections the user wants (in order) */
+    sectionIntents: SectionIntent[];
+    /** Extracted title (if any) */
+    title?: string;
+    /** Raw items/features mentioned */
+    items: string[];
+    /** Raw steps mentioned */
+    steps: string[];
+};
+export type SectionIntent = {
+    type: SectionSpec['type'];
+    /** Items specific to this section (e.g., card titles) */
+    items?: string[];
+    /** Steps specific to this section */
+    steps?: string[];
+};
+export type GeneratePageOptions = {
+    /** Page ID (required) */
+    id: string;
+    /** Optional catalog for blueprint resolution */
+    catalog?: ValentinoCatalogV1;
+    /** Optional LLM callback — receives prompt, returns raw PageSpecV1 JSON */
+    llm?: (prompt: string, context: LlmContext) => Promise<unknown>;
+    /** Optional blueprint ID to use as base */
+    blueprintId?: string;
+};
+export type LlmContext = {
+    intent: PageIntent;
+    sectionTypes: string[];
+    exampleSpec: PageSpecV1;
+};
+export type GeneratePageResult = {
+    spec: PageSpecV1;
+    mode: 'local' | 'llm';
+    intent: PageIntent;
+    warnings: string[];
+};
+/**
+ * Parse a natural language prompt into a structured PageIntent.
+ */
+export declare function parsePrompt(prompt: string): PageIntent;
+/**
+ * Generate a PageSpecV1 from a natural language prompt.
+ *
+ * If `options.llm` is provided, tries LLM first with automatic fallback to local.
+ * Without `options.llm`, uses rule-based local generation (always works).
+ *
+ * @example
+ * ```ts
+ * // Local mode (no API needed)
+ * const result = await generatePageSpec(
+ *   "Landing page per un ristorante con hero, 3 card e CTA",
+ *   { id: 'restaurant-landing' }
+ * );
+ *
+ * // LLM mode (with fallback)
+ * const result = await generatePageSpec(
+ *   "Landing page per un ristorante con hero, 3 card e CTA",
+ *   { id: 'restaurant-landing', llm: myLlmFunction }
+ * );
+ * ```
+ */
+export declare function generatePageSpec(prompt: string, options: GeneratePageOptions): Promise<GeneratePageResult>;
+/**
+ * Synchronous local-only generation. Useful when you don't need LLM.
+ */
+export declare function generatePageSpecLocal(prompt: string, options: Omit<GeneratePageOptions, 'llm'>): GeneratePageResult;
+//# sourceMappingURL=page-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-generator.d.ts","sourceRoot":"","sources":["../../src/core/page-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACR,UAAU,EACV,WAAW,EACX,eAAe,EASf,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAQpB,MAAM,MAAM,UAAU,GAAG;IACrB,yBAAyB;IACzB,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAClE,+BAA+B;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,yCAAyC;IACzC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,2EAA2E;IAC3E,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAgEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAoDtD;AA+OD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,GAC1C,kBAAkB,CAEpB"}