gloomberb 0.18.4 → 0.19.0

package/src/plugins/builtin/market-movers/footer.ts

@@ -1,5 +1,5 @@
 import type { PaneFooterSegment } from "../../../components";
-import { priceColor } from "../../../theme/colors";
+import { shownPriceColor } from "../../../theme/colors";
 import { formatPercentRaw } from "../../../utils/format";
 import { INDEX_SHORT } from "./model";
 import type { MarketSummaryQuote } from "./screener";
@@ -12,7 +12,7 @@ export function summaryFooterSegments(summaryQuotes: readonly MarketSummaryQuote
       id: `summary:${idx.symbol}`,
       parts: [
         { text: short, tone: "label" as const },
-        { text: formatPercentRaw(idx.changePercent), tone: "value" as const, color: priceColor(idx.changePercent), bold: true },
+        { text: formatPercentRaw(idx.changePercent), tone: "value" as const, color: shownPriceColor(idx.changePercent, 2), bold: true },
       ],
     };
   });

package/src/plugins/builtin/market-movers/headless.ts

@@ -14,6 +14,7 @@ import { createRows, fiftyTwoWeekPositionPercent, formatMoverPrice, MOVER_RANKIN
 import { EXTENDED_SESSION_LABELS, type ExtendedSession } from "../../../market-data/market/status";
 import type { HeadlessPaneColumn } from "../../../types/headless";
 import { isSessionTab, resolveSide } from "./session";
+import { hasPartialFloat, minFloatShares, normalizeMinFloat, PARTIAL_FLOAT_NOTE } from "./min-float";
 
 const rowPrice = (value: unknown, row: Record<string, unknown>) => formatMoverPrice(typeof value === "number" ? value : null, typeof row.currency === "string" ? row.currency : "", moverReferencePrice(row as unknown as MarketMoverRow));
 
@@ -69,15 +70,19 @@ function sessionColumns(view: CloudSessionMoversCategory) {
   ];
 }
 
+const FLOAT_COLUMN: HeadlessPaneColumn = { key: "floatShares", header: "Float", align: "right", format: compact };
+
 export interface MarketMoversHeadlessDependencies {
   load(
     args: HeadlessPaneLoadArgs,
     tab: ScreenerTabId,
     provider: DataProvider,
+    minFloat: number | null,
   ): Promise<MarketMoverTabResult>;
   loadSession(
     view: CloudSessionMoversCategory,
     side: CloudSessionMoversSide,
+    minFloat: number | null,
   ): Promise<CloudSessionMoversPayload>;
 }
 
@@ -89,8 +94,8 @@ export interface MarketMoversHeadlessDependencies {
 const ONE_SHOT_METADATA_WAIT_MS = 10_000;
 
 const defaultDependencies: MarketMoversHeadlessDependencies = {
-  load: (_args, tab, provider) => loadMarketMoverTab(tab, provider, { metadataWaitMs: ONE_SHOT_METADATA_WAIT_MS }),
-  loadSession: (view, side) => loadSessionMovers(view, side),
+  load: (_args, tab, provider, minFloat) => loadMarketMoverTab(tab, provider, { metadataWaitMs: ONE_SHOT_METADATA_WAIT_MS, minFloat }),
+  loadSession: (view, side, minFloat) => loadSessionMovers(view, side, { minFloat }),
 };
 
 export function createMarketMoversHeadless(
@@ -128,6 +133,14 @@ export function createMarketMoversHeadless(
       ],
       defaultValue: "up",
       pluginState: { pluginId: "market-overview", key: "sessionSide" },
+    }, {
+      key: "min-float",
+      description: "Keep the rows whose float (the one EQS serves) is at least this many shares, such as 10M or 500k; any lifts it. A row with no float is left out. Trending carries no float and ignores it.",
+      type: "string",
+      placeholder: "shares",
+      example: "--min-float 10M",
+      normalize: normalizeMinFloat,
+      pluginState: { pluginId: "market-overview", key: "minFloat" },
     }],
     columns: COLUMNS,
     describe: (args) => isSessionTab(String(args.options.list))
@@ -135,21 +148,26 @@ export function createMarketMoversHeadless(
       : `Market Movers | ${String(args.options.list)}`,
     async load(args, ctx) {
       const tab = args.options.list as TabId;
+      const minFloatValue = typeof args.options["min-float"] === "string" ? args.options["min-float"] : null;
+      const minFloat = minFloatShares(minFloatValue);
       if (isSessionTab(tab)) {
         const side = resolveSide(tab, String(args.options.side));
-        const payload = await dependencies.loadSession(tab, side);
+        const payload = await dependencies.loadSession(tab, side, minFloat);
         return {
           columns: sessionColumns(tab),
           rows: payload.items.map((item) => ({
             ...item,
             events: item.catalysts.map((catalyst) => CATALYST_LABEL[catalyst] ?? catalyst).join(" "),
           })),
-          metadata: { list: tab, side, session: payload.session, phase: payload.phase, asOf: payload.asOf, stale: payload.stale === true },
+          ...(hasPartialFloat(payload.items) ? { notes: [PARTIAL_FLOAT_NOTE] } : {}),
+          metadata: { list: tab, side, session: payload.session, phase: payload.phase, asOf: payload.asOf, stale: payload.stale === true, minFloat },
           // A Pro account's list is the live board; the free one says it is delayed.
           ...(payload.access === "delayed" ? {} : { freshness: { status: "live" as const } }),
         };
       }
-      const result = await dependencies.load(args, tab, ctx.marketData);
+      // Trending carries no float, so a minimum does not apply to it.
+      const floatFiltered = minFloat != null && tab !== "trending";
+      const result = await dependencies.load(args, tab, ctx.marketData, floatFiltered ? minFloat : null);
       const ranked = createRows(result.quotes);
       // Last and Change % are the regular session; an extended print is a column of its own.
       const extendedSessions = moverExtendedSessions(ranked);
@@ -168,16 +186,18 @@ export function createMarketMoversHeadless(
       // Beside an extended column, say which move the order follows.
       const rankedBy = result.rankedBy ?? null;
       const quoteError = marketMoverQuoteError(result);
+      const columns = [...COLUMNS.slice(0, 5), ...extendedSessions.map(extendedColumn), ...COLUMNS.slice(5), ...(floatFiltered ? [FLOAT_COLUMN] : [])];
+      const notes = [
+        ...(rankedBy && rankedBy !== "volume" && extendedSessions.length > 0 ? [`Ranked by ${MOVER_RANKING_LABELS[rankedBy]}.`] : []),
+        ...(minFloat != null && !floatFiltered ? ["Trending carries no float, so --min-float does not apply to it."] : []),
+        ...(floatFiltered && hasPartialFloat(rows) ? [PARTIAL_FLOAT_NOTE] : []),
+      ];
       return {
-        ...(extendedSessions.length > 0
-          ? { columns: [...COLUMNS.slice(0, 5), ...extendedSessions.map(extendedColumn), ...COLUMNS.slice(5)] }
-          : {}),
+        ...(columns.length !== COLUMNS.length ? { columns } : {}),
         rows,
         ...(quoteError ? { complete: false, unavailableSymbols: result.unavailableSymbols, errors: [quoteError] } : {}),
-        ...(rankedBy && rankedBy !== "volume" && extendedSessions.length > 0
-          ? { notes: [`Ranked by ${MOVER_RANKING_LABELS[rankedBy]}.`] }
-          : {}),
-        metadata: { list: tab, source: result.source, stale: result.stale, rankedBy },
+        ...(notes.length > 0 ? { notes } : {}),
+        metadata: { list: tab, source: result.source, stale: result.stale, rankedBy, minFloat: floatFiltered ? minFloat : null },
         // A Pro account's Gainers, Losers and Most Active are the real-time lists.
         ...(result.source === "cloud" ? { freshness: { status: "live" as const } } : {}),
       };

package/src/plugins/builtin/market-movers/index.tsx

@@ -1,7 +1,7 @@
 import { Box, useUiCapabilities } from "../../../ui";
 import { nextHeaderSort } from "../../../utils/sort-values";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { DataTableView, EmptyState, usePaneFooter, usePaneTabs, type DataTableKeyEvent } from "../../../components";
+import { DataTableView, EmptyState, QueryBar, usePaneFooter, usePaneTabs, type DataTableKeyEvent } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import type { PaneProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
@@ -41,6 +41,7 @@ import { loadMarketMoverTab, marketMoverQuoteError } from "./client";
 import { summaryFooterSegments } from "./footer";
 import { isSessionTab, resolveActiveTab, usSessionAt, type UsSession } from "./session";
 import { SessionMoversBody } from "./session-body";
+import { ANY_FLOAT, minFloatEmptyTitle, minFloatFilter, minFloatShares, partialFloatFooter } from "./min-float";
 import { marketMoversHeadless } from "./headless";
 import { buildMarketMoverColumns, renderMarketMoverCell } from "./table";
 import type { ExtendedSession } from "../../../market-data/market/status";
@@ -152,16 +153,21 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
 }) {
   const dataProvider = useAssetData();
   const { pinTicker } = usePluginTickerActions();
+  const [minFloatValue, setMinFloatValue] = usePluginPaneState<string>("minFloat", ANY_FLOAT);
+  // Trending carries no float, so the minimum is not offered there.
+  const floatFiltered = activeTab !== "trending";
+  const minFloat = floatFiltered ? minFloatShares(minFloatValue) : null;
+  const listKey = `${activeTab}:${minFloat ?? ""}`;
   const [quotes, setQuotes] = useState<MoverQuote[]>([]);
-  const [loadedTab, setLoadedTab] = useState<TabId | null>(null);
-  const visibleQuotes = loadedTab === activeTab ? quotes : NO_QUOTES;
+  const [loadedKey, setLoadedKey] = useState<string | null>(null);
+  const visibleQuotes = loadedKey === listKey ? quotes : NO_QUOTES;
   // The first load starts before the effect runs; an empty board is not "no data".
   const [loading, setLoading] = useState(true);
   const [loadError, setLoadError] = useState<string | null>(null);
   const [selectedSymbol, setSelectedSymbol] = useState<string | null>(null);
   const [sortPreference, setSortPreference] = useState<MarketMoverSortPreference>(DEFAULT_SORT_PREFERENCE);
   const [moversStale, setMoversStale] = useState(false);
-  const [lastSuccess, setLastSuccess] = useState<{ tab: ScreenerTabId; at: number } | null>(null);
+  const [lastSuccess, setLastSuccess] = useState<{ key: string; at: number } | null>(null);
 
   const fetchGenRef = useRef(0);
 
@@ -192,8 +198,8 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
   // A pre-market or after-hours column only while a row has such a print.
   const extendedSessionsKey = moverExtendedSessions(rankedRows).join(",");
   const columns = useMemo(
-    () => buildMarketMoverColumns(width, extendedSessionsKey ? extendedSessionsKey.split(",") as ExtendedSession[] : []),
-    [extendedSessionsKey, width],
+    () => buildMarketMoverColumns(width, extendedSessionsKey ? extendedSessionsKey.split(",") as ExtendedSession[] : [], { float: minFloat != null }),
+    [extendedSessionsKey, minFloat, width],
   );
   const rows = useMemo(() => sortRows(rankedRows, sortPreference), [rankedRows, sortPreference]);
   const selectedIdx = selectedSymbol
@@ -223,6 +229,7 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
     try {
       const result = await loadMarketMoverTab(tab, dataProvider, {
         forceRefresh: options?.forceRefresh,
+        minFloat,
       });
       if (fetchGenRef.current !== gen) return;
 
@@ -230,12 +237,12 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
       // A partial list shows only its current rows; a total failure keeps this list's prior rows.
       if (!quoteError || result.quotes.length > 0) {
         setQuotes(result.quotes);
-        setLoadedTab(tab);
+        setLoadedKey(`${tab}:${minFloat ?? ""}`);
         if (!options?.background) setSelectedSymbol(null);
       }
       setMoversStale(result.stale);
       setLoadError(quoteError);
-      if (!quoteError && !result.stale) setLastSuccess({ tab, at: Date.now() });
+      if (!quoteError && !result.stale) setLastSuccess({ key: `${tab}:${minFloat ?? ""}`, at: Date.now() });
     } catch {
       if (fetchGenRef.current !== gen) return;
       setMoversStale(true);
@@ -244,7 +251,7 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
     finally {
       if (fetchGenRef.current === gen && !options?.background) setLoading(false);
     }
-  }, [dataProvider]);
+  }, [dataProvider, minFloat]);
 
   useEffect(() => {
     setSelectedSymbol(null);
@@ -254,7 +261,7 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
   const backgroundRefresh = useCallback(() => {
     void loadTab(activeTab, { background: true });
   }, [activeTab, loadTab]);
-  useAutoRefresh(lastSuccess?.tab === activeTab ? lastSuccess.at : null, backgroundRefresh);
+  useAutoRefresh(lastSuccess?.key === listKey ? lastSuccess.at : null, backgroundRefresh);
 
   const openSymbol = useCallback((row: MarketMoverRow) => {
     pinTicker(moverKey(row), { floating: true, paneType: TICKER_RESEARCH_PANE_ID, instrument: null });
@@ -281,16 +288,21 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
         id: "feed",
         parts: [{ text: feedStatus, tone: feedStatus === "live" ? "value" as const : "muted" as const }],
       }] : []),
-      ...(moversStale && loadedTab === activeTab ? [{
+      ...(moversStale && loadedKey === listKey ? [{
         id: "stale",
         parts: [{ text: "stale", tone: "muted" as const }],
       }] : []),
+      // The FLOAT column shows while a minimum is set; a float the source does not date says so once.
+      ...partialFloatFooter(columns.some((column) => column.id === "floatShares"), rows),
     ],
-  }), [activeTab, feedStatus, loadedTab, loadError, loading, moversStale, summaryQuotes]);
+  }), [columns, feedStatus, listKey, loadedKey, loadError, loading, moversStale, rows, summaryQuotes]);
 
   return (
     <DataTableView<MarketMoverRow, MarketMoverColumn>
       focused={focused}
+      rootBefore={floatFiltered ? (
+        <QueryBar width={Math.max(1, width - 2)} filters={[minFloatFilter(minFloatValue, setMinFloatValue)]} />
+      ) : undefined}
       selection={{
         kind: "id",
         selectedId: selectedSymbol,
@@ -298,7 +310,7 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
         onChange: (symbol) => setSelectedSymbol(symbol),
       }}
       onRootKeyDown={handleTableKeyDown}
-      resetScrollKey={activeTab}
+      resetScrollKey={listKey}
       sortable
       columns={columns}
       items={rows}
@@ -309,7 +321,7 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
       onActivate={openSymbol}
       renderCell={renderCell}
       selectedTextOverridesCellColor
-      emptyStateTitle={loading ? "Loading movers..." : loadError ?? "No movers returned."}
+      emptyStateTitle={loading ? "Loading movers..." : loadError ?? (minFloat != null ? minFloatEmptyTitle(minFloatValue) : "No movers returned.")}
       emptyContent={loadError ? (
         <Box paddingX={1} paddingY={1}>
           <EmptyState title={loadError} message="Try again in a moment." />

package/src/plugins/builtin/market-movers/min-float.ts

@@ -0,0 +1,74 @@
+import type { PaneFooterSegment } from "../../../components";
+import type { QueryBarSelectFilter } from "../../../components/ui/query-bar";
+import { formatCompact } from "../../../utils/format";
+
+/** No minimum: every row, with or without a float. */
+export const ANY_FLOAT = "any";
+/** The minimums the pane's menu offers; `--min-float` takes any other. */
+const PRESETS = ["1M", "5M", "10M", "20M", "50M", "100M"] as const;
+const SCALE: Record<string, number> = { k: 1e3, m: 1e6, b: 1e9 };
+
+/** Shares in `text` (10M, 500k, 2.5M, 25000000), or null when it is not a share count. */
+function parseShares(text: string): number | null {
+  const match = /^((?:\d+(?:\.\d*)?|\.\d+))([kmb])?$/i.exec(text.trim().replace(/[_,]/g, ""));
+  if (!match) return null;
+  const value = Number(match[1]) * (match[2] ? SCALE[match[2].toLowerCase()]! : 1);
+  return Number.isFinite(value) ? value : null;
+}
+
+/** The minimum a saved or typed value sets, in shares; null for none (`any`, 0 or a value that is not a count). */
+export function minFloatShares(value: string | null | undefined): number | null {
+  if (!value || value.trim().toLowerCase() === ANY_FLOAT) return null;
+  const shares = parseShares(value);
+  return shares != null && shares > 0 ? shares : null;
+}
+
+/** `--min-float` as the pane keeps it: `10M` for 10m or 10000000, `any` for none. Throws on a value that is not a share count. */
+export function normalizeMinFloat(value: string): string {
+  if (value.trim().toLowerCase() === ANY_FLOAT) return ANY_FLOAT;
+  const shares = parseShares(value);
+  if (shares == null) throw new Error(`--min-float takes a share count such as 10M or 500k, or any; got "${value}".`);
+  return shares > 0 ? formatCompact(shares) : ANY_FLOAT;
+}
+
+/** A row passes with a float at or above the minimum; a row whose float is not known does not. */
+export function meetsMinFloat(floatShares: number | null | undefined, minimum: number | null): boolean {
+  return minimum == null || (floatShares != null && floatShares >= minimum);
+}
+
+/** The pane's Min float menu: Any and the presets, with a minimum set from the CLI kept as its own choice. */
+export function minFloatFilter(value: string, onChange: (value: string) => void): QueryBarSelectFilter {
+  const current = minFloatShares(value) == null ? ANY_FLOAT : value;
+  const presets: string[] = [...PRESETS];
+  const options = [ANY_FLOAT, ...(presets.includes(current) || current === ANY_FLOAT ? [] : [current]), ...presets]
+    .map((option) => ({ value: option, label: option === ANY_FLOAT ? "Any" : option }));
+  return {
+    id: "min-float",
+    label: "Min float",
+    title: "Minimum float",
+    value: current,
+    defaultValue: ANY_FLOAT,
+    options,
+    onChange,
+  };
+}
+
+/** What a list says under its Float column while a shown float is partial. */
+export const PARTIAL_FLOAT_NOTE = "Float is partial: the source does not say when it measured it.";
+
+/** Whether any row's float is partial, which the list then says once. */
+export function hasPartialFloat(rows: readonly { floatShares?: number | null; floatSharesState?: string }[]): boolean {
+  return rows.some((row) => row.floatShares != null && row.floatSharesState === "partial");
+}
+
+/** The footer's word for a FLOAT column of partial floats, or none. */
+export function partialFloatFooter(shown: boolean, rows: readonly { floatShares?: number | null; floatSharesState?: string }[]): PaneFooterSegment[] {
+  return shown && hasPartialFloat(rows)
+    ? [{ id: "float-partial", parts: [{ text: "FLOAT", tone: "label" }, { text: "partial, undated", tone: "muted" }] }]
+    : [];
+}
+
+/** The empty list's title while a minimum hides every row. */
+export function minFloatEmptyTitle(value: string): string {
+  return `No movers with a float of ${value} or more.`;
+}

package/src/plugins/builtin/market-movers/model.ts

@@ -50,7 +50,8 @@ type MarketMoverColumnId =
   | "volume"
   | "volumeRatio"
   | "range"
-  | "marketCap";
+  | "marketCap"
+  | "floatShares";
 export type MarketMoverColumn = DataTableColumn & { id: MarketMoverColumnId };
 /**
  * A list row. Price and change are the regular session's, as `ticker` reads
@@ -123,6 +124,8 @@ function getSortValue(
       return fiftyTwoWeekPositionPercent(row.price, row.fiftyTwoWeekLow, row.fiftyTwoWeekHigh);
     case "marketCap":
       return row.marketCap ?? null;
+    case "floatShares":
+      return row.floatShares ?? null;
   }
 }
 

package/src/plugins/builtin/market-movers/screener.ts

@@ -220,6 +220,17 @@ function parseScreenerSessions(row: Record<string, unknown>): CloudMoverSessionF
   return sessions;
 }
 
+/** A positive float with its state, or nothing: a row without one fails any minimum. */
+function floatOf(source: { floatShares?: unknown; floatSharesState?: unknown; floatSharesReason?: unknown } | null | undefined): Pick<ScreenerQuote, "floatShares" | "floatSharesState" | "floatSharesReason"> {
+  const shares = screenerNumber(source?.floatShares);
+  if (shares == null || !(shares > 0)) return {};
+  return {
+    floatShares: shares,
+    ...(source?.floatSharesState === "partial" ? { floatSharesState: "partial" as const } : {}),
+    ...(source?.floatSharesState === "partial" && typeof source.floatSharesReason === "string" ? { floatSharesReason: source.floatSharesReason } : {}),
+  };
+}
+
 /** Validate numeric fields at the API boundary so absent values stay unavailable. */
 export function parseScreenerResponse(data: unknown): ScreenerQuote[] {
   if (!data || typeof data !== "object" || !("quotes" in data) || !Array.isArray(data.quotes)) {
@@ -239,6 +250,7 @@ export function parseScreenerResponse(data: unknown): ScreenerQuote[] {
       previousClose: screenerNumber(q.previousClose) ?? undefined, exchange: typeof q.exchange === "string" ? q.exchange : "",
       lastUpdated: typeof q.lastUpdated === "number" && Number.isFinite(q.lastUpdated) && q.lastUpdated > 0 ? q.lastUpdated : undefined,
       sessions: parseScreenerSessions(q),
+      ...floatOf(q),
     }];
   });
 }
@@ -325,6 +337,8 @@ function mergeCloudScreenerItem(
     lastUpdated: item.lastUpdated,
     previousClose: screenerNumber(item.previousClose) ?? undefined,
     sessions: parseScreenerSessions(item as unknown as Record<string, unknown>),
+    // The live list's own float, the delayed list's when it sends none, each with its own state.
+    ...floatOf(item.floatShares != null ? item : metadata),
   };
 }
 

package/src/plugins/builtin/market-movers/session-body.tsx

@@ -20,6 +20,7 @@ import { nextHeaderSort } from "../../../utils/sort-values";
 import { usePluginPaneState, usePluginTickerActions } from "../../runtime";
 import { ProWall, SignInWall } from "../cloud/auth-actions";
 import { loadSessionMovers, SessionMoversAccessError } from "./client";
+import { ANY_FLOAT, minFloatEmptyTitle, minFloatFilter, minFloatShares, partialFloatFooter } from "./min-float";
 import { summaryFooterSegments } from "./footer";
 import type { MarketSummaryQuote } from "./screener";
 import {
@@ -104,7 +105,9 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
   const { pinTicker } = usePluginTickerActions();
   const [savedSide, setSavedSide] = usePluginPaneState<CloudSessionMoversSide>("sessionSide", "up");
   const side = resolveSide(view, savedSide);
-  const listKey = `${view}:${side}`;
+  const [minFloatValue, setMinFloatValue] = usePluginPaneState<string>("minFloat", ANY_FLOAT);
+  const minFloat = minFloatShares(minFloatValue);
+  const listKey = `${view}:${side}:${minFloat ?? ""}`;
   const [loaded, setLoaded] = useState<LoadedList | null>(null);
   // The first frame would otherwise claim an empty list.
   const [loading, setLoading] = useState(true);
@@ -132,9 +135,9 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
       setLoadError(null);
     }
     try {
-      const next = await loadSessionMovers(view, side, options);
+      const next = await loadSessionMovers(view, side, { ...options, minFloat });
       if (fetchGenRef.current !== gen) return;
-      setLoaded({ key: `${view}:${side}`, payload: next });
+      setLoaded({ key: `${view}:${side}:${minFloat ?? ""}`, payload: next });
       setLoadError(null);
       setLastLoadedAt(Date.now());
     } catch (error) {
@@ -147,7 +150,7 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
     } finally {
       if (fetchGenRef.current === gen && !options?.background) setLoading(false);
     }
-  }, [onDenied, side, view]);
+  }, [minFloat, onDenied, side, view]);
 
   useEffect(() => {
     setSelectedId(null);
@@ -167,7 +170,7 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
     freshnessScopeKey: `market-movers:${listKey}`,
     liveStreaming,
   });
-  const columns = useMemo(() => buildSessionMoverColumns(view, width), [view, width]);
+  const columns = useMemo(() => buildSessionMoverColumns(view, width, { float: minFloat != null }), [minFloat, view, width]);
   // The sort survives a change of list, but not onto a column this list or width does not show.
   const sort = columns.some((column) => column.id === sortPreference.columnId) ? sortPreference : DEFAULT_SORT;
   const rows = useMemo(
@@ -199,8 +202,10 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
         parts: [{ text: feedStatus, tone: feedStatus === "live" ? "value" as const : "muted" as const }],
       }] : []),
       ...(payload?.stale ? [{ id: "stale", parts: [{ text: "stale", tone: "muted" as const }] }] : []),
+      // A float the source does not date says so once, while the FLOAT column shows.
+      ...partialFloatFooter(columns.some((column) => column.id === "floatShares"), rows),
     ],
-  }), [asOfLabel, feedStatus, loadError, loading, payload?.stale, sessionLabel, summaryQuotes]);
+  }), [asOfLabel, columns, feedStatus, loadError, loading, payload?.stale, rows, sessionLabel, summaryQuotes]);
 
   const openRow = useCallback((row: SessionMoverRow) => {
     pinTicker(rowKey(row), { floating: true, paneType: TICKER_RESEARCH_PANE_ID, instrument: null });
@@ -217,7 +222,7 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
   const sides = sessionSides(view);
   // Until this list's first answer the table is loading, including the frame
   // between a change of list and its request going out.
-  const emptyTitle = payload ? "No movers yet." : loadError ?? "Loading movers...";
+  const emptyTitle = payload ? (minFloat != null ? minFloatEmptyTitle(minFloatValue) : "No movers yet.") : loadError ?? "Loading movers...";
   return (
     <DataTableView<SessionMoverRow, SessionMoverColumn>
       focused={focused}
@@ -231,7 +236,7 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
             value: side,
             options: sides,
             onChange: (value: CloudSessionMoversSide) => setSavedSide(value),
-          }]}
+          }, minFloatFilter(minFloatValue, setMinFloatValue)]}
         />
       )}
       selection={{ kind: "id", selectedId, getId: rowKey, onChange: setSelectedId }}

package/src/plugins/builtin/market-movers/session-table.ts

@@ -21,9 +21,10 @@ const VOLUME_LABEL: Record<CloudSessionMoversCategory, string> = {
  * Pre-market and after hours: last, change from the reference close, session
  * volume, relative volume, float and the catalyst. Gaps add the gap and the
  * distance from VWAP. The name gives way first, then the columns a narrow pane
- * can do without (the day's volume, then the float).
+ * can do without (the day's volume, then the float, which stays while a
+ * minimum float is set: `float`).
  */
-export function buildSessionMoverColumns(view: CloudSessionMoversCategory, width: number): SessionMoverColumn[] {
+export function buildSessionMoverColumns(view: CloudSessionMoversCategory, width: number, options: { float?: boolean } = {}): SessionMoverColumn[] {
   const columns: SessionMoverColumn[] = [
     { id: "rank", label: "#", width: 3, align: "left" },
     { id: "symbol", label: "TICKER", width: 8, align: "left" },
@@ -37,7 +38,7 @@ export function buildSessionMoverColumns(view: CloudSessionMoversCategory, width
     { id: "floatShares", label: "FLOAT", width: 7, align: "right" },
     { id: "catalyst", label: "EVENT", width: 6, align: "left" },
   ];
-  const optional: SessionMoverColumnId[] = view === "gaps" ? ["volume", "floatShares"] : ["floatShares"];
+  const optional: SessionMoverColumnId[] = [...(view === "gaps" ? ["volume" as const] : []), ...(options.float ? [] : ["floatShares" as const])];
   // Measured the way the table draws it: a header widens its column, and a
   // left-aligned column after a right-aligned one gets a lead gap. The name
   // sits between left-aligned columns, so it adds only its width and a gutter.

package/src/plugins/builtin/market-movers/table.ts

@@ -26,15 +26,20 @@ function fiftyTwoWeekPosition(price: number | null, low: number | undefined, hig
 }
 
 const EXTENDED_COLUMN_WIDTH = 9;
-/** With an extended column, a narrow pane drops MCAP, then 52W%, before the name gets narrower than this. */
+/** With an extended or float column, a narrow pane drops MCAP, then 52W%, before the name gets narrower than this. */
 const EXTENDED_MIN_NAME_WIDTH = 12;
 
 /**
  * The list's columns at `width`. A pre-market or after-hours column follows
- * CHG% for each session in `extendedSessions`; to make room for it a narrow
- * pane gives up MCAP, then 52W%, before it cuts the names short.
+ * CHG% for each session in `extendedSessions`, and FLOAT ends the row while a
+ * minimum float is set (`float`); to make room for them a narrow pane gives up
+ * MCAP, then 52W%, before it cuts the names short.
  */
-export function buildMarketMoverColumns(width: number, extendedSessions: readonly ExtendedSession[] = []): MarketMoverColumn[] {
+export function buildMarketMoverColumns(
+  width: number,
+  extendedSessions: readonly ExtendedSession[] = [],
+  options: { float?: boolean } = {},
+): MarketMoverColumn[] {
   const lead: MarketMoverColumn[] = [
     { id: "rank", label: "#", width: 3, align: "left" },
     { id: "symbol", label: "TICKER", width: 8, align: "left" },
@@ -55,12 +60,13 @@ export function buildMarketMoverColumns(width: number, extendedSessions: readonl
     { id: "volumeRatio", label: "V/AVG", width: 6, align: "right" },
     { id: "range", label: "52W%", width: 6, align: "right" },
     { id: "marketCap", label: "MCAP", width: 8, align: "right" },
+    ...(options.float ? [{ id: "floatShares" as const, label: "FLOAT", width: 7, align: "right" as const }] : []),
   ];
   // Measured the way the table draws them (a header and its sort mark widen a
   // column, gaps between them); the name adds its own width and a gap.
   const nameRoom = () => width - getTableWidth([...lead, ...quote, ...trailing]) - 1;
   for (const id of ["marketCap", "range"] as const) {
-    if (extendedSessions.length === 0 || nameRoom() >= EXTENDED_MIN_NAME_WIDTH) break;
+    if ((extendedSessions.length === 0 && !options.float) || nameRoom() >= EXTENDED_MIN_NAME_WIDTH) break;
     trailing.splice(trailing.findIndex((column) => column.id === id), 1);
   }
   return [...lead, { id: "name", label: "NAME", width: Math.max(6, nameRoom()), align: "left" }, ...quote, ...trailing];
@@ -121,5 +127,11 @@ export function renderMarketMoverCell(
         value: row.marketCap,
         color: colors.textDim,
       };
+    case "floatShares":
+      return {
+        text: row.floatShares != null ? formatCompact(row.floatShares, { fixedDecimals: true }) : "—",
+        value: row.floatShares ?? null,
+        color: colors.textDim,
+      };
   }
 }

package/src/plugins/builtin/members/breadth-pane.tsx

@@ -0,0 +1,82 @@
+import { useCallback, useMemo } from "react";
+import type { BreadthDay } from "../../../api-client/members";
+import { ChartTableHeader, DataTableView, PaneStatusBody, QueryBar, useChartTableSelection, usePaneNoticeFooter, usePaneStatusFooter, type DataTableColumn } from "../../../components";
+import { staticSeries } from "../../../components/chart/static/series";
+import { fitChartTableColumns } from "../../../components/chart-table/layout";
+import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
+import { useAsyncResource, useAutoRefresh, usePaneVisible, usePluginPaneState } from "../../../public/react";
+import { useThemeColors } from "../../../theme/theme-context";
+import type { PaneProps } from "../../../types/plugin";
+import { cachedBreadth, loadBreadth } from "./client";
+import { useLiveSessionRefresh } from "../shared/volatility/live-session";
+import { decimal } from "./model";
+
+const percent = (value: number | null) => value == null ? "--" : `${value.toFixed(1)}%`;
+const CHARTS = [{ value: "adLine", label: "A/D line" }, { value: "ma200", label: "Above 200D" }, { value: "ma50", label: "Above 50D" }, { value: "ma20", label: "Above 20D" }];
+type Metric = "adLine" | "ma200" | "ma50" | "ma20";
+const dateOf = (row: BreadthDay) => new Date(`${row.date}T00:00:00Z`);
+const keyOf = (row: BreadthDay) => row.date;
+const valueOf = (row: BreadthDay, metric: Metric) => metric === "adLine" ? row.adLine : row[metric].percent;
+const COLUMNS: DataTableColumn[] = [
+  { id: "date", label: "Date", width: 12, align: "left" },
+  ...["advances", "declines", "unchanged", "ma20", "ma50", "ma200", "newHighs", "newLows", "coverage"].map((id, index) => ({
+    id, label: ["Adv", "Dec", "Unch", ">20D %", ">50D %", ">200D %", "52W high", "52W low", "A/D covered"][index]!, width: index === 8 ? 13 : 10, flexGrow: 1, align: "right" as const,
+  })),
+];
+
+export function Breadth({ fund, width, height, focused, active }: Pick<PaneProps, "width" | "height" | "focused"> & { fund: string; active: boolean }) {
+  const colors = useThemeColors();
+  const visible = usePaneVisible();
+  const resource = useAsyncResource(useCallback((force: boolean) => loadBreadth(fund, force), [fund]), { initialData: useCallback(() => cachedBreadth(fund), [fund]) });
+  const data = resource.data?.payload;
+  const latest = data?.latest;
+  const [metric, setMetric] = usePluginPaneState<Metric>("breadth:metric", "adLine");
+  const [selected, setSelected] = usePluginPaneState<string | null>(`breadth:selected:${fund}`, null);
+  const history = useMemo(() => data ? [...data.history, ...(data.basis === "intraday" && data.latest ? [data.latest] : [])] : [], [data]);
+  const rows = useMemo(() => [...history].reverse(), [history]);
+  const columns = useMemo(() => fitChartTableColumns(COLUMNS, width, ["unchanged", "ma20", "ma50", "coverage"]), [width]);
+  const series = useMemo(() => [staticSeries(history.map(row => ({ date: dateOf(row), observedAt: new Date(row.asOf), value: valueOf(row, metric) })), {
+    id: `breadth-${metric}`, label: metric === "adLine" ? "Cumulative advances − declines" : `% above ${metric.slice(2)}-day average`,
+    color: colors.warning, calendarSpaced: true,
+  })], [history, metric, colors.warning]);
+  const link = useChartTableSelection({ rows, getId: keyOf, getDate: dateOf, selectedId: selected ?? latest?.date ?? null, onSelect: setSelected, focused });
+  // The resource keeps a failed load as its error (stale, and a warning below), so this refresh never rejects.
+  const sessionOpen = useLiveSessionRefresh(() => resource.load(true), data?.access === "realtime" ? 15_000 : 60_000, active && visible, resource.updatedAt).live;
+  useAutoRefresh(resource.updatedAt, () => { if (active && visible && !sessionOpen) void resource.load(data?.basis === "intraday"); });
+  usePaneRefreshKey(() => void resource.reload(), { focused, enabled: active });
+  usePaneStatusFooter({ registrationId: "members:breadth", loading: !!data && resource.loading,
+    stale: !!data && (data.stale || resource.data!.stale || !!resource.error), info: latest ? [
+      { id: "as-of", asOf: true, parts: [{ text: `${data?.basis === "intraday" ? data.access === "realtime" ? "live" : "15m delayed" : "close"} ${latest.date}`, tone: "muted" }] },
+      { id: "coverage", parts: [{ text: `A/D ${latest.advanceDeclineEligible}/${latest.memberCount}`, tone: latest.advanceDeclineEligible < latest.memberCount * 0.8 ? "warning" : "muted" }] },
+    ] : [] });
+  usePaneNoticeFooter({ registrationId: "members:breadth-notices", focused, notices: [
+    ...(resource.error || resource.data?.refreshError ? [resource.error ?? resource.data!.refreshError!] : []),
+    ...(latest && [latest.advanceDeclineEligible, latest.ma20.eligible, latest.ma50.eligible, latest.ma200.eligible, latest.highLowEligible].some(n => n < latest.memberCount * 0.8)
+      ? [`Partial coverage: A/D ${latest.advanceDeclineEligible}, 20D ${latest.ma20.eligible}, 50D ${latest.ma50.eligible}, 200D ${latest.ma200.eligible}, 52W ${latest.highLowEligible} of ${latest.memberCount} members. Missing windows are excluded.`] : []),
+  ] });
+  return <PaneStatusBody subject="fund breadth" loading={!data && resource.loading} error={!data ? resource.error : null}
+    empty={!!data && !latest} emptyTitle="Breadth is awaiting daily price history.">
+    {data && latest && <DataTableView<BreadthDay> items={rows} columns={columns} rootWidth={width} rootHeight={height} focused={focused}
+      getItemKey={keyOf} selection={{ kind: "id", selectedId: selected ?? latest.date, getId: keyOf, onChange: id => setSelected(String(id)) }}
+      sortColumnId="date" sortDirection="desc" freezeFirstColumn emptyStateTitle="No daily breadth history."
+      renderCell={(row, column) => {
+        if (column.id === "date") return { text: row.date };
+        if (column.id === "coverage") return { text: `${row.advanceDeclineEligible}/${row.memberCount}` };
+        if (column.id === "ma20" || column.id === "ma50" || column.id === "ma200") return { text: percent(row[column.id].percent), value: row[column.id].percent };
+        const value = row[column.id as "advances"];
+        const eligible = column.id === "newHighs" || column.id === "newLows" ? row.highLowEligible : row.advanceDeclineEligible;
+        return { text: eligible ? decimal(value, 0) : "--", value: eligible ? value : null,
+          color: column.id === "advances" || column.id === "newHighs" ? colors.positive : column.id === "declines" || column.id === "newLows" ? colors.negative : colors.text };
+      }}
+      rootBefore={<ChartTableHeader width={width} height={height} tableRows={rows.length} tableColumns={columns}
+        query={<QueryBar width={width} meta="History uses current members (survivorship bias)." filters={[{ kind: "select", id: "chart", label: "History", value: metric, options: CHARTS, onChange: value => setMetric(value as Metric) }]} />}
+        figures={[
+          { label: "Adv / Dec", value: latest.advanceDeclineEligible ? `${latest.advances} / ${latest.declines}` : "--", detail: `${latest.unchanged} unchanged` },
+          ...([20, 50, 200] as const).map(window => ({ label: `Above ${window}D`, value: percent(latest[`ma${window}`].percent), detail: `${latest[`ma${window}`].eligible}/${latest.memberCount} covered` })),
+          { label: "52W high / low", value: latest.highLowEligible ? `${latest.newHighs} / ${latest.newLows}` : "--", detail: `${latest.highLowEligible}/${latest.memberCount} covered` },
+        ]}
+        chart={{ series, ...link, formatValue: metric === "adLine" ? value => decimal(value, 0) : percent,
+          formatAxisValue: metric === "adLine" ? value => decimal(value, 0) : percent, remoteKind: "member-breadth", empty: "History is awaiting sufficient daily bars." }} />}
+    />}
+  </PaneStatusBody>;
+}