@hex1b/web-terminal 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,312 @@
+/** Logical terminal dimensions, confirmed by the producer rather than reflowed locally. */
+export interface TerminalGrid {
+    columns: number;
+    rows: number;
+}
+export interface TerminalSize {
+    width: number;
+    height: number;
+}
+export interface TerminalPoint {
+    x: number;
+    y: number;
+}
+export type MouseTrackingMode = 0 | 9 | 1000 | 1002 | 1003;
+export interface TerminalGeometry extends TerminalGrid {
+    cellWidth: number;
+    cellHeight: number;
+    mouseTracking: MouseTrackingMode;
+}
+export interface TerminalPeer {
+    id: string | null;
+    primaryId: string | null;
+    isPrimary: boolean;
+}
+/** Font size is an integer from 8 to 32; fixed grids allow 20–300 columns and 10–100 rows. */
+export type TerminalSizing = {
+    mode: "auto";
+    fontSize?: number;
+} | {
+    mode: "fixed";
+    fontSize?: number;
+    columns: number;
+    rows: number;
+};
+export type TerminalSizingState = {
+    mode: "auto";
+    fontSize: number;
+} | {
+    mode: "fixed";
+    fontSize: number;
+    columns: number;
+    rows: number;
+};
+export interface TerminalFontFace {
+    url: string;
+    weight?: string;
+    style?: string;
+}
+/** Without faces, a non-generic family must be installed locally in the worker's environment. */
+export interface TerminalFont {
+    family: string;
+    faces?: readonly TerminalFontFace[];
+}
+export type TerminalBuffer = "main" | "alternate";
+export type SelectionMode = "character" | "word" | "line" | "rectangle";
+export interface SelectionRange {
+    row: number;
+    startColumn: number;
+    endColumn: number;
+}
+export type TerminalViewport = ({
+    available: true;
+    generation: string;
+    buffer: TerminalBuffer;
+    totalRows: number;
+    liveTop: number;
+    top: number;
+    requestId: number;
+    rowIds: readonly string[];
+    revision: number;
+} | {
+    available: false;
+    generation?: undefined;
+    buffer?: undefined;
+    totalRows?: undefined;
+    liveTop?: undefined;
+    top?: undefined;
+    requestId?: undefined;
+    rowIds?: readonly string[];
+    revision?: undefined;
+}) & {
+    following: boolean;
+    pending: boolean;
+    followTail: boolean;
+    offset: number;
+};
+export type TerminalSelection = ({
+    status: "valid";
+    text: string;
+    requestId: number;
+    revision: number;
+} | {
+    status: "none" | "invalidated";
+    text: null;
+    requestId: number;
+    revision: number;
+} | {
+    status: "pending";
+    text: null;
+    requestId: number;
+    revision?: undefined;
+} | {
+    status: "unavailable";
+    text: null;
+    requestId?: undefined;
+    revision?: undefined;
+}) & {
+    mode: SelectionMode;
+    ranges: readonly Readonly<SelectionRange>[];
+    canExtend?: boolean;
+    message: string;
+    active: boolean;
+    pending: boolean;
+    copying: boolean;
+    copyError: string;
+};
+export type TerminalStatusLevel = "info" | "ready" | "error";
+/** Metrics are initially empty; individual fields appear as initialization and presentation proceed. */
+export interface TerminalStats {
+    revision?: number;
+    fullFrames?: number;
+    frames?: number;
+    presentations?: number;
+    changedCells?: number;
+    lastChangedCells?: number;
+    discardedFrames?: number;
+    imageCount?: number;
+    textureBytes?: number;
+    atlasGlyphs?: number;
+    atlasBytes?: number;
+    bytesReceived?: number;
+    imageUploadBytes?: number;
+    imagePayloadBytes?: number;
+    gpu?: "initializing" | "ready" | "error" | "stopped";
+    connected?: boolean;
+    warnings?: readonly string[];
+    fps?: number;
+    receivedKBps?: number;
+    workloadMBps?: number;
+    captureMs?: number;
+    rendererCpuMs?: number;
+    preparationCpuMs?: number;
+    workloadBytes?: number;
+    outputBatches?: number;
+    serverElapsedMs?: number;
+    quads?: number;
+    drawCalls?: number;
+    columns?: number;
+    rows?: number;
+    mouseTracking?: MouseTrackingMode;
+    peer?: TerminalPeer;
+    fontFamily?: string;
+    rasterScale?: number;
+    backingScale?: number;
+    backingWidth?: number;
+    backingHeight?: number;
+    atlasRebuilds?: number;
+    glyphUploadBytes?: number;
+    instanceBufferBytes?: number;
+}
+export interface InputModifiers {
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    meta: boolean;
+}
+export type PointerButton = "left" | "middle" | "right";
+/** Input intents contain no browser event. Returning a route controls browser cancellation. */
+export type TerminalInput = ({
+    type: "key";
+    key: string;
+    code: string;
+    repeat: boolean;
+} & InputModifiers) | ({
+    type: "pointer";
+    button: PointerButton;
+    point: Readonly<TerminalPoint>;
+} & InputModifiers) | ({
+    type: "wheel";
+    deltaX: number;
+    deltaY: number;
+    deltaMode: number;
+    point: Readonly<TerminalPoint> | null;
+} & InputModifiers) | {
+    type: "paste" | "text";
+    text: string;
+};
+export type InputRouteValue = "continue" | "consume" | "application" | "browser";
+export type TerminalActionName = "copySelection" | "pasteClipboard" | "copyOrPaste" | "clearSelection" | "scrollToLive" | "scrollLines";
+export interface CopySelectionOptions {
+    clear?: boolean;
+}
+export interface TerminalInputContext {
+    readonly terminal: WebTerminalHandle;
+    readonly selection: TerminalSelection;
+    readonly viewport: TerminalViewport;
+    readonly buffer: TerminalBuffer | null;
+    readonly mouseCaptured: boolean;
+    readonly historical: boolean;
+    readonly readOnly: boolean;
+    readonly connected: boolean;
+    readonly peer: TerminalPeer;
+}
+/** Custom actions validate their own arguments and may complete asynchronously. */
+export type InputActionHandler = (context: TerminalInputContext, args: unknown, input: Readonly<TerminalInput> | undefined) => unknown;
+export type InputDecision = {
+    route: InputRouteValue;
+    action?: never;
+    args?: never;
+} | {
+    action: string | InputActionHandler;
+    args?: unknown;
+    route?: never;
+};
+export type InputInterceptor = (input: Readonly<TerminalInput>, context: TerminalInputContext) => InputRouteValue | InputDecision | undefined;
+export type InputBinding = {
+    id: string;
+    match: (input: Readonly<TerminalInput>, context: TerminalInputContext) => boolean;
+    when?: (context: TerminalInputContext, input: Readonly<TerminalInput>) => boolean;
+    remove?: false;
+} & InputDecision;
+export type InputBindingOverride = InputBinding | {
+    id: string;
+    remove: true;
+};
+export interface InputPolicyOptions {
+    inputBindings?: readonly InputBindingOverride[];
+    onInput?: InputInterceptor;
+    actions?: Readonly<Record<string, InputActionHandler>>;
+}
+/** Built-ins have typed arguments/results; custom names and callbacks own their argument validation. */
+export interface RunTerminalAction {
+    (action: "copySelection", args?: CopySelectionOptions, input?: TerminalInput): Promise<string>;
+    (action: "pasteClipboard", args?: undefined, input?: TerminalInput): Promise<string>;
+    (action: "copyOrPaste", args?: undefined, input?: TerminalInput): Promise<string | undefined>;
+    (action: "clearSelection" | "scrollToLive", args?: undefined, input?: TerminalInput): Promise<void>;
+    (action: "scrollLines", args: number, input?: TerminalInput): Promise<void>;
+    <Name extends string>(action: Name extends TerminalActionName ? never : Name, args?: unknown, input?: TerminalInput): Promise<unknown>;
+    (action: InputActionHandler, args?: unknown, input?: TerminalInput): Promise<unknown>;
+}
+export interface SelectionRectangle {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface SelectionUIState {
+    readonly selection: Readonly<TerminalSelection>;
+    readonly viewport: Readonly<TerminalViewport>;
+    readonly geometry: Readonly<TerminalGeometry>;
+    readonly canvasSize: Readonly<TerminalSize>;
+    readonly connected: boolean;
+    readonly readOnly: boolean;
+}
+/** A frozen snapshot; preventDefault() synchronously to replace the built-in Copy button. */
+export interface SelectionUIDetail extends SelectionUIState {
+    readonly overlay: HTMLDivElement;
+    readonly signal: AbortSignal;
+    readonly runAction: RunTerminalAction;
+    readonly rects: readonly Readonly<SelectionRectangle>[];
+}
+export type SelectionUIEvent = CustomEvent<SelectionUIDetail>;
+export interface WebTerminalOptions extends InputPolicyOptions {
+    url: string | URL;
+    /** Optional module-worker entry, resolved against the page URL. Defaults to the bundled worker. */
+    workerUrl?: string | URL;
+    signal?: AbortSignal;
+    scale?: number | "auto";
+    font?: TerminalFont;
+    sizing?: TerminalSizing;
+    label?: string;
+    readOnly?: boolean;
+    onStatus?: (message: string, level: TerminalStatusLevel) => void;
+    onGeometry?: (geometry: TerminalGeometry) => void;
+    onSizingChange?: (sizing: TerminalSizingState) => void;
+    onRoleChange?: (peer: TerminalPeer) => void;
+    onStats?: (stats: TerminalStats, text: string | undefined) => void;
+    onViewportChange?: (viewport: TerminalViewport) => void;
+    onSelectionChange?: (selection: TerminalSelection) => void;
+    onInputError?: (error: Error) => void;
+    /** Must return undefined synchronously; async handlers cannot claim default UI ownership. */
+    onSelectionUI?: (event: SelectionUIEvent) => undefined;
+}
+/** Owns only the appended element and browser connection, not the server terminal. */
+export interface WebTerminalHandle {
+    readonly element: HTMLDivElement;
+    readonly geometry: TerminalGeometry;
+    readonly peer: TerminalPeer;
+    readonly connected: boolean;
+    readonly stats: TerminalStats;
+    readonly screenText: string;
+    readonly sizing: TerminalSizingState;
+    readonly inputBindings: InputBinding[];
+    readonly inputContext: TerminalInputContext;
+    readonly viewport: TerminalViewport;
+    readonly selection: TerminalSelection;
+    runAction: RunTerminalAction;
+    scrollLines(delta: number): void;
+    scrollToLive(): void;
+    clearSelection(): void;
+    refreshSelectionUI(): void;
+    copySelection(options?: CopySelectionOptions): Promise<string>;
+    paste(text: string): void;
+    pasteClipboard(): Promise<string>;
+    focus(): void;
+    requestPrimary(): void;
+    resize(columns: number, rows: number): void;
+    setSizing(sizing: TerminalSizing): void;
+    resync(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Logical terminal dimensions, confirmed by the producer rather than reflowed locally. */\nexport interface TerminalGrid { columns: number; rows: number }\nexport interface TerminalSize { width: number; height: number }\nexport interface TerminalPoint { x: number; y: number }\nexport type MouseTrackingMode = 0 | 9 | 1000 | 1002 | 1003;\nexport interface TerminalGeometry extends TerminalGrid {\n  cellWidth: number;\n  cellHeight: number;\n  mouseTracking: MouseTrackingMode;\n}\nexport interface TerminalPeer {\n  id: string | null;\n  primaryId: string | null;\n  isPrimary: boolean;\n}\n/** Font size is an integer from 8 to 32; fixed grids allow 20–300 columns and 10–100 rows. */\nexport type TerminalSizing =\n  | { mode: \"auto\"; fontSize?: number }\n  | { mode: \"fixed\"; fontSize?: number; columns: number; rows: number };\nexport type TerminalSizingState =\n  | { mode: \"auto\"; fontSize: number }\n  | { mode: \"fixed\"; fontSize: number; columns: number; rows: number };\nexport interface TerminalFontFace { url: string; weight?: string; style?: string }\n/** Without faces, a non-generic family must be installed locally in the worker's environment. */\nexport interface TerminalFont { family: string; faces?: readonly TerminalFontFace[] }\nexport type TerminalBuffer = \"main\" | \"alternate\";\nexport type SelectionMode = \"character\" | \"word\" | \"line\" | \"rectangle\";\nexport interface SelectionRange { row: number; startColumn: number; endColumn: number }\nexport type TerminalViewport = (\n  | { available: true; generation: string; buffer: TerminalBuffer; totalRows: number;\n      liveTop: number; top: number; requestId: number; rowIds: readonly string[]; revision: number }\n  | { available: false; generation?: undefined; buffer?: undefined; totalRows?: undefined;\n      liveTop?: undefined; top?: undefined; requestId?: undefined; rowIds?: readonly string[]; revision?: undefined }\n) & { following: boolean; pending: boolean; followTail: boolean; offset: number };\nexport type TerminalSelection = (\n  | { status: \"valid\"; text: string; requestId: number; revision: number }\n  | { status: \"none\" | \"invalidated\"; text: null; requestId: number; revision: number }\n  | { status: \"pending\"; text: null; requestId: number; revision?: undefined }\n  | { status: \"unavailable\"; text: null; requestId?: undefined; revision?: undefined }\n) & {\n  mode: SelectionMode;\n  ranges: readonly Readonly<SelectionRange>[];\n  canExtend?: boolean;\n  message: string;\n  active: boolean;\n  pending: boolean;\n  copying: boolean;\n  copyError: string;\n};\nexport type TerminalStatusLevel = \"info\" | \"ready\" | \"error\";\n/** Metrics are initially empty; individual fields appear as initialization and presentation proceed. */\nexport interface TerminalStats {\n  revision?: number; fullFrames?: number; frames?: number; presentations?: number;\n  changedCells?: number; lastChangedCells?: number; discardedFrames?: number;\n  imageCount?: number; textureBytes?: number; atlasGlyphs?: number; atlasBytes?: number;\n  bytesReceived?: number; imageUploadBytes?: number; imagePayloadBytes?: number;\n  gpu?: \"initializing\" | \"ready\" | \"error\" | \"stopped\"; connected?: boolean; warnings?: readonly string[];\n  fps?: number; receivedKBps?: number; workloadMBps?: number;\n  captureMs?: number; rendererCpuMs?: number; preparationCpuMs?: number;\n  workloadBytes?: number; outputBatches?: number; serverElapsedMs?: number;\n  quads?: number; drawCalls?: number; columns?: number; rows?: number; mouseTracking?: MouseTrackingMode;\n  peer?: TerminalPeer; fontFamily?: string; rasterScale?: number; backingScale?: number;\n  backingWidth?: number; backingHeight?: number; atlasRebuilds?: number;\n  glyphUploadBytes?: number; instanceBufferBytes?: number;\n}\nexport interface InputModifiers { ctrl: boolean; alt: boolean; shift: boolean; meta: boolean }\nexport type PointerButton = \"left\" | \"middle\" | \"right\";\n/** Input intents contain no browser event. Returning a route controls browser cancellation. */\nexport type TerminalInput =\n  | ({ type: \"key\"; key: string; code: string; repeat: boolean } & InputModifiers)\n  | ({ type: \"pointer\"; button: PointerButton; point: Readonly<TerminalPoint> } & InputModifiers)\n  | ({ type: \"wheel\"; deltaX: number; deltaY: number; deltaMode: number;\n       point: Readonly<TerminalPoint> | null } & InputModifiers)\n  | { type: \"paste\" | \"text\"; text: string };\nexport type InputRouteValue = \"continue\" | \"consume\" | \"application\" | \"browser\";\nexport type TerminalActionName = \"copySelection\" | \"pasteClipboard\" | \"copyOrPaste\"\n  | \"clearSelection\" | \"scrollToLive\" | \"scrollLines\";\nexport interface CopySelectionOptions { clear?: boolean }\nexport interface TerminalInputContext {\n  readonly terminal: WebTerminalHandle;\n  readonly selection: TerminalSelection;\n  readonly viewport: TerminalViewport;\n  readonly buffer: TerminalBuffer | null;\n  readonly mouseCaptured: boolean;\n  readonly historical: boolean;\n  readonly readOnly: boolean;\n  readonly connected: boolean;\n  readonly peer: TerminalPeer;\n}\n/** Custom actions validate their own arguments and may complete asynchronously. */\nexport type InputActionHandler =\n  (context: TerminalInputContext, args: unknown, input: Readonly<TerminalInput> | undefined) => unknown;\nexport type InputDecision =\n  | { route: InputRouteValue; action?: never; args?: never }\n  | { action: string | InputActionHandler; args?: unknown; route?: never };\nexport type InputInterceptor =\n  (input: Readonly<TerminalInput>, context: TerminalInputContext) => InputRouteValue | InputDecision | undefined;\nexport type InputBinding = {\n  id: string;\n  match: (input: Readonly<TerminalInput>, context: TerminalInputContext) => boolean;\n  when?: (context: TerminalInputContext, input: Readonly<TerminalInput>) => boolean;\n  remove?: false;\n} & InputDecision;\nexport type InputBindingOverride = InputBinding | { id: string; remove: true };\nexport interface InputPolicyOptions {\n  inputBindings?: readonly InputBindingOverride[];\n  onInput?: InputInterceptor;\n  actions?: Readonly<Record<string, InputActionHandler>>;\n}\n/** Built-ins have typed arguments/results; custom names and callbacks own their argument validation. */\nexport interface RunTerminalAction {\n  (action: \"copySelection\", args?: CopySelectionOptions, input?: TerminalInput): Promise<string>;\n  (action: \"pasteClipboard\", args?: undefined, input?: TerminalInput): Promise<string>;\n  (action: \"copyOrPaste\", args?: undefined, input?: TerminalInput): Promise<string | undefined>;\n  (action: \"clearSelection\" | \"scrollToLive\", args?: undefined, input?: TerminalInput): Promise<void>;\n  (action: \"scrollLines\", args: number, input?: TerminalInput): Promise<void>;\n  <Name extends string>(action: Name extends TerminalActionName ? never : Name,\n    args?: unknown, input?: TerminalInput): Promise<unknown>;\n  (action: InputActionHandler, args?: unknown, input?: TerminalInput): Promise<unknown>;\n}\nexport interface SelectionRectangle { left: number; top: number; width: number; height: number }\nexport interface SelectionUIState {\n  readonly selection: Readonly<TerminalSelection>;\n  readonly viewport: Readonly<TerminalViewport>;\n  readonly geometry: Readonly<TerminalGeometry>;\n  readonly canvasSize: Readonly<TerminalSize>;\n  readonly connected: boolean;\n  readonly readOnly: boolean;\n}\n/** A frozen snapshot; preventDefault() synchronously to replace the built-in Copy button. */\nexport interface SelectionUIDetail extends SelectionUIState {\n  readonly overlay: HTMLDivElement;\n  readonly signal: AbortSignal;\n  readonly runAction: RunTerminalAction;\n  readonly rects: readonly Readonly<SelectionRectangle>[];\n}\nexport type SelectionUIEvent = CustomEvent<SelectionUIDetail>;\nexport interface WebTerminalOptions extends InputPolicyOptions {\n  url: string | URL;\n  /** Optional module-worker entry, resolved against the page URL. Defaults to the bundled worker. */\n  workerUrl?: string | URL;\n  signal?: AbortSignal;\n  scale?: number | \"auto\";\n  font?: TerminalFont;\n  sizing?: TerminalSizing;\n  label?: string;\n  readOnly?: boolean;\n  onStatus?: (message: string, level: TerminalStatusLevel) => void;\n  onGeometry?: (geometry: TerminalGeometry) => void;\n  onSizingChange?: (sizing: TerminalSizingState) => void;\n  onRoleChange?: (peer: TerminalPeer) => void;\n  onStats?: (stats: TerminalStats, text: string | undefined) => void;\n  onViewportChange?: (viewport: TerminalViewport) => void;\n  onSelectionChange?: (selection: TerminalSelection) => void;\n  onInputError?: (error: Error) => void;\n  /** Must return undefined synchronously; async handlers cannot claim default UI ownership. */\n  onSelectionUI?: (event: SelectionUIEvent) => undefined;\n}\n/** Owns only the appended element and browser connection, not the server terminal. */\nexport interface WebTerminalHandle {\n  readonly element: HTMLDivElement;\n  readonly geometry: TerminalGeometry;\n  readonly peer: TerminalPeer;\n  readonly connected: boolean;\n  readonly stats: TerminalStats;\n  readonly screenText: string;\n  readonly sizing: TerminalSizingState;\n  readonly inputBindings: InputBinding[];\n  readonly inputContext: TerminalInputContext;\n  readonly viewport: TerminalViewport;\n  readonly selection: TerminalSelection;\n  runAction: RunTerminalAction;\n  scrollLines(delta: number): void;\n  scrollToLive(): void;\n  clearSelection(): void;\n  refreshSelectionUI(): void;\n  copySelection(options?: CopySelectionOptions): Promise<string>;\n  paste(text: string): void;\n  pasteClipboard(): Promise<string>;\n  focus(): void;\n  requestPrimary(): void;\n  resize(columns: number, rows: number): void;\n  setSizing(sizing: TerminalSizing): void;\n  resync(): void;\n  dispose(): void;\n}\n"]}

package/dist/validation.d.ts

@@ -0,0 +1,3 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/validation.js

@@ -0,0 +1,7 @@
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function errorMessage(error) {
+    return isRecord(error) && typeof error.message === "string" ? error.message : String(error);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC","sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function errorMessage(error: unknown): string {\n  return isRecord(error) && typeof error.message === \"string\" ? error.message : String(error);\n}\n"]}

package/dist/web-terminal.d.ts

@@ -0,0 +1,51 @@
+import type { CopySelectionOptions, InputActionHandler, InputBinding, TerminalActionName, TerminalGeometry, TerminalInput, TerminalInputContext, TerminalPeer, TerminalSelection, TerminalSizing, TerminalSizingState, TerminalStats, TerminalViewport, WebTerminalHandle, WebTerminalOptions } from "./types.js";
+export { InputRoute, TerminalAction, defaultInputBindings } from "./input-policy.js";
+/**
+ * First-party HWT1 client. Owns only the element it appends, not the caller's
+ * container or the server terminal. The HWT1 wire and this spike API evolve together.
+ */
+export declare class WebTerminal implements WebTerminalHandle {
+    #private;
+    readonly element: HTMLDivElement;
+    /** Resolves after a connected terminal frame is presented. Supply signal to cancel mounting. */
+    static mount(container: HTMLElement, options: WebTerminalOptions): Promise<WebTerminal>;
+    private constructor();
+    get geometry(): TerminalGeometry;
+    get peer(): TerminalPeer;
+    get connected(): boolean;
+    get stats(): TerminalStats;
+    get screenText(): string;
+    get sizing(): TerminalSizingState;
+    get inputBindings(): InputBinding[];
+    get viewport(): TerminalViewport;
+    get selection(): TerminalSelection;
+    scrollLines(delta: number): void;
+    scrollToLive(): void;
+    clearSelection(): void;
+    /** Re-notifies selection UI hosts after an external styling/policy change. */
+    refreshSelectionUI(): void;
+    copySelection({ clear }?: CopySelectionOptions): Promise<string>;
+    get inputContext(): TerminalInputContext;
+    /** Named actions are shared by controls and bindings. Custom callbacks receive context, args, and input. */
+    runAction(action: "copySelection", args?: CopySelectionOptions, input?: TerminalInput): Promise<string>;
+    runAction(action: "pasteClipboard", args?: undefined, input?: TerminalInput): Promise<string>;
+    runAction(action: "copyOrPaste", args?: undefined, input?: TerminalInput): Promise<string | undefined>;
+    runAction(action: "clearSelection" | "scrollToLive", args?: undefined, input?: TerminalInput): Promise<void>;
+    runAction(action: "scrollLines", args: number, input?: TerminalInput): Promise<void>;
+    runAction<Name extends string>(action: Name extends TerminalActionName ? never : Name, args?: unknown, input?: TerminalInput): Promise<unknown>;
+    runAction(action: InputActionHandler, args?: unknown, input?: TerminalInput): Promise<unknown>;
+    /** Sends an explicit paste through the producer's mode-aware input encoder. */
+    paste(text: string): void;
+    pasteClipboard(): Promise<string>;
+    focus(): void;
+    /** Request HMP1 primary explicitly; peer notifications confirm the result. */
+    requestPrimary(): void;
+    /** Request a grid; never reflow locally before the authoritative response. */
+    resize(columns: number, rows: number): void;
+    /** Change the primary's sizing policy; applied grid dimensions still come from the server. */
+    setSizing(sizing: TerminalSizing): void;
+    resync(): void;
+    /** Detach this view. The server-side shared terminal is not terminated. */
+    dispose(): void;
+}
+//# sourceMappingURL=web-terminal.d.ts.map

package/dist/web-terminal.d.ts.map

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