gloomberb 0.16.2 → 0.16.3

package/src/components/layout/shell/terminal-pointer-runtime.ts

@@ -87,8 +87,8 @@ export function useShellTerminalPointerRuntime({
   windowMode,
 }: UseShellTerminalPointerRuntimeOptions) {
   const {
-    dragFloatingRect,
-    dragRef,
+    live,
+    startDrag,
     updateDividerPreview,
     updateDragFloatingRect,
   } = dragRuntime;
@@ -112,7 +112,7 @@ export function useShellTerminalPointerRuntime({
 
       for (const { pane, rect: visibleRect } of sortedFloatingPanes(visibleFloatingPanes)) {
         const paneId = pane.instance.instanceId;
-        const rect = getVisibleFloatingRect(visibleRect, paneId, dragFloatingRect, width, contentHeight);
+        const rect = getVisibleFloatingRect(visibleRect, paneId, live.get().floating, width, contentHeight);
         if (!pointInRect({ x: rect.x, y: rect.y, width: rect.width, height: rect.height }, event.x, shellY)) continue;
 
         const relativeX = event.x - rect.x;
@@ -120,13 +120,13 @@ export function useShellTerminalPointerRuntime({
         selectWindowModePane(paneId);
 
         if (relativeX >= rect.width - 2 && relativeY >= rect.height - 1) {
-          dragRef.current = {
+          startDrag({
             type: "float-resize",
             paneId,
             startX: preciseX,
             startY: preciseShellY,
             origRect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height },
-          };
+          });
           updateDragFloatingRect({ paneId, rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height } });
         }
 
@@ -138,7 +138,7 @@ export function useShellTerminalPointerRuntime({
       if (!transientFocusActive) {
         for (const divider of dockDividerLayouts) {
           if (!pointInRect(divider.rect, event.x, shellY)) continue;
-          dragRef.current = {
+          startDrag({
             type: "divider",
             path: divider.path,
             axis: divider.axis,
@@ -146,7 +146,7 @@ export function useShellTerminalPointerRuntime({
             startY: preciseShellY,
             startRatio: divider.ratio,
             bounds: divider.bounds,
-          };
+          });
           updateDividerPreview({
             pathKey: divider.path.join("."),
             rect: divider.rect,
@@ -179,7 +179,7 @@ export function useShellTerminalPointerRuntime({
 
       for (const { pane, rect: visibleRect } of sortedFloatingPanes(visibleFloatingPanes)) {
         const paneId = pane.instance.instanceId;
-        const rect = getVisibleFloatingRect(visibleRect, paneId, dragFloatingRect, width, contentHeight);
+        const rect = getVisibleFloatingRect(visibleRect, paneId, live.get().floating, width, contentHeight);
         if (!pointInRect({ x: rect.x, y: rect.y, width: rect.width, height: rect.height }, event.x, shellY)) continue;
         const relativeX = event.x - rect.x;
         const relativeY = shellY - rect.y;
@@ -212,13 +212,13 @@ export function useShellTerminalPointerRuntime({
           return;
         }
         if (!transientFocusActive && relativeX >= rect.width - 2 && relativeY >= rect.height - 1) {
-          dragRef.current = {
+          startDrag({
             type: "float-resize",
             paneId,
             startX: preciseX,
             startY: preciseShellY,
             origRect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height },
-          };
+          });
           updateDragFloatingRect({ paneId, rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height } });
           event.stopPropagation();
           event.preventDefault();
@@ -230,14 +230,14 @@ export function useShellTerminalPointerRuntime({
           return;
         }
         if (relativeY === 0) {
-          dragRef.current = {
+          startDrag({
             type: "pane-drag",
             paneId,
             mode: "floating",
             startX: preciseX,
             startY: preciseShellY,
             origRect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height },
-          };
+          });
           updateDragFloatingRect({ paneId, rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height } });
           event.stopPropagation();
           event.preventDefault();
@@ -248,7 +248,7 @@ export function useShellTerminalPointerRuntime({
 
       for (const divider of dockDividerLayouts) {
         if (!pointInRect(divider.rect, event.x, shellY)) continue;
-        dragRef.current = {
+        startDrag({
           type: "divider",
           path: divider.path,
           axis: divider.axis,
@@ -256,7 +256,7 @@ export function useShellTerminalPointerRuntime({
           startY: preciseShellY,
           startRatio: divider.ratio,
           bounds: divider.bounds,
-        };
+        });
         updateDividerPreview({
           pathKey: divider.path.join("."),
           rect: divider.rect,
@@ -308,14 +308,14 @@ export function useShellTerminalPointerRuntime({
           return;
         }
         if (relativeY === 0) {
-          dragRef.current = {
+          startDrag({
             type: "pane-drag",
             paneId: leaf.instanceId,
             mode: "docked",
             startX: preciseX,
             startY: preciseShellY,
             origRect: { x: leaf.rect.x, y: leaf.rect.y, width: leaf.rect.width, height: leaf.rect.height },
-          };
+          });
           event.stopPropagation();
           event.preventDefault();
           return;
@@ -333,12 +333,11 @@ export function useShellTerminalPointerRuntime({
     contentHeight,
     dockDividerLayouts,
     dockLeafLayouts,
-    dragFloatingRect,
-    dragRef,
     focusPane,
     focusedPaneId,
     handleActiveDrag,
     handleFloatingClose,
+    live,
     restoreFullscreen,
     menuState,
     openPaneMenu,
@@ -346,6 +345,7 @@ export function useShellTerminalPointerRuntime({
     selectWindowModePane,
     setHoveredMenuItemId,
     setMenuState,
+    startDrag,
     transientFocusActive,
     updateDividerPreview,
     updateDragFloatingRect,

package/src/components/layout/shell/window-mode/overlays.tsx

@@ -1,3 +1,4 @@
+import { useCallback } from "react";
 import { Box, Text } from "../../../../ui";
 import type {
   DockGeometryOptions,
@@ -8,6 +9,7 @@ import type {
 } from "../../../../layout/pane-manager";
 import { colors } from "../../../../theme/colors";
 import { constrainFloatingRectToBounds } from "../drag";
+import { useLiveDrag, type LiveDragGeometry, type LiveDragStore } from "../drag/live";
 import {
   getFloatingResizeCornerPosition,
   type WindowEditDockMovePreview,
@@ -27,9 +29,9 @@ interface ShellWindowModeOverlaysProps {
   contentHeight: number;
   dockGeometryOptions: DockGeometryOptions;
   dockLeafLayouts: DockLeafLayout[];
-  dragFloatingRect: { paneId: string; rect: FloatingRect } | null;
   focusedPaneId: string | null;
   getPaneTitle: (pane: ResolvedPane) => string;
+  live: LiveDragStore;
   menuOpen: boolean;
   nativePaneChrome: boolean;
   nativeWindowModePanelRect: LayoutBounds | null;
@@ -64,9 +66,9 @@ export function ShellWindowModeOverlays({
   contentHeight,
   dockGeometryOptions,
   dockLeafLayouts,
-  dragFloatingRect,
   focusedPaneId,
   getPaneTitle,
+  live,
   menuOpen,
   nativePaneChrome,
   nativeWindowModePanelRect,
@@ -84,9 +86,15 @@ export function ShellWindowModeOverlays({
   const highlightedDockedLeaf = highlightedPaneId && !highlightedFloatingPane
     ? dockLeafLayouts.find((leaf) => leaf.instanceId === highlightedPaneId)
     : null;
+  // The terminal frame follows a floating pane while it moves; desktop panes draw their own.
+  const followedPaneId = !nativePaneChrome && highlightedFloatingPane ? highlightedFloatingPane.pane.instance.instanceId : null;
+  const selectDragRect = useCallback((geometry: LiveDragGeometry) => (
+    followedPaneId && geometry.floating?.paneId === followedPaneId ? geometry.floating.rect : null
+  ), [followedPaneId]);
+  const dragRect = useLiveDrag(live, selectDragRect);
   const highlightedRect = highlightedFloatingPane
-    ? dragFloatingRect?.paneId === highlightedFloatingPane.pane.instance.instanceId
-      ? constrainFloatingRectToBounds(dragFloatingRect.rect, width, contentHeight)
+    ? dragRect
+      ? constrainFloatingRectToBounds(dragRect, width, contentHeight)
       : highlightedFloatingPane.rect
     : highlightedDockedLeaf?.rect ?? null;
   const highlightedZIndex = highlightedFloatingPane

package/src/data/json-persistence.ts

@@ -1,21 +1,35 @@
 import type { AppPersistencePort } from "../core/app-service-ports";
 import type { PluginStateRecord } from "./plugin-state-store";
 import type { SessionSnapshotRecord } from "./session-store";
-import { MemoryResourceStore } from "./memory-resource-store";
+import { resourceRecordKey, WriteThroughResourceStore } from "./memory-resource-store";
+import type { CachedResourceRecord, ResourceCacheKey } from "./resource-store";
 import { BROWSER_STORAGE_KEYS, SafeJsonStorage, type StorageLike } from "./json-storage";
 import { isRecord } from "../utils/guards";
 
 type PluginState = Record<string, Record<string, PluginStateRecord>>;
 type Sessions = Record<string, SessionSnapshotRecord>;
+type SavedResources = Record<string, CachedResourceRecord>;
 
 export class JsonPersistence implements AppPersistencePort {
-  readonly resources = new MemoryResourceStore();
+  /** In memory, except the records `keepResource` picks, which outlive a reload like the positions do. */
+  readonly resources: WriteThroughResourceStore;
   private readonly pluginStateData: SafeJsonStorage<PluginState>;
   private readonly sessionData: SafeJsonStorage<Sessions>;
+  private readonly resourceData: SafeJsonStorage<SavedResources>;
 
-  constructor(storage?: StorageLike) {
+  constructor(storage?: StorageLike, { keepResource = () => false }: { keepResource?: (key: ResourceCacheKey) => boolean } = {}) {
     this.pluginStateData = new SafeJsonStorage(storage, BROWSER_STORAGE_KEYS.pluginState, {}, (value): value is PluginState => isRecord(value));
     this.sessionData = new SafeJsonStorage(storage, BROWSER_STORAGE_KEYS.session, {}, (value): value is Sessions => isRecord(value));
+    this.resourceData = new SafeJsonStorage(storage, BROWSER_STORAGE_KEYS.resources, {}, (value): value is SavedResources => isRecord(value));
+    const saved = Object.values(this.resourceData.get()).filter((record) => isRecord(record) && typeof record.kind === "string");
+    this.resources = new WriteThroughResourceStore(saved, {
+      set: (record) => this.resourceData.set({ ...this.resourceData.get(), [resourceRecordKey(record)]: record }),
+      delete: (key) => {
+        const next = { ...this.resourceData.get() };
+        delete next[resourceRecordKey(key)];
+        this.resourceData.set(next);
+      },
+    }, keepResource);
   }
 
   readonly pluginState = {

package/src/data/json-storage.ts

@@ -47,4 +47,6 @@ export const BROWSER_STORAGE_KEYS = {
   tickers: "gloomberb.web.tickers.v1",
   pluginState: "gloomberb.web.plugin-state.v1",
   session: "gloomberb.web.session.v1",
+  /** Broker account snapshots; other caches stay in memory. */
+  resources: "gloomberb.web.resources.v1",
 } as const;

package/src/data/memory-resource-store.ts

@@ -103,4 +103,50 @@ export class MemoryResourceStore {
   delete(key: ResourceCacheKey): void {
     this.records.delete(buildMapKey(key));
   }
+
+  /** Puts back a record saved elsewhere, with its own times. */
+  protected restore(record: CachedResourceRecord): void {
+    this.records.set(buildMapKey(record), { ...record });
+  }
+}
+
+export function resourceRecordKey(key: ResourceCacheKey): string {
+  return buildMapKey(key);
+}
+
+/** Where a renderer without the cache database keeps the records that must outlive a restart. */
+export interface ResourceRecordSink {
+  set(record: CachedResourceRecord): void;
+  delete(key: ResourceCacheKey): void;
+}
+
+/**
+ * The in-memory store, except that the records `durable` picks are handed to
+ * a sink as they change and come back from it on the next start. The desktop
+ * view and the web app have no cache database: without this a broker
+ * account's snapshot lived only until the app closed, while its positions
+ * were saved.
+ */
+export class WriteThroughResourceStore extends MemoryResourceStore {
+  constructor(
+    saved: readonly CachedResourceRecord[],
+    private readonly sink: ResourceRecordSink,
+    private readonly durable: (key: ResourceCacheKey) => boolean,
+  ) {
+    super();
+    for (const record of saved) {
+      if (durable(record)) this.restore(record);
+    }
+  }
+
+  override set<T>(key: ResourceCacheKey, value: T, options: SetResourceOptions): CachedResourceRecord<T> {
+    const record = super.set(key, value, options);
+    if (this.durable(key)) this.sink.set(record);
+    return record;
+  }
+
+  override delete(key: ResourceCacheKey): void {
+    super.delete(key);
+    if (this.durable(key)) this.sink.delete(key);
+  }
 }

package/src/market-data/market/freshness.ts

@@ -414,6 +414,51 @@ export function isUsPriorSessionPremarketQuote(
   return localTradingDaysBetween(canonical, timestampDate, currentDate) === 1;
 }
 
+/**
+ * After the regular close and before any after-hours trade, a US quote's last
+ * print is today's regular session, and that close is the current price: a thin
+ * listing may not trade again tonight, and for fifteen minutes after the close
+ * the delayed feed still shows the session's last minutes. The source labels
+ * the quote POST (or CLOSED) and has no after-hours price to show. The print
+ * must be from today's New York trading day, from the regular open through the
+ * regular close (the published early close included). An earlier day's print
+ * or this morning's pre-market is not today's close.
+ */
+export function isUsRegularCloseQuoteInPostSession(
+  timestampMs: number,
+  exchange: string | undefined,
+  marketState: MarketState | undefined,
+  now = Date.now(),
+): boolean {
+  const canonical = canonicalExchange(exchange);
+  if ((marketState !== "POST" && marketState !== "CLOSED") || !isUsListingExchange(canonical)) return false;
+  if (!Number.isFinite(timestampMs) || !Number.isFinite(now) || timestampMs > now + quoteFutureToleranceMs()) return false;
+  if (!Number.isFinite(new Date(now).getTime()) || usSessionState(now) !== "POST") return false;
+  const currentDate = exchangeLocalDate(canonical, now);
+  if (!currentDate || exchangeLocalDate(canonical, timestampMs) !== currentDate) return false;
+  if (!isLocalTradingDay(canonical, currentDate)) return false;
+  const published = getPublishedUsEquitySession(canonical, currentDate);
+  if (published) return published.kind === "session" && timestampMs >= published.open && timestampMs <= published.close;
+  return usSessionState(timestampMs) === "REGULAR";
+}
+
+/**
+ * Whether a US print belongs to the after-hours session in progress: today's,
+ * from the regular close. An earlier day's after-hours print is not.
+ */
+export function isUsPostSessionPrint(
+  timestampMs: number,
+  exchange: string | undefined,
+  now = Date.now(),
+): boolean {
+  const canonical = canonicalExchange(exchange);
+  if (!isUsListingExchange(canonical)) return false;
+  if (!Number.isFinite(timestampMs) || !Number.isFinite(now) || timestampMs > now + quoteFutureToleranceMs()) return false;
+  if (!Number.isFinite(new Date(now).getTime()) || usSessionState(now) !== "POST") return false;
+  const currentDate = exchangeLocalDate(canonical, now);
+  return !!currentDate && exchangeLocalDate(canonical, timestampMs) === currentDate && usSessionState(timestampMs) === "POST";
+}
+
 export function isTimestampStaleForExchangeSession(
   timestampMs: number,
   exchange?: string,

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

@@ -7,6 +7,7 @@ import {
   activeUsExtendedHoursSession,
   isTimestampStaleForExchangeSession,
   isUsPriorSessionPremarketQuote,
+  isUsRegularCloseQuoteInPostSession,
 } from "../market/freshness";
 
 // Give the next regular session's NAV time to publish after its actual close.
@@ -61,6 +62,10 @@ function isQuoteMissingActiveSessionPrice(quote: Quote, now: number): boolean {
   if (!isExtendedHoursExchange(quote)) return false;
   const activeSession = activeUsExtendedHoursSession(now);
   if (!activeSession) return false;
+  // No after-hours trade yet: today's regular close is the current price.
+  if (activeSession === "POST" && quote.postMarketPrice == null && isUsRegularCloseQuoteInPostSession(
+    quote.lastUpdated, quote.listingExchangeName || quote.exchangeName, quote.marketState, now,
+  )) return false;
   if (quote.marketState !== activeSession) return true;
   if (activeSession === "POST") return quote.postMarketPrice == null;
   // No pre-market trade yet: the previous session's close is the current price.

package/src/plugins/builtin/analytics/pane-model.ts

@@ -12,6 +12,7 @@ import { instrumentFromTicker, type ChartRequest, type TickerInstrumentOptions }
 import { buildChartKey } from "../../../market-data/selectors";
 import {
   resolvePortfolioAccountMetrics,
+  resolvePortfolioLeverage,
   resolvePortfolioMarketValue,
   resolvePortfolioNetLiquidation,
 } from "../portfolio-list/account-metrics";
@@ -69,8 +70,8 @@ function formatAccountFreshness(account: ResolvedPortfolioAccountState["account"
 }
 
 function formatMarginLeverage(netLiquidation: number | undefined, totalMarketValue: number): string | null {
-  if (!isFiniteNumber(netLiquidation) || netLiquidation <= 0 || !isFiniteNumber(totalMarketValue) || totalMarketValue < 0) return null;
-  return `${(totalMarketValue / netLiquidation).toFixed(1)}x`;
+  const leverage = resolvePortfolioLeverage(totalMarketValue, netLiquidation);
+  return leverage == null ? null : `${leverage.toFixed(1)}x`;
 }
 
 export function buildPortfolioChartTargets(
@@ -205,6 +206,7 @@ export function buildPortfolioBetaResult(portfolio: PortfolioReturnSeriesResult,
 
 export function buildAnalyticsSummaryRows({
   accountState,
+  activePortfolio,
   brokerPerformance,
   portfolioStats,
   convertAccountValue = (value) => value,
@@ -232,6 +234,8 @@ export function buildAnalyticsSummaryRows({
   const totalMarketValue = resolvePortfolioMarketValue(portfolioStats, account, convertAccountValue, basis);
   const netLiquidation = resolvePortfolioNetLiquidation(portfolioStats, account, convertAccountValue, basis);
   const hasMarketValue = portfolioStats.hasPositions || isFiniteNumber(account?.grossPositionValue);
+  // As in the portfolio header: a broker account is worth its equity, and its positions alone are its gross.
+  const broker = !!account || !!activePortfolio?.brokerInstanceId;
 
   if (portfolioStats.unavailableConversions?.length || (account && !Number.isFinite(convertAccountValue(1)))) {
     rows.push({
@@ -241,19 +245,19 @@ export function buildAnalyticsSummaryRows({
     });
   }
 
-  if (netLiquidation != null) {
+  if (netLiquidation != null || (broker && hasMarketValue)) {
     rows.push({
       id: "net-liquidation",
       label: "Net Liq",
-      value: money(netLiquidation),
-      color: colors.text,
+      value: money(netLiquidation ?? Number.NaN),
+      color: netLiquidation != null ? colors.text : colors.textDim,
     });
   }
 
   if (hasMarketValue) {
     rows.push({
       id: "total-value",
-      label: "Val",
+      label: broker || portfolioStats.hasShorts ? "Gross" : "Val",
       value: money(totalMarketValue),
       color: colors.text,
     });

package/src/plugins/builtin/attention/pane.tsx

@@ -58,7 +58,7 @@ function Evidence({ row, data, width, height }: { row: DetailRow; data: Attentio
   const sameDay = row.evidence.periodStart.slice(0, 10) === row.evidence.periodEnd.slice(0, 10);
   const period = sameDay ? `${hour(row.evidence.periodStart)} to ${row.evidence.periodEnd.slice(11, 16)} UTC` : `${hour(row.evidence.periodStart)} to ${date(row.evidence.periodEnd)}`;
   const latest = point?.bucketStart === row.history.at(-1)?.bucketStart;
-  return <ScrollBox width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
+  return <ScrollBox scrollY width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
     <KeyValueRow label="Listing" value={row.symbol} detail={row.name ?? undefined} labelWidth={20} />
     <SectionHeading title="Publication" />
     <KeyValueRow label="Research hours" value={number(row.researchUnits)} detail={`rounded to ${data.privacy.rounding}`} labelWidth={20} />

package/src/plugins/builtin/catalysts/detail.tsx

@@ -18,7 +18,7 @@ function Evidence({ event, width, height }: { event: CatalystEvent; width: numbe
   const facts = catalystFacts(event);
   const procedures = Array.isArray(event.metadata?.proceduralStatements) ? event.metadata.proceduralStatements.filter((value): value is string => typeof value === "string") : [];
   const documents = Array.isArray(event.metadata?.documents) ? event.metadata.documents.filter((value): value is { url: string; title?: string; label?: string } => !!value && typeof value === "object" && "url" in value && typeof value.url === "string" && /^https?:\/\//.test(value.url)) : [];
-  return <ScrollBox width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
+  return <ScrollBox scrollY width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
     <KeyValueRow label="Classification" value={`${catalystLabel(event.type)} · ${catalystAgency(event.agency)} · ${event.country ?? event.jurisdiction}`} labelWidth={18} />
     <KeyValueRow label="Status" value={humanLabel(event.status)} detail={`Revision ${event.revision}`} labelWidth={18} />
     <KeyValueRow label="Announced" value={catalystDate(event, "announced")} labelWidth={18} />

package/src/plugins/builtin/company-attention/pane.tsx

@@ -33,7 +33,7 @@ const LABEL_COLUMNS = new Set(["chart"]);
 function Evidence({ row, width, height }: Size & { row: AttentionRow }) {
   const colors = useThemeColors();
   const desktop = !!useUiCapabilities().nativePaneChrome;
-  return <ScrollBox width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
+  return <ScrollBox scrollY width={width} height={desktop ? undefined : height} flexGrow={1} flexBasis={0} contentOptions={{ paddingX: 1 }}>
     {(row.details ?? Object.entries(row.values).map(([label, value]) => ({ label, value: String(value ?? "--") }))).map((entry) => <KeyValueRow key={entry.label} label={entry.label} value={entry.value} labelWidth={22} />)}
     {row.url ? <Box paddingY={1}><Text fg={colors.textMuted}>{row.url}</Text></Box> : null}
   </ScrollBox>;

package/src/plugins/builtin/holders/client.ts

@@ -1,5 +1,6 @@
 import type { DataProvider, MarketDataRequestContext } from "../../../types/data-provider";
 import type { HolderData } from "../../../types/financials";
+import { holderStakeMarketCap, holderValueCurrency } from "./format";
 
 export async function loadHolderData(
   provider: DataProvider,
@@ -20,10 +21,6 @@ export async function loadHolderSnapshot(
     loadHolderData(provider, symbol, exchange),
     provider.getTickerFinancials(symbol, exchange).catch(() => null),
   ]);
-  const quoteMarketCap = financials?.quote?.marketCap;
-  const marketCap = financials?.quote?.currency && data.currency
-    && financials.quote.currency !== data.currency
-    ? undefined
-    : quoteMarketCap;
-  return { data, marketCap };
+  const quote = financials?.quote;
+  return { data, marketCap: holderStakeMarketCap(quote?.marketCap, quote?.currency, holderValueCurrency(data)) };
 }

package/src/plugins/builtin/holders/format.ts

@@ -1,4 +1,4 @@
-import type { HolderRecord } from "../../../types/financials";
+import type { HolderData, HolderRecord } from "../../../types/financials";
 import { formatCompact, formatPercent, formatPercentRaw } from "../../../utils/format";
 import type { HolderRow } from "./types";
 
@@ -16,15 +16,45 @@ export function formatMaybePercent(value: number | undefined): string {
   return Math.abs(value) <= 1 ? formatPercent(value) : formatPercentRaw(value);
 }
 
+/**
+ * The currency holder values are in. Gloom Cloud names it when it differs
+ * from the listing's (dollars from 13F filings on a London line); an older
+ * service priced them in the listing's currency.
+ */
+export function holderValueCurrency(
+  data: Pick<HolderData, "valueCurrency" | "currency"> | null | undefined,
+  fallback?: string,
+): string | undefined {
+  return data?.valueCurrency?.trim() || data?.currency?.trim() || fallback;
+}
+
+/**
+ * The market cap a holding's value can be divided by: only one in the
+ * values' own currency. A cap whose currency, or values whose currency, is
+ * not known is taken as it was before currencies were stated.
+ */
+export function holderStakeMarketCap(
+  marketCap: number | undefined,
+  marketCapCurrency: string | null | undefined,
+  valueCurrency: string | null | undefined,
+): number | undefined {
+  if (marketCap == null) return undefined;
+  if (marketCapCurrency && valueCurrency && marketCapCurrency !== valueCurrency) return undefined;
+  return marketCap;
+}
+
+/** The reported stake, else the value over a market cap `holderStakeMarketCap` allowed. */
 export function resolveHolderOwnershipPercent(row: Pick<HolderRecord, "percentHeld" | "value">, marketCap: number | undefined): number | undefined {
   if (row.percentHeld != null) return row.percentHeld;
   if (row.value == null || row.value < 0 || marketCap == null || marketCap <= 0) return undefined;
   return row.value / marketCap;
 }
 
+/** A stake too small for two decimals reads "<0.01%", not a zero. */
 export function formatHolderOwnershipPercent(value: number | undefined): string {
   if (value == null) return "-";
   const percent = Math.abs(value) <= 1 ? value * 100 : value;
+  if (percent > 0 && percent < 0.005) return "<0.01%";
   return `${percent.toFixed(2)}%`;
 }
 

package/src/plugins/builtin/holders/headless.ts

@@ -12,6 +12,7 @@ import {
   formatMaybePercent,
   formatMoneyCompact,
   formatSignedCompact,
+  holderValueCurrency,
   resolveHolderOwnershipPercent,
 } from "./format";
 import { buildRows, sortRows } from "./table-model";
@@ -19,6 +20,8 @@ import type { HolderData } from "../../../types/financials";
 import type { HolderColumnId } from "./types";
 import { SEC_FILINGS } from "../shared/report-freshness";
 import {
+  holderShareBasisMarker,
+  holderShareBasisNote,
   holderValueBasis,
   holdersHeaderLine,
   moneyColumnHeader,
@@ -28,6 +31,8 @@ import {
 
 /** Columns a source fills only when it reports the quarter's change. */
 const CHANGE_COLUMN_KEYS = new Set(["changeShares", "changePercent"]);
+/** Shown only when some row is held as depositary receipts, as on a home line abroad. */
+const BASIS_COLUMN_KEY = "shareBasis";
 import type { BeneficialOwnersPayload } from "../../../api-client/beneficial-owners";
 import { fetchBeneficialOwners, type BeneficialOwnersRequest } from "./beneficial-client";
 import type { BeneficialColumnId } from "./beneficial-model";
@@ -60,6 +65,11 @@ const HOLDER_COLUMNS: HeadlessPaneColumn[] = [
     align: "right",
     format: (value) => value == null ? "-" : formatCompact(Number(value)),
   },
+  {
+    key: BASIS_COLUMN_KEY,
+    header: "Basis",
+    format: (_value, row) => holderShareBasisMarker(row),
+  },
   {
     key: "changeShares",
     header: "Chg",
@@ -238,6 +248,8 @@ export function createHoldersHeadless(
       }
       const { data, marketCap } = await dependencies.loadSnapshot(symbol, args, ctx);
       const currency = data.currency ?? "USD";
+      // A London line's values can be dollars from the 13F filings; they are labelled and formatted as such.
+      const valueCurrency = holderValueCurrency(data, currency)!;
       const sorted = sortRows(buildRows(data), {
         columnId: SORT_COLUMNS[String(args.options.sort)] ?? "value",
         direction: args.options.order === "asc" ? "asc" : "desc",
@@ -253,19 +265,23 @@ export function createHoldersHeadless(
           changePercent: row.changePercent ?? null,
           percentHeld: resolveHolderOwnershipPercent(row, marketCap) ?? null,
           reportDate: row.reportDate ?? null,
-          currency,
+          currency: valueCurrency,
+          shareBasis: row.shareBasis ?? null,
         }));
       const total = data.summary?.institutionsCount ?? null;
       const changeReported = rows.some((row) => row.changeShares != null || row.changePercent != null);
       const reportDate = sharedReportDate(rows);
-      const valueBasis = holderValueBasis(reportDate);
+      const valueBasis = holderValueBasis(reportDate, data.valueBasis, valueCurrency);
       const positionsBasis = rows.length > 0 ? nonUsHolderCaveat(data.exchange, currency) : null;
+      const shareBasisNote = holderShareBasisNote(data, rows);
+      const markedRows = rows.some((row) => holderShareBasisMarker(row));
       // The title names the ticker and the closing line carries the as-of date.
       const header = holdersHeaderLine({
         name: data.name,
         symbol: data.symbol && data.symbol !== symbol ? data.symbol : null,
         exchange: data.exchange,
-        currency,
+        currency: valueCurrency,
+        listingCurrency: data.currency,
         shown: rows.length,
         reported: sorted.length,
         total,
@@ -278,13 +294,18 @@ export function createHoldersHeadless(
         // A change column that is empty on every row says nothing; the line above explains it once.
         columns: HOLDER_COLUMNS
           .filter((column) => changeReported || !CHANGE_COLUMN_KEYS.has(column.key))
-          .map((column) => column.key === "value" ? { ...column, header: moneyColumnHeader(column.header, currency) } : column),
+          .filter((column) => markedRows || column.key !== BASIS_COLUMN_KEY)
+          .map((column) => column.key === "value" ? { ...column, header: moneyColumnHeader(column.header, valueCurrency) } : column),
         rows,
         metadata: {
           symbol: data.symbol || symbol,
           name: data.name ?? null,
           exchange: data.exchange ?? null,
           currency,
+          valueCurrency,
+          ...(data.isDepositaryReceipt != null ? { isDepositaryReceipt: data.isDepositaryReceipt } : {}),
+          ...(data.shareBasis ? { shareBasis: data.shareBasis } : {}),
+          ...(data.adrRatio != null ? { adrRatio: data.adrRatio } : {}),
           asOf: data.asOf ?? null,
           summary: data.summary ?? null,
           shown: rows.length,
@@ -294,7 +315,7 @@ export function createHoldersHeadless(
           valueBasis,
           changeReported,
           positionsBasis,
-          notices: [header, basis, positionsBasis].filter((line): line is string => !!line),
+          notices: [header, basis, positionsBasis, shareBasisNote].filter((line): line is string => !!line),
         },
       };
     },