@oh-my-pi/pi-tui 18.0.3 → 18.0.5

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## [Unreleased]
 
+## [18.0.5] - 2026-08-25
+
+### Breaking Changes
+
+- Renamed the public `TerminalFrameProvider.resetHistory` method to `beginHistoryReplay`.
+
+### Added
+
+- Loader messages can now be provided as a function, allowing dynamic labels such as live countdowns to update on each spinner tick while preserving the existing behavior for static strings.
+
+### Changed
+
+- Improved history replay and terminal output handling so replayed content is rendered efficiently and complete replay results are written together.
+
+### Fixed
+
+- Fixed graceful shutdown so finalized output is correctly retired before handing control back to the shell.
+- Fixed terminal scrollback corruption during shutdown, tmux pane zoom and resize, and destructive screen resets, preventing duplicated frames, lost history, and stale transcript re-streaming.
+- Fixed streaming Markdown rendering at chunk boundaries to preserve CommonMark emphasis behavior for Unicode text and correctly recognize GFM tables as they are completed.
+
+## [18.0.4] - 2026-08-24
+
+### Changed
+
+- Significantly improved streaming Markdown rendering performance by caching unchanged rows, resuming boundary walks, and inspecting only text deltas for guard scans and OSC 8 normalization.
+
+### Fixed
+
+- Fixed TUI aborting when syntax highlighting fails during Markdown rendering by falling back to unhighlighted text.
+- Fixed Korean IME cursor drift in Orca by properly matching two-cell Hangul Compatibility Jamo rendering.
+
 ## [18.0.3] - 2026-08-23
 
 ### Fixed

package/dist/types/components/loader.d.ts

@@ -14,7 +14,7 @@ export declare class Loader extends Text {
     private spinnerColorFn;
     private messageColorFn;
     private message;
-    constructor(ui: TUI, spinnerColorFn: ColorFn, messageColorFn: LoaderMessageColorFn, message?: string, spinnerFrames?: string[]);
+    constructor(ui: TUI, spinnerColorFn: ColorFn, messageColorFn: LoaderMessageColorFn, message?: string | (() => string), spinnerFrames?: string[]);
     render(width: number): readonly string[];
     start(): void;
     stop(): void;

package/dist/types/components/markdown.d.ts

@@ -6,6 +6,14 @@ export declare function mathStartIndex(src: string): number | undefined;
 export declare function autolinkSchemeScanIndex(src: string): number | undefined;
 /** @internal exported for tests — must never return false for a src the built-in url regex matches. */
 export declare function urlTokenPossible(src: string): boolean;
+/** @internal exported for tests — counts fast-tail splice frames. A future
+ *  regression that silently disarms the fast path (e.g. an over-broad gate)
+ *  leaves byte-identity intact but drops the counter to zero. */
+export declare let fastTailSplices: number;
+/** @internal exported for tests — resets the splice counter. */
+export declare function resetFastTailSplices(): void;
+/** @internal exported for tests — the grown-line-start block-kind gate. */
+export declare function fastLineStartHazard(grownLine: string): boolean;
 /** Drop all L2 cache entries. Call on theme change to prevent stale styled output. */
 export declare function clearRenderCache(): void;
 /**

package/dist/types/terminal-capabilities.d.ts

@@ -10,7 +10,7 @@ export declare enum NotifyProtocol {
     Osc99 = "\u001B]99;;",
     Osc9 = "\u001B]9;"
 }
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "base" | "trueColor";
+export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "base" | "trueColor";
 /** Terminal capability details used for rendering and protocol selection. */
 export declare class TerminalInfo {
     readonly id: TerminalId;
@@ -23,7 +23,7 @@ export declare class TerminalInfo {
     /** Renders the Kitty OSC 66 text-sizing protocol (scaled spans). Kitty only. */
     readonly supportsTextSizing: boolean;
     /**
-     * Hangul Compatibility Jamo (U+3131..=U+318E) cell width. Ghostty follows
+     * Hangul Compatibility Jamo (U+3131..=U+318E) cell width. Ghostty and Orca follow
      * UAX#11 (2 cells); Warp paints 1; "platform" keeps the OS default
      * (macOS narrow, otherwise UAX#11).
      */
@@ -32,7 +32,7 @@ export declare class TerminalInfo {
     /** Renders the Kitty OSC 66 text-sizing protocol (scaled spans). Kitty only. */
     supportsTextSizing?: boolean, 
     /**
-     * Hangul Compatibility Jamo (U+3131..=U+318E) cell width. Ghostty follows
+     * Hangul Compatibility Jamo (U+3131..=U+318E) cell width. Ghostty and Orca follow
      * UAX#11 (2 cells); Warp paints 1; "platform" keeps the OS default
      * (macOS narrow, otherwise UAX#11).
      */

package/dist/types/tui.d.ts

@@ -23,12 +23,19 @@ export interface ViewportSize {
     readonly columns: number;
     readonly rows: number;
 }
-/** Immutable finalized rows offered until the terminal accepts this identifier. */
+/** Immutable append or complete replay offered until the terminal accepts this identifier. */
 export interface HistoryBatch {
     readonly id: number;
     readonly rows: readonly string[];
+    /**
+     * `append` (the default) adds finalized or naturally emitted rows. `replay`
+     * is the complete logical ledger; the writer bottom-splits it against the
+     * leading blank viewport and serializes the remainder plus final viewport in
+     * one synchronous terminal write.
+     */
+    readonly kind?: "append" | "replay";
 }
-/** One history append and the complete mutable viewport for a terminal frame. */
+/** One history append or complete replay plus the mutable viewport for a terminal frame. */
 export interface TerminalFramePlan {
     readonly history?: HistoryBatch;
     readonly viewport: readonly string[];
@@ -40,7 +47,9 @@ export interface TerminalFrameProvider {
     /** Full semantic viewport used only on the transient resize buffer. */
     renderResizeFrame?(viewport: ViewportSize): readonly string[];
     /** Re-offer finalized history after a display reset or resize replay. */
-    resetHistory?(): void;
+    beginHistoryReplay?(): void;
+    /** Force every currently eligible finalized prefix to retire before stop. */
+    beginHistoryFlush?(): void;
 }
 export interface TUIStartOptions {
     /** Clear saved native scrollback before the first paint. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.0.3",
+	"version": "18.0.5",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": "Stencil Labs, Inc.",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "18.0.3",
-		"@oh-my-pi/pi-utils": "18.0.3"
+		"@oh-my-pi/pi-natives": "18.0.5",
+		"@oh-my-pi/pi-utils": "18.0.5"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/components/loader.ts

@@ -32,7 +32,7 @@ export class Loader extends Text {
 		ui: TUI,
 		private spinnerColorFn: ColorFn,
 		private messageColorFn: LoaderMessageColorFn,
-		private message: string = "Loading...",
+		private message: string | (() => string) = "Loading...",
 		spinnerFrames?: string[],
 	) {
 		super("", 1, 0);
@@ -149,11 +149,18 @@ export class Loader extends Text {
 		}, delayMs);
 		this.#intervalId = timer;
 	}
-	/** Re-wrap the underlying Text only when its message or frame width changes. */
+	#resolveMessage(): string {
+		return typeof this.message === "function" ? this.message() : this.message;
+	}
+
+	/** Re-wrap the underlying Text only when its message or frame width changes.
+	 * When {@link message} is a function it is re-evaluated on every spinner
+	 * tick, so a dynamic label (e.g. a live countdown) advances in sync with
+	 * the glyph instead of freezing on the initial value. */
 	#syncText(): boolean {
 		const layoutFrame = this.#layoutFrames[this.#currentFrame];
 		this.#layoutFrame = layoutFrame;
-		return this.setText(`${layoutFrame} ${this.message}`);
+		return this.setText(`${layoutFrame} ${this.#resolveMessage()}`);
 	}
 
 	#requestPaint() {