restty 0.1.30 → 0.1.32

package/dist/fonts/types.d.ts

@@ -39,6 +39,10 @@ export type FontEntry = {
     advanceUnits: number;
     /** Signature string used to detect constraint changes for atlas invalidation. */
     constraintSignature?: string;
+    /** Last atlas build hinting mode for invalidation checks. */
+    atlasHinting?: boolean;
+    /** Last atlas build hint target for invalidation checks. */
+    atlasHintTarget?: "auto" | "light" | "normal";
 };
 /**
  * Result of shaping a text cluster into positioned glyphs.

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export { RESTTY_PLUGIN_API_VERSION, Restty, ResttyPaneHandle, createRestty, } fr
 export type { ResttyOptions, ResttyPaneApi, ResttyPluginApiRange, ResttyPlugin, ResttyPluginCleanup, ResttyPluginContext, ResttyPluginDisposable, ResttyPluginEvents, ResttyPluginInfo, ResttyPluginRequires, ResttyInputInterceptor, ResttyInputInterceptorPayload, ResttyInterceptorOptions, ResttyLifecycleHook, ResttyLifecycleHookPayload, ResttyPluginLoadResult, ResttyPluginLoadStatus, ResttyPluginManifestEntry, ResttyPluginRegistry, ResttyPluginRegistryEntry, ResttyRenderHook, ResttyRenderHookPayload, ResttyOutputInterceptor, ResttyOutputInterceptorPayload, ResttyRenderStageHandle, } from "./surface/restty";
 export { getBuiltinTheme, getBuiltinThemeSource, isBuiltinThemeName, listBuiltinThemeNames, parseGhosttyTheme, } from "./theme";
 export type { GhosttyTheme, ResttyBuiltinThemeName } from "./theme";
-export type { ResttyFontSource, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyFontPreset, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, } from "./runtime/types";
+export type { ResttyFontHintTarget, ResttyFontSource, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyFontPreset, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, } from "./runtime/types";

package/dist/input/keymap/pty-map.d.ts

@@ -1,3 +1,4 @@
+export declare function isKittyKeyboardSequence(seq: string): boolean;
 /**
  * Map input sequences to PTY expectations (e.g., DEL vs backspace).
  */

package/dist/internal.d.ts

@@ -15,4 +15,4 @@ export type { GhosttyTheme, ThemeColor, ResttyBuiltinThemeName } from "./theme";
 export { Restty } from "./surface/restty";
 export type { ResttyOptions } from "./surface/restty";
 export type { ResttyManagedAppPane, ResttyPaneDomDefaults, ResttyManagedPaneStyleOptions, ResttyManagedPaneStylesOptions, ResttyPaneAppOptionsInput, } from "./surface/pane-app-manager";
-export type { ResttyFontSource, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, } from "./runtime/types";
+export type { ResttyFontHintTarget, ResttyFontSource, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, } from "./runtime/types";

package/dist/internal.js

@@ -100,7 +100,7 @@ import {
   updateGridState,
   updateImePosition,
   updateSelection
-} from "./chunk-w0c4b651.js";
+} from "./chunk-8bv82tek.js";
 export {
   updateSelection,
   updateImePosition,

package/dist/pty/pty.d.ts

@@ -1,4 +1,4 @@
-import type { PtyCallbacks, PtyConnectionState, PtyConnectOptions, PtyTransport } from "./types";
+import type { PtyCallbacks, PtyConnectionState, PtyConnectOptions, PtyResizeMeta, PtyTransport } from "./types";
 /** Decode a binary WebSocket frame into a UTF-8 string using a streaming TextDecoder. */
 export declare function decodePtyBinary(decoder: TextDecoder, payload: ArrayBuffer | Uint8Array, stream?: boolean): string;
 /** Create a fresh idle PTY connection state. */
@@ -13,7 +13,7 @@ export declare function disconnectPty(state: PtyConnectionState): void;
 /** Send terminal input data to the PTY server. Returns false if the socket is not open. */
 export declare function sendPtyInput(state: PtyConnectionState, data: string): boolean;
 /** Send a resize notification to the PTY server. Returns false if the socket is not open. */
-export declare function sendPtyResize(state: PtyConnectionState, cols: number, rows: number): boolean;
+export declare function sendPtyResize(state: PtyConnectionState, cols: number, rows: number, meta?: PtyResizeMeta): boolean;
 /** Check whether the PTY WebSocket is currently open and connected. */
 export declare function isPtyConnected(state: PtyConnectionState): boolean;
 /** Create a PtyTransport backed by a WebSocket connection. */

package/dist/pty/types.d.ts

@@ -3,14 +3,20 @@
  * - input: terminal keystrokes or pasted text
  * - resize: window size change notification
  */
+export type PtyResizeMeta = {
+    widthPx?: number;
+    heightPx?: number;
+    cellW?: number;
+    cellH?: number;
+};
 export type PtyMessage = {
     type: "input";
     data: string;
-} | {
+} | ({
     type: "resize";
     cols: number;
     rows: number;
-};
+} & PtyResizeMeta);
 /** Server notification that the PTY session is ready, with the active shell name. */
 export type PtyStatusMessage = {
     type: "status";
@@ -93,7 +99,7 @@ export type PtyTransport = {
     /** Send terminal input data; returns true if the data was sent. */
     sendInput: (data: string) => boolean;
     /** Notify the PTY of a terminal resize; returns true if the message was sent. */
-    resize: (cols: number, rows: number) => boolean;
+    resize: (cols: number, rows: number, meta?: PtyResizeMeta) => boolean;
     /** Whether the transport currently has an active connection. */
     isConnected: () => boolean;
     /** Release all resources held by the transport. */

package/dist/restty.js

@@ -8,7 +8,7 @@ import {
   isBuiltinThemeName,
   listBuiltinThemeNames,
   parseGhosttyTheme
-} from "./chunk-w0c4b651.js";
+} from "./chunk-8bv82tek.js";
 export {
   parseGhosttyTheme,
   listBuiltinThemeNames,

package/dist/runtime/atlas-builder.d.ts

@@ -58,6 +58,7 @@ type BuildGlyphAtlasWithConstraintsOptions = {
     maxHeight: number;
     pixelMode: number;
     hinting: boolean;
+    hintTarget?: AtlasOptions["hintTarget"];
     rasterizeGlyph?: RasterizeGlyphFn;
     rasterizeGlyphWithTransform?: RasterizeGlyphWithTransformFn;
     glyphMeta?: Map<number, GlyphConstraintMeta>;
@@ -99,6 +100,8 @@ type BuildAtlasDeps = {
     } | null;
     rasterizeGlyph?: RasterizeGlyphFn;
     rasterizeGlyphWithTransform?: RasterizeGlyphWithTransformFn;
+    hinting: boolean;
+    hintTarget?: AtlasOptions["hintTarget"];
     nerdConstraintSignature: (glyphMeta: Map<number, GlyphConstraintMeta> | undefined, constraintContext: AtlasConstraintContext | null | undefined) => string;
     constants: {
         atlasPadding: number;

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

@@ -3,7 +3,7 @@ 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, ResizeStateRef } from "./font-runtime-helpers.types";
+import type { CellMetrics, FontConfigRef, GridStateRef } from "./font-runtime-helpers.types";
 type CreateFontRuntimeGridHelpersOptions = {
     fontState: FontManagerState;
     fontConfig: FontConfigRef;
@@ -19,10 +19,6 @@ type CreateFontRuntimeGridHelpersOptions = {
     getWasmHandle: () => number;
     ptyTransport: PtyTransport;
     setNeedsRender: () => void;
-    resizeState: ResizeStateRef;
-    resizeActiveMs: number;
-    resizeCommitDebounceMs: number;
-    onSyncKittyOverlaySize: () => void;
     shapeClusterWithFont: (entry: FontEntry, text: string) => {
         advance: number;
     };
@@ -30,10 +26,5 @@ type CreateFontRuntimeGridHelpersOptions = {
 export declare function createFontRuntimeGridHelpers(options: CreateFontRuntimeGridHelpersOptions): {
     computeCellMetrics: () => CellMetrics | null;
     updateGrid: () => void;
-    flushPendingTerminalResize: () => void;
-    scheduleTerminalResizeCommit: (cols: number, rows: number, options?: {
-        immediate?: boolean;
-    }) => void;
-    resetTerminalResizeScheduler: () => void;
 };
 export {};

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

@@ -4,11 +4,6 @@ export declare function createRuntimeFontRuntimeHelpers(options: CreateRuntimeFo
     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;
-    flushPendingTerminalResize: () => void;
-    scheduleTerminalResizeCommit: (cols: number, rows: number, options?: {
-        immediate?: boolean;
-    }) => void;
-    resetTerminalResizeScheduler: () => void;
     shapeClusterWithFont: (entry: import("../../fonts").FontEntry, text: string) => import("../../fonts").ShapedCluster;
     noteColorGlyphText: (entry: import("../../fonts").FontEntry, text: string, shaped: {
         glyphs: Array<{

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

@@ -2,7 +2,7 @@ import type { Font, FontAtlas, FontEntry, FontManagerState, FontSizeMode, Shaped
 import type { WebGLState, WebGPUState } from "../../renderer";
 import type { PtyTransport } from "../../pty";
 import type { ResttyWasm } from "../../wasm";
-import type { ResttyAppCallbacks } from "../types";
+import type { ResttyAppCallbacks, ResttyFontHintTarget } from "../types";
 import type { AtlasOptions, GlyphBuffer, GlyphRasterizeOptions, Matrix2D, Matrix3x3, RasterizedGlyph, UnicodeBuffer } from "text-shaper";
 export type GridStateRef = {
     cols: number;
@@ -18,9 +18,6 @@ export type GridStateRef = {
 export type FontConfigRef = {
     sizePx: number;
 };
-export type ResizeStateRef = {
-    lastAt: number;
-};
 export type ShapeClusterResult = {
     glyphs: ShapedGlyph[];
     advance: number;
@@ -72,10 +69,8 @@ export type CreateRuntimeFontRuntimeHelpersOptions = {
     getWasmHandle: () => number;
     ptyTransport: PtyTransport;
     setNeedsRender: () => void;
-    resizeState: ResizeStateRef;
-    resizeActiveMs: number;
-    resizeCommitDebounceMs: number;
-    onSyncKittyOverlaySize: () => void;
+    getFontHinting: () => boolean;
+    getFontHintTarget: () => ResttyFontHintTarget;
     fontScaleOverrides: Array<{
         match: RegExp;
         scale: number;

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

@@ -1,9 +1,12 @@
 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;

package/dist/runtime/create-runtime/interaction-runtime/kitty-image-cache.d.ts

@@ -1,9 +1,10 @@
 import type { KittyPlacement, ResttyWasm } from "../../../wasm";
-type KittyDecodedImage = {
+export type KittyDecodedImage = {
     key: string;
     width: number;
     height: number;
     source: CanvasImageSource;
+    pixels?: Uint8Array;
 };
 export type KittyImageCache = {
     resolveKittyImage: (placement: KittyPlacement) => KittyDecodedImage | null;
@@ -15,4 +16,3 @@ export type CreateKittyImageCacheOptions = {
     markNeedsRender: () => void;
 };
 export declare function createKittyImageCache(options: CreateKittyImageCacheOptions): KittyImageCache;
-export {};

package/dist/runtime/create-runtime/interaction-runtime/types.d.ts

@@ -1,6 +1,6 @@
 import type { InputHandler } from "../../../input";
 import type { createSelectionState } from "../../../selection";
-import type { KittyPlacement, RenderState, ResttyWasm, ResttyWasmExports } from "../../../wasm";
+import type { RenderState, ResttyWasm, ResttyWasmExports } from "../../../wasm";
 export type RuntimeCell = {
     row: number;
     col: number;
@@ -64,7 +64,6 @@ export type CreateRuntimeInteractionOptions = {
     touchSelectionLongPressMs: number;
     touchSelectionMoveThresholdPx: number;
     showOverlayScrollbar: boolean;
-    kittyOverlayDebugEnabled: boolean;
     imeInput: HTMLTextAreaElement | null;
     cleanupCanvasFns: Array<() => void>;
     getCanvas: () => HTMLCanvasElement;
@@ -84,9 +83,7 @@ export type RuntimeInteraction = {
     scrollbarState: RuntimeScrollbarState;
     imeState: RuntimeImeState;
     updateCanvasCursor: () => void;
-    syncKittyOverlaySize: () => void;
-    clearKittyOverlay: () => void;
-    drawKittyOverlay: (placements: KittyPlacement[], cellW: number, cellH: number) => void;
+    updateLinkHover: (cell: RuntimeCell | null) => void;
     positionToCell: (event: {
         clientX: number;
         clientY: number;
@@ -105,6 +102,4 @@ export type RuntimeInteraction = {
     } | null | undefined, cellW: number, cellH: number) => void;
     appendOverlayScrollbar: (overlayData: number[], total: number, offset: number, len: number) => void;
     bindCanvasEvents: (bindOptions: BindCanvasEventsOptions) => void;
-    detachKittyOverlayCanvas: () => void;
-    clearKittyImageCache: () => void;
 };

package/dist/runtime/create-runtime/kitty-overlay-utils.d.ts

@@ -8,19 +8,9 @@ export type KittySlice = {
     sy: number;
     sw: number;
     sh: number;
-    rawSw: number;
-    rawSh: number;
     dx: number;
     dy: number;
     dw: number;
     dh: number;
 };
-export declare function kittyHashInt(hash: number, value: number): number;
-export declare function kittyHashString(hash: number, value: string): number;
 export declare function toKittySlice(placement: KittyPlacement, decoded: KittyDecodedImageLike, cellW: number, cellH: number): KittySlice | null;
-export declare function computeKittyPartialVirtualFallback(placements: KittyPlacement[], slices: KittySlice[], decoded: KittyDecodedImageLike, cellW: number, cellH: number): {
-    dx: number;
-    dy: number;
-    dw: number;
-    dh: number;
-} | null;

package/dist/runtime/create-runtime/kitty-render-runtime.d.ts

@@ -0,0 +1,36 @@
+import type { WebGPUState } from "../../renderer";
+import type { KittyPlacement, ResttyWasm } from "../../wasm";
+export type KittyDrawSlice = {
+    imageId: number;
+    key: string;
+    source: CanvasImageSource;
+    pixels?: Uint8Array;
+    imageWidth: number;
+    imageHeight: number;
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+    dx: number;
+    dy: number;
+    dw: number;
+    dh: number;
+    z: number;
+};
+export type KittyDrawPlan = {
+    underlay: KittyDrawSlice[];
+    overlay: KittyDrawSlice[];
+};
+type CreateKittyRenderRuntimeOptions = {
+    getWasm: () => ResttyWasm | null;
+    markNeedsRender: () => void;
+};
+export declare function createKittyRenderRuntime(options: CreateKittyRenderRuntimeOptions): {
+    collectKittyDrawPlan: (placements: KittyPlacement[], cellW: number, cellH: number) => KittyDrawPlan;
+    resolveKittyWebGLTexture: (gl: WebGL2RenderingContext, slice: KittyDrawSlice) => WebGLTexture | null;
+    resolveKittyWebGPUBindGroup: (state: WebGPUState, slice: KittyDrawSlice, nearest?: boolean) => GPUBindGroup | null;
+    clearWebGLKittyTextures: () => void;
+    clearWebGPUKittyTextures: () => void;
+    clearKittyRenderCaches: () => void;
+};
+export {};

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

@@ -70,15 +70,11 @@ export type LifecycleThemeSizeDeps = {
         cellH: number;
     } | null;
     updateGrid: () => void;
-    syncKittyOverlaySize: () => void;
-    scheduleTerminalResizeCommit: (cols: number, rows: number, options?: {
-        immediate?: boolean;
-    }) => void;
+    clearKittyRenderCaches: () => void;
     sendKeyInput: (text: string, source?: string) => void;
     clearWebGLShaderStages: (state?: WebGLState) => void;
     destroyWebGLStageTargets: (state?: WebGLState) => void;
     destroyWebGPUStageTargets: () => void;
-    detachKittyOverlayCanvas: () => void;
     setShaderStagesDirty: (value: boolean) => void;
     markNeedsRender: () => void;
     resetLastRenderTime: () => void;

package/dist/runtime/create-runtime/pty-input-runtime.d.ts

@@ -1,5 +1,5 @@
 import type { InputHandler } from "../../input";
-import type { PtyTransport } from "../../pty";
+import type { PtyResizeMeta, PtyTransport } from "../../pty";
 import type { PtyOutputBufferController } from "../pty-output-buffer";
 type CursorPosition = {
     row: number;
@@ -21,6 +21,7 @@ export type CreatePtyInputRuntimeOptions = {
         cols: number;
         rows: number;
     };
+    getResizeMeta?: () => PtyResizeMeta | null;
     getCursorForCpr: () => CursorPosition;
     sendInput: SendInput;
     runBeforeInputHook: (text: string, source: string) => string | null;

package/dist/runtime/create-runtime/render-tick-webgl.types.d.ts

@@ -17,7 +17,6 @@ export type WebGLTickDeps = SharedTickDeps & {
     reportDebugText: (text: string) => void;
     updateGrid: () => void;
     getRenderState: () => RenderState | null;
-    clearKittyOverlay: () => void;
     resolveBlendFlags: (alphaMode: AlphaBlendingMode, backend: "webgl2") => {
         useLinearBlending: boolean;
         useLinearCorrection: boolean;

package/dist/runtime/create-runtime/render-tick-webgpu.types.d.ts

@@ -4,6 +4,8 @@ import type { Color, WebGPUState } from "../../renderer";
 import type { CompiledWebGPUShaderStage, WebGPUStageTargets } from "../create-app-types";
 import type { GlyphConstraintMeta } from "../atlas-builder";
 import type { KittyPlacement, RenderState, ResttyWasm, ResttyWasmExports } from "../../wasm";
+import type { KittyDrawPlan, KittyDrawSlice } from "./kitty-render-runtime";
+import type { ResttyFontHintTarget } from "../types";
 export type CursorPosition = {
     col: number;
     row: number;
@@ -97,6 +99,8 @@ export type SharedTickDeps = {
         match: RegExp;
         scale: number;
     }>;
+    getFontHinting: () => boolean;
+    getFontHintTarget: () => ResttyFontHintTarget;
     isSymbolFont: (entry: FontEntry) => boolean;
     isColorEmojiFont: (entry: FontEntry) => boolean;
     fontAdvanceUnits: (entry: FontEntry, shapeClusterWithFont: (entry: FontEntry, text: string) => ShapedCluster) => number;
@@ -198,7 +202,9 @@ export type SharedTickDeps = {
     ensureInstanceBuffer: (state: WebGPUState, kind: "rect" | "glyph", minBytes: number) => void;
     GLYPH_INSTANCE_FLOATS: number;
     wasm: ResttyWasm | null;
-    drawKittyOverlay: (placements: KittyPlacement[], cellW: number, cellH: number) => void;
+    collectKittyDrawPlan: (placements: KittyPlacement[], cellW: number, cellH: number) => KittyDrawPlan;
+    resolveKittyWebGLTexture: (gl: WebGL2RenderingContext, slice: KittyDrawSlice) => WebGLTexture | null;
+    resolveKittyWebGPUBindGroup: (state: WebGPUState, slice: KittyDrawSlice, nearest?: boolean) => GPUBindGroup | null;
     isAppleSymbolsFont: (entry: FontEntry) => boolean;
     DEFAULT_APPLE_SYMBOLS_CONSTRAINT: NerdConstraint;
     DEFAULT_SYMBOL_CONSTRAINT: NerdConstraint;
@@ -243,7 +249,6 @@ export type RuntimeTickDeps = SharedTickDeps & {
     reportDebugText: (text: string) => void;
     updateGrid: () => void;
     getRenderState: () => RenderState | null;
-    clearKittyOverlay: () => void;
     resolveBlendFlags: (alphaMode: string, backend: "webgpu", state: WebGPUState) => {
         useLinearBlending: boolean;
         useLinearCorrection: boolean;

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

@@ -25,6 +25,8 @@ type RuntimeSendInput = (text: string, source?: string, options?: {
 }) => void;
 type RuntimePublicApiOptions = {
     setFontSize: ResttyApp["setFontSize"];
+    setFontHinting: ResttyApp["setFontHinting"];
+    setFontHintTarget: ResttyApp["setFontHintTarget"];
     setFontSources: ResttyApp["setFontSources"];
     resetTheme: ResttyApp["resetTheme"];
     dumpAtlasForCodepoint: ResttyApp["dumpAtlasForCodepoint"];
@@ -78,7 +80,6 @@ type CreateRuntimeAppApiOptions = {
     resizeState: {
         lastAt: number;
     };
-    flushPendingTerminalResize: () => void;
     tickWebGPU: (state: WebGPUState) => void;
     tickWebGL: (state: WebGLState) => void;
     updateGrid: () => void;
@@ -99,7 +100,6 @@ type CreateRuntimeAppApiOptions = {
     destroyWebGPUStageTargets: () => void;
     clearWebGLShaderStages: (state?: WebGLState) => void;
     destroyWebGLStageTargets: (state?: WebGLState) => void;
-    resetTerminalResizeScheduler: () => void;
 };
 export declare function createRuntimeAppApi(options: CreateRuntimeAppApiOptions): RuntimeAppApiRuntime;
 export {};

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

@@ -2,6 +2,6 @@ import type { ResttyApp, ResttyAppOptions } from "./types";
 export { createResttyAppSession, getDefaultResttyAppSession } from "./session";
 export { createResttyPaneManager } from "../surface/panes/manager";
 export { createDefaultResttyPaneContextMenuItems, getResttyShortcutModifierLabel, } from "../surface/panes/default-context-menu-items";
-export type { ResttyAppElements, ResttyAppCallbacks, FontSource, ResttyFontSource, ResttyTouchSelectionMode, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyWasmLogListener, ResttyAppSession, ResttyAppInputPayload, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, ResttyAppOptions, ResttyApp, } from "./types";
+export type { ResttyAppElements, ResttyAppCallbacks, FontSource, ResttyFontHintTarget, ResttyFontSource, ResttyTouchSelectionMode, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyWasmLogListener, ResttyAppSession, ResttyAppInputPayload, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, ResttyAppOptions, ResttyApp, } from "./types";
 export type { ResttyPaneSplitDirection, ResttyPaneContextMenuItem, ResttyPaneDefinition, ResttyPaneStyleOptions, ResttyPaneStylesOptions, ResttyPaneShortcutsOptions, ResttyPaneContextMenuOptions, CreateResttyPaneManagerOptions, ResttyPaneManager, ResttyPaneWithApp, CreateDefaultResttyPaneContextMenuItemsOptions, } from "../surface/panes-types";
 export declare function createResttyApp(options: ResttyAppOptions): ResttyApp;

package/dist/runtime/font-atlas-utils/glyph-atlas-builder.d.ts

@@ -17,6 +17,7 @@ export type BuildGlyphAtlasWithConstraintsOptions = {
     maxHeight: number;
     pixelMode: number;
     hinting: boolean;
+    hintTarget?: GlyphRasterizeOptions["hintTarget"];
     rasterizeGlyph?: RasterizeGlyphFn;
     rasterizeGlyphWithTransform?: RasterizeGlyphWithTransformFn;
     glyphMeta?: Map<number, GlyphConstraintMeta>;

package/dist/runtime/font-resource-store.d.ts

@@ -0,0 +1,21 @@
+import type { ResttyFontResourceFace, ResttyFontResourceStore, ResttyFontSource } from "./types";
+type ParsedFontFace = {
+    font: ResttyFontResourceFace["font"];
+    metadataLabel?: string;
+    index?: number;
+};
+export type CreateResttyFontResourceStoreOptions = {
+    now?: () => number;
+    /** Max in-memory source-byte cache budget across unleased and leased entries. */
+    maxSourceCacheBytes?: number;
+    /** TTL for persistent URL-byte cache records. */
+    urlCacheTtlMs?: number;
+    /** Toggle persistent URL-byte cache (IndexedDB). */
+    usePersistentUrlCache?: boolean;
+    /** Override source loading (used by tests/mocks). */
+    loadSourceBuffer?: (source: ResttyFontSource, sourceKey: string) => Promise<ArrayBuffer | null>;
+    /** Override parse step (used by tests/mocks). */
+    parseBuffer?: (buffer: ArrayBuffer, sourceKey: string) => Promise<ParsedFontFace[]>;
+};
+export declare function createResttyFontResourceStore(options?: CreateResttyFontResourceStoreOptions): ResttyFontResourceStore;
+export {};

package/dist/runtime/types.d.ts

@@ -3,8 +3,28 @@ import type { PtyTransport } from "../pty";
 import type { WebGPUCoreState } from "../renderer";
 import type { GhosttyTheme } from "../theme";
 import type { ResttyWasm } from "../wasm";
+import type { Font as TextShaperFont } from "text-shaper";
 /** Callback for WASM log messages. */
 export type ResttyWasmLogListener = (message: string) => void;
+/** Shared parsed font face reused across panes within a session. */
+export type ResttyFontResourceFace = {
+    /** Human-readable label for debug/log output. */
+    label: string;
+    /** Parsed text-shaper font instance. */
+    font: TextShaperFont;
+};
+/** Lease handle returned by the shared font resource store. */
+export type ResttyFontResourceLease = {
+    /** Ordered parsed faces (primary + fallbacks). */
+    faces: ResttyFontResourceFace[];
+    /** Release the lease when pane/runtime no longer needs the faces. */
+    release: () => void;
+};
+/** Session-level font resource store for deduped loading/parsing and caching. */
+export type ResttyFontResourceStore = {
+    /** Acquire parsed faces for a source list. */
+    acquire: (sources: ResttyFontSource[]) => Promise<ResttyFontResourceLease>;
+};
 /**
  * Session provider that supplies shared WASM and WebGPU resources.
  */
@@ -13,6 +33,8 @@ export type ResttyAppSession = {
     getWasm: () => Promise<ResttyWasm>;
     /** Lazily initialize and return the WebGPU renderer core for a canvas. */
     getWebGPUCore: (canvas: HTMLCanvasElement) => Promise<WebGPUCoreState | null>;
+    /** Return the shared font resource store for this session/tab. */
+    getFontResourceStore?: () => ResttyFontResourceStore;
     /** Subscribe to WASM log output. */
     addWasmLogListener?: (listener: ResttyWasmLogListener) => void;
     /** Unsubscribe from WASM log output. */
@@ -138,6 +160,8 @@ export type ResttyFontPreset = "default-cdn" | "none";
  * - off: disable touch selection entirely
  */
 export type ResttyTouchSelectionMode = "drag" | "long-press" | "off";
+/** Hinting target mode used when TrueType hinting is enabled. */
+export type ResttyFontHintTarget = "auto" | "light" | "normal";
 /** Input payload passed to ResttyApp before-input hooks. */
 export type ResttyAppInputPayload = {
     text: string;
@@ -191,6 +215,15 @@ export type ResttyAppOptions = {
     renderer?: "auto" | "webgpu" | "webgl2";
     /** Font size in CSS pixels. */
     fontSize?: number;
+    /** Enable TrueType hinting during atlas rasterization (default false). */
+    fontHinting?: boolean;
+    /**
+     * Hinting target mode passed to text-shaper when hinting is enabled.
+     * - auto: infer from pixel mode
+     * - light: prefer light/subpixel-like vertical hinting
+     * - normal: prefer full hinting
+     */
+    fontHintTarget?: ResttyFontHintTarget;
     /**
      * Font sizing mode used by text-shaper scale resolution.
      * - em: interpret fontSize as EM size
@@ -283,6 +316,10 @@ export type ResttyApp = {
     togglePause: () => void;
     /** Update the terminal font size in CSS pixels. */
     setFontSize: (value: number) => void;
+    /** Enable or disable TrueType hinting for atlas glyph rasterization. */
+    setFontHinting: (value: boolean) => void;
+    /** Update hinting target mode used when hinting is enabled. */
+    setFontHintTarget: (value: ResttyFontHintTarget) => void;
     /** Replace the active font sources and reload fonts. */
     setFontSources: (sources: ResttyFontSource[]) => Promise<void>;
     /** Apply a Ghostty color theme. */