@stocksharp/trading-controls 0.1.0

package/dist/esm/trade-history-widget.js

@@ -0,0 +1,197 @@
+// Trade history — multi-instance.
+//
+// Read-only table of executed trades for the active portfolio. Builds its own
+// DOM (see `_buildRoot`) rather than cloning a <template> out of the page, so
+// it can be constructed by any host that supplies a `TradingHost`.
+//
+// Which portfolio to load and what to load it through both come off the host's
+// trading context rather than being read out of a singleton here: the panel
+// renders what it is given, and the host decides what "the active portfolio"
+// means.
+//
+// The table is `DataGrid` from `@stocksharp/grids`: the columns below are this
+// blotter's single declaration and the <thead> is left empty for the grid to
+// fill.
+import { formatPrice, formatQty, formatTime } from './formatters.js';
+import { makeElement, makeIconButton, makePanelId, makePanelRoot } from './dom.js';
+import { ControlTypes } from './control-types.js';
+import { assertHost } from './trading-host.js';
+import { DataGrid } from '@stocksharp/grids/data-grid';
+export class TradeHistoryWidget {
+    static create(hostEl, state, deps) {
+        // Assert before building: the markup below is localized through the
+        // host, so a missing host has to fail here rather than render a panel
+        // captioned with raw English keys.
+        const host = assertHost(deps?.host, 'TradeHistoryWidget');
+        const root = TradeHistoryWidget._buildRoot(host);
+        root.id = makePanelId(TradeHistoryWidget.TYPE);
+        hostEl.appendChild(root);
+        return new TradeHistoryWidget(root, state || {}, deps);
+    }
+    // The panel's markup. The host stylesheet reads this structure, and a
+    // docking host lifts `.panel-header`'s children into its tab strip.
+    static _buildRoot(host) {
+        const title = host.t('TradeHistory');
+        return makePanelRoot('trade-history-panel', title, [
+            makeElement('div', 'panel-header', {}, [
+                makeElement('span', '', {}, [title]),
+                makeIconButton('bt-icon-btn bt-icon-cancel panel-close-btn', host.t('ClosePanel'), 'bi-x', { type: 'button' }),
+            ]),
+            makeElement('div', 'panel-body panel-body-with-rail', {}, [
+                makeElement('div', 'panel-body-content', {}, [
+                    makeElement('table', 'terminal-table trade-history-table', { role: 'table', 'aria-label': host.t('TradeHistoryList') }, [
+                        makeElement('thead', '', {}, []),
+                        makeElement('tbody', 'trade-history-body', {}, []),
+                    ]),
+                ]),
+                makeElement('div', 'panel-rail', { role: 'toolbar', 'aria-label': host.t('TradeHistoryActions') }, [
+                    makeIconButton('bt-icon-btn panel-refresh-btn', host.t('Refresh'), 'bi-arrow-clockwise', {}),
+                    makeIconButton('bt-icon-btn panel-export-btn', host.t('ExportToExcel'), 'bi-file-earmark-spreadsheet', {}),
+                ]),
+            ]),
+        ]);
+    }
+    constructor(rootEl, _state, deps) {
+        this._host = assertHost(deps?.host, 'TradeHistoryWidget');
+        this.rootEl = rootEl;
+        this.bodyEl = this.rootEl.querySelector('.trade-history-body');
+        this._closeBtn = this.rootEl.querySelector('.panel-close-btn');
+        this._refreshBtn = this.rootEl.querySelector('.panel-refresh-btn');
+        this._exportBtn = this.rootEl.querySelector('.panel-export-btn');
+        this._closeBtn?.addEventListener('click', (e) => {
+            e.preventDefault();
+            this.dispose();
+            this._host.close();
+        });
+        this._refreshBtn?.addEventListener('click', (e) => {
+            e.preventDefault();
+            void this.refresh();
+        });
+        this._exportBtn?.addEventListener('click', (e) => {
+            e.preventDefault();
+            this._export();
+        });
+        this._rows = [];
+        const head = this.rootEl.querySelector('.trade-history-table thead');
+        this._grid = head && this.bodyEl
+            ? new DataGrid({
+                head: head,
+                body: this.bodyEl,
+                columns: this._columns(),
+                // Most recent fill on top by default — the natural way to read a trade blotter.
+                defaultSort: { col: 'time', dir: 'desc' },
+                rowKey: (t) => String(t.id),
+                emptyText: this._host.t('No trade history'),
+            })
+            : null;
+        this._host.register(this);
+    }
+    dispose() {
+        this._host.unregister(this);
+        try {
+            this.rootEl.remove();
+        }
+        catch { /* already detached */ }
+    }
+    /// Reload against whichever portfolio the host says is active right now.
+    ///
+    /// Two guards, and they are not the same one. No portfolio means there is
+    /// nothing to show — a guest session has none. A portfolio the host will
+    /// not `allow` reading means the session cannot make the call at all: this
+    /// is somebody's executed trades, so a page that has a portfolio id lying
+    /// around but no live credential must not fire the request and collect a
+    /// 401 for it. The panel asks the host rather than inspecting a token,
+    /// because what counts as a usable session is the host's to know.
+    ///
+    /// Order matters: the portfolio check runs first, so a session with no
+    /// portfolio is simply quiet — `allow` is the one that may put a sign-in
+    /// prompt on screen, and reaching it means the page did have an account to
+    /// load.
+    async refresh() {
+        const pf = this._host.trading.portfolioId();
+        if (!pf || !this._grid)
+            return;
+        if (!this._host.allow('load trade history'))
+            return;
+        try {
+            this._rows = await this._host.trading.api.getExecutions(pf, null, 200) || [];
+            this._grid.setRows(this._rows);
+        }
+        catch (err) {
+            // Through the port, not the console: this is the diagnostic the
+            // user cannot see and support has to, and routing it here is also
+            // what makes it assertable.
+            this._host.log(`TradeHistoryWidget: failed to load trade history: ${err}`);
+        }
+    }
+    // Export the table to .xlsx in the currently rendered (sorted) order.
+    _export() {
+        this._grid?.download('trades', this._host.t('TradeHistory'));
+    }
+    // The blotter's single column declaration. The two id columns read `#42` on
+    // screen and export the bare number, so the sheet stays sortable as a number.
+    _columns() {
+        // `label`, not `t` — every row lambda below already binds `t` as the
+        // trade it is rendering, and a translator sharing that name would be
+        // shadowed inside exactly the callbacks that read it.
+        const label = (key) => this._host.t(key);
+        const presentation = this._host.presentation;
+        return [
+            {
+                key: 'id',
+                header: label('ID'),
+                exportable: true,
+                value: (t) => t.id,
+                render: (t) => '#' + t.id,
+                cellClass: () => 'mono-id',
+            },
+            {
+                key: 'time',
+                header: label('Time'),
+                exportable: true,
+                value: (t) => t.executedAt || t.time,
+                render: (t) => formatTime(t.executedAt || t.time),
+                exportValue: (t) => formatTime(t.executedAt || t.time),
+            },
+            {
+                key: 'symbol',
+                header: label('Sym'),
+                exportable: true,
+                value: (t) => t.instrumentSymbol || t.symbol,
+            },
+            {
+                key: 'side',
+                header: label('Side'),
+                exportable: true,
+                value: (t) => t.side,
+                render: (t) => presentation.sideText(t.side),
+                cellClass: (t) => presentation.sideClass(t.side),
+                exportValue: (t) => presentation.sideText(t.side),
+            },
+            {
+                key: 'quantity',
+                header: label('Qty'),
+                exportable: true,
+                value: (t) => t.quantity,
+                render: (t) => formatQty(t.quantity),
+            },
+            {
+                key: 'price',
+                header: label('Price'),
+                exportable: true,
+                value: (t) => t.price,
+                render: (t) => formatPrice(t.price),
+            },
+            {
+                key: 'order',
+                header: label('Order'),
+                exportable: true,
+                value: (t) => t.order || t.orderId,
+                render: (t) => '#' + (t.order || t.orderId || ''),
+                cellClass: () => 'mono-id',
+            },
+        ];
+    }
+}
+TradeHistoryWidget.TYPE = ControlTypes.TradeHistory;
+//# sourceMappingURL=trade-history-widget.js.map

package/dist/esm/trade-history-widget.js.map

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

package/dist/esm/trading-data.js

@@ -0,0 +1,26 @@
+// The rows the controls render.
+//
+// These are wire shapes, not domain models: the host fetches them from
+// whatever backend it has and hands them over, and this package only reads
+// them. That is why every field is optional. A server that omits `realizedPnl`
+// on a flat position, a snapshot row that predates a field, an optimistic
+// client-side insert carrying half a fill — all of them are ordinary here, and
+// every control already guards with `?? 0` / `|| ''` at the point of use. A
+// required field would only move that guard to the host, which cannot honour it
+// either.
+//
+// Two fields are deliberately unions rather than enums. `side` and `status`
+// arrive in more than one spelling depending on which endpoint produced the row
+// (a numeric StockSharp enum from the socket, a name from the DTO, an uppercase
+// name from the history endpoint), and normalising them is the host's job —
+// `TradingPresentation` is where that knowledge lives. Narrowing the type here
+// would only force a cast at every call site that is already correct.
+//
+// Every numeric field is `number | null` as well as optional, for the same
+// reason: an absent price reaches us as an omitted key from one endpoint and as
+// an explicit null from another, both meaning "not set". Saying so once here is
+// what lets the read sites stay the plain `?? 0` / `|| ''` they already were.
+//
+// This module has no imports and no behaviour.
+export {};
+//# sourceMappingURL=trading-data.js.map

package/dist/esm/trading-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-data.js","sourceRoot":"","sources":["../../src/trading-data.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,UAAU;AACV,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,+EAA+E;AAC/E,sEAAsE;AACtE,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,+CAA+C"}

package/dist/esm/trading-host.js

@@ -0,0 +1,79 @@
+/// The class names `TradingPresentation` is expected to return, as data.
+///
+/// Exported because it is a contract, not a detail: a host writing its own
+/// presentation reads this to know which names the shipped stylesheet already
+/// paints, and the style-contract check reads it to prove they are all styled.
+export const PRESENTATION_CLASSES = {
+    sideClass: ['side-buy', 'side-sell'],
+    pnlClass: ['pnl-positive', 'pnl-negative'],
+};
+/// How much of a symbol a control wants streamed. A quote row needs the last
+/// price, a tape needs every print, a ladder needs the book as well — and each
+/// costs the wire something different, so a control states which it is asking
+/// for rather than leaving the argument off and taking a default.
+export const MarketDataLevels = {
+    /// Level 1 only: best bid/ask and last price.
+    Quotes: 'l1only',
+    /// Level 1 plus every tick.
+    Tape: 'tape',
+    /// Level 1, ticks and market depth.
+    Full: 'full',
+};
+/// Prove a host object satisfies the port, and say precisely what is missing
+/// when it does not.
+///
+/// Called from every control's constructor before anything else, so a
+/// mis-wired host fails at construction with the member named, instead of at
+/// the first click that needed it.
+export function assertHost(host, controlName) {
+    _required(host, 'host', 'object', controlName);
+    _required(host.isPrimary, 'host.isPrimary', 'boolean', controlName);
+    _required(host.t, 'host.t', 'function', controlName);
+    _required(host.presentation, 'host.presentation', 'object', controlName);
+    _required(host.presentation.sideText, 'host.presentation.sideText', 'function', controlName);
+    _required(host.presentation.typeText, 'host.presentation.typeText', 'function', controlName);
+    _required(host.presentation.statusText, 'host.presentation.statusText', 'function', controlName);
+    _required(host.presentation.sideClass, 'host.presentation.sideClass', 'function', controlName);
+    _required(host.presentation.pnlClass, 'host.presentation.pnlClass', 'function', controlName);
+    _required(host.preferences, 'host.preferences', 'object', controlName);
+    _required(host.preferences.get, 'host.preferences.get', 'function', controlName);
+    _required(host.preferences.set, 'host.preferences.set', 'function', controlName);
+    _required(host.cache, 'host.cache', 'object', controlName);
+    _required(host.cache.get, 'host.cache.get', 'function', controlName);
+    _required(host.cache.set, 'host.cache.set', 'function', controlName);
+    _required(host.trading, 'host.trading', 'object', controlName);
+    _required(host.trading.api, 'host.trading.api', 'object', controlName);
+    // The calls, not just the objects holding them. An `api: {}` is the shape a
+    // half-wired host actually has — the object gets built, the methods get
+    // forgotten — so stopping at the object would skip exactly the members this
+    // function exists to catch.
+    _required(host.trading.api.getExecutions, 'host.trading.api.getExecutions', 'function', controlName);
+    _required(host.trading.api.searchInstruments, 'host.trading.api.searchInstruments', 'function', controlName);
+    _required(host.trading.marketData, 'host.trading.marketData', 'object', controlName);
+    _required(host.trading.marketData.addSymbol, 'host.trading.marketData.addSymbol', 'function', controlName);
+    _required(host.trading.marketData.removeSymbol, 'host.trading.marketData.removeSymbol', 'function', controlName);
+    _required(host.trading.marketData.resubscribe, 'host.trading.marketData.resubscribe', 'function', controlName);
+    _required(host.trading.marketData.getOrders, 'host.trading.marketData.getOrders', 'function', controlName);
+    _required(host.trading.portfolioId, 'host.trading.portfolioId', 'function', controlName);
+    _required(host.trading.pickInstrument, 'host.trading.pickInstrument', 'function', controlName);
+    _required(host.ticker, 'host.ticker', 'object', controlName);
+    _required(host.ticker.publish, 'host.ticker.publish', 'function', controlName);
+    _required(host.allow, 'host.allow', 'function', controlName);
+    _required(host.log, 'host.log', 'function', controlName);
+    _required(host.close, 'host.close', 'function', controlName);
+    _required(host.spawn, 'host.spawn', 'function', controlName);
+    _required(host.persistState, 'host.persistState', 'function', controlName);
+    _required(host.saveLayout, 'host.saveLayout', 'function', controlName);
+    _required(host.register, 'host.register', 'function', controlName);
+    _required(host.unregister, 'host.unregister', 'function', controlName);
+    _required(host.broadcast, 'host.broadcast', 'function', controlName);
+    return host;
+}
+// `typeof null` is 'object', which would let a null store through the object
+// checks — the one case worth spelling out, because null is exactly what an
+// unwired dependency looks like.
+function _required(value, path, kind, controlName) {
+    if (value === null || value === undefined || typeof value !== kind)
+        throw new Error(`${controlName}: ${path} is required`);
+}
+//# sourceMappingURL=trading-host.js.map

package/dist/esm/trading-host.js.map

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