gloomberb 0.16.0 → 0.16.2

package/src/plugins/builtin/portfolio-list/mutations.ts

@@ -1,5 +1,5 @@
 import type { AppConfig } from "../../../types/config";
-import type { Portfolio, TickerPosition, TickerRecord, Watchlist } from "../../../types/ticker";
+import type { Portfolio, PortfolioCash, TickerPosition, TickerRecord, Watchlist } from "../../../types/ticker";
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
 import { slugifyName } from "../../../utils/slugify";
 import { parseCollectionRef } from "../cloud/team/collections";
@@ -149,6 +149,60 @@ export function adoptHeldPortfolioCurrencies(config: AppConfig, tickers: Iterabl
   return next;
 }
 
+function updatePortfolio(config: AppConfig, portfolioId: string, update: (portfolio: Portfolio) => Portfolio): AppConfig {
+  if (!config.portfolios.some((portfolio) => portfolio.id === portfolioId)) throw new Error("Portfolio not found.");
+  return {
+    ...config,
+    portfolios: config.portfolios.map((portfolio) => (portfolio.id === portfolioId ? update(portfolio) : portfolio)),
+  };
+}
+
+/** Records the cash held beside a portfolio's positions, replacing any earlier entry. */
+export function setPortfolioCash(config: AppConfig, portfolioId: string, cash: PortfolioCash): AppConfig {
+  const currency = cash.currency.trim().toUpperCase();
+  if (!Number.isFinite(cash.amount)) throw new Error("Cash amount must be a valid number.");
+  if (!/^[A-Z]{3}$/.test(currency)) throw new Error(`"${cash.currency}" is not a currency code such as USD or EUR.`);
+  return updatePortfolio(config, portfolioId, (portfolio) => ({ ...portfolio, cash: { amount: cash.amount, currency } }));
+}
+
+export function clearPortfolioCash(config: AppConfig, portfolioId: string): { config: AppConfig; changed: boolean } {
+  const portfolio = config.portfolios.find((entry) => entry.id === portfolioId);
+  if (!portfolio?.cash) return { config, changed: false };
+  return {
+    config: updatePortfolio(config, portfolioId, ({ cash: _cash, ...rest }) => rest),
+    changed: true,
+  };
+}
+
+/** Sets one target weight, in percent, keyed by ticker symbol (`CASH` for the cash line). */
+export function setPortfolioTargetWeight(config: AppConfig, portfolioId: string, symbol: string, weight: number): AppConfig {
+  if (!Number.isFinite(weight) || weight < 0 || weight > 100) throw new Error("Target weight must be between 0% and 100%.");
+  if (!symbol.trim()) throw new Error("Ticker symbol is required.");
+  return updatePortfolio(config, portfolioId, (portfolio) => ({
+    ...portfolio,
+    targetWeights: { ...portfolio.targetWeights, [symbol]: weight },
+  }));
+}
+
+/** Removes one symbol's target, or every target when no symbol is given. */
+export function clearPortfolioTargetWeights(
+  config: AppConfig,
+  portfolioId: string,
+  symbol?: string,
+): { config: AppConfig; removed: string[] } {
+  const portfolio = config.portfolios.find((entry) => entry.id === portfolioId);
+  const current = portfolio?.targetWeights ?? {};
+  const removed = symbol == null ? Object.keys(current) : Object.keys(current).filter((key) => key === symbol);
+  if (removed.length === 0) return { config, removed };
+  const remaining = Object.fromEntries(Object.entries(current).filter(([key]) => !removed.includes(key)));
+  return {
+    config: updatePortfolio(config, portfolioId, ({ targetWeights: _targets, ...rest }) => (
+      Object.keys(remaining).length > 0 ? { ...rest, targetWeights: remaining } : rest
+    )),
+    removed,
+  };
+}
+
 export function createManualPortfolio(
   config: AppConfig,
   name: string,

package/src/plugins/builtin/portfolio-list/pane/data.ts

@@ -34,6 +34,9 @@ const QUOTE_SORT_COLUMN_IDS = new Set([
   "ext_hours",
   "mkt_value",
   "weight",
+  "drift",
+  "trade",
+  "trade_value",
   "day_pnl",
   "pnl",
   "pnl_pct",
@@ -153,9 +156,12 @@ export function buildTrackedCurrencies(
   financialsMap: Map<string, TickerFinancials>,
   accountState: ResolvedPortfolioAccountState | null,
   baseCurrency: string,
+  /** The currency of cash entered by hand. */
+  cashCurrency?: string,
 ): string[] {
   const currencies = new Set<string>([baseCurrency]);
   if (accountState?.account.currency) currencies.add(accountState.account.currency);
+  if (cashCurrency) currencies.add(cashCurrency);
 
   for (const ticker of tickers) {
     if (ticker.metadata.currency) {

package/src/plugins/builtin/portfolio-list/pane/index.tsx

@@ -89,6 +89,16 @@ import { useThrottledMemo } from "../use-throttled-memo";
 import { useColumnClock } from "../use-column-clock";
 import { liveMarketCapitalization } from "../live-valuation";
 import { hasUnknownOptionMultiplier } from "../position-metrics";
+import {
+  allocationTotal,
+  buildPortfolioAllocation,
+  CASH_SYMBOL,
+  hasTargetWeights,
+  resolvePortfolioCash,
+} from "../allocation";
+
+/** Columns that need the portfolio's total. */
+const ALLOCATION_COLUMN_IDS = new Set(["weight", "drift", "trade", "trade_value"]);
 
 // Rows follow every tick. Totals walk the whole collection, so the footer
 // coalesces to about four updates a second and the weight denominator to one.
@@ -163,9 +173,10 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
 
   const accountStateInput = useMemo(() => ({ brokerAccounts, config }), [brokerAccounts, config]);
   const { accountState, accountsError } = usePortfolioAccountState(currentPortfolio, accountStateInput);
+  const portfolioTargets = currentPortfolio?.targetWeights;
   const columns = useMemo(
-    () => resolveVisibleColumns(paneSettings.columnIds, isPortfolioTab),
-    [isPortfolioTab, paneSettings.columnIds],
+    () => resolveVisibleColumns(paneSettings.columnIds, isPortfolioTab, { targetWeights: hasTargetWeights(currentPortfolio) }),
+    [currentPortfolio, isPortfolioTab, paneSettings.columnIds],
   );
   const supplementalData = usePortfolioSupplementalData(tickers, columns, appActive);
   const visibleWarmupRequirements = useMemo(
@@ -178,19 +189,32 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     () => resolvePortfolioTotalsCurrency(currentPortfolio, config.baseCurrency),
     [config.baseCurrency, currentPortfolio],
   );
+  // The broker account's cash when it reports one, else the cash entered by hand.
+  const cashLine = useMemo(
+    () => isPortfolioTab ? resolvePortfolioCash(currentPortfolio, accountState?.account) : null,
+    [accountState, currentPortfolio, isPortfolioTab],
+  );
   const trackedCurrencies = useMemo(
-    () => buildTrackedCurrencies(tickers, financialsMap, accountState, totalsCurrency),
-    [accountState, financialsMap, tickers, totalsCurrency],
+    () => buildTrackedCurrencies(tickers, financialsMap, accountState, totalsCurrency, cashLine?.source === "manual" ? cashLine.currency : undefined),
+    [accountState, cashLine, financialsMap, tickers, totalsCurrency],
   );
   const exchangeRates = useFxRatesMap(trackedCurrencies);
   const conversionCurrencies = trackedCurrencies.some((currency) => currency !== totalsCurrency) ? trackedCurrencies : [];
   const fxStatus = summarizeFxRates(conversionCurrencies, exchangeRates, (currency) => getSharedMarketDataCoordinator()?.getFxEntry(currency));
   const fxStatusText = fxStatusLabel(fxStatus);
   const activeSort = resolveCollectionSortPreference(activeCollectionId, isPortfolioTab, collectionSorts);
+  const accountCurrency = accountState?.account.currency ?? "";
+  const convertAccountValue = useCallback(
+    (value: number) => convertCurrency(value, accountCurrency, totalsCurrency, exchangeRates),
+    [accountCurrency, exchangeRates, totalsCurrency],
+  );
+  const cashValue = cashLine == null ? null
+    : cashLine.source === "broker" ? convertAccountValue(cashLine.amount)
+      : convertCurrency(cashLine.amount, cashLine.currency, totalsCurrency, exchangeRates);
   // Only weights divide by the total: skip the walk when nothing shows one.
   const needsWeightTotal = isPortfolioTab
-    && (viewMode === "grid" || columns.some((column) => column.id === "weight"));
-  const portfolioTotalMarketValue = useThrottledMemo(
+    && (viewMode === "grid" || columns.some((column) => ALLOCATION_COLUMN_IDS.has(column.id)));
+  const weightHoldings = useThrottledMemo(
     () => needsWeightTotal ? calculatePortfolioSummaryTotals(
       tickers,
       financialsMap,
@@ -198,11 +222,13 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
       exchangeRates,
       isPortfolioTab,
       activeCollectionId,
-    ).totalMktValue : undefined,
+    ).allocationHoldings : undefined,
     [financialsMap],
     [activeCollectionId, exchangeRates, isPortfolioTab, needsWeightTotal, tickers, totalsCurrency],
     WEIGHT_TOTAL_THROTTLE_MS,
   );
+  // Priced holdings plus cash, as `portfolio show` totals them.
+  const portfolioTotalMarketValue = weightHoldings ? allocationTotal(weightHoldings, cashValue) ?? undefined : undefined;
 
   // The header, footer and notices move with live quotes a few times a second,
   // not on every tick.
@@ -226,6 +252,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     baseCurrency: totalsCurrency,
     exchangeRates,
     portfolioTotalMarketValue,
+    portfolioTargets,
     supplementalVersion: supplementalData.version,
     analystResearch: supplementalData.analystResearch,
     corporateActions: supplementalData.corporateActions,
@@ -234,6 +261,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     activeCollectionId,
     exchangeRates,
     isPortfolioTab,
+    portfolioTargets,
     portfolioTotalMarketValue,
     supplementalData,
     totalsCurrency,
@@ -292,11 +320,16 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
       : null,
     [accountState],
   );
-  const accountCurrency = accountState?.account.currency ?? "";
-  const convertAccountValue = useCallback(
-    (value: number) => convertCurrency(value, accountCurrency, totalsCurrency, exchangeRates),
-    [accountCurrency, exchangeRates, totalsCurrency],
-  );
+  // Cash entered by hand gets its own figures; a broker account's cash is already in the header.
+  const manualCash = useMemo(() => {
+    if (!isPortfolioTab || accountState || (cashLine == null && portfolioTargets?.[CASH_SYMBOL] == null)) return null;
+    const allocation = buildPortfolioAllocation({
+      holdings: portfolioSummaryTotals.allocationHoldings ?? [],
+      cashValue: cashValue ?? (cashLine ? Number.NaN : null),
+      targets: portfolioTargets,
+    });
+    return allocation.cash ? { ...allocation.cash, total: allocation.total } : null;
+  }, [accountState, cashLine, cashValue, isPortfolioTab, portfolioSummaryTotals, portfolioTargets]);
   const summarySegments = useMemo(() => buildPortfolioSummarySegments({
     totals: portfolioSummaryTotals,
     accountState: summaryAccountState,
@@ -304,7 +337,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     convertAccountValue,
     currency: totalsCurrency,
     baseCurrency: config.baseCurrency,
-  }), [config.baseCurrency, convertAccountValue, isPortfolioTab, portfolioSummaryTotals, summaryAccountState, totalsCurrency]);
+    manualCash,
+  }), [config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, portfolioSummaryTotals, summaryAccountState, totalsCurrency]);
   // The header row sits in the pane's one-cell side padding, like the table.
   const summaryWidth = Math.max(0, width - 2);
   const summaryLayout = useMemo(() => layoutPortfolioSummaryHeader(summarySegments, summaryWidth, {

package/src/plugins/builtin/portfolio-list/quick-add/index.tsx

@@ -9,10 +9,11 @@ import { useAppInputCapture } from "../../../../state/app/input-capture";
 import { t, tf } from "../../../../i18n";
 import { getSharedRegistry } from "../../../registry";
 import { usePluginAppActions } from "../../../runtime";
+import { isDialogOpen } from "../../../../ui/dialog-stack";
 import { colors, priceColor } from "../../../../theme/colors";
 import { formatPercentRaw } from "../../../../utils/format";
 import { formatMarketPrice } from "../../../../market-data/market/format";
-import { upsertTickerFromSearchResult } from "../../../../tickers/search";
+import { listingChoiceQuery, upsertTickerFromSearchResult } from "../../../../tickers/search";
 import type { TickerRecord } from "../../../../types/ticker";
 import { addTickerToPortfolio, addTickerToWatchlist } from "../mutations";
 import { captureAttentionAction } from "../../../../telemetry/attention-counts";
@@ -20,6 +21,7 @@ import { publicTickerKey } from "../../../../utils/exchanges";
 import {
   IDLE_VALIDATION,
   isPlausibleTickerQuery,
+  exchangeLabelFromValidation,
   normalizeQuickAddQuery,
   resolveQuickAddValidation,
   tickerNameFromValidation,
@@ -56,6 +58,10 @@ function QuickAddPreview({
     return <Text fg={colors.textMuted}>{t(validation.message)}</Text>;
   }
 
+  if (validation.status === "choose") {
+    return <Text fg={colors.textMuted}>{t("Multiple listings")}</Text>;
+  }
+
   if (validation.status === "duplicate") {
     return <Text fg={colors.textMuted}>{tf("{symbol} already in {collection}", {
       symbol: validation.symbol,
@@ -71,6 +77,7 @@ function QuickAddPreview({
     : "-";
   const changeValue = quote?.changePercent;
   const name = tickerNameFromValidation(validation);
+  const exchange = exchangeLabelFromValidation(validation);
   const showSymbol = normalizeQuickAddQuery(validation.symbol) !== validation.query;
   const symbolPrefix = showSymbol ? `${validation.symbol} ` : "";
 
@@ -81,6 +88,7 @@ function QuickAddPreview({
         {formatPercentRaw(changeValue)}
       </Text>
       {name ? <Text fg={colors.textMuted}>{`  ${name}`}</Text> : null}
+      {exchange ? <Text fg={colors.textDim}>{`  ${exchange}`}</Text> : null}
     </Box>
   );
 }
@@ -129,6 +137,21 @@ export function QuickAddTickerInput({
     setValidation(IDLE_VALIDATION);
   }, []);
 
+  // `NET:` is the command bar's venue dropdown. Choosing a row adds it here.
+  const handOffListingChoice = useCallback((query: string) => {
+    validationSeqRef.current += 1;
+    if (!isDialogOpen()) {
+      dispatch({
+        type: "SET_COMMAND_BAR",
+        open: true,
+        query,
+        launch: { kind: "add-listing", collectionId, collectionKind },
+      });
+    }
+    resetInput();
+    blurInput();
+  }, [blurInput, collectionId, collectionKind, dispatch, resetInput]);
+
   useEffect(() => {
     onFocusChange?.(inputFocused && focused);
   }, [focused, inputFocused, onFocusChange]);
@@ -159,6 +182,15 @@ export function QuickAddTickerInput({
       return;
     }
 
+    if (listingChoiceQuery(query)) {
+      setValidation(IDLE_VALIDATION);
+      const timeoutId = setTimeout(() => {
+        if (validationSeqRef.current !== seq) return;
+        handOffListingChoice(query);
+      }, QUICK_ADD_DEBOUNCE_MS);
+      return () => clearTimeout(timeoutId);
+    }
+
     if (!isPlausibleTickerQuery(query)) {
       setValidation({ status: "missing", query, message: "Use a ticker symbol" });
       return;
@@ -174,12 +206,16 @@ export function QuickAddTickerInput({
     }, QUICK_ADD_DEBOUNCE_MS);
 
     return () => clearTimeout(timeoutId);
-  }, [inputValue, validateQuery]);
+  }, [handOffListingChoice, inputValue, validateQuery]);
 
   const submitInput = useCallback(async (submittedValue?: string) => {
     const recordAttention = captureAttentionAction();
     const query = normalizeQuickAddQuery(submittedValue ?? inputValue);
     if (!query || submitting) return;
+    if (listingChoiceQuery(query)) {
+      handOffListingChoice(query);
+      return;
+    }
 
     setSubmitting(true);
     try {
@@ -189,6 +225,10 @@ export function QuickAddTickerInput({
       )
         ? validation
         : await validateQuery(query);
+      if (currentValidation.status === "choose") {
+        handOffListingChoice(`${query}:`);
+        return;
+      }
       setValidation(currentValidation);
 
       if (currentValidation.status === "duplicate") {
@@ -275,6 +315,7 @@ export function QuickAddTickerInput({
     collectionKind,
     collectionName,
     dispatch,
+    handOffListingChoice,
     inputValue,
     notify,
     onAdded,

package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts

@@ -1,7 +1,13 @@
 import { getSharedRegistry } from "../../../registry";
-import { resolveTickerSearch, type ResolvedTickerSearch } from "../../../../tickers/search";
+import {
+  AmbiguousContractError,
+  AmbiguousTickerError,
+  resolveTickerSearch,
+  type ResolvedTickerSearch,
+} from "../../../../tickers/search";
 import type { Quote } from "../../../../types/financials";
 import type { TickerRecord } from "../../../../types/ticker";
+import { canonicalExchange, parsePublicTickerKey, publicTickerKey } from "../../../../utils/exchanges";
 
 const QUICK_ADD_MAX_QUERY_LENGTH = 32;
 const QUICK_ADD_SYMBOL_RE = /^[A-Z0-9][A-Z0-9.\-\s]*$/;
@@ -21,6 +27,8 @@ export type QuickAddValidation =
   | { status: "checking"; query: string }
   | (ResolvedQuickAdd & { status: "ready" })
   | (ResolvedQuickAdd & { status: "duplicate" })
+  /** The symbol names several listings and none is the default: the add row asks which. */
+  | { status: "choose"; query: string }
   | { status: "missing"; query: string; message: string }
   | { status: "error"; query: string; message: string };
 
@@ -73,6 +81,38 @@ export function tickerNameFromValidation(
   return validation.resolved.kind === "provider" ? validation.resolved.result.name : "";
 }
 
+export function exchangeLabelFromValidation(
+  validation: Extract<QuickAddValidation, { status: "ready" | "duplicate" }>,
+): string {
+  if (validation.resolved.kind === "provider") {
+    const result = validation.resolved.result;
+    return result.exchange === "SMART" ? result.primaryExchange || result.exchange : result.exchange || "";
+  }
+  return validation.ticker?.metadata.exchange || "";
+}
+
+/**
+ * The symbol key can already store another listing. Only this listing's own
+ * record, and its cached quote, belong to this add.
+ */
+function tickerForResolved(
+  resolved: ResolvedTickerSearch,
+  tickers: Map<string, TickerRecord>,
+): TickerRecord | null {
+  if (resolved.kind === "local") return resolved.ticker;
+  const result = resolved.result;
+  const exchange = canonicalExchange(result.exchange === "SMART" ? result.primaryExchange : result.exchange);
+  const bare = parsePublicTickerKey(resolved.symbol).symbol;
+  const qualified = publicTickerKey(bare, exchange || undefined);
+  const qualifiedTicker = qualified === bare ? undefined : tickers.get(qualified);
+  if (qualifiedTicker) return qualifiedTicker;
+  const saved = tickers.get(bare) ?? tickers.get(resolved.symbol) ?? null;
+  if (!saved) return null;
+  const savedExchange = canonicalExchange(saved.metadata.exchange);
+  if (exchange && savedExchange && exchange !== savedExchange) return null;
+  return saved;
+}
+
 export async function resolveQuickAddValidation({
   query,
   collectionId,
@@ -108,8 +148,8 @@ export async function resolveQuickAddValidation({
     }
 
     const symbol = resolved.symbol;
-    const ticker = resolved.kind === "local" ? resolved.ticker : (tickers.get(symbol) ?? null);
-    const cachedQuote = financials.get(symbol)?.quote ?? null;
+    const ticker = tickerForResolved(resolved, tickers);
+    const cachedQuote = ticker ? financials.get(ticker.metadata.ticker)?.quote ?? null : null;
     let quote = cachedQuote;
     if (!quote) {
       try {
@@ -126,12 +166,15 @@ export async function resolveQuickAddValidation({
     return {
       status: tickerBelongsToCollection(ticker, collectionKind, collectionId) ? "duplicate" : "ready",
       query,
-      symbol,
+      symbol: ticker?.metadata.ticker ?? symbol,
       resolved,
       ticker,
       quote,
     };
-  } catch {
+  } catch (error) {
+    if (error instanceof AmbiguousTickerError && !(error instanceof AmbiguousContractError)) {
+      return { status: "choose", query };
+    }
     return { status: "error", query, message: "Ticker lookup failed" };
   }
 }

package/src/plugins/builtin/portfolio-list/settings.ts

@@ -53,6 +53,11 @@ const PORTFOLIO_COLUMN_DEFS: ColumnConfig[] = [
   { id: "cost_basis", label: "COST", width: 10, align: "right", format: "compact" },
   { id: "mkt_value", label: "MKT VAL", width: 10, align: "right", format: "compact" },
   { id: "weight", label: "WEIGHT", width: 8, align: "right", format: "percent" },
+  // TARGET is the analyst price target; these are the portfolio's own target weights.
+  { id: "target_weight", label: "TGT WT", width: 7, align: "right", format: "percent" },
+  { id: "drift", label: "DRIFT", width: 8, align: "right", format: "percent" },
+  { id: "trade", label: "TRADE", width: 9, align: "right", format: "number" },
+  { id: "trade_value", label: "TRADE VAL", width: 10, align: "right", format: "compact" },
   { id: "day_pnl", label: "DAY", width: 10, align: "right", format: "compact" },
   { id: "pnl", label: "P&L", width: 10, align: "right", format: "compact" },
   { id: "pnl_pct", label: "P&L%", width: 8, align: "right", format: "percent" },
@@ -69,6 +74,10 @@ const PORTFOLIO_ONLY_COLUMN_IDS = new Set([
   "cost_basis",
   "mkt_value",
   "weight",
+  "target_weight",
+  "drift",
+  "trade",
+  "trade_value",
   "day_pnl",
   "pnl",
   "pnl_pct",
@@ -142,8 +151,26 @@ function resolveCollectionOptions(entries: CollectionEntry[]): PaneSettingOption
   }));
 }
 
+/** Columns that read a portfolio's target weights. */
+const TARGET_COLUMN_IDS = new Set(["target_weight", "drift", "trade", "trade_value"]);
+/** What a portfolio with targets shows when the pane's columns name none of them. */
+const REBALANCE_COLUMN_IDS = ["weight", "target_weight", "drift", "trade"];
+
+/**
+ * A portfolio with target weights shows WEIGHT, TGT WT, DRIFT and TRADE beside
+ * its market value, unless the pane's columns already pick target columns.
+ */
+function withTargetColumns(columnIds: string[]): string[] {
+  if (columnIds.some((id) => TARGET_COLUMN_IDS.has(id))) return columnIds;
+  const missing = REBALANCE_COLUMN_IDS.filter((id) => !columnIds.includes(id));
+  const anchor = columnIds.includes("weight") ? columnIds.indexOf("weight") : columnIds.indexOf("mkt_value");
+  const at = anchor >= 0 ? anchor + 1 : columnIds.length;
+  return [...columnIds.slice(0, at), ...missing, ...columnIds.slice(at)];
+}
+
 function describeColumnOption(column: ColumnConfig): string {
   if (column.id === PRICE_SPARKLINE_COLUMN_ID) return "One-month price sparkline.";
+  if (TARGET_COLUMN_IDS.has(column.id)) return "Shown by default once the portfolio has target weights.";
   return PORTFOLIO_ONLY_COLUMN_IDS.has(column.id)
     ? "Visible only when this pane is showing a portfolio."
     : "Visible for watchlists and portfolios.";
@@ -222,8 +249,12 @@ export function resolvePortfolioPaneCollectionId(
   return resolveActiveCollectionId(currentCollectionId, visibleCollections);
 }
 
-export function resolveVisibleColumns(columnIds: string[], isPortfolioTab: boolean): ColumnConfig[] {
-  const resolved = columnIds
+export function resolveVisibleColumns(
+  columnIds: string[],
+  isPortfolioTab: boolean,
+  { targetWeights = false }: { targetWeights?: boolean } = {},
+): ColumnConfig[] {
+  const resolved = (isPortfolioTab && targetWeights ? withTargetColumns(columnIds) : columnIds)
     .map((columnId) => PORTFOLIO_COLUMNS_BY_ID.get(columnId))
     .filter((column): column is ColumnConfig => column != null)
     .filter((column) => isPortfolioTab || !PORTFOLIO_ONLY_COLUMN_IDS.has(column.id));

package/src/plugins/builtin/portfolio-list/summary/index.tsx

@@ -17,6 +17,7 @@ import {
   type BrokerSnapshotBasis,
 } from "../account-metrics";
 import { formatPortfolioAmount, type PortfolioSummaryTotals } from "./totals";
+import { formatAllocationDrift, formatAllocationWeight, type PortfolioCashLine } from "../allocation";
 import { getMostRecentQuoteUpdate } from "../../../../market-data/quotes/time";
 import { fxStatusLabel, type FxRateStatus } from "../../../../utils/fx-status";
 import { t } from "../../../../i18n";
@@ -221,6 +222,7 @@ export function buildPortfolioSummarySegments({
   convertAccountValue = (value) => value,
   currency = "USD",
   baseCurrency = "USD",
+  manualCash = null,
 }: {
   totals: PortfolioSummaryTotals;
   accountState: PortfolioSummaryAccountState | null;
@@ -231,6 +233,8 @@ export function buildPortfolioSummarySegments({
   currency?: string;
   /** The app's base currency: amounts are bare only when both are USD. */
   baseCurrency?: string;
+  /** Cash entered by hand, in the totals currency, with the total it is weighed against. */
+  manualCash?: (PortfolioCashLine & { total: number | null }) | null;
 }): PortfolioSummarySegment[] {
   const money = (value: number | undefined, signed = false) => formatPortfolioAmount(value, currency, { signed, baseCurrency });
   if (!isPortfolioTab) {
@@ -241,7 +245,7 @@ export function buildPortfolioSummarySegments({
       ])]
       : [];
   }
-  if (!totals.hasPositions && !accountState) return [];
+  if (!totals.hasPositions && !accountState && !manualCash) return [];
 
   const candidates: PortfolioSummarySegment[] = [];
   const account = accountState?.account;
@@ -257,6 +261,14 @@ export function buildPortfolioSummarySegments({
     ])
     : null;
 
+  // Holdings plus the cash, as weights divide by it; like Net Liq for a broker account.
+  if (manualCash) {
+    candidates.push(createSummarySegment("total", [
+      { text: "Total", tone: "label" },
+      { text: money(manualCash.total ?? Number.NaN), tone: "value", bold: true },
+    ]));
+  }
+
   if (netLiquidation != null) {
     candidates.push(createSummarySegment("netliq", [
       { text: "Net Liq", tone: "label" },
@@ -278,6 +290,17 @@ export function buildPortfolioSummarySegments({
 
   // A broker account always states its cash, so a missing balance reads as unknown rather than zero.
   if (account) candidates.push(accountValue("cash", "Cash", account.totalCashValue ?? Number.NaN)!);
+  if (manualCash) {
+    const drift = formatAllocationDrift(manualCash.drift);
+    candidates.push(createSummarySegment("cash", [
+      { text: "Cash", tone: "label" },
+      { text: money(manualCash.value), tone: "value", bold: true },
+      ...(manualCash.weight != null ? [{ text: `(${formatAllocationWeight(manualCash.weight)})`, tone: "muted" as const }] : []),
+      ...(manualCash.targetWeight != null && manualCash.drift != null
+        ? [{ text: drift, tone: "muted" as const, color: /[1-9]/.test(drift) ? priceColor(manualCash.drift) : undefined }]
+        : []),
+    ]));
+  }
 
   candidates.push(createSummarySegment("day", [
     { text: "Day", tone: "label" },

package/src/plugins/builtin/portfolio-list/summary/totals.ts

@@ -4,7 +4,9 @@ import { convertCurrency, formatCompactAmount } from "../../../../utils/format";
 import { getCurrencySymbol } from "../../../../market-data/market/format";
 import { getActiveQuoteDisplay } from "../../../../market-data/market/status";
 import { isQuoteStaleForCurrentSession } from "../../../../market-data/quotes/freshness";
+import { headlineQuoteDisplay } from "../column-values";
 import { isManualPortfolio } from "../mutations";
+import type { AllocationHolding } from "../allocation";
 import {
   getPortfolioPositionMetrics,
   getPortfolioQuoteDisplay,
@@ -46,6 +48,8 @@ export interface PortfolioSummaryTotals {
   livePriced?: boolean;
   /** Lots with a current quote. Broker account snapshots move by these. */
   pricedLots?: PricedPortfolioLot[];
+  /** Every ticker of a portfolio valued for weights and targets (see allocation.ts). */
+  allocationHoldings?: AllocationHolding[];
 }
 
 const CURRENCY_CODE = /^[A-Z]{3}$/;
@@ -112,6 +116,7 @@ export function calculatePortfolioSummaryTotals(
   const unavailableConversions = new Set<string>();
   let livePriced = true;
   const pricedLots: PricedPortfolioLot[] = [];
+  const allocationHoldings: AllocationHolding[] = [];
   const now = Date.now();
   const toBase = (value: number, currency: string) => {
     const converted = convertCurrency(value, currency, totalsCurrency, exchangeRates);
@@ -127,8 +132,10 @@ export function calculatePortfolioSummaryTotals(
     const quoteCurrency = quote?.currency || ticker.metadata.currency || "USD";
 
     if (!isPortfolio) {
-      if (activeQuote?.changePercent != null) {
-        watchlistChangeSum += activeQuote.changePercent;
+      // The CHG% column's value, so Avg Day is the mean of that column.
+      const changePercent = headlineQuoteDisplay(activeQuote, quote)?.changePercent;
+      if (changePercent != null) {
+        watchlistChangeSum += changePercent;
         watchlistCount++;
       }
       continue;
@@ -139,20 +146,24 @@ export function calculatePortfolioSummaryTotals(
     }, quote);
     activeQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
     const { totalPriceUnits, grossPriceUnits, totalCost } = positionMetrics;
-    if (positionMetrics.positionCount === 0) continue;
+    if (positionMetrics.positionCount === 0) {
+      // Not held, so a missing rate is no gap in the totals: it only leaves the trade in units out.
+      const unitPrice = activeQuote ? convertCurrency(activeQuote.price, quoteCurrency, totalsCurrency, exchangeRates) : null;
+      allocationHoldings.push({ symbol: ticker.metadata.ticker, held: false, marketValue: 0, units: 0, unitPrice });
+      continue;
+    }
+    const toBaseQuote = (value: number) => toBase(value, quoteCurrency);
+    const currentUnitPrice = activeQuote ? toBaseQuote(activeQuote.price) : null;
     hasPositions = true;
     hasShorts ||= positionMetrics.hasShorts;
     totalCostBasis += totalCost;
     if (!positionMetrics.hasCostBasis) unavailableCostSymbols.add(ticker.metadata.ticker);
 
-    const toBaseQuote = (value: number) => toBase(value, quoteCurrency);
-    const positionPnl = resolvePortfolioPositionPnl(positionMetrics,
-      activeQuote ? toBaseQuote(activeQuote.price) : null);
+    const positionPnl = resolvePortfolioPositionPnl(positionMetrics, currentUnitPrice);
     signedUnrealizedPnl += positionPnl.value ?? Number.NaN;
     pnlBases.add(positionPnl.basis);
     if (positionPnl.basis === "broker-snapshot" || positionPnl.basis === "mixed") brokerPnlSymbols.add(ticker.metadata.ticker);
 
-    const currentUnitPrice = activeQuote ? toBaseQuote(activeQuote.price) : null;
     const freshQuote = currentUnitPrice != null && Number.isFinite(currentUnitPrice)
       && !!quote && !isQuoteStaleForCurrentSession(quote, now);
     if (!freshQuote || quote.dataSource === "delayed" || quote.dataSource === "snapshot") livePriced = false;
@@ -172,6 +183,13 @@ export function calculatePortfolioSummaryTotals(
     }
 
     const marketValue = resolvePortfolioMarketValue(positionMetrics, currentUnitPrice);
+    allocationHoldings.push({
+      symbol: ticker.metadata.ticker,
+      held: true,
+      marketValue: marketValue?.net ?? null,
+      units: positionMetrics.totalShares,
+      unitPrice: currentUnitPrice,
+    });
     if (marketValue) {
       totalMktValue += marketValue.gross;
       netMktValue += marketValue.net;
@@ -216,5 +234,6 @@ export function calculatePortfolioSummaryTotals(
     ...(unavailableConversions.size > 0 ? { unavailableConversions: [...unavailableConversions].sort() } : {}),
     ...(isPortfolio ? { livePriced: hasPositions && livePriced } : {}),
     ...(pricedLots.length > 0 ? { pricedLots } : {}),
+    ...(isPortfolio ? { allocationHoldings } : {}),
   };
 }

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

@@ -4,7 +4,9 @@ import { powerQuery } from "./query";
 import { POWER_TABS, powerTab } from "./model";
 
 export const powerHeadless: HeadlessPaneDefinition<"bundle"> = {
-  shape: "bundle", argument: { kind: "free-text", optional: true, placeholder: "ticker", description: "Optional listed developer or utility ticker, with exchange suffix where needed." },
+  shape: "bundle",
+  freshness: { source: "Grid operator queues and utility filings", status: "not-a-feed", basis: "published records" },
+  argument: { kind: "free-text", optional: true, placeholder: "ticker", description: "Optional listed developer or utility ticker, with exchange suffix where needed." },
   options: [
     { key: "tab", type: "enum", settingKey: "tab", defaultValue: "queue", values: POWER_TABS.map(({ value }) => ({ value })), description: "Queue, history, outcomes, large loads, utility exposure, capacity or coverage." },
     ...["country", "region", "fuel", "status", "search", "sourceId", "from", "to"].map((key) => ({ key, type: "string" as const, settingKey: key, description: `Filter by ${key}.` })),