@draug/engine 1.0.16 → 1.0.18

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   ErrUnknownPlugin: () => ErrUnknownPlugin,
   EventBuffer: () => EventBuffer,
   EventBus: () => EventBus,
+  LogLevel: () => LogLevel,
   Loop: () => Loop,
   ObjectPool: () => ObjectPool,
   Plugin: () => Plugin,
@@ -167,10 +168,12 @@ function isSystem(ctor) {
 var SystemBase = class {
 };
 var SystemsManager = class {
-  constructor(world) {
+  constructor(world, logger) {
     this.world = world;
+    this.logger = logger;
   }
   world;
+  logger;
   systems_ = /* @__PURE__ */ new Map();
   executionOrder_ = [];
   requiredComponents_ = /* @__PURE__ */ new Set();
@@ -192,11 +195,15 @@ var SystemsManager = class {
       this.requiredComponents_.add(c);
     for (const c of requiredComponents)
       this.requiredComponents_.add(c);
+    this.logger.debug(() => `[Systems]: "${ctor.name}" was registered`);
   }
   build() {
     this.buildSystemsArray();
-    for (const sys of this.systems_.values())
-      sys.onInit?.(this.world);
+    for (const sys of this.systems_.values()) {
+      sys.onInit?.({ world: this.world, logger: this.logger });
+    }
+    this.logger.debug(() => `Built ${this.systems_.size} systems`);
+    this.dirty_ = false;
   }
   rebuild() {
     this.build();
@@ -214,7 +221,12 @@ var SystemsManager = class {
     for (const s of this.executionOrder_) {
       const { query } = getSystemMetadata(s.constructor);
       const entities = this.world.query(query);
-      s.compute({ entities, world: this.world, dt });
+      s.compute({
+        world: this.world,
+        entities,
+        dt,
+        logger: this.logger
+      });
     }
   }
   buildSystemsArray() {
@@ -268,12 +280,18 @@ var EntityMaskNotFoundError = class extends Error {
   }
 };
 var EntitiesManager = class {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  logger;
   id_ = 0;
   nextId() {
     return ++this.id_;
   }
   create() {
-    return this.nextId();
+    const id2 = this.nextId();
+    this.logger.debug(() => `[Entities]: Created new entity with ID ${id2}`);
+    return id2;
   }
 };
 var EntityRef = class {
@@ -577,9 +595,14 @@ function getComponentId(ctor) {
 
 // src/ecs/resources/resources.ts
 var ResourcesManager = class {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  logger;
   items_ = /* @__PURE__ */ new Map();
   insert(type, value) {
     this.items_.set(type, value);
+    this.logger.debug(() => `[Resources]: Inserted new Resource "${type.name}"`);
     return value;
   }
   get(type) {
@@ -592,11 +615,12 @@ var ResourcesManager = class {
     let value = this.items_.get(type) ?? null;
     if (value === null) {
       value = factory();
-      this.items_.set(type, value);
+      this.insert(type, value);
     }
     return value;
   }
   remove(type) {
+    this.logger.debug(() => `[Resources]: Removed resource "${type.name}"`);
     this.items_.delete(type);
   }
 };
@@ -607,10 +631,12 @@ function entry(component, init = () => {
   return [component, init];
 }
 var Commands = class {
-  constructor(world) {
+  constructor(world, logger) {
     this.world = world;
+    this.logger = logger;
   }
   world;
+  logger;
   commandsQueue_ = [];
   add(cmd) {
     this.commandsQueue_.push(cmd);
@@ -628,6 +654,7 @@ 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(", ")}]`);
     return id2;
   }
 };
@@ -817,6 +844,10 @@ var ErrDAGCycleDetectedPlugin = class extends Error {
   }
 };
 var PluginsManager = class {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  logger;
   plugins_ = /* @__PURE__ */ new Map();
   isInitiated_ = false;
   install(plugin, ...constructorProps) {
@@ -831,6 +862,7 @@ var PluginsManager = class {
       metadata
     };
     this.plugins_.set(metadata.id, entry2);
+    this.logger.debug(() => `[Plugins]: Installed plugin ${metadata.name} (${metadata.version})`);
   }
   build() {
     const nodes = /* @__PURE__ */ new Map();
@@ -865,7 +897,11 @@ var PluginsManager = class {
       instance.onPluginLoad?.();
     }
     this.isInitiated_ = true;
+    this.logger.debug(() => `[Plugins]: Plugins built successfully!`);
   }
+  /**
+   * @internal
+   */
   __internal__onAfterWorldInit(world) {
     for (const p of this.plugins_.values()) {
       p.instance?.onAfterWorldInit?.(world);
@@ -900,17 +936,26 @@ var PluginsManager = class {
 
 // src/ecs/world.ts
 var World3 = class {
-  entities = new EntitiesManager();
-  components = new ComponentsManager();
-  systems = new SystemsManager(this);
-  events = new EventBus();
-  resources = new ResourcesManager();
-  commands = new Commands(this);
-  queries = new QueryManager(this);
-  plugins = new PluginsManager();
+  entities;
+  components;
+  systems;
+  events;
+  resources;
+  commands;
+  queries;
+  plugins;
+  logger;
   entityRefs_ = /* @__PURE__ */ new Map();
-  constructor(maxEntityCount = ECS_DEFAULTS.MAX_ENTITY_COUNT) {
-    this.components = new ComponentsManager(maxEntityCount);
+  constructor(params) {
+    this.entities = new EntitiesManager(params.logger);
+    this.components = new ComponentsManager(params.maxEntityCount ?? ECS_DEFAULTS.MAX_ENTITY_COUNT);
+    this.systems = new SystemsManager(this, params.logger);
+    this.events = new EventBus();
+    this.resources = new ResourcesManager(params.logger);
+    this.commands = new Commands(this, params.logger);
+    this.queries = new QueryManager(this);
+    this.plugins = new PluginsManager(params.logger);
+    this.logger = params.logger;
   }
   getEntityRef(id2) {
     let ref = this.entityRefs_.get(id2);
@@ -952,6 +997,18 @@ var World3 = class {
   }
   build() {
     this.plugins.build();
+    this.logger.debug(() => "World was built successfully");
+  }
+};
+
+// src/runtime/runtime.ts
+var Runtime = class {
+  constructor(loop) {
+    this.loop = loop;
+  }
+  loop;
+  run(world) {
+    this.loop.start(world);
   }
 };
 
@@ -982,23 +1039,21 @@ var Clock = class {
 
 // src/runtime/loop.ts
 var Loop = class {
-  constructor(world, clock, stepFn, platformLoop) {
-    this.world = world;
+  constructor(clock, stepFn, platformLoop) {
     this.clock = clock;
     this.stepFn = stepFn;
     this.platformLoop = platformLoop;
   }
-  world;
   clock;
   stepFn;
   platformLoop;
   running = false;
-  start() {
+  start(world) {
     this.running = true;
     const loop = () => {
       if (!this.running) return;
       this.clock.tick();
-      this.stepFn(this.clock.dt, this.world);
+      this.stepFn(this.clock.dt, world);
       this.platformLoop(loop);
     };
     this.platformLoop(loop);
@@ -1008,17 +1063,6 @@ var Loop = class {
   }
 };
 
-// src/runtime/runtime.ts
-var Runtime = class {
-  constructor(loop) {
-    this.loop = loop;
-  }
-  loop;
-  run() {
-    this.loop.start();
-  }
-};
-
 // src/assets/assets.ts
 var AssetState = /* @__PURE__ */ ((AssetState2) => {
   AssetState2[AssetState2["NOT_READY"] = 1] = "NOT_READY";
@@ -1165,21 +1209,43 @@ var AssetsManager = class {
   }
 };
 
+// src/logger/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["Debug"] = 0] = "Debug";
+  LogLevel2[LogLevel2["Info"] = 1] = "Info";
+  LogLevel2[LogLevel2["Warn"] = 2] = "Warn";
+  LogLevel2[LogLevel2["Error"] = 3] = "Error";
+  return LogLevel2;
+})(LogLevel || {});
+var NoopLogger = class {
+  debug() {
+  }
+  info() {
+  }
+  warn() {
+  }
+  error() {
+  }
+};
+
 // src/engine.ts
 var Engine = class {
   runtime;
+  assets = new AssetsManager();
   world;
-  assets;
+  logger;
   constructor(params) {
-    this.world = new World3();
     this.runtime = new Runtime(params.loop);
-    this.assets = new AssetsManager();
+    this.logger = params.logger ?? new NoopLogger();
+    this.world = new World3({
+      logger: this.logger
+    });
   }
   init() {
     this.world.build();
   }
   start() {
-    this.runtime.run();
+    this.runtime.run(this.world);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
@@ -1208,6 +1274,7 @@ var Engine = class {
   ErrUnknownPlugin,
   EventBuffer,
   EventBus,
+  LogLevel,
   Loop,
   ObjectPool,
   Plugin,