@napolab/texture-bridge-core 0.2.0

package/dist/index.cjs

@@ -0,0 +1,29 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _napolab_texture_bridge = require("@napolab/texture-bridge");
+
+//#region src/index.ts
+/**
+* Send a texture from an Electron paint event to Syphon/Spout.
+*
+* Handles platform detection and buffer extraction automatically.
+*/
+function sendTextureFromPaintEvent(sender, textureInfo) {
+	const { handle, codedSize } = textureInfo;
+	if (process.platform === "win32") {
+		const ntHandle = handle.ntHandle;
+		if (!ntHandle || !Buffer.isBuffer(ntHandle)) return;
+		const handleValue = Number(ntHandle.readBigInt64LE(0));
+		sender.send(handleValue, codedSize.width, codedSize.height);
+		return;
+	}
+	if (process.platform === "darwin") {
+		const ioSurface = handle.ioSurface;
+		if (!ioSurface) return;
+		sender.sendSurface(ioSurface, codedSize.width, codedSize.height);
+	}
+}
+
+//#endregion
+exports.TextureSender = _napolab_texture_bridge.TextureSender;
+exports.getPlatform = _napolab_texture_bridge.getPlatform;
+exports.sendTextureFromPaintEvent = sendTextureFromPaintEvent;

package/dist/index.d.cts

@@ -0,0 +1,40 @@
+import { TextureSender, getPlatform } from "@napolab/texture-bridge";
+
+//#region src/types.d.ts
+/** Supported pixel formats for shared textures */
+type PixelFormat = "bgra" | "nv12" | "rgba" | "rgbaf16";
+/** Electron paint event texture info */
+interface TextureInfo {
+  pixelFormat: PixelFormat;
+  codedSize: {
+    width: number;
+    height: number;
+  };
+  visibleRect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  handle: {
+    ntHandle?: Buffer;
+    ioSurface?: Buffer;
+  };
+}
+/** Electron paint event texture with release callback */
+interface PaintTexture {
+  textureInfo: TextureInfo;
+  release?: () => void;
+}
+/** Platform-specific texture sharing protocol */
+type Platform = "spout" | "syphon-metal" | "unsupported";
+//#endregion
+//#region src/index.d.ts
+/**
+ * Send a texture from an Electron paint event to Syphon/Spout.
+ *
+ * Handles platform detection and buffer extraction automatically.
+ */
+declare function sendTextureFromPaintEvent(sender: InstanceType<typeof TextureSender>, textureInfo: TextureInfo): void;
+//#endregion
+export { type PaintTexture, type PixelFormat, type Platform, type TextureInfo, TextureSender, getPlatform, sendTextureFromPaintEvent };

package/dist/index.d.mts

@@ -0,0 +1,40 @@
+import { TextureSender, getPlatform } from "@napolab/texture-bridge";
+
+//#region src/types.d.ts
+/** Supported pixel formats for shared textures */
+type PixelFormat = "bgra" | "nv12" | "rgba" | "rgbaf16";
+/** Electron paint event texture info */
+interface TextureInfo {
+  pixelFormat: PixelFormat;
+  codedSize: {
+    width: number;
+    height: number;
+  };
+  visibleRect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  handle: {
+    ntHandle?: Buffer;
+    ioSurface?: Buffer;
+  };
+}
+/** Electron paint event texture with release callback */
+interface PaintTexture {
+  textureInfo: TextureInfo;
+  release?: () => void;
+}
+/** Platform-specific texture sharing protocol */
+type Platform = "spout" | "syphon-metal" | "unsupported";
+//#endregion
+//#region src/index.d.ts
+/**
+ * Send a texture from an Electron paint event to Syphon/Spout.
+ *
+ * Handles platform detection and buffer extraction automatically.
+ */
+declare function sendTextureFromPaintEvent(sender: InstanceType<typeof TextureSender>, textureInfo: TextureInfo): void;
+//#endregion
+export { type PaintTexture, type PixelFormat, type Platform, type TextureInfo, TextureSender, getPlatform, sendTextureFromPaintEvent };

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import { TextureSender, getPlatform } from "@napolab/texture-bridge";
+
+//#region src/index.ts
+/**
+* Send a texture from an Electron paint event to Syphon/Spout.
+*
+* Handles platform detection and buffer extraction automatically.
+*/
+function sendTextureFromPaintEvent(sender, textureInfo) {
+	const { handle, codedSize } = textureInfo;
+	if (process.platform === "win32") {
+		const ntHandle = handle.ntHandle;
+		if (!ntHandle || !Buffer.isBuffer(ntHandle)) return;
+		const handleValue = Number(ntHandle.readBigInt64LE(0));
+		sender.send(handleValue, codedSize.width, codedSize.height);
+		return;
+	}
+	if (process.platform === "darwin") {
+		const ioSurface = handle.ioSurface;
+		if (!ioSurface) return;
+		sender.sendSurface(ioSurface, codedSize.width, codedSize.height);
+	}
+}
+
+//#endregion
+export { TextureSender, getPlatform, sendTextureFromPaintEvent };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@napolab/texture-bridge-core",
+  "version": "0.2.0",
+  "description": "High-level GPU texture sharing for Electron (Spout + Syphon Metal)",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@napolab/texture-bridge": "0.2.0"
+  },
+  "peerDependencies": {
+    "electron": ">=40.0.0"
+  },
+  "peerDependenciesMeta": {
+    "electron": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown src/index.ts --format cjs,esm --dts --exports",
+    "typecheck": "tsgo --noEmit"
+  }
+}