@tradecanvas/core 1.20.0 → 1.22.0

package/README.md

@@ -34,7 +34,7 @@ Two stacked canvases — a hover repaints only the thin top one:
 
 Data transforms: `toHeikinAshi`, `toRenko`, `toLineBreak`, `toKagi`, `toPointAndFigure`, `toRangeBars`
 
-### Indicators (111 built-in)
+### Indicators (133 built-in)
 
 Moving averages, bands and channels, trend and stops, VWAPs and profiles on the price pane; oscillators, volume and volatility indicators in panes of their own. Every id with its inputs, lines and levels is in the [indicator catalog](https://bonguynvan.github.io/tradecanvas/docs/indicators). Four more read a second symbol's bars (`compareSymbol`, `spread`, `correlation`, `correlationlog`); `@tradecanvas/chart`'s `Chart` registers them with its symbol store.
 

package/dist/finance/BarChartRenderer.d.ts

@@ -0,0 +1,39 @@
+import { BarChartOptions, Theme } from '@tradecanvas/commons';
+import { LegendLayout, Measure, NiceScale, Rect } from './chartKit.js';
+export interface BarRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    category: string;
+    series: string;
+    value: number;
+    /** The category's index. */
+    index: number;
+    color: string;
+}
+export interface BarLayout {
+    plot: Rect;
+    scale: NiceScale;
+    orientation: 'vertical' | 'horizontal';
+    /** The zero line: a y for vertical bars, an x for horizontal ones. */
+    zero: number;
+    /** Bars series by series, each in category order. */
+    bars: BarRect[];
+    /** Where each category's band starts along the category axis, and how long it is. */
+    bandStart: number;
+    band: number;
+    legend: LegendLayout | null;
+    legendY: number;
+}
+/** Where the bars go, for a chart `width` × `height`. */
+export declare function computeBarLayout(options: BarChartOptions, width: number, height: number, theme: Theme, measure: Measure): BarLayout;
+/** The bar under (x, y); a bar at least a few pixels thick, so a thin one can be found. */
+export declare function hitBar(layout: BarLayout, x: number, y: number): BarRect | null;
+/** The category whose band holds (x, y) inside the plot; -1 outside it. */
+export declare function hitCategory(layout: BarLayout, x: number, y: number, count: number): number;
+export declare function renderBarChart(ctx: CanvasRenderingContext2D, width: number, height: number, options: BarChartOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: BarLayout): BarLayout;
+//# sourceMappingURL=BarChartRenderer.d.ts.map

package/dist/finance/BarChartRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarChartRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/BarChartRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAcL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,EAEV,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC;IACvC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAwCD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,CA0DnI;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAM9E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,SAAsF,GAC7F,SAAS,CAiDX"}

package/dist/finance/BaseFinanceChart.d.ts

@@ -13,6 +13,8 @@ export declare abstract class BaseFinanceChart {
     private updateSize;
     requestRender(): void;
     protected abstract renderChart(ctx: CanvasRenderingContext2D, width: number, height: number, theme: Theme): void;
+    /** What the chart shows, for screen readers (the canvas's aria-label). */
+    setLabel(label: string): void;
     setTheme(theme: ThemeName | Theme): void;
     destroy(): void;
 }

package/dist/finance/BaseFinanceChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseFinanceChart.d.ts","sourceRoot":"","sources":["../../src/finance/BaseFinanceChart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAS7D,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,wBAAwB,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IACjC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IACvB,SAAS,CAAC,KAAK,SAAK;IACpB,SAAS,CAAC,MAAM,SAAK;IACrB,SAAS,CAAC,GAAG,SAAK;IAClB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK;IAqB7D,OAAO,CAAC,UAAU;IASlB,aAAa,IAAI,IAAI;IAiBrB,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GACX,IAAI;IAEP,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI;IAKxC,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"BaseFinanceChart.d.ts","sourceRoot":"","sources":["../../src/finance/BaseFinanceChart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAS7D,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,wBAAwB,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IACjC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IACvB,SAAS,CAAC,KAAK,SAAK;IACpB,SAAS,CAAC,MAAM,SAAK;IACrB,SAAS,CAAC,GAAG,SAAK;IAClB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK;IAuB7D,OAAO,CAAC,UAAU;IASlB,aAAa,IAAI,IAAI;IAiBrB,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GACX,IAAI;IAEP,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI;IAKxC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/finance/CalendarRenderer.d.ts

@@ -0,0 +1,53 @@
+import { CalendarChartOptions, CalendarDay, Theme } from '@tradecanvas/commons';
+import { Measure, Rect } from './chartKit.js';
+import { ResolvedScale } from './colorScale.js';
+/** Calendar years shown at most: a longer range keeps its last ones. */
+export declare const MAX_CALENDAR_YEARS = 10;
+/** The day number (days since 1 January 1970) of a `YYYY-MM-DD` date, or null if it isn't one. */
+export declare function parseDay(date: string): number | null;
+export declare function dayToIso(day: number): string;
+export interface CalendarCell {
+    x: number;
+    y: number;
+    size: number;
+    date: string;
+    /** The data for the day, if there is any. */
+    day?: CalendarDay;
+    color: string | null;
+}
+export interface CalendarLayout {
+    cells: CalendarCell[];
+    months: {
+        label: string;
+        x: number;
+        y: number;
+    }[];
+    weekdays: {
+        label: string;
+        x: number;
+        y: number;
+    }[];
+    years: {
+        label: string;
+        x: number;
+        y: number;
+    }[];
+    scale: ResolvedScale;
+    /** Where the colour bar goes; null without one. */
+    bar: Rect | null;
+    pitch: number;
+    /** How a day reads in the tooltip. */
+    formatDate: (date: string) => string;
+}
+/**
+ * Days in week columns and weekday rows, a calendar year to a band, for a
+ * chart `width` × `height`; the cells stay square and no larger than 28 px.
+ */
+export declare function computeCalendarLayout(options: CalendarChartOptions, width: number, height: number, theme: Theme, measure: Measure): CalendarLayout;
+/** The day under the pointer. */
+export declare function hitDay(layout: CalendarLayout, x: number, y: number): CalendarCell | null;
+export declare function renderCalendar(ctx: CanvasRenderingContext2D, width: number, height: number, options: CalendarChartOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: CalendarLayout): CalendarLayout;
+//# sourceMappingURL=CalendarRenderer.d.ts.map

package/dist/finance/CalendarRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalendarRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/CalendarRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAiE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAoB,MAAM,eAAe,CAAC;AACzI,OAAO,EAA+D,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGlH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AASrC,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAKD,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,KAAK,EAAE,aAAa,CAAC;IACrB,mDAAmD;IACnD,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAsED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAqFlJ;AAED,iCAAiC;AACjC,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKxF;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,cAAgG,GACvG,cAAc,CAiDhB"}

package/dist/finance/CounterClockRenderer.d.ts

@@ -0,0 +1,45 @@
+import { CounterClockOptions, CounterClockPoint, OHLCBar, Theme } from '@tradecanvas/commons';
+import { Measure, NiceScale, Rect } from './chartKit.js';
+/** Points drawn at most. */
+export declare const MAX_CLOCK_POINTS = 2000;
+/**
+ * Average volume and average close over each run of `period` bars, one point
+ * per bar from the first full run: the path a counter-clock chart draws.
+ * `last` keeps only the newest points. Each run is summed afresh, so equal
+ * closes give equal averages, with no rounding drift between them.
+ */
+export declare function counterClockPoints(data: readonly OHLCBar[], period: number, last?: number): CounterClockPoint[];
+/**
+ * The direction of the last move, as one of eight phases counter-clockwise
+ * from volume rising at a steady price: 1 volume up, 2 both up, 3 price up,
+ * 4 price up on falling volume, 5 volume down, 6 both down, 7 price down,
+ * 8 price down on rising volume. Moves are read against the points' ranges,
+ * so a phase doesn't depend on the units. Null without a move.
+ */
+export declare function counterClockPhase(points: readonly CounterClockPoint[]): number | null;
+export interface PlacedClockPoint {
+    px: number;
+    py: number;
+    alpha: number;
+    point: CounterClockPoint;
+}
+export interface CounterClockLayout {
+    plot: Rect;
+    xScale: NiceScale;
+    yScale: NiceScale;
+    points: PlacedClockPoint[];
+    /** The newest move's phase, 1–8, or null. */
+    phase: number | null;
+    color: string;
+}
+/** The plot and the newest points' places, for a chart `width` × `height`. */
+export declare function computeCounterClockLayout(options: CounterClockOptions, width: number, height: number, _theme: Theme, measure: Measure): CounterClockLayout;
+/** How many of the newest points a chart shows: `points`, 2 to MAX_CLOCK_POINTS. */
+export declare function shownCount(options: Pick<CounterClockOptions, 'points'>): number;
+/** The point nearest the pointer, within reach; the newest wins a tie. */
+export declare function nearestCounterClockPoint(layout: CounterClockLayout, x: number, y: number): PlacedClockPoint | null;
+export declare function renderCounterClock(ctx: CanvasRenderingContext2D, width: number, height: number, options: CounterClockOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: CounterClockLayout): CounterClockLayout;
+//# sourceMappingURL=CounterClockRenderer.d.ts.map

package/dist/finance/CounterClockRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CounterClockRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/CounterClockRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEnG,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AASvB,4BAA4B;AAC5B,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAIrC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAW,GAAG,iBAAiB,EAAE,CAcjH;AAKD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAmBrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,kBAAkB,CAiC1J;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG,MAAM,CAG/E;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAYlH;AAID,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,kBAAwG,GAC/G,kBAAkB,CAuDpB"}

package/dist/finance/DonutRenderer.d.ts

@@ -0,0 +1,33 @@
+import { DonutChartOptions, DonutSlice, Theme } from '@tradecanvas/commons';
+import { LegendLayout, Measure } from './chartKit.js';
+export interface SliceArc {
+    label: string;
+    value: number;
+    /** Its part of the whole, 0–1. */
+    share: number;
+    /** Angles in radians, clockwise from three o'clock; the first starts at twelve. */
+    start: number;
+    end: number;
+    color: string;
+    slice: DonutSlice;
+}
+export interface DonutLayout {
+    cx: number;
+    cy: number;
+    radius: number;
+    inner: number;
+    total: number;
+    slices: SliceArc[];
+    legend: LegendLayout | null;
+    legendX: number;
+    legendY: number;
+}
+/** The ring and its slices, for a chart `width` × `height`. */
+export declare function computeDonutLayout(options: DonutChartOptions, width: number, height: number, _theme: Theme, measure: Measure): DonutLayout;
+/** The slice under (x, y): on the ring, not in the hole or outside. */
+export declare function hitSlice(layout: DonutLayout, x: number, y: number): SliceArc | null;
+export declare function renderDonut(ctx: CanvasRenderingContext2D, width: number, height: number, options: DonutChartOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: DonutLayout): DonutLayout;
+//# sourceMappingURL=DonutRenderer.d.ts.map

package/dist/finance/DonutRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DonutRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/DonutRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAUL,KAAK,YAAY,EACjB,KAAK,OAAO,EACb,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAqC1I;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQnF;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,WAA0F,GACjG,WAAW,CAuCb"}

package/dist/finance/HeatmapLayout.d.ts

@@ -20,5 +20,36 @@ export declare function layoutSquarifiedTreemap(cells: readonly {
     id: string;
     weight: number;
 }[], bounds: Bounds, padding: number): LayoutRect[];
+export interface GroupRect {
+    name: string;
+    /** The group's whole tile, its name strip included. */
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** The height of the name strip at the top of `rect`, px: 0 where it doesn't fit. */
+    header: number;
+    /** The cells' values averaged by weight. */
+    value: number;
+    count: number;
+}
+/** The strip a group's name takes at the top of its tile, px. */
+export declare const GROUP_HEADER = 18;
+/**
+ * Groups as tiles sized by their cells' weights, and each group's cells
+ * squarified inside its tile, under a `header`-px strip for the group's name
+ * where the tile is tall enough. Cells with no group make one named ''.
+ */
+export declare function layoutGroupedTreemap(cells: readonly {
+    id: string;
+    weight: number;
+    group?: string;
+    value: number;
+}[], bounds: Bounds, padding: number, header?: number): {
+    groups: GroupRect[];
+    cells: LayoutRect[];
+};
 export {};
 //# sourceMappingURL=HeatmapLayout.d.ts.map

package/dist/finance/HeatmapLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeatmapLayout.d.ts","sourceRoot":"","sources":["../../src/finance/HeatmapLayout.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,UAAU,MAAM;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CA0Bd;AAyHD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EAChD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAcd"}
+{"version":3,"file":"HeatmapLayout.d.ts","sourceRoot":"","sources":["../../src/finance/HeatmapLayout.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,UAAU,MAAM;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CA0Bd;AAyHD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EAChD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAcd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,iEAAiE;AACjE,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAC/E,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,SAAe,GACpB;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAkC9C"}

package/dist/finance/HeatmapRenderer.d.ts

@@ -1,5 +1,5 @@
 import { HeatmapCell, HeatmapOptions, Theme } from '@tradecanvas/commons';
-import { LayoutRect } from './HeatmapLayout.js';
+import { GroupRect, LayoutRect } from './HeatmapLayout.js';
 export interface HeatmapHitResult {
     cell: HeatmapCell;
     rect: LayoutRect;
@@ -7,5 +7,5 @@ export interface HeatmapHitResult {
 export declare function renderHeatmap(ctx: CanvasRenderingContext2D, width: number, height: number, cells: readonly HeatmapCell[], layoutRects: readonly LayoutRect[], options: HeatmapOptions, theme: Theme, crosshairPos: {
     x: number;
     y: number;
-} | null): HeatmapHitResult | null;
+} | null, groups?: readonly GroupRect[]): HeatmapHitResult | null;
 //# sourceMappingURL=HeatmapRenderer.d.ts.map

package/dist/finance/HeatmapRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeatmapRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/HeatmapRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmDrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;CAClB;AA4FD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC5C,gBAAgB,GAAG,IAAI,CAqEzB"}
+{"version":3,"file":"HeatmapRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/HeatmapRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAoDhE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;CAClB;AA4FD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC7C,MAAM,GAAE,SAAS,SAAS,EAAO,GAChC,gBAAgB,GAAG,IAAI,CA6EzB"}

package/dist/finance/HistogramRenderer.d.ts

@@ -0,0 +1,37 @@
+import { HistogramBin, HistogramOptions, Theme } from '@tradecanvas/commons';
+import { Measure, NiceScale, Rect } from './chartKit.js';
+/** No more bins than this, whatever the options ask: more can't be seen, and could run out of memory. */
+export declare const MAX_BINS = 1000;
+/**
+ * Values counted into equal bins: `bins` of them over the values' range, a
+ * `binWidth` on a grid from 0, or Sturges' count (`ceil(log2 n) + 1`).
+ * Each bin holds `from` up to `to`; the last one holds `to` too.
+ */
+export declare function histogramBins(values: readonly number[], options?: {
+    bins?: number | 'auto';
+    binWidth?: number;
+}): HistogramBin[];
+export interface HistogramBar {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    bin: HistogramBin;
+    color: string;
+}
+export interface HistogramLayout {
+    plot: Rect;
+    xScale: NiceScale;
+    yScale: NiceScale;
+    bars: HistogramBar[];
+    total: number;
+}
+/** The bins' bars on a value axis, for a chart `width` × `height`. */
+export declare function computeHistogramLayout(options: HistogramOptions, width: number, height: number, theme: Theme, measure: Measure): HistogramLayout;
+/** The bar whose bin holds the pointer's x, inside the plot. */
+export declare function hitHistogramBar(layout: HistogramLayout, x: number, y: number): HistogramBar | null;
+export declare function renderHistogram(ctx: CanvasRenderingContext2D, width: number, height: number, options: HistogramOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: HistogramLayout): HistogramLayout;
+//# sourceMappingURL=HistogramRenderer.d.ts.map

package/dist/finance/HistogramRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistogramRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/HistogramRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElF,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAIvB,yGAAyG;AACzG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAO7B;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,EAAE,CAwCpI;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAyBhJ;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIlG;AAID,wBAAgB,eAAe,CAC7B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,eAAkG,GACzG,eAAe,CA0BjB"}

package/dist/finance/MatrixRenderer.d.ts

@@ -0,0 +1,56 @@
+import { MatrixCell, MatrixChartOptions, Theme } from '@tradecanvas/commons';
+import { Measure, Rect } from './chartKit.js';
+import { ResolvedScale } from './colorScale.js';
+/** Rows and columns past this many are left out: their cells would be under a pixel. */
+export declare const MAX_MATRIX_SIZE = 200;
+/**
+ * Pearson correlations between series, `[i][j]` for series i and j: pass
+ * returns (day-on-day changes), not prices. Each pair uses the positions
+ * where both have a finite value; fewer than three, or a series that never
+ * moves, gives NaN. It runs on the calling thread: 200 series of 1,000
+ * values take some tens of milliseconds. Colour the result with
+ * `colorScale: { min: -1, max: 1 }`, so 0.5 doesn't look like 1.
+ */
+export declare function correlationMatrix(series: readonly (readonly number[])[]): number[][];
+export interface MatrixCellRect {
+    x: number;
+    y: number;
+    size: number;
+    cell: MatrixCell;
+    color: string;
+    /** The value printed in the cell, when it fits. */
+    text: string | null;
+    textColor: string;
+}
+export interface MatrixLayout {
+    cells: MatrixCellRect[];
+    rowLabels: {
+        text: string;
+        index: number;
+        x: number;
+        y: number;
+    }[];
+    columnLabels: {
+        text: string;
+        index: number;
+        x: number;
+        y: number;
+        rotated: boolean;
+    }[];
+    /** The whole grid, every row and column, empty cells included. */
+    grid: Rect;
+    pitch: number;
+    scale: ResolvedScale;
+    bar: Rect | null;
+    /** The cell at `[row][column]`, if one is drawn there. */
+    at: (MatrixCellRect | undefined)[][];
+}
+/** Square cells in rows and columns, named along the left and the top, for a chart `width` × `height`. */
+export declare function computeMatrixLayout(options: MatrixChartOptions, width: number, height: number, theme: Theme, measure: Measure): MatrixLayout;
+/** The cell under the pointer, if one is drawn there. */
+export declare function hitMatrixCell(layout: MatrixLayout, x: number, y: number): MatrixCellRect | null;
+export declare function renderMatrix(ctx: CanvasRenderingContext2D, width: number, height: number, options: MatrixChartOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: MatrixLayout): MatrixLayout;
+//# sourceMappingURL=MatrixRenderer.d.ts.map

package/dist/finance/MatrixRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/MatrixRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAA2D,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AACjH,OAAO,EAA6E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhI,wFAAwF;AACxF,eAAO,MAAM,eAAe,MAAM,CAAC;AAQnC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,CAWpF;AAiCD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACxF,kEAAkE;IAClE,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,0DAA0D;IAC1D,EAAE,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;CACtC;AASD,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CA6E5I;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAI/F;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,YAA4F,GACnG,YAAY,CA4Dd"}

package/dist/finance/ScatterRenderer.d.ts

@@ -0,0 +1,32 @@
+import { ScatterChartOptions, ScatterPoint, Theme } from '@tradecanvas/commons';
+import { LegendLayout, Measure, NiceScale, Rect } from './chartKit.js';
+export interface PlacedPoint {
+    px: number;
+    py: number;
+    r: number;
+    color: string;
+    /** Its fill, and its fill while hovered (worked out once, not each frame). */
+    fill: string;
+    hoverFill: string;
+    series: string;
+    label?: string;
+    point: ScatterPoint;
+}
+export interface ScatterLayout {
+    plot: Rect;
+    xScale: NiceScale;
+    yScale: NiceScale;
+    points: PlacedPoint[];
+    /** Indexes into `points`, largest bubble first: small ones are drawn on top. */
+    drawOrder: number[];
+    legend: LegendLayout | null;
+}
+/** The plot and every point's place, for a chart `width` × `height`. */
+export declare function computeScatterLayout(options: ScatterChartOptions, width: number, height: number, _theme: Theme, measure: Measure): ScatterLayout;
+/** The point nearest (x, y) within reach of its edge; null when none is. */
+export declare function nearestPoint(layout: ScatterLayout, x: number, y: number): PlacedPoint | null;
+export declare function renderScatter(ctx: CanvasRenderingContext2D, width: number, height: number, options: ScatterChartOptions, theme: Theme, pointer: {
+    x: number;
+    y: number;
+} | null, layout?: ScatterLayout): ScatterLayout;
+//# sourceMappingURL=ScatterRenderer.d.ts.map

package/dist/finance/ScatterRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterRenderer.d.ts","sourceRoot":"","sources":["../../src/finance/ScatterRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAaL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,EAEV,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gFAAgF;IAChF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAUD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAmEhJ;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAW5F;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACxC,MAAM,GAAE,aAA8F,GACrG,aAAa,CAkDf"}

package/dist/finance/chartKit.d.ts

@@ -0,0 +1,67 @@
+import { Theme } from '@tradecanvas/commons';
+/** How wide `text` is at a font size, px (the canvas's measureText, or a stand-in in tests). */
+export type Measure = (text: string, size?: number) => number;
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface NiceScale {
+    min: number;
+    max: number;
+    step: number;
+    ticks: number[];
+}
+/** Room for a label's text around it, px. */
+export declare const LABEL_SIZE = 11;
+/**
+ * A scale over `min`–`max` in whole steps of 1, 2, 2.5 or 5 times a power
+ * of ten, about `maxTicks` of them; a range of one value is opened up around it.
+ */
+export declare function niceScale(min: number, max: number, maxTicks?: number): NiceScale;
+/** Where `value` falls along a span of pixels, `start` at the scale's min (or max when `inverted`). */
+export declare function scaleToPx(scale: NiceScale, value: number, start: number, length: number, inverted?: boolean): number;
+/** Numbers as people read them: 1,234.5, and 12.3K past ten thousand. */
+export declare function defaultFormat(value: number): string;
+/**
+ * How a scale's ticks read: as many decimals as its step needs, and 20K or
+ * 1.5M when that keeps every tick apart.
+ */
+export declare function axisFormat(scale: NiceScale): (value: number) => string;
+/** A series' colour: its own, else the palette's in turn. */
+export declare function seriesColor(index: number, color?: string): string;
+export declare function fontOf(theme: Theme, size: number, weight?: string): string;
+/** A Measure from a canvas, in the theme's font. */
+export declare function canvasMeasure(ctx: CanvasRenderingContext2D, theme: Theme): Measure;
+export interface LegendItem {
+    label: string;
+    color: string;
+}
+export interface LegendLayout {
+    items: (LegendItem & {
+        x: number;
+        y: number;
+    })[];
+    rows: number;
+    height: number;
+}
+/** Legend entries in rows that fit `maxWidth`, from (0, 0); `column`: one entry a row. */
+export declare function layoutLegend(items: readonly LegendItem[], maxWidth: number, measure: Measure, column?: boolean): LegendLayout;
+export declare function drawLegend(ctx: CanvasRenderingContext2D, layout: LegendLayout, ox: number, oy: number, theme: Theme): void;
+export interface TooltipLine {
+    text: string;
+    /** A swatch before the text. */
+    color?: string;
+    bold?: boolean;
+}
+/** A box of lines by the pointer, kept inside `bounds`. */
+export declare function drawTooltip(ctx: CanvasRenderingContext2D, lines: readonly TooltipLine[], anchor: {
+    x: number;
+    y: number;
+}, bounds: Rect, theme: Theme): void;
+/** Grid lines and labels of a value scale along one side of the plot. */
+export declare function drawValueAxis(ctx: CanvasRenderingContext2D, plot: Rect, scale: NiceScale, orientation: 'vertical' | 'horizontal', theme: Theme, format: (value: number) => string): void;
+/** `text` cut with an ellipsis to fit `width`. */
+export declare function fitText(text: string, width: number, measure: Measure, size?: number): string;
+//# sourceMappingURL=chartKit.d.ts.map

package/dist/finance/chartKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartKit.d.ts","sourceRoot":"","sources":["../../src/finance/chartKit.ts"],"names":[],"mappings":"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"}

package/dist/finance/colorScale.d.ts

@@ -0,0 +1,25 @@
+import { ColorScale, Theme } from '@tradecanvas/commons';
+import { Rect } from './chartKit.js';
+/** A colour scale with its range worked out. */
+export interface ResolvedScale {
+    negative: string;
+    zero: string;
+    positive: string;
+    min: number;
+    max: number;
+}
+/** Room under a chart for its colour bar and the bar's labels, px. */
+export declare const COLOR_BAR_ROOM = 28;
+/**
+ * The scale a chart colours by: the one given, its range filled in from the
+ * values (either side of zero evenly when any is negative, else from zero up),
+ * and the theme's down and up colours by default.
+ */
+export declare function resolveColorScale(values: Iterable<number>, theme: Theme, scale?: ColorScale): ResolvedScale;
+/** The colour of `value`: the zero colour at 0, the end colours at the range's ends and past them. */
+export declare function scaleColor(value: number, scale: ResolvedScale): string;
+/** Near-white or near-black, whichever contrasts more with `color`. */
+export declare function readableText(color: string): string;
+/** The scale as a bar from its min to its max, the ends (and zero, inside them) labelled below. */
+export declare function drawColorBar(ctx: CanvasRenderingContext2D, area: Rect, scale: ResolvedScale, format: (v: number) => string, theme: Theme): void;
+//# sourceMappingURL=colorScale.d.ts.map

package/dist/finance/colorScale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorScale.d.ts","sourceRoot":"","sources":["../../src/finance/colorScale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE9D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,KAAK,CAAC;AAyCjC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,aAAa,CAsB3G;AAED,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAItE;AAMD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CA0B/I"}

package/dist/finance/index.d.ts

@@ -3,10 +3,28 @@ export { FinanceCrosshair } from './FinanceCrosshair.js';
 export { renderSparkline } from './SparklineRenderer.js';
 export { renderDepthChart } from './DepthChartRenderer.js';
 export { renderEquityCurve } from './EquityCurveRenderer.js';
-export { layoutUniformGrid, layoutSquarifiedTreemap } from './HeatmapLayout.js';
-export type { LayoutRect } from './HeatmapLayout.js';
+export { layoutUniformGrid, layoutSquarifiedTreemap, layoutGroupedTreemap, GROUP_HEADER } from './HeatmapLayout.js';
+export type { LayoutRect, GroupRect } from './HeatmapLayout.js';
 export { renderHeatmap } from './HeatmapRenderer.js';
 export type { HeatmapHitResult } from './HeatmapRenderer.js';
 export { renderWaterfall } from './WaterfallRenderer.js';
 export { renderGauge } from './GaugeRenderer.js';
+export { niceScale, layoutLegend, defaultFormat, axisFormat, canvasMeasure } from './chartKit.js';
+export type { NiceScale, LegendLayout, Measure } from './chartKit.js';
+export { renderBarChart, computeBarLayout, hitBar, hitCategory } from './BarChartRenderer.js';
+export type { BarLayout, BarRect } from './BarChartRenderer.js';
+export { renderDonut, computeDonutLayout, hitSlice } from './DonutRenderer.js';
+export type { DonutLayout, SliceArc } from './DonutRenderer.js';
+export { renderScatter, computeScatterLayout, nearestPoint } from './ScatterRenderer.js';
+export type { ScatterLayout, PlacedPoint } from './ScatterRenderer.js';
+export { renderHistogram, computeHistogramLayout, hitHistogramBar, histogramBins } from './HistogramRenderer.js';
+export type { HistogramLayout, HistogramBar } from './HistogramRenderer.js';
+export { resolveColorScale, scaleColor, readableText } from './colorScale.js';
+export type { ResolvedScale } from './colorScale.js';
+export { renderCalendar, computeCalendarLayout, hitDay, parseDay, dayToIso } from './CalendarRenderer.js';
+export type { CalendarLayout, CalendarCell } from './CalendarRenderer.js';
+export { renderMatrix, computeMatrixLayout, hitMatrixCell, correlationMatrix } from './MatrixRenderer.js';
+export type { MatrixLayout, MatrixCellRect } from './MatrixRenderer.js';
+export { renderCounterClock, computeCounterClockLayout, nearestCounterClockPoint, counterClockPoints, counterClockPhase, shownCount } from './CounterClockRenderer.js';
+export type { CounterClockLayout, PlacedClockPoint } from './CounterClockRenderer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/finance/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/finance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/finance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpH,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClG,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9F,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACjH,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC1G,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1G,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvK,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}