@orangecharts/wrun-chart-host 0.6.0 → 0.7.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 +13 -5
- package/dist/constants/marketCapabilities.constants.d.ts +5 -0
- package/dist/constants/marketCapabilities.constants.js +16 -0
- package/dist/host-ports.types.d.ts +35 -3
- package/dist/index.d.ts +11 -1
- package/dist/index.js +11 -1
- package/dist/indicators/controls/tpo-session.util.js +42 -18
- package/dist/market-data/billing.interface.d.ts +2 -1
- package/dist/settings-templates/indicator-fields.js +10 -0
- package/dist/utility/chart/crypto-index.leaf.d.ts +16 -0
- package/dist/utility/chart/crypto-index.leaf.js +19 -0
- package/dist/utility/chart/index-mode-admission.util.js +9 -1
- package/dist/utility/chart/index-mode.util.d.ts +11 -5
- package/dist/utility/chart/index-mode.util.js +22 -10
- package/dist/utility/chart/kscript-source-answer-budget.leaf.d.ts +36 -0
- package/dist/utility/chart/kscript-source-answer-budget.leaf.js +39 -0
- package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +38 -1
- package/dist/utility/chart/kscript-source-degrade.leaf.js +39 -1
- package/dist/utility/chart/live-bucket.util.d.ts +2 -1
- package/dist/utility/chart/live-bucket.util.js +47 -15
- package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +15 -1
- package/dist/utility/chart/local-kscript-warmup-depth.util.js +9 -0
- package/dist/utility/chart/market-session-schedule.util.d.ts +3 -1
- package/dist/utility/chart/market-session-schedule.util.js +24 -2
- package/dist/utility/chart/marketKind.util.d.ts +12 -7
- package/dist/utility/chart/marketKind.util.js +15 -5
- package/dist/utility/chart/ny-calendar.util.d.ts +104 -0
- package/dist/utility/chart/ny-calendar.util.js +346 -0
- package/dist/utility/chart/om-panel.util.d.ts +14 -2
- package/dist/utility/chart/om-panel.util.js +108 -40
- package/dist/utility/chart/rth-session.util.d.ts +10 -7
- package/dist/utility/chart/rth-session.util.js +17 -22
- package/dist/utility/chart/trading-day.util.js +90 -18
- package/dist/utility/chart/us-equities-session.util.js +20 -67
- package/dist/utility/chart/wrun-bar-session-facts.util.js +14 -1
- package/dist/utility/common/time.util.d.ts +7 -1
- package/dist/utility/common/time.util.js +11 -41
- package/dist/utility/number-format.util.d.ts +17 -7
- package/dist/utility/number-format.util.js +18 -8
- package/dist/utility/options/option-symbol.util.js +13 -2
- package/dist/utility/symbol-selection/contract-expiry.util.js +9 -1
- package/dist/utility/watchlist/import/import-request.leaf.d.ts +4 -1
- package/dist/utility/watchlist/import/import-request.leaf.js +5 -2
- package/dist/utility/watchlist/import/tradingview-symbols.leaf.d.ts +25 -4
- package/dist/utility/watchlist/import/tradingview-symbols.leaf.js +62 -4
- package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +19 -0
- package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +57 -0
- package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +23 -0
- package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +90 -0
- package/dist/utility/wrun/run-schedule/wrun-lane-groups.util.d.ts +39 -0
- package/dist/utility/wrun/run-schedule/wrun-lane-groups.util.js +60 -0
- package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +77 -0
- package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +195 -0
- package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +56 -0
- package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +70 -0
- package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +53 -0
- package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +239 -0
- package/dist/utility/wrun/sources/lanes/option_stats_10m.d.ts +16 -0
- package/dist/utility/wrun/sources/lanes/option_stats_10m.js +14 -0
- package/dist/utility/wrun/sources/lanes/options_flow.d.ts +43 -18
- package/dist/utility/wrun/sources/lanes/options_flow.js +209 -72
- package/dist/utility/wrun/sources/lanes/token_supply.js +5 -31
- package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +3 -18
- package/dist/utility/wrun/sources/opra-option-lanes.util.js +12 -57
- package/dist/utility/wrun/sources/row-lane-registry.d.ts +1 -1
- package/dist/utility/wrun/sources/row-lane-registry.js +22 -8
- package/dist/utility/wrun/sources/row-lanes/option_contract_flow.d.ts +61 -0
- package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +103 -8
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +5 -0
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +24 -12
- package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +55 -0
- package/dist/utility/wrun/sources/row-lanes/option_prints.js +95 -18
- package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +15 -1
- package/dist/utility/wrun/sources/row-lanes/option_strikes.js +23 -8
- package/dist/utility/wrun/sources/row-lanes/option_surface.js +11 -11
- package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +14 -2
- package/dist/utility/wrun/sources/wrun-poll-lane.types.js +6 -3
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +43 -8
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +77 -11
- package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -16
- package/dist/utility/wrun/sources/wrun-row-lane.types.js +2 -0
- package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +52 -12
- package/dist/utility/wrun/sources/wrun-row-lanes.util.js +110 -46
- package/dist/utility/wrun/wrun-browser-sources.leaf.d.ts +10 -0
- package/dist/utility/wrun/wrun-browser-sources.leaf.js +12 -0
- package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +3 -3
- package/dist/utility/wrun/wrun-coin-lane-live.util.js +53 -18
- package/dist/utility/wrun/wrun-color-settings.util.d.ts +6 -0
- package/dist/utility/wrun/wrun-color-settings.util.js +45 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.js +14 -8
- package/dist/utility/wrun/wrun-failure-cause.d.ts +1 -1
- package/dist/utility/wrun/wrun-failure-cause.js +14 -0
- package/dist/utility/wrun/wrun-frames.js +6 -2
- package/dist/utility/wrun/wrun-host.service.d.ts +26 -18
- package/dist/utility/wrun/wrun-host.service.js +49 -52
- package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +1 -1
- package/dist/utility/wrun/wrun-hosted-wire-caps.js +2 -0
- package/dist/utility/wrun/wrun-input-requirements.leaf.js +7 -4
- package/dist/utility/wrun/wrun-kit-run-tables.util.d.ts +24 -0
- package/dist/utility/wrun/wrun-kit-run-tables.util.js +87 -0
- package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +2 -1
- package/dist/utility/wrun/wrun-live-tick.util.d.ts +8 -2
- package/dist/utility/wrun/wrun-live-tick.util.js +35 -16
- package/dist/utility/wrun/wrun-opra-flow.leaf.d.ts +40 -13
- package/dist/utility/wrun/wrun-opra-flow.leaf.js +39 -12
- package/dist/utility/wrun/wrun-option-contract-flow.util.d.ts +70 -21
- package/dist/utility/wrun/wrun-option-contract-flow.util.js +257 -112
- package/dist/utility/wrun/wrun-option-prints.util.d.ts +62 -22
- package/dist/utility/wrun/wrun-option-prints.util.js +148 -46
- package/dist/utility/wrun/wrun-option-views.util.d.ts +262 -0
- package/dist/utility/wrun/wrun-option-views.util.js +356 -0
- package/dist/utility/wrun/wrun-options-chain.util.d.ts +23 -2
- package/dist/utility/wrun/wrun-options-chain.util.js +37 -3
- package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +18 -3
- package/dist/utility/wrun/wrun-overlay-drivers.util.js +32 -7
- package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +9 -3
- package/dist/utility/wrun/wrun-overlay-recovery.util.js +146 -18
- package/dist/utility/wrun/wrun-overlay-run.util.d.ts +50 -6
- package/dist/utility/wrun/wrun-overlay-run.util.js +816 -243
- package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +5 -0
- package/dist/utility/wrun/wrun-pin-spelling.util.js +28 -12
- package/dist/utility/wrun/wrun-pin-venues.util.js +4 -6
- package/dist/utility/wrun/wrun-present-bits.util.d.ts +9 -0
- package/dist/utility/wrun/wrun-present-bits.util.js +39 -0
- package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +3 -2
- package/dist/utility/wrun/wrun-refusal-surface.util.js +5 -4
- package/dist/utility/wrun/wrun-refusal.util.d.ts +66 -6
- package/dist/utility/wrun/wrun-refusal.util.js +335 -40
- package/dist/utility/wrun/wrun-source-rows.util.js +11 -0
- package/dist/utility/wrun/wrun-tier-grid.util.d.ts +28 -3
- package/dist/utility/wrun/wrun-tier-grid.util.js +79 -19
- package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +14 -3
- package/dist/utility/wrun/wrun-transient-rerun.util.js +33 -8
- package/package.json +5 -5
- package/dist/utility/wrun/wrun-opra-underlying.util.d.ts +0 -12
- package/dist/utility/wrun/wrun-opra-underlying.util.js +0 -1
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The source answer budget: the most one kScript source answer may hold, in bytes at 8 per numeric cell (the row
|
|
3
|
+
* cache's estimate, `estimateKScriptSourceRowsBytes`). It is the one size limit every layer a source answer crosses
|
|
4
|
+
* reads, so the layers cannot disagree again (OPTFLOW-HANG, field dump 2026-10-20 17:50 SGT):
|
|
5
|
+
*
|
|
6
|
+
* - the row lanes plan their asks to fit it (`rowBudget`, wrun-row-lanes.util `wrunRowLaneMaxRows`): the newest bars
|
|
7
|
+
* whose projected rows fit are read, every older asked bar is partial;
|
|
8
|
+
* - a worker twin that holds its own row cap fails an answer past the CEILING loudly (never truncated);
|
|
9
|
+
* - the source row cache keeps an answer up to the ceiling, so a planned answer is always kept and a rerun (the
|
|
10
|
+
* source ladder's rung, a remount, a lazy refresh) reads it instead of asking the wire again;
|
|
11
|
+
* - the source fetch boundary rings `kscript-source-answer-over-budget` for an answer past the budget, and the dump's
|
|
12
|
+
* `sourceAnswerOverBudget` verdict counts them.
|
|
13
|
+
*
|
|
14
|
+
* The field case it closes: SPY 1h with Premium by Strike and Strike Footprint. The contract flow lane sized each ask
|
|
15
|
+
* by the worker's 500,000-row failure cap (about 25 MB on the wire, 25 s), past the lane's own deadline (10.6 s for
|
|
16
|
+
* 252 bars) and the row cache's 8 MiB entry cap: the lane degraded before the answer landed, the cache refused the
|
|
17
|
+
* late answer, the source ladder asked again, and neither indicator painted. Each answer that landed crossed to the
|
|
18
|
+
* page as one structured clone of about 400,000 nested arrays (2.7 s on the main thread).
|
|
19
|
+
*
|
|
20
|
+
* Why 8 MiB: the cache's entry cap before this budget existed, and about 1.6 MB on the wire for SPY's contract flow
|
|
21
|
+
* (measured 2026-10-20 on INT: about 35 bytes a row), answered in 2 to 5 s, inside the lane deadline's 10 s floor.
|
|
22
|
+
* Raising it is one edit here: every layer follows. A deeper read needs a smaller answer, not a bigger budget (the
|
|
23
|
+
* per-strike fold, UW-PARITY design/STRIKE-FLOW-SCOPE.md).
|
|
24
|
+
*/
|
|
25
|
+
/** Bytes one numeric cell weighs in every estimate of a source answer. */
|
|
26
|
+
export declare const KSCRIPT_SOURCE_CELL_BYTES = 8;
|
|
27
|
+
/** The bytes a planned source answer stays within. */
|
|
28
|
+
export declare const KSCRIPT_SOURCE_ANSWER_BUDGET_BYTES: number;
|
|
29
|
+
/**
|
|
30
|
+
* The bytes a source answer may reach at all: twice the budget. A plan projects its rows from a measured session; a
|
|
31
|
+
* busier session can land past the budget, and up to the ceiling it is still delivered, cached and rung (flagged);
|
|
32
|
+
* past it a worker twin with its own row cap fails the request by name.
|
|
33
|
+
*/
|
|
34
|
+
export declare const KSCRIPT_SOURCE_ANSWER_CEILING_BYTES: number;
|
|
35
|
+
/** The rows of `cellsPerRow` numeric cells each that fit `bytes` (the budget by default); at least one. */
|
|
36
|
+
export declare function kScriptSourceAnswerRows(cellsPerRow: number, bytes?: number): number;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The source answer budget: the most one kScript source answer may hold, in bytes at 8 per numeric cell (the row
|
|
3
|
+
* cache's estimate, `estimateKScriptSourceRowsBytes`). It is the one size limit every layer a source answer crosses
|
|
4
|
+
* reads, so the layers cannot disagree again (OPTFLOW-HANG, field dump 2026-10-20 17:50 SGT):
|
|
5
|
+
*
|
|
6
|
+
* - the row lanes plan their asks to fit it (`rowBudget`, wrun-row-lanes.util `wrunRowLaneMaxRows`): the newest bars
|
|
7
|
+
* whose projected rows fit are read, every older asked bar is partial;
|
|
8
|
+
* - a worker twin that holds its own row cap fails an answer past the CEILING loudly (never truncated);
|
|
9
|
+
* - the source row cache keeps an answer up to the ceiling, so a planned answer is always kept and a rerun (the
|
|
10
|
+
* source ladder's rung, a remount, a lazy refresh) reads it instead of asking the wire again;
|
|
11
|
+
* - the source fetch boundary rings `kscript-source-answer-over-budget` for an answer past the budget, and the dump's
|
|
12
|
+
* `sourceAnswerOverBudget` verdict counts them.
|
|
13
|
+
*
|
|
14
|
+
* The field case it closes: SPY 1h with Premium by Strike and Strike Footprint. The contract flow lane sized each ask
|
|
15
|
+
* by the worker's 500,000-row failure cap (about 25 MB on the wire, 25 s), past the lane's own deadline (10.6 s for
|
|
16
|
+
* 252 bars) and the row cache's 8 MiB entry cap: the lane degraded before the answer landed, the cache refused the
|
|
17
|
+
* late answer, the source ladder asked again, and neither indicator painted. Each answer that landed crossed to the
|
|
18
|
+
* page as one structured clone of about 400,000 nested arrays (2.7 s on the main thread).
|
|
19
|
+
*
|
|
20
|
+
* Why 8 MiB: the cache's entry cap before this budget existed, and about 1.6 MB on the wire for SPY's contract flow
|
|
21
|
+
* (measured 2026-10-20 on INT: about 35 bytes a row), answered in 2 to 5 s, inside the lane deadline's 10 s floor.
|
|
22
|
+
* Raising it is one edit here: every layer follows. A deeper read needs a smaller answer, not a bigger budget (the
|
|
23
|
+
* per-strike fold, UW-PARITY design/STRIKE-FLOW-SCOPE.md).
|
|
24
|
+
*/
|
|
25
|
+
/** Bytes one numeric cell weighs in every estimate of a source answer. */
|
|
26
|
+
export const KSCRIPT_SOURCE_CELL_BYTES = 8;
|
|
27
|
+
/** The bytes a planned source answer stays within. */
|
|
28
|
+
export const KSCRIPT_SOURCE_ANSWER_BUDGET_BYTES = 8 * 1024 * 1024;
|
|
29
|
+
/**
|
|
30
|
+
* The bytes a source answer may reach at all: twice the budget. A plan projects its rows from a measured session; a
|
|
31
|
+
* busier session can land past the budget, and up to the ceiling it is still delivered, cached and rung (flagged);
|
|
32
|
+
* past it a worker twin with its own row cap fails the request by name.
|
|
33
|
+
*/
|
|
34
|
+
export const KSCRIPT_SOURCE_ANSWER_CEILING_BYTES = 2 * KSCRIPT_SOURCE_ANSWER_BUDGET_BYTES;
|
|
35
|
+
/** The rows of `cellsPerRow` numeric cells each that fit `bytes` (the budget by default); at least one. */
|
|
36
|
+
export function kScriptSourceAnswerRows(cellsPerRow, bytes = KSCRIPT_SOURCE_ANSWER_BUDGET_BYTES) {
|
|
37
|
+
const width = Number.isFinite(cellsPerRow) && cellsPerRow >= 1 ? Math.floor(cellsPerRow) : 1;
|
|
38
|
+
return Math.max(1, Math.floor(bytes / (width * KSCRIPT_SOURCE_CELL_BYTES)));
|
|
39
|
+
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* A secondary source's retry and budget numbers (a leaf of utility/chart/kscript-source-degrade.util.ts;
|
|
3
|
-
* P2/inventory.md section 1.1): the constants recovery reads
|
|
3
|
+
* P2/inventory.md section 1.1): the constants recovery reads, the budget the executor reads and the send anchor both
|
|
4
|
+
* source lanes (the kScript engine proxy, the wrun run's lanes) count it from. The degrade registry and
|
|
4
5
|
* its mutators stay in the old module (the chart store and the engine manager share it) behind the chart-host members
|
|
5
6
|
* `chart.markSourcesTerminal`, `chart.markSourceDegraded` and the rest; this leaf holds no state, so it moves into the
|
|
6
7
|
* chart-host package with the phase 2 closure. The old module re-exports it.
|
|
@@ -21,6 +22,14 @@
|
|
|
21
22
|
* per-overlay registry the legend chip is DERIVED from at the diagnostics
|
|
22
23
|
* choke point (chart.ts setIndicatorDiagnostics), so no diagnostics writer
|
|
23
24
|
* can drop the chip and no writer ever sets it directly.
|
|
25
|
+
*
|
|
26
|
+
* On the wrun lane the budget is a paint deadline and stays the chip's
|
|
27
|
+
* authority: counted from the lane's send (resolveSecondarySourceDeadlineMs),
|
|
28
|
+
* a lane still out at it degrades and the run paints without it,
|
|
29
|
+
* while its read (abandoned, never aborted) is joined or adopted by the next
|
|
30
|
+
* run and the source ladder instead of asked again
|
|
31
|
+
* (wrun/run-schedule/wrun-late-reads.util). The read's own bound is the fetch
|
|
32
|
+
* deadline (wrun-deadline.util WRUN_SOURCE_FETCH_DEADLINE_MS).
|
|
24
33
|
*/
|
|
25
34
|
/**
|
|
26
35
|
* Base budget (the floor). Provisional instrumented SLO (2026-09-03): the
|
|
@@ -50,6 +59,34 @@ export declare function resolveSecondarySourceBudgetMs(window: {
|
|
|
50
59
|
toMs?: number;
|
|
51
60
|
intervalMs?: number;
|
|
52
61
|
}): number;
|
|
62
|
+
/**
|
|
63
|
+
* Absolute cap measured from the moment a source request was asked (the
|
|
64
|
+
* engine proxy's request arrival, a wrun lane's dispatch): the send anchor
|
|
65
|
+
* may move the deadline to send + budget, but never past this, so a request
|
|
66
|
+
* that sits queued on the main thread, behind the socket's open or in the
|
|
67
|
+
* worker's queue (or never goes out) still degrades in bounded time.
|
|
68
|
+
*/
|
|
69
|
+
export declare const KSCRIPT_SECONDARY_SOURCE_DISPATCH_CAP_MS = 60000;
|
|
70
|
+
/**
|
|
71
|
+
* When a secondary source request degrades (on the caller's clock), the one
|
|
72
|
+
* anchor rule the kScript engine lane and the wrun lanes share: the budget
|
|
73
|
+
* counts from the moment the request went to the wire (`dispatchedAtMs`),
|
|
74
|
+
* never past `capMs` from the moment it was asked (`startedAtMs`), and never
|
|
75
|
+
* before the budget counted from the ask (a cap below the budget is lifted to
|
|
76
|
+
* it). A request not on the wire yet (`dispatchedAtMs: null`) waits the cap:
|
|
77
|
+
* the engine proxy's rule once it holds a request. A wrun lane asks this rule
|
|
78
|
+
* only after its first send notice and keeps the budget counted from the
|
|
79
|
+
* dispatch until then (`wrunLaneSendDeadline`), so a transport that never
|
|
80
|
+
* reports its send degrades as it always did. The anchor has no default on
|
|
81
|
+
* purpose: every caller says whether its request is on the wire, so time
|
|
82
|
+
* queued before a reported send never eats the budget.
|
|
83
|
+
*/
|
|
84
|
+
export declare function resolveSecondarySourceDeadlineMs(anchor: {
|
|
85
|
+
startedAtMs: number;
|
|
86
|
+
dispatchedAtMs: number | null;
|
|
87
|
+
budgetMs: number;
|
|
88
|
+
capMs?: number;
|
|
89
|
+
}): number;
|
|
53
90
|
/**
|
|
54
91
|
* Gaps between recovery attempts (each is one forced refetch of the overlay
|
|
55
92
|
* with retryAttempt stamped on the degraded names only): the first fires 15s
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* A secondary source's retry and budget numbers (a leaf of utility/chart/kscript-source-degrade.util.ts;
|
|
3
|
-
* P2/inventory.md section 1.1): the constants recovery reads
|
|
3
|
+
* P2/inventory.md section 1.1): the constants recovery reads, the budget the executor reads and the send anchor both
|
|
4
|
+
* source lanes (the kScript engine proxy, the wrun run's lanes) count it from. The degrade registry and
|
|
4
5
|
* its mutators stay in the old module (the chart store and the engine manager share it) behind the chart-host members
|
|
5
6
|
* `chart.markSourcesTerminal`, `chart.markSourceDegraded` and the rest; this leaf holds no state, so it moves into the
|
|
6
7
|
* chart-host package with the phase 2 closure. The old module re-exports it.
|
|
@@ -21,6 +22,14 @@
|
|
|
21
22
|
* per-overlay registry the legend chip is DERIVED from at the diagnostics
|
|
22
23
|
* choke point (chart.ts setIndicatorDiagnostics), so no diagnostics writer
|
|
23
24
|
* can drop the chip and no writer ever sets it directly.
|
|
25
|
+
*
|
|
26
|
+
* On the wrun lane the budget is a paint deadline and stays the chip's
|
|
27
|
+
* authority: counted from the lane's send (resolveSecondarySourceDeadlineMs),
|
|
28
|
+
* a lane still out at it degrades and the run paints without it,
|
|
29
|
+
* while its read (abandoned, never aborted) is joined or adopted by the next
|
|
30
|
+
* run and the source ladder instead of asked again
|
|
31
|
+
* (wrun/run-schedule/wrun-late-reads.util). The read's own bound is the fetch
|
|
32
|
+
* deadline (wrun-deadline.util WRUN_SOURCE_FETCH_DEADLINE_MS).
|
|
24
33
|
*/
|
|
25
34
|
/**
|
|
26
35
|
* Base budget (the floor). Provisional instrumented SLO (2026-09-03): the
|
|
@@ -55,6 +64,35 @@ export function resolveSecondarySourceBudgetMs(window) {
|
|
|
55
64
|
const scaled = KSCRIPT_SECONDARY_SOURCE_BUDGET_MS + (rows / 1000) * KSCRIPT_SECONDARY_SOURCE_BUDGET_PER_1K_ROWS_MS;
|
|
56
65
|
return Math.round(Math.min(KSCRIPT_SECONDARY_SOURCE_BUDGET_MAX_MS, Math.max(KSCRIPT_SECONDARY_SOURCE_BUDGET_MS, scaled)));
|
|
57
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Absolute cap measured from the moment a source request was asked (the
|
|
69
|
+
* engine proxy's request arrival, a wrun lane's dispatch): the send anchor
|
|
70
|
+
* may move the deadline to send + budget, but never past this, so a request
|
|
71
|
+
* that sits queued on the main thread, behind the socket's open or in the
|
|
72
|
+
* worker's queue (or never goes out) still degrades in bounded time.
|
|
73
|
+
*/
|
|
74
|
+
export const KSCRIPT_SECONDARY_SOURCE_DISPATCH_CAP_MS = 60_000;
|
|
75
|
+
/**
|
|
76
|
+
* When a secondary source request degrades (on the caller's clock), the one
|
|
77
|
+
* anchor rule the kScript engine lane and the wrun lanes share: the budget
|
|
78
|
+
* counts from the moment the request went to the wire (`dispatchedAtMs`),
|
|
79
|
+
* never past `capMs` from the moment it was asked (`startedAtMs`), and never
|
|
80
|
+
* before the budget counted from the ask (a cap below the budget is lifted to
|
|
81
|
+
* it). A request not on the wire yet (`dispatchedAtMs: null`) waits the cap:
|
|
82
|
+
* the engine proxy's rule once it holds a request. A wrun lane asks this rule
|
|
83
|
+
* only after its first send notice and keeps the budget counted from the
|
|
84
|
+
* dispatch until then (`wrunLaneSendDeadline`), so a transport that never
|
|
85
|
+
* reports its send degrades as it always did. The anchor has no default on
|
|
86
|
+
* purpose: every caller says whether its request is on the wire, so time
|
|
87
|
+
* queued before a reported send never eats the budget.
|
|
88
|
+
*/
|
|
89
|
+
export function resolveSecondarySourceDeadlineMs(anchor) {
|
|
90
|
+
const { startedAtMs, dispatchedAtMs, budgetMs, capMs = KSCRIPT_SECONDARY_SOURCE_DISPATCH_CAP_MS } = anchor;
|
|
91
|
+
const cappedAtMs = startedAtMs + Math.max(budgetMs, capMs);
|
|
92
|
+
if (dispatchedAtMs === null)
|
|
93
|
+
return cappedAtMs;
|
|
94
|
+
return Math.min(cappedAtMs, Math.max(startedAtMs, dispatchedAtMs) + budgetMs);
|
|
95
|
+
}
|
|
58
96
|
/**
|
|
59
97
|
* Gaps between recovery attempts (each is one forced refetch of the overlay
|
|
60
98
|
* with retryAttempt stamped on the degraded names only): the first fires 15s
|
|
@@ -61,6 +61,7 @@ export declare function liveBucketStartMs(tsMs: number, intervalMs: number, venu
|
|
|
61
61
|
* `liveBucketStartMs`: a regular-session stock chart's hourly columns sit on its 13:30Z (EDT) candles,
|
|
62
62
|
* a CME chart's on its session lattice, and an off-session instant contributes none. The bar holding
|
|
63
63
|
* `fromMs` counts only when it opens inside the range. A probe still inside the last bar (a lattice
|
|
64
|
-
* bar the fall-back Sunday stretches) or off session steps forward a quarter hour at most
|
|
64
|
+
* bar the fall-back Sunday stretches) or off session steps forward a quarter hour at most; on a
|
|
65
|
+
* regular-session stock grid it steps session to session (`resumeProbeMs`) onto the same probes.
|
|
65
66
|
*/
|
|
66
67
|
export declare function liveBucketStartsInRange(fromMs: number, toMs: number, intervalMs: number, venue?: LiveBucketVenue | null): number[];
|
|
@@ -30,6 +30,7 @@ import { checkIsEconomic } from './marketKind.util.js';
|
|
|
30
30
|
import { extractTokensFromTransformations, parsedTransformations } from '../common/transformations.util.js';
|
|
31
31
|
import { isChartRthActive, isFootprintRthFoldTfMs, isRthBucketExactIntervalMs, rthAnchoredBucketStartMs, } from './rth-session.util.js';
|
|
32
32
|
import { isEquityRegularSessionGated, usEquityAnchoredBucketStartMs, usEquitySessionGridBucketStartMs, } from './us-equities-session.util.js';
|
|
33
|
+
import { nyNextRegularOpenAfterMs } from './ny-calendar.util.js';
|
|
33
34
|
const THREE_DAYS_MS = Intervals.map_unit['3d'];
|
|
34
35
|
/**
|
|
35
36
|
* A chart's bar-grid identity as a worker reads it (plain, cloneable fields only): the venue a worker
|
|
@@ -107,7 +108,7 @@ export function cmeSessionLatticeBucketMs(tsMs, intervalMs, venue) {
|
|
|
107
108
|
return null;
|
|
108
109
|
return isCmeSessionLatticeVenue(venue) ? cmeSessionBucketMs(tsMs, intervalMs) : null;
|
|
109
110
|
}
|
|
110
|
-
|
|
111
|
+
function liveBucketGrid(intervalMs, venue) {
|
|
111
112
|
// Calendar and weekly bars: a CME venue's trade-date months and weeks (a
|
|
112
113
|
// month opens at the 17:00 Chicago open before its first trade date), else
|
|
113
114
|
// the plain grid. Regular-session US equities group the session's daily bars
|
|
@@ -115,45 +116,76 @@ export function liveBucketStartMs(tsMs, intervalMs, venue) {
|
|
|
115
116
|
// market; if the gateway stamps them on the first trade date's open instead,
|
|
116
117
|
// this branch needs the session's own month key.
|
|
117
118
|
if (calendarMonthsOfMs(intervalMs) !== null || intervalMs === TimeIntervalConstant.week) {
|
|
118
|
-
return isCmeSessionLatticeVenue(venue)
|
|
119
|
-
? cmeSessionBucketMs(tsMs, intervalMs)
|
|
120
|
-
: plainBucketStartMs(tsMs, intervalMs);
|
|
119
|
+
return isCmeSessionLatticeVenue(venue) ? 'cme-session' : 'plain';
|
|
121
120
|
}
|
|
122
121
|
if (venue && !isRthBucketExactIntervalMs(intervalMs)) {
|
|
123
|
-
if (isChartRthActive(venue.exchange, venue.symbol, venue.sessionType, intervalMs))
|
|
124
|
-
return
|
|
125
|
-
}
|
|
122
|
+
if (isChartRthActive(venue.exchange, venue.symbol, venue.sessionType, intervalMs))
|
|
123
|
+
return 'rth-anchored';
|
|
126
124
|
if (isEquityRegularSessionGated(venue.exchange, venue.sessionType)) {
|
|
127
125
|
if (isFootprintRthFoldTfMs(intervalMs))
|
|
128
|
-
return
|
|
126
|
+
return 'equity-anchored';
|
|
129
127
|
if (intervalMs === THREE_DAYS_MS)
|
|
130
|
-
return
|
|
128
|
+
return 'equity-session-group';
|
|
131
129
|
}
|
|
132
|
-
if (isCmeSessionLatticeIntervalMs(intervalMs) && isCmeSessionLatticeVenue(venue))
|
|
130
|
+
if (isCmeSessionLatticeIntervalMs(intervalMs) && isCmeSessionLatticeVenue(venue))
|
|
131
|
+
return 'cme-session';
|
|
132
|
+
}
|
|
133
|
+
return 'utc-floor';
|
|
134
|
+
}
|
|
135
|
+
function bucketStartOnGrid(grid, tsMs, intervalMs, venue) {
|
|
136
|
+
switch (grid) {
|
|
137
|
+
case 'cme-session':
|
|
133
138
|
return cmeSessionBucketMs(tsMs, intervalMs);
|
|
134
|
-
|
|
139
|
+
case 'plain':
|
|
140
|
+
return plainBucketStartMs(tsMs, intervalMs);
|
|
141
|
+
case 'rth-anchored':
|
|
142
|
+
return rthAnchoredBucketStartMs(venue?.symbol, tsMs, intervalMs);
|
|
143
|
+
case 'equity-anchored':
|
|
144
|
+
return usEquityAnchoredBucketStartMs(tsMs, intervalMs);
|
|
145
|
+
case 'equity-session-group':
|
|
146
|
+
return usEquitySessionGridBucketStartMs(tsMs);
|
|
147
|
+
default:
|
|
148
|
+
return tsMs - (tsMs % intervalMs);
|
|
135
149
|
}
|
|
136
|
-
|
|
150
|
+
}
|
|
151
|
+
export function liveBucketStartMs(tsMs, intervalMs, venue) {
|
|
152
|
+
return bucketStartOnGrid(liveBucketGrid(intervalMs, venue), tsMs, intervalMs, venue);
|
|
137
153
|
}
|
|
138
154
|
/** The probe step through an off-session gap: every open the anchored grids sit on is on the quarter hour. */
|
|
139
155
|
const OFF_SESSION_PROBE_MS = 15 * 60_000;
|
|
156
|
+
/**
|
|
157
|
+
* Where the walk resumes after `probeMs` opened no new bar (`offSession`: no bar holds it). A
|
|
158
|
+
* regular-session stock grid opens bars only inside the cash session, and its 3d bar spans whole
|
|
159
|
+
* sessions, so every probe before the next regular open would come back empty: the walk lands on
|
|
160
|
+
* the first probe of the same quarter-hour run at or after that open, one New York calendar lookup
|
|
161
|
+
* per trade date, and ends when no open comes by `toMs`. Every other grid steps a quarter hour.
|
|
162
|
+
*/
|
|
163
|
+
function resumeProbeMs(grid, probeMs, stepMs, offSession, toMs) {
|
|
164
|
+
if (grid === 'equity-session-group' || (grid === 'equity-anchored' && offSession)) {
|
|
165
|
+
const openMs = nyNextRegularOpenAfterMs(probeMs, toMs);
|
|
166
|
+
return openMs === null ? Number.POSITIVE_INFINITY : probeMs + Math.ceil((openMs - probeMs) / stepMs) * stepMs;
|
|
167
|
+
}
|
|
168
|
+
return probeMs + stepMs;
|
|
169
|
+
}
|
|
140
170
|
/**
|
|
141
171
|
* The starts of the venue's bars that open inside `[fromMs, toMs]`, ascending, each keyed by
|
|
142
172
|
* `liveBucketStartMs`: a regular-session stock chart's hourly columns sit on its 13:30Z (EDT) candles,
|
|
143
173
|
* a CME chart's on its session lattice, and an off-session instant contributes none. The bar holding
|
|
144
174
|
* `fromMs` counts only when it opens inside the range. A probe still inside the last bar (a lattice
|
|
145
|
-
* bar the fall-back Sunday stretches) or off session steps forward a quarter hour at most
|
|
175
|
+
* bar the fall-back Sunday stretches) or off session steps forward a quarter hour at most; on a
|
|
176
|
+
* regular-session stock grid it steps session to session (`resumeProbeMs`) onto the same probes.
|
|
146
177
|
*/
|
|
147
178
|
export function liveBucketStartsInRange(fromMs, toMs, intervalMs, venue) {
|
|
148
179
|
const starts = [];
|
|
149
180
|
if (!(intervalMs > 0) || !Number.isFinite(fromMs) || !Number.isFinite(toMs))
|
|
150
181
|
return starts;
|
|
182
|
+
const grid = liveBucketGrid(intervalMs, venue);
|
|
151
183
|
const stepMs = Math.min(intervalMs, OFF_SESSION_PROBE_MS);
|
|
152
184
|
let last = -Infinity;
|
|
153
185
|
for (let probe = fromMs; probe <= toMs;) {
|
|
154
|
-
const start =
|
|
186
|
+
const start = bucketStartOnGrid(grid, probe, intervalMs, venue);
|
|
155
187
|
if (start === null || start <= last) {
|
|
156
|
-
probe
|
|
188
|
+
probe = resumeProbeMs(grid, probe, stepMs, start === null, toMs);
|
|
157
189
|
continue;
|
|
158
190
|
}
|
|
159
191
|
last = start;
|
|
@@ -45,7 +45,9 @@ type LocalKScriptWarmupDepthSkipReason = 'no-rows' | 'no-viewport' | 'warmup-off
|
|
|
45
45
|
/** A source of the script is still loading, degraded, or never settled: an all-NaN run is not warmup evidence. */
|
|
46
46
|
| 'sources-pending'
|
|
47
47
|
/** The script declares a lookback of 0 and simply printed nothing: an empty output is not a warmup gap. */
|
|
48
|
-
| 'zero-lookback-empty'
|
|
48
|
+
| 'zero-lookback-empty'
|
|
49
|
+
/** The visible first value is where a source's history begins (`sourceReachFromTs`): no page can move it. */
|
|
50
|
+
| 'source-reach';
|
|
49
51
|
export type LocalKScriptWarmupDepthDecision = {
|
|
50
52
|
fetch: true;
|
|
51
53
|
reason: 'warmup-visible' | 'no-values-yet' | 'declared-depth';
|
|
@@ -105,6 +107,15 @@ export interface LocalKScriptWarmupDepthInput {
|
|
|
105
107
|
lookbackBars: number | null;
|
|
106
108
|
/** Every source of the engine settled for the current timeline (the proxy's sourceSettlementLedger). */
|
|
107
109
|
sourcesSettled: boolean;
|
|
110
|
+
/**
|
|
111
|
+
* Where the rows of the result's history sources begin at the clock, null or absent when unknown or when a source
|
|
112
|
+
* reads without a reach (the wrun lane: `wrunRunSourceReachFromMs`, the earliest of its row lanes' reaches, a
|
|
113
|
+
* horizon's served start or the oldest bar a lane's longest-kept tier holds). A visible first value at or after it,
|
|
114
|
+
* with the reach at or after the loaded start, is that history beginning, not a warm-up: a page of candles older
|
|
115
|
+
* than the loaded start holds none of the source's rows, so it cannot move the first value ('source-reach'). Spot
|
|
116
|
+
* Exposures on a 52-day 1h viewport bought a 500-bar page this way for strike rows kept 7 days (INT 2026-10-20).
|
|
117
|
+
*/
|
|
118
|
+
sourceReachFromTs?: number | null;
|
|
108
119
|
}
|
|
109
120
|
/**
|
|
110
121
|
* Bars in the loaded main window: floor((last - first) / interval) + 1. Null
|
|
@@ -124,6 +135,9 @@ export declare function loadedBarsOfWindow(loadedFirstTs: number | null | undefi
|
|
|
124
135
|
* value at the loaded start, is the one non-observed reason ('declared-depth',
|
|
125
136
|
* sized to the shortfall, one page at a time; a shortfall under the absolute
|
|
126
137
|
* gap floor, or the caller's `minGapBars`, is left alone like any other small gap).
|
|
138
|
+
* A visible first value that a source's history explains (`sourceReachFromTs`:
|
|
139
|
+
* that history begins inside the loaded window and the first value at or after
|
|
140
|
+
* it) owes no page: older candles hold none of the source's rows.
|
|
127
141
|
*/
|
|
128
142
|
export declare function chooseLocalKScriptWarmupDepth(input: LocalKScriptWarmupDepthInput): LocalKScriptWarmupDepthDecision;
|
|
129
143
|
export interface WarmupOutputLike {
|
|
@@ -87,6 +87,9 @@ export function loadedBarsOfWindow(loadedFirstTs, loadedLastTs, intervalMs) {
|
|
|
87
87
|
* value at the loaded start, is the one non-observed reason ('declared-depth',
|
|
88
88
|
* sized to the shortfall, one page at a time; a shortfall under the absolute
|
|
89
89
|
* gap floor, or the caller's `minGapBars`, is left alone like any other small gap).
|
|
90
|
+
* A visible first value that a source's history explains (`sourceReachFromTs`:
|
|
91
|
+
* that history begins inside the loaded window and the first value at or after
|
|
92
|
+
* it) owes no page: older candles hold none of the source's rows.
|
|
90
93
|
*/
|
|
91
94
|
export function chooseLocalKScriptWarmupDepth(input) {
|
|
92
95
|
if (!isFiniteTs(input.loadedFirstTs))
|
|
@@ -171,6 +174,12 @@ export function chooseLocalKScriptWarmupDepth(input) {
|
|
|
171
174
|
const minGapBars = Math.max(LOCAL_KSCRIPT_WARMUP_DEPTH_MIN_GAP_BARS, Math.ceil(viewportBars * LOCAL_KSCRIPT_WARMUP_DEPTH_MIN_GAP_VIEWPORT_FRACTION));
|
|
172
175
|
if (missingBars < minGapBars)
|
|
173
176
|
return { fetch: false, reason: 'gap-too-small' };
|
|
177
|
+
// A first value a source's history explains: that history begins inside the loaded window and the first value sits
|
|
178
|
+
// at or after its start, so a page of older candles holds none of the source's rows and cannot move it.
|
|
179
|
+
const reachTs = input.sourceReachFromTs;
|
|
180
|
+
if (isFiniteTs(reachTs) && reachTs >= input.loadedFirstTs && input.firstValueTs >= reachTs) {
|
|
181
|
+
return { fetch: false, reason: 'source-reach' };
|
|
182
|
+
}
|
|
174
183
|
// The need is the observed visible gap, capped at two buckets. A known
|
|
175
184
|
// lookback caps it further at max(lookback, one bucket): a script declaring
|
|
176
185
|
// 5 bars never gets a second bucket even behind a 300-bar visible gap, a
|
|
@@ -16,7 +16,9 @@
|
|
|
16
16
|
* until the data latch corrects it. Known-coarse by design (v1).
|
|
17
17
|
*
|
|
18
18
|
* All math is done in exchange wall-clock parts obtained through Intl with an
|
|
19
|
-
* explicit timeZone
|
|
19
|
+
* explicit timeZone (the zone clock in ny-calendar.util: one Intl reading per
|
|
20
|
+
* UTC day, so the 1 Hz status tick does date arithmetic, not ~20 Intl calls),
|
|
21
|
+
* then converted back to UTC instants with the dual-offset
|
|
20
22
|
* probe (try CST/CDT, keep the one that renders back to the intended wall
|
|
21
23
|
* time). The session boundaries (16:00/17:00) are never inside a DST jump
|
|
22
24
|
* (those happen at 02:00 local), so the probe is always unambiguous.
|
|
@@ -16,12 +16,15 @@
|
|
|
16
16
|
* until the data latch corrects it. Known-coarse by design (v1).
|
|
17
17
|
*
|
|
18
18
|
* All math is done in exchange wall-clock parts obtained through Intl with an
|
|
19
|
-
* explicit timeZone
|
|
19
|
+
* explicit timeZone (the zone clock in ny-calendar.util: one Intl reading per
|
|
20
|
+
* UTC day, so the 1 Hz status tick does date arithmetic, not ~20 Intl calls),
|
|
21
|
+
* then converted back to UTC instants with the dual-offset
|
|
20
22
|
* probe (try CST/CDT, keep the one that renders back to the intended wall
|
|
21
23
|
* time). The session boundaries (16:00/17:00) are never inside a DST jump
|
|
22
24
|
* (those happen at 02:00 local), so the probe is always unambiguous.
|
|
23
25
|
*/
|
|
24
26
|
import { cmeServedAccessForExchange } from './cme-cache-context.util.js';
|
|
27
|
+
import { zoneWallMsAt } from './ny-calendar.util.js';
|
|
25
28
|
import { getRthWindowForSymbol, rthSessionOpenMs } from './rth-session.util.js';
|
|
26
29
|
import { delayedDefaultSecondsFor, gateProviderForExchange } from '../v2/gate-plane.util.js';
|
|
27
30
|
export const GOVERNED_FUTURES_TIME_ZONE = 'America/Chicago';
|
|
@@ -40,7 +43,8 @@ const partsFormatter = new Intl.DateTimeFormat('en-US', {
|
|
|
40
43
|
minute: 'numeric',
|
|
41
44
|
hourCycle: 'h23',
|
|
42
45
|
});
|
|
43
|
-
|
|
46
|
+
/** The Chicago wall clock read from Intl: for the instants the zone clock does not serve (it throws for a non-date). */
|
|
47
|
+
function readWallClockParts(utcMs) {
|
|
44
48
|
const parts = {};
|
|
45
49
|
for (const p of partsFormatter.formatToParts(new Date(utcMs)))
|
|
46
50
|
parts[p.type] = p.value;
|
|
@@ -54,6 +58,24 @@ function wallClockPartsAt(utcMs) {
|
|
|
54
58
|
minute: Number(parts.minute),
|
|
55
59
|
};
|
|
56
60
|
}
|
|
61
|
+
/**
|
|
62
|
+
* The Chicago wall clock at `utcMs`: one Intl reading per UTC day (the zone clock in
|
|
63
|
+
* ny-calendar.util), then date arithmetic. A status reads it about 20 times, every second.
|
|
64
|
+
*/
|
|
65
|
+
function wallClockPartsAt(utcMs) {
|
|
66
|
+
const wallMs = zoneWallMsAt(GOVERNED_FUTURES_TIME_ZONE, utcMs);
|
|
67
|
+
if (Number.isNaN(wallMs))
|
|
68
|
+
return readWallClockParts(utcMs);
|
|
69
|
+
const wall = new Date(wallMs);
|
|
70
|
+
return {
|
|
71
|
+
year: wall.getUTCFullYear(),
|
|
72
|
+
month: wall.getUTCMonth() + 1,
|
|
73
|
+
day: wall.getUTCDate(),
|
|
74
|
+
weekday: wall.getUTCDay(),
|
|
75
|
+
hour: wall.getUTCHours(),
|
|
76
|
+
minute: wall.getUTCMinutes(),
|
|
77
|
+
};
|
|
78
|
+
}
|
|
57
79
|
/**
|
|
58
80
|
* UTC instant for a Chicago wall-clock time on the calendar day of `dayAnchorUtcMs`
|
|
59
81
|
* (anchored at noon UTC so day arithmetic never straddles a DST jump). Probes the
|
|
@@ -4,12 +4,13 @@ import { type OmTargetMetadata } from './om-target.util.js';
|
|
|
4
4
|
/**
|
|
5
5
|
* The frontend's market-kind vocabulary: TitanCharts' `MarketKind` union plus
|
|
6
6
|
* FE-owned kinds for governed CME venues (`'futures'`), HyperLiquid
|
|
7
|
-
* prediction markets (`'hip4'`)
|
|
8
|
-
* the ECONOMICS catalog publishers, which the engine still knows as `'fred'`)
|
|
7
|
+
* prediction markets (`'hip4'`), economic series (`'economic'`: FRED and
|
|
8
|
+
* the ECONOMICS catalog publishers, which the engine still knows as `'fred'`)
|
|
9
|
+
* and the crypto-wide indices (`'cryptoIndex'`: CRYPTOCAP's BTC.D, TOTAL, ...).
|
|
9
10
|
* TitanCharts does not know these kinds; anything handed into the engine
|
|
10
11
|
* narrows through `toTitanMarketKind`.
|
|
11
12
|
*/
|
|
12
|
-
export type VenueMarketKind = Exclude<MarketKind, 'fred'> | 'economic' | 'futures' | 'hip4' | 'options';
|
|
13
|
+
export type VenueMarketKind = Exclude<MarketKind, 'fred'> | 'economic' | 'futures' | 'hip4' | 'options' | 'cryptoIndex';
|
|
13
14
|
/** Which wire path serves an economic series (see `economicSource`). */
|
|
14
15
|
export type EconomicSource = 'fred' | 'observation';
|
|
15
16
|
/**
|
|
@@ -123,14 +124,18 @@ export declare function checkIsForexCommodityOrFutures(exchange: string | undefi
|
|
|
123
124
|
* Narrow the FE kind to TitanCharts' `MarketKind` union at the engine
|
|
124
125
|
* boundary. `'futures'` maps to `'commodity'` for session handling; `'hip4'`
|
|
125
126
|
* maps to `'polymarket'` for the prediction renderer; `'economic'` maps to
|
|
126
|
-
* the engine's `'fred'` (single-value series treatment)
|
|
127
|
-
*
|
|
127
|
+
* the engine's `'fred'` (single-value series treatment); `'cryptoIndex'`
|
|
128
|
+
* maps to `'crypto'`: the indices print 24/7 (about every 250 ms after a
|
|
129
|
+
* price move, every 5 s per coin) onto uniform bars from 1m up, the crypto
|
|
130
|
+
* treatment's own shape, gap policy included. FE-internal code always sees
|
|
131
|
+
* the honest venue kind.
|
|
128
132
|
*/
|
|
129
133
|
export declare function toTitanMarketKind(kind: VenueMarketKind): MarketKind;
|
|
130
134
|
/**
|
|
131
135
|
* True when TitanCharts must omit the dedicated 'volume' legend overlay:
|
|
132
|
-
* economic series
|
|
133
|
-
* CME futures DO ship contracts volume on TRADE_AGG
|
|
136
|
+
* economic series, forex/commodity venues and the crypto indices ship no
|
|
137
|
+
* per-bar volume. Governed CME futures DO ship contracts volume on TRADE_AGG
|
|
138
|
+
* bars, so they keep it.
|
|
134
139
|
*/
|
|
135
140
|
export declare function venueOmitsVolumeOverlay(exchange: string | undefined | null): boolean;
|
|
136
141
|
export declare function checkIsDex(exchange: string | undefined | null): boolean;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { MARKET_CAPABILITIES, ONCHAIN_POOL_CAPABILITIES, } from '../../constants/marketCapabilities.constants.js';
|
|
2
2
|
import { isBlkExchange } from '../blk-market.util.js';
|
|
3
3
|
import { ECONOMIC_EXCHANGES, FRED_EXCHANGE } from '../../constants/economic.constants.js';
|
|
4
|
+
import { CRYPTO_INDEX_EXCHANGES } from './crypto-index.leaf.js';
|
|
4
5
|
import { isCmeGoverned, normalizeExchangeCode } from './cme-realtime.util.js';
|
|
5
6
|
import { isGovernedPlaneExchange } from '../v2/gate-plane.util.js';
|
|
6
7
|
import { isOmTargetPane } from './om-target.util.js';
|
|
@@ -76,6 +77,9 @@ const EXCHANGE_TO_KIND = {
|
|
|
76
77
|
// Economic series: FRED plus the ECONOMICS catalog venue and the observation
|
|
77
78
|
// publishers (economic.constants.ts owns the list).
|
|
78
79
|
...Object.fromEntries(ECONOMIC_EXCHANGES.map((code) => [code, 'economic'])),
|
|
80
|
+
// Crypto-wide indices (CRYPTOCAP): value prints 24/7 with no trades,
|
|
81
|
+
// volume or book behind them (crypto-index.leaf owns the list).
|
|
82
|
+
...Object.fromEntries(CRYPTO_INDEX_EXCHANGES.map((code) => [code, 'cryptoIndex'])),
|
|
79
83
|
// Polymarket
|
|
80
84
|
POLYMARKET: 'polymarket',
|
|
81
85
|
// Hip3 (Hyperliquid synthetic derivatives)
|
|
@@ -278,8 +282,11 @@ export function checkIsForexCommodityOrFutures(exchange) {
|
|
|
278
282
|
* Narrow the FE kind to TitanCharts' `MarketKind` union at the engine
|
|
279
283
|
* boundary. `'futures'` maps to `'commodity'` for session handling; `'hip4'`
|
|
280
284
|
* maps to `'polymarket'` for the prediction renderer; `'economic'` maps to
|
|
281
|
-
* the engine's `'fred'` (single-value series treatment)
|
|
282
|
-
*
|
|
285
|
+
* the engine's `'fred'` (single-value series treatment); `'cryptoIndex'`
|
|
286
|
+
* maps to `'crypto'`: the indices print 24/7 (about every 250 ms after a
|
|
287
|
+
* price move, every 5 s per coin) onto uniform bars from 1m up, the crypto
|
|
288
|
+
* treatment's own shape, gap policy included. FE-internal code always sees
|
|
289
|
+
* the honest venue kind.
|
|
283
290
|
*/
|
|
284
291
|
export function toTitanMarketKind(kind) {
|
|
285
292
|
if (kind === 'futures' || kind === 'options')
|
|
@@ -288,15 +295,18 @@ export function toTitanMarketKind(kind) {
|
|
|
288
295
|
return 'polymarket';
|
|
289
296
|
if (kind === 'economic')
|
|
290
297
|
return 'fred';
|
|
298
|
+
if (kind === 'cryptoIndex')
|
|
299
|
+
return 'crypto';
|
|
291
300
|
return kind;
|
|
292
301
|
}
|
|
293
302
|
/**
|
|
294
303
|
* True when TitanCharts must omit the dedicated 'volume' legend overlay:
|
|
295
|
-
* economic series
|
|
296
|
-
* CME futures DO ship contracts volume on TRADE_AGG
|
|
304
|
+
* economic series, forex/commodity venues and the crypto indices ship no
|
|
305
|
+
* per-bar volume. Governed CME futures DO ship contracts volume on TRADE_AGG
|
|
306
|
+
* bars, so they keep it.
|
|
297
307
|
*/
|
|
298
308
|
export function venueOmitsVolumeOverlay(exchange) {
|
|
299
|
-
return checkIsEconomic(exchange) || checkIsForexOrCommodity(exchange);
|
|
309
|
+
return checkIsEconomic(exchange) || checkIsForexOrCommodity(exchange) || getMarketKind(exchange) === 'cryptoIndex';
|
|
300
310
|
}
|
|
301
311
|
export function checkIsDex(exchange) {
|
|
302
312
|
return getMarketKind(exchange) === 'dex';
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The shared point for per-row timezone math: a zone clock for any IANA zone (one Intl reading per
|
|
3
|
+
* UTC day), and on it the New York calendar behind every US equities session question (the pre /
|
|
4
|
+
* regular / after phase, the 09:30 anchored bucket, the next regular open), resolved once per date.
|
|
5
|
+
*
|
|
6
|
+
* Why this exists (CPU profiles 2026-10-20, UW-PARITY reports/INDICATOR-LOAD-BUDGET.md): on 45m
|
|
7
|
+
* to 12h stock bars every landed row re-derived the New York wall clock through dayjs
|
|
8
|
+
* (`checkUSMarketHours`, plus a format and a parse for the anchored bucket), about 24 us per
|
|
9
|
+
* conversion. One 1h Flow Marks add spent 8.9 s in dayjs `.tz`, and the host-bar walk
|
|
10
|
+
* (`liveBucketStartsInRange`) probed every quarter hour through nights and weekends at three
|
|
11
|
+
* conversions a probe. The same mistake sat in the Chicago schedule (about 20 Intl readings per
|
|
12
|
+
* status, every second), the regional session windows, the option symbol dates and the bar facts.
|
|
13
|
+
* An offset changes twice a year, so each zone reads it once per UTC day into a bounded memo and
|
|
14
|
+
* every row does integer math against it.
|
|
15
|
+
*
|
|
16
|
+
* The zone clock (`zoneOffsetMsAt`, `zoneWallMsAt`, `zoneWallToUtcMs`) reads Intl at a UTC day's
|
|
17
|
+
* first and last second; a day whose two readings differ is bisected to the second the offset
|
|
18
|
+
* changes on. Exact for any zone that changes its offset at most once per UTC day (every zone the
|
|
19
|
+
* app reads); a second change inside one day is detected and read per instant. It serves the
|
|
20
|
+
* instants from the year 100 to the Date range edge: a caller keeps its own reading outside them.
|
|
21
|
+
*
|
|
22
|
+
* The New York calendar, per date (DST-exact on the 23h and 25h days): its span [00:00, next 00:00)
|
|
23
|
+
* and its session edges in UTC ms, on the weekday cycle `checkUSMarketHours` has always read:
|
|
24
|
+
* pre 04:00 -> 09:30
|
|
25
|
+
* regular 09:30 -> 16:00
|
|
26
|
+
* after 16:00 -> 20:00
|
|
27
|
+
* closed everything else, and all of Saturday and Sunday
|
|
28
|
+
* Holidays and half days are NOT modelled (the v1 scope of us-equities-session.util): an
|
|
29
|
+
* exchange holiday reads as a normal weekday.
|
|
30
|
+
*
|
|
31
|
+
* Host-independent (dayjs re-parsed the zone's wall string in the host zone, which misreads an
|
|
32
|
+
* hour on the host's own DST days). Pure and worker-safe: Intl only, no dayjs.
|
|
33
|
+
*/
|
|
34
|
+
export declare const NY_TIME_ZONE = "America/New_York";
|
|
35
|
+
/** Session edges as wall-clock minutes after New York midnight. */
|
|
36
|
+
export declare const NY_PRE_MARKET_OPEN_MINUTES: number;
|
|
37
|
+
export declare const NY_REGULAR_OPEN_MINUTES: number;
|
|
38
|
+
export declare const NY_REGULAR_CLOSE_MINUTES: number;
|
|
39
|
+
export declare const NY_POST_MARKET_CLOSE_MINUTES: number;
|
|
40
|
+
export type NyMarketPhase = 'pre' | 'regular' | 'after' | 'closed';
|
|
41
|
+
/** One New York calendar date, resolved once: its span and its session edges in UTC ms. */
|
|
42
|
+
export interface NyCalendarDay {
|
|
43
|
+
/** The date as whole days since 1970-01-01 (its 00:00Z over 86,400,000). */
|
|
44
|
+
readonly dayNumber: number;
|
|
45
|
+
/** 0 Sunday to 6 Saturday. */
|
|
46
|
+
readonly weekday: number;
|
|
47
|
+
/** Monday to Friday: a date with sessions (holidays are not modelled). */
|
|
48
|
+
readonly isTradeDate: boolean;
|
|
49
|
+
/** New York midnight that starts the date, and the next one: the date is [dayStartMs, dayEndMs). */
|
|
50
|
+
readonly dayStartMs: number;
|
|
51
|
+
readonly dayEndMs: number;
|
|
52
|
+
/** Wall clock minus UTC at the regular open, in ms (-4h in EDT, -5h in EST). */
|
|
53
|
+
readonly utcOffsetMs: number;
|
|
54
|
+
readonly preMarketOpenMs: number;
|
|
55
|
+
readonly regularOpenMs: number;
|
|
56
|
+
/** The regular close, which is also the after-hours open. */
|
|
57
|
+
readonly regularCloseMs: number;
|
|
58
|
+
readonly postMarketCloseMs: number;
|
|
59
|
+
}
|
|
60
|
+
/** Test oracle: New York dates resolved (`computed`), instants looked up (`lookups`), zone UTC days read (`zoneDays`). */
|
|
61
|
+
export declare const __nyCalendarStats: {
|
|
62
|
+
computed: number;
|
|
63
|
+
lookups: number;
|
|
64
|
+
zoneDays: number;
|
|
65
|
+
};
|
|
66
|
+
/**
|
|
67
|
+
* `zone`'s offset at `tMs` (wall clock minus UTC, ms; a fractional ms truncates, as a Date's does).
|
|
68
|
+
* NaN outside the instants the clock serves (from the year 100 to the Date range edge): the caller
|
|
69
|
+
* keeps its own reading there. Throws Intl's RangeError for a zone it does not know.
|
|
70
|
+
*/
|
|
71
|
+
export declare function zoneOffsetMsAt(zone: string, tMs: number): number;
|
|
72
|
+
/** The wall clock `tMs` reads in `zone`, as a UTC-shaped epoch at ms precision; NaN outside the span served. */
|
|
73
|
+
export declare function zoneWallMsAt(zone: string, tMs: number): number;
|
|
74
|
+
/**
|
|
75
|
+
* The instant `zone`'s wall clock reads `wallMs` (a UTC-shaped epoch), by fixed-point iteration from
|
|
76
|
+
* `seedOffsetMs` (the offset at `wallMs` read as an instant, when absent): an instant whose own offset
|
|
77
|
+
* is the one it was solved with is the answer, so a wall time on either side of a change settles on
|
|
78
|
+
* its own offset in one or two reads. A wall time a change skips or repeats settles on one of its
|
|
79
|
+
* readings: callers keep their edges off the change. NaN outside the span served.
|
|
80
|
+
*/
|
|
81
|
+
export declare function zoneWallToUtcMs(zone: string, wallMs: number, seedOffsetMs?: number): number;
|
|
82
|
+
/** Test hook: empty memos (the New York dates and every zone's UTC days) and zeroed counters. */
|
|
83
|
+
export declare function __resetNyCalendarMemo(): void;
|
|
84
|
+
/**
|
|
85
|
+
* The New York calendar date `dayNumber` (days since 1970-01-01), resolved once; null outside the
|
|
86
|
+
* span the zone clock serves, and where the runtime has no New York zone data.
|
|
87
|
+
*/
|
|
88
|
+
export declare function nyCalendarDay(dayNumber: number): NyCalendarDay | null;
|
|
89
|
+
/**
|
|
90
|
+
* The New York calendar date holding the instant `tsMs`; a fractional ms truncates, as a Date's
|
|
91
|
+
* does. Null for a non-finite instant or one outside the span the zone clock serves.
|
|
92
|
+
*/
|
|
93
|
+
export declare function nyCalendarDayAt(tsMs: number): NyCalendarDay | null;
|
|
94
|
+
/** The session phase at `tsMs`: 'closed' on Saturday and Sunday, and for an instant that is not a date. */
|
|
95
|
+
export declare function nyMarketPhaseAt(tsMs: number): NyMarketPhase;
|
|
96
|
+
/** The regular open of the cash session holding `tsMs`; null outside [09:30, 16:00) on a trade date. */
|
|
97
|
+
export declare function nyRegularSessionOpenMs(tsMs: number): number | null;
|
|
98
|
+
/**
|
|
99
|
+
* The first regular open strictly after `tsMs`: the same date's while before it, else the next
|
|
100
|
+
* Monday-to-Friday date's (weekend dates are skipped by arithmetic, never resolved). Null when
|
|
101
|
+
* there is none at or before `notAfterMs`, or outside the span served: a walk bounded by
|
|
102
|
+
* `notAfterMs` never resolves a date it will not reach (a date's open is after its own 00:00Z).
|
|
103
|
+
*/
|
|
104
|
+
export declare function nyNextRegularOpenAfterMs(tsMs: number, notAfterMs?: number): number | null;
|