gloomberb 0.15.6 → 0.15.8

package/README.md

@@ -38,7 +38,7 @@ The desktop app and TUI share the command language and plugin system. The [brows
 On **macOS (Apple Silicon)**:
 
 ```bash
-brew install --cask vincelwt/tap/gloomberb
+brew install --cask gloomberb
 ```
 
 On **Windows 11**, [download the installer](https://github.com/gloom-sh/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe). It supports x64, and ARM64 through x64 emulation.
@@ -76,6 +76,7 @@ Press `Ctrl+P` to open the command bar, or press `` ` `` to search for a ticker.
 | `HVG AAPL` / `HVT AAPL` | Realized volatility and volatility cones |
 | `SEAS AAPL` | Seasonality: monthly returns by year and year overlays |
 | `COT [code or root]` | CFTC positioning and cross-market extremes |
+| `DOE` / `NGS` | EIA weekly oil stocks and gas storage, with builds, draws and five-year ranges |
 | `TOP` | Market stories |
 | `WIRP` / `FFIP` | US rate path and conditional FOMC probabilities |
 | `BTMM` | Funding rates, bill curves and Federal Reserve liquidity |
@@ -117,7 +118,7 @@ When the app hits an uncaught error, a render crash, or a plugin that fails to l
 
 The app also counts how often you open each function, from the command bar, a menu or a link in another pane, and which functions are on screen when a workspace is restored at launch. It sends each function's mnemonic (such as `DES` or `GP`) with those two counts, the surface, the app version and the operating system, a minute after the first count, then every 15 minutes, and when you quit. Functions from plugins other than the official gloom-sh ones are sent as `plugin`, so their names never leave your machine. The server adds your plan (signed out, Free or Pro); the counts are never tied to your account.
 
-Neither contains anything from your workspace: no tickers, arguments, portfolios, watchlists, layouts, settings or queries. Both carry a random install id stored in `~/.gloomberb/install-id` (in the browser, in local storage).
+Neither contains anything from your workspace: no tickers, arguments, portfolios, watchlists, layouts, settings or queries. Both carry a random install id stored in `install-id` in the data folder, `~/.gloomberb` by default (in the browser, in local storage).
 
 The usage setting also covers command bar searches. When you are signed in, a search you finish in the command bar (you pause typing or run something, never each keystroke) is stored with your account to improve search: its text, the AI suggestions it got and the result you picked. Searches are deleted with your account.
 

package/README.zh-CN.md

@@ -40,7 +40,7 @@
 在 **macOS（Apple Silicon）** 上：
 
 ```bash
-brew install --cask vincelwt/tap/gloomberb
+brew install --cask gloomberb
 ```
 
 在 **Windows 11** 上，[下载安装程序](https://github.com/gloom-sh/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)。支持 x64，也可通过 x64 仿真在 ARM64 上运行。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/src/api-client/data.ts

@@ -1,3 +1,5 @@
+import type { EarningsEvent } from "../types/data-provider";
+import type { MarketDividendsPayload, MarketHeatmapResult, MarketHeatmapUniverseId, MarketMoversPayload } from "./market-discovery";
 import type { DebtMaturitiesPayload } from "./debt-maturities";
 import type { RevenueBreakdownPayload, RevenueBreakdownView } from "./revenue-breakdown";
 import type { MnaDealPayload, MnaDealsParams, MnaDealsPayload } from "./mna";
@@ -12,6 +14,7 @@ import type { ShortVolumePayload, ShortVolumeScope } from "./short-volume";
 import type { SocialMentionDayPosts, SocialMentionsPayload, SocialMentionsRange } from "./social-mentions";
 import type { FuturesCurveAsOfPayload, FuturesCurvePayload } from "./futures-curve";
 import type { CotBoardPayload, CotContractPayload, CotFamily, CotClass } from "./cot";
+import type { DoeBoardPayload } from "./doe";
 import type { TapeSnapshot } from "./tape";
 import type { ExchangeRateSnapshot } from "../types/exchange-rate";
 import type { RatePathPayload } from "./rates";
@@ -39,11 +42,11 @@ import {
   cloudJobsPath,
   cloudJobsPostingsPath,
   type CloudJobsPostingsParams,
-  publicProxyStatementPath,
-  publicFilingEventsPath,
-  publicRiskReportPath,
-  publicRiskReportsPath,
-  publicProxyStatementsPath,
+  cloudProxyStatementPath,
+  cloudFilingEventsPath,
+  cloudRiskReportPath,
+  cloudRiskReportsPath,
+  cloudProxyStatementsPath,
   cloudExchangeRatePath,
   cloudSec13FPath,
   cloudSecFilingContentPath,
@@ -213,6 +216,31 @@ export class CloudDataApi {
     );
   }
 
+  getMarketEarningsCalendar(symbols: string[]): Promise<CloudMarketResponse<Array<Omit<EarningsEvent, "earningsDate" | "earningsCallDate"> & { earningsDate: string; earningsCallDate?: string | null }>>> {
+    return this.request(`/market/earnings-calendar?${new URLSearchParams({ symbols: symbols.join(",") })}`);
+  }
+
+  getCloudArticleSummary(url: string): Promise<{ summary: string | null }> {
+    return this.request(`/news/article-summary?${new URLSearchParams({ url })}`);
+  }
+
+  getMarketMovers(category: "day_gainers" | "day_losers" | "most_actives", count = 25, refresh = false): Promise<CloudMarketResponse<MarketMoversPayload>> {
+    const params = new URLSearchParams({ category, count: String(count), mode: refresh ? "refresh" : "cache-first" });
+    return this.request(`/market/movers?${params}`);
+  }
+
+  getMarketTrending(count = 25): Promise<CloudMarketResponse<Array<{ symbol: string }>>> {
+    return this.request(`/market/trending?count=${encodeURIComponent(count)}`);
+  }
+
+  getMarketHeatmap(universe: MarketHeatmapUniverseId, count = 80): Promise<CloudMarketResponse<MarketHeatmapResult>> {
+    return this.request(`/market/heatmap?${new URLSearchParams({ universe, count: String(count) })}`);
+  }
+
+  getMarketDividends(symbol: string, exchange = ""): Promise<CloudMarketResponse<MarketDividendsPayload>> {
+    return this.requestMarketSymbol("/market/dividends", symbol, exchange);
+  }
+
   /** Gainers, losers and most active, or the pre-market, after-hours and gap lists with a `side`. */
   async getCloudMarketScreener<Category extends CloudMarketScreenerCategory | CloudSessionMoversCategory>(
     category: Category,
@@ -358,6 +386,10 @@ export class CloudDataApi {
     return this.request<CotContractPayload>(`/cloud/cot/contracts/${encodeURIComponent(code)}?${new URLSearchParams({ report })}`);
   }
 
+  async getCloudDoeBoard(): Promise<DoeBoardPayload> {
+    return this.request<DoeBoardPayload>("/cloud/doe/board");
+  }
+
   async getCloudTape(symbol: string, exchange: string, signal?: AbortSignal): Promise<TapeSnapshot> {
     return this.request<TapeSnapshot>(`/cloud/tape/${encodeURIComponent(symbol)}?exchange=${encodeURIComponent(exchange)}`, { signal: signal ?? AbortSignal.timeout(30_000) });
   }
@@ -521,7 +553,7 @@ export class CloudDataApi {
     ticker: string,
   ): Promise<CloudProxyStatementListPayload> {
     return this.request<CloudProxyStatementListPayload>(
-      publicProxyStatementsPath(ticker),
+      cloudProxyStatementsPath(ticker),
     );
   }
 
@@ -530,7 +562,7 @@ export class CloudDataApi {
     year: number,
   ): Promise<CloudProxyStatementPayload> {
     return this.request<CloudProxyStatementPayload>(
-      publicProxyStatementPath(ticker, year),
+      cloudProxyStatementPath(ticker, year),
     );
   }
 
@@ -539,13 +571,13 @@ export class CloudDataApi {
     limit?: number,
   ): Promise<{ ticker: string; events: CloudFilingEventPayload[] }> {
     return this.request<{ ticker: string; events: CloudFilingEventPayload[] }>(
-      publicFilingEventsPath(ticker, limit),
+      cloudFilingEventsPath(ticker, limit),
     );
   }
 
   async getRiskReports(ticker: string): Promise<CloudRiskReportListPayload> {
     return this.request<CloudRiskReportListPayload>(
-      publicRiskReportsPath(ticker),
+      cloudRiskReportsPath(ticker),
     );
   }
 
@@ -554,7 +586,7 @@ export class CloudDataApi {
     year: number,
   ): Promise<CloudRiskReportPayload> {
     return this.request<CloudRiskReportPayload>(
-      publicRiskReportPath(ticker, year),
+      cloudRiskReportPath(ticker, year),
     );
   }
 

package/src/api-client/doe.ts

@@ -0,0 +1,75 @@
+/** EIA weekly petroleum and natural gas storage, as GET /cloud/doe/board serves it. */
+export type DoeReport = "petroleum" | "gas";
+export type DoeTab = "crude" | "products" | "gas";
+/** Thousand barrels, thousand barrels a day, percent, billion cubic feet: as published. */
+export type DoeUnit = "kb" | "kbd" | "pct" | "bcf";
+
+interface DoeFiveYear {
+  /** Calendar years in the band, oldest first; fewer than five where history is short. */
+  years: number[];
+  min: number;
+  max: number;
+  average: number;
+  /** The average change into this week over the same years. */
+  averageChange: number | null;
+  vsAverage: number;
+  vsAveragePercent: number | null;
+  /** 0 at the five-year low, 100 at the high, beyond either outside the range. */
+  position: number | null;
+}
+
+interface DoeYearAgo {
+  weekEnding: string;
+  value: number;
+  change: number;
+  changePercent: number | null;
+}
+
+interface DoeSeasonal {
+  /** The calendar year of the latest week. */
+  year: number;
+  /** Fridays in that year: 52 or 53. */
+  weeks: number;
+  /** [week of year, value]. */
+  current: Array<[number, number]>;
+  previous: Array<[number, number]>;
+  /** [week, min, average, max] of the band years on that week's day. */
+  band: Array<[number, number | null, number | null, number | null]>;
+}
+
+export interface DoeSeriesRow {
+  id: string;
+  key: string;
+  report: DoeReport;
+  tab: DoeTab;
+  label: string;
+  unit: DoeUnit;
+  weekEnding: string | null;
+  value: number | null;
+  previousWeekEnding: string | null;
+  weekChange: number | null;
+  yearAgo: DoeYearAgo | null;
+  fiveYear: DoeFiveYear | null;
+  /** One plain read worked out from the numbers. */
+  read: string | null;
+  seasonal: DoeSeasonal | null;
+}
+
+export interface DoeReportStatus {
+  id: DoeReport;
+  weekEnding: string | null;
+  releasedAt: string | null;
+  releaseHoliday: string | null;
+  nextWeekEnding: string | null;
+  nextReleaseAt: string | null;
+  nextReleaseHoliday: string | null;
+}
+
+export interface DoeBoardPayload {
+  source: "EIA";
+  generatedAt: string;
+  status: "available" | "partial" | "unavailable";
+  gaps: string[];
+  reports: DoeReportStatus[];
+  series: DoeSeriesRow[];
+}

package/src/api-client/estimate-revisions.ts

@@ -22,7 +22,7 @@ export interface EstimateObservation {
   analysts: number | null;
   range: number | null;
   relativeRange: number | null;
-  source: "yahoo" | "yahoo-eps-trend";
+  source: "gloom" | "gloom-eps-trend";
 }
 interface RevisionBreadth {
   days: 7 | 30;

package/src/api-client/futures-curve.ts

@@ -22,7 +22,7 @@ export interface FuturesContract {
 export interface FuturesCurvePayload {
   root: string
   name: string
-  source: "yahoo" | "cboe"
+  source: "gloom" | "cboe"
   currency: string | null
   quoteUnit: string | null
   asOf: string | null

package/src/api-client/index.ts

@@ -677,6 +677,12 @@ class GloomApiClient {
   getCloudQuote = this.data.getCloudQuote.bind(this.data);
   getCloudQuotesBatch = this.data.getCloudQuotesBatch.bind(this.data);
   getCloudWorldVenues = this.data.getCloudWorldVenues.bind(this.data);
+  getMarketEarningsCalendar = this.data.getMarketEarningsCalendar.bind(this.data);
+  getCloudArticleSummary = this.data.getCloudArticleSummary.bind(this.data);
+  getMarketMovers = this.data.getMarketMovers.bind(this.data);
+  getMarketTrending = this.data.getMarketTrending.bind(this.data);
+  getMarketHeatmap = this.data.getMarketHeatmap.bind(this.data);
+  getMarketDividends = this.data.getMarketDividends.bind(this.data);
   getCloudMarketScreener = this.data.getCloudMarketScreener.bind(this.data);
   getCloudOptionsChain = this.data.getCloudOptionsChain.bind(this.data);
   getCloudFinancials = this.data.getCloudFinancials.bind(this.data);
@@ -715,6 +721,7 @@ class GloomApiClient {
   getCloudShiller = this.data.getCloudShiller.bind(this.data);
   getCloudCotBoard = this.data.getCloudCotBoard.bind(this.data);
   getCloudCotContract = this.data.getCloudCotContract.bind(this.data);
+  getCloudDoeBoard = this.data.getCloudDoeBoard.bind(this.data);
   getCloudTape = this.data.getCloudTape.bind(this.data);
   getCloudYieldCurve = this.data.getCloudYieldCurve.bind(this.data);
   getCloudCurve = this.data.getCloudCurve.bind(this.data);

package/src/api-client/market-discovery.ts

@@ -0,0 +1,84 @@
+import type { CloudCorporateActionsPayload, CloudQuotePayload } from "./types";
+
+export interface ScreenerQuote {
+  symbol: string;
+  name: string;
+  price: number | null;
+  change: number | null;
+  changePercent: number | null;
+  volume: number | null;
+  avgVolume: number | null;
+  volumeRatio: number | null; // volume / avgVolume
+  marketCap: number | undefined;
+  currency: string;
+  fiftyTwoWeekHigh: number | undefined;
+  fiftyTwoWeekLow: number | undefined;
+  dayHigh: number | undefined;
+  dayLow: number | undefined;
+  exchange: string;
+  lastUpdated?: number;
+  /** Session-fixed, so the price column reads its decimals from it rather than from each tick. */
+  previousClose?: number;
+}
+
+
+export type MarketHeatmapUniverseId = "us-equity" | "us-etf";
+type MarketHeatmapSource = "gloom";
+type MarketHeatmapSizeKind = "market-cap" | "net-assets";
+export interface MarketHeatmapAsset {
+  symbol: string;
+  name: string;
+  price: number;
+  change: number;
+  changePercent: number;
+  /**
+   * Whether the source actually carried a session change. `changePercent` keeps
+   * a numeric 0 for the shared screener row shape, so tiles must read this
+   * before showing a flat session that was really missing data.
+   */
+  hasChange: boolean;
+  size: number | null;
+  sizeKind: MarketHeatmapSizeKind;
+  volume: number | null;
+  currency: string;
+  exchange: string;
+  sector: string | null;
+  industry: string | null;
+  marketState: string | null;
+  source: MarketHeatmapSource;
+}
+
+export interface MarketHeatmapResult {
+  stale?: boolean;
+  universe: MarketHeatmapUniverseId;
+  source: MarketHeatmapSource;
+  fetchedAt: number;
+  assets: MarketHeatmapAsset[];
+}
+
+
+export interface MarketMoversPayload {
+  quotes: ScreenerQuote[];
+  source: "gloom";
+  stale: boolean;
+  asOf: string;
+}
+
+export interface DividendSummary {
+  trailingAnnualDividendRate: number | null;
+  trailingAnnualDividendYield: number | null;
+  forwardAnnualDividendRate: number | null;
+  payoutRatio: number | null;
+  exDividendDate: number | null;
+  dividendDate: number | null;
+  currency: string | null;
+}
+
+export interface MarketDividendsPayload {
+  stale?: boolean;
+  actions: CloudCorporateActionsPayload | null;
+  quote: CloudQuotePayload | null;
+  summary: DividendSummary | null;
+  historyError?: string;
+  summaryError?: string;
+}

package/src/api-client/paths.ts

@@ -13,6 +13,8 @@ export type CloudHistoryParams = {
   endDate?: string;
   rangeKey?: string;
   historyRecovery?: HistoryRetention;
+  /** Ask for pre-market and after-hours bars too. */
+  session?: "extended";
 };
 
 export type CloudFredSeriesParams = {
@@ -172,6 +174,7 @@ export function cloudHistoryPath(
   if (params.endDate) search.set("endDate", params.endDate);
   if (params.rangeKey) search.set("rangeKey", params.rangeKey);
   if (params.historyRecovery) search.set("historyRecovery", JSON.stringify(params.historyRecovery));
+  if (params.session) search.set("session", params.session);
   return appendQuery("/market/history", search);
 }
 
@@ -311,30 +314,33 @@ export function cloudEarningsTranscriptPath(id: string): string {
   return `/cloud/transcripts/${encodeURIComponent(id)}`;
 }
 
-/** Executive compensation reads are open: no account, no plan. */
-export function publicProxyStatementsPath(ticker: string): string {
-  return `/public/proxies/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`;
+/**
+ * RISK, EXEC and EK are Pro: these reads need a verified Pro account. The same
+ * risk factors and pay are open under /public for the gloom.sh pages.
+ */
+export function cloudProxyStatementsPath(ticker: string): string {
+  return `/cloud/proxies/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`;
 }
 
-export function publicFilingEventsPath(ticker: string, limit?: number): string {
+export function cloudFilingEventsPath(ticker: string, limit?: number): string {
   const search = new URLSearchParams();
   if (limit != null) search.set("limit", String(limit));
   return appendQuery(
-    `/public/events/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`,
+    `/cloud/events/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`,
     search,
   );
 }
 
-export function publicRiskReportsPath(ticker: string): string {
-  return `/public/risks/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`;
+export function cloudRiskReportsPath(ticker: string): string {
+  return `/cloud/risks/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}`;
 }
 
-export function publicRiskReportPath(ticker: string, year: number): string {
-  return `/public/risks/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}/${year}`;
+export function cloudRiskReportPath(ticker: string, year: number): string {
+  return `/cloud/risks/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}/${year}`;
 }
 
-export function publicProxyStatementPath(ticker: string, year: number): string {
-  return `/public/proxies/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}/${year}`;
+export function cloudProxyStatementPath(ticker: string, year: number): string {
+  return `/cloud/proxies/${encodeURIComponent(normalizeIssuerResearchTicker(ticker))}/${year}`;
 }
 
 export function cloudSecFilingsPath(params: CloudSecFilingsParams): string {

package/src/api-client/request.ts

@@ -17,6 +17,12 @@ import { SESSION_COOKIE_NAMES } from "./session-cookie";
 
 const DEFAULT_API_URL = "https://api.gloom.sh";
 const DEFAULT_MARKET_REQUEST_TIMEOUT_MS = 10_000;
+const DEFAULT_RESEARCH_REQUEST_TIMEOUT_MS = 45_000;
+// Research may fill missing sections after a primary read; quote/history reads remain latency bounded.
+const RESEARCH_MARKET_PATHS = new Set([
+  "/market/dividends", "/market/short-interest", "/market/movers", "/market/trending",
+  "/market/heatmap", "/market/earnings-calendar",
+]);
 /** Local status for "this runtime cannot stream", never returned by the server. */
 export const STREAMING_UNSUPPORTED_STATUS = 0;
 
@@ -140,6 +146,7 @@ export class CloudApiRequestTransport {
   private cookieSessionMode = false;
   private readonly fetchTransport: CloudApiFetchTransport | null;
   private readonly marketRequestTimeoutMs: number;
+  private readonly researchRequestTimeoutMs: number;
   private readonly connectionHealth: ConnectionHealthRegistry;
 
   readonly baseUrl = getCloudApiBaseUrl();
@@ -154,6 +161,7 @@ export class CloudApiRequestTransport {
     this.fetchTransport = options.fetchTransport ?? null;
     this.marketRequestTimeoutMs =
       options.marketRequestTimeoutMs ?? DEFAULT_MARKET_REQUEST_TIMEOUT_MS;
+    this.researchRequestTimeoutMs = options.marketRequestTimeoutMs ?? DEFAULT_RESEARCH_REQUEST_TIMEOUT_MS;
     this.connectionHealth = options.connectionHealth ?? connectionHealth;
   }
 
@@ -257,6 +265,8 @@ export class CloudApiRequestTransport {
       return this.performRequest<T>(path, options, canApplySession);
     }
 
+    const timeoutMs = RESEARCH_MARKET_PATHS.has(path.split("?")[0]!)
+      ? this.researchRequestTimeoutMs : this.marketRequestTimeoutMs;
     const controller = new AbortController();
     const callerSignal = options?.signal;
     const abortFromCaller = () => controller.abort(callerSignal?.reason);
@@ -273,8 +283,8 @@ export class CloudApiRequestTransport {
       }, canApplySession);
       return await withDeadline(
         request,
-        this.marketRequestTimeoutMs,
-        `Cloud market request timed out after ${this.marketRequestTimeoutMs}ms: ${path}`,
+        timeoutMs,
+        `Cloud market request timed out after ${timeoutMs}ms: ${path}`,
         (error) => controller.abort(error),
       );
     } finally {

package/src/api-client/tape.ts

@@ -11,7 +11,7 @@ export interface TapeQuote {
   timestamp: string;
   bid: number | null;
   ask: number | null;
-  /** Alpaca quote sizes are round lots. */
+  /** Quote sizes are round lots. */
   bidSize: number;
   askSize: number;
   bidExchange: string;
@@ -20,7 +20,7 @@ export interface TapeQuote {
   tape: string;
 }
 export interface TapeSnapshot {
-  source: "Alpaca";
+  source: "Gloom Cloud";
   symbol: string;
   exchange: string;
   access: "realtime" | "delayed";

package/src/api-client/types.ts

@@ -454,6 +454,7 @@ export interface CloudCdsHistoryResponse {
 
 interface CloudShortInterestPointPayload {
   settlementDate: string;
+  shortPercentFloat?: number | null;
   sharesShort: number;
   previousSharesShort: number | null;
   averageDailyVolume: number | null;
@@ -463,6 +464,7 @@ interface CloudShortInterestPointPayload {
 }
 
 export interface CloudShortInterestPayload {
+  source?: "finra" | "gloom";
   symbol: string;
   issueName: string | null;
   points: CloudShortInterestPointPayload[];
@@ -1291,6 +1293,8 @@ export interface CloudMarketResponse<T> {
   historyRetention?: unknown;
   /** Source-declared history semantics; validated separately from quote metadata. */
   historySession?: unknown;
+  /** "extended" when the history includes the pre-market and after-hours bars asked for. */
+  session?: unknown;
   /** Untrusted until the history adapter validates its boundary dates. */
   coverage?: CloudHistoryCoverage;
   providerMeta?: {

package/src/app/dialog-bridge.tsx

@@ -0,0 +1,33 @@
+import { useCallback, useContext, type ReactNode } from "react";
+import { RemoteUiRegistryProvider, useRemoteUiRegistry } from "../remote/semantic-tree";
+import { AppContext, getEffectiveThemeId, useAppSelector } from "../state/app/context";
+import { ThemeProvider } from "../theme/theme-context";
+import { useRegisterDialogBridge } from "../ui/dialog-bridge";
+import { KeybindingsProvider, useKeybindings } from "./keybindings";
+
+function DialogTheme({ children }: { children: ReactNode }) {
+  const themeId = useAppSelector(getEffectiveThemeId);
+  return <ThemeProvider themeId={themeId}>{children}</ThemeProvider>;
+}
+
+/**
+ * Gives every dialog what the app gives its panes: the store, the theme, the
+ * keybindings and the remote registry, so a form in a dialog reads state and
+ * registers nodes like one in the app. Renders nothing.
+ */
+export function AppDialogBridge() {
+  const store = useContext(AppContext);
+  const registry = useRemoteUiRegistry();
+  const keybindings = useKeybindings();
+  const bridge = useCallback((content: ReactNode) => {
+    const withKeybindings = <KeybindingsProvider value={keybindings}>{content}</KeybindingsProvider>;
+    const withRegistry = registry
+      ? <RemoteUiRegistryProvider registry={registry}>{withKeybindings}</RemoteUiRegistryProvider>
+      : withKeybindings;
+    return store
+      ? <AppContext value={store}><DialogTheme>{withRegistry}</DialogTheme></AppContext>
+      : withRegistry;
+  }, [keybindings, registry, store]);
+  useRegisterDialogBridge(bridge);
+  return null;
+}

package/src/app/pane-runtime/index.tsx

@@ -6,6 +6,7 @@ import {
   bringToFront,
   findDockLeaf,
   getDockedPaneIds,
+  isPaneDetached,
   isPaneInLayout,
 } from "../../layout/pane-manager";
 import type { PluginRegistry } from "../../plugins/registry";
@@ -52,6 +53,8 @@ interface AppPaneRuntimeArgs {
   dialog: DialogApi;
   dispatch: Dispatch<AppAction>;
   externalPlugins: readonly LoadedExternalPlugin[];
+  /** Desktop main window: raises a detached pane's own window. */
+  focusDetachedPane?: (paneId: string) => void;
   isDetachedWindow: boolean;
   notify: (body: string, options?: { type?: "info" | "success" | "error" }) => void;
   persistConfig: (nextConfig: AppState["config"]) => void;
@@ -67,6 +70,7 @@ export function useAppPaneRuntime({
   dialog,
   dispatch,
   externalPlugins,
+  focusDetachedPane,
   isDetachedWindow,
   notify,
   persistConfig,
@@ -159,7 +163,9 @@ export function useAppPaneRuntime({
       persistLayout(nextLayout, { pushHistory: false });
     }
     activatePane(paneId);
-  }, [activatePane, persistLayout, state.config.layout]);
+    // Focus in this window's state alone would leave the pane's window behind this one.
+    if (isPaneDetached(nextLayout, paneId)) focusDetachedPane?.(paneId);
+  }, [activatePane, focusDetachedPane, persistLayout, state.config.layout]);
 
   const placePaneInstance = useCallback((
     instance: PaneInstanceConfig,
@@ -240,7 +246,6 @@ export function useAppPaneRuntime({
   const { createPaneFromTemplate } = useAppPaneTemplateRuntime({
     buildPaneInstance,
     dataProvider,
-    dialog,
     dispatch,
     notify,
     placePaneInstance,

package/src/app/pane-runtime/pane-settings-runtime.tsx

@@ -32,7 +32,7 @@ export function useAppPaneSettingsRuntime({
   stateRef,
   tickerRepository,
 }: UseAppPaneSettingsRuntimeOptions) {
-  const openPaneSettings = useCallback(async (paneId?: string) => {
+  const openPaneSettings = useCallback(async (paneId?: string, options?: { fieldKey?: string }) => {
     const targetPaneId = paneId
       ? resolvePaneTarget(paneId)
       : stateRef.current.focusedPaneId;
@@ -59,6 +59,7 @@ export function useAppPaneSettingsRuntime({
           paneId={targetPaneId}
           pluginRegistry={pluginRegistry}
           applyFieldValue={applyFieldValue}
+          initialFieldKey={options?.fieldKey}
         />
       ),
     });