gloomberb 0.15.2 → 0.15.4

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

@@ -1,6 +1,6 @@
 import { FINANCIAL_VINTAGE_NOTICE, SEC_EPS_BASIS_NOTICE } from "../../../utils/financial-statements";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Box, Text, useUiCapabilities, useUiHost } from "../../../ui";
+import { Box, Text, useUiCapabilities } from "../../../ui";
 import {
   ChoiceDialog,
   EmptyState,
@@ -55,9 +55,17 @@ import {
   projectVisibleChartSeries,
   toggleChartSeries,
 } from "./chart-spec";
+import {
+  futuresGenericNotice,
+  futuresGenericRollFromValue,
+  futuresGenericRollLabel,
+  futuresGenericRollValue,
+  type FuturesGenericAdjust,
+} from "../../../utils/futures-generic";
 import {
   buildEmptyChartPreset,
   buildPriceChartPreset,
+  chartFuturesGeneric,
   chartSeriesLabel,
   defaultFinancialTimestampMode,
   builtinStudyPeriod,
@@ -66,6 +74,7 @@ import {
   isPeriodStudy,
   setBuiltinStudies,
   setBuiltinStudyPeriod,
+  setChartFuturesGeneric,
   setPairStudies,
   rebindResearchChartSpec,
   STUDY_PERIOD_MAX,
@@ -85,7 +94,7 @@ import {
 import { resolveChartComposerShortcut } from "./shortcuts";
 import { describeChartResolution, formatChartDateWindow, formatChartResolution } from "./viewport-labels";
 import { ChartSeriesQuickAdd } from "./quick-add";
-import { useLiveStreamingSetting } from "../shared/live-streaming";
+import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { usePluginAppActions } from "../../runtime";
 import { isPlainKey } from "../../../utils/keyboard";
 import { resolveInstrumentForPane } from "../../../core/state/app/instrument";
@@ -143,6 +152,18 @@ interface ChartComposerSurfaceProps {
 
 const QUICK_ADD_CAPTURE = "quick-add";
 
+const GENERIC_ROLL_OPTIONS = [
+  { value: "oi", label: "OI switch" },
+  { value: "f5", label: "5d before notice" },
+  { value: "d15", label: "Day 15" },
+];
+
+const GENERIC_ADJUST_OPTIONS = [
+  { value: "none", label: "None" },
+  { value: "ratio", label: "Ratio" },
+  { value: "difference", label: "Difference" },
+];
+
 function footerAnchorPoint(event?: PaneFooterPressEvent): { x: number; y: number } | undefined {
   const x = event?.pixelX;
   const y = event?.pixelY;
@@ -170,7 +191,7 @@ function ChartComposerSurface({
   const dialog = useDialog();
   const dispatch = useAppDispatch();
   const { publicSharing, cellWidthPx = 8 } = useUiCapabilities();
-  const desktopWeb = useUiHost().kind === "desktop-web";
+  const desktopWeb = useUiCapabilities().nativePaneChrome === true;
   const paneId = usePaneInstanceId();
   const liveStreaming = useLiveStreamingSetting();
   const dialogOpen = useDialogState((state) => state.isOpen);
@@ -655,6 +676,31 @@ function ChartComposerSurface({
     return formatChartDateWindow(window, timeZone);
   }, [spec.series, spec.viewport.dateWindow]);
 
+  // A generic future (CL1) is a rolling series: its roll rule and adjustment are chart controls.
+  const generic = useMemo(() => chartFuturesGeneric(spec), [spec]);
+  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);
+    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);
+      specRef.current = next;
+      setSpec(next);
+    };
+    return [
+      { id: "roll", label: "Roll", value: roll, options: rollOptions, title: "Roll rule",
+        onChange: (value: string) => {
+          const next = futuresGenericRollFromValue(value);
+          if (next) update({ roll: next });
+        } },
+      { id: "adjust", label: "Adjust", value: generic.adjust, options: GENERIC_ADJUST_OPTIONS, title: "Adjustment",
+        onChange: (value: string) => update({ adjust: value as FuturesGenericAdjust }) },
+    ];
+  }, [generic, setSpec]);
+
   const emptyMessage = spec.series.length === 0
     ? "Add a series to start the chart"
     : resolution.loading
@@ -670,6 +716,7 @@ function ChartComposerSurface({
             value: spec.viewport.dateWindow ? "" : spec.viewport.range,
             options: RANGE_OPTIONS,
             onChange: (value: string) => setRange(value as TimeRange) },
+          ...genericFilters,
         ]}
         view={resolutionOptions.length > 1 ? {
           value: spec.viewport.resolution,

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

@@ -1,3 +1,4 @@
+import { formatFuturesGeneric, futuresGenericCaption, futuresGenericListing, isSameFuturesGeneric, type FuturesGeneric } from "../../../utils/futures-generic";
 import {
   CHART_SPEC_VERSION,
   type ChartPanelSpec,
@@ -26,6 +27,7 @@ import {
 import {
   CANONICAL_EXCHANGE_ALIASES,
   canonicalExchange,
+  parsePublicTickerKey,
   publicTickerKey,
 } from "../../../utils/exchanges";
 import { MAX_CHART_COMPOSER_SERIES } from "./chart-spec";
@@ -195,6 +197,9 @@ export function chartSeriesLabel(series: ChartSeriesSpec): string {
   if (series.label?.trim()) return series.label.trim();
   if (series.source.kind === "economic") return `FRED ${series.source.seriesId}`;
   if (series.source.kind === "capability") return series.source.seriesId;
+  const generic = getTimeSeriesField(series.source.fieldId)?.unitGroup === "price"
+    ? futuresGenericListing(series.source.instrument.symbol, series.source.instrument.exchange) : null;
+  if (generic) return futuresGenericCaption(generic);
   const instrument = publicTickerKey(
     series.source.instrument.symbol,
     series.source.instrument.exchange,
@@ -203,6 +208,30 @@ export function chartSeriesLabel(series: ChartSeriesSpec): string {
   return `${instrument} ${field?.shortLabel ?? series.source.fieldId.split(".").at(-1) ?? "Series"}`;
 }
 
+/** The chart's first generic future (CL1), whose roll and adjustment the pane's controls show. */
+export function chartFuturesGeneric(spec: ChartSpec): FuturesGeneric | null {
+  for (const entry of spec.series) {
+    const generic = entry.source.kind === "security" ? futuresGenericListing(entry.source.instrument.symbol, entry.source.instrument.exchange) : null;
+    if (generic) return generic;
+  }
+  return null;
+}
+
+/** Moves every generic future on the chart to another roll rule or adjustment; each is its own ticker (CL1F5R). */
+export function setChartFuturesGeneric(spec: ChartSpec, change: Partial<Pick<FuturesGeneric, "roll" | "adjust">>): ChartSpec {
+  let changed = false;
+  const series = spec.series.map((entry) => {
+    if (entry.source.kind !== "security") return entry;
+    const generic = futuresGenericListing(entry.source.instrument.symbol, entry.source.instrument.exchange);
+    if (!generic) return entry;
+    const symbol = formatFuturesGeneric({ ...generic, ...change });
+    if (symbol === generic.ticker) return entry;
+    changed = true;
+    return { ...entry, source: { ...entry.source, instrument: { ...entry.source.instrument, symbol } } };
+  });
+  return changed ? { ...spec, series } : spec;
+}
+
 export function getCompatibleSeriesStyles(fieldId: string): SeriesStyle[] {
   return getTimeSeriesField(fieldId)?.styles ?? ["line", "area", "step", "columns", "points"];
 }
@@ -681,6 +710,11 @@ export function rebindResearchChartSpec(spec: ChartSpec, previous: string | null
   // A restored chart can already contain the target after its old context was
   // lost. Do not replace an unrelated first comparison in that case.
   if (securityKeys.includes(nextKey)) return spec;
+  // The Roll and Adjust controls rewrite a generic (CL1 to CL1F5R); it still
+  // follows the same ticker, and moves on only when the ticker does.
+  const followed = parsePublicTickerKey(previousKey ?? nextKey);
+  const variant = securityKeys.find((key) => isSameFuturesGeneric(parsePublicTickerKey(key), followed));
+  if (variant) return !previousKey || previousKey === nextKey ? spec : rebindChartSecuritySymbol(spec, variant, nextKey);
   const primary = securityKeys[0];
   return primary ? rebindChartSecuritySymbol(spec, primary, nextKey) : spec;
 }

package/src/plugins/builtin/chart-composer/quick-add.tsx

@@ -3,13 +3,12 @@ import {
   Box,
   Text,
   useNativeRenderer,
-  useUiHost,
+  useUiCapabilities,
   type BoxRenderable,
   type InputRenderable,
 } from "../../../ui";
 import { InlineQuickAddRow, ListView, MenuPopover, type ListViewItem } from "../../../components/ui";
 import { usePaneMenuItems } from "../../../components";
-import { getNativeSurfaceManager } from "../../../components/chart/native/surface/manager";
 import { getRenderableCellRect } from "../../../components/chart/native/surface/visibility";
 import { useShortcut } from "../../../react/input";
 import { isPlainKey } from "../../../utils/keyboard";
@@ -22,6 +21,7 @@ import { MAX_CHART_COMPOSER_SERIES } from "./chart-spec";
 import { appendChartSeries } from "./presets";
 import type { SeriesCatalogInstrument, SeriesCatalogSuggestion } from "./series-catalog";
 import { useSeriesCatalogSuggestions } from "./use-series-catalog";
+import { clampIndex } from "../../../utils/math";
 
 const MAX_VISIBLE_SUGGESTIONS = 4;
 const CHART_TOOLBAR_HEIGHT = 1;
@@ -60,11 +60,6 @@ export function isChartQuickAddMouseTarget(target: unknown, quickAddId: string):
   return root?.getAttribute("data-gloom-chart-quick-add") === quickAddId;
 }
 
-function clampSelection(index: number, length: number): number {
-  if (length <= 0) return -1;
-  return Math.max(0, Math.min(index, length - 1));
-}
-
 function defaultCatalogInstrument(spec: ChartSpec): SeriesCatalogInstrument {
   const security = spec.series.find((series) => series.source.kind === "security");
   const instrument = security?.source.kind === "security" ? security.source.instrument : undefined;
@@ -107,7 +102,7 @@ export function ChartSeriesQuickAdd({
   onActiveChange?: (active: boolean) => void;
   onWidthChange?: (width: number) => void;
 }) {
-  const ui = useUiHost();
+  const domRenderer = useUiCapabilities().nativePaneChrome === true;
   const nativeRenderer = useNativeRenderer();
   const paneId = useOptionalPaneInstanceId();
   const quickAddId = useId();
@@ -148,15 +143,14 @@ export function ChartSeriesQuickAdd({
   const drawerHeight = active
     ? Math.min(maximumDrawerHeight, drawerStatus ? 1 : suggestions.length)
     : 0;
-  const nativeSurfaceManager = useMemo(
-    () => getNativeSurfaceManager(nativeRenderer),
-    [nativeRenderer],
-  );
+  const nativeSurfaceManager = nativeRenderer.nativeSurfaceManager;
   useAppInputCapture(inputFocused && focused);
 
   useEffect(() => {
+    // Only terminal hosts draw kitty images the drawer has to cut out.
+    if (!nativeSurfaceManager) return;
     const occluderId = `${quickAddId}:drawer`;
-    if (ui.kind === "desktop-web" || drawerHeight <= 0 || !paneId || !drawerRef.current) {
+    if (domRenderer || drawerHeight <= 0 || !paneId || !drawerRef.current) {
       nativeSurfaceManager.removeLocalOccluder(occluderId);
       return;
     }
@@ -193,7 +187,7 @@ export function ChartSeriesQuickAdd({
       if (drawer.onLifecyclePass === lifecyclePass) drawer.onLifecyclePass = previousLifecyclePass;
       nativeSurfaceManager.removeLocalOccluder(occluderId);
     };
-  }, [drawerHeight, nativeRenderer, nativeSurfaceManager, paneId, quickAddId, ui.kind]);
+  }, [domRenderer, drawerHeight, nativeRenderer, nativeSurfaceManager, paneId, quickAddId]);
 
   useEffect(() => {
     onActiveChange?.(inputFocused && focused);
@@ -210,7 +204,7 @@ export function ChartSeriesQuickAdd({
   // Plugin catalogs land after the securities: only pull a stranded cursor
   // back into range, so a row the user already moved to stays selected.
   useEffect(() => {
-    setSelectedIndex((current) => clampSelection(current, suggestions.length));
+    setSelectedIndex((current) => clampIndex(current, suggestions.length, -1));
   }, [suggestions.length]);
 
   useEffect(() => {
@@ -221,7 +215,7 @@ export function ChartSeriesQuickAdd({
   }, [active, focused]);
 
   useEffect(() => {
-    if (ui.kind !== "desktop-web") return;
+    if (!domRenderer) return;
 
     // Watch regardless of what state believes: the field can hold the document
     // focus after the state that tracks it has already moved on.
@@ -232,7 +226,7 @@ export function ChartSeriesQuickAdd({
 
     document.addEventListener("mousedown", handleOutsideMouseDown, true);
     return () => document.removeEventListener("mousedown", handleOutsideMouseDown, true);
-  }, [quickAddId, ui.kind]);
+  }, [domRenderer, quickAddId]);
 
   const cancelPendingBlur = useCallback(() => {
     if (blurTimerRef.current === null) return;
@@ -287,7 +281,7 @@ export function ChartSeriesQuickAdd({
   }, [cancelPendingBlur, clearInput, onActiveChange, setSpec, spec]);
 
   const submit = useCallback(() => {
-    commitSuggestion(suggestions[clampSelection(selectedIndex, suggestions.length)]);
+    commitSuggestion(suggestions[clampIndex(selectedIndex, suggestions.length, -1)]);
   }, [commitSuggestion, selectedIndex, suggestions]);
   const cancel = useCallback(() => {
     cancelPendingBlur();
@@ -316,11 +310,11 @@ export function ChartSeriesQuickAdd({
     } else if (event.name === "up") {
       event.preventDefault?.();
       event.stopPropagation?.();
-      setSelectedIndex((current) => clampSelection(current - 1, suggestions.length));
+      setSelectedIndex((current) => clampIndex(current - 1, suggestions.length, -1));
     } else if (event.name === "down") {
       event.preventDefault?.();
       event.stopPropagation?.();
-      setSelectedIndex((current) => clampSelection(current + 1, suggestions.length));
+      setSelectedIndex((current) => clampIndex(current + 1, suggestions.length, -1));
     }
   }, {
     phase: "before",
@@ -335,7 +329,7 @@ export function ChartSeriesQuickAdd({
       : null
   ), [active, focusInput, shortcutEnabled]);
 
-  const desktop = ui.kind === "desktop-web";
+  const desktop = domRenderer;
   const quickAddRow = (
       <InlineQuickAddRow
         value={query}
@@ -407,7 +401,7 @@ export function ChartSeriesQuickAdd({
           label="Chart series suggestions"
           minWidth={controlWidth * 8}
           closeOnSelect={false}
-          highlightedId={suggestions[clampSelection(selectedIndex, suggestions.length)]?.id ?? null}
+          highlightedId={suggestions[clampIndex(selectedIndex, suggestions.length, -1)]?.id ?? null}
           onHighlight={(id) => setSelectedIndex(Math.max(0, suggestions.findIndex((suggestion) => suggestion.id === id)))}
           items={drawerStatus
             ? [{ id: "\u0000status", kind: "heading", label: drawerStatus }]
@@ -453,7 +447,7 @@ export function ChartSeriesQuickAdd({
           ) : (
             <ListView
               items={items}
-              selectedIndex={clampSelection(selectedIndex, items.length)}
+              selectedIndex={clampIndex(selectedIndex, items.length, -1)}
               height={drawerHeight}
               surface="plain"
               bgColor={colors.panel}

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

@@ -82,6 +82,7 @@ export function chartComposerSemanticMetadata(
     dateWindow: spec.viewport.dateWindow ?? null,
     maxPoints: spec.viewport.maxPoints ?? null,
     loading: resolution.loading,
+    ready: !resolution.loading,
     errors: resolution.errors,
     warnings: resolution.warnings,
     priceComparison: resolution.priceComparison ?? null,

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

@@ -15,7 +15,7 @@ import type {
   SeriesStyle,
 } from "../../../time-series/types";
 import { isOhlcSeriesStyle } from "../../../time-series/spec";
-import { REALIZED_VOLATILITY_ESTIMATORS, isRealizedVolatilityEstimator } from "../shared/volatility/realized";
+import { REALIZED_VOLATILITY_ESTIMATORS, isRealizedVolatilityEstimator } from "../../../market-data/realized-volatility";
 import {
   applySeriesStyle,
   buildCustomChartPreset,

package/src/plugins/builtin/chat/channels.ts

@@ -5,8 +5,6 @@ import { t } from "../../../i18n";
 import { chatController } from "./controller";
 import { formatChannelLabel } from "./channel-labels";
 
-export { formatChannelLabel, formatChatPaneTitle } from "./channel-labels";
-
 export const DEFAULT_CHAT_CHANNEL_ID = "everyone";
 export const LAST_VISITED_CHAT_CHANNEL_KEY = "lastChatChannelId";
 

package/src/plugins/builtin/chat/content/index.tsx

@@ -8,9 +8,9 @@ import { chatController } from "../controller";
 import {
   estimateComposerHeight,
 } from "../layout";
+import { formatChatPaneTitle } from "../channel-labels";
 import {
   DEFAULT_CHAT_CHANNEL_ID,
-  formatChatPaneTitle,
   normalizeChannelId,
 } from "../channels";
 import { ChatComposerArea } from "./composer";

package/src/plugins/builtin/chat/content/layout-metrics.ts

@@ -1,9 +1,6 @@
 import type { ChatMessage } from "../../../../api-client";
 import { CHAT_COMPOSER_MAX_ROWS } from "../layout";
-import {
-  getChannelSidebarWidth,
-  shouldShowChannelSidebar,
-} from "../sidebar";
+import { getPaneSidebarWidth, shouldShowPaneSidebar } from "../../../../components/layout/pane/sidebar-metrics";
 import { getChatComposerAreaHeight } from "./composer";
 
 export function resolveChatContentWidthMetrics({
@@ -20,9 +17,9 @@ export function resolveChatContentWidthMetrics({
   /** Width the person dragged the sidebar to; null follows the pane width. */
   sidebarWidth?: number | null;
 }) {
-  const showChannelSidebar = shouldShowChannelSidebar(channelCount, width, height);
+  const showChannelSidebar = shouldShowPaneSidebar(channelCount, width, height);
   const channelSidebarWidth = showChannelSidebar
-    ? getChannelSidebarWidth(width, nativePaneChrome === true, sidebarWidth)
+    ? getPaneSidebarWidth(width, nativePaneChrome === true, sidebarWidth)
     : 0;
   const chatWidth = Math.max(width - channelSidebarWidth, 1);
   const contentWidth = Math.max(chatWidth - 2, 1);

package/src/plugins/builtin/chat/controller/fetch.ts

@@ -7,7 +7,6 @@ import {
   type ChannelRuntimeState,
   type MergeMessagesOptions,
 } from "./state";
-import { isLegacyTimestampCursor } from "./utils";
 
 interface ChatFetchDeps {
   mergeMessages(channelId: string, messages: ChatMessage[], options?: MergeMessagesOptions): void;
@@ -19,10 +18,9 @@ export async function fetchLatestChannelMessages(
   channel: ChannelRuntimeState,
   deps: ChatFetchDeps,
 ): Promise<void> {
-  const legacyTimestampCursor = isLegacyTimestampCursor(channel.lastCursor);
   const hasIncrementalCursor = !!channel.lastCursor;
   const hadMessages = channel.messages.length > 0;
-  const countIncrementalUnread = hadMessages && hasIncrementalCursor && !legacyTimestampCursor;
+  const countIncrementalUnread = hadMessages && hasIncrementalCursor;
   // The first fetch of a session drops the cursor so anything missed while the
   // socket was connected comes back. Merging is keyed by message id, so
   // re-reading known messages changes nothing and counts no unread.
@@ -41,17 +39,6 @@ export async function fetchLatestChannelMessages(
       deps.mergeMessages(channelId, messages, { countUnread: countIncrementalUnread });
       return;
     }
-    if (legacyTimestampCursor) {
-      const fullRefresh = await apiClient.getMessages(channelId, { limit: MESSAGE_PAGE_SIZE });
-      if (fullRefresh.length < MESSAGE_PAGE_SIZE) {
-        channel.reachedOldestMessage = true;
-      }
-      if (fullRefresh.length > 0) {
-        deps.mergeMessages(channelId, fullRefresh, { countUnread: false });
-        return;
-      }
-      channel.lastCursor = null;
-    }
     deps.persistChannelState(channelId);
     return;
   } catch {

package/src/plugins/builtin/chat/controller/state.ts

@@ -4,7 +4,7 @@ import type {
   ChatMessage,
   PersistedAuthUser,
 } from "../../../../api-client";
-import { createClientMessageId, getLatestMessageId, resolveHydratedCursor } from "./utils";
+import { createClientMessageId, getLatestMessageId } from "./utils";
 
 export const SESSION_STATE_KEY = "session";
 export const DEFAULT_CHAT_CHANNEL_ID = "everyone";
@@ -168,7 +168,9 @@ export function hydrateChannelRuntimeState({
     : null;
   channel.replyToId = persistedChannel?.replyToId ?? null;
   channel.messages = messages;
-  channel.lastCursor = resolveHydratedCursor(messages, persistedChannel?.lastCursor ?? null);
+  // The cursor follows the cached transcript, so a persisted cursor that ran
+  // ahead of the cache is never sent to the server.
+  channel.lastCursor = getLatestMessageId(messages);
   channel.lastViewedMessageId = userId
     ? persistedChannel?.lastViewedMessageId ?? getLatestMessageId(messages)
     : null;

package/src/plugins/builtin/chat/controller/utils.ts

@@ -1,7 +1,6 @@
 import type { ChatMessage } from "../../../../api-client";
 import { t, tf } from "../../../../i18n";
 
-const ISO_TIMESTAMP_CURSOR = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/;
 const USERNAME_MENTION = /(^|[^A-Za-z0-9_])@([A-Za-z][A-Za-z0-9_]{2,29})(?![A-Za-z0-9_])/g;
 
 export function normalizeChatUsername(username: string | null | undefined): string | null {
@@ -50,23 +49,10 @@ export function formatChannelToast(message: ChatMessage, direct = false): string
   return snippet ? `@${author}: ${snippet}` : tf("@{author} sent a message.", { author });
 }
 
-export function isLegacyTimestampCursor(cursor: string | null): boolean {
-  return !!cursor && ISO_TIMESTAMP_CURSOR.test(cursor);
-}
-
 export function getLatestMessageId(messages: ChatMessage[]): string | null {
   return messages[messages.length - 1]?.id ?? null;
 }
 
-export function resolveHydratedCursor(messages: ChatMessage[], persistedCursor: string | null): string | null {
-  const transcriptCursor = getLatestMessageId(messages);
-  if (!transcriptCursor) return null;
-  if (!persistedCursor || isLegacyTimestampCursor(persistedCursor)) {
-    return persistedCursor ?? transcriptCursor;
-  }
-  return persistedCursor === transcriptCursor ? persistedCursor : transcriptCursor;
-}
-
 export function createClientMessageId(): string {
   const randomUUID = globalThis.crypto?.randomUUID?.();
   return randomUUID ?? `local:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;

package/src/plugins/builtin/chat/index.tsx

@@ -0,0 +1,105 @@
+import type { PluginModule } from "../plugin-module";
+import { teamChannelId } from "../cloud/team/model";
+import { teamStore } from "../cloud/team/store";
+import { formatChatPaneTitle } from "./channel-labels";
+import {
+  buildDmCommandResults,
+  getPreferredChatOpenChannelId,
+  hasOnlyDmUsernameArgs,
+  normalizeShortcutChannelId,
+  openDmTargetFromCommand,
+  parseDmUsernames,
+} from "./channels";
+import { chatController } from "./controller";
+import { ChatPane } from "./pane";
+import { chatSidebarStore } from "./sidebar-store";
+import { ChatStatusWidget } from "./status-widget";
+
+export const chatModule: PluginModule = {
+  panes: [{
+    id: "chat",
+    name: "Chat",
+    icon: "C",
+    component: ChatPane,
+    defaultPosition: "right",
+    defaultMode: "floating",
+    defaultFloatingSize: { width: 80, height: 30 },
+    portableShare: {
+      private: { title: true, params: true, settings: true, state: true },
+    },
+  }],
+  paneTemplates: [{
+    id: "new-chat-pane",
+    paneId: "chat",
+    label: "New Chat Pane",
+    description: "Open the floating chat window for a channel",
+    keywords: ["new", "chat", "pane", "message"],
+    shortcut: { prefix: "CHAT", argPlaceholder: "channel", argKind: "text" },
+    createInstance: async (context, options) => {
+      // `CHAT MD` or `CHAT "Macro Desk"` opens that team's #general. A raw
+      // channel id (team ids are mixed case) is kept as typed.
+      const rawArg = options?.arg?.trim() ?? "";
+      const team = rawArg ? teamStore.findTeam(rawArg) : null;
+      const channelId = team
+        ? teamChannelId(team.id)
+        : rawArg && chatController.getChannels().some((entry) => entry.id === rawArg)
+        ? rawArg
+        : rawArg
+        ? await chatController.resolveRequiredChannelId(normalizeShortcutChannelId(rawArg))
+        : await chatController.resolvePreferredChannelId(
+          getPreferredChatOpenChannelId(context.config, chatController.getSnapshot()),
+        );
+      const channel = chatController.getChannels().find((entry) => entry.id === channelId);
+      const targetMessageId = options?.values?.messageId?.trim() || null;
+      return {
+        placement: "floating",
+        // One pane per channel: re-opening the same channel focuses the pane
+        // that already holds it, even though its channelId setting drifts as
+        // the user switches channels inside the pane. A jump to a specific
+        // message stays unkeyed so it never lands on a pane that already
+        // scrolled past the target.
+        ...(targetMessageId ? {} : { instanceId: `chat:${channelId}` }),
+        title: formatChatPaneTitle(channel, channelId),
+        settings: {
+          channelId,
+          ...(targetMessageId ? { targetMessageId } : {}),
+        },
+      };
+    },
+  }],
+  slots: {
+    "status:widget": () => <ChatStatusWidget />,
+  },
+  setup(ctx) {
+    chatController.attachPersistence(ctx.persistence, ctx.resume);
+    chatSidebarStore.attach(ctx.persistence);
+    chatController.setNotifier(ctx.notify, (channelId, messageId) => {
+      ctx.createPaneFromTemplate("new-chat-pane", { arg: channelId, values: { messageId } });
+    });
+    ctx.registerCommand({
+      id: "direct-message",
+      label: "DM",
+      description: "Open an existing DM or start a direct/group chat",
+      keywords: ["dm", "direct", "message", "group", "chat"],
+      category: "navigation",
+      shortcut: "DM",
+      shortcutArg: {
+        placeholder: "@username [@username...]",
+        kind: "text",
+        parse: (arg) => ({ participants: arg.trim() }),
+      },
+      buildResults: (arg) => buildDmCommandResults(ctx, arg),
+      execute: async (values) => {
+        const participants = values?.participants ?? values?.shortcut ?? "";
+        const usernames = parseDmUsernames(participants);
+        if (participants.trim() && !hasOnlyDmUsernameArgs(participants)) {
+          throw new Error("Use @username, or multiple usernames for a group chat.");
+        }
+        await openDmTargetFromCommand(ctx, usernames);
+      },
+    });
+  },
+  dispose() {
+    chatController.dispose();
+  },
+};