gloomberb 0.8.1 → 0.8.2

package/src/plugins/builtin/sec/filing-documents.ts

@@ -0,0 +1,66 @@
+import type { SecFilingDocument, SecFilingItem } from "../../../types/data-provider";
+
+const SEC_EXHIBIT_TYPE_RE = /^EX[-\s]?\d/i;
+const SEC_XBRL_EXHIBIT_TYPE_RE = /^EX[-\s]?101(?:\.|$)/i;
+const SEC_NON_READABLE_DOCUMENT_RE = /\.(?:cal|def|gif|jpg|jpeg|json|lab|png|pre|sch|xsd|zip)(?:$|[?#])/i;
+const SEC_SUPPORT_DOCUMENT_TYPE_RE = /^(?:GRAPHIC|XML|ZIP|EX[-\s]?101(?:\.|$)|EX-FILING FEES)/i;
+
+export function documentContentKey(filing: SecFilingItem, document: SecFilingDocument): string {
+  return `${filing.accessionNumber}:${document.document || document.url}`;
+}
+
+export function documentContentTarget(filing: SecFilingItem, document: SecFilingDocument): SecFilingItem {
+  return {
+    ...filing,
+    accessionNumber: documentContentKey(filing, document),
+    form: document.type || filing.form,
+    primaryDocument: document.document,
+    primaryDocDescription: document.description,
+    primaryDocumentUrl: document.url,
+    filingUrl: document.url,
+  };
+}
+
+export function formatDocumentLabel(document: SecFilingDocument): string {
+  const label = document.isPrimary ? "PRIMARY" : document.type || "DOCUMENT";
+  const description = document.description
+    && document.description !== document.document
+    && document.description !== document.type
+    ? ` | ${document.description}`
+    : "";
+  const size = document.size ? ` | ${document.size}` : "";
+  return `${label.padEnd(8)} ${document.document}${description}${size}`;
+}
+
+export function formatCompactDocumentLabel(document: SecFilingDocument): string {
+  const label = document.isPrimary ? "PRIMARY" : document.type || "DOCUMENT";
+  const description = document.description
+    && document.description !== document.document
+    && document.description !== document.type
+    ? ` | ${document.description}`
+    : "";
+  return `${label} ${document.document}${description}`;
+}
+
+export function documentHeading(document: SecFilingDocument): string {
+  const label = document.type || "DOCUMENT";
+  const description = document.description
+    && document.description !== document.document
+    && document.description !== document.type
+    ? ` | ${document.description}`
+    : "";
+  return `${label} | ${document.document}${description}`;
+}
+
+export function isInlineExhibitDocument(document: SecFilingDocument): boolean {
+  const type = document.type.trim();
+  if (!SEC_EXHIBIT_TYPE_RE.test(type)) return false;
+  if (SEC_XBRL_EXHIBIT_TYPE_RE.test(type)) return false;
+  return !SEC_NON_READABLE_DOCUMENT_RE.test(document.document) && !SEC_NON_READABLE_DOCUMENT_RE.test(document.url);
+}
+
+export function isDefaultVisibleFilingDocument(document: SecFilingDocument): boolean {
+  if (document.isPrimary) return true;
+  if (isInlineExhibitDocument(document)) return true;
+  return !SEC_SUPPORT_DOCUMENT_TYPE_RE.test(document.type.trim());
+}

package/src/plugins/builtin/sec/index.tsx

@@ -1,10 +1,10 @@
 import { Text } from "../../../ui";
 import { useEffect, useMemo, useRef, useState } from "react";
 import type { GloomPlugin } from "../../../types/plugin";
-import type { SecFilingItem } from "../../../types/data-provider";
-import { useResolvedEntryValue, useSecFilingContent, useSecFilingsQuery } from "../../../market-data/hooks";
+import type { SecFilingDocument, SecFilingItem } from "../../../types/data-provider";
+import { useResolvedEntryValue, useSecFilingContent, useSecFilingDocuments, useSecFilingsQuery } from "../../../market-data/hooks";
 import { instrumentFromTicker } from "../../../market-data/request-types";
-import { usePluginPaneState } from "../../runtime";
+import { useDebouncedPluginPaneState } from "../../runtime";
 import { usePaneTicker } from "../../../state/app/context";
 import { colors } from "../../../theme/colors";
 import { FeedDataTableStackView, Spinner, useExternalLinkFooter, type FeedDataTableItem } from "../../../components";
@@ -17,6 +17,14 @@ import {
   formatFilingMetaDate,
   renderFilingNotice,
 } from "./filing-display";
+import {
+  documentContentKey,
+  documentContentTarget,
+  documentHeading,
+  formatCompactDocumentLabel,
+  isDefaultVisibleFilingDocument,
+  isInlineExhibitDocument,
+} from "./filing-documents";
 
 const SEC_FILING_LIMIT = 50;
 const OWNERSHIP_FORMS = new Set(["3", "4", "5"]);
@@ -80,6 +88,50 @@ function buildDetailBody(filing: SecFilingItem): string {
     : "No additional SEC filing description is available for this entry.";
 }
 
+function buildDetailBodyWithDocuments({
+  filing,
+  documents,
+  documentsLoading,
+  contentCache,
+  primaryContent,
+}: {
+  filing: SecFilingItem;
+  documents: SecFilingDocument[];
+  documentsLoading: boolean;
+  contentCache: Map<string, string | null>;
+  primaryContent: string;
+}): string {
+  const lines: string[] = [];
+  lines.push("Documents");
+  if (documentsLoading && documents.length === 0) {
+    lines.push("Loading filing documents...");
+  } else if (documents.length === 0) {
+    lines.push("No filing documents were listed for this filing.");
+  } else {
+    const visibleDocuments = documents.filter(isDefaultVisibleFilingDocument);
+    lines.push(...visibleDocuments.map(formatCompactDocumentLabel));
+    const hiddenCount = documents.length - visibleDocuments.length;
+    if (hiddenCount > 0) lines.push(`+ ${hiddenCount} support documents hidden`);
+  }
+
+  const exhibits = documents.filter(isInlineExhibitDocument);
+  if (exhibits.length > 0) {
+    lines.push("", "Inline Exhibits");
+    for (const document of exhibits) {
+      const key = documentContentKey(filing, document);
+      const hasContent = contentCache.has(key);
+      const content = contentCache.get(key);
+      lines.push("", documentHeading(document));
+      lines.push(hasContent
+        ? content || "Readable document content was not available for this exhibit."
+        : "Loading exhibit content...");
+    }
+  }
+
+  lines.push("", "Primary Filing Content", primaryContent);
+  return lines.join("\n");
+}
+
 function buildForm4Preview(content: string | null): string | null {
   if (!content) return null;
   const tx = parseForm4Xml(content);
@@ -134,6 +186,8 @@ function toFeedItems(
   selectedAccessionNumber: string | undefined,
   contentCache: Map<string, string | null>,
   loadingContent: boolean,
+  selectedDocuments: SecFilingDocument[],
+  loadingDocuments: boolean,
 ): FeedDataTableItem[] {
   return filings.map((filing) => {
     const displayTitle = getFilingDisplayTitle(filing);
@@ -152,6 +206,19 @@ function toFeedItems(
     const form4Detail = isOwnership && hasFetchedContent
       ? buildForm4Detail(fetchedContent ?? null, filing)
       : null;
+    const selected = filing.accessionNumber === selectedAccessionNumber;
+    const primaryDetailBody = loadingContent && selected
+      ? "Loading filing content..."
+      : form4Detail ?? fetchedContent ?? fallbackBody;
+    const detailBody = selected
+      ? buildDetailBodyWithDocuments({
+          filing,
+          documents: selectedDocuments,
+          documentsLoading: loadingDocuments,
+          contentCache,
+          primaryContent: primaryDetailBody,
+        })
+      : form4Detail ?? fallbackBody;
 
     const enrichedTitle = formDesc
       ? `${displayTitle} — ${formDesc}`
@@ -170,13 +237,7 @@ function toFeedItems(
         `Accession ${filing.accessionNumber}`,
         ...(filing.items ? [`Items ${filing.items}`] : []),
       ],
-      detailBody: filing.accessionNumber === selectedAccessionNumber
-        ? (
-            loadingContent
-              ? "Loading filing content..."
-              : form4Detail ?? fetchedContent ?? fallbackBody
-          )
-        : form4Detail ?? fallbackBody,
+      detailBody,
     };
   });
 }
@@ -184,7 +245,7 @@ function toFeedItems(
 function SecView({ width, height, focused }: { width: number; height: number; focused: boolean }) {
   const { ticker } = usePaneTicker();
   const selectionKey = `selectedIdx:${ticker?.metadata.ticker ?? "none"}`;
-  const [selectedIdx, setSelectedIdx] = usePluginPaneState<number>(selectionKey, 0);
+  const [selectedIdx, setSelectedIdx] = useDebouncedPluginPaneState<number>(selectionKey, 0);
   const [contentCache, setContentCache] = useState<Map<string, string | null>>(new Map());
   const [openItemId, setOpenItemId] = useState<string | null>(null);
   const contentFetchRef = useRef(0);
@@ -204,28 +265,67 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
     contentFetchRef.current += 1;
   }, [eligibleTicker, ticker?.metadata.exchange, ticker?.metadata.ticker]);
 
-  const selected = filings[selectedIdx];
   const openFiling = openItemId
     ? filings.find((filing) => filing.accessionNumber === openItemId) ?? null
     : null;
-  const cachedSelectedContent = selected ? contentCache.get(selected.accessionNumber) : undefined;
+  const cachedOpenContent = openFiling ? contentCache.get(openFiling.accessionNumber) : undefined;
   const filingContentEntry = useSecFilingContent(
-    selected && cachedSelectedContent === undefined ? selected : null,
+    openFiling && cachedOpenContent === undefined ? openFiling : null,
   );
   const filingContent = useResolvedEntryValue(filingContentEntry);
   const loadingContent = filingContentEntry?.phase === "loading" || filingContentEntry?.phase === "refreshing";
+  const documentsEntry = useSecFilingDocuments(openFiling ?? null);
+  const openDocuments = useResolvedEntryValue(documentsEntry) ?? [];
+  const loadingDocuments = !!openFiling && (
+    documentsEntry?.phase === "idle"
+    || documentsEntry?.phase === "loading"
+    || documentsEntry?.phase === "refreshing"
+  );
 
   useEffect(() => {
-    if (!selected) return;
-    if (cachedSelectedContent !== undefined) return;
+    if (!openFiling) return;
+    if (cachedOpenContent !== undefined) return;
     if (filingContentEntry?.phase === "error") {
-      setContentCache((prev) => new Map(prev).set(selected.accessionNumber, null));
+      setContentCache((prev) => new Map(prev).set(openFiling.accessionNumber, null));
       return;
     }
     if (filingContent !== null) {
-      setContentCache((prev) => new Map(prev).set(selected.accessionNumber, filingContent));
+      setContentCache((prev) => new Map(prev).set(openFiling.accessionNumber, filingContent));
+    }
+  }, [cachedOpenContent, filingContent, filingContentEntry?.phase, openFiling]);
+
+  const documentFetchStartedRef = useRef(new Set<string>());
+  useEffect(() => {
+    if (!openFiling || openDocuments.length === 0) return;
+    const coordinator = getSharedMarketDataCoordinator();
+    if (!coordinator) return;
+    const gen = contentFetchRef.current;
+    const documentsToFetch = openDocuments.filter((document) => {
+      if (!isInlineExhibitDocument(document)) return false;
+      const key = documentContentKey(openFiling, document);
+      return !contentCache.has(key) && !documentFetchStartedRef.current.has(key);
+    });
+    if (documentsToFetch.length === 0) return;
+
+    for (const document of documentsToFetch) {
+      documentFetchStartedRef.current.add(documentContentKey(openFiling, document));
     }
-  }, [cachedSelectedContent, filingContent, filingContentEntry?.phase, selected]);
+
+    (async () => {
+      for (const document of documentsToFetch) {
+        if (contentFetchRef.current !== gen) return;
+        const key = documentContentKey(openFiling, document);
+        try {
+          const entry = await coordinator.loadSecFilingContent(documentContentTarget(openFiling, document));
+          if (contentFetchRef.current !== gen) return;
+          setContentCache((prev) => new Map(prev).set(key, entry.data ?? entry.lastGoodData ?? null));
+        } catch {
+          if (contentFetchRef.current !== gen) return;
+          setContentCache((prev) => new Map(prev).set(key, null));
+        }
+      }
+    })();
+  }, [contentCache, openFiling, openDocuments]);
 
   useEffect(() => {
     if (filings.length > 0 && selectedIdx >= filings.length) {
@@ -235,6 +335,11 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
 
   // Background prefetch Form 4 content for enriched previews
   const prefetchStartedRef = useRef(new Set<string>());
+  useEffect(() => {
+    prefetchStartedRef.current.clear();
+    documentFetchStartedRef.current.clear();
+  }, [eligibleTicker, ticker?.metadata.exchange, ticker?.metadata.ticker]);
+
   useEffect(() => {
     if (filings.length === 0) return;
     const coordinator = getSharedMarketDataCoordinator();
@@ -288,7 +393,14 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
       width={width}
       height={height}
       focused={focused}
-      items={toFeedItems(filings, selected?.accessionNumber, contentCache, loadingContent)}
+      items={toFeedItems(
+        filings,
+        openFiling?.accessionNumber,
+        contentCache,
+        loadingContent,
+        openDocuments,
+        loadingDocuments,
+      )}
       selectedIdx={selectedIdx}
       onSelect={setSelectedIdx}
       onOpenItemIdChange={setOpenItemId}

package/src/plugins/builtin/sectors/index.tsx

@@ -71,11 +71,6 @@ function SectorPerformancePane({ focused, width, height }: PaneProps) {
     label: collection.label,
     value: collection.id,
   })), []);
-  const selectedIdx = selectedEtf
-    ? sortedRows.findIndex((row) => row.etf === selectedEtf)
-    : -1;
-  const activeIdx = selectedIdx >= 0 ? selectedIdx : (sortedRows.length > 0 ? 0 : -1);
-
   const fetchAll = useCallback(() => {
     fetchGenRef.current += 1;
     const gen = fetchGenRef.current;
@@ -189,19 +184,6 @@ function SectorPerformancePane({ focused, width, height }: PaneProps) {
     setSortPreference((current) => nextSortPreference(current, columnId));
   }, [setSortPreference]);
 
-  const selectIndex = useCallback((index: number) => {
-    const row = sortedRows[index];
-    if (row) setSelectedEtf(row.etf);
-  }, [setSelectedEtf, sortedRows]);
-
-  const selectRow = useCallback((row: SectorRow) => {
-    if (row.etf === selectedEtf) {
-      openRow(row);
-      return;
-    }
-    setSelectedEtf(row.etf);
-  }, [openRow, selectedEtf, setSelectedEtf]);
-
   const handleTableKeyDown = useCallback((event: DataTableKeyEvent) => {
     if (event.name === "r") {
       event.preventDefault?.();
@@ -291,9 +273,19 @@ function SectorPerformancePane({ focused, width, height }: PaneProps) {
   return (
     <DataTableView<SectorRow, SectorColumn>
       focused={focused}
-      selectedIndex={activeIdx}
-      onSelectIndex={selectIndex}
-      onActivateIndex={(_index, row) => openRow(row)}
+      selection={{
+        kind: "id",
+        selectedId: selectedEtf,
+        getId: (row) => row.etf,
+        onChange: (id, row, _index, reason) => {
+          if (reason === "pointer" && id === selectedEtf) {
+            openRow(row);
+            return;
+          }
+          setSelectedEtf(id);
+        },
+      }}
+      onActivate={openRow}
       onRootKeyDown={handleTableKeyDown}
       rootBefore={rootBefore}
       rootWidth={width}
@@ -305,8 +297,6 @@ function SectorPerformancePane({ focused, width, height }: PaneProps) {
       sortDirection={sortPreference.direction}
       onHeaderClick={handleHeaderClick}
       getItemKey={(row) => row.etf}
-      isSelected={(row) => row.etf === selectedEtf}
-      onSelect={selectRow}
       renderCell={renderCell}
       emptyStateTitle="No sector data available"
       showHorizontalScrollbar={false}

package/src/plugins/builtin/shared/ticker-request.ts

@@ -11,6 +11,7 @@ export function useBoundTicker() {
   const { symbol, ticker } = usePaneTicker();
   return {
     symbol,
+    ticker,
     exchange: ticker?.metadata.exchange ?? "",
     currency: ticker?.metadata.currency ?? "USD",
   };

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

@@ -344,9 +344,13 @@ export function ThirteenFPane({ focused, width, height }: PaneProps) {
         ) : (
           <Box flexGrow={1} />
         )}
-        selectedIndex={selectedIndex}
-        onSelectIndex={(_index, row) => setSelectedId(row.id)}
-        onActivateIndex={(_index, row) => openDetail(row)}
+        selection={{
+          kind: "id",
+          selectedId,
+          getId: (row) => row.id,
+          onChange: (id) => setSelectedId(id),
+        }}
+        onActivate={openDetail}
         onRootKeyDown={handleRootKeyDown}
         rootWidth={width}
         rootBefore={rootBefore}
@@ -365,9 +369,6 @@ export function ThirteenFPane({ focused, width, height }: PaneProps) {
           ));
         }}
         getItemKey={(row) => row.id}
-        isSelected={(row) => row.id === selectedId}
-        onSelect={(row) => setSelectedId(row.id)}
-        onActivate={openDetail}
         renderCell={renderBrowserCell}
         emptyStateTitle={emptyTitle}
         showHorizontalScrollbar={false}
@@ -625,11 +626,13 @@ function FundDetailView({
           ) : (
             <Box flexGrow={1} />
           )}
-          selectedIndex={selectedFilingIndex}
-          onSelectIndex={(_index, row) => setFilingSelectedId(row.id)}
-          onActivateIndex={(_index, row) => {
-            openFilingInPane(row);
+          selection={{
+            kind: "id",
+            selectedId: filingSelectedId,
+            getId: (row) => row.id,
+            onChange: (id) => setFilingSelectedId(id),
           }}
+          onActivate={openFilingInPane}
           onDetailKeyDown={(event) => {
             if (event.name !== "o" || !openFiling?.url) return false;
             event.preventDefault?.();
@@ -648,11 +651,6 @@ function FundDetailView({
             columnId === "period" || columnId === "filed" ? "desc" : "desc",
           ))}
           getItemKey={(row) => row.id}
-          isSelected={(row) => row.id === filingSelectedId}
-          onSelect={(row) => setFilingSelectedId(row.id)}
-          onActivate={(row) => {
-            openFilingInPane(row);
-          }}
           renderCell={renderTimelineCell}
           emptyStateTitle="No 13F filings."
           showHorizontalScrollbar={false}
@@ -660,8 +658,12 @@ function FundDetailView({
       ) : (
         <DataTableView<FundHoldingRow, FundHoldingColumn>
           focused={focused}
-          selectedIndex={selectedHoldingIndex}
-          onSelectIndex={(_index, row) => setHoldingSelectedId(row.id)}
+          selection={{
+            kind: "id",
+            selectedId: holdingSelectedId,
+            getId: (row) => row.id,
+            onChange: (id) => setHoldingSelectedId(id),
+          }}
           rootWidth={width}
           columns={buildHoldingColumns(width)}
           items={visibleHoldingRows}
@@ -675,8 +677,6 @@ function FundDetailView({
             ));
           }}
           getItemKey={(row) => row.id}
-          isSelected={(row) => row.id === holdingSelectedId}
-          onSelect={(row) => setHoldingSelectedId(row.id)}
           onActivate={(row) => {
             if (row.ticker) pinTicker(row.ticker, { floating: true, paneType: TICKER_RESEARCH_PANE_ID });
           }}
@@ -795,9 +795,13 @@ function FilingDetailView({
     <Box flexDirection="column" width={width} flexGrow={1} overflow="hidden">
       <DataTableView<FilingPositionRow, FilingPositionColumn>
         focused={focused}
-        selectedIndex={selectedPositionIndex}
-        onSelectIndex={(_index, row) => setSelectedPositionId(row.id)}
-        onActivateIndex={(_index, row) => openPositionTicker(row)}
+        selection={{
+          kind: "id",
+          selectedId: selectedPositionId,
+          getId: (row) => row.id,
+          onChange: (id) => setSelectedPositionId(id),
+        }}
+        onActivate={openPositionTicker}
         onRootKeyDown={handlePositionKeyDown}
         rootWidth={width}
         rootBefore={summary}
@@ -814,9 +818,6 @@ function FilingDetailView({
           ));
         }}
         getItemKey={(row) => row.id}
-        isSelected={(row) => row.id === selectedPositionId}
-        onSelect={(row) => setSelectedPositionId(row.id)}
-        onActivate={openPositionTicker}
         renderCell={renderFilingPositionCell}
         emptyStateTitle={emptyTitle}
         showHorizontalScrollbar={false}

package/src/plugins/builtin/ticker-detail/data-panes/fundamental-graph/content.tsx

@@ -137,8 +137,11 @@ export function FundamentalGraphContent({
       <StaticBarChartSurface width={width} height={chartHeight} series={chartSeries} />
       <DataTableView<FundamentalGraphRow, FundamentalColumn>
         focused={focused}
-        selectedIndex={boundedSelectedIdx}
-        onSelectIndex={(index) => setSelectedIdx(index)}
+        selection={{
+          kind: "index",
+          selectedIndex: boundedSelectedIdx,
+          onChange: (index) => setSelectedIdx(index),
+        }}
         onRootKeyDown={handleKeyDown}
         rootWidth={width}
         rootHeight={tableHeight}
@@ -148,8 +151,6 @@ export function FundamentalGraphContent({
         sortDirection="asc"
         onHeaderClick={() => {}}
         getItemKey={(row) => row.key}
-        isSelected={(_row, index) => index === boundedSelectedIdx}
-        onSelect={(_row, index) => setSelectedIdx(index)}
         renderCell={renderCell}
         emptyStateTitle={loading ? "Loading fundamentals..." : "No graph data"}
       />

package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx

@@ -172,8 +172,11 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
   return (
     <DataTableView<HistoricalPriceRow, HistoryColumn>
       focused={focused}
-      selectedIndex={boundedSelectedIdx}
-      onSelectIndex={(index) => setSelectedIdx(index)}
+      selection={{
+        kind: "index",
+        selectedIndex: boundedSelectedIdx,
+        onChange: (index) => setSelectedIdx(index),
+      }}
       onRootKeyDown={handleKeyDown}
       rootWidth={width}
       rootHeight={height}
@@ -183,8 +186,6 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
       sortDirection="desc"
       onHeaderClick={() => {}}
       getItemKey={(row) => row.key}
-      isSelected={(_row, index) => index === boundedSelectedIdx}
-      onSelect={(_row, index) => setSelectedIdx(index)}
       renderCell={renderCell}
       emptyStateTitle={loading ? "Loading historical prices..." : "No historical prices"}
     />

package/src/plugins/builtin/ticker-detail/data-panes/provider-search.tsx

@@ -121,9 +121,12 @@ export function ProviderSearchPane({ focused, width, height }: PaneProps) {
   return (
     <DataTableView<InstrumentSearchResult, DataTableColumn & { id: "symbol" | "name" | "exchange" | "type" }>
       focused={focused}
-      selectedIndex={boundedSelectedIdx}
-      onSelectIndex={(index) => setSelectedIdx(index)}
-      onActivateIndex={(_index, row) => openResult(row)}
+      selection={{
+        kind: "index",
+        selectedIndex: boundedSelectedIdx,
+        onChange: (index) => setSelectedIdx(index),
+      }}
+      onActivate={(row) => openResult(row)}
       onRootKeyDown={handleKeyDown}
       rootWidth={width}
       rootHeight={height}
@@ -133,8 +136,6 @@ export function ProviderSearchPane({ focused, width, height }: PaneProps) {
       sortDirection="asc"
       onHeaderClick={() => {}}
       getItemKey={(row, index) => `${row.providerId}:${row.symbol}:${row.exchange}:${row.type}:${index}`}
-      isSelected={(_row, index) => index === boundedSelectedIdx}
-      onSelect={(_row, index) => setSelectedIdx(index)}
       renderCell={renderCell}
       emptyStateTitle={state.loading ? "Searching..." : query ? "No search results" : "No search query"}
     />

package/src/plugins/builtin/ticker-detail/financials/tab.tsx

@@ -380,19 +380,21 @@ export function ResolvedFinancialsTab({
         bodyScrollId={bodyScrollId}
         columns={columns}
         items={rows}
-        selectedIndex={effectiveSelectedIndex}
-        onSelectIndex={(_index, row) => {
-          setSelectedRowId(row.id);
+        selection={{
+          kind: "id",
+          selectedId: selectedRowId,
+          getId: (row) => row.id,
+          onChange: (_id, row, _index, reason) => {
+            setSelectedRowId(row.id);
+            if (reason === "pointer" && row.kind === "group" && row.toggleable) {
+              toggleGroup(row.id);
+            }
+          },
         }}
         sortColumnId={null}
         sortDirection="desc"
         onHeaderClick={() => {}}
         getItemKey={(row) => row.id}
-        isSelected={(_row, index) => index === effectiveSelectedIndex}
-        onSelect={(row) => {
-          setSelectedRowId(row.id);
-          if (row.kind === "group" && row.toggleable) toggleGroup(row.id);
-        }}
         onActivate={(row) => {
           if (row.kind === "group" && row.toggleable) toggleGroup(row.id);
         }}

package/src/plugins/builtin/world-indices/index.tsx

@@ -162,10 +162,16 @@ function WorldIndicesPane({ focused, width, height }: PaneProps) {
   return (
     <DataTableView<WorldIndexTableRow, WorldIndexColumn>
       focused={focused}
-      selectedIndex={activeFlatIdx}
+      selection={{
+        kind: "id",
+        selectedId: selectedSymbol,
+        getId: (row) => row.type === "row" ? row.entry.symbol : `header-${row.region}`,
+        onChange: (_id, row, index) => {
+          if (row.type === "row") selectFlatIndex(index);
+        },
+      }}
       isNavigable={(row) => row.type === "row"}
-      onSelectIndex={selectFlatIndex}
-      onActivateIndex={(index) => openSelected(index)}
+      onActivate={(_row, index) => openSelected(index)}
       rootWidth={width}
       rootHeight={height}
       columns={columns}
@@ -174,9 +180,6 @@ function WorldIndicesPane({ focused, width, height }: PaneProps) {
       sortDirection={sortPreference.direction}
       onHeaderClick={handleHeaderClick}
       getItemKey={(row) => row.type === "header" ? `header-${row.region}` : row.entry.symbol}
-      isSelected={(row) => row.type === "row" && row.entry.symbol === selectedSymbol}
-      onSelect={(_row, index) => selectFlatIndex(index)}
-      onActivate={(_row, index) => openSelected(index)}
       renderSectionHeader={(row) => row.type === "header"
         ? { text: REGION_LABELS[row.region] }
         : null}

package/src/plugins/prediction-markets/pane.tsx

@@ -260,12 +260,16 @@ export function PredictionMarketsPane({ focused, width, height }: PaneProps) {
       rootWidth={width}
       rootHeight={height}
       rootBackgroundColor={colors.panel}
-      selectedIndex={controller.selectedIndex}
-      onSelectIndex={(_index, row) =>
-        controller.actions.setBrowseSelection(row.key, {
-          debounceDetail: true,
-        })}
-      onActivateIndex={(_index, row) =>
+      selection={{
+        kind: "id",
+        selectedId: controller.selectedRow?.key ?? null,
+        getId: (row) => row.key,
+        onChange: (key, _row, _index, reason) =>
+          controller.actions.setBrowseSelection(key, {
+            debounceDetail: reason === "keyboard",
+          }),
+      }}
+      onActivate={(row) =>
         controller.actions.openSelectedRow(row.key)}
       columns={controller.visibleColumns}
       items={controller.visibleRows}
@@ -275,9 +279,6 @@ export function PredictionMarketsPane({ focused, width, height }: PaneProps) {
       headerScrollRef={controller.headerScrollRef}
       scrollRef={controller.scrollRef}
       getItemKey={(row) => row.key}
-      isSelected={(row) => controller.selectedRow?.key === row.key}
-      onSelect={(row) => controller.actions.setBrowseSelection(row.key)}
-      onActivate={(row) => controller.actions.openSelectedRow(row.key)}
       virtualize
       renderCell={renderCell}
       emptyStateTitle="No markets matched."

package/src/plugins/registry/index.ts

@@ -147,6 +147,9 @@ export class PluginRegistry implements PluginRuntimeAccess {
   hidePane = (paneId: string) => {
     this.hidePaneFn(paneId);
   };
+  focusPane = (paneId: string) => {
+    this.focusPaneFn(paneId);
+  };
 
   getLayoutFn: (() => LayoutConfig) = () => ({ dockRoot: null, instances: [], floating: [], detached: [] });
   updateLayoutFn: ((layout: LayoutConfig) => void) = () => {};

package/src/plugins/runtime/context.tsx

@@ -33,6 +33,7 @@ export interface PluginRuntimeAccess {
   showPane(paneId: string): void;
   createPaneFromTemplate(templateId: string, options?: PaneTemplateCreateOptions): void;
   hidePane(paneId: string): void;
+  focusPane(paneId: string): void;
   openPaneSettings(paneId?: string): void;
   openPluginCommandWorkflow(commandId: string): void;
   notify(notification: AppNotificationRequest): void;