@adimm/x-injection 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -106,7 +106,8 @@ declare class ProviderModuleUtils {
     /** The parent {@link IProviderModule | ProviderModule} of `this` instance. */
     readonly module: IProviderModule;
     readonly moduleNaked: IProviderModuleNaked;
-    constructor(module: IProviderModule);
+    private readonly appModule;
+    constructor(module: IProviderModule, internalOptions: ProviderModuleOptionsInternal);
     /**
      * Low-level method which can be used to manually register _(bind)_ a new {@link provider} into the {@link ProviderModuleUtils.module | module} container.
      *
@@ -118,6 +119,7 @@ declare class ProviderModuleUtils {
      * @returns `true` when the {@link provider} has been bound otherwhise `false`.
      */
     bindToContainer<T>(provider: DependencyProvider<T>, defaultScope: InjectionScope): boolean;
+    private checkIfShouldBeImportedIntoAppModule;
     private bindSelfTokenToContainer;
     private bindClassTokenToContainer;
     private bindValueTokenToContainer;
@@ -330,571 +332,592 @@ interface IProviderModuleNaked extends IProviderModule {
 }
 type LazyInitOptions = Except<ProviderModuleOptions & ProviderModuleOptionsInternal, 'identifier' | 'isAppModule'>;
 
-interface ProviderModuleOptions {
-    /** The module unique ID. */
-    identifier: symbol;
-    /** The list of imported {@link IProviderModule | modules} that export the {@link Provider | providers} which are required in this module. */
-    imports?: IProviderModule[];
-    /** The {@link DependencyProvider | providers} that will be instantiated by the container and that may be shared at least across this module. */
-    providers?: DependencyProvider[];
+/**
+ * The low-level App Container.
+ *
+ * **Internally used, please use the `AppModule` to interact with it.**
+ */
+declare const GlobalContainer: Container;
+
+/**
+ * Modules are highly recommended as an effective way to organize your components.
+ * For most applications, you'll likely have multiple modules, each encapsulating a closely related set of capabilities.
+ *
+ * _See {@link ProviderModuleOptions | ProviderModuleOptions}_.
+ *
+ * @example
+ * ```ts
+ * const EngineModule = new ProviderModule({
+ *   identifier: Symbol('EngineModule'),
+ *   providers: [EngineService],
+ *   exports: [EngineService]
+ * });
+ *
+ * const DashboardModule = new ProviderModule({
+ *   identifier: Symbol('DashboardModule'),
+ *   providers: [DashboardService],
+ *   exports: [DashboardService]
+ * });
+ *
+ * const CarModule = new ProviderModule({
+ *   identifier: Symbol('CarModule'),
+ *   imports: [EngineModule, DashboardModule],
+ *   providers: [CarService],
+ *   exports: [CarService]
+ * });
+ *
+ * // Run-time class replacement:
+ * const RedCarModule = new ProviderModule({
+ *   identifier: Symbol('RedCarModule'),
+ *   imports: [CarModule],
+ *   providers: [
+ *     {
+ *       provide: CarService,
+ *       useClass: RedCarService,
+ *     }
+ *   ],
+ * });
+ *
+ * // Run-time factory example:
+ * const BlackCarModule = new ProviderModule({
+ *   identifier: Symbol('BlackCarModule'),
+ *   imports: [CarModule],
+ *   providers: [
+ *     {
+ *       provide: CarService,
+ *       useFactory: (carService: CarService) => {
+ *         carService.setColor('black');
+ *
+ *         return carService;
+ *       },
+ *       inject: [CarService]
+ *     }
+ *   ],
+ * });
+ * ```
+ */
+declare class ProviderModule implements IProviderModule {
+    readonly identifier: symbol;
+    readonly isMarkedAsGlobal: boolean;
+    readonly isDisposed: boolean;
+    protected readonly isAppModule: boolean;
+    protected readonly container: Container;
+    protected readonly defaultScope: IProviderModuleNaked['defaultScope'];
+    protected readonly dynamicExports: IProviderModuleNaked['dynamicExports'];
+    protected readonly onReady: IProviderModuleNaked['onReady'];
+    protected readonly onDispose: IProviderModuleNaked['onDispose'];
+    protected readonly importedProvidersMap: IProviderModuleNaked['importedProvidersMap'];
+    protected readonly moduleUtils: IProviderModuleNaked['moduleUtils'];
+    protected readonly imports: IProviderModuleNaked['imports'];
+    protected readonly providers: IProviderModuleNaked['providers'];
+    protected readonly importedProviders: IProviderModuleNaked['importedProviders'];
+    protected readonly exports: IProviderModuleNaked['exports'];
+    private readonly registeredBindingSideEffects;
+    constructor({ identifier, imports, providers, exports, defaultScope, markAsGlobal, dynamicExports, onReady, onDispose, ..._internalParams }: ProviderModuleOptions);
+    get<T>(provider: ProviderToken<T>, isOptional?: boolean): T;
+    getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
+    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
+    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
+    toNaked(): IProviderModuleNaked;
+    clone(options?: CloneParams): IProviderModule;
+    toString(): string;
+    private setIdentifier;
+    private prepareContainer;
+    private injectImportedModules;
+    private injectProviders;
+    private registerBindingSideEffect;
+    private invokeRegisteredBindingSideEffects;
+    private removeRegisteredBindingSideEffects;
+    private shouldThrowWhenModuleDynamicExportsDontMatchTheStaticExports;
+    private shouldThrowIfDisposed;
     /**
-     * The subset of {@link ProviderToken | providers} or {@link IProviderModule | modules} that
-     * are provided by this module and should be available in other modules which import this module.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * _Check also the {@link dynamicExports} property._
+     * See {@link IProviderModuleNaked._dispose}.
      */
-    exports?: StaticExports;
+    protected _dispose(): Promise<void>;
     /**
-     * When provided, can be used to control which providers from the {@link ProviderModuleOptions.exports | exports}
-     * array should actually be exported into the importing module.
-     *
-     * **Note:** _Static {@link ProviderModuleOptions.exports | exports} should always be preferred as their static nature implies predictibility._
-     * _This is for advanced use cases only, and most probably you may never need to use a dynamic export!_
-     *
-     * To keep in mind in order to avoid nasty bugs:
-     * - You **must always** return only the providers/modules declared into the static {@link ProviderModuleOptions.exports | exports} array.
-     * - You **can** return _less_ providers/modules as long as they are still part of the static {@link ProviderModuleOptions.exports | exports} array.
-     * - You **cannot** return _more_ providers/modules than the static {@link ProviderModuleOptions.exports | exports} array!
-     *
-     * @example
-     * ```ts
-     * {
-     *   exports: [ConfigModule, UserModule, PaymentService, ReviewService],
-     *   dynamicExports: (importerModule, moduleExports) => {
-     *     const shouldExportOnlyTheServices = true;
-     *
-     *     if (shouldExportOnlyTheServices === false) return moduleExports;
-     *
-     *     return moduleExports.flatMap((ex) => {
-     *       // With `flatMap` we can map and filter out elements
-     *       // from the sequence at the same time
-     *       // by returning an empty array.
-     *       return ex instanceof ProviderModule ? [] : ex;
-     *     });
-     *   }
-     * }
-     *
-     * // Or
-     *
-     * {
-     *   exports: [ConfigModule, UserModule, PaymentService, ReviewService],
-     *   dynamicExports: (importerModule, moduleExports) => {
-     *     // We export all the providers only when the importer module is not the `BULLIED_MODULE`.
-     *     if (importerModule.toNaked().name !== 'BULLIED_MODULE') return moduleExports;
-     *
-     *     return [ConfigModule];
-     *   }
-     * }
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * ```
+     * See {@link IProviderModuleNaked._lazyInit}.
      */
-    dynamicExports?: DynamicExports;
+    protected _lazyInit({ markAsGlobal, imports, providers, exports, defaultScope, dynamicExports, onReady, onDispose, ..._internalParams }: LazyInitOptions): IProviderModule;
     /**
-     * The default {@link InjectionScope} to be used when a {@link ProviderToken} does not have a defined `scope`.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * Defaults to {@link InjectionScope.Singleton}.
+     * See {@link IProviderModuleNaked._getImportedModules}.
      */
-    defaultScope?: InjectionScope;
+    protected _getImportedModules(): IProviderModuleNaked[];
     /**
-     * Callback which will be invoked once the module container has been initialized
-     * and the providers resolved.
-     *
-     * **This happens only once, when the {@link IProviderModule | ProviderModule} has been bootstrapped!**
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * @param module The instance of the {@link IProviderModule | module}.
+     * See {@link IProviderModuleNaked._getProviders}.
      */
-    onReady?: (module: IProviderModule) => Promise<void>;
+    protected _getProviders(): DependencyProvider[];
     /**
-     * Callback which will be invoked whenever the internal module dispose method is invoked.
-     *
-     * **The method will be invoked right _before_ the clean-up process.**
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * @param module The instance of the {@link IProviderModule | module}.
+     * See {@link IProviderModuleNaked._getExportableModulesAndProviders}.
      */
-    onDispose?: (module: IProviderModule) => Promise<void>;
-}
-interface ProviderModuleOptionsInternal {
-    isAppModule?: boolean;
-    isDisposed?: boolean;
-    /** Can be used to manually provide a {@link Container} instance. */
-    container?: () => Container;
-    /** Can be used to override all the _imported_ providers _before_ the binding process. */
-    importedProvidersMap?: (
-    /** The current imported {@link DependencyProvider | provider} altered to use the module from where was imported for resolution. */
-    factorizedProvider: DependencyProvider<any>, 
-    /** The current imported {@link DependencyProvider | provider}. */
-    provider: DependencyProvider<any>, 
-    /** The {@link IProviderModule | module} from where the {@link DependencyProvider | provider} originated. */
-    module: IProviderModule) => DependencyProvider<any>;
-}
-type StaticExports = (ProviderToken | IProviderModule)[];
-type DynamicExports = (
-/** The {@link IProviderModule} which is importing this module. */
-importerModule: IProviderModule, 
-/** The {@link ProviderModuleOptions.exports | exports} array of this module. */
-moduleExports: StaticExports) => StaticExports;
-
-interface IProviderModule {
-    /** The module unique ID. */
-    readonly identifier: symbol;
-    readonly isDisposed: boolean;
+    protected _getExportableModulesAndProviders(): StaticExports;
     /**
-     * Can be used to retrieve a resolved `dependency` from the module container.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * @param provider The {@link ProviderToken}.
-     * @param isOptional When set to `false` _(default)_ an exception will be thrown when the {@link provider} isn't bound.
-     * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.
+     * See {@link IProviderModuleNaked._onBind}.
      */
-    get<T>(provider: ProviderToken<T>, isOptional?: boolean): T;
+    protected _onBind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
     /**
-     * Can be used to retrieve many resolved `dependencies` from the module container at once.
-     *
-     * @param deps Either one or more {@link ProviderToken}.
-     * @returns Tuple containing the {@link D | dependencies}.
-     *
-     * @example
-     * ```ts
-     * // When ProviderTokens are supplied, TS auto-inference works as expected.
-     * // `car` will infer the `Car` type, `engine` the `Engine` type and `dashboard` the `Dashboard` type.
-     * const [car, engine, dashboard] = AppModule.getMany(
-     *   Car,
-     *   Engine,
-     *   { provider: Dashboard, isOptional: true }
-     * );
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * // When auto-inference is not possible, you can manually cast the types.
-     * const [configService, userService] = AppModule.getMany<[typeof ConfigService, typeof UserService]>('CONFIG_SERVICE', UserService);
-     * // Now the `configService` is of type `ConfigService` and the `userService` is of type `UserService`.
-     * ```
+     * See {@link IProviderModuleNaked._onRebind}.
      */
-    getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
+    protected _onRebind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
     /**
-     * Adds an activation handler for the {@link provider}.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link https://inversify.io/docs/api/container/#onactivation} for more details.
+     * See {@link IProviderModuleNaked._onUnbind}.
      */
-    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
+    protected _onUnbind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
     /**
-     * Adds a deactivation handler for the {@link provider}.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link https://inversify.io/docs/api/container/#ondeactivation} for more details.
+     * See {@link IProviderModuleNaked._overwriteContainer}.
      */
-    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
+    protected _overwriteContainer(cb: () => Container): void;
     /**
-     * Casts the current module type to the {@link IProviderModuleNaked} type.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * **Internally used and for testing purposes!**
+     * See {@link IProviderModuleNaked.__bind}.
      */
-    toNaked(): IProviderModuleNaked;
+    protected __bind<T>(provider: ProviderToken<T>): BindToFluentSyntax<T>;
     /**
-     * Can be used to create a new instance of the current {@link IProviderModule | module}.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * **Note:** _All the providers will be registered again within the new module!_
-     * _And also the new module will still refrain values by reference to its parent module because of_
-     * _JS limitation in deeply/truly cloning an instance._
-     *
-     * @param options See {@link CloneParams}.
+     * See {@link IProviderModuleNaked.__get}.
      */
-    clone(options?: CloneParams): IProviderModule;
-    /** Returns the {@link IProviderModule.identifier} `symbol` description. */
-    toString(): string;
-}
-type ProviderModuleGetManySignature<Tokens extends (ProviderModuleGetManyParam<any> | ProviderToken)[]> = {
-    [K in keyof Tokens]: Tokens[K] extends ProviderModuleGetManyParam<infer U> ? U : Tokens[K] extends ProviderToken<infer T> ? T : Tokens[K] extends ProviderIdentifier<infer I> ? I : never;
-};
-type ProviderModuleGetManyParam<T> = {
-    /** The {@link ProviderToken}. */
-    provider: ProviderToken<T>;
-    /** When set to `false` _(default)_ an exception will be thrown when the {@link ProviderModuleGetManyParam.provider | provider} isn't bound. */
-    isOptional?: boolean;
-};
-interface CloneParams {
-    /** Can be used to override all the providers _before_ the binding process. */
-    providersMap?: (
-    /** The current {@link DependencyProvider | provider}. */
-    provider: DependencyProvider<any>, 
-    /** The {@link IProviderModule | module} from where the {@link DependencyProvider | provider} originated. */
-    module: IProviderModule) => DependencyProvider<any>;
-    /** Can be used to override all the _imported_ providers _before_ the binding process. */
-    importedProvidersMap?: ProviderModuleOptionsInternal['importedProvidersMap'];
-}
-
-interface IAppModule extends IProviderModule {
-    /** Must be invoked _(only once during the application lifecycle)_ in order to provide the {@link options} to the module. */
-    register<AsNaked extends boolean = false>(options: AppModuleOptions): AsNaked extends false ? IAppModule : IAppModule & IProviderModuleNaked;
-    toNaked(): IAppModule & IProviderModuleNaked;
-}
-type AppModuleOptions = Except<LazyInitOptions, 'exports' | 'dynamicExports'>;
-
-/** See {@link https://inversify.io/docs/api/decorator/#inject} for more details. */
-declare function Inject(provider: ProviderToken): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#multiinject} for more details. */
-declare function MultiInject(provider: ProviderToken): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#injectfrombase} for more details. */
-declare function InjectFromBase(options?: Parameters<typeof injectFromBase>[0]): ClassDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#named} for more details. */
-declare function Named(name: MetadataName): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#optional} for more details. */
-declare function Optional(): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#postconstruct} for more details. */
-declare function PostConstruct(): MethodDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#predestroy} for more details. */
-declare function PreDestroy(): MethodDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#tagged} for more details. */
-declare function Tagged(key: MetadataTag, value: unknown): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#unmanaged} for more details. */
-declare function Unmanaged(): MethodDecorator & ParameterDecorator & PropertyDecorator;
-
-/** Exception which indicates that there is a generic error. */
-declare class XInjectionError extends Error {
-    name: string;
-}
-
-/** Exception which indicates that there is a generic error with an instance of {@link IProviderModule}. */
-declare class XInjectionProviderModuleError extends Error {
-    name: string;
-    constructor(module: IProviderModule, message: string);
-}
-
-/** Exception which indicates an invokation of a disposed module.  */
-declare class XInjectionProviderModuleDisposedError extends XInjectionProviderModuleError {
-    name: string;
-    constructor(module: IProviderModule);
-}
-
-/**
- * Exception which indicates that an instance of {@link IProviderModule}
- * imports another module which dynamically exports its providers/modules and
- * is trying to dynamically export more or different providers/modules than the
- * ones declared into its static exports.
- */
-declare class XInjectionDynamicExportsOutOfRange extends XInjectionProviderModuleError {
-    name: string;
-    constructor(module: IProviderModule);
-}
-
-/** Exception which indicates that a module has been initialized without an `identifier`.  */
-declare class XInjectionProviderModuleMissingIdentifierError extends XInjectionProviderModuleError {
-    name: string;
-    constructor(module: IProviderModule);
-}
-
-declare function injectionScopeToBindingScope(injectionScope: InjectionScope): BindingScope;
-declare function bindingScopeToInjectionScope(bindingScope: BindingScope): InjectionScope;
-
-declare namespace ProviderTokenHelpers {
-    function isClassToken<T>(provider: ProviderToken<T>): provider is ProviderClassToken<T>;
-    function isValueToken<T>(provider: ProviderToken<T>): provider is ProviderValueToken<T>;
-    function isFactoryToken<T>(provider: ProviderToken<T>): provider is ProviderFactoryToken<T>;
-    function isProviderIdentifier<T = any>(value: any): value is ProviderIdentifier<T>;
-    function toServiceIdentifier<T = any>(provider: ProviderToken<T>): ServiceIdentifier<T>;
-    function toServiceIdentifiers(providers: ProviderToken[]): ServiceIdentifier<unknown>[];
-    function toDependencyProviderWithOptions<T extends DependencyProvider<any>>(original: T, override?: Partial<T>): T;
+    protected __get<T>(provider: ProviderToken<T>, options?: GetOptions): T;
     /**
-     * The priority order is as follows:
-     * 1. From the `ProviderToken.scope`
-     * 2. From the class `@Injectable(scope)` decorator
-     * 3. From the `ProviderModule` default scope.
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * @param provider The {@link ProviderToken}.
-     * @param moduleDefaultScope The module default scope.
+     * See {@link IProviderModuleNaked.__getAsync}.
      */
-    function getInjectionScopeByPriority(provider: ProviderToken, moduleDefaultScope: InjectionScope): InjectionScope;
-    function tryGetProviderOptions<T>(provider: ProviderToken<T>): (ProviderOptions<T> & ProviderScopeOption) | undefined;
-    function tryGetScopeFromProvider(provider: ProviderToken): InjectionScope | undefined;
-    function tryGetDecoratorScopeFromClass<T = any>(provider: ProviderToken<T>): InjectionScope | undefined;
-}
-
-declare namespace ProviderModuleHelpers {
-    function buildInternalConstructorParams(params: ProviderModuleOptions & ProviderModuleOptionsInternal): ProviderModuleOptions;
-    function isDynamicExport(exporter: StaticExports | DynamicExports): exporter is DynamicExports;
-}
-
-declare function isPlainObject(o: any): o is object;
-
-declare function isClass(v: any): boolean;
-
-declare function isFunction(v: any): boolean;
-
-declare function isClassOrFunction(value: any): value is Function | Class<any>;
-
-/**
- * The low-level App Container.
- *
- * **Internally used, please use the `AppModule` to interact with it.**
- */
-declare const GlobalContainer: Container;
-
-/**
- * Modules are highly recommended as an effective way to organize your components.
- * For most applications, you'll likely have multiple modules, each encapsulating a closely related set of capabilities.
- *
- * _See {@link ProviderModuleOptions | ProviderModuleOptions}_.
- *
- * @example
- * ```ts
- * import { ProviderModule } from '@adimm/x-injection';
- *
- * const EngineModule = new ProviderModule({
- *   identifier: Symbol('EngineModule'),
- *   providers: [EngineService],
- *   exports: [EngineService]
- * });
- *
- * const DashboardModule = new ProviderModule({
- *   identifier: Symbol('DashboardModule'),
- *   providers: [DashboardService],
- *   exports: [DashboardService]
- * });
- *
- * const CarModule = new ProviderModule({
- *   identifier: Symbol('CarModule'),
- *   imports: [EngineModule, DashboardModule],
- *   providers: [CarService],
- *   exports: [CarService]
- * });
- *
- * // Run-time class replacement:
- * const RedCarModule = new ProviderModule({
- *   identifier: Symbol('RedCarModule'),
- *   imports: [CarModule],
- *   providers: [
- *     {
- *       provide: CarService,
- *       useClass: RedCarService,
- *     }
- *   ],
- * });
- *
- * // Run-time factory example:
- * const BlackCarModule = new ProviderModule({
- *   identifier: Symbol('BlackCarModule'),
- *   imports: [CarModule],
- *   providers: [
- *     {
- *       provide: CarService,
- *       useFactory: (carService: CarService) => {
- *         carService.setColor('black');
- *
- *         return carService;
- *       },
- *       inject: [CarService]
- *     }
- *   ],
- * });
- * ```
- */
-declare class ProviderModule implements IProviderModule {
-    readonly identifier: symbol;
-    readonly isDisposed: boolean;
-    protected readonly isAppModule: boolean;
-    protected readonly container: Container;
-    protected readonly defaultScope: IProviderModuleNaked['defaultScope'];
-    protected readonly dynamicExports: IProviderModuleNaked['dynamicExports'];
-    protected readonly onReady: IProviderModuleNaked['onReady'];
-    protected readonly onDispose: IProviderModuleNaked['onDispose'];
-    protected readonly importedProvidersMap: IProviderModuleNaked['importedProvidersMap'];
-    protected readonly moduleUtils: IProviderModuleNaked['moduleUtils'];
-    protected readonly imports: IProviderModuleNaked['imports'];
-    protected readonly providers: IProviderModuleNaked['providers'];
-    protected readonly importedProviders: IProviderModuleNaked['importedProviders'];
-    protected readonly exports: IProviderModuleNaked['exports'];
-    private readonly registeredBindingSideEffects;
-    constructor({ identifier, imports, providers, exports, defaultScope, dynamicExports, onReady, onDispose, ..._internalParams }: ProviderModuleOptions);
-    get<T>(provider: ProviderToken<T>, isOptional?: boolean): T;
-    getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
-    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
-    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
-    toNaked(): IProviderModuleNaked;
-    clone(options?: CloneParams): IProviderModule;
-    toString(): string;
-    private setIdentifier;
-    private prepareContainer;
-    private injectImportedModules;
-    private injectProviders;
-    private registerBindingSideEffect;
-    private invokeRegisteredBindingSideEffects;
-    private removeRegisteredBindingSideEffects;
-    private shouldThrowWhenModuleDynamicExportsDontMatchTheStaticExports;
-    private shouldThrowIfDisposed;
+    protected __getAsync<T>(provider: ProviderToken<T>, options?: GetOptions): Promise<T>;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._dispose}.
+     * See {@link IProviderModuleNaked.__getAll}.
      */
-    protected _dispose(): Promise<void>;
+    protected __getAll<T>(provider: ProviderToken<T>, options?: GetOptions): T[];
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._lazyInit}.
+     * See {@link IProviderModuleNaked.__getAllAsync}.
      */
-    protected _lazyInit({ imports, providers, exports, defaultScope, dynamicExports, onReady, onDispose, ..._internalParams }: LazyInitOptions): IProviderModule;
+    protected __getAllAsync<T>(provider: ProviderToken<T>, options?: GetOptions): Promise<T[]>;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._getImportedModules}.
+     * See {@link IProviderModuleNaked.__isBound}.
      */
-    protected _getImportedModules(): IProviderModuleNaked[];
+    protected __isBound(provider: ProviderToken, options?: IsBoundOptions): boolean;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._getProviders}.
+     * See {@link IProviderModuleNaked.__isCurrentBound}.
      */
-    protected _getProviders(): DependencyProvider[];
+    protected __isCurrentBound(provider: ProviderToken, options?: IsBoundOptions): boolean;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._getExportableModulesAndProviders}.
+     * See {@link IProviderModuleNaked.__takeSnapshot}.
      */
-    protected _getExportableModulesAndProviders(): StaticExports;
+    protected __takeSnapshot(): void;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._onBind}.
+     * See {@link IProviderModuleNaked.__restoreSnapshot}.
      */
-    protected _onBind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
+    protected __restoreSnapshot(): void;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._onRebind}.
+     * See {@link IProviderModuleNaked.__rebind}.
      */
-    protected _onRebind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
+    protected __rebind<T>(provider: ProviderToken<T>): Promise<BindToFluentSyntax<T>>;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._onUnbind}.
+     * See {@link IProviderModuleNaked.__rebindSync}.
      */
-    protected _onUnbind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
+    protected __rebindSync<T>(provider: ProviderToken<T>): BindToFluentSyntax<T>;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked._overwriteContainer}.
+     * See {@link IProviderModuleNaked.__unbind}.
      */
-    protected _overwriteContainer(cb: () => Container): void;
+    protected __unbind(provider: ProviderToken): Promise<void>;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked.__bind}.
+     * See {@link IProviderModuleNaked.__unbindSync}.
      */
-    protected __bind<T>(provider: ProviderToken<T>): BindToFluentSyntax<T>;
+    protected __unbindSync(provider: ProviderToken): void;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
-     * See {@link IProviderModuleNaked.__get}.
+     * See {@link IProviderModuleNaked.__unbindAll}.
      */
-    protected __get<T>(provider: ProviderToken<T>, options?: GetOptions): T;
+    protected __unbindAll(): Promise<void>;
+}
+
+/**
+ * Class of the {@link AppModule} instance.
+ *
+ * **You shouldn't initialize a new instance of this class, please use the {@link AppModule} instance!**
+ */
+declare class GlobalAppModule extends ProviderModule implements IAppModule {
+    isMarkedAsGlobal: boolean;
+    private nakedModule;
+    private isLoaded;
+    constructor();
+    register<AsNaked extends boolean = false>(options: AppModuleOptions): AsNaked extends false ? IAppModule : IAppModule & IProviderModuleNaked;
+    toNaked(): IAppModule & IProviderModuleNaked;
+    protected _dispose(): Promise<void>;
+    private checkIfImportsHaveGlobalMark;
+}
+/**
+ * Special instance of {@link ProviderModule} which acts as the global module of your application in which you can inject any provider
+ * which must be available through your entire application.
+ *
+ * The registered providers will automatically be available inside all the modules.
+ *
+ * @example
+ * ```ts
+ * // The `register` method must be invoked only once during your application life cycle!
+ * AppModule.register({
+ *   imports: [ConfigModule, ApiModule, UserModule, DatabaseModule],
+ *   providers: [DummyService],
+ * });
+ * ```
+ */
+declare const AppModule: GlobalAppModule;
+
+interface ProviderModuleOptions {
+    /** The module unique ID. */
+    identifier: symbol;
+    /** The list of imported {@link IProviderModule | modules} that export the {@link Provider | providers} which are required in this module. */
+    imports?: IProviderModule[];
+    /** The {@link DependencyProvider | providers} that will be instantiated by the container and that may be shared at least across this module. */
+    providers?: DependencyProvider[];
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * The subset of {@link ProviderToken | providers} or {@link IProviderModule | modules} that
+     * are provided by this module and should be available in other modules which import this module.
      *
-     * See {@link IProviderModuleNaked.__getAsync}.
+     * _Check also the {@link dynamicExports} property._
      */
-    protected __getAsync<T>(provider: ProviderToken<T>, options?: GetOptions): Promise<T>;
+    exports?: StaticExports;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * The default {@link InjectionScope} to be used when a {@link ProviderToken} does not have a defined `scope`.
      *
-     * See {@link IProviderModuleNaked.__getAll}.
+     * Defaults to {@link InjectionScope.Singleton}.
      */
-    protected __getAll<T>(provider: ProviderToken<T>, options?: GetOptions): T[];
+    defaultScope?: InjectionScope;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * This option is only a _marker_, per se it doesn't do anything
+     * apart from marking this module as `global`.
+     * When a module is marked as `global`, it means that it is expected to be _imported_ into the `AppModule`.
      *
-     * See {@link IProviderModuleNaked.__getAllAsync}.
+     * Expect an exception to be thrown:
+     * - If a `module` marked as global is **not** imported into the `AppModule`.
+     * - If a `module` **not** marked as global _is_ imported into the `AppModule`
+     *
+     * Defaults to `false`.
      */
-    protected __getAllAsync<T>(provider: ProviderToken<T>, options?: GetOptions): Promise<T[]>;
+    markAsGlobal?: true;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * When provided, can be used to control which providers from the {@link ProviderModuleOptions.exports | exports}
+     * array should actually be exported into the importing module.
      *
-     * See {@link IProviderModuleNaked.__isBound}.
+     * **Note:** _Static {@link ProviderModuleOptions.exports | exports} should always be preferred as their static nature implies predictibility._
+     * _This is for advanced use cases only, and most probably you may never need to use a dynamic export!_
+     *
+     * To keep in mind in order to avoid nasty bugs:
+     * - You **must always** return only the providers/modules declared into the static {@link ProviderModuleOptions.exports | exports} array.
+     * - You **can** return _less_ providers/modules as long as they are still part of the static {@link ProviderModuleOptions.exports | exports} array.
+     * - You **cannot** return _more_ providers/modules than the static {@link ProviderModuleOptions.exports | exports} array!
+     *
+     * @example
+     * ```ts
+     * {
+     *   exports: [ConfigModule, UserModule, PaymentService, ReviewService],
+     *   dynamicExports: (importerModule, moduleExports) => {
+     *     const shouldExportOnlyTheServices = true;
+     *
+     *     if (shouldExportOnlyTheServices === false) return moduleExports;
+     *
+     *     return moduleExports.flatMap((ex) => {
+     *       // With `flatMap` we can map and filter out elements
+     *       // from the sequence at the same time
+     *       // by returning an empty array.
+     *       return ex instanceof ProviderModule ? [] : ex;
+     *     });
+     *   }
+     * }
+     *
+     * // Or
+     *
+     * {
+     *   exports: [ConfigModule, UserModule, PaymentService, ReviewService],
+     *   dynamicExports: (importerModule, moduleExports) => {
+     *     // We export all the providers only when the importer module is not the `BULLIED_MODULE`.
+     *     if (importerModule.toNaked().name !== 'BULLIED_MODULE') return moduleExports;
+     *
+     *     return [ConfigModule];
+     *   }
+     * }
+     *
+     * ```
      */
-    protected __isBound(provider: ProviderToken, options?: IsBoundOptions): boolean;
+    dynamicExports?: DynamicExports;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Callback which will be invoked once the module container has been initialized
+     * and the providers resolved.
      *
-     * See {@link IProviderModuleNaked.__isCurrentBound}.
+     * **This happens only once, when the {@link IProviderModule | ProviderModule} has been bootstrapped!**
+     *
+     * @param module The instance of the {@link IProviderModule | module}.
      */
-    protected __isCurrentBound(provider: ProviderToken, options?: IsBoundOptions): boolean;
+    onReady?: (module: IProviderModule) => Promise<void>;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Callback which will be invoked whenever the internal module dispose method is invoked.
      *
-     * See {@link IProviderModuleNaked.__takeSnapshot}.
+     * **The method will be invoked right _before_ the clean-up process.**
+     *
+     * @param module The instance of the {@link IProviderModule | module}.
      */
-    protected __takeSnapshot(): void;
+    onDispose?: (module: IProviderModule) => Promise<void>;
+}
+interface ProviderModuleOptionsInternal {
+    isAppModule?: boolean;
+    isDisposed?: boolean;
+    /** Can be used to manually provide the {@link IAppModule} instance. */
+    appModule?: () => GlobalAppModule;
+    /** Can be used to manually provide a {@link Container} instance. */
+    container?: () => Container;
+    /** Can be used to override all the _imported_ providers _before_ the binding process. */
+    importedProvidersMap?: (
+    /** The current imported {@link DependencyProvider | provider} altered to use the module from where was imported for resolution. */
+    factorizedProvider: DependencyProvider<any>, 
+    /** The current imported {@link DependencyProvider | provider}. */
+    provider: DependencyProvider<any>, 
+    /** The {@link IProviderModule | module} from where the {@link DependencyProvider | provider} originated. */
+    module: IProviderModule) => DependencyProvider<any>;
+}
+type StaticExports = (ProviderToken | IProviderModule)[];
+type DynamicExports = (
+/** The {@link IProviderModule} which is importing this module. */
+importerModule: IProviderModule, 
+/** The {@link ProviderModuleOptions.exports | exports} array of this module. */
+moduleExports: StaticExports) => StaticExports;
+
+interface IProviderModule {
+    /** The module unique ID. */
+    readonly identifier: symbol;
+    /** See {@link ProviderModuleOptions.markAsGlobal}. */
+    readonly isMarkedAsGlobal: boolean;
+    readonly isDisposed: boolean;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Can be used to retrieve a resolved `dependency` from the module container.
      *
-     * See {@link IProviderModuleNaked.__restoreSnapshot}.
+     * @param provider The {@link ProviderToken}.
+     * @param isOptional When set to `false` _(default)_ an exception will be thrown when the {@link provider} isn't bound.
+     * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.
      */
-    protected __restoreSnapshot(): void;
+    get<T>(provider: ProviderToken<T>, isOptional?: boolean): T;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Can be used to retrieve many resolved `dependencies` from the module container at once.
      *
-     * See {@link IProviderModuleNaked.__rebind}.
+     * @param deps Either one or more {@link ProviderToken}.
+     * @returns Tuple containing the {@link D | dependencies}.
+     *
+     * @example
+     * ```ts
+     * // When ProviderTokens are supplied, TS auto-inference works as expected.
+     * // `car` will infer the `Car` type, `engine` the `Engine` type and `dashboard` the `Dashboard` type.
+     * const [car, engine, dashboard] = AppModule.getMany(
+     *   Car,
+     *   Engine,
+     *   { provider: Dashboard, isOptional: true }
+     * );
+     *
+     * // When auto-inference is not possible, you can manually cast the types.
+     * const [configService, userService] = AppModule.getMany<[typeof ConfigService, typeof UserService]>('CONFIG_SERVICE', UserService);
+     * // Now the `configService` is of type `ConfigService` and the `userService` is of type `UserService`.
+     * ```
      */
-    protected __rebind<T>(provider: ProviderToken<T>): Promise<BindToFluentSyntax<T>>;
+    getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Adds an activation handler for the {@link provider}.
      *
-     * See {@link IProviderModuleNaked.__rebindSync}.
+     * See {@link https://inversify.io/docs/api/container/#onactivation} for more details.
      */
-    protected __rebindSync<T>(provider: ProviderToken<T>): BindToFluentSyntax<T>;
+    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Adds a deactivation handler for the {@link provider}.
      *
-     * See {@link IProviderModuleNaked.__unbind}.
+     * See {@link https://inversify.io/docs/api/container/#ondeactivation} for more details.
      */
-    protected __unbind(provider: ProviderToken): Promise<void>;
+    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Casts the current module type to the {@link IProviderModuleNaked} type.
      *
-     * See {@link IProviderModuleNaked.__unbindSync}.
+     * **Internally used and for testing purposes!**
      */
-    protected __unbindSync(provider: ProviderToken): void;
+    toNaked(): IProviderModuleNaked;
     /**
-     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     * Can be used to create a new instance of the current {@link IProviderModule | module}.
      *
-     * See {@link IProviderModuleNaked.__unbindAll}.
+     * **Note:** _All the providers will be registered again within the new module!_
+     * _And also the new module will still refrain values by reference to its parent module because of_
+     * _JS limitation in deeply/truly cloning an instance._
+     *
+     * @param options See {@link CloneParams}.
      */
-    protected __unbindAll(): Promise<void>;
+    clone(options?: CloneParams): IProviderModule;
+    /** Returns the {@link IProviderModule.identifier} `symbol` description. */
+    toString(): string;
+}
+type ProviderModuleGetManySignature<Tokens extends (ProviderModuleGetManyParam<any> | ProviderToken)[]> = {
+    [K in keyof Tokens]: Tokens[K] extends ProviderModuleGetManyParam<infer U> ? U : Tokens[K] extends ProviderToken<infer T> ? T : Tokens[K] extends ProviderIdentifier<infer I> ? I : never;
+};
+type ProviderModuleGetManyParam<T> = {
+    /** The {@link ProviderToken}. */
+    provider: ProviderToken<T>;
+    /** When set to `false` _(default)_ an exception will be thrown when the {@link ProviderModuleGetManyParam.provider | provider} isn't bound. */
+    isOptional?: boolean;
+};
+interface CloneParams {
+    /** Can be used to override all the providers _before_ the binding process. */
+    providersMap?: (
+    /** The current {@link DependencyProvider | provider}. */
+    provider: DependencyProvider<any>, 
+    /** The {@link IProviderModule | module} from where the {@link DependencyProvider | provider} originated. */
+    module: IProviderModule) => DependencyProvider<any>;
+    /** Can be used to override all the _imported_ providers _before_ the binding process. */
+    importedProvidersMap?: ProviderModuleOptionsInternal['importedProvidersMap'];
 }
 
-/**
- * Class of the {@link AppModule} instance.
- *
- * **You shouldn't initialize a new instance of this class, please use the {@link AppModule} instance!**
- */
-declare class GlobalAppModule extends ProviderModule implements IAppModule {
-    private nakedModule;
-    private isLoaded;
-    constructor();
+interface IAppModule extends Except<IProviderModule, 'isMarkedAsGlobal'> {
+    /** Must be invoked _(only once during the application lifecycle)_ in order to provide the {@link options} to the module. */
     register<AsNaked extends boolean = false>(options: AppModuleOptions): AsNaked extends false ? IAppModule : IAppModule & IProviderModuleNaked;
     toNaked(): IAppModule & IProviderModuleNaked;
-    protected _dispose(): Promise<void>;
 }
+type AppModuleOptions = Except<LazyInitOptions, 'exports' | 'dynamicExports'>;
+
+/** See {@link https://inversify.io/docs/api/decorator/#inject} for more details. */
+declare function Inject(provider: ProviderToken): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#multiinject} for more details. */
+declare function MultiInject(provider: ProviderToken): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#injectfrombase} for more details. */
+declare function InjectFromBase(options?: Parameters<typeof injectFromBase>[0]): ClassDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#named} for more details. */
+declare function Named(name: MetadataName): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#optional} for more details. */
+declare function Optional(): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#postconstruct} for more details. */
+declare function PostConstruct(): MethodDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#predestroy} for more details. */
+declare function PreDestroy(): MethodDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#tagged} for more details. */
+declare function Tagged(key: MetadataTag, value: unknown): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** See {@link https://inversify.io/docs/api/decorator/#unmanaged} for more details. */
+declare function Unmanaged(): MethodDecorator & ParameterDecorator & PropertyDecorator;
+
+/** Exception which indicates that there is a generic error. */
+declare class InjectionError extends Error {
+    name: string;
+}
+
+/** Exception which indicates that there is a generic error with an instance of {@link IProviderModule}. */
+declare class InjectionProviderModuleError extends Error {
+    name: string;
+    constructor(module: IProviderModule, message: string);
+}
+
+/** Exception which indicates an invokation of a disposed module.  */
+declare class InjectionProviderModuleDisposedError extends InjectionProviderModuleError {
+    name: string;
+    constructor(module: IProviderModule);
+}
+
 /**
- * Special instance of {@link ProviderModule} which acts as the global module of your application in which you can inject any provider
- * which must be available through your entire application.
- *
- * The registered providers will automatically be available inside all the modules.
- *
- * @example
- * ```ts
- * import { AppModule } from '@adimm/x-injection';
- *
- * // The `register` method must be invoked only once during your application life cycle!
- * AppModule.register({
- *   imports: [ConfigModule, ApiModule, UserModule, DatabaseModule],
- *   providers: [DummyService],
- * });
- * ```
+ * Exception which indicates that an instance of {@link IProviderModule}
+ * imports another module which dynamically exports its providers/modules and
+ * is trying to dynamically export more or different providers/modules than the
+ * ones declared into its static exports.
  */
-declare const AppModule: GlobalAppModule;
+declare class InjectionDynamicExportsOutOfRange extends InjectionProviderModuleError {
+    name: string;
+    constructor(module: IProviderModule);
+}
+
+/** Exception which indicates that a module has been initialized without an `identifier`.  */
+declare class InjectionProviderModuleMissingIdentifierError extends InjectionProviderModuleError {
+    name: string;
+    constructor(module: IProviderModule);
+}
+
+/** Exception which indicates an error with regards to the `markAsGlobal` option.  */
+declare class InjectionProviderModuleGlobalMarkError extends InjectionProviderModuleError {
+    name: string;
+    constructor(module: IProviderModule, message: string);
+}
+
+declare function injectionScopeToBindingScope(injectionScope: InjectionScope): BindingScope;
+declare function bindingScopeToInjectionScope(bindingScope: BindingScope): InjectionScope;
+
+declare namespace ProviderTokenHelpers {
+    function isClassToken<T>(provider: ProviderToken<T>): provider is ProviderClassToken<T>;
+    function isValueToken<T>(provider: ProviderToken<T>): provider is ProviderValueToken<T>;
+    function isFactoryToken<T>(provider: ProviderToken<T>): provider is ProviderFactoryToken<T>;
+    function isProviderIdentifier<T = any>(value: any): value is ProviderIdentifier<T>;
+    function toServiceIdentifier<T = any>(provider: ProviderToken<T>): ServiceIdentifier<T>;
+    function toServiceIdentifiers(providers: ProviderToken[]): ServiceIdentifier<unknown>[];
+    function toDependencyProviderWithOptions<T extends DependencyProvider<any>>(original: T, override?: Partial<T>): T;
+    /**
+     * The priority order is as follows:
+     * 1. From the `ProviderToken.scope`
+     * 2. From the class `@Injectable(scope)` decorator
+     * 3. From the `ProviderModule` default scope.
+     *
+     * @param provider The {@link ProviderToken}.
+     * @param moduleDefaultScope The module default scope.
+     */
+    function getInjectionScopeByPriority(provider: ProviderToken, moduleDefaultScope: InjectionScope): InjectionScope;
+    function tryGetProviderOptions<T>(provider: ProviderToken<T>): (ProviderOptions<T> & ProviderScopeOption) | undefined;
+    function tryGetScopeFromProvider(provider: ProviderToken): InjectionScope | undefined;
+    function tryGetDecoratorScopeFromClass<T = any>(provider: ProviderToken<T>): InjectionScope | undefined;
+}
+
+declare namespace ProviderModuleHelpers {
+    function buildInternalConstructorParams(params: ProviderModuleOptions & ProviderModuleOptionsInternal): ProviderModuleOptions;
+    function isDynamicExport(exporter: StaticExports | DynamicExports): exporter is DynamicExports;
+}
+
+declare function isPlainObject(o: any): o is object;
+
+declare function isClass(v: any): boolean;
+
+declare function isFunction(v: any): boolean;
+
+declare function isClassOrFunction(value: any): value is Function | Class<any>;
 
-export { AppModule, type AppModuleOptions, type CloneParams, type DependencyProvider, type DynamicExports, GLOBAL_APP_MODULE_ID, GlobalAppModule, GlobalContainer, type IAppModule, type IProviderModule, type IProviderModuleNaked, Inject, InjectFromBase, Injectable, InjectionScope, type LazyInitOptions, MultiInject, Named, type OnEvent, Optional, PostConstruct, PreDestroy, type ProviderClassToken, type ProviderFactoryToken, type ProviderIdentifier, ProviderModule, type ProviderModuleGetManyParam, type ProviderModuleGetManySignature, ProviderModuleHelpers, type ProviderModuleOptions, type ProviderModuleOptionsInternal, type ProviderOptions, type ProviderScopeOption, type ProviderToken, ProviderTokenHelpers, type ProviderValueToken, type StaticExports, Tagged, Unmanaged, XInjectionDynamicExportsOutOfRange, XInjectionError, XInjectionProviderModuleDisposedError, XInjectionProviderModuleError, XInjectionProviderModuleMissingIdentifierError, bindingScopeToInjectionScope, injectionScopeToBindingScope, isClass, isClassOrFunction, isFunction, isPlainObject };
+export { AppModule, type AppModuleOptions, type CloneParams, type DependencyProvider, type DynamicExports, GLOBAL_APP_MODULE_ID, GlobalAppModule, GlobalContainer, type IAppModule, type IProviderModule, type IProviderModuleNaked, Inject, InjectFromBase, Injectable, InjectionDynamicExportsOutOfRange, InjectionError, InjectionProviderModuleDisposedError, InjectionProviderModuleError, InjectionProviderModuleGlobalMarkError, InjectionProviderModuleMissingIdentifierError, InjectionScope, type LazyInitOptions, MultiInject, Named, type OnEvent, Optional, PostConstruct, PreDestroy, type ProviderClassToken, type ProviderFactoryToken, type ProviderIdentifier, ProviderModule, type ProviderModuleGetManyParam, type ProviderModuleGetManySignature, ProviderModuleHelpers, type ProviderModuleOptions, type ProviderModuleOptionsInternal, type ProviderOptions, type ProviderScopeOption, type ProviderToken, ProviderTokenHelpers, type ProviderValueToken, type StaticExports, Tagged, Unmanaged, bindingScopeToInjectionScope, injectionScopeToBindingScope, isClass, isClassOrFunction, isFunction, isPlainObject };