gloomberb 0.10.0 → 0.10.2

package/src/time-series/use-chart-resolution.ts

@@ -20,6 +20,7 @@ export interface UseChartResolutionResult extends ChartResolutionResult {
 export interface UseChartResolutionOptions {
   liveRefreshIntervalMs?: number;
   autoViewport?: ChartResolveOptions["autoViewport"];
+  requestViewport?: ChartResolveOptions["requestViewport"];
   targetPointCount?: number;
 }
 
@@ -30,6 +31,10 @@ const EMPTY_RESULT: ChartResolutionResult = {
   warnings: [],
 };
 
+function hasRenderableData(result: ChartResolutionResult): boolean {
+  return (result.bufferedSeries ?? result.series).some((series) => series.points.length > 0);
+}
+
 function withQuoteOverrides(
   sources: ChartResolveSources,
   liveOverrides: ReadonlyMap<string, Quote>,
@@ -49,6 +54,8 @@ export function useChartResolution(
   options: UseChartResolutionOptions = {},
 ): UseChartResolutionResult {
   const [result, setResult] = useState<ChartResolutionResult>(EMPTY_RESULT);
+  const resultRef = useRef(result);
+  resultRef.current = result;
   const [revision, setRevision] = useState(0);
   const generationRef = useRef(0);
   const liveSubscriptionGenerationRef = useRef(0);
@@ -68,9 +75,19 @@ export function useChartResolution(
       && autoViewportStart <= autoViewportEnd
     ? { start: new Date(autoViewportStart), end: new Date(autoViewportEnd) }
     : null;
+  const requestViewportStart = options.requestViewport?.start.getTime();
+  const requestViewportEnd = options.requestViewport?.end.getTime();
+  const validRequestViewport = typeof requestViewportStart === "number"
+      && Number.isFinite(requestViewportStart)
+      && typeof requestViewportEnd === "number"
+      && Number.isFinite(requestViewportEnd)
+      && requestViewportStart <= requestViewportEnd
+    ? { start: new Date(requestViewportStart), end: new Date(requestViewportEnd) }
+    : null;
   const adaptiveTargetPointCount = validAutoViewport ? options.targetPointCount : undefined;
   const resolveOptions: ChartResolveOptions = {
     autoViewport: validAutoViewport,
+    requestViewport: validRequestViewport,
     targetPointCount: adaptiveTargetPointCount,
   };
   const latestRequestRef = useRef({ spec, sources, options: resolveOptions });
@@ -89,7 +106,13 @@ export function useChartResolution(
       cacheIdentityRef.current = { spec, sources, revision };
     }
     const cache = resolveCacheRef.current;
-    setResult((current) => ({ ...current, loading: true, errors: [] }));
+    const current = resultRef.current;
+    const backgroundRefresh = !resetCache
+      && !current.loading
+      && hasRenderableData(current);
+    if (!backgroundRefresh) {
+      setResult((currentResult) => ({ ...currentResult, loading: true, errors: [] }));
+    }
     resolveChartSpecData(
       spec,
       withQuoteOverrides(sources, liveQuoteOverridesRef.current),
@@ -97,10 +120,13 @@ export function useChartResolution(
       resolveOptions,
     )
       .then((next) => {
-        if (generationRef.current === generation) setResult(next);
+        if (generationRef.current !== generation) return;
+        if (backgroundRefresh && !hasRenderableData(next)) return;
+        setResult(next);
       })
       .catch((error) => {
         if (generationRef.current !== generation) return;
+        if (backgroundRefresh) return;
         setResult({
           series: [],
           loading: false,
@@ -111,7 +137,16 @@ export function useChartResolution(
     return () => {
       if (generationRef.current === generation) generationRef.current += 1;
     };
-  }, [adaptiveTargetPointCount, autoViewportEnd, autoViewportStart, revision, sources, spec]);
+  }, [
+    adaptiveTargetPointCount,
+    autoViewportEnd,
+    autoViewportStart,
+    requestViewportEnd,
+    requestViewportStart,
+    revision,
+    sources,
+    spec,
+  ]);
 
   const liveTargetSignature = liveChartQuoteTargetSignature(spec);
   const liveRefreshIntervalMs = options.liveRefreshIntervalMs ?? LIVE_CHART_REFRESH_INTERVAL_MS;
@@ -138,7 +173,14 @@ export function useChartResolution(
             liveSubscriptionGenerationRef.current === subscriptionGeneration
             && generationRef.current === generation
           ) {
-            setResult(next);
+            setResult((current) => (
+              (request.options.autoViewport || request.options.requestViewport)
+              && !current.loading
+              && hasRenderableData(current)
+              && !hasRenderableData(next)
+                ? current
+                : next
+            ));
           }
         } catch (error) {
           if (

package/src/types/broker.ts

@@ -1,6 +1,6 @@
 import type { Quote, TickerFinancials, PricePoint, OptionsChain } from "./financials";
-import type { TimeRange } from "../components/chart/core/types";
-import type { ChartResolutionSupport, ManualChartResolution } from "../components/chart/core/resolution";
+import type { TimeRange } from "../time-series/range";
+import type { ChartResolutionSupport, ManualChartResolution } from "../time-series/resolution";
 import type { BrokerInstanceConfig } from "./config";
 import type { QuoteSubscriptionTarget } from "./data-provider";
 import type { BrokerContractRef, InstrumentSearchResult } from "./instrument";

package/src/types/data-provider.ts

@@ -7,8 +7,8 @@ import type {
   OptionsChain,
   HolderData,
 } from "./financials";
-import type { TimeRange } from "../components/chart/core/types";
-import type { ChartResolutionSupport, ManualChartResolution } from "../components/chart/core/resolution";
+import type { TimeRange } from "../time-series/range";
+import type { ChartResolutionSupport, ManualChartResolution } from "../time-series/resolution";
 import type { BrokerContractRef, InstrumentSearchResult } from "./instrument";
 import type { CachePolicyMap } from "./persistence";
 
@@ -100,7 +100,7 @@ export interface QuoteSubscriptionTarget {
   exchange?: string;
   context?: MarketDataRequestContext;
   route?: "auto" | "provider" | "broker";
-  surface?: "portfolio" | "watchlist" | "detail" | "monitor" | "inline" | "screener" | "unknown";
+  surface?: "portfolio" | "watchlist" | "detail" | "monitor" | "inline" | "options" | "screener" | "unknown";
   visible?: boolean;
   selected?: boolean;
   weight?: number;

package/src/types/financials.ts

@@ -2,6 +2,7 @@
 export type MarketState = "PRE" | "REGULAR" | "POST" | "PREPRE" | "POSTPOST" | "CLOSED";
 export type SessionConfidence = "explicit" | "derived" | "unknown";
 export type QuoteDataSource = "live" | "delayed" | "snapshot";
+export type QuoteDelivery = "stream" | "poll";
 
 export interface QuoteFieldProvenance {
   providerId: string;
@@ -33,6 +34,8 @@ export interface Quote {
   name?: string;
   lastUpdated: number; // timestamp ms
   receivedAt?: number; // local receipt timestamp ms for streamed/display freshness
+  delivery?: QuoteDelivery;
+  stale?: boolean;
   exchangeName?: string;
   fullExchangeName?: string;
   listingExchangeName?: string;
@@ -395,6 +398,8 @@ export interface OptionContract {
   inTheMoney: boolean;
   expiration: number;
   lastTradeDate: number;
+  /** Millisecond timestamp for the latest streamed quote applied to this snapshot. */
+  lastUpdated?: number;
 }
 
 export interface OptionsChain {
@@ -402,4 +407,11 @@ export interface OptionsChain {
   expirationDates: number[];
   calls: OptionContract[];
   puts: OptionContract[];
+  providerId?: string;
+  dataSource?: "live" | "delayed";
+  feed?: "opra" | "yahoo";
+  delayMinutes?: number;
+  realtimeEligible?: boolean;
+  /** ISO timestamp for the upstream options snapshot. */
+  asOf?: string;
 }

package/src/types/plugin.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-import type { TickerRepository } from "../data/ticker-repository";
+import type { AppTickerRepositoryPort } from "../core/app-service-ports";
 import type { PluginEvents } from "../plugins/event-bus";
 import type { PluginLogger } from "../utils/debug-log";
 import type { BrokerAdapter } from "./broker";
@@ -512,7 +512,7 @@ export interface GloomPluginContext {
   getPaneDef(paneId: string): PaneDef | undefined;
 
   readonly marketData: DataProvider;
-  readonly tickerRepository: TickerRepository;
+  readonly tickerRepository: AppTickerRepositoryPort;
   readonly persistence: PluginPersistence;
   readonly log: PluginLogger;
   readonly resume: PluginResumeState;

package/src/ui/context-menu.tsx

@@ -8,6 +8,7 @@ import {
   contextMenuDivider,
   hasRunnableContextMenuItem,
   type ContextMenuContext,
+  type ContextMenuDividerItem,
   type ContextMenuItem,
 } from "../types/context-menu";
 import { useRendererHost, useUiCapabilities } from "./host";
@@ -44,19 +45,19 @@ const MENU_SURFACE_SELECTOR = [
   "[data-gloom-role='tab-button']",
 ].join(", ");
 
-function isDivider(item: ContextMenuItem): boolean {
+function isDivider(item: ContextMenuItem): item is ContextMenuDividerItem {
   return item.type === "divider";
 }
 
 export function compactContextMenuItems(items: ContextMenuItem[]): ContextMenuItem[] {
   const result: ContextMenuItem[] = [];
   for (const item of items) {
-    if (item.hidden === true) continue;
     if (isDivider(item)) {
       if (result.length === 0 || isDivider(result[result.length - 1]!)) continue;
       result.push(item);
       continue;
     }
+    if (item.hidden === true) continue;
     const nextItem = item.type === "normal" || item.type == null
       ? {
         ...item,

package/src/ui/dialog.tsx

@@ -11,8 +11,8 @@ export interface PromptContext<T> extends AlertContext {
 }
 
 export interface DialogApi {
-  alert<T = void>(options: Record<string, unknown>): Promise<T>;
-  prompt<T = string>(options: Record<string, unknown>): Promise<T>;
+  alert(options: Record<string, unknown>): Promise<void>;
+  prompt<T = string>(options: Record<string, unknown>): Promise<T | undefined>;
 }
 
 interface DialogContextValue {

package/src/utils/html-entities.ts

@@ -1,4 +1,4 @@
-const NAMED_ENTITIES: Record<string, string> = {
+const NAMED_ENTITIES: Readonly<Record<string, string>> = {
   amp: "&",
   apos: "'",
   gt: ">",
@@ -18,13 +18,11 @@ export function decodeHtmlEntities(value: string): string {
     const normalized = entity.toLowerCase();
 
     if (normalized.startsWith("#x")) {
-      const codePoint = Number.parseInt(normalized.slice(2), 16);
-      return decodeCodePoint(codePoint, match);
+      return decodeCodePoint(Number.parseInt(normalized.slice(2), 16), match);
     }
 
     if (normalized.startsWith("#")) {
-      const codePoint = Number.parseInt(normalized.slice(1), 10);
-      return decodeCodePoint(codePoint, match);
+      return decodeCodePoint(Number.parseInt(normalized.slice(1), 10), match);
     }
 
     return NAMED_ENTITIES[normalized] ?? match;

package/src/utils/main-thread-monitor.ts

@@ -84,7 +84,7 @@ export function startMainThreadMonitor(
   }, SAMPLE_INTERVAL_MS);
 
   const ObserverCtor = (globalThis as { PerformanceObserver?: unknown }).PerformanceObserver;
-  let observer: { disconnect?: () => void } | null = null;
+  let observer: { observe: (options: { entryTypes: string[] }) => void; disconnect?: () => void } | null = null;
   if (typeof ObserverCtor === "function") {
     try {
       observer = new (ObserverCtor as new (callback: (list: { getEntries: () => unknown[] }) => void) => {

package/src/utils/price-history.ts

@@ -8,7 +8,7 @@ interface PriceHistoryFreshnessOptions {
   exchange?: string;
 }
 
-function getPointTimestamp(point: PricePoint): number {
+export function getPricePointTimestamp(point: PricePoint): number {
   const value = point.date as Date | string | number | null | undefined;
   if (value instanceof Date) return value.getTime();
   if (value == null) return Number.NaN;
@@ -20,8 +20,8 @@ function hasValidClose(point: PricePoint): boolean {
 }
 
 function comparePricePointsByDate(left: PricePoint, right: PricePoint): number {
-  const leftTime = getPointTimestamp(left);
-  const rightTime = getPointTimestamp(right);
+  const leftTime = getPricePointTimestamp(left);
+  const rightTime = getPricePointTimestamp(right);
   const leftValid = Number.isFinite(leftTime);
   const rightValid = Number.isFinite(rightTime);
 
@@ -41,7 +41,7 @@ export function normalizePriceHistory(points: PricePoint[]): PricePoint[] {
   let requiresSort = false;
 
   for (const point of points) {
-    const time = getPointTimestamp(point);
+    const time = getPricePointTimestamp(point);
     if (!Number.isFinite(time)) continue;
     if (!hasValidClose(point)) continue;
 
@@ -77,7 +77,7 @@ export function isPriceHistoryStaleForCurrentWindow(
   const latest = normalized.at(-1);
   if (!latest) return false;
 
-  const latestTime = getPointTimestamp(latest);
+  const latestTime = getPricePointTimestamp(latest);
   if (!Number.isFinite(latestTime) || now - latestTime <= MAX_CURRENT_INTRADAY_HISTORY_LAG_MS) {
     return false;
   }

package/src/version.ts

@@ -1 +1,3 @@
-export const VERSION = "0.10.0";
+import packageJson from "../package.json" with { type: "json" };
+
+export const VERSION = packageJson.version;

package/src/components/chart/core/viewport.test.ts

@@ -1,8 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { getVisiblePointCount } from "./viewport";
-
-describe("chart viewport", () => {
-  test("allows zooming down to a two-point viewport", () => {
-    expect(getVisiblePointCount(433, 1000)).toBe(2);
-  });
-});

package/src/components/chart/core/viewport.ts

@@ -1,24 +0,0 @@
-
-const MIN_VISIBLE_POINTS = 2;
-export const CHART_ZOOM_STEP_FACTOR = 1.2;
-export const RIGHT_EDGE_ANCHOR_RATIO = 1;
-
-function clamp(value: number, min: number, max: number): number {
-  return Math.max(min, Math.min(max, value));
-}
-
-function getMaxChartZoom(totalPoints: number): number {
-  if (totalPoints <= 0) return 1;
-  return Math.max(1, totalPoints / MIN_VISIBLE_POINTS);
-}
-
-export function clampChartZoom(totalPoints: number, zoomLevel: number): number {
-  return clamp(zoomLevel, 1, getMaxChartZoom(totalPoints));
-}
-
-export function getVisiblePointCount(totalPoints: number, zoomLevel: number): number {
-  if (totalPoints <= 0) return 0;
-
-  const clampedZoom = clampChartZoom(totalPoints, zoomLevel);
-  return Math.min(totalPoints, Math.max(Math.floor(totalPoints / clampedZoom), MIN_VISIBLE_POINTS));
-}

package/src/time-series/index.ts

@@ -1,14 +0,0 @@
-export * from "./alignment";
-export * from "./economic";
-export * from "./field-catalog";
-export * from "./fundamentals";
-export * from "./hooks";
-export * from "./live-quotes";
-export * from "./market";
-export * from "./reporting";
-export * from "./resolve";
-export * from "./spec";
-export * from "./studies";
-export * from "./transforms";
-export * from "./types";
-export * from "./use-chart-resolution";