@turquoisehealth/pit-viper 2.240.3-dev.0 → 2.241.1-dev.0

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

@@ -73,7 +73,9 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
     } & PvSelectButtonProps<T>) & Partial<{}>> & PublicProps;
     expose(exposed: ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: {};
+    slots: {
+        footer?(_: {}): any;
+    };
     emit: {
         (e: "dropdown-open"): void;
         (e: "dropdown-closed"): void;

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

@@ -19,6 +19,12 @@ export type PvSortableMenuListProps = {
      * re-asserts them. Ids must refer to options that are already active.
      */
     lockedOptionIds?: string[];
+    /**
+     * Optional per-option explanation for WHY an option is locked, keyed by option id. A locked
+     * option with an entry renders an info icon whose tooltip shows the text (e.g. "Select a
+     * single drug to unlock"). Ignored for options that aren't locked.
+     */
+    lockedOptionTooltips?: Record<string, string>;
 };
 type __VLS_Props = PvSortableMenuListProps;
 type __VLS_PublicProps = {

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

@@ -16,6 +16,25 @@ export declare const getSecondarySeriesKey: (field: string, aggFunc: string | nu
  * back to AG Charts' automatic scaling rather than building a degenerate axis.
  */
 export declare const niceAxisCeiling: (rawMax: number, intervals: number) => number;
+/**
+ * A "nice" fitted axis window: floor and ceiling on multiples of a nice step
+ * (1 / 2 / 2.5 / 5 x 10^k) spanning exactly `intervals` equal steps, with
+ * floor <= rawMin and ceiling >= rawMax.
+ *
+ * Used for a line chart's primary value axis when it is grid-aligned against a
+ * secondary axis: lines don't encode value by length from a baseline, so the
+ * axis can hug the data (e.g. percentages clustered around 100%) instead of
+ * stretching to zero — and because the window keeps the shared interval count,
+ * both axes' gridlines still coincide. Data near zero floors to zero naturally.
+ *
+ * Returns null for non-finite, negative-min, or degenerate (max <= min) input,
+ * signalling the caller to fall back to the zero-based window.
+ */
+export declare const niceAxisRange: (rawMin: number, rawMax: number, intervals: number) => {
+    min: number;
+    max: number;
+    step: number;
+} | null;
 export declare const computeNoDataOverlayText: ({ currentRowGroupColumnsLength, shouldShowFocusOverlayText, chartDataEmpty, missingFocusText, displayGroupByName, yAxisName, yAxisOptionCount, }: {
     currentRowGroupColumnsLength: number;
     shouldShowFocusOverlayText: boolean;

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

@@ -10,6 +10,9 @@ export interface PvChartOptionsPanelProps {
     /** Row-group colIds that are pinned in the sortable X Axis list: locked options can't be
      *  removed or reordered (see PvSortableList's lockedOptionIds). */
     lockedRowGroupColIds?: string[];
+    /** Per-colId explanation for why an X Axis option is locked, shown as an info tooltip on the
+     *  locked list entry (see PvSortableList's lockedOptionTooltips). */
+    lockedRowGroupTooltips?: Record<string, string>;
     /** Keep the Metric Overlay picker enabled when a secondary row group splits a non-stacked
      *  chart into per-group series (see PvDataTableWithChart's metricOverlayWithRowGroups). */
     metricOverlayWithRowGroups?: boolean;

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

@@ -192,8 +192,36 @@ export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
      * Row-group colIds pinned in the sortable X Axis picker: locked options render with a lock
      * icon and cannot be removed or reordered (see PvSortableList's `lockedOptionIds`). Use for
      * charts whose first dimension is structural (e.g. a time axis on a trends template).
+     * Locked ids are also enforced as active: any locked id missing from the current row groups
+     * is prepended (in locked order), so a caller can drive a structural breakout reactively
+     * (e.g. force a per-drug split while multiple drugs are selected).
      */
     lockedRowGroupColIds?: string[];
+    /**
+     * Per-colId explanation for why an X Axis option is locked, keyed by colId. Shown as an
+     * info tooltip on the locked entry in the X Axis picker.
+     */
+    lockedRowGroupTooltips?: Record<string, string>;
+    /**
+     * Explicit display order for the X Axis picker's options, as colIds. Options listed here
+     * sort by their position; unlisted options keep their existing relative order after them.
+     * Lets the picker order diverge from the table's column order (which otherwise drives it).
+     */
+    rowGroupOptionOrder?: string[];
+    /**
+     * When true and the chart is a line chart grid-aligned against a secondary axis, the primary
+     * value axis uses a "nice" fitted window (floor near the data minimum) instead of a zero
+     * baseline, so series clustered far from zero stay readable. Opt-in per consumer: bar charts
+     * and consumers that don't set it keep the zero-based window.
+     */
+    fitPrimaryAxisToLineData?: boolean;
+    /**
+     * When true, metric overlays are withheld from the chart (no overlay series, no secondary
+     * axis) while the picker selections are preserved, so overlays reappear when the flag drops.
+     * Use when the overlay would be misleading for the current view (e.g. a blended WAC/ASP
+     * benchmark line across a multi-drug comparison).
+     */
+    suppressMetricOverlays?: boolean;
     /** Filter configuration that adds a dropdown above the chart to slice data by a category column. */
     chartFilter?: ChartFilter;
     /** The initial chart type to render. */