gloomberb 0.13.2 → 0.14.0

package/src/plugins/builtin/ipo-calendar/headless.ts

@@ -1,127 +0,0 @@
-import type {
-  HeadlessPaneDefinition,
-  HeadlessPaneLoadArgs,
-  HeadlessRowsResult,
-} from "../../../types/plugin";
-import { formatIpoDate, matchesIpoRecord } from "./client";
-import { loadIpoCalendar, type IpoCalendarResult } from "./cache";
-import type { IPORecord, IPOStatus } from "./types";
-
-const IPO_COLUMNS = [
-  { key: "ticker", header: "Ticker" },
-  { key: "company", header: "Company" },
-  { key: "date", header: "Date" },
-  { key: "status", header: "Status" },
-  { key: "exchange", header: "Exchange" },
-  { key: "offerSize", header: "Offer", align: "right" as const },
-  { key: "priceLow", header: "Price low", align: "right" as const },
-  { key: "priceHigh", header: "Price high", align: "right" as const },
-  { key: "pricedPrice", header: "Priced", align: "right" as const },
-  { key: "shares", header: "Shares", align: "right" as const },
-  { key: "closePrice", header: "Close", align: "right" as const },
-  { key: "change1D", header: "1D %", align: "right" as const },
-];
-
-export interface IpoCalendarHeadlessDependencies {
-  loadCalendar(): Promise<IpoCalendarResult>;
-}
-
-const defaultDependencies: IpoCalendarHeadlessDependencies = {
-  loadCalendar: () => loadIpoCalendar(false),
-};
-
-function statusOption(args: HeadlessPaneLoadArgs): IPOStatus | "all" {
-  return String(args.options.status ?? "all") as IPOStatus | "all";
-}
-
-function toHeadlessRow(record: IPORecord) {
-  return {
-    ticker: record.ticker,
-    company: record.companyName,
-    date: formatIpoDate(record.date),
-    status: record.status,
-    exchange: record.exchange,
-    offerSize: record.offerSize,
-    priceLow: record.priceRange?.[0] ?? null,
-    priceHigh: record.priceRange?.[1] ?? null,
-    pricedPrice: record.pricedPrice,
-    shares: record.shares,
-    closePrice: record.closePrice,
-    change1D: record.change1D,
-  };
-}
-
-export function projectIpoCalendarHeadless(
-  result: IpoCalendarResult,
-  args: HeadlessPaneLoadArgs,
-): HeadlessRowsResult {
-  const query = typeof args.argument === "string" ? args.argument.trim() : "";
-  const status = statusOption(args);
-  const limit = Number(args.options.limit ?? 50);
-  const matching = result.records.filter((record) => (
-    matchesIpoRecord(record, query)
-    && (status === "all" || record.status === status)
-  ));
-  const rows = matching.slice(0, limit).map(toHeadlessRow);
-
-  return {
-    columns: IPO_COLUMNS,
-    rows,
-    errors: result.errors.length > 0 ? result.errors : undefined,
-    metadata: {
-      fetchedAt: result.fetchedAt,
-      stale: result.stale,
-      total: matching.length,
-      returned: rows.length,
-      truncated: rows.length < matching.length,
-      query: query || null,
-      status,
-    },
-  };
-}
-
-export function createIpoCalendarHeadless(
-  dependencies: IpoCalendarHeadlessDependencies = defaultDependencies,
-): HeadlessPaneDefinition<"rows"> {
-  return {
-    shape: "rows",
-    argument: {
-      kind: "free-text",
-      placeholder: "company or ticker",
-      description: "Optional company, ticker, exchange, or status filter.",
-      optional: true,
-    },
-    options: [
-      {
-        key: "status",
-        description: "IPO stage to include.",
-        type: "enum",
-        values: [
-          { value: "all" },
-          { value: "upcoming" },
-          { value: "priced" },
-          { value: "trading" },
-        ],
-        defaultValue: "all",
-      },
-      {
-        key: "limit",
-        description: "Maximum IPO rows to return.",
-        type: "integer",
-        defaultValue: 50,
-        minimum: 1,
-        maximum: 200,
-      },
-    ],
-    columns: IPO_COLUMNS,
-    describe: (args) => {
-      const status = statusOption(args);
-      return status === "all" ? "IPO Calendar" : `IPO Calendar | ${status}`;
-    },
-    async load(args) {
-      return projectIpoCalendarHeadless(await dependencies.loadCalendar(), args);
-    },
-  };
-}
-
-export const ipoCalendarHeadless = createIpoCalendarHeadless();

package/src/plugins/builtin/ipo-calendar/index.tsx

@@ -1,68 +0,0 @@
-import type { PluginModule } from "../plugin-module";
-import {
-  attachIpoCalendarHealth,
-  resetIpoCalendarHealth,
-  STOCKANALYSIS_IPO_CONNECTION_ID,
-} from "./client";
-import { attachIpoCalendarPersistence, resetIpoCalendarPersistence } from "./cache";
-import { IPOCalendarPane } from "./pane";
-import { ipoCalendarHeadless } from "./headless";
-import { IPO_CALENDAR_PANE_ID } from "./types";
-
-let disposeConnection: (() => void) | null = null;
-
-export const ipoCalendarModule: PluginModule = {
-  setup(ctx) {
-    attachIpoCalendarHealth(ctx.connectionHealth);
-    attachIpoCalendarPersistence(ctx.persistence);
-    disposeConnection = ctx.connectionHealth.registerSource({
-      id: STOCKANALYSIS_IPO_CONNECTION_ID,
-      name: "Stock Analysis",
-      kind: "api",
-      ownerId: "macro",
-      detail: "stockanalysis.com",
-      priority: 300,
-    });
-  },
-
-  dispose() {
-    disposeConnection?.();
-    disposeConnection = null;
-    resetIpoCalendarHealth();
-    resetIpoCalendarPersistence();
-  },
-
-  panes: [
-    {
-      id: IPO_CALENDAR_PANE_ID,
-      name: "IPO Calendar",
-      icon: "I",
-      component: IPOCalendarPane,
-      defaultPosition: "right",
-      defaultMode: "floating",
-      defaultFloatingSize: { width: 110, height: 28 },
-      tableExport: true,
-    },
-  ],
-
-  paneTemplates: [
-    {
-      id: "ipo-calendar-pane",
-      paneId: IPO_CALENDAR_PANE_ID,
-      label: "IPO Calendar",
-      description: "Upcoming and recent IPOs from Stock Analysis: pricing, offer size, and first-day return.",
-      keywords: [
-        "ipo",
-        "initial",
-        "public",
-        "offering",
-        "new",
-        "listing",
-        "debut",
-      ],
-      shortcut: { prefix: "IPO" },
-      headless: ipoCalendarHeadless,
-      createInstance: () => ({ placement: "floating" }),
-    },
-  ],
-};

package/src/plugins/builtin/ipo-calendar/model.ts

@@ -1,133 +0,0 @@
-import type { DataTableColumn } from "../../../components";
-import { colors } from "../../../theme/colors";
-import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
-import type { IPORecord, IPOStatus } from "./types";
-import { formatIpoDate, matchesIpoRecord } from "./client";
-
-type IPOColumnId =
-  | "ticker"
-  | "company"
-  | "date"
-  | "status"
-  | "exchange"
-  | "offer"
-  | "price"
-  | "shares"
-  | "return";
-
-export type IPOColumn = DataTableColumn & { id: IPOColumnId };
-
-export interface IPOSortPreference {
-  columnId: IPOColumnId | null;
-  direction: SortDirection;
-}
-
-export const DEFAULT_SORT_PREFERENCE: IPOSortPreference = {
-  columnId: null,
-  direction: "asc",
-};
-
-export function statusColor(status: IPOStatus): string {
-  switch (status) {
-    case "upcoming":
-      return colors.warning;
-    case "priced":
-      return colors.textBright;
-    case "trading":
-      return colors.positive;
-  }
-}
-
-export const formatDate = formatIpoDate;
-
-export function formatOfferSize(value: number | null): string {
-  if (value == null) return "—";
-  const abs = Math.abs(value);
-  if (abs >= 1e9) return `$${(value / 1e9).toFixed(1)}B`;
-  if (abs >= 1e6) return `$${(value / 1e6).toFixed(1)}M`;
-  if (abs >= 1e3) return `$${(value / 1e3).toFixed(0)}K`;
-  return `$${value.toFixed(0)}`;
-}
-
-export function formatShares(value: number | null): string {
-  if (value == null) return "—";
-  const abs = Math.abs(value);
-  if (abs >= 1e9) return `${(value / 1e9).toFixed(1)}B`;
-  if (abs >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
-  if (abs >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
-  return String(value);
-}
-
-export function formatPrice(record: IPORecord): string {
-  if (record.pricedPrice != null) return `$${record.pricedPrice.toFixed(2)}`;
-  if (record.priceRange != null) return `$${record.priceRange[0].toFixed(2)}-$${record.priceRange[1].toFixed(2)}`;
-  return "—";
-}
-
-export function formatReturn(value: number | null): string {
-  if (value == null) return "—";
-  const sign = value > 0 ? "+" : "";
-  return `${sign}${value.toFixed(1)}%`;
-}
-
-export function stockAnalysisUrl(ticker: string): string {
-  return `https://stockanalysis.com/stocks/${ticker.toLowerCase()}/`;
-}
-
-/** "$100.00-$120.00" is the widest price a row can hold; anything narrower clips a real number. */
-const PRICE_WIDTH = 15;
-
-export function buildColumns(width: number): IPOColumn[] {
-  const fixed = 7 + 11 + 9 + 8 + 8 + PRICE_WIDTH + 7 + 8;
-  const companyWidth = Math.max(10, width - fixed - 11);
-  return [
-    { id: "ticker", label: "TICKER", width: 7, align: "left" },
-    { id: "company", label: "COMPANY", width: companyWidth, align: "left" },
-    { id: "date", label: "DATE", width: 11, align: "left" },
-    { id: "status", label: "STATUS", width: 9, align: "left" },
-    { id: "exchange", label: "EXCH", width: 8, align: "left" },
-    { id: "offer", label: "OFFER", width: 8, align: "right" },
-    { id: "price", label: "PRICE", width: PRICE_WIDTH, align: "right" },
-    { id: "shares", label: "SHARES", width: 7, align: "right" },
-    { id: "return", label: "RETURN", width: 8, align: "right" },
-  ];
-}
-
-function getSortValue(columnId: IPOColumnId, row: IPORecord): string | number | null {
-  switch (columnId) {
-    case "ticker":
-      return row.ticker;
-    case "company":
-      return row.companyName;
-    case "date":
-      return row.date.getTime();
-    case "status":
-      return row.status;
-    case "exchange":
-      return row.exchange ?? "";
-    case "offer":
-      return row.offerSize;
-    case "price":
-      return row.pricedPrice ?? row.priceRange?.[0] ?? null;
-    case "shares":
-      return row.shares;
-    case "return":
-      return row.change1D;
-  }
-}
-
-export function sortRows(rows: IPORecord[], sort: IPOSortPreference): IPORecord[] {
-  if (!sort.columnId) return rows;
-  return [...rows].sort((a, b) =>
-    compareSortValues(getSortValue(sort.columnId!, a), getSortValue(sort.columnId!, b), sort.direction),
-  );
-}
-
-export function nextSortPreference(current: IPOSortPreference, columnId: string): IPOSortPreference {
-  const typed = columnId as IPOColumnId;
-  if (current.columnId !== typed) return { columnId: typed, direction: "asc" };
-  if (current.direction === "asc") return { columnId: typed, direction: "desc" };
-  return DEFAULT_SORT_PREFERENCE;
-}
-
-export const matchesSearch = matchesIpoRecord;

package/src/plugins/builtin/ipo-calendar/pane.tsx

@@ -1,328 +0,0 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import {
-  Button,
-  DataTableView,
-  EmptyState,
-  InputSearchBar,
-  Spinner,
-  useExternalLinkFooter,
-  type DataTableCell,
-  type DataTableKeyEvent,
-} from "../../../components";
-import { useShortcut } from "../../../react/input";
-import { colors, priceColor } from "../../../theme/colors";
-import { TICKER_RESEARCH_PANE_ID } from "../../../types/config";
-import type { PaneProps } from "../../../types/plugin";
-import { Box, Text, TextAttributes, type InputRenderable } from "../../../ui";
-import { isPlainKey } from "../../../utils/keyboard";
-import { usePluginTickerActions } from "../../runtime";
-import { useAutoRefresh } from "../shared/auto-refresh";
-import { loadingErrorFooterInfo } from "../shared/table-pane";
-import { getCachedIpoCalendar, loadIpoCalendar } from "./cache";
-import {
-  DEFAULT_SORT_PREFERENCE,
-  buildColumns,
-  formatDate,
-  formatOfferSize,
-  formatPrice,
-  formatReturn,
-  formatShares,
-  matchesSearch,
-  nextSortPreference,
-  sortRows,
-  statusColor,
-  stockAnalysisUrl,
-  type IPOColumn,
-  type IPOSortPreference,
-} from "./model";
-import { IPO_CALENDAR_PANE_ID, type IPORecord, type LoadStatus } from "./types";
-
-const SEARCH_DEBOUNCE_MS = 250;
-
-export function IPOCalendarPane({ focused, width, height }: PaneProps) {
-  const { pinTicker } = usePluginTickerActions();
-  const [initialCache] = useState(getCachedIpoCalendar);
-  const [records, setRecords] = useState<IPORecord[]>(initialCache?.records ?? []);
-  // "idle" would render the empty state for one frame before the first load.
-  const [status, setStatus] = useState<LoadStatus>(initialCache ? "loaded" : "loading");
-  const [error, setError] = useState<string | null>(null);
-  const [stale, setStale] = useState(initialCache?.stale ?? false);
-  const [selectedTicker, setSelectedTicker] = useState<string | null>(null);
-  const [sortPreference, setSortPreference] = useState<IPOSortPreference>(DEFAULT_SORT_PREFERENCE);
-  const [searchQuery, setSearchQuery] = useState("");
-  const [searchFocused, setSearchFocused] = useState(false);
-  const [searchFocusToken, setSearchFocusToken] = useState(0);
-  const [lastUpdated, setLastUpdated] = useState<number | null>(initialCache?.fetchedAt ?? null);
-  const searchInputRef = useRef<InputRenderable | null>(null);
-  const fetchGenRef = useRef(0);
-
-  const load = useCallback(async (force = false) => {
-    fetchGenRef.current += 1;
-    const gen = fetchGenRef.current;
-    setStatus((current) => (current === "loaded" ? current : "loading"));
-    setError(null);
-
-    try {
-      const result = await loadIpoCalendar(force);
-      if (fetchGenRef.current !== gen) return;
-      setRecords(result.records);
-      setStale(result.stale);
-      setError(result.errors[0] ?? null);
-      setStatus("loaded");
-      setLastUpdated(result.fetchedAt);
-    } catch (err) {
-      if (fetchGenRef.current !== gen) return;
-      setError(err instanceof Error ? err.message : String(err));
-      setStatus("error");
-    }
-  }, []);
-
-  useEffect(() => {
-    void load();
-  }, [load]);
-
-  // The cache decides whether a tick becomes a scrape; only [r] forces it.
-  useAutoRefresh(status === "loaded" && !stale ? lastUpdated : null, () => {
-    void load();
-  });
-
-  const filtered = useMemo(
-    () => records.filter((record) => matchesSearch(record, searchQuery)),
-    [records, searchQuery],
-  );
-
-  const sorted = useMemo(
-    () => sortRows(filtered, sortPreference),
-    [filtered, sortPreference],
-  );
-
-  const columns = useMemo(() => buildColumns(width), [width]);
-
-  useEffect(() => {
-    if (selectedTicker && sorted.some((record) => record.ticker === selectedTicker)) return;
-    const first = sorted[0];
-    if (first) {
-      setSelectedTicker(first.ticker);
-    } else if (selectedTicker !== null) {
-      setSelectedTicker(null);
-    }
-  }, [selectedTicker, sorted]);
-
-  const loading = status === "loading" && records.length === 0;
-
-  const focusSearch = useCallback(() => {
-    setSearchFocused(true);
-    setSearchFocusToken((token) => token + 1);
-  }, []);
-
-  const blurSearch = useCallback(() => {
-    setSearchFocused(false);
-  }, []);
-
-  const updateSearch = useCallback((query: string) => {
-    setSearchQuery(query);
-    setSelectedTicker(null);
-  }, []);
-
-  const refresh = useCallback(() => {
-    void load(true);
-  }, [load]);
-
-  const handleHeaderClick = useCallback((columnId: string) => {
-    setSortPreference((current) => nextSortPreference(current, columnId));
-  }, []);
-
-  const handleTableKeyDown = useCallback((event: DataTableKeyEvent) => {
-    if (isPlainKey(event, "r")) {
-      event.preventDefault?.();
-      event.stopPropagation?.();
-      refresh();
-      return true;
-    }
-    if (isPlainKey(event, "/")) {
-      event.preventDefault?.();
-      event.stopPropagation?.();
-      focusSearch();
-      return true;
-    }
-    return false;
-  }, [focusSearch, refresh]);
-
-  const handleActivate = useCallback((record: IPORecord) => {
-    pinTicker(record.ticker, { floating: true, paneType: TICKER_RESEARCH_PANE_ID });
-  }, [pinTicker]);
-
-  useShortcut((event) => {
-    if (!focused || searchFocused) return;
-    if (event.targetEditable) return;
-    if (isPlainKey(event, "/")) {
-      event.stopPropagation?.();
-      event.preventDefault?.();
-      focusSearch();
-    } else if (isPlainKey(event, "r")) {
-      event.stopPropagation?.();
-      event.preventDefault?.();
-      refresh();
-    }
-  }, { allowEditable: true, enabled: focused });
-
-  const selectedRecord = useMemo(
-    () => sorted.find((record) => record.ticker === selectedTicker) ?? null,
-    [selectedTicker, sorted],
-  );
-
-  const footerInfo = useMemo(() => [
-    ...loadingErrorFooterInfo(status === "loading", records.length === 0 ? error : null),
-    // One endpoint failed while the other returned rows: say so without
-    // spilling a scrape URL into the footer.
-    ...(error && records.length > 0
-      ? [{ id: "partial", parts: [{ text: "PARTIAL", tone: "warning" as const, bold: true }] }]
-      : []),
-    ...(stale ? [{ id: "stale", parts: [{ text: "STALE", tone: "warning" as const }] }] : []),
-    ...(searchQuery ? [{
-      id: "search",
-      parts: [{ text: `filter: ${searchQuery}`, tone: "value" as const }],
-    }] : []),
-  ], [error, records.length, searchQuery, stale, status]);
-
-  const footerHints = useMemo(
-    () => [{ id: "search", key: "/", label: "search", onPress: focusSearch }],
-    [focusSearch],
-  );
-
-  useExternalLinkFooter({
-    registrationId: IPO_CALENDAR_PANE_ID,
-    focused,
-    url: selectedRecord ? stockAnalysisUrl(selectedRecord.ticker) : null,
-    source: "stockanalysis.com",
-    info: footerInfo,
-    hints: footerHints,
-  });
-
-  const renderCell = useCallback(
-    (row: IPORecord, column: IPOColumn, _index: number, rowState: { selected: boolean }): DataTableCell => {
-      const selectedColor = rowState.selected ? colors.selectedText : undefined;
-
-      switch (column.id) {
-        case "ticker":
-          return {
-            text: row.ticker,
-            color: selectedColor ?? colors.textBright,
-            attributes: TextAttributes.BOLD,
-          };
-        case "company":
-          return {
-            text: row.companyName,
-            color: selectedColor ?? colors.text,
-          };
-        case "date":
-          return {
-            text: formatDate(row.date),
-            color: selectedColor ?? colors.textMuted,
-          };
-        case "status":
-          return {
-            text: row.status,
-            color: selectedColor ?? statusColor(row.status),
-          };
-        case "exchange":
-          return {
-            text: row.exchange ?? "—",
-            color: selectedColor ?? colors.textDim,
-          };
-        case "offer":
-          return {
-            text: formatOfferSize(row.offerSize),
-            color: selectedColor ?? colors.textDim,
-          };
-        case "price":
-          return {
-            text: formatPrice(row),
-            color: selectedColor ?? colors.text,
-          };
-        case "shares":
-          return {
-            text: formatShares(row.shares),
-            color: selectedColor ?? colors.textDim,
-          };
-        case "return":
-          return {
-            text: formatReturn(row.change1D),
-            color: selectedColor ?? (row.change1D != null ? priceColor(row.change1D) : colors.textDim),
-          };
-      }
-    },
-    [],
-  );
-
-  const rootBefore = (
-    <InputSearchBar
-      value={searchQuery}
-      focused={focused}
-      active={searchFocused}
-      width={width}
-      focusToken={searchFocusToken}
-      inputRef={searchInputRef}
-      placeholder="ticker, company, or exchange"
-      debounceMs={SEARCH_DEBOUNCE_MS}
-      normalizeValue={(value) => value.trim()}
-      onFocus={focusSearch}
-      onBlur={blurSearch}
-      onNavigateDown={blurSearch}
-      onQueryChange={updateSearch}
-    />
-  );
-
-  if (loading) {
-    return (
-      <Box flexDirection="column" width={width} height={height}>
-        {rootBefore}
-        <Box flexGrow={1} justifyContent="center" alignItems="center">
-          <Spinner label="Loading IPO calendar..." />
-        </Box>
-      </Box>
-    );
-  }
-
-  if (status === "error" && records.length === 0) {
-    return (
-      <Box flexDirection="column" width={width} height={height}>
-        {rootBefore}
-        <Box padding={1} flexDirection="column" gap={1}>
-          <EmptyState title="IPO calendar unavailable." message={error ?? undefined} />
-        </Box>
-      </Box>
-    );
-  }
-
-  return (
-    <DataTableView<IPORecord, IPOColumn>
-      focused={focused && !searchFocused}
-      rootBefore={rootBefore}
-      rootWidth={width}
-      rootHeight={height}
-      selection={{
-        kind: "id",
-        selectedId: selectedTicker,
-        getId: (row) => row.ticker,
-        onChange: (ticker) => setSelectedTicker(ticker),
-      }}
-      onRootKeyDown={handleTableKeyDown}
-      columns={columns}
-      items={sorted}
-      sortColumnId={sortPreference.columnId}
-      sortDirection={sortPreference.direction}
-      onHeaderClick={handleHeaderClick}
-      getItemKey={(row) => row.ticker}
-      onActivate={handleActivate}
-      renderCell={renderCell}
-      emptyStateTitle={
-        searchQuery
-          ? `No IPOs matching "${searchQuery}"`
-          : status === "error"
-            ? "Failed to load IPO data"
-            : "No IPO data"
-      }
-    />
-  );
-}

package/src/plugins/builtin/ipo-calendar/types.ts

@@ -1,19 +0,0 @@
-export const IPO_CALENDAR_PANE_ID = "ipo-calendar";
-
-export type IPOStatus = "upcoming" | "priced" | "trading";
-
-export interface IPORecord {
-  ticker: string;
-  companyName: string;
-  date: Date;
-  status: IPOStatus;
-  exchange: string | null;
-  offerSize: number | null;
-  priceRange: [number, number] | null;
-  pricedPrice: number | null;
-  shares: number | null;
-  closePrice: number | null;
-  change1D: number | null;
-}
-
-export type LoadStatus = "idle" | "loading" | "loaded" | "error";