restty 0.1.35 → 0.2.0

package/dist/runtime/create-runtime/debug-tools/create-dump-glyph-render.d.ts

@@ -1,2 +0,0 @@
-import type { CreateRuntimeDebugToolsOptions } from "./types";
-export declare function createDumpGlyphRender(options: CreateRuntimeDebugToolsOptions): (cp: number, constraintWidth?: number) => Promise<ImageData>;

package/dist/runtime/create-runtime/debug-tools/diagnose-codepoint.d.ts

@@ -1,2 +0,0 @@
-import type { CreateRuntimeDebugToolsOptions } from "./types";
-export declare function createDiagnoseCodepoint(options: CreateRuntimeDebugToolsOptions): (cp: number) => void;

package/dist/runtime/create-runtime/debug-tools/dump-atlas-for-codepoint.d.ts

@@ -1,2 +0,0 @@
-import type { CreateRuntimeDebugToolsOptions } from "./types";
-export declare function createDumpAtlasForCodepoint(options: CreateRuntimeDebugToolsOptions): (cp: number) => void;

package/dist/runtime/create-runtime/debug-tools/read-texture-to-image-data.d.ts

@@ -1 +0,0 @@
-export declare function readTextureToImageData(device: GPUDevice, texture: GPUTexture, width: number, height: number, origin?: GPUOrigin3D): Promise<ImageData>;

package/dist/runtime/create-runtime/debug-tools/setup-debug-expose.d.ts

@@ -1,2 +0,0 @@
-import type { CreateRuntimeDebugToolsOptions } from "./types";
-export declare function createSetupDebugExpose(options: CreateRuntimeDebugToolsOptions, diagnoseCodepoint: (cp: number) => void): () => void;

package/dist/runtime/create-runtime/debug-tools/types.d.ts

@@ -1,63 +0,0 @@
-import type { fontAdvanceUnits as fontAdvanceUnitsFn, fontMaxCellSpan as fontMaxCellSpanFn, fontScaleOverride as fontScaleOverrideFn, FontEntry, FontManagerState, NerdConstraint, isColorEmojiFont as isColorEmojiFontFn, isNerdSymbolCodepoint as isNerdSymbolCodepointFn, isSymbolFont as isSymbolFontFn } from "../../../fonts";
-import type { clamp as clampFn, fontHeightUnits as fontHeightUnitsFn } from "../../../grid";
-import type { WebGLState, WebGPUState } from "../../../renderer";
-import type { GlyphConstraintMeta, AtlasConstraintContext } from "../../atlas-builder";
-import type { NerdMetrics } from "../render-tick-webgpu.types";
-export type GridState = {
-    cols: number;
-    rows: number;
-    cellW: number;
-    cellH: number;
-    fontSizePx: number;
-    yPad: number;
-};
-export type FontConfig = {
-    sizePx: number;
-};
-export type ShapeClusterResult = {
-    glyphs: Array<{
-        glyphId: number;
-        xAdvance: number;
-        xOffset: number;
-        yOffset: number;
-    }>;
-    advance: number;
-};
-export type BuildNerdMetricsFn = (cellW: number, cellH: number, lineHeight: number, font: FontEntry["font"] | null | undefined, primaryScale: number, nerdIconScale: number) => NerdMetrics;
-export type EnsureAtlasForFontFn = (device: GPUDevice, state: WebGPUState, entry: FontEntry, neededGlyphIds: Set<number>, fontSizePx: number, fontIndex: number, atlasScale: number, glyphMeta?: Map<number, GlyphConstraintMeta>, constraintContext?: AtlasConstraintContext | null) => boolean;
-export type CreateRuntimeDebugToolsOptions = {
-    debugExpose: boolean;
-    getWindow: () => (Window & typeof globalThis) | undefined;
-    getActiveState: () => WebGPUState | WebGLState | null;
-    getCanvas: () => HTMLCanvasElement;
-    atlasCanvas: HTMLCanvasElement | null;
-    atlasInfoEl: HTMLElement | null;
-    fontState: FontManagerState;
-    gridState: GridState;
-    fontConfig: FontConfig;
-    pickFontIndexForText: (text: string, expectedSpan?: number) => number;
-    ensureAtlasForFont: EnsureAtlasForFontFn;
-    formatCodepoint: (cp: number) => string;
-    isSymbolFont: typeof isSymbolFontFn;
-    isNerdSymbolCodepoint: typeof isNerdSymbolCodepointFn;
-    isSymbolCp: (cp: number) => boolean;
-    fontHasGlyph: (font: FontEntry["font"], ch: string) => boolean;
-    shapeClusterWithFont: (entry: FontEntry, text: string) => ShapeClusterResult;
-    getNerdConstraint: (cp: number) => NerdConstraint | null;
-    fontHeightUnits: typeof fontHeightUnitsFn;
-    fontScaleOverride: typeof fontScaleOverrideFn;
-    fontScaleOverrides: Array<{
-        match: RegExp;
-        scale: number;
-    }>;
-    fontAdvanceUnits: typeof fontAdvanceUnitsFn;
-    fontMaxCellSpan: typeof fontMaxCellSpanFn;
-    clamp: typeof clampFn;
-    buildNerdMetrics: BuildNerdMetricsFn;
-    nerdIconScale: number;
-    isColorEmojiFont: typeof isColorEmojiFontFn;
-    atlasPadding: number;
-    symbolAtlasPadding: number;
-    pixelModeGray: number;
-    pixelModeRgba: number;
-};

package/dist/runtime/create-runtime/debug-tools.d.ts

@@ -1,6 +0,0 @@
-import type { CreateRuntimeDebugToolsOptions } from "./debug-tools/types";
-export type { CreateRuntimeDebugToolsOptions } from "./debug-tools/types";
-export declare function createRuntimeDebugTools(options: CreateRuntimeDebugToolsOptions): {
-    dumpAtlasForCodepoint: (cp: number) => void;
-    setupDebugExpose: () => void;
-};

package/dist/runtime/create-runtime/font-runtime-grid-helpers.d.ts

@@ -1,31 +0,0 @@
-import { type FontEntry, type FontManagerState } from "../../fonts";
-import type { WebGLState, WebGPUState } from "../../renderer";
-import type { PtyTransport } from "../../pty";
-import type { ResttyWasm } from "../../wasm";
-import type { ResttyAppCallbacks } from "../types";
-import type { CellMetrics, FontConfigRef, GridStateRef } from "./font-runtime-helpers.types";
-type CreateFontRuntimeGridHelpersOptions = {
-    fontState: FontManagerState;
-    fontConfig: FontConfigRef;
-    gridState: GridStateRef;
-    callbacks?: ResttyAppCallbacks;
-    gridEl: HTMLElement | null;
-    cellEl: HTMLElement | null;
-    getCanvas: () => HTMLCanvasElement;
-    getCurrentDpr: () => number;
-    getActiveState: () => WebGPUState | WebGLState | null;
-    getWasmReady: () => boolean;
-    getWasm: () => ResttyWasm | null;
-    getWasmHandle: () => number;
-    ptyTransport: PtyTransport;
-    setNeedsRender: () => void;
-    markSearchDirty?: () => void;
-    shapeClusterWithFont: (entry: FontEntry, text: string) => {
-        advance: number;
-    };
-};
-export declare function createFontRuntimeGridHelpers(options: CreateFontRuntimeGridHelpersOptions): {
-    computeCellMetrics: () => CellMetrics | null;
-    updateGrid: () => void;
-};
-export {};

package/dist/runtime/create-runtime/font-runtime-helpers.d.ts

@@ -1,15 +0,0 @@
-import type { CreateRuntimeFontRuntimeHelpersOptions } from "./font-runtime-helpers.types";
-export type { CreateRuntimeFontRuntimeHelpersOptions } from "./font-runtime-helpers.types";
-export declare function createRuntimeFontRuntimeHelpers(options: CreateRuntimeFontRuntimeHelpersOptions): {
-    ensureAtlasForFont: (device: GPUDevice, state: import("../../renderer").WebGPUState, entry: import("../../fonts").FontEntry, neededGlyphIds: Set<number>, fontSizePx: number, fontIndex: number, atlasScale: number, glyphMeta?: Map<number, import("../atlas-builder").GlyphConstraintMeta>, constraintContext?: import("../atlas-builder").AtlasConstraintContext | null) => boolean;
-    computeCellMetrics: () => import("./font-runtime-helpers.types").CellMetrics | null;
-    updateGrid: () => void;
-    shapeClusterWithFont: (entry: import("../../fonts").FontEntry, text: string) => import("../../fonts").ShapedCluster;
-    noteColorGlyphText: (entry: import("../../fonts").FontEntry, text: string, shaped: {
-        glyphs: Array<{
-            glyphId: number;
-        }>;
-    }) => void;
-    fontHasGlyph: (font: import("../../fonts").Font, ch: string) => boolean;
-    pickFontIndexForText: (text: string, expectedSpan?: number, stylePreference?: string) => number;
-};

package/dist/runtime/create-runtime/font-runtime-text-helpers.d.ts

@@ -1,21 +0,0 @@
-import { type Font, type FontEntry, type FontManagerState } from "../../fonts";
-import type { GlyphBufferToShapedGlyphsFn, ShapeFn, UnicodeBufferCtor } from "./font-runtime-helpers.types";
-type CreateFontRuntimeTextHelpersOptions = {
-    fontState: FontManagerState;
-    glyphShapeCacheLimit: number;
-    fontPickCacheLimit: number;
-    UnicodeBuffer: UnicodeBufferCtor;
-    shape: ShapeFn;
-    glyphBufferToShapedGlyphs: GlyphBufferToShapedGlyphsFn;
-};
-export declare function createFontRuntimeTextHelpers(options: CreateFontRuntimeTextHelpersOptions): {
-    shapeClusterWithFont: (entry: FontEntry, text: string) => import("../../fonts").ShapedCluster;
-    noteColorGlyphText: (entry: FontEntry, text: string, shaped: {
-        glyphs: Array<{
-            glyphId: number;
-        }>;
-    }) => void;
-    fontHasGlyph: (font: Font, ch: string) => boolean;
-    pickFontIndexForText: (text: string, expectedSpan?: number, stylePreference?: string) => number;
-};
-export {};

package/dist/runtime/create-runtime/font-runtime-webgpu-atlas.d.ts

@@ -1,29 +0,0 @@
-import { type FontEntry, type FontManagerState } from "../../fonts";
-import type { WebGPUState } from "../../renderer";
-import { type AtlasConstraintContext, type GlyphConstraintMeta } from "../atlas-builder";
-import type { ResttyFontHintTarget } from "../types";
-import type { AtlasBitmapToRGBA, BuildAtlasFn, BuildColorEmojiAtlasWithCanvas, PadAtlasRGBAFn, RasterizeGlyphFn, RasterizeGlyphWithTransformFn, ResolveGlyphPixelMode } from "./font-runtime-helpers.types";
-type CreateRuntimeWebGPUAtlasHelpersOptions = {
-    fontState: FontManagerState;
-    getFontHinting: () => boolean;
-    getFontHintTarget: () => ResttyFontHintTarget;
-    fontScaleOverrides: Array<{
-        match: RegExp;
-        scale: number;
-    }>;
-    resolveGlyphPixelMode: ResolveGlyphPixelMode;
-    atlasBitmapToRGBA: AtlasBitmapToRGBA;
-    padAtlasRGBA: PadAtlasRGBAFn;
-    buildAtlas: BuildAtlasFn;
-    buildColorEmojiAtlasWithCanvas: BuildColorEmojiAtlasWithCanvas;
-    rasterizeGlyph: RasterizeGlyphFn;
-    rasterizeGlyphWithTransform: RasterizeGlyphWithTransformFn;
-    pixelModeRgbaValue: number;
-    atlasPadding: number;
-    symbolAtlasPadding: number;
-    symbolAtlasMaxSize: number;
-};
-export declare function createRuntimeWebGPUAtlasHelpers(options: CreateRuntimeWebGPUAtlasHelpersOptions): {
-    ensureAtlasForFont: (device: GPUDevice, state: WebGPUState, entry: FontEntry, neededGlyphIds: Set<number>, fontSizePx: number, fontIndex: number, atlasScale: number, glyphMeta?: Map<number, GlyphConstraintMeta>, constraintContext?: AtlasConstraintContext | null) => boolean;
-};
-export {};

package/dist/runtime/create-runtime/lifecycle-theme-size-theme.d.ts

@@ -1,6 +0,0 @@
-import { type GhosttyTheme } from "../../theme";
-import type { LifecycleThemeSizeDeps } from "./lifecycle-theme-size.types";
-export declare function createLifecycleThemeHandlers(deps: LifecycleThemeSizeDeps): {
-    applyTheme: (theme: GhosttyTheme | null | undefined, sourceLabel?: string) => void;
-    resetTheme: () => void;
-};

package/dist/runtime/create-runtime/runtime-app-api.d.ts

@@ -1,113 +0,0 @@
-import type { InputHandler } from "../../input";
-import { type WebGPUState, type WebGLState } from "../../renderer";
-import type { PtyTransport } from "../../pty";
-import { type GhosttyTheme } from "../../theme";
-import type { ResttyWasm, ResttyWasmExports } from "../../wasm";
-import type { ResttyApp, ResttyAppCallbacks, ResttyAppSession } from "../types";
-import type { PtyInputRuntime } from "./pty-input-runtime";
-import type { RuntimeInteraction } from "./interaction-runtime";
-export type RuntimeAppApiSharedState = {
-    wasm: ResttyWasm | null;
-    wasmExports: ResttyWasmExports | null;
-    wasmHandle: number;
-    wasmReady: boolean;
-    activeState: WebGPUState | WebGLState | null;
-    needsRender: boolean;
-    lastRenderTime: number;
-    currentContextType: "webgpu" | "webgl2" | null;
-    isFocused: boolean;
-    lastKeydownSeq: string;
-    lastKeydownSeqAt: number;
-};
-type PreferredRenderer = "auto" | "webgpu" | "webgl2";
-type RuntimeSendInput = (text: string, source?: string, options?: {
-    skipHooks?: boolean;
-}) => void;
-type RuntimePublicApiOptions = {
-    setFontSize: ResttyApp["setFontSize"];
-    setLigatures: ResttyApp["setLigatures"];
-    setFontHinting: ResttyApp["setFontHinting"];
-    setFontHintTarget: ResttyApp["setFontHintTarget"];
-    setFontSources: ResttyApp["setFontSources"];
-    resetTheme: ResttyApp["resetTheme"];
-    setSearchQuery: ResttyApp["setSearchQuery"];
-    clearSearch: ResttyApp["clearSearch"];
-    searchNext: ResttyApp["searchNext"];
-    searchPrevious: ResttyApp["searchPrevious"];
-    getSearchState: ResttyApp["getSearchState"];
-    dumpAtlasForCodepoint: ResttyApp["dumpAtlasForCodepoint"];
-    resize: ResttyApp["resize"];
-    focus: ResttyApp["focus"];
-    blur: ResttyApp["blur"];
-    updateSize: ResttyApp["updateSize"];
-    setShaderStages: ResttyApp["setShaderStages"];
-    getShaderStages: ResttyApp["getShaderStages"];
-};
-export type RuntimeAppApiRuntime = {
-    sendInput: RuntimeSendInput;
-    createPublicApi: (options: RuntimePublicApiOptions) => ResttyApp;
-};
-type LifecycleThemeRuntime = {
-    cancelScheduledSizeUpdate: () => void;
-    getActiveTheme: () => GhosttyTheme | null;
-};
-type CreateRuntimeAppApiOptions = {
-    session: ResttyAppSession;
-    ptyTransport: PtyTransport;
-    inputHandler: InputHandler;
-    ptyInputRuntime: PtyInputRuntime;
-    interaction: RuntimeInteraction;
-    lifecycleThemeSizeRuntime: LifecycleThemeRuntime;
-    cleanupFns: Array<() => void>;
-    cleanupCanvasFns: Array<() => void>;
-    callbacks?: ResttyAppCallbacks;
-    fpsEl: HTMLElement | null;
-    backendEl: HTMLElement | null;
-    inputDebugEl: HTMLElement | null;
-    imeInput: HTMLTextAreaElement | null;
-    attachWindowEvents: boolean;
-    isMacPlatform: boolean;
-    textEncoder: TextEncoder;
-    readState: () => RuntimeAppApiSharedState;
-    writeState: (patch: Partial<RuntimeAppApiSharedState>) => void;
-    appendLog: (line: string) => void;
-    shouldSuppressWasmLog: (text: string) => boolean;
-    runBeforeInputHook: (text: string, source: string) => string | null;
-    runBeforeRenderOutputHook: (text: string, source: string) => string | null;
-    getSelectionText: () => string;
-    initialPreferredRenderer: PreferredRenderer;
-    maxScrollbackBytes?: number;
-    maxScrollback?: number;
-    CURSOR_BLINK_MS: number;
-    RESIZE_ACTIVE_MS: number;
-    TARGET_RENDER_FPS: number;
-    BACKGROUND_RENDER_FPS: number;
-    KITTY_FLAG_REPORT_EVENTS: number;
-    resizeState: {
-        lastAt: number;
-    };
-    tickWebGPU: (state: WebGPUState) => void;
-    tickWebGL: (state: WebGLState) => void;
-    updateGrid: () => void;
-    gridState: {
-        cols: number;
-        rows: number;
-    };
-    getCanvas: () => HTMLCanvasElement;
-    applyTheme: ResttyApp["applyTheme"];
-    ensureFont: () => Promise<void>;
-    updateSize: ResttyApp["updateSize"];
-    log: (line: string) => void;
-    replaceCanvas: () => void;
-    rebuildWebGPUShaderStages: (state: WebGPUState) => void;
-    rebuildWebGLShaderStages: (state: WebGLState) => void;
-    setShaderStagesDirty: (dirty: boolean) => void;
-    clearWebGPUShaderStages: () => void;
-    destroyWebGPUStageTargets: () => void;
-    clearWebGLShaderStages: (state?: WebGLState) => void;
-    destroyWebGLStageTargets: (state?: WebGLState) => void;
-    markSearchDirty: () => void;
-    handleSearchWasmReset: () => void;
-};
-export declare function createRuntimeAppApi(options: CreateRuntimeAppApiOptions): RuntimeAppApiRuntime;
-export {};

package/dist/runtime/create-runtime/runtime-logger.d.ts

@@ -1,17 +0,0 @@
-type RuntimeLogFilter = {
-    re: RegExp;
-    note: string;
-};
-export type CreateRuntimeLoggerOptions = {
-    logEl?: HTMLElement | null;
-    onLog?: ((entry: string) => void) | null;
-    logLimit?: number;
-    wasmLogFilters?: RuntimeLogFilter[];
-};
-export type RuntimeLogger = {
-    log: (msg: string) => void;
-    appendLog: (line: string) => void;
-    shouldSuppressWasmLog: (text: string) => boolean;
-};
-export declare function createRuntimeLogger(options: CreateRuntimeLoggerOptions): RuntimeLogger;
-export {};

package/dist/runtime/font-sources.d.ts

@@ -1,5 +0,0 @@
-import type { ResttyFontPreset, ResttyFontSource } from "./types";
-/** Local-first default font fallback chain with CDN fallback for JetBrains Mono, Nerd symbols, emoji, and CJK support. */
-export declare const DEFAULT_FONT_SOURCES: ResttyFontSource[];
-/** Validates user-provided font sources or returns defaults based on preset (none returns empty array, otherwise default CDN fonts). */
-export declare function normalizeFontSources(sources: ResttyFontSource[] | undefined, preset: ResttyFontPreset | undefined): ResttyFontSource[];

package/dist/runtime/pty-output-buffer.d.ts

@@ -1,12 +0,0 @@
-export type CreatePtyOutputBufferControllerOptions = {
-    idleMs: number;
-    maxMs: number;
-    onFlush: (text: string) => void;
-};
-export type PtyOutputBufferController = {
-    queue: (text: string) => void;
-    flush: () => void;
-    cancel: () => void;
-    clear: () => void;
-};
-export declare function createPtyOutputBufferController(options: CreatePtyOutputBufferControllerOptions): PtyOutputBufferController;

package/dist/runtime/session.d.ts

@@ -1,9 +0,0 @@
-import type { ResttyAppSession } from "./types";
-/**
- * Create a new app session that lazily loads the WASM module and
- * initializes the WebGPU core on first use. Multiple panes can
- * share a single session to avoid duplicate resource loading.
- */
-export declare function createResttyAppSession(): ResttyAppSession;
-/** Return the global default session, creating it on first call. */
-export declare function getDefaultResttyAppSession(): ResttyAppSession;

package/dist/surface/app-factory.d.ts

@@ -1,3 +0,0 @@
-import type { ResttyApp, ResttyAppOptions } from "../runtime/types";
-/** Internal app-construction boundary used by pane manager wiring. */
-export declare function createResttyApp(options: ResttyAppOptions): ResttyApp;

package/dist/surface/restty-plugin-runtime.d.ts

@@ -1,57 +0,0 @@
-import type { ResttyShaderStage } from "../runtime/types";
-import type { ResttyInterceptorOptions, ResttyPlugin, ResttyPluginEvents, ResttyPluginInfo, ResttyPluginRequires } from "./restty-plugin-types";
-export type ResttyPluginRuntimeDisposerKind = "event" | "input-interceptor" | "output-interceptor" | "lifecycle-hook" | "render-hook" | "render-stage";
-export type ResttyPluginRuntimeDisposer = {
-    kind: ResttyPluginRuntimeDisposerKind;
-    active: boolean;
-    dispose: () => void;
-};
-export type ResttyPluginRuntime = {
-    plugin: ResttyPlugin;
-    cleanup: (() => void) | null;
-    activatedAt: number;
-    options: unknown;
-    disposers: Array<ResttyPluginRuntimeDisposer>;
-};
-export type ResttyPluginDiagnostic = {
-    id: string;
-    version: string | null;
-    apiVersion: number | null;
-    requires: ResttyPluginRequires | null;
-    active: boolean;
-    activatedAt: number | null;
-    lastError: string | null;
-};
-export type ResttyRegisteredInterceptor<T extends (payload: unknown) => unknown> = {
-    id: number;
-    pluginId: string;
-    priority: number;
-    order: number;
-    interceptor: T;
-};
-export type ResttyManagedShaderStage = {
-    id: string;
-    stage: ResttyShaderStage;
-    order: number;
-    ownerPluginId: string | null;
-};
-export type ResttyInterceptorSeq = {
-    nextId: number;
-    nextOrder: number;
-};
-export declare function registerPluginInterceptor<T extends (payload: unknown) => unknown>(bucket: Array<ResttyRegisteredInterceptor<T>>, pluginId: string, interceptor: T, options: ResttyInterceptorOptions | undefined, seq: ResttyInterceptorSeq): {
-    dispose: () => void;
-    nextId: number;
-    nextOrder: number;
-};
-export declare function applyPluginInterceptors<TPayload extends {
-    text: string;
-}>(bucket: Array<ResttyRegisteredInterceptor<(payload: TPayload) => string | null | void>>, kind: "input" | "output", payload: TPayload): string | null;
-export declare function runPluginHooks<TPayload>(bucket: Array<ResttyRegisteredInterceptor<(payload: TPayload) => void>>, kind: "lifecycle" | "render", payload: TPayload): void;
-export declare function attachRuntimeDisposer(runtime: ResttyPluginRuntime, kind: ResttyPluginRuntimeDisposerKind, dispose: () => void): () => void;
-export declare function teardownPluginRuntime(runtime: ResttyPluginRuntime): void;
-export declare function setPluginLoadError(pluginDiagnostics: Map<string, ResttyPluginDiagnostic>, pluginId: string, message: string): void;
-export declare function patchPluginDiagnostic(pluginDiagnostics: Map<string, ResttyPluginDiagnostic>, pluginId: string, patch: Partial<Pick<ResttyPluginDiagnostic, "active" | "activatedAt" | "lastError">>): void;
-export declare function buildPluginInfo(pluginId: string, pluginDiagnostics: Map<string, ResttyPluginDiagnostic>, pluginRuntimes: Map<string, ResttyPluginRuntime>): ResttyPluginInfo | null;
-export declare function onPluginEvent<E extends keyof ResttyPluginEvents>(pluginListeners: Map<keyof ResttyPluginEvents, Set<(payload: unknown) => void>>, event: E, listener: (payload: ResttyPluginEvents[E]) => void): () => void;
-export declare function emitPluginEvent<E extends keyof ResttyPluginEvents>(pluginListeners: Map<keyof ResttyPluginEvents, Set<(payload: unknown) => void>>, event: E, payload: ResttyPluginEvents[E]): void;

package/dist/xterm/app-options.d.ts

@@ -1,2 +0,0 @@
-import type { ResttyOptions } from "../surface/restty";
-export declare function createCompatAppOptions(userAppOptions: ResttyOptions["appOptions"], emitData: (data: string) => void): ResttyOptions["appOptions"];