@hex1b/web-terminal 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mitch Denny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,243 @@
+# @hex1b/web-terminal
+
+The first-party WebGPU browser terminal for Hex1b. It renders server-authoritative
+cells and graphics in a module worker, with local input routing, producer-backed
+history and selection, clipboard actions, and primary/secondary view sizing.
+There are no runtime package dependencies.
+
+**Experimental and paired with Hex1b:** this client speaks the evolving HWT1
+transport implemented by the matching Hex1b server. HWT1 and internal browser
+modules are not a supported third-party protocol or renderer API. The bootstrap
+npm version `0.1.0` must be paired with the server build from the **same
+implementation commit**; it is not compatible merely by version number with the
+historical Hex1b NuGet `0.1.0`. Subsequent normal CI releases coordinate npm and
+NuGet versions; use matching builds from the same release.
+
+## Install and mount
+
+```sh
+npm install @hex1b/web-terminal
+```
+
+Give the container a nonzero width and height. Mount resolves after a connected
+frame has been presented, or rejects on initialization failure or a 30-second
+first-frame timeout.
+
+```html
+<div id="terminal" style="width: 100%; height: 480px"></div>
+```
+
+```ts
+import { WebTerminal } from "@hex1b/web-terminal";
+
+const container = document.getElementById("terminal");
+if (!container) throw new Error("Missing terminal container");
+
+const terminal = await WebTerminal.mount(container, {
+  url: "/ws/terminal", // Your matching Hex1b HWT1 WebSocket endpoint.
+  sizing: { mode: "auto", fontSize: 16 },
+  onStatus(message, level) {
+    console.log(level, message);
+  }
+});
+
+terminal.focus();
+// On component teardown:
+// terminal.dispose();
+```
+
+`url` accepts a string or URL; relative URLs resolve against the page, and
+`http:`/`https:` become `ws:`/`wss:`. An optional `AbortSignal` cancels mounting
+or disposes a mounted view. Disposal removes only the appended element and its
+connection, not the container or server-side shared terminal.
+
+### Browser and deployment requirements
+
+Use HTTPS or localhost and a browser with WebGPU, module workers, transferable
+OffscreenCanvas, worker animation frames, ResizeObserver, and CSS Font Loading.
+Clipboard access also requires browser permission and, for relevant actions, a
+user gesture. There is no Canvas2D terminal-rendering fallback.
+
+The package contains browser ES modules, not a single bundle. For bare static
+hosting, copy **all of `dist/`**, preserving its directory structure, and import
+`/web-terminal/index.js` from a module script. `dist/web-terminal.js` also remains
+available for relative static imports. Package consumers should import only from
+`@hex1b/web-terminal`; internal protocol/renderer modules are not public exports.
+
+The worker is created with
+`new Worker(new URL("./terminal-worker.js", import.meta.url), { type: "module" })`.
+The default font is resolved relative to its module, not the host page.
+Bundlers differ in whether they discover and rewrite assets inside dependencies;
+this package does not claim universal or individually verified bundler support.
+The reliable static deployment layout is the complete emitted tree described
+above.
+
+If your bundler does not handle the dependency's worker URL, explicitly provide
+the entry point you deployed:
+
+```ts
+const terminal = await WebTerminal.mount(container, {
+  url: "/ws/terminal",
+  workerUrl: "/web-terminal/terminal-worker.js"
+});
+```
+
+`workerUrl` accepts a nonempty string or URL and resolves relative strings against
+the page, not the package module. It still creates a **module** worker. Deploy its
+complete relative module tree, or provide a separately bundled worker entry from
+the same package build. The override does not automatically copy fonts: retain
+the default font asset URL or provide explicit `font.faces` URLs as shown below.
+The browser's worker origin and CSP restrictions still apply.
+
+Configure your server's JavaScript and WOFF2 MIME types and CSP to allow these
+workers, fonts, and the intended WebSocket endpoint.
+
+## Configuration and state
+
+`WebTerminalOptions` includes:
+
+| Option | Meaning |
+| --- | --- |
+| `workerUrl` | Optional module-worker entry; useful when worker assets are deployed separately. |
+| `scale` | GPU backing scale `0.5`–`3`, or `"auto"` (default, bounded device pixel ratio). |
+| `font` | One family and optional downloadable font faces; see below. |
+| `sizing` | `{ mode: "auto", fontSize?: number }` or `{ mode: "fixed", columns, rows, fontSize?: number }`. |
+| `readOnly` | Disable application input while retaining history inspection and selection. |
+| `label` | Accessible label for the terminal's hidden keyboard input. |
+| `inputBindings`, `onInput`, `actions` | Per-view input policy and custom actions. |
+| `onSelectionUI` | Synchronous, cancelable UI notification hook. |
+
+Font size is an integer from 8–32, defaulting to 16. Import `MIN_FONT_SIZE` and
+`MAX_FONT_SIZE` from `@hex1b/web-terminal` for sizing controls. Requested fixed grids allow
+20–300 columns and 10–100 rows. The producer still owns actual grid geometry.
+`resize()`, `setSizing()`, and automatic resize requests require primary
+ownership. `requestPrimary()` explicitly requests ownership; inspect `peer` or
+`onRoleChange` to observe the result.
+
+The handle exposes `geometry`, `peer`, `connected`, `stats`, `screenText`,
+`sizing`, `viewport`, `selection`, `inputBindings`, and `inputContext`.
+Metrics start empty; check optional fields before using them. History may be
+unavailable, and selection can be unavailable, none, pending, valid, or
+invalidated. Narrow `viewport.available` and `selection.status` before using
+their state-specific values. `screenText` reflects the presented viewport, not
+an independently reconstructed ANSI buffer.
+
+Callbacks include `onGeometry`, `onRoleChange`, `onSizingChange`, `onStats`,
+`onViewportChange`, `onSelectionChange`, `onStatus`, and `onInputError`.
+
+## Input and clipboard
+
+Import `InputRoute`, `TerminalAction`, and `defaultInputBindings` to inspect and
+customize routing. Defaults preserve browser shortcuts, forward terminal keys,
+copy with Cmd+C or Ctrl+Shift+C, and use a local right-click to copy or paste
+when application mouse capture does not own that gesture. IME composition and
+paste are forwarded through the producer's mode-aware input encoder.
+
+Overrides match first. Reuse a default binding's ID to replace it, or specify
+`{ id: "clipboard.context-click", remove: true }` to remove that default.
+`match`, `when`, and `onInput` must finish synchronously. Actions may be async.
+
+```ts
+import { InputRoute, TerminalAction, type WebTerminalOptions } from "@hex1b/web-terminal";
+
+const options: WebTerminalOptions = {
+  url: "/ws/terminal",
+  inputBindings: [
+    {
+      id: "history.previous-page",
+      match: input => input.type === "key" && input.key === "PageUp" && input.shift,
+      action: TerminalAction.ScrollLines,
+      args: -20
+    },
+    { id: "clipboard.context-click", remove: true }
+  ],
+  onInput(input) {
+    if (input.type === "key" && input.meta) return InputRoute.Browser;
+    return InputRoute.Continue;
+  }
+};
+```
+
+Named actions are `copySelection`, `pasteClipboard`, `copyOrPaste`,
+`clearSelection`, `scrollToLive`, and `scrollLines`.
+`terminal.runAction(TerminalAction.ScrollLines, -20)` shares the same
+implementation as bindings and UI controls. Custom `actions` receive
+`(context, args, input)`; their argument/result types are `unknown`, so custom
+handlers validate their own data. Built-in action names cannot be overridden.
+
+You can also call `scrollLines()`, `scrollToLive()`, `clearSelection()`,
+`copySelection({ clear: true })`, `paste(text)`, or `pasteClipboard()` directly.
+Copy uses authoritative producer selection text, not rendered cells. Clipboard
+actions reject if selection/input/focus changes before their asynchronous work
+can be applied safely. Errors are surfaced rather than silently reported as
+successful copies or pastes.
+
+## Selection UI hooks
+
+`onSelectionUI` receives a typed `SelectionUIEvent`, also dispatched as the
+`selectionui` DOM event on `terminal.element`. Its frozen detail includes
+selection, viewport, geometry, canvas size, connection/read-only state, and:
+
+- `overlay`: a stable light-DOM host for custom UI; style your controls and set
+  `pointer-events: auto` on interactive descendants.
+- `rects`: selection rectangles in overlay-local CSS pixels.
+- `runAction`: the same typed action API as the terminal handle.
+- `signal`: cleanup lifetime, aborted on disposal.
+
+Call `event.preventDefault()` **synchronously** to replace the default Copy
+button. This does not remove selection highlights or transfer ownership of
+selection/clipboard state. The callback must return `undefined`, not a Promise.
+Events coalesce meaningful changes; `refreshSelectionUI()` re-notifies hosts
+after external styling or policy changes. External DOM listeners may also
+cancel the default UI.
+
+Inspection UI inherits the embedding page's `--cp-*` theme tokens and otherwise
+uses its own light/dark defaults. Shadow parts include `selection-highlights`,
+`selection-highlight`, and `selection-copy-button`.
+
+## Fonts and licenses
+
+The default is the bundled **Cascadia Mono NF** variable WOFF2 font. The package
+includes the unmodified font, SIL Open Font License, and provenance in
+`dist/fonts/cascadia-mono-nf/`; no sample assets are required.
+
+```ts
+const font = {
+  family: "My Terminal Font",
+  faces: [{ url: "/fonts/my-terminal.woff2", weight: "100 900", style: "normal" }]
+};
+```
+
+Custom face URLs resolve against the host page before the configuration reaches
+the worker. Page-loaded fonts are not inherited by workers: supply face URLs,
+a locally installed family, or a generic family such as `monospace`. A generic
+family cannot have downloadable faces. Font loading failures reject rather
+than silently selecting a different font.
+
+Hex1b's code is MIT licensed (`LICENSE`); the bundled font uses its separate
+SIL Open Font License.
+
+## Build, test, and pack
+
+From this package directory, with Node.js 22 or later:
+
+```sh
+npm ci
+npm run build
+npm test
+npm pack
+```
+
+The strict TypeScript build emits JavaScript, declarations, declaration maps,
+and source maps (with embedded sources), then copies fonts into `dist/`.
+`npm test` runs zero-dependency `node:test` tests against those emitted modules
+and strict public-consumer declaration checks in NodeNext and bundler modes.
+`npm run typecheck` validates sources without emitting.
+
+`prepack` rebuilds for `npm pack` and manual `npm publish` from this directory.
+Only `dist/`, this README, the MIT license, and package metadata are shipped.
+A prepared tarball is self-contained and can be published with
+`npm publish ./hex1b-web-terminal-<version>.tgz --ignore-scripts`; it does not
+need development sources or build scripts. The package name is always
+`@hex1b/web-terminal`, including GitHub Packages. Registry selection is left to
+the caller; no registry is pinned in `package.json`.

package/dist/fonts/cascadia-mono-nf/LICENSE.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2019 - Present, Microsoft Corporation,
+with Reserved Font Name Cascadia Code.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/cascadia-mono-nf/README.md

@@ -0,0 +1,29 @@
+# Cascadia Mono NF
+
+The web terminal's default font is Microsoft's Cascadia Mono with Nerd Font
+symbols and without programming ligatures. The font file is unmodified.
+
+- Upstream: <https://github.com/microsoft/cascadia-code>
+- Release: [v2407.24](https://github.com/microsoft/cascadia-code/releases/tag/v2407.24)
+- Upstream release path: `woff2/CascadiaMonoNF.woff2`
+- Retrieved from Aspire's copy at commit
+  [`1dd4584e3df56f5544a3e7f5fda8aa767f92318e`](https://github.com/microsoft/aspire/tree/1dd4584e3df56f5544a3e7f5fda8aa767f92318e/src/Aspire.Dashboard/wwwroot/fonts/cascadia-mono-nf)
+- Size: 976,460 bytes
+- SHA-256: `bd42b0c992de9c42d8a770112e8140d67d6437798be39d49e57f4954e2f6e8e2`
+
+## License and redistribution
+
+Copyright (c) 2019 - Present, Microsoft Corporation,
+with Reserved Font Name Cascadia Code.
+
+The font is licensed under the **SIL Open Font License 1.1**, not Hex1b's code
+license. The full, unmodified license and copyright notice are in
+[`LICENSE.txt`](LICENSE.txt). Include that notice and license whenever
+redistributing the font, including future embedded-resource or npm packaging.
+OFL permits bundling and embedding alongside software; the font cannot be sold
+on its own. Modified versions must respect the reserved-font-name and other
+OFL conditions.
+
+To update, take the unmodified WOFF2 from an official upstream release, retain
+the accompanying license, and update the version, provenance, size, and hash
+above. Do not subset or patch the asset as an incidental packaging step.

package/dist/history-state.d.ts

@@ -0,0 +1,27 @@
+/** Commands contain producer identities; text and ranges are never inferred from painted cells. */
+export declare class HistoryState {
+    #private;
+    constructor(send: (command: TerminalCommand) => void, change?: () => void);
+    get viewport(): HistoryViewport;
+    get selection(): HistorySelectionState;
+    accept(history: HistoryMetadata | null, revision: number): boolean;
+    begin(point: TerminalPoint, { mode, extend }: {
+        mode: SelectionMode;
+        extend?: boolean;
+    }): void;
+    extend(point: TerminalPoint): void;
+    scroll(delta: number, endpoint?: TerminalPoint): void;
+    live(): void;
+    clear(): void;
+    endGesture(cancelled?: boolean): void;
+    cancelCopy(error: unknown): void;
+    copy(): Promise<string>;
+    disconnect(): void;
+}
+import type { SelectionMode, TerminalPoint, TerminalSelection, TerminalViewport } from "./types.js";
+import type { HistoryMetadata, TerminalCommand } from "./wire-types.js";
+type OmitEach<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+type HistoryViewport = OmitEach<TerminalViewport, "followTail" | "offset">;
+type HistorySelectionState = OmitEach<TerminalSelection, "active" | "pending" | "copying" | "copyError">;
+export {};
+//# sourceMappingURL=history-state.d.ts.map

package/dist/history-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-state.d.ts","sourceRoot":"","sources":["../src/history-state.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,qBAAa,YAAY;;gBAaX,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,EAAE,MAAM,GAAE,MAAM,IAAe;IAKnF,IAAI,QAAQ,IAAI,eAAe,CAK9B;IAED,IAAI,SAAS,IAAI,qBAAqB,CAYrC;IAED,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAuDlE,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAc,EAAE,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAStG,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAalC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI;IAcrD,IAAI;IAQJ,KAAK;IAQL,UAAU,CAAC,SAAS,UAAQ;IAc5B,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAEhC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAyBvB,UAAU;CAIX;AACD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAExE,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AACjF,KAAK,eAAe,GAAG,QAAQ,CAAC,gBAAgB,EAAE,YAAY,GAAG,QAAQ,CAAC,CAAC;AAC3E,KAAK,qBAAqB,GAAG,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CAAC"}

package/dist/history-state.js

@@ -0,0 +1,194 @@
+const unavailable = "Text history is not available for this terminal view";
+const expired = "Selection expired: its text was changed, evicted, reset, or resized. Select the text again.";
+const changedBeforeCopy = "Selection changed before copy completed. Copy the new selection again.";
+/** Commands contain producer identities; text and ranges are never inferred from painted cells. */
+export class HistoryState {
+    #send;
+    #change;
+    #history = null;
+    #revision = 0;
+    #nextRequest = 0;
+    #selectionRequest = 0;
+    #viewportRequest = 0;
+    #pendingMode = "character";
+    #pendingAction = "clear";
+    #pendingCopy;
+    #deferredEndpoint;
+    constructor(send, change = () => { }) {
+        this.#send = send;
+        this.#change = change;
+    }
+    get viewport() {
+        if (!this.#history)
+            return { available: false, following: true, pending: false };
+        const { selection, copy, ...viewport } = this.#history;
+        return { ...viewport, rowIds: [...viewport.rowIds], available: true, revision: this.#revision,
+            pending: viewport.requestId < this.#viewportRequest };
+    }
+    get selection() {
+        if (!this.#history)
+            return { status: "unavailable", mode: "character", ranges: [], text: null, message: unavailable };
+        const selection = this.#history.selection;
+        if (selection.requestId < this.#selectionRequest || this.#deferredEndpoint) {
+            return { requestId: this.#selectionRequest, status: "pending", mode: this.#pendingMode,
+                canExtend: this.#pendingAction !== "clear",
+                ranges: this.#pendingAction === "clear" ? [] : selection.ranges.map(range => ({ ...range })), text: null,
+                message: "Resolving selection…" };
+        }
+        return { ...selection, canExtend: selection.status === "valid",
+            ranges: selection.ranges.map(range => ({ ...range })), revision: this.#revision,
+            message: selection.status === "invalidated" ? expired : "" };
+    }
+    accept(history, revision) {
+        if (revision <= this.#revision)
+            return false;
+        const previousGeneration = this.#history?.generation;
+        this.#history = history;
+        this.#revision = revision;
+        if (!history || (previousGeneration && previousGeneration !== history.generation) ||
+            history.selection.status === "invalidated") {
+            this.endGesture(true);
+            this.#rejectCopy(new Error(expired));
+        }
+        const pending = this.#pendingCopy;
+        if (pending && history?.copy?.requestId === pending.requestId) {
+            if (history.copy.status !== "valid" || history.selection.status !== "valid" ||
+                history.selection.requestId !== pending.selectionRequestId ||
+                history.generation !== pending.generation || this.#selectionRequest > pending.selectionRequestId ||
+                history.copy.text !== history.selection.text) {
+                this.#rejectCopy(new Error(expired));
+            }
+            else {
+                clearTimeout(pending.timer);
+                this.#pendingCopy = undefined;
+                pending.resolve(history.copy.text);
+            }
+        }
+        if (this.#deferredEndpoint && !this.viewport.pending) {
+            const point = this.#deferredEndpoint;
+            this.#deferredEndpoint = undefined;
+            this.extend(point);
+        }
+        this.#change();
+        return true;
+    }
+    #requireHistory() {
+        if (!this.#history)
+            throw new Error(unavailable);
+        return this.#history;
+    }
+    #pointRowId(point) {
+        const history = this.#requireHistory();
+        if (!point || !Number.isInteger(point.x) || point.x < 0 || point.x > 1023 ||
+            !Number.isInteger(point.y) || point.y < 0 ||
+            typeof history.rowIds[point.y] !== "string" || !history.rowIds[point.y].length) {
+            throw new Error("Terminal viewport is not ready for that selection point. Wait for the next frame and try again.");
+        }
+        return history.rowIds[point.y];
+    }
+    #selectionChanged(mode = this.selection.mode, action = "extend") {
+        this.#rejectCopy(new Error(changedBeforeCopy));
+        this.#pendingMode = mode;
+        this.#pendingAction = action;
+        this.#selectionRequest = ++this.#nextRequest;
+        return this.#selectionRequest;
+    }
+    begin(point, { mode, extend = false }) {
+        const rowId = this.#pointRowId(point);
+        this.#deferredEndpoint = undefined;
+        const requestId = this.#selectionChanged(mode, extend ? "extend" : "start");
+        this.#send({ type: "selection", action: extend ? "extend" : "start", mode, requestId,
+            generation: this.#requireHistory().generation, rowId, column: point.x });
+        this.#change();
+    }
+    extend(point) {
+        this.#pointRowId(point);
+        if (this.viewport.pending) {
+            this.#rejectCopy(new Error(changedBeforeCopy));
+            this.#pendingMode = this.selection.mode;
+            this.#pendingAction = "extend";
+            this.#deferredEndpoint = { ...point };
+            this.#change();
+            return;
+        }
+        this.begin(point, { mode: this.selection.mode, extend: true });
+    }
+    scroll(delta, endpoint) {
+        this.#requireHistory();
+        if (!Number.isSafeInteger(delta) || delta < -2147483648 || delta > 2147483647)
+            throw new RangeError("Scroll delta must be a signed 32-bit integer");
+        if (endpoint)
+            this.#pointRowId(endpoint);
+        if (!delta && !endpoint)
+            return;
+        if (endpoint)
+            this.#deferredEndpoint = undefined;
+        else
+            this.#flushDeferredEndpoint();
+        const requestId = endpoint ? this.#selectionChanged() : ++this.#nextRequest;
+        this.#viewportRequest = requestId;
+        this.#send({ type: "viewport", requestId, delta,
+            ...(endpoint ? { extend: { row: endpoint.y, column: endpoint.x } } : {}) });
+        this.#change();
+    }
+    live() {
+        this.#requireHistory();
+        this.#flushDeferredEndpoint();
+        this.#viewportRequest = ++this.#nextRequest;
+        this.#send({ type: "viewport", live: true, requestId: this.#viewportRequest });
+        this.#change();
+    }
+    clear() {
+        this.#requireHistory();
+        this.#deferredEndpoint = undefined;
+        const requestId = this.#selectionChanged(this.selection.mode, "clear");
+        this.#send({ type: "selection", action: "clear", requestId });
+        this.#change();
+    }
+    endGesture(cancelled = false) {
+        if (cancelled && this.#deferredEndpoint) {
+            this.#deferredEndpoint = undefined;
+            this.#change();
+        }
+    }
+    #flushDeferredEndpoint() {
+        if (!this.#deferredEndpoint)
+            return;
+        const endpoint = this.#deferredEndpoint;
+        this.#deferredEndpoint = undefined;
+        // Preserve command order if another scroll overtakes the pending presentation.
+        this.scroll(0, endpoint);
+    }
+    cancelCopy(error) { this.#rejectCopy(error); }
+    copy() {
+        const history = this.#requireHistory();
+        const selection = this.selection;
+        if (selection.status !== "valid")
+            throw new Error(selection.message || "Select text before copying.");
+        this.#rejectCopy(new Error("A newer copy request replaced this request."));
+        const requestId = ++this.#nextRequest;
+        const { promise, resolve, reject } = Promise.withResolvers();
+        const timer = setTimeout(() => this.#rejectCopy(new Error("Timed out resolving selection. Copy again.")), 10000);
+        this.#pendingCopy = { requestId, selectionRequestId: selection.requestId, generation: history.generation,
+            resolve, reject, timer };
+        try {
+            this.#send({ type: "copy", requestId, selectionRequestId: selection.requestId, generation: history.generation });
+        }
+        catch (error) {
+            this.#rejectCopy(error);
+        }
+        return promise;
+    }
+    #rejectCopy(error) {
+        if (!this.#pendingCopy)
+            return;
+        clearTimeout(this.#pendingCopy.timer);
+        this.#pendingCopy.reject(error);
+        this.#pendingCopy = undefined;
+    }
+    disconnect() {
+        this.#rejectCopy(new Error("Terminal view disconnected before copy completed."));
+        this.#deferredEndpoint = undefined;
+    }
+}
+//# sourceMappingURL=history-state.js.map

package/dist/history-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-state.js","sourceRoot":"","sources":["../src/history-state.ts"],"names":[],"mappings":"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","sourcesContent":["const unavailable = \"Text history is not available for this terminal view\";\nconst expired = \"Selection expired: its text was changed, evicted, reset, or resized. Select the text again.\";\nconst changedBeforeCopy = \"Selection changed before copy completed. Copy the new selection again.\";\n\n/** Commands contain producer identities; text and ranges are never inferred from painted cells. */\nexport class HistoryState {\n  #send: (command: TerminalCommand) => void;\n  #change: () => void;\n  #history: HistoryMetadata | null = null;\n  #revision = 0;\n  #nextRequest = 0;\n  #selectionRequest = 0;\n  #viewportRequest = 0;\n  #pendingMode: SelectionMode = \"character\";\n  #pendingAction = \"clear\";\n  #pendingCopy: PendingCopy | undefined;\n  #deferredEndpoint: TerminalPoint | undefined;\n\n  constructor(send: (command: TerminalCommand) => void, change: () => void = () => {}) {\n    this.#send = send;\n    this.#change = change;\n  }\n\n  get viewport(): HistoryViewport {\n    if (!this.#history) return { available: false, following: true, pending: false };\n    const { selection, copy, ...viewport } = this.#history;\n    return { ...viewport, rowIds: [...viewport.rowIds], available: true, revision: this.#revision,\n      pending: viewport.requestId < this.#viewportRequest };\n  }\n\n  get selection(): HistorySelectionState {\n    if (!this.#history) return { status: \"unavailable\", mode: \"character\", ranges: [], text: null, message: unavailable };\n    const selection = this.#history.selection;\n    if (selection.requestId < this.#selectionRequest || this.#deferredEndpoint) {\n      return { requestId: this.#selectionRequest, status: \"pending\", mode: this.#pendingMode,\n        canExtend: this.#pendingAction !== \"clear\",\n        ranges: this.#pendingAction === \"clear\" ? [] : selection.ranges.map(range => ({ ...range })), text: null,\n        message: \"Resolving selection…\" };\n    }\n    return { ...selection, canExtend: selection.status === \"valid\",\n      ranges: selection.ranges.map(range => ({ ...range })), revision: this.#revision,\n      message: selection.status === \"invalidated\" ? expired : \"\" };\n  }\n\n  accept(history: HistoryMetadata | null, revision: number): boolean {\n    if (revision <= this.#revision) return false;\n    const previousGeneration = this.#history?.generation;\n    this.#history = history;\n    this.#revision = revision;\n    if (!history || (previousGeneration && previousGeneration !== history.generation) ||\n        history.selection.status === \"invalidated\") {\n      this.endGesture(true);\n      this.#rejectCopy(new Error(expired));\n    }\n    const pending = this.#pendingCopy;\n    if (pending && history?.copy?.requestId === pending.requestId) {\n      if (history.copy.status !== \"valid\" || history.selection.status !== \"valid\" ||\n          history.selection.requestId !== pending.selectionRequestId ||\n          history.generation !== pending.generation || this.#selectionRequest > pending.selectionRequestId ||\n          history.copy.text !== history.selection.text) {\n        this.#rejectCopy(new Error(expired));\n      } else {\n        clearTimeout(pending.timer);\n        this.#pendingCopy = undefined;\n        pending.resolve(history.copy.text);\n      }\n    }\n    if (this.#deferredEndpoint && !this.viewport.pending) {\n      const point = this.#deferredEndpoint;\n      this.#deferredEndpoint = undefined;\n      this.extend(point);\n    }\n    this.#change();\n    return true;\n  }\n\n  #requireHistory(): HistoryMetadata {\n    if (!this.#history) throw new Error(unavailable);\n    return this.#history;\n  }\n\n  #pointRowId(point: TerminalPoint): string {\n    const history = this.#requireHistory();\n    if (!point || !Number.isInteger(point.x) || point.x < 0 || point.x > 1023 ||\n        !Number.isInteger(point.y) || point.y < 0 ||\n        typeof history.rowIds[point.y] !== \"string\" || !history.rowIds[point.y].length) {\n      throw new Error(\"Terminal viewport is not ready for that selection point. Wait for the next frame and try again.\");\n    }\n    return history.rowIds[point.y];\n  }\n\n  #selectionChanged(mode = this.selection.mode, action = \"extend\") {\n    this.#rejectCopy(new Error(changedBeforeCopy));\n    this.#pendingMode = mode;\n    this.#pendingAction = action;\n    this.#selectionRequest = ++this.#nextRequest;\n    return this.#selectionRequest;\n  }\n\n  begin(point: TerminalPoint, { mode, extend = false }: { mode: SelectionMode; extend?: boolean }): void {\n    const rowId = this.#pointRowId(point);\n    this.#deferredEndpoint = undefined;\n    const requestId = this.#selectionChanged(mode, extend ? \"extend\" : \"start\");\n    this.#send({ type: \"selection\", action: extend ? \"extend\" : \"start\", mode, requestId,\n      generation: this.#requireHistory().generation, rowId, column: point.x });\n    this.#change();\n  }\n\n  extend(point: TerminalPoint): void {\n    this.#pointRowId(point);\n    if (this.viewport.pending) {\n      this.#rejectCopy(new Error(changedBeforeCopy));\n      this.#pendingMode = this.selection.mode;\n      this.#pendingAction = \"extend\";\n      this.#deferredEndpoint = { ...point };\n      this.#change();\n      return;\n    }\n    this.begin(point, { mode: this.selection.mode, extend: true });\n  }\n\n  scroll(delta: number, endpoint?: TerminalPoint): void {\n    this.#requireHistory();\n    if (!Number.isSafeInteger(delta) || delta < -2147483648 || delta > 2147483647) throw new RangeError(\"Scroll delta must be a signed 32-bit integer\");\n    if (endpoint) this.#pointRowId(endpoint);\n    if (!delta && !endpoint) return;\n    if (endpoint) this.#deferredEndpoint = undefined;\n    else this.#flushDeferredEndpoint();\n    const requestId = endpoint ? this.#selectionChanged() : ++this.#nextRequest;\n    this.#viewportRequest = requestId;\n    this.#send({ type: \"viewport\", requestId, delta,\n      ...(endpoint ? { extend: { row: endpoint.y, column: endpoint.x } } : {}) });\n    this.#change();\n  }\n\n  live() {\n    this.#requireHistory();\n    this.#flushDeferredEndpoint();\n    this.#viewportRequest = ++this.#nextRequest;\n    this.#send({ type: \"viewport\", live: true, requestId: this.#viewportRequest });\n    this.#change();\n  }\n\n  clear() {\n    this.#requireHistory();\n    this.#deferredEndpoint = undefined;\n    const requestId = this.#selectionChanged(this.selection.mode, \"clear\");\n    this.#send({ type: \"selection\", action: \"clear\", requestId });\n    this.#change();\n  }\n\n  endGesture(cancelled = false) {\n    if (cancelled && this.#deferredEndpoint) {\n      this.#deferredEndpoint = undefined;\n      this.#change();\n    }\n  }\n\n  #flushDeferredEndpoint() {\n    if (!this.#deferredEndpoint) return;\n    const endpoint = this.#deferredEndpoint;\n    this.#deferredEndpoint = undefined;\n    // Preserve command order if another scroll overtakes the pending presentation.\n    this.scroll(0, endpoint);\n  }\n  cancelCopy(error: unknown): void { this.#rejectCopy(error); }\n\n  copy(): Promise<string> {\n    const history = this.#requireHistory();\n    const selection = this.selection;\n    if (selection.status !== \"valid\") throw new Error(selection.message || \"Select text before copying.\");\n    this.#rejectCopy(new Error(\"A newer copy request replaced this request.\"));\n    const requestId = ++this.#nextRequest;\n    const { promise, resolve, reject } = Promise.withResolvers<string>();\n    const timer = setTimeout(() => this.#rejectCopy(new Error(\"Timed out resolving selection. Copy again.\")), 10000);\n    this.#pendingCopy = { requestId, selectionRequestId: selection.requestId, generation: history.generation,\n      resolve, reject, timer };\n    try {\n      this.#send({ type: \"copy\", requestId, selectionRequestId: selection.requestId, generation: history.generation });\n    } catch (error) {\n      this.#rejectCopy(error);\n    }\n    return promise;\n  }\n\n  #rejectCopy(error: unknown): void {\n    if (!this.#pendingCopy) return;\n    clearTimeout(this.#pendingCopy.timer);\n    this.#pendingCopy.reject(error);\n    this.#pendingCopy = undefined;\n  }\n\n  disconnect() {\n    this.#rejectCopy(new Error(\"Terminal view disconnected before copy completed.\"));\n    this.#deferredEndpoint = undefined;\n  }\n}\nimport type { SelectionMode, TerminalPoint, TerminalSelection, TerminalViewport } from \"./types.js\";\nimport type { HistoryMetadata, TerminalCommand } from \"./wire-types.js\";\n\ntype OmitEach<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\ntype HistoryViewport = OmitEach<TerminalViewport, \"followTail\" | \"offset\">;\ntype HistorySelectionState = OmitEach<TerminalSelection, \"active\" | \"pending\" | \"copying\" | \"copyError\">;\ninterface PendingCopy {\n  requestId: number; selectionRequestId: number; generation: string;\n  resolve: (text: string) => void; reject: (error: unknown) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { WebTerminal } from "./web-terminal.js";
+export { InputRoute, TerminalAction, defaultInputBindings } from "./input-policy.js";
+export { MIN_FONT_SIZE, MAX_FONT_SIZE } from "./terminal-sizing.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map