@turquoisehealth/pit-viper 2.253.0 → 2.255.0

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

@@ -0,0 +1,15 @@
+import { PvBoxPlotMarker, PvBoxPlotProps, PvBoxPlotStats } from './types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const _default: DefineComponent<PvBoxPlotProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<PvBoxPlotProps> & Readonly<{}>, {
+    highlight: number | null;
+    height: number;
+    ariaLabel: string;
+    markers: PvBoxPlotMarker[];
+    valueFormatter: (value: number) => string;
+    hideLabels: boolean;
+    stats: PvBoxPlotStats | null;
+    xMax: number | null;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    container: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,7 @@
+/** Rounds `value` up to a clean axis bound. Returns 100 for zero or negative input so an empty axis still has a scale. */
+export declare const niceCeiling: (value: number) => number;
+/** Tick interval that gives about five ticks on an axis from 0 to `max`. */
+export declare const niceStep: (max: number) => number;
+/** Tick positions from 0 to `max`, inclusive. */
+export declare const axisTicks: (max: number) => number[];
+export declare const formatWholeDollars: (value: number) => string;

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

@@ -0,0 +1,33 @@
+export interface PvBoxPlotMarker {
+    /** Dot color: any CSS color, including a var(). Defaults to coral ($dataviz-3). */
+    color?: string;
+    /** Optional label drawn above the plot with the formatted value, e.g. "Anchor". */
+    label?: string;
+    /** Position of the dot on the axis. */
+    value: number;
+}
+export interface PvBoxPlotStats {
+    p10: number;
+    p25: number;
+    p50: number;
+    p75: number;
+    p90: number;
+}
+export interface PvBoxPlotProps {
+    /** Accessible description of the plot. Defaults to one generated from the stats and markers. */
+    ariaLabel?: string;
+    /** Height of the plot in pixels. Defaults to 180. The width always fills the container. */
+    height?: number;
+    /** Transient marker, e.g. the rate of a hovered table row: a dashed line with a small dot. Drawn above the markers. */
+    highlight?: number | null;
+    /** Hides the percentile labels, the P10 and P90 amounts, and the median callout. Marker labels still show. */
+    hideLabels?: boolean;
+    /** Persistent dots on the axis, such as an anchor or an offer. */
+    markers?: PvBoxPlotMarker[];
+    /** The distribution: whiskers P10 to P90, box P25 to P75, a line at the median. Nothing renders without it. */
+    stats?: PvBoxPlotStats | null;
+    /** Formats every amount on the axis and in the labels. Defaults to whole US dollars, e.g. "$1,250". */
+    valueFormatter?: (value: number) => string;
+    /** Fixed upper bound of the axis, so the plot can line up with a sibling chart. Defaults to a rounded bound above P90 and every marker. */
+    xMax?: number | null;
+}

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

@@ -3,6 +3,7 @@ import { AdvancedFilterModel, FilterModel } from 'ag-grid-enterprise';
 import { MenuOption, MultiSelectState } from '../../../types';
 import { ColDef, ValueFormatterFunc } from 'ag-grid-community';
 import { PvRangeScale, PvRangeValue } from '../PvRange/types';
+import { FooterPosition } from '../PvMultiSelectButton/types';
 export type PvFilterPanelCategory = string;
 export type PvFilterPanelFilterType = "value" | "range" | "boolean" | "exists";
 export type PvFilterPanelFilterModelType = "advanced" | "regular";
@@ -124,6 +125,10 @@ export interface PvFilterPanelColDefContext {
      * Optional renderer to provide content below the filter options list
      */
     filterFooterRenderer?: Component;
+    /**
+     * Where filterFooterRenderer renders relative to the Select All / Clear All actions. Defaults to "above-actions".
+     */
+    filterFooterPosition?: FooterPosition;
     /**
      * 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.

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

@@ -1,4 +1,4 @@
-import { PvMultiSelectButtonProps, PvSelectButtonVariant, PvSelectButtonSize, MenuActionsVariant } from './types';
+import { PvMultiSelectButtonProps, PvSelectButtonVariant, PvSelectButtonSize, MenuActionsVariant, FooterPosition } from './types';
 import { MenuOption, MultiSelectState, SeeMoreEvent, MenuAction } from '../../../types';
 import { VNodeProps, AllowedComponentProps, ComponentCustomProps, PublicProps, ShallowUnwrapRef, Component, CSSProperties, VNode } from 'vue';
 import { PvCounterBadgeVariant } from '../PvCounterBadge/types';
@@ -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;
+            footerPosition: FooterPosition;
             singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
@@ -108,6 +109,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;
+            footerPosition: FooterPosition;
             singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;
@@ -154,6 +156,54 @@ 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;
+            footerPosition: FooterPosition;
+            singleSelect: boolean;
+            highlightSearchText: boolean;
+            enableCascadeSelection: boolean;
+            counterStyle: "primary" | "secondary";
+        }): any;
+        footer?(_: {
+            selectedItems: MenuOption<T>[];
+            searchInput: string;
+            slotContext: Record<string, unknown> | undefined;
+            isOpen: boolean;
+            isLoading: boolean;
+            companyLogo: string;
+            counterBadgeVariant: PvCounterBadgeVariant;
+            countSelectedParents: boolean;
+            defaultOpen: boolean;
+            enableChildExpansion: boolean;
+            groupings: string[];
+            hideParentOnChildQueryMatch: boolean;
+            icon: string;
+            isSeeMoreLoading: boolean;
+            hasMoreOptions: boolean;
+            loadingText: string;
+            optionsAction: MenuAction<T> | undefined;
+            optionsRenderer: Component;
+            overlayTrigger: boolean;
+            parentSelectsAllChildren: boolean;
+            popoverCssProperties: CSSProperties;
+            popoverProperties: PvPopoverV2Props;
+            prefixLabel: string;
+            searchPlaceholder: string;
+            teleportLocation: string;
+            totalOptionCount: number;
+            additionalCounter: number;
+            rumFilterName: string;
+            rumActionName: string;
+            counterPosition: "none" | "right" | "left";
+            variant: PvSelectButtonVariant;
+            size: PvSelectButtonSize;
+            label: string;
+            disableDropdownIcon: boolean;
+            disableClearIcon: boolean;
+            disableSearchInput: boolean;
+            disabled: boolean;
+            optionsVariant: "toggle" | "checkbox" | "icon" | "simple" | "company" | "avatar" | "checkmark";
+            options: MenuOption<T>[];
+            menuActionsVariant: MenuActionsVariant | null;
+            footerPosition: FooterPosition;
             singleSelect: boolean;
             highlightSearchText: boolean;
             enableCascadeSelection: boolean;

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

@@ -6,6 +6,7 @@ import { PvCounterBadgeVariant } from '../PvCounterBadge/types.ts';
 export type PvSelectButtonVariant = Extract<PvVariants, "secondary" | "ghost">;
 export type PvSelectButtonSize = Extract<PvSize, "lg" | "xl">;
 export type MenuActionsVariant = "select-clear" | "cancel-confirm";
+export type FooterPosition = "above-actions" | "below-actions";
 export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Record<string, unknown> = Record<string, unknown>> {
     /** Company logo name displayed on the trigger button */
     companyLogo?: string;
@@ -36,6 +37,8 @@ export interface PvMultiSelectButtonProps<T = unknown, SlotContext extends Recor
     enableCascadeSelection?: boolean;
     /** Display an expand/collapse icon for options that have children */
     enableChildExpansion?: boolean;
+    /** Where the footer slot renders relative to the menu actions. Defaults to "above-actions". */
+    footerPosition?: FooterPosition;
     /** Labels used to group options into named sections */
     groupings?: string[];
     /** When enableCascadeSelection is true, hide parent options in the dropdown when

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

@@ -1,20 +1,22 @@
+import { PvSidebarProps } from './types.ts';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
-type __VLS_Props = {
-    disableToggle?: boolean;
-    variant?: "primary" | "secondary";
-    newVersion?: boolean;
-};
+type __VLS_Props = PvSidebarProps;
 type __VLS_PublicProps = {
     modelValue?: boolean;
 } & __VLS_Props;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: {
-        'sidebar-header'?(_: {}): any;
-        sidebar?(_: {}): any;
+    slots: Partial<Record<string, (_: {}) => any>> & {
+        'sidebar-additional-header'?(_: {}): any;
+        'sidebar-additional-content'?(_: {}): any;
+        'sidebar-help-content'?(_: {}): any;
+        'sidebar-profile-content'?(_: {}): any;
         default?(_: {}): any;
     };
-    refs: {};
+    refs: {
+        sidebarPanel: HTMLDivElement;
+        popoverTeleportTarget: HTMLDivElement;
+    };
     rootEl: HTMLDivElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
@@ -29,7 +31,10 @@ declare const __VLS_component: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}
         collapsed: boolean;
     }) => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    sidebarPanel: HTMLDivElement;
+    popoverTeleportTarget: HTMLDivElement;
+}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -0,0 +1,9 @@
+import { PvSidebarNavItem } from './types.ts';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    items: PvSidebarNavItem[];
+    /** Keeps nested flyouts closed while the surface hosting this list is inactive. */
+    disabled?: boolean;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,3 @@
+import { PvSidebarNavItem } from './types.ts';
+/** True when the item itself or any of its descendants is the current page. */
+export declare const isNavItemActive: (item: PvSidebarNavItem) => boolean;

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

@@ -0,0 +1,44 @@
+export interface PvSidebarProps {
+    /** @deprecated Organization and profile menus are always click-only. This prop has no effect. */
+    disableOrgProfileHover?: boolean;
+    disableToggle?: boolean;
+    /** Top-level nav items, with optional nested children rendered as an accordion / hover flyout. */
+    navItems?: PvSidebarNavItem[];
+    /** Organizations rendered in the org-switcher dropdown, with optional nested entities. */
+    organizations?: PvSidebarOrgEntity[];
+    /** Identity rendered by the Profile footer trigger. */
+    profile?: PvSidebarProfile;
+    variant?: "primary" | "secondary";
+}
+export interface PvSidebarProfile {
+    avatarUrl?: string;
+    name: string;
+}
+export interface PvSidebarOrgEntity {
+    value: string | number;
+    label: string;
+    url: string;
+    avatarUrl?: string;
+    /** Marks this as the currently active organization/entity (server already knows from the current page). */
+    active?: boolean;
+    entities?: PvSidebarOrgEntity[];
+}
+export interface PvSidebarNavItem {
+    value: string | number;
+    label: string;
+    /** Leaf items link directly; parents with children may omit it. */
+    url?: string;
+    /** SVG symbol id, e.g. "home" — only rendered at the top level. */
+    icon?: string;
+    /** Marks this as the currently active item (server already knows from the current page). */
+    active?: boolean;
+    /** Named slot rendered in a full-height hover and focus panel instead of the compact flyout. */
+    hoverPanelSlot?: string;
+    /** Extra attributes spread directly onto the rendered <a> (e.g. { "data-turbolinks": "false" }). */
+    linkAttrs?: Record<string, string>;
+    external?: boolean;
+    badge?: "beta" | "legacy";
+    /** Draws a divider line above this item, starting a new group. Only rendered at the top level. */
+    separatorAtTop?: boolean;
+    children?: PvSidebarNavItem[];
+}

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

@@ -38,5 +38,7 @@ export interface PvSidebarNavItem {
     linkAttrs?: Record<string, string>;
     external?: boolean;
     badge?: "beta" | "legacy";
+    /** Draws a divider line above this item, starting a new group. Only rendered at the top level. */
+    separatorAtTop?: boolean;
     children?: PvSidebarNavItem[];
 }

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

@@ -68,6 +68,7 @@ export { default as PvTree } from './PvTree/PvTree.vue';
 export { default as PvTreeGroup } from './PvTree/PvTreeGroup.vue';
 export { default as PvProgressBar } from './PvProgressBar/PvProgressBar.vue';
 export { default as PvDistributionBar } from './PvDistributionBar/PvDistributionBar.vue';
+export { default as PvBoxPlot } from './PvBoxPlot/PvBoxPlot.vue';
 export { default as PvFilterPanel } from './PvFilterPanel/PvFilterPanel.vue';
 export { default as PvFilterModal } from './PvFilterModal/PvFilterModal.vue';
 export { default as PvHorizontalScroller } from './PvHorizontalScroller/PvHorizontalScroller.vue';
@@ -98,6 +99,7 @@ export type { RadioGroupOption } from './PvRadioGroup/types';
 export type { PvTableOfContentsItem } from './PvTableOfContents/types';
 export type { PvHorizontalScrollerProps } from './PvHorizontalScroller/types';
 export type { PvFilterModalProps } from './PvFilterModal/types';
+export type { PvBoxPlotMarker, PvBoxPlotProps, PvBoxPlotStats } from './PvBoxPlot/types';
 export type { PvHoverActionMenuPosition } from './PvHoverActionMenu/types';
 export type { PvMenuChildrenDisplay } from './PvMenu/types';
 export type { PvFilterPanelAggregateFieldHierarchy, PvFilterPanelColDef, PvFilterPanelColDefContext, PvFilterPanelControlChange, PvFilterPanelFilterChangeEvent, PvFilterPanelFilterChangeReason, PvFilterPanelFilterGroup, PvFilterPanelFilterModel, PvFilterPanelFilterModelType, PvFilterPanelFilterType, PvFilterPanelOption, PvFilterPanelOptionsHandler, PvFilterPanelOptionsHandlerParams, PvFilterPanelOptionsHandlerReason, PvFilterPanelOptionsResponse, PvFilterPanelOptionRawValue, PvFilterPanelProps, PvFilterPanelRangeConfig, PvFilterPanelResultCount, PvFilterPanelSuggestion, PvFilterStore, PvFilterStoreFetchOptionsParams, } from './PvFilterPanel/types';

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

@@ -252,9 +252,12 @@ export interface PvDataTableProps<T> {
     /**
      * Fetches the flat rows for `pivot`. Called on mount and whenever the filters change. The filters are applied by
      * the handler only; the grid doesn't re-apply them to the returned rows.
-     * If it rejects, the error is logged and the table shows no rows.
+     * If it rejects, the error is logged and the table shows no rows. Table search needs `filterValuesSetHandler` and
+     * `tableSearchHandler` with it.
      */
     serverSidePivotHandler?: (params: ServerSidePivotHandlerParams) => Promise<ServerSidePivotHandlerResponse<T>>;
+    /** Left-to-right order of the first `pivot` column's values; unlisted values follow, ordered by focus then alphabetically. */
+    pivotValueOrder?: string[];
     /** Maximum rows requested from `serverSidePivotHandler`. Defaults to 200. */
     pivotRowLimit?: number;
     /** Maximum generated pivot columns before the grid stops and emits `pivot-max-columns-exceeded`. Defaults to 50. */

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

@@ -2,6 +2,7 @@ import { ColDef, GridApi, ColDefField } from 'ag-grid-community';
 import { Ref, WritableComputedRef, ComputedRef, Component } from 'vue';
 import { MenuOption, MultiSelectState, SeeMoreEvent } from '../../../types';
 import { FilterValueResponseOption } from './types';
+import { FooterPosition } from '../../base/PvMultiSelectButton/types';
 /**
  * Source qualifier on the `filter_option_selected` RUM action.
  *
@@ -61,6 +62,7 @@ export declare const useSetFilter: <T>(options: UseSetFilterOptions<T>) => {
     filterOptionsRenderer: ComputedRef< Component | undefined>;
     filterHeaderRenderer: ComputedRef< Component | undefined>;
     filterFooterRenderer: ComputedRef< Component | undefined>;
+    filterFooterPosition: ComputedRef< FooterPosition | undefined>;
     filterOptionsSortDescription: ComputedRef<string | undefined>;
     filterOptionsSortTooltip: ComputedRef<string | undefined>;
     totalOptionCount: ComputedRef<number | undefined>;