@orangecharts/wrun-chart-host 0.7.1 → 0.9.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 +27 -4
- package/dist/constants/feature-flags.constants.d.ts +5 -0
- package/dist/constants/feature-flags.constants.js +32 -0
- package/dist/constants/marketCapabilities.constants.d.ts +14 -9
- package/dist/constants/marketCapabilities.constants.js +36 -13
- package/dist/constants/opra-compliance.constants.d.ts +14 -0
- package/dist/constants/opra-compliance.constants.js +14 -0
- package/dist/constants/option-venues.constants.d.ts +29 -6
- package/dist/constants/option-venues.constants.js +19 -2
- package/dist/constants/venue-presets.constants.d.ts +17 -3
- package/dist/constants/venue-presets.constants.js +17 -3
- package/dist/host-env.d.ts +34 -4
- package/dist/host-env.js +21 -0
- package/dist/host-ports.types.d.ts +51 -3
- package/dist/index.d.ts +17 -0
- package/dist/index.js +17 -0
- package/dist/indicators/controls/tpo-session.util.d.ts +40 -11
- package/dist/indicators/controls/tpo-session.util.js +138 -14
- package/dist/interfaces/opra-realtime.interface.d.ts +13 -11
- package/dist/interfaces/opra-realtime.interface.js +10 -10
- package/dist/interfaces/option-instrument.interface.d.ts +6 -0
- package/dist/interfaces/wrun-runtime.interface.d.ts +34 -13
- package/dist/kscript-data/controls/live-trades-merge.util.d.ts +57 -10
- package/dist/kscript-data/controls/live-trades-merge.util.js +85 -16
- package/dist/market-data/billing.interface.d.ts +138 -17
- package/dist/market-data/billing.interface.js +25 -8
- package/dist/market-data/venues/index.d.ts +3 -3
- package/dist/market-data/venues/opra.contract.copy.json +5 -3
- package/dist/market-data/venues/opra.d.ts +3 -3
- package/dist/market-data/venues/opra.js +5 -4
- package/dist/replay/replayLadder.js +3 -1
- package/dist/settings-templates/footprint-rows.d.ts +25 -0
- package/dist/settings-templates/footprint-rows.js +127 -0
- package/dist/settings-templates/form-rows.d.ts +56 -0
- package/dist/settings-templates/form-rows.js +19 -0
- package/dist/settings-templates/frvp-fields.js +14 -0
- package/dist/settings-templates/index.d.ts +10 -1
- package/dist/settings-templates/index.js +11 -2
- package/dist/settings-templates/indicator-fields.js +78 -0
- package/dist/settings-templates/tool-rules.d.ts +35 -9
- package/dist/settings-templates/tool-rules.js +42 -8
- package/dist/settings-templates/tool-tables.generated.js +13 -2
- package/dist/utility/chart/candle-volume-unit.leaf.d.ts +16 -0
- package/dist/utility/chart/candle-volume-unit.leaf.js +61 -0
- package/dist/utility/chart/crypto-index.leaf.d.ts +2 -2
- package/dist/utility/chart/crypto-index.leaf.js +2 -2
- package/dist/utility/chart/footprint-columns.util.d.ts +74 -0
- package/dist/utility/chart/footprint-columns.util.js +106 -0
- package/dist/utility/chart/footprint-display-mode.util.d.ts +40 -0
- package/dist/utility/chart/footprint-display-mode.util.js +62 -0
- package/dist/utility/chart/footprint-sierra-look.util.d.ts +2 -0
- package/dist/utility/chart/footprint-sierra-look.util.js +37 -0
- package/dist/utility/chart/index-mode-admission.util.js +9 -1
- package/dist/utility/chart/index-mode.util.d.ts +5 -2
- package/dist/utility/chart/index-mode.util.js +23 -13
- package/dist/utility/chart/kscript-venue-policy.util.d.ts +28 -21
- package/dist/utility/chart/kscript-venue-policy.util.js +34 -26
- package/dist/utility/chart/marketKind.util.d.ts +12 -10
- package/dist/utility/chart/marketKind.util.js +17 -7
- package/dist/utility/chart/om-panel-push-style.util.d.ts +7 -7
- package/dist/utility/chart/om-panel-push-style.util.js +17 -15
- package/dist/utility/chart/om-panel.util.d.ts +11 -0
- package/dist/utility/chart/om-panel.util.js +65 -6
- package/dist/utility/chart/profile-block-size.util.d.ts +16 -0
- package/dist/utility/chart/profile-block-size.util.js +7 -0
- package/dist/utility/chart/quote-perp.leaf.d.ts +17 -0
- package/dist/utility/chart/quote-perp.leaf.js +20 -0
- package/dist/utility/chart/window-geometry.leaf.d.ts +23 -1
- package/dist/utility/chart/window-geometry.leaf.js +78 -6
- package/dist/utility/chart/window-owner.leaf.d.ts +13 -0
- package/dist/utility/chart/window-owner.leaf.js +5 -0
- package/dist/utility/chart/wrun-run-result.util.d.ts +5 -0
- package/dist/utility/chart/wrun-run-result.util.js +4 -1
- package/dist/utility/common/transformations.util.d.ts +7 -0
- package/dist/utility/common/transformations.util.js +11 -0
- package/dist/utility/options/cme-options-root.util.d.ts +25 -0
- package/dist/utility/options/cme-options-root.util.js +40 -0
- package/dist/utility/options/option-book.util.d.ts +27 -0
- package/dist/utility/options/option-book.util.js +76 -0
- package/dist/utility/options/option-trade-date.util.d.ts +50 -0
- package/dist/utility/options/option-trade-date.util.js +120 -0
- package/dist/utility/options/option-venue.util.d.ts +3 -3
- package/dist/utility/options/option-venue.util.js +3 -3
- package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +1 -1
- package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +2 -2
- package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +2 -2
- package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +5 -1
- package/dist/utility/wrun/sources/host-grid-landing.d.ts +4 -2
- package/dist/utility/wrun/sources/host-grid-landing.js +8 -0
- package/dist/utility/wrun/sources/lanes/options_flow.d.ts +40 -4
- package/dist/utility/wrun/sources/lanes/options_flow.js +115 -18
- package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +12 -9
- package/dist/utility/wrun/sources/opra-option-lanes.util.js +10 -7
- package/dist/utility/wrun/sources/row-lane-registry.js +10 -5
- package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
- package/dist/utility/wrun/sources/row-lanes/option_contract_flow.d.ts +3 -2
- package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +30 -5
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +9 -3
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +13 -5
- package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +25 -1
- package/dist/utility/wrun/sources/row-lanes/option_prints.js +161 -30
- package/dist/utility/wrun/sources/row-lanes/option_strike_flow.d.ts +4 -0
- package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +65 -0
- package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +55 -1
- package/dist/utility/wrun/sources/row-lanes/option_strikes.js +83 -2
- package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +17 -1
- package/dist/utility/wrun/sources/row-lanes/option_surface.js +33 -2
- package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +7 -1
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +51 -5
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +136 -3
- package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +42 -0
- package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +146 -0
- package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +25 -5
- package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +111 -20
- package/dist/utility/wrun/sources/wrun-row-lanes.util.js +291 -48
- package/dist/utility/wrun/wrun-batched-marks.util.d.ts +16 -3
- package/dist/utility/wrun/wrun-batched-marks.util.js +30 -19
- package/dist/utility/wrun/wrun-batched-readout.util.d.ts +37 -9
- package/dist/utility/wrun/wrun-batched-readout.util.js +61 -15
- package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -0
- package/dist/utility/wrun/wrun-cell-capacity.leaf.d.ts +66 -0
- package/dist/utility/wrun/wrun-cell-capacity.leaf.js +86 -0
- package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +147 -9
- package/dist/utility/wrun/wrun-chart-market-facts.util.js +345 -11
- package/dist/utility/wrun/wrun-cloud-record.leaf.d.ts +27 -0
- package/dist/utility/wrun/wrun-cloud-record.leaf.js +71 -0
- package/dist/utility/wrun/wrun-cloud-record.util.d.ts +4 -21
- package/dist/utility/wrun/wrun-cloud-record.util.js +5 -65
- package/dist/utility/wrun/wrun-color-facts.util.d.ts +19 -9
- package/dist/utility/wrun/wrun-color-facts.util.js +24 -14
- package/dist/utility/wrun/wrun-color-settings.util.d.ts +22 -9
- package/dist/utility/wrun/wrun-color-settings.util.js +57 -23
- package/dist/utility/wrun/wrun-dollar-unit-port.leaf.d.ts +17 -0
- package/dist/utility/wrun/wrun-dollar-unit-port.leaf.js +9 -0
- package/dist/utility/wrun/wrun-download-meter.util.d.ts +92 -0
- package/dist/utility/wrun/wrun-download-meter.util.js +122 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +10 -3
- package/dist/utility/wrun/wrun-draft-overlay.util.js +63 -6
- package/dist/utility/wrun/wrun-frames.js +5 -5
- package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +2 -2
- package/dist/utility/wrun/wrun-hosted-wire-caps.js +11 -0
- package/dist/utility/wrun/wrun-hud-looks.util.d.ts +33 -17
- package/dist/utility/wrun/wrun-hud-looks.util.js +30 -16
- package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +29 -3
- package/dist/utility/wrun/wrun-lane-refusal.leaf.js +33 -3
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +8 -6
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +8 -6
- package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -2
- package/dist/utility/wrun/wrun-live-intake.util.d.ts +6 -2
- package/dist/utility/wrun/wrun-live-intake.util.js +136 -21
- package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -1
- package/dist/utility/wrun/wrun-live-tick.util.js +130 -44
- package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.d.ts +53 -0
- package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.js +162 -0
- package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +224 -0
- package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +342 -0
- package/dist/utility/wrun/wrun-market-size-defaults.util.d.ts +88 -0
- package/dist/utility/wrun/wrun-market-size-defaults.util.js +471 -0
- package/dist/utility/wrun/wrun-opra-flow.leaf.d.ts +43 -8
- package/dist/utility/wrun/wrun-opra-flow.leaf.js +37 -6
- package/dist/utility/wrun/wrun-option-contract-flow.util.d.ts +51 -10
- package/dist/utility/wrun/wrun-option-contract-flow.util.js +85 -33
- package/dist/utility/wrun/wrun-option-prints.util.d.ts +172 -3
- package/dist/utility/wrun/wrun-option-prints.util.js +394 -17
- package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +99 -0
- package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +218 -0
- package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +365 -0
- package/dist/utility/wrun/wrun-option-strike-flow.util.js +797 -0
- package/dist/utility/wrun/wrun-option-views.util.d.ts +231 -7
- package/dist/utility/wrun/wrun-option-views.util.js +643 -23
- package/dist/utility/wrun/wrun-options-chain.util.d.ts +6 -4
- package/dist/utility/wrun/wrun-options-chain.util.js +8 -5
- package/dist/utility/wrun/wrun-options-stop.util.d.ts +2 -1
- package/dist/utility/wrun/wrun-options-stop.util.js +3 -2
- package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +3 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +31 -14
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +22 -0
- package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +9 -1
- package/dist/utility/wrun/wrun-overlay-recovery.util.js +32 -3
- package/dist/utility/wrun/wrun-overlay-result.util.d.ts +7 -1
- package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
- package/dist/utility/wrun/wrun-overlay-run.util.d.ts +34 -6
- package/dist/utility/wrun/wrun-overlay-run.util.js +527 -180
- package/dist/utility/wrun/wrun-pack-widths.leaf.d.ts +15 -0
- package/dist/utility/wrun/wrun-pack-widths.leaf.js +22 -0
- package/dist/utility/wrun/wrun-pack.util.d.ts +13 -8
- package/dist/utility/wrun/wrun-pack.util.js +38 -21
- package/dist/utility/wrun/wrun-panel-mount.util.d.ts +4 -0
- package/dist/utility/wrun/wrun-panel-mount.util.js +62 -22
- package/dist/utility/wrun/wrun-panel-style.util.d.ts +41 -14
- package/dist/utility/wrun/wrun-panel-style.util.js +86 -26
- package/dist/utility/wrun/wrun-param-map.util.d.ts +7 -6
- package/dist/utility/wrun/wrun-param-map.util.js +8 -5
- package/dist/utility/wrun/wrun-param-values.util.d.ts +10 -2
- package/dist/utility/wrun/wrun-param-values.util.js +2 -0
- package/dist/utility/wrun/wrun-pin-spelling.util.js +19 -10
- package/dist/utility/wrun/wrun-prefix-lanes.util.js +2 -2
- package/dist/utility/wrun/wrun-refusal.util.js +17 -2
- package/dist/utility/wrun/wrun-script-inputs.util.d.ts +20 -0
- package/dist/utility/wrun/wrun-script-inputs.util.js +43 -0
- package/dist/utility/wrun/wrun-source-rows.util.d.ts +4 -0
- package/dist/utility/wrun/wrun-source-rows.util.js +92 -40
- package/dist/utility/wrun/wrun-tape-source.util.d.ts +133 -48
- package/dist/utility/wrun/wrun-tape-source.util.js +205 -62
- package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +7 -5
- package/dist/utility/wrun/wrun-volume-profile-lane.util.js +8 -6
- package/dist/workers/utils/volume-profile.worker.util.d.ts +4 -1
- package/dist/workers/utils/volume-profile.worker.util.js +5 -2
- package/dist/workers/wrun/wrun-abi-host.js +3 -2
- package/package.json +11 -11
|
@@ -4,27 +4,37 @@
|
|
|
4
4
|
* written once over the descriptor, so no consumer names a lane.
|
|
5
5
|
*
|
|
6
6
|
* - `planWrunRowLaneInputs`: the STATIC plan, from the sheet alone: each input of a row-lane class, which must be
|
|
7
|
-
* celled with a `max_cells` (refused by name otherwise)
|
|
7
|
+
* celled with a `max_cells` (refused by name otherwise), and the tuples its module holds a bar's block in (the
|
|
8
|
+
* sheet's `capacity ?? max_cells`, a capacity no build writes refused by name). The run pass runs it before any
|
|
9
|
+
* fetch and the row builder before any row.
|
|
8
10
|
* - `planWrunRowLanes`: the run's plan against the chart, before any fetch, of every input the market demands (an
|
|
9
11
|
* undemanded one is planned nowhere): the OPRA wall, the chart's admission, the lane's identity (once per lane) and
|
|
10
12
|
* each input's facets, grouped into instances (equal facets share one fetch and one buffer; an
|
|
11
13
|
* `acquisitions: 'one'` lane refuses two that differ), a chain lane's instance meeting its own plane's wall,
|
|
12
|
-
* refusals by name.
|
|
14
|
+
* refusals by name. Each input's facets read the run beside the chart (`WrunRowLanePlanFacts`): its own `max_cells`,
|
|
15
|
+
* the most `max_cells` among the package's inputs of its class, the sheet's settings and the run's values.
|
|
13
16
|
* - a chain lane's plane per instance (`wrunRowLaneChainPlane`) and the fields its asks name for it
|
|
14
17
|
* (`wrunRowLaneChainAsk`): the run's and the reconcile's one rule.
|
|
15
18
|
* - `wrunRowLaneRequired`: the empty-answer rule (a `degrades` lane must answer rows unless every reader declares
|
|
16
19
|
* `missing: "empty"`).
|
|
17
20
|
* - `fetchWrunRowLaneRows`: a lane's rows over a chart window: its asks under the tier rule, landed on the host
|
|
18
|
-
* bars, the partial bars marked (a `latest` lane asked once, its rows as they come)
|
|
21
|
+
* bars, the partial bars marked (a `latest` lane asked once, its rows as they come), a row-budget lane's newest bars
|
|
22
|
+
* first, cut on a trade date's first bar where the chart reads one (wrun-row-lane-first-paint.util; a full run's
|
|
23
|
+
* first paint draws them before the older bars land, `onFirstSlice`), and so an instance's whose facets ask a
|
|
24
|
+
* per-bar word (OPTLOAD G5); every
|
|
25
|
+
* packed block a worker transferred split into plain tuples of the instance's width as it lands
|
|
26
|
+
* (`wrunRowLanePlainRow`).
|
|
27
|
+
* - an option knob naming a setting read as its value before a lane's facets judge it (`resolveWrunOptionSettingKnobs`).
|
|
19
28
|
* - `wrunRowLaneCellRows`: the row builder's read of one input: the lane's host-bar rows as cell blocks on the
|
|
20
29
|
* chart's grid (exact width, finite values or NaN outside a lane's `finiteColumns`, the lane's per-input
|
|
21
|
-
* projection
|
|
22
|
-
*
|
|
30
|
+
* projection, after its window-level pass over every held bar where it declares one, with a partial bar kept partial
|
|
31
|
+
* unless the class carries no `present` mask; a view block, the block of an input whose words name a fold, as it
|
|
32
|
+
* is, `wrunRowLaneAtWidth`; a `latest` lane on the live row).
|
|
23
33
|
* - `wrunRowLaneReachFromMs` / `wrunRunSourceReachFromMs`: how far back a lane's source holds rows (its horizon, its
|
|
24
34
|
* longest-kept tier), and where a run's history sources begin, which the warm-up decider reads so a first value a
|
|
25
35
|
* source's history explains never buys a page of older candles.
|
|
26
36
|
*/
|
|
27
|
-
import type { WrunIndicatorMetadata, WrunInputSource } from '../../../interfaces/wrun-runtime.interface.js';
|
|
37
|
+
import type { WrunIndicatorMetadata, WrunInputSource, WrunMetadataParam } from '../../../interfaces/wrun-runtime.interface.js';
|
|
28
38
|
import type { LiveBucketVenue } from '../../chart/live-bucket.util.js';
|
|
29
39
|
import type { OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
|
|
30
40
|
import type { OpraOptionPlaneStop } from '../../../host-ports.types.js';
|
|
@@ -39,11 +49,19 @@ export interface WrunRowLaneInput {
|
|
|
39
49
|
source: WrunInputSource;
|
|
40
50
|
lane: WrunRowLaneDescriptor;
|
|
41
51
|
maxCells: number;
|
|
52
|
+
/** The tuples a bar's block may hold in the run's module (wrun-cell-capacity.leaf `wrunSheetCellBlockTuples`: the
|
|
53
|
+
* sheet's `capacity ?? max_cells`, a print union's whole only where the capacity holds it), the bound the packer
|
|
54
|
+
* refuses past: the row builder hands it to the input's projection. */
|
|
55
|
+
capacity: number;
|
|
42
56
|
}
|
|
43
57
|
/**
|
|
44
|
-
* The static plan: every input whose class a row lane serves, in declaration order, with its lane
|
|
45
|
-
* name: a scalar input (a row lane serves cell blocks)
|
|
46
|
-
* are packed under)
|
|
58
|
+
* The static plan: every input whose class a row lane serves, in declaration order, with its lane and its module's
|
|
59
|
+
* bound (`capacity`, `wrunSheetCellBlockTuples`). Refused by name: a scalar input (a row lane serves cell blocks), a
|
|
60
|
+
* celled one with no `max_cells` (the bound its blocks are packed under) and a capacity no build writes
|
|
61
|
+
* (`wrun_cell_capacity_invalid`). Empty when the sheet reads no row-lane class. The lane's width follows the input's
|
|
62
|
+
* own words (wrun-option-views.util `wrunOptionInputTupleWidth`, the SDK's one rule: a page view fold's view block,
|
|
63
|
+
* the strike kit fold's 14-value rows), so the row builder reads and hands on the block each input's words make; a
|
|
64
|
+
* block of another width than its class's is read as it is (`wrunRowLaneAtWidth`).
|
|
47
65
|
*/
|
|
48
66
|
export declare function planWrunRowLaneInputs(metadata: WrunIndicatorMetadata): WrunRowLaneInput[];
|
|
49
67
|
/** The id of the instance `extras` names: `row:<laneKey>` when the ask carries no extras, else the extras'
|
|
@@ -95,7 +113,9 @@ export interface WrunRowLanePlan {
|
|
|
95
113
|
* reason (`opraPlaneStop`: the `opra` flag dark, an index chart) says that reason instead (`options-stopped`, the
|
|
96
114
|
* note and the refusal alike);
|
|
97
115
|
* 3. the lane's identity, once per lane (the first admitted input's context names a refusal), then the input's
|
|
98
|
-
* facets (awaited, in declaration order)
|
|
116
|
+
* facets (awaited, in declaration order), each knob naming a setting first read as the setting's current value
|
|
117
|
+
* (`resolveWrunOptionSettingKnobs` over `run.paramValues`), the context carrying the plan's facts beside the chart
|
|
118
|
+
* (`WrunRowLanePlanFacts`); the instance is the identity and the facets together. A lane with
|
|
99
119
|
* `acquisitions: 'one'` refuses a second input whose acquisition differs (one fetch, one live fold per package). A
|
|
100
120
|
* chart with no option chain (an identity or facets refusal seeded `no-options` / `chain`, `wrunLaneNoChainRefusal`:
|
|
101
121
|
* a LINK perp, a forex pair) does not serve the feed either: the same one rule, its note naming the feed with the
|
|
@@ -103,7 +123,29 @@ export interface WrunRowLanePlan {
|
|
|
103
123
|
* (`assertWrunLaneChainPlaneReadable`, the one rule a chain poll lane meets too): OPRA's, or the CME display wall
|
|
104
124
|
* (OpenMarket's own packages only); a plain chain (a crypto venue) none.
|
|
105
125
|
*/
|
|
106
|
-
export declare function planWrunRowLanes(metadata: WrunIndicatorMetadata, chart: WrunRowLaneChart, run?:
|
|
126
|
+
export declare function planWrunRowLanes(metadata: WrunIndicatorMetadata, chart: WrunRowLaneChart, run?: WrunRowLaneRunFacts): Promise<WrunRowLanePlan>;
|
|
127
|
+
/** The run facts the row-lane planner reads: the OPRA facts and the run's setting values by name (wrun-param-values.util
|
|
128
|
+
* `wrunParamValuesFromSettings` over the overlay's settings; absent: a knob naming a setting is refused by name). */
|
|
129
|
+
export interface WrunRowLaneRunFacts extends OpraReadFacts {
|
|
130
|
+
paramValues?: Readonly<Record<string, number>>;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* What the planner hands an input's facets beside the chart (on its context):
|
|
134
|
+
* - `maxCells`: the input's own `max_cells` from the static plan, the bound its blocks are packed under (the strike kit
|
|
135
|
+
* fold asks the gateway to refuse a bar past it, OPTLOAD G5 `strikeMaxCells`);
|
|
136
|
+
* - `laneMaxCells`: the most `max_cells` among the package's inputs of the class, the bound a cut that ONE acquisition
|
|
137
|
+
* asks for every input reading it must keep (`option_prints`' per-bar cut asks one more, OPTLOAD G4);
|
|
138
|
+
* - `params` and `paramValues`: the sheet's settings and the run's current values (`WrunRowLaneRunFacts`; absent values
|
|
139
|
+
* when the run read none). Every option knob of the one table naming a setting was already read by them before the
|
|
140
|
+
* facets run (`resolveWrunOptionSettingKnobs`), so a lane never reads such a knob itself
|
|
141
|
+
* (tests/utility/wrun/sources/wrun-row-lanes.setting-knobs.spec.ts).
|
|
142
|
+
*/
|
|
143
|
+
export interface WrunRowLanePlanFacts {
|
|
144
|
+
maxCells?: number;
|
|
145
|
+
laneMaxCells?: number;
|
|
146
|
+
params?: readonly WrunMetadataParam[];
|
|
147
|
+
paramValues?: Readonly<Record<string, number>>;
|
|
148
|
+
}
|
|
107
149
|
/** The exchange a chain-lane instance's chain lists on (the payload field its `chain` names); '' for any other lane
|
|
108
150
|
* or a payload naming none. The chain poll lanes' one rule (`wrunPollLaneChainExchange`: the mark is the same). */
|
|
109
151
|
export declare function wrunRowLaneChainExchange(lane: Pick<WrunRowLaneDescriptor, 'chain'>, extras: Readonly<Record<string, unknown>>): string;
|
|
@@ -153,6 +195,19 @@ export interface WrunRowLaneWindow {
|
|
|
153
195
|
intervalMs: number;
|
|
154
196
|
barGrid?: LiveBucketVenue | null;
|
|
155
197
|
nowMs: number;
|
|
198
|
+
/** The chart's trade date of a bar (its `time.trade_date`, epoch seconds), on which every run cuts a row-budget
|
|
199
|
+
* lane's slice so the slice holds whole sessions (wrun-row-lane-first-paint.util `wrunRowLaneFirstPaintSplit`): a
|
|
200
|
+
* first paint's asks and a later run's are the same windows. Absent: the plain cut, and no early answer. */
|
|
201
|
+
tradeDateOf?: (barOpenMs: number) => number;
|
|
202
|
+
}
|
|
203
|
+
/** What a row lane's fetch hands its caller beside the whole answer (`fetchWrunRowLaneRows`). */
|
|
204
|
+
export interface WrunRowLaneFetchOptions {
|
|
205
|
+
/**
|
|
206
|
+
* The first-paint slice's own answer, before the older asks land: called at most once, with the slice's rows, every
|
|
207
|
+
* bar it holds back read partial (bit 14), and the slice's first bar (`sliceFromTs`: every bar before it is held).
|
|
208
|
+
* Only a full run's first paint asks for it (wrun-overlay-run.util `runWrunSourceLanes`, the lane's early rows).
|
|
209
|
+
*/
|
|
210
|
+
onFirstSlice?: (rows: unknown[][], sliceFromTs: number) => void;
|
|
156
211
|
}
|
|
157
212
|
/**
|
|
158
213
|
* A row lane's rows over a chart window `[barOpens[0], last bar's end)`: a flow or snapshot lane's asks under the
|
|
@@ -160,17 +215,37 @@ export interface WrunRowLaneWindow {
|
|
|
160
215
|
* extras), cut to its horizon and its row budget, each answer landed on the host bars (`wrunLandCellRowsOnHostBars`,
|
|
161
216
|
* the lane's own `fold` when it has one), a snapshot's bar its tier answered nothing for asked again one tier coarser
|
|
162
217
|
* where one fits and retains it when the lane's `coarserWhenEmpty` says so of the acquisition (D12), and the bars no
|
|
163
|
-
* tier retains (or the budget left out) marked partial (bit 14, a marker tuple when empty
|
|
164
|
-
*
|
|
165
|
-
*
|
|
166
|
-
*
|
|
167
|
-
*
|
|
168
|
-
*
|
|
218
|
+
* tier retains (or the budget left out) marked partial (bit 14, a marker tuple when empty; never on an instance its
|
|
219
|
+
* facets widen, whose rows carry no mask: `wrunRowLaneAtWidth`); a `latest` lane asked once over `fallback`, its rows
|
|
220
|
+
* as they come. A flow sums every bucket inside its bar, so its plan reads the window's bar grid as its session grid
|
|
221
|
+
* (wrun-tier-grid.util `wrunCmeSessionBarSpan`): a CME session bar of a day or longer is fit, budgeted and asked over
|
|
222
|
+
* its Globex session, from the 17:00 Chicago open before its 00:00Z stamp, never from a UTC day bucket; a snapshot
|
|
223
|
+
* keeps its stamps (D12's settlement DAY rows). `ask` is the caller's fetch (the full run's, a reconcile's).
|
|
224
|
+
* Ascending, one row per host bar.
|
|
225
|
+
*
|
|
226
|
+
* A row-budget lane's first-paint slice is cut on a trade date's first bar wherever the chart reads trade dates
|
|
227
|
+
* (`window.tradeDateOf`), on every run, so it holds whole sessions and every run asks the same windows.
|
|
228
|
+
* `opts.onFirstSlice` (a full run's first paint): every ask still leaves at once and the promise still answers the
|
|
229
|
+
* whole window, but the slice's own answer is handed over first, once, if it lands with rows while an older ask is
|
|
230
|
+
* still out a macrotask later: the slice's rows, every older bar the projection reads rows for read partial
|
|
231
|
+
* (wrun-row-lane-first-paint.util `wrunRowLaneFirstSliceHeldBars`), and the slice's first bar. Never when no cut falls
|
|
232
|
+
* on a session's first bar (a session longer than the slice: the plain split, asked as today), for a block with no
|
|
233
|
+
* `present` mask (it cannot read a bar as partial), a kit fold carrying the next bar (its pages ask one at a time), or
|
|
234
|
+
* a snapshot whose empty bars ask a coarser tier (that pass would ask the slice's bars again).
|
|
169
235
|
*/
|
|
170
236
|
export declare function fetchWrunRowLaneRows(lane: WrunRowLaneDescriptor, extras: Readonly<Record<string, unknown>>, window: WrunRowLaneWindow, fallback: {
|
|
171
237
|
fromTs: number;
|
|
172
238
|
toTs: number;
|
|
173
|
-
}, ask: (extras: Readonly<Record<string, unknown>>, fromTs: number, toTs: number) => Promise<ReadonlyArray<ReadonlyArray<unknown
|
|
239
|
+
}, ask: (extras: Readonly<Record<string, unknown>>, fromTs: number, toTs: number) => Promise<ReadonlyArray<ReadonlyArray<unknown>>>, opts?: WrunRowLaneFetchOptions): Promise<unknown[][]>;
|
|
240
|
+
/**
|
|
241
|
+
* A landed row with every packed block (a Float64Array a worker handed the page by transfer, `count x width` values back
|
|
242
|
+
* to back: OPTLOAD G5 O6) split into plain tuples of `width` values, every other cell as it is; a new array. The one
|
|
243
|
+
* point a lane's rows enter its buffer, so every reader of them reads arrays: the partial marks (which keep array
|
|
244
|
+
* tuples), the live reconcile's comparison of a re-asked bar (a typed block compares by identity, so an unchanged bar
|
|
245
|
+
* would read revised on every poll and reseed the session), the row builder. A block that is no whole number of tuples
|
|
246
|
+
* stays as it is (`exactTuples` skips it).
|
|
247
|
+
*/
|
|
248
|
+
export declare function wrunRowLanePlainRow(row: ReadonlyArray<unknown>, width: number): unknown[];
|
|
174
249
|
/**
|
|
175
250
|
* A host-grid ask plan cut to a lane's horizon for one acquisition (`WrunRowLaneHorizon`): every window bar that
|
|
176
251
|
* opens before `completeFromMs` joins the partial bars, and the asks start at the first bar that ends after
|
|
@@ -185,6 +260,20 @@ export declare function wrunRowLaneAsksWithinHorizon(plan: {
|
|
|
185
260
|
asks: WrunHostGridAsk[];
|
|
186
261
|
partialBars: number[];
|
|
187
262
|
};
|
|
263
|
+
/**
|
|
264
|
+
* The acquisition a row lane's budget projects the window's bars under (`wrunRowLaneAsksWithinRowBudget` and the
|
|
265
|
+
* first-paint slice, both from `fetchWrunRowLaneRows`): the instance's payload, and for a chain instance under the flow
|
|
266
|
+
* lanes' `history` "today" the first instant of today named off the window's NEWEST bar exactly as each ask's K control
|
|
267
|
+
* names it (option-flow-bars.util `optionFlowTodayFields`: the trade date of the chart's newest bar on the chain's venue
|
|
268
|
+
* clock, option-trade-date.util `optionTodayStartMsByClock`, under `WRUN_OPTION_FLOW_TODAY_FIELD`), so the projection
|
|
269
|
+
* (wrun-option-contract-flow.util `wrunOptionFlowBarBeforeToday`) budgets exactly the bars the worker reads. The payload
|
|
270
|
+
* names no today (the control adds it per ask, off the chart): projected without it, every bar before today was
|
|
271
|
+
* projected in full though it reads nothing, and once the budget filled the older bars were cut and marked partial. The
|
|
272
|
+
* window's newest bar is the chart's on a full run and a reconcile, and never newer than it on a clamped window, so this
|
|
273
|
+
* today is never later than the worker's: a bar the worker reads is never projected at nothing. The trade-date rules
|
|
274
|
+
* load only for such an instance (they stay off the boot path).
|
|
275
|
+
*/
|
|
276
|
+
export declare function wrunRowLaneBudgetAcquisition(lane: Pick<WrunRowLaneDescriptor, 'chain'>, extras: Readonly<Record<string, unknown>>, window: Pick<WrunRowLaneWindow, 'barOpens' | 'intervalMs'>): Promise<Readonly<Record<string, unknown>>>;
|
|
188
277
|
/** A row budget's cap in rows: the source answer budget (kscript-source-answer-budget.leaf) in rows of the lane's
|
|
189
278
|
* answered width. One number for every lane, the row cache and the worker's cap; a lane never picks its own. */
|
|
190
279
|
export declare function wrunRowLaneMaxRows(budget: Pick<WrunRowLaneRowBudget, 'cellsPerRow'>): number;
|
|
@@ -236,9 +325,11 @@ export declare function wrunRowLaneOwnAsk(extras: Readonly<Record<string, unknow
|
|
|
236
325
|
* bar the lane holds no row for reads a present EMPTY block). A PARTIAL bar stays partial through the projection
|
|
237
326
|
* (`wrunProjectedBlock`). A `latest` lane's newest row lands on the LIVE row alone (`liveTs`, the chart's last row;
|
|
238
327
|
* the options chain's rule) whatever its stamp, every other row reading an empty block. `afterTs` (a tail build's
|
|
239
|
-
* carry) keeps the rows stamped after it, except a `latest` lane's newest.
|
|
328
|
+
* carry) keeps the rows stamped after it, except a `latest` lane's newest. An input reading a window-level pass
|
|
329
|
+
* (`cellsWindow`) reads every row the lane holds first, whatever `afterTs` keeps, and each bar's projection reads the
|
|
330
|
+
* answer.
|
|
240
331
|
*/
|
|
241
|
-
export declare function wrunRowLaneCellRows(lane: Pick<WrunRowLaneDescriptor, 'width' | 'landing' | 'cells' | 'finiteColumns' | 'presentMask'>, rows: ReadonlyArray<ReadonlyArray<unknown>>, input: WrunRowLaneCellInput, opts?: {
|
|
332
|
+
export declare function wrunRowLaneCellRows(lane: Pick<WrunRowLaneDescriptor, 'width' | 'landing' | 'cells' | 'cellsWindow' | 'finiteColumns' | 'presentMask'>, rows: ReadonlyArray<ReadonlyArray<unknown>>, input: WrunRowLaneCellInput, opts?: {
|
|
242
333
|
liveTs?: number;
|
|
243
334
|
afterTs?: number;
|
|
244
335
|
}): Array<{
|