@orangecharts/wrun-chart-host 0.4.0 → 0.5.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.
- package/README.md +15 -4
- package/dist/constants/exchange-names.leaf.d.ts +8 -0
- package/dist/constants/exchange-names.leaf.js +101 -0
- package/dist/constants/kscript-data-interval-restrictions.constants.d.ts +15 -0
- package/dist/constants/kscript-data-interval-restrictions.constants.js +40 -0
- package/dist/constants/opra-compliance.constants.d.ts +19 -0
- package/dist/constants/opra-compliance.constants.js +19 -0
- package/dist/constants/replay-ladder.leaf.d.ts +30 -0
- package/dist/constants/replay-ladder.leaf.js +99 -0
- package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +168 -0
- package/dist/constants/scriptEditor/cme-official-scripts.constants.js +398 -0
- package/dist/constants/scriptEditor/converted-script-id.leaf.d.ts +8 -0
- package/dist/constants/scriptEditor/converted-script-id.leaf.js +10 -0
- package/dist/constants/scriptEditor/execution.constants.d.ts +4 -0
- package/dist/constants/scriptEditor/execution.constants.js +14 -0
- package/dist/constants/wrun-prefix-safe.constants.d.ts +23 -0
- package/dist/constants/wrun-prefix-safe.constants.js +26 -0
- package/dist/host-env.d.ts +313 -18
- package/dist/host-env.js +15 -0
- package/dist/host-ports.types.d.ts +853 -16
- package/dist/index.d.ts +139 -2
- package/dist/index.js +139 -2
- package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +31 -0
- package/dist/instances/script-engine-worker-ohlcv-transfer.js +164 -0
- package/dist/interfaces/market-event.interface.d.ts +231 -0
- package/dist/interfaces/market-event.interface.js +15 -0
- package/dist/interfaces/opra-realtime.interface.d.ts +70 -134
- package/dist/interfaces/opra-realtime.interface.js +34 -59
- package/dist/interfaces/replay.interface.d.ts +285 -0
- package/dist/interfaces/replay.interface.js +1 -0
- package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +1 -0
- package/dist/kscript-data/controls/live-ohlcv-merge.util.js +93 -0
- package/dist/kscript-data/controls/live-trades-merge.util.d.ts +5 -1
- package/dist/kscript-data/controls/live-trades-merge.util.js +2 -2
- package/dist/market-data/billing.interface.d.ts +219 -0
- package/dist/market-data/billing.interface.js +58 -0
- package/dist/market-data/venue-governed.util.d.ts +2 -0
- package/dist/market-data/venue-governed.util.js +10 -0
- package/dist/market-data/venue.d.ts +122 -0
- package/dist/market-data/venue.js +1 -0
- package/dist/market-data/venues/index.d.ts +97 -0
- package/dist/market-data/venues/index.js +33 -0
- package/dist/market-data/venues/opra.contract.copy.json +35 -0
- package/dist/market-data/venues/opra.d.ts +70 -0
- package/dist/market-data/venues/opra.js +74 -0
- package/dist/replay/replayIndicatorRows.d.ts +31 -0
- package/dist/replay/replayIndicatorRows.js +117 -0
- package/dist/replay/replayLadder.d.ts +85 -0
- package/dist/replay/replayLadder.js +388 -0
- package/dist/utility/auth/server-clock.util.d.ts +81 -0
- package/dist/utility/auth/server-clock.util.js +238 -0
- package/dist/utility/chart/builtin-identity.util.d.ts +18 -0
- package/dist/utility/chart/builtin-identity.util.js +51 -0
- package/dist/utility/chart/cache-alignment.util.d.ts +454 -0
- package/dist/utility/chart/cache-alignment.util.js +926 -0
- package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +15 -0
- package/dist/utility/chart/chart-data-fetch-generation.util.js +22 -0
- package/dist/utility/chart/chart-mount-epoch.util.d.ts +5 -0
- package/dist/utility/chart/chart-mount-epoch.util.js +29 -0
- package/dist/utility/chart/chart-time-domain.util.d.ts +12 -0
- package/dist/utility/chart/chart-time-domain.util.js +23 -0
- package/dist/utility/chart/color-customization.leaf.d.ts +10 -0
- package/dist/utility/chart/color-customization.leaf.js +16 -0
- package/dist/utility/chart/footprint-tick-grid.util.d.ts +106 -0
- package/dist/utility/chart/footprint-tick-grid.util.js +167 -0
- package/dist/utility/chart/gesture-timing.leaf.d.ts +29 -0
- package/dist/utility/chart/gesture-timing.leaf.js +29 -0
- package/dist/utility/chart/governed-contract-coin.util.d.ts +22 -0
- package/dist/utility/chart/governed-contract-coin.util.js +39 -0
- package/dist/utility/chart/host-bar-placement.util.d.ts +107 -0
- package/dist/utility/chart/host-bar-placement.util.js +447 -0
- package/dist/utility/chart/index-host-tier.util.d.ts +31 -0
- package/dist/utility/chart/index-host-tier.util.js +118 -0
- package/dist/utility/chart/index-mode-admission.util.d.ts +34 -0
- package/dist/utility/chart/index-mode-admission.util.js +67 -0
- package/dist/utility/chart/indicator-error-message.util.d.ts +35 -0
- package/dist/utility/chart/indicator-error-message.util.js +44 -0
- package/dist/utility/chart/kscript-apply-fingerprint.util.d.ts +65 -0
- package/dist/utility/chart/kscript-apply-fingerprint.util.js +357 -0
- package/dist/utility/chart/kscript-chart-flush.leaf.d.ts +22 -0
- package/dist/utility/chart/kscript-chart-flush.leaf.js +13 -0
- package/dist/utility/chart/kscript-data-interval-restriction.leaf.d.ts +6 -0
- package/dist/utility/chart/kscript-data-interval-restriction.leaf.js +27 -0
- package/dist/utility/chart/kscript-integration-decision.leaf.d.ts +89 -0
- package/dist/utility/chart/kscript-integration-decision.leaf.js +80 -0
- package/dist/utility/chart/kscript-live-coalesce.util.d.ts +76 -0
- package/dist/utility/chart/kscript-live-coalesce.util.js +156 -0
- package/dist/utility/chart/kscript-live-rest-pace.util.d.ts +34 -0
- package/dist/utility/chart/kscript-live-rest-pace.util.js +134 -0
- package/dist/utility/chart/kscript-live-source-identity.util.d.ts +98 -0
- package/dist/utility/chart/kscript-live-source-identity.util.js +121 -0
- package/dist/utility/chart/kscript-mounted-plot-set.leaf.d.ts +48 -0
- package/dist/utility/chart/kscript-mounted-plot-set.leaf.js +145 -0
- package/dist/utility/chart/kscript-perf-tracker.util.d.ts +243 -0
- package/dist/utility/chart/kscript-perf-tracker.util.js +522 -0
- package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +43 -0
- package/dist/utility/chart/kscript-run-interval-projection.util.js +471 -0
- package/dist/utility/chart/kscript-run-result-equality.util.d.ts +38 -0
- package/dist/utility/chart/kscript-run-result-equality.util.js +89 -0
- package/dist/utility/chart/kscript-settings-revision.leaf.d.ts +2 -0
- package/dist/utility/chart/kscript-settings-revision.leaf.js +12 -0
- package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +63 -0
- package/dist/utility/chart/kscript-source-degrade.leaf.js +68 -0
- package/dist/utility/chart/kscript-source-retention.util.d.ts +134 -0
- package/dist/utility/chart/kscript-source-retention.util.js +218 -0
- package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +57 -0
- package/dist/utility/chart/kscript-standin-identity.leaf.js +61 -0
- package/dist/utility/chart/kscript-titancharts-preparation.util.d.ts +15 -0
- package/dist/utility/chart/kscript-titancharts-preparation.util.js +376 -0
- package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +9 -0
- package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +130 -0
- package/dist/utility/chart/kscript-venue-policy.util.d.ts +217 -0
- package/dist/utility/chart/kscript-venue-policy.util.js +324 -0
- package/dist/utility/chart/live-cadence.util.d.ts +38 -0
- package/dist/utility/chart/live-cadence.util.js +37 -0
- package/dist/utility/chart/live-feed-series-match.leaf.d.ts +13 -0
- package/dist/utility/chart/live-feed-series-match.leaf.js +21 -0
- package/dist/utility/chart/local-engine-self-heal-backoff.util.d.ts +46 -0
- package/dist/utility/chart/local-engine-self-heal-backoff.util.js +46 -0
- package/dist/utility/chart/local-engine-uninit.leaf.d.ts +21 -0
- package/dist/utility/chart/local-engine-uninit.leaf.js +22 -0
- package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +62 -0
- package/dist/utility/chart/local-kscript-source-revalidation.util.js +123 -0
- package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +214 -0
- package/dist/utility/chart/local-kscript-warmup-depth.util.js +376 -0
- package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.d.ts +85 -0
- package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.js +197 -0
- package/dist/utility/chart/local-technical-script-range.leaf.d.ts +72 -0
- package/dist/utility/chart/local-technical-script-range.leaf.js +126 -0
- package/dist/utility/chart/mixed-mode.util.d.ts +167 -0
- package/dist/utility/chart/mixed-mode.util.js +139 -0
- package/dist/utility/chart/ohlcv-row-readiness.util.d.ts +36 -0
- package/dist/utility/chart/ohlcv-row-readiness.util.js +90 -0
- package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +19 -0
- package/dist/utility/chart/opra-user-scripts-gate.util.js +32 -0
- package/dist/utility/chart/overlay-execution-guard-key.leaf.d.ts +8 -0
- package/dist/utility/chart/overlay-execution-guard-key.leaf.js +10 -0
- package/dist/utility/chart/price-precision.util.d.ts +40 -0
- package/dist/utility/chart/price-precision.util.js +70 -0
- package/dist/utility/chart/profile-block-size.util.d.ts +64 -0
- package/dist/utility/chart/profile-block-size.util.js +141 -0
- package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.d.ts +11 -0
- package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.js +29 -0
- package/dist/utility/chart/protected-kscript-empty-output.util.d.ts +28 -0
- package/dist/utility/chart/protected-kscript-empty-output.util.js +84 -0
- package/dist/utility/chart/run-interval-unservable.leaf.d.ts +9 -0
- package/dist/utility/chart/run-interval-unservable.leaf.js +20 -0
- package/dist/utility/chart/run-interval-warmup.leaf.d.ts +19 -0
- package/dist/utility/chart/run-interval-warmup.leaf.js +35 -0
- package/dist/utility/chart/titan-constants.pin.d.ts +9 -5
- package/dist/utility/chart/titan-constants.pin.js +18 -5
- package/dist/utility/chart/warmup-backfill-retry.leaf.d.ts +9 -0
- package/dist/utility/chart/warmup-backfill-retry.leaf.js +9 -0
- package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +11 -2
- package/dist/utility/chart/wrun-bar-session-facts.util.js +10 -3
- package/dist/utility/chart/wrun-run-result.util.d.ts +5 -1
- package/dist/utility/chart/wrun-run-result.util.js +20 -14
- package/dist/utility/common/data-processing.util.d.ts +138 -0
- package/dist/utility/common/data-processing.util.js +346 -0
- package/dist/utility/common/visible-timeout.util.d.ts +13 -4
- package/dist/utility/common/visible-timeout.util.js +23 -8
- package/dist/utility/exchange-format.leaf.d.ts +1 -0
- package/dist/utility/exchange-format.leaf.js +47 -0
- package/dist/utility/market-events/earnings-scope.util.d.ts +60 -0
- package/dist/utility/market-events/earnings-scope.util.js +92 -0
- package/dist/utility/market-events/market-events.util.d.ts +147 -0
- package/dist/utility/market-events/market-events.util.js +392 -0
- package/dist/utility/market-events/zoned-clock.util.d.ts +1 -0
- package/dist/utility/market-events/zoned-clock.util.js +11 -0
- package/dist/utility/options/option-venue-disclosure.util.d.ts +43 -0
- package/dist/utility/options/option-venue-disclosure.util.js +56 -0
- package/dist/utility/scriptEditor/package-semver.util.d.ts +51 -0
- package/dist/utility/scriptEditor/package-semver.util.js +120 -0
- package/dist/utility/scriptEditor/temp-script-id.util.d.ts +18 -0
- package/dist/utility/scriptEditor/temp-script-id.util.js +25 -0
- package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.d.ts +20 -0
- package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.js +81 -0
- package/dist/utility/v2/governed-tier.leaf.d.ts +103 -0
- package/dist/utility/v2/governed-tier.leaf.js +113 -0
- package/dist/utility/watchlist/import/import-request.leaf.d.ts +10 -0
- package/dist/utility/watchlist/import/import-request.leaf.js +10 -0
- package/dist/utility/wrun/sources/lanes/series.js +2 -2
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +4 -4
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +5 -6
- package/dist/utility/wrun/wrun-alert-outputs.registry.d.ts +166 -0
- package/dist/utility/wrun/wrun-alert-outputs.registry.js +219 -0
- package/dist/utility/wrun/wrun-bar-count.util.d.ts +83 -0
- package/dist/utility/wrun/wrun-bar-count.util.js +259 -0
- package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +84 -0
- package/dist/utility/wrun/wrun-chart-context-names.util.js +186 -0
- package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +253 -0
- package/dist/utility/wrun/wrun-chart-market-facts.util.js +731 -0
- package/dist/utility/wrun/wrun-cloud-opra-stamp.util.d.ts +28 -0
- package/dist/utility/wrun/wrun-cloud-opra-stamp.util.js +45 -0
- package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +18 -0
- package/dist/utility/wrun/wrun-coin-lane-live.util.js +47 -0
- package/dist/utility/wrun/wrun-deadline.util.js +2 -1
- package/dist/utility/wrun/wrun-debug-output.util.d.ts +39 -0
- package/dist/utility/wrun/wrun-debug-output.util.js +63 -0
- package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +113 -0
- package/dist/utility/wrun/wrun-declared-warmup.util.js +181 -0
- package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +43 -0
- package/dist/utility/wrun/wrun-draft-legend-note.util.js +158 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +181 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.js +357 -0
- package/dist/utility/wrun/wrun-draw-skipped.leaf.d.ts +16 -0
- package/dist/utility/wrun/wrun-draw-skipped.leaf.js +16 -0
- package/dist/utility/wrun/wrun-earnings-facts.util.d.ts +42 -0
- package/dist/utility/wrun/wrun-earnings-facts.util.js +131 -0
- package/dist/utility/wrun/wrun-first-run-depth.util.d.ts +32 -0
- package/dist/utility/wrun/wrun-first-run-depth.util.js +118 -0
- package/dist/utility/wrun/wrun-gate-plane-readers.util.d.ts +24 -0
- package/dist/utility/wrun/wrun-gate-plane-readers.util.js +31 -0
- package/dist/utility/wrun/wrun-held-lanes.util.d.ts +32 -0
- package/dist/utility/wrun/wrun-held-lanes.util.js +94 -0
- package/dist/utility/wrun/wrun-host-visible-clock.util.d.ts +2 -0
- package/dist/utility/wrun/wrun-host-visible-clock.util.js +17 -0
- package/dist/utility/wrun/wrun-host.service.d.ts +266 -0
- package/dist/utility/wrun/wrun-host.service.js +655 -0
- package/dist/utility/wrun/wrun-inert-legend.util.d.ts +33 -0
- package/dist/utility/wrun/wrun-inert-legend.util.js +125 -0
- package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +155 -0
- package/dist/utility/wrun/wrun-input-requirements.leaf.js +450 -0
- package/dist/utility/wrun/wrun-integration-route.util.d.ts +51 -0
- package/dist/utility/wrun/wrun-integration-route.util.js +59 -0
- package/dist/utility/wrun/wrun-latest-history.leaf.d.ts +8 -0
- package/dist/utility/wrun/wrun-latest-history.leaf.js +8 -0
- package/dist/utility/wrun/wrun-legend-hover.lazy.d.ts +12 -0
- package/dist/utility/wrun/wrun-legend-hover.lazy.js +96 -0
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +21 -0
- package/dist/utility/wrun/wrun-live-hidden-hold.util.d.ts +23 -0
- package/dist/utility/wrun/wrun-live-hidden-hold.util.js +13 -0
- package/dist/utility/wrun/wrun-live-intake.util.d.ts +374 -0
- package/dist/utility/wrun/wrun-live-intake.util.js +2027 -0
- package/dist/utility/wrun/wrun-live-patch.util.d.ts +116 -0
- package/dist/utility/wrun/wrun-live-patch.util.js +523 -0
- package/dist/utility/wrun/wrun-live-tick.util.d.ts +619 -0
- package/dist/utility/wrun/wrun-live-tick.util.js +4974 -0
- package/dist/utility/wrun/wrun-loading-owner.util.d.ts +58 -0
- package/dist/utility/wrun/wrun-loading-owner.util.js +89 -0
- package/dist/utility/wrun/wrun-official-scope.leaf.d.ts +29 -0
- package/dist/utility/wrun/wrun-official-scope.leaf.js +36 -0
- package/dist/utility/wrun/wrun-oi-lane.util.d.ts +27 -0
- package/dist/utility/wrun/wrun-oi-lane.util.js +42 -0
- package/dist/utility/wrun/wrun-options-stop.util.d.ts +52 -0
- package/dist/utility/wrun/wrun-options-stop.util.js +123 -0
- package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +719 -0
- package/dist/utility/wrun/wrun-overlay-drivers.util.js +1180 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +50 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +131 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +118 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +466 -0
- package/dist/utility/wrun/wrun-overlay-metadata.util.d.ts +45 -0
- package/dist/utility/wrun/wrun-overlay-metadata.util.js +112 -0
- package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +114 -0
- package/dist/utility/wrun/wrun-overlay-recovery.util.js +971 -0
- package/dist/utility/wrun/wrun-overlay-run.util.d.ts +858 -0
- package/dist/utility/wrun/wrun-overlay-run.util.js +11013 -0
- package/dist/utility/wrun/wrun-panel-mount.util.d.ts +24 -9
- package/dist/utility/wrun/wrun-panel-mount.util.js +138 -43
- package/dist/utility/wrun/wrun-param-map.util.d.ts +19 -4
- package/dist/utility/wrun/wrun-param-map.util.js +40 -47
- package/dist/utility/wrun/wrun-param-values.util.d.ts +9 -3
- package/dist/utility/wrun/wrun-param-values.util.js +5 -5
- package/dist/utility/wrun/wrun-prefix-cohort.util.d.ts +93 -0
- package/dist/utility/wrun/wrun-prefix-cohort.util.js +484 -0
- package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +114 -0
- package/dist/utility/wrun/wrun-prefix-lanes.util.js +486 -0
- package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +317 -0
- package/dist/utility/wrun/wrun-prefix-proof.util.js +630 -0
- package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +73 -0
- package/dist/utility/wrun/wrun-refusal-surface.util.js +380 -0
- package/dist/utility/wrun/wrun-refusal-text.util.d.ts +15 -0
- package/dist/utility/wrun/wrun-refusal-text.util.js +40 -0
- package/dist/utility/wrun/wrun-replay-lane.util.d.ts +139 -0
- package/dist/utility/wrun/wrun-replay-lane.util.js +520 -0
- package/dist/utility/wrun/wrun-replay-rows.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-replay-rows.util.js +172 -0
- package/dist/utility/wrun/wrun-row-source-factory.d.ts +53 -0
- package/dist/utility/wrun/wrun-row-source-factory.js +435 -0
- package/dist/utility/wrun/wrun-run-cells.util.d.ts +36 -0
- package/dist/utility/wrun/wrun-run-cells.util.js +46 -0
- package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +133 -0
- package/dist/utility/wrun/wrun-run-interval-session.util.js +121 -0
- package/dist/utility/wrun/wrun-run-interval.util.d.ts +98 -0
- package/dist/utility/wrun/wrun-run-interval.util.js +207 -0
- package/dist/utility/wrun/wrun-run-retained.util.d.ts +122 -0
- package/dist/utility/wrun/wrun-run-retained.util.js +255 -0
- package/dist/utility/wrun/wrun-sandbox-row-source.d.ts +184 -0
- package/dist/utility/wrun/wrun-sandbox-row-source.js +444 -0
- package/dist/utility/wrun/wrun-script-inputs.util.js +4 -4
- package/dist/utility/wrun/wrun-series-stream.util.d.ts +86 -0
- package/dist/utility/wrun/wrun-series-stream.util.js +537 -0
- package/dist/utility/wrun/wrun-sheet-remembered.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-sheet-remembered.util.js +36 -0
- package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.d.ts +7 -0
- package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.js +12 -0
- package/dist/utility/wrun/wrun-socket-row-source.js +4 -2
- package/dist/utility/wrun/wrun-source-rows.util.d.ts +175 -3
- package/dist/utility/wrun/wrun-source-rows.util.js +294 -8
- package/dist/utility/wrun/wrun-stats-strip.util.d.ts +46 -0
- package/dist/utility/wrun/wrun-stats-strip.util.js +87 -0
- package/dist/utility/wrun/wrun-table-chrome.util.d.ts +163 -0
- package/dist/utility/wrun/wrun-table-chrome.util.js +557 -0
- package/dist/utility/wrun/wrun-text-params.util.d.ts +11 -6
- package/dist/utility/wrun/wrun-text-params.util.js +19 -30
- package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +64 -0
- package/dist/utility/wrun/wrun-transient-rerun.util.js +317 -0
- package/dist/utility/wrun/wrun-twin-lookback.util.d.ts +10 -0
- package/dist/utility/wrun/wrun-twin-lookback.util.js +43 -0
- package/dist/utility/wrun/wrun-warmup-head-store.util.d.ts +41 -0
- package/dist/utility/wrun/wrun-warmup-head-store.util.js +120 -0
- package/dist/utility/wrun-alert-params.leaf.d.ts +24 -0
- package/dist/utility/wrun-alert-params.leaf.js +24 -0
- package/dist/utils/replay/replay-buffer-math.d.ts +148 -0
- package/dist/utils/replay/replay-buffer-math.js +684 -0
- package/dist/workers/wrun/wrun-abi-host.d.ts +190 -0
- package/dist/workers/wrun/wrun-abi-host.js +1201 -0
- package/dist/workers/wrun/wrun-engine-handler.d.ts +37 -0
- package/dist/workers/wrun/wrun-engine-handler.js +211 -0
- package/package.json +3 -3
|
@@ -0,0 +1,346 @@
|
|
|
1
|
+
/* eslint-disable @typescript-eslint/no-explicit-any */
|
|
2
|
+
import { Intervals } from '../../constants/interval.constants.js';
|
|
3
|
+
import { serverNowMs } from '../auth/server-clock.util.js';
|
|
4
|
+
import { isCmeGoverned } from '../chart/cme-realtime.util.js';
|
|
5
|
+
import { calendarBarStartMs, calendarMonthsOfMs } from '../chart/calendar-interval.util.js';
|
|
6
|
+
function findMonday(timestamp) {
|
|
7
|
+
const date = new Date(timestamp);
|
|
8
|
+
const day = date.getUTCDay();
|
|
9
|
+
const daysSinceMonday = (day + 6) % 7;
|
|
10
|
+
return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() - daysSinceMonday);
|
|
11
|
+
}
|
|
12
|
+
export function timestampToTsdbTimestamp(timestamp) {
|
|
13
|
+
return Number(`${timestamp.seconds}000`);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Convert the tsdb timestamp to milliseconds
|
|
17
|
+
* @param timestamp - The timestamp to convert
|
|
18
|
+
* @returns The timestamp in milliseconds
|
|
19
|
+
*/
|
|
20
|
+
export function tsdbTimestampToMs(timestamp) {
|
|
21
|
+
const ts = timestamp.seconds + (timestamp.nanoseconds ?? 0) * 1e-9;
|
|
22
|
+
return ts * 1000;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* The start of the calendar bar (1M 3M 6M 1Y) a book stamp belongs to: a stamp
|
|
26
|
+
* exactly on a calendar boundary closes the bar before it, as an exact
|
|
27
|
+
* multiple does on a fixed grid (block book stamps are END labels).
|
|
28
|
+
*/
|
|
29
|
+
function calendarBookBarStartMs(timestamp, months) {
|
|
30
|
+
const start = calendarBarStartMs(timestamp, months);
|
|
31
|
+
return start === timestamp ? calendarBarStartMs(timestamp - 1, months) : start;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Round the timestamp to the nearest interval in the past. A calendar length
|
|
35
|
+
* (1M 3M 6M 1Y) rounds onto its UTC calendar boundary, where its candles open.
|
|
36
|
+
* @param timestamp - The timestamp to round
|
|
37
|
+
* @param interval - The interval to round to
|
|
38
|
+
* @returns The rounded timestamp
|
|
39
|
+
*/
|
|
40
|
+
export function roundObTimestamp(timestamp, interval) {
|
|
41
|
+
if (interval === Intervals.WEEK) {
|
|
42
|
+
return findMonday(timestamp);
|
|
43
|
+
}
|
|
44
|
+
const months = calendarMonthsOfMs(interval);
|
|
45
|
+
if (months !== null)
|
|
46
|
+
return calendarBookBarStartMs(timestamp, months);
|
|
47
|
+
const remainder = timestamp % interval;
|
|
48
|
+
if (remainder === 0) {
|
|
49
|
+
timestamp -= interval;
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
timestamp -= remainder;
|
|
53
|
+
}
|
|
54
|
+
return timestamp;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Parses flattened orderbook data, transforming
|
|
58
|
+
* [numPriceLevels, timestamp_μs, price1, amount1, ...]
|
|
59
|
+
* into
|
|
60
|
+
* [segmentSize, timestamp_ms, price1, amount1, ...]
|
|
61
|
+
*
|
|
62
|
+
* Orderbook consumers must additionally call `shiftOrderbookTimestamps` to
|
|
63
|
+
* align timestamps with the candle interval start. TPSL consumers skip the
|
|
64
|
+
* shift since their timestamps are used as-is.
|
|
65
|
+
*
|
|
66
|
+
* @param flatPoints - Flattened data from backend
|
|
67
|
+
* @returns Float64Array with format [segmentSize, timestamp_ms, price1, amount1, ...]
|
|
68
|
+
*/
|
|
69
|
+
export function parseOrderbookFlatData(flatPoints) {
|
|
70
|
+
if (!flatPoints?.length)
|
|
71
|
+
return new Float64Array();
|
|
72
|
+
// Copy flatPointsto Float64Array
|
|
73
|
+
const result = new Float64Array(flatPoints.length);
|
|
74
|
+
result.set(flatPoints);
|
|
75
|
+
let index = 0;
|
|
76
|
+
while (index < result.length) {
|
|
77
|
+
if (index + 1 >= result.length)
|
|
78
|
+
break;
|
|
79
|
+
const numPriceLevels = result[index];
|
|
80
|
+
const timestamp = result[index + 1];
|
|
81
|
+
// Calculate segment size: count + timestamp + price/amount pairs
|
|
82
|
+
// [count, timestamp, price1, amount1, price2, amount2, ...]
|
|
83
|
+
const segmentSize = 2 + numPriceLevels * 2;
|
|
84
|
+
// Check bounds
|
|
85
|
+
if (index + segmentSize > result.length)
|
|
86
|
+
break;
|
|
87
|
+
// Transform the first element from numPriceLevels to segmentSize
|
|
88
|
+
result[index] = segmentSize;
|
|
89
|
+
result[index + 1] = timestamp / 1000;
|
|
90
|
+
index += segmentSize;
|
|
91
|
+
}
|
|
92
|
+
return result;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* The bar an END-stamped book point paints on: one interval back on a fixed
|
|
96
|
+
* grid, the calendar bar the stamp closes at a calendar length (1M 3M 6M 1Y:
|
|
97
|
+
* a bar of 28 to 366 days, where one average-length step back lands mid-bar
|
|
98
|
+
* or inside the bar before). The ladder projections (orderbook-ladder.util)
|
|
99
|
+
* must place a stamp exactly as this does: both heatmap paths paint one grid.
|
|
100
|
+
*/
|
|
101
|
+
export function bookBarStartMs(stampMs, intervalMs) {
|
|
102
|
+
const months = calendarMonthsOfMs(intervalMs);
|
|
103
|
+
return months === null ? stampMs - intervalMs : calendarBookBarStartMs(stampMs, months);
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Moves each segment's timestamp, in place, from the bucket-end stamp to the
|
|
107
|
+
* start of the bar it closes (`bookBarStartMs`), so the orderbook heatmap
|
|
108
|
+
* aligns with the candles. TPSL does not need this.
|
|
109
|
+
*
|
|
110
|
+
* @param data - Float64Array produced by `parseOrderbookFlatData`
|
|
111
|
+
* @param intervalMs - The chart interval in ms
|
|
112
|
+
*/
|
|
113
|
+
export function shiftOrderbookTimestamps(data, intervalMs) {
|
|
114
|
+
let index = 0;
|
|
115
|
+
while (index < data.length) {
|
|
116
|
+
const segmentSize = data[index];
|
|
117
|
+
if (!segmentSize || index + segmentSize > data.length)
|
|
118
|
+
break;
|
|
119
|
+
data[index + 1] = bookBarStartMs(data[index + 1], intervalMs);
|
|
120
|
+
index += segmentSize;
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Process block book snapshot data (live feed)
|
|
125
|
+
* @param point - The point to process
|
|
126
|
+
* @returns Float64Array
|
|
127
|
+
*
|
|
128
|
+
* @note The data is sorted by ascending price
|
|
129
|
+
*/
|
|
130
|
+
export function processBlockBookSnapshot(point) {
|
|
131
|
+
if (!point)
|
|
132
|
+
return new Float64Array();
|
|
133
|
+
const snapshot = point.blockBookSnapshot;
|
|
134
|
+
if (!snapshot)
|
|
135
|
+
return new Float64Array();
|
|
136
|
+
const { timestamp, bids = [], asks = [] } = snapshot;
|
|
137
|
+
const formattedData = [];
|
|
138
|
+
formattedData.push(bids.length + asks.length + 2);
|
|
139
|
+
formattedData.push(timestampToTsdbTimestamp(timestamp)); // timestamp needs to be adjusted to the interval in main thread
|
|
140
|
+
const quantities = new Map(); // price -> total quantity
|
|
141
|
+
for (let i = 0; i < bids.length; i += 2) {
|
|
142
|
+
quantities.set(bids[i], (quantities.get(bids[i]) || 0) + bids[i + 1]);
|
|
143
|
+
}
|
|
144
|
+
for (let i = 0; i < asks.length; i += 2) {
|
|
145
|
+
quantities.set(asks[i], (quantities.get(asks[i]) || 0) + asks[i + 1]);
|
|
146
|
+
}
|
|
147
|
+
// Sort by price ascending (lowest price first)
|
|
148
|
+
const sortedQuantities = Array.from(quantities.entries()).sort((a, b) => a[0] - b[0]);
|
|
149
|
+
for (const [price, quantity] of sortedQuantities) {
|
|
150
|
+
formattedData.push(price, quantity);
|
|
151
|
+
}
|
|
152
|
+
// Correct the length of the data
|
|
153
|
+
formattedData[0] = formattedData.length;
|
|
154
|
+
return new Float64Array(formattedData);
|
|
155
|
+
}
|
|
156
|
+
export function processBlockBookSnapshots(points) {
|
|
157
|
+
if (!points)
|
|
158
|
+
return [];
|
|
159
|
+
return points.map((point) => processBlockBookSnapshot(point));
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* The bid level count of a flat book frame (`processBlockBookSnapshot`), so a
|
|
163
|
+
* kScript riding a heatmap's stream can split the price-ascending flat back
|
|
164
|
+
* into sides on the main thread (`kScriptOrderbookRowFromFlatBook`). The flat
|
|
165
|
+
* merges levels by price, so the split is only knowable when every wire level
|
|
166
|
+
* survived: -1 when the flat's level count differs from the snapshot's bid
|
|
167
|
+
* pairs plus ask pairs (a duplicate price inside a side, or one price on both
|
|
168
|
+
* sides), or when both sides exist and the book is crossed, locked or merged
|
|
169
|
+
* (`!(bids[0] < asks[0])`, best levels first on the wire). A -1 makes the
|
|
170
|
+
* rider skip that frame instead of guessing the boundary.
|
|
171
|
+
*/
|
|
172
|
+
export function flatBookBidLevels(flat, bids, asks) {
|
|
173
|
+
const bidPairs = bids.length / 2;
|
|
174
|
+
const askPairs = asks.length / 2;
|
|
175
|
+
const flatLevels = (flat.length - 2) / 2;
|
|
176
|
+
if (!Number.isInteger(bidPairs) || !Number.isInteger(askPairs) || flatLevels !== bidPairs + askPairs)
|
|
177
|
+
return -1;
|
|
178
|
+
if (bidPairs > 0 && askPairs > 0 && !(bids[0] < asks[0]))
|
|
179
|
+
return -1;
|
|
180
|
+
return bidPairs;
|
|
181
|
+
}
|
|
182
|
+
function clipOrderbookLevels(levels, maxDepth) {
|
|
183
|
+
const maxLevels = Number(maxDepth);
|
|
184
|
+
if (!Number.isFinite(maxLevels) || maxLevels <= 0)
|
|
185
|
+
return levels;
|
|
186
|
+
return levels.slice(0, Math.floor(maxLevels) * 2);
|
|
187
|
+
}
|
|
188
|
+
function normalizeKScriptBlockBookSnapshotOptions(options) {
|
|
189
|
+
return typeof options === 'number' ? { maxDepth: options } : (options ?? {});
|
|
190
|
+
}
|
|
191
|
+
function normalizeOrderbookBucketPrice(price, blockSize, side) {
|
|
192
|
+
const rawBucket = side === 'ask' ? Math.ceil(price / blockSize) * blockSize : Math.floor(price / blockSize) * blockSize;
|
|
193
|
+
return Number(rawBucket.toFixed(8));
|
|
194
|
+
}
|
|
195
|
+
function aggregateOrderbookLevelsByBlock(levels, side, options) {
|
|
196
|
+
const sourceBlockSize = Number(options.sourceBlockSize);
|
|
197
|
+
const targetBlockSize = Number(options.targetBlockSize);
|
|
198
|
+
if (!Number.isFinite(sourceBlockSize) ||
|
|
199
|
+
!Number.isFinite(targetBlockSize) ||
|
|
200
|
+
sourceBlockSize <= 0 ||
|
|
201
|
+
targetBlockSize <= 0 ||
|
|
202
|
+
sourceBlockSize >= targetBlockSize) {
|
|
203
|
+
return levels;
|
|
204
|
+
}
|
|
205
|
+
const quantitiesByBucket = new Map();
|
|
206
|
+
for (let index = 0; index < levels.length; index += 2) {
|
|
207
|
+
const price = Number(levels[index]);
|
|
208
|
+
const quantity = Number(levels[index + 1]);
|
|
209
|
+
if (!Number.isFinite(price) || !Number.isFinite(quantity))
|
|
210
|
+
continue;
|
|
211
|
+
const bucketPrice = normalizeOrderbookBucketPrice(price, targetBlockSize, side);
|
|
212
|
+
quantitiesByBucket.set(bucketPrice, (quantitiesByBucket.get(bucketPrice) ?? 0) + quantity);
|
|
213
|
+
}
|
|
214
|
+
return Array.from(quantitiesByBucket.entries()).flat();
|
|
215
|
+
}
|
|
216
|
+
export function processKScriptBlockBookSnapshot(point, options) {
|
|
217
|
+
if (!point)
|
|
218
|
+
return new Float64Array();
|
|
219
|
+
const snapshot = point.blockBookSnapshot;
|
|
220
|
+
if (!snapshot)
|
|
221
|
+
return new Float64Array();
|
|
222
|
+
const normalizedOptions = normalizeKScriptBlockBookSnapshotOptions(options);
|
|
223
|
+
const timestamp = timestampToTsdbTimestamp(snapshot.timestamp); // timestamp needs to be adjusted to the interval in main thread
|
|
224
|
+
const bids = clipOrderbookLevels(aggregateOrderbookLevelsByBlock(snapshot.bids ?? [], 'bid', normalizedOptions), normalizedOptions.maxDepth);
|
|
225
|
+
const snapshotAsks = clipOrderbookLevels(aggregateOrderbookLevelsByBlock(snapshot.asks ?? [], 'ask', normalizedOptions), normalizedOptions.maxDepth);
|
|
226
|
+
// sort asks reversely
|
|
227
|
+
const askMap = new Map();
|
|
228
|
+
for (let i = 0; i < snapshotAsks.length; i += 2) {
|
|
229
|
+
askMap.set(snapshotAsks[i], -snapshotAsks[i + 1]); // set ask amounts to negative
|
|
230
|
+
}
|
|
231
|
+
const asks = Array.from(askMap.entries())
|
|
232
|
+
.sort((a, b) => b[0] - a[0])
|
|
233
|
+
.flat();
|
|
234
|
+
const float64Array = new Float64Array(bids.length + asks.length + 1);
|
|
235
|
+
float64Array[0] = timestamp;
|
|
236
|
+
float64Array.set(bids, 1);
|
|
237
|
+
float64Array.set(asks, bids.length + 1);
|
|
238
|
+
return float64Array;
|
|
239
|
+
}
|
|
240
|
+
export function processKScriptBlockBookSnapshots(points, options) {
|
|
241
|
+
if (!points)
|
|
242
|
+
return [];
|
|
243
|
+
return points.map((point) => processKScriptBlockBookSnapshot(point, options));
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
* Rows `[ts, value per subset]` from values keyed by subset name and ms timestamp: each `subsetEnum` member (bar the
|
|
247
|
+
* zero member) at its enum value's index, null where it has no value at that ts; ts ascending over every subset.
|
|
248
|
+
*/
|
|
249
|
+
export function subsetRows(values, subsetEnum) {
|
|
250
|
+
const elementSize = Object.keys(subsetEnum).filter((key) => isNaN(Number(key))).length - 1;
|
|
251
|
+
const times = [...new Set([...values.values()].flatMap((byTs) => [...byTs.keys()]))].sort((a, b) => a - b);
|
|
252
|
+
return times.map((time) => [
|
|
253
|
+
time,
|
|
254
|
+
...Array.from({ length: elementSize }, (_, i) => values.get(subsetEnum[i + 1])?.get(time) ?? null),
|
|
255
|
+
]);
|
|
256
|
+
}
|
|
257
|
+
/**
|
|
258
|
+
* The column `subsetRows` gives a subset inside each row: the subset's enum
|
|
259
|
+
* VALUE (the timestamp holds column 0, the slot of the enum's zero member), so a subset is read
|
|
260
|
+
* by its enum member, whichever members the enum gains later. Undefined for a name the enum
|
|
261
|
+
* does not hold.
|
|
262
|
+
*/
|
|
263
|
+
export function subsetPointColumn(subsetEnum, subsetName) {
|
|
264
|
+
const value = subsetEnum[subsetName];
|
|
265
|
+
return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
|
|
266
|
+
}
|
|
267
|
+
/**
|
|
268
|
+
* Whether the gateway-side BLOCK_BOOK replay clip still applies to history
|
|
269
|
+
* windows on this request interval.
|
|
270
|
+
*
|
|
271
|
+
* SECOND (intervalSec === 1) windows are served directly up to now since
|
|
272
|
+
* tsdb-gateway MR !1954 (coin-grouped SUM in the 1s BLOCK_BOOK_SNAPSHOT_AGG
|
|
273
|
+
* fold, gateway issue #13), so they are exempt from the client clip, and so
|
|
274
|
+
* are the other sub-minute rungs (5s 15s 30s: the 1s fold labelled and
|
|
275
|
+
* gapfilled on the bar's grid, tsdb-gateway !2189). Every other interval
|
|
276
|
+
* (MINUTE and coarser, or callers that do not declare an interval) keeps the
|
|
277
|
+
* 3-minute clip: the gateway hard-errors ("internal error") on younger
|
|
278
|
+
* windows there. If the gateway ever regresses on young SECOND windows,
|
|
279
|
+
* re-enforcing here restores the full clip and widens the seam top-up's owned
|
|
280
|
+
* window from the boot subscribe seam back to the whole young window
|
|
281
|
+
* (heatmap-seam-topup.util.ts).
|
|
282
|
+
*/
|
|
283
|
+
export const isObReplayCapEnforcedForIntervalSec = (intervalSec, exchange) => {
|
|
284
|
+
if (intervalSec === undefined || !(intervalSec > 0 && intervalSec < 60))
|
|
285
|
+
return true;
|
|
286
|
+
// The young-SECOND exemption is a PER-GATEWAY capability, not a global one:
|
|
287
|
+
// the crypto gateway serves young SECOND book windows (gw !1954), while the
|
|
288
|
+
// governed CME gate still hard-errors ("internal error") on windows younger
|
|
289
|
+
// than its 3-minute fold boundary (2026-08-12 field report: ES1! 1s heatmap
|
|
290
|
+
// refetch stuck in a transport-retry loop) and serves the other sub-minute
|
|
291
|
+
// rungs like 1s. Governed venues keep the clip; the seam boot-bridge +
|
|
292
|
+
// top-up own the young window there at 1s.
|
|
293
|
+
return isCmeGoverned(exchange);
|
|
294
|
+
};
|
|
295
|
+
/**
|
|
296
|
+
* Calculates a safe replay cap timestamp for orderbook data.
|
|
297
|
+
* Clip-enforced intervals cap at truncate(now, 3 minutes); exempt intervals
|
|
298
|
+
* (sub-minute, see isObReplayCapEnforcedForIntervalSec) cap at now. `now` is
|
|
299
|
+
* the server's: the gateway clips on its own clock, and a device clock an
|
|
300
|
+
* hour ahead put the cap an hour past it (the young window it refuses was
|
|
301
|
+
* asked), one an hour behind cut the newest hour off every window.
|
|
302
|
+
* Returns UNIX seconds.
|
|
303
|
+
*/
|
|
304
|
+
export const calculateObReplayCapInSeconds = (intervalSec, exchange) => {
|
|
305
|
+
const now = serverNowMs();
|
|
306
|
+
if (!isObReplayCapEnforcedForIntervalSec(intervalSec, exchange))
|
|
307
|
+
return Math.floor(now / 1000);
|
|
308
|
+
const replayCap = now - (now % Intervals.MINUTE3);
|
|
309
|
+
return Math.floor(replayCap / 1000);
|
|
310
|
+
};
|
|
311
|
+
/**
|
|
312
|
+
* Applies the orderbook replay cap to data requests: prevents fetching the
|
|
313
|
+
* last 3 minutes on clip-enforced intervals, passes exempt intervals
|
|
314
|
+
* (sub-minute) through capped at now.
|
|
315
|
+
*
|
|
316
|
+
* @param from - The start timestamp in seconds
|
|
317
|
+
* @param period - The period duration in seconds
|
|
318
|
+
* @param intervalSec - The request interval in seconds, when the caller knows it
|
|
319
|
+
*/
|
|
320
|
+
export const applyObReplayCap = (from, period, intervalSec, exchange) => {
|
|
321
|
+
// Ensure integer timestamps
|
|
322
|
+
const startTime = Math.floor(from);
|
|
323
|
+
const duration = Math.floor(Math.max(60, period));
|
|
324
|
+
const replayCapTime = calculateObReplayCapInSeconds(intervalSec, exchange);
|
|
325
|
+
const endTime = startTime + duration;
|
|
326
|
+
// If the entire request is before the cap, return as-is
|
|
327
|
+
if (endTime <= replayCapTime) {
|
|
328
|
+
return {
|
|
329
|
+
from: startTime,
|
|
330
|
+
period: duration,
|
|
331
|
+
};
|
|
332
|
+
}
|
|
333
|
+
// If the request starts after or at the cap, return zero period
|
|
334
|
+
if (startTime >= replayCapTime) {
|
|
335
|
+
return {
|
|
336
|
+
from: startTime,
|
|
337
|
+
period: 0, // No data available
|
|
338
|
+
};
|
|
339
|
+
}
|
|
340
|
+
// Truncate the period to end at the replay cap
|
|
341
|
+
const truncatedDuration = Math.floor(Math.max(0, replayCapTime - startTime));
|
|
342
|
+
return {
|
|
343
|
+
from: startTime,
|
|
344
|
+
period: truncatedDuration,
|
|
345
|
+
};
|
|
346
|
+
};
|
|
@@ -6,12 +6,21 @@ export interface VisibleTimeout {
|
|
|
6
6
|
/** Time since the start spent not visible; frozen once fired or cleared. */
|
|
7
7
|
hiddenMs(): number;
|
|
8
8
|
}
|
|
9
|
+
/** A host's suspended state beside the page's visibility: calls `listener` with the host's state at once and on
|
|
10
|
+
* every change, and answers the unsubscribe (wrun-chart-host's `clock.watchHostSuspended`). */
|
|
11
|
+
export type VisibleTimeoutSuspendedWatch = (listener: (suspended: boolean) => void) => () => void;
|
|
12
|
+
export interface VisibleTimeoutOptions {
|
|
13
|
+
/** The host's suspended state: the clock pauses while it reads suspended, as while the page is hidden. Absent,
|
|
14
|
+
* only the page's visibility pauses it. */
|
|
15
|
+
watchSuspended?: VisibleTimeoutSuspendedWatch;
|
|
16
|
+
}
|
|
9
17
|
/**
|
|
10
18
|
* Runs `callback` once `budgetMs` of visible time has passed since the call. Outside a
|
|
11
19
|
* browser (no `document`) every millisecond counts, as with a plain timeout, and so it
|
|
12
20
|
* does for a document that reports no visibility state: only an explicit `hidden`
|
|
13
|
-
* pauses the clock, so a deadline can never be parked forever by a missing API.
|
|
14
|
-
*
|
|
15
|
-
*
|
|
21
|
+
* pauses the clock, so a deadline can never be parked forever by a missing API. A host's
|
|
22
|
+
* suspension (`options.watchSuspended`) pauses it too. Whatever a deadline armed is
|
|
23
|
+
* released by `clear()`, by its own fire, and so by a caller's re-arm (clear the old
|
|
24
|
+
* handle, start a new one).
|
|
16
25
|
*/
|
|
17
|
-
export declare function startVisibleTimeout(callback: () => unknown, budgetMs: number): VisibleTimeout;
|
|
26
|
+
export declare function startVisibleTimeout(callback: () => unknown, budgetMs: number, options?: VisibleTimeoutOptions): VisibleTimeout;
|
|
@@ -8,19 +8,26 @@
|
|
|
8
8
|
// while hidden, the clock starts at the first visible moment, so the callback only
|
|
9
9
|
// ever runs while the tab is visible.
|
|
10
10
|
//
|
|
11
|
+
// A host can suspend its chart while the page stays visible (an app backgrounded,
|
|
12
|
+
// or its chart tab blurred, in a web view that keeps `visible`): a deadline handed
|
|
13
|
+
// the host's watch (`watchSuspended`) also pauses while the host reads suspended,
|
|
14
|
+
// on the same edges as a hide.
|
|
15
|
+
//
|
|
11
16
|
// Deliberately no import: the chart boot path loads it (hidden-paced-loop.util says
|
|
12
17
|
// why a leaf here must not pull document-visibility.util in).
|
|
13
18
|
/**
|
|
14
19
|
* Runs `callback` once `budgetMs` of visible time has passed since the call. Outside a
|
|
15
20
|
* browser (no `document`) every millisecond counts, as with a plain timeout, and so it
|
|
16
21
|
* does for a document that reports no visibility state: only an explicit `hidden`
|
|
17
|
-
* pauses the clock, so a deadline can never be parked forever by a missing API.
|
|
18
|
-
*
|
|
19
|
-
*
|
|
22
|
+
* pauses the clock, so a deadline can never be parked forever by a missing API. A host's
|
|
23
|
+
* suspension (`options.watchSuspended`) pauses it too. Whatever a deadline armed is
|
|
24
|
+
* released by `clear()`, by its own fire, and so by a caller's re-arm (clear the old
|
|
25
|
+
* handle, start a new one).
|
|
20
26
|
*/
|
|
21
|
-
export function startVisibleTimeout(callback, budgetMs) {
|
|
27
|
+
export function startVisibleTimeout(callback, budgetMs, options) {
|
|
22
28
|
const doc = typeof document === 'undefined' ? null : document;
|
|
23
|
-
|
|
29
|
+
let hostSuspended = false;
|
|
30
|
+
const isVisible = () => doc?.visibilityState !== 'hidden' && !hostSuspended;
|
|
24
31
|
// Monotonic, like the timers themselves: a wall-clock jump must not bank visible time.
|
|
25
32
|
const now = () => performance.now();
|
|
26
33
|
const startedAt = now();
|
|
@@ -43,6 +50,7 @@ export function startVisibleTimeout(callback, budgetMs) {
|
|
|
43
50
|
pause();
|
|
44
51
|
stoppedAt = now();
|
|
45
52
|
doc?.removeEventListener?.('visibilitychange', onVisibilityChange);
|
|
53
|
+
unwatchSuspended?.();
|
|
46
54
|
};
|
|
47
55
|
const fire = () => {
|
|
48
56
|
timer = null;
|
|
@@ -53,8 +61,10 @@ export function startVisibleTimeout(callback, budgetMs) {
|
|
|
53
61
|
visibleSince = now();
|
|
54
62
|
timer = setTimeout(fire, Math.max(0, budgetMs - bankedVisibleMs));
|
|
55
63
|
};
|
|
56
|
-
// Acts on edges only: a repeated `visible` never stacks a second timer.
|
|
64
|
+
// Acts on edges only: a repeated `visible` never stacks a second timer, and a stopped deadline arms nothing.
|
|
57
65
|
function onVisibilityChange() {
|
|
66
|
+
if (stoppedAt !== null)
|
|
67
|
+
return;
|
|
58
68
|
const visible = isVisible();
|
|
59
69
|
if (visible && visibleSince === null)
|
|
60
70
|
resume();
|
|
@@ -62,8 +72,13 @@ export function startVisibleTimeout(callback, budgetMs) {
|
|
|
62
72
|
pause();
|
|
63
73
|
}
|
|
64
74
|
doc?.addEventListener?.('visibilitychange', onVisibilityChange);
|
|
65
|
-
|
|
66
|
-
|
|
75
|
+
// The host's watch answers its state at once (before the first arm) and on every change; its listener never stops
|
|
76
|
+
// the deadline, so `stop` reads the unwatch only once it is set.
|
|
77
|
+
const unwatchSuspended = options?.watchSuspended?.((suspended) => {
|
|
78
|
+
hostSuspended = suspended;
|
|
79
|
+
onVisibilityChange();
|
|
80
|
+
});
|
|
81
|
+
onVisibilityChange();
|
|
67
82
|
return {
|
|
68
83
|
clear: stop,
|
|
69
84
|
visibleElapsedMs: () => visibleAt(now()),
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function formatExchangeDisplay(exchange: string, displayTransformations?: string): string;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A venue's display code (a leaf of utility/exchange-format.util.ts; P2/inventory.md section 1.1):
|
|
3
|
+
* `formatExchangeDisplay`, the exchange the chart header shows ("BINANCE.F", "OKX.F", "FRED"). The old module also
|
|
4
|
+
* reads the i18n plugin (formatExchangeName's suffix words), which keeps it out of the chart-host package; this leaf
|
|
5
|
+
* reads only the source delimiter (constants/data-source.constants, a package module) and moves with the phase 2
|
|
6
|
+
* closure. The old module re-exports it.
|
|
7
|
+
*/
|
|
8
|
+
import { delimiter } from '../constants/data-source.constants.js';
|
|
9
|
+
export function formatExchangeDisplay(exchange, displayTransformations) {
|
|
10
|
+
if (exchange.toUpperCase() === 'SOLANA_ONCHAIN')
|
|
11
|
+
return 'Solana';
|
|
12
|
+
const suffixMap = {
|
|
13
|
+
_FUTURE: '.F',
|
|
14
|
+
_FUTURES: '.F',
|
|
15
|
+
_PERPETUAL: '.F',
|
|
16
|
+
_OPTION: '.O',
|
|
17
|
+
_OPTIONS: '.O',
|
|
18
|
+
_DERIVATIVES: '.D',
|
|
19
|
+
_SWAP: '.S',
|
|
20
|
+
_SPOT: '',
|
|
21
|
+
};
|
|
22
|
+
const applyTransformations = (exchangeString) => {
|
|
23
|
+
const result = exchangeString
|
|
24
|
+
.replace('PYTH_NETWORK', 'PYTH')
|
|
25
|
+
.replace('GATE_IO', 'GATE.IO')
|
|
26
|
+
.replace('OKEX_SWAP', 'OKX.F')
|
|
27
|
+
.replace('OKEX', 'OKX');
|
|
28
|
+
for (const [suffix, replacement] of Object.entries(suffixMap)) {
|
|
29
|
+
if (result.endsWith(suffix)) {
|
|
30
|
+
return result.slice(0, -suffix.length) + replacement;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
return result;
|
|
34
|
+
};
|
|
35
|
+
// FRED is the St. Louis Fed's database, not the series' publisher (UNRATE is BLS data),
|
|
36
|
+
// so it always reads "FRED"; older picks stored "FEDERAL RESERVE" as the display venue.
|
|
37
|
+
if (exchange === 'FRED')
|
|
38
|
+
return 'FRED';
|
|
39
|
+
if (!displayTransformations) {
|
|
40
|
+
return applyTransformations(exchange);
|
|
41
|
+
}
|
|
42
|
+
if (delimiter && displayTransformations.includes(delimiter)) {
|
|
43
|
+
const exchangeDisplay = displayTransformations.split(delimiter)[0];
|
|
44
|
+
return applyTransformations(exchangeDisplay);
|
|
45
|
+
}
|
|
46
|
+
return applyTransformations(displayTransformations);
|
|
47
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import type { EarningsEventKind, MarketEventsCoverage } from '../../interfaces/market-event.interface.js';
|
|
2
|
+
export declare const DAY_MS: number;
|
|
3
|
+
/** What one slice holds: one kind, one ticker or every ticker, the major companies (impact >= 2) or all of them. */
|
|
4
|
+
export interface EarningsScope {
|
|
5
|
+
kind: EarningsEventKind;
|
|
6
|
+
ticker: string | null;
|
|
7
|
+
majorOnly: boolean;
|
|
8
|
+
/** Epoch ms; normalized down to its UTC day. */
|
|
9
|
+
from: number;
|
|
10
|
+
/** Epoch ms, exclusive; normalized up to a UTC midnight. */
|
|
11
|
+
to: number;
|
|
12
|
+
}
|
|
13
|
+
/** A half-open span of whole UTC days, [from, to). */
|
|
14
|
+
export interface EarningsWindow {
|
|
15
|
+
from: number;
|
|
16
|
+
to: number;
|
|
17
|
+
}
|
|
18
|
+
/** The ticker filter the backend accepts (`^[A-Z][A-Z0-9.\-]{0,9}$`, upper case). */
|
|
19
|
+
export declare const EARNINGS_TICKER_PATTERN: RegExp;
|
|
20
|
+
/** `YYYY-MM-DD` of the UTC day an instant falls in. */
|
|
21
|
+
export declare function utcDayKey(ms: number): string;
|
|
22
|
+
/** A ticker as the slices key it: trimmed, upper case, null for none. */
|
|
23
|
+
export declare function normalizeEarningsTicker(ticker: string | null | undefined): string | null;
|
|
24
|
+
/** The scope's window on whole UTC days: `from` down to its midnight, `to` up to the next one (at least one day). */
|
|
25
|
+
export declare function earningsWindow(scope: Pick<EarningsScope, 'from' | 'to'>): EarningsWindow;
|
|
26
|
+
/** The scope every reader agrees on: the ticker normalized, the window on whole UTC days. */
|
|
27
|
+
export declare function normalizeEarningsScope(scope: EarningsScope): EarningsScope;
|
|
28
|
+
/**
|
|
29
|
+
* `${kind}|${ticker ?? '*'}|${majorOnly ? 'major' : 'all'}|${fromDay}|${toDay}`,
|
|
30
|
+
* the days `YYYY-MM-DD` of the normalized window (`toDay` is its exclusive
|
|
31
|
+
* end): `earnings|*|major|2026-10-01|2026-10-22`.
|
|
32
|
+
*/
|
|
33
|
+
export declare function earningsScopeKey(scope: EarningsScope): string;
|
|
34
|
+
/** The kind an earnings scope key names; null for anything else (an asset class, a malformed key). */
|
|
35
|
+
export declare function earningsKeyKind(key: string): EarningsEventKind | null;
|
|
36
|
+
/**
|
|
37
|
+
* The list: the week behind today and the two ahead as days of the chart's
|
|
38
|
+
* zone, [today − 7 d, today + 14 d), rounded out to whole UTC days so no zone
|
|
39
|
+
* day is cut at either edge. In UTC that is exactly [today − 7 d, today + 14 d).
|
|
40
|
+
*/
|
|
41
|
+
export declare function listWindow(now: number, offsetMs?: number): EarningsWindow;
|
|
42
|
+
/**
|
|
43
|
+
* One calendar month of the chart's zone (`month` 0 to 11 as
|
|
44
|
+
* `Date#getUTCMonth()` reads it), rounded out to whole UTC days. A zone east
|
|
45
|
+
* of UTC starts its month before UTC midnight: a US after-close print on the
|
|
46
|
+
* zone's 1st would otherwise fall out of both months.
|
|
47
|
+
*/
|
|
48
|
+
export declare function monthWindow(year: number, month: number, offsetMs?: number): EarningsWindow;
|
|
49
|
+
/**
|
|
50
|
+
* One ticker's whole stored horizon, [today − 400 d, today + 90 d): 490 days,
|
|
51
|
+
* allowed because a ticker query is not held to the 92-day span of a broad one.
|
|
52
|
+
*/
|
|
53
|
+
export declare function tickerWindow(now: number): EarningsWindow;
|
|
54
|
+
/**
|
|
55
|
+
* Whether a span [from, to) lies inside the served coverage. The served `to`
|
|
56
|
+
* may be an exclusive midnight or the last instant of its day; both read the
|
|
57
|
+
* same. No coverage covers nothing: those days show as unavailable, which is
|
|
58
|
+
* not the same as a day with zero reports.
|
|
59
|
+
*/
|
|
60
|
+
export declare function coverageIncludes(coverage: MarketEventsCoverage | null, from: number, to: number): boolean;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
export const DAY_MS = 24 * 60 * 60 * 1000;
|
|
2
|
+
/** The ticker filter the backend accepts (`^[A-Z][A-Z0-9.\-]{0,9}$`, upper case). */
|
|
3
|
+
export const EARNINGS_TICKER_PATTERN = /^[A-Z][A-Z0-9.-]{0,9}$/;
|
|
4
|
+
const floorUtcDay = (ms) => Math.floor(ms / DAY_MS) * DAY_MS;
|
|
5
|
+
const ceilUtcDay = (ms) => Math.ceil(ms / DAY_MS) * DAY_MS;
|
|
6
|
+
const pad2 = (value) => String(value).padStart(2, '0');
|
|
7
|
+
/** `YYYY-MM-DD` of the UTC day an instant falls in. */
|
|
8
|
+
export function utcDayKey(ms) {
|
|
9
|
+
const day = new Date(ms);
|
|
10
|
+
return `${day.getUTCFullYear()}-${pad2(day.getUTCMonth() + 1)}-${pad2(day.getUTCDate())}`;
|
|
11
|
+
}
|
|
12
|
+
/** A ticker as the slices key it: trimmed, upper case, null for none. */
|
|
13
|
+
export function normalizeEarningsTicker(ticker) {
|
|
14
|
+
const value = (ticker ?? '').trim().toUpperCase();
|
|
15
|
+
return value.length > 0 ? value : null;
|
|
16
|
+
}
|
|
17
|
+
/** The scope's window on whole UTC days: `from` down to its midnight, `to` up to the next one (at least one day). */
|
|
18
|
+
export function earningsWindow(scope) {
|
|
19
|
+
const from = floorUtcDay(scope.from);
|
|
20
|
+
const ceiled = ceilUtcDay(scope.to);
|
|
21
|
+
return { from, to: ceiled > from ? ceiled : from + DAY_MS };
|
|
22
|
+
}
|
|
23
|
+
/** The scope every reader agrees on: the ticker normalized, the window on whole UTC days. */
|
|
24
|
+
export function normalizeEarningsScope(scope) {
|
|
25
|
+
return {
|
|
26
|
+
kind: scope.kind,
|
|
27
|
+
ticker: normalizeEarningsTicker(scope.ticker),
|
|
28
|
+
majorOnly: scope.majorOnly === true,
|
|
29
|
+
...earningsWindow(scope),
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* `${kind}|${ticker ?? '*'}|${majorOnly ? 'major' : 'all'}|${fromDay}|${toDay}`,
|
|
34
|
+
* the days `YYYY-MM-DD` of the normalized window (`toDay` is its exclusive
|
|
35
|
+
* end): `earnings|*|major|2026-10-01|2026-10-22`.
|
|
36
|
+
*/
|
|
37
|
+
export function earningsScopeKey(scope) {
|
|
38
|
+
const normalized = normalizeEarningsScope(scope);
|
|
39
|
+
return [
|
|
40
|
+
normalized.kind,
|
|
41
|
+
normalized.ticker ?? '*',
|
|
42
|
+
normalized.majorOnly ? 'major' : 'all',
|
|
43
|
+
utcDayKey(normalized.from),
|
|
44
|
+
utcDayKey(normalized.to),
|
|
45
|
+
].join('|');
|
|
46
|
+
}
|
|
47
|
+
/** The kind an earnings scope key names; null for anything else (an asset class, a malformed key). */
|
|
48
|
+
export function earningsKeyKind(key) {
|
|
49
|
+
if (key.startsWith('earnings|'))
|
|
50
|
+
return 'earnings';
|
|
51
|
+
if (key.startsWith('dividend|'))
|
|
52
|
+
return 'dividend';
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* The list: the week behind today and the two ahead as days of the chart's
|
|
57
|
+
* zone, [today − 7 d, today + 14 d), rounded out to whole UTC days so no zone
|
|
58
|
+
* day is cut at either edge. In UTC that is exactly [today − 7 d, today + 14 d).
|
|
59
|
+
*/
|
|
60
|
+
export function listWindow(now, offsetMs = 0) {
|
|
61
|
+
const today = Math.floor((now + offsetMs) / DAY_MS) * DAY_MS - offsetMs;
|
|
62
|
+
return { from: floorUtcDay(today - 7 * DAY_MS), to: ceilUtcDay(today + 14 * DAY_MS) };
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* One calendar month of the chart's zone (`month` 0 to 11 as
|
|
66
|
+
* `Date#getUTCMonth()` reads it), rounded out to whole UTC days. A zone east
|
|
67
|
+
* of UTC starts its month before UTC midnight: a US after-close print on the
|
|
68
|
+
* zone's 1st would otherwise fall out of both months.
|
|
69
|
+
*/
|
|
70
|
+
export function monthWindow(year, month, offsetMs = 0) {
|
|
71
|
+
return {
|
|
72
|
+
from: floorUtcDay(Date.UTC(year, month, 1) - offsetMs),
|
|
73
|
+
to: ceilUtcDay(Date.UTC(year, month + 1, 1) - offsetMs),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* One ticker's whole stored horizon, [today − 400 d, today + 90 d): 490 days,
|
|
78
|
+
* allowed because a ticker query is not held to the 92-day span of a broad one.
|
|
79
|
+
*/
|
|
80
|
+
export function tickerWindow(now) {
|
|
81
|
+
const today = floorUtcDay(now);
|
|
82
|
+
return { from: today - 400 * DAY_MS, to: today + 90 * DAY_MS };
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Whether a span [from, to) lies inside the served coverage. The served `to`
|
|
86
|
+
* may be an exclusive midnight or the last instant of its day; both read the
|
|
87
|
+
* same. No coverage covers nothing: those days show as unavailable, which is
|
|
88
|
+
* not the same as a day with zero reports.
|
|
89
|
+
*/
|
|
90
|
+
export function coverageIncludes(coverage, from, to) {
|
|
91
|
+
return coverage !== null && from >= coverage.from && to <= coverage.to + 1;
|
|
92
|
+
}
|