@orangecharts/wrun-chart-host 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +6 -1
  3. package/dist/constants/feature-flags.constants.js +67 -24
  4. package/dist/constants/opra-compliance.constants.d.ts +3 -2
  5. package/dist/constants/opra-compliance.constants.js +3 -2
  6. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  7. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  8. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  9. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  10. package/dist/constants/venue-presets.constants.d.ts +20 -20
  11. package/dist/constants/venue-presets.constants.js +24 -26
  12. package/dist/host-env.d.ts +29 -5
  13. package/dist/host-env.js +6 -0
  14. package/dist/host-ports.types.d.ts +69 -15
  15. package/dist/index.d.ts +13 -0
  16. package/dist/index.js +13 -0
  17. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  18. package/dist/interfaces/replay.interface.d.ts +8 -0
  19. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  20. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +41 -4
  21. package/dist/kscript-data/controls/live-trades-merge.util.js +52 -7
  22. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +56 -0
  23. package/dist/kscript-data/controls/live-trades-order-gate.util.js +107 -0
  24. package/dist/market-data/billing.interface.d.ts +95 -31
  25. package/dist/market-data/billing.interface.js +36 -5
  26. package/dist/market-data/venue.d.ts +88 -6
  27. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  28. package/dist/market-data/venues/cme.d.ts +126 -0
  29. package/dist/market-data/venues/cme.js +133 -0
  30. package/dist/market-data/venues/index.d.ts +162 -5
  31. package/dist/market-data/venues/index.js +48 -6
  32. package/dist/settings-templates/index.js +7 -3
  33. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  34. package/dist/settings-templates/indicator-fields.js +45 -6
  35. package/dist/settings-templates/tool-rules.d.ts +27 -17
  36. package/dist/settings-templates/tool-rules.js +27 -11
  37. package/dist/settings-templates/tool-tables.generated.js +91 -31
  38. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  39. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  40. package/dist/utility/chart/index-mode-admission.util.js +15 -2
  41. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  42. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  43. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +7 -2
  44. package/dist/utility/chart/kscript-live-coalesce.util.js +9 -3
  45. package/dist/utility/chart/kscript-provenance-keys.util.js +6 -0
  46. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  47. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  48. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  49. package/dist/utility/chart/kscript-venue-policy.util.d.ts +54 -35
  50. package/dist/utility/chart/kscript-venue-policy.util.js +78 -42
  51. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  52. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  53. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  54. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  55. package/dist/utility/chart/rth-session.util.d.ts +3 -2
  56. package/dist/utility/chart/rth-session.util.js +2 -1
  57. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  58. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  59. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  60. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  61. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  62. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  63. package/dist/utility/options/option-venue.util.d.ts +18 -0
  64. package/dist/utility/options/option-venue.util.js +27 -0
  65. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  66. package/dist/utility/wrun/derived-roots.util.d.ts +213 -0
  67. package/dist/utility/wrun/derived-roots.util.js +471 -0
  68. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +41 -6
  69. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  70. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  71. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  72. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  73. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  74. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  75. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  76. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  77. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  78. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  79. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  80. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  81. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  82. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  83. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  84. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  85. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  86. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  87. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  88. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +39 -10
  89. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +64 -0
  90. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +89 -0
  91. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  92. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  93. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  94. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +174 -13
  95. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +685 -27
  96. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  97. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  98. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +53 -12
  99. package/dist/utility/wrun/wrun-chart-market-facts.util.js +101 -53
  100. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  101. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  102. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  103. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  104. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  105. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  106. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  107. package/dist/utility/wrun/wrun-frames.js +73 -10
  108. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  109. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  110. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  111. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  112. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  113. package/dist/utility/wrun/wrun-live-intake.util.d.ts +13 -7
  114. package/dist/utility/wrun/wrun-live-intake.util.js +82 -29
  115. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -0
  116. package/dist/utility/wrun/wrun-live-tick.util.js +158 -14
  117. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +49 -10
  118. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +65 -5
  119. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  120. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  121. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  122. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  123. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  124. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  125. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  126. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  127. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  128. package/dist/utility/wrun/wrun-option-views.util.d.ts +47 -13
  129. package/dist/utility/wrun/wrun-option-views.util.js +98 -26
  130. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  131. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  132. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +17 -0
  133. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  134. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  135. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +100 -31
  136. package/dist/utility/wrun/wrun-overlay-run.util.js +733 -114
  137. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  138. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  139. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  140. package/dist/utility/wrun/wrun-panel-mount.util.js +63 -13
  141. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  142. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  143. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  144. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  145. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  146. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  147. package/dist/utility/wrun/wrun-pin-spelling.util.js +12 -11
  148. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  149. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  150. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  151. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  152. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  153. package/dist/utility/wrun/wrun-run-interval.util.d.ts +4 -2
  154. package/dist/utility/wrun/wrun-run-interval.util.js +9 -6
  155. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  156. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  157. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  158. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  159. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  160. package/dist/utility/wrun/wrun-socket-row-source.js +113 -8
  161. package/dist/utility/wrun/wrun-source-rows.util.d.ts +5 -1
  162. package/dist/utility/wrun/wrun-source-rows.util.js +16 -3
  163. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  164. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  165. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  166. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  167. package/dist/utility/wrun/wrun-tape-per-order.util.js +26 -0
  168. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  169. package/dist/utils/replay/replay-buffer-math.js +227 -20
  170. package/package.json +11 -11
@@ -66,6 +66,7 @@ import { type WrunIntegrationRoute } from './wrun-integration-route.util.js';
66
66
  import type { OverlayRunInterval } from '../chart/indicator-run-interval.util.js';
67
67
  import { type WrunPrefixFeedClause } from './run-schedule/wrun-prefix-feeds.util.js';
68
68
  import { type WrunCandleGroup, type WrunFillPair, type WrunRunResult } from '../chart/wrun-run-result.util.js';
69
+ import { type WrunRowLaneBudgetCut } from './sources/wrun-row-lanes.util.js';
69
70
  import { type WrunEarningsMarket } from './wrun-earnings-facts.util.js';
70
71
  import { type WrunRunHealth } from './wrun-run-health.util.js';
71
72
  import { type WrunChartNames } from './wrun-chart-context.util.js';
@@ -73,6 +74,7 @@ import { type WrunFactsMarket } from './wrun-chart-market-facts.util.js';
73
74
  import { type WrunStrategyBarInput } from './wrun-host.service.js';
74
75
  import { type WrunRefusalAttemptToken, type WrunRefusalContext, type WrunRefusalSeed } from './wrun-refusal.util.js';
75
76
  import { type WrunHostFillContext } from './wrun-script-inputs.util.js';
77
+ import { type WrunDownloadSummary } from './wrun-download-meter.util.js';
76
78
  import type { WrunLatestSnapshot } from './wrun-latest-snapshot.js';
77
79
  import { wrunChartMarketIdentity, type WrunOverlayLiveContext, type WrunWarmupMiss } from './wrun-overlay-drivers.util.js';
78
80
  import type { WrunLegCandleClose } from '@orangecharts/indicator-kit/host';
@@ -244,6 +246,8 @@ export type WrunRunStage = 'head' | 'lanes' | 'compute' | 'integrate' | 'prefix'
244
246
  */
245
247
  export declare function surfaceWrunRunFailureOnLegend(chartIndex: number, indicatorId: string, error: unknown, context?: {
246
248
  outputNames?: readonly string[];
249
+ /** The run's console provenance (`computed.opra`): its runtime trap row carries the row mark. */
250
+ opra?: boolean;
247
251
  /** The run's refusal context (the run pass builds it from the chart it ran on). */
248
252
  refusalContext?: WrunRefusalContext;
249
253
  /** The attempt token the run resolved before its first await; absent or null: no toast. */
@@ -274,6 +278,54 @@ export declare function wrunRefusalContextFor(input: {
274
278
  settings: unknown;
275
279
  chartMetadata: WrunRefusalChartMetadata;
276
280
  }): Promise<WrunRefusalContext>;
281
+ /** A row lane's read its row budget cut (`onBudgetCut`, wrun-row-lanes.util): the newest bars that fit read whole,
282
+ * the older ones partial, so the run drew fewer bars of that lane than the chart shows. */
283
+ export declare const WRUN_ROW_BUDGET_CUT_CODE = "WRUN_ROW_BUDGET_CUT";
284
+ /** The rows the run seam owns for its row budget cuts: replaced by every full run, cleared by a run that cut nothing. */
285
+ export declare const WRUN_ROW_BUDGET_ROW_CODES: ReadonlySet<string>;
286
+ /** The legend's localized sentence of a cut over its facts (`{ n }`, the bars kept, its plural choice). */
287
+ export declare const WRUN_ROW_BUDGET_CUT_NOTE_KEY = "wrun.rowBudget.cut";
288
+ /**
289
+ * The legend note rows of a run's row budget cuts, one per row lane instance its budget cut: warnings in the run-owned
290
+ * set `WRUN_ROW_BUDGET_ROW_CODES`, `message` the technical words (Copy details, the console), `details` the facts the
291
+ * legend's sentence reads (`WRUN_ROW_BUDGET_CUT_NOTE_KEY`: `{ n }`) beside the lane and the cut. A note, never a
292
+ * refusal: the run drew its newest bars, and without it a package that drew 30 bars of a long chart (Strike
293
+ * Footprint) said nothing about why. Empty for no cut, which is what clears the rows of an earlier run.
294
+ */
295
+ export declare function wrunRowBudgetCutDiagnostics(cuts: Iterable<WrunRowLaneBudgetCut>): RuntimeDiagnostic[];
296
+ /** The indicator download budget's two chips (OPTLOAD W3 R2), the source chip family's run-owned codes
297
+ * (kscript-source-degrade.util `FE_SOURCE_TRIMMED_CODE`, `FE_SOURCE_HEAVY_CODE`, spelled here because the package
298
+ * names no web module; tests/utility/wrun/wrun-overlay-run.download-budget.spec.ts pins them equal): replaced by every
299
+ * full run, cleared by a run that kept its budget. */
300
+ export declare const WRUN_DOWNLOAD_TRIMMED_CODE = "FE_SOURCE_TRIMMED";
301
+ export declare const WRUN_DOWNLOAD_HEAVY_CODE = "FE_SOURCE_HEAVY";
302
+ export declare const WRUN_DOWNLOAD_BUDGET_ROW_CODES: ReadonlySet<string>;
303
+ /** Bytes as the download chips write them, 1,000,000 a MB: "1 MB", "1.2 MB", "17 MB". */
304
+ export declare function wrunDownloadMbText(bytes: number): string;
305
+ /** A feed as a download chip names it: its label (the console's words), and the i18n key the legend says it in. */
306
+ export interface WrunDownloadFeed {
307
+ label: string;
308
+ key?: string;
309
+ }
310
+ /**
311
+ * The download budget's legend rows of one full run (R2), info rows in the run-owned set
312
+ * `WRUN_DOWNLOAD_BUDGET_ROW_CODES`, still text in the source chip family's coverage group (never a spinner, never a
313
+ * toast; runtime-diagnostics.util words them from `details`, the feeds by `feedKeys` where a lane has feed words):
314
+ * - `FE_SOURCE_TRIMMED` ("Newest bars only"), when the budget cut a read: the feeds it cut, the oldest bar all of them
315
+ * still read (`date`, `keptFromTs`: the newest of the cuts' oldest kept bars) and the budget;
316
+ * - `FE_SOURCE_HEAVY` ("Large download"), when the run downloaded more than its budget and cut nothing (one snapshot):
317
+ * the feed that downloaded the most, the size and the budget.
318
+ * Empty with the flag off, or for a run that kept its budget: what clears an earlier run's rows.
319
+ */
320
+ export declare function wrunDownloadBudgetDiagnostics(args: {
321
+ on: boolean;
322
+ cuts: Iterable<WrunRowLaneBudgetCut>;
323
+ summary: WrunDownloadSummary | undefined;
324
+ feedOf: (laneKeyOrType: string) => WrunDownloadFeed;
325
+ }): RuntimeDiagnostic[];
326
+ /** Whether the download budget's cut is on (`FeatureFlag.WrunDownloadBudgetCut`); a host whose flag store is not up
327
+ * reads off. */
328
+ export declare function wrunDownloadBudgetCutOn(): boolean;
277
329
  /**
278
330
  * The run health the chart's surfaces read (the chip policy, FE-RUN): an output a viewer cannot
279
331
  * see is not watched (`legend: false` and a sheet `visible: false`, which `wrunRunHealth` skips,
@@ -675,32 +727,10 @@ export interface WrunLaneSendAnchor {
675
727
  * nothing: the budget's late read is the whole answer already.
676
728
  */
677
729
  export declare function runWrunSourceLanes(thunks: WrunSourceLaneThunks, policy?: WrunSourceLanePolicy): Promise<WrunSourceLaneRun>;
678
- /**
679
- * The host-filled values a run's `market.*` params read (WRUN-INPUTS-PLAN
680
- * 1.1, `host_fill`): `tickSize` = the instrument tick the pane's engine
681
- * holds (`getPriceTick`, CME venues today), else the tick the chart's own
682
- * candles reveal (`wrunInferredMainTick`: Binance BTCUSDT reads 0.1, so a
683
- * `ticks` offset moves by ticks off CME too); absent when neither knows one,
684
- * which the kit helpers read as unavailable. `pricePrecision` = the decimals
685
- * the chart's MAIN price scale prints at (the engine tick's own decimals
686
- * when it holds one, else the axis-step rule; HIP-4 overrides both), the
687
- * same resolution `calculatePricePrecision` makes for the axis: an inferred
688
- * tick never moves it. Feature-detected on the engine: a pin without the
689
- * tick API, or a bare test double, yields no engine tick.
690
- * The chart words (`intervalSec` = `intervalMs` / 1000, the run clock's
691
- * interval; `bgColor` / `fgColor` = the pane theme's background and axis
692
- * text colour, packed) ride beside them (wrunChartContextHostFill); an
693
- * unknown interval or a theme-less engine leaves them absent. The main
694
- * scale's `priceStep` is the axis label spacing (it moves with zoom), never
695
- * a price unit: it only picks the axis precision here. With `market` (the
696
- * chart metadata), the market's facts ride too (`kind`, `pointValue`, `zone`,
697
- * `quoteIsUsd`, `sessionOpen`: wrunMarketFactsFor, over the directory row a
698
- * run of a package declaring `kind` or `quote_is_usd` awaited first). With
699
- * `earnings` (the chart metadata, passed for a sheet that declares an
700
- * earnings fact), the issuer's earnings facts ride too (`earningsNextMs`,
701
- * `earningsPrevMs`, `earningsSession`: wrunEarningsFactsFor, over the earnings
702
- * window a run of such a package warmed first).
703
- */
730
+ /** The chart metadata as a batch the cloud computed reads its facts (`integrateWrunRowSourceBatch`): the chart's own
731
+ * market's, named outright so no browser run's decision on the chart stands in (`wrunDecidedOptionsExchange`). The
732
+ * server resolves the chain of the chart market it is sent (follow-up: the backend's stock twin rule). */
733
+ export declare function wrunCloudFactsMarket(chartMetadata: WrunFactsMarket | undefined): WrunFactsMarket | undefined;
704
734
  export declare function wrunHostFillContextFor(tc: unknown, chartExchange: unknown, intervalMs?: number, market?: WrunFactsMarket, earnings?: WrunEarningsMarket): WrunHostFillContext;
705
735
  /**
706
736
  * The latest-values snapshot of a run's rows (wrun-hud-state, U10's frozen
@@ -723,18 +753,45 @@ export declare function wrunLatestSnapshotOf(metadata: Pick<WrunIndicatorMetadat
723
753
  * left out.
724
754
  */
725
755
  export declare function wrunOutputRowsOnChartBars(outputRows: ReadonlyArray<WrunOutputRow>, chart: unknown, run: Pick<OverlayRunInterval, 'intervalMs' | 'waitForClose' | 'sessionLattice'>): WrunOutputRow[];
756
+ /**
757
+ * Whose rows a presentation publishes (`presentWrunIntegration`), as a refused full run's snapshot
758
+ * (wrun-refusal-surface.util `wrunRefusedLatestSnapshotOf`) reads them: `run` for the verdicts that supersede every
759
+ * earlier one (contract C3: a full run's integrate, the cloud batch's, a reseed's), which replace it; `republish` for
760
+ * the rows a full run's live session carries on (a tick, a canvas refine, a landed pan page), which never do. Those
761
+ * rows belong to the computation the refusal superseded (another market, other settings), and the run's refusal
762
+ * still stands on the legend beside them, so their numbers would contradict its chip.
763
+ */
764
+ export type WrunLatestPublishOrigin = 'run' | 'republish';
765
+ /** What an integrate applied, as the snapshot's empty targets read it (wrunSnapshotEmptyTargets): the result's
766
+ * `emptyTargets`, and whether its rows were a window of the loaded range (`partial`: the mount keeps its rows
767
+ * outside it). */
768
+ export interface WrunAppliedEmptiness {
769
+ emptyTargets?: ReadonlyArray<string>;
770
+ partial?: boolean;
771
+ }
772
+ /**
773
+ * The Style targets the latest-values snapshot names as drawing nothing (WrunLatestSnapshot.emptyTargets, the Style
774
+ * page's silent lines): the applied result's own, judged over the whole loaded range. A result computed over a
775
+ * window of it (`partial`) speaks for that window only, and the mount keeps its rows outside, so it can clear a
776
+ * target (values in the window) but never mark one: the previous snapshot's targets it still finds empty. A
777
+ * republish that built no result (`applied` absent) carries the previous snapshot's forward.
778
+ */
779
+ export declare function wrunSnapshotEmptyTargets(previous: ReadonlyArray<string> | undefined, applied: WrunAppliedEmptiness | undefined): string[];
726
780
  /**
727
781
  * What follows every successful integrate, the full run's, the reseed's and
728
782
  * the tick's (after the lower-pane children mounted): the nested output
729
783
  * visibility the sheet (`visible: false`) and the Style page's Visible rows
730
784
  * ask for (U9's `applyWrunOutputVisibility`, parent and children), and the
731
785
  * latest-values snapshot the HUD layer, the legend and the hover inspector
732
- * read (`publishWrunLatestValues`), then the Indicator store's seen note for
733
- * a registry Indicator (`noteWrunRegistryRun`: once a page and day, the maker's
734
- * private reach; both row sources pass here). Presentation only: a failure here
735
- * is logged, never a second failure over a run that rendered.
786
+ * read (`publishWrunLatestValues`; a republish leaves a refused full run's
787
+ * snapshot as it is, `WrunLatestPublishOrigin`) with the applied result's
788
+ * `emptyTargets` (the Style page dims those lines), then the Indicator store's
789
+ * seen note for a registry Indicator (`noteWrunRegistryRun`: once a page and
790
+ * day, the maker's private reach; both row sources pass here). Presentation
791
+ * only: a failure here is logged, never a second failure over a run that
792
+ * rendered.
736
793
  */
737
- export declare function presentWrunIntegration(chartIndex: number, indicatorId: string, metadata: WrunIndicatorMetadata, settings: unknown, outputRows: ReadonlyArray<WrunOutputRow>, chart?: unknown, initArgs?: ReadonlyArray<number>, chartNames?: WrunChartNames, runInterval?: OverlayRunInterval | null): void;
794
+ export declare function presentWrunIntegration(chartIndex: number, indicatorId: string, metadata: WrunIndicatorMetadata, settings: unknown, outputRows: ReadonlyArray<WrunOutputRow>, chart?: unknown, initArgs?: ReadonlyArray<number>, chartNames?: WrunChartNames, runInterval?: OverlayRunInterval | null, origin?: WrunLatestPublishOrigin, applied?: WrunAppliedEmptiness): void;
738
795
  /**
739
796
  * The canvas fill a run integrates with: for a sheet that declares a TPO,
740
797
  * the block the catalog mirror holds for the chart market (a mirror miss, a
@@ -891,6 +948,18 @@ export interface WrunIntegrateOutcome {
891
948
  * route skip or a sparse run the mounted rows outrank. */
892
949
  applied: boolean;
893
950
  }
951
+ /**
952
+ * The result a mounted overlay shows now, as it was built, with the window it was computed over (the
953
+ * workspace switch's stand-in capture stores it, kscript-standin-switch.util): the live tick's last
954
+ * applied build (`liveApplied`), else the result this lane's last full integrate applied while its
955
+ * rows are still the ones mounted (the mount memo: a tick's whole integrate, a blank or a stand-in
956
+ * replaces them), else undefined. While a repaint is owed the chart lags the session, so nothing on
957
+ * it is known to show: undefined. Nothing is rebuilt or patched here.
958
+ */
959
+ export declare function wrunMountedRunResultOf(indicatorId: string, meta: Record<string, unknown>): {
960
+ runResult: WrunRunResult;
961
+ window?: WrunRunWindow;
962
+ } | undefined;
894
963
  /**
895
964
  * The chart's integration budget over the parent and its lower panes (`applyWrunIntegrationBudgetPolicy`,
896
965
  * wrun-integration-budget.util): rows past the kScript preflight's 400k refuse with the kScript path's diagnostic