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

package/CHANGELOG.md

@@ -8,6 +8,31 @@ 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.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/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;
     /**

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>;