@camstack/ui-library 1.2.383 → 1.2.385

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.385] - 2026-11-05
+
+### Removed
+
+- The generated client no longer offers the retired per-integration settings methods
+
+## [1.2.384] - 2026-11-05
+
+### Changed
+
+- Device History tab lists an appliance's runs (start, end, duration, energy, peak and average power, outcome) and shades each run on the power chart
+
 ## [1.2.383] - 2026-11-04
 
 ### Changed

package/dist/composites/DeviceRunsPanel.d.ts

@@ -0,0 +1,23 @@
+/**
+* DeviceRunsPanel — the runs of an appliance, newest first, on the device's
+* History tab: start, end, duration, energy, peak and mean power, outcome.
+* A row opens the run's window (the run plus a margin) in the history view.
+*
+* Presentational: the caller reads the runs (`useDeviceRuns`) and decides
+* whether the device has any — the panel never answers "no runs" itself, an
+* unanswered query is not an empty one (D315). A measurement that failed is
+* `—`, never `0` (D393).
+*/
+import { type JSX } from "react";
+import type { DeviceRun } from "@camstack/types";
+import type { HistoryWindow } from "./device-history/history-window";
+export interface DeviceRunsPanelProps {
+	/** Runs as the cap returned them (newest first); never an unanswered query. */
+	readonly runs: readonly DeviceRun[];
+	/** The instant an open run counts up to. */
+	readonly now: number;
+	/** A row was chosen: show this window. */
+	readonly onSelectWindow: (window: HistoryWindow) => void;
+	readonly className?: string;
+}
+export declare function DeviceRunsPanel({ runs, now, onSelectWindow, className }: DeviceRunsPanelProps): JSX.Element;

package/dist/composites/charts/TimeSeriesChart.d.ts

@@ -12,10 +12,12 @@
 */
 import { type JSX, type ReactNode } from "react";
 import type { DisplayPreference } from "@camstack/types";
+import { type ChartBand } from "./chart-bands";
 import { type ValueAxisSpec } from "./chart-uplot";
 import { type ChartWindowToggleProps } from "./chart-window";
 import { type TimeSeriesDef } from "./time-series-model";
 export type { TimeSeriesDef } from "./time-series-model";
+export type { ChartBand, ChartBandTone } from "./chart-bands";
 export interface ChartRange {
 	readonly from: number;
 	readonly to: number;
@@ -23,6 +25,8 @@ export interface ChartRange {
 export interface TimeSeriesChartProps<TId extends string = string> {
 	readonly title: string;
 	readonly series: readonly TimeSeriesDef[];
+	/** Spans shaded behind the lines (a run, a window); the point tooltip names the ones under the cursor. */
+	readonly bands?: readonly ChartBand[];
 	/** The window the x axis spans; default: the data's own span. */
 	readonly range?: ChartRange;
 	/** Plot height in px. Default 120. */
@@ -48,4 +52,4 @@ export interface TimeSeriesChartProps<TId extends string = string> {
 	readonly windowToggle?: ChartWindowToggleProps<TId>;
 	readonly className?: string;
 }
-export declare function TimeSeriesChart<TId extends string = string>({ title, series, range, height, stacked, area, syncKey, formatValue, displayPreference, axisFor, emptyMessage, pending, actions, footer, windowToggle, className }: TimeSeriesChartProps<TId>): JSX.Element;
+export declare function TimeSeriesChart<TId extends string = string>({ title, series, bands, range, height, stacked, area, syncKey, formatValue, displayPreference, axisFor, emptyMessage, pending, actions, footer, windowToggle, className }: TimeSeriesChartProps<TId>): JSX.Element;

package/dist/composites/charts/chart-bands.d.ts

@@ -0,0 +1,22 @@
+/**
+* Shaded bands over a chart's time axis: a span that means something (a
+* washing cycle, a maintenance window) drawn behind the lines. Pure model;
+* `TimeSeriesChart` paints it and states it in the point tooltip.
+*/
+import type { ChartChromeToken } from "./chart-palette";
+export type ChartBandTone = "neutral" | "info" | "success" | "warning" | "danger";
+export interface ChartBand {
+	readonly id: string;
+	readonly from: number;
+	readonly to: number;
+	/** Short name of the kind of span ("Run"); the tooltip row's label. */
+	readonly title: string;
+	/** What the span was ("1h 40m · 1.32 kWh"); the tooltip row's value. */
+	readonly label: string;
+	readonly tone: ChartBandTone;
+}
+export declare function bandToken(tone: ChartBandTone): ChartChromeToken;
+/** The bands that contain `x` (edges included), in input order. */
+export declare function bandsAt(bands: readonly ChartBand[], x: number): readonly ChartBand[];
+/** Bands clipped to `[from, to]`; one that lies wholly outside, or is empty, is dropped. */
+export declare function clipBands(bands: readonly ChartBand[], from: number, to: number): readonly ChartBand[];

package/dist/composites/charts/chart-palette.d.ts

@@ -31,7 +31,7 @@ export declare function swatchFillClass(token: ChartSwatchToken): string;
 /** The utility that colours a dashed swatch's line with `token`. */
 export declare function swatchLineClass(token: ChartSwatchToken): string;
 /** Neutral roles the canvas draws with (axes, grid, gap shading). */
-export type ChartChromeToken = "foreground-subtle" | "foreground-muted" | "border" | "border-subtle" | "surface" | "primary";
+export type ChartChromeToken = "foreground-subtle" | "foreground-muted" | "border" | "border-subtle" | "surface" | "primary" | "info" | "success" | "warning" | "danger";
 /**
 * Resolve a theme token to the colour the canvas paints. Reads the computed
 * value of `--color-<token>` on the chart's own root (so a scoped theme block

package/dist/composites/charts/chart-tooltip-model.d.ts

@@ -146,6 +146,8 @@ export interface LineTooltipBodyInput {
 	readonly timeLabel: string;
 	readonly series: readonly LineTooltipSample[];
 	readonly preference?: DisplayPreference;
+	/** Rows after the series (e.g. the bands under the cursor). */
+	readonly extra?: readonly ChartTooltipLine[];
 }
 /** Time plus one line per visible series. */
 export declare function lineTooltipBody(input: LineTooltipBodyInput): ChartTooltipBody;

package/dist/composites/charts/chart-uplot.d.ts

@@ -4,6 +4,7 @@
 * hole shading. Every colour is a FUNCTION so a theme switch is a redraw.
 */
 import type uPlot from "uplot";
+import { type ChartBand } from "./chart-bands";
 import { type GapSpan } from "./chart-data";
 import { type AxisScale } from "./chart-scale";
 /** The x axis: wall-clock time under the plot, at the window's precision. */
@@ -32,6 +33,8 @@ export declare function chartCursor(syncKey: string | undefined): uPlot.Cursor;
 * missing ground and never as a quiet period.
 */
 export declare function gapShadeHook(spans: () => readonly GapSpan[]): (u: uPlot) => void;
+/** Paint the bands behind the lines, each in its tone. */
+export declare function bandShadeHook(bands: () => readonly ChartBand[]): (u: uPlot) => void;
 /** Is this unit a byte count (binary axis and formatter)? */
 export declare function isByteUnit(unit: string | null | undefined): boolean;
 /** The default axis spec for a unit. */

package/dist/composites/charts/index.d.ts

@@ -2,7 +2,7 @@
 * The chart family (D899): one look for every time-based chart, built on
 * uPlot, themed only through `--color-chart-series-*` and the neutral tokens.
 */
-export { TimeSeriesChart, type ChartRange, type TimeSeriesChartProps } from "./TimeSeriesChart";
+export { TimeSeriesChart, type ChartBand, type ChartBandTone, type ChartRange, type TimeSeriesChartProps } from "./TimeSeriesChart";
 export { StateTimeline, stateStyle, type StateRowDef, type StateTimelineProps } from "./StateTimeline";
 export { BarSeries, type BarSeriesProps } from "./BarSeries";
 export { Sparkline, type SparklinePoint, type SparklineProps } from "./Sparkline";

package/dist/composites/device-history/HistoryChart.d.ts

@@ -8,7 +8,7 @@
 * point is the empty state — never a flat zero.
 */
 import { type JSX, type ReactNode } from "react";
-import type { DeviceHistoryQueryManyEntry } from "@camstack/types";
+import type { DeviceHistoryQueryManyEntry, DeviceRun } from "@camstack/types";
 import { type UiTextFn } from "../../contexts/ui-text";
 import { type HistoryChartSpec } from "./history-model";
 import type { HistoryReads } from "./use-device-history";
@@ -22,10 +22,13 @@ export interface HistoryChartProps {
 	readonly compare: boolean;
 	readonly syncKey: string;
 	readonly actions?: ReactNode;
+	/** The device's runs, drawn as bands on its power chart; an open run extends to `now`. */
+	readonly runs?: readonly DeviceRun[];
+	readonly now?: number;
 }
 /** Operator words for a boolean field's two states. */
 export declare function booleanLabels(key: string, t: UiTextFn): {
 	readonly on: string;
 	readonly off: string;
 };
-export declare function HistoryChart({ spec, entryFor, reads, window, compare, syncKey, actions }: HistoryChartProps): JSX.Element;
+export declare function HistoryChart({ spec, entryFor, reads, window, compare, syncKey, actions, runs, now }: HistoryChartProps): JSX.Element;

package/dist/composites/device-history/history-runs.d.ts

@@ -0,0 +1,29 @@
+/**
+* A device's runs as the History view shows them: chart bands, panel rows and
+* the window a row opens. Pure: the caller supplies `now` and the text.
+*
+* A measurement that failed is `null` and reads `—`, never `0` (D393). An open
+* run extends to `now`.
+*/
+import type { DeviceRun, DeviceRunOutcome } from "@camstack/types";
+import type { UiTextFn } from "../../contexts/ui-text";
+import type { ChartBand, ChartBandTone } from "../charts/chart-bands";
+import type { HistoryWindow } from "./history-window";
+/** The context kept on each side of a run when a row opens it. */
+export declare const RUN_WINDOW_MARGIN_MS: number;
+/** The series whose chart carries the run bands. */
+export declare const RUN_BANDS_SERIES_KEY = "cap:power-meter.power";
+export declare const NO_VALUE: string;
+export type RunStatus = DeviceRunOutcome | "running";
+export declare function runStatus(run: DeviceRun): RunStatus;
+export declare function runEnd(run: DeviceRun, now: number): number;
+/** Elapsed time of a run; an open one counts up to `now`. `null` when a closed run has no duration. */
+export declare function runDurationMs(run: DeviceRun, now: number): number | null;
+export declare function formatKwh(kwh: number | null): string;
+export declare function formatWatts(w: number | null): string;
+export declare function formatRunDuration(ms: number | null): string;
+export declare function runTone(status: RunStatus): ChartBandTone;
+/** The window that frames a run: the run plus {@link RUN_WINDOW_MARGIN_MS} each side. */
+export declare function runWindow(run: DeviceRun, now: number): HistoryWindow;
+/** One band per run that overlaps `window`; the label states the duration and the energy. */
+export declare function runBands(runs: readonly DeviceRun[], now: number, window: HistoryWindow, t: UiTextFn): readonly ChartBand[];

package/dist/composites/device-history/index.d.ts

@@ -5,6 +5,8 @@
 */
 export { DeviceHistoryView, humanizeName, type DeviceHistoryViewProps } from "./DeviceHistoryView";
 export { HistoryChart, booleanLabels, type HistoryChartProps } from "./HistoryChart";
+export { useDeviceRuns, DEVICE_RUNS_PAGE } from "./use-device-runs";
+export { RUN_WINDOW_MARGIN_MS, runBands, runWindow } from "./history-runs";
 export { HistoryWindowBar, type HistoryWindowBarProps } from "./HistoryWindowBar";
 export { BOOLEAN_STATES, OCCUPANCY_KEY, chartKeys, energyBuckets, filterOccupancyLines, groupDeviceSeries, linePoints, occupancyFacets, occupancyLines, parseCapKey, parseProducerKey, shiftPoints, stateRow, type HistoryChartSpec, type HistorySection, type OccupancyFilter, type OccupancyScopeLine } from "./history-model";
 export { chunk, isRefusal, readHistory, type HistoryReader, type HistoryReadWindow } from "./history-reads";

package/dist/composites/device-history/use-device-runs.d.ts

@@ -0,0 +1,11 @@
+/**
+* A device's runs for the History view. `device-runs` is a per-type
+* capability: a device without it, or with no run yet, answers an error or an
+* empty page - both read as "no runs panel". A query still in flight is not
+* an answer either (D315): `undefined` until the cap answers with rows.
+*/
+import type { DeviceRun } from "@camstack/types";
+/** How many runs the panel and the bands are given; the cap's page size. */
+export declare const DEVICE_RUNS_PAGE = 50;
+/** The newest runs, or `undefined` while unanswered, absent or empty. */
+export declare function useDeviceRuns(deviceId: number): readonly DeviceRun[] | undefined;

package/dist/composites/index.d.ts

@@ -82,6 +82,7 @@ export { CopyButton } from "./copy-button";
 export type { DataColumn, DataTableProps } from "./data-table";
 export * from "./data-table";
 export { DataTable } from "./data-table";
+export { DeviceRunsPanel, type DeviceRunsPanelProps } from "./DeviceRunsPanel";
 export type { DataTablePage, DataTablePaginationLabels } from "./data-table-pagination";
 export { DEFAULT_PAGINATION_LABELS, paginateRows } from "./data-table-pagination";
 export type { DataTablePagerProps } from "./data-table-pager";

package/dist/generated/system-hooks.d.ts

@@ -981,12 +981,6 @@ export declare const useIntegrationsCreate: typeof trpc.integrations.create.useM
 export declare const useIntegrationsUpdate: typeof trpc.integrations.update.useMutation;
 /** Generated alias around `trpc.integrations.delete.useMutation`. */
 export declare const useIntegrationsDelete: typeof trpc.integrations.delete.useMutation;
-/** Generated alias around `trpc.integrations.getSettings.useQuery`. */
-export declare const useIntegrationsGetSettings: typeof trpc.integrations.getSettings.useQuery;
-/** Generated alias around `trpc.integrations.setSettings.useMutation`. */
-export declare const useIntegrationsSetSettings: typeof trpc.integrations.setSettings.useMutation;
-/** Generated alias around `trpc.integrations.clearSettings.useMutation`. */
-export declare const useIntegrationsClearSettings: typeof trpc.integrations.clearSettings.useMutation;
 /** Generated alias around `trpc.integrations.getAvailableTypes.useQuery`. */
 export declare const useIntegrationsGetAvailableTypes: typeof trpc.integrations.getAvailableTypes.useQuery;
 /** Generated alias around `trpc.integrations.testConnection.useMutation`. */