@jitl/opentui-core 0.1.97 → 0.2.15

package/NativeSpanFeed.d.ts

@@ -1,4 +1,4 @@
-import { type Pointer } from "./compat/ffi.js";
+import { type Pointer } from "./platform/ffi.js";
 import type { NativeSpanFeedOptions } from "./zig-structs.js";
 export type { GrowthPolicy, NativeSpanFeedOptions, NativeSpanFeedStats } from "./zig-structs.js";
 export type DataHandler = (data: Uint8Array) => void | Promise<void>;
@@ -7,7 +7,7 @@ export type DataHandler = (data: Uint8Array) => void | Promise<void>;
  */
 export declare class NativeSpanFeed {
     static create(options?: NativeSpanFeedOptions): NativeSpanFeed;
-    static attach(streamPtr: bigint | number, _options?: NativeSpanFeedOptions): NativeSpanFeed;
+    static attach(streamPtr: Pointer, _options?: NativeSpanFeedOptions): NativeSpanFeed;
     readonly streamPtr: Pointer;
     private readonly lib;
     private readonly eventHandler;

package/README.md

@@ -31,7 +31,8 @@ This creates platform-specific libraries that are automatically loaded by the Ty
 
 ```bash
 bun install
-bun run src/examples/index.ts
+cd ../examples
+bun run dev
 ```
 
 ## Benchmarks

package/Renderable.d.ts

@@ -16,7 +16,8 @@ export declare enum LayoutEvents {
 }
 export declare enum RenderableEvents {
     FOCUSED = "focused",
-    BLURRED = "blurred"
+    BLURRED = "blurred",
+    DESTROYED = "destroyed"
 }
 export interface Position {
     top?: number | "auto" | `${number}%`;
@@ -122,6 +123,8 @@ export declare abstract class Renderable extends BaseRenderable {
     protected _translateY: number;
     protected _x: number;
     protected _y: number;
+    protected _screenX: number;
+    protected _screenY: number;
     protected _width: number | "auto" | `${number}%`;
     protected _height: number | "auto" | `${number}%`;
     protected _widthValue: number;
@@ -132,6 +135,7 @@ export declare abstract class Renderable extends BaseRenderable {
     protected frameBuffer: OptimizedBuffer | null;
     protected _focusable: boolean;
     protected _focused: boolean;
+    protected _hasFocusedDescendant: boolean;
     protected keypressHandler: ((key: KeyEvent) => void) | null;
     protected pasteHandler: ((event: PasteEvent) => void) | null;
     private _live;
@@ -155,6 +159,7 @@ export declare abstract class Renderable extends BaseRenderable {
     private childrenPrimarySortDirty;
     private childrenSortedByPrimaryAxis;
     private _shouldUpdateBefore;
+    private _lastLayoutFrame;
     onLifecyclePass: (() => void) | null;
     renderBefore?: (this: Renderable, buffer: OptimizedBuffer, deltaTime: number) => void;
     renderAfter?: (this: Renderable, buffer: OptimizedBuffer, deltaTime: number) => void;
@@ -174,8 +179,10 @@ export declare abstract class Renderable extends BaseRenderable {
     getSelectedText(): string;
     shouldStartSelection(x: number, y: number): boolean;
     focus(): void;
+    protected propagateFocusChange(hasFocus: boolean): void;
     blur(): void;
     get focused(): boolean;
+    get hasFocusedDescendant(): boolean;
     get live(): boolean;
     get liveCount(): number;
     set live(value: boolean);
@@ -188,6 +195,8 @@ export declare abstract class Renderable extends BaseRenderable {
     set translateX(value: number);
     get translateY(): number;
     set translateY(value: number);
+    get screenX(): number;
+    get screenY(): number;
     get x(): number;
     set x(value: number);
     get top(): number | "auto" | `${number}%` | undefined;
@@ -232,6 +241,7 @@ export declare abstract class Renderable extends BaseRenderable {
     set marginX(marginX: number | "auto" | `${number}%` | null | undefined);
     set marginY(marginY: number | "auto" | `${number}%` | null | undefined);
     set marginTop(margin: number | "auto" | `${number}%` | null | undefined);
+    get marginTop(): number | "auto" | `${number}%`;
     set marginRight(margin: number | "auto" | `${number}%` | null | undefined);
     set marginBottom(margin: number | "auto" | `${number}%` | null | undefined);
     set marginLeft(margin: number | "auto" | `${number}%` | null | undefined);
@@ -263,6 +273,7 @@ export declare abstract class Renderable extends BaseRenderable {
     getChildrenCount(): number;
     updateLayout(deltaTime: number, renderList?: RenderCommand[]): void;
     render(buffer: OptimizedBuffer, deltaTime: number): void;
+    protected _hasVisibleChildFilter(): boolean;
     protected _getVisibleChildren(): number[];
     protected onUpdate(deltaTime: number): void;
     protected getScissorRect(): {

package/audio.d.ts

@@ -0,0 +1,89 @@
+import { EventEmitter } from "events";
+import type { AudioStats } from "./zig-structs.js";
+export interface AudioSetupOptions {
+    autoStart?: boolean;
+    sampleRate?: number;
+    playbackChannels?: number;
+    startOptions?: AudioStartOptions;
+}
+export interface AudioStartOptions {
+    periodSizeInFrames?: number;
+    periodSizeInMilliseconds?: number;
+    periods?: number;
+    performanceProfile?: number;
+    shareMode?: number;
+    noPreSilencedOutputBuffer?: boolean;
+    noClip?: boolean;
+    noDisableDenormals?: boolean;
+    noFixedSizedCallback?: boolean;
+    wasapiNoAutoConvertSrc?: boolean;
+    wasapiNoDefaultQualitySrc?: boolean;
+    alsaNoMMap?: boolean;
+    alsaNoAutoFormat?: boolean;
+    alsaNoAutoChannels?: boolean;
+    alsaNoAutoResample?: boolean;
+}
+export interface AudioPlayOptions {
+    volume?: number;
+    pan?: number;
+    loop?: boolean;
+    groupId?: number;
+}
+export type AudioGroup = number;
+export type AudioVoice = number;
+export type AudioSound = number;
+export interface AudioPlaybackDevice {
+    index: number;
+    name: string;
+    isDefault: boolean;
+}
+export type AudioAction = "createAudioEngine" | "start" | "startMixer" | "stop" | "loadSound" | "loadSoundFile" | "unloadSound" | "group" | "play" | "stopVoice" | "setVoiceGroup" | "setGroupVolume" | "setMasterVolume" | "mixFrames" | "enableTap" | "readTapFrames" | "listPlaybackDevices" | "selectPlaybackDevice" | "clearPlaybackDeviceSelection" | "getStats";
+export interface AudioErrorContext {
+    action: AudioAction;
+    status?: number;
+}
+export interface AudioEvents {
+    error: [error: Error, context: AudioErrorContext];
+    started: [];
+    mixerStarted: [];
+    stopped: [];
+    disposed: [];
+}
+export declare class Audio extends EventEmitter<AudioEvents> {
+    static create(options?: AudioSetupOptions): Audio;
+    private readonly lib;
+    private readonly defaultStartOptions;
+    private engine;
+    private readonly groups;
+    private playbackStarted;
+    private mixerStarted;
+    private constructor();
+    private emitError;
+    start(options?: AudioStartOptions): boolean;
+    startMixer(): boolean;
+    stop(): boolean;
+    isStarted(): boolean;
+    isMixerStarted(): boolean;
+    loadSound(data: Uint8Array | ArrayBuffer): AudioSound | null;
+    loadSoundFile(filePath: string): Promise<AudioSound | null>;
+    unloadSound(sound: AudioSound): boolean;
+    group(name: string): AudioGroup | null;
+    play(sound: AudioSound, options?: AudioPlayOptions): AudioVoice | null;
+    stopVoice(voice: AudioVoice): boolean;
+    setVoiceGroup(voice: AudioVoice, group: AudioGroup): boolean;
+    setGroupVolume(group: AudioGroup, volume: number): boolean;
+    setMasterVolume(volume: number): boolean;
+    mixFrames(frameCount: number, channels?: number): Float32Array | null;
+    enableTap(capacityFrames?: number): boolean;
+    disableTap(): boolean;
+    readTapFrames(frameCount: number, channels?: number): {
+        frames: Float32Array;
+        framesRead: number;
+    } | null;
+    listPlaybackDevices(): AudioPlaybackDevice[] | null;
+    selectPlaybackDevice(index: number): boolean;
+    clearPlaybackDeviceSelection(): void;
+    getStats(): AudioStats | null;
+    dispose(): void;
+}
+export declare function setupAudio(options?: AudioSetupOptions): Audio;

package/buffer.d.ts

@@ -1,6 +1,6 @@
 import { RGBA } from "./lib/index.js";
 import { type RenderLib } from "./zig.js";
-import { type Pointer } from "./compat/ffi.js";
+import { type Pointer, type PointerInput } from "./platform/ffi.js";
 import { type BorderStyle, type BorderSides } from "./lib/index.js";
 import { TargetChannel, type WidthMethod, type CapturedLine } from "./types.js";
 import type { TextBufferView } from "./text-buffer-view.js";
@@ -18,10 +18,11 @@ export declare class OptimizedBuffer {
     private _destroyed;
     get ptr(): Pointer;
     private guard;
+    private ensureRawBufferViews;
     get buffers(): {
         char: Uint32Array;
-        fg: Float32Array;
-        bg: Float32Array;
+        fg: Uint16Array;
+        bg: Uint16Array;
         attributes: Uint32Array;
     };
     constructor(lib: RenderLib, ptr: Pointer, width: number, height: number, options: {
@@ -56,8 +57,8 @@ export declare class OptimizedBuffer {
     destroy(): void;
     drawTextBuffer(textBufferView: TextBufferView, x: number, y: number): void;
     drawEditorView(editorView: EditorView, x: number, y: number): void;
-    drawSuperSampleBuffer(x: number, y: number, pixelDataPtr: Pointer, pixelDataLength: number, format: "bgra8unorm" | "rgba8unorm", alignedBytesPerRow: number): void;
-    drawPackedBuffer(dataPtr: Pointer, dataLen: number, posX: number, posY: number, terminalWidthCells: number, terminalHeightCells: number): void;
+    drawSuperSampleBuffer(x: number, y: number, pixelDataPtr: PointerInput, pixelDataLength: number, format: "bgra8unorm" | "rgba8unorm", alignedBytesPerRow: number): void;
+    drawPackedBuffer(dataPtr: PointerInput, dataLen: number, posX: number, posY: number, terminalWidthCells: number, terminalHeightCells: number): void;
     drawGrayscaleBuffer(posX: number, posY: number, intensities: Float32Array, srcWidth: number, srcHeight: number, fg?: RGBA | null, bg?: RGBA | null): void;
     drawGrayscaleBufferSupersampled(posX: number, posY: number, intensities: Float32Array, srcWidth: number, srcHeight: number, fg?: RGBA | null, bg?: RGBA | null): void;
     resize(width: number, height: number): void;

package/console.d.ts

@@ -4,7 +4,8 @@ import type { ColorInput } from "./lib/RGBA.js";
 import { OptimizedBuffer } from "./buffer.js";
 import { type Clock } from "./lib/clock.js";
 import { Capture } from "./lib/output.capture.js";
-import { type KeyBinding as BaseKeyBinding, type KeyAliasMap } from "./lib/keymapping.js";
+import { type KeyBinding as BaseKeyBinding } from "./lib/keybinding.internal.js";
+type KeyAliasMap = Record<string, string>;
 export declare const capture: Capture;
 export declare enum ConsolePosition {
     TOP = "top",
@@ -142,3 +143,4 @@ export declare class TerminalConsole extends EventEmitter {
     };
     private saveLogsToFile;
 }
+export {};

package/edit-buffer.d.ts

@@ -1,5 +1,5 @@
 import { type LogicalCursor, type RenderLib } from "./zig.js";
-import { type Pointer } from "./compat/ffi.js";
+import { type Pointer } from "./platform/ffi.js";
 import { type WidthMethod, type Highlight } from "./types.js";
 import { RGBA } from "./lib/RGBA.js";
 import { EventEmitter } from "events";

package/editor-view.d.ts

@@ -1,6 +1,6 @@
 import { RGBA } from "./lib/RGBA.js";
 import { type RenderLib, type VisualCursor, type LineInfo } from "./zig.js";
-import { type Pointer } from "./compat/ffi.js";
+import { type Pointer } from "./platform/ffi.js";
 import type { EditBuffer } from "./edit-buffer.js";
 export interface Viewport {
     offsetY: number;