gloomberb 0.18.3 → 0.18.4

package/src/plugins/builtin/mna/detail.tsx

@@ -25,13 +25,17 @@ import { useQuoteBoard } from "../shared/use-quote-board";
 import { cachedMnaDeal, loadMnaDeal } from "./client";
 import {
   dealSpread,
+  electionLeg,
   formatDealValue,
   formatExpectedClose,
   formatListDate,
   formatPercentShort,
   formatPerShare,
   formatPrice,
+  inQuoteCurrency,
+  isElection,
   MISSING,
+  offerSeries,
   stageLabel,
   termsLabel,
 } from "./model";
@@ -70,11 +74,15 @@ async function dailyCloses(provider: AssetDataProvider, symbol: string, from: st
   return points.filter((point) => Number.isFinite(point.close) && dayOf(point) >= from);
 }
 
-/** The target's daily closes since before the announcement, and the listing a ratio pays in. */
-function useDealHistory(deal: MnaDeal | null) {
+/**
+ * The target's daily closes since before the announcement, and the listing a
+ * ratio pays in when the offer line needs it (an election priced at its cash
+ * leg does not).
+ */
+function useDealHistory(deal: MnaDeal | null, leg: "cash" | "stock" | null) {
   const provider = useAssetData();
   const target = deal?.target.symbol ?? null;
-  const ratio = deal?.terms.exchangeRatio != null ? deal.terms.ratioSymbol : null;
+  const ratio = deal?.terms.exchangeRatio != null && leg !== "cash" ? deal.terms.ratioSymbol : null;
   const from = deal ? shiftDay(deal.announced, -LEAD_DAYS) : null;
   const [history, setHistory] = useState<{ key: string; target: PricePoint[]; ratio: PricePoint[] } | null>(null);
   const key = `${target}:${ratio}:${from}`;
@@ -94,30 +102,6 @@ function useDealHistory(deal: MnaDeal | null) {
   return history?.key === key ? history : null;
 }
 
-/**
- * What the terms were worth each day since the announcement: flat for cash,
- * the ratio times the paying listing's close for stock.
- */
-function offerSeries(deal: MnaDeal, ratioCloses: readonly PricePoint[], days: readonly string[]): Array<{ day: string; value: number }> {
-  const { cashPerShare, exchangeRatio, currency } = deal.terms;
-  if (cashPerShare == null && exchangeRatio == null) return [];
-  const pence = currency === "GBp" || currency === "GBX";
-  const cash = cashPerShare == null ? 0 : pence ? cashPerShare / 100 : cashPerShare;
-  const ratioByDay = new Map(ratioCloses.map((point) => [dayOf(point), point.close]));
-  const out: Array<{ day: string; value: number }> = [];
-  let lastRatio: number | null = null;
-  for (const day of days) {
-    if (day < deal.announced) continue;
-    if (exchangeRatio == null) {
-      out.push({ day, value: cash });
-      continue;
-    }
-    lastRatio = ratioByDay.get(day) ?? lastRatio;
-    if (lastRatio != null) out.push({ day, value: cash + exchangeRatio * lastRatio });
-  }
-  return out;
-}
-
 export function MnaDealDetail({ id, seed, focused, width, height }: {
   id: string;
   /** The list's copy, drawn while the full deal loads. */
@@ -151,7 +135,9 @@ export function MnaDealDetail({ id, seed, focused, width, height }: {
   const targetQuote = deal?.target.symbol ? quotes.get(deal.target.symbol)?.quote ?? null : null;
   const ratioQuote = deal?.terms.ratioSymbol ? quotes.get(deal.terms.ratioSymbol)?.quote ?? null : null;
   const spread = deal ? dealSpread(deal, targetQuote, ratioQuote) : null;
-  const history = useDealHistory(deal);
+  // The leg an election's Offer, premium and offer line are priced at; null for other terms.
+  const leg = deal && isElection(deal.terms) ? electionLeg(deal.terms, targetQuote) : null;
+  const history = useDealHistory(deal, leg);
 
   const unaffected = useMemo(() => {
     if (!deal || !history) return null;
@@ -175,7 +161,7 @@ export function MnaDealDetail({ id, seed, focused, width, height }: {
         tone: spread.spread < 0 ? "warning" : undefined,
       });
       if (spread.annualized != null) items.push({ id: "ann", label: "Ann.", value: formatPercentShort(spread.annualized) });
-      if (unaffected && unaffected.close > 0 && deal.terms.exchangeRatio == null) {
+      if (unaffected && unaffected.close > 0 && (deal.terms.exchangeRatio == null || leg === "cash")) {
         items.push({
           id: "premium",
           label: "Premium",
@@ -199,12 +185,14 @@ export function MnaDealDetail({ id, seed, focused, width, height }: {
       if (spread) items.push({ id: "stage", label: "Stage", value: stageLabel(deal) });
     }
     return items;
-  }, [deal, spread, targetQuote?.currency, unaffected]);
+  }, [deal, leg, spread, targetQuote?.currency, unaffected]);
 
   const series = useMemo(() => {
     if (!deal?.target.symbol || !history || history.target.length < 3) return [];
     const days = history.target.map(dayOf);
-    const offer = offerSeries(deal, history.ratio, days);
+    const offer = leg === "stock"
+      ? offerSeries(deal, history.ratio, days, leg, (close) => inQuoteCurrency(close, ratioQuote?.currency ?? null, targetQuote?.currency))
+      : offerSeries(deal, history.ratio, days, leg);
     const priced = [
       staticSeries(
         history.target.map((point) => ({ date: point.date, observedAt: point.date, value: point.close })),
@@ -221,7 +209,7 @@ export function MnaDealDetail({ id, seed, focused, width, height }: {
       ));
     }
     return priced;
-  }, [colors.positive, colors.text, deal, history]);
+  }, [colors.positive, colors.text, deal, history, leg, ratioQuote?.currency, targetQuote?.currency]);
 
   const selected = events.find((event) => event.id === selectedEvent) ?? events[0] ?? null;
   const openSource = useCallback((event: MnaDealEvent | null) => {

package/src/plugins/builtin/mna/distress/detail.tsx

@@ -8,7 +8,8 @@ import type {
 } from "../../../../api-client/distress";
 import { BulletList, ExternalLinkText, Prose, READING_WIDTH } from "../../../../components";
 import { useThemeColors } from "../../../../theme/theme-context";
-import { Box, Text } from "../../../../ui";
+import { Box, Text, useUiCapabilities } from "../../../../ui";
+import { CountryFlagLead } from "../../../../components/ui/country-flag";
 import { truncateToDisplayWidth } from "../../../../utils/format";
 import {
   assessmentHorizonLabel,
@@ -42,16 +43,27 @@ const LABEL_WIDTH = 16;
  * source publishes under beside its rows.
  */
 
-function Field({ label, value, width, bright = false }: { label: string; value: string; width: number; bright?: boolean }) {
+function Field({ label, value, width, bright = false, country }: {
+  label: string;
+  value: string;
+  width: number;
+  bright?: boolean;
+  /** The country the value names: the desktop and the web lead it with its flag. */
+  country?: string;
+}) {
   const colors = useThemeColors();
+  const desktop = useUiCapabilities().nativePaneChrome === true;
   const valueWidth = Math.max(8, width - LABEL_WIDTH);
+  const prose = <Prose text={value || MISSING} width={valueWidth} color={bright ? colors.textBright : colors.text} figures={false} />;
   return (
     <Box flexDirection="row" width={width} flexShrink={0}>
       <Box width={LABEL_WIDTH} flexShrink={0} overflow="hidden">
         <Text fg={colors.textDim}>{label}</Text>
       </Box>
       <Box flexDirection="column" width={valueWidth} flexShrink={0}>
-        <Prose text={value || MISSING} width={valueWidth} color={bright ? colors.textBright : colors.text} figures={false} />
+        {desktop && country
+          ? <Box flexDirection="row" alignItems="center"><CountryFlagLead value={country} /><Box flexDirection="column">{prose}</Box></Box>
+          : prose}
       </Box>
     </Box>
   );
@@ -227,7 +239,7 @@ export function InsolvencyDetail({ row, width, attributions }: { row: Insolvency
       <Field label="Published" value={isoDay(row.published_date)} width={bodyWidth} />
       {row.court.trim() ? <Field label="Court" value={cellText(row.court)} width={bodyWidth} /> : null}
       <Field label={registryLabel(row.country)} value={row.registry_id} width={bodyWidth} />
-      <Field label="Country" value={france ? "France" : row.country === "GB" ? "United Kingdom" : row.country} width={bodyWidth} />
+      <Field label="Country" value={france ? "France" : row.country === "GB" ? "United Kingdom" : row.country} country={row.country} width={bodyWidth} />
       {/* A correction says which notice it corrects; an initial notice needs no line. */}
       {row.notice_type !== "annonce" ? (
         <Field

package/src/plugins/builtin/mna/distress/model.ts

@@ -462,11 +462,12 @@ export function designationColumns(width: number): Column[] {
   ], ["exchange", "code"], width);
 }
 
-export function insolvencyColumns(width: number): Column[] {
+/** `flagRoom` widens the country column for the flag the desktop draws before its code. */
+export function insolvencyColumns(width: number, flagRoom = 0): Column[] {
   return fit([
     { id: "published", label: "Published", width: 10, align: "left" },
     { id: "company", label: "Company", width: 22, align: "left", flexGrow: 1 },
-    { id: "country", label: "Ctry", width: 4, align: "left" },
+    { id: "country", label: "Ctry", width: 4 + flagRoom, align: "left" },
     { id: "registry", label: "Registry no.", width: 12, align: "left" },
     { id: "procedure", label: "Procedure", width: 22, align: "left" },
     { id: "notice", label: "Notice", width: 26, align: "left", flexGrow: 1 },

package/src/plugins/builtin/mna/distress/pane.tsx

@@ -29,7 +29,8 @@ import type {
 import type { CloudFilingEventPayload } from "../../../../api-client";
 import { useAutoRefresh, usePluginPaneState } from "../../../../public/react";
 import { useThemeColors } from "../../../../theme/theme-context";
-import { Box, type ScrollBoxRenderable } from "../../../../ui";
+import { Box, useUiCapabilities, type ScrollBoxRenderable } from "../../../../ui";
+import { COUNTRY_FLAG_CELLS, withCountryFlag } from "../../../../components/ui/country-flag";
 import { usePluginTickerActions } from "../../../runtime";
 import { toneColor, type StateTone } from "../../shared/research-cells";
 import {
@@ -419,6 +420,8 @@ function InsolvencyList({ country, kind, namePrefix: prefix, search, searching,
     const rows = loaded.payload.notices;
     return { rows, hasMore: canPage(loaded.payload.hasMore, offset + rows.length), nextOffset: offset + rows.length, loaded, attributions: loaded.payload.attributions };
   }, [country, kind, prefix]);
+  // The desktop and the web lead each country code with its flag.
+  const flagged = useUiCapabilities().nativePaneChrome === true;
   const spec = useMemo<RowSpec<InsolvencyNotice>>(() => ({
     getId: insolvencyId,
     title: (row) => cellText(row.entity_name),
@@ -429,7 +432,7 @@ function InsolvencyList({ country, kind, namePrefix: prefix, search, searching,
       switch (column) {
         case "published": return { text: isoDay(row.published_date), color: muted };
         case "company": return { text: cellText(row.entity_name), color: base };
-        case "country": return { text: row.country, color: muted };
+        case "country": return withCountryFlag({ text: row.country, color: muted }, row.country, flagged);
         case "registry": return { text: row.registry_id, color: muted };
         case "procedure": return { text: insolvencyProcedureCell(row), color: tone(insolvencyTone(row)) };
         case "notice": return { text: insolvencyNoticeLabel(row, "short"), color: muted };
@@ -437,7 +440,7 @@ function InsolvencyList({ country, kind, namePrefix: prefix, search, searching,
       }
     },
     detail: (row, width, attributions) => <InsolvencyDetail row={row} width={width} attributions={attributions} />,
-  }), []);
+  }), [flagged]);
   const hints = useMemo<PaneHint[]>(() => [{ id: "distress-search", key: "/", label: "search", onPress: onSearch }], [onSearch]);
   return (
     <DistressTable
@@ -445,7 +448,7 @@ function InsolvencyList({ country, kind, namePrefix: prefix, search, searching,
       viewId="insolvency"
       loader={loader}
       spec={spec}
-      columns={insolvencyColumns(props.width)}
+      columns={insolvencyColumns(props.width, flagged ? COUNTRY_FLAG_CELLS : 0)}
       subject="insolvency notices"
       search={search}
       searching={searching}

package/src/plugins/builtin/mna/headless.ts

@@ -1,9 +1,7 @@
 import type { MnaDealsParams, MnaRegionFilter, MnaStatusFilter, MnaTargetFilter } from "../../../api-client/mna";
 import type { HeadlessPaneColumn, HeadlessPaneDefinition } from "../../../types/plugin";
 import { fetchMnaDeals } from "./client";
-import { formatDealValue, formatExpectedClose, stageLabel, termsLabel } from "./model";
-import { listingAbroadVenue } from "../../../utils/sec";
-import { shortCompanyName } from "../../../tickers/company-name";
+import { dealsSymbol, formatDealValue, formatExpectedClose, stageLabel, termsLabel } from "./model";
 import { REPORT_ROWS } from "../shared/headless-options";
 
 const text = (value: unknown) => (typeof value === "string" ? value : "");
@@ -58,19 +56,14 @@ export const mnaHeadless: HeadlessPaneDefinition<"rows"> = {
   },
   async load(args, ctx) {
     const symbol = args.symbols[0];
-    // Deals carry US tickers, where SAN is not SAN:EPA's company: a listing abroad is looked up by its company's name.
-    const company = symbol && listingAbroadVenue(symbol)
-      ? await ctx.marketData.getQuote(symbol, "").then((quote) => quote.name?.trim() || null, () => null)
-      : null;
-    if (symbol && listingAbroadVenue(symbol) && !company) {
-      throw new Error(`Deals are filed by US ticker or company name, and ${symbol} has no company name to look them up by.`);
-    }
+    // A listing abroad (ATH:TSX) asks by the quote symbol its deals are filed under (ATH.TO), as the pane does.
+    const filed = symbol ? dealsSymbol(symbol) : "";
     const params: MnaDealsParams = {
       status: ((args.options.status as MnaStatusFilter | undefined) ?? (symbol ? "all" : "pending")),
       target: symbol ? undefined : (args.options.target as MnaTargetFilter | undefined),
       region: symbol ? undefined : (args.options.region as MnaRegionFilter | undefined),
-      symbol: company ? undefined : symbol,
-      query: text(args.options.query) || (company ? shortCompanyName(company) : undefined),
+      symbol: filed || undefined,
+      query: text(args.options.query) || undefined,
       limit: Number(args.options.limit ?? 50),
     };
     const payload = await fetchMnaDeals(params, ctx.apiClient);
@@ -90,6 +83,7 @@ export const mnaHeadless: HeadlessPaneDefinition<"rows"> = {
         cashPerShare: deal.terms.cashPerShare,
         exchangeRatio: deal.terms.exchangeRatio,
         ratioSymbol: deal.terms.ratioSymbol,
+        election: deal.terms.election === true,
         currency: deal.terms.currency,
         value: formatDealValue(deal.value, deal.valueCurrency),
         valueUsd: deal.valueUsd,
@@ -100,7 +94,6 @@ export const mnaHeadless: HeadlessPaneDefinition<"rows"> = {
       errors: payload.lockedDeals > 0 ? [`${payload.lockedDeals} deals from the last ${payload.delayDays} days need Gloom Pro`] : [],
       metadata: {
         asOf: payload.asOf, access: payload.access, delayDays: payload.delayDays, hasMore: payload.hasMore,
-        ...(company ? { notices: [`Deals are filed by US ticker, so ${symbol}'s are the ones naming ${shortCompanyName(company)}.`] } : {}),
       },
     };
   },

package/src/plugins/builtin/mna/model.ts

@@ -1,6 +1,9 @@
 import type { MnaDeal, MnaStatus, MnaTerms } from "../../../api-client/mna";
 import type { Quote } from "../../../types/financials";
+import { getListingSymbol } from "../../../sources/listing-symbols";
+import { parsePublicTickerKey } from "../../../utils/exchanges";
 import { formatCompact } from "../../../utils/format";
+import { nonUsSecListingVenue } from "../../../utils/sec";
 
 export const MNA_PANE_ID = "mna";
 export const MISSING = "--";
@@ -33,6 +36,28 @@ function ratioLabel(ratio: number, symbol: string | null): string {
   return symbol ? `${shares} ${symbol}` : `${shares} sh`;
 }
 
+/**
+ * The symbol a company's deals are filed under, from the ticker a pane is
+ * linked to. A deal carries its companies' quote symbols: plain for a US
+ * listing, suffixed by the venue elsewhere (ATH.TO, SHEL.L, 9984.T). A
+ * listing abroad therefore asks by that quote symbol: its bare symbol is
+ * another company's US ticker (ATH is Athene in New York, Athabasca in
+ * Toronto). A US listing, a symbol with no venue and a symbol already
+ * suffixed go as they are, so a US ticker is asked for exactly as before.
+ * `savedExchange` is the venue the saved ticker names, for a key with none.
+ */
+export function dealsSymbol(key: string | null | undefined, savedExchange = ""): string {
+  const value = key?.trim();
+  if (!value) return "";
+  if (nonUsSecListingVenue(value, savedExchange)) return getListingSymbol(value, savedExchange).toUpperCase();
+  return parsePublicTickerKey(value).symbol;
+}
+
+/** Each holder gets the cash or the shares, not both. Older servers never say so. */
+export function isElection(terms: MnaTerms): boolean {
+  return terms.election === true && terms.cashPerShare != null && terms.exchangeRatio != null;
+}
+
 /** What one target share gets, in as few characters as the terms allow. */
 export function termsLabel(terms: MnaTerms): string {
   const parts: string[] = [];
@@ -48,7 +73,7 @@ export function termsLabel(terms: MnaTerms): string {
         : terms.consideration === "mixed" ? "Cash and stock"
           : MISSING);
   }
-  let label = parts.join(" + ");
+  let label = parts.join(isElection(terms) ? " or " : " + ");
   if (terms.cvr) label += " + CVR";
   if (terms.partial) label += ", partial";
   return label;
@@ -75,7 +100,7 @@ const PENCE = new Set(["GBp", "GBX"]);
  * London quotes arrive in pounds while UK offers are often in pence, so the
  * two compare after scaling; any other currency mismatch has no price.
  */
-function inQuoteCurrency(amount: number, from: string | null, quoteCurrency: string | undefined): number | null {
+export function inQuoteCurrency(amount: number, from: string | null, quoteCurrency: string | undefined): number | null {
   const offer = from ?? "USD";
   const quote = quoteCurrency ?? "USD";
   if (offer === quote) return amount;
@@ -85,28 +110,81 @@ function inQuoteCurrency(amount: number, from: string | null, quoteCurrency: str
   return offer.toUpperCase() === quote.toUpperCase() ? amount : null;
 }
 
+function cashLeg(terms: MnaTerms, targetQuote: Quote | null): number | null {
+  return terms.cashPerShare == null ? null : inQuoteCurrency(terms.cashPerShare, terms.currency, targetQuote?.currency);
+}
+
+function stockLeg(terms: MnaTerms, targetQuote: Quote | null, ratioQuote: Quote | null): number | null {
+  const price = ratioQuote?.price;
+  if (terms.exchangeRatio == null || !terms.ratioSymbol || price == null || !Number.isFinite(price) || price <= 0) return null;
+  const leg = inQuoteCurrency(price, ratioQuote?.currency ?? null, targetQuote?.currency);
+  return leg == null ? null : terms.exchangeRatio * leg;
+}
+
+/**
+ * The leg an election is priced at. It pays each holder the cash or the
+ * shares, never both, so it is priced at its cash leg: the legs are set about
+ * equal at signing, proration means a holder cannot count on getting the
+ * stock, and the cash does not move. The stock leg stands in only when the
+ * cash cannot be compared with the target's quote. Without a quote, the cash.
+ */
+export function electionLeg(terms: MnaTerms, targetQuote: Quote | null): "cash" | "stock" {
+  return !targetQuote || cashLeg(terms, targetQuote) != null ? "cash" : "stock";
+}
+
 /**
  * What the terms pay per target share at the latest prices, in the target
  * quote's currency. Null when a leg cannot be priced: no terms, a ratio
- * without its listing, or cash in another currency.
+ * without its listing, or cash in another currency. An election is one leg,
+ * the one {@link electionLeg} picks.
  */
 function offerValue(deal: MnaDeal, targetQuote: Quote | null, ratioQuote: Quote | null): number | null {
   const { terms } = deal;
   if (terms.cashPerShare == null && terms.exchangeRatio == null) return null;
-  let total = 0;
-  if (terms.cashPerShare != null) {
-    const cash = inQuoteCurrency(terms.cashPerShare, terms.currency, targetQuote?.currency);
-    if (cash == null) return null;
-    total += cash;
+  let total: number | null;
+  if (isElection(terms)) {
+    total = electionLeg(terms, targetQuote) === "cash"
+      ? cashLeg(terms, targetQuote)
+      : stockLeg(terms, targetQuote, ratioQuote);
+  } else {
+    const cash = terms.cashPerShare == null ? 0 : cashLeg(terms, targetQuote);
+    const stock = terms.exchangeRatio == null ? 0 : stockLeg(terms, targetQuote, ratioQuote);
+    total = cash == null || stock == null ? null : cash + stock;
   }
-  if (terms.exchangeRatio != null) {
-    const price = ratioQuote?.price;
-    if (!terms.ratioSymbol || price == null || !Number.isFinite(price) || price <= 0) return null;
-    const leg = inQuoteCurrency(price, ratioQuote?.currency ?? null, targetQuote?.currency);
-    if (leg == null) return null;
-    total += terms.exchangeRatio * leg;
+  return total != null && total > 0 ? total : null;
+}
+
+/**
+ * What the terms were worth each day since the announcement: flat for cash,
+ * the ratio times the paying listing's close for stock. An election draws
+ * the one leg its Offer is priced at (`leg`, from {@link electionLeg}), its
+ * stock leg in the target quote's currency as the Offer converts it.
+ */
+export function offerSeries(
+  deal: MnaDeal,
+  ratioCloses: readonly { date: Date; close: number }[],
+  days: readonly string[],
+  leg: "cash" | "stock" | null,
+  toQuote: (close: number) => number | null = (close) => close,
+): Array<{ day: string; value: number }> {
+  const { cashPerShare, exchangeRatio, currency } = deal.terms;
+  if (cashPerShare == null && exchangeRatio == null) return [];
+  const pence = currency === "GBp" || currency === "GBX";
+  const cash = cashPerShare == null || leg === "stock" ? 0 : pence ? cashPerShare / 100 : cashPerShare;
+  const ratioByDay = new Map(ratioCloses.map((point) => [point.date.toISOString().slice(0, 10), point.close]));
+  const out: Array<{ day: string; value: number }> = [];
+  let lastRatio: number | null = null;
+  for (const day of days) {
+    if (day < deal.announced) continue;
+    if (exchangeRatio == null || leg === "cash") {
+      out.push({ day, value: cash });
+      continue;
+    }
+    const close = ratioByDay.get(day);
+    lastRatio = close == null ? lastRatio : toQuote(close) ?? lastRatio;
+    if (lastRatio != null) out.push({ day, value: cash + exchangeRatio * lastRatio });
   }
-  return total > 0 ? total : null;
+  return out;
 }
 
 export interface DealSpread {

package/src/plugins/builtin/mna/pane.tsx

@@ -26,7 +26,6 @@ import { usePlanAccess } from "../../../api-client/plan-access";
 import { useAsyncResource, useAutoRefresh, usePaneSettingValue, usePluginPaneState, useShortcut } from "../../../public/react";
 import { usePaneInstance } from "../../../state/app/context";
 import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
-import { listingIdentity } from "../shared/ticker-request";
 import { blendHex } from "../../../theme/colors";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps, TickerResearchTabProps } from "../../../types/plugin";
@@ -42,6 +41,7 @@ import { MnaDealDetail, mnaDealTitle } from "./detail";
 import { DistressBoard } from "./distress/pane";
 import {
   dealSpread,
+  dealsSymbol,
   expectedCloseDate,
   formatDealValue,
   formatExpectedClose,
@@ -133,10 +133,11 @@ const MNA_TABS: { label: string; value: MnaTab }[] = [
 
 /** `MA`, or `MA ACVA`. A link supplies the ticker; an older pane still has it in settings. */
 export function MnaPane(props: PaneProps) {
-  const { symbol: bound } = usePaneTickerIdentity();
+  const { symbol: bound, ticker: boundTicker } = usePaneTickerIdentity();
   const [ticker] = usePaneSettingValue("ticker", "");
   const fromSettings = typeof ticker === "string" ? ticker.trim().toUpperCase() : "";
-  const symbol = listingIdentity(bound)?.symbol || fromSettings;
+  // Deals are filed under a listing's quote symbol (ATH.TO), not its bare symbol (ATH:TSX is not ATH).
+  const symbol = dealsSymbol(bound, boundTicker?.metadata.exchange) || fromSettings;
   // One company's deals have no market-wide distress tab beside them.
   if (symbol) return <MnaDealsView key={symbol} focused={props.focused} width={props.width} height={props.height} symbol={symbol} />;
   return <MnaBoard focused={props.focused} width={props.width} height={props.height} />;
@@ -172,7 +173,7 @@ function MnaBoard({ focused, width, height }: { focused: boolean; width: number;
 
 export function MnaTickerTab({ focused, width, height }: TickerResearchTabProps) {
   const { ticker } = usePaneTickerIdentity();
-  const symbol = ticker?.metadata.ticker;
+  const symbol = dealsSymbol(ticker?.metadata.ticker, ticker?.metadata.exchange);
   if (!symbol) return <EmptyState title="Select a ticker." />;
   return <MnaDealsView key={symbol} focused={focused} width={width} height={height} symbol={symbol} />;
 }

package/src/plugins/builtin/news/headless.ts

@@ -1,4 +1,3 @@
-import type { CloudNewsListResponse } from "../../../api-client";
 import type {
   HeadlessPaneContext,
   HeadlessPaneDefinition,
@@ -7,8 +6,10 @@ import type {
 } from "../../../types/plugin";
 import type { NewsArticle, NewsQuery } from "../../../news/types";
 import {
-  cloudNewsParams,
+  coinNewsFallbackNotice,
   mapCloudNewsArticle,
+  readCloudNews,
+  type CloudNewsRead,
 } from "../../../sources/gloomberb-cloud/news";
 import { parsePublicTickerKey } from "../../../utils/exchanges";
 import { formatUtcSeconds } from "../../../utils/utc-time";
@@ -29,14 +30,14 @@ export interface NewsHeadlessDependencies {
   loadNews(
     query: NewsQuery,
     context: HeadlessPaneContext,
-  ): Promise<CloudNewsListResponse>;
+  ): Promise<CloudNewsRead>;
   now(): Date;
   /** Whether the session has real-time news; without it the stories are held back. */
   realtimeAccess?(): Promise<boolean | null>;
 }
 
 const defaultDependencies: NewsHeadlessDependencies = {
-  loadNews: (query, context) => context.apiClient.getCloudNews(cloudNewsParams(query)),
+  loadNews: (query, context) => readCloudNews(context.apiClient, query),
   now: () => new Date(),
   realtimeAccess: cloudRealtimeAccess,
 };
@@ -71,7 +72,7 @@ function selectedSentiment(args: HeadlessPaneLoadArgs): string {
 }
 
 function projectNewsHeadless(
-  response: CloudNewsListResponse,
+  response: CloudNewsRead,
   args: HeadlessPaneLoadArgs,
   now: Date,
   realtime: boolean | null,
@@ -80,7 +81,7 @@ function projectNewsHeadless(
   const minImportance = Number(args.options.minImportance ?? 0);
   const limit = Number(args.options.limit ?? 50);
   const matching = response.items
-    .map((item) => mapCloudNewsArticle(item, args.symbols[0]))
+    .map((item) => mapCloudNewsArticle(item, response.searchedFor ? undefined : args.symbols[0]))
     .filter((article) => sentiment === "any" || article.sentiment === sentiment)
     .filter((article) => article.importance >= minImportance)
     .sort((left, right) => right.publishedAt.getTime() - left.publishedAt.getTime());
@@ -91,6 +92,10 @@ function projectNewsHeadless(
     items,
     // Dated by the newest story, held back for an account without real-time news.
     freshness: cloudNewsFreshness(realtime),
+    // A coin pair no story is filed under shows the stories that mention the coin, and says so.
+    ...(response.searchedFor && args.symbols[0]
+      ? { notes: [coinNewsFallbackNotice(parsePublicTickerKey(args.symbols[0]).symbol, response.searchedFor)] }
+      : {}),
     metadata: {
       nextCursor: response.nextCursor,
       sentiment,
@@ -98,6 +103,7 @@ function projectNewsHeadless(
       total: matching.length,
       returned: items.length,
       truncated: items.length < matching.length || response.nextCursor != null,
+      ...(response.searchedFor ? { searchedFor: response.searchedFor } : {}),
     },
   };
 }

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

@@ -5,7 +5,8 @@ import { useArticleSummary, useResolvedEntryValue } from "../../../market-data/h
 import { instrumentFromTicker } from "../../../market-data/request-types";
 import { useCallback } from "react";
 import { useDebouncedPluginPaneState, usePluginPaneState } from "../../runtime";
-import { EmptyState, PaneStatusBody, QueryBar } from "../../../components";
+import { EmptyState, PaneStatusBody, QueryBar, usePaneNoticeFooter } from "../../../components";
+import { coinNewsFallbackNotice } from "../../../sources/gloomberb-cloud/news";
 import { newsMuteSettingsDef, newsMutesApplyToFeed, useNewsMuteFilter } from "./wire/mutes";
 import { newsListEmptyCopy } from "./wire/filter-articles";
 import { NEWS_LIST_SEARCH_PLACEHOLDER, useNewsListSearch, useNewsListSearchHint } from "./wire/news/list-search";
@@ -45,6 +46,7 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
     exchange: instrument.exchange,
     tickerTier: "primary" as const,
     limit: NEWS_ITEM_LIMIT,
+    ...(ticker?.metadata.name ? { listingName: ticker.metadata.name } : {}),
   } : null;
   const newsState = useNewsArticles(newsQuery);
   const loaded = usePersistedNewsArticles(
@@ -91,6 +93,13 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
   }, [markArticleRead, popOutArticle, readableArticle]);
 
   useNewsListSearchHint("ticker-news", focused && !detailOpen, search.focusSearch);
+  // A coin pair no story is filed under lists the stories that mention the coin; the footer says so.
+  const searchedFor = loaded[0]?.searchedFor;
+  usePaneNoticeFooter({
+    registrationId: "ticker-news-notices",
+    notices: searchedFor && instrument ? [coinNewsFallbackNotice(instrument.symbol, searchedFor)] : [],
+    focused,
+  });
   useNewsArticleFooter({
     registrationId: "news",
     focused: listFocused,

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

@@ -92,6 +92,7 @@ const newsWirePanes: PluginModule["panes"] = [
     {
       id: NEWS_STORY_PANE_ID,
       reportFreshness: NEWS_REPORT_FRESHNESS,
+      reportArgument: { kind: "free-text", placeholder: "story id", description: "The id of the story to open." },
       name: "Story",
       icon: "A",
       component: NewsStoryPane,
@@ -147,8 +148,8 @@ const newsWirePaneTemplates: PluginModule["paneTemplates"] = [
     id: "news-industry-pane",
     paneId: "news-industry",
     label: TOPIC_NEWS_TITLE,
-    description: "Market news by topic code (MNA, CB, ENERGY, REG, CRYPTO, EARN, IPO) or sector, and public fund letters (LTR)",
-    keywords: ["news", "industry", "sector", "topic", "ni", "mna", "central banks", "crypto", "ipo", "earnings", "regulation", "letters", "ltr", "fund letters", "investor letters"],
+    description: "Market news by topic code (MNA, CB, ENERGY, METALS, REG, CRYPTO, EARN, IPO) or sector, and public fund letters (LTR)",
+    keywords: ["news", "industry", "sector", "topic", "ni", "mna", "central banks", "metals", "precious metals", "crypto", "ipo", "earnings", "regulation", "letters", "ltr", "fund letters", "investor letters"],
     shortcut: {
       prefix: "NI",
       argPlaceholder: "code",