@turquoisehealth/pit-viper 2.246.1 → 2.248.0

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

@@ -14,6 +14,7 @@ interface PvToastProps {
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
+        header?(_: {}): any;
         default?(_: {}): any;
     };
     refs: {};

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

@@ -1 +1 @@
-export type PvToastVariants = "info" | "success" | "error" | "dark";
+export type PvToastVariants = "info" | "success" | "error" | "warning" | "dark";

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

@@ -1,5 +1,5 @@
 import { SortChangedEvent, SelectionChangedEvent, RowSelectedEvent, RowDataUpdatedEvent, CellValueChangedEvent, ColumnValueChangedEvent, UndoStartedEvent, UndoEndedEvent, RedoStartedEvent, RedoEndedEvent, RowClickedEvent, FirstDataRenderedEvent, GridReadyEvent } from 'ag-grid-community';
-import { ColumnMovedEvent, ColumnResizedEvent, ColumnRowGroupChangedEvent, FilterChangedEvent } from 'ag-grid-enterprise';
+import { ColumnMovedEvent, ColumnResizedEvent, ColumnRowGroupChangedEvent, FilterChangedEvent, PivotMaxColumnsExceededEvent } from 'ag-grid-enterprise';
 import { FilterValueResponseOption, PvDataTableProps, PvDataTablePublicInterface, FocusUpdateEvent } from './types';
 import { VNodeProps, AllowedComponentProps, ComponentCustomProps, PublicProps, ShallowUnwrapRef, VNode } from 'vue';
 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<{
@@ -24,11 +24,12 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         readonly "onRedo-started"?: ((event: RedoStartedEvent<any, any>) => any) | undefined;
         readonly "onRedo-ended"?: ((event: RedoEndedEvent<any, any>) => any) | undefined;
         readonly "onRow-clicked"?: ((event: RowClickedEvent<T, any>) => any) | undefined;
+        readonly "onPivot-max-columns-exceeded"?: ((event: PivotMaxColumnsExceededEvent<T, any>) => any) | undefined;
         readonly "onFilter-metadata-changed"?: ((payload: {
             filterValueMap: Record<string, (FilterValueResponseOption | null)[]>;
             filterValueSelectedMetadataMap: Record<string, (FilterValueResponseOption | null)[]>;
         }) => any) | undefined;
-    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, "onHandle-settings-icon" | "onColumn-moved" | "onColumn-resized" | "onColumn-row-group-changed" | "onColumn-value-changed" | "onGrid-ready" | "onFilter-changed" | "onSort-changed" | "onFilter-opened" | "onFirst-data-rendered" | "onFocus-update" | "onSelection-changed" | "onRow-selected" | "onRow-data-updated" | "onCell-value-changed" | "onUndo-started" | "onUndo-ended" | "onRedo-started" | "onRedo-ended" | "onRow-clicked" | "onFilter-metadata-changed"> & PvDataTableProps<T> & Partial<{}>> & PublicProps;
+    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, "onHandle-settings-icon" | "onColumn-moved" | "onColumn-resized" | "onColumn-row-group-changed" | "onColumn-value-changed" | "onGrid-ready" | "onFilter-changed" | "onSort-changed" | "onFilter-opened" | "onFirst-data-rendered" | "onFocus-update" | "onSelection-changed" | "onRow-selected" | "onRow-data-updated" | "onCell-value-changed" | "onUndo-started" | "onUndo-ended" | "onRedo-started" | "onRedo-ended" | "onRow-clicked" | "onPivot-max-columns-exceeded" | "onFilter-metadata-changed"> & PvDataTableProps<T> & Partial<{}>> & PublicProps;
     expose(exposed: ShallowUnwrapRef<PvDataTablePublicInterface>): void;
     attrs: any;
     slots: {
@@ -56,6 +57,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         (e: "redo-started", event: RedoStartedEvent): void;
         (e: "redo-ended", event: RedoEndedEvent): void;
         (e: "row-clicked", event: RowClickedEvent<T>): void;
+        (e: "pivot-max-columns-exceeded", event: PivotMaxColumnsExceededEvent<T>): void;
         (e: "filter-metadata-changed", payload: {
             filterValueMap: Record<string, (FilterValueResponseOption | null)[]>;
             filterValueSelectedMetadataMap: Record<string, (FilterValueResponseOption | null)[]>;

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

@@ -2,6 +2,10 @@ import { GridApi } from 'ag-grid-community';
 import { ICellRendererParams, RowNode } from 'ag-grid-enterprise';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 interface AutoGroupColDefRendererParams {
+    /** Pivot tables show row labels as plain text, without the grouped-row chrome. */
+    plainLabel?: boolean;
+    /** Bolds the plain label, e.g. the "Total" row of a pivot with no row groups. */
+    boldLabel?: boolean;
     displayBaseAggregationsOnly: boolean;
     displayCount: boolean;
     displayRowNumber: boolean;

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

@@ -0,0 +1,19 @@
+import { IHeaderGroupParams } from 'ag-grid-enterprise';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface PvPivotGroupHeaderParams {
+    /** Secondary line under the group label, e.g. "(Incumbent)". */
+    subtitle?: string;
+    /** Hover text; defaults to the label. Useful when the label is shortened. */
+    tooltip?: string;
+    /** Position of the group, left to right; picks the bar color from the chart palette. */
+    colorIndex?: number;
+    /** Overrides the palette color for the bar. */
+    color?: string;
+    /** Shades the group header, e.g. for the incumbent. */
+    highlight?: boolean;
+}
+type __VLS_Props = {
+    params: IHeaderGroupParams & PvPivotGroupHeaderParams;
+};
+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/tables/PvDataTable/types.d.ts

@@ -4,7 +4,7 @@ import { Component, ComputedRef, CSSProperties, Ref } from 'vue';
 import { AdvancedFilterModel, CellSelectionOptions, FilterModel, GetContextMenuItemsParams, GridState, IServerSideGetRowsParams, ProcessCellForExportParams, ProcessDataFromClipboardParams, RowSelectionOptions, Theme, ValueFormatterFunc } from 'ag-grid-enterprise';
 import { PvDataTableTheme } from '../themes';
 import { PvDataTableFilterStore } from './useFilterStore';
-import { ColDef, GridApi, IsFullWidthRowParams, IsGroupOpenByDefaultParams, IsServerSideGroupOpenByDefaultParams, RefreshServerSideParams } from 'ag-grid-community';
+import { ColDef, ColumnVO, GridApi, IsFullWidthRowParams, IsGroupOpenByDefaultParams, IsServerSideGroupOpenByDefaultParams, RefreshServerSideParams } from 'ag-grid-community';
 import { QueryBuilderSuggestionMenuOption } from '../../base/PvQueryBuilderInput/useQueryBuilder';
 import { MenuOption, PvMultiSelectButtonSlotProps } from '../../base';
 import { PvFilterPanelAggregateFieldHierarchy, PvFilterPanelColDefContext, PvFilterPanelOption, PvFilterPanelOptionsHandlerParams, PvFilterPanelOptionsHandlerReason, PvFilterPanelOptionsResponse } from '../../base/PvFilterPanel/types';
@@ -56,6 +56,12 @@ export interface TooltipDatum {
 export type ChartTooltipRenderer = (params: AgCartesianSeriesTooltipRendererParams<TooltipDatum>) => string;
 export type AggregateFieldHierarchy = PvFilterPanelAggregateFieldHierarchy;
 export interface ColDefContextProps<T> extends Omit<PvFilterPanelColDefContext, "dataType" | "filterValueFormatter" | "valueDecimals"> {
+    /** PvDataTableWithChart only: always shown as a measure in each pivot group, next to the chart's y-axis. */
+    pivotValue?: boolean;
+    /** Pivot columns: the header for each of the column's values, e.g. a display name for an id. */
+    pivotGroupHeader?: (value: string) => PvPivotGroupHeaderConfig | undefined;
+    /** Measures: overrides for the measure's column in every pivot group, e.g. `headerName` or `valueFormatter`. */
+    pivotColDef?: Partial<ColDef<T>>;
     /**
      * Display name for the aggregation function (e.g. "Sum", "Average", etc.) to show in the UI, if different from the aggFunc name
      */
@@ -166,6 +172,44 @@ export interface FilterValueResponseOption extends Omit<PvFilterPanelOption, "ch
     /** Nested child options for hierarchical/cascade filtering */
     children?: FilterValueResponseOption[];
 }
+/** A pivot header group's label and styling, from the pivot column's `context.pivotGroupHeader`. */
+export interface PvPivotGroupHeaderConfig {
+    headerName?: string;
+    /** Second line, e.g. "(Incumbent)". */
+    subtitle?: string;
+    /** Hover text, e.g. the full name when the label is shortened. */
+    tooltip?: string;
+    /** Shades the header. */
+    highlight?: boolean;
+    /** Overrides the palette color for the group's tab. */
+    color?: string;
+}
+/** The pivot layout PvDataTable resolves from the colDefs' `rowGroup`, `pivot`, and `aggFunc`. */
+export interface PvDataTablePivot {
+    /** Fields shown down the side, one row per value (e.g. service line). May be empty for a single totals row. */
+    rowGroupCols: string[];
+    /** Fields whose values become header groups across the top (e.g. payer network). */
+    pivotCols: string[];
+    /** Measures shown inside each header group (e.g. total cost, rate score). */
+    valueCols: string[];
+}
+/**
+ * Request for the flat rows behind a pivot: one row per combination of the row group and pivot columns, each
+ * with its measures already aggregated by the server. Same shape as the chart's data request.
+ */
+export interface ServerSidePivotHandlerParams {
+    /** Row group columns followed by pivot columns. `id` is the column id and `field` the row field to return. */
+    rowGroupCols: ColumnVO[];
+    /** Measures, with the aggregation the server should apply. */
+    valueCols: ColumnVO[];
+    filterModel: FilterModel | AdvancedFilterModel | null;
+    /** Maximum number of rows to return. */
+    endRow: number;
+}
+export interface ServerSidePivotHandlerResponse<T> {
+    /** Aggregated rows: only the row group, pivot, and measure fields, not full rows. */
+    data: Partial<T>[];
+}
 export interface PvDataTableProps<T> {
     /**
      * Boolean flag denoting whether all fields are focusable, meaning their filter options can be selected as focus in
@@ -188,6 +232,26 @@ export interface PvDataTableProps<T> {
      * Handler to fetch server-side data. Only used for server-side row model.
      */
     serverSideRowHandler?: (params: IServerSideGetRowsParams<T>, isCsvExport?: boolean) => void;
+    /**
+     * Shows the table as a pivot, laid out by the colDefs' own AG Grid props: `rowGroup` columns down the side (by
+     * `rowGroupIndex`), `pivot` columns across the top (by `pivotIndex`), and the columns with an `aggFunc` as the
+     * measures in each group (`enableValue: false` leaves one out). The grid uses the client-side row model: rows come
+     * pre-aggregated from `serverSidePivotHandler`, or raw from `rowData` and aggregated in the browser. Fixed at
+     * mount; changing the layout requires a remount.
+     */
+    pivot?: boolean;
+    /**
+     * 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.
+     */
+    serverSidePivotHandler?: (params: ServerSidePivotHandlerParams) => Promise<ServerSidePivotHandlerResponse<T>>;
+    /** 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. */
+    pivotMaxGeneratedColumns?: number;
+    /** Row label when there are no `rowGroup` columns, so the single row still has a label. Defaults to "Total". */
+    pivotTotalLabel?: string;
     /**
      * Handler to fetch filter values for server-side filtering. Only used for server-side row model.
      */

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

@@ -8,7 +8,7 @@ export { preloadAgCharts } from '../../functions/loadAgCharts';
 export { default as PvDataTable } from '../tables/PvDataTable/PvDataTable.vue';
 export { createPvDataTableFilterStore, providePvDataTableFilterStore, usePvDataTableFilterStore, } from '../tables/PvDataTable/useFilterStore';
 export type { PvDataTableFilterController, PvDataTableFilterModel, PvDataTableFilterStore, } from '../tables/PvDataTable/useFilterStore';
-export type { FocusUpdateEvent, FilterValueResponseOption, FilterRendererProps } from '../tables/PvDataTable/types';
+export type { FocusUpdateEvent, FilterValueResponseOption, FilterRendererProps, PvPivotGroupHeaderConfig, ServerSidePivotHandlerParams, ServerSidePivotHandlerResponse, } from '../tables/PvDataTable/types';
 export type { PvChartWidgetMiniChartMode, PvChartWidgetProps, PvChartWidgetSlotProps, } from '../charts/PvChartWidget/types';
 export type { PvDataWidgetChartType, PvDataWidgetChartTypeOption, PvDataWidgetColumnDefinition, PvDataWidgetDataRow, PvDataWidgetProps, PvDataWidgetViewType, } from '../charts/PvDataWidget/types';
 export { DEFAULT_DATA_WIDGET_ERROR_TEXT, usePvDataWidgetData } from '../charts/PvDataWidget/usePvDataWidgetData';