@ekrist1/vulse 0.1.6-alpha.3

package/dist/core/blueprints/reflect-fields.js

@@ -0,0 +1,229 @@
+import { z } from 'astro/zod';
+import { nestedFieldToDescriptor } from './code-to-definition.js';
+import { normalizeSelectOptions } from './select-helpers.js';
+function unwrap(sch) {
+    let inner = sch;
+    for (;;) {
+        const def = inner._def;
+        if (def.type === 'optional' || def.type === 'default') {
+            inner = def.innerType;
+            continue;
+        }
+        break;
+    }
+    return inner;
+}
+function maxLength(sch) {
+    const checks = sch._def.checks ?? [];
+    for (const check of checks) {
+        const zod = check._zod;
+        if (zod?.def?.check === 'max_length')
+            return zod.def.maximum;
+    }
+    return undefined;
+}
+function parseEntriesTag(tag) {
+    const rest = tag.slice('vulse:entries:'.length);
+    const lastColon = rest.lastIndexOf(':');
+    if (lastColon > 0) {
+        const maybeMax = Number(rest.slice(lastColon + 1));
+        if (!Number.isNaN(maybeMax) && String(maybeMax) === rest.slice(lastColon + 1)) {
+            return {
+                collections: rest.slice(0, lastColon).split(',').filter(Boolean),
+                max: maybeMax,
+            };
+        }
+    }
+    return { collections: rest.split(',').filter(Boolean) };
+}
+export function reflectFields(schema) {
+    const shape = schema.shape;
+    return Object.entries(shape).map(([path, sch]) => describe(path, sch));
+}
+function describe(path, sch) {
+    const tag = (sch.description ?? '');
+    const required = !sch.isOptional();
+    if (tag === 'vulse:media')
+        return { path, widget: 'media', required };
+    if (tag.startsWith('vulse:ref:')) {
+        return { path, widget: 'ref', required, refTarget: tag.slice('vulse:ref:'.length) };
+    }
+    if (tag.startsWith('vulse:entry:')) {
+        return {
+            path,
+            widget: 'entry',
+            required,
+            entryCollections: tag.slice('vulse:entry:'.length).split(',').filter(Boolean),
+        };
+    }
+    if (tag.startsWith('vulse:entries:')) {
+        const parsed = parseEntriesTag(tag);
+        return {
+            path,
+            widget: 'entries',
+            required,
+            entriesCollections: parsed.collections,
+            ...(parsed.max !== undefined ? { entriesMax: parsed.max } : {}),
+        };
+    }
+    if (tag.startsWith('vulse:link')) {
+        const collections = tag.length > 'vulse:link'.length
+            ? tag.slice('vulse:link:'.length).split(',').filter(Boolean)
+            : undefined;
+        return {
+            path,
+            widget: 'link',
+            required,
+            ...(collections !== undefined ? { linkCollections: collections } : {}),
+        };
+    }
+    const inner = unwrap(sch);
+    const t = inner._def.type;
+    if (t === 'string') {
+        const max = maxLength(inner);
+        return { path, widget: max && max > 200 ? 'textarea' : 'text', required };
+    }
+    if (t === 'number')
+        return { path, widget: 'number', required };
+    if (t === 'boolean')
+        return { path, widget: 'bool', required };
+    if (t === 'date')
+        return { path, widget: 'date', required };
+    if (t === 'enum') {
+        const entries = inner._def.entries ?? {};
+        const keys = Object.keys(entries);
+        return {
+            path,
+            widget: 'enum',
+            required,
+            options: keys,
+            selectOptions: keys.map((key) => ({ key, label: key })),
+        };
+    }
+    if (t === 'object') {
+        return { path, widget: 'object', required, children: reflectFields(inner) };
+    }
+    if (t === 'any' && (tag === 'vulse:blocks' || tag.startsWith('vulse:blocks:'))) {
+        return blocksDescriptor(path, required, tag);
+    }
+    if (t === 'array') {
+        if (tag === 'vulse:blocks' || tag.startsWith('vulse:blocks:') || path === 'body') {
+            return blocksDescriptor(path, required, tag || 'vulse:blocks');
+        }
+        const el = inner._def.element;
+        if (el._def.type === 'object') {
+            const itemFields = reflectFields(el);
+            if (tag === 'vulse:grid') {
+                return { path, widget: 'grid', required, itemFields, gridMode: 'table' };
+            }
+            return { path, widget: 'repeater', required, itemFields };
+        }
+        if (el._def.type === 'enum') {
+            const entries = el._def.entries ?? {};
+            const keys = Object.keys(entries);
+            return {
+                path,
+                widget: 'enum',
+                required,
+                options: keys,
+                selectOptions: keys.map((key) => ({ key, label: key })),
+                selectMultiple: true,
+            };
+        }
+        return { path, widget: 'text', required };
+    }
+    return { path, widget: 'text', required };
+}
+const RESERVED_FIELD_NAMES = new Set(['slug', 'status', 'seo']);
+export function fieldDescriptorsFromDefinitions(fields) {
+    return fields.map(fieldDefinitionToDescriptor);
+}
+export function fieldDescriptorsFromBlueprint(bp) {
+    const all = !bp.fields?.length
+        ? reflectFields(bp.schema)
+        : bp.fields.map(fieldDefinitionToDescriptor);
+    return all.filter((f) => !RESERVED_FIELD_NAMES.has(f.path));
+}
+function selectDescriptor(base, options, config) {
+    const normalized = normalizeSelectOptions(options);
+    return {
+        ...base,
+        widget: 'enum',
+        options: normalized.map((o) => o.key),
+        selectOptions: normalized,
+        ...(config?.multiple !== undefined ? { selectMultiple: config.multiple } : {}),
+        ...(config?.placeholder !== undefined ? { selectPlaceholder: config.placeholder } : {}),
+        ...(config?.clearable !== undefined ? { selectClearable: config.clearable } : {}),
+    };
+}
+function fieldDefinitionToDescriptor(f) {
+    const base = { path: f.name, required: !f.optional, label: f.label ?? f.name };
+    switch (f.ui.kind) {
+        case 'textarea':
+            return { ...base, widget: 'textarea' };
+        case 'boolean':
+            return { ...base, widget: 'bool' };
+        case 'date':
+            return { ...base, widget: 'date' };
+        case 'select':
+            return selectDescriptor(base, f.ui.options, {
+                ...(f.ui.multiple !== undefined ? { multiple: f.ui.multiple } : {}),
+                ...(f.ui.placeholder !== undefined ? { placeholder: f.ui.placeholder } : {}),
+                ...(f.ui.clearable !== undefined ? { clearable: f.ui.clearable } : {}),
+            });
+        case 'relationship':
+            return { ...base, widget: 'ref', refTarget: f.ui.to };
+        case 'entry':
+            return { ...base, widget: 'entry', entryCollections: f.ui.collections };
+        case 'entries':
+            return {
+                ...base,
+                widget: 'entries',
+                entriesCollections: f.ui.collections,
+                ...(f.ui.max !== undefined ? { entriesMax: f.ui.max } : {}),
+            };
+        case 'link':
+            return {
+                ...base,
+                widget: 'link',
+                ...(f.ui.collections !== undefined ? { linkCollections: f.ui.collections } : {}),
+            };
+        case 'asset':
+            return { ...base, widget: 'media' };
+        case 'blocks': {
+            const tag = f.ui.sets?.length ? `vulse:blocks:${f.ui.sets.join(',')}` : 'vulse:blocks';
+            return {
+                ...base,
+                widget: 'blocks',
+                description: tag,
+                ...(f.ui.sets?.length ? { blocksSets: f.ui.sets } : {}),
+            };
+        }
+        case 'replicator':
+            return { ...base, widget: 'replicator', replicatorSets: f.ui.sets };
+        case 'grid':
+            return {
+                ...base,
+                widget: 'grid',
+                itemFields: f.ui.fields.map((field) => nestedFieldToDescriptor(field)),
+                gridMode: f.ui.mode ?? 'table',
+                ...(f.ui.minRows !== undefined ? { gridMinRows: f.ui.minRows } : {}),
+                ...(f.ui.maxRows !== undefined ? { gridMaxRows: f.ui.maxRows } : {}),
+                ...(f.ui.addLabel !== undefined ? { gridAddLabel: f.ui.addLabel } : {}),
+            };
+        default:
+            return { ...base, widget: 'text' };
+    }
+}
+function blocksDescriptor(path, required, tag) {
+    const blocksSets = tag.startsWith('vulse:blocks:')
+        ? tag.slice('vulse:blocks:'.length).split(',').filter(Boolean)
+        : [];
+    return {
+        path,
+        widget: 'blocks',
+        required,
+        description: tag,
+        ...(blocksSets.length ? { blocksSets } : {}),
+    };
+}

package/dist/core/blueprints/registry.d.ts

@@ -0,0 +1,9 @@
+import type { Blueprint } from './types.js';
+export declare class BlueprintRegistry {
+    #private;
+    register(bp: Blueprint): void;
+    get(name: string): Blueprint | undefined;
+    list(): Blueprint[];
+    has(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/blueprints/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,iBAAiB;;IAG5B,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAK7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IACxC,IAAI,IAAI,SAAS,EAAE;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAC3B"}

package/dist/core/blueprints/registry.js

@@ -0,0 +1,11 @@
+export class BlueprintRegistry {
+    #map = new Map();
+    register(bp) {
+        if (this.#map.has(bp.name))
+            throw new Error(`Blueprint "${bp.name}" already registered`);
+        this.#map.set(bp.name, bp);
+    }
+    get(name) { return this.#map.get(name); }
+    list() { return [...this.#map.values()]; }
+    has(name) { return this.#map.has(name); }
+}

package/dist/core/blueprints/seed.d.ts

@@ -0,0 +1,5 @@
+import type { VulseDb } from '../db.js';
+import type { Blueprint } from './types.js';
+export declare function seedCodeBlueprints(db: VulseDb, codeBlueprints: Blueprint[]): Promise<void>;
+export declare function listCollectionHandles(db: VulseDb): Promise<string[]>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/core/blueprints/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/seed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAIvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhG;AAED,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG1E"}

package/dist/core/blueprints/seed.js

@@ -0,0 +1,17 @@
+import { eq } from 'drizzle-orm';
+import { vulseCollections } from '../schema.js';
+import { createBlueprint, getBlueprintDefinition } from './mutations.js';
+import { blueprintToDefinition } from './code-to-definition.js';
+export async function seedCodeBlueprints(db, codeBlueprints) {
+    for (const bp of codeBlueprints) {
+        const existing = await getBlueprintDefinition(db, bp.name);
+        if (existing)
+            continue;
+        const def = blueprintToDefinition(bp);
+        await createBlueprint(db, def);
+    }
+}
+export async function listCollectionHandles(db) {
+    const rows = await db.select({ handle: vulseCollections.handle }).from(vulseCollections);
+    return rows.map((r) => r.handle);
+}

package/dist/core/blueprints/select-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { SelectOption } from './definition.js';
+export declare function normalizeSelectOptions(options: SelectOption[]): {
+    key: string;
+    label: string;
+}[];
+export declare function selectOptionKeys(options: SelectOption[]): [string, ...string[]];
+/** Parse blueprint editor textarea: `key` or `key: Label` per line. */
+export declare function parseSelectOptionsText(text: string): SelectOption[];
+export declare function formatSelectOptionsText(options: SelectOption[]): string;
+//# sourceMappingURL=select-helpers.d.ts.map

package/dist/core/blueprints/select-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/select-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAEhG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAI/E;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAYnE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAEvE"}

package/dist/core/blueprints/select-helpers.js

@@ -0,0 +1,26 @@
+export function normalizeSelectOptions(options) {
+    return options.map((o) => (typeof o === 'string' ? { key: o, label: o } : o));
+}
+export function selectOptionKeys(options) {
+    const keys = normalizeSelectOptions(options).map((o) => o.key);
+    if (keys.length === 0)
+        throw new Error('Select field requires at least one option');
+    return keys;
+}
+/** Parse blueprint editor textarea: `key` or `key: Label` per line. */
+export function parseSelectOptionsText(text) {
+    return text
+        .split('\n')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const colon = line.indexOf(':');
+        if (colon > 0) {
+            return { key: line.slice(0, colon).trim(), label: line.slice(colon + 1).trim() };
+        }
+        return line;
+    });
+}
+export function formatSelectOptionsText(options) {
+    return options.map((o) => (typeof o === 'string' ? o : `${o.key}: ${o.label}`)).join('\n');
+}

package/dist/core/blueprints/seo.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'astro/zod';
+import type { FieldDescriptor } from './reflect-fields.js';
+export declare const SEO_FIELD_PATH = "seo";
+export interface SeoContent {
+    metaTitle?: string;
+    metaDescription?: string;
+    ogImage?: string;
+}
+/** Maps blueprint content fields to SEO defaults. Omitted keys use inferred defaults. */
+export interface SeoFieldMapping {
+    metaTitle?: string;
+    metaDescription?: string;
+    ogImage?: string;
+}
+export declare const SeoFieldMappingSchema: z.ZodObject<{
+    metaTitle: z.ZodOptional<z.ZodString>;
+    metaDescription: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface ResolvedSeoField<T = string> {
+    value: T | undefined;
+    sourceField?: string;
+    overridden: boolean;
+}
+export interface ResolvedSeo {
+    metaTitle: ResolvedSeoField;
+    metaDescription: ResolvedSeoField;
+    ogImage: ResolvedSeoField;
+}
+export declare function seoZodSchema(): z.ZodOptional<z.ZodObject<{
+    metaTitle: z.ZodOptional<z.ZodString>;
+    metaDescription: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodString>;
+}>>;
+export declare function applySeoToSchema(schema: z.ZodObject<z.ZodRawShape>, seo?: boolean): z.ZodObject<z.ZodRawShape>;
+export declare function emptySeoContent(): SeoContent;
+export declare function resolveSeoFieldMapping(fields: Array<Pick<FieldDescriptor, 'path' | 'widget'>>, titleField: string, mapping?: SeoFieldMapping): SeoFieldMapping;
+export declare function extractSeoFieldValue(value: unknown, widget: FieldDescriptor['widget'] | undefined): string | undefined;
+export declare function resolveEffectiveSeo(content: Record<string, unknown>, explicit: SeoContent | undefined, fields: FieldDescriptor[], titleField: string, mapping?: SeoFieldMapping): ResolvedSeo;
+export declare function resolvedSeoSummary(resolved: ResolvedSeo): string;
+//# sourceMappingURL=seo.d.ts.map

package/dist/core/blueprints/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,WAAW,CAAA;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,eAAO,MAAM,cAAc,QAAQ,CAAA;AAEnC,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AAEF,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM;IAC1C,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,gBAAgB,CAAA;IAC3B,eAAe,EAAE,gBAAgB,CAAA;IACjC,OAAO,EAAE,gBAAgB,CAAA;CAC1B;AAQD,wBAAgB,YAAY,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACrC,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;CACpC,CAAC,CAAC,CAMF;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAClC,GAAG,CAAC,EAAE,OAAO,GACZ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAO5B;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AA2BD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,EACvD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,eAAe,CAcjB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,GAC5C,MAAM,GAAG,SAAS,CAcpB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,MAAM,EAAE,eAAe,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,WAAW,CA8Bb;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAOhE"}

package/dist/core/blueprints/seo.js

@@ -0,0 +1,125 @@
+import { z } from 'astro/zod';
+export const SEO_FIELD_PATH = 'seo';
+export const SeoFieldMappingSchema = z.object({
+    metaTitle: z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/).optional(),
+    metaDescription: z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/).optional(),
+    ogImage: z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/).optional(),
+});
+export function seoZodSchema() {
+    return z.object({
+        metaTitle: z.string().max(70).optional(),
+        metaDescription: z.string().max(160).optional(),
+        ogImage: z.string().describe('vulse:media').optional(),
+    }).optional();
+}
+export function applySeoToSchema(schema, seo) {
+    if (!seo)
+        return schema;
+    if (SEO_FIELD_PATH in schema.shape)
+        return schema;
+    return z.object({
+        ...schema.shape,
+        [SEO_FIELD_PATH]: seoZodSchema(),
+    });
+}
+export function emptySeoContent() {
+    return {};
+}
+function isProseMirrorDoc(v) {
+    return typeof v === 'object' && v !== null && v.type === 'doc';
+}
+function plainTextFromRichContent(value) {
+    if (typeof value === 'string')
+        return value.replace(/\s+/g, ' ').trim();
+    if (!isProseMirrorDoc(value))
+        return '';
+    const parts = [];
+    function walk(nodes) {
+        for (const node of nodes ?? []) {
+            if (node.type === 'text')
+                parts.push(node.text ?? '');
+            else
+                walk(node.content);
+        }
+    }
+    walk(value.content);
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+}
+function truncateDescription(text, max = 160) {
+    if (text.length <= max)
+        return text;
+    const slice = text.slice(0, max);
+    const lastSpace = slice.lastIndexOf(' ');
+    return (lastSpace > 0 ? slice.slice(0, lastSpace) : slice).trim();
+}
+export function resolveSeoFieldMapping(fields, titleField, mapping) {
+    const mediaField = fields.find((f) => f.widget === 'media')?.path;
+    const textareaField = fields.find((f) => f.widget === 'textarea')?.path;
+    const blocksField = fields.find((f) => f.widget === 'blocks')?.path;
+    const textField = fields.find((f) => f.widget === 'text' && f.path !== titleField)?.path;
+    const resolved = {
+        metaTitle: mapping?.metaTitle ?? titleField,
+    };
+    const metaDescription = mapping?.metaDescription ?? textareaField ?? blocksField ?? textField;
+    if (metaDescription)
+        resolved.metaDescription = metaDescription;
+    const ogImage = mapping?.ogImage ?? mediaField;
+    if (ogImage)
+        resolved.ogImage = ogImage;
+    return resolved;
+}
+export function extractSeoFieldValue(value, widget) {
+    if (value === null || value === undefined)
+        return undefined;
+    switch (widget) {
+        case 'media':
+            return typeof value === 'string' && value ? value : undefined;
+        case 'textarea':
+        case 'text':
+            return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+        case 'blocks':
+            return plainTextFromRichContent(value) || undefined;
+        default:
+            if (typeof value === 'string' && value.trim())
+                return value.trim();
+            return undefined;
+    }
+}
+export function resolveEffectiveSeo(content, explicit, fields, titleField, mapping) {
+    const fieldByPath = new Map(fields.map((f) => [f.path, f]));
+    const resolvedMapping = resolveSeoFieldMapping(fields, titleField, mapping);
+    function resolveField(key, mapKey, transform) {
+        const rawOverride = explicit?.[key];
+        if (key === 'ogImage') {
+            if (typeof rawOverride === 'string' && rawOverride) {
+                return { value: rawOverride, overridden: true };
+            }
+        }
+        else if (typeof rawOverride === 'string' && rawOverride.trim()) {
+            return { value: rawOverride.trim(), overridden: true };
+        }
+        const sourceField = resolvedMapping[mapKey];
+        if (!sourceField)
+            return { value: undefined, overridden: false };
+        const widget = fieldByPath.get(sourceField)?.widget;
+        const raw = extractSeoFieldValue(content[sourceField], widget);
+        const value = raw && transform ? transform(raw) : raw;
+        return { value, sourceField, overridden: false };
+    }
+    return {
+        metaTitle: resolveField('metaTitle', 'metaTitle'),
+        metaDescription: resolveField('metaDescription', 'metaDescription', truncateDescription),
+        ogImage: resolveField('ogImage', 'ogImage'),
+    };
+}
+export function resolvedSeoSummary(resolved) {
+    const title = resolved.metaTitle.value?.trim();
+    if (title)
+        return title;
+    const description = resolved.metaDescription.value?.trim();
+    if (description)
+        return truncateDescription(description, 70);
+    if (resolved.ogImage.value)
+        return 'Image configured';
+    return 'No defaults available yet';
+}

package/dist/core/blueprints/types.d.ts

@@ -0,0 +1,60 @@
+import type { z } from 'astro/zod';
+import type { BlueprintDefinition, FieldDefinition } from './definition.js';
+export type Role = 'admin' | 'editor' | 'member';
+export interface AuthContext {
+    user: {
+        id: string;
+        role: Role;
+        email: string;
+    } | null;
+}
+export interface AccessArgs<T = unknown> extends AuthContext {
+    entry?: {
+        id: string;
+        status: 'draft' | 'published';
+        createdBy: string | null;
+        content: T;
+    };
+}
+export type AccessFn<T = unknown> = (args: AccessArgs<T>) => boolean | Promise<boolean>;
+import type { SeoFieldMapping } from './seo.js';
+export interface AdminConfig {
+    titleField: string;
+    listColumns?: string[];
+    /** Maps content fields to SEO defaults in the entry editor. */
+    seoMapping?: SeoFieldMapping;
+}
+export interface PreviewConfig {
+    /**
+     * URL template for the public-facing entry page. `{slug}` is replaced with
+     * the entry's URL slug. Defaults to `/{slug}` if omitted.
+     * Example: `/recipes/{slug}` or `/blog/{slug}`.
+     */
+    path: string;
+    /** DOM selector for live preview morph target. Defaults to `main`. */
+    rootSelector?: string;
+    /** When `false`, hides the live preview split panel (Preview button still works). Defaults to `true`. */
+    live?: boolean;
+}
+export interface BlueprintAccess<T = unknown> {
+    read?: AccessFn<T>;
+    create?: AccessFn<T>;
+    update?: AccessFn<T>;
+    delete?: AccessFn<T>;
+}
+export interface Blueprint<S extends z.ZodTypeAny = z.ZodTypeAny> {
+    name: string;
+    label: string;
+    schema: S;
+    admin: AdminConfig;
+    access?: BlueprintAccess<z.infer<S>>;
+    preview?: PreviewConfig;
+    singleton?: boolean;
+    tree?: boolean;
+    maxDepth?: number;
+    drafts?: boolean;
+    seo?: boolean;
+    fields?: FieldDefinition[];
+    definition?: BlueprintDefinition;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/blueprints/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE3E,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACvD;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,WAAW;IAC1D,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,CAAA;CAC5F;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yGAAyG;IACzG,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CACrB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,CAAC,CAAA;IACT,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACpC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,UAAU,CAAC,EAAE,mBAAmB,CAAA;CACjC"}

package/dist/core/blueprints/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/blueprints/zod-helpers.d.ts

@@ -0,0 +1,79 @@
+import { z as astroZ, type ZodRawShape, type ZodTypeAny } from 'astro/zod';
+export declare const EMPTY_BLOCKS_DOC: {
+    readonly type: "doc";
+    readonly content: readonly [{
+        readonly type: "paragraph";
+    }];
+};
+export declare function blocks(sets?: string[]): astroZ.ZodDefault<astroZ.ZodAny>;
+/** Legacy flat block list (deprecated). */
+export declare function blocksLegacy(): astroZ.ZodDefault<astroZ.ZodArray<astroZ.ZodDiscriminatedUnion<[astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"heading">;
+    level: astroZ.ZodUnion<readonly [astroZ.ZodLiteral<1>, astroZ.ZodLiteral<2>, astroZ.ZodLiteral<3>, astroZ.ZodLiteral<4>]>;
+    text: astroZ.ZodString;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"paragraph">;
+    text: astroZ.ZodString;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"image">;
+    mediaId: astroZ.ZodString;
+    alt: astroZ.ZodDefault<astroZ.ZodString>;
+    caption: astroZ.ZodOptional<astroZ.ZodString>;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"code">;
+    language: astroZ.ZodString;
+    code: astroZ.ZodString;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"embed">;
+    url: astroZ.ZodString;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"quote">;
+    text: astroZ.ZodString;
+    cite: astroZ.ZodOptional<astroZ.ZodString>;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"list">;
+    ordered: astroZ.ZodDefault<astroZ.ZodBoolean>;
+    items: astroZ.ZodArray<astroZ.ZodString>;
+    id: astroZ.ZodOptional<astroZ.ZodString>;
+}, astroZ.z.core.$strip>], "type">>>;
+/** Media reference: stored as the media row's id; resolved at read time. */
+export declare function media(): astroZ.ZodString;
+/** Reference to another collection (or 'user'). Kept for backward compatibility. */
+export declare function ref(target: string): astroZ.ZodString;
+/** Single entry picker from one or more collections. */
+export declare function entry(...collections: string[]): astroZ.ZodString;
+/** Multi-entry picker from one or more collections. */
+export declare function entries(collections: string[], max?: number): astroZ.ZodArray<astroZ.ZodString>;
+/** URL, entry, or first-child link value. */
+export declare function link(collections?: string[]): astroZ.ZodDiscriminatedUnion<[astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"url">;
+    url: astroZ.ZodString;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"entry">;
+    entryId: astroZ.ZodString;
+    collection: astroZ.ZodString;
+}, astroZ.z.core.$strip>, astroZ.ZodObject<{
+    type: astroZ.ZodLiteral<"first-child">;
+}, astroZ.z.core.$strip>], "type">;
+/** Homogeneous row grid (array of objects with fixed columns). */
+export declare function grid<T extends ZodRawShape>(fields: T, opts?: {
+    minRows?: number;
+    maxRows?: number;
+}): astroZ.ZodArray<astroZ.ZodObject<{ -readonly [P in keyof T]: T[P]; }, astroZ.z.core.$strip>>;
+export type VulseZ = typeof astroZ & {
+    media: typeof media;
+    ref: typeof ref;
+    entry: typeof entry;
+    entries: typeof entries;
+    link: typeof link;
+    grid: typeof grid;
+};
+export declare const z: VulseZ;
+export type { ZodTypeAny };
+//# sourceMappingURL=zod-helpers.d.ts.map

package/dist/core/blueprints/zod-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/blueprints/zod-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,IAAI,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAI1E,eAAO,MAAM,gBAAgB;;;;;CAGnB,CAAA;AAEV,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,oCAGrC;AAED,2CAA2C;AAC3C,wBAAgB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAE3B;AAED,4EAA4E;AAC5E,wBAAgB,KAAK,qBAEpB;AAED,oFAAoF;AACpF,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,oBAEjC;AAED,wDAAwD;AACxD,wBAAgB,KAAK,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,oBAG7C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,qCAS1D;AAED,6CAA6C;AAC7C,wBAAgB,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE;;;;;;;;;mCAG1C;AAED,kEAAkE;AAClE,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EACxC,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,gGAM9C;AAED,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,GAAG;IACnC,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,GAAG,EAAE,OAAO,GAAG,CAAA;IACf,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,OAAO,EAAE,OAAO,OAAO,CAAA;IACvB,IAAI,EAAE,OAAO,IAAI,CAAA;IACjB,IAAI,EAAE,OAAO,IAAI,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,CAAC,EAAE,MAUJ,CAAA;AAEZ,YAAY,EAAE,UAAU,EAAE,CAAA"}