@kyrielle/injector 2.0.0-alpha.0 → 2.0.0-alpha.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Julien Capellari
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Julien Capellari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser.d.ts

@@ -0,0 +1,25 @@
+export * from './common.js';
+/**
+ * Returns current scope.
+ *
+ * @version 2.0.0
+ */
+export declare const currentScope$: () => import("./common.js").Scope;
+/**
+ * Creates an instance of token, using and storing in scope.
+ *
+ * @version 1.0.0
+ */
+export declare const inject$: <T>(token: import("./common.js").Token<T>, scope?: import("./common.js").Scope) => T;
+/**
+ * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.
+ *
+ * @version 2.0.0
+ */
+export declare const runIn$: <T>(scope: import("./common.js").Scope, fn: () => T) => T;
+/**
+ * Creates a new {@link ChildScope}, with a given parent defaulting to current scope
+ *
+ * @version 1.0.0
+ */
+export declare const scope$: (name: string, parent?: import("./common.js").Scope) => import("./common.js").ChildScope;

package/dist/browser.js

@@ -0,0 +1,29 @@
+import { createCurrentScope$ } from './current-scope.js';
+import { createInject$ } from './inject.js';
+import { BrowserContext } from './internals/BrowserContext.js';
+import { createRunIn$ } from './run-in.js';
+import { createScope$ } from './scope.js';
+const context = new BrowserContext();
+export * from './common.js';
+/**
+ * Returns current scope.
+ *
+ * @version 2.0.0
+ */ export const currentScope$ = createCurrentScope$(context);
+/**
+ * Creates an instance of token, using and storing in scope.
+ *
+ * @version 1.0.0
+ */ export const inject$ = createInject$(context);
+/**
+ * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.
+ *
+ * @version 2.0.0
+ */ export const runIn$ = createRunIn$(context);
+/**
+ * Creates a new {@link ChildScope}, with a given parent defaulting to current scope
+ *
+ * @version 1.0.0
+ */ export const scope$ = createScope$(context);
+
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser.ts"],"sourcesContent":["import { createCurrentScope$ } from './current-scope.js';\nimport { createInject$ } from './inject.js';\nimport { BrowserContext } from './internals/BrowserContext.js';\nimport { createRunIn$ } from './run-in.js';\nimport { createScope$ } from './scope.js';\n\nconst context = new BrowserContext();\n\nexport * from './common.js';\n\n/**\n * Returns current scope.\n *\n * @version 2.0.0\n */\nexport const currentScope$ = createCurrentScope$(context);\n\n/**\n * Creates an instance of token, using and storing in scope.\n *\n * @version 1.0.0\n */\nexport const inject$ = createInject$(context);\n\n/**\n * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.\n *\n * @version 2.0.0\n */\nexport const runIn$ = createRunIn$(context);\n\n/**\n * Creates a new {@link ChildScope}, with a given parent defaulting to current scope\n *\n * @version 1.0.0\n */\nexport const scope$ = createScope$(context);"],"names":["createCurrentScope$","createInject$","BrowserContext","createRunIn$","createScope$","context","currentScope$","inject$","runIn$","scope$"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,qBAAqB;AACzD,SAASC,aAAa,QAAQ,cAAc;AAC5C,SAASC,cAAc,QAAQ,gCAAgC;AAC/D,SAASC,YAAY,QAAQ,cAAc;AAC3C,SAASC,YAAY,QAAQ,aAAa;AAE1C,MAAMC,UAAU,IAAIH;AAEpB,cAAc,cAAc;AAE5B;;;;CAIC,GACD,OAAO,MAAMI,gBAAgBN,oBAAoBK,SAAS;AAE1D;;;;CAIC,GACD,OAAO,MAAME,UAAUN,cAAcI,SAAS;AAE9C;;;;CAIC,GACD,OAAO,MAAMG,SAASL,aAAaE,SAAS;AAE5C;;;;CAIC,GACD,OAAO,MAAMI,SAASL,aAAaC,SAAS"}

package/dist/{index.d.ts → common.d.ts}

@@ -1,6 +1,4 @@
 export * from './defs/index.js';
-export * from './async-scope.js';
 export * from './global-scope.js';
-export * from './inject.js';
-export * from './scope.js';
 export * from './token.js';
+export * from './root-scope.js';

package/dist/common.js

@@ -0,0 +1,6 @@
+export * from './defs/index.js';
+export * from './global-scope.js';
+export * from './token.js';
+export * from './root-scope.js';
+
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common.ts"],"sourcesContent":["export * from './defs/index.js';\n\nexport * from './global-scope.js';\nexport * from './token.js';\nexport * from './root-scope.js';\n"],"names":[],"mappings":"AAAA,cAAc,kBAAkB;AAEhC,cAAc,oBAAoB;AAClC,cAAc,aAAa;AAC3B,cAAc,kBAAkB"}

package/dist/current-scope.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/current-scope.js

@@ -0,0 +1,7 @@
+/** @internal */ export function createCurrentScope$(context) {
+    return function currentScope$() {
+        return context.getScope();
+    };
+}
+
+//# sourceMappingURL=current-scope.js.map

package/dist/current-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/current-scope.ts"],"sourcesContent":["import type { Scope } from './defs/index.js';\nimport type { InjectionContext } from './internals/InjectionContext.js';\n\n/** @internal */\nexport function createCurrentScope$(context: InjectionContext) {\n  return function currentScope$(): Scope {\n    return context.getScope();\n  };\n}\n"],"names":["createCurrentScope$","context","currentScope$","getScope"],"mappings":"AAGA,cAAc,GACd,OAAO,SAASA,oBAAoBC,OAAyB;IAC3D,OAAO,SAASC;QACd,OAAOD,QAAQE,QAAQ;IACzB;AACF"}

package/dist/defs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/defs/index.ts"],"sourcesContent":["export * from './injectable.js';\r\nexport * from './scope.js';\r\nexport * from './token.js';"],"names":[],"mappings":"AAAA,cAAc,kBAAkB;AAChC,cAAc,aAAa;AAC3B,cAAc,aAAa"}
+{"version":3,"sources":["../../src/defs/index.ts"],"sourcesContent":["export * from './injectable.js';\nexport * from './scope.js';\nexport * from './token.js';"],"names":[],"mappings":"AAAA,cAAc,kBAAkB;AAChC,cAAc,aAAa;AAC3B,cAAc,aAAa"}

package/dist/defs/injectable.js

@@ -1,5 +1,5 @@
-/**
- * Extract value type from an Injectable type
+/**
+ * Extract value type from an Injectable type
  */ export { };
 
 //# sourceMappingURL=injectable.js.map

package/dist/defs/injectable.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/defs/injectable.ts"],"sourcesContent":["import type { Scope } from './scope.js';\r\n\r\n/**\r\n * Object that can be injected.\r\n */\r\nexport interface Injectable<out T = unknown> {\r\n  /**\r\n   * Create a new instance of objet, and store it in a scope.\r\n   * @param scope Scope used to store instance, defaults to global scope.\r\n   */\r\n  inject(scope: Scope): T;\r\n}\r\n\r\n/**\r\n * Object that can be asynchronously injected.\r\n */\r\nexport interface AsyncInjectable<out T = unknown> extends Injectable<PromiseLike<T>> {}\r\n\r\n/**\r\n * Extract value type from an Injectable type\r\n */\r\nexport type InjectedValue<R extends Injectable> = R extends Injectable<infer D> ? D : never;"],"names":[],"mappings":"AAkBA;;CAEC,GACD,WAA4F"}
+{"version":3,"sources":["../../src/defs/injectable.ts"],"sourcesContent":["import type { Scope } from './scope.js';\n\n/**\n * Object that can be injected.\n */\nexport interface Injectable<out T = unknown> {\n  /**\n   * Create a new instance of objet, and store it in a scope.\n   * @param scope Scope used to store instance, defaults to global scope.\n   */\n  inject(scope: Scope): T;\n}\n\n/**\n * Object that can be asynchronously injected.\n */\nexport interface AsyncInjectable<out T = unknown> extends Injectable<PromiseLike<T>> {}\n\n/**\n * Extract value type from an Injectable type\n */\nexport type InjectedValue<R extends Injectable> = R extends Injectable<infer D> ? D : never;"],"names":[],"mappings":"AAkBA;;CAEC,GACD,WAA4F"}

package/dist/defs/scope.d.ts

@@ -3,6 +3,7 @@ import type { Token } from './token.js';
  * Root scope, map matching tokens to instances
  */
 export interface RootScope {
+    readonly name: string;
     /**
      * Return value stored at given token
      */
@@ -20,7 +21,6 @@ export interface RootScope {
  * Child scope, map matching tokens to instances, with inheritance.
  */
 export interface ChildScope extends RootScope {
-    readonly name: string;
     readonly parentScope: Scope;
 }
 export type Scope = RootScope | ChildScope;

package/dist/defs/scope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/defs/scope.ts"],"sourcesContent":["import type { Token } from './token.js';\r\n\r\n/**\r\n * Root scope, map matching tokens to instances\r\n */\r\nexport interface RootScope {\r\n  /**\r\n   * Return value stored at given token\r\n   */\r\n  get<T>(token: Token<T>): T | undefined;\r\n\r\n  /**\r\n   * Update value stored at given token\r\n   */\r\n  set<T>(token: Token<T>, obj: T): void;\r\n\r\n  /**\r\n   * Removes all token stored in the current scope\r\n   */\r\n  clear(): void;\r\n}\r\n\r\n/**\r\n * Child scope, map matching tokens to instances, with inheritance.\r\n */\r\nexport interface ChildScope extends RootScope {\r\n  readonly name: string;\r\n  readonly parentScope: Scope;\r\n}\r\n\r\nexport type Scope = RootScope | ChildScope;"],"names":[],"mappings":"AA8BA,WAA2C"}
+{"version":3,"sources":["../../src/defs/scope.ts"],"sourcesContent":["import type { Token } from './token.js';\n\n/**\n * Root scope, map matching tokens to instances\n */\nexport interface RootScope {\n  readonly name: string;\n\n  /**\n   * Return value stored at given token\n   */\n  get<T>(token: Token<T>): T | undefined;\n\n  /**\n   * Update value stored at given token\n   */\n  set<T>(token: Token<T>, obj: T): void;\n\n  /**\n   * Removes all token stored in the current scope\n   */\n  clear(): void;\n}\n\n/**\n * Child scope, map matching tokens to instances, with inheritance.\n */\nexport interface ChildScope extends RootScope {\n  readonly parentScope: Scope;\n}\n\nexport type Scope = RootScope | ChildScope;"],"names":[],"mappings":"AA+BA,WAA2C"}

package/dist/defs/token.d.ts

@@ -1,10 +1,10 @@
 import type { Injectable } from './injectable.js';
 /**
- * Class based token
+ * Class-based token
  */
 export type ClassToken<out T = unknown> = new () => T;
 /**
- * Symbol based token
+ * Symbol-based token
  */
 export type SymbolToken<T = unknown> = symbol & Injectable<T>;
 export type Token<T = unknown> = ClassToken<T> | SymbolToken<T>;

package/dist/defs/token.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/defs/token.ts"],"sourcesContent":["import type { Injectable } from './injectable.js';\r\n\r\n/**\r\n * Class based token\r\n */\r\nexport type ClassToken<out T = unknown> = new () => T;\r\n\r\n/**\r\n * Symbol based token\r\n */\r\nexport type SymbolToken<T = unknown> = symbol & Injectable<T>;\r\n\r\nexport type Token<T = unknown> = ClassToken<T> | SymbolToken<T>;"],"names":[],"mappings":"AAYA,WAAgE"}
+{"version":3,"sources":["../../src/defs/token.ts"],"sourcesContent":["import type { Injectable } from './injectable.js';\n\n/**\n * Class-based token\n */\nexport type ClassToken<out T = unknown> = new () => T;\n\n/**\n * Symbol-based token\n */\nexport type SymbolToken<T = unknown> = symbol & Injectable<T>;\n\nexport type Token<T = unknown> = ClassToken<T> | SymbolToken<T>;"],"names":[],"mappings":"AAYA,WAAgE"}

package/dist/global-scope.d.ts

@@ -1,6 +1,6 @@
 import type { RootScope } from './defs/index.js';
 /**
- * Returns a new {@link RootScope}
+ * Returns the global {@link RootScope}
  *
  * @version 1.0.0
  */

package/dist/global-scope.js

@@ -1,12 +1,13 @@
 // Constants
 const GLOBAL_SCOPE_MAP = Symbol.for('kyrielle/injector:GLOBAL_SCOPE_MAP');
-/**
- * Returns a new {@link RootScope}
- *
- * @version 1.0.0
+/**
+ * Returns the global {@link RootScope}
+ *
+ * @version 1.0.0
  */ export function globalScope$() {
     const map = globalThis[GLOBAL_SCOPE_MAP] ??= new Map();
     return {
+        name: '[[global]]',
         get: (token)=>map.get(token),
         set: (token, value)=>map.set(token, value),
         clear: ()=>map.clear()

package/dist/global-scope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/global-scope.ts"],"sourcesContent":["import type { RootScope, Token } from './defs/index.js';\r\n\r\n// Constants\r\nconst GLOBAL_SCOPE_MAP = Symbol.for('kyrielle/injector:GLOBAL_SCOPE_MAP');\r\n\r\n/**\r\n * Returns a new {@link RootScope}\r\n *\r\n * @version 1.0.0\r\n */\r\nexport function globalScope$(): RootScope {\r\n  const map = (globalThis as { [GLOBAL_SCOPE_MAP]?: Map<Token, unknown> })[GLOBAL_SCOPE_MAP] ??= new Map();\r\n\r\n  return {\r\n    get: <T>(token: Token<T>) => map.get(token) as T,\r\n    set: (token, value) => map.set(token, value),\r\n    clear: () => map.clear(),\r\n  };\r\n}\r\n"],"names":["GLOBAL_SCOPE_MAP","Symbol","for","globalScope$","map","globalThis","Map","get","token","set","value","clear"],"mappings":"AAEA,YAAY;AACZ,MAAMA,mBAAmBC,OAAOC,GAAG,CAAC;AAEpC;;;;CAIC,GACD,OAAO,SAASC;IACd,MAAMC,MAAM,AAACC,UAA2D,CAACL,iBAAiB,KAAK,IAAIM;IAEnG,OAAO;QACLC,KAAK,CAAIC,QAAoBJ,IAAIG,GAAG,CAACC;QACrCC,KAAK,CAACD,OAAOE,QAAUN,IAAIK,GAAG,CAACD,OAAOE;QACtCC,OAAO,IAAMP,IAAIO,KAAK;IACxB;AACF"}
+{"version":3,"sources":["../src/global-scope.ts"],"sourcesContent":["import type { RootScope, Token } from './defs/index.js';\n\n// Constants\nconst GLOBAL_SCOPE_MAP = Symbol.for('kyrielle/injector:GLOBAL_SCOPE_MAP');\n\n/**\n * Returns the global {@link RootScope}\n *\n * @version 1.0.0\n */\nexport function globalScope$(): RootScope {\n  const map = (globalThis as { [GLOBAL_SCOPE_MAP]?: Map<Token, unknown> })[GLOBAL_SCOPE_MAP] ??= new Map();\n\n  return {\n    name: '[[global]]',\n    get: <T>(token: Token<T>) => map.get(token) as T,\n    set: (token, value) => map.set(token, value),\n    clear: () => map.clear(),\n  };\n}\n"],"names":["GLOBAL_SCOPE_MAP","Symbol","for","globalScope$","map","globalThis","Map","name","get","token","set","value","clear"],"mappings":"AAEA,YAAY;AACZ,MAAMA,mBAAmBC,OAAOC,GAAG,CAAC;AAEpC;;;;CAIC,GACD,OAAO,SAASC;IACd,MAAMC,MAAM,AAACC,UAA2D,CAACL,iBAAiB,KAAK,IAAIM;IAEnG,OAAO;QACLC,MAAM;QACNC,KAAK,CAAIC,QAAoBL,IAAII,GAAG,CAACC;QACrCC,KAAK,CAACD,OAAOE,QAAUP,IAAIM,GAAG,CAACD,OAAOE;QACtCC,OAAO,IAAMR,IAAIQ,KAAK;IACxB;AACF"}

package/dist/inject.d.ts

@@ -1,7 +1 @@
-import type { Scope, Token } from './defs/index.js';
-/**
- * Creates an instance of token, using & storing in scope.
- *
- * @version 1.0.0
- */
-export declare function inject$<T>(token: Token<T>, scope?: Scope): T;
+export {};

package/dist/inject.js

@@ -1,19 +1,16 @@
-import { globalScope$ } from './global-scope.js';
-/**
- * Creates an instance of token, using & storing in scope.
- *
- * @version 1.0.0
- */ export function inject$(token, scope = globalScope$()) {
-    let value = scope.get(token);
-    if (value === undefined) {
-        if (typeof token === 'function') {
-            value = new token();
-        } else {
-            value = token.inject(scope);
+/** @internal */ export function createInject$(context) {
+    return function inject$(token, scope = context.getScope()) {
+        let value = scope.get(token);
+        if (value === undefined) {
+            if (typeof token === 'function') {
+                value = context.runInScope(scope, ()=>new token());
+            } else {
+                value = context.runInScope(scope, ()=>token.inject(scope));
+            }
+            scope.set(token, value);
         }
-        scope.set(token, value);
-    }
-    return value;
+        return value;
+    };
 }
 
 //# sourceMappingURL=inject.js.map

package/dist/inject.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/inject.ts"],"sourcesContent":["import type { Scope, Token } from './defs/index.js';\r\nimport { globalScope$ } from './global-scope.js';\r\n\r\n/**\r\n * Creates an instance of token, using & storing in scope.\r\n *\r\n * @version 1.0.0\r\n */\r\nexport function inject$<T>(token: Token<T>, scope: Scope = globalScope$()): T {\r\n  let value = scope.get(token);\r\n\r\n  if (value === undefined) {\r\n    if (typeof token === 'function') {\r\n      value = new token();\r\n    } else {\r\n      value = token.inject(scope);\r\n    }\r\n\r\n    scope.set(token, value);\r\n  }\r\n\r\n  return value;\r\n}\r\n"],"names":["globalScope$","inject$","token","scope","value","get","undefined","inject","set"],"mappings":"AACA,SAASA,YAAY,QAAQ,oBAAoB;AAEjD;;;;CAIC,GACD,OAAO,SAASC,QAAWC,KAAe,EAAEC,QAAeH,cAAc;IACvE,IAAII,QAAQD,MAAME,GAAG,CAACH;IAEtB,IAAIE,UAAUE,WAAW;QACvB,IAAI,OAAOJ,UAAU,YAAY;YAC/BE,QAAQ,IAAIF;QACd,OAAO;YACLE,QAAQF,MAAMK,MAAM,CAACJ;QACvB;QAEAA,MAAMK,GAAG,CAACN,OAAOE;IACnB;IAEA,OAAOA;AACT"}
+{"version":3,"sources":["../src/inject.ts"],"sourcesContent":["import type { InjectionContext } from './internals/InjectionContext.js';\nimport type { Scope, Token } from './defs/index.js';\n\n/** @internal */\nexport function createInject$(context: InjectionContext) {\n  return function inject$<T>(token: Token<T>, scope: Scope = context.getScope()): T {\n    let value = scope.get(token);\n\n    if (value === undefined) {\n      if (typeof token === 'function') {\n        value = context.runInScope(scope, () => new token());\n      } else {\n        value = context.runInScope(scope, () => token.inject(scope));\n      }\n\n      scope.set(token, value);\n    }\n\n    return value;\n  };\n}"],"names":["createInject$","context","inject$","token","scope","getScope","value","get","undefined","runInScope","inject","set"],"mappings":"AAGA,cAAc,GACd,OAAO,SAASA,cAAcC,OAAyB;IACrD,OAAO,SAASC,QAAWC,KAAe,EAAEC,QAAeH,QAAQI,QAAQ,EAAE;QAC3E,IAAIC,QAAQF,MAAMG,GAAG,CAACJ;QAEtB,IAAIG,UAAUE,WAAW;YACvB,IAAI,OAAOL,UAAU,YAAY;gBAC/BG,QAAQL,QAAQQ,UAAU,CAACL,OAAO,IAAM,IAAID;YAC9C,OAAO;gBACLG,QAAQL,QAAQQ,UAAU,CAACL,OAAO,IAAMD,MAAMO,MAAM,CAACN;YACvD;YAEAA,MAAMO,GAAG,CAACR,OAAOG;QACnB;QAEA,OAAOA;IACT;AACF"}

package/dist/internals/BrowserContext.d.ts

@@ -0,0 +1,7 @@
+import type { Scope } from '../defs/index.js';
+import type { InjectionContext } from './InjectionContext.js';
+export declare class BrowserContext implements InjectionContext {
+    private _scope;
+    getScope(): Scope;
+    runInScope<T>(scope: Scope, fn: () => T): T;
+}

package/dist/internals/BrowserContext.js

@@ -0,0 +1,23 @@
+import { globalScope$ } from '../global-scope.js';
+import { UnsupportedAsyncToken } from './UnsupportedAsyncToken.js';
+export class BrowserContext {
+    _scope = globalScope$();
+    getScope() {
+        return this._scope;
+    }
+    runInScope(scope, fn) {
+        const oldScope = this._scope;
+        this._scope = scope;
+        try {
+            const result = fn();
+            if (result instanceof Promise) {
+                throw new UnsupportedAsyncToken('Async tokens are not supported in browsers');
+            }
+            return result;
+        } finally{
+            this._scope = oldScope;
+        }
+    }
+}
+
+//# sourceMappingURL=BrowserContext.js.map

package/dist/internals/BrowserContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/BrowserContext.ts"],"sourcesContent":["import type { Scope } from '../defs/index.js';\nimport type { InjectionContext } from './InjectionContext.js';\nimport { globalScope$ } from '../global-scope.js';\nimport { UnsupportedAsyncToken } from './UnsupportedAsyncToken.js';\n\nexport class BrowserContext implements InjectionContext {\n  private _scope: Scope = globalScope$();\n\n  getScope(): Scope {\n    return this._scope;\n  }\n\n  runInScope<T>(scope: Scope, fn: () => T): T {\n    const oldScope = this._scope;\n    this._scope = scope;\n\n    try {\n      const result = fn();\n\n      if (result instanceof Promise) {\n        throw new UnsupportedAsyncToken('Async tokens are not supported in browsers');\n      }\n\n      return result;\n    } finally {\n      this._scope = oldScope;\n    }\n  }\n}"],"names":["globalScope$","UnsupportedAsyncToken","BrowserContext","_scope","getScope","runInScope","scope","fn","oldScope","result","Promise"],"mappings":"AAEA,SAASA,YAAY,QAAQ,qBAAqB;AAClD,SAASC,qBAAqB,QAAQ,6BAA6B;AAEnE,OAAO,MAAMC;IACHC,SAAgBH,eAAe;IAEvCI,WAAkB;QAChB,OAAO,IAAI,CAACD,MAAM;IACpB;IAEAE,WAAcC,KAAY,EAAEC,EAAW,EAAK;QAC1C,MAAMC,WAAW,IAAI,CAACL,MAAM;QAC5B,IAAI,CAACA,MAAM,GAAGG;QAEd,IAAI;YACF,MAAMG,SAASF;YAEf,IAAIE,kBAAkBC,SAAS;gBAC7B,MAAM,IAAIT,sBAAsB;YAClC;YAEA,OAAOQ;QACT,SAAU;YACR,IAAI,CAACN,MAAM,GAAGK;QAChB;IACF;AACF"}

package/dist/internals/InjectionContext.d.ts

@@ -0,0 +1,12 @@
+import type { Scope } from '../defs/scope.js';
+export interface InjectionContext {
+    /**
+     * Returns the current scope.
+     */
+    getScope(): Scope;
+    /**
+     * Runs the given function within the given scope.
+     * Any {@link getScope} call made within the function will return the given scope.
+     */
+    runInScope<T>(scope: Scope, fn: () => T): T;
+}

package/dist/internals/InjectionContext.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=InjectionContext.js.map

package/dist/internals/InjectionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/InjectionContext.ts"],"sourcesContent":["import type { Scope } from '../defs/scope.js';\n\nexport interface InjectionContext {\n  /**\n   * Returns the current scope.\n   */\n  getScope(): Scope;\n\n  /**\n   * Runs the given function within the given scope.\n   * Any {@link getScope} call made within the function will return the given scope.\n   */\n  runInScope<T>(scope: Scope, fn: () => T): T;\n}"],"names":[],"mappings":"AAEA,WAWC"}

package/dist/internals/NodeContext.d.ts

@@ -0,0 +1,7 @@
+import type { InjectionContext } from './InjectionContext.js';
+import type { Scope } from '../defs/index.js';
+export declare class NodeContext implements InjectionContext {
+    private readonly _storage;
+    getScope(): Scope;
+    runInScope<T>(scope: Scope, fn: () => T): T;
+}

package/dist/internals/NodeContext.js

@@ -0,0 +1,13 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { globalScope$ } from '../global-scope.js';
+export class NodeContext {
+    _storage = new AsyncLocalStorage();
+    getScope() {
+        return this._storage.getStore() ?? globalScope$();
+    }
+    runInScope(scope, fn) {
+        return this._storage.run(scope, fn);
+    }
+}
+
+//# sourceMappingURL=NodeContext.js.map

package/dist/internals/NodeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/NodeContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { globalScope$ } from '../global-scope.js';\nimport type { InjectionContext } from './InjectionContext.js';\nimport type { Scope } from '../defs/index.js';\n\nexport class NodeContext implements InjectionContext {\n  private readonly _storage = new AsyncLocalStorage<Scope>();\n\n  getScope(): Scope {\n    return this._storage.getStore() ?? globalScope$();\n  }\n\n  runInScope<T>(scope: Scope, fn: () => T): T {\n    return this._storage.run(scope, fn);\n  }\n}"],"names":["AsyncLocalStorage","globalScope$","NodeContext","_storage","getScope","getStore","runInScope","scope","fn","run"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,mBAAmB;AACrD,SAASC,YAAY,QAAQ,qBAAqB;AAIlD,OAAO,MAAMC;IACMC,WAAW,IAAIH,oBAA2B;IAE3DI,WAAkB;QAChB,OAAO,IAAI,CAACD,QAAQ,CAACE,QAAQ,MAAMJ;IACrC;IAEAK,WAAcC,KAAY,EAAEC,EAAW,EAAK;QAC1C,OAAO,IAAI,CAACL,QAAQ,CAACM,GAAG,CAACF,OAAOC;IAClC;AACF"}

package/dist/internals/UnsupportedAsyncToken.d.ts

@@ -0,0 +1,2 @@
+export declare class UnsupportedAsyncToken extends Error {
+}

package/dist/internals/UnsupportedAsyncToken.js

@@ -0,0 +1,4 @@
+export class UnsupportedAsyncToken extends Error {
+}
+
+//# sourceMappingURL=UnsupportedAsyncToken.js.map

package/dist/internals/UnsupportedAsyncToken.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/UnsupportedAsyncToken.ts"],"sourcesContent":["export class UnsupportedAsyncToken extends Error {}"],"names":["UnsupportedAsyncToken","Error"],"mappings":"AAAA,OAAO,MAAMA,8BAA8BC;AAAO"}

package/dist/node.d.ts

@@ -0,0 +1,25 @@
+export * from './common.js';
+/**
+ * Returns current scope.
+ *
+ * @version 2.0.0
+ */
+export declare const currentScope$: () => import("./common.js").Scope;
+/**
+ * Creates an instance of token, using and storing in scope.
+ *
+ * @version 1.0.0
+ */
+export declare const inject$: <T>(token: import("./common.js").Token<T>, scope?: import("./common.js").Scope) => T;
+/**
+ * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.
+ *
+ * @version 2.0.0
+ */
+export declare const runIn$: <T>(scope: import("./common.js").Scope, fn: () => T) => T;
+/**
+ * Creates a new {@link ChildScope}, with a given parent defaulting to current scope
+ *
+ * @version 1.0.0
+ */
+export declare const scope$: (name: string, parent?: import("./common.js").Scope) => import("./common.js").ChildScope;

package/dist/node.js

@@ -0,0 +1,29 @@
+import { createCurrentScope$ } from './current-scope.js';
+import { createInject$ } from './inject.js';
+import { NodeContext } from './internals/NodeContext.js';
+import { createRunIn$ } from './run-in.js';
+import { createScope$ } from './scope.js';
+const context = new NodeContext();
+export * from './common.js';
+/**
+ * Returns current scope.
+ *
+ * @version 2.0.0
+ */ export const currentScope$ = createCurrentScope$(context);
+/**
+ * Creates an instance of token, using and storing in scope.
+ *
+ * @version 1.0.0
+ */ export const inject$ = createInject$(context);
+/**
+ * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.
+ *
+ * @version 2.0.0
+ */ export const runIn$ = createRunIn$(context);
+/**
+ * Creates a new {@link ChildScope}, with a given parent defaulting to current scope
+ *
+ * @version 1.0.0
+ */ export const scope$ = createScope$(context);
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts"],"sourcesContent":["import { createCurrentScope$ } from './current-scope.js';\nimport { createInject$ } from './inject.js';\nimport { NodeContext } from './internals/NodeContext.js';\nimport { createRunIn$ } from './run-in.js';\nimport { createScope$ } from './scope.js';\n\nconst context = new NodeContext();\n\nexport * from './common.js';\n\n/**\n * Returns current scope.\n *\n * @version 2.0.0\n */\nexport const currentScope$ = createCurrentScope$(context);\n\n/**\n * Creates an instance of token, using and storing in scope.\n *\n * @version 1.0.0\n */\nexport const inject$ = createInject$(context);\n\n/**\n * Runs a function in a given scope. Any {@link inject$} calls within the function will use the provided scope by default.\n *\n * @version 2.0.0\n */\nexport const runIn$ = createRunIn$(context);\n\n/**\n * Creates a new {@link ChildScope}, with a given parent defaulting to current scope\n *\n * @version 1.0.0\n */\nexport const scope$ = createScope$(context);"],"names":["createCurrentScope$","createInject$","NodeContext","createRunIn$","createScope$","context","currentScope$","inject$","runIn$","scope$"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,qBAAqB;AACzD,SAASC,aAAa,QAAQ,cAAc;AAC5C,SAASC,WAAW,QAAQ,6BAA6B;AACzD,SAASC,YAAY,QAAQ,cAAc;AAC3C,SAASC,YAAY,QAAQ,aAAa;AAE1C,MAAMC,UAAU,IAAIH;AAEpB,cAAc,cAAc;AAE5B;;;;CAIC,GACD,OAAO,MAAMI,gBAAgBN,oBAAoBK,SAAS;AAE1D;;;;CAIC,GACD,OAAO,MAAME,UAAUN,cAAcI,SAAS;AAE9C;;;;CAIC,GACD,OAAO,MAAMG,SAASL,aAAaE,SAAS;AAE5C;;;;CAIC,GACD,OAAO,MAAMI,SAASL,aAAaC,SAAS"}

package/dist/root-scope.d.ts

@@ -0,0 +1,7 @@
+import type { RootScope } from './defs/index.js';
+/**
+ * Returns a new {@link RootScope}
+ *
+ * @version 2.0.0
+ */
+export declare function rootScope$(name: string): RootScope;

package/dist/root-scope.js

@@ -0,0 +1,15 @@
+/**
+ * Returns a new {@link RootScope}
+ *
+ * @version 2.0.0
+ */ export function rootScope$(name) {
+    const map = new Map();
+    return {
+        name,
+        get: (token)=>map.get(token),
+        set: (token, value)=>map.set(token, value),
+        clear: ()=>map.clear()
+    };
+}
+
+//# sourceMappingURL=root-scope.js.map

package/dist/root-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/root-scope.ts"],"sourcesContent":["import type { RootScope, Token } from './defs/index.js';\n\n/**\n * Returns a new {@link RootScope}\n *\n * @version 2.0.0\n */\nexport function rootScope$(name: string): RootScope {\n  const map = new Map();\n\n  return {\n    name,\n    get: <T>(token: Token<T>) => map.get(token) as T,\n    set: (token, value) => map.set(token, value),\n    clear: () => map.clear(),\n  };\n}\n"],"names":["rootScope$","name","map","Map","get","token","set","value","clear"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,SAASA,WAAWC,IAAY;IACrC,MAAMC,MAAM,IAAIC;IAEhB,OAAO;QACLF;QACAG,KAAK,CAAIC,QAAoBH,IAAIE,GAAG,CAACC;QACrCC,KAAK,CAACD,OAAOE,QAAUL,IAAII,GAAG,CAACD,OAAOE;QACtCC,OAAO,IAAMN,IAAIM,KAAK;IACxB;AACF"}

package/dist/run-in.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/run-in.js

@@ -0,0 +1,7 @@
+/** @internal */ export function createRunIn$(context) {
+    return function runIn$(scope, fn) {
+        return context.runInScope(scope, fn);
+    };
+}
+
+//# sourceMappingURL=run-in.js.map

package/dist/run-in.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/run-in.ts"],"sourcesContent":["import type { Scope } from './defs/index.js';\nimport type { InjectionContext } from './internals/InjectionContext.js';\n\n/** @internal */\nexport function createRunIn$(context: InjectionContext) {\n  return function runIn$<T>(scope: Scope, fn: () => T): T {\n    return context.runInScope(scope, fn);\n  };\n}"],"names":["createRunIn$","context","runIn$","scope","fn","runInScope"],"mappings":"AAGA,cAAc,GACd,OAAO,SAASA,aAAaC,OAAyB;IACpD,OAAO,SAASC,OAAUC,KAAY,EAAEC,EAAW;QACjD,OAAOH,QAAQI,UAAU,CAACF,OAAOC;IACnC;AACF"}

package/dist/scope.d.ts

@@ -1,7 +1 @@
-import type { ChildScope, Scope } from './defs/index.js';
-/**
- * Creates a new {@link ChildScope}, with given parent defaulting to global scope
- *
- * @version 1.0.0
- */
-export declare function scope$(name: string, parent?: Scope): ChildScope;
+export {};

package/dist/scope.js

@@ -1,22 +1,19 @@
-import { globalScope$ } from './global-scope.js';
-/**
- * Creates a new {@link ChildScope}, with given parent defaulting to global scope
- *
- * @version 1.0.0
- */ export function scope$(name, parent = globalScope$()) {
-    const map = new Map();
-    return {
-        name,
-        parentScope: parent,
-        get (token) {
-            let value = map.get(token);
-            if (value === undefined) {
-                value = parent.get(token);
-            }
-            return value;
-        },
-        set: (token, value)=>map.set(token, value),
-        clear: ()=>map.clear()
+/** @internal */ export function createScope$(context) {
+    return function scope$(name, parent = context.getScope()) {
+        const map = new Map();
+        return {
+            name,
+            parentScope: parent,
+            get (token) {
+                let value = map.get(token);
+                if (value === undefined) {
+                    value = parent.get(token);
+                }
+                return value;
+            },
+            set: (token, value)=>map.set(token, value),
+            clear: ()=>map.clear()
+        };
     };
 }
 

package/dist/scope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/scope.ts"],"sourcesContent":["import type { ChildScope, Scope, Token } from './defs/index.js';\r\nimport { globalScope$ } from './global-scope.js';\r\n\r\n/**\r\n * Creates a new {@link ChildScope}, with given parent defaulting to global scope\r\n *\r\n * @version 1.0.0\r\n */\r\nexport function scope$(name: string, parent: Scope = globalScope$()): ChildScope {\r\n  const map = new Map<Token, unknown>();\r\n\r\n  return {\r\n    name,\r\n    parentScope: parent,\r\n    get<T>(token: Token<T>) {\r\n      let value = map.get(token) as T | undefined;\r\n\r\n      if (value === undefined) {\r\n        value = parent.get(token);\r\n      }\r\n\r\n      return value;\r\n    },\r\n    set: (token, value) => map.set(token, value),\r\n    clear: () => map.clear(),\r\n  };\r\n}\r\n"],"names":["globalScope$","scope$","name","parent","map","Map","parentScope","get","token","value","undefined","set","clear"],"mappings":"AACA,SAASA,YAAY,QAAQ,oBAAoB;AAEjD;;;;CAIC,GACD,OAAO,SAASC,OAAOC,IAAY,EAAEC,SAAgBH,cAAc;IACjE,MAAMI,MAAM,IAAIC;IAEhB,OAAO;QACLH;QACAI,aAAaH;QACbI,KAAOC,KAAe;YACpB,IAAIC,QAAQL,IAAIG,GAAG,CAACC;YAEpB,IAAIC,UAAUC,WAAW;gBACvBD,QAAQN,OAAOI,GAAG,CAACC;YACrB;YAEA,OAAOC;QACT;QACAE,KAAK,CAACH,OAAOC,QAAUL,IAAIO,GAAG,CAACH,OAAOC;QACtCG,OAAO,IAAMR,IAAIQ,KAAK;IACxB;AACF"}
+{"version":3,"sources":["../src/scope.ts"],"sourcesContent":["import type { InjectionContext } from './internals/InjectionContext.js';\nimport type { ChildScope, Scope, Token } from './defs/index.js';\n\n/** @internal */\nexport function createScope$(context: InjectionContext) {\n  return function scope$(name: string, parent: Scope = context.getScope()): ChildScope {\n    const map = new Map<Token, unknown>();\n\n    return {\n      name,\n      parentScope: parent,\n      get<T>(token: Token<T>) {\n        let value = map.get(token) as T | undefined;\n\n        if (value === undefined) {\n          value = parent.get(token);\n        }\n\n        return value;\n      },\n      set: (token, value) => map.set(token, value),\n      clear: () => map.clear(),\n    };\n  };\n}"],"names":["createScope$","context","scope$","name","parent","getScope","map","Map","parentScope","get","token","value","undefined","set","clear"],"mappings":"AAGA,cAAc,GACd,OAAO,SAASA,aAAaC,OAAyB;IACpD,OAAO,SAASC,OAAOC,IAAY,EAAEC,SAAgBH,QAAQI,QAAQ,EAAE;QACrE,MAAMC,MAAM,IAAIC;QAEhB,OAAO;YACLJ;YACAK,aAAaJ;YACbK,KAAOC,KAAe;gBACpB,IAAIC,QAAQL,IAAIG,GAAG,CAACC;gBAEpB,IAAIC,UAAUC,WAAW;oBACvBD,QAAQP,OAAOK,GAAG,CAACC;gBACrB;gBAEA,OAAOC;YACT;YACAE,KAAK,CAACH,OAAOC,QAAUL,IAAIO,GAAG,CAACH,OAAOC;YACtCG,OAAO,IAAMR,IAAIQ,KAAK;QACxB;IACF;AACF"}

package/dist/token.d.ts

@@ -1,6 +1,6 @@
 import { type Scope, type SymbolToken } from './defs/index.js';
 /**
- * Creates an injectable token, using init as instance creator.
+ * Creates an injectable token, using init as an instance creator.
  *
  * @version 1.0.0
  */

package/dist/token.js

@@ -1,7 +1,7 @@
-/**
- * Creates an injectable token, using init as instance creator.
- *
- * @version 1.0.0
+/**
+ * Creates an injectable token, using init as an instance creator.
+ *
+ * @version 1.0.0
  */ export function token$(name, init) {
     return Object.assign(Symbol(name), {
         inject: init

package/dist/token.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/token.ts"],"sourcesContent":["import { type Scope, type SymbolToken } from './defs/index.js';\r\n\r\n/**\r\n * Creates an injectable token, using init as instance creator.\r\n *\r\n * @version 1.0.0\r\n */\r\nexport function token$<T>(name: string, init: TokenInitCallback<T>): SymbolToken<T> {\r\n  return Object.assign(Symbol(name), {\r\n    inject: init,\r\n  });\r\n}\r\n\r\nexport type TokenInitCallback<out T> = (scope: Scope) => T;\r\n"],"names":["token$","name","init","Object","assign","Symbol","inject"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,SAASA,OAAUC,IAAY,EAAEC,IAA0B;IAChE,OAAOC,OAAOC,MAAM,CAACC,OAAOJ,OAAO;QACjCK,QAAQJ;IACV;AACF"}
+{"version":3,"sources":["../src/token.ts"],"sourcesContent":["import { type Scope, type SymbolToken } from './defs/index.js';\n\n/**\n * Creates an injectable token, using init as an instance creator.\n *\n * @version 1.0.0\n */\nexport function token$<T>(name: string, init: TokenInitCallback<T>): SymbolToken<T> {\n  return Object.assign(Symbol(name), {\n    inject: init,\n  });\n}\n\nexport type TokenInitCallback<out T> = (scope: Scope) => T;\n"],"names":["token$","name","init","Object","assign","Symbol","inject"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,SAASA,OAAUC,IAAY,EAAEC,IAA0B;IAChE,OAAOC,OAAOC,MAAM,CAACC,OAAOJ,OAAO;QACjCK,QAAQJ;IACV;AACF"}