gloomberb 0.4.1 → 0.5.0

package/src/theme/themes.ts

@@ -17,6 +17,7 @@ export interface Theme {
   positive: string;
   negative: string;
   neutral: string;
+  warning: string;
 
   header: string;
   headerText: string;
@@ -79,6 +80,12 @@ function normalizeTheme(theme: Theme): Theme {
     highestMinimumContrast(bodySurfaces, [textDim, text, "#c0c7d1"]),
     SUBTLE_TEXT_MIN,
   );
+  const warning = blendForContrastOnSurfaces(
+    theme.warning,
+    bodySurfaces,
+    blendHex(theme.warning, theme.textBright, 0.5),
+    SUBTLE_TEXT_MIN,
+  );
   const selected = blendForContrastOnSurfaces(
     theme.selected,
     bodySurfaces,
@@ -106,6 +113,7 @@ function normalizeTheme(theme: Theme): Theme {
     positive,
     negative,
     neutral,
+    warning,
     headerText,
     selected,
     selectedText,
@@ -127,6 +135,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#888888",
+    warning: "#ffaa00",
     header: "#0044aa",
     headerText: "#ffffff",
     selected: "#1a3a5c",
@@ -149,6 +158,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00ff66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#cccc00",
     header: "#003300",
     headerText: "#00ff00",
     selected: "#003300",
@@ -171,6 +181,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00ff88",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddcc00",
     header: "#002222",
     headerText: "#00ffff",
     selected: "#002a2a",
@@ -193,6 +204,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44cc44",
     negative: "#ff6666",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#220000",
     headerText: "#ff3333",
     selected: "#2a0000",
@@ -215,6 +227,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#000033",
     headerText: "#4488ff",
     selected: "#001144",
@@ -237,6 +250,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44dd66",
     negative: "#ff4444",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#1a0028",
     headerText: "#bb55ff",
     selected: "#220033",
@@ -259,6 +273,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#44dd66",
     negative: "#ff5555",
     neutral: "#666666",
+    warning: "#ddaa00",
     header: "#22000f",
     headerText: "#ff44aa",
     selected: "#2a0018",
@@ -281,6 +296,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#888888",
+    warning: "#ddaa00",
     header: "#1a1a1a",
     headerText: "#ffffff",
     selected: "#222222",
@@ -303,6 +319,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#9ece6a",
     negative: "#f7768e",
     neutral: "#565f89",
+    warning: "#e0af68",
     header: "#24283b",
     headerText: "#7aa2f7",
     selected: "#283457",
@@ -325,6 +342,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#859900",
     negative: "#dc322f",
     neutral: "#657b83",
+    warning: "#b58900",
     header: "#073642",
     headerText: "#268bd2",
     selected: "#0a4a5c",
@@ -347,6 +365,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#50fa7b",
     negative: "#ff5555",
     neutral: "#6272a4",
+    warning: "#f1fa8c",
     header: "#44475a",
     headerText: "#bd93f9",
     selected: "#44475a",
@@ -369,6 +388,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a3be8c",
     negative: "#bf616a",
     neutral: "#4c566a",
+    warning: "#ebcb8b",
     header: "#3b4252",
     headerText: "#88c0d0",
     selected: "#4c566a",
@@ -391,6 +411,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a6e22e",
     negative: "#f92672",
     neutral: "#75715e",
+    warning: "#e6db74",
     header: "#49483e",
     headerText: "#e6db74",
     selected: "#49483e",
@@ -413,6 +434,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#a6e3a1",
     negative: "#f38ba8",
     neutral: "#6c7086",
+    warning: "#f9e2af",
     header: "#313244",
     headerText: "#cba6f7",
     selected: "#3e3f56",
@@ -435,6 +457,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#b8bb26",
     negative: "#fb4934",
     neutral: "#928374",
+    warning: "#fabd2f",
     header: "#3c3836",
     headerText: "#fabd2f",
     selected: "#3c3836",
@@ -457,6 +480,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#31748f",
     negative: "#eb6f92",
     neutral: "#6e6a86",
+    warning: "#f6c177",
     header: "#26233a",
     headerText: "#c4a7e7",
     selected: "#332f4a",
@@ -479,6 +503,7 @@ const rawThemes: Record<string, Theme> = {
     positive: "#00cc66",
     negative: "#ff3333",
     neutral: "#6688bb",
+    warning: "#ff9900",
     header: "#001144",
     headerText: "#ff6600",
     selected: "#002255",

package/src/types/config.test.ts

@@ -0,0 +1,107 @@
+import { describe, expect, test } from "bun:test";
+import {
+  createPaneInstance,
+  findPrimaryPaneInstance,
+  resolveFollowBindingInstance,
+  resolvePaneInstance,
+  type LayoutConfig,
+  type PaneInstanceConfig,
+} from "./config";
+
+function createLayout(instances: PaneInstanceConfig[]): LayoutConfig {
+  return {
+    dockRoot: null,
+    instances,
+    floating: [],
+  };
+}
+
+describe("findPrimaryPaneInstance", () => {
+  test("prefers the main non-fixed ticker pane", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:pinned",
+        binding: { kind: "fixed", symbol: "AAPL" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:main",
+        binding: { kind: "follow", sourceInstanceId: "portfolio-list:main" },
+      }),
+    ]);
+
+    expect(findPrimaryPaneInstance(layout, "ticker-detail")?.instanceId).toBe("ticker-detail:main");
+  });
+
+  test("does not treat fixed ticker panes as the primary pane", () => {
+    const layout = createLayout([
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:aapl",
+        binding: { kind: "fixed", symbol: "AAPL" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:msft",
+        binding: { kind: "fixed", symbol: "MSFT" },
+      }),
+    ]);
+
+    expect(findPrimaryPaneInstance(layout, "ticker-detail")).toBeUndefined();
+  });
+});
+
+describe("resolvePaneInstance", () => {
+  test("accepts either an instance id or a pane id", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+    ]);
+
+    expect(resolvePaneInstance(layout, "portfolio-list:main")?.instanceId).toBe("portfolio-list:main");
+    expect(resolvePaneInstance(layout, "portfolio-list")?.instanceId).toBe("portfolio-list:main");
+  });
+});
+
+describe("resolveFollowBindingInstance", () => {
+  test("walks follow bindings until it finds a matching pane", () => {
+    const layout = createLayout([
+      createPaneInstance("portfolio-list", {
+        instanceId: "portfolio-list:main",
+        binding: { kind: "none" },
+      }),
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:main",
+        binding: { kind: "follow", sourceInstanceId: "portfolio-list:main" },
+      }),
+      createPaneInstance("quote-monitor", {
+        instanceId: "quote-monitor:main",
+        binding: { kind: "follow", sourceInstanceId: "ticker-detail:main" },
+      }),
+    ]);
+
+    expect(
+      resolveFollowBindingInstance(layout, "quote-monitor:main", (instance) => instance.paneId === "portfolio-list")?.instanceId,
+    ).toBe("portfolio-list:main");
+  });
+
+  test("stops on follow cycles", () => {
+    const layout = createLayout([
+      createPaneInstance("ticker-detail", {
+        instanceId: "ticker-detail:first",
+        binding: { kind: "follow", sourceInstanceId: "quote-monitor:first" },
+      }),
+      createPaneInstance("quote-monitor", {
+        instanceId: "quote-monitor:first",
+        binding: { kind: "follow", sourceInstanceId: "ticker-detail:first" },
+      }),
+    ]);
+
+    expect(
+      resolveFollowBindingInstance(layout, "ticker-detail:first", (instance) => instance.paneId === "portfolio-list"),
+    ).toBeUndefined();
+  });
+});

package/src/types/config.ts

@@ -179,7 +179,7 @@ export const DEFAULT_LAYOUT: LayoutConfig = {
         hideTabs: false,
         lockedTabId: "overview",
         chartRangePreset: "5Y",
-        chartResolution: "1wk",
+        chartResolution: "auto",
       },
       binding: { kind: "follow", sourceInstanceId: "portfolio-list:main" },
     },
@@ -317,6 +317,35 @@ export function isFixedTickerPane(instance: PaneInstanceConfig): boolean {
   return isTickerPaneInstance(instance) && instance.binding?.kind === "fixed";
 }
 
+export function findPrimaryPaneInstance(layout: LayoutConfig, paneId: string): PaneInstanceConfig | undefined {
+  const instances = layout.instances.filter((instance) => instance.paneId === paneId);
+  if (instances.length === 0) return undefined;
+  if (!isTickerPaneId(paneId)) return instances[0];
+  return instances.find((instance) => instance.instanceId === `${paneId}:main` && instance.binding?.kind !== "fixed")
+    ?? instances.find((instance) => instance.binding?.kind !== "fixed");
+}
+
+export function resolvePaneInstance(layout: LayoutConfig, paneIdOrInstanceId: string): PaneInstanceConfig | undefined {
+  return findPaneInstance(layout, paneIdOrInstanceId) ?? findPrimaryPaneInstance(layout, paneIdOrInstanceId);
+}
+
+export function resolveFollowBindingInstance(
+  layout: LayoutConfig,
+  paneIdOrInstanceId: string | null | undefined,
+  matcher: (instance: PaneInstanceConfig) => boolean,
+  seen = new Set<string>(),
+): PaneInstanceConfig | undefined {
+  if (!paneIdOrInstanceId) return undefined;
+  const instance = resolvePaneInstance(layout, paneIdOrInstanceId);
+  if (!instance || seen.has(instance.instanceId)) return undefined;
+  seen.add(instance.instanceId);
+  if (matcher(instance)) return instance;
+  if (instance.binding?.kind === "follow") {
+    return resolveFollowBindingInstance(layout, instance.binding.sourceInstanceId, matcher, seen);
+  }
+  return undefined;
+}
+
 export function createPaneInstance(
   paneId: string,
   options: Partial<PaneInstanceConfig> = {},

package/src/types/data-provider.ts

@@ -26,6 +26,18 @@ export interface SecFilingItem {
   primaryDocumentUrl?: string;
 }
 
+export interface EarningsEvent {
+  symbol: string;
+  name: string;
+  earningsDate: Date;
+  epsEstimate: number | null;
+  epsActual: number | null;
+  revenueEstimate: number | null;
+  revenueActual: number | null;
+  surprise: number | null;
+  timing: "BMO" | "AMC" | "TNS" | "";
+}
+
 export interface MarketDataRequestContext {
   brokerId?: string;
   brokerInstanceId?: string;
@@ -68,6 +80,7 @@ export interface DataProvider {
   search(query: string, context?: SearchRequestContext): Promise<InstrumentSearchResult[]>;
   getNews(ticker: string, count?: number, exchange?: string, context?: MarketDataRequestContext): Promise<NewsItem[]>;
   getSecFilings?(ticker: string, count?: number, exchange?: string, context?: MarketDataRequestContext): Promise<SecFilingItem[]>;
+  getEarningsCalendar?(symbols: string[], context?: MarketDataRequestContext): Promise<EarningsEvent[]>;
   getSecFilingContent?(filing: SecFilingItem): Promise<string | null>;
   /** Fetch article summary/description by URL (lazy-loaded on selection) */
   getArticleSummary(url: string): Promise<string | null>;

package/src/types/plugin.ts

@@ -169,6 +169,19 @@ export interface WizardStep {
   body?: string[];
 }
 
+export interface CommandShortcutArgContext {
+  activeTicker: string | null;
+}
+
+export interface CommandShortcutArgDef {
+  placeholder?: string;
+  kind?: "text" | "ticker" | "ticker-list";
+  parse?: (
+    arg: string,
+    context: CommandShortcutArgContext,
+  ) => Record<string, string>;
+}
+
 export interface CliHelpColumn {
   header: string;
   align?: "left" | "right" | "center";
@@ -243,6 +256,7 @@ export interface CommandDef {
   label: string;
   keywords: string[];
   shortcut?: string;
+  shortcutArg?: CommandShortcutArgDef;
   execute: (values?: Record<string, string>) => void | Promise<void>;
   category: "navigation" | "data" | "portfolio" | "config";
   description?: string;
@@ -355,6 +369,25 @@ export interface PluginPaneSettingsState {
   delete(paneId: string, key: string): Promise<void>;
 }
 
+export type AppNotificationType = "info" | "success" | "error";
+export type AppDesktopNotificationMode = "never" | "when-inactive" | "always";
+
+export interface AppNotificationRequest {
+  title?: string;
+  body: string;
+  subtitle?: string;
+  duration?: number;
+  type?: AppNotificationType;
+  toast?: boolean;
+  desktop?: AppDesktopNotificationMode;
+  persistent?: boolean;
+  sound?: string;
+  action?: {
+    label: string;
+    onClick: () => void;
+  };
+}
+
 export interface GloomPluginContext {
   registerPane(pane: PaneDef): void;
   registerPaneTemplate(template: PaneTemplateDef): void;
@@ -392,6 +425,7 @@ export interface GloomPluginContext {
   hidePane(paneId: string): void;
   focusPane(paneId: string): void;
   pinTicker(symbol: string, options?: { floating?: boolean; paneType?: string }): void;
+  navigateTicker(symbol: string): void;
   openPaneSettings(paneId?: string): void;
 
   on<K extends keyof PluginEvents>(event: K, handler: (payload: PluginEvents[K]) => void): () => void;
@@ -399,7 +433,7 @@ export interface GloomPluginContext {
 
   showWidget(widgetId: string): void;
   hideWidget(widgetId: string): void;
-  showToast(message: string, options?: { duration?: number; type?: "info" | "success" | "error" }): void;
+  notify(notification: AppNotificationRequest): void;
 }
 
 export interface GloomPlugin {

package/src/utils/format.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { formatTimeAgo } from "./format";
+import { displayWidth, formatTimeAgo, padTo } from "./format";
 
 describe("formatTimeAgo", () => {
   test("handles UTC ISO timestamps with explicit offsets", () => {
@@ -12,3 +12,13 @@ describe("formatTimeAgo", () => {
     expect(formatTimeAgo(fiveMinutesAgo)).toBe("5m ago");
   });
 });
+
+describe("padTo", () => {
+  test("pads and truncates by display width instead of UTF-16 length", () => {
+    expect(displayWidth("🇺🇸")).toBe(2);
+    expect(padTo("🇺🇸", 2)).toBe("🇺🇸");
+    expect(padTo("🇺🇸", 3)).toBe("🇺🇸 ");
+    expect(padTo("🇺🇸", 1)).toBe(" ");
+    expect(padTo("🇺🇸 CPI", 6)).toBe("🇺🇸 CPI");
+  });
+});

package/src/utils/format.ts

@@ -116,17 +116,95 @@ export function formatWithDivisor(value: number | undefined, divisor: number): s
   return scaled.toFixed(decimals);
 }
 
-/** Pad/truncate a string to a fixed width */
+const COMBINING_MARK_RE = /\p{Mark}/u;
+const EMOJI_PRESENTATION_RE = /\p{Emoji_Presentation}/u;
+const EXTENDED_PICTOGRAPHIC_RE = /\p{Extended_Pictographic}/u;
+const REGIONAL_INDICATOR_RE = /\p{Regional_Indicator}/u;
+
+function segmentGraphemes(value: string): string[] {
+  const Segmenter = (Intl as any).Segmenter;
+  if (typeof Segmenter === "function") {
+    return Array.from(
+      new Segmenter(undefined, { granularity: "grapheme" }).segment(value),
+      (entry: any) => entry.segment as string,
+    );
+  }
+  return Array.from(value);
+}
+
+function isFullwidthCodePoint(codePoint: number): boolean {
+  return codePoint >= 0x1100 && (
+    codePoint <= 0x115f ||
+    codePoint === 0x2329 ||
+    codePoint === 0x232a ||
+    (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+    (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+    (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+    (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+    (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+    (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+    (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+    (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||
+    (codePoint >= 0x20000 && codePoint <= 0x3fffd)
+  );
+}
+
+function graphemeWidth(segment: string): number {
+  if (
+    REGIONAL_INDICATOR_RE.test(segment) ||
+    EMOJI_PRESENTATION_RE.test(segment) ||
+    EXTENDED_PICTOGRAPHIC_RE.test(segment)
+  ) {
+    return 2;
+  }
+
+  let width = 0;
+  for (const char of Array.from(segment)) {
+    const codePoint = char.codePointAt(0) ?? 0;
+    if (
+      codePoint === 0 ||
+      codePoint < 32 ||
+      (codePoint >= 0x7f && codePoint < 0xa0) ||
+      codePoint === 0x200d ||
+      (codePoint >= 0xfe00 && codePoint <= 0xfe0f) ||
+      COMBINING_MARK_RE.test(char)
+    ) {
+      continue;
+    }
+    width += isFullwidthCodePoint(codePoint) ? 2 : 1;
+  }
+  return width;
+}
+
+export function displayWidth(value: string): number {
+  return segmentGraphemes(value).reduce((total, segment) => total + graphemeWidth(segment), 0);
+}
+
+function truncateToWidth(value: string, width: number): string {
+  if (width <= 0) return "";
+  let output = "";
+  let used = 0;
+  for (const segment of segmentGraphemes(value)) {
+    const nextWidth = graphemeWidth(segment);
+    if (used + nextWidth > width) break;
+    output += segment;
+    used += nextWidth;
+  }
+  return output;
+}
+
+/** Pad/truncate a string to a fixed display width */
 export function padTo(str: string, width: number, align: "left" | "right" | "center" = "left"): string {
-  if (str.length > width) return str.slice(0, width);
-  if (align === "right") return str.padStart(width);
+  const clipped = displayWidth(str) > width ? truncateToWidth(str, width) : str;
+  const clippedWidth = displayWidth(clipped);
+  const padding = Math.max(0, width - clippedWidth);
+  if (align === "right") return " ".repeat(padding) + clipped;
   if (align === "center") {
-    const totalPadding = width - str.length;
-    const leftPadding = Math.floor(totalPadding / 2);
-    const rightPadding = totalPadding - leftPadding;
-    return " ".repeat(leftPadding) + str + " ".repeat(rightPadding);
+    const leftPadding = Math.floor(padding / 2);
+    const rightPadding = padding - leftPadding;
+    return " ".repeat(leftPadding) + clipped + " ".repeat(rightPadding);
   }
-  return str.padEnd(width);
+  return clipped + " ".repeat(padding);
 }
 
 /** Convert a value from one currency to base currency using cached exchange rates */

package/src/utils/inline-content-tokenizer.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, test } from "bun:test";
+import { tokenizeInlineContent } from "./inline-content-tokenizer";
+
+describe("tokenizeInlineContent", () => {
+  test("returns mixed text, link, and ticker tokens in one pass", () => {
+    expect(tokenizeInlineContent("Read https://example.com then watch $NVDA")).toEqual([
+      { kind: "text", value: "Read " },
+      { kind: "link", value: "https://example.com", url: "https://example.com" },
+      { kind: "text", value: " then watch " },
+      { kind: "ticker", value: "$NVDA", symbol: "NVDA" },
+    ]);
+  });
+
+  test("does not split ticker-like text out of links", () => {
+    expect(tokenizeInlineContent("Read https://example.com/$TSLA before $NVDA")).toEqual([
+      { kind: "text", value: "Read " },
+      { kind: "link", value: "https://example.com/$TSLA", url: "https://example.com/$TSLA" },
+      { kind: "text", value: " before " },
+      { kind: "ticker", value: "$NVDA", symbol: "NVDA" },
+    ]);
+  });
+});

package/src/utils/inline-content-tokenizer.ts

@@ -0,0 +1,76 @@
+import { tokenizeInlineLinks } from "./link-tokenizer";
+
+export interface InlineContentTextToken {
+  kind: "text";
+  value: string;
+}
+
+export interface InlineContentLinkToken {
+  kind: "link";
+  value: string;
+  url: string;
+}
+
+export interface InlineContentTickerToken {
+  kind: "ticker";
+  value: string;
+  symbol: string;
+}
+
+export type InlineContentToken =
+  | InlineContentTextToken
+  | InlineContentLinkToken
+  | InlineContentTickerToken;
+
+const TICKER_TOKEN_RE = /\$[A-Z][A-Z0-9.-]{0,9}/g;
+const SYMBOL_CHAR_RE = /[A-Za-z0-9.-]/;
+
+function trimTrailingTickerPunctuation(value: string): string {
+  let trimmed = value;
+  while (trimmed.length > 2 && /[.-]$/.test(trimmed)) {
+    trimmed = trimmed.slice(0, -1);
+  }
+  return trimmed;
+}
+
+function isValidTickerBoundary(text: string, start: number, end: number): boolean {
+  const prev = start > 0 ? text[start - 1] : "";
+  const next = end < text.length ? text[end] : "";
+  return !SYMBOL_CHAR_RE.test(prev) && !SYMBOL_CHAR_RE.test(next);
+}
+
+export function tokenizeInlineContent(text: string): InlineContentToken[] {
+  const tokens: InlineContentToken[] = [];
+
+  for (const segment of tokenizeInlineLinks(text)) {
+    if (segment.kind === "link") {
+      tokens.push(segment);
+      continue;
+    }
+
+    let cursor = 0;
+    let match: RegExpExecArray | null;
+
+    TICKER_TOKEN_RE.lastIndex = 0;
+    while ((match = TICKER_TOKEN_RE.exec(segment.value)) !== null) {
+      const rawValue = match[0];
+      const start = match.index;
+      const rawEnd = start + rawValue.length;
+      const value = trimTrailingTickerPunctuation(rawValue);
+      const end = start + value.length;
+      if (!isValidTickerBoundary(segment.value, start, rawEnd)) continue;
+
+      if (start > cursor) {
+        tokens.push({ kind: "text", value: segment.value.slice(cursor, start) });
+      }
+      tokens.push({ kind: "ticker", value, symbol: value.slice(1) });
+      cursor = end;
+    }
+
+    if (cursor < segment.value.length) {
+      tokens.push({ kind: "text", value: segment.value.slice(cursor) });
+    }
+  }
+
+  return tokens;
+}

package/src/utils/link-tokenizer.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, test } from "bun:test";
+import { tokenizeInlineLinks } from "./link-tokenizer";
+
+describe("tokenizeInlineLinks", () => {
+  test("extracts http links and preserves surrounding text", () => {
+    expect(tokenizeInlineLinks("Read https://example.com/story now")).toEqual([
+      { kind: "text", value: "Read " },
+      { kind: "link", value: "https://example.com/story", url: "https://example.com/story" },
+      { kind: "text", value: " now" },
+    ]);
+  });
+
+  test("drops trailing punctuation from the link token", () => {
+    expect(tokenizeInlineLinks("See https://example.com/story.)")).toEqual([
+      { kind: "text", value: "See " },
+      { kind: "link", value: "https://example.com/story", url: "https://example.com/story" },
+      { kind: "text", value: ".)" },
+    ]);
+  });
+
+  test("normalizes www links for opening", () => {
+    expect(tokenizeInlineLinks("Visit www.example.com/test")).toEqual([
+      { kind: "text", value: "Visit " },
+      { kind: "link", value: "www.example.com/test", url: "https://www.example.com/test" },
+    ]);
+  });
+});