@lppedd/di-wise-neo 0.3.1 → 0.4.0

package/dist/cjs/index.js

@@ -209,10 +209,6 @@ function isClassProvider(provider) {
     return "useClass" in provider;
 }
 // @internal
-function isExistingProvider(provider) {
-    return "useExisting" in provider;
-}
-// @internal
 function isFactoryProvider(provider) {
     return "useFactory" in provider;
 }
@@ -220,6 +216,10 @@ function isFactoryProvider(provider) {
 function isValueProvider(provider) {
     return "useValue" in provider;
 }
+// @internal
+function isExistingProvider(provider) {
+    return "useExisting" in provider;
+}
 
 const Scope = {
     Inherited: "Inherited",
@@ -231,19 +231,19 @@ const Scope = {
 /**
  * Type API.
  */ /**
- * Create a type token.
+ * Creates a type token.
  *
  * @example
  * ```ts
- * const Spell = Type<Spell>("Spell");
+ * const ISpell = createType<Spell>("Spell");
  * ```
  *
  * @__NO_SIDE_EFFECTS__
- */ function Type(typeName) {
+ */ function createType(typeName) {
     const type = {
         name: `Type<${typeName}>`,
-        inter: Type,
-        union: Type,
+        inter: createType,
+        union: createType,
         toString () {
             return type.name;
         }
@@ -281,8 +281,8 @@ function getTypeName(value) {
 // @internal
 class TokenRegistry {
     constructor(parent){
-        this.parent = parent;
         this.myMap = new Map();
+        this.myParent = parent;
     }
     get(token) {
         // To clarify, at(-1) means we take the last added registration for this token
@@ -335,7 +335,7 @@ class TokenRegistry {
     }
     getAllFromParent(token) {
         const registrations = this.myMap.get(token);
-        return registrations || this.parent?.getAllFromParent(token);
+        return registrations || this.myParent?.getAllFromParent(token);
     }
 }
 // @internal
@@ -349,7 +349,7 @@ function isBuilder(provider) {
  * ```ts
  * class Wizard {
  *   wand = inject(
- *     Build(() => {
+ *     build(() => {
  *       const wand = inject(Wand);
  *       wand.owner = this;
  *       // ...
@@ -360,8 +360,8 @@ function isBuilder(provider) {
  * ```
  *
  * @__NO_SIDE_EFFECTS__
- */ function Build(factory) {
-    const token = Type(`Build<${getTypeName(factory)}>`);
+ */ function build(factory) {
+    const token = createType(`Build<${getTypeName(factory)}>`);
     const provider = {
         useFactory: factory
     };
@@ -386,12 +386,11 @@ function isDisposable(value) {
 
 /**
  * The default implementation of a di-wise-neo {@link Container}.
- */ class DefaultContainer {
-    constructor(myParent, options){
-        this.myParent = myParent;
-        // eslint-disable-next-line no-use-before-define
+ */ class ContainerImpl {
+    constructor(parent, options){
         this.myChildren = new Set();
         this.myDisposed = false;
+        this.myParent = parent;
         this.myOptions = {
             autoRegister: false,
             defaultScope: Scope.Inherited,
@@ -415,7 +414,7 @@ function isDisposable(value) {
     }
     createChild(options) {
         this.checkDisposed();
-        const container = new DefaultContainer(this, {
+        const container = new ContainerImpl(this, {
             ...this.myOptions,
             ...options
         });
@@ -462,6 +461,36 @@ function isDisposable(value) {
         this.checkDisposed();
         return this.myTokenRegistry.get(token) !== undefined;
     }
+    registerClass(token, Class, options) {
+        // This mess will go away once/if we remove the register method
+        // in favor of the multiple specialized ones
+        if (Class) {
+            const ctor = Class ?? token;
+            this.register(token, {
+                useClass: ctor
+            }, options);
+        } else {
+            this.register(token);
+        }
+    }
+    registerFactory(token, factory, options) {
+        this.register(token, {
+            useFactory: factory
+        }, options);
+    }
+    registerValue(token, value) {
+        this.register(token, {
+            useValue: value
+        });
+    }
+    registerAlias(targetToken, aliasTokens) {
+        // De-duplicate tokens
+        for (const alias of new Set(aliasTokens)){
+            this.register(alias, {
+                useExisting: targetToken
+            });
+        }
+    }
     register(...args) {
         this.checkDisposed();
         if (args.length == 1) {
@@ -787,12 +816,12 @@ function isDisposable(value) {
     autoRegister: false,
     defaultScope: Scope.Inherited
 }) {
-    return new DefaultContainer(undefined, options);
+    return new ContainerImpl(undefined, options);
 }
 
 /**
- * Class decorator for enabling auto-registration of an unregistered class
- * when first resolving it from the container.
+ * Class decorator that enables auto-registration of an unregistered class,
+ * when the class is first resolved from the container.
  *
  * @example
  * ```ts
@@ -961,7 +990,7 @@ function OptionalAll(token) {
  * const wizard = container.resolve(Wizard);
  * wizard.getWand(); // => Wand
  * ```
- */ const Injector = /*@__PURE__*/ Build(function Injector() {
+ */ const Injector = /*@__PURE__*/ build(function Injector() {
     const context = ensureInjectionContext(Injector);
     const resolution = context.resolution;
     const dependentFrame = resolution.stack.peek();
@@ -992,7 +1021,7 @@ function OptionalAll(token) {
 });
 
 /**
- * Apply middleware functions to a container.
+ * Applies middleware functions to a container.
  *
  * Middlewares are applied in array order, but execute in reverse order.
  *
@@ -1036,7 +1065,6 @@ function OptionalAll(token) {
 }
 
 exports.AutoRegister = AutoRegister;
-exports.Build = Build;
 exports.Inject = Inject;
 exports.InjectAll = InjectAll;
 exports.Injectable = Injectable;
@@ -1045,9 +1073,10 @@ exports.Optional = Optional;
 exports.OptionalAll = OptionalAll;
 exports.Scope = Scope;
 exports.Scoped = Scoped;
-exports.Type = Type;
 exports.applyMiddleware = applyMiddleware;
+exports.build = build;
 exports.createContainer = createContainer;
+exports.createType = createType;
 exports.forwardRef = forwardRef;
 exports.inject = inject;
 exports.injectAll = injectAll;