@knpkv/herdr-connect 0.3.1 → 0.4.1

package/dist/terminal-keyboard.d.ts

@@ -0,0 +1,52 @@
+import { Schema } from "effect";
+import type { TerminalClientCommand } from "./model.js";
+export declare const TerminalModifier: Schema.Literals<readonly ["ctrl", "alt"]>;
+export type TerminalModifier = typeof TerminalModifier.Type;
+export declare const TerminalCursorMode: Schema.Literals<readonly ["normal", "application"]>;
+export type TerminalCursorMode = typeof TerminalCursorMode.Type;
+export declare const TerminalRailKey: Schema.Literals<readonly ["escape", "tab", "arrowLeft", "arrowUp", "arrowDown", "arrowRight"]>;
+export type TerminalRailKey = typeof TerminalRailKey.Type;
+export type TerminalKeyDescriptor = {
+    readonly key: TerminalRailKey;
+    readonly label: string;
+    readonly ariaLabel: string;
+};
+export declare const terminalModifiers: ReadonlyArray<TerminalModifier>;
+export declare const terminalKeyDescriptors: ReadonlyArray<TerminalKeyDescriptor>;
+export type TerminalKeySerialization = {
+    readonly _tag: "supported";
+    readonly text: string;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: "modifier_combination_not_supported";
+};
+type TerminalInputCommand = Extract<TerminalClientCommand, {
+    readonly type: "terminal.input";
+}>;
+/** Serialize one fixed terminal key without accepting arbitrary command text. */
+export declare const serializeTerminalKey: (key: TerminalRailKey, modifier: TerminalModifier | null, cursorMode?: TerminalCursorMode) => TerminalKeySerialization;
+export type TerminalKeyDispatch = {
+    readonly _tag: "sent";
+    readonly command: TerminalInputCommand;
+    readonly nextModifier: null;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: "modifier_combination_not_supported";
+    readonly nextModifier: TerminalModifier | null;
+};
+/** Apply a rail key and clear a successful one-shot modifier. */
+export declare const dispatchTerminalKey: (key: TerminalRailKey, modifier: TerminalModifier | null, cursorMode?: TerminalCursorMode) => TerminalKeyDispatch;
+export declare const toggleTerminalModifier: (current: TerminalModifier | null, next: TerminalModifier) => TerminalModifier | null;
+export type TerminalInputApplication = {
+    readonly _tag: "supported";
+    readonly text: string;
+    readonly nextModifier: null;
+} | {
+    readonly _tag: "unsupported";
+    readonly reason: "modifier_combination_not_supported";
+    readonly nextModifier: TerminalModifier;
+};
+/** Apply a latched modifier to one Ghostty input chunk using only known encodings. */
+export declare const applyTerminalModifierToInput: (modifier: TerminalModifier | null, text: string) => TerminalInputApplication;
+export {};
+//# sourceMappingURL=terminal-keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-keyboard.d.ts","sourceRoot":"","sources":["../src/terminal-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,eAAO,MAAM,gBAAgB,2CAAmC,CAAA;AAChE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,eAAO,MAAM,kBAAkB,qDAA6C,CAAA;AAC5E,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,eAAe,gGAO1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,gBAAgB,CAAmB,CAAA;AAEjF,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,qBAAqB,CAOvE,CAAA;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAA;CAAE,CAAA;AAE3F,KAAK,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAAA;AAsD/F,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,QAC1B,eAAe,YACV,gBAAgB,GAAG,IAAI,eACrB,kBAAkB,KAC7B,wBAoBF,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;CAC5B,GACC;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAA;IACrD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC/C,CAAA;AAEH,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,QACzB,eAAe,YACV,gBAAgB,GAAG,IAAI,eACrB,kBAAkB,KAC7B,mBAaF,CAAA;AAED,eAAO,MAAM,sBAAsB,YACxB,gBAAgB,GAAG,IAAI,QAC1B,gBAAgB,KACrB,gBAAgB,GAAG,IAAwC,CAAA;AAE9D,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;CAAE,GAClF;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAA;IACrD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAA;CACxC,CAAA;AAgEH,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,aAC7B,gBAAgB,GAAG,IAAI,QAC3B,MAAM,KACX,wBAG4C,CAAA"}

package/dist/terminal-keyboard.js

@@ -0,0 +1,141 @@
+import { Schema } from "effect";
+export const TerminalModifier = Schema.Literals(["ctrl", "alt"]);
+export const TerminalCursorMode = Schema.Literals(["normal", "application"]);
+export const TerminalRailKey = Schema.Literals([
+    "escape",
+    "tab",
+    "arrowLeft",
+    "arrowUp",
+    "arrowDown",
+    "arrowRight"
+]);
+export const terminalModifiers = ["ctrl", "alt"];
+export const terminalKeyDescriptors = [
+    { key: "escape", label: "Esc", ariaLabel: "Escape" },
+    { key: "tab", label: "Tab", ariaLabel: "Tab" },
+    { key: "arrowLeft", label: "←", ariaLabel: "Arrow left" },
+    { key: "arrowUp", label: "↑", ariaLabel: "Arrow up" },
+    { key: "arrowDown", label: "↓", ariaLabel: "Arrow down" },
+    { key: "arrowRight", label: "→", ariaLabel: "Arrow right" }
+];
+const unsupported = () => ({
+    _tag: "unsupported",
+    reason: "modifier_combination_not_supported"
+});
+const supported = (text) => ({ _tag: "supported", text });
+const controlCharacter = (key) => {
+    switch (key) {
+        case "c":
+            return "\u0003";
+        case "d":
+            return "\u0004";
+        case "l":
+            return "\u000c";
+        case "z":
+            return "\u001a";
+    }
+};
+const arrowCode = (key) => {
+    switch (key) {
+        case "arrowLeft":
+            return "D";
+        case "arrowUp":
+            return "A";
+        case "arrowDown":
+            return "B";
+        case "arrowRight":
+            return "C";
+    }
+};
+const arrowSequence = (code, cursorMode) => cursorMode === "application" ? `\u001bO${code}` : `\u001b[${code}`;
+const arrowDefinitions = [
+    { key: "arrowUp", code: "A" },
+    { key: "arrowDown", code: "B" },
+    { key: "arrowRight", code: "C" },
+    { key: "arrowLeft", code: "D" }
+];
+/** Serialize one fixed terminal key without accepting arbitrary command text. */
+export const serializeTerminalKey = (key, modifier, cursorMode = "normal") => {
+    switch (key) {
+        case "escape":
+            return modifier === null ? supported("\u001b") : unsupported();
+        case "tab":
+            return modifier === "ctrl" ? unsupported() : supported(modifier === "alt" ? "\u001b\t" : "\t");
+        case "arrowLeft":
+        case "arrowUp":
+        case "arrowDown":
+        case "arrowRight": {
+            const code = arrowCode(key);
+            return supported(modifier === null
+                ? arrowSequence(code, cursorMode)
+                : `\u001b[1;${modifier === "ctrl" ? "5" : "3"}${code}`);
+        }
+        default:
+            return unsupported();
+    }
+};
+/** Apply a rail key and clear a successful one-shot modifier. */
+export const dispatchTerminalKey = (key, modifier, cursorMode = "normal") => {
+    const serialization = serializeTerminalKey(key, modifier, cursorMode);
+    return serialization._tag === "supported"
+        ? {
+            _tag: "sent",
+            command: { type: "terminal.input", text: serialization.text },
+            nextModifier: null
+        }
+        : {
+            _tag: "unsupported",
+            reason: serialization.reason,
+            nextModifier: modifier
+        };
+};
+export const toggleTerminalModifier = (current, next) => (current === next ? null : next);
+const arrowInputs = arrowDefinitions.map(({ code }) => ({
+    plain: `\u001b[${code}`,
+    application: `\u001bO${code}`,
+    ctrl: `\u001b[1;5${code}`,
+    alt: `\u001b[1;3${code}`
+}));
+const modifierCharacterInputs = ["c", "d", "l", "z"].map((key) => ({
+    plain: key,
+    encoded: `\u001b${key}`
+}));
+const terminalInputWithModifier = (modifier, text) => {
+    const arrow = arrowInputs.find((candidate) => candidate.plain === text || candidate.application === text || candidate[modifier] === text);
+    if (arrow !== undefined) {
+        return { _tag: "supported", text: arrow[modifier], nextModifier: null };
+    }
+    if (modifier === "ctrl") {
+        if (text === "\u0003" || text === "\u0004" || text === "\u000c" || text === "\u001a") {
+            return { _tag: "supported", text, nextModifier: null };
+        }
+        const controlKey = text.length === 1 ? text.toLowerCase() : text;
+        if (controlKey === "c" || controlKey === "d" || controlKey === "l" || controlKey === "z") {
+            return { _tag: "supported", text: controlCharacter(controlKey), nextModifier: null };
+        }
+    }
+    if (modifier === "alt") {
+        const normalized = text.length === 1
+            ? text.toLowerCase()
+            : text.length === 2 && text.startsWith("\u001b")
+                ? `\u001b${text.slice(1).toLowerCase()}`
+                : text;
+        const character = modifierCharacterInputs.find((candidate) => candidate.plain === normalized || candidate.encoded === normalized);
+        if (character !== undefined) {
+            return {
+                _tag: "supported",
+                text: text.length === 1 ? `\u001b${text}` : text,
+                nextModifier: null
+            };
+        }
+        if (text === "\t" || text === "\u001b\t") {
+            return { _tag: "supported", text: "\u001b\t", nextModifier: null };
+        }
+    }
+    return { _tag: "unsupported", reason: "modifier_combination_not_supported", nextModifier: modifier };
+};
+/** Apply a latched modifier to one Ghostty input chunk using only known encodings. */
+export const applyTerminalModifierToInput = (modifier, text) => modifier === null
+    ? { _tag: "supported", text, nextModifier: null }
+    : terminalInputWithModifier(modifier, text);
+//# sourceMappingURL=terminal-keyboard.js.map

package/dist/terminal-keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-keyboard.js","sourceRoot":"","sources":["../src/terminal-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAGhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAA;AAG5E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7C,QAAQ;IACR,KAAK;IACL,WAAW;IACX,SAAS;IACT,WAAW;IACX,YAAY;CACb,CAAC,CAAA;AASF,MAAM,CAAC,MAAM,iBAAiB,GAAoC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAEjF,MAAM,CAAC,MAAM,sBAAsB,GAAyC;IAC1E,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE;IACpD,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IAC9C,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE;IACzD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE;IACrD,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE;IACzD,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE;CAC5D,CAAA;AAQD,MAAM,WAAW,GAAG,GAA6B,EAAE,CAAC,CAAC;IACnD,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,oCAAoC;CAC7C,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAA4B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAI3F,MAAM,gBAAgB,GAAG,CAAC,GAAuB,EAAU,EAAE;IAC3D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,GAAG;YACN,OAAO,QAAQ,CAAA;QACjB,KAAK,GAAG;YACN,OAAO,QAAQ,CAAA;QACjB,KAAK,GAAG;YACN,OAAO,QAAQ,CAAA;QACjB,KAAK,GAAG;YACN,OAAO,QAAQ,CAAA;IACnB,CAAC;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAChB,GAAmF,EAC5D,EAAE;IACzB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,WAAW;YACd,OAAO,GAAG,CAAA;QACZ,KAAK,SAAS;YACZ,OAAO,GAAG,CAAA;QACZ,KAAK,WAAW;YACd,OAAO,GAAG,CAAA;QACZ,KAAK,YAAY;YACf,OAAO,GAAG,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,IAA2B,EAAE,UAA8B,EAAU,EAAE,CAC5F,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAA;AAOpE,MAAM,gBAAgB,GAAmC;IACvD,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE;IAC7B,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE;IAC/B,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE;IAChC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE;CAChC,CAAA;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,GAAoB,EACpB,QAAiC,EACjC,UAAU,GAAuB,QAAQ,EACf,EAAE;IAC5B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAChE,KAAK,KAAK;YACR,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAChG,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YAC3B,OAAO,SAAS,CACd,QAAQ,KAAK,IAAI;gBACf,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC;gBACjC,CAAC,CAAC,YAAY,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CACzD,CAAA;QACH,CAAC;QACD;YACE,OAAO,WAAW,EAAE,CAAA;IACxB,CAAC;AACH,CAAC,CAAA;AAcD,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAoB,EACpB,QAAiC,EACjC,UAAU,GAAuB,QAAQ,EACpB,EAAE;IACvB,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;IACrE,OAAO,aAAa,CAAC,IAAI,KAAK,WAAW;QACvC,CAAC,CAAC;YACA,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE;YAC7D,YAAY,EAAE,IAAI;SACnB;QACD,CAAC,CAAC;YACA,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,YAAY,EAAE,QAAQ;SACvB,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAgC,EAChC,IAAsB,EACG,EAAE,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAU9D,MAAM,WAAW,GAKZ,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,UAAU,IAAI,EAAE;IACvB,WAAW,EAAE,UAAU,IAAI,EAAE;IAC7B,IAAI,EAAE,aAAa,IAAI,EAAE;IACzB,GAAG,EAAE,aAAa,IAAI,EAAE;CACzB,CAAC,CAAC,CAAA;AAEH,MAAM,uBAAuB,GAGxB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtC,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,SAAS,GAAG,EAAE;CACxB,CAAC,CAAC,CAAA;AAEH,MAAM,yBAAyB,GAAG,CAChC,QAA0B,EAC1B,IAAY,EACc,EAAE;IAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAC5B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,IAAI,SAAS,CAAC,WAAW,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAC1G,CAAA;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;IACzE,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;QACxD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QAChE,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACzF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;QACtF,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;YACpB,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAChD,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE;gBACxC,CAAC,CAAC,IAAI,CAAA;QACR,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3D,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,OAAO,KAAK,UAAU,CACnE,CAAA;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;gBAChD,YAAY,EAAE,IAAI;aACnB,CAAA;QACH,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;QACpE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,oCAAoC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAA;AACtG,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,QAAiC,EACjC,IAAY,EACc,EAAE,CAC5B,QAAQ,KAAK,IAAI;IACf,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;IACjD,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA"}

package/dist/terminal-output.d.ts

@@ -0,0 +1,30 @@
+import type { PendingTerminalInput } from "./terminal-input.js";
+import type { TerminalInputApplication, TerminalModifier } from "./terminal-keyboard.js";
+export type TerminalOutputBoundary = {
+    readonly isActive: () => boolean;
+    readonly run: (write: () => void) => void;
+};
+type TerminalOutputWriter = {
+    readonly write: (data: Uint8Array) => void;
+};
+/** Mark synchronous Ghostty output so generated protocol replies bypass key modifiers. */
+export declare const makeTerminalOutputBoundary: () => TerminalOutputBoundary;
+/** Render server output through the production provenance boundary. */
+export declare const writeTerminalOutput: (terminal: TerminalOutputWriter, data: Uint8Array, outputBoundary: TerminalOutputBoundary) => void;
+export type TerminalInputFailure = "connection_unavailable" | "input_queue_overflow";
+type SupportedTerminalInput = Extract<TerminalInputApplication, {
+    readonly _tag: "supported";
+}>;
+export type TerminalInputHandlerOptions = {
+    readonly applyInput: (text: string) => SupportedTerminalInput | null;
+    readonly isReady: () => boolean;
+    readonly onFailure: (failure: TerminalInputFailure) => void;
+    readonly outputBoundary: TerminalOutputBoundary;
+    readonly pendingInput: PendingTerminalInput;
+    readonly sendInput: (text: string) => boolean;
+    readonly setModifier: (modifier: TerminalModifier | null) => void;
+};
+/** Route Ghostty data by provenance so terminal replies bypass user modifiers. */
+export declare const makeTerminalInputHandler: ({ applyInput, isReady, onFailure, outputBoundary, pendingInput, sendInput, setModifier }: TerminalInputHandlerOptions) => (text: string) => void;
+export {};
+//# sourceMappingURL=terminal-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-output.d.ts","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAExF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CAC1C,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;CAC3C,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B,QAAO,sBAa7C,CAAA;AAED,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,aACpB,oBAAoB,QACxB,UAAU,kBACA,sBAAsB,KACrC,IAAsD,CAAA;AAEzD,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,sBAAsB,CAAA;AAEpF,KAAK,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAA;AAE/F,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,sBAAsB,GAAG,IAAI,CAAA;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC3D,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAA;IAC/C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAA;CAClE,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,6FAQlC,2BAA2B,KAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IA0BlD,CAAA"}

package/dist/terminal-output.js

@@ -0,0 +1,54 @@
+/** Mark synchronous Ghostty output so generated protocol replies bypass key modifiers. */
+export const makeTerminalOutputBoundary = () => {
+    let depth = 0;
+    return {
+        isActive: () => depth > 0,
+        run: (write) => {
+            depth += 1;
+            try {
+                write();
+            }
+            finally {
+                depth -= 1;
+            }
+        }
+    };
+};
+/** Render server output through the production provenance boundary. */
+export const writeTerminalOutput = (terminal, data, outputBoundary) => outputBoundary.run(() => terminal.write(data));
+/** Route Ghostty data by provenance so terminal replies bypass user modifiers. */
+export const makeTerminalInputHandler = ({ applyInput, isReady, onFailure, outputBoundary, pendingInput, sendInput, setModifier }) => {
+    const sendOrFail = (text) => {
+        if (sendInput(text))
+            return true;
+        onFailure("connection_unavailable");
+        return false;
+    };
+    const queueOrFail = (text) => {
+        if (pendingInput.push(text) !== "overflow")
+            return true;
+        onFailure("input_queue_overflow");
+        return false;
+    };
+    return (text) => {
+        if (outputBoundary.isActive()) {
+            if (isReady())
+                sendOrFail(text);
+            else
+                queueOrFail(text);
+            return;
+        }
+        const appliedText = applyInput(text);
+        if (appliedText === null)
+            return;
+        if (isReady()) {
+            if (!sendOrFail(appliedText.text))
+                return;
+            setModifier(appliedText.nextModifier);
+            return;
+        }
+        if (queueOrFail(appliedText.text))
+            setModifier(appliedText.nextModifier);
+    };
+};
+//# sourceMappingURL=terminal-output.js.map

package/dist/terminal-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-output.js","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"AAYA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAA2B,EAAE;IACrE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC;QACzB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;YACb,KAAK,IAAI,CAAC,CAAA;YACV,IAAI,CAAC;gBACH,KAAK,EAAE,CAAA;YACT,CAAC;oBAAS,CAAC;gBACT,KAAK,IAAI,CAAC,CAAA;YACZ,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAA8B,EAC9B,IAAgB,EAChB,cAAsC,EAChC,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAgBzD,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,EACvC,UAAU,EACV,OAAO,EACP,SAAS,EACT,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,EACiB,EAA0B,EAAE;IACxD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE;QAC3C,IAAI,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAChC,SAAS,CAAC,wBAAwB,CAAC,CAAA;QACnC,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE;QAC5C,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,IAAI,CAAA;QACvD,SAAS,CAAC,sBAAsB,CAAC,CAAA;QACjC,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,IAAI,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC9B,IAAI,OAAO,EAAE;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAA;;gBAC1B,WAAW,CAAC,IAAI,CAAC,CAAA;YACtB,OAAM;QACR,CAAC;QACD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,WAAW,KAAK,IAAI;YAAE,OAAM;QAChC,IAAI,OAAO,EAAE,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC;gBAAE,OAAM;YACzC,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;YACrC,OAAM;QACR,CAAC;QACD,IAAI,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAC1E,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/terminal-rail-navigation.d.ts

@@ -0,0 +1,4 @@
+export type TerminalRailNavigationKey = "ArrowLeft" | "ArrowRight";
+/** Find the next enabled terminal control for horizontal toolbar navigation. */
+export declare const nextTerminalRailIndex: (key: string, currentIndex: number, enabled: ReadonlyArray<boolean>) => number | null;
+//# sourceMappingURL=terminal-rail-navigation.d.ts.map

package/dist/terminal-rail-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-rail-navigation.d.ts","sourceRoot":"","sources":["../src/terminal-rail-navigation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,CAAA;AAElE,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAC3B,MAAM,gBACG,MAAM,WACX,aAAa,CAAC,OAAO,CAAC,KAC9B,MAAM,GAAG,IAQX,CAAA"}

package/dist/terminal-rail-navigation.js

@@ -0,0 +1,13 @@
+/** Find the next enabled terminal control for horizontal toolbar navigation. */
+export const nextTerminalRailIndex = (key, currentIndex, enabled) => {
+    if ((key !== "ArrowLeft" && key !== "ArrowRight") || enabled.length < 2)
+        return null;
+    const offset = key === "ArrowLeft" ? -1 : 1;
+    for (let step = 1; step < enabled.length; step += 1) {
+        const index = (currentIndex + offset * step + enabled.length) % enabled.length;
+        if (enabled[index] === true)
+            return index;
+    }
+    return null;
+};
+//# sourceMappingURL=terminal-rail-navigation.js.map

package/dist/terminal-rail-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-rail-navigation.js","sourceRoot":"","sources":["../src/terminal-rail-navigation.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAW,EACX,YAAoB,EACpB,OAA+B,EAChB,EAAE;IACjB,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,YAAY,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACpF,MAAM,MAAM,GAAG,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,CAAC,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAA;QAC9E,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;IAC3C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/terminal-viewport.d.ts

@@ -1,12 +1,42 @@
 export interface TerminalViewportTarget {
     readonly style: Pick<CSSStyleDeclaration, "removeProperty" | "setProperty">;
 }
+export interface TerminalViewportScrollAncestor extends EventTarget {
+    readonly parentElement?: TerminalViewportScrollAncestor | null;
+}
+export interface TerminalViewportBoundary {
+    readonly getBoundingClientRect: () => Pick<DOMRect, "top">;
+    readonly parentElement?: TerminalViewportScrollAncestor | null;
+}
 export interface TerminalVisualViewport extends EventTarget {
     readonly height: number;
     readonly offsetTop: number;
 }
-export interface TerminalViewportHost {
+export interface TerminalViewportHost extends EventTarget {
+    readonly document?: {
+        readonly body: {
+            readonly classList: Pick<DOMTokenList, "add" | "contains" | "remove">;
+        };
+        readonly documentElement: {
+            readonly classList: Pick<DOMTokenList, "add" | "contains" | "remove">;
+        };
+    };
+    readonly innerHeight?: number;
+    readonly scrollX?: number;
+    readonly scrollY?: number;
     readonly visualViewport?: TerminalVisualViewport | null;
+    readonly scrollTo?: (options: ScrollToOptions) => void;
+}
+export type TerminalViewportCleanup = () => void;
+export interface TerminalViewportBindingState {
+    readonly connectionRequested: boolean;
+    readonly focusRejected: boolean;
+    readonly terminalConnected: boolean;
 }
-export declare const bindTerminalViewport: (target: TerminalViewportTarget, host: TerminalViewportHost) => () => void;
+/** Keeps geometry installed for every state that can render the fixed terminal. */
+export declare const terminalViewportBindingActive: ({ connectionRequested, focusRejected, terminalConnected }: TerminalViewportBindingState) => boolean;
+/** Locks document scrolling without mutating inline styles until cleanup. */
+export declare const bindTerminalDocumentLock: (host: TerminalViewportHost) => TerminalViewportCleanup;
+/** Locks document scroll and fits the terminal to the visual viewport until cleanup. */
+export declare const bindTerminalViewport: (target: TerminalViewportTarget, host: TerminalViewportHost, topBoundary?: TerminalViewportBoundary, lockDocument?: boolean) => TerminalViewportCleanup;
 //# sourceMappingURL=terminal-viewport.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"terminal-viewport.d.ts","sourceRoot":"","sources":["../src/terminal-viewport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,aAAa,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;CACxD;AAKD,eAAO,MAAM,oBAAoB,WACvB,sBAAsB,QACxB,oBAAoB,KACzB,MAAM,IAmBR,CAAA"}
+{"version":3,"file":"terminal-viewport.d.ts","sourceRoot":"","sources":["../src/terminal-viewport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,aAAa,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,8BAA+B,SAAQ,WAAW;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;CAC/D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;CAC/D;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAA;SAAE,CAAA;QACxF,QAAQ,CAAC,eAAe,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAA;SAAE,CAAA;KACpG,CAAA;IACD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;CACvD;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAA;AAEhD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;CACpC;AAED,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,8DAIvC,4BAA4B,KAAG,OAAoE,CAAA;AAuCtG,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,SAAU,oBAAoB,KAAG,uBAyCrE,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,WACvB,sBAAsB,QACxB,oBAAoB,gBACZ,wBAAwB,6BAErC,uBAwDF,CAAA"}

package/dist/terminal-viewport.js

@@ -1,21 +1,140 @@
+/** Keeps geometry installed for every state that can render the fixed terminal. */
+export const terminalViewportBindingActive = ({ connectionRequested, focusRejected, terminalConnected }) => connectionRequested || focusRejected || terminalConnected;
 const viewportHeightProperty = "--connect-visual-viewport-height";
 const viewportOffsetProperty = "--connect-visual-viewport-offset";
-export const bindTerminalViewport = (target, host) => {
-    const viewport = host.visualViewport;
-    if (viewport === undefined || viewport === null)
+const documentLockClass = "connect-terminal-document-lock";
+const terminalDocumentLocks = new WeakMap();
+const bindTerminalDocumentRelease = (host, lock) => {
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        host.removeEventListener("pagehide", releaseOnPageHide);
+        lock.count -= 1;
+        if (lock.count === 0)
+            lock.restore();
+    };
+    const releaseOnPageHide = (event) => {
+        if ("persisted" in event && event.persisted === true)
+            return;
+        release();
+    };
+    try {
+        host.addEventListener("pagehide", releaseOnPageHide);
+    }
+    catch (error) {
+        lock.count -= 1;
+        if (lock.count === 0)
+            lock.restore();
+        throw error;
+    }
+    return release;
+};
+/** Locks document scrolling without mutating inline styles until cleanup. */
+export const bindTerminalDocumentLock = (host) => {
+    const document = host.document;
+    if (document === undefined)
         return () => undefined;
+    const active = terminalDocumentLocks.get(document);
+    if (active !== undefined) {
+        active.count += 1;
+        return bindTerminalDocumentRelease(host, active);
+    }
+    const bodyWasLocked = document.body.classList.contains(documentLockClass);
+    const documentWasLocked = document.documentElement.classList.contains(documentLockClass);
+    const scrollX = host.scrollX ?? 0;
+    const scrollY = host.scrollY ?? 0;
+    const restoreScroll = () => host.scrollTo?.({ behavior: "instant", left: scrollX, top: scrollY });
+    let restoring = false;
+    const retainScroll = () => {
+        if (restoring || (host.scrollX === scrollX && host.scrollY === scrollY))
+            return;
+        restoring = true;
+        restoreScroll();
+        restoring = false;
+    };
+    const restore = () => {
+        host.removeEventListener("scroll", retainScroll, true);
+        terminalDocumentLocks.delete(document);
+        if (!documentWasLocked)
+            document.documentElement.classList.remove(documentLockClass);
+        if (!bodyWasLocked)
+            document.body.classList.remove(documentLockClass);
+        restoreScroll();
+    };
+    const lock = { count: 1, restore };
+    terminalDocumentLocks.set(document, lock);
+    try {
+        document.documentElement.classList.add(documentLockClass);
+        document.body.classList.add(documentLockClass);
+        host.addEventListener("scroll", retainScroll, true);
+    }
+    catch (error) {
+        restore();
+        throw error;
+    }
+    return bindTerminalDocumentRelease(host, lock);
+};
+/** Locks document scroll and fits the terminal to the visual viewport until cleanup. */
+export const bindTerminalViewport = (target, host, topBoundary, lockDocument = true) => {
+    const releaseDocumentLock = lockDocument ? bindTerminalDocumentLock(host) : () => undefined;
+    const viewport = host.visualViewport;
+    if ((viewport === undefined || viewport === null) && topBoundary === undefined)
+        return releaseDocumentLock;
+    const scrollAncestors = [];
+    let scrollAncestor = topBoundary?.parentElement ?? null;
+    while (scrollAncestor !== null) {
+        scrollAncestors.push(scrollAncestor);
+        scrollAncestor = scrollAncestor.parentElement ?? null;
+    }
     const update = () => {
-        target.style.setProperty(viewportHeightProperty, `${String(Math.max(0, viewport.height))}px`);
-        target.style.setProperty(viewportOffsetProperty, `${String(Math.max(0, viewport.offsetTop))}px`);
+        const viewportTop = Math.max(0, viewport?.offsetTop ?? 0);
+        const viewportHeight = Math.max(0, viewport?.height ?? host.innerHeight ?? 0);
+        const viewportBottom = viewportTop + viewportHeight;
+        const boundaryTop = Math.max(viewportTop, topBoundary?.getBoundingClientRect().top ?? viewportTop);
+        target.style.setProperty(viewportHeightProperty, `${String(Math.max(0, viewportBottom - boundaryTop))}px`);
+        target.style.setProperty(viewportOffsetProperty, `${String(boundaryTop)}px`);
+    };
+    const releaseGeometry = () => {
+        viewport?.removeEventListener("resize", update);
+        viewport?.removeEventListener("scroll", update);
+        if (topBoundary !== undefined) {
+            host.removeEventListener("resize", update);
+            host.removeEventListener("scroll", update, true);
+            for (const ancestor of scrollAncestors)
+                ancestor.removeEventListener("scroll", update, true);
+        }
     };
-    viewport.addEventListener("resize", update);
-    viewport.addEventListener("scroll", update);
-    update();
+    try {
+        viewport?.addEventListener("resize", update);
+        viewport?.addEventListener("scroll", update);
+        if (topBoundary !== undefined) {
+            host.addEventListener("resize", update);
+            host.addEventListener("scroll", update, true);
+            for (const ancestor of scrollAncestors)
+                ancestor.addEventListener("scroll", update, true);
+        }
+        update();
+    }
+    catch (error) {
+        releaseGeometry();
+        releaseDocumentLock();
+        throw error;
+    }
+    let released = false;
     return () => {
-        viewport.removeEventListener("resize", update);
-        viewport.removeEventListener("scroll", update);
-        target.style.removeProperty(viewportHeightProperty);
-        target.style.removeProperty(viewportOffsetProperty);
+        if (released)
+            return;
+        released = true;
+        try {
+            releaseGeometry();
+            target.style.removeProperty(viewportHeightProperty);
+            target.style.removeProperty(viewportOffsetProperty);
+        }
+        finally {
+            releaseDocumentLock();
+        }
     };
 };
 //# sourceMappingURL=terminal-viewport.js.map

package/dist/terminal-viewport.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-viewport.js","sourceRoot":"","sources":["../src/terminal-viewport.ts"],"names":[],"mappings":"AAaA,MAAM,sBAAsB,GAAG,kCAAkC,CAAA;AACjE,MAAM,sBAAsB,GAAG,kCAAkC,CAAA;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAA8B,EAC9B,IAA0B,EACd,EAAE;IACd,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAA;IACpC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAA;IAEvE,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,sBAAsB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;QAC7F,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,sBAAsB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAA;IAClG,CAAC,CAAA;IAED,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3C,MAAM,EAAE,CAAA;IAER,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9C,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAA;IACrD,CAAC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"terminal-viewport.js","sourceRoot":"","sources":["../src/terminal-viewport.ts"],"names":[],"mappings":"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"}

package/dist/terminal-worker-guard.d.ts

@@ -0,0 +1,7 @@
+export interface TerminalWorkerGuard {
+    readonly accepts: (currentRequestId: number) => boolean;
+    readonly release: () => void;
+}
+/** Rejects callbacks after an effect cleanup, even when a remount reuses the persisted request id. */
+export declare const makeTerminalWorkerGuard: (ownedRequestId: number) => TerminalWorkerGuard;
+//# sourceMappingURL=terminal-worker-guard.d.ts.map

package/dist/terminal-worker-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-worker-guard.d.ts","sourceRoot":"","sources":["../src/terminal-worker-guard.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAA;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,sGAAsG;AACtG,eAAO,MAAM,uBAAuB,mBAAoB,MAAM,KAAG,mBAQhE,CAAA"}

package/dist/terminal-worker-guard.js

@@ -0,0 +1,11 @@
+/** Rejects callbacks after an effect cleanup, even when a remount reuses the persisted request id. */
+export const makeTerminalWorkerGuard = (ownedRequestId) => {
+    let active = true;
+    return {
+        accepts: (currentRequestId) => active && currentRequestId === ownedRequestId,
+        release: () => {
+            active = false;
+        }
+    };
+};
+//# sourceMappingURL=terminal-worker-guard.js.map

package/dist/terminal-worker-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-worker-guard.js","sourceRoot":"","sources":["../src/terminal-worker-guard.ts"],"names":[],"mappings":"AAKA,sGAAsG;AACtG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,cAAsB,EAAuB,EAAE;IACrF,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,OAAO;QACL,OAAO,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAAC,MAAM,IAAI,gBAAgB,KAAK,cAAc;QAC5E,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,GAAG,KAAK,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}