@simon_he/vue-tui 1.1.2 → 1.1.4

package/dist/mermaid.d.cts

@@ -1,3 +1,7 @@
 export type { TMermaidAsciiOptions, TMermaidAsciiTheme, TMermaidCopyPayload, TMermaidRenderer, TMermaidRenderEligibility, TMermaidRenderEligibilityContext, TMermaidResolvedAsciiOptions, TMermaidTextProps, TMermaidTransientErrorClassifier, TMermaidTransientErrorContext, } from "./vue/components/TMermaidText.js";
 export { isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal, } from "./vue/components/TMermaidText.js";
 export { beautifulMermaidRenderer, createBeautifulMermaidRenderer, TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidText, } from "./vue/mermaid/beautiful-mermaid.js";
+export { TMermaidImage } from "./vue/components/TMermaidImage.js";
+export type { TMermaidImageCopyPayload, TMermaidImageProps, } from "./vue/components/TMermaidImage.js";
+export { clearMermaidImageCache, getCachedMermaidImage, getMermaidImage, isMermaidImageRendererReady, loadMermaidImageRenderer, normalizeMermaidImageOptions, resolveMermaidImageColor, setMermaidImageRasterizer, subscribeMermaidImage, } from "./vue/mermaid/mermaid-image.js";
+export type { TuiMermaidImageCells, TuiMermaidImageOptions, TuiMermaidImageRasterizer, } from "./vue/mermaid/mermaid-image.js";

package/dist/mermaid.d.ts

@@ -1,3 +1,7 @@
 export type { TMermaidAsciiOptions, TMermaidAsciiTheme, TMermaidCopyPayload, TMermaidRenderer, TMermaidRenderEligibility, TMermaidRenderEligibilityContext, TMermaidResolvedAsciiOptions, TMermaidTextProps, TMermaidTransientErrorClassifier, TMermaidTransientErrorContext, } from "./vue/components/TMermaidText.js";
 export { isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal, } from "./vue/components/TMermaidText.js";
 export { beautifulMermaidRenderer, createBeautifulMermaidRenderer, TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidText, } from "./vue/mermaid/beautiful-mermaid.js";
+export { TMermaidImage } from "./vue/components/TMermaidImage.js";
+export type { TMermaidImageCopyPayload, TMermaidImageProps, } from "./vue/components/TMermaidImage.js";
+export { clearMermaidImageCache, getCachedMermaidImage, getMermaidImage, isMermaidImageRendererReady, loadMermaidImageRenderer, normalizeMermaidImageOptions, resolveMermaidImageColor, setMermaidImageRasterizer, subscribeMermaidImage, } from "./vue/mermaid/mermaid-image.js";
+export type { TuiMermaidImageCells, TuiMermaidImageOptions, TuiMermaidImageRasterizer, } from "./vue/mermaid/mermaid-image.js";

package/dist/mermaid.js

@@ -1,6 +1,8 @@
-import "./width-GqllnV8C.js";
-import "./rect-DUpeDfBg.js";
-import { isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal } from "./TMermaidText-frVr8Ysb.js";
-import { TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidText, beautifulMermaidRenderer, createBeautifulMermaidRenderer } from "./mermaid-BNhM1jAZ.js";
+import "./create-terminal-Db_-UGVQ.js";
+import "./rect-JzWMJxxc.js";
+import { isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal } from "./TMermaidText-wLnMMvVS.js";
+import "./terminal-graphics-DWZrl3oh.js";
+import "./math-image-BZhmfUeu.js";
+import { TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidImage, TMermaidText, beautifulMermaidRenderer, clearMermaidImageCache, createBeautifulMermaidRenderer, getCachedMermaidImage, getMermaidImage, isMermaidImageRendererReady, loadMermaidImageRenderer, normalizeMermaidImageOptions, resolveMermaidImageColor, setMermaidImageRasterizer, subscribeMermaidImage } from "./mermaid-uEfRItDe.js";
 
-export { TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidText, beautifulMermaidRenderer, createBeautifulMermaidRenderer, isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal };
+export { TBeautifulMermaid, TBeautifulMermaidText, TMermaid, TMermaidImage, TMermaidText, beautifulMermaidRenderer, clearMermaidImageCache, createBeautifulMermaidRenderer, getCachedMermaidImage, getMermaidImage, isMermaidImageRendererReady, isSimpleMermaidFlowchartSource, loadMermaidImageRenderer, markMermaidRenderErrorFatal, normalizeMermaidImageOptions, resolveMermaidImageColor, setMermaidImageRasterizer, subscribeMermaidImage };

package/dist/{rect-DUpeDfBg.js → rect-JzWMJxxc.js}

@@ -1,4 +1,4 @@
-import { charCellWidth, segmentedGraphemes } from "./width-GqllnV8C.js";
+import { charCellWidth, segmentedGraphemes } from "./create-terminal-Db_-UGVQ.js";
 import { computed, inject, onBeforeUnmount, provide, readonly, ref, vShow, watchEffect } from "vue";
 
 //#region src/vue/injection-key.ts

package/dist/renderer/cli/stdout-renderer.d.ts

@@ -15,6 +15,13 @@ export type StdoutRenderer = Readonly<{
     capabilities: RendererCapabilities;
     graphicsCapabilities?: TerminalGraphicsCapabilities;
     render: () => void;
+    /**
+     * Force an immediate full repaint of the renderer's rows, bypassing frame
+     * throttling. For `anchor: "bottom"` (REPL bar) callers this re-anchors the
+     * bar and re-establishes the scroll region after the terminal resized or
+     * after native output was written above the bar.
+     */
+    forceRender: () => void;
     dispose: () => void;
     /** Move terminal cursor to specified cell position for IME input */
     setCursor: (x: number, y: number) => void;
@@ -34,6 +41,43 @@ export type StdoutRendererOptions = Readonly<{
     clear?: boolean;
     hideCursor?: boolean;
     altScreen?: boolean;
+    /**
+     * How the TUI buffer is anchored on the terminal screen.
+     *
+     * - `"top"` (default): buffer row 0 maps to screen row 1 — the renderer owns
+     *   the whole terminal screen (full-screen TUIs).
+     * - `"bottom"`: the buffer is pinned to the bottom `rows` of the terminal
+     *   screen (a REPL-style prompt bar). Everything above the buffer is native
+     *   terminal output owned by the caller (scrollback, right-click paste,
+     *   native scrolling) — the renderer only ever writes to its own pinned rows
+     *   and never clears or repaints the area above.
+     *
+     * In bottom mode the renderer:
+     * - initially scrolls existing terminal contents upward to reserve the bar
+     *   rows and one fresh native-output row without overwriting prior history;
+     * - repaints the full (small) buffer every frame, so an externally scrolled
+     *   screen can never leave stale bar rows behind;
+     * - never emits buffer scroll operations that would disturb the caller's
+     *   scroll region above the bar;
+     * - skips the whole-screen clear even when `clear` is true;
+     * - establishes a scroll region that excludes the bar (`ESC[1;<screenRows-rows>r`)
+     *   so output written by the caller scrolls natively above the bar, and
+     *   restores it on dispose.
+     */
+    anchor?: "top" | "bottom";
+    /**
+     * Rows of blank space reserved between the native output region and the
+     * pinned bar in `anchor: "bottom"` mode. The bar stays at the very bottom;
+     * the scroll region the renderer establishes shrinks by `barGap` rows so
+     * caller output scrolls above a persistent blank gap. Default 0.
+     */
+    barGap?: number;
+    /**
+     * Live provider of the terminal screen height in rows (cells). Used only for
+     * `anchor: "bottom"` to compute the bar's pinned offset. Falls back to
+     * `output.rows` and then `process.stdout.rows` when omitted.
+     */
+    screenRows?: () => number;
     /** Fallback background color when a cell has no explicit bg. `null` = terminal default. */
     defaultBg?: string | null;
     /** Optional ANSI-name palette used when emitting ansi256/truecolor sequences. */

package/dist/renderer/terminal-graphics.d.ts

@@ -145,3 +145,47 @@ export declare function createIterm2InlineImageSequence(base64Data: string, opti
     doNotMoveCursor?: boolean;
 }>): string;
 export declare function wrapTerminalGraphicsForMultiplexer(sequence: string, capabilities: TerminalGraphicsCapabilities): string;
+export type TerminalGraphicPngViewport = Readonly<{
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+export type CreateTerminalGraphicPngSequenceOptions = Readonly<{
+    protocol: "kitty" | "iterm2";
+    base64: string;
+    imageId: number;
+    placementId: number;
+    cols?: number;
+    rows?: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    placementColumns?: number;
+    placementRows?: number;
+    rect?: TerminalGraphicPngViewport;
+    fullRect?: TerminalGraphicPngViewport;
+    zIndex?: number;
+    freeImageData?: boolean;
+    fallback?: string;
+}>;
+export type TerminalGraphicPngSequenceResult = Readonly<{
+    type: "sequence";
+    protocol: "kitty" | "iterm2";
+    sequence: string;
+    resizeSequence?: string;
+    clearSequence?: string;
+    fallback?: string;
+    cols?: number;
+    rows?: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    zIndex?: number;
+}>;
+/**
+ * Build a kitty/iTerm2 graphics sequence that renders one PNG. Shared by the
+ * image renderer factory (`createPngTerminalGraphicRenderer`) and the video
+ * frame renderer (`TVideo`) so both emit the same terminal sequences.
+ *
+ * Returns null for protocols this helper does not handle (callers fall back).
+ */
+export declare function createTerminalGraphicPngSequence(options: CreateTerminalGraphicPngSequenceOptions): TerminalGraphicPngSequenceResult | null;

package/dist/renderer-dom.js

@@ -1,6 +1,6 @@
-import "./hyperlink-_1FAj7Wq.js";
-import "./width-GqllnV8C.js";
-import "./ansi-palette-CH6jc2Z7.js";
-import { DOM_RENDERER_CAPABILITIES, createDomRenderer } from "./dom-renderer-DXx8fWzD.js";
+import "./create-terminal-Db_-UGVQ.js";
+import "./ansi-palette-BHF1rN7R.js";
+import "./hyperlink-clbb_ha_.js";
+import { DOM_RENDERER_CAPABILITIES, createDomRenderer } from "./dom-renderer-BfwAEQMf.js";
 
 export { DOM_RENDERER_CAPABILITIES, createDomRenderer };

package/dist/{terminal-graphics-Bbe83wSr.js → terminal-graphics-DWZrl3oh.js}

@@ -1,4 +1,4 @@
-import { getRootTerminal } from "./hyperlink-_1FAj7Wq.js";
+import { getRootTerminal } from "./create-terminal-Db_-UGVQ.js";
 
 //#region src/renderer/terminal-graphics.ts
 const TERMINAL_GRAPHICS_PROTOCOL_PRIORITY = [
@@ -592,6 +592,89 @@ function formatItermDimension(value) {
 	const raw = String(value ?? "").trim();
 	return validateIterm2Dimension(raw) ? raw : "auto";
 }
+function resolveKittyPngSourceCrop(rect, fullRect, sourceWidth, sourceHeight) {
+	if (fullRect.w <= 0 || fullRect.h <= 0) return null;
+	const offsetX = Math.max(0, rect.x - fullRect.x);
+	const offsetY = Math.max(0, rect.y - fullRect.y);
+	const visibleW = Math.max(0, Math.min(rect.w, fullRect.w - offsetX));
+	const visibleH = Math.max(0, Math.min(rect.h, fullRect.h - offsetY));
+	if (offsetX <= 0 && offsetY <= 0 && visibleW >= fullRect.w && visibleH >= fullRect.h) return null;
+	const sourceX = Math.max(0, Math.min(sourceWidth - 1, Math.floor(offsetX * sourceWidth / fullRect.w)));
+	const sourceY = Math.max(0, Math.min(sourceHeight - 1, Math.floor(offsetY * sourceHeight / fullRect.h)));
+	const sourceRight = Math.max(sourceX + 1, Math.min(sourceWidth, Math.ceil((offsetX + visibleW) * sourceWidth / fullRect.w)));
+	const sourceBottom = Math.max(sourceY + 1, Math.min(sourceHeight, Math.ceil((offsetY + visibleH) * sourceHeight / fullRect.h)));
+	return {
+		sourceX,
+		sourceY,
+		sourceWidth: sourceRight - sourceX,
+		sourceHeight: sourceBottom - sourceY
+	};
+}
+/**
+* Build a kitty/iTerm2 graphics sequence that renders one PNG. Shared by the
+* image renderer factory (`createPngTerminalGraphicRenderer`) and the video
+* frame renderer (`TVideo`) so both emit the same terminal sequences.
+*
+* Returns null for protocols this helper does not handle (callers fall back).
+*/
+function createTerminalGraphicPngSequence(options) {
+	if (options.protocol === "kitty") {
+		let placement = {
+			columns: options.placementColumns,
+			rows: options.placementRows
+		};
+		if (options.rect && options.fullRect && options.sourceWidth && options.sourceHeight) {
+			const crop = resolveKittyPngSourceCrop(options.rect, options.fullRect, options.sourceWidth, options.sourceHeight);
+			if (crop) placement = {
+				...placement,
+				...crop
+			};
+		}
+		return {
+			type: "sequence",
+			protocol: "kitty",
+			sequence: createKittyGraphicsSequence(options.base64, {
+				imageId: options.imageId,
+				placementId: options.placementId,
+				zIndex: options.zIndex,
+				...placement
+			}),
+			resizeSequence: createKittyPlacementSequence({
+				imageId: options.imageId,
+				placementId: options.placementId,
+				zIndex: options.zIndex,
+				...placement
+			}),
+			clearSequence: createKittyDeleteGraphicsSequence({
+				imageId: options.imageId,
+				placementId: options.placementId,
+				freeImageData: options.freeImageData
+			}),
+			...options.fallback != null ? { fallback: options.fallback } : {},
+			...options.cols != null ? { cols: options.cols } : {},
+			...options.rows != null ? { rows: options.rows } : {},
+			...options.sourceWidth != null ? { sourceWidth: options.sourceWidth } : {},
+			...options.sourceHeight != null ? { sourceHeight: options.sourceHeight } : {},
+			...options.zIndex != null ? { zIndex: options.zIndex } : {}
+		};
+	}
+	if (options.protocol === "iterm2") return {
+		type: "sequence",
+		protocol: "iterm2",
+		sequence: createIterm2InlineImageSequence(options.base64, {
+			width: options.cols,
+			height: options.rows,
+			preserveAspectRatio: true,
+			doNotMoveCursor: true
+		}),
+		...options.fallback != null ? { fallback: options.fallback } : {},
+		...options.cols != null ? { cols: options.cols } : {},
+		...options.rows != null ? { rows: options.rows } : {},
+		...options.sourceWidth != null ? { sourceWidth: options.sourceWidth } : {},
+		...options.sourceHeight != null ? { sourceHeight: options.sourceHeight } : {}
+	};
+	return null;
+}
 
 //#endregion
-export { canDrawTerminalGraphicRect, createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, detectTerminalGraphicsCapabilities, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, hashTerminalGraphicsString, isSafeTerminalGraphicsSequence, isTerminalGraphicsProtocol, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput };
+export { canDrawTerminalGraphicRect, createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, createTerminalGraphicPngSequence, detectTerminalGraphicsCapabilities, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, hashTerminalGraphicsString, isSafeTerminalGraphicsSequence, isTerminalGraphicsProtocol, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput };

package/dist/{tlog-theme-Bul2Na3u.js → tlog-theme-DqnF_zNe.js}

@@ -1,10 +1,11 @@
-import { applyAnsiSgrStyle, parseAnsiSgr, sanitizeTerminalHref } from "./hyperlink-_1FAj7Wq.js";
-import { EventZIndexContextKey, LayoutContextKey, RenderPlaneContextKey, RenderStackKey, TerminalGraphicsActivityKey, createCombinedTerminalGraphicsActivity, createTerminalGraphicsActivity, forEachTextCellSegment, formatInlineCellLine, intersectRect, normalizeCellRect, nowTerminalGraphicTraceTime, padEndByCells$1 as padEndByCells, recordTerminalGraphicTrace, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useRenderStack, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider, wrapByCells } from "./rect-DUpeDfBg.js";
-import { TView, TuiThemeContextKey, createFrameMailbox, defaultActiveStyle, linkifyTextSegments, tuiDefaultTheme } from "./linkify-D68T7rdW.js";
+import { applyAnsiSgrStyle, parseAnsiSgr } from "./create-terminal-Db_-UGVQ.js";
+import { sanitizeTerminalHref } from "./hyperlink-clbb_ha_.js";
+import { EventZIndexContextKey, LayoutContextKey, RenderPlaneContextKey, RenderStackKey, TerminalGraphicsActivityKey, createCombinedTerminalGraphicsActivity, createTerminalGraphicsActivity, forEachTextCellSegment, formatInlineCellLine, intersectRect, normalizeCellRect, nowTerminalGraphicTraceTime, padEndByCells$1 as padEndByCells, recordTerminalGraphicTrace, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useRenderStack, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider, wrapByCells } from "./rect-JzWMJxxc.js";
+import { TView, TuiThemeContextKey, createFrameMailbox, defaultActiveStyle, linkifyTextSegments, tuiDefaultTheme } from "./linkify-CL9wwnZN.js";
 import { framePerfNow } from "./frame-perf-CHpWhbC4.js";
 import { terminalSelectionRowSpans, terminalSelectionVisibleRowSpans } from "./terminal-selection-4W1SJj4c.js";
 import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-DASkEZr-.js";
-import { canDrawTerminalGraphicRect, createKittyDeleteGraphicsSequence, createKittyPlacementSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, isSafeTerminalGraphicsSequence, isTerminalGraphicsProtocol, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput } from "./terminal-graphics-Bbe83wSr.js";
+import { canDrawTerminalGraphicRect, createKittyDeleteGraphicsSequence, createKittyPlacementSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, isSafeTerminalGraphicsSequence, isTerminalGraphicsProtocol, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput } from "./terminal-graphics-DWZrl3oh.js";
 import { computed, defineComponent, getCurrentInstance, h, inject, markRaw, onBeforeUnmount, provide, ref, shallowReactive, shallowRef, watch, watchEffect } from "vue";
 
 //#region src/vue/utils/row-scroll.ts

package/dist/vue/components/TAgentTerminalGraphic.d.ts

@@ -453,11 +453,11 @@ export declare const TAgentTerminalGraphic: import("vue").DefineComponent<import
     readonly zIndex: number;
     readonly clear: boolean;
     readonly placementMoveWithoutClear: boolean;
+    readonly fallback: string;
     readonly trace: (event: TAgentTerminalGraphicTraceEvent) => void;
     readonly scrolling: boolean;
     readonly renderer: TAgentTerminalGraphicRenderer;
     readonly loadingText: string;
-    readonly fallback: string;
     readonly loadingStyle: Readonly<{
         fg?: string;
         bg?: string;

package/dist/vue/components/TMarkdownText.d.ts

@@ -76,6 +76,34 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    mathImages: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    mathCellWidthPx: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathCellHeightPx: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathScale: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathColor: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    mathMaxWidthCells: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathBaselineRatio: {
+        type: NumberConstructor;
+        default: undefined;
+    };
     imageActions: {
         type: BooleanConstructor;
         default: boolean;
@@ -171,6 +199,34 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    mathImages: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    mathCellWidthPx: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathCellHeightPx: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathScale: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathColor: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    mathMaxWidthCells: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    mathBaselineRatio: {
+        type: NumberConstructor;
+        default: undefined;
+    };
     imageActions: {
         type: BooleanConstructor;
         default: boolean;
@@ -193,6 +249,8 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
             source: string;
             raw: string;
             rendered: boolean;
+            pendingImage?: boolean;
+            mode?: "inline" | "display";
         }>;
         rect: Readonly<{
             x: number;
@@ -207,9 +265,11 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
     }>) => any) | undefined;
     onImageAction?: ((_payload: Readonly<{
         image: Readonly<{
-            kind: "image";
-            src: string;
+            kind: "image" | "math";
+            src?: string;
             alt?: string;
+            tex?: string;
+            raw?: string;
             mime?: string;
             base64?: string;
             originalBase64?: string;
@@ -273,6 +333,7 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
         codeBlock: Partial<Style>;
         thematicBreak: Partial<Style>;
         html: Partial<Style>;
+        math: Partial<Style>;
     }>>;
     imageRenderer: TuiMarkdownImageResolver;
     imageMinWidth: number;
@@ -280,6 +341,13 @@ export declare const TMarkdownText: import("vue").DefineComponent<import("vue").
     imageMinHeight: number;
     imageMaxHeight: number;
     imagePreserveAspectRatio: boolean;
+    mathImages: boolean;
+    mathCellWidthPx: number;
+    mathCellHeightPx: number;
+    mathScale: number;
+    mathColor: string;
+    mathMaxWidthCells: number;
+    mathBaselineRatio: number;
     imageActions: boolean;
     mathActions: boolean;
     linkActions: boolean;