@adimm/x-injection-reactjs 0.3.0 → 1.0.0

package/dist/index.d.cts

@@ -1,74 +1,12 @@
-import * as React from 'react';
-import React__default from 'react';
-import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import react__default from 'react';
+import * as _adimm_x_injection from '@adimm/x-injection';
+import { IProviderModule, ProviderToken, ProviderModuleGetManyParam, ProviderIdentifier, ModuleOrBlueprint, DependencyProvider } from '@adimm/x-injection';
 
-interface ComponentProviderModuleOptions extends ProviderModuleOptions {
-    /**
-     * When set to `true`, it'll automatically `contextualize` all the `imports` array.
-     *
-     * **Note:** _This is required when you have a parent component which renders one or more children
-     * and does also need to control their providers._
-     * _If not set to `true`, then the children providers would be resolved from their original `module`, therefore_
-     * _if your parent component has multiple instances of itself, all its children will actually share_
-     * _the same providers, especially when their module injection scope is set to `Singleton` (by default)._
-     *
-     * **Note2:** _If a module has {@link ProviderModuleOptions.markAsGlobal | markAsGlobal} set to `true`,_
-     * _this will automatically default to `false`._
-     *
-     * Defaults to `true`.
-     */
-    contextualizeImports?: boolean;
-}
-
-interface IComponentProviderModuleNaked extends IComponentProviderModule {
-    /**
-     * The original `id` which was assigned to this module.
-     *
-     * **Note:** _The module initial {@link ComponentProviderModuleOptions.identifier | id} will be suffixed with `Contextualized`._
-     */
-    originalIdentifier: symbol;
-    /** See {@link ComponentProviderModuleOptions.contextualizeImports}. */
-    hasContextualizedImports: ComponentProviderModuleOptions['contextualizeImports'];
-    /** Indicates if this module has been initialized by a React Component or not. */
-    initializedFromComponent: boolean;
-    /**
-     * It is used internally by the `ProviderModule` to create a new cloned
-     * module which will be consumed only by that specific component instance.
-     */
-    _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
-}
-
-interface IComponentProviderModule extends IProviderModule {
-    /**
-     * Casts the current module type to the {@link IComponentProviderModuleNaked} type.
-     *
-     * **Internally used and for testing purposes!**
-     */
-    toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    /**
-     * Should be invoked only when the component is not needed anymore.
-     *
-     * _eg: When changing page, removable components and so on._
-     */
-    dispose(): Promise<void>;
-}
-
-type PropsWithModule<P extends Record<string, any>> = P & {
-    /**
-     * The {@link IComponentProviderModule | Module} which this component should consume.
-     *
-     * **Note:** _You can easily override this in your unit tests to provide a module having mocked providers_
-     * _without the need to create a new mocked component by using the composable `ProvideModule` method._
-     */
-    module?: IComponentProviderModule;
-};
-
-declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponentProviderModule>;
+declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: react.Context<IProviderModule>;
 
 /**
- * Low-level hook which can be used to resolve a single dependency from the current
- * context module.
+ * Low-level hook which can be used to resolve a single dependency.
  *
  * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_
  * _`hookFactory` method to compose a custom hook._
@@ -77,15 +15,24 @@ declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponen
  * @param options See {@link UseInjectOptions}.
  * @returns The resolved {@link T | dependency}.
  */
-declare function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T;
-type UseInjectOptions = {
-    /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */
-    isOptional?: boolean;
+declare function useInject<T, IsOptional extends boolean | undefined = undefined, AsList extends boolean | undefined = undefined>(provider: ProviderToken<T>, options?: UseInjectOptions<IsOptional, AsList>): _adimm_x_injection.ProviderModuleGetReturn<T, IsOptional, AsList>;
+type UseInjectOptions<IsOptional extends boolean | undefined = undefined, AsList extends boolean | undefined = undefined> = {
+    /**
+     * When set to `false` an exception will be thrown when the supplied `ProviderToken` isn't bound.
+     *
+     * Defaults to `false`.
+     */
+    isOptional?: IsOptional;
+    /**
+     * Set to `true` if you need to retrieve _all_ the bound identifiers of the supplied `ProviderToken`.
+     *
+     * Defaults to `false`.
+     */
+    asList?: AsList;
 };
 
 /**
- * Low-level hook which can be used to resolve multiple dependencies at once from the current
- * context module.
+ * Low-level hook which can be used to resolve multiple dependencies at once.
  *
  * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_
  * _`hookFactory` method to compose a custom hook._
@@ -93,30 +40,83 @@ type UseInjectOptions = {
  * @param deps Either one or more {@link ProviderToken}.
  * @returns Tuple containing the {@link D | dependencies}.
  */
-declare function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
+declare function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken | ProviderIdentifier)[]>(...deps: D): _adimm_x_injection.ProviderModuleGetManyReturn<D>;
 
-/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */
-declare function useComponentModule(): IComponentProviderModule;
+/** Can be used to retrieve the {@link IProviderModule | Module} from the current context. */
+declare function useComponentModule(): IProviderModule;
 
-/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
-declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
-    protected readonly originalIdentifier: symbol;
-    protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];
-    protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];
-    constructor(options: ComponentProviderModuleOptions);
-    toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule;
-    dispose(): Promise<void>;
+type PropsWithModule<P extends Record<string, any>> = P & {
     /**
-     * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**
+     * The {@link ModuleOrBlueprint} which this component should consume.
      *
-     * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.
+     * **Note:** _Can be used to easily mock an entire module._
+     *
+     * example:
+     * ```tsx
+     * const CarModuleBp = ProviderModule.blueprint({
+     *   id: 'CarModule',
+     *   imports: [CarEngineModule, CarDashboardModule],
+     *   providers: [CarService],
+     *   exports: [CarService],
+     * });
+     *
+     * const cbMock = jest.fn();
+     *
+     * const CarModulBpeMocked = CarModuleBp.clone().updateDefinition({
+     *   providers: [
+     *     {
+     *       provide: CarService, useValue: { startEngine: cbMock }
+     *     },
+     *   ]
+     * });
+     *
+     * await act(async () => render(<CarComponent module={CarModuleBpMocked} />));
+     *
+     * await waitFor(async () => {
+     *   expect(cbMock).toHaveBeenCalled();
+     * });
+     * ```
      */
-    protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
-}
+    module?: ModuleOrBlueprint;
+    /**
+     * Can be used to control the dependencies consumed by this component.
+     * This is useful when you want to provide an already resolved instance of a dependency down the component tree.
+     *
+     * eg:
+     * ```tsx
+     * class InputboxService {
+     *   currentValue = '';
+     * }
+     *
+     * class FormService {
+     *   constructor(
+     *     public readonly firstNameInputbox: InputboxService,
+     *     public readonly lastNameInputbox: InputboxService
+     *   ) {
+     *     this.firstNameInputbox.currentValue = 'John';
+     *     this.lastNameInputbox.currentValue = 'Doe';
+     *   }
+     * }
+     *
+     * const Form = provideModuleToComponent(FormModule, () => {
+     *   const service = useInject(FormService);
+     *
+     *   return (
+     *     <>
+     *       <Inputbox inject={[{ provide: InputboxService, useValue: service.firstNameInputbox }]} />
+     *       <Inputbox inject={[{ provide: InputboxService, useValue: service.lastNameInputbox }]} />
+     *     </>
+     *   );
+     * });
+     * ```
+     */
+    inject?: DependencyProvider[];
+};
 
 /**
- * Can be used to easily provide a {@link module} to any component.
+ * Can be used to easily provide a {@link module} to a component.
+ *
+ * **Note:** _An error will be thrown if a `global` module is provided._
  *
  * @example
  * ```tsx
@@ -139,57 +139,21 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  * }
  * ```
  *
- * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.
- * @returns The provided {@link toComponent | Component}.
- */
-declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C;
-type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React__default.ReactNode;
-
-/**
- * Can be used to easily provide a {@link module} to any component.
- *
- * @example
- * ```tsx
- * interface MyComponentProps {
- *   firstName: string;
- *   lastName: string;
- * }
- *
- * function MyComponent({ firstName, lastName }: MyComponentProps) {
- *   const service = useInject(MyComponentService);
- *
- *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>
- * }
- *
- * function App() {
- *   return (
- *     <ProvideModule module={MyComponentModule}>
- *       <MyComponent firstName={'John'} lastName={'Doe'} />
- *     </ProvideModule>
- *   );
- * }
- * ```
- *
- * @param param0 See {@link ProvideModuleFunctionParams}.
+ * @param module The {@link ModuleOrBlueprint} which should be consumed by the {@link component}.
  * @returns The provided {@link toComponent | Component}.
  */
-declare function ProvideModule({ module, children }: ProvideModuleFunctionParams): react_jsx_runtime.JSX.Element;
-interface ProvideModuleFunctionParams {
-    /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */
-    module: IComponentProviderModule;
-    children: React__default.ReactElement;
-}
+declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: ModuleOrBlueprint, component: ReactElementWithProviderModule<P>): C;
+type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => react__default.ReactNode;
 
 declare function hookFactory<P extends HookParams, D extends any[], T>({ use: hook, inject, }: HookFactoryParams<P, D, T>): (p: P) => T;
 interface HookFactoryParams<P extends HookParams, D extends any[], T> {
-    use: HookWithProviderModuleDependencies<P, D, T>;
+    use: (p: HookWithDeps<P, D>) => T;
     inject: ProviderToken[];
 }
-type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;
 type HookWithDeps<P extends HookParams, D extends any[]> = P & {
-    /** Array containing the resolved dependencies from the component context. */
+    /** Array containing the resolved dependencies. */
     deps: D;
 };
 type HookParams = Record<string, any> | void;
 
-export { ComponentProviderModule, type ComponentProviderModuleOptions, type HookFactoryParams, type HookWithDeps, type HookWithProviderModuleDependencies, type IComponentProviderModule, type IComponentProviderModuleNaked, type PropsWithModule, ProvideModule, type ProvideModuleFunctionParams, REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, type ReactElementWithProviderModule, type UseInjectOptions, hookFactory, provideModuleToComponent, useComponentModule, useInject, useInjectMany };
+export { type HookFactoryParams, type HookWithDeps, type PropsWithModule, REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, type ReactElementWithProviderModule, type UseInjectOptions, hookFactory, provideModuleToComponent, useComponentModule, useInject, useInjectMany };

package/dist/index.d.ts

@@ -1,74 +1,12 @@
-import * as React from 'react';
-import React__default from 'react';
-import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import react__default from 'react';
+import * as _adimm_x_injection from '@adimm/x-injection';
+import { IProviderModule, ProviderToken, ProviderModuleGetManyParam, ProviderIdentifier, ModuleOrBlueprint, DependencyProvider } from '@adimm/x-injection';
 
-interface ComponentProviderModuleOptions extends ProviderModuleOptions {
-    /**
-     * When set to `true`, it'll automatically `contextualize` all the `imports` array.
-     *
-     * **Note:** _This is required when you have a parent component which renders one or more children
-     * and does also need to control their providers._
-     * _If not set to `true`, then the children providers would be resolved from their original `module`, therefore_
-     * _if your parent component has multiple instances of itself, all its children will actually share_
-     * _the same providers, especially when their module injection scope is set to `Singleton` (by default)._
-     *
-     * **Note2:** _If a module has {@link ProviderModuleOptions.markAsGlobal | markAsGlobal} set to `true`,_
-     * _this will automatically default to `false`._
-     *
-     * Defaults to `true`.
-     */
-    contextualizeImports?: boolean;
-}
-
-interface IComponentProviderModuleNaked extends IComponentProviderModule {
-    /**
-     * The original `id` which was assigned to this module.
-     *
-     * **Note:** _The module initial {@link ComponentProviderModuleOptions.identifier | id} will be suffixed with `Contextualized`._
-     */
-    originalIdentifier: symbol;
-    /** See {@link ComponentProviderModuleOptions.contextualizeImports}. */
-    hasContextualizedImports: ComponentProviderModuleOptions['contextualizeImports'];
-    /** Indicates if this module has been initialized by a React Component or not. */
-    initializedFromComponent: boolean;
-    /**
-     * It is used internally by the `ProviderModule` to create a new cloned
-     * module which will be consumed only by that specific component instance.
-     */
-    _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
-}
-
-interface IComponentProviderModule extends IProviderModule {
-    /**
-     * Casts the current module type to the {@link IComponentProviderModuleNaked} type.
-     *
-     * **Internally used and for testing purposes!**
-     */
-    toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    /**
-     * Should be invoked only when the component is not needed anymore.
-     *
-     * _eg: When changing page, removable components and so on._
-     */
-    dispose(): Promise<void>;
-}
-
-type PropsWithModule<P extends Record<string, any>> = P & {
-    /**
-     * The {@link IComponentProviderModule | Module} which this component should consume.
-     *
-     * **Note:** _You can easily override this in your unit tests to provide a module having mocked providers_
-     * _without the need to create a new mocked component by using the composable `ProvideModule` method._
-     */
-    module?: IComponentProviderModule;
-};
-
-declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponentProviderModule>;
+declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: react.Context<IProviderModule>;
 
 /**
- * Low-level hook which can be used to resolve a single dependency from the current
- * context module.
+ * Low-level hook which can be used to resolve a single dependency.
  *
  * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_
  * _`hookFactory` method to compose a custom hook._
@@ -77,15 +15,24 @@ declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponen
  * @param options See {@link UseInjectOptions}.
  * @returns The resolved {@link T | dependency}.
  */
-declare function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T;
-type UseInjectOptions = {
-    /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */
-    isOptional?: boolean;
+declare function useInject<T, IsOptional extends boolean | undefined = undefined, AsList extends boolean | undefined = undefined>(provider: ProviderToken<T>, options?: UseInjectOptions<IsOptional, AsList>): _adimm_x_injection.ProviderModuleGetReturn<T, IsOptional, AsList>;
+type UseInjectOptions<IsOptional extends boolean | undefined = undefined, AsList extends boolean | undefined = undefined> = {
+    /**
+     * When set to `false` an exception will be thrown when the supplied `ProviderToken` isn't bound.
+     *
+     * Defaults to `false`.
+     */
+    isOptional?: IsOptional;
+    /**
+     * Set to `true` if you need to retrieve _all_ the bound identifiers of the supplied `ProviderToken`.
+     *
+     * Defaults to `false`.
+     */
+    asList?: AsList;
 };
 
 /**
- * Low-level hook which can be used to resolve multiple dependencies at once from the current
- * context module.
+ * Low-level hook which can be used to resolve multiple dependencies at once.
  *
  * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_
  * _`hookFactory` method to compose a custom hook._
@@ -93,30 +40,83 @@ type UseInjectOptions = {
  * @param deps Either one or more {@link ProviderToken}.
  * @returns Tuple containing the {@link D | dependencies}.
  */
-declare function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
+declare function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken | ProviderIdentifier)[]>(...deps: D): _adimm_x_injection.ProviderModuleGetManyReturn<D>;
 
-/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */
-declare function useComponentModule(): IComponentProviderModule;
+/** Can be used to retrieve the {@link IProviderModule | Module} from the current context. */
+declare function useComponentModule(): IProviderModule;
 
-/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
-declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
-    protected readonly originalIdentifier: symbol;
-    protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];
-    protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];
-    constructor(options: ComponentProviderModuleOptions);
-    toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule;
-    dispose(): Promise<void>;
+type PropsWithModule<P extends Record<string, any>> = P & {
     /**
-     * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**
+     * The {@link ModuleOrBlueprint} which this component should consume.
      *
-     * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.
+     * **Note:** _Can be used to easily mock an entire module._
+     *
+     * example:
+     * ```tsx
+     * const CarModuleBp = ProviderModule.blueprint({
+     *   id: 'CarModule',
+     *   imports: [CarEngineModule, CarDashboardModule],
+     *   providers: [CarService],
+     *   exports: [CarService],
+     * });
+     *
+     * const cbMock = jest.fn();
+     *
+     * const CarModulBpeMocked = CarModuleBp.clone().updateDefinition({
+     *   providers: [
+     *     {
+     *       provide: CarService, useValue: { startEngine: cbMock }
+     *     },
+     *   ]
+     * });
+     *
+     * await act(async () => render(<CarComponent module={CarModuleBpMocked} />));
+     *
+     * await waitFor(async () => {
+     *   expect(cbMock).toHaveBeenCalled();
+     * });
+     * ```
      */
-    protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
-}
+    module?: ModuleOrBlueprint;
+    /**
+     * Can be used to control the dependencies consumed by this component.
+     * This is useful when you want to provide an already resolved instance of a dependency down the component tree.
+     *
+     * eg:
+     * ```tsx
+     * class InputboxService {
+     *   currentValue = '';
+     * }
+     *
+     * class FormService {
+     *   constructor(
+     *     public readonly firstNameInputbox: InputboxService,
+     *     public readonly lastNameInputbox: InputboxService
+     *   ) {
+     *     this.firstNameInputbox.currentValue = 'John';
+     *     this.lastNameInputbox.currentValue = 'Doe';
+     *   }
+     * }
+     *
+     * const Form = provideModuleToComponent(FormModule, () => {
+     *   const service = useInject(FormService);
+     *
+     *   return (
+     *     <>
+     *       <Inputbox inject={[{ provide: InputboxService, useValue: service.firstNameInputbox }]} />
+     *       <Inputbox inject={[{ provide: InputboxService, useValue: service.lastNameInputbox }]} />
+     *     </>
+     *   );
+     * });
+     * ```
+     */
+    inject?: DependencyProvider[];
+};
 
 /**
- * Can be used to easily provide a {@link module} to any component.
+ * Can be used to easily provide a {@link module} to a component.
+ *
+ * **Note:** _An error will be thrown if a `global` module is provided._
  *
  * @example
  * ```tsx
@@ -139,57 +139,21 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  * }
  * ```
  *
- * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.
- * @returns The provided {@link toComponent | Component}.
- */
-declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C;
-type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React__default.ReactNode;
-
-/**
- * Can be used to easily provide a {@link module} to any component.
- *
- * @example
- * ```tsx
- * interface MyComponentProps {
- *   firstName: string;
- *   lastName: string;
- * }
- *
- * function MyComponent({ firstName, lastName }: MyComponentProps) {
- *   const service = useInject(MyComponentService);
- *
- *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>
- * }
- *
- * function App() {
- *   return (
- *     <ProvideModule module={MyComponentModule}>
- *       <MyComponent firstName={'John'} lastName={'Doe'} />
- *     </ProvideModule>
- *   );
- * }
- * ```
- *
- * @param param0 See {@link ProvideModuleFunctionParams}.
+ * @param module The {@link ModuleOrBlueprint} which should be consumed by the {@link component}.
  * @returns The provided {@link toComponent | Component}.
  */
-declare function ProvideModule({ module, children }: ProvideModuleFunctionParams): react_jsx_runtime.JSX.Element;
-interface ProvideModuleFunctionParams {
-    /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */
-    module: IComponentProviderModule;
-    children: React__default.ReactElement;
-}
+declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: ModuleOrBlueprint, component: ReactElementWithProviderModule<P>): C;
+type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => react__default.ReactNode;
 
 declare function hookFactory<P extends HookParams, D extends any[], T>({ use: hook, inject, }: HookFactoryParams<P, D, T>): (p: P) => T;
 interface HookFactoryParams<P extends HookParams, D extends any[], T> {
-    use: HookWithProviderModuleDependencies<P, D, T>;
+    use: (p: HookWithDeps<P, D>) => T;
     inject: ProviderToken[];
 }
-type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;
 type HookWithDeps<P extends HookParams, D extends any[]> = P & {
-    /** Array containing the resolved dependencies from the component context. */
+    /** Array containing the resolved dependencies. */
     deps: D;
 };
 type HookParams = Record<string, any> | void;
 
-export { ComponentProviderModule, type ComponentProviderModuleOptions, type HookFactoryParams, type HookWithDeps, type HookWithProviderModuleDependencies, type IComponentProviderModule, type IComponentProviderModuleNaked, type PropsWithModule, ProvideModule, type ProvideModuleFunctionParams, REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, type ReactElementWithProviderModule, type UseInjectOptions, hookFactory, provideModuleToComponent, useComponentModule, useInject, useInjectMany };
+export { type HookFactoryParams, type HookWithDeps, type PropsWithModule, REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, type ReactElementWithProviderModule, type UseInjectOptions, hookFactory, provideModuleToComponent, useComponentModule, useInject, useInjectMany };