gloomberb 0.8.1 → 0.9.0

package/src/components/ui/remote-image.tsx

@@ -1,6 +1,5 @@
 import { Box, ImageSurface, Text } from "../../ui";
 import { colors } from "../../theme/colors";
-import { ExternalLinkText } from "./external-link";
 import { normalizedHttpUrl } from "../../utils/url";
 
 export interface RemoteImageProps {
@@ -11,13 +10,6 @@ export interface RemoteImageProps {
   label?: string;
 }
 
-function truncate(value: string, width: number): string {
-  if (width <= 0) return "";
-  if (value.length <= width) return value;
-  if (width <= 3) return value.slice(0, width);
-  return `${value.slice(0, width - 3)}...`;
-}
-
 export function RemoteImage({
   src,
   alt = "Image",
@@ -37,13 +29,8 @@ export function RemoteImage({
       height={Math.max(4, height)}
       objectFit="contain"
     >
-      <Box flexDirection="column" gap={1}>
+      <Box flexDirection="column">
         <Text fg={colors.textDim}>{label}</Text>
-        <ExternalLinkText
-          url={imageUrl}
-          label={truncate(imageUrl, resolvedWidth)}
-          color={colors.textBright}
-        />
       </Box>
     </ImageSurface>
   );

package/src/components/ui/shortcut-hint.tsx

@@ -1,5 +1,6 @@
 import { StyledText, Text, TextAttributes } from "../../ui";
 import { colors } from "../../theme/colors";
+import { useRef } from "react";
 
 type ShortcutHintMouseEvent = {
   stopPropagation?: () => void;
@@ -36,6 +37,17 @@ export function ShortcutHint({
   const keyColor = disabled ? colors.textMuted : colors.textBright;
   const labelColor = disabled ? colors.textMuted : colors.textDim;
   const keyText = `[${hotkey}]`;
+  const triggerMouseDownRef = useRef(false);
+  const startPress = (event?: ShortcutHintMouseEvent) => {
+    triggerMouseDownRef.current = true;
+    stopMouseEvent(event);
+  };
+  const finishPress = (event?: ShortcutHintMouseEvent) => {
+    const startedOnTrigger = triggerMouseDownRef.current;
+    triggerMouseDownRef.current = false;
+    if (startedOnTrigger) onPress?.(event);
+    else stopMouseEvent(event);
+  };
 
   return (
     <Text
@@ -47,8 +59,8 @@ export function ShortcutHint({
       ])}
       fg={disabled ? colors.textMuted : colors.textDim}
       attributes={interactive ? TextAttributes.BOLD : 0}
-      onMouseDown={interactive ? stopMouseEvent : undefined}
-      onMouseUp={interactive ? onPress : undefined}
+      onMouseDown={interactive ? startPress : undefined}
+      onMouseUp={interactive ? finishPress : undefined}
       {...(dataGloomRole ? { "data-gloom-role": dataGloomRole } : {})}
     />
   );

package/src/components/ui/table-layout.test.ts

@@ -27,7 +27,7 @@ describe("table layout", () => {
     ]);
 
     expect(template).toBe(
-      "minmax(4ch, 4ch) minmax(14ch, 40fr) minmax(8ch, 24ch) minmax(5ch, 5ch)",
+      "minmax(calc(4 * var(--cell-w)), calc(4 * var(--cell-w))) minmax(calc(14 * var(--cell-w)), 40fr) minmax(calc(8 * var(--cell-w)), calc(24 * var(--cell-w))) minmax(calc(5 * var(--cell-w)), calc(5 * var(--cell-w)))",
     );
   });
 
@@ -37,6 +37,6 @@ describe("table layout", () => {
       { width: 8, align: "right" },
     ]);
 
-    expect(template).toBe("minmax(8ch, 12fr) minmax(8ch, 8fr)");
+    expect(template).toBe("minmax(calc(8 * var(--cell-w)), 12fr) minmax(calc(8 * var(--cell-w)), 8fr)");
   });
 });

package/src/components/ui/table-layout.ts

@@ -8,6 +8,7 @@ export interface TableWidthColumn {
 }
 
 const TRAILING_COLUMN_GUTTER_WIDTH = 1;
+const WEB_CELL_UNIT = "var(--cell-w)";
 
 export function getTableWidth(columns: readonly TableWidthColumn[]): number {
   return columns.reduce((sum, column) => sum + column.width + 1, 2);
@@ -57,15 +58,20 @@ function columnFlexWeight(column: TableWidthColumn): number {
   return flexGrow > 0 ? baseWeight * Math.max(1, flexGrow) : baseWeight;
 }
 
+function cellWidthCss(width: number): string {
+  return `calc(${width} * ${WEB_CELL_UNIT})`;
+}
+
 export function buildTableGridTemplateColumns(columns: readonly TableWidthColumn[]): string {
   const hasFlexColumn = columns.some((column) => (column.flexGrow ?? 0) > 0);
   return columns
     .map((column) => {
       const width = normalizedColumnWidth(column);
+      const minWidth = cellWidthCss(columnMinCh(column));
       if (!hasFlexColumn || (column.flexGrow ?? 0) > 0) {
-        return `minmax(${columnMinCh(column)}ch, ${columnFlexWeight(column)}fr)`;
+        return `minmax(${minWidth}, ${columnFlexWeight(column)}fr)`;
       }
-      return `minmax(${columnMinCh(column)}ch, ${width}ch)`;
+      return `minmax(${minWidth}, ${cellWidthCss(width)})`;
     })
     .join(" ");
 }

package/src/components/ui/tabs.tsx

@@ -30,6 +30,7 @@ export interface TabsProps {
   onAdd?: () => void;
   focused?: boolean;
   keyboardNavigation?: boolean;
+  scrollable?: boolean;
 }
 
 const WHEEL_DELTA_PER_CELL = 8;
@@ -45,9 +46,16 @@ export function Tabs({
   onAdd,
   focused = false,
   keyboardNavigation = true,
+  scrollable = true,
 }: TabsProps) {
   const ui = useUiHost();
   const NativeTabs = ui.Tabs;
+  const navigationValueRef = useRef<string | null>(activeValue);
+  const renderedActiveValueRef = useRef<string | null>(activeValue);
+  if (renderedActiveValueRef.current !== activeValue) {
+    renderedActiveValueRef.current = activeValue;
+    navigationValueRef.current = activeValue;
+  }
   const palette = {
     activeFg: variant === "bare" ? colors.textBright : colors.text,
     inactiveFg: colors.textDim,
@@ -62,18 +70,26 @@ export function Tabs({
     closeFg: colors.textMuted,
     addFg: colors.textMuted,
   };
+  const handleSelect = useCallback((value: string) => {
+    navigationValueRef.current = value;
+    onSelect(value);
+  }, [onSelect]);
+
   const selectAdjacentTab = useCallback((direction: -1 | 1) => {
     const enabledTabs = tabs.filter((tab) => !tab.disabled);
     if (enabledTabs.length === 0) return;
 
-    const activeIndex = enabledTabs.findIndex((tab) => tab.value === activeValue);
+    const navigationValue = enabledTabs.some((tab) => tab.value === navigationValueRef.current)
+      ? navigationValueRef.current
+      : activeValue;
+    const activeIndex = enabledTabs.findIndex((tab) => tab.value === navigationValue);
     const nextIndex = activeIndex >= 0
       ? Math.max(0, Math.min(activeIndex + direction, enabledTabs.length - 1))
       : direction > 0 ? 0 : enabledTabs.length - 1;
     const nextTab = enabledTabs[nextIndex];
-    if (!nextTab || nextTab.value === activeValue) return;
-    onSelect(nextTab.value);
-  }, [activeValue, onSelect, tabs]);
+    if (!nextTab || nextTab.value === navigationValue) return;
+    handleSelect(nextTab.value);
+  }, [activeValue, handleSelect, tabs]);
 
   useShortcut((event) => {
     if (event.ctrl || event.meta || event.alt || event.targetEditable) return;
@@ -96,7 +112,7 @@ export function Tabs({
       <NativeTabs
         tabs={tabs}
         activeValue={activeValue}
-        onSelect={onSelect}
+        onSelect={handleSelect}
         compact={compact}
         variant={variant}
         closeMode={closeMode}
@@ -111,12 +127,13 @@ export function Tabs({
     <OpenTuiTabs
       tabs={tabs}
       activeValue={activeValue}
-      onSelect={onSelect}
+      onSelect={handleSelect}
       compact={compact}
       variant={variant}
       closeMode={closeMode}
       addLabel={addLabel}
       onAdd={onAdd}
+      scrollable={scrollable}
       palette={palette}
     />
   );
@@ -140,6 +157,7 @@ function OpenTuiTabs({
   closeMode = "always",
   addLabel = "+",
   onAdd,
+  scrollable = true,
   palette,
 }: TabsProps & {
   palette: {
@@ -213,6 +231,96 @@ function OpenTuiTabs({
     scrollBox.scrollTo({ x: nextLeft, y: scrollBox.scrollTop });
   };
 
+  const tabRow = (
+    <Box flexDirection="row" width={totalWidth} height={1}>
+      {tabs.map((tab, index) => {
+        const active = tab.value === activeValue;
+        const hovered = hoveredValue === tab.value && !tab.disabled;
+        const tabWidth = tabWidths[index] ?? tab.label.length + 2;
+        const showClose = !!tab.onClose && (closeMode === "always" || active);
+        const attributes = (active ? TextAttributes.BOLD : 0)
+          | (variant === "underline" && !compact && (active || hovered) ? TextAttributes.UNDERLINE : 0);
+        const startHover = tab.disabled
+          ? undefined
+          : () => {
+              setHoveredValue((current) => (current === tab.value ? current : tab.value));
+            };
+        const endHover = tab.disabled
+          ? undefined
+          : () => {
+              setHoveredValue((current) => (current === tab.value ? null : current));
+            };
+        const selectTab = tab.disabled
+          ? undefined
+          : (event: TabPointerEvent) => {
+              if (event.button === 2 && tab.onContextMenu) {
+                event.preventDefault?.();
+                event.stopPropagation?.();
+                tab.onContextMenu(tab.value, event);
+                return;
+              }
+              event.preventDefault();
+              event.stopPropagation?.();
+              onSelect(tab.value);
+            };
+
+        return (
+          <Box
+            key={tab.value}
+            width={tabWidth}
+            height={1}
+            flexDirection="row"
+            backgroundColor={active && variant === "pill" ? palette.activeBg : hovered ? palette.hoverBg : undefined}
+            onMouseOver={startHover}
+            onMouseMove={startHover}
+            onMouseOut={endHover}
+            onMouseDown={selectTab}
+            onDoubleClick={tab.disabled || !tab.onDoubleClick ? undefined : () => tab.onDoubleClick?.(tab.value)}
+          >
+            <Text
+              fg={tab.disabled ? palette.disabledFg : active && variant === "pill" ? palette.activePillFg : active ? palette.activeFg : hovered ? palette.hoverFg : palette.inactiveFg}
+              attributes={attributes}
+              onMouseDown={selectTab}
+            >
+              {` ${tab.label} `}
+            </Text>
+            {showClose && (
+              <Text
+                fg={active && variant === "pill" ? palette.activePillFg : palette.closeFg}
+                onMouseDown={(event: any) => {
+                  event.preventDefault?.();
+                  event.stopPropagation?.();
+                  tab.onClose?.(tab.value);
+                }}
+              >
+                {"x "}
+              </Text>
+            )}
+          </Box>
+        );
+      })}
+      {onAdd && (
+        <Box
+          width={addWidth}
+          height={1}
+          backgroundColor={hoveredValue === "__add__" ? palette.hoverBg : undefined}
+          onMouseMove={() => setHoveredValue((current) => (current === "__add__" ? current : "__add__"))}
+          onMouseOut={() => setHoveredValue((current) => (current === "__add__" ? null : current))}
+          onMouseDown={(event: TabPointerEvent) => {
+            event.preventDefault();
+            onAdd();
+          }}
+        >
+          <Text fg={hoveredValue === "__add__" ? palette.hoverFg : palette.addFg}>
+            {` ${addLabel} `}
+          </Text>
+        </Box>
+      )}
+    </Box>
+  );
+
+  if (!scrollable) return tabRow;
+
   return (
     <ScrollBox
       ref={scrollRef}
@@ -223,86 +331,7 @@ function OpenTuiTabs({
       horizontalScrollbarOptions={{ visible: false }}
       onMouseScroll={handleMouseScroll}
     >
-      <Box flexDirection="row" width={totalWidth} height={1}>
-        {tabs.map((tab, index) => {
-          const active = tab.value === activeValue;
-          const hovered = hoveredValue === tab.value && !tab.disabled;
-          const tabWidth = tabWidths[index] ?? tab.label.length + 2;
-          const showClose = !!tab.onClose && (closeMode === "always" || active);
-          const attributes = (active ? TextAttributes.BOLD : 0)
-            | (variant === "underline" && !compact && (active || hovered) ? TextAttributes.UNDERLINE : 0);
-          const startHover = tab.disabled
-            ? undefined
-            : () => {
-                setHoveredValue((current) => (current === tab.value ? current : tab.value));
-              };
-          const endHover = tab.disabled
-            ? undefined
-            : () => {
-                setHoveredValue((current) => (current === tab.value ? null : current));
-              };
-
-          return (
-            <Box
-              key={tab.value}
-              width={tabWidth}
-              height={1}
-              flexDirection="row"
-              backgroundColor={active && variant === "pill" ? palette.activeBg : hovered ? palette.hoverBg : undefined}
-              onMouseOver={startHover}
-              onMouseMove={startHover}
-              onMouseOut={endHover}
-              onMouseDown={tab.disabled ? undefined : (event: TabPointerEvent) => {
-                if (event.button === 2 && tab.onContextMenu) {
-                  event.preventDefault?.();
-                  event.stopPropagation?.();
-                  tab.onContextMenu(tab.value, event);
-                  return;
-                }
-                event.preventDefault();
-                onSelect(tab.value);
-              }}
-              onDoubleClick={tab.disabled || !tab.onDoubleClick ? undefined : () => tab.onDoubleClick?.(tab.value)}
-            >
-              <Text
-                fg={tab.disabled ? palette.disabledFg : active && variant === "pill" ? palette.activePillFg : active ? palette.activeFg : hovered ? palette.hoverFg : palette.inactiveFg}
-                attributes={attributes}
-              >
-                {` ${tab.label} `}
-              </Text>
-              {showClose && (
-                <Text
-                  fg={active && variant === "pill" ? palette.activePillFg : palette.closeFg}
-                  onMouseDown={(event: any) => {
-                    event.preventDefault?.();
-                    event.stopPropagation?.();
-                    tab.onClose?.(tab.value);
-                  }}
-                >
-                  {"x "}
-                </Text>
-              )}
-            </Box>
-          );
-        })}
-        {onAdd && (
-          <Box
-            width={addWidth}
-            height={1}
-            backgroundColor={hoveredValue === "__add__" ? palette.hoverBg : undefined}
-            onMouseMove={() => setHoveredValue((current) => (current === "__add__" ? current : "__add__"))}
-            onMouseOut={() => setHoveredValue((current) => (current === "__add__" ? null : current))}
-            onMouseDown={(event: TabPointerEvent) => {
-              event.preventDefault();
-              onAdd();
-            }}
-          >
-            <Text fg={hoveredValue === "__add__" ? palette.hoverFg : palette.addFg}>
-              {` ${addLabel} `}
-            </Text>
-          </Box>
-        )}
-      </Box>
+      {tabRow}
     </ScrollBox>
   );
 }

package/src/components/ui/ui.test.tsx

@@ -151,6 +151,7 @@ function DataTableHorizontalScrollHarness({
     <DataTableView
       rootWidth={containerWidth}
       rootHeight={containerHeight}
+      selection={{ kind: "none" }}
       columns={columns}
       items={items}
       sortColumnId={null}
@@ -159,8 +160,6 @@ function DataTableHorizontalScrollHarness({
       headerScrollRef={headerScrollRef}
       scrollRef={scrollRef}
       getItemKey={(row) => row.id}
-      isSelected={() => false}
-      onSelect={() => {}}
       renderCell={(row) => ({ text: row.name })}
       emptyStateTitle="No rows."
       showHorizontalScrollbar={showHorizontalScrollbar}
@@ -228,7 +227,7 @@ function MultiSelectDialogButtonHarness() {
   );
 }
 
-function ChoiceDialogHarness() {
+function ChoiceDialogHarness({ selectedChoiceId }: { selectedChoiceId?: string } = {}) {
   return (
     <ChoiceDialog
       title="Choose Account"
@@ -241,6 +240,7 @@ function ChoiceDialogHarness() {
         { id: "beta", label: "Beta", description: "Beta account" },
         { id: "gamma", label: "Gamma", description: "Gamma account" },
       ]}
+      selectedChoiceId={selectedChoiceId}
     />
   );
 }
@@ -318,6 +318,7 @@ describe("shared UI kit", () => {
 
   test("moves focused tabs with arrow keys and leaves Tab for pane focus", async () => {
     let lastSelected = "overview";
+    const selectedValues: string[] = [];
 
     function KeyboardTabsHarness() {
       const [activeValue, setActiveValue] = useState("overview");
@@ -331,6 +332,7 @@ describe("shared UI kit", () => {
           activeValue={activeValue}
           onSelect={(value) => {
             lastSelected = value;
+            selectedValues.push(value);
             setActiveValue(value);
           }}
           focused
@@ -343,17 +345,73 @@ describe("shared UI kit", () => {
     await act(async () => {
       await testSetup!.renderOnce();
       testSetup!.mockInput.pressArrow("right");
+      testSetup!.mockInput.pressArrow("right");
       await testSetup!.renderOnce();
     });
 
-    expect(lastSelected).toBe("news");
+    expect(selectedValues).toEqual(["news", "chart"]);
+    expect(lastSelected).toBe("chart");
 
     await act(async () => {
       testSetup!.mockInput.pressTab();
       await testSetup!.renderOnce();
     });
 
+    expect(lastSelected).toBe("chart");
+  });
+
+  test("selects tabs by clicking their text labels", async () => {
+    let lastSelected = "overview";
+    const selectedValues: string[] = [];
+
+    function PointerTabsHarness() {
+      const [activeValue, setActiveValue] = useState("overview");
+      return (
+        <Tabs
+          tabs={[
+            { label: "Overview", value: "overview" },
+            { label: "News", value: "news" },
+            { label: "Chart", value: "chart" },
+          ]}
+          activeValue={activeValue}
+          onSelect={(value) => {
+            lastSelected = value;
+            selectedValues.push(value);
+            setActiveValue(value);
+          }}
+          scrollable={false}
+        />
+      );
+    }
+
+    testSetup = await testRender(<PointerTabsHarness />, { width: 40, height: 4 });
+
+    await act(async () => {
+      await testSetup!.renderOnce();
+    });
+
+    let frame = testSetup.captureCharFrame();
+    const newsCol = frame.split("\n")[0]!.indexOf("News");
+    expect(newsCol).toBeGreaterThanOrEqual(0);
+
+    await act(async () => {
+      await testSetup!.mockMouse.click(newsCol + 1, 0);
+      await testSetup!.renderOnce();
+    });
+
     expect(lastSelected).toBe("news");
+
+    frame = testSetup.captureCharFrame();
+    const chartCol = frame.split("\n")[0]!.indexOf("Chart");
+    expect(chartCol).toBeGreaterThanOrEqual(0);
+
+    await act(async () => {
+      await testSetup!.mockMouse.click(chartCol + 1, 0);
+      await testSetup!.renderOnce();
+    });
+
+    expect(selectedValues).toEqual(["news", "chart"]);
+    expect(lastSelected).toBe("chart");
   });
 
   test("renders tab actions for editable tab sets", async () => {
@@ -407,6 +465,15 @@ describe("shared UI kit", () => {
     expect(button).toBeDefined();
     expect(button!.width).toBe(" IND: SMA ".length);
 
+    await act(async () => {
+      await testSetup!.mockMouse.release(button!.x + 1, button!.y);
+      await Promise.resolve();
+      await testSetup!.renderOnce();
+    });
+
+    frame = testSetup.captureCharFrame();
+    expect(frame).not.toContain("Chart Indicators");
+
     await act(async () => {
       await testSetup!.mockMouse.click(button!.x + 1, button!.y);
       await Promise.resolve();
@@ -470,6 +537,18 @@ describe("shared UI kit", () => {
     expect(resolvedChoice).toBe("gamma");
   });
 
+  test("preselects the current choice in choice dialogs", async () => {
+    testSetup = await testRender(<ChoiceDialogHarness selectedChoiceId="beta" />, { width: 44, height: 10 });
+
+    await act(async () => {
+      await testSetup!.renderOnce();
+    });
+
+    const frame = testSetup.captureCharFrame();
+    expect(frame).toContain("Beta account");
+    expect(frame).not.toContain("Alpha account");
+  });
+
   test("cancels choice dialogs with escape", async () => {
     testSetup = await testRender(<ChoiceDialogHarness />, { width: 44, height: 10 });
 

package/src/core/state/app/types.ts

@@ -26,10 +26,18 @@ export interface CollectionSortPreference {
   direction: SortDirection;
 }
 
-interface CommandBarLaunchRequest {
+interface CommandBarLaunchRequestBase {
+  sequence: number;
+}
+
+interface CommandBarPluginLaunchRequest extends CommandBarLaunchRequestBase {
   kind: "plugin-command";
   commandId: string;
-  sequence: number;
+}
+
+interface CommandBarTickerSearchLaunchRequest extends CommandBarLaunchRequestBase {
+  kind: "ticker-search";
+  query?: string;
 }
 
 export interface AppState {
@@ -44,7 +52,7 @@ export interface AppState {
   recentTickers: string[];
   commandBarOpen: boolean;
   commandBarQuery: string;
-  commandBarLaunchRequest: CommandBarLaunchRequest | null;
+  commandBarLaunchRequest: CommandBarPluginLaunchRequest | CommandBarTickerSearchLaunchRequest | null;
   themePreview: string | null;
   refreshing: Set<string>;
   initialized: boolean;
@@ -74,7 +82,7 @@ export type AppAction =
       type: "SET_COMMAND_BAR";
       open: boolean;
       query?: string;
-      launch?: { kind: "plugin-command"; commandId: string } | null;
+      launch?: { kind: "plugin-command"; commandId: string } | { kind: "ticker-search"; query?: string } | null;
     }
   | { type: "SET_COMMAND_BAR_QUERY"; query: string }
   | { type: "SET_REFRESHING"; symbol: string; refreshing: boolean }

package/src/market-data/coordinator/auxiliary.ts

@@ -1,4 +1,4 @@
-import type { DataProvider, SecFilingItem } from "../../types/data-provider";
+import type { DataProvider, SecFilingDocument, SecFilingItem } from "../../types/data-provider";
 import type { NewsArticle } from "../../news/types";
 import type { OptionsChain } from "../../types/financials";
 import type { NewsRequest, OptionsRequest, SecFilingsRequest } from "../request-types";
@@ -26,6 +26,7 @@ import {
   buildNewsKey,
   buildOptionsKey,
   buildSecContentKey,
+  buildSecDocumentsKey,
   buildSecFilingsKey,
   toMarketDataContext,
 } from "../selectors";
@@ -170,6 +171,33 @@ export function loadSecFilingContentEntry(options: {
   });
 }
 
+export function loadSecFilingDocumentsEntry(options: {
+  dataProvider: DataProvider;
+  filing: SecFilingItem;
+  store: QueryStore<SecFilingDocument[]>;
+  runSingleFlight: RunSingleFlight;
+}): Promise<QueryEntry<SecFilingDocument[]>> {
+  const { dataProvider, filing, store, runSingleFlight } = options;
+  const key = buildSecDocumentsKey(filing.accessionNumber);
+  return loadAuxiliaryEntry({
+    dataProvider,
+    key,
+    store,
+    ttlMs: SEC_CONTENT_CACHE_TTL_MS,
+    runSingleFlight,
+    load: async (startedAt) => {
+      if (!dataProvider.getSecFilingDocuments) {
+        const attempt = createAttempt(dataProvider.id, startedAt, "unsupported", "UNSUPPORTED_RANGE", "SEC filing documents are not available");
+        return store.update(key, (current) => errorEntry(current, attempt));
+      }
+      const data = await dataProvider.getSecFilingDocuments(filing);
+      const status = data.length > 0 ? "success" : "empty";
+      const attempts = [createAttempt(dataProvider.id, startedAt, status, data.length > 0 ? undefined : "NO_DATA")];
+      return store.update(key, (current) => readyEntry(current, data.length > 0 ? data : null, dataProvider.id, attempts, { keepLastGoodOnEmpty: true }));
+    },
+  });
+}
+
 export function loadArticleSummaryEntry(options: {
   dataProvider: DataProvider;
   url: string;

package/src/market-data/coordinator/index.ts

@@ -1,4 +1,4 @@
-import type { DataProvider, SecFilingItem } from "../../types/data-provider";
+import type { DataProvider, SecFilingDocument, SecFilingItem } from "../../types/data-provider";
 import type { NewsArticle } from "../../news/types";
 import type { OptionsChain, PricePoint, Quote, TickerFinancials } from "../../types/financials";
 import type { ChartRequest, InstrumentRef, NewsRequest, OptionsRequest, SecFilingsRequest } from "../request-types";
@@ -13,6 +13,7 @@ import {
   buildOptionsKey,
   buildQuoteKey,
   buildSecContentKey,
+  buildSecDocumentsKey,
   buildSecFilingsKey,
   buildSnapshotKey,
   resolveEntryData,
@@ -41,6 +42,7 @@ import {
   loadNewsEntry,
   loadOptionsEntry,
   loadSecFilingContentEntry,
+  loadSecFilingDocumentsEntry,
   loadSecFilingsEntry,
 } from "./auxiliary";
 import {
@@ -72,6 +74,7 @@ export class MarketDataCoordinator {
   private readonly newsStore = new QueryStore<NewsArticle[]>((key) => this.events.bump(key));
   private readonly optionsStore = new QueryStore<OptionsChain>((key) => this.events.bump(key));
   private readonly secFilingsStore = new QueryStore<SecFilingItem[]>((key) => this.events.bump(key));
+  private readonly secDocumentsStore = new QueryStore<SecFilingDocument[]>((key) => this.events.bump(key));
   private readonly secContentStore = new QueryStore<string | null>((key) => this.events.bump(key));
   private readonly articleSummaryStore = new QueryStore<string | null>((key) => this.events.bump(key));
   private readonly fxStore = new QueryStore<number>((key) => this.events.bump(key));
@@ -135,6 +138,10 @@ export class MarketDataCoordinator {
     return this.secContentStore.get(buildSecContentKey(accessionNumber));
   }
 
+  getSecDocumentsEntry(accessionNumber: string): QueryEntry<SecFilingDocument[]> {
+    return this.secDocumentsStore.get(buildSecDocumentsKey(accessionNumber));
+  }
+
   getArticleSummaryEntry(url: string): QueryEntry<string | null> {
     return this.articleSummaryStore.get(buildArticleSummaryKey(url));
   }
@@ -336,6 +343,15 @@ export class MarketDataCoordinator {
     });
   }
 
+  async loadSecFilingDocuments(filing: SecFilingItem): Promise<QueryEntry<SecFilingDocument[]>> {
+    return loadSecFilingDocumentsEntry({
+      dataProvider: this.dataProvider,
+      filing,
+      store: this.secDocumentsStore,
+      runSingleFlight: (key, task) => this.runSingleFlight(key, task),
+    });
+  }
+
   async loadArticleSummary(url: string): Promise<QueryEntry<string | null>> {
     return loadArticleSummaryEntry({
       dataProvider: this.dataProvider,