gloomberb 0.19.0 → 0.19.2

package/src/components/layout/pane/footer/model.ts

@@ -1,5 +1,6 @@
 import type { ContextMenuItem } from "../../../../types/context-menu";
-import { t } from "../../../../i18n";
+import { t, tf } from "../../../../i18n";
+import { type CompanyFrom, companyFromLabel } from "../../../../types/company-from";
 import { clipToDisplayWidth, displayWidth } from "../../../../utils/format";
 import { formatShortDate } from "../../../../utils/datetime-format";
 import { getShortcutHintWidth } from "../../../ui/shortcut-hint";
@@ -44,11 +45,19 @@ export interface PaneFooterSegment {
    */
   quoteStatus?: boolean;
   /**
-   * The segment says what the rows leave out (releases a filter hides), which
-   * a picture of the rows cannot: a `gloom shot` keeps it, as it keeps a
+   * The segment says what the rows leave out (releases a filter hides), or
+   * whose they are (a receipt's company data from its home line), which a
+   * picture of the rows cannot: a `gloom shot` keeps it, as it keeps a
    * warning.
    */
   capture?: boolean;
+  /**
+   * When the copy the pane shows was saved, on the saved-copy segment
+   * ({@link savedCopyFooterSegment}). The footer draws that segment first,
+   * wherever a pane registers it, and once: the oldest when several parts of
+   * the pane show a saved copy.
+   */
+  savedCopyAt?: number;
   /**
    * Shorter forms of `parts`, longest first. When the row is too narrow for
    * `parts` beside the hints, it shows the first that fits, or the last, and
@@ -111,12 +120,43 @@ export function savedCopyFooterSegment(id: string, savedAt: number, now = Date.n
   return {
     id,
     quoteStatus: true,
+    savedCopyAt: savedAt,
     title: `${t("Couldn't refresh")}: ${text}`,
     parts: [{ text, tone: "warning" }],
     variants: [[{ text: t("saved copy"), tone: "warning" }]],
   };
 }
 
+/**
+ * The saved-copy segment of a pane showing several answers (a list and the
+ * report it opens): the oldest of the copies among `savedAts` (ms), or no
+ * segment when none of them is one.
+ */
+export function savedCopyFooterInfo(savedAts: readonly (number | null | undefined)[], id = "saved-copy"): PaneFooterSegment[] {
+  const times = savedAts.filter((at): at is number => typeof at === "number" && Number.isFinite(at));
+  return times.length > 0 ? [savedCopyFooterSegment(id, Math.min(...times))] : [];
+}
+
+/**
+ * The footer's one form for company data a pane shows from another listing
+ * of the company: a receipt or a foreign line (SKHY, HY9H in Frankfurt) reads
+ * its home line's news, filings or holders, `company data from 000660 KRX`.
+ * Null when the data is the listing's own.
+ */
+export function companyDataFooterSegment(from: CompanyFrom | null | undefined): PaneFooterSegment | null {
+  if (!from) return null;
+  const listing = companyFromLabel(from);
+  const text = tf("company data from {listing}", { listing });
+  return {
+    id: "company-data",
+    title: from.name ? `${text} (${from.name})` : text,
+    // A capture of the rows keeps it: the picture cannot say whose they are.
+    capture: true,
+    parts: [{ text, tone: "muted" }],
+    variants: [[{ text: tf("from {listing}", { listing }), tone: "muted" }]],
+  };
+}
+
 /** A pane whose market data is all delayed, by no one figure: the clock alone, its tooltip saying so. */
 export const DELAYED_SEGMENT: PaneFooterSegment = delayedFooterSegment({ id: "delayed", detail: "Delayed market data" });
 
@@ -202,6 +242,25 @@ const INFO_FLOOR_CHARS = 10;
 const WARNING_FLOOR_CHARS = 24;
 const HINT_GAP = 1;
 
+/**
+ * What the footer draws between two info segments, muted, as a status draws
+ * between its own parts ("Newest story Mon 14:23 · 12h delayed"): two
+ * segments side by side never read as one sentence ("company data from PBR ·
+ * as of 2026-06-30"). An icon (`⚠[!]`, `◷15m`) is a mark, not a phrase: a
+ * column sets it apart.
+ */
+export const PANE_FOOTER_SEPARATOR = " · ";
+const SEPARATOR_WIDTH = displayWidth(PANE_FOOTER_SEPARATOR);
+
+/** Whether the footer draws {@link PANE_FOOTER_SEPARATOR} between two adjacent segments, else a one-column gap. */
+export function separatesPaneFooterSegments(before: Pick<PaneFooterSegment, "icon">, after: Pick<PaneFooterSegment, "icon">): boolean {
+  return !before.icon && !after.icon;
+}
+
+function segmentGapWidth(before: PaneFooterSegment, after: PaneFooterSegment): number {
+  return separatesPaneFooterSegments(before, after) ? SEPARATOR_WIDTH : 1;
+}
+
 function paneHintWidth(hint: Pick<PaneHint, "key" | "label">, prefix = ""): number {
   return getShortcutHintWidth(hint.key, hint.label, prefix);
 }
@@ -216,15 +275,12 @@ function infoTextWidth(segments: readonly PaneFooterSegment[]): number {
     const text = segment.parts.reduce((sum, part, partIndex) => (
       sum + (partIndex > 0 ? 1 : 0) + displayWidth(part.text)
     ), 0);
-    return total + (index > 0 ? 1 : 0) + text;
+    return total + (index > 0 ? segmentGapWidth(segments[index - 1]!, segment) : 0) + text;
   }, 0);
 }
 
-/**
- * The info segments as they fit `width`: segments with `variants` step down
- * together, one variant at a time, until the row fits or none is left.
- */
-export function fitPaneFooterInfo(info: PaneFooterSegment[], width: number, { besideHints = true }: { besideHints?: boolean } = {}): PaneFooterSegment[] {
+/** Segments with `variants` step down together, one variant at a time, until they fit or none is left. */
+function stepDownTogether(info: PaneFooterSegment[], width: number): PaneFooterSegment[] {
   const stages = Math.max(0, ...info.map((segment) => segment.variants?.length ?? 0));
   let fitted = info;
   for (let stage = 0; stage < stages && infoTextWidth(fitted) > width; stage += 1) {
@@ -237,20 +293,50 @@ export function fitPaneFooterInfo(info: PaneFooterSegment[], width: number, { be
       } : segment;
     });
   }
-  // A trailing status cut mid-word reads as part of the hints beside it ("quote 12h t[x] put"): one that does not
-  // fit ends in an ellipsis a column short of them, or is left out when less than half of it would show. A
-  // warning, an icon or a pressable segment stays as it is, clipped by the row if it must be. With no hints beside it
-  // (a pane picture's footer), the row clips it, so a frame that fits its own status line sees it overflow.
-  while (besideHints && fitted.length > 1 && infoTextWidth(fitted) > width) {
+  return fitted;
+}
+
+/**
+ * A trailing status cut mid-word reads as part of the hints beside it ("quote
+ * 12h t[x] put"): one that does not fit ends in an ellipsis a column short of
+ * them, or is left out when less than half of it would show, until the row
+ * fits or `keep` segments are left. A warning, an icon or a pressable segment
+ * stays as it is, clipped by the row if it must be.
+ */
+function trimTrailing(info: PaneFooterSegment[], width: number, keep: number): PaneFooterSegment[] {
+  let fitted = info;
+  while (fitted.length > keep && infoTextWidth(fitted) > width) {
     const last = fitted.at(-1)!;
     if (last.icon || last.onPress || last.parts.some((part) => part.tone === "warning" || part.tone === "negative")) break;
-    const room = width - infoTextWidth(fitted.slice(0, -1)) - 2;
+    // After the separator, a column short of the hints.
+    const room = width - infoTextWidth(fitted.slice(0, -1)) - segmentGapWidth(fitted.at(-2)!, last) - 1;
     if (room * 2 >= infoTextWidth([last])) return [...fitted.slice(0, -1), clipSegment(last, room)];
     fitted = fitted.slice(0, -1);
   }
   return fitted;
 }
 
+/**
+ * The info segments as they fit `width`: segments with `variants` step down
+ * together, one variant at a time, until the row fits or none is left; beside
+ * the hints, the trailing status that still does not fit is then cut or left
+ * out (trimTrailing). A status after every segment with shorter forms gives
+ * way first, before any of them shortens: a pane puts what goes first last
+ * (an update time after a note that explains the row in hand).
+ *
+ * With no hints beside it (a pane picture's footer), the row clips the rest,
+ * so a frame that fits its own status line sees it overflow.
+ */
+export function fitPaneFooterInfo(info: PaneFooterSegment[], width: number, { besideHints = true }: { besideHints?: boolean } = {}): PaneFooterSegment[] {
+  if (!besideHints) return stepDownTogether(info, width);
+  const lastWithVariants = info.findLastIndex((segment) => (segment.variants?.length ?? 0) > 0);
+  if (lastWithVariants >= 0 && lastWithVariants < info.length - 1 && infoTextWidth(info) > width) {
+    const trimmed = trimTrailing(info, width, lastWithVariants + 1);
+    if (infoTextWidth(trimmed) <= width) return trimmed;
+  }
+  return trimTrailing(stepDownTogether(info, width), width, 1);
+}
+
 /** A segment cut to `width` behind an ellipsis, each part keeping its tone; the full text stays as its title. */
 function clipSegment(segment: PaneFooterSegment, width: number): PaneFooterSegment {
   const full = segment.parts.map((part) => part.text).join(" ");
@@ -382,7 +468,20 @@ export function combinePaneFooterRegistrations(registrations: Map<string, PaneFo
   const shown = yielded.length > 0 ? hints.filter((hint) => !yielded.includes(hint)) : hints;
 
   if (info.length === 0 && shown.length === 0 && menu.length === 0 && keys.length === 0) return EMPTY_FOOTER;
-  return { info, hints: shown, menu, keys };
+  return { info: savedCopyFirst(info), hints: shown, menu, keys };
+}
+
+/**
+ * The saved-copy segment in its one place: first, so it reads the same in
+ * every pane and is the last a narrow row cuts, and once, the oldest copy,
+ * when a list and the report it opens each register one.
+ */
+function savedCopyFirst(info: PaneFooterSegment[]): PaneFooterSegment[] {
+  let oldest: PaneFooterSegment | undefined;
+  for (const segment of info) {
+    if (segment.savedCopyAt != null && (oldest?.savedCopyAt == null || segment.savedCopyAt < oldest.savedCopyAt)) oldest = segment;
+  }
+  return oldest ? [oldest, ...info.filter((segment) => segment.savedCopyAt == null)] : info;
 }
 
 function sameFooterParts(left: PaneFooterPart[], right: PaneFooterPart[]): boolean {
@@ -439,6 +538,7 @@ export function samePaneFooterRegistration(
         && segment.shortcut === other.shortcut
         && !!segment.onPress === !!other.onPress
         && segment.disabled === other.disabled
+        && segment.savedCopyAt === other.savedCopyAt
         && sameFooterParts(segment.parts, other.parts)
         && (segment.variants?.length ?? 0) === (other.variants?.length ?? 0)
         && (segment.variants ?? []).every((variant, variantIndex) => sameFooterParts(variant, other.variants![variantIndex]!));

package/src/components/layout/pane/header.tsx

@@ -178,13 +178,13 @@ export function PaneHeader({
     event.stopPropagation?.();
     onHeaderMouseDown?.(event);
   };
-  const beginWindowDrag = (event?: { stopPropagation?: () => void }) => {
+  const beginWindowDrag = (event?: { stopPropagation?: () => void; detail?: number }) => {
     event?.stopPropagation?.();
     if (titleBar) {
       onHeaderMouseDown?.(event);
       return;
     }
-    void rendererHost.startWindowDrag?.();
+    void rendererHost.startWindowDrag?.(event);
   };
   const barHandlers = windowDrag
     ? { onMouseDown: beginWindowDrag }

package/src/components/layout/pane/status-footer.ts

@@ -1,5 +1,7 @@
-import { useMemo } from "react";
-import { usePaneFooter, type PaneFooterSegment, type PaneHint } from "./footer";
+import { useId, useMemo } from "react";
+import { companyDataFooterSegment, usePaneFooter, type PaneFooterSegment, type PaneHint } from "./footer";
+import type { CompanyFrom } from "../../../types/company-from";
+import { useAppLanguage } from "../../../i18n/react";
 import { useExternalLinkFooter } from "../../use-external-link-footer";
 import { loadingErrorFooterInfo } from "../../data-table/table-pane";
 
@@ -9,7 +11,8 @@ const EMPTY_STATUS_INFO: PaneFooterSegment[] = [];
 // has no per-pane footer hint. Do not reintroduce one. See PR #589. Panes bind
 // it with `usePaneRefreshKey`.
 
-const STALE_SEGMENT: PaneFooterSegment = { id: "stale", parts: [{ text: "stale", tone: "warning" }] };
+/** The shared warning for data on screen older than it should be, for a pane composing its own footer. */
+export const STALE_SEGMENT: PaneFooterSegment = { id: "stale", parts: [{ text: "stale", tone: "warning" }] };
 
 interface PaneStatusInfoOptions {
   loading?: boolean;
@@ -28,6 +31,37 @@ function buildPaneStatusInfo({
   return [...info, ...(stale ? [STALE_SEGMENT] : []), ...loadingErrorFooterInfo(loading, error)];
 }
 
+/**
+ * Where the company data note sits: after the warning indicator (-10) and
+ * before the pane's own status (0 and the ticker quote's -1), so it leads what
+ * the pane says about its data and a narrow footer cuts that status first.
+ */
+const COMPANY_DATA_ORDER = -5;
+
+/**
+ * A company pane on a receipt or a foreign line that shows its company's data
+ * from the home line says which: `company data from 000660 KRX · as of
+ * 2026-06-30`, before the pane's own status (after a warning). Nothing when
+ * the data is the listing's own. Every company pane registers it here, so it
+ * reads, looks and sits the same in each.
+ */
+export function useCompanyDataFooter(companyFrom: CompanyFrom | null | undefined, enabled = true) {
+  const language = useAppLanguage();
+  const segment = useMemo(() => companyDataFooterSegment(companyFrom), [
+    language,
+    companyFrom?.symbol,
+    companyFrom?.exchange,
+    companyFrom?.name,
+  ]);
+  // Its own registration, so a view nested in a pane (13D/G under holders) never clears the pane's.
+  const id = useId();
+  usePaneFooter(
+    `company-data:${id}`,
+    () => enabled && segment ? { order: COMPANY_DATA_ORDER, info: [segment] } : null,
+    [enabled, segment],
+  );
+}
+
 export function usePaneStatusFooter({
   registrationId,
   loading = false,

package/src/components/layout/status-widget-space.ts

@@ -53,6 +53,15 @@ export function usePublishStatusWidgetRoom(columns: number): void {
   }, []);
 }
 
+/**
+ * Extra columns the other widgets claim, for a widget that sizes itself to
+ * what they leave rather than run into them.
+ */
+export function useOtherStatusWidgetClaims(id: string): number {
+  const others = () => claimedColumns() - (claims.get(id) ?? 0);
+  return useSyncExternalStore(subscribe, others, others);
+}
+
 /** The columns the widgets can use, as the status bar last published them. */
 export function useStatusWidgetRoom(): number {
   return useSyncExternalStore(subscribe, () => room, () => room);

package/src/components/onboarding/onboarding-frame.tsx

@@ -219,7 +219,8 @@ export function OnboardingCoach({
       </Box>
       <Box height={1} />
       <Box flexGrow={1} minHeight={0}>{children}</Box>
-      <Box height={1} flexDirection="row" gap={1}>{actions}</Box>
+      {/* As OnboardingActions: a button that does not fit beside the one before it wraps under it. */}
+      <Box flexDirection="row" flexWrap="wrap" alignItems="center" columnGap={1} flexShrink={0}>{actions}</Box>
     </Box>
   );
 }

package/src/components/onboarding/onboarding-wizard.tsx

@@ -322,12 +322,15 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
     return <OnboardingCoach step={t("YOUR WORKSPACE")}
       title={tf("Built around {ticker}", { ticker })}
       actions={<>
-        {/* The card has no room for both keys: like a toast, the dismiss key
-            is in the desktop tooltip. F10 also dismisses it. */}
+        {/* Each button shows its key, as Connect shows Alt+Enter; in the
+            terminal the second wraps under the first. The desktop card has no
+            room for both: like a toast, its dismiss key is in the tooltip.
+            F10 also dismisses it. */}
         <OnboardingButton
           label="Keep exploring"
           variant="ghost"
-          title={notificationDismissShortcut ? `${t("Keep exploring")} (${notificationDismissShortcut})` : undefined}
+          shortcut={!desktop && notificationDismissShortcut ? notificationDismissShortcut : undefined}
+          title={desktop && notificationDismissShortcut ? `${t("Keep exploring")} (${notificationDismissShortcut})` : undefined}
           onPress={() => { void finish(); }}
         />
         <OnboardingButton

package/src/components/ticker/list-table-view.tsx

@@ -29,8 +29,6 @@ import type { QuoteFlashDirection } from "../quote-flash";
 import { objectVersion } from "../../utils/object-version";
 import { getCompletedRegularSessionDisplay } from "../../market-data/market/status";
 import { usePaneFooter } from "../layout/pane/footer";
-import { Button } from "../ui/button";
-import { PaneStatusBody } from "../ui/status";
 
 export interface TickerTableCell {
   text: string;
@@ -99,11 +97,10 @@ export interface TickerListTableViewProps {
   emptyTitle?: string;
   emptyHint?: string;
   /**
-   * Starts the pane's add-ticker flow. Given, the empty table offers a
-   * "+ ticker" button for it and says so before the key.
+   * The pane's own key for adding a ticker, which the empty table names. The
+   * command bar's key when absent. The pane shows its add control once, in its
+   * own row, so the empty table points at the key and offers no second one.
    */
-  onAddTicker?: () => void;
-  /** The pane's key for the same flow, named after the click. The command bar's key when absent. */
   addTickerShortcut?: string;
   virtualize?: boolean;
   overscan?: number;
@@ -237,24 +234,12 @@ export function TickerListTableView({
   rowMenuAccelerators,
   emptyTitle = t("No tickers."),
   emptyHint,
-  onAddTicker,
   addTickerShortcut,
   virtualize = true,
   overscan = 4,
 }: TickerListTableViewProps) {
   const commandBarShortcut = useCommandBarShortcut();
-  const addLabel = `+ ${t("ticker")}`;
-  const resolvedEmptyHint = emptyHint ?? (onAddTicker
-    ? tf("Click {button} to add one, or press {shortcut}.", { button: addLabel, shortcut: addTickerShortcut ?? commandBarShortcut })
-    : tf("Press {shortcut} to add one.", { shortcut: commandBarShortcut }));
-  const emptyContent = onAddTicker ? (
-    <PaneStatusBody
-      empty
-      emptyTitle={emptyTitle}
-      emptyMessage={resolvedEmptyHint}
-      actions={<Button label="Add ticker" displayLabel={addLabel} compact onPress={onAddTicker} />}
-    />
-  ) : undefined;
+  const resolvedEmptyHint = emptyHint ?? tf("Press {shortcut} to add one.", { shortcut: addTickerShortcut ?? commandBarShortcut });
   const renderer = useRendererHost();
   const { showContextMenu } = useContextMenu();
   const { nativeContextMenu } = useUiCapabilities();
@@ -398,7 +383,6 @@ export function TickerListTableView({
       getRowVersion={getRowVersion}
       emptyStateTitle={emptyTitle}
       emptyStateHint={resolvedEmptyHint}
-      emptyContent={emptyContent}
       virtualize={virtualize}
       overscan={overscan}
       rootBefore={rootBefore}

package/src/components/ui/display.tsx

@@ -7,6 +7,7 @@ import { Box, Text, TextAttributes, useUiCapabilities } from "../../ui";
 import { truncateToDisplayWidth } from "../../utils/format";
 import { CountryFlagLead } from "./country-flag";
 import { usePaneLinkMenuEntry } from "./external-link";
+import { ICON_GLYPHS, Icon, type IconName } from "./icon";
 import { titleCase } from "./header-case";
 import { statToneColor, type StatTone } from "./stat-grid";
 
@@ -199,6 +200,10 @@ export interface BadgeProps {
   /** For a domain scale, such as a sentiment score or chart series. */
   color?: string;
   variant?: "subtle" | "solid";
+  /** A mark before the label, in its colour: an SVG on the desktop, its glyph in the terminal. */
+  icon?: IconName;
+  /** False for a label that is not English to translate, such as a username. */
+  translate?: boolean;
 }
 
 /**
@@ -209,9 +214,20 @@ export interface BadgeProps {
 export const NATIVE_BADGE_STYLE = { height: "calc(100% - 2px)", borderRadius: "var(--gloom-radius-sm)" };
 /** How far a subtle chip's fill is tinted toward its tone. */
 export const BADGE_TINT = 0.28;
+const NATIVE_ICON_BADGE_STYLE = { ...NATIVE_BADGE_STYLE, gap: "var(--gloom-space-xs)" };
 const NATIVE_BADGE_TEXT_STYLE = { fontWeight: "var(--gloom-weight-regular)" };
+/**
+ * A label with lowercase letters has them in the middle of the chip,
+ * wherever the font puts them in its line: the line is cut to x-height and
+ * baseline, and that is what the chip centres. Centred whole, SF Mono's
+ * lowercase sit a pixel and a half low. An icon centres in the chip, so it
+ * reads on the letters' line. A label in capitals and digits keeps the
+ * whole line, as ticker chips do; a browser without `text-box` keeps it too.
+ */
+const NATIVE_LOWERCASE_BADGE_TEXT_STYLE = { ...NATIVE_BADGE_TEXT_STYLE, textBox: "trim-both ex alphabetic" };
+const LOWERCASE = /\p{Ll}/u;
 
-export function Badge({ label, tone = "neutral", color, variant = "subtle" }: BadgeProps) {
+export function Badge({ label, tone = "neutral", color, variant = "subtle", icon, translate = true }: BadgeProps) {
   const colors = useThemeColors();
   const { nativePaneChrome } = useUiCapabilities();
   const accent = color ?? (tone === "neutral" ? colors.textDim : tone === "accent" ? colors.borderFocused : colors[tone]);
@@ -220,10 +236,20 @@ export function Badge({ label, tone = "neutral", color, variant = "subtle" }: Ba
   const background = neutral ? colors.selected : solid ? accent : blendHex(colors.bg, accent, BADGE_TINT);
   const baseForeground = neutral ? colors.selectedText : solid ? colors.bg : accent;
   const foreground = blendForContrast(baseForeground, background, higherContrast("#000000", "#ffffff", background), 4.5);
+  const text = translate ? t(label) : label;
+  const nativeIcon = nativePaneChrome && icon;
+  // The terminal draws the icon's glyph as text in front of the label.
+  const shown = icon && !nativePaneChrome ? [ICON_GLYPHS[icon], text].filter(Boolean).join(" ") : text;
   const chip = (
     <Box height={nativePaneChrome ? undefined : 1} paddingX={1} backgroundColor={background}
-      data-gloom-ui="badge" justifyContent={nativePaneChrome ? "center" : undefined} style={nativePaneChrome ? NATIVE_BADGE_STYLE : undefined}>
-      <Text fg={foreground} attributes={TextAttributes.BOLD} style={nativePaneChrome ? NATIVE_BADGE_TEXT_STYLE : undefined}>{t(label)}</Text>
+      data-gloom-ui="badge" {...(nativeIcon ? { flexDirection: "row", alignItems: "center" } as const : {})}
+      justifyContent={nativePaneChrome && !nativeIcon ? "center" : undefined}
+      style={nativePaneChrome ? nativeIcon ? NATIVE_ICON_BADGE_STYLE : NATIVE_BADGE_STYLE : undefined}>
+      {nativeIcon ? <Icon name={nativeIcon} color={foreground} fullHeight /> : null}
+      {shown || !nativeIcon ? (
+        <Text fg={foreground} attributes={TextAttributes.BOLD}
+          style={nativePaneChrome ? LOWERCASE.test(text) ? NATIVE_LOWERCASE_BADGE_TEXT_STYLE : NATIVE_BADGE_TEXT_STYLE : undefined}>{shown}</Text>
+      ) : null}
     </Box>
   );
   return nativePaneChrome ? <Box height={1} flexShrink={0} justifyContent="center">{chip}</Box> : chip;

package/src/components/ui/icon.tsx

@@ -38,7 +38,8 @@ export type IconName =
   | "team"
   | "pro"
   | "clock"
-  | "edit";
+  | "edit"
+  | "mail";
 
 /** Terminal glyph for each icon; the desktop host draws SVG. */
 export const ICON_GLYPHS: Record<IconName, string> = {
@@ -84,6 +85,8 @@ export const ICON_GLYPHS: Record<IconName, string> = {
   // Time, for data that arrives late (a delayed quote).
   clock: "◷",
   edit: "✎",
+  // A message written to you (a DM): text presentation, one cell.
+  mail: "✉",
 };
 
 export interface IconProps {
@@ -91,13 +94,19 @@ export interface IconProps {
   /** Pixel size on the desktop; the terminal draws one glyph. */
   size?: number;
   color?: string;
+  /**
+   * Desktop: takes its row's full height and draws in the middle of it. A
+   * box centred in a row an odd number of pixels taller lands on a whole
+   * pixel, half a pixel off; the drawing inside the box does not.
+   */
+  fullHeight?: boolean;
 }
 
 /** One glyph from the app's icon set. */
-export function Icon({ name, size = 12, color }: IconProps) {
+export function Icon({ name, size = 12, color, fullHeight }: IconProps) {
   const colors = useThemeColors();
   const HostIcon = useUiHost().Icon as ComponentType<IconProps> | undefined;
-  if (HostIcon) return <HostIcon name={name} size={size} color={color} />;
+  if (HostIcon) return <HostIcon name={name} size={size} color={color} fullHeight={fullHeight} />;
   return <Text fg={color ?? colors.textDim} selectable={false}>{ICON_GLYPHS[name]}</Text>;
 }
 

package/src/core/app-services.ts

@@ -10,8 +10,17 @@ import { createAppRuntime } from "./app-runtime";
 
 export type AppServices = ReturnType<typeof createAppServices>;
 
-export function createAppServices({ config, plugins, externalPlugins }: AppServicesFactoryOptions) {
-  const persistence = new AppPersistence(join(config.dataDir, ".gloomberb-cache.db"));
+interface AppServicesOptions extends AppServicesFactoryOptions {
+  /**
+   * Runs where the user waits on it (the terminal, the desktop app), so no
+   * database statement waits on another program's lock (data/sqlite/access.ts).
+   * A command sets it to false and waits instead.
+   */
+  interactive?: boolean;
+}
+
+export function createAppServices({ config, plugins, externalPlugins, interactive = true }: AppServicesOptions) {
+  const persistence = new AppPersistence(join(config.dataDir, ".gloomberb-cache.db"), { interactive });
   const tickerRepository = new TickerRepository(persistence.tickers);
   const providerRouter = new AssetDataRouter(null, [], persistence.resources, connectionHealth);
   const runtime = createAppRuntime({

package/src/data/app-persistence.ts

@@ -1,7 +1,7 @@
 import { PluginStateStore } from "./plugin-state-store";
 import { ResourceStore } from "./resource-store";
 import { SessionStore } from "./session-store";
-import { SqliteDatabase } from "./sqlite/database";
+import { SqliteDatabase, type SqliteDatabaseOptions } from "./sqlite/database";
 import { TickerStore } from "./ticker-store";
 
 export class AppPersistence {
@@ -11,15 +11,17 @@ export class AppPersistence {
   readonly pluginState: PluginStateStore;
   readonly sessions: SessionStore;
 
-  constructor(dbPath: string) {
-    this.database = new SqliteDatabase(dbPath);
-    this.tickers = new TickerStore(this.database.connection);
-    this.resources = new ResourceStore(this.database.connection);
-    this.pluginState = new PluginStateStore(this.database.connection);
-    this.sessions = new SessionStore(this.database.connection);
+  constructor(dbPath: string, options: SqliteDatabaseOptions = {}) {
+    this.database = new SqliteDatabase(dbPath, options);
+    const { connection, access } = this.database;
+    this.tickers = new TickerStore(connection, access);
+    this.resources = new ResourceStore(connection, access);
+    this.pluginState = new PluginStateStore(connection, access);
+    this.sessions = new SessionStore(connection, access);
   }
 
   close(): void {
+    this.resources.close();
     this.database.close();
   }
 }

package/src/data/plugin-cache.ts

@@ -2,6 +2,7 @@ import { logFailure } from "../utils/log-failure";
 import type { CachePolicy } from "../types/persistence";
 import type { PluginPersistence } from "../types/plugin";
 import { CachedQuery, type CachedValue } from "./cached-query";
+import { isTransientFailure } from "../api-client/errors";
 
 export interface PluginCacheResult<T> {
   data: T;
@@ -12,6 +13,20 @@ export interface PluginCacheResult<T> {
   source: "cache" | "network" | "stale-fallback";
 }
 
+/**
+ * `result`, or the failure of the refresh it stands in for when a saved copy
+ * may not answer for it. A saved copy covers only a failure asking again may
+ * get past (`isTransientFailure`: no connection, a timeout, a rate-limited or
+ * overloaded server, a reply whose source did not answer this time); a
+ * refusal (another 4xx, such as a series no longer served or a signed-out
+ * session) and an answer that failed validation are thrown, so they show as
+ * the errors they are instead of as old data.
+ */
+export function savedCopyForTransientFailure<R extends { source?: PluginCacheResult<unknown>["source"]; error?: unknown }>(result: R): R {
+  if (result.source === "stale-fallback" && !isTransientFailure(result.error)) throw result.error;
+  return result;
+}
+
 /** Shared persistence/request lifecycle; keys, codecs, validation and policies stay with the plugin. */
 export function createPluginCache<T, Stored = T>(options: {
   kind: string;
@@ -108,11 +123,13 @@ export function createPluginCache<T, Stored = T>(options: {
         }
         return { value, fetchedAt, staleAt: fetchedAt + options.policy.staleMs, expiresAt: fetchedAt + options.policy.expireMs, source: options.source };
       } });
+      // A retained copy carries its refresh failure, whatever was thrown (an Error without a message included).
+      const failed = "refreshError" in result;
       const error = result.refreshError;
       return {
-        data: result.value, fetchedAt: result.fetchedAt, stale: !!error || result.staleAt <= Date.now(),
-        source: error ? "stale-fallback" : result === before ? "cache" : "network",
-        ...(error ? { error, refreshError: error instanceof Error ? error.message : String(error) } : {}),
+        data: result.value, fetchedAt: result.fetchedAt, stale: failed || result.staleAt <= Date.now(),
+        source: failed ? "stale-fallback" : result === before ? "cache" : "network",
+        ...(failed ? { error, refreshError: error instanceof Error ? error.message : String(error) } : {}),
       };
     },
   };