@gajae-code/tui 0.12.7 → 0.12.8

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+## [0.12.8] - 2026-08-02
+### Fixed
+
+- Fixed a tool block being rendered two or three times in the transcript (a pending `⏳` copy stranded above its own completed `✓` copy, with the rows between duplicated). When a block above the live viewport top grows in place — the bash tool's compact call render becoming a partial box and then a final box, with the editor/status chrome keeping it off-screen — the "commit only the changed visible suffix" path emitted rows by index even though the growth had shifted committed content down across the native-scrollback frontier, so rows already in scrollback were appended a second time under their new content. The suffix commit is now taken only when the last committed row is unchanged (a same-length off-screen substitution, such as a streaming status line); growth that shifts the committed boundary repaints the live viewport instead.
+- Temporary TUI restarts now retain their native-scrollback admission frontier when the following viewport repaint fails, preventing newly appended rows from being duplicated on retry.
+- Restored the `isProcessTerminal`/`shouldUseViewportRepaintForHost` gate on the width-change viewport-repaint intercept so plain terminals (non-multiplexer, non-process-terminal) use `fullRender` for width changes instead of an unconditional viewport repaint. The #3684 chain removed this gate, causing lossless Korean/CJK prose wrapping to break at narrow widths because the viewport repaint only painted the visible rows without committing the full transcript to scrollback (#1979).
+- Restored the `fullRender` fallback for the `firstChanged < viewportTop` branch on non-viewport-repaint hosts, so above-viewport mutations replay the full frame instead of silently viewport-repainting.
+- Propagated IME cursor write failure from `#writeRenderBufferAndReanchorImeCursor` so callers detect terminal detach when the deferred cursor write fails after the shared frame commits.
+
 ## [0.12.7] - 2026-07-31
 
 ## [0.12.6] - 2026-07-31
@@ -9,6 +18,7 @@
 
 - Truncated text now shrinks horizontal padding when the viewport is narrower than the requested inset, keeping every rendered line within its width contract.
 - Select-list no-match rows now stay within the requested render width instead of wrapping into extra terminal lines after narrow resizes (#3600).
+- Preserve transcript rows when a resize/reflow is coalesced with appended output.
 
 ## [0.12.5] - 2026-07-30
 

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

@@ -54,7 +54,7 @@ export declare class Editor implements Component, Focusable {
     disableSubmit: boolean;
     constructor(theme: EditorTheme);
     dispose(): void;
-    setAutocompleteProvider(provider: AutocompleteProvider): void;
+    setAutocompleteProvider(provider: AutocompleteProvider | undefined): void;
     getAutocompleteProvider(): AutocompleteProvider | undefined;
     /** Whether the autocomplete dropdown is currently open. */
     isAutocompleteOpen(): boolean;

package/dist/types/tui.d.ts

@@ -279,11 +279,6 @@ export declare class TUI extends Container {
     getShowHardwareCursor(): boolean;
     setShowHardwareCursor(enabled: boolean): void;
     getClearOnShrink(): boolean;
-    /**
-     * Set whether to trigger full re-render when content shrinks.
-     * When true (default), empty rows are cleared when content shrinks.
-     * When false, empty rows remain (reduces redraws on slower terminals).
-     */
     setClearOnShrink(enabled: boolean): void;
     setFocus(component: Component | null): void;
     /** Returns the currently focused component without exposing mutable focus state. */
@@ -306,7 +301,7 @@ export declare class TUI extends Container {
     setViewportAnchorComponent(component: Component | null): void;
     /** Returns the direct component registered as the semantic viewport anchor source. */
     getViewportAnchorComponent(): Component | null;
-    /** Clear manual viewport ownership before replacing the transcript identity namespace. */
+    /** Clear manual viewport ownership and durable history before replacing the transcript identity. */
     resetViewportAnchorIntent(): void;
     /** Allow one semantic-neighbor reconciliation after a definitive same-transcript rebuild. */
     prepareViewportAnchorForTranscriptRebuild(): void;
@@ -345,24 +340,14 @@ export declare class TUI extends Container {
     /**
      * Viewport-repaint-aware resize render request.
      *
-     * A forced full redraw (`requestRender(true)`) resets `#previousWidth`/`#previousHeight`
-     * to -1, which makes `#doRender` treat the frame as a width change and fall into the
-     * `fullRender` path. In terminal multiplexers that path skips the scrollback-clearing
-     * `3J` escape (users navigate scrollback history), so replaying every transcript line
-     * piles it back on top of scrollback — the "top of screen scrolls down to the prompt at
-     * high speed" resize storm. Windows Terminal/ConPTY can also visibly jump to
-     * the transcript top during streaming redraws, so viewport-repaint sessions
-     * keep force off and let `#doRender` repaint only the live viewport. Set
-     * `PI_TUI_LEGACY_MULTIPLEXER_FULL_RENDER=1` to restore the legacy tmux redraw.
+     * A forced repaint resets `#previousWidth`/`#previousHeight` to -1, which makes
+     * `#doRender` treat the frame as a dimension change. Repaints stay anchored to
+     * the live viewport so native scrollback is never replayed or erased.
      *
      * Spurious resize events (SIGWINCH with unchanged dimensions — iTerm2 tab
      * switches and window focus changes, the self-sent SIGWINCH after resume)
-     * must not force either: on hosts still using the `fullRender` path (legacy
-     * multiplexer opt-in, non-process terminals) the forced redraw clears
-     * scrollback (`2J`/`H`/`3J`) and replays the whole transcript, which can
-     * park the native viewport at the transcript top. Only force when the grid
-     * size actually changed since the last committed frame; a plain diff render
-     * is a no-op otherwise.
+     * must not force either: only force when the grid size actually changed since
+     * the last committed frame.
      */
     requestResizeRender(): void;
     requestRender(force?: boolean, source?: string): void;
@@ -378,10 +363,9 @@ export declare class TUI extends Container {
     /** Retry queued terminal cleanup after terminal recovery or before shutdown. */
     flushTerminalCleanup(): void;
     /**
-     * Register an emitter whose escape payload is appended to every render
-     * write (inside its own synchronized-output block, cursor saved/restored).
-     * Used for absolute-positioned overlays such as pixel-image pets that live
-     * outside the line-based component model. Return null to emit nothing.
+     * Register an emitter whose payload is delivered after each shared render
+     * transaction. The emitter is an exempt physical overlay: its bytes are
+     * deliberately kept out of the shared transcript write.
      */
     setPostRenderEmitter(emitter: (() => string | null) | undefined): void;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.12.7",
+	"version": "0.12.8",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://gajae-code.com",
 	"author": "Yeachan-Heo and Gajae Code Contributors",
@@ -36,8 +36,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@gajae-code/natives": "0.12.7",
-		"@gajae-code/utils": "0.12.7",
+		"@gajae-code/natives": "0.12.8",
+		"@gajae-code/utils": "0.12.8",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/components/editor.ts

@@ -522,8 +522,13 @@ export class Editor implements Component, Focusable {
 		this.#disposeTabWidthListener = undefined;
 	}
 
-	setAutocompleteProvider(provider: AutocompleteProvider): void {
+	setAutocompleteProvider(provider: AutocompleteProvider | undefined): void {
 		this.#autocompleteProvider = provider;
+		if (provider === undefined) {
+			this.#cancelAutocomplete();
+			this.onAutocompleteUpdate?.();
+		}
+		this.invalidate();
 	}
 
 	getAutocompleteProvider(): AutocompleteProvider | undefined {