@hex1b/web-terminal 0.1.0

package/dist/terminal-sizing.js

@@ -0,0 +1,38 @@
+export const MIN_FONT_SIZE = 8;
+export const MAX_FONT_SIZE = 32;
+const NATIVE_FONT_SIZE = 16;
+export function dimensions(columns, rows) {
+    if (!Number.isInteger(columns) || columns < 20 || columns > 300 ||
+        !Number.isInteger(rows) || rows < 10 || rows > 100) {
+        throw new RangeError("Requested grid must be 20-300 columns by 10-100 rows");
+    }
+    return { columns, rows };
+}
+export function normalizeSizing(sizing = { mode: "auto" }, previousFontSize = NATIVE_FONT_SIZE) {
+    if (!sizing || !["auto", "fixed"].includes(sizing.mode)) {
+        throw new TypeError("Sizing mode must be 'auto' or 'fixed'");
+    }
+    const fontSize = sizing.fontSize ?? previousFontSize;
+    if (!Number.isInteger(fontSize) || fontSize < MIN_FONT_SIZE || fontSize > MAX_FONT_SIZE) {
+        throw new RangeError(`Font size must be an integer from ${MIN_FONT_SIZE} to ${MAX_FONT_SIZE}`);
+    }
+    return sizing.mode === "fixed"
+        ? { mode: "fixed", fontSize, ...dimensions(sizing.columns, sizing.rows) }
+        : { mode: "auto", fontSize };
+}
+export function requestedGrid(size, geometry, sizing) {
+    if (sizing.mode === "fixed")
+        return { columns: sizing.columns, rows: sizing.rows };
+    if (size.width <= 0 || size.height <= 0)
+        return null;
+    const scale = sizing.fontSize / NATIVE_FONT_SIZE;
+    return {
+        columns: Math.max(20, Math.min(300, Math.floor(size.width / (geometry.cellWidth * scale)))),
+        rows: Math.max(10, Math.min(100, Math.floor(size.height / (geometry.cellHeight * scale))))
+    };
+}
+export function fittedScale(size, geometry, isPrimary, sizing) {
+    const maximum = isPrimary && sizing.mode === "auto" ? sizing.fontSize / NATIVE_FONT_SIZE : Infinity;
+    return Math.max(0, Math.min(maximum, size.width / (geometry.columns * geometry.cellWidth), size.height / (geometry.rows * geometry.cellHeight)));
+}
+//# sourceMappingURL=terminal-sizing.js.map

package/dist/terminal-sizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-sizing.js","sourceRoot":"","sources":["../src/terminal-sizing.ts"],"names":[],"mappings":"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","sourcesContent":["export const MIN_FONT_SIZE = 8;\nexport const MAX_FONT_SIZE = 32;\nconst NATIVE_FONT_SIZE = 16;\n\nexport function dimensions(columns: number, rows: number): TerminalGrid {\n  if (!Number.isInteger(columns) || columns < 20 || columns > 300 ||\n      !Number.isInteger(rows) || rows < 10 || rows > 100) {\n    throw new RangeError(\"Requested grid must be 20-300 columns by 10-100 rows\");\n  }\n  return { columns, rows };\n}\n\nexport function normalizeSizing(sizing: TerminalSizing = { mode: \"auto\" }, previousFontSize = NATIVE_FONT_SIZE): TerminalSizingState {\n  if (!sizing || ![\"auto\", \"fixed\"].includes(sizing.mode)) {\n    throw new TypeError(\"Sizing mode must be 'auto' or 'fixed'\");\n  }\n  const fontSize = sizing.fontSize ?? previousFontSize;\n  if (!Number.isInteger(fontSize) || fontSize < MIN_FONT_SIZE || fontSize > MAX_FONT_SIZE) {\n    throw new RangeError(`Font size must be an integer from ${MIN_FONT_SIZE} to ${MAX_FONT_SIZE}`);\n  }\n  return sizing.mode === \"fixed\"\n    ? { mode: \"fixed\", fontSize, ...dimensions(sizing.columns, sizing.rows) }\n    : { mode: \"auto\", fontSize };\n}\n\nexport function requestedGrid(size: TerminalSize, geometry: TerminalGeometry, sizing: TerminalSizingState): TerminalGrid | null {\n  if (sizing.mode === \"fixed\") return { columns: sizing.columns, rows: sizing.rows };\n  if (size.width <= 0 || size.height <= 0) return null;\n  const scale = sizing.fontSize / NATIVE_FONT_SIZE;\n  return {\n    columns: Math.max(20, Math.min(300, Math.floor(size.width / (geometry.cellWidth * scale)))),\n    rows: Math.max(10, Math.min(100, Math.floor(size.height / (geometry.cellHeight * scale))))\n  };\n}\n\nexport function fittedScale(size: TerminalSize, geometry: TerminalGeometry, isPrimary: boolean, sizing: TerminalSizingState): number {\n  const maximum = isPrimary && sizing.mode === \"auto\" ? sizing.fontSize / NATIVE_FONT_SIZE : Infinity;\n  return Math.max(0, Math.min(maximum,\n    size.width / (geometry.columns * geometry.cellWidth),\n    size.height / (geometry.rows * geometry.cellHeight)));\n}\nimport type { TerminalGeometry, TerminalGrid, TerminalSize, TerminalSizing, TerminalSizingState } from \"./types.js\";\n"]}

package/dist/terminal-theme.d.ts

@@ -0,0 +1,2 @@
+export declare const terminalThemeCss = "\n  :host {\n    \n  --cp-terminal-surface: #ffffff;\n  --cp-terminal-text: #242424;\n  --cp-terminal-text-muted: #5c5c5c;\n  --cp-terminal-border-strong: #919191;\n  --cp-terminal-accent: #b11f4b;\n  --cp-terminal-accent-soft: rgba(177, 31, 75, 0.08);\n  --cp-terminal-danger: #dc2626;\n\n    --cp-terminal-font-family: \"Segoe UI\", Aptos, Calibri, -apple-system, BlinkMacSystemFont, sans-serif;\n  }\n  @media (prefers-color-scheme: dark) { :host { \n  --cp-terminal-surface: #292929;\n  --cp-terminal-text: #dedede;\n  --cp-terminal-text-muted: #919191;\n  --cp-terminal-border-strong: #5f5f5f;\n  --cp-terminal-accent: #fd8ea1;\n  --cp-terminal-accent-soft: rgba(253, 142, 161, 0.14);\n  --cp-terminal-danger: #f87171;\n } }\n  :host-context([data-theme=\"light\"]) { \n  --cp-terminal-surface: #ffffff;\n  --cp-terminal-text: #242424;\n  --cp-terminal-text-muted: #5c5c5c;\n  --cp-terminal-border-strong: #919191;\n  --cp-terminal-accent: #b11f4b;\n  --cp-terminal-accent-soft: rgba(177, 31, 75, 0.08);\n  --cp-terminal-danger: #dc2626;\n }\n  :host-context([data-theme=\"dark\"]) { \n  --cp-terminal-surface: #292929;\n  --cp-terminal-text: #dedede;\n  --cp-terminal-text-muted: #919191;\n  --cp-terminal-border-strong: #5f5f5f;\n  --cp-terminal-accent: #fd8ea1;\n  --cp-terminal-accent-soft: rgba(253, 142, 161, 0.14);\n  --cp-terminal-danger: #f87171;\n }\n  .viewport {\n    --cp-view-surface: var(--cp-surface, var(--cp-terminal-surface));\n    --cp-view-text: var(--cp-text, var(--cp-terminal-text));\n    --cp-view-text-muted: var(--cp-text-muted, var(--cp-terminal-text-muted));\n    --cp-view-border-strong: var(--cp-border-strong, var(--cp-terminal-border-strong));\n    --cp-view-accent: var(--cp-accent, var(--cp-terminal-accent));\n    --cp-view-accent-soft: var(--cp-accent-soft, var(--cp-terminal-accent-soft));\n    --cp-view-danger: var(--cp-danger, var(--cp-terminal-danger));\n    --cp-view-font-family: var(--cp-font-family, var(--cp-terminal-font-family));\n  }\n";
+//# sourceMappingURL=terminal-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-theme.d.ts","sourceRoot":"","sources":["../src/terminal-theme.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,gBAAgB,28DAkB5B,CAAC"}

package/dist/terminal-theme.js

@@ -0,0 +1,39 @@
+const light = `
+  --cp-terminal-surface: #ffffff;
+  --cp-terminal-text: #242424;
+  --cp-terminal-text-muted: #5c5c5c;
+  --cp-terminal-border-strong: #919191;
+  --cp-terminal-accent: #b11f4b;
+  --cp-terminal-accent-soft: rgba(177, 31, 75, 0.08);
+  --cp-terminal-danger: #dc2626;
+`;
+const dark = `
+  --cp-terminal-surface: #292929;
+  --cp-terminal-text: #dedede;
+  --cp-terminal-text-muted: #919191;
+  --cp-terminal-border-strong: #5f5f5f;
+  --cp-terminal-accent: #fd8ea1;
+  --cp-terminal-accent-soft: rgba(253, 142, 161, 0.14);
+  --cp-terminal-danger: #f87171;
+`;
+// Shared embedding tokens take precedence; defaults never overwrite inherited --cp-* colors.
+export const terminalThemeCss = `
+  :host {
+    ${light}
+    --cp-terminal-font-family: "Segoe UI", Aptos, Calibri, -apple-system, BlinkMacSystemFont, sans-serif;
+  }
+  @media (prefers-color-scheme: dark) { :host { ${dark} } }
+  :host-context([data-theme="light"]) { ${light} }
+  :host-context([data-theme="dark"]) { ${dark} }
+  .viewport {
+    --cp-view-surface: var(--cp-surface, var(--cp-terminal-surface));
+    --cp-view-text: var(--cp-text, var(--cp-terminal-text));
+    --cp-view-text-muted: var(--cp-text-muted, var(--cp-terminal-text-muted));
+    --cp-view-border-strong: var(--cp-border-strong, var(--cp-terminal-border-strong));
+    --cp-view-accent: var(--cp-accent, var(--cp-terminal-accent));
+    --cp-view-accent-soft: var(--cp-accent-soft, var(--cp-terminal-accent-soft));
+    --cp-view-danger: var(--cp-danger, var(--cp-terminal-danger));
+    --cp-view-font-family: var(--cp-font-family, var(--cp-terminal-font-family));
+  }
+`;
+//# sourceMappingURL=terminal-theme.js.map

package/dist/terminal-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-theme.js","sourceRoot":"","sources":["../src/terminal-theme.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG;;;;;;;;CAQb,CAAC;AAEF,MAAM,IAAI,GAAG;;;;;;;;CAQZ,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG;;MAE1B,KAAK;;;kDAGuC,IAAI;0CACZ,KAAK;yCACN,IAAI;;;;;;;;;;;CAW5C,CAAC","sourcesContent":["const light = `\n  --cp-terminal-surface: #ffffff;\n  --cp-terminal-text: #242424;\n  --cp-terminal-text-muted: #5c5c5c;\n  --cp-terminal-border-strong: #919191;\n  --cp-terminal-accent: #b11f4b;\n  --cp-terminal-accent-soft: rgba(177, 31, 75, 0.08);\n  --cp-terminal-danger: #dc2626;\n`;\n\nconst dark = `\n  --cp-terminal-surface: #292929;\n  --cp-terminal-text: #dedede;\n  --cp-terminal-text-muted: #919191;\n  --cp-terminal-border-strong: #5f5f5f;\n  --cp-terminal-accent: #fd8ea1;\n  --cp-terminal-accent-soft: rgba(253, 142, 161, 0.14);\n  --cp-terminal-danger: #f87171;\n`;\n\n// Shared embedding tokens take precedence; defaults never overwrite inherited --cp-* colors.\nexport const terminalThemeCss = `\n  :host {\n    ${light}\n    --cp-terminal-font-family: \"Segoe UI\", Aptos, Calibri, -apple-system, BlinkMacSystemFont, sans-serif;\n  }\n  @media (prefers-color-scheme: dark) { :host { ${dark} } }\n  :host-context([data-theme=\"light\"]) { ${light} }\n  :host-context([data-theme=\"dark\"]) { ${dark} }\n  .viewport {\n    --cp-view-surface: var(--cp-surface, var(--cp-terminal-surface));\n    --cp-view-text: var(--cp-text, var(--cp-terminal-text));\n    --cp-view-text-muted: var(--cp-text-muted, var(--cp-terminal-text-muted));\n    --cp-view-border-strong: var(--cp-border-strong, var(--cp-terminal-border-strong));\n    --cp-view-accent: var(--cp-accent, var(--cp-terminal-accent));\n    --cp-view-accent-soft: var(--cp-accent-soft, var(--cp-terminal-accent-soft));\n    --cp-view-danger: var(--cp-danger, var(--cp-terminal-danger));\n    --cp-view-font-family: var(--cp-font-family, var(--cp-terminal-font-family));\n  }\n`;\n"]}

package/dist/terminal-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-worker.d.ts","sourceRoot":"","sources":["../src/terminal-worker.ts"],"names":[],"mappings":""}

package/dist/terminal-worker.js

@@ -0,0 +1,285 @@
+import { decodeFrame, screenText } from "./protocol.js";
+import { TerminalRenderer } from "./renderer.js";
+import { errorMessage } from "./validation.js";
+let renderer;
+let socket;
+let failed = false;
+let stopped = false;
+let processing = false;
+let drawing = false;
+let frameInFlight = false;
+let scheduled = false;
+let needsRender = false;
+let hasBlink = false;
+let lastBlink = true;
+let metadata;
+let cells = [];
+let localRevision = 0;
+let pendingFrame;
+let renderPromise = Promise.resolve();
+let metricsTimer;
+let blinkTimer;
+let viewport;
+const stats = {
+    revision: 0, fullFrames: 0, frames: 0, presentations: 0,
+    changedCells: 0, lastChangedCells: 0, discardedFrames: 0,
+    imageCount: 0, textureBytes: 0, atlasGlyphs: 0, atlasBytes: 0,
+    bytesReceived: 0, imageUploadBytes: 0, imagePayloadBytes: 0,
+    gpu: "initializing", connected: false, warnings: [],
+    fps: 0, receivedKBps: 0, workloadMBps: 0,
+    captureMs: 0, rendererCpuMs: 0, preparationCpuMs: 0,
+    workloadBytes: 0, outputBatches: 0, serverElapsedMs: 0,
+};
+let sample = { time: performance.now(), presentations: 0, bytes: 0, workload: 0 };
+function postStatus(message, level = "info") {
+    self.postMessage({ type: "status", message, level });
+}
+function send(message) {
+    if (socket?.readyState === WebSocket.OPEN)
+        socket.send(JSON.stringify(message));
+}
+function emitStats(text) {
+    if (renderer && !renderer.disposed)
+        Object.assign(stats, renderer.metrics());
+    self.postMessage({ type: "stats", stats: { ...stats }, ...(text === undefined ? {} : { text }) });
+}
+function fail(error) {
+    if (failed || stopped)
+        return;
+    failed = true;
+    const message = errorMessage(error);
+    stats.gpu = "error";
+    stats.connected = false;
+    clearInterval(metricsTimer);
+    clearInterval(blinkTimer);
+    socket?.close(1011, "Browser renderer failed");
+    emitStats();
+    postStatus(message, "error");
+    renderer?.dispose();
+}
+self.addEventListener("error", event => {
+    event.preventDefault();
+    fail(event.error || new Error(event.message));
+});
+self.addEventListener("unhandledrejection", event => {
+    event.preventDefault();
+    fail(event.reason);
+});
+/** At most one state frame, one decode, and one GPU submission are outstanding. */
+function scheduleRender() {
+    needsRender = true;
+    if (scheduled || drawing || processing || failed || stopped || !metadata)
+        return;
+    scheduled = true;
+    self.requestAnimationFrame(() => {
+        scheduled = false;
+        if (processing || drawing || failed || stopped)
+            return;
+        renderPromise = drawFrame();
+    });
+}
+async function drawFrame() {
+    if (!needsRender || !metadata || !renderer)
+        return;
+    needsRender = false;
+    drawing = true;
+    const frame = pendingFrame;
+    try {
+        renderer.resize(metadata.columns, metadata.rows, viewport);
+        const blink = Math.floor(performance.now() / 600) % 2 === 0;
+        const result = renderer.render(cells, metadata, blink);
+        // This is bounded completion/backpressure, not GPU readback or a GPU timing measurement.
+        await renderer.idle();
+        if (failed || stopped)
+            return;
+        lastBlink = blink;
+        stats.presentations++;
+        stats.rendererCpuMs = result.cpuMs;
+        stats.quads = result.quads;
+        stats.drawCalls = result.drawCalls;
+        stats.warnings = renderer.canvasLimited
+            ? [...metadata.warnings, `Canvas resolution capped by the GPU; terminal grid remains ${metadata.columns}x${metadata.rows}`]
+            : metadata.warnings;
+        if (frame) {
+            pendingFrame = undefined;
+            frameInFlight = false;
+            stats.frames++;
+            if (frame.full)
+                stats.fullFrames++;
+            stats.revision = frame.revision;
+            stats.changedCells += frame.changedCells;
+            stats.lastChangedCells = frame.changedCells;
+            stats.captureMs = metadata.stats.captureMs;
+            stats.workloadBytes = metadata.stats.workloadBytes;
+            stats.outputBatches = metadata.stats.outputBatches;
+            stats.serverElapsedMs = metadata.stats.elapsedMs;
+            stats.columns = metadata.columns;
+            stats.rows = metadata.rows;
+            stats.mouseTracking = metadata.mouseTracking;
+            stats.peer = metadata.peer;
+            stats.history = metadata.history;
+            const text = screenText(cells, metadata.columns, metadata.rows);
+            self.postMessage({
+                type: "geometry", columns: metadata.columns, rows: metadata.rows,
+                cellWidth: metadata.cellWidth, cellHeight: metadata.cellHeight,
+                mouseTracking: metadata.mouseTracking, peer: metadata.peer,
+                history: metadata.history, revision: frame.revision, text
+            });
+            send({ type: "ack", revision: frame.revision });
+            emitStats(text);
+        }
+    }
+    catch (error) {
+        fail(error);
+    }
+    finally {
+        drawing = false;
+        if (needsRender && !processing)
+            scheduleRender();
+    }
+}
+async function receiveFrame(buffer) {
+    if (failed || stopped || !renderer)
+        return;
+    if (frameInFlight)
+        throw new Error("Server sent a second state frame before acknowledgement");
+    frameInFlight = true;
+    processing = true;
+    stats.bytesReceived += buffer.byteLength || 0;
+    try {
+        const frame = decodeFrame(buffer);
+        const next = frame.metadata;
+        if (!next.full && (next.baseRevision !== localRevision || next.revision <= localRevision ||
+            !metadata || next.columns !== metadata.columns || next.rows !== metadata.rows)) {
+            stats.discardedFrames++;
+            frameInFlight = false;
+            // A discarded frame must release the server's one-in-flight gate before resync.
+            send({ type: "ack", revision: next.revision });
+            send({ type: "resync" });
+            postStatus(`Revision mismatch (local ${localRevision}, base ${next.baseRevision}); requesting a full frame`);
+            return;
+        }
+        await renderPromise;
+        if (failed || stopped)
+            return;
+        // No blink presentation may reference textures while this resource transaction is in progress.
+        await renderer.idle();
+        await renderer.updateImages(frame.images, next.retainedImages);
+        if (failed || stopped)
+            return;
+        const preparationStart = performance.now();
+        const nextCells = next.full
+            ? new Array(next.columns * next.rows) : cells.slice();
+        for (const cell of frame.cells)
+            nextCells[cell.index] = cell;
+        renderer.prepareGlyphs(nextCells);
+        cells = nextCells;
+        metadata = next;
+        localRevision = next.revision;
+        pendingFrame = { revision: next.revision, full: next.full, changedCells: frame.cells.length };
+        hasBlink = cells.some(cell => cell && (cell.attributes & 16) && !(cell.attributes & 64)) ||
+            (next.cursor.visible && (next.cursor.shape === 0 || next.cursor.shape % 2 === 1));
+        stats.preparationCpuMs = performance.now() - preparationStart;
+        needsRender = true;
+    }
+    finally {
+        processing = false;
+        if (needsRender)
+            scheduleRender();
+    }
+}
+async function initialize(message) {
+    if (renderer || socket)
+        throw new Error("Worker is already initialized");
+    if (typeof self.requestAnimationFrame !== "function") {
+        throw new Error("This browser does not support requestAnimationFrame in a dedicated OffscreenCanvas worker");
+    }
+    postStatus("Loading terminal font and initializing WebGPU...");
+    renderer = await TerminalRenderer.create(message.canvas, message.scale, fail, message.font);
+    if (failed || stopped) {
+        renderer?.dispose();
+        return;
+    }
+    stats.gpu = "ready";
+    stats.backingScale = message.scale;
+    emitStats();
+    postStatus("WebGPU ready. Attaching terminal view...");
+    const url = new URL(message.url);
+    if (!["ws:", "wss:"].includes(url.protocol)) {
+        throw new Error("The terminal WebSocket URL must use ws: or wss:");
+    }
+    socket = new WebSocket(url);
+    socket.binaryType = "arraybuffer";
+    socket.addEventListener("open", () => {
+        if (failed || stopped)
+            return;
+        stats.connected = true;
+        self.postMessage({ type: "connected" });
+        postStatus("Connected · WebGPU worker · server-authoritative cells and graphics", "ready");
+        emitStats();
+    });
+    socket.addEventListener("message", event => {
+        if (!(event.data instanceof ArrayBuffer)) {
+            fail(new Error(`Expected binary HWT1 frame, received ${String(event.data).slice(0, 200)}`));
+            return;
+        }
+        receiveFrame(event.data).catch(fail);
+    });
+    socket.addEventListener("error", () => fail(new Error("WebSocket connection failed; verify the demo server is running")));
+    socket.addEventListener("close", event => {
+        stats.connected = false;
+        if (!failed && !stopped) {
+            stats.gpu = "stopped";
+            stats.fps = 0;
+            postStatus(`View disconnected (${event.code}${event.reason ? `: ${event.reason}` : ""}). Attach another view to reconnect.`, "error");
+            emitStats();
+            stopped = true;
+            clearInterval(metricsTimer);
+            clearInterval(blinkTimer);
+            renderer?.dispose();
+            self.postMessage({ type: "disconnected" });
+        }
+    });
+    metricsTimer = setInterval(() => {
+        const now = performance.now();
+        const seconds = (now - sample.time) / 1000;
+        stats.fps = (stats.presentations - sample.presentations) / seconds;
+        stats.receivedKBps = (stats.bytesReceived - sample.bytes) / seconds / 1000;
+        stats.workloadMBps = Math.max(0, stats.workloadBytes - sample.workload) / seconds / 1000000;
+        sample = { time: now, presentations: stats.presentations, bytes: stats.bytesReceived, workload: stats.workloadBytes };
+        emitStats();
+    }, 1000);
+    blinkTimer = setInterval(() => {
+        const blinkOn = Math.floor(performance.now() / 600) % 2 === 0;
+        if (hasBlink && blinkOn !== lastBlink)
+            scheduleRender();
+    }, 100);
+}
+self.addEventListener("message", event => {
+    const message = event.data;
+    if (message.type === "init") {
+        initialize(message).catch(fail);
+    }
+    else if (message.type === "stop") {
+        stopped = true;
+        clearInterval(metricsTimer);
+        clearInterval(blinkTimer);
+        socket?.close(1000, "View detached");
+        renderer?.dispose();
+        self.close();
+    }
+    else if (message.type === "viewport" && !failed && !stopped) {
+        if (!Number.isFinite(message.width) || !Number.isFinite(message.height) || message.width < 0 || message.height < 0) {
+            fail(new Error("Invalid mounted viewport dimensions"));
+            return;
+        }
+        if (viewport?.width === message.width && viewport?.height === message.height)
+            return;
+        viewport = { width: message.width, height: message.height };
+        scheduleRender();
+    }
+    else if (message.type === "command" && !failed && !stopped) {
+        send(message.command);
+    }
+});
+//# sourceMappingURL=terminal-worker.js.map

package/dist/terminal-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-worker.js","sourceRoot":"","sources":["../src/terminal-worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { decodeFrame, screenText } from \"./protocol.js\";\nimport { TerminalRenderer } from \"./renderer.js\";\nimport type { TerminalSize, TerminalStatusLevel } from \"./types.js\";\nimport type { FrameMetadata, TerminalCell, TerminalCommand, WorkerInputMessage, WorkerOutputMessage, WorkerStats } from \"./wire-types.js\";\nimport { errorMessage } from \"./validation.js\";\n\n// This module is only executed as a dedicated worker. Keeping its global local to\n// this module avoids leaking worker/WebGPU ambient dependencies to public declarations.\ndeclare const self: {\n  postMessage(message: WorkerOutputMessage): void;\n  requestAnimationFrame(callback: FrameRequestCallback): number;\n  close(): void;\n  addEventListener(type: \"error\", callback: (event: ErrorEvent) => void): void;\n  addEventListener(type: \"unhandledrejection\", callback: (event: PromiseRejectionEvent) => void): void;\n  addEventListener(type: \"message\", callback: (event: MessageEvent<WorkerInputMessage>) => void): void;\n};\n\nlet renderer: TerminalRenderer | undefined;\nlet socket: WebSocket | undefined;\nlet failed = false;\nlet stopped = false;\nlet processing = false;\nlet drawing = false;\nlet frameInFlight = false;\nlet scheduled = false;\nlet needsRender = false;\nlet hasBlink = false;\nlet lastBlink = true;\nlet metadata: FrameMetadata | undefined;\nlet cells: (TerminalCell | undefined)[] = [];\nlet localRevision = 0;\nlet pendingFrame: { revision: number; full: boolean; changedCells: number } | undefined;\nlet renderPromise = Promise.resolve();\nlet metricsTimer: ReturnType<typeof setInterval> | undefined;\nlet blinkTimer: ReturnType<typeof setInterval> | undefined;\nlet viewport: TerminalSize | undefined;\nconst stats: WorkerStats = {\n  revision: 0, fullFrames: 0, frames: 0, presentations: 0,\n  changedCells: 0, lastChangedCells: 0, discardedFrames: 0,\n  imageCount: 0, textureBytes: 0, atlasGlyphs: 0, atlasBytes: 0,\n  bytesReceived: 0, imageUploadBytes: 0, imagePayloadBytes: 0,\n  gpu: \"initializing\", connected: false, warnings: [],\n  fps: 0, receivedKBps: 0, workloadMBps: 0,\n  captureMs: 0, rendererCpuMs: 0, preparationCpuMs: 0,\n  workloadBytes: 0, outputBatches: 0, serverElapsedMs: 0,\n};\nlet sample = { time: performance.now(), presentations: 0, bytes: 0, workload: 0 };\n\nfunction postStatus(message: string, level: TerminalStatusLevel = \"info\"): void {\n  self.postMessage({ type: \"status\", message, level });\n}\n\nfunction send(message: TerminalCommand): void {\n  if (socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify(message));\n}\n\nfunction emitStats(text?: string): void {\n  if (renderer && !renderer.disposed) Object.assign(stats, renderer.metrics());\n  self.postMessage({ type: \"stats\", stats: { ...stats }, ...(text === undefined ? {} : { text }) });\n}\n\nfunction fail(error: unknown): void {\n  if (failed || stopped) return;\n  failed = true;\n  const message = errorMessage(error);\n  stats.gpu = \"error\";\n  stats.connected = false;\n  clearInterval(metricsTimer);\n  clearInterval(blinkTimer);\n  socket?.close(1011, \"Browser renderer failed\");\n  emitStats();\n  postStatus(message, \"error\");\n  renderer?.dispose();\n}\n\nself.addEventListener(\"error\", event => {\n  event.preventDefault();\n  fail(event.error || new Error(event.message));\n});\nself.addEventListener(\"unhandledrejection\", event => {\n  event.preventDefault();\n  fail(event.reason);\n});\n\n/** At most one state frame, one decode, and one GPU submission are outstanding. */\nfunction scheduleRender() {\n  needsRender = true;\n  if (scheduled || drawing || processing || failed || stopped || !metadata) return;\n  scheduled = true;\n  self.requestAnimationFrame(() => {\n    scheduled = false;\n    if (processing || drawing || failed || stopped) return;\n    renderPromise = drawFrame();\n  });\n}\n\nasync function drawFrame() {\n  if (!needsRender || !metadata || !renderer) return;\n  needsRender = false;\n  drawing = true;\n  const frame = pendingFrame;\n  try {\n    renderer.resize(metadata.columns, metadata.rows, viewport);\n    const blink = Math.floor(performance.now() / 600) % 2 === 0;\n    const result = renderer.render(cells, metadata, blink);\n    // This is bounded completion/backpressure, not GPU readback or a GPU timing measurement.\n    await renderer.idle();\n    if (failed || stopped) return;\n    lastBlink = blink;\n    stats.presentations++;\n    stats.rendererCpuMs = result.cpuMs;\n    stats.quads = result.quads;\n    stats.drawCalls = result.drawCalls;\n    stats.warnings = renderer.canvasLimited\n      ? [...metadata.warnings, `Canvas resolution capped by the GPU; terminal grid remains ${metadata.columns}x${metadata.rows}`]\n      : metadata.warnings;\n    if (frame) {\n      pendingFrame = undefined;\n      frameInFlight = false;\n      stats.frames++;\n      if (frame.full) stats.fullFrames++;\n      stats.revision = frame.revision;\n      stats.changedCells += frame.changedCells;\n      stats.lastChangedCells = frame.changedCells;\n      stats.captureMs = metadata.stats.captureMs;\n      stats.workloadBytes = metadata.stats.workloadBytes;\n      stats.outputBatches = metadata.stats.outputBatches;\n      stats.serverElapsedMs = metadata.stats.elapsedMs;\n      stats.columns = metadata.columns;\n      stats.rows = metadata.rows;\n      stats.mouseTracking = metadata.mouseTracking;\n      stats.peer = metadata.peer;\n      stats.history = metadata.history;\n      const text = screenText(cells, metadata.columns, metadata.rows);\n      self.postMessage({\n        type: \"geometry\", columns: metadata.columns, rows: metadata.rows,\n        cellWidth: metadata.cellWidth, cellHeight: metadata.cellHeight,\n        mouseTracking: metadata.mouseTracking, peer: metadata.peer,\n        history: metadata.history, revision: frame.revision, text\n      });\n      send({ type: \"ack\", revision: frame.revision });\n      emitStats(text);\n    }\n  } catch (error) {\n    fail(error);\n  } finally {\n    drawing = false;\n    if (needsRender && !processing) scheduleRender();\n  }\n}\n\nasync function receiveFrame(buffer: ArrayBuffer): Promise<void> {\n  if (failed || stopped || !renderer) return;\n  if (frameInFlight) throw new Error(\"Server sent a second state frame before acknowledgement\");\n  frameInFlight = true;\n  processing = true;\n  stats.bytesReceived += buffer.byteLength || 0;\n  try {\n    const frame = decodeFrame(buffer);\n    const next = frame.metadata;\n    if (!next.full && (next.baseRevision !== localRevision || next.revision <= localRevision ||\n        !metadata || next.columns !== metadata.columns || next.rows !== metadata.rows)) {\n      stats.discardedFrames++;\n      frameInFlight = false;\n      // A discarded frame must release the server's one-in-flight gate before resync.\n      send({ type: \"ack\", revision: next.revision });\n      send({ type: \"resync\" });\n      postStatus(`Revision mismatch (local ${localRevision}, base ${next.baseRevision}); requesting a full frame`);\n      return;\n    }\n    await renderPromise;\n    if (failed || stopped) return;\n    // No blink presentation may reference textures while this resource transaction is in progress.\n    await renderer.idle();\n    await renderer.updateImages(frame.images, next.retainedImages);\n    if (failed || stopped) return;\n    const preparationStart = performance.now();\n    const nextCells: (TerminalCell | undefined)[] = next.full\n      ? new Array<TerminalCell | undefined>(next.columns * next.rows) : cells.slice();\n    for (const cell of frame.cells) nextCells[cell.index] = cell;\n    renderer.prepareGlyphs(nextCells);\n    cells = nextCells;\n    metadata = next;\n    localRevision = next.revision;\n    pendingFrame = { revision: next.revision, full: next.full, changedCells: frame.cells.length };\n    hasBlink = cells.some(cell => cell && (cell.attributes & 16) && !(cell.attributes & 64)) ||\n      (next.cursor.visible && (next.cursor.shape === 0 || next.cursor.shape % 2 === 1));\n    stats.preparationCpuMs = performance.now() - preparationStart;\n    needsRender = true;\n  } finally {\n    processing = false;\n    if (needsRender) scheduleRender();\n  }\n}\n\nasync function initialize(message: Extract<WorkerInputMessage, { type: \"init\" }>): Promise<void> {\n  if (renderer || socket) throw new Error(\"Worker is already initialized\");\n  if (typeof self.requestAnimationFrame !== \"function\") {\n    throw new Error(\"This browser does not support requestAnimationFrame in a dedicated OffscreenCanvas worker\");\n  }\n  postStatus(\"Loading terminal font and initializing WebGPU...\");\n  renderer = await TerminalRenderer.create(message.canvas, message.scale, fail, message.font);\n  if (failed || stopped) {\n    renderer?.dispose();\n    return;\n  }\n  stats.gpu = \"ready\";\n  stats.backingScale = message.scale;\n  emitStats();\n  postStatus(\"WebGPU ready. Attaching terminal view...\");\n  const url = new URL(message.url);\n  if (![\"ws:\", \"wss:\"].includes(url.protocol)) {\n    throw new Error(\"The terminal WebSocket URL must use ws: or wss:\");\n  }\n  socket = new WebSocket(url);\n  socket.binaryType = \"arraybuffer\";\n  socket.addEventListener(\"open\", () => {\n    if (failed || stopped) return;\n    stats.connected = true;\n    self.postMessage({ type: \"connected\" });\n    postStatus(\"Connected · WebGPU worker · server-authoritative cells and graphics\", \"ready\");\n    emitStats();\n  });\n  socket.addEventListener(\"message\", event => {\n    if (!(event.data instanceof ArrayBuffer)) {\n      fail(new Error(`Expected binary HWT1 frame, received ${String(event.data).slice(0, 200)}`));\n      return;\n    }\n    receiveFrame(event.data).catch(fail);\n  });\n  socket.addEventListener(\"error\", () => fail(new Error(\"WebSocket connection failed; verify the demo server is running\")));\n  socket.addEventListener(\"close\", event => {\n    stats.connected = false;\n    if (!failed && !stopped) {\n      stats.gpu = \"stopped\";\n      stats.fps = 0;\n      postStatus(`View disconnected (${event.code}${event.reason ? `: ${event.reason}` : \"\"}). Attach another view to reconnect.`, \"error\");\n      emitStats();\n      stopped = true;\n      clearInterval(metricsTimer);\n      clearInterval(blinkTimer);\n      renderer?.dispose();\n      self.postMessage({ type: \"disconnected\" });\n    }\n  });\n  metricsTimer = setInterval(() => {\n    const now = performance.now();\n    const seconds = (now - sample.time) / 1000;\n    stats.fps = (stats.presentations - sample.presentations) / seconds;\n    stats.receivedKBps = (stats.bytesReceived - sample.bytes) / seconds / 1000;\n    stats.workloadMBps = Math.max(0, stats.workloadBytes - sample.workload) / seconds / 1000000;\n    sample = { time: now, presentations: stats.presentations, bytes: stats.bytesReceived, workload: stats.workloadBytes };\n    emitStats();\n  }, 1000);\n  blinkTimer = setInterval(() => {\n    const blinkOn = Math.floor(performance.now() / 600) % 2 === 0;\n    if (hasBlink && blinkOn !== lastBlink) scheduleRender();\n  }, 100);\n}\n\nself.addEventListener(\"message\", event => {\n  const message = event.data;\n  if (message.type === \"init\") {\n    initialize(message).catch(fail);\n  } else if (message.type === \"stop\") {\n    stopped = true;\n    clearInterval(metricsTimer);\n    clearInterval(blinkTimer);\n    socket?.close(1000, \"View detached\");\n    renderer?.dispose();\n    self.close();\n  } else if (message.type === \"viewport\" && !failed && !stopped) {\n    if (!Number.isFinite(message.width) || !Number.isFinite(message.height) || message.width < 0 || message.height < 0) {\n      fail(new Error(\"Invalid mounted viewport dimensions\"));\n      return;\n    }\n    if (viewport?.width === message.width && viewport?.height === message.height) return;\n    viewport = { width: message.width, height: message.height };\n    scheduleRender();\n  } else if (message.type === \"command\" && !failed && !stopped) {\n    send(message.command);\n  }\n});\n"]}