@opentui/core 0.1.5 → 0.1.7

package/3d.js

@@ -33976,6 +33976,18 @@ function parseJustify(value) {
       return Justify.FlexStart;
   }
 }
+function parsePositionType(value) {
+  switch (value.toLowerCase()) {
+    case "static":
+      return PositionType.Static;
+    case "relative":
+      return PositionType.Relative;
+    case "absolute":
+      return PositionType.Absolute;
+    default:
+      return PositionType.Static;
+  }
+}
 
 // src/Renderable.ts
 var renderableNumber = 1;
@@ -34286,8 +34298,8 @@ class Renderable extends EventEmitter3 {
       this.layoutNode.setHeight(options.height);
     }
     this._positionType = options.position ?? "relative";
-    if (this._positionType === "absolute") {
-      node.setPositionType(PositionType.Absolute);
+    if (this._positionType !== "relative") {
+      node.setPositionType(parsePositionType(this._positionType));
     }
     const hasPositionProps = options.top !== undefined || options.right !== undefined || options.bottom !== undefined || options.left !== undefined;
     if (hasPositionProps) {
@@ -34346,6 +34358,14 @@ class Renderable extends EventEmitter3 {
       node.setPadding(Edge2.Left, options.paddingLeft);
     }
   }
+  set position(positionType) {
+    if (this._positionType === positionType)
+      return;
+    this._positionType = positionType;
+    this.layoutNode.yogaNode.setPositionType(parsePositionType(positionType));
+    this.needsUpdate();
+    this._yogaPerformancePositionUpdated = true;
+  }
   setPosition(position) {
     this._position = { ...this._position, ...position };
     this.updateYogaPosition(position);
@@ -34853,7 +34873,7 @@ function getOpenTUILib(libPath) {
       returns: "ptr"
     },
     destroyRenderer: {
-      args: ["ptr"],
+      args: ["ptr", "bool", "u32"],
       returns: "void"
     },
     setUseThread: {
@@ -35008,6 +35028,14 @@ function getOpenTUILib(libPath) {
       args: ["ptr", "i64"],
       returns: "void"
     },
+    enableMouse: {
+      args: ["ptr", "bool"],
+      returns: "void"
+    },
+    disableMouse: {
+      args: ["ptr"],
+      returns: "void"
+    },
     createTextBuffer: {
       args: ["u32"],
       returns: "ptr"
@@ -35116,8 +35144,8 @@ class FFIRenderLib {
   createRenderer(width, height) {
     return this.opentui.symbols.createRenderer(width, height);
   }
-  destroyRenderer(renderer) {
-    this.opentui.symbols.destroyRenderer(renderer);
+  destroyRenderer(renderer, useAlternateScreen, splitHeight) {
+    this.opentui.symbols.destroyRenderer(renderer, useAlternateScreen, splitHeight);
   }
   setUseThread(renderer, useThread) {
     this.opentui.symbols.setUseThread(renderer, useThread);
@@ -35327,6 +35355,12 @@ class FFIRenderLib {
     const ts = timestamp ?? Date.now();
     this.opentui.symbols.dumpStdoutBuffer(renderer, ts);
   }
+  enableMouse(renderer, enableMovement) {
+    this.opentui.symbols.enableMouse(renderer, enableMovement);
+  }
+  disableMouse(renderer) {
+    this.opentui.symbols.disableMouse(renderer);
+  }
   createTextBuffer(capacity) {
     const bufferPtr = this.opentui.symbols.createTextBuffer(capacity);
     if (!bufferPtr) {
@@ -35553,6 +35587,77 @@ var BorderCharArrays = {
   rounded: borderCharsToArray(BorderChars.rounded),
   heavy: borderCharsToArray(BorderChars.heavy)
 };
+// src/lib/styled-text.ts
+var textEncoder = new TextEncoder;
+
+class StyledText {
+  chunks;
+  _plainText = "";
+  constructor(chunks) {
+    this.chunks = chunks;
+    for (let i = 0;i < chunks.length; i++) {
+      this._plainText += chunks[i].plainText;
+    }
+  }
+  toString() {
+    return this._plainText;
+  }
+  _chunksToPlainText() {
+    this._plainText = "";
+    for (const chunk of this.chunks) {
+      this._plainText += chunk.plainText;
+    }
+  }
+  insert(chunk, index) {
+    const originalLength = this.chunks.length;
+    if (index === undefined) {
+      this.chunks.push(chunk);
+    } else {
+      this.chunks.splice(index, 0, chunk);
+    }
+    if (index === undefined || index === originalLength) {
+      this._plainText += chunk.plainText;
+    } else {
+      this._chunksToPlainText();
+    }
+  }
+  remove(chunk) {
+    const originalLength = this.chunks.length;
+    const index = this.chunks.indexOf(chunk);
+    if (index === -1)
+      return;
+    this.chunks.splice(index, 1);
+    if (index === originalLength - 1) {
+      this._plainText = this._plainText.slice(0, this._plainText.length - chunk.plainText.length);
+    } else {
+      this._chunksToPlainText();
+    }
+  }
+  replace(chunk, oldChunk) {
+    const index = this.chunks.indexOf(oldChunk);
+    if (index === -1)
+      return;
+    this.chunks.splice(index, 1, chunk);
+    if (index === this.chunks.length - 1) {
+      this._plainText = this._plainText.slice(0, this._plainText.length - oldChunk.plainText.length) + chunk.plainText;
+    } else {
+      this._chunksToPlainText();
+    }
+  }
+}
+function stringToStyledText(content) {
+  const textEncoder2 = new TextEncoder;
+  const chunk = {
+    __isChunk: true,
+    text: textEncoder2.encode(content),
+    plainText: content
+  };
+  return new StyledText([chunk]);
+}
+var templateCache = new WeakMap;
+
+// src/lib/hast-styled-text.ts
+var textEncoder2 = new TextEncoder;
 // src/buffer.ts
 var fbIdCounter = 0;
 function isRGBAWithAlpha(color) {
@@ -35933,35 +36038,6 @@ class TimelineEngine {
   }
 }
 var engine = new TimelineEngine;
-// src/lib/styled-text.ts
-var textEncoder = new TextEncoder;
-
-class StyledText {
-  chunks;
-  _length;
-  _plainText;
-  constructor(chunks, length, plainText) {
-    this.chunks = chunks;
-    this._length = length;
-    this._plainText = plainText;
-  }
-  toString() {
-    return this._plainText;
-  }
-  get length() {
-    return this._length;
-  }
-}
-function stringToStyledText(content) {
-  const textEncoder2 = new TextEncoder;
-  const chunk = {
-    __isChunk: true,
-    text: textEncoder2.encode(content),
-    plainText: content
-  };
-  return new StyledText([chunk], content.length, content);
-}
-var templateCache = new WeakMap;
 // src/lib/selection.ts
 class Selection {
   _anchor;
@@ -36142,7 +36218,10 @@ var ANSI = {
   enableAnyEventTracking: "\x1B[?1003h",
   disableAnyEventTracking: "\x1B[?1003l",
   enableSGRMouseMode: "\x1B[?1006h",
-  disableSGRMouseMode: "\x1B[?1006l"
+  disableSGRMouseMode: "\x1B[?1006l",
+  makeRoomForRenderer: (height) => `
+`.repeat(height) + `\x1B[${height}A`,
+  clearRendererSpace: (height) => `\x1B[${height}A\x1B[1G\x1B[J`
 };
 
 // src/console.ts
@@ -36925,6 +37004,11 @@ class MouseEvent {
     this._defaultPrevented = true;
   }
 }
+["SIGINT", "SIGTERM", "SIGQUIT", "SIGABRT"].forEach((signal) => {
+  process.on(signal, () => {
+    process.exit();
+  });
+});
 var animationFrameId = 0;
 
 class CliRenderer extends EventEmitter6 {
@@ -36934,7 +37018,6 @@ class CliRenderer extends EventEmitter6 {
   stdout;
   exitOnCtrlC;
   isDestroyed = false;
-  isShuttingDown = false;
   nextRenderBuffer;
   currentRenderBuffer;
   _isRunning = false;
@@ -36956,6 +37039,7 @@ class CliRenderer extends EventEmitter6 {
   postProcessFns = [];
   backgroundColor = RGBA.fromHex("#000000");
   waitingForPixelResolution = false;
+  shutdownRequested = null;
   rendering = false;
   renderingNative = false;
   renderTimeout = null;
@@ -37059,8 +37143,6 @@ class CliRenderer extends EventEmitter6 {
     }
     this.stdout.write = this.interceptStdoutWrite.bind(this);
     this.sigwinchHandler = () => {
-      if (this.isShuttingDown)
-        return;
       const width2 = this.stdout.columns || 80;
       const height2 = this.stdout.rows || 24;
       this.handleResize(width2, height2);
@@ -37068,6 +37150,7 @@ class CliRenderer extends EventEmitter6 {
     process.on("SIGWINCH", this.sigwinchHandler);
     const handleError = (error) => {
       this.stop();
+      this.destroy();
       new Promise((resolve2) => {
         setTimeout(() => {
           resolve2(true);
@@ -37101,8 +37184,7 @@ Error details:
     };
     process.on("uncaughtException", handleError);
     process.on("unhandledRejection", handleError);
-    process.on("exit", (code) => {
-      this.stop();
+    process.on("exit", () => {
       this.destroy();
     });
     this._console = new TerminalConsole(this, config.consoleOptions);
@@ -37121,6 +37203,13 @@ Error details:
     }
     global.window.requestAnimationFrame = requestAnimationFrame;
     this.queryPixelResolution();
+    if (process.env.OTUI_NO_NATIVE_RENDER === "true") {
+      this.renderNative = () => {
+        if (this._splitHeight > 0) {
+          this.flushStdoutCache(this._splitHeight);
+        }
+      };
+    }
   }
   writeOut(chunk, encoding, callback) {
     return this.realStdoutWrite.call(this.stdout, chunk, encoding, callback);
@@ -37252,30 +37341,17 @@ Error details:
     return true;
   }
   enableMouse() {
-    this.writeOut(ANSI.enableSGRMouseMode);
-    this.writeOut(ANSI.enableMouseTracking);
-    this.writeOut(ANSI.enableButtonEventTracking);
-    if (this.enableMouseMovement) {
-      this.writeOut(ANSI.enableAnyEventTracking);
-    }
+    this.lib.enableMouse(this.rendererPtr, this.enableMouseMovement);
   }
   disableMouse() {
-    if (this.enableMouseMovement) {
-      this.writeOut(ANSI.disableAnyEventTracking);
-    }
-    this.writeOut(ANSI.disableButtonEventTracking);
-    this.writeOut(ANSI.disableMouseTracking);
-    this.writeOut(ANSI.disableSGRMouseMode);
     this.capturedRenderable = undefined;
     this.mouseParser.reset();
+    this.lib.disableMouse(this.rendererPtr);
   }
   set useThread(useThread) {
     this._useThread = useThread;
     this.lib.setUseThread(this.rendererPtr, useThread);
   }
-  setTerminalSize(width, height) {
-    this.handleResize(width, height);
-  }
   setupTerminal() {
     this.writeOut(ANSI.saveCursorState);
     if (this.stdin.setRawMode) {
@@ -37302,7 +37378,7 @@ Error details:
       }
       if (this.exitOnCtrlC && str === "\x03") {
         process.nextTick(() => {
-          process.exit(0);
+          process.exit();
         });
         return;
       }
@@ -37313,6 +37389,8 @@ Error details:
     });
     if (this._useAlternateScreen) {
       this.writeOut(ANSI.switchToAlternateScreen);
+    } else {
+      this.writeOut(ANSI.makeRoomForRenderer(this.height - 1));
     }
     this.setCursorPosition(0, 0, false);
   }
@@ -37434,7 +37512,7 @@ Error details:
     }
   }
   handleResize(width, height) {
-    if (this.isShuttingDown)
+    if (this.isDestroyed)
       return;
     if (this._splitHeight > 0) {
       this.processResize(width, height);
@@ -37571,44 +37649,31 @@ Error details:
     this._isRunning = false;
   }
   stop() {
-    if (this.isShuttingDown)
+    if (this.isRunning && !this.isDestroyed) {
+      this._isRunning = false;
+      if (this.memorySnapshotTimer) {
+        clearInterval(this.memorySnapshotTimer);
+        this.memorySnapshotTimer = null;
+      }
+      if (this.renderTimeout) {
+        clearTimeout(this.renderTimeout);
+        this.renderTimeout = null;
+      }
+    }
+  }
+  destroy() {
+    if (this.isDestroyed)
       return;
-    this._isRunning = false;
-    this.isShuttingDown = true;
+    this.isDestroyed = true;
     this.waitingForPixelResolution = false;
+    this.capturedRenderable = undefined;
     if (this.sigwinchHandler) {
       process.removeListener("SIGWINCH", this.sigwinchHandler);
       this.sigwinchHandler = null;
     }
     this._console.deactivate();
+    this.lib.destroyRenderer(this.rendererPtr, this._useAlternateScreen, this._splitHeight);
     this.disableStdoutInterception();
-    if (this.renderTimeout) {
-      clearTimeout(this.renderTimeout);
-      this.renderTimeout = null;
-    }
-    if (this.memorySnapshotTimer) {
-      clearInterval(this.memorySnapshotTimer);
-      this.memorySnapshotTimer = null;
-    }
-    if (this._splitHeight > 0) {
-      const consoleEndLine = this._terminalHeight - this._splitHeight;
-      this.writeOut(ANSI.moveCursor(consoleEndLine, 1));
-    }
-    this.capturedRenderable = undefined;
-    if (this._useMouse) {
-      this.disableMouse();
-    }
-    this.writeOut(ANSI.resetCursorColor);
-    this.writeOut(ANSI.showCursor);
-    if (this._useAlternateScreen) {
-      this.writeOut(ANSI.switchToMainScreen);
-    }
-  }
-  destroy() {
-    if (this.isDestroyed)
-      return;
-    this.lib.destroyRenderer(this.rendererPtr);
-    this.isDestroyed = true;
   }
   startRenderLoop() {
     if (!this._isRunning)
@@ -37621,7 +37686,7 @@ Error details:
     this.loop();
   }
   async loop() {
-    if (this.rendering)
+    if (this.rendering || this.isDestroyed)
       return;
     this.rendering = true;
     if (this.renderTimeout) {
@@ -37866,8 +37931,6 @@ class TextRenderable extends Renderable {
   set content(value) {
     this._text = typeof value === "string" ? stringToStyledText(value) : value;
     this.updateTextInfo();
-    this.setupMeasureFunc();
-    this.needsUpdate();
   }
   get fg() {
     return this._defaultFg;
@@ -37929,8 +37992,8 @@ class TextRenderable extends Renderable {
     const changed = this.selectionHelper.reevaluateSelection(this.width, this.height);
     if (changed) {
       this.syncSelectionToTextBuffer();
-      this.needsUpdate();
     }
+    this.needsUpdate();
   }
   setupMeasureFunc() {
     if (this._positionType === "relative" && this._width === "auto") {

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 opentui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -3,6 +3,8 @@
 OpenTUI Core is a TypeScript library for building terminal user interfaces (TUIs). It is currently in
 development and is not ready for production use.
 
+[Getting Started](docs/getting-started.md)
+
 ## Install
 
 ```bash

package/Renderable.d.ts

@@ -126,6 +126,7 @@ export declare abstract class Renderable extends EventEmitter {
     private ensureZIndexSorted;
     private setupYogaProperties;
     private setupMarginAndPadding;
+    set position(positionType: PositionTypeString);
     setPosition(position: Position): void;
     private updateYogaPosition;
     set flexGrow(grow: number);

package/ansi.d.ts

@@ -23,4 +23,6 @@ export declare const ANSI: {
     disableAnyEventTracking: string;
     enableSGRMouseMode: string;
     disableSGRMouseMode: string;
+    makeRoomForRenderer: (height: number) => string;
+    clearRendererSpace: (height: number) => string;
 };

package/index.d.ts

@@ -12,3 +12,4 @@ export * from "./lib/selection";
 export * from "./renderer";
 export * from "./renderables";
 export * from "./zig";
+export * from "./console";