dexbot 1.4.16 → 1.4.18

package/dist/analysis/bot_usage/kibana_bot_queries.js

@@ -0,0 +1,399 @@
+/**
+ * KIBANA BOT QUERIES
+ *
+ * Elasticsearch query builders for analyzing DEXBot / DEXBot2 order activity
+ * on the BitShares blockchain via the public Kibana instance.
+ *
+ * Data source:
+ *   https://kibana.bitshares.dev / bitshares-* index
+ *   Time field: block_data.block_time
+ *
+ * BitShares operation types used here:
+ *   1 = limit_order_create  (field: op_object.seller)
+ *   2 = limit_order_cancel  (field: op_object.fee_paying_account)
+ *   4 = fill_order          (field: op_object.account_id)
+ *
+ * Relevant ES field paths:
+ *   limit_order_create:
+ *     op_object.seller                    — account that placed the order
+ *     op_object.amount_to_sell.amount     — integer sell amount
+ *     op_object.amount_to_sell.asset_id   — sell asset ID (e.g. '1.3.0' = BTS)
+ *     op_object.min_to_receive.amount     — integer min-receive (= limit price numerator)
+ *     op_object.min_to_receive.asset_id   — receive asset ID
+ *     op_object.expiration                — ISO datetime
+ *
+ *   fill_order:
+ *     op_object.account_id                — whose order was filled
+ *     op_object.pays.amount / .asset_id   — what was paid
+ *     op_object.receives.amount / .asset_id — what was received
+ *     op_object.order_id                  — the limit order that filled
+ *
+ *   limit_order_cancel:
+ *     op_object.fee_paying_account        — account that cancelled
+ *     op_object.order                     — the order ID cancelled
+ */
+import { toIntervalLabel } from '../../market_adapter/interval_utils.js';
+import { kibanaSearch, DEFAULT_CONFIG as BASE_CONFIG } from '../../market_adapter/core/kibana_client.js';
+'use strict';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const OP_LIMIT_ORDER_CREATE = 1;
+const OP_LIMIT_ORDER_CANCEL = 2;
+const OP_FILL_ORDER = 4;
+const DEFAULT_CONFIG = {
+    ...BASE_CONFIG,
+    timeout: 25000,
+};
+// ─── Aggregation query builders (size:0, for counts & timelines) ───────────────
+/**
+ * Time-bucketed count of limit_order_create ops for an account.
+ * Optionally filtered to orders selling a specific asset.
+ */
+function buildOrderCreateQuery(accountId, lookbackHours, intervalSeconds = 3600, sellAssetId = null) {
+    const filters = [
+        { term: { operation_type: OP_LIMIT_ORDER_CREATE } },
+        { term: { 'operation_history.op_object.seller.keyword': accountId } },
+        { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+    ];
+    if (sellAssetId) {
+        filters.push({ term: { 'operation_history.op_object.amount_to_sell.asset_id.keyword': sellAssetId } });
+    }
+    return {
+        size: 0,
+        query: { bool: { filter: filters } },
+        aggs: {
+            by_time: {
+                date_histogram: {
+                    field: 'block_data.block_time',
+                    fixed_interval: toIntervalLabel(intervalSeconds),
+                    min_doc_count: 1,
+                },
+            },
+            total: { value_count: { field: 'operation_type' } },
+        },
+    };
+}
+/**
+ * Time-bucketed count of fill_order ops for an account.
+ * Optionally filtered to fills where account pays a specific asset.
+ */
+function buildFillOrderQuery(accountId, lookbackHours, intervalSeconds = 3600, paysAssetId = null) {
+    const filters = [
+        { term: { operation_type: OP_FILL_ORDER } },
+        { term: { 'operation_history.op_object.account_id.keyword': accountId } },
+        { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+    ];
+    if (paysAssetId) {
+        filters.push({ term: { 'operation_history.op_object.pays.asset_id.keyword': paysAssetId } });
+    }
+    return {
+        size: 0,
+        query: { bool: { filter: filters } },
+        aggs: {
+            by_time: {
+                date_histogram: {
+                    field: 'block_data.block_time',
+                    fixed_interval: toIntervalLabel(intervalSeconds),
+                    min_doc_count: 1,
+                },
+            },
+            total: { value_count: { field: 'operation_type' } },
+        },
+    };
+}
+/**
+ * Time-bucketed count of limit_order_cancel ops for an account.
+ */
+function buildOrderCancelQuery(accountId, lookbackHours, intervalSeconds = 3600) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { term: { operation_type: OP_LIMIT_ORDER_CANCEL } },
+                    { term: { 'operation_history.op_object.fee_paying_account.keyword': accountId } },
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            by_time: {
+                date_histogram: {
+                    field: 'block_data.block_time',
+                    fixed_interval: toIntervalLabel(intervalSeconds),
+                    min_doc_count: 1,
+                },
+            },
+            total: { value_count: { field: 'operation_type' } },
+        },
+    };
+}
+/**
+ * Daily activity breakdown by operation type for an account.
+ * Merges creates (by seller), fills (by account_id), cancels (by fee_paying_account)
+ * into one aggregation using a filter per op type.
+ */
+function buildDailyActivityQuery(accountId, lookbackHours) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            creates: {
+                filter: {
+                    bool: {
+                        filter: [
+                            { term: { operation_type: OP_LIMIT_ORDER_CREATE } },
+                            { term: { 'operation_history.op_object.seller.keyword': accountId } },
+                        ],
+                    },
+                },
+                aggs: {
+                    by_day: {
+                        date_histogram: { field: 'block_data.block_time', fixed_interval: '1d', min_doc_count: 1 },
+                    },
+                },
+            },
+            fills: {
+                filter: {
+                    bool: {
+                        filter: [
+                            { term: { operation_type: OP_FILL_ORDER } },
+                            { term: { 'operation_history.op_object.account_id.keyword': accountId } },
+                        ],
+                    },
+                },
+                aggs: {
+                    by_day: {
+                        date_histogram: { field: 'block_data.block_time', fixed_interval: '1d', min_doc_count: 1 },
+                    },
+                },
+            },
+            cancels: {
+                filter: {
+                    bool: {
+                        filter: [
+                            { term: { operation_type: OP_LIMIT_ORDER_CANCEL } },
+                            { term: { 'operation_history.op_object.fee_paying_account.keyword': accountId } },
+                        ],
+                    },
+                },
+                aggs: {
+                    by_day: {
+                        date_histogram: { field: 'block_data.block_time', fixed_interval: '1d', min_doc_count: 1 },
+                    },
+                },
+            },
+        },
+    };
+}
+// ─── Raw document query builders (size>0, for price/grid analysis) ────────────
+/**
+ * Fetch raw limit_order_create documents for grid spacing analysis.
+ * Returns the price-relevant fields plus timestamps.
+ *
+ * @param {string}  accountId
+ * @param {number}  lookbackHours
+ * @param {string}  [sellAssetId]   - optional: filter to one sell-side asset
+ * @param {number}  [maxResults]
+ * @returns {Object} Elasticsearch query object
+ */
+function buildOrderPriceQuery(accountId, lookbackHours, sellAssetId = null, maxResults = 1000) {
+    const filters = [
+        { term: { operation_type: OP_LIMIT_ORDER_CREATE } },
+        { term: { 'operation_history.op_object.seller.keyword': accountId } },
+        { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+    ];
+    if (sellAssetId) {
+        filters.push({ term: { 'operation_history.op_object.amount_to_sell.asset_id.keyword': sellAssetId } });
+    }
+    return {
+        size: maxResults,
+        _source: [
+            'block_data.block_time',
+            'operation_history.op_object.amount_to_sell',
+            'operation_history.op_object.min_to_receive',
+            'operation_history.op_object.expiration',
+        ],
+        query: { bool: { filter: filters } },
+        sort: [{ 'block_data.block_time': { order: 'desc' } }],
+    };
+}
+/**
+ * Fetch raw fill_order documents for fill-price analysis.
+ *
+ * @param {string}  accountId
+ * @param {number}  lookbackHours
+ * @param {string}  [paysAssetId]
+ * @param {number}  [maxResults]
+ * @returns {Object} Elasticsearch query object
+ */
+function buildFillPriceQuery(accountId, lookbackHours, paysAssetId = null, maxResults = 500) {
+    const filters = [
+        { term: { operation_type: OP_FILL_ORDER } },
+        { term: { 'operation_history.op_object.account_id.keyword': accountId } },
+        { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+    ];
+    if (paysAssetId) {
+        filters.push({ term: { 'operation_history.op_object.pays.asset_id.keyword': paysAssetId } });
+    }
+    return {
+        size: maxResults,
+        _source: [
+            'block_data.block_time',
+            'operation_history.op_object.pays',
+            'operation_history.op_object.receives',
+            'operation_history.op_object.order_id',
+        ],
+        query: { bool: { filter: filters } },
+        sort: [{ 'block_data.block_time': { order: 'desc' } }],
+    };
+}
+/**
+ * Discover which asset pairs an account trades by aggregating the sell asset IDs.
+ * Returns top asset IDs by order count.
+ */
+function buildAssetDiscoveryQuery(accountId, lookbackHours) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { term: { operation_type: OP_LIMIT_ORDER_CREATE } },
+                    { term: { 'operation_history.op_object.seller.keyword': accountId } },
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            sell_assets: {
+                terms: {
+                    field: 'operation_history.op_object.amount_to_sell.asset_id.keyword',
+                    size: 10,
+                },
+            },
+            recv_assets: {
+                terms: {
+                    field: 'operation_history.op_object.min_to_receive.asset_id.keyword',
+                    size: 10,
+                },
+            },
+        },
+    };
+}
+// ─── Fetch helpers ────────────────────────────────────────────────────────────
+async function fetchOrderCreate(accountId, lookbackHours, config = {}, sellAssetId = null, intervalSeconds = 3600) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildOrderCreateQuery(accountId, lookbackHours, intervalSeconds, sellAssetId));
+}
+async function fetchFillOrder(accountId, lookbackHours, config = {}, paysAssetId = null, intervalSeconds = 3600) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildFillOrderQuery(accountId, lookbackHours, intervalSeconds, paysAssetId));
+}
+async function fetchOrderCancel(accountId, lookbackHours, config = {}, intervalSeconds = 3600) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildOrderCancelQuery(accountId, lookbackHours, intervalSeconds));
+}
+async function fetchOrderPrices(accountId, lookbackHours, config = {}, sellAssetId = null, maxResults = 1000) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildOrderPriceQuery(accountId, lookbackHours, sellAssetId, maxResults));
+}
+async function fetchFillPrices(accountId, lookbackHours, config = {}, paysAssetId = null, maxResults = 500) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildFillPriceQuery(accountId, lookbackHours, paysAssetId, maxResults));
+}
+async function fetchDailyActivity(accountId, lookbackHours, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildDailyActivityQuery(accountId, lookbackHours));
+}
+async function fetchAssetDiscovery(accountId, lookbackHours, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    return kibanaSearch(cfg, buildAssetDiscoveryQuery(accountId, lookbackHours));
+}
+// ─── Discovery query builders ─────────────────────────────────────────────────
+/**
+ * Top N accounts by limit_order_create count (seller field).
+ * Use this to discover the most active order-placing accounts.
+ */
+function buildTopSellerAccountsQuery(lookbackHours, topN = 100, minCreates = 10) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { term: { operation_type: OP_LIMIT_ORDER_CREATE } },
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            by_account: {
+                terms: {
+                    field: 'operation_history.op_object.seller.keyword',
+                    size: topN,
+                    min_doc_count: minCreates,
+                    order: { _count: 'desc' },
+                },
+            },
+        },
+    };
+}
+/**
+ * Top N accounts by limit_order_cancel count (fee_paying_account field).
+ */
+function buildTopCancellerAccountsQuery(lookbackHours, topN = 100, minCancels = 5) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { term: { operation_type: OP_LIMIT_ORDER_CANCEL } },
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            by_account: {
+                terms: {
+                    field: 'operation_history.op_object.fee_paying_account.keyword',
+                    size: topN,
+                    min_doc_count: minCancels,
+                    order: { _count: 'desc' },
+                },
+            },
+        },
+    };
+}
+/**
+ * Top N accounts by fill_order count (account_id field).
+ */
+function buildTopFilledAccountsQuery(lookbackHours, topN = 100, minFills = 3) {
+    return {
+        size: 0,
+        query: {
+            bool: {
+                filter: [
+                    { term: { operation_type: OP_FILL_ORDER } },
+                    { range: { 'block_data.block_time': { gte: `now-${lookbackHours}h`, lte: 'now' } } },
+                ],
+            },
+        },
+        aggs: {
+            by_account: {
+                terms: {
+                    field: 'operation_history.op_object.account_id.keyword',
+                    size: topN,
+                    min_doc_count: minFills,
+                    order: { _count: 'desc' },
+                },
+            },
+        },
+    };
+}
+// ─── Exports ──────────────────────────────────────────────────────────────────
+export { OP_LIMIT_ORDER_CREATE, OP_LIMIT_ORDER_CANCEL, OP_FILL_ORDER, DEFAULT_CONFIG, kibanaSearch, buildOrderCreateQuery, buildFillOrderQuery, buildOrderCancelQuery, buildDailyActivityQuery, buildAssetDiscoveryQuery, buildOrderPriceQuery, buildFillPriceQuery, fetchOrderCreate, fetchFillOrder, fetchOrderCancel, fetchOrderPrices, fetchFillPrices, fetchDailyActivity, fetchAssetDiscovery, buildTopSellerAccountsQuery, buildTopCancellerAccountsQuery, buildTopFilledAccountsQuery };
+//# sourceMappingURL=kibana_bot_queries.js.map

package/dist/analysis/bot_usage/kibana_bot_queries.js.map

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

package/dist/analysis/chart_css.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared CSS fragments for uPlot chart generators.
+ *
+ * All functions return raw CSS strings for interpolation into HTML template
+ * literals. Consumers compose these fragments inside their `<style>` blocks.
+ */
+declare function baseResetCSS(): string;
+declare function headerCSS(height?: number): string;
+declare function panelsCSS(headerHeight?: number): string;
+declare function uplotBgCSS(): string;
+declare function dotCSS(): string;
+declare function cursorCSS(): string;
+declare function sectionLabelCSS(): string;
+declare function legendCSS(): string;
+declare function sharedChartCSS(): string;
+export { baseResetCSS, headerCSS, panelsCSS, uplotBgCSS, dotCSS, cursorCSS, sectionLabelCSS, legendCSS, sharedChartCSS };
+//# sourceMappingURL=chart_css.d.ts.map

package/dist/analysis/chart_css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_css.d.ts","sourceRoot":"","sources":["../../analysis/chart_css.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,iBAAS,YAAY,IAAI,MAAM,CAG9B;AAED,iBAAS,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAEtC;AAED,iBAAS,SAAS,CAAC,YAAY,SAAK,GAAG,MAAM,CAE5C;AAED,iBAAS,UAAU,IAAI,MAAM,CAE5B;AAED,iBAAS,MAAM,IAAI,MAAM,CAExB;AAED,iBAAS,SAAS,IAAI,MAAM,CAI3B;AAED,iBAAS,eAAe,IAAI,MAAM,CAEjC;AAED,iBAAS,SAAS,IAAI,MAAM,CAG3B;AAED,iBAAS,cAAc,IAAI,MAAM,CAWhC;AAED,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,CAAA"}

package/dist/analysis/chart_css.js

@@ -0,0 +1,49 @@
+'use strict';
+/**
+ * Shared CSS fragments for uPlot chart generators.
+ *
+ * All functions return raw CSS strings for interpolation into HTML template
+ * literals. Consumers compose these fragments inside their `<style>` blocks.
+ */
+function baseResetCSS() {
+    return `* { box-sizing: border-box; }
+        body { background: #0b0e14; color: #d1d5db; font-family: 'Segoe UI', sans-serif; margin: 0; padding: 0; overflow: hidden; }`;
+}
+function headerCSS(height = 45) {
+    return `#header { padding: 10px 20px; background: #161b22; border-bottom: 1px solid #30363d; display: flex; align-items: center; justify-content: space-between; height: ${height}px; z-index: 100; }`;
+}
+function panelsCSS(headerHeight = 45) {
+    return `#panels { display: flex; flex-direction: column; height: calc(100vh - ${headerHeight}px); width: 100vw; }`;
+}
+function uplotBgCSS() {
+    return `.uplot { background: #0b0e14; }`;
+}
+function dotCSS() {
+    return `.dot { width: 10px; height: 10px; border-radius: 2px; flex-shrink: 0; }`;
+}
+function cursorCSS() {
+    return `.u-cursor-x { border-left: 1px dashed rgba(255,255,255,0.3) !important; }
+        .u-cursor-y { border-top:  1px dashed rgba(255,255,255,0.3) !important; display: none; }
+        .is-hovered .u-cursor-y { display: block; }`;
+}
+function sectionLabelCSS() {
+    return `.section-label { position: absolute; top: 8px; right: 12px; font-size: 9px; color: #30363d; text-transform: uppercase; letter-spacing: 1px; z-index: 10; pointer-events: none; }`;
+}
+function legendCSS() {
+    return `.legend { position: absolute; top: 8px; left: 12px; font-size: 11px; pointer-events: none; z-index: 10; display: flex; gap: 14px; color: #adbac7; white-space: nowrap; align-items: center; }
+        .legend-item { display: flex; align-items: center; gap: 5px; }`;
+}
+function sharedChartCSS() {
+    return [
+        baseResetCSS(),
+        headerCSS(),
+        panelsCSS(),
+        uplotBgCSS(),
+        dotCSS(),
+        cursorCSS(),
+        sectionLabelCSS(),
+        legendCSS(),
+    ].join('\n        ');
+}
+export { baseResetCSS, headerCSS, panelsCSS, uplotBgCSS, dotCSS, cursorCSS, sectionLabelCSS, legendCSS, sharedChartCSS };
+//# sourceMappingURL=chart_css.js.map

package/dist/analysis/chart_css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_css.js","sourceRoot":"","sources":["../../analysis/chart_css.ts"],"names":[],"mappings":"AACA,YAAY,CAAC;AAEb;;;;;GAKG;AAEH,SAAS,YAAY;IACjB,OAAO;oIACyH,CAAC;AACrI,CAAC;AAED,SAAS,SAAS,CAAC,MAAM,GAAG,EAAE;IAC1B,OAAO,oKAAoK,MAAM,qBAAqB,CAAC;AAC3M,CAAC;AAED,SAAS,SAAS,CAAC,YAAY,GAAG,EAAE;IAChC,OAAO,yEAAyE,YAAY,sBAAsB,CAAC;AACvH,CAAC;AAED,SAAS,UAAU;IACf,OAAO,iCAAiC,CAAC;AAC7C,CAAC;AAED,SAAS,MAAM;IACX,OAAO,yEAAyE,CAAC;AACrF,CAAC;AAED,SAAS,SAAS;IACd,OAAO;;oDAEyC,CAAC;AACrD,CAAC;AAED,SAAS,eAAe;IACpB,OAAO,kLAAkL,CAAC;AAC9L,CAAC;AAED,SAAS,SAAS;IACd,OAAO;uEAC4D,CAAC;AACxE,CAAC;AAED,SAAS,cAAc;IACnB,OAAO;QACH,YAAY,EAAE;QACd,SAAS,EAAE;QACX,SAAS,EAAE;QACX,UAAU,EAAE;QACZ,MAAM,EAAE;QACR,SAAS,EAAE;QACX,eAAe,EAAE;QACjB,SAAS,EAAE;KACd,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,CAAA"}

package/dist/analysis/chart_ui.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared browser-side JavaScript helpers for uPlot chart generators.
+ *
+ * All functions return raw JS code strings for interpolation into inline
+ * `<script>` template literals. Consumers embed these alongside their own
+ * chart-specific logic.
+ */
+declare const Y_AXIS_SIZE = 58;
+/**
+ * Return the uPlot cursor config object literal.
+ * Consumers must define `SYNC_KEY` before calling this.
+ */
+declare function makeCursorConfig(): string;
+/**
+ * Return the `bindHoverState(chart)` function definition.
+ */
+declare function bindHoverStateFn(): string;
+/**
+ * Return the `fmtDate(ts)` browser-side function definition.
+ */
+declare function fmtDateFn(): string;
+/**
+ * Return the chart event wiring loop that binds mousemove, mouseleave,
+ * hover-state, wheelZoom, and pan on each chart.
+ *
+ * @param chartsVar  JS variable name holding the charts array (e.g. `'charts'`)
+ * @param updateFn   name of the legend update function (e.g. `'updateLegend'`)
+ * @param fallback   expression for the mouseleave fallback index
+ *                   (e.g. `'lastLiveIdx'`, `'null'`, or `'shiftChart.cursor.idx ?? data.realBarCount - 1'`)
+ */
+declare function wireChartEvents(chartsVar: string, updateFn: string, fallback: string): string;
+/**
+ * Return the Ctrl+0 zoom-reset keyboard shortcut handler.
+ * Consumers must define `xMin`, `xMax`, and `syncXRange` before calling this.
+ */
+declare function zoomResetScript(): string;
+/**
+ * Return the `sizeCharts()` function definition.
+ *
+ * @param pairs  array of [chartVariableName, panelDomId] pairs
+ *               e.g. `[['priceChart', 'price-panel'], ['kalmanChart', 'kalman-panel']]`
+ */
+declare function sizeChartsFn(pairs: Array<[string, string]>): string;
+export { Y_AXIS_SIZE, makeCursorConfig, bindHoverStateFn, fmtDateFn, wireChartEvents, zoomResetScript, sizeChartsFn };
+//# sourceMappingURL=chart_ui.d.ts.map

package/dist/analysis/chart_ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_ui.d.ts","sourceRoot":"","sources":["../../analysis/chart_ui.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,QAAA,MAAM,WAAW,KAAK,CAAC;AAEvB;;;GAGG;AACH,iBAAS,gBAAgB,IAAI,MAAM,CAUlC;AAED;;GAEG;AACH,iBAAS,gBAAgB,IAAI,MAAM,CAMlC;AAED;;GAEG;AACH,iBAAS,SAAS,IAAI,MAAM,CAO3B;AAED;;;;;;;;GAQG;AACH,iBAAS,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CActF;AAED;;;GAGG;AACH,iBAAS,eAAe,IAAI,MAAM,CAIjC;AAED;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAU5D;AAED,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA"}

package/dist/analysis/chart_ui.js

@@ -0,0 +1,97 @@
+'use strict';
+/**
+ * Shared browser-side JavaScript helpers for uPlot chart generators.
+ *
+ * All functions return raw JS code strings for interpolation into inline
+ * `<script>` template literals. Consumers embed these alongside their own
+ * chart-specific logic.
+ */
+const Y_AXIS_SIZE = 58;
+/**
+ * Return the uPlot cursor config object literal.
+ * Consumers must define `SYNC_KEY` before calling this.
+ */
+function makeCursorConfig() {
+    return `{
+            show: true,
+            x: true,
+            y: true,
+            points: { show: false },
+            drag: { x: false, y: false, setScale: false },
+            sync: { key: SYNC_KEY, setSeries: false, scales: ['x', null] },
+            focus: { prox: -1 },
+        }`;
+}
+/**
+ * Return the `bindHoverState(chart)` function definition.
+ */
+function bindHoverStateFn() {
+    return `function bindHoverState(chart) {
+            const root = chart.root;
+            root.addEventListener('mouseenter', () => root.classList.add('is-hovered'));
+            root.addEventListener('mouseleave', () => root.classList.remove('is-hovered'));
+        }`;
+}
+/**
+ * Return the `fmtDate(ts)` browser-side function definition.
+ */
+function fmtDateFn() {
+    return `function fmtDate(ts) {
+            if (ts == null) return '-';
+            const d = new Date(ts * 1000);
+            return d.toLocaleDateString('en-GB', { day: '2-digit', month: 'short', year: '2-digit' })
+                 + ' ' + d.toLocaleTimeString('en-GB', { hour: '2-digit', minute: '2-digit' });
+        }`;
+}
+/**
+ * Return the chart event wiring loop that binds mousemove, mouseleave,
+ * hover-state, wheelZoom, and pan on each chart.
+ *
+ * @param chartsVar  JS variable name holding the charts array (e.g. `'charts'`)
+ * @param updateFn   name of the legend update function (e.g. `'updateLegend'`)
+ * @param fallback   expression for the mouseleave fallback index
+ *                   (e.g. `'lastLiveIdx'`, `'null'`, or `'shiftChart.cursor.idx ?? data.realBarCount - 1'`)
+ */
+function wireChartEvents(chartsVar, updateFn, fallback) {
+    return `let leavePending = null;
+            ${chartsVar}.forEach(chart => {
+                chart.over.addEventListener('mousemove', () => {
+                    if (leavePending !== null) { clearTimeout(leavePending); leavePending = null; }
+                    ${updateFn}(chart.cursor.idx);
+                });
+                chart.over.addEventListener('mouseleave', () => {
+                    leavePending = setTimeout(() => { leavePending = null; ${updateFn}(${fallback}); }, 60);
+                });
+                bindHoverState(chart);
+                bindWheelZoom(chart);
+                bindPan(chart);
+            });`;
+}
+/**
+ * Return the Ctrl+0 zoom-reset keyboard shortcut handler.
+ * Consumers must define `xMin`, `xMax`, and `syncXRange` before calling this.
+ */
+function zoomResetScript() {
+    return `window.addEventListener('keydown', (e) => {
+            if ((e.ctrlKey || e.metaKey) && e.key === '0') syncXRange(xMin, xMax);
+        });`;
+}
+/**
+ * Return the `sizeCharts()` function definition.
+ *
+ * @param pairs  array of [chartVariableName, panelDomId] pairs
+ *               e.g. `[['priceChart', 'price-panel'], ['kalmanChart', 'kalman-panel']]`
+ */
+function sizeChartsFn(pairs) {
+    const entries = pairs.map(([chartVar, panelId]) => `[${chartVar}, '${panelId}']`).join(', ');
+    const nullCheck = pairs.map(([chartVar]) => `!${chartVar}`).join(' || ');
+    return `function sizeCharts() {
+            if (${nullCheck}) return;
+            [${entries}].forEach(([chart, id]) => {
+                const el = document.getElementById(id);
+                chart.setSize({ width: el.offsetWidth, height: el.offsetHeight });
+            });
+        }`;
+}
+export { Y_AXIS_SIZE, makeCursorConfig, bindHoverStateFn, fmtDateFn, wireChartEvents, zoomResetScript, sizeChartsFn };
+//# sourceMappingURL=chart_ui.js.map

package/dist/analysis/chart_ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_ui.js","sourceRoot":"","sources":["../../analysis/chart_ui.ts"],"names":[],"mappings":"AACA,YAAY,CAAC;AAEb;;;;;;GAMG;AAEH,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;GAGG;AACH,SAAS,gBAAgB;IACrB,OAAO;;;;;;;;UAQD,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACrB,OAAO;;;;UAID,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,SAAS;IACd,OAAO;;;;;UAKD,CAAC;AACX,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,SAAiB,EAAE,QAAgB,EAAE,QAAgB;IAC1E,OAAO;cACG,SAAS;;;sBAGD,QAAQ;;;6EAG+C,QAAQ,IAAI,QAAQ;;;;;gBAKjF,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe;IACpB,OAAO;;YAEC,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAA8B;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;kBACO,SAAS;eACZ,OAAO;;;;UAIZ,CAAC;AACX,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA"}

package/dist/analysis/derivative_chart_generator.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+declare function parseArgs(argv?: string[]): {
+    inputFile: string | null;
+    outputFile: string;
+    title: string;
+    quiet: boolean;
+};
+declare function showHelp(): void;
+declare function trendToNum(trend: string): 0 | 1 | -1;
+declare function generateHTML(data: any, title: string): string;
+export { generateHTML, parseArgs, showHelp, trendToNum };
+//# sourceMappingURL=derivative_chart_generator.d.ts.map

package/dist/analysis/derivative_chart_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivative_chart_generator.d.ts","sourceRoot":"","sources":["../../analysis/derivative_chart_generator.ts"],"names":[],"mappings":";AAWA,iBAAS,SAAS,CAAC,IAAI,WAAwB;eACnB,MAAM,GAAG,IAAI;gBAAc,MAAM;WAAS,MAAM;WAAS,OAAO;EAuB3F;AACD,iBAAS,QAAQ,SAUhB;AACD,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,cAIhC;AAmBD,iBAAS,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,UAmxB7C;AAeD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA"}