@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
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The tuple widths a host's own row lanes serve, the table the packer counts `max_cells` in (wrun-pack.util
3
+ * `wrunCellTupleWidths`). The row-lane registry registers it at its own evaluation and in its spec hook
4
+ * (sources/row-lane-registry.ts); the packer reads it at pack time and re-exports the register function.
5
+ *
6
+ * A LEAF on purpose (no imports): the registry rides the code parsed before the first candle (the requirement leaf
7
+ * reads row lanes for the chart store), the packer does not (tests/utility/wrun/wrun-door.closure.spec.ts), so the
8
+ * registration seam lives here and the registry never loads the packer. One table: a run that loads the packer later
9
+ * reads the widths the registry registered at boot.
10
+ */
11
+ /** Replace the registered row-lane tuple widths (web: src/utility/wrun/sources/row-lane-registry.ts, at load and in
12
+ * its spec hook). */
13
+ export declare function registerWrunRowLaneTupleWidths(widths: Readonly<Record<string, number>>): void;
14
+ /** The row-lane tuple widths registered now, read at call time (the packer reads them per pack). */
15
+ export declare function wrunRegisteredRowLaneTupleWidths(): Readonly<Record<string, number>>;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The tuple widths a host's own row lanes serve, the table the packer counts `max_cells` in (wrun-pack.util
3
+ * `wrunCellTupleWidths`). The row-lane registry registers it at its own evaluation and in its spec hook
4
+ * (sources/row-lane-registry.ts); the packer reads it at pack time and re-exports the register function.
5
+ *
6
+ * A LEAF on purpose (no imports): the registry rides the code parsed before the first candle (the requirement leaf
7
+ * reads row lanes for the chart store), the packer does not (tests/utility/wrun/wrun-door.closure.spec.ts), so the
8
+ * registration seam lives here and the registry never loads the packer. One table: a run that loads the packer later
9
+ * reads the widths the registry registered at boot.
10
+ */
11
+ /** The registered tuple widths by source class (web: each row-lane descriptor's `width`); empty until a registry
12
+ * registers, so a host without row lanes packs with the shared host's table alone. */
13
+ let laneTupleWidths = Object.freeze({});
14
+ /** Replace the registered row-lane tuple widths (web: src/utility/wrun/sources/row-lane-registry.ts, at load and in
15
+ * its spec hook). */
16
+ export function registerWrunRowLaneTupleWidths(widths) {
17
+ laneTupleWidths = Object.freeze({ ...widths });
18
+ }
19
+ /** The row-lane tuple widths registered now, read at call time (the packer reads them per pack). */
20
+ export function wrunRegisteredRowLaneTupleWidths() {
21
+ return laneTupleWidths;
22
+ }
@@ -11,14 +11,20 @@
11
11
  *
12
12
  * Cell enforcement runs HERE, during packing and before any worker is
13
13
  * involved: a block on an input not declared `cellType: "array"` and a block
14
- * over the input's `max_cells` (counted in TUPLES) both refuse the whole
15
- * evaluation by name, never truncate. One exception (frozen authoring
14
+ * over the input's capacity in the run's module (the sheet's `capacity`, else its
15
+ * `max_cells`, counted in TUPLES, at the input's own width: its class's, or the width
16
+ * its words make, `wrunOptionInputTupleWidth`; a print class's union whole only in a
17
+ * module whose capacity holds it, `wrunSheetCellBlockTuples`) both refuse the whole
18
+ * evaluation by name, never truncate, and so does a capacity no build writes
19
+ * (`wrun_cell_capacity_invalid`). One exception (frozen authoring
16
20
  * contract C1.2b): an input declaring `missing: "empty"` reads an oversize
17
21
  * block as a PRESENT EMPTY block (0 cells) on that bar alone and the run
18
22
  * goes on, the way the same input reads a lane that answered nothing; the
19
23
  * block is still never truncated.
20
24
  */
21
25
  import type { WrunAbiVersion, WrunIndicatorMetadata, WrunOutputRow, WrunPackedRunRequest, WrunWorkerResponse } from '../../interfaces/wrun-runtime.interface.js';
26
+ export { registerWrunRowLaneTupleWidths } from './wrun-pack-widths.leaf.js';
27
+ export { WRUN_CELL_CAPACITY_INVALID_CODE, wrunCellBlockTuples, wrunCellCapacityIssue, wrunCellReadCapacity, wrunModuleCellCapacity, wrunSheetCellBlockTuples, } from './wrun-cell-capacity.leaf.js';
22
28
  /** One runtime input row: `values` is the positional scalar block (celled
23
29
  * slots carry NaN placeholders); `cellBlocks` maps a celled input index to
24
30
  * that bar's flat f64 cell array. An index with no entry is a missing block
@@ -31,17 +37,16 @@ export interface WrunInputRow {
31
37
  values: number[];
32
38
  cellBlocks?: Map<number, number[]>;
33
39
  }
34
- /** Replace the registered row-lane tuple widths (web: src/utility/wrun/sources/row-lane-registry.ts, at load and in
35
- * its spec hook). */
36
- export declare function registerWrunRowLaneTupleWidths(widths: Readonly<Record<string, number>>): void;
37
40
  /** Cell tuple widths per celled source class (f64 cells per source tuple), the shared host's table
38
41
  * (`WRUN_HOST_CELL_TUPLE_WIDTHS`): `volume_profile` = [low, high, buy, sell]; `book` = [price,
39
42
  * abs(size), side]; `tape` = [offset_ms, price, size, side]; `trade_volume_by_size` = [bucket,
40
43
  * buy_usd, sell_usd, buy_count, sell_count]; `intrabar` and `candles` = [offset_ms, open, high,
41
44
  * low, close, volume]; `options_chain` = [strike, expiry_ms, side, oi, gamma, delta, mark_iv,
42
- * underlying, multiplier, vega]; and each registered row lane's own (`registerWrunRowLaneTupleWidths`:
43
- * the class a host serves through a descriptor, before or after the kit names it). Read at pack
44
- * time: a run loaded the host first. `max_cells` counts tuples; the packed byte math counts f64s. */
45
+ * underlying, multiplier, vega]; and each registered row lane's own (`registerWrunRowLaneTupleWidths`,
46
+ * wrun-pack-widths.leaf: the class a host serves through a descriptor, before or after the kit names
47
+ * it, so a new lane needs no row in the kit's table). Read at pack time: a run loaded the host first,
48
+ * and the registry registered its lanes at its own evaluation, however late this module loads.
49
+ * `max_cells` counts tuples; the packed byte math counts f64s. */
45
50
  export declare function wrunCellTupleWidths(): Readonly<Record<string, number>>;
46
51
  /** The frozen refusal for a block over its input's `max_cells` (the om contract's code, every
47
52
  * host): the evaluation is refused, the block never truncated. An input declaring
@@ -11,8 +11,12 @@
11
11
  *
12
12
  * Cell enforcement runs HERE, during packing and before any worker is
13
13
  * involved: a block on an input not declared `cellType: "array"` and a block
14
- * over the input's `max_cells` (counted in TUPLES) both refuse the whole
15
- * evaluation by name, never truncate. One exception (frozen authoring
14
+ * over the input's capacity in the run's module (the sheet's `capacity`, else its
15
+ * `max_cells`, counted in TUPLES, at the input's own width: its class's, or the width
16
+ * its words make, `wrunOptionInputTupleWidth`; a print class's union whole only in a
17
+ * module whose capacity holds it, `wrunSheetCellBlockTuples`) both refuse the whole
18
+ * evaluation by name, never truncate, and so does a capacity no build writes
19
+ * (`wrun_cell_capacity_invalid`). One exception (frozen authoring
16
20
  * contract C1.2b): an input declaring `missing: "empty"` reads an oversize
17
21
  * block as a PRESENT EMPTY block (0 cells) on that bar alone and the run
18
22
  * goes on, the way the same input reads a lane that answered nothing; the
@@ -21,26 +25,30 @@
21
25
  import { abiAtLeast } from '../../interfaces/wrun-runtime.interface.js';
22
26
  import { WRUN_FRAME_DEFAULT_MAX_BYTES, WRUN_FRAME_MAX_SLOTS } from './wrun-frames.js';
23
27
  import { wrunChartHostEnv } from '../../host-env.js';
28
+ import { wrunOptionInputTupleWidth } from './wrun-option-views.util.js';
24
29
  import { wrunPlainText } from './wrun-text-params.util.js';
25
- /** The tuple widths a host's own row lanes serve (web: each row-lane descriptor's `width`), registered by its
26
- * registry at load (`registerWrunRowLaneTupleWidths`), so a new lane needs no row in the kit's table. */
27
- let laneTupleWidths = Object.freeze({});
28
- /** Replace the registered row-lane tuple widths (web: src/utility/wrun/sources/row-lane-registry.ts, at load and in
29
- * its spec hook). */
30
- export function registerWrunRowLaneTupleWidths(widths) {
31
- laneTupleWidths = Object.freeze({ ...widths });
32
- }
30
+ // The row-lane widths table and its register function live in the widths leaf: the row-lane registry (boot path)
31
+ // registers through it at its own evaluation and never loads this module; the packer reads the same table.
32
+ import { wrunRegisteredRowLaneTupleWidths } from './wrun-pack-widths.leaf.js';
33
+ // The capacity rules live in their leaf: the row-lane plan hands each input's projection the same answer the packer
34
+ // bounds its block by, without loading this module.
35
+ import { wrunCellBoundWords, wrunSheetCellBlockTuples } from './wrun-cell-capacity.leaf.js';
36
+ export { registerWrunRowLaneTupleWidths } from './wrun-pack-widths.leaf.js';
37
+ export { WRUN_CELL_CAPACITY_INVALID_CODE, wrunCellBlockTuples, wrunCellCapacityIssue, wrunCellReadCapacity, wrunModuleCellCapacity, wrunSheetCellBlockTuples, } from './wrun-cell-capacity.leaf.js';
33
38
  /** Cell tuple widths per celled source class (f64 cells per source tuple), the shared host's table
34
39
  * (`WRUN_HOST_CELL_TUPLE_WIDTHS`): `volume_profile` = [low, high, buy, sell]; `book` = [price,
35
40
  * abs(size), side]; `tape` = [offset_ms, price, size, side]; `trade_volume_by_size` = [bucket,
36
41
  * buy_usd, sell_usd, buy_count, sell_count]; `intrabar` and `candles` = [offset_ms, open, high,
37
42
  * low, close, volume]; `options_chain` = [strike, expiry_ms, side, oi, gamma, delta, mark_iv,
38
- * underlying, multiplier, vega]; and each registered row lane's own (`registerWrunRowLaneTupleWidths`:
39
- * the class a host serves through a descriptor, before or after the kit names it). Read at pack
40
- * time: a run loaded the host first. `max_cells` counts tuples; the packed byte math counts f64s. */
43
+ * underlying, multiplier, vega]; and each registered row lane's own (`registerWrunRowLaneTupleWidths`,
44
+ * wrun-pack-widths.leaf: the class a host serves through a descriptor, before or after the kit names
45
+ * it, so a new lane needs no row in the kit's table). Read at pack time: a run loaded the host first,
46
+ * and the registry registered its lanes at its own evaluation, however late this module loads.
47
+ * `max_cells` counts tuples; the packed byte math counts f64s. */
41
48
  export function wrunCellTupleWidths() {
42
49
  const host = wrunChartHostEnv().sharedHost().WRUN_HOST_CELL_TUPLE_WIDTHS;
43
- return Object.keys(laneTupleWidths).length === 0 ? host : { ...host, ...laneTupleWidths };
50
+ const lanes = wrunRegisteredRowLaneTupleWidths();
51
+ return Object.keys(lanes).length === 0 ? host : { ...host, ...lanes };
44
52
  }
45
53
  /** The frozen refusal for a block over its input's `max_cells` (the om contract's code, every
46
54
  * host): the evaluation is refused, the block never truncated. An input declaring
@@ -84,15 +92,22 @@ export function packWrunRows(metadata, rows, initArgs, textParams) {
84
92
  const cellColumnByIndex = new Map();
85
93
  celledInputs.forEach((input, column) => cellColumnByIndex.set(input.index, column));
86
94
  const tupleWidthByIndex = new Map();
87
- const maxCellsByIndex = new Map();
95
+ // The tuples a block may hold in this module: the sheet's `capacity ?? max_cells`, a print class's union whole only
96
+ // in a module whose capacity holds it (`wrunSheetCellBlockTuples`, which refuses a capacity no build writes).
97
+ const capacityByIndex = new Map();
88
98
  // The inputs that read an oversize block as an empty one (C1.2b `missing: "empty"`).
89
99
  const emptyWhenOversize = new Set();
90
100
  const tupleWidths = celledInputs.length > 0 ? wrunCellTupleWidths() : {};
91
101
  for (const input of celledInputs) {
92
102
  const source = metadata.inputSources[input.name];
93
103
  const sourceClass = source?.source ?? '';
94
- tupleWidthByIndex.set(input.index, Object.hasOwn(tupleWidths, sourceClass) ? (tupleWidths[sourceClass] ?? 1) : 1);
95
- maxCellsByIndex.set(input.index, input.max_cells ?? Number.POSITIVE_INFINITY);
104
+ const classWidth = Object.hasOwn(tupleWidths, sourceClass) ? (tupleWidths[sourceClass] ?? 1) : 1;
105
+ // `max_cells` counts the input's OWN tuples: its words may resize them (a view fold, the strike kit fold's 14-value
106
+ // rows; the SDK's one rule, `wrunOptionInputTupleWidth`), so a block is never counted at its class's width.
107
+ tupleWidthByIndex.set(input.index, source === undefined
108
+ ? classWidth
109
+ : wrunOptionInputTupleWidth(source, classWidth));
110
+ capacityByIndex.set(input.index, wrunSheetCellBlockTuples(metadata, input));
96
111
  if (source?.missing === 'empty')
97
112
  emptyWhenOversize.add(input.index);
98
113
  }
@@ -120,20 +135,22 @@ export function packWrunRows(metadata, rows, initArgs, textParams) {
120
135
  `which is not declared cellType "array" in metadata`);
121
136
  }
122
137
  const tupleWidth = tupleWidthByIndex.get(inputIndex) ?? 1;
123
- const maxCells = maxCellsByIndex.get(inputIndex) ?? Number.POSITIVE_INFINITY;
138
+ const capacity = capacityByIndex.get(inputIndex) ?? Number.POSITIVE_INFINITY;
124
139
  if (block.length % tupleWidth !== 0) {
125
140
  throw new Error(`WRUN ${metadata.id}: cell block for input ${inputIndex} at ts ${row.ts} has ` +
126
141
  `${block.length} f64 cells, which does not divide into ${tupleWidth}-cell tuples`);
127
142
  }
128
143
  const tuples = block.length / tupleWidth;
129
- if (tuples > maxCells && emptyWhenOversize.has(inputIndex)) {
144
+ if (tuples > capacity && emptyWhenOversize.has(inputIndex)) {
130
145
  // C1.2b: this bar reads a present empty block; every other bar keeps its own.
131
146
  cellLens[rowIdx * celledInputs.length + column] = 0;
132
147
  continue;
133
148
  }
134
- if (tuples > maxCells) {
149
+ if (tuples > capacity) {
150
+ const maxCells = metadata.inputs.find((input) => input.index === inputIndex)?.max_cells;
135
151
  throw new Error(`WRUN ${metadata.id}: ${WRUN_CELL_BLOCK_TOO_LARGE_CODE}: input ${inputIndex} bar at ts ${row.ts} has ` +
136
- `${tuples} cells; max_cells is ${maxCells}, so the evaluation is refused (a block is never truncated)`);
152
+ `${tuples} cells; ${wrunCellBoundWords(maxCells, capacity)}, so the evaluation is refused ` +
153
+ `(a block is never truncated)`);
137
154
  }
138
155
  cellLens[rowIdx * celledInputs.length + column] = block.length;
139
156
  totalCells += block.length;
@@ -71,6 +71,10 @@ export interface WrunChildOverlayChart extends WrunPaneFormatChart {
71
71
  settings?: Record<string, unknown>;
72
72
  rawData?: unknown;
73
73
  data?: unknown;
74
+ /** The owner's own plots and its last applied run: whether its pane draws anything in a window
75
+ * (window-geometry.leaf ownerPaneDrawsNothing). */
76
+ nestedMeta?: unknown;
77
+ runResult?: unknown;
74
78
  }>;
75
79
  isDestroyed?: boolean;
76
80
  /** The chart canvas in CSS px sizes a table pane to its rows; the focus mode names the expanded pane. */
@@ -17,7 +17,13 @@
17
17
  * height share are set here (SC08 SC09 SC10 SC17 SC37); `place: "side"`
18
18
  * mounts below the chart like every panel (the window is a side panel's
19
19
  * opened form, Kyle 2026-10-04; the engine's side strip stays for `dock:
20
- * "side"` canvases). Docked levels (g2) take
20
+ * "side"` canvases). A table never sits under the candles while its
21
+ * Indicator's window shows it, and never mounts nowhere (Kyle 2026-10-21): a
22
+ * window cell mounts it; a normal cell leaves it to the window only when the
23
+ * host shows windows (the env's `windows`) and its `tablesShownInWindow`
24
+ * answers true for this chart and Indicator, and mounts it below like every
25
+ * panel otherwise (`mountsOnCell`). A table loses its all-empty columns
26
+ * before it translates (withoutEmptyTableColumns). Docked levels (g2) take
21
27
  * their settings and rows from wrun-levels-child.util's mount helpers and
22
28
  * keep their hover rows under the child id (DL-hover). Price canvases (g6)
23
29
  * take their config from wrun-canvases.util: heatmap and profile children
@@ -38,12 +44,12 @@
38
44
  * OT32). Every child's eye follows the parent's, except where the reader
39
45
  * moved a child's own eye (an inset's): that flip stands (syncChildVisibility).
40
46
  */
41
- import { wrunChartHostEnv } from '../../host-env.js';
47
+ import { wrunChartHostEnv, wrunHostLeavesTablesToWindow } from '../../host-env.js';
42
48
  import { isDateLabelledBarInterval } from '../chart/date-labelled-interval.leaf.js';
43
49
  import { KSCRIPT_LEGEND_VALUE_INK, kScriptLegendEntries, kScriptLegendLineFormat, kScriptLegendLineFormatOptions, kScriptLegendLines, kScriptLegendLineSwatchAt, kScriptLegendLineValueAt, kScriptLegendSlotCells, padKScriptLegendSlots, } from '../chart/kscript-legend-entries.util.js';
44
- import { panelGridHeight, refreshPanelOverlayInPlace, samePanelPane, translatePanelToEngine, } from '../chart/om-panel.util.js';
50
+ import { panelGridHeight, refreshPanelOverlayInPlace, samePanelPane, translatePanelToEngine, withoutEmptyTableColumns, } from '../chart/om-panel.util.js';
45
51
  import { isWrunWindowOwner } from '../chart/window-owner.leaf.js';
46
- import { planWindowWeights, reconcileWindowOwnerGeometry, savedWindowSplit, tableRowCountOf, } from '../chart/window-geometry.leaf.js';
52
+ import { ownerPaneDrawsNothing, planWindowWeights, reconcileWindowOwnerGeometry, savedWindowSplit, tableRowCountOf, } from '../chart/window-geometry.leaf.js';
47
53
  import { wrunLegendName } from '../chart/wrun-legend-name.util.js';
48
54
  import { wrunResultLegendColors, wrunSeriesChildId, } from '../chart/wrun-run-result.util.js';
49
55
  import { budgetWrunBatchedRetained, budgetWrunBatchedRows, commitWrunBatchedPlan, currentWrunBatchedPlan, forgetWrunBatchedCells, isWrunBatchedMarksKind, noteWrunBatchedRowsCut, planWrunBatchedMerged, restoreWrunBatchedLedger, snapshotWrunBatchedLedger, wrunBatchedChargeOf, wrunBatchedChildConfig, wrunBatchedChildrenOverShare, wrunBatchedSiblingsToRebalance, } from './wrun-batched-marks.util.js';
@@ -286,24 +292,30 @@ function userThemeMode() {
286
292
  * theme, price digits and display timezone (SC08 SC16 SC37); the run's
287
293
  * title and caption on the legend as text (SC17: titan renders both as text); the maximize
288
294
  * button and stats row (SC10); the declared height share (SC09); every
289
- * panel below the chart at its carved height, `place: "side"` included (a
290
- * side panel's right-side home is the window, never a strip that narrows
291
- * the candles; `width_px` / `height_px` therefore size nothing here). */
295
+ * panel in a pane of its own at its carved height, `place: "side"` included
296
+ * (a side panel's right-side home is the window, never a strip that narrows
297
+ * the candles; `width_px` / `height_px` therefore size nothing here). A
298
+ * table reaches this door on a window cell, and on a normal cell while no
299
+ * window of the layout shows it (the children filter, mountsOnCell), so it
300
+ * never sits under the candles while its window shows it and never mounts
301
+ * nowhere; its all-empty columns leave before the translation builds the
302
+ * payload and the formatter (withoutEmptyTableColumns, C4). */
292
303
  function panelChildConfig(child, ctx) {
293
304
  const translateContext = {
294
305
  theme: ctx.theme,
295
306
  ...(ctx.priceDigits !== undefined ? { priceDigits: ctx.priceDigits() } : {}),
296
307
  timezoneOffsetMs: ctx.timezoneOffsetMs,
297
308
  };
298
- const translated = translatePanelToEngine(child.frame, translateContext);
299
- const { panel, rows, chrome } = child.frame;
309
+ const frame = withoutEmptyTableColumns(child.frame);
310
+ const translated = translatePanelToEngine(frame, translateContext);
311
+ const { panel, rows, chrome } = frame;
300
312
  const caption = chrome?.caption;
301
313
  const id = `${ctx.overlayId}::panel:${child.name}`;
302
314
  // A table owns no value axis and a rich line (every chrome but box: the
303
315
  // numeric curve, or grid / none on a time, category or stacked line) draws
304
316
  // its own left axis (C4): neither pane echoes the chart's prices in its
305
- // scale cell. A box line and every other kind keep it (every panel mounts
306
- // below, `place: "side"` included).
317
+ // scale cell. A box line and every other kind keep it, in whichever pane it
318
+ // mounts (below the chart, `place: "side"` included, or in a window).
307
319
  const ownAxis = panel.kind === 'table' || (panel.kind === 'line' && wrunPanelChrome(panel) !== 'box');
308
320
  return {
309
321
  id,
@@ -717,13 +729,14 @@ function samePane(mounted, next, heightHeld = false) {
717
729
  }
718
730
  /** The panes a window mount lays out, for the planner: the owner's own pane
719
731
  * when it is mounted offchart (a lower-only package), the run's panel
720
- * children (side panels included: they stack in the window) and series
721
- * children that mount below the chart (a pane pinned over the candles
722
- * carves nothing), and the mounted children a frameless tick keeps. */
732
+ * children (side panels and tables included: they stack in the window) and
733
+ * series children that mount below the chart (a pane pinned over the candles
734
+ * carves nothing), and the mounted children a frameless tick keeps. An owner
735
+ * pane that draws nothing beside child panes is left out (the geometry's
736
+ * rule, ownerPaneDrawsNothing: the reconcile hides it and the children take
737
+ * its height, C5); alone, it stays (never a blank window). */
723
738
  function windowPanesOfMount(parent, overlayId, children, kept) {
724
739
  const panes = [];
725
- if (parent.type === 'offchart' && parent.isPaneHidden !== true)
726
- panes.push({ id: overlayId, kind: 'time' });
727
740
  const seen = new Set();
728
741
  for (const child of children) {
729
742
  if (child.kind === 'panel') {
@@ -751,6 +764,10 @@ function windowPanesOfMount(parent, overlayId, children, kept) {
751
764
  else
752
765
  panes.push({ id: config.id, kind: 'chart' });
753
766
  }
767
+ const ownerPane = parent.type === 'offchart' && parent.isPaneHidden !== true;
768
+ if (ownerPane && (panes.length === 0 || !ownerPaneDrawsNothing(parent))) {
769
+ panes.unshift({ id: overlayId, kind: 'time' });
770
+ }
754
771
  return panes;
755
772
  }
756
773
  /** A row-backed canvas keeps its overlay across runs while it stays the
@@ -1592,6 +1609,21 @@ function ownerTimePaneId(parent, overlayId, children) {
1592
1609
  const lower = children.find((child) => child.kind === 'series' && child.result.pane?.place !== 'price');
1593
1610
  return lower === undefined ? undefined : wrunSeriesChildId(overlayId, lower.name);
1594
1611
  }
1612
+ /**
1613
+ * Whether a run's child mounts on this cell. The class it closes: a table that mounts nowhere, or under the candles
1614
+ * while its window shows it (Kyle 2026-10-21: a table never sits under the candles WHILE its window shows it, which
1615
+ * never lets a table vanish). A window cell mounts every child. A normal cell mounts every child but the `panel.table`
1616
+ * children (any `place`) of an Indicator whose tables a window cell of the layout shows: the host shows windows (the
1617
+ * env's `windows`, C1) and its `tablesShownInWindow` answers true for this chart and Indicator (R1;
1618
+ * `leavesTablesToWindow`, asked here only, and only for a table). An Indicator with no window, or one that cannot get
1619
+ * one (replay, a full layout, a slot budget that refuses the window copy, an editor draft, a layout saved before
1620
+ * windows), keeps its tables on the cell, as does every Indicator on a host without windows (the phone). A table an
1621
+ * earlier pass mounted that the rule now leaves out goes with the children a run no longer declares; one it left out
1622
+ * mounts again on the next run that carries frames once no window shows it.
1623
+ */
1624
+ function mountsOnCell(child, windowCell, leavesTablesToWindow) {
1625
+ return windowCell || child.kind !== 'panel' || child.frame.panel.kind !== 'table' || !leavesTablesToWindow();
1626
+ }
1595
1627
  /** The run's children in mount order (C6): the panels first, then today's
1596
1628
  * order (series, levels, canvases, insets), each group as the run listed
1597
1629
  * it. Decided here, never in the run result, so the run golden's
@@ -1665,7 +1697,20 @@ export function mountWrunChildOverlays({ tc, overlayId, runResult, replaceFrames
1665
1697
  unmountWrunChildOverlays(tc, overlayId);
1666
1698
  state = undefined;
1667
1699
  }
1668
- const children = (runResult.childOverlays ?? []).filter((child) => replaceFrames || ROW_BACKED_KINDS.has(child.kind));
1700
+ // A window (the parent carries the owner flag in its engine settings, or the
1701
+ // caller says so): the children mount at the plan's weights and the plan is
1702
+ // reconciled onto the mounted panes when the mount settles. A cell without
1703
+ // a flagged owner never enters that path: its configs are today's. The cell
1704
+ // also decides whether a table mounts (mountsOnCell): a normal cell leaves
1705
+ // its tables to the window that shows them (the host asked at most once per
1706
+ // pass, and only when a table reaches the rule) and mounts them otherwise.
1707
+ // A table the rule leaves out here that an earlier pass mounted leaves like
1708
+ // a child the run dropped; one left out before mounts again on the first
1709
+ // pass that carries frames and finds no window showing it.
1710
+ const windowCell = cell?.window ?? isWrunWindowOwner(parent);
1711
+ let leavesTables;
1712
+ const leavesTablesToWindow = () => (leavesTables ??= wrunHostLeavesTablesToWindow(chartIndex, overlayId));
1713
+ const children = (runResult.childOverlays ?? []).filter((child) => (replaceFrames || ROW_BACKED_KINDS.has(child.kind)) && mountsOnCell(child, windowCell, leavesTablesToWindow));
1669
1714
  if (!state && children.length === 0)
1670
1715
  return Promise.resolve(true);
1671
1716
  if (!replaceFrames &&
@@ -1702,11 +1747,6 @@ export function mountWrunChildOverlays({ tc, overlayId, runResult, replaceFrames
1702
1747
  const token = Symbol(overlayId);
1703
1748
  current.token = token;
1704
1749
  current.priceDigits = priceDigits;
1705
- // A window (the parent carries the owner flag in its engine settings, or the
1706
- // caller says so): the children mount at the plan's weights and the plan is
1707
- // reconciled onto the mounted panes when the mount settles. A cell without
1708
- // a flagged owner never enters that path: its configs are today's.
1709
- const windowCell = cell?.window ?? isWrunWindowOwner(parent);
1710
1750
  current.chartHeightPx = cell?.canvasHeightPx ?? tc.canvasChartController?.canvasElement?.clientHeight;
1711
1751
  // The host's plan sizes the children on any cell (a normal cell's remembered heights included); a window without
1712
1752
  // one plans its own.
@@ -8,7 +8,11 @@
8
8
  * settings it built from the structural words, a `series` array patch merging
9
9
  * per index. A frame field overrides the declared word of the same name for
10
10
  * that run; `markers` replaces the declared list. Absent words add no key, so
11
- * today's drawing stays the default (conventions 10).
11
+ * today's drawing stays the default (conventions 10), except the plain look's
12
+ * defaults (the `hairlines` chrome of a line, bars, histogram or scatter
13
+ * pane; a heatmap's palette) and a wrun table's: on the wrun lane an absent
14
+ * table colour, border or grid word takes the chart's look (wrunTableStyle),
15
+ * the push lane's table keeps the engine's.
12
16
  *
13
17
  * Pure and worker safe (om-panel.util rides the frame worker): it imports the
14
18
  * style foundation only. Colour words resolve here against `ctx.theme`
@@ -29,8 +33,9 @@ import type { WrunPanelFrameChrome } from './wrun-frames.js';
29
33
  export type WrunStyledPanel = Omit<ParsedPanel['panel'], 'id'>;
30
34
  export type WrunStyledPanelRows = ParsedPanel['rows'];
31
35
  export type WrunStyledPanelSeries = NonNullable<WrunStyledPanel['series']>[number];
32
- /** The pane chrome words (SC02 SC23). */
33
- export type WrunPanelChromeWord = 'box' | 'grid' | 'none';
36
+ /** The pane chrome words (SC02 SC23): the sheet type's own, so the two
37
+ * cannot drift. */
38
+ export type WrunPanelChromeWord = NonNullable<WrunPanelStyle['chrome']>;
34
39
  /** What a printed number stands for (titan `IMetaData.formatDomainValue`):
35
40
  * 'x' = numeric x ticks, the hover title x, marker show_value, the stats row
36
41
  * x; 'axis' = value-axis ticks; 'value' = every other value (hover rows, bar
@@ -69,9 +74,14 @@ export interface WrunHeatmapIndices {
69
74
  export declare const WRUN_PANEL_STYLE_KEYS: ReadonlyArray<keyof WrunPanelStyle>;
70
75
  /** Every `panels[i].series[j]` style word. */
71
76
  export declare const WRUN_PANEL_SERIES_STYLE_KEYS: ReadonlyArray<keyof WrunPanelSeriesStyle>;
72
- /** Today's heatmap palette (the engine's three-stop default), used under
73
- * scale "palette" when the panel declares none (SC06). */
77
+ /** The heatmap palette under scale "palette" when the panel declares none
78
+ * (SC06): the mono ramp from the chart's background to its text colour, so
79
+ * a dark chart ramps black to white and a light chart white to black. Theme
80
+ * tokens, resolved against `ctx.theme`. */
74
81
  export declare const WRUN_PANEL_HEATMAP_PALETTE: readonly string[];
82
+ /** The same default without a theme to resolve the ramp against (the om
83
+ * push lane): the three stops a pushed heatmap has always drawn. */
84
+ export declare const WRUN_PANEL_HEATMAP_UNTHEMED_PALETTE: readonly string[];
75
85
  /** The default `stroke_fade.edge_opacity` (SC03; the engine's own default). */
76
86
  export declare const WRUN_PANEL_STROKE_FADE_EDGE_OPACITY = 0.35;
77
87
  /** The badge chip's defaults (C2): the fill when `color` is absent, and the
@@ -90,9 +100,11 @@ export declare const WRUN_PANEL_TABLE_TOP_OFFSET_PX = 24;
90
100
  * rgba() but not 8-digit hex. Without a theme (the push lane) a token and a
91
101
  * 6-digit hex pass through unchanged. */
92
102
  export declare function wrunPaneColor(word: string, theme?: WrunColorTheme): string;
93
- /** A panel's effective chrome (SC02): the declared word, else "grid" for an
94
- * unstacked line with x "index" or "number" (today's rich curve), else
95
- * "box" (today's panel look). */
103
+ /** A panel's effective chrome (SC02): the declared word, else "hairlines"
104
+ * on a line, bars, histogram or scatter pane of every x kind, stacked or
105
+ * not (the plain look), else "box" (pie, heatmap, table, tiles). On a line
106
+ * every word but "box" is the rich curve: the engine routes any other
107
+ * chromeStyle there, and "hairlines" draws its rows-only grid. */
96
108
  export declare function wrunPanelChrome(panel: WrunStyledPanel): WrunPanelChromeWord;
97
109
  /** The ink a badge chip prints in when `text_color` is absent (C2): the
98
110
  * WCAG relative luminance of the resolved fill, the dark ink above the cut,
@@ -136,11 +148,13 @@ export declare function wrunScatterStyle(panel: WrunStyledPanel, chrome: WrunPan
136
148
  * (frame first), slice gaps and the slice border. */
137
149
  export declare function wrunPieStyle(panel: WrunStyledPanel, chrome: WrunPanelFrameChrome | undefined, rows: WrunStyledPanelRows, ctx: WrunPanelTranslateContext): WrunPanelSettingsPatch;
138
150
  /** The heatmap words (SC06 SC18): under scale "palette" the stops (the
139
- * declared ones, else today's three) and the bounds (frame first); under
140
- * "signed" none of them, so the engine's diverging scale draws through the
141
- * common tone pair. The highlight resolves its keys to the engine's row and
142
- * column indices (a key absent from the rows is dropped), the axis nouns
143
- * pass through, and a frame summary is fitted to the column count. */
151
+ * declared ones, else the mono ramp, or today's three on the push lane,
152
+ * which has no theme to resolve the ramp against) and the bounds (frame
153
+ * first); under "signed" none of them, so the engine's diverging scale
154
+ * draws through the common tone pair. The highlight resolves its keys to
155
+ * the engine's row and column indices (a key absent from the rows is
156
+ * dropped), the axis nouns pass through, and a frame summary is fitted to
157
+ * the column count. */
144
158
  export declare function wrunHeatmapStyle(panel: WrunStyledPanel, chrome: WrunPanelFrameChrome | undefined, indices: WrunHeatmapIndices, ctx: WrunPanelTranslateContext): WrunPanelSettingsPatch;
145
159
  /** The tiles words: none of their own. `columns`, `accent` and a tile's
146
160
  * colour ride the structural translation (the caller's, SC26 SC15), the
@@ -148,11 +162,24 @@ export declare function wrunHeatmapStyle(panel: WrunStyledPanel, chrome: WrunPan
148
162
  * formats reach the engine through {@link wrunPanelFormatter} (SC26). The
149
163
  * seam stays so a tiles word lands here without touching the caller. */
150
164
  export declare function wrunTilesStyle(_panel: WrunStyledPanel, _rows: WrunStyledPanelRows, _ctx: WrunPanelTranslateContext): WrunPanelSettingsPatch;
165
+ /** The fill a wrun table cell takes where the author declared none: the engine paints a cell's fill through the
166
+ * canvas `fillStyle`, which takes any CSS colour, so `transparent` paints nothing where an absent key paints the
167
+ * engine's own grey. */
168
+ export declare const WRUN_TABLE_NO_FILL = "transparent";
151
169
  /** The table words onto the engine's Table payload (SC22 SC35; the
152
170
  * WRUN-CAPS keys verbatim): the anchor and offset (`y` adds the legend
153
171
  * clearance under a top_* anchor), widths, padding, type, alignment, inks
154
172
  * (resolved), the background fill and gradient, the border and grid lines,
155
- * and the header column. Only declared words patch the caller's defaults. */
173
+ * and the header column. Only declared words patch the caller's defaults on
174
+ * the om push lane (no theme), so its payload stays byte for byte the
175
+ * engine's look. The wrun lane (a theme in hand) also sends the table that
176
+ * fills its pane's width with a hovered row (`fillWidth`, `hoverRow`) and,
177
+ * for each word the author did not declare, the chart's look instead of the
178
+ * engine's greys: text in the theme's text colour, the header in its muted
179
+ * colour, no cell or header fill, no border and, when the author declared
180
+ * no grid word at all, one rule under the header in the theme's grid
181
+ * colour. A declared word always wins; a theme switch re-resolves the
182
+ * fallbacks like every other theme word (the mount's retranslate). */
156
183
  export declare function wrunTableStyle(panel: WrunStyledPanel, ctx: WrunPanelTranslateContext): WrunPanelSettingsPatch;
157
184
  /** The engine's number formatter for a panel (SC08 SC26 SC40), built only
158
185
  * when a format word is declared somewhere on it: `format`, `decimals`,