@hex1b/web-terminal 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { WebTerminal } from \"./web-terminal.js\";\nexport { InputRoute, TerminalAction, defaultInputBindings } from \"./input-policy.js\";\nexport { MIN_FONT_SIZE, MAX_FONT_SIZE } from \"./terminal-sizing.js\";\nexport type * from \"./types.js\";\n"]}

package/dist/input-policy.d.ts

@@ -0,0 +1,42 @@
+export declare const InputRoute: Readonly<{
+    Continue: "continue";
+    Consume: "consume";
+    Application: "application";
+    Browser: "browser";
+}>;
+export declare const TerminalAction: Readonly<{
+    CopySelection: "copySelection";
+    PasteClipboard: "pasteClipboard";
+    CopyOrPaste: "copyOrPaste";
+    ClearSelection: "clearSelection";
+    ScrollToLive: "scrollToLive";
+    ScrollLines: "scrollLines";
+}>;
+/** Fresh, inspectable defaults. Overrides are per mounted view, never global. */
+export declare function defaultInputBindings(): InputBinding[];
+/** Resolves intent only. DOM cancellation and action execution belong to the mounted view. */
+export declare class InputPolicy {
+    #private;
+    constructor({ inputBindings, onInput, actions }?: InputPolicyOptions);
+    get bindings(): ({
+        id: string;
+        match: (input: Readonly<TerminalInput>, context: TerminalInputContext) => boolean;
+        when?: (context: TerminalInputContext, input: Readonly<TerminalInput>) => boolean;
+        remove?: false;
+        route: InputRouteValue;
+        action?: never;
+        args?: never;
+    } | {
+        id: string;
+        match: (input: Readonly<TerminalInput>, context: TerminalInputContext) => boolean;
+        when?: (context: TerminalInputContext, input: Readonly<TerminalInput>) => boolean;
+        remove?: false;
+        action: string | InputActionHandler;
+        args?: unknown;
+        route?: never;
+    })[];
+    resolve(input: Readonly<TerminalInput>, context: TerminalInputContext): InputDecision;
+}
+export declare function inputModifiers(event: Pick<KeyboardEvent, "ctrlKey" | "altKey" | "shiftKey" | "metaKey">): InputModifiers;
+import type { InputActionHandler, InputBinding, InputDecision, InputModifiers, InputPolicyOptions, InputRouteValue, TerminalInput, TerminalInputContext } from "./types.js";
+//# sourceMappingURL=input-policy.d.ts.map

package/dist/input-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-policy.d.ts","sourceRoot":"","sources":["../src/input-policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;EAErB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;EAGzB,CAAC;AASH,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,YAAY,EAAE,CA2BrD;AAOD,8FAA8F;AAC9F,qBAAa,WAAW;;gBAKV,EAAE,aAAkB,EAAE,OAAO,EAAE,OAAY,EAAE,GAAE,kBAAuB;IAgClF,IAAI,QAAQ;;;;;;;;;;;;;;;;SAA8D;IAkB1E,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa;CAoBtF;AAUD,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,cAAc,CAExH;AACD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAwB,aAAa,EAAE,cAAc,EACjG,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/input-policy.js

@@ -0,0 +1,143 @@
+export const InputRoute = Object.freeze({
+    Continue: "continue", Consume: "consume", Application: "application", Browser: "browser"
+});
+export const TerminalAction = Object.freeze({
+    CopySelection: "copySelection", PasteClipboard: "pasteClipboard", CopyOrPaste: "copyOrPaste",
+    ClearSelection: "clearSelection", ScrollToLive: "scrollToLive", ScrollLines: "scrollLines"
+});
+const browserCtrlKeys = new Set(["l", "t", "v", "w", "+", "-", "=", "0"]);
+const browserFunctionKeys = new Set(["F1", "F3", "F5", "F6", "F7", "F10", "F11", "F12"]);
+const terminalKeys = new Set(["Tab", "Enter", "Backspace", "Delete", "Escape", "ArrowUp", "ArrowDown",
+    "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown", "Insert",
+    ...Array.from({ length: 12 }, (_, index) => `F${index + 1}`)]);
+const routes = new Set(Object.values(InputRoute));
+/** Fresh, inspectable defaults. Overrides are per mounted view, never global. */
+export function defaultInputBindings() {
+    return [
+        {
+            id: "clipboard.copy-key",
+            match: input => input.type === "key" && input.key.toLowerCase() === "c" && !input.alt &&
+                ((input.meta && !input.ctrl) || (input.ctrl && input.shift && !input.meta)),
+            action: TerminalAction.CopySelection
+        },
+        {
+            id: "browser.shortcuts",
+            match: input => input.type === "key" && (input.meta || browserFunctionKeys.has(input.key) ||
+                (input.ctrl && (input.key === "Tab" || input.key === "F4" || browserCtrlKeys.has(input.key.toLowerCase()) ||
+                    (input.shift && input.key.length === 1))) || (input.alt && !input.ctrl)),
+            route: InputRoute.Browser
+        },
+        {
+            id: "terminal.keys",
+            match: input => input.type === "key" && (terminalKeys.has(input.key) || (input.ctrl && input.key.length === 1)),
+            route: InputRoute.Application
+        },
+        {
+            id: "clipboard.context-click",
+            match: (input, context) => input.type === "pointer" && input.button === "right" && !input.meta &&
+                (!context.mouseCaptured || input.shift || context.historical || context.readOnly),
+            action: TerminalAction.CopyOrPaste
+        }
+    ];
+}
+function synchronous(callback, name) {
+    if (typeof callback !== "function" || callback.constructor.name === "AsyncFunction")
+        throw new TypeError(`${name} must be a synchronous function`);
+}
+/** Resolves intent only. DOM cancellation and action execution belong to the mounted view. */
+export class InputPolicy {
+    #bindings;
+    #intercept;
+    #actions;
+    constructor({ inputBindings = [], onInput, actions = {} } = {}) {
+        if (!Array.isArray(inputBindings))
+            throw new TypeError("inputBindings must be an array");
+        if (!actions || typeof actions !== "object" || Array.isArray(actions))
+            throw new TypeError("actions must be an object");
+        this.#actions = new Set(Object.values(TerminalAction));
+        for (const [name, handler] of Object.entries(actions)) {
+            if (!name || this.#actions.has(name) || typeof handler !== "function")
+                throw new TypeError(`Invalid or reserved action: ${name}`);
+            this.#actions.add(name);
+        }
+        if (onInput !== undefined)
+            synchronous(onInput, "onInput");
+        this.#intercept = onInput;
+        const defaults = defaultInputBindings();
+        const ids = new Set();
+        const overrides = inputBindings.map((binding) => {
+            if (!binding || typeof binding.id !== "string" || !binding.id || ids.has(binding.id))
+                throw new TypeError("Each input binding needs a unique, nonempty id");
+            ids.add(binding.id);
+            if (binding.remove === true) {
+                if (!defaults.some(item => item.id === binding.id))
+                    throw new TypeError(`Cannot remove unknown default binding: ${binding.id}`);
+                if (Object.keys(binding).some(key => !["id", "remove"].includes(key)))
+                    throw new TypeError(`Removed binding ${binding.id} must contain only id and remove`);
+                return null;
+            }
+            synchronous(binding.match, `Binding ${binding.id}.match`);
+            if (binding.when !== undefined)
+                synchronous(binding.when, `Binding ${binding.id}.when`);
+            this.#decision(binding);
+            return Object.freeze({ ...binding });
+        }).filter((binding) => binding !== null);
+        this.#bindings = [...overrides, ...defaults.filter(binding => !ids.has(binding.id))];
+    }
+    get bindings() { return this.#bindings.map(binding => ({ ...binding })); }
+    #decision(value) {
+        if (isRoute(value))
+            return { route: value };
+        if (!isRecord(value) || typeof value.then === "function")
+            throw new TypeError("Input routing must synchronously return a route or action");
+        const hasAction = Object.hasOwn(value, "action");
+        const hasRoute = Object.hasOwn(value, "route");
+        if (hasAction === hasRoute)
+            throw new TypeError("Specify exactly one action or route");
+        if (hasRoute) {
+            if (!isRoute(value.route))
+                throw new TypeError(`Unknown input route: ${String(value.route)}`);
+            return { route: value.route };
+        }
+        if (!isActionHandler(value.action) && (typeof value.action !== "string" || !this.#actions.has(value.action)))
+            throw new TypeError(`Unknown terminal action: ${String(value.action)}`);
+        return { action: value.action, args: value.args };
+    }
+    resolve(input, context) {
+        const intercepted = this.#intercept?.(input, context);
+        if (intercepted !== undefined) {
+            const decision = this.#decision(intercepted);
+            if (decision.route !== InputRoute.Continue)
+                return decision;
+        }
+        for (const binding of this.#bindings) {
+            const matched = binding.match(input, context);
+            if (typeof matched !== "boolean")
+                throw new TypeError(`Binding ${binding.id}.match must return a boolean`);
+            if (!matched)
+                continue;
+            if (binding.when) {
+                const enabled = binding.when(context, input);
+                if (typeof enabled !== "boolean")
+                    throw new TypeError(`Binding ${binding.id}.when must return a boolean`);
+                if (!enabled)
+                    continue;
+            }
+            const decision = this.#decision(binding);
+            if (decision.route !== InputRoute.Continue)
+                return decision;
+        }
+        return { route: InputRoute.Continue };
+    }
+}
+function isRoute(value) {
+    return typeof value === "string" && [...routes].some(route => route === value);
+}
+function isActionHandler(value) {
+    return typeof value === "function";
+}
+export function inputModifiers(event) {
+    return { ctrl: !!event.ctrlKey, alt: !!event.altKey, shift: !!event.shiftKey, meta: !!event.metaKey };
+}
+import { isRecord } from "./validation.js";
+//# sourceMappingURL=input-policy.js.map

package/dist/input-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-policy.js","sourceRoot":"","sources":["../src/input-policy.ts"],"names":[],"mappings":"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","sourcesContent":["export const InputRoute = Object.freeze({\n  Continue: \"continue\", Consume: \"consume\", Application: \"application\", Browser: \"browser\"\n});\n\nexport const TerminalAction = Object.freeze({\n  CopySelection: \"copySelection\", PasteClipboard: \"pasteClipboard\", CopyOrPaste: \"copyOrPaste\",\n  ClearSelection: \"clearSelection\", ScrollToLive: \"scrollToLive\", ScrollLines: \"scrollLines\"\n});\n\nconst browserCtrlKeys = new Set([\"l\", \"t\", \"v\", \"w\", \"+\", \"-\", \"=\", \"0\"]);\nconst browserFunctionKeys = new Set([\"F1\", \"F3\", \"F5\", \"F6\", \"F7\", \"F10\", \"F11\", \"F12\"]);\nconst terminalKeys = new Set([\"Tab\", \"Enter\", \"Backspace\", \"Delete\", \"Escape\", \"ArrowUp\", \"ArrowDown\",\n  \"ArrowLeft\", \"ArrowRight\", \"Home\", \"End\", \"PageUp\", \"PageDown\", \"Insert\",\n  ...Array.from({ length: 12 }, (_, index) => `F${index + 1}`)]);\nconst routes = new Set(Object.values(InputRoute));\n\n/** Fresh, inspectable defaults. Overrides are per mounted view, never global. */\nexport function defaultInputBindings(): InputBinding[] {\n  return [\n    {\n      id: \"clipboard.copy-key\",\n      match: input => input.type === \"key\" && input.key.toLowerCase() === \"c\" && !input.alt &&\n        ((input.meta && !input.ctrl) || (input.ctrl && input.shift && !input.meta)),\n      action: TerminalAction.CopySelection\n    },\n    {\n      id: \"browser.shortcuts\",\n      match: input => input.type === \"key\" && (input.meta || browserFunctionKeys.has(input.key) ||\n        (input.ctrl && (input.key === \"Tab\" || input.key === \"F4\" || browserCtrlKeys.has(input.key.toLowerCase()) ||\n          (input.shift && input.key.length === 1))) || (input.alt && !input.ctrl)),\n      route: InputRoute.Browser\n    },\n    {\n      id: \"terminal.keys\",\n      match: input => input.type === \"key\" && (terminalKeys.has(input.key) || (input.ctrl && input.key.length === 1)),\n      route: InputRoute.Application\n    },\n    {\n      id: \"clipboard.context-click\",\n      match: (input, context) => input.type === \"pointer\" && input.button === \"right\" && !input.meta &&\n        (!context.mouseCaptured || input.shift || context.historical || context.readOnly),\n      action: TerminalAction.CopyOrPaste\n    }\n  ];\n}\n\nfunction synchronous(callback: unknown, name: string): void {\n  if (typeof callback !== \"function\" || callback.constructor.name === \"AsyncFunction\")\n    throw new TypeError(`${name} must be a synchronous function`);\n}\n\n/** Resolves intent only. DOM cancellation and action execution belong to the mounted view. */\nexport class InputPolicy {\n  #bindings: InputBinding[];\n  #intercept: InputPolicyOptions[\"onInput\"];\n  #actions: Set<string>;\n\n  constructor({ inputBindings = [], onInput, actions = {} }: InputPolicyOptions = {}) {\n    if (!Array.isArray(inputBindings)) throw new TypeError(\"inputBindings must be an array\");\n    if (!actions || typeof actions !== \"object\" || Array.isArray(actions)) throw new TypeError(\"actions must be an object\");\n    this.#actions = new Set(Object.values(TerminalAction));\n    for (const [name, handler] of Object.entries(actions)) {\n      if (!name || this.#actions.has(name) || typeof handler !== \"function\")\n        throw new TypeError(`Invalid or reserved action: ${name}`);\n      this.#actions.add(name);\n    }\n    if (onInput !== undefined) synchronous(onInput, \"onInput\");\n    this.#intercept = onInput;\n    const defaults = defaultInputBindings();\n    const ids = new Set();\n    const overrides = inputBindings.map((binding: InputBindingOverride): InputBinding | null => {\n      if (!binding || typeof binding.id !== \"string\" || !binding.id || ids.has(binding.id))\n        throw new TypeError(\"Each input binding needs a unique, nonempty id\");\n      ids.add(binding.id);\n      if (binding.remove === true) {\n        if (!defaults.some(item => item.id === binding.id))\n          throw new TypeError(`Cannot remove unknown default binding: ${binding.id}`);\n        if (Object.keys(binding).some(key => ![\"id\", \"remove\"].includes(key)))\n          throw new TypeError(`Removed binding ${binding.id} must contain only id and remove`);\n        return null;\n      }\n      synchronous(binding.match, `Binding ${binding.id}.match`);\n      if (binding.when !== undefined) synchronous(binding.when, `Binding ${binding.id}.when`);\n      this.#decision(binding);\n      return Object.freeze({ ...binding });\n    }).filter((binding): binding is InputBinding => binding !== null);\n    this.#bindings = [...overrides, ...defaults.filter(binding => !ids.has(binding.id))];\n  }\n\n  get bindings() { return this.#bindings.map(binding => ({ ...binding })); }\n\n  #decision(value: unknown): InputDecision {\n    if (isRoute(value)) return { route: value };\n    if (!isRecord(value) || typeof value.then === \"function\")\n      throw new TypeError(\"Input routing must synchronously return a route or action\");\n    const hasAction = Object.hasOwn(value, \"action\");\n    const hasRoute = Object.hasOwn(value, \"route\");\n    if (hasAction === hasRoute) throw new TypeError(\"Specify exactly one action or route\");\n    if (hasRoute) {\n      if (!isRoute(value.route)) throw new TypeError(`Unknown input route: ${String(value.route)}`);\n      return { route: value.route };\n    }\n    if (!isActionHandler(value.action) && (typeof value.action !== \"string\" || !this.#actions.has(value.action)))\n      throw new TypeError(`Unknown terminal action: ${String(value.action)}`);\n    return { action: value.action, args: value.args };\n  }\n\n  resolve(input: Readonly<TerminalInput>, context: TerminalInputContext): InputDecision {\n    const intercepted = this.#intercept?.(input, context);\n    if (intercepted !== undefined) {\n      const decision = this.#decision(intercepted);\n      if (decision.route !== InputRoute.Continue) return decision;\n    }\n    for (const binding of this.#bindings) {\n      const matched = binding.match(input, context);\n      if (typeof matched !== \"boolean\") throw new TypeError(`Binding ${binding.id}.match must return a boolean`);\n      if (!matched) continue;\n      if (binding.when) {\n        const enabled = binding.when(context, input);\n        if (typeof enabled !== \"boolean\") throw new TypeError(`Binding ${binding.id}.when must return a boolean`);\n        if (!enabled) continue;\n      }\n      const decision = this.#decision(binding);\n      if (decision.route !== InputRoute.Continue) return decision;\n    }\n    return { route: InputRoute.Continue };\n  }\n}\n\nfunction isRoute(value: unknown): value is InputRouteValue {\n  return typeof value === \"string\" && [...routes].some(route => route === value);\n}\n\nfunction isActionHandler(value: unknown): value is InputActionHandler {\n  return typeof value === \"function\";\n}\n\nexport function inputModifiers(event: Pick<KeyboardEvent, \"ctrlKey\" | \"altKey\" | \"shiftKey\" | \"metaKey\">): InputModifiers {\n  return { ctrl: !!event.ctrlKey, alt: !!event.altKey, shift: !!event.shiftKey, meta: !!event.metaKey };\n}\nimport type { InputActionHandler, InputBinding, InputBindingOverride, InputDecision, InputModifiers,\n  InputPolicyOptions, InputRouteValue, TerminalInput, TerminalInputContext } from \"./types.js\";\nimport { isRecord } from \"./validation.js\";\n"]}

package/dist/mouse-input.d.ts

@@ -0,0 +1,26 @@
+import type { GestureState } from "./selection-input.js";
+import type { InputDecision, MouseTrackingMode, SelectionMode, TerminalInput, TerminalPoint } from "./types.js";
+import type { MouseCommand } from "./wire-types.js";
+interface MouseInspection {
+    state?: () => Omit<GestureState, "tracking">;
+    begin?: (point: TerminalPoint, selection: {
+        mode: SelectionMode;
+        extend: boolean;
+    }) => void;
+    extend?: (point: TerminalPoint) => void;
+    scroll?: (delta: number, endpoint?: TerminalPoint) => void;
+    end?: (cancelled: boolean) => void;
+    resolve?: (input: TerminalInput) => InputDecision;
+    execute?: (decision: Extract<InputDecision, {
+        action: unknown;
+    }>, input: TerminalInput) => void;
+}
+export interface MouseCapture {
+    update(columns: number, rows: number, tracking: MouseTrackingMode): void;
+    cancel(): void;
+    dispose(): void;
+}
+/** Capture input intent only; the server chooses and encodes the mouse protocol. */
+export declare function captureMouse(canvas: HTMLCanvasElement, send: (command: MouseCommand) => void, focus: () => void, inspection?: MouseInspection): MouseCapture;
+export {};
+//# sourceMappingURL=mouse-input.d.ts.map

package/dist/mouse-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse-input.d.ts","sourceRoot":"","sources":["../src/mouse-input.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAmB,iBAAiB,EAAiB,aAAa,EAC3F,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/E,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5F,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3D,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACjG;AACD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzE,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,EAC3F,KAAK,EAAE,MAAM,IAAI,EAAE,UAAU,GAAE,eAAoB,GAAG,YAAY,CA+SnE"}

package/dist/mouse-input.js

@@ -0,0 +1,356 @@
+import { cellPoint, WheelAccumulator, SelectionGesture } from "./selection-input.js";
+import { InputRoute, inputModifiers } from "./input-policy.js";
+const buttons = [["left", 1], ["middle", 4], ["right", 2]];
+const pointerButtons = ["left", "middle", "right"];
+/** Capture input intent only; the server chooses and encodes the mouse protocol. */
+export function captureMouse(canvas, send, focus, inspection = {}) {
+    const listeners = new AbortController();
+    const options = { signal: listeners.signal };
+    let columns = 1, rows = 1;
+    let tracking = 0;
+    let pointerId = null;
+    const pressed = new Set();
+    let lastPoint;
+    let pendingMove;
+    let lastMove;
+    let scheduled;
+    const wheel = new WheelAccumulator();
+    const gesture = new SelectionGesture();
+    let wheelOwner;
+    let pointerEvent;
+    let autoScroll;
+    let click = { count: 0, time: 0, x: -1, y: -1 };
+    let selectionClick;
+    let completedClick;
+    let routedGesture;
+    let contextMenuRoute;
+    const state = () => ({ tracking, ...inspection.state?.() });
+    function point(event, clamp = false) {
+        return cellPoint(event, canvas.getBoundingClientRect(), columns, rows, clamp);
+    }
+    function updateAutoScroll() {
+        clearTimeout(autoScroll);
+        autoScroll = undefined;
+        if (gesture.owner !== "local" || !pointerEvent)
+            return;
+        const bounds = canvas.getBoundingClientRect();
+        const distance = pointerEvent.clientY < bounds.top ? pointerEvent.clientY - bounds.top
+            : pointerEvent.clientY >= bounds.bottom ? pointerEvent.clientY - bounds.bottom + 1 : 0;
+        if (!distance)
+            return;
+        autoScroll = setTimeout(() => {
+            autoScroll = undefined;
+            if (!pointerEvent)
+                return;
+            const position = point(pointerEvent, true);
+            if (gesture.owner === "local" && position) {
+                if (selectionClick)
+                    selectionClick.dragged = true;
+                click.count = 0;
+                const lines = Math.sign(distance) * Math.min(8, Math.max(1, Math.ceil(Math.abs(distance) / (bounds.height / rows))));
+                inspection.scroll?.(lines, gesture.scrollPoint(position));
+                updateAutoScroll();
+            }
+        }, 60);
+    }
+    function flushMove() {
+        if (scheduled !== undefined)
+            cancelAnimationFrame(scheduled);
+        scheduled = undefined;
+        if (pendingMove)
+            send(pendingMove);
+        pendingMove = undefined;
+    }
+    function changeButtons(event, position) {
+        for (const [button, mask] of buttons) {
+            const down = (event.buttons & mask) !== 0;
+            if (down === pressed.has(button))
+                continue;
+            flushMove();
+            if (down)
+                pressed.add(button);
+            else
+                pressed.delete(button);
+            if (down || tracking !== 9)
+                send({ type: "mouse", action: down ? "down" : "up", button, ...position });
+            lastMove = undefined;
+        }
+    }
+    function cancel(report = true, cancelled = true) {
+        inspection.end?.(cancelled);
+        clearTimeout(autoScroll);
+        autoScroll = undefined;
+        pointerEvent = undefined;
+        selectionClick = undefined;
+        completedClick = undefined;
+        gesture.end();
+        routedGesture = undefined;
+        if (report)
+            flushMove();
+        else {
+            if (scheduled !== undefined)
+                cancelAnimationFrame(scheduled);
+            scheduled = undefined;
+            pendingMove = undefined;
+        }
+        if (report && tracking !== 9 && lastPoint) {
+            for (const button of pressed)
+                send({ type: "mouse", action: "up", button, ...lastPoint });
+        }
+        pressed.clear();
+        const captured = pointerId;
+        pointerId = null;
+        if (captured !== null && canvas.hasPointerCapture(captured))
+            canvas.releasePointerCapture(captured);
+        lastMove = undefined;
+        wheel.reset();
+        wheelOwner = undefined;
+    }
+    canvas.addEventListener("pointerdown", event => {
+        if (event.defaultPrevented && pointerId === null)
+            return;
+        if (event.pointerType !== "mouse" || ![0, 1, 2].includes(event.button))
+            return;
+        const position = point(event);
+        if (!position)
+            return;
+        if (pointerId !== null) {
+            if (routedGesture !== InputRoute.Browser)
+                event.preventDefault();
+            if ((gesture.owner === "app" || routedGesture === InputRoute.Application) && pointerId === event.pointerId)
+                changeButtons(event, position);
+            return;
+        }
+        focus();
+        const input = { type: "pointer", button: pointerButtons[event.button],
+            point: Object.freeze({ ...position }), ...inputModifiers(event) };
+        const decision = inspection.resolve?.(input) ?? { route: InputRoute.Continue };
+        const route = decision.action !== undefined ? InputRoute.Consume : decision.route;
+        contextMenuRoute = event.button === 2 ? route : undefined;
+        if (route !== InputRoute.Continue) {
+            completedClick = selectionClick = undefined;
+            click.count = 0;
+            routedGesture = route;
+            pointerId = event.pointerId;
+            lastPoint = position;
+            canvas.setPointerCapture(pointerId);
+            if (route !== InputRoute.Browser)
+                event.preventDefault();
+            if (route === InputRoute.Application)
+                flushMove();
+            else {
+                if (scheduled !== undefined)
+                    cancelAnimationFrame(scheduled);
+                scheduled = undefined;
+                pendingMove = undefined;
+            }
+            if (route === InputRoute.Application)
+                changeButtons(event, position);
+            if (decision.action !== undefined)
+                inspection.execute?.(decision, input);
+            return;
+        }
+        // Keep focus on the hidden keyboard input instead of the canvas.
+        event.preventDefault();
+        if (event.metaKey)
+            return;
+        const now = performance.now();
+        click.count = now - click.time < 500 && position.x === click.x && position.y === click.y
+            ? click.count % 3 + 1 : 1;
+        click = { count: click.count, time: now, x: position.x, y: position.y };
+        const start = gesture.begin({ button: event.button, shiftKey: event.shiftKey, altKey: event.altKey,
+            detail: event.detail || click.count }, position, state());
+        if (!start)
+            return;
+        pointerId = event.pointerId;
+        pointerEvent = event;
+        lastPoint = position;
+        completedClick = undefined;
+        canvas.setPointerCapture(pointerId);
+        if (start.owner === "local") {
+            if (scheduled !== undefined)
+                cancelAnimationFrame(scheduled);
+            scheduled = undefined;
+            pendingMove = undefined;
+            lastMove = undefined;
+            selectionClick = { point: position, mode: start.mode, extend: start.extend, dragged: false };
+            inspection.begin?.(position, start);
+        }
+        else
+            changeButtons(event, position);
+    }, options);
+    canvas.addEventListener("pointermove", event => {
+        if (event.pointerType !== "mouse")
+            return;
+        if (pointerId === null && event.buttons)
+            return;
+        if (pointerId !== null && pointerId !== event.pointerId)
+            return;
+        const position = point(event, pointerId !== null);
+        if (!position)
+            return;
+        lastPoint = position;
+        if (routedGesture && routedGesture !== InputRoute.Application)
+            return;
+        if (gesture.owner === "local") {
+            pointerEvent = event;
+            const previous = gesture.endpoint;
+            const endpoint = gesture.move(position);
+            if (endpoint && previous && (endpoint.x !== previous.x || endpoint.y !== previous.y)) {
+                click.count = 0;
+                if (selectionClick)
+                    selectionClick.dragged = true;
+                inspection.extend?.(endpoint);
+            }
+            updateAutoScroll();
+            return;
+        }
+        if (!tracking || (!routedGesture && gesture.owner === null && (state().historical || state().readOnly || event.shiftKey)))
+            return;
+        if (pointerId === event.pointerId)
+            changeButtons(event, position);
+        if (event.metaKey || (tracking !== 1003 && !(tracking === 1002 && pressed.size)))
+            return;
+        const button = buttons.find(([name]) => pressed.has(name))?.[0] ?? "none";
+        const move = { type: "mouse", action: "move", button, ...position };
+        const key = JSON.stringify(move);
+        if (key === lastMove)
+            return;
+        lastMove = key;
+        pendingMove = move;
+        if (scheduled === undefined)
+            scheduled = requestAnimationFrame(flushMove);
+    }, options);
+    canvas.addEventListener("pointerup", event => {
+        if (pointerId !== event.pointerId)
+            return;
+        const position = point(event, true) ?? lastPoint;
+        if (routedGesture) {
+            if (routedGesture === InputRoute.Application && position)
+                changeButtons(event, position);
+            if (event.buttons === 0)
+                cancel(routedGesture === InputRoute.Application);
+            return;
+        }
+        if (gesture.owner === "local") {
+            if (position && gesture.endpoint && (position.x !== gesture.endpoint.x || position.y !== gesture.endpoint.y)) {
+                if (selectionClick)
+                    selectionClick.dragged = true;
+                const endpoint = gesture.move(position);
+                if (endpoint)
+                    inspection.extend?.(endpoint);
+            }
+            const completed = selectionClick;
+            cancel(false, false);
+            completedClick = completed;
+            return;
+        }
+        if (position)
+            changeButtons(event, position);
+        if (!pressed.size)
+            cancel();
+    }, options);
+    canvas.addEventListener("click", event => {
+        const completed = completedClick;
+        completedClick = undefined;
+        if (!completed || completed.dragged || !Number.isInteger(event.detail) || event.detail < 1)
+            return;
+        click.count = event.detail;
+        // Some browsers expose native multiclick counts only on click, not pointerdown.
+        const mode = event.detail >= 3 ? "line" : event.detail === 2 ? "word" : "character";
+        if (!completed.extend && completed.mode !== "rectangle" && mode !== completed.mode)
+            inspection.begin?.(completed.point, { mode, extend: false });
+    }, options);
+    canvas.addEventListener("pointercancel", () => cancel(), options);
+    canvas.addEventListener("lostpointercapture", () => {
+        if (pointerId !== null)
+            cancel();
+    }, options);
+    window.addEventListener("blur", () => cancel(), options);
+    canvas.addEventListener("contextmenu", event => {
+        if (contextMenuRoute !== undefined && contextMenuRoute !== InputRoute.Continue) {
+            const route = contextMenuRoute;
+            contextMenuRoute = undefined;
+            if (route !== InputRoute.Browser)
+                event.preventDefault();
+            return;
+        }
+        if (tracking || gesture.owner === "local")
+            event.preventDefault();
+    }, options);
+    canvas.addEventListener("wheel", event => {
+        const input = { type: "wheel", deltaX: event.deltaX, deltaY: event.deltaY,
+            deltaMode: event.deltaMode, point: point(event), ...inputModifiers(event) };
+        const decision = pointerId === null
+            ? inspection.resolve?.(input) ?? { route: InputRoute.Continue }
+            : { route: routedGesture ?? InputRoute.Continue };
+        if (decision.route === InputRoute.Browser)
+            return;
+        if (decision.action !== undefined || decision.route === InputRoute.Consume) {
+            event.preventDefault();
+            if (decision.action !== undefined)
+                inspection.execute?.(decision, input);
+            return;
+        }
+        // Ctrl+wheel (including trackpad pinch) remains browser zoom.
+        if (decision.route !== InputRoute.Application && (event.ctrlKey || event.metaKey))
+            return;
+        const owner = decision.route === InputRoute.Application ? "app" : gesture.wheelOwner(event, state());
+        if (owner === "app" && tracking === 9)
+            return;
+        const position = point(gesture.owner === "local" && pointerEvent ? pointerEvent : event, gesture.owner === "local");
+        if (!position)
+            return;
+        event.preventDefault();
+        flushMove();
+        const bounds = canvas.getBoundingClientRect();
+        if (wheelOwner !== owner)
+            wheel.reset();
+        wheelOwner = owner;
+        const { x: horizontal, y: vertical } = wheel.take(event, bounds, rows);
+        if (owner === "local") {
+            if (vertical) {
+                if (selectionClick)
+                    selectionClick.dragged = true;
+                click.count = 0;
+                inspection.scroll?.(vertical, gesture.scrollPoint(position));
+            }
+            return;
+        }
+        const wheelDirections = [
+            [vertical, "wheelUp", "wheelDown"],
+            [horizontal, "wheelLeft", "wheelRight"]
+        ];
+        for (const [steps, negative, positive] of wheelDirections) {
+            if (steps)
+                send({
+                    type: "mouse", action: "wheel", button: steps < 0 ? negative : positive,
+                    count: Math.min(32, Math.abs(steps)), ...position
+                });
+        }
+    }, { ...options, passive: false });
+    return {
+        update(nextColumns, nextRows, nextTracking) {
+            if (columns !== nextColumns || rows !== nextRows || tracking !== nextTracking) {
+                if (lastPoint) {
+                    lastPoint = { ...lastPoint,
+                        x: Math.min(lastPoint.x, nextColumns - 1),
+                        y: Math.min(lastPoint.y, nextRows - 1)
+                    };
+                }
+                // Application mode changes do not transfer ownership mid-gesture.
+                if (columns !== nextColumns || rows !== nextRows)
+                    cancel(nextTracking !== 0);
+                columns = nextColumns;
+                rows = nextRows;
+                tracking = nextTracking;
+            }
+        },
+        cancel() { cancel(); },
+        dispose() {
+            cancel(false);
+            listeners.abort();
+        }
+    };
+}
+//# sourceMappingURL=mouse-input.js.map