@overvis/hmi-workspace-ui 0.0.0-stage → 0.1.0

package/dist/src/workspace/reports/histogram/plot.d.ts

@@ -0,0 +1,42 @@
+import uPlot from "uplot";
+import type { HistogramSetup, ReportColor } from "@overvis/hmi-shared/report";
+import type { HistogramCadence } from "./slots.js";
+export interface HistogramPlotSeries {
+    parameterId: string;
+    label: string;
+    units: string;
+    defaultColor: ReportColor;
+    ys: (number | null)[];
+    stroke: string;
+    fill: string | undefined;
+    scaleMultiplier: number;
+    scaleShift: number;
+    decimalPlaces: number;
+}
+export declare function histogramOfAvgSlotLabel(cadence: HistogramCadence, slot: number, locale?: "de" | "en" | "pl" | "ru" | "uk"): string;
+/** Integer slot incrs so uPlot does not place ticks at 2.5, 7.5, … */
+export declare function histogramSlotTickIncrs(cadence: HistogramCadence): number[];
+export declare function histogramSlotTickSpace(cadence: HistogramCadence): number;
+/** Bars need half a slot of room on both ends; fills run edge to edge. */
+export declare function histogramXRange(xs: readonly number[], displayAs: HistogramSetup["displayAs"]): [number, number];
+/** Bars and fills are anchored at zero; only the far end gets headroom. */
+export declare function zeroAnchoredYRange(alignedYs: readonly ArrayLike<number | null | undefined>[]): [number, number];
+/** uPlot series for histogram slots; shared by the widget and the render PNG. */
+export declare function histogramBarSeriesOpts(seriesNow: readonly {
+    label: string;
+    stroke: string;
+    fill: string | undefined;
+}[], displayAs: HistogramSetup["displayAs"], xValues: () => number[], steps: () => number[]): {
+    seriesOpts: uPlot.Series[];
+    bands: uPlot.Band[];
+};
+export declare const HistogramPlot: import("react").MemoExoticComponent<({ xs, series, displayAs, cadence, height, showTooltip, className, dataReportPlot, }: {
+    xs: number[];
+    series: HistogramPlotSeries[];
+    displayAs: HistogramSetup["displayAs"];
+    cadence: HistogramCadence;
+    height: number;
+    showTooltip: boolean;
+    className?: string;
+    dataReportPlot?: string;
+}) => import("react").JSX.Element>;

package/dist/src/workspace/reports/histogram/representation.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import type { HistogramSetup } from "@overvis/hmi-shared/report";
+export interface HistogramRepresentationProps {
+    representationKey: string;
+    setup: HistogramSetup;
+    className?: string;
+}
+export declare function HistogramRepresentation({ representationKey, setup, className, }: HistogramRepresentationProps): ReactNode;

package/dist/src/workspace/reports/histogram/slots.d.ts

@@ -0,0 +1,19 @@
+import type { ReadingsCadence } from "@overvis/hmi-shared/parameter";
+import { type HistogramSetup } from "@overvis/hmi-shared/report";
+export type HistogramCadence = HistogramSetup["cadence"];
+export declare function histogramUnderlyingCadence(cadence: HistogramCadence): ReadingsCadence;
+export declare function histogramSlotCount(cadence: HistogramCadence): number;
+/** Monday = 0 … Sunday = 6 from a civil Y-M-D. */
+export declare function isoWeekdayMon0(year: number, month: number, day: number): number;
+/** Slot index for a closed-bucket start, or `null` if the wall time cannot be resolved. */
+export declare function histogramSlotIndex(bucketStartMs: number, cadence: HistogramCadence, timeZone: string): number | null;
+export declare function histogramNumericValue(value: number | string): number | null;
+/**
+ * Mean of closed-instance `perCadenceValue`s per invariant slot.
+ * Empty slots are `null` (gap, not 0). DST fall-back duplicates both count.
+ */
+export declare function reduceHistogramOfAvgSlots(rows: readonly {
+    bucketStart: number;
+    value: number | string;
+}[], cadence: HistogramCadence, timeZone: string): (number | null)[];
+export declare function histogramClosedTo(from: number, to: number, cadence: HistogramCadence, timeZone: string): number;

package/dist/src/workspace/reports/hourly-matrix/demand.d.ts

@@ -0,0 +1,28 @@
+import type { ReadingsNumericAggregation } from "@overvis/hmi-shared/parameter";
+import type { HourlyMatrixSetup } from "@overvis/hmi-shared/report";
+import type { CadenceNeed } from "../table/fetch.js";
+import type { ReportTableCadenceEntry } from "../table/demand.js";
+export type HourlyMatrixCadence = HourlyMatrixSetup["cadence"];
+export interface ReportHourlyMatrixDemandSlot {
+    parameterId: string;
+    sourceValueType: string;
+    aggregation: ReadingsNumericAggregation;
+}
+export interface ReportHourlyMatrixDemand {
+    cadence: HourlyMatrixCadence;
+    slots: ReportHourlyMatrixDemandSlot[];
+}
+export type ReportHourlyMatrixCadenceEntry = ReportTableCadenceEntry;
+export type ReportHourlyMatrixCadenceCache = Map<string, ReportHourlyMatrixCadenceEntry>;
+export declare function hourlyMatrixClosedTo(from: number, to: number, cadence: HourlyMatrixCadence, timeZone: string, nowMs?: number): number;
+export declare function hourlyMatrixCadenceCacheKey(parts: {
+    parameterId: string;
+    sourceValueType: string;
+    aggregation: string;
+    cadence: HourlyMatrixCadence;
+    timeZone: string;
+    from: number;
+    to: number;
+}): string;
+export declare function serializeReportHourlyMatrixDemand(demand: ReportHourlyMatrixDemand): string;
+export declare function collectHourlyMatrixCadenceNeeds(demands: ReadonlyMap<string, ReportHourlyMatrixDemand>, from: number, to: number, timeZone: string, nowMs?: number): CadenceNeed[];

package/dist/src/workspace/reports/hourly-matrix/layout.d.ts

@@ -0,0 +1,36 @@
+import type { ReadingsNumericAggregation } from "@overvis/hmi-shared/parameter";
+import type { CalendarDay } from "../calendar/layout.js";
+import type { HourlyMatrixCadence } from "./demand.js";
+export type HourlyMatrixTotalAggregation = "none" | "last" | "delta" | "sum" | "average" | "min" | "max";
+export interface HourlyMatrixCivilSlot {
+    index: number;
+    hour: number;
+    minute: number;
+    label: string;
+}
+export interface HourlyMatrixCadencePoint {
+    bucketStart: number;
+    value: number | string;
+    repr?: string | null;
+}
+export type HourlyMatrixSlotKind = "missing" | "out" | "open" | "in";
+export declare function hourlyMatrixStepMinutes(cadence: HourlyMatrixCadence): 15 | 30 | 60;
+export declare function hourlyMatrixCivilSlots(cadence: HourlyMatrixCadence): HourlyMatrixCivilSlot[];
+export declare function hourlyMatrixCivilSlotKey(day: Pick<CalendarDay, "year" | "month" | "day">, hour: number, minute: number): string;
+export declare function hourlyMatrixSlotStartMs(day: Pick<CalendarDay, "year" | "month" | "day">, slot: Pick<HourlyMatrixCivilSlot, "hour" | "minute">, timeZone: string): number | null;
+/** Elapsed slot interval for a civil label. Fall-back duplicates walk back to the first occurrence. */
+export declare function hourlyMatrixSlotRange(day: Pick<CalendarDay, "year" | "month" | "day">, slot: Pick<HourlyMatrixCivilSlot, "hour" | "minute">, cadence: HourlyMatrixCadence, timeZone: string): {
+    startMs: number;
+    endMs: number;
+} | null;
+export declare function hourlyMatrixSlotKind(parts: {
+    startMs: number | null;
+    endMs: number | null;
+    from: number;
+    to: number;
+    closedTo: number;
+}): HourlyMatrixSlotKind;
+export declare function indexHourlyMatrixSlotRows(rows: readonly HourlyMatrixCadencePoint[], timeZone: string, aggregation: ReadingsNumericAggregation): Map<string, HourlyMatrixCadencePoint>;
+export declare function reduceHourlyMatrixBuckets(rows: readonly HourlyMatrixCadencePoint[], aggregation: ReadingsNumericAggregation): HourlyMatrixCadencePoint | null;
+export declare function reduceHourlyMatrixDayHeaders(rows: readonly HourlyMatrixCadencePoint[], dayStartMs: number, dayEndMs: number, from: number, closedTo: number, aggregation: ReadingsNumericAggregation): HourlyMatrixCadencePoint | null;
+export declare function reduceHourlyMatrixTotals(values: readonly (number | string)[], aggregation: HourlyMatrixTotalAggregation): number | string | null;

package/dist/src/workspace/reports/hourly-matrix/model.d.ts

@@ -0,0 +1,66 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { HourlyMatrixSetup, ReportColor, ReportParameterSetup } from "@overvis/hmi-shared/report";
+import { type CalendarDay } from "../calendar/layout.js";
+import { type ReportHourlyMatrixCadenceCache, type ReportHourlyMatrixDemandSlot } from "./demand.js";
+export interface HourlyMatrixCellColors {
+    text: ReportColor | null;
+    bg: ReportColor | null;
+    border: ReportColor | null;
+}
+export interface HourlyMatrixTextCell {
+    text: string | null;
+    title: string | undefined;
+}
+export interface HourlyMatrixHeaderCell extends HourlyMatrixTextCell {
+    /** Numeric header: zone wash at `zoneBgOpacity`; integer header: value color as text. */
+    color: ReportColor | null;
+    paint: "bg" | "text" | "none";
+    bgOpacity: number;
+}
+export interface HourlyMatrixSlotCell extends HourlyMatrixTextCell {
+    key: string;
+    colors: HourlyMatrixCellColors;
+    bold: boolean;
+    italic: boolean;
+}
+export interface HourlyMatrixRowModel {
+    label: string;
+    title: string | undefined;
+    headerCells: HourlyMatrixHeaderCell[];
+    slotCells: HourlyMatrixSlotCell[];
+    /** `null` when the table has no total column; empty text when this row shows none. */
+    totalCell: HourlyMatrixTextCell | null;
+}
+export interface HourlyMatrixDayModel {
+    ymd: string;
+    day: CalendarDay;
+    /** Shared session range for the whole local day (click navigation). */
+    range: {
+        from: number;
+        to: number;
+    };
+    title: string | undefined;
+    rows: HourlyMatrixRowModel[];
+}
+export interface HourlyMatrixModel {
+    /** Titles of the day-header columns (max across groups, padded). */
+    headerTitles: string[];
+    slotLabels: string[];
+    /** Title of the day-total column, or `null` when no group shows a total. */
+    totalTitle: string | null;
+    days: HourlyMatrixDayModel[];
+    /** First `readings_*` error among demanded keys, already localized. */
+    error: string | null;
+}
+export interface HourlyMatrixModelOptions {
+    setup: HourlyMatrixSetup;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+    locale: AppLocale;
+    cache: ReportHourlyMatrixCadenceCache;
+}
+export declare function hourlyMatrixDemandSlots(setup: HourlyMatrixSetup, parametersById: ReadonlyMap<string, ReportParameterSetup>, visibleParameterIds: ReadonlySet<string>): ReportHourlyMatrixDemandSlot[];
+export declare function buildHourlyMatrixModel(options: HourlyMatrixModelOptions): HourlyMatrixModel;

package/dist/src/workspace/reports/hourly-matrix/representation.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from "react";
+import type { HourlyMatrixSetup } from "@overvis/hmi-shared/report";
+export interface HourlyMatrixRepresentationProps {
+    setup: HourlyMatrixSetup;
+    className?: string;
+}
+export declare function HourlyMatrixRepresentation({ setup, className, }: HourlyMatrixRepresentationProps): ReactNode;

package/dist/src/workspace/reports/html/build.d.ts

@@ -0,0 +1,57 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import { type ReportComment, type ReportParameterSetup, type ReportPreset } from "@overvis/hmi-shared/report";
+import { type EncodedFile } from "@overvis/hmi-shared/setup";
+import type { ReportRealtimeOverlay } from "../chart/realtime.js";
+import type { ReportSparseCache, ReportHighPrecisionCache } from "../chart/demand.js";
+import { type ReportMountedWidget } from "./mounted.js";
+import { type ReportHistogramCadenceCache } from "../histogram/demand.js";
+import { type ReportTimeBucketsCadenceCache, type ReportTimeBucketsDaysCache } from "../time-buckets/demand.js";
+import { type ReportSankeyCache } from "../sankey/demand.js";
+import type { ReportTableAggregateCache, ReportTableCadenceCache, ReportTableRawCache } from "../table/demand.js";
+import type { ReportCalendarCadenceCache } from "../calendar/demand.js";
+import type { ReportHourlyMatrixCadenceCache } from "../hourly-matrix/demand.js";
+import type { ReportStateDurationCache } from "../state-duration/demand.js";
+export interface ReportHtmlBuildCaches {
+    sparseCache: ReportSparseCache;
+    highPrecisionCache: ReportHighPrecisionCache;
+    sparseExtent: {
+        from: number;
+        to: number;
+    } | null;
+    tableCadenceCache: ReportTableCadenceCache;
+    tableRawCache: ReportTableRawCache;
+    tableAggregateCache: ReportTableAggregateCache;
+    timeBucketsCadenceCache: ReportTimeBucketsCadenceCache;
+    timeBucketsDaysCache: ReportTimeBucketsDaysCache;
+    histogramCadenceCache: ReportHistogramCadenceCache;
+    calendarDaysCache: ReportCalendarCadenceCache;
+    calendarHourCache: ReportCalendarCadenceCache;
+    hourlyMatrixCadenceCache: ReportHourlyMatrixCadenceCache;
+    stateDurationCache: ReportStateDurationCache;
+    sankeyCache: ReportSankeyCache;
+}
+export declare function reportBarHtmlBlankKind(options: {
+    visibleNumeric: boolean;
+    hasPaint: boolean;
+}): "empty" | "no-data" | null;
+export declare function includeHistogramHtmlSeries(options: {
+    status: string;
+    loadingMore: boolean;
+}): boolean;
+export interface ReportHtmlBuildInput {
+    preset: ReportPreset;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+    locale: AppLocale;
+    overlay: ReportRealtimeOverlay;
+    plotWidths: Readonly<Record<string, number>>;
+    caches: ReportHtmlBuildCaches;
+    comments: readonly ReportComment[];
+    authorsById: ReadonlyMap<string, string>;
+    nowMs: number;
+    mountedWidgets: readonly ReportMountedWidget[];
+}
+export declare function buildReportHtmlFiles(input: ReportHtmlBuildInput, signal: AbortSignal): Promise<Record<string, EncodedFile>>;

package/dist/src/workspace/reports/html/cache-clone.d.ts

@@ -0,0 +1,36 @@
+import type { ReportHighPrecisionCache, ReportSparseCache } from "../chart/demand.js";
+import type { ReportCalendarCadenceCache } from "../calendar/demand.js";
+import type { ReportHistogramCadenceCache } from "../histogram/demand.js";
+import type { ReportTimeBucketsCadenceCache, ReportTimeBucketsDaysCache } from "../time-buckets/demand.js";
+import type { ReportHourlyMatrixCadenceCache } from "../hourly-matrix/demand.js";
+import type { ReportSankeyCache } from "../sankey/demand.js";
+import type { ReportStateDurationCache } from "../state-duration/demand.js";
+import type { ReportTableAggregateCache, ReportTableCadenceCache, ReportTableRawCache } from "../table/demand.js";
+export interface ReportHtmlFrozenCaches {
+    sparseCache: ReportSparseCache;
+    highPrecisionCache: ReportHighPrecisionCache;
+    sparseExtent: {
+        from: number;
+        to: number;
+    } | null;
+    tableCadenceCache: ReportTableCadenceCache;
+    tableRawCache: ReportTableRawCache;
+    tableAggregateCache: ReportTableAggregateCache;
+    timeBucketsCadenceCache: ReportTimeBucketsCadenceCache;
+    timeBucketsDaysCache: ReportTimeBucketsDaysCache;
+    histogramCadenceCache: ReportHistogramCadenceCache;
+    calendarDaysCache: ReportCalendarCadenceCache;
+    calendarHourCache: ReportCalendarCadenceCache;
+    hourlyMatrixCadenceCache: ReportHourlyMatrixCadenceCache;
+    stateDurationCache: ReportStateDurationCache;
+    sankeyCache: ReportSankeyCache;
+}
+export declare function cloneReportHtmlCaches(src: ReportHtmlFrozenCaches): ReportHtmlFrozenCaches;
+/** True when live HP can satisfy the click window (superset, exact, or same-from prefix). */
+export declare function hpCoversFrozenWindow(hp: {
+    windowFrom: number | null;
+    windowTo: number | null;
+}, from: number, to: number): boolean;
+/** Copy live HP into the freeze only when the window still covers the click snapshot. */
+export declare function mergeLiveChartHp(frozen: ReportHighPrecisionCache, live: ReportHighPrecisionCache, from: number, to: number): void;
+export declare function mergeLiveKeyedCaches(frozen: ReportHtmlFrozenCaches, live: ReportHtmlFrozenCaches): void;

package/dist/src/workspace/reports/html/calendar.d.ts

@@ -0,0 +1,15 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { CalendarSetup, ReportParameterSetup } from "@overvis/hmi-shared/report";
+import { type ReportCalendarCadenceCache } from "../calendar/demand.js";
+export declare function reportCalendarHtml(options: {
+    setup: CalendarSetup;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+    locale: AppLocale;
+    nowMs: number;
+    calendarDaysCache: ReportCalendarCadenceCache;
+    calendarHourCache: ReportCalendarCadenceCache;
+}): string;

package/dist/src/workspace/reports/html/comments.d.ts

@@ -0,0 +1,13 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import { type ReportComment, type ReportParameterSetup, type ReportPreset } from "@overvis/hmi-shared/report";
+export declare function reportFooterCommentsHtml(options: {
+    preset: ReportPreset;
+    comments: readonly ReportComment[];
+    authorsById: ReadonlyMap<string, string>;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    from: number;
+    to: number;
+    timeZone: string;
+    locale: AppLocale;
+    visibleParameterIds: ReadonlySet<string>;
+}): string;

package/dist/src/workspace/reports/html/css.d.ts

@@ -0,0 +1,2 @@
+/** Light print stylesheet: report color tokens plus layout / table / print rules. No `.dark`. */
+export declare function reportHtmlCss(): string;

package/dist/src/workspace/reports/html/document.d.ts

@@ -0,0 +1,5 @@
+export declare function wrapReportHtmlDocument(options: {
+    lang: string;
+    title: string;
+    body: string;
+}): string;

package/dist/src/workspace/reports/html/escape.d.ts

@@ -0,0 +1,6 @@
+/** Escape text for HTML body / attribute context. */
+export declare function escapeHtml(value: string): string;
+/** Attribute-safe `style="…"` wrapper. Empty decls → no attribute. */
+export declare function htmlStyleAttr(decls: string): string;
+/** Attribute-safe `title="…"` wrapper. Missing/empty → no attribute. */
+export declare function htmlTitleAttr(text: string | undefined): string;

package/dist/src/workspace/reports/html/matrix.d.ts

@@ -0,0 +1,13 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { HourlyMatrixSetup, ReportParameterSetup } from "@overvis/hmi-shared/report";
+import type { ReportHourlyMatrixCadenceCache } from "../hourly-matrix/demand.js";
+export declare function reportHourlyMatrixHtml(options: {
+    setup: HourlyMatrixSetup;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+    locale: AppLocale;
+    hourlyMatrixCadenceCache: ReportHourlyMatrixCadenceCache;
+}): string;

package/dist/src/workspace/reports/html/mounted.d.ts

@@ -0,0 +1,19 @@
+import type { ReportLayout } from "@overvis/hmi-shared/report";
+export type ReportHtmlColumn = ReportLayout["rows"][number][number]["column"];
+export interface ReportMountedWidget {
+    representationKey: string;
+    /** Layout span when `ReportView` passed `column`; `null` = host fill-parent. */
+    column: ReportHtmlColumn | null;
+}
+export interface ReportHtmlLayoutCell {
+    representation: string;
+    column: ReportHtmlColumn;
+}
+/** First mount of each representation key wins (do not double-publish). */
+export declare function uniqueMountedWidgets(mounted: readonly ReportMountedWidget[]): ReportMountedWidget[];
+/**
+ * HTML rows for Render: layout-backed mounts keep their row grouping; host mounts
+ * (`column` omitted) are full-width and ignore Setup spans. Unmounted layout cells
+ * are omitted.
+ */
+export declare function htmlLayoutRowsForMounted(layout: ReportLayout, mounted: readonly ReportMountedWidget[]): ReportHtmlLayoutCell[][];

package/dist/src/workspace/reports/html/png.d.ts

@@ -0,0 +1,39 @@
+import { type HistogramPlotSeries } from "../histogram/plot.js";
+import { type TimeBucketsPlotSeries } from "../time-buckets/plot.js";
+import { type PreparedSeries } from "../chart/payload.js";
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { HistogramSetup, TimeBucketsSetup } from "@overvis/hmi-shared/report";
+import type { TimeBucketsPaintedGrain } from "../time-buckets/navigate.js";
+import type { HistogramCadence } from "../histogram/slots.js";
+export declare function snapshotChartPng(options: {
+    series: PreparedSeries[];
+    from: number;
+    to: number;
+    timeZone: string;
+    width: number;
+    height: number;
+}): Promise<Uint8Array | null>;
+export declare function snapshotTimeBucketsPng(options: {
+    xs: number[];
+    series: TimeBucketsPlotSeries[];
+    grain: TimeBucketsPaintedGrain[];
+    displayAs: TimeBucketsSetup["displayAs"];
+    cadence: TimeBucketsSetup["cadence"];
+    timeZone: string;
+    from: number;
+    to: number;
+    width: number;
+    height: number;
+}): Promise<Uint8Array | null>;
+export declare function snapshotHistogramPng(options: {
+    locale: AppLocale;
+    xs: number[];
+    series: HistogramPlotSeries[];
+    displayAs: HistogramSetup["displayAs"];
+    cadence: HistogramCadence;
+    width: number;
+    height: number;
+}): Promise<Uint8Array | null>;
+/** Record on-screen `[data-report-plot]` CSS widths at freeze. */
+export declare function freezePlotCssWidths(): Record<string, number>;
+export declare function frozenPlotWidth(representationKey: string, frozen: Readonly<Record<string, number>>, fallback: number): number;

package/dist/src/workspace/reports/html/ready.d.ts

@@ -0,0 +1,56 @@
+import type { ReportParameterSetup, ReportPreset } from "@overvis/hmi-shared/report";
+import type { ReportHighPrecisionCache } from "../chart/demand.js";
+import { type ReportCalendarCadenceCache } from "../calendar/demand.js";
+import { type ReportHistogramCadenceCache } from "../histogram/demand.js";
+import { type ReportTimeBucketsCadenceCache, type ReportTimeBucketsDaysCache } from "../time-buckets/demand.js";
+import { type ReportHourlyMatrixCadenceCache } from "../hourly-matrix/demand.js";
+import { type ReportSankeyCache } from "../sankey/demand.js";
+import { type ReportStateDurationCache } from "../state-duration/demand.js";
+import { type ReportTableAggregateCache, type ReportTableCadenceCache, type ReportTableRawCache } from "../table/demand.js";
+export interface ReportHtmlReadyCaches {
+    highPrecisionCache: ReportHighPrecisionCache;
+    tableCadenceCache: ReportTableCadenceCache;
+    tableRawCache: ReportTableRawCache;
+    tableAggregateCache: ReportTableAggregateCache;
+    timeBucketsCadenceCache: ReportTimeBucketsCadenceCache;
+    timeBucketsDaysCache: ReportTimeBucketsDaysCache;
+    histogramCadenceCache: ReportHistogramCadenceCache;
+    calendarDaysCache: ReportCalendarCadenceCache;
+    calendarHourCache: ReportCalendarCadenceCache;
+    hourlyMatrixCadenceCache: ReportHourlyMatrixCadenceCache;
+    stateDurationCache: ReportStateDurationCache;
+    sankeyCache: ReportSankeyCache;
+}
+export declare function areMountedWidgetsTerminal(options: {
+    preset: ReportPreset;
+    representationKeys: readonly string[];
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+    nowMs: number;
+    sparseExtent: {
+        from: number;
+        to: number;
+    } | null;
+    sparseExtentLoading?: boolean;
+    caches: ReportHtmlReadyCaches;
+}): boolean;
+export interface FrozenPreciseRawNeed {
+    key: string;
+    parameterId: string;
+    sourceValueType: string;
+    from: number;
+    to: number;
+}
+/** Precise table keys the HTML wait must keep, even if follow-live moved session `to`. */
+export declare function frozenPreciseRawNeeds(options: {
+    preset: ReportPreset;
+    representationKeys: readonly string[];
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    timeZone: string;
+}): FrozenPreciseRawNeed[];

package/dist/src/workspace/reports/html/table.d.ts

@@ -0,0 +1,3 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { TableHtmlSnapshot } from "../table/snapshot.js";
+export declare function reportTableHtml(snapshot: TableHtmlSnapshot, emptyColumns: boolean, locale: AppLocale): string;

package/dist/src/workspace/reports/html/use-render.d.ts

@@ -0,0 +1,8 @@
+export declare function useReportHtmlRender(enabled: boolean): {
+    running: boolean;
+    progressValue: number | null;
+    start: () => void;
+    cancel: () => void;
+    resultUrl: string | null;
+    clearResult: () => void;
+};

package/dist/src/workspace/reports/html/widgets.d.ts

@@ -0,0 +1,31 @@
+import type { AppLocale } from "@overvis/hmi-shared";
+import type { ChartSetup, ReportColor, ReportParameterSetup, SankeySetup, StateDurationSetup } from "@overvis/hmi-shared/report";
+import type { ReportSankeyCache } from "../sankey/demand.js";
+import { type ReportStateDurationCache } from "../state-duration/demand.js";
+export declare function reportHtmlWidgetClass(column: "full" | "1/2" | "1/3" | "1/4", compact: boolean): string;
+export declare function reportHtmlShowsLegend(legend: ChartSetup["legend"]): boolean;
+export declare function reportStateDurationHtml(options: {
+    setup: StateDurationSetup;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    to: number;
+    locale: AppLocale;
+    nowMs: number;
+    stateDurationCache: ReportStateDurationCache;
+}): string;
+export declare function reportSankeyHtml(options: {
+    setup: SankeySetup;
+    parametersById: ReadonlyMap<string, ReportParameterSetup>;
+    visibleParameterIds: ReadonlySet<string>;
+    from: number;
+    closedTo: number;
+    locale: AppLocale;
+    width: number;
+    sankeyCache: ReportSankeyCache;
+}): string;
+export declare function legendHtml(items: {
+    label: string;
+    units: string;
+    color: ReportColor;
+}[]): string;

package/dist/src/workspace/reports/page.d.ts

@@ -0,0 +1,4 @@
+export declare function ReportPage({ workspaceId, presetId }: {
+    workspaceId: string;
+    presetId: string;
+}): import("react").JSX.Element;

package/dist/src/workspace/reports/preset/errors.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sankey recipe problems of a rejected report preset (`details.issues` keywords), or `null` for
+ * the standard API error text.
+ */
+export declare function reportPresetErrorText(error: unknown): string | null;

package/dist/src/workspace/reports/preset/form-helpers.d.ts

@@ -0,0 +1,65 @@
+import type { LocalizedString } from "@overvis/hmi-shared";
+import { type ChartParameterSetup, type ChartSetup, type TimeBucketsSetup, type HistogramSetup, type CalendarSetup, type HourlyMatrixSetup, type SankeySetup, type StateDurationSetup, type ReportLayout, type ReportParameterShellForm, type ReportColor, type ReportSetup, type TableParameterSetup, type TableSetup } from "@overvis/hmi-shared/report";
+/**
+ * Freeze selected live parameters as form rows in caller order, skipping unsupported value types
+ * and colors already on the report.
+ */
+export declare function freezeAddedReportParametersFromLive(input: {
+    parameters: readonly {
+        id: string;
+        name: LocalizedString;
+        units: LocalizedString | null;
+        icon: string | null;
+        valueType: {
+            name: string;
+        };
+    }[];
+    locale: string;
+    usedColors: Iterable<ReportColor>;
+}): ReportParameterShellForm[];
+/** Next auto key of a representation type: `chart`, then `chart2`, `chart3`, … */
+export declare function nextRepresentationKey(representations: Readonly<Record<string, unknown>>, type: string): string;
+export declare function createDefaultChartEntry(): ChartSetup;
+export declare function createDefaultTableEntry(): TableSetup;
+export declare function createDefaultTableParameter(parameter: Pick<ReportParameterShellForm, "parameterId" | "type">): TableParameterSetup;
+export declare function createDefaultTimeBucketsEntry(): TimeBucketsSetup;
+export declare function createDefaultHistogramEntry(): HistogramSetup;
+export declare function createDefaultTimeBucketsParameter(parameter: Pick<ReportParameterShellForm, "parameterId">): TimeBucketsSetup["parameters"][number];
+export declare function createDefaultHistogramParameter(parameter: Pick<ReportParameterShellForm, "parameterId">): HistogramSetup["parameters"][number];
+export declare function createDefaultCalendarEntry(): CalendarSetup;
+export declare function createDefaultCalendarDayValueParameter(parameter: Pick<ReportParameterShellForm, "parameterId">): NonNullable<CalendarSetup["dayValueParameter"]>;
+export declare function createDefaultCalendarColorParameter(parameter: Pick<ReportParameterShellForm, "parameterId" | "type">): NonNullable<CalendarSetup["dayTextColorParameter"]>;
+export declare function createDefaultHourlyMatrixEntry(): HourlyMatrixSetup;
+export declare function createDefaultHourlyMatrixGroup(parts: {
+    label: string;
+    totalHeader: string;
+}): HourlyMatrixSetup["parameters"][number];
+export declare function createDefaultHourlyMatrixCellValueParameter(parameter: Pick<ReportParameterShellForm, "parameterId">): NonNullable<HourlyMatrixSetup["parameters"][number]["cellValueParameter"]>;
+export declare function createDefaultHourlyMatrixColorParameter(parameter: Pick<ReportParameterShellForm, "parameterId" | "type">): NonNullable<HourlyMatrixSetup["parameters"][number]["cellTextColorParameter"]>;
+export declare function createDefaultHourlyMatrixDayHeaderParameter(parameter: Pick<ReportParameterShellForm, "parameterId" | "type">): NonNullable<HourlyMatrixSetup["parameters"][number]["dayHeaderParameters"]>[number];
+export declare function createDefaultSankeyEntry(): SankeySetup;
+export declare function createDefaultSankeyNode(parts: {
+    label: string;
+    nodes: readonly {
+        id: string;
+    }[];
+}): SankeySetup["nodes"][number];
+export declare function createDefaultSankeyLink(parts: {
+    fromNodeId: string;
+    toNodeId: string;
+    parameterId: string;
+}): SankeySetup["links"][number];
+export declare function createDefaultStateDurationEntry(): StateDurationSetup;
+export declare function createDefaultStateDurationParameter(parameter: Pick<ReportParameterShellForm, "parameterId">): StateDurationSetup["parameters"][number];
+export declare function createDefaultChartParameter(parameter: Pick<ReportParameterShellForm, "parameterId" | "type">): ChartParameterSetup;
+export declare function layoutPlacesRepresentation(layout: ReportLayout, key: string): boolean;
+/** Remove cells for `key`; drop empty rows. */
+export declare function pruneLayoutRepresentation(layout: ReportLayout, key: string): ReportLayout;
+/** Append a full-width row for `key`. */
+export declare function appendFullWidthLayoutRow(layout: ReportLayout, key: string): ReportLayout;
+/** Drop `parameterId` from every chart series, table column, time-buckets/histogram param, calendar slot, hourly-matrix slot, state-duration param, and sankey link; empty widgets stay. */
+export declare function pruneParameterFromRepresentations(representations: Record<string, ReportSetup>, parameterId: string): Record<string, ReportSetup>;
+/** Parameter ids referenced by representation setups (for shell remove warnings). */
+export declare function representationParameterIds(representations: Record<string, ReportSetup>): Set<string>;
+/** When CSV is enabled, ensure newly added snapshot ids are included in export. */
+export declare function unionExportParameterIds(currentIds: readonly string[], addedIds: readonly string[]): string[];