@orangecharts/wrun-chart-host 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +6 -1
  3. package/dist/constants/feature-flags.constants.js +67 -24
  4. package/dist/constants/opra-compliance.constants.d.ts +3 -2
  5. package/dist/constants/opra-compliance.constants.js +3 -2
  6. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  7. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  8. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  9. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  10. package/dist/constants/venue-presets.constants.d.ts +20 -20
  11. package/dist/constants/venue-presets.constants.js +24 -26
  12. package/dist/host-env.d.ts +29 -5
  13. package/dist/host-env.js +6 -0
  14. package/dist/host-ports.types.d.ts +69 -15
  15. package/dist/index.d.ts +13 -0
  16. package/dist/index.js +13 -0
  17. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  18. package/dist/interfaces/replay.interface.d.ts +8 -0
  19. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  20. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +41 -4
  21. package/dist/kscript-data/controls/live-trades-merge.util.js +52 -7
  22. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +56 -0
  23. package/dist/kscript-data/controls/live-trades-order-gate.util.js +107 -0
  24. package/dist/market-data/billing.interface.d.ts +95 -31
  25. package/dist/market-data/billing.interface.js +36 -5
  26. package/dist/market-data/venue.d.ts +88 -6
  27. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  28. package/dist/market-data/venues/cme.d.ts +126 -0
  29. package/dist/market-data/venues/cme.js +133 -0
  30. package/dist/market-data/venues/index.d.ts +162 -5
  31. package/dist/market-data/venues/index.js +48 -6
  32. package/dist/settings-templates/index.js +7 -3
  33. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  34. package/dist/settings-templates/indicator-fields.js +45 -6
  35. package/dist/settings-templates/tool-rules.d.ts +27 -17
  36. package/dist/settings-templates/tool-rules.js +27 -11
  37. package/dist/settings-templates/tool-tables.generated.js +91 -31
  38. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  39. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  40. package/dist/utility/chart/index-mode-admission.util.js +15 -2
  41. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  42. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  43. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +7 -2
  44. package/dist/utility/chart/kscript-live-coalesce.util.js +9 -3
  45. package/dist/utility/chart/kscript-provenance-keys.util.js +6 -0
  46. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  47. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  48. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  49. package/dist/utility/chart/kscript-venue-policy.util.d.ts +54 -35
  50. package/dist/utility/chart/kscript-venue-policy.util.js +78 -42
  51. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  52. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  53. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  54. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  55. package/dist/utility/chart/rth-session.util.d.ts +3 -2
  56. package/dist/utility/chart/rth-session.util.js +2 -1
  57. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  58. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  59. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  60. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  61. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  62. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  63. package/dist/utility/options/option-venue.util.d.ts +18 -0
  64. package/dist/utility/options/option-venue.util.js +27 -0
  65. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  66. package/dist/utility/wrun/derived-roots.util.d.ts +213 -0
  67. package/dist/utility/wrun/derived-roots.util.js +471 -0
  68. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +41 -6
  69. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  70. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  71. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  72. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  73. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  74. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  75. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  76. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  77. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  78. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  79. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  80. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  81. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  82. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  83. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  84. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  85. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  86. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  87. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  88. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +39 -10
  89. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +64 -0
  90. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +89 -0
  91. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  92. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  93. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  94. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +174 -13
  95. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +685 -27
  96. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  97. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  98. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +53 -12
  99. package/dist/utility/wrun/wrun-chart-market-facts.util.js +101 -53
  100. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  101. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  102. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  103. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  104. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  105. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  106. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  107. package/dist/utility/wrun/wrun-frames.js +73 -10
  108. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  109. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  110. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  111. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  112. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  113. package/dist/utility/wrun/wrun-live-intake.util.d.ts +13 -7
  114. package/dist/utility/wrun/wrun-live-intake.util.js +82 -29
  115. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -0
  116. package/dist/utility/wrun/wrun-live-tick.util.js +158 -14
  117. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +49 -10
  118. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +65 -5
  119. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  120. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  121. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  122. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  123. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  124. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  125. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  126. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  127. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  128. package/dist/utility/wrun/wrun-option-views.util.d.ts +47 -13
  129. package/dist/utility/wrun/wrun-option-views.util.js +98 -26
  130. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  131. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  132. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +17 -0
  133. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  134. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  135. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +100 -31
  136. package/dist/utility/wrun/wrun-overlay-run.util.js +733 -114
  137. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  138. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  139. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  140. package/dist/utility/wrun/wrun-panel-mount.util.js +63 -13
  141. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  142. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  143. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  144. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  145. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  146. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  147. package/dist/utility/wrun/wrun-pin-spelling.util.js +12 -11
  148. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  149. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  150. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  151. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  152. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  153. package/dist/utility/wrun/wrun-run-interval.util.d.ts +4 -2
  154. package/dist/utility/wrun/wrun-run-interval.util.js +9 -6
  155. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  156. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  157. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  158. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  159. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  160. package/dist/utility/wrun/wrun-socket-row-source.js +113 -8
  161. package/dist/utility/wrun/wrun-source-rows.util.d.ts +5 -1
  162. package/dist/utility/wrun/wrun-source-rows.util.js +16 -3
  163. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  164. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  165. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  166. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  167. package/dist/utility/wrun/wrun-tape-per-order.util.js +26 -0
  168. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  169. package/dist/utils/replay/replay-buffer-math.js +227 -20
  170. package/package.json +11 -11
@@ -1,6 +1,9 @@
1
1
  import { Intervals } from '../../constants/interval.constants.js';
2
2
  import { intervalLabelForMs } from '../../utility/chart/interval-registry.util.js';
3
3
  import { CANDLE_TICK_BACKFILL_SEC, FALLBACK_VIEW_BEHIND_MS, FOLLOW_SPAN_ECHO_TOLERANCE_BARS, MONDAY_BUCKET_ORIGIN_MS, REPLAY_COARSE_FORWARD_BATCH, REPLAY_FOLLOW_RIGHT_OFFSET_FRACTION, REPLAY_FORWARD_BATCH, } from '../../constants/replay-ladder.leaf.js';
4
+ import { barEndMs, calendarMonthsOfMs } from '../../utility/chart/calendar-interval.util.js';
5
+ import { cmeSessionBarEndMs, cmeSessionBarOpenMs } from '../../utility/chart/cme-session-bucket.util.js';
6
+ import { cmeSessionLatticeBucketMs, liveBucketStartMs, } from '../../utility/chart/live-bucket.util.js';
4
7
  import { replayResolutionBookEdgeSec, replayResolutionStepMs, tfLabelForMs } from '../../replay/replayLadder.js';
5
8
  const DAY_MS = Intervals.DAY;
6
9
  const WEEK_MS = Intervals.WEEK;
@@ -282,7 +285,8 @@ export function pruneTickCandleRows(buffer, playheadMs, chartIntervalMs = Interv
282
285
  if (!buffer.subRows?.length) {
283
286
  return;
284
287
  }
285
- const anchorBucketStartMs = alignChartBucketMs(buffer.anchorMs, chartIntervalMs);
288
+ const venue = buffer.barVenue ?? null;
289
+ const anchorBucketStartMs = chartBucketOpenMs(buffer.anchorMs, chartIntervalMs, venue);
286
290
  if (!replayUsesSubRowRail(buffer, chartIntervalMs) &&
287
291
  !isIrregularReplayBuffer(buffer) &&
288
292
  buffer.anchorMs === anchorBucketStartMs) {
@@ -291,13 +295,13 @@ export function pruneTickCandleRows(buffer, playheadMs, chartIntervalMs = Interv
291
295
  // rail is ACTIVE those same rows are the anchor bucket's forming source: pruning them
292
296
  // froze the last candle for the whole first bucket and made coverage refetch the
293
297
  // window every tick (fetch -> merge -> prune loop).
294
- const settledAnchorBucketEndMs = anchorBucketStartMs + chartIntervalMs;
298
+ const settledAnchorBucketEndMs = chartBucketEndMs(buffer.anchorMs, chartIntervalMs, venue);
295
299
  buffer.subRows = buffer.subRows.filter((row) => typeof row[0] === 'number' && Number.isFinite(row[0]) && row[0] >= settledAnchorBucketEndMs);
296
300
  }
297
301
  if (buffer.tf.kind !== 'tick' || !buffer.subRows.length) {
298
302
  return;
299
303
  }
300
- const activeBucketStartMs = alignChartBucketMs(playheadMs, chartIntervalMs);
304
+ const activeBucketStartMs = chartBucketOpenMs(playheadMs, chartIntervalMs, venue);
301
305
  const minTs = Math.min(activeBucketStartMs, playheadMs - CANDLE_TICK_BACKFILL_SEC * 1000);
302
306
  buffer.subRows = buffer.subRows.filter((row) => typeof row[0] === 'number' && row[0] >= minTs);
303
307
  }
@@ -409,30 +413,71 @@ export function replaySubRowsHoldFormingRow(buffer, playheadMs, chartIntervalMs,
409
413
  const subRows = buffer.subRows;
410
414
  if (!subRows?.length)
411
415
  return false;
412
- const activeBucketStartMs = alignChartBucketMs(playheadMs, chartIntervalMs);
416
+ const venue = buffer.barVenue ?? null;
417
+ const activeBarMs = replayBarKeyMs(playheadMs, chartIntervalMs, venue);
418
+ if (activeBarMs === null)
419
+ return false;
420
+ const activeBucketStartMs = replayBarOpenMs(activeBarMs, chartIntervalMs, venue);
413
421
  const tickRail = buffer.tf.kind === 'tick';
414
422
  const formingFromMs = tickRail
415
423
  ? Math.max(activeBucketStartMs, Math.floor(playheadMs / stepMs) * stepMs)
416
424
  : activeBucketStartMs;
417
- const firstRow = subRows[sortedLowerBound(subRows, formingFromMs, (row) => row[0])];
418
- if (firstRow === undefined)
419
- return false;
420
- return tickRail ? firstRow[0] <= playheadMs : firstRow[0] + subSourceIntervalMs <= playheadMs;
425
+ // The first row the grid books to the active bar (a fall-back night interleaves other bars' rows).
426
+ const barOf = replayBarKeyReader(chartIntervalMs, venue);
427
+ for (let index = sortedLowerBound(subRows, formingFromMs, (row) => row[0]); index < subRows.length; index++) {
428
+ const rowMs = subRows[index][0];
429
+ if (rowMs > playheadMs)
430
+ return false;
431
+ const barMs = barOf(rowMs);
432
+ if (barMs !== activeBarMs && barMs !== null)
433
+ continue;
434
+ return tickRail ? rowMs <= playheadMs : rowMs + subSourceIntervalMs <= playheadMs;
435
+ }
436
+ return false;
421
437
  }
422
438
  export function formingChartRowFromSubRows(buffer, chartIntervalMs, targetMs) {
423
439
  if (!buffer.subRows?.length) {
424
440
  return null;
425
441
  }
426
- const bucketStartMs = alignChartBucketMs(targetMs, chartIntervalMs);
442
+ // The bar holding the target on the chart's own grid (none outside its session): keyed by
443
+ // replayBarKeyMs, folded from its OPEN (a CME trade date keyed 00:00Z opens at the 17:00 Chicago
444
+ // open the evening before) out of the rows the grid books to it, never a contiguous range: on the
445
+ // fall-back night a CME 45m bar's rows interleave with two other bars'.
446
+ const venue = buffer.barVenue ?? null;
447
+ const bucketKeyMs = replayBarKeyMs(targetMs, chartIntervalMs, venue);
448
+ if (bucketKeyMs === null)
449
+ return null;
450
+ const bucketOpenMs = replayBarOpenMs(bucketKeyMs, chartIntervalMs, venue);
427
451
  // Tick rows are point-in-time events and retain their existing inclusive reveal semantics.
428
452
  // Bar-lane source rows are start-stamped and become playable only after their source interval closes.
429
453
  const completionOffsetMs = buffer.tf.kind === 'tick' ? 0 : replaySubSourceIntervalMs(buffer, chartIntervalMs);
430
- const startIndex = sortedLowerBound(buffer.subRows, bucketStartMs, (row) => row[0]);
454
+ const startIndex = sortedLowerBound(buffer.subRows, bucketOpenMs, (row) => row[0]);
431
455
  const endIndex = sortedPrefixEnd(buffer.subRows, targetMs - completionOffsetMs, (row) => row[0], true);
432
- const rows = aggregateOhlcvRows(buffer.subRows.slice(startIndex, endIndex), chartIntervalMs, bucketStartMs, targetMs, {
433
- originMs: chartBucketOriginMs(chartIntervalMs),
456
+ const barOf = replayBarKeyReader(chartIntervalMs, venue);
457
+ return foldRowsIntoBar(buffer.subRows.slice(startIndex, endIndex), bucketKeyMs, targetMs, (rowMs) => {
458
+ const barMs = barOf(rowMs);
459
+ // A row no bar holds (a daily row stamped before its session's open) belongs to the window it sits in.
460
+ return barMs === bucketKeyMs || barMs === null;
434
461
  });
435
- return rows[0] ?? null;
462
+ }
463
+ /** Rows (ascending) folded into ONE bar keyed `keyMs`: the first open, the high and low over all, the
464
+ * last close, the volume summed (aggregateOhlcvRows' fold); rows past `maxMs`, without a stamp, or
465
+ * that `belongs` refuses are skipped. Null without a row. */
466
+ function foldRowsIntoBar(rows, keyMs, maxMs, belongs) {
467
+ let bar = null;
468
+ for (const row of rows) {
469
+ if (!Number.isFinite(row[0]) || row[0] > maxMs || !belongs(row[0]))
470
+ continue;
471
+ if (bar === null) {
472
+ bar = [keyMs, row[1], row[2], row[3], row[4], row[5] ?? 0];
473
+ continue;
474
+ }
475
+ bar[2] = Math.max(bar[2], row[2]);
476
+ bar[3] = Math.min(bar[3], row[3]);
477
+ bar[4] = row[4];
478
+ bar[5] = (bar[5] ?? 0) + (row[5] ?? 0);
479
+ }
480
+ return bar;
436
481
  }
437
482
  export function mergeHeatmapColumns(existing, incoming) {
438
483
  if (!incoming.length) {
@@ -548,9 +593,148 @@ export function chartBucketOriginMs(chartIntervalMs) {
548
593
  }
549
594
  return 0;
550
595
  }
551
- export function alignChartBucketMs(timestampMs, chartIntervalMs) {
552
- const originMs = chartBucketOriginMs(chartIntervalMs);
553
- return Math.floor((timestampMs - originMs) / chartIntervalMs) * chartIntervalMs + originMs;
596
+ /** Every bar boundary of every grid (the CME lattice, an RTH or regular session's open and close)
597
+ * sits on a quarter hour; a finer or odd width on its own multiples. A probe of this step never
598
+ * straddles a boundary. */
599
+ function barProbeStepMs(chartIntervalMs) {
600
+ let a = Math.max(1, Math.round(chartIntervalMs));
601
+ let b = 15 * 60_000;
602
+ while (b !== 0)
603
+ [a, b] = [b, a % b];
604
+ return a;
605
+ }
606
+ /** How far a bar may run past its nominal end, or lie behind an instant it still holds: a long
607
+ * weekend and a holiday. */
608
+ const BAR_SPAN_HORIZON_MS = 5 * DAY_MS;
609
+ const venueKeyOf = (venue) => `${String(venue.exchange)}|${String(venue.symbol)}|${String(venue.sessionType)}|${String(venue.transformations ?? '')}`;
610
+ /** The bar the chart's own bucket function gives the instant (null where none: outside an RTH or a
611
+ * regular session); the plain grid (origin 0, Monday at 1w) without a market. */
612
+ function liveBarKeyMs(timestampMs, chartIntervalMs, venue) {
613
+ if (!venue) {
614
+ const originMs = chartBucketOriginMs(chartIntervalMs);
615
+ return Math.floor((timestampMs - originMs) / chartIntervalMs) * chartIntervalMs + originMs;
616
+ }
617
+ return liveBucketStartMs(timestampMs, chartIntervalMs, venue);
618
+ }
619
+ const barSpanMemo = new Map();
620
+ const BAR_SPAN_MEMO_MAX = 8192;
621
+ function memoBarSpan(key, compute) {
622
+ const cached = barSpanMemo.get(key);
623
+ if (cached !== undefined)
624
+ return cached;
625
+ const value = compute();
626
+ if (barSpanMemo.size >= BAR_SPAN_MEMO_MAX)
627
+ barSpanMemo.clear();
628
+ barSpanMemo.set(key, value);
629
+ return value;
630
+ }
631
+ /**
632
+ * The KEY of the chart bar holding `timestampMs` on the chart's own grid: the bucket function its live
633
+ * candles key on (`liveBucketStartMs` over the chart market, its session included: the RTH-anchored
634
+ * bars of a CME chart in RTH, ES 4h at 13:30Z and a 17:30Z stub; the 09:30 New York bars of a
635
+ * regular-session stock; the CME session lattice in ETH, GC 4h in CDT at 22/02/06/10/14/18Z and a
636
+ * trade date keyed 00:00Z; the plain grid elsewhere). Between sessions an instant belongs to the bar
637
+ * still running across them (a stock's three-trade-date 3d bar overnight), else to none: null.
638
+ */
639
+ export function replayBarKeyMs(timestampMs, chartIntervalMs, venue) {
640
+ if (!Number.isFinite(timestampMs) || !(chartIntervalMs > 0))
641
+ return null;
642
+ const liveMs = liveBarKeyMs(timestampMs, chartIntervalMs, venue);
643
+ if (liveMs !== null || !venue)
644
+ return liveMs;
645
+ const stepMs = barProbeStepMs(chartIntervalMs);
646
+ const slotMs = Math.floor(timestampMs / stepMs) * stepMs;
647
+ return memoBarSpan(`held|${chartIntervalMs}|${venueKeyOf(venue)}|${slotMs}`, () => {
648
+ for (let probeMs = slotMs - stepMs; probeMs > slotMs - BAR_SPAN_HORIZON_MS; probeMs -= stepMs) {
649
+ const barMs = liveBarKeyMs(probeMs, chartIntervalMs, venue);
650
+ if (barMs === null)
651
+ continue;
652
+ return replayBarEndMs(barMs, chartIntervalMs, venue) > slotMs ? barMs : null;
653
+ }
654
+ return null;
655
+ });
656
+ }
657
+ /**
658
+ * The OPEN of the bar keyed `barKeyMs`: its key, except a CME trade-date bar (1d, 3d, 1w) keyed
659
+ * 00:00Z, which opens at the 17:00 Chicago open the evening before (`cmeSessionBarOpenMs`).
660
+ */
661
+ export function replayBarOpenMs(barKeyMs, chartIntervalMs, venue) {
662
+ if (venue && cmeSessionLatticeBucketMs(barKeyMs, chartIntervalMs, venue) === barKeyMs) {
663
+ return cmeSessionBarOpenMs(barKeyMs, chartIntervalMs) ?? barKeyMs;
664
+ }
665
+ return barKeyMs;
666
+ }
667
+ /**
668
+ * The END of the bar keyed `barKeyMs`, the instant it stops taking rows: its key plus the interval
669
+ * on the plain grid; the CME lattice's own end (`cmeSessionBarEndMs`: a 1d bar runs to the next
670
+ * 17:00 Chicago open, a fall-back Sunday's 4h bar an hour longer); a calendar bar's calendar end;
671
+ * and on a session grid the end of its last session (an RTH stub at the 20:15Z close, a stock's 3d
672
+ * bar at its third session's 16:00 close), walked once per bar on the quarter-hour probe.
673
+ */
674
+ export function replayBarEndMs(barKeyMs, chartIntervalMs, venue) {
675
+ const nominalEndMs = barKeyMs + chartIntervalMs;
676
+ if (!venue)
677
+ return nominalEndMs;
678
+ if (cmeSessionLatticeBucketMs(barKeyMs, chartIntervalMs, venue) === barKeyMs) {
679
+ return cmeSessionBarEndMs(barKeyMs, chartIntervalMs) ?? nominalEndMs;
680
+ }
681
+ if (calendarMonthsOfMs(chartIntervalMs) !== null)
682
+ return barEndMs(barKeyMs, chartIntervalMs);
683
+ // One contiguous run of the grid's width: the instant before the nominal end is the bar's own, the
684
+ // nominal end another bar's or none.
685
+ if (liveBarKeyMs(nominalEndMs - 1, chartIntervalMs, venue) === barKeyMs &&
686
+ liveBarKeyMs(nominalEndMs, chartIntervalMs, venue) !== barKeyMs) {
687
+ return nominalEndMs;
688
+ }
689
+ const stepMs = barProbeStepMs(chartIntervalMs);
690
+ return (memoBarSpan(`end|${chartIntervalMs}|${venueKeyOf(venue)}|${barKeyMs}`, () => {
691
+ let heldEndMs = null;
692
+ for (let probeMs = barKeyMs; probeMs < nominalEndMs + BAR_SPAN_HORIZON_MS; probeMs += stepMs) {
693
+ const barMs = liveBarKeyMs(probeMs, chartIntervalMs, venue);
694
+ if (barMs === barKeyMs)
695
+ heldEndMs = probeMs + stepMs;
696
+ else if (barMs !== null && heldEndMs !== null)
697
+ break;
698
+ }
699
+ return heldEndMs;
700
+ }) ?? nominalEndMs);
701
+ }
702
+ /**
703
+ * A reader of the bar each row belongs to (`replayBarKeyMs`), for rows read in ascending order: the
704
+ * rows inside one probe step share their bar, so the bucket function runs once per step, never once
705
+ * per row (a 4h bar of 1s tick rows).
706
+ */
707
+ export function replayBarKeyReader(chartIntervalMs, venue) {
708
+ const stepMs = barProbeStepMs(chartIntervalMs);
709
+ let slotMs = Number.NaN;
710
+ let slotBarMs = null;
711
+ return (rowMs) => {
712
+ const rowSlotMs = Math.floor(rowMs / stepMs) * stepMs;
713
+ if (rowSlotMs !== slotMs) {
714
+ slotMs = rowSlotMs;
715
+ slotBarMs = replayBarKeyMs(rowSlotMs, chartIntervalMs, venue);
716
+ }
717
+ return slotBarMs;
718
+ };
719
+ }
720
+ /**
721
+ * The KEY of the chart bar holding `timestampMs` (`replayBarKeyMs`), or the instant itself where no
722
+ * bar holds it: every bar before it is settled and none has opened, so it cuts as a key would.
723
+ * Cutoffs and row keys read this; window starts read `chartBucketOpenMs`.
724
+ */
725
+ export function alignChartBucketMs(timestampMs, chartIntervalMs, venue) {
726
+ return replayBarKeyMs(timestampMs, chartIntervalMs, venue) ?? timestampMs;
727
+ }
728
+ /** The OPEN of the bar holding `timestampMs` (`replayBarOpenMs`), or the instant where none holds it.
729
+ * Sub-row folds, fetch windows and retention floors start here. */
730
+ export function chartBucketOpenMs(timestampMs, chartIntervalMs, venue) {
731
+ const barKeyMs = replayBarKeyMs(timestampMs, chartIntervalMs, venue);
732
+ return barKeyMs === null ? timestampMs : replayBarOpenMs(barKeyMs, chartIntervalMs, venue);
733
+ }
734
+ /** The END of the bar holding `timestampMs` (`replayBarEndMs`), or the instant where none holds it. */
735
+ export function chartBucketEndMs(timestampMs, chartIntervalMs, venue) {
736
+ const barKeyMs = replayBarKeyMs(timestampMs, chartIntervalMs, venue);
737
+ return barKeyMs === null ? timestampMs : replayBarEndMs(barKeyMs, chartIntervalMs, venue);
554
738
  }
555
739
  export function replayResolutionRestartAnchorMs(args) {
556
740
  // Continue at the playhead: a resolution or interval pick is a playback
@@ -577,14 +761,37 @@ export function sourceIntervalMsForLabel(label) {
577
761
  }
578
762
  return null;
579
763
  }
580
- export function aggregateSourceRowsToChartInterval(rows, sourceInterval, chartIntervalMs, minMs, maxMs) {
764
+ /**
765
+ * Finer source rows folded into the chart's own bars (`replayBarKeyMs`: a CME 2h chart in CST on its
766
+ * odd-hour lattice, an RTH chart on its anchored bars), each bar keyed and folded as
767
+ * `aggregateOhlcvRows` folds; a row no bar holds is dropped. Rows already at the chart interval or
768
+ * coarser pass through.
769
+ */
770
+ export function aggregateSourceRowsToChartInterval(rows, sourceInterval, chartIntervalMs, minMs, maxMs, venue) {
581
771
  const sourceIntervalMs = sourceIntervalMsForLabel(sourceInterval);
582
772
  if (!sourceIntervalMs || sourceIntervalMs >= chartIntervalMs) {
583
773
  return rows;
584
774
  }
585
- return aggregateOhlcvRows(rows, chartIntervalMs, minMs, maxMs, {
586
- originMs: chartBucketOriginMs(chartIntervalMs),
587
- });
775
+ const byBar = new Map();
776
+ const barOf = replayBarKeyReader(chartIntervalMs, venue);
777
+ const sorted = rows
778
+ .filter((row) => typeof row[0] === 'number' && row[0] >= minMs && row[0] <= maxMs)
779
+ .sort((a, b) => a[0] - b[0]);
780
+ for (const row of sorted) {
781
+ const barMs = barOf(row[0]);
782
+ if (barMs === null || barMs > maxMs)
783
+ continue;
784
+ const existing = byBar.get(barMs);
785
+ if (!existing) {
786
+ byBar.set(barMs, [barMs, row[1], row[2], row[3], row[4], row[5] ?? 0]);
787
+ continue;
788
+ }
789
+ existing[2] = Math.max(existing[2], row[2]);
790
+ existing[3] = Math.min(existing[3], row[3]);
791
+ existing[4] = row[4];
792
+ existing[5] = (existing[5] ?? 0) + (row[5] ?? 0);
793
+ }
794
+ return Array.from(byBar.values()).sort((a, b) => a[0] - b[0]);
588
795
  }
589
796
  export function chartIntervalLabel(chartIntervalMs) {
590
797
  const interval = intervalLabelForMs(chartIntervalMs);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@orangecharts/wrun-chart-host",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "description": "The wrun chart-host layer shared by the kiyotaka web app and the mobile app: the wrun result reader and painter model, cut from the web app (its reference implementation).",
5
5
  "type": "module",
6
6
  "files": [
@@ -22,23 +22,23 @@
22
22
  "default": "./dist/*.js"
23
23
  }
24
24
  },
25
+ "scripts": {
26
+ "build": "node scripts/generate-tool-tables.mjs && rm -rf dist && tsc -p tsconfig.build.json && node scripts/esm-dist.mjs dist",
27
+ "consumer-check": "node scripts/consumer-check.mjs",
28
+ "typecheck": "tsc -p tsconfig.json --noEmit"
29
+ },
25
30
  "peerDependencies": {
26
- "@orangecharts/indicator-kit": "0.97.0",
27
- "@orangecharts/orange-v2-pb-common": "12.73.0",
31
+ "@orangecharts/indicator-kit": "0.103.1",
32
+ "@orangecharts/orange-v2-pb-common": "12.78.0",
28
33
  "dayjs": "1.11.23",
29
34
  "lodash-es": "4.18.1"
30
35
  },
31
36
  "devDependencies": {
32
- "@orangecharts/indicator-kit": "0.97.0",
33
- "@orangecharts/orange-v2-pb-common": "12.73.0",
37
+ "@orangecharts/indicator-kit": "0.103.1",
38
+ "@orangecharts/orange-v2-pb-common": "12.78.0",
34
39
  "@types/lodash-es": "4.17.12",
35
40
  "dayjs": "1.11.23",
36
41
  "lodash-es": "4.18.1",
37
42
  "typescript": "5.9.3"
38
- },
39
- "scripts": {
40
- "build": "node scripts/generate-tool-tables.mjs && rm -rf dist && tsc -p tsconfig.build.json && node scripts/esm-dist.mjs dist",
41
- "consumer-check": "node scripts/consumer-check.mjs",
42
- "typecheck": "tsc -p tsconfig.json --noEmit"
43
43
  }
44
- }
44
+ }