h2o-library 2.2.0 → 2.2.2

package/dist/hooks/charts/src/heatmap/chart-heatmap.d.ts

@@ -1,9 +1,16 @@
 import React from "react";
 import "../../charts.css";
+/**
+ * A cell value. A `number` is colored by intensity as usual. A `string` is a
+ * final, non-numeric result straight from the backend (e.g. "N/A" for a
+ * percentage whose denominator is 0) — it is shown verbatim in a neutral,
+ * grayed-out cell and excluded from the color scale.
+ */
+export type HeatmapCell = number | string;
 export interface HeatmapData {
     rows: string[];
     columns: string[];
-    matrix: number[][];
+    matrix: HeatmapCell[][];
 }
 export interface HeatmapChartProps {
     data: HeatmapData;
@@ -13,6 +20,6 @@ export interface HeatmapChartProps {
     className?: string;
     onRowClick?: (row: string, event: React.MouseEvent<HTMLDivElement>) => void;
     onColumnClick?: (column: string, event: React.MouseEvent<HTMLDivElement>) => void;
-    onCellClick?: (row: string, column: string, value: number, event: React.MouseEvent<HTMLDivElement>) => void;
+    onCellClick?: (row: string, column: string, value: HeatmapCell, event: React.MouseEvent<HTMLDivElement>) => void;
 }
 export declare const HeatmapChart: ({ data, showValue, showPercentage, height, className, onRowClick, onColumnClick, onCellClick, }: HeatmapChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/hooks/charts/src/waterfall/chart-waterfall.d.ts

@@ -12,7 +12,27 @@ export interface WaterfallFeature {
     value?: number | string;
     contribution: number;
 }
-export type ShapRecord = Record<string, number | string>;
+/** One feature entry inside a {@link ShapExplanation}. */
+export interface ShapFeature {
+    name: string;
+    prob: number;
+    value?: number | string;
+}
+/**
+ * The structured SHAP explanation object. Passed straight to
+ * {@link WaterfallChartProps.data} with no transform.
+ */
+export interface ShapExplanation {
+    recordId?: number;
+    losRecordId?: number;
+    probabilityDischargeNext2Days?: number;
+    fx: number;
+    efx: number;
+    otherFactorsProb?: number;
+    otherFactorsValue?: number;
+    text?: string;
+    features: ShapFeature[];
+}
 export interface WaterfallColors {
     positive?: string;
     negative?: string;
@@ -25,16 +45,12 @@ export interface WaterfallBarDatum {
     contribution: number;
 }
 export interface WaterfallChartProps {
-    data: WaterfallFeature[] | ShapRecord;
-    baseValue?: number;
-    prediction?: number;
+    data: ShapExplanation;
     maxFeatures?: number;
     colors?: WaterfallColors;
     compact?: boolean;
     height?: number;
     className?: string;
-    probSuffix?: string;
-    valueSuffix?: string;
     onBarClick?: (datum: WaterfallBarDatum, index: number, event: React.MouseEvent<SVGElement>) => void;
 }
-export declare const WaterfallChart: ({ data, baseValue, prediction, maxFeatures, colors, compact, height, className, probSuffix, valueSuffix, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const WaterfallChart: ({ data, maxFeatures, colors, compact, height, className, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/charts/src/bar/chart-bar.d.ts

@@ -10,6 +10,8 @@ export interface BarSeriesConfig {
     color: string;
     unit?: string;
     stackId?: string;
+    labelKey?: string;
+    labelColor?: string;
 }
 export interface BarChartProps {
     data: BarChartDataPoint[];

package/dist/types/charts/src/chart/chart.d.ts

@@ -29,7 +29,7 @@ type BarChartSpecificProps = {
     layout?: "single" | "grouped" | "stacked" | "grouped-stacked";
     orientation?: "vertical" | "horizontal";
 };
-type WaterfallSpecificProps = Pick<WaterfallChartProps, "baseValue" | "prediction" | "maxFeatures" | "colors" | "compact" | "probSuffix" | "valueSuffix" | "onBarClick">;
+type WaterfallSpecificProps = Pick<WaterfallChartProps, "maxFeatures" | "colors" | "compact" | "onBarClick">;
 type ChartTypeSpecificProps<T extends ChartType> = T extends "bar" ? BarChartSpecificProps : T extends "waterfall" ? WaterfallSpecificProps : Record<string, never>;
 export type ChartProps<T extends ChartType> = BaseChartProps & {
     data: BaseChartData[T];

package/dist/types/charts/src/heatmap/chart-heatmap.d.ts

@@ -1,9 +1,16 @@
 import React from "react";
 import "../../charts.css";
+/**
+ * A cell value. A `number` is colored by intensity as usual. A `string` is a
+ * final, non-numeric result straight from the backend (e.g. "N/A" for a
+ * percentage whose denominator is 0) — it is shown verbatim in a neutral,
+ * grayed-out cell and excluded from the color scale.
+ */
+export type HeatmapCell = number | string;
 export interface HeatmapData {
     rows: string[];
     columns: string[];
-    matrix: number[][];
+    matrix: HeatmapCell[][];
 }
 export interface HeatmapChartProps {
     data: HeatmapData;
@@ -13,6 +20,6 @@ export interface HeatmapChartProps {
     className?: string;
     onRowClick?: (row: string, event: React.MouseEvent<HTMLDivElement>) => void;
     onColumnClick?: (column: string, event: React.MouseEvent<HTMLDivElement>) => void;
-    onCellClick?: (row: string, column: string, value: number, event: React.MouseEvent<HTMLDivElement>) => void;
+    onCellClick?: (row: string, column: string, value: HeatmapCell, event: React.MouseEvent<HTMLDivElement>) => void;
 }
 export declare const HeatmapChart: ({ data, showValue, showPercentage, height, className, onRowClick, onColumnClick, onCellClick, }: HeatmapChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/charts/src/waterfall/chart-waterfall.d.ts

@@ -12,7 +12,27 @@ export interface WaterfallFeature {
     value?: number | string;
     contribution: number;
 }
-export type ShapRecord = Record<string, number | string>;
+/** One feature entry inside a {@link ShapExplanation}. */
+export interface ShapFeature {
+    name: string;
+    prob: number;
+    value?: number | string;
+}
+/**
+ * The structured SHAP explanation object. Passed straight to
+ * {@link WaterfallChartProps.data} with no transform.
+ */
+export interface ShapExplanation {
+    recordId?: number;
+    losRecordId?: number;
+    probabilityDischargeNext2Days?: number;
+    fx: number;
+    efx: number;
+    otherFactorsProb?: number;
+    otherFactorsValue?: number;
+    text?: string;
+    features: ShapFeature[];
+}
 export interface WaterfallColors {
     positive?: string;
     negative?: string;
@@ -25,16 +45,12 @@ export interface WaterfallBarDatum {
     contribution: number;
 }
 export interface WaterfallChartProps {
-    data: WaterfallFeature[] | ShapRecord;
-    baseValue?: number;
-    prediction?: number;
+    data: ShapExplanation;
     maxFeatures?: number;
     colors?: WaterfallColors;
     compact?: boolean;
     height?: number;
     className?: string;
-    probSuffix?: string;
-    valueSuffix?: string;
     onBarClick?: (datum: WaterfallBarDatum, index: number, event: React.MouseEvent<SVGElement>) => void;
 }
-export declare const WaterfallChart: ({ data, baseValue, prediction, maxFeatures, colors, compact, height, className, probSuffix, valueSuffix, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const WaterfallChart: ({ data, maxFeatures, colors, compact, height, className, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/utils/charts/src/bar/chart-bar.d.ts

@@ -10,6 +10,8 @@ export interface BarSeriesConfig {
     color: string;
     unit?: string;
     stackId?: string;
+    labelKey?: string;
+    labelColor?: string;
 }
 export interface BarChartProps {
     data: BarChartDataPoint[];

package/dist/utils/charts/src/chart/chart.d.ts

@@ -29,7 +29,7 @@ type BarChartSpecificProps = {
     layout?: "single" | "grouped" | "stacked" | "grouped-stacked";
     orientation?: "vertical" | "horizontal";
 };
-type WaterfallSpecificProps = Pick<WaterfallChartProps, "baseValue" | "prediction" | "maxFeatures" | "colors" | "compact" | "probSuffix" | "valueSuffix" | "onBarClick">;
+type WaterfallSpecificProps = Pick<WaterfallChartProps, "maxFeatures" | "colors" | "compact" | "onBarClick">;
 type ChartTypeSpecificProps<T extends ChartType> = T extends "bar" ? BarChartSpecificProps : T extends "waterfall" ? WaterfallSpecificProps : Record<string, never>;
 export type ChartProps<T extends ChartType> = BaseChartProps & {
     data: BaseChartData[T];

package/dist/utils/charts/src/heatmap/chart-heatmap.d.ts

@@ -1,9 +1,16 @@
 import React from "react";
 import "../../charts.css";
+/**
+ * A cell value. A `number` is colored by intensity as usual. A `string` is a
+ * final, non-numeric result straight from the backend (e.g. "N/A" for a
+ * percentage whose denominator is 0) — it is shown verbatim in a neutral,
+ * grayed-out cell and excluded from the color scale.
+ */
+export type HeatmapCell = number | string;
 export interface HeatmapData {
     rows: string[];
     columns: string[];
-    matrix: number[][];
+    matrix: HeatmapCell[][];
 }
 export interface HeatmapChartProps {
     data: HeatmapData;
@@ -13,6 +20,6 @@ export interface HeatmapChartProps {
     className?: string;
     onRowClick?: (row: string, event: React.MouseEvent<HTMLDivElement>) => void;
     onColumnClick?: (column: string, event: React.MouseEvent<HTMLDivElement>) => void;
-    onCellClick?: (row: string, column: string, value: number, event: React.MouseEvent<HTMLDivElement>) => void;
+    onCellClick?: (row: string, column: string, value: HeatmapCell, event: React.MouseEvent<HTMLDivElement>) => void;
 }
 export declare const HeatmapChart: ({ data, showValue, showPercentage, height, className, onRowClick, onColumnClick, onCellClick, }: HeatmapChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/utils/charts/src/waterfall/chart-waterfall.d.ts

@@ -12,7 +12,27 @@ export interface WaterfallFeature {
     value?: number | string;
     contribution: number;
 }
-export type ShapRecord = Record<string, number | string>;
+/** One feature entry inside a {@link ShapExplanation}. */
+export interface ShapFeature {
+    name: string;
+    prob: number;
+    value?: number | string;
+}
+/**
+ * The structured SHAP explanation object. Passed straight to
+ * {@link WaterfallChartProps.data} with no transform.
+ */
+export interface ShapExplanation {
+    recordId?: number;
+    losRecordId?: number;
+    probabilityDischargeNext2Days?: number;
+    fx: number;
+    efx: number;
+    otherFactorsProb?: number;
+    otherFactorsValue?: number;
+    text?: string;
+    features: ShapFeature[];
+}
 export interface WaterfallColors {
     positive?: string;
     negative?: string;
@@ -25,16 +45,12 @@ export interface WaterfallBarDatum {
     contribution: number;
 }
 export interface WaterfallChartProps {
-    data: WaterfallFeature[] | ShapRecord;
-    baseValue?: number;
-    prediction?: number;
+    data: ShapExplanation;
     maxFeatures?: number;
     colors?: WaterfallColors;
     compact?: boolean;
     height?: number;
     className?: string;
-    probSuffix?: string;
-    valueSuffix?: string;
     onBarClick?: (datum: WaterfallBarDatum, index: number, event: React.MouseEvent<SVGElement>) => void;
 }
-export declare const WaterfallChart: ({ data, baseValue, prediction, maxFeatures, colors, compact, height, className, probSuffix, valueSuffix, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const WaterfallChart: ({ data, maxFeatures, colors, compact, height, className, onBarClick, }: WaterfallChartProps) => import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h2o-library",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "A set of components for H2O Apps development",
   "main": "dist/index.cjs.js",
   "module": "dist/esm/index.js",