@turquoisehealth/pit-viper 2.231.0 → 2.233.0

package/pv-components/dist/vue/ai/components/base/PvFilterPanel/types.d.ts

@@ -2,7 +2,7 @@ import { Component, Ref } from 'vue';
 import { AdvancedFilterModel, FilterModel } from 'ag-grid-enterprise';
 import { MenuOption, MultiSelectState } from '../../../types';
 import { ColDef, ValueFormatterFunc } from 'ag-grid-community';
-import { PvRangeValue } from '../PvRange/types';
+import { PvRangeScale, PvRangeValue } from '../PvRange/types';
 export type PvFilterPanelCategory = string;
 export type PvFilterPanelFilterType = "value" | "range" | "boolean" | "exists";
 export type PvFilterPanelFilterModelType = "advanced" | "regular";
@@ -79,6 +79,13 @@ export interface PvFilterPanelRangeConfig {
     max?: number | null;
     /** Step increment for range controls in reusable filter panel UIs. */
     step?: number | null;
+    /**
+     * Track mapping for range controls in reusable filter panel UIs. `linear` spreads values evenly,
+     * `log` gives small values proportionally more track. Defaults to `linear` when unset.
+     */
+    scale?: PvRangeScale;
+    /** Icon rendered inside the leading edge of both range inputs. Accepts any Pit Viper icon name. */
+    inputIcon?: string | null;
 }
 export interface PvFilterPanelColDefContext {
     /**
@@ -324,10 +331,24 @@ export interface PvFilterPanelGroupOption {
     isActive: boolean;
     label: string;
 }
-export type PvFilterPanelOptionsHandlerReason = "open" | "search" | "load-more" | "child-load-more";
+export type PvFilterPanelOptionsHandlerReason = "open" | "search" | "load-more" | "child-load-more" | "facet-change";
 export interface PvFilterPanelOptionsHandlerParams {
     field: string;
     colDef: PvFilterPanelColDef;
+    /**
+     * Active secondary facet selections for this field, keyed by facet key (see
+     * `colDef.context.filterPanel`). Facets with nothing selected are omitted, so an empty object
+     * means "no narrowing".
+     *
+     * Sent on every request once a handler is in play, because a handler holding the list is the only
+     * thing that can narrow options it has not sent to the browser yet. Narrow by these *before*
+     * slicing a page, or a facet value whose matches sit past the first page reads as "no matches".
+     *
+     * Ignoring them is safe for a handler that returns the whole list at once: options carrying
+     * `metadata.filters[facetKey]` are still narrowed in the browser. Options that omit that metadata
+     * are taken as already narrowed, so a handler that applied the facets need not echo them back.
+     */
+    facets?: Record<string, string[]>;
     filterModel?: PvFilterPanelFilterModel;
     limit?: number;
     offset?: number;
@@ -364,11 +385,15 @@ export interface PvFilterStore {
     filterTotalCountMap: Ref<Record<string, number | undefined>>;
     filterChildHasMoreMap: Ref<Record<string, boolean | undefined>>;
     filterChildTotalCountMap: Ref<Record<string, number | undefined>>;
+    /** Active facet selections per field, keyed by facet key. Sent with every fetch for that field. */
+    filterFacetSelectionMap: Ref<Record<string, Record<string, string[]>>>;
     getFilterOptions: (field: string) => (PvFilterPanelOption | null)[];
     getFilterSelectedValues: (field: string, staged?: boolean) => (string | null)[];
     initStagedFilterSelections: () => void;
     setFilterOptions: (field: string, options: (PvFilterPanelOption | null)[]) => void;
     setFilterOptionsHandler: (handler?: PvFilterPanelOptionsHandler) => void;
+    /** Record a field's facet selections, so every later fetch for that field carries them. */
+    setFilterFacetSelections: (field: string, facets: Record<string, string[]>) => void;
     setFilterSearchQuery: (field: string, query: string | null | undefined) => void;
     setFilterSelectedValues: (field: string, values: (string | null)[], staged?: boolean) => void;
     stagedFilterModel: Ref<PvFilterPanelFilterModel>;
@@ -413,8 +438,12 @@ export interface PvFilterPanelResolvedFilter {
     label: string;
     loadingText?: string;
     options?: PvFilterPanelOption[];
+    /** See `filterPanelRange.inputIcon`. */
+    rangeInputIcon?: string | null;
     rangeMax?: number | null;
     rangeMin?: number | null;
+    /** See `filterPanelRange.scale`. */
+    rangeScale?: PvRangeScale;
     rangeStep?: number | null;
     rangeValue?: PvRangeValue;
     searchPlaceholder?: string;
@@ -436,6 +465,8 @@ export interface PvFilterPanelAppliedFiltersSectionProps {
     readOnly?: boolean;
 }
 export interface PvFilterPanelCategoryButtonRowProps {
+    /** Label for the button that clears the category selection. */
+    allCategoriesLabel?: string;
     categoryOrder?: PvFilterPanelCategory[];
     filters?: PvFilterPanelResolvedFilter[];
 }
@@ -465,6 +496,8 @@ export type PvFilterPanelEmits = {
     cancel: [];
     /** Emitted when a consumer-controlled value filter selection changes. */
     "controlled-change": [filterKey: string, values: string[], colDef: PvFilterPanelColDef];
+    /** Emitted when a secondary facet selection changes (see `colDef.context.filterPanel`). */
+    "facet-change": [field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef];
     "filter-change": [event: PvFilterPanelFilterChangeEvent];
     "focus-change": [field: string, value: string, option: PvFilterPanelOption];
     "handle-settings-icon": [field: string, colDef: PvFilterPanelColDef];
@@ -475,6 +508,8 @@ export type PvFilterPanelEmits = {
 };
 export type PvFilterPanelEmitFn = <K extends keyof PvFilterPanelEmits>(event: K, ...args: PvFilterPanelEmits[K]) => void;
 export interface PvFilterPanelProps {
+    /** Label for the category-row button that clears the category selection. */
+    allCategoriesLabel?: string;
     applyLabel?: string;
     ariaLabel?: string;
     /** Auto-hide backing fields represented by aggregate filters and child fields represented by filter groups. */
@@ -492,6 +527,12 @@ export interface PvFilterPanelProps {
     /** Whether dev-only filters should be shown. */
     devMode?: boolean;
     displayPreferencesIcon?: boolean;
+    /**
+     * Shows a search input under the category row that narrows the filter list by label.
+     * The search always spans every available filter: it ignores the selected category, which it
+     * resets to "All", and surfaces filters that are collapsed by default.
+     */
+    enableFilterSearch?: boolean;
     enableFocusView?: boolean;
     /** @deprecated Prefer filterStore/filterOptionsHandler. Whether more value-filter options can be loaded, keyed by column key (`colId` when present, otherwise `field`). */
     filterHasMoreMap?: Record<string, boolean | undefined>;
@@ -507,6 +548,8 @@ export interface PvFilterPanelProps {
     filterOptions?: Record<string, PvFilterPanelOption[]>;
     /** Fetches value-filter options. When provided without filterStore, PvFilterPanel creates an internal PvFilterStore. */
     filterOptionsHandler?: PvFilterPanelOptionsHandler;
+    /** Placeholder for the filter search input shown when `enableFilterSearch` is true. */
+    filterSearchPlaceholder?: string;
     /** @deprecated Prefer filterStore/filterOptionsHandler. Value-filter search queries keyed by column key (`colId` when present, otherwise `field`). */
     filterSearchQueries?: Record<string, string | undefined>;
     /** Suggested filter shortcuts shown above the category carousel. Active suggestions are hidden automatically. */

package/pv-components/dist/vue/ai/components/base/PvFilterPanel/usePvFilterPanel.d.ts

@@ -23,8 +23,11 @@ export declare function usePvFilterPanel(props: PvFilterPanelCoreProps, filterMo
     clearAllFilters: () => void;
     getSuggestionKey: (suggestion: PvFilterPanelSuggestion) => string;
     handleControlChange: (field: string, change: PvFilterPanelControlChange) => void;
+    handleFacetChange: (filter: PvFilterPanelResolvedFilter, facets: Record<string, string[]>, query?: string) => void;
     handleLoadMore: (filter: PvFilterPanelResolvedFilter, query: string, parentId?: string) => void;
     handleSearchChange: (filter: PvFilterPanelResolvedFilter, query: string) => void;
     handleSuggestionClick: (suggestion: PvFilterPanelSuggestion) => void;
     removeAppliedFilter: (field: string, value: string, type?: PvFilterPanelFilterType) => void;
+    setFacetSelections: (field: string, facets: Record<string, string[]>) => void;
+    usesHandlerFacets: ComputedRef<boolean>;
 };

package/pv-components/dist/vue/ai/components/base/PvMultiSelectButton/PvMultiSelectButton.vue.d.ts

@@ -62,6 +62,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "checkbox" | "icon" | "toggle" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";
@@ -107,6 +108,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "checkbox" | "icon" | "toggle" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";
@@ -152,6 +154,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "checkbox" | "icon" | "toggle" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";

package/pv-components/dist/vue/ai/components/base/PvMultiSelectButton/types.d.ts

@@ -71,6 +71,10 @@ export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Recor
     optionsVariant?: Exclude<MenuOptionsVariant, "radio">;
     /** Use an overlay-style trigger (auto-focuses search on open) */
     overlayTrigger?: boolean;
+    /** Render options as radios: selecting an option replaces the current selection
+     * (clicking the selected option again deselects it). Ignored for cascade selection.
+     */
+    singleSelect?: boolean;
     /** When enableCascadeSelection is true, selecting a parent will select all children
      * regardless of whether they are filtered by a search query. When false (default),
      * selecting a parent will only select the children that are currently shown in the

package/pv-components/dist/vue/ai/components/base/PvRange/PvRange.vue.d.ts

@@ -1,4 +1,4 @@
-import { PvRangeProps, PvRangeValue, PvRangeSize, PvRangeColor, PvRangeMode } from './types';
+import { PvRangeProps, PvRangeValue, PvRangeSize, PvRangeColor, PvRangeScale, PvRangeMode } from './types';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 type __VLS_Props = PvRangeProps;
 type __VLS_PublicProps = {
@@ -16,7 +16,9 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     label: string;
     disabled: boolean;
     step: number | null;
+    inputIcon: string | null;
     color: PvRangeColor;
+    scale: PvRangeScale;
     mode: PvRangeMode;
     showClear: boolean;
     min: number | null;

package/pv-components/dist/vue/ai/components/base/PvRange/types.d.ts

@@ -1,5 +1,6 @@
 export type PvRangeColor = "single" | "multiple";
 export type PvRangeMode = "single" | "dual";
+export type PvRangeScale = "linear" | "log";
 export type PvRangeSize = "sm" | "md" | "lg";
 export interface PvRangeProps {
     /** When true, min and max handles may have the same value in dual mode. */
@@ -13,6 +14,8 @@ export interface PvRangeProps {
     /** Value display type for dual-mode inputs, tooltips, and bound labels. */
     dataType?: string | null;
     disabled?: boolean;
+    /** Icon rendered inside the leading edge of both dual-mode inputs. Accepts any Pit Viper icon name. */
+    inputIcon?: string | null;
     /** Accessible group label in dual mode. */
     label?: string;
     /** Upper slider bound. */
@@ -23,6 +26,11 @@ export interface PvRangeProps {
     minLabel?: string;
     /** Slider interaction mode. `single` uses the default v-model; `dual` ignores modelValue and uses v-model:rangeValue. */
     mode?: PvRangeMode;
+    /**
+     * Track mapping. `linear` spreads values evenly. `log` gives small values proportionally more track,
+     * which keeps very wide bounds (for example 0 to 240,000) selectable down to single digits.
+     */
+    scale?: PvRangeScale;
     /** Whether to show min/max bound values above the slider in dual mode. */
     showBoundLabels?: boolean;
     /** Whether to show the Clear range action when a dual-mode value is active. */
@@ -33,7 +41,7 @@ export interface PvRangeProps {
     showValueTooltips?: boolean;
     /** Visual size. */
     size?: PvRangeSize;
-    /** Slider/input step. Use 0 for continuous values. */
+    /** Slider/input step. Use 0 for continuous values. Acts as a minimum increment on a `log` scale. */
     step?: number | null;
     /** Decimal places for dual-mode display values. */
     valueDecimals?: number | null;

package/pv-components/dist/vue/base/components/base/PvFilterModal/PvFilterModal.vue.d.ts

@@ -18,6 +18,7 @@ type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     cancel: () => any;
     "load-more": (field: string, colDef: PvFilterPanelColDef, query: string, parentId?: string | undefined) => any;
+    "facet-change": (field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef) => any;
     apply: (filterModel: PvFilterPanelFilterModel) => any;
     "controlled-change": (filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any;
     "filter-change": (event: PvFilterPanelFilterChangeEvent) => any;
@@ -31,6 +32,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
 }, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onCancel?: (() => any) | undefined;
     "onLoad-more"?: ((field: string, colDef: PvFilterPanelColDef, query: string, parentId?: string | undefined) => any) | undefined;
+    "onFacet-change"?: ((field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef) => any) | undefined;
     onApply?: ((filterModel: PvFilterPanelFilterModel) => any) | undefined;
     "onControlled-change"?: ((filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any) | undefined;
     "onFilter-change"?: ((event: PvFilterPanelFilterChangeEvent) => any) | undefined;

package/pv-components/dist/vue/base/components/base/PvFilterPanel/PvFilterPanel.vue.d.ts

@@ -17,6 +17,7 @@ type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     cancel: () => any;
     "load-more": (field: string, colDef: PvFilterPanelColDef, query: string, parentId?: string | undefined) => any;
+    "facet-change": (field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef) => any;
     apply: (filterModel: PvFilterPanelFilterModel) => any;
     "controlled-change": (filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any;
     "filter-change": (event: PvFilterPanelFilterChangeEvent) => any;
@@ -30,6 +31,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
 }, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onCancel?: (() => any) | undefined;
     "onLoad-more"?: ((field: string, colDef: PvFilterPanelColDef, query: string, parentId?: string | undefined) => any) | undefined;
+    "onFacet-change"?: ((field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef) => any) | undefined;
     onApply?: ((filterModel: PvFilterPanelFilterModel) => any) | undefined;
     "onControlled-change"?: ((filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any) | undefined;
     "onFilter-change"?: ((event: PvFilterPanelFilterChangeEvent) => any) | undefined;
@@ -60,6 +62,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     focusText: string;
     rangeDebounceMs: number;
     staged: boolean;
+    allCategoriesLabel: string;
     applyLabel: string;
     autoHideRelatedFilterFields: boolean;
     cancelLabel: string;
@@ -67,6 +70,8 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     clearAllBody: string;
     clearAllHeader: string;
     clearAllLabel: string;
+    enableFilterSearch: boolean;
+    filterSearchPlaceholder: string;
     hideCollapseButton: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/pv-components/dist/vue/base/components/base/PvFilterPanel/PvFilterPanelCategoryButtonRow.vue.d.ts

@@ -10,5 +10,6 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
 }>, {
     filters: PvFilterPanelResolvedFilter[];
+    allCategoriesLabel: string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 export default _default;

package/pv-components/dist/vue/base/components/base/PvFilterPanel/types.d.ts

@@ -2,7 +2,7 @@ import { Component, Ref } from 'vue';
 import { AdvancedFilterModel, FilterModel } from 'ag-grid-enterprise';
 import { MenuOption, MultiSelectState } from '../../../types';
 import { ColDef, ValueFormatterFunc } from 'ag-grid-community';
-import { PvRangeValue } from '../PvRange/types';
+import { PvRangeScale, PvRangeValue } from '../PvRange/types';
 export type PvFilterPanelCategory = string;
 export type PvFilterPanelFilterType = "value" | "range" | "boolean" | "exists";
 export type PvFilterPanelFilterModelType = "advanced" | "regular";
@@ -79,6 +79,13 @@ export interface PvFilterPanelRangeConfig {
     max?: number | null;
     /** Step increment for range controls in reusable filter panel UIs. */
     step?: number | null;
+    /**
+     * Track mapping for range controls in reusable filter panel UIs. `linear` spreads values evenly,
+     * `log` gives small values proportionally more track. Defaults to `linear` when unset.
+     */
+    scale?: PvRangeScale;
+    /** Icon rendered inside the leading edge of both range inputs. Accepts any Pit Viper icon name. */
+    inputIcon?: string | null;
 }
 export interface PvFilterPanelColDefContext {
     /**
@@ -324,10 +331,24 @@ export interface PvFilterPanelGroupOption {
     isActive: boolean;
     label: string;
 }
-export type PvFilterPanelOptionsHandlerReason = "open" | "search" | "load-more" | "child-load-more";
+export type PvFilterPanelOptionsHandlerReason = "open" | "search" | "load-more" | "child-load-more" | "facet-change";
 export interface PvFilterPanelOptionsHandlerParams {
     field: string;
     colDef: PvFilterPanelColDef;
+    /**
+     * Active secondary facet selections for this field, keyed by facet key (see
+     * `colDef.context.filterPanel`). Facets with nothing selected are omitted, so an empty object
+     * means "no narrowing".
+     *
+     * Sent on every request once a handler is in play, because a handler holding the list is the only
+     * thing that can narrow options it has not sent to the browser yet. Narrow by these *before*
+     * slicing a page, or a facet value whose matches sit past the first page reads as "no matches".
+     *
+     * Ignoring them is safe for a handler that returns the whole list at once: options carrying
+     * `metadata.filters[facetKey]` are still narrowed in the browser. Options that omit that metadata
+     * are taken as already narrowed, so a handler that applied the facets need not echo them back.
+     */
+    facets?: Record<string, string[]>;
     filterModel?: PvFilterPanelFilterModel;
     limit?: number;
     offset?: number;
@@ -364,11 +385,15 @@ export interface PvFilterStore {
     filterTotalCountMap: Ref<Record<string, number | undefined>>;
     filterChildHasMoreMap: Ref<Record<string, boolean | undefined>>;
     filterChildTotalCountMap: Ref<Record<string, number | undefined>>;
+    /** Active facet selections per field, keyed by facet key. Sent with every fetch for that field. */
+    filterFacetSelectionMap: Ref<Record<string, Record<string, string[]>>>;
     getFilterOptions: (field: string) => (PvFilterPanelOption | null)[];
     getFilterSelectedValues: (field: string, staged?: boolean) => (string | null)[];
     initStagedFilterSelections: () => void;
     setFilterOptions: (field: string, options: (PvFilterPanelOption | null)[]) => void;
     setFilterOptionsHandler: (handler?: PvFilterPanelOptionsHandler) => void;
+    /** Record a field's facet selections, so every later fetch for that field carries them. */
+    setFilterFacetSelections: (field: string, facets: Record<string, string[]>) => void;
     setFilterSearchQuery: (field: string, query: string | null | undefined) => void;
     setFilterSelectedValues: (field: string, values: (string | null)[], staged?: boolean) => void;
     stagedFilterModel: Ref<PvFilterPanelFilterModel>;
@@ -413,8 +438,12 @@ export interface PvFilterPanelResolvedFilter {
     label: string;
     loadingText?: string;
     options?: PvFilterPanelOption[];
+    /** See `filterPanelRange.inputIcon`. */
+    rangeInputIcon?: string | null;
     rangeMax?: number | null;
     rangeMin?: number | null;
+    /** See `filterPanelRange.scale`. */
+    rangeScale?: PvRangeScale;
     rangeStep?: number | null;
     rangeValue?: PvRangeValue;
     searchPlaceholder?: string;
@@ -436,6 +465,8 @@ export interface PvFilterPanelAppliedFiltersSectionProps {
     readOnly?: boolean;
 }
 export interface PvFilterPanelCategoryButtonRowProps {
+    /** Label for the button that clears the category selection. */
+    allCategoriesLabel?: string;
     categoryOrder?: PvFilterPanelCategory[];
     filters?: PvFilterPanelResolvedFilter[];
 }
@@ -465,6 +496,8 @@ export type PvFilterPanelEmits = {
     cancel: [];
     /** Emitted when a consumer-controlled value filter selection changes. */
     "controlled-change": [filterKey: string, values: string[], colDef: PvFilterPanelColDef];
+    /** Emitted when a secondary facet selection changes (see `colDef.context.filterPanel`). */
+    "facet-change": [field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef];
     "filter-change": [event: PvFilterPanelFilterChangeEvent];
     "focus-change": [field: string, value: string, option: PvFilterPanelOption];
     "handle-settings-icon": [field: string, colDef: PvFilterPanelColDef];
@@ -475,6 +508,8 @@ export type PvFilterPanelEmits = {
 };
 export type PvFilterPanelEmitFn = <K extends keyof PvFilterPanelEmits>(event: K, ...args: PvFilterPanelEmits[K]) => void;
 export interface PvFilterPanelProps {
+    /** Label for the category-row button that clears the category selection. */
+    allCategoriesLabel?: string;
     applyLabel?: string;
     ariaLabel?: string;
     /** Auto-hide backing fields represented by aggregate filters and child fields represented by filter groups. */
@@ -492,6 +527,12 @@ export interface PvFilterPanelProps {
     /** Whether dev-only filters should be shown. */
     devMode?: boolean;
     displayPreferencesIcon?: boolean;
+    /**
+     * Shows a search input under the category row that narrows the filter list by label.
+     * The search always spans every available filter: it ignores the selected category, which it
+     * resets to "All", and surfaces filters that are collapsed by default.
+     */
+    enableFilterSearch?: boolean;
     enableFocusView?: boolean;
     /** @deprecated Prefer filterStore/filterOptionsHandler. Whether more value-filter options can be loaded, keyed by column key (`colId` when present, otherwise `field`). */
     filterHasMoreMap?: Record<string, boolean | undefined>;
@@ -507,6 +548,8 @@ export interface PvFilterPanelProps {
     filterOptions?: Record<string, PvFilterPanelOption[]>;
     /** Fetches value-filter options. When provided without filterStore, PvFilterPanel creates an internal PvFilterStore. */
     filterOptionsHandler?: PvFilterPanelOptionsHandler;
+    /** Placeholder for the filter search input shown when `enableFilterSearch` is true. */
+    filterSearchPlaceholder?: string;
     /** @deprecated Prefer filterStore/filterOptionsHandler. Value-filter search queries keyed by column key (`colId` when present, otherwise `field`). */
     filterSearchQueries?: Record<string, string | undefined>;
     /** Suggested filter shortcuts shown above the category carousel. Active suggestions are hidden automatically. */

package/pv-components/dist/vue/base/components/base/PvFilterPanel/usePvFilterPanel.d.ts

@@ -23,8 +23,11 @@ export declare function usePvFilterPanel(props: PvFilterPanelCoreProps, filterMo
     clearAllFilters: () => void;
     getSuggestionKey: (suggestion: PvFilterPanelSuggestion) => string;
     handleControlChange: (field: string, change: PvFilterPanelControlChange) => void;
+    handleFacetChange: (filter: PvFilterPanelResolvedFilter, facets: Record<string, string[]>, query?: string) => void;
     handleLoadMore: (filter: PvFilterPanelResolvedFilter, query: string, parentId?: string) => void;
     handleSearchChange: (filter: PvFilterPanelResolvedFilter, query: string) => void;
     handleSuggestionClick: (suggestion: PvFilterPanelSuggestion) => void;
     removeAppliedFilter: (field: string, value: string, type?: PvFilterPanelFilterType) => void;
+    setFacetSelections: (field: string, facets: Record<string, string[]>) => void;
+    usesHandlerFacets: ComputedRef<boolean>;
 };

package/pv-components/dist/vue/base/components/base/PvMultiSelectButton/PvMultiSelectButton.vue.d.ts

@@ -62,6 +62,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "toggle" | "checkbox" | "icon" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";
@@ -107,6 +108,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "toggle" | "checkbox" | "icon" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";
@@ -152,6 +154,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             optionsVariant: "toggle" | "checkbox" | "icon" | "simple" | "company" | "avatar" | "checkmark";
             options: MenuOption<T>[];
             menuActionsVariant: MenuActionsVariant | null;
+            singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
             counterStyle: "primary" | "secondary";

package/pv-components/dist/vue/base/components/base/PvMultiSelectButton/types.d.ts

@@ -71,6 +71,10 @@ export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Recor
     optionsVariant?: Exclude<MenuOptionsVariant, "radio">;
     /** Use an overlay-style trigger (auto-focuses search on open) */
     overlayTrigger?: boolean;
+    /** Render options as radios: selecting an option replaces the current selection
+     * (clicking the selected option again deselects it). Ignored for cascade selection.
+     */
+    singleSelect?: boolean;
     /** When enableCascadeSelection is true, selecting a parent will select all children
      * regardless of whether they are filtered by a search query. When false (default),
      * selecting a parent will only select the children that are currently shown in the

package/pv-components/dist/vue/base/components/base/PvRange/PvRange.vue.d.ts

@@ -1,4 +1,4 @@
-import { PvRangeProps, PvRangeValue, PvRangeSize, PvRangeColor, PvRangeMode } from './types';
+import { PvRangeProps, PvRangeValue, PvRangeSize, PvRangeColor, PvRangeScale, PvRangeMode } from './types';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 type __VLS_Props = PvRangeProps;
 type __VLS_PublicProps = {
@@ -16,9 +16,11 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     label: string;
     disabled: boolean;
     color: PvRangeColor;
+    scale: PvRangeScale;
     mode: PvRangeMode;
     showClear: boolean;
     step: number | null;
+    inputIcon: string | null;
     min: number | null;
     max: number | null;
     allowMinMaxEqual: boolean;

package/pv-components/dist/vue/base/components/base/PvRange/types.d.ts

@@ -1,5 +1,6 @@
 export type PvRangeColor = "single" | "multiple";
 export type PvRangeMode = "single" | "dual";
+export type PvRangeScale = "linear" | "log";
 export type PvRangeSize = "sm" | "md" | "lg";
 export interface PvRangeProps {
     /** When true, min and max handles may have the same value in dual mode. */
@@ -13,6 +14,8 @@ export interface PvRangeProps {
     /** Value display type for dual-mode inputs, tooltips, and bound labels. */
     dataType?: string | null;
     disabled?: boolean;
+    /** Icon rendered inside the leading edge of both dual-mode inputs. Accepts any Pit Viper icon name. */
+    inputIcon?: string | null;
     /** Accessible group label in dual mode. */
     label?: string;
     /** Upper slider bound. */
@@ -23,6 +26,11 @@ export interface PvRangeProps {
     minLabel?: string;
     /** Slider interaction mode. `single` uses the default v-model; `dual` ignores modelValue and uses v-model:rangeValue. */
     mode?: PvRangeMode;
+    /**
+     * Track mapping. `linear` spreads values evenly. `log` gives small values proportionally more track,
+     * which keeps very wide bounds (for example 0 to 240,000) selectable down to single digits.
+     */
+    scale?: PvRangeScale;
     /** Whether to show min/max bound values above the slider in dual mode. */
     showBoundLabels?: boolean;
     /** Whether to show the Clear range action when a dual-mode value is active. */
@@ -33,7 +41,7 @@ export interface PvRangeProps {
     showValueTooltips?: boolean;
     /** Visual size. */
     size?: PvRangeSize;
-    /** Slider/input step. Use 0 for continuous values. */
+    /** Slider/input step. Use 0 for continuous values. Acts as a minimum increment on a `log` scale. */
     step?: number | null;
     /** Decimal places for dual-mode display values. */
     valueDecimals?: number | null;