@daneren2005/shared-memory-ecs 1.7.2 → 1.8.1

package/dist/systems/entity-system.d.ts

@@ -2,6 +2,7 @@ import type BaseWorld from '../world';
 import type BaseEntity from '../entity';
 import type { ComponentDefinitionMap, ComponentMap } from '../component-definition';
 import IterableSystem, { type IterableSystemConfig } from './iterable-system';
+import { type EntityBatch } from './system';
 export default abstract class EntitySystem<C extends ComponentMap, T extends BaseEntity<C> = BaseEntity<C>> extends IterableSystem<C, T> {
     entities: Map<number, T>;
     options: EntitySystemConfig<C>;
@@ -12,6 +13,9 @@ export default abstract class EntitySystem<C extends ComponentMap, T extends Bas
     protected getIterableEntityId(entity: T): number;
     isEntityInSystem(entity: BaseEntity<C>): boolean;
     abstract updateEntity(entity: T, elapsedTime: number): void;
+    private onEntityAdded;
+    addEntities(batch: EntityBatch<C>): void;
+    private hasComponents;
     checkAddEntity(entity: BaseEntity<C>): boolean;
     removeEntity(entity: BaseEntity<C>): void;
     shouldRun(): boolean;

package/dist/systems/entity-worker-system.d.ts

@@ -3,7 +3,7 @@ import type BaseWorld from '../world';
 import type BaseEntity from '../entity';
 import type { BaseComponent, ComponentDefinitionMap, ComponentMap } from '../component-definition';
 import type { ComponentTypedArray } from '../memory-component';
-import System, { type SystemConfig } from './system';
+import System, { type EntityBatch, type SystemConfig } from './system';
 import EntitySystemWebWorker from './workers/entity-system-web-worker';
 export default abstract class EntityWorkerSystem<C extends ComponentMap, T extends EntityUpdateComponents<C>, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> extends System<C> {
     entities: Map<number, BaseEntity<C>>;
@@ -35,11 +35,15 @@ export default abstract class EntityWorkerSystem<C extends ComponentMap, T exten
     private buildComponents;
     isEntityInSystem(entity: BaseEntity<C>): boolean;
     protected matchesQuery(entity: BaseEntity<C>, query: EntityWorkerSystemQuery<C>): boolean;
+    private matchesComponents;
     private getQueryDelta;
     private markAdded;
     private markRemoved;
     protected updateEntityList(queryName: string, list: Map<number, BaseEntity<C>>, entity: BaseEntity<C>, shouldInclude: boolean): void;
+    protected get tracksMainQuery(): boolean;
     checkAddEntity(entity: BaseEntity<C>): boolean;
+    addEntities(batch: EntityBatch<C>): void;
+    private addBatchToQuery;
     removeEntity(entity: BaseEntity<C>): void;
     recheckMembership(): void;
     shouldRun(): boolean;
@@ -56,12 +60,14 @@ export type EntityQueryComponents<C extends ComponentMap = ComponentMap> = {
 };
 type EntityUpdateFunctionImpl<C extends ComponentMap, T extends EntityUpdateComponents<C>, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld> = (world: W, entityId: number, components: T, queries: EntityQueryComponents<C>, callbacks: EntityWorkerSystemCallbacks<C>) => void;
 export type EntityUpdateFunction<C extends ComponentMap, T extends EntityUpdateComponents<C>, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> = EntityUpdateFunctionImpl<C, T, W> & {
+    queryChanged?: EntityQueryChangedFunction<C, W>;
     preRun?: EntityUpdatePreRunFunction<C, T, W>;
     entityRemoved?: EntityRemovedFunction<C, W>;
     init?: EntityUpdateInitFunction<W, D>;
 };
 export type EntityUpdateInitFunction<W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> = (data: D | undefined) => Partial<W> | void;
 export type EntityUpdatePreRunFunction<C extends ComponentMap, T extends EntityUpdateComponents<C>, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld> = (world: W, entities: Array<UpdateEntityConfigObject<T>>, queries: EntityQueryComponents<C>, callbacks: EntityWorkerSystemCallbacks<C>) => void;
+export type EntityQueryChangedFunction<C extends ComponentMap = ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld> = (world: W, queryName: string, delta: QueryDelta<EntityUpdateComponents<C>>, callbacks: EntityWorkerSystemCallbacks<C>) => void;
 export type EntityRemovedFunction<C extends ComponentMap = ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld> = (world: W, entityId: number, callbacks: EntityWorkerSystemCallbacks<C>) => void;
 export type UpdateEntityConfig<T extends EntityUpdateComponents = EntityUpdateComponents> = number | UpdateEntityConfigObject<T>;
 export type UpdateEntityConfigObject<T extends EntityUpdateComponents> = {

package/dist/systems/system.d.ts

@@ -1,5 +1,6 @@
 import { EventEmitter } from 'eventemitter3';
 import type BaseWorld from '../world';
+import type BaseEntity from '../entity';
 import type { ComponentDefinitionMap, ComponentMap } from '../component-definition';
 export default abstract class System<C extends ComponentMap = ComponentMap> extends EventEmitter {
     world: BaseWorld<ComponentDefinitionMap, C>;
@@ -11,6 +12,7 @@ export default abstract class System<C extends ComponentMap = ComponentMap> exte
     init(): void | Promise<void>;
     clear(): void;
     finishLoading(): void | Promise<void>;
+    addEntities(batch: EntityBatch<C>): void;
     update(elapsedTime: number): boolean;
     abstract run(elapsedTime: number): void;
     protected onError(error: Error, context?: {
@@ -23,12 +25,18 @@ export default abstract class System<C extends ComponentMap = ComponentMap> exte
     shouldRun(): boolean;
     destroy(): void;
 }
+export interface EntityBatch<C extends ComponentMap = ComponentMap> {
+    entities: Array<BaseEntity<C>>;
+    groupIndexes: Array<number>;
+    groups: Array<BaseEntity<C>>;
+}
+export declare function forEachInMatchingGroups<C extends ComponentMap>(batch: EntityBatch<C>, matchesGroup: (representative: BaseEntity<C>) => boolean, callback: (entity: BaseEntity<C>) => void): void;
 export interface SystemConfig {
     name: string;
     deltaBetweenRuns?: number;
     firstRun?: boolean;
 }
-export type SystemErrorPhase = 'preRun' | 'update' | 'entityRemoved' | 'run' | 'died';
+export type SystemErrorPhase = 'queryChanged' | 'preRun' | 'update' | 'entityRemoved' | 'run' | 'died';
 export interface SystemError {
     system: string;
     error: Error;

package/dist/systems/worker-system.d.ts

@@ -1,12 +1,11 @@
 import type BaseWorld from '../world';
-import type BaseEntity from '../entity';
 import type { ComponentDefinitionMap, ComponentMap } from '../component-definition';
 import type { SystemConfig } from './system';
 import EntityWorkerSystem, { type EntityWorkerSystemQuery, type EntityWorkerSystemWorld, type EntityUpdateComponents } from './entity-worker-system';
 import { type WorkerSystemRunFunction } from './workers/create-system-worker';
 export default class WorkerSystem<C extends ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> extends EntityWorkerSystem<C, EntityUpdateComponents<C>, W, D> {
     constructor(world: BaseWorld<ComponentDefinitionMap, C>, options: WorkerSystemConfig<C, W, D>);
-    checkAddEntity(entity: BaseEntity<C>): boolean;
+    protected get tracksMainQuery(): boolean;
     shouldRun(): boolean;
 }
 export interface WorkerSystemConfig<C extends ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> extends SystemConfig {

package/dist/systems/workers/create-system-worker.d.ts

@@ -1,8 +1,9 @@
 import { type EntitySystemWorkerScope } from './create-entity-system-worker';
 import type { ComponentDefinitionMap, ComponentMap } from '../../component-definition';
-import type { EntityWorkerSystemCallbacks, EntityWorkerSystemWorld, EntityQueryComponents, EntityUpdateComponents, EntityUpdateFunction, EntityUpdateInitFunction, EntityRemovedFunction } from '../entity-worker-system';
+import type { EntityWorkerSystemCallbacks, EntityWorkerSystemWorld, EntityQueryComponents, EntityUpdateComponents, EntityUpdateFunction, EntityUpdateInitFunction, EntityRemovedFunction, EntityQueryChangedFunction } from '../entity-worker-system';
 export type WorkerSystemRunFunction<C extends ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown> = ((world: W, queries: EntityQueryComponents<C>, callbacks: EntityWorkerSystemCallbacks<C>) => void) & {
     init?: EntityUpdateInitFunction<W, D>;
+    queryChanged?: EntityQueryChangedFunction<C, W>;
     entityRemoved?: EntityRemovedFunction<C, W>;
 };
 export declare function toEntityUpdateFunction<C extends ComponentMap, W extends EntityWorkerSystemWorld = EntityWorkerSystemWorld, D = unknown>(run: WorkerSystemRunFunction<C, W, D>): EntityUpdateFunction<C, EntityUpdateComponents<C>, W, D>;

package/dist/systems/workers/entity-system-worker-message.d.ts

@@ -49,7 +49,7 @@ export interface EntityEvent {
 }
 export interface WorkerRunError {
     error: Error;
-    phase: 'preRun' | 'update' | 'entityRemoved';
+    phase: 'queryChanged' | 'preRun' | 'update' | 'entityRemoved';
     entityId?: number;
 }
 export type SystemEvents = {

package/dist/worker.d.ts

@@ -9,4 +9,4 @@ export { default as killEntityWorker } from './actions/kill-entity-worker';
 export { CLASS_INDEX, DEAD_INDEX, TYPE_INDEX } from './entity-component';
 export type { default as EntitySystemWorkerMessage } from './systems/workers/entity-system-worker-message';
 export type { EntityEvent, SystemEvents } from './systems/workers/entity-system-worker-message';
-export type { EntityWorkerSystemWorld, EntityWorkerSystemCallbacks, WorkerAllocator, WorkerCreateEntityConfig, WorkerCreatedEntity, WorkerCreatedComponent, WorkerComponentChange, EntityUpdateComponents, EntityQueryComponents, EntityUpdateFunction, EntityUpdateInitFunction, EntityUpdatePreRunFunction, EntityRemovedFunction, UpdateEntityConfigObject, } from './systems/entity-worker-system';
+export type { EntityWorkerSystemWorld, EntityWorkerSystemCallbacks, WorkerAllocator, WorkerCreateEntityConfig, WorkerCreatedEntity, WorkerCreatedComponent, WorkerComponentChange, EntityUpdateComponents, EntityQueryComponents, EntityUpdateFunction, EntityUpdateInitFunction, EntityUpdatePreRunFunction, EntityQueryChangedFunction, QueryDelta, EntityRemovedFunction, UpdateEntityConfigObject, } from './systems/entity-worker-system';

package/dist/worker.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, i as r, l as i, o as a, r as o, s, t as c } from "./create-system-worker-CDQmmww7.js";
+import { a as e, c as t, d as n, i as r, l as i, o as a, r as o, s, t as c } from "./create-system-worker-C4aS3-3R.js";
 export { t as CLASS_INDEX, i as DEAD_INDEX, n as TYPE_INDEX, e as addComponentWorker, o as createEntitySystemWorker, a as createEntityWorker, c as createSystemWorker, s as killEntityWorker, r as removeComponentWorker };

package/dist/world.d.ts

@@ -43,6 +43,7 @@ export default class BaseWorld<R extends ComponentDefinitionMap = ComponentDefin
     paused: boolean;
     destroyed: boolean;
     pristine: boolean;
+    isBulkLoading: boolean;
     private activeFreeBuffer;
     private nextFreeBuffer;
     constructor(registry: R, options?: WorldOptions<C, Cfg, E>);

package/package.json

@@ -2,9 +2,10 @@
 	"name": "@daneren2005/shared-memory-ecs",
 	"description": "A small, reusable Entity/Component/System core backed by shared memory.",
 	"author": "Scott Jackson",
-	"version": "1.7.2",
+	"version": "1.8.1",
 	"type": "module",
 	"sideEffects": false,
+	"license": "MIT",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/daneren2005/shared-memory-ecs.git"
@@ -61,17 +62,17 @@
 	"devDependencies": {
 		"@semantic-release/git": "^10.0.1",
 		"@stylistic/eslint-plugin": "^5.10.0",
-		"@types/node": "^26.1.1",
-		"@vitest/web-worker": "^4.1.10",
+		"@types/node": "^26.6.1",
+		"@vitest/web-worker": "^5.0.1",
 		"cross-env": "^10.1.0",
 		"husky": "^9.1.7",
-		"lint-staged": "^17.0.8",
-		"oxlint": "^1.73.0",
-		"oxlint-tsgolint": "^0.24.0",
-		"semantic-release": "^25.0.6",
+		"lint-staged": "^17.5.1",
+		"oxlint": "^1.83.0",
+		"oxlint-tsgolint": "^7.0.2001",
+		"semantic-release": "^25.0.9",
 		"typescript": "^7.0.2",
-		"vite": "^8.1.4",
-		"vitest": "^4.1.10"
+		"vite": "^8.3.0",
+		"vitest": "^5.0.1"
 	},
 	"peerDependencies": {
 		"@daneren2005/shared-memory-objects": "^1.5.2"