@vworlds/vecs 1.0.14 → 1.0.16

package/dist/inject.js

@@ -0,0 +1,270 @@
+import { Entity } from "./entity/index.js";
+import { _resolveRelationship } from "./dsl.js";
+function _isUpInject(value) {
+    return typeof value === "object" && value !== null && "up" in value;
+}
+function _isDownInject(value) {
+    return typeof value === "object" && value !== null && "down" in value;
+}
+export function mapInject(world, inject) {
+    return inject.map((term) => {
+        if (_isUpInject(term)) {
+            return {
+                up: [_resolveRelationship(term.up[0], world), term.up[1].map((C) => world.entity(C).eid)],
+            };
+        }
+        if (_isDownInject(term)) {
+            return {
+                down: [
+                    _resolveRelationship(term.down[0], world),
+                    term.down[1].map((C) => world.entity(C).eid),
+                ],
+            };
+        }
+        return world.entity(term).eid;
+    });
+}
+export function injectArity(inject) {
+    let arity = 0;
+    inject.forEach((term) => {
+        arity += typeof term === "number" ? 1 : "up" in term ? term.up[1].length : term.down[1].length;
+    });
+    return arity;
+}
+export function getInjected(e, inject, requireDirectComponents, out, exitSnapshot) {
+    let outIndex = 0;
+    inject.forEach((term) => {
+        if (typeof term === "number") {
+            const c = exitSnapshot?.get(term) ?? e._get(term);
+            if (requireDirectComponents && !c) {
+                throw new Error("query does not contain component");
+            }
+            out[outIndex++] = c;
+            return;
+        }
+        if ("down" in term) {
+            throw new Error("down injection is only supported in each/forEach");
+        }
+        const target = e.componentBitmask.has(term.up[0])
+            ? e._get(term.up[0])?.target
+            : undefined;
+        term.up[1].forEach((componentEid) => {
+            out[outIndex++] = target?.componentBitmask.has(componentEid)
+                ? target._get(componentEid)
+                : undefined;
+        });
+    });
+}
+export function getInjectedWithSrc(e, inject, out, src, requireDirectComponents = false, exitSnapshot) {
+    let outIndex = 0;
+    inject.forEach((term) => {
+        if (typeof term === "number") {
+            const c = exitSnapshot?.get(term) ?? e._get(term);
+            if (requireDirectComponents && !c) {
+                throw new Error("query does not contain component");
+            }
+            out[outIndex] = c;
+            src[outIndex] = e;
+            outIndex++;
+            return;
+        }
+        if ("down" in term) {
+            throw new Error("down injection is only supported in each/forEach");
+        }
+        const target = e.componentBitmask.has(term.up[0])
+            ? e._get(term.up[0])?.target
+            : undefined;
+        term.up[1].forEach((componentEid) => {
+            out[outIndex] = target?.componentBitmask.has(componentEid)
+                ? target._get(componentEid)
+                : undefined;
+            src[outIndex] = target;
+            outIndex++;
+        });
+    });
+}
+export function directInjectEids(inject) {
+    return inject.filter((term) => typeof term === "number");
+}
+/**
+ * Per-iteration cursor passed to `each` / `forEach` / `enter` / `exit` /
+ * `update` / `sort` callbacks when the caller opts in by passing `Iter` as
+ * the first argument:
+ *
+ * ```ts
+ * system.each(Iter, [Body, { up: [ChildOf, [Position]] }], (it, [body, pos]) => {
+ *   it.entity;  // the visited entity
+ *   it.src[0];  // entity `body` was read from (the visited entity)
+ *   it.src[1];  // entity `pos` was read from (the ChildOf target), or undefined
+ * });
+ * ```
+ *
+ * A single instance is created when the iteration is set up and mutated before
+ * every callback, so it allocates nothing per entity. Read what you need inside
+ * the callback; do not retain the cursor or its {@link src} array across
+ * callbacks.
+ */
+export class Iter {
+    constructor(arity) {
+        this.src = new Array(arity);
+    }
+}
+export function isCursorMarker(x) {
+    return x === Entity || x === Iter;
+}
+export function wantsIter(x) {
+    return x === Iter;
+}
+/**
+ * Iterate `entities`, resolving injected components per the `forEach` /
+ * `each` argument grammar (bare callback, `[components]`, `Entity`/`Iter`
+ * cursor markers). Runs inside a deferred scope so mutations made by the
+ * callback are buffered and applied after iteration finishes.
+ *
+ * Shared by {@link Query.forEach} and {@link Group.forEach} so both honour the
+ * same injection and deferral semantics.
+ */
+export function forEachInjected(world, entities, arg0, arg1, arg2) {
+    world.beginDefer();
+    try {
+        // Bare `forEach(callback)`: a function that is not a cursor marker.
+        if (typeof arg0 === "function" && !isCursorMarker(arg0)) {
+            for (const entity of entities) {
+                arg0(entity);
+            }
+            return;
+        }
+        const useIter = wantsIter(arg0);
+        const components = (isCursorMarker(arg0) ? arg1 : arg0);
+        const callback = (isCursorMarker(arg0) ? arg2 : arg1);
+        const invoke = makeInjectedInvoker(world, components, useIter, callback);
+        for (const entity of entities) {
+            invoke(entity);
+        }
+    }
+    finally {
+        world.endDefer();
+    }
+}
+export function makeInjectedInvoker(world, components, useIter, callback) {
+    const inject = mapInject(world, components);
+    const arity = injectArity(inject);
+    const resolved = new Array(arity);
+    const down = _findSingleDownInject(inject);
+    if (down !== undefined) {
+        if (useIter) {
+            const it = new Iter(arity);
+            return (e) => {
+                const children = e._childrenByEid(down.relEid);
+                if (children === undefined) {
+                    return;
+                }
+                it.entity = e;
+                getInjectedWithSrcSkippingDown(e, inject, resolved, it.src);
+                children.forEach((child) => {
+                    fillDownInject(child, down.componentEids, down.slot, resolved, it.src);
+                    callback(it, resolved);
+                });
+            };
+        }
+        return (e) => {
+            const children = e._childrenByEid(down.relEid);
+            if (children === undefined) {
+                return;
+            }
+            getInjectedSkippingDown(e, inject, resolved);
+            children.forEach((child) => {
+                fillDownInject(child, down.componentEids, down.slot, resolved);
+                callback(e, resolved);
+            });
+        };
+    }
+    if (useIter) {
+        const it = new Iter(arity);
+        return (e) => {
+            it.entity = e;
+            getInjectedWithSrc(e, inject, resolved, it.src);
+            callback(it, resolved);
+        };
+    }
+    return (e) => {
+        getInjected(e, inject, false, resolved);
+        callback(e, resolved);
+    };
+}
+function _findSingleDownInject(inject) {
+    let found;
+    let slot = 0;
+    inject.forEach((term) => {
+        if (typeof term === "number") {
+            slot++;
+            return;
+        }
+        if ("up" in term) {
+            slot += term.up[1].length;
+            return;
+        }
+        if (found !== undefined) {
+            throw new Error("Only one down injection is supported per tuple");
+        }
+        found = { relEid: term.down[0], componentEids: term.down[1], slot };
+        slot += term.down[1].length;
+    });
+    return found;
+}
+function fillDownInject(child, componentEids, slot, out, src) {
+    componentEids.forEach((componentEid, offset) => {
+        const outIndex = slot + offset;
+        out[outIndex] = child.componentBitmask.has(componentEid) ? child._get(componentEid) : undefined;
+        if (src) {
+            src[outIndex] = child;
+        }
+    });
+}
+function getInjectedSkippingDown(e, inject, out) {
+    let outIndex = 0;
+    inject.forEach((term) => {
+        if (typeof term === "number") {
+            out[outIndex++] = e._get(term);
+            return;
+        }
+        if ("down" in term) {
+            outIndex += term.down[1].length;
+            return;
+        }
+        const target = e.componentBitmask.has(term.up[0])
+            ? e._get(term.up[0])?.target
+            : undefined;
+        term.up[1].forEach((componentEid) => {
+            out[outIndex++] = target?.componentBitmask.has(componentEid)
+                ? target._get(componentEid)
+                : undefined;
+        });
+    });
+}
+function getInjectedWithSrcSkippingDown(e, inject, out, src) {
+    let outIndex = 0;
+    inject.forEach((term) => {
+        if (typeof term === "number") {
+            out[outIndex] = e._get(term);
+            src[outIndex] = e;
+            outIndex++;
+            return;
+        }
+        if ("down" in term) {
+            outIndex += term.down[1].length;
+            return;
+        }
+        const target = e.componentBitmask.has(term.up[0])
+            ? e._get(term.up[0])?.target
+            : undefined;
+        term.up[1].forEach((componentEid) => {
+            out[outIndex] = target?.componentBitmask.has(componentEid)
+                ? target._get(componentEid)
+                : undefined;
+            src[outIndex] = target;
+            outIndex++;
+        });
+    });
+}
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

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

package/dist/module.d.ts

@@ -0,0 +1,23 @@
+import { Component } from "./component.js";
+import { type World } from "./world/index.js";
+/**
+ * Base class for built-in world modules.
+ *
+ * A `Module` is a special component entity that is registered by the world at
+ * construction time and performs one-time initialisation (registering
+ * components, setting up hooks, etc.) via its {@link init} method.
+ *
+ * User code does not instantiate `Module` subclasses directly; they are
+ * created and initialised by the world internally.
+ */
+export declare abstract class Module extends Component {
+    constructor(world: World, eid: number);
+    /**
+     * Initialise this module.
+     *
+     * Called once by the world after the module entity has been created and
+     * registered. Implementations should register components, attach hooks, and
+     * perform any other world-level setup required by the module.
+     */
+    abstract init(): void;
+}

package/dist/module.js

@@ -0,0 +1,17 @@
+import { Component } from "./component.js";
+/**
+ * Base class for built-in world modules.
+ *
+ * A `Module` is a special component entity that is registered by the world at
+ * construction time and performs one-time initialisation (registering
+ * components, setting up hooks, etc.) via its {@link init} method.
+ *
+ * User code does not instantiate `Module` subclasses directly; they are
+ * created and initialised by the world internally.
+ */
+export class Module extends Component {
+    constructor(world, eid) {
+        super(world, eid);
+    }
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;GASG;AACH,MAAM,OAAgB,MAAO,SAAQ,SAAS;IAC5C,YAAY,KAAY,EAAE,GAAW;QACnC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpB,CAAC;CAUF"}

package/dist/modules/identity.d.ts

@@ -0,0 +1,15 @@
+import { Module } from "../module.js";
+/**
+ * Built-in world module that maintains the name → entity index.
+ *
+ * Registers hooks on the `Identity` component so that whenever an entity's
+ * `name` is set or cleared, `world._identityNameIndex` is updated accordingly.
+ * This powers the string-overloads of {@link World.entity} and
+ * {@link World.getEntity} that resolve entities by name.
+ *
+ * Registered automatically by every {@link World}; user code does not interact
+ * with `IdentityModule` directly.
+ */
+export declare class IdentityModule extends Module {
+    init(): void;
+}

package/dist/modules/identity.js

@@ -0,0 +1,41 @@
+import { Identity } from "../entity/index.js";
+import { Module } from "../module.js";
+/**
+ * Built-in world module that maintains the name → entity index.
+ *
+ * Registers hooks on the `Identity` component so that whenever an entity's
+ * `name` is set or cleared, `world._identityNameIndex` is updated accordingly.
+ * This powers the string-overloads of {@link World.entity} and
+ * {@link World.getEntity} that resolve entities by name.
+ *
+ * Registered automatically by every {@link World}; user code does not interact
+ * with `IdentityModule` directly.
+ */
+export class IdentityModule extends Module {
+    init() {
+        const index = this.world._identityNameIndex;
+        const indexed = this.world._identityIndexedNames;
+        const component = this.world.component(Identity);
+        component.onSet((entity, identity) => {
+            const prev = indexed.get(entity);
+            if (prev !== undefined && index.get(prev) === entity) {
+                index.delete(prev);
+            }
+            if (identity.name) {
+                index.set(identity.name, entity);
+                indexed.set(entity, identity.name);
+            }
+            else {
+                indexed.delete(entity);
+            }
+        });
+        component.onRemove((entity) => {
+            const prev = indexed.get(entity);
+            if (prev !== undefined && index.get(prev) === entity) {
+                index.delete(prev);
+            }
+            indexed.delete(entity);
+        });
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/modules/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/modules/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAe,SAAQ,MAAM;IACjC,IAAI;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEjD,SAAS,CAAC,KAAK,CAAC,CAAC,MAAc,EAAE,QAAkB,EAAE,EAAE;YACrD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEjC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACrD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAED,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAc,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEjC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACrD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/modules/singleton.d.ts

@@ -0,0 +1,26 @@
+import { Module } from "../module.js";
+/**
+ * Marker component used to tag a component class as a singleton.
+ *
+ * Attach it to a component entity to make that component class a singleton: at
+ * most one entity in the world may hold the component at any time. Attempting
+ * to add the component to a second entity throws.
+ *
+ * ```ts
+ * world.component(Gravity).add(Singleton); // Gravity is now a singleton
+ * ```
+ *
+ * The constraint itself is enforced by {@link SingletonModule}.
+ */
+export declare class Singleton {
+}
+/**
+ * Built-in world module that enforces the singleton constraint.
+ *
+ * Registered automatically by every {@link World}. When a component entity has
+ * the `Singleton` component attached, the module installs an `onAdd` hook on
+ * that component class so that adding it to more than one entity throws.
+ */
+export declare class SingletonModule extends Module {
+    init(): void;
+}

package/dist/modules/singleton.js

@@ -0,0 +1,41 @@
+import { Module } from "../module.js";
+/**
+ * Marker component used to tag a component class as a singleton.
+ *
+ * Attach it to a component entity to make that component class a singleton: at
+ * most one entity in the world may hold the component at any time. Attempting
+ * to add the component to a second entity throws.
+ *
+ * ```ts
+ * world.component(Gravity).add(Singleton); // Gravity is now a singleton
+ * ```
+ *
+ * The constraint itself is enforced by {@link SingletonModule}.
+ */
+export class Singleton {
+}
+/**
+ * Built-in world module that enforces the singleton constraint.
+ *
+ * Registered automatically by every {@link World}. When a component entity has
+ * the `Singleton` component attached, the module installs an `onAdd` hook on
+ * that component class so that adding it to more than one entity throws.
+ */
+export class SingletonModule extends Module {
+    init() {
+        this.world.component(Singleton);
+        this.world.component(Singleton).onAdd((target) => {
+            const targetMeta = target.ownMeta;
+            if (targetMeta.usageCount !== 0) {
+                throw new Error(`Cannot make component ${targetMeta.Class.name} singleton; ${targetMeta.usageCount} instance(s) already exist`);
+            }
+            targetMeta.onAdd((entity) => {
+                if (entity !== target || targetMeta.usageCount !== 1) {
+                    throw new Error(`Cannot add singleton component ${targetMeta.Class.name} to entity ${entity.eid}; singleton instance is entity ${target.eid}`);
+                }
+            });
+            target.add(target);
+        });
+    }
+}
+//# sourceMappingURL=singleton.js.map

package/dist/modules/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/modules/singleton.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,SAAS;CAAG;AAEzB;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,MAAM;IAClC,IAAI;QACT,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAEhC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,MAAc,EAAQ,EAAE;YAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;YAClC,IAAI,UAAU,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,CAAC,KAAK,CAAC,IAAI,eAAe,UAAU,CAAC,UAAU,4BAA4B,CAC/G,CAAC;YACJ,CAAC;YAED,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC1B,IAAI,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;oBACrD,MAAM,IAAI,KAAK,CACb,kCAAkC,UAAU,CAAC,KAAK,CAAC,IAAI,cAAc,MAAM,CAAC,GAAG,kCAAkC,MAAM,CAAC,GAAG,EAAE,CAC9H,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/package.json

@@ -1,32 +1,30 @@
 {
   "name": "@vworlds/vecs",
-  "version": "1.0.14",
+  "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 && rimraf tsconfig.tsbuildinfo",
-    "prepack": "yarn build",
-    "build": "yarn clean && yarn compile",
-    "compile": "tsc --build && cp \"./package.json\" ./dist/",
+    "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/ tests/",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" --no-error-on-unmatched-pattern",
     "typecheck": "tsc --noEmit",
-    "format:check": "prettier --check \"**/*.{ts,md}\"",
-    "prepare": "husky"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.59.1",
-    "@typescript-eslint/parser": "^8.59.1",
-    "eslint": "^10.2.1",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
-    "prettier": "^3.8.3",
-    "rimraf": "^5.0.0",
-    "typescript": "^4.8.4",
-    "vitest": "^1.6.0"
+    "format:check": "prettier --check \"**/*.{ts,md}\""
   },
   "dependencies": {
     "eventemitter3": "^4.0.7"

package/dist/phase.d.ts

@@ -1,4 +1,4 @@
-import { type World } from "./world.js";
+import { type World } from "./world/index.js";
 /**
  * Public interface for a pipeline phase, returned by {@link World.addPhase}.
  *
@@ -12,7 +12,7 @@ import { type World } from "./world.js";
  * world.system("NetworkUpdate").phase(preUpdate).run(tick);
  *
  * // each frame:
- * world.beginFrame(now, delta);
+ * world.beginFrame(delta);
  * try {
  *   world.runPhase(preUpdate, now, delta);
  *   world.runPhase(send,      now, delta);

package/dist/query/index.d.ts

@@ -0,0 +1,6 @@
+export { Query, GroupedQuery } from "./query.js";
+export { Group, Grouping } from "./query.07.groups.js";
+export { _setGroupedQueryCtor, SOURCE_TRACKED_QUERY_ERROR } from "./query.00.base.js";
+export type { EntityTestFunc, MaybeRequired, QueryDSL } from "../dsl.js";
+export { Iter } from "../inject.js";
+export type { DownInject, FanInjectElement, FanInjectTuple, InjectElement, InjectTuple, MaybeResolvedInjectTuple, RequiredResolvedInjectTuple, UpInject, } from "../inject.js";

package/dist/query/index.js

@@ -0,0 +1,5 @@
+export { Query, GroupedQuery } from "./query.js";
+export { Group, Grouping } from "./query.07.groups.js";
+export { _setGroupedQueryCtor, SOURCE_TRACKED_QUERY_ERROR } from "./query.00.base.js";
+export { Iter } from "../inject.js";
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/dist/query/query.00.base.d.ts

@@ -0,0 +1,23 @@
+import { type ComponentType } from "../component.js";
+import { Entity } from "../entity/index.js";
+import { type World } from "../world/index.js";
+import { type Term } from "../terms/term.js";
+export declare const SOURCE_TRACKED_QUERY_ERROR = "source/children is not supported in a tracked query; use world.filter(...)";
+export declare const EMPTY_ENTITIES: ReadonlySet<Entity>;
+export declare function _setGroupedQueryCtor(ctor: new (...args: any[]) => any): void;
+export declare function _getGroupedQueryCtor(): new (...args: any[]) => any;
+export declare class Base<R extends ComponentType[] = []> {
+    /** Entity that stores this query as a component and carries query traits. */
+    readonly entity: Entity;
+    /** Materialized root term that owns membership for this query. */
+    rootTerm: Term | undefined;
+    constructor(name: string, world: World, componentClass: ComponentType, track?: boolean);
+    /** `true` once this query has been registered with its world. */
+    get built(): boolean;
+    /** Unique display name; forwards to the backing entity identity. */
+    get name(): string | undefined;
+    /** World that owns this query; forwards to the backing entity. */
+    get world(): World;
+    /** Returns the query name. */
+    toString(): string;
+}

package/dist/query/query.00.base.js

@@ -0,0 +1,77 @@
+import { ArrayMap } from "../util/array_map.js";
+import { Bitset } from "../util/bitset.js";
+export const SOURCE_TRACKED_QUERY_ERROR = "source/children is not supported in a tracked query; use world.filter(...)";
+export const EMPTY_ENTITIES = new Set();
+let _GroupedQueryCtor;
+export function _setGroupedQueryCtor(ctor) {
+    _GroupedQueryCtor = ctor;
+}
+export function _getGroupedQueryCtor() {
+    return _GroupedQueryCtor;
+}
+export class Base {
+    constructor(name, world, componentClass, track = true) {
+        /** @internal `true` once `query` or `requires` has set an explicit predicate. */
+        this._hasExplicitQuery = false;
+        /** @internal DSL predicate used to build the root membership term. */
+        this._dsl = undefined;
+        /** @internal `true` once this query has been registered with its world. */
+        this._built = false;
+        /** @internal Guards destroy hooks against recursive removal. */
+        this._destroyed = false;
+        /** @internal Whether membership APIs are enabled for this query. */
+        this._tracking = false;
+        /** @internal `enter` callback (already wraps any injection logic). */
+        this._enterCallback = undefined;
+        /** @internal `exit` callback (already wraps any injection logic). */
+        this._exitCallback = undefined;
+        /** @internal Component eids the exit callback needs snapshotted before component removal. */
+        this._exitSnapshotTypes = undefined;
+        /** @internal Per-component-eid `update` callbacks. */
+        this._componentUpdateCallbacks = new ArrayMap();
+        /** @internal Bitmask of component eids this query reacts to via `update`. */
+        this._watchlistBitmask = new Bitset();
+        this._queryComponentClass = componentClass;
+        this.entity = world.entity();
+        this.entity.name = name;
+        this.entity.attach(componentClass, this);
+        world._addUnbuiltQuery(this);
+        if (track) {
+            this.track();
+        }
+    }
+    /** @internal Throw when a builder method is called after registration. */
+    _assertConfigurable() {
+        if (this.built) {
+            throw new Error(`query '${this.name}' has already been built`);
+        }
+    }
+    /** @internal Whether this object has enough configuration to enter the world. */
+    _isBuildable() {
+        return this._dsl !== undefined;
+    }
+    /** `true` once this query has been registered with its world. */
+    get built() {
+        return this._built;
+    }
+    /** Unique display name; forwards to the backing entity identity. */
+    get name() {
+        return this.entity.name;
+    }
+    /** World that owns this query; forwards to the backing entity. */
+    get world() {
+        return this.entity.world;
+    }
+    /** Returns the query name. */
+    toString() {
+        return this.name ?? "";
+    }
+    /** @internal */
+    _matchedEntities() {
+        if (!this._tracking) {
+            return EMPTY_ENTITIES;
+        }
+        return this._entities ?? this.rootTerm ?? EMPTY_ENTITIES;
+    }
+}
+//# sourceMappingURL=query.00.base.js.map