spice-html5-react 0.1.0

package/dist/protocol/quic.d.ts

@@ -0,0 +1,105 @@
+import { SpiceQuicData } from './spicetype';
+
+export declare const QuicImageType: {
+    readonly INVALID: 0;
+    readonly GRAY: 1;
+    readonly RGB16: 2;
+    readonly RGB24: 3;
+    readonly RGB32: 4;
+    readonly RGBA: 5;
+};
+export type QuicImageTypeValue = (typeof QuicImageType)[keyof typeof QuicImageType];
+declare class QuicModel {
+    levels: number;
+    nBuckets: number;
+    nBucketsPtrs: number;
+    repfirst: number;
+    firstsize: number;
+    repnext: number;
+    mulsize: number;
+    constructor(bpc: number);
+}
+declare class QuicBucket {
+    bestcode: number;
+    counters: number[];
+    reste(bpp: number): void;
+    updateModel8bpc(state: CommonState, curval: number, bpp: number): void;
+}
+declare class QuicFamilyStat {
+    bucketsPtrs: QuicBucket[];
+    bucketsBuf: QuicBucket[];
+    fillModelStructures(model: QuicModel): boolean;
+}
+interface CorrelateRow {
+    zero: number;
+    row: number[];
+}
+declare class QuicChannel {
+    state: CommonState;
+    familyStat8bpc: QuicFamilyStat;
+    familyStat5bpc: QuicFamilyStat;
+    correlateRow: CorrelateRow;
+    model8bpc: QuicModel;
+    model5bpc: QuicModel;
+    bucketsPtrs: QuicBucket[];
+    constructor(model8bpc: QuicModel, model5bpc: QuicModel);
+    reste(bpc: number): boolean;
+}
+declare class CommonState {
+    waitcnt: number;
+    tabrandSeed: number;
+    wmTrigger: number;
+    wmidx: number;
+    wmileft: number;
+    melcstate: number;
+    melclen: number;
+    melcorder: number;
+    setWmTrigger(): void;
+    reste(): void;
+    tabrand(): number;
+}
+declare class QuicEncoder {
+    type: number;
+    width: number;
+    height: number;
+    ioIdx: number;
+    ioAvailableBits: number;
+    ioWord: number;
+    ioNextWord: number;
+    ioNow: Uint8Array;
+    ioEnd: number;
+    rowsCompleted: number;
+    rgbState: CommonState;
+    model8bpc: QuicModel;
+    model5bpc: QuicModel;
+    channels: QuicChannel[];
+    constructor();
+    reste(ioPtr: Uint8Array): boolean;
+    readIoWord(): void;
+    decodeEatbits(len: number): void;
+    decodeEat32bits(): void;
+    resteChannels(bpc: number): boolean;
+    quicDecodeBegin(ioPtr: Uint8Array): boolean;
+    quicRgb32UncompressRow0Seg(i: number, curRow: Uint8Array, end: number, waitmask: number, bpc: number, bpcMask: number): void;
+    quicRgb32UncompressRow0(curRow: Uint8Array): void;
+    quicRgb32UncompressRowSeg(prevRow: Uint8Array, curRow: Uint8Array, i: number, end: number, bpc: number, bpcMask: number): void;
+    decodeRun(state: CommonState): number;
+    quicRgb32UncompressRow(prevRow: Uint8Array, curRow: Uint8Array): void;
+    quicFourUncompressRow0Seg(channel: QuicChannel, i: number, correlateRow: CorrelateRow, curRow: Uint8Array, end: number, waitmask: number, bpc: number, bpcMask: number): void;
+    quicFourUncompressRow0(channel: QuicChannel, curRow: Uint8Array): void;
+    quicFourUncompressRowSeg(channel: QuicChannel, correlateRow: CorrelateRow, prevRow: Uint8Array, curRow: Uint8Array, i: number, end: number, bpc: number, bpcMask: number): void;
+    quicFourUncompressRow(channel: QuicChannel, prevRow: Uint8Array, curRow: Uint8Array): void;
+    quicDecode(buf: Uint8Array, stride: number): boolean;
+    simpleQuicDecode(buf: Uint8Array): Uint8Array | null;
+}
+export declare class SpiceQuic implements SpiceQuicData {
+    data_size: number;
+    outptr: Uint8Array | null;
+    type: number;
+    width: number;
+    height: number;
+    fromDataView(dv: DataView, at: number, mb: ArrayBuffer): number;
+}
+export declare function convertSpiceQuicToWeb(context: CanvasRenderingContext2D, spiceQuic: SpiceQuicData): ImageData | undefined;
+export { QuicEncoder, QuicModel, QuicBucket, QuicChannel, QuicFamilyStat, CommonState, };
+//# sourceMappingURL=quic.d.ts.map

package/dist/protocol/quic.d.ts.map

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

package/dist/protocol/resize.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Minimal interface for a connection that supports window resize.
+ * Avoids importing SpiceMainConn directly to prevent circular deps.
+ */
+export interface ResizableConnection {
+    /** Screen element ID */
+    screenId: string | undefined;
+    /** Message element ID */
+    messageId: string | undefined;
+    /** Send a resize request to the guest */
+    resizeWindow(flags: number, width: number, height: number, depth: number, x: number, y: number): void;
+}
+/**
+ * Compute the available screen dimensions and send a resize request.
+ *
+ * Width is taken from the screen element's clientWidth.
+ * Height is computed from the window inner height, minus the message
+ * area and a bottom margin, then rounded down to a multiple of 8.
+ *
+ * @param connection - The SPICE main connection
+ */
+export declare function resizeHelper(connection: ResizableConnection): void;
+/**
+ * Manages debounced resize events for a SPICE connection.
+ *
+ * Call `handleResize()` on each resize event; it debounces to avoid
+ * flooding the server with resize requests.  Call `cleanup()` to
+ * cancel any pending timer.
+ */
+export declare class SpiceResizeHandler {
+    private connection;
+    private resizeTimer;
+    private debounceMs;
+    /**
+     * @param connection - The SPICE main connection
+     * @param debounceMs - Debounce delay in ms (default 200)
+     */
+    constructor(connection: ResizableConnection, debounceMs?: number);
+    /**
+     * Handle a resize event.  Debounces: cancels any pending timer
+     * and starts a new one.
+     */
+    handleResize: () => void;
+    /**
+     * Cancel any pending resize timer.
+     */
+    cleanup(): void;
+}
+/**
+ * Monitor a container element for size changes using ResizeObserver.
+ *
+ * Returns a cleanup function that disconnects the observer.
+ * Falls back gracefully if ResizeObserver is unavailable (SSR or old browsers).
+ *
+ * @param container  - The element to observe
+ * @param connection - The SPICE main connection
+ * @param debounceMs - Debounce delay in ms (default 200)
+ * @returns A cleanup function, or undefined if ResizeObserver is unavailable
+ */
+export declare function observeContainerResize(container: HTMLElement, connection: ResizableConnection, debounceMs?: number): (() => void) | undefined;
+//# sourceMappingURL=resize.d.ts.map

package/dist/protocol/resize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/protocol/resize.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAEhC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,yBAAyB;IACzB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,yCAAyC;IACzC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzG;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CA2DlE;AAMD;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,UAAU,EAAE,mBAAmB,EAAE,UAAU,GAAE,MAA2B;IAMpF;;;OAGG;IACH,YAAY,QAAO,IAAI,CAarB;IAEF;;OAEG;IACH,OAAO,IAAI,IAAI;CAQlB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAClC,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,GAAE,MAA2B,GACxC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAqB1B"}

package/dist/protocol/simulatecursor.d.ts

@@ -0,0 +1,49 @@
+import { SpiceCursorHeader } from './spicetype';
+
+export interface CursorData {
+    header: SpiceCursorHeader;
+    data: ArrayBuffer;
+}
+interface SimulatedCursorElement extends HTMLImageElement {
+    spiceScreen: HTMLElement;
+    spiceHotX: number;
+    spiceHotY: number;
+}
+/**
+ * Register a pre-loaded cursor file for a given hash.
+ *
+ * @param hash  - SHA-1 hash of the cursor's PNG + hotspot
+ * @param value - URL to a pre-built .cur file
+ */
+declare function addCursor(hash: string, value: string): void;
+/** Owning cursor channel state needed for simulation */
+export interface CursorOwner {
+    parent: {
+        screenId: string | undefined;
+    } | undefined;
+    simulatedCursor: SimulatedCursorElement | undefined;
+    simulatedCursorHandler: ((e: MouseEvent) => void) | undefined;
+}
+/**
+ * Attempt to simulate the cursor when CSS data URI cursors are not
+ * supported.  First tries preloaded cursors from the cache; if that
+ * also fails, creates a positioned `<img>` element that tracks the
+ * mouse to visually represent the cursor.
+ *
+ * @param owner    - The cursor channel connection (stores simulated cursor state)
+ * @param cursor   - Cursor data with header and pixel data
+ * @param screen   - The screen HTML element
+ * @param dataUrl  - PNG data URI string (from createRgbaPng)
+ */
+declare function simulateCursor(owner: CursorOwner, cursor: CursorData, screen: HTMLElement, dataUrl: string): Promise<void>;
+/**
+ * Clean up a simulated cursor element if one exists.
+ */
+declare function cleanupSimulatedCursor(owner: CursorOwner): void;
+export declare const SpiceSimulateCursor: {
+    addCursor: typeof addCursor;
+    simulateCursor: typeof simulateCursor;
+    cleanupSimulatedCursor: typeof cleanupSimulatedCursor;
+};
+export {};
+//# sourceMappingURL=simulatecursor.d.ts.map

package/dist/protocol/simulatecursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulatecursor.d.ts","sourceRoot":"","sources":["../../src/protocol/simulatecursor.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBrD,MAAM,WAAW,UAAU;IAEvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC;CACrB;AAMD,UAAU,sBAAuB,SAAQ,gBAAgB;IAErD,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAuBD;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpD;AAoED,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAExB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACrD,eAAe,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACpD,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjE;AAED;;;;;;;;;;GAUG;AACH,iBAAe,cAAc,CACzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;GAEG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAexD;AAED,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC"}

package/dist/protocol/spicearraybuffer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Typed ArrayBuffer utility functions for the SPICE protocol.
+ *
+ * The original spicearraybuffer.js was a polyfill for ArrayBuffer.prototype.slice
+ * in IE 10. Modern browsers all support ArrayBuffer.prototype.slice natively,
+ * so no polyfill is needed. This module provides typed helper functions for
+ * common ArrayBuffer operations used throughout the protocol layer.
+ */
+/**
+ * Safely slice an ArrayBuffer with bounds clamping.
+ *
+ * Behaves identically to ArrayBuffer.prototype.slice but clamps negative
+ * indices and out-of-bounds values instead of throwing.
+ *
+ * @param buffer - The source ArrayBuffer to slice.
+ * @param start  - Start byte offset (inclusive). Negative values count from end. Defaults to 0.
+ * @param end    - End byte offset (exclusive). Negative values count from end. Defaults to buffer.byteLength.
+ * @returns A new ArrayBuffer containing the sliced bytes.
+ */
+declare function arrayBufferSlice(buffer: ArrayBuffer, start?: number, end?: number): ArrayBuffer;
+/**
+ * Concatenate multiple ArrayBuffers into a single ArrayBuffer.
+ *
+ * @param buffers - The ArrayBuffers to concatenate.
+ * @returns A new ArrayBuffer containing all bytes in order.
+ */
+declare function concatArrayBuffers(...buffers: ArrayBuffer[]): ArrayBuffer;
+/**
+ * Create a new ArrayBuffer initialized with the contents of a Uint8Array.
+ *
+ * @param data - The source byte array.
+ * @returns A new ArrayBuffer containing a copy of the data.
+ */
+declare function arrayBufferFromUint8Array(data: Uint8Array): ArrayBuffer;
+/**
+ * Compare two ArrayBuffers for byte equality.
+ *
+ * @param a - First ArrayBuffer.
+ * @param b - Second ArrayBuffer.
+ * @returns true if both buffers have identical length and contents.
+ */
+declare function arrayBuffersEqual(a: ArrayBuffer, b: ArrayBuffer): boolean;
+export { arrayBufferSlice, concatArrayBuffers, arrayBufferFromUint8Array, arrayBuffersEqual, };
+//# sourceMappingURL=spicearraybuffer.d.ts.map

package/dist/protocol/spicearraybuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spicearraybuffer.d.ts","sourceRoot":"","sources":["../../src/protocol/spicearraybuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;GAUG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAwBxF;AAED;;;;;GAKG;AACH,iBAAS,kBAAkB,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAgBlE;AAED;;;;;GAKG;AACH,iBAAS,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAIhE;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAYlE;AAED,OAAO,EACH,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,GACpB,CAAC"}

package/dist/protocol/spiceconn.d.ts

@@ -0,0 +1,118 @@
+import { SpiceLinkHeader, SpiceLinkReply, SpiceLinkAuthReply, SpiceMiniData } from './spicemsg';
+import { SpiceWireReader, WireOwner } from './wire';
+
+/**
+ * Connection states for the SPICE handshake and session lifecycle.
+ *
+ * Flow: connecting -> start -> link -> ticket -> ready
+ * Error/close transitions can happen from any state.
+ */
+export declare const ConnectionState: {
+    /** WebSocket is connecting (initial state). */
+    readonly CONNECTING: "connecting";
+    /** WebSocket opened; link header sent, awaiting server link header. */
+    readonly START: "start";
+    /** Server link header received; awaiting server link reply. */
+    readonly LINK: "link";
+    /** Link reply received; ticket sent, awaiting auth reply. */
+    readonly TICKET: "ticket";
+    /** Authenticated; processing protocol messages. */
+    readonly READY: "ready";
+    /** Connection is closing (intentional close). */
+    readonly CLOSING: "closing";
+    /** An error occurred. */
+    readonly ERROR: "error";
+};
+export type ConnectionStateValue = typeof ConnectionState[keyof typeof ConnectionState];
+/**
+ * Options for constructing a SpiceConn instance.
+ */
+export interface SpiceConnOptions {
+    /** WebSocket URI (e.g. "wss://host:port"). */
+    uri: string;
+    /** Connection ID (session ID for sub-channels; 0 for main channel). */
+    connectionId?: number;
+    /** SPICE channel type (from SpiceChannel.*). */
+    type?: number;
+    /** Channel ID (for multi-head, typically 0). */
+    chanId?: number;
+    /** Parent connection (for sub-channels that inherit password and messageId). */
+    parent?: SpiceConn;
+    /** Screen element ID for display rendering. */
+    screenId?: string;
+    /** Element ID for debug canvas dumps. */
+    dumpId?: string;
+    /** Element ID for message logging to the DOM. */
+    messageId?: string;
+    /** Password for SPICE ticket authentication. */
+    password?: string;
+    /** Error callback. */
+    onerror?: (e: Error) => void;
+    /** Success callback. */
+    onsuccess?: (m: string) => void;
+    /** Agent ready callback. */
+    onagent?: () => void;
+}
+/**
+ * Base SPICE connection class.  Manages WebSocket lifecycle,
+ * SPICE link handshake, ticket authentication, and common
+ * message handling (SET_ACK, PING/PONG, NOTIFY).
+ *
+ * Channel-specific subclasses (Main, Display, Inputs, Cursor,
+ * Playback, Port) extend this class and override
+ * `processChannelMessage()` to handle their own message types.
+ */
+export declare class SpiceConn implements WireOwner {
+    ws: WebSocket;
+    connectionId: number;
+    type: number;
+    state: ConnectionStateValue;
+    chanId: number;
+    parent: SpiceConn | undefined;
+    screenId: string | undefined;
+    dumpId: string | undefined;
+    messageId: string | undefined;
+    password: string;
+    onerror: ((e: Error) => void) | undefined;
+    onsuccess: ((m: string) => void) | undefined;
+    onagent: (() => void) | undefined;
+    wireReader: SpiceWireReader;
+    messagesSent: number;
+    ackWindow: number;
+    msgsUntilAck: number | undefined;
+    replyHdr: SpiceLinkHeader | undefined;
+    replyLink: SpiceLinkReply | undefined;
+    authReply: SpiceLinkAuthReply | undefined;
+    private warnings;
+    private timeout;
+    constructor(options: SpiceConnOptions);
+    private sendHdr;
+    private sendTicket;
+    sendMsg(msg: SpiceMiniData): void;
+    private processInbound;
+    private processCommonMessages;
+    private processMessage;
+    /**
+     * Process a channel-specific message.  Subclasses should override
+     * this method to handle their own message types.
+     *
+     * @param msg - The SPICE mini-data message to process
+     * @returns true if the message was handled, false otherwise
+     */
+    protected processChannelMessage(msg: SpiceMiniData): boolean;
+    channelType(): string;
+    logInfo(...args: string[]): void;
+    logWarn(...args: string[]): void;
+    logErr(...args: string[]): void;
+    knownUnimplemented(type: number, msg: string): void;
+    reportError(e: Error): void;
+    reportSuccess(m: string): void;
+    /**
+     * Clean disconnect: close WebSocket, clear timers, detach wire reader.
+     * Call this when the connection is being intentionally torn down.
+     */
+    cleanup(): void;
+    private handleTimeout;
+}
+export { SpiceConn as default };
+//# sourceMappingURL=spiceconn.d.ts.map

package/dist/protocol/spiceconn.d.ts.map

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

package/dist/protocol/spicedataview.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Typed DataView wrapper for the SPICE protocol.
+ *
+ * The original spicedataview.js was a manual DataView polyfill for old
+ * Firefox versions that lacked DataView support. Modern browsers all
+ * provide DataView natively, so no polyfill is needed.
+ *
+ * This module provides:
+ *   - SpiceDataView: a thin typed wrapper around the standard DataView
+ *     with SPICE-specific convenience methods (e.g., 64-bit BigInt reads,
+ *     typed sub-view creation).
+ *   - Helper functions for creating DataViews from various sources.
+ *
+ * Per codebase convention, new protocol code should use standard DataView
+ * directly with getBigUint64/setBigUint64 for 64-bit fields (bigint).
+ * This module exists for compatibility and as a typed alternative.
+ */
+/**
+ * A typed wrapper around standard DataView with SPICE-specific conveniences.
+ *
+ * Provides the same API as DataView, plus:
+ *   - Getters/setters for 64-bit unsigned integers as bigint (delegates to
+ *     standard getBigUint64/setBigUint64)
+ *   - A subview() method for creating DataViews over sub-regions
+ *   - Access to the underlying Uint8Array for byte-level operations
+ *   - A remaining() helper for protocol message parsing
+ */
+declare class SpiceDataView {
+    /** The underlying standard DataView. */
+    readonly dv: DataView;
+    /** The underlying buffer as a Uint8Array for direct byte access. */
+    readonly u8: Uint8Array;
+    /**
+     * Create a SpiceDataView over an ArrayBuffer or ArrayBufferLike.
+     *
+     * @param buffer     - The source buffer.
+     * @param byteOffset - Optional byte offset into the buffer. Defaults to 0.
+     * @param byteLength - Optional number of bytes. Defaults to remainder of buffer.
+     */
+    constructor(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number);
+    /** The ArrayBuffer backing this view. */
+    get buffer(): ArrayBufferLike;
+    /** The byte offset into the buffer. */
+    get byteOffset(): number;
+    /** The byte length of this view. */
+    get byteLength(): number;
+    getUint8(byteOffset: number): number;
+    getInt8(byteOffset: number): number;
+    getUint16(byteOffset: number, littleEndian?: boolean): number;
+    getInt16(byteOffset: number, littleEndian?: boolean): number;
+    getUint32(byteOffset: number, littleEndian?: boolean): number;
+    getInt32(byteOffset: number, littleEndian?: boolean): number;
+    getFloat32(byteOffset: number, littleEndian?: boolean): number;
+    getFloat64(byteOffset: number, littleEndian?: boolean): number;
+    /**
+     * Read an unsigned 64-bit integer as a bigint.
+     *
+     * The original SpiceDataView.getUint64 returned a lossy JavaScript number.
+     * This version uses the standard getBigUint64 for full precision.
+     */
+    getBigUint64(byteOffset: number, littleEndian?: boolean): bigint;
+    /**
+     * Read a signed 64-bit integer as a bigint.
+     */
+    getBigInt64(byteOffset: number, littleEndian?: boolean): bigint;
+    setUint8(byteOffset: number, value: number): void;
+    setInt8(byteOffset: number, value: number): void;
+    setUint16(byteOffset: number, value: number, littleEndian?: boolean): void;
+    setInt16(byteOffset: number, value: number, littleEndian?: boolean): void;
+    setUint32(byteOffset: number, value: number, littleEndian?: boolean): void;
+    setInt32(byteOffset: number, value: number, littleEndian?: boolean): void;
+    setFloat32(byteOffset: number, value: number, littleEndian?: boolean): void;
+    setFloat64(byteOffset: number, value: number, littleEndian?: boolean): void;
+    /**
+     * Write an unsigned 64-bit integer from a bigint.
+     *
+     * The original SpiceDataView.setUint64 accepted a lossy JavaScript number.
+     * This version uses the standard setBigUint64 for full precision.
+     */
+    setBigUint64(byteOffset: number, value: bigint, littleEndian?: boolean): void;
+    /**
+     * Write a signed 64-bit integer from a bigint.
+     */
+    setBigInt64(byteOffset: number, value: bigint, littleEndian?: boolean): void;
+    /**
+     * Create a sub-view of this SpiceDataView.
+     *
+     * Useful for parsing nested protocol structures at a known offset.
+     *
+     * @param byteOffset - Offset relative to this view's start.
+     * @param byteLength - Optional length. Defaults to remainder.
+     * @returns A new SpiceDataView over the sub-region.
+     */
+    subview(byteOffset: number, byteLength?: number): SpiceDataView;
+    /**
+     * Get the number of bytes remaining from the given offset to the end.
+     *
+     * Useful during protocol message parsing to determine how many bytes
+     * are left for variable-length trailing data.
+     *
+     * @param currentOffset - The current parse offset within this view.
+     * @returns Number of remaining bytes.
+     */
+    remaining(currentOffset: number): number;
+    /**
+     * Extract a copy of a byte range as a new Uint8Array.
+     *
+     * @param byteOffset - Start offset within this view.
+     * @param byteLength - Number of bytes to extract. Defaults to remainder.
+     * @returns A new Uint8Array copy of the specified range.
+     */
+    getBytes(byteOffset: number, byteLength?: number): Uint8Array;
+    /**
+     * Copy bytes into this view's buffer at the given offset.
+     *
+     * @param byteOffset - Destination offset within this view.
+     * @param data       - Source bytes to copy.
+     */
+    setBytes(byteOffset: number, data: Uint8Array): void;
+}
+/**
+ * Create a SpiceDataView from an ArrayBuffer.
+ *
+ * @param buffer     - The source ArrayBuffer.
+ * @param byteOffset - Optional byte offset.
+ * @param byteLength - Optional byte length.
+ * @returns A new SpiceDataView.
+ */
+declare function createSpiceDataView(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number): SpiceDataView;
+/**
+ * Create a standard DataView from an ArrayBuffer.
+ *
+ * Convenience function that mirrors the original SpiceDataView constructor
+ * signature but returns a standard DataView. Useful for migrating call sites
+ * incrementally.
+ *
+ * @param buffer     - The source ArrayBuffer.
+ * @param byteOffset - Optional byte offset.
+ * @param byteLength - Optional byte length.
+ * @returns A new standard DataView.
+ */
+declare function createDataView(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number): DataView;
+export { SpiceDataView, createSpiceDataView, createDataView, };
+//# sourceMappingURL=spicedataview.d.ts.map

package/dist/protocol/spicedataview.d.ts.map

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