@thorprovider/blocks 0.1.1 → 0.1.3

package/dist/contracts.d.mts

@@ -1,6 +1,43 @@
 import { z } from 'zod';
 import { Money, ProductPreview, PaymentMethod } from '@thorprovider/types';
 
+/**
+ * True only for a complete, finite decimal string (`"0"`, `"69.99"`, `"-3.5"`).
+ * Rejects `""`, `" "`, `"1."`, `".5"`, `"1e3"`, `"abc"`, and non-strings.
+ */
+declare function isCompleteFiniteDecimal(value: unknown): value is string;
+/**
+ * True when a `Money` value is safe to display and price a purchase with: a
+ * complete finite decimal amount and a non-empty currency code. A valid zero
+ * (`{ amount: '0', currencyCode: 'USD' }`) is available — zero alone does not
+ * make a price unavailable.
+ */
+declare function isAvailableMoney(money: Money | null | undefined): money is Money;
+/**
+ * Formats a `Money` for display, or `null` when the value is unavailable.
+ *
+ * This is the safety gate the whole curated surface relies on: an absent or
+ * malformed amount (`""`, `" "`, `"abc"`, a non-string, a missing currency)
+ * MUST NOT reach `Intl.NumberFormat`, because `Number("")` is `0` and would
+ * render a fake `$0.00` for missing data. A backend-resolved valid zero
+ * (`{ amount: "0", currencyCode: "USD" }`) is available and formats as zero.
+ *
+ * When no `formatter` is supplied the currency comes from
+ * `money.currencyCode`, so no currency is hardcoded. Callers render their own
+ * unavailable/pending/recovery state when this returns `null`.
+ */
+declare function formatMoney(money: Money | null | undefined, formatter?: (money: Money) => string): string | null;
+
+/**
+ * Cart line quantity normalization shared by the curated cart surfaces.
+ *
+ * The Navbar mini-cart expresses a quantity DELTA while the cart page reports
+ * an ABSOLUTE quantity. The boundary normalizes the delta against the
+ * authoritative current line quantity (from the backend cart) before mutating;
+ * it must never reinterpret one as the other.
+ */
+declare function resolveAbsoluteQuantity(currentQuantity: number, delta: number): number;
+
 /**
  * Serialization contracts for spec-driven storefronts.
  *
@@ -30,6 +67,689 @@ type CanonProduct = ProductPreview;
  * one so direct consumers are safe by default.
  */
 declare const PRODUCT_IMAGE_FALLBACK: string;
+/**
+ * Canonical `Money` (`@thorprovider/types`): a decimal string in major units
+ * (`"69.99"`), never cents. A missing price is represented by omitting the
+ * field (or `null` on a nullable field), not by an empty string.
+ *
+ * The amount stays a permissive `z.string()` on purpose: an unresolved backend
+ * price may arrive as the canonical sentinel `""`, and tightening the schema
+ * would reject the whole view instead of letting the presentation layer render
+ * an unavailable state. Validity is enforced at render time by
+ * `isAvailableMoney`/`formatMoney` (a `""`/malformed amount never becomes `$0`).
+ */
+declare const moneySchema: z.ZodType<Money>;
+declare const productDetailVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    sku: z.ZodOptional<z.ZodString>;
+    availableForSale: z.ZodBoolean;
+    selectedOptions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+    }, {
+        value: string;
+        name: string;
+    }>, "many">;
+    /** Omit or null when the backend has no resolved price (purchase disabled). */
+    price: z.ZodOptional<z.ZodNullable<z.ZodType<Money, z.ZodTypeDef, Money>>>;
+    compareAtPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    image: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        altText: z.ZodString;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    availableForSale: boolean;
+    selectedOptions: {
+        value: string;
+        name: string;
+    }[];
+    sku?: string | undefined;
+    price?: Money | null | undefined;
+    compareAtPrice?: Money | undefined;
+    image?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+}, {
+    id: string;
+    title: string;
+    availableForSale: boolean;
+    selectedOptions: {
+        value: string;
+        name: string;
+    }[];
+    sku?: string | undefined;
+    price?: Money | null | undefined;
+    compareAtPrice?: Money | undefined;
+    image?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+}>;
+type ProductDetailVariantSpec = z.infer<typeof productDetailVariantSchema>;
+declare const productDetailProductSchema: z.ZodObject<{
+    id: z.ZodString;
+    handle: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    vendor: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        values: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        values: string[];
+        id: string;
+        name: string;
+    }, {
+        values: string[];
+        id: string;
+        name: string;
+    }>, "many">;
+    variants: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        availableForSale: z.ZodBoolean;
+        selectedOptions: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">;
+        /** Omit or null when the backend has no resolved price (purchase disabled). */
+        price: z.ZodOptional<z.ZodNullable<z.ZodType<Money, z.ZodTypeDef, Money>>>;
+        compareAtPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        image: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            altText: z.ZodString;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            value: string;
+            name: string;
+        }[];
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        title: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            value: string;
+            name: string;
+        }[];
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }>, "many">;
+    images: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        altText: z.ZodString;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }>, "many">;
+    featuredImage: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        altText: z.ZodString;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        values: string[];
+        id: string;
+        name: string;
+    }[];
+    id: string;
+    title: string;
+    variants: {
+        id: string;
+        title: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            value: string;
+            name: string;
+        }[];
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }[];
+    images: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }[];
+    handle?: string | undefined;
+    description?: string | undefined;
+    vendor?: string | undefined;
+    featuredImage?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+}, {
+    options: {
+        values: string[];
+        id: string;
+        name: string;
+    }[];
+    id: string;
+    title: string;
+    variants: {
+        id: string;
+        title: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            value: string;
+            name: string;
+        }[];
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }[];
+    images: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }[];
+    handle?: string | undefined;
+    description?: string | undefined;
+    vendor?: string | undefined;
+    featuredImage?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+}>;
+type ProductDetailProductSpec = z.infer<typeof productDetailProductSchema>;
+declare const productOverview1PropsSchema: z.ZodObject<{
+    product: z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        vendor: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            values: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            values: string[];
+            id: string;
+            name: string;
+        }, {
+            values: string[];
+            id: string;
+            name: string;
+        }>, "many">;
+        variants: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            sku: z.ZodOptional<z.ZodString>;
+            availableForSale: z.ZodBoolean;
+            selectedOptions: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                name: string;
+            }, {
+                value: string;
+                name: string;
+            }>, "many">;
+            /** Omit or null when the backend has no resolved price (purchase disabled). */
+            price: z.ZodOptional<z.ZodNullable<z.ZodType<Money, z.ZodTypeDef, Money>>>;
+            compareAtPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+            image: z.ZodOptional<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                url: z.ZodString;
+                altText: z.ZodString;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            }, {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }, {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }>, "many">;
+        images: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            altText: z.ZodString;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }>, "many">;
+        featuredImage: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+            altText: z.ZodString;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            values: string[];
+            id: string;
+            name: string;
+        }[];
+        id: string;
+        title: string;
+        variants: {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }, {
+        options: {
+            values: string[];
+            id: string;
+            name: string;
+        }[];
+        id: string;
+        title: string;
+        variants: {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    }>;
+    selectedVariantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    quantity: z.ZodOptional<z.ZodNumber>;
+    rating: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        count: number;
+    }, {
+        value: number;
+        count: number;
+    }>>;
+    deliveryEstimate: z.ZodOptional<z.ZodString>;
+    shipping: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    sizesLabel: z.ZodOptional<z.ZodString>;
+    variantLabel: z.ZodOptional<z.ZodString>;
+    reviewsLabel: z.ZodOptional<z.ZodString>;
+    addToCartLabel: z.ZodOptional<z.ZodString>;
+    outOfStockLabel: z.ZodOptional<z.ZodString>;
+    unavailablePriceLabel: z.ZodOptional<z.ZodString>;
+    selectVariantLabel: z.ZodOptional<z.ZodString>;
+    quantityLabel: z.ZodOptional<z.ZodString>;
+    deliveryEstimateLabel: z.ZodOptional<z.ZodString>;
+    shippingLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    product: {
+        options: {
+            values: string[];
+            id: string;
+            name: string;
+        }[];
+        id: string;
+        title: string;
+        variants: {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    };
+    selectedVariantId?: string | null | undefined;
+    quantity?: number | undefined;
+    rating?: {
+        value: number;
+        count: number;
+    } | undefined;
+    deliveryEstimate?: string | undefined;
+    shipping?: Money | undefined;
+    sizesLabel?: string | undefined;
+    variantLabel?: string | undefined;
+    reviewsLabel?: string | undefined;
+    addToCartLabel?: string | undefined;
+    outOfStockLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    selectVariantLabel?: string | undefined;
+    quantityLabel?: string | undefined;
+    deliveryEstimateLabel?: string | undefined;
+    shippingLabel?: string | undefined;
+}, {
+    product: {
+        options: {
+            values: string[];
+            id: string;
+            name: string;
+        }[];
+        id: string;
+        title: string;
+        variants: {
+            id: string;
+            title: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                value: string;
+                name: string;
+            }[];
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+    };
+    selectedVariantId?: string | null | undefined;
+    quantity?: number | undefined;
+    rating?: {
+        value: number;
+        count: number;
+    } | undefined;
+    deliveryEstimate?: string | undefined;
+    shipping?: Money | undefined;
+    sizesLabel?: string | undefined;
+    variantLabel?: string | undefined;
+    reviewsLabel?: string | undefined;
+    addToCartLabel?: string | undefined;
+    outOfStockLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    selectVariantLabel?: string | undefined;
+    quantityLabel?: string | undefined;
+    deliveryEstimateLabel?: string | undefined;
+    shippingLabel?: string | undefined;
+}>;
+type ProductOverview1SpecProps = z.infer<typeof productOverview1PropsSchema>;
 declare const cardProductSchema: z.ZodObject<{
     id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
     title: z.ZodString;
@@ -38,19 +758,19 @@ declare const cardProductSchema: z.ZodObject<{
     image: z.ZodString;
     badge: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    title: string;
-    image: string;
     id: string | number;
+    title: string;
     price: number;
-    badge?: string | undefined;
+    image: string;
     originalPrice?: number | undefined;
+    badge?: string | undefined;
 }, {
-    title: string;
-    image: string;
     id: string | number;
+    title: string;
     price: number;
-    badge?: string | undefined;
+    image: string;
     originalPrice?: number | undefined;
+    badge?: string | undefined;
 }>;
 type CardProduct = z.infer<typeof cardProductSchema>;
 declare const cartItemSchema: z.ZodObject<{
@@ -58,39 +778,68 @@ declare const cartItemSchema: z.ZodObject<{
     name: z.ZodString;
     price: z.ZodNumber;
     quantity: z.ZodNumber;
-    image: z.ZodString;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    /** Canonical backend per-unit price, preferred for display when present. */
+    unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    /** Canonical backend line total, preferred over `price * quantity`. */
+    lineTotal: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
 }, "strip", z.ZodTypeAny, {
-    image: string;
     id: string;
     name: string;
     price: number;
     quantity: number;
+    image?: string | undefined;
     variant?: string | undefined;
+    unitPrice?: Money | undefined;
+    lineTotal?: Money | undefined;
 }, {
-    image: string;
     id: string;
     name: string;
     price: number;
     quantity: number;
+    image?: string | undefined;
     variant?: string | undefined;
+    unitPrice?: Money | undefined;
+    lineTotal?: Money | undefined;
 }>;
 type CartItem = z.infer<typeof cartItemSchema>;
+declare const cartTotalsSchema: z.ZodObject<{
+    subtotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+    discount: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    tax: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    shipping: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    total: z.ZodType<Money, z.ZodTypeDef, Money>;
+}, "strip", z.ZodTypeAny, {
+    subtotal: Money;
+    total: Money;
+    shipping?: Money | undefined;
+    discount?: Money | undefined;
+    tax?: Money | undefined;
+}, {
+    subtotal: Money;
+    total: Money;
+    shipping?: Money | undefined;
+    discount?: Money | undefined;
+    tax?: Money | undefined;
+}>;
+type CartTotals = z.infer<typeof cartTotalsSchema>;
 declare const recentlyViewedItemSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     price: z.ZodNumber;
     image: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    image: string;
     id: string;
     name: string;
     price: number;
-}, {
     image: string;
+}, {
     id: string;
     name: string;
     price: number;
+    image: string;
 }>;
 type RecentlyViewedItem = z.infer<typeof recentlyViewedItemSchema>;
 declare const promotionSchema: z.ZodObject<{
@@ -98,9 +847,9 @@ declare const promotionSchema: z.ZodObject<{
     reward: z.ZodString;
     icon: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    icon: string;
     threshold: number;
     reward: string;
+    icon: string;
 }, {
     threshold: number;
     reward: string;
@@ -128,41 +877,42 @@ type UtilityLink = z.infer<typeof utilityLinkSchema>;
 declare const navCartItemSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    variant: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
     price: z.ZodNumber;
     qty: z.ZodNumber;
-    image: z.ZodString;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    variant: string;
-    image: string;
     id: string;
     name: string;
     price: number;
     qty: number;
+    image?: string | undefined;
+    variant?: string | undefined;
 }, {
-    variant: string;
-    image: string;
     id: string;
     name: string;
     price: number;
     qty: number;
+    image?: string | undefined;
+    variant?: string | undefined;
 }>;
 type NavCartItem = z.infer<typeof navCartItemSchema>;
 declare const storeUserSchema: z.ZodObject<{
     name: z.ZodString;
     email: z.ZodString;
-    avatar: z.ZodString;
+    avatar: z.ZodOptional<z.ZodString>;
     initials: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    email: string;
     name: string;
-    avatar: string;
+    email: string;
     initials: string;
+    avatar?: string | undefined;
 }, {
-    email: string;
     name: string;
-    avatar: string;
+    email: string;
     initials: string;
+    avatar?: string | undefined;
 }>;
 type StoreUser = z.infer<typeof storeUserSchema>;
 declare const accountMenuItemSchema: z.ZodObject<{
@@ -173,13 +923,13 @@ declare const accountMenuItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     label: string;
     href: string;
-    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     description?: string | undefined;
+    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
 }, {
     label: string;
     href: string;
-    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     description?: string | undefined;
+    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
 }>;
 type AccountMenuItem = z.infer<typeof accountMenuItemSchema>;
 /**
@@ -196,26 +946,26 @@ declare const buttonPropsSchema: z.ZodObject<{
     disabled: z.ZodOptional<z.ZodBoolean>;
     className: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    variant?: "default" | "secondary" | "destructive" | "outline" | "ghost" | "link" | undefined;
-    className?: string | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | undefined;
+    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | undefined;
+    size?: "icon" | "default" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | undefined;
     disabled?: boolean | undefined;
-}, {
-    variant?: "default" | "secondary" | "destructive" | "outline" | "ghost" | "link" | undefined;
     className?: string | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | undefined;
+}, {
+    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | undefined;
+    size?: "icon" | "default" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | undefined;
     disabled?: boolean | undefined;
+    className?: string | undefined;
 }>;
 type ButtonSpecProps = z.infer<typeof buttonPropsSchema>;
 declare const storeContainer1PropsSchema: z.ZodObject<{
     size: z.ZodOptional<z.ZodEnum<["default", "narrow", "wide", "full"]>>;
     className: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    className?: string | undefined;
     size?: "default" | "narrow" | "wide" | "full" | undefined;
-}, {
     className?: string | undefined;
+}, {
     size?: "default" | "narrow" | "wide" | "full" | undefined;
+    className?: string | undefined;
 }>;
 type StoreContainer1SpecProps = z.infer<typeof storeContainer1PropsSchema>;
 declare const productCard1PropsSchema: z.ZodObject<{
@@ -227,77 +977,228 @@ declare const productCard1PropsSchema: z.ZodObject<{
         image: z.ZodString;
         badge: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        title: string;
-        image: string;
         id: string | number;
+        title: string;
         price: number;
-        badge?: string | undefined;
+        image: string;
         originalPrice?: number | undefined;
+        badge?: string | undefined;
     }, {
-        title: string;
-        image: string;
         id: string | number;
+        title: string;
         price: number;
-        badge?: string | undefined;
+        image: string;
         originalPrice?: number | undefined;
+        badge?: string | undefined;
     }>, "many">;
     heading: z.ZodOptional<z.ZodString>;
     maxItems: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     products: {
-        title: string;
-        image: string;
         id: string | number;
+        title: string;
         price: number;
-        badge?: string | undefined;
+        image: string;
         originalPrice?: number | undefined;
+        badge?: string | undefined;
     }[];
     heading?: string | undefined;
     maxItems?: number | undefined;
 }, {
     products: {
-        title: string;
-        image: string;
         id: string | number;
+        title: string;
         price: number;
-        badge?: string | undefined;
+        image: string;
         originalPrice?: number | undefined;
+        badge?: string | undefined;
     }[];
     heading?: string | undefined;
     maxItems?: number | undefined;
 }>;
 type ProductCard1SpecProps = z.infer<typeof productCard1PropsSchema>;
+/**
+ * Canonical product presentation — the serializable projection a storefront host
+ * produces from a canonical `Product` for the merchandising sections. Unlike
+ * `cardProductSchema` (legacy, numeric `price`), `price`/`compareAtPrice` carry
+ * canonical `Money` (decimal major-unit string + currency code), so the block
+ * formats in the shopper's currency and locale and renders a truthful
+ * unavailable state instead of `$0`. Optional fields are omitted, never `""`.
+ *
+ * This contract is additive: `cardProductSchema` and its consumers are
+ * unchanged, and a legacy numeric `price` still renders the legacy output.
+ */
+declare const productPresentationSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    title: z.ZodString;
+    /** Omitted (never `""`) when the backend has no image. */
+    image: z.ZodOptional<z.ZodString>;
+    imageAlt: z.ZodOptional<z.ZodString>;
+    /** Product destination; omitted when unknown. */
+    href: z.ZodOptional<z.ZodString>;
+    price: z.ZodType<Money, z.ZodTypeDef, Money>;
+    /** Comparison ("was") price; rendered only when valid and higher than `price`. */
+    compareAtPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    /** Only from real evidence; omitted otherwise (never fabricated). */
+    rating: z.ZodOptional<z.ZodNumber>;
+    badge: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    title: string;
+    price: Money;
+    compareAtPrice?: Money | undefined;
+    image?: string | undefined;
+    rating?: number | undefined;
+    badge?: string | undefined;
+    href?: string | undefined;
+    imageAlt?: string | undefined;
+}, {
+    id: string | number;
+    title: string;
+    price: Money;
+    compareAtPrice?: Money | undefined;
+    image?: string | undefined;
+    rating?: number | undefined;
+    badge?: string | undefined;
+    href?: string | undefined;
+    imageAlt?: string | undefined;
+}>;
+type ProductPresentation = z.infer<typeof productPresentationSchema>;
+/**
+ * Serializable contract for the combined grid-and-carousel product
+ * presentation (`ProductShowcase1`). The grid pages are fixed-size, navigated
+ * manually (prev/next) with a visible current-page indication; there is no
+ * autoplay and no infinite loop. React-only callbacks are excluded.
+ */
+declare const productShowcase1PropsSchema: z.ZodObject<{
+    products: z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        title: z.ZodString;
+        /** Omitted (never `""`) when the backend has no image. */
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        /** Product destination; omitted when unknown. */
+        href: z.ZodOptional<z.ZodString>;
+        price: z.ZodType<Money, z.ZodTypeDef, Money>;
+        /** Comparison ("was") price; rendered only when valid and higher than `price`. */
+        compareAtPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        /** Only from real evidence; omitted otherwise (never fabricated). */
+        rating: z.ZodOptional<z.ZodNumber>;
+        badge: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string | number;
+        title: string;
+        price: Money;
+        compareAtPrice?: Money | undefined;
+        image?: string | undefined;
+        rating?: number | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        id: string | number;
+        title: string;
+        price: Money;
+        compareAtPrice?: Money | undefined;
+        image?: string | undefined;
+        rating?: number | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        imageAlt?: string | undefined;
+    }>, "many">;
+    heading: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    prevLabel: z.ZodOptional<z.ZodString>;
+    nextLabel: z.ZodOptional<z.ZodString>;
+    pageLabel: z.ZodOptional<z.ZodString>;
+    unavailablePriceLabel: z.ZodOptional<z.ZodString>;
+    emptyLabel: z.ZodOptional<z.ZodString>;
+    addToCartLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    products: {
+        id: string | number;
+        title: string;
+        price: Money;
+        compareAtPrice?: Money | undefined;
+        image?: string | undefined;
+        rating?: number | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    description?: string | undefined;
+    addToCartLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    heading?: string | undefined;
+    pageSize?: number | undefined;
+    prevLabel?: string | undefined;
+    nextLabel?: string | undefined;
+    pageLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+}, {
+    products: {
+        id: string | number;
+        title: string;
+        price: Money;
+        compareAtPrice?: Money | undefined;
+        image?: string | undefined;
+        rating?: number | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    description?: string | undefined;
+    addToCartLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    heading?: string | undefined;
+    pageSize?: number | undefined;
+    prevLabel?: string | undefined;
+    nextLabel?: string | undefined;
+    pageLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+}>;
+type ProductShowcase1SpecProps = z.infer<typeof productShowcase1PropsSchema>;
 declare const shoppingCart4PropsSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         price: z.ZodNumber;
         quantity: z.ZodNumber;
-        image: z.ZodString;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
         variant: z.ZodOptional<z.ZodString>;
+        /** Canonical backend per-unit price, preferred for display when present. */
+        unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        /** Canonical backend line total, preferred over `price * quantity`. */
+        lineTotal: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
     }, "strip", z.ZodTypeAny, {
-        image: string;
         id: string;
         name: string;
         price: number;
         quantity: number;
+        image?: string | undefined;
         variant?: string | undefined;
+        unitPrice?: Money | undefined;
+        lineTotal?: Money | undefined;
     }, {
-        image: string;
         id: string;
         name: string;
         price: number;
         quantity: number;
+        image?: string | undefined;
         variant?: string | undefined;
+        unitPrice?: Money | undefined;
+        lineTotal?: Money | undefined;
     }>, "many">;
     promotions: z.ZodDefault<z.ZodArray<z.ZodObject<{
         threshold: z.ZodNumber;
         reward: z.ZodString;
         icon: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        icon: string;
         threshold: number;
         reward: string;
+        icon: string;
     }, {
         threshold: number;
         reward: string;
@@ -309,23 +1210,50 @@ declare const shoppingCart4PropsSchema: z.ZodObject<{
         price: z.ZodNumber;
         image: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        image: string;
         id: string;
         name: string;
         price: number;
-    }, {
         image: string;
+    }, {
         id: string;
         name: string;
         price: number;
+        image: string;
     }>, "many">>;
+    /** Backend-authoritative totals; rendered verbatim, never computed locally. */
+    totals: z.ZodOptional<z.ZodObject<{
+        subtotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+        discount: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        tax: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        shipping: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+        total: z.ZodType<Money, z.ZodTypeDef, Money>;
+    }, "strip", z.ZodTypeAny, {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    }, {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    }>>;
+    totalsState: z.ZodOptional<z.ZodEnum<["idle", "pending", "error"]>>;
+    totalsErrorLabel: z.ZodOptional<z.ZodString>;
+    totalsUnavailableLabel: z.ZodOptional<z.ZodString>;
+    amountUnavailableLabel: z.ZodOptional<z.ZodString>;
+    retryLabel: z.ZodOptional<z.ZodString>;
     taxRate: z.ZodOptional<z.ZodNumber>;
     titleLabel: z.ZodOptional<z.ZodString>;
     subtotalLabel: z.ZodOptional<z.ZodString>;
+    discountLabel: z.ZodOptional<z.ZodString>;
     taxLabel: z.ZodOptional<z.ZodString>;
     shippingLabel: z.ZodOptional<z.ZodString>;
     shippingFreeLabel: z.ZodOptional<z.ZodString>;
     totalLabel: z.ZodOptional<z.ZodString>;
+    totalsPendingLabel: z.ZodOptional<z.ZodString>;
     awayFromLabel: z.ZodOptional<z.ZodString>;
     activatedLabel: z.ZodOptional<z.ZodString>;
     itemsLabel: z.ZodOptional<z.ZodString>;
@@ -340,33 +1268,54 @@ declare const shoppingCart4PropsSchema: z.ZodObject<{
     checkoutLabel: z.ZodOptional<z.ZodString>;
     quickCheckoutLabel: z.ZodOptional<z.ZodString>;
     checkoutNowLabel: z.ZodOptional<z.ZodString>;
+    emptyLabel: z.ZodOptional<z.ZodString>;
+    removeLabel: z.ZodOptional<z.ZodString>;
+    decreaseLabel: z.ZodOptional<z.ZodString>;
+    increaseLabel: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     items: {
-        image: string;
         id: string;
         name: string;
         price: number;
         quantity: number;
+        image?: string | undefined;
         variant?: string | undefined;
+        unitPrice?: Money | undefined;
+        lineTotal?: Money | undefined;
     }[];
     promotions: {
-        icon: string;
         threshold: number;
         reward: string;
+        icon: string;
     }[];
+    shippingLabel?: string | undefined;
+    emptyLabel?: string | undefined;
     recentlyViewed?: {
-        image: string;
         id: string;
         name: string;
         price: number;
+        image: string;
     }[] | undefined;
+    totals?: {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    } | undefined;
+    totalsState?: "idle" | "pending" | "error" | undefined;
+    totalsErrorLabel?: string | undefined;
+    totalsUnavailableLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+    retryLabel?: string | undefined;
     taxRate?: number | undefined;
     titleLabel?: string | undefined;
     subtotalLabel?: string | undefined;
+    discountLabel?: string | undefined;
     taxLabel?: string | undefined;
-    shippingLabel?: string | undefined;
     shippingFreeLabel?: string | undefined;
     totalLabel?: string | undefined;
+    totalsPendingLabel?: string | undefined;
     awayFromLabel?: string | undefined;
     activatedLabel?: string | undefined;
     itemsLabel?: string | undefined;
@@ -381,33 +1330,53 @@ declare const shoppingCart4PropsSchema: z.ZodObject<{
     checkoutLabel?: string | undefined;
     quickCheckoutLabel?: string | undefined;
     checkoutNowLabel?: string | undefined;
+    removeLabel?: string | undefined;
+    decreaseLabel?: string | undefined;
+    increaseLabel?: string | undefined;
 }, {
     items: {
-        image: string;
         id: string;
         name: string;
         price: number;
         quantity: number;
+        image?: string | undefined;
         variant?: string | undefined;
+        unitPrice?: Money | undefined;
+        lineTotal?: Money | undefined;
     }[];
+    shippingLabel?: string | undefined;
+    emptyLabel?: string | undefined;
     promotions?: {
         threshold: number;
         reward: string;
         icon?: string | undefined;
     }[] | undefined;
     recentlyViewed?: {
-        image: string;
         id: string;
         name: string;
         price: number;
+        image: string;
     }[] | undefined;
+    totals?: {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    } | undefined;
+    totalsState?: "idle" | "pending" | "error" | undefined;
+    totalsErrorLabel?: string | undefined;
+    totalsUnavailableLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+    retryLabel?: string | undefined;
     taxRate?: number | undefined;
     titleLabel?: string | undefined;
     subtotalLabel?: string | undefined;
+    discountLabel?: string | undefined;
     taxLabel?: string | undefined;
-    shippingLabel?: string | undefined;
     shippingFreeLabel?: string | undefined;
     totalLabel?: string | undefined;
+    totalsPendingLabel?: string | undefined;
     awayFromLabel?: string | undefined;
     activatedLabel?: string | undefined;
     itemsLabel?: string | undefined;
@@ -422,11 +1391,53 @@ declare const shoppingCart4PropsSchema: z.ZodObject<{
     checkoutLabel?: string | undefined;
     quickCheckoutLabel?: string | undefined;
     checkoutNowLabel?: string | undefined;
+    removeLabel?: string | undefined;
+    decreaseLabel?: string | undefined;
+    increaseLabel?: string | undefined;
 }>;
 type ShoppingCart4SpecProps = z.infer<typeof shoppingCart4PropsSchema>;
+/**
+ * Optional brand seams shared by the existing blocks. These mirror the
+ * components' optional props as a serializable subset (no React): an accent
+ * marks a trailing segment of the wordmark/brand name, and an editorial image
+ * is a native `<img>` source. Omitting each keeps the block's current output.
+ */
+declare const logoAccentSchema: z.ZodObject<{
+    text: z.ZodString;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    className?: string | undefined;
+}, {
+    text: string;
+    className?: string | undefined;
+}>;
+type LogoAccent = z.infer<typeof logoAccentSchema>;
+declare const brandAccentSchema: z.ZodObject<{
+    text: z.ZodString;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    className?: string | undefined;
+}, {
+    text: string;
+    className?: string | undefined;
+}>;
+type BrandAccent = z.infer<typeof brandAccentSchema>;
+declare const heroImageSchema: z.ZodObject<{
+    src: z.ZodString;
+    alt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    src: string;
+    alt: string;
+}, {
+    src: string;
+    alt: string;
+}>;
+type HeroImage = z.infer<typeof heroImageSchema>;
 declare const navbar4PropsSchema: z.ZodObject<{
     storeCategories: z.ZodArray<z.ZodType<StoreCategory, z.ZodTypeDef, StoreCategory>, "many">;
-    shippingNote: z.ZodString;
+    shippingNote: z.ZodOptional<z.ZodString>;
     utilityLinks: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         href: z.ZodString;
@@ -439,45 +1450,65 @@ declare const navbar4PropsSchema: z.ZodObject<{
     }>, "many">;
     logoText: z.ZodString;
     logoHref: z.ZodOptional<z.ZodString>;
+    /** Optional accent for a trailing segment of `logoText`; omitted → unchanged. */
+    logoAccent: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        className: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        className?: string | undefined;
+    }, {
+        text: string;
+        className?: string | undefined;
+    }>>;
+    /**
+     * Consumer-supplied classes merged onto the block's outer surface as the
+     * final argument (e.g. a semantic surface token). Omitted → unchanged.
+     */
+    className: z.ZodOptional<z.ZodString>;
     accountHref: z.ZodOptional<z.ZodString>;
     searchQuery: z.ZodOptional<z.ZodString>;
     items: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
-        variant: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
         price: z.ZodNumber;
         qty: z.ZodNumber;
-        image: z.ZodString;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        variant: string;
-        image: string;
         id: string;
         name: string;
         price: number;
         qty: number;
+        image?: string | undefined;
+        variant?: string | undefined;
     }, {
-        variant: string;
-        image: string;
         id: string;
         name: string;
         price: number;
         qty: number;
+        image?: string | undefined;
+        variant?: string | undefined;
     }>, "many">>;
+    /** Authoritative backend subtotal for the mini-cart. */
+    subtotal: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    subtotalUnavailableLabel: z.ZodOptional<z.ZodString>;
     user: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         email: z.ZodString;
-        avatar: z.ZodString;
+        avatar: z.ZodOptional<z.ZodString>;
         initials: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        email: string;
         name: string;
-        avatar: string;
+        email: string;
         initials: string;
+        avatar?: string | undefined;
     }, {
-        email: string;
         name: string;
-        avatar: string;
+        email: string;
         initials: string;
+        avatar?: string | undefined;
     }>>;
     accountMenuItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
@@ -487,77 +1518,215 @@ declare const navbar4PropsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         label: string;
         href: string;
-        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
         description?: string | undefined;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     }, {
         label: string;
         href: string;
-        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
         description?: string | undefined;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     }>, "many">>;
+    accountPending: z.ZodOptional<z.ZodBoolean>;
+    accountUnavailable: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    logoText: string;
     storeCategories: StoreCategory[];
     utilityLinks: {
         label: string;
         href: string;
     }[];
-    shippingNote: string;
-    logoHref?: string | undefined;
-    user?: {
-        email: string;
-        name: string;
-        avatar: string;
-        initials: string;
-    } | undefined;
+    logoText: string;
+    subtotal?: Money | undefined;
+    className?: string | undefined;
     items?: {
-        variant: string;
-        image: string;
         id: string;
         name: string;
         price: number;
         qty: number;
+        image?: string | undefined;
+        variant?: string | undefined;
     }[] | undefined;
+    shippingNote?: string | undefined;
+    logoHref?: string | undefined;
+    logoAccent?: {
+        text: string;
+        className?: string | undefined;
+    } | undefined;
     accountHref?: string | undefined;
     searchQuery?: string | undefined;
+    subtotalUnavailableLabel?: string | undefined;
+    user?: {
+        name: string;
+        email: string;
+        initials: string;
+        avatar?: string | undefined;
+    } | undefined;
     accountMenuItems?: {
         label: string;
         href: string;
-        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
         description?: string | undefined;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     }[] | undefined;
+    accountPending?: boolean | undefined;
+    accountUnavailable?: boolean | undefined;
 }, {
-    logoText: string;
     storeCategories: StoreCategory[];
     utilityLinks: {
         label: string;
         href: string;
     }[];
-    shippingNote: string;
-    logoHref?: string | undefined;
-    user?: {
-        email: string;
-        name: string;
-        avatar: string;
-        initials: string;
-    } | undefined;
+    logoText: string;
+    subtotal?: Money | undefined;
+    className?: string | undefined;
     items?: {
-        variant: string;
-        image: string;
         id: string;
         name: string;
         price: number;
         qty: number;
+        image?: string | undefined;
+        variant?: string | undefined;
     }[] | undefined;
+    shippingNote?: string | undefined;
+    logoHref?: string | undefined;
+    logoAccent?: {
+        text: string;
+        className?: string | undefined;
+    } | undefined;
     accountHref?: string | undefined;
     searchQuery?: string | undefined;
+    subtotalUnavailableLabel?: string | undefined;
+    user?: {
+        name: string;
+        email: string;
+        initials: string;
+        avatar?: string | undefined;
+    } | undefined;
     accountMenuItems?: {
         label: string;
         href: string;
-        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
         description?: string | undefined;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
     }[] | undefined;
+    accountPending?: boolean | undefined;
+    accountUnavailable?: boolean | undefined;
 }>;
 type Navbar4SpecProps = z.infer<typeof navbar4PropsSchema>;
+/**
+ * Serializable contracts for the two bounded editorial sections (`faq`, `cta`).
+ * These are the serializable subset of `FaqBlock1Props`/`CtaSection1Props`: the
+ * React-only callbacks (`onPrimaryClick`/`onSecondaryClick`) are intentionally
+ * excluded — the catalog adapter binds them (see design D3).
+ */
+declare const ctaSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href?: string | undefined;
+}, {
+    label: string;
+    href?: string | undefined;
+}>;
+type CtaSpec = z.infer<typeof ctaSchema>;
+declare const faqItemSchema: z.ZodObject<{
+    value: z.ZodString;
+    question: z.ZodString;
+    answer: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    question: string;
+    answer: string;
+}, {
+    value: string;
+    question: string;
+    answer: string;
+}>;
+type FaqItemSpec = z.infer<typeof faqItemSchema>;
+declare const faqBlock1PropsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        question: z.ZodString;
+        answer: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        question: string;
+        answer: string;
+    }, {
+        value: string;
+        question: string;
+        answer: string;
+    }>, "many">;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accordionType: z.ZodOptional<z.ZodEnum<["single", "multiple"]>>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        value: string;
+        question: string;
+        answer: string;
+    }[];
+    title?: string | undefined;
+    description?: string | undefined;
+    accordionType?: "single" | "multiple" | undefined;
+}, {
+    items: {
+        value: string;
+        question: string;
+        answer: string;
+    }[];
+    title?: string | undefined;
+    description?: string | undefined;
+    accordionType?: "single" | "multiple" | undefined;
+}>;
+type FaqBlock1SpecProps = z.infer<typeof faqBlock1PropsSchema>;
+declare const ctaSection1PropsSchema: z.ZodObject<{
+    badgeText: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    primaryCta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href?: string | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+    }>>;
+    secondaryCta: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href?: string | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    description?: string | undefined;
+    badgeText?: string | undefined;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    badgeText?: string | undefined;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+}>;
+type CtaSection1SpecProps = z.infer<typeof ctaSection1PropsSchema>;
 
-export { type AccountMenuItem, type ButtonSpecProps, type CanonMoney, type CanonProduct, type CardProduct, type CartItem, type NavCartItem, type Navbar4SpecProps, PRODUCT_IMAGE_FALLBACK, type ProductCard1SpecProps, type Promotion, type RecentlyViewedItem, type ShoppingCart4SpecProps, type StoreCategory, type StoreContainer1SpecProps, type StoreUser, type UtilityLink, accountMenuItemSchema, buttonPropsSchema, cardProductSchema, cartItemSchema, navCartItemSchema, navbar4PropsSchema, paymentMethodSchema, productCard1PropsSchema, promotionSchema, recentlyViewedItemSchema, shoppingCart4PropsSchema, storeCategorySchema, storeContainer1PropsSchema, storeUserSchema, utilityLinkSchema };
+export { type AccountMenuItem, type BrandAccent, type ButtonSpecProps, type CanonMoney, type CanonProduct, type CardProduct, type CartItem, type CartTotals, type CtaSection1SpecProps, type CtaSpec, type FaqBlock1SpecProps, type FaqItemSpec, type HeroImage, type LogoAccent, type NavCartItem, type Navbar4SpecProps, PRODUCT_IMAGE_FALLBACK, type ProductCard1SpecProps, type ProductDetailProductSpec, type ProductDetailVariantSpec, type ProductOverview1SpecProps, type ProductPresentation, type ProductShowcase1SpecProps, type Promotion, type RecentlyViewedItem, type ShoppingCart4SpecProps, type StoreCategory, type StoreContainer1SpecProps, type StoreUser, type UtilityLink, accountMenuItemSchema, brandAccentSchema, buttonPropsSchema, cardProductSchema, cartItemSchema, cartTotalsSchema, ctaSchema, ctaSection1PropsSchema, faqBlock1PropsSchema, faqItemSchema, formatMoney, heroImageSchema, isAvailableMoney, isCompleteFiniteDecimal, logoAccentSchema, moneySchema, navCartItemSchema, navbar4PropsSchema, paymentMethodSchema, productCard1PropsSchema, productDetailProductSchema, productDetailVariantSchema, productOverview1PropsSchema, productPresentationSchema, productShowcase1PropsSchema, promotionSchema, recentlyViewedItemSchema, resolveAbsoluteQuantity, shoppingCart4PropsSchema, storeCategorySchema, storeContainer1PropsSchema, storeUserSchema, utilityLinkSchema };