@blit-sh/core 0.17.0

package/dist/BlitConnection.d.ts

@@ -0,0 +1,132 @@
+import type { BlitConnectionSnapshot, BlitSearchResult, BlitSession, BlitTransport, ConnectionId, SessionId, TerminalPalette } from "./types";
+import { TerminalStore, type BlitWasmModule } from "./TerminalStore";
+export declare const SEARCH_SOURCE_TITLE = 0;
+export declare const SEARCH_SOURCE_VISIBLE = 1;
+export declare const SEARCH_SOURCE_SCROLLBACK = 2;
+export declare const SEARCH_MATCH_TITLE: number;
+export declare const SEARCH_MATCH_VISIBLE: number;
+export declare const SEARCH_MATCH_SCROLLBACK: number;
+export interface CreateBlitConnectionOptions {
+    id: ConnectionId;
+    transport: BlitTransport;
+    wasm: BlitWasmModule | Promise<BlitWasmModule>;
+    autoConnect?: boolean;
+}
+export interface CreateSessionOptions {
+    rows: number;
+    cols: number;
+    tag?: string;
+    command?: string;
+    cwdFromSessionId?: SessionId;
+}
+type ResizeSessionOptions = {
+    sessionId: SessionId;
+    rows: number;
+    cols: number;
+};
+export declare class BlitConnection {
+    readonly id: ConnectionId;
+    private readonly transport;
+    private readonly store;
+    private readonly listeners;
+    private readonly sessionsById;
+    private readonly currentSessionIdByPtyId;
+    private readonly pendingCreates;
+    private readonly pendingCloses;
+    private readonly pendingSearches;
+    private readonly pendingReads;
+    private sessionCounter;
+    private nonceCounter;
+    private searchCounter;
+    private features;
+    private disposed;
+    /** Per-session, per-view size registry for computing minimum resize. */
+    private viewSizes;
+    private viewIdCounter;
+    private hasConnected;
+    private retryCount;
+    private lastError;
+    private snapshot;
+    private sessions;
+    private _publicSessions;
+    private _publicSessionsDirty;
+    constructor({ id, transport, wasm, autoConnect, }: CreateBlitConnectionOptions);
+    subscribe: (listener: () => void) => (() => void);
+    private get publicSessions();
+    private invalidatePublicSessions;
+    getSnapshot: () => BlitConnectionSnapshot;
+    connect(): void;
+    reconnect(): void;
+    close(): void;
+    dispose(): void;
+    setVisibleSessionIds(sessionIds: Iterable<SessionId>): void;
+    getSession(sessionId: SessionId): BlitSession | null;
+    getDebugStats(sessionId: SessionId | null): ReturnType<TerminalStore["getDebugStats"]>;
+    createSession(options: CreateSessionOptions): Promise<BlitSession>;
+    copyRange(sessionId: SessionId, startTail: number, startCol: number, endTail: number, endCol: number): Promise<string>;
+    supportsCopyRange(): boolean;
+    closeSession(sessionId: SessionId): Promise<void>;
+    restartSession(sessionId: SessionId): void;
+    killSession(sessionId: SessionId, signal?: number): void;
+    focusSession(sessionId: SessionId | null): void;
+    sendInput(sessionId: SessionId, data: Uint8Array): void;
+    resizeSession(sessionId: SessionId, rows: number, cols: number): void;
+    clearSessionSize(sessionId: SessionId): void;
+    clearSessionSizes(sessionIds: Iterable<SessionId>): void;
+    resizeSessions(entries: Iterable<ResizeSessionOptions>): void;
+    scrollSession(sessionId: SessionId, offset: number): void;
+    sendMouse(sessionId: SessionId, type: number, button: number, col: number, row: number): void;
+    search(query: string): Promise<BlitSearchResult[]>;
+    private ptyId;
+    getTerminal(sessionId: SessionId): import("@blit-sh/browser").Terminal | null;
+    /** Allocate a unique view ID for multi-pane size tracking. */
+    allocViewId(): string;
+    /** Register/update a view's size for a session. Sends the minimum to the server. */
+    setViewSize(sessionId: SessionId, viewId: string, rows: number, cols: number): void;
+    /** Unregister a view. Recalculates and sends the new minimum. */
+    removeView(sessionId: SessionId, viewId: string): void;
+    private sendMinSize;
+    metricsGeneration(): number;
+    bumpMetricsGeneration(): number;
+    getRetainCount(sessionId: SessionId): number;
+    retain(sessionId: SessionId): void;
+    release(sessionId: SessionId): void;
+    freeze(sessionId: SessionId): void;
+    thaw(sessionId: SessionId): void;
+    isFrozen(sessionId: SessionId): boolean;
+    addDirtyListener(sessionId: SessionId, listener: () => void): () => void;
+    drainPending(sessionId: SessionId): boolean;
+    getSharedRenderer(): {
+        renderer: import("./gl-renderer").GlRenderer;
+        canvas: HTMLCanvasElement;
+    } | null;
+    setCellSize(pw: number, ph: number): void;
+    getCellSize(): {
+        pw: number;
+        ph: number;
+    };
+    wasmMemory(): WebAssembly.Memory | null;
+    noteFrameRendered(): void;
+    invalidateAtlas(): void;
+    setFontFamily(f: string): void;
+    setFontSize(s: number): void;
+    setPalette(p: TerminalPalette): void;
+    isReady(): boolean;
+    onReady(listener: () => void): () => void;
+    private emit;
+    private handleMessage;
+    private handleStatusChange;
+    private handleListMessage;
+    private handleSearchResults;
+    private syncTitleFromTerminal;
+    private upsertLiveSession;
+    private updateSession;
+    private markSessionClosed;
+    private firstLiveSessionId;
+    private rejectPendingCreates;
+    private rejectPendingSearches;
+    private rejectPendingReads;
+    private resolveAllPendingCloses;
+}
+export {};
+//# sourceMappingURL=BlitConnection.d.ts.map

package/dist/BlitConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlitConnection.d.ts","sourceRoot":"","sources":["../src/BlitConnection.ts"],"names":[],"mappings":"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"}