@gajae-code/tui 0.18.8 → 0.18.10

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [Unreleased]
 
+## [0.18.10] - 2026-10-12
+
+### Fixed
+
+- TUI no longer goes blank after stop/restart cycles: `#hardwareCursorRow` is now properly reset during `stop()` to prevent stale cursor position state from corrupting viewport calculations on the next `start()`.
+
+- With `clearOnShrink` enabled, a live block that shrinks after the transcript has scrolled into history no longer leaves blank spacer rows above the pinned composer until the next resize. The contraction now clears the screen and history and replays the frame, so the viewport is filled again and no row appears twice in history.
+
+## [0.18.9] - 2026-10-11
+
+### Added
+
+- With mouse support on, dragging over Markdown copies the original Markdown instead of the painted glyphs: prose is joined across soft wraps, fully selected blocks copy their original Markdown (code with its original tabs, quotes with `>`), a selection inside a single code block drops the fences and presentation indent, and a partial table selection copies tab-separated cells without box drawing.
+- A held drag keeps extending while the wheel scrolls the transcript, and auto-scrolls while the pointer rests on the top or bottom transcript edge. A drag that leaves the window or crosses editor chrome keeps its selection instead of clearing it.
+
+### Fixed
+
+- Preserve the committed viewport frontier through bottom-pinned frame contractions and temporary manual-history handoffs, preventing scrolled-off transcript rows from being added to scrollback twice.
+
 ## [0.18.8] - 2026-10-08
 
 ## [0.18.7] - 2026-10-04

package/dist/types/tui.d.ts

@@ -500,6 +500,8 @@ export declare class TUI extends Container {
     /** Refresh terminal cell metrics for a verified external image transport. */
     refreshImageCellSize(): void;
     stop(): void;
+    /** Temporarily releases terminal modes for foreground handoff and preserves viewport state for restart. */
+    suspend(): void;
     /**
      * Viewport-repaint-aware resize render request.
      *

package/dist/types/utils.d.ts

@@ -46,7 +46,77 @@ export interface ViewportAnchorAnnotation {
     nextCell: number;
     token: string;
 }
+export interface CopyRowAnnotation {
+    token: number;
+    kind: string;
+    /** Actual logical source line corresponding to this row, never a token copy. */
+    source: string;
+    /**
+     * Present on the token's last row (also while streaming), for complete-token
+     * reconstruction. Only the growing tail token's last row changes per delta, and
+     * ending a stream leaves already-painted rows byte-identical.
+     */
+    tokenSource?: string;
+    /**
+     * This row's position among its token's rendered rows. A container that shows
+     * only part of a rendered token (a clipped preview) keeps it, so a selection can
+     * tell it does not start at the token's first row.
+     */
+    tokenRow: number;
+    /** The token's rendered row count; present with `tokenSource` on the last row only. */
+    tokenRows?: number;
+    /** `source` is this code row's original-spelling slice (tabs intact), at any nesting depth. */
+    originalCode?: true;
+    joinGap: string;
+    contentStart: number;
+    contentEnd: number;
+    continuation: boolean;
+    prefixColumns: number;
+    fence: boolean;
+    quoteDepth: number;
+    ranges?: Array<[number, number]>;
+    /**
+     * On a table row that continues the wrapped cells of the row above: per cell,
+     * the source text the soft wrap removed before this row's fragment.
+     */
+    cellGaps?: string[];
+}
 export declare const VIEWPORT_ANCHOR_PREFIX = "\u001B_AGJC_ANCHOR:";
+/**
+ * Copy annotations are emitted only while a TUI that copies mouse selections is
+ * running. The switch is process-wide: while it is on, every Markdown render in
+ * the process carries zero-width copy APCs, which TUI.#emit strips at the
+ * terminal write boundary. With no such TUI running, render() output is
+ * byte-identical to the stock renderer. Returns an idempotent release.
+ */
+export declare function retainCopyAnnotations(): () => void;
+export declare function copyAnnotationsEnabled(): boolean;
+/** Remove all copy APCs; applied to bytes at the terminal write boundary. */
+export declare function stripCopyApcs(data: string): string;
+/** Zero-width content origin; parent containers may prepend visible columns. */
+export declare function annotateCopyOrigin(line: string): string;
+/** Attach renderer-owned semantic copy data after a row's visible content. */
+export declare function annotateCopyRow(line: string, sourceId: string, annotation: CopyRowAnnotation): string;
+/** Read the annotation carried by this exact rendered row. */
+export declare function extractCopyRowAnnotation(line: string): {
+    line: string;
+    sourceId: string;
+    annotation: CopyRowAnnotation;
+    originColumn: number;
+} | null;
+/**
+ * Detach copy APCs from a row without decoding payloads: the visible line, the
+ * column of this process's origin marker, and the verbatim row APCs. Re-attaching
+ * `origin` at `originColumn` and `rows` after the content restores the annotations.
+ */
+export declare function splitCopyAnnotations(line: string): {
+    line: string;
+    origin: string;
+    originColumn: number;
+    rows: string;
+};
+/** Rebind cached semantic row data to the component that emitted this frame. */
+export declare function replaceCopyAnnotationSourceId(line: string, sourceId: string): string;
 /**
  * Tag every visible grapheme with an APC marker that survives ANSI-aware
  * wrapping. The marker contains source grapheme and monotonic cell offsets.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.18.8",
+	"version": "0.18.10",
 	"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.18.8",
-		"@gajae-code/utils": "0.18.8",
+		"@gajae-code/natives": "0.18.10",
+		"@gajae-code/utils": "0.18.10",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},