@napolab/texture-bridge-renderer 0.5.1 → 0.6.1

package/dist/index.cjs

@@ -160,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);
@@ -170,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,
@@ -177,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);
 	}
@@ -191,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,
@@ -220,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);
@@ -275,10 +292,12 @@ var TextureReceiverBridgeImpl = class extends events.EventEmitter {
 		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);

package/dist/index.d.cts

@@ -52,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
@@ -84,7 +86,10 @@ interface TextureReceiverBridge {
   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;

package/dist/index.d.mts

@@ -52,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
@@ -84,7 +86,10 @@ interface TextureReceiverBridge {
   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;

package/dist/index.mjs

@@ -131,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);
@@ -141,6 +159,7 @@ var TextureBridgeImpl = class extends EventEmitter {
 	}
 	resize(width, height) {
 		if (this._disposed) return;
+		const prevOpts = this.options;
 		this.options = {
 			...this.options,
 			width,
@@ -148,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);
 	}
@@ -162,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,
@@ -191,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);
@@ -246,10 +263,12 @@ var TextureReceiverBridgeImpl = class extends EventEmitter {
 		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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napolab/texture-bridge-renderer",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "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.5.1"
+    "@napolab/texture-bridge-core": "0.6.1"
   },
   "peerDependencies": {
     "electron": ">=40.0.0"