@thorprovider/blocks 2.0.0 → 3.0.0

package/dist/lib/contracts.d.ts

@@ -0,0 +1,4008 @@
+import { z } from 'zod';
+import type { Money, PaymentMethod, ProductPreview } from '@thorprovider/types';
+/**
+ * Serialization contracts for spec-driven storefronts.
+ *
+ * These Zod schemas are the *serializable subset* of what a spec may write for
+ * a block. The component keeps its rich React interface; the catalog/registry
+ * is the adapter that maps these props to real component props and binds
+ * callbacks (see storefronts-on-blocks design D3). `z.infer` is the typed
+ * boundary between spec and catalog — a prop outside the schema is a compile
+ * error, not a runtime surprise.
+ *
+ * Data shapes are projections of the @thorprovider/types canon so that
+ * @thorprovider/adapters output validates without conflict:
+ * - Prices are plain numbers here while the canon `Money` is a decimal string
+ *   ({ amount: "45.00", currencyCode }). The projection happens at the
+ *   loader boundary.
+ * - Blocks use `title` while the canon `ProductPreview` uses `name`. Reconcile
+ *   via the canonical aliases below or the catalog/loader adapter.
+ */
+export type CanonMoney = Money;
+export type CanonProduct = ProductPreview;
+/**
+ * Fallback data-URI for required image fields when the data source has no
+ * image. Image fields are non-optional `z.string()` in these contracts, so the
+ * boundary must never emit `""` (React warns about `src=""`); it must emit a
+ * real, renderable value. Hosts may override with their own branded fallback
+ * (e.g. electrostore's `CATEGORY_IMAGE_FALLBACK`), but blocks ship a neutral
+ * one so direct consumers are safe by default.
+ */
+export 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`).
+ */
+export declare const moneySchema: z.ZodType<Money>;
+export 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, {
+        name: string;
+        value: string;
+    }, {
+        name: string;
+        value: 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;
+        height?: number | undefined;
+        width?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    availableForSale: boolean;
+    selectedOptions: {
+        name: string;
+        value: string;
+    }[];
+    image?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    } | undefined;
+    sku?: string | undefined;
+    price?: Money | null | undefined;
+    compareAtPrice?: Money | undefined;
+}, {
+    title: string;
+    id: string;
+    availableForSale: boolean;
+    selectedOptions: {
+        name: string;
+        value: string;
+    }[];
+    image?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    } | undefined;
+    sku?: string | undefined;
+    price?: Money | null | undefined;
+    compareAtPrice?: Money | undefined;
+}>;
+export type ProductDetailVariantSpec = z.infer<typeof productDetailVariantSchema>;
+export 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, {
+        id: string;
+        values: string[];
+        name: string;
+    }, {
+        id: string;
+        values: 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, {
+            name: string;
+            value: string;
+        }, {
+            name: string;
+            value: 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;
+            height?: number | undefined;
+            width?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            name: string;
+            value: string;
+        }[];
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+    }, {
+        title: string;
+        id: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            name: string;
+            value: string;
+        }[];
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | 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;
+        height?: number | undefined;
+        width?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: 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;
+        height?: number | undefined;
+        width?: number | undefined;
+    }, {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    variants: {
+        title: string;
+        id: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            name: string;
+            value: string;
+        }[];
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+    }[];
+    options: {
+        id: string;
+        values: string[];
+        name: string;
+    }[];
+    images: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    }[];
+    handle?: string | undefined;
+    description?: string | undefined;
+    vendor?: string | undefined;
+    featuredImage?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    } | undefined;
+}, {
+    title: string;
+    id: string;
+    variants: {
+        title: string;
+        id: string;
+        availableForSale: boolean;
+        selectedOptions: {
+            name: string;
+            value: string;
+        }[];
+        image?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+        sku?: string | undefined;
+        price?: Money | null | undefined;
+        compareAtPrice?: Money | undefined;
+    }[];
+    options: {
+        id: string;
+        values: string[];
+        name: string;
+    }[];
+    images: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    }[];
+    handle?: string | undefined;
+    description?: string | undefined;
+    vendor?: string | undefined;
+    featuredImage?: {
+        url: string;
+        altText: string;
+        id?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+    } | undefined;
+}>;
+export type ProductDetailProductSpec = z.infer<typeof productDetailProductSchema>;
+/**
+ * Canonical ProductOverview contract. Uses the canonical product projection and adds the
+ * bounded `presentation` option plus the `rich` presentation's optional data. Callbacks are not
+ * part of the schema (they are runtime props).
+ */
+export declare const productOverviewReviewSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    author: z.ZodString;
+    rating: z.ZodNumber;
+    comment: z.ZodString;
+    date: z.ZodString;
+    helpful: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    date: string;
+    author: string;
+    rating: number;
+    comment: string;
+    helpful?: number | undefined;
+}, {
+    id: number;
+    date: string;
+    author: string;
+    rating: number;
+    comment: string;
+    helpful?: number | undefined;
+}>;
+export declare const productOverviewPropsSchema: 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, {
+            id: string;
+            values: string[];
+            name: string;
+        }, {
+            id: string;
+            values: 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, {
+                name: string;
+                value: string;
+            }, {
+                name: string;
+                value: 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;
+                height?: number | undefined;
+                width?: number | undefined;
+            }, {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+        }, {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | 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;
+            height?: number | undefined;
+            width?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: 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;
+            height?: number | undefined;
+            width?: number | undefined;
+        }, {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        variants: {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+        }[];
+        options: {
+            id: string;
+            values: string[];
+            name: string;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        id: string;
+        variants: {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+        }[];
+        options: {
+            id: string;
+            values: string[];
+            name: string;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }>;
+    presentation: z.ZodOptional<z.ZodEnum<["standard", "gallery", "rich"]>>;
+    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>>;
+    specifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    reviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        author: z.ZodString;
+        rating: z.ZodNumber;
+        comment: z.ZodString;
+        date: z.ZodString;
+        helpful: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        date: string;
+        author: string;
+        rating: number;
+        comment: string;
+        helpful?: number | undefined;
+    }, {
+        id: number;
+        date: string;
+        author: string;
+        rating: number;
+        comment: string;
+        helpful?: number | undefined;
+    }>, "many">>;
+    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>;
+    badgeLabel: z.ZodOptional<z.ZodString>;
+    availabilityLabel: z.ZodOptional<z.ZodString>;
+    skuLabel: z.ZodOptional<z.ZodString>;
+    overviewLabel: z.ZodOptional<z.ZodString>;
+    specsLabel: z.ZodOptional<z.ZodString>;
+    featuresLabel: z.ZodOptional<z.ZodString>;
+    specificationsLabel: z.ZodOptional<z.ZodString>;
+    galleryLabel: z.ZodOptional<z.ZodString>;
+    photosLabel: z.ZodOptional<z.ZodString>;
+    saveLabel: z.ZodOptional<z.ZodString>;
+    savedLabel: z.ZodOptional<z.ZodString>;
+    shareLabel: z.ZodOptional<z.ZodString>;
+    basedOnReviewsLabel: z.ZodOptional<z.ZodString>;
+    foundHelpfulLabel: z.ZodOptional<z.ZodString>;
+    ofCounterLabel: z.ZodOptional<z.ZodString>;
+    freeDeliveryLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    product: {
+        title: string;
+        id: string;
+        variants: {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+        }[];
+        options: {
+            id: string;
+            values: string[];
+            name: string;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+    };
+    presentation?: "standard" | "gallery" | "rich" | undefined;
+    rating?: {
+        value: number;
+        count: number;
+    } | undefined;
+    selectedVariantId?: string | null | undefined;
+    quantity?: number | undefined;
+    deliveryEstimate?: string | undefined;
+    shipping?: Money | undefined;
+    specifications?: Record<string, string> | undefined;
+    features?: string[] | undefined;
+    reviews?: {
+        id: number;
+        date: string;
+        author: string;
+        rating: number;
+        comment: string;
+        helpful?: number | undefined;
+    }[] | 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;
+    badgeLabel?: string | undefined;
+    availabilityLabel?: string | undefined;
+    skuLabel?: string | undefined;
+    overviewLabel?: string | undefined;
+    specsLabel?: string | undefined;
+    featuresLabel?: string | undefined;
+    specificationsLabel?: string | undefined;
+    galleryLabel?: string | undefined;
+    photosLabel?: string | undefined;
+    saveLabel?: string | undefined;
+    savedLabel?: string | undefined;
+    shareLabel?: string | undefined;
+    basedOnReviewsLabel?: string | undefined;
+    foundHelpfulLabel?: string | undefined;
+    ofCounterLabel?: string | undefined;
+    freeDeliveryLabel?: string | undefined;
+}, {
+    product: {
+        title: string;
+        id: string;
+        variants: {
+            title: string;
+            id: string;
+            availableForSale: boolean;
+            selectedOptions: {
+                name: string;
+                value: string;
+            }[];
+            image?: {
+                url: string;
+                altText: string;
+                id?: string | undefined;
+                height?: number | undefined;
+                width?: number | undefined;
+            } | undefined;
+            sku?: string | undefined;
+            price?: Money | null | undefined;
+            compareAtPrice?: Money | undefined;
+        }[];
+        options: {
+            id: string;
+            values: string[];
+            name: string;
+        }[];
+        images: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        }[];
+        handle?: string | undefined;
+        description?: string | undefined;
+        vendor?: string | undefined;
+        featuredImage?: {
+            url: string;
+            altText: string;
+            id?: string | undefined;
+            height?: number | undefined;
+            width?: number | undefined;
+        } | undefined;
+    };
+    presentation?: "standard" | "gallery" | "rich" | undefined;
+    rating?: {
+        value: number;
+        count: number;
+    } | undefined;
+    selectedVariantId?: string | null | undefined;
+    quantity?: number | undefined;
+    deliveryEstimate?: string | undefined;
+    shipping?: Money | undefined;
+    specifications?: Record<string, string> | undefined;
+    features?: string[] | undefined;
+    reviews?: {
+        id: number;
+        date: string;
+        author: string;
+        rating: number;
+        comment: string;
+        helpful?: number | undefined;
+    }[] | 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;
+    badgeLabel?: string | undefined;
+    availabilityLabel?: string | undefined;
+    skuLabel?: string | undefined;
+    overviewLabel?: string | undefined;
+    specsLabel?: string | undefined;
+    featuresLabel?: string | undefined;
+    specificationsLabel?: string | undefined;
+    galleryLabel?: string | undefined;
+    photosLabel?: string | undefined;
+    saveLabel?: string | undefined;
+    savedLabel?: string | undefined;
+    shareLabel?: string | undefined;
+    basedOnReviewsLabel?: string | undefined;
+    foundHelpfulLabel?: string | undefined;
+    ofCounterLabel?: string | undefined;
+    freeDeliveryLabel?: string | undefined;
+}>;
+export type ProductOverviewSpecProps = z.infer<typeof productOverviewPropsSchema>;
+export declare const cardProductSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    title: z.ZodString;
+    price: z.ZodNumber;
+    originalPrice: z.ZodOptional<z.ZodNumber>;
+    image: z.ZodString;
+    badge: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    image: string;
+    id: string | number;
+    price: number;
+    badge?: string | undefined;
+    originalPrice?: number | undefined;
+}, {
+    title: string;
+    image: string;
+    id: string | number;
+    price: number;
+    badge?: string | undefined;
+    originalPrice?: number | undefined;
+}>;
+export type CardProduct = z.infer<typeof cardProductSchema>;
+export declare const cartItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    price: z.ZodNumber;
+    quantity: z.ZodNumber;
+    /** 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, {
+    id: string;
+    name: string;
+    price: number;
+    quantity: number;
+    variant?: string | undefined;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+    lineTotal?: Money | undefined;
+}, {
+    id: string;
+    name: string;
+    price: number;
+    quantity: number;
+    variant?: string | undefined;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+    lineTotal?: Money | undefined;
+}>;
+export type CartItem = z.infer<typeof cartItemSchema>;
+export 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;
+}>;
+export type CartTotals = z.infer<typeof cartTotalsSchema>;
+export 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;
+}>;
+export type RecentlyViewedItem = z.infer<typeof recentlyViewedItemSchema>;
+export declare const promotionSchema: z.ZodObject<{
+    threshold: z.ZodNumber;
+    reward: z.ZodString;
+    icon: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    icon: string;
+    threshold: number;
+    reward: string;
+}, {
+    threshold: number;
+    reward: string;
+    icon?: string | undefined;
+}>;
+export type Promotion = z.infer<typeof promotionSchema>;
+export declare const storeCategorySchema: z.ZodType<StoreCategory>;
+export type StoreCategory = {
+    label: string;
+    href: string;
+    children?: StoreCategory[];
+    emphasis?: boolean;
+};
+export declare const utilityLinkSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href: string;
+}, {
+    label: string;
+    href: string;
+}>;
+export type UtilityLink = z.infer<typeof utilityLinkSchema>;
+export declare const navCartItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    qty: z.ZodNumber;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    price: number;
+    qty: number;
+    variant?: string | undefined;
+    image?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    price: number;
+    qty: number;
+    variant?: string | undefined;
+    image?: string | undefined;
+}>;
+export type NavCartItem = z.infer<typeof navCartItemSchema>;
+export declare const storeUserSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    avatar: z.ZodOptional<z.ZodString>;
+    initials: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    name: string;
+    initials: string;
+    avatar?: string | undefined;
+}, {
+    email: string;
+    name: string;
+    initials: string;
+    avatar?: string | undefined;
+}>;
+export type StoreUser = z.infer<typeof storeUserSchema>;
+export declare const accountMenuItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodEnum<["orders", "wishlist", "addresses", "settings"]>>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href: string;
+    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+    description?: string | undefined;
+}, {
+    label: string;
+    href: string;
+    icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+    description?: string | undefined;
+}>;
+export type AccountMenuItem = z.infer<typeof accountMenuItemSchema>;
+/**
+ * Serialization contract for a payment method offered at checkout.
+ *
+ * A projection of `@thorprovider/types` `PaymentMethod` — the storefront-facing
+ * shape produced by the adapters transform. Checkout blocks render the method
+ * list from this data instead of hardcoding providers.
+ */
+export declare const paymentMethodSchema: z.ZodType<PaymentMethod>;
+export declare const buttonPropsSchema: z.ZodObject<{
+    variant: z.ZodOptional<z.ZodEnum<["default", "destructive", "outline", "secondary", "ghost", "link"]>>;
+    size: z.ZodOptional<z.ZodEnum<["default", "xs", "sm", "lg", "icon", "icon-xs", "icon-sm", "icon-lg"]>>;
+    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;
+    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;
+    disabled?: boolean | undefined;
+}>;
+export type ButtonSpecProps = z.infer<typeof buttonPropsSchema>;
+export 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;
+}>;
+export type StoreContainer1SpecProps = z.infer<typeof storeContainer1PropsSchema>;
+/**
+ * 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.
+ */
+export 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, {
+    title: string;
+    id: string | number;
+    price: Money;
+    image?: string | undefined;
+    badge?: string | undefined;
+    href?: string | undefined;
+    compareAtPrice?: Money | undefined;
+    rating?: number | undefined;
+    imageAlt?: string | undefined;
+}, {
+    title: string;
+    id: string | number;
+    price: Money;
+    image?: string | undefined;
+    badge?: string | undefined;
+    href?: string | undefined;
+    compareAtPrice?: Money | undefined;
+    rating?: number | undefined;
+    imageAlt?: string | undefined;
+}>;
+export type ProductPresentation = z.infer<typeof productPresentationSchema>;
+/**
+ * Canonical product card contract (item cell of a product listing). The cell
+ * consumes one canonical `ProductPresentation` projection only — the legacy
+ * numeric-price card shape is not accepted. `presentation` is the bounded
+ * structure switch (`classic`/`minimal`/`rich`) and `wishlisted` is the
+ * host-resolved membership state; callbacks and label strings are runtime
+ * props and are excluded here. Collection concerns (heading, item cap, loading
+ * and empty states) belong to `ProductGrid`.
+ */
+export declare const productCardPropsSchema: z.ZodObject<{
+    item: 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, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }>;
+    presentation: z.ZodOptional<z.ZodEnum<["classic", "minimal", "rich"]>>;
+    wishlisted: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    item: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    };
+    presentation?: "rich" | "classic" | "minimal" | undefined;
+    wishlisted?: boolean | undefined;
+}, {
+    item: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    };
+    presentation?: "rich" | "classic" | "minimal" | undefined;
+    wishlisted?: boolean | undefined;
+}>;
+export type ProductCardSpecProps = z.infer<typeof productCardPropsSchema>;
+/**
+ * Canonical product grid contract (listing). Consumes a collection of
+ * canonical `ProductPresentation` items and owns the listing's heading, item
+ * cap, wishlist membership, and loading/empty/ready states. `wishlistedIds` is
+ * resolved per cell before rendering, so the cell receives only its own
+ * boolean. Callbacks and label strings are runtime props and are excluded
+ * here. Error state belongs to the host.
+ */
+export declare const productGridPropsSchema: z.ZodObject<{
+    items: 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, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodEnum<["classic", "minimal", "rich"]>>;
+    heading: z.ZodOptional<z.ZodString>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+    wishlistedIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+    skeletonCount: z.ZodOptional<z.ZodNumber>;
+    emptyLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    heading?: string | undefined;
+    presentation?: "rich" | "classic" | "minimal" | undefined;
+    loading?: boolean | undefined;
+    maxItems?: number | undefined;
+    wishlistedIds?: readonly (string | number)[] | undefined;
+    skeletonCount?: number | undefined;
+    emptyLabel?: string | undefined;
+}, {
+    items: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    heading?: string | undefined;
+    presentation?: "rich" | "classic" | "minimal" | undefined;
+    loading?: boolean | undefined;
+    maxItems?: number | undefined;
+    wishlistedIds?: readonly (string | number)[] | undefined;
+    skeletonCount?: number | undefined;
+    emptyLabel?: string | undefined;
+}>;
+export type ProductGridSpecProps = z.infer<typeof productGridPropsSchema>;
+/**
+ * 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.
+ */
+export 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, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | 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: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    heading?: string | undefined;
+    description?: string | undefined;
+    addToCartLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+    pageSize?: number | undefined;
+    prevLabel?: string | undefined;
+    nextLabel?: string | undefined;
+    pageLabel?: string | undefined;
+}, {
+    products: {
+        title: string;
+        id: string | number;
+        price: Money;
+        image?: string | undefined;
+        badge?: string | undefined;
+        href?: string | undefined;
+        compareAtPrice?: Money | undefined;
+        rating?: number | undefined;
+        imageAlt?: string | undefined;
+    }[];
+    heading?: string | undefined;
+    description?: string | undefined;
+    addToCartLabel?: string | undefined;
+    unavailablePriceLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+    pageSize?: number | undefined;
+    prevLabel?: string | undefined;
+    nextLabel?: string | undefined;
+    pageLabel?: string | undefined;
+}>;
+export type ProductShowcase1SpecProps = z.infer<typeof productShowcase1PropsSchema>;
+/**
+ * Canonical shopping cart contract (consolidated shopping-cart family). Lines
+ * are keyed by the backend cart line-item id and carry canonical `Money`
+ * amounts only — the legacy numeric-price shape is not accepted: a line always
+ * carries the backend-authoritative `lineTotal`, and an optional `unitPrice` is
+ * carried verbatim (never used for a local `price * quantity` computation).
+ * Suggestions fold the numbered carts' recommendations: optional image (omitted
+ * when absent) and optional canonical `Money` price. `presentation` is the
+ * bounded structure switch (`compact`/`page`); callbacks and interaction state
+ * are runtime props and are excluded here.
+ */
+export declare const shoppingCartItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    quantity: z.ZodNumber;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    /** Canonical backend line total; a malformed amount renders as unavailable. */
+    lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+    /** Canonical backend unit price; carried verbatim, never used locally. */
+    unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    variant?: string | undefined;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+}, {
+    id: string;
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    variant?: string | undefined;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+}>;
+export type ShoppingCartItem = z.infer<typeof shoppingCartItemSchema>;
+export declare const shoppingCartSuggestionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
+    unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+}, {
+    id: string;
+    name: string;
+    image?: string | undefined;
+    unitPrice?: Money | undefined;
+}>;
+export type ShoppingCartSuggestion = z.infer<typeof shoppingCartSuggestionSchema>;
+export declare const shoppingCartPropsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        quantity: z.ZodNumber;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        /** Canonical backend line total; a malformed amount renders as unavailable. */
+        lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+        /** Canonical backend unit price; carried verbatim, never used locally. */
+        unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        variant?: string | undefined;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }, {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        variant?: string | undefined;
+        image?: string | undefined;
+        unitPrice?: 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;
+    }, {
+        threshold: number;
+        reward: string;
+        icon?: string | undefined;
+    }>, "many">>;
+    recentlyViewed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
+        unitPrice: z.ZodOptional<z.ZodType<Money, z.ZodTypeDef, Money>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }>, "many">>;
+    presentation: z.ZodOptional<z.ZodEnum<["compact", "page"]>>;
+    /** 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>;
+    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>;
+    expressCheckoutLabel: z.ZodOptional<z.ZodString>;
+    expressLabel: z.ZodOptional<z.ZodString>;
+    standardLabel: z.ZodOptional<z.ZodString>;
+    estimatedDeliveryLabel: z.ZodOptional<z.ZodString>;
+    secureCheckoutLabel: z.ZodOptional<z.ZodString>;
+    recentlyViewedLabel: z.ZodOptional<z.ZodString>;
+    promoPromptLabel: z.ZodOptional<z.ZodString>;
+    promoPlaceholderLabel: z.ZodOptional<z.ZodString>;
+    promoApplyLabel: z.ZodOptional<z.ZodString>;
+    collapseLabel: z.ZodOptional<z.ZodString>;
+    expandLabel: z.ZodOptional<z.ZodString>;
+    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: {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        variant?: string | undefined;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }[];
+    promotions: {
+        icon: string;
+        threshold: number;
+        reward: string;
+    }[];
+    presentation?: "page" | "compact" | undefined;
+    retryLabel?: string | undefined;
+    shippingLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+    recentlyViewed?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }[] | undefined;
+    totals?: {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    } | undefined;
+    totalsState?: "error" | "pending" | "idle" | undefined;
+    totalsErrorLabel?: string | undefined;
+    totalsUnavailableLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+    titleLabel?: string | undefined;
+    subtotalLabel?: string | undefined;
+    discountLabel?: string | undefined;
+    taxLabel?: string | undefined;
+    shippingFreeLabel?: string | undefined;
+    totalLabel?: string | undefined;
+    totalsPendingLabel?: string | undefined;
+    awayFromLabel?: string | undefined;
+    activatedLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    expressCheckoutLabel?: string | undefined;
+    expressLabel?: string | undefined;
+    standardLabel?: string | undefined;
+    estimatedDeliveryLabel?: string | undefined;
+    secureCheckoutLabel?: string | undefined;
+    recentlyViewedLabel?: string | undefined;
+    promoPromptLabel?: string | undefined;
+    promoPlaceholderLabel?: string | undefined;
+    promoApplyLabel?: string | undefined;
+    collapseLabel?: string | undefined;
+    expandLabel?: string | undefined;
+    checkoutLabel?: string | undefined;
+    quickCheckoutLabel?: string | undefined;
+    checkoutNowLabel?: string | undefined;
+    removeLabel?: string | undefined;
+    decreaseLabel?: string | undefined;
+    increaseLabel?: string | undefined;
+}, {
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        variant?: string | undefined;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }[];
+    presentation?: "page" | "compact" | undefined;
+    retryLabel?: string | undefined;
+    shippingLabel?: string | undefined;
+    emptyLabel?: string | undefined;
+    promotions?: {
+        threshold: number;
+        reward: string;
+        icon?: string | undefined;
+    }[] | undefined;
+    recentlyViewed?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        unitPrice?: Money | undefined;
+    }[] | undefined;
+    totals?: {
+        subtotal: Money;
+        total: Money;
+        shipping?: Money | undefined;
+        discount?: Money | undefined;
+        tax?: Money | undefined;
+    } | undefined;
+    totalsState?: "error" | "pending" | "idle" | undefined;
+    totalsErrorLabel?: string | undefined;
+    totalsUnavailableLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+    titleLabel?: string | undefined;
+    subtotalLabel?: string | undefined;
+    discountLabel?: string | undefined;
+    taxLabel?: string | undefined;
+    shippingFreeLabel?: string | undefined;
+    totalLabel?: string | undefined;
+    totalsPendingLabel?: string | undefined;
+    awayFromLabel?: string | undefined;
+    activatedLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    expressCheckoutLabel?: string | undefined;
+    expressLabel?: string | undefined;
+    standardLabel?: string | undefined;
+    estimatedDeliveryLabel?: string | undefined;
+    secureCheckoutLabel?: string | undefined;
+    recentlyViewedLabel?: string | undefined;
+    promoPromptLabel?: string | undefined;
+    promoPlaceholderLabel?: string | undefined;
+    promoApplyLabel?: string | undefined;
+    collapseLabel?: string | undefined;
+    expandLabel?: string | undefined;
+    checkoutLabel?: string | undefined;
+    quickCheckoutLabel?: string | undefined;
+    checkoutNowLabel?: string | undefined;
+    removeLabel?: string | undefined;
+    decreaseLabel?: string | undefined;
+    increaseLabel?: string | undefined;
+}>;
+export type ShoppingCartSpecProps = z.infer<typeof shoppingCartPropsSchema>;
+/**
+ * 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.
+ */
+export 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;
+}>;
+export type LogoAccent = z.infer<typeof logoAccentSchema>;
+export 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;
+}>;
+export type BrandAccent = z.infer<typeof brandAccentSchema>;
+export declare const heroImageSchema: z.ZodObject<{
+    src: z.ZodString;
+    alt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    alt: string;
+    src: string;
+}, {
+    alt: string;
+    src: string;
+}>;
+export type HeroImage = z.infer<typeof heroImageSchema>;
+/**
+ * Serializable contract for the canonical commerce storefront shell
+ * (`StorefrontNavbar`). Identity, cart, and search state stay host-owned: the
+ * schema carries content and display state only, never cart arithmetic.
+ */
+export declare const storefrontNavbarPropsSchema: z.ZodObject<{
+    storeCategories: z.ZodArray<z.ZodType<StoreCategory, z.ZodTypeDef, StoreCategory>, "many">;
+    shippingNote: z.ZodOptional<z.ZodString>;
+    utilityLinks: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href: string;
+    }, {
+        label: string;
+        href: string;
+    }>, "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.ZodOptional<z.ZodString>;
+        price: z.ZodNumber;
+        qty: z.ZodNumber;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        price: number;
+        qty: number;
+        variant?: string | undefined;
+        image?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        price: number;
+        qty: number;
+        variant?: string | undefined;
+        image?: 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.ZodOptional<z.ZodString>;
+        initials: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        email: string;
+        name: string;
+        initials: string;
+        avatar?: string | undefined;
+    }, {
+        email: string;
+        name: string;
+        initials: string;
+        avatar?: string | undefined;
+    }>>;
+    accountMenuItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodEnum<["orders", "wishlist", "addresses", "settings"]>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href: string;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+        description?: string | undefined;
+    }, {
+        label: string;
+        href: string;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+    accountPending: z.ZodOptional<z.ZodBoolean>;
+    accountUnavailable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    logoText: string;
+    storeCategories: StoreCategory[];
+    utilityLinks: {
+        label: string;
+        href: string;
+    }[];
+    className?: string | undefined;
+    logoHref?: string | undefined;
+    user?: {
+        email: string;
+        name: string;
+        initials: string;
+        avatar?: string | undefined;
+    } | undefined;
+    items?: {
+        id: string;
+        name: string;
+        price: number;
+        qty: number;
+        variant?: string | undefined;
+        image?: string | undefined;
+    }[] | undefined;
+    subtotal?: Money | undefined;
+    subtotalUnavailableLabel?: string | undefined;
+    shippingNote?: string | undefined;
+    logoAccent?: {
+        text: string;
+        className?: string | undefined;
+    } | undefined;
+    accountHref?: string | undefined;
+    searchQuery?: string | undefined;
+    accountMenuItems?: {
+        label: string;
+        href: string;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    accountPending?: boolean | undefined;
+    accountUnavailable?: boolean | undefined;
+}, {
+    logoText: string;
+    storeCategories: StoreCategory[];
+    utilityLinks: {
+        label: string;
+        href: string;
+    }[];
+    className?: string | undefined;
+    logoHref?: string | undefined;
+    user?: {
+        email: string;
+        name: string;
+        initials: string;
+        avatar?: string | undefined;
+    } | undefined;
+    items?: {
+        id: string;
+        name: string;
+        price: number;
+        qty: number;
+        variant?: string | undefined;
+        image?: string | undefined;
+    }[] | undefined;
+    subtotal?: Money | undefined;
+    subtotalUnavailableLabel?: string | undefined;
+    shippingNote?: string | undefined;
+    logoAccent?: {
+        text: string;
+        className?: string | undefined;
+    } | undefined;
+    accountHref?: string | undefined;
+    searchQuery?: string | undefined;
+    accountMenuItems?: {
+        label: string;
+        href: string;
+        icon?: "orders" | "wishlist" | "addresses" | "settings" | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    accountPending?: boolean | undefined;
+    accountUnavailable?: boolean | undefined;
+}>;
+export type StorefrontNavbarSpecProps = z.infer<typeof storefrontNavbarPropsSchema>;
+/**
+ * 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).
+ */
+export 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;
+}>;
+export type CtaSpec = z.infer<typeof ctaSchema>;
+/** Bounded presentations of the page-level navigation header. */
+export declare const navbarPresentationSchema: z.ZodEnum<["bar", "mega", "floating"]>;
+export type NavbarPresentationSpec = z.infer<typeof navbarPresentationSchema>;
+export declare const navbarItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Key resolved through the consumer's host-bound `iconMap`. */
+    icon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href: string;
+    icon?: string | undefined;
+    description?: string | undefined;
+}, {
+    label: string;
+    href: string;
+    icon?: string | undefined;
+    description?: string | undefined;
+}>;
+export type NavbarItemSpec = z.infer<typeof navbarItemSchema>;
+export declare const navbarGroupSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        /** Key resolved through the consumer's host-bound `iconMap`. */
+        icon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href: string;
+        icon?: string | undefined;
+        description?: string | undefined;
+    }, {
+        label: string;
+        href: string;
+        icon?: string | undefined;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        label: string;
+        href: string;
+        icon?: string | undefined;
+        description?: string | undefined;
+    }[];
+    title?: string | undefined;
+}, {
+    items: {
+        label: string;
+        href: string;
+        icon?: string | undefined;
+        description?: string | undefined;
+    }[];
+    title?: string | undefined;
+}>;
+export type NavbarGroupSpec = z.infer<typeof navbarGroupSchema>;
+export declare const navbarLinkSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            /** Key resolved through the consumer's host-bound `iconMap`. */
+            icon: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }[];
+        title?: string | undefined;
+    }, {
+        items: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }[];
+        title?: string | undefined;
+    }>, "many">>;
+    emphasis: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href?: string | undefined;
+    emphasis?: boolean | undefined;
+    groups?: {
+        items: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }[];
+        title?: string | undefined;
+    }[] | undefined;
+}, {
+    label: string;
+    href?: string | undefined;
+    emphasis?: boolean | undefined;
+    groups?: {
+        items: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+            description?: string | undefined;
+        }[];
+        title?: string | undefined;
+    }[] | undefined;
+}>;
+export type NavbarLinkSpec = z.infer<typeof navbarLinkSchema>;
+export declare const navbarFeaturedSchema: z.ZodObject<{
+    eyebrow: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    href: z.ZodString;
+    linkLabel: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    imageAlt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    href: string;
+    eyebrow: string;
+    image?: string | undefined;
+    description?: string | undefined;
+    imageAlt?: string | undefined;
+    linkLabel?: string | undefined;
+}, {
+    title: string;
+    href: string;
+    eyebrow: string;
+    image?: string | undefined;
+    description?: string | undefined;
+    imageAlt?: string | undefined;
+    linkLabel?: string | undefined;
+}>;
+export type NavbarFeaturedSpec = z.infer<typeof navbarFeaturedSchema>;
+/**
+ * Serializable contract for the canonical page-level header (`Navbar`). The
+ * serializable subset excludes the React-only bindings: `iconMap`, `onSignIn`,
+ * and `onCtaClick` are bound by the host, exactly like the footer's icon map.
+ */
+export declare const navbarPropsSchema: z.ZodObject<{
+    presentation: z.ZodOptional<z.ZodEnum<["bar", "mega", "floating"]>>;
+    logoText: z.ZodString;
+    logoHref: z.ZodOptional<z.ZodString>;
+    currentPath: z.ZodOptional<z.ZodString>;
+    links: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                /** Key resolved through the consumer's host-bound `iconMap`. */
+                icon: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }, {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }, {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }>, "many">>;
+        emphasis: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href?: string | undefined;
+        emphasis?: boolean | undefined;
+        groups?: {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }[] | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+        emphasis?: boolean | undefined;
+        groups?: {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }[] | undefined;
+    }>, "many">;
+    featured: z.ZodOptional<z.ZodObject<{
+        eyebrow: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        href: z.ZodString;
+        linkLabel: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        href: string;
+        eyebrow: string;
+        image?: string | undefined;
+        description?: string | undefined;
+        imageAlt?: string | undefined;
+        linkLabel?: string | undefined;
+    }, {
+        title: string;
+        href: string;
+        eyebrow: string;
+        image?: string | undefined;
+        description?: string | undefined;
+        imageAlt?: string | undefined;
+        linkLabel?: string | undefined;
+    }>>;
+    signIn: 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;
+    }>>;
+    cta: 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;
+    }>>;
+    /** Consumer-supplied classes merged onto the header surface last. */
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    links: {
+        label: string;
+        href?: string | undefined;
+        emphasis?: boolean | undefined;
+        groups?: {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }[] | undefined;
+    }[];
+    logoText: string;
+    className?: string | undefined;
+    presentation?: "bar" | "mega" | "floating" | undefined;
+    featured?: {
+        title: string;
+        href: string;
+        eyebrow: string;
+        image?: string | undefined;
+        description?: string | undefined;
+        imageAlt?: string | undefined;
+        linkLabel?: string | undefined;
+    } | undefined;
+    currentPath?: string | undefined;
+    signIn?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    logoHref?: string | undefined;
+}, {
+    links: {
+        label: string;
+        href?: string | undefined;
+        emphasis?: boolean | undefined;
+        groups?: {
+            items: {
+                label: string;
+                href: string;
+                icon?: string | undefined;
+                description?: string | undefined;
+            }[];
+            title?: string | undefined;
+        }[] | undefined;
+    }[];
+    logoText: string;
+    className?: string | undefined;
+    presentation?: "bar" | "mega" | "floating" | undefined;
+    featured?: {
+        title: string;
+        href: string;
+        eyebrow: string;
+        image?: string | undefined;
+        description?: string | undefined;
+        imageAlt?: string | undefined;
+        linkLabel?: string | undefined;
+    } | undefined;
+    currentPath?: string | undefined;
+    signIn?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    logoHref?: string | undefined;
+}>;
+export type NavbarSpecProps = z.infer<typeof navbarPropsSchema>;
+/**
+ * Serializable subset of the canonical `StorefrontHero`'s props (callbacks
+ * excluded). Every popularity, review, count, or countdown field is optional
+ * host-supplied evidence: omitted fields render nothing (honest omission)
+ * instead of fabricated defaults, and prices are formatted from the supplied
+ * ISO 4217 `currency` via `Intl.NumberFormat` (never hardcoded).
+ */
+export declare const storefrontHeroProductSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    price: z.ZodNumber;
+    originalPrice: z.ZodOptional<z.ZodNumber>;
+    image: z.ZodOptional<z.ZodString>;
+    imageAlt: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodString>;
+    colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rating: z.ZodOptional<z.ZodNumber>;
+    reviewCount: z.ZodOptional<z.ZodNumber>;
+    inStock: z.ZodOptional<z.ZodBoolean>;
+    isNew: z.ZodOptional<z.ZodBoolean>;
+    tag: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    price: number;
+    image?: string | undefined;
+    rating?: number | undefined;
+    originalPrice?: number | undefined;
+    imageAlt?: string | undefined;
+    brand?: string | undefined;
+    colors?: string[] | undefined;
+    reviewCount?: number | undefined;
+    inStock?: boolean | undefined;
+    isNew?: boolean | undefined;
+    tag?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    price: number;
+    image?: string | undefined;
+    rating?: number | undefined;
+    originalPrice?: number | undefined;
+    imageAlt?: string | undefined;
+    brand?: string | undefined;
+    colors?: string[] | undefined;
+    reviewCount?: number | undefined;
+    inStock?: boolean | undefined;
+    isNew?: boolean | undefined;
+    tag?: string | undefined;
+}>;
+export type StorefrontHeroProduct = z.infer<typeof storefrontHeroProductSchema>;
+export declare const storefrontHeroPropsSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    presentation: z.ZodOptional<z.ZodEnum<["compact", "showcase", "editorial", "promotional"]>>;
+    currency: z.ZodOptional<z.ZodString>;
+    products: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        price: z.ZodNumber;
+        originalPrice: z.ZodOptional<z.ZodNumber>;
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        brand: z.ZodOptional<z.ZodString>;
+        colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rating: z.ZodOptional<z.ZodNumber>;
+        reviewCount: z.ZodOptional<z.ZodNumber>;
+        inStock: z.ZodOptional<z.ZodBoolean>;
+        isNew: z.ZodOptional<z.ZodBoolean>;
+        tag: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        rating?: number | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+        brand?: string | undefined;
+        colors?: string[] | undefined;
+        reviewCount?: number | undefined;
+        inStock?: boolean | undefined;
+        isNew?: boolean | undefined;
+        tag?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        rating?: number | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+        brand?: string | undefined;
+        colors?: string[] | undefined;
+        reviewCount?: number | undefined;
+        inStock?: boolean | undefined;
+        isNew?: boolean | undefined;
+        tag?: string | undefined;
+    }>, "many">;
+    badge: z.ZodOptional<z.ZodString>;
+    titleAccent: 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;
+    }>>;
+    heroImage: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        alt: string;
+        src: string;
+    }, {
+        alt: string;
+        src: string;
+    }>>;
+    departments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }>, "many">>;
+    featuredDeals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        price: z.ZodNumber;
+        originalPrice: z.ZodOptional<z.ZodNumber>;
+        cta: 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, {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        cta?: {
+            label: string;
+            href?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        cta?: {
+            label: string;
+            href?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+    }>, "many">>;
+    storeLocator: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodString;
+        ctaLabel: z.ZodString;
+        ctaHref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description: string;
+        ctaLabel: string;
+        ctaHref?: string | undefined;
+    }, {
+        title: string;
+        description: string;
+        ctaLabel: string;
+        ctaHref?: string | undefined;
+    }>>;
+    shippingInfo: z.ZodOptional<z.ZodString>;
+    deals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        discount: z.ZodOptional<z.ZodString>;
+        endTime: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        discount?: string | undefined;
+        endTime?: string | undefined;
+    }, {
+        title: string;
+        id: string;
+        discount?: string | undefined;
+        endTime?: string | undefined;
+    }>, "many">>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        image: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }>, "many">>;
+    rotationInterval: z.ZodOptional<z.ZodNumber>;
+    addToCartLabel: z.ZodOptional<z.ZodString>;
+    buyNowLabel: z.ZodOptional<z.ZodString>;
+    newLabel: z.ZodOptional<z.ZodString>;
+    outOfStockLabel: z.ZodOptional<z.ZodString>;
+    colorsLabel: z.ZodOptional<z.ZodString>;
+    discountSuffixLabel: z.ZodOptional<z.ZodString>;
+    searchPlaceholder: z.ZodOptional<z.ZodString>;
+    searchLabel: z.ZodOptional<z.ZodString>;
+    featuredDescription: z.ZodOptional<z.ZodString>;
+    shopNowLabel: z.ZodOptional<z.ZodString>;
+    endsInLabel: z.ZodOptional<z.ZodString>;
+    productsLabel: z.ZodOptional<z.ZodString>;
+    viewLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    description: string;
+    products: {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        rating?: number | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+        brand?: string | undefined;
+        colors?: string[] | undefined;
+        reviewCount?: number | undefined;
+        inStock?: boolean | undefined;
+        isNew?: boolean | undefined;
+        tag?: string | undefined;
+    }[];
+    presentation?: "compact" | "showcase" | "editorial" | "promotional" | undefined;
+    badge?: string | undefined;
+    currency?: string | undefined;
+    addToCartLabel?: string | undefined;
+    outOfStockLabel?: string | undefined;
+    titleAccent?: string | undefined;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    heroImage?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    departments?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    featuredDeals?: {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        cta?: {
+            label: string;
+            href?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    storeLocator?: {
+        title: string;
+        description: string;
+        ctaLabel: string;
+        ctaHref?: string | undefined;
+    } | undefined;
+    shippingInfo?: string | undefined;
+    deals?: {
+        title: string;
+        id: string;
+        discount?: string | undefined;
+        endTime?: string | undefined;
+    }[] | undefined;
+    categories?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    rotationInterval?: number | undefined;
+    buyNowLabel?: string | undefined;
+    newLabel?: string | undefined;
+    colorsLabel?: string | undefined;
+    discountSuffixLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    featuredDescription?: string | undefined;
+    shopNowLabel?: string | undefined;
+    endsInLabel?: string | undefined;
+    productsLabel?: string | undefined;
+    viewLabel?: string | undefined;
+}, {
+    title: string;
+    description: string;
+    products: {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        rating?: number | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+        brand?: string | undefined;
+        colors?: string[] | undefined;
+        reviewCount?: number | undefined;
+        inStock?: boolean | undefined;
+        isNew?: boolean | undefined;
+        tag?: string | undefined;
+    }[];
+    presentation?: "compact" | "showcase" | "editorial" | "promotional" | undefined;
+    badge?: string | undefined;
+    currency?: string | undefined;
+    addToCartLabel?: string | undefined;
+    outOfStockLabel?: string | undefined;
+    titleAccent?: string | undefined;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    heroImage?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    departments?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    featuredDeals?: {
+        id: string;
+        name: string;
+        price: number;
+        image?: string | undefined;
+        cta?: {
+            label: string;
+            href?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        originalPrice?: number | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    storeLocator?: {
+        title: string;
+        description: string;
+        ctaLabel: string;
+        ctaHref?: string | undefined;
+    } | undefined;
+    shippingInfo?: string | undefined;
+    deals?: {
+        title: string;
+        id: string;
+        discount?: string | undefined;
+        endTime?: string | undefined;
+    }[] | undefined;
+    categories?: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        href?: string | undefined;
+        count?: string | undefined;
+        imageAlt?: string | undefined;
+    }[] | undefined;
+    rotationInterval?: number | undefined;
+    buyNowLabel?: string | undefined;
+    newLabel?: string | undefined;
+    colorsLabel?: string | undefined;
+    discountSuffixLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    featuredDescription?: string | undefined;
+    shopNowLabel?: string | undefined;
+    endsInLabel?: string | undefined;
+    productsLabel?: string | undefined;
+    viewLabel?: string | undefined;
+}>;
+export type StorefrontHeroSpecProps = z.infer<typeof storefrontHeroPropsSchema>;
+export 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;
+}>;
+export type FaqItemSpec = z.infer<typeof faqItemSchema>;
+export 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;
+}>;
+export type FaqBlock1SpecProps = z.infer<typeof faqBlock1PropsSchema>;
+export 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;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    badgeText?: string | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    primaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    secondaryCta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    badgeText?: string | undefined;
+}>;
+export type CtaSection1SpecProps = z.infer<typeof ctaSection1PropsSchema>;
+/**
+ * Serializable contract for the canonical `Feature` benefits section. The
+ * item `icon` is a Lucide icon NAME (e.g. `'Zap'`) that the registry resolves
+ * to a component at the seam; the React-only callbacks (`onCtaClick`,
+ * `onLearnMore`) are intentionally excluded — the catalog adapter binds them.
+ */
+export declare const featureItemSpecSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    icon: string;
+    description: string;
+}, {
+    title: string;
+    id: string;
+    icon: string;
+    description: string;
+}>;
+/**
+ * `cards` branch: the card grid never owns an image. The presentation is
+ * optional so an omitted value resolves to `cards`.
+ */
+export declare const featureCardsSpecSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        icon: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodLiteral<"cards">>;
+    badge: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ctaLabel: z.ZodOptional<z.ZodString>;
+    learnMoreLabel: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "cards" | undefined;
+    badge?: string | undefined;
+    description?: string | undefined;
+    ctaLabel?: string | undefined;
+    learnMoreLabel?: string | undefined;
+}, {
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "cards" | undefined;
+    badge?: string | undefined;
+    description?: string | undefined;
+    ctaLabel?: string | undefined;
+    learnMoreLabel?: string | undefined;
+}>;
+export type FeatureCardsSpecProps = z.infer<typeof featureCardsSpecSchema>;
+/**
+ * `split` branch: the editorial image is mandatory and must carry a non-empty
+ * `src`. `alt` stays required so the caller decides whether the image is
+ * informative or decorative. `cards`-only chrome is intentionally absent.
+ */
+export declare const featureSplitSpecSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        icon: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }>, "many">;
+    presentation: z.ZodLiteral<"split">;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    image: z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        alt: string;
+        src: string;
+    }, {
+        alt: string;
+        src: string;
+    }>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    image: {
+        alt: string;
+        src: string;
+    };
+    presentation: "split";
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    description?: string | undefined;
+}, {
+    image: {
+        alt: string;
+        src: string;
+    };
+    presentation: "split";
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    description?: string | undefined;
+}>;
+export type FeatureSplitSpecProps = z.infer<typeof featureSplitSpecSchema>;
+/**
+ * Serialized `Feature` union. The split branch is listed first so
+ * `presentation: 'split'` resolves deterministically; an omitted presentation
+ * falls through to `cards`. A split input without a non-empty image matches
+ * neither branch and fails to parse.
+ */
+export declare const featurePropsSchema: z.ZodUnion<[z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        icon: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }>, "many">;
+    presentation: z.ZodLiteral<"split">;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    image: z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        alt: string;
+        src: string;
+    }, {
+        alt: string;
+        src: string;
+    }>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    image: {
+        alt: string;
+        src: string;
+    };
+    presentation: "split";
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    description?: string | undefined;
+}, {
+    image: {
+        alt: string;
+        src: string;
+    };
+    presentation: "split";
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    description?: string | undefined;
+}>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        icon: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }, {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodLiteral<"cards">>;
+    badge: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ctaLabel: z.ZodOptional<z.ZodString>;
+    learnMoreLabel: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "cards" | undefined;
+    badge?: string | undefined;
+    description?: string | undefined;
+    ctaLabel?: string | undefined;
+    learnMoreLabel?: string | undefined;
+}, {
+    items: {
+        title: string;
+        id: string;
+        icon: string;
+        description: string;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "cards" | undefined;
+    badge?: string | undefined;
+    description?: string | undefined;
+    ctaLabel?: string | undefined;
+    learnMoreLabel?: string | undefined;
+}>]>;
+export type FeatureSpecProps = z.infer<typeof featurePropsSchema>;
+/**
+ * Canonical category contract for the consolidated `ProductCategory` block.
+ *
+ * `categories` is the canonical category projection (a `@thorprovider/types`
+ * `ProductCategory` subset): ids are canonical strings, optional fields are
+ * omitted rather than serialized as `""`, and there are no demo-only required
+ * fields (no required subtitle, sector icon enum, or Lucide component). `icon`
+ * is a plain, serializable icon-key string resolved by the block against a
+ * bounded map with a neutral fallback. The `presentation` value is a bounded
+ * structure switch, never a per-store fork. Callbacks are runtime props and are
+ * excluded here (see the component).
+ */
+export declare const productCategoryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    handle: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Optional real count; an unknown count is omitted, never fabricated as `0`. */
+    itemCount: z.ZodOptional<z.ZodNumber>;
+    /** Omitted (never `""`) when the backend has no image. */
+    image: z.ZodOptional<z.ZodString>;
+    trending: z.ZodOptional<z.ZodBoolean>;
+    /** Serializable icon key (e.g. `'shirt'`); unknown keys render a neutral fallback. */
+    icon: z.ZodOptional<z.ZodString>;
+    subcategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    image?: string | undefined;
+    icon?: string | undefined;
+    featured?: boolean | undefined;
+    handle?: string | undefined;
+    description?: string | undefined;
+    itemCount?: number | undefined;
+    trending?: boolean | undefined;
+    subcategories?: string[] | undefined;
+}, {
+    id: string;
+    name: string;
+    image?: string | undefined;
+    icon?: string | undefined;
+    featured?: boolean | undefined;
+    handle?: string | undefined;
+    description?: string | undefined;
+    itemCount?: number | undefined;
+    trending?: boolean | undefined;
+    subcategories?: string[] | undefined;
+}>;
+export type ProductCategoryItem = z.infer<typeof productCategoryItemSchema>;
+export declare const productCategoryPropsSchema: z.ZodObject<{
+    categories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        /** Optional real count; an unknown count is omitted, never fabricated as `0`. */
+        itemCount: z.ZodOptional<z.ZodNumber>;
+        /** Omitted (never `""`) when the backend has no image. */
+        image: z.ZodOptional<z.ZodString>;
+        trending: z.ZodOptional<z.ZodBoolean>;
+        /** Serializable icon key (e.g. `'shirt'`); unknown keys render a neutral fallback. */
+        icon: z.ZodOptional<z.ZodString>;
+        subcategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        featured: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodEnum<["grid", "icons", "list"]>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    badge: z.ZodOptional<z.ZodString>;
+    cta: 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;
+    }>>;
+    /** Controlled search value; filtering is owned by the host. */
+    query: z.ZodOptional<z.ZodString>;
+    searchPlaceholder: z.ZodOptional<z.ZodString>;
+    searchLabel: z.ZodOptional<z.ZodString>;
+    emptyLabel: z.ZodOptional<z.ZodString>;
+    noResultsLabel: z.ZodOptional<z.ZodString>;
+    browseLabel: z.ZodOptional<z.ZodString>;
+    viewAllLabel: z.ZodOptional<z.ZodString>;
+    trendingLabel: z.ZodOptional<z.ZodString>;
+    featuredLabel: z.ZodOptional<z.ZodString>;
+    itemsLabel: z.ZodOptional<z.ZodString>;
+    imageFallback: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    categories: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "grid" | "list" | "icons" | undefined;
+    badge?: string | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    emptyLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    query?: string | undefined;
+    noResultsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    viewAllLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}, {
+    categories: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "grid" | "list" | "icons" | undefined;
+    badge?: string | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    emptyLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    query?: string | undefined;
+    noResultsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    viewAllLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}>;
+export type ProductCategorySpecProps = z.infer<typeof productCategoryPropsSchema>;
+export declare const categoryCardPropsSchema: z.ZodObject<{
+    category: z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        /** Optional real count; an unknown count is omitted, never fabricated as `0`. */
+        itemCount: z.ZodOptional<z.ZodNumber>;
+        /** Omitted (never `""`) when the backend has no image. */
+        image: z.ZodOptional<z.ZodString>;
+        trending: z.ZodOptional<z.ZodBoolean>;
+        /** Serializable icon key (e.g. `'shirt'`); unknown keys render a neutral fallback. */
+        icon: z.ZodOptional<z.ZodString>;
+        subcategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        featured: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }>;
+    presentation: z.ZodOptional<z.ZodEnum<["grid", "icons", "list"]>>;
+    browseLabel: z.ZodOptional<z.ZodString>;
+    itemsLabel: z.ZodOptional<z.ZodString>;
+    trendingLabel: z.ZodOptional<z.ZodString>;
+    featuredLabel: z.ZodOptional<z.ZodString>;
+    imageFallback: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    };
+    presentation?: "grid" | "list" | "icons" | undefined;
+    itemsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}, {
+    category: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    };
+    presentation?: "grid" | "list" | "icons" | undefined;
+    itemsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}>;
+export type CategoryCardSpecProps = z.infer<typeof categoryCardPropsSchema>;
+export declare const categoryGridPropsSchema: z.ZodObject<{
+    categories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        /** Optional real count; an unknown count is omitted, never fabricated as `0`. */
+        itemCount: z.ZodOptional<z.ZodNumber>;
+        /** Omitted (never `""`) when the backend has no image. */
+        image: z.ZodOptional<z.ZodString>;
+        trending: z.ZodOptional<z.ZodBoolean>;
+        /** Serializable icon key (e.g. `'shirt'`); unknown keys render a neutral fallback. */
+        icon: z.ZodOptional<z.ZodString>;
+        subcategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        featured: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodEnum<["grid", "icons", "list"]>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    badge: z.ZodOptional<z.ZodString>;
+    cta: 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;
+    }>>;
+    /** Controlled search value; filtering is owned by the host. */
+    query: z.ZodOptional<z.ZodString>;
+    searchPlaceholder: z.ZodOptional<z.ZodString>;
+    searchLabel: z.ZodOptional<z.ZodString>;
+    emptyLabel: z.ZodOptional<z.ZodString>;
+    noResultsLabel: z.ZodOptional<z.ZodString>;
+    browseLabel: z.ZodOptional<z.ZodString>;
+    viewAllLabel: z.ZodOptional<z.ZodString>;
+    trendingLabel: z.ZodOptional<z.ZodString>;
+    featuredLabel: z.ZodOptional<z.ZodString>;
+    itemsLabel: z.ZodOptional<z.ZodString>;
+    imageFallback: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+} & {
+    maxItems: z.ZodOptional<z.ZodNumber>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+    skeletonCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    categories: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "grid" | "list" | "icons" | undefined;
+    badge?: string | undefined;
+    loading?: boolean | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    maxItems?: number | undefined;
+    skeletonCount?: number | undefined;
+    emptyLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    query?: string | undefined;
+    noResultsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    viewAllLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}, {
+    categories: {
+        id: string;
+        name: string;
+        image?: string | undefined;
+        icon?: string | undefined;
+        featured?: boolean | undefined;
+        handle?: string | undefined;
+        description?: string | undefined;
+        itemCount?: number | undefined;
+        trending?: boolean | undefined;
+        subcategories?: string[] | undefined;
+    }[];
+    title?: string | undefined;
+    className?: string | undefined;
+    presentation?: "grid" | "list" | "icons" | undefined;
+    badge?: string | undefined;
+    loading?: boolean | undefined;
+    cta?: {
+        label: string;
+        href?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    maxItems?: number | undefined;
+    skeletonCount?: number | undefined;
+    emptyLabel?: string | undefined;
+    itemsLabel?: string | undefined;
+    searchPlaceholder?: string | undefined;
+    searchLabel?: string | undefined;
+    query?: string | undefined;
+    noResultsLabel?: string | undefined;
+    browseLabel?: string | undefined;
+    viewAllLabel?: string | undefined;
+    trendingLabel?: string | undefined;
+    featuredLabel?: string | undefined;
+    imageFallback?: string | undefined;
+}>;
+export type CategoryGridSpecProps = z.infer<typeof categoryGridPropsSchema>;
+/**
+ * Canonical order-history contracts (change: consolidate-order-history-family).
+ *
+ * `OrderHistory` is the order-level collection section and `OrderLine` is its
+ * item cell. Both are `Money`-only: there is no numeric money field, so a host
+ * cannot supply a `toFixed` amount, and the block never sums lines into a
+ * total. `status` is data (`label` plus optional `tone`) so no status literal
+ * is compared anywhere. Callbacks, `locale`, and the formatter are runtime
+ * props and are excluded here, as in the cart contract.
+ */
+export declare const orderHistoryPresentationSchema: z.ZodEnum<["cards", "rows"]>;
+export type OrderHistoryPresentationSpec = z.infer<typeof orderHistoryPresentationSchema>;
+export declare const orderHistoryStatusSchema: z.ZodObject<{
+    label: z.ZodString;
+    tone: z.ZodOptional<z.ZodEnum<["default", "secondary", "destructive", "outline"]>>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+}, {
+    label: string;
+    tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+}>;
+export type OrderHistoryStatusSpec = z.infer<typeof orderHistoryStatusSchema>;
+export declare const orderLineDataSchema: z.ZodObject<{
+    /** Backend line identity; the React key. */
+    id: z.ZodString;
+    name: z.ZodString;
+    /** Optional; absent images are omitted, never serialized as `""`. */
+    image: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    /** Canonical backend line total; rendered verbatim. */
+    lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    details?: string | undefined;
+    image?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    details?: string | undefined;
+    image?: string | undefined;
+}>;
+export type OrderLineDataSpec = z.infer<typeof orderLineDataSchema>;
+export declare const orderHistoryOrderSchema: z.ZodObject<{
+    /** Backend order identity; the React key and the action callback argument. */
+    id: z.ZodString;
+    number: z.ZodString;
+    date: z.ZodString;
+    status: z.ZodObject<{
+        label: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<["default", "secondary", "destructive", "outline"]>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+    }, {
+        label: string;
+        tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+    }>;
+    /** Canonical backend order total; rendered verbatim, never aggregated. */
+    total: z.ZodType<Money, z.ZodTypeDef, Money>;
+    items: z.ZodArray<z.ZodObject<{
+        /** Backend line identity; the React key. */
+        id: z.ZodString;
+        name: z.ZodString;
+        /** Optional; absent images are omitted, never serialized as `""`. */
+        image: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        /** Canonical backend line total; rendered verbatim. */
+        lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        details?: string | undefined;
+        image?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        details?: string | undefined;
+        image?: string | undefined;
+    }>, "many">;
+    trackable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    number: string;
+    id: string;
+    status: {
+        label: string;
+        tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+    };
+    date: string;
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        details?: string | undefined;
+        image?: string | undefined;
+    }[];
+    total: Money;
+    trackable?: boolean | undefined;
+}, {
+    number: string;
+    id: string;
+    status: {
+        label: string;
+        tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+    };
+    date: string;
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+        lineTotal: Money;
+        details?: string | undefined;
+        image?: string | undefined;
+    }[];
+    total: Money;
+    trackable?: boolean | undefined;
+}>;
+export type OrderHistoryOrderSpec = z.infer<typeof orderHistoryOrderSchema>;
+export declare const orderHistoryPropsSchema: z.ZodObject<{
+    orders: z.ZodArray<z.ZodObject<{
+        /** Backend order identity; the React key and the action callback argument. */
+        id: z.ZodString;
+        number: z.ZodString;
+        date: z.ZodString;
+        status: z.ZodObject<{
+            label: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<["default", "secondary", "destructive", "outline"]>>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        }, {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        }>;
+        /** Canonical backend order total; rendered verbatim, never aggregated. */
+        total: z.ZodType<Money, z.ZodTypeDef, Money>;
+        items: z.ZodArray<z.ZodObject<{
+            /** Backend line identity; the React key. */
+            id: z.ZodString;
+            name: z.ZodString;
+            /** Optional; absent images are omitted, never serialized as `""`. */
+            image: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+            /** Canonical backend line total; rendered verbatim. */
+            lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }, {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }>, "many">;
+        trackable: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        number: string;
+        id: string;
+        status: {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        };
+        date: string;
+        items: {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }[];
+        total: Money;
+        trackable?: boolean | undefined;
+    }, {
+        number: string;
+        id: string;
+        status: {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        };
+        date: string;
+        items: {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }[];
+        total: Money;
+        trackable?: boolean | undefined;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodEnum<["cards", "rows"]>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    orders: {
+        number: string;
+        id: string;
+        status: {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        };
+        date: string;
+        items: {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }[];
+        total: Money;
+        trackable?: boolean | undefined;
+    }[];
+    className?: string | undefined;
+    presentation?: "cards" | "rows" | undefined;
+    labels?: Record<string, string> | undefined;
+}, {
+    orders: {
+        number: string;
+        id: string;
+        status: {
+            label: string;
+            tone?: "default" | "secondary" | "destructive" | "outline" | undefined;
+        };
+        date: string;
+        items: {
+            id: string;
+            name: string;
+            quantity: number;
+            lineTotal: Money;
+            details?: string | undefined;
+            image?: string | undefined;
+        }[];
+        total: Money;
+        trackable?: boolean | undefined;
+    }[];
+    className?: string | undefined;
+    presentation?: "cards" | "rows" | undefined;
+    labels?: Record<string, string> | undefined;
+}>;
+export type OrderHistorySpecProps = z.infer<typeof orderHistoryPropsSchema>;
+export declare const orderLinePropsSchema: z.ZodObject<{
+    name: z.ZodString;
+    image: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    lineTotal: z.ZodType<Money, z.ZodTypeDef, Money>;
+    quantityLabel: z.ZodOptional<z.ZodString>;
+    amountUnavailableLabel: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    details?: string | undefined;
+    image?: string | undefined;
+    className?: string | undefined;
+    quantityLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+}, {
+    name: string;
+    quantity: number;
+    lineTotal: Money;
+    details?: string | undefined;
+    image?: string | undefined;
+    className?: string | undefined;
+    quantityLabel?: string | undefined;
+    amountUnavailableLabel?: string | undefined;
+}>;
+export type OrderLineSpecProps = z.infer<typeof orderLinePropsSchema>;
+/**
+ * Canonical review contracts (change: consolidate-review-family).
+ *
+ * `ReviewSummary` is the aggregate unit, `ReviewList` the collection section,
+ * `ReviewCard` its item cell, and `ReviewComposer` the controlled form. The
+ * aggregate fields are required here for the same reason they are required in
+ * the component: an absent average must stop a host from rendering a summary,
+ * not become a zero. Callbacks and `resetSignal` are runtime props and are
+ * excluded, as in the cart and order-history contracts.
+ */
+export declare const reviewRatingValueSchema: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
+export type ReviewRatingValueSpec = z.infer<typeof reviewRatingValueSchema>;
+export declare const reviewDistributionSchema: z.ZodObject<{
+    /** Every rating value is required; a partial distribution is rejected. */
+    1: z.ZodNumber;
+    2: z.ZodNumber;
+    3: z.ZodNumber;
+    4: z.ZodNumber;
+    5: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    1: number;
+    2: number;
+    3: number;
+    4: number;
+    5: number;
+}, {
+    1: number;
+    2: number;
+    3: number;
+    4: number;
+    5: number;
+}>;
+export type ReviewDistributionSpec = z.infer<typeof reviewDistributionSchema>;
+export declare const reviewItemSchema: z.ZodObject<{
+    /** Backend review identity; the React key and the action argument. */
+    id: z.ZodString;
+    author: z.ZodString;
+    /** Optional; absent avatars are omitted, never serialized as `""`. */
+    avatar: z.ZodOptional<z.ZodString>;
+    /** Host-formatted display date, rendered verbatim. */
+    date: z.ZodString;
+    /** Optional machine-readable value; the cell emits it only when it parses. */
+    dateTime: z.ZodOptional<z.ZodString>;
+    rating: z.ZodNumber;
+    content: z.ZodString;
+    /** Host-authoritative count; absent means unknown, never zero. */
+    helpfulCount: z.ZodOptional<z.ZodNumber>;
+    likedByViewer: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    date: string;
+    author: string;
+    rating: number;
+    avatar?: string | undefined;
+    dateTime?: string | undefined;
+    helpfulCount?: number | undefined;
+    likedByViewer?: boolean | undefined;
+}, {
+    id: string;
+    content: string;
+    date: string;
+    author: string;
+    rating: number;
+    avatar?: string | undefined;
+    dateTime?: string | undefined;
+    helpfulCount?: number | undefined;
+    likedByViewer?: boolean | undefined;
+}>;
+export type ReviewItemSpec = z.infer<typeof reviewItemSchema>;
+export declare const reviewSummaryPropsSchema: z.ZodObject<{
+    averageRating: z.ZodNumber;
+    totalReviews: z.ZodNumber;
+    distribution: z.ZodObject<{
+        /** Every rating value is required; a partial distribution is rejected. */
+        1: z.ZodNumber;
+        2: z.ZodNumber;
+        3: z.ZodNumber;
+        4: z.ZodNumber;
+        5: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        5: number;
+    }, {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        5: number;
+    }>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    locale: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    averageRating: number;
+    totalReviews: number;
+    distribution: {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        5: number;
+    };
+    className?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    locale?: string | undefined;
+}, {
+    averageRating: number;
+    totalReviews: number;
+    distribution: {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        5: number;
+    };
+    className?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    locale?: string | undefined;
+}>;
+export type ReviewSummarySpecProps = z.infer<typeof reviewSummaryPropsSchema>;
+export declare const reviewListPresentationSchema: z.ZodEnum<["list", "carousel"]>;
+export type ReviewListPresentationSpec = z.infer<typeof reviewListPresentationSchema>;
+export declare const reviewListPropsSchema: z.ZodObject<{
+    reviews: z.ZodArray<z.ZodObject<{
+        /** Backend review identity; the React key and the action argument. */
+        id: z.ZodString;
+        author: z.ZodString;
+        /** Optional; absent avatars are omitted, never serialized as `""`. */
+        avatar: z.ZodOptional<z.ZodString>;
+        /** Host-formatted display date, rendered verbatim. */
+        date: z.ZodString;
+        /** Optional machine-readable value; the cell emits it only when it parses. */
+        dateTime: z.ZodOptional<z.ZodString>;
+        rating: z.ZodNumber;
+        content: z.ZodString;
+        /** Host-authoritative count; absent means unknown, never zero. */
+        helpfulCount: z.ZodOptional<z.ZodNumber>;
+        likedByViewer: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        content: string;
+        date: string;
+        author: string;
+        rating: number;
+        avatar?: string | undefined;
+        dateTime?: string | undefined;
+        helpfulCount?: number | undefined;
+        likedByViewer?: boolean | undefined;
+    }, {
+        id: string;
+        content: string;
+        date: string;
+        author: string;
+        rating: number;
+        avatar?: string | undefined;
+        dateTime?: string | undefined;
+        helpfulCount?: number | undefined;
+        likedByViewer?: boolean | undefined;
+    }>, "many">;
+    presentation: z.ZodOptional<z.ZodEnum<["list", "carousel"]>>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cardLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reviews: {
+        id: string;
+        content: string;
+        date: string;
+        author: string;
+        rating: number;
+        avatar?: string | undefined;
+        dateTime?: string | undefined;
+        helpfulCount?: number | undefined;
+        likedByViewer?: boolean | undefined;
+    }[];
+    className?: string | undefined;
+    presentation?: "list" | "carousel" | undefined;
+    labels?: Record<string, string> | undefined;
+    cardLabels?: Record<string, string> | undefined;
+}, {
+    reviews: {
+        id: string;
+        content: string;
+        date: string;
+        author: string;
+        rating: number;
+        avatar?: string | undefined;
+        dateTime?: string | undefined;
+        helpfulCount?: number | undefined;
+        likedByViewer?: boolean | undefined;
+    }[];
+    className?: string | undefined;
+    presentation?: "list" | "carousel" | undefined;
+    labels?: Record<string, string> | undefined;
+    cardLabels?: Record<string, string> | undefined;
+}>;
+export type ReviewListSpecProps = z.infer<typeof reviewListPropsSchema>;
+export declare const reviewComposerDataSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    content: z.ZodString;
+    rating: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    email: string;
+    name: string;
+    rating: 1 | 2 | 3 | 4 | 5;
+}, {
+    content: string;
+    email: string;
+    name: string;
+    rating: 1 | 2 | 3 | 4 | 5;
+}>;
+export type ReviewComposerDataSpec = z.infer<typeof reviewComposerDataSchema>;
+export declare const reviewComposerPropsSchema: z.ZodObject<{
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    isSubmitting: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    className?: string | undefined;
+    error?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    isSubmitting?: boolean | undefined;
+}, {
+    className?: string | undefined;
+    error?: string | undefined;
+    labels?: Record<string, string> | undefined;
+    isSubmitting?: boolean | undefined;
+}>;
+export type ReviewComposerSpecProps = z.infer<typeof reviewComposerPropsSchema>;
+export { isCompleteFiniteDecimal, isAvailableMoney, formatMoney } from './money';
+export { resolveAbsoluteQuantity } from './cart';
+//# sourceMappingURL=contracts.d.ts.map