@draug/engine 1.0.16 → 1.0.17

package/dist/index.d.cts

@@ -233,6 +233,24 @@ declare class PluginsManager {
     private resolveId;
 }
 
+declare enum LogLevel {
+    Debug = 0,
+    Info = 1,
+    Warn = 2,
+    Error = 3
+}
+type LogMessage = () => string;
+interface Logger {
+    debug(message: LogMessage): void;
+    info(message: LogMessage): void;
+    warn(message: LogMessage): void;
+    error(message: LogMessage): void;
+}
+
+type WorldConstructor = {
+    maxEntityCount?: number;
+    logger: Logger;
+};
 declare class World {
     readonly entities: EntitiesManager;
     readonly components: ComponentsManager;
@@ -243,7 +261,7 @@ declare class World {
     readonly queries: QueryManager;
     readonly plugins: PluginsManager;
     private entityRefs_;
-    constructor(maxEntityCount?: number);
+    constructor(params: WorldConstructor);
     getEntityRef(id: number): EntityRef;
     query(params: QueryParameters): number[];
     removeComponent<T extends object>(ref: EntityRef, component: ComponentType<T>): void;
@@ -311,11 +329,17 @@ type SystemCtor<T extends SystemBase = SystemBase> = ClassType<T>;
  */
 type SystemComputeContext = {
     /** Entity IDs from the query for this {@link SystemBase.compute} invocation. */
-    entities: number[];
+    readonly entities: number[];
     /** ECS world instance. */
-    world: World;
+    readonly world: World;
     /** Delta time (seconds or your engine's convention) since the previous update. */
-    dt: number;
+    readonly dt: number;
+    /** Logger instance for debugging and diagnostics. */
+    readonly logger: Logger;
+};
+type SystemInitContext = {
+    world: World;
+    logger: Logger;
 };
 /**
  * Base class for ECS systems executed by {@link SystemsManager}.
@@ -329,15 +353,16 @@ declare abstract class SystemBase {
      * Logic for one systems pass: run for all entities in {@link SystemComputeContext.entities}.
      */
     abstract compute(ctx: SystemComputeContext): void;
-    onInit?(world: World): void;
+    onInit?(ctx: SystemInitContext): void;
 }
 declare class SystemsManager {
     private readonly world;
+    private readonly logger;
     private systems_;
     private executionOrder_;
     private requiredComponents_;
     private dirty_;
-    constructor(world: World);
+    constructor(world: World, logger: Logger);
     getRequiredComponents(): ComponentType[];
     register<T extends SystemBase>(sys: T): void;
     build(): void;
@@ -364,20 +389,19 @@ declare class Clock {
 type StepFunction = (dt: number, world: World) => void;
 type PlatformLoop = (callback: () => void) => void;
 declare class Loop {
-    private readonly world;
     private readonly clock;
     private readonly stepFn;
     private readonly platformLoop;
     private running;
-    constructor(world: World, clock: Clock, stepFn: StepFunction, platformLoop: PlatformLoop);
-    start(): void;
+    constructor(clock: Clock, stepFn: StepFunction, platformLoop: PlatformLoop);
+    start(world: World): void;
     stop(): void;
 }
 
 declare class Runtime {
     private readonly loop;
     constructor(loop: Loop);
-    run(): void;
+    run(world: World): void;
 }
 
 declare enum VisitedState {
@@ -457,14 +481,16 @@ declare class AssetsManager {
 
 type EngineConstructor = {
     loop: Loop;
+    logger?: Logger;
 };
 declare class Engine {
     readonly runtime: Runtime;
-    readonly world: World;
     readonly assets: AssetsManager;
+    readonly world: World;
+    readonly logger: Logger;
     constructor(params: EngineConstructor);
     init(): void;
     start(): void;
 }
 
-export { Asset, type AssetDisposer, type AssetID, type AssetIDGenerator, type AssetLoader, AssetState, AssetStorage, AssetsManager, type ClassType, Clock, Commands, Component, ComponentAlreadyRegisteredError, type ComponentInitFn, ComponentStorage, type ComponentType, ComponentsManager, type CreateEntityComponentEntry, DAGNode, Engine, type EngineConstructor, EntitiesManager, type EntityID, EntityMaskNotFoundError, EntityRef, ErrDAGCycleDetected, ErrMissingPluginMetadata, ErrMissingSystemMetadata, ErrNotAPlugin, ErrNotASystem, ErrPluginNotInit, ErrUnknownPlugin, EventBuffer, EventBus, type IStorage, Loop, ObjectPool, Plugin, PluginBase, type PluginDependencies, PluginError, type PluginID, type PluginMetadata, PluginsManager, ResourcesManager, Runtime, SingletonStorage, type StepFunction, System, SystemBase, type SystemComputeContext, SystemError, SystemPhase, SystemsManager, type TimeSource, UnregisteredComponentStorageError, VisitedState, World, type WorldCommand, createEventKey, entry, getPluginMetadata, getSystemMetadata, isPlugin, isSystem, topologicalSort };
+export { Asset, type AssetDisposer, type AssetID, type AssetIDGenerator, type AssetLoader, AssetState, AssetStorage, AssetsManager, type ClassType, Clock, Commands, Component, ComponentAlreadyRegisteredError, type ComponentInitFn, ComponentStorage, type ComponentType, ComponentsManager, type CreateEntityComponentEntry, DAGNode, Engine, type EngineConstructor, EntitiesManager, type EntityID, EntityMaskNotFoundError, EntityRef, ErrDAGCycleDetected, ErrMissingPluginMetadata, ErrMissingSystemMetadata, ErrNotAPlugin, ErrNotASystem, ErrPluginNotInit, ErrUnknownPlugin, EventBuffer, EventBus, type IStorage, LogLevel, type LogMessage, type Logger, Loop, ObjectPool, type PlatformLoop, Plugin, PluginBase, type PluginDependencies, PluginError, type PluginID, type PluginMetadata, PluginsManager, ResourcesManager, Runtime, SingletonStorage, type StepFunction, System, SystemBase, type SystemComputeContext, SystemError, type SystemInitContext, SystemPhase, SystemsManager, type TimeSource, UnregisteredComponentStorageError, VisitedState, World, type WorldCommand, createEventKey, entry, getPluginMetadata, getSystemMetadata, isPlugin, isSystem, topologicalSort };

package/dist/index.d.ts

@@ -233,6 +233,24 @@ declare class PluginsManager {
     private resolveId;
 }
 
+declare enum LogLevel {
+    Debug = 0,
+    Info = 1,
+    Warn = 2,
+    Error = 3
+}
+type LogMessage = () => string;
+interface Logger {
+    debug(message: LogMessage): void;
+    info(message: LogMessage): void;
+    warn(message: LogMessage): void;
+    error(message: LogMessage): void;
+}
+
+type WorldConstructor = {
+    maxEntityCount?: number;
+    logger: Logger;
+};
 declare class World {
     readonly entities: EntitiesManager;
     readonly components: ComponentsManager;
@@ -243,7 +261,7 @@ declare class World {
     readonly queries: QueryManager;
     readonly plugins: PluginsManager;
     private entityRefs_;
-    constructor(maxEntityCount?: number);
+    constructor(params: WorldConstructor);
     getEntityRef(id: number): EntityRef;
     query(params: QueryParameters): number[];
     removeComponent<T extends object>(ref: EntityRef, component: ComponentType<T>): void;
@@ -311,11 +329,17 @@ type SystemCtor<T extends SystemBase = SystemBase> = ClassType<T>;
  */
 type SystemComputeContext = {
     /** Entity IDs from the query for this {@link SystemBase.compute} invocation. */
-    entities: number[];
+    readonly entities: number[];
     /** ECS world instance. */
-    world: World;
+    readonly world: World;
     /** Delta time (seconds or your engine's convention) since the previous update. */
-    dt: number;
+    readonly dt: number;
+    /** Logger instance for debugging and diagnostics. */
+    readonly logger: Logger;
+};
+type SystemInitContext = {
+    world: World;
+    logger: Logger;
 };
 /**
  * Base class for ECS systems executed by {@link SystemsManager}.
@@ -329,15 +353,16 @@ declare abstract class SystemBase {
      * Logic for one systems pass: run for all entities in {@link SystemComputeContext.entities}.
      */
     abstract compute(ctx: SystemComputeContext): void;
-    onInit?(world: World): void;
+    onInit?(ctx: SystemInitContext): void;
 }
 declare class SystemsManager {
     private readonly world;
+    private readonly logger;
     private systems_;
     private executionOrder_;
     private requiredComponents_;
     private dirty_;
-    constructor(world: World);
+    constructor(world: World, logger: Logger);
     getRequiredComponents(): ComponentType[];
     register<T extends SystemBase>(sys: T): void;
     build(): void;
@@ -364,20 +389,19 @@ declare class Clock {
 type StepFunction = (dt: number, world: World) => void;
 type PlatformLoop = (callback: () => void) => void;
 declare class Loop {
-    private readonly world;
     private readonly clock;
     private readonly stepFn;
     private readonly platformLoop;
     private running;
-    constructor(world: World, clock: Clock, stepFn: StepFunction, platformLoop: PlatformLoop);
-    start(): void;
+    constructor(clock: Clock, stepFn: StepFunction, platformLoop: PlatformLoop);
+    start(world: World): void;
     stop(): void;
 }
 
 declare class Runtime {
     private readonly loop;
     constructor(loop: Loop);
-    run(): void;
+    run(world: World): void;
 }
 
 declare enum VisitedState {
@@ -457,14 +481,16 @@ declare class AssetsManager {
 
 type EngineConstructor = {
     loop: Loop;
+    logger?: Logger;
 };
 declare class Engine {
     readonly runtime: Runtime;
-    readonly world: World;
     readonly assets: AssetsManager;
+    readonly world: World;
+    readonly logger: Logger;
     constructor(params: EngineConstructor);
     init(): void;
     start(): void;
 }
 
-export { Asset, type AssetDisposer, type AssetID, type AssetIDGenerator, type AssetLoader, AssetState, AssetStorage, AssetsManager, type ClassType, Clock, Commands, Component, ComponentAlreadyRegisteredError, type ComponentInitFn, ComponentStorage, type ComponentType, ComponentsManager, type CreateEntityComponentEntry, DAGNode, Engine, type EngineConstructor, EntitiesManager, type EntityID, EntityMaskNotFoundError, EntityRef, ErrDAGCycleDetected, ErrMissingPluginMetadata, ErrMissingSystemMetadata, ErrNotAPlugin, ErrNotASystem, ErrPluginNotInit, ErrUnknownPlugin, EventBuffer, EventBus, type IStorage, Loop, ObjectPool, Plugin, PluginBase, type PluginDependencies, PluginError, type PluginID, type PluginMetadata, PluginsManager, ResourcesManager, Runtime, SingletonStorage, type StepFunction, System, SystemBase, type SystemComputeContext, SystemError, SystemPhase, SystemsManager, type TimeSource, UnregisteredComponentStorageError, VisitedState, World, type WorldCommand, createEventKey, entry, getPluginMetadata, getSystemMetadata, isPlugin, isSystem, topologicalSort };
+export { Asset, type AssetDisposer, type AssetID, type AssetIDGenerator, type AssetLoader, AssetState, AssetStorage, AssetsManager, type ClassType, Clock, Commands, Component, ComponentAlreadyRegisteredError, type ComponentInitFn, ComponentStorage, type ComponentType, ComponentsManager, type CreateEntityComponentEntry, DAGNode, Engine, type EngineConstructor, EntitiesManager, type EntityID, EntityMaskNotFoundError, EntityRef, ErrDAGCycleDetected, ErrMissingPluginMetadata, ErrMissingSystemMetadata, ErrNotAPlugin, ErrNotASystem, ErrPluginNotInit, ErrUnknownPlugin, EventBuffer, EventBus, type IStorage, LogLevel, type LogMessage, type Logger, Loop, ObjectPool, type PlatformLoop, Plugin, PluginBase, type PluginDependencies, PluginError, type PluginID, type PluginMetadata, PluginsManager, ResourcesManager, Runtime, SingletonStorage, type StepFunction, System, SystemBase, type SystemComputeContext, SystemError, type SystemInitContext, SystemPhase, SystemsManager, type TimeSource, UnregisteredComponentStorageError, VisitedState, World, type WorldCommand, createEventKey, entry, getPluginMetadata, getSystemMetadata, isPlugin, isSystem, topologicalSort };

package/dist/index.js

@@ -94,10 +94,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();
@@ -121,9 +123,12 @@ var SystemsManager = class {
       this.requiredComponents_.add(c);
   }
   build() {
+    this.logger.info(() => "Building systems...");
     this.buildSystemsArray();
     for (const sys of this.systems_.values())
-      sys.onInit?.(this.world);
+      sys.onInit?.({ world: this.world, logger: this.logger });
+    this.logger.info(() => "Systems sucessfully was built!");
+    this.dirty_ = false;
   }
   rebuild() {
     this.build();
@@ -141,7 +146,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() {
@@ -827,17 +837,24 @@ 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;
   entityRefs_ = /* @__PURE__ */ new Map();
-  constructor(maxEntityCount = ECS_DEFAULTS.MAX_ENTITY_COUNT) {
-    this.components = new ComponentsManager(maxEntityCount);
+  constructor(params) {
+    this.components = new ComponentsManager(params.maxEntityCount ?? ECS_DEFAULTS.MAX_ENTITY_COUNT);
+    this.systems = new SystemsManager(this, params.logger);
+    this.entities = new EntitiesManager();
+    this.events = new EventBus();
+    this.resources = new ResourcesManager();
+    this.commands = new Commands(this);
+    this.queries = new QueryManager(this);
+    this.plugins = new PluginsManager();
   }
   getEntityRef(id2) {
     let ref = this.entityRefs_.get(id2);
@@ -882,6 +899,17 @@ var World3 = class {
   }
 };
 
+// src/runtime/runtime.ts
+var Runtime = class {
+  constructor(loop) {
+    this.loop = loop;
+  }
+  loop;
+  run(world) {
+    this.loop.start(world);
+  }
+};
+
 // src/runtime/clock.ts
 var Clock = class {
   constructor(timeSource_) {
@@ -909,23 +937,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);
@@ -935,17 +961,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";
@@ -1092,21 +1107,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);
   }
 };
 export {
@@ -1134,6 +1171,7 @@ export {
   ErrUnknownPlugin,
   EventBuffer,
   EventBus,
+  LogLevel,
   Loop,
   ObjectPool,
   Plugin,