@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.
Files changed (210) hide show
  1. package/README.md +27 -4
  2. package/dist/constants/feature-flags.constants.d.ts +5 -0
  3. package/dist/constants/feature-flags.constants.js +32 -0
  4. package/dist/constants/marketCapabilities.constants.d.ts +14 -9
  5. package/dist/constants/marketCapabilities.constants.js +36 -13
  6. package/dist/constants/opra-compliance.constants.d.ts +14 -0
  7. package/dist/constants/opra-compliance.constants.js +14 -0
  8. package/dist/constants/option-venues.constants.d.ts +29 -6
  9. package/dist/constants/option-venues.constants.js +19 -2
  10. package/dist/constants/venue-presets.constants.d.ts +17 -3
  11. package/dist/constants/venue-presets.constants.js +17 -3
  12. package/dist/host-env.d.ts +34 -4
  13. package/dist/host-env.js +21 -0
  14. package/dist/host-ports.types.d.ts +51 -3
  15. package/dist/index.d.ts +17 -0
  16. package/dist/index.js +17 -0
  17. package/dist/indicators/controls/tpo-session.util.d.ts +40 -11
  18. package/dist/indicators/controls/tpo-session.util.js +138 -14
  19. package/dist/interfaces/opra-realtime.interface.d.ts +13 -11
  20. package/dist/interfaces/opra-realtime.interface.js +10 -10
  21. package/dist/interfaces/option-instrument.interface.d.ts +6 -0
  22. package/dist/interfaces/wrun-runtime.interface.d.ts +34 -13
  23. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +57 -10
  24. package/dist/kscript-data/controls/live-trades-merge.util.js +85 -16
  25. package/dist/market-data/billing.interface.d.ts +138 -17
  26. package/dist/market-data/billing.interface.js +25 -8
  27. package/dist/market-data/venues/index.d.ts +3 -3
  28. package/dist/market-data/venues/opra.contract.copy.json +5 -3
  29. package/dist/market-data/venues/opra.d.ts +3 -3
  30. package/dist/market-data/venues/opra.js +5 -4
  31. package/dist/replay/replayLadder.js +3 -1
  32. package/dist/settings-templates/footprint-rows.d.ts +25 -0
  33. package/dist/settings-templates/footprint-rows.js +127 -0
  34. package/dist/settings-templates/form-rows.d.ts +56 -0
  35. package/dist/settings-templates/form-rows.js +19 -0
  36. package/dist/settings-templates/frvp-fields.js +14 -0
  37. package/dist/settings-templates/index.d.ts +10 -1
  38. package/dist/settings-templates/index.js +11 -2
  39. package/dist/settings-templates/indicator-fields.js +78 -0
  40. package/dist/settings-templates/tool-rules.d.ts +35 -9
  41. package/dist/settings-templates/tool-rules.js +42 -8
  42. package/dist/settings-templates/tool-tables.generated.js +13 -2
  43. package/dist/utility/chart/candle-volume-unit.leaf.d.ts +16 -0
  44. package/dist/utility/chart/candle-volume-unit.leaf.js +61 -0
  45. package/dist/utility/chart/crypto-index.leaf.d.ts +2 -2
  46. package/dist/utility/chart/crypto-index.leaf.js +2 -2
  47. package/dist/utility/chart/footprint-columns.util.d.ts +74 -0
  48. package/dist/utility/chart/footprint-columns.util.js +106 -0
  49. package/dist/utility/chart/footprint-display-mode.util.d.ts +40 -0
  50. package/dist/utility/chart/footprint-display-mode.util.js +62 -0
  51. package/dist/utility/chart/footprint-sierra-look.util.d.ts +2 -0
  52. package/dist/utility/chart/footprint-sierra-look.util.js +37 -0
  53. package/dist/utility/chart/index-mode-admission.util.js +9 -1
  54. package/dist/utility/chart/index-mode.util.d.ts +5 -2
  55. package/dist/utility/chart/index-mode.util.js +23 -13
  56. package/dist/utility/chart/kscript-venue-policy.util.d.ts +28 -21
  57. package/dist/utility/chart/kscript-venue-policy.util.js +34 -26
  58. package/dist/utility/chart/marketKind.util.d.ts +12 -10
  59. package/dist/utility/chart/marketKind.util.js +17 -7
  60. package/dist/utility/chart/om-panel-push-style.util.d.ts +7 -7
  61. package/dist/utility/chart/om-panel-push-style.util.js +17 -15
  62. package/dist/utility/chart/om-panel.util.d.ts +11 -0
  63. package/dist/utility/chart/om-panel.util.js +65 -6
  64. package/dist/utility/chart/profile-block-size.util.d.ts +16 -0
  65. package/dist/utility/chart/profile-block-size.util.js +7 -0
  66. package/dist/utility/chart/quote-perp.leaf.d.ts +17 -0
  67. package/dist/utility/chart/quote-perp.leaf.js +20 -0
  68. package/dist/utility/chart/window-geometry.leaf.d.ts +23 -1
  69. package/dist/utility/chart/window-geometry.leaf.js +78 -6
  70. package/dist/utility/chart/window-owner.leaf.d.ts +13 -0
  71. package/dist/utility/chart/window-owner.leaf.js +5 -0
  72. package/dist/utility/chart/wrun-run-result.util.d.ts +5 -0
  73. package/dist/utility/chart/wrun-run-result.util.js +4 -1
  74. package/dist/utility/common/transformations.util.d.ts +7 -0
  75. package/dist/utility/common/transformations.util.js +11 -0
  76. package/dist/utility/options/cme-options-root.util.d.ts +25 -0
  77. package/dist/utility/options/cme-options-root.util.js +40 -0
  78. package/dist/utility/options/option-book.util.d.ts +27 -0
  79. package/dist/utility/options/option-book.util.js +76 -0
  80. package/dist/utility/options/option-trade-date.util.d.ts +50 -0
  81. package/dist/utility/options/option-trade-date.util.js +120 -0
  82. package/dist/utility/options/option-venue.util.d.ts +3 -3
  83. package/dist/utility/options/option-venue.util.js +3 -3
  84. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +1 -1
  85. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +2 -2
  86. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +2 -2
  87. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +5 -1
  88. package/dist/utility/wrun/sources/host-grid-landing.d.ts +4 -2
  89. package/dist/utility/wrun/sources/host-grid-landing.js +8 -0
  90. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +40 -4
  91. package/dist/utility/wrun/sources/lanes/options_flow.js +115 -18
  92. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +12 -9
  93. package/dist/utility/wrun/sources/opra-option-lanes.util.js +10 -7
  94. package/dist/utility/wrun/sources/row-lane-registry.js +10 -5
  95. package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
  96. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.d.ts +3 -2
  97. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +30 -5
  98. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +9 -3
  99. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +13 -5
  100. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +25 -1
  101. package/dist/utility/wrun/sources/row-lanes/option_prints.js +161 -30
  102. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.d.ts +4 -0
  103. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +65 -0
  104. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +55 -1
  105. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +83 -2
  106. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +17 -1
  107. package/dist/utility/wrun/sources/row-lanes/option_surface.js +33 -2
  108. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +7 -1
  109. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +51 -5
  110. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +136 -3
  111. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +42 -0
  112. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +146 -0
  113. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +25 -5
  114. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +111 -20
  115. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +291 -48
  116. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +16 -3
  117. package/dist/utility/wrun/wrun-batched-marks.util.js +30 -19
  118. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +37 -9
  119. package/dist/utility/wrun/wrun-batched-readout.util.js +61 -15
  120. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -0
  121. package/dist/utility/wrun/wrun-cell-capacity.leaf.d.ts +66 -0
  122. package/dist/utility/wrun/wrun-cell-capacity.leaf.js +86 -0
  123. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +147 -9
  124. package/dist/utility/wrun/wrun-chart-market-facts.util.js +345 -11
  125. package/dist/utility/wrun/wrun-cloud-record.leaf.d.ts +27 -0
  126. package/dist/utility/wrun/wrun-cloud-record.leaf.js +71 -0
  127. package/dist/utility/wrun/wrun-cloud-record.util.d.ts +4 -21
  128. package/dist/utility/wrun/wrun-cloud-record.util.js +5 -65
  129. package/dist/utility/wrun/wrun-color-facts.util.d.ts +19 -9
  130. package/dist/utility/wrun/wrun-color-facts.util.js +24 -14
  131. package/dist/utility/wrun/wrun-color-settings.util.d.ts +22 -9
  132. package/dist/utility/wrun/wrun-color-settings.util.js +57 -23
  133. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.d.ts +17 -0
  134. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.js +9 -0
  135. package/dist/utility/wrun/wrun-download-meter.util.d.ts +92 -0
  136. package/dist/utility/wrun/wrun-download-meter.util.js +122 -0
  137. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +10 -3
  138. package/dist/utility/wrun/wrun-draft-overlay.util.js +63 -6
  139. package/dist/utility/wrun/wrun-frames.js +5 -5
  140. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +2 -2
  141. package/dist/utility/wrun/wrun-hosted-wire-caps.js +11 -0
  142. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +33 -17
  143. package/dist/utility/wrun/wrun-hud-looks.util.js +30 -16
  144. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +29 -3
  145. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +33 -3
  146. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +8 -6
  147. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +8 -6
  148. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -2
  149. package/dist/utility/wrun/wrun-live-intake.util.d.ts +6 -2
  150. package/dist/utility/wrun/wrun-live-intake.util.js +136 -21
  151. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -1
  152. package/dist/utility/wrun/wrun-live-tick.util.js +130 -44
  153. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.d.ts +53 -0
  154. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.js +162 -0
  155. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +224 -0
  156. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +342 -0
  157. package/dist/utility/wrun/wrun-market-size-defaults.util.d.ts +88 -0
  158. package/dist/utility/wrun/wrun-market-size-defaults.util.js +471 -0
  159. package/dist/utility/wrun/wrun-opra-flow.leaf.d.ts +43 -8
  160. package/dist/utility/wrun/wrun-opra-flow.leaf.js +37 -6
  161. package/dist/utility/wrun/wrun-option-contract-flow.util.d.ts +51 -10
  162. package/dist/utility/wrun/wrun-option-contract-flow.util.js +85 -33
  163. package/dist/utility/wrun/wrun-option-prints.util.d.ts +172 -3
  164. package/dist/utility/wrun/wrun-option-prints.util.js +394 -17
  165. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +99 -0
  166. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +218 -0
  167. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +365 -0
  168. package/dist/utility/wrun/wrun-option-strike-flow.util.js +797 -0
  169. package/dist/utility/wrun/wrun-option-views.util.d.ts +231 -7
  170. package/dist/utility/wrun/wrun-option-views.util.js +643 -23
  171. package/dist/utility/wrun/wrun-options-chain.util.d.ts +6 -4
  172. package/dist/utility/wrun/wrun-options-chain.util.js +8 -5
  173. package/dist/utility/wrun/wrun-options-stop.util.d.ts +2 -1
  174. package/dist/utility/wrun/wrun-options-stop.util.js +3 -2
  175. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +3 -0
  176. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +31 -14
  177. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +22 -0
  178. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +9 -1
  179. package/dist/utility/wrun/wrun-overlay-recovery.util.js +32 -3
  180. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +7 -1
  181. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  182. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +34 -6
  183. package/dist/utility/wrun/wrun-overlay-run.util.js +527 -180
  184. package/dist/utility/wrun/wrun-pack-widths.leaf.d.ts +15 -0
  185. package/dist/utility/wrun/wrun-pack-widths.leaf.js +22 -0
  186. package/dist/utility/wrun/wrun-pack.util.d.ts +13 -8
  187. package/dist/utility/wrun/wrun-pack.util.js +38 -21
  188. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +4 -0
  189. package/dist/utility/wrun/wrun-panel-mount.util.js +62 -22
  190. package/dist/utility/wrun/wrun-panel-style.util.d.ts +41 -14
  191. package/dist/utility/wrun/wrun-panel-style.util.js +86 -26
  192. package/dist/utility/wrun/wrun-param-map.util.d.ts +7 -6
  193. package/dist/utility/wrun/wrun-param-map.util.js +8 -5
  194. package/dist/utility/wrun/wrun-param-values.util.d.ts +10 -2
  195. package/dist/utility/wrun/wrun-param-values.util.js +2 -0
  196. package/dist/utility/wrun/wrun-pin-spelling.util.js +19 -10
  197. package/dist/utility/wrun/wrun-prefix-lanes.util.js +2 -2
  198. package/dist/utility/wrun/wrun-refusal.util.js +17 -2
  199. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +20 -0
  200. package/dist/utility/wrun/wrun-script-inputs.util.js +43 -0
  201. package/dist/utility/wrun/wrun-source-rows.util.d.ts +4 -0
  202. package/dist/utility/wrun/wrun-source-rows.util.js +92 -40
  203. package/dist/utility/wrun/wrun-tape-source.util.d.ts +133 -48
  204. package/dist/utility/wrun/wrun-tape-source.util.js +205 -62
  205. package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +7 -5
  206. package/dist/utility/wrun/wrun-volume-profile-lane.util.js +8 -6
  207. package/dist/workers/utils/volume-profile.worker.util.d.ts +4 -1
  208. package/dist/workers/utils/volume-profile.worker.util.js +5 -2
  209. package/dist/workers/wrun/wrun-abi-host.js +3 -2
  210. 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). The row builder runs it before any row.
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 with a partial bar kept partial unless the class carries no `present` mask; a `latest` lane on the
22
- * live row).
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. Refused by
45
- * name: a scalar input (a row lane serves cell blocks) and a celled one with no `max_cells` (the bound its blocks
46
- * are packed under). Empty when the sheet reads no row-lane class.
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); the instance is the identity and the facets together. A lane with
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?: OpraReadFacts): Promise<WrunRowLanePlan>;
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); a `latest` lane asked
164
- * once over `fallback`, its rows as they come. A flow sums every bucket inside its bar, so its plan reads the window's
165
- * bar grid as its session grid (wrun-tier-grid.util `wrunCmeSessionBarSpan`): a CME session bar of a day or longer
166
- * is fit, budgeted and asked over its Globex session, from the 17:00 Chicago open before its 00:00Z stamp, never from
167
- * a UTC day bucket; a snapshot keeps its stamps (D12's settlement DAY rows). `ask` is the caller's fetch (the full
168
- * run's, a reconcile's). Ascending, one row per host bar.
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>>>): Promise<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<{