gloomberb 0.16.6 → 0.17.1

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

@@ -6,16 +6,21 @@ import { getSharedMarketDataCoordinator } from "../../../market-data/coordinator
 import { useShortcut } from "../../../react/input";
 import { isPlainKey } from "../../../utils/keyboard";
 import { instrumentFromTicker } from "../../../market-data/request-types";
-import { useDebouncedPluginPaneState } from "../../runtime";
+import { useDebouncedPluginPaneState, usePluginPaneState } from "../../runtime";
 import { usePaneSettingValue } from "../../../state/app/context";
 import type { ScrollBoxRenderable } from "../../../ui";
-import { EmptyState, FeedDataTableStackView, Spinner, StatGrid, usePaneNoticeFooter, useTableLoadMore, type FeedDataTableItem, type StatItem } from "../../../components";
+import { EmptyState, FeedDataTableStackView, QueryBar, Spinner, TickerBadgeList, usePaneNoticeFooter, useTableLoadMore, type FeedDataTableItem, type PaneHint, type QueryBarFilter } from "../../../components";
+import { displayWidth } from "../../../utils/format";
+import type { DetailFact } from "../../../components/reader/detail-reader";
+import type { ThemeColors } from "../../../theme/colors";
+import { useThemeColors } from "../../../theme/theme-context";
+import { useOpenDescription } from "../shared/open-description";
+import { toneColor } from "../shared/research-cells";
 import { mayBeUsEquityOrFundTicker, mayBeUsEquityTicker, secFilingItemCodes } from "../../../utils/sec";
-import { parseForm4Xml, transactionTypeLabel } from "../insider/insider-data";
+import { parseForm4Xml } from "../insider/insider-data";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import {
   formatFilingMetaDate,
-  buildInsiderTransactionTitle,
   buildInsiderTransactionDetailBody,
   renderFilingNotice,
 } from "./filing-display";
@@ -37,6 +42,11 @@ import { SignInWall } from "../cloud/auth-actions";
 import { ETF_FILING_FORMS, ETF_FORMS_SETTING, filterFilingsByForms, parseFormsSetting, SEC_FILING_FETCH_LIMIT } from "./forms";
 import { createSecHeadless, fundFilingsEmpty, secHeadless } from "./headless";
 import {
+  ALL_FORMS,
+  COMPANY_FORM_GROUPS,
+  filingTone,
+  filterFilingsByGroup,
+  FUND_FORM_GROUPS,
   getFilingDisplayTitle,
   getFilingColumnText,
   getFormDescription,
@@ -45,6 +55,7 @@ import {
   secIssuerLabel,
   secReportedAcceptance,
 } from "./model";
+import { rowSummary, rowSummaryTarget } from "./row-summaries";
 import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
 import { createSecFilingSearchProvider, resetSecFilingFocusRequests, useSecFilingFocusRequest } from "./command-bar-search";
 
@@ -53,6 +64,8 @@ export { secHeadless } from "./headless";
 const SEC_FILING_PAGE_SIZE = 50;
 const NO_FILINGS: SecFilingItem[] = [];
 const OWNERSHIP_FORMS = new Set(["3", "4", "5"]);
+/** At most this many rows on screen have their insider forms and fund flow notices read for their row text. */
+const OWNERSHIP_ROWS_READ = 40;
 
 function formatFiledAt(filing: SecFilingItem): string {
   return formatFilingMetaDate(filing.filingDate);
@@ -122,16 +135,6 @@ function buildDetailBodyWithDocuments({
   return lines.join("\n");
 }
 
-function buildForm4Preview(content: string | null): string | null {
-  if (!content) return null;
-  const transactions = parseForm4Xml(content);
-  const tx = transactions[0];
-  if (!tx) return null;
-  if (transactions.length === 1) return `${tx.reportedName} — ${buildInsiderTransactionTitle(tx)}`;
-  const types = [...new Set(transactions.map((transaction) => transactionTypeLabel(transaction.transactionType)))];
-  return `${tx.reportedName} — ${transactions.length} transactions: ${types.join(", ")}`;
-}
-
 function buildForm4Detail(content: string | null, filing: SecFilingItem): string {
   if (!content) return buildDetailBody(filing);
   const transactions = parseForm4Xml(content);
@@ -149,6 +152,9 @@ function buildForm4Detail(content: string | null, filing: SecFilingItem): string
 }
 
 function toFeedItems(
+  colors: ThemeColors,
+  issuerTicker: { symbol: string; open: () => void } | null,
+  showIssuer: boolean,
   filings: SecFilingItem[],
   selectedAccessionNumber: string | undefined,
   contentCache: Map<string, string | null>,
@@ -169,10 +175,10 @@ function toFeedItems(
       ? `${buildDetailBody(filing)}\n\nReadable filing content was not available for this document.`
       : buildDetailBody(filing);
 
-    // For Form 4s, build structured preview and detail from parsed XML
-    const form4Preview = isOwnership && hasFetchedContent
-      ? buildForm4Preview(fetchedContent ?? null)
-      : null;
+    // An insider form read once says who traded and how, a fund's 24F-2NT its
+    // year's flows; the row says it too.
+    const summaryTarget = rowSummaryTarget(filing);
+    const readSummary = summaryTarget ? rowSummary(filing.form, contentCache.get(summaryTarget.accessionNumber)) : null;
     const form4Detail = isOwnership && hasFetchedContent
       ? buildForm4Detail(fetchedContent ?? null, filing)
       : null;
@@ -197,13 +203,28 @@ function toFeedItems(
     const enrichedTitle = formDesc
       ? `${displayTitle} — ${formDesc}`
       : displayTitle;
+    const summary = readSummary?.title ?? getFilingColumnText(filing);
+    const items = secFilingItemCodes(filing.items);
+    const facts: DetailFact[] = [
+      { label: "Issuer", value: filing.companyName || "Name unavailable" },
+      ...(issuerTicker ? [{ label: "Ticker", value: issuerTicker.symbol, link: { label: `Open ${issuerTicker.symbol}`, onOpen: issuerTicker.open } }] : []),
+      { label: "CIK", value: filing.cik },
+      { label: "Form", value: formDesc ? `${filing.form} · ${formDesc}` : filing.form, color: toneColor(filingTone(filing, readSummary?.direction), colors) },
+      { label: "Filed", value: formatFiledAt(filing) },
+      ...(acceptedAt ? [{ label: "SEC-reported acceptance", value: acceptedAt }] : []),
+      ...(items ? [{ label: "Items", value: items }] : []),
+      { label: "Accession", value: filing.accessionNumber },
+    ];
 
     return {
       id: filing.accessionNumber,
       eyebrow: filing.form,
-      title: form4Preview || getFilingColumnText(filing),
+      eyebrowColor: toneColor(filingTone(filing, readSummary?.direction), colors),
+      // A ticker shared by several filers names the filer on each row.
+      title: showIssuer && filing.companyName ? `${filing.companyName}: ${summary}` : summary,
       timestamp: filing.filingDate,
       detailTitle: enrichedTitle,
+      detailFacts: facts,
       detailMeta: [
         secIssuerLabel(filing),
         `Filed ${formatFiledAt(filing)}`,
@@ -218,8 +239,11 @@ function toFeedItems(
   });
 }
 
-function SecView({ width, height, focused }: { width: number; height: number; focused: boolean }) {
+/** `paneType` is set for the standalone pane and absent in the DES tab, whose header already names the security. */
+function SecView({ width, height, focused, paneType }: { width: number; height: number; focused: boolean; paneType?: string }) {
   const { ticker } = usePaneTickerIdentity();
+  const colors = useThemeColors();
+  const openDescription = useOpenDescription();
   const selectionKey = `selectedIdx:${ticker?.metadata.ticker ?? "none"}`;
   const [selectedIdx, setSelectedIdx] = useDebouncedPluginPaneState<number>(selectionKey, 0);
   // The open filing is what the pane shows, so it is pane state: it restores
@@ -251,10 +275,22 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
   const issuerFilings = useResolvedEntryValue(filingsEntry) ?? NO_FILINGS;
   // The filter runs over every filing the service returned for the issuer,
   // the same list the unfiltered pane shows, not over a first page of it.
-  const filings = useMemo(
+  const formFilings = useMemo(
     () => (forms ? filterFilingsByForms(issuerFilings, forms) : issuerFilings),
     [forms, issuerFilings],
   );
+  // The fund view (ETF) has its own groups; each view keeps its own choice.
+  const groups = forms ? FUND_FORM_GROUPS : COMPANY_FORM_GROUPS;
+  const [storedGroup, setFormGroup] = usePluginPaneState<string>(forms ? "fundFormGroup" : "formGroup", ALL_FORMS);
+  const formGroup = groups.some((group) => group.value === storedGroup) ? storedGroup : ALL_FORMS;
+  // A ticker can map to more than one filer (CIK); each can be listed alone.
+  const issuers = useMemo(() => secFilingIssuers(formFilings), [formFilings]);
+  const [storedIssuer, setIssuer] = usePluginPaneState<string>("issuerCik", ALL_FORMS);
+  const issuerCik = issuers.some((issuer) => issuer.cik === storedIssuer) ? storedIssuer : ALL_FORMS;
+  const filings = useMemo(() => {
+    const grouped = filterFilingsByGroup(formFilings, groups, formGroup);
+    return issuerCik === ALL_FORMS ? grouped : grouped.filter((filing) => filing.cik === issuerCik);
+  }, [formFilings, formGroup, groups, issuerCik]);
   const filterHistoryCapped = !!forms && issuerFilings.length >= SEC_FILING_FETCH_LIMIT;
   const [visibleCount, setVisibleCount] = useState(SEC_FILING_PAGE_SIZE);
   const visibleFilings = useMemo(() => filings.slice(0, visibleCount), [filings, visibleCount]);
@@ -266,7 +302,7 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
   );
   useEffect(() => {
     setVisibleCount(SEC_FILING_PAGE_SIZE);
-  }, [ticker?.metadata.ticker, ticker?.metadata.exchange, formsSetting]);
+  }, [ticker?.metadata.ticker, ticker?.metadata.exchange, formsSetting, formGroup, issuerCik]);
   const loading = filingsEntry?.phase === "loading" || filingsEntry?.phase === "refreshing";
   // A restored or shared open filing can sit past the first page, or be gone
   // from the feed entirely.
@@ -284,7 +320,7 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
   const error = filingsEntry?.error && filingsEntry.error.reasonCode !== "NO_DATA" ? filingsEntry.error.message : null;
   // Hosted, the only filings source is Gloom Cloud, which needs an account.
   const cloudSession = useResearchCloudSession();
-  const authWall = filings.length === 0 && isCloudSessionRequired(error);
+  const authWall = formFilings.length === 0 && isCloudSessionRequired(error);
 
   const openFiling = openItemId
     ? filings.find((filing) => filing.accessionNumber === openItemId) ?? null
@@ -298,14 +334,30 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
     || documentsEntry?.phase === "refreshing"
   );
 
-  // Only the filing in view needs its content; queueing every ownership form in
-  // the list fires dozens of SEC requests the user never looks at.
+  // The open filing's content comes first. Insider forms say who traded only
+  // in their text, so the ones around the cursor are read after it, one at a
+  // time, for their rows; the rest of the list is never queued, which would
+  // fire dozens of requests for rows nobody looks at. Read text is cached.
   const selectedFiling = visibleFilings[selectedIdx];
-  const contentTargets = useMemo(() => [
+  // The rows on screen, as a share of the list so it holds for terminal rows and desktop pixels alike.
+  const [onScreen, setOnScreen] = useState({ first: 0, count: height });
+  const trackScroll = useCallback(() => {
+    loadMore();
+    const box = scrollRef.current;
+    if (!box?.viewport || !(box.scrollHeight > 0) || visibleFilings.length === 0) return;
+    const first = Math.floor((box.scrollTop / box.scrollHeight) * visibleFilings.length);
+    const count = Math.ceil((box.viewport.height / box.scrollHeight) * visibleFilings.length) + 1;
+    setOnScreen((current) => (current.first === first && current.count === count ? current : { first, count }));
+  }, [loadMore, visibleFilings.length]);
+  const nearbyOwnership = useMemo(() => [
+    ...(selectedFiling ? [selectedFiling] : []),
+    ...visibleFilings.slice(onScreen.first, onScreen.first + Math.min(OWNERSHIP_ROWS_READ, onScreen.count)),
+  ].map(rowSummaryTarget).filter((target): target is SecFilingItem => !!target), [onScreen, selectedFiling, visibleFilings]);
+  const viewedTargets = useMemo(() => [
     ...(openFiling ? [openFiling] : []),
     ...buildInlineFilingContentTargets(openFiling, openDocuments),
-    ...(selectedFiling && OWNERSHIP_FORMS.has(selectedFiling.form.trim()) ? [selectedFiling] : []),
-  ], [openDocuments, openFiling, selectedFiling]);
+  ], [openDocuments, openFiling]);
+  const contentTargets = useMemo(() => [...viewedTargets, ...nearbyOwnership], [nearbyOwnership, viewedTargets]);
   const { contentCache, contentErrors, retry: retryContent, loadingKey } = useSecFilingContentCache({
     scopeKey: `${ticker?.metadata.ticker ?? "none"}:${ticker?.metadata.exchange ?? ""}:${eligibleTicker}`,
     targets: contentTargets,
@@ -352,14 +404,24 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
     }
   }, [selectedIdx, setSelectedIdx, visibleFilings.length]);
 
+  // The pane's own ticker opens its description; a fund or equity both have one.
+  const issuerTicker = useMemo(() => (ticker && paneType ? {
+    symbol: ticker.metadata.ticker,
+    open: () => openDescription(ticker.metadata.ticker, ticker.metadata.exchange || undefined),
+  } : null), [openDescription, paneType, ticker]);
+  const hints = useMemo<PaneHint[]>(() => (issuerTicker
+    ? [{ id: "sec-description", key: "d", label: "es", title: `Open ${issuerTicker.symbol}`, onPress: issuerTicker.open }]
+    : []), [issuerTicker]);
   usePaneStatusLinkFooter({
     registrationId: "sec",
     focused,
     url: openFiling?.filingUrl,
     source: openFiling?.form,
     label: "filing",
-    loading: loading || loadingDocuments || !!loadingKey,
+    // Rows read in the background for their insiders do not hold up the pane.
+    loading: loading || loadingDocuments || (!!loadingKey && viewedTargets.some((target) => target.accessionNumber === loadingKey)),
     error: authWall ? null : error ?? detailError,
+    hints,
     showOpenHint: !!openFiling?.filingUrl,
   });
 
@@ -373,25 +435,48 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
     title: "Fund filings",
   });
 
-  // One cell per filer: a ticker can map to more than one CIK.
-  const issuerItems = useMemo<StatItem[]>(() => secFilingIssuers(filings).map((issuer) => ({
-    id: issuer.cik,
-    label: "Issuer",
-    value: issuer.companyName || "Name unavailable",
-    detail: `CIK ${issuer.cik}`,
-  })), [filings]);
+  const queryFilters = useMemo<QueryBarFilter[]>(() => [
+    {
+      id: "form",
+      label: "Form",
+      value: formGroup,
+      defaultValue: ALL_FORMS,
+      options: [{ value: ALL_FORMS, label: forms ? "All fund forms" : "All forms" }, ...groups.map((group) => ({ value: group.value, label: group.label }))],
+      onChange: (value: string) => { setFormGroup(value); setSelectedIdx(0, { immediate: true }); setOpenItemId(null); },
+    },
+    ...(issuers.length > 1 ? [{
+      id: "issuer",
+      label: "Filer",
+      value: issuerCik,
+      defaultValue: ALL_FORMS,
+      options: [{ value: ALL_FORMS, label: "All filers" }, ...issuers.map((issuer) => ({ value: issuer.cik, label: issuer.companyName || `CIK ${issuer.cik}` }))],
+      onChange: (value: string) => { setIssuer(value); setSelectedIdx(0, { immediate: true }); setOpenItemId(null); },
+    }] : []),
+  ], [formGroup, forms, groups, issuerCik, issuers, setFormGroup, setIssuer, setOpenItemId, setSelectedIdx]);
+  // The ticker and the filer once, beside the filters: every row is their filing.
+  const issuerMeta = issuers.length === 1 ? secIssuerLabel(issuers[0]!).replace(/CIK 0+/, "CIK ") : undefined;
+  const queryBar = (
+    <QueryBar
+      width={width}
+      filters={queryFilters}
+      meta={issuerMeta}
+      leading={issuerTicker
+        ? <TickerBadgeList symbols={[issuerTicker.symbol]} width={displayWidth(issuerTicker.symbol) + 2} listed onOpen={issuerTicker.open} />
+        : undefined}
+    />
+  );
 
   if (!ticker) {
     return <EmptyState title="No ticker selected." message="Select a ticker to view SEC filings." />;
   }
   if (!eligibleTicker) {
-    return renderFilingNotice(forms ? "Fund filings are only shown for US-listed funds and equities." : "SEC filings are only shown for US equities.", width);
+    return renderFilingNotice(forms ? "Fund filings are only shown for US-listed funds and equities." : "SEC filings are only shown for US equities.");
   }
   if (authWall) return <SignInWall placement="sec-signin" action="view SEC filings" needsVerification={cloudSession.needsVerification} />;
   if (loading && filings.length === 0) return <Spinner label="Loading SEC filings..." />;
-  if (error && filings.length === 0) return <EmptyState title="SEC filings unavailable." message={error} />;
-  if (filings.length === 0) {
-    return renderFilingNotice(forms ? `No fund filings for ${ticker.metadata.ticker}.` : `No recent SEC filings for ${ticker.metadata.ticker}.`, width);
+  if (error && formFilings.length === 0) return <EmptyState title="SEC filings unavailable." message={error} />;
+  if (formFilings.length === 0) {
+    return renderFilingNotice(forms ? `No fund filings for ${ticker.metadata.ticker}.` : `No recent SEC filings for ${ticker.metadata.ticker}.`);
   }
 
   return (
@@ -400,6 +485,9 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
       height={height}
       focused={focused}
       items={toFeedItems(
+        colors,
+        issuerTicker,
+        issuers.length > 1 && issuerCik === ALL_FORMS,
         visibleFilings,
         openFiling?.accessionNumber,
         contentCache,
@@ -414,12 +502,12 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
       openItemId={openItemId}
       onOpenItemIdChange={setOpenItemId}
       prefetchDetail={prefetchDocuments}
-      rootBefore={<StatGrid items={issuerItems} width={width} />}
+      rootBefore={queryBar}
       sourceLabel="Form"
       titleLabel="Filing"
-      emptyStateTitle="No SEC filings."
+      emptyStateTitle={formGroup === ALL_FORMS ? "No SEC filings." : "No filings of these forms."}
       scrollRef={scrollRef}
-      onBodyScrollActivity={loadMore}
+      onBodyScrollActivity={trackScroll}
     />
   );
 }

package/src/plugins/builtin/sec/model.ts

@@ -46,11 +46,77 @@ export function getFilingDisplayTitle(filing: SecFilingItem): string {
   return description ? `${formLabel} | ${description}` : formLabel;
 }
 
-/** The adjacent FORM column already identifies the form. Keep its meaning here. */
+/**
+ * 8-K items in a few words, as a reader scans them: what happened, not the
+ * SEC's full caption. 9.01 (exhibits) comes with most reports and says little.
+ */
+const CURRENT_REPORT_ITEMS: Record<string, string> = {
+  "1.01": "Material agreement",
+  "1.02": "Agreement terminated",
+  "1.03": "Bankruptcy or receivership",
+  "1.04": "Mine safety",
+  "1.05": "Cybersecurity incident",
+  "2.01": "Acquisition or disposal",
+  "2.02": "Results of operations",
+  "2.03": "New financial obligation",
+  "2.04": "Obligation accelerated",
+  "2.05": "Exit or restructuring costs",
+  "2.06": "Impairment",
+  "3.01": "Listing standard notice",
+  "3.02": "Unregistered equity sale",
+  "3.03": "Shareholder rights modified",
+  "4.01": "Auditor change",
+  "4.02": "Non-reliance on financials",
+  "5.01": "Change in control",
+  "5.02": "Officer or director change",
+  "5.03": "Charter or bylaws amended",
+  "5.04": "Benefit plan trading suspension",
+  "5.05": "Code of ethics change",
+  "5.06": "Shell company status change",
+  "5.07": "Shareholder vote results",
+  "5.08": "Director nominations",
+  "7.01": "Regulation FD disclosure",
+  "8.01": "Other events",
+  "9.01": "Exhibits",
+};
+
+const isCurrentReport = (form: string) => /^(?:8-K|6-K)(?:\/A)?$/i.test(form.trim());
+
+/** `Results of operations; Exhibits` from `2.02,9.01`; exhibits only when nothing else is reported. */
+function currentReportItemsText(items: string | null | undefined): string | null {
+  const codes = (secFilingItemCodes(items) ?? "").split(",").filter(Boolean);
+  const named = codes.filter((code) => code !== "9.01" || codes.length === 1).map((code) => CURRENT_REPORT_ITEMS[code] ?? `Item ${code}`);
+  return named.length > 0 ? named.join("; ") : null;
+}
+
+/**
+ * The period a 10-K or 10-Q covers, read from its inline XBRL document name
+ * (`aapl-20260627.htm`), which by convention carries the period end. A date
+ * after the filing, or more than 15 months before it, is not taken.
+ */
+function periodicReportPeriod(filing: Pick<SecFilingItem, "form" | "primaryDocument" | "filingDate">): string | null {
+  if (!/^(?:10-K|10-Q|10-KT|10-QT|20-F|40-F)(?:\/A)?$/i.test(filing.form.trim())) return null;
+  const match = /^[a-z0-9.]+-(\d{4})(\d{2})(\d{2})(?:x\d+)?\.html?$/i.exec(filing.primaryDocument?.split("/").pop() ?? "");
+  if (!match) return null;
+  const end = new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3])));
+  const iso = `${match[1]}-${match[2]}-${match[3]}`;
+  const filed = new Date(filing.filingDate).getTime();
+  if (!Number.isFinite(end.getTime()) || end.toISOString().slice(0, 10) !== iso || !Number.isFinite(filed)) return null;
+  const days = (filed - end.getTime()) / 86_400_000;
+  return days >= 0 && days <= 460 ? iso : null;
+}
+
+/** The adjacent FORM column already identifies the form. Keep its meaning here: what the filing reports. */
 export function getFilingColumnText(filing: SecFilingItem): string {
   const description = getMeaningfulPrimaryDescription(filing);
   const meaning = getFormDescription(filing.form);
-  if (!description) return meaning || "Filing";
+  if (!description) {
+    const items = isCurrentReport(filing.form) ? currentReportItemsText(filing.items) : null;
+    if (items) return /\/A$/i.test(filing.form.trim()) ? `${items} (amended)` : items;
+    const period = periodicReportPeriod(filing);
+    if (period) return `${meaning || "Report"}, period ended ${period}`;
+    return meaning || "Filing";
+  }
   return meaning && normalizeComparableText(description) !== normalizeComparableText(meaning)
     ? `${description} | ${meaning}`
     : description;
@@ -99,6 +165,22 @@ export function getFormDescription(form: string): string {
     case "NPORT-P": return "Monthly Portfolio Holdings Report";
     case "NPORT-EX": return "Portfolio Holdings Exhibit";
     case "24F-2NT": return "Annual Notice of Securities Sold";
+    case "SD": return "Conflict Minerals Report";
+    case "S-3": return "Shelf Registration";
+    case "S-8": return "Employee Plan Registration";
+    case "FWP": return "Free Writing Prospectus";
+    case "DEFA14A": return "Additional Proxy Materials";
+    case "PX14A6G": return "Shareholder Exempt Solicitation";
+    case "11-K": return "Employee Plan Annual Report";
+    case "ARS": return "Annual Report to Shareholders";
+    case "NT 10-K": return "Late Annual Report Notice";
+    case "NT 10-Q": return "Late Quarterly Report Notice";
+    case "25-NSE": return "Delisting Notice";
+    case "6-K": return "Foreign Issuer Current Report";
+    case "40-F": return "Annual Report (Canadian)";
+    case "424B2":
+    case "424B3":
+    case "424B5": return "Prospectus";
     default: {
       const base = normalized.endsWith("/A") ? getFormDescription(normalized.slice(0, -2)) : "";
       return base ? `${base} (Amended)` : "";
@@ -106,6 +188,70 @@ export function getFormDescription(form: string): string {
   }
 }
 
+/** The groups of the Form filter: a reader looks for reports, events or insiders, not one form code. */
+export interface FormGroup {
+  value: string;
+  label: string;
+  matches: (form: string) => boolean;
+}
+
+const upper = (form: string) => form.trim().toUpperCase().replace(/\/A$/, "");
+const oneOf = (...forms: string[]) => (form: string) => forms.includes(upper(form));
+
+export const ALL_FORMS = "all";
+
+export const COMPANY_FORM_GROUPS: readonly FormGroup[] = [
+  { value: "periodic", label: "Annual & quarterly", matches: oneOf("10-K", "10-Q", "10-KT", "10-QT", "20-F", "40-F", "NT 10-K", "NT 10-Q", "NT 20-F") },
+  { value: "current", label: "Current reports", matches: (form) => isCurrentReport(form) || upper(form) === "8-K12B" },
+  { value: "insider", label: "Insider", matches: oneOf("3", "4", "5", "144") },
+  { value: "ownership", label: "13D / 13G", matches: (form) => /^(?:SC|SCHEDULE) 13[DG]$/.test(upper(form)) },
+  { value: "proxy", label: "Proxy", matches: (form) => /^(?:DEF|DEFA|DEFM|PRE|PREM|DFAN)14[AC]$/.test(upper(form).replace(/\s+/g, "")) },
+  { value: "offerings", label: "Registrations & offerings", matches: (form) => /^(?:S-\d|F-\d|424B\d|FWP|S-8 POS|POS AM|425)/.test(upper(form)) },
+];
+
+export const FUND_FORM_GROUPS: readonly FormGroup[] = [
+  { value: "reports", label: "Shareholder reports", matches: oneOf("N-CSR", "N-CSRS", "N-30D") },
+  { value: "holdings", label: "Holdings", matches: oneOf("NPORT-P", "NPORT-EX") },
+  { value: "prospectus", label: "Prospectus & registration", matches: oneOf("N-1A", "N-2", "485APOS", "485BPOS", "485BXT", "497", "497J", "497K") },
+  { value: "census", label: "Flows & census", matches: oneOf("N-CEN", "24F-2NT") },
+];
+
+/** Filings in a group; `all` and an unknown group keep every filing. */
+export function filterFilingsByGroup<T extends { form: string }>(filings: readonly T[], groups: readonly FormGroup[], value: string): T[] {
+  const group = groups.find((entry) => entry.value === value);
+  return group ? filings.filter((filing) => group.matches(filing.form)) : [...filings];
+}
+
+export type FilingTone = "positive" | "negative" | "warning" | "accent" | "muted" | "text";
+
+/**
+ * How much a filing matters, in the tone every research pane gives a state:
+ * events that can sink a company (bankruptcy, delisting, non-reliance, a late
+ * report) red, an insider sale red and a purchase green, a planned sale, an
+ * activist stake, a management or auditor change amber, the periodic reports,
+ * earnings and fund shareholder reports in the accent, and routine paperwork
+ * quiet. A fund's annual notice of securities sold reads green for a year of
+ * net creations and red for net redemptions. The form text never changes, so
+ * the colour is not the only signal.
+ */
+export function filingTone(filing: Pick<SecFilingItem, "form" | "items">, insiderDirection?: "buy" | "sell" | null): FilingTone {
+  const form = upper(filing.form);
+  if (/^NT /.test(form)) return "negative";
+  if (isCurrentReport(filing.form)) {
+    const codes = (secFilingItemCodes(filing.items) ?? "").split(",");
+    if (codes.some((code) => code === "1.03" || code === "3.01" || code === "4.02")) return "negative";
+    if (codes.some((code) => ["2.05", "2.06", "4.01", "5.01", "5.02", "1.05"].includes(code))) return "warning";
+    if (codes.includes("2.02")) return "accent";
+    return "text";
+  }
+  if (form === "4" || form === "5" || form === "24F-2NT") return insiderDirection === "sell" ? "negative" : insiderDirection === "buy" ? "positive" : form === "24F-2NT" ? "muted" : "text";
+  if (form === "144") return "warning";
+  if (/13D$/.test(form)) return "warning";
+  if (/^(?:10-K|10-Q|10-KT|10-QT|20-F|40-F|N-CSR|N-CSRS|N-30D|N-1A|N-2)$/.test(form)) return "accent";
+  if (/^(?:3|SC 13G|SCHEDULE 13G|SD|497|497J|497K|485BPOS|485BXT|NPORT-P|NPORT-EX)$/.test(form)) return "muted";
+  return "text";
+}
+
 export function buildSecFilingRows(filings: readonly SecFilingItem[]) {
   return filings.map((filing) => {
     return {

package/src/plugins/builtin/sec/row-summaries.ts

@@ -0,0 +1,105 @@
+import type { SecFilingItem } from "../../../types/data-provider";
+import { decodeHtmlEntities } from "../../../utils/html-entities";
+import { formatCompact } from "../../../utils/format";
+import { parseForm4Xml, transactionTypeLabel } from "../insider/insider-data";
+import { buildInsiderTransactionTitle } from "./filing-display";
+
+/**
+ * What a small XML filing's own text says, for its row: who traded and which
+ * way on an insider form, how much money came in or went out on a fund's
+ * annual notice of securities sold.
+ */
+export interface RowSummary {
+  title: string;
+  /** An open-market purchase or sale, or a fund's net creations or redemptions. */
+  direction: "buy" | "sell" | null;
+}
+
+const OWNERSHIP_FORMS = /^(?:3|4|5|144)(?:\/A)?$/i;
+const FUND_FLOW_FORM = /^24F-2NT(?:\/A)?$/i;
+
+const isOwnershipForm = (form: string) => OWNERSHIP_FORMS.test(form.trim());
+
+/**
+ * The document a row is read from. Gloom Cloud returns a Form 3, 4 or 5 as
+ * its XML; a Form 144 and a 24F-2NT come as the SEC's rendered page unless
+ * asked for their XML, which a separate key keeps apart from the page the
+ * open filing shows. Other forms are not read for their rows.
+ */
+export function rowSummaryTarget(filing: SecFilingItem): SecFilingItem | null {
+  const form = filing.form.trim();
+  if (!isOwnershipForm(form) && !FUND_FLOW_FORM.test(form)) return null;
+  if (/^[345](?:\/A)?$/i.test(form)) return filing;
+  const url = filing.primaryDocumentUrl?.replace(/\/xsl[^/]+\//, "/");
+  if (!url || url === filing.primaryDocumentUrl) return null;
+  const document = url.split("/").pop() ?? "primary_doc.xml";
+  return { ...filing, accessionNumber: `${filing.accessionNumber}:${document}`, primaryDocument: document, primaryDocumentUrl: url, filingUrl: url };
+}
+
+function tagText(xml: string, tag: string): string {
+  const match = new RegExp(`<(?:[\\w.-]+:)?${tag}(?:\\s[^>]*)?>([\\s\\S]*?)<\\/(?:[\\w.-]+:)?${tag}\\s*>`, "i").exec(xml);
+  return decodeHtmlEntities((match?.[1] ?? "").replace(/<[^>]*>/g, "").trim());
+}
+
+const money = (value: number) => `$${formatCompact(value)}`;
+
+/**
+ * A Form 144 is a notice that someone means to sell: who, how many shares
+ * and what they were worth when it was filed.
+ */
+function form144Summary(xml: string): RowSummary | null {
+  const name = tagText(xml, "nameOfPersonForWhoseAccountTheSecuritiesAreToBeSold");
+  if (!name) return null;
+  const shares = Number(tagText(xml, "noOfUnitsSold"));
+  const value = Number(tagText(xml, "aggregateMarketValue"));
+  const amount = [
+    Number.isFinite(shares) && shares > 0 ? `${formatCompact(shares)} shares` : "",
+    Number.isFinite(value) && value > 0 ? `(${money(value)})` : "",
+  ].filter(Boolean).join(" ");
+  return { title: `${name}: proposed sale${amount ? ` of ${amount}` : ""}`, direction: null };
+}
+
+/** The reporting owner of a Form 3, which lists holdings and no transactions. */
+function initialOwnershipSummary(xml: string): RowSummary | null {
+  const name = tagText(xml, "rptOwnerName");
+  return name ? { title: `${name}: initial holdings`, direction: null } : null;
+}
+
+const signedMoney = (value: number) => `${value < 0 ? "-" : "+"}${money(Math.abs(value))}`;
+
+/**
+ * A fund's 24F-2NT: what it sold (created) and redeemed over its fiscal year,
+ * and the difference, which is the year's net flow.
+ */
+function fundFlowSummary(xml: string): RowSummary | null {
+  const sold = Number(tagText(xml, "aggregateSalePriceOfSecuritiesSold"));
+  const redeemed = Number(tagText(xml, "aggregatePriceOfSecuritiesRedeemedOrRepurchasedInFiscalYear"));
+  if (!tagText(xml, "aggregateSalePriceOfSecuritiesSold") || !Number.isFinite(sold) || !Number.isFinite(redeemed)) return null;
+  const yearEnd = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(tagText(xml, "lastDayOfFiscalYear"));
+  const net = sold - redeemed;
+  return {
+    title: `${yearEnd ? `Year to ${yearEnd[3]}-${yearEnd[1]}-${yearEnd[2]}: ` : ""}net flow ${signedMoney(net)} (sold ${money(sold)}, redeemed ${money(redeemed)})`,
+    direction: net > 0 ? "buy" : net < 0 ? "sell" : null,
+  };
+}
+
+/**
+ * The row text of a filing whose content has been read, or null when it was
+ * not read or says nothing a row can use. An insider form with one
+ * transaction says it in full; one with several lists their kinds.
+ */
+export function rowSummary(form: string, content: string | null | undefined): RowSummary | null {
+  if (!content) return null;
+  if (FUND_FLOW_FORM.test(form.trim())) return fundFlowSummary(content);
+  if (!isOwnershipForm(form)) return null;
+  const base = form.trim().replace(/\/A$/i, "");
+  if (base === "144") return form144Summary(content);
+  const transactions = parseForm4Xml(content);
+  const first = transactions[0];
+  if (!first) return base === "3" ? initialOwnershipSummary(content) : null;
+  const codes = new Set(transactions.map((transaction) => transaction.transactionType));
+  const direction = codes.has("P") && !codes.has("S") ? "buy" : codes.has("S") && !codes.has("P") ? "sell" : null;
+  if (transactions.length === 1) return { title: `${first.reportedName}: ${buildInsiderTransactionTitle(first)}`, direction };
+  const kinds = [...new Set(transactions.map((transaction) => transactionTypeLabel(transaction.transactionType)))];
+  return { title: `${first.reportedName}: ${transactions.length} transactions, ${kinds.join(", ")}`, direction };
+}

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

@@ -395,6 +395,8 @@ export const sectorsModule: PluginModule = {
       name: "Sector Performance",
       icon: "S",
       component: SectorPerformancePane,
+      // BI and THEM open this pane: THEM sets the theme param; the ETF lists are preferences.
+      identitySettings: [],
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 82, height: 18 },

package/src/plugins/builtin/sectors/sector-model.ts

@@ -7,7 +7,7 @@ import { mergePriceHistoryIntegrity, pricePointIntegrity, type PriceHistoryInteg
 import {
   getExtendedSessionDisplay,
   getRegularSessionDisplay,
-  marketStateLabel,
+  extendedSessionStateLabel,
   type ExtendedSession,
 } from "../../../market-data/market/status";
 import {
@@ -359,7 +359,7 @@ export function buildSectorColumns(width: number, extendedSessions: readonly Ext
   const extendedColumns = extendedSessions.map((session): SectorColumn => ({
     id: session === "PRE" ? "preMarket" : "afterHours",
     // Named for the session it trades in, as the header labels it.
-    label: marketStateLabel(session),
+    label: extendedSessionStateLabel(session),
     width: EXTENDED_COLUMN_WIDTH,
     align: "right",
   }));