wgpu-kit 0.9.10

package/dist/three.js

@@ -0,0 +1,33 @@
+// src/interop/three.ts
+function threePoints(sim, THREE, opts = {}) {
+  const { pos } = sim.buffers();
+  const count = pos.length;
+  const positions = new Float32Array(count * 3);
+  const geometry = new THREE.BufferGeometry();
+  const attr = new THREE.BufferAttribute(positions, 3);
+  geometry.setAttribute("position", attr);
+  const material = new THREE.PointsMaterial({
+    size: opts.size ?? 0.015,
+    color: opts.color ?? 9417983,
+    sizeAttenuation: true
+  });
+  const points = new THREE.Points(geometry, material);
+  return {
+    points,
+    async update() {
+      const data = await pos.read();
+      for (let i = 0; i < count; i++) {
+        positions[i * 3] = data[i * 2] ?? 0;
+        positions[i * 3 + 1] = data[i * 2 + 1] ?? 0;
+        positions[i * 3 + 2] = 0;
+      }
+      attr.needsUpdate = true;
+    },
+    dispose() {
+      sim.destroy();
+    }
+  };
+}
+export {
+  threePoints
+};

package/dist/vite.d.ts

@@ -0,0 +1,38 @@
+import type { ElementKernel } from './core/kernel.ts';
+/**
+ * kernel 热重载(Vite 插件 + 客户端助手)。
+ *
+ * 服务端:`wgpuKitHotReload()` 监听 *.wgsl 文件变化,把新代码推给浏览器;
+ * 客户端:`hotKernel(kernel, import.meta.hot, './sim.wgsl')` 收到推送后调 kernel.replace。
+ *
+ * 用法(配合 Vite 的 ?raw 导入):
+ *   import simSrc from './sim.wgsl?raw';
+ *   const k = elementKernel({ state: {...}, code: simSrc });
+ *   hotKernel(k, import.meta.hot, './sim.wgsl');
+ */
+interface HotContext {
+    on(event: string, cb: (data: unknown) => void): void;
+    off?(event: string, cb: (data: unknown) => void): void;
+}
+interface ViteHotUpdateCtx {
+    file: string;
+    read(): string | Promise<string>;
+    server: {
+        ws: {
+            send(payload: {
+                type: string;
+                event: string;
+                data: unknown;
+            }): void;
+        };
+    };
+}
+interface VitePluginLike {
+    name: string;
+    apply?: string;
+    handleHotUpdate?(ctx: ViteHotUpdateCtx): unknown;
+}
+export declare function wgpuKitHotReload(): VitePluginLike;
+/** 把 kernel 注册进热重载:对应 .wgsl 文件一变,自动 kernel.replace */
+export declare function hotKernel(kernel: ElementKernel, hot: HotContext | undefined, file: string): void;
+export {};

package/dist/vite.js

@@ -0,0 +1,30 @@
+// src/vite.ts
+function wgpuKitHotReload() {
+  return {
+    name: "wgpu-kit:hot-reload",
+    handleHotUpdate(ctx) {
+      if (!ctx.file.endsWith(".wgsl")) return;
+      void (async () => {
+        const code = await ctx.read();
+        ctx.server.ws.send({ type: "custom", event: "wgpu-kit:kernel", data: { file: ctx.file, code } });
+      })();
+      return [];
+    }
+  };
+}
+function hotKernel(kernel, hot, file) {
+  if (!hot) return;
+  const suffix = file.slice(file.lastIndexOf("/"));
+  hot.on("wgpu-kit:kernel", (data) => {
+    const d = data;
+    if (typeof d?.code === "string" && typeof d.file === "string" && d.file.endsWith(suffix)) {
+      void kernel.replace(d.code).catch((e) => {
+        console.error("[wgpu-kit] \u70ED\u91CD\u8F7D\u5931\u8D25,\u4FDD\u7559\u65E7\u7248 kernel:", e.message);
+      });
+    }
+  });
+}
+export {
+  hotKernel,
+  wgpuKitHotReload
+};

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "wgpu-kit",
+  "version": "0.9.10",
+  "description": "Browser GPGPU middle layer: 100k particles in 5 lines. WebGPU compute without the boilerplate.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "webgpu",
+    "gpgpu",
+    "compute",
+    "wgsl",
+    "particles",
+    "simulation",
+    "creative-coding",
+    "threejs"
+  ],
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./particles": {
+      "types": "./dist/packs/particles/index.d.ts",
+      "import": "./dist/particles.js"
+    },
+    "./three": {
+      "types": "./dist/interop/three.d.ts",
+      "import": "./dist/three.js"
+    },
+    "./life": {
+      "types": "./dist/packs/life/index.d.ts",
+      "import": "./dist/life.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./fields": {
+      "types": "./dist/packs/fields/index.d.ts",
+      "import": "./dist/fields.js"
+    },
+    "./image": {
+      "types": "./dist/packs/image/index.d.ts",
+      "import": "./dist/image.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    }
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite playground",
+    "build": "node scripts/build.mjs",
+    "build:playground": "vite build playground",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "bundle:tests": "esbuild tests/gpu/smoke.ts --bundle --format=esm --outfile=tests/gpu/smoke.bundle.js --log-level=warning && esbuild tests/gpu/bench.ts --bundle --format=esm --outfile=tests/gpu/bench.bundle.js --log-level=warning && esbuild tests/gpu/packages.ts --bundle --format=esm --outfile=tests/gpu/packages.bundle.js --log-level=warning",
+    "verify": "node scripts/verify.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "@webgpu/types": "^0.1.64",
+    "esbuild": "^0.28.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.6.0",
+    "vite": "^7.0.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nanfengw0w/wgpu-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nanfengw0w/wgpu-kit/issues"
+  },
+  "homepage": "https://github.com/nanfengw0w/wgpu-kit#readme"
+}