gloomberb 0.16.4 → 0.16.5

package/src/cli/not-a-ticker.ts

@@ -1,16 +1,23 @@
 import { notATickerSymbol } from "../sources/provider-errors";
+import { splitSymbolArgs } from "./symbol-args";
 
 // "Not a ticker: APPLE." as the router words it; the symbol ends at the sentence's own period.
 const NOT_A_TICKER_SENTENCE = /Not a ticker: ((?:(?!\.\s)[^\n`\x1b])+?)\.(?=\s|\x1b|$)(?! Try `gloomberb search)/g;
 
-/** The symbol as the user typed it on the command line (`Apple`), not as the router saw it (`APPLE`). */
+/**
+ * The symbol as the user typed it on the command line (`Apple`), not as the router saw it (`APPLE`).
+ * A symbol list splits as the commands split it; a command that takes one name (`Apple Inc`) is
+ * matched as the whole argument first, so the hint searches for the name.
+ */
 function typedSymbol(symbol: string, args: readonly string[]): string {
   const wanted = symbol.toUpperCase();
   for (const arg of args) {
-    for (const part of arg.split(",")) {
-      const typed = part.trim().replace(/^\$/, "");
-      if (typed.toUpperCase() === wanted) return typed;
-    }
+    const whole = arg.trim().replace(/^\$/, "");
+    if (/\s/.test(whole) && whole.toUpperCase() === wanted) return whole;
+  }
+  for (const part of splitSymbolArgs(args)) {
+    const typed = part.replace(/^\$/, "");
+    if (typed.toUpperCase() === wanted) return typed;
   }
   return symbol;
 }

package/src/cli/pane-functions/access-gate.ts

@@ -9,6 +9,11 @@ export type PaneAccessGate = "pro" | "sign-in";
 const SIGN_IN_ERROR = /\bsign(?:ed)?[ -]?in\b|\bsignup\b|\bemail verification\b|\bverify your email\b/i;
 const PRO_ERROR = /\bGloom (?:Cloud )?Pro\b|\b(?:requires?|needs?) Pro\b|\bPro access\b/;
 
+/** A message that says what Gloom Pro would unlock, not what failed: reports print it under "Pro", apart from the errors. */
+export function isProLock(message: string): boolean {
+  return PRO_ERROR.test(message) && !SIGN_IN_ERROR.test(message);
+}
+
 function errorMessages(errors: unknown): string[] {
   return Array.isArray(errors) ? errors.filter((error): error is string => typeof error === "string") : [];
 }

package/src/cli/pane-functions/capabilities.ts

@@ -179,7 +179,8 @@ function normalizeOptionValue(option: PaneFunctionOptionDef, rawValue: string |
 export function normalizeCapabilityOptions(
   capability: PaneFunctionCapability,
   options: Record<string, string | true>,
-  settings: { strict?: boolean } = {},
+  /** `code` is what the user types for the function (`CDX`), which an error names; the capability id stands in when there is none. */
+  settings: { strict?: boolean; code?: string } = {},
 ): NormalizedPaneFunctionOptions {
   if (!capability.botSafe) {
     // A rendered view takes any pane setting; the options it declares are checked.
@@ -202,7 +203,7 @@ export function normalizeCapabilityOptions(
       }
       const supported = capability.options.map(({ key }) => `--${key}`).join(", ");
       throw new Error(
-        `${capability.id} does not support --${rawKey}.${supported ? ` Supported options: ${supported}.` : " It has no options."}`,
+        `${settings.code ?? capability.id} does not support --${rawKey}.${supported ? ` Supported options: ${supported}.` : " It has no options."}`,
       );
     }
     normalized[option.key] = normalizeOptionValue(option, rawValue);

package/src/cli/pane-functions/catalog.ts

@@ -24,6 +24,7 @@ import {
   wrapText,
   type CliStatEntry,
 } from "../../utils/cli-output";
+import { renderGlossaryEntries, type GlossaryLookup } from "../glossary";
 
 export interface PaneFunctionCatalog {
   panes: ReadonlyMap<string, PaneDef>;
@@ -381,21 +382,50 @@ function renderCatalogEntry(entry: PaneCatalogEntry): string {
   return lines.join("\n");
 }
 
-export function renderPaneCatalogReport(entries: PaneCatalogEntry[], args: ParsedPaneCatalogArgs): string {
+/**
+ * The glossary part of a search: the meaning of a term the query names, or
+ * the terms that hold its words, to look up next.
+ */
+function renderCatalogGlossary(glossary: GlossaryLookup, width: number): string {
+  const defined = glossary.exact.length > 0 ? [renderSection("Glossary"), ...renderGlossaryEntries(glossary.exact)] : [];
+  const others = glossary.partial.map((entry) => entry.term).join(", ");
+  const related = others
+    ? wrapText(`${defined.length > 0 ? "Related" : "Glossary"}: ${others}. gloomberb catalog glossary <term> explains one.`, width)
+      .map((line) => cliStyles.muted(line))
+    : [];
+  return [...defined, ...related].join("\n");
+}
+
+/**
+ * `catalog [query]`: one function in full, or the matches, with the glossary
+ * terms the query names. `gap` is the line for data no source carries yet
+ * (`knownGapMessage`): it leads, and stands in for "No functions match".
+ */
+export function renderPaneCatalogReport(
+  entries: PaneCatalogEntry[],
+  args: ParsedPaneCatalogArgs,
+  glossary: GlossaryLookup = { exact: [], partial: [] },
+  gap: string | null = null,
+): string {
   const query = args.query.trim().toLowerCase();
   const exact = query
     ? entries.find((entry) => entry.token.toLowerCase() === query)
       ?? entries.find((entry) => entry.aliases.some((alias) => alias.toLowerCase() === query))
     : undefined;
   if (exact) return renderCatalogEntry(exact);
-  if (args.query && entries.length === 1) return renderCatalogEntry(entries[0]!);
 
   const width = Math.min(cliTerminalWidth() ?? CATALOG_TEXT_WIDTH, CATALOG_TEXT_WIDTH);
+  const terms = renderCatalogGlossary(glossary, width);
+  const withGap = (text: string) => [gap ? wrapText(gap, width).join("\n") : "", text].filter(Boolean).join("\n\n");
+  const withTerms = (text: string) => withGap(terms ? `${text}\n\n${terms}` : text);
+  if (args.query && entries.length === 1) return withTerms(renderCatalogEntry(entries[0]!));
+
   const note = (text: string) => wrapText(text, width).map((line) => cliStyles.muted(line)).join("\n");
   if (entries.length === 0) {
-    return note(args.query
+    if (glossary.exact.length > 0 || gap) return withGap(terms);
+    return withTerms(note(args.query
       ? `No functions match "${args.query}". Run gloomberb catalog to browse them all.`
-      : "No functions are available.");
+      : "No functions are available."));
   }
 
   const shown = entries.slice(0, args.limit);
@@ -424,5 +454,5 @@ export function renderPaneCatalogReport(entries: PaneCatalogEntry[], args: Parse
       ? `gloomberb catalog <function> shows its options and examples. Add --all to list all ${entries.length}.`
       : "gloomberb catalog <function> shows its options and examples."),
   ];
-  return lines.join("\n");
+  return withTerms(lines.join("\n"));
 }

package/src/cli/pane-functions/data.ts

@@ -86,20 +86,23 @@ export async function withShotPriceHistory(
 }
 
 /**
- * SEAS reads monthly closes. Captured history answers every request, so the
- * weekly seed would stand in for them and price each month at a week's close.
- * The pane's own load fetches them, tagged so no other cadence is answered.
+ * SEAS reads monthly closes, and its Weekdays tab daily ones. Captured history
+ * answers every request, so the weekly seed would stand in for them and price
+ * each month at a week's close. The pane's own load fetches the shot tab's
+ * cadence, tagged so no other cadence is answered.
  */
 export async function withShotSeasonalityHistory(
   context: MarketContext,
   instrument: InstrumentRef,
+  resolved: ResolvedPaneFunction,
   financials: TickerFinancials,
 ): Promise<TickerFinancials> {
-  const monthly = await loadSeasonalityHistory({ instrument, forceRefresh: context.refresh }, context.dataProvider);
-  if (monthly.error || monthly.stale) {
-    throw new Error(`${instrument.symbol}: ${monthly.error ?? "monthly price history is stale"}`);
+  const cadence = resolved.options.tab === "weekdays" ? "daily" : "monthly";
+  const history = await loadSeasonalityHistory({ instrument, cadence, forceRefresh: context.refresh }, context.dataProvider);
+  if (history.error || history.stale) {
+    throw new Error(`${instrument.symbol}: ${history.error ?? `${cadence} price history is stale`}`);
   }
-  return { ...financials, priceHistory: monthly.history, priceHistoryResolution: SEASONALITY_HISTORY_RESOLUTION };
+  return { ...financials, priceHistory: history.history, priceHistoryResolution: SEASONALITY_HISTORY_RESOLUTION[cadence] };
 }
 
 /** Correlation and relationship panes read daily returns at every range. */
@@ -178,7 +181,8 @@ export async function createFallbackTicker(symbol: string, financials: TickerFin
     : await context.dataProvider.getQuoteMetadata?.(instrument.symbol, "").catch(() => null) ?? known;
   return {
     metadata: {
-      ticker: instrument.symbol,
+      // A listing key stays the key the pane is bound to (CAR:ASX), as a saved listing abroad is keyed.
+      ticker: instrument.exchange ? symbol : instrument.symbol,
       exchange: instrument.exchange ?? listing?.listingExchangeName ?? "",
       currency: listing?.currency ?? "",
       name: quote?.name ?? instrument.symbol,

package/src/cli/pane-functions/discovery.ts

@@ -90,6 +90,7 @@ function buildDiscoveryContext({
     registerShortcut: () => {},
     registerTickerAction: () => {},
     registerContextMenuProvider: () => {},
+    registerSeries: () => () => {},
     registerSyncContributor: () => () => {},
     registerSyncTransport: () => () => {},
     watchNewsQuery: () => () => {},

package/src/cli/pane-functions/dom.ts

@@ -14,6 +14,8 @@ const DOM_REPORT_WIDTH = 1280;
 const DOM_REPORT_HEIGHT = 720;
 const DOM_LIMITATION =
   "Only values visible in the rendered pane are returned; clipped or off-screen data may be omitted.";
+const DOM_EVERY_ROW =
+  "Every row of the pane's table is returned, including rows scrolled out of view.";
 
 function rowsContainEllipsis(rows: DesktopPaneShotRenderedRow[]): boolean {
   return rows.some((row) => row.cells.some((cell) => /\u2026|\.\.\./.test(cell.text)));
@@ -190,6 +192,8 @@ export function buildDomPaneReportFromRender(
   });
 
   const complete = failureReason === null && !truncated;
+  // Each table published its rows and nothing else was cut: the report is the whole view.
+  const everyRow = complete && result.render.reportRows !== undefined;
   return {
     data: {
       kind: "rendered-view",
@@ -205,7 +209,8 @@ export function buildDomPaneReportFromRender(
       visibleText: result.render.visibleText,
       truncated,
       truncationReasons,
-      limitation: DOM_LIMITATION,
+      ...(everyRow ? { everyRow } : {}),
+      limitation: everyRow ? DOM_EVERY_ROW : DOM_LIMITATION,
       ...(failureReason ? { reason: failureReason } : {}),
       ...(notices.length > 0 ? { metadata: { ...rendered.facts, notices } } : {}),
       freshness,
@@ -224,21 +229,30 @@ export function buildDomPaneReportFromRender(
 export function appendDomReportFooter(
   text: string,
   elapsedMs: number,
-  truncated: boolean,
+  view: DomReportView,
   freshness: ReportFreshness,
 ): string {
   return [
     text,
     "",
-    domReportNote(elapsedMs, truncated),
+    domReportNote(elapsedMs, view),
     cliStyles.muted(formatFreshnessLine(freshness)),
   ].join("\n");
 }
 
+/** How much of the pane a rendered-view report holds: cut, every row its tables publish, or what the viewport shows. */
+export type DomReportView = "clipped" | "every-row" | "visible";
+
+export function domReportView(data: Readonly<Record<string, unknown>>): DomReportView {
+  return data.truncated === true ? "clipped" : data.everyRow === true ? "every-row" : "visible";
+}
+
 /** What a rendered-view report says about where its values come from. */
-export function domReportNote(elapsedMs: number, truncated: boolean): string {
-  const clipping = truncated ? "The rendered view is clipped." : "The rendered view may be clipped.";
-  return `Rendered view: values come from the visible pane. ${clipping} Render time: ${elapsedMs} ms.`;
+export function domReportNote(elapsedMs: number, view: DomReportView): string {
+  const source = view === "every-row"
+    ? "Rendered view: every row of the pane's table, including rows scrolled out of view."
+    : `Rendered view: values come from the visible pane. ${view === "clipped" ? "The rendered view is clipped." : "The rendered view may be clipped."}`;
+  return `${source} Render time: ${elapsedMs} ms.`;
 }
 
 function failedDomReport(