spice-html5-react 0.1.0

package/dist/protocol/webm.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Interface for WebM/EBML elements that can be serialized to an ArrayBuffer.
+ * Unlike the protocol Serializable interface, toBuffer returns the new write
+ * offset so elements can be composed sequentially.
+ */
+interface WebmElement {
+    toBuffer(a: ArrayBuffer, at: number): number;
+    bufferSize(): number;
+}
+export declare const WebmConstants: {
+    readonly CLUSTER_SIMPLEBLOCK_FLAG_KEYFRAME: number;
+    readonly OPUS_FREQUENCY: 48000;
+    readonly OPUS_CHANNELS: 2;
+    readonly SPICE_PLAYBACK_CODEC: "audio/webm; codecs=\"opus\"";
+    readonly MAX_CLUSTER_TIME: 1000;
+    readonly EXPECTED_PACKET_DURATION: 10;
+    readonly GAP_DETECTION_THRESHOLD: 50;
+    readonly SPICE_VP8_CODEC: "video/webm; codecs=\"vp8\"";
+};
+export declare const Constants: {
+    readonly CLUSTER_SIMPLEBLOCK_FLAG_KEYFRAME: number;
+    readonly OPUS_FREQUENCY: 48000;
+    readonly OPUS_CHANNELS: 2;
+    readonly SPICE_PLAYBACK_CODEC: "audio/webm; codecs=\"opus\"";
+    readonly MAX_CLUSTER_TIME: 1000;
+    readonly EXPECTED_PACKET_DURATION: 10;
+    readonly GAP_DETECTION_THRESHOLD: 50;
+    readonly SPICE_VP8_CODEC: "video/webm; codecs=\"vp8\"";
+};
+export declare class WebmAudio implements WebmElement {
+    private readonly id;
+    private readonly samplingFrequency;
+    private readonly channels;
+    constructor(frequency: number);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmVideo implements WebmElement {
+    private readonly id;
+    private readonly flagInterlaced;
+    readonly width: number;
+    readonly height: number;
+    constructor(width: number, height: number);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmAudioTrackEntry implements WebmElement {
+    private readonly id;
+    private readonly number;
+    private readonly uid;
+    private readonly type;
+    private readonly flagEnabled;
+    private readonly flagDefault;
+    private readonly flagForced;
+    private readonly flagLacing;
+    private readonly minCache;
+    private readonly maxBlockAdditionId;
+    private readonly codecDecodeAll;
+    private readonly seekPreRoll;
+    private readonly codecDelay;
+    private readonly codecId;
+    private readonly audio;
+    private readonly codecPrivate;
+    constructor();
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmVideoTrackEntry implements WebmElement {
+    private readonly id;
+    private readonly number;
+    private readonly uid;
+    private readonly type;
+    private readonly flagEnabled;
+    private readonly flagDefault;
+    private readonly flagForced;
+    private readonly flagLacing;
+    private readonly minCache;
+    private readonly maxBlockAdditionId;
+    private readonly codecId;
+    private readonly codecDecodeAll;
+    private readonly seekPreRoll;
+    readonly video: WebmVideo;
+    constructor(width: number, height: number);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmTracks implements WebmElement {
+    private readonly id;
+    private readonly trackEntry;
+    constructor(entry: WebmAudioTrackEntry | WebmVideoTrackEntry);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmCluster implements WebmElement {
+    readonly timecode: number;
+    constructor(timecode: number);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmSimpleBlock implements WebmElement {
+    readonly timecode: number;
+    readonly data: ArrayBuffer;
+    readonly keyframe: boolean;
+    constructor(timecode: number, data: ArrayBuffer, keyframe: boolean);
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export declare class WebmHeader implements WebmElement {
+    private readonly ebml;
+    private readonly segment;
+    private readonly seekHead;
+    private readonly info;
+    constructor();
+    toBuffer(a: ArrayBuffer, at?: number): number;
+    bufferSize(): number;
+}
+export { WebmAudio as Audio, WebmVideo as Video, WebmAudioTrackEntry as AudioTrackEntry, WebmVideoTrackEntry as VideoTrackEntry, WebmTracks as Tracks, WebmCluster as Cluster, WebmSimpleBlock as SimpleBlock, WebmHeader as Header, };
+//# sourceMappingURL=webm.d.ts.map

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

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

package/dist/protocol/wire.d.ts

@@ -0,0 +1,81 @@
+import { SpiceMiniData } from './spicemsg';
+
+/**
+ * Callback invoked when a complete frame has been reassembled.
+ * The first argument is the frame data; the second is the optional
+ * saved SpiceMiniData header.
+ */
+export type WireCallback = (data: ArrayBuffer, header: SpiceMiniData | undefined) => void;
+/**
+ * Minimal interface for the "connection" object that owns the WebSocket.
+ * SpiceConn will satisfy this once it is implemented (US-014).
+ * Using an interface here avoids a circular dependency.
+ */
+export interface WireOwner {
+    ws: WebSocket;
+    connectionId: number;
+    type: number;
+}
+/**
+ * Receives binary data from a WebSocket and reassembles it into complete
+ * protocol frames of the requested size, invoking a callback for each
+ * completed frame.
+ *
+ * Usage pattern:
+ *   1. Construct with a WireOwner and callback.
+ *   2. Call `request(n)` to indicate that n bytes are expected.
+ *   3. Incoming WebSocket messages are buffered and, once `n` bytes are
+ *      available, the callback is invoked with a contiguous ArrayBuffer
+ *      of exactly `n` bytes.
+ *   4. Optionally call `saveHeader(h)` before `request()` to attach a
+ *      SpiceMiniData header that will be passed to the callback.
+ */
+export declare class SpiceWireReader {
+    /** The connection that owns the WebSocket. */
+    private readonly owner;
+    /** Callback invoked when a complete frame is ready. */
+    private readonly callback;
+    /** Number of bytes needed to complete the current frame (0 = just buffer). */
+    private needed;
+    /** Total bytes currently buffered across all entries in `buffers`. */
+    private size;
+    /** Queue of ArrayBuffer chunks received from the WebSocket. */
+    private buffers;
+    /** Optional saved SpiceMiniData header to relay with the next frame. */
+    private savedMsgHeader;
+    /** Bound message handler so we can remove the listener on cleanup. */
+    private readonly boundOnMessage;
+    constructor(owner: WireOwner, callback: WireCallback);
+    /**
+     * Request a frame of exactly `n` bytes.  When enough data has been
+     * buffered, the callback will be invoked.
+     */
+    request(n: number): void;
+    /**
+     * Save a SpiceMiniData header to be passed along with the next frame.
+     */
+    saveHeader(h: SpiceMiniData): void;
+    /**
+     * Clear the saved header.
+     */
+    clearHeader(): void;
+    /**
+     * Detach the WebSocket message listener.  Call this on connection
+     * teardown to avoid processing messages after the connection is closed.
+     */
+    cleanup(): void;
+    /**
+     * WebSocket "message" event handler.
+     */
+    private onMessage;
+    /**
+     * Process an incoming ArrayBuffer chunk from the WebSocket.
+     *
+     * If no bytes are currently needed (`needed === 0`), the chunk is simply
+     * buffered.  Otherwise the method attempts to assemble complete frames
+     * and deliver them via the callback.
+     */
+    private inbound;
+}
+export { SpiceWireReader as default };
+//# sourceMappingURL=wire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/protocol/wire.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM3C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACvB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,GAAG,SAAS,KAChC,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IACxB,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAElC,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAAa;IAE3B,sEAAsE;IACtE,OAAO,CAAC,IAAI,CAAa;IAEzB,+DAA+D;IAC/D,OAAO,CAAC,OAAO,CAAqB;IAEpC,wEAAwE;IACxE,OAAO,CAAC,cAAc,CAAwC;IAE9D,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyC;gBAE5D,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY;IAcpD;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAKlC;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,OAAO,IAAI,IAAI;IAaf;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;CAmElB;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/utils/atKeynames.d.ts

@@ -0,0 +1,96 @@
+export declare const KeyNames: {
+    readonly KEY_Escape: 1;
+    readonly KEY_1: 2;
+    readonly KEY_2: 3;
+    readonly KEY_3: 4;
+    readonly KEY_4: 5;
+    readonly KEY_5: 6;
+    readonly KEY_6: 7;
+    readonly KEY_7: 8;
+    readonly KEY_8: 9;
+    readonly KEY_9: 10;
+    readonly KEY_0: 11;
+    readonly KEY_Minus: 12;
+    readonly KEY_Equal: 13;
+    readonly KEY_BackSpace: 14;
+    readonly KEY_Tab: 15;
+    readonly KEY_Q: 16;
+    readonly KEY_W: 17;
+    readonly KEY_E: 18;
+    readonly KEY_R: 19;
+    readonly KEY_T: 20;
+    readonly KEY_Y: 21;
+    readonly KEY_U: 22;
+    readonly KEY_I: 23;
+    readonly KEY_O: 24;
+    readonly KEY_P: 25;
+    readonly KEY_LBrace: 26;
+    readonly KEY_RBrace: 27;
+    readonly KEY_Enter: 28;
+    readonly KEY_LCtrl: 29;
+    readonly KEY_A: 30;
+    readonly KEY_S: 31;
+    readonly KEY_D: 32;
+    readonly KEY_F: 33;
+    readonly KEY_G: 34;
+    readonly KEY_H: 35;
+    readonly KEY_J: 36;
+    readonly KEY_K: 37;
+    readonly KEY_L: 38;
+    readonly KEY_SemiColon: 39;
+    readonly KEY_Quote: 40;
+    readonly KEY_Tilde: 41;
+    readonly KEY_ShiftL: 42;
+    readonly KEY_BSlash: 43;
+    readonly KEY_Z: 44;
+    readonly KEY_X: 45;
+    readonly KEY_C: 46;
+    readonly KEY_V: 47;
+    readonly KEY_B: 48;
+    readonly KEY_N: 49;
+    readonly KEY_M: 50;
+    readonly KEY_Comma: 51;
+    readonly KEY_Period: 52;
+    readonly KEY_Slash: 53;
+    readonly KEY_ShiftR: 54;
+    readonly KEY_KP_Multiply: 55;
+    readonly KEY_Alt: 56;
+    readonly KEY_Space: 57;
+    readonly KEY_CapsLock: 58;
+    readonly KEY_F1: 59;
+    readonly KEY_F2: 60;
+    readonly KEY_F3: 61;
+    readonly KEY_F4: 62;
+    readonly KEY_F5: 63;
+    readonly KEY_F6: 64;
+    readonly KEY_F7: 65;
+    readonly KEY_F8: 66;
+    readonly KEY_F9: 67;
+    readonly KEY_F10: 68;
+    readonly KEY_NumLock: 69;
+    readonly KEY_ScrollLock: 70;
+    readonly KEY_KP_7: 71;
+    readonly KEY_KP_8: 72;
+    readonly KEY_KP_9: 73;
+    readonly KEY_KP_Minus: 74;
+    readonly KEY_KP_4: 75;
+    readonly KEY_KP_5: 76;
+    readonly KEY_KP_6: 77;
+    readonly KEY_KP_Plus: 78;
+    readonly KEY_KP_1: 79;
+    readonly KEY_KP_2: 80;
+    readonly KEY_KP_3: 81;
+    readonly KEY_KP_0: 82;
+    readonly KEY_KP_Decimal: 83;
+    readonly KEY_SysReqest: 84;
+    readonly KEY_Less: 86;
+    readonly KEY_F11: 87;
+    readonly KEY_F12: 88;
+    readonly KEY_Prefix0: 96;
+    readonly KEY_Prefix1: 97;
+};
+/** Type for any valid key name from the KeyNames mapping */
+export type KeyName = keyof typeof KeyNames;
+/** Type for any valid scancode value from the KeyNames mapping */
+export type Scancode = (typeof KeyNames)[KeyName];
+//# sourceMappingURL=atKeynames.d.ts.map

package/dist/utils/atKeynames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atKeynames.d.ts","sourceRoot":"","sources":["../../src/utils/atKeynames.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmGX,CAAC;AAEX,4DAA4D;AAC5D,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE5C,kEAAkE;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC"}

package/dist/utils/codeToScancode.d.ts

@@ -0,0 +1,2 @@
+export declare const codeToScancode: Readonly<Record<string, number>>;
+//# sourceMappingURL=codeToScancode.d.ts.map

package/dist/utils/codeToScancode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeToScancode.d.ts","sourceRoot":"","sources":["../../src/utils/codeToScancode.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2K3D,CAAC"}

package/dist/utils/debug.d.ts

@@ -0,0 +1,84 @@
+/** Master debug verbosity level (0 = off, higher = more verbose) */
+export declare let DEBUG: number;
+/** Audio playback debug flag (0 = off) */
+export declare let PLAYBACK_DEBUG: number;
+/** Video stream debug flag (0 = off) */
+export declare let STREAM_DEBUG: number;
+/** When true, render draw commands to debug canvases */
+export declare let DUMP_DRAWS: boolean;
+/** When true, dump canvas contents for debugging */
+export declare let DUMP_CANVASES: boolean;
+/** Set the master debug verbosity level */
+export declare function setDebug(level: number): void;
+/** Set the playback debug flag */
+export declare function setPlaybackDebug(level: number): void;
+/** Set the stream debug flag */
+export declare function setStreamDebug(level: number): void;
+/** Set the dump draws flag */
+export declare function setDumpDraws(enabled: boolean): void;
+/** Set the dump canvases flag */
+export declare function setDumpCanvases(enabled: boolean): void;
+/**
+ * We use an Image temporarily, and the image/src does not get garbage
+ * collected as quickly as we might like. This blank image helps with that.
+ */
+export declare const EMPTY_GIF_IMAGE: string;
+/**
+ * Combine two ArrayBuffers into a new one.
+ * FIXME - this can't be optimal. See wire.ts about eliminating the need.
+ */
+export declare function combineArrayBuffers(a1: ArrayBuffer, a2: ArrayBuffer): ArrayBuffer;
+/**
+ * Hex dump an ArrayBuffer to the console for debugging.
+ * Collapses repeated all-zero lines with a "." indicator.
+ */
+export declare function hexdumpBuffer(a: ArrayBuffer): void;
+/**
+ * Convert an ArrayBuffer to a string (treating contents as UTF-16 code units).
+ */
+export declare function arraybufferToStr(buf: ArrayBuffer): string;
+/**
+ * Look up the AT scancode for a given browser keyCode and DOM code string.
+ * Prefers the DOM `code` property (KeyboardEvent.code) when available,
+ * falling back to the legacy `keyCode` property with browser-specific maps.
+ *
+ * @param keyCode - The legacy `KeyboardEvent.keyCode` value
+ * @param code - The DOM `KeyboardEvent.code` string (e.g. "KeyA", "ArrowUp")
+ * @returns The AT scancode, or undefined if no mapping exists
+ */
+export declare function getScancode(keyCode: number, code: string): number | undefined;
+/**
+ * Convert a browser keyCode/code to an AT make (press) scancode.
+ * Logs an alert if no mapping is found.
+ *
+ * @param keyCode - The legacy `KeyboardEvent.keyCode` value
+ * @param code - The DOM `KeyboardEvent.code` string
+ * @returns The AT make scancode, or 0 if unmapped
+ */
+export declare function keycodeToStartScan(keyCode: number, code: string): number;
+/**
+ * Convert a browser keyCode/code to an AT break (release) scancode.
+ * The break code has bit 7 set (single-byte) or bit 15 set (extended).
+ *
+ * @param keyCode - The legacy `KeyboardEvent.keyCode` value
+ * @param code - The DOM `KeyboardEvent.code` string
+ * @returns The AT break scancode, or 0 if unmapped
+ */
+export declare function keycodeToEndScan(keyCode: number, code: string): number;
+/**
+ * Dump the state of an HTMLMediaElement for debugging.
+ */
+export declare function dumpMediaElement(m: HTMLMediaElement): string;
+/**
+ * Dump the state of a MediaSource for debugging.
+ */
+export declare function dumpMediaSource(ms: MediaSource): string;
+/**
+ * Dump the state of a SourceBuffer for debugging.
+ */
+export declare function dumpSourceBuffer(sb: SourceBuffer): string;
+/**
+ * Dump a TimeRanges object for debugging.
+ */
+export declare function dumpTimeRange(tr: TimeRanges | null): string;
+//# sourceMappingURL=debug.d.ts.map

package/dist/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAaA,oEAAoE;AACpE,eAAO,IAAI,KAAK,QAAI,CAAC;AAErB,0CAA0C;AAC1C,eAAO,IAAI,cAAc,QAAI,CAAC;AAE9B,wCAAwC;AACxC,eAAO,IAAI,YAAY,QAAI,CAAC;AAE5B,wDAAwD;AACxD,eAAO,IAAI,UAAU,SAAQ,CAAC;AAE9B,oDAAoD;AACpD,eAAO,IAAI,aAAa,SAAQ,CAAC;AAEjC,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGnD;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGtD;AAMD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MACkC,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,WAAW,CASjF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CA6DlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASzD;AA6JD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB7E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAW5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAIvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAQzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAiB3D"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "spice-html5-react",
+  "version": "0.1.0",
+  "description": "React + TypeScript SPICE protocol client component library",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.freedesktop.org/spice/spice-html5.git"
+  },
+  "keywords": [
+    "spice",
+    "html5",
+    "react",
+    "typescript",
+    "remote-desktop",
+    "websockify"
+  ],
+  "homepage": "https://www.spice-space.org",
+  "author": "SPICE Project <spice-devel@lists.freedesktop.org> (https://www.spice-space.org)",
+
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "jsdom": "^28.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.1.0",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^1.3.0"
+  }
+}