@propeller-commerce/propeller-v2-vue-ui 0.3.24 → 0.3.26

package/CHANGELOG.md

@@ -8,6 +8,44 @@ once it reaches 1.0. Until then (the `0.x` line) the public API may change
 between minor versions; breaking changes are called out below and in
 [MIGRATION.md](./MIGRATION.md).
 
+## [0.3.26] - 2026-07-09
+
+### Added
+
+- `ProductCard` / `ProductGrid`: new `belowNameComponent?: Component` prop plus a
+  `#belowName` scoped slot on `ProductCard`. Renders arbitrary host-supplied
+  content directly below the product name (and above the short description /
+  price) in both the grid and row layouts, without forking the card — e.g.
+  package descriptions or custom badges. On `ProductGrid` the component cascades
+  to every card via `ProductGridConfig`; on `ProductCard` it can also be set
+  per-card (explicit prop wins over grid context) or overridden via the
+  `#belowName` slot. Mirrors the React `belowName` render prop.
+
+## [0.3.25] - 2026-07-09
+
+### Added
+
+- `ProductGrid`, `SearchBar`, `ProductInfo`: new `orderlistIds?: number[]` and
+  `applyOrderlists?: boolean` props to scope the product/search fetch to
+  specific orderlists (e.g. a chosen B2B contract). When `orderlistIds` is
+  non-empty, orderlists are applied (unless `applyOrderlists` is `false`);
+  otherwise `applyOrderlists: false` is sent so an authenticated user without a
+  contract still sees the full catalogue. Threaded through `useProductSearch`
+  and `useProductInfo` (explicit ids override the composable's default
+  all-company-orderlists resolution).
+- `Menu`: new `getUrl?: (category: Category) => string` prop — a custom URL
+  builder that overrides `menuLinkFormat` / `configuration.urls.getCategoryUrl`,
+  letting hosts inject dynamic query strings (e.g. `?contract=…`). Mirrors the
+  existing `Breadcrumbs.getUrl`.
+- `GridToolbar`: new `hidePriceSort?: boolean` prop to hide the price sort
+  option entirely (closed B2B portals where prices are "by quotation").
+- `ProductTabs` / `ProductSpecifications`: new
+  `specificationsPackageDescription?` (ProductTabs) → `packageDescription?`
+  (ProductSpecifications) passthrough, rendering an extra package-description
+  string above the specifications table.
+
+  Mirrors React UI 0.4.16. All additions are additive and backward-compatible.
+
 ## [0.3.24] - 2026-07-08
 
 ### Changed

package/dist/components/GridToolbar.vue.d.ts

@@ -6,6 +6,11 @@ export interface GridToolbarProps {
      * Defaults to all available sort fields.
      */
     sortOptions?: string[];
+    /**
+     * Hide the price-ascending/descending sort options entirely. Default: false.
+     * Useful for closed B2B portals where prices are "by quotation".
+     */
+    hidePriceSort?: boolean;
     /**
      * Active sort — first element is used.
      * Defaults to [{ field: 'CATEGORY_ORDER', order: 'DESC' }].

package/dist/components/Menu.vue.d.ts

@@ -36,6 +36,13 @@ export interface MenuProps {
      * Defaults to 'category/{categoryId}/{slug}'.
      */
     menuLinkFormat?: string;
+    /**
+     * Custom URL builder for category links. Overrides `menuLinkFormat` /
+     * `configuration.urls.getCategoryUrl`. Lets hosts inject dynamic query strings
+     * (e.g. `?contract=…`) that a static format string cannot express.
+     * Mirrors the `getUrl` prop on Breadcrumbs.
+     */
+    getUrl?: (category: Category) => string;
     /**
      * Called when a menu item is clicked.
      * Use for SPA-style routing instead of full-page navigation.

package/dist/components/ProductCard.vue.d.ts

@@ -168,6 +168,15 @@ export interface ProductCardProps {
     imageComponent?: Component;
     badgesComponent?: Component;
     favoriteComponent?: Component;
+    /**
+     * Render arbitrary content directly below the product name (and above the
+     * short description / price), in both the grid and row layouts. Receives the
+     * product as a prop so hosts can surface extra info — e.g. package
+     * descriptions, custom badges — without forking the card. Consumers can also
+     * use the `#belowName` scoped slot directly; this prop is the cascadable
+     * (grid-wide) equivalent.
+     */
+    belowNameComponent?: Component;
 }
 interface ProductCardState {
     isFavorite: boolean;
@@ -238,6 +247,12 @@ declare function __VLS_template(): {
             name: string;
             onNavigate: typeof handleNavigate;
         }): any;
+        belowName?(_: {
+            product: Product;
+        }): any;
+        belowName?(_: {
+            product: Product;
+        }): any;
         textLabels?(_: {
             product: Product;
             values: {

package/dist/components/ProductGrid.vue.d.ts

@@ -32,6 +32,14 @@ export interface ProductGridProps {
      * categoryProductSearchInput and uses `config.baseCategoryId`.
      */
     brand?: string;
+    /** Scope the product fetch to specific orderlist IDs (e.g. a chosen B2B contract). */
+    orderlistIds?: number[];
+    /**
+     * Apply the orderlist filter. Defaults to `true` when `orderlistIds` is
+     * non-empty, `false` otherwise — so an authenticated user without a contract
+     * still sees the full catalogue.
+     */
+    applyOrderlists?: boolean;
     /** Number of columns in the grid. Accepts 2, 3, 4, 5, or 6. Defaults to 3. */
     columns?: number;
     /**
@@ -256,6 +264,13 @@ export interface ProductGridProps {
     favoriteComponent?: Component;
     productCardComponent?: Component;
     clusterCardComponent?: Component;
+    /**
+     * Render arbitrary content directly below each card's product name. Receives
+     * the product as a prop; cascades to every ProductCard via ProductGridConfig.
+     * Lets hosts surface extra per-product info (e.g. package descriptions)
+     * across the whole grid without swapping the entire card.
+     */
+    belowNameComponent?: Component;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;

package/dist/components/ProductInfo.vue.d.ts

@@ -7,6 +7,16 @@ export interface ProductInfoProps {
      * Overrides default company for price calculation.
      * Triggers a re-fetch when changed. */
     companyId?: number;
+    /**
+     * Scope the product fetch to specific orderlist IDs (e.g. a chosen B2B
+     * contract). Overrides the default resolution of all the company's orderlists.
+     */
+    orderlistIds?: number[];
+    /**
+     * Apply the orderlist filter. Defaults to `true`; set `false` to browse
+     * unscoped (full catalogue) for an authenticated user without a contract.
+     */
+    applyOrderlists?: boolean;
     /**
      * Pre-fetched product object to display.
      * When provided the component skips internal fetching.

package/dist/components/ProductSpecifications.vue.d.ts

@@ -30,6 +30,11 @@ export interface ProductSpecificationsProps {
      * When false or omitted, displays a flat ungrouped table/list. Default: false.
      */
     grouping?: boolean;
+    /**
+     * Optional package-description string (e.g. contents / packaging notes),
+     * rendered above the attribute table. Omitted when empty.
+     */
+    packageDescription?: string;
     /** Extra CSS class applied to the root element. */
     className?: string;
 }

package/dist/components/ProductTabs.vue.d.ts

@@ -55,6 +55,12 @@ export interface ProductTabsProps {
      * Passed as `grouping` to ProductSpecifications.
      */
     specificationsGrouping?: boolean;
+    /**
+     * Extra package-description string rendered in the specifications section
+     * (e.g. contents / packaging notes). Passed as `packageDescription` to
+     * ProductSpecifications.
+     */
+    specificationsPackageDescription?: string;
     /**
      * Override UI strings for the Downloads section.
      * Available keys: title, download

package/dist/components/SearchBar.vue.d.ts

@@ -54,6 +54,14 @@ export interface SearchBarProps {
      * if the underlying SDK call supports priceCalculateProductInput.
      */
     companyId?: number;
+    /** Scope the autosuggest fetch to specific orderlist IDs (e.g. a chosen B2B contract). */
+    orderlistIds?: number[];
+    /**
+     * Apply the orderlist filter. Defaults to `true` when `orderlistIds` is
+     * non-empty, `false` otherwise — so an authenticated user without a contract
+     * still sees the full catalogue.
+     */
+    applyOrderlists?: boolean;
     /**
      * Configuration object providing:
      *   imageSearchFiltersGrid, imageVariantFiltersMedium — passed to CategoryService

package/dist/composables/vue/useProductInfo.d.ts

@@ -6,6 +6,16 @@ export interface UseProductInfoOptions {
     taxZone?: string;
     user?: Ref<Contact | Customer | null>;
     companyId?: Ref<number | undefined>;
+    /**
+     * Scope the product fetch to specific orderlist IDs (e.g. a chosen B2B
+     * contract). Overrides the default resolution of all the company's orderlists.
+     */
+    orderlistIds?: Ref<number[] | undefined>;
+    /**
+     * Apply the orderlist filter. Defaults to `true`; set `false` to browse
+     * unscoped (full catalogue) for an authenticated user without a contract.
+     */
+    applyOrderlists?: Ref<boolean | undefined>;
     /** Attribute names to include in attributeResultSearchInput (productTrackAttributes). */
     productTrackAttributes?: string[];
     configuration?: {

package/dist/composables/vue/useProductSearch.d.ts

@@ -11,6 +11,14 @@ export interface UseProductSearchOptions {
     taxZone?: string;
     user?: Ref<Contact | Customer | null>;
     companyId?: Ref<number | undefined>;
+    /** Scope the product fetch to specific orderlist IDs (e.g. a chosen B2B contract). */
+    orderlistIds?: Ref<number[] | undefined>;
+    /**
+     * Apply the orderlist filter. Defaults to `true` when `orderlistIds` is
+     * non-empty, `false` otherwise — so an authenticated user without a contract
+     * still sees the full catalogue.
+     */
+    applyOrderlists?: Ref<boolean | undefined>;
     textFilters?: Ref<ProductTextFilterInput[] | undefined>;
     priceFilterMin?: Ref<number | undefined>;
     priceFilterMax?: Ref<number | undefined>;

package/dist/context/ProductGridContext.d.ts

@@ -43,6 +43,13 @@ export interface ProductGridConfig {
     surchargesComponent?: Component;
     productCardComponent?: Component;
     clusterCardComponent?: Component;
+    /**
+     * Render arbitrary content directly below each card's product name. Receives
+     * the product as a prop; cascades to every ProductCard. Lets hosts surface
+     * extra per-product info (e.g. package descriptions) across the whole grid
+     * without swapping the entire card.
+     */
+    belowNameComponent?: Component;
 }
 /** Injection key for the Tier 2 grid config. Symbol-keyed, collision-free. */
 export declare const ProductGridInjectionKey: InjectionKey<ProductGridConfig>;