@floegence/floeterm-terminal-web 0.5.0 → 0.5.2

package/dist/fabric/TerminalFabricCoordinator.js.map

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

package/dist/fabric/TerminalLiveFabric.d.ts

@@ -0,0 +1,84 @@
+import type { Logger } from '../types';
+import type { TerminalFabricCell, TerminalFabricColor, TerminalFabricCursor, TerminalFabricDiagnostics, TerminalFabricFrameReason, TerminalFabricRenderer, TerminalFabricTheme } from './types';
+type GhosttyCellLike = {
+    codepoint?: number;
+    fg_r?: number;
+    fg_g?: number;
+    fg_b?: number;
+    bg_r?: number;
+    bg_g?: number;
+    bg_b?: number;
+    flags?: number;
+    width?: number;
+    grapheme_len?: number;
+    hyperlink_id?: number;
+};
+type GhosttyRendererLike = {
+    currentBuffer?: {
+        getGraphemeString?: (row: number, col: number) => string;
+    } | null;
+};
+type TerminalFabricSelectionRange = {
+    startCol: number;
+    startRow: number;
+    endCol: number;
+    endRow: number;
+};
+type TerminalFabricHoverRange = {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+};
+export type TerminalFabricRowRenderHints = {
+    selection?: (TerminalFabricSelectionRange & {
+        foreground: TerminalFabricColor;
+        background: TerminalFabricColor;
+    }) | null;
+    hover?: {
+        hyperlinkId?: number;
+        range?: TerminalFabricHoverRange | null;
+    } | null;
+};
+export type TerminalLiveFabricRendererFactory = (request: {
+    viewId: string;
+}) => TerminalFabricRenderer;
+export type TerminalLiveFabricAttachRequest = {
+    sessionId: string;
+    viewId: string;
+    container: HTMLElement;
+    logger: Logger;
+    fontFamily: string;
+    fontSize: number;
+    theme: Record<string, string>;
+    getGhosttyCanvas: () => HTMLCanvasElement | null;
+    focusInputSurface: () => void;
+    forwardWheel: (event: WheelEvent) => void;
+};
+export type TerminalLiveFabricOptions = {
+    createRenderer?: TerminalLiveFabricRendererFactory;
+};
+export type TerminalLiveFabricViewHandle = {
+    viewId: string;
+    sessionId: string;
+    renderer: TerminalFabricRenderer;
+    dispose(): void;
+};
+export declare class TerminalLiveFabric {
+    private readonly sessions;
+    private readonly views;
+    private readonly createRenderer;
+    constructor(options?: TerminalLiveFabricOptions);
+    attachView(request: TerminalLiveFabricAttachRequest): Promise<TerminalLiveFabricViewHandle>;
+    detachView(viewId: string): void;
+    private releaseSession;
+    getDiagnostics(): TerminalFabricDiagnostics;
+    dispose(): void;
+}
+export declare const terminalLiveFabric: TerminalLiveFabric;
+export declare const mapGhosttyRowToFabricCells: (renderer: GhosttyRendererLike, row: number, cells: GhosttyCellLike[], cols: number, hints?: TerminalFabricRowRenderHints) => TerminalFabricCell[];
+export declare const themeToFabricTheme: (theme: Record<string, string>) => TerminalFabricTheme;
+export declare const cursorToFabricCursor: (value: unknown) => TerminalFabricCursor | null;
+export declare const renderReasonFromForce: (forceAll: boolean) => TerminalFabricFrameReason;
+export {};
+//# sourceMappingURL=TerminalLiveFabric.d.ts.map

package/dist/fabric/TerminalLiveFabric.d.ts.map

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

package/dist/fabric/TerminalLiveFabric.js

@@ -0,0 +1,211 @@
+import { BeamtermFabricRenderer } from './BeamtermFabricRenderer';
+import { getTerminalFabricDiagnostics, terminalFabricCoordinator, } from './TerminalFabricCoordinator';
+export class TerminalLiveFabric {
+    constructor(options = {}) {
+        this.sessions = new Map();
+        this.views = new Map();
+        this.createRenderer = options.createRenderer ?? defaultRendererFactory;
+    }
+    async attachView(request) {
+        const session = this.sessions.get(request.sessionId) ?? {
+            sessionId: request.sessionId,
+            refCount: 0,
+        };
+        session.refCount += 1;
+        this.sessions.set(session.sessionId, session);
+        const renderer = this.createRenderer({ viewId: request.viewId });
+        try {
+            await renderer.initialize({
+                container: request.container,
+                logger: request.logger,
+                fontFamily: request.fontFamily,
+                fontSize: request.fontSize,
+                theme: request.theme,
+                getGhosttyCanvas: request.getGhosttyCanvas,
+                focusInputSurface: request.focusInputSurface,
+                forwardWheel: request.forwardWheel,
+            });
+        }
+        catch (error) {
+            this.releaseSession(session.sessionId);
+            terminalFabricCoordinator.noteFallback(error);
+            request.logger.warn('[TerminalLiveFabric] Beamterm renderer unavailable; keeping live canvas fallback', { error });
+            throw error;
+        }
+        const view = {
+            viewId: request.viewId,
+            sessionId: request.sessionId,
+            renderer,
+        };
+        this.views.set(view.viewId, view);
+        return {
+            viewId: view.viewId,
+            sessionId: view.sessionId,
+            renderer,
+            dispose: () => {
+                this.detachView(view.viewId);
+            },
+        };
+    }
+    detachView(viewId) {
+        const view = this.views.get(viewId);
+        if (!view) {
+            return;
+        }
+        this.views.delete(viewId);
+        view.renderer.dispose();
+        this.releaseSession(view.sessionId);
+    }
+    releaseSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        session.refCount -= 1;
+        if (session.refCount <= 0) {
+            this.sessions.delete(session.sessionId);
+        }
+    }
+    getDiagnostics() {
+        return getTerminalFabricDiagnostics();
+    }
+    dispose() {
+        for (const viewId of Array.from(this.views.keys())) {
+            this.detachView(viewId);
+        }
+        this.sessions.clear();
+    }
+}
+export const terminalLiveFabric = new TerminalLiveFabric();
+function defaultRendererFactory({ viewId }) {
+    void viewId;
+    return new BeamtermFabricRenderer();
+}
+export const mapGhosttyRowToFabricCells = (renderer, row, cells, cols, hints = {}) => {
+    const mapped = [];
+    for (let col = 0; col < cols; col += 1) {
+        const cell = cells[col] ?? {};
+        const selected = isCellInSelection(row, col, hints.selection);
+        const hovered = isCellHovered(row, col, cell, hints.hover);
+        const attrs = {
+            bold: hasFlag(cell, 1),
+            italic: hasFlag(cell, 2),
+            underline: hasFlag(cell, 4) || hovered,
+            strikethrough: hasFlag(cell, 8),
+            inverse: selected ? false : hasFlag(cell, 16),
+            invisible: hasFlag(cell, 32),
+            faint: hasFlag(cell, 128),
+        };
+        mapped[col] = {
+            symbol: resolveCellSymbol(renderer, cell, row, col),
+            width: Number(cell.width ?? 1) || 1,
+            fg: selected
+                ? hints.selection.foreground
+                : colorFromCell(cell, 'fg', { r: 255, g: 255, b: 255 }),
+            bg: selected
+                ? hints.selection.background
+                : colorFromCell(cell, 'bg', { r: 0, g: 0, b: 0 }),
+            attrs,
+        };
+    }
+    return mapped;
+};
+export const themeToFabricTheme = (theme) => ({
+    background: parseThemeColor(theme.background, 0x000000),
+    foreground: parseThemeColor(theme.foreground, 0xffffff),
+});
+export const cursorToFabricCursor = (value) => {
+    const raw = value;
+    if (!raw || typeof raw.x !== 'number' || typeof raw.y !== 'number') {
+        return null;
+    }
+    return {
+        x: raw.x,
+        y: raw.y,
+        visible: raw.visible !== false,
+    };
+};
+export const renderReasonFromForce = (forceAll) => (forceAll ? 'external' : 'write');
+const resolveCellSymbol = (renderer, cell, row, col) => {
+    if ((cell.grapheme_len ?? 0) > 0) {
+        const grapheme = renderer.currentBuffer?.getGraphemeString?.(row, col);
+        if (grapheme) {
+            return grapheme;
+        }
+    }
+    const codepoint = Number(cell.codepoint ?? 32);
+    if (!Number.isFinite(codepoint) || codepoint <= 0) {
+        return ' ';
+    }
+    try {
+        return String.fromCodePoint(codepoint);
+    }
+    catch {
+        return ' ';
+    }
+};
+const colorFromCell = (cell, prefix, fallback) => {
+    const r = Number(cell[`${prefix}_r`]);
+    const g = Number(cell[`${prefix}_g`]);
+    const b = Number(cell[`${prefix}_b`]);
+    if (![r, g, b].every(value => Number.isInteger(value) && value >= 0 && value <= 255)) {
+        return fallback;
+    }
+    return { r, g, b };
+};
+const hasFlag = (cell, flag) => ((Number(cell.flags ?? 0) & flag) !== 0);
+const isCellInSelection = (row, col, selection) => {
+    if (!selection) {
+        return false;
+    }
+    if (selection.startRow === selection.endRow) {
+        return row === selection.startRow && col >= selection.startCol && col <= selection.endCol;
+    }
+    if (row === selection.startRow) {
+        return col >= selection.startCol;
+    }
+    if (row === selection.endRow) {
+        return col <= selection.endCol;
+    }
+    return row > selection.startRow && row < selection.endRow;
+};
+const isCellHovered = (row, col, cell, hover) => {
+    if (!hover) {
+        return false;
+    }
+    const hoverId = Number(hover.hyperlinkId ?? 0);
+    if (hoverId > 0 && Number(cell.hyperlink_id ?? 0) === hoverId) {
+        return true;
+    }
+    const range = hover.range;
+    if (!range) {
+        return false;
+    }
+    if (row === range.startY && row === range.endY) {
+        return col >= range.startX && col <= range.endX;
+    }
+    if (row === range.startY) {
+        return col >= range.startX;
+    }
+    if (row === range.endY) {
+        return col <= range.endX;
+    }
+    return row > range.startY && row < range.endY;
+};
+const parseThemeColor = (value, fallback) => {
+    if (!value) {
+        return fallback;
+    }
+    const trimmed = value.trim();
+    const shortHex = /^#([0-9a-fA-F]{3})$/.exec(trimmed);
+    if (shortHex) {
+        const [r, g, b] = shortHex[1].split('');
+        return Number.parseInt(`${r}${r}${g}${g}${b}${b}`, 16);
+    }
+    const longHex = /^#([0-9a-fA-F]{6})$/.exec(trimmed);
+    if (longHex) {
+        return Number.parseInt(longHex[1], 16);
+    }
+    return fallback;
+};
+//# sourceMappingURL=TerminalLiveFabric.js.map

package/dist/fabric/TerminalLiveFabric.js.map

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

package/dist/fabric/types.d.ts

@@ -0,0 +1,112 @@
+import type { Logger } from '../types';
+export type TerminalFabricBackend = 'beamterm_webgl2' | 'main_thread_canvas_live';
+export type TerminalFabricRenderPath = 'main_thread_webgl2' | 'canvas_live_fallback';
+export type TerminalFabricVisibility = 'visible' | 'occluded' | 'offscreen';
+export type TerminalFabricColor = {
+    r: number;
+    g: number;
+    b: number;
+};
+export type TerminalFabricCellAttrs = {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    inverse?: boolean;
+    invisible?: boolean;
+    faint?: boolean;
+};
+export type TerminalFabricCell = {
+    symbol: string;
+    width: number;
+    fg: TerminalFabricColor;
+    bg: TerminalFabricColor;
+    attrs: TerminalFabricCellAttrs;
+};
+export type TerminalFabricCursor = {
+    x: number;
+    y: number;
+    visible: boolean;
+};
+export type TerminalFabricTheme = {
+    background: number;
+    foreground: number;
+};
+export type TerminalFabricGeometry = {
+    width: number;
+    height: number;
+    cellWidth: number;
+    cellHeight: number;
+    cols: number;
+    rows: number;
+};
+export type TerminalFabricFrameReason = 'initial' | 'write' | 'resize' | 'theme' | 'font' | 'selection' | 'scroll' | 'interaction' | 'context_restore' | 'external';
+export type TerminalFabricFrame = {
+    id: number;
+    forceAll: boolean;
+    reason: TerminalFabricFrameReason;
+    startedAtMs: number;
+};
+export type TerminalFabricFrameRenderResult = {
+    rendered: boolean;
+    renderedRows: number;
+    dirtyCells: number;
+};
+export type TerminalFabricStats = {
+    backend: TerminalFabricBackend;
+    renderPath: TerminalFabricRenderPath;
+    activeRendererCount: number;
+    visibleViewCount: number;
+    offscreenViewCount: number;
+    frameCount: number;
+    renderedFrameCount: number;
+    lastFrameDurationMs: number;
+    lastFrameRenderedRows: number;
+    lastFrameDirtyCells: number;
+    fullRepaintCount: number;
+    contextRestoreCount: number;
+    fallbackCount: number;
+    workerRestartCount: number;
+    pendingDeltaCount: number;
+    coalescedFrameCount: number;
+};
+export type TerminalFabricDiagnostics = TerminalFabricStats & {
+    webgl2Supported: boolean;
+    beamtermLoaded: boolean;
+    lastError: string;
+};
+export type TerminalFabricRendererTarget = {
+    container: HTMLElement;
+    logger: Logger;
+    fontFamily: string;
+    fontSize: number;
+    theme: Record<string, string>;
+    getGhosttyCanvas: () => HTMLCanvasElement | null;
+    focusInputSurface: () => void;
+    forwardWheel: (event: WheelEvent) => void;
+};
+export type TerminalFabricRenderer = {
+    readonly backend: TerminalFabricBackend;
+    readonly renderPath: TerminalFabricRenderPath;
+    initialize(target: TerminalFabricRendererTarget): Promise<void>;
+    isActive(): boolean;
+    startFrame(frame: TerminalFabricFrame, options: {
+        cols: number;
+        rows: number;
+        theme: TerminalFabricTheme;
+    }): void;
+    writeRow(row: number, cells: TerminalFabricCell[], cols: number): void;
+    finishFrame(cursor: TerminalFabricCursor | null): TerminalFabricFrameRenderResult;
+    resize(width: number, height: number): void;
+    getGeometry(): TerminalFabricGeometry | null;
+    setAppearance(appearance: {
+        fontFamily?: string;
+        fontSize?: number;
+        theme?: Record<string, string>;
+    }): void;
+    setVisible(visible: boolean): void;
+    loseContextForTest(): void;
+    getDiagnostics(): TerminalFabricDiagnostics;
+    dispose(): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/fabric/types.d.ts.map

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

package/dist/fabric/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/fabric/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/fabric/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -2,9 +2,11 @@ export { TerminalCore } from './core/TerminalCore';
 export { TerminalState } from './types';
 export { createTerminalInstance, FrameworkNeutralTerminalInstanceController, } from './manager/TerminalInstanceController';
 export { getTerminalRenderSchedulerStats, resetTerminalRenderSchedulerStats, } from './core/TerminalRenderScheduler';
+export { getTerminalFabricDiagnostics, resetTerminalFabricDiagnostics, } from './fabric/TerminalFabricCoordinator';
 export { TerminalSessionsCoordinator } from './sessions/TerminalSessionsCoordinator';
 export type { TerminalSessionsCoordinatorOptions } from './sessions/TerminalSessionsCoordinator';
 export type { TerminalRenderSchedulerStats } from './core/TerminalRenderScheduler';
+export type { TerminalFabricBackend, TerminalFabricDiagnostics, TerminalFabricRenderPath, TerminalFabricStats, } from './fabric/types';
 export type { Logger, TerminalBufferCellPosition, TerminalBufferRange, TerminalClipboardConfig, TerminalAppearance, TerminalConfig, TerminalCopySelectionResult, TerminalCopySelectionSource, TerminalResponsiveConfig, TerminalRuntimeLineSnapshot, TerminalEventHandlers, TerminalInstanceController, TerminalInstanceListener, TerminalInstanceMutableOptions, TerminalInstanceOptions, TerminalInstanceScheduler, TerminalInstanceSnapshot, TerminalLoadingState, TerminalID, TerminalSessionInfo, TerminalDataChunk, TerminalDataEvent, TerminalNameUpdateEvent, TerminalTransport, TerminalEventSource, TerminalManagerOptions, TerminalManagerReturn, TerminalManagerActions, TerminalManagerAppearance, TerminalManagerState, TerminalError, TerminalLink, TerminalLinkProvider, TerminalSelectionSnapshot, TerminalTouchScrollRuntime, TerminalVisualSuspendHandle, TerminalVisualSuspendOptions, TerminalVisualSuspendReason, TerminalThemeName } from './types';
 export { getThemeColors, getDefaultTerminalConfig } from './utils/config';
 export { filterXtermAutoResponses } from './utils/xtermAutoResponseFilter';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,0CAA0C,GAC3C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AACjG,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,YAAY,EACV,MAAM,EACN,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,0CAA0C,GAC3C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AACjG,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,MAAM,EACN,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export { TerminalCore } from './core/TerminalCore';
 export { TerminalState } from './types';
 export { createTerminalInstance, FrameworkNeutralTerminalInstanceController, } from './manager/TerminalInstanceController';
 export { getTerminalRenderSchedulerStats, resetTerminalRenderSchedulerStats, } from './core/TerminalRenderScheduler';
+export { getTerminalFabricDiagnostics, resetTerminalFabricDiagnostics, } from './fabric/TerminalFabricCoordinator';
 export { TerminalSessionsCoordinator } from './sessions/TerminalSessionsCoordinator';
 export { getThemeColors, getDefaultTerminalConfig } from './utils/config';
 export { filterXtermAutoResponses } from './utils/xtermAutoResponseFilter';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,0CAA0C,GAC3C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AA8CrF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,0CAA0C,GAC3C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAoDrF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/internal/TerminalInitializationScheduler.d.ts

@@ -0,0 +1,22 @@
+import { type ScheduleTurn } from './scheduleUiTurn';
+export type TerminalInitializationPermit = {
+    release(): void;
+};
+export declare class TerminalInitializationScheduler {
+    private readonly maxConcurrent;
+    private readonly scheduleTurn;
+    private readonly queue;
+    private activeCount;
+    private drainScheduled;
+    constructor(maxConcurrent?: number, scheduleTurn?: ScheduleTurn);
+    acquire(signal?: AbortSignal): Promise<TerminalInitializationPermit | null>;
+    getSnapshot(): {
+        active: number;
+        queued: number;
+        maxConcurrent: number;
+    };
+    private scheduleDrain;
+    private drain;
+}
+export declare const terminalInitializationScheduler: TerminalInitializationScheduler;
+//# sourceMappingURL=TerminalInitializationScheduler.d.ts.map

package/dist/internal/TerminalInitializationScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalInitializationScheduler.d.ts","sourceRoot":"","sources":["../../src/internal/TerminalInitializationScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAaF,qBAAa,+BAA+B;IAMxC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAS;gBAGZ,aAAa,SAAsC,EACnD,YAAY,GAAE,YAAgC;IAGjE,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAwB3E,WAAW,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAQxE,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,KAAK;CA2Bd;AAED,eAAO,MAAM,+BAA+B,iCAAwC,CAAC"}

package/dist/internal/TerminalInitializationScheduler.js

@@ -0,0 +1,79 @@
+import { scheduleNextFrame } from './scheduleUiTurn';
+const DEFAULT_MAX_CONCURRENT_INITIALIZERS = 3;
+// Terminal initialization is CPU and WebGL-resource heavy. A small global gate
+// keeps large live grids responsive while every mounted terminal still becomes
+// a real, live terminal instead of a snapshot or paused placeholder.
+export class TerminalInitializationScheduler {
+    constructor(maxConcurrent = DEFAULT_MAX_CONCURRENT_INITIALIZERS, scheduleTurn = scheduleNextFrame) {
+        this.maxConcurrent = maxConcurrent;
+        this.scheduleTurn = scheduleTurn;
+        this.queue = [];
+        this.activeCount = 0;
+        this.drainScheduled = false;
+    }
+    acquire(signal) {
+        if (signal?.aborted) {
+            return Promise.resolve(null);
+        }
+        return new Promise(resolve => {
+            const waiter = {
+                resolve,
+                signal,
+                onAbort: () => {
+                    const index = this.queue.indexOf(waiter);
+                    if (index >= 0) {
+                        this.queue.splice(index, 1);
+                    }
+                    resolve(null);
+                },
+            };
+            signal?.addEventListener('abort', waiter.onAbort, { once: true });
+            this.queue.push(waiter);
+            this.scheduleDrain();
+        });
+    }
+    getSnapshot() {
+        return {
+            active: this.activeCount,
+            queued: this.queue.length,
+            maxConcurrent: this.maxConcurrent,
+        };
+    }
+    scheduleDrain() {
+        if (this.drainScheduled) {
+            return;
+        }
+        this.drainScheduled = true;
+        this.scheduleTurn(() => {
+            this.drainScheduled = false;
+            this.drain();
+        });
+    }
+    drain() {
+        while (this.activeCount < this.maxConcurrent && this.queue.length > 0) {
+            const waiter = this.queue.shift();
+            if (!waiter) {
+                continue;
+            }
+            waiter.signal?.removeEventListener('abort', waiter.onAbort);
+            if (waiter.signal?.aborted) {
+                waiter.resolve(null);
+                continue;
+            }
+            this.activeCount += 1;
+            let released = false;
+            waiter.resolve({
+                release: () => {
+                    if (released) {
+                        return;
+                    }
+                    released = true;
+                    this.activeCount = Math.max(0, this.activeCount - 1);
+                    this.scheduleDrain();
+                },
+            });
+        }
+    }
+}
+export const terminalInitializationScheduler = new TerminalInitializationScheduler();
+//# sourceMappingURL=TerminalInitializationScheduler.js.map

package/dist/internal/TerminalInitializationScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalInitializationScheduler.js","sourceRoot":"","sources":["../../src/internal/TerminalInitializationScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,kBAAkB,CAAC;AAYxE,MAAM,mCAAmC,GAAG,CAAC,CAAC;AAE9C,+EAA+E;AAC/E,+EAA+E;AAC/E,qEAAqE;AACrE,MAAM,OAAO,+BAA+B;IAK1C,YACmB,gBAAgB,mCAAmC,EACnD,eAA6B,iBAAiB;QAD9C,kBAAa,GAAb,aAAa,CAAsC;QACnD,iBAAY,GAAZ,YAAY,CAAkC;QANhD,UAAK,GAAmC,EAAE,CAAC;QACpD,gBAAW,GAAG,CAAC,CAAC;QAChB,mBAAc,GAAG,KAAK,CAAC;IAK5B,CAAC;IAEJ,OAAO,CAAC,MAAoB;QAC1B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3B,MAAM,MAAM,GAAiC;gBAC3C,OAAO;gBACP,MAAM;gBACN,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBACzC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;wBACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBAC9B,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;aACF,CAAC;YAEF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE;YACrB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,OAAO,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YAED,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;YACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC;gBACb,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,QAAQ,EAAE,CAAC;wBACb,OAAO;oBACT,CAAC;oBACD,QAAQ,GAAG,IAAI,CAAC;oBAChB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;oBACrD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,+BAA+B,EAAE,CAAC"}

package/dist/internal/scheduleUiTurn.d.ts

@@ -0,0 +1,5 @@
+export type ScheduledTurnCancel = () => void;
+export type ScheduleTurn = (callback: () => void) => void;
+export declare const scheduleUiTurn: (callback: () => void) => ScheduledTurnCancel;
+export declare const scheduleNextFrame: ScheduleTurn;
+//# sourceMappingURL=scheduleUiTurn.d.ts.map

package/dist/internal/scheduleUiTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleUiTurn.d.ts","sourceRoot":"","sources":["../../src/internal/scheduleUiTurn.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC;AAC7C,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAI1D,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,IAAI,KAAG,mBAiCrD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,YAE/B,CAAC"}