@shoppexio/builder-contracts 0.1.1 → 0.1.3

package/dist/legacy-manifest.d.ts

@@ -179,5 +179,12 @@ export declare const LegacyThemeManifestSchema: z.ZodObject<{
 }, z.core.$loose>;
 export type LegacyThemeManifest = z.infer<typeof LegacyThemeManifestSchema>;
 export declare function convertLegacyThemeManifest(input: unknown): ThemeManifest;
+export type ThemePageBlockOrderPage = {
+    allowedBlocks?: string[];
+    defaultBlocks?: Array<{
+        type?: string;
+    }>;
+};
+export declare function getThemePageBlockOrderFromManifest(manifest: unknown, pageId: string): string[];
 export {};
 //# sourceMappingURL=legacy-manifest.d.ts.map

package/dist/legacy-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-manifest.d.ts","sourceRoot":"","sources":["../src/legacy-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAU9E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAarB,CAAC;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;iBAOpB,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrB,CAAC;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,QAAA,MAAM,uBAAuB;;;;;;;;;;;iBAgBb,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBtB,CAAC;AACjB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAoFxE"}
+{"version":3,"file":"legacy-manifest.d.ts","sourceRoot":"","sources":["../src/legacy-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAU9E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAarB,CAAC;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;iBAOpB,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrB,CAAC;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,QAAA,MAAM,uBAAuB;;;;;;;;;;;iBAgBb,CAAC;AACjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBtB,CAAC;AACjB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAoFxE;AAuND,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1C,CAAC;AAqBF,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAW9F"}

package/dist/legacy-manifest.js

@@ -1,4 +1,5 @@
 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";
@@ -111,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;
         }
@@ -140,7 +141,7 @@ export function convertLegacyThemeManifest(input) {
         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
@@ -176,10 +177,6 @@ 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) => {
         const styleSlots = StyleSlotDefaultsSchema.parse(preset.overrides?.style_slots ?? preset.overrides?.styleSlots ?? {});
@@ -360,3 +357,31 @@ function createListItemShape(kind) {
         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

@@ -27,5 +27,6 @@ export declare function createBlockInstance(input: {
 export declare function createPageLayoutFromBlocks(blocks: BlockInstance[]): PageLayout;
 export declare function migrateLegacyBuilderSettings(input: LegacyBuilderSettingsInput, revision?: number): BuilderSettings;
 export declare function applyManifestDefaultLayout(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettings;
+export declare function mapLegacyNestedThemeTypographyToStyleSlots(theme: Record<string, unknown>, baseSlots?: StyleSlots): StyleSlots;
 export declare function mapLegacyTokenOverridesToStyleSlots(tokens: Record<string, unknown>): StyleSlots;
 //# sourceMappingURL=migrations.d.ts.map

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;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,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,CAuC/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,0CAA0C,CACxD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,GAAE,UAAe,GACzB,UAAU,CAkBZ;AAeD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAuC/F"}

package/dist/migrations.js

@@ -1,3 +1,4 @@
+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) {
@@ -32,12 +33,14 @@ export function migrateLegacyBuilderSettings(input, revision = 0) {
         ...mapLegacyTokenOverridesToStyleSlots(tokensOverride),
         ...(input.theme?.style_slots ?? {}),
     };
+    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: {},
@@ -66,6 +69,31 @@ export function applyManifestDefaultLayout(settings, manifest) {
     }
     return BuilderSettingsSchema.parse(next);
 }
+export function mapLegacyNestedThemeTypographyToStyleSlots(theme, baseSlots = {}) {
+    const slots = { ...baseSlots };
+    const typography = theme.typography;
+    if (!isRecord(typography)) {
+        return slots;
+    }
+    const bodyFont = readLegacyTypographyString(typography, 'font_family', 'fontFamily');
+    const headingFont = readLegacyTypographyString(typography, 'heading_font', 'headingFont');
+    if (bodyFont && slots['theme.typography.font.family'] === undefined) {
+        slots['theme.typography.font.family'] = bodyFont;
+    }
+    if (headingFont && slots['theme.typography.heading.font'] === undefined) {
+        slots['theme.typography.heading.font'] = headingFont;
+    }
+    return slots;
+}
+function readLegacyTypographyString(typography, ...keys) {
+    for (const key of keys) {
+        const value = typography[key];
+        if (typeof value === 'string' && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return null;
+}
 export function mapLegacyTokenOverridesToStyleSlots(tokens) {
     const slots = {};
     assignResponsiveNumber(tokens, slots, 'buttons.borderRadius', 'button.radius');

package/dist/persistence.d.ts

@@ -1,6 +1,15 @@
 import { type BuilderSettings } from './builder-settings.ts';
 type JsonRecord = Record<string, unknown>;
 export declare function extractPersistedBuilderSettings(input: unknown): BuilderSettings | null;
+/**
+ * Single read boundary for builder v2 state: strict extract first, then legacy migration.
+ * Strips invalid keys such as nested `theme.typography` while preserving style_slots and pages.
+ */
+export declare function coercePersistedBuilderSettings(input: unknown): BuilderSettings | null;
+/**
+ * Coerces builder v2 fields for storefront export while preserving non-v2 siblings (seo, appearance, …).
+ */
+export declare function exportCoercedBuilderSettingsBlob(builderSettingsBlob: unknown): JsonRecord | null;
 export declare function sanitizeBuilderSettingsState(settings: BuilderSettings): BuilderSettings;
 export declare function mergeBuilderSettingsIntoThemeSettings(currentSettings: unknown, builderSettings: BuilderSettings): JsonRecord;
 export {};

package/dist/persistence.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAQ/B,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAmB1C,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAYtF;AA0BD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAkDrF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,mBAAmB,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAgBhG;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

@@ -1,4 +1,5 @@
 import { BuilderSettingsSchema, } from "./builder-settings.js";
+import { mapLegacyNestedThemeTypographyToStyleSlots, mapLegacyTokenOverridesToStyleSlots, migrateLegacyBuilderSettings, } from "./migrations.js";
 const RESERVED_THEME_CONTENT_KEYS = new Set(['layout']);
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -24,6 +25,85 @@ export function extractPersistedBuilderSettings(input) {
     const parsedNested = BuilderSettingsSchema.safeParse(pickBuilderSettingsFields(input.builder_settings));
     return parsedNested.success ? sanitizeBuilderSettingsState(parsedNested.data) : null;
 }
+function parseBuilderSettingsRevision(input) {
+    return typeof input === 'number' && Number.isInteger(input) && input >= 0 ? input : 0;
+}
+function unwrapBuilderSettingsRecord(input) {
+    if (!isRecord(input)) {
+        return null;
+    }
+    if (isRecord(input.builder_settings)) {
+        return input.builder_settings;
+    }
+    if ('version' in input || 'revision' in input || 'theme' in input) {
+        return input;
+    }
+    return null;
+}
+function readStyleSlotsRecord(theme) {
+    return isRecord(theme.style_slots) ? theme.style_slots : {};
+}
+/**
+ * Single read boundary for builder v2 state: strict extract first, then legacy migration.
+ * Strips invalid keys such as nested `theme.typography` while preserving style_slots and pages.
+ */
+export function coercePersistedBuilderSettings(input) {
+    const extracted = extractPersistedBuilderSettings(input);
+    if (extracted) {
+        return extracted;
+    }
+    if (isRecord(input) && isRecord(input.builder_settings)) {
+        const nestedExtracted = extractPersistedBuilderSettings(input.builder_settings);
+        if (nestedExtracted) {
+            return nestedExtracted;
+        }
+    }
+    const blob = unwrapBuilderSettingsRecord(input);
+    if (!blob) {
+        return null;
+    }
+    const theme = isRecord(blob.theme) ? blob.theme : {};
+    const tokensOverride = isRecord(theme.tokens_override) ? theme.tokens_override : {};
+    const styleSlots = mapLegacyNestedThemeTypographyToStyleSlots(theme, {
+        ...mapLegacyTokenOverridesToStyleSlots(tokensOverride),
+        ...readStyleSlotsRecord(theme),
+    });
+    const migrated = migrateLegacyBuilderSettings({
+        theme: {
+            content: isRecord(theme.content) ? theme.content : {},
+            layout: isRecord(theme.layout) ? theme.layout : {},
+            tokens_override: tokensOverride,
+            style_slots: styleSlots,
+        },
+    }, parseBuilderSettingsRevision(blob.revision));
+    const merged = BuilderSettingsSchema.safeParse({
+        ...migrated,
+        theme: {
+            ...migrated.theme,
+            pages: Array.isArray(theme.pages) ? theme.pages : migrated.theme.pages,
+            terms: isRecord(theme.terms) ? theme.terms : migrated.theme.terms,
+        },
+    });
+    return merged.success ? sanitizeBuilderSettingsState(merged.data) : migrated;
+}
+/**
+ * Coerces builder v2 fields for storefront export while preserving non-v2 siblings (seo, appearance, …).
+ */
+export function exportCoercedBuilderSettingsBlob(builderSettingsBlob) {
+    if (!isRecord(builderSettingsBlob)) {
+        return null;
+    }
+    const coerced = coercePersistedBuilderSettings(builderSettingsBlob);
+    if (!coerced) {
+        return null;
+    }
+    return {
+        ...builderSettingsBlob,
+        version: coerced.version,
+        revision: coerced.revision,
+        theme: coerced.theme,
+    };
+}
 export function sanitizeBuilderSettingsState(settings) {
     const content = sanitizeThemeContent(settings.theme.content);
     return BuilderSettingsSchema.parse({

package/dist/preview-boot.d.ts

@@ -5,7 +5,7 @@ export declare const StorefrontSeedSchema: z.ZodObject<{
     products: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     groups: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     pages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-}, z.core.$strict>;
+}, z.core.$loose>;
 export type StorefrontSeed = z.infer<typeof StorefrontSeedSchema>;
 export declare const PreviewBootPayloadSchema: z.ZodObject<{
     shopId: z.ZodString;
@@ -59,7 +59,7 @@ export declare const PreviewBootPayloadSchema: z.ZodObject<{
         products: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         groups: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         pages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-    }, z.core.$strict>;
+    }, z.core.$loose>;
     artifactRevision: z.ZodOptional<z.ZodString>;
     artifactStale: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;

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

@@ -1 +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;AAEvE,eAAO,MAAM,oBAAoB;;;;;kBAOtB,CAAC;AAEZ,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"}
+{"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

@@ -1,6 +1,8 @@
 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()),
@@ -8,7 +10,7 @@ export const StorefrontSeedSchema = z
     groups: z.array(z.unknown()).optional(),
     pages: z.array(z.unknown()).optional(),
 })
-    .strict();
+    .passthrough();
 export const PreviewBootPayloadSchema = z
     .object({
     shopId: z.string().min(1),

package/dist/preview-protocol.d.ts

@@ -66,6 +66,24 @@ export declare const PreviewApplyStateMessageSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const EdgeBlockRenderModeSchema: z.ZodLiteral<"edge-block-engine">;
+export type EdgeBlockRenderMode = z.infer<typeof EdgeBlockRenderModeSchema>;
+export declare const PreviewBlockHtmlPatchSchema: z.ZodObject<{
+    blockId: z.ZodString;
+    html: z.ZodString;
+}, z.core.$strict>;
+export type PreviewBlockHtmlPatch = z.infer<typeof PreviewBlockHtmlPatchSchema>;
+export declare const PreviewApplyBlockHtmlMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"APPLY_BLOCK_HTML">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blocks: z.ZodArray<z.ZodObject<{
+        blockId: z.ZodString;
+        html: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const PreviewReloadMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"RELOAD">;
     revision: z.ZodNumber;
@@ -164,6 +182,16 @@ export declare const PreviewMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             }, z.core.$strict>>;
         }, z.core.$strict>;
     }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"APPLY_BLOCK_HTML">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blocks: z.ZodArray<z.ZodObject<{
+        blockId: z.ZodString;
+        html: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"RELOAD">;
     revision: z.ZodNumber;
@@ -209,14 +237,28 @@ export declare const PreviewBootstrapOkResponseSchema: z.ZodObject<{
     shopId: z.ZodString;
     artifactStale: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+export declare const PreviewReadyHealthSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    reactMounted: z.ZodLiteral<true>;
+    builderRuntimeProvider: z.ZodLiteral<true>;
+    protocolVersion: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    edgeBlockEngine: z.ZodLiteral<true>;
+    blockHtmlReconcile: z.ZodLiteral<true>;
+    protocolVersion: z.ZodLiteral<3>;
+}, z.core.$strict>], "protocolVersion">;
+export type PreviewReadyHealth = z.infer<typeof PreviewReadyHealthSchema>;
 export declare const PreviewReadyResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"READY">;
     revision: z.ZodNumber;
-    health: z.ZodOptional<z.ZodObject<{
+    health: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         reactMounted: z.ZodLiteral<true>;
         builderRuntimeProvider: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<2>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        edgeBlockEngine: z.ZodLiteral<true>;
+        blockHtmlReconcile: z.ZodLiteral<true>;
+        protocolVersion: z.ZodLiteral<3>;
+    }, z.core.$strict>], "protocolVersion">>;
 }, z.core.$strict>;
 export declare const PreviewAppliedResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"APPLIED">;
@@ -227,6 +269,26 @@ export declare const PreviewApplyFailedResponseSchema: z.ZodObject<{
     revision: z.ZodNumber;
     error: z.ZodString;
 }, z.core.$strict>;
+export declare const PreviewBlockHtmlAppliedResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"BLOCK_HTML_APPLIED">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blocks: z.ZodArray<z.ZodObject<{
+        blockId: z.ZodString;
+        html: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PreviewBlockHtmlFailedResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"BLOCK_HTML_FAILED">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodOptional<z.ZodString>;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blockIds: z.ZodArray<z.ZodString>;
+    error: z.ZodString;
+}, z.core.$strict>;
 export declare const PreviewElementClickedResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"ELEMENT_CLICKED">;
     revision: z.ZodOptional<z.ZodNumber>;
@@ -351,11 +413,15 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"READY">;
     revision: z.ZodNumber;
-    health: z.ZodOptional<z.ZodObject<{
+    health: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         reactMounted: z.ZodLiteral<true>;
         builderRuntimeProvider: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<2>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        edgeBlockEngine: z.ZodLiteral<true>;
+        blockHtmlReconcile: z.ZodLiteral<true>;
+        protocolVersion: z.ZodLiteral<3>;
+    }, z.core.$strict>], "protocolVersion">>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"APPLIED">;
     revision: z.ZodNumber;
@@ -363,6 +429,24 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     type: z.ZodLiteral<"APPLY_FAILED">;
     revision: z.ZodNumber;
     error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"BLOCK_HTML_APPLIED">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blocks: z.ZodArray<z.ZodObject<{
+        blockId: z.ZodString;
+        html: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"BLOCK_HTML_FAILED">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodOptional<z.ZodString>;
+    renderMode: z.ZodLiteral<"edge-block-engine">;
+    blockIds: z.ZodArray<z.ZodString>;
+    error: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"ELEMENT_CLICKED">;
     revision: z.ZodOptional<z.ZodNumber>;

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

@@ -1 +1 @@
-{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMhC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;kBAM5B,CAAC;AAEZ,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;kBAMnC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;kBAIlC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;EAA8B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC;;;;;;kBAKxC,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gCAAgC;;;;;;kBAQlC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;kBAa5B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;kBAK9B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;kBAMlC,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0B5B,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;kBAOnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,8BAA8B;;;;;;;;;;kBAOhC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;kBAOpC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,qCAAqC;;;;;;kBAQvC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAUhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMhC,CAAC;AAEZ,eAAO,MAAM,yBAAyB,mCAAiC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;kBAK7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,kCAAkC;;;;;;;;;;kBASpC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;kBAM5B,CAAC;AAEZ,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;kBAMnC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;kBAIlC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;EAA8B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC;;;;;;kBAKxC,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAO/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gCAAgC;;;;;;kBAQlC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;uCAenC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;kBAM5B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;kBAK9B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;kBAMlC,CAAC;AAEZ,eAAO,MAAM,qCAAqC;;;;;;;;;;kBASvC,CAAC;AAEZ,eAAO,MAAM,oCAAoC;;;;;;;;kBAUtC,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0B5B,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;kBAOnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,8BAA8B;;;;;;;;;;kBAOhC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;kBAOpC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,qCAAqC;;;;;;kBAQvC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAYhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/preview-protocol.js

@@ -20,6 +20,23 @@ export const PreviewApplyStateMessageSchema = z
     state: BuilderSettingsSchema,
 })
     .strict();
+export const EdgeBlockRenderModeSchema = z.literal('edge-block-engine');
+export const PreviewBlockHtmlPatchSchema = z
+    .object({
+    blockId: z.string().min(1),
+    html: z.string().min(1),
+})
+    .strict();
+export const PreviewApplyBlockHtmlMessageSchema = z
+    .object({
+    type: z.literal('APPLY_BLOCK_HTML'),
+    revision: z.number().int().nonnegative(),
+    pageId: z.string().min(1),
+    sourceRevision: z.string().min(1),
+    renderMode: EdgeBlockRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+})
+    .strict();
 export const PreviewReloadMessageSchema = z
     .object({
     type: z.literal('RELOAD'),
@@ -54,6 +71,7 @@ export const PreviewSetInteractionModeMessageSchema = z
     .strict();
 export const PreviewMessageSchema = z.discriminatedUnion('type', [
     PreviewApplyStateMessageSchema,
+    PreviewApplyBlockHtmlMessageSchema,
     PreviewReloadMessageSchema,
     PreviewSelectElementMessageSchema,
     PreviewRequestReadyMessageSchema,
@@ -68,18 +86,27 @@ export const PreviewBootstrapOkResponseSchema = z
     artifactStale: z.boolean().optional(),
 })
     .strict();
-export const PreviewReadyResponseSchema = z
-    .object({
-    type: z.literal('READY'),
-    revision: z.number().int().nonnegative(),
-    health: z
+export const PreviewReadyHealthSchema = z.discriminatedUnion('protocolVersion', [
+    z
         .object({
         reactMounted: z.literal(true),
         builderRuntimeProvider: z.literal(true),
         protocolVersion: z.literal(2),
     })
-        .strict()
-        .optional(),
+        .strict(),
+    z
+        .object({
+        edgeBlockEngine: z.literal(true),
+        blockHtmlReconcile: z.literal(true),
+        protocolVersion: z.literal(3),
+    })
+        .strict(),
+]);
+export const PreviewReadyResponseSchema = z
+    .object({
+    type: z.literal('READY'),
+    revision: z.number().int().nonnegative(),
+    health: PreviewReadyHealthSchema.optional(),
 })
     .strict();
 export const PreviewAppliedResponseSchema = z
@@ -95,6 +122,27 @@ export const PreviewApplyFailedResponseSchema = z
     error: z.string().min(1),
 })
     .strict();
+export const PreviewBlockHtmlAppliedResponseSchema = z
+    .object({
+    type: z.literal('BLOCK_HTML_APPLIED'),
+    revision: z.number().int().nonnegative(),
+    pageId: z.string().min(1),
+    sourceRevision: z.string().min(1),
+    renderMode: EdgeBlockRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+})
+    .strict();
+export const PreviewBlockHtmlFailedResponseSchema = z
+    .object({
+    type: z.literal('BLOCK_HTML_FAILED'),
+    revision: z.number().int().nonnegative(),
+    pageId: z.string().min(1),
+    sourceRevision: z.string().min(1).optional(),
+    renderMode: EdgeBlockRenderModeSchema,
+    blockIds: z.array(z.string().min(1)).min(1),
+    error: z.string().min(1),
+})
+    .strict();
 export const PreviewElementClickedResponseSchema = z
     .object({
     type: z.literal('ELEMENT_CLICKED'),
@@ -183,6 +231,8 @@ export const PreviewResponseSchema = z.discriminatedUnion('type', [
     PreviewReadyResponseSchema,
     PreviewAppliedResponseSchema,
     PreviewApplyFailedResponseSchema,
+    PreviewBlockHtmlAppliedResponseSchema,
+    PreviewBlockHtmlFailedResponseSchema,
     PreviewElementClickedResponseSchema,
     PreviewErrorResponseSchema,
     PreviewBlockRectResponseSchema,

package/dist/preview-session-resolve.d.ts

@@ -108,8 +108,8 @@ export declare const BuilderPreviewResolveResponseSchema: z.ZodObject<{
         artifactStale: z.ZodOptional<z.ZodBoolean>;
         sourceRevision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
-    error: z.ZodNullable<z.ZodString>;
-}, z.core.$strict>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
 export type BuilderPreviewResolveResponse = z.infer<typeof BuilderPreviewResolveResponseSchema>;
 export declare function parseBuilderPreviewResolveResponse(value: unknown): BuilderPreviewResolveResponse | null;
 //# sourceMappingURL=preview-session-resolve.d.ts.map

package/dist/preview-session-resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-session-resolve.d.ts","sourceRoot":"","sources":["../src/preview-session-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWjC,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AAEZ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,IAAI,CAGtC"}
+{"version":3,"file":"preview-session-resolve.d.ts","sourceRoot":"","sources":["../src/preview-session-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWjC,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,IAAI,CAGtC"}

package/dist/preview-session-resolve.js

@@ -16,9 +16,9 @@ export const BuilderPreviewResolveResponseSchema = z
     .object({
     status: z.number(),
     data: BuilderPreviewResolveDataSchema.nullable(),
-    error: z.string().nullable(),
+    error: z.string().nullable().optional(),
 })
-    .strict();
+    .strip();
 export function parseBuilderPreviewResolveResponse(value) {
     const parsed = BuilderPreviewResolveResponseSchema.safeParse(value);
     return parsed.success ? parsed.data : null;

package/dist/preview-trusted-origins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-trusted-origins.d.ts","sourceRoot":"","sources":["../src/preview-trusted-origins.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,iMAOjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmBpE"}
+{"version":3,"file":"preview-trusted-origins.d.ts","sourceRoot":"","sources":["../src/preview-trusted-origins.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,iMAOjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAuBpE"}

package/dist/preview-trusted-origins.js

@@ -11,14 +11,16 @@ export function isTrustedPreviewParentOrigin(origin) {
         return true;
     }
     try {
-        const hostname = new URL(origin).hostname.toLowerCase();
-        return (hostname === 'dashboard.shoppex.test'
-            || hostname === 'localhost'
-            || hostname === '127.0.0.1'
-            || hostname === '::1'
-            || hostname.endsWith('.localhost')
-            || hostname.endsWith('.vercel.app')
-            || hostname.endsWith('.vercel.run'));
+        const url = new URL(origin);
+        const hostname = url.hostname.toLowerCase();
+        const isHttp = url.protocol === 'http:' || url.protocol === 'https:';
+        return (isHttp
+            && (hostname === 'dashboard.shoppex.test'
+                || hostname === 'localhost'
+                || hostname === '127.0.0.1'
+                || hostname === '::1'
+                || hostname === '[::1]'
+                || hostname.endsWith('.localhost')));
     }
     catch {
         return false;

package/dist/storefront-initial-data-html.js

@@ -44,7 +44,7 @@ export function buildPlainInitialDataScript(initialData) {
 export function buildWrappedStorefrontInitialDataScript(serialized, deployedThemeEntryPathPattern) {
     return [
         '<!--shoppex-initial-data:start--><script>(function(){',
-        'if(typeof window!=="undefined"){var path=window.location.pathname||"";',
+        'if(typeof window!=="undefined"){window.__SHOPPEX_DEPLOYED_THEME_ARTIFACT__=true;var path=window.location.pathname||"";',
         `if(${deployedThemeEntryPathPattern}.test(path)){window.__SHOPPEX_DEPLOYED_THEME_ARTIFACT_PATH__=path;window.history.replaceState(window.history.state,"","/"+window.location.search+window.location.hash);}}`,
         `window.__SHOPPEX_INITIAL__=${serialized};})();</script><!--shoppex-initial-data:end-->`,
     ].join('');