@fairyhunter13/opentui-core 0.1.130 → 0.1.131

package/{index-983h7jnd.js → index-t54p24hr.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   exports_src
-} from "./index-3dryhc1d.js";
+} from "./index-gwfqqvw5.js";
 import {
   __require
-} from "./index-pr4swpf9.js";
+} from "./index-t3rrpex7.js";
 
 // src/runtime-plugin.ts
 import { existsSync, readFileSync, realpathSync } from "fs";
@@ -408,4 +408,4 @@ function createRuntimePlugin(input = {}) {
 export { isCoreRuntimeModuleSpecifier, runtimeModuleIdForSpecifier, createRuntimePlugin };
 
 //# debugId=127A9B143CE0234164756E2164756E21
-//# sourceMappingURL=index-983h7jnd.js.map
+//# sourceMappingURL=index-t54p24hr.js.map

package/index.js

@@ -6,11 +6,9 @@ import {
   ArrowRenderable,
   BloomEffect,
   Box,
-  BoxRenderable,
   CRTRollingBarEffect,
   CloudsEffect,
   Code,
-  CodeRenderable,
   DEUTERANOPIA_COMP_MATRIX,
   DEUTERANOPIA_SIM_MATRIX,
   DiffRenderable,
@@ -31,7 +29,6 @@ import {
   PROTANOPIA_COMP_MATRIX,
   PROTANOPIA_SIM_MATRIX,
   RainbowTextEffect,
-  RootTextNodeRenderable,
   SEPIA_MATRIX,
   SOLARIZATION_MATRIX,
   SYNTHWAVE_MATRIX,
@@ -44,7 +41,6 @@ import {
   SliderRenderable,
   SlotRegistry,
   SlotRenderable,
-  SyntaxStyle,
   TECHNICOLOR_MATRIX,
   TRITANOPIA_COMP_MATRIX,
   TRITANOPIA_SIM_MATRIX,
@@ -52,10 +48,6 @@ import {
   TabSelectRenderable,
   TabSelectRenderableEvents,
   Text,
-  TextBufferRenderable,
-  TextBufferView,
-  TextNodeRenderable,
-  TextRenderable,
   TextTableRenderable,
   TextareaRenderable,
   TimeToFirstDrawRenderable,
@@ -70,16 +62,14 @@ import {
   applyNoise,
   applySaturation,
   applyScanlines,
-  convertThemeToStyles,
   createCoreSlotRegistry,
   createSlotRegistry,
   createTimeline,
   engine,
-  isTextNodeRenderable,
   registerCorePlugin,
   resolveCoreSlot,
   vstyles
-} from "./index-3dryhc1d.js";
+} from "./index-gwfqqvw5.js";
 import {
   ASCIIFontSelectionHelper,
   ATTRIBUTE_BASE_BITS,
@@ -87,8 +77,10 @@ import {
   BaseRenderable,
   BorderCharArrays,
   BorderChars,
+  BoxRenderable,
   CliRenderEvents,
   CliRenderer,
+  CodeRenderable,
   ConsolePosition,
   DataPathsManager,
   DebugOverlayCorner,
@@ -114,15 +106,21 @@ import {
   RenderableEvents,
   RendererControlState,
   RootRenderable,
+  RootTextNodeRenderable,
   Selection,
   StdinParser,
   StyledText,
+  SyntaxStyle,
   SystemClock,
   TargetChannel,
   TerminalConsole,
   TerminalPalette,
   TextAttributes,
   TextBuffer,
+  TextBufferRenderable,
+  TextBufferView,
+  TextNodeRenderable,
+  TextRenderable,
   TreeSitterClient,
   addDefaultParsers,
   attributesWithLink,
@@ -153,6 +151,7 @@ import {
   capture,
   clearEnvCache,
   convertGlobalToLocalSelection,
+  convertThemeToStyles,
   coordinateToCharacterIndex,
   createCliRenderer,
   createExtmarksController,
@@ -189,6 +188,7 @@ import {
   isEditBufferRenderable,
   isRenderable,
   isStyledText,
+  isTextNodeRenderable,
   isVNode,
   isValidBorderStyle,
   italic,
@@ -236,7 +236,7 @@ import {
   white,
   wrapWithDelegates,
   yellow
-} from "./index-pr4swpf9.js";
+} from "./index-t3rrpex7.js";
 export {
   yellow,
   wrapWithDelegates,
@@ -474,5 +474,5 @@ export {
   ACHROMATOPSIA_MATRIX
 };
 
-//# debugId=FD2591B7A1AB109264756E2164756E21
+//# debugId=32A13A6074BDA33364756E2164756E21
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "FD2591B7A1AB109264756E2164756E21",
+  "debugId": "32A13A6074BDA33364756E2164756E21",
   "names": []
 }

package/lib/render-geometry.d.ts

@@ -0,0 +1,8 @@
+export type RenderGeometryScreenMode = "alternate-screen" | "main-screen" | "split-footer";
+export interface RenderGeometry {
+    effectiveFooterHeight: number;
+    renderOffset: number;
+    renderWidth: number;
+    renderHeight: number;
+}
+export declare function calculateRenderGeometry(screenMode: RenderGeometryScreenMode, terminalWidth: number, terminalHeight: number, footerHeight: number): RenderGeometry;

package/lib/stdin-parser.d.ts

@@ -3,7 +3,7 @@ import { type ParsedKey } from "./parse.keypress.js";
 import { type RawMouseEvent } from "./parse.mouse.js";
 import type { PasteMetadata } from "./paste.js";
 export { SystemClock, type Clock, type TimerHandle } from "./clock.js";
-export type StdinResponseProtocol = "csi" | "osc" | "dcs" | "apc" | "unknown";
+export type StdinResponseProtocol = "csi" | "cpr" | "osc" | "dcs" | "apc" | "unknown";
 export type StdinEvent = {
     type: "key";
     raw: string;
@@ -27,6 +27,7 @@ export interface StdinParserProtocolContext {
     privateCapabilityRepliesActive: boolean;
     pixelResolutionQueryActive: boolean;
     explicitWidthCprActive: boolean;
+    startupCursorCprActive: boolean;
 }
 export interface StdinParserOptions {
     timeoutMs?: number;

package/package.json

@@ -4,7 +4,7 @@
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",
-  "version": "0.1.130",
+  "version": "0.1.131",
   "description": "OpenTUI is a TypeScript library on a native Zig core for building terminal user interfaces (TUIs)",
   "license": "MIT",
   "repository": {
@@ -67,12 +67,12 @@
     "bun-webgpu": "0.1.5",
     "planck": "^1.4.2",
     "three": "0.177.0",
-    "@fairyhunter13/opentui-core-darwin-x64": "0.1.130",
-    "@fairyhunter13/opentui-core-darwin-arm64": "0.1.130",
-    "@fairyhunter13/opentui-core-linux-x64": "0.1.130",
-    "@fairyhunter13/opentui-core-linux-arm64": "0.1.130",
-    "@fairyhunter13/opentui-core-win32-x64": "0.1.130",
-    "@fairyhunter13/opentui-core-win32-arm64": "0.1.130"
+    "@fairyhunter13/opentui-core-darwin-x64": "0.1.131",
+    "@fairyhunter13/opentui-core-darwin-arm64": "0.1.131",
+    "@fairyhunter13/opentui-core-linux-x64": "0.1.131",
+    "@fairyhunter13/opentui-core-linux-arm64": "0.1.131",
+    "@fairyhunter13/opentui-core-win32-x64": "0.1.131",
+    "@fairyhunter13/opentui-core-win32-arm64": "0.1.131"
   },
   "publishConfig": {
     "access": "public"

package/renderables/Markdown.d.ts

@@ -8,7 +8,16 @@ import { type TextTableColumnFitter, type TextTableColumnWidthMode, type TextTab
 import type { TreeSitterClient } from "../lib/tree-sitter/index.js";
 import { type ParseState } from "./markdown-parser.js";
 import type { OptimizedBuffer } from "../buffer.js";
+export type MarkdownTableStyle = "grid" | "columns";
 export interface MarkdownTableOptions {
+    /**
+     * Visual style preset for markdown tables.
+     * - "grid": boxed table with visible borders.
+     * - "columns": borderless columns optimized for separated block output.
+     *
+     * Defaults to "columns" in `internalBlockMode: "top-level"`, otherwise "grid".
+     */
+    style?: MarkdownTableStyle;
     /**
      * Strategy for sizing table columns.
      * - "content": columns fit to intrinsic content width.
@@ -81,6 +90,12 @@ export interface MarkdownOptions extends RenderableOptions<MarkdownRenderable> {
      * or undefined/null to use default rendering.
      */
     renderNode?: (token: Token, context: RenderNodeContext) => Renderable | undefined | null;
+    /**
+     * Internal only.
+     * - "coalesced": combine ordinary markdown into larger render blocks.
+     * - "top-level": preserve top-level markdown blocks as separate render blocks.
+     */
+    internalBlockMode?: "coalesced" | "top-level";
 }
 export interface RenderNodeContext {
     syntaxStyle: SyntaxStyle;
@@ -97,6 +112,7 @@ interface TableContentCache {
 export interface BlockState {
     token: MarkedToken;
     tokenRaw: string;
+    marginTop?: number;
     renderable: Renderable;
     tableContentCache?: TableContentCache;
 }
@@ -111,9 +127,11 @@ export declare class MarkdownRenderable extends Renderable {
     private _treeSitterClient?;
     private _tableOptions?;
     private _renderNode?;
+    private _internalBlockMode;
     _parseState: ParseState | null;
     private _streaming;
     _blockStates: BlockState[];
+    _stableBlockCount: number;
     private _styleDirty;
     private _linkifyMarkdownChunks;
     private _inlineConcealChunks;
@@ -122,6 +140,7 @@ export declare class MarkdownRenderable extends Renderable {
         conceal: true;
         concealCode: false;
         streaming: false;
+        internalBlockMode: "coalesced";
     };
     constructor(ctx: RenderContext, options: MarkdownOptions);
     get content(): string;
@@ -146,6 +165,7 @@ export declare class MarkdownRenderable extends Renderable {
     private renderInlineContent;
     private renderInlineToken;
     private renderInlineTokenWithStyle;
+    private applyMargins;
     private buildInlineConcealChunks;
     private renderBlockTokenInline;
     private renderListInline;
@@ -157,7 +177,9 @@ export declare class MarkdownRenderable extends Renderable {
     private getInterBlockMargin;
     private createMarkdownBlockToken;
     private normalizeMarkdownBlockRaw;
+    private normalizeScrollbackMarkdownBlockRaw;
     private buildRenderableTokens;
+    private buildTopLevelRenderBlocks;
     private getTableRowsToRender;
     private hashString;
     private hashTableToken;
@@ -165,13 +187,21 @@ export declare class MarkdownRenderable extends Renderable {
     private createTableDataCellChunks;
     private createTableHeaderCellChunks;
     private buildTableContentCache;
+    private resolveTableStyle;
+    private usesBorderlessColumnSpacing;
     private resolveTableRenderableOptions;
     private applyTableRenderableOptions;
     private applyTableOptionsToBlocks;
     private createTextTableRenderable;
     private createTableBlock;
+    private getStableBlockCount;
+    private syncTopLevelBlockState;
+    private getTopLevelBlockRaw;
+    private createTopLevelDefaultRenderable;
+    private createTopLevelRenderable;
     private createDefaultRenderable;
     private updateBlockRenderable;
+    private updateTopLevelBlocks;
     private updateBlocks;
     private clearBlockStates;
     /**

package/renderables/TextBufferRenderable.d.ts

@@ -33,6 +33,7 @@ export declare abstract class TextBufferRenderable extends Renderable implements
     protected _scrollX: number;
     protected _scrollY: number;
     protected _truncate: boolean;
+    protected _firstLineOffset: number;
     protected textBuffer: TextBuffer;
     protected textBufferView: TextBufferView;
     protected _textBufferSyntaxStyle: SyntaxStyle;

package/renderables/TextTable.d.ts

@@ -15,6 +15,7 @@ export interface TextTableOptions extends RenderableOptions<TextTableRenderable>
     columnWidthMode?: TextTableColumnWidthMode;
     columnFitter?: TextTableColumnFitter;
     cellPadding?: number;
+    columnGap?: number;
     showBorders?: boolean;
     border?: boolean;
     outerBorder?: boolean;
@@ -35,6 +36,7 @@ export declare class TextTableRenderable extends Renderable {
     private _columnWidthMode;
     private _columnFitter;
     private _cellPadding;
+    private _columnGap;
     private _showBorders;
     private _border;
     private _outerBorder;
@@ -71,6 +73,8 @@ export declare class TextTableRenderable extends Renderable {
     set columnFitter(value: TextTableColumnFitter);
     get cellPadding(): number;
     set cellPadding(value: number);
+    get columnGap(): number;
+    set columnGap(value: number);
     get showBorders(): boolean;
     set showBorders(value: boolean);
     get outerBorder(): boolean;
@@ -109,6 +113,8 @@ export declare class TextTableRenderable extends Renderable {
     private allocateShrinkByWeight;
     private computeRowHeights;
     private computeOffsets;
+    private getInterColumnGap;
+    private getTotalInterColumnGap;
     private applyLayoutToViews;
     private resolveBorderLayout;
     private getVerticalBorderCount;
@@ -135,6 +141,7 @@ export declare class TextTableRenderable extends Renderable {
     private getVerticalCellPadding;
     private resolveColumnFitter;
     private resolveCellPadding;
+    private resolveColumnGap;
     private invalidateLayoutAndRaster;
     private invalidateRasterOnly;
 }

package/renderables/markdown-parser.d.ts

@@ -2,6 +2,7 @@ import { type MarkedToken } from "marked";
 export interface ParseState {
     content: string;
     tokens: MarkedToken[];
+    stableTokenCount?: number;
 }
 /**
  * Incrementally parse markdown, reusing unchanged tokens from previous parse.

package/renderer.d.ts

@@ -20,6 +20,7 @@ export interface CliRendererConfig {
     testing?: boolean;
     exitOnCtrlC?: boolean;
     exitSignals?: NodeJS.Signals[];
+    clearOnShutdown?: boolean;
     forwardEnvKeys?: string[];
     debounceDelay?: number;
     targetFps?: number;
@@ -52,6 +53,40 @@ export type PixelResolution = {
     width: number;
     height: number;
 };
+export interface ScrollbackRenderContext {
+    width: number;
+    widthMethod: WidthMethod;
+    tailColumn: number;
+    renderContext: RenderContext;
+}
+export interface ScrollbackSnapshot {
+    root: Renderable;
+    width?: number;
+    height?: number;
+    rowColumns?: number;
+    startOnNewLine?: boolean;
+    trailingNewline?: boolean;
+    teardown?: () => void;
+}
+export type ScrollbackWriter = (ctx: ScrollbackRenderContext) => ScrollbackSnapshot;
+export interface ScrollbackSurfaceOptions {
+    startOnNewLine?: boolean;
+}
+export interface ScrollbackSurfaceCommitOptions {
+    rowColumns?: number;
+    trailingNewline?: boolean;
+}
+export interface ScrollbackSurface {
+    readonly renderContext: RenderContext;
+    readonly root: Renderable;
+    readonly width: number;
+    readonly height: number;
+    readonly isDestroyed: boolean;
+    render(): void;
+    settle(timeoutMs?: number): Promise<void>;
+    commitRows(startRow: number, endRowExclusive: number, options?: ScrollbackSurfaceCommitOptions): void;
+    destroy(): void;
+}
 /**
  * Kitty Keyboard Protocol configuration options
  * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement
@@ -190,6 +225,8 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     private animationRequest;
     private resizeTimeoutId;
     private capabilityTimeoutId;
+    private splitStartupSeedTimeoutId;
+    private pendingSplitStartupCursorSeed;
     private resizeDebounceDelay;
     private enableMouseMovement;
     private _useMouse;
@@ -197,6 +234,7 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     private _screenMode;
     private _footerHeight;
     private _externalOutputMode;
+    private clearOnShutdown;
     private _suspendedMouseEnabled;
     private _previousControlState;
     private capturedRenderable?;
@@ -207,11 +245,15 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     private clipboard;
     private _splitHeight;
     private renderOffset;
+    private splitTailColumn;
+    private pendingSplitFooterTransition;
+    private forceFullRepaintRequested;
+    private readonly maxSplitCommitsPerFrame;
     private _terminalWidth;
     private _terminalHeight;
     private _terminalIsSetup;
+    private externalOutputQueue;
     private realStdoutWrite;
-    private captureCallback;
     private _useConsole;
     private sigwinchHandler;
     private _capabilities;
@@ -227,6 +269,10 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     private _paletteDetectionPromise;
     private _onDestroy?;
     private _themeMode;
+    private _themeModeSource;
+    private _themeFallbackPending;
+    private _themeOscForeground;
+    private _themeOscBackground;
     private _terminalFocusState;
     private sequenceHandlers;
     private prependedInputHandlers;
@@ -291,13 +337,36 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     get currentControlState(): string;
     get capabilities(): any | null;
     get themeMode(): ThemeMode | null;
+    waitForThemeMode(timeoutMs?: number): Promise<ThemeMode | null>;
     getDebugInputs(): Array<{
         timestamp: string;
         sequence: string;
     }>;
     get useKittyKeyboard(): boolean;
     set useKittyKeyboard(use: boolean);
+    createScrollbackSurface(options?: ScrollbackSurfaceOptions): ScrollbackSurface;
+    writeToScrollback(write: ScrollbackWriter): void;
+    private getSnapshotWidth;
+    private getSnapshotHeight;
+    private getSnapshotRowWidths;
+    private publishSplitTailColumns;
+    private recordSplitCommit;
+    private enqueueRenderedScrollbackCommit;
+    private enqueueSplitCommit;
+    private createStdoutSnapshotCommit;
+    private splitStdoutRows;
+    private createStdoutSnapshotCommits;
+    private flushPendingSplitCommits;
     private interceptStdoutWrite;
+    private getSplitPinnedRenderOffset;
+    private getSplitCursorSeedRows;
+    private flushPendingSplitOutputBeforeTransition;
+    private resetSplitScrollback;
+    private syncSplitScrollback;
+    private clearPendingSplitFooterTransition;
+    private setPendingSplitFooterTransition;
+    private syncSplitFooterState;
+    private clearStaleSplitSurfaceRows;
     private applyScreenMode;
     private flushStdoutCache;
     private enableMouse;
@@ -312,9 +381,11 @@ export declare class CliRenderer extends EventEmitter implements RenderContext {
     removeInputHandler(handler: (sequence: string) => boolean): void;
     private updateStdinParserProtocolContext;
     subscribeOsc(handler: (sequence: string) => void): () => void;
+    private processCapabilitySequence;
     private capabilityHandler;
     private focusHandler;
     private themeModeHandler;
+    private applyThemeMode;
     private dispatchSequenceHandlers;
     private drainStdinParser;
     private handleStdinEvent;

package/runtime-plugin-support.js

@@ -2,9 +2,9 @@
 import {
   createRuntimePlugin,
   runtimeModuleIdForSpecifier
-} from "./index-983h7jnd.js";
-import"./index-3dryhc1d.js";
-import"./index-pr4swpf9.js";
+} from "./index-t54p24hr.js";
+import"./index-gwfqqvw5.js";
+import"./index-t3rrpex7.js";
 
 // src/runtime-plugin-support.ts
 var {plugin: registerBunPlugin } = globalThis.Bun;

package/runtime-plugin.js

@@ -3,9 +3,9 @@ import {
   createRuntimePlugin,
   isCoreRuntimeModuleSpecifier,
   runtimeModuleIdForSpecifier
-} from "./index-983h7jnd.js";
-import"./index-3dryhc1d.js";
-import"./index-pr4swpf9.js";
+} from "./index-t54p24hr.js";
+import"./index-gwfqqvw5.js";
+import"./index-t3rrpex7.js";
 export {
   runtimeModuleIdForSpecifier,
   isCoreRuntimeModuleSpecifier,

package/testing.js

@@ -3,8 +3,9 @@ import {
   ANSI,
   CliRenderer,
   TreeSitterClient,
+  calculateRenderGeometry,
   resolveRenderLib
-} from "./index-pr4swpf9.js";
+} from "./index-t3rrpex7.js";
 
 // src/testing/test-renderer.ts
 import { Readable, Writable } from "stream";
@@ -522,9 +523,11 @@ async function setupTestRenderer(config) {
   const width = config.width || config.stdout?.columns || process.stdout.columns || 80;
   const height = config.height || config.stdout?.rows || process.stdout.rows || 24;
   const stdout = config.stdout || new TestWriteStream(width, height);
-  const renderHeight = config.screenMode === "split-footer" ? config.footerHeight ?? 12 : height;
+  const screenMode = config.screenMode ?? "alternate-screen";
+  const footerHeight = config.footerHeight ?? 12;
+  const geometry = calculateRenderGeometry(screenMode, width, height, footerHeight);
   const ziglib = resolveRenderLib();
-  const rendererPtr = ziglib.createRenderer(width, renderHeight, {
+  const rendererPtr = ziglib.createRenderer(geometry.renderWidth, geometry.renderHeight, {
     testing: true,
     remote: config.remote ?? false
   });
@@ -693,5 +696,5 @@ export {
   KeyCodes
 };
 
-//# debugId=75C57AE1327A974C64756E2164756E21
+//# debugId=269D1D9A5FEEE19764756E2164756E21
 //# sourceMappingURL=testing.js.map