@turquoisehealth/pit-viper 2.244.4 → 2.245.0

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

@@ -0,0 +1,10 @@
+import { PvEmptyStateProps } from './types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const _default: DefineComponent<PvEmptyStateProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    "handle-primary-click": () => any;
+    "handle-secondary-click": () => any;
+}, string, PublicProps, Readonly<PvEmptyStateProps> & Readonly<{
+    "onHandle-primary-click"?: (() => any) | undefined;
+    "onHandle-secondary-click"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -78,6 +78,7 @@ export { default as PvSidebarV2 } from './PvSidebarV2/PvSidebarV2.vue';
 export { default as PvMenuItem } from './PvMenu/items/PvMenuItem.vue';
 export { default as PvTableOfContents } from './PvTableOfContents/PvTableOfContents.vue';
 export { default as PvStepper } from './PvStepper/PvStepper.vue';
+export { default as PvEmptyState } from './PvEmptyState/PvEmptyState.vue';
 export { useDateTime } from './PvDateTime/useDateTime';
 export { usePvComponents } from './PvComponentsConfig/usePvComponents';
 export type { Tab } from './PvTabs/types';

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

@@ -20,7 +20,8 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         readonly "onChart-state-changed"?: ((event: ChartStateChangedEvent) => any) | undefined;
         readonly "onChart-collapsed"?: ((collapsed: boolean) => any) | undefined;
         readonly "onActive-overlay-group-ids-change"?: ((ids: string[]) => 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" | "onTable-overlay-change" | "onChart-state-changed" | "onChart-collapsed" | "onActive-overlay-group-ids-change"> & PvDataTableWithChartProps<T> & Partial<{}>> & PublicProps;
+        readonly "onStack-values-page-changed"?: ((pageIndex: number) => 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" | "onTable-overlay-change" | "onChart-state-changed" | "onChart-collapsed" | "onActive-overlay-group-ids-change" | "onStack-values-page-changed"> & PvDataTableWithChartProps<T> & Partial<{}>> & PublicProps;
     expose(exposed: ShallowUnwrapRef<{
         getChartImageDataURL: (dimensions?: {
             width?: number;
@@ -60,6 +61,7 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         (e: "chart-collapsed", collapsed: boolean): void;
         (e: "table-overlay-change", selectedIds: string[]): void;
         (e: "active-overlay-group-ids-change", ids: string[]): void;
+        (e: "stack-values-page-changed", pageIndex: number): void;
     };
 }>) => VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

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

@@ -65,13 +65,45 @@ export declare const isChronologicalColDef: (colDef: ColDef | null | undefined)
 export declare const sortChartDataChronologically: (data: AgChartOptions["data"], categoryField: string) => AgChartOptions["data"];
 export declare const generateStackSeriesKey: (seriesField: string, stackField: string) => string;
 export declare const generateStackSecondaryCategoryKey: (stackField: string) => string;
-export declare const buildStackedChartData: (data: AgChartOptions["data"], categoryField: string, stackField: string, seriesColumns: OptionWithFormatterAndDataType[], supplementaryChartingColumns?: OptionWithFormatterAndDataType[]) => {
+export interface StackValuesPage {
+    data: AgChartOptions["data"];
+    /** Total distinct stack values across all pages. */
+    total: number;
+    pageCount: number;
+    /** The page actually returned — clamped into range if the requested one was out of bounds. */
+    pageIndex: number;
+    /** This page's stack values, ordered by total contribution to the primary series,
+     * descending (highest cost first) — the render order, not just the selection. */
+    orderedLabels: string[];
+}
+/**
+ * Same idea as paginateStackValuesByTotal, but for the client-side grouping path: rows are
+ * already pivoted one-per-category (each stack value lives in its own `field_stackValue`
+ * sub-key via generateStackSeriesKey — see getStackedChartDataFromRowNodes), rather than one
+ * row per raw record. Ranks stack values by total contribution to the primary series across
+ * all category rows, keeps only the requested page, and recomputes each series' `_sort_total`
+ * to reflect only the kept values (so axis scaling and label-suppression thresholds match what
+ * actually renders — otherwise they'd stay based on every value, page or no page).
+ *
+ * Ranking (and the `_sort_total` recompute) only happens when paging is actually enabled (a
+ * positive `pageSize`) — see paginateStackValuesByTotal for why that matters. With `pageSize`
+ * falsy (paging off, the default), `fieldValues` and each row's existing sort totals pass
+ * through unchanged.
+ */
+export declare const paginatePivotedStackValuesByTotal: (rows: AgChartOptions["data"], fieldValues: string[], seriesColumns: OptionWithFormatterAndDataType[], primaryField: string | undefined, pageSize: number | undefined, pageIndex: number) => StackValuesPage;
+export declare const buildStackedChartData: (data: AgChartOptions["data"], categoryField: string, stackField: string, seriesColumns: OptionWithFormatterAndDataType[], supplementaryChartingColumns?: OptionWithFormatterAndDataType[], primarySeriesField?: string, stackValuesPageSize?: number, stackValuesPageIndex?: number) => {
     data: never[];
     uniqueFieldValues: never[];
+    totalStackValueCount: number;
+    stackValuesPageCount: number;
+    stackValuesPageIndex: number;
     stackedData?: undefined;
 } | {
     stackedData: any[];
     uniqueFieldValues: string[];
+    totalStackValueCount: number;
+    stackValuesPageCount: number;
+    stackValuesPageIndex: number;
     data?: undefined;
 };
 /**

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

@@ -146,6 +146,27 @@ export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
     allFieldsAreFocusable?: boolean;
     /** List of chart types available in the chart-type selector. */
     enabledChartTypes?: supportedChartType[];
+    /**
+     * How many distinct stack/series values (e.g. the second row-group column's values)
+     * render on the chart per page, ranked by their total contribution to the primary series
+     * across all categories (highest first) and shown a page at a time — nothing is ever
+     * permanently dropped, the rest are just a page navigation away (see
+     * `initialStackValuesPageIndex` / the exposed page-navigation controls).
+     *
+     * Opt-in: omit or set to 0 to disable (the default) and keep the stack field's original,
+     * unranked order exactly as before this prop existed. Set a positive number (20 lines up
+     * with a typical legend page size) for high-cardinality dimensions — hundreds of cities,
+     * providers, etc. — that would otherwise each become their own series and the chart would
+     * become an unreadable crunch of overlapping bars. Applies to both server-side
+     * (`serverSideChartHandler`) and client-side (`rowData`) data.
+     */
+    stackValuesPageSize?: number;
+    /**
+     * Which page of stack values to show initially, 0-indexed, when `stackValuesPageSize` is
+     * paging a high-cardinality stack field. Out-of-range values are clamped. Defaults to 0.
+     * Subsequent page navigation is internal; listen for `stack-values-page-changed` to observe it.
+     */
+    initialStackValuesPageIndex?: number;
     /** Handler to fetch chart data on the server side. Only used for server-side row model. */
     serverSideChartHandler?: (params: ServerSideChartDataHandlerParams) => Promise<ServerSideChartDataHandlerResponse>;
     /** When true, displays value labels on chart series bars/points. */

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

@@ -1,4 +1,5 @@
-import { AgChartTheme } from 'ag-charts-enterprise';
+import { AgChartTheme, CssColor } from 'ag-charts-enterprise';
+export declare const multicolorFills: CssColor[];
 export declare const SCATTER_MARKER_STROKE = "#7C8AF4";
 export declare const PitViperAGChartsMonochromeThemeName = "pv-ag-chart-monochrome";
 export declare const PitViperAGChartsMonochromeTheme: AgChartTheme;