@floegence/floeterm-terminal-web 0.13.6 → 0.14.1

package/README.md

@@ -164,10 +164,10 @@ the foreground revision that was active at that exact byte boundary.
 ## Notes
 
 - You must provide a `TerminalTransport` and `TerminalEventSource` for the managed controller.
-- Each `TerminalCore` owns an isolated `ghostty-web` WASM runtime; consumers must not provide or share a Ghostty runtime.
-- `scrollback` is measured in terminal buffer rows, including separately wrapped rows, and accepts integers from 1 through 10,000. Within the supported geometry, Floeterm preserves at least the requested number of buffer rows; it does not trim to an exact physical row count. Floeterm maps that contract to a bounded byte budget for the exact pinned `ghostty-web@0.4.0-next.14.g6a1a50d` release, which currently interprets the value as bytes. The 81,920,000-byte cap limits Ghostty's scrollback arena, not the total memory of a WASM runtime. The mapping is temporary and must be reviewed and removed or updated with any Ghostty upgrade.
+- Each `TerminalCore` owns an isolated `@floegence/ghostty-web` WASM runtime; consumers must not provide or share a Ghostty runtime.
+- `scrollback` is measured in terminal buffer rows, including separately wrapped rows, and accepts integers from 1 through 10,000. Within the supported geometry, Floeterm preserves at least the requested number of buffer rows; it does not trim to an exact physical row count. Floeterm maps that contract to a bounded byte budget for the exact pinned `@floegence/ghostty-web@0.5.0-rc.0` release, which currently interprets the value as bytes. The 81,920,000-byte cap limits Ghostty's scrollback arena, not the total memory of a WASM runtime. The mapping is temporary and must be reviewed and removed or updated with any Ghostty upgrade.
 - Supported terminal geometry is limited to 500 columns. Explicit dimensions above that limit fail, while automatic fitting reports at most 500 columns.
-- Consumer dependency overrides for `ghostty-web` are unsupported. Floeterm's compatibility guard requires the exact package pin so an upstream behavior change cannot silently apply the row-to-byte mapping twice or reactivate the native canvas scrollbar beneath the renderer-neutral DOM control.
+- Consumer dependency overrides for `@floegence/ghostty-web` are unsupported. Floeterm's compatibility guard requires the exact package pin so an upstream behavior change cannot silently apply the row-to-byte mapping twice or reactivate the native canvas scrollbar beneath the renderer-neutral DOM control.
 - `TerminalCore` bridges the hidden textarea used by `ghostty-web`, so soft-keyboard and composition input continue to work on touch devices.
 - The hidden terminal input is mounted in the document viewport plane and anchored from rendered cursor geometry, so native IME candidate windows stay aligned without expanding transformed terminal hosts.
 - Programmatic terminal focus uses no-scroll focus by default, keeping embedded terminals stable inside scaled, projected, or otherwise transformed host surfaces.

package/dist/checkpoint/GhosttyCheckpoint.worker.d.ts

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

package/dist/checkpoint/GhosttyCheckpoint.worker.d.ts.map

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

package/dist/checkpoint/GhosttyCheckpoint.worker.js

@@ -0,0 +1,9 @@
+import { GhosttyCheckpointWorkerRuntime } from './GhosttyCheckpointWorkerRuntime';
+const workerScope = globalThis;
+const runtime = new GhosttyCheckpointWorkerRuntime({
+    postMessage: (message, transfer) => workerScope.postMessage(message, transfer),
+});
+workerScope.addEventListener('message', event => {
+    void runtime.handle(event.data);
+});
+//# sourceMappingURL=GhosttyCheckpoint.worker.js.map

package/dist/checkpoint/GhosttyCheckpoint.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GhosttyCheckpoint.worker.js","sourceRoot":"","sources":["../../src/checkpoint/GhosttyCheckpoint.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,MAAM,WAAW,GAAG,UAGnB,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,8BAA8B,CAAC;IACjD,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC/E,CAAC,CAAC;AAEH,WAAW,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;IAC9C,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC"}

package/dist/checkpoint/GhosttyCheckpointActor.d.ts

@@ -0,0 +1,44 @@
+import type { TerminalHistoryCheckpoint } from '../types.js';
+export type GhosttyCheckpointActorState = 'idle' | 'starting' | 'ready' | 'failed' | 'disposed';
+export interface GhosttyCheckpointChunk {
+    sequence: number;
+    data: Uint8Array;
+    geometryGeneration: number;
+    cols: number;
+    rows: number;
+}
+export type GhosttyAuthoritativeCheckpoint = TerminalHistoryCheckpoint;
+export interface GhosttyCheckpointWorkerLike {
+    postMessage(message: unknown, transfer?: Transferable[]): void;
+    addEventListener(type: 'message' | 'error', listener: EventListener): void;
+    removeEventListener(type: 'message' | 'error', listener: EventListener): void;
+    terminate(): void;
+}
+export interface GhosttyCheckpointActorOptions {
+    createWorker?: () => GhosttyCheckpointWorkerLike;
+    maxQueuedBytes?: number;
+}
+export interface GhosttyCheckpointActorStartOptions {
+    cols: number;
+    rows: number;
+    parserEpoch: number;
+    initialSequence?: number;
+    checkpoint?: GhosttyAuthoritativeCheckpoint;
+}
+export interface GhosttyCheckpointActorSnapshot {
+    state: GhosttyCheckpointActorState;
+    queuedThroughSequence: number;
+    appliedThroughSequence: number;
+    queuedBytes: number;
+    parserEpoch: number;
+    failure: Error | null;
+}
+export interface GhosttyCheckpointActor {
+    start(options: GhosttyCheckpointActorStartOptions): Promise<void>;
+    append(chunks: readonly GhosttyCheckpointChunk[]): void;
+    capture(targetSequence: number): Promise<GhosttyAuthoritativeCheckpoint>;
+    getSnapshot(): GhosttyCheckpointActorSnapshot;
+    dispose(): void;
+}
+export declare const createGhosttyCheckpointActor: (options?: GhosttyCheckpointActorOptions) => GhosttyCheckpointActor;
+//# sourceMappingURL=GhosttyCheckpointActor.d.ts.map

package/dist/checkpoint/GhosttyCheckpointActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GhosttyCheckpointActor.d.ts","sourceRoot":"","sources":["../../src/checkpoint/GhosttyCheckpointActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC/D,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3E,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9E,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,MAAM,2BAA2B,CAAC;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,2BAA2B,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,OAAO,EAAE,kCAAkC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACzE,WAAW,IAAI,8BAA8B,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAgTD,eAAO,MAAM,4BAA4B,GACvC,UAAS,6BAAkC,KAC1C,sBAAiE,CAAC"}

package/dist/checkpoint/GhosttyCheckpointActor.js

@@ -0,0 +1,284 @@
+const DEFAULT_MAX_QUEUED_BYTES = 16 * 1024 * 1024;
+const SHA256_HEX = /^[0-9a-f]{64}$/;
+const assertPositiveSafeInteger = (value, field) => {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`${field} must be a positive safe integer`);
+    }
+};
+const assertNonNegativeSafeInteger = (value, field) => {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${field} must be a non-negative safe integer`);
+    }
+};
+const toError = (value, fallback) => {
+    if (value instanceof Error)
+        return value;
+    if (typeof value === 'string' && value.trim() !== '')
+        return new Error(value);
+    return new Error(fallback);
+};
+const defaultCreateWorker = () => new Worker(new URL('./GhosttyCheckpoint.worker.js', import.meta.url), { type: 'module', name: 'floeterm-ghostty-checkpoint' });
+class GhosttyCheckpointActorImpl {
+    constructor(options) {
+        this.state = 'idle';
+        this.parserEpoch = 0;
+        this.queuedThroughSequence = 0;
+        this.appliedThroughSequence = 0;
+        this.queuedBytes = 0;
+        this.geometryGeneration = 0;
+        this.cols = 0;
+        this.rows = 0;
+        this.nextRequestId = 1;
+        this.failure = null;
+        this.startResolve = null;
+        this.startReject = null;
+        this.captures = new Map();
+        this.onMessage = (event) => {
+            const data = event.data;
+            try {
+                this.handleMessage(data);
+            }
+            catch (error) {
+                this.fail(toError(error, 'invalid Ghostty checkpoint worker response'));
+            }
+        };
+        this.onError = (event) => {
+            const message = event.message;
+            this.fail(new Error(message || 'Ghostty checkpoint worker crashed'));
+        };
+        const maxQueuedBytes = options.maxQueuedBytes ?? DEFAULT_MAX_QUEUED_BYTES;
+        assertPositiveSafeInteger(maxQueuedBytes, 'maxQueuedBytes');
+        this.maxQueuedBytes = maxQueuedBytes;
+        this.worker = (options.createWorker ?? defaultCreateWorker)();
+        this.worker.addEventListener('message', this.onMessage);
+        this.worker.addEventListener('error', this.onError);
+    }
+    start(options) {
+        if (this.state !== 'idle')
+            return Promise.reject(new Error('Ghostty checkpoint actor has already started'));
+        assertPositiveSafeInteger(options.cols, 'cols');
+        assertPositiveSafeInteger(options.rows, 'rows');
+        assertPositiveSafeInteger(options.parserEpoch, 'parserEpoch');
+        assertNonNegativeSafeInteger(options.initialSequence ?? 0, 'initialSequence');
+        if (options.checkpoint && options.initialSequence !== undefined) {
+            return Promise.reject(new Error('checkpoint and initialSequence are mutually exclusive'));
+        }
+        if (options.checkpoint && options.checkpoint.parserEpoch !== options.parserEpoch) {
+            return Promise.reject(new Error('checkpoint parser epoch does not match actor parser epoch'));
+        }
+        this.state = 'starting';
+        this.parserEpoch = options.parserEpoch;
+        this.cols = options.checkpoint?.cols ?? options.cols;
+        this.rows = options.checkpoint?.rows ?? options.rows;
+        this.geometryGeneration = options.checkpoint?.geometryGeneration ?? 0;
+        this.queuedThroughSequence = options.checkpoint?.coveredThroughSequence ?? options.initialSequence ?? 0;
+        this.appliedThroughSequence = this.queuedThroughSequence;
+        const checkpointBytes = options.checkpoint?.bytes.slice();
+        const transfer = checkpointBytes ? [checkpointBytes.buffer] : [];
+        const started = new Promise((resolve, reject) => {
+            this.startResolve = resolve;
+            this.startReject = reject;
+        });
+        this.worker.postMessage({
+            type: 'initialize',
+            cols: this.cols,
+            rows: this.rows,
+            parserEpoch: this.parserEpoch,
+            initialSequence: options.initialSequence,
+            checkpoint: options.checkpoint ? {
+                ...options.checkpoint,
+                bytes: checkpointBytes,
+            } : undefined,
+        }, transfer);
+        return started;
+    }
+    append(chunks) {
+        this.assertReady();
+        if (chunks.length === 0)
+            return;
+        let sequence = this.queuedThroughSequence;
+        let geometryGeneration = this.geometryGeneration;
+        let cols = this.cols;
+        let rows = this.rows;
+        let addedBytes = 0;
+        const ownedChunks = chunks.map(chunk => {
+            assertPositiveSafeInteger(chunk.sequence, 'chunk.sequence');
+            assertPositiveSafeInteger(chunk.geometryGeneration, 'chunk.geometryGeneration');
+            assertPositiveSafeInteger(chunk.cols, 'chunk.cols');
+            assertPositiveSafeInteger(chunk.rows, 'chunk.rows');
+            if (chunk.sequence !== sequence + 1) {
+                throw new Error(`Ghostty checkpoint actor sequence gap: got ${chunk.sequence}, want ${sequence + 1}`);
+            }
+            if (!(chunk.data instanceof Uint8Array) || chunk.data.byteLength === 0) {
+                throw new Error('Ghostty checkpoint actor chunk data must be non-empty bytes');
+            }
+            if (chunk.geometryGeneration < geometryGeneration) {
+                throw new Error('Ghostty checkpoint actor geometry generation moved backwards');
+            }
+            if (chunk.geometryGeneration === geometryGeneration && geometryGeneration > 0 && (chunk.cols !== cols || chunk.rows !== rows)) {
+                throw new Error('Ghostty checkpoint actor geometry generation has conflicting dimensions');
+            }
+            sequence = chunk.sequence;
+            if (chunk.geometryGeneration > geometryGeneration) {
+                geometryGeneration = chunk.geometryGeneration;
+                cols = chunk.cols;
+                rows = chunk.rows;
+            }
+            addedBytes += chunk.data.byteLength;
+            return { ...chunk, data: chunk.data.slice() };
+        });
+        if (this.queuedBytes + addedBytes > this.maxQueuedBytes) {
+            throw new Error(`Ghostty checkpoint actor queue exceeds ${this.maxQueuedBytes} bytes`);
+        }
+        this.queuedThroughSequence = sequence;
+        this.geometryGeneration = geometryGeneration;
+        this.cols = cols;
+        this.rows = rows;
+        this.queuedBytes += addedBytes;
+        this.worker.postMessage({ type: 'append', chunks: ownedChunks }, ownedChunks.map(chunk => chunk.data.buffer));
+    }
+    capture(targetSequence) {
+        this.assertReady();
+        assertPositiveSafeInteger(targetSequence, 'targetSequence');
+        if (targetSequence !== this.queuedThroughSequence) {
+            return Promise.reject(new Error(`checkpoint target must equal queued sequence ${this.queuedThroughSequence}`));
+        }
+        const requestId = this.nextRequestId;
+        this.nextRequestId += 1;
+        const result = new Promise((resolve, reject) => {
+            this.captures.set(requestId, {
+                targetSequence,
+                geometryGeneration: this.geometryGeneration,
+                cols: this.cols,
+                rows: this.rows,
+                resolve,
+                reject,
+            });
+        });
+        this.worker.postMessage({ type: 'capture', requestId, targetSequence });
+        return result;
+    }
+    getSnapshot() {
+        return {
+            state: this.state,
+            queuedThroughSequence: this.queuedThroughSequence,
+            appliedThroughSequence: this.appliedThroughSequence,
+            queuedBytes: this.queuedBytes,
+            parserEpoch: this.parserEpoch,
+            failure: this.failure,
+        };
+    }
+    dispose() {
+        if (this.state === 'disposed')
+            return;
+        const error = new Error('Ghostty checkpoint actor is disposed');
+        this.startReject?.(error);
+        this.startResolve = null;
+        this.startReject = null;
+        for (const pending of this.captures.values())
+            pending.reject(error);
+        this.captures.clear();
+        this.worker.removeEventListener('message', this.onMessage);
+        this.worker.removeEventListener('error', this.onError);
+        this.worker.terminate();
+        this.state = 'disposed';
+    }
+    handleMessage(value) {
+        if (!value || typeof value !== 'object')
+            throw new Error('checkpoint worker message must be an object');
+        const message = value;
+        if (message.type === 'ready') {
+            if (this.state !== 'starting')
+                throw new Error('unexpected checkpoint worker ready message');
+            if (message.parserEpoch !== this.parserEpoch || message.historySequence !== this.queuedThroughSequence) {
+                throw new Error('checkpoint worker initialized at stale coordinates');
+            }
+            this.state = 'ready';
+            this.startResolve?.();
+            this.startResolve = null;
+            this.startReject = null;
+            return;
+        }
+        if (message.type === 'applied') {
+            this.assertReady();
+            const throughSequence = message.throughSequence;
+            const releasedBytes = message.releasedBytes;
+            assertNonNegativeSafeInteger(throughSequence, 'applied.throughSequence');
+            assertNonNegativeSafeInteger(releasedBytes, 'applied.releasedBytes');
+            if (throughSequence < this.appliedThroughSequence || throughSequence > this.queuedThroughSequence) {
+                throw new Error('checkpoint worker applied sequence is stale or beyond queued output');
+            }
+            if (releasedBytes > this.queuedBytes) {
+                throw new Error('checkpoint worker released more bytes than queued');
+            }
+            this.appliedThroughSequence = throughSequence;
+            this.queuedBytes -= releasedBytes;
+            return;
+        }
+        if (message.type === 'checkpoint') {
+            const requestId = message.requestId;
+            assertPositiveSafeInteger(requestId, 'checkpoint.requestId');
+            const pending = this.captures.get(requestId);
+            if (!pending)
+                throw new Error('checkpoint worker returned an unknown request');
+            const historySequence = message.historySequence;
+            if (historySequence !== pending.targetSequence) {
+                throw new Error(`stale checkpoint sequence: got ${historySequence}, want ${pending.targetSequence}`);
+            }
+            if (message.parserEpoch !== this.parserEpoch
+                || message.geometryGeneration !== pending.geometryGeneration
+                || message.cols !== pending.cols
+                || message.rows !== pending.rows) {
+                throw new Error('stale checkpoint geometry or parser epoch');
+            }
+            if (message.formatVersion !== 1)
+                throw new Error('unsupported checkpoint format version');
+            if (typeof message.checksumSha256 !== 'string' || !SHA256_HEX.test(message.checksumSha256)) {
+                throw new Error('checkpoint checksum must be lowercase SHA-256');
+            }
+            if (typeof message.stateDigestSha256 !== 'string' || !SHA256_HEX.test(message.stateDigestSha256)) {
+                throw new Error('checkpoint state digest must be lowercase SHA-256');
+            }
+            if (!(message.bytes instanceof Uint8Array) || message.bytes.byteLength === 0) {
+                throw new Error('checkpoint worker returned empty checkpoint bytes');
+            }
+            this.captures.delete(requestId);
+            pending.resolve({
+                formatVersion: 1,
+                engineId: 'floegence-ghostty-web',
+                coveredThroughSequence: historySequence,
+                geometryGeneration: pending.geometryGeneration,
+                parserEpoch: this.parserEpoch,
+                cols: pending.cols,
+                rows: pending.rows,
+                checksumSha256: message.checksumSha256,
+                stateDigestSha256: message.stateDigestSha256,
+                bytes: message.bytes.slice(),
+            });
+            return;
+        }
+        if (message.type === 'error') {
+            throw new Error(typeof message.message === 'string' ? message.message : 'Ghostty checkpoint worker failed');
+        }
+        throw new Error('unknown Ghostty checkpoint worker message');
+    }
+    assertReady() {
+        if (this.state !== 'ready') {
+            throw this.failure ?? new Error(`Ghostty checkpoint actor is not ready (${this.state})`);
+        }
+    }
+    fail(error) {
+        if (this.state === 'disposed' || this.state === 'failed')
+            return;
+        this.failure = error;
+        this.state = 'failed';
+        this.startReject?.(error);
+        this.startResolve = null;
+        this.startReject = null;
+        for (const pending of this.captures.values())
+            pending.reject(error);
+        this.captures.clear();
+    }
+}
+export const createGhosttyCheckpointActor = (options = {}) => new GhosttyCheckpointActorImpl(options);
+//# sourceMappingURL=GhosttyCheckpointActor.js.map

package/dist/checkpoint/GhosttyCheckpointActor.js.map

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

package/dist/checkpoint/GhosttyCheckpointEngine.d.ts

@@ -0,0 +1,62 @@
+import type { GhosttyAuthoritativeCheckpoint, GhosttyCheckpointChunk } from './GhosttyCheckpointActor';
+interface GhosttyCheckpointMetadata {
+    formatVersion: number;
+    cols: number;
+    rows: number;
+    historySequence: bigint;
+    geometryGeneration: bigint;
+    parserEpoch: bigint;
+}
+interface GhosttyCheckpointTerminal {
+    readonly cols: number;
+    readonly rows: number;
+    write(data: Uint8Array): void;
+    resize(cols: number, rows: number): void;
+    captureCheckpoint(coordinates?: {
+        historySequence: bigint;
+        geometryGeneration: bigint;
+        parserEpoch: bigint;
+    }): {
+        bytes: Uint8Array;
+        metadata: GhosttyCheckpointMetadata;
+    };
+    validateCheckpoint(bytes: Uint8Array): GhosttyCheckpointMetadata;
+    restoreCheckpoint(bytes: Uint8Array, expectedCoordinates?: {
+        historySequence: bigint;
+        geometryGeneration: bigint;
+        parserEpoch: bigint;
+    }): void;
+    getStateDigest(): string;
+    free(): void;
+}
+export interface GhosttyCheckpointRuntimeLike {
+    createTerminal(cols: number, rows: number): GhosttyCheckpointTerminal;
+}
+export interface GhosttyCheckpointEngineOptions {
+    cols: number;
+    rows: number;
+    parserEpoch: number;
+    initialSequence?: number;
+    checkpoint?: GhosttyAuthoritativeCheckpoint;
+}
+export interface GhosttyCheckpointEngineAppendResult {
+    throughSequence: number;
+    releasedBytes: number;
+}
+export declare class GhosttyCheckpointEngine {
+    private readonly runtime;
+    private readonly parserEpoch;
+    private terminal;
+    private queuedThroughSequence;
+    private geometryGeneration;
+    private cols;
+    private rows;
+    private disposed;
+    constructor(runtime: GhosttyCheckpointRuntimeLike, options: GhosttyCheckpointEngineOptions);
+    append(chunks: readonly GhosttyCheckpointChunk[]): GhosttyCheckpointEngineAppendResult;
+    capture(targetSequence: number): Promise<GhosttyAuthoritativeCheckpoint>;
+    dispose(): void;
+    private assertLive;
+}
+export {};
+//# sourceMappingURL=GhosttyCheckpointEngine.d.ts.map

package/dist/checkpoint/GhosttyCheckpointEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GhosttyCheckpointEngine.d.ts","sourceRoot":"","sources":["../../src/checkpoint/GhosttyCheckpointEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,WAAW,CAAC,EAAE;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,yBAAyB,CAAA;KAAE,CAAC;IAC/D,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,yBAAyB,CAAC;IACjE,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,EAAE;QACzD,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,cAAc,IAAI,MAAM,CAAC;IACzB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAAC;CACvE;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAED,MAAM,WAAW,mCAAmC;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAgCD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,8BAA8B;IAoC1F,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,GAAG,mCAAmC;IAyChF,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;IA8D9E,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,UAAU;CAGnB"}

package/dist/checkpoint/GhosttyCheckpointEngine.js

@@ -0,0 +1,175 @@
+const toBigInt = (value, field) => {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${field} must be a non-negative safe integer`);
+    return BigInt(value);
+};
+const assertDigest = (value, field) => {
+    if (!/^[0-9a-f]{64}$/.test(value))
+        throw new Error(`${field} must be lowercase SHA-256`);
+};
+const sha256Hex = async (bytes) => {
+    const digest = await crypto.subtle.digest('SHA-256', bytes.slice().buffer);
+    return Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join('');
+};
+const assertMetadataMatches = (metadata, checkpoint) => {
+    if (metadata.formatVersion !== checkpoint.formatVersion
+        || metadata.cols !== checkpoint.cols
+        || metadata.rows !== checkpoint.rows
+        || metadata.historySequence !== BigInt(checkpoint.coveredThroughSequence)
+        || metadata.geometryGeneration !== BigInt(checkpoint.geometryGeneration)
+        || metadata.parserEpoch !== BigInt(checkpoint.parserEpoch)) {
+        throw new Error('checkpoint metadata does not match its requested coordinates');
+    }
+};
+export class GhosttyCheckpointEngine {
+    constructor(runtime, options) {
+        this.disposed = false;
+        if (!Number.isSafeInteger(options.parserEpoch) || options.parserEpoch <= 0) {
+            throw new Error('checkpoint parser epoch must be positive');
+        }
+        if (!Number.isSafeInteger(options.cols) || options.cols <= 0 || !Number.isSafeInteger(options.rows) || options.rows <= 0) {
+            throw new Error('checkpoint engine dimensions must be positive safe integers');
+        }
+        if (!Number.isSafeInteger(options.initialSequence ?? 0) || (options.initialSequence ?? 0) < 0) {
+            throw new Error('checkpoint engine initial sequence must be a non-negative safe integer');
+        }
+        if (options.checkpoint && options.initialSequence !== undefined) {
+            throw new Error('checkpoint and initial sequence are mutually exclusive');
+        }
+        this.runtime = runtime;
+        this.parserEpoch = options.parserEpoch;
+        this.terminal = runtime.createTerminal(options.checkpoint?.cols ?? options.cols, options.checkpoint?.rows ?? options.rows);
+        this.queuedThroughSequence = options.checkpoint?.coveredThroughSequence ?? options.initialSequence ?? 0;
+        this.geometryGeneration = options.checkpoint?.geometryGeneration ?? 0;
+        this.cols = options.checkpoint?.cols ?? options.cols;
+        this.rows = options.checkpoint?.rows ?? options.rows;
+        if (options.checkpoint) {
+            assertDigest(options.checkpoint.stateDigestSha256, 'checkpoint state digest');
+            const coordinates = {
+                historySequence: toBigInt(options.checkpoint.coveredThroughSequence, 'checkpoint history sequence'),
+                geometryGeneration: toBigInt(options.checkpoint.geometryGeneration, 'checkpoint geometry generation'),
+                parserEpoch: toBigInt(options.checkpoint.parserEpoch, 'checkpoint parser epoch'),
+            };
+            const metadata = this.terminal.validateCheckpoint(options.checkpoint.bytes);
+            assertMetadataMatches(metadata, options.checkpoint);
+            this.terminal.restoreCheckpoint(options.checkpoint.bytes.slice(), coordinates);
+            if (this.terminal.getStateDigest() !== options.checkpoint.stateDigestSha256) {
+                throw new Error('checkpoint restore state digest mismatch');
+            }
+        }
+    }
+    append(chunks) {
+        this.assertLive();
+        let sequence = this.queuedThroughSequence;
+        let geometryGeneration = this.geometryGeneration;
+        let cols = this.cols;
+        let rows = this.rows;
+        let releasedBytes = 0;
+        for (const chunk of chunks) {
+            if (!Number.isSafeInteger(chunk.sequence) || chunk.sequence !== sequence + 1) {
+                throw new Error(`checkpoint engine sequence gap: got ${chunk.sequence}, want ${sequence + 1}`);
+            }
+            if (!Number.isSafeInteger(chunk.geometryGeneration) || chunk.geometryGeneration <= 0) {
+                throw new Error('checkpoint engine geometry generation is invalid');
+            }
+            if (chunk.geometryGeneration < geometryGeneration) {
+                throw new Error('checkpoint engine geometry generation moved backwards');
+            }
+            if (chunk.geometryGeneration === geometryGeneration && geometryGeneration > 0 && (chunk.cols !== cols || chunk.rows !== rows)) {
+                throw new Error('checkpoint engine geometry generation has conflicting dimensions');
+            }
+            if (chunk.geometryGeneration > geometryGeneration) {
+                if (!Number.isSafeInteger(chunk.cols) || chunk.cols <= 0 || !Number.isSafeInteger(chunk.rows) || chunk.rows <= 0) {
+                    throw new Error('checkpoint engine geometry dimensions are invalid');
+                }
+                geometryGeneration = chunk.geometryGeneration;
+                cols = chunk.cols;
+                rows = chunk.rows;
+                this.terminal.resize(cols, rows);
+            }
+            if (chunk.data.byteLength === 0)
+                throw new Error('checkpoint engine output chunk is empty');
+            this.terminal.write(chunk.data.slice());
+            sequence = chunk.sequence;
+            releasedBytes += chunk.data.byteLength;
+        }
+        this.queuedThroughSequence = sequence;
+        this.geometryGeneration = geometryGeneration;
+        this.cols = cols;
+        this.rows = rows;
+        return { throughSequence: sequence, releasedBytes };
+    }
+    async capture(targetSequence) {
+        this.assertLive();
+        if (!Number.isSafeInteger(targetSequence) || targetSequence <= 0 || targetSequence !== this.queuedThroughSequence) {
+            throw new Error(`checkpoint engine target must equal queued sequence ${this.queuedThroughSequence}`);
+        }
+        const coordinates = {
+            historySequence: toBigInt(targetSequence, 'checkpoint history sequence'),
+            geometryGeneration: toBigInt(this.geometryGeneration, 'checkpoint geometry generation'),
+            parserEpoch: toBigInt(this.parserEpoch, 'checkpoint parser epoch'),
+        };
+        const captured = this.terminal.captureCheckpoint(coordinates);
+        assertMetadataMatches(captured.metadata, {
+            formatVersion: 1,
+            engineId: 'floegence-ghostty-web',
+            coveredThroughSequence: targetSequence,
+            geometryGeneration: this.geometryGeneration,
+            parserEpoch: this.parserEpoch,
+            cols: this.cols,
+            rows: this.rows,
+            checksumSha256: '0'.repeat(64),
+            stateDigestSha256: this.terminal.getStateDigest(),
+            bytes: captured.bytes,
+        });
+        const metadata = this.terminal.validateCheckpoint(captured.bytes);
+        assertMetadataMatches(metadata, {
+            formatVersion: 1,
+            engineId: 'floegence-ghostty-web',
+            coveredThroughSequence: targetSequence,
+            geometryGeneration: this.geometryGeneration,
+            parserEpoch: this.parserEpoch,
+            cols: this.cols,
+            rows: this.rows,
+            checksumSha256: '0'.repeat(64),
+            stateDigestSha256: this.terminal.getStateDigest(),
+            bytes: captured.bytes,
+        });
+        const liveDigest = this.terminal.getStateDigest();
+        assertDigest(liveDigest, 'live state digest');
+        const verifier = this.runtime.createTerminal(this.cols, this.rows);
+        try {
+            verifier.restoreCheckpoint(captured.bytes.slice(), coordinates);
+            if (verifier.getStateDigest() !== liveDigest) {
+                throw new Error('self-restore state digest mismatch');
+            }
+            const bytes = captured.bytes.slice();
+            return {
+                formatVersion: 1,
+                engineId: 'floegence-ghostty-web',
+                coveredThroughSequence: targetSequence,
+                geometryGeneration: this.geometryGeneration,
+                parserEpoch: this.parserEpoch,
+                cols: this.cols,
+                rows: this.rows,
+                checksumSha256: await sha256Hex(bytes),
+                stateDigestSha256: liveDigest,
+                bytes,
+            };
+        }
+        finally {
+            verifier.free();
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.terminal.free();
+    }
+    assertLive() {
+        if (this.disposed)
+            throw new Error('checkpoint engine is disposed');
+    }
+}
+//# sourceMappingURL=GhosttyCheckpointEngine.js.map