aiecsjs 0.5.3 → 0.5.5

package/dist/{chunk-FZWRVGAA.js → chunk-ZWOAXX4R.js}

@@ -1,2 +1,2 @@
-import {i,r,k,u,Q as Q$1,J as J$1,a,R,v as v$1}from'./chunk-UAJNL4VY.js';var p="AIEC",B=1;function P(n,o){let e=D(n);return o?.components&&(e.entities=e.entities.map(t=>({eid:t.eid,components:t.components.filter(i=>o.components.some(c=>c.__id===i.id))}))),x(e)}function Q(n,o){let e=N(n,o);return J(e)}function D(n){let o=i(n),e=[];for(let t=1;t<o.capacity;t++){let i=o.entityArchetype[t]??0;if(i===0)continue;let c=o.archetypes[i];if(!c)continue;let r$1=o.generations[t]??0,a=r(t,r$1,o.options);if(!c.entityRow.has(a))continue;let s=o.options.maskWordCount,f=t*s,l=[];for(let d=0;d<s;d++){let m=o.entityMask[f+d]??0;for(;m!==0;){let b=m&-m,A=(d<<5)+(31-Math.clz32(b)),h=o.componentInfoByBit[A];if(h){let S=o.componentStorageByBit[A],w=null;if(h.kind==="soa"&&S?.soa){let y={};for(let u of h.fields){let g=S.soa[u.name];if(g)if(u.vectorLen===1)y[u.name]=g[t];else {let _=[],M=t*u.vectorLen;for(let C=0;C<u.vectorLen;C++)_.push(g[M+C]??0);y[u.name]=_;}}w=y;}else h.kind==="aos"&&S?.aos?w=S.aos[t]??null:w=true;l.push({kind:h.kind,id:h.id,data:w});}m&=m-1;}}e.push({eid:t,components:l});}return {version:o.version,capacity:o.capacity,entities:e}}function J(n){let o=k({initialCapacity:n.capacity}),e=new Map;for(let t of n.entities){let i=u(o);e.set(t.eid,i);}for(let t of n.entities){let i=e.get(t.eid);for(let c of t.components){let r=Q$1(c.id);if(!r)continue;let a=v(r);a&&J$1(o,i,a,c.data);}}return o}function v(n){if(n.kind==="soa")return {__kind:"soa",__id:n.id,__schema:n.schema??{}};if(n.kind==="aos"){let o=n.factory??(()=>({}));return {__kind:"aos",__id:n.id,__factory:o}}return {__kind:"tag",__id:n.id}}function x(n){let o=JSON.stringify(n),e=new TextEncoder().encode(o),t=new TextEncoder().encode(a),c=12+t.length+4+e.length,r=new Uint8Array(c),a$1=new DataView(r.buffer),s=0;return r[s++]=p.charCodeAt(0),r[s++]=p.charCodeAt(1),r[s++]=p.charCodeAt(2),r[s++]=p.charCodeAt(3),a$1.setUint32(s,B,true),s+=4,a$1.setUint32(s,t.length,true),s+=4,r.set(t,s),s+=t.length,a$1.setUint32(s,e.length,true),s+=4,r.set(e,s),r}function N(n,o){if(n.length<12)throw new Error("aiecsjs: bytes too short to be a valid snapshot");let e=new DataView(n.buffer,n.byteOffset,n.byteLength);if(n[0]!==p.charCodeAt(0)||n[1]!==p.charCodeAt(1)||n[2]!==p.charCodeAt(2)||n[3]!==p.charCodeAt(3))throw new Error("aiecsjs: invalid magic bytes");let t=4,i=e.getUint32(t,true);t+=4;let c=o?.onUnknownVersion??"throw";if(i!==B&&c==="throw")throw new Error(`aiecsjs: format version ${i} not supported`);let r=64*1024*1024;if(t+4>n.length)throw new Error("aiecsjs: snapshot truncated before verLen");let a=e.getUint32(t,true);if(t+=4,a>r||t+a>n.length)throw new Error(`aiecsjs: snapshot verLen=${a} out of bounds`);if(t+=a,t+4>n.length)throw new Error("aiecsjs: snapshot truncated before jsonLen");let s=e.getUint32(t,true);if(t+=4,s>r||t+s>n.length)throw new Error(`aiecsjs: snapshot jsonLen=${s} out of bounds`);let f=n.subarray(t,t+s),l=new TextDecoder().decode(f);try{return JSON.parse(l)}catch(d){throw new Error("aiecsjs: snapshot body is not valid JSON",{cause:d})}}function Y(n,o){let e={world:n,components:o?.components??R().map(t=>v(t)).filter(Boolean),lastSnapshot:null};return {capture(){let t=D(e.world),i;return e.lastSnapshot?i=V(e.lastSnapshot,t):i=t,e.lastSnapshot=t,x(i)},apply(t,i$1){let c=N(i$1),r=i(t);for(let a of c.entities){if(a.eid<=0||a.eid>=r.options.maxEntities)continue;let s=v$1(r,a.eid);for(let f of a.components){let l=Q$1(f.id);if(!l)continue;let d=v(l);d&&J$1(t,s,d,f.data);}}},reset(){e.lastSnapshot=null;}}}function V(n,o){let e=new Map(n.entities.map(i=>[i.eid,i])),t=[];for(let i of o.entities){let c=e.get(i.eid);if(!c){t.push(i);continue}let r=JSON.stringify(c.components),a=JSON.stringify(i.components);r!==a&&t.push(i);}return {version:o.version,capacity:o.capacity,entities:t}}export{P as a,Q as b,D as c,J as d,Y as e};//# sourceMappingURL=chunk-FZWRVGAA.js.map
-//# sourceMappingURL=chunk-FZWRVGAA.js.map
+import {i,r,k,u,Q as Q$1,J as J$1,a,R,v as v$1}from'./chunk-ENULPSKV.js';var p="AIEC",B=1;function P(n,o){let e=D(n);return o?.components&&(e.entities=e.entities.map(t=>({eid:t.eid,components:t.components.filter(i=>o.components.some(c=>c.__id===i.id))}))),x(e)}function Q(n,o){let e=N(n,o);return J(e)}function D(n){let o=i(n),e=[];for(let t=1;t<o.capacity;t++){let i=o.entityArchetype[t]??0;if(i===0)continue;let c=o.archetypes[i];if(!c)continue;let r$1=o.generations[t]??0,a=r(t,r$1,o.options);if(!c.entityRow.has(a))continue;let s=o.options.maskWordCount,f=t*s,l=[];for(let d=0;d<s;d++){let m=o.entityMask[f+d]??0;for(;m!==0;){let b=m&-m,A=(d<<5)+(31-Math.clz32(b)),h=o.componentInfoByBit[A];if(h){let S=o.componentStorageByBit[A],w=null;if(h.kind==="soa"&&S?.soa){let y={};for(let u of h.fields){let g=S.soa[u.name];if(g)if(u.vectorLen===1)y[u.name]=g[t];else {let _=[],M=t*u.vectorLen;for(let C=0;C<u.vectorLen;C++)_.push(g[M+C]??0);y[u.name]=_;}}w=y;}else h.kind==="aos"&&S?.aos?w=S.aos[t]??null:w=true;l.push({kind:h.kind,id:h.id,data:w});}m&=m-1;}}e.push({eid:t,components:l});}return {version:o.version,capacity:o.capacity,entities:e}}function J(n){let o=k({initialCapacity:n.capacity}),e=new Map;for(let t of n.entities){let i=u(o);e.set(t.eid,i);}for(let t of n.entities){let i=e.get(t.eid);for(let c of t.components){let r=Q$1(c.id);if(!r)continue;let a=v(r);a&&J$1(o,i,a,c.data);}}return o}function v(n){if(n.kind==="soa")return {__kind:"soa",__id:n.id,__schema:n.schema??{}};if(n.kind==="aos"){let o=n.factory??(()=>({}));return {__kind:"aos",__id:n.id,__factory:o}}return {__kind:"tag",__id:n.id}}function x(n){let o=JSON.stringify(n),e=new TextEncoder().encode(o),t=new TextEncoder().encode(a),c=12+t.length+4+e.length,r=new Uint8Array(c),a$1=new DataView(r.buffer),s=0;return r[s++]=p.charCodeAt(0),r[s++]=p.charCodeAt(1),r[s++]=p.charCodeAt(2),r[s++]=p.charCodeAt(3),a$1.setUint32(s,B,true),s+=4,a$1.setUint32(s,t.length,true),s+=4,r.set(t,s),s+=t.length,a$1.setUint32(s,e.length,true),s+=4,r.set(e,s),r}function N(n,o){if(n.length<12)throw new Error("aiecsjs: bytes too short to be a valid snapshot");let e=new DataView(n.buffer,n.byteOffset,n.byteLength);if(n[0]!==p.charCodeAt(0)||n[1]!==p.charCodeAt(1)||n[2]!==p.charCodeAt(2)||n[3]!==p.charCodeAt(3))throw new Error("aiecsjs: invalid magic bytes");let t=4,i=e.getUint32(t,true);t+=4;let c=o?.onUnknownVersion??"throw";if(i!==B&&c==="throw")throw new Error(`aiecsjs: format version ${i} not supported`);let r=64*1024*1024;if(t+4>n.length)throw new Error("aiecsjs: snapshot truncated before verLen");let a=e.getUint32(t,true);if(t+=4,a>r||t+a>n.length)throw new Error(`aiecsjs: snapshot verLen=${a} out of bounds`);if(t+=a,t+4>n.length)throw new Error("aiecsjs: snapshot truncated before jsonLen");let s=e.getUint32(t,true);if(t+=4,s>r||t+s>n.length)throw new Error(`aiecsjs: snapshot jsonLen=${s} out of bounds`);let f=n.subarray(t,t+s),l=new TextDecoder().decode(f);try{return JSON.parse(l)}catch(d){throw new Error("aiecsjs: snapshot body is not valid JSON",{cause:d})}}function Y(n,o){let e={world:n,components:o?.components??R().map(t=>v(t)).filter(Boolean),lastSnapshot:null};return {capture(){let t=D(e.world),i;return e.lastSnapshot?i=V(e.lastSnapshot,t):i=t,e.lastSnapshot=t,x(i)},apply(t,i$1){let c=N(i$1),r=i(t);for(let a of c.entities){if(a.eid<=0||a.eid>=r.options.maxEntities)continue;let s=v$1(r,a.eid);for(let f of a.components){let l=Q$1(f.id);if(!l)continue;let d=v(l);d&&J$1(t,s,d,f.data);}}},reset(){e.lastSnapshot=null;}}}function V(n,o){let e=new Map(n.entities.map(i=>[i.eid,i])),t=[];for(let i of o.entities){let c=e.get(i.eid);if(!c){t.push(i);continue}let r=JSON.stringify(c.components),a=JSON.stringify(i.components);r!==a&&t.push(i);}return {version:o.version,capacity:o.capacity,entities:t}}export{P as a,Q as b,D as c,J as d,Y as e};//# sourceMappingURL=chunk-ZWOAXX4R.js.map
+//# sourceMappingURL=chunk-ZWOAXX4R.js.map

package/dist/{chunk-FZWRVGAA.js.map → chunk-ZWOAXX4R.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/serialize.ts"],"names":["MAGIC","FORMAT_VERSION","serializeWorld","world","options","snapshot","toJSON","e","c","comp","packBinary","deserializeWorld","bytes","unpackBinary","fromJSON","state","getWorldState","entities","idx","archId","arch","gen","packedEid","packEid","w","base","components","wi","word","lsb","bit","info","storage","data","obj","f","col","arr","baseI","i","createWorld","eidMap","eid","createEntity","getComponentByInternalId","handle","getComponentHandle","addComponent","factory","json","jsonBytes","versionBytes","VERSION","total","out","view","off","formatVersion","onUnknown","MAX_FIELD_LEN","verLen","jsonLen","cause","createDeltaSerializer","listAllComponents","current","delta","computeDelta","targetWorld","deltaBytes","targetState","ensureEntityAtSlot","prev","curr","prevByEid","changed","prevE","prevSig","currSig"],"mappings":"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","file":"chunk-FZWRVGAA.js","sourcesContent":["// aiecsjs/serialize — binary, JSON, and delta serializers.\n\nimport { testBit } from './internal/bitmask.js'\nimport {\n  addComponent,\n  defineComponent,\n  defineObjectComponent,\n  defineTag,\n  getComponentByInternalId,\n  getComponentInfo,\n  listAllComponents,\n} from './internal/component.js'\nimport { createEntity, destroyEntity, ensureEntityAtSlot, packEid } from './internal/entity.js'\nimport type {\n  ComponentInfo,\n  ComponentLike,\n  DeltaSerializer,\n  DeserializeOptions,\n  EntityId,\n  SerializeOptions,\n  World,\n  WorldSnapshot,\n} from './internal/types.js'\nimport { createWorld, getWorldState } from './internal/world.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 'AIEC'\nconst FORMAT_VERSION = 1\n\nexport function serializeWorld(world: World, options?: SerializeOptions): Uint8Array {\n  const snapshot = toJSON(world)\n  if (options?.components) {\n    snapshot.entities = snapshot.entities.map((e) => ({\n      eid: e.eid,\n      components: e.components.filter((c) =>\n        options.components!.some((comp) => comp.__id === c.id),\n      ),\n    }))\n  }\n  return packBinary(snapshot)\n}\n\nexport function deserializeWorld(bytes: Uint8Array, options?: DeserializeOptions): World {\n  const snapshot = unpackBinary(bytes, options)\n  return fromJSON(snapshot)\n}\n\n/**\n * Serialize a world snapshot to a plain JSON-compatible object.\n *\n * Note: `EntityRef` is in-memory only — not preserved across serialize/deserialize.\n * Generation counters reset on world load. Stale refs from before serialization\n * will deref to null after loading the snapshot into a new world.\n */\nexport function toJSON(world: World): WorldSnapshot {\n  const state = getWorldState(world)\n  const entities: WorldSnapshot['entities'] = []\n  // Iterate by raw slot index; snapshot stores raw idx in the `eid` field\n  // (wire format unchanged — idx is used for load-side entity re-creation).\n  for (let idx = 1; idx < state.capacity; idx++) {\n    const archId = state.entityArchetype[idx] ?? 0\n    if (archId === 0) continue // slot unused\n\n    const arch = state.archetypes[archId]\n    if (!arch) continue\n\n    // Build the packed eid from idx + current generation to do alive check\n    const gen = state.generations[idx] ?? 0\n    const packedEid = packEid(idx, gen, state.options)\n    if (!arch.entityRow.has(packedEid)) continue\n\n    const w = state.options.maskWordCount\n    const base = idx * w\n    const components: WorldSnapshot['entities'][0]['components'] = []\n    for (let wi = 0; wi < w; wi++) {\n      let word = state.entityMask[base + wi] ?? 0\n      while (word !== 0) {\n        const lsb = word & -word\n        const bit = (wi << 5) + (31 - Math.clz32(lsb))\n        const info = state.componentInfoByBit[bit]\n        if (info) {\n          const storage = state.componentStorageByBit[bit]\n          let data: unknown = null\n          if (info.kind === 'soa' && storage?.soa) {\n            const obj: Record<string, unknown> = {}\n            for (const f of info.fields) {\n              const col = storage.soa[f.name]\n              if (!col) continue\n              if (f.vectorLen === 1) {\n                obj[f.name] = col[idx]\n              } else {\n                const arr: number[] = []\n                const baseI = idx * f.vectorLen\n                for (let i = 0; i < f.vectorLen; i++) arr.push(col[baseI + i] ?? 0)\n                obj[f.name] = arr\n              }\n            }\n            data = obj\n          } else if (info.kind === 'aos' && storage?.aos) {\n            data = storage.aos[idx] ?? null\n          } else {\n            data = true\n          }\n          components.push({ kind: info.kind, id: info.id, data })\n        }\n        word &= word - 1\n      }\n    }\n    // Wire format stores raw idx (not packed) for cross-session portability\n    entities.push({ eid: idx, components })\n  }\n  return {\n    version: state.version,\n    capacity: state.capacity,\n    entities,\n  }\n}\n\nexport function fromJSON(snapshot: WorldSnapshot): World {\n  const world = createWorld({ initialCapacity: snapshot.capacity })\n  const eidMap = new Map<number, EntityId>()\n  for (const e of snapshot.entities) {\n    const eid = createEntity(world)\n    eidMap.set(e.eid, eid)\n  }\n  for (const e of snapshot.entities) {\n    const eid = eidMap.get(e.eid)!\n    for (const comp of e.components) {\n      const info = getComponentByInternalId(comp.id)\n      if (!info) {\n        // Component missing — silently skip; future version may throw based on options\n        continue\n      }\n      const handle = getComponentHandle(info)\n      if (handle) {\n        addComponent(world, eid, handle, comp.data as any)\n      }\n    }\n  }\n  return world\n}\n\n// Reconstruct a component handle from its ComponentInfo. Since defineComponent\n// returns plain handles { __kind, __id, __schema }, we can synthesize them.\nfunction getComponentHandle(info: ComponentInfo): ComponentLike | null {\n  if (info.kind === 'soa') {\n    return { __kind: 'soa', __id: info.id, __schema: info.schema ?? {} } as ComponentLike\n  }\n  if (info.kind === 'aos') {\n    const factory = info.factory ?? (() => ({}))\n    return { __kind: 'aos', __id: info.id, __factory: factory } as ComponentLike\n  }\n  return { __kind: 'tag', __id: info.id } as ComponentLike\n}\n\n// --- Binary packing (wrapped JSON for 0.1) ---\n\nfunction packBinary(snapshot: WorldSnapshot): Uint8Array {\n  const json = JSON.stringify(snapshot)\n  const jsonBytes = new TextEncoder().encode(json)\n  const versionBytes = new TextEncoder().encode(VERSION)\n  const headerSize = 4 + 4 + 4 + versionBytes.length + 4\n  const total = headerSize + jsonBytes.length\n  const out = new Uint8Array(total)\n  const view = new DataView(out.buffer)\n  let off = 0\n  out[off++] = MAGIC.charCodeAt(0)\n  out[off++] = MAGIC.charCodeAt(1)\n  out[off++] = MAGIC.charCodeAt(2)\n  out[off++] = MAGIC.charCodeAt(3)\n  view.setUint32(off, FORMAT_VERSION, true)\n  off += 4\n  view.setUint32(off, versionBytes.length, true)\n  off += 4\n  out.set(versionBytes, off)\n  off += versionBytes.length\n  view.setUint32(off, jsonBytes.length, true)\n  off += 4\n  out.set(jsonBytes, off)\n  return out\n}\n\nfunction unpackBinary(bytes: Uint8Array, options?: DeserializeOptions): WorldSnapshot {\n  if (bytes.length < 12) throw new Error('aiecsjs: bytes too short to be a valid snapshot')\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n  if (\n    bytes[0] !== MAGIC.charCodeAt(0) ||\n    bytes[1] !== MAGIC.charCodeAt(1) ||\n    bytes[2] !== MAGIC.charCodeAt(2) ||\n    bytes[3] !== MAGIC.charCodeAt(3)\n  ) {\n    throw new Error('aiecsjs: invalid magic bytes')\n  }\n  let off = 4\n  const formatVersion = view.getUint32(off, true)\n  off += 4\n  const onUnknown = options?.onUnknownVersion ?? 'throw'\n  if (formatVersion !== FORMAT_VERSION && onUnknown === 'throw') {\n    throw new Error(`aiecsjs: format version ${formatVersion} not supported`)\n  }\n\n  // SECURITY: explicit bounds checks on every length field. DataView itself\n  // throws on out-of-range reads, but an attacker who controls the bytes can\n  // still craft a `verLen` that skips past data of their choosing — we make\n  // each step's invariant explicit and impose a sane cap to short-circuit\n  // pathological payloads early.\n  const MAX_FIELD_LEN = 64 * 1024 * 1024 // 64 MiB\n  if (off + 4 > bytes.length) {\n    throw new Error('aiecsjs: snapshot truncated before verLen')\n  }\n  const verLen = view.getUint32(off, true)\n  off += 4\n  if (verLen > MAX_FIELD_LEN || off + verLen > bytes.length) {\n    throw new Error(`aiecsjs: snapshot verLen=${verLen} out of bounds`)\n  }\n  off += verLen // skip the aiecsjs version string\n\n  if (off + 4 > bytes.length) {\n    throw new Error('aiecsjs: snapshot truncated before jsonLen')\n  }\n  const jsonLen = view.getUint32(off, true)\n  off += 4\n  if (jsonLen > MAX_FIELD_LEN || off + jsonLen > bytes.length) {\n    throw new Error(`aiecsjs: snapshot jsonLen=${jsonLen} out of bounds`)\n  }\n  const jsonBytes = bytes.subarray(off, off + jsonLen)\n  const json = new TextDecoder().decode(jsonBytes)\n  // Wrap the parse so a malformed body (e.g. a truncated/garbled payload reached\n  // under onUnknownVersion:'best-effort') surfaces a namespaced `aiecsjs:` error\n  // instead of leaking a raw SyntaxError — consistent with the rest of the module.\n  // Bounds checks above already guarantee `json` covers exactly the declared body.\n  try {\n    return JSON.parse(json) as WorldSnapshot\n  } catch (cause) {\n    throw new Error('aiecsjs: snapshot body is not valid JSON', { cause })\n  }\n}\n\n// --- Delta serializer ---\n\ninterface DeltaState {\n  world: World\n  components: ComponentLike[]\n  lastSnapshot: WorldSnapshot | null\n}\n\nexport function createDeltaSerializer(world: World, options?: SerializeOptions): DeltaSerializer {\n  const state: DeltaState = {\n    world,\n    components:\n      options?.components ??\n      listAllComponents()\n        .map((i) => getComponentHandle(i)!)\n        .filter(Boolean),\n    lastSnapshot: null,\n  }\n  return {\n    capture(): Uint8Array {\n      const current = toJSON(state.world)\n      let delta: WorldSnapshot\n      if (!state.lastSnapshot) {\n        delta = current\n      } else {\n        // Compute simple delta: entities with changed components\n        delta = computeDelta(state.lastSnapshot, current)\n      }\n      state.lastSnapshot = current\n      return packBinary(delta)\n    },\n    apply(targetWorld: World, deltaBytes: Uint8Array): void {\n      const snapshot = unpackBinary(deltaBytes)\n      // Materialise each snapshot entity at the SAME slot index the source used\n      // (the wire stores raw slot indices in `eid`). ensureEntityAtSlot reuses a\n      // live slot, reclaims a freed one, or advances the frontier — so apply() is\n      // sound on a non-pristine / independently-churned replica (it uses the\n      // slot's CURRENT generation, never gen=0) and never spawns phantom padding\n      // entities for holes in the source's slot range.\n      //\n      // CAVEAT: deltas carry added/changed entities only (see computeDelta) —\n      // entity REMOVALS are not represented, so a replica is not pruned when the\n      // source destroys an entity, and a component removed on the source is not\n      // removed on the replica. apply() is additive/updating.\n      const targetState = getWorldState(targetWorld)\n      for (const e of snapshot.entities) {\n        if (e.eid <= 0 || e.eid >= targetState.options.maxEntities) continue\n        const eid = ensureEntityAtSlot(targetState, e.eid)\n        for (const comp of e.components) {\n          const info = getComponentByInternalId(comp.id)\n          if (!info) continue\n          const handle = getComponentHandle(info)\n          if (handle) addComponent(targetWorld, eid, handle, comp.data as any)\n        }\n      }\n    },\n    reset(): void {\n      state.lastSnapshot = null\n    },\n  }\n}\n\nfunction computeDelta(prev: WorldSnapshot, curr: WorldSnapshot): WorldSnapshot {\n  const prevByEid = new Map(prev.entities.map((e) => [e.eid, e]))\n  const changed: WorldSnapshot['entities'] = []\n  for (const e of curr.entities) {\n    const prevE = prevByEid.get(e.eid)\n    if (!prevE) {\n      changed.push(e)\n      continue\n    }\n    const prevSig = JSON.stringify(prevE.components)\n    const currSig = JSON.stringify(e.components)\n    if (prevSig !== currSig) changed.push(e)\n  }\n  return { version: curr.version, capacity: curr.capacity, entities: changed }\n}\n"]}
+{"version":3,"sources":["../src/serialize.ts"],"names":["MAGIC","FORMAT_VERSION","serializeWorld","world","options","snapshot","toJSON","e","c","comp","packBinary","deserializeWorld","bytes","unpackBinary","fromJSON","state","getWorldState","entities","idx","archId","arch","gen","packedEid","packEid","w","base","components","wi","word","lsb","bit","info","storage","data","obj","f","col","arr","baseI","i","createWorld","eidMap","eid","createEntity","getComponentByInternalId","handle","getComponentHandle","addComponent","factory","json","jsonBytes","versionBytes","VERSION","total","out","view","off","formatVersion","onUnknown","MAX_FIELD_LEN","verLen","jsonLen","cause","createDeltaSerializer","listAllComponents","current","delta","computeDelta","targetWorld","deltaBytes","targetState","ensureEntityAtSlot","prev","curr","prevByEid","changed","prevE","prevSig","currSig"],"mappings":"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","file":"chunk-ZWOAXX4R.js","sourcesContent":["// aiecsjs/serialize — binary, JSON, and delta serializers.\n\nimport { testBit } from './internal/bitmask.js'\nimport {\n  addComponent,\n  defineComponent,\n  defineObjectComponent,\n  defineTag,\n  getComponentByInternalId,\n  getComponentInfo,\n  listAllComponents,\n} from './internal/component.js'\nimport { createEntity, destroyEntity, ensureEntityAtSlot, packEid } from './internal/entity.js'\nimport type {\n  ComponentInfo,\n  ComponentLike,\n  DeltaSerializer,\n  DeserializeOptions,\n  EntityId,\n  SerializeOptions,\n  World,\n  WorldSnapshot,\n} from './internal/types.js'\nimport { createWorld, getWorldState } from './internal/world.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 'AIEC'\nconst FORMAT_VERSION = 1\n\nexport function serializeWorld(world: World, options?: SerializeOptions): Uint8Array {\n  const snapshot = toJSON(world)\n  if (options?.components) {\n    snapshot.entities = snapshot.entities.map((e) => ({\n      eid: e.eid,\n      components: e.components.filter((c) =>\n        options.components!.some((comp) => comp.__id === c.id),\n      ),\n    }))\n  }\n  return packBinary(snapshot)\n}\n\nexport function deserializeWorld(bytes: Uint8Array, options?: DeserializeOptions): World {\n  const snapshot = unpackBinary(bytes, options)\n  return fromJSON(snapshot)\n}\n\n/**\n * Serialize a world snapshot to a plain JSON-compatible object.\n *\n * Note: `EntityRef` is in-memory only — not preserved across serialize/deserialize.\n * Generation counters reset on world load. Stale refs from before serialization\n * will deref to null after loading the snapshot into a new world.\n */\nexport function toJSON(world: World): WorldSnapshot {\n  const state = getWorldState(world)\n  const entities: WorldSnapshot['entities'] = []\n  // Iterate by raw slot index; snapshot stores raw idx in the `eid` field\n  // (wire format unchanged — idx is used for load-side entity re-creation).\n  for (let idx = 1; idx < state.capacity; idx++) {\n    const archId = state.entityArchetype[idx] ?? 0\n    if (archId === 0) continue // slot unused\n\n    const arch = state.archetypes[archId]\n    if (!arch) continue\n\n    // Build the packed eid from idx + current generation to do alive check\n    const gen = state.generations[idx] ?? 0\n    const packedEid = packEid(idx, gen, state.options)\n    if (!arch.entityRow.has(packedEid)) continue\n\n    const w = state.options.maskWordCount\n    const base = idx * w\n    const components: WorldSnapshot['entities'][0]['components'] = []\n    for (let wi = 0; wi < w; wi++) {\n      let word = state.entityMask[base + wi] ?? 0\n      while (word !== 0) {\n        const lsb = word & -word\n        const bit = (wi << 5) + (31 - Math.clz32(lsb))\n        const info = state.componentInfoByBit[bit]\n        if (info) {\n          const storage = state.componentStorageByBit[bit]\n          let data: unknown = null\n          if (info.kind === 'soa' && storage?.soa) {\n            const obj: Record<string, unknown> = {}\n            for (const f of info.fields) {\n              const col = storage.soa[f.name]\n              if (!col) continue\n              if (f.vectorLen === 1) {\n                obj[f.name] = col[idx]\n              } else {\n                const arr: number[] = []\n                const baseI = idx * f.vectorLen\n                for (let i = 0; i < f.vectorLen; i++) arr.push(col[baseI + i] ?? 0)\n                obj[f.name] = arr\n              }\n            }\n            data = obj\n          } else if (info.kind === 'aos' && storage?.aos) {\n            data = storage.aos[idx] ?? null\n          } else {\n            data = true\n          }\n          components.push({ kind: info.kind, id: info.id, data })\n        }\n        word &= word - 1\n      }\n    }\n    // Wire format stores raw idx (not packed) for cross-session portability\n    entities.push({ eid: idx, components })\n  }\n  return {\n    version: state.version,\n    capacity: state.capacity,\n    entities,\n  }\n}\n\nexport function fromJSON(snapshot: WorldSnapshot): World {\n  const world = createWorld({ initialCapacity: snapshot.capacity })\n  const eidMap = new Map<number, EntityId>()\n  for (const e of snapshot.entities) {\n    const eid = createEntity(world)\n    eidMap.set(e.eid, eid)\n  }\n  for (const e of snapshot.entities) {\n    const eid = eidMap.get(e.eid)!\n    for (const comp of e.components) {\n      const info = getComponentByInternalId(comp.id)\n      if (!info) {\n        // Component missing — silently skip; future version may throw based on options\n        continue\n      }\n      const handle = getComponentHandle(info)\n      if (handle) {\n        addComponent(world, eid, handle, comp.data as any)\n      }\n    }\n  }\n  return world\n}\n\n// Reconstruct a component handle from its ComponentInfo. Since defineComponent\n// returns plain handles { __kind, __id, __schema }, we can synthesize them.\nfunction getComponentHandle(info: ComponentInfo): ComponentLike | null {\n  if (info.kind === 'soa') {\n    return { __kind: 'soa', __id: info.id, __schema: info.schema ?? {} } as ComponentLike\n  }\n  if (info.kind === 'aos') {\n    const factory = info.factory ?? (() => ({}))\n    return { __kind: 'aos', __id: info.id, __factory: factory } as ComponentLike\n  }\n  return { __kind: 'tag', __id: info.id } as ComponentLike\n}\n\n// --- Binary packing (wrapped JSON for 0.1) ---\n\nfunction packBinary(snapshot: WorldSnapshot): Uint8Array {\n  const json = JSON.stringify(snapshot)\n  const jsonBytes = new TextEncoder().encode(json)\n  const versionBytes = new TextEncoder().encode(VERSION)\n  const headerSize = 4 + 4 + 4 + versionBytes.length + 4\n  const total = headerSize + jsonBytes.length\n  const out = new Uint8Array(total)\n  const view = new DataView(out.buffer)\n  let off = 0\n  out[off++] = MAGIC.charCodeAt(0)\n  out[off++] = MAGIC.charCodeAt(1)\n  out[off++] = MAGIC.charCodeAt(2)\n  out[off++] = MAGIC.charCodeAt(3)\n  view.setUint32(off, FORMAT_VERSION, true)\n  off += 4\n  view.setUint32(off, versionBytes.length, true)\n  off += 4\n  out.set(versionBytes, off)\n  off += versionBytes.length\n  view.setUint32(off, jsonBytes.length, true)\n  off += 4\n  out.set(jsonBytes, off)\n  return out\n}\n\nfunction unpackBinary(bytes: Uint8Array, options?: DeserializeOptions): WorldSnapshot {\n  if (bytes.length < 12) throw new Error('aiecsjs: bytes too short to be a valid snapshot')\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n  if (\n    bytes[0] !== MAGIC.charCodeAt(0) ||\n    bytes[1] !== MAGIC.charCodeAt(1) ||\n    bytes[2] !== MAGIC.charCodeAt(2) ||\n    bytes[3] !== MAGIC.charCodeAt(3)\n  ) {\n    throw new Error('aiecsjs: invalid magic bytes')\n  }\n  let off = 4\n  const formatVersion = view.getUint32(off, true)\n  off += 4\n  const onUnknown = options?.onUnknownVersion ?? 'throw'\n  if (formatVersion !== FORMAT_VERSION && onUnknown === 'throw') {\n    throw new Error(`aiecsjs: format version ${formatVersion} not supported`)\n  }\n\n  // SECURITY: explicit bounds checks on every length field. DataView itself\n  // throws on out-of-range reads, but an attacker who controls the bytes can\n  // still craft a `verLen` that skips past data of their choosing — we make\n  // each step's invariant explicit and impose a sane cap to short-circuit\n  // pathological payloads early.\n  const MAX_FIELD_LEN = 64 * 1024 * 1024 // 64 MiB\n  if (off + 4 > bytes.length) {\n    throw new Error('aiecsjs: snapshot truncated before verLen')\n  }\n  const verLen = view.getUint32(off, true)\n  off += 4\n  if (verLen > MAX_FIELD_LEN || off + verLen > bytes.length) {\n    throw new Error(`aiecsjs: snapshot verLen=${verLen} out of bounds`)\n  }\n  off += verLen // skip the aiecsjs version string\n\n  if (off + 4 > bytes.length) {\n    throw new Error('aiecsjs: snapshot truncated before jsonLen')\n  }\n  const jsonLen = view.getUint32(off, true)\n  off += 4\n  if (jsonLen > MAX_FIELD_LEN || off + jsonLen > bytes.length) {\n    throw new Error(`aiecsjs: snapshot jsonLen=${jsonLen} out of bounds`)\n  }\n  const jsonBytes = bytes.subarray(off, off + jsonLen)\n  const json = new TextDecoder().decode(jsonBytes)\n  // Wrap the parse so a malformed body (e.g. a truncated/garbled payload reached\n  // under onUnknownVersion:'best-effort') surfaces a namespaced `aiecsjs:` error\n  // instead of leaking a raw SyntaxError — consistent with the rest of the module.\n  // Bounds checks above already guarantee `json` covers exactly the declared body.\n  try {\n    return JSON.parse(json) as WorldSnapshot\n  } catch (cause) {\n    throw new Error('aiecsjs: snapshot body is not valid JSON', { cause })\n  }\n}\n\n// --- Delta serializer ---\n\ninterface DeltaState {\n  world: World\n  components: ComponentLike[]\n  lastSnapshot: WorldSnapshot | null\n}\n\nexport function createDeltaSerializer(world: World, options?: SerializeOptions): DeltaSerializer {\n  const state: DeltaState = {\n    world,\n    components:\n      options?.components ??\n      listAllComponents()\n        .map((i) => getComponentHandle(i)!)\n        .filter(Boolean),\n    lastSnapshot: null,\n  }\n  return {\n    capture(): Uint8Array {\n      const current = toJSON(state.world)\n      let delta: WorldSnapshot\n      if (!state.lastSnapshot) {\n        delta = current\n      } else {\n        // Compute simple delta: entities with changed components\n        delta = computeDelta(state.lastSnapshot, current)\n      }\n      state.lastSnapshot = current\n      return packBinary(delta)\n    },\n    apply(targetWorld: World, deltaBytes: Uint8Array): void {\n      const snapshot = unpackBinary(deltaBytes)\n      // Materialise each snapshot entity at the SAME slot index the source used\n      // (the wire stores raw slot indices in `eid`). ensureEntityAtSlot reuses a\n      // live slot, reclaims a freed one, or advances the frontier — so apply() is\n      // sound on a non-pristine / independently-churned replica (it uses the\n      // slot's CURRENT generation, never gen=0) and never spawns phantom padding\n      // entities for holes in the source's slot range.\n      //\n      // CAVEAT: deltas carry added/changed entities only (see computeDelta) —\n      // entity REMOVALS are not represented, so a replica is not pruned when the\n      // source destroys an entity, and a component removed on the source is not\n      // removed on the replica. apply() is additive/updating.\n      const targetState = getWorldState(targetWorld)\n      for (const e of snapshot.entities) {\n        if (e.eid <= 0 || e.eid >= targetState.options.maxEntities) continue\n        const eid = ensureEntityAtSlot(targetState, e.eid)\n        for (const comp of e.components) {\n          const info = getComponentByInternalId(comp.id)\n          if (!info) continue\n          const handle = getComponentHandle(info)\n          if (handle) addComponent(targetWorld, eid, handle, comp.data as any)\n        }\n      }\n    },\n    reset(): void {\n      state.lastSnapshot = null\n    },\n  }\n}\n\nfunction computeDelta(prev: WorldSnapshot, curr: WorldSnapshot): WorldSnapshot {\n  const prevByEid = new Map(prev.entities.map((e) => [e.eid, e]))\n  const changed: WorldSnapshot['entities'] = []\n  for (const e of curr.entities) {\n    const prevE = prevByEid.get(e.eid)\n    if (!prevE) {\n      changed.push(e)\n      continue\n    }\n    const prevSig = JSON.stringify(prevE.components)\n    const currSig = JSON.stringify(e.components)\n    if (prevSig !== currSig) changed.push(e)\n  }\n  return { version: curr.version, capacity: curr.capacity, entities: changed }\n}\n"]}

package/dist/commands.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkD4VGTV76_cjs=require('./chunk-D4VGTV76.cjs');function l(n){let e={worldId:chunkD4VGTV76_cjs.i(n).id,ops:[],nextPlaceholder:-1,flushing:false};return h(e)}function C(n){let o=y(n);if(!o.flushing){o.flushing=true;try{let e=B(o.worldId),r=new Map;for(let t of o.ops)t.kind==="create"&&r.set(t.placeholder,chunkD4VGTV76_cjs.u(e));let d=t=>{let a=t;if(a<0){let f=r.get(a);if(f===void 0)throw new Error(`aiecsjs: unresolved placeholder ${a}`);return f}return t};for(let t of o.ops)t.kind==="add"?chunkD4VGTV76_cjs.J(e,d(t.eid),t.component,t.initial):t.kind==="remove"&&chunkD4VGTV76_cjs.K(e,d(t.eid),t.component);for(let t of o.ops)t.kind==="destroy"&&chunkD4VGTV76_cjs.w(e,d(t.eid));o.ops.length=0,o.nextPlaceholder=-1;}finally{o.flushing=false;}}}function W(n,o){let e=l(n),r=o(e);return C(e),r}var p=new WeakMap;function h(n){let o={add(e,r,d){n.ops.push({kind:"add",eid:e,component:r,initial:d});},remove(e,r){n.ops.push({kind:"remove",eid:e,component:r});},destroy(e){n.ops.push({kind:"destroy",eid:e});},create(){let e=n.nextPlaceholder--;return n.ops.push({kind:"create",placeholder:e}),e}};return p.set(o,n),o}function y(n){let o=p.get(n);if(!o)throw new Error("aiecsjs: unknown CommandBuffer");return o}function B(n){let o=k(n);return {id:o.id,capacity:o.capacity,version:o.version}}function k(n){return chunkD4VGTV76_cjs.i({id:n,capacity:0,version:"0.0.0"})}exports.createCommandBuffer=l;exports.flush=C;exports.withCommandBuffer=W;//# sourceMappingURL=commands.cjs.map
+'use strict';var chunkM6L4SSE4_cjs=require('./chunk-M6L4SSE4.cjs');function l(n){let e={worldId:chunkM6L4SSE4_cjs.i(n).id,ops:[],nextPlaceholder:-1,flushing:false};return h(e)}function C(n){let o=y(n);if(!o.flushing){o.flushing=true;try{let e=B(o.worldId),r=new Map;for(let t of o.ops)t.kind==="create"&&r.set(t.placeholder,chunkM6L4SSE4_cjs.u(e));let d=t=>{let a=t;if(a<0){let f=r.get(a);if(f===void 0)throw new Error(`aiecsjs: unresolved placeholder ${a}`);return f}return t};for(let t of o.ops)t.kind==="add"?chunkM6L4SSE4_cjs.J(e,d(t.eid),t.component,t.initial):t.kind==="remove"&&chunkM6L4SSE4_cjs.K(e,d(t.eid),t.component);for(let t of o.ops)t.kind==="destroy"&&chunkM6L4SSE4_cjs.w(e,d(t.eid));o.ops.length=0,o.nextPlaceholder=-1;}finally{o.flushing=false;}}}function W(n,o){let e=l(n),r=o(e);return C(e),r}var p=new WeakMap;function h(n){let o={add(e,r,d){n.ops.push({kind:"add",eid:e,component:r,initial:d});},remove(e,r){n.ops.push({kind:"remove",eid:e,component:r});},destroy(e){n.ops.push({kind:"destroy",eid:e});},create(){let e=n.nextPlaceholder--;return n.ops.push({kind:"create",placeholder:e}),e}};return p.set(o,n),o}function y(n){let o=p.get(n);if(!o)throw new Error("aiecsjs: unknown CommandBuffer");return o}function B(n){let o=k(n);return {id:o.id,capacity:o.capacity,version:o.version}}function k(n){return chunkM6L4SSE4_cjs.i({id:n,capacity:0,version:"0.0.0"})}exports.createCommandBuffer=l;exports.flush=C;exports.withCommandBuffer=W;//# sourceMappingURL=commands.cjs.map
 //# sourceMappingURL=commands.cjs.map

package/dist/commands.js

@@ -1,2 +1,2 @@
-import {i,u,J,K,w}from'./chunk-UAJNL4VY.js';function l(n){let e={worldId:i(n).id,ops:[],nextPlaceholder:-1,flushing:false};return h(e)}function C(n){let o=y(n);if(!o.flushing){o.flushing=true;try{let e=B(o.worldId),r=new Map;for(let t of o.ops)t.kind==="create"&&r.set(t.placeholder,u(e));let d=t=>{let a=t;if(a<0){let f=r.get(a);if(f===void 0)throw new Error(`aiecsjs: unresolved placeholder ${a}`);return f}return t};for(let t of o.ops)t.kind==="add"?J(e,d(t.eid),t.component,t.initial):t.kind==="remove"&&K(e,d(t.eid),t.component);for(let t of o.ops)t.kind==="destroy"&&w(e,d(t.eid));o.ops.length=0,o.nextPlaceholder=-1;}finally{o.flushing=false;}}}function W(n,o){let e=l(n),r=o(e);return C(e),r}var p=new WeakMap;function h(n){let o={add(e,r,d){n.ops.push({kind:"add",eid:e,component:r,initial:d});},remove(e,r){n.ops.push({kind:"remove",eid:e,component:r});},destroy(e){n.ops.push({kind:"destroy",eid:e});},create(){let e=n.nextPlaceholder--;return n.ops.push({kind:"create",placeholder:e}),e}};return p.set(o,n),o}function y(n){let o=p.get(n);if(!o)throw new Error("aiecsjs: unknown CommandBuffer");return o}function B(n){let o=k(n);return {id:o.id,capacity:o.capacity,version:o.version}}function k(n){return i({id:n,capacity:0,version:"0.0.0"})}export{l as createCommandBuffer,C as flush,W as withCommandBuffer};//# sourceMappingURL=commands.js.map
+import {i,u,J,K,w}from'./chunk-ENULPSKV.js';function l(n){let e={worldId:i(n).id,ops:[],nextPlaceholder:-1,flushing:false};return h(e)}function C(n){let o=y(n);if(!o.flushing){o.flushing=true;try{let e=B(o.worldId),r=new Map;for(let t of o.ops)t.kind==="create"&&r.set(t.placeholder,u(e));let d=t=>{let a=t;if(a<0){let f=r.get(a);if(f===void 0)throw new Error(`aiecsjs: unresolved placeholder ${a}`);return f}return t};for(let t of o.ops)t.kind==="add"?J(e,d(t.eid),t.component,t.initial):t.kind==="remove"&&K(e,d(t.eid),t.component);for(let t of o.ops)t.kind==="destroy"&&w(e,d(t.eid));o.ops.length=0,o.nextPlaceholder=-1;}finally{o.flushing=false;}}}function W(n,o){let e=l(n),r=o(e);return C(e),r}var p=new WeakMap;function h(n){let o={add(e,r,d){n.ops.push({kind:"add",eid:e,component:r,initial:d});},remove(e,r){n.ops.push({kind:"remove",eid:e,component:r});},destroy(e){n.ops.push({kind:"destroy",eid:e});},create(){let e=n.nextPlaceholder--;return n.ops.push({kind:"create",placeholder:e}),e}};return p.set(o,n),o}function y(n){let o=p.get(n);if(!o)throw new Error("aiecsjs: unknown CommandBuffer");return o}function B(n){let o=k(n);return {id:o.id,capacity:o.capacity,version:o.version}}function k(n){return i({id:n,capacity:0,version:"0.0.0"})}export{l as createCommandBuffer,C as flush,W as withCommandBuffer};//# sourceMappingURL=commands.js.map
 //# sourceMappingURL=commands.js.map

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkNCYUF4YW_cjs=require('./chunk-NCYUF4YW.cjs'),chunkD4VGTV76_cjs=require('./chunk-D4VGTV76.cjs');var $={i8:"i8",u8:"u8",i16:"i16",u16:"u16",i32:"i32",u32:"u32",f32:"f32",f64:"f64",eid:"eid",bool:"bool"};function J(...n){return n.length===0?e=>e:n.length===1?n[0]:(e,r)=>{let t=e;for(let o of n)t=o(t,r);return t}}var i=class extends Error{eid;constructor(e){super(`aiecsjs: entity ${e} is not alive`),this.name="EntityNotAliveError",this.eid=e;}};function X(n,e){let r=chunkD4VGTV76_cjs.i(n);if(!chunkD4VGTV76_cjs.y(r,e))throw new i(e);return Object.freeze({id:e,worldId:r.id})}function b(n,e){let r=chunkD4VGTV76_cjs.i(n);if(e.worldId!==r.id)return null;let t=e.id,o=chunkD4VGTV76_cjs.s(t,r.options);if(o<=0||o>=r.capacity)return null;let x=r.entityArchetype[o]??0,d=r.archetypes[x];if(!d||!d.entityRow.has(e.id))return null;let C=r.generations[o]??0,A=chunkD4VGTV76_cjs.t(t,r.options);return C!==A?null:e.id}function Y(n,e){return b(n,e)!==null}chunkNCYUF4YW_cjs.j(n=>chunkD4VGTV76_cjs.Q(n));chunkD4VGTV76_cjs.O((n,e,r,t,o)=>{chunkNCYUF4YW_cjs.i(n,e,r,t,o);});var de=typeof SharedArrayBuffer<"u";Object.defineProperty(exports,"defineQuery",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.a}});Object.defineProperty(exports,"enterQuery",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.b}});Object.defineProperty(exports,"exitQuery",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.c}});Object.defineProperty(exports,"forEachEntity",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.g}});Object.defineProperty(exports,"forEachEntityIndexed",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.h}});Object.defineProperty(exports,"iterQuery",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.f}});Object.defineProperty(exports,"queryArchetypes",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.d}});Object.defineProperty(exports,"runQuery",{enumerable:true,get:function(){return chunkNCYUF4YW_cjs.e}});Object.defineProperty(exports,"VERSION",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.a}});Object.defineProperty(exports,"addComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.J}});Object.defineProperty(exports,"createEntity",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.u}});Object.defineProperty(exports,"createWorld",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.k}});Object.defineProperty(exports,"defineComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.F}});Object.defineProperty(exports,"defineObjectComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.H}});Object.defineProperty(exports,"defineTag",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.G}});Object.defineProperty(exports,"destroyEntity",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.w}});Object.defineProperty(exports,"destroyWorld",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.l}});Object.defineProperty(exports,"disposeWorld",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.l}});Object.defineProperty(exports,"entityExists",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.x}});Object.defineProperty(exports,"getComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.M}});Object.defineProperty(exports,"getEntityGeneration",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.A}});Object.defineProperty(exports,"getEntityIndex",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.z}});Object.defineProperty(exports,"getWorldCapacity",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.o}});Object.defineProperty(exports,"getWorldSize",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.n}});Object.defineProperty(exports,"hasComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.L}});Object.defineProperty(exports,"isEntity",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.C}});Object.defineProperty(exports,"isWorld",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.q}});Object.defineProperty(exports,"packEntity",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.B}});Object.defineProperty(exports,"removeComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.K}});Object.defineProperty(exports,"resetWorld",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.m}});Object.defineProperty(exports,"setComponent",{enumerable:true,get:function(){return chunkD4VGTV76_cjs.N}});exports.EntityNotAliveError=i;exports.IS_SAB_SUPPORTED=de;exports.Types=$;exports.aliveRef=Y;exports.deref=b;exports.pipe=J;exports.refOf=X;//# sourceMappingURL=index.cjs.map
+'use strict';var chunkO5OK5TLX_cjs=require('./chunk-O5OK5TLX.cjs'),chunkM6L4SSE4_cjs=require('./chunk-M6L4SSE4.cjs');var $={i8:"i8",u8:"u8",i16:"i16",u16:"u16",i32:"i32",u32:"u32",f32:"f32",f64:"f64",eid:"eid",bool:"bool"};function J(...n){return n.length===0?e=>e:n.length===1?n[0]:(e,r)=>{let t=e;for(let o of n)t=o(t,r);return t}}var i=class extends Error{eid;constructor(e){super(`aiecsjs: entity ${e} is not alive`),this.name="EntityNotAliveError",this.eid=e;}};function X(n,e){let r=chunkM6L4SSE4_cjs.i(n);if(!chunkM6L4SSE4_cjs.y(r,e))throw new i(e);return Object.freeze({id:e,worldId:r.id})}function b(n,e){let r=chunkM6L4SSE4_cjs.i(n);if(e.worldId!==r.id)return null;let t=e.id,o=chunkM6L4SSE4_cjs.s(t,r.options);if(o<=0||o>=r.capacity)return null;let x=r.entityArchetype[o]??0,d=r.archetypes[x];if(!d||!d.entityRow.has(e.id))return null;let C=r.generations[o]??0,A=chunkM6L4SSE4_cjs.t(t,r.options);return C!==A?null:e.id}function Y(n,e){return b(n,e)!==null}chunkO5OK5TLX_cjs.j(n=>chunkM6L4SSE4_cjs.Q(n));chunkM6L4SSE4_cjs.O((n,e,r,t,o)=>{chunkO5OK5TLX_cjs.i(n,e,r,t,o);});var de=typeof SharedArrayBuffer<"u";Object.defineProperty(exports,"defineQuery",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.a}});Object.defineProperty(exports,"enterQuery",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.b}});Object.defineProperty(exports,"exitQuery",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.c}});Object.defineProperty(exports,"forEachEntity",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.g}});Object.defineProperty(exports,"forEachEntityIndexed",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.h}});Object.defineProperty(exports,"iterQuery",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.f}});Object.defineProperty(exports,"queryArchetypes",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.d}});Object.defineProperty(exports,"runQuery",{enumerable:true,get:function(){return chunkO5OK5TLX_cjs.e}});Object.defineProperty(exports,"VERSION",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.a}});Object.defineProperty(exports,"addComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.J}});Object.defineProperty(exports,"createEntity",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.u}});Object.defineProperty(exports,"createWorld",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.k}});Object.defineProperty(exports,"defineComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.F}});Object.defineProperty(exports,"defineObjectComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.H}});Object.defineProperty(exports,"defineTag",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.G}});Object.defineProperty(exports,"destroyEntity",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.w}});Object.defineProperty(exports,"destroyWorld",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.l}});Object.defineProperty(exports,"disposeWorld",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.l}});Object.defineProperty(exports,"entityExists",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.x}});Object.defineProperty(exports,"getComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.M}});Object.defineProperty(exports,"getEntityGeneration",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.A}});Object.defineProperty(exports,"getEntityIndex",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.z}});Object.defineProperty(exports,"getWorldCapacity",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.o}});Object.defineProperty(exports,"getWorldSize",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.n}});Object.defineProperty(exports,"hasComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.L}});Object.defineProperty(exports,"isEntity",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.C}});Object.defineProperty(exports,"isWorld",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.q}});Object.defineProperty(exports,"packEntity",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.B}});Object.defineProperty(exports,"removeComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.K}});Object.defineProperty(exports,"resetWorld",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.m}});Object.defineProperty(exports,"setComponent",{enumerable:true,get:function(){return chunkM6L4SSE4_cjs.N}});exports.EntityNotAliveError=i;exports.IS_SAB_SUPPORTED=de;exports.Types=$;exports.aliveRef=Y;exports.deref=b;exports.pipe=J;exports.refOf=X;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { o as WorldOptions, W as World, E as EntityId, c as ComponentLike, b as ComponentInit, k as SoASchema, h as SoAComponent, A as AoSComponent, T as TagComponent, f as QueryDescriptor, Q as Query, a as Archetype, l as System } from './types-BGEeHad-.cjs';
 export { d as ComponentView, g as SoAColumns, i as SoAFieldDecl, j as SoAFieldType, n as Types } from './types-BGEeHad-.cjs';
 
-declare const VERSION = "0.5.3";
+declare const VERSION = "0.5.5";
 
 declare function createWorld(options?: WorldOptions): World;
 declare function destroyWorld(world: World): void;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { o as WorldOptions, W as World, E as EntityId, c as ComponentLike, b as ComponentInit, k as SoASchema, h as SoAComponent, A as AoSComponent, T as TagComponent, f as QueryDescriptor, Q as Query, a as Archetype, l as System } from './types-BGEeHad-.js';
 export { d as ComponentView, g as SoAColumns, i as SoAFieldDecl, j as SoAFieldType, n as Types } from './types-BGEeHad-.js';
 
-declare const VERSION = "0.5.3";
+declare const VERSION = "0.5.5";
 
 declare function createWorld(options?: WorldOptions): World;
 declare function destroyWorld(world: World): void;

package/dist/index.js

@@ -1,2 +1,2 @@
-import {j,i as i$1}from'./chunk-COORLIYF.js';export{a as defineQuery,b as enterQuery,c as exitQuery,g as forEachEntity,h as forEachEntityIndexed,f as iterQuery,d as queryArchetypes,e as runQuery}from'./chunk-COORLIYF.js';import {Q,O,i as i$2,y,s,t}from'./chunk-UAJNL4VY.js';export{a as VERSION,J as addComponent,u as createEntity,k as createWorld,F as defineComponent,H as defineObjectComponent,G as defineTag,w as destroyEntity,l as destroyWorld,l as disposeWorld,x as entityExists,M as getComponent,A as getEntityGeneration,z as getEntityIndex,o as getWorldCapacity,n as getWorldSize,L as hasComponent,C as isEntity,q as isWorld,B as packEntity,K as removeComponent,m as resetWorld,N as setComponent}from'./chunk-UAJNL4VY.js';var $={i8:"i8",u8:"u8",i16:"i16",u16:"u16",i32:"i32",u32:"u32",f32:"f32",f64:"f64",eid:"eid",bool:"bool"};function J(...n){return n.length===0?e=>e:n.length===1?n[0]:(e,r)=>{let t=e;for(let o of n)t=o(t,r);return t}}var i=class extends Error{eid;constructor(e){super(`aiecsjs: entity ${e} is not alive`),this.name="EntityNotAliveError",this.eid=e;}};function X(n,e){let r=i$2(n);if(!y(r,e))throw new i(e);return Object.freeze({id:e,worldId:r.id})}function b(n,e){let r=i$2(n);if(e.worldId!==r.id)return null;let t$1=e.id,o=s(t$1,r.options);if(o<=0||o>=r.capacity)return null;let x=r.entityArchetype[o]??0,d=r.archetypes[x];if(!d||!d.entityRow.has(e.id))return null;let C=r.generations[o]??0,A=t(t$1,r.options);return C!==A?null:e.id}function Y(n,e){return b(n,e)!==null}j(n=>Q(n));O((n,e,r,t,o)=>{i$1(n,e,r,t,o);});var de=typeof SharedArrayBuffer<"u";export{i as EntityNotAliveError,de as IS_SAB_SUPPORTED,$ as Types,Y as aliveRef,b as deref,J as pipe,X as refOf};//# sourceMappingURL=index.js.map
+import {j,i as i$1}from'./chunk-EVPXWN4C.js';export{a as defineQuery,b as enterQuery,c as exitQuery,g as forEachEntity,h as forEachEntityIndexed,f as iterQuery,d as queryArchetypes,e as runQuery}from'./chunk-EVPXWN4C.js';import {Q,O,i as i$2,y,s,t}from'./chunk-ENULPSKV.js';export{a as VERSION,J as addComponent,u as createEntity,k as createWorld,F as defineComponent,H as defineObjectComponent,G as defineTag,w as destroyEntity,l as destroyWorld,l as disposeWorld,x as entityExists,M as getComponent,A as getEntityGeneration,z as getEntityIndex,o as getWorldCapacity,n as getWorldSize,L as hasComponent,C as isEntity,q as isWorld,B as packEntity,K as removeComponent,m as resetWorld,N as setComponent}from'./chunk-ENULPSKV.js';var $={i8:"i8",u8:"u8",i16:"i16",u16:"u16",i32:"i32",u32:"u32",f32:"f32",f64:"f64",eid:"eid",bool:"bool"};function J(...n){return n.length===0?e=>e:n.length===1?n[0]:(e,r)=>{let t=e;for(let o of n)t=o(t,r);return t}}var i=class extends Error{eid;constructor(e){super(`aiecsjs: entity ${e} is not alive`),this.name="EntityNotAliveError",this.eid=e;}};function X(n,e){let r=i$2(n);if(!y(r,e))throw new i(e);return Object.freeze({id:e,worldId:r.id})}function b(n,e){let r=i$2(n);if(e.worldId!==r.id)return null;let t$1=e.id,o=s(t$1,r.options);if(o<=0||o>=r.capacity)return null;let x=r.entityArchetype[o]??0,d=r.archetypes[x];if(!d||!d.entityRow.has(e.id))return null;let C=r.generations[o]??0,A=t(t$1,r.options);return C!==A?null:e.id}function Y(n,e){return b(n,e)!==null}j(n=>Q(n));O((n,e,r,t,o)=>{i$1(n,e,r,t,o);});var de=typeof SharedArrayBuffer<"u";export{i as EntityNotAliveError,de as IS_SAB_SUPPORTED,$ as Types,Y as aliveRef,b as deref,J as pipe,X as refOf};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/observers.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkNCYUF4YW_cjs=require('./chunk-NCYUF4YW.cjs'),chunkD4VGTV76_cjs=require('./chunk-D4VGTV76.cjs');function f(n,e){if(!e)return n;if(e.aborted)return n(),()=>{};let o=()=>{n();};e.addEventListener("abort",o,{once:true});let t=false;return ()=>{t||(t=true,e.removeEventListener("abort",o),n());}}function w(n,e,o,t){return f(b(n,e,"add",o),t?.signal)}function x(n,e,o,t){return f(b(n,e,"remove",o),t?.signal)}function C(n,e,o,t){return f(b(n,e,"set",o),t?.signal)}function L(n,e,o,t,r){let s=chunkD4VGTV76_cjs.i(n);chunkNCYUF4YW_cjs.e(n,e);let i={event:o,componentBit:-1,queryId:e.id,handler:t};return s.observers.push(i),f(()=>{let d=s.observers.indexOf(i);d>=0&&s.observers.splice(d,1);},r?.signal)}function b(n,e,o,t){let r=chunkD4VGTV76_cjs.i(n),s=chunkD4VGTV76_cjs.I(e),i=r.componentBitFor.get(s.id);i===void 0&&(i=chunkD4VGTV76_cjs.p(r,s));let u={event:o,componentBit:i,queryId:-1,handler:t};return r.observers.push(u),()=>{let d=r.observers.indexOf(u);d>=0&&r.observers.splice(d,1);}}function E(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="add"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"add");}function M(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="remove"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"remove");}function g(n,e,o,t){let r=Array.from(n.observers);for(let s of r)s.event==="set"&&n.observers.includes(s)&&(s.componentBit===o||s.queryId!==-1&&n.queries[s.queryId]?.all.includes(n.componentInfoByBit[o]?.id??-1))&&s.handler(e,t);}function O(n,e,o,t,r){let s=n.options.maskWordCount,i=(e&n.options.indexMask)*s,u=Array.from(n.observers);for(let d of u){if(d.event!==o||d.queryId===-1||!n.observers.includes(d))continue;let c=n.queryMasks.get(d.queryId);if(!c)continue;let l=chunkD4VGTV76_cjs.h(n.entityMask,i,s,c.withMask,c.anyMask,c.noneMask,c.anyHasBits);o==="add"&&l&&d.handler(e),o==="remove"&&!l&&d.handler(e);}}chunkD4VGTV76_cjs.P({fireAdd:E,fireRemove:M,fireSet:g});chunkD4VGTV76_cjs.D({dispatchDestroyObservers(n,e){let o=n.options.maskWordCount,t=(e&n.options.indexMask)*o,r=new Uint32Array(o);for(let i=0;i<o;i++)r[i]=n.entityMask[t+i]??0;chunkD4VGTV76_cjs.g(r,0,o,i=>{let u=Array.from(n.observers);for(let d of u)d.event==="remove"&&d.componentBit===i&&n.observers.includes(d)&&d.handler(e);});let s=Array.from(n.observers);for(let i of s){if(i.event!=="remove"||i.queryId===-1||!n.observers.includes(i))continue;let u=n.queryMasks.get(i.queryId);if(!u)continue;chunkD4VGTV76_cjs.h(r,0,o,u.withMask,u.anyMask,u.noneMask,u.anyHasBits)&&i.handler(e);}}});exports.observe=L;exports.onAdd=w;exports.onRemove=x;exports.onSet=C;//# sourceMappingURL=observers.cjs.map
+'use strict';var chunkO5OK5TLX_cjs=require('./chunk-O5OK5TLX.cjs'),chunkM6L4SSE4_cjs=require('./chunk-M6L4SSE4.cjs');function f(n,e){if(!e)return n;if(e.aborted)return n(),()=>{};let o=()=>{n();};e.addEventListener("abort",o,{once:true});let t=false;return ()=>{t||(t=true,e.removeEventListener("abort",o),n());}}function w(n,e,o,t){return f(b(n,e,"add",o),t?.signal)}function x(n,e,o,t){return f(b(n,e,"remove",o),t?.signal)}function C(n,e,o,t){return f(b(n,e,"set",o),t?.signal)}function L(n,e,o,t,r){let s=chunkM6L4SSE4_cjs.i(n);chunkO5OK5TLX_cjs.e(n,e);let i={event:o,componentBit:-1,queryId:e.id,handler:t};return s.observers.push(i),f(()=>{let d=s.observers.indexOf(i);d>=0&&s.observers.splice(d,1);},r?.signal)}function b(n,e,o,t){let r=chunkM6L4SSE4_cjs.i(n),s=chunkM6L4SSE4_cjs.I(e),i=r.componentBitFor.get(s.id);i===void 0&&(i=chunkM6L4SSE4_cjs.p(r,s));let u={event:o,componentBit:i,queryId:-1,handler:t};return r.observers.push(u),()=>{let d=r.observers.indexOf(u);d>=0&&r.observers.splice(d,1);}}function E(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="add"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"add");}function M(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="remove"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"remove");}function g(n,e,o,t){let r=Array.from(n.observers);for(let s of r)s.event==="set"&&n.observers.includes(s)&&(s.componentBit===o||s.queryId!==-1&&n.queries[s.queryId]?.all.includes(n.componentInfoByBit[o]?.id??-1))&&s.handler(e,t);}function O(n,e,o,t,r){let s=n.options.maskWordCount,i=(e&n.options.indexMask)*s,u=Array.from(n.observers);for(let d of u){if(d.event!==o||d.queryId===-1||!n.observers.includes(d))continue;let c=n.queryMasks.get(d.queryId);if(!c)continue;let l=chunkM6L4SSE4_cjs.h(n.entityMask,i,s,c.withMask,c.anyMask,c.noneMask,c.anyHasBits);o==="add"&&l&&d.handler(e),o==="remove"&&!l&&d.handler(e);}}chunkM6L4SSE4_cjs.P({fireAdd:E,fireRemove:M,fireSet:g});chunkM6L4SSE4_cjs.D({dispatchDestroyObservers(n,e){let o=n.options.maskWordCount,t=(e&n.options.indexMask)*o,r=new Uint32Array(o);for(let i=0;i<o;i++)r[i]=n.entityMask[t+i]??0;chunkM6L4SSE4_cjs.g(r,0,o,i=>{let u=Array.from(n.observers);for(let d of u)d.event==="remove"&&d.componentBit===i&&n.observers.includes(d)&&d.handler(e);});let s=Array.from(n.observers);for(let i of s){if(i.event!=="remove"||i.queryId===-1||!n.observers.includes(i))continue;let u=n.queryMasks.get(i.queryId);if(!u)continue;chunkM6L4SSE4_cjs.h(r,0,o,u.withMask,u.anyMask,u.noneMask,u.anyHasBits)&&i.handler(e);}}});exports.observe=L;exports.onAdd=w;exports.onRemove=x;exports.onSet=C;//# sourceMappingURL=observers.cjs.map
 //# sourceMappingURL=observers.cjs.map

package/dist/observers.js

@@ -1,2 +1,2 @@
-import {e}from'./chunk-COORLIYF.js';import {P,D,g as g$1,h,i,I,p}from'./chunk-UAJNL4VY.js';function f(n,e){if(!e)return n;if(e.aborted)return n(),()=>{};let o=()=>{n();};e.addEventListener("abort",o,{once:true});let t=false;return ()=>{t||(t=true,e.removeEventListener("abort",o),n());}}function w(n,e,o,t){return f(b(n,e,"add",o),t?.signal)}function x(n,e,o,t){return f(b(n,e,"remove",o),t?.signal)}function C(n,e,o,t){return f(b(n,e,"set",o),t?.signal)}function L(n,e$1,o,t,r){let s=i(n);e(n,e$1);let i$1={event:o,componentBit:-1,queryId:e$1.id,handler:t};return s.observers.push(i$1),f(()=>{let d=s.observers.indexOf(i$1);d>=0&&s.observers.splice(d,1);},r?.signal)}function b(n,e,o,t){let r=i(n),s=I(e),i$1=r.componentBitFor.get(s.id);i$1===void 0&&(i$1=p(r,s));let u={event:o,componentBit:i$1,queryId:-1,handler:t};return r.observers.push(u),()=>{let d=r.observers.indexOf(u);d>=0&&r.observers.splice(d,1);}}function E(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="add"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"add");}function M(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="remove"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"remove");}function g(n,e,o,t){let r=Array.from(n.observers);for(let s of r)s.event==="set"&&n.observers.includes(s)&&(s.componentBit===o||s.queryId!==-1&&n.queries[s.queryId]?.all.includes(n.componentInfoByBit[o]?.id??-1))&&s.handler(e,t);}function O(n,e,o,t,r){let s=n.options.maskWordCount,i=(e&n.options.indexMask)*s,u=Array.from(n.observers);for(let d of u){if(d.event!==o||d.queryId===-1||!n.observers.includes(d))continue;let c=n.queryMasks.get(d.queryId);if(!c)continue;let l=h(n.entityMask,i,s,c.withMask,c.anyMask,c.noneMask,c.anyHasBits);o==="add"&&l&&d.handler(e),o==="remove"&&!l&&d.handler(e);}}P({fireAdd:E,fireRemove:M,fireSet:g});D({dispatchDestroyObservers(n,e){let o=n.options.maskWordCount,t=(e&n.options.indexMask)*o,r=new Uint32Array(o);for(let i=0;i<o;i++)r[i]=n.entityMask[t+i]??0;g$1(r,0,o,i=>{let u=Array.from(n.observers);for(let d of u)d.event==="remove"&&d.componentBit===i&&n.observers.includes(d)&&d.handler(e);});let s=Array.from(n.observers);for(let i of s){if(i.event!=="remove"||i.queryId===-1||!n.observers.includes(i))continue;let u=n.queryMasks.get(i.queryId);if(!u)continue;h(r,0,o,u.withMask,u.anyMask,u.noneMask,u.anyHasBits)&&i.handler(e);}}});export{L as observe,w as onAdd,x as onRemove,C as onSet};//# sourceMappingURL=observers.js.map
+import {e}from'./chunk-EVPXWN4C.js';import {P,D,g as g$1,h,i,I,p}from'./chunk-ENULPSKV.js';function f(n,e){if(!e)return n;if(e.aborted)return n(),()=>{};let o=()=>{n();};e.addEventListener("abort",o,{once:true});let t=false;return ()=>{t||(t=true,e.removeEventListener("abort",o),n());}}function w(n,e,o,t){return f(b(n,e,"add",o),t?.signal)}function x(n,e,o,t){return f(b(n,e,"remove",o),t?.signal)}function C(n,e,o,t){return f(b(n,e,"set",o),t?.signal)}function L(n,e$1,o,t,r){let s=i(n);e(n,e$1);let i$1={event:o,componentBit:-1,queryId:e$1.id,handler:t};return s.observers.push(i$1),f(()=>{let d=s.observers.indexOf(i$1);d>=0&&s.observers.splice(d,1);},r?.signal)}function b(n,e,o,t){let r=i(n),s=I(e),i$1=r.componentBitFor.get(s.id);i$1===void 0&&(i$1=p(r,s));let u={event:o,componentBit:i$1,queryId:-1,handler:t};return r.observers.push(u),()=>{let d=r.observers.indexOf(u);d>=0&&r.observers.splice(d,1);}}function E(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="add"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"add");}function M(n,e,o){let t=Array.from(n.observers);for(let r of t)r.event==="remove"&&r.componentBit===o&&n.observers.includes(r)&&r.handler(e);O(n,e,"remove");}function g(n,e,o,t){let r=Array.from(n.observers);for(let s of r)s.event==="set"&&n.observers.includes(s)&&(s.componentBit===o||s.queryId!==-1&&n.queries[s.queryId]?.all.includes(n.componentInfoByBit[o]?.id??-1))&&s.handler(e,t);}function O(n,e,o,t,r){let s=n.options.maskWordCount,i=(e&n.options.indexMask)*s,u=Array.from(n.observers);for(let d of u){if(d.event!==o||d.queryId===-1||!n.observers.includes(d))continue;let c=n.queryMasks.get(d.queryId);if(!c)continue;let l=h(n.entityMask,i,s,c.withMask,c.anyMask,c.noneMask,c.anyHasBits);o==="add"&&l&&d.handler(e),o==="remove"&&!l&&d.handler(e);}}P({fireAdd:E,fireRemove:M,fireSet:g});D({dispatchDestroyObservers(n,e){let o=n.options.maskWordCount,t=(e&n.options.indexMask)*o,r=new Uint32Array(o);for(let i=0;i<o;i++)r[i]=n.entityMask[t+i]??0;g$1(r,0,o,i=>{let u=Array.from(n.observers);for(let d of u)d.event==="remove"&&d.componentBit===i&&n.observers.includes(d)&&d.handler(e);});let s=Array.from(n.observers);for(let i of s){if(i.event!=="remove"||i.queryId===-1||!n.observers.includes(i))continue;let u=n.queryMasks.get(i.queryId);if(!u)continue;h(r,0,o,u.withMask,u.anyMask,u.noneMask,u.anyHasBits)&&i.handler(e);}}});export{L as observe,w as onAdd,x as onRemove,C as onSet};//# sourceMappingURL=observers.js.map
 //# sourceMappingURL=observers.js.map

package/dist/relations.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkD4VGTV76_cjs=require('./chunk-D4VGTV76.cjs');var x=1;function p(r){return {__kind:"relation",__id:x++,__exclusive:r?.exclusive??false,__hasData:false}}var _=p({exclusive:true});function v(r,l){let s=r.relationStorage.get(l.__id);return s||(s={rel:l,exclusive:l.__exclusive?new Int32Array(r.capacity).fill(-1):null,outgoing:new Map,data:new Map},r.relationStorage.set(l.__id,s),s)}function R(r,l,s,i,n){let t=chunkD4VGTV76_cjs.i(r);if(t.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let e=v(t,s),o=l&t.options.indexMask,d=i&t.options.indexMask;if(e.exclusive){if(o>=e.exclusive.length){let c=new Int32Array(Math.max(o+1,e.exclusive.length*2)).fill(-1);c.set(e.exclusive),e.exclusive=c;}let a=e.exclusive[o]??-1;if(a>=0&&a!==d){let c=e.data.get(o);c?.delete(a),c&&c.size===0&&e.data.delete(o);}e.exclusive[o]=d;}else {let a=e.outgoing.get(o);a||(a=[],e.outgoing.set(o,a)),a.includes(d)||a.push(d);}if(n!==void 0){let a=e.data.get(o);a||(a=new Map,e.data.set(o,a)),a.set(d,n);}}function b(r,l,s,i){let n=chunkD4VGTV76_cjs.i(r);if(n.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i&n.options.indexMask;if(t.exclusive)e<t.exclusive.length&&t.exclusive[e]===o&&(t.exclusive[e]=-1);else {let a=t.outgoing.get(e);if(a){let c=a.indexOf(o);c>=0&&a.splice(c,1),a.length===0&&t.outgoing.delete(e);}}let d=t.data.get(e);d&&(d.delete(o),d.size===0&&t.data.delete(e));}function h(r,l,s){let i=chunkD4VGTV76_cjs.i(r),n=i.relationStorage.get(s.__id);if(!n)return [];let t=l&i.options.indexMask;if(n.exclusive){if(t<n.exclusive.length){let o=n.exclusive[t]??-1;if(o>=0){let d=i.generations[o]??0;return [chunkD4VGTV76_cjs.r(o,d,i.options)]}}return []}let e=n.outgoing.get(t);return e?e.map(o=>{let d=i.generations[o]??0;return chunkD4VGTV76_cjs.r(o,d,i.options)}):[]}function w(r,l,s,i){let n=chunkD4VGTV76_cjs.i(r),t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i&n.options.indexMask;return t.data.get(e)?.get(o)}chunkD4VGTV76_cjs.E((r,l)=>{let s=l&r.options.indexMask;for(let i of r.relationStorage.values()){if(i.exclusive){s<i.exclusive.length&&(i.exclusive[s]=-1);for(let n=0;n<i.exclusive.length;n++)i.exclusive[n]===s&&(i.exclusive[n]=-1);}i.outgoing.delete(s);for(let[n,t]of i.outgoing){let e=t.indexOf(s);e>=0&&(t.splice(e,1),t.length===0&&i.outgoing.delete(n));}i.data.delete(s);for(let[n,t]of i.data)t.delete(s),t.size===0&&i.data.delete(n);}});exports.ChildOf=_;exports.addRelation=R;exports.defineRelation=p;exports.getRelationData=w;exports.getRelationTargets=h;exports.removeRelation=b;//# sourceMappingURL=relations.cjs.map
+'use strict';var chunkM6L4SSE4_cjs=require('./chunk-M6L4SSE4.cjs');var x=1;function p(r){return {__kind:"relation",__id:x++,__exclusive:r?.exclusive??false,__hasData:false}}var _=p({exclusive:true});function v(r,l){let s=r.relationStorage.get(l.__id);return s||(s={rel:l,exclusive:l.__exclusive?new Int32Array(r.capacity).fill(-1):null,outgoing:new Map,data:new Map},r.relationStorage.set(l.__id,s),s)}function R(r,l,s,i,n){let t=chunkM6L4SSE4_cjs.i(r);if(t.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let e=v(t,s),o=l&t.options.indexMask,d=i&t.options.indexMask;if(e.exclusive){if(o>=e.exclusive.length){let c=new Int32Array(Math.max(o+1,e.exclusive.length*2)).fill(-1);c.set(e.exclusive),e.exclusive=c;}let a=e.exclusive[o]??-1;if(a>=0&&a!==d){let c=e.data.get(o);c?.delete(a),c&&c.size===0&&e.data.delete(o);}e.exclusive[o]=d;}else {let a=e.outgoing.get(o);a||(a=[],e.outgoing.set(o,a)),a.includes(d)||a.push(d);}if(n!==void 0){let a=e.data.get(o);a||(a=new Map,e.data.set(o,a)),a.set(d,n);}}function b(r,l,s,i){let n=chunkM6L4SSE4_cjs.i(r);if(n.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i&n.options.indexMask;if(t.exclusive)e<t.exclusive.length&&t.exclusive[e]===o&&(t.exclusive[e]=-1);else {let a=t.outgoing.get(e);if(a){let c=a.indexOf(o);c>=0&&a.splice(c,1),a.length===0&&t.outgoing.delete(e);}}let d=t.data.get(e);d&&(d.delete(o),d.size===0&&t.data.delete(e));}function h(r,l,s){let i=chunkM6L4SSE4_cjs.i(r),n=i.relationStorage.get(s.__id);if(!n)return [];let t=l&i.options.indexMask;if(n.exclusive){if(t<n.exclusive.length){let o=n.exclusive[t]??-1;if(o>=0){let d=i.generations[o]??0;return [chunkM6L4SSE4_cjs.r(o,d,i.options)]}}return []}let e=n.outgoing.get(t);return e?e.map(o=>{let d=i.generations[o]??0;return chunkM6L4SSE4_cjs.r(o,d,i.options)}):[]}function w(r,l,s,i){let n=chunkM6L4SSE4_cjs.i(r),t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i&n.options.indexMask;return t.data.get(e)?.get(o)}chunkM6L4SSE4_cjs.E((r,l)=>{let s=l&r.options.indexMask;for(let i of r.relationStorage.values()){if(i.exclusive){s<i.exclusive.length&&(i.exclusive[s]=-1);for(let n=0;n<i.exclusive.length;n++)i.exclusive[n]===s&&(i.exclusive[n]=-1);}i.outgoing.delete(s);for(let[n,t]of i.outgoing){let e=t.indexOf(s);e>=0&&(t.splice(e,1),t.length===0&&i.outgoing.delete(n));}i.data.delete(s);for(let[n,t]of i.data)t.delete(s),t.size===0&&i.data.delete(n);}});exports.ChildOf=_;exports.addRelation=R;exports.defineRelation=p;exports.getRelationData=w;exports.getRelationTargets=h;exports.removeRelation=b;//# sourceMappingURL=relations.cjs.map
 //# sourceMappingURL=relations.cjs.map

package/dist/relations.js

@@ -1,2 +1,2 @@
-import {E,i,r}from'./chunk-UAJNL4VY.js';var x=1;function p(r){return {__kind:"relation",__id:x++,__exclusive:r?.exclusive??false,__hasData:false}}var _=p({exclusive:true});function v(r,l){let s=r.relationStorage.get(l.__id);return s||(s={rel:l,exclusive:l.__exclusive?new Int32Array(r.capacity).fill(-1):null,outgoing:new Map,data:new Map},r.relationStorage.set(l.__id,s),s)}function R(r,l,s,i$1,n){let t=i(r);if(t.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let e=v(t,s),o=l&t.options.indexMask,d=i$1&t.options.indexMask;if(e.exclusive){if(o>=e.exclusive.length){let c=new Int32Array(Math.max(o+1,e.exclusive.length*2)).fill(-1);c.set(e.exclusive),e.exclusive=c;}let a=e.exclusive[o]??-1;if(a>=0&&a!==d){let c=e.data.get(o);c?.delete(a),c&&c.size===0&&e.data.delete(o);}e.exclusive[o]=d;}else {let a=e.outgoing.get(o);a||(a=[],e.outgoing.set(o,a)),a.includes(d)||a.push(d);}if(n!==void 0){let a=e.data.get(o);a||(a=new Map,e.data.set(o,a)),a.set(d,n);}}function b(r,l,s,i$1){let n=i(r);if(n.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i$1&n.options.indexMask;if(t.exclusive)e<t.exclusive.length&&t.exclusive[e]===o&&(t.exclusive[e]=-1);else {let a=t.outgoing.get(e);if(a){let c=a.indexOf(o);c>=0&&a.splice(c,1),a.length===0&&t.outgoing.delete(e);}}let d=t.data.get(e);d&&(d.delete(o),d.size===0&&t.data.delete(e));}function h(r$1,l,s){let i$1=i(r$1),n=i$1.relationStorage.get(s.__id);if(!n)return [];let t=l&i$1.options.indexMask;if(n.exclusive){if(t<n.exclusive.length){let o=n.exclusive[t]??-1;if(o>=0){let d=i$1.generations[o]??0;return [r(o,d,i$1.options)]}}return []}let e=n.outgoing.get(t);return e?e.map(o=>{let d=i$1.generations[o]??0;return r(o,d,i$1.options)}):[]}function w(r,l,s,i$1){let n=i(r),t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i$1&n.options.indexMask;return t.data.get(e)?.get(o)}E((r,l)=>{let s=l&r.options.indexMask;for(let i of r.relationStorage.values()){if(i.exclusive){s<i.exclusive.length&&(i.exclusive[s]=-1);for(let n=0;n<i.exclusive.length;n++)i.exclusive[n]===s&&(i.exclusive[n]=-1);}i.outgoing.delete(s);for(let[n,t]of i.outgoing){let e=t.indexOf(s);e>=0&&(t.splice(e,1),t.length===0&&i.outgoing.delete(n));}i.data.delete(s);for(let[n,t]of i.data)t.delete(s),t.size===0&&i.data.delete(n);}});export{_ as ChildOf,R as addRelation,p as defineRelation,w as getRelationData,h as getRelationTargets,b as removeRelation};//# sourceMappingURL=relations.js.map
+import {E,i,r}from'./chunk-ENULPSKV.js';var x=1;function p(r){return {__kind:"relation",__id:x++,__exclusive:r?.exclusive??false,__hasData:false}}var _=p({exclusive:true});function v(r,l){let s=r.relationStorage.get(l.__id);return s||(s={rel:l,exclusive:l.__exclusive?new Int32Array(r.capacity).fill(-1):null,outgoing:new Map,data:new Map},r.relationStorage.set(l.__id,s),s)}function R(r,l,s,i$1,n){let t=i(r);if(t.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let e=v(t,s),o=l&t.options.indexMask,d=i$1&t.options.indexMask;if(e.exclusive){if(o>=e.exclusive.length){let c=new Int32Array(Math.max(o+1,e.exclusive.length*2)).fill(-1);c.set(e.exclusive),e.exclusive=c;}let a=e.exclusive[o]??-1;if(a>=0&&a!==d){let c=e.data.get(o);c?.delete(a),c&&c.size===0&&e.data.delete(o);}e.exclusive[o]=d;}else {let a=e.outgoing.get(o);a||(a=[],e.outgoing.set(o,a)),a.includes(d)||a.push(d);}if(n!==void 0){let a=e.data.get(o);a||(a=new Map,e.data.set(o,a)),a.set(d,n);}}function b(r,l,s,i$1){let n=i(r);if(n.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");let t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i$1&n.options.indexMask;if(t.exclusive)e<t.exclusive.length&&t.exclusive[e]===o&&(t.exclusive[e]=-1);else {let a=t.outgoing.get(e);if(a){let c=a.indexOf(o);c>=0&&a.splice(c,1),a.length===0&&t.outgoing.delete(e);}}let d=t.data.get(e);d&&(d.delete(o),d.size===0&&t.data.delete(e));}function h(r$1,l,s){let i$1=i(r$1),n=i$1.relationStorage.get(s.__id);if(!n)return [];let t=l&i$1.options.indexMask;if(n.exclusive){if(t<n.exclusive.length){let o=n.exclusive[t]??-1;if(o>=0){let d=i$1.generations[o]??0;return [r(o,d,i$1.options)]}}return []}let e=n.outgoing.get(t);return e?e.map(o=>{let d=i$1.generations[o]??0;return r(o,d,i$1.options)}):[]}function w(r,l,s,i$1){let n=i(r),t=n.relationStorage.get(s.__id);if(!t)return;let e=l&n.options.indexMask,o=i$1&n.options.indexMask;return t.data.get(e)?.get(o)}E((r,l)=>{let s=l&r.options.indexMask;for(let i of r.relationStorage.values()){if(i.exclusive){s<i.exclusive.length&&(i.exclusive[s]=-1);for(let n=0;n<i.exclusive.length;n++)i.exclusive[n]===s&&(i.exclusive[n]=-1);}i.outgoing.delete(s);for(let[n,t]of i.outgoing){let e=t.indexOf(s);e>=0&&(t.splice(e,1),t.length===0&&i.outgoing.delete(n));}i.data.delete(s);for(let[n,t]of i.data)t.delete(s),t.size===0&&i.data.delete(n);}});export{_ as ChildOf,R as addRelation,p as defineRelation,w as getRelationData,h as getRelationTargets,b as removeRelation};//# sourceMappingURL=relations.js.map
 //# sourceMappingURL=relations.js.map

package/dist/serialize.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkXBCASW7K_cjs=require('./chunk-XBCASW7K.cjs');require('./chunk-D4VGTV76.cjs');Object.defineProperty(exports,"createDeltaSerializer",{enumerable:true,get:function(){return chunkXBCASW7K_cjs.e}});Object.defineProperty(exports,"deserializeWorld",{enumerable:true,get:function(){return chunkXBCASW7K_cjs.b}});Object.defineProperty(exports,"fromJSON",{enumerable:true,get:function(){return chunkXBCASW7K_cjs.d}});Object.defineProperty(exports,"serializeWorld",{enumerable:true,get:function(){return chunkXBCASW7K_cjs.a}});Object.defineProperty(exports,"toJSON",{enumerable:true,get:function(){return chunkXBCASW7K_cjs.c}});//# sourceMappingURL=serialize.cjs.map
+'use strict';var chunkF6VQ6V3Y_cjs=require('./chunk-F6VQ6V3Y.cjs');require('./chunk-M6L4SSE4.cjs');Object.defineProperty(exports,"createDeltaSerializer",{enumerable:true,get:function(){return chunkF6VQ6V3Y_cjs.e}});Object.defineProperty(exports,"deserializeWorld",{enumerable:true,get:function(){return chunkF6VQ6V3Y_cjs.b}});Object.defineProperty(exports,"fromJSON",{enumerable:true,get:function(){return chunkF6VQ6V3Y_cjs.d}});Object.defineProperty(exports,"serializeWorld",{enumerable:true,get:function(){return chunkF6VQ6V3Y_cjs.a}});Object.defineProperty(exports,"toJSON",{enumerable:true,get:function(){return chunkF6VQ6V3Y_cjs.c}});//# sourceMappingURL=serialize.cjs.map
 //# sourceMappingURL=serialize.cjs.map

package/dist/serialize.js

@@ -1,2 +1,2 @@
-export{e as createDeltaSerializer,b as deserializeWorld,d as fromJSON,a as serializeWorld,c as toJSON}from'./chunk-FZWRVGAA.js';import'./chunk-UAJNL4VY.js';//# sourceMappingURL=serialize.js.map
+export{e as createDeltaSerializer,b as deserializeWorld,d as fromJSON,a as serializeWorld,c as toJSON}from'./chunk-ZWOAXX4R.js';import'./chunk-ENULPSKV.js';//# sourceMappingURL=serialize.js.map
 //# sourceMappingURL=serialize.js.map

package/dist/worker.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkXBCASW7K_cjs=require('./chunk-XBCASW7K.cjs'),chunkD4VGTV76_cjs=require('./chunk-D4VGTV76.cjs');var l=1095320899;function W(r){let e=chunkD4VGTV76_cjs.i(r),o=chunkXBCASW7K_cjs.a(r);if(typeof SharedArrayBuffer>"u"){let n=new ArrayBuffer(o.byteLength);return new Uint8Array(n).set(o),{buffer:n,meta:p(e)}}let t=new SharedArrayBuffer(o.byteLength);return new Uint8Array(t).set(o),{buffer:t,meta:p(e)}}function b(r){m(r.meta);let e=new Uint8Array(r.buffer);return chunkXBCASW7K_cjs.b(e)}function S(r,e){let o=new Uint8Array(r),t=chunkXBCASW7K_cjs.b(o);if(e?.readOnly){let n=chunkD4VGTV76_cjs.i(t);n.readOnly=true;}return t}function w(r){chunkD4VGTV76_cjs.j(r.id)&&chunkD4VGTV76_cjs.l(r);}function p(r){let e=[];for(let o of r.componentInfoByBit)o&&e.push({id:o.id,kind:o.kind,schema:o.schema});return {magic:l,formatVersion:1,aiecsjsVersion:chunkD4VGTV76_cjs.a,indexBits:r.options.indexBits,generationBits:r.options.generationBits,maxComponents:r.options.maxComponents,maskWordCount:r.options.maskWordCount,capacity:r.capacity,componentSchemas:e}}function m(r){if(r.magic!==l)throw new Error("aiecsjs: invalid snapshot meta (wrong magic)");if(r.formatVersion!==1)throw new Error(`aiecsjs: unsupported snapshot format version ${r.formatVersion}`)}exports.adoptSnapshot=b;exports.attachWorld=S;exports.detachWorld=w;exports.transferableSnapshot=W;//# sourceMappingURL=worker.cjs.map
+'use strict';var chunkF6VQ6V3Y_cjs=require('./chunk-F6VQ6V3Y.cjs'),chunkM6L4SSE4_cjs=require('./chunk-M6L4SSE4.cjs');var l=1095320899;function W(r){let e=chunkM6L4SSE4_cjs.i(r),o=chunkF6VQ6V3Y_cjs.a(r);if(typeof SharedArrayBuffer>"u"){let n=new ArrayBuffer(o.byteLength);return new Uint8Array(n).set(o),{buffer:n,meta:p(e)}}let t=new SharedArrayBuffer(o.byteLength);return new Uint8Array(t).set(o),{buffer:t,meta:p(e)}}function b(r){m(r.meta);let e=new Uint8Array(r.buffer);return chunkF6VQ6V3Y_cjs.b(e)}function S(r,e){let o=new Uint8Array(r),t=chunkF6VQ6V3Y_cjs.b(o);if(e?.readOnly){let n=chunkM6L4SSE4_cjs.i(t);n.readOnly=true;}return t}function w(r){chunkM6L4SSE4_cjs.j(r.id)&&chunkM6L4SSE4_cjs.l(r);}function p(r){let e=[];for(let o of r.componentInfoByBit)o&&e.push({id:o.id,kind:o.kind,schema:o.schema});return {magic:l,formatVersion:1,aiecsjsVersion:chunkM6L4SSE4_cjs.a,indexBits:r.options.indexBits,generationBits:r.options.generationBits,maxComponents:r.options.maxComponents,maskWordCount:r.options.maskWordCount,capacity:r.capacity,componentSchemas:e}}function m(r){if(r.magic!==l)throw new Error("aiecsjs: invalid snapshot meta (wrong magic)");if(r.formatVersion!==1)throw new Error(`aiecsjs: unsupported snapshot format version ${r.formatVersion}`)}exports.adoptSnapshot=b;exports.attachWorld=S;exports.detachWorld=w;exports.transferableSnapshot=W;//# sourceMappingURL=worker.cjs.map
 //# sourceMappingURL=worker.cjs.map

package/dist/worker.js

@@ -1,2 +1,2 @@
-import {a,b as b$1}from'./chunk-FZWRVGAA.js';import {i,j,l as l$1,a as a$1}from'./chunk-UAJNL4VY.js';var l=1095320899;function W(r){let e=i(r),o=a(r);if(typeof SharedArrayBuffer>"u"){let n=new ArrayBuffer(o.byteLength);return new Uint8Array(n).set(o),{buffer:n,meta:p(e)}}let t=new SharedArrayBuffer(o.byteLength);return new Uint8Array(t).set(o),{buffer:t,meta:p(e)}}function b(r){m(r.meta);let e=new Uint8Array(r.buffer);return b$1(e)}function S(r,e){let o=new Uint8Array(r),t=b$1(o);if(e?.readOnly){let n=i(t);n.readOnly=true;}return t}function w(r){j(r.id)&&l$1(r);}function p(r){let e=[];for(let o of r.componentInfoByBit)o&&e.push({id:o.id,kind:o.kind,schema:o.schema});return {magic:l,formatVersion:1,aiecsjsVersion:a$1,indexBits:r.options.indexBits,generationBits:r.options.generationBits,maxComponents:r.options.maxComponents,maskWordCount:r.options.maskWordCount,capacity:r.capacity,componentSchemas:e}}function m(r){if(r.magic!==l)throw new Error("aiecsjs: invalid snapshot meta (wrong magic)");if(r.formatVersion!==1)throw new Error(`aiecsjs: unsupported snapshot format version ${r.formatVersion}`)}export{b as adoptSnapshot,S as attachWorld,w as detachWorld,W as transferableSnapshot};//# sourceMappingURL=worker.js.map
+import {a,b as b$1}from'./chunk-ZWOAXX4R.js';import {i,j,l as l$1,a as a$1}from'./chunk-ENULPSKV.js';var l=1095320899;function W(r){let e=i(r),o=a(r);if(typeof SharedArrayBuffer>"u"){let n=new ArrayBuffer(o.byteLength);return new Uint8Array(n).set(o),{buffer:n,meta:p(e)}}let t=new SharedArrayBuffer(o.byteLength);return new Uint8Array(t).set(o),{buffer:t,meta:p(e)}}function b(r){m(r.meta);let e=new Uint8Array(r.buffer);return b$1(e)}function S(r,e){let o=new Uint8Array(r),t=b$1(o);if(e?.readOnly){let n=i(t);n.readOnly=true;}return t}function w(r){j(r.id)&&l$1(r);}function p(r){let e=[];for(let o of r.componentInfoByBit)o&&e.push({id:o.id,kind:o.kind,schema:o.schema});return {magic:l,formatVersion:1,aiecsjsVersion:a$1,indexBits:r.options.indexBits,generationBits:r.options.generationBits,maxComponents:r.options.maxComponents,maskWordCount:r.options.maskWordCount,capacity:r.capacity,componentSchemas:e}}function m(r){if(r.magic!==l)throw new Error("aiecsjs: invalid snapshot meta (wrong magic)");if(r.formatVersion!==1)throw new Error(`aiecsjs: unsupported snapshot format version ${r.formatVersion}`)}export{b as adoptSnapshot,S as attachWorld,w as detachWorld,W as transferableSnapshot};//# sourceMappingURL=worker.js.map
 //# sourceMappingURL=worker.js.map

package/llms-full.txt

@@ -991,6 +991,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
   65 536 entities × 65 536 generations). See test
   [tests/ref.test.ts](./tests/ref.test.ts) `generation wrap` describe block.
 
+## [0.5.5] - 2026-06-08
+
+### Changed
+
+- Project home migrated to the [`islumina`](https://github.com/islumina) GitHub org; published from there via npm trusted publisher (OIDC + SLSA provenance). Family-wide version alignment at `0.5.5`.
+
+### Internal
+
+- Test version assertions now derive from `package.json` instead of a hard-coded string, shrinking the release version-sync surface.
+
 ## [0.5.3] - 2026-06-05
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiecsjs",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "TypeScript-first archetype ECS with TypedArray SoA, SAB-ready snapshot transport, and AI-readable docs.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -61,7 +61,7 @@
   "author": "yshengliao",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/yshengliao/aiecsjs.git"
+    "url": "git+https://github.com/islumina/aiecsjs.git"
   },
   "keywords": [
     "ecs",