@forgecharts/sdk 1.1.23 → 1.1.28

package/dist/pixi/PixiDrawingRenderer.js

@@ -0,0 +1,111 @@
+import { Graphics } from 'pixi.js';
+const DEFAULT_COLOR = 0x888888;
+const DEFAULT_WIDTH = 1;
+const FIB_RATIOS = [0, 0.236, 0.382, 0.5, 0.618, 0.786, 1];
+/**
+ * PixiDrawingRenderer — renders all drawing objects via GPU-batched Graphics.
+ *
+ * All `DrawingPoint` (time, price) → pixel conversions go through
+ * `CoordTransform`, keeping drawings perfectly aligned with the price series
+ * across zoom/pan without requiring a full re-fetch of underlying data.
+ */
+export class PixiDrawingRenderer {
+    _gfx;
+    constructor(layer) {
+        this._gfx = new Graphics();
+        layer.addChild(this._gfx);
+    }
+    draw(drawings, transform) {
+        this._gfx.clear();
+        for (const d of drawings) {
+            if (d.visible === false)
+                continue;
+            this._drawOne(d, transform);
+        }
+    }
+    _drawOne(d, t) {
+        const gfx = this._gfx;
+        const color = d.color ? parseInt(d.color.replace('#', ''), 16) : DEFAULT_COLOR;
+        const width = d.lineWidth ?? DEFAULT_WIDTH;
+        const stroke = { color, width };
+        const { points, type } = d;
+        switch (type) {
+            case 'trendline': {
+                if (points.length < 2)
+                    break;
+                const p0 = t.toPixel(points[0].time, points[0].price);
+                const p1 = t.toPixel(points[1].time, points[1].price);
+                gfx.moveTo(p0.x, p0.y).lineTo(p1.x, p1.y).stroke(stroke);
+                break;
+            }
+            case 'horizontal': {
+                if (points.length < 1)
+                    break;
+                const y = t.priceToY(points[0].price);
+                gfx.moveTo(0, y).lineTo(t.plotWidth, y).stroke(stroke);
+                break;
+            }
+            case 'vertical': {
+                if (points.length < 1)
+                    break;
+                const x = t.timeToX(points[0].time);
+                gfx.moveTo(x, 0).lineTo(x, t.plotHeight).stroke(stroke);
+                break;
+            }
+            case 'rectangle': {
+                if (points.length < 2)
+                    break;
+                const p0 = t.toPixel(points[0].time, points[0].price);
+                const p1 = t.toPixel(points[1].time, points[1].price);
+                gfx
+                    .rect(Math.min(p0.x, p1.x), Math.min(p0.y, p1.y), Math.abs(p1.x - p0.x), Math.abs(p1.y - p0.y))
+                    .stroke(stroke);
+                break;
+            }
+            case 'fibRetracement': {
+                if (points.length < 2)
+                    break;
+                const priceHigh = Math.max(points[0].price, points[1].price);
+                const priceLow = Math.min(points[0].price, points[1].price);
+                const span = priceHigh - priceLow;
+                const x0 = Math.min(t.timeToX(points[0].time), t.timeToX(points[1].time));
+                const x1 = Math.max(t.timeToX(points[0].time), t.timeToX(points[1].time));
+                for (const ratio of FIB_RATIOS) {
+                    const levelPrice = priceLow + span * (1 - ratio);
+                    const y = t.priceToY(levelPrice);
+                    gfx.moveTo(x0, y).lineTo(x1, y).stroke({ color, width, alpha: 0.7 });
+                }
+                break;
+            }
+            // ray: rendered as a segment from p0 through p1 to the plot boundary
+            case 'ray': {
+                if (points.length < 2)
+                    break;
+                const x0 = t.timeToX(points[0].time);
+                const y0 = t.priceToY(points[0].price);
+                const dx = t.timeToX(points[1].time) - x0;
+                const dy = t.priceToY(points[1].price) - y0;
+                let tMin = Infinity;
+                if (dx > 0)
+                    tMin = Math.min(tMin, (t.plotWidth - x0) / dx);
+                else if (dx < 0)
+                    tMin = Math.min(tMin, -x0 / dx);
+                if (dy > 0)
+                    tMin = Math.min(tMin, (t.plotHeight - y0) / dy);
+                else if (dy < 0)
+                    tMin = Math.min(tMin, -y0 / dy);
+                const ex = tMin === Infinity ? x0 : x0 + dx * tMin;
+                const ey = tMin === Infinity ? y0 : y0 + dy * tMin;
+                gfx.moveTo(x0, y0).lineTo(ex, ey).stroke(stroke);
+                break;
+            }
+            // text: PixiJS does not handle text labels — skip silently
+            case 'text':
+                break;
+            default:
+                // Fib/Gann tools and future drawing types are rendered by the canvas layer, not Pixi.
+                break;
+        }
+    }
+}
+//# sourceMappingURL=PixiDrawingRenderer.js.map

package/dist/pixi/PixiDrawingRenderer.js.map

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

package/dist/pixi/PixiGridRenderer.d.ts

@@ -0,0 +1,22 @@
+import { Container } from 'pixi.js';
+import type { ChartColors } from '@forgecharts/types';
+import type { CoordTransform } from '../core/CoordTransform';
+import type { TimeScale } from '../core/TimeScale';
+/**
+ * PixiGridRenderer — draws background fill, horizontal grid lines (price),
+ * vertical grid lines (time), and the axis separator borders.
+ *
+ * All drawing uses PixiJS `Graphics` which is GPU-batched.
+ */
+export declare class PixiGridRenderer {
+    private readonly _colors;
+    private readonly _gfx;
+    private readonly _timeLabels;
+    private readonly _priceLabels;
+    private readonly _timeScale;
+    constructor(layer: Container, _colors: ChartColors, timeScale: TimeScale);
+    draw(transform: CoordTransform, width: number, height: number): void;
+    private _formatPrice;
+    private _niceTimeStep;
+}
+//# sourceMappingURL=PixiGridRenderer.d.ts.map

package/dist/pixi/PixiGridRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixiGridRenderer.d.ts","sourceRoot":"","sources":["../../src/pixi/PixiGridRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,SAAS,EAAmB,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;gBAGrC,KAAK,EAAE,SAAS,EACC,OAAO,EAAE,WAAW,EACrC,SAAS,EAAE,SAAS;IAStB,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiFpE,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;CAgBtB"}

package/dist/pixi/PixiGridRenderer.js

@@ -0,0 +1,114 @@
+import { Graphics, Container, Text, TextStyle } from 'pixi.js';
+import { computeTicks } from '../core/TimeScale';
+import { formatTimestampLabel } from '@forgecharts/utils';
+const TICK_LEN = 4;
+/**
+ * PixiGridRenderer — draws background fill, horizontal grid lines (price),
+ * vertical grid lines (time), and the axis separator borders.
+ *
+ * All drawing uses PixiJS `Graphics` which is GPU-batched.
+ */
+export class PixiGridRenderer {
+    _colors;
+    _gfx;
+    _timeLabels;
+    _priceLabels;
+    _timeScale;
+    constructor(layer, _colors, timeScale) {
+        this._colors = _colors;
+        this._timeScale = timeScale;
+        this._gfx = new Graphics();
+        this._timeLabels = new Container();
+        this._priceLabels = new Container();
+        layer.addChild(this._gfx, this._timeLabels, this._priceLabels);
+    }
+    draw(transform, width, height) {
+        const gfx = this._gfx;
+        gfx.clear();
+        const { plotWidth: pw, plotHeight: ph, priceScaleWidth, timeScaleHeight } = transform;
+        const { min: priceMin, max: priceMax } = transform.priceRange;
+        const { from: timeFrom, to: timeTo } = transform.timeRange;
+        // ── Background ────────────────────────────────────────────────────────────
+        gfx.rect(0, 0, width, height).fill(this._colors.background);
+        // ── Horizontal price grid ─────────────────────────────────────────────────
+        const priceTicks = computeTicks(priceMin, priceMax, Math.max(2, Math.floor(ph / 50)));
+        this._priceLabels.removeChildren();
+        const labelStyle = new TextStyle({
+            fontSize: 11,
+            fontFamily: 'system-ui, sans-serif',
+            fill: this._colors.text,
+        });
+        for (const tick of priceTicks) {
+            if (tick < priceMin || tick > priceMax)
+                continue;
+            const y = transform.priceToY(tick);
+            if (y < 0 || y > ph)
+                continue;
+            gfx.moveTo(0, y).lineTo(pw, y).stroke({ color: this._colors.grid, width: 1, alpha: 0.5 });
+            // Tick mark on axis border
+            gfx.moveTo(pw, y).lineTo(pw + TICK_LEN, y).stroke({ color: this._colors.border, width: 1 });
+            // Price label
+            const t = new Text({ text: this._formatPrice(tick), style: labelStyle });
+            t.x = pw + TICK_LEN + 2;
+            t.y = y - t.height / 2;
+            this._priceLabels.addChild(t);
+        }
+        // ── Vertical time grid ────────────────────────────────────────────────────
+        const approxTicks = Math.max(2, Math.floor(pw / 100));
+        const span = timeTo - timeFrom;
+        const rawStep = span / approxTicks;
+        const step = this._niceTimeStep(rawStep);
+        const startTime = Math.ceil(timeFrom / step) * step;
+        this._timeLabels.removeChildren();
+        const timeLabelStyle = new TextStyle({
+            fontSize: 11,
+            fontFamily: 'system-ui, sans-serif',
+            fill: this._colors.text,
+        });
+        for (let t = startTime; t <= timeTo; t += step) {
+            const x = transform.timeToX(t);
+            if (x < 0 || x > pw)
+                continue;
+            gfx.moveTo(x, 0).lineTo(x, ph).stroke({ color: this._colors.grid, width: 1, alpha: 0.4 });
+            gfx.moveTo(x, ph).lineTo(x, ph + TICK_LEN).stroke({ color: this._colors.border, width: 1 });
+            const label = formatTimestampLabel(t, step);
+            const tl = new Text({ text: label, style: timeLabelStyle });
+            tl.x = x - tl.width / 2;
+            tl.y = ph + TICK_LEN + 2;
+            this._timeLabels.addChild(tl);
+        }
+        // ── Axis separator lines ──────────────────────────────────────────────────
+        gfx
+            .moveTo(0, ph).lineTo(pw, ph)
+            .stroke({ color: this._colors.border, width: 1 });
+        gfx
+            .moveTo(pw, 0).lineTo(pw, ph)
+            .stroke({ color: this._colors.border, width: 1 });
+        // ── Price axis background fill ────────────────────────────────────────────
+        gfx.rect(pw, 0, priceScaleWidth, ph).fill(this._colors.backgroundSecondary);
+        // ── Time axis background fill ─────────────────────────────────────────────
+        gfx.rect(0, ph, pw, timeScaleHeight).fill(this._colors.backgroundSecondary);
+    }
+    _formatPrice(price) {
+        const decimals = price < 1 ? 6 : price < 1000 ? 4 : 2;
+        return price.toFixed(decimals);
+    }
+    _niceTimeStep(rawSeconds) {
+        const nice = [
+            1, 5, 10, 30, 60, 300, 600, 900, 1800, 3600, 7200, 14400, 21600, 43200,
+            86400, // 1 day
+            7 * 86400, // 1 week
+            14 * 86400, // 2 weeks
+            30 * 86400, // ~1 month
+            91 * 86400, // ~quarter
+            182 * 86400, // ~half year
+            365 * 86400, // ~1 year
+        ];
+        for (const s of nice) {
+            if (s >= rawSeconds)
+                return s;
+        }
+        return 365 * 86400 * Math.ceil(rawSeconds / (365 * 86400));
+    }
+}
+//# sourceMappingURL=PixiGridRenderer.js.map

package/dist/pixi/PixiGridRenderer.js.map

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

package/dist/pixi/PixiLayerManager.d.ts

@@ -0,0 +1,56 @@
+import { Container } from 'pixi.js';
+import { LayerName } from './LayerName';
+/**
+ * DirtyFlags — bitmask that tracks which layers need to be redrawn.
+ *
+ * Call `mark(layer)` whenever data or viewport changes affecting a layer.
+ * Call `isDirty(layer)` before redrawing to skip unnecessary work.
+ * Call `clear(layer)` after the layer finishes drawing.
+ */
+export declare class DirtyFlags {
+    private _bits;
+    mark(layer: LayerName): void;
+    markAll(): void;
+    isDirty(layer: LayerName): boolean;
+    clear(layer: LayerName): void;
+    clearAll(): void;
+}
+/**
+ * PixiLayerManager — owns one PixiJS `Container` per layer, stacked by z-index.
+ *
+ * Responsibilities:
+ * - Creates and names seven containers corresponding to `LayerName` values
+ * - Attaches all containers to a root `Container` already mounted in the stage
+ * - Exposes `get(layer)` so renderers can add display objects to the right layer
+ * - Owns a `DirtyFlags` instance for selective redraw signalling
+ * - `clear(layer)` removes all children from a layer without destroying the container
+ *
+ * @example
+ * ```ts
+ * const layers = new PixiLayerManager(stage);
+ *
+ * // Direct child access
+ * const seriesContainer = layers.get(LayerName.PriceSeries);
+ *
+ * // Invalidation
+ * layers.dirty.mark(LayerName.PriceSeries);
+ * if (layers.dirty.isDirty(LayerName.PriceSeries)) {
+ *   // redraw…
+ *   layers.dirty.clear(LayerName.PriceSeries);
+ * }
+ * ```
+ */
+export declare class PixiLayerManager {
+    private readonly _containers;
+    readonly dirty: DirtyFlags;
+    constructor(stage: Container);
+    /** Returns the `Container` for the given layer. */
+    get(layer: LayerName): Container;
+    /** Removes all display objects from a layer (preserves the container itself). */
+    clear(layer: LayerName): void;
+    /** Removes all display objects from every layer. */
+    clearAll(): void;
+    /** Destroys all container children (use on chart destroy). */
+    destroy(): void;
+}
+//# sourceMappingURL=PixiLayerManager.d.ts.map

package/dist/pixi/PixiLayerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixiLayerManager.d.ts","sourceRoot":"","sources":["../../src/pixi/PixiLayerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,SAAS,EAA4B,MAAM,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAK;IAElB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI5B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIlC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI7B,QAAQ,IAAI,IAAI;CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,QAAQ,CAAC,KAAK,aAAoB;gBAEtB,KAAK,EAAE,SAAS;IAa5B,mDAAmD;IACnD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAMhC,iFAAiF;IACjF,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI7B,oDAAoD;IACpD,QAAQ,IAAI,IAAI;IAIhB,8DAA8D;IAC9D,OAAO,IAAI,IAAI;CAOhB"}

package/dist/pixi/PixiLayerManager.js

@@ -0,0 +1,92 @@
+import { Container } from 'pixi.js';
+import { LAYER_NAMES, LAYER_LABEL } from './LayerName';
+/**
+ * DirtyFlags — bitmask that tracks which layers need to be redrawn.
+ *
+ * Call `mark(layer)` whenever data or viewport changes affecting a layer.
+ * Call `isDirty(layer)` before redrawing to skip unnecessary work.
+ * Call `clear(layer)` after the layer finishes drawing.
+ */
+export class DirtyFlags {
+    _bits = 0;
+    mark(layer) {
+        this._bits |= 1 << layer;
+    }
+    markAll() {
+        this._bits = (1 << LAYER_NAMES.length) - 1;
+    }
+    isDirty(layer) {
+        return (this._bits & (1 << layer)) !== 0;
+    }
+    clear(layer) {
+        this._bits &= ~(1 << layer);
+    }
+    clearAll() {
+        this._bits = 0;
+    }
+}
+/**
+ * PixiLayerManager — owns one PixiJS `Container` per layer, stacked by z-index.
+ *
+ * Responsibilities:
+ * - Creates and names seven containers corresponding to `LayerName` values
+ * - Attaches all containers to a root `Container` already mounted in the stage
+ * - Exposes `get(layer)` so renderers can add display objects to the right layer
+ * - Owns a `DirtyFlags` instance for selective redraw signalling
+ * - `clear(layer)` removes all children from a layer without destroying the container
+ *
+ * @example
+ * ```ts
+ * const layers = new PixiLayerManager(stage);
+ *
+ * // Direct child access
+ * const seriesContainer = layers.get(LayerName.PriceSeries);
+ *
+ * // Invalidation
+ * layers.dirty.mark(LayerName.PriceSeries);
+ * if (layers.dirty.isDirty(LayerName.PriceSeries)) {
+ *   // redraw…
+ *   layers.dirty.clear(LayerName.PriceSeries);
+ * }
+ * ```
+ */
+export class PixiLayerManager {
+    _containers = new Map();
+    dirty = new DirtyFlags();
+    constructor(stage) {
+        for (const name of LAYER_NAMES) {
+            const c = new Container();
+            c.label = LAYER_LABEL[name];
+            c.zIndex = name;
+            stage.addChild(c);
+            this._containers.set(name, c);
+        }
+        // PixiJS v8: sortableChildren must be true on the stage so zIndex is respected
+        stage.sortableChildren = true;
+    }
+    /** Returns the `Container` for the given layer. */
+    get(layer) {
+        const c = this._containers.get(layer);
+        if (!c)
+            throw new Error(`[ForgeCharts] Unknown layer: ${layer}`);
+        return c;
+    }
+    /** Removes all display objects from a layer (preserves the container itself). */
+    clear(layer) {
+        this.get(layer).removeChildren();
+    }
+    /** Removes all display objects from every layer. */
+    clearAll() {
+        for (const name of LAYER_NAMES)
+            this.clear(name);
+    }
+    /** Destroys all container children (use on chart destroy). */
+    destroy() {
+        for (const name of LAYER_NAMES) {
+            const c = this._containers.get(name);
+            c?.destroy({ children: true });
+        }
+        this._containers.clear();
+    }
+}
+//# sourceMappingURL=PixiLayerManager.js.map

package/dist/pixi/PixiLayerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixiLayerManager.js","sourceRoot":"","sources":["../../src/pixi/PixiLayerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAa,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,CAAC,CAAC;IAElB,IAAI,CAAC,KAAgB;QACnB,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,KAAgB;QACtB,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAgB;QACpB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,gBAAgB;IACV,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtD,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAElC,YAAY,KAAgB;QAC1B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;YAC1B,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QAED,+EAA+E;QAC/E,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,mDAAmD;IACnD,GAAG,CAAC,KAAgB;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,KAAgB;QACpB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC;IACnC,CAAC;IAED,oDAAoD;IACpD,QAAQ;QACN,KAAK,MAAM,IAAI,IAAI,WAAW;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,8DAA8D;IAC9D,OAAO;QACL,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/react/canvas/ChartCanvas.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ChartCanvas — stacks the main price chart above one or more indicator panes.
+ *
+ * Features:
+ *  - Creates a TChart instance and attaches any `initialIndicators`.
+ *  - Each non-overlay indicator gets its own sub-pane (managed by TChart's PaneManager).
+ *  - Draggable dividers let the user resize panes; the price-split fraction is
+ *    reported via onPriceFractionChange (no localStorage in this package).
+ *  - A requestAnimationFrame loop forwards viewport changes (pan/zoom) to the
+ *    indicator canvases so they stay in sync with the main chart’s time axis.
+ *
+ * Previously exported as MultiPaneChart — that name is kept as an alias.
+ */
+import type { TradingOverlayStore } from '../../';
+import type { IndicatorConfig, ChartLayout } from '@forgecharts/types';
+import type { IDatafeed, ChartTheme } from '@forgecharts/types';
+import type { TradingBridgeCallbacks } from '../trading/TradingBridge';
+export type ChartCanvasHandle = {
+    /** Returns the full current chart state (indicators, drawings, viewport). */
+    getLayoutSnapshot: () => ChartLayout | null;
+    /** Replaces the chart state with the supplied layout snapshot. */
+    loadLayoutSnapshot: (layout: ChartLayout) => void;
+    /** Adds an indicator to the live chart and returns its id. */
+    addIndicator: (config: IndicatorConfig) => string | null;
+    /** Captures the visible chart area as a PNG data-URL. */
+    captureScreenshot: () => Promise<string | null>;
+    /**
+     * Returns the chart's internal TradingOverlayStore for Unmanaged mode.
+     * Use this to push confirmed order / position state into the chart.
+     * Returns null before the chart has mounted.
+     */
+    getOverlayStore: () => TradingOverlayStore | null;
+};
+export type ChartCanvasProps = {
+    symbol: string;
+    timeframe: string;
+    datafeed?: IDatafeed;
+    theme?: ChartTheme;
+    /** IANA timezone for axis labels (e.g. "America/New_York"). */
+    timezone?: string | undefined;
+    /** Indicators to add on mount. Non-overlay indicators each get a sub-pane. */
+    initialIndicators?: IndicatorConfig[];
+    /**
+     * When provided the chart restores this snapshot on mount instead of
+     * reading from localStorage. Pass a snapshot captured via getLayoutSnapshot()
+     * or a ChartLayout loaded from the server.
+     */
+    layoutToRestore?: ChartLayout | undefined;
+    /** Called whenever an indicator is added or removed, so the parent can trigger a workspace save. */
+    onIndicatorsChanged?: () => void;
+    /**
+     * Initial price-pane fraction (0.3–0.85). Defaults to 0.6.
+     * The parent controls persistence; changes are reported via onPriceFractionChange.
+     */
+    priceFraction?: number;
+    /** Called when the user drags the price/sub-pane divider. */
+    onPriceFractionChange?: (fraction: number) => void;
+    /**
+     * Optional callback to resolve an exchange logo URL.
+     * Receives the exchange code (e.g. "BINANCE") and returns a URL string,
+     * or undefined/null to suppress the logo image entirely.
+     * If omitted, no exchange logo is rendered.
+     */
+    getExchangeLogoUrl?: (exchange: string) => string | null | undefined;
+    /**
+     * Optional trading bridge callbacks for Unmanaged mode.
+     *
+     * When provided the chart will invoke these callbacks when the user performs
+     * a trading action (drag-to-place, cancel, bracket adjust, etc.).
+     * The chart never self-confirms — the host must push confirmed state back
+     * through `TradingOverlayStore` (via `upsertOrder` / `setOrders` etc.).
+     *
+     * Wrap with `createTradingBridgeLogger` during development for structured
+     * console output of every emitted intent.
+     */
+    tradingBridge?: TradingBridgeCallbacks;
+};
+/** @deprecated Use ChartCanvasProps */
+export type MultiPaneChartProps = ChartCanvasProps;
+/** @deprecated Use ChartCanvasHandle */
+export type MultiPaneChartHandle = ChartCanvasHandle;
+export declare const ChartCanvas: import("react").ForwardRefExoticComponent<ChartCanvasProps & import("react").RefAttributes<ChartCanvasHandle>>;
+/** @deprecated Use ChartCanvas */
+export declare const MultiPaneChart: import("react").ForwardRefExoticComponent<ChartCanvasProps & import("react").RefAttributes<ChartCanvasHandle>>;
+//# sourceMappingURL=ChartCanvas.d.ts.map

package/dist/react/canvas/ChartCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartCanvas.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ChartCanvas.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,KAAK,EAAyB,eAAe,EAAkC,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9H,OAAO,KAAK,EAAE,SAAS,EAAa,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AA0OvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,8DAA8D;IAC9D,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD;;;;OAIG;IACH,eAAe,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACxC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AACnD,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAErD,eAAO,MAAM,WAAW,gHAmpBtB,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,cAAc,gHAAc,CAAC"}