@oasys/oecs 0.5.4 → 0.6.0

package/dist/plugins/workers/worker_loop.d.cts

@@ -0,0 +1,14 @@
+import { HostMessage, WorkerReply, WorkerStart } from './protocol.cjs';
+/** What a runtime adapter drives. `onMessage` takes one host message, and
+ * `start` is called once the worker is ready to receive them. */
+export interface WorkerRuntime {
+    onMessage(message: HostMessage): void;
+}
+/**
+ * Build the worker body. `post` sends one reply to the host, and the adapter
+ * owns how that happens.
+ *
+ * Hot path once the barrier loop starts. Everything before it is setup.
+ */
+export declare function createWorkerRuntime(start: WorkerStart, post: (reply: WorkerReply) => void): WorkerRuntime;
+//# sourceMappingURL=worker_loop.d.ts.map

package/dist/plugins/workers/worker_loop.d.ts

@@ -0,0 +1,14 @@
+import { HostMessage, WorkerReply, WorkerStart } from './protocol.js';
+/** What a runtime adapter drives. `onMessage` takes one host message, and
+ * `start` is called once the worker is ready to receive them. */
+export interface WorkerRuntime {
+    onMessage(message: HostMessage): void;
+}
+/**
+ * Build the worker body. `post` sends one reply to the host, and the adapter
+ * owns how that happens.
+ *
+ * Hot path once the barrier loop starts. Everything before it is setup.
+ */
+export declare function createWorkerRuntime(start: WorkerStart, post: (reply: WorkerReply) => void): WorkerRuntime;
+//# sourceMappingURL=worker_loop.d.ts.map

package/dist/plugins/workers/worker_loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker_loop.d.ts","sourceRoot":"","sources":["../../../src/plugins/workers/worker_loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6BK;AAEL,OAAO,EAaN,KAAK,WAAW,EAEhB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,MAAM,eAAe,CAAC;AA+HvB;iEACiE;AACjE,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAChC,aAAa,CAkMf"}

package/dist/plugins/workers.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./abi-D3V-QUSf.cjs"),a=require("../index.cjs");var p=typeof document<"u"?document.currentScript:null;async function b(){const o=globalThis.process,e=o?.getBuiltinModule;return typeof e=="function"?e.call(o,"node:worker_threads"):await import(["node","worker_threads"].join(":"))}const w=0,E=1,R=2,g=3,C=4,A=C+f.COMPONENT_MASK_WORDS,O=A+f.COMPONENT_MASK_WORDS,v=O+1,L=v+1>>1,D=(L+1)*8,P=-1,W=-2,y=16,S=65536,N=3e4;function $(o){if(o===void 0)return 0;if(!Number.isInteger(o)||o<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be an integer >= 1, got ${String(o)}`);if(o%y!==0)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be a multiple of ${y}, the frame alignment of a wasm shadow stack, got ${o}`);if(o<S)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be at least ${S}, one WASM page, got ${o}`);return o}function K(){try{const o=new Int32Array(new SharedArrayBuffer(4));return Atomics.wait(o,0,1,0),!0}catch{return!1}}function U(){const o=globalThis.process;return typeof o=="object"&&o!==null&&typeof o.versions?.node=="string"}function B(){const o=globalThis.navigator?.hardwareConcurrency;return typeof o!="number"||!Number.isFinite(o)?1:Math.max(1,Math.floor(o)-1)}function j(){const o=new URL(typeof document>"u"?require("url").pathToFileURL(__filename).href:p&&p.tagName.toUpperCase()==="SCRIPT"&&p.src||new URL("plugins/workers.cjs",document.baseURI).href),e=o.pathname,t=e.lastIndexOf("/"),n=e.slice(t+1),s=n.indexOf("."),r=e.slice(0,t),i=r.slice(0,r.lastIndexOf("/")+1);return o.pathname=`${i}worker${s<0?"":n.slice(s)}`,o}class T{_waiting=new Map;_arrived=new Map;_failure=null;deliver(e){const t=e.slot===void 0?e.type:`${e.type}:${e.slot}`,n=this._waiting.get(t);if(n!==void 0&&n.length>0){n.shift()(e);return}const s=this._arrived.get(t);s===void 0?this._arrived.set(t,[e]):s.push(e)}fail(e){this._failure=e;for(const t of this._waiting.values())for(;t.length>0;)t.shift()({type:"kernel",error:e});this._waiting.clear()}expect(e,t){if(this._failure!==null)return Promise.resolve({type:e,slot:t,error:this._failure});const n=t===void 0?e:`${e}:${t}`,s=this._arrived.get(n);return s!==void 0&&s.length>0?Promise.resolve(s.shift()):new Promise(r=>{const i=this._waiting.get(n);i===void 0?this._waiting.set(n,[r]):i.push(r)})}}async function q(o,e){const t=await b();return e.map(n=>{const s=new t.Worker(o,{workerData:n}),r=new T;return s.on("message",i=>r.deliver(i)),s.on("error",i=>r.fail(i.message)),{post:i=>s.postMessage(i),expect:(i,l)=>r.expect(i,l),terminate:()=>s.terminate()}})}function F(o,e){return e.map(t=>{const n=new Worker(o,{type:"module"}),s=new T;return n.addEventListener("message",r=>s.deliver(r.data)),n.addEventListener("error",r=>{const i=r.message;s.fail(typeof i=="string"&&i!==""?i:`the script at '${String(o)}' did not load`)}),n.postMessage(t),{post:r=>n.postMessage(r),expect:(r,i)=>s.expect(r,i),terminate:()=>(n.terminate(),Promise.resolve())}})}class m{_world;_workers;_ctl;_ctlF64;_joinTimeoutMs;_state="idle";_epoch=0;_nextSlot=0;_pending=[];_syncing=Promise.resolve();constructor(e,t,n,s){this._world=e,this._workers=t,this._ctl=new Int32Array(n),this._ctlF64=new Float64Array(n),this._joinTimeoutMs=s}get count(){return this._workers.length}static async attach(e,t){if(!K())throw new a.ECSError(a.ECS_ERROR.WORKERS_HOST_CANNOT_PARK,"workers.attach: this host refuses Atomics.wait, so it cannot park while the workers run. Host the world inside a worker and attach the pool from there.");const n=t?.count??B();if(!Number.isInteger(n)||n<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: count must be an integer >= 1, got ${String(n)}`);const s=t?.joinTimeoutMs??N;if(!Number.isInteger(s)||s<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: joinTimeoutMs must be an integer >= 1, got ${String(s)}`);const r=$(t?.stackBytes),i=new SharedArrayBuffer(D),l=[];for(let c=0;c<n;c++)l.push({store:e.store,storeBase:e.storeBase,control:i,index:c,count:n,stackBytes:r});const _=t?.workerUrl??j(),u=U()?await q(_,l):F(_,l),h=await Promise.all(u.map(c=>c.expect("ready")));for(let c=0;c<h.length;c++){const k=h[c].error;if(k!==void 0)throw await Promise.all(u.map(M=>M.terminate())),new a.ECSError(a.ECS_ERROR.WORKERS_ENTRY_UNREACHABLE,`workers.attach: worker ${c} did not start from '${String(_)}': ${k}. Pass workerUrl with the URL your bundler emits for the '@oasys/oecs/worker' entry.`)}const d=new m(e,u,i,s);for(const c of e.plans())d._pending.push(c);d._kick();try{await d.settled()}catch(c){throw await d.detach(),c}return d}register(e){this._state==="detached"||this._state==="failed"||(this._pending.push(e),this._kick())}_kick(){this._syncing=this._syncing.then(()=>this._sync())}settled(){return this._syncing}async _sync(){if(this._state==="detached"||this._state==="failed")return;const e=this._pending;this._pending=[],e.length>0&&this._state==="running"&&await this._park();for(const t of e){t.slot=this._nextSlot++;const n={type:"kernel",slot:t.slot,wasm:t.kernel.wasm,js:t.kernel.js,exportName:t.exportName,specs:t.specs},s=await Promise.all(this._workers.map(r=>(r.post(n),r.expect("kernel",t.slot))));for(let r=0;r<s.length;r++){const i=s[r].error;if(i!==void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`worker ${r} could not load the kernel export '${t.exportName}': ${String(i).replace(/\.$/,"")}. Check the module and the export name.`)}t.ready=!0}this._resume()}async _park(){this._state="idle";const e=this._ctl;Atomics.store(e,R,P),Atomics.store(e,w,++this._epoch),Atomics.notify(e,w),await Promise.all(this._workers.map(t=>t.expect("yielded")))}_resume(){if(this._state==="idle"){for(const e of this._workers)e.post({type:"run"});this._state="running"}}run(e,t,n,s){if(!e.ready||this._state!=="running"||(t.publishRowCounts(),e.query.entityCount<e.minRows))return!1;const r=this._ctl,i=e.exclude;Atomics.store(r,E,0),Atomics.store(r,g,0);for(let h=0;h<f.COMPONENT_MASK_WORDS;h++)r[C+h]=e.include[h]|0,r[A+h]=i===null?0:i[h]|0;r[O]=i===null?0:1,this._ctlF64[L]=n,Atomics.store(r,R,e.slot),Atomics.store(r,w,++this._epoch),Atomics.notify(r,w);const l=this._workers.length,_=performance.now()+this._joinTimeoutMs;for(;;){const h=Atomics.load(r,E);if(h===l)break;const d=_-performance.now();if(d<=0)throw this._stamp(e,s),this._state="failed",new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`a worker did not reach the join of the kernel export '${e.exportName}' within joinTimeoutMs of ${this._joinTimeoutMs}. The world holds whatever the pass wrote, and every later frame runs the sequential body. Detach the pool and fix the kernel.`);Atomics.wait(r,E,h,d)}this._stamp(e,s);const u=Atomics.load(r,g);if(u!==0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`worker ${u-1} threw inside the kernel export '${e.exportName}'. The world is unchanged for the rows that worker owned. Fix the kernel, or lower parallel.minRows to keep the system sequential.`);return!0}_stamp(e,t){const n=e.query.archetypes,s=e.writes;for(let r=0;r<n.length;r++){const i=n[r];if(i.hasColumns)for(let l=0;l<s.length;l++){const _=s[l];i.columnGroupMut(_,t);const u=i.rowTicks[_.id];u!==void 0&&u.fill(t,0,i.enabledCount)}}for(let r=0;r<s.length;r++)this._world.noteScan(s[r].id)}async detach(){if(this._state==="detached")return;try{await this._syncing}catch{}const e=this._state==="running";if(this._state="detached",this._pending.length=0,e){const t=this._ctl;Atomics.store(t,R,W),Atomics.store(t,w,++this._epoch),Atomics.notify(t,w)}await Promise.all(this._workers.map(t=>t.terminate()));for(const t of this._world.plans())t.ready=!1,t.slot=-1;this._world.released()}}const H=2e5;function I(o){const e=new Uint32Array(f.COMPONENT_MASK_WORDS);for(let t=0;t<f.COMPONENT_MASK_WORDS&&t<o.length;t++)e[t]=o[t]>>>0;return e}function V(o){const e=o.excludeWords;return e===null?null:I(e)}function J(o,e,t,n){const s=new Int32Array(o.columns.length*2);for(let r=0;r<o.columns.length;r++){const[i,l]=o.columns[r];s[r*2]=i.id,s[r*2+1]=n(i,l)}return{slot:-1,ready:!1,exportName:o.kernel.export,query:e,include:I(e.include.words),exclude:V(e),specs:s,minRows:o.minRows??H,writes:t,kernel:o.kernel}}class x{_memory;_changes;_control;_resolveQuery;_fieldId;_plans=[];_pool=null;constructor(e){const t=e.store,n=e.world;this._resolveQuery=s=>n.query(...s),this._fieldId=(s,r)=>t.fieldIdOf(s,r),this._memory=e.memory,this._changes=e.changes,e.onDispose(()=>this.dispose()),this._control=e.installRoute(this)}get pool(){return this._pool}async attach(e){if(this._pool!==null)throw new a.ECSError(a.ECS_ERROR.WORKERS_ATTACHED,"workers.attach: this world already holds a pool. One pool per world, detach it before you attach another.");const t=this._memory.backing;if(t===null)throw new a.ECSError(a.ECS_ERROR.WORKERS_NEED_SHARED_BACKING,`workers.attach: this world's backing is '${this._memory.backingSource}', and a worker cannot reach its bytes. Build the world with memory.backing "shared" or { wasm }.`);const n=await m.attach({store:t,storeBase:this._memory.storeBase,noteScan:s=>this._changes.noteScan(s),plans:()=>this._plans,released:()=>{this._pool=null,this._control.route(null)}},e);return this._pool=n,this._control.route(n),n}async detach(){const e=this._pool;e!==null&&await e.detach()}plan(e){const t=e.parallel;if(t===void 0)return;let n=t.query;if(n===void 0){const r=e.queries?.[0];if(r===void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`registerSystem: config${e.name?` '${e.name}'`:""} declares 'parallel' with neither 'parallel.query' nor a first entry in 'queries'. A worker resolves the matched archetypes from a query, so one is required.`);n=this._resolveQuery(r)}const s=J(t,n,e.writes,this._fieldId);return this._plans.push(s),this._pool?.register(s),s}dispose(){this._pool?.detach(),this._plans.length=0}}function Y(){return{name:"workers",install(o){return{workers:new x(o)}}}}exports.DEFAULT_JOIN_TIMEOUT_MS=N;exports.ECSWorkers=x;exports.WorkerPool=m;exports.workers=Y;

package/dist/plugins/workers.d.cts

@@ -0,0 +1 @@
+export * from "./workers/index.cjs";

package/dist/plugins/workers.d.ts

@@ -0,0 +1 @@
+export * from "./workers/index.js";

package/dist/plugins/workers.development.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./abi-D3V-QUSf.cjs"),a=require("../index.development.cjs");var f=typeof document<"u"?document.currentScript:null;async function x(){const o=globalThis.process,e=o?.getBuiltinModule;return typeof e=="function"?e.call(o,"node:worker_threads"):await import(["node","worker_threads"].join(":"))}const w=0,p=1,R=2,C=3,A=4,L=A+_.COMPONENT_MASK_WORDS,g=L+_.COMPONENT_MASK_WORDS,P=g+1,O=P+1>>1,M=(O+1)*8,I=-1,D=-2,k=16,y=65536,$=3e4;function W(o){if(o===void 0)return 0;if(!Number.isInteger(o)||o<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be an integer >= 1, got ${String(o)}`);if(o%k!==0)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be a multiple of ${k}, the frame alignment of a wasm shadow stack, got ${o}`);if(o<y)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: stackBytes must be at least ${y}, one WASM page, got ${o}`);return o}function K(){try{const o=new Int32Array(new SharedArrayBuffer(4));return Atomics.wait(o,0,1,0),!0}catch{return!1}}function U(){const o=globalThis.process;return typeof o=="object"&&o!==null&&typeof o.versions?.node=="string"}function q(){const o=globalThis.navigator?.hardwareConcurrency;return typeof o!="number"||!Number.isFinite(o)?1:Math.max(1,Math.floor(o)-1)}function j(){const o=new URL(typeof document>"u"?require("url").pathToFileURL(__filename).href:f&&f.tagName.toUpperCase()==="SCRIPT"&&f.src||new URL("plugins/workers.development.cjs",document.baseURI).href),e=o.pathname,t=e.lastIndexOf("/"),s=e.slice(t+1),n=s.indexOf("."),r=e.slice(0,t),i=r.slice(0,r.lastIndexOf("/")+1);return o.pathname=`${i}worker${n<0?"":s.slice(n)}`,o}class b{_waiting=new Map;_arrived=new Map;_failure=null;deliver(e){const t=e.slot===void 0?e.type:`${e.type}:${e.slot}`,s=this._waiting.get(t);if(s!==void 0&&s.length>0){s.shift()(e);return}const n=this._arrived.get(t);n===void 0?this._arrived.set(t,[e]):n.push(e)}fail(e){this._failure=e;for(const t of this._waiting.values())for(;t.length>0;)t.shift()({type:"kernel",error:e});this._waiting.clear()}expect(e,t){if(this._failure!==null)return Promise.resolve({type:e,slot:t,error:this._failure});const s=t===void 0?e:`${e}:${t}`,n=this._arrived.get(s);return n!==void 0&&n.length>0?Promise.resolve(n.shift()):new Promise(r=>{const i=this._waiting.get(s);i===void 0?this._waiting.set(s,[r]):i.push(r)})}}async function B(o,e){const t=await x();return e.map(s=>{const n=new t.Worker(o,{workerData:s}),r=new b;return n.on("message",i=>r.deliver(i)),n.on("error",i=>r.fail(i.message)),{post:i=>n.postMessage(i),expect:(i,h)=>r.expect(i,h),terminate:()=>n.terminate()}})}function F(o,e){return e.map(t=>{const s=new Worker(o,{type:"module"}),n=new b;return s.addEventListener("message",r=>n.deliver(r.data)),s.addEventListener("error",r=>{const i=r.message;n.fail(typeof i=="string"&&i!==""?i:`the script at '${String(o)}' did not load`)}),s.postMessage(t),{post:r=>s.postMessage(r),expect:(r,i)=>n.expect(r,i),terminate:()=>(s.terminate(),Promise.resolve())}})}class E{_world;_workers;_ctl;_ctlF64;_joinTimeoutMs;_state="idle";_epoch=0;_nextSlot=0;_pending=[];_syncing=Promise.resolve();constructor(e,t,s,n){this._world=e,this._workers=t,this._ctl=new Int32Array(s),this._ctlF64=new Float64Array(s),this._joinTimeoutMs=n}get count(){return this._workers.length}static async attach(e,t){if(!K())throw new a.ECSError(a.ECS_ERROR.WORKERS_HOST_CANNOT_PARK,"workers.attach: this host refuses Atomics.wait, so it cannot park while the workers run. Host the world inside a worker and attach the pool from there.");const s=t?.count??q();if(!Number.isInteger(s)||s<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: count must be an integer >= 1, got ${String(s)}`);const n=t?.joinTimeoutMs??$;if(!Number.isInteger(n)||n<1)throw new a.ECSError(a.ECS_ERROR.WORKERS_COUNT_INVALID,`workers.attach: joinTimeoutMs must be an integer >= 1, got ${String(n)}`);const r=W(t?.stackBytes),i=new SharedArrayBuffer(M),h=[];for(let d=0;d<s;d++)h.push({store:e.store,storeBase:e.storeBase,control:i,index:d,count:s,stackBytes:r});const u=t?.workerUrl??j(),c=U()?await B(u,h):F(u,h),l=await Promise.all(c.map(d=>d.expect("ready")));for(let d=0;d<l.length;d++){const S=l[d].error;if(S!==void 0)throw await Promise.all(c.map(T=>T.terminate())),new a.ECSError(a.ECS_ERROR.WORKERS_ENTRY_UNREACHABLE,`workers.attach: worker ${d} did not start from '${String(u)}': ${S}. Pass workerUrl with the URL your bundler emits for the '@oasys/oecs/worker' entry.`)}const m=new E(e,c,i,n);for(const d of e.plans())m._pending.push(d);m._kick();try{await m.settled()}catch(d){throw await m.detach(),d}return m}register(e){this._state==="detached"||this._state==="failed"||(this._pending.push(e),this._kick())}_kick(){this._syncing=this._syncing.then(()=>this._sync())}settled(){return this._syncing}async _sync(){if(this._state==="detached"||this._state==="failed")return;const e=this._pending;this._pending=[],e.length>0&&this._state==="running"&&await this._park();for(const t of e){t.slot=this._nextSlot++;const s={type:"kernel",slot:t.slot,wasm:t.kernel.wasm,js:t.kernel.js,exportName:t.exportName,specs:t.specs},n=await Promise.all(this._workers.map(r=>(r.post(s),r.expect("kernel",t.slot))));for(let r=0;r<n.length;r++){const i=n[r].error;if(i!==void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`worker ${r} could not load the kernel export '${t.exportName}': ${String(i).replace(/\.$/,"")}. Check the module and the export name.`)}t.ready=!0}this._resume()}async _park(){this._state="idle";const e=this._ctl;Atomics.store(e,R,I),Atomics.store(e,w,++this._epoch),Atomics.notify(e,w),await Promise.all(this._workers.map(t=>t.expect("yielded")))}_resume(){if(this._state==="idle"){for(const e of this._workers)e.post({type:"run"});this._state="running"}}run(e,t,s,n){if(!e.ready||this._state!=="running"||(t.publishRowCounts(),e.query.entityCount<e.minRows))return!1;const r=this._ctl,i=e.exclude;Atomics.store(r,p,0),Atomics.store(r,C,0);for(let l=0;l<_.COMPONENT_MASK_WORDS;l++)r[A+l]=e.include[l]|0,r[L+l]=i===null?0:i[l]|0;r[g]=i===null?0:1,this._ctlF64[O]=s,Atomics.store(r,R,e.slot),Atomics.store(r,w,++this._epoch),Atomics.notify(r,w);const h=this._workers.length,u=performance.now()+this._joinTimeoutMs;for(;;){const l=Atomics.load(r,p);if(l===h)break;const m=u-performance.now();if(m<=0)throw this._stamp(e,n),this._state="failed",new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`a worker did not reach the join of the kernel export '${e.exportName}' within joinTimeoutMs of ${this._joinTimeoutMs}. The world holds whatever the pass wrote, and every later frame runs the sequential body. Detach the pool and fix the kernel.`);Atomics.wait(r,p,l,m)}this._stamp(e,n);const c=Atomics.load(r,C);if(c!==0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_FAILED,`worker ${c-1} threw inside the kernel export '${e.exportName}'. The world is unchanged for the rows that worker owned. Fix the kernel, or lower parallel.minRows to keep the system sequential.`);return!0}_stamp(e,t){const s=e.query.archetypes,n=e.writes;for(let r=0;r<s.length;r++){const i=s[r];if(i.hasColumns)for(let h=0;h<n.length;h++){const u=n[h];i.columnGroupMut(u,t);const c=i.rowTicks[u.id];c!==void 0&&c.fill(t,0,i.enabledCount)}}for(let r=0;r<n.length;r++)this._world.noteScan(n[r].id)}async detach(){if(this._state==="detached")return;try{await this._syncing}catch{}const e=this._state==="running";if(this._state="detached",this._pending.length=0,e){const t=this._ctl;Atomics.store(t,R,D),Atomics.store(t,w,++this._epoch),Atomics.notify(t,w)}await Promise.all(this._workers.map(t=>t.terminate()));for(const t of this._world.plans())t.ready=!1,t.slot=-1;this._world.released()}}const H=2e5;function G(o,e,t){const s=WebAssembly.Module.imports(e);let n=!1;for(const i of s){if(i.module==="env"&&i.name==="memory"&&i.kind==="memory"){n=!0;continue}throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_MODULE,`${o} names a wasm kernel that imports '${i.module}.${i.name}' as a ${i.kind}, and a worker supplies only 'env.memory'. Drop the import, or move what it does into the kernel.`)}if(!n)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_MODULE,`${o} names a wasm kernel that imports no 'env.memory', so it addresses a linear memory of its own and never the store. Link the module with --import-memory.`);const r=WebAssembly.Module.exports(e).find(i=>i.name===t);if(r===void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_MODULE,`${o} names the wasm kernel export '${t}' and the module exports no such name. Name an export the module carries.`);if(r.kind!=="function")throw new a.ECSError(a.ECS_ERROR.PARALLEL_KERNEL_MODULE,`${o} names the wasm kernel export '${t}', and the module exports it as a ${r.kind}. A kernel must be a function.`)}function v(o){const e=new Uint32Array(_.COMPONENT_MASK_WORDS);for(let t=0;t<_.COMPONENT_MASK_WORDS&&t<o.length;t++)e[t]=o[t]>>>0;return e}function V(o){const e=o.excludeWords;return e===null?null:v(e)}const J=[["spawns","a worker makes no structural change"],["despawns","a worker makes no structural change"],["transitions","a worker makes no structural change"],["resourceReads","a resource is a main-thread value"],["resourceWrites","a resource is a main-thread value"],["sparseReads","a sparse store is a main-thread object"],["sparseWrites","a sparse store is a main-thread object"],["relationReads","a relation store is a main-thread object"],["relationWrites","a relation store is a main-thread object"]];function Y(o,e){const t=o.parallel,s=o.name!==void 0?`system '${o.name}'`:"a parallel system";for(const[l,m]of J){const d=o[l];if(d!==void 0&&d.length>0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares '${l}' beside 'parallel', and ${m}. Drop the declaration, or run the system sequentially.`)}if(o.exclusive===!0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares 'exclusive' beside 'parallel', and an exclusive system reaches state no worker can see. Drop 'exclusive', or run the system sequentially.`);if(o.backendHandle!==void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares 'backendHandle' beside 'parallel', and one system body cannot run in two places. Keep one of them.`);if(o.fn===void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares 'parallel' with no 'fn'. The sequential body runs below the row threshold, and on a world with no pool, so it is required.`);const n=e.terms;if(n.sparseIncludes.length>0||n.sparseExcludes.length>0||n.relationIncludes.length>0||n.relationExcludes.length>0||n.hierarchyTerm!==null||n.includesDisabled)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} runs over a query that carries a sparse, relation, hierarchy or disabled term, and a worker resolves a query from the archetype masks alone. Give it a query whose only terms are .and and .not.`);const r=new Set;for(const l of o.reads)r.add(l.id);for(const l of o.writes)r.add(l.id);const i=new Set;for(const l of e.defs)i.add(l.id);const h=new Set;for(const[l]of t.columns){if(h.add(l.id),!r.has(l.id))throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} names component id ${l.id} in 'parallel.columns' but not in 'reads' or 'writes'. Add it to the access declaration.`);if(!i.has(l.id))throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} names component id ${l.id} in 'parallel.columns' but the query does not require it, so a matched archetype may hold no column for it. Add it to the query.`)}for(const l of o.writes)if(!h.has(l.id))throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares a write of component id ${l.id} that 'parallel.columns' does not name. The join stamps every declared write, and it needs the component's columns. Add a field of it to 'parallel.columns', or drop the write.`);for(const l of e.defs)if(!r.has(l.id))throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} queries component id ${l.id} that is not in 'reads' or 'writes'. Add it to the access declaration.`);const u=t.minRows;if(u!==void 0&&(!Number.isInteger(u)||u<0))throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares parallel.minRows must be an integer >= 0, got ${String(u)}`);const c=t.kernel;if(typeof c.export!="string"||c.export.length===0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares parallel.kernel.export must be a non-empty export name, got ${String(c.export)}`);if(c.wasm===void 0&&c.js===void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`${s} declares a parallel.kernel with neither 'wasm' nor 'js'. Give a compiled WebAssembly.Module, or an absolute module URL a worker can import.`);c.wasm!==void 0&&G(s,c.wasm,c.export)}function Q(o,e,t,s){const n=new Int32Array(o.columns.length*2);for(let r=0;r<o.columns.length;r++){const[i,h]=o.columns[r];n[r*2]=i.id,n[r*2+1]=s(i,h)}return{slot:-1,ready:!1,exportName:o.kernel.export,query:e,include:v(e.include.words),exclude:V(e),specs:n,minRows:o.minRows??H,writes:t,kernel:o.kernel}}class N{_memory;_changes;_control;_resolveQuery;_fieldId;_plans=[];_pool=null;constructor(e){const t=e.store,s=e.world;this._resolveQuery=n=>s.query(...n),this._fieldId=(n,r)=>t.fieldIdOf(n,r),this._memory=e.memory,this._changes=e.changes,e.onDispose(()=>this.dispose()),this._control=e.installRoute(this)}get pool(){return this._pool}async attach(e){if(this._pool!==null)throw new a.ECSError(a.ECS_ERROR.WORKERS_ATTACHED,"workers.attach: this world already holds a pool. One pool per world, detach it before you attach another.");const t=this._memory.backing;if(t===null)throw new a.ECSError(a.ECS_ERROR.WORKERS_NEED_SHARED_BACKING,`workers.attach: this world's backing is '${this._memory.backingSource}', and a worker cannot reach its bytes. Build the world with memory.backing "shared" or { wasm }.`);const s=await E.attach({store:t,storeBase:this._memory.storeBase,noteScan:n=>this._changes.noteScan(n),plans:()=>this._plans,released:()=>{this._pool=null,this._control.route(null)}},e);return this._pool=s,this._control.route(s),s}async detach(){const e=this._pool;e!==null&&await e.detach()}plan(e){const t=e.parallel;if(t===void 0)return;let s=t.query;if(s===void 0){const r=e.queries?.[0];if(r===void 0)throw new a.ECSError(a.ECS_ERROR.PARALLEL_ACCESS,`registerSystem: config${e.name?` '${e.name}'`:""} declares 'parallel' with neither 'parallel.query' nor a first entry in 'queries'. A worker resolves the matched archetypes from a query, so one is required.`);s=this._resolveQuery(r)}Y(e,s);const n=Q(t,s,e.writes,this._fieldId);return this._plans.push(n),this._pool?.register(n),n}dispose(){this._pool?.detach(),this._plans.length=0}}function X(){return{name:"workers",install(o){return{workers:new N(o)}}}}exports.DEFAULT_JOIN_TIMEOUT_MS=$;exports.ECSWorkers=N;exports.WorkerPool=E;exports.workers=X;