@gajae-code/tui 0.18.7 → 0.18.9

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [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
 
 ## [0.18.6] - 2026-10-03

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.7",
+	"version": "0.18.9",
 	"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.7",
-		"@gajae-code/utils": "0.18.7",
+		"@gajae-code/natives": "0.18.9",
+		"@gajae-code/utils": "0.18.9",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},