@kipk/ha-better-history 0.1.0

package/dist/ha-better-history.d.ts

@@ -0,0 +1,143 @@
+import { LitElement, type PropertyValues, type TemplateResult } from "lit";
+import type { AttributeUnitMap, BetterHistoryConfig, BetterHistoryLineMode } from "./types/config.js";
+import type { HomeAssistant } from "./types/ha.js";
+export declare class HaBetterHistory extends LitElement {
+    static styles: import("lit").CSSResult;
+    hass?: HomeAssistant;
+    config?: BetterHistoryConfig;
+    entities?: string[];
+    attributeUnits?: AttributeUnitMap;
+    hours: number;
+    startDate?: Date;
+    endDate?: Date;
+    showDatePicker: boolean;
+    showEntityPicker: boolean;
+    showImportButton: boolean;
+    showLegend: boolean;
+    showTooltip: boolean;
+    showControls: boolean;
+    width?: string;
+    height?: string;
+    lineMode?: BetterHistoryLineMode;
+    lineWidth?: string;
+    backgroundColor?: string;
+    graphTitle?: string;
+    titleFontFamily?: string;
+    titleFontSize?: string;
+    titleColor?: string;
+    language?: string;
+    debugPerformance: boolean;
+    toolsOpen: boolean;
+    private _resolved?;
+    private _hiddenSeriesIds;
+    private _rangeStart?;
+    private _rangeEnd?;
+    private _viewStart?;
+    private _viewEnd?;
+    private _liveNow;
+    private _datePickerReady;
+    private _entityComponentsReady;
+    private _runtimeLineMode?;
+    private _attributeMenuOpen;
+    private _attributeSearch;
+    private _selectedEntityId?;
+    private _path;
+    private _selectedSources;
+    private _customEntityIds;
+    private _entityPickerOpen;
+    private _draggingSourceId?;
+    private readonly _data;
+    private readonly _tooltip;
+    private _chartRenderCache?;
+    private _graphGroupRenderCache?;
+    private _prevClipX;
+    private _prevStartTime;
+    private _prevEndTime;
+    private _prevContainerWidth;
+    private _wasLoading;
+    private _suppressLineAnimation;
+    private _pendingAddedSources;
+    private _sourceAddBatchTimer?;
+    private _liveNowTimer?;
+    private _dragStartSourceIds?;
+    private _dragDropCommitted;
+    private _lastPickerOverlayOpen;
+    private _importedSeriesMeta;
+    private _importedDataActive;
+    private _containerWidth;
+    private _resizeObserver?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _maxXTicks;
+    private _effectiveStartDate;
+    private _effectiveEndDate;
+    private _requestedEndDate;
+    private _rangeExtendsFuture;
+    private _syncLiveClock;
+    private _stopLiveClock;
+    private _effectiveLineMode;
+    private _effectiveViewRange;
+    private _pickerEntities;
+    private _fetchSources;
+    private _isDefaultSource;
+    private _resolvedTemperatureUnit;
+    private _lastFetchKey;
+    private _lastFetchSources;
+    private _lastHassResolveTime;
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(changed: PropertyValues): void;
+    private _emitPickerOverlayState;
+    private _onDateRangeChanged;
+    private _pickScaleGroup;
+    private _defaultLineMode;
+    private _defaultLineWidth;
+    private _showImportButton;
+    private _buildRenderSeries;
+    private _chartSourceKey;
+    private _chartData;
+    private _graphGroups;
+    private _renderGraphGroup;
+    private _animateClipPaths;
+    private _renderChartBody;
+    private readonly _getEntityPickerItems;
+    private readonly _getAdditionalEntityPickerItems;
+    private _renderEntityPickerUI;
+    private _rangePercent;
+    private _loadedRangeMs;
+    private _minViewSpanMs;
+    private _setViewRangeMs;
+    private _dateFromRangePercent;
+    private _formatRangeDate;
+    private _setViewRangePart;
+    private _onRangeSelectionPointerDown;
+    private _resetViewRange;
+    private _setRuntimeLineMode;
+    private _exportData;
+    private _importData;
+    private _applyImportedData;
+    private _isExportPayload;
+    private _parseImportedSeries;
+    private _parseImportedPoint;
+    private _parseDate;
+    private _renderToolsPanel;
+    render(): TemplateResult;
+    private _toggleSeries;
+    private _renderDatePicker;
+    private _positionEntityMenu;
+    private _closeAttributeMenu;
+    private _onEntitySelected;
+    private _onEntityPickerOpened;
+    private _onEntityPickerClosed;
+    private _handleDocumentPointerDown;
+    private _handleDocumentClick;
+    private _isEventInsideAttributeOverlay;
+    private _sourceWithAttributeUnit;
+    private _addSource;
+    private _flushPendingAddedSources;
+    private _removeSource;
+    private _onSourceDragStart;
+    private _onSourceDragEnd;
+    private _onSourceDragOver;
+    private _onSourceDrop;
+    private _previewSourceOrder;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { HaBetterHistory } from "./ha-better-history.js";
+export { type BetterHistoryConfig, type BetterHistoryLineMode, type SeriesConfig, type ResolvedConfig, type ResolvedSeries, type AttributeUnitMap } from "./types/config.js";
+export { type HistorySource, type HistorySeries, type HistoryPoint, type HistoryValueType } from "./data/history.js";
+export { type HomeAssistant, type HassEntity } from "./types/ha.js";
+export { type TooltipValue, type TooltipState } from "./controllers/tooltip-controller.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "./ha-better-history-BY4eqV1H.js";
+export { e as HaBetterHistory };

package/dist/load-ha-components.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureHaComponents(): Promise<void>;
+export declare function ensureDateRangePicker(): Promise<void>;

package/dist/localize/localize.d.ts

@@ -0,0 +1,2 @@
+import type { HomeAssistant } from "../types/ha.js";
+export declare function localize(hass: HomeAssistant | undefined, key: string): string;

package/dist/render/chart.d.ts

@@ -0,0 +1,109 @@
+import { type NumericScale } from "./scales.js";
+import { type HeatingAreaRenderData } from "./climate-overlay.js";
+import type { HistoryPoint } from "../data/history.js";
+import type { HistoryValueType } from "../data/value-type.js";
+import type { BetterHistoryLineMode } from "../types/config.js";
+export declare const CHART_WIDTH = 720;
+export declare const PLOT_LEFT = 40;
+export declare const PLOT_RIGHT = 680;
+export declare const PLOT_WIDTH: number;
+export declare const PLOT_TOP = 18;
+export declare const SEGMENT_ROW_HEIGHT = 14;
+export declare const SEGMENT_HEIGHT = 9;
+export interface RenderableSeries {
+    id: string;
+    label: string;
+    color: string;
+    unit?: string;
+    scaleGroupKey: string;
+    scaleMode: "auto" | "manual";
+    scaleMin?: number;
+    scaleMax?: number;
+    lineMode: BetterHistoryLineMode;
+    lineWidth: string;
+    valueType: HistoryValueType;
+    points: HistoryPoint[];
+}
+export interface NumericLineRenderData {
+    id: string;
+    color: string;
+    points: string;
+    pathLength: number;
+    lineWidth: string;
+}
+export interface NumericColumnRenderData {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill: string;
+}
+export interface SegmentRenderData {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    fill: string;
+}
+export interface YAxisLabelRenderData {
+    y: number;
+    value: string;
+}
+export interface XAxisLabelRenderData {
+    x: number;
+    label: string;
+    bold?: boolean;
+}
+export interface ChartRenderData {
+    allSeries: RenderableSeries[];
+    visibleSeries: RenderableSeries[];
+    timeBounds: {
+        start: number;
+        end: number;
+    };
+    extendStairToEnd: boolean;
+    numericScales: NumericScale[];
+    plotBottom: number;
+    chartHeight: number;
+    numericLines: NumericLineRenderData[];
+    numericColumns: NumericColumnRenderData[];
+    segments: SegmentRenderData[];
+    heatingAreas: HeatingAreaRenderData[];
+    yAxisLabels: YAxisLabelRenderData[];
+    xAxisLabels: XAxisLabelRenderData[];
+}
+export interface GraphGroup {
+    series: RenderableSeries[];
+    allSeries: RenderableSeries[];
+    scale?: NumericScale;
+    scales: NumericScale[];
+    svgHeight: number;
+    canvasHeight: number;
+    lines: NumericLineRenderData[];
+    columns: NumericColumnRenderData[];
+    segments: SegmentRenderData[];
+    yLabels: YAxisLabelRenderData[];
+    rightYLabels: YAxisLabelRenderData[];
+    xLabels: XAxisLabelRenderData[];
+    heatingAreas: HeatingAreaRenderData[];
+}
+export declare function xFor(time: number, bounds: {
+    start: number;
+    end: number;
+}): number;
+export declare function yFor(value: number, scale: NumericScale): number;
+export declare function scaleFor(series: RenderableSeries, scales: NumericScale[]): NumericScale | undefined;
+export declare function stateRanges(series: RenderableSeries, bounds: {
+    start: number;
+    end: number;
+}): Array<{
+    start: number;
+    end: number;
+    value: number | string | boolean;
+}>;
+export declare function buildChartData(allSeries: RenderableSeries[], visibleSeries: RenderableSeries[], timeBounds: {
+    start: number;
+    end: number;
+}, disableClimateOverlay?: boolean, maxXTicks?: number, extendStairToEnd?: boolean): ChartRenderData;
+export declare function buildGraphGroups(data: ChartRenderData, maxXTicks?: number): GraphGroup[];

package/dist/render/climate-overlay.d.ts

@@ -0,0 +1,10 @@
+import { type RenderableSeries } from "./chart.js";
+import { type NumericScale } from "./scales.js";
+export interface HeatingAreaRenderData {
+    id: string;
+    points: string;
+}
+export declare function buildClimateHeatingAreas(visibleSeries: RenderableSeries[], scales: NumericScale[], bounds: {
+    start: number;
+    end: number;
+}): HeatingAreaRenderData[];

package/dist/render/colors.d.ts

@@ -0,0 +1,5 @@
+export declare const PALETTE: string[];
+export declare const CLIMATE_ATTR_COLORS: Record<string, string>;
+export declare function paletteColor(index: number): string;
+export declare function graphColor(preferred: string, used: Set<string>, index: number): string;
+export declare function graphColorKey(color: string): string;

package/dist/render/downsample.d.ts

@@ -0,0 +1,8 @@
+import type { HistoryPoint } from "../data/history.js";
+export declare function displayNumericPoints(points: HistoryPoint[], bounds: {
+    start: number;
+    end: number;
+}, plotLeft: number, plotWidth: number): Array<{
+    time: number;
+    value: number;
+}>;

package/dist/render/scales.d.ts

@@ -0,0 +1,40 @@
+import type { HistoryPoint } from "../data/history.js";
+import type { HistoryValueType } from "../data/value-type.js";
+export interface NumericScale {
+    ids: Set<string>;
+    graphKey: string;
+    axis: "left" | "right";
+    min: number;
+    max: number;
+    precision: number;
+    top: number;
+    height: number;
+    ticks: number[];
+}
+interface ScaleInput {
+    id: string;
+    unit?: string;
+    scaleGroupKey: string;
+    scaleMode: "auto" | "manual";
+    scaleMin?: number;
+    scaleMax?: number;
+    valueType: HistoryValueType;
+    points: HistoryPoint[];
+}
+export declare const GRAPH_TOP = 28;
+export declare const GRAPH_HEIGHT = 180;
+export declare const GRAPH_GAP = 34;
+export declare const GRAPH_STEP: number;
+export declare const GRAPH_BOTTOM_PADDING = 18;
+export declare const PLOT_PADDING = 5;
+export declare function valuePrecision(value: number): number;
+export declare function roundToPrecision(value: number, precision: number): number;
+export declare function computeNiceTicks(min: number, max: number, desiredCount?: number): number[];
+export declare function tickPrecision(ticks: number[]): number;
+export declare function paddedRange(min: number, max: number, precision: number): {
+    min: number;
+    max: number;
+};
+export declare function plotBottomFor(numericScaleCount: number): number;
+export declare function numericScalesFor(series: ScaleInput[]): NumericScale[];
+export {};

package/dist/styles/chart.css.d.ts

@@ -0,0 +1 @@
+export declare const chartStyles: import("lit").CSSResult;

package/dist/types/config.d.ts

@@ -0,0 +1,73 @@
+import type { HistoryValueType } from "../data/value-type.js";
+export type AttributeUnitMap = Record<string, string>;
+export type BetterHistoryLineMode = "stair" | "line" | "column";
+export interface SeriesConfig {
+    entity: string;
+    attribute?: string | string[];
+    label?: string;
+    color?: string;
+    unit?: string;
+    scaleGroup?: string;
+    scaleMode?: "auto" | "manual";
+    scaleMin?: number;
+    scaleMax?: number;
+    lineMode?: BetterHistoryLineMode;
+    lineWidth?: number | string;
+}
+export interface BetterHistoryConfig {
+    hours?: number;
+    startDate?: Date;
+    endDate?: Date;
+    showDatePicker?: boolean;
+    showEntityPicker?: boolean;
+    showImportButton?: boolean;
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    width?: string;
+    height?: string;
+    lineMode?: BetterHistoryLineMode;
+    lineWidth?: number | string;
+    backgroundColor?: string;
+    title?: string;
+    titleFontFamily?: string;
+    titleFontSize?: string;
+    titleColor?: string;
+    series?: SeriesConfig[];
+    defaultEntities?: string[];
+    disableClimateOverlay?: boolean;
+    debugPerformance?: boolean;
+    attributeUnits?: AttributeUnitMap;
+}
+export interface ResolvedSeries {
+    id: string;
+    entity: string;
+    attribute?: string[];
+    label: string;
+    color: string;
+    unit?: string;
+    scaleGroupKey: string;
+    scaleMode: "auto" | "manual";
+    scaleMin?: number;
+    scaleMax?: number;
+    lineMode: BetterHistoryLineMode;
+    lineWidth: string;
+    valueType: HistoryValueType;
+}
+export interface ResolvedConfig {
+    startDate: Date;
+    endDate: Date;
+    showDatePicker: boolean;
+    showEntityPicker: boolean;
+    showLegend: boolean;
+    showTooltip: boolean;
+    width: string;
+    height: string | undefined;
+    backgroundColor: string | undefined;
+    title: string | undefined;
+    titleFontFamily: string | undefined;
+    titleFontSize: string | undefined;
+    titleColor: string | undefined;
+    language: string | undefined;
+    series: ResolvedSeries[];
+    disableClimateOverlay: boolean;
+}

package/dist/types/ha.d.ts

@@ -0,0 +1,18 @@
+export interface HassEntity {
+    entity_id: string;
+    state: string;
+    attributes: Record<string, unknown>;
+    last_changed?: string;
+    last_updated?: string;
+}
+export interface HomeAssistant {
+    states: Record<string, HassEntity | undefined>;
+    language?: string;
+    locale?: {
+        language?: string;
+    };
+    localize?(key: string): string;
+    callApi?<T>(method: string, path: string, parameters?: Record<string, unknown>): Promise<T>;
+    callWS?<T>(message: Record<string, unknown>): Promise<T>;
+    callService(domain: string, service: string, serviceData?: Record<string, unknown>): Promise<unknown>;
+}

package/dist/ui/date-picker.d.ts

@@ -0,0 +1,5 @@
+import { type TemplateResult } from "lit";
+import type { HomeAssistant } from "../types/ha.js";
+export declare function datePickerAvailable(): boolean;
+export declare function preloadDatePicker(): Promise<void>;
+export declare function renderDatePicker(hass: HomeAssistant | undefined, startDate: Date, endDate: Date, onChange: (startDate: Date, endDate: Date) => void): TemplateResult;

package/dist/ui/entity-picker.d.ts

@@ -0,0 +1,35 @@
+import { type TemplateResult } from "lit";
+import { type HistorySource } from "../data/history.js";
+import type { HassEntity, HomeAssistant } from "../types/ha.js";
+import type { ResolvedConfig } from "../types/config.js";
+export declare function entityLabel(entity: HassEntity): string;
+export declare function preloadEntityPickerComponents(): Promise<void>;
+interface EntityPickerRenderOpts {
+    hass?: HomeAssistant;
+    menuOpen: boolean;
+    entityPickerOpen: boolean;
+    selectedEntityId?: string;
+    path: string[];
+    selectedSources: HistorySource[];
+    draggingSourceId?: string;
+    resolved?: ResolvedConfig;
+    loading: boolean;
+    attributeSearch: string;
+    getItems: () => unknown[];
+    getAdditionalItems: (search?: string) => unknown[];
+    onEntityPickerOpened(): void;
+    onEntityPickerClosed(): void;
+    onEntitySelected(entityId: string): void;
+    onAttributeSearchChanged(value: string): void;
+    onSourceAdded(source: HistorySource): void;
+    onSourceRemoved(sourceId: string): void;
+    onSourceDragStart(sourceId: string, event: DragEvent): void;
+    onSourceDragOver(sourceId: string | undefined, event: DragEvent): void;
+    onSourceDragEnd(): void;
+    onSourceDrop(sourceId: string | undefined, event: DragEvent): void;
+    onBreadcrumbClick(path: string[]): void;
+    onCloseMenu(): void;
+}
+export declare function entityPickerAvailable(): boolean;
+export declare function renderEntityPicker(opts: EntityPickerRenderOpts): TemplateResult;
+export {};

package/dist/utils/performance.d.ts

@@ -0,0 +1,3 @@
+export type PerformanceDetails = Record<string, number | string | boolean | undefined>;
+export declare function performanceNow(): number;
+export declare function logPerformance(enabled: boolean, event: string, details: PerformanceDetails): void;

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@kipk/ha-better-history",
+  "version": "0.1.0",
+  "description": "Standalone web component for Home Assistant history charts.",
+  "type": "module",
+  "author": "@KipK",
+  "keywords": [
+    "home-assistant",
+    "lovelace",
+    "web-component",
+    "history",
+    "chart",
+    "lit"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KipK/ha-better-history.git"
+  },
+  "bugs": {
+    "url": "https://github.com/KipK/ha-better-history/issues"
+  },
+  "homepage": "https://github.com/KipK/ha-better-history#readme",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./define": {
+      "import": "./dist/define.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "dist/define.js"
+  ],
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "dev": "vite --config vite.config.dev.ts"
+  },
+  "dependencies": {
+    "@kipk/load-ha-components": "^1.0.3",
+    "lit": "^3.3.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vite": "^8.0.10"
+  }
+}