@orangecharts/wrun-chart-host 0.9.0 → 0.10.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 (170) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +6 -1
  3. package/dist/constants/feature-flags.constants.js +67 -24
  4. package/dist/constants/opra-compliance.constants.d.ts +3 -2
  5. package/dist/constants/opra-compliance.constants.js +3 -2
  6. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  7. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  8. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  9. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  10. package/dist/constants/venue-presets.constants.d.ts +20 -20
  11. package/dist/constants/venue-presets.constants.js +24 -26
  12. package/dist/host-env.d.ts +29 -5
  13. package/dist/host-env.js +6 -0
  14. package/dist/host-ports.types.d.ts +69 -15
  15. package/dist/index.d.ts +13 -0
  16. package/dist/index.js +13 -0
  17. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  18. package/dist/interfaces/replay.interface.d.ts +8 -0
  19. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  20. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +41 -4
  21. package/dist/kscript-data/controls/live-trades-merge.util.js +52 -7
  22. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +56 -0
  23. package/dist/kscript-data/controls/live-trades-order-gate.util.js +107 -0
  24. package/dist/market-data/billing.interface.d.ts +95 -31
  25. package/dist/market-data/billing.interface.js +36 -5
  26. package/dist/market-data/venue.d.ts +88 -6
  27. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  28. package/dist/market-data/venues/cme.d.ts +126 -0
  29. package/dist/market-data/venues/cme.js +133 -0
  30. package/dist/market-data/venues/index.d.ts +162 -5
  31. package/dist/market-data/venues/index.js +48 -6
  32. package/dist/settings-templates/index.js +7 -3
  33. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  34. package/dist/settings-templates/indicator-fields.js +45 -6
  35. package/dist/settings-templates/tool-rules.d.ts +27 -17
  36. package/dist/settings-templates/tool-rules.js +27 -11
  37. package/dist/settings-templates/tool-tables.generated.js +91 -31
  38. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  39. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  40. package/dist/utility/chart/index-mode-admission.util.js +15 -2
  41. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  42. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  43. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +7 -2
  44. package/dist/utility/chart/kscript-live-coalesce.util.js +9 -3
  45. package/dist/utility/chart/kscript-provenance-keys.util.js +6 -0
  46. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  47. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  48. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  49. package/dist/utility/chart/kscript-venue-policy.util.d.ts +54 -35
  50. package/dist/utility/chart/kscript-venue-policy.util.js +78 -42
  51. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  52. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  53. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  54. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  55. package/dist/utility/chart/rth-session.util.d.ts +3 -2
  56. package/dist/utility/chart/rth-session.util.js +2 -1
  57. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  58. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  59. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  60. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  61. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  62. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  63. package/dist/utility/options/option-venue.util.d.ts +18 -0
  64. package/dist/utility/options/option-venue.util.js +27 -0
  65. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  66. package/dist/utility/wrun/derived-roots.util.d.ts +213 -0
  67. package/dist/utility/wrun/derived-roots.util.js +471 -0
  68. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +41 -6
  69. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  70. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  71. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  72. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  73. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  74. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  75. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  76. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  77. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  78. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  79. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  80. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  81. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  82. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  83. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  84. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  85. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  86. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  87. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  88. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +39 -10
  89. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +64 -0
  90. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +89 -0
  91. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  92. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  93. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  94. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +174 -13
  95. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +685 -27
  96. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  97. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  98. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +53 -12
  99. package/dist/utility/wrun/wrun-chart-market-facts.util.js +101 -53
  100. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  101. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  102. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  103. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  104. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  105. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  106. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  107. package/dist/utility/wrun/wrun-frames.js +73 -10
  108. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  109. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  110. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  111. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  112. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  113. package/dist/utility/wrun/wrun-live-intake.util.d.ts +13 -7
  114. package/dist/utility/wrun/wrun-live-intake.util.js +82 -29
  115. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -0
  116. package/dist/utility/wrun/wrun-live-tick.util.js +158 -14
  117. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +49 -10
  118. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +65 -5
  119. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  120. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  121. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  122. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  123. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  124. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  125. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  126. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  127. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  128. package/dist/utility/wrun/wrun-option-views.util.d.ts +47 -13
  129. package/dist/utility/wrun/wrun-option-views.util.js +98 -26
  130. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  131. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  132. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +17 -0
  133. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  134. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  135. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +100 -31
  136. package/dist/utility/wrun/wrun-overlay-run.util.js +733 -114
  137. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  138. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  139. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  140. package/dist/utility/wrun/wrun-panel-mount.util.js +63 -13
  141. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  142. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  143. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  144. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  145. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  146. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  147. package/dist/utility/wrun/wrun-pin-spelling.util.js +12 -11
  148. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  149. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  150. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  151. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  152. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  153. package/dist/utility/wrun/wrun-run-interval.util.d.ts +4 -2
  154. package/dist/utility/wrun/wrun-run-interval.util.js +9 -6
  155. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  156. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  157. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  158. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  159. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  160. package/dist/utility/wrun/wrun-socket-row-source.js +113 -8
  161. package/dist/utility/wrun/wrun-source-rows.util.d.ts +5 -1
  162. package/dist/utility/wrun/wrun-source-rows.util.js +16 -3
  163. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  164. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  165. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  166. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  167. package/dist/utility/wrun/wrun-tape-per-order.util.js +26 -0
  168. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  169. package/dist/utils/replay/replay-buffer-math.js +227 -20
  170. package/package.json +11 -11
@@ -18,11 +18,14 @@
18
18
  * - GROUPED (the data plane computes): OPTION_PRINT_AGG's STRIKE, EXPIRY or EXPIRY_STRIKE scope rows, grouped to the
19
19
  * chart's bar (`barSeconds` and `barAnchor`) or trade date (`span`) by the gateway, every knob applied there
20
20
  * (`optionRead`, `wrunOptionStrikeFlowOptionRead`), one row per group key per bar (`wrunOptionStrikeFlowTupleOf`);
21
+ * the anchors are the gateway's own (the one mirror, option-bar-anchor.util: UTC, US_EQUITY_RTH, a CME chart's
22
+ * regular session on CME_RTH or CME_ENERGY_RTH, its Globex trade date on CME_SESSION), offered where they land
23
+ * (`wrunOptionFlowGrouping`, at a tier the anchor takes: `wrunOptionFlowGroupedRead`);
21
24
  * - FOLDED (today's ask): the chain's CONTRACT rows at a contract tier, summed per group key and cut by the same rules
22
25
  * in the browser (`foldWrunOptionStrikeFlowGroup`, section 6.4 step by step), when the gateway refuses `optionRead` by
23
26
  * name (a deployment without the read: the session's fallback for the plane), when the chart's bars are no grouping
24
- * the gateway can draw (a CME session bar, a week), or when the chain's book is one of several of its coin (a crypto
25
- * venue: the gateway groups by coin, every book together).
27
+ * the gateway can draw (a Globex lattice bar off the UTC floor, a week), or when the chain's book is one of several of
28
+ * its coin (a crypto venue: the gateway groups by coin, every book together).
26
29
  * The worker twin answers one row per group stamp, `[stampMs, block]`, the block one Float64Array of the stamp's tuples
27
30
  * back to back (`packWrunOptionStrikeFlowTuples`), handed over by transfer; the lane's fold reads them in place
28
31
  * (`foldWrunOptionStrikeFlowBar`, the identity of a grouped bar).
@@ -33,11 +36,12 @@
33
36
  */
34
37
  import { KSCRIPT_SOURCE_CELL_BYTES, kScriptSourceAnswerRows } from '../chart/kscript-source-answer-budget.leaf.js';
35
38
  import { liveBucketStartsInRange } from '../chart/live-bucket.util.js';
36
- import { isEquityRegularSessionGated, usEquityAnchoredBucketStartMs } from '../chart/us-equities-session.util.js';
39
+ import { isEquityRegularSessionGated } from '../chart/us-equities-session.util.js';
40
+ import { OPTION_BAR_ANCHOR, OPTION_BAR_ANCHOR_RULES, optionBarAnchorRuleOf, optionBarAnchorsTaken, optionChartClosedAt, optionGridCeilBoundaryMs, optionGridFloorBoundaryMs, optionSessionAnchorOf, } from '../options/option-bar-anchor.util.js';
37
41
  import { optionExpiresOnTradeDay, optionTradeDateClockOf, optionTradeDayByClock, optionTradeDayStartMsByClock, } from '../options/option-trade-date.util.js';
38
42
  import { wrunPartialMarkerTuple } from './wrun-present-bits.util.js';
39
43
  import { WRUN_OPTION_CONTRACT_FLOW_BOOK_FIELD, WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD, WRUN_OPTION_CONTRACT_FLOW_RAW, WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH, WRUN_OPTION_PRINT_AGG_TIERS, wrunOptionContractFlowBarRows, wrunOptionFlowTodayFromOf, } from './wrun-option-contract-flow.util.js';
40
- import { compareWrunOptionStrikeFlowTuples, WRUN_OPTION_FLOW_HISTORY, WRUN_OPTION_FLOW_SPANS, WRUN_OPTION_STRIKE_FLOW_COLUMN, WRUN_OPTION_STRIKE_FLOW_GROUPS, WRUN_OPTION_STRIKE_FLOW_TIERS, WRUN_OPTION_STRIKE_FLOW_WIDTH, wrunOptionStrikeFlowExpiriesOf, wrunOptionStrikeFlowPayloadKnobsOf, } from './wrun-option-strike-flow-lane.util.js';
44
+ import { compareWrunOptionStrikeFlowTuples, WRUN_OPTION_FLOW_HISTORY, WRUN_OPTION_FLOW_SPANS, WRUN_OPTION_STRIKE_FLOW_COLUMN, WRUN_OPTION_STRIKE_FLOW_FOLD_BUDGET_FIELD, WRUN_OPTION_STRIKE_FLOW_GROUPS, WRUN_OPTION_STRIKE_FLOW_TIERS, WRUN_OPTION_STRIKE_FLOW_WIDTH, wrunOptionStrikeFlowExpiriesOf, wrunOptionStrikeFlowPayloadKnobsOf, } from './wrun-option-strike-flow-lane.util.js';
41
45
  import { refuseWrunOptionKnob, WRUN_OPTION_STRIKE_WINDOW_MAX_PCT } from './wrun-option-knobs.util.js';
42
46
  import { wrunOptionChainAskStampHolds } from './wrun-option-prints.util.js';
43
47
  import { wrunBarTiers, wrunHostBarOf, wrunHostBarSpanOf, wrunTierSegments, } from './wrun-tier-grid.util.js';
@@ -67,17 +71,21 @@ export const WRUN_OPTION_STRIKE_FLOW_COLUMNS = Object.freeze([
67
71
  export const WRUN_OPTION_STRIKE_FLOW_DTE_CLASS = Object.freeze({ whole: 0, zero: 1, later: 2 });
68
72
  /** `strike_rows`: 1 to 200 (om `WRUN_OPTION_STRIKE_ROWS_MAX`). */
69
73
  export const WRUN_OPTION_STRIKE_ROWS_MAX = 200;
70
- /** The scope word of each group (pb-common `OptionPrintAggScope` STRIKE 5, EXPIRY 6, EXPIRY_STRIKE 7). */
74
+ /** The scope word of each group (pb-common `OptionPrintAggScope` STRIKE 5, EXPIRY 6, EXPIRY_STRIKE 7) and the read its
75
+ * grouped ask is, as the gateway registers the anchors it takes (option-bar-anchor.util). */
71
76
  export const WRUN_OPTION_STRIKE_FLOW_SCOPE = Object.freeze({
72
- strike: { word: 'STRIKE', id: 5 },
73
- expiry: { word: 'EXPIRY', id: 6 },
74
- expiry_strike: { word: 'EXPIRY_STRIKE', id: 7 },
77
+ strike: { word: 'STRIKE', id: 5, read: 'OPTION_PRINT_AGG/STRIKE' },
78
+ expiry: { word: 'EXPIRY', id: 6, read: 'OPTION_PRINT_AGG/EXPIRY' },
79
+ expiry_strike: { word: 'EXPIRY_STRIKE', id: 7, read: 'OPTION_PRINT_AGG/EXPIRY_STRIKE' },
75
80
  });
76
- /** pb-common enums the request names by number (the gateway decodes JSON with encoding/json): `BarAnchor`, `BarSpan`,
77
- * `OptionExpiryClass`, `OptionDteBucket`, `OptionType`. */
81
+ /** pb-common enums the request names by number (the gateway decodes JSON with encoding/json): `BarAnchor` (the anchor
82
+ * mirror's values, option-bar-anchor.util), `BarSpan`, `OptionExpiryClass`, `OptionDteBucket`, `OptionType`. */
78
83
  export const WRUN_OPTION_READ_ENUM = Object.freeze({
79
- anchorUtc: 0,
80
- anchorUsEquityRth: 1,
84
+ anchorUtc: OPTION_BAR_ANCHOR.UTC,
85
+ anchorUsEquityRth: OPTION_BAR_ANCHOR.US_EQUITY_RTH,
86
+ anchorCmeSession: OPTION_BAR_ANCHOR.CME_SESSION,
87
+ anchorCmeRth: OPTION_BAR_ANCHOR.CME_RTH,
88
+ anchorCmeEnergyRth: OPTION_BAR_ANCHOR.CME_ENERGY_RTH,
81
89
  spanSession: 1,
82
90
  expiryZeroDte: 1,
83
91
  expiryAfterToday: 2,
@@ -205,6 +213,7 @@ export function wrunOptionStrikeFlowAcquisitionOf(payload) {
205
213
  const book = upperOf(payload?.[WRUN_OPTION_CONTRACT_FLOW_BOOK_FIELD]);
206
214
  const knobs = wrunOptionStrikeFlowPayloadKnobsOf(payload);
207
215
  const todayFromMs = wrunOptionFlowTodayFromOf(payload);
216
+ const foldBudget = payload?.[WRUN_OPTION_STRIKE_FLOW_FOLD_BUDGET_FIELD];
208
217
  return {
209
218
  coin,
210
219
  exchange: upperOf(payload?.[WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD]),
@@ -213,6 +222,9 @@ export function wrunOptionStrikeFlowAcquisitionOf(payload) {
213
222
  ...(typeof payload?.tier === 'string' ? { tier: payload.tier } : {}),
214
223
  ...wrunOptionFlowBarsOf(payload),
215
224
  ...(knobs.history === 'today' && todayFromMs !== undefined ? { todayFromMs } : {}),
225
+ ...(typeof foldBudget === 'number' && Number.isInteger(foldBudget) && foldBudget >= 1
226
+ ? { foldBudgetRows: foldBudget }
227
+ : {}),
216
228
  };
217
229
  }
218
230
  /** Whether a payload is an `option_strike_flow` lane ask the K control serves: a coin, a group, one of the class's tiers
@@ -231,33 +243,33 @@ export function wrunOptionFlowClockOf(acquisition) {
231
243
  }
232
244
  /** The most tier buckets a grouping is proved over bucket by bucket (beyond it the fold reads the chart's bars). */
233
245
  const GROUPING_PROOF_MAX_BUCKETS = 60_000;
234
- /** The clock's session the gateway draws (contract 3.4): RTH on the New York date, UTC on the UTC date; none else. */
235
- function sessionAnchorOf(clock) {
236
- if (clock.rule.offsetHours !== 0 || clock.rule.weekendsToMonday === true)
237
- return undefined;
238
- if (clock.zone === 'America/New_York')
239
- return WRUN_OPTION_READ_ENUM.anchorUsEquityRth;
240
- if (clock.zone === 'UTC')
241
- return WRUN_OPTION_READ_ENUM.anchorUtc;
242
- return undefined;
243
- }
246
+ /** The read a grouping is for when its caller names none: the strike scopes' (every anchor is theirs to take). */
247
+ const STRIKE_READ = 'OPTION_PRINT_AGG/STRIKE';
248
+ const everyDrop = () => true;
249
+ const noDrop = () => false;
244
250
  /**
245
- * The grouping of one ask's window `[fromMs, toMs)` at a tier: a session span groups by trade date (the gateway's
246
- * session where the clock has one), else a chart bar of a day reads its trade date's session where that session lands
247
- * on it (a daily bar holding one New York regular session, the cash session's buckets alone, or one UTC date), else the
248
- * chart's bars when the gateway's bars are exactly them (every tier bucket of the window lands on the host bar the
249
- * gateway's bar opens on: the UTC floor, or the 09:30 New York lattice of a regular-session stock chart's 45m to 12h
250
- * bars, the tier dividing 30 minutes, a bucket outside the cash session reaching no bar on either side), else the
251
- * chart's own bars, folded in the browser.
251
+ * The grouping of one ask's window `[fromMs, toMs)` at a tier, from the anchors `read` takes on the read's venue
252
+ * (`exchange`, the chain's; a decider naming none is offered no CME anchor, as the gateway lays those over the CME
253
+ * group's rows alone): a session span groups by trade date (the anchor whose sessions are the clock's trade dates, from
254
+ * a tier its sessions fit), else a chart bar of a day reads its trade date's session where that session lands on it (a
255
+ * daily bar holding one New York regular session, the cash session's buckets alone, one UTC date, or one Globex trade
256
+ * date), else the chart's bars when the gateway's bars are exactly them (every tier bucket of the window lands on the
257
+ * host bar the gateway's bar opens on: the UTC floor; the 09:30 New York lattice of a regular-session stock chart's 45m
258
+ * to 12h bars, the tier dividing 30 minutes, a bucket outside the cash session reaching no bar on either side; a CME
259
+ * regular session's lattice on a regular-hours CME chart, the tier dividing that anchor's (15 minutes on CME_RTH, 30 on
260
+ * CME_ENERGY_RTH), the window on its boundaries, a bucket the anchor drops reaching no bar or falling where the chart's
261
+ * product holds no trading, option-bar-anchor.util `optionChartClosedAt`: a weekday product's weekend, never an
262
+ * always-on root's), else the chart's own bars, folded in the browser.
252
263
  */
253
264
  export function wrunOptionFlowGrouping(args) {
254
- const { barMs, barGrid, tierMs, fromMs, toMs, clock } = args;
255
- const sessionAnchor = sessionAnchorOf(clock);
256
- const sessionServed = sessionAnchor !== undefined &&
257
- tierMs > 0 &&
258
- (sessionAnchor === WRUN_OPTION_READ_ENUM.anchorUtc ? DAY_MS % tierMs === 0 : HALF_HOUR_MS % tierMs === 0);
265
+ const { barMs, barGrid, tierMs, fromMs, toMs, clock, exchange } = args;
266
+ const read = args.read ?? STRIKE_READ;
267
+ const sessionRule = optionSessionAnchorOf(clock, read, exchange);
268
+ const sessionServed = sessionRule?.fitsTier(tierMs, 0, true) === true ? sessionRule : undefined;
259
269
  if (args.session) {
260
- return sessionServed ? { kind: 'session', barAnchor: sessionAnchor } : { kind: 'host', session: true };
270
+ return sessionServed !== undefined
271
+ ? { kind: 'session', barAnchor: sessionServed.anchor }
272
+ : { kind: 'host', session: true };
261
273
  }
262
274
  if (barMs === undefined || !(tierMs > 0) || !(toMs > fromMs) || fromMs % tierMs !== 0 || toMs % tierMs !== 0) {
263
275
  return { kind: 'host', session: false };
@@ -266,13 +278,13 @@ export function wrunOptionFlowGrouping(args) {
266
278
  if (buckets > GROUPING_PROOF_MAX_BUCKETS)
267
279
  return { kind: 'host', session: false };
268
280
  /** Whether every bucket's group (`barOf`: the host bar its group lands on, null for a bucket the anchor drops) is the
269
- * bucket's own host bar; a dropped bucket counts only where the anchor drops off the cash session (`drops`). */
281
+ * bucket's own host bar; a dropped bucket holding a host bar counts only where `drops` says the drop loses no row. */
270
282
  const lands = (barOf, drops) => {
271
283
  for (let ts = fromMs; ts < toMs; ts += tierMs) {
272
284
  const bar = barOf(ts);
273
285
  const host = wrunHostBarOf(ts, barMs, barGrid);
274
286
  if (bar === null) {
275
- if (!drops && host !== null)
287
+ if (host !== null && !drops(ts))
276
288
  return false;
277
289
  continue;
278
290
  }
@@ -281,28 +293,101 @@ export function wrunOptionFlowGrouping(args) {
281
293
  }
282
294
  return true;
283
295
  };
284
- if (barMs === DAY_MS && sessionServed) {
285
- const anchor = sessionAnchor;
296
+ if (barMs === DAY_MS && sessionServed !== undefined) {
297
+ const rule = sessionServed;
286
298
  const sessionBar = (ts) => {
287
- const stamp = wrunOptionFlowSessionStampMs(ts, anchor);
299
+ const stamp = rule.sessionOpenMs(ts);
288
300
  return stamp === null ? null : wrunHostBarOf(stamp, barMs, barGrid);
289
301
  };
290
- if (lands(sessionBar, anchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth)) {
291
- return { kind: 'session', barAnchor: anchor };
302
+ // A regular session drops the buckets off its hours, which the daily candle of its chart never holds.
303
+ if (lands(sessionBar, rule.session !== undefined ? everyDrop : noDrop)) {
304
+ return { kind: 'session', barAnchor: rule.anchor };
292
305
  }
293
306
  }
294
307
  if (barMs >= DAY_MS || barMs % tierMs !== 0)
295
308
  return { kind: 'host', session: false };
296
- if (fromMs % barMs === 0 && toMs % barMs === 0 && lands((ts) => ts - (ts % barMs), false)) {
297
- return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUtc };
309
+ if (fromMs % barMs === 0 && toMs % barMs === 0 && lands((ts) => ts - (ts % barMs), noDrop)) {
310
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: OPTION_BAR_ANCHOR.UTC };
298
311
  }
299
- if (HALF_HOUR_MS % tierMs === 0 &&
312
+ const cashSession = OPTION_BAR_ANCHOR_RULES[OPTION_BAR_ANCHOR.US_EQUITY_RTH];
313
+ if (cashSession.fitsTier(tierMs, barMs, false) &&
300
314
  isEquityRegularSessionGated(barGrid?.exchange, barGrid?.sessionType) &&
301
- lands((ts) => usEquityAnchoredBucketStartMs(ts, barMs), true)) {
302
- return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUsEquityRth };
315
+ lands((ts) => cashSession.barOpenMs(ts, barMs), everyDrop)) {
316
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: cashSession.anchor };
317
+ }
318
+ // A CME regular session drops its weekend days: only where the chart's product trades none there.
319
+ const chartClosed = optionChartClosedAt(barGrid);
320
+ for (const rule of wrunOptionFlowVenueSessionRules(read, exchange)) {
321
+ if (!rule.fitsTier(tierMs, barMs, false) || !rule.isBoundary(fromMs, barMs, false))
322
+ continue;
323
+ if (!rule.isBoundary(toMs, barMs, false))
324
+ continue;
325
+ if (lands((ts) => rule.barOpenMs(ts, barMs), chartClosed)) {
326
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: rule.anchor };
327
+ }
303
328
  }
304
329
  return { kind: 'host', session: false };
305
330
  }
331
+ /** The regular sessions a read takes on its venue that one venue group's rows alone are laid on (a CME group venue:
332
+ * CME_RTH, CME_ENERGY_RTH), in pb-common's order; none on a venue no such anchor lays, or a read naming no venue. */
333
+ function wrunOptionFlowVenueSessionRules(read, exchange) {
334
+ return optionBarAnchorsTaken(read, exchange).filter((rule) => rule.venues !== 'every' && rule.session !== undefined);
335
+ }
336
+ /**
337
+ * The grouping of one ask and the tier its grouped read rides (OPTLOAD W3 FE-ANCHOR): the ask's own tier wherever the
338
+ * gateway groups the window there (a session at the group's 30-minute view where that holds the window,
339
+ * `wrunOptionFlowGroupedTier`), else the coarsest of the read's tiers (`tiers`) finer than the ask's, dividing it and
340
+ * still holding the window's start, at which the chart's bars ARE an anchor's bars. A regular-hours CME chart's hours
341
+ * ride the 30-minute tier (their 13:30Z opens sit on it), which CME_RTH's 16:15 close does not divide (the gateway takes
342
+ * CME_RTH from tiers dividing 15 minutes alone), so they group from 5 minutes. Else `host`, at the ask's tier.
343
+ */
344
+ export function wrunOptionFlowGroupedRead(args) {
345
+ const { askTier, fromMs, nowMs } = args;
346
+ const at = (tier) => wrunOptionFlowGrouping({
347
+ barMs: args.barMs,
348
+ barGrid: args.barGrid,
349
+ tierMs: tier.ms,
350
+ fromMs,
351
+ toMs: args.toMs,
352
+ session: args.session,
353
+ clock: args.clock,
354
+ exchange: args.exchange,
355
+ read: args.read,
356
+ });
357
+ const grouping = at(askTier);
358
+ if (grouping.kind !== 'host') {
359
+ return { grouping, tier: wrunOptionFlowGroupedTier(grouping, askTier, args.sessionTier, fromMs, nowMs) };
360
+ }
361
+ if (!args.session) {
362
+ const finer = args.tiers
363
+ .filter((tier) => tier.ms > 0 &&
364
+ tier.ms < askTier.ms &&
365
+ askTier.ms % tier.ms === 0 &&
366
+ (tier.retentionMs === undefined || fromMs >= nowMs - tier.retentionMs))
367
+ .sort((a, b) => b.ms - a.ms);
368
+ for (const tier of finer) {
369
+ const stepped = at(tier);
370
+ if (stepped.kind === 'bars')
371
+ return { grouping: stepped, tier };
372
+ }
373
+ }
374
+ return { grouping, tier: askTier };
375
+ }
376
+ /**
377
+ * The window a grouped read of `[fromMs, toMs)` sends: on a session grouping the window widened to its anchor's session
378
+ * boundaries (the gateway refuses any other window; a CME trade date a weekday holiday's session is booked into opens
379
+ * at that session's open), else the window itself (a bar grouping was proved on it, its edges on the bars).
380
+ */
381
+ export function wrunOptionFlowGroupingWindow(grouping, fromMs, toMs) {
382
+ if (grouping.kind !== 'session')
383
+ return { fromMs, toMs };
384
+ const grid = {
385
+ anchor: grouping.barAnchor,
386
+ seconds: 0,
387
+ session: true,
388
+ };
389
+ return { fromMs: optionGridFloorBoundaryMs(grid, fromMs), toMs: optionGridCeilBoundaryMs(grid, toMs) };
390
+ }
306
391
  /** The most tier buckets the nested proof walks for one read (the gateway's own limit is 15,000 points a request). */
307
392
  const NESTED_PROOF_MAX_BUCKETS = 50_000;
308
393
  /** Every UTC group width the gateway takes, widest first: the whole minutes that divide a day (contract 3.2: B below a
@@ -354,18 +439,17 @@ export function wrunOptionNestedUtcBars(args) {
354
439
  if (fromMs % width !== 0 || toMs % width !== 0)
355
440
  continue;
356
441
  if (nests(width))
357
- return { barSeconds: width / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUtc };
442
+ return { barSeconds: width / 1000, barAnchor: OPTION_BAR_ANCHOR.UTC };
358
443
  }
359
444
  return undefined;
360
445
  }
361
- /** The trade-date group a bucket stamped `ts` sums into under the gateway's session (contract 3.4): on RTH the New York
362
- * date's 09:30 open for a bucket inside the cash session (null outside it), on UTC the UTC date's 00:00Z. */
446
+ /** The trade-date group a bucket stamped `ts` sums into under the gateway's session on an anchor (contract 3.4, the
447
+ * anchor mirror): on RTH the New York date's 09:30 open for a bucket inside the cash session (null outside it), on UTC
448
+ * the UTC date's 00:00Z, on CME_SESSION the 17:00 Chicago open of the trade date's first session day. */
363
449
  export function wrunOptionFlowSessionStampMs(ts, barAnchor) {
364
450
  if (!Number.isFinite(ts))
365
451
  return null;
366
- if (barAnchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth)
367
- return usEquityAnchoredBucketStartMs(ts, DAY_MS);
368
- return ts - (((ts % DAY_MS) + DAY_MS) % DAY_MS);
452
+ return optionBarAnchorRuleOf(barAnchor)?.sessionOpenMs(ts) ?? null;
369
453
  }
370
454
  /**
371
455
  * The stamp of the group a bucket stamped `ts` sums into, on the browser's side of a grouping (the fold's): the
@@ -376,12 +460,8 @@ export function wrunOptionFlowGroupStampMs(ts, grouping, bars) {
376
460
  if (!Number.isFinite(ts))
377
461
  return null;
378
462
  switch (grouping.kind) {
379
- case 'bars': {
380
- const barMs = grouping.barSeconds * 1000;
381
- return grouping.barAnchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth
382
- ? usEquityAnchoredBucketStartMs(ts, barMs)
383
- : ts - (((ts % barMs) + barMs) % barMs);
384
- }
463
+ case 'bars':
464
+ return optionBarAnchorRuleOf(grouping.barAnchor)?.barOpenMs(ts, grouping.barSeconds * 1000) ?? null;
385
465
  case 'session':
386
466
  return wrunOptionFlowSessionStampMs(ts, grouping.barAnchor);
387
467
  case 'host': {
@@ -723,6 +803,10 @@ export function wrunOptionStrikeFlowZeroDte(row, tierMs, clock) {
723
803
  * bars. A newest bar that cannot fit alone is skipped (a forming day read from minutes); from the first bar that fits,
724
804
  * a bar that would pass the budget stops the walk. The kept bars are read per run of one tier (`reads`); every asked
725
805
  * bar outside them is partial. `newerBarOpens` are the host bars after the ask, up to the clock.
806
+ *
807
+ * FE-FOLD-CAP (OPTLOAD W3, under R2's flag): `budgetRows` (the ask's `foldBudgetRows`, its share of the indicator's
808
+ * download budget in contract rows) caps the walk below the source answer budget; absent, the answer budget's 49,932
809
+ * rows a read, today's plan. `projectedRows` is what the kept bars are projected to read.
726
810
  */
727
811
  export function wrunOptionStrikeFlowFoldPlan(args) {
728
812
  const { barOpens, barMs, barGrid, nowMs } = args;
@@ -735,8 +819,18 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
735
819
  choice: 'coarsest',
736
820
  sessionGrid: barGrid ?? null,
737
821
  });
738
- // The per-contract read weighs as `option_contract_flow`'s raw rows do: the same read, the same budget.
739
- const budget = kScriptSourceAnswerRows(WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH);
822
+ // The per-contract read weighs as `option_contract_flow`'s raw rows do: the same read, the same budget; a budgeted
823
+ // run's share caps it below (the smaller wins).
824
+ const answerRows = kScriptSourceAnswerRows(WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH);
825
+ const cap = args.budgetRows;
826
+ const capped = typeof cap === 'number' && cap >= 1;
827
+ const budget = capped ? Math.min(answerRows, Math.floor(cap)) : answerRows;
828
+ // The projection finds the chain's plane by the contract flow's exchange field (`flowExchange`): a lane's extras name
829
+ // it there (the lane's forecast), the worker's parsed acquisition as `exchange`. Under a cap both read the chain's own
830
+ // plane, so the cap the forecast priced is the cap the worker folds by (INT 2026-10-23: the worker read the plain
831
+ // plane, an ES1! regular-hours hour at 1,458 rows for the CME plane's 4,913, and its 5,831-row cap folded 3 hours).
832
+ // Without a cap the plan reads as it did (the flag-off fold, unchanged).
833
+ const projection = capped ? wrunOptionStrikeFlowProjectionOf(args.acquisition) : args.acquisition;
740
834
  let rows = 0;
741
835
  let keptFromMs = Number.POSITIVE_INFINITY;
742
836
  let keptToMs = Number.NEGATIVE_INFINITY;
@@ -748,7 +842,7 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
748
842
  continue;
749
843
  }
750
844
  const span = bar.span ?? wrunHostBarSpanOf(bar.barOpenMs, barMs, barGrid ?? null);
751
- const projected = wrunOptionContractFlowBarRows({ openMs: span.fromMs, endMs: span.toMs, tier: bar.tier }, nowMs, args.acquisition);
845
+ const projected = wrunOptionContractFlowBarRows({ openMs: span.fromMs, endMs: span.toMs, tier: bar.tier }, nowMs, projection);
752
846
  const barRows = Number.isFinite(projected) && projected > 0 ? projected : 0;
753
847
  if (keptToMs === Number.NEGATIVE_INFINITY && barRows > budget)
754
848
  continue;
@@ -767,8 +861,20 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
767
861
  partialBars: barOpens.filter((open) => !keptSet.has(open)),
768
862
  keptFromMs,
769
863
  keptToMs,
864
+ projectedRows: rows,
770
865
  };
771
866
  }
867
+ /** A strike flow acquisition as the contract flow projection reads it (`wrunOptionStrikeFlowFoldPlan` under a cap): the
868
+ * chain's exchange in `flowExchange`, from the parsed acquisition's `exchange` when the field is missing. */
869
+ function wrunOptionStrikeFlowProjectionOf(acquisition) {
870
+ const named = acquisition[WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD];
871
+ if (typeof named === 'string' && named.trim() !== '')
872
+ return acquisition;
873
+ const exchange = acquisition.exchange;
874
+ return typeof exchange === 'string' && exchange.trim() !== ''
875
+ ? { ...acquisition, [WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD]: exchange }
876
+ : acquisition;
877
+ }
772
878
  /** The host bars `[fromMs, toMs)` holds on the chart's grid, ascending (`liveBucketStartsInRange` over the grid). */
773
879
  export function wrunOptionFlowHostBars(fromMs, toMs, barMs, barGrid) {
774
880
  if (!(toMs > fromMs) || !(barMs > 0))
@@ -389,10 +389,34 @@ export declare const WRUN_OPTION_STRIKES_KIT_LAYOUTS: Readonly<{
389
389
  /** The column of a kit levels row that says the bar was refused (its newest minute held more rows than the input's
390
390
  * `max_cells`): 1 refused, 0 served. */
391
391
  export declare const WRUN_OPTION_STRIKES_KIT_REFUSED_COLUMN = 13;
392
+ /**
393
+ * `option_strikes`' strike velocity knob (contract H; the om schema takes the knob by this name and shape): a literal
394
+ * list of 1 to 7 distinct windows in minutes, each one of `WRUN_OPTION_STRIKES_VELOCITY_WINDOWS`, in the order its
395
+ * columns take. A setting's handle (`"@param"`) never names it: the windows size the block, and a setting never
396
+ * resizes one (`wrunOptionInputTupleWidth`).
397
+ */
398
+ export declare const WRUN_OPTION_STRIKES_VELOCITY_KNOB = "velocity_windows";
399
+ /** The windows the gateway answers velocity over (tsdb-gateway `optionStrikeVelocityWindows`), in minutes. */
400
+ export declare const WRUN_OPTION_STRIKES_VELOCITY_WINDOWS: readonly number[];
401
+ /** What `velocity_windows` takes, for a refusal. */
402
+ export declare const WRUN_OPTION_STRIKES_VELOCITY_TAKES = "a list of 1 to 7 distinct windows in minutes, each one of 1, 5, 10, 15, 60, 240 and 1440";
403
+ /** The ask's field the windows ride (the K control copies it, the worker twin reads it), in the knob's order. */
404
+ export declare const WRUN_OPTION_STRIKES_VELOCITY_FIELD = "strikeVelocityWindowsMin";
405
+ /**
406
+ * The velocity lists a tuple appends after `underlying` when the knob is set, in this order, each one entry per window
407
+ * in the knob's order: the change of net GEX, net DEX, net VEX, and the open interest (calls plus puts, in contracts).
408
+ */
409
+ export declare const WRUN_OPTION_STRIKES_VELOCITY_LISTS: readonly string[];
410
+ /** A `velocity_windows` value's windows in its own order, or undefined for a value outside the knob's words. */
411
+ export declare function wrunOptionStrikesVelocityWindows(value: unknown): number[] | undefined;
412
+ /** The f64s per tuple of a velocity read: the class's tuple, then one value per list per window. */
413
+ export declare function wrunOptionStrikesVelocityWidth(classWidth: number, windows: readonly number[]): number;
392
414
  /**
393
415
  * The f64s per tuple one input's block carries (the SDK's `wrunOptionInputTupleWidth`, the one rule every host sizes
394
- * by): a view block's row width when its words name a fold (a page view fold, the strike kit fold), else the class's
395
- * own width. The words alone decide it, never a param, so a setting never resizes a block.
416
+ * by): a view block's row width when its words name a fold (a page view fold, the strike kit fold), the class's tuple
417
+ * and its velocity lists when an `option_strikes` input names `velocity_windows` (`wrunOptionStrikesVelocityWidth`;
418
+ * the kit sizes it so from the om schema's knob on, `WRUN_OPTION_STRIKES_VELOCITY_SERVED`), else the class's own
419
+ * width. The words alone decide it, never a param, so a setting never resizes a block.
396
420
  */
397
421
  export declare function wrunOptionInputTupleWidth(source: Readonly<Record<string, unknown>>, classWidth: number): number;
398
422
  /** pb-common `OptionSurfacePick` by word (the gateway decodes numbers, never names). */
@@ -400,18 +424,21 @@ export declare const WRUN_OPTION_SURFACE_PICK_CODES: Readonly<Record<string, num
400
424
  /** pb-common `StrikeMetric` by the kit fold's lens code (0 gamma, 1 delta, 2 vega): NET_GEX, DEX, VEX. */
401
425
  export declare const WRUN_OPTION_STRIKES_KIT_METRICS: Readonly<Record<number, number>>;
402
426
  /**
403
- * The `OptionReadShape` G5 fields (pb-common 12.72.0, fields 40 to 51) a per-bar ask names, as they ride the lane's
427
+ * The `OptionReadShape` G5 fields (pb-common 12.74.0, fields 40 to 53) a per-bar ask names, as they ride the lane's
404
428
  * payload and the gateway reads them (JSON names, enums as numbers):
405
429
  * - the surface pick: `surfacePick` (1 nearest_days, 2 tenor_bracket) with `surfaceDays` and `surfaceDelta` (25 or
406
430
  * 10, the wings) or `surfaceTenorDays`;
407
431
  * - the strike kit fold: `strikeKitFold`, `strikeNearest`, `strikeKitWindowPct`, `strikeStepRows`, `strikeCarryNext`,
408
432
  * `strikeLevels`, `strikeMaxCells` (the input's `max_cells`: a minute with more rows answers a refused levels row)
409
- * and `strikeKitMetric` (the lens).
433
+ * and `strikeKitMetric` (the lens); with `curve` (OPTLOAD W3 U4) `strikeKitCurve` and `strikeKitMultiplier` (the
434
+ * chart's `market.option_multiplier()`, `facts.optionMultiplier`; 0, which the gateway reads as 1, when unknown),
435
+ * both or neither, so an input without `curve` asks exactly what it asked before.
410
436
  * The fields key the lane instance, so two inputs asking two picks are two reads, and an input declaring no word asks
411
437
  * none of them (today's read).
412
438
  */
413
439
  export declare function wrunOptionLaneAskFields(ask: WrunOptionLaneAsk, facts?: {
414
440
  maxCells?: number;
441
+ optionMultiplier?: number;
415
442
  }): Record<string, unknown>;
416
443
  /** A per-bar ask read back off a payload (the worker twins, the K controls): the G5 fields as they ride, or
417
444
  * undefined for a payload that names none (today's read). */
@@ -428,6 +455,9 @@ export interface WrunOptionLaneAskRead {
428
455
  strikeLevels?: boolean;
429
456
  strikeMaxCells?: number;
430
457
  strikeKitMetric?: number;
458
+ /** Set (with its multiplier) only on an ask whose input declares `curve`. */
459
+ strikeKitCurve?: true;
460
+ strikeKitMultiplier?: number;
431
461
  }
432
462
  /** A per-bar ask's fields of a payload, as they ride (a K control copies them onto the request it builds). */
433
463
  export declare function wrunOptionLanePayloadFields(cls: WrunOptionLaneClass, payload: Readonly<Record<string, unknown>> | undefined): Record<string, unknown>;
@@ -449,8 +479,9 @@ export declare function wrunOptionKitBarHasRows(tuples: ReadonlyArray<unknown>):
449
479
  /**
450
480
  * The f64s per row an instance's rows carry, by its facets (the SDK's `wrunAskTupleWidth`, the ask's side of
451
481
  * `wrunOptionInputTupleWidth`: the views ride the instance's key, so every input it serves shares its width): the kit
452
- * fold's rows on an instance asking it, a view block's rows on one whose views (`<prefix>Views`) name a fold of its
453
- * class (Top Contracts' totals), else the class's own tuple (`classWidth`).
482
+ * fold's rows on an instance asking it, the class's tuple and its velocity lists on an `option_strikes` instance asking
483
+ * velocity windows (`WRUN_OPTION_STRIKES_VELOCITY_FIELD`), a view block's rows on one whose views (`<prefix>Views`) name
484
+ * a fold of its class (Top Contracts' totals), else the class's own tuple (`classWidth`).
454
485
  */
455
486
  export declare function wrunOptionLaneTupleWidth(sourceClass: string, acquisition: Readonly<Record<string, unknown>>, classWidth: number): number;
456
487
  /**
@@ -476,11 +507,14 @@ export declare function wrunOptionLaneFirstPaintBudget(sourceClass: string, acqu
476
507
  export declare function wrunOptionSurfacePickTuples(tuples: ReadonlyArray<ReadonlyArray<number>>, word: string, params: Readonly<Record<string, number>>): number[][];
477
508
  /**
478
509
  * The chart's chain on the OPRA plane by coin, held in place of the chain directory's answer (section 8, O1): the
479
- * chain `wrunLaneOpraPlaneChain` reads for the chart's coin when the chart's options ride the OPRA plane (the
480
- * planner's verdict when the lane context carries it, `opraPlane`, else the run's own rule over the chart's exchange,
481
- * `governedOptionPlane`, the predicate the planners' `isOpraPlaneExchange` is). Undefined off the plane, for a chart
482
- * naming no coin, and while another screen holds the plane's session (the directory resolution then stops by that
483
- * name before any read). Main thread only; the lane resolver loads lazily (this module stays light: the paint seam
484
- * reads its view table).
510
+ * chain `wrunLaneOpraPlaneChain` reads for the coin when the chart's options ride the OPRA plane. With the planner's
511
+ * verdict (`opraPlane`, which the lane context carries: a stock twin's context names its stock's ticker as the coin) the
512
+ * coin is read as given; without one the market is judged through the options seam (the gate port's
513
+ * `chartOptionsMarket`, then `governedOptionPlane` over the market it answers, exchange and `symbol` both: the
514
+ * predicate the planners' `isOpraPlaneExchange` is), and a stock twin's chain is its stock's, by the twin's ticker,
515
+ * never the chart's own coin, naming the chart market (`stockTwinOf`). Undefined off the plane, for a chart naming no
516
+ * coin, and while another screen holds the plane's session (the directory resolution then stops by that name before
517
+ * any read). Main thread only; the lane resolver loads lazily (this module stays light: the paint seam reads its view
518
+ * table).
485
519
  */
486
- export declare function wrunHeldOpraPlaneChain(exchange: unknown, coin: unknown, opraPlane?: boolean): Promise<WrunLaneChartChain | undefined>;
520
+ export declare function wrunHeldOpraPlaneChain(exchange: unknown, coin: unknown, opraPlane?: boolean, symbol?: unknown): Promise<WrunLaneChartChain | undefined>;