@vworlds/vecs 1.0.15 → 1.0.16

package/dist/world/world.pools.js.map

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

package/dist/world/world.queries.d.ts

@@ -0,0 +1,18 @@
+import { type ComponentType } from "../component.js";
+import { type ExtractRequired, type QueryDSL } from "../dsl.js";
+import { Filter } from "../filter.js";
+import { Query } from "../query/index.js";
+import { Term } from "../terms/index.js";
+import { Storage } from "./world.storage.js";
+import type { World } from "./world.js";
+export declare class Queries extends Storage {
+    /** Read-only view of every registered query (includes systems). */
+    get queries(): ReadonlyArray<Query>;
+    /** Create a non-reactive {@link Filter} that matches entities satisfying `q`. */
+    filter<Q extends QueryDSL>(this: World, q: Q): Filter<ExtractRequired<Q>>;
+    filter<T extends ComponentType[]>(this: World, q: QueryDSL, _guaranteed: readonly [...T]): Filter<T>;
+    /** Create and return a standalone {@link Query}, ready for fluent configuration. */
+    query(this: World, name: string): Query;
+    /** Return the shared materialized term for a reactive query DSL expression. */
+    getTerm(this: World, q: QueryDSL): Term;
+}

package/dist/world/world.queries.js

@@ -0,0 +1,101 @@
+import { Filter } from "../filter.js";
+import { Query } from "../query/index.js";
+import { getCachedTerm, getTerm, notifyComponentAdded, notifyComponentChanged, notifyComponentRemoved, notifyEntityCreated, notifyEntityDestroyed, } from "../terms/build.js";
+import { Storage } from "./world.storage.js";
+export class Queries extends Storage {
+    constructor() {
+        super(...arguments);
+        /** @internal All registered queries, including systems (which extend `Query`). */
+        this._queries = [];
+        /** @internal Queries created but not yet built into the world. */
+        this._unbuiltQueries = new Set();
+        /** @internal Canonical DSL key -> live term. */
+        this._termCache = new Map();
+        /** @internal Component eid -> pinned component leaf term. */
+        this._componentTerms = new Map();
+        /** @internal True while the world is driving one logical frame. */
+        this._frameInProgress = false;
+        /** @internal True while the world is auto-building pending queries. */
+        this._buildingPendingQueries = false;
+    }
+    /** Read-only view of every registered query (includes systems). */
+    get queries() {
+        return this._queries;
+    }
+    /** @internal Register and index a freshly built {@link Query}. */
+    _addQuery(q) {
+        if (this._frameInProgress && !this._buildingPendingQueries) {
+            throw new Error("queries cannot be built while a frame is in progress");
+        }
+        this._removeUnbuiltQuery(q);
+        this._queries.push(q);
+    }
+    /** @internal Track a newly-created query until it is explicitly or automatically built. */
+    _addUnbuiltQuery(q) {
+        this._unbuiltQueries.add(q);
+    }
+    /** @internal Unregister a query and purge its membership from every entity. */
+    _removeQuery(q) {
+        this._removeUnbuiltQuery(q);
+        const idx = this._queries.indexOf(q);
+        if (idx !== -1) {
+            this._queries.splice(idx, 1);
+        }
+        q._unsubscribeRootTerm();
+        this._entities.forEach((e) => e._purgeQuery(q));
+    }
+    /** @internal Stop tracking a pending query. */
+    _removeUnbuiltQuery(q) {
+        this._unbuiltQueries.delete(q);
+    }
+    filter(q, _guaranteed) {
+        return new Filter(this, q);
+    }
+    /** Create and return a standalone {@link Query}, ready for fluent configuration. */
+    query(name) {
+        return new Query(name, this);
+    }
+    /** Return the shared materialized term for a reactive query DSL expression. */
+    getTerm(q) {
+        return getTerm(this, q);
+    }
+    /** @internal Return a cached term without creating one. */
+    _getCachedTerm(q) {
+        return getCachedTerm(this, q);
+    }
+    /** @internal Drive the component leaf for a newly attached component. */
+    _notifyComponentAdded(eid, entity) {
+        notifyComponentAdded(this, eid, entity);
+    }
+    /** @internal Drive predicate/target refresh for changed component data. */
+    _notifyComponentChanged(eid, entity) {
+        notifyComponentChanged(this, eid, entity);
+    }
+    /** @internal Drive the component leaf for a detached component. */
+    _notifyComponentRemoved(eid, entity) {
+        notifyComponentRemoved(this, eid, entity);
+    }
+    /** @internal Drive the world leaf for a created entity. */
+    _notifyEntityCreated(entity) {
+        notifyEntityCreated(this, entity);
+    }
+    /** @internal Drive the world/component leaves for a destroyed entity. */
+    _notifyEntityDestroyed(entity) {
+        notifyEntityDestroyed(this, entity);
+    }
+    /** @internal Build every query that has not yet entered the world. */
+    _buildPendingQueries() {
+        if (this._unbuiltQueries.size === 0) {
+            return;
+        }
+        const pending = [...this._unbuiltQueries];
+        this._buildingPendingQueries = true;
+        try {
+            pending.forEach((q) => q._build());
+        }
+        finally {
+            this._buildingPendingQueries = false;
+        }
+    }
+}
+//# sourceMappingURL=world.queries.js.map

package/dist/world/world.queries.js.map

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

package/dist/world/world.storage.d.ts

@@ -0,0 +1,7 @@
+import type { Entity } from "../entity/index.js";
+import { type ReadonlyArrayMap } from "../util/array_map.js";
+import { Pools } from "./world.pools.js";
+export declare class Storage extends Pools {
+    /** Read-only view of the live entities, keyed by entity id. */
+    get entities(): ReadonlyArrayMap<Entity>;
+}

package/dist/world/world.storage.js

@@ -0,0 +1,26 @@
+import { ArrayMap } from "../util/array_map.js";
+import { Pools } from "./world.pools.js";
+export class Storage extends Pools {
+    constructor() {
+        super(...arguments);
+        /**
+         * @internal Entity id -> entity. Owns every live entity.
+         *
+         * Backed by an {@link ArrayMap} rather than a `Map`: entity ids are dense
+         * pooled integers, so array indexing beats hashing on the lookups that run
+         * per component during teardown (`world.entity(componentEid)` in
+         * `Entity._destroy`) and on every `world.entity(eid)` resolution.
+         */
+        this._entities = new ArrayMap();
+    }
+    /** Read-only view of the live entities, keyed by entity id. */
+    get entities() {
+        return this._entities;
+    }
+    /** @internal Remove an entity from the world's entity map (called by `Entity._destroy`). */
+    _unregisterEntity(entity) {
+        this._entities.delete(entity.eid);
+        this._poolFor(entity.eid).free(entity.eid);
+    }
+}
+//# sourceMappingURL=world.storage.js.map

package/dist/world/world.storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.storage.js","sourceRoot":"","sources":["../../src/world/world.storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAyB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAAlC;;QACE;;;;;;;WAOG;QACO,cAAS,GAAG,IAAI,QAAQ,EAAU,CAAC;IAY/C,CAAC;IAVC,+DAA+D;IAC/D,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,4FAA4F;IACrF,iBAAiB,CAAC,MAAc;QACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/package.json

@@ -1,14 +1,25 @@
 {
   "name": "@vworlds/vecs",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "development": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts"
+      },
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "scripts": {
     "clean": "rimraf dist",
     "prepack": "npm run build",
     "build": "npm run clean && npm run compile",
     "compile": "tsc -p tsconfig.build.json && cp \"./package.json\" ./dist/",
+    "bench:ecs": "NODE_OPTIONS=--max-old-space-size=32768 RUN_VECS_ECS_BENCH=1 vitest run tests/ecs.bench.test.ts --pool=forks --poolOptions.forks.singleFork",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" --no-error-on-unmatched-pattern",

package/dist/entity.d.ts

@@ -1,215 +0,0 @@
-import { type Component, type ComponentClass, type ComponentClassOrType } from "./component.js";
-import type { World } from "./world.js";
-import { ReadonlyArrayMap } from "./util/array_map.js";
-import { Events } from "./util/events.js";
-import { Bitset } from "./util/bitset.js";
-type EntityEvents = Events<{
-    destroy(): void;
-}>;
-/**
- * A game object: a unique numeric id with an arbitrary set of
- * {@link Component | components} attached.
- *
- * Never instantiate `Entity` directly. Use {@link World.entity} for an
- * auto-assigned id, or {@link World.getOrCreateEntity} when the id comes from
- * an external authority such as a game server:
- *
- * ```ts
- * const e = world.entity();
- * e.set(Position, { x: 100 });
- * ```
- *
- * Entities support a parent-child hierarchy. `parent` and `children` form a
- * bidirectional link maintained by {@link setParent}; the children set is
- * created lazily. Destroying a parent recursively destroys its children.
- *
- * ## Deferred semantics
- *
- * Inside a system body or `forEach` iteration the world is in **deferred
- * mode**: `add` / `attach` / `set` / `modified` / `remove` / `destroy` /
- * `setParent` only enqueue commands. The data layer (the components map and
- * `componentBitmask`) is mutated when the world drains its queue. Concretely,
- * while deferred:
- *
- * - `entity.get(C)` returns `undefined` after `entity.add(C)` (no instance yet).
- * - `entity.get(C)` returns `undefined` after `entity.attach(instance)` if C was absent.
- * - `entity.get(C)` returns the previous value after `entity.set(C, props)`.
- * - `entity.get(C)` still returns the component after `entity.remove(C)`.
- *
- * Outside deferred mode the same calls execute inline and mutations are
- * visible immediately.
- */
-export declare class Entity {
-    /** World that owns this entity. */
-    readonly world: World;
-    /** Unique numeric entity id assigned at creation. */
-    readonly eid: number;
-    /**
-     * Bitmask of component type ids currently attached to this entity. Used by
-     * the world for fast archetype matching against query predicates.
-     */
-    readonly componentBitmask: Bitset;
-    /**
-     * Free-form property bag. Modules can use it to associate arbitrary data with
-     * an entity without registering a dedicated component.
-     */
-    properties: Map<string, any>;
-    constructor(
-    /** World that owns this entity. */
-    world: World, 
-    /** Unique numeric entity id assigned at creation. */
-    eid: number);
-    /** Fire every `onAdd` hook registered for `meta`. */
-    private _runOnAddHandlers;
-    /** Fire every `onSet` hook registered for `meta`. */
-    private _runOnSetHandlers;
-    /**
-     * Re-evaluate every world query for this entity, firing `_enter` / `_exit`
-     * routing whenever membership flipped.
-     */
-    private _updateQueries;
-    /** Store a component instance and perform the shared add-side bookkeeping. */
-    private _storeComponent;
-    /** Perform the shared set-side hook and query update routing. */
-    private _notifyComponentSet;
-    /**
-     * Construct a fresh component of `type`, apply `props`, store it on this
-     * entity, fire the `onAdd` hook, and route query updates.
-     *
-     * If the component type belongs to an exclusivity group, any conflicting
-     * component already on this entity is removed first.
-     */
-    private _new;
-    /**
-     * Read-only view of direct child entities. The backing set is created lazily
-     * on the first child link; before that this getter returns a shared empty set.
-     */
-    get children(): ReadonlySet<Entity>;
-    /**
-     * Read-only view of all components currently attached to this entity, keyed
-     * by numeric component type id.
-     *
-     * The mutating methods (`set`, `delete`, `clear`) are not exposed. Use
-     * `entity.add`, `entity.attach`, `entity.set`, and `entity.remove` to change
-     * the component set.
-     *
-     * ```ts
-     * entity.components.forEach((c) => console.log(c.constructor.name));
-     * ```
-     */
-    get components(): ReadonlyArrayMap<Component>;
-    /** `true` when no components are currently attached to this entity. */
-    get empty(): boolean;
-    /**
-     * Typed event emitter for entity-level lifecycle events. Currently only the
-     * `"destroy"` event is emitted, just before the entity is fully torn down.
-     *
-     * The emitter is created lazily on first access.
-     */
-    get events(): EntityEvents;
-    /** Parent entity in the scene hierarchy, or `undefined` for a root entity. */
-    get parent(): Entity | undefined;
-    /**
-     * Attach a component to this entity if it is not already present.
-     *
-     * Idempotent. Does not fire `onSet` -- use {@link set} when you want to apply
-     * data and notify watchers.
-     *
-     * @param Class - Component class to instantiate.
-     * @returns This entity, for chaining.
-     */
-    add<C extends ComponentClass>(Class: C): Entity;
-    /**
-     * Attach a component by numeric type id.
-     *
-     * @param type - Numeric component type id.
-     * @returns This entity, for chaining.
-     */
-    add(type: number): Entity;
-    /**
-     * Attach an existing component instance to this entity and store that exact
-     * object. If a component of the same registered class already exists, it is
-     * replaced rather than assigned into.
-     *
-     * `attach` uses the instance constructor to resolve component metadata, so
-     * the constructor must already be registered in this world. The operation
-     * fires hooks and query updates like a `set` operation.
-     *
-     * @param component - Existing component instance to store on the entity.
-     * @returns This entity, for chaining.
-     */
-    attach(component: Component): Entity;
-    /**
-     * Destroy this entity and recursively destroy its children.
-     *
-     * Each component fires its `onRemove` hook, the `"destroy"` event is emitted
-     * just before teardown, and the entity is unregistered from the world.
-     * After destruction the entity must not be used.
-     */
-    destroy(): void;
-    /**
-     * Look up a component on this entity.
-     *
-     * @param typeOrClass - Component class or numeric type id.
-     * @returns The component instance, or `undefined` when it is not attached.
-     */
-    get<C extends ComponentClass>(typeOrClass: number | C): InstanceType<C> | undefined;
-    /**
-     * Mark a component type as having changed, queueing the corresponding `onSet` / `update`
-     * notifications.
-     *
-     * Repeated calls before the world routes the modified command are coalesced via
-     * the entity's dirty component bitset.
-     *
-     * @param typeOrClass - Component class or numeric type id whose data changed.
-     * @returns This entity, for chaining.
-     */
-    modified(typeOrClass: ComponentClassOrType): Entity;
-    /**
-     * Detach a component from this entity.
-     *
-     * In deferred mode the removal is queued; `get(C)` continues to return the
-     * component until the queue drains. When applied, queries fire `exit`
-     * callbacks first and the `onRemove` hook fires last.
-     *
-     * @param Class - Component class to detach.
-     */
-    remove<C extends ComponentClass>(Class: C): void;
-    /**
-     * Detach a component by numeric type id.
-     *
-     * @param type - Numeric component type id.
-     */
-    remove(type: number): void;
-    /**
-     * Reparent this entity. In deferred mode the change is queued; outside
-     * deferred mode it executes inline.
-     *
-     * @param newParent - New parent, or `undefined` to make this a root entity.
-     */
-    setParent(newParent: Entity | undefined): void;
-    /**
-     * Attach a component (creating it if necessary), copy `props` onto the
-     * instance, and fire the `onSet` hook plus any `update` callbacks for the
-     * component type.
-     *
-     * In deferred mode `props` are not applied until the queued `Set` command is
-     * routed.
-     *
-     * @param Class - Component class to instantiate.
-     * @param props - Properties to assign onto the component instance.
-     * @returns This entity, for chaining.
-     */
-    set<C extends ComponentClass>(Class: C, props: Partial<InstanceType<C>>): Entity;
-    /**
-     * Attach a component by numeric type id and copy `props` onto it.
-     *
-     * @param type - Numeric component type id.
-     * @param props - Properties to assign onto the component instance.
-     * @returns This entity, for chaining.
-     */
-    set(type: number, props: Partial<Component>): Entity;
-    /** Returns `"EntityN"` where N is the entity id. */
-    toString(): string;
-}
-export {};