gloomberb 0.17.3 → 0.17.5

package/src/cli/glossary.ts

@@ -2,7 +2,7 @@ import { cliStyles, cliTerminalWidth, renderDefinitions, renderSection, wrapText
 
 /**
  * Plain-words meanings of the rates, auction, energy, perpetual-futures, portfolio,
- * fund, short interest, quote-board, futures and economic-calendar terms the functions
+ * fund, short interest, quote-board, futures (basis, contango, roll yield) and economic-calendar terms the functions
  * show in their rows, headers and footers.
  * `catalog glossary` lists them, `catalog explain <term>` prints one, and
  * `fn <function> --explain` and `portfolio show --explain` follow a report with
@@ -301,10 +301,11 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
       + "The funding rate keeps its price close to the asset it tracks.",
   },
   {
-    term: "Funding rate", aliases: ["funding", "funding payment", "funding fee", "funding 8h"], functions: ["PERP"],
-    shown: ["Funding %/int", "Funding 8h", "Paid %/int"],
+    term: "Funding rate", aliases: ["funding", "funding payment", "funding fee", "funding 8h", "funding apr", "apr"], functions: ["PERP"],
+    shown: ["Funding %/int", "Funding 8h", "Paid %/int", "APR %"],
     definition: "A regular payment between the two sides of a perpetual contract, set to pull its price toward the asset's. "
-      + "Positive means longs pay shorts, negative means shorts pay longs.",
+      + "Positive means longs pay shorts, negative means shorts pay longs, so a basis trade (long spot, short the perpetual) collects it when positive. "
+      + "APR % is the current 8h rate × 3 × 365: a simple annualisation of the rate now, not funding actually paid.",
   },
   {
     term: "Open interest", short: "OI", aliases: ["open interest usd"], functions: ["PERP"],
@@ -473,6 +474,35 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
     definition: "A futures contract's official price for the day, set by its exchange from trading near the close. "
       + "The day's change and margin are measured from it, and it can differ from the last trade. FUT's PREV is the previous one.",
   },
+  // Futures basis and curve shape (CTM, FUT, PERP).
+  {
+    term: "Futures basis", aliases: ["basis", "basis trade", "cash and carry", "cash-and-carry", "vs spot", "spot spread"],
+    functions: ["CTM", "FUT", "PERP"], shown: ["Vs Spot", "VS SPOT"],
+    definition: "The gap between a futures price and the spot price of what it tracks, in percent: positive when the future costs more, negative when it costs less. "
+      + "It closes by expiry. A basis trade buys spot and sells the future to earn it. A perpetual has no expiry, so its funding rate plays that part.",
+  },
+  {
+    term: "Annualised basis", aliases: ["annualized basis", "ann basis", "ann. basis", "basis annualised"], functions: ["CTM", "PERP"], shown: ["Ann Basis", "ANN BASIS"],
+    definition: "The basis restated as a yearly rate, so contracts of different length compare with each other and with a perpetual's funding APR: "
+      + "(Last / spot - 1) × 365 / days to expiry, simple rather than compounded, on the latest trade against the spot quote. "
+      + "Inside 30 days a few basis points of spot noise move it by whole points: 10 bp is about ±2 points at 18 days to expiry.",
+  },
+  {
+    term: "Contango", aliases: ["contango curve", "upward curve"], functions: ["CTM", "FUT"], shown: ["contango", "Contango"],
+    definition: "A futures curve that slopes up: each contract costs more than the one before it, and the future trades above spot. "
+      + "A long rolling into the next contract pays that difference, a short earns it, and the basis closes as expiry nears.",
+  },
+  {
+    term: "Backwardation", aliases: ["backwardation curve", "downward curve", "inverted futures curve"], functions: ["CTM", "FUT"], shown: ["backwardation", "Backwardation"],
+    definition: "A futures curve that slopes down: later contracts cost less than nearer ones, and the future trades below spot, often when the asset is scarce now. "
+      + "A long rolling into the next contract earns that difference, a short pays it.",
+  },
+  {
+    term: "Roll yield", aliases: ["roll", "roll return", "annualised roll yield", "annualized roll yield", "ann roll yield", "ann. roll yield"], functions: ["CTM", "FUT"],
+    shown: ["Ann. roll yield", "Annualized Roll Yield"],
+    definition: "What a long future earns or loses as it is rolled into the next contract. CTM's annualised roll yield is the front price over the next contract's "
+      + "less 1, scaled to a year: (front / next - 1) × 365 / days between the two. It is positive in backwardation and negative in contango.",
+  },
   // The economic calendar (ECO).
   {
     term: "Actual", aliases: ["actual release", "actual value"], functions: ["ECO"], shown: ["ACTUAL", "Actual"],

package/src/cli/index.ts

@@ -251,6 +251,12 @@ function createCoreCliCommands(
       help: {
         group: CLI_COMMAND_GROUPS.plugins,
         usage: ["update [name]"],
+        sections: [{
+          title: "Updating Gloomberb itself",
+          lines: [
+            "The app updates itself from stable releases. config set updates.channel nightly adds the nightly build of main; see gloomberb help config.",
+          ],
+        }],
         examples: ["update", "update gloom-tv"],
       },
       execute: async (args) => {

package/src/cli/pane-functions/function-help.ts

@@ -749,14 +749,14 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: [],
   },
   FUT: {
-    summary: "Each root's most active futures contract across equity index, rates, energy, metals, agriculture, livestock and FX with last price, unit and session change, grouped by sector.",
+    summary: "Each root's most active futures contract across equity index, equity sectors, rates, energy, metals, agriculture, livestock and FX with last price, unit and session change, grouped by sector.",
     usage: ["FUT"],
     keys: [SEARCH, OPEN],
     data: same(DELAYED),
     bloomberg: ["GLCO"],
   },
   CTM: {
-    summary: "A futures root's listed contracts as a curve against a week and a month ago, with roll yield, contango or backwardation, and each contract's price, open interest and volume. Takes a FUT root, VX or a CME crypto root (BTC, ETH, SOL, XRP), which also shows each contract's premium to spot and annualised basis against the USD pair quote.",
+    summary: "A futures root's listed contracts as a curve against a week and a month ago, with roll yield, contango or backwardation, and each contract's price, open interest and volume. Takes a FUT root, VX or a CME crypto root (BTC, ETH, SOL, XRP), which also shows each contract's premium to spot and annualised basis against the USD pair quote: Ann Basis = (Last / spot - 1) × 365 / days to expiry, simple actual/365.",
     usage: ["CTM GC", "CTM BTC"],
     keys: [key("d", "ate"), key("c", "urrent"), STEP],
     data: same("Delayed, usually 10 minutes; VIX at settlement"),

package/src/cli/pane-functions/market-session.ts

@@ -48,7 +48,8 @@ const US_EXCHANGE_TIME_ZONE = "America/New_York";
 /**
  * A venue's session now, from its calendar (weekends and published holidays),
  * or from the state its source reports when the app has no calendar for it,
- * such as an index publisher or a futures exchange. Null when neither says.
+ * such as an index publisher or a futures exchange; an index quote that states
+ * none is placed on the sessions it carries. Null when none of them says.
  */
 function venueSession(exchange: string, marketState: string | undefined, now: number, calendar?: QuoteIndexSession): VenueSession | null {
   if (isAlwaysOpenExchange(exchange)) return { state: "always" };
@@ -68,8 +69,22 @@ function venueSession(exchange: string, marketState: string | undefined, now: nu
   }
   if (marketState === "REGULAR") return { state: "open" };
   const stated = marketState === "PRE" ? "pre-market" : marketState === "POST" ? "after-hours" : marketState && CLOSED_STATES.has(marketState) ? "closed" : null;
-  if (!stated) return null;
-  return calendar ? { state: stated, ...quotedSessions(calendar, now) } : { state: stated };
+  if (!calendar) return stated ? { state: stated } : null;
+  const state = stated ?? quotedState(calendar, now);
+  return state ? { state, ...quotedSessions(calendar, now) } : null;
+}
+
+/**
+ * Where an index quote's own sessions put the market now, for a quote that
+ * states no session. Before the open it is pre-market on the day of the open,
+ * as the venue calendars have it, and closed on any earlier day (a weekend, a holiday).
+ */
+function quotedState({ timeZone, current, regular }: QuoteIndexSession, now: number): ReportMarketState | null {
+  if (now >= current.end) return "closed";
+  if (now >= current.start) return "open";
+  // A regular session still running is not today's: the sessions disagree, so say nothing.
+  if (regular.some((window) => window.end > now)) return null;
+  return zonedDateKey(now, timeZone) === zonedDateKey(current.start, timeZone) ? "pre-market" : "closed";
 }
 
 /**

package/src/components/chart/composite/format.ts

@@ -500,6 +500,13 @@ export function formatCompositeCursorAxisDate(
 
 const MONTH_NAMES = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
 
+/** A dataset observation's day as the axis words it, `Oct 4`, with the year when the chart ends in another. */
+export function formatCompositeDatasetDate(date: Date, endTime: number | undefined): string {
+  const text = `${MONTH_NAMES[date.getUTCMonth()]} ${date.getUTCDate()}`;
+  const endYear = endTime === undefined ? null : new Date(endTime).getUTCFullYear();
+  return endYear === null || endYear === date.getUTCFullYear() ? text : `${text} ${date.getUTCFullYear()}`;
+}
+
 /**
  * When a value carried under the cursor was observed: its time when it is
  * from the cursor's own day, else its date (`Sep 2`, with the year when that

package/src/components/chart/composite/legend.tsx

@@ -5,7 +5,13 @@ import { CANONICAL_EXCHANGE_ALIASES } from "../../../utils/exchanges";
 import { displayWidth, formatPercentRaw, truncateToDisplayWidth } from "../../../utils/format";
 import type { ResolvedSeries } from "../../../time-series/types";
 import { consumeChartMouseEvent, type ChartMouseEvent } from "../core/pointer";
-import { formatCompositeCarriedStamp, formatCompositePointDetails, formatCompositeSeriesValue, seriesPriceReference } from "./format";
+import {
+  formatCompositeCarriedStamp,
+  formatCompositeDatasetDate,
+  formatCompositePointDetails,
+  formatCompositeSeriesValue,
+  seriesPriceReference,
+} from "./format";
 import type { CompositeChartProps, CompositeChartScene } from "./types";
 import { seriesCueCssBackground, type SeriesLineCue } from "./series-cues";
 
@@ -45,15 +51,6 @@ function axisPriceReference(scene: CompositeChartScene | null, series: ResolvedS
   return own;
 }
 
-const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
-
-/** `Oct 4`, the axis's own wording, with the year when the chart ends in another. */
-function legendDateText(date: Date, endTime: number | undefined): string {
-  const text = `${MONTHS[date.getUTCMonth()]} ${date.getUTCDate()}`;
-  const endYear = endTime === undefined ? null : new Date(endTime).getUTCFullYear();
-  return endYear === null || endYear === date.getUTCFullYear() ? text : `${text} ${date.getUTCFullYear()}`;
-}
-
 /**
  * A dataset's values arrive days late, so the legend dates them. Idle, one
  * date leads the legend when it is every value's; otherwise, and under the
@@ -72,7 +69,7 @@ function legendValueDates(
     valued += 1;
     if (entry.observationKind === "dataset" && cursorValue.point) dates.set(entry.id, cursorValue.point.date);
   }
-  const text = new Map([...dates].map(([id, date]) => [id, legendDateText(date, scene?.endTime)] as const));
+  const text = new Map([...dates].map(([id, date]) => [id, formatCompositeDatasetDate(date, scene?.endTime)] as const));
   const cursorDate = scene?.cursorDate;
   if (cursorDate) {
     const cursorDay = cursorDate.toISOString().slice(0, 10);

package/src/components/command-bar/commands/direct/index.ts

@@ -29,6 +29,9 @@ import { parseWindowModeCommandArg } from "../../layout-items";
 import type { CommandBarRoute } from "../../workflow/types";
 import { recordFunctionOpen } from "../../../../telemetry/usage-counts";
 import { reportTelemetryConfig } from "../../../../telemetry/live-config";
+import { NIGHTLY_CHANNEL_SUMMARY, withUpdateChannel } from "../../../../updater/channel";
+import { isPrereleaseVersion } from "../../../../utils/semver";
+import { VERSION } from "../../../../version";
 
 type NotifyFn = (body: string, options?: { type?: "info" | "success" | "error" }) => void;
 
@@ -373,6 +376,50 @@ export function runDirectCommandAction(options: {
       void onCheckForUpdates?.();
       closeAll({ revertThemePreview: false });
       return;
+    case "release-channel": {
+      // The runtime checks again as soon as the channel changes.
+      const setChannel = (channel: "stable" | "nightly") => {
+        const nextConfig = withUpdateChannel(getState().config, channel);
+        dispatch({ type: "SET_CONFIG", config: nextConfig });
+        persistConfig(nextConfig);
+        notify(`${t(command.label)}: ${channel}`, { type: "success" });
+      };
+      // The saved setting flips; GLOOMBERB_UPDATE_CHANNEL still wins for the run it is set on.
+      // Back to stable asks too, to say a nightly build already running stays.
+      if (state.config.updates?.channel === "nightly") {
+        openInlineConfirm({
+          confirmId: "switch-to-stable",
+          title: "Switch to Stable?",
+          body: [
+            isPrereleaseVersion(VERSION)
+              ? "Updates come from stable releases only. This nightly build stays until a newer stable release is out."
+              : "Updates come from stable releases only.",
+          ],
+          confirmLabel: "Switch to Stable",
+          cancelLabel: "Stay on Nightly",
+          tone: "default",
+          onConfirm: async () => { setChannel("stable"); },
+        });
+        return;
+      }
+      openInlineConfirm({
+        confirmId: "switch-to-nightly",
+        title: "Switch to Nightly?",
+        body: [
+          `Nightly is ${NIGHTLY_CHANNEL_SUMMARY}. Stable releases still reach you when they are newer.`,
+          isPrereleaseVersion(VERSION)
+            ? "Switch back to Stable at any time."
+            : "Switch back to Stable at any time: the nightly build stays until a newer stable release is out.",
+        ],
+        confirmLabel: "Switch to Nightly",
+        cancelLabel: "Stay on Stable",
+        tone: "default",
+        // An opt-in to builds that can break: a stray Enter stays on stable.
+        defaultAction: "cancel",
+        onConfirm: async () => { setChannel("nightly"); },
+      });
+      return;
+    }
     case "theme":
       setRootThemeBaseId(getState().config.theme);
       setRootQuery(arg ? `TH ${arg}` : "TH ");

package/src/components/command-bar/commands/registry.ts

@@ -250,6 +250,14 @@ export const commands: Command[] = [
     description: "Check GitHub releases for a newer version",
     category: "Config",
   },
+  {
+    // Not "Update ...": "update" has to land on Check for Updates first.
+    id: "release-channel",
+    prefix: "",
+    label: "Release Channel",
+    description: "Update from stable releases, or from nightly builds as well",
+    category: "Config",
+  },
   {
     id: "toggle-crash-reports",
     prefix: "",

package/src/components/command-bar/panel/prompt-binding.ts

@@ -52,3 +52,11 @@ function getSnapshot(): CommandBarPromptBinding | null {
 export function useCommandBarPromptBinding(): CommandBarPromptBinding | null {
   return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 }
+
+/**
+ * Calls `listener` with the open screen's query each time the bar publishes
+ * its prompt, and with an empty one when it closes. For code outside React.
+ */
+export function subscribeCommandBarQuery(listener: (query: string) => void): () => void {
+  return subscribe(() => listener(binding?.query ?? ""));
+}

package/src/components/command-bar/routes/root/command-items.ts

@@ -4,6 +4,9 @@ import { isManualPortfolio } from "../../../../plugins/builtin/portfolio-list/mu
 import type { Command } from "../../commands/registry";
 import type { ResultItem } from "../../list/model";
 import { canRestartToApply } from "../../../../updater";
+import { NIGHTLY_CHANNEL_SUMMARY, resolveUpdateChannel } from "../../../../updater/channel";
+import { isPrereleaseVersion } from "../../../../utils/semver";
+import { VERSION } from "../../../../version";
 
 interface RootCommandItemBuilderOptions {
   activeCollectionId: string | null;
@@ -157,6 +160,11 @@ export function createRootCommandItemBuilder({
         return state.config.telemetry?.attention === true
           ? "Currently on: share ticker research counts"
           : "Currently off: opt in to sharing ticker research counts";
+      case "release-channel":
+        if (resolveUpdateChannel(state.config) === "nightly") return `Currently nightly: ${NIGHTLY_CHANNEL_SUMMARY}`;
+        return isPrereleaseVersion(VERSION)
+          ? "Currently stable: this nightly build stays until a newer stable release"
+          : "Currently stable";
       case "font-size-increase":
       case "font-size-decrease":
         return `Currently ${state.config.fontSize ?? 12}px`;
@@ -176,6 +184,8 @@ export function createRootCommandItemBuilder({
         return state.config.telemetry?.usage === false ? "off" : "on";
       case "toggle-attention-counts":
         return state.config.telemetry?.attention === true ? "on" : "off";
+      case "release-channel":
+        return resolveUpdateChannel(state.config);
       default:
         return command.prefix || undefined;
     }
@@ -185,8 +195,13 @@ export function createRootCommandItemBuilder({
     switch (command.id) {
       case "set-portfolio-position":
         return "edit position update position modify position manual position portfolio position";
+      // "update" is a whole word here so it lands on this command before Set
+      // Portfolio Position (whose keywords say "update position") and Release
+      // Channel, which keeps the word further back.
       case "check-for-updates":
-        return state.updateProgress?.phase === "ready" ? "check for updates restart relaunch" : "";
+        return state.updateProgress?.phase === "ready" ? "update check for updates restart relaunch" : "update";
+      case "release-channel":
+        return "nightly stable beta prerelease update updates channel";
       default:
         return "";
     }

package/src/components/command-bar/surface/index.tsx

@@ -77,9 +77,10 @@ export function CommandBar({
     titleBarOverlay,
     visibleListStateRef,
   } = useCommandBarEnvironment();
+  // Without an updater (the web terminal) neither checking nor a channel means anything.
   const availableCommands = useMemo(() => onCheckForUpdates
     ? allAvailableCommands
-    : allAvailableCommands.filter((command) => command.id !== "check-for-updates"), [allAvailableCommands, onCheckForUpdates]);
+    : allAvailableCommands.filter((command) => command.id !== "check-for-updates" && command.id !== "release-channel"), [allAvailableCommands, onCheckForUpdates]);
   const {
     applyThemePreview,
     clearThemePreview,

package/src/components/command-bar/workflow/ops.ts

@@ -2,7 +2,7 @@ import { type LayoutConfig, type PaneBinding, type PaneInstanceConfig } from "..
 import type { PaneSettingField, PaneTemplateContext, PaneTemplateCreateOptions, PaneTemplateInstanceConfig, PaneTemplateDef } from "../../../types/plugin";
 import { getFocusedCollectionId, getFocusedTickerSymbol } from "../../../state/app/context";
 import { resolveInstrumentForPane, resolveListingForPane } from "../../../core/state/app/instrument";
-import { resolveTickerOpenTarget } from "../../../tickers/open-target";
+import { resolveTickerOpenTarget, tickerOpenFailureMessage } from "../../../tickers/open-target";
 import { instrumentFromTicker } from "../../../market-data/request-types";
 import { scopedBrokerContractIdentityKey } from "../../../utils/instrument-identity";
 import { tickerSelectionFromSearchResult } from "../../../tickers/selection";
@@ -120,9 +120,10 @@ async function resolvePaneTemplateOptions(
     && (tickerNamed || !template.shortcut.argOptional);
   if (resolvesTicker) {
     if (resolvedOptions?.instrument === null && !resolvedOptions.ticker) {
-      const publicTarget = await resolveTickerOpenTarget({ query: resolvedOptions.symbol ?? resolvedOptions.arg ?? baseContext.activeTicker ?? "",
+      const publicQuery = resolvedOptions.symbol ?? resolvedOptions.arg ?? baseContext.activeTicker ?? "";
+      const publicTarget = await resolveTickerOpenTarget({ query: publicQuery,
         tickers: state.tickers, tickerRepository: deps.tickerRepository, dataProvider: deps.dataProvider, publicOnly: true });
-      if (!publicTarget) throw new Error("Could not resolve the selected public listing.");
+      if (!publicTarget) throw new Error(tickerOpenFailureMessage(publicQuery.trim().toUpperCase()));
       deps.dispatch({ type: "UPDATE_TICKER", ticker: publicTarget.ticker });
       if (publicTarget.created) deps.pluginRegistry.events.emit("ticker:added", { symbol: publicTarget.symbol, ticker: publicTarget.ticker });
       resolvedOptions = { ...resolvedOptions, symbol: publicTarget.symbol, ticker: publicTarget.ticker, listing: resolvedOptions.listing ?? publicTarget.listing };

package/src/components/form-modal/confirm.tsx

@@ -137,6 +137,7 @@ export function ConfirmModalContent({
       confirmLabel={t(confirm.confirmLabel)}
       cancelLabel={t(confirmCancelLabel(confirm.cancelLabel))}
       confirmVariant={confirm.tone === "default" ? "primary" : "danger"}
+      defaultAction={confirm.defaultAction}
       width={contentWidth}
       status={status}
       busy={pending}

package/src/components/form-modal/request.ts

@@ -12,6 +12,8 @@ export interface ConfirmModalOptions {
   cancelLabel?: string;
   /** Danger unless said otherwise: most confirms guard a deletion. */
   tone?: "default" | "danger";
+  /** What Enter answers: `cancel` for an opt-in a stray Enter must not accept (ConfirmDialog). */
+  defaultAction?: "confirm" | "cancel";
   /** Reads what it acts on when it runs, not when the confirm opened. */
   onConfirm: () => void | Promise<void>;
   /** "stay" keeps the confirm open after it ran; "back" closes it, as "close" does. */

package/src/components/index.ts

@@ -147,7 +147,7 @@ export type {
   NoticeProps, NumberFieldProps, PaneStatusBodyProps, PopoverProps, ProseProps, QueryBarFilter,
   QueryBarMultiFilter, QueryBarProps, QueryBarSearch, QueryBarSearchFocus, QueryBarSelectFilter, QueryBarTextFilter,
   QueryBarToggleFilter, QueryBarView, RangeTrackProps, RatioBarProps, SectionHeadingProps, SectionProps, SegmentedControlProps,
-  SelectButtonOption, SelectButtonProps, SelectControl, StatGridProps, StatItem, TabsProps,
+  SelectButtonOption, SelectButtonProps, SelectControl, StatGridProps, StatItem, StatusRetry, TabsProps,
   TextFieldProps, TextPromptDialogProps,
 } from "./ui";
 export { usePaneTicker } from "../state/app/context";

package/src/components/layout/detached-pane-shell.tsx

@@ -38,7 +38,8 @@ import {
   paneManagementAccelerators,
   resolvePaneManagementShortcut,
 } from "./shell/shortcuts";
-import { menuItemsForFallback, paneFooterMenuItems } from "./shell/menu";
+import { menuItemsForFallback, paneFooterMenuItems, REPORT_BUG_MENU_LABEL } from "./shell/menu";
+import { canReportPaneBug } from "../../shares/bug-report-flow";
 import { useShellPaneCapture } from "./shell/pane/capture";
 import { captureStampFooter, usePaneCaptureStamp } from "./pane/capture-stamp";
 import { pluginContextMenuSlot, withPluginContextMenuItems } from "../../ui/context-menu";
@@ -252,6 +253,10 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
     }
     items.push({ id: "pane-docs", label: "Docs", onSelect: openDocs });
     items.push({ id: "share-pane", label: "Share", accelerator: accelerators.share, onSelect: sharePane });
+    // A popped-out window paints its pane's DOM, so it can always picture it.
+    if (canReportPaneBug(true)) {
+      items.push({ id: "report-bug", label: REPORT_BUG_MENU_LABEL, onSelect: () => pluginRegistry.reportPaneBug(desktopWindowBridge.paneId) });
+    }
     items.push(pluginContextMenuSlot("pane"));
     if (dockPane) {
       items.push({ id: "dock", label: "Dock in Main Window", accelerator: accelerators.toggleFloating, onSelect: dockPane });

package/src/components/layout/pane/sidebar.tsx

@@ -178,9 +178,11 @@ export function PaneSidebar({
     (resize?.onResizeEnd ?? resize?.onResize)?.(next);
   }, [resize, resolveDragWidth, stopLiveDrag]);
 
-  // The keyboard moves the divider too: `<` and `>` while the pane is focused,
-  // shown in the footer and listed in the pane menu. Each press is a finished
-  // resize, so it persists.
+  // The keyboard moves the divider too: `<` and `>` while the pane is focused.
+  // They are bound and listed in the pane menu, not drawn in the footer: the
+  // width of a list is not one of the pane's actions, and the divider shows
+  // where it is (on the desktop its tooltip names the keys). Each press is a
+  // finished resize, so it persists.
   const resizeRegistrationId = `pane-sidebar-resize:${useId()}`;
   const canNarrow = !!resize && width > resize.min;
   const canWiden = !!resize && width < resize.max;
@@ -189,14 +191,25 @@ export function PaneSidebar({
     const next = Math.min(resize.max, Math.max(resize.min, width + delta));
     if (next !== width) (resize.onResizeEnd ?? resize.onResize)(next);
   };
-  usePaneFooter(resizeRegistrationId, () => (resize ? {
-    // After the pane's own actions, which register at order 0.
-    order: 1,
-    hints: [
-      { id: "sidebar-narrow", key: NARROW_KEY, label: " sidebar", title: t("Narrow Sidebar"), onPress: () => stepResize(-KEYBOARD_RESIZE_STEP), disabled: !canNarrow },
-      { id: "sidebar-widen", key: WIDEN_KEY, label: "", title: t("Widen Sidebar"), onPress: () => stepResize(KEYBOARD_RESIZE_STEP), disabled: !canWiden },
-    ],
-  } : null), [!!resize, canNarrow, canWiden, resize?.min, resize?.max, width]);
+  usePaneFooter(resizeRegistrationId, () => {
+    if (!resize) return null;
+    const steps = [
+      { id: "sidebar-narrow", key: NARROW_KEY, title: "Narrow Sidebar", delta: -KEYBOARD_RESIZE_STEP, disabled: !canNarrow },
+      { id: "sidebar-widen", key: WIDEN_KEY, title: "Widen Sidebar", delta: KEYBOARD_RESIZE_STEP, disabled: !canWiden },
+    ];
+    return {
+      // After the pane's own actions, which register at order 0.
+      order: 1,
+      keys: steps.map(({ id, key, delta, disabled }) => ({ id, key, label: "", onPress: () => stepResize(delta), disabled })),
+      // A bound that is reached drops out, as a disabled footer hint did.
+      menu: steps.filter((step) => !step.disabled).map(({ id, key, title, delta }) => ({
+        id: `pane-sidebar:${id}`,
+        label: title,
+        accelerator: key,
+        onSelect: () => stepResize(delta),
+      })),
+    };
+  }, [!!resize, canNarrow, canWiden, resize?.min, resize?.max, width]);
 
   const borderWidth = nativePaneChrome ? 0 : width > 1 ? 1 : 0;
   const listWidth = Math.max(width - borderWidth, 1);

package/src/components/layout/shell/index.tsx

@@ -71,6 +71,7 @@ import type { AppTickerRepositoryPort } from "../../../core/app-service-ports";
 import type { DataProvider } from "../../../types/data-provider";
 import { useShellPaneActions } from "./pane/actions";
 import { useShellPaneCapture } from "./pane/capture";
+import { canReportPaneBug } from "../../../shares/bug-report-flow";
 import { useShellPaneLayoutMoves } from "./pane/new-layout";
 import { resolvePaneFocusSourceLayout } from "./fullscreen";
 import { useTransientLayout } from "../transient-layout";
@@ -668,6 +669,9 @@ export function Shell({
       paneLayoutMoveMenu(paneId),
       () => { openPaneDocs(paneId); },
       canAsk ? () => { askAboutPane(paneId, { cover: kitMenuRectRef.current }); } : undefined,
+      canReportPaneBug(nativePaneChrome || !!nativeRenderer.capturePaneImage)
+        ? () => { pluginRegistry.reportPaneBug(paneId); }
+        : undefined,
     );
     const showKitMenu = () => {
       const fallbackSourceItems = withPluginContextMenuItems(context, items, pluginRegistry);
@@ -710,7 +714,7 @@ export function Shell({
     void showContextMenu(context, items, event).then((shown) => {
       if (!shown) showKitMenu();
     });
-  }, [askAboutPane, canAsk, canExportPaneCsv, closePaneMenu, contentHeight, copyPaneScreenshot, desktopWindowBridge, exportPaneCsv, focusPane, getPaneTitle, handlePaneQuickSetting, nativePaneChrome, togglePaneFullscreen, openPaneDocs, openPaneSettings, paneAccelerators, paneLayoutMoveMenu, paneMap, persistLayout, pluginRegistry, rendererHost.copyPngImage, sharePane, shortcutDisplayMode, showContextMenu, titleState, visibleLayout, width]);
+  }, [askAboutPane, canAsk, canExportPaneCsv, closePaneMenu, contentHeight, copyPaneScreenshot, desktopWindowBridge, exportPaneCsv, focusPane, getPaneTitle, handlePaneQuickSetting, nativePaneChrome, nativeRenderer, togglePaneFullscreen, openPaneDocs, openPaneSettings, paneAccelerators, paneLayoutMoveMenu, paneMap, persistLayout, pluginRegistry, rendererHost.copyPngImage, sharePane, shortcutDisplayMode, showContextMenu, titleState, visibleLayout, width]);
   openPaneMenuRef.current = openPaneMenu;
 
 

package/src/components/layout/shell/menu.ts

@@ -25,6 +25,9 @@ const MENU_MAX_WIDTH = 44;
 
 export const MENU_Z_INDEX = 10_000;
 
+/** The pane menu entry that opens Report a Bug, in the main window's and a popped-out window's menu. */
+export const REPORT_BUG_MENU_LABEL = "Report a Bug";
+
 /** One row of the kit pane menu; a divider row is skipped by the keyboard. */
 export interface PaneMenuEntry {
   id: string;
@@ -107,6 +110,8 @@ export function menuForPane(
   openDocs?: () => void,
   /** A new Ask Gloom conversation with this pane attached, the same as the button beside the `?`. */
   askGloom?: () => void,
+  /** Report a Bug: the pane's picture and a line to #bugs; absent where it cannot be posted or pictured. */
+  reportBug?: () => void,
 ): ContextMenuItem[] {
   const baseActions: ContextMenuItem[] = [...paneItems];
   if (baseActions.length > 0) baseActions.push(contextMenuDivider("pane:own-actions-divider"));
@@ -141,6 +146,9 @@ export function menuForPane(
       onSelect: sharePane,
     });
   }
+  if (reportBug) {
+    baseActions.push({ id: "report-bug", label: REPORT_BUG_MENU_LABEL, onSelect: reportBug });
+  }
   if (copyPaneScreenshot) {
     baseActions.push({
       id: "copy-screenshot",

package/src/components/layout/shell/pane/capture.ts

@@ -4,13 +4,14 @@ import type { LayoutBounds, ResolvedPane } from "../../../../layout/pane-manager
 import type { PluginRegistry } from "../../../../plugins/registry";
 import { paneScreenshotScale, PANE_SCREENSHOT_MIN_WIDTH } from "../../../../remote/pane-screenshot";
 import { base64Bytes, formatCaptureStamp, type PaneImageCapture } from "../../../../shares/pane-image";
-import { panePersonalData } from "../../../../shares/personal-pane";
+import { capturedPersonalData } from "../../../../shares/personal-pane";
 import { resolveTickerForPane, useAppStateRef } from "../../../../state/app/context";
 import type { LayoutConfig } from "../../../../types/config";
 import { useUiCapabilities, type NativeRendererHost } from "../../../../ui";
 import { buildPaneSharePayload } from "../../../../shares/pane";
 import { preparePaneShare } from "../../../../shares/prepare";
 import { shareFocusedPane } from "../../../../shares/flow";
+import { reportPaneBug } from "../../../../shares/bug-report-flow";
 import { useDialog } from "../../../../ui/dialog";
 import { capturePaneImage as paintPaneImage } from "../../../../utils/dom-screenshot";
 import { setPaneCaptureStamp } from "../../pane/capture-stamp";
@@ -45,14 +46,16 @@ interface UseShellPaneCaptureOptions {
 
 /**
  * Binds `capturePaneImage` and `promptDialog` for plugins that post a pane's
- * picture or copy its link. The desktop and the web paint the pane's DOM; the
- * terminal draws the cells it shows, kitty charts included.
+ * picture or copy its link, and Share and Report a Bug, which are built on
+ * them. The desktop and the web paint the pane's DOM; the terminal draws the
+ * cells it shows, kitty charts included.
  */
 export function useShellPaneCapture(options: UseShellPaneCaptureOptions): void {
   const { pluginRegistry } = options;
   const dialog = useDialog();
-  // Shared by menu, command, key and plugin calls, including triggers without a repeat flag.
-  const [shareOnce] = useState(createOneShot);
+  // Shared by Share and Report a Bug from a menu, command, key or plugin call,
+  // including triggers without a repeat flag: one capture flow at a time.
+  const [captureOnce] = useState(createOneShot);
   const { publicSharing } = useUiCapabilities();
   const stateRef = useAppStateRef();
   const latest = useRef(options);
@@ -71,6 +74,8 @@ export function useShellPaneCapture(options: UseShellPaneCaptureOptions): void {
     setPaneCaptureStamp(paneId, formatCaptureStamp(capturedAt));
     try {
       let image: Pick<PaneImageCapture, "png" | "width" | "height" | "pixels" | "cells">;
+      // The terminal's picture is the screen's cells, so it shows whatever is drawn over the pane.
+      let drawn: Map<string, LayoutBounds> | null = null;
       if (current.nativePaneChrome) {
         await nextFrames(2);
         const shot = await paintPaneImage({
@@ -81,7 +86,8 @@ export function useShellPaneCapture(options: UseShellPaneCaptureOptions): void {
         });
         image = { png: base64Bytes(shot.pngBase64), width: shot.width, height: shot.height };
       } else {
-        const rect = current.screenRects().get(paneId);
+        drawn = current.screenRects();
+        const rect = drawn.get(paneId);
         if (!rect || !current.nativeRenderer.capturePaneImage) {
           throw new Error("Show the pane on screen to share it.");
         }
@@ -106,11 +112,13 @@ export function useShellPaneCapture(options: UseShellPaneCaptureOptions): void {
           resolveTickerForPane(stateRef.current, paneId),
           stateRef.current.tickers,
         ) : null,
-        personalData: panePersonalData({
+        personalData: capturedPersonalData({
           registry: current.pluginRegistry,
           state: stateRef.current,
           layout: current.layout,
-          pane,
+          paneId,
+          panes: current.paneMap,
+          drawn,
         }),
         ...image,
       };
@@ -122,15 +130,24 @@ export function useShellPaneCapture(options: UseShellPaneCaptureOptions): void {
   useEffect(() => pluginRegistry.bindHost({
     sharePane: (requestedPaneId) => {
       const paneId = requestedPaneId ?? latest.current.focusedPaneId;
-      if (!paneId || shareOnce.refuses()) return;
-      shareOnce.start();
+      if (!paneId || captureOnce.refuses()) return;
+      captureOnce.start();
       // Let a menu/command close before the capture starts. The flow also refuses
       // a second run for the entire dialog/post, even beyond the cooldown's timeout.
       setTimeout(() => {
-        void shareFocusedPane(pluginRegistry, paneId).finally(() => shareOnce.end());
+        void shareFocusedPane(pluginRegistry, paneId).finally(() => captureOnce.end());
+      }, 0);
+    },
+    reportPaneBug: (requestedPaneId) => {
+      const paneId = requestedPaneId ?? latest.current.focusedPaneId;
+      if (!paneId || captureOnce.refuses()) return;
+      captureOnce.start();
+      // After the menu that chose it has closed.
+      setTimeout(() => {
+        void reportPaneBug(pluginRegistry, paneId).finally(() => captureOnce.end());
       }, 0);
     },
     capturePaneImage: capture,
     promptDialog: (prompt) => dialog.prompt(prompt),
-  }), [capture, dialog, pluginRegistry, shareOnce]);
+  }), [capture, captureOnce, dialog, pluginRegistry]);
 }