aiecsjs 0.5.9 → 0.6.0

package/llms-full.txt

@@ -14,7 +14,7 @@ The short index lives at `llms.txt` (see https://llmstxt.org/).
 
 TypeScript-first archetype ECS with TypedArray SoA components, command buffers, relations, serialization, and SAB-ready snapshot transport.
 
-> **Status: 0.5.9 - stable 1.0-track core.** Root ECS APIs are stable; worker transport remains adapter-shaped and environment-dependent.
+> **Status: 0.6.0 - stable 1.0-track core.** Root ECS APIs are stable; worker transport remains adapter-shaped and environment-dependent. 0.6.0 has breaking changes (snapshot format 2, stricter validation): see the [CHANGELOG](CHANGELOG.md).
 
 ## Install
 
@@ -29,8 +29,8 @@ import {
   createEntity,
   createWorld,
   defineComponent,
-  forEachEntity,
-  getComponent,
+  defineQuery,
+  forEachEntityIndexed,
 } from "aiecsjs";
 ```
 
@@ -45,15 +45,15 @@ const e = createEntity(world);
 addComponent(world, e, Position, { x: 0, y: 0 });
 addComponent(world, e, Velocity, { x: 1, y: 0 });
 
-forEachEntity(world, [Position, Velocity], (entity) => {
-  const pos = getComponent(world, entity, Position);
-  const vel = getComponent(world, entity, Velocity);
-  pos.x += vel.x;
-  pos.y += vel.y;
+// SoA columns are TypedArrays; index them with `i`, the entity's slot index.
+const movers = defineQuery([Position, Velocity]);
+forEachEntityIndexed(world, movers, (entity, i, pos, vel) => {
+  pos.x[i] += vel.x[i];
+  pos.y[i] += vel.y[i];
 });
 ```
 
-Use `defineTag()` for marker components and `defineObjectComponent()` when you need object references instead of TypedArray storage.
+Use `defineTag()` for marker components and `defineObjectComponent()` when you need object references instead of TypedArray storage. Do not index columns with the packed `entity` id: it stops matching the slot once a slot is recycled.
 
 ## Public Surface
 
@@ -67,15 +67,49 @@ Use `defineTag()` for marker components and `defineObjectComponent()` when you n
 | `aiecsjs/worker` | Transfer/adopt/attach helpers for worker snapshots. |
 | `aiecsjs/relations` | `defineRelation`, `ChildOf`, relation add/remove/read helpers. |
 
+## Snapshots
+
+`toJSON` / `serializeWorld` write snapshot format 2: entity data plus a table of the components it uses (stable key, kind, SoA fields). Give every component you save a `key`, so a loading session can define its components in any order:
+
+```ts
+const Position = defineComponent({ x: Types.f32, y: Types.f32 }, { key: "position" });
+const Player = defineTag({ key: "player" });
+
+const bytes = serializeWorld(world); // aiecsjs/serialize
+const restored = deserializeWorld(bytes); // or fromJSON(toJSON(world))
+```
+
+- Loading resolves every component before it creates the world: by key, or by creation-order id for keyless components. It throws `EcsError` when a component is not defined in this process (pass `onUnknownComponent: "skip"` to drop its data) or when its kind or SoA fields differ.
+- 0.5.x snapshots are rejected with `EcsError` by default; `{ onUnknownVersion: "best-effort" }` loads them by id with a kind check. See [0.5.x -> 0.6.0 snapshots](docs/MIGRATION.md#05x---060-snapshots).
+- Restored entities get fresh ids in snapshot order (holes in the slot range close up), so EntityIds stored inside component data are not remapped. Delta `apply()` keeps slot indices.
+
+## Relations
+
+```ts
+import { ChildOf, addRelation, getRelationTargets } from "aiecsjs/relations";
+
+addRelation(world, child, ChildOf, parent);
+getRelationTargets(world, child, ChildOf); // [parent]
+```
+
+- `addRelation` throws `EcsError` for a dead source or target, mirroring `addComponent`. Check `entityExists` first when an endpoint may be stale.
+- `destroyEntity` and `resetWorld` drop every edge of the entities they remove; `removeRelation` is a no-op for dead endpoints.
+
+## Errors
+
+- Misuse and invariant failures throw `EcsError` (message `aiecsjs: ...`) before any change is made: non-integer world options, dead entities, unknown components, invalid component keys, non-function callbacks (observer handlers, `forEachEntity`, `withCommandBuffer`, `pipe` systems, AoS factories) and snapshot errors.
+- A world from `attachWorld(buffer, { readOnly: true })` rejects every mutator with `EcsError`: `createEntity`, `destroyEntity`, `addComponent`, `removeComponent`, `setComponent`, `resetWorld`, `addRelation`, `removeRelation` and delta `apply()`.
+- `defineComponent` field-declaration errors and non-Query input to query functions throw `TypeError`. `createLoop` (`aiecsjs/loop` has no error class) throws `TypeError` / `RangeError`.
+
 ## Sharp Edges
 
 - Structural mutation during a query loop is allowed by the library, but app systems should prefer `withCommandBuffer()` when adding/removing/destroying entities from inside iteration.
 - Reactive query buffers are unbounded until drained. Poll and clear them every frame or event tick.
-- Query registration currently uses a global module cache; many worlds/components can make structural changes scan more query metadata than expected.
-- Exclusive relation cleanup is `O(incoming)` on destroy — a reverse index touches only the edges pointing at the destroyed entity, not the whole relation capacity.
+- Queries are cached process-wide, and a structural change visits every reactive (enter/exit) source query that references the changed component, whichever world registered it.
+- Exclusive relation cleanup is `O(incoming)` on destroy for the exclusive-slot reverse index, but every destroy also walks all relation `data` payload sources and all `outgoing` (non-exclusive) edge lists — cost is `O(incoming + data sources + outgoing sources)` across all relations, even for entities with no relations at all.
 - Serialization restores capacity with safety clamps, but snapshots from untrusted sources should still be treated as hostile input.
 - Worker/SAB helpers depend on the runtime environment. Feature-detect `SharedArrayBuffer` and cross-origin isolation in browsers.
-- `pnpm lint` currently reports many `noExplicitAny` warnings. They are not release-blocking, but they add AI-review noise.
+- `pnpm lint` reports 84 `noExplicitAny` warnings, mostly casts in tests plus the public query callback types. They are not release-blocking.
 
 ## AI Context
 
@@ -98,7 +132,58 @@ MIT
 
 All notable changes to aiecsjs are summarized here. Detailed historical review notes live in Git history; this file keeps current release context compact.
 
-## [Unreleased]
+## [0.6.0] - 2026-09-29
+
+### Breaking
+
+- `toJSON` / `serializeWorld` / `createDeltaSerializer` / `fromJSON` / `deserializeWorld` / `adoptSnapshot` / `attachWorld`: snapshots are now format 2 with a component table, and every loader resolves each component by its stable key (by creation-order id when keyless) and throws `EcsError` for a component the process has not defined or a kind / SoA-field mismatch, because 0.5.x id-only matching silently put data into the wrong components when definition order differed; 0.5.x snapshots (no `formatVersion`, binary or worker meta format 1) are rejected with `EcsError: aiecsjs: format version 1 not supported`. Migration: give every serialized component a key (`defineComponent(schema, { key })`, `defineTag({ key })`, `defineObjectComponent(factory, { key })`), re-export existing 0.5.x snapshots with 0.6.0 or load them once with `{ onUnknownVersion: 'best-effort' }` and save again, pass `{ onUnknownComponent: 'skip' }` where dropping unknown components is intended, and add `formatVersion: 2` plus a `components` table to hand-built snapshots (see docs/MIGRATION.md).
+- `addRelation`: a dead source or target now throws `EcsError` (mirroring `addComponent`), because edges are stored by slot and an edge to a dead entity was inherited by whatever entity was later recycled into that slot. Migration: check `entityExists` before `addRelation` when an endpoint may be stale.
+- `createWorld`: a non-integer `initialCapacity`, `maxEntities`, `indexBits` or `generationBits` (such as `1.5`, `NaN`, `Infinity` or `'8'`) now throws `EcsError` before the range checks and clamps, because fractional and `NaN` values silently truncated typed arrays and dropped entities. Migration: pass integers for these options (for example `Math.floor(n)`).
+- `resetWorld`: a read-only (worker-attached) world now throws `EcsError`, as every other mutator already did, instead of being wiped. Migration: reset a writable world instead (`adoptSnapshot`, or `attachWorld` without `readOnly`).
+- `onAdd` / `onRemove` / `onSet` / `observe`, `forEachEntity` / `forEachEntityIndexed`, `withCommandBuffer`, `pipe`, `defineObjectComponent` and the relation helpers: a non-function handler, callback, system or factory, an AoS factory that returns `null` or `undefined`, or a relation argument that is not a `defineRelation` handle now throws `EcsError` at the call, instead of being accepted and failing later (for observers, after the structural change was already committed) or doing nothing. Migration: pass functions, a factory that returns a value and real relation handles; catch `EcsError` where these come from dynamic input.
+- `createLoop` (`aiecsjs/loop`): a missing options object or a non-function `onUpdate` / `onRender` now throws `TypeError`, and a `fixed` that is not a finite number > 0 or a `maxSubSteps` that is not a finite number >= 1 throws `RangeError`, instead of failing in the first tick or silently stalling. Migration: pass an options object with a function `onUpdate`, and a positive finite `fixed` and a `maxSubSteps` of at least 1 when you set them.
+
+### Changes
+
+- Added: stable component keys: `defineComponent(schema, { key })`, `defineTag({ key })` and `defineObjectComponent(factory, { key })`; a key must be a non-empty string (`EcsError` otherwise); defining a key again with the same kind and field layout (HMR, editor script reload) returns the existing component, and a different layout throws `EcsError`.
+- Added: `DeserializeOptions.onUnknownComponent` (`'throw'` by default, or `'skip'`); `fromJSON(snapshot, options?)` takes `DeserializeOptions` (including the `components` allowlist), and `adoptSnapshot(snap, options?)` and `attachWorld(buffer, { readOnly?, ...DeserializeOptions })` pass them through.
+- Added: the `EcsError` constructor accepts an optional `{ cause }`.
+- Changed: every plain `Error` misuse throw (read-only guards, the dead-entity guards of `addComponent` / `setComponent`, unregistered components, the missing empty archetype guard, binary snapshot header and body errors, worker meta errors, command-buffer errors) is now `EcsError` with the same message, so callers can branch on the class; `instanceof Error` checks and message matches keep working.
+- Changed: `noExplicitAny` lint warnings are down from 133 to 84 (`src` 11 to 4, tests 122 to 80), with the emitted public `.d.ts` signatures unchanged; the 4 left in `src` are the public query callback and `ComponentLike` types.
+- Changed: internal refactors keep every entry inside its existing size budget: shared archetype-row and slot-placement helpers, one loop for `forEachEntity` / `forEachEntityIndexed`, one reactive-buffer drain, one mask matcher, and removal of the never-read per-archetype edge tables (two `Int32Array(256)` per archetype) and of unreachable fallback factories; the coverage `functions` threshold is raised to 100.
+- Fixed: `destroyEntity` no longer recurses (or corrupts world size/freeList/exit-query state) when an onRemove/observe handler destroys, resets, or otherwise re-enters teardown for the same entity.
+- Fixed: the package's `sideEffects: false` no longer lets bundlers drop `dist/index.js`'s component-lookup and mask-change registration, which broke queries (and left reactive enter/exit queries empty) for consumers who imported only chunk-owned bindings.
+- Fixed: query observers (`observe(world, query, 'add'|'remove')`) now track match transitions, so queries with `none` terms fire enter/exit correctly and `'remove'` no longer fires for entities that never matched.
+- Fixed: the delta serializer now replicates AoS (`defineObjectComponent`) changes; `capture()` previously aliased the live component instance and always diffed it against itself, silently dropping AoS updates.
+- Fixed: `toJSON`/delta capture no longer drop component-less live entities (archetype 0) from snapshots.
+- Fixed: `flush()` detaches the command-buffer queue before applying it, so a flush that throws partway through no longer replays Phase 1 and duplicates entities on retry.
+- Fixed: command-buffer ops enqueued during `flush()` (e.g. from an onAdd/onRemove handler) are now processed in further rounds instead of throwing an unresolved-placeholder error or being silently dropped.
+- Fixed: component-level `onRemove` handlers can now read the outgoing component's value via `getComponent` on the `removeComponent` path, matching the existing `destroyEntity` path.
+- Fixed: `forEachEntity`/`forEachEntityIndexed`/`iterQuery`/`runQuery` accept a raw component array (routed through `defineQuery`) and throw a `TypeError` for other non-Query input, instead of silently iterating zero entities.
+- Fixed: an in-loop `addComponent`/`removeComponent` that moves the currently visited entity into an archetype already covered by the same `forEachEntity`/`forEachEntityIndexed` pass no longer visits it twice or skips another entity.
+- Fixed: `observe(world, query, 'set')` now fires only for entities that actually match the query (not merely any entity carrying a component in `query.all`), and fires for `any`-only components too.
+- Fixed: `toJSON` deep-copies AoS component data instead of handing out the live instance, so `fromJSON(toJSON(w))` and a mutated snapshot no longer alias/mutate the source world.
+- Fixed: the delta serializer's `capture()`/`apply()` and `deserializeWorld` now honour the documented `components` allowlist option instead of silently ignoring it.
+- Fixed: component/query/world registries are now shared across duplicate ESM+CJS copies of the package (via a `globalThis` key) instead of colliding on the same auto-incrementing ids.
+- Fixed: `fromJSON`/`deserializeWorld` restore `maxEntities`, `indexBits`, and `generationBits` from the snapshot instead of falling back to defaults, so a large or non-default-layout world round-trips without hitting a bogus `maxEntities` cap.
+- Fixed: the fixed-timestep loop now ends a tick chain as soon as it is stopped or restarted — even from inside `onUpdate`/`onRender` — so it no longer keeps stepping, renders after `stop()`, or runs two chains concurrently.
+- Fixed: reactive (enter/exit) queries are now indexed per world instead of scanning a module-level cache on every structural change, which previously registered foreign components (and could exhaust `maxComponents`) in unrelated worlds.
+- Fixed: `observe()` on an `enterQuery`/`exitQuery` now registers the query directly instead of forcing registration via `runQuery`, which drained the (not-yet-registered) reactive buffer as a no-op and left the observer permanently inert.
+- Fixed: `iterQuery`/`forEachEntity`/`forEachEntityIndexed` now drain their reactive buffer up front, so breaking out of the loop early or a callback throwing partway through no longer re-delivers already-seen entities on the next read.
+- Fixed: the delta serializer's `apply()` rejects a non-integer `eid` instead of corrupting entity-slot allocation (a live slot pushed onto the freeList, a non-integer allocation frontier).
+- Fixed: the fixed-timestep loop clamps `dtMs` to non-negative, so a first tick timestamp earlier than `start()`'s sample can no longer drive the accumulator (and `onRender`'s alpha) negative.
+- Fixed: `createEntity`'s `maxEntities` guard now throws `EcsError` (matching the documented behaviour) instead of a plain `Error`.
+- Fixed: `enterQuery` / `exitQuery` / `observe` now check their query argument like `runQuery`: a raw component array works, and other non-Query input throws the documented `TypeError` instead of an internal `TypeError` (`enterQuery` / `exitQuery` also cached a broken reactive query that later calls returned silently).
+- Fixed: `addComponent` builds a new AoS instance before it moves the entity to its new archetype, so a factory that throws leaves the entity unchanged instead of half-added (moved, but never announced to observers or reactive queries).
+- Fixed: a missing world handle, component handle, snapshot, worker meta or delta byte array now throws `EcsError` instead of a bare `TypeError` from property access.
+- Fixed: `deserializeWorld` applied the `components` allowlist to the snapshot's source-process component ids; `fromJSON` / `deserializeWorld` now apply it to the resolved local components.
+- Fixed: package.json `exports` now nest `types` under `import` and `require` for every subpath, with `require.types` pointing at the `.d.cts` file, so CommonJS consumers on `node16`/`nodenext` module resolution get the CommonJS declarations; `verify-exports` walks nested conditions.
+- Docs: relation-destroy cost is documented as `O(incoming + data sources + outgoing sources)` (was understated as `O(incoming)` alone).
+- Docs: `deref`/`aliveRef` are documented as "never throws for a live world" (was an unqualified "never throws") — both throw `EcsError` once the world has been disposed.
+- Docs: the README / README_ZHTW Quick Start no longer corrupts the world: it did `pos.x += vel.x` on the column objects returned by `getComponent`, which replaced the `Position.x` column with a string; it now indexes the columns with `forEachEntityIndexed`'s `i` over a `defineQuery` query (the TypeScript signature does not accept a raw array).
+- Docs: README / README_ZHTW gain Snapshots, Relations and Errors sections; STABILITY gains a Behavioral Contract section (the ai*js re-entrancy clause for observer dispatch, argument validation, read-only mutators, relation liveness, snapshot format 2); `docs/MIGRATION.md` / `MIGRATION_ZHTW.md` gain "0.5.x -> 0.6.0 snapshots".
+- Docs: README / STABILITY no longer describe reactive-query tracking as a module-level cache scan; it is a per-component index.
+- Docs: `api.json` is updated for 0.6.0 signatures and throws, documents that the `defineObjectComponent` factory runs once per entity on first add (not once at definition), and lists `DeserializeOptions.components`.
 
 ## [0.5.9] - 2026-06-29
 
@@ -144,25 +229,36 @@ aiecsjs keeps the root ECS surface stable and treats subpaths as explicit public
 | `aiecsjs/loop` | Stable utility | Loop helper only; scheduler policy remains app-owned. |
 | `aiecsjs/commands` | Stable utility | Command buffers for deferred structural mutations. |
 | `aiecsjs/observers` | Stable utility | Add/remove/set observer helpers. |
-| `aiecsjs/serialize` | Stable utility | Binary and JSON snapshots with capacity clamps. |
+| `aiecsjs/serialize` | Stable utility | Binary and JSON snapshots with capacity clamps; format 2; keyed components; mismatch rejected. |
 | `aiecsjs/worker` | Experimental adapter | Environment-dependent SAB/transfer helpers. |
-| `aiecsjs/relations` | Stable | Relations and `ChildOf`; destroy cleanup cost remains documented. |
+| `aiecsjs/relations` | Stable | Relations and `ChildOf`; `addRelation` throws `EcsError` for a dead source or target, mirroring `addComponent`; destroy cleanup cost remains documented. |
 | `aiecsjs/internal/*` | Private | No compatibility guarantee. |
 
+## Behavioral Contract
+
+- Re-entrancy (ai*js rule for pure fan-out emitters): observer dispatch (`onAdd`, `onRemove`, `onSet`, `observe`) is synchronous and depth-first. A structural change made inside a handler, with its own notifications, runs to completion before the outer dispatch resumes; the outer dispatch keeps iterating its pre-taken snapshot and skips observers removed meanwhile; nested dispatch is never rejected or queued. aiecsjs has no `once` observers.
+- Structural changes are applied at once, never queued. A handler that destroys the entity being destroyed, or removes the component being removed, makes the nested call a no-op and the outer call finishes. `flush()` on a buffer that is already flushing returns immediately; ops queued during a flush run in later rounds of that flush, in queue order.
+- Misuse throws `EcsError` (message `aiecsjs: <subject> must be <constraint>` or `aiecsjs: <operation> on dead entity <eid>`) before any change is made: a non-integer `initialCapacity` / `maxEntities` / `indexBits` / `generationBits`; an empty, non-string or duplicate component `key`; a non-function observer handler, `forEachEntity` / `forEachEntityIndexed` / `withCommandBuffer` callback, `pipe` system or AoS factory; an AoS factory that returns `null` / `undefined`; a value that is not a relation handle; a missing world or component handle.
+- `defineComponent` field-declaration errors and non-Query input to the query functions throw `TypeError`. `aiecsjs/loop` exports no error class: `createLoop` throws `TypeError` for a missing options object or a non-function `onUpdate` / `onRender` and `RangeError` for a `fixed` that is not a finite number > 0 or a `maxSubSteps` that is not a finite number >= 1.
+- A read-only world (`attachWorld(buffer, { readOnly: true })`) rejects every mutator with `EcsError`: `createEntity`, `destroyEntity`, `addComponent`, `removeComponent`, `setComponent`, `resetWorld`, `addRelation`, `removeRelation` and delta `apply()`.
+- `addRelation` throws `EcsError` for a dead source or target; `removeRelation` is lenient. `destroyEntity` and `resetWorld` drop the edges of the entities they remove, so relation storage never holds an edge for a dead entity.
+- Snapshots are format 2: `toJSON`, `serializeWorld` and delta `capture()` write `formatVersion: 2` and a table of every referenced component (`id`, `key`, `kind`, SoA `fields`). `fromJSON`, `deserializeWorld`, delta `apply()`, `adoptSnapshot` and `attachWorld` resolve every component (by `key`, by `id` when keyless) before they create or write anything. An undefined component throws `EcsError` unless `onUnknownComponent: 'skip'`; a kind or SoA-field mismatch always throws. A snapshot of another format version (every 0.5.x snapshot) throws unless `onUnknownVersion: 'best-effort'`, which resolves by `id` with a kind check only.
+
 ## Behavioral Boundaries
 
 - Entity ids are generational numeric ids. Use refs (`refOf`, `deref`, `aliveRef`) when storing ids across time.
 - Query iteration is synchronous and direct. Use command buffers for structural changes inside systems.
 - Reactive query buffers must be drained by the caller.
 - Serialization accepts trusted snapshots; hostile input is bounded but not a sandbox.
+- `fromJSON` / `deserializeWorld` re-create entities in snapshot order with fresh ids; EntityIds stored inside component data are not remapped.
 - No build-mode-gated runtime validation policy is promised.
 - Worker support depends on `SharedArrayBuffer`, transfer support, and browser isolation policy.
 
 ## Current Caveats
 
-- Reactive query registration scans a module-level query cache on structural changes.
-- Exclusive relation cleanup touches only the incoming edges (`O(incoming)`) when an entity is destroyed, via a reverse index — no full relation-capacity scan.
-- Lint has many `noExplicitAny` warnings pending cleanup.
+- Queries are cached process-wide, and reactive (enter/exit) source queries are indexed process-wide by component: a structural change visits every such source that references the changed component, whichever world registered it.
+- Exclusive relation cleanup avoids a full relation-capacity scan (via a reverse index it touches only `O(incoming)` exclusive edges), but it still walks every relation's `data` payload sources and `outgoing` (non-exclusive) edge lists on every destroy: `O(incoming + data sources + outgoing sources)` across all relations, even for entities with no relations.
+- Lint reports `noExplicitAny` warnings, mostly test casts plus the public query callback types (typed per arity only in a future design).
 
 ---
 

package/llms.txt

@@ -7,4 +7,5 @@ Archetype ECS with TypedArray SoA components, command buffers, relations, snapsh
 - Current backlog: REVIEW.md
 - Machine-readable API: api.json
 - Changelog: CHANGELOG.md
+- Migration and upgrade notes: docs/MIGRATION.md
 - Full generated context: llms-full.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiecsjs",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "description": "TypeScript-first archetype ECS with TypedArray SoA, SAB-ready snapshot transport, and AI-readable docs.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -8,39 +8,74 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./loop": {
-      "types": "./dist/loop.d.ts",
-      "import": "./dist/loop.js",
-      "require": "./dist/loop.cjs"
+      "import": {
+        "types": "./dist/loop.d.ts",
+        "default": "./dist/loop.js"
+      },
+      "require": {
+        "types": "./dist/loop.d.cts",
+        "default": "./dist/loop.cjs"
+      }
     },
     "./commands": {
-      "types": "./dist/commands.d.ts",
-      "import": "./dist/commands.js",
-      "require": "./dist/commands.cjs"
+      "import": {
+        "types": "./dist/commands.d.ts",
+        "default": "./dist/commands.js"
+      },
+      "require": {
+        "types": "./dist/commands.d.cts",
+        "default": "./dist/commands.cjs"
+      }
     },
     "./observers": {
-      "types": "./dist/observers.d.ts",
-      "import": "./dist/observers.js",
-      "require": "./dist/observers.cjs"
+      "import": {
+        "types": "./dist/observers.d.ts",
+        "default": "./dist/observers.js"
+      },
+      "require": {
+        "types": "./dist/observers.d.cts",
+        "default": "./dist/observers.cjs"
+      }
     },
     "./serialize": {
-      "types": "./dist/serialize.d.ts",
-      "import": "./dist/serialize.js",
-      "require": "./dist/serialize.cjs"
+      "import": {
+        "types": "./dist/serialize.d.ts",
+        "default": "./dist/serialize.js"
+      },
+      "require": {
+        "types": "./dist/serialize.d.cts",
+        "default": "./dist/serialize.cjs"
+      }
     },
     "./worker": {
-      "types": "./dist/worker.d.ts",
-      "import": "./dist/worker.js",
-      "require": "./dist/worker.cjs"
+      "import": {
+        "types": "./dist/worker.d.ts",
+        "default": "./dist/worker.js"
+      },
+      "require": {
+        "types": "./dist/worker.d.cts",
+        "default": "./dist/worker.cjs"
+      }
     },
     "./relations": {
-      "types": "./dist/relations.d.ts",
-      "import": "./dist/relations.js",
-      "require": "./dist/relations.cjs"
+      "import": {
+        "types": "./dist/relations.d.ts",
+        "default": "./dist/relations.js"
+      },
+      "require": {
+        "types": "./dist/relations.d.cts",
+        "default": "./dist/relations.cjs"
+      }
     },
     "./package.json": "./package.json"
   },

package/dist/chunk-JDV5JZP2.cjs

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

package/dist/chunk-JDV5JZP2.cjs.map

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

package/dist/chunk-OBMQME2P.js

@@ -1,2 +0,0 @@
-var F="0.5.9";function T(t){return new Uint32Array(t)}function z(t,n){let e=n>>>5;t[e]=(t[e]??0)|1<<(n&31);}function E(t,n){let e=n>>>5;t[e]=(t[e]??0)&~(1<<(n&31));}function A(t,n){let e=n>>>5;return ((t[e]??0)&1<<(n&31))!==0}function b(t){let n=new Uint32Array(t.length);for(let e=0;e<t.length;e++)n[e]=t[e]??0;return n}function W(t){let n=[];for(let e=0;e<t.length;e++)n.push((t[e]??0).toString(16));return n.join(",")}function xn(t){for(let n=0;n<t.length;n++)if((t[n]??0)!==0)return  false;return  true}function gn(t,n,e,o,r,i){let s=!r;for(let a=0;a<i;a++){let c=t[a]??0,f=n[a]??0,d=e[a]??0,u=o[a]??0;if((c&f)!==f||(c&u)!==0)return  false;!s&&(c&d)!==0&&(s=true);}return s}function kn(t){let n=[];for(let e=0;e<t.length;e++){let o=t[e]??0;for(;o!==0;){let r=(e<<5)+D(o);n.push(r),o&=o-1;}}return n}function B(t,n,e,o){for(let r=0;r<e;r++){let i=t[n+r]??0;for(;i!==0;){let s=(r<<5)+D(i);o(s),i&=i-1;}}}function Cn(t,n,e,o,r,i,s){let a=!s;for(let c=0;c<e;c++){let f=t[n+c]??0,d=o[c]??0,u=r[c]??0,l=i[c]??0;if((f&d)!==d||(f&l)!==0)return  false;!a&&(f&u)!==0&&(a=true);}return a}function D(t){return 31-Math.clz32(t&-t)}var p=class extends Error{constructor(n){super(n),this.name="EcsError";}};var S={initialCapacity:1024,maxEntities:1e6,indexBits:24,generationBits:8},nn=256,tn=1,w=new Map;function y(t){let n=w.get(t.id);if(!n)throw new p(`aiecsjs: world ${t.id} is destroyed or unknown`);if(n.destroyed)throw new p(`aiecsjs: world ${t.id} is destroyed`);return n}function en(t){w.set(t.id,t);}function on(t){w.delete(t);}function Mn(t){return w.has(t)}function rn(t){let n=t??{},e=n.indexBits??S.indexBits,o=n.generationBits??S.generationBits,r=nn;if(e<1||e>24)throw new p("aiecsjs: indexBits must be in [1, 24]");if(o<0||o>16)throw new p("aiecsjs: generationBits must be in [0, 16]");if(e+o>32)throw new p(`aiecsjs: indexBits (${e}) + generationBits (${o}) must be <= 32`);let i=1<<e,s=Math.max(1,Math.min(n.initialCapacity??S.initialCapacity,i)),a=Math.max(s,Math.min(n.maxEntities??S.maxEntities,i));return {initialCapacity:s,maxEntities:a,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 sn(t,n){return {id:0,mask:T(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 Un(t){let n=rn(t),e=tn++,o=n.generationBits>8?Uint16Array:Uint8Array,r=new o(n.initialCapacity),i={id:e,capacity:n.initialCapacity,version:F,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=sn(n.maskWordCount,n.maxComponents);return s.id=0,i.archetypes.push(s),i.archetypeByMaskHash.set(W(s.mask),0),en(i),an(i)}function an(t){return {id:t.id,get capacity(){return t.capacity},version:t.version}}function On(t){let n=w.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(),n.entityMask=new Uint32Array(0),n.entityArchetype=new Uint32Array(0),n.generations=new Uint8Array(0),n.freeList=[],n.componentBitFor.clear(),n.bitToQueries.clear(),n.queryArchetypeStamp=[],n.sab=null,on(t.id));}function Rn(t){let n=y(t);n.size=0,n.nextFreshIndex=1,n.freeList=[],n.generations.fill(0),n.entityArchetype.fill(0),n.entityMask.fill(0);for(let e of n.archetypes)e.size=0,e.entityRow.clear();for(let e of n.componentStorageByBit)if(e)if(e.kind==="soa"&&e.soa)for(let o of Object.keys(e.soa))e.soa[o]?.fill(0);else e.kind==="aos"&&e.aos&&e.aos.fill(void 0);n.relationStorage.clear(),n.queryVersion++;for(let e of n.reactiveBuffers.values())e.entered.length=0,e.exited.length=0;}function _n(t){return y(t).size}function Ln(t){return y(t).capacity}function M(t,n){if(n<=t.capacity)return;if(n>t.options.maxEntities)throw new p(`aiecsjs: requested capacity ${n} exceeds maxEntities ${t.options.maxEntities}`);let e=t.capacity;for(;e<n;)e=Math.min(e*2,t.options.maxEntities);cn(t,e);}function cn(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 a of t.componentStorageByBit)if(a)if(a.kind==="soa"&&a.soa){let c=t.componentInfoByBit[a.bit];c&&fn(a.soa,c.fields,n);}else a.kind==="aos"&&a.aos&&(a.aos.length=n);t.capacity=n;}function fn(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 N(t,n){let e=W(n),o=t.archetypeByMaskHash.get(e);if(o!==void 0)return {archId:o,created:false};let r=t.archetypes.length,i={id:r,mask:b(n),size:0,capacity:16,entities:new Uint32Array(16),entityRow:new Map,componentBits:dn(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 k(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 dn(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 P(t,n){let e=t.componentBitFor.get(n.id);if(e!==void 0)return e;if(t.nextComponentBit>=t.options.maxComponents)throw new p(`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 h(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 q(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 C(t,n){return t.componentBitFor.get(n.id)}function jn(t){if(!t||typeof t!="object")return  false;let n=t;return typeof n.id!="number"||typeof n.version!="string"?false:w.has(n.id)}var O=1,un={i8:Int8Array,u8:Uint8Array,i16:Int16Array,u16:Uint16Array,i32:Int32Array,u32:Uint32Array,f32:Float32Array,f64:Float64Array,eid:Uint32Array,bool:Uint8Array},x=new Map;function Nn(t){let n=[];for(let[i,s]of Object.entries(t)){let a,c=1;if(typeof s=="string")a=s;else if(Array.isArray(s)){let[d,u]=s;a=d,c=u;}else throw new TypeError(`aiecsjs: invalid field declaration for "${i}"`);let f=un[a];if(!f)throw new TypeError(`aiecsjs: unknown field type "${a}" for field "${i}"`);n.push({name:i,type:a,vectorLen:c,ctor:f,bytesPerElement:f.BYTES_PER_ELEMENT});}let e=O++,o={id:e,kind:"soa",schema:t,fields:n,factory:null};return x.set(e,o),{__kind:"soa",__id:e,__schema:t}}function Pn(){let t=O++,n={id:t,kind:"tag",schema:null,fields:[],factory:null};return x.set(t,n),{__kind:"tag",__id:t}}function qn(t){let n=O++,e=t??(()=>({})),o={id:n,kind:"aos",schema:null,fields:[],factory:e};return x.set(n,o),{__kind:"aos",__id:n,__factory:e}}function g(t){let n=x.get(t.__id);if(!n)throw new Error("aiecsjs: component is not registered (call defineComponent/defineTag/defineObjectComponent)");return n}function $(t,n,e,o){let r=y(t);if(r.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");if(!m(r,n))throw new Error(`aiecsjs: addComponent on dead entity ${n}`);let i=g(e),s=P(r,i),a=h(r,n);if(A(a,s)){o!==void 0&&U(r,n,e,o);return}let c=b(a);z(c,s),V(r,n,c),U(r,n,e,o),ln(r,n,s),R(r,n,s,a,c);}function $n(t,n,e){let o=y(t);if(o.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");if(!m(o,n))return;let r=g(e),i=C(o,r);if(i===void 0)return;let s=h(o,n);if(!A(s,i))return;let a=b(s);E(a,i),V(o,n,a),yn(o,n,i);let c=n&o.options.indexMask,f=o.componentStorageByBit[i];f?.kind==="soa"&&f.soa?G(f.soa,r.fields,c):f?.kind==="aos"&&f.aos&&(f.aos[c]=void 0),R(o,n,i,s,a);}function Gn(t,n,e){let o=y(t);if(!m(o,n))return  false;let r=g(e),i=C(o,r);if(i===void 0)return  false;let s=h(o,n);return A(s,i)}function Hn(t,n,e){let o=y(t);if(!m(o,n))return;let r=g(e),i=C(o,r);if(i===void 0)return;let s=h(o,n);if(!A(s,i))return;let a=o.componentStorageByBit[i];if(a){if(a.kind==="soa")return a.soa;if(a.kind==="aos"){let c=n&o.options.indexMask;return a.aos?.[c]}return  true}}function Vn(t,n,e,o){let r=y(t);if(r.readOnly)throw new Error("aiecsjs: cannot mutate a read-only world");if(!m(r,n))throw new Error(`aiecsjs: setComponent on dead entity ${n}`);let i=g(e),s=C(r,i);if(s===void 0){$(t,n,e,o);return}let a=h(r,n);if(!A(a,s)){$(t,n,e,o);return}U(r,n,e,o),pn(r,n,s,o);}function U(t,n,e,o){let r=g(e),i=t.componentBitFor.get(r.id);if(i===void 0)return;let s=t.componentStorageByBit[i];if(!s)return;let a=n&t.options.indexMask;if(r.kind==="soa"&&s.soa){if(o==null)return;let c=o;for(let f of r.fields){if(!(f.name in c))continue;let d=s.soa[f.name];if(!d)continue;let u=c[f.name];if(f.vectorLen===1)d[a]=typeof u=="boolean"?u?1:0:Number(u);else if(Array.isArray(u)||ArrayBuffer.isView(u)){let l=a*f.vectorLen,J=u;for(let I=0;I<f.vectorLen;I++)d[l+I]=Number(J[I]??0);}}}else if(r.kind==="aos"&&s.aos){let c=r.factory??(()=>({})),f=s.aos[a];if(f===void 0&&(f=c(),s.aos[a]=f),o&&typeof o=="object"){let d=o,u=f;for(let l of Object.keys(d))l==="__proto__"||l==="constructor"||l==="prototype"||(u[l]=d[l]);}}}function G(t,n,e){for(let o of n){let r=t[o.name];if(r)if(o.vectorLen===1)r[e]=0;else {let i=e*o.vectorLen;for(let s=0;s<o.vectorLen;s++)r[i+s]=0;}}}function H(t,n){let e=t.options.maskWordCount,o=n&t.options.indexMask,r=o*e;B(t.entityMask,r,e,i=>{let s=t.componentStorageByBit[i],a=t.componentInfoByBit[i];s?.kind==="soa"&&s.soa&&a?G(s.soa,a.fields,o):s?.kind==="aos"&&s.aos&&(s.aos[o]=void 0);});}function V(t,n,e){let o=n&t.options.indexMask,r=t.entityArchetype[o]??0,i=t.archetypes[r];if(!i)return;let a=N(t,e).archId,c=t.archetypes[a];if(c){if(a!==r){let f=i.entityRow.get(n);if(f!==void 0){let u=i.size-1;if(f!==u){let l=i.entities[u]??0;i.entities[f]=l,i.entityRow.set(l,f);}i.entities[u]=0,i.entityRow.delete(n),i.size--;}k(c,c.size+1);let d=c.size;c.entities[d]=n,c.entityRow.set(n,d),c.size++,t.entityArchetype[o]=a;}q(t,n,e);}}var v={fireAdd:()=>{},fireRemove:()=>{},fireSet:()=>{}},X=()=>{};function Xn(t){X=t;}function R(t,n,e,o,r){X(t,n,e,o,r);}function Y(t,n,e){let o=t.options.maskWordCount,r=b(e),i=b(e);B(e,0,o,s=>{E(i,s),R(t,n,s,r,i),E(r,s);});}function Yn(t){v=t;}function ln(t,n,e){v.fireAdd(t,n,e);}function yn(t,n,e){v.fireRemove(t,n,e);}function pn(t,n,e,o){v.fireSet(t,n,e,o);}function Kn(t){return x.get(t)}function Qn(){return Array.from(x.values())}var j=24,mn=8,K=(1<<j)-1,Q=(1<<mn)-1;function Z(t,n,e){return ((n&e.generationMask)<<e.indexBits|t&e.indexMask)>>>0}function tt(t,n){return t&n.indexMask}function et(t,n){return t>>>n.indexBits&n.generationMask}function ot(t){let n=y(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&&M(n,n.nextFreshIndex+1),e=n.nextFreshIndex++;}let o=n.generations[e]??0,r=Z(e,o,n.options),i=n.archetypes[0];if(!i)throw new Error("aiecsjs: missing empty archetype");k(i,i.size+1);let s=i.size;i.entities[s]=r,i.entityRow.set(r,s),i.size++,n.entityArchetype[e]=0;let a=n.options.maskWordCount,c=e*a;for(let f=0;f<a;f++)n.entityMask[c+f]=0;return n.size++,r}function rt(t,n){if(t.readOnly)throw new Error("aiecsjs: cannot create entities on a read-only world (worker-attached)");if(n<=0||n>=t.options.maxEntities)throw new Error(`aiecsjs: slot index ${n} out of range`);n>=t.capacity&&M(t,n+1);let e=t.generations[n]??0,o=Z(n,e,t.options);if(m(t,o))return o;if(n>=t.nextFreshIndex){for(let c=t.nextFreshIndex;c<n;c++)t.freeList.push(c);t.nextFreshIndex=n+1;}else {let c=t.freeList.lastIndexOf(n);if(c!==-1){let f=t.freeList.length-1;t.freeList[c]=t.freeList[f],t.freeList.pop();}}let r=t.archetypes[0];if(!r)throw new Error("aiecsjs: missing empty archetype");k(r,r.size+1);let i=r.size;r.entities[i]=o,r.entityRow.set(o,i),r.size++,t.entityArchetype[n]=0;let s=t.options.maskWordCount,a=n*s;for(let c=0;c<s;c++)t.entityMask[a+c]=0;return t.size++,o}function it(t,n){let e=y(t);if(e.readOnly)throw new Error("aiecsjs: cannot destroyEntity on a read-only world");if(!m(e,n))return;let o=n&e.options.indexMask,r=h(e,n),{dispatchDestroyObservers:i}=bn();i(e,n),An(e,n),H(e,n);let s=e.entityArchetype[o]??0,a=e.archetypes[s];if(a){let d=a.entityRow.get(n);if(d!==void 0){let u=a.size-1;if(d!==u){let l=a.entities[u]??0;a.entities[d]=l,a.entityRow.set(l,d);}a.entities[u]=0,a.entityRow.delete(n),a.size--;}}Y(e,n,r),e.entityArchetype[o]=0;let c=e.options.maskWordCount,f=o*c;for(let d=0;d<c;d++)e.entityMask[f+d]=0;e.generations[o]=(e.generations[o]??0)+1&e.options.generationMask,e.freeList.push(o),e.size--;}function hn(t,n){let e=y(t);return m(e,n)}function m(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}function st(t){return t&K}function at(t){return t>>>j&Q}function ct(t,n){return ((n&Q)<<j|t&K)>>>0}function ft(t,n){return typeof n!="number"?false:hn(t,n)}var _=null;function dt(t){_=t;}function bn(){return _||{dispatchDestroyObservers:()=>{}}}var L=null;function ut(t){L=t;}function An(t,n){L&&L(t,n);}export{st as A,at as B,ct as C,ft as D,dt as E,ut as F,Nn as G,Pn as H,qn as I,g as J,$ as K,$n as L,Gn as M,Hn as N,Vn as O,Xn as P,Yn as Q,Kn as R,Qn as S,F as a,T as b,z as c,xn as d,gn as e,kn as f,B as g,Cn as h,p as i,y as j,Mn as k,Un as l,On as m,Rn as n,_n as o,Ln as p,P as q,jn as r,Z as s,tt as t,et as u,ot as v,rt as w,it as x,hn as y,m as z};//# sourceMappingURL=chunk-OBMQME2P.js.map
-//# sourceMappingURL=chunk-OBMQME2P.js.map