@vworlds/vecs 1.0.14 → 1.0.16

package/dist/entity/entity.base.js

@@ -0,0 +1,81 @@
+import { ComponentMeta } from "../component_meta.js";
+import { ArrayMap } from "../util/array_map.js";
+import { Bitset } from "../util/bitset.js";
+import { Events } from "../util/events.js";
+export class Base {
+    constructor(
+    /** World that owns this entity. */
+    world, 
+    /** Unique numeric entity id assigned at creation. */
+    eid, ownComponentClass) {
+        this.world = world;
+        this.eid = eid;
+        /** @internal Maps component eid to component instance. */
+        this._components = new ArrayMap();
+        /** @internal Component eids with pending modified delivery. */
+        this._dirtyComponentBitmask = new Bitset();
+        /** @internal Set of queries this entity currently belongs to. */
+        this._queries = new Set();
+        /**
+         * Bitmask of component type ids currently attached to this entity. Used by
+         * the world for fast archetype matching against query predicates.
+         */
+        this.componentBitmask = new Bitset();
+        /**
+         * Free-form property bag. Modules can use it to associate arbitrary data with
+         * an entity without registering a dedicated component.
+         */
+        this.properties = new Map();
+        /** @internal Set to `true` after the world has fully torn down this entity. */
+        this._destroyed = false;
+        if (ownComponentClass !== undefined) {
+            this._ownMeta = new ComponentMeta(ownComponentClass, eid);
+        }
+    }
+    /**
+     * 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() {
+        return this._components;
+    }
+    /** `true` when no components are currently attached to this entity. */
+    get empty() {
+        return this._components.size == 0;
+    }
+    /**
+     * 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() {
+        if (!this._events) {
+            this._events = new Events();
+        }
+        return this._events;
+    }
+    /** Metadata for using this entity's eid as a component key. Created lazily for plain entities. */
+    get ownMeta() {
+        return (this._ownMeta ?? (this._ownMeta = new ComponentMeta(Object, this.eid)));
+    }
+    /** Number of live component instances currently attached for this entity's component key. */
+    instanceCount() {
+        return this._ownMeta?.usageCount ?? 0;
+    }
+    /** Returns `"EntityN"` where N is the entity id. */
+    toString() {
+        return `Entity${this.eid}`;
+    }
+}
+/** @internal Empty incoming set used when no entities target this one. */
+Base._emptyIncoming = new Set();
+//# sourceMappingURL=entity.base.js.map

package/dist/entity/entity.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.base.js","sourceRoot":"","sources":["../../src/entity/entity.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8C,MAAM,sBAAsB,CAAC;AAEjG,OAAO,EAAE,QAAQ,EAAyB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAM3C,MAAM,OAAO,IAAI;IAmCf;IACE,mCAAmC;IACnB,KAAY;IAC5B,qDAAqD;IACrC,GAAW,EAC3B,iBAAiC;QAHjB,UAAK,GAAL,KAAK,CAAO;QAEZ,QAAG,GAAH,GAAG,CAAQ;QAnC7B,0DAA0D;QAChD,gBAAW,GAAG,IAAI,QAAQ,EAAqB,CAAC;QAC1D,+DAA+D;QAC5C,2BAAsB,GAAG,IAAI,MAAM,EAAE,CAAC;QACzD,iEAAiE;QAC9C,aAAQ,GAAG,IAAI,GAAG,EAAS,CAAC;QAQ/C;;;WAGG;QACa,qBAAgB,GAAG,IAAI,MAAM,EAAE,CAAC;QAEhD;;;WAGG;QACI,eAAU,GAAG,IAAI,GAAG,EAAe,CAAC;QAE3C,+EAA+E;QACxE,eAAU,GAAY,KAAK,CAAC;QAYjC,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,IAAW,MAAM;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,kGAAkG;IAClG,IAAW,OAAO;QAChB,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAb,IAAI,CAAC,QAAQ,GAAK,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAC,CAAC;IACjE,CAAC;IAED,6FAA6F;IACtF,aAAa;QAClB,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,oDAAoD;IAC7C,QAAQ;QACb,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;;AAnFD,0EAA0E;AAChD,mBAAc,GAAwB,IAAI,GAAG,EAAE,AAAjC,CAAkC"}

package/dist/entity/entity.components.d.ts

@@ -0,0 +1,117 @@
+import { type ComponentClass, type ComponentInstance, type ComponentRef, type ComponentType } from "../component_meta.js";
+import { Relationships } from "./entity.relationships.js";
+import type { Entity } from "./entity.js";
+export declare class Components extends Relationships {
+    /**
+     * 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): this;
+    /**
+     * Attach a component by numeric type id.
+     *
+     * @param type - Numeric component type id.
+     * @returns This entity, for chaining.
+     */
+    add(eid: number): this;
+    add(entity: Entity): this;
+    /**
+     * 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.
+     *
+     * By default `attach` uses the instance constructor to resolve component
+     * metadata. Pass an explicit class when the instance should be stored under
+     * a base component key. 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: ComponentInstance): this;
+    attach<C extends ComponentInstance>(Class: ComponentType<C>, component: C): this;
+    /**
+     * Look up a component on this entity as a readonly value.
+     *
+     * @param typeOrClass - Component class or numeric type id.
+     * @returns The component instance, or `undefined` when it is not attached.
+     */
+    get<C extends ComponentType>(Class: C): Readonly<InstanceType<C>> | undefined;
+    /** Look up a component by numeric type id as a readonly value. */
+    get(eid: number): Readonly<ComponentInstance> | undefined;
+    get(entity: Entity): Readonly<ComponentInstance> | undefined;
+    /**
+     * Look up a component on this entity for mutation in deferred mode.
+     *
+     * When the component is present, this marks the component modified before
+     * returning the mutable instance. Outside deferred mode, pass a callback so
+     * the component can be marked modified after the mutation callback returns.
+     *
+     * @param typeOrClass - Component class or numeric type id.
+     * @returns The component instance, or `undefined` when it is not attached.
+     */
+    getMut<C extends ComponentType>(Class: C): InstanceType<C> | undefined;
+    /** Look up a component, mutate it in `callback`, then mark it modified. */
+    getMut<C extends ComponentType>(Class: C, callback: (component: InstanceType<C>) => void): Readonly<InstanceType<C>> | undefined;
+    /** Look up a component by numeric type id for mutation. */
+    getMut(eid: number): ComponentInstance | undefined;
+    /** Look up a component by numeric type id, mutate it in `callback`, then mark it modified. */
+    getMut(eid: number, callback: (component: ComponentInstance) => void): Readonly<ComponentInstance> | undefined;
+    getMut(entity: Entity): ComponentInstance | undefined;
+    getMut(entity: Entity, callback: (component: ComponentInstance) => void): Readonly<ComponentInstance> | 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(ref: ComponentRef): this;
+    /**
+     * 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 ComponentType>(Class: C): void;
+    /**
+     * Detach a component by numeric type id.
+     *
+     * @param type - Numeric component type id.
+     */
+    remove(eid: number): void;
+    remove(entity: Entity): 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>>): this;
+    /**
+     * 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(eid: number, props: Partial<ComponentInstance>): this;
+    set(entity: Entity, props: Partial<ComponentInstance>): this;
+}

package/dist/entity/entity.components.js

@@ -0,0 +1,244 @@
+import { Relationships } from "./entity.relationships.js";
+export class Components extends Relationships {
+    /**
+     * @internal Apply an `Attach` command: store the provided component instance,
+     * replacing any previous instance for this type. Events are fired as if the
+     * caller had performed a `set` operation.
+     */
+    _attach(meta, component) {
+        if (this._destroyed) {
+            return;
+        }
+        const existing = this._components.get(meta.eid);
+        const oldTarget = meta.isRelationship
+            ? existing?.target
+            : undefined;
+        this._storeComponent(meta, component, existing === undefined);
+        this._updateIncoming(meta, oldTarget, component.target);
+        this._notifyComponentSet(meta, component, existing !== undefined);
+    }
+    /**
+     * @internal Look up a component instance by component eid.
+     *
+     * Faster than {@link get} because no class to type id resolution is needed.
+     */
+    _get(eid) {
+        return this._components.get(eid);
+    }
+    /**
+     * @internal Apply a `Modified` command: fire `onSet` and route modified
+     * events to every query that watches the component type.
+     */
+    _modified(meta) {
+        if (this._destroyed) {
+            return;
+        }
+        const c = this._components.get(meta.eid);
+        if (!c) {
+            return;
+        }
+        this._notifyComponentSet(meta, c, true);
+    }
+    /**
+     * @internal Apply a `Remove` command: clear the type bit, route exits,
+     * detach the component, and fire `onRemove`.
+     */
+    _remove(meta) {
+        if (this._destroyed) {
+            return;
+        }
+        const c = this._components.get(meta.eid);
+        if (!c) {
+            return;
+        }
+        if (meta.isRelationship) {
+            this._removeIncoming(c.target, meta.eid);
+        }
+        this._dirtyComponentBitmask.deleteBit(meta.bitPtr);
+        this.componentBitmask.deleteBit(meta.bitPtr);
+        this.world._notifyComponentRemoved(meta.eid, this);
+        this._components.delete(meta.eid);
+        this.world._notifyComponentChanged(meta.eid, this);
+        meta._decrementUsage();
+        const removeHandlers = meta._onRemoveHandlers;
+        if (removeHandlers) {
+            removeHandlers.forEach((handler) => handler(this, c));
+        }
+    }
+    /**
+     * @internal Apply a `Set` command: create the component if missing, assign
+     * `props` if provided, fire `onSet`, and route modified events to every
+     * query that watches the component type.
+     */
+    _set(meta, props) {
+        if (this._destroyed) {
+            return;
+        }
+        const existing = this._components.get(meta.eid);
+        const oldTarget = meta.isRelationship
+            ? existing?.target
+            : undefined;
+        const c = existing ?? this._new(meta, props);
+        if (props !== undefined) {
+            if (existing) {
+                Object.assign(c, props);
+            }
+            const newTarget = c.target;
+            this._updateIncoming(meta, oldTarget, newTarget);
+            this._notifyComponentSet(meta, c, existing !== undefined);
+        }
+    }
+    add(ref) {
+        const meta = this.world.entity(ref).ownMeta;
+        if (this.world.deferred) {
+            this.world._enqueue({
+                kind: 1 /* CommandKind.Set */,
+                entity: this,
+                meta,
+                props: undefined,
+            });
+        }
+        else {
+            this._set(meta, undefined);
+        }
+        return this;
+    }
+    attach(classOrComponent, component) {
+        const ComponentKey = component === undefined ? classOrComponent.constructor : classOrComponent;
+        const instance = component ?? classOrComponent;
+        const meta = this.world.entity(ComponentKey).ownMeta;
+        if (this.world.deferred) {
+            this.world._enqueue({
+                kind: 5 /* CommandKind.Attach */,
+                entity: this,
+                meta,
+                component: instance,
+            });
+        }
+        else {
+            this._attach(meta, instance);
+        }
+        return this;
+    }
+    get(ref) {
+        const eid = this.world.entity(ref).eid;
+        return this._get(eid);
+    }
+    getMut(ref, callback) {
+        if (callback === undefined && !this.world.deferred) {
+            throw new Error("Entity.getMut without a callback is only allowed in deferred mode");
+        }
+        const meta = this.world.entity(ref).ownMeta;
+        if (meta.isRelationship) {
+            throw new Error("Entity.getMut cannot mutate Relationship components; retarget with set");
+        }
+        const component = this._get(meta.eid);
+        if (!component) {
+            return undefined;
+        }
+        callback?.(component);
+        this._markModified(meta);
+        return component;
+    }
+    /**
+     * 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(ref) {
+        const meta = this.world.entity(ref).ownMeta;
+        return this._markModified(meta);
+    }
+    /** @internal Mark a component changed, coalescing duplicate pending notifications. */
+    _markModified(meta) {
+        if (this._dirtyComponentBitmask.hasBit(meta.bitPtr)) {
+            return this;
+        }
+        this._dirtyComponentBitmask.addBit(meta.bitPtr);
+        if (this.world.deferred) {
+            this.world._enqueue({ kind: 2 /* CommandKind.Modified */, entity: this, meta });
+        }
+        else {
+            this._modified(meta);
+        }
+        return this;
+    }
+    remove(ref) {
+        const meta = this.world.entity(ref).ownMeta;
+        if (this.world.deferred) {
+            this.world._enqueue({ kind: 3 /* CommandKind.Remove */, entity: this, meta });
+        }
+        else {
+            this._remove(meta);
+        }
+    }
+    set(ref, props) {
+        const meta = this.world.entity(ref).ownMeta;
+        if (this.world.deferred) {
+            this.world._enqueue({
+                kind: 1 /* CommandKind.Set */,
+                entity: this,
+                meta,
+                props,
+            });
+        }
+        else {
+            this._set(meta, props);
+        }
+        return this;
+    }
+    /**
+     * @internal
+     *
+     * 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.
+     */
+    _new(meta, props) {
+        const c = new meta.Class();
+        if (props !== undefined) {
+            Object.assign(c, props);
+        }
+        this._storeComponent(meta, c, true);
+        return c;
+    }
+    /** @internal Perform the shared set-side hook and query update routing. */
+    _notifyComponentSet(meta, instance, isUpdate) {
+        meta._onSetHandlers?.forEach((handler) => handler(this, instance));
+        this._dirtyComponentBitmask.deleteBit(meta.bitPtr);
+        if (isUpdate) {
+            this.world._notifyComponentChanged(meta.eid, this);
+            this._queries.forEach((q) => q._notifyModified(this, meta, instance));
+        }
+    }
+    /** @internal Store a component instance and perform the shared add-side bookkeeping. */
+    _storeComponent(meta, instance, isAdd) {
+        if (meta._exclusive) {
+            for (const exclusiveMeta of meta._exclusive) {
+                if (this._components.has(exclusiveMeta.eid)) {
+                    this._remove(exclusiveMeta);
+                }
+            }
+        }
+        const existing = this._components.has(meta.eid);
+        this._components.set(meta.eid, instance);
+        this.componentBitmask.addBit(meta.bitPtr);
+        if (!existing) {
+            meta._incrementUsage();
+        }
+        if (isAdd && !existing) {
+            meta._onAddHandlers?.forEach((handler) => handler(this, instance));
+        }
+        if (!existing) {
+            this.world._notifyComponentAdded(meta.eid, this);
+        }
+    }
+}
+//# sourceMappingURL=entity.components.js.map

package/dist/entity/entity.components.js.map

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

package/dist/entity/entity.d.ts

@@ -0,0 +1,35 @@
+import { type ComponentType } from "../component_meta.js";
+import { type World } from "../world/index.js";
+import { IdentityEntity } from "./entity.identity.js";
+export type EntityClass<T extends Entity = Entity> = new (world: World, eid: number, ownComponentClass?: ComponentType) => T;
+/**
+ * A game object: a unique numeric id with an arbitrary set of
+ * {@link ComponentInstance | 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 });
+ * ```
+ *
+ * ## Deferred semantics
+ *
+ * Inside a system body or `forEach` iteration the world is in **deferred
+ * mode**: `add` / `attach` / `set` / `modified` / `remove` / `destroy` 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)` / `entity.getMut(C)` returns `undefined` after `entity.add(C)` (no instance yet).
+ * - `entity.get(C)` / `entity.getMut(C)` returns `undefined` after `entity.attach(instance)` if C was absent.
+ * - `entity.get(C)` / `entity.getMut(C)` returns the previous value after `entity.set(C, props)`.
+ * - `entity.get(C)` / `entity.getMut(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 extends IdentityEntity {
+}

package/dist/entity/entity.identity.d.ts

@@ -0,0 +1,8 @@
+import { Lifecycle } from "./entity.lifecycle.js";
+export declare class Identity {
+    name: string;
+}
+export declare class IdentityEntity extends Lifecycle {
+    get name(): string | undefined;
+    set name(n: string);
+}

package/dist/entity/entity.identity.js

@@ -0,0 +1,15 @@
+import { Lifecycle } from "./entity.lifecycle.js";
+export class Identity {
+    constructor() {
+        this.name = "";
+    }
+}
+export class IdentityEntity extends Lifecycle {
+    get name() {
+        return this.get(Identity)?.name;
+    }
+    set name(n) {
+        this.set(Identity, { name: n });
+    }
+}
+//# sourceMappingURL=entity.identity.js.map

package/dist/entity/entity.identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.identity.js","sourceRoot":"","sources":["../../src/entity/entity.identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAO,QAAQ;IAArB;QACS,SAAI,GAAG,EAAE,CAAC;IACnB,CAAC;CAAA;AAED,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAClC,CAAC;IAED,IAAW,IAAI,CAAC,CAAS;QACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/entity/entity.js

@@ -0,0 +1,33 @@
+import { IdentityEntity } from "./entity.identity.js";
+/**
+ * A game object: a unique numeric id with an arbitrary set of
+ * {@link ComponentInstance | 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 });
+ * ```
+ *
+ * ## Deferred semantics
+ *
+ * Inside a system body or `forEach` iteration the world is in **deferred
+ * mode**: `add` / `attach` / `set` / `modified` / `remove` / `destroy` 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)` / `entity.getMut(C)` returns `undefined` after `entity.add(C)` (no instance yet).
+ * - `entity.get(C)` / `entity.getMut(C)` returns `undefined` after `entity.attach(instance)` if C was absent.
+ * - `entity.get(C)` / `entity.getMut(C)` returns the previous value after `entity.set(C, props)`.
+ * - `entity.get(C)` / `entity.getMut(C)` still returns the component after `entity.remove(C)`.
+ *
+ * Outside deferred mode the same calls execute inline and mutations are
+ * visible immediately.
+ */
+export class Entity extends IdentityEntity {
+}
+//# sourceMappingURL=entity.js.map

package/dist/entity/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/entity/entity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,MAAO,SAAQ,cAAc;CAAG"}

package/dist/entity/entity.lifecycle.d.ts

@@ -0,0 +1,12 @@
+import { Components } from "./entity.components.js";
+export declare class Lifecycle extends Components {
+    /**
+     * Destroy this entity.
+     *
+     * 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;
+    private _applyOnDelete;
+}