aiecsjs 0.2.1 → 0.3.1

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","createEntity","row","entityExists","isAliveInternal","archId","componentInfoById","getComponentInfo","component","addComponent","initial","prevMask","writeInitial","migrateEntity","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.2.1'\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    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 base = eid * 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 base = eid * 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, World, WorldState } from './types.js'\nimport { ensureArchetypeCapacity, ensureCapacity, getWorldState } from './world.js'\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 eid: number\n  if (state.freeList.length > 0) {\n    eid = 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    eid = state.nextFreshIndex++\n  }\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[eid] = 0\n  // Reset entityMask row for this eid\n  const w = state.options.maskWordCount\n  const base = eid * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n\n  state.size++\n  return eid as EntityId\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  // 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[eid] ?? 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[eid] = 0\n  const w = state.options.maskWordCount\n  const base = eid * w\n  for (let i = 0; i < w; i++) state.entityMask[base + i] = 0\n  // bump generation (Uint8Array wraps to 8 bits naturally; Uint16Array to 16)\n  const idx = eid as number\n  state.generations[idx] = ((state.generations[idx] ?? 0) + 1) & 0xffff\n\n  state.freeList.push(eid)\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  if (eid <= 0) return false\n  if (eid >= state.capacity) return false\n  // An entity is alive iff it is in some archetype (its row map points somewhere).\n  const archId = state.entityArchetype[eid] ?? 0\n  const arch = state.archetypes[archId]\n  if (!arch) return false\n  return arch.entityRow.has(eid)\n}\n\nexport function getEntityIndex(eid: EntityId): number {\n  return eid as number\n}\n\nexport function getEntityGeneration(_eid: EntityId): number {\n  // Unversioned in 0.1: generation not encoded in EntityId.\n  return 0\n}\n\nexport function packEntity(index: number, _generation: number): EntityId {\n  // Identity in 0.1.\n  return index 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, component, initial)\n    return\n  }\n  const newMask = cloneMask(prevMask)\n  setBit(newMask, bit)\n  migrateEntity(state, eid, newMask)\n\n  writeInitial(state, eid, 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, newMask)\n\n  fireRemoveObservers(state, eid, bit)\n\n  const storage = state.componentStorageByBit[bit]\n  if (storage?.kind === 'soa' && storage.soa) {\n    clearSoAEntity(storage.soa, info.fields, eid)\n  } else if (storage?.kind === 'aos' && storage.aos) {\n    storage.aos[eid] = 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') return storage.aos?.[eid]\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, component, value as any)\n  fireSetObservers(state, eid, bit, value)\n}\n\n// --- Internals ---\n\nfunction writeInitial(\n  state: WorldState,\n  eid: 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  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[eid] = typeof val === 'boolean' ? (val ? 1 : 0) : Number(val)\n      } else if (Array.isArray(val) || ArrayBuffer.isView(val)) {\n        const base = eid * 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[eid]\n    if (inst === undefined) {\n      inst = factory()\n      storage.aos[eid] = 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\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, eid: number, newMask: Uint32Array): void {\n  const srcArchId = state.entityArchetype[eid] ?? 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\n    const row = srcArch.entityRow.get(eid)\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(eid)\n      srcArch.size--\n    }\n\n    // Append to dest\n    ensureArchetypeCapacity(destArch, destArch.size + 1)\n    const newRow = destArch.size\n    destArch.entities[newRow] = eid\n    destArch.entityRow.set(eid, newRow)\n    destArch.size++\n\n    state.entityArchetype[eid] = destArchId\n  }\n\n  writeEntityMask(state, eid, 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\nexport function toJSON(world: World): WorldSnapshot {\n  const state = getWorldState(world)\n  const entities: WorldSnapshot['entities'] = []\n  for (let eid = 1; eid < state.capacity; eid++) {\n    if (!entityExists(world, eid as EntityId)) continue\n    const archId = state.entityArchetype[eid] ?? 0\n    if (archId === 0) continue // unattached (shouldn't happen for alive)\n\n    const w = state.options.maskWordCount\n    const base = eid * 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[eid]\n              } else {\n                const arr: number[] = []\n                const baseI = eid * 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[eid] ?? 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    entities.push({ eid, 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 in 0.1).\n//\n// Note: 0.1 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 on the 0.2 roadmap. The API matches the\n// documented contract and survives postMessage cleanly.\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,14 +939,102 @@ 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.3+
+### Planned for 0.4+
 
-- Implement ABA-safe `EntityRef` and graduate `getEntityGeneration` / `packEntity` from experimental → stable.
 - Add `pipeAsync` for async system composition.
 - Doc-test harness so README code blocks are mechanically verified.
 - Promote `aiecsjs/relations` and `aiecsjs/worker` (true SAB-shared columns) to `stable`.
+- Document the 8-bit generation wrap caveat in [STABILITY.md](./STABILITY.md): with the
+  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({ 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
+
+### Added (API)
+
+- **`EntityRef<T>`** — ABA-safe entity reference. `refOf(world, eid)` builds one;
+  `deref(world, ref)` returns the entity id when still alive (generation match)
+  or `null` otherwise; `aliveRef(world, ref)` is the boolean guard form. Phantom
+  type `T` lets callers distinguish ref kinds (e.g. `EntityRef<'bullet'>`) without
+  runtime cost. Refs are in-memory only — not serializable across worker / disk.
+- **`EntityNotAliveError`** — thrown by `refOf` when the entity is dead or invalid.
+  `deref` / `aliveRef` never throw.
+
+### Changed
+
+- **`EntityId` now packs index + generation** into a single 32-bit number
+  `(generation << indexBits) | index` (default `indexBits=24, generationBits=8`).
+  `EntityId` remains opaque per STABILITY contract; the layout is implementation
+  detail. **Migration note**: do not compare `EntityId` numbers directly
+  (`eid === 42` will break across slot recycles); use
+  `getEntityIndex(eid)` for index comparison or `refOf(world, eid).id` for
+  identity matching that survives slot reuse.
+- **`getEntityGeneration` / `packEntity` graduate to `stable`** (were `experimental`
+  since 0.2.0). Both now return real values. These functions use default 24/8 bit
+  layout; for non-default `createWorld({ indexBits, generationBits })`, use
+  `EntityRef` and `deref` instead of manual unpacking.
+
+### Fixed
+
+- **ABA bug on entity slot recycle**: previously `entityExists` and `isAliveInternal`
+  only checked archetype membership; a stale `EntityId` pointing at a recycled slot
+  would silently report alive. With packed generation + `deref` generation match,
+  stale refs now correctly invalidate.
+- **`destroyEntity` generation wrap mask aligned with `options.generationBits`**
+  (was hard-coded `& 0xffff`). The mask now correctly uses
+  `state.options.generationMask`, fixing inconsistency for non-default
+  `generationBits` values.
+
+### Documentation
+
+- `onSet` JSDoc clarifies that `addComponent` does NOT trigger `onSet`, and
+  direct writes to column views returned by `getComponent` (e.g. `col.x[idx] = 5`)
+  also do NOT trigger `onSet`. Only `setComponent` on an already-present
+  component fires the callback. Anti-pattern example included.
+
+### Compatibility
+
+- `EntityId` layout change is **not** breaking at the type system level (opaque
+  branded number), but consumers who relied on `eid === N` direct comparison
+  will need to migrate (see Migration note above).
+- All existing `stable` exports unchanged.
+- `aiecsjs/worker` snapshot wire format unchanged (still uses raw indices).
+- `aiecsjs/serialize` wire format unchanged.
+
+### Build & tooling
+
+- `VERSION` constant bumped to `0.3.0`.
 
 ## [0.2.1] - 2026-05-28
 
@@ -1154,8 +1247,13 @@ The **root** entry (`aiecsjs`) is the stable core: world, entity, component, que
 | `destroyEntity` | stable | 0.1.0 | |
 | `entityExists` | stable | 0.1.0 | |
 | `getEntityIndex` | stable | 0.1.0 | |
-| `getEntityGeneration` | **experimental** | 0.1.0 | Returns 0 in 0.x (generation tracked internally but not encoded in EntityId). Real values arrive with ABA-safe `EntityRef` in **0.3+**. |
-| `packEntity` | **experimental** | 0.1.0 | Identity helper in 0.x. Returns the index unchanged. Real packing arrives with `EntityRef` in **0.3+**. |
+| `getEntityGeneration` | stable | 0.3.0 | Returns real generation value packed into EntityId (default 24-bit index, 8-bit generation). For non-default `createWorld({ indexBits, generationBits })`, use `EntityRef` + `deref` instead. |
+| `packEntity` | stable | 0.3.0 | Packs index + generation into an EntityId using default 24/8 bit layout. For non-default bit sizes, use `EntityRef` + `deref` instead. |
+| `refOf` | stable | 0.3.0 | Throws `EntityNotAliveError` for dead entity. |
+| `deref` | stable | 0.3.0 | Returns null for stale / cross-world refs; never throws. |
+| `aliveRef` | stable | 0.3.0 | Boolean guard form of `deref`; never throws. |
+| `EntityRef` (type) | stable | 0.3.0 | In-memory only; not serializable. |
+| `EntityNotAliveError` | stable | 0.3.0 | Thrown only by `refOf`. |
 | `defineComponent` | stable | 0.1.0 | |
 | `defineTag` | stable | 0.1.0 | |
 | `defineObjectComponent` | stable | 0.1.0 | AoS components are main-thread only; not SAB-shareable. |
@@ -1250,8 +1348,9 @@ Everything under this prefix is **internal**. It exists for the implementation's
 |---|---|---|
 | 0.1.x | Core surface (world, entity, component, query, system, loop, commands, observers, serialize) | Initial publish; all marked experimental at the package level but per-export stable where listed. |
 | 0.2.0 | Safety + alignment | Prototype-pollution hardening, observer `{ signal? }`, `disposeWorld` alias, `getEntityGeneration` / `packEntity` re-labelled experimental, `verify:llms` gate. See [CHANGELOG.md](./CHANGELOG.md#020---2026-05-28). |
-| 0.3+ | Relations stabilisation + EntityRef + SAB | `aiecsjs/relations` graduates to stable; ABA-safe `EntityRef` lands and `getEntityGeneration` / `packEntity` start returning real values; `aiecsjs/worker` adopts true shared-memory column aliasing. |
-| 0.3.x | Hardening, relations stabilization, multi-threading polish | `aiecsjs/relations` and `aiecsjs/worker` → stable. |
+| 0.3.x | EntityRef + generation packing | ABA-safe; `getEntityGeneration` / `packEntity` → stable. |
+| 0.4+ | Relations stabilisation + true SAB worker | `aiecsjs/relations` and `aiecsjs/worker` → stable. |
+| 0.6+ | Multi-World snapshot diff transport (placeholder) | experimental — design TBD. |
 | 1.0.0 | API freeze | All `stable` exports frozen for 1.x. |
 
 ## How to check stability at runtime

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiecsjs",
-  "version": "0.2.1",
+  "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",