@gloom-sh/terminal 0.19.0 → 0.19.1

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;
 }
 
 /**
@@ -210,8 +215,9 @@ export const NATIVE_BADGE_STYLE = { height: "calc(100% - 2px)", borderRadius: "v
 /** How far a subtle chip's fill is tinted toward its tone. */
 export const BADGE_TINT = 0.28;
 const NATIVE_BADGE_TEXT_STYLE = { fontWeight: "var(--gloom-weight-regular)" };
+const NATIVE_ICON_BADGE_STYLE = { ...NATIVE_BADGE_STYLE, gap: "var(--gloom-space-xs)" };
 
-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 +226,19 @@ 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 && !icon ? "center" : undefined}
+      style={nativePaneChrome ? icon ? NATIVE_ICON_BADGE_STYLE : NATIVE_BADGE_STYLE : undefined}>
+      {nativeIcon ? <Icon name={nativeIcon} color={foreground} /> : null}
+      {shown || !nativeIcon ? (
+        <Text fg={foreground} attributes={TextAttributes.BOLD} style={nativePaneChrome ? 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 {

package/src/data/plugin-cache.ts

@@ -108,11 +108,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) } : {}),
       };
     },
   };

package/src/data/saved-copies.ts

@@ -56,6 +56,14 @@ export function savedCopyMark(value: unknown): object {
   return savedAt != null ? { [SAVED_AT]: savedAt } : {};
 }
 
+/**
+ * The refresh failure a command still prints for `result`: none when a saved
+ * copy answered for it (`servedFromSavedCopy`), whose closing line says so.
+ */
+export function unansweredRefreshError(result: { refreshError?: string | null } | null | undefined): string | null {
+  return result?.refreshError && savedCopyAt(result) == null ? result.refreshError : null;
+}
+
 /** When `value` itself was saved, if it is a saved copy served after a failed refresh; null otherwise. */
 export function savedCopyAt(value: unknown): number | null {
   const savedAt = value && typeof value === "object" ? (value as Marked)[SAVED_AT] : undefined;

package/src/docs/snapshot.json

@@ -1684,6 +1684,13 @@
    "category": "app",
    "lesson": "/academy/terminal-and-workspace/how-the-terminal-works/help-cards"
   },
+  {
+   "code": "ROADMAP",
+   "name": "Roadmap",
+   "description": "What is coming next",
+   "detail": "What is being built, what is planned and what shipped, with each item's votes. Pro members vote on what is building or planned, once per item, and can take the vote back.",
+   "category": "app"
+  },
   {
    "code": "HELP",
    "name": "Help",
@@ -1799,7 +1806,7 @@
     },
     {
      "type": "code",
-     "code": "bun install -g gloomberb"
+     "code": "bun install -g @gloom-sh/terminal"
     },
     {
      "type": "heading",
@@ -1853,10 +1860,14 @@
       ],
       [
        "Bun",
-       "`bun install -g gloomberb@latest`"
+       "`bun install -g @gloom-sh/terminal@latest`"
       ]
      ]
     },
+    {
+     "type": "paragraph",
+     "text": "An existing `gloomberb` install keeps updating as it is."
+    },
     {
      "type": "paragraph",
      "text": "Installed before 0.18.4, when the command was `gloomberb`? Updating adds `gloom` beside it and `gloomberb` keeps working, with nothing to reinstall."
@@ -5469,7 +5480,7 @@
     "functions",
     "screenshots"
    ],
-   "updatedAt": "2026-10-12",
+   "updatedAt": "2026-10-27",
    "blocks": [
     {
      "type": "paragraph",
@@ -5641,8 +5652,8 @@
        "Ticker and quick notes"
       ],
       [
-       "`alerts list`, `alerts add <symbol> <above|below|crosses> <price>`, `alerts delete|rearm <id>`",
-       "Price alerts"
+       "`alerts list`, `alerts add ...`, `alerts delete|rearm <id>`",
+       "Price, valuation, daily technical and event alerts, every kind the `ALRT` pane offers; the forms are below"
       ]
      ]
     },
@@ -5650,6 +5661,22 @@
      "type": "paragraph",
      "text": "[Portfolios and rebalancing](/docs/portfolio) walks through targets and the drift table. `CASH` in `portfolio target` is the cash line; `portfolio add` and `position set` refuse a bare `CASH` (the stock is `CASH:NASDAQ`). `portfolio` and `watchlist` write immediately and ignore `--dry-run`. Sign-in, account management and chat are app-only."
     },
+    {
+     "type": "paragraph",
+     "text": "The alerts commands, as `gloom help alerts` lists them:"
+    },
+    {
+     "type": "code",
+     "code": "gloom alerts list\ngloom alerts add <symbol> <above|below|crosses> <price>\ngloom alerts add <symbol> <pe|ps|rsi(14)> <above|below> <level>\ngloom alerts add <symbol> ma(50) crosses <above|below> ma(200)\ngloom alerts add <symbol> closes <above|below> ma(200)\ngloom alerts add <symbol>/<benchmark> <above|below|crosses> <ratio>\ngloom alerts add <symbol> rrg <leading|weakening|lagging|improving> [--benchmark <symbol>]\ngloom alerts add <symbol> earnings [--days <n> | results]\ngloom alerts add <calendar event> [--country <code>] [--days <n>]\ngloom alerts add [symbol] news <keyword>\ngloom alerts add [symbol] flow [premium] [calls|puts] [sweeps|blocks]\ngloom alerts add <symbol> <iv|rr> <above|below> <level>\ngloom alerts add <OCC contract> iv spike <points>\ngloom alerts add <symbol> 52-week <high|low>\ngloom alerts add <symbol> unusual volume [<multiple>x]\ngloom alerts add <symbol> filing [8-K|10-K|10-Q|S-1|13D|13D/A|13G|13G/A|6-K|20-F]\ngloom alerts add <symbol> insider [buy|sell]\ngloom alerts add <symbol> short interest [increase|decrease] [<percent>%]\ngloom alerts add <symbol> analyst [upgrade|downgrade]\ngloom alerts add <symbol> hiring [accelerating|slowing]\ngloom alerts add perps <market> <funding|oi|premium|closed-premium> <above|below> <percent>\ngloom alerts add catalyst [type <type> | agency <agency> | country <code>]\ngloom alerts add <symbol> catalyst\ngloom alerts add congress [member name]\ngloom alerts add 13f <fund CIK>\ngloom alerts delete <id>\ngloom alerts rearm <id>"
+    },
+    {
+     "type": "paragraph",
+     "text": "Words none of these forms read are refused with the list of kinds. Adding a rule that already exists names the existing alert's ID and adds nothing, and `rearm` on an alert that has not gone off says it is already active. An RSI or moving-average alert is always saved: it reads the same daily closes `history` shows as final and says when it is first checked."
+    },
+    {
+     "type": "paragraph",
+     "text": "`alerts list` shows each alert's listing with its currency, its last reading with when it is from (or `not checked yet`) and when it was created, in ISO 8601 UTC. `alerts list --csv` keeps its columns in order (`id,kind,target,trigger,eventDate,status,lastCheckedPrice,triggeredAt`) and adds `createdAt,listing,currency,lastReading,lastReadingAt` after them. Creating, re-arming and deleting an alert go in the app's alert log beside the alerts that fired (`gloom fn ALRT --tab history`)."
+    },
     {
      "type": "heading",
      "level": 2,

package/src/i18n/es.ts

@@ -506,10 +506,8 @@ export const es: Record<string, string> = {
   "Pin Ticker": "Fijar ticker",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "Cómo usar Gloom",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "¿No sabes el código? Haz clic en la barra de búsqueda de arriba, o pulsa {key}, y escribe lo que quieres con tus palabras, como \"top news\". La pestaña Funciones las lista todas.",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "¿No sabes el código? Haz clic en la barra de búsqueda de arriba y escribe lo que quieres con tus palabras, como \"top news\". La pestaña Funciones las lista todas.",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "Haz clic en cualquier cosa para usarla; las teclas junto a las acciones son atajos.",
   "Open Help": "Abrir la ayuda",
   "Command Prefixes": "Prefijos de comandos",
   "Window Templates": "Plantillas de ventana",
@@ -519,7 +517,6 @@ export const es: Record<string, string> = {
   "Scrolling": "Desplazamiento",
   "Open Debug Log": "Abrir registro de depuración",
   "GitHub Issues": "GitHub Issues",
-  "Docked panes stay in the saved layout.": "Los paneles anclados permanecen en el diseño guardado.",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "Los paneles flotantes se arrastran por la barra de título y se redimensionan desde la esquina inferior derecha.",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "Usa Acciones de diseño para dividir, mover, duplicar, cerrar paneles flotantes, deshacer, rehacer y diseños predefinidos.",
   "Move through focused table and list rows.": "Moverse por las filas de tablas y listas activas.",
@@ -564,7 +561,6 @@ export const es: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "Volver de una pantalla de comando anidada cuando la consulta está vacía.",
   "Reorder ordered multi-select choices.": "Reordenar opciones de selección múltiple ordenadas.",
   "Submit multiline command forms.": "Enviar formularios de comando multilínea.",
-  "Layout Basics": "Fundamentos del diseño",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "La terminal abierta para las finanzas modernas.",
@@ -1672,6 +1668,8 @@ export const es: Record<string, string> = {
   "Guides": "Guías",
   "Academy": "Academia",
   "offline, saved copy": "sin conexión, copia guardada",
+  "company data from {listing}": "datos de la empresa de {listing}",
+  "from {listing}": "de {listing}",
   "Open in Browser": "Abrir en el navegador",
   "No docs match \"{query}\".": "Nada en la documentación coincide con \"{query}\".",
   "No docs for {name} yet.": "Aún no hay documentación para {name}.",

package/src/i18n/ja.ts

@@ -507,10 +507,8 @@ export const ja: Record<string, string> = {
   "Pin Ticker": "銘柄を固定",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "Gloom の使用方法",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "コードが分からない場合は、上部の検索バーをクリックするか {key} を押し、\"top news\" のように普段の言葉で入力してください。「関数」タブに全機能があります。",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "コードが分からない場合は、上部の検索バーをクリックし、\"top news\" のように普段の言葉で入力してください。「関数」タブに全機能があります。",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "どこでもクリックして操作できます。操作の横に表示されるキーはショートカットです。",
   "Open Help": "ヘルプを開く",
   "Command Prefixes": "コマンド接頭辞",
   "Window Templates": "ウィンドウ テンプレート",
@@ -520,7 +518,6 @@ export const ja: Record<string, string> = {
   "Scrolling": "スクロール",
   "Open Debug Log": "デバッグ ログを開く",
   "GitHub Issues": "GitHub Issues",
-  "Docked panes stay in the saved layout.": "ドッキングされたペインは保存されたレイアウトに残ります。",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "フローティング ペインは、タイトル バーをドラッグして、右下隅からサイズを変更できます。",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "レイアウト アクションを使用して、分割、移動、複製、すべてのフローティング ペインを閉じる、元に戻す、やり直し、およびレイアウト プリセットを実行します。",
   "Move through focused table and list rows.": "フォーカスされたテーブルとリストの行を移動します。",
@@ -565,7 +562,6 @@ export const ja: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "クエリが空の場合、ネストされたコマンド画面から戻ります。",
   "Reorder ordered multi-select choices.": "順序付けされた複数選択の選択肢を並べ替えます。",
   "Submit multiline command forms.": "複数行のコマンド フォームを送信します。",
-  "Layout Basics": "レイアウトの基本",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "現代の金融に開かれたターミナル。",
@@ -1668,6 +1664,8 @@ export const ja: Record<string, string> = {
   "Guides": "ガイド",
   "Academy": "アカデミー",
   "offline, saved copy": "オフライン、保存済みのコピー",
+  "company data from {listing}": "{listing} の企業データ",
+  "from {listing}": "{listing} から",
   "Open in Browser": "ブラウザで開く",
   "No docs match \"{query}\".": "「{query}」に一致するドキュメントはありません。",
   "No docs for {name} yet.": "{name} のドキュメントはまだありません。",

package/src/i18n/ko.ts

@@ -505,10 +505,8 @@ export const ko: Record<string, string> = {
   "Pin Ticker": "종목 고정",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "Gloom 사용 방법",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "코드를 모르겠다면 위쪽 검색창을 클릭하거나 {key}을 누르고 \"top news\"처럼 원하는 것을 평범한 말로 입력하세요. 기능 탭에 전체 목록이 있습니다.",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "코드를 모르겠다면 위쪽 검색창을 클릭하고 \"top news\"처럼 원하는 것을 평범한 말로 입력하세요. 기능 탭에 전체 목록이 있습니다.",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "무엇이든 클릭해서 사용하세요. 동작 옆에 표시된 키는 단축키입니다.",
   "Open Help": "도움말 열기",
   "Command Prefixes": "명령 접두사",
   "Window Templates": "창 템플릿",
@@ -518,7 +516,6 @@ export const ko: Record<string, string> = {
   "Scrolling": "스크롤",
   "Open Debug Log": "디버그 로그 열기",
   "GitHub Issues": "GitHub 이슈",
-  "Docked panes stay in the saved layout.": "도킹된 패널은 저장된 레이아웃에 유지됩니다.",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "플로팅 패널은 제목 표시줄로 이동하고 오른쪽 아래에서 크기를 조절할 수 있습니다.",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "레이아웃 작업에서 분할, 이동, 복제, 플로팅 패널 모두 닫기, 실행 취소, 다시 실행 및 프리셋을 관리합니다.",
   "Move through focused table and list rows.": "포커스된 표와 목록의 행을 이동합니다.",
@@ -563,7 +560,6 @@ export const ko: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "쿼리가 비어 있으면 중첩된 명령 화면에서 돌아갑니다.",
   "Reorder ordered multi-select choices.": "순서가 있는 다중 선택 항목을 재정렬합니다.",
   "Submit multiline command forms.": "여러 줄 명령 양식을 제출합니다.",
-  "Layout Basics": "레이아웃 기본 사항",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "현대 금융을 위한 오픈 소스 터미널.",
@@ -1666,6 +1662,8 @@ export const ko: Record<string, string> = {
   "Guides": "가이드",
   "Academy": "아카데미",
   "offline, saved copy": "오프라인, 저장된 사본",
+  "company data from {listing}": "{listing}의 기업 데이터",
+  "from {listing}": "{listing}에서",
   "Open in Browser": "브라우저에서 열기",
   "No docs match \"{query}\".": "\"{query}\"와 일치하는 문서가 없습니다.",
   "No docs for {name} yet.": "{name} 문서가 아직 없습니다.",

package/src/i18n/zh-cn.ts

@@ -507,10 +507,8 @@ export const zhCN: Record<string, string> = {
   "Pin Ticker": "固定股票",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "如何使用 Gloom",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "不知道代码？点击顶部的搜索栏，或按 {key}，用日常语言输入你想要的，比如 \"top news\"。“功能”标签列出了全部功能。",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "不知道代码？点击顶部的搜索栏，用日常语言输入你想要的，比如 \"top news\"。“功能”标签列出了全部功能。",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "点击任意内容即可使用；操作旁显示的按键是快捷键。",
   "Open Help": "打开帮助",
   "Command Prefixes": "命令前缀",
   "Window Templates": "窗口模板",
@@ -520,7 +518,6 @@ export const zhCN: Record<string, string> = {
   "Scrolling": "滚动",
   "Open Debug Log": "打开调试日志",
   "GitHub Issues": "GitHub 问题反馈",
-  "Docked panes stay in the saved layout.": "停靠面板会保留在已存布局中。",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "浮动面板可拖动标题栏移动，右下角调整大小。",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "用布局操作完成拆分、移动、复制、关闭全部浮动面板、撤销、重做与布局预设。",
   "Move through focused table and list rows.": "在聚焦的表格与列表行间移动。",
@@ -565,7 +562,6 @@ export const zhCN: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "查询为空时从嵌套命令界面返回。",
   "Reorder ordered multi-select choices.": "调整有序多选项的顺序。",
   "Submit multiline command forms.": "提交多行命令表单。",
-  "Layout Basics": "布局基础",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "面向现代金融的开源终端。",
@@ -1668,6 +1664,8 @@ export const zhCN: Record<string, string> = {
   "Guides": "指南",
   "Academy": "学院",
   "offline, saved copy": "离线，已保存的副本",
+  "company data from {listing}": "公司数据来自 {listing}",
+  "from {listing}": "来自 {listing}",
   "Open in Browser": "在浏览器中打开",
   "No docs match \"{query}\".": "没有与“{query}”匹配的文档。",
   "No docs for {name} yet.": "{name} 暂无文档。",

package/src/i18n/zh-tw.ts

@@ -507,10 +507,8 @@ export const zhTW: Record<string, string> = {
   "Pin Ticker": "固定股票",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "如何使用 Gloom",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "不知道代碼？點擊頂部的搜尋列，或按 {key}，用日常用語輸入你想要的，例如 \"top news\"。「功能」標籤列出了全部功能。",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "不知道代碼？點擊頂部的搜尋列，用日常用語輸入你想要的，例如 \"top news\"。「功能」標籤列出了全部功能。",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "點擊任何內容即可使用；動作旁顯示的按鍵是快捷鍵。",
   "Open Help": "開啟說明",
   "Command Prefixes": "命令字首",
   "Window Templates": "視窗範本",
@@ -520,7 +518,6 @@ export const zhTW: Record<string, string> = {
   "Scrolling": "捲動",
   "Open Debug Log": "開啟除錯日誌",
   "GitHub Issues": "GitHub 問題回報",
-  "Docked panes stay in the saved layout.": "停靠面板會保留在已儲存的版面設定中。",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "拖曳標題列可移動浮動面板，從右下角可調整大小。",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "用版面設定操作完成拆分、移動、複製、關閉全部浮動面板、撤銷、重做與版面設定預設。",
   "Move through focused table and list rows.": "在目前表格與清單的各列之間移動。",
@@ -565,7 +562,6 @@ export const zhTW: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "查詢為空時，從巢狀命令畫面回到上一層。",
   "Reorder ordered multi-select choices.": "調整有序多選項的順序。",
   "Submit multiline command forms.": "提交多行命令表單。",
-  "Layout Basics": "版面設定基礎",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "現代金融的開源終端機。",
@@ -1668,6 +1664,8 @@ export const zhTW: Record<string, string> = {
   "Guides": "指南",
   "Academy": "學院",
   "offline, saved copy": "離線，已儲存的副本",
+  "company data from {listing}": "公司資料來自 {listing}",
+  "from {listing}": "來自 {listing}",
   "Open in Browser": "在瀏覽器中開啟",
   "No docs match \"{query}\".": "沒有符合「{query}」的文件。",
   "No docs for {name} yet.": "{name} 尚無文件。",

package/src/market-data/depositary-pair.ts

@@ -1,4 +1,4 @@
-import type { DepositaryPair, Fundamentals, Quote } from "../types/financials";
+import type { CedearRatio, DepositaryPair, Fundamentals, Quote } from "../types/financials";
 import { canonicalExchange, parsePublicTickerKey } from "../utils/exchanges";
 import { formatNumber } from "../utils/format";
 import { formatUtcDayTime } from "../utils/utc-time";
@@ -41,6 +41,30 @@ export function ratioCount(ratio: number): string {
   return Number.isInteger(ratio) ? String(ratio) : String(Number(ratio.toPrecision(6)));
 }
 
+type CedearRecords = { quote?: Pick<Quote, "cedearRatio"> | null; fundamentals?: Pick<Fundamentals, "cedearRatio"> | null };
+
+const positiveCount = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value > 0;
+
+/** A served CEDEAR ratio, when it is whole. */
+function readCedearRatio(value: unknown): CedearRatio | null {
+  if (!value || typeof value !== "object") return null;
+  const ratio = value as Partial<CedearRatio>;
+  if (typeof ratio.listing !== "string" || !ratio.listing.trim()) return null;
+  if (typeof ratio.company !== "string" || !ratio.company.trim()) return null;
+  if (!positiveCount(ratio.receipts) || !positiveCount(ratio.shares)) return null;
+  return ratio as CedearRatio;
+}
+
+/** The CEDEAR ratio a listing's records state: the quote's, else the fundamentals'. */
+export function listingCedearRatio(records: CedearRecords | null | undefined): CedearRatio | null {
+  return readCedearRatio(records?.quote?.cedearRatio) ?? readCedearRatio(records?.fundamentals?.cedearRatio);
+}
+
+/** A CEDEAR's ratio in its company's shares: `20 AAPL:BYMA = 1 Apple Inc. share`. */
+export function cedearRatioText(ratio: CedearRatio): string {
+  return `${ratioCount(ratio.receipts)} ${ratio.listing} = ${ratioCount(ratio.shares)} ${ratio.company.trim()} share${ratio.shares === 1 ? "" : "s"}`;
+}
+
 /** What a home line says of its receipt: `1 GGAL ADR = 10 of these shares`, and `1 of these shares` for one. */
 function homeLineRatioText(pair: DepositaryPair): string {
   return `1 ${pair.receipt} ADR = ${ratioCount(pair.ratio)} of these shares`;

package/src/market-data/quotes/metadata.ts

@@ -2,6 +2,7 @@ import type { Quote, QuoteMetadata } from "../../types/financials";
 import { canonicalExchange, parsePublicTickerKey } from "../../utils/exchanges";
 import { getListingSymbolsToTry } from "../../sources/listing-symbols";
 import { currencyPairCode } from "../../utils/currency-pair";
+import { exchangeLineCoinListing } from "../../utils/crypto-pair";
 
 export function quoteMetadataFromQuote(quote: Quote): QuoteMetadata {
   return {
@@ -44,6 +45,12 @@ export function mergeQuoteMetadata(known: QuoteMetadata | null | undefined, load
 
 /** Qualified listings must agree; provider suffix spellings use the existing exact-listing normalizer. */
 export function quoteMetadataMatchesTarget(metadata: QuoteMetadata, symbol: string, exchange?: string): boolean {
+  // A crypto exchange's line of a pair (BTC/GBP on COINBASE PRO) is priced as the crypto venue's listing, BTC-GBP on
+  // CCC, and a quote kept under the line's key is that listing's.
+  const line = exchangeLineCoinListing(symbol, exchange);
+  if (line) return quoteMetadataMatchesTarget(metadata, line.symbol, line.exchange);
+  const quotedLine = exchangeLineCoinListing(metadata.symbol, parsePublicTickerKey(metadata.symbol).exchange ? undefined : metadata.listingExchangeName);
+  if (quotedLine) metadata = { ...metadata, symbol: quotedLine.symbol, listingExchangeName: quotedLine.exchange };
   const target = parsePublicTickerKey(symbol);
   const actual = parsePublicTickerKey(metadata.symbol);
   // An index is one series whatever its venue is called: search files ^VIX under CXI and ^RUT under WCB, while

package/src/news/aggregator.ts

@@ -1,3 +1,4 @@
+import type { CompanyFrom } from "../types/company-from";
 import { logFailure } from "../utils/log-failure";
 import type { NewsCapability } from "../capabilities";
 import type { ConnectionHealthRegistry } from "../core/connection-health";
@@ -63,6 +64,7 @@ interface SourceFetchResult {
   errors: string[];
   nextCursor: string | null;
   access: NewsAccess | null;
+  companyFrom?: CompanyFrom | null;
 }
 
 interface NewsQueryEntry {
@@ -451,6 +453,7 @@ export class NewsService {
           loadingMore: entry.state.loadingMore,
           // A page that does not say keeps what this session's earlier answer said.
           access: result.access ?? (sameSession ? entry.state.access ?? null : null),
+          companyFrom: result.companyFrom ?? null,
         };
         entry.state = state;
         entry.generation = generation;
@@ -550,7 +553,7 @@ export class NewsService {
   private async readSourcePage(
     source: NewsCapability,
     query: NewsQuery,
-  ): Promise<{ articles: NewsArticle[]; nextCursor: string | null; error?: string | null; access?: NewsAccess | null }> {
+  ): Promise<{ articles: NewsArticle[]; nextCursor: string | null; error?: string | null; access?: NewsAccess | null; companyFrom?: CompanyFrom | null }> {
     if (source.provider.fetchNewsPage) {
       const page = await this.trackSourceRequest(
         source,
@@ -562,6 +565,7 @@ export class NewsService {
         nextCursor: page.nextCursor ?? null,
         error: page.error,
         access: page.access,
+        companyFrom: page.companyFrom ?? null,
       };
     }
     const articles = (await this.trackSourceRequest(
@@ -585,6 +589,7 @@ export class NewsService {
           errors: page.error ? [page.error] : [],
           nextCursor: page.nextCursor,
           access: page.access ?? null,
+          companyFrom: page.companyFrom ?? null,
         };
         if (page.articles.length > 0) return result;
         firstEmpty ??= result;
@@ -654,6 +659,7 @@ export class NewsService {
         nextCursor: entry.state.nextCursor,
         loadingMore: false,
         access: entry.state.access ?? null,
+        companyFrom: entry.state.companyFrom ?? null,
       };
       changed = true;
     }

package/src/news/types.ts

@@ -1,3 +1,5 @@
+import type { CompanyFrom } from "../types/company-from";
+
 type NewsQueryScope = "global" | "ticker";
 export type NewsFeed = "latest" | "top" | "breaking" | "ticker" | "sector" | "topic";
 type NewsSentiment = "positive" | "neutral" | "negative";
@@ -95,6 +97,8 @@ export interface NewsPage {
   nextCursor?: string | null;
   /** Which news the source answered with; null or absent when the answer does not say. */
   access?: NewsAccess | null;
+  /** The company's home line the stories are read from, when not the listing asked (a receipt, a foreign line). */
+  companyFrom?: CompanyFrom | null;
 }
 
 export interface NewsQueryState {
@@ -107,4 +111,6 @@ export interface NewsQueryState {
   loadingMore: boolean;
   /** Which news the stories are, from the last answer; null or absent when it did not say. */
   access?: NewsAccess | null;
+  /** The company's home line the stories are read from, when not the listing asked. */
+  companyFrom?: CompanyFrom | null;
 }

package/src/plugins/builtin/alerts/calendar-events.ts

@@ -3,7 +3,7 @@
 // release's rows as the calendar's feeds name it from week to week, and the
 // notifications sent before it and once its figures are out. CPI and FOMC are
 // two cases of the same alert, whose dates come from their own calendars.
-import { dateKey, eventCountry, matchesCountry, type CountryFilter } from "../econ/calendar-model";
+import { dateKey, econEventName, eventCountry, matchesCountry, type CountryFilter } from "../econ/calendar-model";
 import { isAllDayEvent, hasNoReleaseTime, type EconEvent, type EconImpact } from "../econ/types";
 import { RENAMED_RELEASES } from "../shared/macro-releases";
 import { MACRO_EVENT_NAMES } from "./research-builder";
@@ -126,7 +126,11 @@ export interface CalendarEventChoice {
 
 const IMPACT_RANK: Record<EconImpact, number> = { high: 0, medium: 1, low: 2 };
 
-type RankedChoice = CalendarEventChoice & { words: string[] };
+type RankedChoice = CalendarEventChoice & {
+  words: string[];
+  /** The words of the name `econ` shows it under, when that is not the feed's (the Fed's rate as its upper bound). */
+  shownWords: string[];
+};
 
 /**
  * The calendar's releases, one per country and name, each with its next row
@@ -150,6 +154,7 @@ function calendarChoices(events: readonly EconEvent[], now: number): RankedChoic
       impact: rows.reduce<EconImpact>((best, event) => IMPACT_RANK[event.impact] < IMPACT_RANK[best] ? event.impact : best, "low"),
       next,
       words: calendarNameWords(named.event),
+      shownWords: calendarNameWords(econEventName(named)),
     };
   });
 }
@@ -246,7 +251,8 @@ function matchCalendarWords(
   now: number,
 ): CalendarEventMatch {
   const choices = calendarChoices(country ? events.filter((event) => matchesCountry(event, country)) : events, now);
-  const exact = choices.filter((choice) => choice.words.join(" ") === words.join(" "));
+  // The name as the feed gives it, or as `econ` shows it: the alert keeps the feed's, which the calendar's rows carry.
+  const exact = choices.filter((choice) => [choice.words, choice.shownWords].some((name) => name.join(" ") === words.join(" ")));
   const naming = (typed: readonly string[], loose: boolean) => typed.length === 0 ? [] : choices.filter((choice) =>
     typed.every((word) => loose ? wordFound(word, choice.words) : choice.words.includes(word)));
   // CPI by the name one feed gives it everywhere but the US (China's Inflation Rate YoY).
@@ -278,7 +284,7 @@ function matchCalendarWords(
   return { kind: "match", choice: strip(ranked[0]!), others: ranked.slice(1).map(strip) };
 }
 
-function strip({ words: _words, ...choice }: RankedChoice): CalendarEventChoice {
+function strip({ words: _words, shownWords: _shown, ...choice }: RankedChoice): CalendarEventChoice {
   return choice;
 }