storefront-layouts-staging 1.0.0-staging.0

package/dist/lib/guest-user.js

@@ -0,0 +1,71 @@
+/**
+ * Guest User Information Management
+ * Stores and retrieves guest user data from localStorage
+ */
+const GUEST_USER_STORAGE_KEY = 'guest_user_info';
+/**
+ * Get guest user information from localStorage
+ */
+export function getGuestUserInfo() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        const stored = localStorage.getItem(GUEST_USER_STORAGE_KEY);
+        if (!stored) {
+            return null;
+        }
+        const parsed = JSON.parse(stored);
+        // Validate that all required fields are present
+        if (parsed.firstName &&
+            parsed.lastName &&
+            parsed.phone &&
+            parsed.email) {
+            return parsed;
+        }
+        return null;
+    }
+    catch (error) {
+        console.error('Error reading guest user info:', error);
+        return null;
+    }
+}
+/**
+ * Save guest user information to localStorage
+ */
+export function saveGuestUserInfo(info) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        localStorage.setItem(GUEST_USER_STORAGE_KEY, JSON.stringify(info));
+    }
+    catch (error) {
+        console.error('Error saving guest user info:', error);
+    }
+}
+/**
+ * Clear guest user information from localStorage
+ */
+export function clearGuestUserInfo() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        localStorage.removeItem(GUEST_USER_STORAGE_KEY);
+    }
+    catch (error) {
+        console.error('Error clearing guest user info:', error);
+    }
+}
+/**
+ * Check if guest user info is complete
+ */
+export function hasCompleteGuestInfo() {
+    const info = getGuestUserInfo();
+    return info !== null &&
+        !!info.firstName &&
+        !!info.lastName &&
+        !!info.phone &&
+        !!info.email;
+}

package/dist/lib/inventory-utils.d.ts

@@ -0,0 +1,41 @@
+import type { StoreProduct } from './store-types';
+export type ProductStockStatus = 'untracked' | 'in_stock' | 'low_stock' | 'out_of_stock';
+export interface ProductStockInfo {
+    status: ProductStockStatus;
+    availableStock?: number;
+    lowStockThreshold?: number;
+    canPurchase: boolean;
+    label: string;
+}
+export interface CartLineStockInfo {
+    /** Max quantity allowed for this cart line (cart-aware availableStock from API). */
+    maxLineQuantity: number | undefined;
+    /** How many more units can be added beyond the current line quantity. */
+    remainingToAdd: number | undefined;
+    canIncrease: boolean;
+    canDecrease: boolean;
+    isAtMaxQuantity: boolean;
+    stockError: string | null;
+    /** Optional badge copy for the cart row (never uses cart qty as "left in stock"). */
+    displayLabel: string | null;
+}
+/**
+ * Stock display for catalog / product detail pages.
+ * Do not use for cart line products — use getCartLineStockInfo instead.
+ */
+export declare function getProductStockInfo(product: Pick<StoreProduct, 'trackInventory' | 'availableStock' | 'inStock' | 'lowStockThreshold' | 'name'>): ProductStockInfo;
+/**
+ * Cart API enriches line products with availableStock = trueRemaining + cartLineQty.
+ * Use this helper anywhere cart quantity controls or badges are rendered.
+ */
+export declare function getCartLineStockInfo(product: Pick<StoreProduct, 'name' | 'trackInventory' | 'availableStock' | 'inStock' | 'lowStockThreshold'>, cartLineQty: number): CartLineStockInfo;
+/** Max quantity for a cart line when product.availableStock is cart-aware. */
+export declare function getMaxCartLineQuantity(product: Pick<StoreProduct, 'name' | 'trackInventory' | 'availableStock' | 'inStock'>, cartLineQty: number): number | undefined;
+export declare function getMaxPurchasableQuantity(product: StoreProduct, currentCartQty?: number): number | undefined;
+export declare function formatStockLimitMessage(productName: string, available: number, requested?: number): string;
+/**
+ * Validates checkout line quantity against catalog availableStock (advisory cart).
+ */
+export declare function formatCheckoutStockError(product: Pick<StoreProduct, 'name' | 'availableStock' | 'trackInventory' | 'inStock'>, quantity: number): string | null;
+export declare function isInventoryHoldExpired(holdUntil: string | Date | null | undefined): boolean;
+//# sourceMappingURL=inventory-utils.d.ts.map

package/dist/lib/inventory-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-utils.d.ts","sourceRoot":"","sources":["../../src/lib/inventory-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;AAEzF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yEAAyE;IACzE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qFAAqF;IACrF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,GAAG,mBAAmB,GAAG,MAAM,CAAC,GAC1G,gBAAgB,CAoDlB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,GAAG,mBAAmB,CAAC,EAC3G,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAuFnB;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC,EACrF,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,SAAI,GAAG,MAAM,GAAG,SAAS,CAKvG;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1G;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC,EACrF,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAK3F"}

package/dist/lib/inventory-utils.js

@@ -0,0 +1,180 @@
+function resolveAvailableStock(product) {
+    if (product.trackInventory === false)
+        return undefined;
+    if (typeof product.availableStock === 'number' && Number.isFinite(product.availableStock)) {
+        return Math.max(0, product.availableStock);
+    }
+    return product.inStock ? undefined : 0;
+}
+/**
+ * Stock display for catalog / product detail pages.
+ * Do not use for cart line products — use getCartLineStockInfo instead.
+ */
+export function getProductStockInfo(product) {
+    if (product.trackInventory === false) {
+        return {
+            status: 'untracked',
+            canPurchase: true,
+            label: 'In Stock',
+        };
+    }
+    const availableStock = resolveAvailableStock(product);
+    const lowStockThreshold = typeof product.lowStockThreshold === 'number' && product.lowStockThreshold > 0
+        ? product.lowStockThreshold
+        : undefined;
+    if (availableStock == null) {
+        return {
+            status: product.inStock ? 'in_stock' : 'out_of_stock',
+            availableStock,
+            lowStockThreshold,
+            canPurchase: product.inStock,
+            label: product.inStock ? 'In Stock' : 'Out of Stock',
+        };
+    }
+    if (availableStock <= 0) {
+        return {
+            status: 'out_of_stock',
+            availableStock: 0,
+            lowStockThreshold,
+            canPurchase: false,
+            label: 'Out of Stock',
+        };
+    }
+    if (lowStockThreshold != null && availableStock <= lowStockThreshold) {
+        return {
+            status: 'low_stock',
+            availableStock,
+            lowStockThreshold,
+            canPurchase: true,
+            label: `Low Stock — only ${availableStock} left`,
+        };
+    }
+    return {
+        status: 'in_stock',
+        availableStock,
+        lowStockThreshold,
+        canPurchase: true,
+        label: 'In Stock',
+    };
+}
+/**
+ * Cart API enriches line products with availableStock = trueRemaining + cartLineQty.
+ * Use this helper anywhere cart quantity controls or badges are rendered.
+ */
+export function getCartLineStockInfo(product, cartLineQty) {
+    if (product.trackInventory === false) {
+        const safeCartQty = Math.max(0, Math.floor(cartLineQty));
+        return {
+            maxLineQuantity: undefined,
+            remainingToAdd: undefined,
+            canIncrease: true,
+            canDecrease: safeCartQty > 1,
+            isAtMaxQuantity: false,
+            stockError: null,
+            displayLabel: null,
+        };
+    }
+    const maxLineQuantity = resolveAvailableStock(product);
+    const safeCartQty = Math.max(0, Math.floor(cartLineQty));
+    if (maxLineQuantity == null) {
+        return {
+            maxLineQuantity: undefined,
+            remainingToAdd: undefined,
+            canIncrease: product.inStock,
+            canDecrease: safeCartQty > 1,
+            isAtMaxQuantity: false,
+            stockError: product.inStock ? null : formatStockLimitMessage(product.name, 0),
+            displayLabel: product.inStock ? null : 'Out of Stock',
+        };
+    }
+    if (maxLineQuantity <= 0) {
+        if (safeCartQty > 0) {
+            return {
+                maxLineQuantity: Math.max(safeCartQty, maxLineQuantity),
+                remainingToAdd: 0,
+                canIncrease: false,
+                canDecrease: safeCartQty > 1,
+                isAtMaxQuantity: true,
+                stockError: null,
+                displayLabel: 'Maximum quantity in cart',
+            };
+        }
+        return {
+            maxLineQuantity: 0,
+            remainingToAdd: 0,
+            canIncrease: false,
+            canDecrease: false,
+            isAtMaxQuantity: false,
+            stockError: formatStockLimitMessage(product.name, 0),
+            displayLabel: 'Out of Stock',
+        };
+    }
+    const remainingToAdd = Math.max(0, maxLineQuantity - safeCartQty);
+    const isAtMaxQuantity = remainingToAdd === 0 && safeCartQty > 0;
+    const stockError = safeCartQty > maxLineQuantity
+        ? formatStockLimitMessage(product.name, maxLineQuantity, safeCartQty)
+        : null;
+    const lowStockThreshold = typeof product.lowStockThreshold === 'number' && product.lowStockThreshold > 0
+        ? product.lowStockThreshold
+        : undefined;
+    let displayLabel = null;
+    if (stockError) {
+        displayLabel = stockError;
+    }
+    else if (remainingToAdd === 0 && safeCartQty > 0) {
+        displayLabel = 'Maximum quantity in cart';
+    }
+    else if (lowStockThreshold != null && maxLineQuantity <= lowStockThreshold) {
+        displayLabel =
+            remainingToAdd > 0
+                ? `Low Stock — ${remainingToAdd} more available`
+                : `Low Stock — only ${maxLineQuantity} available`;
+    }
+    else if (remainingToAdd > 0 && remainingToAdd <= 5) {
+        displayLabel = `${remainingToAdd} more available`;
+    }
+    return {
+        maxLineQuantity,
+        remainingToAdd,
+        canIncrease: remainingToAdd > 0,
+        canDecrease: safeCartQty > 1,
+        isAtMaxQuantity,
+        stockError,
+        displayLabel,
+    };
+}
+/** Max quantity for a cart line when product.availableStock is cart-aware. */
+export function getMaxCartLineQuantity(product, cartLineQty) {
+    return getCartLineStockInfo(product, cartLineQty).maxLineQuantity;
+}
+export function getMaxPurchasableQuantity(product, currentCartQty = 0) {
+    const stock = getProductStockInfo(product);
+    if (stock.status === 'untracked')
+        return undefined;
+    if (stock.availableStock == null)
+        return stock.canPurchase ? undefined : 0;
+    return Math.max(0, stock.availableStock - currentCartQty);
+}
+export function formatStockLimitMessage(productName, available, requested) {
+    if (available <= 0) {
+        return `The item "${productName}" is out of stock`;
+    }
+    if (requested != null && requested > available) {
+        return `Only ${available} of "${productName}" available`;
+    }
+    return `Only ${available} of "${productName}" available`;
+}
+/**
+ * Validates checkout line quantity against catalog availableStock (advisory cart).
+ */
+export function formatCheckoutStockError(product, quantity) {
+    return getCartLineStockInfo(product, quantity).stockError;
+}
+export function isInventoryHoldExpired(holdUntil) {
+    if (!holdUntil)
+        return false;
+    const target = new Date(holdUntil).getTime();
+    if (Number.isNaN(target))
+        return false;
+    return target <= Date.now();
+}

package/dist/lib/layout-badges.d.ts

@@ -0,0 +1,4 @@
+/** Decorative pill badges (hero/page headers). Permanently off for clean templates. */
+export declare const SHOW_LAYOUT_DECORATIVE_BADGES = false;
+export declare function showLayoutDecorativeBadges(): boolean;
+//# sourceMappingURL=layout-badges.d.ts.map

package/dist/lib/layout-badges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-badges.d.ts","sourceRoot":"","sources":["../../src/lib/layout-badges.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/dist/lib/layout-badges.js

@@ -0,0 +1,5 @@
+/** Decorative pill badges (hero/page headers). Permanently off for clean templates. */
+export const SHOW_LAYOUT_DECORATIVE_BADGES = false;
+export function showLayoutDecorativeBadges() {
+    return SHOW_LAYOUT_DECORATIVE_BADGES;
+}

package/dist/lib/layout-config-hydration.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Server-safe hydration of published layout config from DB/API payloads.
+ * Merges compiledLegacyConfigJson, editorDocument section entries, and layoutConfig.sections.
+ */
+export declare function payloadHasRenderableBlocks(payload: Record<string, unknown>): boolean;
+export declare function deepMergeLayoutPayload(base: Record<string, unknown>, overlay: Record<string, unknown>): Record<string, unknown>;
+/** Merge all persisted layout layers from a DB/API record. */
+export declare function hydratePublishedLayoutPayload(record: Record<string, unknown> | null | undefined): Record<string, unknown> | null;
+/** True when a persisted DB record contains renderable layout content after hydration. */
+export declare function hasDynamicLayoutDataFromDb(record: Record<string, unknown> | null | undefined): boolean;
+/** Extract renderable layout sections from template/default store config JSON. */
+export declare function extractTemplateLayoutPayload(raw: Record<string, unknown> | null | undefined): Record<string, unknown> | null;
+export type LayoutConfigResolutionSource = 'database' | 'template_default' | 'merged';
+/**
+ * Strict resolution: DB dynamic data wins; otherwise template defaults.
+ * When both exist, template defaults fill gaps and DB overlays customized sections.
+ */
+export declare function resolveLayoutConfigWithTemplateDefaults(dbPayload: Record<string, unknown> | null | undefined, templatePayload: Record<string, unknown> | null | undefined): {
+    layoutConfig: Record<string, unknown> | null;
+    source: LayoutConfigResolutionSource;
+};
+/** Public storefront helper — returns layout sections/pages from any persisted API shape. */
+export declare function extractPublishedLayoutConfig(apiLayoutConfig: unknown): Record<string, unknown> | null;
+export declare function hasRenderableLayoutContent(config: Record<string, unknown> | null | undefined): boolean;
+//# sourceMappingURL=layout-config-hydration.d.ts.map

package/dist/lib/layout-config-hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-config-hydration.d.ts","sourceRoot":"","sources":["../../src/lib/layout-config-hydration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwCH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBpF;AAqDD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqDzB;AAqBD,8DAA8D;AAC9D,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAsChC;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAIT;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAOhC;AAED,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACrD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1D;IAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAiBxF;AAED,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,OAAO,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKhC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAIT"}

package/dist/lib/layout-config-hydration.js

@@ -0,0 +1,264 @@
+/**
+ * Server-safe hydration of published layout config from DB/API payloads.
+ * Merges compiledLegacyConfigJson, editorDocument section entries, and layoutConfig.sections.
+ */
+import { validateEditorEnvelope } from '../editor/document/validate.js';
+import { envelopeToStoreConfig } from '../editor/document/adapter.js';
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function extractLayoutConfigPayload(config) {
+    if (!config)
+        return null;
+    const compiled = config._editor?.compiledLegacyConfigJson;
+    if (compiled && typeof compiled === 'object') {
+        const compiledRecord = compiled;
+        if (compiledRecord.layoutConfig && typeof compiledRecord.layoutConfig === 'object') {
+            return compiledRecord.layoutConfig;
+        }
+        if (compiledRecord.sections || compiledRecord.pages || compiledRecord.home) {
+            return compiledRecord;
+        }
+    }
+    if (config.layoutConfig && typeof config.layoutConfig === 'object') {
+        const lc = config.layoutConfig;
+        if (lc.sections || lc.pages || lc.home || lc.assignedAssets || lc.assignedText) {
+            return lc;
+        }
+    }
+    if (config.sections || config.pages || config.home || config.assignedAssets || config.assignedText) {
+        return config;
+    }
+    return null;
+}
+export function payloadHasRenderableBlocks(payload) {
+    const sections = payload.sections;
+    if (sections && typeof sections === 'object' && Object.keys(sections).length > 0) {
+        return true;
+    }
+    const pages = payload.pages;
+    if (pages && typeof pages === 'object' && Object.keys(pages).length > 0) {
+        return true;
+    }
+    const home = payload.home;
+    if (home && typeof home === 'object' && Object.keys(home).length > 0) {
+        return true;
+    }
+    const assignedAssets = payload.assignedAssets;
+    if (assignedAssets && typeof assignedAssets === 'object' && Object.keys(assignedAssets).length > 0) {
+        return true;
+    }
+    const assignedText = payload.assignedText;
+    if (assignedText && typeof assignedText === 'object' && Object.keys(assignedText).length > 0) {
+        return true;
+    }
+    return false;
+}
+function mergeHeroSliderArrays(base, overlay) {
+    const baseArr = Array.isArray(base) ? base : [];
+    const overlayArr = Array.isArray(overlay) ? overlay : [];
+    if (overlayArr.length === 0)
+        return baseArr.length > 0 ? [...baseArr] : [];
+    if (baseArr.length === 0)
+        return [...overlayArr];
+    const maxLen = Math.max(baseArr.length, overlayArr.length);
+    const result = [];
+    for (let i = 0; i < maxLen; i++) {
+        const baseItem = baseArr[i];
+        const overlayItem = overlayArr[i];
+        if (overlayItem === undefined) {
+            if (baseItem !== undefined)
+                result.push(baseItem);
+            continue;
+        }
+        if (baseItem === undefined) {
+            result.push(overlayItem);
+            continue;
+        }
+        if (isPlainObject(baseItem) && isPlainObject(overlayItem)) {
+            result.push(mergeLayoutSectionPayload(baseItem, overlayItem));
+        }
+        else {
+            result.push(overlayItem);
+        }
+    }
+    return result;
+}
+/** Deep-merge section payloads so nested keys (e.g. marketing.editorial) are not wiped. */
+function mergeLayoutSectionPayload(base, overlay) {
+    const result = { ...base };
+    for (const key of Object.keys(overlay)) {
+        const overlayValue = overlay[key];
+        const baseValue = result[key];
+        if (key === 'sliders' && (Array.isArray(overlayValue) || Array.isArray(baseValue))) {
+            result.sliders = mergeHeroSliderArrays(Array.isArray(baseValue) ? baseValue : undefined, Array.isArray(overlayValue) ? overlayValue : undefined);
+        }
+        else if (isPlainObject(baseValue) && isPlainObject(overlayValue)) {
+            result[key] = mergeLayoutSectionPayload(baseValue, overlayValue);
+        }
+        else if (overlayValue !== undefined) {
+            result[key] = overlayValue;
+        }
+    }
+    return result;
+}
+export function deepMergeLayoutPayload(base, overlay) {
+    const result = { ...base };
+    for (const key of Object.keys(overlay)) {
+        const overlayValue = overlay[key];
+        const baseValue = result[key];
+        if (key === 'sections' && isPlainObject(overlayValue)) {
+            const mergedSections = {
+                ...(isPlainObject(baseValue) ? baseValue : {}),
+            };
+            for (const sectionKey of Object.keys(overlayValue)) {
+                const sectionOverlay = overlayValue[sectionKey];
+                const sectionBase = mergedSections[sectionKey];
+                mergedSections[sectionKey] =
+                    isPlainObject(sectionBase) && isPlainObject(sectionOverlay)
+                        ? mergeLayoutSectionPayload(sectionBase, sectionOverlay)
+                        : sectionOverlay;
+            }
+            result.sections = mergedSections;
+            continue;
+        }
+        if (key === 'pages' && isPlainObject(overlayValue)) {
+            const mergedPages = {
+                ...(isPlainObject(baseValue) ? baseValue : {}),
+            };
+            for (const pageKey of Object.keys(overlayValue)) {
+                const pageOverlay = overlayValue[pageKey];
+                const pageBase = mergedPages[pageKey];
+                mergedPages[pageKey] =
+                    isPlainObject(pageBase) && isPlainObject(pageOverlay)
+                        ? mergeLayoutSectionPayload(pageBase, pageOverlay)
+                        : pageOverlay;
+            }
+            result.pages = mergedPages;
+            continue;
+        }
+        if ((key === 'assignedAssets' || key === 'assignedText') && isPlainObject(overlayValue)) {
+            result[key] = {
+                ...(isPlainObject(baseValue) ? baseValue : {}),
+                ...overlayValue,
+            };
+            continue;
+        }
+        if (overlayValue !== undefined) {
+            result[key] = overlayValue;
+        }
+    }
+    return result;
+}
+function compileFromEditorDocument(editorDocument) {
+    if (!editorDocument || typeof editorDocument !== 'object')
+        return null;
+    const validation = validateEditorEnvelope(editorDocument);
+    if (!validation.ok)
+        return null;
+    try {
+        const config = envelopeToStoreConfig(editorDocument);
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+function payloadFromCompiledLegacy(compiledLegacy) {
+    if (!isPlainObject(compiledLegacy))
+        return null;
+    return extractLayoutConfigPayload({
+        _editor: { compiledLegacyConfigJson: compiledLegacy },
+    });
+}
+/** Merge all persisted layout layers from a DB/API record. */
+export function hydratePublishedLayoutPayload(record) {
+    if (!record || !isPlainObject(record))
+        return null;
+    const editorMeta = isPlainObject(record._editor) ? record._editor : undefined;
+    const layers = [];
+    let compiledLayer = null;
+    if (editorMeta?.compiledLegacyConfigJson) {
+        const fromCompiled = payloadFromCompiledLegacy(editorMeta.compiledLegacyConfigJson);
+        if (fromCompiled)
+            compiledLayer = fromCompiled;
+    }
+    if (isPlainObject(record.layoutConfig)) {
+        const fromNested = extractLayoutConfigPayload(record.layoutConfig);
+        if (fromNested)
+            layers.push(fromNested);
+    }
+    const fromRecord = extractLayoutConfigPayload(record);
+    if (fromRecord)
+        layers.push(fromRecord);
+    if (editorMeta?.editorDocument) {
+        const fromEnvelope = compileFromEditorDocument(editorMeta.editorDocument);
+        const fromDoc = fromEnvelope ? extractLayoutConfigPayload(fromEnvelope) : null;
+        if (fromDoc)
+            layers.push(fromDoc);
+    }
+    // compiledLegacyConfigJson is authoritative — apply last so save-time content wins
+    // over stale section entries or template defaults in the envelope.
+    if (compiledLayer)
+        layers.push(compiledLayer);
+    if (layers.length === 0)
+        return null;
+    let merged = {};
+    for (const layer of layers) {
+        merged = deepMergeLayoutPayload(merged, layer);
+    }
+    return payloadHasRenderableBlocks(merged) ? merged : null;
+}
+/** True when a persisted DB record contains renderable layout content after hydration. */
+export function hasDynamicLayoutDataFromDb(record) {
+    if (!record)
+        return false;
+    const hydrated = hydratePublishedLayoutPayload(record);
+    return hydrated != null && payloadHasRenderableBlocks(hydrated);
+}
+/** Extract renderable layout sections from template/default store config JSON. */
+export function extractTemplateLayoutPayload(raw) {
+    if (!raw)
+        return null;
+    const hydrated = hydratePublishedLayoutPayload(raw);
+    if (hydrated && payloadHasRenderableBlocks(hydrated))
+        return hydrated;
+    const extracted = extractLayoutConfigPayload(raw);
+    if (extracted && payloadHasRenderableBlocks(extracted))
+        return extracted;
+    return null;
+}
+/**
+ * Strict resolution: DB dynamic data wins; otherwise template defaults.
+ * When both exist, template defaults fill gaps and DB overlays customized sections.
+ */
+export function resolveLayoutConfigWithTemplateDefaults(dbPayload, templatePayload) {
+    const hasDb = dbPayload != null && payloadHasRenderableBlocks(dbPayload);
+    const hasTemplate = templatePayload != null && payloadHasRenderableBlocks(templatePayload);
+    if (hasDb && hasTemplate) {
+        return {
+            layoutConfig: deepMergeLayoutPayload(templatePayload, dbPayload),
+            source: 'merged',
+        };
+    }
+    if (hasDb) {
+        return { layoutConfig: dbPayload, source: 'database' };
+    }
+    if (hasTemplate) {
+        return { layoutConfig: templatePayload, source: 'template_default' };
+    }
+    return { layoutConfig: null, source: 'template_default' };
+}
+/** Public storefront helper — returns layout sections/pages from any persisted API shape. */
+export function extractPublishedLayoutConfig(apiLayoutConfig) {
+    if (!apiLayoutConfig || typeof apiLayoutConfig !== 'object' || Array.isArray(apiLayoutConfig)) {
+        return null;
+    }
+    return hydratePublishedLayoutPayload(apiLayoutConfig);
+}
+export function hasRenderableLayoutContent(config) {
+    if (!config)
+        return false;
+    const payload = hydratePublishedLayoutPayload(config) ?? extractLayoutConfigPayload(config);
+    return payload != null && payloadHasRenderableBlocks(payload);
+}

package/dist/lib/layout-field-normalize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Normalize layout field shapes for save/publish and denormalize block trees
+ * into flat section fields for storefront renderers that read legacy paths.
+ */
+/** True when a clothing-minimal section has merchant-authored flat or block content. */
+export declare function hasClothingMinimalMerchantSectionSignal(sectionKey: string, section: Record<string, unknown> | null | undefined): boolean;
+/** Extract flat hero fields from clothing-minimal block tree for legacy renderers. */
+export declare function denormalizeClothingMinimalHeroBlocks(section: Record<string, unknown>): Record<string, unknown>;
+/** Denormalize block-based clothing-minimal home sections into flat fields. */
+export declare function denormalizeClothingMinimalBlocksToSectionFields(layoutPayload: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Normalize field shapes on a layoutConfig payload before save/publish.
+ * Ensures storefront renderers and hydration read consistent paths.
+ */
+export declare function normalizeLayoutConfigFieldShapes(layoutPayload: Record<string, unknown> | null | undefined): Record<string, unknown> | null;
+/** Apply normalization + clothing-minimal denormalization for publish materialization. */
+export declare function prepareLayoutPayloadForPublish(layoutPayload: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=layout-field-normalize.d.ts.map

package/dist/lib/layout-field-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-field-normalize.d.ts","sourceRoot":"","sources":["../../src/lib/layout-field-normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,wFAAwF;AACxF,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAClD,OAAO,CAuBT;AAED,sFAAsF;AACtF,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAED,+EAA+E;AAC/E,wBAAgB,+CAA+C,CAC7D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAmED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmChC;AAED,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}