@shoppexio/builder-contracts 0.1.0 → 0.1.2

package/dist/legacy-manifest.js

@@ -1,6 +1,8 @@
 import * as z from 'zod/v4';
+import { createDedicatedPageBlockType } from "./dedicated-pages.js";
 import { BuilderFieldSchema } from "./fields.js";
 import { ThemeManifestSchema } from "./theme-manifest.js";
+import { StyleSlotDefaultsSchema } from "./style-slots.js";
 const LegacyFieldOptionSchema = z
     .object({
     label: z.string().min(1),
@@ -71,6 +73,17 @@ export const LegacyThemeManifestSchema = z
     id: z.string().min(1),
     name: z.string().min(1),
     version: z.string().min(1),
+    author: z.string().min(1).optional(),
+    description: z.string().min(1).optional(),
+    preview: z.string().min(1).optional(),
+    features: z.array(z.string().min(1)).optional(),
+    techStack: z.array(z.string().min(1)).optional(),
+    templates: z.array(z.string().min(1)).optional(),
+    createdAt: z.string().min(1).optional(),
+    demoUrl: z.string().min(1).optional(),
+    audience: z.string().min(1).optional(),
+    tags: z.array(z.string().min(1)).optional(),
+    hotfixPaths: z.array(z.string().min(1)).optional(),
     presets: z.array(LegacyThemePresetSchema).optional(),
     builder: z
         .object({
@@ -82,6 +95,10 @@ export const LegacyThemeManifestSchema = z
 })
     .passthrough();
 export function convertLegacyThemeManifest(input) {
+    const canonical = ThemeManifestSchema.safeParse(input);
+    if (canonical.success) {
+        return canonical.data;
+    }
     const legacy = LegacyThemeManifestSchema.parse(input);
     const blocks = Object.fromEntries(Object.entries(legacy.builder.blocks).map(([blockType, block]) => [
         blockType,
@@ -95,7 +112,7 @@ export function convertLegacyThemeManifest(input) {
         },
     ]));
     for (const page of legacy.builder.pages) {
-        const syntheticBlockType = createSyntheticPageBlockType(page.id);
+        const syntheticBlockType = createDedicatedPageBlockType(page.id);
         if ((page.fields?.length ?? 0) === 0 && (page.lists?.length ?? 0) === 0) {
             continue;
         }
@@ -112,8 +129,19 @@ export function convertLegacyThemeManifest(input) {
         id: normalizeLegacyThemeId(legacy.id),
         name: legacy.name,
         version: legacy.version,
+        author: legacy.author,
+        description: legacy.description,
+        preview: legacy.preview,
+        features: legacy.features,
+        techStack: legacy.techStack,
+        templates: legacy.templates,
+        createdAt: legacy.createdAt,
+        demoUrl: legacy.demoUrl,
+        audience: legacy.audience,
+        tags: legacy.tags,
+        hotfixPaths: legacy.hotfixPaths,
         pages: Object.fromEntries(legacy.builder.pages.map((page) => {
-            const syntheticBlockType = createSyntheticPageBlockType(page.id);
+            const syntheticBlockType = createDedicatedPageBlockType(page.id);
             const hasSyntheticBlock = blocks[syntheticBlockType] !== undefined;
             const allowedBlocks = page.blocks.length > 0
                 ? page.blocks
@@ -137,6 +165,8 @@ export function convertLegacyThemeManifest(input) {
         blocks,
         styleSlots: {},
         presets: convertLegacyThemePresets(legacy.presets ?? []),
+        linkGroups: Array.isArray(legacy.builder.linkGroups) ? legacy.builder.linkGroups : [],
+        defaultLinkItems: isPlainObject(legacy.builder.defaultLinkItems) ? legacy.builder.defaultLinkItems : {},
     };
     return ThemeManifestSchema.parse(converted);
 }
@@ -147,21 +177,21 @@ function normalizeLegacyThemeId(rawId) {
     }
     return `legacy-${lowered || 'theme'}`;
 }
-function createSyntheticPageBlockType(pageId) {
-    const normalizedPageId = pageId.toLowerCase().replace(/[^a-z0-9\-_.]+/g, '-').replace(/^[-_.]+/, '');
-    return `page-${normalizedPageId || 'custom'}`;
-}
 function convertLegacyThemePresets(presets) {
-    return Object.fromEntries(presets.map((preset) => [
-        preset.id,
-        {
-            label: preset.name ?? preset.label ?? preset.id,
-            description: preset.description,
-            content: flattenContentRecord(preset.overrides?.content ?? {}),
-            layout: preset.overrides?.layout ?? {},
-            style_slots: preset.overrides?.style_slots ?? preset.overrides?.styleSlots ?? {},
-        },
-    ]));
+    return Object.fromEntries(presets.map((preset) => {
+        const styleSlots = StyleSlotDefaultsSchema.parse(preset.overrides?.style_slots ?? preset.overrides?.styleSlots ?? {});
+        return [
+            preset.id,
+            {
+                label: preset.name ?? preset.label ?? preset.id,
+                description: preset.description,
+                preview: typeof preset.preview === 'string' ? preset.preview : undefined,
+                content: flattenContentRecord(preset.overrides?.content ?? {}),
+                layout: preset.overrides?.layout ?? {},
+                style_slots: styleSlots,
+            },
+        ];
+    }));
 }
 function flattenContentRecord(content, prefix = '') {
     const flattened = {};
@@ -180,21 +210,59 @@ function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 function convertLegacyFields(fields, lists) {
-    const convertedFields = Object.fromEntries(fields.map((field) => [field.path, convertLegacyField(field)]));
-    const convertedLists = Object.fromEntries(lists.map((list) => [
-        list.path,
-        {
+    // Auto-promote inline `type: 'list'` fields to first-class list entries so
+    // the migrator can emit list-shaped data without separately maintaining a
+    // `lists: []` block-level entry. The promoted list inherits its kind from
+    // the field path (e.g. `header.left_links` → kind `navLinks`).
+    const inlineLists = [];
+    const remainingFields = [];
+    for (const field of fields) {
+        if (field.type === 'list') {
+            inlineLists.push({
+                path: field.path,
+                label: field.label,
+                kind: inferListKindFromPath(field.path),
+                description: field.description,
+            });
+        }
+        else {
+            remainingFields.push(field);
+        }
+    }
+    const convertedFields = Object.fromEntries(remainingFields.map((field) => [field.path, convertLegacyField(field)]));
+    const allLists = [...inlineLists, ...lists];
+    const convertedLists = Object.fromEntries(allLists.map((list) => {
+        const inlineField = fields.find((f) => f.type === 'list' && f.path === list.path);
+        const candidate = {
             type: 'list',
             label: list.label,
             description: list.description,
             itemShape: createListItemShape(list.kind),
-        },
-    ]));
+            ...(inlineField?.defaultValue !== undefined ? { defaultValue: inlineField.defaultValue } : {}),
+        };
+        return [list.path, candidate];
+    }));
     return {
         ...convertedFields,
         ...convertedLists,
     };
 }
+function inferListKindFromPath(path) {
+    const suffix = path.split('.').at(-1) ?? '';
+    if (/items$/i.test(suffix))
+        return 'faqItems';
+    if (/links$/i.test(suffix))
+        return 'navLinks';
+    if (/images$/i.test(suffix) || /gallery$/i.test(suffix))
+        return 'galleryItems';
+    if (/features$/i.test(suffix))
+        return 'featureItems';
+    if (/reviews$/i.test(suffix) || /testimonials$/i.test(suffix))
+        return 'reviewItems';
+    if (/announcements$/i.test(suffix))
+        return 'announcementItems';
+    return 'genericItems';
+}
 function convertLegacyField(field) {
     const type = normalizeLegacyFieldType(field.type);
     const base = {
@@ -265,8 +333,55 @@ function createListItemShape(kind) {
             author: { type: 'text', label: 'Author' },
         };
     }
+    if (kind === 'navLinks') {
+        return {
+            text: { type: 'text', label: 'Text' },
+            link: { type: 'link', label: 'Link' },
+        };
+    }
+    if (kind === 'featureItems') {
+        return {
+            title: { type: 'text', label: 'Title' },
+            description: { type: 'richtext', label: 'Description' },
+            icon: { type: 'text', label: 'Icon' },
+        };
+    }
+    if (kind === 'announcementItems') {
+        return {
+            text: { type: 'text', label: 'Text' },
+            link: { type: 'link', label: 'Link' },
+        };
+    }
     return {
         title: { type: 'text', label: 'Title' },
         body: { type: 'richtext', label: 'Body' },
     };
 }
+function resolveManifestPagesForBlockOrder(manifest) {
+    const canonical = ThemeManifestSchema.safeParse(manifest);
+    if (canonical.success) {
+        return canonical.data.pages;
+    }
+    try {
+        return convertLegacyThemeManifest(manifest).pages;
+    }
+    catch {
+        if (typeof manifest === 'object' && manifest !== null && 'pages' in manifest) {
+            const pages = manifest.pages;
+            if (typeof pages === 'object' && pages !== null && !Array.isArray(pages)) {
+                return pages;
+            }
+        }
+        return {};
+    }
+}
+export function getThemePageBlockOrderFromManifest(manifest, pageId) {
+    const page = resolveManifestPagesForBlockOrder(manifest)[pageId];
+    if (!page) {
+        return [];
+    }
+    const defaultBlockTypes = (Array.isArray(page.defaultBlocks) ? page.defaultBlocks : [])
+        .map((block) => (typeof block === 'object' && block !== null ? block.type : undefined))
+        .filter((blockType) => typeof blockType === 'string' && blockType.length > 0);
+    return defaultBlockTypes.length > 0 ? defaultBlockTypes : page.allowedBlocks ?? [];
+}

package/dist/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,QAAQ,SAAI,GAAG,eAAe,CAYxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,UAAU,CAAC;CAC9B,GAAG,aAAa,CAShB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,CAE9E;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,EAAE,QAAQ,SAAI,GAAG,eAAe,CAkB7G;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,GAAG,eAAe,CAwB9G;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAa/F"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,QAAQ,SAAI,GAAG,eAAe,CAYxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,UAAU,CAAC;CAC9B,GAAG,aAAa,CAShB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,CAE9E;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,EAAE,QAAQ,SAAI,GAAG,eAAe,CAoB7G;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,GAAG,eAAe,CAwB9G;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAuC/F"}

package/dist/migrations.js

@@ -1,4 +1,6 @@
+import { migrateDedicatedPageContent, migrateDedicatedPageLayout } from "./dedicated-pages.js";
 import { BUILDER_SETTINGS_VERSION, BuilderSettingsSchema, } from "./builder-settings.js";
+import { sanitizeBuilderSettingsState } from "./persistence.js";
 export function createEmptyBuilderSettings(revision = 0) {
     return {
         version: BUILDER_SETTINGS_VERSION,
@@ -31,17 +33,19 @@ export function migrateLegacyBuilderSettings(input, revision = 0) {
         ...mapLegacyTokenOverridesToStyleSlots(tokensOverride),
         ...(input.theme?.style_slots ?? {}),
     };
-    return BuilderSettingsSchema.parse({
+    const rawContent = input.theme?.content ?? {};
+    const rawLayout = input.theme?.layout ?? {};
+    return sanitizeBuilderSettingsState(BuilderSettingsSchema.parse({
         version: BUILDER_SETTINGS_VERSION,
         revision,
         theme: {
-            content: input.theme?.content ?? {},
-            layout: normalizeLegacyLayout(input.theme?.layout ?? {}),
+            content: migrateDedicatedPageContent(rawContent),
+            layout: migrateDedicatedPageLayout(normalizeLegacyLayout(rawLayout)),
             style_slots: styleSlots,
             pages: [],
             terms: {},
         },
-    });
+    }));
 }
 export function applyManifestDefaultLayout(settings, manifest) {
     const next = cloneBuilderSettings(settings);
@@ -68,13 +72,33 @@ export function applyManifestDefaultLayout(settings, manifest) {
 export function mapLegacyTokenOverridesToStyleSlots(tokens) {
     const slots = {};
     assignResponsiveNumber(tokens, slots, 'buttons.borderRadius', 'button.radius');
+    assignColor(tokens, slots, 'buttons.background', 'button.background');
+    assignColor(tokens, slots, 'buttons.foreground', 'button.foreground');
+    assignColor(tokens, slots, 'buttons.border', 'button.border');
+    assignFontWeight(tokens, slots, 'buttons.fontWeight', 'button.font.weight');
     assignResponsiveNumber(tokens, slots, 'inputs.borderRadius', 'input.radius');
     assignResponsiveNumber(tokens, slots, 'inputs.height', 'input.height');
+    assignColor(tokens, slots, 'inputs.border', 'input.border');
+    assignColor(tokens, slots, 'inputs.background', 'input.background');
+    assignColor(tokens, slots, 'inputs.foreground', 'input.foreground');
+    assignResponsiveNumber(tokens, slots, 'cards.borderRadius', 'card.radius');
+    assignColor(tokens, slots, 'cards.background', 'card.background');
+    assignColor(tokens, slots, 'cards.border', 'card.border');
+    assignResponsiveNumber(tokens, slots, 'sections.paddingY', 'section.padding.y');
+    assignResponsiveNumber(tokens, slots, 'sections.paddingX', 'section.padding.x');
+    assignResponsiveNumber(tokens, slots, 'container.width', 'container.width');
     assignColor(tokens, slots, 'colors.primary', 'color.primary');
     assignColor(tokens, slots, 'colors.accent', 'color.accent');
     assignColor(tokens, slots, 'colors.background', 'color.background');
     assignColor(tokens, slots, 'colors.foreground', 'color.foreground');
     assignColor(tokens, slots, 'colors.muted', 'color.muted');
+    assignColor(tokens, slots, 'links.color', 'link.color');
+    assignFontWeight(tokens, slots, 'typography.headingWeight', 'typography.heading.weight');
+    assignResponsiveNumber(tokens, slots, 'typography.fontSize', 'typography.body.size');
+    assignResponsiveNumber(tokens, slots, 'typography.bodySize', 'typography.body.size');
+    assignString(tokens, slots, 'typography.fontFamily', 'theme.typography.font.family');
+    assignString(tokens, slots, 'typography.headingFont', 'theme.typography.heading.font');
+    assignResponsiveNumber(tokens, slots, 'header.height', 'theme.header.height');
     return slots;
 }
 function normalizeLegacyLayout(layout) {
@@ -128,7 +152,7 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 function assignResponsiveNumber(tokens, slots, tokenPath, slotId) {
-    const value = tokens[tokenPath];
+    const value = readLegacyTokenPath(tokens, tokenPath);
     if (typeof value === 'number' && Number.isFinite(value)) {
         slots[slotId] = { base: value };
         return;
@@ -138,11 +162,36 @@ function assignResponsiveNumber(tokens, slots, tokenPath, slotId) {
     }
 }
 function assignColor(tokens, slots, tokenPath, slotId) {
-    const value = tokens[tokenPath];
+    const value = readLegacyTokenPath(tokens, tokenPath);
     if (typeof value === 'string') {
         slots[slotId] = value;
     }
 }
+function assignString(tokens, slots, tokenPath, slotId) {
+    const value = readLegacyTokenPath(tokens, tokenPath);
+    if (typeof value === 'string' && value.trim().length > 0) {
+        slots[slotId] = value;
+    }
+}
+function assignFontWeight(tokens, slots, tokenPath, slotId) {
+    const value = readLegacyTokenPath(tokens, tokenPath);
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        slots[slotId] = value;
+    }
+}
+function readLegacyTokenPath(tokens, tokenPath) {
+    if (Object.prototype.hasOwnProperty.call(tokens, tokenPath)) {
+        return tokens[tokenPath];
+    }
+    let current = tokens;
+    for (const segment of tokenPath.split('.')) {
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
 function isResponsiveNumber(value) {
     if (!value || typeof value !== 'object') {
         return false;

package/dist/persistence.d.ts

@@ -0,0 +1,7 @@
+import { type BuilderSettings } from './builder-settings.ts';
+type JsonRecord = Record<string, unknown>;
+export declare function extractPersistedBuilderSettings(input: unknown): BuilderSettings | null;
+export declare function sanitizeBuilderSettingsState(settings: BuilderSettings): BuilderSettings;
+export declare function mergeBuilderSettingsIntoThemeSettings(currentSettings: unknown, builderSettings: BuilderSettings): JsonRecord;
+export {};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAmB1C,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAYtF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CASvF;AAaD,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,OAAO,EACxB,eAAe,EAAE,eAAe,GAC/B,UAAU,CAaZ"}

package/dist/persistence.js

@@ -0,0 +1,58 @@
+import { BuilderSettingsSchema, } from "./builder-settings.js";
+const RESERVED_THEME_CONTENT_KEYS = new Set(['layout']);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function pickBuilderSettingsFields(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    return {
+        version: value.version,
+        revision: value.revision,
+        theme: value.theme,
+    };
+}
+export function extractPersistedBuilderSettings(input) {
+    const parsedDirect = BuilderSettingsSchema.safeParse(pickBuilderSettingsFields(input));
+    if (parsedDirect.success) {
+        return sanitizeBuilderSettingsState(parsedDirect.data);
+    }
+    if (!isRecord(input)) {
+        return null;
+    }
+    const parsedNested = BuilderSettingsSchema.safeParse(pickBuilderSettingsFields(input.builder_settings));
+    return parsedNested.success ? sanitizeBuilderSettingsState(parsedNested.data) : null;
+}
+export function sanitizeBuilderSettingsState(settings) {
+    const content = sanitizeThemeContent(settings.theme.content);
+    return BuilderSettingsSchema.parse({
+        ...settings,
+        theme: {
+            ...settings.theme,
+            content,
+        },
+    });
+}
+function sanitizeThemeContent(content) {
+    const next = {};
+    for (const [key, value] of Object.entries(content)) {
+        if (RESERVED_THEME_CONTENT_KEYS.has(key)) {
+            continue;
+        }
+        next[key] = value;
+    }
+    return next;
+}
+export function mergeBuilderSettingsIntoThemeSettings(currentSettings, builderSettings) {
+    const root = isRecord(currentSettings) ? { ...currentSettings } : {};
+    const currentBuilderSettings = isRecord(root.builder_settings) ? root.builder_settings : {};
+    const sanitizedBuilderSettings = sanitizeBuilderSettingsState(builderSettings);
+    root.builder_settings = {
+        ...currentBuilderSettings,
+        version: sanitizedBuilderSettings.version,
+        revision: sanitizedBuilderSettings.revision,
+        theme: sanitizedBuilderSettings.theme,
+    };
+    return root;
+}

package/dist/preview-boot.d.ts

@@ -0,0 +1,68 @@
+import * as z from 'zod/v4';
+export declare const PREVIEW_BOOT_SIDECAR_PATH = "__shoppex/preview-boot.json";
+export declare const StorefrontSeedSchema: z.ZodObject<{
+    store: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    products: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export type StorefrontSeed = z.infer<typeof StorefrontSeedSchema>;
+export declare const PreviewBootPayloadSchema: z.ZodObject<{
+    shopId: z.ZodString;
+    shopSlug: z.ZodString;
+    builderSettings: z.ZodObject<{
+        version: z.ZodLiteral<2>;
+        revision: z.ZodNumber;
+        theme: z.ZodObject<{
+            content: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            layout: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                blocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodString;
+                    variant: z.ZodOptional<z.ZodString>;
+                    visible: z.ZodDefault<z.ZodBoolean>;
+                    settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    style_overrides: z.ZodOptional<z.ZodType<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown, z.core.$ZodTypeInternals<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown>>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            style_slots: z.ZodDefault<z.ZodType<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown, z.core.$ZodTypeInternals<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown>>>;
+            pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                slug: z.ZodString;
+                visible: z.ZodDefault<z.ZodBoolean>;
+                layout: z.ZodDefault<z.ZodObject<{
+                    blocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        type: z.ZodString;
+                        variant: z.ZodOptional<z.ZodString>;
+                        visible: z.ZodDefault<z.ZodBoolean>;
+                        settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        style_overrides: z.ZodOptional<z.ZodType<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown, z.core.$ZodTypeInternals<Partial<Record<import("./style-slots.ts").StyleSlotId, import("./style-slots.ts").StyleSlotValue>>, unknown>>>;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>>;
+                seo: z.ZodOptional<z.ZodObject<{
+                    title: z.ZodOptional<z.ZodString>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>>;
+            terms: z.ZodDefault<z.ZodObject<{
+                termsOfService: z.ZodOptional<z.ZodString>;
+                privacyPolicy: z.ZodOptional<z.ZodString>;
+                refundPolicy: z.ZodOptional<z.ZodString>;
+                imprint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    storefrontSeed: z.ZodObject<{
+        store: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        products: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        pages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>;
+    artifactRevision: z.ZodOptional<z.ZodString>;
+    artifactStale: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PreviewBootPayload = z.infer<typeof PreviewBootPayloadSchema>;
+export declare function mergePreviewBootIntoInitialData(payload: PreviewBootPayload): Record<string, unknown>;
+//# sourceMappingURL=preview-boot.d.ts.map

package/dist/preview-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-boot.d.ts","sourceRoot":"","sources":["../src/preview-boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAIvE,eAAO,MAAM,oBAAoB;;;;;iBAOjB,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAS1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/preview-boot.js

@@ -0,0 +1,38 @@
+import * as z from 'zod/v4';
+import { BuilderSettingsSchema } from "./builder-settings.js";
+export const PREVIEW_BOOT_SIDECAR_PATH = '__shoppex/preview-boot.json';
+// Artifact HTML seeds include catalog/menu fields beyond the documented minimum.
+// Passthrough keeps them available to the theme runtime in preview boot.
+export const StorefrontSeedSchema = z
+    .object({
+    store: z.record(z.string(), z.unknown()),
+    products: z.array(z.unknown()).optional(),
+    groups: z.array(z.unknown()).optional(),
+    pages: z.array(z.unknown()).optional(),
+})
+    .passthrough();
+export const PreviewBootPayloadSchema = z
+    .object({
+    shopId: z.string().min(1),
+    shopSlug: z.string().min(1),
+    builderSettings: BuilderSettingsSchema,
+    storefrontSeed: StorefrontSeedSchema,
+    artifactRevision: z.string().optional(),
+    artifactStale: z.boolean().optional(),
+})
+    .strict();
+export function mergePreviewBootIntoInitialData(payload) {
+    const existingStore = isRecord(payload.storefrontSeed.store) ? payload.storefrontSeed.store : {};
+    return {
+        ...payload.storefrontSeed,
+        store: {
+            ...existingStore,
+            id: payload.shopId,
+            slug: payload.shopSlug,
+            builder_settings: payload.builderSettings,
+        },
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}