@turquoisehealth/pit-viper 2.182.0 → 2.182.1-dev.1

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

@@ -41,6 +41,7 @@ export interface MenuOption<T = unknown> {
     handleSeeMore?: (payload: SeeMoreEvent) => Promise<MenuOption<T>[] | void> | MenuOption<T>[] | void;
     totalChildCount?: number;
     defaultExpanded?: boolean;
+    config?: MenuOptionConfig;
 }
 export interface MenuOptionConfig {
     renderer?: Component;
@@ -55,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/PvAvatar/PvAvatar.vue.d.ts

@@ -5,6 +5,8 @@ interface PvAvatarProps {
     icon?: string;
     /** URL of an image to display. Only rendered when `icon` and `initials` are not set. */
     image?: string;
+    /** Accessible alt text for the avatar image. Defaults to "" (decorative) when initials or other context provides the name. */
+    alt?: string;
     /** One or two character string displayed when no icon is provided. Takes priority over `image` when both are set. */
     initials?: string;
     /** Display size of the avatar. */

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

@@ -3,6 +3,8 @@ export interface PvAvatarGroupItem {
     initials?: string;
     /** URL of an image to display in the avatar. */
     image?: string;
+    /** Accessible alt text for the avatar image. Defaults to "" (decorative) when initials or other context provides the name. */
+    alt?: string;
     /**
      * Reserved for future use.
      * A default placeholder avatar is currently rendered whenever neither `initials`

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

@@ -23,6 +23,8 @@ export interface PvButtonProps {
     leftCounterBadge?: number;
     /** Optional counter on the right side of the button */
     rightCounterBadge?: number;
+    /** Accessible name for icon-only buttons (no label). Required when label is omitted. */
+    ariaLabel?: string;
 }
 export interface PvButtonWithTooltipProps extends PvButtonProps {
     /** Text to show within the tooltip */

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

@@ -4,6 +4,8 @@ interface PvCheckboxProps {
     disabled?: boolean;
     /** When true, displays the checkbox in an indeterminate (mixed) state. */
     indeterminate?: boolean;
+    /** Accessible name when no wrapping <label> is present. */
+    ariaLabel?: string;
 }
 type __VLS_Props = PvCheckboxProps;
 type __VLS_PublicProps = {

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/PvPopoverV2/types.d.ts

@@ -19,7 +19,7 @@ export interface PvPopoverV2Props {
     useTeleport?: boolean;
     /** When true, clicking outside the popover will not close it. */
     disableClickOutsideToClose?: boolean;
-    /** Delay in milliseconds before opening/closing the popover on hover. */
+    /** Delay in milliseconds before opening the popover. Closing is always immediate regardless of this value. */
     delay?: number;
     /** z-index applied to the floating popover element. */
     zIndex?: number;

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

@@ -6,6 +6,8 @@ type __VLS_Props = {
     max?: number;
     /** Step increment between values */
     step?: number;
+    /** Accessible name for the range slider */
+    ariaLabel?: string;
 };
 type __VLS_PublicProps = {
     modelValue: number;

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

@@ -11,6 +11,8 @@ export interface PvSegmentedControlOption {
     iconPosition?: "left" | "right";
     /** Visible text for the option. Omit for icon-only segments. */
     label?: string;
+    /** Accessible name for icon-only segments (no label). Required when label is omitted. */
+    ariaLabel?: string;
     /** Unique identifier emitted as the model value when this option is selected. */
     value: string;
 }

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

@@ -7,6 +7,8 @@ interface PvSwitchProps {
     size?: PvSwitchSize;
     /** Optional text label displayed next to the switch. */
     label?: string;
+    /** Accessible name for the switch when no visible label is provided. */
+    ariaLabel?: string;
     /** When true, the switch is non-interactive and visually dimmed. */
     disabled?: boolean;
     /** HTML id for the underlying checkbox input. Auto-generated when omitted. */
@@ -26,7 +28,6 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     size: PvSwitchSize;
-    id: string;
     disabled: boolean;
     hideCheckIcon: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLLabelElement>;

package/pv-components/dist/vue/visualizations/components/charts/PvDataTableWithChart/table-chart-components/PvTableOptionsPanel.vue.d.ts

@@ -0,0 +1,14 @@
+import { TableConfigOptions } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    groupedModeEnabled: boolean;
+    tableConfigOptions?: TableConfigOptions;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    "toggle-group": (enableGrouping: boolean) => any;
+    "overlay-change": (selectedIds: string[]) => any;
+}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onToggle-group"?: ((enableGrouping: boolean) => any) | undefined;
+    "onOverlay-change"?: ((selectedIds: string[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/pv-components/dist/vue/visualizations/components/charts/PvDataTableWithChart/table-chart-components/PvTableOverlayMenuItemRenderer.vue.d.ts

@@ -0,0 +1,11 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+interface TableOverlayContext {
+    rightIcon?: string;
+}
+type __VLS_Props = {
+    text: string;
+    disabled?: boolean;
+    context?: TableOverlayContext;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/pv-components/dist/vue/visualizations/components/charts/PvDataTableWithChart/types.d.ts

@@ -52,6 +52,15 @@ export interface CrosslineOverlayGroup {
     disabled?: boolean;
     disabledReason?: string;
 }
+export interface TableOverlayOption {
+    title: string;
+    icon: string;
+    field: string;
+}
+export interface TableConfigOptions {
+    /** Overlay options that appear as expandable checkboxes under "Table Overlay". */
+    tableOverlayOptions?: TableOverlayOption[];
+}
 export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
     /**
      * Boolean flag denoting whether all fields are focusable, meaning their filter options can be selected as focus in
@@ -108,6 +117,11 @@ export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
      * Enable toggle to group or ungroup
      */
     enableGroupingToggle?: boolean;
+    /**
+     * Configuration options for the Table Configuration dropdown panel.
+     * Includes table overlay options and can be extended with additional settings.
+     */
+    tableConfigOptions?: TableConfigOptions;
     /**
      * Css Properties
      */

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/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,27 +145,22 @@ 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;
+    /**
+     * @deprecated Use `aggregateFieldHierarchy` so parent/child relationships are explicit.
      */
     aggregateFields?: string[];
     /**
@@ -170,7 +171,7 @@ export interface ColDefContextProps<T> {
 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 */
@@ -217,6 +218,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>;
@@ -67,6 +68,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>;

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

@@ -34,16 +34,17 @@ export declare const useSetFilter: <T>(options: UseSetFilterOptions<T>) => {
     totalOptionCount: ComputedRef<number | 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;