gloomberb 0.15.3 → 0.15.5

package/src/api-client/types.ts

@@ -171,7 +171,7 @@ export interface BuildoutTokenResponse {
   expiresAt: string;
 }
 
-export interface CloudPricingTier {
+interface CloudPricingTier {
   /** Charged amount, in integer cents. */
   amount: number;
 }
@@ -370,7 +370,7 @@ export interface CloudFredSeriesPayload {
  * One month of Robert Shiller's dataset. FRED carries no long-run S&P earnings,
  * so this is what every earnings-based valuation ratio is built from.
  */
-export interface CloudShillerObservationPayload {
+interface CloudShillerObservationPayload {
   date: string;
   price: number | null;
   dividend: number | null;
@@ -444,7 +444,7 @@ export interface CloudCdsHistoryResponse {
   points: CloudCdsHistoryPointPayload[];
 }
 
-export interface CloudShortInterestPointPayload {
+interface CloudShortInterestPointPayload {
   settlementDate: string;
   sharesShort: number;
   previousSharesShort: number | null;
@@ -585,7 +585,7 @@ export interface CloudEarningsCallPayload {
   webcastUrl?: string | null;
 }
 
-export interface CloudJobsSeriesPoint {
+interface CloudJobsSeriesPoint {
   day: string;
   open: number;
   /** Null on the first observed day, when the whole board is seen for the first time. */
@@ -687,7 +687,7 @@ export interface CloudJobsSummaryPayload {
   recent: CloudJobsPosting[];
 }
 
-export interface CloudJobsPendingPayload {
+interface CloudJobsPendingPayload {
   status: "pending";
   ticker: string;
   queued: boolean;
@@ -744,7 +744,7 @@ export interface CloudExecutiveRowPayload {
   total: number | null;
 }
 
-export interface CloudProxyStatementSummaryPayload {
+interface CloudProxyStatementSummaryPayload {
   id: string;
   ticker: string;
   company: {
@@ -778,7 +778,7 @@ export interface CloudProxyStatementPayload extends CloudProxyStatementSummaryPa
   otherYears: CloudProxyStatementSummaryPayload[];
 }
 
-export interface CloudRiskFactorPayload {
+interface CloudRiskFactorPayload {
   heading: string;
   group: string | null;
   excerpt: string;
@@ -791,7 +791,7 @@ export interface CloudRiskNotePayload {
   text: string;
 }
 
-export interface CloudRiskReportSummaryPayload {
+interface CloudRiskReportSummaryPayload {
   id: string;
   ticker: string;
   company: {
@@ -848,7 +848,7 @@ export interface CloudRiskReportListPayload {
   reports: CloudRiskReportSummaryPayload[];
 }
 
-export interface CloudFilingPersonPayload {
+interface CloudFilingPersonPayload {
   name: string;
   role: string;
   action: string;
@@ -904,7 +904,7 @@ export interface CloudTranscriptTurnPayload {
   startSeconds: number | null;
 }
 
-export interface CloudTranscriptKeyFigurePayload {
+interface CloudTranscriptKeyFigurePayload {
   /** What the number is, e.g. "Q3 revenue guidance". */
   label: string;
   /** As management said it, e.g. "$108B ± 2%". */
@@ -913,7 +913,7 @@ export interface CloudTranscriptKeyFigurePayload {
   note?: string;
 }
 
-export interface CloudTranscriptParticipantPayload {
+interface CloudTranscriptParticipantPayload {
   name: string;
   role?: string;
   company?: string;
@@ -1056,7 +1056,7 @@ export interface CloudSavedSearchInput {
   alertChannels?: string[];
 }
 
-export interface CloudSecFilingPayload {
+interface CloudSecFilingPayload {
   accessionNumber: string;
   form: string;
   filingDate: string;
@@ -1072,7 +1072,7 @@ export interface CloudSecFilingPayload {
   primaryDocumentUrl?: string;
 }
 
-export interface CloudSecDocumentPayload {
+interface CloudSecDocumentPayload {
   sequence?: string;
   type: string;
   description?: string;
@@ -1092,7 +1092,7 @@ export interface CloudSecDocumentsResponse {
   documents: CloudSecDocumentPayload[];
 }
 
-export interface CloudSecForm4Payload {
+interface CloudSecForm4Payload {
   filingDate: string;
   reportedName: string;
   title: string;
@@ -1359,7 +1359,7 @@ export type CloudEquityDiagnosticFindingKind =
   "red_flag" | "green_flag" | "anomaly";
 
 /** 3 is the most severe. */
-export type CloudEquityDiagnosticSeverity = 1 | 2 | 3;
+type CloudEquityDiagnosticSeverity = 1 | 2 | 3;
 
 export interface CloudEquityDiagnosticFinding {
   id: string;
@@ -1393,7 +1393,7 @@ export interface CloudEquityDiagnosticEvidence {
   url?: string;
 }
 
-export interface CloudEquityDiagnosticPending {
+interface CloudEquityDiagnosticPending {
   status: "generating";
   retryAfterMs: number;
 }
@@ -1459,7 +1459,7 @@ export type ScannerKind = "hilo" | "flow";
 
 export type ScannerStatus = "live" | "starting" | "closed" | "degraded";
 
-export interface ScannerWindowCounts {
+interface ScannerWindowCounts {
   highs: number;
   lows: number;
 }
@@ -1474,7 +1474,7 @@ export interface ScannerHiloExtreme {
 }
 
 /** Which entitlement tier produced the payload: free accounts get a delayed instance. */
-export interface ScannerAccessInfo {
+interface ScannerAccessInfo {
   access: "realtime" | "delayed";
   /** 0 on the realtime instance, 15 on the delayed one. */
   delayMinutes: number;
@@ -1559,7 +1559,7 @@ export interface QuoteStreamTarget {
   weight?: number;
 }
 
-export const TEAM_ACCENT_COLORS = [
+const TEAM_ACCENT_COLORS = [
   "amber",
   "blue",
   "cyan",
@@ -1667,7 +1667,7 @@ interface TeamNotificationTeam {
   shortName: string;
 }
 
-export type TeamNotificationData =
+type TeamNotificationData =
   | {
       kind: "team-invite";
       team: TeamNotificationTeam;
@@ -1685,7 +1685,7 @@ export type TeamNotificationData =
       author: TeamActor;
     };
 
-export type TeamNotificationType = TeamNotificationData["kind"];
+type TeamNotificationType = TeamNotificationData["kind"];
 
 export interface TeamNotification {
   id: string;
@@ -1697,10 +1697,10 @@ export interface TeamNotification {
 
 // Cloud notes
 
-export type NoteOwnerKind = "user" | "team";
+type NoteOwnerKind = "user" | "team";
 export type NoteKind = "ticker" | "quick";
 
-export interface CloudNoteOwner {
+interface CloudNoteOwner {
   kind: NoteOwnerKind;
   id: string;
 }
@@ -1733,14 +1733,14 @@ export type ThesisStatus = "watching" | "active" | "closed";
 export type ThesisHealth = "unverified" | "intact" | "weakening" | "broken";
 export type ThesisPillarStatus = ThesisHealth;
 
-export interface ThesisInstrument {
+interface ThesisInstrument {
   symbol: string;
   exchange?: string;
   side: "long" | "short";
   role: "core" | "hedge";
 }
 
-export interface ThesisMetricBound {
+interface ThesisMetricBound {
   key: string;
   op: ">=" | "<=";
   value: number;
@@ -1783,13 +1783,13 @@ export interface ThesisDocument {
   entry?: { date?: string; price?: number };
 }
 
-export interface ThesisOutcome {
+interface ThesisOutcome {
   verdict: "right" | "wrong" | "lucky" | "unlucky";
   returnPct?: number;
   lesson?: string;
 }
 
-export interface ThesisEditor {
+interface ThesisEditor {
   id: string;
   username: string | null;
   displayName: string;
@@ -1817,11 +1817,11 @@ export interface CloudThesis {
   closedAt: string | null;
 }
 
-export type ThesisSignalTargetKind = "pillar" | "kill" | "catalyst" | "thesis";
-export type ThesisSignalVerdict = "supports" | "challenges" | "breaks" | "neutral";
-export type ThesisSignalStatus = "open" | "accepted" | "dismissed" | "snoozed" | "noted";
+type ThesisSignalTargetKind = "pillar" | "kill" | "catalyst" | "thesis";
+type ThesisSignalVerdict = "supports" | "challenges" | "breaks" | "neutral";
+type ThesisSignalStatus = "open" | "accepted" | "dismissed" | "snoozed" | "noted";
 
-export interface ThesisSignalSource {
+interface ThesisSignalSource {
   kind: "news" | "filing" | "transcript" | "metric" | "review" | "user";
   id?: string;
   title?: string;
@@ -1893,7 +1893,7 @@ export interface TeamCollectionItem {
   updatedAt: string;
 }
 
-export type TeamCollectionChange =
+type TeamCollectionChange =
   | { change: "created"; collection: TeamCollection }
   | { change: "updated"; collection: TeamCollection }
   | { change: "deleted"; collectionId: string }

package/src/api-client/yield-curves.ts

@@ -0,0 +1,47 @@
+/** Government bond curves stored from their official publishers, in percent. */
+export type CloudCurveId = "us" | "us-real" | "us-breakeven" | "eu-aaa" | "de" | "gb" | "jp" | "ca";
+
+export interface CloudCurvePoint {
+  tenor: string;
+  years: number;
+  yield: number | null;
+}
+
+interface CloudCurveHeader {
+  id: CloudCurveId;
+  label: string;
+  country: string;
+  /** par: bonds priced at par; zero: spot rates; benchmark: named benchmark bonds; spread: nominal minus real. */
+  basis: "par" | "zero" | "benchmark" | "spread";
+  couponsPerYear: number;
+}
+
+export interface CloudCurveView {
+  curve: CloudCurveHeader;
+  requestedDate: string | null;
+  /** The session the publisher dates the curve. */
+  asOf: string;
+  points: CloudCurvePoint[];
+  lookbacks: Array<{ id: "1D" | "1W" | "1M"; requestedDate: string; asOf: string | null; points: CloudCurvePoint[] | null }>;
+  spreads: Array<{
+    id: string;
+    short: string;
+    long: string;
+    /** Long minus short, percentage points. */
+    value: number | null;
+    change1d: number | null;
+    percentile1y: number | null;
+    observations1y: number;
+  }>;
+  checkedAt: string | null;
+}
+
+export interface CloudWorldCurves {
+  curves: Array<{
+    curve: CloudCurveHeader;
+    asOf: string;
+    points: CloudCurvePoint[];
+    previous: { asOf: string; points: CloudCurvePoint[] } | null;
+    checkedAt: string | null;
+  }>;
+}

package/src/app/app-bootstrap-state.ts

@@ -73,7 +73,6 @@ function createDetachedSessionSnapshotFallback(): AppSessionSnapshot {
   return {
     paneState: {},
     focusedPaneId: null,
-    activePanel: "left",
     statusBarVisible: true,
     openPaneIds: [],
     hydrationTargets: [],
@@ -97,7 +96,6 @@ function resolveDetachedAppSessionSnapshot(
       ...baseSessionSnapshot,
       paneState: desktopSnapshot.paneState,
       focusedPaneId: desktopSnapshot.focusedPaneId,
-      activePanel: desktopSnapshot.activePanel,
       statusBarVisible: desktopSnapshot.statusBarVisible,
     }
     : null;

package/src/app/global-shortcuts.ts

@@ -6,9 +6,13 @@ import { useToastHost } from "../ui/toast";
 import type { PluginRegistry } from "../plugins/registry";
 import type { AppAction, AppState } from "../state/app/context";
 import type { TickerRecord } from "../types/ticker";
+import { findPaneInstance } from "../types/config";
 import type { ReleaseInfo } from "../updater";
 import { canSelfUpdate } from "../updater";
 import { getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order";
+import { requestFunctionHelp, useFunctionHelpHost } from "../plugins/builtin/help/function-card";
+import { buildRegistryHelpIndex, helpFunctionForPane } from "../plugins/builtin/help/function-index";
+import { recordFunctionOpen } from "../telemetry/usage-counts";
 import { isMoveDownShortcut, isMoveUpShortcut } from "../components/command-bar/keyboard-handlers";
 import {
   copyActiveSelection,
@@ -106,6 +110,11 @@ export function useAppGlobalShortcuts({
   const uiKind = useUiHost().kind;
   const toastHost = useToastHost();
   useKeybindingIssueNotice(keybindings, pluginRegistry, state.initialized);
+  useFunctionHelpHost({
+    closeCommandBar: () => {
+      if (state.commandBarOpen) dispatch({ type: "SET_COMMAND_BAR", open: false });
+    },
+  });
 
   useShortcut((event) => {
     if (isCopyShortcut(event) && copyActiveSelection(nativeRenderer)) {
@@ -207,6 +216,18 @@ export function useAppGlobalShortcuts({
       return;
     }
 
+    // A function key is never text, so the card opens from a focused field too.
+    if (action === "function-help") {
+      event.preventDefault();
+      event.stopPropagation();
+      recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
+      const instance = state.focusedPaneId ? findPaneInstance(state.config.layout, state.focusedPaneId) : undefined;
+      const fn = instance ? helpFunctionForPane(buildRegistryHelpIndex(pluginRegistry), pluginRegistry, instance) : null;
+      if (fn && requestFunctionHelp({ kind: "function", fn })) return;
+      if (!isDetachedWindow) pluginRegistry.showPane("help");
+      return;
+    }
+
     if (state.inputCaptured) return;
 
     if (!isDetachedWindow && action === "help") {

package/src/app/keybindings/actions.ts

@@ -7,6 +7,7 @@ export type CoreKeybindingActionId =
   | "command-bar"
   | "ticker-search"
   | "help"
+  | "function-help"
   | "switch-layout"
   | "focus-next-pane"
   | "focus-prev-pane"
@@ -31,7 +32,7 @@ export type CoreKeybindingActionId =
   | "window-move-mode"
   | "window-resize-mode";
 
-export type KeybindingActionCategory = "Global Keys" | "Pane Management";
+type KeybindingActionCategory = "Global Keys" | "Pane Management";
 
 export interface KeybindingActionDef {
   id: CoreKeybindingActionId;
@@ -88,6 +89,13 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
     description: "Open help.",
     defaults: ["?"],
   },
+  {
+    id: "function-help",
+    category: "Global Keys",
+    description: "Open the focused pane's help card: what it shows, its keys and how fresh its data is.",
+    // F1 is help on every platform and nothing in the app used it.
+    defaults: ["F1"],
+  },
   {
     id: "switch-layout",
     category: "Global Keys",

package/src/app/keybindings/chord.ts

@@ -113,7 +113,7 @@ const MODIFIER_ONLY_EVENT_NAMES = new Set([
   "", "shift", "ctrl", "control", "alt", "option", "meta", "super", "cmd", "command", "capslock", "fn",
 ]);
 
-export function isNamedKey(key: string): boolean {
+function isNamedKey(key: string): boolean {
   return NAMED_KEY_BY_ALIAS.get(key)?.key === key;
 }
 

package/src/app/keybindings/index.ts

@@ -1,45 +1,32 @@
 export {
-  KEYBINDING_ACTIONS,
   PLUGIN_ACTION_PREFIX,
-  getKeybindingAction,
   isCoreKeybindingActionId,
-  pluginShortcutActionId,
   type CoreKeybindingActionId,
-  type KeybindingActionCategory,
-  type KeybindingActionDef,
 } from "./actions";
 export {
   formatKeyChord,
   isTypingChord,
-  keyChordDigit,
   keyChordFromEvent,
-  keyChordsEqual,
   matchesKeyChord,
   parseKeyChord,
   serializeKeyChord,
   type KeyChord,
   type KeyChordEventLike,
-  type PrimaryModifier,
 } from "./chord";
 export {
   describeKeybindingIssue,
   isPaneKeybindingAction,
   keyChordsOverlap,
-  keybindingActionLabel,
   matchKeybinding,
   matchesKeybindingAction,
-  pluginShortcutDefaultChord,
   resolveKeybindings,
   resolvePluginShortcutChords,
   type KeybindingCommand,
-  type KeybindingIssue,
-  type KeybindingMatch,
   type ResolvedKeybindingAction,
   type ResolvedKeybindings,
 } from "./resolve";
 export {
   advertisedChord,
-  chordsForHost,
   formatActionChords,
   formatAdvertisedChord,
   formatChordForHost,
@@ -58,5 +45,4 @@ export {
   requestKeybindingCapture,
   subscribeKeybindingCapture,
   takeKeybindingCaptureRequest,
-  type KeybindingCaptureRequest,
 } from "./capture-request";

package/src/app/keybindings/labels.ts

@@ -34,7 +34,7 @@ export function formatChordForHost(
  * Chords worth showing on this host. A terminal cannot deliver an explicit
  * Command chord, so those rows stay out of the terminal's help.
  */
-export function chordsForHost(chords: readonly KeyChord[], mode: ShortcutDisplayMode): KeyChord[] {
+function chordsForHost(chords: readonly KeyChord[], mode: ShortcutDisplayMode): KeyChord[] {
   return chords.filter((chord) => mode !== "terminal" || !chord.cmd);
 }
 

package/src/app/keybindings/resolve.ts

@@ -1,7 +1,6 @@
 import type { KeybindingsConfig } from "../../types/config";
 import type { KeyboardShortcut } from "../../types/plugin";
 import {
-  getKeybindingAction,
   isCoreKeybindingActionId,
   KEYBINDING_ACTIONS,
   PANE_ACTION_IDS,
@@ -66,7 +65,7 @@ export interface ResolveKeybindingsOptions {
   host?: "terminal" | "desktop";
 }
 
-export function pluginShortcutDefaultChord(shortcut: KeyboardShortcut): KeyChord {
+function pluginShortcutDefaultChord(shortcut: KeyboardShortcut): KeyChord {
   return {
     key: shortcut.key.toLowerCase(),
     ctrl: shortcut.ctrl === true,
@@ -280,9 +279,3 @@ export function describeKeybindingIssue(issue: KeybindingIssue): string {
       return `${serializeKeyChord(issue.chord)} is bound to ${issue.targets.join(" and ")}.`;
   }
 }
-
-export function keybindingActionLabel(action: ResolvedKeybindingAction): string {
-  return action.def?.description ?? action.pluginShortcut?.description ?? action.id;
-}
-
-export { getKeybindingAction };

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

@@ -7,7 +7,7 @@ import {
   findDockLeaf,
   getDockedPaneIds,
   isPaneInLayout,
-} from "../../plugins/pane-manager";
+} from "../../layout/pane-manager";
 import type { PluginRegistry } from "../../plugins/registry";
 import type { LoadedExternalPlugin } from "../../plugins/loader";
 import {
@@ -35,7 +35,6 @@ import type {
 } from "../../types/plugin";
 import type { DialogApi } from "../../ui/dialog";
 import {
-  resolvePanelForPane,
   resolvePaneShowTarget,
   resolvePaneTarget as resolvePaneTargetInLayout,
   selectEdgeAnchor,
@@ -95,18 +94,12 @@ export function useAppPaneRuntime({
       { ...currentState.config, layout: normalizedLayout },
       currentState.paneState,
       hasFocusTarget ? (options.focusedPaneId ?? null) : currentState.focusedPaneId,
-      currentState.activePanel,
     ));
   }, [dispatch, stateRef]);
 
-  const activatePane = useCallback((paneId: string, layout: LayoutConfig = state.config.layout) => {
-    dispatch({
-      type: "SET_ACTIVE_PANEL",
-      panel: resolvePanelForPane({ layout, paneId, pluginRegistry }),
-      preserveFocus: true,
-    });
+  const activatePane = useCallback((paneId: string) => {
     dispatch({ type: "FOCUS_PANE", paneId });
-  }, [dispatch, pluginRegistry, state.config.layout]);
+  }, [dispatch]);
 
   const {
     buildPaneBinding,
@@ -163,7 +156,7 @@ export function useAppPaneRuntime({
     if (nextLayout !== state.config.layout) {
       persistLayout(nextLayout, { pushHistory: false });
     }
-    activatePane(paneId, nextLayout);
+    activatePane(paneId);
   }, [activatePane, persistLayout, state.config.layout]);
 
   const placePaneInstance = useCallback((
@@ -171,7 +164,7 @@ export function useAppPaneRuntime({
     paneDef: PaneDef,
     options?: PaneTemplateInstanceConfig,
   ) => {
-    const { width, height } = pluginRegistry.getTermSizeFn();
+    const { width, height } = pluginRegistry.getTermSize();
     // Templates can await ticker resolution before placing their pane, so the
     // layout from the render that started the request may be out of date.
     const { config: { layout }, focusedPaneId } = stateRef.current;
@@ -201,7 +194,7 @@ export function useAppPaneRuntime({
     }
 
     persistLayout(nextLayout);
-    activatePane(instance.instanceId, nextLayout);
+    activatePane(instance.instanceId);
   }, [
     activatePane,
     persistLayout,
@@ -221,7 +214,7 @@ export function useAppPaneRuntime({
     }
 
     if (target.instance && isPaneInLayout(state.config.layout, target.instance.instanceId)) {
-      pluginRegistry.focusPaneFn(target.instance.instanceId);
+      pluginRegistry.focusPane(target.instance.instanceId);
       return;
     }
 

package/src/app/pane-runtime/layout-placement.ts

@@ -1,8 +1,6 @@
-import type { PluginRegistry } from "../../plugins/registry";
 import {
   getDockLeafLayouts,
-  getLeafRect,
-} from "../../plugins/pane-manager";
+} from "../../layout/pane-manager";
 import {
   findPaneInstance,
   isTickerPaneId,
@@ -41,33 +39,6 @@ export function resolvePaneShowTarget(
   };
 }
 
-export function resolvePanelForPane({
-  layout,
-  paneId,
-  pluginRegistry,
-}: {
-  layout: LayoutConfig;
-  paneId: string;
-  pluginRegistry: PluginRegistry;
-}): "left" | "right" {
-  const instanceId = resolvePaneTarget(layout, paneId);
-  if (!instanceId) return "right";
-  const instance = findPaneInstance(layout, instanceId);
-  const paneDef = instance ? pluginRegistry.panes.get(instance.paneId) : pluginRegistry.panes.get(paneId);
-  const floating = layout.floating.find((entry) => entry.instanceId === instanceId);
-  if (floating) {
-    return paneDef?.defaultPosition ?? "right";
-  }
-
-  const rect = getLeafRect(layout, instanceId, PANEL_RESOLUTION_BOUNDS);
-  if (!rect) {
-    return paneDef?.defaultPosition ?? "right";
-  }
-
-  const midpoint = PANEL_RESOLUTION_BOUNDS.width / 2;
-  return rect.x + (rect.width / 2) <= midpoint ? "left" : "right";
-}
-
 export function selectEdgeAnchor(layout: LayoutConfig, edge: "left" | "right"): string | null {
   const leaves = getDockLeafLayouts(layout, PANEL_RESOLUTION_BOUNDS);
   if (leaves.length === 0) return null;