@turquoisehealth/pit-viper 2.211.2 → 2.211.4-dev.0

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

@@ -25,6 +25,12 @@ export interface PvSelectButtonProps<T = unknown> {
     prefixLabel?: string;
     /** Text label on the trigger button; updates to the selected option's text when an item is chosen */
     label?: string;
+    /**
+     * Keep the trigger showing `label` even after an option is selected, instead of
+     * swapping to the selected option's text. Use when the label is a fixed title
+     * (e.g. a column name) and the current selection is surfaced only inside the dropdown.
+     */
+    staticLabel?: boolean;
     /** Hide the search input inside the dropdown */
     disableSearchInput?: boolean;
     /** Placeholder text for the search input */

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

@@ -7,5 +7,9 @@ export declare const histogramChartTypeConfig: MenuOption;
 export declare const mapChartTypeConfig: MenuOption;
 export declare const MAP_REGION_FIELD = "state";
 export declare const separatorValue = "--SEPARATOR--";
+export declare const distributionRangeMinCategory = "--DISTRIBUTION-RANGE-MIN--";
+export declare const distributionRangeMaxCategory = "--DISTRIBUTION-RANGE-MAX--";
+export declare const padStartValue = "--PAD-START--";
+export declare const padEndValue = "--PAD-END--";
 export declare const sortTotalSuffix = "_sort_total";
 export declare const SECONDARY_AXIS_INTERVAL_COUNT = 5;

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

@@ -1,4 +1,4 @@
-import { AgChartOptions } from 'ag-charts-enterprise';
+import { AgAxisLabelFormatterParams, AgChartOptions, Formatter } from 'ag-charts-enterprise';
 import { ColDef } from 'ag-grid-community';
 import { OptionWithFormatterAndDataType } from './types';
 export declare const isAvailableSecondarySeriesColDef: (colDef: ColDef) => boolean;
@@ -41,5 +41,39 @@ export declare const buildStackedChartData: (data: AgChartOptions["data"], categ
     uniqueFieldValues: string[];
     data?: undefined;
 };
+/**
+ * A lone bar in a category ("bar"-type) chart would otherwise stretch full-width.
+ * Flank the single row with two sentinel blank categories so it renders at a
+ * natural width instead.
+ *
+ * The sentinels are dedicated values that can never equal a real category. This
+ * matters when the single real category is itself blank (a "(Blanks)" group,
+ * whose key is ""): a naive "" pad would collide with the real category, and the
+ * pad's transparent, valueless bar would overwrite the real one - rendering it
+ * invisible. Both sentinels are hidden by the category-axis label formatter and
+ * filtered out of map/scatter data.
+ */
+export declare const padSingleCategoryBarData: (data: AgChartOptions["data"], categoryField: string) => AgChartOptions["data"];
 export declare const calculateMaxChartSeriesValue: (data: any[] | undefined, seriesField: string, isStacked: boolean) => number;
 export declare const calculateMinChartSeriesValue: (data: any[] | undefined, seriesField: string, isStacked: boolean) => number;
+/**
+ * Builds the category axis's label formatter. Exactly one of three behaviors applies:
+ * - `hideLabel`: every label is blank (e.g. a chart type that doesn't show x-axis labels).
+ * - `showDistributionRangeLabels`: only the two blank pad categories flanking a histogram's
+ *   real buckets (under `useDistributionV2Styling`) are labeled, with the overall lowest
+ *   min / highest max bucket boundary; every other category (including the real buckets
+ *   themselves) is blank.
+ * - Otherwise: normal category labels, formatted via `columnValueFormatter`, with the
+ *   separator/single-bar-padding sentinel categories hidden, a focus suffix appended, and
+ *   the result truncated to `MAX_LABEL_LENGTH`.
+ */
+export declare const buildCategoryAxisLabelFormatter: ({ hideLabel, showDistributionRangeLabels, chartData, formatBucketBoundary, columnValueFormatter, enableFocusView, focuses, focusText, }: {
+    hideLabel: boolean;
+    showDistributionRangeLabels: boolean;
+    chartData: AgChartOptions["data"];
+    formatBucketBoundary: (value: number) => string;
+    columnValueFormatter: Formatter<AgAxisLabelFormatterParams> | undefined;
+    enableFocusView: boolean;
+    focuses: string[];
+    focusText: string;
+}) => ((params: AgAxisLabelFormatterParams) => string);

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

@@ -77,6 +77,12 @@ export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
     showSeriesLabels?: boolean;
     /** When true, truncates long category labels on the chart axis. */
     truncateLabelValues?: boolean;
+    /**
+     * Gate for distribution/histogram chart styling changes that must ship together.
+     * When true, notates the x-axis of histogram charts with the overall lowest min
+     * (left) and highest max (right) bucket bounds.
+     */
+    useDistributionV2Styling?: boolean;
     /** Pre-populated chart data to render before any server-side fetch completes. */
     initialChartData?: AgChartOptions["data"];
     /** When true, wraps large charts in a native Pit Viper-styled scroll container. */

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

@@ -1,6 +1,8 @@
+import { AgChartOptions, AgSeriesVisibilityChange, AgChartInstance } from 'ag-charts-types';
 import { MapTopologyType } from '../chart-components/maps/useTopology';
 import { AgMapLineSeriesTooltipRendererParams } from 'ag-charts-enterprise';
-import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, CreateComponentPublicInstanceWithMixins, GlobalComponents, GlobalDirectives, ExtractPropTypes, PropType } from 'vue';
+import { PvChartProps } from '../PvChart/types';
 export interface PvMapChartData {
     [key: string]: string | number;
 }
@@ -32,7 +34,12 @@ export interface PvMapChartProps {
 declare const _default: DefineComponent<{
     chartData: PvMapChartData[];
     selectedRegion?: string | undefined;
-} & PvMapChartProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+} & PvMapChartProps, {
+    getChartImageDataURL: (dimensions?: {
+        width?: number;
+        height?: number;
+    }) => Promise<string> | undefined;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:chartData": (value: PvMapChartData[]) => any;
     "update:selectedRegion": (value: string | undefined) => any;
 } & {
@@ -52,5 +59,69 @@ declare const _default: DefineComponent<{
     gradientLegendMin: number;
     gradientLegendMax: number;
     seriesValueFormatter: (value: number) => string;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    pvChartRef: CreateComponentPublicInstanceWithMixins<Readonly< PvChartProps> & Readonly<{
+        "onSeries-visibility-change"?: ((event: AgSeriesVisibilityChange<unknown>) => any) | undefined;
+    }>, {
+        getChartImageDataURL: (dimensions?: {
+            width?: number;
+            height?: number;
+        }) => Promise<string> | undefined;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+        "series-visibility-change": (event: AgSeriesVisibilityChange<unknown>) => any;
+    }, PublicProps, {
+        seriesFormatType: "none" | "currency" | "percent";
+        isLoading: boolean;
+        enableFocusView: boolean;
+        minHeight: number;
+        translateNullValues: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+        chartRef: CreateComponentPublicInstanceWithMixins<Readonly< ExtractPropTypes<{
+            options: {
+                type: PropType<AgChartOptions>;
+                default: () => AgChartOptions;
+            };
+        }>> & Readonly<{}>, {
+            chart: AgChartInstance | undefined;
+        }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {
+            options: AgChartOptions;
+        }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+            P: {};
+            B: {};
+            D: {};
+            C: {};
+            M: {};
+            Defaults: {};
+        }, Readonly< ExtractPropTypes<{
+            options: {
+                type: PropType<AgChartOptions>;
+                default: () => AgChartOptions;
+            };
+        }>> & Readonly<{}>, {
+            chart: AgChartInstance | undefined;
+        }, {}, {}, {}, {
+            options: AgChartOptions;
+        }> | null;
+    }, HTMLDivElement, ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< PvChartProps> & Readonly<{
+        "onSeries-visibility-change"?: ((event: AgSeriesVisibilityChange<unknown>) => any) | undefined;
+    }>, {
+        getChartImageDataURL: (dimensions?: {
+            width?: number;
+            height?: number;
+        }) => Promise<string> | undefined;
+    }, {}, {}, {}, {
+        seriesFormatType: "none" | "currency" | "percent";
+        isLoading: boolean;
+        enableFocusView: boolean;
+        minHeight: number;
+        translateNullValues: boolean;
+    }> | null;
+}, any>;
 export default _default;