aiecsjs 0.3.0 → 0.3.1

package/dist/worker.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts","../src/internal/bitmask.ts","../src/internal/world.ts","../src/internal/entity.ts","../src/internal/component.ts","../src/serialize.ts","../src/worker.ts"],"names":["VERSION","createMask","wordCount","setBit","mask","bit","w","testBit","cloneMask","src","out","i","maskHash","m","parts","DEFAULT_OPTIONS","DEFAULT_MAX_COMPONENTS","nextWorldId","worldRegistry","getWorldState","world","state","registerWorld","unregisterWorld","id","isWorldRegistered","resolveOptions","opts","o","indexBits","generationBits","maxComponents","maxByIndex","initialCapacity","maxEntities","createEmptyArchetype","maskWordCount","createWorld","options","resolved","generationCtor","generations","empty","makePublicWorld","destroyWorld","ensureCapacity","needed","newCap","growEntityArrays","genCtor","newGen","newArch","newMask","storage","info","growSoAColumns","soa","fields","f","old","newLen","next","findOrCreateArchetype","key","existing","arch","collectBits","ensureArchetypeCapacity","bits","word","lsb","getOrRegisterComponentBit","readEntityMask","eid","base","writeEntityMask","packEid","idx","gen","createEntity","row","isAliveInternal","archId","storedGen","refGen","componentInfoById","getComponentInfo","component","addComponent","initial","prevMask","writeInitial","migrateEntity","packedEid","obj","col","val","arr","factory","inst","target","srcArchId","srcArch","destArchId","destArch","lastRow","moved","newRow","getComponentByInternalId","MAGIC","FORMAT_VERSION","serializeWorld","snapshot","toJSON","packBinary","deserializeWorld","bytes","unpackBinary","fromJSON","entities","components","wi","data","baseI","eidMap","e","comp","handle","getComponentHandle","json","jsonBytes","versionBytes","total","view","off","formatVersion","onUnknown","MAX_FIELD_LEN","verLen","jsonLen","transferableSnapshot","ab","buildMeta","sab","adoptSnapshot","snap","validateMeta","attachWorld","buffer","detachWorld","componentSchemas","meta"],"mappings":"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","file":"worker.cjs","sourcesContent":["export const VERSION = '0.3.0'\n","// Multi-word Uint32 bitmask helpers.\n\nexport function createMask(wordCount: number): Uint32Array {\n  return new Uint32Array(wordCount)\n}\n\nexport function setBit(mask: Uint32Array, bit: number): void {\n  const w = bit >>> 5\n  mask[w] = (mask[w] ?? 0) | (1 << (bit & 31))\n}\n\nexport function clearBit(mask: Uint32Array, bit: number): void {\n  const w = bit >>> 5\n  mask[w] = (mask[w] ?? 0) & ~(1 << (bit & 31))\n}\n\nexport function testBit(mask: Uint32Array, bit: number): boolean {\n  const w = bit >>> 5\n  return ((mask[w] ?? 0) & (1 << (bit & 31))) !== 0\n}\n\nexport function copyMask(dst: Uint32Array, src: Uint32Array): void {\n  const n = src.length\n  for (let i = 0; i < n; i++) dst[i] = src[i] ?? 0\n}\n\nexport function cloneMask(src: Uint32Array): Uint32Array {\n  const out = new Uint32Array(src.length)\n  for (let i = 0; i < src.length; i++) out[i] = src[i] ?? 0\n  return out\n}\n\nexport function maskEquals(a: Uint32Array, b: Uint32Array): boolean {\n  const n = a.length\n  if (b.length !== n) return false\n  for (let i = 0; i < n; i++) if ((a[i] ?? 0) !== (b[i] ?? 0)) return false\n  return true\n}\n\nexport function maskHash(m: Uint32Array): string {\n  // Stable string key for Map lookups. Hex-joined.\n  const parts: string[] = []\n  for (let i = 0; i < m.length; i++) {\n    parts.push((m[i] ?? 0).toString(16))\n  }\n  return parts.join(',')\n}\n\nexport function isMaskZero(m: Uint32Array): boolean {\n  for (let i = 0; i < m.length; i++) if ((m[i] ?? 0) !== 0) return false\n  return true\n}\n\nexport function unionMask(a: Uint32Array, b: Uint32Array): Uint32Array {\n  const out = new Uint32Array(a.length)\n  for (let i = 0; i < a.length; i++) out[i] = (a[i] ?? 0) | (b[i] ?? 0)\n  return out\n}\n\n/**\n * Test whether an archetype's mask matches a query.\n *   - withMask: all of these bits must be present\n *   - anyMask:  if anyHasBits, at least one of these bits must be present\n *   - noneMask: none of these bits may be present\n */\nexport function matches(\n  mask: Uint32Array,\n  withMask: Uint32Array,\n  anyMask: Uint32Array,\n  noneMask: Uint32Array,\n  anyHasBits: boolean,\n  words: number,\n): boolean {\n  let anyHit = !anyHasBits\n  for (let w = 0; w < words; w++) {\n    const m = mask[w] ?? 0\n    const wm = withMask[w] ?? 0\n    const am = anyMask[w] ?? 0\n    const nm = noneMask[w] ?? 0\n    if ((m & wm) !== wm) return false\n    if ((m & nm) !== 0) return false\n    if (!anyHit && (m & am) !== 0) anyHit = true\n  }\n  return anyHit\n}\n\nexport function listBits(mask: Uint32Array): number[] {\n  const out: number[] = []\n  for (let w = 0; w < mask.length; w++) {\n    let word = mask[w] ?? 0\n    while (word !== 0) {\n      const bit = (w << 5) + ctz32(word)\n      out.push(bit)\n      word &= word - 1\n    }\n  }\n  return out\n}\n\n// Iterate set bits in a slice of a larger Uint32Array starting at `base`.\n// Shared by destroy paths and storage cleanup so the bit-extraction maths\n// lives in exactly one place.\nexport function forEachSetBit(\n  mask: Uint32Array,\n  base: number,\n  words: number,\n  fn: (bit: number) => void,\n): void {\n  for (let wi = 0; wi < words; wi++) {\n    let word = mask[base + wi] ?? 0\n    while (word !== 0) {\n      const bit = (wi << 5) + ctz32(word)\n      fn(bit)\n      word &= word - 1\n    }\n  }\n}\n\n// Match a query against an entity's mask stored as a slice inside a larger\n// Uint32Array. Reading directly from the parent array avoids the temporary\n// Uint32Array allocation on every observer dispatch.\nexport function matchesEntityMask(\n  entityMask: Uint32Array,\n  base: number,\n  words: number,\n  withMask: Uint32Array,\n  anyMask: Uint32Array,\n  noneMask: Uint32Array,\n  anyHasBits: boolean,\n): boolean {\n  let anyHit = !anyHasBits\n  for (let i = 0; i < words; i++) {\n    const m = entityMask[base + i] ?? 0\n    const wm = withMask[i] ?? 0\n    const am = anyMask[i] ?? 0\n    const nm = noneMask[i] ?? 0\n    if ((m & wm) !== wm) return false\n    if ((m & nm) !== 0) return false\n    if (!anyHit && (m & am) !== 0) anyHit = true\n  }\n  return anyHit\n}\n\nfunction ctz32(v: number): number {\n  // Count trailing zeros in a 32-bit integer (assumes v !== 0)\n  return 31 - Math.clz32(v & -v)\n}\n","import { VERSION } from '../version.js'\nimport { cloneMask, copyMask, createMask, maskHash } from './bitmask.js'\nimport type {\n  ArchetypeState,\n  ComponentInfo,\n  FieldInfo,\n  ResolvedWorldOptions,\n  World,\n  WorldComponentStorage,\n  WorldOptions,\n  WorldState,\n} from './types.js'\n\nexport const WORLD_BRAND = Symbol.for('aiecsjs.world')\n\nconst DEFAULT_OPTIONS: Required<Omit<WorldOptions, 'buffer' | 'bufferByteOffset'>> = {\n  initialCapacity: 1024,\n  maxEntities: 1_000_000,\n  indexBits: 24,\n  generationBits: 8,\n}\n\nconst DEFAULT_MAX_COMPONENTS = 256\n\nlet nextWorldId = 1\nconst worldRegistry = new Map<number, WorldState>()\n\nexport function getWorldState(world: World): WorldState {\n  const state = worldRegistry.get(world.id)\n  if (!state) throw new Error(`aiecsjs: world ${world.id} is destroyed or unknown`)\n  if (state.destroyed) throw new Error(`aiecsjs: world ${world.id} is destroyed`)\n  return state\n}\n\nexport function registerWorld(state: WorldState): void {\n  worldRegistry.set(state.id, state)\n}\n\nexport function unregisterWorld(id: number): void {\n  worldRegistry.delete(id)\n}\n\nexport function isWorldRegistered(id: number): boolean {\n  return worldRegistry.has(id)\n}\n\nfunction resolveOptions(opts: WorldOptions | undefined): ResolvedWorldOptions {\n  const o = opts ?? {}\n  const indexBits = o.indexBits ?? DEFAULT_OPTIONS.indexBits\n  const generationBits = o.generationBits ?? DEFAULT_OPTIONS.generationBits\n  const maxComponents = DEFAULT_MAX_COMPONENTS\n  if (indexBits < 1 || indexBits > 24) {\n    throw new Error('aiecsjs: indexBits must be in [1, 24]')\n  }\n  if (generationBits < 0 || generationBits > 16) {\n    throw new Error('aiecsjs: generationBits must be in [0, 16]')\n  }\n  const maxByIndex = 1 << indexBits\n  const initialCapacity = Math.max(\n    1,\n    Math.min(o.initialCapacity ?? DEFAULT_OPTIONS.initialCapacity, maxByIndex),\n  )\n  const maxEntities = Math.max(\n    initialCapacity,\n    Math.min(o.maxEntities ?? DEFAULT_OPTIONS.maxEntities, maxByIndex),\n  )\n  return {\n    initialCapacity,\n    maxEntities,\n    indexBits,\n    generationBits,\n    indexMask: (1 << indexBits) - 1,\n    generationMask: generationBits === 0 ? 0 : (1 << generationBits) - 1,\n    maxComponents,\n    maskWordCount: Math.ceil(maxComponents / 32),\n    buffer: o.buffer ?? null,\n    bufferByteOffset: o.bufferByteOffset ?? 0,\n  }\n}\n\nexport function createEmptyArchetype(maskWordCount: number, maxComponents: number): ArchetypeState {\n  return {\n    id: 0,\n    mask: createMask(maskWordCount),\n    size: 0,\n    capacity: 16,\n    entities: new Uint32Array(16),\n    entityRow: new Map<number, number>(),\n    componentBits: [],\n    edgeAdd: new Int32Array(maxComponents).fill(-1),\n    edgeRemove: new Int32Array(maxComponents).fill(-1),\n  }\n}\n\nexport function createWorld(options?: WorldOptions): World {\n  const resolved = resolveOptions(options)\n  const id = nextWorldId++\n\n  const generationCtor = resolved.generationBits > 8 ? Uint16Array : Uint8Array\n  const generations = new generationCtor(resolved.initialCapacity)\n\n  const state: WorldState = {\n    id,\n    capacity: resolved.initialCapacity,\n    version: VERSION,\n    options: resolved,\n    size: 0,\n    nextFreshIndex: 1, // 0 reserved\n    freeList: [],\n    generations,\n    destroyed: false,\n    componentBitFor: new Map<number, number>(),\n    componentInfoByBit: new Array(resolved.maxComponents).fill(null),\n    componentStorageByBit: new Array(resolved.maxComponents).fill(null),\n    nextComponentBit: 0,\n    entityArchetype: new Uint32Array(resolved.initialCapacity),\n    entityMask: new Uint32Array(resolved.initialCapacity * resolved.maskWordCount),\n    archetypes: [],\n    archetypeByMaskHash: new Map<string, number>(),\n    queryVersion: 0,\n    queries: [],\n    queryMasks: new Map(),\n    queryArchetypeCache: [],\n    queryArchetypeStamp: [],\n    bitToQueries: new Map<number, Set<number>>(),\n    reactiveBuffers: new Map(),\n    observers: [],\n    relationStorage: new Map(),\n    sab: resolved.buffer,\n    readOnly: false,\n  }\n\n  // Seed archetype 0 (the empty mask)\n  const empty = createEmptyArchetype(resolved.maskWordCount, resolved.maxComponents)\n  empty.id = 0\n  state.archetypes.push(empty)\n  state.archetypeByMaskHash.set(maskHash(empty.mask), 0)\n\n  registerWorld(state)\n  return makePublicWorld(state)\n}\n\nexport function makePublicWorld(state: WorldState): World {\n  return {\n    id: state.id,\n    get capacity() {\n      return state.capacity\n    },\n    version: state.version,\n  } as World\n}\n\nexport function destroyWorld(world: World): void {\n  const state = worldRegistry.get(world.id)\n  if (!state || state.destroyed) return\n  state.destroyed = true\n  // Clear large buffers to help GC\n  state.archetypes = []\n  state.archetypeByMaskHash.clear()\n  state.componentInfoByBit = []\n  state.componentStorageByBit = []\n  state.queries = []\n  state.queryMasks.clear()\n  state.queryArchetypeCache = []\n  state.observers = []\n  state.relationStorage.clear()\n  state.reactiveBuffers.clear()\n  unregisterWorld(world.id)\n}\n\nexport function resetWorld(world: World): void {\n  const state = getWorldState(world)\n  // Keep capacity and registered components; clear entities and per-entity state.\n  state.size = 0\n  state.nextFreshIndex = 1\n  state.freeList = []\n  state.generations.fill(0)\n  state.entityArchetype.fill(0)\n  state.entityMask.fill(0)\n  // Wipe archetype memberships but keep archetype graph for stability.\n  for (const arch of state.archetypes) {\n    arch.size = 0\n    arch.entityRow.clear()\n  }\n  // Clear SoA columns and AoS instances; storage allocation is preserved.\n  for (const storage of state.componentStorageByBit) {\n    if (!storage) continue\n    if (storage.kind === 'soa' && storage.soa) {\n      for (const k of Object.keys(storage.soa)) {\n        storage.soa[k]?.fill(0)\n      }\n    } else if (storage.kind === 'aos' && storage.aos) {\n      storage.aos.fill(undefined as unknown as never)\n    }\n  }\n  state.queryVersion++\n  for (const buf of state.reactiveBuffers.values()) {\n    buf.entered.length = 0\n    buf.exited.length = 0\n  }\n}\n\nexport function getWorldSize(world: World): number {\n  return getWorldState(world).size\n}\n\nexport function getWorldCapacity(world: World): number {\n  return getWorldState(world).capacity\n}\n\n// --- Capacity growth ---\n\nexport function ensureCapacity(state: WorldState, needed: number): void {\n  if (needed <= state.capacity) return\n  if (needed > state.options.maxEntities) {\n    throw new Error(\n      `aiecsjs: requested capacity ${needed} exceeds maxEntities ${state.options.maxEntities}`,\n    )\n  }\n  let newCap = state.capacity\n  while (newCap < needed) newCap = Math.min(newCap * 2, state.options.maxEntities)\n  growEntityArrays(state, newCap)\n}\n\nfunction growEntityArrays(state: WorldState, newCap: number): void {\n  // generations\n  const genCtor: any = state.generations.constructor\n  const newGen = new genCtor(newCap) as Uint8Array | Uint16Array\n  ;(newGen as Uint8Array).set(state.generations as Uint8Array)\n  state.generations = newGen\n\n  // entityArchetype\n  const newArch = new Uint32Array(newCap)\n  newArch.set(state.entityArchetype)\n  state.entityArchetype = newArch\n\n  // entityMask\n  const wordCount = state.options.maskWordCount\n  const newMask = new Uint32Array(newCap * wordCount)\n  newMask.set(state.entityMask)\n  state.entityMask = newMask\n\n  // Component storages (SoA columns + AoS arrays)\n  for (const storage of state.componentStorageByBit) {\n    if (!storage) continue\n    if (storage.kind === 'soa' && storage.soa) {\n      const info = state.componentInfoByBit[storage.bit]\n      if (info) growSoAColumns(storage.soa, info.fields, newCap)\n    } else if (storage.kind === 'aos' && storage.aos) {\n      storage.aos.length = newCap\n    }\n  }\n\n  state.capacity = newCap\n}\n\nfunction growSoAColumns(soa: Record<string, any>, fields: FieldInfo[], newCap: number): void {\n  for (const f of fields) {\n    const old = soa[f.name]\n    if (!old) continue\n    const newLen = newCap * f.vectorLen\n    if (old.length >= newLen) continue\n    const next = new f.ctor(newLen)\n    next.set(old)\n    soa[f.name] = next\n  }\n}\n\n// --- Archetype management ---\n\nexport function findOrCreateArchetype(\n  state: WorldState,\n  mask: Uint32Array,\n): { archId: number; created: boolean } {\n  const key = maskHash(mask)\n  const existing = state.archetypeByMaskHash.get(key)\n  if (existing !== undefined) return { archId: existing, created: false }\n\n  const id = state.archetypes.length\n  const arch: ArchetypeState = {\n    id,\n    mask: cloneMask(mask),\n    size: 0,\n    capacity: 16,\n    entities: new Uint32Array(16),\n    entityRow: new Map<number, number>(),\n    componentBits: collectBits(mask),\n    edgeAdd: new Int32Array(state.options.maxComponents).fill(-1),\n    edgeRemove: new Int32Array(state.options.maxComponents).fill(-1),\n  }\n  state.archetypes.push(arch)\n  state.archetypeByMaskHash.set(key, id)\n  state.queryVersion++\n  return { archId: id, created: true }\n}\n\nexport function ensureArchetypeCapacity(arch: ArchetypeState, needed: number): void {\n  if (needed <= arch.capacity) return\n  let newCap = arch.capacity\n  while (newCap < needed) newCap *= 2\n  const next = new Uint32Array(newCap)\n  next.set(arch.entities)\n  arch.entities = next\n  arch.capacity = newCap\n}\n\nfunction collectBits(mask: Uint32Array): number[] {\n  const bits: number[] = []\n  for (let w = 0; w < mask.length; w++) {\n    let word = mask[w] ?? 0\n    while (word !== 0) {\n      const lsb = word & -word\n      const bit = (w << 5) + (31 - Math.clz32(lsb))\n      bits.push(bit)\n      word &= word - 1\n    }\n  }\n  return bits\n}\n\n// --- Component registration in a world ---\n\nexport function getOrRegisterComponentBit(state: WorldState, info: ComponentInfo): number {\n  const existing = state.componentBitFor.get(info.id)\n  if (existing !== undefined) return existing\n\n  if (state.nextComponentBit >= state.options.maxComponents) {\n    throw new Error(`aiecsjs: world reached maxComponents=${state.options.maxComponents}`)\n  }\n  const bit = state.nextComponentBit++\n  state.componentBitFor.set(info.id, bit)\n  state.componentInfoByBit[bit] = info\n\n  // Create storage\n  let storage: WorldComponentStorage\n  if (info.kind === 'soa') {\n    const soa: Record<string, any> = {}\n    for (const f of info.fields) {\n      soa[f.name] = new f.ctor(state.capacity * f.vectorLen)\n    }\n    storage = { kind: 'soa', componentId: info.id, bit, soa }\n  } else if (info.kind === 'aos') {\n    storage = { kind: 'aos', componentId: info.id, bit, aos: new Array(state.capacity) }\n  } else {\n    storage = { kind: 'tag', componentId: info.id, bit }\n  }\n  state.componentStorageByBit[bit] = storage\n  return bit\n}\n\n// Read a bitmask out of state.entityMask[] into a fresh Uint32Array.\nexport function readEntityMask(state: WorldState, eid: number): Uint32Array {\n  const w = state.options.maskWordCount\n  const out = new Uint32Array(w)\n  const idx = eid & state.options.indexMask\n  const base = idx * w\n  for (let i = 0; i < w; i++) out[i] = state.entityMask[base + i] ?? 0\n  return out\n}\n\nexport function writeEntityMask(state: WorldState, eid: number, mask: Uint32Array): void {\n  const w = state.options.maskWordCount\n  const idx = eid & state.options.indexMask\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = mask[i] ?? 0\n}\n\n// Get the bit of a component within a world without registering.\nexport function tryGetComponentBit(state: WorldState, info: ComponentInfo): number | undefined {\n  return state.componentBitFor.get(info.id)\n}\n\nexport function isWorld(x: unknown): x is World {\n  if (!x || typeof x !== 'object') return false\n  const obj = x as { id?: unknown; version?: unknown }\n  if (typeof obj.id !== 'number') return false\n  if (typeof obj.version !== 'string') return false\n  return worldRegistry.has(obj.id)\n}\n","import { clearAllEntityStorages } from './component.js'\nimport type { EntityId, ResolvedWorldOptions, World, WorldState } from './types.js'\nimport { ensureArchetypeCapacity, ensureCapacity, getWorldState } from './world.js'\n\n// --- Default bit layout constants (used by public getEntityIndex / getEntityGeneration / packEntity) ---\n// These use the default 24/8 split. See §4.4 limitation: callers using non-default\n// createWorld({ indexBits, generationBits }) should not rely on these functions for unpacking.\nexport const DEFAULT_INDEX_BITS = 24\nexport const DEFAULT_GENERATION_BITS = 8\nexport const DEFAULT_INDEX_MASK = (1 << DEFAULT_INDEX_BITS) - 1\nexport const DEFAULT_GENERATION_MASK = (1 << DEFAULT_GENERATION_BITS) - 1\n\n// --- Internal pack/unpack helpers (world-options-aware) ---\n\nexport function packEid(idx: number, gen: number, opts: ResolvedWorldOptions): EntityId {\n  return (((gen & opts.generationMask) << opts.indexBits) | (idx & opts.indexMask)) as EntityId\n}\n\nexport function unpackIdx(eid: number, opts: ResolvedWorldOptions): number {\n  return eid & opts.indexMask\n}\n\nexport function unpackGen(eid: number, opts: ResolvedWorldOptions): number {\n  return (eid >>> opts.indexBits) & opts.generationMask\n}\n\nexport function createEntity(world: World): EntityId {\n  const state = getWorldState(world)\n  if (state.readOnly) {\n    throw new Error('aiecsjs: cannot createEntity on a read-only world (worker-attached)')\n  }\n\n  let idx: number\n  if (state.freeList.length > 0) {\n    idx = state.freeList.pop()!\n  } else {\n    if (state.nextFreshIndex >= state.options.maxEntities) {\n      throw new Error(`aiecsjs: reached maxEntities ${state.options.maxEntities}`)\n    }\n    if (state.nextFreshIndex >= state.capacity) {\n      ensureCapacity(state, state.nextFreshIndex + 1)\n    }\n    idx = state.nextFreshIndex++\n  }\n\n  const gen = state.generations[idx] ?? 0\n  const eid = packEid(idx, gen, state.options)\n\n  // Move into the empty archetype (0)\n  const arch = state.archetypes[0]\n  if (!arch) throw new Error('aiecsjs: missing empty archetype')\n  ensureArchetypeCapacity(arch, arch.size + 1)\n  const row = arch.size\n  arch.entities[row] = eid\n  arch.entityRow.set(eid, row)\n  arch.size++\n\n  state.entityArchetype[idx] = 0\n  // Reset entityMask row for this idx\n  const w = state.options.maskWordCount\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n\n  state.size++\n  return eid\n}\n\nexport function destroyEntity(world: World, eid: EntityId): void {\n  const state = getWorldState(world)\n  if (state.readOnly) {\n    throw new Error('aiecsjs: cannot destroyEntity on a read-only world')\n  }\n  if (!isAliveInternal(state, eid)) return\n\n  const idx = eid & state.options.indexMask\n\n  // Fire onRemove for every component the entity has, plus reactive exit\n  // (Late-bound to avoid circular imports — done via observers module.)\n  const { dispatchDestroyObservers } = lazyObservers()\n  dispatchDestroyObservers(state, eid)\n\n  // Clean up relations referring to this entity\n  cleanupRelationsOnDestroy(state, eid)\n\n  // Zero the SoA columns / undefine the AoS slots the entity owned, before\n  // the mask is cleared. Without this, destroyed entities leave stale data\n  // visible to snapshots and serialisation.\n  clearAllEntityStorages(state, eid)\n\n  // Swap-pop from its archetype\n  const archId = state.entityArchetype[idx] ?? 0\n  const arch = state.archetypes[archId]\n  if (arch) {\n    const row = arch.entityRow.get(eid)\n    if (row !== undefined) {\n      const lastRow = arch.size - 1\n      if (row !== lastRow) {\n        const moved = arch.entities[lastRow] ?? 0\n        arch.entities[row] = moved\n        arch.entityRow.set(moved, row)\n      }\n      arch.entities[lastRow] = 0\n      arch.entityRow.delete(eid)\n      arch.size--\n    }\n  }\n\n  // Wipe state\n  state.entityArchetype[idx] = 0\n  const w = state.options.maskWordCount\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n  // Bump generation — use generationMask so non-default generationBits wraps correctly\n  state.generations[idx] = ((state.generations[idx] ?? 0) + 1) & state.options.generationMask\n\n  // freeList stores raw idx (not packed); createEntity packs on re-use\n  state.freeList.push(idx)\n  state.size--\n}\n\nexport function entityExists(world: World, eid: EntityId): boolean {\n  const state = getWorldState(world)\n  return isAliveInternal(state, eid)\n}\n\nexport function isAliveInternal(state: WorldState, eid: number): boolean {\n  const idx = eid & state.options.indexMask\n  if (idx <= 0) return false\n  if (idx >= state.capacity) return false\n  const archId = state.entityArchetype[idx] ?? 0\n  const arch = state.archetypes[archId]\n  if (!arch) return false\n  if (!arch.entityRow.has(eid)) return false\n  // Generation comparison: packed eid must match stored generation\n  const storedGen = state.generations[idx] ?? 0\n  const refGen = (eid >>> state.options.indexBits) & state.options.generationMask\n  return storedGen === refGen\n}\n\n/**\n * Extract the index portion of a packed entity ID.\n *\n * Uses the default 24-bit index layout. If you created the world with a\n * non-default `indexBits`, use `EntityRef` + `deref` instead.\n */\nexport function getEntityIndex(eid: EntityId): number {\n  return (eid as number) & DEFAULT_INDEX_MASK\n}\n\n/**\n * Extract the generation portion of a packed entity ID.\n *\n * Uses the default 8-bit generation layout. If you created the world with a\n * non-default `generationBits`, use `EntityRef` + `deref` instead.\n */\nexport function getEntityGeneration(eid: EntityId): number {\n  return ((eid as number) >>> DEFAULT_INDEX_BITS) & DEFAULT_GENERATION_MASK\n}\n\n/**\n * Pack an index and generation into an EntityId using the default 24/8 bit layout.\n *\n * Uses the default `indexBits=24, generationBits=8`. If you created the world\n * with non-default bit sizes, this will produce values with incorrect layout.\n * Use `EntityRef` and `deref` for portable cross-world identity matching.\n */\nexport function packEntity(index: number, generation: number): EntityId {\n  return (((generation & DEFAULT_GENERATION_MASK) << DEFAULT_INDEX_BITS) |\n    (index & DEFAULT_INDEX_MASK)) as EntityId\n}\n\nexport function isEntity(world: World, x: unknown): x is EntityId {\n  if (typeof x !== 'number') return false\n  return entityExists(world, x as EntityId)\n}\n\n// --- Lazy loaders to break import cycles ---\n\ninterface ObserversAPI {\n  dispatchDestroyObservers(state: WorldState, eid: EntityId): void\n}\nlet _observersAPI: ObserversAPI | null = null\nexport function registerObserversAPI(api: ObserversAPI): void {\n  _observersAPI = api\n}\nfunction lazyObservers(): ObserversAPI {\n  if (!_observersAPI) {\n    return { dispatchDestroyObservers: () => {} }\n  }\n  return _observersAPI\n}\n\nlet _relationsCleanup: ((state: WorldState, eid: EntityId) => void) | null = null\nexport function registerRelationsCleanup(fn: (state: WorldState, eid: EntityId) => void): void {\n  _relationsCleanup = fn\n}\nfunction cleanupRelationsOnDestroy(state: WorldState, eid: EntityId): void {\n  if (_relationsCleanup) _relationsCleanup(state, eid)\n}\n","import { clearBit, cloneMask, forEachSetBit, setBit, testBit } from './bitmask.js'\nimport { isAliveInternal } from './entity.js'\nimport type {\n  AoSComponent,\n  ComponentInfo,\n  ComponentInit,\n  ComponentLike,\n  EntityId,\n  FieldInfo,\n  SoAColumns,\n  SoAComponent,\n  SoASchema,\n  TagComponent,\n  TypedArrayConstructor,\n  World,\n  WorldComponentStorage,\n  WorldState,\n} from './types.js'\nimport {\n  ensureArchetypeCapacity,\n  findOrCreateArchetype,\n  getOrRegisterComponentBit,\n  getWorldState,\n  readEntityMask,\n  tryGetComponentBit,\n  writeEntityMask,\n} from './world.js'\n\n// --- Component factories ---\n\nlet nextComponentId = 1\n\nconst TYPE_CTOR: Record<string, TypedArrayConstructor> = {\n  i8: Int8Array,\n  u8: Uint8Array,\n  i16: Int16Array,\n  u16: Uint16Array,\n  i32: Int32Array,\n  u32: Uint32Array,\n  f32: Float32Array,\n  f64: Float64Array,\n  eid: Uint32Array,\n  bool: Uint8Array,\n}\n\nconst componentInfoById = new Map<number, ComponentInfo>()\n\nexport function defineComponent<S extends SoASchema>(schema: S): SoAComponent<S> {\n  const fields: FieldInfo[] = []\n  for (const [name, decl] of Object.entries(schema)) {\n    let type: keyof typeof TYPE_CTOR\n    let vectorLen = 1\n    if (typeof decl === 'string') {\n      type = decl\n    } else if (Array.isArray(decl)) {\n      const [t, len] = decl\n      type = t\n      vectorLen = len\n    } else {\n      throw new TypeError(`aiecsjs: invalid field declaration for \"${name}\"`)\n    }\n    const ctor = TYPE_CTOR[type]\n    if (!ctor) throw new TypeError(`aiecsjs: unknown field type \"${type}\" for field \"${name}\"`)\n    fields.push({\n      name,\n      type: type as any,\n      vectorLen,\n      ctor,\n      bytesPerElement: (ctor as any).BYTES_PER_ELEMENT,\n    })\n  }\n  const id = nextComponentId++\n  const info: ComponentInfo = { id, kind: 'soa', schema, fields, factory: null }\n  componentInfoById.set(id, info)\n  const handle: SoAComponent<S> = {\n    __kind: 'soa',\n    __id: id,\n    __schema: schema,\n  }\n  return handle\n}\n\nexport function defineTag(): TagComponent {\n  const id = nextComponentId++\n  const info: ComponentInfo = { id, kind: 'tag', schema: null, fields: [], factory: null }\n  componentInfoById.set(id, info)\n  return { __kind: 'tag', __id: id }\n}\n\nexport function defineObjectComponent<T>(factory?: () => T): AoSComponent<T> {\n  const id = nextComponentId++\n  const fac = factory ?? (() => ({}) as T)\n  const info: ComponentInfo = { id, kind: 'aos', schema: null, fields: [], factory: fac as any }\n  componentInfoById.set(id, info)\n  return { __kind: 'aos', __id: id, __factory: fac }\n}\n\nexport function getComponentInfo(component: ComponentLike): ComponentInfo {\n  const info = componentInfoById.get(component.__id)\n  if (!info)\n    throw new Error(\n      'aiecsjs: component is not registered (call defineComponent/defineTag/defineObjectComponent)',\n    )\n  return info\n}\n\n// --- Component ops on entities ---\n\nexport function addComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n  initial?: ComponentInit<C>,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) {\n    throw new Error(`aiecsjs: addComponent on dead entity ${eid}`)\n  }\n  const info = getComponentInfo(component)\n  const bit = getOrRegisterComponentBit(state, info)\n\n  const prevMask = readEntityMask(state, eid)\n  if (testBit(prevMask, bit)) {\n    if (initial !== undefined) writeInitial(state, eid as number, component, initial)\n    return\n  }\n  const newMask = cloneMask(prevMask)\n  setBit(newMask, bit)\n  migrateEntity(state, eid as number, newMask)\n\n  writeInitial(state, eid as number, component, initial)\n\n  fireAddObservers(state, eid, bit)\n  notifyMaskChange(state, eid, bit, prevMask, newMask)\n}\n\nexport function removeComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) return\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return\n  const prevMask = readEntityMask(state, eid)\n  if (!testBit(prevMask, bit)) return\n\n  // Write the new mask BEFORE firing observers so query-targeted observers\n  // reading `state.entityMask` see the post-removal state (and thus correctly\n  // detect \"entity left this query\"). Without this reorder, a query that\n  // requires the removed component would still match during dispatch and the\n  // remove observer would never fire. Component-targeted observers receive the\n  // bit directly and don't depend on mask timing. addComponent already follows\n  // this \"mutate then fire\" order; keeping removeComponent consistent.\n  const newMask = cloneMask(prevMask)\n  clearBit(newMask, bit)\n  migrateEntity(state, eid as number, newMask)\n\n  fireRemoveObservers(state, eid, bit)\n\n  const idx = (eid as number) & state.options.indexMask\n  const storage = state.componentStorageByBit[bit]\n  if (storage?.kind === 'soa' && storage.soa) {\n    clearSoAEntity(storage.soa, info.fields, idx)\n  } else if (storage?.kind === 'aos' && storage.aos) {\n    storage.aos[idx] = undefined\n  }\n\n  notifyMaskChange(state, eid, bit, prevMask, newMask)\n}\n\nexport function hasComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): boolean {\n  const state = getWorldState(world)\n  if (!isAliveInternal(state, eid)) return false\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return false\n  const mask = readEntityMask(state, eid)\n  return testBit(mask, bit)\n}\n\nexport function getComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): unknown {\n  const state = getWorldState(world)\n  if (!isAliveInternal(state, eid)) return undefined\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return undefined\n  const mask = readEntityMask(state, eid)\n  if (!testBit(mask, bit)) return undefined\n  const storage = state.componentStorageByBit[bit]\n  if (!storage) return undefined\n  if (storage.kind === 'soa') return storage.soa\n  if (storage.kind === 'aos') {\n    const idx = (eid as number) & state.options.indexMask\n    return storage.aos?.[idx]\n  }\n  return true // tag\n}\n\nexport function setComponent<C extends ComponentLike, V>(\n  world: World,\n  eid: EntityId,\n  component: C,\n  value: V,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) throw new Error(`aiecsjs: setComponent on dead entity ${eid}`)\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) {\n    // Adding via set\n    addComponent(world, eid, component, value as any)\n    return\n  }\n  const mask = readEntityMask(state, eid)\n  if (!testBit(mask, bit)) {\n    addComponent(world, eid, component, value as any)\n    return\n  }\n  writeInitial(state, eid as number, component, value as any)\n  fireSetObservers(state, eid, bit, value)\n}\n\n// --- Internals ---\n\nfunction writeInitial(\n  state: WorldState,\n  packedEid: number,\n  component: ComponentLike,\n  initial: unknown,\n): void {\n  const info = getComponentInfo(component)\n  const bit = state.componentBitFor.get(info.id)\n  if (bit === undefined) return\n  const storage = state.componentStorageByBit[bit]\n  if (!storage) return\n  // Unpack to raw index for storage access\n  const idx = packedEid & state.options.indexMask\n  if (info.kind === 'soa' && storage.soa) {\n    if (initial == null) return\n    const obj = initial as Record<string, unknown>\n    for (const f of info.fields) {\n      if (!(f.name in obj)) continue\n      const col = storage.soa[f.name]\n      if (!col) continue\n      const val = obj[f.name]\n      if (f.vectorLen === 1) {\n        col[idx] = typeof val === 'boolean' ? (val ? 1 : 0) : Number(val)\n      } else if (Array.isArray(val) || ArrayBuffer.isView(val)) {\n        const base = idx * f.vectorLen\n        const arr = val as ArrayLike<number>\n        for (let i = 0; i < f.vectorLen; i++) col[base + i] = Number(arr[i] ?? 0)\n      }\n    }\n  } else if (info.kind === 'aos' && storage.aos) {\n    const factory = info.factory ?? (() => ({}))\n    let inst = storage.aos[idx]\n    if (inst === undefined) {\n      inst = factory()\n      storage.aos[idx] = inst\n    }\n    if (initial && typeof initial === 'object') {\n      // SECURITY: do NOT use `Object.assign(inst, initial)` here. When `initial`\n      // comes from `JSON.parse(untrustedBytes)` — e.g. via `fromJSON`,\n      // `deserializeWorld`, or app code piping a bridge payload — the parsed\n      // object can carry an OWN `__proto__` property, and `Object.assign` uses\n      // [[Set]] semantics which would trigger the proto setter and clobber the\n      // instance's prototype chain. Explicit own-key copy with a deny-list\n      // closes the prototype-pollution path.\n      const src = initial as Record<string, unknown>\n      const target = inst as Record<string, unknown>\n      for (const key of Object.keys(src)) {\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue\n        target[key] = src[key]\n      }\n    }\n  }\n  // tag: nothing\n}\n\nfunction clearSoAEntity(soa: SoAColumns, fields: FieldInfo[], eid: number): void {\n  for (const f of fields) {\n    const col = soa[f.name]\n    if (!col) continue\n    if (f.vectorLen === 1) {\n      col[eid] = 0\n    } else {\n      const base = eid * f.vectorLen\n      for (let i = 0; i < f.vectorLen; i++) col[base + i] = 0\n    }\n  }\n}\n\n// Clear every component-storage slot that the entity currently owns.\n// Walks the entity's mask; for each set bit, zeroes the SoA columns or\n// undefines the AoS slot at the entity index. Tag storages are bit-only.\n// Caller (e.g. destroyEntity) is expected to clear the mask separately.\nexport function clearAllEntityStorages(state: WorldState, eid: EntityId): void {\n  const wordCount = state.options.maskWordCount\n  const idx = (eid as number) & state.options.indexMask\n  const base = idx * wordCount\n  forEachSetBit(state.entityMask, base, wordCount, (bit) => {\n    const storage = state.componentStorageByBit[bit]\n    const info = state.componentInfoByBit[bit]\n    if (storage?.kind === 'soa' && storage.soa && info) {\n      clearSoAEntity(storage.soa, info.fields, idx)\n    } else if (storage?.kind === 'aos' && storage.aos) {\n      storage.aos[idx] = undefined\n    }\n  })\n}\n\nfunction migrateEntity(state: WorldState, packedEid: number, newMask: Uint32Array): void {\n  // Unpack to raw index for sparse-array lookups\n  const idx = packedEid & state.options.indexMask\n  const srcArchId = state.entityArchetype[idx] ?? 0\n  const srcArch = state.archetypes[srcArchId]\n  if (!srcArch) return\n\n  const found = findOrCreateArchetype(state, newMask)\n  const destArchId = found.archId\n  const destArch = state.archetypes[destArchId]\n  if (!destArch) return\n\n  if (destArchId !== srcArchId) {\n    // Swap-pop from src (arch.entities / entityRow use packed eid as key)\n    const row = srcArch.entityRow.get(packedEid)\n    if (row !== undefined) {\n      const lastRow = srcArch.size - 1\n      if (row !== lastRow) {\n        const moved = srcArch.entities[lastRow] ?? 0\n        srcArch.entities[row] = moved\n        srcArch.entityRow.set(moved, row)\n      }\n      srcArch.entities[lastRow] = 0\n      srcArch.entityRow.delete(packedEid)\n      srcArch.size--\n    }\n\n    // Append to dest (store packed eid)\n    ensureArchetypeCapacity(destArch, destArch.size + 1)\n    const newRow = destArch.size\n    destArch.entities[newRow] = packedEid\n    destArch.entityRow.set(packedEid, newRow)\n    destArch.size++\n\n    state.entityArchetype[idx] = destArchId\n  }\n\n  writeEntityMask(state, packedEid, newMask)\n}\n\n// --- Observer dispatch (lazy-bound) ---\n\ninterface ObserversDispatchAPI {\n  fireAdd(state: WorldState, eid: EntityId, bit: number): void\n  fireRemove(state: WorldState, eid: EntityId, bit: number): void\n  fireSet(state: WorldState, eid: EntityId, bit: number, value: unknown): void\n}\nlet _dispatch: ObserversDispatchAPI = {\n  fireAdd: () => {},\n  fireRemove: () => {},\n  fireSet: () => {},\n}\n\ntype MaskChangeFn = (\n  state: WorldState,\n  eid: EntityId,\n  bit: number,\n  prev: Uint32Array,\n  next: Uint32Array,\n) => void\nlet _maskChange: MaskChangeFn = () => {}\nexport function registerMaskChangeDispatch(fn: MaskChangeFn): void {\n  _maskChange = fn\n}\nfunction notifyMaskChange(\n  state: WorldState,\n  eid: number,\n  bit: number,\n  prev: Uint32Array,\n  next: Uint32Array,\n): void {\n  _maskChange(state, eid as EntityId, bit, prev, next)\n}\nexport function registerObserverDispatch(api: ObserversDispatchAPI): void {\n  _dispatch = api\n}\nfunction fireAddObservers(state: WorldState, eid: number, bit: number): void {\n  _dispatch.fireAdd(state, eid as EntityId, bit)\n}\nfunction fireRemoveObservers(state: WorldState, eid: number, bit: number): void {\n  _dispatch.fireRemove(state, eid as EntityId, bit)\n}\nfunction fireSetObservers(state: WorldState, eid: number, bit: number, value: unknown): void {\n  _dispatch.fireSet(state, eid as EntityId, bit, value)\n}\n\n// --- Helper for serialize/worker ---\n\nexport function getComponentByInternalId(id: number): ComponentInfo | undefined {\n  return componentInfoById.get(id)\n}\n\nexport function listAllComponents(): ComponentInfo[] {\n  return Array.from(componentInfoById.values())\n}\n\nexport function _resetComponentRegistry_FOR_TESTS_ONLY(): void {\n  componentInfoById.clear()\n  nextComponentId = 1\n}\n","// 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, entityExists } 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 =\n      ((gen & state.options.generationMask) << state.options.indexBits) |\n      (idx & state.options.indexMask)\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  return JSON.parse(json) as WorldSnapshot\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      // Apply: ensure entities exist, then add/update their components\n      const targetState = getWorldState(targetWorld)\n      for (const e of snapshot.entities) {\n        if (e.eid >= targetState.capacity) continue\n        if (!entityExists(targetWorld, e.eid as EntityId)) {\n          // Create the entity. For simplicity, we just spawn until we have enough.\n          while (targetState.size < e.eid) {\n            createEntity(targetWorld)\n          }\n        }\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, e.eid as EntityId, 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","// aiecsjs/worker — SharedArrayBuffer helpers (experimental, snapshot-copy).\n//\n// Note: 0.x implements SAB as a transferable snapshot pattern rather than true\n// shared-memory aliasing. The world is serialized into the SAB, and the worker\n// reconstructs a fresh world from those bytes via adoptSnapshot/attachWorld.\n// True shared-column memory is targeted for a future stable release.\n// The API matches the documented contract and survives postMessage cleanly.\n//\n// EntityRef is in-memory only — not preserved across worker boundaries.\n// Generation counters reset on adoptSnapshot/attachWorld. Pass `EntityRef.id`\n// (the packed EntityId) across the worker boundary only if you understand that\n// the generation portion will be stale after a round-trip snapshot.\n\nimport type { TransferableSnapshot, World, WorldMeta, WorldState } from './internal/types.js'\nimport { destroyWorld, getWorldState, isWorldRegistered } from './internal/world.js'\nimport { deserializeWorld, serializeWorld } from './serialize.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 0x41494543 // 'AIEC' little-endian as uint32\n\nexport function transferableSnapshot(world: World): TransferableSnapshot {\n  const state = getWorldState(world)\n  const bytes = serializeWorld(world)\n\n  if (typeof SharedArrayBuffer === 'undefined') {\n    // Fallback: ArrayBuffer wrapped to look like a SAB at runtime\n    const ab = new ArrayBuffer(bytes.byteLength)\n    new Uint8Array(ab).set(bytes)\n    return {\n      buffer: ab as unknown as SharedArrayBuffer,\n      meta: buildMeta(state),\n    }\n  }\n\n  const sab = new SharedArrayBuffer(bytes.byteLength)\n  new Uint8Array(sab).set(bytes)\n  return { buffer: sab, meta: buildMeta(state) }\n}\n\n/**\n * Adopt a snapshot previously produced by `transferableSnapshot`.\n *\n * SECURITY: same trust expectation as `attachWorld` — the sender of the\n * `TransferableSnapshot` (typically a Web Worker) must be trusted. The\n * function runs `validateMeta` and `deserializeWorld`, which enforce magic\n * + format version + length bounds on the binary header; but the inner\n * JSON payload, once decoded, is fed to `addComponent` and reaches AoS\n * components. For untrusted senders, use `aibridgejs` + `toJSON(world)` at\n * the application boundary instead.\n */\nexport function adoptSnapshot(snap: TransferableSnapshot): World {\n  validateMeta(snap.meta)\n  const bytes = new Uint8Array(snap.buffer)\n  return deserializeWorld(bytes)\n}\n\n/**\n * Adopt a SharedArrayBuffer-backed snapshot produced by `transferableSnapshot`.\n *\n * SECURITY: the SAB sender must be trusted. `attachWorld` performs the same\n * magic + version + length-bounds checks as `deserializeWorld`, but the JSON\n * payload itself is deserialised into AoS components via `addComponent`. If\n * the sender is untrusted (e.g. a third-party Web Worker that you do not\n * audit), prefer the higher-level `aibridgejs` channel + `toJSON(world)`\n * pattern, which lets you validate the shape at the application boundary\n * before constructing entities.\n */\nexport function attachWorld(buffer: SharedArrayBuffer, options?: { readOnly?: boolean }): World {\n  const bytes = new Uint8Array(buffer)\n  const world = deserializeWorld(bytes)\n  if (options?.readOnly) {\n    const state = getWorldState(world)\n    state.readOnly = true\n  }\n  return world\n}\n\nexport function detachWorld(world: World): void {\n  if (isWorldRegistered(world.id)) {\n    destroyWorld(world)\n  }\n}\n\nfunction buildMeta(state: WorldState): WorldMeta {\n  const componentSchemas: WorldMeta['componentSchemas'] = []\n  for (const info of state.componentInfoByBit) {\n    if (!info) continue\n    componentSchemas.push({ id: info.id, kind: info.kind, schema: info.schema })\n  }\n  return {\n    magic: MAGIC,\n    formatVersion: 1,\n    aiecsjsVersion: VERSION,\n    indexBits: state.options.indexBits,\n    generationBits: state.options.generationBits,\n    maxComponents: state.options.maxComponents,\n    maskWordCount: state.options.maskWordCount,\n    capacity: state.capacity,\n    componentSchemas,\n  }\n}\n\nfunction validateMeta(meta: WorldMeta): void {\n  if (meta.magic !== MAGIC) {\n    throw new Error('aiecsjs: invalid snapshot meta (wrong magic)')\n  }\n  if (meta.formatVersion !== 1) {\n    throw new Error(`aiecsjs: unsupported snapshot format version ${meta.formatVersion}`)\n  }\n}\n"]}
+{"version":3,"sources":["../src/worker.ts"],"names":["MAGIC","transferableSnapshot","world","state","getWorldState","bytes","serializeWorld","ab","buildMeta","sab","adoptSnapshot","snap","validateMeta","deserializeWorld","attachWorld","buffer","options","detachWorld","isWorldRegistered","destroyWorld","componentSchemas","info","VERSION","meta"],"mappings":"qHAkBA,IAAMA,CAAAA,CAAQ,WAEP,SAASC,CAAAA,CAAqBC,EAAoC,CACvE,IAAMC,CAAAA,CAAQC,mBAAAA,CAAcF,CAAK,CAAA,CAC3BG,EAAQC,mBAAAA,CAAeJ,CAAK,EAElC,GAAI,OAAO,kBAAsB,GAAA,CAAa,CAE5C,IAAMK,CAAAA,CAAK,IAAI,WAAA,CAAYF,EAAM,UAAU,CAAA,CAC3C,WAAI,UAAA,CAAWE,CAAE,EAAE,GAAA,CAAIF,CAAK,CAAA,CACrB,CACL,MAAA,CAAQE,CAAAA,CACR,KAAMC,CAAAA,CAAUL,CAAK,CACvB,CACF,CAEA,IAAMM,EAAM,IAAI,iBAAA,CAAkBJ,CAAAA,CAAM,UAAU,CAAA,CAClD,OAAA,IAAI,WAAWI,CAAG,CAAA,CAAE,IAAIJ,CAAK,CAAA,CACtB,CAAE,MAAA,CAAQI,CAAAA,CAAK,IAAA,CAAMD,CAAAA,CAAUL,CAAK,CAAE,CAC/C,CAaO,SAASO,CAAAA,CAAcC,CAAAA,CAAmC,CAC/DC,CAAAA,CAAaD,EAAK,IAAI,CAAA,CACtB,IAAMN,CAAAA,CAAQ,IAAI,UAAA,CAAWM,EAAK,MAAM,CAAA,CACxC,OAAOE,mBAAAA,CAAiBR,CAAK,CAC/B,CAaO,SAASS,CAAAA,CAAYC,CAAAA,CAA2BC,CAAAA,CAAyC,CAC9F,IAAMX,CAAAA,CAAQ,IAAI,UAAA,CAAWU,CAAM,CAAA,CAC7Bb,CAAAA,CAAQW,oBAAiBR,CAAK,CAAA,CACpC,GAAIW,CAAAA,EAAS,QAAA,CAAU,CACrB,IAAMb,CAAAA,CAAQC,mBAAAA,CAAcF,CAAK,CAAA,CACjCC,CAAAA,CAAM,SAAW,KACnB,CACA,OAAOD,CACT,CAEO,SAASe,EAAYf,CAAAA,CAAoB,CAC1CgB,mBAAAA,CAAkBhB,CAAAA,CAAM,EAAE,CAAA,EAC5BiB,oBAAajB,CAAK,EAEtB,CAEA,SAASM,CAAAA,CAAUL,CAAAA,CAA8B,CAC/C,IAAMiB,CAAAA,CAAkD,EAAC,CACzD,IAAA,IAAWC,KAAQlB,CAAAA,CAAM,kBAAA,CAClBkB,CAAAA,EACLD,CAAAA,CAAiB,IAAA,CAAK,CAAE,GAAIC,CAAAA,CAAK,EAAA,CAAI,IAAA,CAAMA,CAAAA,CAAK,IAAA,CAAM,MAAA,CAAQA,EAAK,MAAO,CAAC,CAAA,CAE7E,OAAO,CACL,KAAA,CAAOrB,EACP,aAAA,CAAe,CAAA,CACf,eAAgBsB,mBAAAA,CAChB,SAAA,CAAWnB,EAAM,OAAA,CAAQ,SAAA,CACzB,cAAA,CAAgBA,CAAAA,CAAM,OAAA,CAAQ,cAAA,CAC9B,cAAeA,CAAAA,CAAM,OAAA,CAAQ,aAAA,CAC7B,aAAA,CAAeA,CAAAA,CAAM,OAAA,CAAQ,cAC7B,QAAA,CAAUA,CAAAA,CAAM,QAAA,CAChB,gBAAA,CAAAiB,CACF,CACF,CAEA,SAASR,CAAAA,CAAaW,EAAuB,CAC3C,GAAIA,EAAK,KAAA,GAAUvB,CAAAA,CACjB,MAAM,IAAI,KAAA,CAAM,8CAA8C,EAEhE,GAAIuB,CAAAA,CAAK,aAAA,GAAkB,CAAA,CACzB,MAAM,IAAI,MAAM,CAAA,6CAAA,EAAgDA,CAAAA,CAAK,aAAa,CAAA,CAAE,CAExF","file":"worker.cjs","sourcesContent":["// aiecsjs/worker — SharedArrayBuffer helpers (experimental, snapshot-copy).\n//\n// Note: 0.x implements SAB as a transferable snapshot pattern rather than true\n// shared-memory aliasing. The world is serialized into the SAB, and the worker\n// reconstructs a fresh world from those bytes via adoptSnapshot/attachWorld.\n// True shared-column memory is targeted for a future stable release.\n// The API matches the documented contract and survives postMessage cleanly.\n//\n// EntityRef is in-memory only — not preserved across worker boundaries.\n// Generation counters reset on adoptSnapshot/attachWorld. Pass `EntityRef.id`\n// (the packed EntityId) across the worker boundary only if you understand that\n// the generation portion will be stale after a round-trip snapshot.\n\nimport type { TransferableSnapshot, World, WorldMeta, WorldState } from './internal/types.js'\nimport { destroyWorld, getWorldState, isWorldRegistered } from './internal/world.js'\nimport { deserializeWorld, serializeWorld } from './serialize.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 0x41494543 // 'AIEC' little-endian as uint32\n\nexport function transferableSnapshot(world: World): TransferableSnapshot {\n  const state = getWorldState(world)\n  const bytes = serializeWorld(world)\n\n  if (typeof SharedArrayBuffer === 'undefined') {\n    // Fallback: ArrayBuffer wrapped to look like a SAB at runtime\n    const ab = new ArrayBuffer(bytes.byteLength)\n    new Uint8Array(ab).set(bytes)\n    return {\n      buffer: ab as unknown as SharedArrayBuffer,\n      meta: buildMeta(state),\n    }\n  }\n\n  const sab = new SharedArrayBuffer(bytes.byteLength)\n  new Uint8Array(sab).set(bytes)\n  return { buffer: sab, meta: buildMeta(state) }\n}\n\n/**\n * Adopt a snapshot previously produced by `transferableSnapshot`.\n *\n * SECURITY: same trust expectation as `attachWorld` — the sender of the\n * `TransferableSnapshot` (typically a Web Worker) must be trusted. The\n * function runs `validateMeta` and `deserializeWorld`, which enforce magic\n * + format version + length bounds on the binary header; but the inner\n * JSON payload, once decoded, is fed to `addComponent` and reaches AoS\n * components. For untrusted senders, use `aibridgejs` + `toJSON(world)` at\n * the application boundary instead.\n */\nexport function adoptSnapshot(snap: TransferableSnapshot): World {\n  validateMeta(snap.meta)\n  const bytes = new Uint8Array(snap.buffer)\n  return deserializeWorld(bytes)\n}\n\n/**\n * Adopt a SharedArrayBuffer-backed snapshot produced by `transferableSnapshot`.\n *\n * SECURITY: the SAB sender must be trusted. `attachWorld` performs the same\n * magic + version + length-bounds checks as `deserializeWorld`, but the JSON\n * payload itself is deserialised into AoS components via `addComponent`. If\n * the sender is untrusted (e.g. a third-party Web Worker that you do not\n * audit), prefer the higher-level `aibridgejs` channel + `toJSON(world)`\n * pattern, which lets you validate the shape at the application boundary\n * before constructing entities.\n */\nexport function attachWorld(buffer: SharedArrayBuffer, options?: { readOnly?: boolean }): World {\n  const bytes = new Uint8Array(buffer)\n  const world = deserializeWorld(bytes)\n  if (options?.readOnly) {\n    const state = getWorldState(world)\n    state.readOnly = true\n  }\n  return world\n}\n\nexport function detachWorld(world: World): void {\n  if (isWorldRegistered(world.id)) {\n    destroyWorld(world)\n  }\n}\n\nfunction buildMeta(state: WorldState): WorldMeta {\n  const componentSchemas: WorldMeta['componentSchemas'] = []\n  for (const info of state.componentInfoByBit) {\n    if (!info) continue\n    componentSchemas.push({ id: info.id, kind: info.kind, schema: info.schema })\n  }\n  return {\n    magic: MAGIC,\n    formatVersion: 1,\n    aiecsjsVersion: VERSION,\n    indexBits: state.options.indexBits,\n    generationBits: state.options.generationBits,\n    maxComponents: state.options.maxComponents,\n    maskWordCount: state.options.maskWordCount,\n    capacity: state.capacity,\n    componentSchemas,\n  }\n}\n\nfunction validateMeta(meta: WorldMeta): void {\n  if (meta.magic !== MAGIC) {\n    throw new Error('aiecsjs: invalid snapshot meta (wrong magic)')\n  }\n  if (meta.formatVersion !== 1) {\n    throw new Error(`aiecsjs: unsupported snapshot format version ${meta.formatVersion}`)\n  }\n}\n"]}

package/dist/worker.js

@@ -1,2 +1,2 @@
-var b="0.3.0";function U(t){return new Uint32Array(t)}function _(t,n){let e=n>>>5;t[e]=(t[e]??0)|1<<(n&31);}function R(t,n){let e=n>>>5;return ((t[e]??0)&1<<(n&31))!==0}function k(t){let n=new Uint32Array(t.length);for(let e=0;e<t.length;e++)n[e]=t[e]??0;return n}function B(t){let n=[];for(let e=0;e<t.length;e++)n.push((t[e]??0).toString(16));return n.join(",")}var S={initialCapacity:1024,maxEntities:1e6,indexBits:24,generationBits:8},nt=256,et=1,A=new Map;function p(t){let n=A.get(t.id);if(!n)throw new Error(`aiecsjs: world ${t.id} is destroyed or unknown`);if(n.destroyed)throw new Error(`aiecsjs: world ${t.id} is destroyed`);return n}function ot(t){A.set(t.id,t);}function rt(t){A.delete(t);}function j(t){return A.has(t)}function it(t){let n=t??{},e=n.indexBits??S.indexBits,o=n.generationBits??S.generationBits,r=nt;if(e<1||e>24)throw new Error("aiecsjs: indexBits must be in [1, 24]");if(o<0||o>16)throw new Error("aiecsjs: generationBits must be in [0, 16]");let i=1<<e,s=Math.max(1,Math.min(n.initialCapacity??S.initialCapacity,i)),c=Math.max(s,Math.min(n.maxEntities??S.maxEntities,i));return {initialCapacity:s,maxEntities:c,indexBits:e,generationBits:o,indexMask:(1<<e)-1,generationMask:o===0?0:(1<<o)-1,maxComponents:r,maskWordCount:Math.ceil(r/32),buffer:n.buffer??null,bufferByteOffset:n.bufferByteOffset??0}}function st(t,n){return {id:0,mask:U(t),size:0,capacity:16,entities:new Uint32Array(16),entityRow:new Map,componentBits:[],edgeAdd:new Int32Array(n).fill(-1),edgeRemove:new Int32Array(n).fill(-1)}}function L(t){let n=it(t),e=et++,o=n.generationBits>8?Uint16Array:Uint8Array,r=new o(n.initialCapacity),i={id:e,capacity:n.initialCapacity,version:b,options:n,size:0,nextFreshIndex:1,freeList:[],generations:r,destroyed:false,componentBitFor:new Map,componentInfoByBit:new Array(n.maxComponents).fill(null),componentStorageByBit:new Array(n.maxComponents).fill(null),nextComponentBit:0,entityArchetype:new Uint32Array(n.initialCapacity),entityMask:new Uint32Array(n.initialCapacity*n.maskWordCount),archetypes:[],archetypeByMaskHash:new Map,queryVersion:0,queries:[],queryMasks:new Map,queryArchetypeCache:[],queryArchetypeStamp:[],bitToQueries:new Map,reactiveBuffers:new Map,observers:[],relationStorage:new Map,sab:n.buffer,readOnly:false},s=st(n.maskWordCount,n.maxComponents);return s.id=0,i.archetypes.push(s),i.archetypeByMaskHash.set(B(s.mask),0),ot(i),at(i)}function at(t){return {id:t.id,get capacity(){return t.capacity},version:t.version}}function T(t){let n=A.get(t.id);!n||n.destroyed||(n.destroyed=true,n.archetypes=[],n.archetypeByMaskHash.clear(),n.componentInfoByBit=[],n.componentStorageByBit=[],n.queries=[],n.queryMasks.clear(),n.queryArchetypeCache=[],n.observers=[],n.relationStorage.clear(),n.reactiveBuffers.clear(),rt(t.id));}function z(t,n){if(n<=t.capacity)return;if(n>t.options.maxEntities)throw new Error(`aiecsjs: requested capacity ${n} exceeds maxEntities ${t.options.maxEntities}`);let e=t.capacity;for(;e<n;)e=Math.min(e*2,t.options.maxEntities);ct(t,e);}function ct(t,n){let e=t.generations.constructor,o=new e(n);o.set(t.generations),t.generations=o;let r=new Uint32Array(n);r.set(t.entityArchetype),t.entityArchetype=r;let i=t.options.maskWordCount,s=new Uint32Array(n*i);s.set(t.entityMask),t.entityMask=s;for(let c of t.componentStorageByBit)if(c)if(c.kind==="soa"&&c.soa){let a=t.componentInfoByBit[c.bit];a&&dt(c.soa,a.fields,n);}else c.kind==="aos"&&c.aos&&(c.aos.length=n);t.capacity=n;}function dt(t,n,e){for(let o of n){let r=t[o.name];if(!r)continue;let i=e*o.vectorLen;if(r.length>=i)continue;let s=new o.ctor(i);s.set(r),t[o.name]=s;}}function D(t,n){let e=B(n),o=t.archetypeByMaskHash.get(e);if(o!==void 0)return {archId:o,created:false};let r=t.archetypes.length,i={id:r,mask:k(n),size:0,capacity:16,entities:new Uint32Array(16),entityRow:new Map,componentBits:ft(n),edgeAdd:new Int32Array(t.options.maxComponents).fill(-1),edgeRemove:new Int32Array(t.options.maxComponents).fill(-1)};return t.archetypes.push(i),t.archetypeByMaskHash.set(e,r),t.queryVersion++,{archId:r,created:true}}function C(t,n){if(n<=t.capacity)return;let e=t.capacity;for(;e<n;)e*=2;let o=new Uint32Array(e);o.set(t.entities),t.entities=o,t.capacity=e;}function ft(t){let n=[];for(let e=0;e<t.length;e++){let o=t[e]??0;for(;o!==0;){let r=o&-o,i=(e<<5)+(31-Math.clz32(r));n.push(i),o&=o-1;}}return n}function F(t,n){let e=t.componentBitFor.get(n.id);if(e!==void 0)return e;if(t.nextComponentBit>=t.options.maxComponents)throw new Error(`aiecsjs: world reached maxComponents=${t.options.maxComponents}`);let o=t.nextComponentBit++;t.componentBitFor.set(n.id,o),t.componentInfoByBit[o]=n;let r;if(n.kind==="soa"){let i={};for(let s of n.fields)i[s.name]=new s.ctor(t.capacity*s.vectorLen);r={kind:"soa",componentId:n.id,bit:o,soa:i};}else n.kind==="aos"?r={kind:"aos",componentId:n.id,bit:o,aos:new Array(t.capacity)}:r={kind:"tag",componentId:n.id,bit:o};return t.componentStorageByBit[o]=r,o}function N(t,n){let e=t.options.maskWordCount,o=new Uint32Array(e),i=(n&t.options.indexMask)*e;for(let s=0;s<e;s++)o[s]=t.entityMask[i+s]??0;return o}function V(t,n,e){let o=t.options.maskWordCount,i=(n&t.options.indexMask)*o;for(let s=0;s<o;s++)t.entityMask[i+s]=e[s]??0;}function pt(t,n,e){return (n&e.generationMask)<<e.indexBits|t&e.indexMask}function P(t){let n=p(t);if(n.readOnly)throw new Error("aiecsjs: cannot createEntity on a read-only world (worker-attached)");let e;if(n.freeList.length>0)e=n.freeList.pop();else {if(n.nextFreshIndex>=n.options.maxEntities)throw new Error(`aiecsjs: reached maxEntities ${n.options.maxEntities}`);n.nextFreshIndex>=n.capacity&&z(n,n.nextFreshIndex+1),e=n.nextFreshIndex++;}let o=n.generations[e]??0,r=pt(e,o,n.options),i=n.archetypes[0];if(!i)throw new Error("aiecsjs: missing empty archetype");C(i,i.size+1);let s=i.size;i.entities[s]=r,i.entityRow.set(r,s),i.size++,n.entityArchetype[e]=0;let c=n.options.maskWordCount,a=e*c;for(let d=0;d<c;d++)n.entityMask[a+d]=0;return n.size++,r}function $(t,n){let e=n&t.options.indexMask;if(e<=0||e>=t.capacity)return  false;let o=t.entityArchetype[e]??0,r=t.archetypes[o];if(!r||!r.entityRow.has(n))return  false;let i=t.generations[e]??0,s=n>>>t.options.indexBits&t.options.generationMask;return i===s}var G=new Map;function H(t){let n=G.get(t.__id);if(!n)throw new Error("aiecsjs: component is not registered (call defineComponent/defineTag/defineObjectComponent)");return n}function J(t,n,e,o){let r=p(t);if(r.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");if(!$(r,n))throw new Error(`aiecsjs: addComponent on dead entity ${n}`);let i=H(e),s=F(r,i),c=N(r,n);if(R(c,s)){o!==void 0&&q(r,n,e,o);return}let a=k(c);_(a,s),yt(r,n,a),q(r,n,e,o);}function q(t,n,e,o){let r=H(e),i=t.componentBitFor.get(r.id);if(i===void 0)return;let s=t.componentStorageByBit[i];if(!s)return;let c=n&t.options.indexMask;if(r.kind==="soa"&&s.soa){if(o==null)return;let a=o;for(let d of r.fields){if(!(d.name in a))continue;let l=s.soa[d.name];if(!l)continue;let f=a[d.name];if(d.vectorLen===1)l[c]=typeof f=="boolean"?f?1:0:Number(f);else if(Array.isArray(f)||ArrayBuffer.isView(f)){let u=c*d.vectorLen,W=f;for(let m=0;m<d.vectorLen;m++)l[u+m]=Number(W[m]??0);}}}else if(r.kind==="aos"&&s.aos){let a=r.factory??(()=>({})),d=s.aos[c];if(d===void 0&&(d=a(),s.aos[c]=d),o&&typeof o=="object"){let l=o,f=d;for(let u of Object.keys(l))u==="__proto__"||u==="constructor"||u==="prototype"||(f[u]=l[u]);}}}function yt(t,n,e){let o=n&t.options.indexMask,r=t.entityArchetype[o]??0,i=t.archetypes[r];if(!i)return;let c=D(t,e).archId,a=t.archetypes[c];if(a){if(c!==r){let d=i.entityRow.get(n);if(d!==void 0){let f=i.size-1;if(d!==f){let u=i.entities[f]??0;i.entities[d]=u,i.entityRow.set(u,d);}i.entities[f]=0,i.entityRow.delete(n),i.size--;}C(a,a.size+1);let l=a.size;a.entities[l]=n,a.entityRow.set(n,l),a.size++,t.entityArchetype[o]=c;}V(t,n,e);}}function X(t){return G.get(t)}var y="AIEC",Y=1;function K(t,n){let e=At(t);return kt(e)}function M(t,n){let e=St(t);return gt(e)}function At(t){let n=p(t),e=[];for(let o=1;o<n.capacity;o++){let r=n.entityArchetype[o]??0;if(r===0)continue;let i=n.archetypes[r];if(!i)continue;let c=((n.generations[o]??0)&n.options.generationMask)<<n.options.indexBits|o&n.options.indexMask;if(!i.entityRow.has(c))continue;let a=n.options.maskWordCount,d=o*a,l=[];for(let f=0;f<a;f++){let u=n.entityMask[d+f]??0;for(;u!==0;){let W=u&-u,m=(f<<5)+(31-Math.clz32(W)),h=n.componentInfoByBit[m];if(h){let g=n.componentStorageByBit[m],x=null;if(h.kind==="soa"&&g?.soa){let E={};for(let w of h.fields){let I=g.soa[w.name];if(I)if(w.vectorLen===1)E[w.name]=I[o];else {let O=[],tt=o*w.vectorLen;for(let v=0;v<w.vectorLen;v++)O.push(I[tt+v]??0);E[w.name]=O;}}x=E;}else h.kind==="aos"&&g?.aos?x=g.aos[o]??null:x=true;l.push({kind:h.kind,id:h.id,data:x});}u&=u-1;}}e.push({eid:o,components:l});}return {version:n.version,capacity:n.capacity,entities:e}}function gt(t){let n=L({initialCapacity:t.capacity}),e=new Map;for(let o of t.entities){let r=P(n);e.set(o.eid,r);}for(let o of t.entities){let r=e.get(o.eid);for(let i of o.components){let s=X(i.id);if(!s)continue;let c=xt(s);c&&J(n,r,c,i.data);}}return n}function xt(t){if(t.kind==="soa")return {__kind:"soa",__id:t.id,__schema:t.schema??{}};if(t.kind==="aos"){let n=t.factory??(()=>({}));return {__kind:"aos",__id:t.id,__factory:n}}return {__kind:"tag",__id:t.id}}function kt(t){let n=JSON.stringify(t),e=new TextEncoder().encode(n),o=new TextEncoder().encode(b),i=12+o.length+4+e.length,s=new Uint8Array(i),c=new DataView(s.buffer),a=0;return s[a++]=y.charCodeAt(0),s[a++]=y.charCodeAt(1),s[a++]=y.charCodeAt(2),s[a++]=y.charCodeAt(3),c.setUint32(a,Y,true),a+=4,c.setUint32(a,o.length,true),a+=4,s.set(o,a),a+=o.length,c.setUint32(a,e.length,true),a+=4,s.set(e,a),s}function St(t,n){if(t.length<12)throw new Error("aiecsjs: bytes too short to be a valid snapshot");let e=new DataView(t.buffer,t.byteOffset,t.byteLength);if(t[0]!==y.charCodeAt(0)||t[1]!==y.charCodeAt(1)||t[2]!==y.charCodeAt(2)||t[3]!==y.charCodeAt(3))throw new Error("aiecsjs: invalid magic bytes");let o=4,r=e.getUint32(o,true);o+=4;let i="throw";if(r!==Y&&i==="throw")throw new Error(`aiecsjs: format version ${r} not supported`);let s=64*1024*1024;if(o+4>t.length)throw new Error("aiecsjs: snapshot truncated before verLen");let c=e.getUint32(o,true);if(o+=4,c>s||o+c>t.length)throw new Error(`aiecsjs: snapshot verLen=${c} out of bounds`);if(o+=c,o+4>t.length)throw new Error("aiecsjs: snapshot truncated before jsonLen");let a=e.getUint32(o,true);if(o+=4,a>s||o+a>t.length)throw new Error(`aiecsjs: snapshot jsonLen=${a} out of bounds`);let d=t.subarray(o,o+a),l=new TextDecoder().decode(d);return JSON.parse(l)}var Z=1095320899;function on(t){let n=p(t),e=K(t);if(typeof SharedArrayBuffer>"u"){let r=new ArrayBuffer(e.byteLength);return new Uint8Array(r).set(e),{buffer:r,meta:Q(n)}}let o=new SharedArrayBuffer(e.byteLength);return new Uint8Array(o).set(e),{buffer:o,meta:Q(n)}}function rn(t){Ct(t.meta);let n=new Uint8Array(t.buffer);return M(n)}function sn(t,n){let e=new Uint8Array(t),o=M(e);if(n?.readOnly){let r=p(o);r.readOnly=true;}return o}function an(t){j(t.id)&&T(t);}function Q(t){let n=[];for(let e of t.componentInfoByBit)e&&n.push({id:e.id,kind:e.kind,schema:e.schema});return {magic:Z,formatVersion:1,aiecsjsVersion:b,indexBits:t.options.indexBits,generationBits:t.options.generationBits,maxComponents:t.options.maxComponents,maskWordCount:t.options.maskWordCount,capacity:t.capacity,componentSchemas:n}}function Ct(t){if(t.magic!==Z)throw new Error("aiecsjs: invalid snapshot meta (wrong magic)");if(t.formatVersion!==1)throw new Error(`aiecsjs: unsupported snapshot format version ${t.formatVersion}`)}export{rn as adoptSnapshot,sn as attachWorld,an as detachWorld,on as transferableSnapshot};//# sourceMappingURL=worker.js.map
+import {a,b as b$1}from'./chunk-QOKIEF7C.js';import {i,j,l as l$1,a as a$1}from'./chunk-L5CMKMIP.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/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts","../src/internal/bitmask.ts","../src/internal/world.ts","../src/internal/entity.ts","../src/internal/component.ts","../src/serialize.ts","../src/worker.ts"],"names":["VERSION","createMask","wordCount","setBit","mask","bit","w","testBit","cloneMask","src","out","i","maskHash","m","parts","DEFAULT_OPTIONS","DEFAULT_MAX_COMPONENTS","nextWorldId","worldRegistry","getWorldState","world","state","registerWorld","unregisterWorld","id","isWorldRegistered","resolveOptions","opts","o","indexBits","generationBits","maxComponents","maxByIndex","initialCapacity","maxEntities","createEmptyArchetype","maskWordCount","createWorld","options","resolved","generationCtor","generations","empty","makePublicWorld","destroyWorld","ensureCapacity","needed","newCap","growEntityArrays","genCtor","newGen","newArch","newMask","storage","info","growSoAColumns","soa","fields","f","old","newLen","next","findOrCreateArchetype","key","existing","arch","collectBits","ensureArchetypeCapacity","bits","word","lsb","getOrRegisterComponentBit","readEntityMask","eid","base","writeEntityMask","packEid","idx","gen","createEntity","row","isAliveInternal","archId","storedGen","refGen","componentInfoById","getComponentInfo","component","addComponent","initial","prevMask","writeInitial","migrateEntity","packedEid","obj","col","val","arr","factory","inst","target","srcArchId","srcArch","destArchId","destArch","lastRow","moved","newRow","getComponentByInternalId","MAGIC","FORMAT_VERSION","serializeWorld","snapshot","toJSON","packBinary","deserializeWorld","bytes","unpackBinary","fromJSON","entities","components","wi","data","baseI","eidMap","e","comp","handle","getComponentHandle","json","jsonBytes","versionBytes","total","view","off","formatVersion","onUnknown","MAX_FIELD_LEN","verLen","jsonLen","transferableSnapshot","ab","buildMeta","sab","adoptSnapshot","snap","validateMeta","attachWorld","buffer","detachWorld","componentSchemas","meta"],"mappings":"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","file":"worker.js","sourcesContent":["export const VERSION = '0.3.0'\n","// Multi-word Uint32 bitmask helpers.\n\nexport function createMask(wordCount: number): Uint32Array {\n  return new Uint32Array(wordCount)\n}\n\nexport function setBit(mask: Uint32Array, bit: number): void {\n  const w = bit >>> 5\n  mask[w] = (mask[w] ?? 0) | (1 << (bit & 31))\n}\n\nexport function clearBit(mask: Uint32Array, bit: number): void {\n  const w = bit >>> 5\n  mask[w] = (mask[w] ?? 0) & ~(1 << (bit & 31))\n}\n\nexport function testBit(mask: Uint32Array, bit: number): boolean {\n  const w = bit >>> 5\n  return ((mask[w] ?? 0) & (1 << (bit & 31))) !== 0\n}\n\nexport function copyMask(dst: Uint32Array, src: Uint32Array): void {\n  const n = src.length\n  for (let i = 0; i < n; i++) dst[i] = src[i] ?? 0\n}\n\nexport function cloneMask(src: Uint32Array): Uint32Array {\n  const out = new Uint32Array(src.length)\n  for (let i = 0; i < src.length; i++) out[i] = src[i] ?? 0\n  return out\n}\n\nexport function maskEquals(a: Uint32Array, b: Uint32Array): boolean {\n  const n = a.length\n  if (b.length !== n) return false\n  for (let i = 0; i < n; i++) if ((a[i] ?? 0) !== (b[i] ?? 0)) return false\n  return true\n}\n\nexport function maskHash(m: Uint32Array): string {\n  // Stable string key for Map lookups. Hex-joined.\n  const parts: string[] = []\n  for (let i = 0; i < m.length; i++) {\n    parts.push((m[i] ?? 0).toString(16))\n  }\n  return parts.join(',')\n}\n\nexport function isMaskZero(m: Uint32Array): boolean {\n  for (let i = 0; i < m.length; i++) if ((m[i] ?? 0) !== 0) return false\n  return true\n}\n\nexport function unionMask(a: Uint32Array, b: Uint32Array): Uint32Array {\n  const out = new Uint32Array(a.length)\n  for (let i = 0; i < a.length; i++) out[i] = (a[i] ?? 0) | (b[i] ?? 0)\n  return out\n}\n\n/**\n * Test whether an archetype's mask matches a query.\n *   - withMask: all of these bits must be present\n *   - anyMask:  if anyHasBits, at least one of these bits must be present\n *   - noneMask: none of these bits may be present\n */\nexport function matches(\n  mask: Uint32Array,\n  withMask: Uint32Array,\n  anyMask: Uint32Array,\n  noneMask: Uint32Array,\n  anyHasBits: boolean,\n  words: number,\n): boolean {\n  let anyHit = !anyHasBits\n  for (let w = 0; w < words; w++) {\n    const m = mask[w] ?? 0\n    const wm = withMask[w] ?? 0\n    const am = anyMask[w] ?? 0\n    const nm = noneMask[w] ?? 0\n    if ((m & wm) !== wm) return false\n    if ((m & nm) !== 0) return false\n    if (!anyHit && (m & am) !== 0) anyHit = true\n  }\n  return anyHit\n}\n\nexport function listBits(mask: Uint32Array): number[] {\n  const out: number[] = []\n  for (let w = 0; w < mask.length; w++) {\n    let word = mask[w] ?? 0\n    while (word !== 0) {\n      const bit = (w << 5) + ctz32(word)\n      out.push(bit)\n      word &= word - 1\n    }\n  }\n  return out\n}\n\n// Iterate set bits in a slice of a larger Uint32Array starting at `base`.\n// Shared by destroy paths and storage cleanup so the bit-extraction maths\n// lives in exactly one place.\nexport function forEachSetBit(\n  mask: Uint32Array,\n  base: number,\n  words: number,\n  fn: (bit: number) => void,\n): void {\n  for (let wi = 0; wi < words; wi++) {\n    let word = mask[base + wi] ?? 0\n    while (word !== 0) {\n      const bit = (wi << 5) + ctz32(word)\n      fn(bit)\n      word &= word - 1\n    }\n  }\n}\n\n// Match a query against an entity's mask stored as a slice inside a larger\n// Uint32Array. Reading directly from the parent array avoids the temporary\n// Uint32Array allocation on every observer dispatch.\nexport function matchesEntityMask(\n  entityMask: Uint32Array,\n  base: number,\n  words: number,\n  withMask: Uint32Array,\n  anyMask: Uint32Array,\n  noneMask: Uint32Array,\n  anyHasBits: boolean,\n): boolean {\n  let anyHit = !anyHasBits\n  for (let i = 0; i < words; i++) {\n    const m = entityMask[base + i] ?? 0\n    const wm = withMask[i] ?? 0\n    const am = anyMask[i] ?? 0\n    const nm = noneMask[i] ?? 0\n    if ((m & wm) !== wm) return false\n    if ((m & nm) !== 0) return false\n    if (!anyHit && (m & am) !== 0) anyHit = true\n  }\n  return anyHit\n}\n\nfunction ctz32(v: number): number {\n  // Count trailing zeros in a 32-bit integer (assumes v !== 0)\n  return 31 - Math.clz32(v & -v)\n}\n","import { VERSION } from '../version.js'\nimport { cloneMask, copyMask, createMask, maskHash } from './bitmask.js'\nimport type {\n  ArchetypeState,\n  ComponentInfo,\n  FieldInfo,\n  ResolvedWorldOptions,\n  World,\n  WorldComponentStorage,\n  WorldOptions,\n  WorldState,\n} from './types.js'\n\nexport const WORLD_BRAND = Symbol.for('aiecsjs.world')\n\nconst DEFAULT_OPTIONS: Required<Omit<WorldOptions, 'buffer' | 'bufferByteOffset'>> = {\n  initialCapacity: 1024,\n  maxEntities: 1_000_000,\n  indexBits: 24,\n  generationBits: 8,\n}\n\nconst DEFAULT_MAX_COMPONENTS = 256\n\nlet nextWorldId = 1\nconst worldRegistry = new Map<number, WorldState>()\n\nexport function getWorldState(world: World): WorldState {\n  const state = worldRegistry.get(world.id)\n  if (!state) throw new Error(`aiecsjs: world ${world.id} is destroyed or unknown`)\n  if (state.destroyed) throw new Error(`aiecsjs: world ${world.id} is destroyed`)\n  return state\n}\n\nexport function registerWorld(state: WorldState): void {\n  worldRegistry.set(state.id, state)\n}\n\nexport function unregisterWorld(id: number): void {\n  worldRegistry.delete(id)\n}\n\nexport function isWorldRegistered(id: number): boolean {\n  return worldRegistry.has(id)\n}\n\nfunction resolveOptions(opts: WorldOptions | undefined): ResolvedWorldOptions {\n  const o = opts ?? {}\n  const indexBits = o.indexBits ?? DEFAULT_OPTIONS.indexBits\n  const generationBits = o.generationBits ?? DEFAULT_OPTIONS.generationBits\n  const maxComponents = DEFAULT_MAX_COMPONENTS\n  if (indexBits < 1 || indexBits > 24) {\n    throw new Error('aiecsjs: indexBits must be in [1, 24]')\n  }\n  if (generationBits < 0 || generationBits > 16) {\n    throw new Error('aiecsjs: generationBits must be in [0, 16]')\n  }\n  const maxByIndex = 1 << indexBits\n  const initialCapacity = Math.max(\n    1,\n    Math.min(o.initialCapacity ?? DEFAULT_OPTIONS.initialCapacity, maxByIndex),\n  )\n  const maxEntities = Math.max(\n    initialCapacity,\n    Math.min(o.maxEntities ?? DEFAULT_OPTIONS.maxEntities, maxByIndex),\n  )\n  return {\n    initialCapacity,\n    maxEntities,\n    indexBits,\n    generationBits,\n    indexMask: (1 << indexBits) - 1,\n    generationMask: generationBits === 0 ? 0 : (1 << generationBits) - 1,\n    maxComponents,\n    maskWordCount: Math.ceil(maxComponents / 32),\n    buffer: o.buffer ?? null,\n    bufferByteOffset: o.bufferByteOffset ?? 0,\n  }\n}\n\nexport function createEmptyArchetype(maskWordCount: number, maxComponents: number): ArchetypeState {\n  return {\n    id: 0,\n    mask: createMask(maskWordCount),\n    size: 0,\n    capacity: 16,\n    entities: new Uint32Array(16),\n    entityRow: new Map<number, number>(),\n    componentBits: [],\n    edgeAdd: new Int32Array(maxComponents).fill(-1),\n    edgeRemove: new Int32Array(maxComponents).fill(-1),\n  }\n}\n\nexport function createWorld(options?: WorldOptions): World {\n  const resolved = resolveOptions(options)\n  const id = nextWorldId++\n\n  const generationCtor = resolved.generationBits > 8 ? Uint16Array : Uint8Array\n  const generations = new generationCtor(resolved.initialCapacity)\n\n  const state: WorldState = {\n    id,\n    capacity: resolved.initialCapacity,\n    version: VERSION,\n    options: resolved,\n    size: 0,\n    nextFreshIndex: 1, // 0 reserved\n    freeList: [],\n    generations,\n    destroyed: false,\n    componentBitFor: new Map<number, number>(),\n    componentInfoByBit: new Array(resolved.maxComponents).fill(null),\n    componentStorageByBit: new Array(resolved.maxComponents).fill(null),\n    nextComponentBit: 0,\n    entityArchetype: new Uint32Array(resolved.initialCapacity),\n    entityMask: new Uint32Array(resolved.initialCapacity * resolved.maskWordCount),\n    archetypes: [],\n    archetypeByMaskHash: new Map<string, number>(),\n    queryVersion: 0,\n    queries: [],\n    queryMasks: new Map(),\n    queryArchetypeCache: [],\n    queryArchetypeStamp: [],\n    bitToQueries: new Map<number, Set<number>>(),\n    reactiveBuffers: new Map(),\n    observers: [],\n    relationStorage: new Map(),\n    sab: resolved.buffer,\n    readOnly: false,\n  }\n\n  // Seed archetype 0 (the empty mask)\n  const empty = createEmptyArchetype(resolved.maskWordCount, resolved.maxComponents)\n  empty.id = 0\n  state.archetypes.push(empty)\n  state.archetypeByMaskHash.set(maskHash(empty.mask), 0)\n\n  registerWorld(state)\n  return makePublicWorld(state)\n}\n\nexport function makePublicWorld(state: WorldState): World {\n  return {\n    id: state.id,\n    get capacity() {\n      return state.capacity\n    },\n    version: state.version,\n  } as World\n}\n\nexport function destroyWorld(world: World): void {\n  const state = worldRegistry.get(world.id)\n  if (!state || state.destroyed) return\n  state.destroyed = true\n  // Clear large buffers to help GC\n  state.archetypes = []\n  state.archetypeByMaskHash.clear()\n  state.componentInfoByBit = []\n  state.componentStorageByBit = []\n  state.queries = []\n  state.queryMasks.clear()\n  state.queryArchetypeCache = []\n  state.observers = []\n  state.relationStorage.clear()\n  state.reactiveBuffers.clear()\n  unregisterWorld(world.id)\n}\n\nexport function resetWorld(world: World): void {\n  const state = getWorldState(world)\n  // Keep capacity and registered components; clear entities and per-entity state.\n  state.size = 0\n  state.nextFreshIndex = 1\n  state.freeList = []\n  state.generations.fill(0)\n  state.entityArchetype.fill(0)\n  state.entityMask.fill(0)\n  // Wipe archetype memberships but keep archetype graph for stability.\n  for (const arch of state.archetypes) {\n    arch.size = 0\n    arch.entityRow.clear()\n  }\n  // Clear SoA columns and AoS instances; storage allocation is preserved.\n  for (const storage of state.componentStorageByBit) {\n    if (!storage) continue\n    if (storage.kind === 'soa' && storage.soa) {\n      for (const k of Object.keys(storage.soa)) {\n        storage.soa[k]?.fill(0)\n      }\n    } else if (storage.kind === 'aos' && storage.aos) {\n      storage.aos.fill(undefined as unknown as never)\n    }\n  }\n  state.queryVersion++\n  for (const buf of state.reactiveBuffers.values()) {\n    buf.entered.length = 0\n    buf.exited.length = 0\n  }\n}\n\nexport function getWorldSize(world: World): number {\n  return getWorldState(world).size\n}\n\nexport function getWorldCapacity(world: World): number {\n  return getWorldState(world).capacity\n}\n\n// --- Capacity growth ---\n\nexport function ensureCapacity(state: WorldState, needed: number): void {\n  if (needed <= state.capacity) return\n  if (needed > state.options.maxEntities) {\n    throw new Error(\n      `aiecsjs: requested capacity ${needed} exceeds maxEntities ${state.options.maxEntities}`,\n    )\n  }\n  let newCap = state.capacity\n  while (newCap < needed) newCap = Math.min(newCap * 2, state.options.maxEntities)\n  growEntityArrays(state, newCap)\n}\n\nfunction growEntityArrays(state: WorldState, newCap: number): void {\n  // generations\n  const genCtor: any = state.generations.constructor\n  const newGen = new genCtor(newCap) as Uint8Array | Uint16Array\n  ;(newGen as Uint8Array).set(state.generations as Uint8Array)\n  state.generations = newGen\n\n  // entityArchetype\n  const newArch = new Uint32Array(newCap)\n  newArch.set(state.entityArchetype)\n  state.entityArchetype = newArch\n\n  // entityMask\n  const wordCount = state.options.maskWordCount\n  const newMask = new Uint32Array(newCap * wordCount)\n  newMask.set(state.entityMask)\n  state.entityMask = newMask\n\n  // Component storages (SoA columns + AoS arrays)\n  for (const storage of state.componentStorageByBit) {\n    if (!storage) continue\n    if (storage.kind === 'soa' && storage.soa) {\n      const info = state.componentInfoByBit[storage.bit]\n      if (info) growSoAColumns(storage.soa, info.fields, newCap)\n    } else if (storage.kind === 'aos' && storage.aos) {\n      storage.aos.length = newCap\n    }\n  }\n\n  state.capacity = newCap\n}\n\nfunction growSoAColumns(soa: Record<string, any>, fields: FieldInfo[], newCap: number): void {\n  for (const f of fields) {\n    const old = soa[f.name]\n    if (!old) continue\n    const newLen = newCap * f.vectorLen\n    if (old.length >= newLen) continue\n    const next = new f.ctor(newLen)\n    next.set(old)\n    soa[f.name] = next\n  }\n}\n\n// --- Archetype management ---\n\nexport function findOrCreateArchetype(\n  state: WorldState,\n  mask: Uint32Array,\n): { archId: number; created: boolean } {\n  const key = maskHash(mask)\n  const existing = state.archetypeByMaskHash.get(key)\n  if (existing !== undefined) return { archId: existing, created: false }\n\n  const id = state.archetypes.length\n  const arch: ArchetypeState = {\n    id,\n    mask: cloneMask(mask),\n    size: 0,\n    capacity: 16,\n    entities: new Uint32Array(16),\n    entityRow: new Map<number, number>(),\n    componentBits: collectBits(mask),\n    edgeAdd: new Int32Array(state.options.maxComponents).fill(-1),\n    edgeRemove: new Int32Array(state.options.maxComponents).fill(-1),\n  }\n  state.archetypes.push(arch)\n  state.archetypeByMaskHash.set(key, id)\n  state.queryVersion++\n  return { archId: id, created: true }\n}\n\nexport function ensureArchetypeCapacity(arch: ArchetypeState, needed: number): void {\n  if (needed <= arch.capacity) return\n  let newCap = arch.capacity\n  while (newCap < needed) newCap *= 2\n  const next = new Uint32Array(newCap)\n  next.set(arch.entities)\n  arch.entities = next\n  arch.capacity = newCap\n}\n\nfunction collectBits(mask: Uint32Array): number[] {\n  const bits: number[] = []\n  for (let w = 0; w < mask.length; w++) {\n    let word = mask[w] ?? 0\n    while (word !== 0) {\n      const lsb = word & -word\n      const bit = (w << 5) + (31 - Math.clz32(lsb))\n      bits.push(bit)\n      word &= word - 1\n    }\n  }\n  return bits\n}\n\n// --- Component registration in a world ---\n\nexport function getOrRegisterComponentBit(state: WorldState, info: ComponentInfo): number {\n  const existing = state.componentBitFor.get(info.id)\n  if (existing !== undefined) return existing\n\n  if (state.nextComponentBit >= state.options.maxComponents) {\n    throw new Error(`aiecsjs: world reached maxComponents=${state.options.maxComponents}`)\n  }\n  const bit = state.nextComponentBit++\n  state.componentBitFor.set(info.id, bit)\n  state.componentInfoByBit[bit] = info\n\n  // Create storage\n  let storage: WorldComponentStorage\n  if (info.kind === 'soa') {\n    const soa: Record<string, any> = {}\n    for (const f of info.fields) {\n      soa[f.name] = new f.ctor(state.capacity * f.vectorLen)\n    }\n    storage = { kind: 'soa', componentId: info.id, bit, soa }\n  } else if (info.kind === 'aos') {\n    storage = { kind: 'aos', componentId: info.id, bit, aos: new Array(state.capacity) }\n  } else {\n    storage = { kind: 'tag', componentId: info.id, bit }\n  }\n  state.componentStorageByBit[bit] = storage\n  return bit\n}\n\n// Read a bitmask out of state.entityMask[] into a fresh Uint32Array.\nexport function readEntityMask(state: WorldState, eid: number): Uint32Array {\n  const w = state.options.maskWordCount\n  const out = new Uint32Array(w)\n  const idx = eid & state.options.indexMask\n  const base = idx * w\n  for (let i = 0; i < w; i++) out[i] = state.entityMask[base + i] ?? 0\n  return out\n}\n\nexport function writeEntityMask(state: WorldState, eid: number, mask: Uint32Array): void {\n  const w = state.options.maskWordCount\n  const idx = eid & state.options.indexMask\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = mask[i] ?? 0\n}\n\n// Get the bit of a component within a world without registering.\nexport function tryGetComponentBit(state: WorldState, info: ComponentInfo): number | undefined {\n  return state.componentBitFor.get(info.id)\n}\n\nexport function isWorld(x: unknown): x is World {\n  if (!x || typeof x !== 'object') return false\n  const obj = x as { id?: unknown; version?: unknown }\n  if (typeof obj.id !== 'number') return false\n  if (typeof obj.version !== 'string') return false\n  return worldRegistry.has(obj.id)\n}\n","import { clearAllEntityStorages } from './component.js'\nimport type { EntityId, ResolvedWorldOptions, World, WorldState } from './types.js'\nimport { ensureArchetypeCapacity, ensureCapacity, getWorldState } from './world.js'\n\n// --- Default bit layout constants (used by public getEntityIndex / getEntityGeneration / packEntity) ---\n// These use the default 24/8 split. See §4.4 limitation: callers using non-default\n// createWorld({ indexBits, generationBits }) should not rely on these functions for unpacking.\nexport const DEFAULT_INDEX_BITS = 24\nexport const DEFAULT_GENERATION_BITS = 8\nexport const DEFAULT_INDEX_MASK = (1 << DEFAULT_INDEX_BITS) - 1\nexport const DEFAULT_GENERATION_MASK = (1 << DEFAULT_GENERATION_BITS) - 1\n\n// --- Internal pack/unpack helpers (world-options-aware) ---\n\nexport function packEid(idx: number, gen: number, opts: ResolvedWorldOptions): EntityId {\n  return (((gen & opts.generationMask) << opts.indexBits) | (idx & opts.indexMask)) as EntityId\n}\n\nexport function unpackIdx(eid: number, opts: ResolvedWorldOptions): number {\n  return eid & opts.indexMask\n}\n\nexport function unpackGen(eid: number, opts: ResolvedWorldOptions): number {\n  return (eid >>> opts.indexBits) & opts.generationMask\n}\n\nexport function createEntity(world: World): EntityId {\n  const state = getWorldState(world)\n  if (state.readOnly) {\n    throw new Error('aiecsjs: cannot createEntity on a read-only world (worker-attached)')\n  }\n\n  let idx: number\n  if (state.freeList.length > 0) {\n    idx = state.freeList.pop()!\n  } else {\n    if (state.nextFreshIndex >= state.options.maxEntities) {\n      throw new Error(`aiecsjs: reached maxEntities ${state.options.maxEntities}`)\n    }\n    if (state.nextFreshIndex >= state.capacity) {\n      ensureCapacity(state, state.nextFreshIndex + 1)\n    }\n    idx = state.nextFreshIndex++\n  }\n\n  const gen = state.generations[idx] ?? 0\n  const eid = packEid(idx, gen, state.options)\n\n  // Move into the empty archetype (0)\n  const arch = state.archetypes[0]\n  if (!arch) throw new Error('aiecsjs: missing empty archetype')\n  ensureArchetypeCapacity(arch, arch.size + 1)\n  const row = arch.size\n  arch.entities[row] = eid\n  arch.entityRow.set(eid, row)\n  arch.size++\n\n  state.entityArchetype[idx] = 0\n  // Reset entityMask row for this idx\n  const w = state.options.maskWordCount\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n\n  state.size++\n  return eid\n}\n\nexport function destroyEntity(world: World, eid: EntityId): void {\n  const state = getWorldState(world)\n  if (state.readOnly) {\n    throw new Error('aiecsjs: cannot destroyEntity on a read-only world')\n  }\n  if (!isAliveInternal(state, eid)) return\n\n  const idx = eid & state.options.indexMask\n\n  // Fire onRemove for every component the entity has, plus reactive exit\n  // (Late-bound to avoid circular imports — done via observers module.)\n  const { dispatchDestroyObservers } = lazyObservers()\n  dispatchDestroyObservers(state, eid)\n\n  // Clean up relations referring to this entity\n  cleanupRelationsOnDestroy(state, eid)\n\n  // Zero the SoA columns / undefine the AoS slots the entity owned, before\n  // the mask is cleared. Without this, destroyed entities leave stale data\n  // visible to snapshots and serialisation.\n  clearAllEntityStorages(state, eid)\n\n  // Swap-pop from its archetype\n  const archId = state.entityArchetype[idx] ?? 0\n  const arch = state.archetypes[archId]\n  if (arch) {\n    const row = arch.entityRow.get(eid)\n    if (row !== undefined) {\n      const lastRow = arch.size - 1\n      if (row !== lastRow) {\n        const moved = arch.entities[lastRow] ?? 0\n        arch.entities[row] = moved\n        arch.entityRow.set(moved, row)\n      }\n      arch.entities[lastRow] = 0\n      arch.entityRow.delete(eid)\n      arch.size--\n    }\n  }\n\n  // Wipe state\n  state.entityArchetype[idx] = 0\n  const w = state.options.maskWordCount\n  const base = idx * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n  // Bump generation — use generationMask so non-default generationBits wraps correctly\n  state.generations[idx] = ((state.generations[idx] ?? 0) + 1) & state.options.generationMask\n\n  // freeList stores raw idx (not packed); createEntity packs on re-use\n  state.freeList.push(idx)\n  state.size--\n}\n\nexport function entityExists(world: World, eid: EntityId): boolean {\n  const state = getWorldState(world)\n  return isAliveInternal(state, eid)\n}\n\nexport function isAliveInternal(state: WorldState, eid: number): boolean {\n  const idx = eid & state.options.indexMask\n  if (idx <= 0) return false\n  if (idx >= state.capacity) return false\n  const archId = state.entityArchetype[idx] ?? 0\n  const arch = state.archetypes[archId]\n  if (!arch) return false\n  if (!arch.entityRow.has(eid)) return false\n  // Generation comparison: packed eid must match stored generation\n  const storedGen = state.generations[idx] ?? 0\n  const refGen = (eid >>> state.options.indexBits) & state.options.generationMask\n  return storedGen === refGen\n}\n\n/**\n * Extract the index portion of a packed entity ID.\n *\n * Uses the default 24-bit index layout. If you created the world with a\n * non-default `indexBits`, use `EntityRef` + `deref` instead.\n */\nexport function getEntityIndex(eid: EntityId): number {\n  return (eid as number) & DEFAULT_INDEX_MASK\n}\n\n/**\n * Extract the generation portion of a packed entity ID.\n *\n * Uses the default 8-bit generation layout. If you created the world with a\n * non-default `generationBits`, use `EntityRef` + `deref` instead.\n */\nexport function getEntityGeneration(eid: EntityId): number {\n  return ((eid as number) >>> DEFAULT_INDEX_BITS) & DEFAULT_GENERATION_MASK\n}\n\n/**\n * Pack an index and generation into an EntityId using the default 24/8 bit layout.\n *\n * Uses the default `indexBits=24, generationBits=8`. If you created the world\n * with non-default bit sizes, this will produce values with incorrect layout.\n * Use `EntityRef` and `deref` for portable cross-world identity matching.\n */\nexport function packEntity(index: number, generation: number): EntityId {\n  return (((generation & DEFAULT_GENERATION_MASK) << DEFAULT_INDEX_BITS) |\n    (index & DEFAULT_INDEX_MASK)) as EntityId\n}\n\nexport function isEntity(world: World, x: unknown): x is EntityId {\n  if (typeof x !== 'number') return false\n  return entityExists(world, x as EntityId)\n}\n\n// --- Lazy loaders to break import cycles ---\n\ninterface ObserversAPI {\n  dispatchDestroyObservers(state: WorldState, eid: EntityId): void\n}\nlet _observersAPI: ObserversAPI | null = null\nexport function registerObserversAPI(api: ObserversAPI): void {\n  _observersAPI = api\n}\nfunction lazyObservers(): ObserversAPI {\n  if (!_observersAPI) {\n    return { dispatchDestroyObservers: () => {} }\n  }\n  return _observersAPI\n}\n\nlet _relationsCleanup: ((state: WorldState, eid: EntityId) => void) | null = null\nexport function registerRelationsCleanup(fn: (state: WorldState, eid: EntityId) => void): void {\n  _relationsCleanup = fn\n}\nfunction cleanupRelationsOnDestroy(state: WorldState, eid: EntityId): void {\n  if (_relationsCleanup) _relationsCleanup(state, eid)\n}\n","import { clearBit, cloneMask, forEachSetBit, setBit, testBit } from './bitmask.js'\nimport { isAliveInternal } from './entity.js'\nimport type {\n  AoSComponent,\n  ComponentInfo,\n  ComponentInit,\n  ComponentLike,\n  EntityId,\n  FieldInfo,\n  SoAColumns,\n  SoAComponent,\n  SoASchema,\n  TagComponent,\n  TypedArrayConstructor,\n  World,\n  WorldComponentStorage,\n  WorldState,\n} from './types.js'\nimport {\n  ensureArchetypeCapacity,\n  findOrCreateArchetype,\n  getOrRegisterComponentBit,\n  getWorldState,\n  readEntityMask,\n  tryGetComponentBit,\n  writeEntityMask,\n} from './world.js'\n\n// --- Component factories ---\n\nlet nextComponentId = 1\n\nconst TYPE_CTOR: Record<string, TypedArrayConstructor> = {\n  i8: Int8Array,\n  u8: Uint8Array,\n  i16: Int16Array,\n  u16: Uint16Array,\n  i32: Int32Array,\n  u32: Uint32Array,\n  f32: Float32Array,\n  f64: Float64Array,\n  eid: Uint32Array,\n  bool: Uint8Array,\n}\n\nconst componentInfoById = new Map<number, ComponentInfo>()\n\nexport function defineComponent<S extends SoASchema>(schema: S): SoAComponent<S> {\n  const fields: FieldInfo[] = []\n  for (const [name, decl] of Object.entries(schema)) {\n    let type: keyof typeof TYPE_CTOR\n    let vectorLen = 1\n    if (typeof decl === 'string') {\n      type = decl\n    } else if (Array.isArray(decl)) {\n      const [t, len] = decl\n      type = t\n      vectorLen = len\n    } else {\n      throw new TypeError(`aiecsjs: invalid field declaration for \"${name}\"`)\n    }\n    const ctor = TYPE_CTOR[type]\n    if (!ctor) throw new TypeError(`aiecsjs: unknown field type \"${type}\" for field \"${name}\"`)\n    fields.push({\n      name,\n      type: type as any,\n      vectorLen,\n      ctor,\n      bytesPerElement: (ctor as any).BYTES_PER_ELEMENT,\n    })\n  }\n  const id = nextComponentId++\n  const info: ComponentInfo = { id, kind: 'soa', schema, fields, factory: null }\n  componentInfoById.set(id, info)\n  const handle: SoAComponent<S> = {\n    __kind: 'soa',\n    __id: id,\n    __schema: schema,\n  }\n  return handle\n}\n\nexport function defineTag(): TagComponent {\n  const id = nextComponentId++\n  const info: ComponentInfo = { id, kind: 'tag', schema: null, fields: [], factory: null }\n  componentInfoById.set(id, info)\n  return { __kind: 'tag', __id: id }\n}\n\nexport function defineObjectComponent<T>(factory?: () => T): AoSComponent<T> {\n  const id = nextComponentId++\n  const fac = factory ?? (() => ({}) as T)\n  const info: ComponentInfo = { id, kind: 'aos', schema: null, fields: [], factory: fac as any }\n  componentInfoById.set(id, info)\n  return { __kind: 'aos', __id: id, __factory: fac }\n}\n\nexport function getComponentInfo(component: ComponentLike): ComponentInfo {\n  const info = componentInfoById.get(component.__id)\n  if (!info)\n    throw new Error(\n      'aiecsjs: component is not registered (call defineComponent/defineTag/defineObjectComponent)',\n    )\n  return info\n}\n\n// --- Component ops on entities ---\n\nexport function addComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n  initial?: ComponentInit<C>,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) {\n    throw new Error(`aiecsjs: addComponent on dead entity ${eid}`)\n  }\n  const info = getComponentInfo(component)\n  const bit = getOrRegisterComponentBit(state, info)\n\n  const prevMask = readEntityMask(state, eid)\n  if (testBit(prevMask, bit)) {\n    if (initial !== undefined) writeInitial(state, eid as number, component, initial)\n    return\n  }\n  const newMask = cloneMask(prevMask)\n  setBit(newMask, bit)\n  migrateEntity(state, eid as number, newMask)\n\n  writeInitial(state, eid as number, component, initial)\n\n  fireAddObservers(state, eid, bit)\n  notifyMaskChange(state, eid, bit, prevMask, newMask)\n}\n\nexport function removeComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) return\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return\n  const prevMask = readEntityMask(state, eid)\n  if (!testBit(prevMask, bit)) return\n\n  // Write the new mask BEFORE firing observers so query-targeted observers\n  // reading `state.entityMask` see the post-removal state (and thus correctly\n  // detect \"entity left this query\"). Without this reorder, a query that\n  // requires the removed component would still match during dispatch and the\n  // remove observer would never fire. Component-targeted observers receive the\n  // bit directly and don't depend on mask timing. addComponent already follows\n  // this \"mutate then fire\" order; keeping removeComponent consistent.\n  const newMask = cloneMask(prevMask)\n  clearBit(newMask, bit)\n  migrateEntity(state, eid as number, newMask)\n\n  fireRemoveObservers(state, eid, bit)\n\n  const idx = (eid as number) & state.options.indexMask\n  const storage = state.componentStorageByBit[bit]\n  if (storage?.kind === 'soa' && storage.soa) {\n    clearSoAEntity(storage.soa, info.fields, idx)\n  } else if (storage?.kind === 'aos' && storage.aos) {\n    storage.aos[idx] = undefined\n  }\n\n  notifyMaskChange(state, eid, bit, prevMask, newMask)\n}\n\nexport function hasComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): boolean {\n  const state = getWorldState(world)\n  if (!isAliveInternal(state, eid)) return false\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return false\n  const mask = readEntityMask(state, eid)\n  return testBit(mask, bit)\n}\n\nexport function getComponent<C extends ComponentLike>(\n  world: World,\n  eid: EntityId,\n  component: C,\n): unknown {\n  const state = getWorldState(world)\n  if (!isAliveInternal(state, eid)) return undefined\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) return undefined\n  const mask = readEntityMask(state, eid)\n  if (!testBit(mask, bit)) return undefined\n  const storage = state.componentStorageByBit[bit]\n  if (!storage) return undefined\n  if (storage.kind === 'soa') return storage.soa\n  if (storage.kind === 'aos') {\n    const idx = (eid as number) & state.options.indexMask\n    return storage.aos?.[idx]\n  }\n  return true // tag\n}\n\nexport function setComponent<C extends ComponentLike, V>(\n  world: World,\n  eid: EntityId,\n  component: C,\n  value: V,\n): void {\n  const state = getWorldState(world)\n  if (state.readOnly) throw new Error('aiecsjs: cannot mutate a read-only world')\n  if (!isAliveInternal(state, eid)) throw new Error(`aiecsjs: setComponent on dead entity ${eid}`)\n  const info = getComponentInfo(component)\n  const bit = tryGetComponentBit(state, info)\n  if (bit === undefined) {\n    // Adding via set\n    addComponent(world, eid, component, value as any)\n    return\n  }\n  const mask = readEntityMask(state, eid)\n  if (!testBit(mask, bit)) {\n    addComponent(world, eid, component, value as any)\n    return\n  }\n  writeInitial(state, eid as number, component, value as any)\n  fireSetObservers(state, eid, bit, value)\n}\n\n// --- Internals ---\n\nfunction writeInitial(\n  state: WorldState,\n  packedEid: number,\n  component: ComponentLike,\n  initial: unknown,\n): void {\n  const info = getComponentInfo(component)\n  const bit = state.componentBitFor.get(info.id)\n  if (bit === undefined) return\n  const storage = state.componentStorageByBit[bit]\n  if (!storage) return\n  // Unpack to raw index for storage access\n  const idx = packedEid & state.options.indexMask\n  if (info.kind === 'soa' && storage.soa) {\n    if (initial == null) return\n    const obj = initial as Record<string, unknown>\n    for (const f of info.fields) {\n      if (!(f.name in obj)) continue\n      const col = storage.soa[f.name]\n      if (!col) continue\n      const val = obj[f.name]\n      if (f.vectorLen === 1) {\n        col[idx] = typeof val === 'boolean' ? (val ? 1 : 0) : Number(val)\n      } else if (Array.isArray(val) || ArrayBuffer.isView(val)) {\n        const base = idx * f.vectorLen\n        const arr = val as ArrayLike<number>\n        for (let i = 0; i < f.vectorLen; i++) col[base + i] = Number(arr[i] ?? 0)\n      }\n    }\n  } else if (info.kind === 'aos' && storage.aos) {\n    const factory = info.factory ?? (() => ({}))\n    let inst = storage.aos[idx]\n    if (inst === undefined) {\n      inst = factory()\n      storage.aos[idx] = inst\n    }\n    if (initial && typeof initial === 'object') {\n      // SECURITY: do NOT use `Object.assign(inst, initial)` here. When `initial`\n      // comes from `JSON.parse(untrustedBytes)` — e.g. via `fromJSON`,\n      // `deserializeWorld`, or app code piping a bridge payload — the parsed\n      // object can carry an OWN `__proto__` property, and `Object.assign` uses\n      // [[Set]] semantics which would trigger the proto setter and clobber the\n      // instance's prototype chain. Explicit own-key copy with a deny-list\n      // closes the prototype-pollution path.\n      const src = initial as Record<string, unknown>\n      const target = inst as Record<string, unknown>\n      for (const key of Object.keys(src)) {\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue\n        target[key] = src[key]\n      }\n    }\n  }\n  // tag: nothing\n}\n\nfunction clearSoAEntity(soa: SoAColumns, fields: FieldInfo[], eid: number): void {\n  for (const f of fields) {\n    const col = soa[f.name]\n    if (!col) continue\n    if (f.vectorLen === 1) {\n      col[eid] = 0\n    } else {\n      const base = eid * f.vectorLen\n      for (let i = 0; i < f.vectorLen; i++) col[base + i] = 0\n    }\n  }\n}\n\n// Clear every component-storage slot that the entity currently owns.\n// Walks the entity's mask; for each set bit, zeroes the SoA columns or\n// undefines the AoS slot at the entity index. Tag storages are bit-only.\n// Caller (e.g. destroyEntity) is expected to clear the mask separately.\nexport function clearAllEntityStorages(state: WorldState, eid: EntityId): void {\n  const wordCount = state.options.maskWordCount\n  const idx = (eid as number) & state.options.indexMask\n  const base = idx * wordCount\n  forEachSetBit(state.entityMask, base, wordCount, (bit) => {\n    const storage = state.componentStorageByBit[bit]\n    const info = state.componentInfoByBit[bit]\n    if (storage?.kind === 'soa' && storage.soa && info) {\n      clearSoAEntity(storage.soa, info.fields, idx)\n    } else if (storage?.kind === 'aos' && storage.aos) {\n      storage.aos[idx] = undefined\n    }\n  })\n}\n\nfunction migrateEntity(state: WorldState, packedEid: number, newMask: Uint32Array): void {\n  // Unpack to raw index for sparse-array lookups\n  const idx = packedEid & state.options.indexMask\n  const srcArchId = state.entityArchetype[idx] ?? 0\n  const srcArch = state.archetypes[srcArchId]\n  if (!srcArch) return\n\n  const found = findOrCreateArchetype(state, newMask)\n  const destArchId = found.archId\n  const destArch = state.archetypes[destArchId]\n  if (!destArch) return\n\n  if (destArchId !== srcArchId) {\n    // Swap-pop from src (arch.entities / entityRow use packed eid as key)\n    const row = srcArch.entityRow.get(packedEid)\n    if (row !== undefined) {\n      const lastRow = srcArch.size - 1\n      if (row !== lastRow) {\n        const moved = srcArch.entities[lastRow] ?? 0\n        srcArch.entities[row] = moved\n        srcArch.entityRow.set(moved, row)\n      }\n      srcArch.entities[lastRow] = 0\n      srcArch.entityRow.delete(packedEid)\n      srcArch.size--\n    }\n\n    // Append to dest (store packed eid)\n    ensureArchetypeCapacity(destArch, destArch.size + 1)\n    const newRow = destArch.size\n    destArch.entities[newRow] = packedEid\n    destArch.entityRow.set(packedEid, newRow)\n    destArch.size++\n\n    state.entityArchetype[idx] = destArchId\n  }\n\n  writeEntityMask(state, packedEid, newMask)\n}\n\n// --- Observer dispatch (lazy-bound) ---\n\ninterface ObserversDispatchAPI {\n  fireAdd(state: WorldState, eid: EntityId, bit: number): void\n  fireRemove(state: WorldState, eid: EntityId, bit: number): void\n  fireSet(state: WorldState, eid: EntityId, bit: number, value: unknown): void\n}\nlet _dispatch: ObserversDispatchAPI = {\n  fireAdd: () => {},\n  fireRemove: () => {},\n  fireSet: () => {},\n}\n\ntype MaskChangeFn = (\n  state: WorldState,\n  eid: EntityId,\n  bit: number,\n  prev: Uint32Array,\n  next: Uint32Array,\n) => void\nlet _maskChange: MaskChangeFn = () => {}\nexport function registerMaskChangeDispatch(fn: MaskChangeFn): void {\n  _maskChange = fn\n}\nfunction notifyMaskChange(\n  state: WorldState,\n  eid: number,\n  bit: number,\n  prev: Uint32Array,\n  next: Uint32Array,\n): void {\n  _maskChange(state, eid as EntityId, bit, prev, next)\n}\nexport function registerObserverDispatch(api: ObserversDispatchAPI): void {\n  _dispatch = api\n}\nfunction fireAddObservers(state: WorldState, eid: number, bit: number): void {\n  _dispatch.fireAdd(state, eid as EntityId, bit)\n}\nfunction fireRemoveObservers(state: WorldState, eid: number, bit: number): void {\n  _dispatch.fireRemove(state, eid as EntityId, bit)\n}\nfunction fireSetObservers(state: WorldState, eid: number, bit: number, value: unknown): void {\n  _dispatch.fireSet(state, eid as EntityId, bit, value)\n}\n\n// --- Helper for serialize/worker ---\n\nexport function getComponentByInternalId(id: number): ComponentInfo | undefined {\n  return componentInfoById.get(id)\n}\n\nexport function listAllComponents(): ComponentInfo[] {\n  return Array.from(componentInfoById.values())\n}\n\nexport function _resetComponentRegistry_FOR_TESTS_ONLY(): void {\n  componentInfoById.clear()\n  nextComponentId = 1\n}\n","// 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, entityExists } 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 =\n      ((gen & state.options.generationMask) << state.options.indexBits) |\n      (idx & state.options.indexMask)\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  return JSON.parse(json) as WorldSnapshot\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      // Apply: ensure entities exist, then add/update their components\n      const targetState = getWorldState(targetWorld)\n      for (const e of snapshot.entities) {\n        if (e.eid >= targetState.capacity) continue\n        if (!entityExists(targetWorld, e.eid as EntityId)) {\n          // Create the entity. For simplicity, we just spawn until we have enough.\n          while (targetState.size < e.eid) {\n            createEntity(targetWorld)\n          }\n        }\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, e.eid as EntityId, 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","// aiecsjs/worker — SharedArrayBuffer helpers (experimental, snapshot-copy).\n//\n// Note: 0.x implements SAB as a transferable snapshot pattern rather than true\n// shared-memory aliasing. The world is serialized into the SAB, and the worker\n// reconstructs a fresh world from those bytes via adoptSnapshot/attachWorld.\n// True shared-column memory is targeted for a future stable release.\n// The API matches the documented contract and survives postMessage cleanly.\n//\n// EntityRef is in-memory only — not preserved across worker boundaries.\n// Generation counters reset on adoptSnapshot/attachWorld. Pass `EntityRef.id`\n// (the packed EntityId) across the worker boundary only if you understand that\n// the generation portion will be stale after a round-trip snapshot.\n\nimport type { TransferableSnapshot, World, WorldMeta, WorldState } from './internal/types.js'\nimport { destroyWorld, getWorldState, isWorldRegistered } from './internal/world.js'\nimport { deserializeWorld, serializeWorld } from './serialize.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 0x41494543 // 'AIEC' little-endian as uint32\n\nexport function transferableSnapshot(world: World): TransferableSnapshot {\n  const state = getWorldState(world)\n  const bytes = serializeWorld(world)\n\n  if (typeof SharedArrayBuffer === 'undefined') {\n    // Fallback: ArrayBuffer wrapped to look like a SAB at runtime\n    const ab = new ArrayBuffer(bytes.byteLength)\n    new Uint8Array(ab).set(bytes)\n    return {\n      buffer: ab as unknown as SharedArrayBuffer,\n      meta: buildMeta(state),\n    }\n  }\n\n  const sab = new SharedArrayBuffer(bytes.byteLength)\n  new Uint8Array(sab).set(bytes)\n  return { buffer: sab, meta: buildMeta(state) }\n}\n\n/**\n * Adopt a snapshot previously produced by `transferableSnapshot`.\n *\n * SECURITY: same trust expectation as `attachWorld` — the sender of the\n * `TransferableSnapshot` (typically a Web Worker) must be trusted. The\n * function runs `validateMeta` and `deserializeWorld`, which enforce magic\n * + format version + length bounds on the binary header; but the inner\n * JSON payload, once decoded, is fed to `addComponent` and reaches AoS\n * components. For untrusted senders, use `aibridgejs` + `toJSON(world)` at\n * the application boundary instead.\n */\nexport function adoptSnapshot(snap: TransferableSnapshot): World {\n  validateMeta(snap.meta)\n  const bytes = new Uint8Array(snap.buffer)\n  return deserializeWorld(bytes)\n}\n\n/**\n * Adopt a SharedArrayBuffer-backed snapshot produced by `transferableSnapshot`.\n *\n * SECURITY: the SAB sender must be trusted. `attachWorld` performs the same\n * magic + version + length-bounds checks as `deserializeWorld`, but the JSON\n * payload itself is deserialised into AoS components via `addComponent`. If\n * the sender is untrusted (e.g. a third-party Web Worker that you do not\n * audit), prefer the higher-level `aibridgejs` channel + `toJSON(world)`\n * pattern, which lets you validate the shape at the application boundary\n * before constructing entities.\n */\nexport function attachWorld(buffer: SharedArrayBuffer, options?: { readOnly?: boolean }): World {\n  const bytes = new Uint8Array(buffer)\n  const world = deserializeWorld(bytes)\n  if (options?.readOnly) {\n    const state = getWorldState(world)\n    state.readOnly = true\n  }\n  return world\n}\n\nexport function detachWorld(world: World): void {\n  if (isWorldRegistered(world.id)) {\n    destroyWorld(world)\n  }\n}\n\nfunction buildMeta(state: WorldState): WorldMeta {\n  const componentSchemas: WorldMeta['componentSchemas'] = []\n  for (const info of state.componentInfoByBit) {\n    if (!info) continue\n    componentSchemas.push({ id: info.id, kind: info.kind, schema: info.schema })\n  }\n  return {\n    magic: MAGIC,\n    formatVersion: 1,\n    aiecsjsVersion: VERSION,\n    indexBits: state.options.indexBits,\n    generationBits: state.options.generationBits,\n    maxComponents: state.options.maxComponents,\n    maskWordCount: state.options.maskWordCount,\n    capacity: state.capacity,\n    componentSchemas,\n  }\n}\n\nfunction validateMeta(meta: WorldMeta): void {\n  if (meta.magic !== MAGIC) {\n    throw new Error('aiecsjs: invalid snapshot meta (wrong magic)')\n  }\n  if (meta.formatVersion !== 1) {\n    throw new Error(`aiecsjs: unsupported snapshot format version ${meta.formatVersion}`)\n  }\n}\n"]}
+{"version":3,"sources":["../src/worker.ts"],"names":["MAGIC","transferableSnapshot","world","state","getWorldState","bytes","serializeWorld","ab","buildMeta","sab","adoptSnapshot","snap","validateMeta","deserializeWorld","attachWorld","buffer","options","detachWorld","isWorldRegistered","destroyWorld","componentSchemas","info","VERSION","meta"],"mappings":"qGAkBA,IAAMA,CAAAA,CAAQ,WAEP,SAASC,CAAAA,CAAqBC,EAAoC,CACvE,IAAMC,CAAAA,CAAQC,CAAAA,CAAcF,CAAK,CAAA,CAC3BG,EAAQC,CAAAA,CAAeJ,CAAK,EAElC,GAAI,OAAO,kBAAsB,GAAA,CAAa,CAE5C,IAAMK,CAAAA,CAAK,IAAI,WAAA,CAAYF,EAAM,UAAU,CAAA,CAC3C,WAAI,UAAA,CAAWE,CAAE,EAAE,GAAA,CAAIF,CAAK,CAAA,CACrB,CACL,MAAA,CAAQE,CAAAA,CACR,KAAMC,CAAAA,CAAUL,CAAK,CACvB,CACF,CAEA,IAAMM,EAAM,IAAI,iBAAA,CAAkBJ,CAAAA,CAAM,UAAU,CAAA,CAClD,OAAA,IAAI,WAAWI,CAAG,CAAA,CAAE,IAAIJ,CAAK,CAAA,CACtB,CAAE,MAAA,CAAQI,CAAAA,CAAK,IAAA,CAAMD,CAAAA,CAAUL,CAAK,CAAE,CAC/C,CAaO,SAASO,CAAAA,CAAcC,CAAAA,CAAmC,CAC/DC,CAAAA,CAAaD,EAAK,IAAI,CAAA,CACtB,IAAMN,CAAAA,CAAQ,IAAI,UAAA,CAAWM,EAAK,MAAM,CAAA,CACxC,OAAOE,GAAAA,CAAiBR,CAAK,CAC/B,CAaO,SAASS,CAAAA,CAAYC,CAAAA,CAA2BC,CAAAA,CAAyC,CAC9F,IAAMX,CAAAA,CAAQ,IAAI,UAAA,CAAWU,CAAM,CAAA,CAC7Bb,CAAAA,CAAQW,IAAiBR,CAAK,CAAA,CACpC,GAAIW,CAAAA,EAAS,QAAA,CAAU,CACrB,IAAMb,CAAAA,CAAQC,CAAAA,CAAcF,CAAK,CAAA,CACjCC,CAAAA,CAAM,SAAW,KACnB,CACA,OAAOD,CACT,CAEO,SAASe,EAAYf,CAAAA,CAAoB,CAC1CgB,CAAAA,CAAkBhB,CAAAA,CAAM,EAAE,CAAA,EAC5BiB,IAAajB,CAAK,EAEtB,CAEA,SAASM,CAAAA,CAAUL,CAAAA,CAA8B,CAC/C,IAAMiB,CAAAA,CAAkD,EAAC,CACzD,IAAA,IAAWC,KAAQlB,CAAAA,CAAM,kBAAA,CAClBkB,CAAAA,EACLD,CAAAA,CAAiB,IAAA,CAAK,CAAE,GAAIC,CAAAA,CAAK,EAAA,CAAI,IAAA,CAAMA,CAAAA,CAAK,IAAA,CAAM,MAAA,CAAQA,EAAK,MAAO,CAAC,CAAA,CAE7E,OAAO,CACL,KAAA,CAAOrB,EACP,aAAA,CAAe,CAAA,CACf,eAAgBsB,GAAAA,CAChB,SAAA,CAAWnB,EAAM,OAAA,CAAQ,SAAA,CACzB,cAAA,CAAgBA,CAAAA,CAAM,OAAA,CAAQ,cAAA,CAC9B,cAAeA,CAAAA,CAAM,OAAA,CAAQ,aAAA,CAC7B,aAAA,CAAeA,CAAAA,CAAM,OAAA,CAAQ,cAC7B,QAAA,CAAUA,CAAAA,CAAM,QAAA,CAChB,gBAAA,CAAAiB,CACF,CACF,CAEA,SAASR,CAAAA,CAAaW,EAAuB,CAC3C,GAAIA,EAAK,KAAA,GAAUvB,CAAAA,CACjB,MAAM,IAAI,KAAA,CAAM,8CAA8C,EAEhE,GAAIuB,CAAAA,CAAK,aAAA,GAAkB,CAAA,CACzB,MAAM,IAAI,MAAM,CAAA,6CAAA,EAAgDA,CAAAA,CAAK,aAAa,CAAA,CAAE,CAExF","file":"worker.js","sourcesContent":["// aiecsjs/worker — SharedArrayBuffer helpers (experimental, snapshot-copy).\n//\n// Note: 0.x implements SAB as a transferable snapshot pattern rather than true\n// shared-memory aliasing. The world is serialized into the SAB, and the worker\n// reconstructs a fresh world from those bytes via adoptSnapshot/attachWorld.\n// True shared-column memory is targeted for a future stable release.\n// The API matches the documented contract and survives postMessage cleanly.\n//\n// EntityRef is in-memory only — not preserved across worker boundaries.\n// Generation counters reset on adoptSnapshot/attachWorld. Pass `EntityRef.id`\n// (the packed EntityId) across the worker boundary only if you understand that\n// the generation portion will be stale after a round-trip snapshot.\n\nimport type { TransferableSnapshot, World, WorldMeta, WorldState } from './internal/types.js'\nimport { destroyWorld, getWorldState, isWorldRegistered } from './internal/world.js'\nimport { deserializeWorld, serializeWorld } from './serialize.js'\nimport { VERSION } from './version.js'\n\nconst MAGIC = 0x41494543 // 'AIEC' little-endian as uint32\n\nexport function transferableSnapshot(world: World): TransferableSnapshot {\n  const state = getWorldState(world)\n  const bytes = serializeWorld(world)\n\n  if (typeof SharedArrayBuffer === 'undefined') {\n    // Fallback: ArrayBuffer wrapped to look like a SAB at runtime\n    const ab = new ArrayBuffer(bytes.byteLength)\n    new Uint8Array(ab).set(bytes)\n    return {\n      buffer: ab as unknown as SharedArrayBuffer,\n      meta: buildMeta(state),\n    }\n  }\n\n  const sab = new SharedArrayBuffer(bytes.byteLength)\n  new Uint8Array(sab).set(bytes)\n  return { buffer: sab, meta: buildMeta(state) }\n}\n\n/**\n * Adopt a snapshot previously produced by `transferableSnapshot`.\n *\n * SECURITY: same trust expectation as `attachWorld` — the sender of the\n * `TransferableSnapshot` (typically a Web Worker) must be trusted. The\n * function runs `validateMeta` and `deserializeWorld`, which enforce magic\n * + format version + length bounds on the binary header; but the inner\n * JSON payload, once decoded, is fed to `addComponent` and reaches AoS\n * components. For untrusted senders, use `aibridgejs` + `toJSON(world)` at\n * the application boundary instead.\n */\nexport function adoptSnapshot(snap: TransferableSnapshot): World {\n  validateMeta(snap.meta)\n  const bytes = new Uint8Array(snap.buffer)\n  return deserializeWorld(bytes)\n}\n\n/**\n * Adopt a SharedArrayBuffer-backed snapshot produced by `transferableSnapshot`.\n *\n * SECURITY: the SAB sender must be trusted. `attachWorld` performs the same\n * magic + version + length-bounds checks as `deserializeWorld`, but the JSON\n * payload itself is deserialised into AoS components via `addComponent`. If\n * the sender is untrusted (e.g. a third-party Web Worker that you do not\n * audit), prefer the higher-level `aibridgejs` channel + `toJSON(world)`\n * pattern, which lets you validate the shape at the application boundary\n * before constructing entities.\n */\nexport function attachWorld(buffer: SharedArrayBuffer, options?: { readOnly?: boolean }): World {\n  const bytes = new Uint8Array(buffer)\n  const world = deserializeWorld(bytes)\n  if (options?.readOnly) {\n    const state = getWorldState(world)\n    state.readOnly = true\n  }\n  return world\n}\n\nexport function detachWorld(world: World): void {\n  if (isWorldRegistered(world.id)) {\n    destroyWorld(world)\n  }\n}\n\nfunction buildMeta(state: WorldState): WorldMeta {\n  const componentSchemas: WorldMeta['componentSchemas'] = []\n  for (const info of state.componentInfoByBit) {\n    if (!info) continue\n    componentSchemas.push({ id: info.id, kind: info.kind, schema: info.schema })\n  }\n  return {\n    magic: MAGIC,\n    formatVersion: 1,\n    aiecsjsVersion: VERSION,\n    indexBits: state.options.indexBits,\n    generationBits: state.options.generationBits,\n    maxComponents: state.options.maxComponents,\n    maskWordCount: state.options.maskWordCount,\n    capacity: state.capacity,\n    componentSchemas,\n  }\n}\n\nfunction validateMeta(meta: WorldMeta): void {\n  if (meta.magic !== MAGIC) {\n    throw new Error('aiecsjs: invalid snapshot meta (wrong magic)')\n  }\n  if (meta.formatVersion !== 1) {\n    throw new Error(`aiecsjs: unsupported snapshot format version ${meta.formatVersion}`)\n  }\n}\n"]}

package/llms-full.txt

@@ -22,7 +22,7 @@ The short index lives at `llms.txt` (see https://llmstxt.org/).
 
 Part of the [ai\*js micro-runtime ecosystem](https://github.com/yshengliao) — see also [aifsmjs](https://github.com/yshengliao/aifsmjs) (FSM) and [aibridgejs](https://github.com/yshengliao/aibridgejs) (cross-context RPC).
 
-aiecsjs uses **archetype tables with TypedArray columns** and **bitmask queries** — the same architecture that powers piecs and wolf-ecs at the top of public benchmarks. Its API is **functional and tree-shakable**, composed with `pipe()`. Components support both Structure-of-Arrays (SoA) and Array-of-Structures (AoS) layouts. Entity IDs in 0.x are bare slot indices; internal generation tracks slot reuse but is not encoded in the ID. ABA-safe `EntityRef` is targeted for **0.3+** (deferred from the 0.2 roadmap once the v0.2.0 scope froze on API stability + safety).
+aiecsjs uses **archetype tables with TypedArray columns** and **bitmask queries** — the same architecture that powers piecs and wolf-ecs at the top of public benchmarks. Its API is **functional and tree-shakable**, composed with `pipe()`. Components support both Structure-of-Arrays (SoA) and Array-of-Structures (AoS) layouts. Since 0.3, `EntityId` packs index + generation into a single 32-bit number; the ABA-safe `EntityRef` API shipped in 0.3.0.
 
 ```ts
 import { createWorld, createEntity, defineComponent, defineQuery, pipe, forEachEntity, Types } from 'aiecsjs'
@@ -392,8 +392,13 @@ type WorldOptions = {
 | `destroyEntity` | `(world: World, eid: EntityId) => void` | stable |
 | `entityExists` | `(world: World, eid: EntityId) => boolean` | stable |
 | `getEntityIndex` | `(eid: EntityId) => number` | stable |
-| `getEntityGeneration` | `(eid: EntityId) => number` | experimental (since 0.1) — returns `0` in 0.x; real generation lands with ABA-safe `EntityRef` in **0.3+** |
-| `packEntity` | `(index: number, generation: number) => EntityId` | experimental (since 0.1) — identity in 0.x; real packing lands with `EntityRef` in **0.3+** |
+| `getEntityGeneration` | `(eid: EntityId) => number` | stable (since 0.3.0) — returns the 8-bit generation field; uses default 24/8 layout |
+| `packEntity` | `(index: number, generation: number) => EntityId` | stable (since 0.3.0) — packs index + generation using default 24/8 layout |
+| `refOf` | `<T>(world: World, eid: EntityId) => EntityRef<T>` | stable (since 0.3.0) — creates ABA-safe ref; throws `EntityNotAliveError` if entity is dead |
+| `deref` | `<T>(world: World, ref: EntityRef<T>) => EntityId \| null` | stable (since 0.3.0) — returns live `EntityId` or `null` if stale/cross-world; never throws |
+| `aliveRef` | `<T>(world: World, ref: EntityRef<T>) => boolean` | stable (since 0.3.0) — boolean guard form of `deref`; never throws |
+| `EntityRef` | `interface EntityRef<T> { id: EntityId; worldId: number }` | stable (since 0.3.0) — opaque ABA-safe reference; in-memory only |
+| `EntityNotAliveError` | `class EntityNotAliveError extends Error { eid: number }` | stable (since 0.3.0) — thrown by `refOf` when entity is not alive |
 
 ### Component — `aiecsjs`
 
@@ -934,6 +939,31 @@ All notable changes to `aiecsjs` are recorded in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-05-29
+
+### Fixed
+
+- **Packed EntityId signed-overflow for generation ≥ 128**: `createEntity` returned a negative number diverging from the unsigned value stored in archetype row arrays (`Uint32Array`), so query iteration (`runQuery`/`iterQuery`/`forEachEntity`) yielded an eid that failed `entityRow` lookups; `refOf`/`entityExists`/`deref` on a query-iterated high-generation entity misbehaved (`refOf` threw on a live entity). `packEid`/`packEntity` now normalise with `>>> 0`. No public-bundle behaviour change beyond the corrected eid representation (EntityId is opaque + in-memory-only).
+- **`toJSON` silently dropped high-generation entities** (gen ≥ 128 with default 8-bit generation): `toJSON` contained its own inline pack expression that produced a signed (negative) result, diverging from the unsigned key stored in `arch.entityRow`. The affected entity passed the archetype check but failed `entityRow.has()`, so it was omitted from every snapshot and `serializeWorld` call. Fixed by replacing the inline expression with the canonical `packEid` (which applies `>>> 0`). SPOT principle: one pack source of truth.
+- **Cross-subpath registry isolation** (`tsup splitting: false` → `splitting: true`): each compiled entry point (`dist/index.js`, `dist/serialize.js`, etc.) previously bundled its own private copy of `internal/world.ts`, including the module-scope `worldRegistry`. A world created via the core subpath was invisible to `serializeWorld`/`getRelationTargets`/`transferableSnapshot` imported from their respective subpaths, causing `world N is destroyed or unknown` at runtime. With `splitting: true`, esbuild extracts a shared chunk used by all entries; ESM and CJS are both verified by the new `scripts/check-dist-subpaths.mjs` smoke script.
+- **`getRelationTargets` returned raw index as `EntityId`** (gen always 0): `addRelation` stores the target as a raw slot index (`& indexMask`). The previous return path cast this raw index directly to `EntityId`, which is equivalent to a packed id with generation 0. For any target that had been recycled (gen > 0), callers received a stale id that failed `entityExists`, `entityRow` lookups, and component access. Fixed by re-packing each raw index against the current generation via `packEid` before returning.
+- **`resolveOptions` did not validate `indexBits + generationBits ≤ 32`**: the individual range checks (`indexBits ∈ [1, 24]`, `generationBits ∈ [0, 16]`) allowed combinations such as `indexBits=24, generationBits=16` (40 bits), where `gen << 24` silently overflowed and high-generation bits were lost. A sum check is now enforced with a clear error message. The `[Unreleased]` example corrected accordingly (`indexBits: 16, generationBits: 16` = 32 bits).
+
+### Known Limitations
+
+- **`createDeltaSerializer.apply` with a recycled target world**: `apply` uses the raw entity index from the delta snapshot as the `EntityId` directly. When the target world has already recycled any of those slots (generation > 0), component operations silently act on the wrong packed id. This is a known limitation of the experimental delta API; the common usage (delta → a fresh gen-0 render-mirror world) is unaffected. A proper raw-index-to-packed-id mapping is planned for 0.4. Avoid `apply` against a world that has previously destroyed entities.
+
+### Documentation
+
+- README / README_ZHTW updated to reflect the shipped 0.3.0 `EntityRef` API: the previous README still described EntityRef as "targeted for 0.3+" and `getEntityGeneration`/`packEntity` as experimental. Both files now correctly state EntityId has been packed since 0.3, and `EntityRef` / `refOf` / `deref` / `aliveRef` / `EntityNotAliveError` are all stable since 0.3.0. API table entries for these symbols added.
+
+### Build & Tooling
+
+- Coverage gate: `@vitest/coverage-v8` installed and wired into `prepublishOnly` (replaces `npm run test`) and CI. Thresholds: statements 95 / branches 80 / functions 97 / lines 98 — the achievable bar on pristine source. The branch figure honours the `?? 0` / `noUncheckedIndexedAccess` idiom on TypedArray reads (nullish-fallback branches unreachable by design); thresholds are raised only by adding tests, never by stripping defensive guards or scattering `/* v8 ignore */`.
+- `fast-check` property tests (`tests/properties.test.ts`): pack/unpack round-trip invariant (asserts `e >= 0` to guard the P0 regression) and ABA-deref always-null invariant.
+- Dispose three-cycle tests, error-path tests, and observer handler-throw behaviour documented in `tests/world.test.ts` / `tests/observers.test.ts`.
+- `scripts/check-dist-subpaths.mjs` (`npm run verify:dist`): post-build smoke test that imports `createWorld`+`createEntity` from the core subpath and calls `serializeWorld`, `addRelation`/`getRelationTargets`, and `transferableSnapshot` from their respective subpaths for both ESM (`dist/*.js`) and CJS (`dist/*.cjs`). Wired into `prepublishOnly` (after `build`) and CI.
+
 ## [Unreleased]
 
 ### Planned for 0.4+
@@ -945,7 +975,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
   default `generationBits=8`, a single slot recycled 256 times wraps back to its
   starting generation, briefly re-opening the ABA window. Safe for v0.5 shmup
   workloads (~5000 frame to wrap a single slot at 60 fps × ~1k destroys); high-churn
-  pools should set `createWorld({ generationBits: 16 })`. See test
+  pools should set `createWorld({ indexBits: 16, generationBits: 16 })` (16 + 16 = 32 bits;
+  65 536 entities × 65 536 generations). See test
   [tests/ref.test.ts](./tests/ref.test.ts) `generation wrap` describe block.
 
 ## [0.3.0] - 2026-05-29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiecsjs",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "TypeScript-first archetype ECS with TypedArray SoA, SAB-ready snapshot transport, and AI-readable docs.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -84,14 +84,18 @@
     "lint": "biome check src tests",
     "format": "biome format --write src tests",
     "verify:exports": "node scripts/verify-exports.mjs",
+    "verify:dist": "node scripts/check-dist-subpaths.mjs",
     "build:llms": "node scripts/build-llms-full.mjs",
     "verify:llms": "node scripts/build-llms-full.mjs --check",
     "size": "size-limit",
-    "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build && npm run verify:exports && npm run verify:llms && npm run size"
+    "coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run coverage && npm run build && npm run verify:dist && npm run verify:exports && npm run verify:llms && npm run size"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@size-limit/file": "^12.1.0",
+    "@vitest/coverage-v8": "^4.1.7",
+    "fast-check": "^4.8.0",
     "size-limit": "^12.1.0",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",