gloomberb 0.4.0 → 0.5.0

package/src/plugins/registry.ts

@@ -8,6 +8,7 @@ import type { BrokerInstanceConfig, LayoutConfig, PaneInstanceConfig } from "../
 import type { DataProvider } from "../types/data-provider";
 import type { TickerFinancials } from "../types/financials";
 import type {
+  AppNotificationRequest,
   CommandDef,
   CustomColumnDef,
   DetailTabDef,
@@ -27,7 +28,7 @@ import type {
 import type { TickerRecord } from "../types/ticker";
 import { addPaneFloating, removePane } from "./pane-manager";
 import { EventBus, type PluginEvents } from "./event-bus";
-import { createPaneInstance } from "../types/config";
+import { createPaneInstance, resolvePaneInstance } from "../types/config";
 import { createPluginPersistence } from "./plugin-persistence";
 import { debugLog } from "../utils/debug-log";
 import { PluginRenderProvider, type PluginRuntimeAccess } from "./plugin-runtime";
@@ -104,6 +105,7 @@ export class PluginRegistry implements PluginRuntimeAccess {
   switchPanelFn: ((panel: "left" | "right") => void) = () => {};
   switchTabFn: ((tabId: string, paneId?: string) => void) = () => {};
   openCommandBarFn: ((query?: string) => void) = () => {};
+  openPluginCommandWorkflowFn: ((commandId: string) => void) = () => {};
   openPaneSettingsFn: ((paneId?: string) => void) = () => {};
   showPaneFn: ((paneId: string) => void) = () => {};
   createPaneFromTemplateFn: ((templateId: string, options?: PaneTemplateCreateOptions) => void) = () => {};
@@ -111,12 +113,22 @@ export class PluginRegistry implements PluginRuntimeAccess {
   hidePaneFn: ((paneId: string) => void) = () => {};
   focusPaneFn: ((paneId: string) => void) = () => {};
   pinTickerFn: ((symbol: string, options?: { floating?: boolean; paneType?: string }) => void) = () => {};
+  navigateTickerFn: ((symbol: string) => void) = () => {};
+  pinTicker = (symbol: string, options?: { floating?: boolean; paneType?: string }) => {
+    this.pinTickerFn(symbol, options);
+  };
+  navigateTicker = (symbol: string) => {
+    this.navigateTickerFn(symbol);
+  };
+  openPluginCommandWorkflow = (commandId: string) => {
+    this.openPluginCommandWorkflowFn(commandId);
+  };
 
   getLayoutFn: (() => LayoutConfig) = () => ({ dockRoot: null, instances: [], floating: [] });
   updateLayoutFn: ((layout: LayoutConfig) => void) = () => {};
   getTermSizeFn: (() => { width: number; height: number }) = () => ({ width: 120, height: 40 });
 
-  showToastFn: ((message: string, options?: { duration?: number; type?: "info" | "success" | "error" }) => void) = () => {};
+  notifyFn: ((notification: AppNotificationRequest) => void) = () => {};
   getPaneRuntimeStateFn: ((paneId: string) => PaneRuntimeState | null) = () => null;
   updatePaneRuntimeStateFn: ((paneId: string, patch: Partial<PaneRuntimeState>) => void) = () => {};
   applyPaneSettingValueFn: ((paneId: string, field: import("../types/plugin").PaneSettingField, value: unknown) => Promise<void>) = async () => {};
@@ -177,6 +189,10 @@ export class PluginRegistry implements PluginRuntimeAccess {
     return this.pluginItems.get(pluginId)?.paneTemplates ?? [];
   }
 
+  notify(notification: AppNotificationRequest): void {
+    this.notifyFn(notification);
+  }
+
   private getOrCreatePluginItems(pluginId: string): PluginItems {
     const existing = this.pluginItems.get(pluginId);
     if (existing) return existing;
@@ -272,16 +288,8 @@ export class PluginRegistry implements PluginRuntimeAccess {
     return Object.keys(this.getConfigFn().pluginConfig[pluginId] ?? {}).sort();
   }
 
-  private resolvePrimaryPaneInstanceId(paneId: string): string | undefined {
-    const layout = this.getLayoutFn();
-    return layout.instances.find((instance) => instance.paneId === paneId)?.instanceId;
-  }
-
   private resolvePaneTarget(paneId: string): string | undefined {
-    const layout = this.getLayoutFn();
-    const isInstanceId = layout.instances.some((instance) => instance.instanceId === paneId);
-    if (isInstanceId) return paneId;
-    return this.resolvePrimaryPaneInstanceId(paneId);
+    return resolvePaneInstance(this.getLayoutFn(), paneId)?.instanceId;
   }
 
   resolvePaneSettings(paneId: string): {
@@ -514,7 +522,8 @@ export class PluginRegistry implements PluginRuntimeAccess {
       createPaneFromTemplate: (templateId, options) => this.createPaneFromTemplateFn(templateId, options),
       hidePane: (paneId) => this.hidePaneFn(paneId),
       focusPane: (paneId) => this.focusPaneFn(paneId),
-      pinTicker: (symbol, options) => this.pinTickerFn(symbol, options),
+      pinTicker: this.pinTicker,
+      navigateTicker: this.navigateTicker,
       openPaneSettings: (paneId) => this.openPaneSettingsFn(paneId),
 
       on: <K extends keyof PluginEvents>(event: K, handler: (payload: PluginEvents[K]) => void) => {
@@ -526,7 +535,7 @@ export class PluginRegistry implements PluginRuntimeAccess {
 
       showWidget: (widgetId) => this.showWidget(widgetId),
       hideWidget: (widgetId) => this.hideWidget(widgetId),
-      showToast: (message, options) => this.showToastFn(message, options),
+      notify: (notification) => this.notifyFn(notification),
     };
   }
 
@@ -630,4 +639,27 @@ export class PluginRegistry implements PluginRuntimeAccess {
     this.plugins.delete(pluginId);
     this.events.emit("plugin:unregistered", { pluginId });
   }
+
+  destroy(): void {
+    for (const pluginId of [...this.plugins.keys()].reverse()) {
+      try {
+        this.unregister(pluginId);
+      } catch (error) {
+        this.registryLog.error("Failed to unregister plugin during registry destroy", {
+          pluginId,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    }
+    this.pluginResumeListeners.clear();
+    if (sharedRegistry === this) {
+      sharedRegistry = undefined;
+    }
+    if (sharedDataProvider === this.dataProvider) {
+      sharedDataProvider = undefined;
+    }
+    if ((globalThis as any).__gloomRegistry === this) {
+      delete (globalThis as any).__gloomRegistry;
+    }
+  }
 }

package/src/sources/provider-router.test.ts

@@ -1293,7 +1293,8 @@ describe("ProviderRouter", () => {
   test("drops stale cached cloud quotes while preserving cached cloud fundamentals", () => {
     const dbPath = createTempDbPath("stale-cloud-cached-financials");
     const persistence = new AppPersistence(dbPath);
-    const now = Date.parse("2026-04-08T10:55:00Z");
+    const now = Date.now();
+    const previousSession = now - 24 * 60 * 60_000;
 
     persistence.resources.set(
       {
@@ -1313,7 +1314,7 @@ describe("ProviderRouter", () => {
           currency: "EUR",
           change: 28,
           changePercent: 5.6,
-          lastUpdated: Date.parse("2026-04-07T19:55:00Z"),
+          lastUpdated: previousSession,
           marketState: "REGULAR",
           exchangeName: "FWB2",
           listingExchangeName: "FWB2",

package/src/sources/sec-edgar.ts

@@ -507,9 +507,21 @@ export class SecEdgarClient {
   }
 
   async getFilingContent(filing: Pick<SecFilingItem, "primaryDocumentUrl" | "filingUrl" | "form">): Promise<string | null> {
-    const targetUrl = filing.primaryDocumentUrl || filing.filingUrl;
+    let targetUrl = filing.primaryDocumentUrl || filing.filingUrl;
     if (!targetUrl) return null;
 
+    // SEC ownership forms (3/4/5) have XSL-prefixed primaryDocument paths
+    // (e.g., "xslF345X06/wk-form4_xxx.xml") which return rendered HTML.
+    // Strip the prefix and return the raw XML for programmatic parsing.
+    const ownershipForms = new Set(["3", "4", "5"]);
+    if (filing.primaryDocumentUrl && filing.form && ownershipForms.has(filing.form.trim())) {
+      const rawUrl = filing.primaryDocumentUrl.replace(/\/xsl[^/]+\//, "/");
+      if (rawUrl !== filing.primaryDocumentUrl) {
+        const { body } = await this.fetchText(rawUrl);
+        return body;
+      }
+    }
+
     if (filing.primaryDocumentUrl && isPdfDocument("", "", filing.primaryDocumentUrl)) {
       const alternativeUrl = filing.filingUrl
         ? await this.findAlternativeHtmlDocumentUrl(filing.filingUrl, filing.primaryDocumentUrl)

package/src/sources/yahoo-finance.ts

@@ -1,5 +1,5 @@
 import type { Quote, Fundamentals, FinancialStatement, PricePoint, TickerFinancials, MarketState, OptionContract, OptionsChain, CompanyProfile } from "../types/financials";
-import type { DataProvider, MarketDataRequestContext, NewsItem, SecFilingItem } from "../types/data-provider";
+import type { DataProvider, EarningsEvent, MarketDataRequestContext, NewsItem, SecFilingItem } from "../types/data-provider";
 import type { TimeRange } from "../components/chart/chart-types";
 import {
   normalizeChartResolutionSupport,
@@ -1065,4 +1065,78 @@ export class YahooFinanceClient implements DataProvider {
     }
     throw lastError || new Error(`No options chain for ${ticker}`);
   }
+
+  async getEarningsCalendar(symbols: string[], _context?: MarketDataRequestContext): Promise<EarningsEvent[]> {
+    const results: EarningsEvent[] = [];
+    const BATCH_SIZE = 5;
+
+    for (let i = 0; i < symbols.length; i += BATCH_SIZE) {
+      if (i > 0) await new Promise((r) => setTimeout(r, 200));
+      const batch = symbols.slice(i, i + BATCH_SIZE);
+
+      const settled = await Promise.allSettled(
+        batch.map(async (symbol) => {
+          const params = new URLSearchParams({ modules: "calendarEvents,earningsTrend,quoteType" });
+          const url = `https://query1.finance.yahoo.com/v10/finance/quoteSummary/${encodeURIComponent(symbol)}?${params}`;
+          const data = await this.fetchJsonWithCrumb<{
+            quoteSummary?: {
+              result?: Array<{
+                calendarEvents?: {
+                  earnings?: {
+                    earningsDate?: Array<{ raw: number }>;
+                    earningsAverage?: { raw: number };
+                    revenueAverage?: { raw: number };
+                  };
+                };
+                earningsTrend?: {
+                  trend?: Array<{
+                    period: string;
+                    earningsEstimate?: { avg?: { raw: number } };
+                    revenueEstimate?: { avg?: { raw: number } };
+                  }>;
+                };
+                quoteType?: {
+                  shortName?: string;
+                  longName?: string;
+                };
+              }>;
+            };
+          }>(`earnings ${symbol}`, url);
+
+          const mod = data.quoteSummary?.result?.[0];
+          if (!mod) return null;
+
+          const cal = mod.calendarEvents?.earnings;
+          if (!cal?.earningsDate?.length) return null;
+
+          const earningsDate = new Date(cal.earningsDate[0]!.raw * 1000);
+          if (isNaN(earningsDate.getTime())) return null;
+
+          const currentQtr = mod.earningsTrend?.trend?.find((t) => t.period === "0q");
+          const name = mod.quoteType?.shortName || mod.quoteType?.longName || symbol;
+
+          return {
+            symbol,
+            name,
+            earningsDate,
+            epsEstimate: currentQtr?.earningsEstimate?.avg?.raw ?? cal.earningsAverage?.raw ?? null,
+            epsActual: null,
+            revenueEstimate: currentQtr?.revenueEstimate?.avg?.raw ?? cal.revenueAverage?.raw ?? null,
+            revenueActual: null,
+            surprise: null,
+            timing: "" as const,
+          };
+        }),
+      );
+
+      for (const result of settled) {
+        if (result.status === "fulfilled" && result.value) {
+          results.push(result.value);
+        }
+      }
+    }
+
+    results.sort((a, b) => a.earningsDate.getTime() - b.earningsDate.getTime());
+    return results;
+  }
 }

package/src/state/app-context-selector.test.tsx

@@ -3,7 +3,7 @@ import { act, useRef, type Dispatch } from "react";
 import { testRender } from "@opentui/react/test-utils";
 import { AppProvider, PaneInstanceProvider, useAppDispatch, useAppSelector, usePaneTicker, type AppAction } from "./app-context";
 import { cloneLayout, createDefaultConfig, type AppConfig } from "../types/config";
-import { getCurrentThemeId } from "../theme/colors";
+import { applyTheme, getCurrentThemeId } from "../theme/colors";
 
 const TEST_PANE_ID = "ticker-detail:test";
 
@@ -51,6 +51,7 @@ describe("pane selectors", () => {
     testSetup?.renderer.destroy();
     testSetup = undefined;
     capturedDispatch = null;
+    applyTheme("amber");
   });
 
   test("does not rerender usePaneTicker consumers for unrelated app state updates", async () => {
@@ -96,4 +97,19 @@ describe("pane selectors", () => {
     await testSetup.renderOnce();
     expect(testSetup.captureCharFrame()).toContain(`${TEST_PANE_ID}:green`);
   });
+
+  test("uses the configured theme on the first provider render", async () => {
+    const config = createTickerDetailConfig("AAPL");
+    config.theme = "green";
+
+    testSetup = await testRender(
+      <AppProvider config={config}>
+        <ThemeSelectorHarness />
+      </AppProvider>,
+      { width: 32, height: 4 },
+    );
+
+    await testSetup.renderOnce();
+    expect(testSetup.captureCharFrame()).toContain(`${TEST_PANE_ID}:green`);
+  });
 });

package/src/state/app-context.test.tsx

@@ -22,6 +22,30 @@ describe("appReducer command bar state", () => {
     expect(next.commandBarQuery).toBe("");
   });
 
+  test("stores and clears command bar launch requests", () => {
+    const initial = createInitialState(createDefaultConfig("/tmp/gloomberb-test"));
+    const opened = appReducer(initial, {
+      type: "SET_COMMAND_BAR",
+      open: true,
+      launch: { kind: "plugin-command", commandId: "set-alert" },
+    });
+    const relaunched = appReducer(opened, {
+      type: "SET_COMMAND_BAR",
+      open: true,
+      launch: { kind: "plugin-command", commandId: "set-alert" },
+    });
+    const closed = appReducer(relaunched, { type: "SET_COMMAND_BAR", open: false });
+
+    expect(opened.commandBarOpen).toBe(true);
+    expect(opened.commandBarLaunchRequest).toEqual({
+      kind: "plugin-command",
+      commandId: "set-alert",
+      sequence: 1,
+    });
+    expect(relaunched.commandBarLaunchRequest?.sequence).toBe(2);
+    expect(closed.commandBarLaunchRequest).toBeNull();
+  });
+
   test("toggle opens blank and clears on close", () => {
     const initial = createInitialState(createDefaultConfig("/tmp/gloomberb-test"));
     const opened = appReducer(initial, { type: "TOGGLE_COMMAND_BAR" });

package/src/state/app-context.tsx

@@ -13,7 +13,7 @@ import {
 } from "react";
 import type { SessionStore } from "../data/session-store";
 import { saveConfig } from "../data/config-store";
-import { applyTheme } from "../theme/colors";
+import { applyTheme, syncTheme } from "../theme/colors";
 import { isBrokerPortfolioId } from "../utils/broker-instances";
 import { resolveTickerFinancialsQuoteState } from "../utils/quote-resolution";
 import {
@@ -61,6 +61,12 @@ export interface CollectionSortPreference {
   direction: SortDirection;
 }
 
+export interface CommandBarLaunchRequest {
+  kind: "plugin-command";
+  commandId: string;
+  sequence: number;
+}
+
 export interface AppState {
   config: AppConfig;
   tickers: Map<string, TickerRecord>;
@@ -73,6 +79,7 @@ export interface AppState {
   recentTickers: string[];
   commandBarOpen: boolean;
   commandBarQuery: string;
+  commandBarLaunchRequest: CommandBarLaunchRequest | null;
   refreshing: Set<string>;
   initialized: boolean;
   statusBarVisible: boolean;
@@ -97,7 +104,12 @@ export type AppAction =
   | { type: "TRACK_TICKER"; symbol: string | null }
   | { type: "SET_ACTIVE_PANEL"; panel: "left" | "right" }
   | { type: "TOGGLE_COMMAND_BAR" }
-  | { type: "SET_COMMAND_BAR"; open: boolean; query?: string }
+  | {
+      type: "SET_COMMAND_BAR";
+      open: boolean;
+      query?: string;
+      launch?: { kind: "plugin-command"; commandId: string } | null;
+    }
   | { type: "SET_COMMAND_BAR_QUERY"; query: string }
   | { type: "SET_REFRESHING"; symbol: string; refreshing: boolean }
   | { type: "SET_BROKER_ACCOUNTS"; instanceId: string; accounts: BrokerAccount[] }
@@ -492,15 +504,23 @@ export function appReducer(state: AppState, action: AppAction): AppState {
 
     case "TOGGLE_COMMAND_BAR":
       return state.commandBarOpen
-        ? { ...state, commandBarOpen: false, commandBarQuery: "" }
-        : { ...state, commandBarOpen: true, commandBarQuery: "" };
-
-    case "SET_COMMAND_BAR":
+        ? { ...state, commandBarOpen: false, commandBarQuery: "", commandBarLaunchRequest: null }
+        : { ...state, commandBarOpen: true, commandBarQuery: "", commandBarLaunchRequest: null };
+
+    case "SET_COMMAND_BAR": {
+      const launchRequest = action.open && action.launch
+        ? {
+            ...action.launch,
+            sequence: (state.commandBarLaunchRequest?.sequence ?? 0) + 1,
+          }
+        : null;
       return {
         ...state,
         commandBarOpen: action.open,
         commandBarQuery: action.open ? (action.query ?? "") : "",
+        commandBarLaunchRequest: launchRequest,
       };
+    }
 
     case "SET_COMMAND_BAR_QUERY":
       return { ...state, commandBarQuery: action.query };
@@ -1018,6 +1038,7 @@ export function createInitialState(config: AppConfig, sessionSnapshot: AppSessio
     recentTickers: config.recentTickers,
     commandBarOpen: false,
     commandBarQuery: "",
+    commandBarLaunchRequest: null,
     refreshing: new Set(),
     initialized: false,
     statusBarVisible: sessionSnapshot?.statusBarVisible !== false,
@@ -1043,6 +1064,8 @@ export function AppProvider({
   sessionStore?: SessionStore;
   sessionSnapshot?: AppSessionSnapshot | null;
 }) {
+  // Sync the configured theme before descendants read the shared palette on first render.
+  syncTheme(config.theme);
   const [state, dispatch] = useReducer(appReducer, { config, sessionSnapshot }, ({ config, sessionSnapshot: initialSessionSnapshot }) => (
     createInitialState(config, initialSessionSnapshot)
   ));

package/src/theme/colors.ts

@@ -18,6 +18,11 @@ export function applyTheme(id: string): void {
   Object.assign(colors, theme);
 }
 
+export function syncTheme(id: string): void {
+  if (currentThemeId === id) return;
+  applyTheme(id);
+}
+
 export type ColorKey = keyof typeof colors;
 
 export { blendHex } from "./color-utils";

package/src/theme/themes.ts

@@ -17,6 +17,7 @@ export interface Theme {
   positive: string;
   negative: string;
   neutral: string;
+  warning: string;
 
   header: string;
   headerText: string;
@@ -79,6 +80,12 @@ function normalizeTheme(theme: Theme): Theme {
     highestMinimumContrast(bodySurfaces, [textDim, text, "#c0c7d1"]),
     SUBTLE_TEXT_MIN,
   );
+  const warning = blendForContrastOnSurfaces(
+    theme.warning,
+    bodySurfaces,
+    blendHex(theme.warning, theme.textBright, 0.5),
+    SUBTLE_TEXT_MIN,
+  );
   const selected = blendForContrastOnSurfaces(
     theme.selected,
     bodySurfaces,
@@ -106,6 +113,7 @@ function normalizeTheme(theme: Theme): Theme {
     positive,
     negative,
     neutral,
+    warning,
     headerText,
     selected,
     selectedText,
@@ -127,6 +135,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#888888",
+    warning: "#ffaa00",
     header: "#0044aa",
     headerText: "#ffffff",
     selected: "#1a3a5c",
@@ -149,6 +158,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00ff66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#cccc00",
     header: "#003300",
     headerText: "#00ff00",
     selected: "#003300",
@@ -171,6 +181,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00ff88",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddcc00",
     header: "#002222",
     headerText: "#00ffff",
     selected: "#002a2a",
@@ -193,6 +204,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44cc44",
     negative: "#ff6666",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#220000",
     headerText: "#ff3333",
     selected: "#2a0000",
@@ -215,6 +227,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#000033",
     headerText: "#4488ff",
     selected: "#001144",
@@ -237,6 +250,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44dd66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#1a0028",
     headerText: "#bb55ff",
     selected: "#220033",
@@ -259,6 +273,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44dd66",
     negative: "#ff5555",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#22000f",
     headerText: "#ff44aa",
     selected: "#2a0018",
@@ -281,6 +296,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#888888",
+    warning: "#ddaa00",
     header: "#1a1a1a",
     headerText: "#ffffff",
     selected: "#222222",
@@ -303,6 +319,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#9ece6a",
     negative: "#f7768e",
     neutral: "#565f89",
+    warning: "#e0af68",
     header: "#24283b",
     headerText: "#7aa2f7",
     selected: "#283457",
@@ -325,6 +342,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#859900",
     negative: "#dc322f",
     neutral: "#657b83",
+    warning: "#b58900",
     header: "#073642",
     headerText: "#268bd2",
     selected: "#0a4a5c",
@@ -347,6 +365,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#50fa7b",
     negative: "#ff5555",
     neutral: "#6272a4",
+    warning: "#f1fa8c",
     header: "#44475a",
     headerText: "#bd93f9",
     selected: "#44475a",
@@ -369,6 +388,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a3be8c",
     negative: "#bf616a",
     neutral: "#4c566a",
+    warning: "#ebcb8b",
     header: "#3b4252",
     headerText: "#88c0d0",
     selected: "#4c566a",
@@ -391,6 +411,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a6e22e",
     negative: "#f92672",
     neutral: "#75715e",
+    warning: "#e6db74",
     header: "#49483e",
     headerText: "#e6db74",
     selected: "#49483e",
@@ -413,6 +434,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a6e3a1",
     negative: "#f38ba8",
     neutral: "#6c7086",
+    warning: "#f9e2af",
     header: "#313244",
     headerText: "#cba6f7",
     selected: "#3e3f56",
@@ -435,6 +457,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#b8bb26",
     negative: "#fb4934",
     neutral: "#928374",
+    warning: "#fabd2f",
     header: "#3c3836",
     headerText: "#fabd2f",
     selected: "#3c3836",
@@ -457,6 +480,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#31748f",
     negative: "#eb6f92",
     neutral: "#6e6a86",
+    warning: "#f6c177",
     header: "#26233a",
     headerText: "#c4a7e7",
     selected: "#332f4a",
@@ -479,6 +503,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#6688bb",
+    warning: "#ff9900",
     header: "#001144",
     headerText: "#ff6600",
     selected: "#002255",

package/src/types/config.test.ts

@@ -0,0 +1,107 @@
+import { describe, expect, test } from "bun:test";
+import {
+  createPaneInstance,
+  findPrimaryPaneInstance,
+  resolveFollowBindingInstance,
+  resolvePaneInstance,
+  type LayoutConfig,
+  type PaneInstanceConfig,
+} from "./config";
+
+function createLayout(instances: PaneInstanceConfig[]): LayoutConfig {
+  return {
+    dockRoot: null,
+    instances,
+    floating: [],
+  };
+}
+
+describe("findPrimaryPaneInstance", () => {
+  test("prefers the main non-fixed ticker pane", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:pinned",
+        binding: { kind: "fixed", symbol: "AAPL" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:main",
+        binding: { kind: "follow", sourceInstanceId: "portfolio-list:main" },
+      }),
+    ]);
+
+    expect(findPrimaryPaneInstance(layout, "ticker-detail")?.instanceId).toBe("ticker-detail:main");
+  });
+
+  test("does not treat fixed ticker panes as the primary pane", () => {
+    const layout = createLayout([
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:aapl",
+        binding: { kind: "fixed", symbol: "AAPL" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:msft",
+        binding: { kind: "fixed", symbol: "MSFT" },
+      }),
+    ]);
+
+    expect(findPrimaryPaneInstance(layout, "ticker-detail")).toBeUndefined();
+  });
+});
+
+describe("resolvePaneInstance", () => {
+  test("accepts either an instance id or a pane id", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+    ]);
+
+    expect(resolvePaneInstance(layout, "portfolio-list:main")?.instanceId).toBe("portfolio-list:main");
+    expect(resolvePaneInstance(layout, "portfolio-list")?.instanceId).toBe("portfolio-list:main");
+  });
+});
+
+describe("resolveFollowBindingInstance", () => {
+  test("walks follow bindings until it finds a matching pane", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:main",
+        binding: { kind: "follow", sourceInstanceId: "portfolio-list:main" },
+      }),
+      createPaneInstance("quote-monitor", {
+        instanceId: "quote-monitor:main",
+        binding: { kind: "follow", sourceInstanceId: "ticker-detail:main" },
+      }),
+    ]);
+
+    expect(
+      resolveFollowBindingInstance(layout, "quote-monitor:main", (instance) => instance.paneId === "portfolio-list")?.instanceId,
+    ).toBe("portfolio-list:main");
+  });
+
+  test("stops on follow cycles", () => {
+    const layout = createLayout([
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:first",
+        binding: { kind: "follow", sourceInstanceId: "quote-monitor:first" },
+      }),
+      createPaneInstance("quote-monitor", {
+        instanceId: "quote-monitor:first",
+        binding: { kind: "follow", sourceInstanceId: "ticker-detail:first" },
+      }),
+    ]);
+
+    expect(
+      resolveFollowBindingInstance(layout, "ticker-detail:first", (instance) => instance.paneId === "portfolio-list"),
+    ).toBeUndefined();
+  });
+});