gloomberb 0.16.2 → 0.16.4

package/src/theme/themes.ts

@@ -633,6 +633,81 @@ const rawThemes: Record<string, Theme> = {
     commandBg: "#000033",
     commandBorder: "#ff6600",
   },
+
+  // Gains, losses, warnings and chart series stay apart for deuteranopia,
+  // protanopia and tritanopia: up is blue, down is vermillion (the Okabe-Ito
+  // set), never red against green. The chrome is grey so hue only ever means
+  // data. themes.test.ts simulates the three deficiencies on these palettes.
+  colorblind: {
+    name: "Colorblind",
+    description: "Blue gains and vermillion losses, safe for color-blind eyes",
+    bg: "#0e1013",
+    panel: "#15181c",
+    border: "#3b4149",
+    borderFocused: "#d7dade",
+    text: "#e4e6e9",
+    textDim: "#a3a9b2",
+    textBright: "#ffffff",
+    textMuted: "#858c96",
+    positive: "#56b4e9",
+    negative: "#e66a1f",
+    neutral: "#9aa0a8",
+    warning: "#f0e442",
+    header: "#1c2026",
+    headerText: "#ffffff",
+    selected: "#2b3540",
+    selectedText: "#ffffff",
+    commandBg: "#15181c",
+    commandBorder: "#a3a9b2",
+  },
+
+  "colorblind-light": {
+    name: "Colorblind Light",
+    description: "Light, blue gains and vermillion losses, safe for color-blind eyes",
+    bg: "#ffffff",
+    panel: "#f5f6f8",
+    border: "#c8cdd4",
+    borderFocused: "#1f2328",
+    text: "#1f2328",
+    textDim: "#4d545e",
+    textBright: "#000000",
+    textMuted: "#646b75",
+    positive: "#0072b2",
+    negative: "#a84100",
+    neutral: "#5f6670",
+    warning: "#a27409",
+    header: "#e9ecef",
+    headerText: "#1f2328",
+    selected: "#d3e3f0",
+    selectedText: "#000000",
+    commandBg: "#f5f6f8",
+    commandBorder: "#1f2328",
+  },
+
+  // Every text role clears 7:1 (WCAG AAA) on the page, and the up, down and
+  // warning colours are the colour-blind safe ones.
+  "high-contrast": {
+    name: "High Contrast",
+    description: "White on black at AAA contrast, color-blind safe",
+    bg: "#000000",
+    panel: "#000000",
+    border: "#9a9a9a",
+    borderFocused: "#ffffff",
+    text: "#ffffff",
+    textDim: "#e0e0e0",
+    textBright: "#ffffff",
+    textMuted: "#c8c8c8",
+    positive: "#56b4e9",
+    negative: "#ff8c42",
+    neutral: "#c8c8c8",
+    warning: "#f0e442",
+    header: "#1a1a1a",
+    headerText: "#ffffff",
+    selected: "#3d3d3d",
+    selectedText: "#ffffff",
+    commandBg: "#000000",
+    commandBorder: "#ffffff",
+  },
 };
 
 export const themes: Record<string, Theme> = Object.fromEntries(
@@ -661,3 +736,77 @@ export function isDarkTheme(themeId: string): boolean {
 export function getTheme(id: string): Theme {
   return themes[id] ?? themes[DEFAULT_THEME]!;
 }
+
+type ThemeTrait = "colorblind-safe" | "high-contrast";
+
+const THEME_TRAITS: Readonly<Record<string, readonly ThemeTrait[]>> = {
+  colorblind: ["colorblind-safe"],
+  "colorblind-light": ["colorblind-safe"],
+  "high-contrast": ["high-contrast", "colorblind-safe"],
+};
+
+export interface ThemeSummary {
+  id: string;
+  name: string;
+  appearance: "dark" | "light";
+  traits: readonly ThemeTrait[];
+}
+
+/** Every theme in registry order: what `config themes`, help and the docs list. */
+export function listThemes(): ThemeSummary[] {
+  return getThemeIds().map((id) => ({
+    id,
+    name: themes[id]!.name,
+    appearance: isDarkTheme(id) ? "dark" : "light",
+    traits: THEME_TRAITS[id] ?? [],
+  }));
+}
+
+export type ThemeLookup =
+  | { ok: true; id: string }
+  | { ok: false; suggestion: string | null };
+
+/** `White Phosphor`, `white_phosphor` and `WHITE` all read as `white-phosphor` / `white`. */
+function themeKey(value: string): string {
+  return value.trim().toLowerCase().replace(/[\s_]+/g, "-");
+}
+
+function editDistance(left: string, right: string): number {
+  let previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+  for (let row = 1; row <= left.length; row += 1) {
+    const current = [row];
+    for (let column = 1; column <= right.length; column += 1) {
+      const substitution = previous[column - 1]! + (left[row - 1] === right[column - 1] ? 0 : 1);
+      current.push(Math.min(previous[column]! + 1, current[column - 1]! + 1, substitution));
+    }
+    previous = current;
+  }
+  return previous[right.length]!;
+}
+
+/**
+ * The theme id a person meant. An id or a display name, in any case, is that
+ * theme; anything else is unknown, with the closest id when the input is a
+ * typo of one (or of a name), or names part of exactly one theme.
+ */
+export function resolveThemeId(input: string): ThemeLookup {
+  const key = themeKey(input);
+  const ids = getThemeIds();
+  const exact = ids.find((id) => id === key) ?? ids.find((id) => themeKey(themes[id]!.name) === key);
+  if (exact) return { ok: true, id: exact };
+  if (!key) return { ok: false, suggestion: null };
+
+  let best: { id: string; distance: number } | null = null;
+  for (const id of ids) {
+    for (const candidate of [id, themeKey(themes[id]!.name)]) {
+      const distance = editDistance(key, candidate);
+      if (!best || distance < best.distance) best = { id, distance };
+    }
+  }
+  const tolerance = Math.max(2, Math.floor(key.length / 3));
+  if (best && best.distance <= tolerance) return { ok: false, suggestion: best.id };
+  const partial = key.length >= 3
+    ? ids.filter((id) => id.includes(key) || themeKey(themes[id]!.name).includes(key))
+    : [];
+  return { ok: false, suggestion: partial.length === 1 ? partial[0]! : null };
+}

package/src/tickers/search/index.ts

@@ -9,6 +9,7 @@ import { assetClassMarketSymbol, parseAssetClassQuery } from "./asset-classes";
 import { searchContractKey, searchInstrumentKey } from "./identity";
 import { tickerInstrumentLabel } from "../instrument-label";
 import {
+  answersOnlyByKeyword,
   buildSymbolAliases,
   classifyInstrumentKind,
   findExactTickerSearchMatch,
@@ -178,6 +179,7 @@ function createProviderTickerSearchCandidates(
       instrumentClass: classifyInstrumentKind(result.brokerContract?.secType || result.type),
       instrumentType: result.brokerContract?.secType || result.type,
       searchAliases: buildSearchResultAliases(result),
+      ...(searchResultKeywords(result) ? { searchKeywords: searchResultKeywords(result) } : {}),
       result,
     }];
   });
@@ -251,7 +253,7 @@ export function buildTickerSearchCandidates({
   );
   const providerItems = createProviderTickerSearchCandidates(filteredProviderResults, tickers, candidateOptions);
   const ranked = rankTickerSearchItems([...localItems, ...providerItems], query);
-  return limitTickerSearchCandidates(assignTickerSearchCategories(ranked), totalLimit, localLimit);
+  return limitTickerSearchCandidates(assignTickerSearchCategories(ranked, query), totalLimit, localLimit);
 }
 
 interface ResolveTickerSearchOptions {
@@ -589,10 +591,22 @@ function getProviderHintScore(result: InstrumentSearchResult, preferredExchange?
   return getProviderHintRichness(result) + (matchesPreferredExchange ? 10_000 : 0);
 }
 
-function assignTickerSearchCategories<T extends TickerSearchCandidate>(items: T[]): T[] {
+/** Older servers send none; anything malformed is ignored. */
+function searchResultKeywords(result: InstrumentSearchResult): string[] | undefined {
+  const keywords = Array.isArray(result.searchKeywords)
+    ? result.searchKeywords.filter((keyword): keyword is string => typeof keyword === "string" && !!keyword.trim())
+    : [];
+  return keywords.length > 0 ? keywords : undefined;
+}
+
+function assignTickerSearchCategories<T extends TickerSearchCandidate>(items: T[], query: string): T[] {
   let assignedPrimaryListing = false;
 
   return items.map((item) => {
+    // A company the theme's funds hold is not another listing of the one searched for.
+    if (!item.saved && item.kind === "search" && item.instrumentClass === "equity" && answersOnlyByKeyword(item, query)) {
+      return { ...item, category: "Related" };
+    }
     if (item.saved || item.kind === "ticker") {
       if (item.instrumentClass !== "fund" && item.instrumentClass !== "derivative") {
         assignedPrimaryListing = true;
@@ -669,5 +683,11 @@ function buildSearchResultAliases(result: InstrumentSearchResult): string[] {
   if (result.brokerContract?.symbol) {
     for (const alias of buildSymbolAliases(result.brokerContract.symbol)) aliases.add(alias);
   }
+  // Older servers send none. Anything else malformed is ignored.
+  if (Array.isArray(result.searchAliases)) {
+    for (const alias of result.searchAliases) {
+      if (typeof alias === "string" && alias.trim()) aliases.add(alias.trim());
+    }
+  }
   return [...aliases];
 }

package/src/tickers/search/ranking.ts

@@ -216,7 +216,12 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
       const aliases = getItemSearchAliases(item);
       const aliasScore = (exactListingSymbol ? [...aliases, exactListingSymbol] : aliases)
         .reduce((best, alias) => Math.max(best, scoreSearchAlias(intent, alias)), 0);
-      const textScore = labelScore + detailScore + aliasScore
+      // Several words match on all of them, in any order, across the name, type,
+      // venue and the themes the row answers to; a theme alone ranks after a name.
+      const keywordScore = scoreAllWords(intent, [...(item.searchKeywords ?? [])]) > 0 ? KEYWORD_MATCH_SCORE : 0;
+      const wordsScore = labelScore + detailScore + aliasScore > 0 ? 0
+        : scoreAllWords(intent, [item.label, item.detail, item.right ?? "", ...(item.searchKeywords ?? [])]);
+      const textScore = labelScore + detailScore + aliasScore + Math.max(keywordScore, wordsScore)
         + (isQualifiedTickerQuery(query) && matchesQualifiedTicker(item, query) ? 100_000 : 0);
       const saved = isSavedSearchItem(item);
       const explicitIntentScore = scoreAssetPreference(intent, item.instrumentClass)
@@ -285,6 +290,13 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
     const aSaved = isSavedSearchItem(a.item);
     const bSaved = isSavedSearchItem(b.item);
     if (aSaved !== bSaved) return aSaved ? -1 : 1;
+    // Rows that answer to the same typed name (GOOGL and GOOG for "Google")
+    // keep the order the server gave them rather than the shorter symbol first.
+    if (a.symbolMatchRank === 2) {
+      const aProviderRank = a.item.providerRank ?? Number.POSITIVE_INFINITY;
+      const bProviderRank = b.item.providerRank ?? Number.POSITIVE_INFINITY;
+      if (aProviderRank !== bProviderRank) return aProviderRank - bProviderRank;
+    }
     if (a.item.label.length !== b.item.label.length) return a.item.label.length - b.item.label.length;
     return a.index - b.index;
   };
@@ -487,6 +499,38 @@ function getItemSearchAliases(item: Pick<TickerSearchRankableItem, "label"> & Pa
   return aliases.length > 0 ? aliases : [item.label];
 }
 
+/** A row that answers only to a theme it was sent with (`searchKeywords`), below any name match. */
+const KEYWORD_MATCH_SCORE = 500;
+/** Every query word found somewhere in the row, in any order. */
+const ALL_WORDS_SCORE = 2_200;
+
+/**
+ * ALL_WORDS_SCORE when every word of the query (exchange and asset words
+ * aside) starts a word of some field: "miners copper" finds "Copper Miners
+ * ETF", "lithium" finds a row sent with the lithium theme. Zero otherwise.
+ */
+function scoreAllWords(intent: SearchQueryIntent, fields: readonly string[]): number {
+  const terms = intent.companyQuery.split(" ").filter(Boolean);
+  if (terms.length === 0) return 0;
+  const words = fields.flatMap((field) => normalizeSearchText(field).split(" ").filter(Boolean));
+  return terms.every((term) => words.some((word) => word.startsWith(term))) ? ALL_WORDS_SCORE : 0;
+}
+
+/**
+ * Whether a row is in an answer for a theme it was sent with, not for its
+ * name: the name lacks some of the query's words (Albemarle for "lithium",
+ * Southern Copper for "copper miners").
+ */
+export function answersOnlyByKeyword(
+  item: Pick<TickerSearchRankableItem, "label" | "detail"> & Partial<TickerSearchRankableItem>,
+  query: string,
+): boolean {
+  if (!item.searchKeywords?.length) return false;
+  const terms = analyzeSearchQuery(query).companyQuery.split(" ").filter(Boolean);
+  const words = [item.label, item.detail].flatMap((field) => normalizeSearchText(field).split(" ").filter(Boolean));
+  return terms.length > 0 && !terms.every((term) => words.some((word) => word.startsWith(term)));
+}
+
 function maxScoreForQueries(
   queries: string[],
   value: string,

package/src/tickers/search/types.ts

@@ -2,7 +2,7 @@ import type { BrokerContractRef, InstrumentSearchResult, TickerListingRef } from
 import type { TickerRecord } from "../../types/ticker";
 
 export type TickerSearchInstrumentClass = "equity" | "fund" | "derivative" | "other";
-type TickerSearchCategory = "Saved" | "Primary Listing" | "Other Listings" | "Funds & Derivatives";
+type TickerSearchCategory = "Saved" | "Primary Listing" | "Other Listings" | "Funds & Derivatives" | "Related";
 
 export interface TickerSearchRankableItem {
   id: string;
@@ -21,6 +21,8 @@ export interface TickerSearchRankableItem {
   providerRank?: number;
   popularity?: number;
   searchAliases?: string[];
+  /** Themes the row answers to that its name does not say (`InstrumentSearchResult.searchKeywords`). */
+  searchKeywords?: string[];
 }
 
 export interface TickerSearchCandidate extends TickerSearchRankableItem {

package/src/time-series/resolution.ts

@@ -37,6 +37,21 @@ const RANGE_PRESET_RESOLUTION: Record<TimeRange, ManualChartResolution> = {
   "ALL": "1mo",
 };
 
+/**
+ * The bar size a price history for a range is served in, unlike the chart
+ * presets above: what `gloomberb history` and the historical prices pane get.
+ */
+export const RANGE_HISTORY_RESOLUTION: Readonly<Record<TimeRange, ManualChartResolution>> = {
+  "1D": "5m",
+  "1W": "1h",
+  "1M": "1d",
+  "3M": "1d",
+  "6M": "1d",
+  "1Y": "1d",
+  "5Y": "1wk",
+  "ALL": "1mo",
+};
+
 const RANGE_PRELOAD_BUFFER: Record<TimeRange, TimeRange> = {
   "1D": "1W",
   "1W": "1M",

package/src/time-series/resolve.ts

@@ -80,6 +80,7 @@ import { getPricePointTimestamp, isPriceHistoryStaleForCurrentWindow } from "../
 import { latestSessionStart, latestTradingSessionOpen, listingTimeZone, priorSessionClose } from "../market-data/market/trading-sessions";
 import { futuresGenericCaption, futuresGenericListing, futuresGenericPriceBasis } from "../utils/futures-generic";
 import { isOhlcSeriesStyle } from "./spec";
+import { SERIES_COLORS } from "../theme/series-colors";
 import type {
   ChartResolutionResult,
   ChartSeriesSpec,
@@ -88,20 +89,6 @@ import type {
   TimeSeriesPoint,
 } from "./types";
 
-/** Colours for series told apart by name (compared tickers, markets). */
-export const SERIES_COLORS = [
-  "#4dabf7",
-  "#63e6be",
-  "#f6c85f",
-  "#b197fc",
-  "#ff8787",
-  "#ffa94d",
-  "#74c0fc",
-  "#e599f7",
-  "#8ce99a",
-  "#ffd43b",
-] as const;
-
 export interface ChartResolveSources {
   dataProvider: DataProvider | null;
   loadFredSeries: (request: FredSeriesRequest) => Promise<FredSeriesLoadResult>;

package/src/types/config.ts

@@ -2,7 +2,7 @@ import type { Portfolio, Watchlist } from "./ticker";
 import type { BrokerContractRef, TickerListingRef } from "./instrument";
 import type { LanguagePreference } from "../i18n/languages";
 
-export const CURRENT_CONFIG_VERSION = 24;
+export const CURRENT_CONFIG_VERSION = 25;
 
 type ChartRendererPreference = "auto" | "kitty" | "braille";
 
@@ -59,6 +59,30 @@ export interface PanePlacementMemory {
   detached?: DetachedPlacementMemory;
 }
 
+/**
+ * A ticker link Move to New Layout had to cut: the pane followed another one
+ * that stayed behind (or left with the moved pane) and was pinned on `symbol`.
+ * Move Back links it again while it is still pinned there.
+ */
+export interface PaneMovedLink {
+  instanceId: string;
+  sourceInstanceId: string;
+  symbol: string;
+  /** The title before the pin renamed it ("OPX" for "OPX NVDA"), when it did. */
+  title?: string;
+}
+
+/** Where Move to New Layout took a pane from, so Move Back can return it. */
+export interface PaneMovedFrom {
+  /** `SavedLayout.id` of the layout it left. */
+  layoutId: string;
+  /** Set when it was docked there: its place in the tree and its share of the split. */
+  docked?: DockedPlacementMemory & { ratio?: number };
+  /** Set when it was floating there. */
+  floating?: FloatingPlacementMemory;
+  links?: PaneMovedLink[];
+}
+
 export interface PaneInstanceConfig {
   instanceId: string;
   paneId: string;
@@ -69,6 +93,8 @@ export interface PaneInstanceConfig {
   placementMemory?: PanePlacementMemory;
   /** Pinned by the user: the keyboard close shortcuts leave this pane alone. */
   locked?: boolean;
+  /** Set by Move to New Layout and cleared by Move Back; never published. */
+  movedFrom?: PaneMovedFrom;
 }
 
 interface DockPaneNode {
@@ -203,6 +229,21 @@ export interface TelemetryConfig {
   attention?: boolean;
 }
 
+/**
+ * The one-time line in the terminal's status bar asking to star Gloomberb on
+ * GitHub. Absent means on and not shown yet. Kept on this machine only.
+ */
+export interface StarPromptConfig {
+  /** `false` turns the line off; absent means on. */
+  enabled?: boolean;
+  /** Local days (`YYYY-MM-DD`) the terminal app was opened on, oldest first, until the line shows. */
+  days?: string[];
+  /** When the line showed. Once set it never shows again. */
+  shownAt?: string;
+  /** How it ended: the repository was opened, the line was dismissed, or it timed out. */
+  outcome?: "opened" | "dismissed" | "expired";
+}
+
 /**
  * One recent command-bar run: `id` is `pane-template:<templateId>`, `label`
  * its name when it ran, and `arg` a ticker it ran with (never free text).
@@ -255,6 +296,12 @@ export interface AppConfig {
   /** Key overrides for this machine. Absent means every default applies. */
   keybindings?: KeybindingsConfig;
   telemetry?: TelemetryConfig;
+  starPrompt?: StarPromptConfig;
+  /**
+   * Presentation mode: the panes fill the window, without the header or the
+   * status bar, for a screen that is shown rather than worked at. Absent is off.
+   */
+  presentationMode?: boolean;
 }
 
 export const TICKER_RESEARCH_PANE_ID = "ticker-research";
@@ -582,6 +629,17 @@ export function clonePlacementMemory(memory: PanePlacementMemory | undefined): P
   };
 }
 
+function clonePaneMovedFrom(movedFrom: PaneMovedFrom): PaneMovedFrom {
+  return {
+    layoutId: movedFrom.layoutId,
+    ...(movedFrom.docked ? {
+      docked: { ...movedFrom.docked, ...(movedFrom.docked.path ? { path: [...movedFrom.docked.path] } : {}) },
+    } : {}),
+    ...(movedFrom.floating ? { floating: { ...movedFrom.floating } } : {}),
+    ...(movedFrom.links ? { links: movedFrom.links.map((link) => ({ ...link })) } : {}),
+  };
+}
+
 function cloneUnknownValue<T>(value: T): T {
   if (Array.isArray(value)) {
     return value.map((entry) => cloneUnknownValue(entry)) as T;
@@ -816,6 +874,7 @@ export function normalizePaneLayout(
       params: instance.params ? { ...instance.params } : undefined,
       settings: clonePaneSettings(instance.settings),
       placementMemory: clonePlacementMemory(instance.placementMemory),
+      ...(instance.movedFrom ? { movedFrom: clonePaneMovedFrom(instance.movedFrom) } : {}),
     })),
     floating: nextLayout.floating
       .filter((entry) => (
@@ -838,6 +897,7 @@ export function cloneLayout(layout: LayoutConfig): LayoutConfig {
       params: instance.params ? { ...instance.params } : undefined,
       settings: clonePaneSettings(instance.settings),
       placementMemory: clonePlacementMemory(instance.placementMemory),
+      ...(instance.movedFrom ? { movedFrom: clonePaneMovedFrom(instance.movedFrom) } : {}),
     })),
     floating: layout.floating.map((entry) => ({ ...entry })),
     detached: detached.map((entry) => ({ ...entry })),

package/src/types/financials.ts

@@ -38,7 +38,21 @@ export interface QuoteMetadata {
   fieldSources?: Partial<Record<"currency" | "instrumentType", QuoteMetadataSource>>;
 }
 
-export interface Quote {
+/**
+ * What a record's share counts count: depositary receipts or the ordinary
+ * shares behind them. Gloom Cloud states it only when it established it.
+ */
+export type ShareBasis = "depositary_receipt" | "ordinary";
+
+/** How a depositary receipt relates to the ordinary shares, as Gloom Cloud states it. */
+interface DepositaryReceiptFacts {
+  /** Whether the listing is a depositary receipt; absent when unknown. */
+  isDepositaryReceipt?: boolean;
+  /** Ordinary shares per receipt, on a receipt's own records. */
+  adrRatio?: number;
+}
+
+export interface Quote extends DepositaryReceiptFacts {
   /** Applies to this price observation; a stored position cannot supply it. */
   priceBasis?: PriceBasis;
   /** Daily fund net asset value; independent of the units used to format its price. */
@@ -109,7 +123,11 @@ export interface QuoteContribution extends Quote {
 
 export type QuoteContributionMap = Record<string, QuoteContribution>;
 
-export interface Fundamentals {
+export interface Fundamentals extends DepositaryReceiptFacts {
+  /** Every share count here is on this basis, the basis of the listing's price and market cap; absent when unproven. */
+  shareBasis?: ShareBasis;
+  /** On a receipt, the ordinary shares behind `sharesOutstanding`. */
+  underlyingOrdinaryShares?: number;
   source?: "gloom";
   fetchedAt?: string;
   stale?: boolean;
@@ -180,6 +198,8 @@ export interface HolderRecord {
   percentHeld?: number;
   changeShares?: number;
   changePercent?: number;
+  /** Set when the position's filing ties it to the receipts or to the ordinary shares. */
+  shareBasis?: ShareBasis;
 }
 
 interface HolderSummary {
@@ -189,11 +209,18 @@ interface HolderSummary {
   institutionsCount?: number;
 }
 
-export interface HolderData {
+export interface HolderData extends DepositaryReceiptFacts {
   providerId?: string;
   symbol: string;
   name?: string;
+  /** The listing's price currency. */
   currency?: string;
+  /** The currency of `value`, which can differ from the listing's (USD on a London line priced from 13F filings). */
+  valueCurrency?: string;
+  /** Reported shares times the latest price, or times the price at the report date. */
+  valueBasis?: "latest_price" | "period_end_price";
+  /** Set when every row is on one basis. */
+  shareBasis?: ShareBasis;
   exchange?: string;
   asOf?: string;
   summary?: HolderSummary;
@@ -430,6 +457,8 @@ export interface ReportedEarningsCohort {
 export interface EarningsResultProvenance { version: 1; reported: ReportedEarningsCohort }
 
 export interface FinancialStatement {
+  /** The basis of this row's share counts and per-share earnings; absent when unproven. */
+  shareBasis?: ShareBasis;
   /** @deprecated No longer populated. */
   earningsResult?: EarningsResultProvenance;
   /** EPS lines unavailable for this period, for example because they disagree with the row's own income and shares. */

package/src/types/headless.ts

@@ -51,6 +51,15 @@ export interface HeadlessPaneOptionDef {
     pluginId: string;
     key?: string;
   };
+  /** The value's name in the catalog's flag, `--expiration <YYYY-MM-DD|unix>`; the type when absent. */
+  placeholder?: string;
+  /** The option in use as typed after the function, such as `--expiration 2028-01-21`; the catalog shows it as an example. */
+  example?: string;
+  /**
+   * Checks a typed value and returns it as the pane reads it, in place of the
+   * type's own check; throws an Error that names what is wrong.
+   */
+  normalize?(value: string): string | number | boolean;
 }
 
 export interface HeadlessPaneLoadArgs {
@@ -90,6 +99,8 @@ export interface HeadlessPaneColumn {
   header: string;
   align?: "left" | "right" | "center";
   width?: number;
+  /** False keeps the column whole when the text table is fitted to a narrow width, so a time or an id is never cut. */
+  shrink?: boolean;
   description?: string;
   format?: (value: unknown, row: HeadlessPaneRow) => string;
 }

package/src/types/instrument.ts

@@ -59,4 +59,12 @@ export interface InstrumentSearchResult {
   /** How often the listing is searched, higher is more (the search service score,
    * sent by newer cloud servers). Only comparable within one response. */
   popularity?: number;
+  /** Trade names the row answers to ("Aramco" for Saudi Arabian Oil Co.), sent by
+   * newer cloud servers on a row a trade-name query added. The legal name does not
+   * contain them, so search matches the query against them too. */
+  searchAliases?: string[];
+  /** A theme the row answers to without its name saying so ("lithium" on
+   * Albemarle, which the lithium funds hold), sent by newer cloud servers on a
+   * row a theme query added. Matched like the name, ranked after name matches. */
+  searchKeywords?: string[];
 }