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

package/pv-components/dist/vue/visualizations/components/base/PvContext/{PvContextFeedback.vue.d.ts → PvContextFeedback/PvContextFeedback.vue.d.ts}

@@ -1,23 +1,23 @@
-import { ContextCardItem } from './types.ts';
-import { ContextFeedbackPayload } from './config.ts';
+import { ContextEntityField, ContextFeedbackPayload } from '../config.ts';
 import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 interface PvContextFeedbackProps {
-    item: ContextCardItem;
+    /** The field labels to offer for feedback selection. */
+    fields?: ContextEntityField[];
     /**
      * Handles the submitted feedback. Resolve `true` when the feedback was
-     * accepted (a persistent success message replaces the form and blocks further
-     * submissions) or `false` when it failed (a persistent error message appears
-     * and the form stays open so the user can retry). The submit button shows a
-     * spinner while the returned promise is pending.
+     * accepted (the form resets and a success toast appears) or `false` when it
+     * failed (an error toast appears and the form stays open so the user can
+     * retry). The submit button shows a spinner while the returned promise is
+     * pending.
      */
     onSubmitFeedback?: (payload: ContextFeedbackPayload) => Promise<boolean>;
-    /** Message shown in place of the form after feedback is accepted. */
+    /** Toast message shown after feedback is accepted. */
     successMessage?: string;
-    /** Message shown when feedback submission fails. */
+    /** Toast message shown when feedback submission fails. */
     errorMessage?: string;
 }
 declare const _default: DefineComponent<PvContextFeedbackProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<PvContextFeedbackProps> & Readonly<{}>, {
     successMessage: string;
     errorMessage: string;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

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

@@ -0,0 +1,45 @@
+import { ShowContextPayload } from '../config.ts';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+interface PvContextSurfaceProps {
+    /** Controls the outer surface: `pv-card` or `pv-drawer pv-surface`. */
+    variant: "card" | "drawer";
+    /** Tag shown in the header row. Omit to hide the tag. Payer/Provider (case-insensitive) also swap in PvCompanyLogo next to the default title. */
+    contextType?: string;
+    /** Used by the default title when the `title` slot isn't provided. */
+    header: string;
+    /** Hides the close button. */
+    disableClose?: boolean;
+    /** Shows a back arrow in the header row, for callers that support drilling back up a navigation stack. */
+    showBack?: boolean;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        title?(_: {}): any;
+        default?(_: {}): any;
+        footer?(_: {}): any;
+    };
+    refs: {
+        panel: HTMLDivElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<PvContextSurfaceProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    close: () => any;
+    back: () => any;
+    "show-context": (payload: ShowContextPayload) => any;
+}, string, PublicProps, Readonly<PvContextSurfaceProps> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onBack?: (() => any) | undefined;
+    "onShow-context"?: ((payload: ShowContextPayload) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    panel: HTMLDivElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,12 @@
+import { ShowContextPayload, ContextEntityField } from '../config.ts';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+interface PvSpinesEntityFieldsProps {
+    /** The label/value rows to render. */
+    entityFields: ContextEntityField[];
+}
+declare const _default: DefineComponent<PvSpinesEntityFieldsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    "show-context": (payload: ShowContextPayload) => any;
+}, string, PublicProps, Readonly<PvSpinesEntityFieldsProps> & Readonly<{
+    "onShow-context"?: ((payload: ShowContextPayload) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -1,3 +1,4 @@
+import { InjectionKey } from 'vue';
 import { ContextCardEnum, ContextCardFieldConfig, ContextCardItem } from './types';
 export declare const CONTEXT_TAG_LABELS: Record<ContextCardEnum, string>;
 /**
@@ -20,7 +21,33 @@ export interface ContextLabelClickPayload {
         value: string[];
     };
 }
+/** A single value within a `ContextEntityField`. Set `isClickable` to render it as interactive. */
+export interface ContextEntityFieldValue {
+    name: string;
+    isClickable?: boolean;
+    /** Opaque identifier for this value (e.g. a knowledge-graph id). Not read internally; consumers resolve it themselves in their `show-context` handler. */
+    contextIdentifier?: string;
+}
+/** A pre-built label/value entry for PvSpinesEntityFields and PvContextFeedback. */
+export interface ContextEntityField {
+    label: string;
+    value: ContextEntityFieldValue | ContextEntityFieldValue[];
+}
 export interface ContextFeedbackPayload {
     fields: string[];
     comment: string;
 }
+/** Emitted as PvContextSurface's `show-context` event when a clickable value is activated. */
+export interface ShowContextPayload {
+    contextIdentifier: string;
+}
+/**
+ * Lets content slotted into PvContextSurface (e.g. PvSpinesEntityFields) request a context
+ * change without the consumer manually relaying an intermediate event. PvContextSurface
+ * provides this; slotted content injects it and calls `showContext` directly, and
+ * PvContextSurface re-emits it as its own `show-context` event.
+ */
+export interface PvContextSurfaceContext {
+    showContext: (payload: ShowContextPayload) => void;
+}
+export declare const PvContextSurfaceKey: InjectionKey<PvContextSurfaceContext>;

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

@@ -0,0 +1,17 @@
+export interface PvEmptyStateProps {
+    /** Alt text for the image */
+    alt?: string;
+    description?: string;
+    /** Primary text displayed in the empty/error state */
+    header?: string;
+    /** Label for the primary action button. Button is only rendered when set */
+    primaryLabel?: string;
+    /** Label for the secondary action button. Button is only rendered when set */
+    secondaryLabel?: string;
+    /** Source URL for the image displayed above the header */
+    src?: string;
+}
+export interface PvEmptyStateEmits {
+    (e: "handle-primary-click"): void;
+    (e: "handle-secondary-click"): void;
+}

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

@@ -1,4 +1,6 @@
 export interface PvSidebarV2Props {
+    /** @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[];

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

@@ -13,18 +13,6 @@ export type PvSortableMenuListProps = {
      * Whether to render placeholder drop zones for unfilled active slots.
      */
     showPlaceholders?: boolean;
-    /**
-     * Options that cannot be removed or reordered: they render with a lock icon, stay pinned
-     * at the top of the active list, and every mutation (click, drag, placeholder drop)
-     * 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 = {
@@ -38,7 +26,6 @@ declare const _default: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Compo
     options: MenuOption[];
     placeholderText: string;
     showPlaceholders: boolean;
-    lockedOptionIds: string[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     sortableListRef: HTMLUListElement;

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

@@ -27,6 +27,9 @@ export { default as PvDateTime } from './PvDateTime/PvDateTime.vue';
 export { default as PvDrawer } from './PvDrawer/PvDrawer.vue';
 export { default as PvSpinesContextCard } from './PvContext/PvSpinesContextCard/PvSpinesContextCard.vue';
 export { default as PvSpinesContextDrawer } from './PvContext/PvSpinesContextDrawer/PvSpinesContextDrawer.vue';
+export { default as PvContextSurface } from './PvContext/PvContextSurface/PvContextSurface.vue';
+export { default as PvSpinesEntityFields } from './PvContext/PvSpinesEntityFields/PvSpinesEntityFields.vue';
+export { default as PvContextFeedback } from './PvContext/PvContextFeedback/PvContextFeedback.vue';
 export { default as PvTooltip } from './PvTooltip/PvTooltip.vue';
 export { default as PvTooltipV2 } from './PvTooltipV2/PvTooltipV2.vue';
 export { default as PvTabs } from './PvTabs/PvTabs.vue';
@@ -94,6 +97,8 @@ export { createPvFilterStore, providePvFilterStore, useOptionalPvFilterStore, us
 export type { PvRangeColor, PvRangeMode, PvRangeProps, PvRangeSize, PvRangeValue, } from './PvRange/types';
 export { ContextCardEnum } from './PvContext/types';
 export type { ContextCardItem, ContextCardVariants, ProviderContextCard, PayerContextCard, LineOfBusinessContextCard, PlanTypeContextCard, ProductContextCard, CSBAContextCard, StateContextCard, ServiceContextCard, ServiceCodeContextCard, } from './PvContext/types';
-export type { ContextFeedbackPayload, ContextLabelClickPayload } from './PvContext/config';
+export type { ContextLabelClickPayload } from './PvContext/config';
+export type { ShowContextPayload, ContextEntityField, ContextEntityFieldValue, ContextFeedbackPayload, PvContextSurfaceContext, } from './PvContext/config';
+export { PvContextSurfaceKey } from './PvContext/config';
 export { RumContextKey, useRumContext, addRumAction, deferRumTask } from '../../functions/rum';
 export type { PvRumContext } from '../../functions/rum';

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

@@ -16,25 +16,6 @@ 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

@@ -7,15 +7,6 @@ export interface PvChartOptionsPanelProps {
     useCombinedButton?: boolean;
     useNestedMenu?: boolean;
     chartConfigOptions?: ChartConfigPanelType[];
-    /** 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;
     /** When true, the panel's controls are visible but disabled (view-only). */
     readOnly?: boolean;
     /** Column field used for the "% of focus" chart view; its Y-axis option is disabled on line charts. */

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

@@ -180,48 +180,6 @@ export interface PvDataTableWithChartProps<T> extends PvDataTableProps<T> {
      * when `multiSelectMetricOverlay` is true; unknown fields are ignored.
      */
     initialSecondaryYKeys?: string[];
-    /**
-     * Keep Metric Overlays available when a secondary row group splits a non-stacked chart into
-     * one series per group value (they are normally disabled and cleared there). The overlay
-     * plots the field's plain per-category value, so it is only meaningful when that value is
-     * constant within a category — e.g. drug-level benchmarks (WAC/ASP) on a report already
-     * filtered to a single drug.
-     */
-    metricOverlayWithRowGroups?: boolean;
-    /**
-     * 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. */