ml-time-graph 1.0.0 → 1.0.2

package/dist/{layout-Sc5UkC0r.d.ts → layout-CkEYYdSw.d.ts}

@@ -1,4 +1,4 @@
-import { p as DrawCommand, t as DrawGroup, $ as PointStyleType } from './scale-Cbr0KpPz.js';
+import { o as DrawCommand, s as DrawGroup, _ as PointStyleType } from './scale-O3OLrmn5.js';
 
 /** Output format type for the renderer (SVG string, Canvas, or nothing). */
 type RenderType = 'svg' | 'canvas' | 'none';

package/dist/{scale-Cbr0KpPz.d.ts → scale-O3OLrmn5.d.ts}

@@ -53,6 +53,15 @@ interface DrawPath extends DrawEffects {
     type: 'path';
     points: Point[];
     smoothing?: boolean;
+    /**
+     * When `smoothing` is enabled, only apply the Catmull-Rom spline to the
+     * first `smoothCount` points; the remaining points connect with straight
+     * `L` commands. Used by fill polygons: the data-following top curve should
+     * be smoothed, but the flat baseline must stay straight — otherwise the
+     * spline rounds the corners and bulges past the start/end data points.
+     * Unset (or ≥ points.length) keeps the current behaviour: smooth all.
+     */
+    smoothCount?: number;
     stroke?: string;
     strokeWidth?: number;
     fill?: string;
@@ -454,17 +463,6 @@ interface DataPoint {
      */
     synthetic?: boolean;
 }
-/**
- * Limits + activation energy for pre-computed slot-level statistics (MKT,
- * minutes-above/below). When passed to `aggregateBySlot`, the returned
- * slots are widened to `StatsAggregatedPoint`. At render time, an
- * equivalent on-the-fly variant is the `limits` / `movingMkt` overlay.
- */
-interface AggregationThresholds {
-    limitLow: number;
-    limitHigh: number;
-    activationEnergy?: number;
-}
 /** Aggregierter Messwert pro Zeitslot (hourly/daily/custom). */
 interface AggregatedPoint {
     /** Slot-Start-Zeit (ms) */
@@ -565,8 +563,20 @@ interface GapConfig {
     minGapMs?: number;
     gaps?: Gap[];
 }
-/** Possible positions for threshold labels */
-type ThresholdLabelPosition = "left" | "right" | "above" | "below" | "center";
+/** Possible positions for threshold labels.
+ *
+ *  Inside the plot area:
+ *    'left' / 'right'   — at the plot edge, INSIDE the rect (overlaps data if line is busy).
+ *    'above' / 'below'  — above / below the threshold line, centred on the time domain.
+ *    'center'           — middle of the threshold line, inside the plot.
+ *
+ *  Outside the plot area (in the axis gutter, alongside the tick labels):
+ *    'outside-left'   — to the LEFT of the plot rect.
+ *    'outside-right'  — to the RIGHT of the plot rect.
+ *  Use these for audit-style charts where the absolute threshold value
+ *  must be readable without crossing the data line.
+ */
+type ThresholdLabelPosition = "left" | "right" | "above" | "below" | "center" | "outside-left" | "outside-right";
 interface ThresholdLabelConfig {
     /** Label text (default: the threshold's name). */
     text?: string;
@@ -590,6 +600,12 @@ interface Threshold {
     fillHatch?: HatchVariant;
     fillOpacity?: number;
     label?: false | string | ThresholdLabelConfig;
+    /**
+     * Which Y-axis this threshold's `value` is on. Default 0 (left).
+     * Set to 1 to anchor the threshold to the right Y-axis — e.g. a
+     * humidity threshold on a dual-axis temperature + humidity chart.
+     */
+    axisIndex?: number;
     /** Optional SVG id prefix for threshold elements. Generated ids: `<id>-line`, `<id>-fill`, `<id>-label`. */
     id?: string;
     shadowColor?: string;
@@ -620,10 +636,16 @@ interface DataPointRef {
 /**
  * A free-form, user-supplied overlay drawn in data coordinates (time/value).
  * The chart projects it to pixels, so it tracks the data through zoom/resize.
- * An optional `id` lets you remove or enable/disable it dynamically.
+ *
+ *  - `id`     — stable handle for `disableAnnotation()` / `enableAnnotation()`
+ *               and for the wrapper `<g id="annotation-{slug}">` in the SVG
+ *               output (lets external code toggle visibility via CSS).
+ *  - `title`  — human-readable label, used by toggle panels / legends.
+ *               Not drawn in the chart itself.
  */
 type Annotation = {
     id?: string;
+    title?: string;
 } & ({
     type: "line";
     from: DataPointRef;
@@ -821,4 +843,4 @@ declare class BandScale implements Scale {
     positions(): Map<string, number>;
 }
 
-export { type PointStyleType as $, type AggregatedPoint as A, BandScale as B, type CircleParams as C, type Dashstyle_t as D, type EnumMap as E, type FillBound as F, type FillSide as G, type FillSpec as H, type FillStyle as I, type Gap as J, type GapConfig as K, type GapLabel as L, type GapRegion as M, type GapStyle as N, type GapsConfig as O, type HatchVariant as P, type Highlight as Q, type LabelAnchor as R, type LineDashStyle as S, type LineParams as T, type LineStyle as U, type LineVariant as V, LinearScale as W, type LinearScaleConfig as X, type MarkerStyle as Y, type PathParams as Z, type Point as _, type AggregatedSeries as a, type RectParams as a0, type Scale as a1, type ScaleConfig as a2, type SensorType as a3, type SeriesOverlay as a4, type SeriesOverlayKind as a5, type SeriesStyle as a6, type SeriesType as a7, type ShadowStyle as a8, TIME_INTERVALS as a9, type TextParams as aa, type Threshold as ab, type ThresholdLabelConfig as ac, type ThresholdLabelPosition as ad, TimeScale as ae, type TimeScaleConfig as af, type TimeSeries as ag, getHatch as ah, type AggregationConfig as b, type AggregationMode as c, type AggregationThresholds as d, type Annotation as e, type AnnotationBandConfig as f, type AnnotationBandItem as g, type AnySeries as h, type AxisOrientation as i, type AxisPosition as j, type BandScaleConfig as k, type DataPoint as l, type DataPointRef as m, type DomainScaleConfig as n, type DrawCircle as o, type DrawCommand as p, type DrawGap as q, type DrawGapType_t as r, type DrawGradient as s, type DrawGroup as t, type DrawLine as u, type DrawPath as v, type DrawRect as w, type DrawText as x, type FillDirectionType as y, type FillRegion as z };
+export { type RectParams as $, type AggregatedPoint as A, BandScale as B, type CircleParams as C, type Dashstyle_t as D, type EnumMap as E, type FillBound as F, type FillSpec as G, type FillStyle as H, type Gap as I, type GapConfig as J, type GapLabel as K, type GapRegion as L, type GapStyle as M, type GapsConfig as N, type HatchVariant as O, type Highlight as P, type LabelAnchor as Q, type LineDashStyle as R, type LineParams as S, type LineStyle as T, type LineVariant as U, LinearScale as V, type LinearScaleConfig as W, type MarkerStyle as X, type PathParams as Y, type Point as Z, type PointStyleType as _, type AggregatedSeries as a, type Scale as a0, type ScaleConfig as a1, type SensorType as a2, type SeriesOverlay as a3, type SeriesOverlayKind as a4, type SeriesStyle as a5, type SeriesType as a6, type ShadowStyle as a7, TIME_INTERVALS as a8, type TextParams as a9, type Threshold as aa, type ThresholdLabelConfig as ab, type ThresholdLabelPosition as ac, TimeScale as ad, type TimeScaleConfig as ae, type TimeSeries as af, getHatch as ag, type AggregationConfig as b, type AggregationMode as c, type Annotation as d, type AnnotationBandConfig as e, type AnnotationBandItem as f, type AnySeries as g, type AxisOrientation as h, type AxisPosition as i, type BandScaleConfig as j, type DataPoint as k, type DataPointRef as l, type DomainScaleConfig as m, type DrawCircle as n, type DrawCommand as o, type DrawGap as p, type DrawGapType_t as q, type DrawGradient as r, type DrawGroup as s, type DrawLine as t, type DrawPath as u, type DrawRect as v, type DrawText as w, type FillDirectionType as x, type FillRegion as y, type FillSide as z };

package/package.json

@@ -1,85 +1,70 @@
 {
-    "name": "ml-time-graph",
-    "version": "1.0.0",
-    "description": "TypeScript library for time-series chart rendering — DOM-free SVG output (works in the browser and on the server).",
-    "type": "module",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "sideEffects": false,
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./internals": {
-            "types": "./dist/internals.d.ts",
-            "import": "./dist/internals.js"
-        },
-        "./analyze": {
-            "types": "./dist/analyze/index.d.ts",
-            "import": "./dist/analyze/index.js"
-        },
-        "./interaction": {
-            "types": "./dist/interaction/index.d.ts",
-            "import": "./dist/interaction/index.js"
-        }
+  "name": "ml-time-graph",
+  "version": "1.0.2",
+  "description": "TypeScript library for time-series chart rendering — DOM-free SVG output (works in the browser and on the server).",
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
-    "files": [
-        "dist",
-        "README.md",
-        "README.de.md",
-        "USAGE.md",
-        "MKT_AGGREGATE.md",
-        "LICENSE"
-    ],
-    "scripts": {
-        "dev": "vite demos",
-        "build": "tsup",
-        "build:demos": "tsc -p tsconfig.demos.json",
-        "test": "vitest",
-        "test:coverage": "vitest run --coverage",
-        "typecheck": "tsc --noEmit",
-        "typecheck:demos": "tsc -p tsconfig.demos.json",
-        "lint": "eslint .",
-        "prepublishOnly": "tsup"
+    "./internals": {
+      "types": "./dist/internals.d.ts",
+      "import": "./dist/internals.js"
     },
-    "keywords": [
-        "chart",
-        "time-series",
-        "typescript",
-        "svg",
-        "renderer",
-        "ssr",
-        "sensor",
-        "monitoring",
-        "incident-analysis",
-        "mkt"
-    ],
-    "author": "Michael Lechner",
-    "license": "SEE LICENSE IN LICENSE",
-    "homepage": "https://github.com/mlc0911/mlctimegraph",
-    "repository": {
-        "type": "git",
-        "url": "git+https://gitlab.com/mlc0911/mlctimegraph.git"
+    "./analyze": {
+      "types": "./dist/analyze/index.d.ts",
+      "import": "./dist/analyze/index.js"
     },
-    "bugs": {
-        "url": "https://gitlab.com/mlc0911/mlctimegraph/-/issues"
-    },
-    "engines": {
-        "node": ">=18"
-    },
-    "devDependencies": {
-        "@eslint/js": "^10.0.1",
-        "@typescript-eslint/eslint-plugin": "^8.60.0",
-        "@typescript-eslint/parser": "^8.60.0",
-        "@vitest/coverage-v8": "^4.1.6",
-        "eslint": "^10.4.0",
-        "globals": "^17.6.0",
-        "jiti": "^2.7.0",
-        "tsup": "^8.5.1",
-        "typescript": "^6.0.3",
-        "typescript-eslint": "^8.60.0",
-        "vite": "^8.0.13",
-        "vitest": "^4.1.6"
+    "./interaction": {
+      "types": "./dist/interaction/index.d.ts",
+      "import": "./dist/interaction/index.js"
     }
-}
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md",
+    "README.de.md",
+    "USAGE.md",
+    "API_DESIGN.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "chart",
+    "time-series",
+    "typescript",
+    "svg",
+    "renderer",
+    "ssr",
+    "sensor",
+    "monitoring",
+    "incident-analysis",
+    "mkt"
+  ],
+  "devDependencies": {
+    "ml-time-analyze": "0.1.0"
+  },
+  "author": "Michael Lechner",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://github.com/mlc0911/mlctimegraph",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/mlc0911/mlctimegraph.git",
+    "directory": "packages/ml-time-graph"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/mlc0911/mlctimegraph/-/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/dist/aggregated_subtypes-DZNZyFTX.d.ts

@@ -1,43 +0,0 @@
-import { A as AggregatedPoint } from './scale-Cbr0KpPz.js';
-
-/*!
- * MLTimeGraph — Copyright (c) 2026 Michael Lechner
- * MIT with Attribution: free use incl. commercial requires visible credit to
- * "Michael Lechner". Commercial license (no attribution) on request. See LICENSE.
- */
-
-/** Slot carrying a rolling Mean Kinetic Temperature value (USP <1079.2>). */
-interface MktPoint extends AggregatedPoint {
-    /** Mean kinetic temperature for this slot. `null` = gap. */
-    mkt: number | null;
-    /** Delta vs the previous slot's MKT (optional). */
-    deltaMkt?: number | null;
-}
-/** Slot carrying the standard deviation of the samples in the window. */
-interface StdDevPoint extends AggregatedPoint {
-    /** Standard deviation of the samples in this slot. `null` = gap. */
-    stdDev: number | null;
-}
-/**
- * Slot carrying minutes-above-/below-limit statistics. At least one of
- * `minutesAboveHigh` or `minutesBelowLow` must be set.
- */
-interface LimitStatsPoint extends AggregatedPoint {
-    /** Minutes above the upper limit in this slot. */
-    minutesAboveHigh?: number | null;
-    /** Minutes below the lower limit in this slot. */
-    minutesBelowLow?: number | null;
-}
-/**
- * The "full-stats" aggregated slot — combines all three specialised
- * subtypes via intersection. This is what `aggregateBySlot(data, mode,
- * thresholds)` returns when thresholds are provided: per-slot MKT (USP
- * <1079.2>), standard deviation, and out-of-bounds minute counters.
- *
- * Prefer this typed alias over plain `AggregatedPoint` whenever you
- * downstream-consume `aggregateBySlot`'s output and want guaranteed access
- * to the stat fields.
- */
-type StatsAggregatedPoint = MktPoint & StdDevPoint & LimitStatsPoint;
-
-export type { LimitStatsPoint as L, MktPoint as M, StatsAggregatedPoint as S, StdDevPoint as a };