@funderforge/ecs 0.1.0

package/dist/entity.js

@@ -0,0 +1,418 @@
+/**
+ * Represents an entity in a hierarchical tree structure that can contain child entities and components.
+ * Entities form the backbone of the component framework, allowing you to build flexible hierarchies
+ * where each entity can have multiple components attached to it.
+ *
+ * Key features:
+ * - Hierarchical parent-child relationships
+ * - Cascading enabled/disabled state management with caching
+ * - Component attachment and management
+ * - Efficient traversal of entities and components
+ * - Method-based architecture through component virtual methods
+ *
+ * @example
+ * ```typescript
+ * const root = new Entity({ id: 'root' });
+ * const child = new Entity({ id: 'child', parent: root });
+ * root.addChild(child);
+ * ```
+ */
+export default class Entity {
+    _children = [];
+    _parent = null;
+    _enabledSelf = true;
+    _enabledCache = null; // Cache for enabled property
+    /** Unique identifier for this entity. Can be a string or number. If not provided in constructor, an auto-incrementing number is assigned. */
+    id;
+    static _idCounter = Number.MIN_SAFE_INTEGER;
+    _components = [];
+    // biome-ignore lint/complexity/noBannedTypes: On purpose, we need to support any constructor
+    _componentMap = new Map();
+    /**
+     * Creates a new Entity instance.
+     * @param preset - Optional configuration object for the entity.
+     * @param preset.id - Optional unique identifier. If not provided, an auto-incrementing number is assigned.
+     * @param preset.enabledSelf - Whether the entity is enabled by default. Defaults to `true`.
+     * @param preset.parent - Optional parent entity. If provided, this entity will be added as a child of the parent.
+     *
+     * @example
+     * ```typescript
+     * // Create a root entity with a custom ID
+     * const root = new Entity({ id: 'scene' });
+     *
+     * // Create a child entity with a parent
+     * const child = new Entity({ id: 'player', parent: root, enabledSelf: true });
+     *
+     * // Create an entity that will be auto-assigned an ID
+     * const entity = new Entity();
+     * ```
+     */
+    constructor(preset = {}) {
+        this.id = preset.id ?? Entity._idCounter++;
+        this._enabledSelf = preset.enabledSelf ?? true;
+        if (preset.parent) {
+            this.setParent(preset.parent);
+        }
+    }
+    /**
+     * Gets whether this entity itself is enabled, independent of its parent's state.
+     * @returns `true` if this entity is enabled, `false` otherwise.
+     */
+    get enabledSelf() {
+        return this._enabledSelf;
+    }
+    /**
+     * Sets whether this entity itself is enabled. When set to `false`, this entity and all its descendants become disabled.
+     * Invalidates the enabled cache for this entity and all descendants, and calls `onEnabledChanged` on affected components.
+     * @param value - `true` to enable this entity, `false` to disable it.
+     */
+    set enabledSelf(value) {
+        if (value === this._enabledSelf)
+            return;
+        const oldEnabled = this.enabled;
+        this._enabledSelf = value;
+        // Invalidate enabled cache for this entity and all descendants
+        this._invalidateEnabledCache();
+        const newEnabled = this.enabled;
+        if (newEnabled === oldEnabled) {
+            return;
+        }
+        for (const component of this._components) {
+            if (component.enabledSelf) {
+                // biome-ignore lint/suspicious/noExplicitAny: Override protected guard
+                component.onEnabledChanged(newEnabled);
+            }
+        }
+        for (const child of this.traverseChildren((child) => child.enabledSelf)) {
+            for (const component of child._components) {
+                if (component.enabledSelf) {
+                    // biome-ignore lint/suspicious/noExplicitAny: Override protected guard
+                    component.onEnabledChanged(newEnabled);
+                }
+            }
+        }
+    }
+    /**
+     * Gets the effective enabled state of this entity, considering both its own `enabledSelf` value and all parent entities' enabled states.
+     * The result is cached for performance and automatically invalidated when necessary.
+     * @returns `true` only if this entity's `enabledSelf` is `true` and all parent entities (up to the root) have `enabledSelf` set to `true`.
+     */
+    get enabled() {
+        // Return cached value if available
+        if (this._enabledCache !== null) {
+            return this._enabledCache;
+        }
+        // iterate through self and parents until a parent is found false
+        let current = this;
+        while (current) {
+            if (!current.enabledSelf) {
+                this._enabledCache = false;
+                return false;
+            }
+            current = current.parent;
+        }
+        this._enabledCache = true;
+        return true;
+    }
+    /**
+     * Invalidates the enabled cache for this entity and all its descendants.
+     * This is called when enabledSelf changes or when parent changes.
+     * Uses an iterative approach with a stack to avoid potential stack overflow for deep trees.
+     */
+    _invalidateEnabledCache() {
+        const stack = [this];
+        while (stack.length) {
+            // biome-ignore lint/style/noNonNullAssertion: stack is not null
+            const entity = stack.pop();
+            entity._enabledCache = null;
+            // Push all children onto the stack
+            for (let i = entity._children.length - 1; i >= 0; i--) {
+                stack.push(entity._children[i]);
+            }
+        }
+    }
+    /**
+     * Adds a child entity to this entity. If the child already has a parent, it will be removed from its previous parent first.
+     * @param child - The entity to add as a child.
+     */
+    addChild(child) {
+        this._children.push(child);
+        if (child.parent) {
+            child.parent.removeChild(child);
+        }
+        child._parent = this;
+        child._invalidateEnabledCache();
+    }
+    /**
+     * Removes a child entity by its index in the children array. The removed child's parent will be set to `null`.
+     * @param index - The index of the child to remove.
+     */
+    removeChildByIndex(index) {
+        const child = this._children.splice(index, 1);
+        child[0].setParent(null);
+        child[0]._invalidateEnabledCache();
+    }
+    /**
+     * Removes a child entity. The removed child's parent will be set to `null`.
+     * @param child - The child entity to remove.
+     */
+    removeChild(child) {
+        const index = this._children.indexOf(child);
+        if (index !== -1) {
+            this._children.splice(index, 1);
+            child.setParent(null);
+            child._invalidateEnabledCache();
+        }
+    }
+    /**
+     * Gets the number of direct child entities.
+     * @returns The number of children.
+     */
+    childrenLength() {
+        return this._children.length;
+    }
+    /**
+     * Gets a child entity by its index in the children array.
+     * @template T - The type of entity to return. Defaults to `Entity`.
+     * @param index - The index of the child to retrieve.
+     * @returns The child entity at the specified index, or `undefined` if the index is out of bounds.
+     */
+    childByIdx(index) {
+        return this._children[index];
+    }
+    /**
+     * Finds the first child entity that matches the given predicate.
+     * @template T - The type of entity to return. Defaults to `Entity`.
+     * @param predicate - A function that returns `true` for the child to find.
+     * @returns The first matching child entity, or `undefined` if no match is found.
+     */
+    getChild(predicate) {
+        return this._children.find(predicate);
+    }
+    /**
+     * Gets the index of a child entity in the children array.
+     * @param child - The child entity to find the index of.
+     * @returns The index of the child, or `-1` if not found.
+     */
+    indexOfChild(child) {
+        return this._children.indexOf(child);
+    }
+    /**
+     * Gets all child entities that match the given filter function.
+     * @template T - The type of entity to return. Defaults to `Entity`.
+     * @param filter - A function that returns `true` for children to include.
+     * @returns An array of matching child entities.
+     */
+    getChildren(filter) {
+        return this._children.filter(filter);
+    }
+    /**
+     * Traverses the children of this entity and all its descendants using a depth-first approach.
+     * @template T - The type of entity to yield. Defaults to `Entity`.
+     * @param predicate - Optional predicate to filter the children. If provided and returns `true`, the child will be yielded and its descendants will be traversed. If omitted, all children are traversed.
+     * @returns A generator that yields entities in the traversal order.
+     */
+    *traverseChildren(predicate) {
+        const stack = [];
+        for (let i = this._children.length - 1; i >= 0; i--) {
+            stack.push(this._children[i]);
+        }
+        while (stack.length) {
+            // biome-ignore lint/style/noNonNullAssertion: stack is not null
+            const e = stack.pop();
+            if (predicate && !predicate(e))
+                continue;
+            yield e;
+            const c = e._children;
+            for (let i = c.length - 1; i >= 0; i--) {
+                stack.push(c[i]);
+            }
+        }
+    }
+    /**
+     * Traverses the components of this entity and all its descendants using a pre-order depth-first approach.
+     * Only traverses enabled entities. Components are yielded before their entity's children.
+     * @template T - The type of component to yield. Defaults to `Component`.
+     * @param predicate - Optional predicate to filter the components. If provided and returns `true`, the component will be yielded. If omitted, all components are traversed.
+     * @returns A generator that yields components in the traversal order.
+     */
+    *traverseComponents(predicate) {
+        const stack = [];
+        // push root
+        stack.push(this);
+        const hasPredicate = predicate !== undefined;
+        while (stack.length) {
+            // biome-ignore lint/style/noNonNullAssertion: stack is not null
+            const entity = stack.pop();
+            // yield components first (pre-order)
+            const components = entity._components;
+            for (let i = 0; i < components.length; i++) {
+                const component = components[i];
+                if (!hasPredicate || predicate(component)) {
+                    yield component;
+                }
+            }
+            // push children in reverse to preserve order
+            const children = entity._children;
+            for (let i = children.length - 1; i >= 0; i--) {
+                const child = children[i];
+                if (child.enabledSelf) {
+                    stack.push(child);
+                }
+            }
+        }
+    }
+    /**
+     * Sets or clears the parent entity. If setting a new parent, this entity will be removed from its previous parent and added to the new one.
+     * Invalidates the enabled cache when the parent changes.
+     * @param parent - The new parent entity, or `null` to remove the parent.
+     */
+    setParent(parent) {
+        if (this._parent) {
+            this._parent.removeChild(this);
+        }
+        this._parent = parent;
+        if (parent) {
+            parent._children.push(this);
+        }
+        // Invalidate enabled cache when parent changes
+        this._invalidateEnabledCache();
+    }
+    /**
+     * Gets the parent entity in the hierarchy.
+     * @returns The parent entity, or `null` if this entity has no parent (i.e., it's a root entity).
+     */
+    get parent() {
+        return this._parent;
+    }
+    /**
+     * Gets the depth level of this entity in the hierarchy. Root entities have a level of 0.
+     * @returns The number of ancestors (parent entities) in the hierarchy chain.
+     */
+    hierarchyLevel() {
+        let level = 0;
+        let current = this._parent;
+        while (current) {
+            level++;
+            current = current.parent;
+        }
+        return level;
+    }
+    /**
+     * Gets the number of components attached to this entity.
+     * @returns The number of components.
+     */
+    componentsLength() {
+        return this._components.length;
+    }
+    /**
+     * Gets a component by its index in the components array.
+     * @template T - The type of component to return. Defaults to `Component`.
+     * @param index - The index of the component to retrieve.
+     * @returns The component at the specified index, or `undefined` if the index is out of bounds.
+     */
+    componentByIdx(index) {
+        return this._components[index];
+    }
+    /**
+     * Finds the first component that matches the given predicate.
+     * @template T - The type of component to return. Defaults to `Component`.
+     * @param predicate - A function that returns `true` for the component to find.
+     * @returns The first matching component, or `undefined` if no match is found.
+     */
+    getComponent(predicate) {
+        return this._components.find(predicate);
+    }
+    /**
+     * Finds the first component of the specified type. Uses an optimized type map for fast lookups when available.
+     *
+     * **Performance Note:** Components are only added to the internal type map for optimized lookups when they are
+     * created with `precacheTypeLookup: true`. If a component is created with `precacheTypeLookup: false` (the default),
+     * it will not be in the type map and the lookup will fall back to iterating through all components, which is slower
+     * but avoids the overhead of maintaining the map for components that are rarely looked up by type.
+     *
+     * @template T - The type of component to return.
+     * @param type - The constructor function of the component type to find.
+     * @returns The first matching component of the specified type, or `undefined` if not found.
+     *
+     * @example
+     * ```typescript
+     * class TransformComponent extends Component {}
+     * const entity = new Entity();
+     * // Component is NOT added to type map by default (precacheTypeLookup defaults to false)
+     * const transform = new TransformComponent(entity);
+     * const found = entity.getComponentByType(TransformComponent); // Slower, iterates through components
+     *
+     * // Component is added to type map for fast lookups (precacheTypeLookup: true)
+     * const render = new RenderComponent(entity, { precacheTypeLookup: true });
+     * const foundRender = entity.getComponentByType(RenderComponent); // Fast O(1) lookup
+     * ```
+     */
+    getComponentByType(
+    // biome-ignore lint/suspicious/noExplicitAny: It's fine, we need to support any constructor
+    type) {
+        const direct = this._componentMap.get(type);
+        if (direct) {
+            return direct;
+        }
+        // No map entry, iterate to find first component
+        for (const c of this._components) {
+            if (c instanceof type) {
+                this._componentMap.set(type, c);
+                return c;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Gets all components that match the given filter function.
+     * @template T - The type of component to return. Defaults to `Component`.
+     * @param filter - A function that returns `true` for components to include.
+     * @returns An array of matching components.
+     */
+    getComponents(filter) {
+        // Writing filter manually, as this is supposedly faster than using the built in filter method or generator
+        const result = [];
+        const components = this._components;
+        for (let i = 0, l = components.length; i < l; i++) {
+            const c = components[i];
+            if (filter(c)) {
+                result.push(c);
+            }
+        }
+        return result;
+    }
+    /**
+     * Gets the index of a component in the components array.
+     * @param component - The component to find the index of.
+     * @returns The index of the component, or `-1` if not found.
+     */
+    indexOfComponent(component) {
+        return this._components.indexOf(component);
+    }
+    /**
+     * Ticks this entity and all its descendants, calling `onTick` on all enabled components.
+     * This should ONLY be called from the root of an Entity tree. Will traverse the full depth of the tree.
+     * Disabled entity subtrees and disabled components are skipped during traversal.
+     * @param deltaTime - The time elapsed since the last tick in milliseconds.
+     */
+    _tick(deltaTime) {
+        if (!this._enabledSelf)
+            return;
+        this._components.forEach((component) => {
+            if (!component.enabledSelf)
+                return;
+            // biome-ignore lint/suspicious/noExplicitAny: Override protected guard
+            component.onTick(deltaTime);
+        });
+        for (const child of this.traverseChildren((child) => child.enabledSelf)) {
+            child._components.forEach((component) => {
+                if (!component.enabledSelf)
+                    return;
+                // biome-ignore lint/suspicious/noExplicitAny: Override protected guard
+                component.onTick(deltaTime);
+            });
+        }
+    }
+}
+//# 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,3 @@
+export { default as Component } from "./component";
+export { default as Entity } from "./entity";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as Component } from "./component";
+export { default as Entity } from "./entity";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+	"name": "@funderforge/ecs",
+	"version": "0.1.0",
+	"description": "A generic component framework implementing an Entity-Component System (ECS) pattern, optimized for performance and simplicity",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"lint:fix": "pnpm exec biome check --write",
+		"prepublishOnly": "pnpm run build",
+		"publish": "pnpm publish"
+	},
+	"keywords": [
+		"ecs",
+		"entity-component-system",
+		"component",
+		"entity",
+		"framework",
+		"game-engine",
+		"hierarchy",
+		"typescript"
+	],
+	"author": "funder75",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/funder75/ecs"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.8",
+		"@types/node": "^25.0.3",
+		"typescript": "~5.9.3",
+		"vitest": "4.0.16"
+	}
+}