@oasys/oecs 0.1.0

package/dist/query.d.ts

@@ -0,0 +1,73 @@
+import { Store } from './store';
+import { Archetype } from './archetype';
+import { EntityID } from './entity';
+import { ComponentDef, ComponentFields, FieldValues, ColumnsForSchema } from './component';
+import { EventDef, EventReader } from './event';
+import { BitSet } from './type_primitives';
+type DefsToColumns<Defs extends readonly ComponentDef<ComponentFields>[]> = {
+    [K in keyof Defs]: ColumnsForSchema<Defs[K] extends ComponentDef<infer F> ? F : never>;
+};
+type EachFn<Defs extends readonly ComponentDef<ComponentFields>[]> = (...args: [...DefsToColumns<Defs>, number]) => void;
+export interface QueryCacheEntry {
+    include_mask: BitSet;
+    exclude_mask: BitSet | null;
+    any_of_mask: BitSet | null;
+    query: Query<any>;
+}
+export interface QueryResolver {
+    _resolve_query(include: BitSet, exclude: BitSet | null, any_of: BitSet | null, defs: readonly ComponentDef<ComponentFields>[]): Query<any>;
+}
+export declare class Query<Defs extends readonly ComponentDef<ComponentFields>[]> {
+    private readonly _archetypes;
+    private readonly _defs;
+    readonly _resolver: QueryResolver;
+    readonly _include: BitSet;
+    readonly _exclude: BitSet | null;
+    readonly _any_of: BitSet | null;
+    private readonly _args_buf;
+    constructor(archetypes: Archetype[], defs: Defs, resolver: QueryResolver, include: BitSet, exclude: BitSet | null, any_of: BitSet | null);
+    /** Number of matching archetypes (including empty ones). */
+    get length(): number;
+    /** Total entity count across all matching archetypes. */
+    count(): number;
+    get archetypes(): readonly Archetype[];
+    /** Iterate non-empty archetypes. Skips archetypes with zero entities. */
+    [Symbol.iterator](): Iterator<Archetype>;
+    /**
+     * Typed per-archetype iteration. Calls fn once per non-empty archetype
+     * with column groups for each queried component, plus the entity count.
+     * The system is responsible for the inner loop over entities.
+     */
+    each(fn: EachFn<Defs>): void;
+    /** Extend required component set. Returns a new (cached) Query. */
+    and<D extends ComponentDef<ComponentFields>[]>(...comps: D): Query<[...Defs, ...D]>;
+    /** Exclude archetypes that have any of these components. */
+    not(...comps: ComponentDef<ComponentFields>[]): Query<Defs>;
+    /** Require at least one of these components. */
+    or(...comps: ComponentDef<ComponentFields>[]): Query<Defs>;
+}
+export declare class QueryBuilder {
+    private readonly _resolver;
+    constructor(_resolver: QueryResolver);
+    every<T extends ComponentDef<ComponentFields>[]>(...defs: T): Query<T>;
+}
+export declare class SystemContext {
+    private readonly store;
+    constructor(store: Store);
+    create_entity(): EntityID;
+    get_field<F extends ComponentFields>(def: ComponentDef<F>, entity_id: EntityID, field: F[number]): number;
+    set_field<F extends ComponentFields>(def: ComponentDef<F>, entity_id: EntityID, field: F[number], value: number): void;
+    /** Buffer an entity for deferred destruction (applied at phase flush). */
+    destroy_entity(id: EntityID): this;
+    flush_destroyed(): void;
+    add_component(entity_id: EntityID, def: ComponentDef<readonly []>): this;
+    add_component<F extends ComponentFields>(entity_id: EntityID, def: ComponentDef<F>, values: FieldValues<F>): this;
+    remove_component(entity_id: EntityID, def: ComponentDef<ComponentFields>): this;
+    /** Flush all deferred changes: structural (add/remove) first, then destructions. */
+    flush(): void;
+    emit(def: EventDef<readonly []>): void;
+    emit<F extends ComponentFields>(def: EventDef<F>, values: FieldValues<F>): void;
+    read<F extends ComponentFields>(def: EventDef<F>): EventReader<F>;
+}
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

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

package/dist/schedule.d.ts

@@ -0,0 +1,40 @@
+import { SystemContext } from './query';
+import { SystemDescriptor } from './system';
+export declare enum SCHEDULE {
+    PRE_STARTUP = "PRE_STARTUP",
+    STARTUP = "STARTUP",
+    POST_STARTUP = "POST_STARTUP",
+    PRE_UPDATE = "PRE_UPDATE",
+    UPDATE = "UPDATE",
+    POST_UPDATE = "POST_UPDATE"
+}
+export interface SystemOrdering {
+    before?: SystemDescriptor[];
+    after?: SystemDescriptor[];
+}
+export interface SystemEntry {
+    system: SystemDescriptor;
+    ordering?: SystemOrdering;
+}
+export declare class Schedule {
+    private label_systems;
+    private sorted_cache;
+    private system_index;
+    private next_insertion_order;
+    constructor();
+    add_systems(label: SCHEDULE, ...entries: (SystemDescriptor | SystemEntry)[]): void;
+    remove_system(system: SystemDescriptor): void;
+    run_startup(ctx: SystemContext): void;
+    run_update(ctx: SystemContext, delta_time: number): void;
+    get_all_systems(): SystemDescriptor[];
+    has_system(system: SystemDescriptor): boolean;
+    clear(): void;
+    private run_label;
+    private get_sorted;
+    /**
+     * Kahn's algorithm: BFS-based topological sort.
+     * Uses insertion_order as a stable tiebreaker (lower insertion order runs first).
+     */
+    private topological_sort;
+}
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;KAwBK;AAEL,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,oBAAY,QAAQ;IAClB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AAcD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AASD,qBAAa,QAAQ;IACnB,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,oBAAoB,CAAK;;IAWjC,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,GAAG,OAAO,EAAE,CAAC,gBAAgB,GAAG,WAAW,CAAC,EAAE,GAC7C,IAAI;IA2BP,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAyB7C,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAMrC,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAMxD,eAAe,IAAI,gBAAgB,EAAE;IAUrC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAI7C,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAsEzB"}

package/dist/store.d.ts

@@ -0,0 +1,92 @@
+import { EntityID } from './entity';
+import { ComponentDef, ComponentFields, FieldValues } from './component';
+import { EventDef, EventReader } from './event';
+import { BitSet } from './type_primitives';
+import { Archetype } from './archetype';
+export declare class Store {
+    private entity_generations;
+    private entity_high_water;
+    private entity_free_indices;
+    private entity_alive_count;
+    private component_metas;
+    private component_count;
+    private event_channels;
+    private event_count;
+    private archetypes;
+    private archetype_map;
+    private next_archetype_id;
+    private component_index;
+    private registered_queries;
+    private empty_archetype_id;
+    private entity_archetype;
+    private entity_row;
+    private pending_destroy;
+    private pending_add_ids;
+    private pending_add_defs;
+    private pending_add_values;
+    private pending_remove_ids;
+    private pending_remove_defs;
+    constructor();
+    private arch_get;
+    /**
+     * Find or create an archetype for the given component mask.
+     * Also updates the component_index and pushes into matching registered queries.
+     */
+    private arch_get_or_create_from_mask;
+    /** Resolve "add component_id to archetype_id" → target ArchetypeID. Caches the edge. */
+    private arch_resolve_add;
+    /** Resolve "remove component_id from archetype_id" → target ArchetypeID. Caches the edge. */
+    private arch_resolve_remove;
+    /** Cache a bidirectional add/remove edge between two archetypes. */
+    private arch_cache_edge;
+    create_entity(): EntityID;
+    /** Immediately destroy an entity, removing it from its archetype. */
+    destroy_entity(id: EntityID): void;
+    is_alive(id: EntityID): boolean;
+    get entity_count(): number;
+    destroy_entity_deferred(id: EntityID): void;
+    /** Flush all buffered entity destructions in batch. */
+    flush_destroyed(): void;
+    get pending_destroy_count(): number;
+    add_component_deferred(entity_id: EntityID, def: ComponentDef<readonly []>): void;
+    add_component_deferred<F extends ComponentFields>(entity_id: EntityID, def: ComponentDef<F>, values: FieldValues<F>): void;
+    remove_component_deferred(entity_id: EntityID, def: ComponentDef<ComponentFields>): void;
+    flush_structural(): void;
+    /** Batch-apply all deferred component additions. */
+    private _flush_adds;
+    /** Batch-apply all deferred component removals. */
+    private _flush_removes;
+    get pending_structural_count(): number;
+    register_component<F extends readonly string[]>(fields: F): ComponentDef<F>;
+    add_component(entity_id: EntityID, def: ComponentDef<readonly []>): void;
+    add_component<F extends ComponentFields>(entity_id: EntityID, def: ComponentDef<F>, values: FieldValues<F>): void;
+    /** Add multiple components in one transition (resolves final archetype, then moves once). */
+    add_components(entity_id: EntityID, entries: {
+        def: ComponentDef<ComponentFields>;
+        values?: Record<string, number>;
+    }[]): void;
+    remove_component(entity_id: EntityID, def: ComponentDef<ComponentFields>): void;
+    /** Remove multiple components in one transition (resolves final archetype, then moves once). */
+    remove_components(entity_id: EntityID, defs: ComponentDef<ComponentFields>[]): void;
+    has_component(entity_id: EntityID, def: ComponentDef<ComponentFields>): boolean;
+    get_entity_archetype(entity_id: EntityID): Archetype;
+    get_entity_row(entity_id: EntityID): number;
+    /**
+     * Find all archetypes matching the given masks.
+     * Uses the inverted component_index to start from the component with the
+     * fewest archetypes, minimizing the number of superset checks.
+     */
+    get_matching_archetypes(required: BitSet, excluded?: BitSet, any_of?: BitSet): readonly Archetype[];
+    /**
+     * Register a live query. Returns a mutable Archetype[] that this Store will
+     * push newly-created matching archetypes into, keeping the query always up-to-date.
+     */
+    register_query(include: BitSet, exclude?: BitSet, any_of?: BitSet): Archetype[];
+    get archetype_count(): number;
+    register_event<F extends readonly string[]>(fields: F): EventDef<F>;
+    emit_event<F extends ComponentFields>(def: EventDef<F>, values: Record<string, number>): void;
+    emit_signal(def: EventDef<readonly []>): void;
+    get_event_reader<F extends ComponentFields>(def: EventDef<F>): EventReader<F>;
+    clear_events(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/system.d.ts

@@ -0,0 +1,16 @@
+import { Brand } from './type_primitives';
+import { SystemContext } from './query';
+import { Store } from './store';
+export type SystemID = Brand<number, "system_id">;
+export declare const as_system_id: (value: number) => SystemID;
+export type SystemFn = (ctx: SystemContext, delta_time: number) => void;
+export interface SystemConfig {
+    fn: SystemFn;
+    on_added?: (store: Store) => void;
+    on_removed?: () => void;
+    dispose?: () => void;
+}
+export interface SystemDescriptor extends Readonly<SystemConfig> {
+    readonly id: SystemID;
+}
+//# sourceMappingURL=system.d.ts.map

package/dist/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;KAcK;AAEL,OAAO,EACL,KAAK,EAGN,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAElD,eAAO,MAAM,YAAY,UAAW,MAAM,aAKvC,CAAC;AAEJ,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,QAAQ,CAAC,YAAY,CAAC;IAC9D,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACvB"}

package/dist/type_primitives/assertions.d.ts

@@ -0,0 +1,14 @@
+/***
+ * Assertions — Dev-only runtime validation and branded casting.
+ *
+ * All checks are guarded by __DEV__ and tree-shaken in production builds.
+ * validate_and_cast is the primary tool for creating branded IDs:
+ * it validates the input in dev and returns the value as the branded type.
+ * unsafe_cast bypasses all checks (used when the caller guarantees validity).
+ *
+ ***/
+export declare const is_non_negative_integer: (v: number) => boolean;
+export declare function assert<T, Result extends T = T>(value: T, condition: (v: T) => v is Result, err_message: string): asserts value is Result;
+export declare function validate_and_cast<T, Result extends T = T>(value: T, validator: (v: T) => boolean, err_message: string): Result;
+export declare function unsafe_cast<T>(value: unknown): T;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/type_primitives/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/type_primitives/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;;;KAQK;AAIL,eAAO,MAAM,uBAAuB,MAAO,MAAM,KAAG,OACrB,CAAC;AAEhC,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,GAAG,CAAC,EAC5C,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,MAAM,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,IAAI,MAAM,CAOzB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,GAAG,CAAC,EACvD,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAEhD"}

package/dist/type_primitives/bitset/bitset.d.ts

@@ -0,0 +1,37 @@
+/***
+ * BitSet — number[]-backed bit set with auto-grow.
+ *
+ * Used as the archetype component signature. Each bit position corresponds
+ * to a ComponentID. Operations (has/set/clear) are O(1), and mask
+ * comparisons (contains, equals, overlaps) are O(words) where
+ * words = ceil(maxComponentId / 32).
+ *
+ * Bit layout within each 32-bit word:
+ *   word_index = bit >>> 5       (divide by 32)
+ *   bit_offset = bit & 31       (mod 32)
+ *   test:  word & (1 << offset)
+ *   set:   word |= (1 << offset)
+ *   clear: word &= ~(1 << offset)
+ *
+ ***/
+export declare class BitSet {
+    _words: number[];
+    constructor(words?: number[]);
+    has(bit: number): boolean;
+    set(bit: number): void;
+    clear(bit: number): void;
+    /** True if any bit is set in both this and other (non-empty intersection). */
+    overlaps(other: BitSet): boolean;
+    /** True if this is a superset of other (all bits in other are set in this). */
+    contains(other: BitSet): boolean;
+    equals(other: BitSet): boolean;
+    copy(): BitSet;
+    copy_with_set(bit: number): BitSet;
+    copy_with_clear(bit: number): BitSet;
+    /** FNV-1a hash. Skips trailing zero words so differently-sized arrays with the same bits hash equally. */
+    hash(): number;
+    /** Iterate all set bits via lowest-set-bit extraction. */
+    for_each(fn: (bit: number) => void): void;
+    private grow;
+}
+//# sourceMappingURL=bitset.d.ts.map

package/dist/type_primitives/bitset/bitset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitset.d.ts","sourceRoot":"","sources":["../../../src/type_primitives/bitset/bitset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;KAeK;AAIL,qBAAa,MAAM;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;gBAEL,KAAK,CAAC,EAAE,MAAM,EAAE;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMxB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAUhC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAehC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAa9B,IAAI,IAAI,MAAM;IAId,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUlC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IASpC,0GAA0G;IAC1G,IAAI,IAAI,MAAM;IAad,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAmBzC,OAAO,CAAC,IAAI;CAOb"}

package/dist/type_primitives/brand.d.ts

@@ -0,0 +1,18 @@
+/***
+ * Brand — Nominal typing for TypeScript.
+ *
+ * Brand<T, Name> intersects T with a phantom readonly symbol property
+ * tagged with Name. The symbol never exists at runtime — it only prevents
+ * accidental assignment between structurally identical types.
+ *
+ * Example: EntityID and ComponentID are both numbers at runtime, but
+ * Brand<number, "entity_id"> and Brand<number, "component_id"> are
+ * incompatible at compile time.
+ *
+ ***/
+declare const brand: unique symbol;
+export type Brand<T, BrandName extends string> = T & {
+    readonly [brand]: BrandName;
+};
+export {};
+//# sourceMappingURL=brand.d.ts.map

package/dist/type_primitives/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/type_primitives/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;KAWK;AAEL,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAC;AAEnC,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,IAAI,CAAC,GAAG;IACnD,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC"}

package/dist/type_primitives/error.d.ts

@@ -0,0 +1,10 @@
+import { AppError } from '../utils/error';
+export declare enum TYPE_ERROR {
+    ASSERTION_FAIL_CONDITION = "ASSERTION_FAIL_CONDITION",
+    VALIDATION_FAIL_CONDITION = "VALIDATION_FAIL_CONDITION"
+}
+export declare class TypeError extends AppError {
+    readonly category: TYPE_ERROR;
+    constructor(category: TYPE_ERROR, message: string, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/type_primitives/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/type_primitives/error.ts"],"names":[],"mappings":"AAAA;;;;;;KAMK;AAEL,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,oBAAY,UAAU;IACpB,wBAAwB,6BAA6B;IACrD,yBAAyB,8BAA8B;CACxD;AAED,qBAAa,SAAU,SAAQ,QAAQ;aAEnB,QAAQ,EAAE,UAAU;gBAApB,QAAQ,EAAE,UAAU,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIpC"}

package/dist/type_primitives/index.d.ts

@@ -0,0 +1,8 @@
+export * from './assertions';
+export * from './brand';
+export * from './error';
+export * from './bitset/bitset';
+export * from './sparse_set/sparse_set';
+export * from './sparse_map/sparse_map';
+export * from './typed_arrays/typed_arrays';
+//# sourceMappingURL=index.d.ts.map

package/dist/type_primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/type_primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/type_primitives/sparse_map/sparse_map.d.ts

@@ -0,0 +1,26 @@
+/***
+ * SparseMap — O(1) integer-keyed map with cache-friendly dense iteration.
+ *
+ * Keys are non-negative integers. Two parallel dense arrays (keys + values)
+ * enable linear iteration. A sparse number[] maps key → dense index for
+ * O(1) get/set/delete.
+ *
+ * Membership is verified by cross-referencing dense_keys[sparse[key]] === key,
+ * so stale sparse entries are harmless. Deletion uses swap-and-pop.
+ *
+ ***/
+export declare class SparseMap<V> {
+    private _dense_keys;
+    private _dense_vals;
+    private _sparse;
+    get size(): number;
+    get keys(): readonly number[];
+    has(key: number): boolean;
+    get(key: number): V | undefined;
+    set(key: number, value: V): void;
+    delete(key: number): boolean;
+    clear(): void;
+    for_each(fn: (key: number, value: V) => void): void;
+    [Symbol.iterator](): Iterator<[number, V]>;
+}
+//# sourceMappingURL=sparse_map.d.ts.map

package/dist/type_primitives/sparse_map/sparse_map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse_map.d.ts","sourceRoot":"","sources":["../../../src/type_primitives/sparse_map/sparse_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;KAUK;AAEL,qBAAa,SAAS,CAAC,CAAC;IACtB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,OAAO,CAAgB;IAE/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAUhC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAa5B,KAAK,IAAI,IAAI;IAMb,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAMnD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAa3C"}

package/dist/type_primitives/sparse_set/sparse_set.d.ts

@@ -0,0 +1,24 @@
+/***
+ * SparseSet — O(1) integer-key set with cache-friendly dense iteration.
+ *
+ * Keys are non-negative integers. A dense number[] holds members packed
+ * at 0..size-1 for linear iteration. A sparse number[] maps
+ * key → dense index for O(1) has/add/delete.
+ *
+ * Membership is verified by cross-referencing dense[sparse[key]] === key,
+ * so stale sparse entries are harmless (no clearing needed on delete).
+ * Deletion uses swap-and-pop to keep data contiguous.
+ *
+ ***/
+export declare class SparseSet {
+    private _dense;
+    private _sparse;
+    get size(): number;
+    get values(): readonly number[];
+    has(key: number): boolean;
+    add(key: number): void;
+    delete(key: number): boolean;
+    clear(): void;
+    [Symbol.iterator](): Iterator<number>;
+}
+//# sourceMappingURL=sparse_set.d.ts.map

package/dist/type_primitives/sparse_set/sparse_set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse_set.d.ts","sourceRoot":"","sources":["../../../src/type_primitives/sparse_set/sparse_set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;KAWK;AAEL,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAgB;IAE/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,SAAS,MAAM,EAAE,CAE9B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B,KAAK,IAAI,IAAI;IAKb,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC;CAGtC"}

package/dist/type_primitives/typed_arrays/typed_arrays.d.ts

@@ -0,0 +1,79 @@
+/***
+ * GrowableTypedArray — TypedArray wrapper with amortised O(1) append.
+ *
+ * TypedArrays have fixed length — resizing requires allocating a new
+ * buffer and copying. GrowableTypedArray wraps one with a separate
+ * logical length and doubles the backing buffer on overflow.
+ *
+ * Named subclasses (GrowableFloat32Array etc.) are provided for each
+ * numeric type. TypedArrayFor maps TypeTag strings to their class so
+ * component columns can be allocated by tag.
+ *
+ ***/
+export type TypedArrayTag = "f32" | "f64" | "i8" | "i16" | "i32" | "u8" | "u16" | "u32";
+export type AnyTypedArray = Float32Array | Float64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint16Array | Uint32Array;
+export declare class GrowableTypedArray<T extends AnyTypedArray> {
+    private readonly _ctor;
+    private _buf;
+    private _len;
+    constructor(_ctor: new (n: number) => T, initial_capacity?: number);
+    get length(): number;
+    push(value: number): void;
+    pop(): number;
+    get(i: number): number;
+    set_at(i: number, value: number): void;
+    /**
+     * Move the last element into slot i, decrement length.
+     * Returns the value that was removed from slot i.
+     */
+    swap_remove(i: number): number;
+    clear(): void;
+    /**
+     * Raw backing buffer. Valid data: indices 0..length-1.
+     * This reference is stable until the next push() that triggers a grow —
+     * do not cache across entity additions.
+     */
+    get buf(): T;
+    /**
+     * Zero-copy subarray view of valid data (0..length-1).
+     * Shares the backing buffer — invalidated if a subsequent push() grows.
+     */
+    view(): T;
+    [Symbol.iterator](): Iterator<number>;
+    private _grow;
+}
+export declare class GrowableFloat32Array extends GrowableTypedArray<Float32Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableFloat64Array extends GrowableTypedArray<Float64Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableInt8Array extends GrowableTypedArray<Int8Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableInt16Array extends GrowableTypedArray<Int16Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableInt32Array extends GrowableTypedArray<Int32Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableUint8Array extends GrowableTypedArray<Uint8Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableUint16Array extends GrowableTypedArray<Uint16Array> {
+    constructor(initial_capacity?: number);
+}
+export declare class GrowableUint32Array extends GrowableTypedArray<Uint32Array> {
+    constructor(initial_capacity?: number);
+}
+export declare const TypedArrayFor: {
+    readonly f32: typeof GrowableFloat32Array;
+    readonly f64: typeof GrowableFloat64Array;
+    readonly i8: typeof GrowableInt8Array;
+    readonly i16: typeof GrowableInt16Array;
+    readonly i32: typeof GrowableInt32Array;
+    readonly u8: typeof GrowableUint8Array;
+    readonly u16: typeof GrowableUint16Array;
+    readonly u32: typeof GrowableUint32Array;
+};
+//# sourceMappingURL=typed_arrays.d.ts.map

package/dist/type_primitives/typed_arrays/typed_arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed_arrays.d.ts","sourceRoot":"","sources":["../../../src/type_primitives/typed_arrays/typed_arrays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;KAWK;AAEL,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GACX,WAAW,CAAC;AAEhB,qBAAa,kBAAkB,CAAC,CAAC,SAAS,aAAa;IAKnD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,IAAI,CAAK;gBAGE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,EAC5C,gBAAgB,SAAK;IAKvB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB,GAAG,IAAI,MAAM;IAIb,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAItB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAM9B,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,GAAG,IAAI,CAAC,CAEX;IAED;;;OAGG;IACH,IAAI,IAAI,CAAC;IAIT,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC;IAYrC,OAAO,CAAC,KAAK;CAKd;AAED,qBAAa,oBAAqB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;gBAC5D,gBAAgB,SAAK;CAGlC;AAED,qBAAa,oBAAqB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;gBAC5D,gBAAgB,SAAK;CAGlC;AAED,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,SAAS,CAAC;gBACtD,gBAAgB,SAAK;CAGlC;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB,CAAC,UAAU,CAAC;gBACxD,gBAAgB,SAAK;CAGlC;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB,CAAC,UAAU,CAAC;gBACxD,gBAAgB,SAAK;CAGlC;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB,CAAC,UAAU,CAAC;gBACxD,gBAAgB,SAAK;CAGlC;AAED,qBAAa,mBAAoB,SAAQ,kBAAkB,CAAC,WAAW,CAAC;gBAC1D,gBAAgB,SAAK;CAGlC;AAED,qBAAa,mBAAoB,SAAQ,kBAAkB,CAAC,WAAW,CAAC;gBAC1D,gBAAgB,SAAK;CAGlC;AAED,eAAO,MAAM,aAAa;;;;;;;;;CAYzB,CAAC"}

package/dist/utils/arrays.d.ts

@@ -0,0 +1,6 @@
+/***
+ * Array utilities — helpers for hash-bucketed maps.
+ ***/
+/** Push a value into a hash-bucket map, creating the bucket array if absent. */
+export declare function bucket_push<T>(map: Map<number, T[]>, key: number, value: T): void;
+//# sourceMappingURL=arrays.d.ts.map

package/dist/utils/arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA;;KAEK;AAEL,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,IAAI,CAON"}

package/dist/utils/error.d.ts

@@ -0,0 +1,28 @@
+/***
+ * Error — Base error types and ECS error categories.
+ *
+ * AppError is the base class for all application errors, carrying an
+ * is_operational flag (recoverable vs programmer error) and optional context.
+ * ECSError extends it with an ECS_ERROR category enum for structured matching.
+ *
+ ***/
+export declare abstract class AppError extends Error {
+    readonly is_operational: boolean;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, is_operational: boolean, context?: Record<string, unknown> | undefined);
+}
+export declare enum ECS_ERROR {
+    EID_MAX_INDEX_OVERFLOW = "EID_MAX_INDEX_OVERFLOW",
+    EID_MAX_GEN_OVERFLOW = "EID_MAX_GEN_OVERFLOW",
+    COMPONENT_NOT_REGISTERED = "COMPONENT_NOT_REGISTERED",
+    ENTITY_NOT_ALIVE = "ENTITY_NOT_ALIVE",
+    CIRCULAR_SYSTEM_DEPENDENCY = "CIRCULAR_SYSTEM_DEPENDENCY",
+    DUPLICATE_SYSTEM = "DUPLICATE_SYSTEM",
+    ARCHETYPE_NOT_FOUND = "ARCHETYPE_NOT_FOUND"
+}
+export declare class ECSError extends AppError {
+    readonly category: ECS_ERROR;
+    constructor(category: ECS_ERROR, message?: string, context?: Record<string, unknown>);
+}
+export declare function is_ecs_error(error: unknown): error is ECSError;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;;;KAOK;AAEL,8BAAsB,QAAS,SAAQ,KAAK;aAGxB,cAAc,EAAE,OAAO;aACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAMpD;AAED,oBAAY,SAAS;IACnB,sBAAsB,2BAA2B;IACjD,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,gBAAgB,qBAAqB;IACrC,0BAA0B,+BAA+B;IACzD,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;CAC5C;AAED,qBAAa,QAAS,SAAQ,QAAQ;aAElB,QAAQ,EAAE,SAAS;gBAAnB,QAAQ,EAAE,SAAS,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIpC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE9D"}

package/dist/world.d.ts

@@ -0,0 +1,63 @@
+import { SCHEDULE, SystemEntry } from './schedule';
+import { SystemContext, Query, QueryBuilder, QueryResolver } from './query';
+import { EntityID } from './entity';
+import { ComponentDef, ComponentFields, FieldValues } from './component';
+import { EventDef } from './event';
+import { SystemConfig, SystemDescriptor } from './system';
+import { BitSet } from './type_primitives';
+export declare class World implements QueryResolver {
+    private readonly store;
+    private readonly schedule;
+    private readonly ctx;
+    private systems;
+    private next_system_id;
+    private query_cache;
+    private scratch_mask;
+    constructor();
+    register_component<F extends readonly string[]>(fields: F): ComponentDef<F>;
+    register_tag(): ComponentDef<readonly []>;
+    register_event<F extends readonly string[]>(fields: F): EventDef<F>;
+    register_signal(): EventDef<readonly []>;
+    create_entity(): EntityID;
+    destroy_entity(id: EntityID): void;
+    is_alive(id: EntityID): boolean;
+    get entity_count(): number;
+    add_component(entity_id: EntityID, def: ComponentDef<readonly []>): void;
+    add_component<F extends ComponentFields>(entity_id: EntityID, def: ComponentDef<F>, values: FieldValues<F>): void;
+    add_components(entity_id: EntityID, entries: {
+        def: ComponentDef<ComponentFields>;
+        values?: Record<string, number>;
+    }[]): void;
+    remove_component(entity_id: EntityID, def: ComponentDef<ComponentFields>): this;
+    remove_components(entity_id: EntityID, ...defs: ComponentDef<ComponentFields>[]): void;
+    has_component(entity_id: EntityID, def: ComponentDef<ComponentFields>): boolean;
+    get_field<F extends ComponentFields>(def: ComponentDef<F>, entity_id: EntityID, field: F[number]): number;
+    emit(def: EventDef<readonly []>): void;
+    emit<F extends ComponentFields>(def: EventDef<F>, values: FieldValues<F>): void;
+    query<T extends ComponentDef<ComponentFields>[]>(...defs: T): Query<T>;
+    /** QueryResolver implementation — creates or retrieves a cached Query. */
+    _resolve_query(include: BitSet, exclude: BitSet | null, any_of: BitSet | null, defs: readonly ComponentDef<ComponentFields>[]): Query<any>;
+    private _find_cached;
+    /**
+     * Register a system with a typed query.
+     *
+     *   world.register_system(
+     *     (q, ctx, dt) => q.each((pos, vel, n) => { ... }),
+     *     (qb) => qb.every(Pos, Vel),
+     *   );
+     *
+     * Or with a raw config for systems that don't need a query:
+     *
+     *   world.register_system({ fn(ctx, dt) { ... } });
+     */
+    register_system<Defs extends readonly ComponentDef<ComponentFields>[]>(fn: (q: Query<Defs>, ctx: SystemContext, dt: number) => void, query_fn: (qb: QueryBuilder) => Query<Defs>): SystemDescriptor;
+    register_system(config: SystemConfig): SystemDescriptor;
+    add_systems(label: SCHEDULE, ...entries: (SystemDescriptor | SystemEntry)[]): this;
+    remove_system(system: SystemDescriptor): void;
+    get system_count(): number;
+    startup(): void;
+    update(delta_time: number): void;
+    flush(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

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