@thorprovider/blocks 0.1.3 → 1.0.0

package/dist/contracts.d.mts

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