@vworlds/vecs 1.0.0

package/dist/component.js

@@ -0,0 +1,101 @@
+import { BitPtr, Bitset } from "./util/bitset.js";
+/**
+ * Internal bookkeeping record for a registered component class.
+ *
+ * Every component class that is passed to {@link World.registerComponent} gets
+ * a `ComponentMeta` that maps it to a numeric type id, a string name, and a
+ * pre-computed {@link BitPtr} used for fast archetype checks.
+ *
+ * `ComponentMeta` also implements {@link Hook}, so you can attach lifecycle
+ * callbacks directly on the meta object (as `World.hook()` returns it).
+ */
+export class ComponentMeta {
+    constructor(Class, type, componentName) {
+        this.Class = Class;
+        this.type = type;
+        this.componentName = componentName;
+        this.bitPtr = new BitPtr(type);
+    }
+    /** @inheritdoc */
+    onAdd(handler) {
+        this.onAddHandler = handler;
+        return this;
+    }
+    /** @inheritdoc */
+    onRemove(handler) {
+        this.onRemoveHandler = handler;
+        return this;
+    }
+    /** @inheritdoc */
+    onSet(handler) {
+        this.onSetHandler = handler;
+        return this;
+    }
+}
+/**
+ * Base class for all ECS components.
+ *
+ * Extend this class to define data that can be attached to an {@link Entity}:
+ *
+ * ```ts
+ * class Position extends Component {
+ *   x = 0;
+ *   y = 0;
+ * }
+ *
+ * world.registerComponent(Position);
+ * const pos = entity.add(Position);
+ * pos.x = 100;
+ * pos.modified(); // notify watching systems
+ * ```
+ *
+ * A component instance is always bound to a single entity and is created by
+ * the world when {@link Entity.add} is called.
+ */
+export class Component {
+    constructor(
+    /** The entity this component belongs to. */
+    entity, 
+    /** Registration metadata (type id, name, bit-pointer). */
+    meta) {
+        this.entity = entity;
+        this.meta = meta;
+        this.dirty = false;
+    }
+    /** Numeric type id — shorthand for `this.meta.type`. */
+    get type() {
+        return this.meta.type;
+    }
+    /** Pre-computed bit-pointer — shorthand for `this.meta.bitPtr`. */
+    get bitPtr() {
+        return this.meta.bitPtr;
+    }
+    /**
+     * Notify the world that this component's data has changed.
+     *
+     * Queues the component for delivery to all {@link System.update} callbacks
+     * that watch this component type. Call this after mutating the component's
+     * fields to ensure systems react to the new values.
+     */
+    modified() {
+        this.entity.world._queueUpdatedComponent(this);
+    }
+    /** Returns the component's registered name, e.g. `"Position"`. */
+    toString() {
+        return this.meta.componentName;
+    }
+}
+/**
+ * Compute a {@link Bitset} that has a bit set for every component class or
+ * type id in `classes`.
+ *
+ * @internal Used internally to build archetype masks for system queries.
+ */
+export function calculateComponentBitmask(classes, world) {
+    const bitmask = new Bitset();
+    classes.forEach((C) => {
+        bitmask.add(world.getComponentType(C));
+    });
+    return bitmask;
+}
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAoDlD;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAa;IAaxB,YAAY,KAAuB,EAAE,IAAY,EAAE,aAAqB;QACtE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,OAA+B;QAC1C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IACX,QAAQ,CAAC,OAA+B;QAC7C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,OAA+B;QAC1C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IAGpB;IACE,4CAA4C;IAC5B,MAAc;IAC9B,0DAA0D;IAC1C,IAAmB;QAFnB,WAAM,GAAN,MAAM,CAAQ;QAEd,SAAI,GAAJ,IAAI,CAAe;QAN7B,UAAK,GAAY,KAAK,CAAC;IAO5B,CAAC;IAEJ,wDAAwD;IACxD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,mEAAmE;IACnE,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACI,QAAQ;QACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,kEAAkE;IAC3D,QAAQ;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;IACjC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA4B,EAC5B,KAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/entity.d.ts

@@ -0,0 +1,157 @@
+import { Component } from "./component.js";
+import type { World } from "./world.js";
+import { type System } from "./system.js";
+import { Events } from "./util/events.js";
+import { Bitset } from "./util/bitset.js";
+type EntityEvents = Events<{
+    destroy(): void;
+}>;
+/**
+ * A game object — a unique identifier with an arbitrary set of
+ * {@link Component | components} attached to it.
+ *
+ * You never construct an `Entity` directly. Use {@link World.createEntity} for
+ * locally-owned entities or {@link World.getOrCreateEntity} when the id is
+ * assigned by an external authority (e.g. the server):
+ *
+ * ```ts
+ * const e = world.createEntity();
+ * const pos = e.add(Position);
+ * pos.x = 100;
+ * pos.modified();
+ * ```
+ *
+ * Entities support a parent–child hierarchy. When a parent is destroyed its
+ * children are destroyed recursively. The `children` set is created lazily.
+ */
+export declare class Entity {
+    /** The {@link World} that owns this entity. */
+    readonly world: World;
+    /** Unique numeric entity id assigned at creation time. */
+    readonly eid: number;
+    private components;
+    private deletedComponents;
+    /**
+     * Bitmask representing the set of component types currently attached to this
+     * entity. Used by the world to efficiently match entities against system
+     * queries.
+     */
+    readonly componentBitmask: Bitset;
+    private readonly systems;
+    private readonly newSystems;
+    /**
+     * A free-form property bag that modules can use to associate arbitrary data
+     * with an entity without registering a component.
+     */
+    properties: Map<string, any>;
+    _events: EntityEvents;
+    /** Parent entity in the scene hierarchy, or `undefined` if root. */
+    parent: Entity | undefined;
+    private _children;
+    _archetypeChanged: boolean;
+    private destroyed;
+    constructor(
+    /** The {@link World} that owns this entity. */
+    world: World, 
+    /** Unique numeric entity id assigned at creation time. */
+    eid: number);
+    /**
+     * The set of direct child entities in the scene hierarchy.
+     *
+     * The set is created lazily on first access. Mutate it only through
+     * {@link Entity.destroy} or by setting {@link Entity.parent} on a child —
+     * both will keep the parent–child links consistent.
+     */
+    get children(): Set<Entity>;
+    /**
+     * Add a component of type `Class` to this entity and return the instance.
+     *
+     * If the component is already present the existing instance is returned and
+     * no callback is fired. Pass `markAsModified = false` to suppress the
+     * initial `onSet` / `update` notification (useful when bulk-loading
+     * network snapshots before systems are running).
+     *
+     * @param Class - The component class to instantiate.
+     * @param markAsModified - Whether to immediately queue an `update`
+     *   notification. Defaults to `true`.
+     * @returns The new (or existing) component instance, typed as
+     *   `InstanceType<Class>`.
+     */
+    add<C extends typeof Component>(Class: C, markAsModified?: boolean): InstanceType<C>;
+    /**
+     * Add a component by its numeric type id.
+     *
+     * @param type - Numeric component type id (as returned by
+     *   {@link World.getComponentType}).
+     * @param markAsModified - Whether to queue an update notification.
+     */
+    add(type: number, markAsModified?: boolean): Component;
+    /**
+     * Remove the component of the given class from this entity.
+     *
+     * The `onRemove` hook and any `exit` callbacks on matching systems are
+     * called when archetype changes are flushed at the end of the next system
+     * run. Does nothing if the component is not present.
+     *
+     * @param Class - The component class to remove.
+     */
+    remove<C extends typeof Component>(Class: C): void;
+    /**
+     * Remove a component by its numeric type id.
+     *
+     * @param type - Numeric component type id.
+     */
+    remove(type: number): void;
+    /** @internal Called by systems to deliver update notifications. */
+    _notifyModified(component: Component): void;
+    /**
+     * Retrieve the component of type `Class`, or `undefined` if not present.
+     *
+     * @param typeOrClass - Component class or numeric type id.
+     * @param get_deleted - If `true`, also search components that were removed
+     *   in the current frame but not yet garbage-collected. Useful inside
+     *   `exit` callbacks to read final component values.
+     * @returns The component instance or `undefined`.
+     */
+    get<C extends typeof Component>(typeOrClass: number | C, get_deleted?: boolean): InstanceType<C> | undefined;
+    /**
+     * Typed event emitter for entity-level lifecycle events.
+     *
+     * Currently emits one event:
+     * - `"destroy"` — fired just before the entity is fully torn down.
+     *
+     * The emitter is created lazily on first access.
+     */
+    get events(): EntityEvents;
+    /** @internal */
+    _hasSystem(s: System): boolean;
+    /** @internal */
+    _addSystem(s: System): void;
+    /** @internal */
+    _removeSystem(s: System): void;
+    /** @internal */
+    _updateSystems(): void;
+    /** `true` when the entity has no components attached. */
+    get empty(): boolean;
+    private _destroy;
+    /**
+     * Destroy this entity and recursively destroy all of its children.
+     *
+     * All components are removed (triggering `onRemove` hooks and `exit`
+     * callbacks), the entity is unregistered from the world, and the `"destroy"`
+     * event is emitted. The entity must not be used after calling this method.
+     */
+    destroy(): void;
+    /** @internal */
+    clearDeletedComponents(): void;
+    /**
+     * Iterate over every component currently attached to this entity.
+     *
+     * @param callback - Called with each component instance. Iteration order is
+     *   not guaranteed.
+     */
+    forEachComponent(callback: (c: Component) => void): void;
+    /** Returns `"EntityN"` where N is the entity id. */
+    toString(): string;
+}
+export {};

package/dist/entity.js

@@ -0,0 +1,199 @@
+import { ArrayMap } from "./util/array_map.js";
+import { Events } from "./util/events.js";
+import { Bitset } from "./util/bitset.js";
+/**
+ * A game object — a unique identifier with an arbitrary set of
+ * {@link Component | components} attached to it.
+ *
+ * You never construct an `Entity` directly. Use {@link World.createEntity} for
+ * locally-owned entities or {@link World.getOrCreateEntity} when the id is
+ * assigned by an external authority (e.g. the server):
+ *
+ * ```ts
+ * const e = world.createEntity();
+ * const pos = e.add(Position);
+ * pos.x = 100;
+ * pos.modified();
+ * ```
+ *
+ * Entities support a parent–child hierarchy. When a parent is destroyed its
+ * children are destroyed recursively. The `children` set is created lazily.
+ */
+export class Entity {
+    constructor(
+    /** The {@link World} that owns this entity. */
+    world, 
+    /** Unique numeric entity id assigned at creation time. */
+    eid) {
+        this.world = world;
+        this.eid = eid;
+        this.components = new ArrayMap(); //maps component types to Components
+        this.deletedComponents = new ArrayMap(); //maps deleted component types to Components
+        /**
+         * Bitmask representing the set of component types currently attached to this
+         * entity. Used by the world to efficiently match entities against system
+         * queries.
+         */
+        this.componentBitmask = new Bitset();
+        this.systems = new Set();
+        this.newSystems = [];
+        /**
+         * A free-form property bag that modules can use to associate arbitrary data
+         * with an entity without registering a component.
+         */
+        this.properties = new Map();
+        this._archetypeChanged = false;
+        this.destroyed = false;
+    }
+    /**
+     * The set of direct child entities in the scene hierarchy.
+     *
+     * The set is created lazily on first access. Mutate it only through
+     * {@link Entity.destroy} or by setting {@link Entity.parent} on a child —
+     * both will keep the parent–child links consistent.
+     */
+    get children() {
+        if (!this._children)
+            this._children = new Set();
+        return this._children;
+    }
+    add(typeOrClass, markAsModified = true) {
+        const type = this.world.getComponentType(typeOrClass);
+        let c = this.components.get(type);
+        if (c) {
+            return c;
+        }
+        c = this.world["getComponentInstance"](typeOrClass, this);
+        this.components.set(type, c);
+        this.componentBitmask.add(type);
+        this.world._notifyComponentAdded(this, c);
+        if (markAsModified)
+            this.world._queueUpdatedComponent(c);
+        return c;
+    }
+    remove(typeOrClass) {
+        const type = this.world.getComponentType(typeOrClass);
+        const c = this.components.get(type);
+        if (c) {
+            this.components.delete(type);
+            this.deletedComponents.set(type, c);
+            this.componentBitmask.delete(type);
+            this.world._notifyComponentRemoved(this, c);
+        }
+    }
+    /** @internal Called by systems to deliver update notifications. */
+    _notifyModified(component) {
+        this.systems.forEach((s) => {
+            s.notifyModified(component);
+        });
+    }
+    /**
+     * Retrieve the component of type `Class`, or `undefined` if not present.
+     *
+     * @param typeOrClass - Component class or numeric type id.
+     * @param get_deleted - If `true`, also search components that were removed
+     *   in the current frame but not yet garbage-collected. Useful inside
+     *   `exit` callbacks to read final component values.
+     * @returns The component instance or `undefined`.
+     */
+    get(typeOrClass, get_deleted = false) {
+        const type = this.world.getComponentType(typeOrClass);
+        const c = this.components.get(type);
+        if (!c && get_deleted) {
+            return this.deletedComponents.get(type);
+        }
+        return c;
+    }
+    /**
+     * Typed event emitter for entity-level lifecycle events.
+     *
+     * Currently emits one event:
+     * - `"destroy"` — fired just before the entity is fully torn down.
+     *
+     * The emitter is created lazily on first access.
+     */
+    get events() {
+        if (!this._events) {
+            this._events = new Events();
+        }
+        return this._events;
+    }
+    /** @internal */
+    _hasSystem(s) {
+        return this.systems.has(s);
+    }
+    /** @internal */
+    _addSystem(s) {
+        if (!this.systems.has(s)) {
+            this.newSystems.push(s);
+            s._enter(this);
+        }
+    }
+    /** @internal */
+    _removeSystem(s) {
+        if (this.systems.delete(s)) {
+            s._exit(this);
+        }
+    }
+    /** @internal */
+    _updateSystems() {
+        this.newSystems.forEach((s) => {
+            this.systems.add(s);
+        });
+        this.newSystems.length = 0;
+    }
+    /** `true` when the entity has no components attached. */
+    get empty() {
+        return this.components.size == 0;
+    }
+    _destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.systems.forEach((s) => {
+            s._exit(this);
+        });
+        this.systems.clear();
+        if (this._events) {
+            this._events.emit("destroy");
+            this._events.removeAllListeners("destroy");
+        }
+    }
+    /**
+     * Destroy this entity and recursively destroy all of its children.
+     *
+     * All components are removed (triggering `onRemove` hooks and `exit`
+     * callbacks), the entity is unregistered from the world, and the `"destroy"`
+     * event is emitted. The entity must not be used after calling this method.
+     */
+    destroy() {
+        this.world._notifyEntityDestroyed(this);
+        this.children.forEach((child) => {
+            child.destroy();
+        });
+        this.children.clear();
+        if (this.parent) {
+            this.parent.children.delete(this);
+            this.world.archetypeChanged(this.parent);
+            this.parent = undefined;
+        }
+    }
+    /** @internal */
+    clearDeletedComponents() {
+        this.deletedComponents.clear();
+    }
+    /**
+     * Iterate over every component currently attached to this entity.
+     *
+     * @param callback - Called with each component instance. Iteration order is
+     *   not guaranteed.
+     */
+    forEachComponent(callback) {
+        this.components.forEach(callback);
+    }
+    /** Returns `"EntityN"` where N is the entity id. */
+    toString() {
+        return `Entity${this.eid}`;
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type System } from "./system.js";
+export { World } from "./world.js";
+export { Component, type ComponentMeta } from "./component.js";
+export { type Entity } from "./entity.js";
+export { type IPhase } from "./phase.js";
+export { Bitset } from "./util/bitset.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { World } from "./world.js";
+export { Component } from "./component.js";
+export { Bitset } from "./util/bitset.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAsB,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@vworlds/vecs",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "clean": "rimraf dist && rimraf tsconfig.tsbuildinfo",
+    "prepack": "yarn build",
+    "build": "yarn clean && yarn compile",
+    "compile": "tsc --build && cp \"./package.json\" ./dist/",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^4.8.4",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "eventemitter3": "^4.0.7"
+  },
+  "license": "UNLICENSED"
+}

package/dist/phase.d.ts

@@ -0,0 +1,47 @@
+import { type System } from "./system.js";
+import { type World } from "./world.js";
+/**
+ * A named, ordered bucket of {@link System | systems} within the world's
+ * update pipeline.
+ *
+ * Created internally by {@link World.addPhase}. The systems in a phase run in
+ * the order they were registered. Between each system run the world flushes
+ * pending archetype changes, so `enter` / `exit` callbacks are always
+ * delivered before the next system executes.
+ *
+ * @internal The concrete class is not part of the public API. Use
+ * {@link IPhase} to refer to phases in user code.
+ */
+export declare class Phase {
+    /** Name used to look up the phase in the pipeline. */
+    readonly name: string;
+    world: World;
+    /** Systems that belong to this phase, in execution order. */
+    systems: System[];
+    constructor(
+    /** Name used to look up the phase in the pipeline. */
+    name: string, world: World);
+}
+/**
+ * Public interface for a pipeline phase returned by {@link World.addPhase}.
+ *
+ * Pass an `IPhase` to {@link System.phase} to assign a system to that phase,
+ * or to {@link World.runPhase} to execute it:
+ *
+ * ```ts
+ * const preUpdate = world.addPhase("preupdate");
+ * const send      = world.addPhase("send");
+ *
+ * world.system("NetworkUpdate").phase(preUpdate).run(tick);
+ *
+ * // each frame:
+ * world.runPhase(preUpdate, now, delta);
+ * world.runPhase(send,      now, delta);
+ * ```
+ */
+export interface IPhase {
+    /** The name this phase was registered under. */
+    get name(): string;
+    /** The world that owns this phase. */
+    get world(): World;
+}

package/dist/phase.js

@@ -0,0 +1,23 @@
+/**
+ * A named, ordered bucket of {@link System | systems} within the world's
+ * update pipeline.
+ *
+ * Created internally by {@link World.addPhase}. The systems in a phase run in
+ * the order they were registered. Between each system run the world flushes
+ * pending archetype changes, so `enter` / `exit` callbacks are always
+ * delivered before the next system executes.
+ *
+ * @internal The concrete class is not part of the public API. Use
+ * {@link IPhase} to refer to phases in user code.
+ */
+export class Phase {
+    constructor(
+    /** Name used to look up the phase in the pipeline. */
+    name, world) {
+        this.name = name;
+        this.world = world;
+        /** Systems that belong to this phase, in execution order. */
+        this.systems = [];
+    }
+}
+//# sourceMappingURL=phase.js.map

package/dist/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../src/phase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,KAAK;IAIhB;IACE,sDAAsD;IACtC,IAAY,EACrB,KAAY;QADH,SAAI,GAAJ,IAAI,CAAQ;QACrB,UAAK,GAAL,KAAK,CAAO;QANrB,6DAA6D;QACtD,YAAO,GAAa,EAAE,CAAC;IAM3B,CAAC;CACL"}