@offmain/workerkit 0.13.0 → 0.14.0

package/README.md

@@ -75,27 +75,32 @@ When worker logic relies on external npm packages (such as Luxon, `date-fns`, `i
 
 Passing `createWorker` enables modern module bundlers (Webpack 5, Vite, Rollup, Parcel) to analyze and bundle the worker file along with all of its dependencies into a dedicated ES module worker chunk.
 
-### Dedicated Worker Script
+### Dedicated Worker Script with `defineWorker`
+
+When writing standalone worker files, wrap your export in `defineWorker`. This automatically handles standard runs, worker-to-worker pipelines (`pipeline()`), and persistent dataset caching without manual `postMessage` / `onmessage` boilerplate:
 
 ```ts
 // transform-data.worker.ts
+import { defineWorker } from '@offmain/workerkit';
 import { format } from 'date-fns';
 import { t } from './i18n.ts';
 
-self.addEventListener('message', (event) => {
-  try {
-    const { items, locale } = event.data.data;
-    const result = items.map((item: any) => ({
+export default defineWorker(
+  async ({
+    data,
+    options,
+  }: {
+    data: { items: any[]; locale: string };
+    options?: { prefix?: string };
+  }) => {
+    const { items, locale } = data;
+    return items.map((item: any) => ({
       ...item,
       formattedDate: format(new Date(item.timestamp), 'yyyy-MM-dd'),
-      label: t('transaction', locale),
+      label: (options?.prefix ?? '') + t('transaction', locale),
     }));
-
-    self.postMessage({ ok: true, data: result });
-  } catch (err) {
-    self.postMessage({ ok: false, error: (err as Error).message });
-  }
-});
+  },
+);
 ```
 
 ### Webpack 5 & Vite Static Analysis (`createWorker`)
@@ -176,7 +181,7 @@ Only the final result crosses back to the main thread. If your pipeline generate
 
 ### Usage
 
-```ts
+````ts
 import { MainWorkerFactory } from '@offmain/workerkit';
 import { fetchData, transform, aggregate } from './workers.ts';
 
@@ -188,20 +193,33 @@ const factory = new MainWorkerFactory({
   ] as const,
 });
 
+### Step-Specific Options and Configs in Pipeline
+
+You can pass step-specific parameters (such as `options`, `configs`, etc.) directly to each pipeline step:
+
+```ts
 const result = await factory.pipeline<AggregateResult>([
-  { worker: 'fetchData', srcData: { url: '/api/records' } },
-  { worker: 'transform' }, // receives fetchData output directly
-  { worker: 'aggregate' }, // receives transform output directly
+  {
+    worker: 'fetchData',
+    srcData: { url: '/api/records' },
+    options: { timeout: 5000 },
+  },
+  {
+    worker: 'transform',
+    configs: { multiplier: 2 },
+  },
+  {
+    worker: 'aggregate',
+    options: { threshold: 10 },
+  },
 ]);
+````
 
-console.log(result); // only this small result crossed to main thread
-```
-
-### How each step receives data
+### How each step receives data and parameters
 
-- The first step receives `srcData` as `{ data: srcData, index: 0 }` — same as `runWorker`.
-- Each subsequent step receives the previous step's output as `{ data: previousOutput, index: 0 }`.
-- Worker functions don't need any special handling — they use the same `{ data }` parameter signature as regular workers.
+- The first step receives `srcData` merged with its step parameters as `{ data: srcData, options: { timeout: 5000 }, index: 0 }`.
+- Each subsequent step receives the previous step's output merged with its step parameters as `{ data: previousOutput, configs: { multiplier: 2 }, index: 0 }`.
+- Worker functions (both inline functions and native scripts using `defineWorker`) receive all step parameters in their first argument.
 
 ### When to use pipeline vs runWorker
 
@@ -310,11 +328,42 @@ The framework handles the caching transparently — your function always receive
 
 The cached dataset lives in worker memory until `release()` is called. For large datasets, always call `release()` when you're done to free the memory:
 
+After releasing, the next `runPersistent` call will create a fresh worker instance (requiring a new dataset).
+
+---
+
+## Lifecycle Management (`terminate`, `destroy`, `reset`, `restart`)
+
+`MainWorkerFactory` provides built-in lifecycle management to terminate running workers and clean up browser resources:
+
+### `terminate()` / `destroy()`
+
+Immediately stops all active workers (one-shot tasks, pipelines, reducers) and releases all cached persistent workers:
+
 ```ts
-factory.release('transform');
+// Stop all active threads and release persistent workers
+factory.terminate();
+// or
+factory.destroy(); // Alias for terminate()
+
+console.log(factory.isTerminated); // true
 ```
 
-After releasing, the next `runPersistent` call will create a fresh worker instance (requiring a new dataset).
+After calling `terminate()`, any attempt to run workers on the factory instance will immediately reject.
+
+### `reset()` / `restart()`
+
+Terminates all active/persistent worker instances and restores the factory to an active state (`isTerminated = false`), allowing new worker instances to be initiated cleanly:
+
+```ts
+// Stop existing workers and reset factory state
+factory.reset(); // or factory.restart()
+
+console.log(factory.isTerminated); // false
+
+// Factory is ready to initiate fresh worker instances again
+const settled = await factory.runWorker('sum', { srcData: [1, 2, 3] });
+```
 
 ---
 

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";var y=Object.defineProperty;var w=(n,e,r)=>e in n?y(n,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):n[e]=r;var h=(n,e,r)=>w(n,typeof e!="symbol"?e+"":e,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=n=>`
+"use strict";var S=Object.defineProperty;var x=(n,e,r)=>e in n?S(n,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):n[e]=r;var y=(n,e,r)=>x(n,typeof e!="symbol"?e+"":e,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const O=n=>`
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -21,7 +21,7 @@ self.addEventListener('message', async (event) => {
     self.postMessage({ ok: false, error: err instanceof Error ? err.message : String(err) });
   }
 })
-`,W=n=>`
+`,F=n=>`
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -40,10 +40,15 @@ const workerFn = ${n};
 let outputPort = null;
 let inputPort = null;
 let pendingData = null;
+let stepParams = {};
 
 async function processData(data) {
   try {
-    const output = await workerFn(data);
+    const payload =
+      typeof data === 'object' && data !== null && 'data' in data
+        ? { ...stepParams, ...data }
+        : { data, ...stepParams, index: 0 };
+    const output = await workerFn(payload);
     const result = { ok: true, data: output };
     const transfers = extractTransferables(output);
     if (outputPort) {
@@ -63,6 +68,9 @@ async function processData(data) {
 
 self.addEventListener('message', (event) => {
   if (event.data && event.data.__pipeline_ports__) {
+    if (event.data.stepParams) {
+      stepParams = event.data.stepParams;
+    }
     if (event.data.outputPort) {
       outputPort = event.data.outputPort;
     }
@@ -74,7 +82,7 @@ self.addEventListener('message', (event) => {
           if (outputPort) outputPort.postMessage(e.data);
           else self.postMessage(e.data);
         } else {
-          processData({ data: e.data.data, index: 0 });
+          processData({ data: e.data.data, ...stepParams, index: 0 });
         }
       };
     }
@@ -93,7 +101,7 @@ self.addEventListener('message', (event) => {
     pendingData = event.data;
   }
 });
-`,M=n=>`
+`,R=n=>`
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -149,7 +157,7 @@ self.addEventListener('message', async (event) => {
     self.postMessage({ ok: false, error: err instanceof Error ? err.message : String(err) });
   }
 });
-`;var m=(n=>(n.Default="default",n.Pipeline="pipeline",n.Persistent="persistent",n))(m||{});const P=Object.freeze({persistent:M,pipeline:W,default:v});class g{constructor(e,r){h(this,"_worker");if(r!=null&&r.createWorker)this._worker=r.createWorker();else if(e){const o=(r==null?void 0:r.mode)??"default",a=P[o](e.toString()),i=new Blob([a],{type:"application/javascript"});this._worker=new Worker(URL.createObjectURL(i))}else throw new Error("Either workerFunction or options.createWorker must be provided to WorkerFactory.")}get getWorker(){return this._worker}}class b{constructor(e){this.results=e}}function k(n,e=new Set){return n===null||typeof n!="object"?[]:e.has(n)?[]:(e.add(n),n instanceof ArrayBuffer||n instanceof MessagePort||typeof ImageBitmap<"u"&&n instanceof ImageBitmap||typeof OffscreenCanvas<"u"&&n instanceof OffscreenCanvas?[n]:ArrayBuffer.isView(n)?[n.buffer]:Array.isArray(n)?n.flatMap(r=>k(r,e)):Object.values(n).flatMap(r=>k(r,e)))}class _{constructor(e){h(this,"_workers");h(this,"_threads");h(this,"_persistentWorkers",new Map);h(this,"_activeWorkers",new Set);h(this,"_isTerminated",!1);this._workers=e.workers,this._threads=navigator.hardwareConcurrency}get isTerminated(){return this._isTerminated}trackWorker(e){if(this._isTerminated)throw e.terminate(),new Error("MainWorkerFactory has been terminated");return this._activeWorkers.add(e),e}terminateWorker(e){this._activeWorkers.delete(e);try{e.terminate()}catch{}}initWorker(e){const r=new g(e.func,{createWorker:e.createWorker});return this.trackWorker(r.getWorker),r}partitionArray(e,r){if(!e.length)return[];if(r<=0)throw new Error("numChunks must be positive");const o=Math.min(r,e.length),a=Math.floor(e.length/o),i=e.length%o,c=[];let u=0;for(let t=0;t<o;t++){const s=a+(t<i?1:0);c.push(e.slice(u,u+s)),u+=s}return c}findWorkerByName(e){return this._workers.find(r=>r.name===e)}async runWorker(e,{srcData:r,...o}){if(this._isTerminated)return Promise.reject(new Error("MainWorkerFactory has been terminated"));const a=this.findWorkerByName(e);if(!a)return Promise.reject(new Error(`Worker "${e}" not found`));const i=a.maxConcurrency??this._threads,c=!!(Array.isArray(r)&&r.length>1&&a.partition),u=c?this.partitionArray(r,i):r,t=this.createWorkerPromises(a,e,{data:u,...o},i,c),s=await Promise.allSettled(t);return new b(s)}createWorkerPromises(e,r,o,a,i){const{data:c,...u}=o;return Array.from({length:a},(t,s)=>{const f=i&&Array.isArray(c)?c[s]:c;return this.runWorkerWithRetry({workerFunc:e.func,createWorker:e.createWorker,workerName:r,index:s,data:{data:f,...u}},e.retries)})}async runWorkerWithRetry(e,r=2){try{return await this.initiateWorker(e)}catch(o){if(r>0)return console.error(`Worker ${e.index} failed, retrying (${r} left):`,o),this.runWorkerWithRetry(e,r-1);throw console.error("Worker failed after all retries:",o),o}}initiateWorker({workerFunc:e,createWorker:r,workerName:o,index:a,data:i}){return new Promise((c,u)=>{const s=this.initWorker({name:o,role:"",func:e,createWorker:r}).getWorker;s.onerror=l=>{this.terminateWorker(s),u({index:a,workerConfigs:{workerFunc:e,createWorker:r,workerName:o,index:a,data:i},failedResult:l})},s.onmessage=l=>{var d,p;if(((d=l.data)==null?void 0:d.ok)===!1){this.terminateWorker(s),u({index:a,workerConfigs:{workerFunc:e,createWorker:r,workerName:o,index:a,data:i},failedResult:new ErrorEvent("error",{message:l.data.error})});return}c({index:a,workerConfigs:{workerFunc:e,createWorker:r,workerName:o,index:a,data:i},successResult:new MessageEvent("message",{data:(p=l.data)==null?void 0:p.data})}),this.terminateWorker(s)};const f={index:a,...Array.isArray(i)?{data:i}:i};s.postMessage(f,k(f))})}async collectResults(e,r={}){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");const o=e.results.filter(t=>t.status==="fulfilled"),a=e.results.filter(t=>t.status==="rejected"),i=o.map(t=>t.value.successResult.data),c=r.reducer?r.reducer.toString():"(shards) => shards.flat()";return{data:await new Promise((t,s)=>{const f=`
+`;var P=(n=>(n.Default="default",n.Pipeline="pipeline",n.Persistent="persistent",n))(P||{});const C=Object.freeze({persistent:R,pipeline:F,default:O});class v{constructor(e,r){y(this,"_worker");if(r!=null&&r.createWorker)this._worker=r.createWorker();else if(e){const s=(r==null?void 0:r.mode)??"default",t=C[s](e.toString()),l=new Blob([t],{type:"application/javascript"});this._worker=new Worker(URL.createObjectURL(l))}else throw new Error("Either workerFunction or options.createWorker must be provided to WorkerFactory.")}get getWorker(){return this._worker}}class j{constructor(e){this.results=e}}function m(n,e=new Set){return n===null||typeof n!="object"?[]:e.has(n)?[]:(e.add(n),n instanceof ArrayBuffer||n instanceof MessagePort||typeof ImageBitmap<"u"&&n instanceof ImageBitmap||typeof OffscreenCanvas<"u"&&n instanceof OffscreenCanvas?[n]:ArrayBuffer.isView(n)?[n.buffer]:Array.isArray(n)?n.flatMap(r=>m(r,e)):Object.values(n).flatMap(r=>m(r,e)))}class L{constructor(e){y(this,"_workers");y(this,"_threads");y(this,"_persistentWorkers",new Map);y(this,"_activeWorkers",new Set);y(this,"_isTerminated",!1);this._workers=e.workers,this._threads=navigator.hardwareConcurrency}get isTerminated(){return this._isTerminated}trackWorker(e){if(this._isTerminated)throw e.terminate(),new Error("MainWorkerFactory has been terminated");return this._activeWorkers.add(e),e}terminateWorker(e){this._activeWorkers.delete(e);try{e.terminate()}catch{}}initWorker(e){const r=new v(e.func,{createWorker:e.createWorker});return this.trackWorker(r.getWorker),r}partitionArray(e,r){if(!e.length)return[];if(r<=0)throw new Error("numChunks must be positive");const s=Math.min(r,e.length),t=Math.floor(e.length/s),l=e.length%s,c=[];let f=0;for(let a=0;a<s;a++){const o=t+(a<l?1:0);c.push(e.slice(f,f+o)),f+=o}return c}findWorkerByName(e){return this._workers.find(r=>r.name===e)}async runWorker(e,{srcData:r,...s}){if(this._isTerminated)return Promise.reject(new Error("MainWorkerFactory has been terminated"));const t=this.findWorkerByName(e);if(!t)return Promise.reject(new Error(`Worker "${e}" not found`));const l=t.maxConcurrency??this._threads,c=!!(Array.isArray(r)&&r.length>1&&t.partition),f=c?this.partitionArray(r,l):r,a=this.createWorkerPromises(t,e,{data:f,...s},l,c),o=await Promise.allSettled(a);return new j(o)}createWorkerPromises(e,r,s,t,l){const{data:c,...f}=s;return Array.from({length:t},(a,o)=>{const d=l&&Array.isArray(c)?c[o]:c;return this.runWorkerWithRetry({workerFunc:e.func,createWorker:e.createWorker,workerName:r,index:o,data:{data:d,...f}},e.retries)})}async runWorkerWithRetry(e,r=2){try{return await this.initiateWorker(e)}catch(s){if(r>0)return console.error(`Worker ${e.index} failed, retrying (${r} left):`,s),this.runWorkerWithRetry(e,r-1);throw console.error("Worker failed after all retries:",s),s}}initiateWorker({workerFunc:e,createWorker:r,workerName:s,index:t,data:l}){return new Promise((c,f)=>{const o=this.initWorker({name:s,role:"",func:e,createWorker:r}).getWorker;o.onerror=p=>{this.terminateWorker(o),f({index:t,workerConfigs:{workerFunc:e,createWorker:r,workerName:s,index:t,data:l},failedResult:p})},o.onmessage=p=>{var i,u;if(((i=p.data)==null?void 0:i.ok)===!1){this.terminateWorker(o),f({index:t,workerConfigs:{workerFunc:e,createWorker:r,workerName:s,index:t,data:l},failedResult:new ErrorEvent("error",{message:p.data.error})});return}c({index:t,workerConfigs:{workerFunc:e,createWorker:r,workerName:s,index:t,data:l},successResult:new MessageEvent("message",{data:(u=p.data)==null?void 0:u.data})}),this.terminateWorker(o)};const d={index:t,...Array.isArray(l)?{data:l}:l};o.postMessage(d,m(d))})}async collectResults(e,r={}){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");const s=e.results.filter(a=>a.status==="fulfilled"),t=e.results.filter(a=>a.status==="rejected"),l=s.map(a=>a.value.successResult.data),c=r.reducer?r.reducer.toString():"(shards) => shards.flat()";return{data:await new Promise((a,o)=>{const d=`
         const reducer = ${c};
         self.addEventListener('message', (event) => {
           try {
@@ -159,4 +167,4 @@ self.addEventListener('message', async (event) => {
             self.postMessage({ ok: false, error: String(err) });
           }
         });
-      `,l=new Blob([f],{type:"application/javascript"}),d=this.trackWorker(new Worker(URL.createObjectURL(l)));d.onmessage=p=>{this.terminateWorker(d),p.data.ok?t(p.data.data):s(new Error(p.data.error))},d.onerror=p=>{this.terminateWorker(d),s(p)},d.postMessage(i)}),succeeded:o.length,failed:a.length,errors:a}}async pipeline(e){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");if(e.length===0)throw new Error("Pipeline requires at least one step");if(e.length===1){const r=e[0],o=this.findWorkerByName(r.worker);if(!o)throw new Error(`Worker "${r.worker}" not found`);const i=this.initWorker(o).getWorker;return new Promise((c,u)=>{i.onmessage=s=>{var f,l;this.terminateWorker(i),((f=s.data)==null?void 0:f.ok)===!1?u(new Error(s.data.error)):c((l=s.data)==null?void 0:l.data)},i.onerror=s=>{this.terminateWorker(i),u(s)};const t=r.srcData??{};i.postMessage({data:t,index:0},k(t))})}return new Promise((r,o)=>{const a=[],i=[];for(const t of e){const s=this.findWorkerByName(t.worker);if(!s){o(new Error(`Worker "${t.worker}" not found`));return}const f=new g(s.func,{mode:m.Pipeline,createWorker:s.createWorker}),l=this.trackWorker(f.getWorker);a.push(l)}for(let t=0;t<a.length-1;t++)i.push(new MessageChannel);for(let t=0;t<a.length;t++){const s=[],f={};t>0&&(f.inputPort=i[t-1].port1,s.push(f.inputPort)),t<a.length-1&&(f.outputPort=i[t].port2,s.push(f.outputPort)),a[t].postMessage({__pipeline_ports__:!0,...f},s)}const c=a[a.length-1];c.onmessage=t=>{var s,f;a.forEach(l=>this.terminateWorker(l)),((s=t.data)==null?void 0:s.ok)===!1?o(new Error(t.data.error)):r((f=t.data)==null?void 0:f.data)},c.onerror=t=>{a.forEach(s=>this.terminateWorker(s)),o(t)};const u=e[0].srcData??{};a[0].postMessage({data:u,index:0},k(u))})}async runPersistent(e,r){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");const o=this.findWorkerByName(e);if(!o)throw new Error(`Worker "${e}" not found`);let a=this._persistentWorkers.get(e);if(!a){const i=new g(o.func,{mode:m.Persistent,createWorker:o.createWorker});a=this.trackWorker(i.getWorker),this._persistentWorkers.set(e,a)}return new Promise((i,c)=>{a.onmessage=t=>{var s,f;((s=t.data)==null?void 0:s.ok)===!1?c(new Error(t.data.error)):i((f=t.data)==null?void 0:f.data)},a.onerror=t=>{c(t)};const u={type:"run",config:r.config};r.dataset!==void 0&&(u.dataset=r.dataset),a.postMessage(u,k(u))})}release(e){const r=this._persistentWorkers.get(e);if(r){try{r.postMessage({type:"release"})}catch{}this.terminateWorker(r),this._persistentWorkers.delete(e)}}terminate(){this._isTerminated=!0;for(const e of this._persistentWorkers.values()){try{e.postMessage({type:"release"})}catch{}this.terminateWorker(e)}this._persistentWorkers.clear();for(const e of Array.from(this._activeWorkers))this.terminateWorker(e);this._activeWorkers.clear()}destroy(){this.terminate()}reset(){this.terminate(),this._isTerminated=!1}restart(){this.reset()}}exports.MainWorkerFactory=_;exports.WorkerFactory=g;
+      `,p=new Blob([d],{type:"application/javascript"}),i=this.trackWorker(new Worker(URL.createObjectURL(p)));i.onmessage=u=>{this.terminateWorker(i),u.data.ok?a(u.data.data):o(new Error(u.data.error))},i.onerror=u=>{this.terminateWorker(i),o(u)},i.postMessage(l)}),succeeded:s.length,failed:t.length,errors:t}}async pipeline(e){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");if(e.length===0)throw new Error("Pipeline requires at least one step");if(e.length===1){const r=e[0],{worker:s,srcData:t,...l}=r,c=this.findWorkerByName(r.worker);if(!c)throw new Error(`Worker "${r.worker}" not found`);const a=this.initWorker(c).getWorker;return new Promise((o,d)=>{a.onmessage=u=>{var k,g;this.terminateWorker(a),((k=u.data)==null?void 0:k.ok)===!1?d(new Error(u.data.error)):o((g=u.data)==null?void 0:g.data)},a.onerror=u=>{this.terminateWorker(a),d(u)};const i={data:t??{},...l,index:0};a.postMessage(i,m(i))})}return new Promise((r,s)=>{const t=[],l=[];for(const i of e){const u=this.findWorkerByName(i.worker);if(!u){s(new Error(`Worker "${i.worker}" not found`));return}const k=new v(u.func,{mode:P.Pipeline,createWorker:u.createWorker}),g=this.trackWorker(k.getWorker);t.push(g)}for(let i=0;i<t.length-1;i++)l.push(new MessageChannel);for(let i=0;i<t.length;i++){const{worker:u,srcData:k,...g}=e[i],W=[],w={};if(i>0&&(w.inputPort=l[i-1].port1,W.push(w.inputPort)),i<t.length-1&&(w.outputPort=l[i].port2,W.push(w.outputPort)),t[i].postMessage({__pipeline_ports__:!0,stepParams:g,...w},W),i<t.length-1){const _=t[i],A=t[i+1],{worker:I,srcData:U,...D}=e[i+1];_.onmessage=h=>{var E,T;if(h.data&&h.data.__pipeline_ports__)return;if(((E=h.data)==null?void 0:E.ok)===!1){t.forEach(B=>this.terminateWorker(B)),s(new Error(h.data.error));return}const b={data:((T=h.data)==null?void 0:T.ok)!==void 0?h.data.data:h.data,...D,index:0};A.postMessage(b,m(b))},_.onerror=h=>{t.forEach(M=>this.terminateWorker(M)),s(h)}}}const c=t[t.length-1];c.onmessage=i=>{var u,k;t.forEach(g=>this.terminateWorker(g)),((u=i.data)==null?void 0:u.ok)===!1?s(new Error(i.data.error)):r((k=i.data)==null?void 0:k.data)},c.onerror=i=>{t.forEach(u=>this.terminateWorker(u)),s(i)};const{worker:f,srcData:a,...o}=e[0],p={data:a??{},...o,index:0};t[0].postMessage(p,m(p))})}async runPersistent(e,r){if(this._isTerminated)throw new Error("MainWorkerFactory has been terminated");const s=this.findWorkerByName(e);if(!s)throw new Error(`Worker "${e}" not found`);let t=this._persistentWorkers.get(e);if(!t){const l=new v(s.func,{mode:P.Persistent,createWorker:s.createWorker});t=this.trackWorker(l.getWorker),this._persistentWorkers.set(e,t)}return new Promise((l,c)=>{t.onmessage=a=>{var o,d;((o=a.data)==null?void 0:o.ok)===!1?c(new Error(a.data.error)):l((d=a.data)==null?void 0:d.data)},t.onerror=a=>{c(a)};const f={type:"run",config:r.config};r.dataset!==void 0&&(f.dataset=r.dataset),t.postMessage(f,m(f))})}release(e){const r=this._persistentWorkers.get(e);if(r){try{r.postMessage({type:"release"})}catch{}this.terminateWorker(r),this._persistentWorkers.delete(e)}}terminate(){this._isTerminated=!0;for(const e of this._persistentWorkers.values()){try{e.postMessage({type:"release"})}catch{}this.terminateWorker(e)}this._persistentWorkers.clear();for(const e of Array.from(this._activeWorkers))this.terminateWorker(e);this._activeWorkers.clear()}destroy(){this.terminate()}reset(){this.terminate(),this._isTerminated=!1}restart(){this.reset()}}function $(n){if(typeof self>"u")return;let e=null,r=null,s=null,t={};const l=(f,a)=>{self.postMessage(f,a)};async function c(f){try{const a=typeof f=="object"&&f!==null&&"data"in f?{...t,...f}:{data:f,...t,index:0},o=await n(a),d={ok:!0,data:o},p=m(o);e?e.postMessage(d,p):l(d,p)}catch(a){const o={ok:!1,error:a instanceof Error?a.message:String(a)};e?e.postMessage(o):l(o)}}self.addEventListener("message",f=>{const a=f.data;if(a&&a.__pipeline_ports__){a.stepParams&&(t=a.stepParams),a.outputPort&&(e=a.outputPort),a.inputPort&&(r=a.inputPort,r.onmessage=o=>{var d;o.data&&o.data.ok===!1?e?e.postMessage(o.data):l(o.data):c({data:(d=o.data)==null?void 0:d.data,...t,index:0})}),s!==null&&(c(s),s=null);return}r?s=a:c(a)})}exports.MainWorkerFactory=L;exports.WorkerFactory=v;exports.defineWorker=$;

package/dist/index.js

@@ -1,7 +1,7 @@
-var w = Object.defineProperty;
-var v = (n, e, r) => e in n ? w(n, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : n[e] = r;
-var h = (n, e, r) => v(n, typeof e != "symbol" ? e + "" : e, r);
-const y = (n) => `
+var S = Object.defineProperty;
+var x = (n, e, r) => e in n ? S(n, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : n[e] = r;
+var y = (n, e, r) => x(n, typeof e != "symbol" ? e + "" : e, r);
+const O = (n) => `
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -24,7 +24,7 @@ self.addEventListener('message', async (event) => {
     self.postMessage({ ok: false, error: err instanceof Error ? err.message : String(err) });
   }
 })
-`, W = (n) => `
+`, R = (n) => `
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -43,10 +43,15 @@ const workerFn = ${n};
 let outputPort = null;
 let inputPort = null;
 let pendingData = null;
+let stepParams = {};
 
 async function processData(data) {
   try {
-    const output = await workerFn(data);
+    const payload =
+      typeof data === 'object' && data !== null && 'data' in data
+        ? { ...stepParams, ...data }
+        : { data, ...stepParams, index: 0 };
+    const output = await workerFn(payload);
     const result = { ok: true, data: output };
     const transfers = extractTransferables(output);
     if (outputPort) {
@@ -66,6 +71,9 @@ async function processData(data) {
 
 self.addEventListener('message', (event) => {
   if (event.data && event.data.__pipeline_ports__) {
+    if (event.data.stepParams) {
+      stepParams = event.data.stepParams;
+    }
     if (event.data.outputPort) {
       outputPort = event.data.outputPort;
     }
@@ -77,7 +85,7 @@ self.addEventListener('message', (event) => {
           if (outputPort) outputPort.postMessage(e.data);
           else self.postMessage(e.data);
         } else {
-          processData({ data: e.data.data, index: 0 });
+          processData({ data: e.data.data, ...stepParams, index: 0 });
         }
       };
     }
@@ -96,7 +104,7 @@ self.addEventListener('message', (event) => {
     pendingData = event.data;
   }
 });
-`, M = (n) => `
+`, F = (n) => `
 const extractTransferables = (value, seen = new Set()) => {
   if (value === null || typeof value !== 'object') return [];
   if (seen.has(value)) return [];
@@ -153,13 +161,13 @@ self.addEventListener('message', async (event) => {
   }
 });
 `;
-var m = /* @__PURE__ */ ((n) => (n.Default = "default", n.Pipeline = "pipeline", n.Persistent = "persistent", n))(m || {});
-const P = Object.freeze({
-  persistent: M,
-  pipeline: W,
-  default: y
+var P = /* @__PURE__ */ ((n) => (n.Default = "default", n.Pipeline = "pipeline", n.Persistent = "persistent", n))(P || {});
+const C = Object.freeze({
+  persistent: F,
+  pipeline: R,
+  default: O
 });
-class g {
+class W {
   /**
    * Creates a new `Worker` from the given function or factory option.
    *
@@ -169,14 +177,14 @@ class g {
    * @param options - Optional configuration containing `createWorker` or `mode`.
    */
   constructor(e, r) {
-    h(this, "_worker");
+    y(this, "_worker");
     if (r != null && r.createWorker)
       this._worker = r.createWorker();
     else if (e) {
-      const o = (r == null ? void 0 : r.mode) ?? "default", a = P[o](e.toString()), i = new Blob([a], {
+      const s = (r == null ? void 0 : r.mode) ?? "default", t = C[s](e.toString()), l = new Blob([t], {
         type: "application/javascript"
       });
-      this._worker = new Worker(URL.createObjectURL(i));
+      this._worker = new Worker(URL.createObjectURL(l));
     } else
       throw new Error(
         "Either workerFunction or options.createWorker must be provided to WorkerFactory."
@@ -192,28 +200,28 @@ class g {
     return this._worker;
   }
 }
-class b {
+class L {
   constructor(e) {
     this.results = e;
   }
 }
-function k(n, e = /* @__PURE__ */ new Set()) {
-  return n === null || typeof n != "object" ? [] : e.has(n) ? [] : (e.add(n), n instanceof ArrayBuffer || n instanceof MessagePort || typeof ImageBitmap < "u" && n instanceof ImageBitmap || typeof OffscreenCanvas < "u" && n instanceof OffscreenCanvas ? [n] : ArrayBuffer.isView(n) ? [n.buffer] : Array.isArray(n) ? n.flatMap((r) => k(r, e)) : Object.values(n).flatMap(
-    (r) => k(r, e)
+function m(n, e = /* @__PURE__ */ new Set()) {
+  return n === null || typeof n != "object" ? [] : e.has(n) ? [] : (e.add(n), n instanceof ArrayBuffer || n instanceof MessagePort || typeof ImageBitmap < "u" && n instanceof ImageBitmap || typeof OffscreenCanvas < "u" && n instanceof OffscreenCanvas ? [n] : ArrayBuffer.isView(n) ? [n.buffer] : Array.isArray(n) ? n.flatMap((r) => m(r, e)) : Object.values(n).flatMap(
+    (r) => m(r, e)
   ));
 }
-class E {
+class U {
   /**
    * Creates a new `MainWorkerFactory`.
    *
    * @param options - Configuration object containing the `workers` registry.
    */
   constructor(e) {
-    h(this, "_workers");
-    h(this, "_threads");
-    h(this, "_persistentWorkers", /* @__PURE__ */ new Map());
-    h(this, "_activeWorkers", /* @__PURE__ */ new Set());
-    h(this, "_isTerminated", !1);
+    y(this, "_workers");
+    y(this, "_threads");
+    y(this, "_persistentWorkers", /* @__PURE__ */ new Map());
+    y(this, "_activeWorkers", /* @__PURE__ */ new Set());
+    y(this, "_isTerminated", !1);
     this._workers = e.workers, this._threads = navigator.hardwareConcurrency;
   }
   /**
@@ -247,7 +255,7 @@ class E {
    * @returns A new `WorkerFactory` wrapping the worker.
    */
   initWorker(e) {
-    const r = new g(e.func, {
+    const r = new W(e.func, {
       createWorker: e.createWorker
     });
     return this.trackWorker(r.getWorker), r;
@@ -271,11 +279,11 @@ class E {
   partitionArray(e, r) {
     if (!e.length) return [];
     if (r <= 0) throw new Error("numChunks must be positive");
-    const o = Math.min(r, e.length), a = Math.floor(e.length / o), i = e.length % o, c = [];
-    let u = 0;
-    for (let t = 0; t < o; t++) {
-      const s = a + (t < i ? 1 : 0);
-      c.push(e.slice(u, u + s)), u += s;
+    const s = Math.min(r, e.length), t = Math.floor(e.length / s), l = e.length % s, c = [];
+    let f = 0;
+    for (let a = 0; a < s; a++) {
+      const o = t + (a < l ? 1 : 0);
+      c.push(e.slice(f, f + o)), f += o;
     }
     return c;
   }
@@ -316,21 +324,21 @@ class E {
    */
   async runWorker(e, {
     srcData: r,
-    ...o
+    ...s
   }) {
     if (this._isTerminated)
       return Promise.reject(new Error("MainWorkerFactory has been terminated"));
-    const a = this.findWorkerByName(e);
-    if (!a)
+    const t = this.findWorkerByName(e);
+    if (!t)
       return Promise.reject(new Error(`Worker "${e}" not found`));
-    const i = a.maxConcurrency ?? this._threads, c = !!(Array.isArray(r) && r.length > 1 && a.partition), u = c ? this.partitionArray(r, i) : r, t = this.createWorkerPromises(
-      a,
+    const l = t.maxConcurrency ?? this._threads, c = !!(Array.isArray(r) && r.length > 1 && t.partition), f = c ? this.partitionArray(r, l) : r, a = this.createWorkerPromises(
+      t,
       e,
-      { data: u, ...o },
-      i,
+      { data: f, ...s },
+      l,
       c
-    ), s = await Promise.allSettled(t);
-    return new b(s);
+    ), o = await Promise.allSettled(a);
+    return new L(o);
   }
   /**
    * Builds the array of per-thread worker promises for a single `runWorker`
@@ -346,17 +354,17 @@ class E {
    * @param isPartitioned  - Whether `data` is a pre-split array of shards.
    * @returns An array of promises, one per thread.
    */
-  createWorkerPromises(e, r, o, a, i) {
-    const { data: c, ...u } = o;
-    return Array.from({ length: a }, (t, s) => {
-      const f = i && Array.isArray(c) ? c[s] : c;
+  createWorkerPromises(e, r, s, t, l) {
+    const { data: c, ...f } = s;
+    return Array.from({ length: t }, (a, o) => {
+      const d = l && Array.isArray(c) ? c[o] : c;
       return this.runWorkerWithRetry(
         {
           workerFunc: e.func,
           createWorker: e.createWorker,
           workerName: r,
-          index: s,
-          data: { data: f, ...u }
+          index: o,
+          data: { data: d, ...f }
         },
         e.retries
       );
@@ -377,13 +385,13 @@ class E {
   async runWorkerWithRetry(e, r = 2) {
     try {
       return await this.initiateWorker(e);
-    } catch (o) {
+    } catch (s) {
       if (r > 0)
         return console.error(
           `Worker ${e.index} failed, retrying (${r} left):`,
-          o
+          s
         ), this.runWorkerWithRetry(e, r - 1);
-      throw console.error("Worker failed after all retries:", o), o;
+      throw console.error("Worker failed after all retries:", s), s;
     }
   }
   /**
@@ -406,66 +414,66 @@ class E {
   initiateWorker({
     workerFunc: e,
     createWorker: r,
-    workerName: o,
-    index: a,
-    data: i
+    workerName: s,
+    index: t,
+    data: l
   }) {
-    return new Promise((c, u) => {
-      const s = this.initWorker({
-        name: o,
+    return new Promise((c, f) => {
+      const o = this.initWorker({
+        name: s,
         role: "",
         func: e,
         createWorker: r
       }).getWorker;
-      s.onerror = (l) => {
-        this.terminateWorker(s), u({
-          index: a,
+      o.onerror = (p) => {
+        this.terminateWorker(o), f({
+          index: t,
           workerConfigs: {
             workerFunc: e,
             createWorker: r,
-            workerName: o,
-            index: a,
-            data: i
+            workerName: s,
+            index: t,
+            data: l
           },
-          failedResult: l
+          failedResult: p
         });
-      }, s.onmessage = (l) => {
-        var d, p;
-        if (((d = l.data) == null ? void 0 : d.ok) === !1) {
-          this.terminateWorker(s), u({
-            index: a,
+      }, o.onmessage = (p) => {
+        var i, u;
+        if (((i = p.data) == null ? void 0 : i.ok) === !1) {
+          this.terminateWorker(o), f({
+            index: t,
             workerConfigs: {
               workerFunc: e,
               createWorker: r,
-              workerName: o,
-              index: a,
-              data: i
+              workerName: s,
+              index: t,
+              data: l
             },
             failedResult: new ErrorEvent("error", {
-              message: l.data.error
+              message: p.data.error
             })
           });
           return;
         }
         c({
-          index: a,
+          index: t,
           workerConfigs: {
             workerFunc: e,
             createWorker: r,
-            workerName: o,
-            index: a,
-            data: i
+            workerName: s,
+            index: t,
+            data: l
           },
           successResult: new MessageEvent("message", {
-            data: (p = l.data) == null ? void 0 : p.data
+            data: (u = p.data) == null ? void 0 : u.data
           })
-        }), this.terminateWorker(s);
+        }), this.terminateWorker(o);
       };
-      const f = {
-        index: a,
-        ...Array.isArray(i) ? { data: i } : i
+      const d = {
+        index: t,
+        ...Array.isArray(l) ? { data: l } : l
       };
-      s.postMessage(f, k(f));
+      o.postMessage(d, m(d));
     });
   }
   /**
@@ -503,14 +511,14 @@ class E {
   async collectResults(e, r = {}) {
     if (this._isTerminated)
       throw new Error("MainWorkerFactory has been terminated");
-    const o = e.results.filter(
-      (t) => t.status === "fulfilled"
-    ), a = e.results.filter(
-      (t) => t.status === "rejected"
-    ), i = o.map((t) => t.value.successResult.data), c = r.reducer ? r.reducer.toString() : "(shards) => shards.flat()";
+    const s = e.results.filter(
+      (a) => a.status === "fulfilled"
+    ), t = e.results.filter(
+      (a) => a.status === "rejected"
+    ), l = s.map((a) => a.value.successResult.data), c = r.reducer ? r.reducer.toString() : "(shards) => shards.flat()";
     return {
-      data: await new Promise((t, s) => {
-        const f = `
+      data: await new Promise((a, o) => {
+        const d = `
         const reducer = ${c};
         self.addEventListener('message', (event) => {
           try {
@@ -520,16 +528,16 @@ class E {
             self.postMessage({ ok: false, error: String(err) });
           }
         });
-      `, l = new Blob([f], { type: "application/javascript" }), d = this.trackWorker(new Worker(URL.createObjectURL(l)));
-        d.onmessage = (p) => {
-          this.terminateWorker(d), p.data.ok ? t(p.data.data) : s(new Error(p.data.error));
-        }, d.onerror = (p) => {
-          this.terminateWorker(d), s(p);
-        }, d.postMessage(i);
+      `, p = new Blob([d], { type: "application/javascript" }), i = this.trackWorker(new Worker(URL.createObjectURL(p)));
+        i.onmessage = (u) => {
+          this.terminateWorker(i), u.data.ok ? a(u.data.data) : o(new Error(u.data.error));
+        }, i.onerror = (u) => {
+          this.terminateWorker(i), o(u);
+        }, i.postMessage(l);
       }),
-      succeeded: o.length,
-      failed: a.length,
-      errors: a
+      succeeded: s.length,
+      failed: t.length,
+      errors: t
     };
   }
   /**
@@ -564,58 +572,66 @@ class E {
     if (e.length === 0)
       throw new Error("Pipeline requires at least one step");
     if (e.length === 1) {
-      const r = e[0], o = this.findWorkerByName(r.worker);
-      if (!o) throw new Error(`Worker "${r.worker}" not found`);
-      const i = this.initWorker(o).getWorker;
-      return new Promise((c, u) => {
-        i.onmessage = (s) => {
-          var f, l;
-          this.terminateWorker(i), ((f = s.data) == null ? void 0 : f.ok) === !1 ? u(new Error(s.data.error)) : c((l = s.data) == null ? void 0 : l.data);
-        }, i.onerror = (s) => {
-          this.terminateWorker(i), u(s);
+      const r = e[0], { worker: s, srcData: t, ...l } = r, c = this.findWorkerByName(r.worker);
+      if (!c) throw new Error(`Worker "${r.worker}" not found`);
+      const a = this.initWorker(c).getWorker;
+      return new Promise((o, d) => {
+        a.onmessage = (u) => {
+          var k, g;
+          this.terminateWorker(a), ((k = u.data) == null ? void 0 : k.ok) === !1 ? d(new Error(u.data.error)) : o((g = u.data) == null ? void 0 : g.data);
+        }, a.onerror = (u) => {
+          this.terminateWorker(a), d(u);
         };
-        const t = r.srcData ?? {};
-        i.postMessage(
-          { data: t, index: 0 },
-          k(t)
-        );
+        const i = { data: t ?? {}, ...l, index: 0 };
+        a.postMessage(i, m(i));
       });
     }
-    return new Promise((r, o) => {
-      const a = [], i = [];
-      for (const t of e) {
-        const s = this.findWorkerByName(t.worker);
-        if (!s) {
-          o(new Error(`Worker "${t.worker}" not found`));
+    return new Promise((r, s) => {
+      const t = [], l = [];
+      for (const i of e) {
+        const u = this.findWorkerByName(i.worker);
+        if (!u) {
+          s(new Error(`Worker "${i.worker}" not found`));
           return;
         }
-        const f = new g(s.func, {
-          mode: m.Pipeline,
-          createWorker: s.createWorker
-        }), l = this.trackWorker(f.getWorker);
-        a.push(l);
+        const k = new W(u.func, {
+          mode: P.Pipeline,
+          createWorker: u.createWorker
+        }), g = this.trackWorker(k.getWorker);
+        t.push(g);
       }
-      for (let t = 0; t < a.length - 1; t++)
-        i.push(new MessageChannel());
-      for (let t = 0; t < a.length; t++) {
-        const s = [], f = {};
-        t > 0 && (f.inputPort = i[t - 1].port1, s.push(f.inputPort)), t < a.length - 1 && (f.outputPort = i[t].port2, s.push(f.outputPort)), a[t].postMessage(
-          { __pipeline_ports__: !0, ...f },
-          s
-        );
+      for (let i = 0; i < t.length - 1; i++)
+        l.push(new MessageChannel());
+      for (let i = 0; i < t.length; i++) {
+        const { worker: u, srcData: k, ...g } = e[i], v = [], w = {};
+        if (i > 0 && (w.inputPort = l[i - 1].port1, v.push(w.inputPort)), i < t.length - 1 && (w.outputPort = l[i].port2, v.push(w.outputPort)), t[i].postMessage(
+          { __pipeline_ports__: !0, stepParams: g, ...w },
+          v
+        ), i < t.length - 1) {
+          const _ = t[i], A = t[i + 1], { worker: j, srcData: $, ...D } = e[i + 1];
+          _.onmessage = (h) => {
+            var E, T;
+            if (h.data && h.data.__pipeline_ports__) return;
+            if (((E = h.data) == null ? void 0 : E.ok) === !1) {
+              t.forEach((B) => this.terminateWorker(B)), s(new Error(h.data.error));
+              return;
+            }
+            const b = { data: ((T = h.data) == null ? void 0 : T.ok) !== void 0 ? h.data.data : h.data, ...D, index: 0 };
+            A.postMessage(b, m(b));
+          }, _.onerror = (h) => {
+            t.forEach((M) => this.terminateWorker(M)), s(h);
+          };
+        }
       }
-      const c = a[a.length - 1];
-      c.onmessage = (t) => {
-        var s, f;
-        a.forEach((l) => this.terminateWorker(l)), ((s = t.data) == null ? void 0 : s.ok) === !1 ? o(new Error(t.data.error)) : r((f = t.data) == null ? void 0 : f.data);
-      }, c.onerror = (t) => {
-        a.forEach((s) => this.terminateWorker(s)), o(t);
+      const c = t[t.length - 1];
+      c.onmessage = (i) => {
+        var u, k;
+        t.forEach((g) => this.terminateWorker(g)), ((u = i.data) == null ? void 0 : u.ok) === !1 ? s(new Error(i.data.error)) : r((k = i.data) == null ? void 0 : k.data);
+      }, c.onerror = (i) => {
+        t.forEach((u) => this.terminateWorker(u)), s(i);
       };
-      const u = e[0].srcData ?? {};
-      a[0].postMessage(
-        { data: u, index: 0 },
-        k(u)
-      );
+      const { worker: f, srcData: a, ...o } = e[0], p = { data: a ?? {}, ...o, index: 0 };
+      t[0].postMessage(p, m(p));
     });
   }
   /**
@@ -655,28 +671,28 @@ class E {
   async runPersistent(e, r) {
     if (this._isTerminated)
       throw new Error("MainWorkerFactory has been terminated");
-    const o = this.findWorkerByName(e);
-    if (!o) throw new Error(`Worker "${e}" not found`);
-    let a = this._persistentWorkers.get(e);
-    if (!a) {
-      const i = new g(o.func, {
-        mode: m.Persistent,
-        createWorker: o.createWorker
+    const s = this.findWorkerByName(e);
+    if (!s) throw new Error(`Worker "${e}" not found`);
+    let t = this._persistentWorkers.get(e);
+    if (!t) {
+      const l = new W(s.func, {
+        mode: P.Persistent,
+        createWorker: s.createWorker
       });
-      a = this.trackWorker(i.getWorker), this._persistentWorkers.set(e, a);
+      t = this.trackWorker(l.getWorker), this._persistentWorkers.set(e, t);
     }
-    return new Promise((i, c) => {
-      a.onmessage = (t) => {
-        var s, f;
-        ((s = t.data) == null ? void 0 : s.ok) === !1 ? c(new Error(t.data.error)) : i((f = t.data) == null ? void 0 : f.data);
-      }, a.onerror = (t) => {
-        c(t);
+    return new Promise((l, c) => {
+      t.onmessage = (a) => {
+        var o, d;
+        ((o = a.data) == null ? void 0 : o.ok) === !1 ? c(new Error(a.data.error)) : l((d = a.data) == null ? void 0 : d.data);
+      }, t.onerror = (a) => {
+        c(a);
       };
-      const u = {
+      const f = {
         type: "run",
         config: r.config
       };
-      r.dataset !== void 0 && (u.dataset = r.dataset), a.postMessage(u, k(u));
+      r.dataset !== void 0 && (f.dataset = r.dataset), t.postMessage(f, m(f));
     });
   }
   /**
@@ -738,7 +754,38 @@ class E {
     this.reset();
   }
 }
+function V(n) {
+  if (typeof self > "u") return;
+  let e = null, r = null, s = null, t = {};
+  const l = (f, a) => {
+    self.postMessage(f, a);
+  };
+  async function c(f) {
+    try {
+      const a = typeof f == "object" && f !== null && "data" in f ? { ...t, ...f } : { data: f, ...t, index: 0 }, o = await n(a), d = { ok: !0, data: o }, p = m(o);
+      e ? e.postMessage(d, p) : l(d, p);
+    } catch (a) {
+      const o = {
+        ok: !1,
+        error: a instanceof Error ? a.message : String(a)
+      };
+      e ? e.postMessage(o) : l(o);
+    }
+  }
+  self.addEventListener("message", (f) => {
+    const a = f.data;
+    if (a && a.__pipeline_ports__) {
+      a.stepParams && (t = a.stepParams), a.outputPort && (e = a.outputPort), a.inputPort && (r = a.inputPort, r.onmessage = (o) => {
+        var d;
+        o.data && o.data.ok === !1 ? e ? e.postMessage(o.data) : l(o.data) : c({ data: (d = o.data) == null ? void 0 : d.data, ...t, index: 0 });
+      }), s !== null && (c(s), s = null);
+      return;
+    }
+    r ? s = a : c(a);
+  });
+}
 export {
-  E as MainWorkerFactory,
-  g as WorkerFactory
+  U as MainWorkerFactory,
+  W as WorkerFactory,
+  V as defineWorker
 };

package/dist/types/tools/define-worker.d.ts

@@ -0,0 +1,21 @@
+import { WorkerFunction } from './main-worker-factory/types';
+/**
+ * Defines and exports a function to run inside a native Web Worker script,
+ * providing full compatibility with `MainWorkerFactory` features including
+ * standard runs, worker-to-worker pipelines (`foreman.pipeline()`), and
+ * dataset caching (`foreman.runPersistent()`).
+ *
+ * @typeParam TParams - The type of the payload sent to the worker.
+ * @typeParam TResult - The return type of the worker function.
+ *
+ * @param workerFn - The worker execution function.
+ *
+ * @example
+ * // my-native-worker.ts
+ * import { defineWorker } from '@offmain/workerkit';
+ *
+ * export default defineWorker(async ({ data }: { data: number[] }) => {
+ *   return data.map((x) => x * 2);
+ * });
+ */
+export declare function defineWorker<TParams = unknown, TResult = unknown>(workerFn: WorkerFunction<TParams, TResult | Promise<TResult>>): void;

package/dist/types/tools/define-worker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tools/index.d.ts

@@ -1,2 +1,3 @@
 export * from './worker-factory';
 export * from './main-worker-factory';
+export * from './define-worker';

package/dist/types/tools/main-worker-factory/types.d.ts

@@ -168,4 +168,6 @@ export interface PipelineStep {
     worker: string;
     /** Input data for the first step (subsequent steps receive previous output) */
     srcData?: unknown;
+    /** Any additional step parameters, configs, or options forwarded to the worker payload. */
+    [key: string]: unknown;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@offmain/workerkit",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "A lightweight manager for running functions in Web Workers with partitioning, retries, and concurrency control",
   "type": "module",
   "main": "./dist/index.cjs",