@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
|
@@ -302,10 +302,12 @@ export type WrunOptionsChainTuple = [
|
|
|
302
302
|
multiplier: number,
|
|
303
303
|
vega: number
|
|
304
304
|
];
|
|
305
|
-
/** The worker's block: every instrument of the shared chain snapshot
|
|
306
|
-
*
|
|
307
|
-
*
|
|
308
|
-
*
|
|
305
|
+
/** The worker's block: every instrument of the shared chain snapshot's
|
|
306
|
+
* dominant book (C0, `filterDominantBooks`: the tuple carries no symbol, so
|
|
307
|
+
* the kit cannot tell `BTC-...` from `BTC_USDC-...` and every card would sum
|
|
308
|
+
* both) as a tuple, ordered by expiry, then strike, calls before puts, then
|
|
309
|
+
* symbol (deterministic whatever order the map holds), zero-OI contracts
|
|
310
|
+
* kept (the raw chain; a package decides what a zero means). */
|
|
309
311
|
export declare function wrunOptionsChainTuples(instruments: Iterable<OptionInstrumentSnapshot>): WrunOptionsChainTuple[];
|
|
310
312
|
/** A lane row `[ts, [tuple], ...]` (the K_OPTIONS_CHAIN worker's shape,
|
|
311
313
|
* nested like the volume-profile lane's) read back as tuples; a malformed
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { filterDominantBooks } from '../options/option-book.util.js';
|
|
1
2
|
/** f64s per contract tuple (the shared host's `WRUN_HOST_CELL_TUPLE_WIDTHS.options_chain`, the width
|
|
2
3
|
* the packer packs; wrun-source-words.kit-mirror.spec.ts pins it). */
|
|
3
4
|
export const WRUN_OPTIONS_CHAIN_TUPLE_WIDTH = 10;
|
|
@@ -453,12 +454,14 @@ export function wrunOptionsChainOneVenueRefusal(firstInputName, inputName) {
|
|
|
453
454
|
reason: 'one-venue',
|
|
454
455
|
};
|
|
455
456
|
}
|
|
456
|
-
/** The worker's block: every instrument of the shared chain snapshot
|
|
457
|
-
*
|
|
458
|
-
*
|
|
459
|
-
*
|
|
457
|
+
/** The worker's block: every instrument of the shared chain snapshot's
|
|
458
|
+
* dominant book (C0, `filterDominantBooks`: the tuple carries no symbol, so
|
|
459
|
+
* the kit cannot tell `BTC-...` from `BTC_USDC-...` and every card would sum
|
|
460
|
+
* both) as a tuple, ordered by expiry, then strike, calls before puts, then
|
|
461
|
+
* symbol (deterministic whatever order the map holds), zero-OI contracts
|
|
462
|
+
* kept (the raw chain; a package decides what a zero means). */
|
|
460
463
|
export function wrunOptionsChainTuples(instruments) {
|
|
461
|
-
const entries =
|
|
464
|
+
const entries = filterDominantBooks(instruments).filter((snap) => Number.isFinite(snap.strike) && snap.strike > 0 && Number.isFinite(snap.expiryMs));
|
|
462
465
|
entries.sort((a, b) => a.expiryMs - b.expiryMs ||
|
|
463
466
|
a.strike - b.strike ||
|
|
464
467
|
(a.side === b.side ? 0 : a.side === 'CALL' ? -1 : 1) ||
|
|
@@ -38,7 +38,8 @@ export declare function wrunLaneGatePlanes(facts: WrunGateLaneFacts): Map<string
|
|
|
38
38
|
* A run's lane thunks with every lane on a plane another screen holds (`heldElsewhere`, read at dispatch) answering
|
|
39
39
|
* at once with the typed stop instead of its read. Thunks are the run's shape: the builtin lanes by name (a function
|
|
40
40
|
* or undefined), and the lists of `[lane id, thunk]` pairs (trades legs, poll lanes, row lanes). Everything else is
|
|
41
|
-
* returned as it is.
|
|
41
|
+
* returned as it is. A lane that is sent gets every argument the lane runner hands its thunk (its abandon signal, so a
|
|
42
|
+
* lane asked in pieces stops at its budget; a row lane's early rows).
|
|
42
43
|
*/
|
|
43
44
|
export declare function wrunGateLatchedThunks<T extends object>(thunks: T, planes: ReadonlyMap<string, WrunRefusalGatePlane>, heldElsewhere: (plane: WrunRefusalGatePlane) => boolean): T;
|
|
44
45
|
/**
|
|
@@ -85,7 +85,8 @@ export function wrunLaneGatePlanes(facts) {
|
|
|
85
85
|
* A run's lane thunks with every lane on a plane another screen holds (`heldElsewhere`, read at dispatch) answering
|
|
86
86
|
* at once with the typed stop instead of its read. Thunks are the run's shape: the builtin lanes by name (a function
|
|
87
87
|
* or undefined), and the lists of `[lane id, thunk]` pairs (trades legs, poll lanes, row lanes). Everything else is
|
|
88
|
-
* returned as it is.
|
|
88
|
+
* returned as it is. A lane that is sent gets every argument the lane runner hands its thunk (its abandon signal, so a
|
|
89
|
+
* lane asked in pieces stops at its budget; a row lane's early rows).
|
|
89
90
|
*/
|
|
90
91
|
export function wrunGateLatchedThunks(thunks, planes, heldElsewhere) {
|
|
91
92
|
if (planes.size === 0)
|
|
@@ -94,7 +95,7 @@ export function wrunGateLatchedThunks(thunks, planes, heldElsewhere) {
|
|
|
94
95
|
const plane = planes.get(lane);
|
|
95
96
|
if (plane === undefined)
|
|
96
97
|
return run;
|
|
97
|
-
return () => heldElsewhere(plane) ? Promise.reject(new WrunLaneStoppedError('session-elsewhere', plane, lane)) : run();
|
|
98
|
+
return (...args) => heldElsewhere(plane) ? Promise.reject(new WrunLaneStoppedError('session-elsewhere', plane, lane)) : run(...args);
|
|
98
99
|
};
|
|
99
100
|
const out = { ...thunks };
|
|
100
101
|
for (const [key, value] of Object.entries(out)) {
|
|
@@ -255,6 +255,9 @@ export interface WrunOverlayLiveContext {
|
|
|
255
255
|
* Absent when the package reads no row-lane class. */
|
|
256
256
|
rowLanes?: WrunRowLaneInstance[];
|
|
257
257
|
rowLaneRows?: Record<string, ReadonlyArray<ReadonlyArray<unknown>>>;
|
|
258
|
+
/** Row lanes drawing their first-paint slice alone, by the slice's first bar (ms), until the fill's run: no prefix
|
|
259
|
+
* page stands on them, no reconcile lands rows before that bar. */
|
|
260
|
+
rowLaneFilling?: Readonly<Record<string, number>>;
|
|
258
261
|
/** The pinned legs this package declares (absent or empty when it pins
|
|
259
262
|
* none) and their candle buffers, keyed by the leg's fetch key: a PERIOD
|
|
260
263
|
* leg holds the CLOSED candles the full run fetched at the leg's
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The boot graph's side of the wrun overlay lifecycle door
|
|
3
|
-
* (`wrun-lifecycle-runtime.util`, behind a dynamic import). Every trigger
|
|
4
|
-
* pre-candle graph calls them through here: the chart store's pause and resume,
|
|
5
|
-
* titan-charts, the history-range, switch and wake triggers in data-fetching, the
|
|
6
|
-
* lift, the legend Retry, the workspace poll and the live feed. The door, its recovery
|
|
7
|
-
* the replay lane, the live tick
|
|
8
|
-
* with the
|
|
2
|
+
* The boot graph's side of the wrun overlay lifecycle door, the live tick lane and the live intake's
|
|
3
|
+
* market rule and gap mark (`wrun-lifecycle-runtime.util`, behind a dynamic import). Every trigger
|
|
4
|
+
* that lives in the pre-candle graph calls them through here: the chart store's pause and resume,
|
|
5
|
+
* the pan wave in titan-charts, the history-range, switch and wake triggers in data-fetching, the
|
|
6
|
+
* pane budget lift, the legend Retry, the workspace poll and the live feed. The door, its recovery
|
|
7
|
+
* ladders, the replay lane, the live tick, the live intake (with the row builder and the source
|
|
8
|
+
* lanes it reads) and the run pass then evaluate with the first wrun loader, not with the chart
|
|
9
|
+
* (docs/features/kscript/wrun/wrun-browser-runtime.md, "Lifecycle door" and "Boot doors").
|
|
9
10
|
*
|
|
10
11
|
* Each entry keeps the door's contract:
|
|
11
12
|
* - The runtime in hand: the call goes straight to it in the same turn, so the answer and every
|
|
@@ -13,19 +14,28 @@
|
|
|
13
14
|
* their static import) before they register a driver, so this is the path for every driver id.
|
|
14
15
|
* - No runtime yet: "not mine" from the same Map reads the door makes (`hasWrunOverlayDriver`,
|
|
15
16
|
* `hasWrunOverlayLiveContext`), with the door's own answer (false, 'no-driver', 'not-wrun',
|
|
16
|
-
* undefined, a resolved promise
|
|
17
|
-
* stay on this path, and nothing wrun loads.
|
|
18
|
-
* - A driver before the runtime (a registrant that skipped the bind): the runtime
|
|
19
|
-
* call runs once, when it lands. The synchronous answer is the one the door gives
|
|
20
|
-
* Map state ('queued' for the heal, whose tail decides; 'gap-marked' or 'healing' for
|
|
21
|
-
* true for the pause; a promise for the reruns and the resume), and a load that fails
|
|
22
|
-
* like the door, which never rejects.
|
|
17
|
+
* undefined, a resolved promise; admitted and no mark for the intake's two) and no import. A
|
|
18
|
+
* flag-off session and every kScript overlay stay on this path, and nothing wrun loads.
|
|
19
|
+
* - A driver or a live session before the runtime (a registrant that skipped the bind): the runtime
|
|
20
|
+
* loads and the call runs once, when it lands. The synchronous answer is the one the door gives
|
|
21
|
+
* for the same Map state ('queued' for the heal, whose tail decides; 'gap-marked' or 'healing' for
|
|
22
|
+
* the wake; true for the pause; a promise for the reruns and the resume), and a load that fails
|
|
23
|
+
* resolves like the door, which never rejects. The market rule only loads it and answers false,
|
|
24
|
+
* never true: the tick arms a drain and heals a held session for a frame before its own market
|
|
25
|
+
* check, so a frame nothing judged is not admitted (the session's next reconcile repairs it). Ring
|
|
26
|
+
* `wrun-lifecycle-runtime-late` names the entry.
|
|
27
|
+
*
|
|
28
|
+
* The intake's two entries take fixed parameters: the market rule runs per live frame per overlay
|
|
29
|
+
* with a session. A live session exists only after the run pass, which imports the intake and comes
|
|
30
|
+
* with a loader (tests/utility/wrun/wrun-overlay-lifecycle.live-context.spec.ts).
|
|
23
31
|
*/
|
|
24
32
|
import type { WrunHealVerdict } from './wrun-lifecycle.contract.js';
|
|
25
33
|
export type WrunLifecycleRuntime = typeof import('./wrun-lifecycle-runtime.util.js');
|
|
26
34
|
/** An entry's parameters, exactly the runtime's: each entry forwards the arguments it received,
|
|
27
35
|
* so the call the door sees is the trigger's own. */
|
|
28
36
|
type EntryArgs<K extends keyof WrunLifecycleRuntime> = Parameters<WrunLifecycleRuntime[K]>;
|
|
37
|
+
type WrunLiveFrameSeries = EntryArgs<'wrunLiveFrameMarketAdmitted'>[1];
|
|
38
|
+
type WrunLiveGapReason = EntryArgs<'markWrunLiveGap'>[1];
|
|
29
39
|
/** Hand the runtime over in the same turn: a loader calls this with its static import of
|
|
30
40
|
* `wrun-lifecycle-runtime.util` before it registers a driver. */
|
|
31
41
|
export declare function bindWrunLifecycleRuntime(loaded: WrunLifecycleRuntime): void;
|
|
@@ -45,6 +55,13 @@ export declare function pauseWrunOverlay(...args: EntryArgs<'pauseWrunOverlay'>)
|
|
|
45
55
|
export declare function resumeWrunOverlay(...args: EntryArgs<'resumeWrunOverlay'>): Promise<void> | undefined;
|
|
46
56
|
/** `scheduleWrunOverlayLiveTick` (the live tick lane): nothing without the overlay's live session. */
|
|
47
57
|
export declare function scheduleWrunOverlayLiveTick(...args: EntryArgs<'scheduleWrunOverlayLiveTick'>): void;
|
|
58
|
+
/** `wrunLiveFrameMarketAdmitted` (the live intake's market rule, before the live feed hands a frame to the tick
|
|
59
|
+
* lane): true without the overlay's live session, as the intake answers. Late, false: the runtime loads, and the
|
|
60
|
+
* frames after it lands are judged by the intake. */
|
|
61
|
+
export declare function wrunLiveFrameMarketAdmitted(indicatorId: string, series: WrunLiveFrameSeries): boolean;
|
|
62
|
+
/** `markWrunLiveGap` (the live intake's reconcile mark, the workspace poll's poll-due): nothing without the overlay's
|
|
63
|
+
* live session, as the intake does. Late, the gap is marked when the runtime lands. */
|
|
64
|
+
export declare function markWrunLiveGap(indicatorId: string, reason: WrunLiveGapReason): void;
|
|
48
65
|
/** `feedWrunRideBookRows` (the live tick lane): false when nothing was queued. */
|
|
49
66
|
export declare function feedWrunRideBookRows(...args: EntryArgs<'feedWrunRideBookRows'>): boolean;
|
|
50
67
|
export {};
|
|
@@ -119,6 +119,28 @@ export function scheduleWrunOverlayLiveTick(...args) {
|
|
|
119
119
|
return;
|
|
120
120
|
void whenLoaded('live-tick', indicatorId, (loaded) => loaded.scheduleWrunOverlayLiveTick(...args));
|
|
121
121
|
}
|
|
122
|
+
/** `wrunLiveFrameMarketAdmitted` (the live intake's market rule, before the live feed hands a frame to the tick
|
|
123
|
+
* lane): true without the overlay's live session, as the intake answers. Late, false: the runtime loads, and the
|
|
124
|
+
* frames after it lands are judged by the intake. */
|
|
125
|
+
export function wrunLiveFrameMarketAdmitted(indicatorId, series) {
|
|
126
|
+
if (runtime)
|
|
127
|
+
return runtime.wrunLiveFrameMarketAdmitted(indicatorId, series);
|
|
128
|
+
if (!hasWrunOverlayLiveContext(indicatorId))
|
|
129
|
+
return true;
|
|
130
|
+
void whenLoaded('market-admitted', indicatorId, () => undefined);
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
133
|
+
/** `markWrunLiveGap` (the live intake's reconcile mark, the workspace poll's poll-due): nothing without the overlay's
|
|
134
|
+
* live session, as the intake does. Late, the gap is marked when the runtime lands. */
|
|
135
|
+
export function markWrunLiveGap(indicatorId, reason) {
|
|
136
|
+
if (runtime) {
|
|
137
|
+
runtime.markWrunLiveGap(indicatorId, reason);
|
|
138
|
+
return;
|
|
139
|
+
}
|
|
140
|
+
if (!hasWrunOverlayLiveContext(indicatorId))
|
|
141
|
+
return;
|
|
142
|
+
void whenLoaded('live-gap', indicatorId, (loaded) => loaded.markWrunLiveGap(indicatorId, reason));
|
|
143
|
+
}
|
|
122
144
|
/** `feedWrunRideBookRows` (the live tick lane): false when nothing was queued. */
|
|
123
145
|
export function feedWrunRideBookRows(...args) {
|
|
124
146
|
if (runtime)
|
|
@@ -39,7 +39,8 @@ import { type WrunRefusalGatePlane } from './wrun-refusal.util.js';
|
|
|
39
39
|
* flag and the execution guard (the guarded engine calls), replay (only the
|
|
40
40
|
* replay lane's run draws over replay rows), the ONE fetch gate (`isIndicatorGatedForFetch`:
|
|
41
41
|
* mode or pane budget), a collapsed or pane-hidden pane for the
|
|
42
|
-
* loaded-range-refresh family only
|
|
42
|
+
* loaded-range-refresh family only (never a pane its window hid, which is
|
|
43
|
+
* the window's layout: isPaneHiddenByWindow), the CME display wall (the run head
|
|
43
44
|
* refuses it too; read here so a heal or a rung declines instead of spending
|
|
44
45
|
* a run), then the narrow deterministic latch for the waves and the heal
|
|
45
46
|
* (`failedDeterministicHold`). Null for an id with no driver, without loading
|
|
@@ -87,6 +88,13 @@ export declare function healWrunOverlayIfIdle(chartIndex: number, indicatorId: s
|
|
|
87
88
|
* read is still out (run-schedule/wrun-late-reads.util) the ladder never asks
|
|
88
89
|
* it again: the rung runs the moment the reads answer (their rows adopted),
|
|
89
90
|
* and a rung that comes due first waits for them (their read joined).
|
|
91
|
+
* A lane that drew its first-paint slice alone (cause `filling`: the rest of
|
|
92
|
+
* its window is its late read) rides the same ladder: its rung runs when that
|
|
93
|
+
* read answers, adopts it, and spends no attempt when it adopts fills alone
|
|
94
|
+
* (`runWrunSourceRung`). An arm of fills alone comes from a run that landed
|
|
95
|
+
* every other lane, so it ends the episode it ran in (as such a run retires
|
|
96
|
+
* it) and starts a fresh one: an exhausted or terminal episode never strands a
|
|
97
|
+
* fill.
|
|
90
98
|
*/
|
|
91
99
|
export declare function armWrunSourceRecovery(chartIndex: number, indicatorId: string, degraded: ReadonlyArray<WrunDegradedLane>): void;
|
|
92
100
|
/** Drop one overlay's source ladder: every lane landed ('recovered'), a user
|
|
@@ -5,6 +5,7 @@ import { attachWrunRefusal } from './wrun-refusal.util.js';
|
|
|
5
5
|
import { onGateSessionLatchChange } from '../v2/gate-session-latch.util.js';
|
|
6
6
|
import { __resetWrunGatePlaneReadersForTests, forgetWrunGatePlaneReader, wrunGatePlaneReaders, } from './wrun-gate-plane-readers.util.js';
|
|
7
7
|
import { overlayExecutionGuardKey } from '../chart/overlay-execution-guard-key.leaf.js';
|
|
8
|
+
import { isPaneHiddenByWindow } from '../chart/window-owner.leaf.js';
|
|
8
9
|
import { LOCAL_ENGINE_SELF_HEAL_BASE_DELAY_MS, openLocalEngineSelfHealGate, recordLocalEngineSelfHealAttempt, } from '../chart/local-engine-self-heal-backoff.util.js';
|
|
9
10
|
import { KSCRIPT_SECONDARY_SOURCE_MAX_RECOVERY_ATTEMPTS, KSCRIPT_SECONDARY_SOURCE_RETRY_DELAYS_MS, } from '../chart/kscript-source-degrade.leaf.js';
|
|
10
11
|
import { __resetWrunLateReadsForTests, forgetWrunLateReads, onWrunLateReadSettled, wrunLateReadsAnswered, wrunLateReadsOut, } from './run-schedule/wrun-late-reads.util.js';
|
|
@@ -82,7 +83,8 @@ function loadWrunStoreSide() {
|
|
|
82
83
|
* flag and the execution guard (the guarded engine calls), replay (only the
|
|
83
84
|
* replay lane's run draws over replay rows), the ONE fetch gate (`isIndicatorGatedForFetch`:
|
|
84
85
|
* mode or pane budget), a collapsed or pane-hidden pane for the
|
|
85
|
-
* loaded-range-refresh family only
|
|
86
|
+
* loaded-range-refresh family only (never a pane its window hid, which is
|
|
87
|
+
* the window's layout: isPaneHiddenByWindow), the CME display wall (the run head
|
|
86
88
|
* refuses it too; read here so a heal or a rung declines instead of spending
|
|
87
89
|
* a run), then the narrow deterministic latch for the waves and the heal
|
|
88
90
|
* (`failedDeterministicHold`). Null for an id with no driver, without loading
|
|
@@ -121,8 +123,11 @@ candidate = {}) {
|
|
|
121
123
|
.find((candidate) => candidate?.id === indicatorId);
|
|
122
124
|
const metas = getTC(chartIndex)?.metadata;
|
|
123
125
|
const meta = metas?.find((entry) => entry?.id === indicatorId);
|
|
126
|
+
// A pane its window hid because the owner draws nothing there (window-geometry.leaf, C5) is the window's layout,
|
|
127
|
+
// not the reader's collapse: the owner's runs feed the window's tables, so they never hold on it.
|
|
128
|
+
const paneCollapsed = meta?.isPaneHidden === true && !isPaneHiddenByWindow(meta);
|
|
124
129
|
if (COLLAPSED_HOLD_REASONS.has(reason) &&
|
|
125
|
-
(overlay?.isBottomPaneCollapsed === true || overlay?.isPaneHidden === true ||
|
|
130
|
+
(overlay?.isBottomPaneCollapsed === true || overlay?.isPaneHidden === true || paneCollapsed)) {
|
|
126
131
|
return 'collapsed';
|
|
127
132
|
}
|
|
128
133
|
// The run head's reading: the workspace's exchange against the mounted
|
|
@@ -516,6 +521,13 @@ const settledRuns = new Map();
|
|
|
516
521
|
* read is still out (run-schedule/wrun-late-reads.util) the ladder never asks
|
|
517
522
|
* it again: the rung runs the moment the reads answer (their rows adopted),
|
|
518
523
|
* and a rung that comes due first waits for them (their read joined).
|
|
524
|
+
* A lane that drew its first-paint slice alone (cause `filling`: the rest of
|
|
525
|
+
* its window is its late read) rides the same ladder: its rung runs when that
|
|
526
|
+
* read answers, adopts it, and spends no attempt when it adopts fills alone
|
|
527
|
+
* (`runWrunSourceRung`). An arm of fills alone comes from a run that landed
|
|
528
|
+
* every other lane, so it ends the episode it ran in (as such a run retires
|
|
529
|
+
* it) and starts a fresh one: an exhausted or terminal episode never strands a
|
|
530
|
+
* fill.
|
|
519
531
|
*/
|
|
520
532
|
export function armWrunSourceRecovery(chartIndex, indicatorId, degraded) {
|
|
521
533
|
if (!hasWrunOverlayDriver(indicatorId))
|
|
@@ -538,9 +550,17 @@ export function armWrunSourceRecovery(chartIndex, indicatorId, degraded) {
|
|
|
538
550
|
waitingOnReads: false,
|
|
539
551
|
unwatch: undefined,
|
|
540
552
|
episode: wrunSourceRecoveryEpisodeOf(chartIndex, indicatorId),
|
|
553
|
+
fillRung: false,
|
|
541
554
|
};
|
|
542
555
|
sourceRecoveries.set(indicatorId, recovery);
|
|
543
556
|
}
|
|
557
|
+
const fillsAlone = retryable.every((lane) => lane.cause === 'filling');
|
|
558
|
+
if (fillsAlone && (recovery.step > 0 || recovery.terminal)) {
|
|
559
|
+
recovery.step = 0;
|
|
560
|
+
recovery.terminal = false;
|
|
561
|
+
recovery.episode = wrunSourceRecoveryEpisodeOf(chartIndex, indicatorId);
|
|
562
|
+
}
|
|
563
|
+
recovery.fillRung = fillsAlone;
|
|
544
564
|
recovery.chartIndex = chartIndex;
|
|
545
565
|
recovery.lanes = new Map(retryable.map((lane) => [lane.lane, lane]));
|
|
546
566
|
recovery.armedAtSettle = settledRuns.get(indicatorId) ?? 0;
|
|
@@ -708,12 +728,21 @@ async function runWrunSourceRung(indicatorId, recovery) {
|
|
|
708
728
|
scheduleWrunSourceRung(indicatorId, recovery, true);
|
|
709
729
|
return;
|
|
710
730
|
}
|
|
711
|
-
|
|
731
|
+
// A rung that adopts planned fills alone (its arm's lanes all drew their first-paint slice alone, and every one's read
|
|
732
|
+
// answered with rows) answers no failure: it spends none of the episode's attempts, so a first paint never shortens
|
|
733
|
+
// the ladder a real degrade gets. The arm's one rung: a rung after it (its run failed, or did not arm again) counts,
|
|
734
|
+
// so the ladder stays bounded.
|
|
735
|
+
const lanes = [...recovery.lanes.keys()];
|
|
736
|
+
const fillOnly = recovery.fillRung && wrunLateReadsAnswered(indicatorId, lanes).length === lanes.length;
|
|
737
|
+
recovery.fillRung = false;
|
|
738
|
+
if (!fillOnly)
|
|
739
|
+
recovery.step += 1;
|
|
712
740
|
ring('wrun-source-recovery-rung', {
|
|
713
741
|
chartIndex: recovery.chartIndex,
|
|
714
742
|
indicatorId,
|
|
715
743
|
attempt: recovery.step,
|
|
716
744
|
lanes: [...recovery.lanes.keys()],
|
|
745
|
+
...(fillOnly ? { fill: true } : {}),
|
|
717
746
|
});
|
|
718
747
|
// The rung answers an attempt of its episode's origin and reason (`episode`), so the record it ends on names the
|
|
719
748
|
// episode that started the ladder.
|
|
@@ -43,6 +43,12 @@ export interface WrunOverlayResultOptions {
|
|
|
43
43
|
* `visible_by` does not list it mounts nothing, nor the stats rows drawn
|
|
44
44
|
* from it (wrunRowVisibleHere). Absent reads 0, the unknown unit. */
|
|
45
45
|
sizeUnit?: number;
|
|
46
|
+
/** The chart market's dollar unit (wrunMarketDollarUnit when proven: the US
|
|
47
|
+
* dollars one price unit times one size unit is worth; NQ 20, 1 on crypto),
|
|
48
|
+
* read beside the size unit by every build (wrun-overlay-run.util
|
|
49
|
+
* `wrunResultMarketUnits`): the batched marks children's `units` caption and
|
|
50
|
+
* hover divide a record's dollar value by it. Absent: none is proven. */
|
|
51
|
+
valuePerUnit?: number;
|
|
46
52
|
/** WRUN-STYLE (g6): the run's celled source rows the price canvases
|
|
47
53
|
* (heatmaps, footprints, TPO letters, time-anchored profiles) draw from. */
|
|
48
54
|
cellRows?: WrunCellRows;
|
|
@@ -107,7 +113,7 @@ export declare const WRUN_RESULT_CAPTURE_LIMIT = 8;
|
|
|
107
113
|
* of trades behind it, more than a rig's process holds (2026-10-17: the TIP corpus run died at 4 GB on the eighth
|
|
108
114
|
* package). A key added to the options must be added here, or the type below fails to compile.
|
|
109
115
|
*/
|
|
110
|
-
export declare const WRUN_OVERLAY_RESULT_OPTION_KEYS: readonly ["metadata", "outputRows", "title", "params", "texts", "position", "axis", "colors", "fills", "candles", "chartNames", "runTimeline", "priceDigits", "sizeUnit", "cellRows", "canvasTailRows", "batchedTailFromTs", "intervalMs", "exchange", "priceTick", "overlayId", "tpoBlockSize", "legendNote"];
|
|
116
|
+
export declare const WRUN_OVERLAY_RESULT_OPTION_KEYS: readonly ["metadata", "outputRows", "title", "params", "texts", "position", "axis", "colors", "fills", "candles", "chartNames", "runTimeline", "priceDigits", "sizeUnit", "valuePerUnit", "cellRows", "canvasTailRows", "batchedTailFromTs", "intervalMs", "exchange", "priceTick", "overlayId", "tpoBlockSize", "legendNote"];
|
|
111
117
|
/**
|
|
112
118
|
* Record one build on a corpus lane's page (`globalThis.__omRig === true` and the store `__wrunResultCapture` the lane
|
|
113
119
|
* created before the app loaded) under `__wrunResultCapture[<overlay id, else the title>]`, newest last, the last
|
|
@@ -64,6 +64,7 @@ export function buildWrunOverlayRunResult(options) {
|
|
|
64
64
|
...(options.cellRows !== undefined ? { cellRows: options.cellRows } : {}),
|
|
65
65
|
...(options.canvasTailRows !== undefined ? { canvasTailRows: options.canvasTailRows } : {}),
|
|
66
66
|
...(options.batchedTailFromTs !== undefined ? { batchedTailFromTs: options.batchedTailFromTs } : {}),
|
|
67
|
+
...(options.valuePerUnit !== undefined ? { valuePerUnit: options.valuePerUnit } : {}),
|
|
67
68
|
...(options.intervalMs !== undefined ? { intervalMs: options.intervalMs } : {}),
|
|
68
69
|
...(options.exchange !== undefined ? { exchange: options.exchange } : {}),
|
|
69
70
|
...(options.priceTick !== undefined ? { priceTick: options.priceTick } : {}),
|
|
@@ -166,6 +167,7 @@ export const WRUN_OVERLAY_RESULT_OPTION_KEYS = [
|
|
|
166
167
|
'runTimeline',
|
|
167
168
|
'priceDigits',
|
|
168
169
|
'sizeUnit',
|
|
170
|
+
'valuePerUnit',
|
|
169
171
|
'cellRows',
|
|
170
172
|
'canvasTailRows',
|
|
171
173
|
'batchedTailFromTs',
|
|
@@ -84,6 +84,19 @@ import type { RuntimeDiagnostic } from '../../interfaces/kscript-diagnostics.int
|
|
|
84
84
|
import { buildWrunOverlayRunResult, type WrunCanvasHostFill, type WrunOverlayResultOptions } from './wrun-overlay-result.util.js';
|
|
85
85
|
import { wrunIntegratedRowsView } from './wrun-integration-budget.util.js';
|
|
86
86
|
export { buildWrunOverlayRunResult, type WrunCanvasHostFill, type WrunOverlayResultOptions };
|
|
87
|
+
/**
|
|
88
|
+
* The chart market's units a result build reads, together: its size unit (`wrunChartSizeUnit`: an output whose
|
|
89
|
+
* `visible_by` leaves it out mounts nothing) and its dollar unit when proven (`wrunMarketDollarUnit`: the CME registry's
|
|
90
|
+
* point value of the contract, NQ 20; 1 on crypto and US stocks), which the batched marks' `units` caption and hover
|
|
91
|
+
* divide a record's dollar value by. Synchronous over the facts the run head warmed. Every build spreads it (the full
|
|
92
|
+
* run, the row-source run, the reseed, the refine, the prefix landing and the live tick), so a tail or a reseed never
|
|
93
|
+
* hands the children a size unit without the dollar unit: a tail without it would re-register the hover in dollars.
|
|
94
|
+
* tests/utility/wrun/wrun-big-trades-size-shown-as.spec.ts fails on a build that names a size unit by hand.
|
|
95
|
+
*/
|
|
96
|
+
export declare function wrunResultMarketUnits(market: WrunFactsMarket | undefined): {
|
|
97
|
+
sizeUnit: number;
|
|
98
|
+
valuePerUnit?: number;
|
|
99
|
+
};
|
|
87
100
|
export { wrunIntegratedRowsView };
|
|
88
101
|
/** The leg bars an odds seed fetch reaches back before the window's open
|
|
89
102
|
* (the hosted lane's seed span): the last observation before a thin
|
|
@@ -537,7 +550,13 @@ type WrunBuiltinLaneThunks = {
|
|
|
537
550
|
};
|
|
538
551
|
/** One lane keyed by its id to dispatch (a registry poll lane instance, a trades leg lane): its id and its fetch,
|
|
539
552
|
* handed the signal its run raises when the lane's budget runs out (`runWrunSourceLanes`). */
|
|
540
|
-
|
|
553
|
+
/** A lane's first rows before its whole answer (a row lane's first-paint slice: wrun-row-lanes.util
|
|
554
|
+
* `fetchWrunRowLaneRows` `onFirstSlice`), handed to its thunk by `runWrunSourceLanes`. */
|
|
555
|
+
type WrunLaneEarly = (rows: WrunLaneRows) => void;
|
|
556
|
+
type WrunPollLaneThunk = readonly [
|
|
557
|
+
key: string,
|
|
558
|
+
run: (abandoned: AbortSignal, early?: WrunLaneEarly) => Promise<WrunLaneRows>
|
|
559
|
+
];
|
|
541
560
|
type WrunSourceLaneThunks = WrunBuiltinLaneThunks & {
|
|
542
561
|
/** The trades leg lanes (kit 0.77.0), one thunk per (quote, market) by its lane id. */
|
|
543
562
|
tradeLegs?: ReadonlyArray<WrunPollLaneThunk>;
|
|
@@ -567,10 +586,12 @@ export declare function mergeWrunSourceLaneRuns(runs: ReadonlyArray<WrunSourceLa
|
|
|
567
586
|
* rows with the cause (a budget expiry, an empty or declined answer, any
|
|
568
587
|
* other rejection). Every cause here is retryable, except an answer the
|
|
569
588
|
* data plane refused by name (wrun-lane-refusal.leaf): the same ask is
|
|
570
|
-
* refused again, so no ladder re-asks it.
|
|
589
|
+
* refused again, so no ladder re-asks it. A lane that answered its first rows alone (`filling`: a row lane's
|
|
590
|
+
* first-paint slice) is rows: its whole answer went on as a late read. */
|
|
571
591
|
export type WrunLaneOutcome = {
|
|
572
592
|
kind: 'rows';
|
|
573
593
|
rows: WrunLaneRows;
|
|
594
|
+
filling?: true;
|
|
574
595
|
} | {
|
|
575
596
|
kind: 'degraded';
|
|
576
597
|
rows: [];
|
|
@@ -609,10 +630,11 @@ export interface WrunSourceLanePolicy {
|
|
|
609
630
|
/** Called with each lane id right before its thunk runs, and the lane's send anchor, which the fetch that asks the
|
|
610
631
|
* lane hands its transport. */
|
|
611
632
|
onDispatch?: (lane: string, anchor: WrunLaneSendAnchor) => void;
|
|
612
|
-
/** Called with a lane's own answer when
|
|
613
|
-
*
|
|
614
|
-
*
|
|
615
|
-
|
|
633
|
+
/** Called with a lane's own answer when the run stopped waiting for it while it was still out (never when the answer
|
|
634
|
+
* itself failed): its budget ran out first (`budget`), or the lane handed its first rows over first (`first-slice`:
|
|
635
|
+
* a row lane's first-paint slice, its older bars still out). The read is abandoned, never aborted, and a later run's
|
|
636
|
+
* dispatch may join or adopt it (run-schedule/wrun-late-reads.util). */
|
|
637
|
+
onLate?: (lane: string, answer: Promise<WrunLaneRows>, why: 'budget' | 'first-slice') => void;
|
|
616
638
|
}
|
|
617
639
|
/**
|
|
618
640
|
* A lane's send anchor (`WrunSourceLanePolicy.onDispatch`): the fetch that asks the lane calls `request()` right before
|
|
@@ -645,6 +667,12 @@ export interface WrunLaneSendAnchor {
|
|
|
645
667
|
* poll lanes (`thunks.pollLanes`, one thunk per planned instance) dispatch with
|
|
646
668
|
* them, after the row builder's own lanes; their rows come back under
|
|
647
669
|
* `tradeLegRows` and `pollLaneRows`, keyed by lane id and instance id.
|
|
670
|
+
*
|
|
671
|
+
* A lane may hand its first rows over before its whole answer (`early`, a row lane's first-paint slice on a full run's
|
|
672
|
+
* first paint): when they come before the whole answer and before the budget, the lane settles on them (outcome
|
|
673
|
+
* rows, `filling`) and its whole answer goes on as a late read (`onLate`, `first-slice`), exactly as a read its budget
|
|
674
|
+
* abandoned does, so the source ladder adopts it and nothing asks it twice. Early rows after the budget change
|
|
675
|
+
* nothing: the budget's late read is the whole answer already.
|
|
648
676
|
*/
|
|
649
677
|
export declare function runWrunSourceLanes(thunks: WrunSourceLaneThunks, policy?: WrunSourceLanePolicy): Promise<WrunSourceLaneRun>;
|
|
650
678
|
/**
|