@opentui/core 0.5.6 → 0.5.8

package/lib/selection.d.ts

@@ -1,5 +1,5 @@
 import { Renderable } from "../Renderable.js";
-import type { ViewportBounds } from "../types.js";
+import type { SelectionBehavior, ViewportBounds } from "../types.js";
 import { fonts } from "./ascii.font.js";
 export declare class Selection {
     private _anchor;
@@ -9,13 +9,14 @@ export declare class Selection {
     private _isActive;
     private _isDragging;
     private _isStart;
+    behavior: SelectionBehavior;
     constructor(anchorRenderable: Renderable, anchor: {
         x: number;
         y: number;
     }, focus: {
         x: number;
         y: number;
-    });
+    }, behavior?: SelectionBehavior);
     get isStart(): boolean;
     set isStart(value: boolean);
     get anchor(): {
@@ -47,6 +48,7 @@ export interface LocalSelectionBounds {
     focusX: number;
     focusY: number;
     isActive: boolean;
+    behavior: SelectionBehavior;
 }
 export declare function convertGlobalToLocalSelection(globalSelection: Selection | null, localX: number, localY: number): LocalSelectionBounds | null;
 export declare class ASCIIFontSelectionHelper {

package/package.json

@@ -4,7 +4,7 @@
   "main": "index.node.js",
   "types": "index.d.ts",
   "type": "module",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "OpenTUI is a TypeScript library on a native Zig core for building terminal user interfaces (TUIs)",
   "license": "MIT",
   "repository": {
@@ -75,13 +75,13 @@
     "web-tree-sitter": "0.25.10"
   },
   "optionalDependencies": {
-    "@opentui/core-darwin-x64": "0.5.6",
-    "@opentui/core-darwin-arm64": "0.5.6",
-    "@opentui/core-linux-x64": "0.5.6",
-    "@opentui/core-linux-arm64": "0.5.6",
-    "@opentui/core-win32-x64": "0.5.6",
-    "@opentui/core-win32-arm64": "0.5.6",
-    "@opentui/core-linux-x64-musl": "0.5.6",
-    "@opentui/core-linux-arm64-musl": "0.5.6"
+    "@opentui/core-darwin-x64": "0.5.8",
+    "@opentui/core-darwin-arm64": "0.5.8",
+    "@opentui/core-linux-x64": "0.5.8",
+    "@opentui/core-linux-arm64": "0.5.8",
+    "@opentui/core-win32-x64": "0.5.8",
+    "@opentui/core-win32-arm64": "0.5.8",
+    "@opentui/core-linux-x64-musl": "0.5.8",
+    "@opentui/core-linux-arm64-musl": "0.5.8"
   }
 }

package/renderables/EditBufferRenderable.d.ts

@@ -3,7 +3,7 @@ import { Selection, type LocalSelectionBounds } from "../lib/selection.js";
 import { EditBuffer, type LogicalCursor } from "../edit-buffer.js";
 import { EditorView, type VisualCursor } from "../editor-view.js";
 import { RGBA } from "../lib/RGBA.js";
-import type { RenderContext, Highlight, CursorStyleOptions, LineInfoProvider, LineInfo } from "../types.js";
+import type { RenderContext, Highlight, CursorStyleOptions, LineInfoProvider, LineInfo, SelectionOccupancy } from "../types.js";
 import type { OptimizedBuffer } from "../buffer.js";
 import type { SyntaxStyle } from "../syntax-style.js";
 declare const BrandedEditBufferRenderable: unique symbol;
@@ -36,6 +36,7 @@ export interface EditBufferOptions extends RenderableOptions<EditBufferRenderabl
     showCursor?: boolean;
     cursorColor?: string | RGBA;
     cursorStyle?: CursorStyleOptions;
+    selectionOccupancy?: SelectionOccupancy;
     syntaxStyle?: SyntaxStyle;
     tabIndicator?: string | number;
     tabIndicatorColor?: string | RGBA;
@@ -120,6 +121,8 @@ export declare abstract class EditBufferRenderable extends Renderable implements
     set cursorColor(value: RGBA | string);
     get cursorStyle(): CursorStyleOptions;
     set cursorStyle(style: CursorStyleOptions);
+    get selectionOccupancy(): SelectionOccupancy;
+    set selectionOccupancy(value: SelectionOccupancy | null | undefined);
     get tabIndicator(): string | number | undefined;
     set tabIndicator(value: string | number | undefined);
     get tabIndicatorColor(): RGBA | undefined;
@@ -153,6 +156,7 @@ export declare abstract class EditBufferRenderable extends Renderable implements
     deleteCharBackward(): boolean;
     newLine(): boolean;
     deleteLine(): boolean;
+    private collapseSelectionToEdge;
     moveCursorLeft(options?: {
         select?: boolean;
     }): boolean;

package/renderer.d.ts

@@ -1,5 +1,5 @@
 import { Renderable, RootRenderable } from "./Renderable.js";
-import { DebugOverlayCorner, type CursorStyleOptions, type MousePointerStyle, type RenderContext, type TerminalCapabilities, type ThemeMode, type WidthMethod } from "./types.js";
+import { DebugOverlayCorner, type CursorStyleOptions, type MousePointerStyle, type RenderContext, type TerminalCapabilities, type ThemeMode, type SelectionBehavior, type WidthMethod } from "./types.js";
 import { RGBA, type ColorInput } from "./lib/RGBA.js";
 import { OptimizedBuffer } from "./buffer.js";
 import { type NativeBufferedOutput, type NativeRenderStats, type RendererHandle } from "./zig.js";
@@ -295,6 +295,7 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     private lastOverRenderable?;
     private currentSelection;
     private selectionContainers;
+    private lastClick;
     private clipboard;
     private _splitHeight;
     private renderOffset;
@@ -585,11 +586,13 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     get hasSelection(): boolean;
     getSelectionContainer(): Renderable | null;
     clearSelection(): void;
+    private clearSelectionState;
     /**
      * Start a new selection at the given coordinates.
      * Used by both mouse and keyboard selection.
      */
-    startSelection(renderable: Renderable, x: number, y: number): void;
+    startSelection(renderable: Renderable, x: number, y: number, behavior?: SelectionBehavior): void;
+    private nextClickBehavior;
     updateSelection(currentRenderable: Renderable | undefined, x: number, y: number, options?: {
         finishDragging?: boolean;
     }): void;

package/testing.bun.js

@@ -2,11 +2,11 @@
 import {
   ANSI,
   CliRenderer
-} from "./chunk-bun-da1keqyp.js";
+} from "./chunk-bun-b3exa82d.js";
 import {
   SystemClock,
   TreeSitterClient
-} from "./chunk-bun-9335djz2.js";
+} from "./chunk-bun-2956gvaq.js";
 
 // src/testing/mock-keys.ts
 import { Buffer as Buffer2 } from "buffer";

package/testing.js

@@ -1,11 +1,11 @@
 import {
   ANSI,
   CliRenderer
-} from "./chunk-node-ks0581vk.js";
+} from "./chunk-node-kr27pp2p.js";
 import {
   SystemClock,
   TreeSitterClient
-} from "./chunk-node-2h23nsbj.js";
+} from "./chunk-node-mfda59vq.js";
 
 // src/testing/mock-keys.ts
 import { Buffer as Buffer2 } from "node:buffer";

package/text-buffer-view.d.ts

@@ -1,6 +1,7 @@
 import { RGBA } from "./lib/RGBA.js";
 import { type LineInfo, type MeasureResult, type RenderLib, type TextBufferViewHandle } from "./zig.js";
 import type { TextBuffer } from "./text-buffer.js";
+import type { SelectionBehavior, SelectionOccupancy } from "./types.js";
 export declare class TextBufferView {
     private lib;
     private viewPtr;
@@ -18,9 +19,11 @@ export declare class TextBufferView {
         end: number;
     } | null;
     hasSelection(): boolean;
-    setLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA): boolean;
-    updateLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA): boolean;
+    setLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA, behavior?: SelectionBehavior): boolean;
+    updateLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA, behavior?: SelectionBehavior): boolean;
     resetLocalSelection(): void;
+    setSelectionOccupancy(occupancy: SelectionOccupancy): void;
+    getSelectionOccupancy(): SelectionOccupancy;
     setWrapWidth(width: number | null): void;
     setWrapMode(mode: "none" | "char" | "word"): void;
     setFirstLineOffset(offset: number): void;

package/types.d.ts

@@ -24,6 +24,15 @@ export declare const ATTRIBUTE_BASE_MASK = 255;
 export declare function getBaseAttributes(attr: number): number;
 export type ThemeMode = "dark" | "light";
 export type CursorStyle = "block" | "line" | "underline" | "default";
+/** How a selection occupies cells between stored anchor and focus offsets.
+ * Independent of `cursorStyle` (CSI `q` is paint). Default `cell` includes
+ * the grapheme under the max endpoint. `boundary` is the half-open insert
+ * range `[min, max)`. */
+export type SelectionOccupancy = "cell" | "boundary";
+/** How local cell coordinates expand into a highlight range.
+ * `cell` is the current inclusive press/drag. `word` and `line` expand
+ * each endpoint through native selectWord / selectLine. */
+export type SelectionBehavior = "cell" | "word" | "line";
 export type MousePointerStyle = "default" | "pointer" | "text" | "crosshair" | "move" | "not-allowed";
 export interface CursorStyleOptions {
     style?: CursorStyle;
@@ -42,7 +51,7 @@ export declare enum TargetChannel {
     BG = 2,
     Both = 3
 }
-export type WidthMethod = "wcwidth" | "unicode";
+export type WidthMethod = "wcwidth" | "unicode" | "unicode-wide";
 export type TerminalMultiplexer = "none" | "tmux" | "zellij" | "screen" | "unknown";
 export type TerminalCapabilityState = "unknown" | "supported" | "unsupported";
 export type ImageRenderProtocol = "auto" | "kitty" | "sixel" | "blocks";
@@ -128,7 +137,7 @@ export interface RenderContext extends EventEmitter {
     keyInput: KeyHandler;
     _internalKeyInput: InternalKeyHandler;
     clearSelection: () => void;
-    startSelection: (renderable: Renderable, x: number, y: number) => void;
+    startSelection: (renderable: Renderable, x: number, y: number, behavior?: SelectionBehavior) => void;
     updateSelection: (currentRenderable: Renderable | undefined, x: number, y: number, options?: {
         finishDragging?: boolean;
     }) => void;

package/yoga.bun.js

@@ -93,7 +93,7 @@ import {
   WRAP_WRAP_REVERSE,
   Wrap,
   yoga_default
-} from "./chunk-bun-9335djz2.js";
+} from "./chunk-bun-2956gvaq.js";
 export {
   yoga_default as default,
   Wrap,

package/yoga.js

@@ -92,7 +92,7 @@ import {
   WRAP_WRAP_REVERSE,
   Wrap,
   yoga_default
-} from "./chunk-node-2h23nsbj.js";
+} from "./chunk-node-mfda59vq.js";
 export {
   yoga_default as default,
   Wrap,

package/zig-structs.d.ts

@@ -38,6 +38,7 @@ export declare const VisualCursorStruct: import("bun-ffi-structs").DefineStructR
 export declare const TerminalCapabilitiesStruct: import("bun-ffi-structs").DefineStructReturnType<[readonly ["kitty_keyboard", "bool_u8"], readonly ["kitty_graphics", "bool_u8"], readonly ["rgb", "bool_u8"], readonly ["ansi256", "bool_u8"], readonly ["unicode", import("bun-ffi-structs").EnumDef<{
     wcwidth: number;
     unicode: number;
+    "unicode-wide": number;
 }>], readonly ["sgr_pixels", "bool_u8"], readonly ["color_scheme_updates", "bool_u8"], readonly ["explicit_width", "bool_u8"], readonly ["scaled_text", "bool_u8"], readonly ["sixel", "bool_u8"], readonly ["focus_tracking", "bool_u8"], readonly ["sync", "bool_u8"], readonly ["bracketed_paste", "bool_u8"], readonly ["hyperlinks", "bool_u8"], readonly ["osc52", "bool_u8"], readonly ["notifications", "bool_u8"], readonly ["explicit_cursor_positioning", "bool_u8"], readonly ["remote", "bool_u8"], readonly ["multiplexer", import("bun-ffi-structs").EnumDef<{
     none: number;
     tmux: number;

package/zig.d.ts

@@ -1,5 +1,5 @@
 import { type FFICallbackInstance, type Pointer } from "./platform/ffi.js";
-import { type CursorStyle, type CursorStyleOptions, type TargetChannel, type DebugOverlayCorner, type WidthMethod, type TerminalCapabilities, type Highlight, type LineInfo, type ImageRenderProtocol } from "./types.js";
+import { type CursorStyle, type CursorStyleOptions, type SelectionOccupancy, type SelectionBehavior, type TargetChannel, type DebugOverlayCorner, type WidthMethod, type TerminalCapabilities, type Highlight, type LineInfo, type ImageRenderProtocol } from "./types.js";
 export type { LineInfo, AllocatorStats, AudioStreamCreateOptions, BuildOptions, NativeAudioCaptureStats, NativeAudioStreamStats, NativeRenderStats, };
 import { RGBA } from "./lib/RGBA.js";
 import { OptimizedBuffer } from "./buffer.js";
@@ -474,10 +474,12 @@ export interface RenderLib extends AudioEngineLib {
         start: number;
         end: number;
     } | null;
-    textBufferViewSetLocalSelection: (view: TextBufferViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null) => boolean;
+    textBufferViewSetLocalSelection: (view: TextBufferViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, behavior?: SelectionBehavior) => boolean;
     textBufferViewUpdateSelection: (view: TextBufferViewHandle, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
-    textBufferViewUpdateLocalSelection: (view: TextBufferViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null) => boolean;
+    textBufferViewUpdateLocalSelection: (view: TextBufferViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, behavior?: SelectionBehavior) => boolean;
     textBufferViewResetLocalSelection: (view: TextBufferViewHandle) => void;
+    textBufferViewSetSelectionOccupancy: (view: TextBufferViewHandle, occupancy: SelectionOccupancy) => void;
+    textBufferViewGetSelectionOccupancy: (view: TextBufferViewHandle) => SelectionOccupancy;
     textBufferViewSetWrapWidth: (view: TextBufferViewHandle, width: number) => void;
     textBufferViewSetWrapMode: (view: TextBufferViewHandle, mode: "none" | "char" | "word") => void;
     textBufferViewSetFirstLineOffset: (view: TextBufferViewHandle, offset: number) => void;
@@ -573,10 +575,14 @@ export interface RenderLib extends AudioEngineLib {
         start: number;
         end: number;
     } | null;
-    editorViewSetLocalSelection: (view: EditorViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, updateCursor: boolean, followCursor: boolean) => boolean;
+    editorViewSetLocalSelection: (view: EditorViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, updateCursor: boolean, followCursor: boolean, behavior?: SelectionBehavior) => boolean;
     editorViewUpdateSelection: (view: EditorViewHandle, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
-    editorViewUpdateLocalSelection: (view: EditorViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, updateCursor: boolean, followCursor: boolean) => boolean;
+    editorViewUpdateLocalSelection: (view: EditorViewHandle, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null, updateCursor: boolean, followCursor: boolean, behavior?: SelectionBehavior) => boolean;
     editorViewResetLocalSelection: (view: EditorViewHandle) => void;
+    editorViewConvertSelectionToCell: (view: EditorViewHandle) => boolean;
+    editorViewSetSelectionOccupancy: (view: EditorViewHandle, occupancy: SelectionOccupancy) => void;
+    editorViewSetSelectionInclusive: (view: EditorViewHandle, start: number, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
+    editorViewSetSelectionColors: (view: EditorViewHandle, bgColor: RGBA | null, fgColor: RGBA | null) => void;
     editorViewGetSelectedTextBytes: (view: EditorViewHandle, maxLength: number) => Uint8Array | null;
     editorViewGetCursor: (view: EditorViewHandle) => {
         row: number;
@@ -593,6 +599,7 @@ export interface RenderLib extends AudioEngineLib {
     editorViewGetEOL: (view: EditorViewHandle) => VisualCursor;
     editorViewGetVisualSOL: (view: EditorViewHandle) => VisualCursor;
     editorViewGetVisualEOL: (view: EditorViewHandle) => VisualCursor;
+    editorViewGotoVisualLineEnd: (view: EditorViewHandle) => void;
     editorViewGetLineInfo: (view: EditorViewHandle) => LineInfo;
     editorViewGetLogicalLineInfo: (view: EditorViewHandle) => LineInfo;
     editorViewSetPlaceholderStyledText: (view: EditorViewHandle, chunks: Array<{