@tradecanvas/chart 1.3.0 → 1.7.0

package/dist/layout/LayoutManager.d.ts

@@ -1,16 +1,66 @@
 import { PanelPosition, PanelConfig, ResolvedLayout, Rect } from '@tradecanvas/commons';
+/** What a folded pane keeps: its header, with the indicator's name and the pane's buttons. */
+export declare const COLLAPSED_PANE_HEIGHT = 20;
+/** The least the price pane keeps while a pane is maximised. */
+export declare const MIN_MAIN_HEIGHT_WITH_MAXIMIZED = 48;
 export declare class LayoutManager {
     private panels;
     private containerWidth;
     private containerHeight;
     private priceAxisWidth;
+    /** Width of the left price scale; 0 while it is hidden. */
+    private leftAxisWidth;
+    /** The pane that takes the room of the others (they fold to their headers), or null. */
+    private maximized;
     resize(width: number, height: number): void;
     addPanel(instanceId: string, position?: PanelPosition, size?: number): void;
+    /** Hand a pane to another indicator, keeping its place and size. */
+    renamePanel(fromId: string, toId: string): void;
     removePanel(instanceId: string): void;
+    /**
+     * Fold a top or bottom pane to its header, or open it again. While a pane
+     * is maximised this puts the layout back to normal first (the other panes
+     * show folded then). False when nothing changed.
+     */
+    setPanelCollapsed(instanceId: string, collapsed: boolean): boolean;
+    /** Folded as set (see `isPanelShownCollapsed` for how it shows). */
+    isPanelCollapsed(instanceId: string): boolean;
+    /** Shown folded: folded as set, or another pane is maximised. */
+    isPanelShownCollapsed(instanceId: string): boolean;
+    /** A pane's value scale: logarithmic, upside down, in percent. False when nothing changed. */
+    setPanelScale(instanceId: string, scale: {
+        log?: boolean;
+        invert?: boolean;
+        percent?: boolean;
+    }): boolean;
+    /** Whether `movePanel(instanceId, delta)` would move it. */
+    canMovePanel(instanceId: string, delta: -1 | 1): boolean;
+    /**
+     * Let one top or bottom pane take the room: the others fold to their
+     * headers and the price pane keeps a strip. `null` puts them back.
+     */
+    setMaximizedPanel(instanceId: string | null): boolean;
+    getMaximizedPanel(): string | null;
+    /**
+     * Move a pane one place up (`-1`) or down (`1`) among the panes on its side
+     * of the price pane. False at the end of the line.
+     */
+    movePanel(instanceId: string, delta: -1 | 1): boolean;
+    /** Put the panes on each side in the order of `ids` (others keep their place after them). */
+    orderPanels(ids: readonly string[]): void;
+    /** A pane's height (or width) on screen: folded, maximised or as set. */
+    private shownSize;
     setPanelPosition(instanceId: string, position: PanelPosition): void;
+    /**
+     * Resize a pane; a folded pane opens, and a maximised layout goes back to
+     * normal. A height is kept within the room there is (a stored layout may ask
+     * for more).
+     */
     setPanelSize(instanceId: string, size: number): void;
     /** Width reserved for the price axis right of the main chart. */
     setPriceAxisWidth(width: number): void;
+    /** Width reserved left of the plot for the left price scale (0 = none). */
+    setLeftAxisWidth(width: number): void;
     getPanels(): PanelConfig[];
     resolve(): ResolvedLayout;
     getMainChartRect(): Rect;

package/dist/layout/LayoutManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LayoutManager.d.ts","sourceRoot":"","sources":["../../src/layout/LayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAA8B,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAMzH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAoB;IAE1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAWrF,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAanE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOpD,iEAAiE;IACjE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,SAAS,IAAI,WAAW,EAAE;IAI1B,OAAO,IAAI,cAAc;IAoFzB,gBAAgB,IAAI,IAAI;CAGzB"}
+{"version":3,"file":"LayoutManager.d.ts","sourceRoot":"","sources":["../../src/layout/LayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAA8B,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAKzH,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,gEAAgE;AAChE,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAIjD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAoB;IAC1C,2DAA2D;IAC3D,OAAO,CAAC,aAAa,CAAK;IAC1B,wFAAwF;IACxF,OAAO,CAAC,SAAS,CAAuB;IAExC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAarF,oEAAoE;IACpE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ/C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKrC;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;IASlE,oEAAoE;IACpE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C,iEAAiE;IACjE,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAMlD,8FAA8F;IAC9F,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAmBzG,4DAA4D;IAC5D,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO;IAOxD;;;OAGG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IASrD,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO;IAgBrD,6FAA6F;IAC7F,WAAW,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAQzC,yEAAyE;IACzE,OAAO,CAAC,SAAS;IAMjB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAkBnE;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAWpD,iEAAiE;IACjE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,2EAA2E;IAC3E,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,SAAS,IAAI,WAAW,EAAE;IAI1B,OAAO,IAAI,cAAc;IAgGzB,gBAAgB,IAAI,IAAI;CAGzB"}

package/dist/layout/priceAxisWidth.d.ts

@@ -7,6 +7,8 @@ export interface PriceAxisWidthInput {
     /** Decimals for the price tags (a market's `pricePrecision`), or null to follow the axis. */
     tagPrecision: number | null;
     locale: string;
+    /** The chart's price format, when it has one: labels and tags print with it. */
+    format?: ((price: number) => string) | null;
     fontFamily: string;
     fontSizeSmall: number;
     measure: (text: string, font: string) => number;

package/dist/layout/priceAxisWidth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"priceAxisWidth.d.ts","sourceRoot":"","sources":["../../src/layout/priceAxisWidth.ts"],"names":[],"mappings":"AAUA,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAoBzE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5E"}
+{"version":3,"file":"priceAxisWidth.d.ts","sourceRoot":"","sources":["../../src/layout/priceAxisWidth.ts"],"names":[],"mappings":"AAUA,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAoBzE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/regularHours.d.ts

@@ -0,0 +1,10 @@
+import { SymbolInfo } from '@tradecanvas/commons';
+/**
+ * Which bar times fall in `info`'s regular hours, for bars like `data`'s
+ * (by the time each bar opens). Null when there is nothing to leave out:
+ * the symbol has no hours or no zone, or the bars are a day or longer.
+ */
+export declare function regularHoursFilter(info: SymbolInfo | null, data: readonly {
+    time: number;
+}[]): ((time: number) => boolean) | null;
+//# sourceMappingURL=regularHours.d.ts.map

package/dist/regularHours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regularHours.d.ts","sourceRoot":"","sources":["../src/regularHours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQvD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAChC,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAiBpC"}

package/dist/state/LayoutSession.d.ts

@@ -0,0 +1,101 @@
+import { LayoutStorage, SavedLayout, SavedLayoutSummary } from './layoutStorage.js';
+/** The longest a layout's name may be. */
+export declare const MAX_LAYOUT_NAME = 80;
+/** A layout name trimmed, with runs of spaces folded and capped in length; `null` when nothing is left. */
+export declare function cleanLayoutName(name: string): string | null;
+/** What a session saves and opens: the widget, or a grid of widgets. */
+export interface LayoutSessionHost {
+    /** What to save now, with the symbol and interval a list shows. */
+    capture(): {
+        content: string;
+        symbol?: string;
+        timeframe?: string;
+    };
+    /** Show a saved layout; throw when its content can't be shown. */
+    apply(layout: SavedLayout): Promise<void> | void;
+}
+export interface LayoutSessionOptions {
+    /** Save the current layout by itself once changes settle. Default `true`. */
+    autoSave?: boolean;
+    /** How long changes must settle before an auto-save. Default 1500 ms. */
+    debounceMs?: number;
+    /**
+     * What this session saves (`'chart'`, the default, or `'grid'`): it lists
+     * and opens only layouts of its kind, so both can share one storage.
+     */
+    kind?: string;
+    /** The current layout, its saved state or the auto-save switch changed. */
+    onChange?: () => void;
+    /** An auto-save failed (a full storage, a server down). */
+    onError?: (error: unknown) => void;
+    now?: () => number;
+    newId?: () => string;
+}
+/**
+ * Named layouts over a {@link LayoutStorage}: the one showing now, save it,
+ * save it under a new name, open, rename and remove. Changes reported with
+ * `changed()` are auto-saved into the current layout once they settle, and
+ * only when what would be saved differs from what was.
+ *
+ * Every operation runs in turn, and reads the current layout and captures
+ * the chart when its turn comes: a save never lands in a layout opened after
+ * it was asked for, and never holds a half-opened chart. What storage hands
+ * back is checked before it is used.
+ */
+export declare class LayoutSession {
+    private readonly storage;
+    private readonly host;
+    private readonly options;
+    private currentLayout;
+    /** What the current layout holds in storage (as captured), to tell a real change. */
+    private savedContent;
+    private dirty;
+    private autoSave;
+    private readonly debounceMs;
+    private readonly kind;
+    private timer;
+    private applying;
+    /** Operations waiting or running; a change while one runs is looked at after. */
+    private busy;
+    private changedWhileBusy;
+    private tail;
+    private destroyed;
+    private readonly now;
+    private readonly newId;
+    constructor(storage: LayoutStorage, host: LayoutSessionHost, options?: LayoutSessionOptions);
+    /** The layout showing now, or `null` before one is saved or opened. */
+    current(): SavedLayoutSummary | null;
+    /** The chart differs from the current layout as saved (auto-save off, failed, or not yet run). */
+    isDirty(): boolean;
+    isAutoSave(): boolean;
+    setAutoSave(on: boolean): void;
+    /** Every saved layout of this session's kind, newest first; entries that aren't layouts are left out. */
+    list(): Promise<SavedLayoutSummary[]>;
+    /** Save into the current layout; `null` when there is none yet (ask for a name, then `saveAs`). */
+    save(): Promise<SavedLayoutSummary | null>;
+    /** Save as a new layout called `name`, and make it the current one. */
+    saveAs(name: string): Promise<SavedLayoutSummary>;
+    /**
+     * Show a saved layout. `false` when there is no such layout (or it isn't
+     * one of this kind); rejects when it could not be shown, and then no layout
+     * is current (the chart may be part way).
+     */
+    open(id: string): Promise<boolean>;
+    rename(id: string, name: string): Promise<void>;
+    remove(id: string): Promise<void>;
+    /** Something a layout holds may have changed: check once things settle, and auto-save. */
+    changed(): void;
+    /** Stop. A change still waiting to be auto-saved is saved now. */
+    destroy(): void;
+    /** The changes have settled: save them into the current layout, or mark it changed. */
+    private settle;
+    /** Store the chart as layout `id` and make it the current one (runs inside the queue). */
+    private write;
+    /** No layout is current any more. */
+    private forget;
+    /** Run operations one after another; a failed one does not stop the next. */
+    private queue;
+    private cancelTimer;
+    private notify;
+}
+//# sourceMappingURL=LayoutSession.d.ts.map

package/dist/state/LayoutSession.d.ts.map

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

package/dist/state/layoutStorage.d.ts

@@ -0,0 +1,46 @@
+/** A saved layout as a list shows it. */
+export interface SavedLayoutSummary {
+    id: string;
+    name: string;
+    /** The symbol it opens on. */
+    symbol?: string;
+    /** The interval it opens on. */
+    timeframe?: string;
+    /** When it was last saved, in ms since the epoch. */
+    updatedAt: number;
+    /** What saved it: `'chart'` (a widget, the default) or `'grid'` (a grid of charts). */
+    kind?: string;
+}
+/** A saved layout: its summary and what it holds, as the widget wrote it (JSON). */
+export interface SavedLayout extends SavedLayoutSummary {
+    content: string;
+}
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Where named layouts live. The widget ships one for `localStorage` and one in
+ * memory; a host keeps layouts on its server by implementing these four calls
+ * (each may return a promise).
+ */
+export interface LayoutStorage {
+    /** Every layout, newest first. */
+    list(): MaybePromise<SavedLayoutSummary[]>;
+    /** One layout, or `null` when there is no such layout. */
+    load(id: string): MaybePromise<SavedLayout | null>;
+    /** Save a layout, replacing one with the same id. */
+    save(layout: SavedLayout): MaybePromise<void>;
+    remove(id: string): MaybePromise<void>;
+}
+/** A summary read back from storage (or a host's server), or null when it is not one. */
+export declare function readLayoutSummary(value: unknown): SavedLayoutSummary | null;
+/** A whole layout read back from storage, or null when it is not one. */
+export declare function readSavedLayout(value: unknown): SavedLayout | null;
+/** Layouts kept in memory: for tests, or a page that does not keep them. */
+export declare function memoryLayouts(initial?: readonly SavedLayout[]): LayoutStorage;
+/**
+ * Layouts in the browser's `localStorage`: an index of summaries under
+ * `<prefix>index` and each layout's content under `<prefix>item:<id>`.
+ * Entries it cannot read are skipped.
+ */
+export declare function localStorageLayouts(prefix?: string): LayoutStorage;
+export {};
+//# sourceMappingURL=layoutStorage.d.ts.map

package/dist/state/layoutStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutStorage.d.ts","sourceRoot":"","sources":["../../src/state/layoutStorage.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,IAAI,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,qDAAqD;IACrD,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CACxC;AAYD,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAY3E;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAIlE;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,GAAE,SAAS,WAAW,EAAO,GAAG,aAAa,CAejF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAiB,GAAG,aAAa,CAiC1E"}

package/dist/trading/wireExecution.d.ts

@@ -1,6 +1,6 @@
-import { ExecutionAdapter, ExecutionError, TradingOrder, TradingPosition } from '@tradecanvas/commons';
-/** The five order/position intents the chart emits and an adapter consumes. */
-export type ExecutionIntentType = 'orderPlace' | 'orderModify' | 'orderCancel' | 'positionModify' | 'positionClose';
+import { ExecutionAdapter, ExecutionError, TradingOrder, TradingPosition, FillEvent } from '@tradecanvas/commons';
+/** The order/position intents the chart emits and an adapter consumes. */
+export type ExecutionIntentType = 'orderPlace' | 'orderModify' | 'orderCancel' | 'positionModify' | 'positionClose' | 'positionReverse';
 /**
  * Surface the host (the Chart) provides so execution can be bridged without
  * the helper knowing anything about chart internals — which keeps it pure and
@@ -15,6 +15,10 @@ export interface ExecutionHost {
     setPositions(positions: TradingPosition[]): void;
     /** Surface an execution failure (adapter-reported or a failed command). */
     onError(error: ExecutionError): void;
+    /** An order filled or a position closed (the adapter's `fill`). */
+    onFill?(fill: FillEvent): void;
+    /** The positions on the chart, until the adapter reports its own. */
+    getPositions?(): readonly TradingPosition[];
 }
 /**
  * Bridge an `ExecutionAdapter` to a host: render the adapter's authoritative

package/dist/trading/wireExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wireExecution.d.ts","sourceRoot":"","sources":["../../src/trading/wireExecution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,YAAY,EACZ,eAAe,EAMhB,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrF,yDAAyD;IACzD,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACxC,yDAAyD;IACzD,YAAY,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACjD,2EAA2E;IAC3E,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAaD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI,CA+BxF"}
+{"version":3,"file":"wireExecution.d.ts","sourceRoot":"","sources":["../../src/trading/wireExecution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,YAAY,EACZ,eAAe,EAOf,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrF,yDAAyD;IACzD,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACxC,yDAAyD;IACzD,YAAY,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACjD,2EAA2E;IAC3E,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,mEAAmE;IACnE,MAAM,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,qEAAqE;IACrE,YAAY,CAAC,IAAI,SAAS,eAAe,EAAE,CAAC;CAC7C;AAsDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI,CA6CxF"}