@simon_he/vue-tui 1.1.1 → 1.1.2

package/README.md

@@ -54,20 +54,22 @@ Development, release validation, and documentation builds are run on Node.js 20
 
 ## Entry Points
 
-| Import                            | Stability    | Use it for                                                                                                                                                                                        |
-| --------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@simon_he/vue-tui`               | Public       | Browser-safe terminal core, DOM renderer, stable Vue components, and input host plugin factory                                                                                                    |
-| `@simon_he/vue-tui/core`          | Public       | Terminal core, buffer-facing types, ANSI/theme/path/hyperlink helpers                                                                                                                             |
-| `@simon_he/vue-tui/renderer/dom`  | Public       | DOM renderer factory and renderer capabilities                                                                                                                                                    |
-| `@simon_he/vue-tui/vue`           | Advanced     | Extended Vue components, composables, router helpers, and Vue runtime internals                                                                                                                   |
-| `@simon_he/vue-tui/runtime`       | Advanced     | Runtime wiring, selection helpers, and clipboard abstraction                                                                                                                                      |
-| `@simon_he/vue-tui/observability` | Advanced     | Frame perf store, profiler hooks, and trace helpers                                                                                                                                               |
-| `@simon_he/vue-tui/cli`           | Public       | Node-only headless Vue app runtime, stdin driver, stdout renderer, path provider, recording, and terminal clipboard helpers                                                                       |
-| `@simon_he/vue-tui/markdown`      | Public       | `TMarkdownText`, `TVirtualMarkdown`, markdown parser and layout helpers, streaming markdown block sources                                                                                         |
-| `@simon_he/vue-tui/mermaid`       | Public       | Optional `beautiful-mermaid` bridge and wrapper for `TMermaidText`                                                                                                                                |
-| `@simon_he/vue-tui/experimental`  | Experimental | `TContributionGraph`, `TLineChart`, `TCandlestickChart`, `TPieChart`, `TVirtualList`, `TTranscriptView`, `TLogView`, TLog search/link/minimap companions, append-only log store, and TLog plugins |
-| `@simon_he/vue-tui/agent`         | Experimental | Agent/console transcript, tool-call header, log, markdown, virtual list, render plane, and overlay component aggregation                                                                          |
-| `@simon_he/vue-tui/agent/mermaid` | Experimental | Agent namespace optional `beautiful-mermaid` bridge and wrapper for `TMermaidText`                                                                                                                |
+| Import                                      | Stability    | Use it for                                                                                                                   |
+| ------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
+| `@simon_he/vue-tui`                         | Public       | Browser-safe terminal core, DOM renderer, stable Vue components, and input host plugin factory                               |
+| `@simon_he/vue-tui/core`                    | Public       | Terminal core, buffer-facing types, ANSI/theme/path/hyperlink helpers                                                        |
+| `@simon_he/vue-tui/renderer/dom`            | Public       | DOM renderer factory and renderer capabilities                                                                               |
+| `@simon_he/vue-tui/vue`                     | Advanced     | Extended Vue components, composables, router helpers, and Vue runtime internals                                              |
+| `@simon_he/vue-tui/runtime`                 | Advanced     | Runtime wiring, selection helpers, and clipboard abstraction                                                                 |
+| `@simon_he/vue-tui/observability`           | Advanced     | Frame perf store, profiler hooks, and trace helpers                                                                          |
+| `@simon_he/vue-tui/cli`                     | Public       | Node-only headless Vue app runtime, stdin driver, stdout renderer, path provider, recording, and terminal clipboard helpers  |
+| `@simon_he/vue-tui/markdown`                | Public       | `TMarkdownText`, `TVirtualMarkdown`, markdown parser and layout helpers, streaming markdown block sources                    |
+| `@simon_he/vue-tui/mermaid`                 | Public       | Optional `beautiful-mermaid` bridge and wrapper for `TMermaidText`                                                           |
+| `@simon_he/vue-tui/experimental`            | Experimental | `T3DViewport`, `TVideo`, charts, `TVirtualList`, `TTranscriptView`, `TLogView`, TLog companions, and append-only log tooling |
+| `@simon_he/vue-tui/experimental/video/node` | Experimental | Node-only lazy FFmpeg frame source plus optional yt-dlp resolver for supported video pages                                   |
+| `@simon_he/vue-tui/experimental/3d/bun`     | Experimental | Bun-only raw WGSL/WebGPU Pull renderers, including the vue-tui terminal badge scene                                          |
+| `@simon_he/vue-tui/agent`                   | Experimental | Agent/console transcript, tool-call header, log, markdown, virtual list, render plane, and overlay component aggregation     |
+| `@simon_he/vue-tui/agent/mermaid`           | Experimental | Agent namespace optional `beautiful-mermaid` bridge and wrapper for `TMermaidText`                                           |
 
 The stable surface is terminal core, DOM rendering, CLI runtime, basic Vue components, markdown APIs, and the optional Mermaid bridge. High-throughput log, virtualization, and agent/console aggregation APIs stay under `/experimental` or `/agent` until their public surface settles; keep those imports isolated in application code. Use `/agent/mermaid` when agent code wants the optional Mermaid wrapper without changing the `/agent` main entrypoint.
 
@@ -82,6 +84,43 @@ import {
 } from "@simon_he/vue-tui/experimental";
 ```
 
+`T3DViewport` is renderer-agnostic and Pull-based. The bundled WGSL renderer is isolated in the Bun-only entrypoint so browser-safe imports do not load native GPU code:
+
+```ts
+import { T3DViewport } from "@simon_he/vue-tui/experimental";
+import { createTerminalBadge3DRenderer } from "@simon_he/vue-tui/experimental/3d/bun";
+
+const renderer = createTerminalBadge3DRenderer();
+```
+
+Install the optional `bun-webgpu` peer, then run the complete direction-E terminal badge example with `bun run run:3d:terminal`. Drag to orbit and use a two-finger trackpad gesture or mouse wheel to zoom. CLI hover steering requires `createStdinDriver({ enableMouseMotion: true })`.
+
+#### `experimental/3d/bun` platform requirements
+
+| Requirement                 | Detail                                               |
+| --------------------------- | ---------------------------------------------------- |
+| Runtime                     | **Bun only** — Node.js and browser are not supported |
+| `bun-webgpu` peer           | Must be installed manually: `bun add bun-webgpu`     |
+| macOS x64 / arm64           | ✅ Prebuilt binary available                         |
+| Linux x64                   | ✅ Prebuilt binary available                         |
+| Windows x64                 | ✅ Prebuilt binary available                         |
+| Linux arm64 / musl (Alpine) | ❌ No prebuilt binary — must build from source       |
+
+> `T3DViewport` itself (from `/experimental`) has zero native dependencies and works everywhere. Only `experimental/3d/bun` requires Bun and the optional peer. `bun-webgpu` is an experimental library; see [bun-webgpu](https://github.com/kommander/bun-webgpu) for current status.
+
+#### Terminal graphics protocol requirements
+
+`TVideo` and `T3DViewport` automatically negotiate their output format based on the detected terminal:
+
+| Terminal capability                 | Output quality                                 |
+| ----------------------------------- | ---------------------------------------------- |
+| kitty or iTerm2 protocol            | Pixel-accurate frames (PNG)                    |
+| No graphics protocol (any terminal) | `gray8` ASCII art — functional, lower fidelity |
+
+`TAgentTerminalGraphic` (mermaid diagrams, KaTeX math, images) requires kitty, iTerm2, or sixel to render visually; without a protocol it shows the `fallback` text prop. Always provide a meaningful `fallback` value so non-graphical terminals still convey the content.
+
+> sixel terminals get graphics for `TAgentTerminalGraphic` but ASCII art for `TVideo` / `T3DViewport` — only kitty and iTerm2 support pixel-accurate video and 3D frames. See [docs/platform-contracts.md](./docs/platform-contracts.md) for the full degradation table.
+
 Do not deep import from `@simon_he/vue-tui/dist/...`; only the entry points above are part of the supported package contract.
 
 ### Migration: Node Host Adapter Moved To `/cli`
@@ -242,20 +281,21 @@ Unhandled promise rejections stay host-owned by default. Setting `cleanupOnUnhan
 
 ## Components
 
-| Area           | Import                            | Components / APIs                                                                                                                                                                                |
-| -------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Stable layout  | `@simon_he/vue-tui`               | `TBox`, `TView`                                                                                                                                                                                  |
-| Stable text    | `@simon_he/vue-tui`               | `TText`, `TLink`, `TLinkifyText`                                                                                                                                                                 |
-| Stable input   | `@simon_he/vue-tui`               | `TInput`, `TList`, `TSelect`                                                                                                                                                                     |
-| Stable overlay | `@simon_he/vue-tui`               | `TDialog`                                                                                                                                                                                        |
-| Vue extended   | `@simon_he/vue-tui/vue`           | `TAnchor`, `TFlex`, `TFlexItem`, `TFlow`, `TRenderPlane`, `TRenderLayer`, `TTransition`, `TInputBox`, `TPathPicker`, `TJsonEditor`, `TMultilineModal`, `TDebugOverlay`, composables, router APIs |
-| Markdown       | `@simon_he/vue-tui/markdown`      | `TMarkdownText`, `TVirtualMarkdown`                                                                                                                                                              |
-| Mermaid        | `@simon_he/vue-tui/mermaid`       | `beautifulMermaidRenderer`, `TMermaid`, `TMermaidText`, `TBeautifulMermaidText`                                                                                                                  |
-| Experimental   | `@simon_he/vue-tui/experimental`  | `TContributionGraph`, `TLineChart`, `TCandlestickChart`, `TPieChart`, `TVirtualList`, `TTranscriptView`, `TLogView`, `TLogSearchBar`, `TLogLinksPanel`, `TLogScrollbar`, `TLogMinimap`           |
-| Agent console  | `@simon_he/vue-tui/agent`         | `TAgentTranscript`, `TToolCallView`, `TToolLogView`, `TVirtualMarkdown`, `TVirtualList`, `TRenderPlane`                                                                                          |
-| Agent Mermaid  | `@simon_he/vue-tui/agent/mermaid` | `beautifulMermaidRenderer`, `TMermaid`, `TMermaidText`, `TBeautifulMermaidText`                                                                                                                  |
-| Runtime        | `@simon_he/vue-tui/runtime`       | runtime, event, and selection APIs                                                                                                                                                               |
-| CLI            | `@simon_he/vue-tui/cli`           | `createTerminalApp`, `createStdoutRenderer`, `createStdinDriver`, Node host adapters                                                                                                             |
+| Area           | Import                                      | Components / APIs                                                                                                                                                                                |
+| -------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Stable layout  | `@simon_he/vue-tui`                         | `TBox`, `TView`                                                                                                                                                                                  |
+| Stable text    | `@simon_he/vue-tui`                         | `TText`, `TLink`, `TLinkifyText`                                                                                                                                                                 |
+| Stable input   | `@simon_he/vue-tui`                         | `TInput`, `TList`, `TSelect`                                                                                                                                                                     |
+| Stable overlay | `@simon_he/vue-tui`                         | `TDialog`                                                                                                                                                                                        |
+| Vue extended   | `@simon_he/vue-tui/vue`                     | `TAnchor`, `TFlex`, `TFlexItem`, `TFlow`, `TRenderPlane`, `TRenderLayer`, `TTransition`, `TInputBox`, `TPathPicker`, `TJsonEditor`, `TMultilineModal`, `TDebugOverlay`, composables, router APIs |
+| Markdown       | `@simon_he/vue-tui/markdown`                | `TMarkdownText`, `TVirtualMarkdown`                                                                                                                                                              |
+| Mermaid        | `@simon_he/vue-tui/mermaid`                 | `beautifulMermaidRenderer`, `TMermaid`, `TMermaidText`, `TBeautifulMermaidText`                                                                                                                  |
+| Experimental   | `@simon_he/vue-tui/experimental`            | `TVideo`, `TContributionGraph`, `TLineChart`, `TCandlestickChart`, `TPieChart`, `TVirtualList`, `TTranscriptView`, `TLogView`, `TLogSearchBar`, `TLogLinksPanel`, `TLogScrollbar`, `TLogMinimap` |
+| Video adapter  | `@simon_he/vue-tui/experimental/video/node` | `createFfmpegVideoFrameSource`, `createYtDlpVideoFrameSource`                                                                                                                                    |
+| Agent console  | `@simon_he/vue-tui/agent`                   | `TAgentTranscript`, `TToolCallView`, `TToolLogView`, `TVirtualMarkdown`, `TVirtualList`, `TRenderPlane`                                                                                          |
+| Agent Mermaid  | `@simon_he/vue-tui/agent/mermaid`           | `beautifulMermaidRenderer`, `TMermaid`, `TMermaidText`, `TBeautifulMermaidText`                                                                                                                  |
+| Runtime        | `@simon_he/vue-tui/runtime`                 | runtime, event, and selection APIs                                                                                                                                                               |
+| CLI            | `@simon_he/vue-tui/cli`                     | `createTerminalApp`, `createStdoutRenderer`, `createStdinDriver`, Node host adapters                                                                                                             |
 
 For streaming Mermaid source, pass `streaming` with `final`. When `streaming=true` and `final=false`, transient renderer errors do not replace the last successfully rendered diagram; if no diagram has rendered yet, `incompleteText` is shown until the source becomes renderable or `final=true` surfaces the final error.
 

package/dist/{TMermaidText-CXm_L969.js → TMermaidText-frVr8Ysb.js}

@@ -1,4 +1,4 @@
-import { EventZIndexContextKey, intersectRect, padEndByCells$1 as padEndByCells, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider } from "./rect-Ng-3eKzF.js";
+import { EventZIndexContextKey, intersectRect, padEndByCells$1 as padEndByCells, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider } from "./rect-DUpeDfBg.js";
 import { computed, defineComponent, getCurrentInstance, h, inject, markRaw, onBeforeUnmount, shallowRef, watch } from "vue";
 
 //#region src/vue/components/TMermaidText.ts

package/dist/{TSelect-CiyMvwl-.js → TSelect-tJ87rKPM.js}

@@ -1,9 +1,8 @@
-import { getPlaneTerminal } from "./create-terminal-DXuZ2fci.js";
+import { getPlaneTerminal, hasEncodedControl } from "./hyperlink-_1FAj7Wq.js";
 import { charCellWidth } from "./width-GqllnV8C.js";
-import { hasEncodedControl } from "./hyperlink-B35-O-cW.js";
-import { DialogContextKey, EventZIndexContextKey, ImeAnchorContextKey, LayoutContextKey, RenderPlaneContextKey, RenderStackKey, TInputPluginsContextKey, TerminalContextKey, forEachTextCellSegment, graphemeRangeAt, hasTextWidthAsciiFastPath, intersectRect, padEndByCells$1 as padEndByCells, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useRenderStack, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider, wrapByCells } from "./rect-Ng-3eKzF.js";
-import { TView, mergeStyle } from "./linkify-CuuquMQT.js";
-import { isAbsolutePath, normalizeNewlines, normalizePath, resolvePath } from "./path-BI9W15Zt.js";
+import { DialogContextKey, EventZIndexContextKey, ImeAnchorContextKey, LayoutContextKey, RenderPlaneContextKey, RenderStackKey, TInputPluginsContextKey, TerminalContextKey, forEachTextCellSegment, graphemeRangeAt, hasTextWidthAsciiFastPath, intersectRect, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCells, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useRenderStack, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider } from "./rect-DUpeDfBg.js";
+import { TText, TView, mergeStyle } from "./linkify-D68T7rdW.js";
+import { isAbsolutePath, normalizeNewlines, normalizePath, resolvePath } from "./path-mnSgEpCm.js";
 import { computed, defineComponent, h, inject, nextTick, onBeforeUnmount, onMounted, provide, ref, shallowReactive, shallowRef, watch, watchEffect } from "vue";
 
 //#region src/vue/components/TRenderPlane.ts
@@ -462,167 +461,6 @@ function createOverlayFocusStack() {
 	};
 }
 
-//#endregion
-//#region src/vue/components/TText.ts
-function fitText(text, max) {
-	if (max <= 0) return "";
-	text = sanitizeInlineText(text);
-	return sliceByCells(text, max);
-}
-function splitLines(text) {
-	return sanitizeTextBlock(text).split("\n");
-}
-function computeDefaultWidth(text) {
-	const lines = splitLines(text);
-	let max = 0;
-	for (const line of lines) max = Math.max(max, textCellWidth(line));
-	return max;
-}
-const TText = defineComponent({
-	name: "TText",
-	props: {
-		x: {
-			type: Number,
-			required: true
-		},
-		y: {
-			type: Number,
-			required: true
-		},
-		zIndex: {
-			type: Number,
-			default: 0
-		},
-		value: {
-			type: String,
-			required: true
-		},
-		w: {
-			type: Number,
-			default: void 0
-		},
-		h: {
-			type: Number,
-			default: void 0
-		},
-		style: {
-			type: Object,
-			default: void 0
-		},
-		clear: {
-			type: Boolean,
-			default: true
-		},
-		wrap: {
-			type: Boolean,
-			default: false
-		},
-		depsKey: {
-			type: null,
-			default: void 0
-		}
-	},
-	setup(props) {
-		const { terminal, defaultStyle } = useTerminal();
-		const layout = useLayout();
-		const { visible, rootProps } = useVisibility();
-		const defaultWidth = computed(() => computeDefaultWidth(props.value));
-		const lines = computed(() => {
-			const w = props.w ?? defaultWidth.value;
-			if (w <= 0) return [""];
-			if (!props.wrap) return splitLines(props.value).map((l) => fitText(l, w));
-			const safe = sanitizeTextBlock(props.value);
-			return wrapByCells(safe, w).map((l) => fitText(l, w));
-		});
-		const absRect = computed(() => {
-			const width = props.w ?? defaultWidth.value;
-			const height = props.h ?? (props.wrap ? lines.value.length || 1 : lines.value.length || 1);
-			const raw = {
-				x: props.x,
-				y: props.y,
-				w: width,
-				h: height
-			};
-			const translated = translateRect(raw, layout.originX, layout.originY);
-			if (!layout.clipRect) return translated;
-			return intersectRect(translated, layout.clipRect) ?? {
-				x: 0,
-				y: 0,
-				w: 0,
-				h: 0
-			};
-		});
-		const fullRect = computed(() => {
-			const width = props.w ?? defaultWidth.value;
-			const height = props.h ?? (props.wrap ? lines.value.length || 1 : lines.value.length || 1);
-			return translateRect({
-				x: props.x,
-				y: props.y,
-				w: width,
-				h: height
-			}, layout.originX, layout.originY);
-		});
-		useRenderNode(() => ({
-			zIndex: props.zIndex,
-			rect: visible.value ? absRect.value : {
-				x: 0,
-				y: 0,
-				w: 0,
-				h: 0
-			},
-			deps: [
-				visible.value,
-				absRect.value,
-				fullRect.value,
-				props.value,
-				props.w,
-				props.h,
-				props.wrap,
-				props.style,
-				defaultStyle.value,
-				props.depsKey
-			],
-			paint: (dirtyRows) => {
-				if (!visible.value) return;
-				const r = absRect.value;
-				if (r.w <= 0 || r.h <= 0) return;
-				const full = fullRect.value;
-				const style = props.style ?? defaultStyle.value;
-				const blank = props.clear ? spaces(r.w) : "";
-				const out = lines.value;
-				const dx = Math.max(0, Math.floor(r.x - full.x));
-				const fullY = Math.floor(full.y);
-				const paintRow = (y) => {
-					const relY = y - r.y;
-					if (relY < 0 || relY >= r.h) return;
-					const i = y - fullY;
-					if (i < 0 || i >= out.length) {
-						if (props.clear) terminal.write(blank, {
-							x: r.x,
-							y,
-							style
-						});
-						return;
-					}
-					const src = out[i] ?? "";
-					const clipped = dx > 0 ? sliceByCellsRange(src, dx, dx + r.w) : sliceByCells(src, r.w);
-					terminal.write(padEndByCells(clipped, r.w), {
-						x: r.x,
-						y,
-						style
-					});
-				};
-				if (!dirtyRows) {
-					for (let i = 0; i < r.h; i++) paintRow(r.y + i);
-					return;
-				}
-				for (const y of dirtyRows) paintRow(y);
-			}
-		}));
-		return () => h("span", rootProps);
-	}
-});
-
 //#endregion
 //#region src/vue/components/TDialog.ts
 function clamp$3(n, min, max) {
@@ -1865,7 +1703,7 @@ function isAscii(text) {
 	return true;
 }
 const textCellWidth$1 = textCellWidth;
-function padEndByCells$1(text, width) {
+function padEndByCells(text, width) {
 	const cells = textCellWidth$1(text);
 	if (cells >= width) return text;
 	return text + spaces(width - cells);
@@ -6114,4 +5952,4 @@ const TSelect = defineComponent({
 });
 
 //#endregion
-export { TBox, TCommandPalette, TDialog, TInput, TRenderPlane, TSelect, TText, clamp$1, computeCommandPaletteMatchRanges, createOverlayFocusStack, isCommitMention, isWhitespace, mentionChipStyle, padEndByCells$1 as padEndByCells, resolveOverlayPlacement, sliceByCellsWindow, textCellWidth$1 as textCellWidth };
+export { TBox, TCommandPalette, TDialog, TInput, TRenderPlane, TSelect, clamp$1, computeCommandPaletteMatchRanges, createOverlayFocusStack, isCommitMention, isWhitespace, mentionChipStyle, padEndByCells, resolveOverlayPlacement, sliceByCellsWindow, textCellWidth$1 as textCellWidth };

package/dist/{TTree-DKGiuIcM.js → TTree-CGdE-CYu.js}

@@ -1,16 +1,15 @@
-import { TERMINAL_RENDER_PLANES, createTerminal, getPlaneTerminal, resetPlaneRowsForRender, scrollPlaneRows } from "./create-terminal-DXuZ2fci.js";
-import { sanitizeDomHref } from "./hyperlink-B35-O-cW.js";
-import { DOM_RENDERER_CAPABILITIES, createDomRenderer } from "./dom-renderer-DNzmg2As.js";
-import { EventZIndexContextKey, ImeAnchorContextKey, LayoutContextKey, RenderStackKey, TInputPluginsContextKey, TPathPickerProviderContextKey, TerminalContextKey, VisibilityContextKey, clearTextCaches, forEachTextCellSegment, formatInlineCellLine, injectionKey, intersectRect, normalizeCellRect, padEndByCells$1 as padEndByCells, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextRenderPass } from "./rect-Ng-3eKzF.js";
-import { TView, TuiThemeContextKey, clamp, createFrameMailbox, createTheme, defaultActiveStyle, defaultDimStyle, fitCellText, linkifyTextSegments, mergeStyle, repeatToCells, tuiDefaultTheme } from "./linkify-CuuquMQT.js";
-import { SUPPRESS_TERMINAL_POINTER_DOWN, SUPPRESS_TERMINAL_POINTER_MOVE, SUPPRESS_TERMINAL_POINTER_UP, createEventManager, createRuntime } from "./runtime-D77C03RM.js";
-import { framePerfNow, mergeFramePerfReason } from "./frame-perf-BBhE-iuS.js";
-import { createFramePerfStore, createTraceStore } from "./trace-CYHDKM1m.js";
-import { envFlag, envString, firstNonEmptyEnv } from "./env-DNCzvX8b.js";
-import { createTerminalSelectionController } from "./terminal-selection-CQYr--26.js";
-import { createDebugLogger, isDebugEnabled } from "./debug-logger-ChY_PXVk.js";
-import { TBox, TInput, TRenderPlane, TText, resolveOverlayPlacement } from "./TSelect-CiyMvwl-.js";
-import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-CQ22Hcyj.js";
+import { TERMINAL_RENDER_PLANES, createTerminal, getPlaneTerminal, resetPlaneRowsForRender, sanitizeDomHref, scrollPlaneRows } from "./hyperlink-_1FAj7Wq.js";
+import { DOM_RENDERER_CAPABILITIES, createDomRenderer } from "./dom-renderer-DXx8fWzD.js";
+import { EventZIndexContextKey, ImeAnchorContextKey, LayoutContextKey, RenderStackKey, TInputPluginsContextKey, TPathPickerProviderContextKey, TerminalContextKey, VisibilityContextKey, clearTextCaches, forEachTextCellSegment, formatInlineCellLine, injectionKey, intersectRect, normalizeCellRect, padEndByCells$1 as padEndByCells, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextRenderPass } from "./rect-DUpeDfBg.js";
+import { TText, TView, TuiThemeContextKey, clamp, createFrameMailbox, createTheme, defaultActiveStyle, defaultDimStyle, fitCellText, linkifyTextSegments, mergeStyle, repeatToCells, tuiDefaultTheme } from "./linkify-D68T7rdW.js";
+import { SUPPRESS_TERMINAL_POINTER_DOWN, SUPPRESS_TERMINAL_POINTER_MOVE, SUPPRESS_TERMINAL_POINTER_UP, createEventManager, createRuntime } from "./runtime-Byf8XXOT.js";
+import { framePerfNow, mergeFramePerfReason } from "./frame-perf-CHpWhbC4.js";
+import { createFramePerfStore, createTraceStore } from "./trace-Bh8WnoMo.js";
+import { envFlag, envString, firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
+import { createTerminalSelectionController } from "./terminal-selection-4W1SJj4c.js";
+import { createDebugLogger, isDebugEnabled } from "./debug-logger-CmsGI4of.js";
+import { TBox, TInput, TRenderPlane, resolveOverlayPlacement } from "./TSelect-tJ87rKPM.js";
+import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-DASkEZr-.js";
 import { computed, defineComponent, effectScope, getCurrentInstance, h, inject, nextTick, onBeforeUnmount, onMounted, onScopeDispose, onUnmounted, provide, ref, shallowReactive, shallowRef, toRef, watch, watchEffect } from "vue";
 
 //#region src/observability/tui-profiler.ts

package/dist/agent.cjs

@@ -6281,6 +6281,7 @@ var tAgentTerminalGraphicProps = {
   scrolling: { type: Boolean, default: !1 },
   scrollVersion: { type: Number, default: 0 },
   placementMoveWithoutClear: { type: Boolean, default: !1 },
+  preserveRawWhileRendering: { type: Boolean, default: !1 },
   suspended: { type: Boolean, default: !1 },
   retainRawWhileCovered: { type: Boolean, default: !1 },
   ignoreRawCoverage: { type: Boolean, default: !1 },
@@ -6527,7 +6528,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
       })), accepted;
     }
     function queueDrawGraphic(output, current, rect, full = rect, options = {}) {
-      let clearSequence = resolveClearSequence(current), resizeSequence = resolveResizeSequence(current, rect, full), drawKey = terminalDrawKey(current, rect, clearSequence, resizeSequence), activePrevious = lastDrawnGraphic.value, retainedPrevious = rawClearPendingRepaint.value, previous = activePrevious ?? retainedPrevious, previousIsRetained = activePrevious == null && retainedPrevious != null, previousStillActive = previous ? typeof output.isActive == "function" ? output.isActive(previous.id) : !0 : !1;
+      let clearSequence = resolveClearSequence(current), resizeSequence = resolveResizeSequence(current, rect, full), drawKey = terminalDrawKey(current, rect, clearSequence, resizeSequence), activePrevious = lastDrawnGraphic.value, retainedPrevious = rawClearPendingRepaint.value, previous = activePrevious ?? retainedPrevious, previousIsRetained = activePrevious == null && retainedPrevious != null, previousStillActive = previous ? typeof output.isActive == "function" ? output.isActive(previous.id) : !0 : !1, preservePreviousForAtomicReplace = props.preserveRawWhileRendering && activePrevious != null && !previousIsRetained && previousStillActive;
       if (!previousIsRetained && !options.force && previous?.drawKey === drawKey && previousStillActive)
         return !1;
       let canReusePlacementSequence = previousStillActive && previous?.protocol === current.protocol && previous.sequenceHash === current.sequenceHash && current.protocol === "kitty" && !!resizeSequence, scrollVersion = Math.floor(Number(props.scrollVersion ?? 0)), canMoveWithoutClear = canReusePlacementSequence && !!options.placementMoveWithoutClear;
@@ -6542,7 +6543,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
           activityVersion: graphicsActivityVersion.value,
           scrollVersion
         }, lastRawSkipScrollKey = "", !1;
-      if (previousStillActive && !previousIsRetained && !canReusePlacementSequence) {
+      if (previousStillActive && !previousIsRetained && !canReusePlacementSequence && !preservePreviousForAtomicReplace) {
         if (!queueClearLastGraphic({ markPendingRepaint: !1 }))
           return !1;
       } else
@@ -6559,6 +6560,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
           sequence: canReusePlacementSequence && resizeSequence ? resizeSequence : current.sequence,
           resizeSequence,
           clearSequence,
+          retainOnClear: !!(props.cacheKey && resizeSequence),
           resizeRedraw: canReusePlacementSequence,
           placementMoveWithoutClear: canMoveWithoutClear,
           allowTextOverlay: options.allowTextOverlay,
@@ -6580,10 +6582,11 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
         clearSequence,
         resizeSequence,
         retainOnClear: !!(props.cacheKey && resizeSequence),
+        allowTextOverlay: !!options.allowTextOverlay,
         drawKey,
         activityVersion: graphicsActivityVersion.value,
         scrollVersion
-      }, lastRawSkipScrollKey = "", !0) : (lastDrawnGraphic.value = null, rawDrawRejectedKey.value !== drawKey && (rawDrawRejectedKey.value = drawKey, scheduler.invalidate({ priority: "low", reason: "data" })), !1);
+      }, lastRawSkipScrollKey = "", !0) : (preservePreviousForAtomicReplace ? (lastDrawnGraphic.value = activePrevious, queueClearLastGraphic({ markPendingRepaint: !1 })) : lastDrawnGraphic.value = null, rawDrawRejectedKey.value !== drawKey && (rawDrawRejectedKey.value = drawKey, scheduler.invalidate({ priority: "low", reason: "data" })), !1);
     }
     function hasRetainedActiveRawGraphic() {
       let output = graphicsOutput();
@@ -6768,7 +6771,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
     }
     function scheduleRender(options = {}) {
       let version2 = ++renderVersion;
-      if ((options.clearLastGraphic ?? !0) && queueClearLastGraphic(), !builtOnce || !props.streaming) {
+      if ((options.clearLastGraphic ?? !props.preserveRawWhileRendering) && queueClearLastGraphic(), !builtOnce || !props.streaming) {
         builtOnce = !0, renderNow(version2);
         return;
       }
@@ -6795,6 +6798,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
         () => props.suspendRawWhileScrolling,
         () => props.suspendRenderWhileScrolling,
         () => props.scrolling,
+        () => props.preserveRawWhileRendering,
         () => props.suspended,
         () => props.retainRawWhileCovered,
         () => props.ignoreRawCoverage,
@@ -6898,7 +6902,7 @@ var TAgentTerminalGraphic = (0, import_vue14.defineComponent)({
             let previous = lastDrawnGraphic.value;
             if ((previous ? typeof output.isActive == "function" ? output.isActive(previous.id) : !0 : !1) && previous) {
               let clearSequence = resolveClearSequence(current), resizeSequence = resolveResizeSequence(current, rawRectForPaint, full);
-              preserveActiveRawGraphic = rawClearPendingRepaint.value == null && previous.drawKey === terminalDrawKey(current, rawRectForPaint, clearSequence, resizeSequence), allowTextOverlay = retainedRawCoveredByHigherRenderNode(r), forceActiveRawRedraw = preserveActiveRawGraphic && (previous.activityVersion !== graphicsActivityVersion.value || allowTextOverlay);
+              preserveActiveRawGraphic = rawClearPendingRepaint.value == null && previous.drawKey === terminalDrawKey(current, rawRectForPaint, clearSequence, resizeSequence), allowTextOverlay = retainedRawCoveredByHigherRenderNode(r), forceActiveRawRedraw = preserveActiveRawGraphic && (previous.activityVersion !== graphicsActivityVersion.value || previous.allowTextOverlay !== allowTextOverlay);
             }
           }
           let preserveActiveRawGraphicForPaint = preserveActiveRawGraphic, out = rawCanQueueForPaint ? displayLines.value : resolveDisplayLines(!1), clearingRawGraphic = rawClearPendingRepaint.value != null || lastDrawnGraphic.value != null && !preserveActiveRawGraphicForPaint, clearOwnedRegion = preserveActiveRawGraphicForPaint || retainedActiveRawGraphic ? !1 : props.clear || clearingRawGraphic || !!rawCanQueueForPaint, blank = clearOwnedRegion ? spaces(r.w) : "", paintRow = (y) => {