@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
@@ -1,4 +1,5 @@
1
1
  import type { WrunLaneChartChain } from './sources/opra-option-lanes.util.js';
2
+ import type { WrunRowLaneRowBudget } from './sources/wrun-row-lane.types.js';
2
3
  /** The classes whose inputs declare views (the cell class each view's block is built in). */
3
4
  export type WrunOptionViewClass = 'options_chain' | 'option_contract_state';
4
5
  /** One view word's contract (section 6.1). */
@@ -155,11 +156,13 @@ export declare const WRUN_OPTION_VIEWS: Readonly<{
155
156
  readonly rate: "rate";
156
157
  };
157
158
  readonly answer: "fold";
159
+ readonly hinted: true;
158
160
  };
159
161
  readonly strike_table: {
160
162
  readonly cls: "options_chain";
161
163
  readonly params: {};
162
164
  readonly answer: "fold";
165
+ readonly hinted: true;
163
166
  };
164
167
  readonly gex_curve: {
165
168
  readonly cls: "options_chain";
@@ -169,6 +172,7 @@ export declare const WRUN_OPTION_VIEWS: Readonly<{
169
172
  readonly points: "points";
170
173
  };
171
174
  readonly answer: "fold";
175
+ readonly hinted: true;
172
176
  };
173
177
  }>;
174
178
  export type WrunOptionViewWord = keyof typeof WRUN_OPTION_VIEWS;
@@ -181,13 +185,20 @@ export interface WrunOptionView {
181
185
  export declare const WRUN_OPTION_VIEW_MARGIN_PCT = 0.5;
182
186
  /** The lane refusal code (wrun-lane-refusal.leaf) of a view ask the gateway answered without the views. */
183
187
  export declare const WRUN_OPTION_VIEWS_UNSERVED_CODE = "option-views-unserved";
184
- /** The plan's refusal of a view whose answer no reader of this host takes yet (a fold). */
188
+ /** The plan's refusal of a view this host does not read yet (`wrunOptionViewUnread`). */
185
189
  export declare const WRUN_OPTION_VIEW_UNREAD_CODE = "wrun_option_view_unread";
186
190
  /** The plan's refusal of one chain lane whose inputs read it through views and whole at once (one ask serves both
187
191
  * never: B and a view of B are two answers). */
188
192
  export declare const WRUN_OPTION_VIEWS_ONE_ASK_CODE = "wrun_option_views_one_ask";
193
+ /** The plan's refusal of one chain lane whose view inputs declare different `expiries` words: the lane asks ONE block
194
+ * B of the gateway, built for one `nearestExpiries`, so an input of another word would read views of another B (the
195
+ * SDK asks each word apart; one acquisition per word would serve them). */
196
+ export declare const WRUN_OPTION_VIEWS_ONE_EXPIRIES_CODE = "wrun_option_views_one_expiries";
189
197
  /** A view's spec, or undefined for a word that names none. */
190
198
  export declare function wrunOptionViewSpec(word: unknown): WrunOptionViewSpec | undefined;
199
+ /** Why this host does not read a view yet, in a refusal's words, or undefined when it reads it (every projection,
200
+ * option_contract_state's folds but `oi_board`, which follows the chart's close). */
201
+ export declare function wrunOptionViewUnread(spec: WrunOptionViewSpec): string | undefined;
191
202
  /**
192
203
  * The knobs an input names its views in: `page_view` (one word) or `page_views` (a list), the chain page's views
193
204
  * (section 6.1's title). Never `view`: that is every input's bar view (`confirmed`, `forming`, `is_new_period`,
@@ -196,15 +207,17 @@ export declare function wrunOptionViewSpec(word: unknown): WrunOptionViewSpec |
196
207
  export declare const WRUN_OPTION_VIEW_KNOB = "page_view";
197
208
  export declare const WRUN_OPTION_VIEWS_KNOB = "page_views";
198
209
  /** Every view word an input source declares, in either knob, unvalidated (the paint seam and the stray-knob rule
199
- * read which params the declared views take). */
210
+ * read which params the declared views take; the tuple width reads whether one is a fold). A `page_views` that is
211
+ * no list reads as its one value, as the SDK's `wrunOptionViewWordsDeclared` reads it (its declaration refuses). */
200
212
  export declare function wrunOptionViewWordsDeclared(source: Readonly<Record<string, unknown>>): unknown[];
201
- /** The knob names every view the source declares takes as params. */
213
+ /** The knob names every view the source declares takes as params, and on a per-bar class the number params its
214
+ * declared word takes (a flag takes no setting: true or false only). */
202
215
  export declare function wrunOptionViewParamKnobs(source: Readonly<Record<string, unknown>>): Set<string>;
203
216
  /**
204
217
  * An input's views, validated (main thread, after the paint seam): undefined when it declares none (today's path),
205
218
  * else the views in canonical order (`canonicalViews`). Refuses by name a word that names no view of the input's
206
- * class, a param that is no finite number (a `"@<param>"` the sheet declares no param of stays a string here), and a
207
- * fold, which no reader of this host takes yet.
219
+ * class, a view this host does not read yet (`wrunOptionViewUnread`), and a param that is no finite number (a
220
+ * `"@<param>"` the sheet declares no param of stays a string here).
208
221
  */
209
222
  export declare function wrunOptionViewsOfSource(input: object, ctx: {
210
223
  inputName: string;
@@ -219,12 +232,13 @@ export declare function wrunOptionViewsHinted(views: readonly WrunOptionView[]):
219
232
  /**
220
233
  * A payload's `<prefix>Views` read back (the worker twins, the K controls): the views of `cls`, canonical, or
221
234
  * undefined for a payload that names none; null for a text that is not one this module writes (a word of another
222
- * class, a param that is no finite number, garbage): the ask is refused, never widened to B whole.
235
+ * class, a view this host does not read, a param that is no finite number, garbage): the ask is refused, never
236
+ * widened to B whole.
223
237
  */
224
238
  export declare function wrunOptionViewsOf(text: unknown, cls: WrunOptionViewClass): WrunOptionView[] | null | undefined;
225
239
  /** What an `options_chain` view ask hands the gateway to size B on its page (section 5.1). */
226
240
  export interface WrunOptionsChainViewScope {
227
- /** The largest `nearest:N` over the lane's inputs; absent when one reads every expiry. */
241
+ /** The lane's one `nearest:N` (its view inputs declare one expiries word); absent when they read every expiry. */
228
242
  nearestExpiries?: number;
229
243
  /** The smallest `max_cells` over the lane's inputs; absent when none declares one. */
230
244
  maxContracts?: number;
@@ -233,10 +247,41 @@ export interface WrunOptionsChainViewScope {
233
247
  export declare function wrunOptionViewLaneFields(cls: WrunOptionViewClass, views: readonly WrunOptionView[], scope?: WrunOptionsChainViewScope): Record<string, unknown>;
234
248
  /** The view fields of a payload, as they ride (a K control copies them onto the request it builds). */
235
249
  export declare function wrunOptionViewPayloadFields(cls: WrunOptionViewClass, payload: Readonly<Record<string, unknown>> | undefined): Record<string, unknown>;
250
+ /**
251
+ * The implicit view (OPTLOAD W3 FE-STATE): an `option_contract_state` input that declares no view reads its block B
252
+ * whole, so its lane asks the gateway for exactly that, the `WHOLE` view of B (pb-common `OPTION_CHAIN_VIEW_WHOLE`,
253
+ * which the gateway answers on either class), in ONE chain summary read: no expiry directory, no page of every strike,
254
+ * no per-contract registry read. The answer is B's own class tuples in B's order, so the input reads it as it read B.
255
+ * The acquisition names it apart from any view text (`stateViews: "whole"`, never a JSON list: the authoring table
256
+ * keeps `whole` an options_chain word, as the kit does, and no author declares it on this class), so it keys an
257
+ * instance of its own (one key per chain, tier, expiries word, window and book), and the worker twin reads it back as
258
+ * the `whole` view, `implicit` (`wrunOptionViewAskFieldsOf`).
259
+ */
260
+ export declare const WRUN_OPTION_STATE_IMPLICIT_VIEW = "whole";
261
+ /** The payload field of the implicit view (`WRUN_OPTION_STATE_IMPLICIT_VIEW`), as the state lane writes it. */
262
+ export declare function wrunOptionStateImplicitViewFields(): Record<string, unknown>;
263
+ /**
264
+ * The implicit view of an `options_chain` input (OPTLOAD W3 FE-CHAIN), FE-STATE's rule on the chain class: a governed
265
+ * chain whose inputs declare no view reads its block B whole, so its lane asks the gateway's `WHOLE` view of B in ONE
266
+ * chain summary read, sized on the gateway's page by the inputs' expiries word and budget (`chainNearestExpiries`, the
267
+ * inputs' `nearest:N` when every input declares one; `chainMaxContracts`, the smallest `max_cells`; the gateway ports the
268
+ * lane scope's arithmetic, `wrunOptionsChainLaneScope`): no expiry directory before the ask and no per-contract registry
269
+ * read after it. The answer is B's 10-value tuples in B's order, so the inputs read it as they read B. The acquisition
270
+ * names it by the bare word (`chainViews: "whole"`), never a JSON list, so it never shares an author's spelling (an
271
+ * explicit `page_view: "whole"` rides as view text and is refused like any view when the gateway does not answer it),
272
+ * and the worker twin reads it back as the `whole` view, `implicit` (`wrunOptionViewAskFieldsOf`).
273
+ */
274
+ export declare const WRUN_OPTIONS_CHAIN_IMPLICIT_VIEW = "whole";
275
+ /** The payload fields of the options_chain implicit view (`WRUN_OPTIONS_CHAIN_IMPLICIT_VIEW`), as the chain lane writes
276
+ * them: the bare word, then the gateway's scope inputs. */
277
+ export declare function wrunOptionsChainImplicitViewFields(scope: WrunOptionsChainViewScope): Record<string, unknown>;
236
278
  /** A view ask read off a payload (the worker twins): the views and the scope and hint fields, or null for a payload
237
279
  * whose views are not this module's text; undefined for one that names no views (today's path). */
238
280
  export interface WrunOptionViewAskFields {
239
281
  views: WrunOptionView[];
282
+ /** The implicit WHOLE of an input that declares no view (`WRUN_OPTIONS_CHAIN_IMPLICIT_VIEW`,
283
+ * `WRUN_OPTION_STATE_IMPLICIT_VIEW`): an answer that is not B's rows is read today's way, never refused. */
284
+ implicit?: true;
240
285
  nearestExpiries?: number;
241
286
  maxContracts?: number;
242
287
  spotHint?: number;
@@ -250,6 +295,185 @@ export declare function wrunOptionViewHintCovers(hint: number, marginPct: number
250
295
  export declare function wrunOptionViewHint(held: unknown, marginPct: number, close: number | undefined): number | undefined;
251
296
  /** The close of a chart's last row (`[ts, open, high, low, close, ...]`), or undefined. */
252
297
  export declare function wrunChartLastClose(rows: unknown): number | undefined;
298
+ /** The classes whose inputs declare a per-bar word. */
299
+ export type WrunOptionLaneClass = 'option_surface' | 'option_strikes';
300
+ /** Each per-bar class's word knob and its words, in the SDK's order (`WRUN_OPTION_SURFACE_PICKS`,
301
+ * `WRUN_OPTION_STRIKES_FOLDS`). */
302
+ export declare const WRUN_OPTION_LANE_WORDS: Readonly<Record<WrunOptionLaneClass, {
303
+ knob: string;
304
+ words: readonly string[];
305
+ }>>;
306
+ /**
307
+ * What one per-bar param knob takes (the SDK's `WrunOptionKnobSpec`): a number in min..max (`above` excludes min,
308
+ * `below` excludes max), a whole number, or (`codes`) one of a few numbers, each naming a choice (a select setting's
309
+ * picked index); a flag takes true or false, never a setting. `what` names it in a refusal; `fallback` is what an
310
+ * absent knob reads (absent: the knob is required).
311
+ */
312
+ export interface WrunOptionKnobSpec {
313
+ readonly kind: 'number' | 'whole' | 'time' | 'flag';
314
+ readonly min?: number;
315
+ readonly max?: number;
316
+ readonly above?: boolean;
317
+ readonly below?: boolean;
318
+ readonly codes?: Readonly<Record<number, string>>;
319
+ readonly what: string;
320
+ readonly fallback?: number;
321
+ }
322
+ /** The per-bar words' knobs, by word, in the SDK's order (`WRUN_OPTION_LANE_KNOBS`, kit 0.90.0; the surface pick's
323
+ * `delta` 0 reads the 25 delta wings, 1 the 10 delta ones). tests/utility/wrun/wrun-option-views.kit-pin.spec.ts holds
324
+ * every spec equal to the installed kit's. */
325
+ export declare const WRUN_OPTION_LANE_KNOBS: Readonly<Record<string, Readonly<Record<string, WrunOptionKnobSpec>>>>;
326
+ /** What `expiries` takes beside the strike kit fold (the SDK's `WRUN_OPTION_STRIKES_KIT_EXPIRIES_TAKES`, kit 0.91.1):
327
+ * the fold keeps its expiries with its own `nearest`, so any other word beside it is refused at declaration. */
328
+ export declare const WRUN_OPTION_STRIKES_KIT_EXPIRIES_TAKES = "\"all\" (or no expiries) beside fold \"kit\": the fold keeps its expiries with its own `nearest`";
329
+ /** What `curve` takes beside the strike kit fold (the SDK's `WRUN_OPTION_STRIKES_KIT_CURVE_TAKES`, kit 0.96.0): the
330
+ * curve row follows each bar's levels row, so `curve: true` without `levels: true` is refused at declaration. */
331
+ export declare const WRUN_OPTION_STRIKES_KIT_CURVE_TAKES = "true only beside levels: true (the curve row follows each bar's levels row), or false";
332
+ /** A per-bar class, or undefined for a class that declares no per-bar word. */
333
+ export declare function wrunOptionLaneClassOf(sourceClass: unknown): WrunOptionLaneClass | undefined;
334
+ /** One word's knobs on a per-bar class (empty for a word the class does not take). */
335
+ export declare function wrunOptionLaneKnobSpecs(cls: WrunOptionLaneClass, word: string): Readonly<Record<string, WrunOptionKnobSpec>>;
336
+ /** Every param knob a per-bar class takes, over its words, each once, in table order (the SDK's
337
+ * `wrunOptionViewParamKnobsOf`). */
338
+ export declare function wrunOptionLaneParamKnobs(cls: WrunOptionLaneClass): readonly string[];
339
+ /** Whether a number is a legal value of a per-bar knob, a flag's 0 or 1 included (the SDK's
340
+ * `wrunOptionKnobSpecLegal`). */
341
+ export declare function wrunOptionKnobSpecLegal(spec: WrunOptionKnobSpec, value: number): boolean;
342
+ /** What a per-bar knob takes, as a refusal spells it (the SDK's `wrunOptionKnobSpecTakes`). */
343
+ export declare function wrunOptionKnobSpecTakes(spec: WrunOptionKnobSpec): string;
344
+ /** One input's per-bar ask: its class, its word and each param by knob, at its value (a flag's 1 or 0) or fallback. */
345
+ export interface WrunOptionLaneAsk {
346
+ cls: WrunOptionLaneClass;
347
+ word: string;
348
+ params: Readonly<Record<string, number>>;
349
+ }
350
+ /** Why an input's per-bar knobs refuse: the knob, its value and what it takes (the SDK's `WrunOptionViewIssue`). */
351
+ export interface WrunOptionLaneIssue {
352
+ knob: string;
353
+ value: unknown;
354
+ takes: string;
355
+ }
356
+ /**
357
+ * ONE reader of a per-bar class's knobs, the SDK's `wrunOptionViewAskOf` for `option_surface` and `option_strikes`
358
+ * (no handle option: a `"@<param>"` the paint seam did not replace is refused as any other value): the ask, or
359
+ * undefined when the input declares neither the word nor a param of it, or the first issue in the SDK's order (the
360
+ * word; each declared param in table order, taken by the word and legal on it; each required param; an `expiries` word
361
+ * other than "all" beside the kit fold, `WRUN_OPTION_STRIKES_KIT_EXPIRIES_TAKES`). Pure: the lane's facets refuse its
362
+ * issue by name (`wrunOptionLaneAskOfSource`), its per-input projection reads the ask.
363
+ */
364
+ export declare function wrunOptionLaneAskOf(source: Readonly<Record<string, unknown>>): {
365
+ ask: WrunOptionLaneAsk;
366
+ } | {
367
+ issue: WrunOptionLaneIssue;
368
+ } | undefined;
369
+ /** An input's per-bar ask, its first issue refused by name (`wrun_option_knob_invalid`): undefined when it declares no
370
+ * per-bar knob (today's read). */
371
+ export declare function wrunOptionLaneAskOfSource(source: object, ctx: {
372
+ inputName: string;
373
+ sourceClass: string;
374
+ }): WrunOptionLaneAsk | undefined;
375
+ /** f64s per row of a view block (the page views' folds) and of the strike kit fold (the SDK's
376
+ * `WRUN_OPTION_VIEW_ROW_WIDTHS`): the layout, then the widest layout's fields. */
377
+ export declare const WRUN_OPTION_VIEW_ROW_WIDTHS: Readonly<{
378
+ readonly options_chain: 11;
379
+ readonly option_contract_state: 16;
380
+ readonly option_strikes: 14;
381
+ }>;
382
+ /** Column 0 of every strike kit fold row (the SDK's `WRUN_OPTION_STRIKES_KIT_LAYOUTS`): a strike row, a bar's levels
383
+ * row and, with `curve` (kit 0.96.0), its curve row after the levels row. */
384
+ export declare const WRUN_OPTION_STRIKES_KIT_LAYOUTS: Readonly<{
385
+ readonly strike: 0;
386
+ readonly levels: 1;
387
+ readonly curve: 2;
388
+ }>;
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
+ * `max_cells`): 1 refused, 0 served. */
391
+ export declare const WRUN_OPTION_STRIKES_KIT_REFUSED_COLUMN = 13;
392
+ /**
393
+ * 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.
396
+ */
397
+ export declare function wrunOptionInputTupleWidth(source: Readonly<Record<string, unknown>>, classWidth: number): number;
398
+ /** pb-common `OptionSurfacePick` by word (the gateway decodes numbers, never names). */
399
+ export declare const WRUN_OPTION_SURFACE_PICK_CODES: Readonly<Record<string, number>>;
400
+ /** pb-common `StrikeMetric` by the kit fold's lens code (0 gamma, 1 delta, 2 vega): NET_GEX, DEX, VEX. */
401
+ export declare const WRUN_OPTION_STRIKES_KIT_METRICS: Readonly<Record<number, number>>;
402
+ /**
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
404
+ * payload and the gateway reads them (JSON names, enums as numbers):
405
+ * - the surface pick: `surfacePick` (1 nearest_days, 2 tenor_bracket) with `surfaceDays` and `surfaceDelta` (25 or
406
+ * 10, the wings) or `surfaceTenorDays`;
407
+ * - the strike kit fold: `strikeKitFold`, `strikeNearest`, `strikeKitWindowPct`, `strikeStepRows`, `strikeCarryNext`,
408
+ * `strikeLevels`, `strikeMaxCells` (the input's `max_cells`: a minute with more rows answers a refused levels row)
409
+ * and `strikeKitMetric` (the lens).
410
+ * The fields key the lane instance, so two inputs asking two picks are two reads, and an input declaring no word asks
411
+ * none of them (today's read).
412
+ */
413
+ export declare function wrunOptionLaneAskFields(ask: WrunOptionLaneAsk, facts?: {
414
+ maxCells?: number;
415
+ }): Record<string, unknown>;
416
+ /** A per-bar ask read back off a payload (the worker twins, the K controls): the G5 fields as they ride, or
417
+ * undefined for a payload that names none (today's read). */
418
+ export interface WrunOptionLaneAskRead {
419
+ surfacePick?: number;
420
+ surfaceDays?: number;
421
+ surfaceDelta?: number;
422
+ surfaceTenorDays?: number;
423
+ strikeKitFold?: true;
424
+ strikeNearest?: number;
425
+ strikeKitWindowPct?: number;
426
+ strikeStepRows?: number;
427
+ strikeCarryNext?: boolean;
428
+ strikeLevels?: boolean;
429
+ strikeMaxCells?: number;
430
+ strikeKitMetric?: number;
431
+ }
432
+ /** A per-bar ask's fields of a payload, as they ride (a K control copies them onto the request it builds). */
433
+ export declare function wrunOptionLanePayloadFields(cls: WrunOptionLaneClass, payload: Readonly<Record<string, unknown>> | undefined): Record<string, unknown>;
434
+ /** A payload's per-bar ask (the worker twins): its G5 fields, each of its own type, or undefined when it names no
435
+ * word of its class (`surfacePick` 1 or 2, `strikeKitFold` true). */
436
+ export declare function wrunOptionLaneAskOfPayload(cls: WrunOptionLaneClass, payload: Readonly<Record<string, unknown>>): WrunOptionLaneAskRead | undefined;
437
+ /** The kit fold's params by knob (the SDK reference's names) off a payload's ask, the lens back to its code. */
438
+ export declare function wrunOptionStrikesKitParamsOf(read: WrunOptionLaneAskRead): Record<string, number>;
439
+ /** Whether a lane instance's acquisition asks a per-bar word (a pick or the kit fold): its rows are landed on the
440
+ * chart's bars by the gateway (or by the lane's own fallback by the same rules). */
441
+ export declare function wrunOptionLaneAcquisitionAsks(sourceClass: string, acquisition: Readonly<Record<string, unknown>>): boolean;
442
+ /** Whether an instance's acquisition asks the kit fold with `carry`: each bar's rows then hold the strikes the NEXT bar
443
+ * with rows draws, and the gateway's carry stops at its read window, so a paged read must ask each older page through
444
+ * the newer page's first bar with rows (wrun-row-lanes.util `fetchWrunRowLaneRows`). */
445
+ export declare function wrunOptionLaneCarriesNext(sourceClass: string, acquisition: Readonly<Record<string, unknown>>): boolean;
446
+ /** Whether one landed kit fold bar has rows the carry reads: any row, its levels row not the refusal (a refused bar
447
+ * keeps no strike, so the carry passes over it to the next bar). */
448
+ export declare function wrunOptionKitBarHasRows(tuples: ReadonlyArray<unknown>): boolean;
449
+ /**
450
+ * The f64s per row an instance's rows carry, by its facets (the SDK's `wrunAskTupleWidth`, the ask's side of
451
+ * `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`).
454
+ */
455
+ export declare function wrunOptionLaneTupleWidth(sourceClass: string, acquisition: Readonly<Record<string, unknown>>, classWidth: number): number;
456
+ /**
457
+ * The row budget the first-paint slice sizes an instance asking a per-bar word by (wrun-row-lane-first-paint.util, the
458
+ * slice FE-STRIKE-LANE added; no second one): the answered row's cells and the rows one bar is projected to hold (a
459
+ * nearest_days pick 1, a tenor bracket 2, a kit fold bar its levels row and drawn strikes). Undefined for an instance
460
+ * that asks no per-bar word: its asks are today's, unsliced.
461
+ */
462
+ export declare function wrunOptionLaneFirstPaintBudget(sourceClass: string, acquisition: Readonly<Record<string, unknown>>, classWidth: number): WrunRowLaneRowBudget | undefined;
463
+ /**
464
+ * One bar's option_surface block under a pick, the SDK's reference (`wrunOptionSurfacePick` and
465
+ * `wrunOptionSurfacePickBlock`, wrun-host/option-views.ts) on the bar's tuples:
466
+ * - `nearest_days` (Skew History): the tuple with dte_days served and at least 1 and both wings served at `delta` (0:
467
+ * iv_p25 and iv_c25, 1: iv_p10 and iv_c10), its dte nearest `days`, the earlier expiry on a tie (the first tuple on
468
+ * an exact one);
469
+ * - `tenor_bracket` (Options Sentiment's AVAR): the anchors (dte_days and both 25-delta wings served, dte above 0.5
470
+ * and both wings above 0) ordered by dte, ties in the block's order; the one before the first at or past `tenor`
471
+ * days and that one, or the first alone, or the last alone.
472
+ * The kept tuples ride in the block's order. A bar that held tuples and whose pick keeps none answers one all-zero
473
+ * tuple (a served bar still reads served); a partial bar's bit 14 rides the first tuple of the answer. Idempotent: a
474
+ * bar the gateway already picked picks to itself, so the gateway's answer and today's read land the same block.
475
+ */
476
+ export declare function wrunOptionSurfacePickTuples(tuples: ReadonlyArray<ReadonlyArray<number>>, word: string, params: Readonly<Record<string, number>>): number[][];
253
477
  /**
254
478
  * The chart's chain on the OPRA plane by coin, held in place of the chain directory's answer (section 8, O1): the
255
479
  * chain `wrunLaneOpraPlaneChain` reads for the chart's coin when the chart's options ride the OPRA plane (the