@propeller-commerce/propeller-v2-react-ui 0.20.1 → 0.22.0

package/dist/index.d.ts

@@ -40,6 +40,14 @@ interface PropellerDeps {
 interface PropellerScope {
     /** The authenticated user, or `null` when browsing anonymously. */
     user: Contact | Customer | null;
+    /**
+     * Whether a session exists, independent of whether `user` has loaded yet.
+     * Hosts paint from a cached hint before the profile arrives, so `user` is
+     * null for an authenticated visitor for the first frames; without this,
+     * semi-closed surfaces flash their logged-out state. Optional — omitting it
+     * keeps the previous behaviour.
+     */
+    isAuthenticated?: boolean;
     /** Active company ID for the current session; `undefined` for non-company users. */
     companyId: number | undefined;
     /** Active language code (e.g. `'NL'`). */
@@ -588,7 +596,11 @@ interface UseCartReturn {
     loading: boolean;
     /** Last error message, or `null`. */
     error: string | null;
-    /** `false` when a B2B purchaser's authorization limit is exceeded by the cart total. */
+    /**
+     * `false` when a B2B purchaser's authorization limit is exceeded by the cart
+     * total, and while a seeded `cartId` is still being hydrated — it fails
+     * closed, so gating a checkout button on it holds rather than opens.
+     */
     checkoutAllowed: boolean;
     /** Resolves an existing cart or creates one via the shared `initCart` flow. */
     resolveCart: () => Promise<Cart>;
@@ -1687,6 +1699,20 @@ interface UseSparePartsOptions {
     sortOrder?: SortOrder | string;
     /** Items per page. Defaults to 12. */
     pageSize?: number;
+    /**
+     * Controlled page. When provided the hook renders (and fetches) this page and
+     * `goToPage` becomes advisory - the host owns the number, typically from the
+     * URL.
+     *
+     * Every other listing input (term, textFilters, sortField, pageSize) was
+     * already an option, so its absence read as "paging is internal" and it was
+     * not: driving the hook from URL state and rendering GridPagination changed
+     * the URL but re-rendered the same first page, because the only way in was a
+     * `useEffect(() => goToPage(page))` that MachineGrid does internally and
+     * nothing documented (PWP-995b). Omit it to keep the previous uncontrolled
+     * behaviour.
+     */
+    page?: number;
     /** Image filter config, mirroring `useProductSearch`'s `configuration`. */
     configuration?: {
         /** The channel's anonymous user, seeded by the host. Scopes logged-out
@@ -2167,8 +2193,13 @@ interface ResolveSpecEntry {
      */
     transform?: (gridValue: NonNullable<ProductGridConfig[GridKey]>) => unknown;
 }
-/** Per-prop resolution spec: maps each prop key to its {@link ResolveSpecEntry}. */
-type ResolveSpec<P> = Partial<Record<keyof P, ResolveSpecEntry>>;
+/**
+ * Per-prop resolution spec: maps each prop key to its {@link ResolveSpecEntry}.
+ *
+ * Infra keys are spec'able too, so a component can pull a provider value it
+ * only reads internally without having to publish it as its own prop.
+ */
+type ResolveSpec<P> = Partial<Record<keyof P | keyof PropellerInfra, ResolveSpecEntry>>;
 /**
  * useResolvedProps — resolves props through the two-tier precedence
  * `explicit prop > ProductGrid context > Propeller infra > default`.
@@ -2177,7 +2208,7 @@ type ResolveSpec<P> = Partial<Record<keyof P, ResolveSpecEntry>>;
  * @param spec - per-key resolution rules; keys absent from the spec pass through unchanged.
  * @returns the props with each spec'd key resolved to its highest-precedence value.
  */
-declare function useResolvedProps<P extends object>(rawProps: P, spec: ResolveSpec<P>): P;
+declare function useResolvedProps<P extends object>(rawProps: P, spec: ResolveSpec<P>): P & Partial<PropellerInfra>;
 
 /**
  * Read the SDK services bundle from `<PropellerDepsProvider>`.
@@ -3482,13 +3513,17 @@ interface CartOverviewProps {
         code: string;
         name: string;
     }[];
+    /** Logged-in user — used for the purchase-authorization check. Resolved from PropellerProvider when omitted. */
+    user?: Contact | Customer | null;
+    /** Active company ID — used for the purchase-authorization check. Resolved from PropellerProvider when omitted. */
+    companyId?: number;
 }
 /**
  * Final cart review panel: shows invoice/delivery addresses, payment, carrier
  * and delivery date, with optional reference, notes, terms acceptance and a
  * place-order button.
  */
-declare function CartOverview(props: CartOverviewProps): React$1.JSX.Element;
+declare function CartOverview(rawProps: CartOverviewProps): React$1.JSX.Element;
 
 /**
  * @rsc-blocked — Client-only component: interactive state (useState/useReducer).
@@ -3898,14 +3933,22 @@ interface MachineCardProps {
      * URL is its ancestor path (`/machines/a/b/c`), which only the host route
      * knows; the machine object carries just its own slug.
      */
-    href: string;
+    href?: string;
     /** Show the machine image. Defaults to true. */
     showImage?: boolean;
     /** Show the machine description under the name. Defaults to false. */
     showDescription?: boolean;
     /** Language used to resolve the localized name/description. */
     language?: string;
-    /** UI label overrides. Supported key: `viewMachine`. */
+    /**
+     * UI label overrides. Key read here: `viewMachine`.
+     *
+     * `MachineGrid` passes its own `machineCardLabels` straight through to this
+     * prop and additionally reads `loading` and `noMachines` from it for its own
+     * empty/loading states, so the object a grid host supplies carries all three.
+     * This doc used to name only `viewMachine`, which left the other two in
+     * English for anyone who followed it (PWP-995d).
+     */
     labels?: Record<string, string>;
     /** Extra classes on the card root. */
     className?: string;
@@ -3923,216 +3966,514 @@ interface MachineCardProps {
 declare function MachineCard(props: MachineCardProps): React$1.JSX.Element;
 
 /**
- * @rsc-blocked — Client-only component: hooks + effects (via useSpareParts /
- * useMachines) and event handlers. Render inside a Client boundary.
- */
-/**
- * MachineGrid — the spare-parts machine tree, as one self-contained grid.
- *
- * The machine-tree sibling of `ProductGrid`. Driven by the current URL path
- * (`segments`), it renders one of two modes:
- *
- *  - **Root** (`segments` empty): resolves the company's installations in ONE
- *    concatenated request via `useMachines(source, sourceIds)` and renders them
- *    as `MachineCard`s.
- *  - **Node** (`segments` non-empty): fetches that machine by its leaf slug via
- *    `useSpareParts`, and renders its child machines (`MachineCard`s) above a
- *    category-style spare-parts listing (facets + toolbar + a permanently
- *    controlled `ProductGrid` + pagination, with the qty-in-machine `belowName`).
- *
- * Navigation between levels is via `MachineCard`'s `href` (built from `basePath`
- * + segments + child slug) — the package owns no router. The parts listing is
- * **controlled**: the current state comes in via `listing`, and every filter /
- * sort / page / search interaction emits the next state via `onListingChange`.
- * The host route maps that to the URL (so a filtered view is shareable), exactly
- * as `ProductGrid` + the category island already do.
- */
-
-/**
- * The controlled listing state for the spare-parts view — mirrors what the host
- * derives from the URL (`page`/`offset`/`sort`/attribute-`filters`/`price`/`term`).
- * Primitives + SDK enums only, so no app type leaks into the package.
+ * Props for the root `<ProductCard>` (and the back-compat monolithic
+ * variant). Most fields are display toggles preserved for back-compat; in
+ * the new compound API, consumers control rendering by composition instead
+ * — see the Subcomponents section below.
  */
-interface MachineListingState {
-    page: number;
-    offset: number;
-    sortField: ProductSortField | string;
-    sortOrder: SortOrder | string;
-    /** Attribute name → selected facet values. */
-    filters: Record<string, string[]>;
-    minPrice?: number;
-    maxPrice?: number;
-    term: string;
-}
-interface MachineGridProps {
-    /** Current URL path under the machines root, e.g. `['mixer','frame']`. `[]` = root. */
-    segments: string[];
-    /** Localized machines base path (e.g. `/nl/machines`) — used to build hrefs. */
-    basePath: string;
-    /** External system the installation ids belong to (root mode). */
-    source?: string;
-    /** Installation ids from `MY_INSTALLATIONS` (root mode). */
-    sourceIds?: string[];
-    /** Title for the root list. Defaults to `'Machines'`. */
-    rootTitle?: string;
-    /** Language the machine tree is authored in (usually EN). Defaults to `'EN'`. */
-    machineLanguage?: string;
-    listing: MachineListingState;
-    onListingChange: (next: MachineListingState) => void;
-    graphqlClient?: GraphQLClient;
-    user?: Contact | Customer | null;
-    companyId?: number;
-    /** Storefront language (parts). */
-    language?: string;
-    taxZone?: string;
-    configuration?: {
-        imageSearchFiltersGrid?: unknown;
-        imageVariantFiltersMedium?: unknown;
-    };
-    portalMode?: string;
-    cartId?: string;
-    createCart?: boolean;
-    onCartCreated?: (cart: Cart) => void;
+interface ProductCardProps {
+    /** The product object to display */
+    product: Product;
     /**
-     * Fired after every successful add-to-cart (adds into an EXISTING cart too, not
-     * just the first create). Forward this to `CartContext.saveCart` or the cart
-     * icon/sidebar/page won't reflect parts added from the grid — `onCartCreated`
-     * alone only fires when a brand-new cart is created.
+     * Compound API: provide subcomponents as children. When omitted, the
+     * monolithic legacy layout renders based on the show*/ children?: React$1.ReactNode;
+    /** Show the product name. Defaults to true. */
+    showName?: boolean;
+    /** Show the product image. Defaults to true. */
+    showImage?: boolean;
+    /** Show the product short description. Defaults to false. */
+    showShortDescription?: boolean;
+    /** Show the product SKU. Defaults to true. */
+    showSku?: boolean;
+    /** Show the product manufacturer. Defaults to false. */
+    showManufacturer?: boolean;
+    /**
+     * Show the stock / availability widget below the product name.
+     * Uses the embedded `ItemStock` component driven by `product.inventory`.
+     * Defaults to false.
      */
-    afterAddToCart?: (cart: Cart, item?: CartMainItem) => void;
-    allowAddToCart?: boolean;
-    showPrice?: boolean;
     showStock?: boolean;
-    showAvailability?: boolean;
-    onProductClick?: (product: Product) => void;
-    paginationLabels?: Record<string, string>;
-    filtersLabels?: Record<string, string>;
-    toolbarLabels?: Record<string, string>;
-    machineCardLabels?: Record<string, string>;
-    className?: string;
-}
-declare function MachineGrid(rawProps: MachineGridProps): React$1.JSX.Element;
-
-/**
- * @rsc-blocked — Client-only component: side effects (useEffect).
- * Must be rendered inside (or below) a Client Component boundary; cannot be
- * imported directly into a React Server Component. The 'use client' header
- * above marks this boundary to Next.js.
- */
-
-/**
- * A computed object containing a cluster config setting enriched with
- * its current UI state: available values for drilldown, the currently
- * selected value, and whether the selector should be disabled.
- */
-interface ClusterConfiguratorProps {
-    /** The cluster ID this configurator belongs to. Required. */
-    clusterId: number;
     /**
-     * All products that belong to the cluster. Required.
-     * Used to derive available values per attribute and to match
-     * the configured product when all selections are made.
+     * Show only the availability indicator (Available / Not available) inside ItemStock.
+     * Only relevant when `showStock` is true.
+     * Defaults to true.
      */
-    products: Product[];
+    showAvailability?: boolean;
     /**
-     * Cluster configuration object (`cluster.config`). Required.
-     * Provides the ordered list of attribute settings.
+     * Show the price below the product name.
+     * Defaults to true.
      */
-    config: ClusterConfig;
+    showPrice?: boolean;
     /**
-     * Fired whenever the user completes a set of attribute selections
-     * that uniquely identifies a cluster product.
-     * Also fired whenever any selection changes and a matching product
-     * can already be determined (e.g. only one setting exists).
+     * Show the AddToCart component.
+     * Defaults to true.
      */
-    onConfigurationChange?: (product: Product) => void;
-    /** Default product to pre-populate the attribute selections on mount. */
-    defaultProduct?: Product;
-    /** Override any UI string. Available keys: selectOption */
-    labels?: Record<string, string>;
-    /** Extra CSS class applied to the root element. */
-    className?: string;
-}
-/**
- * Renders attribute selectors (dropdown, radio, colour or image swatches) for
- * configuring a cluster, narrowing available values as the user selects and
- * emitting the matching product.
- *
- * @remarks Uses {@link useClusterConfigurator} to derive selectable values and
- * resolve the configured product.
- */
-declare function ClusterConfigurator(props: ClusterConfiguratorProps): React$1.JSX.Element;
-
-/**
- * @rsc-blocked — Client-only component: side effects (useEffect).
- * Must be rendered inside (or below) a Client Component boundary; cannot be
- * imported directly into a React Server Component. The 'use client' header
- * above marks this boundary to Next.js.
- */
-
-interface ClusterInfoProps {
-    /** The authenticated user (Contact or Customer). Resolved from PropellerProvider when omitted. */
-    user?: Contact | Customer | null;
+    allowAddToCart?: boolean;
     /**
-     * Pre-fetched cluster object to display.
-     * When provided the component skips internal fetching.
+     * Label overrides forwarded to the embedded ItemStock component.
+     * Keys: inStock, outOfStock, lowStock, available, notAvailable, pieces
      */
-    cluster?: Cluster;
+    stockLabels?: Record<string, string>;
     /**
-     * Cluster ID to fetch data for when no `cluster` prop is provided.
-     * Requires `graphqlClient` to be set.
+     * Attribute codes/names to look up and display as badge overlays on the product image.
+     * Example: ['new', 'sale']
      */
-    clusterId?: number;
+    imageLabels?: string[];
     /**
-     * Initialised Propeller SDK GraphQL client.
-     * Required when `clusterId` is provided for internal data fetching.
+     * Attribute codes/names to look up and display as extra text rows below the product name.
+     * Example: ['brand', 'color']
      */
-    graphqlClient?: GraphQLClient;
+    textLabels?: string[];
+    /** Override any UI string. Keys: addToFavorites, removeFromFavorites */
+    labels?: Record<string, string>;
+    /** Renders a heart-icon toggle button on the product image. Defaults to false. */
+    enableAddFavorite?: boolean;
+    /** Called whenever the favourite state is toggled. */
+    onToggleFavorite?: (product: Product, isFavorite: boolean) => void;
     /**
-     * Called once the cluster data is loaded — either immediately (when
-     * `cluster` prop is supplied) or after the internal fetch completes.
-     * Use this to hydrate sibling components (configurator, price, gallery, etc.).
+     * Called when the product name or image is clicked.
+     * When provided, the default `<a>` navigation is prevented.
      */
-    onClusterLoaded?: (cluster: Cluster) => void;
-    /** Show the cluster name. Defaults to true. */
-    showTitle?: boolean;
-    /** Show the cluster SKU. Defaults to true. */
-    showSku?: boolean;
-    /** Language code used to resolve localised names. Defaults to 'NL'. */
-    language?: string;
+    onProductClick?: (product: Product) => void;
+    /** When true, tax-inclusive (net) price is the leading price. Defaults to false. */
+    includeTax?: boolean;
+    /** Number of grid columns — when 1 the card renders as a compact horizontal row. */
+    columns?: number;
     /** Extra CSS class applied to the root element. */
     className?: string;
     /**
-     * Tax zone to use for price calculation.
-     */
-    taxZone?: string;
-    /**
-     * Image search filter passed to ProductService.getProduct().
-     * Controls how many image items are returned.
-     * Example: { page: 1, offset: 20 }
+     * URL pattern controlling which segments appear in product links.
+     * Tokens: page → 'product', id → productId, slug → slug value.
+     * Defaults to 'page/id/slug'.
      */
-    imageSearchFilters?: any;
+    urlPattern?: string;
+    /** GraphQL client for the embedded AddToCart. Resolved from PropellerProvider when omitted. */
+    graphqlClient?: GraphQLClient;
+    /** Authenticated user. Resolved from PropellerProvider when omitted. */
+    user?: Contact | Customer | null;
     /**
-     * Image variant transformation filter passed to ProductService.getProduct().
-     * Controls image size/format variants returned with the product.
-     * Example: imageVariantFiltersLarge from @/data/defaults
-     * Defaults to { transformations: [] } when omitted.
+     * Portal access mode — `'open'` / `'semi-closed'` / `'closed'`. Resolved from
+     * PropellerProvider when omitted. In `'semi-closed'` the card hides price and
+     * stock from anonymous visitors and offers a log-in action in place of
+     * add-to-cart; signed-in users are unaffected.
      */
-    imageVariantFilters?: any;
+    portalMode?: string;
     /**
-     * Config object providing imageSearchFiltersGrid and imageVariantFiltersSmall.
+     * Invoked when an anonymous visitor clicks the log-in action that replaces
+     * add-to-cart in a semi-closed portal. The host owns navigation.
      */
+    onLoginClick?: () => void;
+    /** ID of the cart that add-to-cart targets. */
+    cartId?: string;
+    /** Configuration object (URL builders, image filters, etc.). */
     configuration?: any;
-    /**
-     * Attribute codes/names to look up and display as badge overlays on the product image.
-     * Each code is resolved against `product.attributes.items[].attributeDescription.code`
-     * (or `.name`). Attributes with no matching value are silently omitted.
-     * Example: ['new', 'sale']
-     */
-    imageLabels?: string[];
-    /**
-     * Attribute codes/names to look up and display as extra text rows below the product name.
-     * Resolved the same way as `imageLabels`.
+    /** Cluster ID when this card represents a variant of a product cluster. */
+    clusterId?: number;
+    /** Pre-selected child item product IDs added alongside the product. */
+    childItems?: number[];
+    /** Order-line notes forwarded with the add-to-cart request. */
+    notes?: string;
+    /** Custom price override forwarded with the add-to-cart request. */
+    price?: number;
+    /** When true, a new cart is created if no `cartId` is set. */
+    createCart?: boolean;
+    /** Fires when add-to-cart creates a new cart. */
+    onCartCreated?: (cart: Cart) => void;
+    /** Delegation handler — when provided, the parent performs the add-to-cart itself. */
+    onAddToCart?: (product: Product, clusterId?: number, quantity?: number, childItems?: CartChildItemInput[], notes?: string, price?: number, showModal?: boolean) => Cart;
+    /** Fires after an item has been added to the cart. */
+    afterAddToCart?: (cart: Cart, item?: CartMainItem) => void;
+    /** When true, show a confirmation modal after add-to-cart instead of a toast. */
+    showModal?: boolean;
+    /** When true, the AddToCart shows quantity increment/decrement controls. */
+    allowIncrDecr?: boolean;
+    /** When true, stock availability is validated before adding to cart. */
+    enableStockValidation?: boolean;
+    /** Language code for localised content. Resolved from PropellerProvider when omitted. */
+    language?: string;
+    /** Active company ID from the company switcher. */
+    companyId?: number;
+    /** Fires when the "Proceed to checkout" modal button is clicked. */
+    onProceedToCheckout?: () => void;
+    /** Fires when the user requests a quote from the AddToCart modal. */
+    onRequestQuoteClick?: (cart: Cart) => void;
+    /** Label overrides forwarded to the embedded AddToCart component. */
+    addToCartLabels?: Record<string, string>;
+    /** Translated labels forwarded to the embedded `<ProductPrice>` display.
+     * See `ProductPriceProps.labels` for slugs (inclTax, exclTax, loginToSeePrices). */
+    priceLabels?: Record<string, string>;
+    /** Replaces the default price block. Receives `PriceComponentProps`. */
+    /** Currency symbol used when formatting the price. Falls back to PropellerInfra.currency, then `'€'`. */
+    currency?: string;
+    priceComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.PriceComponentProps>;
+    /** Replaces the default stock/availability block. Receives `StockComponentProps`. */
+    stockComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.StockComponentProps>;
+    /** Replaces the default add-to-cart control. Receives `AddToCartComponentProps`. */
+    addToCartComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.AddToCartComponentProps>;
+    /** Replaces the default product image block. Receives `ImageComponentProps`. */
+    imageComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.ImageComponentProps>;
+    /** Replaces the default product badges block. Receives `BadgesComponentProps`. */
+    badgesComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.BadgesComponentProps>;
+    /** Replaces the default favorite-toggle. Receives `FavoriteComponentProps`. */
+    favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
+    /**
+     * Render arbitrary content directly below the product name (and above the
+     * short description / price), in both the grid and row layouts. Receives the
+     * product so hosts can surface extra info — e.g. package descriptions, custom
+     * badges — without forking the card. Return `null`/`undefined` to render
+     * nothing for a given product.
+     */
+    belowName?: (product: Product) => React$1.ReactNode;
+}
+/**
+ * Root of the `<ProductCard>` compound component. Renders either the
+ * consumer-composed children (compound mode) or the legacy monolithic layout
+ * driven by `show*`/`allow*` toggles, and provides the shared card context.
+ */
+declare function ProductCardRoot(rawProps: ProductCardProps): React$1.JSX.Element;
+/**
+ * Product image with optional badge overlays and favourite button.
+ * Reads `derived.imageUrl`, `derived.imageLabelValues`, `derived.productUrl`,
+ * and the `favorite` state from context.
+ *
+ * Trade-off: when `imageComponent` is injected, the consumer takes over the
+ * ENTIRE image area — including the badge / favorite overlay layer.
+ * The default markup wraps the `<img>` in a link with absolute-positioned
+ * badges and a favorite button; an injected component receives only the
+ * `ImageComponentProps` contract and is free to re-render those overlays
+ * itself (e.g. by composing `<DefaultProductBadges>` / `<DefaultAddToFavorite>`)
+ * or omit them entirely.
+ */
+declare function ProductCardImage(props: {
+    /** Override the wrapper class. */
+    className?: string;
+    /** Render the favourite heart button. Defaults to context `enableAddFavorite`. */
+    showFavorite?: boolean;
+}): React$1.JSX.Element;
+/** Image-overlay badge list (e.g. "new", "sale" attributes), or the
+ *  injected `badgesComponent` from context when set. */
+declare function ProductCardBadges(props: {
+    /** Override the badge container class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Favourite (heart) toggle button — typically placed inside `<ProductCard.Image>`,
+ *  or the injected `favoriteComponent` from context when set.
+ *
+ *  The default render is the inline self-contained heart button (local state
+ *  only, fires `onToggleFavorite`); the injected variant receives the full
+ *  `FavoriteComponentProps` contract (product, user, callback) so consumers
+ *  can plug in real favorite-list mutations. The unused import of
+ *  `DefaultAddToFavoriteImpl` is kept so consumers can wrap-and-call it. */
+declare function ProductCardFavorite(props: {
+    /** Override the button class. */
+    className?: string;
+}): React$1.JSX.Element;
+/** Product name. `linkable` (default true) wraps it in an `<a>` to the PDP. */
+declare function ProductCardName(props: {
+    /** When true (default), wraps the name in a link to the product page. */
+    linkable?: boolean;
+    /** Override the name element class. */
+    className?: string;
+}): React$1.JSX.Element;
+/** Renders the product SKU. */
+declare function ProductCardSku(props: {
+    /** Override the SKU element class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Renders the product's short description. */
+declare function ProductCardShortDescription(props: {
+    /** Override the description element class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Renders the product manufacturer name. */
+declare function ProductCardManufacturer(props: {
+    /** Override the manufacturer element class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Renders the resolved `textLabels` attribute values as text rows. */
+declare function ProductCardTextLabels(props: {
+    /** Override the label container class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Renders the embedded stock/availability widget for the product, or the
+ *  injected `stockComponent` from context when set. */
+declare function ProductCardStock(props: {
+    /** Show only the availability indicator. Defaults to context `showAvailability`. */
+    showAvailability?: boolean;
+}): React$1.JSX.Element | null;
+/** Renders host-supplied content directly below the name, via the `belowName`
+ *  render prop (explicit or from grid context). Renders nothing when unset or
+ *  when the render prop returns a nullish value. */
+declare function ProductCardBelowName(): React$1.JSX.Element | null;
+/** Renders the product price via the embedded `ProductPrice` component, or
+ *  the injected `priceComponent` from context when set. */
+declare function ProductCardPrice(props: {
+    /** Tailwind text-size class for the price. Defaults to `'text-base sm:text-lg'`. */
+    priceSize?: string;
+    /** Override the price wrapper class. */
+    className?: string;
+}): React$1.JSX.Element | null;
+/** Renders the embedded `AddToCart` control with all pass-through props from
+ *  context, or the injected `addToCartComponent` when set.
+ *
+ *  Note: the default `AddToCartImpl` accepts a richer prop set than the public
+ *  `AddToCartComponentProps` contract. Injected components receive the whole
+ *  contract surface; what stays default-only is infra (graphqlClient, user,
+ *  configuration, …), which an injected component resolves from
+ *  `<PropellerProvider>` itself. */
+declare function ProductCardAddToCart(props: {
+    /** Override the AddToCart wrapper class. */
+    className?: string;
+}): React$1.JSX.Element;
+declare const MemoizedRoot: React$1.MemoExoticComponent<typeof ProductCardRoot>;
+/**
+ * Compound component. Use either:
+ *
+ *  **Compound mode (new — preferred):**
+ *  ```tsx
+ *  <ProductCard product={p}>
+ *    <ProductCard.Image variant="grid" />
+ *    <ProductCard.Name linkable />
+ *    <ProductCard.Sku />
+ *    <ProductCard.Price />
+ *    <ProductCard.AddToCart />
+ *  </ProductCard>
+ *  ```
+ *
+ *  **Legacy mode (deprecated — kept for back-compat):**
+ *  ```tsx
+ *  <ProductCard product={p} showName showPrice allowAddToCart />
+ *  ```
+ *  All the show* / allow* toggles still work and render the canonical layout
+ *  using the compound subcomponents internally.
+ */
+type ProductCardComponent = typeof MemoizedRoot & {
+    Image: typeof ProductCardImage;
+    Badges: typeof ProductCardBadges;
+    Favorite: typeof ProductCardFavorite;
+    Name: typeof ProductCardName;
+    Sku: typeof ProductCardSku;
+    BelowName: typeof ProductCardBelowName;
+    ShortDescription: typeof ProductCardShortDescription;
+    Manufacturer: typeof ProductCardManufacturer;
+    TextLabels: typeof ProductCardTextLabels;
+    Stock: typeof ProductCardStock;
+    Price: typeof ProductCardPrice;
+    AddToCart: typeof ProductCardAddToCart;
+};
+declare const ProductCard: ProductCardComponent;
+
+/**
+ * The controlled listing state for the spare-parts view — mirrors what the host
+ * derives from the URL (`page`/`offset`/`sort`/attribute-`filters`/`price`/`term`).
+ * Primitives + SDK enums only, so no app type leaks into the package.
+ */
+interface MachineListingState {
+    page: number;
+    offset: number;
+    sortField: ProductSortField | string;
+    sortOrder: SortOrder | string;
+    /** Attribute name → selected facet values. */
+    filters: Record<string, string[]>;
+    minPrice?: number;
+    maxPrice?: number;
+    term: string;
+}
+interface MachineGridProps {
+    /** Current URL path under the machines root, e.g. `['mixer','frame']`. `[]` = root. */
+    segments: string[];
+    /** Localized machines base path (e.g. `/nl/machines`) — used to build hrefs. */
+    basePath: string;
+    /** External system the installation ids belong to (root mode). */
+    source?: string;
+    /** Installation ids from `MY_INSTALLATIONS` (root mode). */
+    sourceIds?: string[];
+    /** Title for the root list. Defaults to `'Machines'`. */
+    rootTitle?: string;
+    /** Language the machine tree is authored in (usually EN). Defaults to `'EN'`. */
+    machineLanguage?: string;
+    listing: MachineListingState;
+    onListingChange: (next: MachineListingState) => void;
+    graphqlClient?: GraphQLClient;
+    user?: Contact | Customer | null;
+    companyId?: number;
+    /** Storefront language (parts). */
+    language?: string;
+    taxZone?: string;
+    configuration?: {
+        imageSearchFiltersGrid?: unknown;
+        imageVariantFiltersMedium?: unknown;
+    };
+    portalMode?: string;
+    cartId?: string;
+    createCart?: boolean;
+    onCartCreated?: (cart: Cart) => void;
+    /**
+     * Fired after every successful add-to-cart (adds into an EXISTING cart too, not
+     * just the first create). Forward this to `CartContext.saveCart` or the cart
+     * icon/sidebar/page won't reflect parts added from the grid — `onCartCreated`
+     * alone only fires when a brand-new cart is created.
+     */
+    afterAddToCart?: (cart: Cart, item?: CartMainItem) => void;
+    allowAddToCart?: boolean;
+    showPrice?: boolean;
+    showStock?: boolean;
+    showAvailability?: boolean;
+    onProductClick?: (product: Product) => void;
+    /**
+     * Custom card for the PARTS list, forwarded to the inner ProductGrid. Without
+     * it a product rendered with the host's custom card on a normal listing and
+     * with the stock card here, so the same product looked different depending on
+     * the page it was reached from (PWP-995c).
+     */
+    productCardComponent?: React$1.ComponentType<ProductCardProps>;
+    paginationLabels?: Record<string, string>;
+    filtersLabels?: Record<string, string>;
+    toolbarLabels?: Record<string, string>;
+    /**
+     * Labels for the machine side of the grid. Keys read here: `loading` and
+     * `noMachines`. The same object is passed to each `MachineCard` as its
+     * `labels`, which reads `viewMachine` — so all three keys belong in it.
+     */
+    machineCardLabels?: Record<string, string>;
+    /**
+     * Labels for the PARTS list, forwarded verbatim to the inner ProductGrid and
+     * the components it embeds.
+     *
+     * MachineGrid used to forward none of these and expose no way to reach them,
+     * so a translated storefront rendered "In stock", "Add" and "Search parts…"
+     * in English in the middle of its own copy. A monolingual shop never noticed
+     * (PWP-995a).
+     */
+    productCardLabels?: Record<string, string>;
+    addToCartLabels?: Record<string, string>;
+    stockLabels?: Record<string, string>;
+    priceLabels?: Record<string, string>;
+    labels?: Record<string, string>;
+    className?: string;
+}
+declare function MachineGrid(rawProps: MachineGridProps): React$1.JSX.Element;
+
+/**
+ * @rsc-blocked — Client-only component: side effects (useEffect).
+ * Must be rendered inside (or below) a Client Component boundary; cannot be
+ * imported directly into a React Server Component. The 'use client' header
+ * above marks this boundary to Next.js.
+ */
+
+/**
+ * A computed object containing a cluster config setting enriched with
+ * its current UI state: available values for drilldown, the currently
+ * selected value, and whether the selector should be disabled.
+ */
+interface ClusterConfiguratorProps {
+    /** The cluster ID this configurator belongs to. Required. */
+    clusterId: number;
+    /**
+     * All products that belong to the cluster. Required.
+     * Used to derive available values per attribute and to match
+     * the configured product when all selections are made.
+     */
+    products: Product[];
+    /**
+     * Cluster configuration object (`cluster.config`). Required.
+     * Provides the ordered list of attribute settings.
+     */
+    config: ClusterConfig;
+    /**
+     * Fired whenever the user completes a set of attribute selections
+     * that uniquely identifies a cluster product.
+     * Also fired whenever any selection changes and a matching product
+     * can already be determined (e.g. only one setting exists).
+     */
+    onConfigurationChange?: (product: Product) => void;
+    /** Default product to pre-populate the attribute selections on mount. */
+    defaultProduct?: Product;
+    /** Override any UI string. Available keys: selectOption */
+    labels?: Record<string, string>;
+    /** Extra CSS class applied to the root element. */
+    className?: string;
+}
+/**
+ * Renders attribute selectors (dropdown, radio, colour or image swatches) for
+ * configuring a cluster, narrowing available values as the user selects and
+ * emitting the matching product.
+ *
+ * @remarks Uses {@link useClusterConfigurator} to derive selectable values and
+ * resolve the configured product.
+ */
+declare function ClusterConfigurator(props: ClusterConfiguratorProps): React$1.JSX.Element;
+
+/**
+ * @rsc-blocked — Client-only component: side effects (useEffect).
+ * Must be rendered inside (or below) a Client Component boundary; cannot be
+ * imported directly into a React Server Component. The 'use client' header
+ * above marks this boundary to Next.js.
+ */
+
+interface ClusterInfoProps {
+    /** The authenticated user (Contact or Customer). Resolved from PropellerProvider when omitted. */
+    user?: Contact | Customer | null;
+    /**
+     * Pre-fetched cluster object to display.
+     * When provided the component skips internal fetching.
+     */
+    cluster?: Cluster;
+    /**
+     * Cluster ID to fetch data for when no `cluster` prop is provided.
+     * Requires `graphqlClient` to be set.
+     */
+    clusterId?: number;
+    /**
+     * Initialised Propeller SDK GraphQL client.
+     * Required when `clusterId` is provided for internal data fetching.
+     */
+    graphqlClient?: GraphQLClient;
+    /**
+     * Called once the cluster data is loaded — either immediately (when
+     * `cluster` prop is supplied) or after the internal fetch completes.
+     * Use this to hydrate sibling components (configurator, price, gallery, etc.).
+     */
+    onClusterLoaded?: (cluster: Cluster) => void;
+    /** Show the cluster name. Defaults to true. */
+    showTitle?: boolean;
+    /** Show the cluster SKU. Defaults to true. */
+    showSku?: boolean;
+    /** Language code used to resolve localised names. Defaults to 'NL'. */
+    language?: string;
+    /** Extra CSS class applied to the root element. */
+    className?: string;
+    /**
+     * Tax zone to use for price calculation.
+     */
+    taxZone?: string;
+    /**
+     * Image search filter passed to ProductService.getProduct().
+     * Controls how many image items are returned.
+     * Example: { page: 1, offset: 20 }
+     */
+    imageSearchFilters?: any;
+    /**
+     * Image variant transformation filter passed to ProductService.getProduct().
+     * Controls image size/format variants returned with the product.
+     * Example: imageVariantFiltersLarge from @/data/defaults
+     * Defaults to { transformations: [] } when omitted.
+     */
+    imageVariantFilters?: any;
+    /**
+     * Config object providing imageSearchFiltersGrid and imageVariantFiltersSmall.
+     */
+    configuration?: any;
+    /**
+     * Attribute codes/names to look up and display as badge overlays on the product image.
+     * Each code is resolved against `product.attributes.items[].attributeDescription.code`
+     * (or `.name`). Attributes with no matching value are silently omitted.
+     * Example: ['new', 'sale']
+     */
+    imageLabels?: string[];
+    /**
+     * Attribute codes/names to look up and display as extra text rows below the product name.
+     * Resolved the same way as `imageLabels`.
      * Example: ['brand', 'color']
      */
     textLabels?: string[];
@@ -4230,6 +4571,8 @@ interface CompanySwitcherProps {
     /** Translated labels keyed by the slugs used inside the component (see
      * `getLabel` calls). Missing keys fall back to the English defaults. */
     labels?: Record<string, string>;
+    /** Additional class name for the switcher's trigger button. */
+    triggerClassName?: string;
 }
 /**
  * Dropdown for switching the active company of a multi-company contact.
@@ -5836,6 +6179,12 @@ interface ProductBulkPricesProps {
      * Defaults to 'open'.
      */
     portalMode?: string;
+    /**
+     * Whether a session exists, independent of whether `user` has loaded yet.
+     * Passed down by the parent alongside `portalMode`; closes the hydration
+     * window in which an authenticated visitor still has a null `user`.
+     */
+    isAuthenticated?: boolean;
     /** Authenticated user — used for semi-closed visibility. */
     user?: Contact | Customer | null;
     /** Tax zone code. Defaults to 'NL'. */
@@ -5913,356 +6262,59 @@ interface ProductBundlesProps {
     /** When true, stock availability is validated before adding to cart. */
     stockValidation?: boolean;
     /**
-     * When true, the individual bundle items are listed inside each bundle card.
-     * Defaults to true.
-     */
-    showIndividualItems?: boolean;
-    /** Additional configuration object passed through to the component. */
-    configuration?: any;
-    /**
-     * Layout variant for the bundle display.
-     * - 'vertical' — stacked layout
-     * - 'horizontal' — side-by-side (default)
-     * - 'compact' — condensed, hides individual items
-     */
-    layout?: 'vertical' | 'horizontal' | 'compact';
-    /**
-     * Override any UI string.
-     * Available keys: title, condition_ALL, condition_EP, leaderItem,
-     * youSave, adding, addToCart, loginToSeePrices, addedToCart,
-     * modalTitle, continueShopping, proceedToCheckout, noCartId
-     */
-    labels?: Record<string, string>;
-    /**
-     * Show the "log in to see prices" prompt when prices are hidden.
-     * Defaults to true; pass false to render nothing in its place.
-     */
-    showLoginPrompt?: boolean;
-    /**
-     * When true a modal popup is shown after a successful add-to-cart
-     * with buttons to continue shopping or proceed to checkout.
-     * Defaults to false (only a brief inline toast is shown).
-     */
-    showModal?: boolean;
-    /** Callback fired when the "Proceed to checkout" modal button is clicked */
-    onProceedToCheckout?: () => void;
-    /**
-     * Callback triggered before adding the bundle to cart.
-     */
-    beforeBundleAddToCart?: (bundleId: string, quantity: number) => boolean;
-    /** Called when the user clicks "Add bundle to cart". Receives bundleId and quantity (always 1). */
-    onAddBundleToCart?: (bundleId: string, quantity: number) => void;
-    /**
-     * Callback triggered after adding the bundle to cart.
-     */
-    afterBundleAddToCart?: (cart: Cart, bundle?: Bundle) => void;
-    /** Extra CSS class applied to the root wrapper element. */
-    className?: string;
-}
-/**
- * Renders combo-deal bundles for a product, each with its constituent items,
- * pricing and savings, plus add-to-cart with toast or modal feedback.
- *
- * @remarks Uses {@link useProductBundles} to fetch bundles and add them to a cart.
- */
-declare function ProductBundles(rawProps: ProductBundlesProps): React$1.JSX.Element;
-
-/**
- * Props for the root `<ProductCard>` (and the back-compat monolithic
- * variant). Most fields are display toggles preserved for back-compat; in
- * the new compound API, consumers control rendering by composition instead
- * — see the Subcomponents section below.
- */
-interface ProductCardProps {
-    /** The product object to display */
-    product: Product;
-    /**
-     * Compound API: provide subcomponents as children. When omitted, the
-     * monolithic legacy layout renders based on the show*/ children?: React$1.ReactNode;
-    /** Show the product name. Defaults to true. */
-    showName?: boolean;
-    /** Show the product image. Defaults to true. */
-    showImage?: boolean;
-    /** Show the product short description. Defaults to false. */
-    showShortDescription?: boolean;
-    /** Show the product SKU. Defaults to true. */
-    showSku?: boolean;
-    /** Show the product manufacturer. Defaults to false. */
-    showManufacturer?: boolean;
-    /**
-     * Show the stock / availability widget below the product name.
-     * Uses the embedded `ItemStock` component driven by `product.inventory`.
-     * Defaults to false.
-     */
-    showStock?: boolean;
-    /**
-     * Show only the availability indicator (Available / Not available) inside ItemStock.
-     * Only relevant when `showStock` is true.
-     * Defaults to true.
-     */
-    showAvailability?: boolean;
-    /**
-     * Show the price below the product name.
-     * Defaults to true.
-     */
-    showPrice?: boolean;
-    /**
-     * Show the AddToCart component.
-     * Defaults to true.
-     */
-    allowAddToCart?: boolean;
-    /**
-     * Label overrides forwarded to the embedded ItemStock component.
-     * Keys: inStock, outOfStock, lowStock, available, notAvailable, pieces
-     */
-    stockLabels?: Record<string, string>;
-    /**
-     * Attribute codes/names to look up and display as badge overlays on the product image.
-     * Example: ['new', 'sale']
-     */
-    imageLabels?: string[];
-    /**
-     * Attribute codes/names to look up and display as extra text rows below the product name.
-     * Example: ['brand', 'color']
-     */
-    textLabels?: string[];
-    /** Override any UI string. Keys: addToFavorites, removeFromFavorites */
-    labels?: Record<string, string>;
-    /** Renders a heart-icon toggle button on the product image. Defaults to false. */
-    enableAddFavorite?: boolean;
-    /** Called whenever the favourite state is toggled. */
-    onToggleFavorite?: (product: Product, isFavorite: boolean) => void;
-    /**
-     * Called when the product name or image is clicked.
-     * When provided, the default `<a>` navigation is prevented.
+     * When true, the individual bundle items are listed inside each bundle card.
+     * Defaults to true.
      */
-    onProductClick?: (product: Product) => void;
-    /** When true, tax-inclusive (net) price is the leading price. Defaults to false. */
-    includeTax?: boolean;
-    /** Number of grid columns — when 1 the card renders as a compact horizontal row. */
-    columns?: number;
-    /** Extra CSS class applied to the root element. */
-    className?: string;
+    showIndividualItems?: boolean;
+    /** Additional configuration object passed through to the component. */
+    configuration?: any;
     /**
-     * URL pattern controlling which segments appear in product links.
-     * Tokens: page → 'product', id → productId, slug → slug value.
-     * Defaults to 'page/id/slug'.
+     * Layout variant for the bundle display.
+     * - 'vertical' — stacked layout
+     * - 'horizontal' — side-by-side (default)
+     * - 'compact' — condensed, hides individual items
      */
-    urlPattern?: string;
-    /** GraphQL client for the embedded AddToCart. Resolved from PropellerProvider when omitted. */
-    graphqlClient?: GraphQLClient;
-    /** Authenticated user. Resolved from PropellerProvider when omitted. */
-    user?: Contact | Customer | null;
+    layout?: 'vertical' | 'horizontal' | 'compact';
     /**
-     * Portal access mode — `'open'` / `'semi-closed'` / `'closed'`. Resolved from
-     * PropellerProvider when omitted. In `'semi-closed'` the card hides price and
-     * stock from anonymous visitors and offers a log-in action in place of
-     * add-to-cart; signed-in users are unaffected.
+     * Override any UI string.
+     * Available keys: title, condition_ALL, condition_EP, leaderItem,
+     * youSave, adding, addToCart, loginToSeePrices, addedToCart,
+     * modalTitle, continueShopping, proceedToCheckout, noCartId
      */
-    portalMode?: string;
+    labels?: Record<string, string>;
     /**
-     * Invoked when an anonymous visitor clicks the log-in action that replaces
-     * add-to-cart in a semi-closed portal. The host owns navigation.
+     * Show the "log in to see prices" prompt when prices are hidden.
+     * Defaults to true; pass false to render nothing in its place.
+     */
+    showLoginPrompt?: boolean;
+    /**
+     * When true a modal popup is shown after a successful add-to-cart
+     * with buttons to continue shopping or proceed to checkout.
+     * Defaults to false (only a brief inline toast is shown).
      */
-    onLoginClick?: () => void;
-    /** ID of the cart that add-to-cart targets. */
-    cartId?: string;
-    /** Configuration object (URL builders, image filters, etc.). */
-    configuration?: any;
-    /** Cluster ID when this card represents a variant of a product cluster. */
-    clusterId?: number;
-    /** Pre-selected child item product IDs added alongside the product. */
-    childItems?: number[];
-    /** Order-line notes forwarded with the add-to-cart request. */
-    notes?: string;
-    /** Custom price override forwarded with the add-to-cart request. */
-    price?: number;
-    /** When true, a new cart is created if no `cartId` is set. */
-    createCart?: boolean;
-    /** Fires when add-to-cart creates a new cart. */
-    onCartCreated?: (cart: Cart) => void;
-    /** Delegation handler — when provided, the parent performs the add-to-cart itself. */
-    onAddToCart?: (product: Product, clusterId?: number, quantity?: number, childItems?: CartChildItemInput[], notes?: string, price?: number, showModal?: boolean) => Cart;
-    /** Fires after an item has been added to the cart. */
-    afterAddToCart?: (cart: Cart, item?: CartMainItem) => void;
-    /** When true, show a confirmation modal after add-to-cart instead of a toast. */
     showModal?: boolean;
-    /** When true, the AddToCart shows quantity increment/decrement controls. */
-    allowIncrDecr?: boolean;
-    /** When true, stock availability is validated before adding to cart. */
-    enableStockValidation?: boolean;
-    /** Language code for localised content. Resolved from PropellerProvider when omitted. */
-    language?: string;
-    /** Active company ID from the company switcher. */
-    companyId?: number;
-    /** Fires when the "Proceed to checkout" modal button is clicked. */
+    /** Callback fired when the "Proceed to checkout" modal button is clicked */
     onProceedToCheckout?: () => void;
-    /** Fires when the user requests a quote from the AddToCart modal. */
-    onRequestQuoteClick?: (cart: Cart) => void;
-    /** Label overrides forwarded to the embedded AddToCart component. */
-    addToCartLabels?: Record<string, string>;
-    /** Translated labels forwarded to the embedded `<ProductPrice>` display.
-     * See `ProductPriceProps.labels` for slugs (inclTax, exclTax, loginToSeePrices). */
-    priceLabels?: Record<string, string>;
-    /** Replaces the default price block. Receives `PriceComponentProps`. */
-    /** Currency symbol used when formatting the price. Falls back to PropellerInfra.currency, then `'€'`. */
-    currency?: string;
-    priceComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.PriceComponentProps>;
-    /** Replaces the default stock/availability block. Receives `StockComponentProps`. */
-    stockComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.StockComponentProps>;
-    /** Replaces the default add-to-cart control. Receives `AddToCartComponentProps`. */
-    addToCartComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.AddToCartComponentProps>;
-    /** Replaces the default product image block. Receives `ImageComponentProps`. */
-    imageComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.ImageComponentProps>;
-    /** Replaces the default product badges block. Receives `BadgesComponentProps`. */
-    badgesComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.BadgesComponentProps>;
-    /** Replaces the default favorite-toggle. Receives `FavoriteComponentProps`. */
-    favoriteComponent?: React$1.ComponentType<_propeller_commerce_propeller_v2_core_ui.FavoriteComponentProps>;
     /**
-     * Render arbitrary content directly below the product name (and above the
-     * short description / price), in both the grid and row layouts. Receives the
-     * product so hosts can surface extra info — e.g. package descriptions, custom
-     * badges — without forking the card. Return `null`/`undefined` to render
-     * nothing for a given product.
+     * Callback triggered before adding the bundle to cart.
      */
-    belowName?: (product: Product) => React$1.ReactNode;
-}
-/**
- * Root of the `<ProductCard>` compound component. Renders either the
- * consumer-composed children (compound mode) or the legacy monolithic layout
- * driven by `show*`/`allow*` toggles, and provides the shared card context.
- */
-declare function ProductCardRoot(rawProps: ProductCardProps): React$1.JSX.Element;
-/**
- * Product image with optional badge overlays and favourite button.
- * Reads `derived.imageUrl`, `derived.imageLabelValues`, `derived.productUrl`,
- * and the `favorite` state from context.
- *
- * Trade-off: when `imageComponent` is injected, the consumer takes over the
- * ENTIRE image area — including the badge / favorite overlay layer.
- * The default markup wraps the `<img>` in a link with absolute-positioned
- * badges and a favorite button; an injected component receives only the
- * `ImageComponentProps` contract and is free to re-render those overlays
- * itself (e.g. by composing `<DefaultProductBadges>` / `<DefaultAddToFavorite>`)
- * or omit them entirely.
- */
-declare function ProductCardImage(props: {
-    /** Override the wrapper class. */
-    className?: string;
-    /** Render the favourite heart button. Defaults to context `enableAddFavorite`. */
-    showFavorite?: boolean;
-}): React$1.JSX.Element;
-/** Image-overlay badge list (e.g. "new", "sale" attributes), or the
- *  injected `badgesComponent` from context when set. */
-declare function ProductCardBadges(props: {
-    /** Override the badge container class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Favourite (heart) toggle button — typically placed inside `<ProductCard.Image>`,
- *  or the injected `favoriteComponent` from context when set.
- *
- *  The default render is the inline self-contained heart button (local state
- *  only, fires `onToggleFavorite`); the injected variant receives the full
- *  `FavoriteComponentProps` contract (product, user, callback) so consumers
- *  can plug in real favorite-list mutations. The unused import of
- *  `DefaultAddToFavoriteImpl` is kept so consumers can wrap-and-call it. */
-declare function ProductCardFavorite(props: {
-    /** Override the button class. */
-    className?: string;
-}): React$1.JSX.Element;
-/** Product name. `linkable` (default true) wraps it in an `<a>` to the PDP. */
-declare function ProductCardName(props: {
-    /** When true (default), wraps the name in a link to the product page. */
-    linkable?: boolean;
-    /** Override the name element class. */
-    className?: string;
-}): React$1.JSX.Element;
-/** Renders the product SKU. */
-declare function ProductCardSku(props: {
-    /** Override the SKU element class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Renders the product's short description. */
-declare function ProductCardShortDescription(props: {
-    /** Override the description element class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Renders the product manufacturer name. */
-declare function ProductCardManufacturer(props: {
-    /** Override the manufacturer element class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Renders the resolved `textLabels` attribute values as text rows. */
-declare function ProductCardTextLabels(props: {
-    /** Override the label container class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Renders the embedded stock/availability widget for the product, or the
- *  injected `stockComponent` from context when set. */
-declare function ProductCardStock(props: {
-    /** Show only the availability indicator. Defaults to context `showAvailability`. */
-    showAvailability?: boolean;
-}): React$1.JSX.Element | null;
-/** Renders host-supplied content directly below the name, via the `belowName`
- *  render prop (explicit or from grid context). Renders nothing when unset or
- *  when the render prop returns a nullish value. */
-declare function ProductCardBelowName(): React$1.JSX.Element | null;
-/** Renders the product price via the embedded `ProductPrice` component, or
- *  the injected `priceComponent` from context when set. */
-declare function ProductCardPrice(props: {
-    /** Tailwind text-size class for the price. Defaults to `'text-base sm:text-lg'`. */
-    priceSize?: string;
-    /** Override the price wrapper class. */
-    className?: string;
-}): React$1.JSX.Element | null;
-/** Renders the embedded `AddToCart` control with all pass-through props from
- *  context, or the injected `addToCartComponent` when set.
- *
- *  Note: the default `AddToCartImpl` accepts a richer prop set (graphqlClient,
- *  configuration, etc.) than the public `AddToCartComponentProps` contract.
- *  Injected components only receive the contract surface; the extra infra
- *  props stay default-only. */
-declare function ProductCardAddToCart(props: {
-    /** Override the AddToCart wrapper class. */
+    beforeBundleAddToCart?: (bundleId: string, quantity: number) => boolean;
+    /** Called when the user clicks "Add bundle to cart". Receives bundleId and quantity (always 1). */
+    onAddBundleToCart?: (bundleId: string, quantity: number) => void;
+    /**
+     * Callback triggered after adding the bundle to cart.
+     */
+    afterBundleAddToCart?: (cart: Cart, bundle?: Bundle) => void;
+    /** Extra CSS class applied to the root wrapper element. */
     className?: string;
-}): React$1.JSX.Element;
-declare const MemoizedRoot: React$1.MemoExoticComponent<typeof ProductCardRoot>;
+}
 /**
- * Compound component. Use either:
- *
- *  **Compound mode (new — preferred):**
- *  ```tsx
- *  <ProductCard product={p}>
- *    <ProductCard.Image variant="grid" />
- *    <ProductCard.Name linkable />
- *    <ProductCard.Sku />
- *    <ProductCard.Price />
- *    <ProductCard.AddToCart />
- *  </ProductCard>
- *  ```
+ * Renders combo-deal bundles for a product, each with its constituent items,
+ * pricing and savings, plus add-to-cart with toast or modal feedback.
  *
- *  **Legacy mode (deprecated — kept for back-compat):**
- *  ```tsx
- *  <ProductCard product={p} showName showPrice allowAddToCart />
- *  ```
- *  All the show* / allow* toggles still work and render the canonical layout
- *  using the compound subcomponents internally.
+ * @remarks Uses {@link useProductBundles} to fetch bundles and add them to a cart.
  */
-type ProductCardComponent = typeof MemoizedRoot & {
-    Image: typeof ProductCardImage;
-    Badges: typeof ProductCardBadges;
-    Favorite: typeof ProductCardFavorite;
-    Name: typeof ProductCardName;
-    Sku: typeof ProductCardSku;
-    BelowName: typeof ProductCardBelowName;
-    ShortDescription: typeof ProductCardShortDescription;
-    Manufacturer: typeof ProductCardManufacturer;
-    TextLabels: typeof ProductCardTextLabels;
-    Stock: typeof ProductCardStock;
-    Price: typeof ProductCardPrice;
-    AddToCart: typeof ProductCardAddToCart;
-};
-declare const ProductCard: ProductCardComponent;
+declare function ProductBundles(rawProps: ProductBundlesProps): React$1.JSX.Element;
 
 /**
  * @rsc-blocked — Client-only component: interactive state (useState/useReducer).
@@ -6672,6 +6724,15 @@ interface ProductInfoProps {
      * Example: ['brand', 'color']
      */
     textLabels?: string[];
+    /** Cart to add into. Omit and pass `createCart` to start one on first add. */
+    cartId?: string;
+    /** If true a new cart is created when no `cartId` is available. */
+    createCart?: boolean;
+    /**
+     * Called when a new cart is created, so the host can persist `cart.cartId`.
+     * WARNING: without it a new cart is created on every add.
+     */
+    onCartCreated?: (cart: Cart) => void;
     showImage?: boolean;
     showBadges?: boolean;
     showFavorite?: boolean;
@@ -6815,6 +6876,12 @@ interface ProductPriceProps {
      * Defaults to 'open'.
      */
     portalMode?: string;
+    /**
+     * Whether a session exists, independent of whether `user` has loaded yet.
+     * Passed down by the parent alongside `portalMode`; closes the hydration
+     * window in which an authenticated visitor still has a null `user`.
+     */
+    isAuthenticated?: boolean;
     /** Authenticated user — used for semi-closed visibility. */
     user?: Contact | Customer | null;
     /**