@plasius/gpu-worker 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -20,6 +20,39 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 
+## [0.1.9] - 2026-03-13
+
+- **Added**
+  - ADR and TDR guidance describing `@plasius/gpu-worker` as the preferred
+    discrete execution plane for current and future `@plasius/gpu-*` compute
+    packages.
+  - Design documentation for multi-package worker coordination and future effect
+    package expansion.
+  - Optional `createWorkerLoop` telemetry hooks for dispatch samples and
+    per-tick summaries with shared `frameId` correlation support.
+  - `queueMode: "dag"` support for loading and assembling against
+    multi-root DAG-ready queue helpers from `@plasius/gpu-lock-free-queue`.
+  - ADR, TDR, and design documentation for flat versus DAG queue assembly
+    contracts.
+
+- **Changed**
+  - README guidance now points package authors toward worker-job manifests,
+    `@plasius/gpu-performance` budget coordination, and optional
+    `@plasius/gpu-debug` instrumentation.
+  - Worker assembly now guarantees a `complete_job(job_index)` hook is present
+    so flat and DAG queue assets share the same worker completion path.
+  - Queue package resolution now uses the published npm release
+    `@plasius/gpu-lock-free-queue@^0.2.13` instead of the temporary GitHub
+    fallback.
+  - Updated patch-level eslint tooling to the latest versions allowed by the
+    current semver ranges.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.1.8] - 2026-03-04
 
 - **Added**
@@ -156,7 +189,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 
 ---
 
-[Unreleased]: https://github.com/Plasius-LTD/gpu-worker/compare/v0.1.8...HEAD
+[Unreleased]: https://github.com/Plasius-LTD/gpu-worker/compare/v0.1.9...HEAD
 [0.1.0-beta.1]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.0-beta.1
 [0.1.0]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.0
 [0.1.2]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.2
@@ -177,3 +210,4 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 [0.1.3]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.3
 [0.1.4]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.4
 [0.1.8]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.8
+[0.1.9]: https://github.com/Plasius-LTD/gpu-worker/releases/tag/v0.1.9

package/README.md

@@ -54,6 +54,22 @@ By default it applies queue compatibility renames (for example `JobMeta` -> `Job
 set `queueCompat: false` to disable that behavior.
 If you are concatenating WGSL manually, `loadQueueWgsl` provides the same
 compatibility renames by default: `loadQueueWgsl({ url, fetcher, queueCompat: false })`.
+Set `queueMode: "dag"` on `loadQueueWgsl(...)` or `assembleWorkerWgsl(...)`
+to assemble against the multi-root DAG-ready queue helpers from
+`@plasius/gpu-lock-free-queue`.
+
+```js
+const shaderCode = await assembleWorkerWgsl(workerWgsl, {
+  preludeWgsl,
+  jobs,
+  queueMode: "dag",
+});
+```
+
+Worker WGSL now calls `complete_job(job_index)` after `process_job(...)`.
+Queue assets from `@plasius/gpu-lock-free-queue` already provide that hook. If
+you pass a custom queue source without it, the assembler appends a no-op shim so
+existing flat queue integrations keep working.
 
 To bypass the registry, pass jobs directly:
 ```js
@@ -85,11 +101,102 @@ const loop = createWorkerLoop({
 loop.start();
 ```
 
+For opt-in local instrumentation, `createWorkerLoop` also accepts:
+
+- `frameId`: a string or function returning the current frame correlation id.
+- `worker.owner`, `worker.queueClass`, `worker.jobType`, `worker.label`,
+  `worker.workgroupSize`: optional metadata for the dequeue pass.
+- the same metadata fields on each job descriptor.
+- `telemetry.onDispatch(sample)`: called after submit for each worker/job
+  dispatch.
+- `telemetry.onTick(summary)`: called after submit with the per-tick dispatch
+  summary.
+
+That allows direct integration with `@plasius/gpu-debug` without coupling the
+runtime to the package:
+
+```js
+import { createGpuDebugSession } from "@plasius/gpu-debug";
+
+const debug = createGpuDebugSession({ enabled: true });
+
+const loop = createWorkerLoop({
+  device,
+  frameId: () => `frame-${frameNumber}`,
+  worker: {
+    pipeline: workerPipeline,
+    bindGroups: [queueBindGroup],
+    workgroups: [2, 1, 1],
+    workgroupSize: 64,
+    owner: "lighting",
+    queueClass: "lighting",
+    jobType: "worker.dequeue",
+  },
+  jobs: [
+    {
+      pipeline: directLightingPipeline,
+      bindGroups: [queueBindGroup, lightingBindGroup],
+      workgroupCount: [32, 18, 1],
+      workgroupSize: [8, 8, 1],
+      owner: "lighting",
+      queueClass: "lighting",
+      jobType: "lighting.direct",
+    },
+  ],
+  telemetry: {
+    onDispatch(sample) {
+      debug.recordDispatch({
+        owner: sample.owner,
+        queueClass: sample.queueClass,
+        jobType: sample.jobType,
+        frameId: sample.frameId,
+        workgroups: sample.workgroups,
+        workgroupSize: sample.workgroupSize,
+      });
+    },
+  },
+});
+```
+
 ## What this is
 - A minimal GPU worker layer that combines a lock-free queue with user WGSL jobs.
 - A helper to assemble WGSL modules with queue helpers included.
 - A reference job format for fixed-size job dispatch (u32 indices).
 
+## DAG Queue Modes
+
+`@plasius/gpu-worker` now supports two scheduler assembly modes:
+
+- `flat`: the original lock-free FIFO/worklist execution flow.
+- `dag`: a multi-root, priority-aware ready-queue flow where jobs can declare
+  dependencies and join points through their package-owned manifests.
+
+The worker runtime still stays lock-free and policy-light. It does not resolve
+budgets or decide priorities itself. Instead it exposes the queue mode and the
+completion hook needed by package manifests and `@plasius/gpu-performance` to
+coordinate DAG-shaped workloads.
+
+## Package Integration Model
+
+`@plasius/gpu-worker` is the preferred execution plane for discrete GPU work
+across current and future `@plasius/gpu-*` compute packages.
+
+Package authors should:
+
+- register stable worker job types for each effect family,
+- keep scheduling in terms of compact worklists and bounded dispatches,
+- expose `priority`, `dependencies`, and `schedulerMode` metadata in manifests
+  when jobs form ordered DAG stages instead of a flat queue,
+- let `@plasius/gpu-performance` adjust worker budgets instead of building
+  separate package-local governors,
+- expose optional local instrumentation through `createWorkerLoop(..., {
+  telemetry })` and route that into `@plasius/gpu-debug` when clients enable
+  it.
+
+This pattern is intended to scale across post-processing, cloth, fluids,
+lighting refresh, voxel generation, and additional GPU job families without
+splitting scheduling policy across packages.
+
 ## Demo
 The demo enqueues physics and render jobs on the GPU, builds per-type worklists, runs the
 physics kernel, and uses an indirect draw for the particle pass. Install dependencies first
@@ -139,6 +246,9 @@ npm run pack:check
 - `demo/jobs/render.job.wgsl`: Render job kernel (worklist + indirect args).
 - `src/worker.wgsl`: Minimal worker entry point template (dequeue + `process_job` hook).
 - `src/index.js`: Helper functions to load/assemble WGSL.
+- `docs/adrs/*`: architectural decisions for worker runtime and scheduling.
+- `docs/tdrs/*`: technical design records for multi-package worker integration.
+- `docs/design/*`: design notes for package integration, DAG queue modes, and future expansion.
 
 ## Job shape
 Jobs are variable-length payloads stored in a caller-managed buffer. Each job supplies `job_type`, `payload_offset`, and `payload_words` metadata plus a payload stored in the input payload buffer. For simple cases, use a single-word payload containing an index into your workload array.

package/dist/index.cjs

@@ -202,6 +202,15 @@ function getQueueCompatMap(source) {
   }
   return [{ from: /\bJobMeta\b/g, to: "JobDesc" }];
 }
+function normalizeQueueMode(mode) {
+  const resolved = mode ?? "flat";
+  if (!import_gpu_lock_free_queue.schedulerModes.includes(resolved)) {
+    throw new Error(
+      `queueMode must be one of: ${import_gpu_lock_free_queue.schedulerModes.join(", ")}.`
+    );
+  }
+  return resolved;
+}
 function applyCompatMap(source, map) {
   if (!map || map.length === 0) {
     return source;
@@ -276,8 +285,11 @@ async function loadWorkerWgsl(options = {}) {
   return source;
 }
 async function loadQueueWgsl(options = {}) {
-  const { queueCompat = true, ...rest } = options ?? {};
-  const source = await (0, import_gpu_lock_free_queue.loadQueueWgsl)(rest);
+  const { queueCompat = true, queueMode = "flat", ...rest } = options ?? {};
+  const source = await (0, import_gpu_lock_free_queue.loadSchedulerWgsl)({
+    mode: normalizeQueueMode(queueMode),
+    ...rest
+  });
   if (typeof source !== "string") {
     throw new Error("Failed to load queue WGSL source.");
   }
@@ -288,6 +300,16 @@ async function loadQueueWgsl(options = {}) {
   const compatMap = getQueueCompatMap(source);
   return applyCompatMap(source, compatMap);
 }
+function ensureQueueLifecycleHooks(source) {
+  if (/\bfn\s+complete_job\b/.test(source)) {
+    return source;
+  }
+  return `${source}
+
+fn complete_job(job_index: u32) {
+  _ = job_index;
+}`;
+}
 async function loadJobWgsl(options = {}) {
   const { wgsl, url, fetcher, label } = options ?? {};
   const source = await loadWgslSource({
@@ -318,12 +340,20 @@ async function assembleWorkerWgsl(workerWgsl, options = {}) {
     fetcher,
     jobs,
     debug,
-    queueCompat = true
+    queueCompat = true,
+    queueMode = "flat"
   } = options ?? {};
-  const rawQueueSource = queueWgsl ?? await (0, import_gpu_lock_free_queue.loadQueueWgsl)({ url: queueUrl, fetcher });
+  const resolvedQueueMode = normalizeQueueMode(queueMode);
+  const rawQueueSource = queueWgsl ?? await (0, import_gpu_lock_free_queue.loadSchedulerWgsl)({
+    mode: resolvedQueueMode,
+    url: queueUrl,
+    fetcher
+  });
   const bodyRaw = workerWgsl ?? await loadWorkerWgsl({ fetcher });
   const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;
-  const queueSource = applyCompatMap(rawQueueSource, compatMap);
+  const queueSource = ensureQueueLifecycleHooks(
+    applyCompatMap(rawQueueSource, compatMap)
+  );
   const preludeRaw = preludeWgsl ?? (preludeUrl ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl }) : "");
   if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== "string") {
     throw new Error("Failed to load prelude WGSL source.");
@@ -396,6 +426,88 @@ function resolveWorkgroups(value, label) {
   }
   return normalizeWorkgroups(value, label);
 }
+function normalizeTelemetryText(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : fallback;
+}
+function resolveFrameId(value) {
+  if (typeof value === "function") {
+    return resolveFrameId(value());
+  }
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : void 0;
+}
+function toVector(workgroups) {
+  return { x: workgroups[0], y: workgroups[1], z: workgroups[2] };
+}
+function resolveTelemetryWorkgroupSize(descriptor, fallback, label) {
+  const size = descriptor?.workgroupSize == null ? fallback : descriptor.workgroupSize;
+  if (size == null) {
+    return void 0;
+  }
+  const normalized = typeof size === "number" ? normalizeWorkgroups(size, label) : resolveWorkgroups(size, label);
+  if (!normalized) {
+    return void 0;
+  }
+  return toVector(normalized);
+}
+function getNow() {
+  if (globalThis.performance && typeof globalThis.performance.now === "function") {
+    return globalThis.performance.now();
+  }
+  return Date.now();
+}
+function reportOptionalError(error, onError) {
+  if (!onError) {
+    return;
+  }
+  if (error instanceof Error) {
+    onError(error);
+    return;
+  }
+  onError(new Error(String(error)));
+}
+function emitOptionalHook(callback, payload, onError) {
+  if (typeof callback !== "function") {
+    return;
+  }
+  try {
+    callback(payload);
+  } catch (error) {
+    reportOptionalError(error, onError);
+  }
+}
+function buildDispatchTelemetrySample({
+  kind,
+  descriptor,
+  index,
+  frameId,
+  workgroups,
+  workgroupSize
+}) {
+  const labelFallback = kind === "worker" ? "worker" : `job_${index}`;
+  const label = normalizeTelemetryText(descriptor?.label, labelFallback);
+  return {
+    kind,
+    index,
+    label,
+    owner: normalizeTelemetryText(descriptor?.owner, label),
+    queueClass: normalizeTelemetryText(descriptor?.queueClass, "custom"),
+    jobType: normalizeTelemetryText(
+      descriptor?.jobType,
+      kind === "worker" ? "worker.dispatch" : label
+    ),
+    frameId,
+    workgroups: toVector(workgroups),
+    workgroupSize
+  };
+}
 function setBindGroups(pass, bindGroups) {
   if (!bindGroups) {
     return;
@@ -427,7 +539,9 @@ function createWorkerLoop(options = {}) {
     rateHz,
     label,
     onTick,
-    onError
+    onError,
+    frameId,
+    telemetry
   } = options ?? {};
   if (!device) {
     throw new Error("createWorkerLoop requires a GPUDevice.");
@@ -441,6 +555,9 @@ function createWorkerLoop(options = {}) {
   const intervalMs = Number.isFinite(rateHz) && rateHz > 0 ? 1e3 / rateHz : null;
   const tick = () => {
     try {
+      const tickStartMs = getNow();
+      const currentFrameId = resolveFrameId(frameId);
+      const telemetryDispatches = [];
       const encoder = device.createCommandEncoder();
       const pass = encoder.beginComputePass(
         label ? { label } : void 0
@@ -451,6 +568,20 @@ function createWorkerLoop(options = {}) {
       const workerGroups = explicitWorkerGroups ? explicitWorkerGroups : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];
       if (workerGroups[0] > 0) {
         pass.dispatchWorkgroups(...workerGroups);
+        telemetryDispatches.push(
+          buildDispatchTelemetrySample({
+            kind: "worker",
+            descriptor: worker,
+            index: 0,
+            frameId: currentFrameId,
+            workgroups: workerGroups,
+            workgroupSize: resolveTelemetryWorkgroupSize(
+              worker,
+              workgroupSize,
+              "worker workgroupSize"
+            )
+          })
+        );
       }
       jobs.forEach((job, index) => {
         if (!job || !job.pipeline) {
@@ -467,10 +598,43 @@ function createWorkerLoop(options = {}) {
         }
         if (groups[0] > 0) {
           pass.dispatchWorkgroups(...groups);
+          telemetryDispatches.push(
+            buildDispatchTelemetrySample({
+              kind: "job",
+              descriptor: job,
+              index,
+              frameId: currentFrameId,
+              workgroups: groups,
+              workgroupSize: resolveTelemetryWorkgroupSize(
+                job,
+                void 0,
+                `job ${index} workgroupSize`
+              )
+            })
+          );
         }
       });
       pass.end();
       device.queue.submit([encoder.finish()]);
+      telemetryDispatches.forEach((sample) => {
+        emitOptionalHook(telemetry?.onDispatch, sample, onError);
+      });
+      emitOptionalHook(
+        telemetry?.onTick,
+        {
+          frameId: currentFrameId,
+          tickDurationMs: getNow() - tickStartMs,
+          dispatchCount: telemetryDispatches.length,
+          workerDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "worker"
+          ).length,
+          jobDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "job"
+          ).length,
+          dispatches: telemetryDispatches
+        },
+        onError
+      );
       if (onTick) {
         onTick();
       }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.js"],"sourcesContent":["import { loadQueueWgsl as loadQueueWgslRaw } from \"@plasius/gpu-lock-free-queue\";\n\nexport const workerWgslUrl = (() => {\n  if (typeof __IMPORT_META_URL__ !== \"undefined\") {\n    return new URL(\"./worker.wgsl\", __IMPORT_META_URL__);\n  }\n  if (typeof __filename !== \"undefined\" && typeof require !== \"undefined\") {\n    const { pathToFileURL } = require(\"node:url\");\n    return new URL(\"./worker.wgsl\", pathToFileURL(__filename));\n  }\n  const base =\n    typeof process !== \"undefined\" && process.cwd\n      ? `file://${process.cwd()}/`\n      : \"file:///\";\n  return new URL(\"./worker.wgsl\", base);\n})();\n\nconst jobRegistry = [];\nlet nextJobType = 0;\n\nasync function loadWgslSource(options = {}) {\n  const { wgsl, url, fetcher = globalThis.fetch, baseUrl } = options ?? {};\n  if (typeof wgsl === \"string\") {\n    assertNotHtmlWgsl(wgsl, \"inline WGSL\");\n    return wgsl;\n  }\n  if (!url) {\n    return null;\n  }\n  const resolved = url instanceof URL ? url : new URL(url, baseUrl);\n  if (!fetcher) {\n    if (resolved.protocol !== \"file:\") {\n      throw new Error(\"No fetcher available for non-file WGSL URL.\");\n    }\n    const { readFile } = await import(\"fs/promises\");\n    const { fileURLToPath } = await import(\"url\");\n    const source = await readFile(fileURLToPath(resolved), \"utf8\");\n    assertNotHtmlWgsl(source, resolved.href);\n    return source;\n  }\n  const response = await fetcher(resolved);\n  if (!response.ok) {\n    const status = \"status\" in response ? response.status : \"unknown\";\n    const statusText = \"statusText\" in response ? response.statusText : \"\";\n    const detail = statusText ? `${status} ${statusText}` : `${status}`;\n    throw new Error(`Failed to load WGSL (${detail})`);\n  }\n  const source = await response.text();\n  assertNotHtmlWgsl(source, resolved.href);\n  return source;\n}\n\nfunction stripComments(source) {\n  return source\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\")\n    .replace(/\\/\\/.*$/gm, \"\");\n}\n\nfunction tokenize(source) {\n  return source.match(/[A-Za-z_][A-Za-z0-9_]*|[{}();<>,:=]/g) ?? [];\n}\n\nfunction isIdentifier(token) {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(token);\n}\n\nfunction readNameAfterType(tokens, startIndex) {\n  let i = startIndex;\n  if (tokens[i] === \"<\") {\n    let depth = 1;\n    i += 1;\n    while (i < tokens.length && depth > 0) {\n      if (tokens[i] === \"<\") {\n        depth += 1;\n      } else if (tokens[i] === \">\") {\n        depth -= 1;\n      }\n      i += 1;\n    }\n  }\n  return tokens[i];\n}\n\nfunction scanModuleNames(source) {\n  const cleaned = stripComments(source);\n  const tokens = tokenize(cleaned);\n  const names = [];\n  let depth = 0;\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    if (token === \"{\") {\n      depth += 1;\n      continue;\n    }\n    if (token === \"}\") {\n      depth = Math.max(0, depth - 1);\n      continue;\n    }\n    if (depth !== 0) {\n      continue;\n    }\n    if (token === \"fn\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"fn\", name });\n      }\n      continue;\n    }\n    if (token === \"struct\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"struct\", name });\n      }\n      continue;\n    }\n    if (token === \"alias\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"alias\", name });\n      }\n      continue;\n    }\n    if (token === \"var\" || token === \"let\" || token === \"const\" || token === \"override\") {\n      const name = readNameAfterType(tokens, i + 1);\n      if (isIdentifier(name)) {\n        names.push({ kind: token, name });\n      }\n    }\n  }\n  return names;\n}\n\nfunction buildNameIndex(modules) {\n  const index = new Map();\n  for (const module of modules) {\n    for (const item of scanModuleNames(module.source)) {\n      const bucket = index.get(item.name) ?? [];\n      bucket.push({ kind: item.kind, module: module.name });\n      index.set(item.name, bucket);\n    }\n  }\n  return index;\n}\n\nfunction assertNoNameClashes(modules) {\n  const index = buildNameIndex(modules);\n  const clashes = [];\n  for (const [name, entries] of index.entries()) {\n    if (entries.length > 1) {\n      clashes.push({ name, entries });\n    }\n  }\n  if (clashes.length === 0) {\n    return;\n  }\n  const lines = [\"WGSL debug: identifier clashes detected:\"];\n  for (const clash of clashes) {\n    const locations = clash.entries\n      .map((entry) => `${entry.module} (${entry.kind})`)\n      .join(\", \");\n    lines.push(`- ${clash.name}: ${locations}`);\n  }\n  throw new Error(lines.join(\"\\n\"));\n}\n\nfunction assertNotHtmlWgsl(source, context) {\n  const sample = source.slice(0, 200).toLowerCase();\n  if (\n    sample.includes(\"<!doctype\") ||\n    sample.includes(\"<html\") ||\n    sample.includes(\"<meta\")\n  ) {\n    const label = context ? ` for ${context}` : \"\";\n    throw new Error(\n      `Expected WGSL${label} but received HTML. Check the URL or server root.`\n    );\n  }\n}\n\nfunction renameProcessJob(source, name) {\n  return source.replace(/\\bprocess_job\\b/g, name);\n}\n\nfunction getQueueCompatMap(source) {\n  if (!/\\bJobMeta\\b/.test(source)) {\n    return null;\n  }\n  return [{ from: /\\bJobMeta\\b/g, to: \"JobDesc\" }];\n}\n\nfunction applyCompatMap(source, map) {\n  if (!map || map.length === 0) {\n    return source;\n  }\n  let next = source;\n  for (const entry of map) {\n    next = next.replace(entry.from, entry.to);\n  }\n  return next;\n}\n\nfunction normalizeJobs(jobs) {\n  const normalized = jobs.map((job, index) => {\n    if (typeof job === \"string\") {\n      return {\n        jobType: index,\n        wgsl: job,\n        label: `job_${index}`,\n        sourceName: `job-${index}`,\n      };\n    }\n    if (!job || typeof job.wgsl !== \"string\") {\n      throw new Error(\"Job entries must provide WGSL source strings.\");\n    }\n    const jobType = job.jobType ?? index;\n    const label = job.label ?? `job_${jobType}`;\n    return {\n      jobType,\n      wgsl: job.wgsl,\n      label,\n      sourceName: job.sourceName ?? job.label ?? `job-${jobType}`,\n    };\n  });\n  const seen = new Set();\n  for (const job of normalized) {\n    if (seen.has(job.jobType)) {\n      throw new Error(`Duplicate job_type detected: ${job.jobType}`);\n    }\n    seen.add(job.jobType);\n  }\n  return normalized;\n}\n\nfunction buildProcessJobDispatch(jobs) {\n  const lines = [\n    \"fn process_job(job_index: u32, job_type: u32, payload_words: u32) {\",\n  ];\n  if (jobs.length === 0) {\n    lines.push(\"  return;\");\n    lines.push(\"}\");\n    return lines.join(\"\\n\");\n  }\n  jobs.forEach((job, idx) => {\n    const clause = idx === 0 ? \"if\" : \"else if\";\n    lines.push(`  ${clause} (job_type == ${job.jobType}u) {`);\n    lines.push(\n      `    ${job.entryName}(job_index, job_type, payload_words);`\n    );\n    lines.push(\"  }\");\n  });\n  lines.push(\"}\");\n  return lines.join(\"\\n\");\n}\n\nexport async function loadWorkerWgsl(options = {}) {\n  const { url = workerWgslUrl, fetcher } = options ?? {};\n  const source = await loadWgslSource({\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load worker WGSL source.\");\n  }\n  return source;\n}\n\nexport async function loadQueueWgsl(options = {}) {\n  const { queueCompat = true, ...rest } = options ?? {};\n  const source = await loadQueueWgslRaw(rest);\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load queue WGSL source.\");\n  }\n  assertNotHtmlWgsl(source, rest?.url ? String(rest.url) : \"queue WGSL\");\n  if (!queueCompat) {\n    return source;\n  }\n  const compatMap = getQueueCompatMap(source);\n  return applyCompatMap(source, compatMap);\n}\n\nexport async function loadJobWgsl(options = {}) {\n  const { wgsl, url, fetcher, label } = options ?? {};\n  const source = await loadWgslSource({\n    wgsl,\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"loadJobWgsl requires a WGSL string or URL.\");\n  }\n  const jobType = nextJobType;\n  nextJobType += 1;\n  jobRegistry.push({\n    jobType,\n    wgsl: source,\n    label: label ?? `job_${jobType}`,\n    sourceName: label ?? `job-${jobType}`,\n  });\n  return jobType;\n}\n\nexport async function assembleWorkerWgsl(workerWgsl, options = {}) {\n  const {\n    queueWgsl,\n    queueUrl,\n    preludeWgsl,\n    preludeUrl,\n    fetcher,\n    jobs,\n    debug,\n    queueCompat = true,\n  } = options ?? {};\n  const rawQueueSource =\n    queueWgsl ?? (await loadQueueWgslRaw({ url: queueUrl, fetcher }));\n  const bodyRaw = workerWgsl ?? (await loadWorkerWgsl({ fetcher }));\n  const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;\n  const queueSource = applyCompatMap(rawQueueSource, compatMap);\n  const preludeRaw =\n    preludeWgsl ??\n    (preludeUrl\n      ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl })\n      : \"\");\n  if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== \"string\") {\n    throw new Error(\"Failed to load prelude WGSL source.\");\n  }\n  const preludeSource =\n    typeof preludeRaw === \"string\" && preludeRaw.length > 0\n      ? applyCompatMap(preludeRaw, compatMap)\n      : \"\";\n  const body = applyCompatMap(bodyRaw, compatMap);\n  const jobList = normalizeJobs(\n    typeof jobs === \"undefined\" ? jobRegistry : jobs\n  );\n  if (!jobList || jobList.length === 0) {\n    return `${queueSource}\\n\\n${body}`;\n  }\n  const rewrittenJobs = jobList.map((job) => {\n    const source = applyCompatMap(job.wgsl, compatMap);\n    const hasProcessJob = /\\bfn\\s+process_job\\b/.test(source);\n    if (!hasProcessJob) {\n      throw new Error(\n        `Job ${job.sourceName} is missing a process_job() entry function.`\n      );\n    }\n    const entryName = `process_job__${job.jobType}`;\n    const renamed = renameProcessJob(source, entryName);\n    return { ...job, entryName, wgsl: renamed };\n  });\n  const dispatch = buildProcessJobDispatch(rewrittenJobs);\n  const modulesForDebug = debug\n    ? [\n        { name: \"queue.wgsl\", source: queueSource },\n        ...(preludeSource\n          ? [{ name: \"jobs.prelude.wgsl\", source: preludeSource }]\n          : []),\n        ...rewrittenJobs.map((job) => ({\n          name: job.sourceName,\n          source: job.wgsl,\n        })),\n        { name: \"jobs.dispatch.wgsl\", source: dispatch },\n        { name: \"worker.wgsl\", source: body },\n      ]\n    : null;\n  if (modulesForDebug) {\n    assertNoNameClashes(modulesForDebug);\n  }\n  const jobBlocks = rewrittenJobs\n    .map((job) => `// Job ${job.jobType}: ${job.label}\\n${job.wgsl}`)\n    .join(\"\\n\\n\");\n  const preludeBlock = preludeSource ? `${preludeSource}\\n\\n` : \"\";\n  return `${queueSource}\\n\\n${preludeBlock}${jobBlocks}\\n\\n${dispatch}\\n\\n${body}`;\n}\n\nfunction normalizeWorkgroups(value, label) {\n  if (typeof value === \"number\") {\n    return [value, 1, 1];\n  }\n  if (Array.isArray(value)) {\n    const [x = 0, y = 1, z = 1] = value;\n    return [x, y, z];\n  }\n  throw new Error(`Invalid workgroup count for ${label}.`);\n}\n\nfunction resolveWorkgroups(value, label) {\n  if (typeof value === \"function\") {\n    return normalizeWorkgroups(value(), label);\n  }\n  if (value == null) {\n    return null;\n  }\n  return normalizeWorkgroups(value, label);\n}\n\nfunction setBindGroups(pass, bindGroups) {\n  if (!bindGroups) {\n    return;\n  }\n  bindGroups.forEach((group, index) => {\n    if (group) {\n      pass.setBindGroup(index, group);\n    }\n  });\n}\n\nfunction computeWorkerWorkgroups(maxJobs, workgroupSize) {\n  const jobs =\n    typeof maxJobs === \"function\" ? Number(maxJobs()) : Number(maxJobs);\n  if (!Number.isFinite(jobs) || jobs <= 0) {\n    throw new Error(\"maxJobsPerDispatch must be a positive number.\");\n  }\n  const size = Number(workgroupSize);\n  if (!Number.isFinite(size) || size <= 0) {\n    throw new Error(\"workgroupSize must be a positive number.\");\n  }\n  return Math.max(1, Math.ceil(jobs / size));\n}\n\nexport function createWorkerLoop(options = {}) {\n  const {\n    device,\n    worker,\n    jobs = [],\n    workgroupSize = 64,\n    maxJobsPerDispatch,\n    rateHz,\n    label,\n    onTick,\n    onError,\n  } = options ?? {};\n\n  if (!device) {\n    throw new Error(\"createWorkerLoop requires a GPUDevice.\");\n  }\n  if (!worker || !worker.pipeline) {\n    throw new Error(\"createWorkerLoop requires a worker pipeline.\");\n  }\n\n  let running = false;\n  let handle = null;\n  let usingRaf = false;\n  const intervalMs =\n    Number.isFinite(rateHz) && rateHz > 0 ? 1000 / rateHz : null;\n\n  const tick = () => {\n    try {\n      const encoder = device.createCommandEncoder();\n      const pass = encoder.beginComputePass(\n        label ? { label } : undefined\n      );\n\n      pass.setPipeline(worker.pipeline);\n      setBindGroups(pass, worker.bindGroups);\n\n      const explicitWorkerGroups =\n        resolveWorkgroups(worker.workgroups, \"worker\") ??\n        resolveWorkgroups(worker.workgroupCount, \"worker\") ??\n        resolveWorkgroups(worker.dispatch, \"worker\");\n\n      const workerGroups = explicitWorkerGroups\n        ? explicitWorkerGroups\n        : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];\n\n      if (workerGroups[0] > 0) {\n        pass.dispatchWorkgroups(...workerGroups);\n      }\n\n      jobs.forEach((job, index) => {\n        if (!job || !job.pipeline) {\n          throw new Error(`Job pipeline missing at index ${index}.`);\n        }\n        pass.setPipeline(job.pipeline);\n        setBindGroups(pass, job.bindGroups);\n        const groups = resolveWorkgroups(\n          job.workgroups ?? job.workgroupCount ?? job.dispatch,\n          `job ${index}`\n        );\n        if (!groups) {\n          throw new Error(`Job ${index} requires a workgroup count.`);\n        }\n        if (groups[0] > 0) {\n          pass.dispatchWorkgroups(...groups);\n        }\n      });\n\n      pass.end();\n      device.queue.submit([encoder.finish()]);\n\n      if (onTick) {\n        onTick();\n      }\n    } catch (err) {\n      if (onError) {\n        onError(err);\n        return;\n      }\n      throw err;\n    }\n  };\n\n  const scheduleNext = () => {\n    if (!running) {\n      return;\n    }\n    if (intervalMs != null) {\n      tick();\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, intervalMs);\n      return;\n    }\n    tick();\n    if (typeof requestAnimationFrame === \"function\") {\n      usingRaf = true;\n      handle = requestAnimationFrame(scheduleNext);\n    } else {\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, 0);\n    }\n  };\n\n  const start = () => {\n    if (running) {\n      return;\n    }\n    running = true;\n    scheduleNext();\n  };\n\n  const stop = () => {\n    running = false;\n    if (handle == null) {\n      return;\n    }\n    if (usingRaf && typeof cancelAnimationFrame === \"function\") {\n      cancelAnimationFrame(handle);\n    } else {\n      clearTimeout(handle);\n    }\n    handle = null;\n  };\n\n  return {\n    start,\n    stop,\n    tick,\n    get running() {\n      return running;\n    },\n  };\n}\n"],"mappings":"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","names":["source","module","loadQueueWgslRaw"]}
+{"version":3,"sources":["../src/index.js"],"sourcesContent":["import {\n  loadSchedulerWgsl as loadSchedulerWgslRaw,\n  schedulerModes as workerSchedulerModes,\n} from \"@plasius/gpu-lock-free-queue\";\n\nexport const workerWgslUrl = (() => {\n  if (typeof __IMPORT_META_URL__ !== \"undefined\") {\n    return new URL(\"./worker.wgsl\", __IMPORT_META_URL__);\n  }\n  if (typeof __filename !== \"undefined\" && typeof require !== \"undefined\") {\n    const { pathToFileURL } = require(\"node:url\");\n    return new URL(\"./worker.wgsl\", pathToFileURL(__filename));\n  }\n  const base =\n    typeof process !== \"undefined\" && process.cwd\n      ? `file://${process.cwd()}/`\n      : \"file:///\";\n  return new URL(\"./worker.wgsl\", base);\n})();\n\nconst jobRegistry = [];\nlet nextJobType = 0;\n\nasync function loadWgslSource(options = {}) {\n  const { wgsl, url, fetcher = globalThis.fetch, baseUrl } = options ?? {};\n  if (typeof wgsl === \"string\") {\n    assertNotHtmlWgsl(wgsl, \"inline WGSL\");\n    return wgsl;\n  }\n  if (!url) {\n    return null;\n  }\n  const resolved = url instanceof URL ? url : new URL(url, baseUrl);\n  if (!fetcher) {\n    if (resolved.protocol !== \"file:\") {\n      throw new Error(\"No fetcher available for non-file WGSL URL.\");\n    }\n    const { readFile } = await import(\"fs/promises\");\n    const { fileURLToPath } = await import(\"url\");\n    const source = await readFile(fileURLToPath(resolved), \"utf8\");\n    assertNotHtmlWgsl(source, resolved.href);\n    return source;\n  }\n  const response = await fetcher(resolved);\n  if (!response.ok) {\n    const status = \"status\" in response ? response.status : \"unknown\";\n    const statusText = \"statusText\" in response ? response.statusText : \"\";\n    const detail = statusText ? `${status} ${statusText}` : `${status}`;\n    throw new Error(`Failed to load WGSL (${detail})`);\n  }\n  const source = await response.text();\n  assertNotHtmlWgsl(source, resolved.href);\n  return source;\n}\n\nfunction stripComments(source) {\n  return source\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\")\n    .replace(/\\/\\/.*$/gm, \"\");\n}\n\nfunction tokenize(source) {\n  return source.match(/[A-Za-z_][A-Za-z0-9_]*|[{}();<>,:=]/g) ?? [];\n}\n\nfunction isIdentifier(token) {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(token);\n}\n\nfunction readNameAfterType(tokens, startIndex) {\n  let i = startIndex;\n  if (tokens[i] === \"<\") {\n    let depth = 1;\n    i += 1;\n    while (i < tokens.length && depth > 0) {\n      if (tokens[i] === \"<\") {\n        depth += 1;\n      } else if (tokens[i] === \">\") {\n        depth -= 1;\n      }\n      i += 1;\n    }\n  }\n  return tokens[i];\n}\n\nfunction scanModuleNames(source) {\n  const cleaned = stripComments(source);\n  const tokens = tokenize(cleaned);\n  const names = [];\n  let depth = 0;\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    if (token === \"{\") {\n      depth += 1;\n      continue;\n    }\n    if (token === \"}\") {\n      depth = Math.max(0, depth - 1);\n      continue;\n    }\n    if (depth !== 0) {\n      continue;\n    }\n    if (token === \"fn\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"fn\", name });\n      }\n      continue;\n    }\n    if (token === \"struct\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"struct\", name });\n      }\n      continue;\n    }\n    if (token === \"alias\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"alias\", name });\n      }\n      continue;\n    }\n    if (token === \"var\" || token === \"let\" || token === \"const\" || token === \"override\") {\n      const name = readNameAfterType(tokens, i + 1);\n      if (isIdentifier(name)) {\n        names.push({ kind: token, name });\n      }\n    }\n  }\n  return names;\n}\n\nfunction buildNameIndex(modules) {\n  const index = new Map();\n  for (const module of modules) {\n    for (const item of scanModuleNames(module.source)) {\n      const bucket = index.get(item.name) ?? [];\n      bucket.push({ kind: item.kind, module: module.name });\n      index.set(item.name, bucket);\n    }\n  }\n  return index;\n}\n\nfunction assertNoNameClashes(modules) {\n  const index = buildNameIndex(modules);\n  const clashes = [];\n  for (const [name, entries] of index.entries()) {\n    if (entries.length > 1) {\n      clashes.push({ name, entries });\n    }\n  }\n  if (clashes.length === 0) {\n    return;\n  }\n  const lines = [\"WGSL debug: identifier clashes detected:\"];\n  for (const clash of clashes) {\n    const locations = clash.entries\n      .map((entry) => `${entry.module} (${entry.kind})`)\n      .join(\", \");\n    lines.push(`- ${clash.name}: ${locations}`);\n  }\n  throw new Error(lines.join(\"\\n\"));\n}\n\nfunction assertNotHtmlWgsl(source, context) {\n  const sample = source.slice(0, 200).toLowerCase();\n  if (\n    sample.includes(\"<!doctype\") ||\n    sample.includes(\"<html\") ||\n    sample.includes(\"<meta\")\n  ) {\n    const label = context ? ` for ${context}` : \"\";\n    throw new Error(\n      `Expected WGSL${label} but received HTML. Check the URL or server root.`\n    );\n  }\n}\n\nfunction renameProcessJob(source, name) {\n  return source.replace(/\\bprocess_job\\b/g, name);\n}\n\nfunction getQueueCompatMap(source) {\n  if (!/\\bJobMeta\\b/.test(source)) {\n    return null;\n  }\n  return [{ from: /\\bJobMeta\\b/g, to: \"JobDesc\" }];\n}\n\nfunction normalizeQueueMode(mode) {\n  const resolved = mode ?? \"flat\";\n  if (!workerSchedulerModes.includes(resolved)) {\n    throw new Error(\n      `queueMode must be one of: ${workerSchedulerModes.join(\", \")}.`\n    );\n  }\n  return resolved;\n}\n\nfunction applyCompatMap(source, map) {\n  if (!map || map.length === 0) {\n    return source;\n  }\n  let next = source;\n  for (const entry of map) {\n    next = next.replace(entry.from, entry.to);\n  }\n  return next;\n}\n\nfunction normalizeJobs(jobs) {\n  const normalized = jobs.map((job, index) => {\n    if (typeof job === \"string\") {\n      return {\n        jobType: index,\n        wgsl: job,\n        label: `job_${index}`,\n        sourceName: `job-${index}`,\n      };\n    }\n    if (!job || typeof job.wgsl !== \"string\") {\n      throw new Error(\"Job entries must provide WGSL source strings.\");\n    }\n    const jobType = job.jobType ?? index;\n    const label = job.label ?? `job_${jobType}`;\n    return {\n      jobType,\n      wgsl: job.wgsl,\n      label,\n      sourceName: job.sourceName ?? job.label ?? `job-${jobType}`,\n    };\n  });\n  const seen = new Set();\n  for (const job of normalized) {\n    if (seen.has(job.jobType)) {\n      throw new Error(`Duplicate job_type detected: ${job.jobType}`);\n    }\n    seen.add(job.jobType);\n  }\n  return normalized;\n}\n\nfunction buildProcessJobDispatch(jobs) {\n  const lines = [\n    \"fn process_job(job_index: u32, job_type: u32, payload_words: u32) {\",\n  ];\n  if (jobs.length === 0) {\n    lines.push(\"  return;\");\n    lines.push(\"}\");\n    return lines.join(\"\\n\");\n  }\n  jobs.forEach((job, idx) => {\n    const clause = idx === 0 ? \"if\" : \"else if\";\n    lines.push(`  ${clause} (job_type == ${job.jobType}u) {`);\n    lines.push(\n      `    ${job.entryName}(job_index, job_type, payload_words);`\n    );\n    lines.push(\"  }\");\n  });\n  lines.push(\"}\");\n  return lines.join(\"\\n\");\n}\n\nexport async function loadWorkerWgsl(options = {}) {\n  const { url = workerWgslUrl, fetcher } = options ?? {};\n  const source = await loadWgslSource({\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load worker WGSL source.\");\n  }\n  return source;\n}\n\nexport async function loadQueueWgsl(options = {}) {\n  const { queueCompat = true, queueMode = \"flat\", ...rest } = options ?? {};\n  const source = await loadSchedulerWgslRaw({\n    mode: normalizeQueueMode(queueMode),\n    ...rest,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load queue WGSL source.\");\n  }\n  assertNotHtmlWgsl(source, rest?.url ? String(rest.url) : \"queue WGSL\");\n  if (!queueCompat) {\n    return source;\n  }\n  const compatMap = getQueueCompatMap(source);\n  return applyCompatMap(source, compatMap);\n}\n\nfunction ensureQueueLifecycleHooks(source) {\n  if (/\\bfn\\s+complete_job\\b/.test(source)) {\n    return source;\n  }\n  return `${source}\\n\\nfn complete_job(job_index: u32) {\\n  _ = job_index;\\n}`;\n}\n\nexport async function loadJobWgsl(options = {}) {\n  const { wgsl, url, fetcher, label } = options ?? {};\n  const source = await loadWgslSource({\n    wgsl,\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"loadJobWgsl requires a WGSL string or URL.\");\n  }\n  const jobType = nextJobType;\n  nextJobType += 1;\n  jobRegistry.push({\n    jobType,\n    wgsl: source,\n    label: label ?? `job_${jobType}`,\n    sourceName: label ?? `job-${jobType}`,\n  });\n  return jobType;\n}\n\nexport async function assembleWorkerWgsl(workerWgsl, options = {}) {\n  const {\n    queueWgsl,\n    queueUrl,\n    preludeWgsl,\n    preludeUrl,\n    fetcher,\n    jobs,\n    debug,\n    queueCompat = true,\n    queueMode = \"flat\",\n  } = options ?? {};\n  const resolvedQueueMode = normalizeQueueMode(queueMode);\n  const rawQueueSource =\n    queueWgsl ??\n    (await loadSchedulerWgslRaw({\n      mode: resolvedQueueMode,\n      url: queueUrl,\n      fetcher,\n    }));\n  const bodyRaw = workerWgsl ?? (await loadWorkerWgsl({ fetcher }));\n  const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;\n  const queueSource = ensureQueueLifecycleHooks(\n    applyCompatMap(rawQueueSource, compatMap)\n  );\n  const preludeRaw =\n    preludeWgsl ??\n    (preludeUrl\n      ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl })\n      : \"\");\n  if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== \"string\") {\n    throw new Error(\"Failed to load prelude WGSL source.\");\n  }\n  const preludeSource =\n    typeof preludeRaw === \"string\" && preludeRaw.length > 0\n      ? applyCompatMap(preludeRaw, compatMap)\n      : \"\";\n  const body = applyCompatMap(bodyRaw, compatMap);\n  const jobList = normalizeJobs(\n    typeof jobs === \"undefined\" ? jobRegistry : jobs\n  );\n  if (!jobList || jobList.length === 0) {\n    return `${queueSource}\\n\\n${body}`;\n  }\n  const rewrittenJobs = jobList.map((job) => {\n    const source = applyCompatMap(job.wgsl, compatMap);\n    const hasProcessJob = /\\bfn\\s+process_job\\b/.test(source);\n    if (!hasProcessJob) {\n      throw new Error(\n        `Job ${job.sourceName} is missing a process_job() entry function.`\n      );\n    }\n    const entryName = `process_job__${job.jobType}`;\n    const renamed = renameProcessJob(source, entryName);\n    return { ...job, entryName, wgsl: renamed };\n  });\n  const dispatch = buildProcessJobDispatch(rewrittenJobs);\n  const modulesForDebug = debug\n    ? [\n        { name: \"queue.wgsl\", source: queueSource },\n        ...(preludeSource\n          ? [{ name: \"jobs.prelude.wgsl\", source: preludeSource }]\n          : []),\n        ...rewrittenJobs.map((job) => ({\n          name: job.sourceName,\n          source: job.wgsl,\n        })),\n        { name: \"jobs.dispatch.wgsl\", source: dispatch },\n        { name: \"worker.wgsl\", source: body },\n      ]\n    : null;\n  if (modulesForDebug) {\n    assertNoNameClashes(modulesForDebug);\n  }\n  const jobBlocks = rewrittenJobs\n    .map((job) => `// Job ${job.jobType}: ${job.label}\\n${job.wgsl}`)\n    .join(\"\\n\\n\");\n  const preludeBlock = preludeSource ? `${preludeSource}\\n\\n` : \"\";\n  return `${queueSource}\\n\\n${preludeBlock}${jobBlocks}\\n\\n${dispatch}\\n\\n${body}`;\n}\n\nfunction normalizeWorkgroups(value, label) {\n  if (typeof value === \"number\") {\n    return [value, 1, 1];\n  }\n  if (Array.isArray(value)) {\n    const [x = 0, y = 1, z = 1] = value;\n    return [x, y, z];\n  }\n  throw new Error(`Invalid workgroup count for ${label}.`);\n}\n\nfunction resolveWorkgroups(value, label) {\n  if (typeof value === \"function\") {\n    return normalizeWorkgroups(value(), label);\n  }\n  if (value == null) {\n    return null;\n  }\n  return normalizeWorkgroups(value, label);\n}\n\nfunction normalizeTelemetryText(value, fallback) {\n  if (typeof value !== \"string\") {\n    return fallback;\n  }\n  const trimmed = value.trim();\n  return trimmed ? trimmed.slice(0, 120) : fallback;\n}\n\nfunction resolveFrameId(value) {\n  if (typeof value === \"function\") {\n    return resolveFrameId(value());\n  }\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed ? trimmed.slice(0, 120) : undefined;\n}\n\nfunction toVector(workgroups) {\n  return { x: workgroups[0], y: workgroups[1], z: workgroups[2] };\n}\n\nfunction resolveTelemetryWorkgroupSize(descriptor, fallback, label) {\n  const size =\n    descriptor?.workgroupSize == null ? fallback : descriptor.workgroupSize;\n  if (size == null) {\n    return undefined;\n  }\n  const normalized =\n    typeof size === \"number\" ? normalizeWorkgroups(size, label) : resolveWorkgroups(size, label);\n  if (!normalized) {\n    return undefined;\n  }\n  return toVector(normalized);\n}\n\nfunction getNow() {\n  if (globalThis.performance && typeof globalThis.performance.now === \"function\") {\n    return globalThis.performance.now();\n  }\n  return Date.now();\n}\n\nfunction reportOptionalError(error, onError) {\n  if (!onError) {\n    return;\n  }\n  if (error instanceof Error) {\n    onError(error);\n    return;\n  }\n  onError(new Error(String(error)));\n}\n\nfunction emitOptionalHook(callback, payload, onError) {\n  if (typeof callback !== \"function\") {\n    return;\n  }\n  try {\n    callback(payload);\n  } catch (error) {\n    reportOptionalError(error, onError);\n  }\n}\n\nfunction buildDispatchTelemetrySample({\n  kind,\n  descriptor,\n  index,\n  frameId,\n  workgroups,\n  workgroupSize,\n}) {\n  const labelFallback = kind === \"worker\" ? \"worker\" : `job_${index}`;\n  const label = normalizeTelemetryText(descriptor?.label, labelFallback);\n  return {\n    kind,\n    index,\n    label,\n    owner: normalizeTelemetryText(descriptor?.owner, label),\n    queueClass: normalizeTelemetryText(descriptor?.queueClass, \"custom\"),\n    jobType: normalizeTelemetryText(\n      descriptor?.jobType,\n      kind === \"worker\" ? \"worker.dispatch\" : label\n    ),\n    frameId,\n    workgroups: toVector(workgroups),\n    workgroupSize,\n  };\n}\n\nfunction setBindGroups(pass, bindGroups) {\n  if (!bindGroups) {\n    return;\n  }\n  bindGroups.forEach((group, index) => {\n    if (group) {\n      pass.setBindGroup(index, group);\n    }\n  });\n}\n\nfunction computeWorkerWorkgroups(maxJobs, workgroupSize) {\n  const jobs =\n    typeof maxJobs === \"function\" ? Number(maxJobs()) : Number(maxJobs);\n  if (!Number.isFinite(jobs) || jobs <= 0) {\n    throw new Error(\"maxJobsPerDispatch must be a positive number.\");\n  }\n  const size = Number(workgroupSize);\n  if (!Number.isFinite(size) || size <= 0) {\n    throw new Error(\"workgroupSize must be a positive number.\");\n  }\n  return Math.max(1, Math.ceil(jobs / size));\n}\n\nexport function createWorkerLoop(options = {}) {\n  const {\n    device,\n    worker,\n    jobs = [],\n    workgroupSize = 64,\n    maxJobsPerDispatch,\n    rateHz,\n    label,\n    onTick,\n    onError,\n    frameId,\n    telemetry,\n  } = options ?? {};\n\n  if (!device) {\n    throw new Error(\"createWorkerLoop requires a GPUDevice.\");\n  }\n  if (!worker || !worker.pipeline) {\n    throw new Error(\"createWorkerLoop requires a worker pipeline.\");\n  }\n\n  let running = false;\n  let handle = null;\n  let usingRaf = false;\n  const intervalMs =\n    Number.isFinite(rateHz) && rateHz > 0 ? 1000 / rateHz : null;\n\n  const tick = () => {\n    try {\n      const tickStartMs = getNow();\n      const currentFrameId = resolveFrameId(frameId);\n      const telemetryDispatches = [];\n      const encoder = device.createCommandEncoder();\n      const pass = encoder.beginComputePass(\n        label ? { label } : undefined\n      );\n\n      pass.setPipeline(worker.pipeline);\n      setBindGroups(pass, worker.bindGroups);\n\n      const explicitWorkerGroups =\n        resolveWorkgroups(worker.workgroups, \"worker\") ??\n        resolveWorkgroups(worker.workgroupCount, \"worker\") ??\n        resolveWorkgroups(worker.dispatch, \"worker\");\n\n      const workerGroups = explicitWorkerGroups\n        ? explicitWorkerGroups\n        : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];\n\n      if (workerGroups[0] > 0) {\n        pass.dispatchWorkgroups(...workerGroups);\n        telemetryDispatches.push(\n          buildDispatchTelemetrySample({\n            kind: \"worker\",\n            descriptor: worker,\n            index: 0,\n            frameId: currentFrameId,\n            workgroups: workerGroups,\n            workgroupSize: resolveTelemetryWorkgroupSize(\n              worker,\n              workgroupSize,\n              \"worker workgroupSize\"\n            ),\n          })\n        );\n      }\n\n      jobs.forEach((job, index) => {\n        if (!job || !job.pipeline) {\n          throw new Error(`Job pipeline missing at index ${index}.`);\n        }\n        pass.setPipeline(job.pipeline);\n        setBindGroups(pass, job.bindGroups);\n        const groups = resolveWorkgroups(\n          job.workgroups ?? job.workgroupCount ?? job.dispatch,\n          `job ${index}`\n        );\n        if (!groups) {\n          throw new Error(`Job ${index} requires a workgroup count.`);\n        }\n        if (groups[0] > 0) {\n          pass.dispatchWorkgroups(...groups);\n          telemetryDispatches.push(\n            buildDispatchTelemetrySample({\n              kind: \"job\",\n              descriptor: job,\n              index,\n              frameId: currentFrameId,\n              workgroups: groups,\n              workgroupSize: resolveTelemetryWorkgroupSize(\n                job,\n                undefined,\n                `job ${index} workgroupSize`\n              ),\n            })\n          );\n        }\n      });\n\n      pass.end();\n      device.queue.submit([encoder.finish()]);\n\n      telemetryDispatches.forEach((sample) => {\n        emitOptionalHook(telemetry?.onDispatch, sample, onError);\n      });\n      emitOptionalHook(\n        telemetry?.onTick,\n        {\n          frameId: currentFrameId,\n          tickDurationMs: getNow() - tickStartMs,\n          dispatchCount: telemetryDispatches.length,\n          workerDispatchCount: telemetryDispatches.filter(\n            (sample) => sample.kind === \"worker\"\n          ).length,\n          jobDispatchCount: telemetryDispatches.filter(\n            (sample) => sample.kind === \"job\"\n          ).length,\n          dispatches: telemetryDispatches,\n        },\n        onError\n      );\n\n      if (onTick) {\n        onTick();\n      }\n    } catch (err) {\n      if (onError) {\n        onError(err);\n        return;\n      }\n      throw err;\n    }\n  };\n\n  const scheduleNext = () => {\n    if (!running) {\n      return;\n    }\n    if (intervalMs != null) {\n      tick();\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, intervalMs);\n      return;\n    }\n    tick();\n    if (typeof requestAnimationFrame === \"function\") {\n      usingRaf = true;\n      handle = requestAnimationFrame(scheduleNext);\n    } else {\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, 0);\n    }\n  };\n\n  const start = () => {\n    if (running) {\n      return;\n    }\n    running = true;\n    scheduleNext();\n  };\n\n  const stop = () => {\n    running = false;\n    if (handle == null) {\n      return;\n    }\n    if (usingRaf && typeof cancelAnimationFrame === \"function\") {\n      cancelAnimationFrame(handle);\n    } else {\n      clearTimeout(handle);\n    }\n    handle = null;\n  };\n\n  return {\n    start,\n    stop,\n    tick,\n    get running() {\n      return running;\n    },\n  };\n}\n"],"mappings":"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","names":["source","module","workerSchedulerModes","loadSchedulerWgslRaw"]}

package/dist/index.js

@@ -6,7 +6,10 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/index.js
-import { loadQueueWgsl as loadQueueWgslRaw } from "@plasius/gpu-lock-free-queue";
+import {
+  loadSchedulerWgsl as loadSchedulerWgslRaw,
+  schedulerModes as workerSchedulerModes
+} from "@plasius/gpu-lock-free-queue";
 var workerWgslUrl = (() => {
   if (typeof import.meta.url !== "undefined") {
     return new URL("./worker.wgsl", import.meta.url);
@@ -171,6 +174,15 @@ function getQueueCompatMap(source) {
   }
   return [{ from: /\bJobMeta\b/g, to: "JobDesc" }];
 }
+function normalizeQueueMode(mode) {
+  const resolved = mode ?? "flat";
+  if (!workerSchedulerModes.includes(resolved)) {
+    throw new Error(
+      `queueMode must be one of: ${workerSchedulerModes.join(", ")}.`
+    );
+  }
+  return resolved;
+}
 function applyCompatMap(source, map) {
   if (!map || map.length === 0) {
     return source;
@@ -245,8 +257,11 @@ async function loadWorkerWgsl(options = {}) {
   return source;
 }
 async function loadQueueWgsl(options = {}) {
-  const { queueCompat = true, ...rest } = options ?? {};
-  const source = await loadQueueWgslRaw(rest);
+  const { queueCompat = true, queueMode = "flat", ...rest } = options ?? {};
+  const source = await loadSchedulerWgslRaw({
+    mode: normalizeQueueMode(queueMode),
+    ...rest
+  });
   if (typeof source !== "string") {
     throw new Error("Failed to load queue WGSL source.");
   }
@@ -257,6 +272,16 @@ async function loadQueueWgsl(options = {}) {
   const compatMap = getQueueCompatMap(source);
   return applyCompatMap(source, compatMap);
 }
+function ensureQueueLifecycleHooks(source) {
+  if (/\bfn\s+complete_job\b/.test(source)) {
+    return source;
+  }
+  return `${source}
+
+fn complete_job(job_index: u32) {
+  _ = job_index;
+}`;
+}
 async function loadJobWgsl(options = {}) {
   const { wgsl, url, fetcher, label } = options ?? {};
   const source = await loadWgslSource({
@@ -287,12 +312,20 @@ async function assembleWorkerWgsl(workerWgsl, options = {}) {
     fetcher,
     jobs,
     debug,
-    queueCompat = true
+    queueCompat = true,
+    queueMode = "flat"
   } = options ?? {};
-  const rawQueueSource = queueWgsl ?? await loadQueueWgslRaw({ url: queueUrl, fetcher });
+  const resolvedQueueMode = normalizeQueueMode(queueMode);
+  const rawQueueSource = queueWgsl ?? await loadSchedulerWgslRaw({
+    mode: resolvedQueueMode,
+    url: queueUrl,
+    fetcher
+  });
   const bodyRaw = workerWgsl ?? await loadWorkerWgsl({ fetcher });
   const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;
-  const queueSource = applyCompatMap(rawQueueSource, compatMap);
+  const queueSource = ensureQueueLifecycleHooks(
+    applyCompatMap(rawQueueSource, compatMap)
+  );
   const preludeRaw = preludeWgsl ?? (preludeUrl ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl }) : "");
   if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== "string") {
     throw new Error("Failed to load prelude WGSL source.");
@@ -365,6 +398,88 @@ function resolveWorkgroups(value, label) {
   }
   return normalizeWorkgroups(value, label);
 }
+function normalizeTelemetryText(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : fallback;
+}
+function resolveFrameId(value) {
+  if (typeof value === "function") {
+    return resolveFrameId(value());
+  }
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : void 0;
+}
+function toVector(workgroups) {
+  return { x: workgroups[0], y: workgroups[1], z: workgroups[2] };
+}
+function resolveTelemetryWorkgroupSize(descriptor, fallback, label) {
+  const size = descriptor?.workgroupSize == null ? fallback : descriptor.workgroupSize;
+  if (size == null) {
+    return void 0;
+  }
+  const normalized = typeof size === "number" ? normalizeWorkgroups(size, label) : resolveWorkgroups(size, label);
+  if (!normalized) {
+    return void 0;
+  }
+  return toVector(normalized);
+}
+function getNow() {
+  if (globalThis.performance && typeof globalThis.performance.now === "function") {
+    return globalThis.performance.now();
+  }
+  return Date.now();
+}
+function reportOptionalError(error, onError) {
+  if (!onError) {
+    return;
+  }
+  if (error instanceof Error) {
+    onError(error);
+    return;
+  }
+  onError(new Error(String(error)));
+}
+function emitOptionalHook(callback, payload, onError) {
+  if (typeof callback !== "function") {
+    return;
+  }
+  try {
+    callback(payload);
+  } catch (error) {
+    reportOptionalError(error, onError);
+  }
+}
+function buildDispatchTelemetrySample({
+  kind,
+  descriptor,
+  index,
+  frameId,
+  workgroups,
+  workgroupSize
+}) {
+  const labelFallback = kind === "worker" ? "worker" : `job_${index}`;
+  const label = normalizeTelemetryText(descriptor?.label, labelFallback);
+  return {
+    kind,
+    index,
+    label,
+    owner: normalizeTelemetryText(descriptor?.owner, label),
+    queueClass: normalizeTelemetryText(descriptor?.queueClass, "custom"),
+    jobType: normalizeTelemetryText(
+      descriptor?.jobType,
+      kind === "worker" ? "worker.dispatch" : label
+    ),
+    frameId,
+    workgroups: toVector(workgroups),
+    workgroupSize
+  };
+}
 function setBindGroups(pass, bindGroups) {
   if (!bindGroups) {
     return;
@@ -396,7 +511,9 @@ function createWorkerLoop(options = {}) {
     rateHz,
     label,
     onTick,
-    onError
+    onError,
+    frameId,
+    telemetry
   } = options ?? {};
   if (!device) {
     throw new Error("createWorkerLoop requires a GPUDevice.");
@@ -410,6 +527,9 @@ function createWorkerLoop(options = {}) {
   const intervalMs = Number.isFinite(rateHz) && rateHz > 0 ? 1e3 / rateHz : null;
   const tick = () => {
     try {
+      const tickStartMs = getNow();
+      const currentFrameId = resolveFrameId(frameId);
+      const telemetryDispatches = [];
       const encoder = device.createCommandEncoder();
       const pass = encoder.beginComputePass(
         label ? { label } : void 0
@@ -420,6 +540,20 @@ function createWorkerLoop(options = {}) {
       const workerGroups = explicitWorkerGroups ? explicitWorkerGroups : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];
       if (workerGroups[0] > 0) {
         pass.dispatchWorkgroups(...workerGroups);
+        telemetryDispatches.push(
+          buildDispatchTelemetrySample({
+            kind: "worker",
+            descriptor: worker,
+            index: 0,
+            frameId: currentFrameId,
+            workgroups: workerGroups,
+            workgroupSize: resolveTelemetryWorkgroupSize(
+              worker,
+              workgroupSize,
+              "worker workgroupSize"
+            )
+          })
+        );
       }
       jobs.forEach((job, index) => {
         if (!job || !job.pipeline) {
@@ -436,10 +570,43 @@ function createWorkerLoop(options = {}) {
         }
         if (groups[0] > 0) {
           pass.dispatchWorkgroups(...groups);
+          telemetryDispatches.push(
+            buildDispatchTelemetrySample({
+              kind: "job",
+              descriptor: job,
+              index,
+              frameId: currentFrameId,
+              workgroups: groups,
+              workgroupSize: resolveTelemetryWorkgroupSize(
+                job,
+                void 0,
+                `job ${index} workgroupSize`
+              )
+            })
+          );
         }
       });
       pass.end();
       device.queue.submit([encoder.finish()]);
+      telemetryDispatches.forEach((sample) => {
+        emitOptionalHook(telemetry?.onDispatch, sample, onError);
+      });
+      emitOptionalHook(
+        telemetry?.onTick,
+        {
+          frameId: currentFrameId,
+          tickDurationMs: getNow() - tickStartMs,
+          dispatchCount: telemetryDispatches.length,
+          workerDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "worker"
+          ).length,
+          jobDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "job"
+          ).length,
+          dispatches: telemetryDispatches
+        },
+        onError
+      );
       if (onTick) {
         onTick();
       }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.js"],"sourcesContent":["import { loadQueueWgsl as loadQueueWgslRaw } from \"@plasius/gpu-lock-free-queue\";\n\nexport const workerWgslUrl = (() => {\n  if (typeof __IMPORT_META_URL__ !== \"undefined\") {\n    return new URL(\"./worker.wgsl\", __IMPORT_META_URL__);\n  }\n  if (typeof __filename !== \"undefined\" && typeof require !== \"undefined\") {\n    const { pathToFileURL } = require(\"node:url\");\n    return new URL(\"./worker.wgsl\", pathToFileURL(__filename));\n  }\n  const base =\n    typeof process !== \"undefined\" && process.cwd\n      ? `file://${process.cwd()}/`\n      : \"file:///\";\n  return new URL(\"./worker.wgsl\", base);\n})();\n\nconst jobRegistry = [];\nlet nextJobType = 0;\n\nasync function loadWgslSource(options = {}) {\n  const { wgsl, url, fetcher = globalThis.fetch, baseUrl } = options ?? {};\n  if (typeof wgsl === \"string\") {\n    assertNotHtmlWgsl(wgsl, \"inline WGSL\");\n    return wgsl;\n  }\n  if (!url) {\n    return null;\n  }\n  const resolved = url instanceof URL ? url : new URL(url, baseUrl);\n  if (!fetcher) {\n    if (resolved.protocol !== \"file:\") {\n      throw new Error(\"No fetcher available for non-file WGSL URL.\");\n    }\n    const { readFile } = await import(\"fs/promises\");\n    const { fileURLToPath } = await import(\"url\");\n    const source = await readFile(fileURLToPath(resolved), \"utf8\");\n    assertNotHtmlWgsl(source, resolved.href);\n    return source;\n  }\n  const response = await fetcher(resolved);\n  if (!response.ok) {\n    const status = \"status\" in response ? response.status : \"unknown\";\n    const statusText = \"statusText\" in response ? response.statusText : \"\";\n    const detail = statusText ? `${status} ${statusText}` : `${status}`;\n    throw new Error(`Failed to load WGSL (${detail})`);\n  }\n  const source = await response.text();\n  assertNotHtmlWgsl(source, resolved.href);\n  return source;\n}\n\nfunction stripComments(source) {\n  return source\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\")\n    .replace(/\\/\\/.*$/gm, \"\");\n}\n\nfunction tokenize(source) {\n  return source.match(/[A-Za-z_][A-Za-z0-9_]*|[{}();<>,:=]/g) ?? [];\n}\n\nfunction isIdentifier(token) {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(token);\n}\n\nfunction readNameAfterType(tokens, startIndex) {\n  let i = startIndex;\n  if (tokens[i] === \"<\") {\n    let depth = 1;\n    i += 1;\n    while (i < tokens.length && depth > 0) {\n      if (tokens[i] === \"<\") {\n        depth += 1;\n      } else if (tokens[i] === \">\") {\n        depth -= 1;\n      }\n      i += 1;\n    }\n  }\n  return tokens[i];\n}\n\nfunction scanModuleNames(source) {\n  const cleaned = stripComments(source);\n  const tokens = tokenize(cleaned);\n  const names = [];\n  let depth = 0;\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    if (token === \"{\") {\n      depth += 1;\n      continue;\n    }\n    if (token === \"}\") {\n      depth = Math.max(0, depth - 1);\n      continue;\n    }\n    if (depth !== 0) {\n      continue;\n    }\n    if (token === \"fn\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"fn\", name });\n      }\n      continue;\n    }\n    if (token === \"struct\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"struct\", name });\n      }\n      continue;\n    }\n    if (token === \"alias\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"alias\", name });\n      }\n      continue;\n    }\n    if (token === \"var\" || token === \"let\" || token === \"const\" || token === \"override\") {\n      const name = readNameAfterType(tokens, i + 1);\n      if (isIdentifier(name)) {\n        names.push({ kind: token, name });\n      }\n    }\n  }\n  return names;\n}\n\nfunction buildNameIndex(modules) {\n  const index = new Map();\n  for (const module of modules) {\n    for (const item of scanModuleNames(module.source)) {\n      const bucket = index.get(item.name) ?? [];\n      bucket.push({ kind: item.kind, module: module.name });\n      index.set(item.name, bucket);\n    }\n  }\n  return index;\n}\n\nfunction assertNoNameClashes(modules) {\n  const index = buildNameIndex(modules);\n  const clashes = [];\n  for (const [name, entries] of index.entries()) {\n    if (entries.length > 1) {\n      clashes.push({ name, entries });\n    }\n  }\n  if (clashes.length === 0) {\n    return;\n  }\n  const lines = [\"WGSL debug: identifier clashes detected:\"];\n  for (const clash of clashes) {\n    const locations = clash.entries\n      .map((entry) => `${entry.module} (${entry.kind})`)\n      .join(\", \");\n    lines.push(`- ${clash.name}: ${locations}`);\n  }\n  throw new Error(lines.join(\"\\n\"));\n}\n\nfunction assertNotHtmlWgsl(source, context) {\n  const sample = source.slice(0, 200).toLowerCase();\n  if (\n    sample.includes(\"<!doctype\") ||\n    sample.includes(\"<html\") ||\n    sample.includes(\"<meta\")\n  ) {\n    const label = context ? ` for ${context}` : \"\";\n    throw new Error(\n      `Expected WGSL${label} but received HTML. Check the URL or server root.`\n    );\n  }\n}\n\nfunction renameProcessJob(source, name) {\n  return source.replace(/\\bprocess_job\\b/g, name);\n}\n\nfunction getQueueCompatMap(source) {\n  if (!/\\bJobMeta\\b/.test(source)) {\n    return null;\n  }\n  return [{ from: /\\bJobMeta\\b/g, to: \"JobDesc\" }];\n}\n\nfunction applyCompatMap(source, map) {\n  if (!map || map.length === 0) {\n    return source;\n  }\n  let next = source;\n  for (const entry of map) {\n    next = next.replace(entry.from, entry.to);\n  }\n  return next;\n}\n\nfunction normalizeJobs(jobs) {\n  const normalized = jobs.map((job, index) => {\n    if (typeof job === \"string\") {\n      return {\n        jobType: index,\n        wgsl: job,\n        label: `job_${index}`,\n        sourceName: `job-${index}`,\n      };\n    }\n    if (!job || typeof job.wgsl !== \"string\") {\n      throw new Error(\"Job entries must provide WGSL source strings.\");\n    }\n    const jobType = job.jobType ?? index;\n    const label = job.label ?? `job_${jobType}`;\n    return {\n      jobType,\n      wgsl: job.wgsl,\n      label,\n      sourceName: job.sourceName ?? job.label ?? `job-${jobType}`,\n    };\n  });\n  const seen = new Set();\n  for (const job of normalized) {\n    if (seen.has(job.jobType)) {\n      throw new Error(`Duplicate job_type detected: ${job.jobType}`);\n    }\n    seen.add(job.jobType);\n  }\n  return normalized;\n}\n\nfunction buildProcessJobDispatch(jobs) {\n  const lines = [\n    \"fn process_job(job_index: u32, job_type: u32, payload_words: u32) {\",\n  ];\n  if (jobs.length === 0) {\n    lines.push(\"  return;\");\n    lines.push(\"}\");\n    return lines.join(\"\\n\");\n  }\n  jobs.forEach((job, idx) => {\n    const clause = idx === 0 ? \"if\" : \"else if\";\n    lines.push(`  ${clause} (job_type == ${job.jobType}u) {`);\n    lines.push(\n      `    ${job.entryName}(job_index, job_type, payload_words);`\n    );\n    lines.push(\"  }\");\n  });\n  lines.push(\"}\");\n  return lines.join(\"\\n\");\n}\n\nexport async function loadWorkerWgsl(options = {}) {\n  const { url = workerWgslUrl, fetcher } = options ?? {};\n  const source = await loadWgslSource({\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load worker WGSL source.\");\n  }\n  return source;\n}\n\nexport async function loadQueueWgsl(options = {}) {\n  const { queueCompat = true, ...rest } = options ?? {};\n  const source = await loadQueueWgslRaw(rest);\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load queue WGSL source.\");\n  }\n  assertNotHtmlWgsl(source, rest?.url ? String(rest.url) : \"queue WGSL\");\n  if (!queueCompat) {\n    return source;\n  }\n  const compatMap = getQueueCompatMap(source);\n  return applyCompatMap(source, compatMap);\n}\n\nexport async function loadJobWgsl(options = {}) {\n  const { wgsl, url, fetcher, label } = options ?? {};\n  const source = await loadWgslSource({\n    wgsl,\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"loadJobWgsl requires a WGSL string or URL.\");\n  }\n  const jobType = nextJobType;\n  nextJobType += 1;\n  jobRegistry.push({\n    jobType,\n    wgsl: source,\n    label: label ?? `job_${jobType}`,\n    sourceName: label ?? `job-${jobType}`,\n  });\n  return jobType;\n}\n\nexport async function assembleWorkerWgsl(workerWgsl, options = {}) {\n  const {\n    queueWgsl,\n    queueUrl,\n    preludeWgsl,\n    preludeUrl,\n    fetcher,\n    jobs,\n    debug,\n    queueCompat = true,\n  } = options ?? {};\n  const rawQueueSource =\n    queueWgsl ?? (await loadQueueWgslRaw({ url: queueUrl, fetcher }));\n  const bodyRaw = workerWgsl ?? (await loadWorkerWgsl({ fetcher }));\n  const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;\n  const queueSource = applyCompatMap(rawQueueSource, compatMap);\n  const preludeRaw =\n    preludeWgsl ??\n    (preludeUrl\n      ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl })\n      : \"\");\n  if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== \"string\") {\n    throw new Error(\"Failed to load prelude WGSL source.\");\n  }\n  const preludeSource =\n    typeof preludeRaw === \"string\" && preludeRaw.length > 0\n      ? applyCompatMap(preludeRaw, compatMap)\n      : \"\";\n  const body = applyCompatMap(bodyRaw, compatMap);\n  const jobList = normalizeJobs(\n    typeof jobs === \"undefined\" ? jobRegistry : jobs\n  );\n  if (!jobList || jobList.length === 0) {\n    return `${queueSource}\\n\\n${body}`;\n  }\n  const rewrittenJobs = jobList.map((job) => {\n    const source = applyCompatMap(job.wgsl, compatMap);\n    const hasProcessJob = /\\bfn\\s+process_job\\b/.test(source);\n    if (!hasProcessJob) {\n      throw new Error(\n        `Job ${job.sourceName} is missing a process_job() entry function.`\n      );\n    }\n    const entryName = `process_job__${job.jobType}`;\n    const renamed = renameProcessJob(source, entryName);\n    return { ...job, entryName, wgsl: renamed };\n  });\n  const dispatch = buildProcessJobDispatch(rewrittenJobs);\n  const modulesForDebug = debug\n    ? [\n        { name: \"queue.wgsl\", source: queueSource },\n        ...(preludeSource\n          ? [{ name: \"jobs.prelude.wgsl\", source: preludeSource }]\n          : []),\n        ...rewrittenJobs.map((job) => ({\n          name: job.sourceName,\n          source: job.wgsl,\n        })),\n        { name: \"jobs.dispatch.wgsl\", source: dispatch },\n        { name: \"worker.wgsl\", source: body },\n      ]\n    : null;\n  if (modulesForDebug) {\n    assertNoNameClashes(modulesForDebug);\n  }\n  const jobBlocks = rewrittenJobs\n    .map((job) => `// Job ${job.jobType}: ${job.label}\\n${job.wgsl}`)\n    .join(\"\\n\\n\");\n  const preludeBlock = preludeSource ? `${preludeSource}\\n\\n` : \"\";\n  return `${queueSource}\\n\\n${preludeBlock}${jobBlocks}\\n\\n${dispatch}\\n\\n${body}`;\n}\n\nfunction normalizeWorkgroups(value, label) {\n  if (typeof value === \"number\") {\n    return [value, 1, 1];\n  }\n  if (Array.isArray(value)) {\n    const [x = 0, y = 1, z = 1] = value;\n    return [x, y, z];\n  }\n  throw new Error(`Invalid workgroup count for ${label}.`);\n}\n\nfunction resolveWorkgroups(value, label) {\n  if (typeof value === \"function\") {\n    return normalizeWorkgroups(value(), label);\n  }\n  if (value == null) {\n    return null;\n  }\n  return normalizeWorkgroups(value, label);\n}\n\nfunction setBindGroups(pass, bindGroups) {\n  if (!bindGroups) {\n    return;\n  }\n  bindGroups.forEach((group, index) => {\n    if (group) {\n      pass.setBindGroup(index, group);\n    }\n  });\n}\n\nfunction computeWorkerWorkgroups(maxJobs, workgroupSize) {\n  const jobs =\n    typeof maxJobs === \"function\" ? Number(maxJobs()) : Number(maxJobs);\n  if (!Number.isFinite(jobs) || jobs <= 0) {\n    throw new Error(\"maxJobsPerDispatch must be a positive number.\");\n  }\n  const size = Number(workgroupSize);\n  if (!Number.isFinite(size) || size <= 0) {\n    throw new Error(\"workgroupSize must be a positive number.\");\n  }\n  return Math.max(1, Math.ceil(jobs / size));\n}\n\nexport function createWorkerLoop(options = {}) {\n  const {\n    device,\n    worker,\n    jobs = [],\n    workgroupSize = 64,\n    maxJobsPerDispatch,\n    rateHz,\n    label,\n    onTick,\n    onError,\n  } = options ?? {};\n\n  if (!device) {\n    throw new Error(\"createWorkerLoop requires a GPUDevice.\");\n  }\n  if (!worker || !worker.pipeline) {\n    throw new Error(\"createWorkerLoop requires a worker pipeline.\");\n  }\n\n  let running = false;\n  let handle = null;\n  let usingRaf = false;\n  const intervalMs =\n    Number.isFinite(rateHz) && rateHz > 0 ? 1000 / rateHz : null;\n\n  const tick = () => {\n    try {\n      const encoder = device.createCommandEncoder();\n      const pass = encoder.beginComputePass(\n        label ? { label } : undefined\n      );\n\n      pass.setPipeline(worker.pipeline);\n      setBindGroups(pass, worker.bindGroups);\n\n      const explicitWorkerGroups =\n        resolveWorkgroups(worker.workgroups, \"worker\") ??\n        resolveWorkgroups(worker.workgroupCount, \"worker\") ??\n        resolveWorkgroups(worker.dispatch, \"worker\");\n\n      const workerGroups = explicitWorkerGroups\n        ? explicitWorkerGroups\n        : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];\n\n      if (workerGroups[0] > 0) {\n        pass.dispatchWorkgroups(...workerGroups);\n      }\n\n      jobs.forEach((job, index) => {\n        if (!job || !job.pipeline) {\n          throw new Error(`Job pipeline missing at index ${index}.`);\n        }\n        pass.setPipeline(job.pipeline);\n        setBindGroups(pass, job.bindGroups);\n        const groups = resolveWorkgroups(\n          job.workgroups ?? job.workgroupCount ?? job.dispatch,\n          `job ${index}`\n        );\n        if (!groups) {\n          throw new Error(`Job ${index} requires a workgroup count.`);\n        }\n        if (groups[0] > 0) {\n          pass.dispatchWorkgroups(...groups);\n        }\n      });\n\n      pass.end();\n      device.queue.submit([encoder.finish()]);\n\n      if (onTick) {\n        onTick();\n      }\n    } catch (err) {\n      if (onError) {\n        onError(err);\n        return;\n      }\n      throw err;\n    }\n  };\n\n  const scheduleNext = () => {\n    if (!running) {\n      return;\n    }\n    if (intervalMs != null) {\n      tick();\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, intervalMs);\n      return;\n    }\n    tick();\n    if (typeof requestAnimationFrame === \"function\") {\n      usingRaf = true;\n      handle = requestAnimationFrame(scheduleNext);\n    } else {\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, 0);\n    }\n  };\n\n  const start = () => {\n    if (running) {\n      return;\n    }\n    running = true;\n    scheduleNext();\n  };\n\n  const stop = () => {\n    running = false;\n    if (handle == null) {\n      return;\n    }\n    if (usingRaf && typeof cancelAnimationFrame === \"function\") {\n      cancelAnimationFrame(handle);\n    } else {\n      clearTimeout(handle);\n    }\n    handle = null;\n  };\n\n  return {\n    start,\n    stop,\n    tick,\n    get running() {\n      return running;\n    },\n  };\n}\n"],"mappings":"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","names":["source"]}
+{"version":3,"sources":["../src/index.js"],"sourcesContent":["import {\n  loadSchedulerWgsl as loadSchedulerWgslRaw,\n  schedulerModes as workerSchedulerModes,\n} from \"@plasius/gpu-lock-free-queue\";\n\nexport const workerWgslUrl = (() => {\n  if (typeof __IMPORT_META_URL__ !== \"undefined\") {\n    return new URL(\"./worker.wgsl\", __IMPORT_META_URL__);\n  }\n  if (typeof __filename !== \"undefined\" && typeof require !== \"undefined\") {\n    const { pathToFileURL } = require(\"node:url\");\n    return new URL(\"./worker.wgsl\", pathToFileURL(__filename));\n  }\n  const base =\n    typeof process !== \"undefined\" && process.cwd\n      ? `file://${process.cwd()}/`\n      : \"file:///\";\n  return new URL(\"./worker.wgsl\", base);\n})();\n\nconst jobRegistry = [];\nlet nextJobType = 0;\n\nasync function loadWgslSource(options = {}) {\n  const { wgsl, url, fetcher = globalThis.fetch, baseUrl } = options ?? {};\n  if (typeof wgsl === \"string\") {\n    assertNotHtmlWgsl(wgsl, \"inline WGSL\");\n    return wgsl;\n  }\n  if (!url) {\n    return null;\n  }\n  const resolved = url instanceof URL ? url : new URL(url, baseUrl);\n  if (!fetcher) {\n    if (resolved.protocol !== \"file:\") {\n      throw new Error(\"No fetcher available for non-file WGSL URL.\");\n    }\n    const { readFile } = await import(\"fs/promises\");\n    const { fileURLToPath } = await import(\"url\");\n    const source = await readFile(fileURLToPath(resolved), \"utf8\");\n    assertNotHtmlWgsl(source, resolved.href);\n    return source;\n  }\n  const response = await fetcher(resolved);\n  if (!response.ok) {\n    const status = \"status\" in response ? response.status : \"unknown\";\n    const statusText = \"statusText\" in response ? response.statusText : \"\";\n    const detail = statusText ? `${status} ${statusText}` : `${status}`;\n    throw new Error(`Failed to load WGSL (${detail})`);\n  }\n  const source = await response.text();\n  assertNotHtmlWgsl(source, resolved.href);\n  return source;\n}\n\nfunction stripComments(source) {\n  return source\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\")\n    .replace(/\\/\\/.*$/gm, \"\");\n}\n\nfunction tokenize(source) {\n  return source.match(/[A-Za-z_][A-Za-z0-9_]*|[{}();<>,:=]/g) ?? [];\n}\n\nfunction isIdentifier(token) {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(token);\n}\n\nfunction readNameAfterType(tokens, startIndex) {\n  let i = startIndex;\n  if (tokens[i] === \"<\") {\n    let depth = 1;\n    i += 1;\n    while (i < tokens.length && depth > 0) {\n      if (tokens[i] === \"<\") {\n        depth += 1;\n      } else if (tokens[i] === \">\") {\n        depth -= 1;\n      }\n      i += 1;\n    }\n  }\n  return tokens[i];\n}\n\nfunction scanModuleNames(source) {\n  const cleaned = stripComments(source);\n  const tokens = tokenize(cleaned);\n  const names = [];\n  let depth = 0;\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    if (token === \"{\") {\n      depth += 1;\n      continue;\n    }\n    if (token === \"}\") {\n      depth = Math.max(0, depth - 1);\n      continue;\n    }\n    if (depth !== 0) {\n      continue;\n    }\n    if (token === \"fn\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"fn\", name });\n      }\n      continue;\n    }\n    if (token === \"struct\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"struct\", name });\n      }\n      continue;\n    }\n    if (token === \"alias\") {\n      const name = tokens[i + 1];\n      if (isIdentifier(name)) {\n        names.push({ kind: \"alias\", name });\n      }\n      continue;\n    }\n    if (token === \"var\" || token === \"let\" || token === \"const\" || token === \"override\") {\n      const name = readNameAfterType(tokens, i + 1);\n      if (isIdentifier(name)) {\n        names.push({ kind: token, name });\n      }\n    }\n  }\n  return names;\n}\n\nfunction buildNameIndex(modules) {\n  const index = new Map();\n  for (const module of modules) {\n    for (const item of scanModuleNames(module.source)) {\n      const bucket = index.get(item.name) ?? [];\n      bucket.push({ kind: item.kind, module: module.name });\n      index.set(item.name, bucket);\n    }\n  }\n  return index;\n}\n\nfunction assertNoNameClashes(modules) {\n  const index = buildNameIndex(modules);\n  const clashes = [];\n  for (const [name, entries] of index.entries()) {\n    if (entries.length > 1) {\n      clashes.push({ name, entries });\n    }\n  }\n  if (clashes.length === 0) {\n    return;\n  }\n  const lines = [\"WGSL debug: identifier clashes detected:\"];\n  for (const clash of clashes) {\n    const locations = clash.entries\n      .map((entry) => `${entry.module} (${entry.kind})`)\n      .join(\", \");\n    lines.push(`- ${clash.name}: ${locations}`);\n  }\n  throw new Error(lines.join(\"\\n\"));\n}\n\nfunction assertNotHtmlWgsl(source, context) {\n  const sample = source.slice(0, 200).toLowerCase();\n  if (\n    sample.includes(\"<!doctype\") ||\n    sample.includes(\"<html\") ||\n    sample.includes(\"<meta\")\n  ) {\n    const label = context ? ` for ${context}` : \"\";\n    throw new Error(\n      `Expected WGSL${label} but received HTML. Check the URL or server root.`\n    );\n  }\n}\n\nfunction renameProcessJob(source, name) {\n  return source.replace(/\\bprocess_job\\b/g, name);\n}\n\nfunction getQueueCompatMap(source) {\n  if (!/\\bJobMeta\\b/.test(source)) {\n    return null;\n  }\n  return [{ from: /\\bJobMeta\\b/g, to: \"JobDesc\" }];\n}\n\nfunction normalizeQueueMode(mode) {\n  const resolved = mode ?? \"flat\";\n  if (!workerSchedulerModes.includes(resolved)) {\n    throw new Error(\n      `queueMode must be one of: ${workerSchedulerModes.join(\", \")}.`\n    );\n  }\n  return resolved;\n}\n\nfunction applyCompatMap(source, map) {\n  if (!map || map.length === 0) {\n    return source;\n  }\n  let next = source;\n  for (const entry of map) {\n    next = next.replace(entry.from, entry.to);\n  }\n  return next;\n}\n\nfunction normalizeJobs(jobs) {\n  const normalized = jobs.map((job, index) => {\n    if (typeof job === \"string\") {\n      return {\n        jobType: index,\n        wgsl: job,\n        label: `job_${index}`,\n        sourceName: `job-${index}`,\n      };\n    }\n    if (!job || typeof job.wgsl !== \"string\") {\n      throw new Error(\"Job entries must provide WGSL source strings.\");\n    }\n    const jobType = job.jobType ?? index;\n    const label = job.label ?? `job_${jobType}`;\n    return {\n      jobType,\n      wgsl: job.wgsl,\n      label,\n      sourceName: job.sourceName ?? job.label ?? `job-${jobType}`,\n    };\n  });\n  const seen = new Set();\n  for (const job of normalized) {\n    if (seen.has(job.jobType)) {\n      throw new Error(`Duplicate job_type detected: ${job.jobType}`);\n    }\n    seen.add(job.jobType);\n  }\n  return normalized;\n}\n\nfunction buildProcessJobDispatch(jobs) {\n  const lines = [\n    \"fn process_job(job_index: u32, job_type: u32, payload_words: u32) {\",\n  ];\n  if (jobs.length === 0) {\n    lines.push(\"  return;\");\n    lines.push(\"}\");\n    return lines.join(\"\\n\");\n  }\n  jobs.forEach((job, idx) => {\n    const clause = idx === 0 ? \"if\" : \"else if\";\n    lines.push(`  ${clause} (job_type == ${job.jobType}u) {`);\n    lines.push(\n      `    ${job.entryName}(job_index, job_type, payload_words);`\n    );\n    lines.push(\"  }\");\n  });\n  lines.push(\"}\");\n  return lines.join(\"\\n\");\n}\n\nexport async function loadWorkerWgsl(options = {}) {\n  const { url = workerWgslUrl, fetcher } = options ?? {};\n  const source = await loadWgslSource({\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load worker WGSL source.\");\n  }\n  return source;\n}\n\nexport async function loadQueueWgsl(options = {}) {\n  const { queueCompat = true, queueMode = \"flat\", ...rest } = options ?? {};\n  const source = await loadSchedulerWgslRaw({\n    mode: normalizeQueueMode(queueMode),\n    ...rest,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"Failed to load queue WGSL source.\");\n  }\n  assertNotHtmlWgsl(source, rest?.url ? String(rest.url) : \"queue WGSL\");\n  if (!queueCompat) {\n    return source;\n  }\n  const compatMap = getQueueCompatMap(source);\n  return applyCompatMap(source, compatMap);\n}\n\nfunction ensureQueueLifecycleHooks(source) {\n  if (/\\bfn\\s+complete_job\\b/.test(source)) {\n    return source;\n  }\n  return `${source}\\n\\nfn complete_job(job_index: u32) {\\n  _ = job_index;\\n}`;\n}\n\nexport async function loadJobWgsl(options = {}) {\n  const { wgsl, url, fetcher, label } = options ?? {};\n  const source = await loadWgslSource({\n    wgsl,\n    url,\n    fetcher,\n    baseUrl: workerWgslUrl,\n  });\n  if (typeof source !== \"string\") {\n    throw new Error(\"loadJobWgsl requires a WGSL string or URL.\");\n  }\n  const jobType = nextJobType;\n  nextJobType += 1;\n  jobRegistry.push({\n    jobType,\n    wgsl: source,\n    label: label ?? `job_${jobType}`,\n    sourceName: label ?? `job-${jobType}`,\n  });\n  return jobType;\n}\n\nexport async function assembleWorkerWgsl(workerWgsl, options = {}) {\n  const {\n    queueWgsl,\n    queueUrl,\n    preludeWgsl,\n    preludeUrl,\n    fetcher,\n    jobs,\n    debug,\n    queueCompat = true,\n    queueMode = \"flat\",\n  } = options ?? {};\n  const resolvedQueueMode = normalizeQueueMode(queueMode);\n  const rawQueueSource =\n    queueWgsl ??\n    (await loadSchedulerWgslRaw({\n      mode: resolvedQueueMode,\n      url: queueUrl,\n      fetcher,\n    }));\n  const bodyRaw = workerWgsl ?? (await loadWorkerWgsl({ fetcher }));\n  const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;\n  const queueSource = ensureQueueLifecycleHooks(\n    applyCompatMap(rawQueueSource, compatMap)\n  );\n  const preludeRaw =\n    preludeWgsl ??\n    (preludeUrl\n      ? await loadWgslSource({ url: preludeUrl, fetcher, baseUrl: workerWgslUrl })\n      : \"\");\n  if ((preludeWgsl || preludeUrl) && typeof preludeRaw !== \"string\") {\n    throw new Error(\"Failed to load prelude WGSL source.\");\n  }\n  const preludeSource =\n    typeof preludeRaw === \"string\" && preludeRaw.length > 0\n      ? applyCompatMap(preludeRaw, compatMap)\n      : \"\";\n  const body = applyCompatMap(bodyRaw, compatMap);\n  const jobList = normalizeJobs(\n    typeof jobs === \"undefined\" ? jobRegistry : jobs\n  );\n  if (!jobList || jobList.length === 0) {\n    return `${queueSource}\\n\\n${body}`;\n  }\n  const rewrittenJobs = jobList.map((job) => {\n    const source = applyCompatMap(job.wgsl, compatMap);\n    const hasProcessJob = /\\bfn\\s+process_job\\b/.test(source);\n    if (!hasProcessJob) {\n      throw new Error(\n        `Job ${job.sourceName} is missing a process_job() entry function.`\n      );\n    }\n    const entryName = `process_job__${job.jobType}`;\n    const renamed = renameProcessJob(source, entryName);\n    return { ...job, entryName, wgsl: renamed };\n  });\n  const dispatch = buildProcessJobDispatch(rewrittenJobs);\n  const modulesForDebug = debug\n    ? [\n        { name: \"queue.wgsl\", source: queueSource },\n        ...(preludeSource\n          ? [{ name: \"jobs.prelude.wgsl\", source: preludeSource }]\n          : []),\n        ...rewrittenJobs.map((job) => ({\n          name: job.sourceName,\n          source: job.wgsl,\n        })),\n        { name: \"jobs.dispatch.wgsl\", source: dispatch },\n        { name: \"worker.wgsl\", source: body },\n      ]\n    : null;\n  if (modulesForDebug) {\n    assertNoNameClashes(modulesForDebug);\n  }\n  const jobBlocks = rewrittenJobs\n    .map((job) => `// Job ${job.jobType}: ${job.label}\\n${job.wgsl}`)\n    .join(\"\\n\\n\");\n  const preludeBlock = preludeSource ? `${preludeSource}\\n\\n` : \"\";\n  return `${queueSource}\\n\\n${preludeBlock}${jobBlocks}\\n\\n${dispatch}\\n\\n${body}`;\n}\n\nfunction normalizeWorkgroups(value, label) {\n  if (typeof value === \"number\") {\n    return [value, 1, 1];\n  }\n  if (Array.isArray(value)) {\n    const [x = 0, y = 1, z = 1] = value;\n    return [x, y, z];\n  }\n  throw new Error(`Invalid workgroup count for ${label}.`);\n}\n\nfunction resolveWorkgroups(value, label) {\n  if (typeof value === \"function\") {\n    return normalizeWorkgroups(value(), label);\n  }\n  if (value == null) {\n    return null;\n  }\n  return normalizeWorkgroups(value, label);\n}\n\nfunction normalizeTelemetryText(value, fallback) {\n  if (typeof value !== \"string\") {\n    return fallback;\n  }\n  const trimmed = value.trim();\n  return trimmed ? trimmed.slice(0, 120) : fallback;\n}\n\nfunction resolveFrameId(value) {\n  if (typeof value === \"function\") {\n    return resolveFrameId(value());\n  }\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed ? trimmed.slice(0, 120) : undefined;\n}\n\nfunction toVector(workgroups) {\n  return { x: workgroups[0], y: workgroups[1], z: workgroups[2] };\n}\n\nfunction resolveTelemetryWorkgroupSize(descriptor, fallback, label) {\n  const size =\n    descriptor?.workgroupSize == null ? fallback : descriptor.workgroupSize;\n  if (size == null) {\n    return undefined;\n  }\n  const normalized =\n    typeof size === \"number\" ? normalizeWorkgroups(size, label) : resolveWorkgroups(size, label);\n  if (!normalized) {\n    return undefined;\n  }\n  return toVector(normalized);\n}\n\nfunction getNow() {\n  if (globalThis.performance && typeof globalThis.performance.now === \"function\") {\n    return globalThis.performance.now();\n  }\n  return Date.now();\n}\n\nfunction reportOptionalError(error, onError) {\n  if (!onError) {\n    return;\n  }\n  if (error instanceof Error) {\n    onError(error);\n    return;\n  }\n  onError(new Error(String(error)));\n}\n\nfunction emitOptionalHook(callback, payload, onError) {\n  if (typeof callback !== \"function\") {\n    return;\n  }\n  try {\n    callback(payload);\n  } catch (error) {\n    reportOptionalError(error, onError);\n  }\n}\n\nfunction buildDispatchTelemetrySample({\n  kind,\n  descriptor,\n  index,\n  frameId,\n  workgroups,\n  workgroupSize,\n}) {\n  const labelFallback = kind === \"worker\" ? \"worker\" : `job_${index}`;\n  const label = normalizeTelemetryText(descriptor?.label, labelFallback);\n  return {\n    kind,\n    index,\n    label,\n    owner: normalizeTelemetryText(descriptor?.owner, label),\n    queueClass: normalizeTelemetryText(descriptor?.queueClass, \"custom\"),\n    jobType: normalizeTelemetryText(\n      descriptor?.jobType,\n      kind === \"worker\" ? \"worker.dispatch\" : label\n    ),\n    frameId,\n    workgroups: toVector(workgroups),\n    workgroupSize,\n  };\n}\n\nfunction setBindGroups(pass, bindGroups) {\n  if (!bindGroups) {\n    return;\n  }\n  bindGroups.forEach((group, index) => {\n    if (group) {\n      pass.setBindGroup(index, group);\n    }\n  });\n}\n\nfunction computeWorkerWorkgroups(maxJobs, workgroupSize) {\n  const jobs =\n    typeof maxJobs === \"function\" ? Number(maxJobs()) : Number(maxJobs);\n  if (!Number.isFinite(jobs) || jobs <= 0) {\n    throw new Error(\"maxJobsPerDispatch must be a positive number.\");\n  }\n  const size = Number(workgroupSize);\n  if (!Number.isFinite(size) || size <= 0) {\n    throw new Error(\"workgroupSize must be a positive number.\");\n  }\n  return Math.max(1, Math.ceil(jobs / size));\n}\n\nexport function createWorkerLoop(options = {}) {\n  const {\n    device,\n    worker,\n    jobs = [],\n    workgroupSize = 64,\n    maxJobsPerDispatch,\n    rateHz,\n    label,\n    onTick,\n    onError,\n    frameId,\n    telemetry,\n  } = options ?? {};\n\n  if (!device) {\n    throw new Error(\"createWorkerLoop requires a GPUDevice.\");\n  }\n  if (!worker || !worker.pipeline) {\n    throw new Error(\"createWorkerLoop requires a worker pipeline.\");\n  }\n\n  let running = false;\n  let handle = null;\n  let usingRaf = false;\n  const intervalMs =\n    Number.isFinite(rateHz) && rateHz > 0 ? 1000 / rateHz : null;\n\n  const tick = () => {\n    try {\n      const tickStartMs = getNow();\n      const currentFrameId = resolveFrameId(frameId);\n      const telemetryDispatches = [];\n      const encoder = device.createCommandEncoder();\n      const pass = encoder.beginComputePass(\n        label ? { label } : undefined\n      );\n\n      pass.setPipeline(worker.pipeline);\n      setBindGroups(pass, worker.bindGroups);\n\n      const explicitWorkerGroups =\n        resolveWorkgroups(worker.workgroups, \"worker\") ??\n        resolveWorkgroups(worker.workgroupCount, \"worker\") ??\n        resolveWorkgroups(worker.dispatch, \"worker\");\n\n      const workerGroups = explicitWorkerGroups\n        ? explicitWorkerGroups\n        : [computeWorkerWorkgroups(maxJobsPerDispatch, workgroupSize), 1, 1];\n\n      if (workerGroups[0] > 0) {\n        pass.dispatchWorkgroups(...workerGroups);\n        telemetryDispatches.push(\n          buildDispatchTelemetrySample({\n            kind: \"worker\",\n            descriptor: worker,\n            index: 0,\n            frameId: currentFrameId,\n            workgroups: workerGroups,\n            workgroupSize: resolveTelemetryWorkgroupSize(\n              worker,\n              workgroupSize,\n              \"worker workgroupSize\"\n            ),\n          })\n        );\n      }\n\n      jobs.forEach((job, index) => {\n        if (!job || !job.pipeline) {\n          throw new Error(`Job pipeline missing at index ${index}.`);\n        }\n        pass.setPipeline(job.pipeline);\n        setBindGroups(pass, job.bindGroups);\n        const groups = resolveWorkgroups(\n          job.workgroups ?? job.workgroupCount ?? job.dispatch,\n          `job ${index}`\n        );\n        if (!groups) {\n          throw new Error(`Job ${index} requires a workgroup count.`);\n        }\n        if (groups[0] > 0) {\n          pass.dispatchWorkgroups(...groups);\n          telemetryDispatches.push(\n            buildDispatchTelemetrySample({\n              kind: \"job\",\n              descriptor: job,\n              index,\n              frameId: currentFrameId,\n              workgroups: groups,\n              workgroupSize: resolveTelemetryWorkgroupSize(\n                job,\n                undefined,\n                `job ${index} workgroupSize`\n              ),\n            })\n          );\n        }\n      });\n\n      pass.end();\n      device.queue.submit([encoder.finish()]);\n\n      telemetryDispatches.forEach((sample) => {\n        emitOptionalHook(telemetry?.onDispatch, sample, onError);\n      });\n      emitOptionalHook(\n        telemetry?.onTick,\n        {\n          frameId: currentFrameId,\n          tickDurationMs: getNow() - tickStartMs,\n          dispatchCount: telemetryDispatches.length,\n          workerDispatchCount: telemetryDispatches.filter(\n            (sample) => sample.kind === \"worker\"\n          ).length,\n          jobDispatchCount: telemetryDispatches.filter(\n            (sample) => sample.kind === \"job\"\n          ).length,\n          dispatches: telemetryDispatches,\n        },\n        onError\n      );\n\n      if (onTick) {\n        onTick();\n      }\n    } catch (err) {\n      if (onError) {\n        onError(err);\n        return;\n      }\n      throw err;\n    }\n  };\n\n  const scheduleNext = () => {\n    if (!running) {\n      return;\n    }\n    if (intervalMs != null) {\n      tick();\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, intervalMs);\n      return;\n    }\n    tick();\n    if (typeof requestAnimationFrame === \"function\") {\n      usingRaf = true;\n      handle = requestAnimationFrame(scheduleNext);\n    } else {\n      usingRaf = false;\n      handle = setTimeout(scheduleNext, 0);\n    }\n  };\n\n  const start = () => {\n    if (running) {\n      return;\n    }\n    running = true;\n    scheduleNext();\n  };\n\n  const stop = () => {\n    running = false;\n    if (handle == null) {\n      return;\n    }\n    if (usingRaf && typeof cancelAnimationFrame === \"function\") {\n      cancelAnimationFrame(handle);\n    } else {\n      clearTimeout(handle);\n    }\n    handle = null;\n  };\n\n  return {\n    start,\n    stop,\n    tick,\n    get running() {\n      return running;\n    },\n  };\n}\n"],"mappings":"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","names":["source"]}

package/dist/worker.wgsl

@@ -34,4 +34,5 @@ fn worker_main(@builtin(global_invocation_id) gid: vec3<u32>) {
 
   let job_info = output_jobs[idx];
   process_job(idx, job_info.job_type, job_info.payload_words);
+  complete_job(idx);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/gpu-worker",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "WebGPU worker runtime with a lock-free job queue for WGSL workloads.",
   "type": "module",
   "sideEffects": false,
@@ -55,7 +55,7 @@
   "author": "Plasius LTD <development@plasius.co.uk>",
   "license": "Apache-2.0",
   "dependencies": {
-    "@plasius/gpu-lock-free-queue": "^0.2.12"
+    "@plasius/gpu-lock-free-queue": "^0.2.13"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
@@ -89,5 +89,8 @@
   ],
   "overrides": {
     "minimatch": "^10.2.1"
+  },
+  "engines": {
+    "node": ">=24"
   }
 }

package/src/index.js

@@ -1,4 +1,7 @@
-import { loadQueueWgsl as loadQueueWgslRaw } from "@plasius/gpu-lock-free-queue";
+import {
+  loadSchedulerWgsl as loadSchedulerWgslRaw,
+  schedulerModes as workerSchedulerModes,
+} from "@plasius/gpu-lock-free-queue";
 
 export const workerWgslUrl = (() => {
   if (typeof __IMPORT_META_URL__ !== "undefined") {
@@ -188,6 +191,16 @@ function getQueueCompatMap(source) {
   return [{ from: /\bJobMeta\b/g, to: "JobDesc" }];
 }
 
+function normalizeQueueMode(mode) {
+  const resolved = mode ?? "flat";
+  if (!workerSchedulerModes.includes(resolved)) {
+    throw new Error(
+      `queueMode must be one of: ${workerSchedulerModes.join(", ")}.`
+    );
+  }
+  return resolved;
+}
+
 function applyCompatMap(source, map) {
   if (!map || map.length === 0) {
     return source;
@@ -266,8 +279,11 @@ export async function loadWorkerWgsl(options = {}) {
 }
 
 export async function loadQueueWgsl(options = {}) {
-  const { queueCompat = true, ...rest } = options ?? {};
-  const source = await loadQueueWgslRaw(rest);
+  const { queueCompat = true, queueMode = "flat", ...rest } = options ?? {};
+  const source = await loadSchedulerWgslRaw({
+    mode: normalizeQueueMode(queueMode),
+    ...rest,
+  });
   if (typeof source !== "string") {
     throw new Error("Failed to load queue WGSL source.");
   }
@@ -279,6 +295,13 @@ export async function loadQueueWgsl(options = {}) {
   return applyCompatMap(source, compatMap);
 }
 
+function ensureQueueLifecycleHooks(source) {
+  if (/\bfn\s+complete_job\b/.test(source)) {
+    return source;
+  }
+  return `${source}\n\nfn complete_job(job_index: u32) {\n  _ = job_index;\n}`;
+}
+
 export async function loadJobWgsl(options = {}) {
   const { wgsl, url, fetcher, label } = options ?? {};
   const source = await loadWgslSource({
@@ -311,12 +334,21 @@ export async function assembleWorkerWgsl(workerWgsl, options = {}) {
     jobs,
     debug,
     queueCompat = true,
+    queueMode = "flat",
   } = options ?? {};
+  const resolvedQueueMode = normalizeQueueMode(queueMode);
   const rawQueueSource =
-    queueWgsl ?? (await loadQueueWgslRaw({ url: queueUrl, fetcher }));
+    queueWgsl ??
+    (await loadSchedulerWgslRaw({
+      mode: resolvedQueueMode,
+      url: queueUrl,
+      fetcher,
+    }));
   const bodyRaw = workerWgsl ?? (await loadWorkerWgsl({ fetcher }));
   const compatMap = queueCompat ? getQueueCompatMap(rawQueueSource) : null;
-  const queueSource = applyCompatMap(rawQueueSource, compatMap);
+  const queueSource = ensureQueueLifecycleHooks(
+    applyCompatMap(rawQueueSource, compatMap)
+  );
   const preludeRaw =
     preludeWgsl ??
     (preludeUrl
@@ -394,6 +426,98 @@ function resolveWorkgroups(value, label) {
   return normalizeWorkgroups(value, label);
 }
 
+function normalizeTelemetryText(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : fallback;
+}
+
+function resolveFrameId(value) {
+  if (typeof value === "function") {
+    return resolveFrameId(value());
+  }
+  if (typeof value !== "string") {
+    return undefined;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, 120) : undefined;
+}
+
+function toVector(workgroups) {
+  return { x: workgroups[0], y: workgroups[1], z: workgroups[2] };
+}
+
+function resolveTelemetryWorkgroupSize(descriptor, fallback, label) {
+  const size =
+    descriptor?.workgroupSize == null ? fallback : descriptor.workgroupSize;
+  if (size == null) {
+    return undefined;
+  }
+  const normalized =
+    typeof size === "number" ? normalizeWorkgroups(size, label) : resolveWorkgroups(size, label);
+  if (!normalized) {
+    return undefined;
+  }
+  return toVector(normalized);
+}
+
+function getNow() {
+  if (globalThis.performance && typeof globalThis.performance.now === "function") {
+    return globalThis.performance.now();
+  }
+  return Date.now();
+}
+
+function reportOptionalError(error, onError) {
+  if (!onError) {
+    return;
+  }
+  if (error instanceof Error) {
+    onError(error);
+    return;
+  }
+  onError(new Error(String(error)));
+}
+
+function emitOptionalHook(callback, payload, onError) {
+  if (typeof callback !== "function") {
+    return;
+  }
+  try {
+    callback(payload);
+  } catch (error) {
+    reportOptionalError(error, onError);
+  }
+}
+
+function buildDispatchTelemetrySample({
+  kind,
+  descriptor,
+  index,
+  frameId,
+  workgroups,
+  workgroupSize,
+}) {
+  const labelFallback = kind === "worker" ? "worker" : `job_${index}`;
+  const label = normalizeTelemetryText(descriptor?.label, labelFallback);
+  return {
+    kind,
+    index,
+    label,
+    owner: normalizeTelemetryText(descriptor?.owner, label),
+    queueClass: normalizeTelemetryText(descriptor?.queueClass, "custom"),
+    jobType: normalizeTelemetryText(
+      descriptor?.jobType,
+      kind === "worker" ? "worker.dispatch" : label
+    ),
+    frameId,
+    workgroups: toVector(workgroups),
+    workgroupSize,
+  };
+}
+
 function setBindGroups(pass, bindGroups) {
   if (!bindGroups) {
     return;
@@ -429,6 +553,8 @@ export function createWorkerLoop(options = {}) {
     label,
     onTick,
     onError,
+    frameId,
+    telemetry,
   } = options ?? {};
 
   if (!device) {
@@ -446,6 +572,9 @@ export function createWorkerLoop(options = {}) {
 
   const tick = () => {
     try {
+      const tickStartMs = getNow();
+      const currentFrameId = resolveFrameId(frameId);
+      const telemetryDispatches = [];
       const encoder = device.createCommandEncoder();
       const pass = encoder.beginComputePass(
         label ? { label } : undefined
@@ -465,6 +594,20 @@ export function createWorkerLoop(options = {}) {
 
       if (workerGroups[0] > 0) {
         pass.dispatchWorkgroups(...workerGroups);
+        telemetryDispatches.push(
+          buildDispatchTelemetrySample({
+            kind: "worker",
+            descriptor: worker,
+            index: 0,
+            frameId: currentFrameId,
+            workgroups: workerGroups,
+            workgroupSize: resolveTelemetryWorkgroupSize(
+              worker,
+              workgroupSize,
+              "worker workgroupSize"
+            ),
+          })
+        );
       }
 
       jobs.forEach((job, index) => {
@@ -482,12 +625,46 @@ export function createWorkerLoop(options = {}) {
         }
         if (groups[0] > 0) {
           pass.dispatchWorkgroups(...groups);
+          telemetryDispatches.push(
+            buildDispatchTelemetrySample({
+              kind: "job",
+              descriptor: job,
+              index,
+              frameId: currentFrameId,
+              workgroups: groups,
+              workgroupSize: resolveTelemetryWorkgroupSize(
+                job,
+                undefined,
+                `job ${index} workgroupSize`
+              ),
+            })
+          );
         }
       });
 
       pass.end();
       device.queue.submit([encoder.finish()]);
 
+      telemetryDispatches.forEach((sample) => {
+        emitOptionalHook(telemetry?.onDispatch, sample, onError);
+      });
+      emitOptionalHook(
+        telemetry?.onTick,
+        {
+          frameId: currentFrameId,
+          tickDurationMs: getNow() - tickStartMs,
+          dispatchCount: telemetryDispatches.length,
+          workerDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "worker"
+          ).length,
+          jobDispatchCount: telemetryDispatches.filter(
+            (sample) => sample.kind === "job"
+          ).length,
+          dispatches: telemetryDispatches,
+        },
+        onError
+      );
+
       if (onTick) {
         onTick();
       }

package/src/worker.wgsl

@@ -34,4 +34,5 @@ fn worker_main(@builtin(global_invocation_id) gid: vec3<u32>) {
 
   let job_info = output_jobs[idx];
   process_job(idx, job_info.job_type, job_info.payload_words);
+  complete_job(idx);
 }