@orangecharts/wrun-chart-host 0.8.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 (246) hide show
  1. package/README.md +3 -1
  2. package/dist/constants/feature-flags.constants.d.ts +9 -0
  3. package/dist/constants/feature-flags.constants.js +86 -16
  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 +15 -0
  7. package/dist/constants/opra-compliance.constants.js +15 -0
  8. package/dist/constants/option-venues.constants.d.ts +11 -6
  9. package/dist/constants/option-venues.constants.js +5 -2
  10. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  11. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  12. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  13. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  14. package/dist/constants/venue-presets.constants.d.ts +20 -20
  15. package/dist/constants/venue-presets.constants.js +24 -26
  16. package/dist/host-env.d.ts +39 -9
  17. package/dist/host-env.js +6 -0
  18. package/dist/host-ports.types.d.ts +108 -18
  19. package/dist/index.d.ts +14 -0
  20. package/dist/index.js +14 -0
  21. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  22. package/dist/interfaces/opra-realtime.interface.d.ts +13 -11
  23. package/dist/interfaces/opra-realtime.interface.js +10 -10
  24. package/dist/interfaces/replay.interface.d.ts +8 -0
  25. package/dist/interfaces/wrun-runtime.interface.d.ts +52 -15
  26. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +94 -14
  27. package/dist/kscript-data/controls/live-trades-merge.util.js +132 -22
  28. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +56 -0
  29. package/dist/kscript-data/controls/live-trades-order-gate.util.js +107 -0
  30. package/dist/market-data/billing.interface.d.ts +227 -42
  31. package/dist/market-data/billing.interface.js +60 -12
  32. package/dist/market-data/venue.d.ts +88 -6
  33. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  34. package/dist/market-data/venues/cme.d.ts +126 -0
  35. package/dist/market-data/venues/cme.js +133 -0
  36. package/dist/market-data/venues/index.d.ts +165 -8
  37. package/dist/market-data/venues/index.js +48 -6
  38. package/dist/market-data/venues/opra.contract.copy.json +5 -3
  39. package/dist/market-data/venues/opra.d.ts +3 -3
  40. package/dist/market-data/venues/opra.js +5 -4
  41. package/dist/replay/replayLadder.js +3 -1
  42. package/dist/settings-templates/index.js +7 -3
  43. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  44. package/dist/settings-templates/indicator-fields.js +45 -6
  45. package/dist/settings-templates/tool-rules.d.ts +27 -17
  46. package/dist/settings-templates/tool-rules.js +27 -11
  47. package/dist/settings-templates/tool-tables.generated.js +91 -31
  48. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  49. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  50. package/dist/utility/chart/crypto-index.leaf.d.ts +2 -2
  51. package/dist/utility/chart/crypto-index.leaf.js +2 -2
  52. package/dist/utility/chart/index-mode-admission.util.js +24 -3
  53. package/dist/utility/chart/index-mode.util.d.ts +5 -2
  54. package/dist/utility/chart/index-mode.util.js +23 -13
  55. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  56. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  57. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +7 -2
  58. package/dist/utility/chart/kscript-live-coalesce.util.js +9 -3
  59. package/dist/utility/chart/kscript-provenance-keys.util.js +6 -0
  60. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  61. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  62. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  63. package/dist/utility/chart/kscript-venue-policy.util.d.ts +53 -27
  64. package/dist/utility/chart/kscript-venue-policy.util.js +74 -32
  65. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  66. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  67. package/dist/utility/chart/marketKind.util.d.ts +12 -10
  68. package/dist/utility/chart/marketKind.util.js +17 -7
  69. package/dist/utility/chart/om-panel-push-style.util.d.ts +7 -7
  70. package/dist/utility/chart/om-panel-push-style.util.js +17 -15
  71. package/dist/utility/chart/om-panel.util.js +6 -6
  72. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  73. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  74. package/dist/utility/chart/profile-block-size.util.d.ts +16 -0
  75. package/dist/utility/chart/profile-block-size.util.js +7 -0
  76. package/dist/utility/chart/quote-perp.leaf.d.ts +17 -0
  77. package/dist/utility/chart/quote-perp.leaf.js +20 -0
  78. package/dist/utility/chart/rth-session.util.d.ts +3 -2
  79. package/dist/utility/chart/rth-session.util.js +2 -1
  80. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  81. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  82. package/dist/utility/chart/wrun-run-result.util.d.ts +17 -0
  83. package/dist/utility/chart/wrun-run-result.util.js +145 -7
  84. package/dist/utility/common/transformations.util.d.ts +7 -0
  85. package/dist/utility/common/transformations.util.js +11 -0
  86. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  87. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  88. package/dist/utility/options/option-venue.util.d.ts +21 -3
  89. package/dist/utility/options/option-venue.util.js +30 -3
  90. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  91. package/dist/utility/wrun/derived-roots.util.d.ts +213 -0
  92. package/dist/utility/wrun/derived-roots.util.js +471 -0
  93. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +41 -6
  94. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  95. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  96. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  97. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +5 -3
  98. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +6 -4
  99. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +2 -2
  100. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +5 -1
  101. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  102. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  103. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  104. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  105. package/dist/utility/wrun/sources/row-lane-registry.js +3 -2
  106. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  107. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +9 -3
  108. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +15 -6
  109. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +14 -0
  110. package/dist/utility/wrun/sources/row-lanes/option_prints.js +82 -13
  111. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  112. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +55 -8
  113. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +95 -14
  114. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +5 -2
  115. package/dist/utility/wrun/sources/row-lanes/option_surface.js +7 -3
  116. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  117. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +35 -14
  118. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +70 -20
  119. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +64 -0
  120. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +89 -0
  121. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +45 -1
  122. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +114 -6
  123. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +56 -5
  124. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +224 -26
  125. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +822 -58
  126. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +16 -3
  127. package/dist/utility/wrun/wrun-batched-marks.util.js +30 -19
  128. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +37 -9
  129. package/dist/utility/wrun/wrun-batched-readout.util.js +61 -15
  130. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  131. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  132. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -0
  133. package/dist/utility/wrun/wrun-cell-capacity.leaf.d.ts +66 -0
  134. package/dist/utility/wrun/wrun-cell-capacity.leaf.js +86 -0
  135. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +192 -13
  136. package/dist/utility/wrun/wrun-chart-market-facts.util.js +437 -55
  137. package/dist/utility/wrun/wrun-color-facts.util.d.ts +19 -9
  138. package/dist/utility/wrun/wrun-color-facts.util.js +24 -14
  139. package/dist/utility/wrun/wrun-color-settings.util.d.ts +15 -4
  140. package/dist/utility/wrun/wrun-color-settings.util.js +31 -12
  141. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.d.ts +17 -0
  142. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.js +9 -0
  143. package/dist/utility/wrun/wrun-download-meter.util.d.ts +107 -0
  144. package/dist/utility/wrun/wrun-download-meter.util.js +134 -0
  145. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  146. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  147. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  148. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  149. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +6 -1
  150. package/dist/utility/wrun/wrun-draft-overlay.util.js +23 -3
  151. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  152. package/dist/utility/wrun/wrun-frames.js +78 -15
  153. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +2 -2
  154. package/dist/utility/wrun/wrun-hosted-wire-caps.js +7 -0
  155. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  156. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  157. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +51 -21
  158. package/dist/utility/wrun/wrun-hud-looks.util.js +74 -28
  159. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  160. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +8 -6
  161. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +8 -6
  162. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -2
  163. package/dist/utility/wrun/wrun-live-intake.util.d.ts +19 -9
  164. package/dist/utility/wrun/wrun-live-intake.util.js +213 -45
  165. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -0
  166. package/dist/utility/wrun/wrun-live-tick.util.js +246 -49
  167. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.d.ts +53 -0
  168. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.js +162 -0
  169. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +205 -48
  170. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +277 -34
  171. package/dist/utility/wrun/wrun-market-size-defaults.util.d.ts +51 -7
  172. package/dist/utility/wrun/wrun-market-size-defaults.util.js +340 -56
  173. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  174. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  175. package/dist/utility/wrun/wrun-option-prints.util.d.ts +41 -2
  176. package/dist/utility/wrun/wrun-option-prints.util.js +80 -13
  177. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  178. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  179. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +26 -6
  180. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +50 -11
  181. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +109 -19
  182. package/dist/utility/wrun/wrun-option-strike-flow.util.js +222 -61
  183. package/dist/utility/wrun/wrun-option-views.util.d.ts +96 -18
  184. package/dist/utility/wrun/wrun-option-views.util.js +246 -51
  185. package/dist/utility/wrun/wrun-options-stop.util.d.ts +2 -1
  186. package/dist/utility/wrun/wrun-options-stop.util.js +3 -2
  187. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  188. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  189. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +20 -0
  190. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +31 -14
  191. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +22 -0
  192. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  193. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  194. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +7 -0
  195. package/dist/utility/wrun/wrun-overlay-recovery.util.js +25 -1
  196. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +7 -1
  197. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  198. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +134 -37
  199. package/dist/utility/wrun/wrun-overlay-run.util.js +1118 -254
  200. package/dist/utility/wrun/wrun-pack-widths.leaf.d.ts +4 -4
  201. package/dist/utility/wrun/wrun-pack-widths.leaf.js +4 -4
  202. package/dist/utility/wrun/wrun-pack.util.d.ts +7 -3
  203. package/dist/utility/wrun/wrun-pack.util.js +20 -9
  204. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  205. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  206. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  207. package/dist/utility/wrun/wrun-panel-mount.util.js +63 -13
  208. package/dist/utility/wrun/wrun-panel-style.util.d.ts +37 -24
  209. package/dist/utility/wrun/wrun-panel-style.util.js +100 -29
  210. package/dist/utility/wrun/wrun-param-map.util.d.ts +15 -11
  211. package/dist/utility/wrun/wrun-param-map.util.js +13 -5
  212. package/dist/utility/wrun/wrun-param-values.util.d.ts +21 -3
  213. package/dist/utility/wrun/wrun-param-values.util.js +6 -0
  214. package/dist/utility/wrun/wrun-pin-spelling.util.js +12 -11
  215. package/dist/utility/wrun/wrun-prefix-lanes.util.js +2 -2
  216. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  217. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  218. package/dist/utility/wrun/wrun-refusal.util.js +10 -1
  219. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  220. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  221. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  222. package/dist/utility/wrun/wrun-run-interval.util.d.ts +4 -2
  223. package/dist/utility/wrun/wrun-run-interval.util.js +9 -6
  224. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +52 -1
  225. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  226. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  227. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  228. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  229. package/dist/utility/wrun/wrun-socket-row-source.js +113 -8
  230. package/dist/utility/wrun/wrun-source-rows.util.d.ts +9 -1
  231. package/dist/utility/wrun/wrun-source-rows.util.js +108 -43
  232. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  233. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  234. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  235. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  236. package/dist/utility/wrun/wrun-tape-per-order.util.js +26 -0
  237. package/dist/utility/wrun/wrun-tape-source.util.d.ts +126 -50
  238. package/dist/utility/wrun/wrun-tape-source.util.js +193 -68
  239. package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +7 -5
  240. package/dist/utility/wrun/wrun-volume-profile-lane.util.js +8 -6
  241. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  242. package/dist/utils/replay/replay-buffer-math.js +227 -20
  243. package/dist/workers/utils/volume-profile.worker.util.d.ts +4 -1
  244. package/dist/workers/utils/volume-profile.worker.util.js +5 -2
  245. package/dist/workers/wrun/wrun-abi-host.js +3 -2
  246. package/package.json +5 -5
@@ -6,15 +6,16 @@
6
6
  *
7
7
  * Resolution order (LK01, LK09): a word declared on the entry wins; then the
8
8
  * viewer's pick on the Style page; then the row of the author's look; then
9
- * today's look, untouched (an entry without a look resolves to no inline
10
- * style at all, byte for byte today's card).
9
+ * the `default` row (C4), whose surface and type are the stylesheet's
10
+ * (`data-look='default'`), read through the same variables.
11
11
  *
12
12
  * The look values travel as CSS custom properties on `.wrun-hud`
13
13
  * (`--wrun-hud-bg`, `--wrun-hud-radius`, ...); the card's base rules in
14
- * WrunHudLayer.vue read each one with today's value as the fallback, and
15
- * `src/styles/wrun-hud-looks.scss` holds only what a variable cannot carry
16
- * (frame parts, textures, letter case). Nothing here reads the DOM: the
17
- * palette a token resolves against is handed in by the caller.
14
+ * WrunHudLayer.vue read each one with a fallback, and
15
+ * `src/styles/wrun-hud-looks.scss` holds what a variable cannot carry
16
+ * (frame parts, textures, letter case) and the default look's values. Nothing
17
+ * here reads the DOM: the palette a token resolves against is handed in by
18
+ * the caller.
18
19
  *
19
20
  * Cost rules (LK10, D11 acceptance): no blur, no animation, no downloaded
20
21
  * font. The serif and rounded stacks are the foundation's system stacks.
@@ -124,6 +125,12 @@ export interface WrunHudLookRow {
124
125
  /** The split meter's rest: the theme's down colour, or the accent. */
125
126
  splitRest?: 'down' | 'accent';
126
127
  rowLeader?: WrunRowLeader;
128
+ /** The headline tile prints its label over the lead; false: on a titled card the title names the card
129
+ * and the headline prints none (the default look). */
130
+ headlineLabel?: boolean;
131
+ /** A rows tile leads a key with its output's colour swatch; false: the label alone, no dot that names
132
+ * no sign (the default look). */
133
+ rowSwatch?: boolean;
127
134
  /** Frame. */
128
135
  chrome: WrunHudChrome;
129
136
  /** The title ink on a `title_bar` chrome. */
@@ -131,23 +138,38 @@ export interface WrunHudLookRow {
131
138
  /** The `window` chrome's two-colour title bar. */
132
139
  windowBar?: [string, string];
133
140
  texture: WrunHudTexture;
134
- /** A home look keeps its paper in both themes; an adaptive one resolves
135
- * tokens per theme and may name a light variant. A home look may name one
136
- * too, to keep its paper legible over a light chart (cockpit: the same
137
- * slate, opaque, with stronger labels). */
141
+ /** A home look keeps its own paper (its colours are the look's, never the
142
+ * app theme's); an adaptive one resolves tokens per theme and may name a
143
+ * light variant. A home look whose paper is dark names one too: over a
144
+ * light chart it wears that light paper, ink, rules and accent instead of
145
+ * sitting black on the chart (OPRA QA 2026-10-22: the inline paper beats
146
+ * the light rule of the stylesheet, which covers the default look alone;
147
+ * wrun-hud-looks.util.spec.ts fails a dark home row without one). A light
148
+ * paper needs none: it reads on both charts. Cockpit's variant keeps its
149
+ * slate on purpose (opaque, with stronger labels: template QA C17). */
138
150
  home: boolean;
151
+ /** What the look wears over a light chart, each word in place of the row's own. */
139
152
  light?: {
140
153
  background?: string;
154
+ /** A vertical gradient's stops (stage's wash). */
155
+ backgroundGradient?: string[];
141
156
  borderColor?: string;
142
157
  textColor?: string;
158
+ /** The label ink (terminal's amber labels go a dark amber on white). */
159
+ labelTextColor?: string;
160
+ /** The accent: a bright accent made for a dark paper reads too faint on a light one. */
161
+ accentColor?: string;
143
162
  /** The tiles' label opacity (`--wrun-hud-label-opacity`, 0.55 when absent);
144
163
  * at least WRUN_HUD_LIGHT_LABEL_OPACITY_MIN. */
145
164
  labelOpacity?: number;
165
+ /** The text halo: a glow is a dark paper's effect and smudges the glyphs on a light one. */
166
+ textGlow?: number;
146
167
  };
147
168
  }
148
- /** The frozen look table (g3 addendum, "The look table"). `default` is
149
- * today's card: the g3 HUD defaults with the g3 drawings (arc, line, bar,
150
- * capsule), adaptive. Where the table names no accent and the look's mock
169
+ /** The frozen look table (g3 addendum, "The look table"). `default` is the
170
+ * house look (C4), worn by every card without a look word: sentence case,
171
+ * pills as words, no row swatch, no label over a titled card's headline; its
172
+ * surface and type are the stylesheet's. Where the table names no accent and the look's mock
151
173
  * paints one colour throughout, the row carries that colour as its accent
152
174
  * (broadsheet newsprint ink, classic's navy, phosphor's green): without it
153
175
  * LK03 would hand the look the app's accent (glass keeps the app's: its
@@ -180,7 +202,7 @@ export interface WrunHudOffsetPx {
180
202
  /** What one entry resolves to: the words a tile and the layer read, and the
181
203
  * inline style of `.wrun-hud`. */
182
204
  export interface WrunHudResolvedStyle {
183
- /** The look in force (the viewer's pick, else the author's); absent = today's. */
205
+ /** The look in force: the viewer's pick, else the author's, else `default` (the resolver always sets it). */
184
206
  look?: WrunHudLook;
185
207
  authorLook?: WrunHudLook;
186
208
  viewerPick?: WrunHudLook;
@@ -198,6 +220,10 @@ export interface WrunHudResolvedStyle {
198
220
  sparkHeight?: number;
199
221
  sparkBaseline?: 'zero' | 'mark';
200
222
  rowLeader?: WrunRowLeader;
223
+ /** Present (false) when the look prints no label over a titled card's headline. */
224
+ headlineLabel?: false;
225
+ /** Present (false) when the look draws no colour swatch beside a row's key. */
226
+ rowSwatch?: false;
201
227
  /** DW22: the declared offset the `css` carries as `left`/`top`; the layer
202
228
  * clamps it into the pane (item 29). Absent without a valid offset. */
203
229
  offset?: WrunHudOffsetPx;
@@ -217,26 +243,30 @@ export declare function wrunHudOffsetCss(offset: WrunHudOffsetPx): Record<string
217
243
  * (an invisible card must never trap a click meant for the chart). */
218
244
  export declare function wrunHudPointerFree(style: Pick<WrunHudResolvedStyle, 'opacity'>): boolean;
219
245
  /**
220
- * The style of one HUD entry: declared word > viewer pick > look row >
221
- * today's (LK01, LK09). Every value lands in `css` as a custom property the
222
- * card's base rules read (today's value is each rule's fallback), so an
223
- * entry without a look and without a word resolves to an empty style.
246
+ * The style of one HUD entry: declared word > viewer pick > look row, the
247
+ * `default` row when neither the viewer nor the author named a look (LK01,
248
+ * LK09, C4). Every value lands in `css` as a custom property the card's base
249
+ * rules read, so an entry without a look and without a word resolves to an
250
+ * empty `css`: the default look's surface and type are the stylesheet's.
224
251
  */
225
252
  export declare function resolveWrunHudLook(entry: WrunHudStyleEntry, options?: WrunHudResolveOptions): WrunHudResolvedStyle;
226
253
  /** The look defaults one tile takes when it declares none (LK04 draw, LK05
227
- * height, the signal zero line, the broadsheet row leaders). */
254
+ * height, the signal zero line, the broadsheet row leaders, the default
255
+ * look's rows without swatches). */
228
256
  export interface WrunHudTileLookDefaults {
229
257
  draw?: string;
230
258
  height?: number;
231
259
  baseline?: number;
232
260
  leader?: WrunRowLeader;
261
+ /** Rows: the look draws no swatch beside a key. */
262
+ swatch?: false;
233
263
  }
234
264
  /**
235
265
  * The defaults the look in force gives a tile of `kind` (undefined fields
236
- * keep today's drawing). `cardMark` is the card's first meter mark, the
266
+ * keep the kit's own drawing). `cardMark` is the card's first meter mark, the
237
267
  * baseline spark bars grow from on a look that says so.
238
268
  */
239
- export declare function wrunHudTileLookDefaults(style: Pick<WrunHudResolvedStyle, 'draws' | 'sparkHeight' | 'sparkBaseline' | 'rowLeader'>, kind: WrunHoverBlock['kind'], cardMark?: number): WrunHudTileLookDefaults;
269
+ export declare function wrunHudTileLookDefaults(style: Pick<WrunHudResolvedStyle, 'draws' | 'sparkHeight' | 'sparkBaseline' | 'rowLeader' | 'rowSwatch'>, kind: WrunHoverBlock['kind'], cardMark?: number): WrunHudTileLookDefaults;
240
270
  /** The luminance of a palette's background, read as a light theme above
241
271
  * 0.5; an unreadable colour counts as dark (the chart's default). */
242
272
  export declare function wrunHudThemeIsLight(theme: WrunColorTheme | undefined): boolean;
@@ -71,7 +71,8 @@ export const WRUN_HUD_RINGS_HEIGHT_PX = 86;
71
71
  export const WRUN_HUD_RING_STRENGTHS = [1, 0.7, 0.45];
72
72
  const WRUN_HUD_DEFAULT_CHROME = 'card';
73
73
  const WRUN_HUD_DEFAULT_TEXTURE = 'none';
74
- /** Today's title is uppercase and labels keep their case (LK06). */
74
+ /** A look that names no case prints its title uppercase and keeps its labels' case (LK06); the default
75
+ * look names `none` (sentence case). */
75
76
  const WRUN_HUD_DEFAULT_TITLE_CASE = 'upper';
76
77
  const WRUN_HUD_DEFAULT_LABEL_CASE = 'none';
77
78
  export function isWrunHudLook(value) {
@@ -95,21 +96,29 @@ export function wrunBlockDraw(kind, value) {
95
96
  const draws = WRUN_BLOCK_DRAWS[kind];
96
97
  return typeof value === 'string' && draws !== undefined && draws.includes(value) ? value : undefined;
97
98
  }
98
- const TODAY = {
99
+ /** The bare card: no surface, type or frame word of its own. */
100
+ const BARE_ROW = {
99
101
  draws: {},
100
102
  chrome: 'card',
101
103
  texture: 'none',
102
104
  home: false,
103
105
  };
104
- /** The frozen look table (g3 addendum, "The look table"). `default` is
105
- * today's card: the g3 HUD defaults with the g3 drawings (arc, line, bar,
106
- * capsule), adaptive. Where the table names no accent and the look's mock
106
+ /** The frozen look table (g3 addendum, "The look table"). `default` is the
107
+ * house look (C4), worn by every card without a look word: sentence case,
108
+ * pills as words, no row swatch, no label over a titled card's headline; its
109
+ * surface and type are the stylesheet's. Where the table names no accent and the look's mock
107
110
  * paints one colour throughout, the row carries that colour as its accent
108
111
  * (broadsheet newsprint ink, classic's navy, phosphor's green): without it
109
112
  * LK03 would hand the look the app's accent (glass keeps the app's: its
110
113
  * mock's reds and greens are reading tones, not an accent). */
111
114
  export const WRUN_HUD_LOOK_TABLE = {
112
- default: { ...TODAY, draws: { gauge: 'arc', spark: 'line', meter: 'bar', pill: 'capsule' } },
115
+ default: {
116
+ ...BARE_ROW,
117
+ titleCase: 'none',
118
+ draws: { gauge: 'arc', spark: 'line', meter: 'bar', pill: 'text' },
119
+ headlineLabel: false,
120
+ rowSwatch: false,
121
+ },
113
122
  glass: {
114
123
  background: '#1c1c1ee6',
115
124
  borderColor: '#ffffff29',
@@ -139,6 +148,14 @@ export const WRUN_HUD_LOOK_TABLE = {
139
148
  chrome: 'cover',
140
149
  texture: 'none',
141
150
  home: true,
151
+ /** Over a light chart the green wash fades into a light paper, the type goes ink (15:1) and the green
152
+ * deepens so the 30 px headline still reads (3.8:1 on the wash, 4.4:1 on the paper). */
153
+ light: {
154
+ backgroundGradient: ['#d3eedd', '#eaf6ee', '#f6f6f6', '#f6f6f6'],
155
+ textColor: '#121212',
156
+ accentColor: '#13853d',
157
+ labelOpacity: 0.75,
158
+ },
142
159
  },
143
160
  signal: {
144
161
  background: '#000000',
@@ -155,6 +172,8 @@ export const WRUN_HUD_LOOK_TABLE = {
155
172
  chrome: 'card',
156
173
  texture: 'none',
157
174
  home: true,
175
+ /** Over a light chart the same slab in white: black type, a hairline edge (labels at 0.55 read 4.8:1). */
176
+ light: { background: '#ffffff', borderColor: '#e3e3e3', textColor: '#000000' },
158
177
  },
159
178
  terminal: {
160
179
  background: '#000000',
@@ -173,6 +192,17 @@ export const WRUN_HUD_LOOK_TABLE = {
173
192
  titleBarInk: '#000000',
174
193
  texture: 'none',
175
194
  home: true,
195
+ /** Over a light chart (the OPRA cards, QA 2026-10-22): white paper, black type, a grey frame, the labels a
196
+ * dark amber at 0.8 (4.7:1), and the title bar a deeper amber that still takes its black ink (6.1:1) and
197
+ * inks the headline at 3.4:1 (bold 22 px). */
198
+ light: {
199
+ background: '#ffffff',
200
+ borderColor: '#b8b8b8',
201
+ textColor: '#000000',
202
+ labelTextColor: '#7a4700',
203
+ accentColor: '#c77800',
204
+ labelOpacity: 0.8,
205
+ },
176
206
  },
177
207
  broadsheet: {
178
208
  background: '#F6F1E7',
@@ -266,6 +296,9 @@ export const WRUN_HUD_LOOK_TABLE = {
266
296
  chrome: 'none',
267
297
  texture: 'scanlines',
268
298
  home: true,
299
+ /** Over a light chart a pale green paper with the phosphor printed in a deep green (7.4:1), labels at 0.8
300
+ * (4.6:1), no glow; the scanlines stay. */
301
+ light: { background: '#eef7f0', textColor: '#0b5d27', accentColor: '#0b5d27', labelOpacity: 0.8, textGlow: 0 },
269
302
  },
270
303
  classic: {
271
304
  background: '#C0C0C0',
@@ -344,8 +377,9 @@ export function wrunHudPointerFree(style) {
344
377
  return style.opacity !== undefined && style.opacity < WRUN_HUD_POINTER_FREE_OPACITY;
345
378
  }
346
379
  /** The card's background: a declared colour (at its declared opacity), a
347
- * declared gradient, else the look's; a declared opacity alone dims today's
348
- * surface. Undefined keeps today's rule. */
380
+ * declared gradient, else the look's (its light variant's paper over a light
381
+ * chart); a declared opacity alone dims today's surface. Undefined keeps
382
+ * today's rule. */
349
383
  function backgroundCss(entry, row, light, theme) {
350
384
  const direction = entry.gradient_direction === 'horizontal' ? 'to right' : 'to bottom';
351
385
  const gradient = Array.isArray(entry.background_gradient)
@@ -355,39 +389,44 @@ function backgroundCss(entry, row, light, theme) {
355
389
  return `linear-gradient(${direction}, ${gradient.map((stop) => paint(stop, theme)).join(', ')})`;
356
390
  }
357
391
  const opacity = numberIn(entry.background_opacity, 0, 1);
358
- const lookBackground = light && row.light?.background !== undefined ? row.light.background : row.background;
392
+ const variant = light ? row.light : undefined;
393
+ const lookBackground = variant?.background ?? row.background;
359
394
  const color = colorWord(entry.background_color) ?? lookBackground;
360
395
  if (color !== undefined) {
361
396
  const painted = paint(color, theme);
362
397
  return opacity === undefined ? painted : withShare(painted, opacity);
363
398
  }
364
- if (row.backgroundGradient !== undefined && row.backgroundGradient.length >= 2) {
365
- return `linear-gradient(to bottom, ${row.backgroundGradient.map((stop) => paint(stop, theme)).join(', ')})`;
399
+ const lookGradient = variant?.backgroundGradient ?? row.backgroundGradient;
400
+ if (lookGradient !== undefined && lookGradient.length >= 2) {
401
+ return `linear-gradient(to bottom, ${lookGradient.map((stop) => paint(stop, theme)).join(', ')})`;
366
402
  }
367
403
  if (opacity !== undefined)
368
404
  return `color-mix(in srgb, var(--tooltip-bg, #17171c) ${Math.round(opacity * 100)}%, transparent)`;
369
405
  return undefined;
370
406
  }
371
407
  /**
372
- * The style of one HUD entry: declared word > viewer pick > look row >
373
- * today's (LK01, LK09). Every value lands in `css` as a custom property the
374
- * card's base rules read (today's value is each rule's fallback), so an
375
- * entry without a look and without a word resolves to an empty style.
408
+ * The style of one HUD entry: declared word > viewer pick > look row, the
409
+ * `default` row when neither the viewer nor the author named a look (LK01,
410
+ * LK09, C4). Every value lands in `css` as a custom property the card's base
411
+ * rules read, so an entry without a look and without a word resolves to an
412
+ * empty `css`: the default look's surface and type are the stylesheet's.
376
413
  */
377
414
  export function resolveWrunHudLook(entry, options = {}) {
378
415
  const { theme } = options;
379
416
  const authorLook = isWrunHudLook(entry.look) ? entry.look : undefined;
380
417
  const viewerPick = isWrunHudLook(options.viewerPick) ? options.viewerPick : undefined;
381
- const look = viewerPick ?? authorLook;
382
- const row = look === undefined ? TODAY : WRUN_HUD_LOOK_TABLE[look];
418
+ const look = viewerPick ?? authorLook ?? 'default';
419
+ const row = WRUN_HUD_LOOK_TABLE[look];
383
420
  const light = options.light === true;
421
+ // Over a light chart the look's light variant stands in for its paper, ink, rules and accent word by word; on a
422
+ // dark chart there is none, so every word below reads the row as it always did.
423
+ const variant = light ? row.light : undefined;
384
424
  const css = {};
385
425
  // Surface
386
426
  const background = backgroundCss(entry, row, light, theme);
387
427
  if (background !== undefined)
388
428
  css['--wrun-hud-bg'] = background;
389
- const borderColor = colorWord(entry.border_color) ??
390
- (light && row.light?.borderColor !== undefined ? row.light.borderColor : row.borderColor);
429
+ const borderColor = colorWord(entry.border_color) ?? variant?.borderColor ?? row.borderColor;
391
430
  if (borderColor !== undefined)
392
431
  css['--wrun-hud-border-color'] = paint(borderColor, theme);
393
432
  const borderWidth = numberIn(entry.border_width, 0, WRUN_MAX_HUD_BORDER_WIDTH_PX) ?? row.borderWidth;
@@ -425,14 +464,15 @@ export function resolveWrunHudLook(entry, options = {}) {
425
464
  // A look with its own ink prints its title, labels and tracks in it (the
426
465
  // app's muted and secondary inks belong to the app theme, not the paper);
427
466
  // a declared text_color recolours the text alone (DW22).
428
- const lookTextColor = light && row.light?.textColor !== undefined ? row.light.textColor : row.textColor;
467
+ const lookTextColor = variant?.textColor ?? row.textColor;
429
468
  const lookInk = lookTextColor === undefined ? undefined : paint(lookTextColor, theme);
430
469
  if (lookInk !== undefined) {
431
470
  css['--wrun-hud-title-ink'] = lookInk;
432
- css['--wrun-hud-label-ink'] = row.labelTextColor === undefined ? lookInk : paint(row.labelTextColor, theme);
471
+ const labelTextColor = variant?.labelTextColor ?? row.labelTextColor;
472
+ css['--wrun-hud-label-ink'] = labelTextColor === undefined ? lookInk : paint(labelTextColor, theme);
433
473
  css['--wrun-hud-track'] = withShare(lookInk, 0.15);
434
474
  }
435
- const labelOpacity = light ? row.light?.labelOpacity : undefined;
475
+ const labelOpacity = variant?.labelOpacity;
436
476
  if (labelOpacity !== undefined)
437
477
  css['--wrun-hud-label-opacity'] = String(labelOpacity);
438
478
  const declaredInk = colorWord(entry.text_color);
@@ -447,15 +487,17 @@ export function resolveWrunHudLook(entry, options = {}) {
447
487
  const headlineWeight = wrunFontWeightCss(row.headlineFontWeight);
448
488
  if (headlineWeight !== undefined)
449
489
  css['--wrun-hud-headline-weight'] = String(headlineWeight);
450
- const textGlow = numberIn(entry.text_glow, 0, WRUN_MAX_HUD_TEXT_GLOW_PX) ?? row.textGlow ?? 0;
490
+ const textGlow = numberIn(entry.text_glow, 0, WRUN_MAX_HUD_TEXT_GLOW_PX) ?? variant?.textGlow ?? row.textGlow ?? 0;
451
491
  if (textGlow > 0)
452
492
  css['--wrun-hud-glow'] = `0 0 ${textGlow}px currentColor`;
453
- // Accent (LK03): a declared colour, the ladder's rung, the look's, else the
454
- // theme's for any look but `default` (today's marks keep the app accent).
493
+ // Accent (LK03): a declared colour, the ladder's rung, the look's (its light
494
+ // variant's over a light chart), else the theme's for any look but `default`
495
+ // (whose marks ink in the text colour).
455
496
  const accentWord = colorWord(entry.accent_color) ??
456
497
  accentRung(entry, options.snapshot) ??
498
+ variant?.accentColor ??
457
499
  row.accentColor ??
458
- ((look !== undefined && look !== 'default') || entry.accent_color_by !== undefined ? 'theme.accent' : undefined);
500
+ (look !== 'default' || entry.accent_color_by !== undefined ? 'theme.accent' : undefined);
459
501
  const accent = accentWord === undefined ? undefined : paint(accentWord, theme);
460
502
  if (accent !== undefined) {
461
503
  css['--wrun-hud-accent'] = accent;
@@ -469,7 +511,7 @@ export function resolveWrunHudLook(entry, options = {}) {
469
511
  `linear-gradient(90deg, ${row.windowBar.map((stop) => paint(stop, theme)).join(', ')})`;
470
512
  }
471
513
  return {
472
- ...(look !== undefined ? { look } : {}),
514
+ look,
473
515
  ...(authorLook !== undefined ? { authorLook } : {}),
474
516
  ...(viewerPick !== undefined ? { viewerPick } : {}),
475
517
  ...(fontFamily !== undefined ? { fontFamily } : {}),
@@ -485,6 +527,8 @@ export function resolveWrunHudLook(entry, options = {}) {
485
527
  ...(row.sparkHeight !== undefined ? { sparkHeight: row.sparkHeight } : {}),
486
528
  ...(row.sparkBaseline !== undefined ? { sparkBaseline: row.sparkBaseline } : {}),
487
529
  ...(row.rowLeader !== undefined ? { rowLeader: row.rowLeader } : {}),
530
+ ...(row.headlineLabel === false ? { headlineLabel: false } : {}),
531
+ ...(row.rowSwatch === false ? { rowSwatch: false } : {}),
488
532
  ...(offset !== undefined ? { offset } : {}),
489
533
  ...(opacity !== undefined ? { opacity } : {}),
490
534
  css,
@@ -502,7 +546,7 @@ const FALLBACK_THEME = {
502
546
  };
503
547
  /**
504
548
  * The defaults the look in force gives a tile of `kind` (undefined fields
505
- * keep today's drawing). `cardMark` is the card's first meter mark, the
549
+ * keep the kit's own drawing). `cardMark` is the card's first meter mark, the
506
550
  * baseline spark bars grow from on a look that says so.
507
551
  */
508
552
  export function wrunHudTileLookDefaults(style, kind, cardMark) {
@@ -521,6 +565,8 @@ export function wrunHudTileLookDefaults(style, kind, cardMark) {
521
565
  }
522
566
  if (kind === 'rows' && style.rowLeader !== undefined)
523
567
  defaults.leader = style.rowLeader;
568
+ if (kind === 'rows' && style.rowSwatch === false)
569
+ defaults.swatch = false;
524
570
  return defaults;
525
571
  }
526
572
  /** The luminance of a palette's background, read as a light theme above
@@ -16,4 +16,15 @@ export interface WrunLatestSnapshot {
16
16
  /** The init() arguments the run computed with, one per sheet param in sheet order (the
17
17
  * rig's proof that a dialog edit reached the module). Absent on a tick republish. */
18
18
  initArgs?: number[];
19
+ /** A full run the host refused by name (a lane unserved on this market, a budget, a plan): the card shows this
20
+ * sentence instead of its tiles. Absent on a served run. `reason` is the refusal row's key, `sentence` the
21
+ * user-facing chip text. */
22
+ refused?: {
23
+ reason: string;
24
+ sentence: string;
25
+ };
26
+ /** The Style targets the applied run drew nothing for (the run result's `emptyTargets`): the Style page draws
27
+ * their lines dimmed with the reason (WrunLayoutPanel). A republish that built no result (a landed pan page)
28
+ * carries the last one's forward. Absent when every judged target drew. */
29
+ emptyTargets?: string[];
19
30
  }
@@ -1,17 +1,18 @@
1
1
  /**
2
2
  * The browser-run wrun overlay runtime that the chart's boot graph reaches only through
3
3
  * `wrun-overlay-lifecycle.lazy.ts`: the lifecycle door (with the recovery ladders and the replay
4
- * lane behind it) and the live tick lane, and through them the run pass. None of it can do
5
- * anything for an overlay without a driver, and only the wrun loaders register drivers (behind the
6
- * Indicators gate), so this graph stays out of the pre-candle closure and evaluates with the first
7
- * loader instead.
4
+ * lane behind it), the live tick lane and the live intake's market rule and gap mark (with the row
5
+ * builder and the source lanes the intake reads), and through them the run pass. None of it can do
6
+ * anything for an overlay without a driver or a live session, and only the wrun loaders register
7
+ * drivers (behind the Indicators gate) and run the pass that opens a session, so this graph stays
8
+ * out of the pre-candle closure and evaluates with the first loader instead.
8
9
  *
9
10
  * The loaders import this module statically and bind it (`bindWrunLifecycleRuntime`) before they
10
11
  * register a driver. Two things follow, and both must hold before any driver exists:
11
12
  * - the import-time registrations of these modules (the door's compute-succeeded and teardown
12
13
  * hooks, the recovery ladders' hooks, the replay lane's teardown, the live tick's drain
13
- * requester, teardown hook and rows identity reader) are in place, exactly as when they
14
- * evaluated at boot;
14
+ * requester, teardown hook and rows identity reader, the live intake's teardown hook, the
15
+ * poll-lane registry's peer bind) are in place, exactly as when they evaluated at boot;
15
16
  * - the boot-side accessor answers synchronously for a driver id, so a trigger runs in the same
16
17
  * turn as before.
17
18
  *
@@ -19,3 +20,4 @@
19
20
  */
20
21
  export { healWrunOverlayIfIdle, pauseWrunOverlay, requestWrunOverlayRerun, requestWrunOverlayRerunsForChart, resumeWrunOverlay, resyncWrunOverlayAfterWake, } from './wrun-overlay-lifecycle.util.js';
21
22
  export { feedWrunRideBookRows, scheduleWrunOverlayLiveTick } from './wrun-live-tick.util.js';
23
+ export { markWrunLiveGap, wrunLiveFrameMarketAdmitted } from './wrun-live-intake.util.js';
@@ -1,17 +1,18 @@
1
1
  /**
2
2
  * The browser-run wrun overlay runtime that the chart's boot graph reaches only through
3
3
  * `wrun-overlay-lifecycle.lazy.ts`: the lifecycle door (with the recovery ladders and the replay
4
- * lane behind it) and the live tick lane, and through them the run pass. None of it can do
5
- * anything for an overlay without a driver, and only the wrun loaders register drivers (behind the
6
- * Indicators gate), so this graph stays out of the pre-candle closure and evaluates with the first
7
- * loader instead.
4
+ * lane behind it), the live tick lane and the live intake's market rule and gap mark (with the row
5
+ * builder and the source lanes the intake reads), and through them the run pass. None of it can do
6
+ * anything for an overlay without a driver or a live session, and only the wrun loaders register
7
+ * drivers (behind the Indicators gate) and run the pass that opens a session, so this graph stays
8
+ * out of the pre-candle closure and evaluates with the first loader instead.
8
9
  *
9
10
  * The loaders import this module statically and bind it (`bindWrunLifecycleRuntime`) before they
10
11
  * register a driver. Two things follow, and both must hold before any driver exists:
11
12
  * - the import-time registrations of these modules (the door's compute-succeeded and teardown
12
13
  * hooks, the recovery ladders' hooks, the replay lane's teardown, the live tick's drain
13
- * requester, teardown hook and rows identity reader) are in place, exactly as when they
14
- * evaluated at boot;
14
+ * requester, teardown hook and rows identity reader, the live intake's teardown hook, the
15
+ * poll-lane registry's peer bind) are in place, exactly as when they evaluated at boot;
15
16
  * - the boot-side accessor answers synchronously for a driver id, so a trigger runs in the same
16
17
  * turn as before.
17
18
  *
@@ -19,3 +20,4 @@
19
20
  */
20
21
  export { healWrunOverlayIfIdle, pauseWrunOverlay, requestWrunOverlayRerun, requestWrunOverlayRerunsForChart, resumeWrunOverlay, resyncWrunOverlayAfterWake, } from './wrun-overlay-lifecycle.util.js';
21
22
  export { feedWrunRideBookRows, scheduleWrunOverlayLiveTick } from './wrun-live-tick.util.js';
23
+ export { markWrunLiveGap, wrunLiveFrameMarketAdmitted } from './wrun-live-intake.util.js';
@@ -65,12 +65,14 @@ export interface WrunRunSettledEvent {
65
65
  /** A failed run's identity (its window and settings), set by the run's settle producer. */
66
66
  failedIdentity?: WrunRunFailedIdentity;
67
67
  }
68
- /** One secondary lane a run treated as empty instead of failing the run. */
68
+ /** One secondary lane a run treated as empty instead of failing the run, or (cause `filling`) one that drew its
69
+ * first-paint slice alone while the rest of its window is still out: a planned fill, never a failure, which the
70
+ * source ladder adopts without spending an attempt (wrun-overlay-recovery.util). */
69
71
  export interface WrunDegradedLane {
70
72
  lane: string;
71
73
  /** The source type name the kScript degrade registry and its chips use. */
72
74
  kType: string;
73
75
  label: string;
74
- cause: 'budget' | 'declined' | 'empty' | 'error';
76
+ cause: 'budget' | 'declined' | 'empty' | 'error' | 'filling';
75
77
  retryable: boolean;
76
78
  }
@@ -43,13 +43,21 @@ export interface WrunLiveFrame {
43
43
  /** The frame's coin (its series' underlying), when the fan-out names it: a row lane fed by coin admits by it
44
44
  * (else the point's own `series.coin`). */
45
45
  incomingCoin?: string;
46
- /** Rider rows already floored by roundObTimestamp: never re-bucket. */
46
+ /** Rider rows already keyed on their bar (`bookLiveBucketRows`): never re-bucket. */
47
47
  bucketed?: boolean;
48
48
  }
49
49
  export type WrunLiveIntakeVerdict = 'queued' | 'ignored:no-context' | 'ignored:foreign' | 'ignored:undeclared' | 'ignored:replaying' | 'ignored:ineligible' | 'ignored:generation'
50
- /** A raw print below the tape acquisition's `minSize`: it can never fold (the kScript fan-out's
51
- * floor), so it takes no queue slot and arms no drain. */
50
+ /** A raw print below the tape acquisition's floor (its `minSize`, or its dollar value below its
51
+ * `minValue`): it can never fold, so it takes no queue slot and arms no drain. */
52
52
  | 'ignored:below-floor'
53
+ /** A print on a dollar tape (`minValue`, C-DOLLAR) whose market's dollar unit the run head could not
54
+ * prove: no live print is valued by a guess, so none folds (the history still serves the gateway's
55
+ * own dollar values). */
56
+ | 'ignored:value-unproven'
57
+ /** A print of a per-order tape held by its order gate (`wrunTapePerOrder`, live-trades-order-gate.util):
58
+ * queued with every fill of its order once the order is judged at or above the floor (the gate wakes
59
+ * the drain then), turned away whole, each fill `ignored:below-floor`, when it falls short. */
60
+ | 'held'
53
61
  /** The tick's own verdict: the overlay is paused or its execution guard tripped. */
54
62
  | 'ignored:paused';
55
63
  /** `pinned-close`: a pinned coarser leg's candle closed (armed by the tick
@@ -170,7 +178,8 @@ export type WrunLiveBucketMarket = {
170
178
  * open (a week bucket is its Monday, the main path's `findMonday`; a month,
171
179
  * quarter, half or year bucket its UTC calendar boundary), except
172
180
  * the book, whose snapshots are stamped at the observation and an exact
173
- * boundary belongs to the PREVIOUS bar (`roundObTimestamp`, the rule the
181
+ * boundary belongs to the PREVIOUS bar, on the CME session lattice its
182
+ * history rides on a CME Group `market` (`bookLiveBucketMs`, the rule the
174
183
  * K_ORDERBOOK lane and the rider projection apply), and a session-lattice
175
184
  * lane on a `market`, which keys the bar its fetched rows have through the
176
185
  * chart's one live boundary rule (`liveBucketStartMs`: the Chicago session
@@ -213,11 +222,12 @@ export declare function wrunLiveOhlcvPoint(point: unknown): {
213
222
  * leg on the session lattice). Never mutates its inputs.
214
223
  */
215
224
  export declare function foldWrunLegCandleRows(base: ReadonlyArray<ArrayLike<number>>, points: readonly unknown[], intervalMs: number, market?: WrunLiveBucketMarket | null): FoldResult | null;
216
- /** K_ORDERBOOK.buildLiveDataRows over a raw frame: replay bursts floor
217
- * every row (copied), a live snapshot floors its one row (copied); a
218
- * bucketed row (`ArrayLike<number>`) is taken as-is. Frames without a
219
- * book payload yield nothing. */
220
- export declare function wrunLiveBookRows(point: WrunLiveBookPoint, intervalMs: number): ArrayLike<number>[];
225
+ /** K_ORDERBOOK.buildLiveDataRows over a raw frame: replay bursts key
226
+ * every row (copied), a live snapshot keys its one row (copied), each on
227
+ * `market`'s bar (`bookLiveBucketMs`: the session lattice on a CME Group
228
+ * market); a bucketed row (`ArrayLike<number>`) is taken as-is. Frames
229
+ * without a book payload yield nothing. */
230
+ export declare function wrunLiveBookRows(point: WrunLiveBookPoint, intervalMs: number, market: WrunLiveBucketMarket | null | undefined): ArrayLike<number>[];
221
231
  /**
222
232
  * Fold queued points into a lane's rows under the lane's kScript fold rule.
223
233
  * Returns the NEW rows array (untouched rows shared, touched rows new), the