gloomberb 0.10.0 → 0.10.2

package/src/plugins/builtin/correlation/compute.ts

@@ -1,4 +1,5 @@
 import type { PricePoint } from "../../../types/financials";
+import { getPricePointTimestamp } from "../../../utils/price-history";
 
 export interface DatedReturn {
   dateKey: string;
@@ -10,21 +11,14 @@ export interface CorrelationResult {
   sampleSize: number;
 }
 
-function getPointTimestamp(point: PricePoint): number {
-  const value = point.date as Date | string | number | null | undefined;
-  if (value instanceof Date) return value.getTime();
-  if (value == null) return Number.NaN;
-  return new Date(value).getTime();
-}
-
 function toDateKey(point: PricePoint): string | null {
-  const timestamp = getPointTimestamp(point);
+  const timestamp = getPricePointTimestamp(point);
   if (!Number.isFinite(timestamp)) return null;
   return new Date(timestamp).toISOString().slice(0, 10);
 }
 
 function comparePricePointsByDate(left: PricePoint, right: PricePoint): number {
-  return getPointTimestamp(left) - getPointTimestamp(right);
+  return getPricePointTimestamp(left) - getPricePointTimestamp(right);
 }
 
 export function computeReturns(closes: number[]): number[] {
@@ -40,7 +34,7 @@ export function computeReturns(closes: number[]): number[] {
 
 export function computeDatedReturns(points: PricePoint[]): DatedReturn[] {
   const sorted = [...points]
-    .filter((point) => Number.isFinite(getPointTimestamp(point)) && Number.isFinite(point.close))
+    .filter((point) => Number.isFinite(getPricePointTimestamp(point)) && Number.isFinite(point.close))
     .sort(comparePricePointsByDate);
   const byDate = new Map<string, number>();
 

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

@@ -1,7 +1,7 @@
 import { Box } from "../../../ui";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { TextAttributes, type ScrollBoxRenderable } from "../../../ui";
-import { DataTableStackView, usePaneFooter, type DataTableCell } from "../../../components";
+import { DataTableStackView, type DataTableCell, type PaneFooterSegment } from "../../../components";
 import type { PaneProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
 import { colors, blendHex } from "../../../theme/colors";
@@ -30,6 +30,7 @@ import {
   type ImpactFilter,
 } from "./calendar-model";
 import { attachFredSeriesPersistence } from "../../../data/fred-series";
+import { usePaneStatusFooter } from "../shared/pane-footer";
 
 function EconCalendarPane({ focused, width, height }: PaneProps) {
   const [initialCache] = useState(() => getCalendarCache());
@@ -221,24 +222,21 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
       ].filter(Boolean).join(" · ") || undefined
     : undefined;
 
-  usePaneFooter("econ-calendar", () => ({
-    info: [
-      { id: "impact", parts: [{ text: `impact: ${impactFilter}`, tone: impactFilter === "all" ? "muted" : "value" }] },
-      { id: "country", parts: [{ text: `country: ${countryFilter}`, tone: countryFilter === "all" ? "muted" : "value" }] },
-      ...(nextEvent && nextCountdown ? [{
-        id: "next",
-        parts: [{ text: `Next: ${nextEvent.event.length > 18 ? nextEvent.event.slice(0, 18).trimEnd() : nextEvent.event} ${nextCountdown}`, tone: "muted" as const }],
-      }] : []),
-      ...(staleness ? [{ id: "stale", parts: [{ text: staleness, tone: "muted" as const }] }] : []),
-      ...(loading ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }] : []),
-      ...(error ? [{ id: "error", parts: [{ text: error, tone: "warning" as const }] }] : []),
-    ],
-    hints: [
-      { id: "impact", key: "f", label: "impact", onPress: cycleImpactFilter },
-      { id: "country", key: "c", label: "ountry", onPress: cycleCountryFilter },
-      { id: "refresh", key: "r", label: "efresh", onPress: () => load(true) },
-    ],
-  }), [countryFilter, cycleCountryFilter, cycleImpactFilter, error, impactFilter, load, loading, nextCountdown, nextEvent?.event, staleness]);
+  const calendarStatus = useMemo<PaneFooterSegment[]>(() => [
+    ...(impactFilter !== "all" ? [{ id: "impact", parts: [{ text: `impact: ${impactFilter}`, tone: "value" as const }] }] : []),
+    ...(countryFilter !== "all" ? [{ id: "country", parts: [{ text: `country: ${countryFilter}`, tone: "value" as const }] }] : []),
+    ...(nextEvent && nextCountdown ? [{
+      id: "next",
+      parts: [{ text: `Next: ${nextEvent.event.length > 18 ? nextEvent.event.slice(0, 18).trimEnd() : nextEvent.event} ${nextCountdown}`, tone: "muted" as const }],
+    }] : []),
+    ...(staleness ? [{ id: "stale", parts: [{ text: staleness, tone: "muted" as const }] }] : []),
+  ], [countryFilter, impactFilter, nextCountdown, nextEvent?.event, staleness]);
+  usePaneStatusFooter({
+    registrationId: "econ-calendar",
+    loading,
+    error,
+    info: calendarStatus,
+  });
 
   const handleHeaderClick = useCallback(() => {}, []);
   const openDisplayRow = useCallback((row: DisplayRow) => {

package/src/plugins/builtin/holders/types.ts

@@ -5,7 +5,6 @@ export type ViewMode = "table" | "chart";
 export type HolderColumnId = "holder" | "value" | "shares" | "changeShares" | "changePercent" | "percentHeld" | "reportDate";
 export type HolderColumn = DataTableColumn & { id: HolderColumnId };
 export type SortDirection = "asc" | "desc";
-export type PreventableMouseEvent = { preventDefault(): void };
 
 export interface SortPreference {
   columnId: HolderColumnId;

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

@@ -1,10 +1,9 @@
 import { Text } from "../../../ui";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback, useMemo, useState } from "react";
 import type { PluginModule } from "../plugin-module";
 import type { SecFilingItem } from "../../../types/data-provider";
 import {
   useResolvedEntryValue,
-  useSecFilingContent,
   useSecFilingsQuery,
 } from "../../../market-data/hooks";
 import { instrumentFromTicker } from "../../../market-data/request-types";
@@ -24,6 +23,7 @@ import {
   formatFilingShortDate,
   renderFilingNotice,
 } from "../sec/filing-display";
+import { useSecFilingContentCache } from "../sec/filing-content";
 
 const FORM4_LIMIT = 20;
 const NINETY_DAYS_MS = 90 * 24 * 60 * 60 * 1000;
@@ -125,34 +125,10 @@ function InsiderView({ width, height, focused }: { width: number; height: number
       ? (filingsEntry.error?.message ?? "Failed to load SEC filings")
       : null;
 
-  // Fetch content for each Form 4 filing sequentially via an index pointer
-  const [contentMap, setContentMap] = useState<Map<string, string | null>>(new Map());
-  const [fetchPointer, setFetchPointer] = useState(0);
-
-  // Reset when ticker changes
-  useEffect(() => {
-    setContentMap(new Map());
-    setFetchPointer(0);
-  }, [ticker?.metadata.ticker]);
-
-  // Pick the next un-fetched filing to load
-  const nextToFetch = form4Filings.find((f) => !contentMap.has(f.accessionNumber)) ?? null;
-  const contentEntry = useSecFilingContent(nextToFetch);
-  const contentValue = useResolvedEntryValue(contentEntry);
-
-  useEffect(() => {
-    if (!nextToFetch) return;
-    if (contentEntry?.phase === "error") {
-      setContentMap((prev) => new Map(prev).set(nextToFetch.accessionNumber, null));
-      setFetchPointer((p) => p + 1);
-      return;
-    }
-    if (contentValue !== null && contentValue !== undefined) {
-      setContentMap((prev) => new Map(prev).set(nextToFetch.accessionNumber, contentValue));
-      setFetchPointer((p) => p + 1);
-    }
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [contentValue, contentEntry?.phase, nextToFetch?.accessionNumber, fetchPointer]);
+  const { contentCache: contentMap, pendingCount } = useSecFilingContentCache({
+    scopeKey: `${ticker?.metadata.ticker ?? "none"}:${ticker?.metadata.exchange ?? ""}`,
+    targets: form4Filings,
+  });
 
   const allParsed: ParsedFiling[] = useMemo(() => form4Filings.map((filing) => {
     const hasContent = contentMap.has(filing.accessionNumber);
@@ -172,7 +148,6 @@ function InsiderView({ width, height, focused }: { width: number; height: number
   ), [allParsed, nameFilter]);
   const feedItems = useMemo(() => toFeedItems(parsed), [parsed]);
   const summary = useMemo(() => buildSummary(allParsed), [allParsed]);
-  const pendingCount = form4Filings.filter((f) => !contentMap.has(f.accessionNumber)).length;
   const selectedTransaction = parsed[selectedIdx]?.transaction ?? null;
   const openFiling = openItemId
     ? parsed.find(({ filing }) => filing.accessionNumber === openItemId)?.filing ?? null

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

@@ -107,17 +107,15 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
     }
   }, [news.length, selectedIdx, setSelectedIdx]);
 
-  const footerInfo = useMemo(() => [
-    ...(loading ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }] : []),
-    ...(error ? [{ id: "error", parts: [{ text: "error", tone: "warning" as const }] }] : []),
-    ...(loadingSummary ? [{ id: "summary", parts: [{ text: "summary loading", tone: "muted" as const }] }] : []),
-  ], [error, loading, loadingSummary]);
-
   useNewsArticleFooter({
     registrationId: "news",
     focused,
     article: openArticle,
-    info: footerInfo,
+    loading,
+    error,
+    info: loadingSummary
+      ? [{ id: "summary", parts: [{ text: "summary loading", tone: "muted" as const }] }]
+      : undefined,
   });
 
   if (!ticker) return <Text fg={colors.textDim}>Select a ticker to view news.</Text>;

package/src/plugins/builtin/news/wire/breaking/pane.test.tsx

@@ -10,7 +10,7 @@ import { createStatefulTestPluginRuntime } from "../../../../../test-support/plu
 import { createDefaultConfig } from "../../../../../types/config";
 import { Box } from "../../../../../ui";
 import { PluginRenderProvider } from "../../../../runtime";
-import { __setDetectedProvidersForTests } from "../../../ai/providers";
+import { setDetectedProviders } from "../../../ai/providers";
 import { setAiRunHost } from "../../../ai/runner";
 import { BreakingPane } from "./pane";
 
@@ -53,18 +53,16 @@ function createReadyNewsService(articles: NewsArticle[]): { service: NewsService
     updatedAt: Date.now(),
     sourceIds: ["test"],
   };
-  const listeners = new Set<() => void>();
+  const listeners = new Set<(state: NewsQueryState) => void>();
   let queryStateCalls = 0;
   const service = {
-    subscribe(listener: () => void) {
+    watchQuery(_query: unknown, listener: (state: NewsQueryState) => void) {
       listeners.add(listener);
+      listener(state);
       return () => {
         listeners.delete(listener);
       };
     },
-    getVersion() {
-      return 1;
-    },
     getQueryState() {
       queryStateCalls += 1;
       return state;
@@ -110,7 +108,7 @@ function createHarness() {
 afterEach(async () => {
   setSharedNewsService(null);
   setAiRunHost(null);
-  __setDetectedProvidersForTests(null);
+  setDetectedProviders(null);
   if (testSetup) {
     await act(async () => {
       testSetup!.renderer.destroy();
@@ -124,7 +122,7 @@ describe("BreakingPane", () => {
     let runCalls = 0;
     const newsService = createReadyNewsService([makeArticle()]);
     setSharedNewsService(newsService.service);
-    __setDetectedProvidersForTests([
+    setDetectedProviders([
       {
         id: "anthropic",
         name: "Claude",

package/src/plugins/builtin/news/wire/news/footer.ts

@@ -1,10 +1,10 @@
 import { useCallback, useMemo } from "react";
-import { useExternalLinkFooter, type PaneFooterSegment, type PaneHint } from "../../../../../components";
+import type { PaneFooterSegment } from "../../../../../components";
 import { useShortcut } from "../../../../../react/input";
 import { useRendererHost } from "../../../../../ui";
 import { apiClient } from "../../../../../api-client";
-
-const CLOUD_UPGRADE_URL = "https://gloom.sh/cloud";
+import { usePaneStatusLinkFooter } from "../../../shared/pane-footer";
+import { CLOUD_UPGRADE_URL } from "../../../shared/cloud-upgrade";
 
 interface NewsFooterArticle {
   source?: string | null;
@@ -16,7 +16,8 @@ interface UseNewsArticleFooterOptions {
   focused: boolean;
   article: NewsFooterArticle | null | undefined;
   info?: PaneFooterSegment[];
-  hints?: PaneHint[];
+  loading?: boolean;
+  error?: string | null;
 }
 
 function hasRealtimeNewsAccess(): boolean {
@@ -29,7 +30,8 @@ export function useNewsArticleFooter({
   focused,
   article,
   info,
-  hints,
+  loading = false,
+  error,
 }: UseNewsArticleFooterOptions) {
   const rendererHost = useRendererHost();
   const hasRealtimeAccess = hasRealtimeNewsAccess();
@@ -60,18 +62,15 @@ export function useNewsArticleFooter({
         parts: [{ text: "delayed 12h, upgrade for realtime", tone: "warning" }],
       }]
   ), [hasRealtimeAccess, openUpgrade, showAccessFooter]);
-  const upgradeHints = useMemo<PaneHint[]>(() => (
-    showAccessFooter && !hasRealtimeAccess ? [{ id: "upgrade", key: "u", label: "pgrade", onPress: openUpgrade }] : []
-  ), [hasRealtimeAccess, openUpgrade, showAccessFooter]);
   const footerInfo = useMemo(() => [...accessInfo, ...(info ?? [])], [accessInfo, info]);
-  const footerHints = useMemo(() => [...upgradeHints, ...(hints ?? [])], [hints, upgradeHints]);
 
-  useExternalLinkFooter({
+  usePaneStatusLinkFooter({
     registrationId,
     focused,
     url: article?.url,
     source: article?.source,
     info: footerInfo,
-    hints: footerHints,
+    loading,
+    error,
   });
 }

package/src/plugins/builtin/news/wire/read-state.test.ts

@@ -3,6 +3,7 @@ import {
   MAX_READ_ARTICLE_IDS,
   markNewsArticleRead,
   normalizeNewsReadState,
+  type NewsReadState,
 } from "./read-state";
 
 describe("news read state", () => {
@@ -27,4 +28,10 @@ describe("news read state", () => {
     expect(state.articleIds[0]).toBe("id-0");
     expect(state.articleIds.at(-1)).toBe(`id-${MAX_READ_ARTICLE_IDS - 1}`);
   });
+
+  test("repairs persisted state with a missing article list", () => {
+    const state = normalizeNewsReadState({} as NewsReadState);
+
+    expect(state).toEqual({ articleIds: [] });
+  });
 });

package/src/plugins/builtin/news/wire/read-state.ts

@@ -1,10 +1,9 @@
-import { useCallback, useMemo } from "react";
-import { usePluginState } from "../../../runtime";
 import {
   DEFAULT_MAX_READ_IDS,
-  markReadId,
-  normalizeReadIds,
-  sameStringArray,
+  markPersistedReadId,
+  normalizePersistedReadIdState,
+  usePersistedReadIds,
+  type PersistedReadIdAdapter,
 } from "../../shared/read-state";
 
 export interface NewsReadState {
@@ -16,38 +15,29 @@ export const MAX_READ_ARTICLE_IDS = DEFAULT_MAX_READ_IDS;
 
 const READ_STATE_KEY = "read-articles";
 const EMPTY_READ_STATE: NewsReadState = { articleIds: [] };
+const NEWS_READ_STATE_ADAPTER: PersistedReadIdAdapter<NewsReadState> = {
+  getIds: (state) => state.articleIds,
+  withIds: (_state, articleIds) => ({ articleIds }),
+  maxIds: MAX_READ_ARTICLE_IDS,
+};
 
 export function normalizeNewsReadState(state: NewsReadState): NewsReadState {
-  return { articleIds: normalizeReadIds(state.articleIds, MAX_READ_ARTICLE_IDS) };
+  return normalizePersistedReadIdState(state, NEWS_READ_STATE_ADAPTER);
 }
 
 export function markNewsArticleRead(
   state: NewsReadState,
   articleId: string,
 ): NewsReadState {
-  const current = normalizeNewsReadState(state).articleIds;
-  const articleIds = markReadId(current, articleId, MAX_READ_ARTICLE_IDS);
-
-  return sameStringArray(articleIds, state.articleIds) ? state : { articleIds };
+  return markPersistedReadId(state, articleId, NEWS_READ_STATE_ADAPTER);
 }
 
 export function useNewsReadState() {
-  const [readState, setReadState] = usePluginState<NewsReadState>(
-    READ_STATE_KEY,
-    EMPTY_READ_STATE,
-    { schemaVersion: NEWS_READ_STATE_SCHEMA_VERSION },
-  );
-  const normalizedReadState = useMemo(
-    () => normalizeNewsReadState(readState),
-    [readState],
-  );
-  const readArticleIds = useMemo(
-    () => new Set(normalizedReadState.articleIds),
-    [normalizedReadState],
-  );
-  const markArticleRead = useCallback((articleId: string) => {
-    setReadState((current) => markNewsArticleRead(current, articleId));
-  }, [setReadState]);
-
-  return { readArticleIds, markArticleRead };
+  const { readIds, markRead } = usePersistedReadIds({
+    key: READ_STATE_KEY,
+    fallback: EMPTY_READ_STATE,
+    schemaVersion: NEWS_READ_STATE_SCHEMA_VERSION,
+    adapter: NEWS_READ_STATE_ADAPTER,
+  });
+  return { readArticleIds: readIds, markArticleRead: markRead };
 }

package/src/plugins/builtin/news/wire/rss/parser.ts

@@ -1,4 +1,5 @@
 import type { MarketNewsItem } from "../../../../../types/news-source";
+import { decodeHtmlEntities } from "../../../../../utils/html-entities";
 import { hashString } from "../hash";
 
 export interface RssFeedConfig {
@@ -10,17 +11,6 @@ export interface RssFeedConfig {
   enabled: boolean;
 }
 
-function decodeHtmlEntities(s: string): string {
-  return s
-    .replace(/&/g, "&")
-    .replace(/&lt;/g, "<")
-    .replace(/&gt;/g, ">")
-    .replace(/&quot;/g, '"')
-    .replace(/&#39;/g, "'")
-    .replace(/&apos;/g, "'")
-    .replace(/&nbsp;/g, " ");
-}
-
 function stripCdata(s: string): string {
   return s.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, (_, inner) => inner);
 }

package/src/plugins/builtin/options/footer.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, test } from "bun:test";
+import type { OptionsChain } from "../../../types/financials";
+import { buildOptionsAccessFooterSegment, resolveOptionsAccessFooterState } from "./footer";
+
+function chain(overrides: Partial<OptionsChain> = {}): OptionsChain {
+  return {
+    underlyingSymbol: "AAPL",
+    expirationDates: [],
+    calls: [],
+    puts: [],
+    ...overrides,
+  };
+}
+
+describe("options access footer", () => {
+  test("offers free users the exact delayed upgrade state with a clickable segment", () => {
+    const state = resolveOptionsAccessFooterState({
+      chain: chain({
+        dataSource: "delayed",
+        delayMinutes: 15,
+        realtimeEligible: false,
+      }),
+      clientPlan: "free",
+      hasLiveQuote: false,
+    });
+    let upgrades = 0;
+    const segment = buildOptionsAccessFooterSegment(state, () => {
+      upgrades += 1;
+    });
+
+    expect(state).toEqual({
+      canUpgrade: true,
+      text: "15-minute delayed options, upgrade for real-time",
+      tone: "warning",
+    });
+    segment.onPress?.();
+    expect(upgrades).toBe(1);
+  });
+
+  test("claims real-time only for a Pro user with a fresh live stream", () => {
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({
+          dataSource: "delayed",
+          delayMinutes: 15,
+          realtimeEligible: true,
+        }),
+        clientPlan: "pro",
+        hasLiveQuote: false,
+      }),
+    ).toMatchObject({
+      canUpgrade: false,
+      text: "options delayed fallback",
+      tone: "warning",
+    });
+
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({
+          dataSource: "live",
+          delayMinutes: 0,
+          realtimeEligible: true,
+        }),
+        clientPlan: "pro",
+        hasLiveQuote: false,
+      }),
+    ).toMatchObject({
+      canUpgrade: false,
+      text: "options delayed fallback",
+      tone: "warning",
+    });
+
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({ realtimeEligible: false }),
+        clientPlan: "pro",
+        hasLiveQuote: true,
+      }).text,
+    ).toBe("real-time options");
+  });
+
+  test("makes the current plan authoritative over cached chain metadata", () => {
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({
+          dataSource: "live",
+          delayMinutes: 0,
+          realtimeEligible: true,
+        }),
+        clientPlan: "free",
+        hasLiveQuote: true,
+      }),
+    ).toMatchObject({
+      canUpgrade: true,
+      text: "15-minute delayed options, upgrade for real-time",
+      tone: "warning",
+    });
+
+    expect(
+      resolveOptionsAccessFooterState({
+        chain: chain({
+          dataSource: "delayed",
+          delayMinutes: 15,
+          realtimeEligible: false,
+        }),
+        clientPlan: "pro",
+        hasLiveQuote: true,
+      }),
+    ).toMatchObject({
+      canUpgrade: false,
+      text: "real-time options",
+      tone: "positive",
+    });
+  });
+});

package/src/plugins/builtin/options/footer.ts

@@ -0,0 +1,110 @@
+import { useCallback, useMemo } from "react";
+import type { PaneFooterSegment } from "../../../components";
+import { apiClient } from "../../../api-client";
+import { t, tf } from "../../../i18n";
+import { useShortcut } from "../../../react/input";
+import type { OptionsChain } from "../../../types/financials";
+import { useRendererHost } from "../../../ui";
+import { CLOUD_UPGRADE_URL } from "../shared/cloud-upgrade";
+import { usePaneStatusFooter } from "../shared/pane-footer";
+
+export interface OptionsAccessFooterState {
+  canUpgrade: boolean;
+  text: string;
+  tone: "positive" | "warning";
+}
+
+export function resolveOptionsAccessFooterState({
+  chain,
+  clientPlan,
+  hasLiveQuote,
+}: {
+  chain: OptionsChain | null | undefined;
+  clientPlan: "free" | "pro" | null;
+  hasLiveQuote: boolean;
+}): OptionsAccessFooterState {
+  if (clientPlan !== "pro") {
+    const delayMinutes = chain?.delayMinutes && chain.delayMinutes > 0 ? chain.delayMinutes : 15;
+    return {
+      canUpgrade: true,
+      text: tf("{count}-minute delayed options, upgrade for real-time", {
+        count: delayMinutes,
+      }),
+      tone: "warning",
+    };
+  }
+
+  if (hasLiveQuote) {
+    return {
+      canUpgrade: false,
+      text: t("real-time options"),
+      tone: "positive",
+    };
+  }
+
+  return {
+    canUpgrade: false,
+    text: t("options delayed fallback"),
+    tone: "warning",
+  };
+}
+
+export function buildOptionsAccessFooterSegment(
+  state: OptionsAccessFooterState,
+  openUpgrade: () => void,
+): PaneFooterSegment {
+  return {
+    id: "options-access",
+    ...(state.canUpgrade ? { onPress: openUpgrade } : {}),
+    parts: [{ text: state.text, tone: state.tone }],
+  };
+}
+
+export function useOptionsAccessFooter({
+  chain,
+  error,
+  focused,
+  hasLiveQuote,
+  loading,
+}: {
+  chain: OptionsChain | null | undefined;
+  error?: string | null;
+  focused: boolean;
+  hasLiveQuote: boolean;
+  loading?: boolean;
+}): OptionsAccessFooterState {
+  const rendererHost = useRendererHost();
+  const user = apiClient.getCurrentUser();
+  const clientPlan = user?.emailVerified === true && user.plan === "pro" ? "pro" : "free";
+  const state = resolveOptionsAccessFooterState({
+    chain,
+    clientPlan,
+    hasLiveQuote,
+  });
+  const openUpgrade = useCallback(() => {
+    void rendererHost.openExternal(CLOUD_UPGRADE_URL);
+  }, [rendererHost]);
+
+  useShortcut(
+    (event) => {
+      const key = (event.name ?? event.key ?? "").toLowerCase();
+      if (!focused || !state.canUpgrade || key !== "u") return;
+      event.stopPropagation();
+      event.preventDefault();
+      openUpgrade();
+    },
+    { scope: "options:upgrade" },
+  );
+
+  const info = useMemo(
+    () => [buildOptionsAccessFooterSegment(state, openUpgrade)],
+    [openUpgrade, state.canUpgrade, state.text, state.tone],
+  );
+  usePaneStatusFooter({
+    registrationId: "options",
+    loading,
+    error,
+    info,
+  });
+  return state;
+}