@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
@@ -19,11 +19,33 @@
19
19
  * required`), `expiries`, `history` ("live" | "3d" | "90d") and `overflow` ("refuse" | "largest"), each refused by
20
20
  * name outside its words (`wrun_option_knob_invalid`), and the chain classes' `venue` and `book`. One acquisition a
21
21
  * package: two inputs whose knobs or chains differ refuse by name.
22
+ * - The cuts and filters (OPTLOAD G4, om kit 0.89.0 `optionCellFacets`, each absent at its default so a sheet without
23
+ * them keeps its acquisition): `newest` (0 to 20,000), `newest_tail_ms` (0 to 60,000, beside `newest` only),
24
+ * `types` ("both" | "calls" | "puts"), `sides` (a list of "ask", "bid", "mid", "none", each once), `moneyness`
25
+ * ("all" | "otm" | "itm") and `max_dte` (0 to 3,650), refused by the same name outside their words; and under
26
+ * `overflow: "largest"` the per-bar cut K, one more than the most `max_cells` among the package's inputs of the class
27
+ * (`WrunRowLanePlanFacts.laneMaxCells`, from the planner). A knob om lets name a setting (`min_premium`,
28
+ * `types`, `sides`, `moneyness`, `max_dte`, `newest_tail_ms`: the sheet records the setting's name) is read as the
29
+ * setting's current value by the planner before the facets judge it (wrun-poll-lanes.util
30
+ * `resolveWrunOptionSettingKnobs` over the class's row of the one table, om `resolveOptionParamKnobs`), so a settings
31
+ * change re-plans the input and its ask carries the new value; the lane reads no setting itself.
22
32
  * - History: one ask over the window from the span the backend serves the acquisition (`horizon`: the table the
23
33
  * floor and the history reach, the gateway's bar limit); older bars are partial. The K control `K_OPTION_PRINT`
24
- * reads it on the native-rows path, keyed by second; the landing re-bases each print's offset on its host bar.
34
+ * reads it on the native-rows path, keyed by second, the gateway cutting and filtering it where its answer is the
35
+ * lane's own (the worker twin falls back to today's read for a plane whose gateway refuses the cut by name); the
36
+ * answer crosses to the page packed by transfer and the landing reads its blocks in place, re-basing each print's
37
+ * offset on its host bar.
25
38
  * - Projection, per input: `expiries: "nearest:N"` keeps the bar's N nearest expiries; `overflow: "largest"` cuts a
26
39
  * bar over the input's own `max_cells` to its largest premiums (om's packer rule, bit 14 on the first kept print).
40
+ * Beside `newest` N the cut is the union (the SDK's frozen contract): a window-level pass (`cellsWindow`) finds the
41
+ * window's N newest over every bar the instance holds, by time then print key, and each bar keeps its `max_cells`
42
+ * largest and its prints among them (`wrunLargestOrNewestOptionPrints`), at most `max_cells` + N, the packer's
43
+ * capacity for the input. The union answer, today's whole download and either one with live prints folded in project
44
+ * the same cells, bit 14 included, and every run projects again, so a live print moves the cut. `newest_tail_ms`
45
+ * beside "largest" is refused by name (`wrun_option_prints_tail_largest`): the capacity must stay bounded. The union
46
+ * needs a module whose buffer holds it (the input's `capacity`, the sheet's own: a build at kit scaffold 97 writes
47
+ * `max_cells + newest` there, wrun-cell-capacity.leaf `wrunSheetCellBlockTuples`); a sheet naming no capacity (any
48
+ * module built before) reads `max_cells`, so its bars keep their largest alone, as before the union.
27
49
  * - Live by coin, on the planes whose OPTION_PRINT producer streams (`chainPlanes`: OPRA and CME): the coin channel of
28
50
  * the instance's chain (`K_OPTION_PRINT` subscribes the chain's exchange and underlying, on a governed exchange at a
29
51
  * real-time routed tier only: wrun-coin-lane-live.util) feeds every print of the underlying; the fold keeps the
@@ -42,7 +64,7 @@
42
64
  import { decideWrunLaneChain, resolveWrunLaneChainChart, WRUN_OPTION_CHART_UNRESOLVED_CODE, wrunLaneChainLeadMoved, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
43
65
  import { refuseWrunPollInput, WRUN_POLL_AUTHOR_GATE_SEED } from '../wrun-poll-lane.types.js';
44
66
  import { refuseWrunOptionKnob, wrunNearestExpiryTuples, wrunOptionExpiriesKnob, wrunOptionExpiriesOf, wrunOptionExpiriesWord, } from '../../wrun-option-knobs.util.js';
45
- import { isWrunOptionPrintTuple, WRUN_OPTION_PRINT_COLUMN, WRUN_OPTION_PRINTS_BOOK_FIELD, WRUN_OPTION_PRINTS_CONTINUOUS_FIELD, WRUN_OPTION_PRINTS_EXCHANGE_FIELD, WRUN_OPTION_PRINTS_HISTORY, WRUN_OPTION_PRINTS_OVERFLOW, WRUN_OPTION_PRINTS_WIDTH, wrunLargestPremiumPrints, wrunOptionPrintKept, wrunOptionPrintOf, wrunOptionPrintsAcquisitionOf, wrunOptionPrintsHorizon, wrunOptionPrintsInTimeOrder, wrunOptionPrintTimeMs, } from '../../wrun-option-prints.util.js';
67
+ import { compareWrunOptionPrintsInTimeOrder, forEachWrunOptionPrintTuple, isWrunOptionPrintMarker, isWrunOptionPrintTuple, WRUN_OPTION_MAX_DTE_DAYS, WRUN_OPTION_PRINT_COLUMN, WRUN_OPTION_PRINT_SIDES, WRUN_OPTION_PRINTS_BOOK_FIELD, WRUN_OPTION_PRINTS_CONTINUOUS_FIELD, WRUN_OPTION_PRINTS_EXCHANGE_FIELD, WRUN_OPTION_PRINTS_HISTORY, WRUN_OPTION_PRINTS_MONEYNESS, WRUN_OPTION_PRINTS_NEWEST_MAX, WRUN_OPTION_PRINTS_NEWEST_TAIL_MAX_MS, WRUN_OPTION_PRINTS_OVERFLOW, WRUN_OPTION_PRINTS_TYPES, WRUN_OPTION_PRINTS_WIDTH, wrunLargestOrNewestOptionPrints, wrunLargestPremiumPrints, wrunNewestOptionPrintBound, wrunNewestOptionPrintRows, wrunOptionPrintKept, wrunOptionPrintOf, wrunOptionPrintsAcquisitionOf, wrunOptionPrintsHorizon, wrunOptionPrintsInTimeOrder, wrunOptionPrintTimeMs, } from '../../wrun-option-prints.util.js';
46
68
  import { wrunPartialMarkerTuple, wrunPresentIsPartial, wrunTuplesMarkedPartial } from '../../wrun-present-bits.util.js';
47
69
  import { wrunAuthorRuleSeed } from '../../wrun-refusal.util.js';
48
70
  import { wrunHostBarOf } from '../../wrun-tier-grid.util.js';
@@ -50,6 +72,8 @@ import { wrunHostBarOf } from '../../wrun-tier-grid.util.js';
50
72
  const LANE_KEY = 'option_prints';
51
73
  /** om's refusal name of a missing floor. */
52
74
  export const WRUN_OPTION_PRINTS_MIN_PREMIUM_REQUIRED_CODE = 'wrun_option_prints_min_premium_required';
75
+ /** om's refusal name of a tail beside `overflow: "largest"` (the union's capacity is `max_cells` + `newest`). */
76
+ export const WRUN_OPTION_PRINTS_TAIL_LARGEST_CODE = 'wrun_option_prints_tail_largest';
53
77
  /** What `identity` resolved for a chart (the one chain resolver's chart), read back by `facets`. Keyed by the chart
54
78
  * market; the newest entries kept. */
55
79
  const PRINTS_CHARTS_KEPT = 16;
@@ -86,9 +110,78 @@ export function wrunOptionPrintsExtras(chain) {
86
110
  export function wrunOptionPrintsAcquisitionMoved(acquisition) {
87
111
  return wrunLaneChainLeadMoved(acquisition[WRUN_OPTION_PRINTS_EXCHANGE_FIELD], acquisition[WRUN_OPTION_PRINTS_CONTINUOUS_FIELD], acquisition.coin);
88
112
  }
89
- /** One input's facets: the floor (required), the history, the overflow rule and the expiries word, then its chain,
90
- * decided by the one chain resolver over the chart `identity` resolved (its `venue` and `book`). */
113
+ /** A whole-number knob from `min` to `max`, refused by name outside it; undefined when absent or at 0 (its off). */
114
+ function countKnob(source, ctx, knob, max, what) {
115
+ const value = source[knob];
116
+ if (value === undefined)
117
+ return undefined;
118
+ if (typeof value !== 'number' || !Number.isInteger(value) || value < 0 || value > max) {
119
+ return refuseWrunOptionKnob(ctx, knob, value, `${what}, a whole number from 0 to ${max}`);
120
+ }
121
+ return value > 0 ? value : undefined;
122
+ }
123
+ /** A word knob's word other than its default (`words[0]`, absent too), refused by name outside its words. */
124
+ function wordKnob(source, ctx, knob, words) {
125
+ const value = source[knob] ?? words[0];
126
+ if (typeof value !== 'string' || !words.includes(value)) {
127
+ return refuseWrunOptionKnob(ctx, knob, value, words.join(', '));
128
+ }
129
+ return value === words[0] ? undefined : value;
130
+ }
131
+ /**
132
+ * One input's cuts and filters as acquisition fields (om `optionCellFacets`' print knobs, each absent at its default so
133
+ * a sheet declaring none keeps its acquisition): `newest`, `newestTailMs` (beside `newest` only, never beside
134
+ * `overflow: "largest"`: `wrun_option_prints_tail_largest`), `types`, `sides`
135
+ * (om's facet spelling: the words in om's order joined by commas; none or all four is every side), `moneyness`,
136
+ * `maxDte`, and under `overflow: "largest"` the per-bar cut `largestPerBar` (`laneMaxCells` + 1). Each refused by name
137
+ * outside its words (`wrun_option_knob_invalid`).
138
+ */
139
+ function optionPrintsCutFacets(source, ctx, overflow, laneMaxCells) {
140
+ const newest = countKnob(source, ctx, 'newest', WRUN_OPTION_PRINTS_NEWEST_MAX, 'the newest prints kept');
141
+ const tail = countKnob(source, ctx, 'newest_tail_ms', WRUN_OPTION_PRINTS_NEWEST_TAIL_MAX_MS, 'the ms before the oldest newest print also kept');
142
+ if (tail !== undefined && newest === undefined) {
143
+ refuseWrunOptionKnob(ctx, 'newest_tail_ms', tail, 'a tail beside newest only (declare newest, 1 and up)');
144
+ }
145
+ if (tail !== undefined && overflow === 'largest') {
146
+ refuseWrunPollInput(ctx, `declares newest_tail_ms beside overflow "largest" (${WRUN_OPTION_PRINTS_TAIL_LARGEST_CODE}): each bar holds its ` +
147
+ 'max_cells largest and its prints among the newest, at most max_cells plus newest, a bound a tail would lift; ' +
148
+ 'declare the tail or the largest prints, not both', WRUN_POLL_AUTHOR_GATE_SEED);
149
+ }
150
+ const types = wordKnob(source, ctx, 'types', WRUN_OPTION_PRINTS_TYPES);
151
+ const moneyness = wordKnob(source, ctx, 'moneyness', WRUN_OPTION_PRINTS_MONEYNESS);
152
+ const maxDte = countKnob(source, ctx, 'max_dte', WRUN_OPTION_MAX_DTE_DAYS, 'the days to expiry kept at most');
153
+ const sides = source.sides;
154
+ let sideWords;
155
+ if (sides !== undefined) {
156
+ if (!Array.isArray(sides) ||
157
+ new Set(sides).size !== sides.length ||
158
+ !sides.every((side) => WRUN_OPTION_PRINT_SIDES.includes(side))) {
159
+ refuseWrunOptionKnob(ctx, 'sides', sides, `a list of ${WRUN_OPTION_PRINT_SIDES.join(', ')}, each once`);
160
+ }
161
+ const kept = WRUN_OPTION_PRINT_SIDES.filter((side) => sides.includes(side));
162
+ sideWords = kept.length === 0 || kept.length === WRUN_OPTION_PRINT_SIDES.length ? undefined : kept;
163
+ }
164
+ const largestPerBar = overflow === 'largest' && typeof laneMaxCells === 'number' && Number.isInteger(laneMaxCells) && laneMaxCells >= 1
165
+ ? laneMaxCells + 1
166
+ : undefined;
167
+ return {
168
+ ...(newest !== undefined ? { newest } : {}),
169
+ ...(tail !== undefined ? { newestTailMs: tail } : {}),
170
+ ...(largestPerBar !== undefined ? { largestPerBar } : {}),
171
+ ...(types !== undefined ? { types } : {}),
172
+ ...(sideWords !== undefined ? { sides: sideWords.join(',') } : {}),
173
+ ...(maxDte !== undefined ? { maxDte } : {}),
174
+ ...(moneyness !== undefined ? { moneyness } : {}),
175
+ };
176
+ }
177
+ /** One input's facets: the floor (required), the history, the overflow rule, the expiries word and the cuts and
178
+ * filters, each knob naming a setting already read as its value by the planner (`resolveWrunOptionSettingKnobs`, the
179
+ * class's row of the one table), then its chain, decided by the one chain resolver over the chart `identity` resolved
180
+ * (its `venue` and `book`). */
91
181
  async function optionPrintsFacets(source, ctx) {
182
+ // The planner's facts beside the chart: the package's most `max_cells` of the class (the per-bar cut under
183
+ // "largest" asks one more).
184
+ const facts = ctx;
92
185
  const minPremium = source.min_premium;
93
186
  if (minPremium === undefined) {
94
187
  return refuseWrunPollInput(ctx, `declares no min_premium (${WRUN_OPTION_PRINTS_MIN_PREMIUM_REQUIRED_CODE}): declare the smallest premium a print ` +
@@ -106,6 +199,7 @@ async function optionPrintsFacets(source, ctx) {
106
199
  return refuseWrunOptionKnob(ctx, 'overflow', overflow, WRUN_OPTION_PRINTS_OVERFLOW.join(', '));
107
200
  }
108
201
  const expiries = wrunOptionExpiriesWord(wrunOptionExpiriesKnob(source, ctx));
202
+ const cuts = optionPrintsCutFacets(source, ctx, overflow, facts.laneMaxCells);
109
203
  const chart = printsCharts.get(wrunLaneChartKey(ctx));
110
204
  if (chart === undefined) {
111
205
  return refuseWrunPollInput(ctx, 'could not resolve the chart market for its options chain: Run again', wrunAuthorRuleSeed(WRUN_OPTION_CHART_UNRESOLVED_CODE));
@@ -117,25 +211,27 @@ async function optionPrintsFacets(source, ctx) {
117
211
  history,
118
212
  overflow,
119
213
  ...(expiries !== undefined ? { expiries } : {}),
214
+ ...cuts,
120
215
  };
121
216
  }
122
- /** A host bar's prints: each second row's prints, their offsets re-based on the bar's open, in time order. */
217
+ /** A host bar's prints: each second row's prints, read in place from its cells (the worker's packed blocks, or plain
218
+ * tuples), their offsets re-based on the bar's open, in time order. */
123
219
  function landOptionPrints(group) {
220
+ const width = WRUN_OPTION_PRINTS_WIDTH;
124
221
  const out = [];
125
222
  for (const row of group.rows) {
126
223
  const base = Number(row[0]) - group.barOpenMs;
127
224
  if (!Number.isFinite(base))
128
225
  continue;
129
- for (let at = 1; at < row.length; at += 1) {
130
- const cell = row[at];
131
- if (!isWrunOptionPrintTuple(cell))
132
- continue;
133
- const tuple = [...cell];
134
- tuple[WRUN_OPTION_PRINT_COLUMN.offset] = base + cell[WRUN_OPTION_PRINT_COLUMN.offset];
226
+ forEachWrunOptionPrintTuple(row, (source, offset) => {
227
+ const tuple = new Array(width);
228
+ for (let column = 0; column < width; column += 1)
229
+ tuple[column] = source[offset + column];
230
+ tuple[WRUN_OPTION_PRINT_COLUMN.offset] = base + source[offset + WRUN_OPTION_PRINT_COLUMN.offset];
135
231
  out.push(tuple);
136
- }
232
+ });
137
233
  }
138
- return wrunOptionPrintsInTimeOrder(out);
234
+ return out.sort(compareWrunOptionPrintsInTimeOrder);
139
235
  }
140
236
  /** A live point's print and series (the feed's point: `{ series, optionPrint }`). */
141
237
  function livePrintOf(point) {
@@ -149,11 +245,6 @@ function livePrintOf(point) {
149
245
  ...(series !== null && typeof series === 'object' ? { series: series } : {}),
150
246
  };
151
247
  }
152
- /** Whether a tuple is a partial bar's marker (every value 0, `present` bit 14 alone), never a print. */
153
- function isPartialMarker(tuple) {
154
- const present = tuple[WRUN_OPTION_PRINT_COLUMN.present];
155
- return (wrunPresentIsPartial(present) && tuple.every((value, at) => at === WRUN_OPTION_PRINT_COLUMN.present || value === 0));
156
- }
157
248
  /**
158
249
  * One bar's print tuples merged with more (`incoming` win on a shared `print_key`), in time order. A partial bar
159
250
  * stays partial: when any tuple of either side says so, every print carries bit 14, and a bar left without a print
@@ -163,9 +254,10 @@ function mergeBarPrints(existing, incoming) {
163
254
  const tuples = [...existing.filter(isWrunOptionPrintTuple), ...incoming];
164
255
  const partial = tuples.some((tuple) => wrunPresentIsPartial(tuple[WRUN_OPTION_PRINT_COLUMN.present]));
165
256
  const byKey = new Map();
166
- for (const tuple of tuples)
167
- if (!isPartialMarker(tuple))
257
+ for (const tuple of tuples) {
258
+ if (!isWrunOptionPrintMarker(tuple))
168
259
  byKey.set(tuple[WRUN_OPTION_PRINT_COLUMN.key], tuple);
260
+ }
169
261
  const prints = wrunOptionPrintsInTimeOrder([...byKey.values()]);
170
262
  if (!partial)
171
263
  return prints;
@@ -175,7 +267,8 @@ function mergeBarPrints(existing, incoming) {
175
267
  }
176
268
  /** Live prints folded into the instance's host-bar rows: each kept print (the acquisition's chain, its exchange and
177
269
  * its ONE book, its floor and "0dte": a coin channel of another venue or book feeds nothing here) on the bar holding
178
- * it, once per `print_key`, every touched bar's prints in time order. */
270
+ * it, once per `print_key`, every touched bar's prints in time order; then the rows cut to the acquisition's newest cut
271
+ * over the window (`wrunNewestOptionPrintRows`), as its history was read under, so a live bar never outgrows it. */
179
272
  function foldLiveOptionPrints(rows, points, ctx) {
180
273
  const acquisition = wrunOptionPrintsAcquisitionOf(ctx.acquisition);
181
274
  const byBar = new Map(rows.map((row) => [Number(row[0]), [...row]]));
@@ -202,7 +295,8 @@ function foldLiveOptionPrints(rows, points, ctx) {
202
295
  const fresh = prints.filter((tuple) => !heldKeys.has(tuple[WRUN_OPTION_PRINT_COLUMN.key]));
203
296
  byBar.set(open, [open, ...mergeBarPrints(held, fresh)]);
204
297
  }
205
- return [...byBar.entries()].sort((a, b) => a[0] - b[0]).map(([, row]) => row);
298
+ const folded = [...byBar.entries()].sort((a, b) => a[0] - b[0]).map(([, row]) => row);
299
+ return acquisition === undefined ? folded : wrunNewestOptionPrintRows(folded, acquisition);
206
300
  }
207
301
  /** A reconcile answer over the rows held: the answer's prints, plus every held print of the bar its key does not
208
302
  * name (a print shown live keeps its place until history serves it), in time order. */
@@ -217,24 +311,60 @@ function reconcileOptionPrints(held, answer) {
217
311
  const kept = before
218
312
  .slice(1)
219
313
  .filter(isWrunOptionPrintTuple)
220
- .filter((tuple) => !isPartialMarker(tuple) && !keys.has(tuple[WRUN_OPTION_PRINT_COLUMN.key]));
314
+ .filter((tuple) => !isWrunOptionPrintMarker(tuple) && !keys.has(tuple[WRUN_OPTION_PRINT_COLUMN.key]));
221
315
  if (kept.length === 0)
222
316
  return [...row];
223
317
  return [row[0], ...mergeBarPrints(answered, kept)];
224
318
  });
225
319
  }
226
- /** One input's projection of a bar: its N nearest expiries, then its own bound under `overflow: "largest"`. */
227
- function projectOptionPrints(tuples, input) {
228
- const source = input.source;
320
+ /** One input's prints of a bar before any cut: its N nearest expiries, in time order. */
321
+ function inputOptionPrints(tuples, source) {
229
322
  const ordered = wrunOptionPrintsInTimeOrder(tuples);
230
323
  const expiries = wrunOptionExpiriesOf(source.expiries);
231
- const kept = expiries?.kind === 'nearest'
324
+ return expiries?.kind === 'nearest'
232
325
  ? wrunNearestExpiryTuples(ordered, expiries.count, WRUN_OPTION_PRINT_COLUMN.expiry)
233
326
  : ordered;
234
- if (source.overflow === 'largest' && input.maxCells !== undefined) {
235
- return wrunLargestPremiumPrints(kept, input.maxCells);
327
+ }
328
+ /** The window's newest N an input's bars are unioned with: its `newest` (1 and up) under `overflow: "largest"` with a
329
+ * bound of its own (`max_cells`), in a module whose buffer holds the union (`capacity` at least `max_cells` + N: the
330
+ * sheet's own, wrun-cell-capacity.leaf `wrunSheetCellBlockTuples`); undefined for any other input (its bars cut to
331
+ * their largest, or not at all), and for a sheet naming no such capacity (a module built before kit scaffold 97, or
332
+ * before 96 with a `max_cells` buffer), which keeps the cut before the union: each bar's `max_cells` largest. */
333
+ function unionNewestOf(input) {
334
+ const source = input.source;
335
+ const newest = source.newest;
336
+ return source.overflow === 'largest' &&
337
+ input.maxCells !== undefined &&
338
+ typeof newest === 'number' &&
339
+ Number.isInteger(newest) &&
340
+ newest >= 1 &&
341
+ input.capacity !== undefined &&
342
+ input.capacity >= input.maxCells + newest
343
+ ? newest
344
+ : undefined;
345
+ }
346
+ /** The window-level pass an input reads (`cellsWindow`), for an input reading the union alone: the bound of the
347
+ * window's newest cut over every bar the instance holds, each bar read as the input reads it (its nearest expiries),
348
+ * undefined for a window holding fewer than its `newest` prints (every print is newest). */
349
+ function optionPrintsWindow(input) {
350
+ const newest = unionNewestOf(input);
351
+ if (newest === undefined)
352
+ return undefined;
353
+ const source = input.source;
354
+ return (bars) => wrunNewestOptionPrintBound(bars.map((bar) => ({ openMs: bar.openMs, tuples: inputOptionPrints(bar.tuples, source) })), newest);
355
+ }
356
+ /** One input's projection of a bar: its N nearest expiries, then its own bound under `overflow: "largest"`: its
357
+ * largest alone, or beside `newest` its largest unioned with its prints inside the window's newest cut (`bar`, the
358
+ * window-level pass's bound; a caller that ran no pass reads the largest alone). */
359
+ function projectOptionPrints(tuples, input, bar) {
360
+ const source = input.source;
361
+ const kept = inputOptionPrints(tuples, source);
362
+ if (source.overflow !== 'largest' || input.maxCells === undefined)
363
+ return kept;
364
+ if (bar !== undefined && unionNewestOf(input) !== undefined) {
365
+ return wrunLargestOrNewestOptionPrints(kept, bar.openMs, input.maxCells, bar.window);
236
366
  }
237
- return kept;
367
+ return wrunLargestPremiumPrints(kept, input.maxCells);
238
368
  }
239
369
  export const rowLane = {
240
370
  sourceClass: 'option_prints',
@@ -254,6 +384,7 @@ export const rowLane = {
254
384
  horizon: wrunOptionPrintsHorizon,
255
385
  emptyAnswer: 'quiet',
256
386
  cells: projectOptionPrints,
387
+ cellsWindow: optionPrintsWindow,
257
388
  liveByCoin: {
258
389
  scriptSource: 'option_print',
259
390
  // The planes whose OPTION_PRINT producer streams live (a crypto chain's prints are derived each minute: history).
@@ -0,0 +1,4 @@
1
+ import type { WrunRowLaneDescriptor } from '../wrun-row-lane.types.js';
2
+ /** Test seam: forget every resolved chart. */
3
+ export declare function __resetWrunStrikeFlowChartsForTests(): void;
4
+ export declare const rowLane: WrunRowLaneDescriptor;
@@ -0,0 +1,65 @@
1
+ /**
2
+ * `option_strike_flow` (OPTLOAD G3, om kit 0.89.0): one underlying's option flow per strike, per expiry or per both, per
3
+ * chart bar or trade date, as 15-value tuples; a CHAIN lane on every chain, its chain the one chain resolver's as
4
+ * `option_contract_flow`'s (on the OPRA plane the plane's own by coin, G5 O1). The lane, its knobs, reads and fallback:
5
+ * docs/features/kscript/wrun/wrun-browser-runtime.md, `option_strike_flow`.
6
+ *
7
+ * LIGHT at module load (every row lane rides the boot path): the knobs' rules load with the class's read module inside
8
+ * `facets`, and the chain resolver's reads run inside `identity` and `facets`.
9
+ */
10
+ import { decideWrunLaneChain, resolveWrunLaneChainChart, WRUN_OPTION_CHART_UNRESOLVED_CODE, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
11
+ import { refuseWrunPollInput } from '../wrun-poll-lane.types.js';
12
+ import { WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD } from '../../wrun-option-contract-flow.util.js';
13
+ import { foldWrunOptionStrikeFlowBar, WRUN_OPTION_STRIKE_FLOW_CLASS, WRUN_OPTION_STRIKE_FLOW_TIERS, WRUN_OPTION_STRIKE_FLOW_WIDTH, wrunOptionStrikeFlowBarRows, wrunOptionStrikeFlowHorizon, } from '../../wrun-option-strike-flow-lane.util.js';
14
+ import { wrunOptionContractFlowAcquisitionMoved, wrunOptionContractFlowExtras } from './option_contract_flow.js';
15
+ import { wrunHeldOpraPlaneChain } from '../../wrun-option-views.util.js';
16
+ import { wrunAuthorRuleSeed } from '../../wrun-refusal.util.js';
17
+ /** What `identity` resolved for a chart, read back by `facets`, keyed by the chart market; the newest kept. */
18
+ const STRIKE_CHARTS_KEPT = 16;
19
+ const strikeCharts = new Map();
20
+ function rememberStrikeChart(key, chart) {
21
+ strikeCharts.delete(key);
22
+ strikeCharts.set(key, chart);
23
+ while (strikeCharts.size > STRIKE_CHARTS_KEPT)
24
+ strikeCharts.delete(strikeCharts.keys().next().value);
25
+ }
26
+ /** Test seam: forget every resolved chart. */
27
+ export function __resetWrunStrikeFlowChartsForTests() {
28
+ strikeCharts.clear();
29
+ }
30
+ /** One input's facets: its knobs (om's rules, refused by name), then its chain, named in `option_contract_flow`'s
31
+ * fields. */
32
+ async function strikeFlowFacets(source, ctx) {
33
+ const { wrunOptionStrikeFlowKnobsOf } = await import('../../wrun-option-strike-flow.util.js');
34
+ const knobs = wrunOptionStrikeFlowKnobsOf(source, ctx);
35
+ const chart = strikeCharts.get(wrunLaneChartKey(ctx));
36
+ if (chart === undefined) {
37
+ return refuseWrunPollInput(ctx, 'could not resolve the chart market for its options chain: Run again', wrunAuthorRuleSeed(WRUN_OPTION_CHART_UNRESOLVED_CODE));
38
+ }
39
+ const chain = await decideWrunLaneChain(chart, { venue: source.venue, book: source.book }, ctx);
40
+ return { ...wrunOptionContractFlowExtras(chain), ...knobs };
41
+ }
42
+ export const rowLane = {
43
+ sourceClass: WRUN_OPTION_STRIKE_FLOW_CLASS,
44
+ laneKey: WRUN_OPTION_STRIKE_FLOW_CLASS,
45
+ kType: WRUN_OPTION_STRIKE_FLOW_CLASS,
46
+ label: 'Option strike flow',
47
+ feedWords: 'wrun.refusal.feed.optionStrikeFlow',
48
+ width: WRUN_OPTION_STRIKE_FLOW_WIDTH,
49
+ chain: { exchangeField: WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD },
50
+ acquisitionMoved: wrunOptionContractFlowAcquisitionMoved,
51
+ identity: async (ctx) => {
52
+ const held = await wrunHeldOpraPlaneChain(ctx.exchange, ctx.coin, ctx.opraPlane);
53
+ rememberStrikeChart(wrunLaneChartKey(ctx), await resolveWrunLaneChainChart(ctx, held));
54
+ },
55
+ facets: strikeFlowFacets,
56
+ landing: {
57
+ kind: 'flow',
58
+ tiers: WRUN_OPTION_STRIKE_FLOW_TIERS.strike,
59
+ tierChoice: 'coarsest',
60
+ fold: (group) => foldWrunOptionStrikeFlowBar(group.rows),
61
+ },
62
+ horizon: wrunOptionStrikeFlowHorizon,
63
+ rowBudget: { cellsPerRow: WRUN_OPTION_STRIKE_FLOW_WIDTH, barRows: wrunOptionStrikeFlowBarRows },
64
+ emptyAnswer: 'quiet',
65
+ };
@@ -33,11 +33,28 @@
33
33
  * `expiries` ("all", or "nearest:N": the N earliest expiries each bar's snapshot lists, kept per input before the
34
34
  * packer judges `max_cells`, never a fetch facet). A market pin, `history` and `min_size` are refused by name; a
35
35
  * block over `max_cells` refuses the run (wrun_cell_block_too_large, never truncated). One chain per package.
36
+ * - `fold` "kit" (OPTLOAD G5, kit 0.90.0; wrun-option-views.util): `nearest`, `window_pct` (required), `lens`,
37
+ * `step_rows` (required), `carry` and `levels`, refused by the SDK's rules by name (`wrun_option_knob_invalid`); its
38
+ * `expiries` word is "all" or none (kit 0.91.1: the fold keeps its expiries with its own `nearest`, any other word
39
+ * refused at declaration). Each bar reads the fold of its newest
40
+ * minute, 14-value rows (`[1, totals..., max_pain, zero_gamma, call_wall, put_wall, spot, refused]` when `levels`,
41
+ * then `[0, strike, value]` at the strikes the template draws), asked of the gateway at the chart's bars
42
+ * (`strikeKitFold` and its params, `strikeMaxCells` the input's `max_cells`) and folded by the worker by the same
43
+ * rules while the gateway refuses the read. A bar whose newest minute held more rows than `max_cells` answers its
44
+ * levels row refused, and that refuses the run (wrun_cell_block_too_large), as a block over `max_cells` does today;
45
+ * an input declaring `missing: "empty"` reads that bar empty instead (C1.2b). The run carries the 14-value rows: the
46
+ * lane's plan, the packer and the shared aligner (kit 0.91.1) size the block by the input's width
47
+ * (`WRUN_OPTION_STRIKES_KIT_SERVED`).
48
+ * - O1 (OPTLOAD G5): on the OPRA plane the chain is the plane's own by coin (`wrunHeldOpraPlaneChain`), no chain
49
+ * directory read.
36
50
  *
37
51
  * LIGHT at module load: the chain resolver's directory, listing and lead reads run inside `identity` and `facets`.
38
52
  */
39
53
  import { type WrunLaneChain } from '../opra-option-lanes.util.js';
40
- import type { WrunRowLaneDescriptor, WrunRowLaneHorizon } from '../wrun-row-lane.types.js';
54
+ import { type WrunPollLaneExtras } from '../wrun-poll-lane.types.js';
55
+ import type { WrunRowLaneCellInput, WrunRowLaneContext, WrunRowLaneDescriptor, WrunRowLaneHorizon } from '../wrun-row-lane.types.js';
56
+ import type { WrunRowLanePlanFacts } from '../wrun-row-lanes.util.js';
57
+ import { type WrunOptionLaneAsk } from '../../wrun-option-views.util.js';
41
58
  /** f64s per tuple (om's `WRUN_OPTION_STRIKES_TUPLE_WIDTH`). */
42
59
  export declare const WRUN_OPTION_STRIKES_WIDTH = 12;
43
60
  /** The columns a tuple must hold a finite number in: the strike and the expiry. */
@@ -73,4 +90,41 @@ export declare function wrunOptionStrikesExtras(chain: WrunLaneChain): Record<st
73
90
  * continuous alias whose lead rolled since the run planned it (`wrunLaneChainLeadMoved`). A live session holding it
74
91
  * rebuilds, so no store or buffer joins the old contract's strikes to the new one's. */
75
92
  export declare function wrunOptionStrikesAcquisitionMoved(acquisition: Readonly<Record<string, unknown>>): boolean;
93
+ /** om's code for a block over its input's `max_cells` (wrun-pack.util `WRUN_CELL_BLOCK_TOO_LARGE_CODE`, named here so
94
+ * the lane module does not pull the packer onto the boot path). */
95
+ export declare const WRUN_OPTION_STRIKES_BLOCK_TOO_LARGE_CODE = "wrun_cell_block_too_large";
96
+ /** The kit's code for a view word a host does not serve (`wrun_option_views_unserved`, kit 0.90.0). */
97
+ export declare const WRUN_OPTION_VIEWS_UNSERVED_REFUSAL = "wrun_option_views_unserved";
98
+ /**
99
+ * Whether this host carries the strike kit fold's 14-value rows into a run. It does: every reader of the block sizes
100
+ * it by the input's own width (wrun-option-views.util `wrunOptionInputTupleWidth`, the SDK's one rule): the row lane's
101
+ * plan, the run's packer (wrun-pack.util `packWrunRows`) and, from kit 0.91.1, the shared host's aligner (kit
102
+ * `alignWrunRows`), which read the block in the class's 12-value tuples before. False refuses a kit fold input by name
103
+ * after its knobs pass, never read wrong.
104
+ */
105
+ export declare const WRUN_OPTION_STRIKES_KIT_SERVED = true;
106
+ /**
107
+ * Whether this host answers the strike kit fold's curve row (kit 0.96.0: `curve: true` beside `levels: true`, a row of
108
+ * the gamma curve's readings after each bar's levels row). Not yet: the gateway's `strikeKitCurve` read and the worker's
109
+ * fold of it are the Spot Exposures design's units (OPTLOAD W3, U2 and U4), and a fold without the row would read every
110
+ * curve reading NaN. So an input declaring `curve: true` is refused by name after its knobs pass, never drawn without
111
+ * its curve; U4 sets this true with the fold that answers the row.
112
+ */
113
+ export declare const WRUN_OPTION_STRIKES_KIT_CURVE_SERVED = false;
114
+ /**
115
+ * The acquisition fields of an input's strike kit fold (OPTLOAD G5): the fold, its params and the input's `max_cells`,
116
+ * so the gateway (or the worker's fold while the gateway refuses it) answers a refused levels row for a bar whose newest
117
+ * minute held more rows. The fold reads every expiry of the minute (its `nearest` keeps the soonest): an `expiries`
118
+ * word other than "all" beside it was refused at declaration (`wrunOptionLaneAskOfSource`, the SDK's words).
119
+ */
120
+ export declare function wrunOptionStrikesKitExtras(ask: WrunOptionLaneAsk, ctx: WrunRowLaneContext & WrunRowLanePlanFacts): WrunPollLaneExtras;
121
+ /** Whether a kit fold bar's rows carry the refusal: its levels row with `refused` 1 (the bar's newest minute held more
122
+ * rows than the input's `max_cells`). */
123
+ export declare function wrunOptionStrikesKitRefused(tuples: ReadonlyArray<ReadonlyArray<number>>): boolean;
124
+ /**
125
+ * One input's block on one bar: under fold "kit" the bar's kit rows as they are, a refused levels row refusing the run
126
+ * (`wrun_cell_block_too_large`, the block never truncated) or, for an input declaring `missing: "empty"`, reading that
127
+ * bar as a present empty block (C1.2b); else the tuples its `expiries` word keeps (`wrunOptionStrikesKept`).
128
+ */
129
+ export declare function wrunOptionStrikesCells(tuples: ReadonlyArray<ReadonlyArray<number>>, input: WrunRowLaneCellInput): ReadonlyArray<ReadonlyArray<number>>;
76
130
  export declare const rowLane: WrunRowLaneDescriptor;
@@ -33,11 +33,26 @@
33
33
  * `expiries` ("all", or "nearest:N": the N earliest expiries each bar's snapshot lists, kept per input before the
34
34
  * packer judges `max_cells`, never a fetch facet). A market pin, `history` and `min_size` are refused by name; a
35
35
  * block over `max_cells` refuses the run (wrun_cell_block_too_large, never truncated). One chain per package.
36
+ * - `fold` "kit" (OPTLOAD G5, kit 0.90.0; wrun-option-views.util): `nearest`, `window_pct` (required), `lens`,
37
+ * `step_rows` (required), `carry` and `levels`, refused by the SDK's rules by name (`wrun_option_knob_invalid`); its
38
+ * `expiries` word is "all" or none (kit 0.91.1: the fold keeps its expiries with its own `nearest`, any other word
39
+ * refused at declaration). Each bar reads the fold of its newest
40
+ * minute, 14-value rows (`[1, totals..., max_pain, zero_gamma, call_wall, put_wall, spot, refused]` when `levels`,
41
+ * then `[0, strike, value]` at the strikes the template draws), asked of the gateway at the chart's bars
42
+ * (`strikeKitFold` and its params, `strikeMaxCells` the input's `max_cells`) and folded by the worker by the same
43
+ * rules while the gateway refuses the read. A bar whose newest minute held more rows than `max_cells` answers its
44
+ * levels row refused, and that refuses the run (wrun_cell_block_too_large), as a block over `max_cells` does today;
45
+ * an input declaring `missing: "empty"` reads that bar empty instead (C1.2b). The run carries the 14-value rows: the
46
+ * lane's plan, the packer and the shared aligner (kit 0.91.1) size the block by the input's width
47
+ * (`WRUN_OPTION_STRIKES_KIT_SERVED`).
48
+ * - O1 (OPTLOAD G5): on the OPRA plane the chain is the plane's own by coin (`wrunHeldOpraPlaneChain`), no chain
49
+ * directory read.
36
50
  *
37
51
  * LIGHT at module load: the chain resolver's directory, listing and lead reads run inside `identity` and `facets`.
38
52
  */
39
53
  import { decideWrunLaneChain, decideWrunLaneChainIdentity, refuseWrunLaneStrayKnob, resolveWrunLaneChainChart, WRUN_OPTION_CHART_UNRESOLVED_CODE, wrunLaneChainLeadMoved, wrunLaneChainRefusalError, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
40
54
  import { refuseWrunPollInput } from '../wrun-poll-lane.types.js';
55
+ import { WRUN_OPTION_STRIKES_KIT_LAYOUTS, WRUN_OPTION_STRIKES_KIT_REFUSED_COLUMN, wrunHeldOpraPlaneChain, wrunOptionLaneAskFields, wrunOptionLaneAskOfSource, } from '../../wrun-option-views.util.js';
41
56
  import { WRUN_OPTIONS_CHAIN_EXPIRIES_CODE, wrunOptionsChainExpiries, wrunOptionsChainIdentityKey, } from '../../wrun-options-chain.util.js';
42
57
  import { attachWrunRefusal, wrunAuthorRuleSeed } from '../../wrun-refusal.util.js';
43
58
  /** f64s per tuple (om's `WRUN_OPTION_STRIKES_TUPLE_WIDTH`). */
@@ -107,6 +122,58 @@ export function wrunOptionStrikesExtras(chain) {
107
122
  export function wrunOptionStrikesAcquisitionMoved(acquisition) {
108
123
  return wrunLaneChainLeadMoved(acquisition[WRUN_OPTION_STRIKES_EXCHANGE_FIELD], acquisition.strikeContinuous, acquisition.strikeUnderlying);
109
124
  }
125
+ /** om's code for a block over its input's `max_cells` (wrun-pack.util `WRUN_CELL_BLOCK_TOO_LARGE_CODE`, named here so
126
+ * the lane module does not pull the packer onto the boot path). */
127
+ export const WRUN_OPTION_STRIKES_BLOCK_TOO_LARGE_CODE = 'wrun_cell_block_too_large';
128
+ /** The kit's code for a view word a host does not serve (`wrun_option_views_unserved`, kit 0.90.0). */
129
+ export const WRUN_OPTION_VIEWS_UNSERVED_REFUSAL = 'wrun_option_views_unserved';
130
+ /**
131
+ * Whether this host carries the strike kit fold's 14-value rows into a run. It does: every reader of the block sizes
132
+ * it by the input's own width (wrun-option-views.util `wrunOptionInputTupleWidth`, the SDK's one rule): the row lane's
133
+ * plan, the run's packer (wrun-pack.util `packWrunRows`) and, from kit 0.91.1, the shared host's aligner (kit
134
+ * `alignWrunRows`), which read the block in the class's 12-value tuples before. False refuses a kit fold input by name
135
+ * after its knobs pass, never read wrong.
136
+ */
137
+ export const WRUN_OPTION_STRIKES_KIT_SERVED = true;
138
+ /**
139
+ * Whether this host answers the strike kit fold's curve row (kit 0.96.0: `curve: true` beside `levels: true`, a row of
140
+ * the gamma curve's readings after each bar's levels row). Not yet: the gateway's `strikeKitCurve` read and the worker's
141
+ * fold of it are the Spot Exposures design's units (OPTLOAD W3, U2 and U4), and a fold without the row would read every
142
+ * curve reading NaN. So an input declaring `curve: true` is refused by name after its knobs pass, never drawn without
143
+ * its curve; U4 sets this true with the fold that answers the row.
144
+ */
145
+ export const WRUN_OPTION_STRIKES_KIT_CURVE_SERVED = false;
146
+ /**
147
+ * The acquisition fields of an input's strike kit fold (OPTLOAD G5): the fold, its params and the input's `max_cells`,
148
+ * so the gateway (or the worker's fold while the gateway refuses it) answers a refused levels row for a bar whose newest
149
+ * minute held more rows. The fold reads every expiry of the minute (its `nearest` keeps the soonest): an `expiries`
150
+ * word other than "all" beside it was refused at declaration (`wrunOptionLaneAskOfSource`, the SDK's words).
151
+ */
152
+ export function wrunOptionStrikesKitExtras(ask, ctx) {
153
+ return wrunOptionLaneAskFields(ask, { maxCells: ctx.maxCells });
154
+ }
155
+ /** Whether a kit fold bar's rows carry the refusal: its levels row with `refused` 1 (the bar's newest minute held more
156
+ * rows than the input's `max_cells`). */
157
+ export function wrunOptionStrikesKitRefused(tuples) {
158
+ return tuples.some((tuple) => tuple[0] === WRUN_OPTION_STRIKES_KIT_LAYOUTS.levels && tuple[WRUN_OPTION_STRIKES_KIT_REFUSED_COLUMN] === 1);
159
+ }
160
+ /**
161
+ * One input's block on one bar: under fold "kit" the bar's kit rows as they are, a refused levels row refusing the run
162
+ * (`wrun_cell_block_too_large`, the block never truncated) or, for an input declaring `missing: "empty"`, reading that
163
+ * bar as a present empty block (C1.2b); else the tuples its `expiries` word keeps (`wrunOptionStrikesKept`).
164
+ */
165
+ export function wrunOptionStrikesCells(tuples, input) {
166
+ const source = input.source;
167
+ if (source.fold !== 'kit')
168
+ return wrunOptionStrikesKept(tuples, source.expiries);
169
+ if (!wrunOptionStrikesKitRefused(tuples))
170
+ return tuples;
171
+ if (input.source.missing === 'empty')
172
+ return [];
173
+ throw new Error(`${WRUN_OPTION_STRIKES_BLOCK_TOO_LARGE_CODE}: input '${input.name}' (option_strikes, fold "kit") read a bar whose ` +
174
+ `newest minute held more strike rows than its max_cells (${input.maxCells ?? 'unset'}), so the evaluation is ` +
175
+ 'refused (a block is never truncated)');
176
+ }
110
177
  export const rowLane = {
111
178
  sourceClass: 'option_strikes',
112
179
  laneKey: 'option_strikes',
@@ -123,7 +190,9 @@ export const rowLane = {
123
190
  horizon: wrunOptionStrikesHorizon,
124
191
  acquisitionMoved: wrunOptionStrikesAcquisitionMoved,
125
192
  identity: async (ctx) => {
126
- rememberStrikesChart(wrunLaneChartKey(ctx), await resolveWrunLaneChainChart(ctx));
193
+ // O1: on the OPRA plane the chain is the plane's own by coin, no chain directory read.
194
+ const held = await wrunHeldOpraPlaneChain(ctx.exchange, ctx.coin, ctx.opraPlane);
195
+ rememberStrikesChart(wrunLaneChartKey(ctx), await resolveWrunLaneChainChart(ctx, held));
127
196
  },
128
197
  facets: async (source, ctx) => {
129
198
  for (const knob of ['history', 'min_size']) {
@@ -149,6 +218,17 @@ export const rowLane = {
149
218
  }
150
219
  if (!decision.ok)
151
220
  throw wrunLaneChainRefusalError(decision, 'option_strikes');
221
+ // The kit fold and its params, by the SDK's rules (`wrun_option_knob_invalid`), then this host's guard.
222
+ const kit = wrunOptionLaneAskOfSource(source, ctx);
223
+ const kitExtras = kit === undefined ? undefined : wrunOptionStrikesKitExtras(kit, ctx);
224
+ if (kitExtras !== undefined && !WRUN_OPTION_STRIKES_KIT_SERVED) {
225
+ return refuseWrunPollInput(ctx, `reads option_strikes with fold "kit" (${WRUN_OPTION_VIEWS_UNSERVED_REFUSAL}): this app does not carry the ` +
226
+ "kit fold's rows into a run yet; read the strike rows whole (drop fold and its params)", wrunAuthorRuleSeed(WRUN_OPTION_VIEWS_UNSERVED_REFUSAL));
227
+ }
228
+ if (kit?.params.curve === 1 && !WRUN_OPTION_STRIKES_KIT_CURVE_SERVED) {
229
+ return refuseWrunPollInput(ctx, `reads option_strikes with fold "kit" and curve (${WRUN_OPTION_VIEWS_UNSERVED_REFUSAL}): this app does not ` +
230
+ "answer the kit fold's curve row yet; drop curve and read the gamma curve from the strike rows", wrunAuthorRuleSeed(WRUN_OPTION_VIEWS_UNSERVED_REFUSAL));
231
+ }
152
232
  const chain = await decideWrunLaneChain(chart, { venue: source.venue, book: source.book }, ctx);
153
233
  return {
154
234
  // The chain's identity as the options chain keys it (one chain per package: `acquisitions: 'one'`).
@@ -156,7 +236,8 @@ export const rowLane = {
156
236
  ...wrunOptionStrikesExtras(chain),
157
237
  // The run's bar span: the worker keeps the newest minute of each of these bars.
158
238
  hostIntervalMs: ctx.intervalMs,
239
+ ...kitExtras,
159
240
  };
160
241
  },
161
- cells: (tuples, input) => wrunOptionStrikesKept(tuples, input.source.expiries),
242
+ cells: wrunOptionStrikesCells,
162
243
  };
@@ -27,11 +27,24 @@
27
27
  * decided when the run plans and named in the acquisition, `auto` the chain's default book over the series its
28
28
  * directory lists, opra-option-lanes.util `resolveWrunLaneChainAutoBook`; an answer never picks it) and `max_cells`
29
29
  * (a block over it refuses the run); a market pin and the other options classes' knobs refuse by name.
30
+ * - `pick` (OPTLOAD G5, kit 0.90.0; wrun-option-views.util): "nearest_days" (`days`, `delta`) or "tenor_bracket"
31
+ * (`tenor`), each param a number (a setting's value once the paint seam wrote it), refused by the SDK's rules by
32
+ * name (`wrun_option_knob_invalid`). Each bar's block is the pick of its landed bucket (`wrunOptionSurfacePickTuples`,
33
+ * the SDK's reference), so the template reads the one or two tuples it reads today. The pick's fields ride the
34
+ * acquisition (`surfacePick` and its params, with the run's bar span), so the worker asks OPTION_SURFACE grouped to
35
+ * the chart's bars with the pick applied there (`optionRead`: the gateway lands each bar on its newest sealed 5m
36
+ * bucket, as this lane lands it), or, where the chart's bars are no grouping the gateway draws (an RTH CME chart's
37
+ * 13:30Z hours, a daily bar), in the widest UTC groups that nest inside them (OPTLOAD W3 SURF-NEST: a few rows a bar,
38
+ * each its group's newest sealed bucket picked; this lane lands each bar on its newest row), and reads today's
39
+ * buckets while the gateway refuses the read; the pick applied on the page to a bar the gateway picked picks the
40
+ * same tuples. An input without `pick` asks and lands as before.
41
+ * - O1 (OPTLOAD G5): on the OPRA plane the chain is the plane's own by coin (`wrunHeldOpraPlaneChain`), no chain
42
+ * directory read.
30
43
  *
31
44
  * LIGHT at module load: pb-common and the chain resolver are imported inside `identity`.
32
45
  */
33
46
  import { type WrunLaneChain } from '../opra-option-lanes.util.js';
34
- import type { WrunRowLaneDescriptor } from '../wrun-row-lane.types.js';
47
+ import type { WrunRowLaneCellInput, WrunRowLaneDescriptor } from '../wrun-row-lane.types.js';
35
48
  import type { WrunBackendTier } from '../../wrun-tier-grid.util.js';
36
49
  /** f64s per tuple (the source contract's width, the `present` mask included). */
37
50
  export declare const WRUN_OPTION_SURFACE_WIDTH = 9;
@@ -67,4 +80,7 @@ export declare function wrunOptionSurfaceAcquisitionMoved(acquisition: Readonly<
67
80
  * bar reads its settlement instead of nothing. An OPRA or crypto chain keeps the tier rule as it is.
68
81
  */
69
82
  export declare function wrunOptionSurfaceReadsSettlements(acquisition: Readonly<Record<string, unknown>>): boolean;
83
+ /** One input's block on one bar: the pick of the bar's tuples when the input declares `pick` (the SDK's reference,
84
+ * idempotent on a bar the gateway picked), else the tuples as they are. */
85
+ export declare function wrunOptionSurfaceCells(tuples: ReadonlyArray<ReadonlyArray<number>>, input: Pick<WrunRowLaneCellInput, 'source'>): ReadonlyArray<ReadonlyArray<number>>;
70
86
  export declare const rowLane: WrunRowLaneDescriptor;