@oasys/oecs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oasys
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,305 @@
+# OECS
+
+A fast, minimal archetype-based Entity Component System written in TypeScript.
+
+- **Zero-copy archetype transitions** — component data is indexed by entity, not archetype row. Moving between archetypes copies only the relevant column data.
+- **Structure-of-Arrays (SoA)** — each component field is a contiguous `number[]` column, enabling tight inner loops.
+- **Phantom-typed components** — `ComponentDef<["x", "y"]>` is just a number at runtime, but enforces field names at compile time.
+- **Batch iteration** — `query.each()` calls your function once per archetype with column arrays and entity count. You write the inner loop.
+- **Deferred structural changes** — add/remove component and destroy entity are buffered during system execution and flushed between phases.
+- **Topological system ordering** — systems within a phase are sorted by before/after constraints using Kahn's algorithm.
+
+## Quick start
+
+```ts
+import { World, SCHEDULE } from "@oasys/oecs";
+
+const world = new World();
+
+// Define components as field-name arrays
+const Pos = world.register_component(["x", "y"] as const);
+const Vel = world.register_component(["vx", "vy"] as const);
+
+// Tags have no fields
+const IsEnemy = world.register_tag();
+
+// Create entities and attach components
+const e = world.create_entity();
+world.add_component(e, Pos, { x: 0, y: 0 });
+world.add_component(e, Vel, { vx: 100, vy: 50 });
+world.add_component(e, IsEnemy);
+
+// Register a system with a typed query
+const moveSys = world.register_system(
+  (q, _ctx, dt) => {
+    q.each((pos, vel, n) => {
+      for (let i = 0; i < n; i++) {
+        pos.x[i] += vel.vx[i] * dt;
+        pos.y[i] += vel.vy[i] * dt;
+      }
+    });
+  },
+  (qb) => qb.every(Pos, Vel),
+);
+
+// Schedule the system
+world.add_systems(SCHEDULE.UPDATE, moveSys);
+
+// Initialize
+world.startup();
+
+// Game loop
+function frame(dt: number) {
+  world.update(dt);
+}
+```
+
+## Components
+
+Components are defined as readonly string arrays of field names. All field values are `number`.
+
+```ts
+const Position = world.register_component(["x", "y"] as const);
+const Health   = world.register_component(["current", "max"] as const);
+const IsEnemy  = world.register_tag(); // no fields
+```
+
+The `as const` is required so TypeScript infers the literal tuple type `["x", "y"]` instead of `string[]`. This enables type-safe field access throughout the API.
+
+### Adding components
+
+```ts
+const e = world.create_entity();
+
+// Data components require a values object
+world.add_component(e, Position, { x: 10, y: 20 });
+world.add_component(e, Health, { current: 100, max: 100 });
+
+// Tags require no values
+world.add_component(e, IsEnemy);
+
+// Add multiple at once (single archetype transition)
+world.add_components(e, [
+  { def: Position, values: { x: 10, y: 20 } },
+  { def: Health, values: { current: 100, max: 100 } },
+]);
+```
+
+### Removing and checking components
+
+```ts
+world.remove_component(e, Health);
+world.has_component(e, IsEnemy); // true
+```
+
+## Queries
+
+Queries are live views over all archetypes matching a component mask. They update automatically as new archetypes are created.
+
+### Batch iteration with `each()`
+
+`each()` calls your function once per matching archetype, passing column-group objects and the entity count. You write the inner loop.
+
+```ts
+const q = world.query(Position, Velocity);
+
+q.each((pos, vel, n) => {
+  // pos.x, pos.y, vel.vx, vel.vy are all number[]
+  // n is the entity count in this archetype
+  for (let i = 0; i < n; i++) {
+    pos.x[i] += vel.vx[i];
+    pos.y[i] += vel.vy[i];
+  }
+});
+```
+
+### Query chaining
+
+```ts
+// Extend required components
+const q = world.query(Position).and(Velocity);
+
+// Exclude archetypes that have a component
+const alive = world.query(Position).not(Dead);
+
+// Require at least one of these
+const damaged = world.query(Health).or(Poison, Fire);
+
+// Combine
+const targets = world.query(Position).and(Health).not(Shield).or(IsEnemy, IsBoss);
+```
+
+### Manual iteration
+
+For dynamic component access, iterate archetypes directly:
+
+```ts
+for (const arch of world.query(Position)) {
+  const px = arch.get_column(Position, "x");
+  const py = arch.get_column(Position, "y");
+  const count = arch.entity_count;
+
+  for (let i = 0; i < count; i++) {
+    px[i] += 1;
+    py[i] += 1;
+  }
+}
+```
+
+## Systems
+
+Systems are plain functions registered with a query and scheduled into lifecycle phases.
+
+### Registration
+
+Two registration styles:
+
+```ts
+// Style 1: Function + query builder (typed, preferred)
+const moveSys = world.register_system(
+  (q, ctx, dt) => {
+    q.each((pos, vel, n) => {
+      for (let i = 0; i < n; i++) {
+        pos.x[i] += vel.vx[i] * dt;
+        pos.y[i] += vel.vy[i] * dt;
+      }
+    });
+  },
+  (qb) => qb.every(Pos, Vel),
+);
+
+// Style 2: Config object (for systems that don't need a query)
+const logSys = world.register_system({
+  fn(ctx, dt) {
+    console.log("frame", dt);
+  },
+});
+```
+
+### Deferred operations
+
+Inside systems, use `ctx` (SystemContext) for structural changes. These are buffered and applied between phases.
+
+```ts
+const spawnSys = world.register_system({
+  fn(ctx, _dt) {
+    const e = ctx.create_entity();
+    ctx.add_component(e, Position, { x: 0, y: 0 });
+    ctx.destroy_entity(someOtherEntity);
+    ctx.remove_component(anotherEntity, Health);
+    // Changes are applied after all systems in this phase complete
+  },
+});
+```
+
+### Per-entity field access
+
+For reading/writing individual entity fields (not batch):
+
+```ts
+const damageSys = world.register_system({
+  fn(ctx, _dt) {
+    const hp = ctx.get_field(Health, targetEntity, "current");
+    ctx.set_field(Health, targetEntity, "current", hp - 10);
+  },
+});
+```
+
+## Schedule
+
+Six lifecycle phases, executed in order:
+
+| Phase | When | Use case |
+|---|---|---|
+| `PRE_STARTUP` | Once, before startup | Resource loading, allocation |
+| `STARTUP` | Once | Initial entity spawning |
+| `POST_STARTUP` | Once, after startup | Validation, index building |
+| `PRE_UPDATE` | Every frame, first | Input handling, time management |
+| `UPDATE` | Every frame | Game logic, physics, AI |
+| `POST_UPDATE` | Every frame, last | Rendering, cleanup |
+
+Deferred changes are flushed automatically after each phase.
+
+```ts
+world.add_systems(SCHEDULE.UPDATE, moveSys, physicsSys);
+world.add_systems(SCHEDULE.POST_UPDATE, renderSys);
+```
+
+### Ordering constraints
+
+```ts
+world.add_systems(SCHEDULE.UPDATE, moveSys, {
+  system: physicsSys,
+  ordering: { after: [moveSys] },
+});
+
+world.add_systems(SCHEDULE.UPDATE, {
+  system: aiSys,
+  ordering: { before: [moveSys] },
+});
+```
+
+Systems with ordering constraints are topologically sorted. Systems with no constraints run in registration order.
+
+## Entity lifecycle
+
+```ts
+const e = world.create_entity();
+
+world.is_alive(e); // true
+
+world.destroy_entity(e); // deferred
+world.flush();           // apply now
+
+world.is_alive(e); // false
+```
+
+Entity IDs are generational: destroying an entity increments its slot's generation, so stale IDs are safely detected as dead.
+
+## Lifecycle hooks
+
+Systems can define lifecycle hooks:
+
+```ts
+const sys = world.register_system({
+  fn(ctx, dt) { /* runs every frame */ },
+
+  on_added(store) {
+    // Called once during world.startup()
+  },
+
+  on_removed() {
+    // Called when system is unregistered via world.remove_system()
+  },
+
+  dispose() {
+    // Called during world.dispose()
+  },
+});
+```
+
+## Dev / Prod modes
+
+The codebase uses `__DEV__` compile-time flags. In development builds, you get:
+
+- Bounds checking on entity IDs
+- Validation on branded type construction
+- Duplicate system detection
+- Circular dependency detection
+- Helpful error messages with context
+
+All dev-only checks are tree-shaken in production builds.
+
+## Development
+
+```bash
+pnpm install
+pnpm test          # vitest in watch mode
+pnpm bench         # run benchmarks
+pnpm build         # vite library build
+pnpm tsc --noEmit  # type check
+```
+
+## Architecture
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for a thorough explanation of the internal design.

package/dist/archetype.d.ts

@@ -0,0 +1,61 @@
+import { Brand, BitSet } from './type_primitives';
+import { ComponentID, ComponentFields, ComponentDef, ColumnsForSchema } from './component';
+import { EntityID } from './entity';
+export type ArchetypeID = Brand<number, "archetype_id">;
+export declare const as_archetype_id: (value: number) => ArchetypeID;
+export interface ArchetypeEdge {
+    add: ArchetypeID | null;
+    remove: ArchetypeID | null;
+}
+export interface ArchetypeColumnLayout {
+    component_id: ComponentID;
+    field_names: string[];
+    field_index: Record<string, number>;
+}
+interface ArchetypeColumnGroup {
+    layout: ArchetypeColumnLayout;
+    columns: number[][];
+    record: Record<string, number[]>;
+}
+export declare class Archetype {
+    readonly id: ArchetypeID;
+    readonly mask: BitSet;
+    readonly has_columns: boolean;
+    entity_ids: EntityID[];
+    length: number;
+    private edges;
+    readonly column_groups: (ArchetypeColumnGroup | undefined)[];
+    private _column_ids;
+    constructor(id: ArchetypeID, mask: BitSet, layouts?: ArchetypeColumnLayout[]);
+    get entity_count(): number;
+    get entity_list(): readonly EntityID[];
+    has_component(id: ComponentID): boolean;
+    matches(required: BitSet): boolean;
+    /** Get a single field's column. Valid data: indices 0..entity_count-1. */
+    get_column<F extends ComponentFields, Field extends F[number]>(def: ComponentDef<F>, field: Field): number[];
+    /** Get all columns for a component as { fieldName: number[] }. */
+    get_column_group<F extends ComponentFields>(def: ComponentDef<F>): ColumnsForSchema<F>;
+    write_fields(row: number, component_id: ComponentID, values: Record<string, number>): void;
+    read_field(row: number, component_id: ComponentID, field: string): number;
+    /** Copy all shared component columns from source archetype at src_row into dst_row. */
+    copy_shared_from(source: Archetype, src_row: number, dst_row: number): void;
+    /**
+     * Add an entity. Pushes zeroes into all columns and returns the assigned row.
+     * Store is responsible for tracking entity_index → row.
+     */
+    add_entity(entity_id: EntityID): number;
+    /**
+     * Remove entity at row via swap-and-pop. Swaps the last entity into the
+     * vacated row to keep data dense. Returns the entity_index of the swapped
+     * entity (so Store can update its row), or -1 if no swap was needed.
+     */
+    remove_entity(row: number): number;
+    /** Tag-optimized add: skip column push entirely (no data to store). */
+    add_entity_tag(entity_id: EntityID): number;
+    /** Tag-optimized remove via swap-and-pop: skip column swap/pop entirely. */
+    remove_entity_tag(row: number): number;
+    get_edge(component_id: ComponentID): ArchetypeEdge | undefined;
+    set_edge(component_id: ComponentID, edge: ArchetypeEdge): void;
+}
+export {};
+//# sourceMappingURL=archetype.d.ts.map

package/dist/archetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype.d.ts","sourceRoot":"","sources":["../src/archetype.ts"],"names":[],"mappings":"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"}

package/dist/component.d.ts

@@ -0,0 +1,18 @@
+import { Brand } from './type_primitives';
+export type ComponentID = Brand<number, "component_id">;
+export declare const as_component_id: (value: number) => ComponentID;
+export type ComponentFields = readonly string[];
+/** Maps component fields to their value object: { x: number, y: number }. */
+export type FieldValues<F extends ComponentFields> = {
+    readonly [K in F[number]]: number;
+};
+/** Maps component fields to column arrays: { x: number[], y: number[] }. */
+export type ColumnsForSchema<F extends ComponentFields> = {
+    readonly [K in F[number]]: number[];
+};
+declare const __schema: unique symbol;
+export type ComponentDef<F extends ComponentFields = ComponentFields> = ComponentID & {
+    readonly [__schema]: F;
+};
+export {};
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;KAkBK;AAEL,OAAO,EACL,KAAK,EAGN,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACxD,eAAO,MAAM,eAAe,UAAW,MAAM,gBAK1C,CAAC;AAEJ,MAAM,MAAM,eAAe,GAAG,SAAS,MAAM,EAAE,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI;IACnD,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CAClC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,eAAe,IAAI;IACxD,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;CACpC,CAAC;AAKF,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC;AAEtC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAClE,WAAW,GAAG;IAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC"}

package/dist/entity.d.ts

@@ -0,0 +1,11 @@
+import { Brand } from './type_primitives';
+export type EntityID = Brand<number, "entity_id">;
+export declare const INDEX_BITS = 20;
+export declare const INDEX_MASK: number;
+export declare const MAX_INDEX: number;
+export declare const GENERATION_BITS: number;
+export declare const MAX_GENERATION: number;
+export declare const create_entity_id: (index: number, generation: number) => EntityID;
+export declare const get_entity_index: (id: EntityID) => number;
+export declare const get_entity_generation: (id: EntityID) => number;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;KAkBK;AAEL,OAAO,EAAE,KAAK,EAAe,MAAM,iBAAiB,CAAC;AAGrD,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAElD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,QAAwB,CAAC;AAChD,eAAO,MAAM,SAAS,QAAa,CAAC;AACpC,eAAO,MAAM,eAAe,QAAkB,CAAC;AAC/C,eAAO,MAAM,cAAc,QAA6B,CAAC;AAEzD,eAAO,MAAM,gBAAgB,UACpB,MAAM,cACD,MAAM,KACjB,QAWF,CAAC;AAEF,eAAO,MAAM,gBAAgB,OAAQ,QAAQ,KAAG,MAAyB,CAAC;AAE1E,eAAO,MAAM,qBAAqB,OAAQ,QAAQ,KAAG,MACvB,CAAC"}

package/dist/event.d.ts

@@ -0,0 +1,24 @@
+import { Brand } from './type_primitives';
+import { ComponentFields, ColumnsForSchema } from './component';
+export type EventID = Brand<number, "event_id">;
+export declare const as_event_id: (value: number) => EventID;
+declare const __event_schema: unique symbol;
+export type EventDef<F extends ComponentFields = ComponentFields> = EventID & {
+    readonly [__event_schema]: F;
+};
+/** Reader view over an event channel's SoA columns. */
+export type EventReader<F extends ComponentFields> = {
+    length: number;
+} & ColumnsForSchema<F>;
+export declare class EventChannel {
+    readonly field_names: string[];
+    readonly columns: number[][];
+    readonly reader: EventReader<any>;
+    constructor(field_names: string[]);
+    emit(values: Record<string, number>): void;
+    /** Emit a signal (zero-field event). */
+    emit_signal(): void;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAyBK;AAEL,OAAO,EACL,KAAK,EAGN,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAChD,eAAO,MAAM,WAAW,UAAW,MAAM,YAKtC,CAAC;AAGJ,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAE5C,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAC9D,OAAO,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7C,uDAAuD;AACvD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE9F,qBAAa,YAAY;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;gBAEtB,WAAW,EAAE,MAAM,EAAE;IAejC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAS1C,wCAAwC;IACxC,WAAW,IAAI,IAAI;IAInB,KAAK,IAAI,IAAI;CAOd"}

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var $=Object.defineProperty;var z=(a,t,e)=>t in a?$(a,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):a[t]=e;var l=(a,t,e)=>z(a,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class Y extends Error{constructor(t,e,s){super(t),this.is_operational=e,this.context=s,this.name=this.constructor.name,Error.captureStackTrace(this,this.constructor)}}var u=(a=>(a.EID_MAX_INDEX_OVERFLOW="EID_MAX_INDEX_OVERFLOW",a.EID_MAX_GEN_OVERFLOW="EID_MAX_GEN_OVERFLOW",a.COMPONENT_NOT_REGISTERED="COMPONENT_NOT_REGISTERED",a.ENTITY_NOT_ALIVE="ENTITY_NOT_ALIVE",a.CIRCULAR_SYSTEM_DEPENDENCY="CIRCULAR_SYSTEM_DEPENDENCY",a.DUPLICATE_SYSTEM="DUPLICATE_SYSTEM",a.ARCHETYPE_NOT_FOUND="ARCHETYPE_NOT_FOUND",a))(u||{});class g extends Y{constructor(t,e,s){super(e??t,!0,s),this.category=t}}var C=(a=>(a.ASSERTION_FAIL_CONDITION="ASSERTION_FAIL_CONDITION",a.VALIDATION_FAIL_CONDITION="VALIDATION_FAIL_CONDITION",a))(C||{});class B extends Y{constructor(t,e,s){super(e,!1,s),this.category=t}}const P=a=>Number.isInteger(a)&&a>=0;function b(a,t,e){if(process.env.NODE_ENV!=="production"&&!t(a))throw new B(C.VALIDATION_FAIL_CONDITION,`Expected value to meet validation: ${e}`);return a}const Q=4;class T{constructor(t){l(this,"_words");this._words=t??new Array(Q).fill(0)}has(t){const e=t>>>5;return e>=this._words.length?!1:(this._words[e]&1<<(t&31))!==0}set(t){const e=t>>>5;e>=this._words.length&&this.grow(e+1),this._words[e]|=1<<(t&31)}clear(t){const e=t>>>5;e>=this._words.length||(this._words[e]&=~(1<<(t&31)))}overlaps(t){const e=this._words,s=t._words,n=e.length<s.length?e.length:s.length;for(let r=0;r<n;r++)if((e[r]&s[r])!==0)return!0;return!1}contains(t){const e=t._words,s=this._words,n=s.length;for(let r=0;r<e.length;r++){const o=e[r];if(o!==0&&(r>=n||(s[r]&o)!==o))return!1}return!0}equals(t){const e=this._words,s=t._words,n=e.length>s.length?e.length:s.length;for(let r=0;r<n;r++){const o=r<e.length?e[r]:0,_=r<s.length?s[r]:0;if(o!==_)return!1}return!0}copy(){return new T(this._words.slice())}copy_with_set(t){const e=t>>>5,s=e+1,n=this._words.length>s?this._words.length:s,r=new Array(n).fill(0);for(let o=0;o<this._words.length;o++)r[o]=this._words[o];return r[e]|=1<<(t&31),new T(r)}copy_with_clear(t){const e=this._words.slice(),s=t>>>5;return s<e.length&&(e[s]&=~(1<<(t&31))),new T(e)}hash(){let t=2166136261;const e=this._words;let s=e.length-1;for(;s>=0&&e[s]===0;)s--;for(let n=0;n<=s;n++)t^=e[n],t=Math.imul(t,16777619);return t}for_each(t){const e=this._words;for(let s=0;s<e.length;s++){let n=e[s];if(n===0)continue;const r=s<<5;for(;n!==0;){const o=n&-n>>>0,_=31-Math.clz32(o);t(r+_),n^=o}}}grow(t){let e=this._words.length;for(;e<t;)e*=2;const s=new Array(e).fill(0);for(let n=0;n<this._words.length;n++)s[n]=this._words[n];this._words=s}}const D=20,S=(1<<D)-1,K=S,J=31-D,k=(1<<J)-1,Z=(a,t)=>{if(process.env.NODE_ENV!=="production"){if(a<0||a>K)throw new g(u.EID_MAX_INDEX_OVERFLOW);if(t<0||t>k)throw new g(u.EID_MAX_GEN_OVERFLOW)}return t<<D|a},m=a=>a&S,R=a=>a>>D,H=a=>b(a,P,"ComponentID must be a non-negative integer"),tt=a=>b(a,P,"EventID must be a non-negative integer");class et{constructor(t){l(this,"field_names");l(this,"columns");l(this,"reader");this.field_names=t,this.columns=[];for(let s=0;s<t.length;s++)this.columns.push([]);const e={length:0};for(let s=0;s<t.length;s++)e[t[s]]=this.columns[s];this.reader=e}emit(t){const e=this.field_names,s=this.columns;for(let n=0;n<e.length;n++)s[n].push(t[e[n]]);this.reader.length++}emit_signal(){this.reader.length++}clear(){this.reader.length=0;const t=this.columns;for(let e=0;e<t.length;e++)t[e].length=0}}const st=a=>b(a,P,"ArchetypeID must be a non-negative integer");class nt{constructor(t,e,s){l(this,"id");l(this,"mask");l(this,"has_columns");l(this,"entity_ids",[]);l(this,"length",0);l(this,"edges",[]);l(this,"column_groups",[]);l(this,"_column_ids",[]);if(this.id=t,this.mask=e,s)for(let n=0;n<s.length;n++){const r=s[n],o=new Array(r.field_names.length);for(let h=0;h<r.field_names.length;h++)o[h]=[];const _=Object.create(null);for(let h=0;h<r.field_names.length;h++)_[r.field_names[h]]=o[h];this.column_groups[r.component_id]={layout:r,columns:o,record:_},this._column_ids.push(r.component_id)}this.has_columns=this._column_ids.length>0}get entity_count(){return this.length}get entity_list(){return this.entity_ids}has_component(t){return this.mask.has(t)}matches(t){return this.mask.contains(t)}get_column(t,e){const s=this.column_groups[t];if(process.env.NODE_ENV!=="production"&&!s)throw new g(u.COMPONENT_NOT_REGISTERED,`Component ${t} not in archetype ${this.id}`);const n=s.layout.field_index[e];if(process.env.NODE_ENV!=="production"&&n===void 0)throw new g(u.COMPONENT_NOT_REGISTERED,`Field "${e}" does not exist on component`);return s.columns[n]}get_column_group(t){const e=this.column_groups[t];return e?e.record:{}}write_fields(t,e,s){const n=this.column_groups[e];if(!n)return;const{field_names:r}=n.layout;for(let o=0;o<r.length;o++)n.columns[o][t]=s[r[o]]}read_field(t,e,s){const n=this.column_groups[e];if(!n)return NaN;const r=n.layout.field_index[s];return r===void 0?NaN:n.columns[r][t]??NaN}copy_shared_from(t,e,s){const n=t.column_groups,r=this._column_ids;for(let o=0;o<r.length;o++){const _=r[o],h=n[_];if(!h)continue;const i=this.column_groups[_];for(let c=0;c<i.columns.length;c++)i.columns[c][s]=h.columns[c][e]}}add_entity(t){const e=this.length;this.entity_ids.push(t);const s=this._column_ids;for(let n=0;n<s.length;n++){const r=this.column_groups[s[n]];for(let o=0;o<r.columns.length;o++)r.columns[o].push(0)}return this.length++,e}remove_entity(t){const e=this.length-1;let s=-1;const n=this._column_ids;if(t!==e){this.entity_ids[t]=this.entity_ids[e],s=m(this.entity_ids[t]);for(let r=0;r<n.length;r++){const o=this.column_groups[n[r]];for(let _=0;_<o.columns.length;_++)o.columns[_][t]=o.columns[_][e],o.columns[_].pop()}}else for(let r=0;r<n.length;r++){const o=this.column_groups[n[r]];for(let _=0;_<o.columns.length;_++)o.columns[_].pop()}return this.entity_ids.pop(),this.length--,s}add_entity_tag(t){const e=this.length;return this.entity_ids.push(t),this.length++,e}remove_entity_tag(t){const e=this.length-1;let s=-1;return t!==e&&(this.entity_ids[t]=this.entity_ids[e],s=m(this.entity_ids[t])),this.entity_ids.pop(),this.length--,s}get_edge(t){return this.edges[t]}set_edge(t,e){this.edges[t]=e}}function j(a,t,e){const s=a.get(t);s!==void 0?s.push(e):a.set(t,[e])}const w=-1,M=Object.freeze(Object.create(null));class rt{constructor(){l(this,"entity_generations",[]);l(this,"entity_high_water",0);l(this,"entity_free_indices",[]);l(this,"entity_alive_count",0);l(this,"component_metas",[]);l(this,"component_count",0);l(this,"event_channels",[]);l(this,"event_count",0);l(this,"archetypes",[]);l(this,"archetype_map",new Map);l(this,"next_archetype_id",0);l(this,"component_index",new Map);l(this,"registered_queries",[]);l(this,"empty_archetype_id");l(this,"entity_archetype",[]);l(this,"entity_row",[]);l(this,"pending_destroy",[]);l(this,"pending_add_ids",[]);l(this,"pending_add_defs",[]);l(this,"pending_add_values",[]);l(this,"pending_remove_ids",[]);l(this,"pending_remove_defs",[]);this.empty_archetype_id=this.arch_get_or_create_from_mask(new T)}arch_get(t){if(process.env.NODE_ENV!=="production"&&(t<0||t>=this.archetypes.length))throw new g(u.ARCHETYPE_NOT_FOUND,`Archetype with ID ${t} not found`);return this.archetypes[t]}arch_get_or_create_from_mask(t){const e=t.hash(),s=this.archetype_map.get(e);if(s!==void 0){for(let h=0;h<s.length;h++)if(this.archetypes[s[h]].mask.equals(t))return s[h]}const n=st(this.next_archetype_id++),r=[];t.for_each(h=>{const i=h,c=this.component_metas[i];c&&c.field_names.length>0&&r.push({component_id:i,field_names:c.field_names,field_index:c.field_index})});const o=new nt(n,t,r);this.archetypes.push(o),j(this.archetype_map,e,n),t.for_each(h=>{const i=h;let c=this.component_index.get(i);c||(c=new Set,this.component_index.set(i,c)),c.add(n)});const _=this.registered_queries;for(let h=0;h<_.length;h++){const i=_[h];o.matches(i.include_mask)&&(!i.exclude_mask||!o.mask.overlaps(i.exclude_mask))&&(!i.any_of_mask||o.mask.overlaps(i.any_of_mask))&&i.result.push(o)}return n}arch_resolve_add(t,e){const s=this.arch_get(t);if(s.mask.has(e))return t;const n=s.get_edge(e);if((n==null?void 0:n.add)!=null)return n.add;const r=this.arch_get_or_create_from_mask(s.mask.copy_with_set(e));return this.arch_cache_edge(s,this.arch_get(r),e),r}arch_resolve_remove(t,e){const s=this.arch_get(t);if(!s.mask.has(e))return t;const n=s.get_edge(e);if((n==null?void 0:n.remove)!=null)return n.remove;const r=this.arch_get_or_create_from_mask(s.mask.copy_with_clear(e));return this.arch_cache_edge(this.arch_get(r),s,e),r}arch_cache_edge(t,e,s){const n=t.get_edge(s)??{add:null,remove:null};n.add=e.id,t.set_edge(s,n);const r=e.get_edge(s)??{add:null,remove:null};r.remove=t.id,e.set_edge(s,r)}create_entity(){let t,e;this.entity_free_indices.length>0?(t=this.entity_free_indices.pop(),e=this.entity_generations[t]):(t=this.entity_high_water++,this.entity_generations[t]=0,e=0),this.entity_alive_count++;const s=Z(t,e);return this.entity_archetype[t]=this.empty_archetype_id,this.entity_row[t]=w,s}destroy_entity(t){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return}const e=m(t),s=this.entity_row[e];if(s!==w){const o=this.arch_get(this.entity_archetype[e]).remove_entity(s);o!==-1&&(this.entity_row[o]=s)}this.entity_archetype[e]=w,this.entity_row[e]=w;const n=R(t);if(process.env.NODE_ENV!=="production"&&n>=k)throw new g(u.EID_MAX_GEN_OVERFLOW);this.entity_generations[e]=n+1&k,this.entity_free_indices.push(e),this.entity_alive_count--}is_alive(t){const e=m(t);return e<this.entity_high_water&&this.entity_generations[e]===R(t)}get entity_count(){return this.entity_alive_count}destroy_entity_deferred(t){if(process.env.NODE_ENV!=="production"&&!this.is_alive(t))throw new g(u.ENTITY_NOT_ALIVE);this.pending_destroy.push(t)}flush_destroyed(){const t=this.pending_destroy;if(t.length===0)return;const e=this.entity_archetype,s=this.entity_row,n=this.entity_generations,r=this.archetypes,o=this.entity_high_water;for(let _=0;_<t.length;_++){const h=t[_],i=h&S,c=h>>D;if(i>=o||n[i]!==c)continue;const d=s[i];if(d!==w){const f=r[e[i]],p=f.has_columns?f.remove_entity(d):f.remove_entity_tag(d);p!==-1&&(s[p]=d)}if(e[i]=w,s[i]=w,process.env.NODE_ENV!=="production"&&c>=k)throw new g(u.EID_MAX_GEN_OVERFLOW);n[i]=c+1&k,this.entity_free_indices.push(i),this.entity_alive_count--}t.length=0}get pending_destroy_count(){return this.pending_destroy.length}add_component_deferred(t,e,s){if(process.env.NODE_ENV!=="production"&&!this.is_alive(t))throw new g(u.ENTITY_NOT_ALIVE);this.pending_add_ids.push(t),this.pending_add_defs.push(e),this.pending_add_values.push(s??M)}remove_component_deferred(t,e){if(process.env.NODE_ENV!=="production"&&!this.is_alive(t))throw new g(u.ENTITY_NOT_ALIVE);this.pending_remove_ids.push(t),this.pending_remove_defs.push(e)}flush_structural(){this.pending_add_ids.length>0&&this._flush_adds(),this.pending_remove_ids.length>0&&this._flush_removes()}_flush_adds(){const t=this.pending_add_ids,e=this.pending_add_defs,s=this.pending_add_values,n=t.length,r=this.entity_archetype,o=this.entity_row,_=this.entity_generations,h=this.archetypes,i=this.component_metas,c=this.entity_high_water;for(let d=0;d<n;d++){const f=t[d],p=f&S,v=f>>D;if(p>=c||_[p]!==v)continue;const O=r[p],E=e[d],y=h[O];if(y.mask.has(E)){i[E].field_names.length>0&&y.write_fields(o[p],E,s[d]);continue}const A=this.arch_resolve_add(O,E),N=h[A],I=o[p],x=!N.has_columns&&!y.has_columns,V=x?N.add_entity_tag(f):N.add_entity(f);if(I!==w){x||N.copy_shared_from(y,I,V);const q=x?y.remove_entity_tag(I):y.remove_entity(I);q!==-1&&(o[q]=I)}i[E].field_names.length>0&&N.write_fields(V,E,s[d]),r[p]=A,o[p]=V}t.length=0,e.length=0,s.length=0}_flush_removes(){const t=this.pending_remove_ids,e=this.pending_remove_defs,s=t.length,n=this.entity_archetype,r=this.entity_row,o=this.entity_generations,_=this.archetypes,h=this.entity_high_water;for(let i=0;i<s;i++){const c=t[i],d=c&S,f=c>>D;if(d>=h||o[d]!==f)continue;const p=n[d],v=e[i],O=_[p];if(!O.mask.has(v))continue;const E=this.arch_resolve_remove(p,v),y=_[E],A=r[d],N=!y.has_columns&&!O.has_columns,I=N?y.add_entity_tag(c):y.add_entity(c);N||y.copy_shared_from(O,A,I);const x=N?O.remove_entity_tag(A):O.remove_entity(A);x!==-1&&(r[x]=A),n[d]=E,r[d]=I}t.length=0,e.length=0}get pending_structural_count(){return this.pending_add_ids.length+this.pending_remove_ids.length}register_component(t){const e=H(this.component_count++),s=t,n=Object.create(null);for(let r=0;r<s.length;r++)n[s[r]]=r;return this.component_metas.push({field_names:s,field_index:n}),e}add_component(t,e,s){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return}const n=m(t),r=this.entity_archetype[n],o=this.arch_get(r);if(o.has_component(e)){o.write_fields(this.entity_row[n],e,s);return}const _=this.arch_resolve_add(r,e),h=this.arch_get(_),i=this.entity_row[n],c=h.add_entity(t);if(i!==w){h.copy_shared_from(o,i,c);const d=o.remove_entity(i);d!==-1&&(this.entity_row[d]=i)}h.write_fields(c,e,s),this.entity_archetype[n]=_,this.entity_row[n]=c}add_components(t,e){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return}const s=m(t),n=this.entity_archetype[s];let r=n;for(let o=0;o<e.length;o++)r=this.arch_resolve_add(r,e[o].def);if(r!==n){const o=this.arch_get(n),_=this.arch_get(r),h=this.entity_row[s],i=_.add_entity(t);if(h!==w){_.copy_shared_from(o,h,i);const c=o.remove_entity(h);c!==-1&&(this.entity_row[c]=h)}for(let c=0;c<e.length;c++)_.write_fields(i,e[c].def,e[c].values??M);this.entity_archetype[s]=r,this.entity_row[s]=i}else{const o=this.arch_get(n),_=this.entity_row[s];for(let h=0;h<e.length;h++)o.write_fields(_,e[h].def,e[h].values??M)}}remove_component(t,e){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return}const s=m(t),n=this.entity_archetype[s],r=this.arch_get(n);if(!r.has_component(e))return;const o=this.arch_resolve_remove(n,e),_=this.arch_get(o),h=this.entity_row[s],i=_.add_entity(t);_.copy_shared_from(r,h,i);const c=r.remove_entity(h);c!==-1&&(this.entity_row[c]=h),this.entity_archetype[s]=o,this.entity_row[s]=i}remove_components(t,e){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return}const s=m(t),n=this.entity_archetype[s];let r=n;for(let d=0;d<e.length;d++)r=this.arch_resolve_remove(r,e[d]);if(r===n)return;const o=this.arch_get(n),_=this.arch_get(r),h=this.entity_row[s],i=_.add_entity(t);_.copy_shared_from(o,h,i);const c=o.remove_entity(h);c!==-1&&(this.entity_row[c]=h),this.entity_archetype[s]=r,this.entity_row[s]=i}has_component(t,e){if(!this.is_alive(t)){if(process.env.NODE_ENV!=="production")throw new g(u.ENTITY_NOT_ALIVE);return!1}const s=m(t);return this.arch_get(this.entity_archetype[s]).has_component(e)}get_entity_archetype(t){return this.arch_get(this.entity_archetype[m(t)])}get_entity_row(t){return this.entity_row[m(t)]}get_matching_archetypes(t,e,s){const n=t._words;let r=!1;for(let i=0;i<n.length;i++)if(n[i]!==0){r=!0;break}if(!r)return this.archetypes.filter(i=>(!e||!i.mask.overlaps(e))&&(!s||i.mask.overlaps(s)));let o,_=!1;for(let i=0;i<n.length;i++){let c=n[i];if(c===0)continue;const d=i<<5;for(;c!==0;){const f=c&-c>>>0,p=d+(31-Math.clz32(f));c^=f;const v=this.component_index.get(p);if(!v||v.size===0){_=!0;break}(!o||v.size<o.size)&&(o=v)}if(_)break}if(_||!o)return[];const h=[];for(const i of o){const c=this.arch_get(i);c.matches(t)&&(!e||!c.mask.overlaps(e))&&(!s||c.mask.overlaps(s))&&h.push(c)}return h}register_query(t,e,s){const n=this.get_matching_archetypes(t,e,s);return this.registered_queries.push({include_mask:t.copy(),exclude_mask:e?e.copy():null,any_of_mask:s?s.copy():null,result:n}),n}get archetype_count(){return this.archetypes.length}register_event(t){const e=tt(this.event_count++),s=new et(t);return this.event_channels.push(s),e}emit_event(t,e){this.event_channels[t].emit(e)}emit_signal(t){this.event_channels[t].emit_signal()}get_event_reader(t){return this.event_channels[t].reader}clear_events(){const t=this.event_channels;for(let e=0;e<t.length;e++)t[e].clear()}}var F=(a=>(a.PRE_STARTUP="PRE_STARTUP",a.STARTUP="STARTUP",a.POST_STARTUP="POST_STARTUP",a.PRE_UPDATE="PRE_UPDATE",a.UPDATE="UPDATE",a.POST_UPDATE="POST_UPDATE",a))(F||{});const L=["PRE_STARTUP","STARTUP","POST_STARTUP"],U=["PRE_UPDATE","UPDATE","POST_UPDATE"];class ot{constructor(){l(this,"label_systems",new Map);l(this,"sorted_cache",new Map);l(this,"system_index",new Map);l(this,"next_insertion_order",0);for(let t=0;t<L.length;t++)this.label_systems.set(L[t],[]);for(let t=0;t<U.length;t++)this.label_systems.set(U[t],[])}add_systems(t,...e){for(const s of e){const n="system"in s?s.system:s,r="system"in s?s.ordering:void 0;if(process.env.NODE_ENV!=="production"&&this.system_index.has(n))throw new g(u.DUPLICATE_SYSTEM,`System ${n.id} is already scheduled`);const o={descriptor:n,insertion_order:this.next_insertion_order++,before:new Set((r==null?void 0:r.before)??[]),after:new Set((r==null?void 0:r.after)??[])};this.label_systems.get(t).push(o),this.system_index.set(n,t),this.sorted_cache.delete(t)}}remove_system(t){const e=this.system_index.get(t);if(e===void 0)return;const s=this.label_systems.get(e),n=s.findIndex(r=>r.descriptor===t);if(n!==-1){const r=s.length-1;n!==r&&(s[n]=s[r]),s.pop();for(const o of s)o.before.delete(t),o.after.delete(t)}this.system_index.delete(t),this.sorted_cache.delete(e)}run_startup(t){for(const e of L)this.run_label(e,t,0)}run_update(t,e){for(const s of U)this.run_label(s,t,e)}get_all_systems(){const t=[];for(const e of this.label_systems.values())for(const s of e)t.push(s.descriptor);return t}has_system(t){return this.system_index.has(t)}clear(){for(const t of this.label_systems.values())t.length=0;this.sorted_cache.clear(),this.system_index.clear()}run_label(t,e,s){const n=this.get_sorted(t);for(let r=0;r<n.length;r++)n[r].fn(e,s);e.flush()}get_sorted(t){const e=this.sorted_cache.get(t);if(e!==void 0)return e;const s=this.label_systems.get(t),n=this.topological_sort(s,t);return this.sorted_cache.set(t,n),n}topological_sort(t,e){if(t.length===0)return[];const s=new Map,n=new Map,r=new Map,o=new Set;for(const i of t)s.set(i.descriptor,new Set),n.set(i.descriptor,0),r.set(i.descriptor,i.insertion_order),o.add(i.descriptor);for(const i of t){for(const c of i.before)o.has(c)&&(s.get(i.descriptor).add(c),n.set(c,n.get(c)+1));for(const c of i.after)o.has(c)&&(s.get(c).add(i.descriptor),n.set(i.descriptor,n.get(i.descriptor)+1))}let _=[];for(const i of t)n.get(i.descriptor)===0&&_.push(i.descriptor);_.sort((i,c)=>r.get(c)-r.get(i));const h=[];for(;_.length>0;){const i=_.pop();h.push(i);for(const c of s.get(i)){const d=n.get(c)-1;n.set(c,d),d===0&&_.push(c)}_.sort((c,d)=>r.get(d)-r.get(c))}if(h.length!==t.length){const i=new Set(h),c=t.filter(d=>!i.has(d.descriptor)).map(d=>`system_${d.descriptor.id}`);throw new g(u.CIRCULAR_SYSTEM_DEPENDENCY,`Circular system dependency detected in ${e}: [${c.join(", ")}]`)}return h}}const it=Object.freeze(Object.create(null));class X{constructor(t,e,s,n,r,o){l(this,"_archetypes");l(this,"_defs");l(this,"_resolver");l(this,"_include");l(this,"_exclude");l(this,"_any_of");l(this,"_args_buf");this._archetypes=t,this._defs=e,this._resolver=s,this._include=n,this._exclude=r,this._any_of=o,this._args_buf=new Array(e.length+1)}get length(){return this._archetypes.length}count(){const t=this._archetypes;let e=0;for(let s=0;s<t.length;s++)e+=t[s].entity_count;return e}get archetypes(){return this._archetypes}*[Symbol.iterator](){const t=this._archetypes;for(let e=0;e<t.length;e++)t[e].entity_count>0&&(yield t[e])}each(t){const e=this._archetypes,s=this._defs,n=this._args_buf;for(let r=0;r<e.length;r++){const o=e[r],_=o.entity_count;if(_!==0){for(let h=0;h<s.length;h++)n[h]=o.get_column_group(s[h]);n[s.length]=_,t.apply(null,n)}}}and(...t){const e=this._include.copy(),s=this._defs.slice();for(let n=0;n<t.length;n++)e.has(t[n])||(e.set(t[n]),s.push(t[n]));return this._resolver._resolve_query(e,this._exclude,this._any_of,s)}not(...t){const e=this._exclude?this._exclude.copy():new T;for(let s=0;s<t.length;s++)e.set(t[s]);return this._resolver._resolve_query(this._include,e,this._any_of,this._defs)}or(...t){const e=this._any_of?this._any_of.copy():new T;for(let s=0;s<t.length;s++)e.set(t[s]);return this._resolver._resolve_query(this._include,this._exclude,e,this._defs)}}class G{constructor(t){this._resolver=t}every(...t){const e=new T;for(let s=0;s<t.length;s++)e.set(t[s]);return this._resolver._resolve_query(e,null,null,t)}}class W{constructor(t){l(this,"store");this.store=t}create_entity(){return this.store.create_entity()}get_field(t,e,s){const n=this.store.get_entity_archetype(e),r=this.store.get_entity_row(e);return n.read_field(r,t,s)}set_field(t,e,s,n){const r=this.store.get_entity_archetype(e),o=this.store.get_entity_row(e),_=r.get_column(t,s);_[o]=n}destroy_entity(t){return this.store.destroy_entity_deferred(t),this}flush_destroyed(){this.store.flush_destroyed()}add_component(t,e,s){return this.store.add_component_deferred(t,e,s??it),this}remove_component(t,e){return this.store.remove_component_deferred(t,e),this}flush(){this.store.flush_structural(),this.store.flush_destroyed()}emit(t,e){e===void 0?this.store.emit_signal(t):this.store.emit_event(t,e)}read(t){return this.store.get_event_reader(t)}}const _t=a=>b(a,P,"SystemID must be a non-negative integer"),ct=Object.freeze(Object.create(null));class ht{constructor(){l(this,"store");l(this,"schedule");l(this,"ctx");l(this,"systems",new Set);l(this,"next_system_id",0);l(this,"query_cache",new Map);l(this,"scratch_mask",new T);this.store=new rt,this.schedule=new ot,this.ctx=new W(this.store)}register_component(t){return this.store.register_component(t)}register_tag(){return this.store.register_component([])}register_event(t){return this.store.register_event(t)}register_signal(){return this.store.register_event([])}create_entity(){return this.store.create_entity()}destroy_entity(t){this.store.destroy_entity_deferred(t)}is_alive(t){return this.store.is_alive(t)}get entity_count(){return this.store.entity_count}add_component(t,e,s){this.store.add_component(t,e,s??ct)}add_components(t,e){this.store.add_components(t,e)}remove_component(t,e){return this.store.remove_component(t,e),this}remove_components(t,...e){this.store.remove_components(t,e)}has_component(t,e){return this.store.has_component(t,e)}get_field(t,e,s){const n=this.store.get_entity_archetype(e),r=this.store.get_entity_row(e);return n.read_field(r,t,s)}emit(t,e){e===void 0?this.store.emit_signal(t):this.store.emit_event(t,e)}query(...t){const e=this.scratch_mask;e._words.fill(0);for(let s=0;s<t.length;s++)e.set(t[s]);return this._resolve_query(e.copy(),null,null,t)}_resolve_query(t,e,s,n){const r=t.hash(),o=e?e.hash():0,_=s?s.hash():0,h=r^Math.imul(o,2654435769)^Math.imul(_,1367130551)|0,i=this._find_cached(h,t,e,s);if(i!==void 0)return i.query;const c=this.store.register_query(t,e??void 0,s??void 0),d=new X(c,n,this,t.copy(),(e==null?void 0:e.copy())??null,(s==null?void 0:s.copy())??null);return j(this.query_cache,h,{include_mask:t.copy(),exclude_mask:(e==null?void 0:e.copy())??null,any_of_mask:(s==null?void 0:s.copy())??null,query:d}),d}_find_cached(t,e,s,n){const r=this.query_cache.get(t);if(r)for(let o=0;o<r.length;o++){const _=r[o];if(!(!_.include_mask.equals(e)||!(s===null?_.exclude_mask===null:_.exclude_mask!==null&&_.exclude_mask.equals(s))||!(n===null?_.any_of_mask===null:_.any_of_mask!==null&&_.any_of_mask.equals(n))))return _}}register_system(t,e){let s;if(typeof t=="function"){const o=e(new G(this)),_=this.ctx;s={fn:(h,i)=>t(o,_,i)}}else s=t;const n=_t(this.next_system_id++),r=Object.freeze(Object.assign({id:n},s));return this.systems.add(r),r}add_systems(t,...e){return this.schedule.add_systems(t,...e),this}remove_system(t){var e;this.schedule.remove_system(t),(e=t.on_removed)==null||e.call(t),this.systems.delete(t)}get system_count(){return this.systems.size}startup(){var t;for(const e of this.systems.values())(t=e.on_added)==null||t.call(e,this.store);this.schedule.run_startup(this.ctx)}update(t){this.store.clear_events(),this.schedule.run_update(this.ctx,t)}flush(){this.ctx.flush()}dispose(){var t,e;for(const s of this.systems.values())(t=s.dispose)==null||t.call(s),(e=s.on_removed)==null||e.call(s);this.systems.clear(),this.schedule.clear()}}exports.Query=X;exports.QueryBuilder=G;exports.SCHEDULE=F;exports.SystemContext=W;exports.World=ht;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { World } from './world';
+export { Query, QueryBuilder, SystemContext } from './query';
+export { SCHEDULE } from './schedule';
+export type { EntityID } from './entity';
+export type { ComponentDef, ComponentFields, FieldValues, ColumnsForSchema, } from './component';
+export type { EventDef, EventReader } from './event';
+export type { SystemFn, SystemConfig, SystemDescriptor, } from './system';
+export type { SystemEntry, SystemOrdering } from './schedule';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}