@opentui/core 0.1.12 → 0.1.14

package/{index-bpwzbxgn.js → index-rv93tneq.js}

@@ -4822,7 +4822,7 @@ class ASCIIFontSelectionHelper {
   }
 }
 // src/zig.ts
-import { dlopen, toArrayBuffer } from "bun:ffi";
+import { dlopen, toArrayBuffer, JSCallback } from "bun:ffi";
 import { existsSync } from "fs";
 
 // src/buffer.ts
@@ -4890,7 +4890,7 @@ class OptimizedBuffer {
     return this.bufferPtr;
   }
   constructor(lib, ptr, buffer, width, height, options) {
-    this.id = `fb_${OptimizedBuffer.fbIdCounter++}`;
+    this.id = options.id || `fb_${OptimizedBuffer.fbIdCounter++}`;
     this.lib = lib;
     this.respectAlpha = options.respectAlpha || false;
     this._width = width;
@@ -4901,7 +4901,8 @@ class OptimizedBuffer {
   static create(width, height, widthMethod, options = {}) {
     const lib = resolveRenderLib();
     const respectAlpha = options.respectAlpha || false;
-    return lib.createOptimizedBuffer(width, height, widthMethod, respectAlpha);
+    const id = options.id && options.id.trim() !== "" ? options.id : "unnamed buffer";
+    return lib.createOptimizedBuffer(width, height, widthMethod, respectAlpha, id);
   }
   get buffers() {
     return this.buffer;
@@ -4919,6 +4920,9 @@ class OptimizedBuffer {
     this.lib.bufferSetRespectAlpha(this.bufferPtr, respectAlpha);
     this.respectAlpha = respectAlpha;
   }
+  getNativeId() {
+    return this.lib.bufferGetId(this.bufferPtr);
+  }
   clear(bg2 = RGBA.fromValues(0, 0, 0, 1), clearChar = " ") {
     if (this.useFFI) {
       this.clearFFI(bg2);
@@ -5180,6 +5184,15 @@ class OptimizedBuffer {
     const packedOptions = packDrawOptions(options.border, options.shouldFill ?? false, options.titleAlignment || "left");
     this.lib.bufferDrawBox(this.bufferPtr, options.x, options.y, options.width, options.height, borderChars, packedOptions, options.borderColor, options.backgroundColor, options.title ?? null);
   }
+  pushScissorRect(x, y, width, height) {
+    this.lib.bufferPushScissorRect(this.bufferPtr, x, y, width, height);
+  }
+  popScissorRect() {
+    this.lib.bufferPopScissorRect(this.bufferPtr);
+  }
+  clearScissorRects() {
+    this.lib.bufferClearScissorRects(this.bufferPtr);
+  }
 }
 
 // src/zig.ts
@@ -5191,6 +5204,10 @@ if (!existsSync(targetLibPath)) {
 function getOpenTUILib(libPath) {
   const resolvedLibPath = libPath || targetLibPath;
   return dlopen(resolvedLibPath, {
+    setLogCallback: {
+      args: ["ptr"],
+      returns: "void"
+    },
     createRenderer: {
       args: ["u32", "u32"],
       returns: "ptr"
@@ -5232,7 +5249,7 @@ function getOpenTUILib(libPath) {
       returns: "ptr"
     },
     createOptimizedBuffer: {
-      args: ["u32", "u32", "bool", "u8"],
+      args: ["u32", "u32", "bool", "u8", "ptr", "usize"],
       returns: "ptr"
     },
     destroyOptimizedBuffer: {
@@ -5279,6 +5296,10 @@ function getOpenTUILib(libPath) {
       args: ["ptr", "bool"],
       returns: "void"
     },
+    bufferGetId: {
+      args: ["ptr", "ptr", "usize"],
+      returns: "usize"
+    },
     bufferDrawText: {
       args: ["ptr", "ptr", "u32", "u32", "u32", "ptr", "ptr", "u8"],
       returns: "void"
@@ -5319,6 +5340,10 @@ function getOpenTUILib(libPath) {
       args: ["ptr"],
       returns: "void"
     },
+    setTerminalTitle: {
+      args: ["ptr", "ptr", "usize"],
+      returns: "void"
+    },
     bufferDrawSuperSampleBuffer: {
       args: ["ptr", "u32", "u32", "ptr", "usize", "u8", "u32"],
       returns: "void"
@@ -5331,6 +5356,18 @@ function getOpenTUILib(libPath) {
       args: ["ptr", "i32", "i32", "u32", "u32", "ptr", "u32", "ptr", "ptr", "ptr", "u32"],
       returns: "void"
     },
+    bufferPushScissorRect: {
+      args: ["ptr", "i32", "i32", "u32", "u32"],
+      returns: "void"
+    },
+    bufferPopScissorRect: {
+      args: ["ptr"],
+      returns: "void"
+    },
+    bufferClearScissorRects: {
+      args: ["ptr"],
+      returns: "void"
+    },
     addToHitGrid: {
       args: ["ptr", "i32", "i32", "u32", "u32", "u32"],
       returns: "void"
@@ -5477,12 +5514,67 @@ function getOpenTUILib(libPath) {
     }
   });
 }
+var LogLevel2;
+((LogLevel3) => {
+  LogLevel3[LogLevel3["Error"] = 0] = "Error";
+  LogLevel3[LogLevel3["Warn"] = 1] = "Warn";
+  LogLevel3[LogLevel3["Info"] = 2] = "Info";
+  LogLevel3[LogLevel3["Debug"] = 3] = "Debug";
+})(LogLevel2 ||= {});
 
 class FFIRenderLib {
   opentui;
   encoder = new TextEncoder;
+  decoder = new TextDecoder;
+  logCallbackWrapper;
   constructor(libPath) {
     this.opentui = getOpenTUILib(libPath);
+    this.setupLogging();
+  }
+  setupLogging() {
+    if (this.logCallbackWrapper) {
+      return;
+    }
+    const logCallback = new JSCallback((level, msgPtr, msgLenBigInt) => {
+      try {
+        const msgLen = typeof msgLenBigInt === "bigint" ? Number(msgLenBigInt) : msgLenBigInt;
+        if (msgLen === 0 || !msgPtr) {
+          return;
+        }
+        const msgBuffer = toArrayBuffer(msgPtr, 0, msgLen);
+        const msgBytes = new Uint8Array(msgBuffer);
+        const message = this.decoder.decode(msgBytes);
+        switch (level) {
+          case 0 /* Error */:
+            console.error(message);
+            break;
+          case 1 /* Warn */:
+            console.warn(message);
+            break;
+          case 2 /* Info */:
+            console.info(message);
+            break;
+          case 3 /* Debug */:
+            console.debug(message);
+            break;
+          default:
+            console.log(message);
+        }
+      } catch (error) {
+        console.error("Error in Zig log callback:", error);
+      }
+    }, {
+      args: ["u8", "ptr", "usize"],
+      returns: "void"
+    });
+    this.logCallbackWrapper = logCallback;
+    if (!logCallback.ptr) {
+      throw new Error("Failed to create log callback");
+    }
+    this.setLogCallback(logCallback.ptr);
+  }
+  setLogCallback(callbackPtr) {
+    this.opentui.symbols.setLogCallback(callbackPtr);
   }
   createRenderer(width, height) {
     return this.opentui.symbols.createRenderer(width, height);
@@ -5514,7 +5606,7 @@ class FFIRenderLib {
     const height = this.opentui.symbols.getBufferHeight(bufferPtr);
     const size = width * height;
     const buffers = this.getBuffer(bufferPtr, size);
-    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, {});
+    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, { id: "next buffer" });
   }
   getCurrentBuffer(renderer) {
     const bufferPtr = this.opentui.symbols.getCurrentBuffer(renderer);
@@ -5525,7 +5617,7 @@ class FFIRenderLib {
     const height = this.opentui.symbols.getBufferHeight(bufferPtr);
     const size = width * height;
     const buffers = this.getBuffer(bufferPtr, size);
-    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, {});
+    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, { id: "current buffer" });
   }
   getBuffer(bufferPtr, size) {
     const charPtr = this.opentui.symbols.bufferGetCharPtr(bufferPtr);
@@ -5560,32 +5652,32 @@ class FFIRenderLib {
     return buffers;
   }
   bufferGetCharPtr(buffer) {
-    const ptr = this.opentui.symbols.bufferGetCharPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.bufferGetCharPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get char pointer");
     }
-    return ptr;
+    return ptr2;
   }
   bufferGetFgPtr(buffer) {
-    const ptr = this.opentui.symbols.bufferGetFgPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.bufferGetFgPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get fg pointer");
     }
-    return ptr;
+    return ptr2;
   }
   bufferGetBgPtr(buffer) {
-    const ptr = this.opentui.symbols.bufferGetBgPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.bufferGetBgPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get bg pointer");
     }
-    return ptr;
+    return ptr2;
   }
   bufferGetAttributesPtr(buffer) {
-    const ptr = this.opentui.symbols.bufferGetAttributesPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.bufferGetAttributesPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get attributes pointer");
     }
-    return ptr;
+    return ptr2;
   }
   bufferGetRespectAlpha(buffer) {
     return this.opentui.symbols.bufferGetRespectAlpha(buffer);
@@ -5593,6 +5685,13 @@ class FFIRenderLib {
   bufferSetRespectAlpha(buffer, respectAlpha) {
     this.opentui.symbols.bufferSetRespectAlpha(buffer, respectAlpha);
   }
+  bufferGetId(buffer) {
+    const maxLen = 256;
+    const outBuffer = new Uint8Array(maxLen);
+    const actualLen = this.opentui.symbols.bufferGetId(buffer, outBuffer, maxLen);
+    const len = typeof actualLen === "bigint" ? Number(actualLen) : actualLen;
+    return this.decoder.decode(outBuffer.slice(0, len));
+  }
   getBufferWidth(buffer) {
     return this.opentui.symbols.getBufferWidth(buffer);
   }
@@ -5653,18 +5752,20 @@ class FFIRenderLib {
   render(renderer, force) {
     this.opentui.symbols.render(renderer, force);
   }
-  createOptimizedBuffer(width, height, widthMethod, respectAlpha = false) {
+  createOptimizedBuffer(width, height, widthMethod, respectAlpha = false, id) {
     if (Number.isNaN(width) || Number.isNaN(height)) {
       console.error(new Error(`Invalid dimensions for OptimizedBuffer: ${width}x${height}`).stack);
     }
     const widthMethodCode = widthMethod === "wcwidth" ? 0 : 1;
-    const bufferPtr = this.opentui.symbols.createOptimizedBuffer(width, height, respectAlpha, widthMethodCode);
+    const idToUse = id || "unnamed buffer";
+    const idBytes = this.encoder.encode(idToUse);
+    const bufferPtr = this.opentui.symbols.createOptimizedBuffer(width, height, respectAlpha, widthMethodCode, idBytes, idBytes.length);
     if (!bufferPtr) {
       throw new Error(`Failed to create optimized buffer: ${width}x${height}`);
     }
     const size = width * height;
     const buffers = this.getBuffer(bufferPtr, size);
-    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, { respectAlpha });
+    return new OptimizedBuffer(this, bufferPtr, buffers, width, height, { respectAlpha, id });
   }
   destroyOptimizedBuffer(bufferPtr) {
     this.opentui.symbols.destroyOptimizedBuffer(bufferPtr);
@@ -5682,6 +5783,10 @@ class FFIRenderLib {
   clearTerminal(renderer) {
     this.opentui.symbols.clearTerminal(renderer);
   }
+  setTerminalTitle(renderer, title) {
+    const titleBytes = this.encoder.encode(title);
+    this.opentui.symbols.setTerminalTitle(renderer, titleBytes, titleBytes.length);
+  }
   addToHitGrid(renderer, x, y, width, height, id) {
     this.opentui.symbols.addToHitGrid(renderer, x, y, width, height, id);
   }
@@ -5736,32 +5841,32 @@ class FFIRenderLib {
     this.opentui.symbols.destroyTextBuffer(buffer);
   }
   textBufferGetCharPtr(buffer) {
-    const ptr = this.opentui.symbols.textBufferGetCharPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.textBufferGetCharPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get TextBuffer char pointer");
     }
-    return ptr;
+    return ptr2;
   }
   textBufferGetFgPtr(buffer) {
-    const ptr = this.opentui.symbols.textBufferGetFgPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.textBufferGetFgPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get TextBuffer fg pointer");
     }
-    return ptr;
+    return ptr2;
   }
   textBufferGetBgPtr(buffer) {
-    const ptr = this.opentui.symbols.textBufferGetBgPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.textBufferGetBgPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get TextBuffer bg pointer");
     }
-    return ptr;
+    return ptr2;
   }
   textBufferGetAttributesPtr(buffer) {
-    const ptr = this.opentui.symbols.textBufferGetAttributesPtr(buffer);
-    if (!ptr) {
+    const ptr2 = this.opentui.symbols.textBufferGetAttributesPtr(buffer);
+    if (!ptr2) {
       throw new Error("Failed to get TextBuffer attributes pointer");
     }
-    return ptr;
+    return ptr2;
   }
   textBufferGetLength(buffer) {
     return this.opentui.symbols.textBufferGetLength(buffer);
@@ -5855,6 +5960,15 @@ class FFIRenderLib {
     const clipHeight = clipRect?.height ?? 0;
     this.opentui.symbols.bufferDrawTextBuffer(buffer, textBuffer, x, y, clipX, clipY, clipWidth, clipHeight, hasClipRect);
   }
+  bufferPushScissorRect(buffer, x, y, width, height) {
+    this.opentui.symbols.bufferPushScissorRect(buffer, x, y, width, height);
+  }
+  bufferPopScissorRect(buffer) {
+    this.opentui.symbols.bufferPopScissorRect(buffer);
+  }
+  bufferClearScissorRects(buffer) {
+    this.opentui.symbols.bufferClearScissorRects(buffer);
+  }
   getTerminalCapabilities(renderer) {
     const capsBuffer = new Uint8Array(64);
     this.opentui.symbols.getTerminalCapabilities(renderer, capsBuffer);
@@ -5911,9 +6025,9 @@ class TextBuffer {
   _length = 0;
   _capacity;
   _lineInfo;
-  constructor(lib, ptr, buffer, capacity) {
+  constructor(lib, ptr2, buffer, capacity) {
     this.lib = lib;
-    this.bufferPtr = ptr;
+    this.bufferPtr = ptr2;
     this.buffer = buffer;
     this._capacity = capacity;
   }
@@ -6045,9 +6159,12 @@ function isPositionType(value) {
   }
   return isValidPercentage(value);
 }
-function isPostionTypeType(value) {
+function isPositionTypeType(value) {
   return value === "relative" || value === "absolute";
 }
+function isOverflowType(value) {
+  return value === "visible" || value === "hidden" || value === "scroll";
+}
 function isDimensionType(value) {
   return isPositionType(value);
 }
@@ -6076,6 +6193,8 @@ class Renderable extends EventEmitter3 {
   id;
   num;
   _ctx;
+  _translateX = 0;
+  _translateY = 0;
   _x = 0;
   _y = 0;
   _width;
@@ -6099,6 +6218,7 @@ class Renderable extends EventEmitter3 {
   _keyListeners = {};
   layoutNode;
   _positionType = "relative";
+  _overflow = "visible";
   _position = {};
   _childHostOverride = null;
   renderableMap = new Map;
@@ -6159,7 +6279,7 @@ class Renderable extends EventEmitter3 {
     if (this._focused) {
       this.blur();
     }
-    this.needsUpdate();
+    this.requestRender();
   }
   hasSelection() {
     return false;
@@ -6181,7 +6301,7 @@ class Renderable extends EventEmitter3 {
     if (this._focused || !this.focusable)
       return;
     this._focused = true;
-    this.needsUpdate();
+    this.requestRender();
     this.keypressHandler = (key) => {
       this._keyListeners["down"]?.(key);
       if (this.handleKeyPress) {
@@ -6199,7 +6319,7 @@ class Renderable extends EventEmitter3 {
     if (!this._focused || !this.focusable)
       return;
     this._focused = false;
-    this.needsUpdate();
+    this.requestRender();
     if (this.keypressHandler) {
       this.keyHandler.off("keypress", this.keypressHandler);
       this.keypressHandler = null;
@@ -6258,15 +6378,33 @@ class Renderable extends EventEmitter3 {
   markClean() {
     this._dirty = false;
   }
-  needsUpdate() {
+  requestRender() {
     this._dirty = true;
-    this._ctx.needsUpdate();
+    this._ctx.requestRender();
+  }
+  get translateX() {
+    return this._translateX;
+  }
+  set translateX(value) {
+    if (this._translateX === value)
+      return;
+    this._translateX = value;
+    this.requestRender();
+  }
+  get translateY() {
+    return this._translateY;
+  }
+  set translateY(value) {
+    if (this._translateY === value)
+      return;
+    this._translateY = value;
+    this.requestRender();
   }
   get x() {
     if (this.parent && this._positionType === "relative") {
-      return this.parent.x + this._x;
+      return this.parent.x + this._x + this._translateX;
     }
-    return this._x;
+    return this._x + this._translateX;
   }
   set x(value) {
     this.left = value;
@@ -6305,9 +6443,9 @@ class Renderable extends EventEmitter3 {
   }
   get y() {
     if (this.parent && this._positionType === "relative") {
-      return this.parent.y + this._y;
+      return this.parent.y + this._y + this._translateY;
     }
-    return this._y;
+    return this._y + this._translateY;
   }
   set y(value) {
     this.top = value;
@@ -6319,7 +6457,7 @@ class Renderable extends EventEmitter3 {
     if (isDimensionType(value)) {
       this._width = value;
       this.layoutNode.setWidth(value);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   get height() {
@@ -6329,7 +6467,7 @@ class Renderable extends EventEmitter3 {
     if (isDimensionType(value)) {
       this._height = value;
       this.layoutNode.setHeight(value);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   get zIndex() {
@@ -6375,12 +6513,18 @@ class Renderable extends EventEmitter3 {
     if (options.flexDirection !== undefined) {
       node.setFlexDirection(parseFlexDirection(options.flexDirection));
     }
+    if (options.flexWrap !== undefined) {
+      node.setFlexWrap(parseWrap(options.flexWrap));
+    }
     if (options.alignItems !== undefined) {
       node.setAlignItems(parseAlign(options.alignItems));
     }
     if (options.justifyContent !== undefined) {
       node.setJustifyContent(parseJustify(options.justifyContent));
     }
+    if (options.alignSelf !== undefined) {
+      node.setAlignSelf(parseAlign(options.alignSelf));
+    }
     if (isDimensionType(options.width)) {
       this._width = options.width;
       this.layoutNode.setWidth(options.width);
@@ -6393,6 +6537,10 @@ class Renderable extends EventEmitter3 {
     if (this._positionType !== "relative") {
       node.setPositionType(parsePositionType(this._positionType));
     }
+    this._overflow = options.overflow === "hidden" ? "hidden" : options.overflow === "scroll" ? "scroll" : "visible";
+    if (this._overflow !== "visible") {
+      node.setOverflow(parseOverflow(this._overflow));
+    }
     const hasPositionProps = options.top !== undefined || options.right !== undefined || options.bottom !== undefined || options.left !== undefined;
     if (hasPositionProps) {
       this._position = {
@@ -6451,11 +6599,21 @@ class Renderable extends EventEmitter3 {
     }
   }
   set position(positionType) {
-    if (!isPostionTypeType(positionType) || this._positionType === positionType)
+    if (!isPositionTypeType(positionType) || this._positionType === positionType)
       return;
     this._positionType = positionType;
     this.layoutNode.yogaNode.setPositionType(parsePositionType(positionType));
-    this.needsUpdate();
+    this.requestRender();
+  }
+  get overflow() {
+    return this._overflow;
+  }
+  set overflow(overflow) {
+    if (!isOverflowType(overflow) || this._overflow === overflow)
+      return;
+    this._overflow = overflow;
+    this.layoutNode.yogaNode.setOverflow(parseOverflow(overflow));
+    this.requestRender();
   }
   setPosition(position) {
     this._position = { ...this._position, ...position };
@@ -6492,56 +6650,64 @@ class Renderable extends EventEmitter3 {
         node.setPosition(Edge.Left, left);
       }
     }
-    this.needsUpdate();
+    this.requestRender();
   }
   set flexGrow(grow) {
     this.layoutNode.yogaNode.setFlexGrow(grow);
-    this.needsUpdate();
+    this.requestRender();
   }
   set flexShrink(shrink) {
     this.layoutNode.yogaNode.setFlexShrink(shrink);
-    this.needsUpdate();
+    this.requestRender();
   }
   set flexDirection(direction) {
     this.layoutNode.yogaNode.setFlexDirection(parseFlexDirection(direction));
-    this.needsUpdate();
+    this.requestRender();
+  }
+  set flexWrap(wrap) {
+    this.layoutNode.yogaNode.setFlexWrap(parseWrap(wrap));
+    this.requestRender();
   }
   set alignItems(alignItems) {
     this.layoutNode.yogaNode.setAlignItems(parseAlign(alignItems));
-    this.needsUpdate();
+    this.requestRender();
   }
   set justifyContent(justifyContent) {
     this.layoutNode.yogaNode.setJustifyContent(parseJustify(justifyContent));
-    this.needsUpdate();
+    this.requestRender();
+  }
+  set alignSelf(alignSelf) {
+    this.layoutNode.yogaNode.setAlignSelf(parseAlign(alignSelf));
+    this.requestRender();
   }
   set flexBasis(basis) {
     if (isFlexBasisType(basis)) {
       this.layoutNode.yogaNode.setFlexBasis(basis);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set minWidth(minWidth) {
     if (isSizeType(minWidth)) {
       this.layoutNode.yogaNode.setMinWidth(minWidth);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set maxWidth(maxWidth) {
     if (isSizeType(maxWidth)) {
       this.layoutNode.yogaNode.setMaxWidth(maxWidth);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set minHeight(minHeight) {
     if (isSizeType(minHeight)) {
       this.layoutNode.yogaNode.setMinHeight(minHeight);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set maxHeight(maxHeight) {
     if (isSizeType(maxHeight)) {
       this.layoutNode.yogaNode.setMaxHeight(maxHeight);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set margin(margin) {
@@ -6551,31 +6717,31 @@ class Renderable extends EventEmitter3 {
       node.setMargin(Edge.Right, margin);
       node.setMargin(Edge.Bottom, margin);
       node.setMargin(Edge.Left, margin);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set marginTop(margin) {
     if (isMarginType(margin)) {
       this.layoutNode.yogaNode.setMargin(Edge.Top, margin);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set marginRight(margin) {
     if (isMarginType(margin)) {
       this.layoutNode.yogaNode.setMargin(Edge.Right, margin);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set marginBottom(margin) {
     if (isMarginType(margin)) {
       this.layoutNode.yogaNode.setMargin(Edge.Bottom, margin);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set marginLeft(margin) {
     if (isMarginType(margin)) {
       this.layoutNode.yogaNode.setMargin(Edge.Left, margin);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set padding(padding) {
@@ -6585,31 +6751,31 @@ class Renderable extends EventEmitter3 {
       node.setPadding(Edge.Right, padding);
       node.setPadding(Edge.Bottom, padding);
       node.setPadding(Edge.Left, padding);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set paddingTop(padding) {
     if (isPaddingType(padding)) {
       this.layoutNode.yogaNode.setPadding(Edge.Top, padding);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set paddingRight(padding) {
     if (isPaddingType(padding)) {
       this.layoutNode.yogaNode.setPadding(Edge.Right, padding);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set paddingBottom(padding) {
     if (isPaddingType(padding)) {
       this.layoutNode.yogaNode.setPadding(Edge.Bottom, padding);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   set paddingLeft(padding) {
     if (isPaddingType(padding)) {
       this.layoutNode.yogaNode.setPadding(Edge.Left, padding);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   getLayoutNode() {
@@ -6632,7 +6798,7 @@ class Renderable extends EventEmitter3 {
     if (this._visible) {
       this.handleFrameBufferResize(width, height);
       this.onResize(width, height);
-      this.needsUpdate();
+      this.requestRender();
     }
   }
   handleFrameBufferResize(width, height) {
@@ -6661,7 +6827,9 @@ class Renderable extends EventEmitter3 {
       this.frameBuffer = null;
     }
   }
-  onResize(width, height) {}
+  onResize(width, height) {
+    this.emit("resize");
+  }
   replaceParent(obj) {
     if (obj.parent) {
       obj.parent.remove(obj.id);
@@ -6692,7 +6860,7 @@ class Renderable extends EventEmitter3 {
     if (obj._liveCount > 0) {
       this.propagateLiveCount(obj._liveCount);
     }
-    this.needsUpdate();
+    this.requestRender();
     return insertedIndex;
   }
   insertBefore(obj, anchor) {
@@ -6734,7 +6902,7 @@ class Renderable extends EventEmitter3 {
         }
         const childLayoutNode = obj.getLayoutNode();
         this.layoutNode.removeChild(childLayoutNode);
-        this.needsUpdate();
+        this.requestRender();
         obj.onRemove();
         obj.parent = null;
       }
@@ -6770,14 +6938,30 @@ class Renderable extends EventEmitter3 {
     this.markClean();
     this._ctx.addToHitGrid(this.x, this.y, this.width, this.height, this.num);
     this.ensureZIndexSorted();
+    const shouldPushScissor = this._overflow !== "visible" && this.width > 0 && this.height > 0;
+    if (shouldPushScissor) {
+      const scissorRect = this.getScissorRect();
+      renderBuffer.pushScissorRect(scissorRect.x, scissorRect.y, scissorRect.width, scissorRect.height);
+    }
     for (const child of this.renderableArray) {
       child.render(renderBuffer, deltaTime);
     }
+    if (shouldPushScissor) {
+      renderBuffer.popScissorRect();
+    }
     if (this.buffered && this.frameBuffer) {
       buffer.drawFrameBuffer(this.x, this.y, this.frameBuffer);
     }
   }
   beforeRender() {}
+  getScissorRect() {
+    return {
+      x: this.buffered ? 0 : this.x,
+      y: this.buffered ? 0 : this.y,
+      width: this.width,
+      height: this.height
+    };
+  }
   renderSelf(buffer, deltaTime) {}
   destroy() {
     if (this.parent) {
@@ -7332,9 +7516,9 @@ class TerminalConsole extends EventEmitter5 {
   _displayLines = [];
   _allLogEntries = [];
   _needsFrameBufferUpdate = false;
-  markNeedsUpdate() {
+  markNeedsRerender() {
     this._needsFrameBufferUpdate = true;
-    this.renderer.needsUpdate();
+    this.renderer.requestRender();
   }
   _rgbaInfo;
   _rgbaWarn;
@@ -7401,7 +7585,7 @@ class TerminalConsole extends EventEmitter5 {
     if (this.isScrolledToBottom) {
       this._scrollToBottom();
     }
-    this.markNeedsUpdate();
+    this.markNeedsRerender();
   }
   _updateConsoleDimensions() {
     const termWidth = this.renderer.terminalWidth;
@@ -7506,7 +7690,7 @@ class TerminalConsole extends EventEmitter5 {
         break;
     }
     if (needsRedraw) {
-      this.markNeedsUpdate();
+      this.markNeedsRerender();
     }
   }
   attachStdin() {
@@ -7563,7 +7747,7 @@ class TerminalConsole extends EventEmitter5 {
       const visibleLineCount = Math.min(logAreaHeight, displayLineCount - this.scrollTopIndex);
       this.currentLineIndex = Math.max(0, Math.min(this.currentLineIndex, visibleLineCount - 1));
       if (this.isVisible) {
-        this.markNeedsUpdate();
+        this.markNeedsRerender();
       }
     }
   }
@@ -7571,7 +7755,7 @@ class TerminalConsole extends EventEmitter5 {
     terminalConsoleCache.clearConsole();
     this._allLogEntries = [];
     this._displayLines = [];
-    this.markNeedsUpdate();
+    this.markNeedsRerender();
   }
   toggle() {
     if (this.isVisible) {
@@ -7584,17 +7768,17 @@ class TerminalConsole extends EventEmitter5 {
       this.show();
     }
     if (!this.renderer.isRunning) {
-      this.renderer.needsUpdate();
+      this.renderer.requestRender();
     }
   }
   focus() {
     this.attachStdin();
     this._scrollToBottom(true);
-    this.markNeedsUpdate();
+    this.markNeedsRerender();
   }
   blur() {
     this.detachStdin();
-    this.markNeedsUpdate();
+    this.markNeedsRerender();
   }
   show() {
     if (!this.isVisible) {
@@ -7603,7 +7787,8 @@ class TerminalConsole extends EventEmitter5 {
       terminalConsoleCache.setCachingEnabled(false);
       if (!this.frameBuffer) {
         this.frameBuffer = OptimizedBuffer.create(this.consoleWidth, this.consoleHeight, this.renderer.widthMethod, {
-          respectAlpha: this.backgroundColor.a < 1
+          respectAlpha: this.backgroundColor.a < 1,
+          id: "console framebuffer"
         });
       }
       const logCount = terminalConsoleCache.cachedLogs.length;
@@ -7612,7 +7797,7 @@ class TerminalConsole extends EventEmitter5 {
       this.scrollTopIndex = 0;
       this._scrollToBottom(true);
       this.focus();
-      this.markNeedsUpdate();
+      this.markNeedsRerender();
     }
   }
   hide() {
@@ -7685,7 +7870,7 @@ class TerminalConsole extends EventEmitter5 {
     this._debugModeEnabled = enabled;
     terminalConsoleCache.setCollectCallerInfo(enabled);
     if (this.isVisible) {
-      this.markNeedsUpdate();
+      this.markNeedsRerender();
     }
   }
   toggleDebugMode() {
@@ -7950,7 +8135,7 @@ class CliRenderer extends EventEmitter6 {
   realStdoutWrite;
   captureCallback = () => {
     if (this._splitHeight > 0) {
-      this.needsUpdate();
+      this.requestRender();
     }
   };
   _useConsole = true;
@@ -8074,8 +8259,8 @@ Error details:
   writeOut(chunk, encoding, callback) {
     return this.realStdoutWrite.call(this.stdout, chunk, encoding, callback);
   }
-  needsUpdate() {
-    if (!this.updateScheduled && !this._isRunning) {
+  requestRender() {
+    if (!this.rendering && !this.updateScheduled && !this._isRunning) {
       this.updateScheduled = true;
       process.nextTick(() => {
         this.loop();
@@ -8177,13 +8362,13 @@ Error details:
     this._console.resize(this.width, this.height);
     this.root.resize(this.width, this.height);
     this.emit("resize", this.width, this.height);
-    this.needsUpdate();
+    this.requestRender();
   }
   interceptStdoutWrite = (chunk, encoding, callback) => {
     const text = chunk.toString();
     capture.write("stdout", text);
     if (this._splitHeight > 0) {
-      this.needsUpdate();
+      this.requestRender();
     }
     if (typeof callback === "function") {
       process.nextTick(callback);
@@ -8355,7 +8540,7 @@ Error details:
         this.lastOverRenderable = this.capturedRenderable;
         this.lastOverRenderableNum = this.capturedRenderable.num;
         this.capturedRenderable = undefined;
-        this.needsUpdate();
+        this.requestRender();
       }
       if (maybeRenderable) {
         if (mouseEvent.type === "drag" && mouseEvent.button === 0 /* LEFT */) {
@@ -8450,30 +8635,33 @@ Error details:
     this._console.resize(this.width, this.height);
     this.root.resize(this.width, this.height);
     this.emit("resize", this.width, this.height);
-    this.needsUpdate();
+    this.requestRender();
   }
   setBackgroundColor(color) {
     const parsedColor = parseColor(color);
     this.lib.setBackgroundColor(this.rendererPtr, parsedColor);
     this.backgroundColor = parsedColor;
     this.nextRenderBuffer.clear(parsedColor);
-    this.needsUpdate();
+    this.requestRender();
   }
   toggleDebugOverlay() {
     this.debugOverlay.enabled = !this.debugOverlay.enabled;
     this.lib.setDebugOverlay(this.rendererPtr, this.debugOverlay.enabled, this.debugOverlay.corner);
     this.emit("debugOverlay:toggle" /* DEBUG_OVERLAY_TOGGLE */, this.debugOverlay.enabled);
-    this.needsUpdate();
+    this.requestRender();
   }
   configureDebugOverlay(options) {
     this.debugOverlay.enabled = options.enabled ?? this.debugOverlay.enabled;
     this.debugOverlay.corner = options.corner ?? this.debugOverlay.corner;
     this.lib.setDebugOverlay(this.rendererPtr, this.debugOverlay.enabled, this.debugOverlay.corner);
-    this.needsUpdate();
+    this.requestRender();
   }
   clearTerminal() {
     this.lib.clearTerminal(this.rendererPtr);
   }
+  setTerminalTitle(title) {
+    this.lib.setTerminalTitle(this.rendererPtr, title);
+  }
   dumpHitGrid() {
     this.lib.dumpHitGrid(this.rendererPtr);
   }
@@ -8546,6 +8734,9 @@ Error details:
     this.controlState = "explicit_started" /* EXPLICIT_STARTED */;
     this.internalStart();
   }
+  auto() {
+    this.controlState = this._isRunning ? "auto_started" /* AUTO_STARTED */ : "idle" /* IDLE */;
+  }
   internalStart() {
     if (!this._isRunning && !this.isDestroyed) {
       this._isRunning = true;
@@ -8813,7 +9004,7 @@ Error details:
   }
 }
 
-export { __toESM, __commonJS, __export, __require, Edge, Gutter, MeasureMode, BorderChars, getBorderFromSides, getBorderSides, borderCharsToArray, BorderCharArrays, TrackedNode, createTrackedNode, nonAlphanumericKeys, parseKeypress, KeyHandler, getKeyHandler, RGBA, hexToRgb, rgbToHex, hsvToRgb, parseColor, fonts, measureText, getCharacterPositions, coordinateToCharacterIndex, renderFontToFrameBuffer, TextAttributes, DebugOverlayCorner, createTextAttributes, StyledText, stringToStyledText, black, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bold, italic, underline, strikethrough, dim, reverse, blink, fg, bg, tn, t, SyntaxStyle, hastToStyledText, parseAlign, parseBoxSizing, parseDimension, parseDirection, parseDisplay, parseEdge, parseFlexDirection, parseGutter, parseJustify, parseLogLevel, parseMeasureMode, parseOverflow, parsePositionType, parseUnit, parseWrap, MouseParser, Selection, TextSelectionHelper, ASCIIFontSelectionHelper, TextBuffer, setRenderLibPath, resolveRenderLib, OptimizedBuffer, h, isVNode, ensureRenderable, wrapWithDelegates, instantiate, delegate, LayoutEvents, RenderableEvents, isValidPercentage, isMarginType, isPaddingType, isPositionType, isPostionTypeType, isDimensionType, isFlexBasisType, isSizeType, Renderable, RootRenderable, capture, ConsolePosition, TerminalConsole, MouseEvent, MouseButton, createCliRenderer, CliRenderEvents, CliRenderer };
+export { __toESM, __commonJS, __export, __require, Edge, Gutter, MeasureMode, BorderChars, getBorderFromSides, getBorderSides, borderCharsToArray, BorderCharArrays, TrackedNode, createTrackedNode, nonAlphanumericKeys, parseKeypress, KeyHandler, getKeyHandler, RGBA, hexToRgb, rgbToHex, hsvToRgb, parseColor, fonts, measureText, getCharacterPositions, coordinateToCharacterIndex, renderFontToFrameBuffer, TextAttributes, DebugOverlayCorner, createTextAttributes, StyledText, stringToStyledText, black, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bold, italic, underline, strikethrough, dim, reverse, blink, fg, bg, tn, t, SyntaxStyle, hastToStyledText, parseAlign, parseBoxSizing, parseDimension, parseDirection, parseDisplay, parseEdge, parseFlexDirection, parseGutter, parseJustify, parseLogLevel, parseMeasureMode, parseOverflow, parsePositionType, parseUnit, parseWrap, MouseParser, Selection, TextSelectionHelper, ASCIIFontSelectionHelper, TextBuffer, LogLevel2 as LogLevel, setRenderLibPath, resolveRenderLib, OptimizedBuffer, h, isVNode, ensureRenderable, wrapWithDelegates, instantiate, delegate, LayoutEvents, RenderableEvents, isValidPercentage, isMarginType, isPaddingType, isPositionType, isPositionTypeType, isOverflowType, isDimensionType, isFlexBasisType, isSizeType, Renderable, RootRenderable, capture, ConsolePosition, TerminalConsole, MouseEvent, MouseButton, createCliRenderer, CliRenderEvents, CliRenderer };
 
-//# debugId=8EF563BA9A3E575E64756E2164756E21
-//# sourceMappingURL=index-bpwzbxgn.js.map
+//# debugId=ADDBBC6DB7FFCF1064756E2164756E21
+//# sourceMappingURL=index-rv93tneq.js.map