@inflexa-ai/harness 0.45.1 → 0.46.0

package/dist/report-render/chart-renderers.d.ts

@@ -19,6 +19,7 @@
  * The export option lives here too, in the same two twins: the server draws the SVG through it, and the page
  * draws each PNG through it.
  */
+import type { CustomSeriesRenderItemReturn as EchartsRenderItemReturn } from "echarts";
 /** The renderer name of an interval: an error bar, a confidence interval, or the inner mark of a violin. */
 export declare const INTERVAL_RENDERER = "interval";
 /** The renderer name of a violin outline. */
@@ -40,23 +41,29 @@ export declare const INTERVAL_CAP_PX = 4;
 /** The length of the arrow at a clipped end of an interval, in pixels. */
 export declare const INTERVAL_ARROW_PX = 6;
 /** The first argument of a renderer: the JSON parameters that the series carries in `itemPayload`. */
-export interface RenderParams {
+export type RenderParams = {
     readonly itemPayload?: Readonly<Record<string, unknown>>;
-}
-/** The part of the chart runtime that a renderer reads. */
-export interface RenderApi {
+};
+/** The part of the chart runtime that a renderer reads. `coord` and `size` give one number for each dimension. */
+export type RenderApi = {
     value(dimension: number): number;
-    coord(point: number[]): number[];
-    size(delta: number[]): number[];
+    coord(point: number[]): [number, number];
+    size(delta: number[]): [number, number];
     visual(name: "color"): string;
-}
-/** One graphic element that a renderer gives back to the chart runtime. */
-export interface RenderedElement {
+};
+/**
+ * One graphic element that a renderer gives back to the chart runtime.
+ *
+ * The export hands the element to the chart runtime, which draws it from its own option type; the
+ * intersection keeps the loose fields that the renderers and their shared test vector read, so one
+ * value serves both readers with no cast at the handoff.
+ */
+export type RenderedElement = EchartsRenderItemReturn & {
     type: string;
     shape?: Record<string, unknown>;
     style?: Record<string, unknown>;
     children?: RenderedElement[];
-}
+};
 /**
  * Draw one interval.
  *
@@ -99,20 +106,20 @@ export type ChartRenderer = (params: RenderParams, api: RenderApi) => RenderedEl
  * One registered renderer: the name that a derived series states, the TypeScript function that the export
  * registers, and the name of the page twin in `CHART_RENDERERS_SOURCE` that the bootstrap registers.
  */
-export interface ChartRendererEntry {
+export type ChartRendererEntry = {
     readonly name: string;
     readonly render: ChartRenderer;
     readonly pageFunction: string;
-}
+};
 /**
  * The registered renderers. A renderer joins by one entry here, beside its TypeScript function and its page
  * twin, and each consumer registers it under the same name.
  */
 export declare const CHART_RENDERERS: readonly ChartRendererEntry[];
 /** The part of the chart runtime that holds the registry of the named renderers. */
-export interface RendererRegistry {
+export type RendererRegistry = {
     registerCustomSeries(name: string, render: ChartRenderer): void;
-}
+};
 /**
  * Register each renderer with the chart runtime. A second registration of one name replaces the first with
  * the same function, thus a caller registers before each draw and the runtime holds one function per name.
@@ -129,10 +136,10 @@ export declare function registerChartRenderers(runtime: RendererRegistry): void;
  */
 export declare const SIZED_SERIES_MEMBER = "sizedSeries";
 /** The series of each export width: the names of the page series that they replace, and the series of each width. */
-export interface SizedSeries {
+export type SizedSeries = {
     readonly names: readonly string[];
     readonly widths: Readonly<Record<string, readonly unknown[]>>;
-}
+};
 /** The height of one line of the chart text, as a share of the text size. An upright category label takes one line along its axis. */
 export declare const LABEL_LINE_SHARE = 1.3;
 /**

package/dist/report-render/chart-renderers.js

@@ -19,6 +19,9 @@
  * The export option lives here too, in the same two twins: the server draws the SVG through it, and the page
  * draws each PNG through it.
  */
+import { textOf } from "../lib/unknown-text.js";
+import { isUnknownArray } from "../lib/unknown-array.js";
+import { parseUnknownRecord } from "../lib/unknown-containers.js";
 import { CHART_INK, CHART_PAGE_TEXT_PX, COLOR_SCALE_BAND_PCT, GUIDE_LINE_COLOR } from "./design.js";
 /** The renderer name of an interval: an error bar, a confidence interval, or the inner mark of a violin. */
 export const INTERVAL_RENDERER = "interval";
@@ -77,7 +80,7 @@ export function intervalRenderer(_params, api) {
     const alongX = api.value(4) === 0;
     const offset = api.value(5);
     const inner = api.value(6) === 1;
-    const clipped = Number(api.value(7)) || 0;
+    const clipped = api.value(7) || 0;
     const band = alongX ? api.size([0, 1])[1] : api.size([1, 0])[0];
     const shift = offset * band;
     const from = api.coord(alongX ? [low, y] : [x, low]);
@@ -101,10 +104,11 @@ export function intervalRenderer(_params, api) {
         };
     }
     const children = [segment(fromX, fromY, toX, toY, INTERVAL_STROKE_PX)];
-    for (const [bit, endX, endY, otherX, otherY] of [
+    const ends = [
         [1, fromX, fromY, toX, toY],
         [2, toX, toY, fromX, fromY],
-    ]) {
+    ];
+    for (const [bit, endX, endY, otherX, otherY] of ends) {
         if ((clipped & bit) !== 0) {
             children.push(...arrowHead(endX, endY, otherX, otherY));
             continue;
@@ -176,7 +180,11 @@ export function cellGlyphRenderer(params, api) {
     ];
     if (klass >= 0 && klass < colors.length) {
         const glyph = height * CELL_GLYPH_SHARE;
-        children.push({ type: "rect", shape: { x: center[0] - width / 2, y: center[1] - glyph / 2, width, height: glyph }, style: { fill: colors[klass] } });
+        children.push({
+            type: "rect",
+            shape: { x: center[0] - width / 2, y: center[1] - glyph / 2, width, height: glyph },
+            style: { fill: String(colors[klass]) },
+        });
     }
     return { type: "group", children };
 }
@@ -236,15 +244,20 @@ export const SIZED_SERIES_MEMBER = "sizedSeries";
  * A width that the member does not hold keeps the page series.
  */
 function sizedSeries(series, sized, widthPx) {
-    if (!Array.isArray(series) || typeof sized !== "object" || sized === null)
+    if (!Array.isArray(series))
+        return series;
+    const fields = parseUnknownRecord(sized);
+    if (fields === undefined)
         return series;
-    const fields = sized;
-    const widths = fields.widths;
-    const chosen = typeof widths === "object" && widths !== null ? widths[String(widthPx)] : undefined;
-    if (!Array.isArray(fields.names) || !Array.isArray(chosen))
+    const widths = parseUnknownRecord(fields.widths);
+    const chosen = widths === undefined ? undefined : widths[String(widthPx)];
+    const names = isUnknownArray(fields.names) ? fields.names : undefined;
+    if (names === undefined || !isUnknownArray(chosen))
         return series;
-    const names = fields.names;
-    const kept = series.filter((entry) => typeof entry !== "object" || entry === null || names.indexOf(entry.name) < 0);
+    const kept = series.filter((entry) => {
+        const member = parseUnknownRecord(entry);
+        return member === undefined || names.indexOf(member.name) < 0;
+    });
     return kept.concat(chosen);
 }
 /**
@@ -254,9 +267,10 @@ function sizedSeries(series, sized, widthPx) {
 function scaledAxes(axes, scale) {
     if (Array.isArray(axes))
         return axes.map((axis) => scaledAxes(axis, scale));
-    if (typeof axes !== "object" || axes === null)
+    const axisFields = parseUnknownRecord(axes);
+    if (axisFields === undefined)
         return axes;
-    const axis = { ...axes };
+    const axis = { ...axisFields };
     if (typeof axis.nameGap === "number")
         axis.nameGap = axis.nameGap * scale;
     if (typeof axis.offset === "number")
@@ -268,13 +282,13 @@ function scaledAxes(axes, scale) {
  * group. A facet panel label is such an element, and the size legend is such a group.
  */
 function scaledGraphic(element, scale) {
-    if (typeof element !== "object" || element === null)
+    const out = parseUnknownRecord(element);
+    if (out === undefined)
         return element;
-    const out = { ...element };
-    const style = out.style;
+    const style = parseUnknownRecord(out.style);
     if (style !== undefined && typeof style.fontSize === "number")
         out.style = { ...style, fontSize: style.fontSize * scale };
-    if (Array.isArray(out.children))
+    if (isUnknownArray(out.children))
         out.children = out.children.map((child) => scaledGraphic(child, scale));
     return out;
 }
@@ -303,18 +317,18 @@ export function categoryInterval(count, textPx, widthPx) {
  * export states the interval again at its own width and text size.
  */
 function fittedCategories(axis, textPx, widthPx) {
-    if (typeof axis !== "object" || axis === null || Array.isArray(axis))
+    const fields = parseUnknownRecord(axis);
+    if (fields === undefined)
         return axis;
-    const fields = axis;
     const data = fields.data;
-    if (fields.type !== "category" || !Array.isArray(data) || data.length === 0)
+    if (fields.type !== "category" || !isUnknownArray(data) || data.length === 0)
         return axis;
-    const label = typeof fields.axisLabel === "object" && fields.axisLabel !== null ? fields.axisLabel : {};
+    const label = parseUnknownRecord(fields.axisLabel) ?? {};
     let rotate = label.rotate;
     if (typeof rotate !== "number" || rotate === 0) {
         let longest = 0;
         for (const name of data)
-            longest = Math.max(longest, String(name).length);
+            longest = Math.max(longest, textOf(name).length);
         const need = longest * textPx * CHARACTER_SHARE;
         const room = (widthPx * LABEL_ROOM) / data.length;
         if (need <= room)
@@ -358,11 +372,10 @@ function wrappedTitle(title, textPx, widthPx) {
  * the chart, and a chart of one grid spans the export width.
  */
 function gridWidth(grid, axis, widthPx) {
-    const place = typeof axis === "object" && axis !== null && typeof axis.gridIndex === "number"
-        ? axis.gridIndex
-        : 0;
-    const entry = Array.isArray(grid) ? grid[place] : grid;
-    const width = typeof entry === "object" && entry !== null ? entry.width : undefined;
+    const axisFields = parseUnknownRecord(axis);
+    const place = axisFields !== undefined && typeof axisFields.gridIndex === "number" ? axisFields.gridIndex : 0;
+    const entry = isUnknownArray(grid) ? grid[place] : grid;
+    const width = parseUnknownRecord(entry)?.width;
     if (typeof width === "string" && width.endsWith("%"))
         return (widthPx * Number.parseFloat(width)) / 100;
     if (typeof width === "number")
@@ -384,9 +397,9 @@ function fittedAxes(axes, grid, textPx, widthPx) {
  * prints no end, or that draws pieces and no scale passes through.
  */
 function stillScale(map, textPx, widthPx) {
-    if (typeof map !== "object" || map === null)
+    const fields = parseUnknownRecord(map);
+    if (fields === undefined)
         return map;
-    const fields = map;
     const text = fields.text;
     if (fields.show === false || fields.type === "piecewise" || !Array.isArray(text) || typeof text[0] !== "string" || typeof text[1] !== "string")
         return map;
@@ -397,7 +410,7 @@ function stillScale(map, textPx, widthPx) {
         ...fields,
         top: STILL_SCALE_TOP,
         itemHeight: STILL_SCALE_LINES * textPx,
-        text: [title === "" ? upper : `${wrappedTitle(title, textPx, widthPx)}\n${upper}`, text[1]],
+        text: [title === "" ? upper : `${wrappedTitle(title, textPx, widthPx)}\n${String(upper)}`, text[1]],
     };
 }
 /** The top of a still color scale, which is the top margin of the grid, and its length in lines of the text. */
@@ -433,18 +446,21 @@ function legendBand(lines, textPx) {
  * are the data of the legend, or else the name of each series in order of first appearance.
  */
 function legendLines(option, textPx, widthPx) {
-    const legend = option.legend;
+    const legend = parseUnknownRecord(option.legend);
+    if (legend === undefined)
+        return 0;
     const names = [];
-    if (Array.isArray(legend.data)) {
+    if (isUnknownArray(legend.data)) {
         for (const entry of legend.data) {
-            const name = typeof entry === "object" && entry !== null ? entry.name : entry;
+            const fields = parseUnknownRecord(entry);
+            const name = fields === undefined ? entry : fields.name;
             if (typeof name === "string")
                 names.push(name);
         }
     }
     else if (Array.isArray(option.series)) {
         for (const series of option.series) {
-            const name = typeof series === "object" && series !== null ? series.name : undefined;
+            const name = parseUnknownRecord(series)?.name;
             if (typeof name === "string" && name !== "" && names.indexOf(name) < 0)
                 names.push(name);
         }
@@ -475,7 +491,7 @@ function legendLines(option, textPx, widthPx) {
  * height draws in one line that scrolls.
  */
 function facetOverLegend(option, textPx, widthPx, heightPx) {
-    const grids = option.grid;
+    const grids = Array.isArray(option.grid) ? option.grid : [];
     const title = Math.round(textPx * FACET_TITLE_SHARE);
     const tops = [];
     let lowest = 0;
@@ -484,21 +500,23 @@ function facetOverLegend(option, textPx, widthPx, heightPx) {
         const bottom = panelBottom(grid);
         if (bottom <= 0)
             continue;
-        const fields = grid;
-        const top = Number.parseFloat(String(fields.top));
+        const fields = parseUnknownRecord(grid);
+        if (fields === undefined)
+            continue;
+        const top = Number.parseFloat(textOf(fields.top));
         if (tops.indexOf(top) < 0)
             tops.push(top);
         if (bottom <= lowest)
             continue;
         lowest = bottom;
-        height = Number.parseFloat(String(fields.height));
+        height = Number.parseFloat(textOf(fields.height));
     }
     tops.sort((a, b) => a - b);
     const partOf = (legendPx) => Math.max(0, lowest - ((heightPx - legendPx - title) / heightPx) * 100) / tops.length;
     const lines = legendLines(option, textPx, widthPx);
     let band = legendBand(lines, textPx);
     if (lines > 1 && partOf(band) > height * (1 - PANEL_MIN_SHARE)) {
-        option.legend = { ...option.legend, type: "scroll" };
+        option.legend = { ...parseUnknownRecord(option.legend), type: "scroll" };
         band = legendBand(1, textPx);
     }
     const part = partOf(band);
@@ -509,16 +527,18 @@ function facetOverLegend(option, textPx, widthPx, heightPx) {
         option.grid = grids.map((grid) => {
             if (panelBottom(grid) <= 0)
                 return grid;
-            const fields = grid;
-            const top = Number.parseFloat(String(fields.top));
-            return { ...fields, top: moved(top, tops.indexOf(top)), height: `${Math.round((Number.parseFloat(String(fields.height)) - part) * 1e4) / 1e4}%` };
+            const fields = parseUnknownRecord(grid);
+            if (fields === undefined)
+                return grid;
+            const top = Number.parseFloat(textOf(fields.top));
+            return { ...fields, top: moved(top, tops.indexOf(top)), height: `${Math.round((Number.parseFloat(textOf(fields.height)) - part) * 1e4) / 1e4}%` };
         });
     }
     if (Array.isArray(option.graphic)) {
         option.graphic = option.graphic.map((element) => {
-            if (typeof element !== "object" || element === null)
+            const fields = parseUnknownRecord(element);
+            if (fields === undefined)
                 return element;
-            const fields = element;
             if (fields.bottom !== undefined)
                 return { ...fields, bottom: band };
             const top = typeof fields.top === "string" && fields.top.endsWith("%") ? Number.parseFloat(fields.top) : Number.NaN;
@@ -529,23 +549,23 @@ function facetOverLegend(option, textPx, widthPx, heightPx) {
 }
 /** The bottom edge of one facet panel, in percent of the chart, or 0 for a grid that is no facet panel. */
 function panelBottom(grid) {
-    if (typeof grid !== "object" || grid === null)
+    const fields = parseUnknownRecord(grid);
+    if (fields === undefined)
         return 0;
-    const fields = grid;
     if (fields.outerBoundsMode !== PANEL_BOUNDS_MODE || typeof fields.top !== "string" || typeof fields.height !== "string")
         return 0;
     return Number.parseFloat(fields.top) + Number.parseFloat(fields.height);
 }
 /** True when an option lays out facet panels over a bottom legend. */
 function holdsFacetLegend(option) {
-    const legend = option.legend;
-    const bottom = typeof legend === "object" && legend !== null && legend.show !== false && legend.bottom !== undefined;
+    const legend = parseUnknownRecord(option.legend);
+    const bottom = legend !== undefined && legend.show !== false && legend.bottom !== undefined;
     return bottom && Array.isArray(option.grid) && option.grid.some((grid) => panelBottom(grid) > 0);
 }
 /** True when an option draws a legend along the bottom edge of a grid of one panel. */
 function holdsBottomLegend(option) {
-    const legend = option.legend;
-    const bottom = typeof legend === "object" && legend !== null && legend.show !== false && legend.bottom !== undefined;
+    const legend = parseUnknownRecord(option.legend);
+    const bottom = legend !== undefined && legend.show !== false && legend.bottom !== undefined;
     return bottom && option.xAxis !== undefined && !Array.isArray(option.grid);
 }
 /**
@@ -583,12 +603,13 @@ export function exportOption(option, textPx, widthPx, heightPx) {
         out.visualMap = out.visualMap.map((map) => stillScale(map, textPx, widthPx));
     else if (out.visualMap !== undefined)
         out.visualMap = stillScale(out.visualMap, textPx, widthPx);
-    if (typeof out.grid === "object" && out.grid !== null && !Array.isArray(out.grid) && out.grid.containLabel === true) {
+    const gridFields = parseUnknownRecord(out.grid);
+    if (gridFields !== undefined && gridFields.containLabel === true) {
         // The legacy containment holds the labels alone, and a name at the edge of a short export is cut.
-        out.grid = { ...out.grid, containLabel: false, outerBoundsMode: "auto", outerBoundsContain: "all" };
+        out.grid = { ...gridFields, containLabel: false, outerBoundsMode: "auto", outerBoundsContain: "all" };
     }
     if (holdsBottomLegend(out)) {
-        const grid = typeof out.grid === "object" && out.grid !== null ? out.grid : {};
+        const grid = parseUnknownRecord(out.grid) ?? {};
         out.grid = { ...grid, outerBoundsMode: "auto", outerBounds: { left: 0, right: 0, top: 0, bottom: Math.round(textPx * LEGEND_BAND_LINES) } };
     }
     if (holdsFacetLegend(out))

package/dist/report-render/chart-toolbox.d.ts

@@ -76,10 +76,10 @@ export declare function pageChartOption(option: EchartOption, chartType: ChartTy
 export declare const GENOME_POSITION_FUNCTION = "reportGenomePosition";
 export declare const GENOME_MEMBER = "genome";
 /** The genome member of an axis: the series that names the chromosomes, and the start and the label of each chromosome in position order. */
-export interface GenomeAxis {
+export type GenomeAxis = {
     readonly names: string;
     readonly starts: ReadonlyArray<readonly [number, string]>;
-}
+};
 /**
  * The page functions of the toolbox, as browser source text.
  *

package/dist/report-render/chart-toolbox.js

@@ -94,6 +94,12 @@ export function chartMenuControlId(containerId) {
  */
 export function chartToolbox(chartType) {
     const dense = chartType !== undefined && DENSE_CARTESIAN_CHARTS.includes(chartType);
+    const zoomFeatures = dense
+        ? {
+            dataZoom: { show: true, title: { zoom: "Zoom", back: "Undo zoom" }, filterMode: "none" },
+            restore: { show: true, title: "Restore" },
+        }
+        : undefined;
     return {
         show: true,
         zlevel: TOOLBOX_ZLEVEL,
@@ -112,12 +118,7 @@ export function chartToolbox(chartType) {
             },
         },
         feature: {
-            ...(dense
-                ? {
-                    dataZoom: { show: true, title: { zoom: "Zoom", back: "Undo zoom" }, filterMode: "none" },
-                    restore: { show: true, title: "Restore" },
-                }
-                : {}),
+            ...zoomFeatures,
             dataView: {
                 show: true,
                 title: "Data",

package/dist/report-render/chart.d.ts

@@ -28,10 +28,9 @@
 import { type Result } from "neverthrow";
 import { type ChartBlock, type ChartTransform } from "../contracts/report-blocks.js";
 import { type PresetRule } from "./chart-presets.js";
-import { transformColumn } from "./figures/common.js";
 import { type FigureRegistry } from "./figures/index.js";
 import type { RenderProblem, RenderStatistic, RenderTrack, RenderTrees } from "./types.js";
-export { transformColumn };
+export { transformColumn } from "./figures/common.js";
 /** One cell of a resolved row. A cell is one string or one number. */
 export type Cell = string | number;
 /** One resolved row of the bound table, keyed by column name. */
@@ -54,15 +53,15 @@ export declare function deriveChartOption(block: ChartBlock, rows: readonly Char
  * the rows of the track, and the rows of the tree of each axis. A block that declares none of them takes no
  * input.
  */
-export interface ChartInputs {
+export type ChartInputs = {
     readonly statistics?: readonly RenderStatistic[];
     readonly track?: RenderTrack;
     readonly trees?: RenderTrees;
-}
+};
 /** The options of the chart derivation: the figure modules that the dispatch asks first. */
-export interface ChartOpts {
+export type ChartOpts = {
     readonly figures: FigureRegistry;
-}
+};
 /** The options of every render: the registered figure modules. */
 export declare const DEFAULT_CHART_OPTS: ChartOpts;
 /**
@@ -94,11 +93,11 @@ export declare const POINT_LABEL: EchartOption;
  * One column that a page-side series build reads: the place of the column in the payload, the per-row
  * transform of the channel, and whether the page reads each cell as its number.
  */
-export interface ChartColumnSource {
+export type ChartColumnSource = {
     readonly column: number;
     readonly transform?: ChartTransform;
     readonly numeric?: true;
-}
+};
 /**
  * One runtime series, as the page builds it from the columnar payload.
  *
@@ -115,7 +114,7 @@ export interface ChartColumnSource {
  * `color` and `size` name the columns of a continuous color and of a symbol size. Each one adds one member
  * to the item after the pair, in that order, and a row whose cell is not numeric draws no point.
  */
-export interface ChartSeriesSource {
+export type ChartSeriesSource = {
     readonly x: ChartColumnSource;
     readonly y: ChartColumnSource;
     readonly color?: ChartColumnSource;
@@ -128,16 +127,16 @@ export interface ChartSeriesSource {
     readonly sort?: boolean;
     readonly rise?: boolean;
     readonly swap?: boolean;
-}
+};
 /**
  * The data source of one chart: the payload that it reads, the classification rule where a preset splits
  * the rows, and one descriptor for each runtime series in series order.
  */
-export interface ChartDataSource {
+export type ChartDataSource = {
     readonly payload: string;
     readonly rule?: PresetRule;
     readonly series: readonly ChartSeriesSource[];
-}
+};
 /**
  * The member of the option that carries the data source.
  *
@@ -146,10 +145,10 @@ export interface ChartDataSource {
  */
 export declare const CHART_SOURCE_MEMBER = "__reportData";
 /** The payload that a dense chart reads: the key of the registry, and the columns of the payload. */
-export interface ChartPayloadTarget {
+export type ChartPayloadTarget = {
     readonly key: string;
     readonly columns: readonly string[];
-}
+};
 /**
  * The option of one chart, whether it reads the registered payload of its artifact, the same chart with
  * every row inline, and the box of its page chart body.
@@ -159,10 +158,10 @@ export interface ChartPayloadTarget {
  * own. `widthPx` is the width of a figure that draws a block of a fixed size, for example the square of a PCA.
  * The card narrows the body to that width and centers it, and a chart with no such width fills the card.
  */
-export interface ChartRender {
+export type ChartRender = {
     readonly option: EchartOption;
     readonly readsPayload: boolean;
     readonly inline: EchartOption;
     readonly bodyPx: number;
     readonly widthPx?: number;
-}
+};