@draug/engine 1.0.18 → 1.0.20

package/dist/index.cjs

@@ -51,9 +51,9 @@ __export(index_exports, {
   PluginBase: () => PluginBase,
   PluginError: () => PluginError,
   PluginsManager: () => PluginsManager,
+  Resource: () => Resource,
   ResourcesManager: () => ResourcesManager,
   Runtime: () => Runtime,
-  SingletonStorage: () => SingletonStorage,
   System: () => System,
   SystemBase: () => SystemBase,
   SystemError: () => SystemError,
@@ -65,6 +65,7 @@ __export(index_exports, {
   createEventKey: () => createEventKey,
   entry: () => entry,
   getPluginMetadata: () => getPluginMetadata,
+  getResourceMetadata: () => getResourceMetadata,
   getSystemMetadata: () => getSystemMetadata,
   isPlugin: () => isPlugin,
   isSystem: () => isSystem,
@@ -149,7 +150,8 @@ function System(props) {
     const requiredComponents = new Set(props.requiredComponents);
     const computeAfter = new Set(props.computeAfter);
     const phase = props.phase ?? 1 /* MAIN */;
-    const metadata = { query, requiredComponents, computeAfter, phase };
+    const name = props.name ?? target.name;
+    const metadata = { query, requiredComponents, computeAfter, phase, name };
     systemTarget[SystemMetadataSymbol] = metadata;
   };
 }
@@ -195,7 +197,8 @@ var SystemsManager = class {
       this.requiredComponents_.add(c);
     for (const c of requiredComponents)
       this.requiredComponents_.add(c);
-    this.logger.debug(() => `[Systems]: "${ctor.name}" was registered`);
+    const meta = getSystemMetadata(ctor);
+    this.logger.debug(() => `[Systems]: system "${meta.name}" was registered`);
   }
   build() {
     this.buildSystemsArray();
@@ -214,7 +217,7 @@ var SystemsManager = class {
       throw new Error("System not registered");
     return s;
   }
-  update(dt) {
+  update(time) {
     if (this.dirty_)
       this.rebuild();
     this.world.events.swapAll();
@@ -224,7 +227,7 @@ var SystemsManager = class {
       s.compute({
         world: this.world,
         entities,
-        dt,
+        time,
         logger: this.logger
       });
     }
@@ -311,7 +314,7 @@ var EntityRef = class {
 
 // src/ecs/constant.ts
 var ECS_DEFAULTS = {
-  MAX_ENTITY_COUNT: Math.pow(2, 16)
+  MAX_ENTITY_COUNT: Math.pow(2, 12)
 };
 
 // src/ecs/events-buffer.ts
@@ -376,17 +379,16 @@ var ObjectPool = class {
   pool_;
   factory_;
   cursor_;
-  constructor(factory, initialSize = 1024) {
+  constructor(factory, initialSize = 0) {
     this.pool_ = new Array(initialSize);
-    for (let i = 0; i < initialSize; i++) {
-      this.pool_[i] = factory();
-    }
     this.factory_ = factory;
     this.cursor_ = initialSize - 1;
   }
   acquire() {
-    if (this.cursor_ < 0) this.grow();
-    return this.pool_[this.cursor_--];
+    if (this.cursor_ >= 0) {
+      return this.pool_[this.cursor_--];
+    }
+    return this.factory_();
   }
   release(obj) {
     this.pool_[++this.cursor_] = obj;
@@ -402,17 +404,18 @@ var ObjectPool = class {
 
 // src/ecs/components/component-storage.ts
 var import_bitmap_index = require("bitmap-index");
-var import_ts_sparse_set = require("ts-sparse-set");
 var ComponentStorage = class {
   bits_;
-  set_;
+  data_ = [];
+  entityIds_ = [];
+  indexMap_ = /* @__PURE__ */ new Map();
   pool_;
   id_ = 0;
+  size_ = 0;
   cls;
   constructor(cap = ECS_DEFAULTS.MAX_ENTITY_COUNT, factory, cls) {
-    this.set_ = new import_ts_sparse_set.SparseSet(cap);
     this.bits_ = new import_bitmap_index.Bitmap(cap);
-    this.pool_ = new ObjectPool(factory, cap);
+    this.pool_ = new ObjectPool(factory, 0);
     this.cls = cls;
   }
   bitmap() {
@@ -425,99 +428,103 @@ var ComponentStorage = class {
     return this.id_ = id2;
   }
   add(id2, initFn) {
+    if (this.indexMap_.has(id2)) {
+      throw new Error(`[ComponentStorage "${this.cls.name}"]: Entity ${id2} already has this component`);
+    }
     const obj = this.pool_.acquire();
     initFn?.(obj);
-    const value = this.set_.add(id2, obj);
+    const index = this.data_.length;
+    this.data_.push(obj);
+    this.entityIds_.push(id2);
+    this.indexMap_.set(id2, index);
     this.bits_.set(id2);
-    return value;
+    this.size_++;
+    return obj;
   }
   remove(id2) {
-    const obj = this.set_.get(id2);
-    if (!obj) return;
+    const index = this.indexMap_.get(id2);
+    if (index === void 0) return;
     this.bits_.remove(id2);
-    this.pool_.release(obj);
-    this.set_.remove(id2);
+    const lastIndex = this.data_.length - 1;
+    const lastEntityId = this.entityIds_[lastIndex];
+    const removedObj = this.data_[index];
+    if (index !== lastIndex) {
+      this.data_[index] = this.data_[lastIndex];
+      this.entityIds_[index] = lastEntityId;
+      this.indexMap_.set(lastEntityId, index);
+    }
+    this.data_.pop();
+    this.entityIds_.pop();
+    this.indexMap_.delete(id2);
+    this.pool_.release(removedObj);
+    this.size_--;
   }
   get(id2) {
-    return this.set_.get(id2);
+    const index = this.indexMap_.get(id2);
+    return index !== void 0 ? this.data_[index] : null;
   }
   tryGet(id2) {
-    const x = this.set_.get(id2);
-    if (!x)
+    const index = this.indexMap_.get(id2);
+    if (index === void 0)
       throw new Error(`[ComponentStorage "${this.cls.name}"]: Requesting non-existing item with ID ${id2}.`);
-    return x;
+    return this.data_[index];
   }
   writeComponentsToBuf(ids, out) {
     let len = 0;
     for (const id2 of ids) {
-      const obj = this.set_.get(id2);
-      if (obj !== null) out[len++] = obj;
+      const index = this.indexMap_.get(id2);
+      if (index !== void 0) out[len++] = this.data_[index];
     }
     return len;
   }
   has(id2) {
     return this.bits_.contains(id2);
   }
-  entityIds() {
-    return Array.from(this.bits_);
-  }
   size() {
-    return this.bits_.count();
+    return this.size_;
   }
   forEach(cb) {
-    this.bits_.range((x) => cb(x));
+    for (const id2 of this.entityIds_) {
+      cb(id2);
+    }
   }
 };
 
-// src/ecs/components/singleton-storage.ts
-var SingletonStorage = class {
-  constructor(factory) {
-    this.factory = factory;
-  }
-  factory;
-  value = null;
-  entityId = null;
-  bitmap() {
-    throw new Error("Singletone component cannot has a bitmap!");
-  }
-  add(id2, initFn) {
-    if (this.value !== null)
-      throw new Error("Singleton already initiated");
-    this.entityId = id2;
-    this.value = this.factory();
-    initFn?.(this.value);
-    return this.value;
-  }
-  remove(id2) {
-    if (!this.validateId(id2))
-      return;
-    this.value = null;
-    this.entityId = null;
-  }
-  get(id2) {
-    if (!this.validateId(id2))
-      return null;
-    return this.value;
-  }
-  tryGet(id2) {
-    if (!this.validateId(id2))
-      throw new Error("[SingletoneStorage]: ID missmatch.");
-    return this.value;
-  }
-  has(id2) {
-    return this.validateId(id2);
-  }
-  size() {
-    return this.value !== null ? 1 : 0;
-  }
-  forEach(cb) {
-    if (this.entityId !== null)
-      cb(this.entityId);
+// src/ecs/components/utils.ts
+var registry = /* @__PURE__ */ new Map();
+var id = 0;
+var ComponentMetadataSymbol = /* @__PURE__ */ Symbol("component");
+function Component(options) {
+  return (target) => {
+    const metadata = {
+      name: options.name,
+      id: ++id
+    };
+    registry.set(target, metadata.id);
+    target[ComponentMetadataSymbol] = metadata;
+  };
+}
+function getComponentId(ctor) {
+  const id2 = registry.get(ctor);
+  if (id2 === void 0) {
+    throw new Error(`Component not registered: ${ctor.name}`);
   }
-  validateId(id2) {
-    return this.entityId !== null && id2 === this.entityId;
+  return id2;
+}
+var ErrNotComponent = class extends Error {
+  constructor(ctor) {
+    super(`Class ${ctor.name} is not a Component. Use @Component decorator to define components.`);
   }
 };
+function getComponentMetadata(component) {
+  if (isComponent(component)) {
+    return component[ComponentMetadataSymbol];
+  }
+  throw new ErrNotComponent(component);
+}
+function isComponent(ctor) {
+  return ComponentMetadataSymbol in ctor;
+}
 
 // src/ecs/components/manager.ts
 var ComponentAlreadyRegisteredError = class extends Error {
@@ -526,9 +533,11 @@ var ComponentAlreadyRegisteredError = class extends Error {
   }
 };
 var ComponentsManager = class {
-  constructor(maxEntityCount = ECS_DEFAULTS.MAX_ENTITY_COUNT) {
+  constructor(logger, maxEntityCount = ECS_DEFAULTS.MAX_ENTITY_COUNT) {
+    this.logger = logger;
     this.maxEntityCount = maxEntityCount;
   }
+  logger;
   maxEntityCount;
   storages_ = /* @__PURE__ */ new Map();
   currId_ = 0;
@@ -538,19 +547,10 @@ var ComponentsManager = class {
   register(component, opts) {
     if (this.storages_.has(component))
       return this.storages_.get(component);
-    let store;
-    switch (opts?.storageType) {
-      case 2 /* SINGLETON_STORAGE */:
-        store = this.createSingletonStore(opts);
-        break;
-      case 1 /* COMPONENT_STORAGE */:
-        store = this.createComponentStore(component, opts);
-        break;
-      default:
-        store = this.createComponentStore(component, opts);
-        break;
-    }
+    const store = this.createComponentStore(component, opts);
     this.storages_.set(component, store);
+    const meta = getComponentMetadata(component);
+    this.logger.debug(() => `[Components]: Registered component "${meta.name}"`);
     return store;
   }
   createComponentStore(component, opts) {
@@ -559,12 +559,6 @@ var ComponentsManager = class {
     store._internalSetId(this.nextId());
     return store;
   }
-  createSingletonStore(opts) {
-    if (!opts?.factory) {
-      throw new Error("For singletone storage provide factory is required!");
-    }
-    return new SingletonStorage(opts.factory);
-  }
   getStorage(component) {
     const store = this.storages_.get(component);
     if (store === void 0)
@@ -576,24 +570,30 @@ var ComponentsManager = class {
   }
 };
 
-// src/ecs/components/utils.ts
-var registry = /* @__PURE__ */ new Map();
-var id = 0;
-function Component() {
+// src/ecs/resources/resources.ts
+var ResourceMetadataSymbol = /* @__PURE__ */ Symbol("resource");
+function Resource(params) {
   return (target) => {
-    if (registry.has(target)) return;
-    registry.set(target, ++id);
+    const metadata = {
+      name: params.name
+    };
+    target[ResourceMetadataSymbol] = metadata;
   };
 }
-function getComponentId(ctor) {
-  const id2 = registry.get(ctor);
-  if (id2 === void 0) {
-    throw new Error(`Component not registered: ${ctor.name}`);
+var ErrNotResource = class extends Error {
+  constructor(ctor) {
+    super(`Class ${ctor.name} is not a Resource. Use @Resource decorator to define resources.`);
   }
-  return id2;
+};
+function getResourceMetadata(resource) {
+  if (isResource(resource)) {
+    return resource[ResourceMetadataSymbol];
+  }
+  throw new ErrNotResource(resource);
+}
+function isResource(ctor) {
+  return ResourceMetadataSymbol in ctor;
 }
-
-// src/ecs/resources/resources.ts
 var ResourcesManager = class {
   constructor(logger) {
     this.logger = logger;
@@ -602,13 +602,15 @@ var ResourcesManager = class {
   items_ = /* @__PURE__ */ new Map();
   insert(type, value) {
     this.items_.set(type, value);
-    this.logger.debug(() => `[Resources]: Inserted new Resource "${type.name}"`);
+    const metadata = getResourceMetadata(type);
+    this.logger.debug(() => `[Resources]: Inserted new Resource "${metadata.name}"`);
     return value;
   }
   get(type) {
     const value = this.items_.get(type);
+    const meta = getResourceMetadata(type);
     if (!value)
-      throw new Error(`Resource of class ${type.name} does not exist!`);
+      throw new Error(`Resource of class ${meta.name} does not exist!`);
     return value;
   }
   getOrInsert(type, factory) {
@@ -620,7 +622,8 @@ var ResourcesManager = class {
     return value;
   }
   remove(type) {
-    this.logger.debug(() => `[Resources]: Removed resource "${type.name}"`);
+    const meta = getResourceMetadata(type);
+    this.logger.debug(() => `[Resources]: Removed resource "${meta.name}"`);
     this.items_.delete(type);
   }
 };
@@ -654,7 +657,10 @@ var Commands = class {
       }
     };
     this.add(cmd);
-    this.logger.debug(() => `[Commands.createEntity]: Created new entity with ID ${id2}. Linked components: [${entries.map((x) => x[0].name).join(", ")}]`);
+    this.logger.debug(() => {
+      const components = entries.map((x) => getComponentMetadata(x[0]).name).join(", ");
+      return `[Commands.createEntity]: Created new entity with ID ${id2}. Linked components: [${components}]`;
+    });
     return id2;
   }
 };
@@ -854,30 +860,33 @@ var PluginsManager = class {
     if (!isPlugin(plugin))
       throw new ErrMissingPluginMetadata(plugin);
     const metadata = getPluginMetadata(plugin);
-    if (this.plugins_.has(metadata.id))
+    if (this.plugins_.has(plugin))
       return;
     const entry2 = {
       ctor: plugin,
       ctorParams: constructorProps,
       metadata
     };
-    this.plugins_.set(metadata.id, entry2);
+    this.plugins_.set(plugin, entry2);
     this.logger.debug(() => `[Plugins]: Installed plugin ${metadata.name} (${metadata.version})`);
   }
   build() {
+    if (this.plugins_.size === 0) {
+      return;
+    }
     const nodes = /* @__PURE__ */ new Map();
     for (const id2 of this.plugins_.keys()) {
       nodes.set(id2, new DAGNode(id2));
     }
-    for (const [id2, entry2] of this.plugins_) {
-      const node = nodes.get(id2);
+    for (const [plugin, entry2] of this.plugins_) {
+      const node = nodes.get(plugin);
       const depPlugins = entry2.metadata.dependencies?.plugins ?? [];
       for (const dep of depPlugins) {
-        const depNode = nodes.get(dep.id);
+        const depNode = nodes.get(dep.plugin);
         if (!depNode) {
-          throw new ErrMissingPluginDependency(id2, dep.id);
+          throw new ErrMissingPluginDependency(plugin, dep.plugin);
         }
-        node.vertices.push(depNode);
+        depNode.vertices.push(node);
       }
     }
     let sortedNodes;
@@ -907,20 +916,18 @@ var PluginsManager = class {
       p.instance?.onAfterWorldInit?.(world);
     }
   }
-  getPluginMetadata(pluginOrId) {
-    const id2 = this.resolveId(pluginOrId);
-    const entry2 = this.plugins_.get(id2);
-    if (!entry2) throw new ErrUnknownPlugin(id2);
+  getPluginMetadata(plugin) {
+    const entry2 = this.plugins_.get(plugin);
+    if (!entry2) throw new ErrUnknownPlugin(plugin);
     return entry2.metadata;
   }
-  getPluginInstance(pluginOrId) {
+  getPluginInstance(plugin) {
+    const entry2 = this.plugins_.get(plugin);
+    if (!entry2) throw new ErrUnknownPlugin(plugin);
+    if (!entry2.instance) throw new ErrPluginNotInit(plugin);
     if (!this.isInitiated_) {
-      throw new Error("Plugin instance is not initiated yet. Use PluginManager.build() before use plugins.");
+      throw new ErrPluginNotInit(plugin);
     }
-    const id2 = this.resolveId(pluginOrId);
-    const entry2 = this.plugins_.get(id2);
-    if (!entry2) throw new ErrUnknownPlugin(id2);
-    if (!entry2.instance) throw new ErrPluginNotInit(id2);
     return entry2.instance;
   }
   resolveId(pluginOrId) {
@@ -946,9 +953,13 @@ var World3 = class {
   plugins;
   logger;
   entityRefs_ = /* @__PURE__ */ new Map();
+  updatesCount_ = 0;
+  get updatesCount() {
+    return this.updatesCount_;
+  }
   constructor(params) {
     this.entities = new EntitiesManager(params.logger);
-    this.components = new ComponentsManager(params.maxEntityCount ?? ECS_DEFAULTS.MAX_ENTITY_COUNT);
+    this.components = new ComponentsManager(params.logger, params.maxEntityCount ?? ECS_DEFAULTS.MAX_ENTITY_COUNT);
     this.systems = new SystemsManager(this, params.logger);
     this.events = new EventBus();
     this.resources = new ResourcesManager(params.logger);
@@ -991,9 +1002,10 @@ var World3 = class {
     this.queries.invalidate(component);
     return c;
   }
-  update(dt) {
-    this.systems.update(dt);
+  update(clock) {
+    this.systems.update(clock.getTime());
     this.commands.flush(this);
+    this.updatesCount_++;
   }
   build() {
     this.plugins.build();
@@ -1020,21 +1032,28 @@ var Clock = class {
   }
   timeSource_;
   lastTimeMs_;
-  elapsedTime_ = 0;
-  dt_ = 0;
-  get dt() {
-    return this.dt_;
+  ellapsedTime_ = 0;
+  delta_ = 0;
+  time_ = {
+    delta: 0,
+    elapsed: 0
+  };
+  get deltaMs() {
+    return this.delta_;
   }
   get ellapsedTime() {
-    return this.elapsedTime_;
+    return this.ellapsedTime_;
   }
   tick() {
     const now = this.timeSource_.now();
-    const dt = now - this.lastTimeMs_;
-    this.dt_ = dt;
-    this.elapsedTime_ += dt;
+    const dt = Math.min(now - this.lastTimeMs_, 100);
+    this.delta_ = this.time_.delta = dt / 1e3;
+    this.ellapsedTime_ = this.time_.elapsed += dt / 1e3;
     this.lastTimeMs_ = now;
   }
+  getTime() {
+    return this.time_;
+  }
 };
 
 // src/runtime/loop.ts
@@ -1053,7 +1072,7 @@ var Loop = class {
     const loop = () => {
       if (!this.running) return;
       this.clock.tick();
-      this.stepFn(this.clock.dt, world);
+      this.stepFn(this.clock.deltaMs, world);
       this.platformLoop(loop);
     };
     this.platformLoop(loop);
@@ -1238,7 +1257,8 @@ var Engine = class {
     this.runtime = new Runtime(params.loop);
     this.logger = params.logger ?? new NoopLogger();
     this.world = new World3({
-      logger: this.logger
+      logger: this.logger,
+      maxEntityCount: params.maxEntityCount ?? ECS_DEFAULTS.MAX_ENTITY_COUNT
     });
   }
   init() {
@@ -1281,9 +1301,9 @@ var Engine = class {
   PluginBase,
   PluginError,
   PluginsManager,
+  Resource,
   ResourcesManager,
   Runtime,
-  SingletonStorage,
   System,
   SystemBase,
   SystemError,
@@ -1295,6 +1315,7 @@ var Engine = class {
   createEventKey,
   entry,
   getPluginMetadata,
+  getResourceMetadata,
   getSystemMetadata,
   isPlugin,
   isSystem,