@opentuah/core 0.1.88 → 0.1.90

package/3d.js

@@ -2,7 +2,7 @@
 import {
   RGBA,
   Renderable
-} from "./index-1n3xjscm.js";
+} from "./index-bsnn7gyg.js";
 
 // src/3d/WGPURenderer.ts
 import { PerspectiveCamera, Color, NoToneMapping, LinearSRGBColorSpace } from "three";

package/NativeSpanFeed.d.ts

@@ -0,0 +1,41 @@
+import { type Pointer } from "bun:ffi";
+import type { NativeSpanFeedOptions } from "./zig-structs";
+export type { GrowthPolicy, NativeSpanFeedOptions, NativeSpanFeedStats } from "./zig-structs";
+export type DataHandler = (data: Uint8Array) => void | Promise<void>;
+/**
+ * Zero-copy wrapper over Zig memory; not a full stream interface.
+ */
+export declare class NativeSpanFeed {
+    static create(options?: NativeSpanFeedOptions): NativeSpanFeed;
+    static attach(streamPtr: bigint | number, _options?: NativeSpanFeedOptions): NativeSpanFeed;
+    readonly streamPtr: Pointer;
+    private readonly lib;
+    private readonly eventHandler;
+    private chunkMap;
+    private chunkSizes;
+    private dataHandlers;
+    private errorHandlers;
+    private drainBuffer;
+    private stateBuffer;
+    private closed;
+    private destroyed;
+    private draining;
+    private pendingDataAvailable;
+    private pendingClose;
+    private closing;
+    private pendingAsyncHandlers;
+    private inCallback;
+    private closeQueued;
+    private constructor();
+    private ensureDrainBuffer;
+    onData(handler: DataHandler): () => void;
+    onError(handler: (code: number) => void): () => void;
+    close(): void;
+    private processPendingClose;
+    private performClose;
+    private finalizeDestroy;
+    private handleEvent;
+    private decrementRefcount;
+    private drainOnce;
+    drainAll(): void;
+}

package/README.md

@@ -42,6 +42,10 @@ bun run bench:native
 
 See [src/zig/bench.zig](src/zig/bench.zig) for available options like `--filter` and `--mem`.
 
+NativeSpanFeed TypeScript benchmarks:
+
+- [src/benchmark/native-span-feed-benchmark.md](src/benchmark/native-span-feed-benchmark.md)
+
 ## CLI Renderer
 
 ### Renderables

package/{index-1n3xjscm.js → index-bsnn7gyg.js}

@@ -4908,6 +4908,7 @@ class MouseParser {
       const y = str.charCodeAt(5) - 33;
       const button = buttonByte & 3;
       const isScroll = (buttonByte & 64) !== 0;
+      const isMotion = (buttonByte & 32) !== 0;
       const scrollDirection = !isScroll ? undefined : MouseParser.SCROLL_DIRECTIONS[button];
       const modifiers = {
         shift: (buttonByte & 4) !== 0,
@@ -4924,6 +4925,9 @@ class MouseParser {
           direction: scrollDirection,
           delta: 1
         };
+      } else if (isMotion) {
+        type = "move";
+        actualButton = button === 3 ? -1 : button;
       } else {
         type = button === 3 ? "up" : "down";
         actualButton = button === 3 ? 0 : button;
@@ -8102,6 +8106,45 @@ var CursorStateStruct = defineStruct([
   ["b", "f32"],
   ["a", "f32"]
 ]);
+var GrowthPolicyEnum = defineEnum({ grow: 0, block: 1 }, "u8");
+var NativeSpanFeedOptionsStruct = defineStruct([
+  ["chunkSize", "u32", { default: 64 * 1024 }],
+  ["initialChunks", "u32", { default: 2 }],
+  ["maxBytes", "u64", { default: 0n }],
+  ["growthPolicy", GrowthPolicyEnum, { default: "grow" }],
+  ["autoCommitOnFull", "bool_u8", { default: true }],
+  ["spanQueueCapacity", "u32", { default: 0 }]
+]);
+var NativeSpanFeedStatsStruct = defineStruct([
+  ["bytesWritten", "u64"],
+  ["spansCommitted", "u64"],
+  ["chunks", "u32"],
+  ["pendingSpans", "u32"]
+]);
+var SpanInfoStruct = defineStruct([
+  ["chunkPtr", "pointer"],
+  ["offset", "u32"],
+  ["len", "u32"],
+  ["chunkIndex", "u32"],
+  ["reserved", "u32", { default: 0 }]
+], {
+  reduceValue: (value) => ({
+    chunkPtr: value.chunkPtr,
+    offset: value.offset,
+    len: value.len,
+    chunkIndex: value.chunkIndex
+  })
+});
+var ReserveInfoStruct = defineStruct([
+  ["ptr", "pointer"],
+  ["len", "u32"],
+  ["reserved", "u32", { default: 0 }]
+], {
+  reduceValue: (value) => ({
+    ptr: value.ptr,
+    len: value.len
+  })
+});
 
 // src/zig.ts
 var targetLibPath;
@@ -8109,12 +8152,7 @@ try {
   const module = await import(`@opentuah/core-${process.platform}-${process.arch}/index.ts`);
   targetLibPath = module.default;
 } catch {
-  if (process.platform === "linux") {
-    const module = await import(`@opentuah/core-linux-musl-${process.arch}/index.ts`);
-    targetLibPath = module.default;
-  } else {
-    throw new Error(`opentui is not supported on the current platform: ${process.platform}-${process.arch}`);
-  }
+  throw new Error(`opentui is not supported on the current platform: ${process.platform}-${process.arch}`);
 }
 if (isBunfsPath(targetLibPath)) {
   targetLibPath = targetLibPath.replace("../", "");
@@ -8161,6 +8199,18 @@ registerEnvVar({
 var globalTraceSymbols = null;
 var globalFFILogWriter = null;
 var exitHandlerRegistered = false;
+function toPointer(value) {
+  if (typeof value === "bigint") {
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+      throw new Error("Pointer exceeds safe integer range");
+    }
+    return Number(value);
+  }
+  return value;
+}
+function toNumber(value) {
+  return typeof value === "bigint" ? Number(value) : value;
+}
 function getOpenTUILib(libPath) {
   const resolvedLibPath = libPath || targetLibPath;
   const rawSymbols = dlopen(resolvedLibPath, {
@@ -9076,6 +9126,54 @@ function getOpenTUILib(libPath) {
     vtermPtyToText: {
       args: ["ptr", "usize", "u16", "u16", "ptr", "usize"],
       returns: "usize"
+    },
+    createNativeSpanFeed: {
+      args: ["ptr"],
+      returns: "ptr"
+    },
+    attachNativeSpanFeed: {
+      args: ["ptr"],
+      returns: "i32"
+    },
+    destroyNativeSpanFeed: {
+      args: ["ptr"],
+      returns: "void"
+    },
+    streamWrite: {
+      args: ["ptr", "ptr", "u64"],
+      returns: "i32"
+    },
+    streamCommit: {
+      args: ["ptr"],
+      returns: "i32"
+    },
+    streamDrainSpans: {
+      args: ["ptr", "ptr", "u32"],
+      returns: "u32"
+    },
+    streamClose: {
+      args: ["ptr"],
+      returns: "i32"
+    },
+    streamReserve: {
+      args: ["ptr", "u32", "ptr"],
+      returns: "i32"
+    },
+    streamCommitReserved: {
+      args: ["ptr", "u32"],
+      returns: "i32"
+    },
+    streamSetOptions: {
+      args: ["ptr", "ptr"],
+      returns: "i32"
+    },
+    streamGetStats: {
+      args: ["ptr", "ptr"],
+      returns: "i32"
+    },
+    streamSetCallback: {
+      args: ["ptr", "ptr"],
+      returns: "void"
     }
   });
   if (env.OTUI_DEBUG_FFI || env.OTUI_TRACE_FFI) {
@@ -9241,6 +9339,8 @@ class FFIRenderLib {
   eventCallbackWrapper;
   _nativeEvents = new EventEmitter5;
   _anyEventHandlers = [];
+  nativeSpanFeedCallbackWrapper = null;
+  nativeSpanFeedHandlers = new Map;
   constructor(libPath) {
     this.opentui = getOpenTUILib(libPath);
     this.setupLogging();
@@ -9330,6 +9430,25 @@ class FFIRenderLib {
     }
     this.setEventCallback(eventCallback.ptr);
   }
+  ensureNativeSpanFeedCallback() {
+    if (this.nativeSpanFeedCallbackWrapper) {
+      return this.nativeSpanFeedCallbackWrapper;
+    }
+    const callback = new JSCallback((streamPtr, eventId, arg0, arg1) => {
+      const handler = this.nativeSpanFeedHandlers.get(toPointer(streamPtr));
+      if (handler) {
+        handler(eventId, arg0, arg1);
+      }
+    }, {
+      args: ["ptr", "u32", "ptr", "u64"],
+      returns: "void"
+    });
+    this.nativeSpanFeedCallbackWrapper = callback;
+    if (!callback.ptr) {
+      throw new Error("Failed to create native span feed callback");
+    }
+    return callback;
+  }
   setEventCallback(callbackPtr) {
     this.opentui.symbols.setEventCallback(callbackPtr);
   }
@@ -10361,6 +10480,73 @@ class FFIRenderLib {
   bufferDrawChar(buffer, char, x, y, fg2, bg2, attributes = 0) {
     this.opentui.symbols.bufferDrawChar(buffer, char, x, y, fg2.buffer, bg2.buffer, attributes);
   }
+  registerNativeSpanFeedStream(stream, handler) {
+    const callback = this.ensureNativeSpanFeedCallback();
+    this.nativeSpanFeedHandlers.set(toPointer(stream), handler);
+    this.opentui.symbols.streamSetCallback(stream, callback.ptr);
+  }
+  unregisterNativeSpanFeedStream(stream) {
+    this.opentui.symbols.streamSetCallback(stream, null);
+    this.nativeSpanFeedHandlers.delete(toPointer(stream));
+  }
+  createNativeSpanFeed(options) {
+    const optionsBuffer = options == null ? null : NativeSpanFeedOptionsStruct.pack(options);
+    const streamPtr = this.opentui.symbols.createNativeSpanFeed(optionsBuffer ? ptr3(optionsBuffer) : null);
+    if (!streamPtr) {
+      throw new Error("Failed to create stream");
+    }
+    return toPointer(streamPtr);
+  }
+  attachNativeSpanFeed(stream) {
+    return this.opentui.symbols.attachNativeSpanFeed(stream);
+  }
+  destroyNativeSpanFeed(stream) {
+    this.opentui.symbols.destroyNativeSpanFeed(stream);
+    this.nativeSpanFeedHandlers.delete(toPointer(stream));
+  }
+  streamWrite(stream, data) {
+    const bytes = typeof data === "string" ? this.encoder.encode(data) : data;
+    return this.opentui.symbols.streamWrite(stream, ptr3(bytes), bytes.length);
+  }
+  streamCommit(stream) {
+    return this.opentui.symbols.streamCommit(stream);
+  }
+  streamDrainSpans(stream, outBuffer, maxSpans) {
+    const count = this.opentui.symbols.streamDrainSpans(stream, ptr3(outBuffer), maxSpans);
+    return toNumber(count);
+  }
+  streamClose(stream) {
+    return this.opentui.symbols.streamClose(stream);
+  }
+  streamSetOptions(stream, options) {
+    const optionsBuffer = NativeSpanFeedOptionsStruct.pack(options);
+    return this.opentui.symbols.streamSetOptions(stream, ptr3(optionsBuffer));
+  }
+  streamGetStats(stream) {
+    const statsBuffer = new ArrayBuffer(NativeSpanFeedStatsStruct.size);
+    const status = this.opentui.symbols.streamGetStats(stream, ptr3(statsBuffer));
+    if (status !== 0) {
+      return null;
+    }
+    const stats = NativeSpanFeedStatsStruct.unpack(statsBuffer);
+    return {
+      bytesWritten: typeof stats.bytesWritten === "bigint" ? stats.bytesWritten : BigInt(stats.bytesWritten),
+      spansCommitted: typeof stats.spansCommitted === "bigint" ? stats.spansCommitted : BigInt(stats.spansCommitted),
+      chunks: stats.chunks,
+      pendingSpans: stats.pendingSpans
+    };
+  }
+  streamReserve(stream, minLen) {
+    const reserveBuffer = new ArrayBuffer(ReserveInfoStruct.size);
+    const status = this.opentui.symbols.streamReserve(stream, minLen, ptr3(reserveBuffer));
+    if (status !== 0) {
+      return { status, info: null };
+    }
+    return { status, info: ReserveInfoStruct.unpack(reserveBuffer) };
+  }
+  streamCommitReserved(stream, length) {
+    return this.opentui.symbols.streamCommitReserved(stream, length);
+  }
   createSyntaxStyle() {
     const stylePtr = this.opentui.symbols.createSyntaxStyle();
     if (!stylePtr) {
@@ -15076,7 +15262,7 @@ Captured output:
   }
 }
 
-export { isValidBorderStyle, parseBorderStyle, BorderChars, getBorderFromSides, getBorderSides, borderCharsToArray, BorderCharArrays, nonAlphanumericKeys, parseKeypress, KeyEvent, PasteEvent, KeyHandler, InternalKeyHandler, RGBA, hexToRgb, rgbToHex, hsvToRgb, parseColor, fonts, measureText, getCharacterPositions, coordinateToCharacterIndex, renderFontToFrameBuffer, TextAttributes, ATTRIBUTE_BASE_BITS, ATTRIBUTE_BASE_MASK, getBaseAttributes, DebugOverlayCorner, createTextAttributes, attributesWithLink, getLinkId, visualizeRenderableTree, isStyledText, 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, link, t, hastToStyledText, LinearScrollAccel, MacOSScrollAccel, StdinBuffer, parseAlign, parseAlignItems, parseBoxSizing, parseDimension, parseDirection, parseDisplay, parseEdge, parseFlexDirection, parseGutter, parseJustify, parseLogLevel, parseMeasureMode, parseOverflow, parsePositionType, parseUnit, parseWrap, MouseParser, Selection, convertGlobalToLocalSelection, ASCIIFontSelectionHelper, envRegistry, registerEnvVar, clearEnvCache, generateEnvMarkdown, generateEnvColored, env, treeSitterToTextChunks, treeSitterToStyledText, addDefaultParsers, TreeSitterClient, DataPathsManager, getDataPaths, extToFiletype, pathToFiletype, main, getTreeSitterClient, ExtmarksController, createExtmarksController, TerminalPalette, createTerminalPalette, VTermStyleFlags, vtermDataToStyledText, TextBuffer, LogLevel2 as LogLevel, setRenderLibPath, resolveRenderLib, OptimizedBuffer, h, isVNode, maybeMakeRenderable, wrapWithDelegates, instantiate, delegate, isValidPercentage, LayoutEvents, RenderableEvents, isRenderable, BaseRenderable, Renderable, RootRenderable, ANSI, defaultKeyAliases, mergeKeyAliases, mergeKeyBindings, getKeyBindingKey, buildKeyBindingsMap, capture, ConsolePosition, TerminalConsole, getObjectsInViewport, buildKittyKeyboardFlags, MouseEvent, MouseButton, createCliRenderer, CliRenderEvents, RendererControlState, CliRenderer };
+export { isValidBorderStyle, parseBorderStyle, BorderChars, getBorderFromSides, getBorderSides, borderCharsToArray, BorderCharArrays, nonAlphanumericKeys, parseKeypress, KeyEvent, PasteEvent, KeyHandler, InternalKeyHandler, RGBA, hexToRgb, rgbToHex, hsvToRgb, parseColor, fonts, measureText, getCharacterPositions, coordinateToCharacterIndex, renderFontToFrameBuffer, TextAttributes, ATTRIBUTE_BASE_BITS, ATTRIBUTE_BASE_MASK, getBaseAttributes, DebugOverlayCorner, createTextAttributes, attributesWithLink, getLinkId, visualizeRenderableTree, isStyledText, 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, link, t, hastToStyledText, LinearScrollAccel, MacOSScrollAccel, StdinBuffer, parseAlign, parseAlignItems, parseBoxSizing, parseDimension, parseDirection, parseDisplay, parseEdge, parseFlexDirection, parseGutter, parseJustify, parseLogLevel, parseMeasureMode, parseOverflow, parsePositionType, parseUnit, parseWrap, MouseParser, Selection, convertGlobalToLocalSelection, ASCIIFontSelectionHelper, envRegistry, registerEnvVar, clearEnvCache, generateEnvMarkdown, generateEnvColored, env, treeSitterToTextChunks, treeSitterToStyledText, addDefaultParsers, TreeSitterClient, DataPathsManager, getDataPaths, extToFiletype, pathToFiletype, main, getTreeSitterClient, ExtmarksController, createExtmarksController, TerminalPalette, createTerminalPalette, VTermStyleFlags, vtermDataToStyledText, TextBuffer, SpanInfoStruct, LogLevel2 as LogLevel, setRenderLibPath, resolveRenderLib, OptimizedBuffer, h, isVNode, maybeMakeRenderable, wrapWithDelegates, instantiate, delegate, isValidPercentage, LayoutEvents, RenderableEvents, isRenderable, BaseRenderable, Renderable, RootRenderable, ANSI, defaultKeyAliases, mergeKeyAliases, mergeKeyBindings, getKeyBindingKey, buildKeyBindingsMap, capture, ConsolePosition, TerminalConsole, getObjectsInViewport, buildKittyKeyboardFlags, MouseEvent, MouseButton, createCliRenderer, CliRenderEvents, RendererControlState, CliRenderer };
 
-//# debugId=C15A319C5711EB2964756E2164756E21
-//# sourceMappingURL=index-1n3xjscm.js.map
+//# debugId=35AC0EA10B5E556464756E2164756E21
+//# sourceMappingURL=index-bsnn7gyg.js.map