gloomberb 0.20.3 → 0.20.4

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 (154) hide show
  1. package/package.json +1 -1
  2. package/src/account/auth-dialog.tsx +17 -0
  3. package/src/api-client/data.ts +6 -0
  4. package/src/api-client/fx-interventions.ts +64 -0
  5. package/src/api-client/index.ts +1 -0
  6. package/src/api-client/release-summaries.ts +21 -0
  7. package/src/app/keybindings/actions.ts +2 -2
  8. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  9. package/src/cli/commands/market.ts +77 -1
  10. package/src/cli/commands/news-search.ts +1 -3
  11. package/src/cli/commands/plugins.ts +27 -5
  12. package/src/cli/commands/system.ts +19 -3
  13. package/src/cli/commands/ticker.ts +60 -19
  14. package/src/cli/index.ts +8 -8
  15. package/src/cli/pane-functions/function-help.ts +3 -3
  16. package/src/cli/report-tables.ts +18 -6
  17. package/src/cli/result.ts +15 -7
  18. package/src/cli/types.ts +2 -0
  19. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  20. package/src/components/chart/composite/composite-chart.tsx +54 -13
  21. package/src/components/chart/composite/event-captions.ts +109 -0
  22. package/src/components/chart/composite/event-guides.ts +74 -0
  23. package/src/components/chart/composite/rasterizer.ts +2 -0
  24. package/src/components/chart/composite/text-renderer.ts +2 -0
  25. package/src/components/chart/composite/types.ts +31 -0
  26. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  27. package/src/components/command-bar/routes/root/provider-search.ts +5 -4
  28. package/src/components/command-bar/routes/ticker-search/results.ts +51 -0
  29. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  30. package/src/components/layout/detached-pane-shell.tsx +1 -1
  31. package/src/components/layout/floating-pane.tsx +5 -1
  32. package/src/components/layout/pane/footer/index.tsx +21 -14
  33. package/src/components/layout/pane/footer/model.ts +6 -0
  34. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  35. package/src/components/layout/shell/active-drag.ts +149 -105
  36. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  37. package/src/components/layout/shell/drag/index.ts +47 -218
  38. package/src/components/layout/shell/drag/live.ts +10 -3
  39. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  40. package/src/components/layout/shell/drag/runtime.ts +29 -6
  41. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  42. package/src/components/layout/shell/index.tsx +11 -6
  43. package/src/components/layout/shell/menu.ts +11 -2
  44. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  45. package/src/components/layout/shell/native/window-state.ts +2 -2
  46. package/src/components/layout/shell/pane/layers.tsx +71 -7
  47. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  48. package/src/components/layout/shell/window-mode/index.ts +8 -10
  49. package/src/components/layout/window-edit/mode.ts +39 -7
  50. package/src/components/layout/window-edit/presentation.ts +1 -1
  51. package/src/components/onboarding/onboarding-keyboard.ts +4 -0
  52. package/src/components/onboarding/onboarding-wizard.tsx +8 -3
  53. package/src/components/ui/button.tsx +2 -0
  54. package/src/components/ui/choice-dialog.tsx +1 -0
  55. package/src/components/ui/data-table/index.tsx +4 -3
  56. package/src/components/ui/list-view.tsx +7 -12
  57. package/src/components/ui/loading.tsx +10 -3
  58. package/src/components/ui/menu.tsx +6 -2
  59. package/src/components/ui/quote.ts +14 -1
  60. package/src/data/config/layout.ts +5 -2
  61. package/src/docs/snapshot.json +29 -5
  62. package/src/i18n/es.ts +9 -8
  63. package/src/i18n/ja.ts +9 -8
  64. package/src/i18n/ko.ts +9 -8
  65. package/src/i18n/zh-cn.ts +9 -8
  66. package/src/i18n/zh-tw.ts +9 -8
  67. package/src/layout/pane-manager/floating-actions.ts +17 -0
  68. package/src/layout/pane-manager/floating-stack.ts +187 -0
  69. package/src/layout/pane-manager/floating.ts +4 -2
  70. package/src/layout/pane-manager/gridlock.ts +5 -1
  71. package/src/layout/pane-manager/index.ts +11 -0
  72. package/src/layout/pane-manager/layout-state.ts +10 -3
  73. package/src/market-data/futures-board.ts +46 -1
  74. package/src/market-data/futures-contract.ts +12 -3
  75. package/src/market-data/fx-interventions.ts +270 -0
  76. package/src/news/news-model.ts +44 -2
  77. package/src/plugins/builtin/alerts/cli.ts +4 -4
  78. package/src/plugins/builtin/alerts/format.ts +1 -2
  79. package/src/plugins/builtin/alerts/headless.ts +1 -2
  80. package/src/plugins/builtin/alerts/move-checks.ts +12 -6
  81. package/src/plugins/builtin/alerts/move.ts +30 -9
  82. package/src/plugins/builtin/alerts/pane.tsx +0 -2
  83. package/src/plugins/builtin/alerts/storage.ts +4 -2
  84. package/src/plugins/builtin/alerts/types.ts +12 -0
  85. package/src/plugins/builtin/changelog/index.tsx +292 -101
  86. package/src/plugins/builtin/changelog/versions.ts +293 -0
  87. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  88. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  89. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  90. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  91. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  92. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  93. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  94. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  95. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  96. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  97. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  98. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  99. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  100. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  101. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  102. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  103. package/src/plugins/builtin/cot/headless.ts +14 -2
  104. package/src/plugins/builtin/earnings/index.tsx +2 -2
  105. package/src/plugins/builtin/futures/index.tsx +25 -4
  106. package/src/plugins/builtin/futures/model.ts +28 -32
  107. package/src/plugins/builtin/futures/series.ts +4 -3
  108. package/src/plugins/builtin/futures/table.tsx +16 -9
  109. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  110. package/src/plugins/builtin/help/index.tsx +3 -3
  111. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  112. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  113. package/src/plugins/builtin/news/headless.ts +2 -2
  114. package/src/plugins/builtin/news/index.tsx +3 -3
  115. package/src/plugins/builtin/perps/markets-section.tsx +5 -2
  116. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  117. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  118. package/src/plugins/builtin/research/event-model.ts +9 -1
  119. package/src/plugins/builtin/research/event-sources.ts +22 -0
  120. package/src/plugins/builtin/research/headless.ts +3 -3
  121. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  122. package/src/plugins/builtin/ticker-detail/overview/components.tsx +54 -5
  123. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +28 -13
  124. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  125. package/src/plugins/installer.ts +45 -0
  126. package/src/remote/resources.ts +12 -1
  127. package/src/remote/schema.ts +1 -0
  128. package/src/remote/semantic-helpers.ts +29 -1
  129. package/src/remote/semantic-tree.tsx +32 -15
  130. package/src/renderers/cloudflare/worker.ts +16 -1
  131. package/src/renderers/dom/styles.css +40 -6
  132. package/src/renderers/share/layout-view.tsx +1 -1
  133. package/src/sources/gloomberb-cloud/news.ts +35 -12
  134. package/src/state/opening-ticker-panes.ts +47 -0
  135. package/src/test-support/cli-context.ts +2 -0
  136. package/src/test-support/preload.ts +4 -1
  137. package/src/tickers/instrument-kind.ts +23 -3
  138. package/src/types/config.ts +5 -0
  139. package/src/types/context-menu.ts +2 -0
  140. package/src/types/plugin-commands.ts +140 -0
  141. package/src/types/plugin-context.ts +125 -0
  142. package/src/types/plugin-contributions.ts +55 -0
  143. package/src/types/plugin-definition.ts +234 -0
  144. package/src/types/plugin-notifications.ts +38 -0
  145. package/src/types/plugin-pane-settings.ts +114 -0
  146. package/src/types/plugin-pane-templates.ts +160 -0
  147. package/src/types/plugin-panes.ts +221 -0
  148. package/src/types/plugin-reports.ts +35 -0
  149. package/src/types/plugin-shared.ts +14 -0
  150. package/src/types/plugin-state.ts +71 -0
  151. package/src/types/plugin.ts +14 -1169
  152. package/src/ui/index.tsx +14 -3
  153. package/src/updater/github-releases.ts +23 -0
  154. package/src/utils/cli-output.ts +22 -9
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gloomberb",
3
- "version": "0.20.3",
3
+ "version": "0.20.4",
4
4
  "packageManager": "bun@1.3.14",
5
5
  "description": "Market research and portfolio tracker for the terminal",
6
6
  "module": "src/public/index.ts",
@@ -45,6 +45,8 @@ export interface AuthDialogRequest {
45
45
  }
46
46
 
47
47
  const authDialogListeners = new Set<(request: AuthDialogRequest) => void>();
48
+ /** How many hosts show the dialog now; a request while one does is ignored. */
49
+ let openAuthDialogs = 0;
48
50
 
49
51
  /** Returns false when no dialog host is mounted, so callers can fall back. */
50
52
  export function requestAuthDialog(request: AuthDialogRequest = {}): boolean {
@@ -53,6 +55,19 @@ export function requestAuthDialog(request: AuthDialogRequest = {}): boolean {
53
55
  return true;
54
56
  }
55
57
 
58
+ /** Whether the dialog is on screen, so a press that would only ask for it again can do nothing. */
59
+ export function isAuthDialogOpen(): boolean {
60
+ return openAuthDialogs > 0;
61
+ }
62
+
63
+ /** Takes the requests a host would, for a test that signs in without the form. */
64
+ export function interceptAuthDialogForTests(listener: (request: AuthDialogRequest) => void): () => void {
65
+ authDialogListeners.add(listener);
66
+ return () => {
67
+ authDialogListeners.delete(listener);
68
+ };
69
+ }
70
+
56
71
  export function AuthDialogHost() {
57
72
  const dialog = useDialog();
58
73
  const openRef = useRef(false);
@@ -61,6 +76,7 @@ export function AuthDialogHost() {
61
76
  const listener = (request: AuthDialogRequest) => {
62
77
  if (openRef.current) return;
63
78
  openRef.current = true;
79
+ openAuthDialogs += 1;
64
80
  void dialog
65
81
  .prompt<AuthUser | undefined>({
66
82
  closeOnClickOutside: false,
@@ -76,6 +92,7 @@ export function AuthDialogHost() {
76
92
  })
77
93
  .finally(() => {
78
94
  openRef.current = false;
95
+ openAuthDialogs -= 1;
79
96
  });
80
97
  };
81
98
  authDialogListeners.add(listener);
@@ -35,6 +35,7 @@ import type { OrganizationTickersResponse } from "./organization-tickers";
35
35
  import type { BitcoinNetworkPayload, CryptoMarketsPayload, DefiTvlPayload, StablecoinSupplyHistoryPayload, StablecoinSupplyPayload } from "./crypto-markets";
36
36
  import type { CryptoEtfFlowAsset, CryptoEtfFlowsPayload } from "./crypto-etf-flows";
37
37
  import type { CentralBankRatesPayload } from "./central-bank-rates";
38
+ import type { FxInterventionsPayload } from "./fx-interventions";
38
39
  import type { EstimateRevisionsPayload } from "./estimate-revisions";
39
40
  import type { MoneyMarketsPayload } from "./money-markets";
40
41
  import type { CloudCurveHistory, CloudCurveId, CloudCurveView, CloudWorldCurves } from "./yield-curves";
@@ -1089,6 +1090,11 @@ export class CloudDataApi {
1089
1090
  return this.request<CentralBankRatesPayload>("/cloud/econ/central-bank-rates", { signal: AbortSignal.timeout(45_000) });
1090
1091
  }
1091
1092
 
1093
+ /** Japan's foreign exchange interventions as its Ministry of Finance publishes them. */
1094
+ async getCloudFxInterventions(signal?: AbortSignal): Promise<FxInterventionsPayload> {
1095
+ return this.request<FxInterventionsPayload>("/cloud/econ/fx-interventions", { signal: signalWithTimeout(signal, 20_000) });
1096
+ }
1097
+
1092
1098
  /** A live scan's matches against Gloom Cloud's newest market-wide snapshot for this account's tier. */
1093
1099
  getLiveScan(definition: LiveScanWireDefinition, signal?: AbortSignal) {
1094
1100
  return this.request<LiveScanPayload>(LIVE_SCAN_PATH, {
@@ -0,0 +1,64 @@
1
+ /** One day Japan's Ministry of Finance intervened, in one pair, as its quarterly release lists it. */
2
+ export interface FxInterventionDay {
3
+ /** The day, in Tokyo. */
4
+ date: string;
5
+ /** The day's total in yen; an operation in a pair without the yen is converted at the Bank of Japan's central rate. */
6
+ amountJpy: number;
7
+ /** The currency sold and the one bought (ISO codes); null for one the server does not list. */
8
+ sold: string | null;
9
+ bought: string | null;
10
+ /** The pair as the ministry writes it: "the US dollar (sold) the Japanese yen (bought)". */
11
+ pair: string;
12
+ }
13
+
14
+ /** Operations in one pair and direction, each at most four calendar days after the last, summed: one intervention, counted once. */
15
+ export interface FxInterventionRun {
16
+ from: string;
17
+ to: string;
18
+ /** Days with an operation. */
19
+ days: number;
20
+ amountJpy: number;
21
+ sold: string | null;
22
+ bought: string | null;
23
+ pair: string;
24
+ }
25
+
26
+ /** One monthly release: the total for its period, which names no day and no pair until its quarter is released. */
27
+ export interface FxInterventionMonth {
28
+ from: string;
29
+ to: string;
30
+ amountJpy: number;
31
+ /** The day the ministry published it. */
32
+ releasedOn: string;
33
+ url?: string;
34
+ /** How far the daily record reaches into the period. */
35
+ daysKnown: "all" | "partial" | "none";
36
+ /** The part of its total no served day accounts for yet: what is not dated, counted once. */
37
+ undatedAmountJpy: number;
38
+ }
39
+
40
+ /** One quarter's total. */
41
+ interface FxInterventionQuarter {
42
+ from: string;
43
+ to: string;
44
+ amountJpy: number;
45
+ }
46
+
47
+ /** `GET /cloud/econ/fx-interventions`: Japan's interventions as the Ministry of Finance publishes them. */
48
+ export interface FxInterventionsPayload {
49
+ authority: string;
50
+ status: "available" | "unavailable";
51
+ /** Each operation, oldest first. */
52
+ days: FxInterventionDay[];
53
+ /** The operations as interventions, oldest first. */
54
+ interventions: FxInterventionRun[];
55
+ /** The last day `days` covers; a monthly total after it names no day yet. */
56
+ dailyThrough: string | null;
57
+ /** Every monthly release read, oldest first. */
58
+ months: FxInterventionMonth[];
59
+ /** Quarterly totals, oldest first. */
60
+ quarters: FxInterventionQuarter[];
61
+ fetchedAt: string | null;
62
+ sourceUrl: string;
63
+ notes: string[];
64
+ }
@@ -976,6 +976,7 @@ class GloomApiClient {
976
976
  getCloudDefiTvl = this.data.getCloudDefiTvl.bind(this.data);
977
977
  getCloudBitcoinNetwork = this.data.getCloudBitcoinNetwork.bind(this.data);
978
978
  getCloudCentralBankRates = this.data.getCloudCentralBankRates.bind(this.data);
979
+ getCloudFxInterventions = this.data.getCloudFxInterventions.bind(this.data);
979
980
  getMobileAlertHistory = this.data.getMobileAlertHistory.bind(this.data);
980
981
  getScannerFlowHistory = this.data.getScannerFlowHistory.bind(this.data);
981
982
  getScannerFlowSession = this.data.getScannerFlowSession.bind(this.data);
@@ -0,0 +1,21 @@
1
+ import { CloudApiRequestTransport } from "./request";
2
+
3
+ // A public file needs no session credential. A separate transport, as the
4
+ // public wall summary has, still follows the installed desktop/web bridge.
5
+ const publicTransport = new CloudApiRequestTransport();
6
+
7
+ /**
8
+ * The repository's CHANGELOG.md as Gloom Cloud serves it (GET
9
+ * /public/releases/summaries): read there with the service's own GitHub
10
+ * credentials and cached, so the Changelog does not spend the anonymous
11
+ * GitHub limit of the address the app runs on. Null when the repository has
12
+ * no such file. Throws when the service cannot say (a service without the
13
+ * route, or GitHub down with nothing kept), so the caller asks GitHub itself.
14
+ */
15
+ export async function getReleaseSummaries(signal?: AbortSignal): Promise<string | null> {
16
+ const body = await publicTransport.request<unknown>("/public/releases/summaries", { signal });
17
+ const markdown = typeof body === "object" && body !== null ? (body as { markdown?: unknown }).markdown : undefined;
18
+ if (markdown === null) return null;
19
+ if (typeof markdown !== "string") throw new Error("Gloom Cloud returned no release summaries");
20
+ return markdown;
21
+ }
@@ -173,7 +173,7 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
173
173
  {
174
174
  id: "pane-close",
175
175
  category: "Pane Management",
176
- description: "Close the focused pane, docked or floating. Locked panes stay open.",
176
+ description: "Close the focused pane, in the layout or floating. Locked panes stay open.",
177
177
  defaults: ["CmdOrCtrl+W"],
178
178
  },
179
179
  {
@@ -205,7 +205,7 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
205
205
  {
206
206
  id: "pane-float",
207
207
  category: "Pane Management",
208
- description: "Dock or float the focused pane.",
208
+ description: "Float the focused pane, or return it to the layout.",
209
209
  defaults: ["CmdOrCtrl+Shift+D"],
210
210
  },
211
211
  {
@@ -6,31 +6,40 @@ import {
6
6
  getDockedPaneIds,
7
7
  isPaneInLayout,
8
8
  isPaneDocked,
9
+ removePane,
9
10
  } from "../../layout/pane-manager";
10
11
  import type { PluginRegistry } from "../../plugins/registry";
11
12
  import { PluginOffError, notifyPluginOff } from "../../plugins/plugin-off";
12
13
  import { findFixedTickerPaneForSymbol } from "../../layout/ticker-navigation";
13
14
  import type { AppAction, AppState } from "../../state/app/context";
14
- import { TICKER_RESEARCH_PANE_ID, normalizePaneId } from "../../types/config";
15
+ import { findPaneInstance, TICKER_RESEARCH_PANE_ID, normalizePaneId } from "../../types/config";
15
16
  import type {
16
17
  LayoutConfig,
17
18
  PaneBinding,
18
19
  PaneInstanceConfig,
19
20
  } from "../../types/config";
20
21
  import type { DataProvider } from "../../types/data-provider";
21
- import type { PinTickerOptions } from "../../types/plugin";
22
+ import type { PaneDef, PinTickerOptions } from "../../types/plugin";
23
+ import type { BrokerContractRef } from "../../types/instrument";
24
+ import type { TickerRecord } from "../../types/ticker";
22
25
  import {
23
26
  resolveTickerOpenTarget,
24
27
  tickerOpenFailureMessage,
25
28
  type TickerOpenTarget,
26
29
  } from "../../tickers/open-target";
27
- import { findExactTickerSearchMatch, upsertTickerFromSearchResult } from "../../tickers/search";
30
+ import {
31
+ createLocalTickerSearchCandidates,
32
+ findExactTickerSearchMatch,
33
+ upsertTickerFromSearchResult,
34
+ } from "../../tickers/search";
28
35
  import { offerTickerListings, publishTickerOpenTarget as publishOpenTarget } from "./ticker-open-target";
29
36
  import { parsePublicTickerKey, publicTickerKey } from "../../utils/exchanges";
30
37
  import { attentionActionForPane, captureAttentionAction } from "../../telemetry/attention-counts";
31
38
  import { tickerHasListingSuffix } from "../../sources/listing-symbols";
32
39
  import { instrumentFromTicker } from "../../market-data/request-types";
33
40
  import { tickerInstrumentLabel } from "../../tickers/instrument-label";
41
+ import { markTickerPaneOpening } from "../../state/opening-ticker-panes";
42
+ import { stableStringify } from "../../utils/hash";
34
43
 
35
44
  interface UseAppTickerOpenRuntimeOptions {
36
45
  activatePane: (paneId: string) => void;
@@ -44,12 +53,93 @@ interface UseAppTickerOpenRuntimeOptions {
44
53
  dataProvider: DataProvider;
45
54
  dispatch: Dispatch<AppAction>;
46
55
  focusVisiblePane: (paneId: string, layout?: LayoutConfig) => void;
47
- persistLayout: (layout: LayoutConfig, options?: { pushHistory?: boolean }) => void;
56
+ persistLayout: (layout: LayoutConfig, options?: { pushHistory?: boolean; focusedPaneId?: string | null }) => void;
48
57
  pluginRegistry: PluginRegistry;
49
58
  stateRef: { current: AppState };
50
59
  tickerRepository: AppTickerRepositoryPort;
51
60
  }
52
61
 
62
+ /** A research pane opened ahead of the lookup that finds its ticker (`openPaneAhead`). */
63
+ interface PaneAhead {
64
+ instanceId: string;
65
+ /** The key it is bound to until the lookup settles it. */
66
+ symbol: string;
67
+ /** The pane focused before it opened, which focus goes back to when nothing opens. */
68
+ sourcePaneId: string | null;
69
+ stopOpening: () => void;
70
+ }
71
+
72
+ /** The binding a resolved target opens with, and its broker contract (`null` for the public listing). */
73
+ function targetPaneBinding(target: TickerOpenTarget, options?: PinTickerOptions): {
74
+ binding: PaneBinding;
75
+ instrument: BrokerContractRef | null | undefined;
76
+ } {
77
+ const instrument = options?.instrument !== undefined ? options.instrument
78
+ : target.instrument !== undefined ? target.instrument : instrumentFromTicker(target.ticker)?.instrument ?? undefined;
79
+ const listing = options?.listing ?? target.listing;
80
+ return {
81
+ binding: { kind: "fixed", symbol: target.symbol, ...(instrument !== undefined ? { instrument } : {}), ...(listing ? { listing } : {}) },
82
+ instrument,
83
+ };
84
+ }
85
+
86
+ /**
87
+ * The pane of `paneType` already showing the target in `layout`, which an
88
+ * open brings forward instead of adding another, and whether its binding
89
+ * stays as it is.
90
+ */
91
+ function findTargetPane(
92
+ state: AppState,
93
+ layout: LayoutConfig,
94
+ paneType: string,
95
+ target: TickerOpenTarget,
96
+ instrument: BrokerContractRef | null | undefined,
97
+ options?: PinTickerOptions,
98
+ typed?: string,
99
+ ): { existing: PaneInstanceConfig | null; keepBinding: boolean } {
100
+ if (options?.forceNewPane) return { existing: null, keepBinding: false };
101
+ const symbol = target.symbol;
102
+ let existing = findFixedTickerPaneForSymbol(layout, paneType, symbol, instrument);
103
+ // A pane bound to the key as typed (the web terminal's first pane for ?ticker=7203:TSE) is the one the
104
+ // resolved listing (7203:JPX) settles.
105
+ const typedKey = typed?.trim().toUpperCase();
106
+ if (!existing && typedKey && typedKey !== symbol) {
107
+ existing = findFixedTickerPaneForSymbol(layout, paneType, typedKey, instrument);
108
+ }
109
+ // Without a broker route, the public listing and an unnamed route are the same security: a link that names
110
+ // neither still finds the DES the command bar opened on the public listing, and leaves its binding as it is.
111
+ let keepBinding = false;
112
+ if (!existing && !instrument && !target.ticker.metadata.broker_contracts?.length) {
113
+ existing = findFixedTickerPaneForSymbol(layout, paneType, symbol, instrument === null ? undefined : null);
114
+ keepBinding = !!existing && instrument === undefined;
115
+ }
116
+ if (!existing && !instrument && (parsePublicTickerKey(symbol).exchange || tickerHasListingSuffix(symbol))) {
117
+ existing = layout.instances.find((instance) => {
118
+ if (instance.paneId !== paneType || instance.binding?.kind !== "fixed" || instance.binding.instrument || !isPaneInLayout(layout, instance.instanceId)) return false;
119
+ const ticker = state.tickers.get(instance.binding.symbol);
120
+ return !!ticker?.metadata.exchange && !!findExactTickerSearchMatch([
121
+ { label: instance.binding.symbol, right: ticker.metadata.exchange },
122
+ ], symbol);
123
+ }) ?? null;
124
+ }
125
+ return { existing, keepBinding };
126
+ }
127
+
128
+ /**
129
+ * Whether the app holds a ticker the key names, so opening it resolves here
130
+ * without a network lookup, as `resolveTickerSearch` reads a saved symbol.
131
+ */
132
+ function holdsTicker(tickers: ReadonlyMap<string, TickerRecord>, symbol: string): boolean {
133
+ return tickers.has(symbol) || !!findExactTickerSearchMatch(createLocalTickerSearchCandidates(tickers.values()), symbol);
134
+ }
135
+
136
+ /** Whether a pane opened ahead is still in the layout on its key: not closed, nor pointed at another ticker. */
137
+ function isPaneAheadInPlace(layout: LayoutConfig, ahead: PaneAhead): boolean {
138
+ const instance = findPaneInstance(layout, ahead.instanceId);
139
+ return !!instance && isPaneInLayout(layout, ahead.instanceId)
140
+ && instance.binding?.kind === "fixed" && instance.binding.symbol === ahead.symbol;
141
+ }
142
+
53
143
  export function useAppTickerOpenRuntime({
54
144
  activatePane,
55
145
  buildPaneInstance,
@@ -102,6 +192,46 @@ export function useAppTickerOpenRuntime({
102
192
  return true;
103
193
  }, [pluginRegistry, stateRef]);
104
194
 
195
+ /**
196
+ * Adds a new pane of `paneType` bound to `binding`, floating or docked as
197
+ * asked, and focuses it. `beforePlace` runs with its id before it is placed.
198
+ */
199
+ const addTickerPane = useCallback((
200
+ paneType: string,
201
+ paneDef: PaneDef,
202
+ binding: PaneBinding,
203
+ title: string,
204
+ options?: PinTickerOptions,
205
+ beforePlace?: (instanceId: string) => void,
206
+ ): string | null => {
207
+ const instance = buildPaneInstance(paneType, { title, binding });
208
+ if (!instance) return null;
209
+ beforePlace?.(instance.instanceId);
210
+
211
+ const currentState = stateRef.current;
212
+ const currentLayout = currentState.config.layout;
213
+ const { width, height } = pluginRegistry.getTermSize();
214
+ const shouldFloat = options?.floating ?? true;
215
+ const nextLayout = shouldFloat
216
+ ? addPaneFloating(currentLayout, instance, width, height, paneDef, { focusedPaneId: currentState.focusedPaneId })
217
+ : addPaneToLayout(
218
+ currentLayout,
219
+ instance,
220
+ {
221
+ relativeTo: currentState.focusedPaneId && isPaneDocked(currentLayout, currentState.focusedPaneId)
222
+ ? currentState.focusedPaneId
223
+ : (getDockedPaneIds(currentLayout).at(-1) ?? instance.instanceId),
224
+ position: "right",
225
+ },
226
+ );
227
+ persistLayout(nextLayout);
228
+ if (paneType === TICKER_RESEARCH_PANE_ID && options?.tabId) {
229
+ dispatch({ type: "UPDATE_PANE_STATE", paneId: instance.instanceId, patch: { ...options.tabState, activeTabId: options.tabId } });
230
+ }
231
+ activatePane(instance.instanceId);
232
+ return instance.instanceId;
233
+ }, [activatePane, buildPaneInstance, dispatch, persistLayout, pluginRegistry, stateRef]);
234
+
105
235
  const placePinnedTickerTarget = useCallback((target: TickerOpenTarget, options?: PinTickerOptions, typed?: string) => {
106
236
  const paneType = normalizePaneId(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
107
237
  const paneDef = pluginRegistry.panes.get(paneType);
@@ -110,37 +240,10 @@ export function useAppTickerOpenRuntime({
110
240
 
111
241
  publishTickerOpenTarget(target);
112
242
  const symbol = target.symbol;
113
- const instrument = options?.instrument !== undefined ? options.instrument
114
- : target.instrument !== undefined ? target.instrument : instrumentFromTicker(target.ticker)?.instrument ?? undefined;
115
- const listing = options?.listing ?? target.listing;
116
- const binding = { kind: "fixed" as const, symbol, ...(instrument !== undefined ? { instrument } : {}), ...(listing ? { listing } : {}) };
243
+ const { binding, instrument } = targetPaneBinding(target, options);
117
244
  const currentState = stateRef.current;
118
245
  const currentLayout = currentState.config.layout;
119
- let existing = options?.forceNewPane
120
- ? null
121
- : findFixedTickerPaneForSymbol(currentLayout, paneType, symbol, instrument);
122
- // A pane bound to the key as typed (the web terminal's first pane for ?ticker=7203:TSE) is the one the
123
- // resolved listing (7203:JPX) settles.
124
- const typedKey = typed?.trim().toUpperCase();
125
- if (!options?.forceNewPane && !existing && typedKey && typedKey !== symbol) {
126
- existing = findFixedTickerPaneForSymbol(currentLayout, paneType, typedKey, instrument);
127
- }
128
- // Without a broker route, the public listing and an unnamed route are the same security: a link that names
129
- // neither still finds the DES the command bar opened on the public listing, and leaves its binding as it is.
130
- let keepBinding = false;
131
- if (!options?.forceNewPane && !existing && !instrument && !target.ticker.metadata.broker_contracts?.length) {
132
- existing = findFixedTickerPaneForSymbol(currentLayout, paneType, symbol, instrument === null ? undefined : null);
133
- keepBinding = !!existing && instrument === undefined;
134
- }
135
- if (!options?.forceNewPane && !existing && !instrument && (parsePublicTickerKey(symbol).exchange || tickerHasListingSuffix(symbol))) {
136
- existing = currentLayout.instances.find((instance) => {
137
- if (instance.paneId !== paneType || instance.binding?.kind !== "fixed" || instance.binding.instrument || !isPaneInLayout(currentLayout, instance.instanceId)) return false;
138
- const ticker = currentState.tickers.get(instance.binding.symbol);
139
- return !!ticker?.metadata.exchange && !!findExactTickerSearchMatch([
140
- { label: instance.binding.symbol, right: ticker.metadata.exchange },
141
- ], symbol);
142
- }) ?? null;
143
- }
246
+ const { existing, keepBinding } = findTargetPane(currentState, currentLayout, paneType, target, instrument, options, typed);
144
247
  if (existing) {
145
248
  // A reload can qualify a previously bare saved symbol. Reuse only the
146
249
  // verified same listing, retaining its pane identity and its followers.
@@ -164,34 +267,9 @@ export function useAppTickerOpenRuntime({
164
267
  return;
165
268
  }
166
269
 
167
- const instance = buildPaneInstance(paneType, {
168
- title: tickerInstrumentLabel(symbol, instrument),
169
- binding,
170
- });
171
- if (!instance) return;
172
-
173
- const { width, height } = pluginRegistry.getTermSize();
174
- const shouldFloat = options?.floating ?? true;
175
- const nextLayout = shouldFloat
176
- ? addPaneFloating(currentLayout, instance, width, height, paneDef, { focusedPaneId: currentState.focusedPaneId })
177
- : addPaneToLayout(
178
- currentLayout,
179
- instance,
180
- {
181
- relativeTo: currentState.focusedPaneId && isPaneDocked(currentLayout, currentState.focusedPaneId)
182
- ? currentState.focusedPaneId
183
- : (getDockedPaneIds(currentLayout).at(-1) ?? instance.instanceId),
184
- position: "right",
185
- },
186
- );
187
- persistLayout(nextLayout);
188
- if (paneType === TICKER_RESEARCH_PANE_ID && options?.tabId) {
189
- dispatch({ type: "UPDATE_PANE_STATE", paneId: instance.instanceId, patch: { ...options.tabState, activeTabId: options.tabId } });
190
- }
191
- activatePane(instance.instanceId);
270
+ addTickerPane(paneType, paneDef, binding, tickerInstrumentLabel(symbol, instrument), options);
192
271
  }, [
193
- activatePane,
194
- buildPaneInstance,
272
+ addTickerPane,
195
273
  dispatch,
196
274
  focusVisiblePane,
197
275
  persistLayout,
@@ -201,6 +279,88 @@ export function useAppTickerOpenRuntime({
201
279
  stateRef,
202
280
  ]);
203
281
 
282
+ /**
283
+ * Opens the research pane of a ticker the app does not hold yet before the
284
+ * network lookup that finds it (search and the listing's quote, seconds on
285
+ * a slow connection), bound to the key as given and marked as opening; the
286
+ * lookup settles it (`settlePaneAhead`). Null when the open waits for the
287
+ * lookup instead: another pane type, a broker contract, a ticker the app
288
+ * holds (it resolves here, at once), or a research pane already on the key.
289
+ */
290
+ const openPaneAhead = useCallback((rawSymbol: string, options?: PinTickerOptions): PaneAhead | null => {
291
+ const paneType = normalizePaneId(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
292
+ const paneDef = pluginRegistry.panes.get(paneType);
293
+ const symbol = rawSymbol.trim().toUpperCase();
294
+ if (paneType !== TICKER_RESEARCH_PANE_ID || !paneDef || !symbol || options?.instrument) return null;
295
+ const state = stateRef.current;
296
+ const layout = state.config.layout;
297
+ if (holdsTicker(state.tickers, symbol)) return null;
298
+ if (!options?.forceNewPane && layout.instances.some((instance) => instance.paneId === paneType
299
+ && instance.binding?.kind === "fixed" && instance.binding.symbol === symbol && isPaneInLayout(layout, instance.instanceId))) return null;
300
+ const binding: PaneBinding = {
301
+ kind: "fixed",
302
+ symbol,
303
+ ...(options?.instrument !== undefined ? { instrument: options.instrument } : {}),
304
+ ...(options?.listing ? { listing: options.listing } : {}),
305
+ };
306
+ const sourcePaneId = state.focusedPaneId;
307
+ // Marked before it is placed, so its first frame already says it is loading.
308
+ let stopOpening = () => {};
309
+ const instanceId = addTickerPane(paneType, paneDef, binding, tickerInstrumentLabel(symbol, options?.instrument), options, (id) => {
310
+ stopOpening = markTickerPaneOpening(id);
311
+ });
312
+ if (!instanceId) return null;
313
+ return { instanceId, symbol, sourcePaneId, stopOpening };
314
+ }, [addTickerPane, pluginRegistry, stateRef]);
315
+
316
+ /**
317
+ * Settles a pane opened ahead once the lookup answers: it is bound to the
318
+ * listing found, or gives way to a pane already showing that listing, or
319
+ * closes when nothing opens (no listing, or a choice of listings the
320
+ * command bar now offers), focus going back where it was. A pane closed or
321
+ * pointed at another ticker meanwhile is left alone. True when the open
322
+ * landed in a pane.
323
+ */
324
+ const settlePaneAhead = useCallback((
325
+ ahead: PaneAhead,
326
+ target: TickerOpenTarget | null,
327
+ options: PinTickerOptions | undefined,
328
+ typed: string,
329
+ ): boolean => {
330
+ if (target) publishTickerOpenTarget(target);
331
+ const state = stateRef.current;
332
+ const layout = state.config.layout;
333
+ if (!isPaneAheadInPlace(layout, ahead)) return false;
334
+ const focusedHere = state.focusedPaneId === ahead.instanceId;
335
+ const without = removePane(layout, ahead.instanceId);
336
+ if (!target) {
337
+ const backTo = ahead.sourcePaneId && isPaneInLayout(without, ahead.sourcePaneId) ? ahead.sourcePaneId : null;
338
+ persistLayout(without, { pushHistory: false, ...(focusedHere ? { focusedPaneId: backTo } : {}) });
339
+ return false;
340
+ }
341
+ const { binding, instrument } = targetPaneBinding(target, options);
342
+ const { existing } = findTargetPane(state, without, TICKER_RESEARCH_PANE_ID, target, instrument, options, typed);
343
+ if (existing) {
344
+ persistLayout(without, { pushHistory: false });
345
+ if (options?.tabId) {
346
+ dispatch({ type: "UPDATE_PANE_STATE", paneId: existing.instanceId, patch: { ...options.tabState, activeTabId: options.tabId } });
347
+ }
348
+ if (focusedHere) focusVisiblePane(existing.instanceId, without);
349
+ return true;
350
+ }
351
+ const instance = findPaneInstance(layout, ahead.instanceId)!;
352
+ const title = !instance.title || instance.title === tickerInstrumentLabel(ahead.symbol, options?.instrument)
353
+ ? tickerInstrumentLabel(target.symbol, instrument)
354
+ : instance.title;
355
+ if (title !== instance.title || stableStringify(instance.binding) !== stableStringify(binding)) {
356
+ persistLayout({
357
+ ...layout,
358
+ instances: layout.instances.map((pane) => pane.instanceId === ahead.instanceId ? { ...pane, binding, title } : pane),
359
+ }, { pushHistory: false });
360
+ }
361
+ return true;
362
+ }, [dispatch, focusVisiblePane, persistLayout, publishTickerOpenTarget, stateRef]);
363
+
204
364
  const openPinnedTicker = useCallback(async (rawSymbol: string, options?: PinTickerOptions) => {
205
365
  // Before resolving, so a refused open adds no ticker either.
206
366
  if (refuseWhileOwnerOff(rawSymbol, options, () => { void openPinnedTicker(rawSymbol, options); })) return;
@@ -218,16 +378,35 @@ export function useAppTickerOpenRuntime({
218
378
  });
219
379
  }
220
380
  const selectedTicker = selected?.ticker;
221
- const target = selectedTicker
222
- ? { symbol: selectedTicker.metadata.ticker, ticker: selectedTicker, created: selected!.created, instrument: options?.instrument, listing: options?.listing }
223
- : await resolveOpenTickerTarget(rawSymbol, options?.instrument === null);
224
- if (!target) return;
225
- placePinnedTickerTarget(target, options, rawSymbol);
381
+ let target: TickerOpenTarget | null;
382
+ let placed = true;
383
+ if (selectedTicker) {
384
+ target = { symbol: selectedTicker.metadata.ticker, ticker: selectedTicker, created: selected!.created, instrument: options?.instrument, listing: options?.listing };
385
+ placePinnedTickerTarget(target, options, rawSymbol);
386
+ } else {
387
+ // The pane of a ticker found over the network shows now, not once the lookup answers.
388
+ const ahead = openPaneAhead(rawSymbol, options);
389
+ if (!ahead) {
390
+ target = await resolveOpenTickerTarget(rawSymbol, options?.instrument === null);
391
+ if (target) placePinnedTickerTarget(target, options, rawSymbol);
392
+ } else {
393
+ // Cleared once it settles, so no frame between says no ticker is selected.
394
+ try {
395
+ // A failure, or the choice of listings, is said only while the pane still waits: one closed was given up.
396
+ target = await resolveOpenTickerTarget(rawSymbol, options?.instrument === null,
397
+ () => isPaneAheadInPlace(stateRef.current.config.layout, ahead));
398
+ placed = settlePaneAhead(ahead, target, options, rawSymbol);
399
+ } finally {
400
+ ahead.stopOpening();
401
+ }
402
+ }
403
+ }
404
+ if (!target || !placed) return;
226
405
  const action = attentionActionForPane(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
227
406
  if (action && pluginRegistry.panes.has(options?.paneType ?? TICKER_RESEARCH_PANE_ID)) {
228
407
  recordAttention(publicTickerKey(target.symbol, target.listing?.exchange ?? target.ticker.metadata.exchange), action);
229
408
  }
230
- }, [placePinnedTickerTarget, pluginRegistry, refuseWhileOwnerOff, resolveOpenTickerTarget, tickerRepository]);
409
+ }, [openPaneAhead, placePinnedTickerTarget, pluginRegistry, refuseWhileOwnerOff, resolveOpenTickerTarget, settlePaneAhead, stateRef, tickerRepository]);
231
410
 
232
411
  return {
233
412
  openPinnedTicker,