@orangecharts/wrun-chart-host 0.6.0 → 0.7.1
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 +14 -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/index.d.ts +2 -0
- package/dist/settings-templates/index.js +19 -5
- package/dist/settings-templates/indicator-fields.d.ts +2 -0
- package/dist/settings-templates/indicator-fields.js +10 -0
- package/dist/settings-templates/tool-rules.d.ts +12 -2
- package/dist/settings-templates/tool-rules.js +9 -2
- package/dist/settings-templates/tool-tables.generated.js +9 -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
|
@@ -20,6 +20,23 @@ export type WrunTierChoice = 'finest' | 'coarsest';
|
|
|
20
20
|
/** Whether a tier fits a host bar: its width divides the bar's span (a day for a calendar bar) and the bar's
|
|
21
21
|
* open sits on the tier's UTC grid, so the bar is a whole number of the tier's buckets. */
|
|
22
22
|
export declare function wrunTierFitsBar(tier: Pick<WrunBackendTier, 'ms'>, barOpenMs: number, barMs: number): boolean;
|
|
23
|
+
/** The instants a host bar's rows cover, `[fromMs, toMs)`. */
|
|
24
|
+
export interface WrunHostBarSpan {
|
|
25
|
+
fromMs: number;
|
|
26
|
+
toMs: number;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* The session a host bar covers when it is not its stamp to its end, under a session grid (a flow's plan, see the
|
|
30
|
+
* module header): a bar the CME session lattice stamps at a day or longer (cme-session-bucket.util: the trade date's
|
|
31
|
+
* 00:00Z label at 1d, its group's first trade date at 3d, its week's Monday at 1w, its month's 1st at a calendar
|
|
32
|
+
* length) runs from the 17:00 Chicago open before it (`cmeSessionBarOpenMs`, read inside the bar) to the open that
|
|
33
|
+
* starts the next bar (`cmeSessionBarEndMs`). Undefined for any other bar: no grid, a grid off the lattice (a UTC or
|
|
34
|
+
* a stock chart's), an intraday lattice width (its stamp is its open), a stamp the lattice books no row to.
|
|
35
|
+
*/
|
|
36
|
+
export declare function wrunCmeSessionBarSpan(barOpenMs: number, intervalMs: number, sessionGrid: LiveBucketVenue | null | undefined): WrunHostBarSpan | undefined;
|
|
37
|
+
/** A host bar's span: its session under a session grid (`wrunCmeSessionBarSpan`), else its stamp to its end
|
|
38
|
+
* (`wrunHostGridFetchTo`: its calendar close on a calendar chart). */
|
|
39
|
+
export declare function wrunHostBarSpanOf(barOpenMs: number, intervalMs: number, sessionGrid?: LiveBucketVenue | null): WrunHostBarSpan;
|
|
23
40
|
/** The finest tier that fits a host bar (the one its live bar is built from), or undefined when none fits
|
|
24
41
|
* (a bar finer than every tier, or one whose open sits on no tier's grid). */
|
|
25
42
|
export declare function wrunFinestTier(tiers: readonly WrunBackendTier[], barOpenMs: number, barMs: number): WrunBackendTier | undefined;
|
|
@@ -30,15 +47,20 @@ export interface WrunBarTier {
|
|
|
30
47
|
barOpenMs: number;
|
|
31
48
|
tier?: WrunBackendTier;
|
|
32
49
|
partial: boolean;
|
|
50
|
+
/** The session the bar is fit, retained, served and asked over when it is not its stamp to its end (a CME session
|
|
51
|
+
* bar of a day or longer under a session grid: `wrunCmeSessionBarSpan`). */
|
|
52
|
+
span?: WrunHostBarSpan;
|
|
33
53
|
}
|
|
34
54
|
/** The tier rule over a host grid's bar opens (ascending): each bar's fitting tier that still retains it (the
|
|
35
|
-
* finest, or with `choice: 'coarsest'` the coarsest that already serves the bar), else partial.
|
|
55
|
+
* finest, or with `choice: 'coarsest'` the coarsest that already serves the bar), else partial. Under a session grid
|
|
56
|
+
* (a flow's plan) a CME session bar of a day or longer is judged over its session (`wrunCmeSessionBarSpan`). */
|
|
36
57
|
export declare function wrunBarTiers(args: {
|
|
37
58
|
tiers: readonly WrunBackendTier[];
|
|
38
59
|
barOpens: readonly number[];
|
|
39
60
|
barMs: number;
|
|
40
61
|
nowMs: number;
|
|
41
62
|
choice?: WrunTierChoice;
|
|
63
|
+
sessionGrid?: LiveBucketVenue | null;
|
|
42
64
|
}): WrunBarTier[];
|
|
43
65
|
/** One ask of a tier-planned fetch: a tier and the span of host bars it builds, `[fromMs, toMs)` (the last
|
|
44
66
|
* bar's end, its calendar close on a calendar chart, so every bucket inside it is asked). */
|
|
@@ -48,7 +70,8 @@ export interface WrunTierSegment {
|
|
|
48
70
|
toMs: number;
|
|
49
71
|
}
|
|
50
72
|
/** The asks a tier plan needs: each run of consecutive bars that read the same tier, as one segment (a
|
|
51
|
-
* partial bar asks nothing, it is marked instead)
|
|
73
|
+
* partial bar asks nothing, it is marked instead), from its first bar's open (its session's, when it has one) to its
|
|
74
|
+
* last bar's end. */
|
|
52
75
|
export declare function wrunTierSegments(barTiers: readonly WrunBarTier[], barMs: number): WrunTierSegment[];
|
|
53
76
|
/** Where a host-grid lane asks its tier rows through, for a chart window whose last bar opens at
|
|
54
77
|
* `lastBarOpenMs`: that bar's END (`barEndMs`: its calendar close on a calendar chart, whose length is an
|
|
@@ -66,7 +89,8 @@ export interface WrunHostGridAsk {
|
|
|
66
89
|
* The asks a host-grid lane makes over a chart window: with no tiers, ONE ask from the first bar's open to the
|
|
67
90
|
* last bar's end; with tiers, one ask per run of bars on one tier (`wrunBarTiers` under the lane's `choice`, then
|
|
68
91
|
* `wrunTierSegments`), and the bars no fitting tier retains, which ask nothing and are partial. `barOpens` are the
|
|
69
|
-
* host bars of the window, ascending (`liveBucketStartsInRange` over the chart's bar grid).
|
|
92
|
+
* host bars of the window, ascending (`liveBucketStartsInRange` over the chart's bar grid). `sessionGrid` (a flow's
|
|
93
|
+
* plan: the chart's bar grid) asks a CME session bar of a day or longer over its session (`wrunHostBarSpanOf`).
|
|
70
94
|
*/
|
|
71
95
|
export declare function wrunHostGridAsks(args: {
|
|
72
96
|
tiers?: readonly WrunBackendTier[];
|
|
@@ -74,6 +98,7 @@ export declare function wrunHostGridAsks(args: {
|
|
|
74
98
|
intervalMs: number;
|
|
75
99
|
nowMs: number;
|
|
76
100
|
choice?: WrunTierChoice;
|
|
101
|
+
sessionGrid?: LiveBucketVenue | null;
|
|
77
102
|
}): {
|
|
78
103
|
asks: WrunHostGridAsk[];
|
|
79
104
|
partialBars: number[];
|
|
@@ -20,15 +20,24 @@
|
|
|
20
20
|
* closed inside the lag, read the next finer tier that serves them (the finest when none does). Which bars are
|
|
21
21
|
* partial does not change.
|
|
22
22
|
*
|
|
23
|
+
* The session grid (`sessionGrid`, a FLOW's plan: every bucket inside a bar sums into it). A bar the CME session
|
|
24
|
+
* lattice stamps at a day or longer (1d, 3d, 1w, a calendar length on a CME Group chart) carries its trade date's
|
|
25
|
+
* label, 00:00Z, while its session opens at the 17:00 Chicago open before it (22:00Z or 23:00Z the evening before):
|
|
26
|
+
* an evening print belongs to the next trade date's bar. Under the session grid such a bar is fit, retained, served
|
|
27
|
+
* and asked over its session (`wrunCmeSessionBarSpan`), so no ask reads a UTC day bucket that straddles the 17:00
|
|
28
|
+
* flip (an hour bucket never does: the flip falls on the hour) and every ask starts at the session's open. Every other
|
|
29
|
+
* bar (an intraday lattice bar, a UTC or an anchored grid's) keeps its stamp to its end, and so does a snapshot's plan.
|
|
30
|
+
*
|
|
23
31
|
* The landing. A tier's rows are stamped at their bucket opens; each lands on the host bar holding it
|
|
24
32
|
* (`liveBucketStartMs` over the chart's bar-grid venue, `liveBucketVenueOf(metadata)`: the 09:30-anchored
|
|
25
|
-
* bucket of a regular-session stock chart, the UTC floor elsewhere; an off-session row
|
|
26
|
-
* bar's rows fold by the class's landing: a FLOW sums (every tuple of a celled flow is kept,
|
|
27
|
-
* scalar column sums its finite values), a SNAPSHOT takes the newest SEALED row of the bar (a row
|
|
28
|
-
* bucket has closed by the clock: a forming bucket is never read as the bar's state).
|
|
33
|
+
* bucket of a regular-session stock chart, a CME chart's session lattice, the UTC floor elsewhere; an off-session row
|
|
34
|
+
* lands nowhere), and the bar's rows fold by the class's landing: a FLOW sums (every tuple of a celled flow is kept,
|
|
35
|
+
* in time order; a scalar column sums its finite values), a SNAPSHOT takes the newest SEALED row of the bar (a row
|
|
36
|
+
* whose tier bucket has closed by the clock: a forming bucket is never read as the bar's state).
|
|
29
37
|
*/
|
|
30
38
|
import { barEndMs, calendarMonthsOfMs } from '../chart/calendar-interval.util.js';
|
|
31
|
-
import {
|
|
39
|
+
import { cmeSessionBarEndMs, cmeSessionBarOpenMs, isCmeSessionLatticeIntervalMs, } from '../chart/cme-session-bucket.util.js';
|
|
40
|
+
import { isCmeSessionLatticeVenue, liveBucketStartMs } from '../chart/live-bucket.util.js';
|
|
32
41
|
import { wrunPartialMarkerTuple, wrunTuplesMarkedPartial } from './wrun-present-bits.util.js';
|
|
33
42
|
const DAY_MS = 86_400_000;
|
|
34
43
|
/** The span a tier must divide: the bar's own, or a day for a calendar bar (its span is no fixed number). */
|
|
@@ -52,15 +61,51 @@ function tierRetainsBar(tier, barOpenMs, nowMs) {
|
|
|
52
61
|
function fittingTiers(tiers, barOpenMs, barMs) {
|
|
53
62
|
return tiers.filter((tier) => wrunTierFitsBar(tier, barOpenMs, barMs)).sort((a, b) => a.ms - b.ms);
|
|
54
63
|
}
|
|
64
|
+
/**
|
|
65
|
+
* The session a host bar covers when it is not its stamp to its end, under a session grid (a flow's plan, see the
|
|
66
|
+
* module header): a bar the CME session lattice stamps at a day or longer (cme-session-bucket.util: the trade date's
|
|
67
|
+
* 00:00Z label at 1d, its group's first trade date at 3d, its week's Monday at 1w, its month's 1st at a calendar
|
|
68
|
+
* length) runs from the 17:00 Chicago open before it (`cmeSessionBarOpenMs`, read inside the bar) to the open that
|
|
69
|
+
* starts the next bar (`cmeSessionBarEndMs`). Undefined for any other bar: no grid, a grid off the lattice (a UTC or
|
|
70
|
+
* a stock chart's), an intraday lattice width (its stamp is its open), a stamp the lattice books no row to.
|
|
71
|
+
*/
|
|
72
|
+
export function wrunCmeSessionBarSpan(barOpenMs, intervalMs, sessionGrid) {
|
|
73
|
+
if (!Number.isFinite(barOpenMs) || !(intervalMs >= DAY_MS) || !isCmeSessionLatticeIntervalMs(intervalMs)) {
|
|
74
|
+
return undefined;
|
|
75
|
+
}
|
|
76
|
+
if (!isCmeSessionLatticeVenue(sessionGrid))
|
|
77
|
+
return undefined;
|
|
78
|
+
const toMs = cmeSessionBarEndMs(barOpenMs, intervalMs);
|
|
79
|
+
if (toMs === null)
|
|
80
|
+
return undefined;
|
|
81
|
+
const fromMs = cmeSessionBarOpenMs(toMs - 1, intervalMs);
|
|
82
|
+
return fromMs !== null && fromMs < toMs ? { fromMs, toMs } : undefined;
|
|
83
|
+
}
|
|
84
|
+
/** A host bar's span: its session under a session grid (`wrunCmeSessionBarSpan`), else its stamp to its end
|
|
85
|
+
* (`wrunHostGridFetchTo`: its calendar close on a calendar chart). */
|
|
86
|
+
export function wrunHostBarSpanOf(barOpenMs, intervalMs, sessionGrid) {
|
|
87
|
+
return (wrunCmeSessionBarSpan(barOpenMs, intervalMs, sessionGrid) ?? {
|
|
88
|
+
fromMs: barOpenMs,
|
|
89
|
+
toMs: wrunHostGridFetchTo(barOpenMs, intervalMs),
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
/** The tiers that fit a session (its length a whole number of the tier's buckets, its open on the tier's UTC grid),
|
|
93
|
+
* finest first: on a CME session the hour and finer, never the UTC day. */
|
|
94
|
+
function sessionTiers(tiers, span) {
|
|
95
|
+
const length = span.toMs - span.fromMs;
|
|
96
|
+
return tiers
|
|
97
|
+
.filter((tier) => tier.ms > 0 && length % tier.ms === 0 && span.fromMs % tier.ms === 0)
|
|
98
|
+
.sort((a, b) => a.ms - b.ms);
|
|
99
|
+
}
|
|
55
100
|
/** The finest tier that fits a host bar (the one its live bar is built from), or undefined when none fits
|
|
56
101
|
* (a bar finer than every tier, or one whose open sits on no tier's grid). */
|
|
57
102
|
export function wrunFinestTier(tiers, barOpenMs, barMs) {
|
|
58
103
|
return fittingTiers(tiers, barOpenMs, barMs)[0];
|
|
59
104
|
}
|
|
60
105
|
/** The coarsest of a bar's retaining tiers (finest first) that already serves the whole bar: a tier with a
|
|
61
|
-
* `servedLagMs` serves it once the bar ended that long ago. None serving: the finest (the finest choice's
|
|
62
|
-
|
|
63
|
-
|
|
106
|
+
* `servedLagMs` serves it once the bar ended (`barEnd`) that long ago. None serving: the finest (the finest choice's
|
|
107
|
+
* tier). */
|
|
108
|
+
function coarsestServingTier(retaining, barEnd, nowMs) {
|
|
64
109
|
for (let at = retaining.length - 1; at > 0; at -= 1) {
|
|
65
110
|
const lag = retaining[at].servedLagMs;
|
|
66
111
|
if (lag === undefined || barEnd + lag <= nowMs)
|
|
@@ -69,20 +114,28 @@ function coarsestServingTier(retaining, barOpenMs, barMs, nowMs) {
|
|
|
69
114
|
return retaining[0];
|
|
70
115
|
}
|
|
71
116
|
/** The tier rule over a host grid's bar opens (ascending): each bar's fitting tier that still retains it (the
|
|
72
|
-
* finest, or with `choice: 'coarsest'` the coarsest that already serves the bar), else partial.
|
|
117
|
+
* finest, or with `choice: 'coarsest'` the coarsest that already serves the bar), else partial. Under a session grid
|
|
118
|
+
* (a flow's plan) a CME session bar of a day or longer is judged over its session (`wrunCmeSessionBarSpan`). */
|
|
73
119
|
export function wrunBarTiers(args) {
|
|
74
120
|
return args.barOpens.map((barOpenMs) => {
|
|
75
|
-
const
|
|
76
|
-
const
|
|
121
|
+
const span = wrunCmeSessionBarSpan(barOpenMs, args.barMs, args.sessionGrid);
|
|
122
|
+
const fitting = span === undefined ? fittingTiers(args.tiers, barOpenMs, args.barMs) : sessionTiers(args.tiers, span);
|
|
123
|
+
const fromMs = span?.fromMs ?? barOpenMs;
|
|
124
|
+
const retaining = fitting.filter((tier) => tierRetainsBar(tier, fromMs, args.nowMs));
|
|
125
|
+
const spanned = span === undefined ? {} : { span };
|
|
77
126
|
if (retaining.length > 0) {
|
|
78
|
-
const
|
|
79
|
-
|
|
127
|
+
const barEnd = span?.toMs ?? barEndMs(barOpenMs, args.barMs);
|
|
128
|
+
const tier = args.choice === 'coarsest' ? coarsestServingTier(retaining, barEnd, args.nowMs) : retaining[0];
|
|
129
|
+
return { barOpenMs, tier, partial: false, ...spanned };
|
|
80
130
|
}
|
|
81
|
-
return fitting.length > 0
|
|
131
|
+
return fitting.length > 0
|
|
132
|
+
? { barOpenMs, tier: fitting[0], partial: true, ...spanned }
|
|
133
|
+
: { barOpenMs, partial: true, ...spanned };
|
|
82
134
|
});
|
|
83
135
|
}
|
|
84
136
|
/** The asks a tier plan needs: each run of consecutive bars that read the same tier, as one segment (a
|
|
85
|
-
* partial bar asks nothing, it is marked instead)
|
|
137
|
+
* partial bar asks nothing, it is marked instead), from its first bar's open (its session's, when it has one) to its
|
|
138
|
+
* last bar's end. */
|
|
86
139
|
export function wrunTierSegments(barTiers, barMs) {
|
|
87
140
|
const segments = [];
|
|
88
141
|
let open;
|
|
@@ -91,12 +144,12 @@ export function wrunTierSegments(barTiers, barMs) {
|
|
|
91
144
|
open = undefined;
|
|
92
145
|
continue;
|
|
93
146
|
}
|
|
94
|
-
const endMs = barEndMs(bar.barOpenMs, barMs);
|
|
147
|
+
const endMs = bar.span?.toMs ?? barEndMs(bar.barOpenMs, barMs);
|
|
95
148
|
if (open !== undefined && open.tier.key === bar.tier.key) {
|
|
96
149
|
open.toMs = endMs;
|
|
97
150
|
continue;
|
|
98
151
|
}
|
|
99
|
-
open = { tier: bar.tier, fromMs: bar.barOpenMs, toMs: endMs };
|
|
152
|
+
open = { tier: bar.tier, fromMs: bar.span?.fromMs ?? bar.barOpenMs, toMs: endMs };
|
|
100
153
|
segments.push(open);
|
|
101
154
|
}
|
|
102
155
|
return segments;
|
|
@@ -112,7 +165,8 @@ export function wrunHostGridFetchTo(lastBarOpenMs, intervalMs) {
|
|
|
112
165
|
* The asks a host-grid lane makes over a chart window: with no tiers, ONE ask from the first bar's open to the
|
|
113
166
|
* last bar's end; with tiers, one ask per run of bars on one tier (`wrunBarTiers` under the lane's `choice`, then
|
|
114
167
|
* `wrunTierSegments`), and the bars no fitting tier retains, which ask nothing and are partial. `barOpens` are the
|
|
115
|
-
* host bars of the window, ascending (`liveBucketStartsInRange` over the chart's bar grid).
|
|
168
|
+
* host bars of the window, ascending (`liveBucketStartsInRange` over the chart's bar grid). `sessionGrid` (a flow's
|
|
169
|
+
* plan: the chart's bar grid) asks a CME session bar of a day or longer over its session (`wrunHostBarSpanOf`).
|
|
116
170
|
*/
|
|
117
171
|
export function wrunHostGridAsks(args) {
|
|
118
172
|
const { barOpens, intervalMs } = args;
|
|
@@ -120,7 +174,12 @@ export function wrunHostGridAsks(args) {
|
|
|
120
174
|
return { asks: [], partialBars: [] };
|
|
121
175
|
if (args.tiers === undefined || args.tiers.length === 0) {
|
|
122
176
|
return {
|
|
123
|
-
asks: [
|
|
177
|
+
asks: [
|
|
178
|
+
{
|
|
179
|
+
fromMs: wrunHostBarSpanOf(barOpens[0], intervalMs, args.sessionGrid).fromMs,
|
|
180
|
+
toMs: wrunHostBarSpanOf(barOpens[barOpens.length - 1], intervalMs, args.sessionGrid).toMs,
|
|
181
|
+
},
|
|
182
|
+
],
|
|
124
183
|
partialBars: [],
|
|
125
184
|
};
|
|
126
185
|
}
|
|
@@ -130,6 +189,7 @@ export function wrunHostGridAsks(args) {
|
|
|
130
189
|
barMs: intervalMs,
|
|
131
190
|
nowMs: args.nowMs,
|
|
132
191
|
choice: args.choice,
|
|
192
|
+
sessionGrid: args.sessionGrid,
|
|
133
193
|
});
|
|
134
194
|
return {
|
|
135
195
|
asks: wrunTierSegments(bars, intervalMs),
|
|
@@ -17,12 +17,23 @@ export type WrunTransientRerunAdmission = 'no-driver' | 'in-flight' | 'queued' |
|
|
|
17
17
|
* took the place of the last one waiting. */
|
|
18
18
|
export type WrunTransientGraceEnd = 'painted' | 'teardown' | 'superseded';
|
|
19
19
|
type WrunTransientRerunAdmit = (target: WrunTransientRerunTarget, trigger: WrunTransientRerunTrigger) => WrunTransientRerunAdmission;
|
|
20
|
+
/** How a caller holds a transient refusal (`holdWrunTransientRefusal`). */
|
|
21
|
+
export interface WrunTransientHoldOptions {
|
|
22
|
+
/**
|
|
23
|
+
* The host reruns this overlay itself, outside the executor (the mobile app's hosted lane: its protected run heal
|
|
24
|
+
* re-asks the overlay on its own ladder), so the grace holds it without a registered rerun driver. The admission
|
|
25
|
+
* still answers `no-driver` to the package's own triggers, so nothing here reruns it twice. Off by default: an
|
|
26
|
+
* overlay no driver runs shows its record at once.
|
|
27
|
+
*/
|
|
28
|
+
hostReruns?: boolean;
|
|
29
|
+
}
|
|
20
30
|
/**
|
|
21
31
|
* Hold a transient refusal of this overlay inside its grace: true when it waits (a grace started, or the one running
|
|
22
|
-
* took it in without restarting), false when it must show now (
|
|
23
|
-
* since). `onExpire` shows the records still waiting once
|
|
32
|
+
* took it in without restarting), false when it must show now (no rerun driver runs the overlay and its host does not
|
|
33
|
+
* rerun it itself, or its grace ran out and it has not painted since). `onExpire` shows the records still waiting once
|
|
34
|
+
* the deadline ends the grace; the grace keeps the first one.
|
|
24
35
|
*/
|
|
25
|
-
export declare function holdWrunTransientRefusal(target: WrunTransientRerunTarget, onExpire: () => void): boolean;
|
|
36
|
+
export declare function holdWrunTransientRefusal(target: WrunTransientRerunTarget, onExpire: () => void, options?: WrunTransientHoldOptions): boolean;
|
|
26
37
|
/**
|
|
27
38
|
* End the overlay's grace before its deadline: nothing waiting shows, and its load signal comes down. A paint or a
|
|
28
39
|
* teardown also ends the overlay's failure streak (its next transient refusal gets a grace of its own); a record that
|
|
@@ -7,9 +7,13 @@
|
|
|
7
7
|
* one shows it as before.
|
|
8
8
|
*
|
|
9
9
|
* - The grace (`holdWrunTransientRefusal`), asked by the refusal surface for a record whose cause is transient: one
|
|
10
|
-
* per overlay (`chartIndex:indicatorId`)
|
|
11
|
-
*
|
|
12
|
-
*
|
|
10
|
+
* per overlay (`chartIndex:indicatorId`), and only for an overlay a rerun driver runs (the drivers registry,
|
|
11
|
+
* `hasWrunOverlayDriver`, the one the rerun's admission asks): a revive or an add whose load failed registered none,
|
|
12
|
+
* so no event could rerun it, and its record shows at once with its Retry. A host that reruns an overlay itself,
|
|
13
|
+
* outside the executor (the mobile app's hosted lane, whose protected run heal re-asks it), says so on the hold
|
|
14
|
+
* (`hostReruns`), and the grace holds it without a driver. The first such record starts it and a
|
|
15
|
+
* later one never restarts it. While it runs, its load signal shows the overlay loading (`raiseWrunGraceLoad`) and
|
|
16
|
+
* its deadline counts visible time only (startVisibleTimeout), so a hidden tab never runs it out.
|
|
13
17
|
* - Its end, one way each (data-loading rule 3): a paint (the refusal surface's retraction), the overlay's teardown,
|
|
14
18
|
* a record that shows at once in place of the last one waiting (`endWrunTransientGrace`), or the deadline, which
|
|
15
19
|
* hands the waiting records back to the refusal surface to show as they would have shown at once. Every end lowers
|
|
@@ -20,13 +24,15 @@
|
|
|
20
24
|
* against the overlay's own work, and each trigger admits at most once per grace (`claimWrunTransientRerun`). An
|
|
21
25
|
* event the dedupe met is owed one coalesced rerun once that work settles without a paint (`oweWrunTransientRerun`).
|
|
22
26
|
*
|
|
23
|
-
* Import graph:
|
|
27
|
+
* Import graph: on the boot path beside the drivers registry it reads (the refusal surface rides the registry there,
|
|
28
|
+
* and the registry imports the surface: a cycle no module crosses at load, only at call time). The chart instances
|
|
24
29
|
* and the chart store load with the first grace through the host's loaders, the recovery ladders bind themselves (they
|
|
25
30
|
* load beside their ports, `chart.loadRunPorts`, when a grace asks before they evaluated): nothing heavy at import.
|
|
26
31
|
*/
|
|
27
32
|
import { startVisibleTimeout } from '../common/visible-timeout.util.js';
|
|
28
33
|
import { wrunHostVisibleClock } from './wrun-host-visible-clock.util.js';
|
|
29
34
|
import { claimWrunGraceLoading, isWrunLoadingOwned, releaseWrunLoading } from './wrun-loading-owner.util.js';
|
|
35
|
+
import { hasWrunOverlayDriver } from './wrun-overlay-drivers.util.js';
|
|
30
36
|
import { wrunChartHostEnv } from '../../host-env.js';
|
|
31
37
|
/** How long a transient refusal waits, in visible time, before it shows. */
|
|
32
38
|
export const WRUN_TRANSIENT_GRACE_MS = 20_000;
|
|
@@ -141,12 +147,25 @@ function raiseGraceSignal(key, grace) {
|
|
|
141
147
|
}
|
|
142
148
|
/**
|
|
143
149
|
* Hold a transient refusal of this overlay inside its grace: true when it waits (a grace started, or the one running
|
|
144
|
-
* took it in without restarting), false when it must show now (
|
|
145
|
-
* since). `onExpire` shows the records still waiting once
|
|
150
|
+
* took it in without restarting), false when it must show now (no rerun driver runs the overlay and its host does not
|
|
151
|
+
* rerun it itself, or its grace ran out and it has not painted since). `onExpire` shows the records still waiting once
|
|
152
|
+
* the deadline ends the grace; the grace keeps the first one.
|
|
146
153
|
*/
|
|
147
|
-
export function holdWrunTransientRefusal(target, onExpire) {
|
|
154
|
+
export function holdWrunTransientRefusal(target, onExpire, options = {}) {
|
|
148
155
|
const key = keyOf(target);
|
|
149
156
|
const running = graces.get(key);
|
|
157
|
+
const hostReruns = options.hostReruns === true || running?.hostReruns === true;
|
|
158
|
+
// No driver, no rerun: the admission answers `no-driver` to every trigger (a revive or an add whose load failed
|
|
159
|
+
// registered none), so a grace would only show loading over nothing and the same record 20 s late. A host that
|
|
160
|
+
// reruns the overlay itself (on this hold, or the one that started the running grace) is the rerun.
|
|
161
|
+
if (!hostReruns && !hasWrunOverlayDriver(target.indicatorId)) {
|
|
162
|
+
ring('wrun-transient-grace', {
|
|
163
|
+
chartIndex: target.chartIndex,
|
|
164
|
+
indicatorId: target.indicatorId,
|
|
165
|
+
verdict: 'no-driver',
|
|
166
|
+
});
|
|
167
|
+
return false;
|
|
168
|
+
}
|
|
150
169
|
if (running) {
|
|
151
170
|
raiseGraceSignal(key, running);
|
|
152
171
|
ring('wrun-transient-grace', { ...running.target, verdict: 'again' });
|
|
@@ -163,6 +182,7 @@ export function holdWrunTransientRefusal(target, onExpire) {
|
|
|
163
182
|
admitted: new Set(),
|
|
164
183
|
owed: undefined,
|
|
165
184
|
expire: onExpire,
|
|
185
|
+
hostReruns,
|
|
166
186
|
};
|
|
167
187
|
graces.set(key, grace);
|
|
168
188
|
// The deadline is armed before the load signal: the store's loading watchdog arms its 20 s "Still loading" chip on
|
|
@@ -171,7 +191,12 @@ export function holdWrunTransientRefusal(target, onExpire) {
|
|
|
171
191
|
// The host's suspension pauses the grace too (a suspended app never runs it out).
|
|
172
192
|
wrunHostVisibleClock());
|
|
173
193
|
raiseGraceSignal(key, grace);
|
|
174
|
-
ring('wrun-transient-grace', {
|
|
194
|
+
ring('wrun-transient-grace', {
|
|
195
|
+
...grace.target,
|
|
196
|
+
verdict: 'held',
|
|
197
|
+
graceMs: WRUN_TRANSIENT_GRACE_MS,
|
|
198
|
+
...(hostReruns ? { rerunner: 'host' } : {}),
|
|
199
|
+
});
|
|
175
200
|
return true;
|
|
176
201
|
}
|
|
177
202
|
function expireWrunTransientGrace(key, grace) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@orangecharts/wrun-chart-host",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"description": "The wrun chart-host layer shared by the kiyotaka web app and the mobile app: the wrun result reader and painter model, cut from the web app (its reference implementation).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
@@ -28,14 +28,14 @@
|
|
|
28
28
|
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
29
29
|
},
|
|
30
30
|
"peerDependencies": {
|
|
31
|
-
"@orangecharts/indicator-kit": "0.
|
|
32
|
-
"@orangecharts/orange-v2-pb-common": "12.
|
|
31
|
+
"@orangecharts/indicator-kit": "0.88.0",
|
|
32
|
+
"@orangecharts/orange-v2-pb-common": "12.72.0",
|
|
33
33
|
"dayjs": "1.11.23",
|
|
34
34
|
"lodash-es": "4.18.1"
|
|
35
35
|
},
|
|
36
36
|
"devDependencies": {
|
|
37
|
-
"@orangecharts/indicator-kit": "0.
|
|
38
|
-
"@orangecharts/orange-v2-pb-common": "12.
|
|
37
|
+
"@orangecharts/indicator-kit": "0.88.0",
|
|
38
|
+
"@orangecharts/orange-v2-pb-common": "12.72.0",
|
|
39
39
|
"@types/lodash-es": "4.17.12",
|
|
40
40
|
"dayjs": "1.11.23",
|
|
41
41
|
"lodash-es": "4.18.1",
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The identity of an OPRA-only row lane on its chart (`option_prints`, `option_contract_flow`: the underlying the
|
|
3
|
-
* OPRA plane keys its series by, `coin`). A thin re-export kept for those lanes' imports: the wrapper lives beside the
|
|
4
|
-
* one chain resolver (sources/opra-option-lanes.util `resolveWrunOpraLaneUnderlying`, over the same chart chain
|
|
5
|
-
* resolution `option_surface` and `option_strikes` read), its refusals by name unchanged: the directory that did not
|
|
6
|
-
* answer (`service-no-answer` / `opra-directory`, Retry) and a chart OPRA lists no options for (`no-options` /
|
|
7
|
-
* `chain`).
|
|
8
|
-
*/
|
|
9
|
-
import type { WrunPollLaneContext } from './sources/wrun-poll-lane.types.js';
|
|
10
|
-
export { resolveWrunOpraLaneUnderlying } from './sources/opra-option-lanes.util.js';
|
|
11
|
-
/** The chart a lane resolves its underlying on (a row lane's plan context carries these). */
|
|
12
|
-
export type WrunOpraUnderlyingContext = Pick<WrunPollLaneContext, 'inputName' | 'sourceClass' | 'coin' | 'exchange' | 'symbol'>;
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { resolveWrunOpraLaneUnderlying } from './sources/opra-option-lanes.util.js';
|