@turquoisehealth/pit-viper 2.183.0 → 2.183.1-dev.0

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

@@ -56,12 +56,14 @@ export interface MenuOptionSelectedEvent {
 }
 export interface SeeMoreEvent {
     parentId?: string;
+    offset?: number;
 }
-export interface MultiSelectState {
-    selectedParentIds: string[];
-    selectedChildrenIds: string[];
-    deselectedChildrenIds: string[];
+export interface SelectionNode {
+    id: string;
+    state: "selected" | "deselected";
+    children?: SelectionNode[];
 }
+export type MultiSelectState = SelectionNode[];
 export declare enum MenuItemType {
     simple = "simple",
     checkbox = "checkbox",

package/pv-components/dist/vue/visualizations/components/base/PvMenu/cascadeUtils.d.ts

@@ -1,4 +1,4 @@
-import { MenuOption } from '../../../types';
+import { MenuOption, MultiSelectState } from '../../../types';
 /** Recursively collect all leaf (childless) options from a tree. */
 export declare function collectLeafOptions<T>(options: MenuOption<T>[]): MenuOption<T>[];
 /**
@@ -21,6 +21,7 @@ export declare function mergeLeafOptions<T>(base: MenuOption<T>[], overlay: Menu
  * not depend on Map iteration order.
  */
 export declare function countWithCollapsedParents<T>(options: MenuOption<T>[], selectedIds: Set<string>): number;
+export declare function countFromSelectionState(state: MultiSelectState): number;
 /**
  * Recursively filter a tree for a search value.
  *

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

@@ -34,6 +34,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             groupings: string[];
             hideParentOnChildQueryMatch: boolean;
             icon: string;
+            hasMoreOptions: boolean;
             optionsAction: MenuAction<T> | undefined;
             optionsRenderer: Component;
             overlayTrigger: boolean;
@@ -72,6 +73,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             groupings: string[];
             hideParentOnChildQueryMatch: boolean;
             icon: string;
+            hasMoreOptions: boolean;
             optionsAction: MenuAction<T> | undefined;
             optionsRenderer: Component;
             overlayTrigger: boolean;
@@ -110,6 +112,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             groupings: string[];
             hideParentOnChildQueryMatch: boolean;
             icon: string;
+            hasMoreOptions: boolean;
             optionsAction: MenuAction<T> | undefined;
             optionsRenderer: Component;
             overlayTrigger: boolean;

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

@@ -47,6 +47,8 @@ export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Recor
     icon?: string;
     /** Show a loading spinner inside the dropdown */
     isLoading?: boolean;
+    /** Whether more top-level options are available after the loaded options */
+    hasMoreOptions?: boolean;
     /** Text label on the trigger button */
     label?: string;
     /** Style of the footer action panel. "select-clear" shows select/clear all; "cancel-confirm" requires explicit confirmation. */
@@ -82,7 +84,7 @@ export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Recor
     /** CSS selector for teleporting the popover dropdown */
     teleportLocation?: string;
     /** Total available top-level options (may exceed options.length when paginating).
-     * When totalOptionCount > options.length, a "See more" button appears. */
+     * Used as a fallback to show "See more" when hasMoreOptions is not provided. */
     totalOptionCount?: number;
     /** Visual style of the trigger button */
     variant?: PvSelectButtonVariant;

package/pv-components/dist/vue/visualizations/components/tables/PvDataTable/helpers.d.ts

@@ -1,6 +1,6 @@
 import { Column, ColumnVO, ICellRendererParams, ValueFormatterFunc } from 'ag-grid-enterprise';
 import { ColDef } from 'ag-grid-community';
-import { ColDefContextProps } from './types';
+import { AggregateFieldHierarchy, ColDefContextProps } from './types';
 /**
  * Returns row data for a cell renderer. For leaf rows, returns `params.data` directly.
  * For group rows (where `params.data` is null), falls back to the first child row's data.
@@ -13,6 +13,10 @@ export declare const colDefValueFormatter: <T>(colDef: ColDef<T>) => ValueFormat
 export declare const colDefMaxSelectableValues: <T>(colDef: ColDef<T>) => number | null;
 export declare const isColDefSingleSelect: <T>(colDef: ColDef<T>) => boolean;
 export declare const isColDefNumericDataType: <T>(colDef: ColDef<T>) => boolean;
+export declare const flattenAggregateFieldHierarchy: (hierarchy: AggregateFieldHierarchy | undefined) => string[];
+export declare const getAggregateFields: <T>(colDef: ColDef<T>) => string[];
+export declare const getAggregateLeafFields: (hierarchy: AggregateFieldHierarchy | undefined) => string[];
+export declare const getAggregateRootField: <T>(colDef: ColDef<T>) => string | undefined;
 export declare const isAggregateColDef: <T>(colDef: ColDef<T>) => boolean;
 export declare const processRowGroupCols: (rowGroupCols: ColumnVO[], colDefs: (ColDef | null | undefined)[] | undefined) => ColumnVO[];
 export declare const mapColsToColumnV0: (columns: Column[]) => ColumnVO[];

package/pv-components/dist/vue/visualizations/components/tables/PvDataTable/table-components/FilterGroupMenu.vue.d.ts

@@ -0,0 +1,21 @@
+import { ColDef } from 'ag-grid-community';
+import { VNodeProps, AllowedComponentProps, ComponentCustomProps, PublicProps, ShallowUnwrapRef, Ref, VNode } from 'vue';
+export interface FilterGroupMenuProps<T> {
+    filterColDef: ColDef<T>;
+}
+declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, never> & FilterGroupMenuProps<T> & Partial<{}>> & PublicProps;
+    expose(exposed: ShallowUnwrapRef<{
+        openForTest: () => void;
+        selectedValues: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    }>): void;
+    attrs: any;
+    slots: {};
+    emit: {};
+}>) => VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/pv-components/dist/vue/visualizations/components/tables/PvDataTable/types.d.ts

@@ -44,6 +44,12 @@ export interface TooltipDatum {
     [key: string]: string | number | undefined;
 }
 export type ChartTooltipRenderer = (params: AgCartesianSeriesTooltipRendererParams<TooltipDatum>) => string;
+export interface AggregateFieldHierarchy {
+    /** Field represented by this hierarchy node. Parent/child relationships are determined by nesting. */
+    field: string;
+    /** Child fields nested under this field. */
+    children?: AggregateFieldHierarchy[];
+}
 export interface ColDefContextProps<T> {
     /**
      * Display name for the aggregation function (e.g. "Sum", "Average", etc.) to show in the UI, if different from the aggFunc name
@@ -139,38 +145,44 @@ export interface ColDefContextProps<T> {
     customTooltipRenderer?: ChartTooltipRenderer;
     /**
      * For server-side filtering, list of associated column IDs to query against when searching for filter values.
-     *
-     * Interaction with `aggregateFields`:
-     * - `queryColIds` only, with query: rows matching the query in any `queryColIds` field are found,
-     *   then the base column's `field` values are collected from those rows.
-     * - `queryColIds` + `aggregateFields`, with query: rows matching the query via `queryColIds` are found,
-     *   then values are collected from each `aggregateFields` field (not the base `field`).
-     * - `queryColIds` only, no query: ignored — all values from the base `field` are returned.
-     * - `aggregateFields` only, no query: values are collected from each `aggregateFields` field across all rows.
      */
     queryColIds?: string[];
     /**
-     * A list of fields to use when aggregating data for this column.
-     * Fields must be present as their own columns in the table.
-     * The filter types must match between the aggregated column AND the fields used for aggregation.
-     * Filters for the aggregated fields will be hidden from the UI.
+     * Hierarchy of fields represented by this aggregate filter column.
      *
-     * Requires `enableAdvancedFilter: true` on the table — columns with `aggregateFields` are
-     * excluded (and may log a console warning) when advanced filtering is disabled.
+     * Example: `{ field: "health_system", children: [{ field: "provider_id" }] }`
+     * renders health systems as parent options and providers as nested child options.
+     * Fields must be present as their own columns in the table. Filters for the
+     * hierarchy fields are hidden from the filter panel in favor of this aggregate filter.
      *
-     * Selected filter values are routed back to their originating field via `colField` metadata
-     * and composed into an OR join across fields, then ANDed with existing filters.
+     * Requires `enableAdvancedFilter: true` on the table — columns with an aggregate hierarchy
+     * are excluded (and may log a console warning) when advanced filtering is disabled.
+     */
+    aggregateFieldHierarchy?: AggregateFieldHierarchy;
+    /**
+     * Aggregate filter column for columns that have "peer" relationships, as opposed to hierarchical
+     * Requires `enableAdvancedFilter: true` on the table — columns with aggregate fields
+     * are excluded (and may log a console warning) when advanced filtering is disabled.
      */
     aggregateFields?: string[];
     /**
      * If true, this column is considered a "dev" column and will only be shown when devMode is enabled
      */
     devOnly?: boolean;
+    /**
+     * A group of boolean sub-fields to render as a hover submenu above the filter options.
+     * Each field in `fields` must be present as a column in the table.
+     * Selecting an item toggles a `<field> = "true"` condition in the advanced filter model.
+     */
+    filterGroup?: {
+        label: string;
+        fields: string[];
+    };
 }
 export interface FilterValuesSetHandlerParams<T> {
     api?: GridApi<T>;
     colDef: ColDef<T>;
-    filterModel?: FilterModel | null;
+    filterModel?: FilterModel | AdvancedFilterModel | null;
     query?: string;
     selectedValues?: (string | null)[];
     /** Pagination offset for "see more" requests */
@@ -191,6 +203,8 @@ export interface FilterValueMatchResult {
 }
 export interface FilterValuesResponse {
     values: (FilterValueResponseOption | null)[];
+    /** Whether additional matching values are available after this page */
+    hasMore?: boolean;
     /** Total count of matching values (before pagination/truncation) */
     totalCount?: number;
 }
@@ -217,6 +231,8 @@ export interface FilterValueResponseOption {
     matchedValue?: string;
     /** The field used to match the value (for search scenarios) */
     matchedField?: string;
+    /** Optional PvMenu option props to apply when rendering this value in custom/nested filters. */
+    menuOption?: Partial<Omit<MenuOption<FilterValueResponseOption>, "id" | "text" | "children" | "context">>;
     /** Nested child options for hierarchical/cascade filtering */
     children?: FilterValueResponseOption[];
     /** Total number of children available (may exceed children.length when paginating) */

package/pv-components/dist/vue/visualizations/components/tables/PvDataTable/useFilterStore.d.ts

@@ -21,6 +21,7 @@ export declare const createFilterStore: () => {
         filterModel?: FilterModel | AdvancedFilterModel;
         offset?: number;
         parentId?: string;
+        useStaged?: boolean;
     }) => Promise<(string | null)[]>;
     filterValueContext: (colField: string, value: string | null) => FilterValueResponseOption | null | undefined;
     filterModelEmpty: ComputedRef<boolean>;
@@ -51,6 +52,7 @@ export declare const createFilterStore: () => {
     getStagedSelectedValues: (colField: string) => (string | null)[];
     setStagedSelectedValues: (colField: string, selectedValues: (string | null)[]) => void;
     filterValueSearchTextMap: Ref<Record<string, string | null>, Record<string, string | null>>;
+    filterValuesHasMoreMap: Ref<Record<string, boolean | undefined>, Record<string, boolean | undefined>>;
     filterValuesTotalCountMap: Ref<Record<string, number | undefined>, Record<string, number | undefined>>;
 };
 export declare const useFilterStore: () => {
@@ -67,6 +69,7 @@ export declare const useFilterStore: () => {
         filterModel?: FilterModel | AdvancedFilterModel;
         offset?: number;
         parentId?: string;
+        useStaged?: boolean;
     }) => Promise<(string | null)[]>;
     filterValueContext: (colField: string, value: string | null) => FilterValueResponseOption | null | undefined;
     filterModelEmpty: ComputedRef<boolean>;
@@ -97,5 +100,6 @@ export declare const useFilterStore: () => {
     getStagedSelectedValues: (colField: string) => (string | null)[];
     setStagedSelectedValues: (colField: string, selectedValues: (string | null)[]) => void;
     filterValueSearchTextMap: Ref<Record<string, string | null>, Record<string, string | null>>;
+    filterValuesHasMoreMap: Ref<Record<string, boolean | undefined>, Record<string, boolean | undefined>>;
     filterValuesTotalCountMap: Ref<Record<string, number | undefined>, Record<string, number | undefined>>;
 };

package/pv-components/dist/vue/visualizations/components/tables/PvDataTable/useSetFilter.d.ts

@@ -6,6 +6,7 @@ export interface UseSetFilterOptions<T> {
     filterColDef: Ref<ColDef<T>>;
     filterStyle?: Ref<"horizontal" | "vertical">;
     onSelectionChanged?: () => void;
+    filterGroupStagedFields?: Ref<Set<string>>;
 }
 export declare const useSetFilter: <T>(options: UseSetFilterOptions<T>) => {
     selectedValues: WritableComputedRef<(string | null)[], (string | null)[]>;
@@ -32,18 +33,20 @@ export declare const useSetFilter: <T>(options: UseSetFilterOptions<T>) => {
     filterOptionsSortDescription: ComputedRef<string | undefined>;
     filterOptionsSortTooltip: ComputedRef<string | undefined>;
     totalOptionCount: ComputedRef<number | undefined>;
+    hasMoreOptions: ComputedRef<boolean | undefined>;
     isAggregate: ComputedRef<boolean>;
     cascadeSelectionState: Ref<{
-        selectedParentIds: string[];
-        selectedChildrenIds: string[];
-        deselectedChildrenIds: string[];
-    }, MultiSelectState | {
-        selectedParentIds: string[];
-        selectedChildrenIds: string[];
-        deselectedChildrenIds: string[];
-    }>;
+        id: string;
+        state: "selected" | "deselected";
+        children?: /*elided*/ any[] | undefined;
+    }[], MultiSelectState | {
+        id: string;
+        state: "selected" | "deselected";
+        children?: /*elided*/ any[] | undefined;
+    }[]>;
     filterValueContext: (colField: string, value: string | null) => FilterValueResponseOption | null | undefined;
     formatDisplayValue: (input: string | null) => string | null;
+    resolvedFilterValueContext: (input: string | null) => FilterValueResponseOption | null | undefined;
     isUnresolvedMetadataValue: (value: string | null) => boolean;
     getLatestFilterValues: (fetchNewValues?: boolean, forceFetchValues?: boolean) => Promise<void>;
     addSelectedValue: (value: string | null, field?: string) => void;