gloomberb 0.17.6 → 0.18.0

package/src/plugins/builtin/chart-composer/pane.tsx

@@ -1,6 +1,7 @@
 import { FINANCIAL_VINTAGE_NOTICE, SEC_EPS_BASIS_NOTICE } from "../../../utils/financial-statements";
 import { usePaneSharePreparation } from "../../../shares/prepare";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useTabCursorLink } from "../../../state/app/tab-cursor";
 import { Box, useUiCapabilities } from "../../../ui";
 import {
   ChoiceDialog,
@@ -30,6 +31,8 @@ import {
   type ManualChartResolution,
 } from "../../../time-series/resolution";
 import { useResolvedChartSpec } from "../../../time-series/hooks";
+import { shortCompanyName } from "../../../tickers/company-name";
+import { useSeriesListings } from "./series-listings";
 import { LIVE_CHART_TERMINAL_FRAME_MS } from "../../../time-series/live-quotes";
 import { FORWARD_VALUATION_BASIS_NOTICES } from "../../../time-series/forward-valuation";
 import { chartSeriesSourceKey } from "../../../capabilities";
@@ -56,8 +59,10 @@ import { chartComposerSemanticMetadata } from "./semantic";
 import {
   canToggleChartSeries,
   CHART_INTERACTION_VIEWPORT_SETTING_KEY,
+  CHART_PINNED_MOMENT_SETTING_KEY,
   CHART_SPEC_SETTING_KEY,
   parseChartInteractionViewport,
+  parseSharedPinnedMoment,
   parseChartSpecOr,
   projectVisibleChartSeries,
   toggleChartSeries,
@@ -67,6 +72,7 @@ import {
   futuresGenericRollFromValue,
   futuresGenericRollLabel,
   futuresGenericRollValue,
+  standardFuturesGenericRoll,
   type FuturesGenericAdjust,
 } from "../../../utils/futures-generic";
 import { chartSeriesLabel } from "./series-expression";
@@ -190,11 +196,14 @@ interface ChartComposerSurfaceProps {
   height: number;
   footerId: string;
   onCapture?: (capturing: boolean) => void;
+  /** The legend names each series' company; a ticker's own research tab already does. */
+  nameSeries?: boolean;
 }
 
 const QUICK_ADD_CAPTURE = "quick-add";
 
 const GENERIC_ROLL_OPTIONS = [
+  { value: "standard", label: "Standard" },
   { value: "oi", label: "OI switch" },
   { value: "f5", label: "5d before notice" },
   { value: "d15", label: "Day 15" },
@@ -277,6 +286,7 @@ function ChartComposerSurface({
   height,
   footerId,
   onCapture,
+  nameSeries = true,
 }: ChartComposerSurfaceProps) {
   const dialog = useDialog();
   const dispatch = useAppDispatch();
@@ -310,6 +320,19 @@ function ChartComposerSurface({
     CHART_INTERACTION_VIEWPORT_SETTING_KEY,
     null,
   );
+  // A link shared while its sender's crosshair was pinned opens on that
+  // moment: the chart pins its tab there once, then forgets it, so a restart
+  // does not pin it again. The value came from a link: anything but a
+  // plausible time is dropped without pinning. This handle only sets the
+  // pin; the chart it opens on is what shows and keeps it.
+  const [pinnedMoment, setPinnedMoment] = usePaneSettingValue<unknown>(CHART_PINNED_MOMENT_SETTING_KEY, null);
+  const momentLink = useTabCursorLink(paneId ? `${paneId}:moment` : null, { viewer: false });
+  useEffect(() => {
+    if (pinnedMoment == null || !momentLink?.pin) return;
+    const moment = parseSharedPinnedMoment(pinnedMoment);
+    if (moment !== null) momentLink.pin(moment);
+    setPinnedMoment(undefined);
+  }, [momentLink, pinnedMoment, setPinnedMoment]);
   const persistedInteractionViewport = useMemo(
     () => parseChartInteractionViewport(storedInteractionViewport),
     [storedInteractionViewport],
@@ -332,7 +355,9 @@ function ChartComposerSurface({
   // small zoom keeps the bars it already has. Read from the previous render:
   // the resolver only consults it when the viewport moves.
   const currentResolutionRef = useRef<ManualChartResolution | null>(null);
-  const resolution = useResolvedChartSpec(spec, {
+  // Bare series are read as `quote` reads them before anything is loaded for them.
+  const listings = useSeriesListings(spec);
+  const resolution = useResolvedChartSpec(listings.spec, {
     autoViewport: spec.viewport.resolution === "auto"
       ? activeRuntimeViewport?.adaptiveViewport
       : null,
@@ -391,10 +416,18 @@ function ChartComposerSurface({
   // them. Without a placeholder they vanish from the legend entirely and the
   // only way back is the series dialog.
   const legendSeries = useMemo(() => {
-    const resolved = resolution.legendSeries ?? [];
+    // Each security series names its company once, beside its label: "AAPL Price · Apple".
+    const named = new Set<string>();
+    const resolved = (resolution.legendSeries ?? []).map((entry) => {
+      const name = nameSeries ? listings.names.get(entry.id) : undefined;
+      const company = name ? shortCompanyName(name) : "";
+      if (!company || named.has(company)) return entry;
+      named.add(company);
+      return { ...entry, label: `${entry.label} · ${company}` };
+    });
     const resolvedIds = new Set(resolved.map((entry) => entry.id));
     const missing = spec.series.filter((entry) => !resolvedIds.has(entry.id));
-    if (missing.length === 0) return resolution.legendSeries;
+    if (missing.length === 0) return named.size > 0 ? resolved : resolution.legendSeries;
     const bySpecOrder = new Map(spec.series.map((entry, index) => [entry.id, index] as const));
     return [
       ...resolved,
@@ -415,7 +448,7 @@ function ChartComposerSurface({
         points: [],
       })),
     ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER));
-  }, [resolution.legendSeries, spec.series]);
+  }, [listings.names, nameSeries, resolution.legendSeries, spec.series]);
   const plottedSeries = useMemo(
     () => projectVisibleChartSeries(
       spec,
@@ -896,7 +929,9 @@ function ChartComposerSurface({
   const comparisonUnavailable = comparisonHasNoWindow && !resolution.loading
     ? "Comparison unavailable: need two shared dates and a nonzero baseline."
     : null;
-  const statusError = resolution.errors[0];
+  const loading = resolution.loading || listings.pending;
+  // A bare code several companies list asks which, as `quote` does, before anything else is said.
+  const statusError = listings.errors[0] ?? resolution.errors[0];
   // A spread or formula error names its legs and their units; the study's id adds nothing to it.
   const formulaStudy = spec.studies.find((study) => (study.kind === "spread" || study.kind === "formula")
     && statusError?.startsWith(`${study.id}: `));
@@ -904,7 +939,9 @@ function ChartComposerSurface({
   // Failed series use their authored id in errors and their display label in warnings.
   const errorSeries = spec.series.find((entry) => statusError?.startsWith(`${entry.label ?? entry.id}: `));
   const errorMessage = errorSeries ? statusError?.slice(`${errorSeries.label ?? errorSeries.id}: `.length) : undefined;
-  const errorSeriesLabel = legendSeries?.find((entry) => entry.id === errorSeries?.id)?.label;
+  // The label the resolver wrote its warnings with, before the legend named the company.
+  const errorSeriesLabel = (resolution.legendSeries?.find((entry) => entry.id === errorSeries?.id)
+    ?? legendSeries?.find((entry) => entry.id === errorSeries?.id))?.label;
   const duplicateErrorNotices = new Set([statusError, errorMessage,
     errorSeriesLabel && errorMessage ? `${errorSeriesLabel}: ${errorMessage}` : undefined]);
   // A failed shared window empties every compared leg; one comparison message explains it.
@@ -923,7 +960,8 @@ function ChartComposerSurface({
         && warning.endsWith("; only matching observation times contribute."))
     ))
   ));
-  const statusNotices = [...new Set([...(statusErrorNotice ? [statusErrorNotice] : []), ...(comparisonUnavailable ? [comparisonUnavailable] : []), ...statusWarnings])];
+  const statusNotices = [...new Set([...(statusErrorNotice ? [statusErrorNotice] : []), ...listings.errors, ...listings.notices,
+    ...(comparisonUnavailable ? [comparisonUnavailable] : []), ...statusWarnings])];
   usePaneNoticeFooter({
     registrationId: `${footerId}:notices`,
     notices: statusNotices,
@@ -964,7 +1002,7 @@ function ChartComposerSurface({
     return newest > end ? formatCompositeDatasetDate(new Date(newest), end) : null;
   }, [activeRuntimeViewport, plottedSeries, spec, viewport]);
   usePaneFooter(footerId, () => ({
-    info: resolution.loading
+    info: loading
       ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }]
       : pickingAnchor
         ? [{ id: "anchor", parts: [{ text: "pick a bar to anchor VWAP", tone: "muted" as const }] }]
@@ -978,7 +1016,7 @@ function ChartComposerSurface({
       { id: "resolution", key: "t", label: "imeframe", onPress: footerResolution },
       ...(anchorable ? [{ id: "vwap-anchor", key: "v", label: "wap anchor", title: "Anchor VWAP", onPress: footerAnchor }] : []),
     ],
-  }), [resolution.loading, pickingAnchor, newestBeyondView, footerSeries, openIndicators, indicatorsDisabled, openFormulas, formulasDisabled, footerResolution, anchorable, footerAnchor]);
+  }), [loading, pickingAnchor, newestBeyondView, footerSeries, openIndicators, indicatorsDisabled, openFormulas, formulasDisabled, footerResolution, anchorable, footerAnchor]);
 
   // A fixed window (a GIP session) highlights no range, so the bar names it.
   const dateWindowLabel = useMemo(() => {
@@ -996,9 +1034,12 @@ function ChartComposerSurface({
   const genericFilters = useMemo(() => {
     if (!generic) return [];
     const roll = futuresGenericRollValue(generic.roll);
-    const rollOptions = GENERIC_ROLL_OPTIONS.map((option) => option.value === "f5"
-      ? { ...option, label: futuresGenericNotice(generic.root) === "first notice" ? "5d before notice" : "5d before last trade" }
-      : option);
+    const notice = futuresGenericNotice(generic.root) === "first notice" ? "notice" : "last trade";
+    const standard = standardFuturesGenericRoll(generic.root);
+    const rollOptions = GENERIC_ROLL_OPTIONS.map((option) => option.value === "f5" ? { ...option, label: `5d before ${notice}` }
+      : option.value === "standard" && standard.rule === "first-notice"
+        ? { ...option, label: standard.days === 0 ? `Standard, after ${notice}` : `Standard, ${standard.days}d before ${notice}` }
+        : option);
     if (!rollOptions.some((option) => option.value === roll)) rollOptions.push({ value: roll, label: futuresGenericRollLabel(generic) });
     const update = (change: Parameters<typeof setChartFuturesGeneric>[1]) => {
       const next = setChartFuturesGeneric(specRef.current, change);
@@ -1008,7 +1049,7 @@ function ChartComposerSurface({
     return [
       { id: "roll", label: "Roll", value: roll, options: rollOptions, title: "Roll rule",
         onChange: (value: string) => {
-          const next = futuresGenericRollFromValue(value);
+          const next = futuresGenericRollFromValue(value, generic.root);
           if (next) update({ roll: next });
         } },
       { id: "adjust", label: "Adjust", value: generic.adjust, options: GENERIC_ADJUST_OPTIONS, title: "Adjustment",
@@ -1041,11 +1082,18 @@ function ChartComposerSurface({
     }]
     : [];
 
+  // A company that reports no quarterly figures says so, and where its annual ones are.
+  const unreported = resolution.legendSeries?.find((entry) => entry.unreportedPeriod && entry.points.length === 0);
   const emptyMessage = spec.series.length === 0
     ? "Add a series to start the chart"
-    : resolution.loading
+    : loading
       ? "Loading chart data"
-      : statusErrorNotice ?? comparisonUnavailable ?? "No observations in this range";
+      : statusErrorNotice ?? comparisonUnavailable
+        ?? (unreported ? `${unreported.label} has no ${unreported.unreportedPeriod} figures. Set Period to Annual in Series.` : "No observations in this range");
+  // Under "Choose an exchange for BDI.", the listings it asks between.
+  const emptyDetail = !loading && spec.series.length > 0 && emptyMessage === statusErrorNotice && statusError
+    ? listings.choices.get(statusError)
+    : undefined;
 
   return (
     <Box flexDirection="column" width={width} height={height}>
@@ -1127,6 +1175,7 @@ function ChartComposerSurface({
           timePick={timePick}
           levels={chartLevels}
           emptyMessage={emptyMessage}
+          emptyDetail={emptyDetail}
           legendAccessory={(
             <ChartSeriesQuickAdd
               spec={spec}
@@ -1258,6 +1307,7 @@ export function ChartComposerResearchTab({ focused, width, height, onCapture }:
       height={height}
       footerId="chart-composer:research"
       onCapture={onCapture}
+      nameSeries={false}
     />
   );
 }

package/src/plugins/builtin/chart-composer/presets.ts

@@ -6,7 +6,7 @@ import {
 } from "../../../time-series/types";
 import type { ChartResolution, TimeRange } from "../../../components/chart/core/types";
 import { MAX_CHART_COMPOSER_SERIES } from "./chart-spec";
-import { appendChartSeries, buildCustomSeries, buildSeriesSpec, panelsForSeries } from "./chart-spec-edit";
+import { appendChartSeries, appendPlacedSeries, buildCustomSeries, buildSeriesSpec, panelsForSeries } from "./chart-spec-edit";
 import { currencyPairSpelling } from "../../../utils/currency-pair";
 import { dashedCoinPair } from "../../../utils/crypto-pair";
 import {
@@ -21,6 +21,8 @@ import {
 import { setBuiltinStudies, setPairStudies, type PairStudySelection } from "./studies";
 import { looksLikeFormula, parseFormulaExpression, type ParsedFormula } from "./formula";
 import type { SeriesCatalogSuggestion } from "./series-catalog";
+import { getSharedRegistry } from "../../registry";
+import { seriesCatalogEntry } from "../../../series/registry";
 
 function chartSpec(
   series: ChartSeriesSpec[],
@@ -43,7 +45,8 @@ export function buildEmptyChartPreset(): ChartSpec {
 /**
  * `GAA/VOO`, `GAA / VOO`, and `CL=F - ES=F` are a ratio or a spread of two series.
  * A slash that is the symbol stays one series (`EUR/USD`, `BTC/USD`), and so does
- * a field written with a slash (`AAPL:EV/EBITDA`). A comma-separated list stays a list.
+ * a field written with a slash (`AAPL:EV/EBITDA`) and the symbol a catalog series
+ * takes after one (`CAP:short-volume:ratio/AAPL`). A comma-separated list stays a list.
  */
 function derivedPair(expression: string): { series: ParsedSeriesExpression[]; formula: PairStudySelection } | null {
   const trimmed = expression.trim();
@@ -58,6 +61,7 @@ function derivedPair(expression: string): { series: ParsedSeriesExpression[]; fo
   const tight = /^([^/\s]+)\/([^/\s]+)$/.exec(trimmed);
   if (!tight) return null;
   const [leftToken, rightToken] = [tight[1]!, tight[2]!];
+  if (/^CAP:/i.test(leftToken) && !/^CAP:/i.test(rightToken)) return null;
   const quote = rightToken.split(":")[0]!;
   if (currencyPairSpelling(`${leftToken}/${quote}`) || dashedCoinPair(`${leftToken}/${quote}`)) return null;
   const left = parseSeriesExpression(leftToken);
@@ -129,14 +133,54 @@ function appendChartFormula(spec: ChartSpec, expression: string): { spec: ChartS
   };
 }
 
-/** The chart with a catalog suggestion added: one series, or a formula's legs and its study. */
+/**
+ * The chart with a catalog suggestion added: one series, a registered
+ * series' lines where it asks for them, or a formula's legs and its study.
+ */
 export function appendCatalogSuggestion(
   spec: ChartSpec,
   suggestion: SeriesCatalogSuggestion,
 ): { spec: ChartSpec; series: ChartSeriesSpec } {
-  return suggestion.formula !== undefined
-    ? appendChartFormula(spec, suggestion.formula)
-    : appendChartSeries(spec, suggestion.expression);
+  if (suggestion.formula !== undefined) return appendChartFormula(spec, suggestion.formula);
+  if (suggestion.lines || suggestion.placement) {
+    return appendPlacedSeries(spec, suggestion.lines ?? [suggestion.expression!], {
+      name: suggestion.seriesName ?? suggestion.label,
+      ...(suggestion.placement ? { placement: suggestion.placement } : {}),
+      ...(suggestion.symbol ? { symbol: suggestion.symbol } : {}),
+    });
+  }
+  return appendChartSeries(spec, suggestion.expression);
+}
+
+/**
+ * The chart CAT opens for a registered series that asks where it is drawn or
+ * draws several lines: the ticker's price with the series placed as it asks,
+ * or the lines on their own.
+ */
+export function buildRegisteredSeriesChart(
+  series: { name: string; template: string; placement?: SeriesCatalogSuggestion["placement"]; lines?: ReadonlyArray<{ name: string; expression: string; style?: ChartSeriesSpec["style"] }> },
+  symbol?: string,
+): ChartSpec {
+  const fill = (template: string) => symbol
+    ? template.replaceAll("{ticker}", template.startsWith("CAP:") ? encodeURIComponent(symbol) : symbol)
+    : template;
+  const prefix = symbol ? `${symbol} · ` : "";
+  const lines = series.lines?.length
+    ? series.lines.map((line) => {
+      const parsed = parseSeriesExpression(fill(line.expression));
+      if (!parsed) throw new Error(`"${line.expression}" is not a chart series.`);
+      return { ...parsed, label: `${prefix}${series.name} · ${line.name}`, ...(line.style ? { style: line.style } : {}) };
+    })
+    : [(() => {
+      const parsed = parseSeriesExpression(fill(series.template));
+      if (!parsed) throw new Error(`"${series.template}" is not a chart series.`);
+      return { ...parsed, label: `${prefix}${series.name}` };
+    })()];
+  const base = series.placement && symbol ? buildPriceChartPreset(symbol) : buildEmptyChartPreset();
+  return appendPlacedSeries(base, lines, {
+    name: series.name,
+    ...(series.placement && symbol ? { placement: series.placement, symbol } : {}),
+  }).spec;
 }
 
 /**
@@ -157,9 +201,27 @@ export function buildCustomChartPreset(expression: string, fallbackSymbol?: stri
     return formulaChartPreset(formula);
   }
   if (parsed.length === 0) return fallbackSymbol ? buildPriceChartPreset(fallbackSymbol) : buildEmptyChartPreset();
+  const registered = parsed.length === 1 ? placedRegisteredSeries(parsed[0]!) : null;
+  if (registered) return buildRegisteredSeriesChart(registered.series, registered.ticker);
   return chartSpec(buildCustomSeries(parsed));
 }
 
+/**
+ * A registered series typed alone (`CAP:studies:rsi/AAPL`) that says where it is
+ * drawn or draws several lines charts as CAT opens it. Naming one line
+ * (`rsi~signal/AAPL`) charts that line alone.
+ */
+function placedRegisteredSeries(expression: ParsedSeriesExpression) {
+  if (expression.kind !== "capability" || expression.seriesId.split("/")[0]!.includes("~")) return null;
+  const found = getSharedRegistry()?.series?.findLoaded(expression.capabilityId, expression.seriesId);
+  if (!found || (!found.series.definition.placement && !found.series.definition.lines?.length)) return null;
+  const entry = seriesCatalogEntry(found.series);
+  return {
+    series: { name: entry.name, template: entry.expression, placement: entry.placement, lines: entry.lines },
+    ...(found.ticker ? { ticker: found.ticker } : {}),
+  };
+}
+
 export function buildPriceChartPreset(symbol: string): ChartSpec {
   const normalized = normalizeInstrument(symbol, true);
   if (!normalized) return buildEmptyChartPreset();
@@ -209,9 +271,15 @@ export function buildValuationChartPreset(
 ): ChartSpec {
   const resolvedField = resolveChartFieldAlias(fieldId);
   const normalized = symbols.map((symbol) => normalizeInstrument(symbol, true)).filter((entry): entry is NonNullable<typeof entry> => entry !== null).slice(0, MAX_CHART_COMPOSER_SERIES);
-  return chartSpec(normalized.map((instrument, index) => buildSeriesSpec(
-    { kind: "security", ...instrument, fieldId: resolvedField },
-    index,
-    { style: normalized.length === 1 ? "line" : "columns", axis: "left" },
-  )));
+  return chartSpec(normalized.map((instrument, index) => {
+    const series = buildSeriesSpec(
+      { kind: "security", ...instrument, fieldId: resolvedField },
+      index,
+      { style: normalized.length === 1 ? "line" : "columns", axis: "left" },
+    );
+    // Fiscal years: most US filers report no Q4 EPS, which charts do not
+    // reconstruct, so a quarterly trailing multiple has only its latest few
+    // quarters. Quarterly is the series' Period control away.
+    return series.source.kind === "security" ? { ...series, source: { ...series.source, period: "annual" } } : series;
+  }));
 }

package/src/plugins/builtin/chart-composer/series-catalog.ts

@@ -7,7 +7,7 @@ import {
   type ChartSeriesCatalogItem,
 } from "../../../capabilities";
 import type { TimeSeriesFieldDefinition } from "../../../time-series/types";
-import type { SeriesCatalogEntry } from "../../../series/types";
+import type { SeriesCatalogEntry, SeriesPlacement } from "../../../series/types";
 import {
   canonicalExchange,
   parsePublicTickerKey,
@@ -31,13 +31,20 @@ interface SeriesCatalogSuggestionText {
 }
 
 /**
- * One series to add, or a catalog formula (`42*HO=F - CL=F`): its legs join
- * the chart with the study that weighs them.
+ * One series to add, the lines of a registered series that draws several, or
+ * a catalog formula (`42*HO=F - CL=F`): its legs join the chart with the study
+ * that weighs them.
  */
 export type SeriesCatalogSuggestion = SeriesCatalogSuggestionText & (
-  | { expression: ParsedSeriesExpression; formula?: never }
-  | { formula: string; expression?: never }
-);
+  | { expression: ParsedSeriesExpression; formula?: never; lines?: never }
+  | { lines: ParsedSeriesExpression[]; expression?: never; formula?: never }
+  | { formula: string; expression?: never; lines?: never }
+) & {
+  /** A registered series' own name, and where it asks to be drawn for the ticker it was filled in for. */
+  seriesName?: string;
+  placement?: SeriesPlacement;
+  symbol?: string;
+};
 
 export interface SeriesSearchAnalysis {
   directInstrument: SeriesCatalogInstrument | null;
@@ -306,31 +313,44 @@ function registeredSeriesSuggestions(
   if (!query.trim() || registered.length === 0) return [];
   const instrument = analysis.directInstrument ?? defaultInstrument;
   const tickerQuery = analysis.directInstrument ? analysis.metricQuery : query;
-  const hits: Array<{ entry: SeriesCatalogEntry; rank: number } & (
-    | { expression: ParsedSeriesExpression; formula?: never }
-    | { formula: string; expression?: never }
+  const hits: Array<{ entry: SeriesCatalogEntry; rank: number; symbol?: string } & (
+    | { expression: ParsedSeriesExpression; formula?: never; lines?: never }
+    | { lines: ParsedSeriesExpression[]; expression?: never; formula?: never }
+    | { formula: string; expression?: never; lines?: never }
   )> = [];
   for (const entry of registered) {
     let template = entry.expression;
     let text = query;
+    let symbol: string | undefined;
+    const fill = (value: string) => symbol
+      ? value.replaceAll("{ticker}", value.startsWith("CAP:") ? encodeURIComponent(symbol) : symbol)
+      : value;
     if (entry.input) {
       // Ticker fields are ranked against the security below; options and pairs need their own symbol.
       if (entry.input !== "ticker" || /^\{ticker\}:[A-Za-z]/.test(template) || !tickerQuery.trim()) continue;
-      const symbol = publicTickerKey(instrument.symbol, instrument.exchange);
-      template = template.replaceAll("{ticker}", template.startsWith("CAP:") ? encodeURIComponent(symbol) : symbol);
+      symbol = publicTickerKey(instrument.symbol, instrument.exchange);
+      template = fill(template);
       text = tickerQuery;
     }
     if (!matchesAliasQuery(text, entry.name, entry.expression, entry.id, entry.group ?? "", ...(entry.tags ?? []))) continue;
+    const prefix = symbol ? `${symbol} · ` : "";
+    if (entry.lines?.length) {
+      const lines = entry.lines.flatMap((line) => {
+        const parsed = parseSeriesExpression(fill(line.expression));
+        return parsed ? [{ ...parsed, label: `${prefix}${entry.name} · ${line.name}`, ...(line.style ? { style: line.style } : {}) }] : [];
+      });
+      if (lines.length === entry.lines.length) hits.push({ entry, rank: registeredMatchRank(entry, text), lines, ...(symbol ? { symbol } : {}) });
+      continue;
+    }
     const parsed = parseSeriesExpression(template);
     if (!parsed) {
       if (!entry.input && catalogFormula(template)) hits.push({ entry, rank: registeredMatchRank(entry, text), formula: template });
       continue;
     }
-    const label = entry.input ? `${publicTickerKey(instrument.symbol, instrument.exchange)} · ${entry.name}` : entry.name;
-    hits.push({ entry, rank: registeredMatchRank(entry, text), expression: { ...parsed, label } });
+    hits.push({ entry, rank: registeredMatchRank(entry, text), expression: { ...parsed, label: `${prefix}${entry.name}` }, ...(symbol ? { symbol } : {}) });
   }
   hits.sort((left, right) => left.rank - right.rank || left.entry.name.length - right.entry.name.length);
-  return hits.map(({ entry, expression, formula }): SeriesCatalogSuggestion => {
+  return hits.map(({ entry, expression, lines, formula, symbol }): SeriesCatalogSuggestion => {
     const description = [entry.group, entry.unit, entry.frequency].filter(Boolean).join(" · ");
     const detail = entry.group ?? "Series";
     if (formula !== undefined) {
@@ -338,12 +358,28 @@ function registeredSeriesSuggestions(
       const formulaDescription = [formula, entry.unit, entry.frequency].filter(Boolean).join(" · ");
       return { id: `formula:${formula}`, label: entry.name, description: formulaDescription, detail, formula };
     }
+    const placed = {
+      seriesName: entry.name,
+      ...(entry.placement ? { placement: entry.placement } : {}),
+      ...(symbol ? { symbol } : {}),
+    };
+    if (lines) {
+      return {
+        id: `lines:${suggestionId(lines[0]!)}`,
+        label: `${symbol ? `${symbol} · ` : ""}${entry.name}`,
+        description: [entry.lines!.map((line) => line.name).join(", "), entry.group].filter(Boolean).join(" · "),
+        detail,
+        lines,
+        ...placed,
+      };
+    }
     return {
       id: suggestionId(expression),
       label: expression.kind === "capability" ? expression.label ?? entry.name : `${entry.expression} · ${entry.name}`,
       description,
       detail,
       expression,
+      ...placed,
     };
   });
 }

package/src/plugins/builtin/chart-composer/series-expression.ts

@@ -162,10 +162,14 @@ export function parseSeriesExpression(value: string): ParsedSeriesExpression | n
   return { kind: "security", ...instrument, fieldId };
 }
 
+const SERIES_FORMS = "Use SYMBOL, SYMBOL:field, FUT:code, UST:maturity, FRED:series, GEO:series, or CAP:capability-id:series-id.";
+
 export function parseChartExpression(value: string): ParsedSeriesExpression[] {
   if (!value.trim()) return [];
-
-  const legs = value.split(/[;,\n]/);
+  // A list pasted with a stray separator (`BRK.B,SPY,`, `,SPY`, `A,,B`) has no series between them.
+  const legs = value.split(/[;,\n]/).filter((leg) => leg.trim());
+  // Separators alone name no series at all.
+  if (legs.length === 0) throw new Error(`Invalid chart series "${value.trim()}": no series between its separators. ${SERIES_FORMS}`);
   if (legs.length > MAX_CHART_COMPOSER_SERIES) {
     throw new Error(`Charts support up to ${MAX_CHART_COMPOSER_SERIES} base series.`);
   }
@@ -173,10 +177,7 @@ export function parseChartExpression(value: string): ParsedSeriesExpression[] {
   return legs.map((leg) => {
     const parsed = parseSeriesExpression(leg);
     if (parsed) return parsed;
-    const display = leg.trim() || "empty series";
-    throw new Error(
-      `Invalid chart series "${display}". Use SYMBOL, SYMBOL:field, FUT:code, UST:maturity, FRED:series, GEO:series, or CAP:capability-id:series-id.`,
-    );
+    throw new Error(`Invalid chart series "${leg.trim()}". ${SERIES_FORMS}`);
   });
 }
 
@@ -194,7 +195,8 @@ export function formatSeriesExpression(series: ChartSeriesSpec): string {
 export function registeredSeriesName(source: { capabilityId: string; seriesId: string }): string | null {
   const found = getSharedRegistry()?.series?.findLoaded(source.capabilityId, source.seriesId);
   if (!found) return null;
-  return found.ticker ? `${found.ticker} ${found.series.definition.name}` : found.series.definition.name;
+  const name = found.line ? `${found.series.definition.name} · ${found.line.name}` : found.series.definition.name;
+  return found.ticker ? `${found.ticker} ${name}` : name;
 }
 
 export function chartSeriesLabel(series: ChartSeriesSpec): string {