gloomberb 0.8.0 → 0.8.2

package/README.md

@@ -17,57 +17,6 @@ Available as a desktop app or TUI.
 
 </div>
 
-## Functions
-
-Open the command bar with `Ctrl+P` or `` ` ``, then type a shortcut or command name.
-
-| Shortcut | Function |
-|----------|----------|
-| `DES <ticker>` | Security details for a ticker |
-| `FA <ticker>` | Financial statement view |
-| `GP <ticker>` | Price chart |
-| `GIP <ticker>` | Intraday price chart |
-| `HP <ticker>` | Historical OHLCV prices |
-| `GF <tickers>` | Fundamental statement graph |
-| `GE <tickers>` | Valuation multiple graph |
-| `GR <tickers>` | Security relationship graph |
-| `EE <ticker>` | Events view with earnings and revenue estimates |
-| `EM [tickers]` | Earnings monitor |
-| `SRCH <query>` | Provider symbol search |
-| `QQ <tickers>` | Ticker quote monitor |
-| `PM <query>` | Polymarket and Kalshi prediction data |
-| `TOP` | Ranked market stories |
-| `MOST` | Top gainers, losers, most active, and trending tickers |
-| `WEI` | Global equity indices |
-| `ECON` | Economic events and releases |
-| `CMP <tickers>` | Ticker charts |
-| `CORR <tickers>` | Ticker return correlations |
-| `ANR <ticker>` | Analyst targets and ratings |
-| `SEC <ticker>` | SEC filings and company disclosures |
-| `TWIT <query>` | Ticker-related market posts |
-| `OMON <ticker>` | Options monitor |
-| `PORT` | Portfolio risk and sector exposure |
-| `BI` / `SP` | S&P 500 sector performance |
-| `FXC` | Major FX cross rates |
-| `FNG` | Fear and greed market gauge |
-| `ALRT` | Price alerts |
-| `CHAT` | Gloom Cloud chat |
-| `PF` | Portfolio and watchlist workspace |
-| `N` | News feed |
-| `CN <ticker>` | Ticker news |
-| `NI` | Sector news |
-| `FIRST` | Breaking news |
-| `NOTE` | Notes |
-| `AI <prompt>` | AI screener |
-| `GC` | Yield curve |
-| `ERN` | Earnings calendar |
-| `HDS <ticker>` | Institutional holders |
-| `INS <ticker>` | Insider activity |
-| `EVT <ticker>` | Corporate actions, earnings, and estimates |
-| `RV <tickers>` | Relative valuation |
-| `IBKR` | IBKR trading pane |
-| `BR` | Broker connections |
-
 ## Install
 
 macOS desktop app + terminal command:
@@ -100,6 +49,25 @@ On macOS, app updates replace the app bundle in place and keep the terminal comm
 
 For the best terminal experience, use a [Kitty](https://sw.kovidgoyal.net/kitty/)-compatible terminal such as Ghostty, Kitty, or WezTerm.
 
+## Start
+
+Open the command bar with `Ctrl+P` or `` ` ``, then type a command.
+
+| Try | Opens |
+|-----|-------|
+| `DES AAPL` | Security details |
+| `GP NVDA` | Price chart |
+| `TOP` | Ranked market stories |
+| `MOST` | Market movers |
+| `PF` | Portfolios and watchlists |
+| `HELP` | Full in-app shortcut list |
+
+## What It Does
+
+- Research companies with quotes, charts, financials, filings, holders, insiders, options, analyst ratings, events, and relative valuation.
+- Follow markets with top stories, breaking news, sector feeds, global indices, FX, macro events, yield curves, market movers, and fear/greed.
+- Track portfolios and watchlists, connect brokers, set alerts, keep notes, run AI screens, browse prediction markets, and use Gloom Cloud chat.
+
 ## CLI
 
 Running `gloomberb` with no arguments launches the terminal UI. Use `gloomberb help` to see the full command list.
@@ -148,7 +116,89 @@ See [PLUGINS.md](PLUGINS.md) for the plugin API and the shared UI surface availa
 | `m` | Cycle chart mode |
 | `q` | Quit |
 
-Desktop builds also accept the matching `Cmd` shortcuts on macOS, plus `Cmd/Ctrl+Shift+O` to pop out a pane.
+Desktop builds also accept `Cmd/Ctrl+K` for the command bar, the matching `Cmd` shortcuts on macOS, `Cmd/Ctrl+Shift+O` to pop out a pane, and `Cmd/Ctrl+Shift+C` to copy a focused pane screenshot.
+
+## Command Reference
+
+Use `HELP` inside Gloomberb for the live shortcut list. The common command-bar prefixes are listed here for quick scanning.
+
+### Company Research
+
+| Shortcut | Function |
+|----------|----------|
+| `DES <ticker>` / `T <ticker>` | Security details for a ticker |
+| `FA <ticker>` | Financial statement view |
+| `GP <ticker>` | Price chart |
+| `GIP <ticker>` | Intraday price chart |
+| `HP <ticker>` | Historical OHLCV prices |
+| `GF <tickers>` | Fundamental statement graph |
+| `GE <tickers>` | Valuation multiple graph |
+| `GR <tickers>` | Security relationship graph |
+| `EE <ticker>` | Events view with earnings and revenue estimates |
+| `EM [tickers]` | Earnings monitor |
+| `SRCH <query>` | Provider symbol search |
+| `QQ <tickers>` | Ticker quote monitor |
+| `CMP <tickers>` | Ticker charts |
+| `CORR <tickers>` | Ticker return correlations |
+| `ANR <ticker>` | Analyst targets and ratings |
+| `SEC <ticker>` | SEC filings and company disclosures |
+| `OMON <ticker>` | Options monitor |
+| `HDS <ticker>` | Institutional holders |
+| `13F [fund/ticker/CIK]` | 13F fund filings and holdings |
+| `INS <ticker>` | Insider activity |
+| `EVT <ticker>` | Corporate actions, earnings, and estimates |
+| `RV <tickers>` | Relative valuation |
+
+### Markets, News, and Macro
+
+| Shortcut | Function |
+|----------|----------|
+| `TOP` | Ranked market stories |
+| `MOST` | Top gainers, losers, most active, and trending tickers |
+| `N` | News feed |
+| `CN <ticker>` | Ticker news |
+| `NI` | Sector news |
+| `FIRST` | Breaking news |
+| `TWIT <query>` | Ticker-related market posts |
+| `WEI` | Global equity indices |
+| `ECON` | Economic events and releases |
+| `GC` | Yield curve |
+| `ERN` | Earnings calendar |
+| `BI` / `SP` | S&P 500 sector performance |
+| `FXC` | Major FX cross rates |
+| `FNG` | Fear and greed market gauge |
+
+### Workspace and App Controls
+
+| Shortcut | Function |
+|----------|----------|
+| `PF` | Portfolio and watchlist workspace |
+| `PORT` | Portfolio risk and sector exposure |
+| `ALRT` | Price alerts |
+| `SA <symbol condition price>` | Create a price alert |
+| `PM <query>` | Polymarket and Kalshi prediction data |
+| `AI <prompt>` | AI screener |
+| `CHAT [channel]` | Gloom Cloud chat |
+| `DM @user [@user...]` | Open or start a direct or group chat |
+| `ACM` | Gloom Cloud account settings |
+| `TBO` | TheBuildout infrastructure intelligence |
+| `CG` | Congress trading disclosures |
+| `NOTE` | Notes |
+| `IBKR` | IBKR trading pane |
+| `BR` | Broker connections |
+| `CHG` | Changelog |
+| `HELP` | Open shortcut and layout help |
+| `AW` / `AP <ticker>` | Add a ticker to the active watchlist or portfolio |
+| `RW` / `RP <ticker>` | Remove a ticker from the active watchlist or portfolio |
+| `PS` | Open focused pane settings |
+| `LAY <action>` | Open layout actions |
+| `WIN move\|resize` | Move or resize the focused window |
+| `GL` | Gridlock all visible panes |
+| `SB` | Toggle the status bar |
+| `VF` | Toggle quote value flashing |
+| `TH <theme>` | Change color theme |
+| `CR` | Cycle chart renderer |
+| `PL <plugin>` | Manage plugins |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/index.tsx",
   "type": "module",

package/src/api-client/chat.ts

@@ -93,6 +93,14 @@ export class CloudChatApi {
     return normalizeChatMessage(message);
   }
 
+  async editMessage(channelId: string, messageId: string, content: string): Promise<ChatMessage> {
+    const message = await this.options.request<ChatMessage>(`/chat/channels/${channelId}/messages/${messageId}`, {
+      method: "PATCH",
+      body: JSON.stringify({ content }),
+    });
+    return normalizeChatMessage(message);
+  }
+
   connectChannel(
     channelId: string,
     onMessage: (msg: ChatMessage) => void,

package/src/api-client/index.test.ts

@@ -379,6 +379,36 @@ describe("apiClient chat timestamps", () => {
     expect(sentMessage.createdAt).toBe("2026-04-08T07:29:27.625Z");
   });
 
+  test("edits a chat message and normalizes the edit timestamp", async () => {
+    const requests: Array<{ path: string; method: string; body: unknown }> = [];
+    globalThis.fetch = mockFetch(async (input: Request | string | URL, init?: RequestInit) => {
+      requests.push({
+        path: new URL(String(input)).pathname,
+        method: init?.method ?? "GET",
+        body: init?.body ? JSON.parse(String(init.body)) : null,
+      });
+      return createResponse({
+        id: "m2",
+        channelId: "everyone",
+        content: "hello edited",
+        replyToId: null,
+        createdAt: "2026-04-08 07:29:27.625",
+        editedAt: "2026-04-08 07:30:27.625",
+        user: { id: "u1", username: "alice", displayName: "Alice" },
+        replyTo: null,
+      });
+    });
+
+    const editedMessage = await apiClient.editMessage("everyone", "m2", "hello edited");
+
+    expect(requests).toEqual([{
+      path: "/chat/channels/everyone/messages/m2",
+      method: "PATCH",
+      body: { content: "hello edited" },
+    }]);
+    expect(editedMessage.editedAt).toBe("2026-04-08T07:30:27.625Z");
+  });
+
   test("normalizes websocket chat timestamps before notifying listeners", async () => {
     const seenCreatedAts: string[] = [];
     const channel = apiClient.connectChannel("everyone", (message) => {

package/src/api-client/index.ts

@@ -244,6 +244,10 @@ class GloomApiClient {
     return this.chat.sendMessage(channelId, content, replyToId, clientMessageId);
   }
 
+  async editMessage(channelId: string, messageId: string, content: string): Promise<ChatMessage> {
+    return this.chat.editMessage(channelId, messageId, content);
+  }
+
   connectChannel(
     channelId: string,
     onMessage: (msg: ChatMessage) => void,

package/src/api-client/normalizers.ts

@@ -12,6 +12,7 @@ export function normalizeChatMessage(message: ChatMessage): ChatMessage {
   return {
     ...message,
     createdAt: normalizeTimestamp(message.createdAt),
+    ...(message.editedAt ? { editedAt: normalizeTimestamp(message.editedAt) } : {}),
   };
 }
 

package/src/api-client/types.ts

@@ -28,6 +28,7 @@ export interface ChatMessage {
   content: string;
   replyToId: string | null;
   createdAt: string;
+  editedAt?: string | null;
   user: ChatUserSummary;
   replyTo?: { content: string; user: { id?: string; username: string } } | null;
   clientStatus?: "sending" | "failed";

package/src/capabilities/factories.ts

@@ -52,6 +52,10 @@ export function assetDataProvider(provider: AssetDataProvider): AssetDataCapabil
         if (!provider.getEarningsCalendar) throw new Error(`${provider.name} does not provide earnings calendar.`);
         return provider.getEarningsCalendar(input.symbols ?? [], input.context);
       }, "query"),
+      getSecFilingDocuments: op((input: any) => {
+        if (!provider.getSecFilingDocuments) throw new Error(`${provider.name} does not provide SEC filing documents.`);
+        return provider.getSecFilingDocuments(input.filing);
+      }, "query"),
       getSecFilingContent: op((input: any) => {
         if (!provider.getSecFilingContent) throw new Error(`${provider.name} does not provide SEC filing content.`);
         return provider.getSecFilingContent(input.filing);

package/src/components/chart/comparison/data.test.ts

@@ -57,6 +57,60 @@ describe("projectComparisonChartData", () => {
     expect(projection.series[1]?.points.map((point) => point.rawValue)).toEqual([null, null, 20, 22]);
   });
 
+  test("carries the latest series value across shared timestamps from other markets", () => {
+    const projection = projectComparisonChartData([
+      makeSeries("DAX", "EUR", [
+        ["2024-01-02T08:00:00.000Z", 100],
+        ["2024-01-02T08:15:00.000Z", 101],
+        ["2024-01-03T08:00:00.000Z", 102],
+      ]),
+      makeSeries("AAPL", "USD", [
+        ["2024-01-02T14:30:00.000Z", 200],
+        ["2024-01-02T14:45:00.000Z", 201],
+      ]),
+    ], 8, {
+      panOffset: 0,
+      zoomLevel: 1,
+      renderMode: "line",
+    }, "price");
+
+    expect(projection.dates.map((date) => date.toISOString())).toEqual([
+      "2024-01-02T08:00:00.000Z",
+      "2024-01-02T08:15:00.000Z",
+      "2024-01-02T14:30:00.000Z",
+      "2024-01-02T14:45:00.000Z",
+      "2024-01-03T08:00:00.000Z",
+    ]);
+    expect(projection.series[0]?.points.map((point) => point.rawValue)).toEqual([100, 101, 101, 101, 102]);
+    expect(projection.series[1]?.points.map((point) => point.rawValue)).toEqual([null, null, 200, 201, 201]);
+  });
+
+  test("uses the same alternating close bucket selection as stock chart projection", () => {
+    const projection = projectComparisonChartData([
+      makeSeries("DAX", "EUR", [
+        ["2024-01-02T08:00:00.000Z", 100],
+        ["2024-01-02T08:15:00.000Z", 105],
+        ["2024-01-02T14:30:00.000Z", 101],
+        ["2024-01-02T14:45:00.000Z", 99],
+      ]),
+      makeSeries("AAPL", "USD", [
+        ["2024-01-02T14:30:00.000Z", 200],
+        ["2024-01-02T14:45:00.000Z", 201],
+      ]),
+    ], 2, {
+      panOffset: 0,
+      zoomLevel: 1,
+      renderMode: "line",
+    }, "price");
+
+    expect(projection.dates.map((date) => date.toISOString())).toEqual([
+      "2024-01-02T08:15:00.000Z",
+      "2024-01-02T14:45:00.000Z",
+    ]);
+    expect(projection.series[0]?.points.map((point) => point.rawValue)).toEqual([105, 99]);
+    expect(projection.series[1]?.points.map((point) => point.rawValue)).toEqual([null, 200]);
+  });
+
   test("normalizes percent mode from each series first visible point", () => {
     const projection = projectComparisonChartData([
       makeSeries("AAPL", "USD", [

package/src/components/chart/comparison/data.ts

@@ -7,6 +7,11 @@ import type {
 } from "../core/types";
 import { buildVisibleDateWindowFromRange } from "../core/date-window";
 import { getVisiblePointCount } from "../core/viewport";
+import {
+  buildIndexProjectionBuckets,
+  selectRepresentativeCloseValue,
+  type IndexProjectionBucket,
+} from "../core/projection";
 
 export interface ComparisonProjectedPoint {
   date: Date;
@@ -38,6 +43,14 @@ interface ComparisonAxisModeResolution {
   warning: string | null;
 }
 
+type ComparisonWindowViewState =
+  Pick<ComparisonChartViewState, "panOffset" | "zoomLevel">
+  & Partial<Pick<ComparisonChartViewState, "dateWindow">>;
+
+type ComparisonProjectionViewState =
+  ComparisonWindowViewState
+  & Pick<ComparisonChartViewState, "renderMode">;
+
 export interface ComparisonChartProjection {
   dates: Date[];
   series: ComparisonProjectedSeries[];
@@ -92,7 +105,7 @@ export function getMaxComparisonPanOffset(
 
 export function getVisibleComparisonWindow(
   series: ComparisonChartSeries[],
-  viewState: Pick<ComparisonChartViewState, "dateWindow" | "panOffset" | "zoomLevel">,
+  viewState: ComparisonWindowViewState,
 ): ComparisonVisibleWindow {
   const dates = getUniqueSortedDates(series);
 
@@ -138,10 +151,7 @@ function transformRawValue(rawValue: number | null, axisMode: ChartAxisMode, bas
 }
 
 function resolveRepresentativeValue(values: number[], index: number): number {
-  if (values.length === 1) return values[0]!;
-  return index % 2 === 0
-    ? Math.max(...values)
-    : Math.min(...values);
+  return selectRepresentativeCloseValue(values, index, (value) => value);
 }
 
 function buildSeriesMap(points: PricePoint[]): Map<number, number> {
@@ -155,6 +165,28 @@ function buildSeriesMap(points: PricePoint[]): Map<number, number> {
   return map;
 }
 
+function buildFilledRawValuesByDate(
+  rawByDate: ReadonlyMap<number, number>,
+  dates: readonly Date[],
+): Array<number | null> {
+  let latestRawValue: number | null = null;
+  return dates.map((date) => {
+    const timestamp = date.getTime();
+    if (rawByDate.has(timestamp)) {
+      latestRawValue = rawByDate.get(timestamp)!;
+      return latestRawValue;
+    }
+    return latestRawValue;
+  });
+}
+
+function getBucketDate(
+  dates: readonly Date[],
+  bucket: IndexProjectionBucket,
+): Date {
+  return dates[Math.max(bucket.end - 1, 0)] ?? dates[dates.length - 1] ?? new Date(0);
+}
+
 function resolveComparisonAxisMode(
   requestedAxisMode: ChartAxisMode,
   series: ComparisonChartSeries[],
@@ -194,7 +226,7 @@ function resolveComparisonAxisMode(
 export function projectComparisonChartData(
   series: ComparisonChartSeries[],
   chartWidth: number,
-  viewState: Pick<ComparisonChartViewState, "dateWindow" | "panOffset" | "zoomLevel" | "renderMode">,
+  viewState: ComparisonProjectionViewState,
   requestedAxisMode: ChartAxisMode,
 ): ComparisonChartProjection {
   const normalizedSeries = series.map((entry) => ({ ...entry, points: normalizeSeriesPoints(entry.points) }));
@@ -221,31 +253,26 @@ export function projectComparisonChartData(
       warning: axisResolution.warning,
     };
   }
-  const bucketCount = Math.min(Math.max(chartWidth, 1), Math.max(window.dates.length, 1));
-  const bucketSize = window.dates.length > 0 ? window.dates.length / bucketCount : 1;
+  const buckets = buildIndexProjectionBuckets(window.dates.length, chartWidth);
 
   const projectedSeries = normalizedSeries.map((entry) => {
     const rawByDate = buildSeriesMap(entry.points);
-    const visibleRawValues = window.dates
-      .map((date) => rawByDate.get(date.getTime()) ?? null)
+    const filledRawValues = buildFilledRawValuesByDate(rawByDate, window.dates);
+    const visibleRawValues = filledRawValues
       .filter((value): value is number => value !== null);
     const baseValue = visibleRawValues[0] ?? null;
     const latestRawValue = visibleRawValues[visibleRawValues.length - 1] ?? null;
 
-    const points = Array.from({ length: bucketCount }, (_, index) => {
-      const start = Math.floor(index * bucketSize);
-      const end = Math.min(window.dates.length, Math.max(Math.floor((index + 1) * bucketSize), start + 1));
-      const bucketDates = window.dates.slice(start, end);
-      const date = bucketDates[bucketDates.length - 1] ?? window.dates[window.dates.length - 1] ?? new Date(0);
-      const bucketRawValues = bucketDates
-        .map((bucketDate) => rawByDate.get(bucketDate.getTime()) ?? null)
+    const points = buckets.map((bucket) => {
+      const bucketRawValues = filledRawValues
+        .slice(bucket.start, bucket.end)
         .filter((value): value is number => value !== null);
       const rawValue = bucketRawValues.length > 0
-        ? resolveRepresentativeValue(bucketRawValues, index)
+        ? resolveRepresentativeValue(bucketRawValues, bucket.index)
         : null;
 
       return {
-        date,
+        date: getBucketDate(window.dates, bucket),
         rawValue,
         value: transformRawValue(rawValue, axisResolution.effectiveAxisMode, baseValue),
       };
@@ -264,11 +291,7 @@ export function projectComparisonChartData(
   });
 
   return {
-    dates: Array.from({ length: bucketCount }, (_, index) => {
-      const start = Math.floor(index * bucketSize);
-      const end = Math.min(window.dates.length, Math.max(Math.floor((index + 1) * bucketSize), start + 1));
-      return window.dates[Math.max(end - 1, 0)] ?? new Date(0);
-    }),
+    dates: buckets.map((bucket) => getBucketDate(window.dates, bucket)),
     series: projectedSeries,
     requestedMode,
     effectiveMode: requestedMode,

package/src/components/chart/core/projection.ts

@@ -24,6 +24,12 @@ export interface ProjectChartDataOptions {
   sourceIndexOffset?: number;
 }
 
+export interface IndexProjectionBucket {
+  index: number;
+  start: number;
+  end: number;
+}
+
 interface StableOhlcProjectionOptionsInput {
   pointCount: number;
   sourceIndexOffset: number;
@@ -131,6 +137,44 @@ function aggregateOhlcBucket(bucket: readonly ProjectedChartPoint[]): ProjectedC
   };
 }
 
+export function buildIndexProjectionBuckets(
+  itemCount: number,
+  targetWidth: number,
+): IndexProjectionBucket[] {
+  const normalizedItemCount = Math.max(Math.floor(itemCount), 0);
+  if (normalizedItemCount === 0) return [];
+
+  const bucketCount = Math.min(normalizedItemCount, Math.max(Math.floor(targetWidth), 1));
+  const bucketSize = normalizedItemCount / bucketCount;
+
+  return Array.from({ length: bucketCount }, (_, index) => {
+    const start = Math.floor(index * bucketSize);
+    const end = Math.min(
+      normalizedItemCount,
+      Math.max(Math.floor((index + 1) * bucketSize), start + 1),
+    );
+    return { index, start, end };
+  });
+}
+
+export function selectRepresentativeCloseValue<T>(
+  bucket: readonly T[],
+  index: number,
+  getClose: (item: T) => number,
+): T {
+  let best = bucket[0] as T;
+  if (index % 2 === 0) {
+    for (const item of bucket) {
+      if (getClose(item) > getClose(best)) best = item;
+    }
+  } else {
+    for (const item of bucket) {
+      if (getClose(item) < getClose(best)) best = item;
+    }
+  }
+  return best;
+}
+
 function bucketOhlcBySourceIndex(
   normalizedPoints: readonly ProjectedChartPoint[],
   bucketSize: number,
@@ -202,33 +246,13 @@ function projectCloseSeries(
   targetWidth: number,
 ): ProjectedChartPoint[] {
   if (points.length === 0) return [];
-  if (points.length <= targetWidth) return points.map(normalizePoint);
-
-  const result: ProjectedChartPoint[] = [];
-  const bucketSize = points.length / targetWidth;
-
-  for (let i = 0; i < targetWidth; i++) {
-    const start = Math.floor(i * bucketSize);
-    const end = Math.min(points.length, Math.max(Math.floor((i + 1) * bucketSize), start + 1));
-    const bucket = points.slice(start, end);
-
-    if (bucket.length === 0) continue;
-
-    // Alternate bucket extremes to preserve line/area shape after downsampling.
-    let best = bucket[0]!;
-    if (i % 2 === 0) {
-      for (const point of bucket) {
-        if (point.close > best.close) best = point;
-      }
-    } else {
-      for (const point of bucket) {
-        if (point.close < best.close) best = point;
-      }
-    }
-    result.push(normalizePoint(best));
-  }
-
-  return result;
+  return buildIndexProjectionBuckets(points.length, targetWidth).map((bucket) => (
+    normalizePoint(selectRepresentativeCloseValue(
+      points.slice(bucket.start, bucket.end),
+      bucket.index,
+      (point) => point.close,
+    ))
+  ));
 }
 
 /**

package/src/components/data-table/stack-view.test.tsx

@@ -67,18 +67,18 @@ function Harness() {
             )
           }
           detailTitle={openRow?.title}
-          selectedIndex={selectedIndex}
-          onSelectIndex={(index) => setSelectedIndex(index)}
-          onActivateIndex={(_index, row) => setOpenRow(row)}
+          selection={{
+            kind: "index",
+            selectedIndex,
+            onChange: (index) => setSelectedIndex(index),
+          }}
+          onActivate={(row) => setOpenRow(row)}
           columns={columns}
           items={rows}
           sortColumnId={null}
           sortDirection="asc"
           onHeaderClick={() => {}}
           getItemKey={(row) => row.id}
-          isSelected={(_row, index) => index === selectedIndex}
-          onSelect={(_row, index) => setSelectedIndex(index)}
-          onActivate={(row) => setOpenRow(row)}
           renderCell={(row): DataTableCell => ({ text: row.title })}
           emptyStateTitle="No rows"
           showHorizontalScrollbar={false}
@@ -90,13 +90,14 @@ function Harness() {
 
 function GroupedHarness() {
   const [selectedIndex, setSelectedIndex] = useState(0);
+  const [cursorIndex, setCursorIndex] = useState(0);
   const state = createInitialState(
     createDefaultConfig("/tmp/gloomberb-data-table-stack-view-grouped-test"),
   );
   const columns: Column[] = [
     { id: "title", label: "Title", width: 20, align: "left" },
   ];
-  const selectedTitle = groupedRows[selectedIndex]?.title ?? "none";
+  const selectedTitle = groupedRows[cursorIndex]?.title ?? "none";
 
   return (
     <AppContext value={{ state, dispatch: () => {} }}>
@@ -106,8 +107,12 @@ function GroupedHarness() {
           detailOpen={false}
           onBack={() => {}}
           detailContent={<Box flexGrow={1} />}
-          selectedIndex={selectedIndex}
-          onSelectIndex={(index) => setSelectedIndex(index)}
+          selection={{
+            kind: "index",
+            selectedIndex,
+            onChange: (index) => setSelectedIndex(index),
+          }}
+          onCursorChange={(_row, index) => setCursorIndex(index)}
           isNavigable={(row) => row.type !== "section"}
           rootAfter={
             <Box height={1}>
@@ -120,8 +125,6 @@ function GroupedHarness() {
           sortDirection="asc"
           onHeaderClick={() => {}}
           getItemKey={(row) => row.id}
-          isSelected={(_row, index) => index === selectedIndex}
-          onSelect={(_row, index) => setSelectedIndex(index)}
           renderSectionHeader={(row) => row.type === "section"
             ? { text: row.title }
             : null}

package/src/components/data-table/stack-view.tsx

@@ -10,13 +10,12 @@ import { PageStackView, type DataTableColumn } from "../ui";
 export interface DataTableStackViewProps<
   T,
   C extends DataTableColumn = DataTableColumn,
-> extends Omit<DataTableViewProps<T, C>, "focused" | "selectedIndex"> {
+> extends Omit<DataTableViewProps<T, C>, "focused"> {
   focused: boolean;
   detailOpen: boolean;
   onBack: () => void;
   detailContent: ReactNode;
   detailTitle?: string;
-  selectedIndex: number;
   onDetailKeyDown?: (event: DataTableKeyEvent) => boolean | void;
 }