pi-one-ui 0.1.1

package/extensions/transcript/renderer/mouse/layout.ts

@@ -0,0 +1,207 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { ThinkingPreviewBlock } from "../../../features/compact-thinking.ts";
+import { isCompactAssistantComponent } from "../compact-mode.ts";
+import { ToolGroupComponent } from "../tool/grouping.ts";
+import { isMessageDisplayComponent } from "../tool/message-display.ts";
+import {
+  isToolExecutionComponent,
+  stripTerminalSequencesPreservingLayout,
+} from "./packets.ts";
+import { getScrollButtonWidget } from "./scroll.ts";
+
+export type ComponentRowHit = {
+  component: any;
+  row: number;
+  /** 内部工具命中时所属的展开 group；普通卡点击仍折叠整个 group。 */
+  group?: ToolGroupComponent;
+};
+
+/** 行内 [click to show more] 提示的命中列区间（1-based，含两端）。 */
+export function collapsedHintHitbox(
+  line: string,
+): { startCol: number; endCol: number } | null {
+  const plain = stripTerminalSequencesPreservingLayout(line);
+  const match =
+    /(\([^()\n]* \/ click\)|click to show more|to show more)(?=\)?\s*$)/.exec(
+      plain,
+    );
+  if (!match?.[1]) return null;
+  const startCol = visibleWidth(plain.slice(0, match.index)) + 1;
+  return { startCol, endCol: startCol + visibleWidth(match[1]) - 1 };
+}
+
+/** 布局树点查询：返回 (x,y) 处最深含行 leaf box（屏幕行 → 组件局部行）。 */
+export function fullscreenLeafAt(
+  layout: any,
+  x: number,
+  y: number,
+): { box: any; localRow: number } | null {
+  const root = layout?.root;
+  if (!root) return null;
+  let best: { box: any; localRow: number } | null = null;
+  let bestDepth = -1;
+  const visit = (box: any, depth: number) => {
+    if (!box) return;
+    const clip = box.clip;
+    if (
+      !clip ||
+      x < clip.x ||
+      x >= clip.x + clip.width ||
+      y < clip.y ||
+      y >= clip.y + clip.height
+    )
+      return;
+    const isLeaf = !Array.isArray(box.children) || box.children.length === 0;
+    if (
+      isLeaf &&
+      y >= box.rect.y &&
+      y < box.rect.y + Math.max(1, box.rect.height) &&
+      depth > bestDepth
+    ) {
+      best = { box, localRow: Math.max(0, y - box.rect.y) };
+      bestDepth = depth;
+    }
+    for (const child of box.children ?? []) visit(child, depth + 1);
+  };
+  visit(root, 0);
+  return best;
+}
+
+/** leaf 自身不带 scrollView；内容宽度由最近的 scroll 祖先决定。 */
+export function fullscreenContentWidth(
+  box: any,
+  terminalWidth: number,
+): number {
+  for (let current = box; current; current = current.parent) {
+    if (typeof current.scrollView?.getContentWidth === "function") {
+      return Math.max(1, current.scrollView.getContentWidth(terminalWidth));
+    }
+  }
+  return terminalWidth;
+}
+
+/** 点击列是否为官方滚动条列（放行官方拖动）。 */
+export function isScrollbarColumnAt(layout: any, x: number): boolean {
+  let hit = false;
+  const visit = (box: any) => {
+    if (hit || !box) return;
+    if (
+      box.scrollView?.isScrollbarVisible &&
+      x === box.rect.x + box.rect.width - 1
+    ) {
+      hit = true;
+      return;
+    }
+    for (const child of box.children ?? []) visit(child);
+  };
+  visit(layout?.root);
+  return hit;
+}
+
+/** compact 展开卡用 childAtRow 映射 thinking；其余按 render 行数下钻。 */
+function nestedChildAtRow(node: any, localRow: number, width: number): any {
+  if (typeof node?.childAtRow === "function") {
+    return node.childAtRow(localRow, width);
+  }
+  if (!Array.isArray(node?.children)) return null;
+  let offset = 0;
+  for (const child of node.children) {
+    let count = 0;
+    try {
+      const rendered = child.render?.(width);
+      if (Array.isArray(rendered)) count = rendered.length;
+    } catch {
+      count = 0;
+    }
+    if (localRow < offset + count) {
+      return nestedChildAtRow(child, localRow - offset, width);
+    }
+    offset += count;
+  }
+  return null;
+}
+
+/**
+ * 布局 leaf box 的组件通常是容器（documentContainer/dock 容器等），工具卡与
+ * widget 在其 children 内。按局部行遍历组件树，定位实际命中的子组件。
+ */
+export function componentAtLocalRow(
+  component: any,
+  localRow: number,
+  width: number,
+): ComponentRowHit | null {
+  if (component instanceof ToolGroupComponent) {
+    // 展开的 group：头两行（空行 + 头行）归 group，其余行映射到内部工具。
+    const child = component.childAtRow(localRow, width);
+    return child
+      ? { ...child, group: component }
+      : { component, row: localRow };
+  }
+  if (isToolExecutionComponent(component)) {
+    return { component, row: localRow };
+  }
+  if (isCompactAssistantComponent(component)) {
+    // 折叠：整行摘要。展开：先命中内部 thinking hint，其余仍归外层卡片。
+    if (component.expanded === true) {
+      const inner = nestedChildAtRow(component, localRow, width);
+      if (inner instanceof ThinkingPreviewBlock) {
+        return { component: inner, row: localRow };
+      }
+    }
+    return { component, row: localRow };
+  }
+  if (component instanceof ThinkingPreviewBlock) {
+    return { component, row: localRow };
+  }
+  if (isMessageDisplayComponent(component)) {
+    return { component, row: localRow };
+  }
+  if (component === getScrollButtonWidget()) {
+    return { component, row: localRow };
+  }
+  if (!Array.isArray(component.children)) return null;
+  let offset = 0;
+  for (const child of component.children) {
+    let lines: string[] = [];
+    try {
+      const rendered = child.render?.(width);
+      if (Array.isArray(rendered)) lines = rendered.map((line) => String(line));
+    } catch {
+      lines = [];
+    }
+    if (localRow < offset + lines.length) {
+      return (
+        componentAtLocalRow(child, localRow - offset, width) ?? {
+          component: child,
+          row: localRow - offset,
+        }
+      );
+    }
+    offset += lines.length;
+  }
+  return null;
+}
+
+/** fullscreen single-expand：group 作为整体，不继续递归其内部工具。 */
+export function collectFullscreenToolCards(
+  component: any,
+  out: any[],
+  seen = new Set<any>(),
+): void {
+  if (!component || typeof component !== "object" || seen.has(component))
+    return;
+  seen.add(component);
+  if (
+    isToolExecutionComponent(component) ||
+    component instanceof ToolGroupComponent ||
+    isCompactAssistantComponent(component) ||
+    component instanceof ThinkingPreviewBlock ||
+    isMessageDisplayComponent(component)
+  ) {
+    out.push(component);
+    return;
+  }
+  if (!Array.isArray(component.children)) return;
+  for (const child of component.children)
+    collectFullscreenToolCards(child, out, seen);
+}

package/extensions/transcript/renderer/mouse/packets.ts

@@ -0,0 +1,96 @@
+import type { ExpandedToolIoView, ToolIoSection } from "../tool/result.ts";
+import { walkComponentTree } from "../../../tools/component-tree.ts";
+export {
+  stripTerminalSequences,
+  stripTerminalSequencesPreservingLayout,
+} from "../../../tools/ansi-text.ts";
+export {
+  parseSgrMousePackets,
+  isSgrLeftPress,
+  type SgrMousePacket,
+} from "../../../tools/sgr-mouse.ts";
+
+/** Final painted placement of one outermost tool/group row after parent layout. */
+export type FrameToolPlacement = {
+  component: any;
+  componentRow: number;
+  lineIndex: number;
+  /** Marker-stripped final line text as painted after parent layout. */
+  finalLine: string;
+  view?: ExpandedToolIoView;
+  section?: ToolIoSection;
+};
+
+/** Zero-width APC row marker (like pi CURSOR_MARKER); stripped before terminal output. */
+const TOOL_FRAME_MARKER_RE = /\x1b_cc:t(\d+):(\d+)\x07/g;
+const TOOL_VIEW_MARKER_RE = /\x1b_cc:v(\d+):([io])\x07/g;
+export const toolFrameMarker = (id: number, row: number) =>
+  `\x1b_cc:t${id}:${row}\x07`;
+
+/** 工具执行组件识别（toolCallId + setExpanded + render）。 */
+export function isToolExecutionComponent(value: any): boolean {
+  return Boolean(
+    value &&
+      typeof value === "object" &&
+      typeof value.toolCallId === "string" &&
+      typeof value.setExpanded === "function" &&
+      typeof value.render === "function",
+  );
+}
+
+/** 深度收集组件树中的工具执行组件（含 getMountedRoots 分支）。 */
+export function collectToolComponents(component: any, tools: any[]): void {
+  walkComponentTree(component, (value: any) => {
+    if (isToolExecutionComponent(value)) {
+      tools.push(value);
+      return false;
+    }
+  });
+}
+
+/** 剥离一行中的零宽帧/视图 marker。 */
+export function stripToolFrameMarkers(line: string): string {
+  return line
+    .replace(TOOL_FRAME_MARKER_RE, "")
+    .replace(TOOL_VIEW_MARKER_RE, "");
+}
+
+/**
+ * 从渲染行中提取工具帧 placement（component/componentRow/lineIndex/finalLine
+ * 及其所属视图与 section），同时返回剥离 marker 后的行。
+ */
+export function extractToolFramePlacements(
+  lines: string[],
+  idToComponent: Map<number, any>,
+  idToView: Map<number, ExpandedToolIoView>,
+): { lines: string[]; placements: FrameToolPlacement[] } {
+  const placements: FrameToolPlacement[] = [];
+  const cleaned = lines.map((line, lineIndex) => {
+    const toolMatches = [...line.matchAll(TOOL_FRAME_MARKER_RE)];
+    const viewMatches = [...line.matchAll(TOOL_VIEW_MARKER_RE)];
+    const finalLine = stripToolFrameMarkers(line);
+    let view: ExpandedToolIoView | undefined;
+    let section: ToolIoSection | undefined;
+    for (const match of viewMatches) {
+      const candidate = idToView.get(Number(match[1]));
+      if (!candidate) continue;
+      view = candidate;
+      section = match[2] === "i" ? "input" : "output";
+      break;
+    }
+    for (const match of toolMatches) {
+      const component = idToComponent.get(Number(match[1]));
+      if (!component) continue;
+      placements.push({
+        component,
+        componentRow: Number(match[2]),
+        lineIndex,
+        finalLine,
+        view,
+        section,
+      });
+    }
+    return finalLine;
+  });
+  return { lines: cleaned, placements };
+}

package/extensions/transcript/renderer/mouse/scroll.ts

@@ -0,0 +1,211 @@
+import {
+  getKeybindings,
+  matchesKey,
+  truncateToWidth,
+  visibleWidth,
+  type Keybinding,
+} from "@earendil-works/pi-tui";
+import { config } from "../../../app/config/renderer.ts";
+import { isLazyProxyTui } from "../../../tools/fullscreen-detect.ts";
+import { parseSgrMousePackets } from "./packets.ts";
+import {
+  patchRegistry,
+  SCROLL_BUTTON_STATE_SLOT,
+  TOOL_MOUSE_TUI_SLOT,
+} from "../../../tools/patch-keys.ts";
+
+const ZENTUI_PAGE_UP_INPUT =
+  /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
+const ZENTUI_PAGE_DOWN_INPUT =
+  /^\x1b\[6;9(?::[12])?~$|^\x1b\[57422;9(?::[12])?u$|^\x1b\[1;6B$/;
+const SCROLL_BOTTOM_SHORTCUT = "ctrl+end";
+
+/**
+ * 当前安装的 tui 宿主。宿主放本模块（滚动按钮/调度依赖它），
+ * 由 mouse-interaction 经 setToolMouseTui 维护；跨模块一律经绑定/setter 访问。
+ *
+ * 状态镜像到 globalThis（Symbol 槽）：jiti 转译下经 re-export 链读取的
+ * 模块级 let 绑定是初始值快照（死绑定，实测恒 null），函数调用才是活引用。
+ * 跨模块读取一律用 getToolMouseTui()，避免拿到加载时的快照。
+ */
+patchRegistry.ensure(TOOL_MOUSE_TUI_SLOT, () => null);
+export let toolMouseTui: any = null;
+export function getToolMouseTui(): any {
+  return patchRegistry.get(TOOL_MOUSE_TUI_SLOT);
+}
+export function setToolMouseTui(tui: any): void {
+  toolMouseTui = tui;
+  patchRegistry.install(TOOL_MOUSE_TUI_SLOT, tui);
+}
+
+// 滚动按钮状态同 toolMouseTui：镜像到 globalThis（Symbol 槽），跨模块读取
+// 一律用 getter（jiti 转译下模块级 let 绑定是初始值快照）。
+type ScrollButtonState = { visible: boolean; hovered: boolean; widget: any };
+function scrollButtonState(): ScrollButtonState {
+  return patchRegistry.ensure(SCROLL_BUTTON_STATE_SLOT, () => ({
+    visible: false,
+    hovered: false,
+    widget: null,
+  }));
+}
+export function getScrollButtonVisible(): boolean {
+  return scrollButtonState().visible;
+}
+export function getScrollButtonHovered(): boolean {
+  return scrollButtonState().hovered;
+}
+export function getScrollButtonWidget(): any {
+  return scrollButtonState().widget;
+}
+export function setScrollButtonVisible(visible: boolean): void {
+  scrollButtonState().visible = visible;
+}
+
+/** 返回是否发生变化（调用方据此决定是否需要重渲染）。 */
+export function setScrollButtonHovered(hovered: boolean): boolean {
+  if (hovered === scrollButtonState().hovered) return false;
+  scrollButtonState().hovered = hovered;
+  return true;
+}
+
+export function setScrollButtonWidget(widget: any): void {
+  scrollButtonState().widget = widget;
+}
+
+/** teardown 全量清零（visible/hovered/widget/sync 调度）。 */
+export function resetScrollButtonState(): void {
+  scrollButtonState().visible = false;
+  scrollButtonState().hovered = false;
+  scrollButtonState().widget = null;
+  scrollButtonSyncScheduled = false;
+}
+
+let scrollButtonSyncScheduled = false;
+
+// 交互开关只取决于配置模式：原实现按 isLazyProxyTui(toolMouseTui) 分两分支，
+// 两分支恒真（0.84+ 惰性 Proxy 下判定不再影响开关），折叠为单条件。
+export function toolMouseInteractionActive(): boolean {
+  return config.mode !== "off";
+}
+
+/** 惰性 Proxy 官方 fullscreen（TuiAltScreen）判定。 */
+export function fullscreenLazyTui(tui: any): boolean {
+  return isLazyProxyTui(tui) && tui.mode === "fullscreen";
+}
+
+/** 官方 fullscreen：是否已跟随 transcript 底部（按钮隐藏条件）。 */
+export function isFullscreenAtBottom(tui: any): boolean {
+  const following =
+    tui.isFollowingOutput ??
+    tui.getPrimaryScrollView?.()?.isFollowingEnd ??
+    true;
+  return Boolean(following);
+}
+
+function formatShortcut(shortcut: string): string {
+  return shortcut
+    .split("+")
+    .map((part) =>
+      part.length <= 1
+        ? part.toUpperCase()
+        : `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`,
+    )
+    .join("+");
+}
+
+export function isScrollBottomInput(data: string): boolean {
+  return matchesKey(data, SCROLL_BOTTOM_SHORTCUT);
+}
+
+function isScrollNavigationInput(data: string): boolean {
+  if (
+    matchesKey(data, "pageUp") ||
+    matchesKey(data, "pageDown") ||
+    ZENTUI_PAGE_UP_INPUT.test(data) ||
+    ZENTUI_PAGE_DOWN_INPUT.test(data) ||
+    // 官方 fullscreen viewport 的可滚动键（half-page/prompt/top/bottom）。
+    [
+      "tui.altScreen.pageUp",
+      "tui.altScreen.pageDown",
+      "tui.altScreen.halfPageUp",
+      "tui.altScreen.halfPageDown",
+      "tui.altScreen.previousPrompt",
+      "tui.altScreen.nextPrompt",
+      "tui.altScreen.top",
+      "tui.altScreen.bottom",
+    ].some((key) => getKeybindings().matches(data, key as Keybinding))
+  ) {
+    return true;
+  }
+  const packets = parseSgrMousePackets(data);
+  return Boolean(
+    packets?.some((packet) => {
+      const baseButton = packet.code & ~(4 | 8 | 16 | 32);
+      return packet.final === "M" && (baseButton === 64 || baseButton === 65);
+    }),
+  );
+}
+
+function isAtTranscriptBottom(tui: any): boolean {
+  // 惰性 Proxy fullscreen：官方 viewport 以 isFollowingOutput 判定是否在底部。
+  if (fullscreenLazyTui(tui)) return isFullscreenAtBottom(tui);
+  return true;
+}
+
+export function hideScrollButton(tui: any): void {
+  const changed = getScrollButtonVisible() || getScrollButtonHovered();
+  setScrollButtonVisible(false);
+  setScrollButtonHovered(false);
+  if (changed) tui.requestRender?.();
+}
+
+export function scheduleScrollButtonSync(tui: any, data: string): void {
+  if (
+    !fullscreenLazyTui(tui) ||
+    !toolMouseInteractionActive() ||
+    !isScrollNavigationInput(data) ||
+    scrollButtonSyncScheduled
+  )
+    return;
+  scrollButtonSyncScheduled = true;
+  const previousLines = tui.previousLines;
+  const check = (attempt: number) => {
+    scrollButtonSyncScheduled = false;
+    if (toolMouseTui !== tui) return;
+    // Pi renders on its own frame timer. Inspect the resulting viewport before
+    // showing the button so empty or non-scrollable transcripts never flash it.
+    const rendered = tui.previousLines !== previousLines;
+    // fullscreen 下 isFollowingOutput 是即时状态，无需等待官方帧渲染。
+    if (!rendered && attempt < 4 && !fullscreenLazyTui(tui)) {
+      scrollButtonSyncScheduled = true;
+      const timer = setTimeout(() => check(attempt + 1), 16);
+      if (typeof timer === "object" && timer !== null && "unref" in timer) {
+        (timer as { unref: () => void }).unref();
+      }
+      return;
+    }
+    const nextVisible = !isAtTranscriptBottom(tui);
+    if (nextVisible !== getScrollButtonVisible()) {
+      setScrollButtonVisible(nextVisible);
+      tui.requestRender?.();
+    }
+  };
+  process.nextTick(() => check(0));
+}
+
+export function updateScrollButtonFromInput(tui: any, data: string): void {
+  if (!fullscreenLazyTui(tui) || !toolMouseInteractionActive()) return;
+  if (matchesKey(data, "enter") || matchesKey(data, "return"))
+    hideScrollButton(tui);
+}
+
+export function renderScrollButton(width: number, theme: any): string[] {
+  if (!getScrollButtonVisible() || !fullscreenLazyTui(toolMouseTui)) return [];
+  const shortcut = formatShortcut(SCROLL_BOTTOM_SHORTCUT);
+  const label = theme.fg(
+    getScrollButtonHovered() ? "text" : "accent",
+    `[ ↓ Back to bottom · ${shortcut} ]`,
+  );
+  const leftPad = Math.max(0, Math.floor((width - visibleWidth(label)) / 2));
+  return [`${" ".repeat(leftPad)}${truncateToWidth(label, width, "…")}`];
+}

package/extensions/transcript/renderer/tool/diff/ATTRIBUTION.md

@@ -0,0 +1,28 @@
+# Attribution
+
+The rich diff renderer in this directory is adapted from
+[MasuRii/pi-tool-display](https://github.com/MasuRii/pi-tool-display) at commit
+`91cef7580078371f8dc49a8607222807ad6a424d`.
+
+Copyright (c) MasuRii and pi-tool-display contributors. Used under the MIT
+License. The upstream license text is reproduced below.
+
+> MIT License
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.

package/extensions/transcript/renderer/tool/diff/ansi-utils.ts

@@ -0,0 +1,128 @@
+const ANSI_SGR_PATTERN = /\x1b\[([0-9;]*)m/g;
+const STYLE_RESET_PARAMS = [39, 22, 23, 24, 25, 27, 28, 29, 59] as const;
+
+export { ANSI_SGR_PATTERN, STYLE_RESET_PARAMS };
+
+export function expandSgrReset(param: number): readonly number[] | undefined {
+  return param === 0 ? STYLE_RESET_PARAMS : undefined;
+}
+
+export function toSgrParams(rawParams: string): number[] {
+  if (!rawParams.trim()) {
+    return [0];
+  }
+
+  const parsed = rawParams
+    .split(";")
+    .map((token) => Number.parseInt(token, 10))
+    .filter((value) => Number.isFinite(value));
+
+  return parsed.length > 0 ? parsed : [];
+}
+
+export function isFiniteSgrParam(value: number | undefined): value is number {
+  return typeof value === "number" && Number.isFinite(value);
+}
+
+export function readSgrColorSequence(
+  params: number[],
+  index: number,
+): number[] | undefined {
+  const param = params[index];
+  if (param !== 38 && param !== 48) {
+    return undefined;
+  }
+
+  const colorMode = params[index + 1];
+  if (colorMode === 5) {
+    const colorValue = params[index + 2];
+    return isFiniteSgrParam(colorValue)
+      ? [param, colorMode, colorValue]
+      : undefined;
+  }
+
+  if (colorMode === 2) {
+    const red = params[index + 2];
+    const green = params[index + 3];
+    const blue = params[index + 4];
+    return isFiniteSgrParam(red) &&
+      isFiniteSgrParam(green) &&
+      isFiniteSgrParam(blue)
+      ? [param, colorMode, red, green, blue]
+      : undefined;
+  }
+
+  return undefined;
+}
+
+export function stripBackgroundSgrParams(params: readonly number[]): number[] {
+  const sanitized: number[] = [];
+
+  for (let index = 0; index < params.length; index++) {
+    const param = params[index] ?? 0;
+
+    if (param === 0) {
+      sanitized.push(...expandSgrReset(param)!);
+      continue;
+    }
+
+    if (
+      param === 49 ||
+      (param >= 40 && param <= 47) ||
+      (param >= 100 && param <= 107)
+    ) {
+      continue;
+    }
+
+    if (param === 38 || param === 48) {
+      const sequence = readSgrColorSequence(params as number[], index);
+      if (sequence) {
+        if (param === 38) {
+          sanitized.push(...sequence);
+        }
+        index += sequence.length - 1;
+        continue;
+      }
+      const advance =
+        params[index + 1] === 5 ? 2 : params[index + 1] === 2 ? 4 : 0;
+      if (advance > 0) {
+        index += advance;
+        if (param === 38) {
+          sanitized.push(param);
+        }
+        continue;
+      }
+    }
+
+    sanitized.push(param);
+  }
+
+  return sanitized;
+}
+
+export function filterSgrSequences(
+  text: string,
+  filter: (params: number[]) => number[],
+): string {
+  if (!text || !text.includes("\x1b[")) {
+    return text;
+  }
+
+  return text.replace(ANSI_SGR_PATTERN, (_sequence, rawParams: string) => {
+    const parsed = toSgrParams(rawParams);
+    if (parsed.length === 0) {
+      return "";
+    }
+
+    const sanitized = filter(parsed);
+    if (sanitized.length === 0) {
+      return "";
+    }
+
+    return `\x1b[${sanitized.join(";")}m`;
+  });
+}
+
+export function sanitizeAnsiForThemedOutput(text: string): string {
+  return filterSgrSequences(text, stripBackgroundSgrParams);
+}