gloomberb 0.10.2 → 0.10.3

package/package.json

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

package/src/components/index.ts

@@ -41,7 +41,7 @@ export { Checkbox } from "./ui/checkbox";
 export { ConfirmDialog } from "./ui/confirm-dialog";
 export { ChoiceDialog } from "./ui/choice-dialog";
 export type { ChoiceDialogChoice } from "./ui/choice-dialog";
-export type { DataTableCell, DataTableColumn } from "./ui/data-table";
+export type { DataTableCell, DataTableColumn, DataTableVisibleRange } from "./ui/data-table";
 export { EmptyState } from "./ui/status";
 export { getMessageComposerBlockHeight, MessageComposer } from "./ui/message-composer";
 export { NumberField, TextField } from "./ui/fields";

package/src/components/ui/data-table/index.tsx

@@ -13,6 +13,7 @@ export type {
   DataTableColumn,
   DataTableProps,
   DataTableSectionHeader,
+  DataTableVisibleRange,
 } from "./types";
 
 export function DataTable<T, C extends DataTableColumn = DataTableColumn>(

package/src/components/ui/data-table/opentui/index.tsx

@@ -19,7 +19,9 @@ import {
 import type {
   DataTableColumn,
   DataTableProps,
+  DataTableVisibleRange,
 } from "../types";
+import { resolveDataTableVisibleRange } from "../visible-range";
 import {
   resolveDataTableScrollTop,
   resolveDataTableVisibleWindow,
@@ -47,6 +49,8 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
   onSelect,
   onActivate,
   onTableMouseDown,
+  visibleRangeKey,
+  onVisibleRangeChange,
   onRowMouseDown,
   onRowContextMenu,
   rowContextMenuSurface = false,
@@ -74,6 +78,10 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
   const nativeRenderer = useNativeRenderer();
   const [scrollVersion, setScrollVersion] = useState(0);
   const lastAppliedScrollRequestRef = useRef<string | null>(null);
+  const lastVisibleRangeRef = useRef<{
+    key: string | number | undefined;
+    range: DataTableVisibleRange;
+  } | null>(null);
   const scrollTop = virtualize ? (scrollRef.current?.scrollTop ?? 0) : 0;
   const measuredViewportHeight = scrollRef.current?.viewport?.height;
   const tableWindow = useMemo(
@@ -123,6 +131,25 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
     () => expandTableColumns(columns, contentWidth, columnGap, horizontalPadding),
     [columnGap, columns, contentWidth, horizontalPadding],
   );
+  const emitVisibleRange = useCallback(() => {
+    if (!onVisibleRangeChange) return;
+    const scrollBox = scrollRef.current;
+    const range = resolveDataTableVisibleRange({
+      itemCount: items.length,
+      rowSize: 1,
+      scrollOffset: scrollBox?.scrollTop ?? scrollTop,
+      viewportSize: scrollBox?.viewport?.height ?? viewportHeight,
+    });
+    const previous = lastVisibleRangeRef.current;
+    if (
+      previous !== null
+      && previous.key === visibleRangeKey
+      && previous.range.start === range.start
+      && previous.range.end === range.end
+    ) return;
+    lastVisibleRangeRef.current = { key: visibleRangeKey, range };
+    onVisibleRangeChange(range);
+  }, [items.length, onVisibleRangeChange, scrollRef, scrollTop, viewportHeight, visibleRangeKey]);
   const handleRowMouseDown =
     useDoubleClickActivation<DataTableRowPointerTarget<T>>({
       onSelect: ({ item, index }) => {
@@ -140,13 +167,26 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
       setScrollVersion((current) => current + 1);
     }
     onBodyScrollActivity();
+    emitVisibleRange();
     nativeRenderer.requestRender();
-  }, [nativeRenderer, onBodyScrollActivity, virtualize]);
+  }, [emitVisibleRange, nativeRenderer, onBodyScrollActivity, virtualize]);
   useScrollBoxScrollActivity({
     scrollRef,
     onVerticalScroll: handleBodyScrollActivity,
     onHorizontalScroll: syncHeaderScroll,
   });
+  const handleBodySizeChange = useCallback(() => {
+    measureContentWidth();
+    if (virtualize) {
+      setScrollVersion((current) => current + 1);
+    }
+    queueMicrotask(emitVisibleRange);
+  }, [emitVisibleRange, measureContentWidth, virtualize]);
+
+  useEffect(() => {
+    emitVisibleRange();
+    queueMicrotask(emitVisibleRange);
+  }, [emitVisibleRange]);
   const focusPane = useCallback(() => {
     if (!paneInstanceId) return;
     dispatch({ type: "FOCUS_PANE", paneId: paneInstanceId });
@@ -178,6 +218,7 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
       setScrollVersion((current) => current + 1);
     }
     syncHeaderScroll();
+    queueMicrotask(emitVisibleRange);
     return true;
   }, [
     appViewport.height,
@@ -185,6 +226,7 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
     scrollRef,
     scrollToIndex,
     scrollToIndexAlign,
+    emitVisibleRange,
     syncHeaderScroll,
     virtualize,
   ]);
@@ -324,7 +366,7 @@ export function OpenTuiDataTable<T, C extends DataTableColumn = DataTableColumn>
           focusPane();
           onTableMouseDown?.({});
         }}
-        onSizeChange={measureContentWidth}
+        onSizeChange={handleBodySizeChange}
       >
         {items.length === 0 ? (
           emptyContent ?? (

package/src/components/ui/data-table/types.ts

@@ -33,6 +33,13 @@ export interface DataTableRowState {
   selected: boolean;
 }
 
+export interface DataTableVisibleRange {
+  /** First visible row index. */
+  start: number;
+  /** Exclusive end of the visible row range. */
+  end: number;
+}
+
 export interface DataTableProps<
   T,
   C extends DataTableColumn = DataTableColumn,
@@ -53,6 +60,9 @@ export interface DataTableProps<
   onSelect: (item: T, index: number) => void;
   onActivate?: (item: T, index: number) => void;
   onTableMouseDown?: (event: any) => void;
+  /** Changes when the meaning of row indexes changes without changing table geometry. */
+  visibleRangeKey?: string | number;
+  onVisibleRangeChange?: (range: DataTableVisibleRange) => void;
   onRowMouseDown?: (item: T, index: number, event: any) => boolean | void;
   onRowContextMenu?: (item: T, index: number, event: any) => void;
   rowContextMenuSurface?: boolean;

package/src/components/ui/data-table/visible-range.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, test } from "bun:test";
+import { resolveDataTableVisibleRange } from "./visible-range";
+
+describe("data table visible range", () => {
+  test("includes partially visible desktop rows without counting the sticky header", () => {
+    expect(resolveDataTableVisibleRange({
+      itemCount: 100,
+      rowSize: 20,
+      scrollOffset: 10,
+      viewportSize: 180,
+    })).toEqual({ start: 0, end: 10 });
+
+    expect(resolveDataTableVisibleRange({
+      itemCount: 100,
+      rowSize: 20,
+      scrollOffset: 30,
+      viewportSize: 180,
+    })).toEqual({ start: 1, end: 11 });
+  });
+
+  test("clamps a terminal range to the available rows", () => {
+    expect(resolveDataTableVisibleRange({
+      itemCount: 8,
+      rowSize: 1,
+      scrollOffset: 6,
+      viewportSize: 5,
+    })).toEqual({ start: 6, end: 8 });
+  });
+});

package/src/components/ui/data-table/visible-range.ts

@@ -0,0 +1,21 @@
+import type { DataTableVisibleRange } from "./types";
+
+export function resolveDataTableVisibleRange({
+  itemCount,
+  rowSize,
+  scrollOffset,
+  viewportSize,
+}: {
+  itemCount: number;
+  rowSize: number;
+  scrollOffset: number;
+  viewportSize: number;
+}): DataTableVisibleRange {
+  const count = Math.max(0, Math.floor(itemCount));
+  const size = Number.isFinite(rowSize) && rowSize > 0 ? rowSize : 1;
+  const offset = Number.isFinite(scrollOffset) ? Math.max(0, scrollOffset) : 0;
+  const viewport = Number.isFinite(viewportSize) ? Math.max(0, viewportSize) : 0;
+  const start = Math.min(count, Math.floor(offset / size));
+  const end = Math.min(count, Math.max(start, Math.ceil((offset + viewport) / size)));
+  return { start, end };
+}

package/src/components/ui/ui.test.tsx

@@ -3,7 +3,7 @@ import { act, createRef, useEffect, useRef, useState } from "react";
 import { TestDialogProvider, testRender } from "../../renderers/opentui/test-utils";
 import type { BoxRenderable, ScrollBoxRenderable } from "@opentui/core";
 import { ChoiceDialog } from "./choice-dialog";
-import { DataTable, type DataTableColumn } from "./data-table";
+import { DataTable, type DataTableColumn, type DataTableVisibleRange } from "./data-table";
 import { TextField } from "./fields";
 import { ListView } from "./list-view";
 import { MultiSelectDialogButton, type MultiSelectDialogButtonHandle } from "./multi-select/dialog";
@@ -26,6 +26,8 @@ let setListSelection: ((index: number) => void) | null = null;
 let selectedTableRow: string | null = null;
 let activatedTableRow: string | null = null;
 let tableScrollBoxForTest: ScrollBoxRenderable | null = null;
+let tableVisibleRanges: DataTableVisibleRange[] = [];
+let setTableVisibleRangeKey: ((key: string) => void) | null = null;
 let closedTab: string | null = null;
 let addedTab = false;
 let resolvedChoice: string | null = null;
@@ -176,6 +178,7 @@ function DataTableHorizontalScrollHarness({
 function DataTableVirtualizationHarness() {
   const headerScrollRef = useRef<ScrollBoxRenderable>(null);
   const scrollRef = useRef<ScrollBoxRenderable>(null);
+  const [visibleRangeKey, setVisibleRangeKey] = useState("first");
   const rows = Array.from({ length: 100 }, (_, index) => ({
     id: `row-${index}`,
     name: `Row ${index}`,
@@ -183,6 +186,7 @@ function DataTableVirtualizationHarness() {
 
   useEffect(() => {
     tableScrollBoxForTest = scrollRef.current;
+    setTableVisibleRangeKey = setVisibleRangeKey;
     return () => {
       if (tableScrollBoxForTest === scrollRef.current) {
         tableScrollBoxForTest = null;
@@ -201,6 +205,8 @@ function DataTableVirtualizationHarness() {
       scrollRef={scrollRef}
       syncHeaderScroll={() => {}}
       onBodyScrollActivity={() => {}}
+      visibleRangeKey={visibleRangeKey}
+      onVisibleRangeChange={(range) => tableVisibleRanges.push(range)}
       getItemKey={(row) => row.id}
       isSelected={() => false}
       onSelect={() => {}}
@@ -287,6 +293,8 @@ afterEach(async () => {
   selectedTableRow = null;
   activatedTableRow = null;
   tableScrollBoxForTest = null;
+  tableVisibleRanges = [];
+  setTableVisibleRangeKey = null;
   closedTab = null;
   addedTab = false;
   resolvedChoice = null;
@@ -906,6 +914,16 @@ describe("shared UI kit", () => {
     expect(frame).toContain("Row 0");
     expect(frame).not.toContain("Row 99");
     expect(tableScrollBoxForTest?.scrollTop).toBe(0);
+    expect(tableVisibleRanges.at(-1)).toEqual({ start: 0, end: 5 });
+
+    const initialRangeCount = tableVisibleRanges.length;
+    await act(async () => {
+      setTableVisibleRangeKey!("second");
+      await Promise.resolve();
+      await testSetup!.renderOnce();
+    });
+    expect(tableVisibleRanges.length).toBeGreaterThan(initialRangeCount);
+    expect(tableVisibleRanges.at(-1)).toEqual({ start: 0, end: 5 });
 
     await act(async () => {
       for (let index = 0; index < 12; index++) {
@@ -919,6 +937,10 @@ describe("shared UI kit", () => {
 
     const scrollTop = tableScrollBoxForTest?.scrollTop ?? 0;
     expect(scrollTop).toBeGreaterThan(0);
+    expect(tableVisibleRanges.at(-1)).toEqual({
+      start: scrollTop,
+      end: Math.min(100, scrollTop + 5),
+    });
 
     const scrolledFrame = testSetup.captureCharFrame();
     expect(scrolledFrame).toContain(`Row ${scrollTop}`);

package/src/i18n/ja.ts

@@ -645,6 +645,8 @@ export const ja: Record<string, string> = {
   "{count}-minute delayed options, upgrade for real-time":
     "オプションは {count} 分遅延、リアルタイムにはアップグレード",
   "real-time options": "リアルタイムオプション",
+  "mixed real-time and delayed options": "リアルタイムと遅延の混在オプション",
+  "connecting real-time options": "リアルタイムオプションに接続中",
   "options delayed fallback": "オプション遅延フォールバック",
   "News": "ニュース",
   "12h delay": "12 時間遅延",

package/src/i18n/ko.ts

@@ -643,6 +643,8 @@ export const ko: Record<string, string> = {
   "{count}-minute delayed options, upgrade for real-time":
     "옵션 데이터 {count}분 지연, 실시간으로 업그레이드",
   "real-time options": "실시간 옵션",
+  "mixed real-time and delayed options": "실시간 및 지연 옵션 혼합",
+  "connecting real-time options": "실시간 옵션 연결 중",
   "options delayed fallback": "옵션 지연 대체 데이터",
   "News": "뉴스",
   "12h delay": "12시간 지연",

package/src/i18n/zh-cn.ts

@@ -645,6 +645,8 @@ export const zhCN: Record<string, string> = {
   "{count}-minute delayed options, upgrade for real-time":
     "期权行情延迟 {count} 分钟，升级以获取实时数据",
   "real-time options": "实时期权",
+  "mixed real-time and delayed options": "实时与延迟期权混合",
+  "connecting real-time options": "正在连接实时期权",
   "options delayed fallback": "期权延迟备用数据",
   "News": "新闻",
   "12h delay": "延迟 12 小时",

package/src/i18n/zh-tw.ts

@@ -645,6 +645,8 @@ export const zhTW: Record<string, string> = {
   "{count}-minute delayed options, upgrade for real-time":
     "選擇權行情延遲 {count} 分鐘，升級以取得即時資料",
   "real-time options": "即時選擇權",
+  "mixed real-time and delayed options": "即時與延遲選擇權混合",
+  "connecting real-time options": "正在連線即時選擇權",
   "options delayed fallback": "選擇權延遲備援資料",
   "News": "新聞",
   "12h delay": "延遲 12 小時",

package/src/market-data/coordinator/index.ts

@@ -369,10 +369,10 @@ export class MarketDataCoordinator {
     const key = buildQuoteKey(instrument);
     const current = this.quoteStore.get(key);
     const resolvedQuote = quote.stale === true ? quote : this.resolveIncomingQuote(instrument, quote);
-    if (areStreamQuotesEquivalent(current.data ?? current.lastGoodData, resolvedQuote)) return;
     const startedAt = Date.now();
     const receivedAt = resolvedQuote.stale === true ? resolvedQuote.receivedAt : startedAt;
     const storedQuote = receivedAt == null ? resolvedQuote : { ...resolvedQuote, receivedAt };
+    if (areStreamQuotesEquivalent(current.data ?? current.lastGoodData, storedQuote)) return;
     const attempts = [createAttempt(resolvedQuote.providerId ?? this.dataProvider.id, startedAt, "success")];
     this.quoteStore.set(key, readyQuoteEntry(current, storedQuote, resolvedQuote.providerId ?? this.dataProvider.id, attempts));
   }

package/src/market-data/coordinator/quotes.ts

@@ -291,5 +291,6 @@ export function areStreamQuotesEquivalent(current: Quote | null | undefined, nex
     if (current[field] !== next[field]) return false;
   }
   return current.lastUpdated === next.lastUpdated
+    && current.receivedAt === next.receivedAt
     && JSON.stringify(current.provenance ?? null) === JSON.stringify(next.provenance ?? null);
 }

package/src/market-data/coordinator/subscriptions.test.ts

@@ -245,6 +245,45 @@ describe("MarketDataCoordinator key subscriptions", () => {
     }
   });
 
+  test("advances receipt freshness for an identical live stream heartbeat", async () => {
+    const realDateNow = Date.now;
+    const { provider, emitQuote } = createProvider();
+    const coordinator = new MarketDataCoordinator(provider);
+    const option = { symbol: "AAPL260731C00110000", exchange: "OPTIONS" };
+    const firstTimestamp = 1_800_000_000_000;
+    let calls = 0;
+
+    try {
+      coordinator.subscribeKeys([buildQuoteKey(option)], () => { calls += 1; });
+      coordinator.subscribeQuotes([{ instrument: option }]);
+
+      Date.now = () => firstTimestamp;
+      const heartbeat = quote(option.symbol, 2.5, {
+        lastUpdated: firstTimestamp,
+        bid: 2.4,
+        ask: 2.6,
+        mark: 2.5,
+        dataSource: "live",
+        delivery: "stream",
+        stale: false,
+      });
+      emitQuote(option, heartbeat);
+      await flushCoordinator();
+
+      Date.now = () => firstTimestamp + 60_000;
+      emitQuote(option, heartbeat);
+      await flushCoordinator();
+
+      expect(calls).toBe(2);
+      expect(coordinator.getQuoteEntry(option).data).toMatchObject({
+        lastUpdated: firstTimestamp,
+        receivedAt: firstTimestamp + 60_000,
+      });
+    } finally {
+      Date.now = realDateNow;
+    }
+  });
+
   test("does not refresh receipt time from an explicitly stale polled quote", async () => {
     const realDateNow = Date.now;
     const { provider, emitQuote } = createProvider();

package/src/plugins/builtin/options/footer.test.ts

@@ -21,7 +21,7 @@ describe("options access footer", () => {
         realtimeEligible: false,
       }),
       clientPlan: "free",
-      hasLiveQuote: false,
+      quoteCoverage: { status: "delayed" },
     });
     let upgrades = 0;
     const segment = buildOptionsAccessFooterSegment(state, () => {
@@ -37,7 +37,7 @@ describe("options access footer", () => {
     expect(upgrades).toBe(1);
   });
 
-  test("claims real-time only for a Pro user with a fresh live stream", () => {
+  test("reports complete, mixed, connecting, and delayed Pro coverage", () => {
     expect(
       resolveOptionsAccessFooterState({
         chain: chain({
@@ -46,7 +46,7 @@ describe("options access footer", () => {
           realtimeEligible: true,
         }),
         clientPlan: "pro",
-        hasLiveQuote: false,
+        quoteCoverage: { status: "delayed" },
       }),
     ).toMatchObject({
       canUpgrade: false,
@@ -62,21 +62,33 @@ describe("options access footer", () => {
           realtimeEligible: true,
         }),
         clientPlan: "pro",
-        hasLiveQuote: false,
+        quoteCoverage: { status: "connecting" },
       }),
     ).toMatchObject({
       canUpgrade: false,
-      text: "options delayed fallback",
-      tone: "warning",
+      text: "connecting real-time options",
+      tone: "muted",
     });
 
     expect(
       resolveOptionsAccessFooterState({
         chain: chain({ realtimeEligible: false }),
         clientPlan: "pro",
-        hasLiveQuote: true,
+        quoteCoverage: { status: "live" },
       }).text,
     ).toBe("real-time options");
+
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({ realtimeEligible: true }),
+        clientPlan: "pro",
+        quoteCoverage: { status: "mixed" },
+      }),
+    ).toMatchObject({
+      canUpgrade: false,
+      text: "mixed real-time and delayed options",
+      tone: "warning",
+    });
   });
 
   test("makes the current plan authoritative over cached chain metadata", () => {
@@ -88,7 +100,7 @@ describe("options access footer", () => {
           realtimeEligible: true,
         }),
         clientPlan: "free",
-        hasLiveQuote: true,
+        quoteCoverage: { status: "live" },
       }),
     ).toMatchObject({
       canUpgrade: true,
@@ -104,7 +116,7 @@ describe("options access footer", () => {
           realtimeEligible: false,
         }),
         clientPlan: "pro",
-        hasLiveQuote: true,
+        quoteCoverage: { status: "live" },
       }),
     ).toMatchObject({
       canUpgrade: false,

package/src/plugins/builtin/options/footer.ts

@@ -7,21 +7,22 @@ import type { OptionsChain } from "../../../types/financials";
 import { useRendererHost } from "../../../ui";
 import { CLOUD_UPGRADE_URL } from "../shared/cloud-upgrade";
 import { usePaneStatusFooter } from "../shared/pane-footer";
+import type { OptionQuoteCoverage } from "./live-quotes";
 
 export interface OptionsAccessFooterState {
   canUpgrade: boolean;
   text: string;
-  tone: "positive" | "warning";
+  tone: "muted" | "positive" | "warning";
 }
 
 export function resolveOptionsAccessFooterState({
   chain,
   clientPlan,
-  hasLiveQuote,
+  quoteCoverage,
 }: {
   chain: OptionsChain | null | undefined;
   clientPlan: "free" | "pro" | null;
-  hasLiveQuote: boolean;
+  quoteCoverage: Pick<OptionQuoteCoverage, "status">;
 }): OptionsAccessFooterState {
   if (clientPlan !== "pro") {
     const delayMinutes = chain?.delayMinutes && chain.delayMinutes > 0 ? chain.delayMinutes : 15;
@@ -34,13 +35,27 @@ export function resolveOptionsAccessFooterState({
     };
   }
 
-  if (hasLiveQuote) {
+  if (quoteCoverage.status === "live") {
     return {
       canUpgrade: false,
       text: t("real-time options"),
       tone: "positive",
     };
   }
+  if (quoteCoverage.status === "mixed") {
+    return {
+      canUpgrade: false,
+      text: t("mixed real-time and delayed options"),
+      tone: "warning",
+    };
+  }
+  if (quoteCoverage.status === "connecting") {
+    return {
+      canUpgrade: false,
+      text: t("connecting real-time options"),
+      tone: "muted",
+    };
+  }
 
   return {
     canUpgrade: false,
@@ -64,14 +79,14 @@ export function useOptionsAccessFooter({
   chain,
   error,
   focused,
-  hasLiveQuote,
   loading,
+  quoteCoverage,
 }: {
   chain: OptionsChain | null | undefined;
   error?: string | null;
   focused: boolean;
-  hasLiveQuote: boolean;
   loading?: boolean;
+  quoteCoverage: Pick<OptionQuoteCoverage, "status">;
 }): OptionsAccessFooterState {
   const rendererHost = useRendererHost();
   const user = apiClient.getCurrentUser();
@@ -79,7 +94,7 @@ export function useOptionsAccessFooter({
   const state = resolveOptionsAccessFooterState({
     chain,
     clientPlan,
-    hasLiveQuote,
+    quoteCoverage,
   });
   const openUpgrade = useCallback(() => {
     void rendererHost.openExternal(CLOUD_UPGRADE_URL);