@shoppexio/builder-contracts 0.1.13 → 0.1.15

package/dist/canonical-settings.d.ts

@@ -1,5 +1,7 @@
 import type { BuilderSettings } from './builder-settings.ts';
 import type { ThemeManifest } from './theme-manifest.ts';
+/** Render-time enrichment keys that must never be persisted in builder settings. */
+export declare const NON_PERSISTABLE_BLOCK_SETTING_KEYS: Set<string>;
 export type BuilderSettingsCanonicalizationConflict = {
     pageId: string;
     blockId: string;
@@ -13,6 +15,16 @@ export type BuilderSettingsCanonicalizationResult = {
     removedAliases: number;
     conflicts: BuilderSettingsCanonicalizationConflict[];
 };
+export type BuilderSettingsSanitizationPrunedEntry = {
+    path: string;
+    key: string;
+    reason: 'non_persistable_block_setting' | 'unknown_block_setting' | 'unexposed_style_slot' | 'unknown_style_slot';
+};
+export type BuilderSettingsSanitizationResult = BuilderSettingsCanonicalizationResult & {
+    pruned: BuilderSettingsSanitizationPrunedEntry[];
+};
 export declare function canonicalizeBuilderSettingsForManifest(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettings;
 export declare function canonicalizeBuilderSettingsForManifestWithReport(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettingsCanonicalizationResult;
+export declare function sanitizeBuilderSettingsForManifest(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettings;
+export declare function sanitizeBuilderSettingsForManifestWithReport(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettingsSanitizationResult;
 //# sourceMappingURL=canonical-settings.d.ts.map

package/dist/canonical-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-settings.d.ts","sourceRoot":"","sources":["../src/canonical-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,uCAAuC,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,uCAAuC,EAAE,CAAC;CACtD,CAAC;AAEF,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,eAAe,CAEjB;AAED,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,qCAAqC,CAwBvC"}
+{"version":3,"file":"canonical-settings.d.ts","sourceRoot":"","sources":["../src/canonical-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,oFAAoF;AACpF,eAAO,MAAM,kCAAkC,aAK7C,CAAC;AAEH,MAAM,MAAM,uCAAuC,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,uCAAuC,EAAE,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EACF,+BAA+B,GAC/B,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,qCAAqC,GAAG;IACtF,MAAM,EAAE,sCAAsC,EAAE,CAAC;CAClD,CAAC;AAEF,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,eAAe,CAEjB;AAED,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,qCAAqC,CAwBvC;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,eAAe,CAEjB;AAED,wBAAgB,4CAA4C,CAC1D,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,iCAAiC,CA0BnC"}

package/dist/canonical-settings.js

@@ -1,4 +1,13 @@
+import { mergeCustomPagesIntoManifest } from "./custom-pages.js";
 import { sanitizeBuilderSettingsState } from "./persistence.js";
+import { ThemeStyleSlotIdSchema } from "./style-slots.js";
+/** Render-time enrichment keys that must never be persisted in builder settings. */
+export const NON_PERSISTABLE_BLOCK_SETTING_KEYS = new Set([
+    'titleHasHighlight',
+    'titleBefore',
+    'titleHighlight',
+    'titleAfter',
+]);
 export function canonicalizeBuilderSettingsForManifest(settings, manifest) {
     return canonicalizeBuilderSettingsForManifestWithReport(settings, manifest).settings;
 }
@@ -25,6 +34,99 @@ export function canonicalizeBuilderSettingsForManifestWithReport(settings, manif
         conflicts,
     };
 }
+export function sanitizeBuilderSettingsForManifest(settings, manifest) {
+    return sanitizeBuilderSettingsForManifestWithReport(settings, manifest).settings;
+}
+export function sanitizeBuilderSettingsForManifestWithReport(settings, manifest) {
+    const canonical = canonicalizeBuilderSettingsForManifestWithReport(settings, manifest);
+    const pruned = [];
+    stripNonPersistableBlockSettings(canonical.settings, pruned);
+    const effectiveManifest = mergeCustomPagesIntoManifest(manifest, canonical.settings);
+    pruneUnknownGlobalStyleSlots(canonical.settings, effectiveManifest, pruned);
+    for (const [pageId, layout] of Object.entries(canonical.settings.theme.layout)) {
+        for (const [index, block] of layout.blocks.entries()) {
+            const blockPath = `theme.layout.${pageId}.blocks.${index}`;
+            const blockDefinition = effectiveManifest.blocks[block.type];
+            if (!blockDefinition) {
+                continue;
+            }
+            pruneBlockSettings(block, Object.keys(blockDefinition.settings), blockPath, pruned);
+            pruneBlockStyleOverrides(block, blockDefinition.exposedStyleSlots, blockPath, pruned);
+        }
+    }
+    return {
+        ...canonical,
+        pruned,
+    };
+}
+function stripNonPersistableBlockSettings(settings, pruned) {
+    for (const [pageId, layout] of Object.entries(settings.theme.layout)) {
+        for (const [index, block] of layout.blocks.entries()) {
+            const blockPath = `theme.layout.${pageId}.blocks.${index}`;
+            for (const key of Object.keys(block.settings)) {
+                if (!NON_PERSISTABLE_BLOCK_SETTING_KEYS.has(key)) {
+                    continue;
+                }
+                delete block.settings[key];
+                pruned.push({
+                    path: `${blockPath}.settings.${key}`,
+                    key,
+                    reason: 'non_persistable_block_setting',
+                });
+            }
+        }
+    }
+}
+function pruneUnknownGlobalStyleSlots(settings, manifest, pruned) {
+    const declaredThemeSlots = new Set(Object.keys(manifest.styleSlots));
+    for (const slotId of Object.keys(settings.theme.style_slots)) {
+        if (!ThemeStyleSlotIdSchema.safeParse(slotId).success) {
+            continue;
+        }
+        if (declaredThemeSlots.has(slotId)) {
+            continue;
+        }
+        const styleSlots = settings.theme.style_slots;
+        delete styleSlots[slotId];
+        pruned.push({
+            path: `theme.style_slots.${slotId}`,
+            key: slotId,
+            reason: 'unknown_style_slot',
+        });
+    }
+}
+function pruneBlockSettings(block, settingPaths, blockPath, pruned) {
+    const allowedSettings = new Set(settingPaths);
+    for (const key of Object.keys(block.settings)) {
+        if (allowedSettings.has(key)) {
+            continue;
+        }
+        delete block.settings[key];
+        pruned.push({
+            path: `${blockPath}.settings.${key}`,
+            key,
+            reason: 'unknown_block_setting',
+        });
+    }
+}
+function pruneBlockStyleOverrides(block, exposedStyleSlots, blockPath, pruned) {
+    if (!block.style_overrides) {
+        return;
+    }
+    const exposed = new Set(exposedStyleSlots);
+    const overrides = block.style_overrides;
+    for (const slotId of Object.keys(overrides)) {
+        if (exposed.has(slotId)) {
+            continue;
+        }
+        delete overrides[slotId];
+        pruned.push({
+            path: `${blockPath}.style_overrides.${slotId}`,
+            key: slotId,
+            reason: 'unexposed_style_slot',
+        });
+    }
+}
 function canonicalizeBlockSettings(pageId, block, settingPaths) {
     const aliases = buildAliasMap(block.type, settingPaths);
     const conflicts = [];

package/dist/fields.d.ts

@@ -14,13 +14,13 @@ export declare const ListItemFieldTypeSchema: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
     link: "link";
-    product: "product";
     text: "text";
     richtext: "richtext";
     image: "image";
     range: "range";
     select: "select";
     color: "color";
+    product: "product";
 }>;
 export type ListItemFieldType = z.infer<typeof ListItemFieldTypeSchema>;
 export declare const ListItemFieldSchema: z.ZodObject<{
@@ -38,13 +38,13 @@ export declare const ListItemFieldSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         link: "link";
-        product: "product";
         text: "text";
         richtext: "richtext";
         image: "image";
         range: "range";
         select: "select";
         color: "color";
+        product: "product";
     }>;
     options: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
@@ -266,13 +266,13 @@ export declare const BuilderFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             number: "number";
             boolean: "boolean";
             link: "link";
-            product: "product";
             text: "text";
             richtext: "richtext";
             image: "image";
             range: "range";
             select: "select";
             color: "color";
+            product: "product";
         }>;
         options: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
@@ -495,13 +495,13 @@ export declare const BlockSettingsSchema: z.ZodRecord<z.ZodString, z.ZodDiscrimi
             number: "number";
             boolean: "boolean";
             link: "link";
-            product: "product";
             text: "text";
             richtext: "richtext";
             image: "image";
             range: "range";
             select: "select";
             color: "color";
+            product: "product";
         }>;
         options: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;

package/dist/migrations.d.ts

@@ -27,6 +27,7 @@ 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 buildDefaultBuilderSettingsFromManifest(manifest: ThemeManifest, revision?: number): 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":"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"}
+{"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,uCAAuC,CACrD,QAAQ,EAAE,aAAa,EACvB,QAAQ,SAAI,GACX,eAAe,CAqCjB;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

@@ -69,6 +69,39 @@ export function applyManifestDefaultLayout(settings, manifest) {
     }
     return BuilderSettingsSchema.parse(next);
 }
+export function buildDefaultBuilderSettingsFromManifest(manifest, revision = 1) {
+    const settings = createEmptyBuilderSettings(revision);
+    for (const [pageId, page] of Object.entries(manifest.pages)) {
+        if (page.defaultBlocks.length === 0) {
+            continue;
+        }
+        settings.theme.layout[pageId] = {
+            blocks: page.defaultBlocks.map((defaultBlock, index) => {
+                const blockDefinition = manifest.blocks[defaultBlock.type];
+                const blockSettings = {
+                    ...(defaultBlock.settings ?? {}),
+                };
+                if (blockDefinition) {
+                    for (const [settingPath, field] of Object.entries(blockDefinition.settings)) {
+                        if (Object.prototype.hasOwnProperty.call(blockSettings, settingPath)) {
+                            continue;
+                        }
+                        if (field.defaultValue !== undefined) {
+                            blockSettings[settingPath] = field.defaultValue;
+                        }
+                    }
+                }
+                return createBlockInstance({
+                    id: createDefaultBlockId(pageId, defaultBlock.type, index),
+                    type: defaultBlock.type,
+                    variant: defaultBlock.variant,
+                    settings: blockSettings,
+                });
+            }),
+        };
+    }
+    return BuilderSettingsSchema.parse(settings);
+}
 export function mapLegacyNestedThemeTypographyToStyleSlots(theme, baseSlots = {}) {
     const slots = { ...baseSlots };
     const typography = theme.typography;

package/dist/preview-route.d.ts

@@ -2,5 +2,5 @@
  * Normalizes the storefront route visible inside a theme-preview iframe after the
  * worker strips the `/s/:sessionId/:draftToken` prefix via history.replaceState.
  */
-export declare function readPreviewStorefrontRoutePath(pathname: string, search?: string, hash?: string): string | null;
+export declare function readPreviewStorefrontRoutePath(pathname: string, search?: string, _hash?: string): string | null;
 //# sourceMappingURL=preview-route.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"preview-route.d.ts","sourceRoot":"","sources":["../src/preview-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAK,EACX,IAAI,SAAK,GACR,MAAM,GAAG,IAAI,CAaf"}
+{"version":3,"file":"preview-route.d.ts","sourceRoot":"","sources":["../src/preview-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAK,EACX,KAAK,SAAK,GACT,MAAM,GAAG,IAAI,CAaf"}

package/dist/preview-route.js

@@ -2,7 +2,7 @@
  * Normalizes the storefront route visible inside a theme-preview iframe after the
  * worker strips the `/s/:sessionId/:draftToken` prefix via history.replaceState.
  */
-export function readPreviewStorefrontRoutePath(pathname, search = '', hash = '') {
+export function readPreviewStorefrontRoutePath(pathname, search = '', _hash = '') {
     const path = pathname.trim() || '/';
     if (path.includes('/__shoppex/')) {
         return null;
@@ -12,5 +12,5 @@ export function readPreviewStorefrontRoutePath(pathname, search = '', hash = '')
         return null;
     }
     const normalizedPath = path.replace(/\/+$/, '') || '/';
-    return `${normalizedPath}${search}${hash}`;
+    return `${normalizedPath}${search}`;
 }

package/dist/shop-structured-data.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const ShopStructuredDataOrganizationSchema: z.ZodObject<{
+    legal_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const ShopStructuredDataSettingsSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    organization: z.ZodOptional<z.ZodObject<{
+        legal_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ShopStructuredDataOrganization = z.infer<typeof ShopStructuredDataOrganizationSchema>;
+export type ShopStructuredDataSettings = z.infer<typeof ShopStructuredDataSettingsSchema>;
+export declare const DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS: ShopStructuredDataSettings;
+export declare function normalizeShopStructuredDataSettings(value: unknown): ShopStructuredDataSettings;
+//# sourceMappingURL=shop-structured-data.d.ts.map

package/dist/shop-structured-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop-structured-data.d.ts","sourceRoot":"","sources":["../src/shop-structured-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oCAAoC;;kBAEtC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;kBAGlC,CAAC;AAEZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,qCAAqC,EAAE,0BAGnD,CAAC;AAMF,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAoB9F"}

package/dist/shop-structured-data.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export const ShopStructuredDataOrganizationSchema = z.object({
+    legal_name: z.string().trim().max(120).nullable().optional(),
+}).strict();
+export const ShopStructuredDataSettingsSchema = z.object({
+    enabled: z.boolean(),
+    organization: ShopStructuredDataOrganizationSchema.optional(),
+}).strict();
+export const DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS = {
+    enabled: true,
+    organization: {},
+};
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function normalizeShopStructuredDataSettings(value) {
+    if (!isRecord(value)) {
+        return { ...DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS, organization: {} };
+    }
+    const enabled = typeof value.enabled === 'boolean' ? value.enabled : DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS.enabled;
+    const organizationRaw = isRecord(value.organization) ? value.organization : {};
+    const legalName = organizationRaw.legal_name;
+    const organization = {
+        ...(typeof legalName === 'string' && legalName.trim().length > 0
+            ? { legal_name: legalName.trim() }
+            : legalName === null
+                ? { legal_name: null }
+                : {}),
+    };
+    return {
+        enabled,
+        organization,
+    };
+}

package/dist/storefront-render-frame-origins.d.ts

@@ -3,9 +3,15 @@
  * and for custom-embed postMessage trust in storefront-commerce (when registered).
  */
 export declare const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS: readonly ["https://www.youtube.com", "https://www.youtube-nocookie.com"];
+/**
+ * Streamable embed iframe origins. The embed document is served from
+ * `https://streamable.com/e/<shortcode>`; the wildcard covers player/CDN
+ * subdomains Streamable may serve the iframe document from.
+ */
+export declare const STOREFRONT_RENDER_STREAMABLE_FRAME_ORIGINS: readonly ["https://streamable.com", "https://*.streamable.com"];
 /** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
 export declare const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS: readonly ["https://calendly.com", "https://substack.com", "https://shoppex.io"];
 /** frame-src entries for custom embed blocks (includes Substack wildcard). */
 export declare const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS: readonly ["https://calendly.com", "https://substack.com", "https://shoppex.io", "https://*.substack.com"];
-export declare const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS: readonly ["https://www.youtube.com", "https://www.youtube-nocookie.com", "https://calendly.com", "https://substack.com", "https://shoppex.io", "https://*.substack.com"];
+export declare const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS: readonly ["https://www.youtube.com", "https://www.youtube-nocookie.com", "https://streamable.com", "https://*.streamable.com", "https://calendly.com", "https://substack.com", "https://shoppex.io", "https://*.substack.com"];
 //# sourceMappingURL=storefront-render-frame-origins.d.ts.map

package/dist/storefront-render-frame-origins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-render-frame-origins.d.ts","sourceRoot":"","sources":["../src/storefront-render-frame-origins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uCAAuC,0EAG1C,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,8CAA8C,iFAIjD,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,gDAAgD,2GAGnD,CAAC;AAEX,eAAO,MAAM,uCAAuC,0KAG1C,CAAC"}
+{"version":3,"file":"storefront-render-frame-origins.d.ts","sourceRoot":"","sources":["../src/storefront-render-frame-origins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uCAAuC,0EAG1C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,0CAA0C,iEAG7C,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,8CAA8C,iFAIjD,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,gDAAgD,2GAGnD,CAAC;AAEX,eAAO,MAAM,uCAAuC,gOAI1C,CAAC"}

package/dist/storefront-render-frame-origins.js

@@ -6,6 +6,15 @@ export const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS = [
     'https://www.youtube.com',
     'https://www.youtube-nocookie.com',
 ];
+/**
+ * Streamable embed iframe origins. The embed document is served from
+ * `https://streamable.com/e/<shortcode>`; the wildcard covers player/CDN
+ * subdomains Streamable may serve the iframe document from.
+ */
+export const STOREFRONT_RENDER_STREAMABLE_FRAME_ORIGINS = [
+    'https://streamable.com',
+    'https://*.streamable.com',
+];
 /** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
 export const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS = [
     'https://calendly.com',
@@ -19,5 +28,6 @@ export const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS = [
 ];
 export const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS = [
     ...STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS,
+    ...STOREFRONT_RENDER_STREAMABLE_FRAME_ORIGINS,
     ...STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS,
 ];

package/dist/storefront-render-structured-data.d.ts

@@ -0,0 +1,9 @@
+export declare const STOREFRONT_RENDER_STRUCTURED_DATA_HEADER = "X-Shoppex-Storefront-Structured-Data";
+export interface StorefrontRenderStructuredData {
+    jsonLd: string | null;
+    shopSlug: string;
+}
+export declare function normalizeStorefrontRenderStructuredData(value: unknown): StorefrontRenderStructuredData | null;
+export declare function encodeStorefrontRenderStructuredDataHeader(metadata: StorefrontRenderStructuredData): string;
+export declare function decodeStorefrontRenderStructuredDataHeader(value: string | null): StorefrontRenderStructuredData;
+//# sourceMappingURL=storefront-render-structured-data.d.ts.map

package/dist/storefront-render-structured-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-render-structured-data.d.ts","sourceRoot":"","sources":["../src/storefront-render-structured-data.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wCAAwC,yCAAyC,CAAC;AAE/F,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,GAAG,IAAI,CAc7G;AAED,wBAAgB,0CAA0C,CAAC,QAAQ,EAAE,8BAA8B,GAAG,MAAM,CAE3G;AAED,wBAAgB,0CAA0C,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,8BAA8B,CAW/G"}

package/dist/storefront-render-structured-data.js

@@ -0,0 +1,30 @@
+export const STOREFRONT_RENDER_STRUCTURED_DATA_HEADER = 'X-Shoppex-Storefront-Structured-Data';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function normalizeStorefrontRenderStructuredData(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const { jsonLd, shopSlug } = value;
+    if (jsonLd !== null && typeof jsonLd !== 'string') {
+        return null;
+    }
+    if (typeof shopSlug !== 'string' || shopSlug.trim().length === 0) {
+        return null;
+    }
+    return { jsonLd, shopSlug: shopSlug.trim() };
+}
+export function encodeStorefrontRenderStructuredDataHeader(metadata) {
+    return encodeURIComponent(JSON.stringify(metadata));
+}
+export function decodeStorefrontRenderStructuredDataHeader(value) {
+    if (value === null) {
+        throw new Error(`${STOREFRONT_RENDER_STRUCTURED_DATA_HEADER} is required.`);
+    }
+    const metadata = normalizeStorefrontRenderStructuredData(JSON.parse(decodeURIComponent(value)));
+    if (!metadata) {
+        throw new Error(`${STOREFRONT_RENDER_STRUCTURED_DATA_HEADER} is invalid.`);
+    }
+    return metadata;
+}

package/dist/theme-manifest.d.ts

@@ -253,13 +253,13 @@ export declare const ManifestBlockSchema: z.ZodObject<{
                 number: "number";
                 boolean: "boolean";
                 link: "link";
-                product: "product";
                 text: "text";
                 richtext: "richtext";
                 image: "image";
                 range: "range";
                 select: "select";
                 color: "color";
+                product: "product";
             }>;
             options: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 label: z.ZodString;
@@ -587,13 +587,13 @@ export declare const ThemeManifestSchema: z.ZodObject<{
                     number: "number";
                     boolean: "boolean";
                     link: "link";
-                    product: "product";
                     text: "text";
                     richtext: "richtext";
                     image: "image";
                     range: "range";
                     select: "select";
                     color: "color";
+                    product: "product";
                 }>;
                 options: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     label: z.ZodString;

package/dist/theme-schemes.d.ts

@@ -3,7 +3,7 @@ export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[num
 export declare const STARTER_BUILDER_THEME_SCHEMES: readonly ["blank"];
 export declare const THEME_STORE_DISABLED_SCHEMES: readonly [];
 export declare const THEME_STORE_INSTALLABLE_SCHEMES: readonly ["default", "starlight", "pulse", "vault", "clean-minimal", "classic", "phantom", "nebula", "apex", "shadow"];
-export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal", "shadow"];
 export type ThemeStoreInstallableScheme = (typeof THEME_STORE_INSTALLABLE_SCHEMES)[number];
 export type StarterBuilderThemeScheme = (typeof STARTER_BUILDER_THEME_SCHEMES)[number];
 export type BuilderReadyThemeScheme = (typeof BUILDER_READY_THEME_SCHEMES)[number];

package/dist/theme-schemes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-schemes.d.ts","sourceRoot":"","sources":["../src/theme-schemes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wHAW/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,4BAA4B,aAA4D,CAAC;AAItG,eAAO,MAAM,+BAA+B,wHAWY,CAAC;AAEzD,eAAO,MAAM,2BAA2B,uHAW9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3F,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,2BAA2B,CAEtC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF"}
+{"version":3,"file":"theme-schemes.d.ts","sourceRoot":"","sources":["../src/theme-schemes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wHAW/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,4BAA4B,aAA4D,CAAC;AAItG,eAAO,MAAM,+BAA+B,wHAWY,CAAC;AAEzD,eAAO,MAAM,2BAA2B,iIAY9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3F,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,2BAA2B,CAEtC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF"}

package/dist/theme-schemes.js

@@ -36,6 +36,7 @@ export const BUILDER_READY_THEME_SCHEMES = [
     'apex',
     'vault',
     'clean-minimal',
+    'shadow',
 ];
 export function isPublicBuilderThemeScheme(value) {
     return PUBLIC_BUILDER_THEME_SCHEMES.includes(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-contracts",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Shared Builder v2 contracts for Shoppex dashboard, backend, preview runtime, and themes",
   "type": "module",
   "repository": {
@@ -55,6 +55,18 @@
       "import": "./dist/storefront-render-seo.js",
       "default": "./dist/storefront-render-seo.js"
     },
+    "./shop-structured-data": {
+      "bun": "./src/shop-structured-data.ts",
+      "types": "./dist/shop-structured-data.d.ts",
+      "import": "./dist/shop-structured-data.js",
+      "default": "./dist/shop-structured-data.js"
+    },
+    "./storefront-render-structured-data": {
+      "bun": "./src/storefront-render-structured-data.ts",
+      "types": "./dist/storefront-render-structured-data.d.ts",
+      "import": "./dist/storefront-render-structured-data.js",
+      "default": "./dist/storefront-render-structured-data.js"
+    },
     "./events": {
       "bun": "./src/events.ts",
       "types": "./dist/events.d.ts",

package/src/builder-contracts.test.ts

@@ -17,6 +17,7 @@ import {
   exportCoercedBuilderSettingsBlob,
   extractPersistedBuilderSettings,
   canonicalizeBuilderSettingsForManifestWithReport,
+  sanitizeBuilderSettingsForManifestWithReport,
   mergeBuilderSettingsIntoThemeSettings,
   migrateLegacyBuilderSettings,
   listThemeManifestPresets,
@@ -849,6 +850,80 @@ describe('@shoppex/builder-contracts', () => {
     expect(validateBuilderSettingsAgainstManifest(result.settings, manifest)).toEqual([]);
   });
 
+  test('sanitizeBuilderSettingsForManifest prunes unknown block settings and non-persistable enrichment keys', () => {
+    const settings = BuilderSettingsSchema.parse({
+      version: 2,
+      revision: 1,
+      theme: {
+        content: {},
+        layout: {
+          home: {
+            blocks: [
+              {
+                id: 'home-hero-1',
+                type: 'hero',
+                visible: true,
+                settings: {
+                  'hero.title': 'Launch sale',
+                  'style.accentColor': '#ff0000',
+                  titleBefore: 'ignored',
+                },
+              },
+            ],
+          },
+        },
+        style_slots: {},
+        pages: [],
+        terms: {},
+      },
+    });
+
+    const manifest = {
+      id: 'pulse',
+      name: 'Pulse',
+      version: '1.0.0',
+      pages: {
+        home: {
+          label: 'Home',
+          allowedBlocks: ['hero'],
+          defaultBlocks: [{ type: 'hero' }],
+        },
+      },
+      blocks: {
+        hero: {
+          label: 'Hero',
+          settings: {
+            'hero.title': { type: 'text', label: 'Title' },
+          },
+          variants: [],
+          exposedStyleSlots: [],
+          presets: [],
+        },
+      },
+      styleSlots: {},
+      presets: {},
+    };
+
+    const result = sanitizeBuilderSettingsForManifestWithReport(settings, manifest);
+
+    expect(result.pruned).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          key: 'style.accentColor',
+          reason: 'unknown_block_setting',
+        }),
+        expect.objectContaining({
+          key: 'titleBefore',
+          reason: 'non_persistable_block_setting',
+        }),
+      ]),
+    );
+    expect(result.settings.theme.layout.home.blocks[0].settings).toEqual({
+      'hero.title': 'Launch sale',
+    });
+    expect(validateBuilderSettingsAgainstManifest(result.settings, manifest)).toEqual([]);
+  });
+
   test('accepts transparent color literals used by theme manifests', () => {
     expect(ColorSchema.parse('transparent')).toBe('transparent');
     expect(ColorSchema.parse('#ffffff')).toBe('#ffffff');

package/src/canonical-settings.ts

@@ -1,7 +1,17 @@
 import type { BlockInstance, BuilderSettings } from './builder-settings.ts';
+import { mergeCustomPagesIntoManifest } from './custom-pages.ts';
 import { sanitizeBuilderSettingsState } from './persistence.ts';
+import { ThemeStyleSlotIdSchema } from './style-slots.ts';
 import type { ThemeManifest } from './theme-manifest.ts';
 
+/** Render-time enrichment keys that must never be persisted in builder settings. */
+export const NON_PERSISTABLE_BLOCK_SETTING_KEYS = new Set([
+  'titleHasHighlight',
+  'titleBefore',
+  'titleHighlight',
+  'titleAfter',
+]);
+
 export type BuilderSettingsCanonicalizationConflict = {
   pageId: string;
   blockId: string;
@@ -17,6 +27,20 @@ export type BuilderSettingsCanonicalizationResult = {
   conflicts: BuilderSettingsCanonicalizationConflict[];
 };
 
+export type BuilderSettingsSanitizationPrunedEntry = {
+  path: string;
+  key: string;
+  reason:
+    | 'non_persistable_block_setting'
+    | 'unknown_block_setting'
+    | 'unexposed_style_slot'
+    | 'unknown_style_slot';
+};
+
+export type BuilderSettingsSanitizationResult = BuilderSettingsCanonicalizationResult & {
+  pruned: BuilderSettingsSanitizationPrunedEntry[];
+};
+
 export function canonicalizeBuilderSettingsForManifest(
   settings: BuilderSettings,
   manifest: ThemeManifest,
@@ -53,6 +77,142 @@ export function canonicalizeBuilderSettingsForManifestWithReport(
   };
 }
 
+export function sanitizeBuilderSettingsForManifest(
+  settings: BuilderSettings,
+  manifest: ThemeManifest,
+): BuilderSettings {
+  return sanitizeBuilderSettingsForManifestWithReport(settings, manifest).settings;
+}
+
+export function sanitizeBuilderSettingsForManifestWithReport(
+  settings: BuilderSettings,
+  manifest: ThemeManifest,
+): BuilderSettingsSanitizationResult {
+  const canonical = canonicalizeBuilderSettingsForManifestWithReport(settings, manifest);
+  const pruned: BuilderSettingsSanitizationPrunedEntry[] = [];
+
+  stripNonPersistableBlockSettings(canonical.settings, pruned);
+
+  const effectiveManifest = mergeCustomPagesIntoManifest(manifest, canonical.settings);
+  pruneUnknownGlobalStyleSlots(canonical.settings, effectiveManifest, pruned);
+
+  for (const [pageId, layout] of Object.entries(canonical.settings.theme.layout)) {
+    for (const [index, block] of layout.blocks.entries()) {
+      const blockPath = `theme.layout.${pageId}.blocks.${index}`;
+      const blockDefinition = effectiveManifest.blocks[block.type];
+      if (!blockDefinition) {
+        continue;
+      }
+
+      pruneBlockSettings(block, Object.keys(blockDefinition.settings), blockPath, pruned);
+      pruneBlockStyleOverrides(block, blockDefinition.exposedStyleSlots, blockPath, pruned);
+    }
+  }
+
+  return {
+    ...canonical,
+    pruned,
+  };
+}
+
+function stripNonPersistableBlockSettings(
+  settings: BuilderSettings,
+  pruned: BuilderSettingsSanitizationPrunedEntry[],
+): void {
+  for (const [pageId, layout] of Object.entries(settings.theme.layout)) {
+    for (const [index, block] of layout.blocks.entries()) {
+      const blockPath = `theme.layout.${pageId}.blocks.${index}`;
+
+      for (const key of Object.keys(block.settings)) {
+        if (!NON_PERSISTABLE_BLOCK_SETTING_KEYS.has(key)) {
+          continue;
+        }
+
+        delete block.settings[key];
+        pruned.push({
+          path: `${blockPath}.settings.${key}`,
+          key,
+          reason: 'non_persistable_block_setting',
+        });
+      }
+    }
+  }
+}
+
+function pruneUnknownGlobalStyleSlots(
+  settings: BuilderSettings,
+  manifest: ThemeManifest,
+  pruned: BuilderSettingsSanitizationPrunedEntry[],
+): void {
+  const declaredThemeSlots = new Set(Object.keys(manifest.styleSlots));
+
+  for (const slotId of Object.keys(settings.theme.style_slots)) {
+    if (!ThemeStyleSlotIdSchema.safeParse(slotId).success) {
+      continue;
+    }
+
+    if (declaredThemeSlots.has(slotId)) {
+      continue;
+    }
+
+    const styleSlots = settings.theme.style_slots as Record<string, unknown>;
+    delete styleSlots[slotId];
+    pruned.push({
+      path: `theme.style_slots.${slotId}`,
+      key: slotId,
+      reason: 'unknown_style_slot',
+    });
+  }
+}
+
+function pruneBlockSettings(
+  block: BlockInstance,
+  settingPaths: string[],
+  blockPath: string,
+  pruned: BuilderSettingsSanitizationPrunedEntry[],
+): void {
+  const allowedSettings = new Set(settingPaths);
+
+  for (const key of Object.keys(block.settings)) {
+    if (allowedSettings.has(key)) {
+      continue;
+    }
+
+    delete block.settings[key];
+    pruned.push({
+      path: `${blockPath}.settings.${key}`,
+      key,
+      reason: 'unknown_block_setting',
+    });
+  }
+}
+
+function pruneBlockStyleOverrides(
+  block: BlockInstance,
+  exposedStyleSlots: string[],
+  blockPath: string,
+  pruned: BuilderSettingsSanitizationPrunedEntry[],
+): void {
+  if (!block.style_overrides) {
+    return;
+  }
+
+  const exposed = new Set(exposedStyleSlots);
+  const overrides = block.style_overrides as Record<string, unknown>;
+  for (const slotId of Object.keys(overrides)) {
+    if (exposed.has(slotId)) {
+      continue;
+    }
+
+    delete overrides[slotId];
+    pruned.push({
+      path: `${blockPath}.style_overrides.${slotId}`,
+      key: slotId,
+      reason: 'unexposed_style_slot',
+    });
+  }
+}
+
 function canonicalizeBlockSettings(
   pageId: string,
   block: BlockInstance,

package/src/migrations.ts

@@ -110,6 +110,48 @@ export function applyManifestDefaultLayout(settings: BuilderSettings, manifest:
   return BuilderSettingsSchema.parse(next);
 }
 
+export function buildDefaultBuilderSettingsFromManifest(
+  manifest: ThemeManifest,
+  revision = 1,
+): BuilderSettings {
+  const settings = createEmptyBuilderSettings(revision);
+
+  for (const [pageId, page] of Object.entries(manifest.pages)) {
+    if (page.defaultBlocks.length === 0) {
+      continue;
+    }
+
+    settings.theme.layout[pageId] = {
+      blocks: page.defaultBlocks.map((defaultBlock, index) => {
+        const blockDefinition = manifest.blocks[defaultBlock.type];
+        const blockSettings: Record<string, unknown> = {
+          ...(defaultBlock.settings ?? {}),
+        };
+
+        if (blockDefinition) {
+          for (const [settingPath, field] of Object.entries(blockDefinition.settings)) {
+            if (Object.prototype.hasOwnProperty.call(blockSettings, settingPath)) {
+              continue;
+            }
+            if (field.defaultValue !== undefined) {
+              blockSettings[settingPath] = field.defaultValue;
+            }
+          }
+        }
+
+        return createBlockInstance({
+          id: createDefaultBlockId(pageId, defaultBlock.type, index),
+          type: defaultBlock.type,
+          variant: defaultBlock.variant,
+          settings: blockSettings,
+        });
+      }),
+    };
+  }
+
+  return BuilderSettingsSchema.parse(settings);
+}
+
 export function mapLegacyNestedThemeTypographyToStyleSlots(
   theme: Record<string, unknown>,
   baseSlots: StyleSlots = {},

package/src/preview-route.test.ts

@@ -7,6 +7,11 @@ describe('readPreviewStorefrontRoutePath', () => {
       .toBe('/products?category=fivem&sort=price-asc');
   });
 
+  test('omits hash fragments from storefront routes', () => {
+    expect(readPreviewStorefrontRoutePath('/products', '?category=fivem', '#faq'))
+      .toBe('/products?category=fivem');
+  });
+
   test('normalizes trailing slashes on non-root paths', () => {
     expect(readPreviewStorefrontRoutePath('/products/', '?page=2')).toBe('/products?page=2');
   });

package/src/preview-route.ts

@@ -5,7 +5,7 @@
 export function readPreviewStorefrontRoutePath(
   pathname: string,
   search = '',
-  hash = '',
+  _hash = '',
 ): string | null {
   const path = pathname.trim() || '/';
   if (path.includes('/__shoppex/')) {
@@ -18,5 +18,5 @@ export function readPreviewStorefrontRoutePath(
   }
 
   const normalizedPath = path.replace(/\/+$/, '') || '/';
-  return `${normalizedPath}${search}${hash}`;
+  return `${normalizedPath}${search}`;
 }

package/src/shop-structured-data.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+
+export const ShopStructuredDataOrganizationSchema = z.object({
+  legal_name: z.string().trim().max(120).nullable().optional(),
+}).strict();
+
+export const ShopStructuredDataSettingsSchema = z.object({
+  enabled: z.boolean(),
+  organization: ShopStructuredDataOrganizationSchema.optional(),
+}).strict();
+
+export type ShopStructuredDataOrganization = z.infer<typeof ShopStructuredDataOrganizationSchema>;
+export type ShopStructuredDataSettings = z.infer<typeof ShopStructuredDataSettingsSchema>;
+
+export const DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS: ShopStructuredDataSettings = {
+  enabled: true,
+  organization: {},
+};
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function normalizeShopStructuredDataSettings(value: unknown): ShopStructuredDataSettings {
+  if (!isRecord(value)) {
+    return { ...DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS, organization: {} };
+  }
+
+  const enabled = typeof value.enabled === 'boolean' ? value.enabled : DEFAULT_SHOP_STRUCTURED_DATA_SETTINGS.enabled;
+  const organizationRaw = isRecord(value.organization) ? value.organization : {};
+  const legalName = organizationRaw.legal_name;
+  const organization = {
+    ...(typeof legalName === 'string' && legalName.trim().length > 0
+      ? { legal_name: legalName.trim() }
+      : legalName === null
+        ? { legal_name: null }
+        : {}),
+  };
+
+  return {
+    enabled,
+    organization,
+  };
+}

package/src/storefront-render-frame-origins.ts

@@ -7,6 +7,16 @@ export const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS = [
   'https://www.youtube-nocookie.com',
 ] as const;
 
+/**
+ * Streamable embed iframe origins. The embed document is served from
+ * `https://streamable.com/e/<shortcode>`; the wildcard covers player/CDN
+ * subdomains Streamable may serve the iframe document from.
+ */
+export const STOREFRONT_RENDER_STREAMABLE_FRAME_ORIGINS = [
+  'https://streamable.com',
+  'https://*.streamable.com',
+] as const;
+
 /** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
 export const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS = [
   'https://calendly.com',
@@ -22,5 +32,6 @@ export const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS = [
 
 export const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS = [
   ...STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS,
+  ...STOREFRONT_RENDER_STREAMABLE_FRAME_ORIGINS,
   ...STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS,
 ] as const;

package/src/storefront-render-structured-data.ts

@@ -0,0 +1,43 @@
+export const STOREFRONT_RENDER_STRUCTURED_DATA_HEADER = 'X-Shoppex-Storefront-Structured-Data';
+
+export interface StorefrontRenderStructuredData {
+  jsonLd: string | null;
+  shopSlug: string;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function normalizeStorefrontRenderStructuredData(value: unknown): StorefrontRenderStructuredData | null {
+  if (!isRecord(value)) {
+    return null;
+  }
+
+  const { jsonLd, shopSlug } = value;
+  if (jsonLd !== null && typeof jsonLd !== 'string') {
+    return null;
+  }
+  if (typeof shopSlug !== 'string' || shopSlug.trim().length === 0) {
+    return null;
+  }
+
+  return { jsonLd, shopSlug: shopSlug.trim() };
+}
+
+export function encodeStorefrontRenderStructuredDataHeader(metadata: StorefrontRenderStructuredData): string {
+  return encodeURIComponent(JSON.stringify(metadata));
+}
+
+export function decodeStorefrontRenderStructuredDataHeader(value: string | null): StorefrontRenderStructuredData {
+  if (value === null) {
+    throw new Error(`${STOREFRONT_RENDER_STRUCTURED_DATA_HEADER} is required.`);
+  }
+
+  const metadata = normalizeStorefrontRenderStructuredData(JSON.parse(decodeURIComponent(value)) as unknown);
+  if (!metadata) {
+    throw new Error(`${STOREFRONT_RENDER_STRUCTURED_DATA_HEADER} is invalid.`);
+  }
+
+  return metadata;
+}

package/src/theme-schemes.ts

@@ -43,6 +43,7 @@ export const BUILDER_READY_THEME_SCHEMES = [
   'apex',
   'vault',
   'clean-minimal',
+  'shadow',
 ] as const;
 
 export type ThemeStoreInstallableScheme = (typeof THEME_STORE_INSTALLABLE_SCHEMES)[number];