@alphacharts/core 0.1.0 → 0.1.1

package/dist/internal.js

@@ -1 +1,7 @@
-export { o as GLContext, s as GLSL_COMMON, t as HOLE_TEST, n as InstanceWindow, r as RECORD_BYTES, i as RECORD_FLOATS, a as chooseLevel } from "./window-uK2QNvv5.js";
+import { E as e, a as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./window-WvcPCDkK.js";
+//#region src/version.ts
+var c = "0.1.1";
+//#endregion
+export { c as CORE_VERSION, i as GLContext, o as GLSL_COMMON, s as HOLE_TEST, r as InstanceWindow, a as RECORD_BYTES, n as RECORD_FLOATS, t as chooseLevel, e as onFault };
+
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":["onFault","chooseLevel","RECORD_FLOATS","InstanceWindow","GLContext","RECORD_BYTES","GLSL_COMMON","HOLE_TEST","CORE_VERSION"],"sources":["../src/version.ts"],"sourcesContent":["// Kept equal to package.json by test/fault.test.ts. Read by @alphacharts/report through /internal.\nexport const CORE_VERSION = \"0.1.1\";\n"],"mappings":";;AACA,IAAaQ,IAAe"}

package/dist/types/chart/primitives.d.ts

@@ -94,3 +94,26 @@ export declare class PriceLine implements PanePrimitive {
     draw(ctx: CanvasRenderingContext2D, view: PaneView): void;
     axisLabels(view: PaneView): readonly AxisLabel[];
 }
+/**
+ * A background colour per bar, drawn behind the series of the pane it is attached to (`Series.attachPrimitive`).
+ * It takes no part in autoscale (a primitive never does) and costs nothing while no bar is shaded. Colours are
+ * keyed by bar time (UTC ms), so they stay with their bars when the timeline is re-indexed; a time with no bar on
+ * the chart draws nothing. Runs of equal colour on neighbouring bars are painted as one rectangle.
+ */
+export declare class BarShading implements PanePrimitive {
+    private host;
+    private times;
+    private colors;
+    private n;
+    private shown;
+    private any;
+    /** Replace every shade: strictly increasing times, packed 0xRRGGBBAA colours (0 = no shade). */
+    set(time: Float64Array, color: Uint32Array): void;
+    /** Shade one bar: replaces the colour at `time` when the bar is known, else appends (a time later than the last). */
+    setAt(time: number, color: number): void;
+    clear(): void;
+    setVisible(visible: boolean): void;
+    attached(host: PrimitiveHost): void;
+    detached(): void;
+    drawBackground(ctx: CanvasRenderingContext2D, view: PaneView): void;
+}

package/dist/types/chart/series.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnarOhlc, ColumnarValue, OhlcBar, SeriesData, ValuePoint } from "../data/model.js";
+import type { ColumnarColors, ColumnarOhlc, ColumnarValue, OhlcBar, SeriesData, ValuePoint } from "../data/model.js";
 import { type SeriesMarker } from "./markers.js";
 import type { PanePrimitive } from "./primitives.js";
 import { type CommonSeriesOptions, type SeriesOptions, type SeriesShapes, type SeriesType } from "./series-types.js";
@@ -11,6 +11,8 @@ export interface SeriesHost {
     setData(s: Series<SeriesType>, input: unknown): void;
     prepend(s: Series<SeriesType>, input: unknown): void;
     update(s: Series<SeriesType>, bar: unknown): void;
+    setColors(s: Series<SeriesType>, colors: ColumnarColors): void;
+    clearColors(s: Series<SeriesType>): void;
     optionsChanged(s: Series<SeriesType>, paneOrScaleMoved: boolean): void;
     markersChanged(s: Series<SeriesType>): void;
     /** Pane-relative y of a price on the series' scale; NaN when the scale has no range yet. */
@@ -39,6 +41,14 @@ export declare class Series<T extends SeriesType> {
     prepend(data: SeriesInput<T>): void;
     /** Live bar: same time as the last bar replaces it, a later time appends. */
     update(bar: SeriesBar<T>): void;
+    /**
+     * Colour individual bars of a candle or OHLC-bar series (`colors.color`: packed 0xRRGGBBAA, 0 = the series' own up/down
+     * colours), by time; a time with no bar is ignored. Colours belong to (series, time): `update`, `prepend` and `setData`
+     * keep the colours of the bars they keep. Writing the colour a bar already has changes and redraws nothing.
+     */
+    setBarColors(this: Series<"candles" | "bars">, colors: ColumnarColors): void;
+    /** Remove every bar colour (the colour column too): the series draws in its up/down colours again. */
+    clearBarColors(this: Series<"candles" | "bars">): void;
     /** The bar at `time`, or undefined. Values are the exact inputs (Float64). */
     barAt(time: number): SeriesBar<T> | undefined;
     /** Index range of the series' bars on the chart's timeline. */

package/dist/types/data/deque.d.ts

@@ -8,7 +8,6 @@ export declare const F32_NAN: ColumnSpec;
 export declare const U32_ZERO: ColumnSpec;
 export declare const U8_ZERO: ColumnSpec;
 export declare class ColumnDeque {
-    private readonly specs;
     /** Raw buffers, one per column. Replaced on growth: never cache across a write. */
     cols: TypedArray[];
     /** Buffer position of `first`. */
@@ -17,7 +16,12 @@ export declare class ColumnDeque {
     first: number;
     length: number;
     private capacity;
+    private readonly specs;
     constructor(specs: readonly ColumnSpec[], capacity?: number);
+    /** Add a column over the current range, filled with its fill value. Existing columns and indices are untouched. */
+    addColumn(spec: ColumnSpec): number;
+    /** Drop the last column (the one `addColumn` returned last). */
+    dropColumn(): void;
     /** One past the last absolute index. */
     get end(): number;
     /** Buffer position of absolute index `abs` (not bounds-checked). */

package/dist/types/data/lod.d.ts

@@ -7,8 +7,13 @@ export interface LodSource {
     readonly h: number;
     readonly l: number;
     readonly c: number;
-    /** Column of a packed RGBA colour per row, if the series has one. */
-    readonly color?: number;
+    /** Column of a packed RGBA colour per row, if the series has one. Set when the column is added; the owner then rebuilds the pyramid. */
+    color?: number;
+    /**
+     * Which colour a bucket takes: "high" (default) that of the row that made its high; "any" the last non-zero colour of
+     * its rows, so a highlighted bar still shows when 8 or more bars share a pixel.
+     */
+    colorMode?: "high" | "any";
 }
 export declare const LOD_O = 0;
 export declare const LOD_H = 1;

package/dist/types/data/model.d.ts

@@ -9,6 +9,8 @@ export interface OhlcBar {
     high: number;
     low: number;
     close: number;
+    /** Per-bar colour override, CSS colour string; absent leaves the bar's colour as it is. */
+    color?: string;
 }
 export interface ValuePoint {
     time: number;
@@ -23,6 +25,14 @@ export interface ColumnarOhlc {
     high: Float64Array;
     low: Float64Array;
     close: Float64Array;
+    /** Packed 0xRRGGBBAA per bar; 0 means the series colours. Absent leaves the bars' colours as they are. */
+    color?: Uint32Array;
+}
+/** Colours alone for bars of an OHLC series, by time (times strictly increasing; a time the series has no bar at is ignored). */
+export interface ColumnarColors {
+    time: Float64Array;
+    /** Packed 0xRRGGBBAA; 0 clears the bar back to the series colours. */
+    color: Uint32Array;
 }
 export interface ColumnarValue {
     time: Float64Array;
@@ -34,7 +44,10 @@ export type OhlcInput = readonly OhlcBar[] | ColumnarOhlc;
 export type ValueInput = readonly ValuePoint[] | ColumnarValue;
 export declare const COL_O = 0, COL_H = 1, COL_L = 2, COL_C = 3;
 export declare const COL_V = 0, COL_COLOR = 1;
-export type ChangeKind = "replace" | "prepend" | "update";
+/** The optional colour column of an OHLC store, added by `SeriesData.enableColors`. */
+export declare const COL_BAR_COLOR = 4;
+/** "color": only bar colours changed (no bar, price or time did): data followers such as studies have nothing to recompute. */
+export type ChangeKind = "replace" | "prepend" | "update" | "color";
 export interface DataChange {
     readonly series: SeriesData | null;
     readonly kind: ChangeKind;
@@ -50,7 +63,19 @@ export declare class SeriesData {
     readonly shape: SeriesShape;
     readonly store: ColumnDeque;
     readonly lod: Lod;
+    private readonly lodSrc;
+    /**
+     * A value series: whether any point may carry its own colour (set when one is written, cleared when the series is
+     * replaced). Conservative: renderers that draw uncoloured series faster read it.
+     */
+    pointColors: boolean;
     constructor(shape: SeriesShape);
+    /** Whether an OHLC series holds a per-bar colour column. */
+    get colored(): boolean;
+    /** Add the colour column (all zero) and the pyramid's colour column. A no-op when present or for a value series. */
+    enableColors(): void;
+    /** Remove the colour column again, giving its memory back. */
+    disableColors(): void;
     /** True when the series has a bar at timeline index i. */
     has(i: number): boolean;
     /** Value of column `col` at timeline index i (NaN when absent). */
@@ -86,6 +111,14 @@ export declare class DataModel {
     prepend(s: SeriesData, input: OhlcInput | ValueInput): void;
     /** A live bar: replaces the series' last bar if the time matches, else appends. */
     update(s: SeriesData, input: OhlcBar | ValuePoint): void;
+    /**
+     * Write bar colours of an OHLC series without touching its bars. Times the series has no bar at are ignored; a colour
+     * equal to the one already there changes nothing and announces nothing. Announces a "color" change over the bars that
+     * did change (one event), which renderers answer by patching those records.
+     */
+    setColors(s: SeriesData, input: ColumnarColors): void;
+    /** Remove every bar colour of an OHLC series (and the colour column). Announces one "color" change when there were any. */
+    clearColors(s: SeriesData): void;
     private rebuildAndEmit;
     /**
      * Replace the targets' rows and rebuild the timeline as the union of every

package/dist/types/fault.d.ts

@@ -0,0 +1,9 @@
+export type FaultSource = "draw-loop" | "ctor" | "context-lost" | "context-restored" | "shader";
+export interface Fault {
+    source: FaultSource;
+    /** The thrown value; undefined for context events. */
+    error: unknown;
+    renderer?: "webgl" | "canvas2d";
+}
+export declare function onFault(fn: (f: Fault) => void): () => void;
+export declare function emitFault(f: Fault): void;

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export type { ChartPlugin, PluginApi, PluginPaneView, PluginPointer } from "./ch
 export type { SeriesBar, SeriesInput } from "./chart/series.js";
 export { registerSeriesType } from "./chart/series-types.js";
 export type { CommonSeriesOptions, LastValue, SeriesOptions, SeriesOptionsMap, SeriesType, SeriesTypeDef } from "./chart/series-types.js";
-export { PriceLine, crisp, dashPattern } from "./chart/primitives.js";
+export { BarShading, PriceLine, crisp, dashPattern } from "./chart/primitives.js";
 export type { SeriesMarker, MarkerPosition, MarkerShape } from "./chart/markers.js";
 export type { AxisLabel, LineDash, PanePrimitive, PaneView, PriceLineOptions, PrimitiveHit, PrimitiveHost, RenderLayer } from "./chart/primitives.js";
 export { DARK, HIGH_CONTRAST, LIGHT, systemTheme } from "./chart/theme.js";
@@ -29,12 +29,12 @@ export { SyncGroup } from "./interaction/sync.js";
 export type { SyncOptions } from "./interaction/sync.js";
 export { connectDatafeed } from "./feed/datafeed.js";
 export type { BarsRequest, BarsResponse, Datafeed, FeedController, FeedOptions, Trade, TradesRequest } from "./feed/datafeed.js";
-export type { ColumnarOhlc, ColumnarValue, OhlcBar, ValuePoint } from "./data/model.js";
+export type { ColumnarColors, ColumnarOhlc, ColumnarValue, OhlcBar, ValuePoint } from "./data/model.js";
 export type { PriceScaleOptions } from "./scale/price-scale.js";
 export type { TimeScaleOptions } from "./scale/time-scale.js";
 export type { TimeLabel } from "./scale/ticks.js";
 export type { DataChange, SeriesData, SeriesShape } from "./data/model.js";
-export { COL_C, COL_COLOR, COL_H, COL_L, COL_O, COL_V } from "./data/model.js";
+export { COL_BAR_COLOR, COL_C, COL_COLOR, COL_H, COL_L, COL_O, COL_V } from "./data/model.js";
 export { LOD_BASE, LOD_C, LOD_COLOR, LOD_H, LOD_L, LOD_O } from "./data/lod.js";
 export { parseColor, rgba, cssColor } from "./render/color.js";
 export { barWidths } from "./render/renderers.js";

package/dist/types/internal.d.ts

@@ -1,3 +1,6 @@
 export { InstanceWindow, chooseLevel, RECORD_FLOATS, RECORD_BYTES, HOLE_TEST } from "./render/window.js";
 export { GLContext, GLSL_COMMON } from "./render/gl.js";
 export type { Program } from "./render/gl.js";
+export { CORE_VERSION } from "./version.js";
+export { onFault } from "./fault.js";
+export type { Fault, FaultSource } from "./fault.js";

package/dist/types/version.d.ts

@@ -0,0 +1 @@
+export declare const CORE_VERSION = "0.1.1";