@propeller-commerce/propeller-v2-react-ui 0.11.0 → 0.11.1

package/dist/index.d.cts

@@ -4973,10 +4973,32 @@ interface MenuProps {
     menuClass?: string;
     /**
      * Main menu display type.
-     * - 'dropdown-vertical': nested flyout panels on hover (default)
-     * - 'jumbotron': full-width mega-menu panel showing all subcategories
+     * - 'dropdown-vertical': nested flyout panels on hover (default). Lays each
+     *   level out as another 256px column, so it caps at 5 levels.
+     * - 'jumbotron': full-width mega-menu panel showing all subcategories.
+     * - 'accordion': inline vertical nesting at every breakpoint. The only style
+     *   with no depth ceiling — use it for trees deeper than a flyout can show.
+     *   (Also the mobile presentation of the other styles.)
+     *
+     * Typed as `MenuStyle | (string & {})` so the built-ins autocomplete while
+     * any other value still type-checks — pair a custom value with
+     * {@link MenuProps.renderMenu} to render it. Without `renderMenu`, an
+     * unrecognised value falls back to 'accordion' and warns in development.
+     */
+    menuStyle?: MenuStyle | (string & {});
+    /**
+     * Render the menu yourself instead of using a built-in `menuStyle`.
+     *
+     * The built-in styles cover the common shapes, but they are just three
+     * arrangements of the same tree — this is the escape hatch for a fourth.
+     * Receives the fetched categories plus the state and helpers the built-in
+     * renderers use, so a custom menu gets working open/close behaviour, URL
+     * building and click handling without reimplementing them.
+     *
+     * Return `null` to fall through to the `menuStyle` rendering (useful for
+     * overriding a single breakpoint or category).
      */
-    menuStyle?: string;
+    renderMenu?: (ctx: MenuRenderContext) => React$1.ReactNode;
     /**
      * URL pattern for category links.
      * Use `{categoryId}` and `{slug}` as placeholders.
@@ -5010,9 +5032,50 @@ interface MenuProps {
     /** Configuration object passed to the component */
     configuration?: any;
 }
+/** Every style with a built-in renderer — the source of truth for the union. */
+declare const RENDERED_STYLES: readonly ["dropdown-vertical", "jumbotron", "accordion"];
+type MenuStyle = (typeof RENDERED_STYLES)[number];
 /**
- * Renders a multi-level category navigation menu (dropdown flyout or jumbotron
- * mega-menu on desktop, accordion on mobile) from the fetched category tree.
+ * Everything a custom `renderMenu` needs to draw the tree: the data, the
+ * open/close state, and the same helpers the built-in styles use.
+ *
+ * Exposing the helpers rather than just the categories is the point — URL
+ * building respects `getUrl`/`configuration`, `handleItemClick` honours
+ * `onMenuItemClick`, and the `openPath` helpers give working expand/collapse.
+ * A custom renderer that only got `categories` would have to reimplement all
+ * of that and would drift from the built-ins.
+ */
+interface MenuRenderContext {
+    /** Root-level categories of the fetched tree. */
+    categories: MenuCategory[];
+    /** True while the internal fetch is in flight (never when `tree` is passed). */
+    isLoading: boolean;
+    /** True when the internal fetch failed. */
+    hasError: boolean;
+    /** Levels that may be rendered, after the style's cap is applied. */
+    maxDepth: number;
+    /** Children of `cat`, minus entries with no name or slug. */
+    getSubCategories: (cat: MenuCategory) => MenuCategory[];
+    /** Localised display name. */
+    getCategoryName: (cat: MenuCategory) => string;
+    /** Href honouring `getUrl` when provided, else `configuration.urls`. */
+    getCategoryUrl: (cat: MenuCategory) => string;
+    /** Click handler that fires `onMenuItemClick` and suppresses navigation. */
+    handleItemClick: (cat: MenuCategory, e: React$1.MouseEvent) => void;
+    /** Currently open branch as category ids, root → deepest. */
+    openPath: number[];
+    /** Is `categoryId` the open branch at `level` (0-based)? */
+    isOpenAt: (level: number, categoryId: number) => boolean;
+    /** Open a branch at `level`, closing anything deeper. Pass null to close. */
+    openAt: (level: number, categoryId: number | null) => void;
+    /** Toggle a branch at `level` — the accordion's click behaviour. */
+    toggleAt: (level: number, categoryId: number) => void;
+}
+/**
+ * Renders a multi-level category navigation menu from the fetched category
+ * tree: a dropdown flyout or jumbotron mega-menu on desktop, an accordion on
+ * mobile — or an accordion on every breakpoint when `menuStyle="accordion"`,
+ * which is the option to pick for trees deeper than a flyout can lay out.
  *
  * @remarks Uses {@link useMenu} to fetch the category hierarchy.
  */
@@ -7319,4 +7382,4 @@ declare function DefaultProductBadges(props: BadgesComponentProps): React__defau
  */
 declare function DefaultProductSurcharges(props: ProductSurchargesComponentProps): React__default.JSX.Element | null;
 
-export { AccountIconAndMenu, type AccountIconAndMenuProps, ActionCode, type ActionCodeProps, type AddContactFormState, type AddItemOptions, _default$1 as AddToCart, type AddToCartProps, AddToFavorite, type AddToFavoriteProps, AddressCardExport as AddressCard, type AddressCardProps, type AddressInput, AddressSelector, type AddressSelectorProps, type AttributeDisplayItem, type AttributeGroup, BreadcrumbsWithProvider as Breadcrumbs, type BreadcrumbsProps, CartBonusItems, type CartBonusItemsProps, CartCarriers, type CartCarriersProps, CartIconAndSidebar, type CartIconAndSidebarProps, type CartInitConfig, CartItemExport as CartItem, type CartItemProps, CartOverview, type CartOverviewProps, CartPaymethods, type CartPaymethodsProps, CartSummary, type CartSummaryProps, CategoryDescription, type CategoryDescriptionProps, CategoryShortDescriptionWithProvider as CategoryShortDescription, type CategoryShortDescriptionProps, ClusterCardExport as ClusterCard, type ClusterCardProps, ClusterConfigurator, type ClusterConfiguratorProps, ClusterInfo, type ClusterInfoProps, ClusterOptions, type ClusterOptionsProps, CompanySwitcher, type CompanySwitcherProps, type ConfiguredSetting, _default$1 as DefaultAddToCart, AddToFavorite as DefaultAddToFavorite, _default as DefaultItemStock, DefaultProductBadges, ProductBulkPrices as DefaultProductBulkPrices, ProductBundles as DefaultProductBundles, DefaultProductImage, ProductPriceDisplay as DefaultProductPrice, DefaultProductSurcharges, DeliveryDate, type DeliveryDateProps, FavoriteListDetails, type FavoriteListDetailsProps, type FavoriteListFormData, FavoriteListItemExport as FavoriteListItem, type FavoriteListItemProps, FavoriteLists, type FavoriteListsProps, type FetchActiveCartConfig, type FetchCrossupsellsInput, ForgotPassword, type ForgotPasswordProps, type GetCrossupsellsOptions, GridFilters, GridFiltersPanel, type GridFiltersPanelProps, type GridFiltersProps, GridPagination, type GridPaginationProps, GridTitleWithProvider as GridTitle, type GridTitleProps, GridToolbar, type GridToolbarProps, _default as ItemStock, type ItemStockProps, ItemsOverview, type ItemsOverviewProps, LoginFormExport as LoginForm, type LoginFormProps, LoginToOrderButton, type LoginToOrderButtonProps, MachineCard, type MachineCardProps, MachineGrid, type MachineGridProps, type MachineListingState, Menu, type MenuCategory, type MenuProps, OrderActions, type OrderActionsProps, OrderBonusItems, type OrderBonusItemsProps, OrderItemCard, type OrderItemCardProps, OrderList, type OrderListProps, type OrderSearchForm, OrderShipments, type OrderShipmentsProps, OrderSummary, type OrderSummaryProps, OrderTotals, type OrderTotalsProps, type PlaceOrderOptions, PriceToggle, type PriceToggleProps, ProductBulkPricesWithProvider as ProductBulkPrices, type ProductBulkPricesProps, ProductBundles, type ProductBundlesProps, ProductCard, type ProductCardProps, ProductDescription, type ProductDescriptionProps, ProductDownloads, type ProductDownloadsProps, ProductGallery, type ProductGalleryProps, ProductGridCompound as ProductGrid, type ProductGridConfig, ProductGridConfigProvider, type ProductGridProps, ProductInfoExport as ProductInfo, type ProductInfoProps, ProductPriceWithProvider as ProductPrice, type ProductPriceProps, ProductShortDescriptionWithProvider as ProductShortDescription, type ProductShortDescriptionProps, ProductSlider, type ProductSliderProps, ProductSpecifications, type ProductSpecificationsProps, ProductTabs, type ProductTabsProps, ProductVideos, type ProductVideosProps, type PropellerDeps, PropellerDepsProvider, type PropellerDepsProviderProps, type PropellerInfra, PropellerProvider, type PropellerProviderProps, type PropellerScope, PurchaseAuthorizationConfigurator, type PurchaseAuthorizationConfiguratorProps, PurchaseAuthorizationRequests, type PurchaseAuthorizationRequestsProps, QuickOrder, type QuickOrderLine, type QuickOrderMatch, type QuickOrderProps, type QuickOrderSubmitResult, type QuickOrderUploadLine, QuoteActions, type QuoteActionsProps, RegisterForm, type RegisterFormProps, type ResolveSpec, type RowEdit, SearchBar, type SearchBarProps, type UseAddressOptions, type UseAddressReturn, type LoginResult as UseAuthLoginResult, type UseAuthOptions, type RegisterContactInput as UseAuthRegisterContactInput, type RegisterCustomerInput as UseAuthRegisterCustomerInput, type UseAuthReturn, type UseCartOptions, type UseCartReturn, type UseCheckoutOptions, type UseCheckoutReturn, type UseClusterConfiguratorOptions, type UseClusterConfiguratorReturn, type UseCompanyOptions, type UseCompanyReturn, type UseFavoritesOptions, type UseFavoritesReturn, type UseMachinesOptions, type UseMachinesReturn, type UseMenuOptions, type UseMenuReturn, type UseOrdersOptions, type UseOrdersReturn, type BundleItem as UseProductBundlesBundleItem, type UseProductBundlesOptions, type UseProductBundlesReturn, type UseProductInfoOptions, type UseProductInfoReturn, type UseProductSearchOptions, type UseProductSearchReturn, type UseProductSliderOptions, type UseProductSliderReturn, type UseProductSpecsOptions, type UseProductSpecsReturn, type UsePurchaseAuthorizationConfiguratorOptions, type UsePurchaseAuthorizationConfiguratorReturn, type UsePurchaseAuthorizationRequestsOptions, type UsePurchaseAuthorizationRequestsReturn, type UseQuickOrderOptions, type UseQuickOrderReturn, type UseSparePartsOptions, type UseSparePartsReturn, UserDetails, type UserDetailsProps, buildRootMachinesQuery, fetchActiveCart, initCart, mergeAnonymousCart, useAddress, useAuth, useCart, useCheckout, useClusterConfigurator, useCompany, useFavorites, useInfraProps, useMachines, useMenu, useOrders, useProductBundles, useProductGridConfig, useProductInfo, useProductSearch, useProductSlider, useProductSpecs, usePropellerContext, usePropellerDeps, usePropellerScope, usePurchaseAuthorizationConfigurator, usePurchaseAuthorizationRequests, useQuickOrder, useRequiredPropellerDeps, useResolvedProps, useServices, useSpareParts, useUserMode };
+export { AccountIconAndMenu, type AccountIconAndMenuProps, ActionCode, type ActionCodeProps, type AddContactFormState, type AddItemOptions, _default$1 as AddToCart, type AddToCartProps, AddToFavorite, type AddToFavoriteProps, AddressCardExport as AddressCard, type AddressCardProps, type AddressInput, AddressSelector, type AddressSelectorProps, type AttributeDisplayItem, type AttributeGroup, BreadcrumbsWithProvider as Breadcrumbs, type BreadcrumbsProps, CartBonusItems, type CartBonusItemsProps, CartCarriers, type CartCarriersProps, CartIconAndSidebar, type CartIconAndSidebarProps, type CartInitConfig, CartItemExport as CartItem, type CartItemProps, CartOverview, type CartOverviewProps, CartPaymethods, type CartPaymethodsProps, CartSummary, type CartSummaryProps, CategoryDescription, type CategoryDescriptionProps, CategoryShortDescriptionWithProvider as CategoryShortDescription, type CategoryShortDescriptionProps, ClusterCardExport as ClusterCard, type ClusterCardProps, ClusterConfigurator, type ClusterConfiguratorProps, ClusterInfo, type ClusterInfoProps, ClusterOptions, type ClusterOptionsProps, CompanySwitcher, type CompanySwitcherProps, type ConfiguredSetting, _default$1 as DefaultAddToCart, AddToFavorite as DefaultAddToFavorite, _default as DefaultItemStock, DefaultProductBadges, ProductBulkPrices as DefaultProductBulkPrices, ProductBundles as DefaultProductBundles, DefaultProductImage, ProductPriceDisplay as DefaultProductPrice, DefaultProductSurcharges, DeliveryDate, type DeliveryDateProps, FavoriteListDetails, type FavoriteListDetailsProps, type FavoriteListFormData, FavoriteListItemExport as FavoriteListItem, type FavoriteListItemProps, FavoriteLists, type FavoriteListsProps, type FetchActiveCartConfig, type FetchCrossupsellsInput, ForgotPassword, type ForgotPasswordProps, type GetCrossupsellsOptions, GridFilters, GridFiltersPanel, type GridFiltersPanelProps, type GridFiltersProps, GridPagination, type GridPaginationProps, GridTitleWithProvider as GridTitle, type GridTitleProps, GridToolbar, type GridToolbarProps, _default as ItemStock, type ItemStockProps, ItemsOverview, type ItemsOverviewProps, LoginFormExport as LoginForm, type LoginFormProps, LoginToOrderButton, type LoginToOrderButtonProps, MachineCard, type MachineCardProps, MachineGrid, type MachineGridProps, type MachineListingState, Menu, type MenuCategory, type MenuProps, type MenuRenderContext, type MenuStyle, OrderActions, type OrderActionsProps, OrderBonusItems, type OrderBonusItemsProps, OrderItemCard, type OrderItemCardProps, OrderList, type OrderListProps, type OrderSearchForm, OrderShipments, type OrderShipmentsProps, OrderSummary, type OrderSummaryProps, OrderTotals, type OrderTotalsProps, type PlaceOrderOptions, PriceToggle, type PriceToggleProps, ProductBulkPricesWithProvider as ProductBulkPrices, type ProductBulkPricesProps, ProductBundles, type ProductBundlesProps, ProductCard, type ProductCardProps, ProductDescription, type ProductDescriptionProps, ProductDownloads, type ProductDownloadsProps, ProductGallery, type ProductGalleryProps, ProductGridCompound as ProductGrid, type ProductGridConfig, ProductGridConfigProvider, type ProductGridProps, ProductInfoExport as ProductInfo, type ProductInfoProps, ProductPriceWithProvider as ProductPrice, type ProductPriceProps, ProductShortDescriptionWithProvider as ProductShortDescription, type ProductShortDescriptionProps, ProductSlider, type ProductSliderProps, ProductSpecifications, type ProductSpecificationsProps, ProductTabs, type ProductTabsProps, ProductVideos, type ProductVideosProps, type PropellerDeps, PropellerDepsProvider, type PropellerDepsProviderProps, type PropellerInfra, PropellerProvider, type PropellerProviderProps, type PropellerScope, PurchaseAuthorizationConfigurator, type PurchaseAuthorizationConfiguratorProps, PurchaseAuthorizationRequests, type PurchaseAuthorizationRequestsProps, QuickOrder, type QuickOrderLine, type QuickOrderMatch, type QuickOrderProps, type QuickOrderSubmitResult, type QuickOrderUploadLine, QuoteActions, type QuoteActionsProps, RegisterForm, type RegisterFormProps, type ResolveSpec, type RowEdit, SearchBar, type SearchBarProps, type UseAddressOptions, type UseAddressReturn, type LoginResult as UseAuthLoginResult, type UseAuthOptions, type RegisterContactInput as UseAuthRegisterContactInput, type RegisterCustomerInput as UseAuthRegisterCustomerInput, type UseAuthReturn, type UseCartOptions, type UseCartReturn, type UseCheckoutOptions, type UseCheckoutReturn, type UseClusterConfiguratorOptions, type UseClusterConfiguratorReturn, type UseCompanyOptions, type UseCompanyReturn, type UseFavoritesOptions, type UseFavoritesReturn, type UseMachinesOptions, type UseMachinesReturn, type UseMenuOptions, type UseMenuReturn, type UseOrdersOptions, type UseOrdersReturn, type BundleItem as UseProductBundlesBundleItem, type UseProductBundlesOptions, type UseProductBundlesReturn, type UseProductInfoOptions, type UseProductInfoReturn, type UseProductSearchOptions, type UseProductSearchReturn, type UseProductSliderOptions, type UseProductSliderReturn, type UseProductSpecsOptions, type UseProductSpecsReturn, type UsePurchaseAuthorizationConfiguratorOptions, type UsePurchaseAuthorizationConfiguratorReturn, type UsePurchaseAuthorizationRequestsOptions, type UsePurchaseAuthorizationRequestsReturn, type UseQuickOrderOptions, type UseQuickOrderReturn, type UseSparePartsOptions, type UseSparePartsReturn, UserDetails, type UserDetailsProps, buildRootMachinesQuery, fetchActiveCart, initCart, mergeAnonymousCart, useAddress, useAuth, useCart, useCheckout, useClusterConfigurator, useCompany, useFavorites, useInfraProps, useMachines, useMenu, useOrders, useProductBundles, useProductGridConfig, useProductInfo, useProductSearch, useProductSlider, useProductSpecs, usePropellerContext, usePropellerDeps, usePropellerScope, usePurchaseAuthorizationConfigurator, usePurchaseAuthorizationRequests, useQuickOrder, useRequiredPropellerDeps, useResolvedProps, useServices, useSpareParts, useUserMode };

package/dist/index.d.ts

@@ -4973,10 +4973,32 @@ interface MenuProps {
     menuClass?: string;
     /**
      * Main menu display type.
-     * - 'dropdown-vertical': nested flyout panels on hover (default)
-     * - 'jumbotron': full-width mega-menu panel showing all subcategories
+     * - 'dropdown-vertical': nested flyout panels on hover (default). Lays each
+     *   level out as another 256px column, so it caps at 5 levels.
+     * - 'jumbotron': full-width mega-menu panel showing all subcategories.
+     * - 'accordion': inline vertical nesting at every breakpoint. The only style
+     *   with no depth ceiling — use it for trees deeper than a flyout can show.
+     *   (Also the mobile presentation of the other styles.)
+     *
+     * Typed as `MenuStyle | (string & {})` so the built-ins autocomplete while
+     * any other value still type-checks — pair a custom value with
+     * {@link MenuProps.renderMenu} to render it. Without `renderMenu`, an
+     * unrecognised value falls back to 'accordion' and warns in development.
+     */
+    menuStyle?: MenuStyle | (string & {});
+    /**
+     * Render the menu yourself instead of using a built-in `menuStyle`.
+     *
+     * The built-in styles cover the common shapes, but they are just three
+     * arrangements of the same tree — this is the escape hatch for a fourth.
+     * Receives the fetched categories plus the state and helpers the built-in
+     * renderers use, so a custom menu gets working open/close behaviour, URL
+     * building and click handling without reimplementing them.
+     *
+     * Return `null` to fall through to the `menuStyle` rendering (useful for
+     * overriding a single breakpoint or category).
      */
-    menuStyle?: string;
+    renderMenu?: (ctx: MenuRenderContext) => React$1.ReactNode;
     /**
      * URL pattern for category links.
      * Use `{categoryId}` and `{slug}` as placeholders.
@@ -5010,9 +5032,50 @@ interface MenuProps {
     /** Configuration object passed to the component */
     configuration?: any;
 }
+/** Every style with a built-in renderer — the source of truth for the union. */
+declare const RENDERED_STYLES: readonly ["dropdown-vertical", "jumbotron", "accordion"];
+type MenuStyle = (typeof RENDERED_STYLES)[number];
 /**
- * Renders a multi-level category navigation menu (dropdown flyout or jumbotron
- * mega-menu on desktop, accordion on mobile) from the fetched category tree.
+ * Everything a custom `renderMenu` needs to draw the tree: the data, the
+ * open/close state, and the same helpers the built-in styles use.
+ *
+ * Exposing the helpers rather than just the categories is the point — URL
+ * building respects `getUrl`/`configuration`, `handleItemClick` honours
+ * `onMenuItemClick`, and the `openPath` helpers give working expand/collapse.
+ * A custom renderer that only got `categories` would have to reimplement all
+ * of that and would drift from the built-ins.
+ */
+interface MenuRenderContext {
+    /** Root-level categories of the fetched tree. */
+    categories: MenuCategory[];
+    /** True while the internal fetch is in flight (never when `tree` is passed). */
+    isLoading: boolean;
+    /** True when the internal fetch failed. */
+    hasError: boolean;
+    /** Levels that may be rendered, after the style's cap is applied. */
+    maxDepth: number;
+    /** Children of `cat`, minus entries with no name or slug. */
+    getSubCategories: (cat: MenuCategory) => MenuCategory[];
+    /** Localised display name. */
+    getCategoryName: (cat: MenuCategory) => string;
+    /** Href honouring `getUrl` when provided, else `configuration.urls`. */
+    getCategoryUrl: (cat: MenuCategory) => string;
+    /** Click handler that fires `onMenuItemClick` and suppresses navigation. */
+    handleItemClick: (cat: MenuCategory, e: React$1.MouseEvent) => void;
+    /** Currently open branch as category ids, root → deepest. */
+    openPath: number[];
+    /** Is `categoryId` the open branch at `level` (0-based)? */
+    isOpenAt: (level: number, categoryId: number) => boolean;
+    /** Open a branch at `level`, closing anything deeper. Pass null to close. */
+    openAt: (level: number, categoryId: number | null) => void;
+    /** Toggle a branch at `level` — the accordion's click behaviour. */
+    toggleAt: (level: number, categoryId: number) => void;
+}
+/**
+ * Renders a multi-level category navigation menu from the fetched category
+ * tree: a dropdown flyout or jumbotron mega-menu on desktop, an accordion on
+ * mobile — or an accordion on every breakpoint when `menuStyle="accordion"`,
+ * which is the option to pick for trees deeper than a flyout can lay out.
  *
  * @remarks Uses {@link useMenu} to fetch the category hierarchy.
  */
@@ -7319,4 +7382,4 @@ declare function DefaultProductBadges(props: BadgesComponentProps): React__defau
  */
 declare function DefaultProductSurcharges(props: ProductSurchargesComponentProps): React__default.JSX.Element | null;
 
-export { AccountIconAndMenu, type AccountIconAndMenuProps, ActionCode, type ActionCodeProps, type AddContactFormState, type AddItemOptions, _default$1 as AddToCart, type AddToCartProps, AddToFavorite, type AddToFavoriteProps, AddressCardExport as AddressCard, type AddressCardProps, type AddressInput, AddressSelector, type AddressSelectorProps, type AttributeDisplayItem, type AttributeGroup, BreadcrumbsWithProvider as Breadcrumbs, type BreadcrumbsProps, CartBonusItems, type CartBonusItemsProps, CartCarriers, type CartCarriersProps, CartIconAndSidebar, type CartIconAndSidebarProps, type CartInitConfig, CartItemExport as CartItem, type CartItemProps, CartOverview, type CartOverviewProps, CartPaymethods, type CartPaymethodsProps, CartSummary, type CartSummaryProps, CategoryDescription, type CategoryDescriptionProps, CategoryShortDescriptionWithProvider as CategoryShortDescription, type CategoryShortDescriptionProps, ClusterCardExport as ClusterCard, type ClusterCardProps, ClusterConfigurator, type ClusterConfiguratorProps, ClusterInfo, type ClusterInfoProps, ClusterOptions, type ClusterOptionsProps, CompanySwitcher, type CompanySwitcherProps, type ConfiguredSetting, _default$1 as DefaultAddToCart, AddToFavorite as DefaultAddToFavorite, _default as DefaultItemStock, DefaultProductBadges, ProductBulkPrices as DefaultProductBulkPrices, ProductBundles as DefaultProductBundles, DefaultProductImage, ProductPriceDisplay as DefaultProductPrice, DefaultProductSurcharges, DeliveryDate, type DeliveryDateProps, FavoriteListDetails, type FavoriteListDetailsProps, type FavoriteListFormData, FavoriteListItemExport as FavoriteListItem, type FavoriteListItemProps, FavoriteLists, type FavoriteListsProps, type FetchActiveCartConfig, type FetchCrossupsellsInput, ForgotPassword, type ForgotPasswordProps, type GetCrossupsellsOptions, GridFilters, GridFiltersPanel, type GridFiltersPanelProps, type GridFiltersProps, GridPagination, type GridPaginationProps, GridTitleWithProvider as GridTitle, type GridTitleProps, GridToolbar, type GridToolbarProps, _default as ItemStock, type ItemStockProps, ItemsOverview, type ItemsOverviewProps, LoginFormExport as LoginForm, type LoginFormProps, LoginToOrderButton, type LoginToOrderButtonProps, MachineCard, type MachineCardProps, MachineGrid, type MachineGridProps, type MachineListingState, Menu, type MenuCategory, type MenuProps, OrderActions, type OrderActionsProps, OrderBonusItems, type OrderBonusItemsProps, OrderItemCard, type OrderItemCardProps, OrderList, type OrderListProps, type OrderSearchForm, OrderShipments, type OrderShipmentsProps, OrderSummary, type OrderSummaryProps, OrderTotals, type OrderTotalsProps, type PlaceOrderOptions, PriceToggle, type PriceToggleProps, ProductBulkPricesWithProvider as ProductBulkPrices, type ProductBulkPricesProps, ProductBundles, type ProductBundlesProps, ProductCard, type ProductCardProps, ProductDescription, type ProductDescriptionProps, ProductDownloads, type ProductDownloadsProps, ProductGallery, type ProductGalleryProps, ProductGridCompound as ProductGrid, type ProductGridConfig, ProductGridConfigProvider, type ProductGridProps, ProductInfoExport as ProductInfo, type ProductInfoProps, ProductPriceWithProvider as ProductPrice, type ProductPriceProps, ProductShortDescriptionWithProvider as ProductShortDescription, type ProductShortDescriptionProps, ProductSlider, type ProductSliderProps, ProductSpecifications, type ProductSpecificationsProps, ProductTabs, type ProductTabsProps, ProductVideos, type ProductVideosProps, type PropellerDeps, PropellerDepsProvider, type PropellerDepsProviderProps, type PropellerInfra, PropellerProvider, type PropellerProviderProps, type PropellerScope, PurchaseAuthorizationConfigurator, type PurchaseAuthorizationConfiguratorProps, PurchaseAuthorizationRequests, type PurchaseAuthorizationRequestsProps, QuickOrder, type QuickOrderLine, type QuickOrderMatch, type QuickOrderProps, type QuickOrderSubmitResult, type QuickOrderUploadLine, QuoteActions, type QuoteActionsProps, RegisterForm, type RegisterFormProps, type ResolveSpec, type RowEdit, SearchBar, type SearchBarProps, type UseAddressOptions, type UseAddressReturn, type LoginResult as UseAuthLoginResult, type UseAuthOptions, type RegisterContactInput as UseAuthRegisterContactInput, type RegisterCustomerInput as UseAuthRegisterCustomerInput, type UseAuthReturn, type UseCartOptions, type UseCartReturn, type UseCheckoutOptions, type UseCheckoutReturn, type UseClusterConfiguratorOptions, type UseClusterConfiguratorReturn, type UseCompanyOptions, type UseCompanyReturn, type UseFavoritesOptions, type UseFavoritesReturn, type UseMachinesOptions, type UseMachinesReturn, type UseMenuOptions, type UseMenuReturn, type UseOrdersOptions, type UseOrdersReturn, type BundleItem as UseProductBundlesBundleItem, type UseProductBundlesOptions, type UseProductBundlesReturn, type UseProductInfoOptions, type UseProductInfoReturn, type UseProductSearchOptions, type UseProductSearchReturn, type UseProductSliderOptions, type UseProductSliderReturn, type UseProductSpecsOptions, type UseProductSpecsReturn, type UsePurchaseAuthorizationConfiguratorOptions, type UsePurchaseAuthorizationConfiguratorReturn, type UsePurchaseAuthorizationRequestsOptions, type UsePurchaseAuthorizationRequestsReturn, type UseQuickOrderOptions, type UseQuickOrderReturn, type UseSparePartsOptions, type UseSparePartsReturn, UserDetails, type UserDetailsProps, buildRootMachinesQuery, fetchActiveCart, initCart, mergeAnonymousCart, useAddress, useAuth, useCart, useCheckout, useClusterConfigurator, useCompany, useFavorites, useInfraProps, useMachines, useMenu, useOrders, useProductBundles, useProductGridConfig, useProductInfo, useProductSearch, useProductSlider, useProductSpecs, usePropellerContext, usePropellerDeps, usePropellerScope, usePurchaseAuthorizationConfigurator, usePurchaseAuthorizationRequests, useQuickOrder, useRequiredPropellerDeps, useResolvedProps, useServices, useSpareParts, useUserMode };
+export { AccountIconAndMenu, type AccountIconAndMenuProps, ActionCode, type ActionCodeProps, type AddContactFormState, type AddItemOptions, _default$1 as AddToCart, type AddToCartProps, AddToFavorite, type AddToFavoriteProps, AddressCardExport as AddressCard, type AddressCardProps, type AddressInput, AddressSelector, type AddressSelectorProps, type AttributeDisplayItem, type AttributeGroup, BreadcrumbsWithProvider as Breadcrumbs, type BreadcrumbsProps, CartBonusItems, type CartBonusItemsProps, CartCarriers, type CartCarriersProps, CartIconAndSidebar, type CartIconAndSidebarProps, type CartInitConfig, CartItemExport as CartItem, type CartItemProps, CartOverview, type CartOverviewProps, CartPaymethods, type CartPaymethodsProps, CartSummary, type CartSummaryProps, CategoryDescription, type CategoryDescriptionProps, CategoryShortDescriptionWithProvider as CategoryShortDescription, type CategoryShortDescriptionProps, ClusterCardExport as ClusterCard, type ClusterCardProps, ClusterConfigurator, type ClusterConfiguratorProps, ClusterInfo, type ClusterInfoProps, ClusterOptions, type ClusterOptionsProps, CompanySwitcher, type CompanySwitcherProps, type ConfiguredSetting, _default$1 as DefaultAddToCart, AddToFavorite as DefaultAddToFavorite, _default as DefaultItemStock, DefaultProductBadges, ProductBulkPrices as DefaultProductBulkPrices, ProductBundles as DefaultProductBundles, DefaultProductImage, ProductPriceDisplay as DefaultProductPrice, DefaultProductSurcharges, DeliveryDate, type DeliveryDateProps, FavoriteListDetails, type FavoriteListDetailsProps, type FavoriteListFormData, FavoriteListItemExport as FavoriteListItem, type FavoriteListItemProps, FavoriteLists, type FavoriteListsProps, type FetchActiveCartConfig, type FetchCrossupsellsInput, ForgotPassword, type ForgotPasswordProps, type GetCrossupsellsOptions, GridFilters, GridFiltersPanel, type GridFiltersPanelProps, type GridFiltersProps, GridPagination, type GridPaginationProps, GridTitleWithProvider as GridTitle, type GridTitleProps, GridToolbar, type GridToolbarProps, _default as ItemStock, type ItemStockProps, ItemsOverview, type ItemsOverviewProps, LoginFormExport as LoginForm, type LoginFormProps, LoginToOrderButton, type LoginToOrderButtonProps, MachineCard, type MachineCardProps, MachineGrid, type MachineGridProps, type MachineListingState, Menu, type MenuCategory, type MenuProps, type MenuRenderContext, type MenuStyle, OrderActions, type OrderActionsProps, OrderBonusItems, type OrderBonusItemsProps, OrderItemCard, type OrderItemCardProps, OrderList, type OrderListProps, type OrderSearchForm, OrderShipments, type OrderShipmentsProps, OrderSummary, type OrderSummaryProps, OrderTotals, type OrderTotalsProps, type PlaceOrderOptions, PriceToggle, type PriceToggleProps, ProductBulkPricesWithProvider as ProductBulkPrices, type ProductBulkPricesProps, ProductBundles, type ProductBundlesProps, ProductCard, type ProductCardProps, ProductDescription, type ProductDescriptionProps, ProductDownloads, type ProductDownloadsProps, ProductGallery, type ProductGalleryProps, ProductGridCompound as ProductGrid, type ProductGridConfig, ProductGridConfigProvider, type ProductGridProps, ProductInfoExport as ProductInfo, type ProductInfoProps, ProductPriceWithProvider as ProductPrice, type ProductPriceProps, ProductShortDescriptionWithProvider as ProductShortDescription, type ProductShortDescriptionProps, ProductSlider, type ProductSliderProps, ProductSpecifications, type ProductSpecificationsProps, ProductTabs, type ProductTabsProps, ProductVideos, type ProductVideosProps, type PropellerDeps, PropellerDepsProvider, type PropellerDepsProviderProps, type PropellerInfra, PropellerProvider, type PropellerProviderProps, type PropellerScope, PurchaseAuthorizationConfigurator, type PurchaseAuthorizationConfiguratorProps, PurchaseAuthorizationRequests, type PurchaseAuthorizationRequestsProps, QuickOrder, type QuickOrderLine, type QuickOrderMatch, type QuickOrderProps, type QuickOrderSubmitResult, type QuickOrderUploadLine, QuoteActions, type QuoteActionsProps, RegisterForm, type RegisterFormProps, type ResolveSpec, type RowEdit, SearchBar, type SearchBarProps, type UseAddressOptions, type UseAddressReturn, type LoginResult as UseAuthLoginResult, type UseAuthOptions, type RegisterContactInput as UseAuthRegisterContactInput, type RegisterCustomerInput as UseAuthRegisterCustomerInput, type UseAuthReturn, type UseCartOptions, type UseCartReturn, type UseCheckoutOptions, type UseCheckoutReturn, type UseClusterConfiguratorOptions, type UseClusterConfiguratorReturn, type UseCompanyOptions, type UseCompanyReturn, type UseFavoritesOptions, type UseFavoritesReturn, type UseMachinesOptions, type UseMachinesReturn, type UseMenuOptions, type UseMenuReturn, type UseOrdersOptions, type UseOrdersReturn, type BundleItem as UseProductBundlesBundleItem, type UseProductBundlesOptions, type UseProductBundlesReturn, type UseProductInfoOptions, type UseProductInfoReturn, type UseProductSearchOptions, type UseProductSearchReturn, type UseProductSliderOptions, type UseProductSliderReturn, type UseProductSpecsOptions, type UseProductSpecsReturn, type UsePurchaseAuthorizationConfiguratorOptions, type UsePurchaseAuthorizationConfiguratorReturn, type UsePurchaseAuthorizationRequestsOptions, type UsePurchaseAuthorizationRequestsReturn, type UseQuickOrderOptions, type UseQuickOrderReturn, type UseSparePartsOptions, type UseSparePartsReturn, UserDetails, type UserDetailsProps, buildRootMachinesQuery, fetchActiveCart, initCart, mergeAnonymousCart, useAddress, useAuth, useCart, useCheckout, useClusterConfigurator, useCompany, useFavorites, useInfraProps, useMachines, useMenu, useOrders, useProductBundles, useProductGridConfig, useProductInfo, useProductSearch, useProductSlider, useProductSpecs, usePropellerContext, usePropellerDeps, usePropellerScope, usePurchaseAuthorizationConfigurator, usePurchaseAuthorizationRequests, useQuickOrder, useRequiredPropellerDeps, useResolvedProps, useServices, useSpareParts, useUserMode };

package/dist/index.js

@@ -12825,6 +12825,7 @@ function ItemsOverview(props) {
   ] });
 }
 var ItemsOverview_default = ItemsOverview;
+var RENDERED_STYLES = ["dropdown-vertical", "jumbotron", "accordion"];
 function Menu(rawProps) {
   const props = useInfraProps(rawProps);
   const [openPath, setOpenPath] = useState([]);
@@ -12880,11 +12881,20 @@ function Menu(rawProps) {
     return openPath[level] === categoryId;
   }
   function getMenuStyle() {
-    return props.menuStyle || "dropdown-vertical";
+    const requested = props.menuStyle || "dropdown-vertical";
+    if (!RENDERED_STYLES.includes(requested)) {
+      if (process.env.NODE_ENV !== "production") {
+        console.warn(
+          `[Menu] menuStyle="${requested}" has no built-in renderer (available: ${RENDERED_STYLES.join(", ")}); falling back to "accordion". Pass \`renderMenu\` to draw a custom style.`
+        );
+      }
+      return "accordion";
+    }
+    return requested;
   }
   function getRenderableDepth() {
     const requested = Math.max(1, props.depth ?? 3);
-    const cap = getMenuStyle() === "dropdown-horizontal" ? 3 : getMenuStyle() === "accordion" ? Number.POSITIVE_INFINITY : 4;
+    const cap = getMenuStyle() === "accordion" ? Number.POSITIVE_INFINITY : 5;
     if (process.env.NODE_ENV !== "production" && requested > cap) {
       console.warn(
         `[Menu] depth={${requested}} exceeds what menuStyle="${getMenuStyle()}" can lay out (${cap}); rendering ${cap} levels. Use menuStyle="accordion" for deeper trees.`
@@ -12980,7 +12990,7 @@ function Menu(rawProps) {
                     "button",
                     {
                       type: "button",
-                      className: "propeller-menu__toggle px-4 py-3",
+                      className: "propeller-menu__toggle cursor-pointer px-4 py-3 text-muted-foreground transition-colors hover:text-foreground",
                       "aria-expanded": expanded,
                       "aria-label": getCategoryName(cat),
                       onClick: () => toggleAt(level, cat.categoryId),
@@ -13002,6 +13012,31 @@ function Menu(rawProps) {
     if (!props.graphqlClient) return;
     fetchMenu(props.categoryId, userKey);
   }, [hasPrefetchedTree, props.graphqlClient, props.categoryId, props.language, userKey, fetchMenu]);
+  const customMenu = props.renderMenu ? props.renderMenu({
+    categories: menuCategories,
+    isLoading,
+    hasError,
+    maxDepth,
+    getSubCategories,
+    getCategoryName,
+    getCategoryUrl,
+    handleItemClick,
+    openPath,
+    isOpenAt,
+    openAt,
+    toggleAt
+  }) : null;
+  if (customMenu !== null && customMenu !== void 0) {
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `propeller-menu ${props.className || ""}`,
+        "data-variant": props.menuStyle || "custom",
+        "data-loading": isLoading ? "true" : "false",
+        children: customMenu
+      }
+    );
+  }
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -13019,7 +13054,7 @@ function Menu(rawProps) {
           "nav",
           {
             className: `propeller-menu__nav hidden md:block ${props.menuClass || ""}`,
-            children: /* @__PURE__ */ jsx("div", { className: "flex bg-popover border border-border shadow-lg", children: renderColumns(menuCategories, 0) })
+            children: /* @__PURE__ */ jsx("div", { className: "flex max-w-[100vw] overflow-x-auto bg-popover border border-border shadow-lg", children: renderColumns(menuCategories, 0) })
           }
         ) : null,
         !isLoading && !hasError && menuCategories.length > 0 && getMenuStyle() === "jumbotron" ? /* @__PURE__ */ jsxs(
@@ -13030,7 +13065,7 @@ function Menu(rawProps) {
               /* @__PURE__ */ jsx("div", { className: "propeller-menu__tabs flex items-center border-b border-border", children: menuCategories?.map((l1, idx) => /* @__PURE__ */ jsx(
                 "button",
                 {
-                  className: `propeller-menu__tab px-5 py-3 text-sm font-medium transition-colors border-b-2 ${isOpenAt(0, l1.categoryId) ? "border-primary text-primary" : "border-transparent text-foreground hover:text-primary hover:border-primary/50"}`,
+                  className: `propeller-menu__tab cursor-pointer px-5 py-3 text-sm font-medium transition-colors border-b-2 ${isOpenAt(0, l1.categoryId) ? "border-primary text-primary" : "border-transparent text-foreground hover:text-primary hover:border-primary/50"}`,
                   "data-level": "1",
                   "data-active": isOpenAt(0, l1.categoryId) ? "true" : "false",
                   onMouseEnter: (event) => openAt(0, l1.categoryId),
@@ -13072,7 +13107,13 @@ function Menu(rawProps) {
             ]
           }
         ) : null,
-        !isLoading && !hasError && menuCategories.length > 0 ? /* @__PURE__ */ jsx("nav", { className: `propeller-menu__nav md:hidden ${props.menuClass || ""}`, children: renderAccordion(menuCategories, 0) }) : null
+        !isLoading && !hasError && menuCategories.length > 0 ? /* @__PURE__ */ jsx(
+          "nav",
+          {
+            className: `propeller-menu__nav ${getMenuStyle() === "accordion" ? "block" : "md:hidden"} ${props.menuClass || ""}`,
+            children: renderAccordion(menuCategories, 0)
+          }
+        ) : null
       ]
     }
   );