@orangecharts/wrun-chart-host 0.3.0 → 0.5.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.
- package/README.md +23 -6
- package/dist/constants/exchange-names.leaf.d.ts +8 -0
- package/dist/constants/exchange-names.leaf.js +101 -0
- package/dist/constants/kscript-data-interval-restrictions.constants.d.ts +15 -0
- package/dist/constants/kscript-data-interval-restrictions.constants.js +40 -0
- package/dist/constants/opra-compliance.constants.d.ts +19 -0
- package/dist/constants/opra-compliance.constants.js +19 -0
- package/dist/constants/replay-ladder.leaf.d.ts +30 -0
- package/dist/constants/replay-ladder.leaf.js +99 -0
- package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +133 -0
- package/dist/constants/scriptEditor/builtin-script-snippets.js +451 -0
- package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +168 -0
- package/dist/constants/scriptEditor/cme-official-scripts.constants.js +398 -0
- package/dist/constants/scriptEditor/converted-script-id.leaf.d.ts +8 -0
- package/dist/constants/scriptEditor/converted-script-id.leaf.js +10 -0
- package/dist/constants/scriptEditor/execution.constants.d.ts +4 -0
- package/dist/constants/scriptEditor/execution.constants.js +14 -0
- package/dist/constants/wrun-prefix-safe.constants.d.ts +23 -0
- package/dist/constants/wrun-prefix-safe.constants.js +26 -0
- package/dist/host-env.d.ts +321 -24
- package/dist/host-env.js +15 -0
- package/dist/host-ports.types.d.ts +857 -35
- package/dist/index.d.ts +149 -2
- package/dist/index.js +149 -2
- package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +31 -0
- package/dist/instances/script-engine-worker-ohlcv-transfer.js +164 -0
- package/dist/interfaces/market-event.interface.d.ts +231 -0
- package/dist/interfaces/market-event.interface.js +15 -0
- package/dist/interfaces/opra-realtime.interface.d.ts +70 -134
- package/dist/interfaces/opra-realtime.interface.js +34 -59
- package/dist/interfaces/replay.interface.d.ts +285 -0
- package/dist/interfaces/replay.interface.js +1 -0
- package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +1 -0
- package/dist/kscript-data/controls/live-ohlcv-merge.util.js +93 -0
- package/dist/kscript-data/controls/live-trades-merge.util.d.ts +5 -1
- package/dist/kscript-data/controls/live-trades-merge.util.js +2 -2
- package/dist/market-data/billing.interface.d.ts +219 -0
- package/dist/market-data/billing.interface.js +58 -0
- package/dist/market-data/venue-governed.util.d.ts +2 -0
- package/dist/market-data/venue-governed.util.js +10 -0
- package/dist/market-data/venue.d.ts +122 -0
- package/dist/market-data/venue.js +1 -0
- package/dist/market-data/venues/index.d.ts +97 -0
- package/dist/market-data/venues/index.js +33 -0
- package/dist/market-data/venues/opra.contract.copy.json +35 -0
- package/dist/market-data/venues/opra.d.ts +70 -0
- package/dist/market-data/venues/opra.js +74 -0
- package/dist/replay/replayIndicatorRows.d.ts +31 -0
- package/dist/replay/replayIndicatorRows.js +117 -0
- package/dist/replay/replayLadder.d.ts +85 -0
- package/dist/replay/replayLadder.js +388 -0
- package/dist/utility/auth/server-clock.util.d.ts +81 -0
- package/dist/utility/auth/server-clock.util.js +238 -0
- package/dist/utility/chart/builtin-identity.util.d.ts +18 -0
- package/dist/utility/chart/builtin-identity.util.js +51 -0
- package/dist/utility/chart/cache-alignment.util.d.ts +454 -0
- package/dist/utility/chart/cache-alignment.util.js +926 -0
- package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +15 -0
- package/dist/utility/chart/chart-data-fetch-generation.util.js +22 -0
- package/dist/utility/chart/chart-mount-epoch.util.d.ts +5 -0
- package/dist/utility/chart/chart-mount-epoch.util.js +29 -0
- package/dist/utility/chart/chart-time-domain.util.d.ts +12 -0
- package/dist/utility/chart/chart-time-domain.util.js +23 -0
- package/dist/utility/chart/color-customization.leaf.d.ts +10 -0
- package/dist/utility/chart/color-customization.leaf.js +16 -0
- package/dist/utility/chart/date-labelled-interval.leaf.d.ts +15 -0
- package/dist/utility/chart/date-labelled-interval.leaf.js +19 -0
- package/dist/utility/chart/footprint-tick-grid.util.d.ts +106 -0
- package/dist/utility/chart/footprint-tick-grid.util.js +167 -0
- package/dist/utility/chart/gesture-timing.leaf.d.ts +29 -0
- package/dist/utility/chart/gesture-timing.leaf.js +29 -0
- package/dist/utility/chart/governed-contract-coin.util.d.ts +22 -0
- package/dist/utility/chart/governed-contract-coin.util.js +39 -0
- package/dist/utility/chart/host-bar-placement.util.d.ts +107 -0
- package/dist/utility/chart/host-bar-placement.util.js +447 -0
- package/dist/utility/chart/index-host-tier.util.d.ts +31 -0
- package/dist/utility/chart/index-host-tier.util.js +118 -0
- package/dist/utility/chart/index-mode-admission.util.d.ts +34 -0
- package/dist/utility/chart/index-mode-admission.util.js +67 -0
- package/dist/utility/chart/indicator-error-message.util.d.ts +35 -0
- package/dist/utility/chart/indicator-error-message.util.js +44 -0
- package/dist/utility/chart/indicator-run-interval.util.d.ts +130 -0
- package/dist/utility/chart/indicator-run-interval.util.js +268 -0
- package/dist/utility/chart/kscript-apply-fingerprint.util.d.ts +65 -0
- package/dist/utility/chart/kscript-apply-fingerprint.util.js +357 -0
- package/dist/utility/chart/kscript-chart-flush.leaf.d.ts +22 -0
- package/dist/utility/chart/kscript-chart-flush.leaf.js +13 -0
- package/dist/utility/chart/kscript-data-interval-restriction.leaf.d.ts +6 -0
- package/dist/utility/chart/kscript-data-interval-restriction.leaf.js +27 -0
- package/dist/utility/chart/kscript-integration-decision.leaf.d.ts +89 -0
- package/dist/utility/chart/kscript-integration-decision.leaf.js +80 -0
- package/dist/utility/chart/kscript-live-coalesce.util.d.ts +76 -0
- package/dist/utility/chart/kscript-live-coalesce.util.js +156 -0
- package/dist/utility/chart/kscript-live-rest-pace.util.d.ts +34 -0
- package/dist/utility/chart/kscript-live-rest-pace.util.js +134 -0
- package/dist/utility/chart/kscript-live-source-identity.util.d.ts +98 -0
- package/dist/utility/chart/kscript-live-source-identity.util.js +121 -0
- package/dist/utility/chart/kscript-mounted-plot-set.leaf.d.ts +48 -0
- package/dist/utility/chart/kscript-mounted-plot-set.leaf.js +145 -0
- package/dist/utility/chart/kscript-perf-tracker.util.d.ts +243 -0
- package/dist/utility/chart/kscript-perf-tracker.util.js +522 -0
- package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +43 -0
- package/dist/utility/chart/kscript-run-interval-projection.util.js +471 -0
- package/dist/utility/chart/kscript-run-result-equality.util.d.ts +38 -0
- package/dist/utility/chart/kscript-run-result-equality.util.js +89 -0
- package/dist/utility/chart/kscript-settings-revision.leaf.d.ts +2 -0
- package/dist/utility/chart/kscript-settings-revision.leaf.js +12 -0
- package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +63 -0
- package/dist/utility/chart/kscript-source-degrade.leaf.js +68 -0
- package/dist/utility/chart/kscript-source-retention.util.d.ts +134 -0
- package/dist/utility/chart/kscript-source-retention.util.js +218 -0
- package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +57 -0
- package/dist/utility/chart/kscript-standin-identity.leaf.js +61 -0
- package/dist/utility/chart/kscript-titancharts-preparation.util.d.ts +15 -0
- package/dist/utility/chart/kscript-titancharts-preparation.util.js +376 -0
- package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +9 -0
- package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +130 -0
- package/dist/utility/chart/kscript-venue-policy.util.d.ts +217 -0
- package/dist/utility/chart/kscript-venue-policy.util.js +324 -0
- package/dist/utility/chart/live-cadence.util.d.ts +38 -0
- package/dist/utility/chart/live-cadence.util.js +37 -0
- package/dist/utility/chart/live-feed-series-match.leaf.d.ts +13 -0
- package/dist/utility/chart/live-feed-series-match.leaf.js +21 -0
- package/dist/utility/chart/local-engine-self-heal-backoff.util.d.ts +46 -0
- package/dist/utility/chart/local-engine-self-heal-backoff.util.js +46 -0
- package/dist/utility/chart/local-engine-uninit.leaf.d.ts +21 -0
- package/dist/utility/chart/local-engine-uninit.leaf.js +22 -0
- package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +62 -0
- package/dist/utility/chart/local-kscript-source-revalidation.util.js +123 -0
- package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +214 -0
- package/dist/utility/chart/local-kscript-warmup-depth.util.js +376 -0
- package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.d.ts +85 -0
- package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.js +197 -0
- package/dist/utility/chart/local-technical-script-range.leaf.d.ts +72 -0
- package/dist/utility/chart/local-technical-script-range.leaf.js +126 -0
- package/dist/utility/chart/mixed-mode.util.d.ts +167 -0
- package/dist/utility/chart/mixed-mode.util.js +139 -0
- package/dist/utility/chart/ohlcv-row-readiness.util.d.ts +36 -0
- package/dist/utility/chart/ohlcv-row-readiness.util.js +90 -0
- package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +19 -0
- package/dist/utility/chart/opra-user-scripts-gate.util.js +32 -0
- package/dist/utility/chart/overlay-execution-guard-key.leaf.d.ts +8 -0
- package/dist/utility/chart/overlay-execution-guard-key.leaf.js +10 -0
- package/dist/utility/chart/price-precision.util.d.ts +40 -0
- package/dist/utility/chart/price-precision.util.js +70 -0
- package/dist/utility/chart/profile-block-size.util.d.ts +64 -0
- package/dist/utility/chart/profile-block-size.util.js +141 -0
- package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.d.ts +11 -0
- package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.js +29 -0
- package/dist/utility/chart/protected-kscript-empty-output.util.d.ts +28 -0
- package/dist/utility/chart/protected-kscript-empty-output.util.js +84 -0
- package/dist/utility/chart/run-interval-unservable.leaf.d.ts +9 -0
- package/dist/utility/chart/run-interval-unservable.leaf.js +20 -0
- package/dist/utility/chart/run-interval-warmup.leaf.d.ts +19 -0
- package/dist/utility/chart/run-interval-warmup.leaf.js +35 -0
- package/dist/utility/chart/titan-constants.pin.d.ts +9 -5
- package/dist/utility/chart/titan-constants.pin.js +18 -5
- package/dist/utility/chart/warmup-backfill-retry.leaf.d.ts +9 -0
- package/dist/utility/chart/warmup-backfill-retry.leaf.js +9 -0
- package/dist/utility/chart/window-geometry.leaf.d.ts +119 -0
- package/dist/utility/chart/window-geometry.leaf.js +391 -0
- package/dist/utility/chart/window-owner.leaf.d.ts +19 -0
- package/dist/utility/chart/window-owner.leaf.js +24 -0
- package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +11 -2
- package/dist/utility/chart/wrun-bar-session-facts.util.js +10 -3
- package/dist/utility/chart/wrun-run-result.util.d.ts +5 -1
- package/dist/utility/chart/wrun-run-result.util.js +20 -14
- package/dist/utility/common/data-processing.util.d.ts +138 -0
- package/dist/utility/common/data-processing.util.js +346 -0
- package/dist/utility/common/visible-timeout.util.d.ts +13 -4
- package/dist/utility/common/visible-timeout.util.js +23 -8
- package/dist/utility/exchange-format.leaf.d.ts +1 -0
- package/dist/utility/exchange-format.leaf.js +47 -0
- package/dist/utility/html-escape.leaf.d.ts +11 -0
- package/dist/utility/html-escape.leaf.js +20 -0
- package/dist/utility/market-events/earnings-scope.util.d.ts +60 -0
- package/dist/utility/market-events/earnings-scope.util.js +92 -0
- package/dist/utility/market-events/market-events.util.d.ts +147 -0
- package/dist/utility/market-events/market-events.util.js +392 -0
- package/dist/utility/market-events/zoned-clock.util.d.ts +1 -0
- package/dist/utility/market-events/zoned-clock.util.js +11 -0
- package/dist/utility/options/option-venue-disclosure.util.d.ts +43 -0
- package/dist/utility/options/option-venue-disclosure.util.js +56 -0
- package/dist/utility/scriptEditor/package-semver.util.d.ts +51 -0
- package/dist/utility/scriptEditor/package-semver.util.js +120 -0
- package/dist/utility/scriptEditor/temp-script-id.util.d.ts +18 -0
- package/dist/utility/scriptEditor/temp-script-id.util.js +25 -0
- package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.d.ts +20 -0
- package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.js +81 -0
- package/dist/utility/v2/governed-tier.leaf.d.ts +103 -0
- package/dist/utility/v2/governed-tier.leaf.js +113 -0
- package/dist/utility/watchlist/import/import-request.leaf.d.ts +10 -0
- package/dist/utility/watchlist/import/import-request.leaf.js +10 -0
- package/dist/utility/wrun/sources/lanes/option_daily.d.ts +43 -15
- package/dist/utility/wrun/sources/lanes/option_daily.js +78 -20
- package/dist/utility/wrun/sources/lanes/option_stats_10m.d.ts +14 -10
- package/dist/utility/wrun/sources/lanes/option_stats_10m.js +5 -4
- package/dist/utility/wrun/sources/lanes/series.js +2 -2
- package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +22 -3
- package/dist/utility/wrun/sources/opra-option-lanes.util.js +38 -7
- package/dist/utility/wrun/sources/registry.js +31 -1
- package/dist/utility/wrun/sources/row-lane-registry.js +5 -5
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +49 -0
- package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +75 -20
- package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +49 -0
- package/dist/utility/wrun/sources/row-lanes/option_strikes.js +57 -47
- package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +36 -4
- package/dist/utility/wrun/sources/row-lanes/option_surface.js +6 -12
- package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +37 -3
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +128 -2
- package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +233 -51
- package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +0 -8
- package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +26 -24
- package/dist/utility/wrun/sources/wrun-row-lanes.util.js +85 -104
- package/dist/utility/wrun/wrun-alert-outputs.registry.d.ts +166 -0
- package/dist/utility/wrun/wrun-alert-outputs.registry.js +219 -0
- package/dist/utility/wrun/wrun-bar-count.util.d.ts +83 -0
- package/dist/utility/wrun/wrun-bar-count.util.js +259 -0
- package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +84 -0
- package/dist/utility/wrun/wrun-chart-context-names.util.js +186 -0
- package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +253 -0
- package/dist/utility/wrun/wrun-chart-market-facts.util.js +731 -0
- package/dist/utility/wrun/wrun-cloud-opra-stamp.util.d.ts +28 -0
- package/dist/utility/wrun/wrun-cloud-opra-stamp.util.js +45 -0
- package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +18 -0
- package/dist/utility/wrun/wrun-coin-lane-live.util.js +47 -0
- package/dist/utility/wrun/wrun-deadline.util.js +2 -1
- package/dist/utility/wrun/wrun-debug-output.util.d.ts +39 -0
- package/dist/utility/wrun/wrun-debug-output.util.js +63 -0
- package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +113 -0
- package/dist/utility/wrun/wrun-declared-warmup.util.js +181 -0
- package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +43 -0
- package/dist/utility/wrun/wrun-draft-legend-note.util.js +158 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +181 -0
- package/dist/utility/wrun/wrun-draft-overlay.util.js +357 -0
- package/dist/utility/wrun/wrun-draw-skipped.leaf.d.ts +16 -0
- package/dist/utility/wrun/wrun-draw-skipped.leaf.js +16 -0
- package/dist/utility/wrun/wrun-earnings-facts.util.d.ts +42 -0
- package/dist/utility/wrun/wrun-earnings-facts.util.js +131 -0
- package/dist/utility/wrun/wrun-first-run-depth.util.d.ts +32 -0
- package/dist/utility/wrun/wrun-first-run-depth.util.js +118 -0
- package/dist/utility/wrun/wrun-gate-plane-readers.util.d.ts +24 -0
- package/dist/utility/wrun/wrun-gate-plane-readers.util.js +31 -0
- package/dist/utility/wrun/wrun-held-lanes.util.d.ts +32 -0
- package/dist/utility/wrun/wrun-held-lanes.util.js +94 -0
- package/dist/utility/wrun/wrun-host-visible-clock.util.d.ts +2 -0
- package/dist/utility/wrun/wrun-host-visible-clock.util.js +17 -0
- package/dist/utility/wrun/wrun-host.service.d.ts +266 -0
- package/dist/utility/wrun/wrun-host.service.js +655 -0
- package/dist/utility/wrun/wrun-inert-legend.util.d.ts +33 -0
- package/dist/utility/wrun/wrun-inert-legend.util.js +125 -0
- package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +155 -0
- package/dist/utility/wrun/wrun-input-requirements.leaf.js +450 -0
- package/dist/utility/wrun/wrun-integration-route.util.d.ts +51 -0
- package/dist/utility/wrun/wrun-integration-route.util.js +59 -0
- package/dist/utility/wrun/wrun-latest-history.leaf.d.ts +8 -0
- package/dist/utility/wrun/wrun-latest-history.leaf.js +8 -0
- package/dist/utility/wrun/wrun-legend-hover.lazy.d.ts +12 -0
- package/dist/utility/wrun/wrun-legend-hover.lazy.js +96 -0
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +21 -0
- package/dist/utility/wrun/wrun-live-hidden-hold.util.d.ts +23 -0
- package/dist/utility/wrun/wrun-live-hidden-hold.util.js +13 -0
- package/dist/utility/wrun/wrun-live-intake.util.d.ts +374 -0
- package/dist/utility/wrun/wrun-live-intake.util.js +2027 -0
- package/dist/utility/wrun/wrun-live-patch.util.d.ts +116 -0
- package/dist/utility/wrun/wrun-live-patch.util.js +523 -0
- package/dist/utility/wrun/wrun-live-tick.util.d.ts +619 -0
- package/dist/utility/wrun/wrun-live-tick.util.js +4974 -0
- package/dist/utility/wrun/wrun-loading-owner.util.d.ts +58 -0
- package/dist/utility/wrun/wrun-loading-owner.util.js +89 -0
- package/dist/utility/wrun/wrun-official-scope.leaf.d.ts +29 -0
- package/dist/utility/wrun/wrun-official-scope.leaf.js +36 -0
- package/dist/utility/wrun/wrun-oi-lane.util.d.ts +27 -0
- package/dist/utility/wrun/wrun-oi-lane.util.js +42 -0
- package/dist/utility/wrun/wrun-opra-stats.leaf.d.ts +29 -10
- package/dist/utility/wrun/wrun-opra-stats.leaf.js +29 -10
- package/dist/utility/wrun/wrun-options-stop.util.d.ts +52 -0
- package/dist/utility/wrun/wrun-options-stop.util.js +123 -0
- package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +719 -0
- package/dist/utility/wrun/wrun-overlay-drivers.util.js +1180 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +50 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +131 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +118 -0
- package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +466 -0
- package/dist/utility/wrun/wrun-overlay-metadata.util.d.ts +45 -0
- package/dist/utility/wrun/wrun-overlay-metadata.util.js +112 -0
- package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +114 -0
- package/dist/utility/wrun/wrun-overlay-recovery.util.js +971 -0
- package/dist/utility/wrun/wrun-overlay-run.util.d.ts +858 -0
- package/dist/utility/wrun/wrun-overlay-run.util.js +11013 -0
- package/dist/utility/wrun/wrun-panel-mount.lazy.d.ts +10 -0
- package/dist/utility/wrun/wrun-panel-mount.lazy.js +68 -0
- package/dist/utility/wrun/wrun-panel-mount.util.d.ts +392 -0
- package/dist/utility/wrun/wrun-panel-mount.util.js +2346 -0
- package/dist/utility/wrun/wrun-param-map.util.d.ts +19 -4
- package/dist/utility/wrun/wrun-param-map.util.js +40 -47
- package/dist/utility/wrun/wrun-param-values.util.d.ts +9 -3
- package/dist/utility/wrun/wrun-param-values.util.js +5 -5
- package/dist/utility/wrun/wrun-pause-dim.util.d.ts +52 -0
- package/dist/utility/wrun/wrun-pause-dim.util.js +153 -0
- package/dist/utility/wrun/wrun-plot-gate.types.d.ts +23 -0
- package/dist/utility/wrun/wrun-plot-gate.types.js +7 -0
- package/dist/utility/wrun/wrun-prefix-cohort.util.d.ts +93 -0
- package/dist/utility/wrun/wrun-prefix-cohort.util.js +484 -0
- package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +114 -0
- package/dist/utility/wrun/wrun-prefix-lanes.util.js +486 -0
- package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +317 -0
- package/dist/utility/wrun/wrun-prefix-proof.util.js +630 -0
- package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +73 -0
- package/dist/utility/wrun/wrun-refusal-surface.util.js +380 -0
- package/dist/utility/wrun/wrun-refusal-text.util.d.ts +15 -0
- package/dist/utility/wrun/wrun-refusal-text.util.js +40 -0
- package/dist/utility/wrun/wrun-replay-lane.util.d.ts +139 -0
- package/dist/utility/wrun/wrun-replay-lane.util.js +520 -0
- package/dist/utility/wrun/wrun-replay-rows.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-replay-rows.util.js +172 -0
- package/dist/utility/wrun/wrun-row-source-factory.d.ts +53 -0
- package/dist/utility/wrun/wrun-row-source-factory.js +435 -0
- package/dist/utility/wrun/wrun-run-cells.util.d.ts +36 -0
- package/dist/utility/wrun/wrun-run-cells.util.js +46 -0
- package/dist/utility/wrun/wrun-run-interval-projection.types.d.ts +14 -0
- package/dist/utility/wrun/wrun-run-interval-projection.types.js +1 -0
- package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +133 -0
- package/dist/utility/wrun/wrun-run-interval-session.util.js +121 -0
- package/dist/utility/wrun/wrun-run-interval.util.d.ts +98 -0
- package/dist/utility/wrun/wrun-run-interval.util.js +207 -0
- package/dist/utility/wrun/wrun-run-retained.util.d.ts +122 -0
- package/dist/utility/wrun/wrun-run-retained.util.js +255 -0
- package/dist/utility/wrun/wrun-sandbox-row-source.d.ts +184 -0
- package/dist/utility/wrun/wrun-sandbox-row-source.js +444 -0
- package/dist/utility/wrun/wrun-script-inputs.util.js +4 -4
- package/dist/utility/wrun/wrun-series-stream.util.d.ts +86 -0
- package/dist/utility/wrun/wrun-series-stream.util.js +537 -0
- package/dist/utility/wrun/wrun-sheet-remembered.util.d.ts +21 -0
- package/dist/utility/wrun/wrun-sheet-remembered.util.js +36 -0
- package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.d.ts +7 -0
- package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.js +12 -0
- package/dist/utility/wrun/wrun-socket-row-source.js +4 -2
- package/dist/utility/wrun/wrun-source-rows.util.d.ts +175 -3
- package/dist/utility/wrun/wrun-source-rows.util.js +294 -8
- package/dist/utility/wrun/wrun-stats-strip.util.d.ts +46 -0
- package/dist/utility/wrun/wrun-stats-strip.util.js +87 -0
- package/dist/utility/wrun/wrun-table-chrome.util.d.ts +163 -0
- package/dist/utility/wrun/wrun-table-chrome.util.js +557 -0
- package/dist/utility/wrun/wrun-text-params.util.d.ts +11 -6
- package/dist/utility/wrun/wrun-text-params.util.js +19 -30
- package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +64 -0
- package/dist/utility/wrun/wrun-transient-rerun.util.js +317 -0
- package/dist/utility/wrun/wrun-twin-lookback.util.d.ts +10 -0
- package/dist/utility/wrun/wrun-twin-lookback.util.js +43 -0
- package/dist/utility/wrun/wrun-warmup-head-store.util.d.ts +41 -0
- package/dist/utility/wrun/wrun-warmup-head-store.util.js +120 -0
- package/dist/utility/wrun-alert-params.leaf.d.ts +24 -0
- package/dist/utility/wrun-alert-params.leaf.js +24 -0
- package/dist/utils/replay/replay-buffer-math.d.ts +148 -0
- package/dist/utils/replay/replay-buffer-math.js +684 -0
- package/dist/workers/wrun/wrun-abi-host.d.ts +190 -0
- package/dist/workers/wrun/wrun-abi-host.js +1201 -0
- package/dist/workers/wrun/wrun-engine-handler.d.ts +37 -0
- package/dist/workers/wrun/wrun-engine-handler.js +211 -0
- package/package.json +3 -3
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whether a run result fits the plot set an overlay has mounted (a leaf of
|
|
3
|
+
* utility/chart/kscript-titancharts-integration.util.ts; P2/inventory.md section 1.1): the plot-set growth a range
|
|
4
|
+
* refresh cannot merge, and the output matching it rests on (an output's key and plot type, its rows, a run result's
|
|
5
|
+
* output entries, the incoming outputs a live refresh plan matches against the mount). The wrun executor's integration
|
|
6
|
+
* route reads the fit. Pure: it reads package modules only (the run-result shape, the container key, the main-grid
|
|
7
|
+
* stages' plot type), no state, so it moves into the chart-host package with the phase 2 closure; the titan adapter
|
|
8
|
+
* imports the shared helpers back and re-exports the two fit functions.
|
|
9
|
+
*/
|
|
10
|
+
import { isRecord } from './kscript-run-result-shape.util.js';
|
|
11
|
+
import { KSCRIPT_CONTAINER_OUTPUT_KEY } from './kscript-titancharts-container.util.js';
|
|
12
|
+
import { plotTypeOf } from './kscript-main-grid-stages.util.js';
|
|
13
|
+
export function outputRows(output) {
|
|
14
|
+
if (!isRecord(output))
|
|
15
|
+
return undefined;
|
|
16
|
+
for (const candidate of [output.data, output.rawData, output.activeData]) {
|
|
17
|
+
if (Array.isArray(candidate))
|
|
18
|
+
return candidate;
|
|
19
|
+
}
|
|
20
|
+
return undefined;
|
|
21
|
+
}
|
|
22
|
+
function mountedOutputKey(output, fallbackKey, options = {}) {
|
|
23
|
+
if (!isRecord(output))
|
|
24
|
+
return fallbackKey;
|
|
25
|
+
const includeId = options.includeId !== false;
|
|
26
|
+
for (const value of [
|
|
27
|
+
output.plotId,
|
|
28
|
+
includeId ? output.id : undefined,
|
|
29
|
+
output.key,
|
|
30
|
+
output.outputKey,
|
|
31
|
+
output.mainPlotKey,
|
|
32
|
+
output.plotKey,
|
|
33
|
+
]) {
|
|
34
|
+
if (typeof value === 'string' && value.trim())
|
|
35
|
+
return value;
|
|
36
|
+
}
|
|
37
|
+
return fallbackKey;
|
|
38
|
+
}
|
|
39
|
+
export function outputDescriptor(output, fallbackKey, options = {}) {
|
|
40
|
+
return {
|
|
41
|
+
key: mountedOutputKey(output, fallbackKey, options),
|
|
42
|
+
plotType: isRecord(output) ? plotTypeOf(output) : undefined,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
function descriptorsMatchByKey(current, incoming) {
|
|
46
|
+
if (!current.key || !incoming.key || current.key !== incoming.key)
|
|
47
|
+
return false;
|
|
48
|
+
if (current.plotType && incoming.plotType && current.plotType !== incoming.plotType)
|
|
49
|
+
return false;
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
export function runResultOutputEntries(runResult) {
|
|
53
|
+
if (!isRecord(runResult) || !isRecord(runResult.outputs))
|
|
54
|
+
return [];
|
|
55
|
+
return Object.entries(runResult.outputs).filter((entry) => isRecord(entry[1]));
|
|
56
|
+
}
|
|
57
|
+
export function buildIncomingLiveRefreshOutputs(runResult) {
|
|
58
|
+
return runResultOutputEntries(runResult).flatMap(([key, output]) => {
|
|
59
|
+
const descriptor = outputDescriptor(output, key);
|
|
60
|
+
if (!descriptor.key)
|
|
61
|
+
return [];
|
|
62
|
+
return [
|
|
63
|
+
{
|
|
64
|
+
key,
|
|
65
|
+
output,
|
|
66
|
+
descriptor,
|
|
67
|
+
rows: outputRows(output),
|
|
68
|
+
},
|
|
69
|
+
];
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
export function findIncomingLiveRefreshOutput(outputByKey, mountedOutput, options = {}) {
|
|
73
|
+
const mountedDescriptor = outputDescriptor(mountedOutput, undefined, options);
|
|
74
|
+
if (!mountedDescriptor.key)
|
|
75
|
+
return undefined;
|
|
76
|
+
const incoming = outputByKey.get(mountedDescriptor.key);
|
|
77
|
+
if (!incoming || !descriptorsMatchByKey(mountedDescriptor, incoming.descriptor))
|
|
78
|
+
return undefined;
|
|
79
|
+
return incoming;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Incoming outputs (keys) the mounted-rows fast path cannot patch: no mounted
|
|
83
|
+
* row (parent or nested) matches their key / plot type, so a rows refresh would
|
|
84
|
+
* drop them. The local-run route treats a non-empty answer as plot-set growth
|
|
85
|
+
* and takes the remount (the field case: an order-book script whose fill
|
|
86
|
+
* plots only appear once the degraded book source lands). Same matching as
|
|
87
|
+
* the refresh plan, so the answer is exactly "what the plan would drop".
|
|
88
|
+
*/
|
|
89
|
+
export function kscriptRunResultOutputsWithoutMountedRow(meta, runResult) {
|
|
90
|
+
const incoming = buildIncomingLiveRefreshOutputs(runResult);
|
|
91
|
+
if (incoming.length === 0)
|
|
92
|
+
return [];
|
|
93
|
+
const outputByKey = new Map(incoming.map((entry) => [entry.descriptor.key, entry]));
|
|
94
|
+
const matched = new Set();
|
|
95
|
+
const parent = findIncomingLiveRefreshOutput(outputByKey, meta, { includeId: false });
|
|
96
|
+
if (parent)
|
|
97
|
+
matched.add(parent.descriptor.key);
|
|
98
|
+
if (Array.isArray(meta.nestedMeta)) {
|
|
99
|
+
for (const nested of meta.nestedMeta) {
|
|
100
|
+
if (!isRecord(nested))
|
|
101
|
+
continue;
|
|
102
|
+
const hit = findIncomingLiveRefreshOutput(outputByKey, nested);
|
|
103
|
+
if (hit)
|
|
104
|
+
matched.add(hit.descriptor.key);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
// The synthetic container output is the parent's own key, never a user
|
|
108
|
+
// plot: it must not read as growth on a legacy-mounted parent.
|
|
109
|
+
return incoming
|
|
110
|
+
.filter((entry) => !matched.has(entry.descriptor.key) && entry.key !== KSCRIPT_CONTAINER_OUTPUT_KEY)
|
|
111
|
+
.map((entry) => entry.key)
|
|
112
|
+
.sort();
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* The prepared outputs of a run result no mounted row matches (container and
|
|
116
|
+
* known-unmountable keys aside): the plot-set GROWTH a range refresh cannot
|
|
117
|
+
* merge. Judged against the mount, never against the previous result: the
|
|
118
|
+
* engine's live tick posts only the outputs that changed, so the last
|
|
119
|
+
* integrated result is not the plot set (2026-09-14 field dump: one page
|
|
120
|
+
* remount per reload from that comparison).
|
|
121
|
+
*/
|
|
122
|
+
export function mountedPlotSetGrowth(meta, runResult, ignoreOutputKeys) {
|
|
123
|
+
return kscriptRunResultOutputsWithoutMountedRow(meta, runResult).filter((key) => !(ignoreOutputKeys?.has(key) ?? false));
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Whether a run result fits the MOUNTED plot set: none of its outputs lacks a
|
|
127
|
+
* mounted row (mountedPlotSetGrowth), and a result carrying no plot outputs
|
|
128
|
+
* fits a mount carrying no plots (drawings-only scripts). Growth only: a
|
|
129
|
+
* mounted plot the run stopped carrying (an hline a script prints on some
|
|
130
|
+
* windows only) keeps its rows through a merge exactly as it does through a
|
|
131
|
+
* live tick, and a script whose only plot is a known-unmountable anchor line
|
|
132
|
+
* (drawings-only scripts) has nothing to grow. Requiring every mounted plot
|
|
133
|
+
* in the result remounted both on every page (2026-09-14 05:26 dump).
|
|
134
|
+
*/
|
|
135
|
+
export function mountedPlotSetMatchesRunResult(meta, runResult, ignoreOutputKeys) {
|
|
136
|
+
if (!isRecord(runResult))
|
|
137
|
+
return false;
|
|
138
|
+
if (runResultOutputEntries(runResult).length === 0) {
|
|
139
|
+
// A drawings-only script posts no plot outputs at all: nothing to grow
|
|
140
|
+
// when nothing is mounted (2026-09-14 14:40 dump: one page remount per
|
|
141
|
+
// reload for Big Trades under the "no outputs never fits" rule).
|
|
142
|
+
return !Array.isArray(meta.nestedMeta) || meta.nestedMeta.length === 0;
|
|
143
|
+
}
|
|
144
|
+
return mountedPlotSetGrowth(meta, runResult, ignoreOutputKeys).length === 0;
|
|
145
|
+
}
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-indicator kScript performance tracker.
|
|
3
|
+
*
|
|
4
|
+
* Records what is exactly attributable to one overlay on this device:
|
|
5
|
+
* - main-thread integration duration per applied update (bracketed by the
|
|
6
|
+
* overlay execution guard's measure calls),
|
|
7
|
+
* - main-thread render cost as ms of chart paint per second (read from
|
|
8
|
+
* titan's paint budget, or drained from its per-plot draw accounting, by
|
|
9
|
+
* the render-cost sampler), and
|
|
10
|
+
* - the counted volume of the run output it shipped (rows / series / bytes
|
|
11
|
+
* estimated from row shape, never by serializing the payload).
|
|
12
|
+
*
|
|
13
|
+
* Each signal keeps its own sliding-window median with cold-start exclusion
|
|
14
|
+
* and enter/exit hysteresis; the overlay is "slow" when EITHER signal
|
|
15
|
+
* convicts, and `slowCause` names which. The chart store surfaces the slow
|
|
16
|
+
* state as a legend diagnostic; the hard auto-pause stays owned by the
|
|
17
|
+
* overlay execution guard's breaker. Network/data-fetch time is deliberately
|
|
18
|
+
* never recorded here.
|
|
19
|
+
*
|
|
20
|
+
* Keys are overlay execution guard keys (`${chartIndex}:${indicatorId}`).
|
|
21
|
+
* This module must stay dependency-free (the guard imports it).
|
|
22
|
+
*
|
|
23
|
+
* Relationship to the gesture-apply cost EMA (gesture-apply-budget.util.ts):
|
|
24
|
+
* both observe main-thread apply cost per overlay, but they answer different
|
|
25
|
+
* questions with different lifecycles. The EMA is a fast-decaying pacing
|
|
26
|
+
* signal for the gesture scheduler (reset on gesture boundaries); this module
|
|
27
|
+
* is a windowed-median verdict with hysteresis for USER-FACING attribution,
|
|
28
|
+
* reset with the overlay's guard state. Merging them would couple scheduler
|
|
29
|
+
* pacing to legend UX; keep them separate on purpose.
|
|
30
|
+
*
|
|
31
|
+
* Samples pool live-tick applies with pan/historical applies (endMeasure has
|
|
32
|
+
* no stage tag). The median plus an enter threshold ABOVE the documented
|
|
33
|
+
* normal apply band (50-70 ms wake-herd merges, see GESTURE_APPLY_UNKNOWN_COST_MS)
|
|
34
|
+
* keeps burst pan applies from convicting a healthy overlay; per-stage
|
|
35
|
+
* sampling is a possible follow-up if field data shows false positives.
|
|
36
|
+
*/
|
|
37
|
+
export declare const KSCRIPT_PERF_SLOW_ENTER_MEDIAN_MS = 80;
|
|
38
|
+
export declare const KSCRIPT_PERF_SLOW_EXIT_MEDIAN_MS = 50;
|
|
39
|
+
export declare const KSCRIPT_PERF_SAMPLE_WINDOW_MS = 60000;
|
|
40
|
+
export declare const KSCRIPT_PERF_MIN_SAMPLES = 5;
|
|
41
|
+
/** A slow verdict may retire on fewer samples than it took to convict. */
|
|
42
|
+
export declare const KSCRIPT_PERF_EXIT_MIN_SAMPLES = 3;
|
|
43
|
+
export declare const KSCRIPT_PERF_COLD_START_SKIP = 2;
|
|
44
|
+
export declare const KSCRIPT_PERF_MAX_SAMPLES = 24;
|
|
45
|
+
/**
|
|
46
|
+
* The chart apply budget's window (D11, GUARDS-12): every LIVE apply sample
|
|
47
|
+
* past the cold start is also kept in its key's ledger for this long, so the
|
|
48
|
+
* shed ladder can sum the main-thread live apply time of a chart's scripts per
|
|
49
|
+
* second (kscriptChartApplyLoad). The median ring above keeps 24 samples of
|
|
50
|
+
* every kind; this ledger keeps every live apply of the window.
|
|
51
|
+
*/
|
|
52
|
+
export declare const KSCRIPT_CHART_APPLY_WINDOW_MS = 10000;
|
|
53
|
+
/**
|
|
54
|
+
* Render-cost thresholds, in ms of main-thread paint per second attributable
|
|
55
|
+
* to one indicator (a 1000 ms/s budget shared by everything on the page).
|
|
56
|
+
*
|
|
57
|
+
* Calibration from the two QA perf dumps that motivated the signal (per-drain
|
|
58
|
+
* sums over titan's per-plot draw accounting, normalized by drain spacing):
|
|
59
|
+
* - panning session, Liquidation Bands (8 deltaFillSpline plots):
|
|
60
|
+
* median 198.8 ms/s, p90 611.1, max 688.6 -> must convict.
|
|
61
|
+
* - same panning session, next-heaviest indicator: median 14.4 ms/s,
|
|
62
|
+
* max 38.0 -> must stay silent.
|
|
63
|
+
* - idle session, same script: median 7.8 ms/s, lone spike 73.9
|
|
64
|
+
* -> must stay silent.
|
|
65
|
+
* Enter at 100 ms/s sits 2x under the guilty median and 2.6x above the worst
|
|
66
|
+
* single innocent sample, so an innocent windowed median can never cross it.
|
|
67
|
+
*
|
|
68
|
+
* The exit threshold is wider than the apply signal's band because paint
|
|
69
|
+
* cost is pan-gated and bursty: the panning session contained a ~6 drain
|
|
70
|
+
* lull whose windowed median dipped to 46.3 ms/s before the storm resumed.
|
|
71
|
+
* Exiting there would flap the verdict and re-arm the toast mid-session, so
|
|
72
|
+
* exit sits BELOW inter-burst lull medians (46.3) and comfortably above
|
|
73
|
+
* genuine idle medians (7.8), which still retire the verdict promptly.
|
|
74
|
+
*/
|
|
75
|
+
export declare const KSCRIPT_RENDER_SLOW_ENTER_MS_PER_SEC = 100;
|
|
76
|
+
export declare const KSCRIPT_RENDER_SLOW_EXIT_MS_PER_SEC = 30;
|
|
77
|
+
/**
|
|
78
|
+
* Display damping for the convicted paint rate. The chip communicates
|
|
79
|
+
* magnitude, not a live meter: re-rendering the legend for every median
|
|
80
|
+
* wiggle would rewrite Pinia diagnostics and force a titan legend refresh at
|
|
81
|
+
* drain cadence during the very pan storms being convicted. While convicted,
|
|
82
|
+
* the displayed rate is an anchor that re-anchors on a 2x WORSENING (the
|
|
83
|
+
* label must keep pace with a growing storm) but only on a 4x improvement:
|
|
84
|
+
* calibration lull medians dip 2-3x below the anchor without the episode
|
|
85
|
+
* ending, and a warning may briefly overstate but must not flap. Replaying
|
|
86
|
+
* the panning dump: 2 legend writes across the whole burst (conviction at
|
|
87
|
+
* ~140 ms, one re-anchor to ~330 ms).
|
|
88
|
+
*/
|
|
89
|
+
export declare const KSCRIPT_RENDER_DISPLAY_REANCHOR_UP_RATIO = 2;
|
|
90
|
+
export declare const KSCRIPT_RENDER_DISPLAY_REANCHOR_DOWN_RATIO = 4;
|
|
91
|
+
export type KScriptPerfLevel = 'healthy' | 'slow';
|
|
92
|
+
export type KScriptPerfSlowCause = 'apply' | 'render' | 'both';
|
|
93
|
+
export interface KScriptPerfVolume {
|
|
94
|
+
rows: number;
|
|
95
|
+
series: number;
|
|
96
|
+
bytesEstimate: number;
|
|
97
|
+
/** Rows in the run window (outputRows.length). */
|
|
98
|
+
bars?: number;
|
|
99
|
+
/** Heatmap cells mounted (rows x levels over the heatmap children). */
|
|
100
|
+
cells?: number;
|
|
101
|
+
}
|
|
102
|
+
export interface KScriptPerfStats {
|
|
103
|
+
level: KScriptPerfLevel;
|
|
104
|
+
/** True only on the statsFor() call that flipped the level. */
|
|
105
|
+
transitioned: boolean;
|
|
106
|
+
/** Which signal(s) hold the slow verdict; null while healthy. */
|
|
107
|
+
slowCause: KScriptPerfSlowCause | null;
|
|
108
|
+
medianMs: number | null;
|
|
109
|
+
worstMs: number | null;
|
|
110
|
+
sampleCount: number;
|
|
111
|
+
/** Windowed median of ms-of-paint-per-second charged to this indicator. */
|
|
112
|
+
renderMsPerSecond: number | null;
|
|
113
|
+
/**
|
|
114
|
+
* The same windowed median, never damped: `renderMsPerSecond` holds the
|
|
115
|
+
* display anchor while render-convicted, and a decision (the shed ladder,
|
|
116
|
+
* kscript-perf-shed.util) must read the measured rate instead.
|
|
117
|
+
*/
|
|
118
|
+
renderFreshMsPerSecond: number | null;
|
|
119
|
+
renderSampleCount: number;
|
|
120
|
+
volume: KScriptPerfVolume | null;
|
|
121
|
+
lastSampleAt: number | null;
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* One apply sample (the guard's measure, a wrun host build). `live`: the apply integrated a live tick (a local
|
|
125
|
+
* kScript's live update or its commit, a protected or hosted live frame, a wrun live tick). Every sample feeds the
|
|
126
|
+
* windowed median; only live ones also enter the chart's apply ledger (kscriptChartApplyLoad): a mount, a history
|
|
127
|
+
* page, a wake resync, a timeframe switch or a settings recompute is a one-off the chart sum must not pace.
|
|
128
|
+
*/
|
|
129
|
+
export declare function recordKScriptPerfSample(key: string, ms: number, at?: number, live?: boolean): void;
|
|
130
|
+
/** One key's apply load inside the chart window. */
|
|
131
|
+
export interface KScriptChartApplyShare {
|
|
132
|
+
key: string;
|
|
133
|
+
/** Apply ms the key's samples carried in the window. */
|
|
134
|
+
ms: number;
|
|
135
|
+
/** The applies that carried them. */
|
|
136
|
+
applies: number;
|
|
137
|
+
}
|
|
138
|
+
/** A chart's apply load: what the chart apply budget (kscript-perf-shed.util) judges. */
|
|
139
|
+
export interface KScriptChartApplyLoad {
|
|
140
|
+
/** Apply ms per second over the window, the listed keys summed. */
|
|
141
|
+
msPerSecond: number;
|
|
142
|
+
/** Every listed key with an apply in the window, the costliest first. */
|
|
143
|
+
keys: KScriptChartApplyShare[];
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* The live apply load of one chart's keys (`includeKey` admits them, the
|
|
147
|
+
* ladder passes its paceable scripts) over the last
|
|
148
|
+
* KSCRIPT_CHART_APPLY_WINDOW_MS: the live applies this tracker sampled (past
|
|
149
|
+
* each key's cold start, outside a user settings burst), summed. The sum always divides by the whole window, so a window
|
|
150
|
+
* that is not full yet understates and never overstates. A key's reset drops
|
|
151
|
+
* its share at once (a step up the ladder starts it over).
|
|
152
|
+
*/
|
|
153
|
+
export declare function kscriptChartApplyLoad(chartIndex: number, now?: number, includeKey?: (key: string) => boolean): KScriptChartApplyLoad;
|
|
154
|
+
/**
|
|
155
|
+
* One render sample, in ms of paint per second. `windowMs`: the rate is a mean over that span ending
|
|
156
|
+
* at `at` (the engine paint budget's rolling 10 s, paint-budget-arm.util); while that span reaches
|
|
157
|
+
* back before the entry's first render sample it still carries paint from before the add or the
|
|
158
|
+
* reset that started the entry (the mount, the previous shed rung's tier), so it is cold start too.
|
|
159
|
+
* Without it (a drained window) the count-only cold start below is the whole rule.
|
|
160
|
+
*/
|
|
161
|
+
export declare function recordKScriptRenderCostSample(key: string, msPerSecond: number, at?: number, windowMs?: number): void;
|
|
162
|
+
export interface KScriptRenderCostFoldResult {
|
|
163
|
+
/** Indicators that received a render sample from this snapshot. */
|
|
164
|
+
recordedIndicatorIds: string[];
|
|
165
|
+
/** Snapshot keys whose owner segment matched no known overlay id. */
|
|
166
|
+
unmatchedOwnerKeys: number;
|
|
167
|
+
/** Draw cost carried by those unmatched keys, in ms. */
|
|
168
|
+
unmatchedOwnerMs: number;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Fold one drained per-plot draw-cost snapshot into render-cost samples.
|
|
172
|
+
*
|
|
173
|
+
* Snapshot keys are titan draw-accounting keys whose first `:` segment is the
|
|
174
|
+
* owning overlay id. Titan's container-native apply path mounts kScript
|
|
175
|
+
* nested plots as `<indicatorId>:<plotKey>` (nestedPlotObjectId), so their
|
|
176
|
+
* draw-cost keys read `<indicatorId>:<plotKey>:<renderer>`; native overlays
|
|
177
|
+
* read `<id>:<renderer>`. Titan's non-container-native apply path
|
|
178
|
+
* (updateMetadataWithRunResult -> applyRunResult without containerNative)
|
|
179
|
+
* keeps RAW output keys (or generated ids) as nested ids, so its draw-cost
|
|
180
|
+
* keys carry no indicator prefix and match nothing here.
|
|
181
|
+
*
|
|
182
|
+
* That is why absence is sample-STARVATION, never a zero sample: an
|
|
183
|
+
* indicator whose keys are unprefixed still paints, and manufacturing zeros
|
|
184
|
+
* for it would actively retire an earned verdict. Starved verdicts decay
|
|
185
|
+
* through window expiry instead. The orphaned cost stays observable through
|
|
186
|
+
* the unmatched-owner counters (owners matching neither a kScript indicator
|
|
187
|
+
* nor any other known overlay id).
|
|
188
|
+
*
|
|
189
|
+
* `sampleWindowMs`: every value is a rate averaged over that span (the engine
|
|
190
|
+
* paint budget's rolling window, read with `elapsedMs` 1000), passed on to
|
|
191
|
+
* recordKScriptRenderCostSample's windowed cold start.
|
|
192
|
+
*/
|
|
193
|
+
export declare function recordKScriptRenderCostFromSnapshot(chartIndex: number, snapshot: Record<string, {
|
|
194
|
+
ms: number;
|
|
195
|
+
calls: number;
|
|
196
|
+
}>, elapsedMs: number, indicatorIds: readonly string[], at?: number, otherKnownOwnerIds?: readonly string[], sampleWindowMs?: number): KScriptRenderCostFoldResult;
|
|
197
|
+
export declare function recordKScriptPerfVolume(key: string, volume: KScriptPerfVolume | null): void;
|
|
198
|
+
/**
|
|
199
|
+
* Merge the parts of a run's volume that no canonical result carries (the bars of the run
|
|
200
|
+
* window, the heatmap cells mounted) into the key's last recorded volume. A key with no volume
|
|
201
|
+
* yet gets a zero-row one, so an extra recorded before the run's own volume is never lost.
|
|
202
|
+
*/
|
|
203
|
+
export declare function recordKScriptPerfVolumeExtras(key: string, extras: {
|
|
204
|
+
bars?: number;
|
|
205
|
+
cells?: number;
|
|
206
|
+
}): void;
|
|
207
|
+
export declare function kscriptPerfStatsFor(key: string, now?: number): KScriptPerfStats;
|
|
208
|
+
/**
|
|
209
|
+
* Warning-toast gate, owned here so every tracker reset path also resets the
|
|
210
|
+
* latches. Two latches stack:
|
|
211
|
+
* - the EPISODE latch (slowToastConsumed) grants at most one toast per slow
|
|
212
|
+
* episode regardless of which signals convict, re-armed on recovery;
|
|
213
|
+
* - the MOUNT latch (renderSlowToastConsumed) additionally suppresses
|
|
214
|
+
* render-only re-convictions for the overlay's whole mount: 1 Hz sampling
|
|
215
|
+
* recovers on every pan/idle boundary, so an episodic latch alone would
|
|
216
|
+
* re-toast ordinary panning every couple of minutes. Only a tracker reset
|
|
217
|
+
* (remove, resume, chart teardown) re-arms it.
|
|
218
|
+
* An apply conviction is always new information and only defers to the
|
|
219
|
+
* episode latch, keeping shipped apply behavior unchanged.
|
|
220
|
+
*/
|
|
221
|
+
export declare function consumeKScriptPerfSlowToastGate(key: string): boolean;
|
|
222
|
+
export declare function resetKScriptPerfTracking(key: string): void;
|
|
223
|
+
/** Guard keys are `${chartIndex}:${indicatorId}`; the trailing ':' keeps chart 1 from matching chart 10. */
|
|
224
|
+
export declare function resetKScriptPerfTrackingForChart(chartIndex: number): void;
|
|
225
|
+
export declare function resetAllKScriptPerfTracking(): void;
|
|
226
|
+
/**
|
|
227
|
+
* Counted volume of a run result's plot outputs. Reads array lengths and one
|
|
228
|
+
* sample row per output; never serializes. Bytes assume 8 bytes per value,
|
|
229
|
+
* which is the right order of magnitude for numeric plot rows crossing the
|
|
230
|
+
* worker boundary. `bars` is the run window's bar count: the result's own
|
|
231
|
+
* count (`barCount`, `bars`), else its timeline (`combinedTimes`), else its
|
|
232
|
+
* longest plot output (one row per bar). A canvas-only result (a browser-run
|
|
233
|
+
* Indicator's heatmaps, profiles and matrices ride `childOverlays`, never
|
|
234
|
+
* `outputs`) is measured too, with no plot rows; only a result with nothing
|
|
235
|
+
* to measure at all answers null, so a failed run's summary never replaces
|
|
236
|
+
* the last good volume.
|
|
237
|
+
*/
|
|
238
|
+
export declare function measureKScriptRunResultVolume(runResult: unknown): KScriptPerfVolume | null;
|
|
239
|
+
/** "~240 ms" style bucket so legend text stays stable between minor median moves. */
|
|
240
|
+
export declare function formatKScriptPerfMedian(medianMs: number): string;
|
|
241
|
+
/** Same "~200 ms" bucketing for the paint-per-second rate. */
|
|
242
|
+
export declare function formatKScriptPerfRenderRate(msPerSecond: number): string;
|
|
243
|
+
export declare function formatKScriptPerfSummary(stats: KScriptPerfStats): string;
|