@illuma/core 1.3.1 → 1.5.0

package/dist/{plugin-container-jg0-7wgh.d.ts → plugin-container-OWBUHjSf.d.cts}

@@ -1,4 +1,4 @@
-import { N as NodeToken, M as MultiNodeToken, a as NodeBase } from './types-zryyqrii.js';
+import { N as NodeToken, M as MultiNodeToken, a as NodeBase, T as Token } from './types-zryyqrii.cjs';
 
 /**
  * Represents a single dependency injection point in the dependency graph.
@@ -29,6 +29,17 @@ interface iContextScanner {
     scan(factory: any): Set<iInjectionNode<any>>;
 }
 
+/**
+ * Instantiation parameters for creating a new instance of a type `T`.
+ * @template T - The type of the instance to be created.
+ */
+interface iInstantiationParams<T = unknown> {
+    readonly token: NodeBase<T>;
+    readonly factory: () => T;
+    readonly deps: Set<Token<unknown>>;
+}
+type iMiddleware<T = unknown> = (params: iInstantiationParams<T>, next: (params: iInstantiationParams<T>) => T) => T;
+
 declare class ProtoNodeSingle<T = any> {
     readonly token: NodeToken<T>;
     readonly injections: Set<iInjectionNode<any>>;
@@ -67,7 +78,7 @@ declare class TreeNodeSingle<T = any> {
     constructor(proto: ProtoNodeSingle<T>);
     addDependency(node: TreeNode<any>): void;
     collectPool(pool: InjectionPool): void;
-    instantiate(pool?: InjectionPool): void;
+    instantiate(pool?: InjectionPool, middlewares?: iMiddleware[]): void;
     toString(): string;
 }
 declare class TreeNodeTransparent<T = any> {
@@ -81,7 +92,7 @@ declare class TreeNodeTransparent<T = any> {
     constructor(proto: ProtoNodeTransparent<T>);
     addDependency(node: TreeNode<any>): void;
     collectPool(pool: InjectionPool): void;
-    instantiate(pool?: InjectionPool): void;
+    instantiate(pool?: InjectionPool, middlewares?: iMiddleware[]): void;
     toString(): string;
 }
 declare class TreeNodeMulti<T = any> {
@@ -92,7 +103,7 @@ declare class TreeNodeMulti<T = any> {
     allocations: number;
     constructor(proto: ProtoNodeMulti<T>);
     collectPool(pool: InjectionPool): void;
-    instantiate(pool?: InjectionPool): void;
+    instantiate(pool?: InjectionPool, middlewares?: iMiddleware[]): void;
     addDependency(...nodes: TreeNode[]): void;
     toString(): string;
 }
@@ -117,6 +128,7 @@ interface iDiagnosticsModule {
 declare abstract class Illuma {
     private static readonly _diagnostics;
     private static readonly _scanners;
+    protected static readonly _middlewares: iMiddleware[];
     /** @internal */
     static get contextScanners(): ReadonlyArray<iContextScanner>;
     /**
@@ -133,7 +145,27 @@ declare abstract class Illuma {
      * @param scanner - The context scanner instance to add
      */
     static extendContextScanner(scanner: iContextScanner): void;
+    /**
+     * Registers a global middleware to be applied during instance creation.
+     * Typically used for cross-cutting concerns like logging, profiling, or custom instantiation logic.
+     * Function should accept instantiation parameters and a `next` function to proceed with the next middleware or actual instantiation.
+     *
+     * @param m - The middleware function to register
+     */
+    static registerGlobalMiddleware(m: iMiddleware): void;
+    protected readonly middlewares: iMiddleware[];
+    registerMiddleware(m: iMiddleware): void;
     protected static onReport(report: iDiagnosticsReport): void;
+    /**
+     * @internal
+     * Check if diagnostics modules are registered
+     */
+    protected static hasDiagnostics(): boolean;
+    /**
+     * @internal
+     * Reset all plugin registrations
+     */
+    protected static __resetPlugins(): void;
 }
 
-export { Illuma as I, type TreeNode as T, type iDiagnosticsModule as a, type iDiagnosticsReport as b, type iContextScanner as c, type iInjectionNode as i };
+export { Illuma as I, type TreeNode as T, type iInjectionNode as a, type iDiagnosticsModule as b, type iDiagnosticsReport as c, type iContextScanner as d, type iInstantiationParams as e, type iMiddleware as i };

package/dist/plugins.cjs

@@ -22,7 +22,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var plugins_exports = {};
 __export(plugins_exports, {
   DiagnosticsDefaultReporter: () => DiagnosticsDefaultReporter,
-  Illuma: () => Illuma
+  Illuma: () => Illuma,
+  enableIllumaDiagnostics: () => enableIllumaDiagnostics
 });
 module.exports = __toCommonJS(plugins_exports);
 
@@ -31,8 +32,9 @@ var Illuma = class _Illuma {
   static {
     __name(this, "Illuma");
   }
-  static _diagnostics = [];
+  static _diagnostics = /* @__PURE__ */ new Set();
   static _scanners = [];
+  static _middlewares = [];
   /** @internal */
   static get contextScanners() {
     return _Illuma._scanners;
@@ -44,7 +46,7 @@ var Illuma = class _Illuma {
   * @param m - The diagnostics module instance to add
   */
   static extendDiagnostics(m) {
-    _Illuma._diagnostics.push(m);
+    _Illuma._diagnostics.add(m);
   }
   /**
   * Extends the context scanners with a new context scanner.
@@ -55,11 +57,54 @@ var Illuma = class _Illuma {
   static extendContextScanner(scanner) {
     _Illuma._scanners.push(scanner);
   }
+  /**
+  * Registers a global middleware to be applied during instance creation.
+  * Typically used for cross-cutting concerns like logging, profiling, or custom instantiation logic.
+  * Function should accept instantiation parameters and a `next` function to proceed with the next middleware or actual instantiation.
+  *
+  * @param m - The middleware function to register
+  */
+  static registerGlobalMiddleware(m) {
+    _Illuma._middlewares.push(m);
+  }
+  middlewares = [];
+  registerMiddleware(m) {
+    this.middlewares.push(m);
+  }
   static onReport(report) {
     for (const diag of _Illuma._diagnostics) diag.onReport(report);
   }
+  /**
+  * @internal
+  * Check if diagnostics modules are registered
+  */
+  static hasDiagnostics() {
+    return _Illuma._diagnostics.size > 0;
+  }
+  /**
+  * @internal
+  * Reset all plugin registrations
+  */
+  static __resetPlugins() {
+    _Illuma._diagnostics.clear();
+    _Illuma._scanners.length = 0;
+    _Illuma._middlewares.length = 0;
+  }
 };
 
+// src/lib/plugins/middlewares/diagnostics.middleware.ts
+var performanceDiagnostics = /* @__PURE__ */ __name((params, next) => {
+  if (!params.deps.size) {
+    return next(params);
+  }
+  const start = performance.now();
+  const instance = next(params);
+  const end = performance.now();
+  const duration = end - start;
+  console.log(`Instantiated ${params.token.name} in ${duration.toFixed(2)} ms`);
+  return instance;
+}, "performanceDiagnostics");
+
 // src/lib/plugins/diagnostics/default-impl.ts
 var DiagnosticsDefaultReporter = class {
   static {
@@ -72,9 +117,22 @@ var DiagnosticsDefaultReporter = class {
     for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);
   }
 };
+
+// src/lib/plugins/diagnostics/built-in.ts
+var state = {
+  enabled: false
+};
+function enableIllumaDiagnostics() {
+  if (state.enabled) return;
+  state.enabled = true;
+  Illuma.extendDiagnostics(new DiagnosticsDefaultReporter());
+  Illuma.registerGlobalMiddleware(performanceDiagnostics);
+}
+__name(enableIllumaDiagnostics, "enableIllumaDiagnostics");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DiagnosticsDefaultReporter,
-  Illuma
+  Illuma,
+  enableIllumaDiagnostics
 });
 //# sourceMappingURL=plugins.cjs.map

package/dist/plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugins.ts","../src/lib/plugins/core/plugin-container.ts","../src/lib/plugins/diagnostics/default-impl.ts"],"sourcesContent":["export * from \"./lib/plugins\";\n","import type { iContextScanner } from \"../context\";\nimport type { iDiagnosticsModule, iDiagnosticsReport } from \"../diagnostics/types\";\n\n/**\n * Global plugin container for managing core plugins such as diagnostics and context scanners.\n */\nexport abstract class Illuma {\n  private static readonly _diagnostics = [] as iDiagnosticsModule[];\n  private static readonly _scanners = [] as iContextScanner[];\n\n  /** @internal */\n  public static get contextScanners(): ReadonlyArray<iContextScanner> {\n    return Illuma._scanners;\n  }\n\n  /**\n   * Extends the diagnostics with a new diagnostics module.\n   * These will be run on diagnostics reports after container bootstrap.\n   *\n   * @param m - The diagnostics module instance to add\n   */\n  public static extendDiagnostics(m: iDiagnosticsModule): void {\n    Illuma._diagnostics.push(m);\n  }\n\n  /**\n   * Extends the context scanners with a new context scanner.\n   * These will be run in injection context scans to detect additional injections (alongside `nodeInject` calls).\n   *\n   * @param scanner - The context scanner instance to add\n   */\n  public static extendContextScanner(scanner: iContextScanner): void {\n    Illuma._scanners.push(scanner);\n  }\n\n  protected static onReport(report: iDiagnosticsReport): void {\n    for (const diag of Illuma._diagnostics) diag.onReport(report);\n  }\n}\n","import type { iDiagnosticsModule, iDiagnosticsReport } from \"./types\";\n\nexport class DiagnosticsDefaultReporter implements iDiagnosticsModule {\n  public onReport(report: iDiagnosticsReport): void {\n    console.log(\"[Illuma] 🧹 Diagnostics:\");\n    console.log(`  Total: ${report.totalNodes} node(s)`);\n    console.log(`  ${report.unusedNodes.length} were not used while bootstrap:`);\n    for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;ACMO,IAAeA,SAAf,MAAeA,QAAAA;EAHtB,OAGsBA;;;EACpB,OAAwBC,eAAe,CAAA;EACvC,OAAwBC,YAAY,CAAA;;EAGpC,WAAkBC,kBAAkD;AAClE,WAAOH,QAAOE;EAChB;;;;;;;EAQA,OAAcE,kBAAkBC,GAA6B;AAC3DL,YAAOC,aAAaK,KAAKD,CAAAA;EAC3B;;;;;;;EAQA,OAAcE,qBAAqBC,SAAgC;AACjER,YAAOE,UAAUI,KAAKE,OAAAA;EACxB;EAEA,OAAiBC,SAASC,QAAkC;AAC1D,eAAWC,QAAQX,QAAOC,aAAcU,MAAKF,SAASC,MAAAA;EACxD;AACF;;;ACpCO,IAAME,6BAAN,MAAMA;EAAb,OAAaA;;;EACJC,SAASC,QAAkC;AAChDC,YAAQC,IAAI,iCAAA;AACZD,YAAQC,IAAI,YAAYF,OAAOG,UAAU,UAAU;AACnDF,YAAQC,IAAI,KAAKF,OAAOI,YAAYC,MAAM,iCAAiC;AAC3E,eAAWC,QAAQN,OAAOI,YAAaH,SAAQC,IAAI,SAASI,KAAKC,SAAQ,CAAA,EAAI;EAC/E;AACF;","names":["Illuma","_diagnostics","_scanners","contextScanners","extendDiagnostics","m","push","extendContextScanner","scanner","onReport","report","diag","DiagnosticsDefaultReporter","onReport","report","console","log","totalNodes","unusedNodes","length","node","toString"]}
+{"version":3,"sources":["../src/plugins.ts","../src/lib/plugins/core/plugin-container.ts","../src/lib/plugins/middlewares/diagnostics.middleware.ts","../src/lib/plugins/diagnostics/default-impl.ts","../src/lib/plugins/diagnostics/built-in.ts"],"sourcesContent":["export * from \"./lib/plugins\";\n","import type { iContextScanner } from \"../context\";\nimport type { iDiagnosticsModule, iDiagnosticsReport } from \"../diagnostics/types\";\nimport type { iMiddleware } from \"../middlewares/types\";\n\n/**\n * Global plugin container for managing core plugins such as diagnostics and context scanners.\n */\nexport abstract class Illuma {\n  private static readonly _diagnostics = new Set<iDiagnosticsModule>();\n  private static readonly _scanners = [] as iContextScanner[];\n  protected static readonly _middlewares = [] as iMiddleware[];\n\n  /** @internal */\n  public static get contextScanners(): ReadonlyArray<iContextScanner> {\n    return Illuma._scanners;\n  }\n\n  /**\n   * Extends the diagnostics with a new diagnostics module.\n   * These will be run on diagnostics reports after container bootstrap.\n   *\n   * @param m - The diagnostics module instance to add\n   */\n  public static extendDiagnostics(m: iDiagnosticsModule): void {\n    Illuma._diagnostics.add(m);\n  }\n\n  /**\n   * Extends the context scanners with a new context scanner.\n   * These will be run in injection context scans to detect additional injections (alongside `nodeInject` calls).\n   *\n   * @param scanner - The context scanner instance to add\n   */\n  public static extendContextScanner(scanner: iContextScanner): void {\n    Illuma._scanners.push(scanner);\n  }\n\n  /**\n   * Registers a global middleware to be applied during instance creation.\n   * Typically used for cross-cutting concerns like logging, profiling, or custom instantiation logic.\n   * Function should accept instantiation parameters and a `next` function to proceed with the next middleware or actual instantiation.\n   *\n   * @param m - The middleware function to register\n   */\n  public static registerGlobalMiddleware(m: iMiddleware): void {\n    Illuma._middlewares.push(m);\n  }\n\n  protected readonly middlewares = [] as iMiddleware[];\n  public registerMiddleware(m: iMiddleware): void {\n    this.middlewares.push(m);\n  }\n\n  protected static onReport(report: iDiagnosticsReport): void {\n    for (const diag of Illuma._diagnostics) diag.onReport(report);\n  }\n\n  /**\n   * @internal\n   * Check if diagnostics modules are registered\n   */\n  protected static hasDiagnostics(): boolean {\n    return Illuma._diagnostics.size > 0;\n  }\n\n  /**\n   * @internal\n   * Reset all plugin registrations\n   */\n  protected static __resetPlugins(): void {\n    Illuma._diagnostics.clear();\n    Illuma._scanners.length = 0;\n    Illuma._middlewares.length = 0;\n  }\n}\n","import type { iMiddleware } from \"./types\";\n\nexport const performanceDiagnostics: iMiddleware = (params, next) => {\n  if (!params.deps.size) {\n    return next(params);\n  }\n\n  const start = performance.now();\n  const instance = next(params);\n  const end = performance.now();\n  const duration = end - start;\n\n  console.log(`Instantiated ${params.token.name} in ${duration.toFixed(2)} ms`);\n  return instance;\n};\n","import type { iDiagnosticsModule, iDiagnosticsReport } from \"./types\";\n\nexport class DiagnosticsDefaultReporter implements iDiagnosticsModule {\n  public onReport(report: iDiagnosticsReport): void {\n    console.log(\"[Illuma] 🧹 Diagnostics:\");\n    console.log(`  Total: ${report.totalNodes} node(s)`);\n    console.log(`  ${report.unusedNodes.length} were not used while bootstrap:`);\n    for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);\n  }\n}\n","import { Illuma } from \"../core\";\nimport { performanceDiagnostics } from \"../middlewares/diagnostics.middleware\";\nimport { DiagnosticsDefaultReporter } from \"./default-impl\";\n\nconst state = { enabled: false };\n\nexport function enableIllumaDiagnostics() {\n  if (state.enabled) return;\n  state.enabled = true;\n\n  Illuma.extendDiagnostics(new DiagnosticsDefaultReporter());\n  Illuma.registerGlobalMiddleware(performanceDiagnostics);\n}\n\n/**\n * @internal\n * Reset diagnostics state (for testing only)\n */\nexport function __resetDiagnosticsState() {\n  state.enabled = false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;ACOO,IAAeA,SAAf,MAAeA,QAAAA;EAHtB,OAGsBA;;;EACpB,OAAwBC,eAAe,oBAAIC,IAAAA;EAC3C,OAAwBC,YAAY,CAAA;EACpC,OAA0BC,eAAe,CAAA;;EAGzC,WAAkBC,kBAAkD;AAClE,WAAOL,QAAOG;EAChB;;;;;;;EAQA,OAAcG,kBAAkBC,GAA6B;AAC3DP,YAAOC,aAAaO,IAAID,CAAAA;EAC1B;;;;;;;EAQA,OAAcE,qBAAqBC,SAAgC;AACjEV,YAAOG,UAAUQ,KAAKD,OAAAA;EACxB;;;;;;;;EASA,OAAcE,yBAAyBL,GAAsB;AAC3DP,YAAOI,aAAaO,KAAKJ,CAAAA;EAC3B;EAEmBM,cAAc,CAAA;EAC1BC,mBAAmBP,GAAsB;AAC9C,SAAKM,YAAYF,KAAKJ,CAAAA;EACxB;EAEA,OAAiBQ,SAASC,QAAkC;AAC1D,eAAWC,QAAQjB,QAAOC,aAAcgB,MAAKF,SAASC,MAAAA;EACxD;;;;;EAMA,OAAiBE,iBAA0B;AACzC,WAAOlB,QAAOC,aAAakB,OAAO;EACpC;;;;;EAMA,OAAiBC,iBAAuB;AACtCpB,YAAOC,aAAaoB,MAAK;AACzBrB,YAAOG,UAAUmB,SAAS;AAC1BtB,YAAOI,aAAakB,SAAS;EAC/B;AACF;;;ACxEO,IAAMC,yBAAsC,wBAACC,QAAQC,SAAAA;AAC1D,MAAI,CAACD,OAAOE,KAAKC,MAAM;AACrB,WAAOF,KAAKD,MAAAA;EACd;AAEA,QAAMI,QAAQC,YAAYC,IAAG;AAC7B,QAAMC,WAAWN,KAAKD,MAAAA;AACtB,QAAMQ,MAAMH,YAAYC,IAAG;AAC3B,QAAMG,WAAWD,MAAMJ;AAEvBM,UAAQC,IAAI,gBAAgBX,OAAOY,MAAMC,IAAI,OAAOJ,SAASK,QAAQ,CAAA,CAAA,KAAO;AAC5E,SAAOP;AACT,GAZmD;;;ACA5C,IAAMQ,6BAAN,MAAMA;EAAb,OAAaA;;;EACJC,SAASC,QAAkC;AAChDC,YAAQC,IAAI,iCAAA;AACZD,YAAQC,IAAI,YAAYF,OAAOG,UAAU,UAAU;AACnDF,YAAQC,IAAI,KAAKF,OAAOI,YAAYC,MAAM,iCAAiC;AAC3E,eAAWC,QAAQN,OAAOI,YAAaH,SAAQC,IAAI,SAASI,KAAKC,SAAQ,CAAA,EAAI;EAC/E;AACF;;;ACLA,IAAMC,QAAQ;EAAEC,SAAS;AAAM;AAExB,SAASC,0BAAAA;AACd,MAAIF,MAAMC,QAAS;AACnBD,QAAMC,UAAU;AAEhBE,SAAOC,kBAAkB,IAAIC,2BAAAA,CAAAA;AAC7BF,SAAOG,yBAAyBC,sBAAAA;AAClC;AANgBL;","names":["Illuma","_diagnostics","Set","_scanners","_middlewares","contextScanners","extendDiagnostics","m","add","extendContextScanner","scanner","push","registerGlobalMiddleware","middlewares","registerMiddleware","onReport","report","diag","hasDiagnostics","size","__resetPlugins","clear","length","performanceDiagnostics","params","next","deps","size","start","performance","now","instance","end","duration","console","log","token","name","toFixed","DiagnosticsDefaultReporter","onReport","report","console","log","totalNodes","unusedNodes","length","node","toString","state","enabled","enableIllumaDiagnostics","Illuma","extendDiagnostics","DiagnosticsDefaultReporter","registerGlobalMiddleware","performanceDiagnostics"]}

package/dist/plugins.d.cts

@@ -1,9 +1,11 @@
-import { a as iDiagnosticsModule, b as iDiagnosticsReport } from './plugin-container-CSWXa9hU.cjs';
-export { I as Illuma, c as iContextScanner } from './plugin-container-CSWXa9hU.cjs';
+import { b as iDiagnosticsModule, c as iDiagnosticsReport } from './plugin-container-OWBUHjSf.cjs';
+export { I as Illuma, d as iContextScanner, e as iInstantiationParams, i as iMiddleware } from './plugin-container-OWBUHjSf.cjs';
 import './types-zryyqrii.cjs';
 
+declare function enableIllumaDiagnostics(): void;
+
 declare class DiagnosticsDefaultReporter implements iDiagnosticsModule {
     onReport(report: iDiagnosticsReport): void;
 }
 
-export { DiagnosticsDefaultReporter, iDiagnosticsModule, iDiagnosticsReport };
+export { DiagnosticsDefaultReporter, enableIllumaDiagnostics, iDiagnosticsModule, iDiagnosticsReport };

package/dist/plugins.d.ts

@@ -1,9 +1,11 @@
-import { a as iDiagnosticsModule, b as iDiagnosticsReport } from './plugin-container-jg0-7wgh.js';
-export { I as Illuma, c as iContextScanner } from './plugin-container-jg0-7wgh.js';
+import { b as iDiagnosticsModule, c as iDiagnosticsReport } from './plugin-container-DZj4vSLu.js';
+export { I as Illuma, d as iContextScanner, e as iInstantiationParams, i as iMiddleware } from './plugin-container-DZj4vSLu.js';
 import './types-zryyqrii.js';
 
+declare function enableIllumaDiagnostics(): void;
+
 declare class DiagnosticsDefaultReporter implements iDiagnosticsModule {
     onReport(report: iDiagnosticsReport): void;
 }
 
-export { DiagnosticsDefaultReporter, iDiagnosticsModule, iDiagnosticsReport };
+export { DiagnosticsDefaultReporter, enableIllumaDiagnostics, iDiagnosticsModule, iDiagnosticsReport };

package/dist/plugins.js

@@ -6,8 +6,9 @@ var Illuma = class _Illuma {
   static {
     __name(this, "Illuma");
   }
-  static _diagnostics = [];
+  static _diagnostics = /* @__PURE__ */ new Set();
   static _scanners = [];
+  static _middlewares = [];
   /** @internal */
   static get contextScanners() {
     return _Illuma._scanners;
@@ -19,7 +20,7 @@ var Illuma = class _Illuma {
   * @param m - The diagnostics module instance to add
   */
   static extendDiagnostics(m) {
-    _Illuma._diagnostics.push(m);
+    _Illuma._diagnostics.add(m);
   }
   /**
   * Extends the context scanners with a new context scanner.
@@ -30,11 +31,54 @@ var Illuma = class _Illuma {
   static extendContextScanner(scanner) {
     _Illuma._scanners.push(scanner);
   }
+  /**
+  * Registers a global middleware to be applied during instance creation.
+  * Typically used for cross-cutting concerns like logging, profiling, or custom instantiation logic.
+  * Function should accept instantiation parameters and a `next` function to proceed with the next middleware or actual instantiation.
+  *
+  * @param m - The middleware function to register
+  */
+  static registerGlobalMiddleware(m) {
+    _Illuma._middlewares.push(m);
+  }
+  middlewares = [];
+  registerMiddleware(m) {
+    this.middlewares.push(m);
+  }
   static onReport(report) {
     for (const diag of _Illuma._diagnostics) diag.onReport(report);
   }
+  /**
+  * @internal
+  * Check if diagnostics modules are registered
+  */
+  static hasDiagnostics() {
+    return _Illuma._diagnostics.size > 0;
+  }
+  /**
+  * @internal
+  * Reset all plugin registrations
+  */
+  static __resetPlugins() {
+    _Illuma._diagnostics.clear();
+    _Illuma._scanners.length = 0;
+    _Illuma._middlewares.length = 0;
+  }
 };
 
+// src/lib/plugins/middlewares/diagnostics.middleware.ts
+var performanceDiagnostics = /* @__PURE__ */ __name((params, next) => {
+  if (!params.deps.size) {
+    return next(params);
+  }
+  const start = performance.now();
+  const instance = next(params);
+  const end = performance.now();
+  const duration = end - start;
+  console.log(`Instantiated ${params.token.name} in ${duration.toFixed(2)} ms`);
+  return instance;
+}, "performanceDiagnostics");
+
 // src/lib/plugins/diagnostics/default-impl.ts
 var DiagnosticsDefaultReporter = class {
   static {
@@ -47,8 +91,21 @@ var DiagnosticsDefaultReporter = class {
     for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);
   }
 };
+
+// src/lib/plugins/diagnostics/built-in.ts
+var state = {
+  enabled: false
+};
+function enableIllumaDiagnostics() {
+  if (state.enabled) return;
+  state.enabled = true;
+  Illuma.extendDiagnostics(new DiagnosticsDefaultReporter());
+  Illuma.registerGlobalMiddleware(performanceDiagnostics);
+}
+__name(enableIllumaDiagnostics, "enableIllumaDiagnostics");
 export {
   DiagnosticsDefaultReporter,
-  Illuma
+  Illuma,
+  enableIllumaDiagnostics
 };
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/lib/plugins/core/plugin-container.ts","../src/lib/plugins/diagnostics/default-impl.ts"],"sourcesContent":["import type { iContextScanner } from \"../context\";\nimport type { iDiagnosticsModule, iDiagnosticsReport } from \"../diagnostics/types\";\n\n/**\n * Global plugin container for managing core plugins such as diagnostics and context scanners.\n */\nexport abstract class Illuma {\n  private static readonly _diagnostics = [] as iDiagnosticsModule[];\n  private static readonly _scanners = [] as iContextScanner[];\n\n  /** @internal */\n  public static get contextScanners(): ReadonlyArray<iContextScanner> {\n    return Illuma._scanners;\n  }\n\n  /**\n   * Extends the diagnostics with a new diagnostics module.\n   * These will be run on diagnostics reports after container bootstrap.\n   *\n   * @param m - The diagnostics module instance to add\n   */\n  public static extendDiagnostics(m: iDiagnosticsModule): void {\n    Illuma._diagnostics.push(m);\n  }\n\n  /**\n   * Extends the context scanners with a new context scanner.\n   * These will be run in injection context scans to detect additional injections (alongside `nodeInject` calls).\n   *\n   * @param scanner - The context scanner instance to add\n   */\n  public static extendContextScanner(scanner: iContextScanner): void {\n    Illuma._scanners.push(scanner);\n  }\n\n  protected static onReport(report: iDiagnosticsReport): void {\n    for (const diag of Illuma._diagnostics) diag.onReport(report);\n  }\n}\n","import type { iDiagnosticsModule, iDiagnosticsReport } from \"./types\";\n\nexport class DiagnosticsDefaultReporter implements iDiagnosticsModule {\n  public onReport(report: iDiagnosticsReport): void {\n    console.log(\"[Illuma] 🧹 Diagnostics:\");\n    console.log(`  Total: ${report.totalNodes} node(s)`);\n    console.log(`  ${report.unusedNodes.length} were not used while bootstrap:`);\n    for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);\n  }\n}\n"],"mappings":";;;;AAMO,IAAeA,SAAf,MAAeA,QAAAA;EAHtB,OAGsBA;;;EACpB,OAAwBC,eAAe,CAAA;EACvC,OAAwBC,YAAY,CAAA;;EAGpC,WAAkBC,kBAAkD;AAClE,WAAOH,QAAOE;EAChB;;;;;;;EAQA,OAAcE,kBAAkBC,GAA6B;AAC3DL,YAAOC,aAAaK,KAAKD,CAAAA;EAC3B;;;;;;;EAQA,OAAcE,qBAAqBC,SAAgC;AACjER,YAAOE,UAAUI,KAAKE,OAAAA;EACxB;EAEA,OAAiBC,SAASC,QAAkC;AAC1D,eAAWC,QAAQX,QAAOC,aAAcU,MAAKF,SAASC,MAAAA;EACxD;AACF;;;ACpCO,IAAME,6BAAN,MAAMA;EAAb,OAAaA;;;EACJC,SAASC,QAAkC;AAChDC,YAAQC,IAAI,iCAAA;AACZD,YAAQC,IAAI,YAAYF,OAAOG,UAAU,UAAU;AACnDF,YAAQC,IAAI,KAAKF,OAAOI,YAAYC,MAAM,iCAAiC;AAC3E,eAAWC,QAAQN,OAAOI,YAAaH,SAAQC,IAAI,SAASI,KAAKC,SAAQ,CAAA,EAAI;EAC/E;AACF;","names":["Illuma","_diagnostics","_scanners","contextScanners","extendDiagnostics","m","push","extendContextScanner","scanner","onReport","report","diag","DiagnosticsDefaultReporter","onReport","report","console","log","totalNodes","unusedNodes","length","node","toString"]}
+{"version":3,"sources":["../src/lib/plugins/core/plugin-container.ts","../src/lib/plugins/middlewares/diagnostics.middleware.ts","../src/lib/plugins/diagnostics/default-impl.ts","../src/lib/plugins/diagnostics/built-in.ts"],"sourcesContent":["import type { iContextScanner } from \"../context\";\nimport type { iDiagnosticsModule, iDiagnosticsReport } from \"../diagnostics/types\";\nimport type { iMiddleware } from \"../middlewares/types\";\n\n/**\n * Global plugin container for managing core plugins such as diagnostics and context scanners.\n */\nexport abstract class Illuma {\n  private static readonly _diagnostics = new Set<iDiagnosticsModule>();\n  private static readonly _scanners = [] as iContextScanner[];\n  protected static readonly _middlewares = [] as iMiddleware[];\n\n  /** @internal */\n  public static get contextScanners(): ReadonlyArray<iContextScanner> {\n    return Illuma._scanners;\n  }\n\n  /**\n   * Extends the diagnostics with a new diagnostics module.\n   * These will be run on diagnostics reports after container bootstrap.\n   *\n   * @param m - The diagnostics module instance to add\n   */\n  public static extendDiagnostics(m: iDiagnosticsModule): void {\n    Illuma._diagnostics.add(m);\n  }\n\n  /**\n   * Extends the context scanners with a new context scanner.\n   * These will be run in injection context scans to detect additional injections (alongside `nodeInject` calls).\n   *\n   * @param scanner - The context scanner instance to add\n   */\n  public static extendContextScanner(scanner: iContextScanner): void {\n    Illuma._scanners.push(scanner);\n  }\n\n  /**\n   * Registers a global middleware to be applied during instance creation.\n   * Typically used for cross-cutting concerns like logging, profiling, or custom instantiation logic.\n   * Function should accept instantiation parameters and a `next` function to proceed with the next middleware or actual instantiation.\n   *\n   * @param m - The middleware function to register\n   */\n  public static registerGlobalMiddleware(m: iMiddleware): void {\n    Illuma._middlewares.push(m);\n  }\n\n  protected readonly middlewares = [] as iMiddleware[];\n  public registerMiddleware(m: iMiddleware): void {\n    this.middlewares.push(m);\n  }\n\n  protected static onReport(report: iDiagnosticsReport): void {\n    for (const diag of Illuma._diagnostics) diag.onReport(report);\n  }\n\n  /**\n   * @internal\n   * Check if diagnostics modules are registered\n   */\n  protected static hasDiagnostics(): boolean {\n    return Illuma._diagnostics.size > 0;\n  }\n\n  /**\n   * @internal\n   * Reset all plugin registrations\n   */\n  protected static __resetPlugins(): void {\n    Illuma._diagnostics.clear();\n    Illuma._scanners.length = 0;\n    Illuma._middlewares.length = 0;\n  }\n}\n","import type { iMiddleware } from \"./types\";\n\nexport const performanceDiagnostics: iMiddleware = (params, next) => {\n  if (!params.deps.size) {\n    return next(params);\n  }\n\n  const start = performance.now();\n  const instance = next(params);\n  const end = performance.now();\n  const duration = end - start;\n\n  console.log(`Instantiated ${params.token.name} in ${duration.toFixed(2)} ms`);\n  return instance;\n};\n","import type { iDiagnosticsModule, iDiagnosticsReport } from \"./types\";\n\nexport class DiagnosticsDefaultReporter implements iDiagnosticsModule {\n  public onReport(report: iDiagnosticsReport): void {\n    console.log(\"[Illuma] 🧹 Diagnostics:\");\n    console.log(`  Total: ${report.totalNodes} node(s)`);\n    console.log(`  ${report.unusedNodes.length} were not used while bootstrap:`);\n    for (const node of report.unusedNodes) console.log(`    - ${node.toString()}`);\n  }\n}\n","import { Illuma } from \"../core\";\nimport { performanceDiagnostics } from \"../middlewares/diagnostics.middleware\";\nimport { DiagnosticsDefaultReporter } from \"./default-impl\";\n\nconst state = { enabled: false };\n\nexport function enableIllumaDiagnostics() {\n  if (state.enabled) return;\n  state.enabled = true;\n\n  Illuma.extendDiagnostics(new DiagnosticsDefaultReporter());\n  Illuma.registerGlobalMiddleware(performanceDiagnostics);\n}\n\n/**\n * @internal\n * Reset diagnostics state (for testing only)\n */\nexport function __resetDiagnosticsState() {\n  state.enabled = false;\n}\n"],"mappings":";;;;AAOO,IAAeA,SAAf,MAAeA,QAAAA;EAHtB,OAGsBA;;;EACpB,OAAwBC,eAAe,oBAAIC,IAAAA;EAC3C,OAAwBC,YAAY,CAAA;EACpC,OAA0BC,eAAe,CAAA;;EAGzC,WAAkBC,kBAAkD;AAClE,WAAOL,QAAOG;EAChB;;;;;;;EAQA,OAAcG,kBAAkBC,GAA6B;AAC3DP,YAAOC,aAAaO,IAAID,CAAAA;EAC1B;;;;;;;EAQA,OAAcE,qBAAqBC,SAAgC;AACjEV,YAAOG,UAAUQ,KAAKD,OAAAA;EACxB;;;;;;;;EASA,OAAcE,yBAAyBL,GAAsB;AAC3DP,YAAOI,aAAaO,KAAKJ,CAAAA;EAC3B;EAEmBM,cAAc,CAAA;EAC1BC,mBAAmBP,GAAsB;AAC9C,SAAKM,YAAYF,KAAKJ,CAAAA;EACxB;EAEA,OAAiBQ,SAASC,QAAkC;AAC1D,eAAWC,QAAQjB,QAAOC,aAAcgB,MAAKF,SAASC,MAAAA;EACxD;;;;;EAMA,OAAiBE,iBAA0B;AACzC,WAAOlB,QAAOC,aAAakB,OAAO;EACpC;;;;;EAMA,OAAiBC,iBAAuB;AACtCpB,YAAOC,aAAaoB,MAAK;AACzBrB,YAAOG,UAAUmB,SAAS;AAC1BtB,YAAOI,aAAakB,SAAS;EAC/B;AACF;;;ACxEO,IAAMC,yBAAsC,wBAACC,QAAQC,SAAAA;AAC1D,MAAI,CAACD,OAAOE,KAAKC,MAAM;AACrB,WAAOF,KAAKD,MAAAA;EACd;AAEA,QAAMI,QAAQC,YAAYC,IAAG;AAC7B,QAAMC,WAAWN,KAAKD,MAAAA;AACtB,QAAMQ,MAAMH,YAAYC,IAAG;AAC3B,QAAMG,WAAWD,MAAMJ;AAEvBM,UAAQC,IAAI,gBAAgBX,OAAOY,MAAMC,IAAI,OAAOJ,SAASK,QAAQ,CAAA,CAAA,KAAO;AAC5E,SAAOP;AACT,GAZmD;;;ACA5C,IAAMQ,6BAAN,MAAMA;EAAb,OAAaA;;;EACJC,SAASC,QAAkC;AAChDC,YAAQC,IAAI,iCAAA;AACZD,YAAQC,IAAI,YAAYF,OAAOG,UAAU,UAAU;AACnDF,YAAQC,IAAI,KAAKF,OAAOI,YAAYC,MAAM,iCAAiC;AAC3E,eAAWC,QAAQN,OAAOI,YAAaH,SAAQC,IAAI,SAASI,KAAKC,SAAQ,CAAA,EAAI;EAC/E;AACF;;;ACLA,IAAMC,QAAQ;EAAEC,SAAS;AAAM;AAExB,SAASC,0BAAAA;AACd,MAAIF,MAAMC,QAAS;AACnBD,QAAMC,UAAU;AAEhBE,SAAOC,kBAAkB,IAAIC,2BAAAA,CAAAA;AAC7BF,SAAOG,yBAAyBC,sBAAAA;AAClC;AANgBL;","names":["Illuma","_diagnostics","Set","_scanners","_middlewares","contextScanners","extendDiagnostics","m","add","extendContextScanner","scanner","push","registerGlobalMiddleware","middlewares","registerMiddleware","onReport","report","diag","hasDiagnostics","size","__resetPlugins","clear","length","performanceDiagnostics","params","next","deps","size","start","performance","now","instance","end","duration","console","log","token","name","toFixed","DiagnosticsDefaultReporter","onReport","report","console","log","totalNodes","unusedNodes","length","node","toString","state","enabled","enableIllumaDiagnostics","Illuma","extendDiagnostics","DiagnosticsDefaultReporter","registerGlobalMiddleware","performanceDiagnostics"]}