@turquoisehealth/pit-viper 2.237.0 → 2.238.1-dev.0

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

@@ -30,9 +30,15 @@ export interface MenuOption<T = unknown> {
     subText?: string;
     /** Value of the secondary text which appears on the menu item. Number shows up as a counter badge, string shows up as plain text */
     secondaryText?: number | string;
+    /** When true, a spinner takes the place of the secondary text. Takes precedence over secondaryIcon and secondaryText. */
+    secondaryLoading?: boolean;
+    /** Icon rendered in place of the secondary text. Takes precedence over secondaryText. */
+    secondaryIcon?: string;
     subduedText?: string;
     icon?: string;
     hoverTitle?: string;
+    /** Explanatory copy surfaced as an info-icon tooltip at the end of the menu item. */
+    description?: string;
     /** Optional Datadog RUM action name applied to the interactive menu item. */
     rumActionName?: string;
     /** ARIA popup type for options with custom child content. Defaults to menu. */

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

@@ -49,6 +49,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<PvDropdownProps
             readonly cssCustomListProperties?: CSSProperties | undefined;
             readonly cssCustomProperties?: CSSProperties | undefined;
             readonly isList?: boolean | undefined;
+            readonly listId?: string | undefined;
+            readonly listRole?: string | undefined;
             readonly isSortable?: boolean | undefined;
             readonly "onList-order-updated"?: ((value: string[]) => any) | undefined;
         } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
@@ -77,6 +79,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<PvDropdownProps
             cssCustomProperties: CSSProperties;
             alignment: "top" | "right" | "top right";
             isList: boolean;
+            listId: string;
+            listRole: string;
             isSortable: boolean;
         }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
@@ -102,15 +106,19 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<PvDropdownProps
         cssCustomProperties: CSSProperties;
         alignment: "top" | "right" | "top right";
         isList: boolean;
+        listId: string;
+        listRole: string;
         isSortable: boolean;
     }> & Omit<Readonly< PvPopoverProps> & Readonly<{
         "onList-order-updated"?: ((value: string[]) => any) | undefined;
-    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "isSortable")> & {
+    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "listId" | "listRole" | "isSortable")> & {
         popoverRoot: HTMLElement | null;
     } & {} & ComponentCustomProperties & {} & {
         $slots: {
+            header?(_: {}): any;
             default?(_: {}): any;
             default?(_: {}): any;
+            footer?(_: {}): any;
         };
     }) | null;
 }, HTMLDivElement>, {

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

@@ -23,6 +23,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     "controlled-change": (filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any;
     "filter-change": (event: PvFilterPanelFilterChangeEvent) => any;
     "focus-change": (field: string, value: string, option: PvFilterPanelOption) => any;
+    "remove-external-filter": (key: string, value: string) => any;
     "handle-settings-icon": (field: string, colDef: PvFilterPanelColDef) => any;
     "open-change": (field: string, open: boolean, colDef: PvFilterPanelColDef) => any;
     "search-change": (field: string, query: string, colDef: PvFilterPanelColDef) => any;
@@ -37,6 +38,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     "onControlled-change"?: ((filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any) | undefined;
     "onFilter-change"?: ((event: PvFilterPanelFilterChangeEvent) => any) | undefined;
     "onFocus-change"?: ((field: string, value: string, option: PvFilterPanelOption) => any) | undefined;
+    "onRemove-external-filter"?: ((key: string, value: string) => any) | undefined;
     "onHandle-settings-icon"?: ((field: string, colDef: PvFilterPanelColDef) => any) | undefined;
     "onOpen-change"?: ((field: string, open: boolean, colDef: PvFilterPanelColDef) => any) | undefined;
     "onSearch-change"?: ((field: string, query: string, colDef: PvFilterPanelColDef) => any) | undefined;

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

@@ -1,4 +1,4 @@
-import { PvFilterPanelFilterModel, PvFilterPanelProps, PvFilterPanelColDef, PvFilterPanelFilterChangeEvent, PvFilterPanelOption, PvFilterPanelSuggestion } from './types';
+import { PvFilterPanelFilterModel, PvFilterPanelProps, PvFilterPanelColDef, PvFilterPanelFilterChangeEvent, PvFilterPanelOption, PvFilterPanelSuggestion, PvFilterPanelExternalFilterGroup } from './types';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 type __VLS_Props = PvFilterPanelProps;
 type __VLS_PublicProps = {
@@ -22,6 +22,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     "controlled-change": (filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any;
     "filter-change": (event: PvFilterPanelFilterChangeEvent) => any;
     "focus-change": (field: string, value: string, option: PvFilterPanelOption) => any;
+    "remove-external-filter": (key: string, value: string) => any;
     "handle-settings-icon": (field: string, colDef: PvFilterPanelColDef) => any;
     "open-change": (field: string, open: boolean, colDef: PvFilterPanelColDef) => any;
     "search-change": (field: string, query: string, colDef: PvFilterPanelColDef) => any;
@@ -36,6 +37,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     "onControlled-change"?: ((filterKey: string, values: string[], colDef: PvFilterPanelColDef) => any) | undefined;
     "onFilter-change"?: ((event: PvFilterPanelFilterChangeEvent) => any) | undefined;
     "onFocus-change"?: ((field: string, value: string, option: PvFilterPanelOption) => any) | undefined;
+    "onRemove-external-filter"?: ((key: string, value: string) => any) | undefined;
     "onHandle-settings-icon"?: ((field: string, colDef: PvFilterPanelColDef) => any) | undefined;
     "onOpen-change"?: ((field: string, open: boolean, colDef: PvFilterPanelColDef) => any) | undefined;
     "onSearch-change"?: ((field: string, query: string, colDef: PvFilterPanelColDef) => any) | undefined;
@@ -72,6 +74,7 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
     clearAllLabel: string;
     disableWhileLoading: boolean;
     enableFilterSearch: boolean;
+    externalFilters: PvFilterPanelExternalFilterGroup[];
     filterSearchPlaceholder: string;
     hideCollapseButton: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;

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

@@ -1,11 +1,14 @@
-import { PvFilterPanelAppliedFiltersSectionProps, PvFilterPanelFilterType, PvFilterPanelAppliedGroup } from './types';
+import { PvFilterPanelAppliedFiltersSectionProps, PvFilterPanelExternalFilterGroup, PvFilterPanelFilterType, PvFilterPanelAppliedGroup } from './types';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 declare const _default: DefineComponent<PvFilterPanelAppliedFiltersSectionProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "remove-filter": (filterKey: string, value: string, type?: PvFilterPanelFilterType | undefined) => any;
+    "remove-external-filter": (key: string, value: string) => any;
 }, string, PublicProps, Readonly<PvFilterPanelAppliedFiltersSectionProps> & Readonly<{
     "onRemove-filter"?: ((filterKey: string, value: string, type?: PvFilterPanelFilterType | undefined) => any) | undefined;
+    "onRemove-external-filter"?: ((key: string, value: string) => any) | undefined;
 }>, {
     readOnly: boolean;
+    externalFilters: PvFilterPanelExternalFilterGroup[];
     appliedCount: number;
     appliedGroups: PvFilterPanelAppliedGroup[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;

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

@@ -289,6 +289,21 @@ export interface PvFilterPanelAppliedGroup {
     label: string;
     values: PvFilterPanelAppliedValue[];
 }
+/**
+ * A filter that is applied outside the panel's own controls - a table search bar's partial match, a
+ * saved view, a URL parameter - surfaced at the top of the Applied tab so every active narrowing is
+ * visible in one place. The panel only displays these: it never writes them to the filter model, and
+ * removing one is reported back through `remove-external-filter` for the owner to act on.
+ */
+export interface PvFilterPanelExternalFilterGroup {
+    /** Stable key echoed back with removals. */
+    key: string;
+    /** Heading shown above the group's tags. */
+    label: string;
+    /** When false, tags render without a clear button and clear-all leaves them alone. Defaults to true. */
+    removable?: boolean;
+    values: PvFilterPanelAppliedValue[];
+}
 export type PvFilterPanelControlChange = {
     checked: boolean;
     field?: string;
@@ -468,6 +483,8 @@ export interface PvFilterPanelAccordionProps {
 export interface PvFilterPanelAppliedFiltersSectionProps {
     appliedCount?: number;
     appliedGroups?: PvFilterPanelAppliedGroup[];
+    /** Filters applied outside the panel, rendered above the panel's own applied groups. */
+    externalFilters?: PvFilterPanelExternalFilterGroup[];
     readOnly?: boolean;
 }
 export interface PvFilterPanelCategoryButtonRowProps {
@@ -506,6 +523,8 @@ export type PvFilterPanelEmits = {
     "facet-change": [field: string, facets: Record<string, string[]>, colDef: PvFilterPanelColDef];
     "filter-change": [event: PvFilterPanelFilterChangeEvent];
     "focus-change": [field: string, value: string, option: PvFilterPanelOption];
+    /** Emitted when an external filter tag is cleared, including via clear all. */
+    "remove-external-filter": [key: string, value: string];
     "handle-settings-icon": [field: string, colDef: PvFilterPanelColDef];
     "load-more": [field: string, colDef: PvFilterPanelColDef, query: string, parentId?: string];
     "open-change": [field: string, open: boolean, colDef: PvFilterPanelColDef];
@@ -542,6 +561,12 @@ export interface PvFilterPanelProps {
      */
     enableFilterSearch?: boolean;
     enableFocusView?: boolean;
+    /**
+     * Filters applied outside this panel (e.g. a search bar's partial match), shown at the top of the
+     * Applied tab. They count toward the applied badge and clear all, but are never written to the
+     * filter model - clearing one emits `remove-external-filter` for the owner to handle.
+     */
+    externalFilters?: PvFilterPanelExternalFilterGroup[];
     /** @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>;
     /** @deprecated Prefer filterStore/filterOptionsHandler. Initial/options loading state keyed by column key (`colId` when present, otherwise `field`). */

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

@@ -8,6 +8,10 @@ export interface PvPopoverProps {
     cssCustomProperties?: CSSProperties;
     /** When true, renders the content inside a `<ul>` list element. */
     isList?: boolean;
+    /** id applied to the inner list element, so a trigger can reference it via aria-controls. */
+    listId?: string;
+    /** ARIA role for the inner list element. Defaults to `list`. */
+    listRole?: string;
     /** When true and isList is true, enables drag-and-drop reordering of list items. */
     isSortable?: boolean;
 }
@@ -21,13 +25,17 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<PvPopoverProps,
     cssCustomProperties: CSSProperties;
     alignment: "top" | "right" | "top right";
     isList: boolean;
+    listId: string;
+    listRole: string;
     isSortable: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
     popoverRoot: HTMLDivElement;
     popoverList: HTMLUListElement;
 }, HTMLDivElement>, {
+    header?(_: {}): any;
     default?(_: {}): any;
     default?(_: {}): any;
+    footer?(_: {}): any;
 }>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -51,7 +51,21 @@ type __VLS_PublicProps = {
     "query": QueryBuilderOutput | null;
     "options"?: QueryBuilderSuggestionMenuOption[];
 } & __VLS_Props;
-declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        footer?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {
+        'query-builder-input': HTMLDivElement;
+        'search-input': HTMLInputElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:options": (value: QueryBuilderSuggestionMenuOption[]) => any;
     "update:searchText": (value: string) => any;
     "update:query": (value: QueryBuilderOutput | null) => any;
@@ -74,4 +88,10 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     'query-builder-input': HTMLDivElement;
     'search-input': HTMLInputElement;
 }, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -10,7 +10,7 @@ export interface QueryTerm {
     exactMatch?: boolean;
     queryText?: string;
 }
-export interface QueryBuilderSuggestionMenuOption extends MenuOption {
+export interface QueryBuilderSuggestionMenuOption extends MenuOption<QueryTerm> {
     queryTerm?: QueryTerm;
 }
 /**

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

@@ -23,6 +23,8 @@ declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOp
             readonly cssCustomListProperties?: CSSProperties | undefined;
             readonly cssCustomProperties?: CSSProperties | undefined;
             readonly isList?: boolean | undefined;
+            readonly listId?: string | undefined;
+            readonly listRole?: string | undefined;
             readonly isSortable?: boolean | undefined;
             readonly "onList-order-updated"?: ((value: string[]) => any) | undefined;
         } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
@@ -51,6 +53,8 @@ declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOp
             cssCustomProperties: CSSProperties;
             alignment: "top" | "right" | "top right";
             isList: boolean;
+            listId: string;
+            listRole: string;
             isSortable: boolean;
         }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
@@ -76,15 +80,19 @@ declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOp
         cssCustomProperties: CSSProperties;
         alignment: "top" | "right" | "top right";
         isList: boolean;
+        listId: string;
+        listRole: string;
         isSortable: boolean;
     }> & Omit<Readonly< PvPopoverProps> & Readonly<{
         "onList-order-updated"?: ((value: string[]) => any) | undefined;
-    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "isSortable")> & {
+    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "listId" | "listRole" | "isSortable")> & {
         popoverRoot: HTMLElement | null;
     } & {} & ComponentCustomProperties & {} & {
         $slots: {
+            header?(_: {}): any;
             default?(_: {}): any;
             default?(_: {}): any;
+            footer?(_: {}): any;
         };
     }) | null;
 }, any>;

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

@@ -13,6 +13,11 @@ 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;
+/**
+ * Whether a column's header should sit on the right edge. Numeric data types
+ * right-align by convention, and so does AG Grid's own `rightAligned` type.
+ */
+export declare const isColDefRightAligned: <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[];

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

@@ -18,6 +18,8 @@ declare const _default: DefineComponent<FilterGroupMenuProps, {
             readonly cssCustomListProperties?: CSSProperties | undefined;
             readonly cssCustomProperties?: CSSProperties | undefined;
             readonly isList?: boolean | undefined;
+            readonly listId?: string | undefined;
+            readonly listRole?: string | undefined;
             readonly isSortable?: boolean | undefined;
             readonly "onList-order-updated"?: ((value: string[]) => any) | undefined;
         } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
@@ -46,6 +48,8 @@ declare const _default: DefineComponent<FilterGroupMenuProps, {
             cssCustomProperties: CSSProperties;
             alignment: "top" | "right" | "top right";
             isList: boolean;
+            listId: string;
+            listRole: string;
             isSortable: boolean;
         }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
@@ -71,15 +75,19 @@ declare const _default: DefineComponent<FilterGroupMenuProps, {
         cssCustomProperties: CSSProperties;
         alignment: "top" | "right" | "top right";
         isList: boolean;
+        listId: string;
+        listRole: string;
         isSortable: boolean;
     }> & Omit<Readonly< PvPopoverProps> & Readonly<{
         "onList-order-updated"?: ((value: string[]) => any) | undefined;
-    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "isSortable")> & {
+    }>, "popoverRoot" | ("cssCustomProperties" | "alignment" | "isList" | "listId" | "listRole" | "isSortable")> & {
         popoverRoot: HTMLElement | null;
     } & {} & ComponentCustomProperties & {} & {
         $slots: {
+            header?(_: {}): any;
             default?(_: {}): any;
             default?(_: {}): any;
+            footer?(_: {}): any;
         };
     }) | null;
 }, HTMLDivElement>;

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

@@ -61,7 +61,8 @@ export interface ColDefContextProps<T> extends Omit<PvFilterPanelColDefContext,
      */
     aggFuncDisplayName?: string;
     /**
-     * A map of aggregation function names to descriptions shown in chart-series menu tooltips.
+     * A map of aggregation function names to descriptions, shown as an info-icon tooltip on the
+     * matching option in the header aggregation selector and in chart-series menus.
      */
     aggFuncDescriptionMap?: Record<string, string>;
     /**

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

@@ -2,5 +2,11 @@ import { Theme } from 'ag-grid-community';
 export declare const PitViperAGGridBaseTheme: Theme;
 export declare const PitViperAGGridNoBordersTheme: Theme;
 export declare const PitViperAGGridGroupedTheme: Theme;
-export type PvDataTableTheme = "pv-data-table-base" | "pv-data-table-grouped" | "pv-data-table-grouped-card";
+/**
+ * Matches the `.pv-table` CSS framework styling used by components like
+ * PvDataWidget: gray header, no wrapper border or radius, no row hover, and
+ * a single hairline rule between rows.
+ */
+export declare const PitViperAGGridClassicTheme: Theme;
+export type PvDataTableTheme = "pv-data-table-base" | "pv-data-table-grouped" | "pv-data-table-grouped-card" | "pv-data-table-classic";
 export declare const themeMap: Record<PvDataTableTheme, Theme>;