gloomberb 0.13.2 → 0.14.0

package/src/public/market-data.ts

@@ -7,3 +7,22 @@
  */
 export * from "../market-data/request-types";
 export * from "../market-data/market/format";
+
+// The coordinator the app loads snapshots through, so a plugin pane that shows
+// its own list of tickers warms the same cache the rest of the app reads.
+export { getSharedMarketDataCoordinator } from "../market-data/coordinator";
+
+// Values derived from a quote and its fundamentals that a pane must not
+// recompute by hand: whether a quote's timestamp can be trusted, trailing
+// returns, and the market capitalization with its currency and provenance.
+export { hasValidQuoteObservationTime } from "../market-data/quotes/freshness";
+export { computeTickerPriceReturns } from "../market-data/ticker-price-returns";
+export { selectMarketCapitalization } from "../utils/market-capitalization";
+export type { MarketCapitalization } from "../utils/market-capitalization";
+
+// Yahoo Finance's JSON endpoints need a crumb and cookie pair, retries on the
+// 4xx/5xx it throws under load, and browser-like headers. A plugin scraping a
+// Yahoo screener or quote endpoint gets that dance here rather than
+// reimplementing it, and goes through `httpFetch` so the desktop and web
+// renderers can route it.
+export { YahooHttpClient } from "../sources/yahoo-finance/http";

package/src/public/pane-hooks.ts

@@ -35,7 +35,14 @@ export function useTickers(): AppState["tickers"] {
  * Prefer a named hook above: these expose the app store directly, so anything
  * built on them is coupled to its shape.
  */
-export { AppContext, PaneInstanceProvider, useAppDispatch, useAppSelector } from "../state/app/context";
+export { AppContext, PaneInstanceProvider, useAppDispatch, useAppSelector, usePaneSettingValue, usePaneTitle } from "../state/app/context";
+
+/**
+ * Pane state at the top level rather than inside the plugin's namespace, for
+ * the few values the app itself resolves across panes: the cursor symbol a
+ * follower pane reads is the clearest case.
+ */
+export { usePaneStateValue } from "../state/app/context";
 
 export const usePaneInstanceId = usePaneInstanceIdInternal;
 export const usePaneCollection = usePaneCollectionInternal;

package/src/public/public-api.test.ts

@@ -1,285 +1,42 @@
-import { describe, expect, test } from "bun:test";
-
-import * as capabilities from "../capabilities";
-import * as components from "../components";
-import * as theme from "../theme/colors";
-import * as ui from "../ui";
-import * as pluginReact from "./react";
-import * as testSupport from "./test-support";
-import * as utils from "./utils";
-
-/**
- * The public plugin API is a compatibility boundary: plugins in other
- * repositories (gloom-sh/gloomberb-substack, -ibkr, -hackernews, and any
- * community plugin) import these subpaths, and a rename here breaks them
- * silently at their next install rather than in this repo's CI.
- *
- * Adding an export is deliberate — update the list below in the same commit.
- * Removing or renaming one is a breaking change for every installed plugin and
- * needs a major version plus a migration note in PLUGINS.md.
- */
-const PUBLIC_API: Record<string, readonly string[]> = {
-  "ui": [
-    "AsciiText",
-    "Box",
-    "ChartSurface",
-    "ContextMenuProvider",
-    "ImageSurface",
-    "Input",
-    "MediaSurface",
-    "RGBA",
-    "ScrollBox",
-    "Span",
-    "SpinnerMark",
-    "Strong",
-    "StyledText",
-    "Text",
-    "TextAttributes",
-    "Textarea",
-    "UiHostProvider",
-    "Underline",
-    "compactContextMenuItems",
-    "contextMenuDivider",
-    "editableTextContextMenuItems",
-    "linkContextMenuItems",
-    "tickerContextMenuItems",
-    "useCommandBarShortcut",
-    "useContextMenu",
-    "useNativeRenderer",
-    "useRendererHost",
-    "useSyntaxStyleFactory",
-    "useTickerContextMenu",
-    "useUiCapabilities",
-    "useUiHost",
-  ],
-  "components": [
-    "Button",
-    "Checkbox",
-    "ChoiceDialog",
-    "ConfirmDialog",
-    "DataTableStackView",
-    "DataTableView",
-    "EmptyState",
-    "FeedDataTableStackView",
-    "InputSearchBar",
-    "MessageComposer",
-    "MetricTreemapSurface",
-    "NumberField",
-    "PaneFooterScope",
-    "PaneSidebar",
-    "PaneSidebarAction",
-    "PaneSidebarRow",
-    "PaneStatusBody",
-    "PriceSelectorDialog",
-    "RemoteImage",
-    "SegmentedControl",
-    "SelectButton",
-    "SpeedometerGauge",
-    "Spinner",
-    "StaticChartSurface",
-    "Tabs",
-    "TextField",
-    "TickerBadgeList",
-    "TickerBadgeText",
-    "TickerListTableView",
-    "activeStackIndex",
-    "buildMetricTreemapNavigationTiles",
-    "findMetricTreemapNeighbor",
-    "getMessageComposerBlockHeight",
-    "getPaneSidebarWidth",
-    "isTableScrollNearEnd",
-    "loadingText",
-    "shouldShowPaneSidebar",
-    "sortStackItems",
-    "unavailableText",
-    "useExternalLinkFooter",
-    "usePaneFooter",
-    "usePaneTicker",
-    "useTableLoadMore",
-  ],
-  "theme": [
-    "applyTheme",
-    "blendHex",
-    "clearTransientThemePreview",
-    "colors",
-    "commandBarAccentText",
-    "commandBarBadgeText",
-    "commandBarBg",
-    "commandBarHeadingText",
-    "commandBarHoverBg",
-    "commandBarInputBg",
-    "commandBarMatchText",
-    "commandBarPanelBg",
-    "commandBarSelectedBg",
-    "commandBarSelectedText",
-    "commandBarSubtleText",
-    "commandBarText",
-    "floatingPaneBg",
-    "floatingPaneTitleBg",
-    "getChartIndicatorColor",
-    "getCurrentThemeId",
-    "getThemeColors",
-    "hoverBg",
-    "paneBg",
-    "paneTitleBg",
-    "paneTitleText",
-    "previewTheme",
-    "priceColor",
-    "syncTheme",
-  ],
-  "capabilities": [
-    "AI_RUNNER_CAPABILITY_ID",
-    "BROKER_CAPABILITY_ID",
-    "CHART_SERIES_CAPABILITY_KIND",
-    "CapabilityRegistry",
-    "MAX_CHART_SERIES_CATALOG_ITEMS",
-    "MAX_CHART_SERIES_POINTS",
-    "NOTES_FILES_CAPABILITY_ID",
-    "assetDataProvider",
-    "chartSeriesCapabilityManifests",
-    "chartSeriesCatalogOutputSchema",
-    "chartSeriesCatalogRequestSchema",
-    "chartSeriesProvider",
-    "chartSeriesResolveOutputSchema",
-    "chartSeriesResolveRequestSchema",
-    "chartSeriesSourceKey",
-    "createChartSeriesResolver",
-    "isValidChartCapabilityId",
-    "isValidChartSeriesId",
-    "newsProvider",
-    "recordSchema",
-    "searchChartSeriesCapabilities",
-  ],
-  "utils": [
-    "buildBrokerPortfolioId",
-    "canonicalExchange",
-    "canonicalTickerKey",
-    "createBrokerInstanceId",
-    "createThrottledFetch",
-    "debugLog",
-    "decodeHtmlEntities",
-    "displayWidth",
-    "fnv1aHashString",
-    "formatCompact",
-    "formatCompactCurrency",
-    "formatCurrency",
-    "formatGrowthShort",
-    "formatNumber",
-    "formatPercent",
-    "formatPercentRaw",
-    "formatRelativeAge",
-    "formatTimeAgo",
-    "formatWithDivisor",
-    "getBrokerInstance",
-    "getBrokerInstancesByType",
-    "hasLikelyQuoteUnitMismatch",
-    "httpFetch",
-    "isBrokerPortfolioId",
-    "isPlainKey",
-    "isPlainKeyboardEvent",
-    "normalizePriceValueByDivisor",
-    "normalizeSymbol",
-    "normalizedHttpUrl",
-    "padTo",
-    "parsePublicTickerKey",
-    "pickUnit",
-    "publicExchange",
-    "publicTickerKey",
-    "resolveCurrencyUnit",
-    "resolveExchangeSubUnitCurrencyUnit",
-    "resolveExchangeTimeZone",
-    "resolvePriceHistoryCurrencyUnit",
-    "setHttpFetchTransport",
-    "splitLongTextSegmentByDisplayWidth",
-    "truncateToDisplayWidth",
-    "truncateWithEllipsis",
-    "wrapTextLines",
-  ],
-
-  "react": [
-    "AppContext",
-    "DEFAULT_MAX_READ_IDS",
-    "PaneInstanceProvider",
-    "deletePluginPaneStateValue",
-    "getPluginPaneStateValue",
-    "markPersistedReadId",
-    "normalizePersistedReadIdState",
-    "setPluginPaneStateValue",
-    "useAppConfig",
-    "useAppDispatch",
-    "useAppSelector",
-    "useAssetData",
-    "useBrokerAccounts",
-    "useCapabilityInvoker",
-    "useConnectionHealth",
-    "useDebouncedPluginPaneState",
-    "useInlineTickerOpener",
-    "useInlineTickers",
-    "useInputCapture",
-    "useMarketData",
-    "usePaneCollection",
-    "usePaneInstanceId",
-    "usePaneTicker",
-    "usePersistedReadIds",
-    "usePluginAppActions",
-    "usePluginBrokerActions",
-    "usePluginConfigState",
-    "usePluginPaneActions",
-    "usePluginPaneState",
-    "usePluginState",
-    "usePluginTickerActions",
-    "useSetPluginConfigStates",
-    "useShortcut",
-    "useTickers",
-  ],
-
-
-
-  "test-support": [
-    "AppContext",
-    "AppPersistence",
-    "MemoryPluginPersistence",
-    "PaneInstanceProvider",
-    "TestDialogProvider",
-    "clearPersistedBrokerAccounts",
-    "createInitialState",
-    "getBrokerAccountCacheSourceKey",
-    "loadPersistedBrokerAccountMap",
-    "loadPersistedBrokerAccounts",
-    "persistBrokerAccounts",
-    "testRender",
-  ],
-
-};
-
-const MODULES: Record<string, Record<string, unknown>> = {
-  ui,
-  components,
-  theme,
-  capabilities,
-  utils,
-  react: pluginReact,
-  "test-support": testSupport,
-};
-
-describe("public plugin API", () => {
-  for (const [name, expected] of Object.entries(PUBLIC_API)) {
-    test(`gloomberb/${name} exports exactly its documented surface`, () => {
-      const actual = Object.keys(MODULES[name]!)
-        .filter((key) => key !== "default")
-        .sort();
-      expect(actual).toEqual([...expected]);
-    });
+import { expect, test } from "bun:test";
+
+test("every exports subpath in package.json resolves", async () => {
+  const pkg = JSON.parse(await Bun.file(new URL("../../package.json", import.meta.url)).text());
+  const subpaths = Object.entries(pkg.exports as Record<string, string>);
+  expect(subpaths.length).toBeGreaterThan(0);
+  for (const [subpath, target] of subpaths) {
+    if (subpath === "./package.json") continue;
+    const file = Bun.file(new URL(`../../${target.replace(/^\.\//, "")}`, import.meta.url));
+    expect(await file.exists(), `${subpath} -> ${target}`).toBe(true);
   }
+});
 
-  test("every exports subpath in package.json resolves", async () => {
-    const pkg = JSON.parse(await Bun.file(new URL("../../package.json", import.meta.url)).text());
-    const subpaths = Object.entries(pkg.exports as Record<string, string>);
-    expect(subpaths.length).toBeGreaterThan(0);
-    for (const [subpath, target] of subpaths) {
-      if (subpath === "./package.json") continue;
-      const file = Bun.file(new URL(`../../${target.replace(/^\.\//, "")}`, import.meta.url));
-      expect(await file.exists(), `${subpath} -> ${target}`).toBe(true);
-    }
-  });
+test("a bundled external plugin uses the host's React and public hooks", async () => {
+  const { mkdtemp, rm } = await import("node:fs/promises");
+  const { tmpdir } = await import("node:os");
+  const { join } = await import("node:path");
+  const { createElement } = await import("react");
+  const { renderToStaticMarkup } = await import("react-dom/server");
+  const { useMarketData } = await import("./react");
+  const { bundleExternalPlugin } = await import("../plugins/bundle");
+  const { installPluginHostModules } = await import("../plugins/host-modules");
+  const dir = await mkdtemp(join(tmpdir(), "gloom-public-plugin-"));
+  try {
+    await Bun.write(join(dir, "package.json"), JSON.stringify({ name: "smoke-plugin", main: "index.tsx" }));
+    await Bun.write(join(dir, "index.tsx"), `
+      import { createElement, useState } from "react";
+      import { useMarketData } from "gloomberb/react";
+      export default {
+        id: "smoke-plugin", name: "Smoke", version: "1.0.0", useMarketData,
+        component() { return createElement("div", null, useState("ready")[0]); },
+      };
+    `);
+    await installPluginHostModules();
+    const bundle = await bundleExternalPlugin(dir, join(dir, "out"));
+    const plugin = (await import(bundle.outputPath)).default;
+    expect(plugin.useMarketData).toBe(useMarketData);
+    expect(renderToStaticMarkup(createElement(plugin.component))).toBe("<div>ready</div>");
+  } finally {
+    await rm(dir, { recursive: true, force: true });
+  }
 });

package/src/public/quotes.ts

@@ -0,0 +1,50 @@
+/**
+ * Public live-quote surface for external plugins (`gloomberb/quotes`).
+ *
+ * `useMarketData()` from `gloomberb/react` hands a plugin the `DataProvider`
+ * for one-off reads. This module is the streaming layer on top of it: a pane
+ * that shows many symbols at once subscribes to them here and receives the
+ * same live or polled updates the host's own screeners get, through the same
+ * subscription registry, so two panes watching the same symbol share one feed.
+ *
+ * It is a shared host module, not something a plugin bundle can carry a copy
+ * of: the subscriptions live in host state, and a second instance would open a
+ * second feed and never see the first one's updates.
+ *
+ * Compatibility commitment: see the note in `./utils.ts`.
+ */
+
+// Subscribing a list of targets and reading the entries as they update, or
+// only keeping them warm in the host's store when the pane reads quotes
+// through the financials it already holds.
+export { DEFAULT_QUOTE_POLL_INTERVAL_MS, useLiveQuoteEntries, useQuoteUpdates } from "../state/hooks/quote-streaming";
+export type { QuoteUpdateOptions } from "../state/hooks/quote-streaming";
+export type { QuoteSubscriptionTarget } from "../types/data-provider";
+export type { QueryEntry } from "../market-data/result-types";
+export type { Quote } from "../types/financials";
+
+// A screener-style pane holds rows it fetched itself and overlays the live
+// feed on top. These are the host's helpers for that pattern: build the
+// subscription targets from the rows, merge the entries back in, and summarise
+// whether the feed is live, mixed, or polling for the footer.
+export {
+  buildScreenerQuoteTargets,
+  overlayScreenerQuoteEntries,
+  resolveScreenerQuoteFeedStatus,
+} from "../plugins/builtin/shared/screener-live-quotes";
+export type {
+  ScreenerQuoteFeedStatus,
+  ScreenerQuoteFreshness,
+  ScreenerQuoteRow,
+} from "../plugins/builtin/shared/screener-live-quotes";
+
+// The persisted "Live streaming" pane setting and its quick toggle, so a
+// plugin pane offers the same control, on the same key, as the built-ins.
+export {
+  LIVE_STREAMING_QUICK_SETTING,
+  LIVE_STREAMING_SETTING_FIELD,
+  LIVE_STREAMING_SETTING_KEY,
+  resolveLiveStreamingSetting,
+  useLiveStreamingSetting,
+  withLiveStreamingSetting,
+} from "../plugins/builtin/shared/live-streaming";

package/src/public/react.ts

@@ -26,6 +26,7 @@ export {
   usePluginPaneState,
   usePluginState,
   usePluginTickerActions,
+  usePrunePluginPaneState,
   useSetPluginConfigStates,
 } from "../plugins/runtime";
 export type { PluginRuntimeAccess } from "../plugins/runtime";
@@ -54,9 +55,52 @@ export {
   useInputCapture,
   usePaneCollection,
   usePaneInstanceId,
+  usePaneSettingValue,
+  usePaneStateValue,
+  usePaneTitle,
   usePaneTicker,
   useTickers,
 } from "./pane-hooks";
 
 // Keyboard handling for plugin panes; the renderer decides how events arrive.
 export { useShortcut } from "../react/input";
+
+// The size of the surface the app is drawing into. A pane that pages or
+// virtualizes its own rows needs it, and it has to come from the renderer:
+// terminal cells, desktop pixels, and a browser tab are all different.
+export { useViewport } from "../react/input";
+
+// The pane's own instance record, for a pane whose template seeds `params`
+// (a CLI launch or a shortcut argument) and has to read them back on mount.
+export { usePaneInstance } from "../state/app/context";
+
+// Which ticker a pane is on, resolved the way the host resolves it: the pane's
+// own selection when it has one, the shared selection otherwise. A pane that
+// reads app state directly (rather than through `usePaneTicker`) needs it, and
+// the action type to dispatch back into the store.
+export { resolveTickerForPane } from "../state/app/context";
+export type { AppAction } from "../state/app/context";
+
+// Turning a row in a plugin's own table into the app's ticker selection, with
+// the host's rules for opening a new pane or reusing the current one.
+export { useTickerSourceActivate } from "../plugins/builtin/shared/ticker-source";
+
+// Financials and FX for a list of tickers, from the same query store the
+// built-in tables read, so a plugin table shows the values the rest of the app
+// already fetched instead of fetching them again.
+export { useFxRatesMap, useTickerFinancialsMap } from "../market-data/hooks";
+
+// Loading one thing asynchronously into a pane: data, loading, error, reload.
+// Every data pane needs this, and a plugin that hand-rolls it drifts from the
+// host's cancellation and stale-response handling.
+export { useAsyncResource } from "../react/async-resource";
+
+// Periodic refresh tied to app activity, and the "updated 2m ago" label that
+// goes with it, so plugin panes refresh on the same cadence as built-ins and
+// stop while the app is in the background. `AGE_TICK_MS` is that cadence, for
+// a pane that re-renders its own age column on the same clock.
+export { AGE_TICK_MS, useAutoRefresh, useUpdatedAgo } from "../plugins/builtin/shared/auto-refresh";
+
+// The class behind `useConnectionHealth()`. A value export so a plugin test
+// can construct one to exercise its own connection-status registration.
+export { ConnectionHealthRegistry } from "../core/connection-health";

package/src/public/remote.ts

@@ -0,0 +1,23 @@
+/**
+ * The running app's remote-control endpoint (`gloomberb/remote`).
+ *
+ * The app already answers a complete read and control protocol on a local
+ * port, described by `remote-control.<appKind>.json` in the data directory.
+ * A plugin that drives the app from outside the renderer, such as an agent
+ * holding a tool the model can call, sends requests through the same client
+ * and authentication the CLI uses rather than opening a second door into the
+ * app's state.
+ *
+ * Native only: reading the endpoint file needs the filesystem, so this is not
+ * a shared browser module and a renderer bundle that imports it fails to
+ * compile, which is the correct answer for a browser context.
+ */
+
+export { sendRemoteControlRequest } from "../remote/client";
+export type { SendRemoteControlRequestOptions } from "../remote/client";
+export type {
+  RemoteAppKind,
+  RemoteControlRequest,
+  RemoteControlResponse,
+  RemoteMarketDataRequest,
+} from "../remote/types";

package/src/public/test-support.ts

@@ -12,10 +12,55 @@
 
 export { MemoryPluginPersistence } from "../test-support/plugin-persistence";
 
-export { TestDialogProvider, testRender } from "../renderers/opentui/test-utils";
+// A doubled plugin runtime, so a pane test can exercise the state a pane keeps
+// across renders without standing up the whole app.
+export {
+  createConfigBackedTestPluginRuntime,
+  createStatefulTestPluginRuntime,
+  createTestPluginRuntime,
+} from "../test-support/plugin-runtime";
+export { PluginRenderProvider } from "../plugins/runtime";
+
+export {
+  createOpenTuiTestRoot,
+  emitKeypress,
+  settleFrame,
+  TestDialogProvider,
+  testRender,
+} from "../renderers/opentui/test-utils";
+export type { TestKeyEvent } from "../renderers/opentui/test-utils";
 
 export { AppContext, PaneInstanceProvider } from "../state/app/context";
+export { appReducer } from "../state/app/context";
 export { createInitialState } from "../core/state/app/state";
+export type { PaneRuntimeState } from "../core/state/app/state";
+
+// The providers the app wraps a pane in, and a ticker record shaped like a
+// saved one, so a pane test renders through the same context stack as the app
+// instead of a hand-built approximation of it.
+export { TestPaneProvider, createTestPaneConfig, createTestTicker } from "../test-support/pane";
+
+// A data provider that answers from fixtures, for a pane whose rows come from
+// quotes, financials, or instrument search.
+export { createTestDataProvider } from "../test-support/data-provider";
+
+// The registry and market data a pane reads through when it is not handed
+// them as props. A suite that sets them is responsible for clearing them.
+export {
+  getSharedMarketData,
+  setSharedMarketDataForTests,
+  setSharedRegistryForTests,
+} from "../plugins/registry/shared";
+export type { PluginRegistry } from "../plugins/registry";
+
+// Ticker persistence on a temporary directory, for a test that exercises the
+// real save path rather than a double of it.
+export { JsonTickerRepository } from "../data/json-ticker-repository";
+
+// The pane chrome the app draws around a plugin pane. A test that asserts on
+// footer status has to render it the same way, or it is asserting on a footer
+// the user never sees.
+export { PaneFooterBar, PaneFooterProvider } from "../components/layout/pane/footer";
 
 // Broker plugins test against the real account cache and persistence rather
 // than a hand-rolled double that drifts from how the app actually stores rows.

package/src/public/tickers.ts

@@ -0,0 +1,40 @@
+/**
+ * Adding tickers the app does not have yet (`gloomberb/tickers`).
+ *
+ * A pane that resolves symbols a user (or a model) named has to turn a search
+ * result into a saved ticker exactly as the command bar does: the same symbol
+ * and exchange normalization, the same broker contract identity, the same
+ * "already saved" rule. Doing it by hand produces near-duplicates the rest of
+ * the app then disagrees about.
+ *
+ * It is a shared host module: the repository and the event bus are the running
+ * app's, and a bundled copy would write into a store nothing else reads.
+ *
+ * Compatibility commitment: see the note in `./utils.ts`.
+ */
+
+import type { AppTickerRepositoryPort } from "../core/app-service-ports";
+import { getSharedRegistry } from "../plugins/registry/shared";
+import type { TickerRecord } from "../types/ticker";
+
+export { findExactTickerSearchMatch, upsertTickerFromSearchResult } from "../tickers/search";
+
+/**
+ * The repository the running app saves tickers in, or null before services are
+ * constructed (a CLI command that never initialized them, a unit test). Treat
+ * null as "cannot save right now" rather than creating a second store.
+ */
+export function getTickerRepository(): AppTickerRepositoryPort | null {
+  return getSharedRegistry()?.tickerRepository ?? null;
+}
+
+/**
+ * Announces a ticker a plugin just created, so panes, watchlists, and other
+ * plugins see it the same way they see one added from the command bar.
+ */
+export function emitTickerAdded(ticker: TickerRecord): void {
+  getSharedRegistry()?.events.emit("ticker:added", {
+    symbol: ticker.metadata.ticker,
+    ticker,
+  });
+}

package/src/public/time-series.ts

@@ -6,3 +6,8 @@
  */
 export * from "../time-series/range";
 export * from "../time-series/resolution";
+
+// The resolved shape itself: what a chart-series capability returns and what
+// the composite chart draws. A plugin that answers `chartSeriesProvider`
+// builds one of these.
+export * from "../time-series/types";

package/src/public/utils.ts

@@ -7,8 +7,8 @@
  * when a real plugin needs it, and prefer widening later over exporting
  * speculatively.
  *
- * `scripts/check-public-api.ts` pins the exported names so the surface cannot
- * grow by accident during an unrelated refactor.
+ * `src/public/public-api.test.ts` checks that every subpath resolves and that a
+ * bundled plugin shares the host's module instances.
  */
 
 export { createThrottledFetch } from "../utils/throttled-fetch";
@@ -75,3 +75,39 @@ export { splitLongTextSegmentByDisplayWidth, truncateWithEllipsis, wrapTextLines
 export { httpFetch, setHttpFetchTransport } from "../utils/http-transport";
 export type { HttpFetchTransport } from "../utils/http-transport";
 export { debugLog } from "../utils/debug-log";
+
+// A pane that fetches on its own schedule and wants to survive restarts: a
+// persisted cache keyed by the plugin, with a TTL and a stale-while-refresh
+// read. The Fear & Greed and IPO calendar plugins both keep their last good
+// payload this way so the pane has something to show before the first fetch.
+export { createPluginCache } from "../data/plugin-cache";
+export type { PluginCacheResult } from "../data/plugin-cache";
+
+// Table sorting, so a plugin table cycles its sort the same way built-in ones
+// do and orders mixed null/number/string columns identically.
+export { compareSortValues, cycleSortPreference } from "../utils/sort-values";
+export type { SortDirection, SortPreference } from "../utils/sort-values";
+
+// Exchange schedules are published as wall-clock times in a named zone.
+export { zonedDateTimeParts, zonedWallClockToUtcMs } from "../utils/zoned-date-time";
+
+// A list pane with a search field hands the arrow keys between the two.
+export { isPlainArrowDown, isPlainArrowUp, stopSearchFocusNavigation } from "../utils/search-focus-navigation";
+
+// Timing for the work a pane does on the main thread: parsing a large payload,
+// rebuilding rows, re-sorting a table. Slow samples are logged by the host's
+// perf logger, so a plugin's hot paths show up in the same trace as the app's
+// instead of being invisible.
+export { measurePerf, measurePerfAsync } from "../utils/perf-marks";
+
+// Opening a URL a provider handed back, and bounding a call that may never
+// answer. Both are security or startup rules the host already settled: an
+// auth flow must not launch a `file:` or `javascript:` URL, and optional
+// discovery must not hold up a launch forever.
+export { safeExternalUrl } from "../utils/external-url";
+export { withDeadline } from "../utils/async-deadline";
+
+// Which renderer this copy of the plugin is running in. A plugin with a native
+// half needs it to tell the terminal, where it owns the panes, from the Bun
+// process behind the desktop view, where it only answers capability calls.
+export { getCurrentPluginTarget } from "../plugins/current-target";