@napolab/texture-bridge-renderer 0.4.1 → 0.6.0

package/dist/index.cjs

@@ -121,6 +121,11 @@ var FpsCounter = class {
 		this.count = 0;
 		this.lastTime = Date.now();
 	}
+	/** Reset the counter, discarding any accumulated frames and time. */
+	reset() {
+		this.count = 0;
+		this.lastTime = Date.now();
+	}
 	/** Call on every frame. Returns FPS when 1 second has elapsed, otherwise null. */
 	tick() {
 		this.count++;
@@ -155,6 +160,24 @@ var TextureBridgeImpl = class extends events.EventEmitter {
 	get isDisposed() {
 		return this._disposed;
 	}
+	/** Handle a paint event from the offscreen BrowserWindow. */
+	handlePaint(event) {
+		const texture = event.texture;
+		if (!texture?.textureInfo) return;
+		try {
+			if (this._disposed) return;
+			(0, _napolab_texture_bridge_core.sendTextureFromPaintEvent)(this.sender, texture.textureInfo);
+			this.previewManager?.sendFrame(texture);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		} finally {
+			texture.release?.();
+		}
+		if (this._disposed) return;
+		const fps = this.fpsCounter.tick();
+		if (fps !== null) this.emit("fps", fps);
+	}
 	openPreview() {
 		if (this._disposed) return;
 		if (!this.previewManager) this.previewManager = new PreviewManager(this.options.width, this.options.height, this.options.preview);
@@ -165,6 +188,7 @@ var TextureBridgeImpl = class extends events.EventEmitter {
 	}
 	resize(width, height) {
 		if (this._disposed) return;
+		const prevOpts = this.options;
 		this.options = {
 			...this.options,
 			width,
@@ -172,7 +196,14 @@ var TextureBridgeImpl = class extends events.EventEmitter {
 		};
 		this._renderWindow.setSize(width, height);
 		this.sender.stop();
-		this.sender = new _napolab_texture_bridge_core.TextureSender(this.options.name, width, height);
+		try {
+			this.sender = new _napolab_texture_bridge_core.TextureSender(this.options.name, width, height);
+		} catch (err) {
+			this.options = prevOpts;
+			this._renderWindow.setSize(prevOpts.width, prevOpts.height);
+			this.sender = new _napolab_texture_bridge_core.TextureSender(prevOpts.name, prevOpts.width, prevOpts.height);
+			throw err;
+		}
 		this.previewManager?.updateSize(width, height);
 		this.emit("resize", width, height);
 	}
@@ -186,6 +217,9 @@ var TextureBridgeImpl = class extends events.EventEmitter {
 		this.emit("disposed");
 		this.removeAllListeners();
 	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
 };
 /**
 * Create a fully-wired texture bridge: offscreen window, native sender,
@@ -215,19 +249,7 @@ async function createTextureBridge(options) {
 	}
 	const bridge = new TextureBridgeImpl(renderWindow, sender, previewManager, options);
 	renderWindow.webContents.on("paint", (event) => {
-		const texture = event.texture;
-		if (!texture?.textureInfo) return;
-		try {
-			(0, _napolab_texture_bridge_core.sendTextureFromPaintEvent)(bridge.sender, texture.textureInfo);
-			bridge.previewManager?.sendFrame(texture);
-		} catch (err) {
-			const error = err instanceof Error ? err : new Error(String(err));
-			bridge.emit("error", error);
-		} finally {
-			texture.release?.();
-		}
-		const fps = bridge.fpsCounter.tick();
-		if (fps !== null) bridge.emit("fps", fps);
+		bridge.handlePaint(event);
 	});
 	renderWindow.webContents.setFrameRate(frameRate);
 	if (rendererUrl.startsWith("http://") || rendererUrl.startsWith("https://")) await renderWindow.loadURL(rendererUrl);
@@ -238,4 +260,115 @@ async function createTextureBridge(options) {
 }
 
 //#endregion
-exports.createTextureBridge = createTextureBridge;
+//#region src/receiver.ts
+var TextureReceiverBridgeImpl = class extends events.EventEmitter {
+	constructor(receiver, pollIntervalMs) {
+		super();
+		this.fpsCounter = new FpsCounter();
+		this._disposed = false;
+		this._timer = null;
+		this.receiver = receiver;
+		this.pollIntervalMs = pollIntervalMs;
+	}
+	get isDisposed() {
+		return this._disposed;
+	}
+	start() {
+		if (this._disposed || this._timer) return;
+		this.fpsCounter.reset();
+		this._timer = setInterval(() => this._poll(), this.pollIntervalMs);
+	}
+	stop() {
+		if (this._timer) {
+			clearInterval(this._timer);
+			this._timer = null;
+		}
+	}
+	dispose() {
+		if (this._disposed) return;
+		this._disposed = true;
+		this.stop();
+		this.receiver.stop();
+		this.emit("disposed");
+		this.removeAllListeners();
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	_poll() {
+		if (this._disposed) return;
+		try {
+			if (!this.receiver.hasNewFrame()) return;
+			const frame = this.receiver.receiveFrame();
+			if (!frame) return;
+			this.emit("frame", frame);
+			const fps = this.fpsCounter.tick();
+			if (fps !== null) this.emit("fps", fps);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		}
+	}
+};
+function createTextureReceiver(options) {
+	const { senderName, appName, serverUuid, pollIntervalMs = 16 } = options;
+	return new TextureReceiverBridgeImpl(new _napolab_texture_bridge_core.TextureReceiver(senderName, appName, serverUuid), pollIntervalMs);
+}
+
+//#endregion
+//#region src/discovery.ts
+var SenderDiscovery = class extends events.EventEmitter {
+	constructor(..._args) {
+		super(..._args);
+		this._senders = [];
+		this._timer = null;
+		this._disposed = false;
+	}
+	get isDisposed() {
+		return this._disposed;
+	}
+	start(intervalMs = 1e3) {
+		if (this._disposed || this._timer) return;
+		this._timer = setInterval(() => this._refresh(), intervalMs);
+	}
+	stop() {
+		if (this._timer) {
+			clearInterval(this._timer);
+			this._timer = null;
+		}
+	}
+	getSenders() {
+		return [...this._senders];
+	}
+	dispose() {
+		if (this._disposed) return;
+		this._disposed = true;
+		this.stop();
+		this.removeAllListeners();
+	}
+	_refresh() {
+		if (this._disposed) return;
+		try {
+			const current = (0, _napolab_texture_bridge_core.listSenders)();
+			const prev = this._senders;
+			const added = current.filter((c) => !prev.some((p) => this._isSame(c, p)));
+			const removed = prev.filter((p) => !current.some((c) => this._isSame(c, p)));
+			this._senders = current;
+			if (added.length > 0) this.emit("added", added);
+			if (removed.length > 0) this.emit("removed", removed);
+			if (added.length > 0 || removed.length > 0) this.emit("updated", current);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		}
+	}
+	_isSame(a, b) {
+		if (a.uuid && b.uuid) return a.uuid === b.uuid;
+		return a.name === b.name && a.appName === b.appName;
+	}
+};
+
+//#endregion
+exports.SenderDiscovery = SenderDiscovery;
+exports.createTextureBridge = createTextureBridge;
+exports.createTextureReceiver = createTextureReceiver;

package/dist/index.d.cts

@@ -1,4 +1,6 @@
 import { BrowserWindow } from "electron";
+import { ReceivedFrame, SenderInfo } from "@napolab/texture-bridge-core";
+import { EventEmitter } from "events";
 
 //#region src/types.d.ts
 /** Options for the preview window */
@@ -50,8 +52,10 @@ interface TextureBridge {
   readonly previewWindow: BrowserWindow | null;
   /** Whether the bridge has been disposed */
   readonly isDisposed: boolean;
-  /** Tear down all resources */
+  /** Tear down all resources. Terminal operation — the bridge cannot be reused afterward. */
   dispose(): void;
+  /** Alias for dispose(), enabling `using bridge = await createTextureBridge(...)` */
+  [Symbol.dispose](): void;
 }
 //#endregion
 //#region src/bridge.d.ts
@@ -63,4 +67,51 @@ interface TextureBridge {
  */
 declare function createTextureBridge(options: TextureBridgeOptions): Promise<TextureBridge>;
 //#endregion
-export { type BridgeEvents, type PreviewOptions, type TextureBridge, type TextureBridgeOptions, createTextureBridge };
+//#region src/receiver.d.ts
+interface TextureReceiverBridgeOptions {
+  senderName: string;
+  appName?: string;
+  serverUuid?: string;
+  pollIntervalMs?: number;
+}
+interface ReceiverBridgeEvents {
+  frame: [frame: ReceivedFrame];
+  fps: [fps: number];
+  error: [error: Error];
+  disposed: [];
+}
+interface TextureReceiverBridge {
+  on<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  off<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  once<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  start(): void;
+  stop(): void;
+  /** Tear down all resources. Terminal operation — the bridge cannot be reused afterward. */
+  dispose(): void;
+  /** Alias for dispose(), enabling `using receiver = createTextureReceiver(...)` */
+  [Symbol.dispose](): void;
+  readonly isDisposed: boolean;
+}
+declare function createTextureReceiver(options: TextureReceiverBridgeOptions): TextureReceiverBridge;
+//#endregion
+//#region src/discovery.d.ts
+interface SenderDiscoveryEvents {
+  updated: [senders: SenderInfo[]];
+  added: [senders: SenderInfo[]];
+  removed: [senders: SenderInfo[]];
+  error: [error: Error];
+}
+declare class SenderDiscovery extends EventEmitter {
+  private _senders;
+  private _timer;
+  private _disposed;
+  get isDisposed(): boolean;
+  start(intervalMs?: number): void;
+  stop(): void;
+  getSenders(): SenderInfo[];
+  dispose(): void;
+  private _refresh;
+  private _isSame;
+}
+//#endregion
+export { type BridgeEvents, type PreviewOptions, type ReceiverBridgeEvents, SenderDiscovery, type SenderDiscoveryEvents, type TextureBridge, type TextureBridgeOptions, type TextureReceiverBridge, type TextureReceiverBridgeOptions, createTextureBridge, createTextureReceiver };

package/dist/index.d.mts

@@ -1,4 +1,6 @@
+import { EventEmitter } from "events";
 import { BrowserWindow } from "electron";
+import { ReceivedFrame, SenderInfo } from "@napolab/texture-bridge-core";
 
 //#region src/types.d.ts
 /** Options for the preview window */
@@ -50,8 +52,10 @@ interface TextureBridge {
   readonly previewWindow: BrowserWindow | null;
   /** Whether the bridge has been disposed */
   readonly isDisposed: boolean;
-  /** Tear down all resources */
+  /** Tear down all resources. Terminal operation — the bridge cannot be reused afterward. */
   dispose(): void;
+  /** Alias for dispose(), enabling `using bridge = await createTextureBridge(...)` */
+  [Symbol.dispose](): void;
 }
 //#endregion
 //#region src/bridge.d.ts
@@ -63,4 +67,51 @@ interface TextureBridge {
  */
 declare function createTextureBridge(options: TextureBridgeOptions): Promise<TextureBridge>;
 //#endregion
-export { type BridgeEvents, type PreviewOptions, type TextureBridge, type TextureBridgeOptions, createTextureBridge };
+//#region src/receiver.d.ts
+interface TextureReceiverBridgeOptions {
+  senderName: string;
+  appName?: string;
+  serverUuid?: string;
+  pollIntervalMs?: number;
+}
+interface ReceiverBridgeEvents {
+  frame: [frame: ReceivedFrame];
+  fps: [fps: number];
+  error: [error: Error];
+  disposed: [];
+}
+interface TextureReceiverBridge {
+  on<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  off<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  once<K extends keyof ReceiverBridgeEvents>(event: K, listener: (...args: ReceiverBridgeEvents[K]) => void): this;
+  start(): void;
+  stop(): void;
+  /** Tear down all resources. Terminal operation — the bridge cannot be reused afterward. */
+  dispose(): void;
+  /** Alias for dispose(), enabling `using receiver = createTextureReceiver(...)` */
+  [Symbol.dispose](): void;
+  readonly isDisposed: boolean;
+}
+declare function createTextureReceiver(options: TextureReceiverBridgeOptions): TextureReceiverBridge;
+//#endregion
+//#region src/discovery.d.ts
+interface SenderDiscoveryEvents {
+  updated: [senders: SenderInfo[]];
+  added: [senders: SenderInfo[]];
+  removed: [senders: SenderInfo[]];
+  error: [error: Error];
+}
+declare class SenderDiscovery extends EventEmitter {
+  private _senders;
+  private _timer;
+  private _disposed;
+  get isDisposed(): boolean;
+  start(intervalMs?: number): void;
+  stop(): void;
+  getSenders(): SenderInfo[];
+  dispose(): void;
+  private _refresh;
+  private _isSame;
+}
+//#endregion
+export { type BridgeEvents, type PreviewOptions, type ReceiverBridgeEvents, SenderDiscovery, type SenderDiscoveryEvents, type TextureBridge, type TextureBridgeOptions, type TextureReceiverBridge, type TextureReceiverBridgeOptions, createTextureBridge, createTextureReceiver };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { EventEmitter } from "events";
 import { BrowserWindow, app, ipcMain, sharedTexture } from "electron";
-import { TextureSender, sendTextureFromPaintEvent } from "@napolab/texture-bridge-core";
+import { TextureReceiver, TextureSender, listSenders, sendTextureFromPaintEvent } from "@napolab/texture-bridge-core";
 import path from "path";
 
 //#region src/preview-manager.ts
@@ -92,6 +92,11 @@ var FpsCounter = class {
 		this.count = 0;
 		this.lastTime = Date.now();
 	}
+	/** Reset the counter, discarding any accumulated frames and time. */
+	reset() {
+		this.count = 0;
+		this.lastTime = Date.now();
+	}
 	/** Call on every frame. Returns FPS when 1 second has elapsed, otherwise null. */
 	tick() {
 		this.count++;
@@ -126,6 +131,24 @@ var TextureBridgeImpl = class extends EventEmitter {
 	get isDisposed() {
 		return this._disposed;
 	}
+	/** Handle a paint event from the offscreen BrowserWindow. */
+	handlePaint(event) {
+		const texture = event.texture;
+		if (!texture?.textureInfo) return;
+		try {
+			if (this._disposed) return;
+			sendTextureFromPaintEvent(this.sender, texture.textureInfo);
+			this.previewManager?.sendFrame(texture);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		} finally {
+			texture.release?.();
+		}
+		if (this._disposed) return;
+		const fps = this.fpsCounter.tick();
+		if (fps !== null) this.emit("fps", fps);
+	}
 	openPreview() {
 		if (this._disposed) return;
 		if (!this.previewManager) this.previewManager = new PreviewManager(this.options.width, this.options.height, this.options.preview);
@@ -136,6 +159,7 @@ var TextureBridgeImpl = class extends EventEmitter {
 	}
 	resize(width, height) {
 		if (this._disposed) return;
+		const prevOpts = this.options;
 		this.options = {
 			...this.options,
 			width,
@@ -143,7 +167,14 @@ var TextureBridgeImpl = class extends EventEmitter {
 		};
 		this._renderWindow.setSize(width, height);
 		this.sender.stop();
-		this.sender = new TextureSender(this.options.name, width, height);
+		try {
+			this.sender = new TextureSender(this.options.name, width, height);
+		} catch (err) {
+			this.options = prevOpts;
+			this._renderWindow.setSize(prevOpts.width, prevOpts.height);
+			this.sender = new TextureSender(prevOpts.name, prevOpts.width, prevOpts.height);
+			throw err;
+		}
 		this.previewManager?.updateSize(width, height);
 		this.emit("resize", width, height);
 	}
@@ -157,6 +188,9 @@ var TextureBridgeImpl = class extends EventEmitter {
 		this.emit("disposed");
 		this.removeAllListeners();
 	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
 };
 /**
 * Create a fully-wired texture bridge: offscreen window, native sender,
@@ -186,19 +220,7 @@ async function createTextureBridge(options) {
 	}
 	const bridge = new TextureBridgeImpl(renderWindow, sender, previewManager, options);
 	renderWindow.webContents.on("paint", (event) => {
-		const texture = event.texture;
-		if (!texture?.textureInfo) return;
-		try {
-			sendTextureFromPaintEvent(bridge.sender, texture.textureInfo);
-			bridge.previewManager?.sendFrame(texture);
-		} catch (err) {
-			const error = err instanceof Error ? err : new Error(String(err));
-			bridge.emit("error", error);
-		} finally {
-			texture.release?.();
-		}
-		const fps = bridge.fpsCounter.tick();
-		if (fps !== null) bridge.emit("fps", fps);
+		bridge.handlePaint(event);
 	});
 	renderWindow.webContents.setFrameRate(frameRate);
 	if (rendererUrl.startsWith("http://") || rendererUrl.startsWith("https://")) await renderWindow.loadURL(rendererUrl);
@@ -209,4 +231,113 @@ async function createTextureBridge(options) {
 }
 
 //#endregion
-export { createTextureBridge };
+//#region src/receiver.ts
+var TextureReceiverBridgeImpl = class extends EventEmitter {
+	constructor(receiver, pollIntervalMs) {
+		super();
+		this.fpsCounter = new FpsCounter();
+		this._disposed = false;
+		this._timer = null;
+		this.receiver = receiver;
+		this.pollIntervalMs = pollIntervalMs;
+	}
+	get isDisposed() {
+		return this._disposed;
+	}
+	start() {
+		if (this._disposed || this._timer) return;
+		this.fpsCounter.reset();
+		this._timer = setInterval(() => this._poll(), this.pollIntervalMs);
+	}
+	stop() {
+		if (this._timer) {
+			clearInterval(this._timer);
+			this._timer = null;
+		}
+	}
+	dispose() {
+		if (this._disposed) return;
+		this._disposed = true;
+		this.stop();
+		this.receiver.stop();
+		this.emit("disposed");
+		this.removeAllListeners();
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	_poll() {
+		if (this._disposed) return;
+		try {
+			if (!this.receiver.hasNewFrame()) return;
+			const frame = this.receiver.receiveFrame();
+			if (!frame) return;
+			this.emit("frame", frame);
+			const fps = this.fpsCounter.tick();
+			if (fps !== null) this.emit("fps", fps);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		}
+	}
+};
+function createTextureReceiver(options) {
+	const { senderName, appName, serverUuid, pollIntervalMs = 16 } = options;
+	return new TextureReceiverBridgeImpl(new TextureReceiver(senderName, appName, serverUuid), pollIntervalMs);
+}
+
+//#endregion
+//#region src/discovery.ts
+var SenderDiscovery = class extends EventEmitter {
+	constructor(..._args) {
+		super(..._args);
+		this._senders = [];
+		this._timer = null;
+		this._disposed = false;
+	}
+	get isDisposed() {
+		return this._disposed;
+	}
+	start(intervalMs = 1e3) {
+		if (this._disposed || this._timer) return;
+		this._timer = setInterval(() => this._refresh(), intervalMs);
+	}
+	stop() {
+		if (this._timer) {
+			clearInterval(this._timer);
+			this._timer = null;
+		}
+	}
+	getSenders() {
+		return [...this._senders];
+	}
+	dispose() {
+		if (this._disposed) return;
+		this._disposed = true;
+		this.stop();
+		this.removeAllListeners();
+	}
+	_refresh() {
+		if (this._disposed) return;
+		try {
+			const current = listSenders();
+			const prev = this._senders;
+			const added = current.filter((c) => !prev.some((p) => this._isSame(c, p)));
+			const removed = prev.filter((p) => !current.some((c) => this._isSame(c, p)));
+			this._senders = current;
+			if (added.length > 0) this.emit("added", added);
+			if (removed.length > 0) this.emit("removed", removed);
+			if (added.length > 0 || removed.length > 0) this.emit("updated", current);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			this.emit("error", error);
+		}
+	}
+	_isSame(a, b) {
+		if (a.uuid && b.uuid) return a.uuid === b.uuid;
+		return a.name === b.name && a.appName === b.appName;
+	}
+};
+
+//#endregion
+export { SenderDiscovery, createTextureBridge, createTextureReceiver };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napolab/texture-bridge-renderer",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "High-level factory API for GPU texture bridge (BrowserWindow + Preview + Sender)",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -25,7 +25,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@napolab/texture-bridge-core": "0.4.1"
+    "@napolab/texture-bridge-core": "0.6.0"
   },
   "peerDependencies": {
     "electron": ">=40.0.0"
@@ -53,6 +53,7 @@
   ],
   "scripts": {
     "build": "tsdown src/index.ts src/client/index.ts src/client/worker-protocol.ts --format cjs,esm --dts && cp -r src/assets dist/assets",
+    "test": "vitest run",
     "typecheck": "tsgo --noEmit"
   }
 }