@adimm/x-injection-reactjs 0.2.4 → 0.3.0

package/README.md

@@ -120,7 +120,7 @@ If you prefer to use the `const Component = () => {}` syntax, then you must use
 
 ```tsx
 // The UserInfo component will correctly infer the interface of `UserInfoProps` automatically!
-export const UserInfo = provideModuleToComponent(UserComponentModule, ({ firstName, lastName }: UserInfoProps) => {
+export const UserInfo = provideModuleToComponent<UserInfoProps>(UserComponentModule, ({ firstName, lastName }) => {
   const userService = useInject(UserService);
 
   userService.firstName = firstName;
@@ -263,7 +263,7 @@ export interface InputboxProps {
   initialValue: string;
 }
 
-export const Inputbox = provideModuleToComponent(InputboxModule, ({ initialValue }: InputboxProps) => {
+export const Inputbox = provideModuleToComponent<InputboxProps>(InputboxModule, ({ initialValue }) => {
   const service = useInject(InputboxService);
   const [, setCurrentValue] = useState(initialValue);
   service.setStateValue = setCurrentValue;
@@ -304,7 +304,7 @@ export interface ListviewProps {
   items: any[];
 }
 
-export const Listview = provideModuleToComponent(ListviewModule, ({ items }: ListviewProps) => {
+export const Listview = provideModuleToComponent<ListviewProps>(ListviewModule, ({ items }) => {
   const service = useInject(ListviewService);
 
   /* Remaining fancy implementation */
@@ -362,7 +362,7 @@ export interface DropdownProps {
   initialSelectedValue: number;
 }
 
-export const Dropdown = provideModuleToComponent(
+export const Dropdown = provideModuleToComponent<DropdownProps>(
   ListviewModule,
   ({
     listviewProps,
@@ -370,7 +370,7 @@ export const Dropdown = provideModuleToComponent(
     // Here it is important that we get access to the contextualized module
     // so we can forward it to the `Listview` component!
     module,
-  }: DropdownProps) => {
+  }) => {
     const service = useInject(DropdownService);
 
     /* Remaining fancy implementation */
@@ -437,14 +437,14 @@ export interface AutocompleteProps {
   currentText: string;
 }
 
-export const Autocomplete = provideModuleToComponent(
+export const Autocomplete = provideModuleToComponent<AutocompleteProps>(
   AutocompleteModule,
   ({
     dropdownProps,
     currentText,
 
     module,
-  }: AutocompleteProps) => {
+  }) => {
     const service = useInject(AutocompleteService);
 
     console.log(service.dropdownService.listviewService.items);

package/dist/index.cjs

@@ -21,12 +21,12 @@ var e, t = Object.create, o = Object.defineProperty, r = Object.getOwnPropertyDe
     });
 })(c, {
     ComponentProviderModule: () => C,
-    ProvideModule: () => q,
+    ProvideModule: () => _,
     REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: () => p,
-    hookFactory: () => R,
-    provideModuleToComponent: () => I,
+    hookFactory: () => q,
+    provideModuleToComponent: () => z,
     useComponentModule: () => f,
-    useInject: () => v,
+    useInject: () => h,
     useInjectMany: () => M
 }), module.exports = (e = c, a(o({}, "__esModule", {
     value: !0
@@ -38,7 +38,7 @@ function f() {
     return (0, m.useContext)(p);
 }
 
-function v(e, t) {
+function h(e, t) {
     return f().get(e, t?.isOptional);
 }
 
@@ -46,27 +46,40 @@ function M(...e) {
     return f().getMany(...e);
 }
 
-s(f, "useComponentModule"), s(v, "useInject"), s(M, "useInjectMany");
+s(f, "useComponentModule"), s(h, "useInject"), s(M, "useInjectMany");
 
-var h = require("@adimm/x-injection"), C = class e extends h.ProviderModule {
+var v = require("@adimm/x-injection"), C = class e extends v.ProviderModule {
     static {
         s(this, "ComponentProviderModule");
     }
-    _initializedFromComponent;
+    originalIdentifier;
+    hasContextualizedImports;
+    initializedFromComponent;
     constructor(e) {
-        super(h.ProviderModuleHelpers.buildInternalConstructorParams({
+        const t = Symbol(`Component${e.identifier.description}`), o = !e.markAsGlobal && (e.contextualizeImports ?? !0), r = o ? new Map : void 0;
+        super(v.ProviderModuleHelpers.buildInternalConstructorParams({
             ...e,
-            defaultScope: e.defaultScope ?? h.InjectionScope.Singleton,
-            identifier: Symbol(`Component${e.identifier.description}`)
-        })), this._initializedFromComponent = !1;
+            defaultScope: e.defaultScope ?? v.InjectionScope.Singleton,
+            identifier: t,
+            imports: o ? e.imports?.map((e => {
+                const n = "function" == typeof e ? e() : e;
+                return o ? () => {
+                    const e = n._createContextualizedComponentInstance(t);
+                    return r.set(n.originalIdentifier.toString(), e), e;
+                } : n;
+            })) : e.imports,
+            dynamicExports: s(((e, t) => o ? t.map((e => {
+                if (!(e instanceof v.ProviderModule)) return e;
+                return r.get(e.originalIdentifier.toString());
+            })) : t), "dynamicExports")
+        })), this.originalIdentifier = e.identifier, this.hasContextualizedImports = o, 
+        this.initializedFromComponent = !1;
     }
     toNaked() {
         return this;
     }
     clone(t) {
-        let o = [ ...this.providers ];
-        t?.providersMap && (o = o.map((e => t.providersMap(e, this))));
-        const r = new e(h.ProviderModuleHelpers.buildInternalConstructorParams({
+        const o = t, r = new e(v.ProviderModuleHelpers.buildInternalConstructorParams({
             isAppModule: this.isAppModule,
             markAsGlobal: this.isMarkedAsGlobal,
             identifier: Symbol(this.identifier.description.replace("Component", "")),
@@ -74,65 +87,68 @@ var h = require("@adimm/x-injection"), C = class e extends h.ProviderModule {
             dynamicExports: this.dynamicExports,
             onReady: this.onReady,
             onDispose: this.onDispose,
-            importedProvidersMap: t?.importedProvidersMap,
+            contextualizeImports: this.hasContextualizedImports,
+            importedProvidersMap: this.importedProvidersMap,
             imports: [ ...this.imports ],
-            providers: o,
-            exports: [ ...this.exports ]
+            providers: [ ...this.providers ],
+            exports: [ ...this.exports ],
+            ...o
         }));
-        return r._initializedFromComponent = this._initializedFromComponent, r;
+        return r.initializedFromComponent = this.initializedFromComponent, r;
     }
-    dispose() {
-        this._dispose();
+    async dispose() {
+        await super.dispose();
     }
-    _createContextualizedComponentInstance() {
-        if (this._initializedFromComponent) return this;
-        const e = this.clone().toNaked();
-        return e.identifier = Symbol(`Contextualized${e.identifier.description}`), e._initializedFromComponent = !0, 
-        e;
+    _createContextualizedComponentInstance(e) {
+        if (this.initializedFromComponent) return this;
+        const t = this.clone().toNaked();
+        return t.identifier = Symbol(`${e ? `[Parent:${e.description ?? "Unknown"}]` : ""}Contextualized${t.identifier.description}`), 
+        t.initializedFromComponent = !0, t;
     }
-}, y = d(require("react"), 1), P = require("react"), b = require("react");
+}, y = d(require("react"), 1), P = require("react"), x = require("react");
 
-function j(e) {
-    const t = (0, b.useRef)(void 0), o = (0, b.useRef)(!1), r = (0, b.useRef)(!1), [, n] = (0, 
-    b.useState)(0);
-    o.current && (r.current = !0), (0, b.useEffect)((() => (o.current || (t.current = e(), 
+function I(e) {
+    const t = (0, x.useRef)(void 0), o = (0, x.useRef)(!1), r = (0, x.useRef)(!1), [, n] = (0, 
+    x.useState)(0);
+    o.current && (r.current = !0), (0, x.useEffect)((() => (o.current || (t.current = e(), 
     o.current = !0), n((e => e + 1)), () => {
         r.current && t.current?.();
     })), []);
 }
 
-function _(e, t) {
+function b(e, t) {
     const o = (0, P.useMemo)((() => {
         const o = (t ?? e).toNaked();
         return o.isMarkedAsGlobal ? o : o._createContextualizedComponentInstance();
     }), [ e, t ]);
-    return j((() => () => {
+    return I((() => () => {
         o.dispose();
     })), o;
 }
 
-s(j, "useEffectOnce"), s(_, "useContextualizedModule");
+s(I, "useEffectOnce"), s(b, "useContextualizedModule");
 
-var x = require("@adimm/x-injection");
+var g, j = require("@adimm/x-injection");
 
-function E(e, t, o) {
-    const r = {
-        ...t
-    };
-    return ("object" == typeof e && "type" in e && (0, x.isFunction)(e.type) || (0, 
-    x.isFunction)(e)) && (r.module = o), r;
-}
-
-s(E, "forwardPropsWithModule");
+!function(e) {
+    function t(e, t, o) {
+        const r = {
+            ...t
+        };
+        return ("object" == typeof e && "type" in e && (0, j.isFunction)(e.type) || (0, 
+        j.isFunction)(e)) && (r.module = o), r;
+    }
+    s(t, "forwardPropsWithModule"), e.forwardPropsWithModule = t;
+}(g || (g = {}));
 
-var O = y.default.memo(g);
+var E = y.default.memo(O);
 
-function I(e, t) {
+function z(e, t) {
     return o => {
-        const r = _(e, o.module);
+        const r = b(e, o.module);
         return y.default.createElement(p.Provider, {
             value: r
-        }, y.default.createElement(O, {
+        }, y.default.createElement(E, {
             module: r,
             componentProps: o,
             component: t
@@ -140,33 +156,33 @@ function I(e, t) {
     };
 }
 
-function g({module: e, component: t, componentProps: o}) {
-    return y.default.createElement(y.default.Fragment, null, t(E(t, o, e)));
+function O({module: e, component: t, componentProps: o}) {
+    return y.default.createElement(y.default.Fragment, null, t(g.forwardPropsWithModule(t, o, e)));
 }
 
-s(I, "provideModuleToComponent"), s(g, "_ComponentRenderer");
+s(z, "provideModuleToComponent"), s(O, "_ComponentRenderer");
 
-var F = d(require("react"), 1);
+var w = d(require("react"), 1);
 
-function q({module: e, children: t}) {
-    const o = t.props ?? {}, r = _(e, o.module), n = (0, F.useMemo)((() => F.default.cloneElement(t, E(t, o, r))), [ o, r ]);
-    return F.default.createElement(p.Provider, {
+function _({module: e, children: t}) {
+    const o = t.props ?? {}, r = b(e, o.module), n = (0, w.useMemo)((() => w.default.cloneElement(t, g.forwardPropsWithModule(t, o, r))), [ o, r ]);
+    return w.default.createElement(p.Provider, {
         value: r
     }, n);
 }
 
-s(q, "ProvideModule");
+s(_, "ProvideModule");
 
-var z = require("react"), S = require("@adimm/x-injection"), k = class e extends S.InjectionProviderModuleError {
+var F = require("react"), S = require("@adimm/x-injection"), k = class e extends S.InjectionProviderModuleError {
     static {
         s(this, "InjectionHookFactoryError");
     }
     name=e.name;
 };
 
-function R({use: e, inject: t}) {
+function q({use: e, inject: t}) {
     return o => {
-        const r = f(), n = (0, z.useMemo)((() => {
+        const r = f(), n = (0, F.useMemo)((() => {
             if (0 === t.length) throw new k(r, "The 'deps' property array is missing!");
             return r.getMany(...t);
         }), [ t ]);
@@ -177,4 +193,4 @@ function R({use: e, inject: t}) {
     };
 }
 
-s(R, "hookFactory");//# sourceMappingURL=index.cjs.map
+s(q, "hookFactory");//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/core/react-context.ts","../src/core/hooks/use-component-module.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many.ts","../src/core/component-provider-module.ts","../src/core/provide-module/provide-module.arrow-function.tsx","../src/helpers/hooks/use-contextualized-module.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/forward-props-with-module.ts","../src/core/provide-module/provide-module.provider.tsx","../src/core/hook-factory.ts","../src/errors/hook-factory.ts"],"sourcesContent":["export * from './core';\nexport type * from './types';\n","import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../types';\n\nexport const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT = createContext<IComponentProviderModule>(AppModule as any);\n","import { useContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */\nexport function useComponentModule(): IComponentProviderModule {\n  return useContext(REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve a single dependency from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectOptions}.\n * @returns The resolved {@link T | dependency}.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useComponentModule();\n\n  return componentModule.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve multiple dependencies at once from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(\n  ...deps: D | unknown[]\n): ProviderModuleGetManySignature<D> {\n  const componentModule = useComponentModule();\n\n  return componentModule.getMany(...deps);\n}\n","import {\n  InjectionScope,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type CloneParams,\n  type IProviderModuleNaked,\n  type ProviderModuleOptions,\n} from '@adimm/x-injection';\n\nimport type { IComponentProviderModule, IComponentProviderModuleNaked } from '../types';\n\n/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */\nexport class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {\n  protected readonly _initializedFromComponent: IComponentProviderModuleNaked['_initializedFromComponent'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        defaultScope: options.defaultScope ?? InjectionScope.Singleton,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  override clone(options?: CloneParams): IComponentProviderModule {\n    let providers = [...this.providers];\n\n    if (options?.providersMap) {\n      providers = providers.map((provider) => options.providersMap!(provider, this));\n    }\n\n    const clonedModule = new ComponentProviderModule(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        isAppModule: this.isAppModule,\n        markAsGlobal: this.isMarkedAsGlobal,\n        identifier: Symbol(this.identifier.description!.replace('Component', '')),\n        defaultScope: this.defaultScope.native,\n        dynamicExports: this.dynamicExports,\n        onReady: this.onReady,\n        onDispose: this.onDispose,\n        importedProvidersMap: options?.importedProvidersMap,\n        imports: [...this.imports],\n        providers,\n        exports: [...this.exports],\n      })\n    );\n\n    //@ts-expect-error Read-only method.\n    clonedModule._initializedFromComponent = this._initializedFromComponent;\n\n    return clonedModule;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  //#region IComponentProviderModuleNaked methods\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.\n   */\n  protected _createContextualizedComponentInstance(): IComponentProviderModule {\n    if (this._initializedFromComponent) return this;\n\n    const ctxModule = this.clone().toNaked();\n\n    //@ts-expect-error Read-only property\n    ctxModule.identifier = Symbol(`Contextualized${ctxModule.identifier.description}`);\n    ctxModule._initializedFromComponent = true;\n\n    return ctxModule;\n  }\n\n  //#endregion\n}\n","import React from 'react';\n\nimport { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\nconst ComponentRenderer = React.memo(_ComponentRenderer);\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * export const MyComponent = provideModuleToComponent(\n *   MyComponentModule,\n *   ({ firstName, lastName }: MyComponentProps) => {\n *     const service = useInject(MyComponentService);\n *\n *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n *   }\n * );\n *\n * function App() {\n *   return <MyComponent firstName={'John'} lastName={'Doe'} />;\n * }\n * ```\n *\n * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function provideModuleToComponent<\n  P extends Record<string, any>,\n  C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>,\n>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C {\n  return ((componentProps: PropsWithModule<P>) => {\n    const moduleCtx = useContextualizedModule(module, componentProps.module);\n\n    return (\n      <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n        <ComponentRenderer module={moduleCtx} componentProps={componentProps} component={component as any} />\n      </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n    );\n  }) as any;\n}\n\nfunction _ComponentRenderer<P extends Record<string, any>>({\n  module,\n  component,\n  componentProps,\n}: {\n  module: IComponentProviderModule;\n  component: ReactElementWithProviderModule<P>;\n  componentProps: P;\n}) {\n  return <>{component(forwardPropsWithModule(component, componentProps, module))}</>;\n}\n\nexport type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;\n","import { useMemo } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { useEffectOnce } from './use-effect-once';\n\nexport function useContextualizedModule(\n  originalModule: IComponentProviderModule,\n  forwardedModule?: IComponentProviderModule\n): IComponentProviderModule {\n  const ctxModule = useMemo(() => {\n    const module = (forwardedModule ?? originalModule).toNaked();\n\n    if (module.isMarkedAsGlobal) return module;\n\n    return module._createContextualizedComponentInstance();\n  }, [originalModule, forwardedModule]);\n\n  useEffectOnce(() => {\n    return () => {\n      ctxModule.dispose();\n    };\n  });\n\n  return ctxModule;\n}\n","import { useEffect, useRef, useState } from 'react';\n\n// Credits: https://stackoverflow.com/a/74000921\n\n/** Custom {@link useEffect} hook which will be run once. _(In `StrictMode` as well)_ */\nexport function useEffectOnce(effect: () => React.EffectCallback) {\n  const destroyFunc = useRef<React.EffectCallback>(undefined);\n  const effectCalled = useRef(false);\n  const renderAfterCalled = useRef(false);\n  const [, forceRerender] = useState(0);\n\n  if (effectCalled.current) renderAfterCalled.current = true;\n\n  useEffect(() => {\n    // only execute the effect first time around\n    if (!effectCalled.current) {\n      destroyFunc.current = effect();\n      effectCalled.current = true;\n    }\n\n    // this forces one render after the effect is run\n    forceRerender((x) => x + 1);\n\n    return () => {\n      // if the comp didn't render since the useEffect was called,\n      // we know it's the dummy React cycle\n      if (!renderAfterCalled.current) return;\n\n      destroyFunc.current?.();\n    };\n  }, []);\n}\n","import { isFunction } from '@adimm/x-injection';\n\nimport type { ReactElementWithProviderModule } from '../core';\nimport type { IComponentProviderModule, PropsWithModule } from '../types';\n\nexport function forwardPropsWithModule<P extends Record<string, any>>(\n  component: ReactElementWithProviderModule<P> | React.ReactElement,\n  props: Record<string, any>,\n  module: IComponentProviderModule\n): PropsWithModule<P> {\n  const isReactElement = typeof component === 'object' && 'type' in component;\n\n  const result = {\n    ...props,\n  } as any;\n\n  if ((isReactElement && isFunction(component.type)) || isFunction(component)) {\n    result['module'] = module;\n  }\n\n  return result;\n}\n","import React, { useMemo } from 'react';\n\nimport { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * function MyComponent({ firstName, lastName }: MyComponentProps) {\n *   const service = useInject(MyComponentService);\n *\n *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n * }\n *\n * function App() {\n *   return (\n *     <ProvideModule module={MyComponentModule}>\n *       <MyComponent firstName={'John'} lastName={'Doe'} />\n *     </ProvideModule>\n *   );\n * }\n * ```\n *\n * @param param0 See {@link ProvideModuleFunctionParams}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function ProvideModule({ module, children }: ProvideModuleFunctionParams) {\n  /* istanbul ignore next */\n  const componentProps = (children.props ?? {}) as any;\n  const moduleCtx = useContextualizedModule(module, componentProps.module);\n  const component = useMemo(\n    () => React.cloneElement(children, forwardPropsWithModule(children, componentProps, moduleCtx)),\n    [componentProps, moduleCtx]\n  );\n\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {component}\n    </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n  );\n}\n\nexport interface ProvideModuleFunctionParams {\n  /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */\n  module: IComponentProviderModule;\n\n  children: React.ReactElement;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useMemo } from 'react';\n\nimport { InjectionHookFactoryError } from '../errors';\nimport { useComponentModule } from './hooks';\n\nexport function hookFactory<P extends HookParams, D extends any[], T>({\n  use: hook,\n  inject,\n}: HookFactoryParams<P, D, T>): (p: P) => T {\n  return (p: P) => {\n    const componentModule = useComponentModule();\n\n    const deps = useMemo(() => {\n      if (inject.length === 0) {\n        throw new InjectionHookFactoryError(componentModule, `The 'deps' property array is missing!`);\n      }\n\n      return componentModule.getMany(...inject);\n    }, [inject]);\n\n    return hook({ ...p, deps: [...deps] } as any);\n  };\n}\n\nexport interface HookFactoryParams<P extends HookParams, D extends any[], T> {\n  use: HookWithProviderModuleDependencies<P, D, T>;\n  inject: ProviderToken[];\n}\n\nexport type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;\n\nexport type HookWithDeps<P extends HookParams, D extends any[]> = P & {\n  /** Array containing the resolved dependencies from the component context. */\n  deps: D;\n};\n\ntype HookParams = Record<string, any> | void;\n","import { InjectionProviderModuleError } from '@adimm/x-injection';\n\nexport class InjectionHookFactoryError extends InjectionProviderModuleError {\n  override name = InjectionHookFactoryError.name;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;ACAA,yBAA0B;AAC1B,mBAA8B;AAIvB,IAAMA,gDAA4CC,4BAAwCC,4BAAAA;;;ACLjG,IAAAC,gBAA2B;AAMpB,SAASC,qBAAAA;AACd,aAAOC,0BAAWC,yCAAAA;AACpB;AAFgBF;;;ACST,SAASG,UAAaC,UAA4BC,SAA0B;AACjF,QAAMC,kBAAkBC,mBAAAA;AAExB,SAAOD,gBAAgBE,IAAIJ,UAAUC,SAASI,UAAAA;AAChD;AAJgBN;;;ACDT,SAASO,iBACXC,MAAmB;AAEtB,QAAMC,kBAAkBC,mBAAAA;AAExB,SAAOD,gBAAgBE,QAAO,GAAIH,IAAAA;AACpC;AANgBD;;;ACdhB,IAAAK,sBAOO;AAKA,IAAMC,0BAAN,MAAMA,iCAAgCC,mCAAAA;EAZ7C,OAY6CA;;;EACxBC;EAEnBC,YAAYC,SAAgC;AAC1C,UACEC,0CAAsBC,+BAA+B;MACnD,GAAGF;MACHG,cAAcH,QAAQG,gBAAgBC,mCAAeC;MACrDC,YAAYC,OAAO,YAAYP,QAAQM,WAAWE,WAAW,EAAE;IACjE,CAAA,CAAA;AAGF,SAAKV,4BAA4B;EACnC;EAESW,UAAgE;AACvE,WAAO;EACT;;EAGSC,MAAMV,SAAiD;AAC9D,QAAIW,YAAY;SAAI,KAAKA;;AAEzB,QAAIX,SAASY,cAAc;AACzBD,kBAAYA,UAAUE,IAAI,CAACC,aAAad,QAAQY,aAAcE,UAAU,IAAI,CAAA;IAC9E;AAEA,UAAMC,eAAe,IAAInB,yBACvBK,0CAAsBC,+BAA+B;MACnDc,aAAa,KAAKA;MAClBC,cAAc,KAAKC;MACnBZ,YAAYC,OAAO,KAAKD,WAAWE,YAAaW,QAAQ,aAAa,EAAA,CAAA;MACrEhB,cAAc,KAAKA,aAAaiB;MAChCC,gBAAgB,KAAKA;MACrBC,SAAS,KAAKA;MACdC,WAAW,KAAKA;MAChBC,sBAAsBxB,SAASwB;MAC/BC,SAAS;WAAI,KAAKA;;MAClBd;MACAe,SAAS;WAAI,KAAKA;;IACpB,CAAA,CAAA;AAIFX,iBAAajB,4BAA4B,KAAKA;AAE9C,WAAOiB;EACT;;EAGAY,UAAgB;AACd,SAAKC,SAAQ;EACf;;;;;;;EASUC,yCAAmE;AAC3E,QAAI,KAAK/B,0BAA2B,QAAO;AAE3C,UAAMgC,YAAY,KAAKpB,MAAK,EAAGD,QAAO;AAGtCqB,cAAUxB,aAAaC,OAAO,iBAAiBuB,UAAUxB,WAAWE,WAAW,EAAE;AACjFsB,cAAUhC,4BAA4B;AAEtC,WAAOgC;EACT;AAGF;;;ACtFA,IAAAC,gBAAkB;;;ACAlB,IAAAC,gBAAwB;;;ACAxB,IAAAC,gBAA4C;AAKrC,SAASC,cAAcC,QAAkC;AAC9D,QAAMC,kBAAcC,sBAA6BC,MAAAA;AACjD,QAAMC,mBAAeF,sBAAO,KAAA;AAC5B,QAAMG,wBAAoBH,sBAAO,KAAA;AACjC,QAAM,CAAA,EAAGI,aAAAA,QAAiBC,wBAAS,CAAA;AAEnC,MAAIH,aAAaI,QAASH,mBAAkBG,UAAU;AAEtDC,+BAAU,MAAA;AAER,QAAI,CAACL,aAAaI,SAAS;AACzBP,kBAAYO,UAAUR,OAAAA;AACtBI,mBAAaI,UAAU;IACzB;AAGAF,kBAAc,CAACI,MAAMA,IAAI,CAAA;AAEzB,WAAO,MAAA;AAGL,UAAI,CAACL,kBAAkBG,QAAS;AAEhCP,kBAAYO,UAAO;IACrB;EACF,GAAG,CAAA,CAAE;AACP;AA1BgBT;;;ADAT,SAASY,wBACdC,gBACAC,iBAA0C;AAE1C,QAAMC,gBAAYC,uBAAQ,MAAA;AACxB,UAAMC,WAAUH,mBAAmBD,gBAAgBK,QAAO;AAE1D,QAAID,QAAOE,iBAAkB,QAAOF;AAEpC,WAAOA,QAAOG,uCAAsC;EACtD,GAAG;IAACP;IAAgBC;GAAgB;AAEpCO,gBAAc,MAAA;AACZ,WAAO,MAAA;AACLN,gBAAUO,QAAO;IACnB;EACF,CAAA;AAEA,SAAOP;AACT;AAnBgBH;;;AELhB,IAAAW,sBAA2B;AAKpB,SAASC,uBACdC,WACAC,OACAC,SAAgC;AAEhC,QAAMC,iBAAiB,OAAOH,cAAc,YAAY,UAAUA;AAElE,QAAMI,SAAS;IACb,GAAGH;EACL;AAEA,MAAKE,sBAAkBE,gCAAWL,UAAUM,IAAI,SAAMD,gCAAWL,SAAAA,GAAY;AAC3EI,WAAO,QAAA,IAAYF;EACrB;AAEA,SAAOE;AACT;AAhBgBL;;;AHChB,IAAMQ,oBAAoBC,8BAAAA,QAAMC,KAAKC,kBAAAA;AA6B9B,SAASC,yBAGdC,SAAkCC,WAA4C;AAC9E,SAAQ,CAACC,mBAAAA;AACP,UAAMC,YAAYC,wBAAwBJ,SAAQE,eAAeF,MAAM;AAEvE,WACE,8BAAAJ,QAAA,cAACS,0CAA0CC,UAAQ;MAACC,OAAOJ;OACzD,8BAAAP,QAAA,cAACD,mBAAAA;MAAkBK,QAAQG;MAAWD;MAAgCD;;EAG5E;AACF;AAbgBF;AAehB,SAASD,mBAAkD,EACzDE,QAAAA,SACAC,WACAC,eAAc,GAKf;AACC,SAAO,8BAAAN,QAAA,cAAA,cAAAA,QAAA,UAAA,MAAGK,UAAUO,uBAAuBP,WAAWC,gBAAgBF,OAAAA,CAAAA,CAAAA;AACxE;AAVSF;;;AIlDT,IAAAW,gBAA+B;AAkCxB,SAASC,cAAc,EAAEC,QAAAA,SAAQC,SAAQ,GAA+B;AAE7E,QAAMC,iBAAkBD,SAASE,SAAS,CAAC;AAC3C,QAAMC,YAAYC,wBAAwBL,SAAQE,eAAeF,MAAM;AACvE,QAAMM,gBAAYC,uBAChB,MAAMC,8BAAAA,QAAMC,aAAaR,UAAUS,uBAAuBT,UAAUC,gBAAgBE,SAAAA,CAAAA,GACpF;IAACF;IAAgBE;GAAU;AAG7B,SACE,8BAAAI,QAAA,cAACG,0CAA0CC,UAAQ;IAACC,OAAOT;KACxDE,SAAAA;AAGP;AAdgBP;;;ACjChB,IAAAe,gBAAwB;;;ACDxB,IAAAC,sBAA6C;AAEtC,IAAMC,4BAAN,MAAMA,mCAAkCC,iDAAAA;EAF/C,OAE+CA;;;EACpCC,OAAOF,2BAA0BE;AAC5C;;;ADEO,SAASC,YAAsD,EACpEC,KAAKC,MACLC,OAAM,GACqB;AAC3B,SAAO,CAACC,MAAAA;AACN,UAAMC,kBAAkBC,mBAAAA;AAExB,UAAMC,WAAOC,uBAAQ,MAAA;AACnB,UAAIL,OAAOM,WAAW,GAAG;AACvB,cAAM,IAAIC,0BAA0BL,iBAAiB,uCAAuC;MAC9F;AAEA,aAAOA,gBAAgBM,QAAO,GAAIR,MAAAA;IACpC,GAAG;MAACA;KAAO;AAEX,WAAOD,KAAK;MAAE,GAAGE;MAAGG,MAAM;WAAIA;;IAAM,CAAA;EACtC;AACF;AAjBgBP;","names":["REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","createContext","AppModule","import_react","useComponentModule","useContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useInject","provider","options","componentModule","useComponentModule","get","isOptional","useInjectMany","deps","componentModule","useComponentModule","getMany","import_x_injection","ComponentProviderModule","ProviderModule","_initializedFromComponent","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Singleton","identifier","Symbol","description","toNaked","clone","providers","providersMap","map","provider","clonedModule","isAppModule","markAsGlobal","isMarkedAsGlobal","replace","native","dynamicExports","onReady","onDispose","importedProvidersMap","imports","exports","dispose","_dispose","_createContextualizedComponentInstance","ctxModule","import_react","import_react","import_react","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","module","toNaked","isMarkedAsGlobal","_createContextualizedComponentInstance","useEffectOnce","dispose","import_x_injection","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","ComponentRenderer","React","memo","_ComponentRenderer","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","forwardPropsWithModule","import_react","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","component","useMemo","React","cloneElement","forwardPropsWithModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","import_react","import_x_injection","InjectionHookFactoryError","InjectionProviderModuleError","name","hookFactory","use","hook","inject","p","componentModule","useComponentModule","deps","useMemo","length","InjectionHookFactoryError","getMany"]}
+{"version":3,"sources":["../src/index.ts","../src/core/react-context.ts","../src/core/hooks/use-component-module.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many.ts","../src/core/component-provider-module.ts","../src/core/provide-module/provide-module.arrow-function.tsx","../src/helpers/hooks/use-contextualized-module.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/component-provider-module.ts","../src/core/provide-module/provide-module.provider.tsx","../src/core/hook-factory.ts","../src/errors/hook-factory.ts"],"sourcesContent":["export * from './core';\nexport type * from './types';\n","import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../types';\n\nexport const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT = createContext<IComponentProviderModule>(AppModule as any);\n","import { useContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */\nexport function useComponentModule(): IComponentProviderModule {\n  return useContext(REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve a single dependency from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectOptions}.\n * @returns The resolved {@link T | dependency}.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useComponentModule();\n\n  return componentModule.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve multiple dependencies at once from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(\n  ...deps: D | unknown[]\n): ProviderModuleGetManySignature<D> {\n  const componentModule = useComponentModule();\n\n  return componentModule.getMany(...deps);\n}\n","import {\n  InjectionScope,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type IProviderModule,\n  type IProviderModuleNaked,\n  type ProviderModuleOptionsInternal,\n} from '@adimm/x-injection';\n\nimport type { ComponentProviderModuleOptions, IComponentProviderModule, IComponentProviderModuleNaked } from '../types';\n\n/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */\nexport class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {\n  protected readonly originalIdentifier: symbol;\n  protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];\n  protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];\n\n  constructor(options: ComponentProviderModuleOptions) {\n    const identifier = Symbol(`Component${options.identifier.description}`);\n    const contextualizeImports = options.markAsGlobal ? false : options.contextualizeImports ?? true;\n    const contextualizedImportsCache: Map<string, IProviderModule> | undefined = contextualizeImports\n      ? new Map()\n      : undefined;\n\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        defaultScope: options.defaultScope ?? InjectionScope.Singleton,\n        identifier: identifier,\n        imports: !contextualizeImports\n          ? options.imports\n          : options.imports?.map((imp) => {\n              const module = (typeof imp === 'function' ? imp() : imp) as IComponentProviderModuleNaked;\n              /* istanbul ignore next */\n              if (!contextualizeImports) return module;\n\n              return () => {\n                const ctxModule = module._createContextualizedComponentInstance(identifier);\n\n                contextualizedImportsCache!.set(module.originalIdentifier.toString(), ctxModule);\n\n                return ctxModule;\n              };\n            }),\n        dynamicExports: (_, exports) => {\n          if (!contextualizeImports) return exports;\n\n          return exports.map((exp) => {\n            if (!(exp instanceof ProviderModule)) return exp;\n\n            const cachedCtxModule = contextualizedImportsCache!.get(\n              (exp as unknown as IComponentProviderModuleNaked).originalIdentifier.toString()\n            )!;\n\n            return cachedCtxModule;\n          });\n        },\n      })\n    );\n\n    this.originalIdentifier = options.identifier;\n    this.hasContextualizedImports = contextualizeImports;\n    this.initializedFromComponent = false;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  override clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule {\n    const _options = options as ProviderModuleOptionsInternal;\n\n    const clonedModule = new ComponentProviderModule(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        isAppModule: this.isAppModule,\n        markAsGlobal: this.isMarkedAsGlobal,\n        identifier: Symbol(this.identifier.description!.replace('Component', '')),\n        defaultScope: this.defaultScope.native,\n        dynamicExports: this.dynamicExports,\n        onReady: this.onReady,\n        onDispose: this.onDispose,\n        contextualizeImports: this.hasContextualizedImports,\n        importedProvidersMap: this.importedProvidersMap,\n        imports: [...this.imports],\n        providers: [...this.providers],\n        exports: [...this.exports],\n        ..._options,\n      } as ComponentProviderModuleOptions)\n    );\n\n    //@ts-expect-error Read-only method.\n    clonedModule.initializedFromComponent = this.initializedFromComponent;\n\n    return clonedModule;\n  }\n\n  /* istanbul ignore next */\n  override async dispose(): Promise<void> {\n    await super.dispose();\n  }\n\n  //#region IComponentProviderModuleNaked methods\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.\n   */\n  protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule {\n    if (this.initializedFromComponent) return this;\n\n    const ctxModule = this.clone().toNaked();\n\n    /* istanbul ignore next */\n    //@ts-expect-error Read-only property\n    ctxModule.identifier = Symbol(\n      `${parentIdentifier ? `[Parent:${parentIdentifier.description ?? 'Unknown'}]` : ''}Contextualized${ctxModule.identifier.description}`\n    );\n    ctxModule.initializedFromComponent = true;\n\n    return ctxModule;\n  }\n\n  //#endregion\n}\n","import React from 'react';\n\nimport { ComponentProviderModuleHelpers, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\nconst ComponentRenderer = React.memo(_ComponentRenderer);\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * export const MyComponent = provideModuleToComponent<MyComponentProps>(\n *   MyComponentModule,\n *   ({ firstName, lastName }) => {\n *     const service = useInject(MyComponentService);\n *\n *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n *   }\n * );\n *\n * function App() {\n *   return <MyComponent firstName={'John'} lastName={'Doe'} />;\n * }\n * ```\n *\n * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function provideModuleToComponent<\n  P extends Record<string, any>,\n  C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>,\n>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C {\n  return ((componentProps: PropsWithModule<P>) => {\n    const moduleCtx = useContextualizedModule(module, componentProps.module);\n\n    return (\n      <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n        <ComponentRenderer module={moduleCtx} componentProps={componentProps} component={component as any} />\n      </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n    );\n  }) as any;\n}\n\nfunction _ComponentRenderer<P extends Record<string, any>>({\n  module,\n  component,\n  componentProps,\n}: {\n  module: IComponentProviderModule;\n  component: ReactElementWithProviderModule<P>;\n  componentProps: P;\n}) {\n  return <>{component(ComponentProviderModuleHelpers.forwardPropsWithModule(component, componentProps, module))}</>;\n}\n\nexport type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;\n","import { useMemo } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { useEffectOnce } from './use-effect-once';\n\nexport function useContextualizedModule(\n  originalModule: IComponentProviderModule,\n  forwardedModule?: IComponentProviderModule\n): IComponentProviderModule {\n  const ctxModule = useMemo(() => {\n    const module = (forwardedModule ?? originalModule).toNaked();\n\n    if (module.isMarkedAsGlobal) return module;\n\n    return module._createContextualizedComponentInstance();\n  }, [originalModule, forwardedModule]);\n\n  useEffectOnce(() => {\n    return () => {\n      ctxModule.dispose();\n    };\n  });\n\n  return ctxModule;\n}\n","import { useEffect, useRef, useState } from 'react';\n\n// Credits: https://stackoverflow.com/a/74000921\n\n/** Custom {@link useEffect} hook which will be run once. _(In `StrictMode` as well)_ */\nexport function useEffectOnce(effect: () => React.EffectCallback) {\n  const destroyFunc = useRef<React.EffectCallback>(undefined);\n  const effectCalled = useRef(false);\n  const renderAfterCalled = useRef(false);\n  const [, forceRerender] = useState(0);\n\n  if (effectCalled.current) renderAfterCalled.current = true;\n\n  useEffect(() => {\n    // only execute the effect first time around\n    if (!effectCalled.current) {\n      destroyFunc.current = effect();\n      effectCalled.current = true;\n    }\n\n    // this forces one render after the effect is run\n    forceRerender((x) => x + 1);\n\n    return () => {\n      // if the comp didn't render since the useEffect was called,\n      // we know it's the dummy React cycle\n      if (!renderAfterCalled.current) return;\n\n      destroyFunc.current?.();\n    };\n  }, []);\n}\n","import { isFunction } from '@adimm/x-injection';\n\nimport type { ReactElementWithProviderModule } from '../core';\nimport type { IComponentProviderModule, PropsWithModule } from '../types';\n\nexport namespace ComponentProviderModuleHelpers {\n  export function forwardPropsWithModule<P extends Record<string, any>>(\n    component: ReactElementWithProviderModule<P> | React.ReactElement,\n    props: Record<string, any>,\n    module: IComponentProviderModule\n  ): PropsWithModule<P> {\n    const isReactElement = typeof component === 'object' && 'type' in component;\n\n    const result = {\n      ...props,\n    } as any;\n\n    if ((isReactElement && isFunction(component.type)) || isFunction(component)) {\n      result['module'] = module;\n    }\n\n    return result;\n  }\n}\n","import React, { useMemo } from 'react';\n\nimport { ComponentProviderModuleHelpers, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * function MyComponent({ firstName, lastName }: MyComponentProps) {\n *   const service = useInject(MyComponentService);\n *\n *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n * }\n *\n * function App() {\n *   return (\n *     <ProvideModule module={MyComponentModule}>\n *       <MyComponent firstName={'John'} lastName={'Doe'} />\n *     </ProvideModule>\n *   );\n * }\n * ```\n *\n * @param param0 See {@link ProvideModuleFunctionParams}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function ProvideModule({ module, children }: ProvideModuleFunctionParams) {\n  /* istanbul ignore next */\n  const componentProps = (children.props ?? {}) as any;\n  const moduleCtx = useContextualizedModule(module, componentProps.module);\n  const component = useMemo(\n    () =>\n      React.cloneElement(\n        children,\n        ComponentProviderModuleHelpers.forwardPropsWithModule(children, componentProps, moduleCtx)\n      ),\n    [componentProps, moduleCtx]\n  );\n\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {component}\n    </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n  );\n}\n\nexport interface ProvideModuleFunctionParams {\n  /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */\n  module: IComponentProviderModule;\n\n  children: React.ReactElement;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useMemo } from 'react';\n\nimport { InjectionHookFactoryError } from '../errors';\nimport { useComponentModule } from './hooks';\n\nexport function hookFactory<P extends HookParams, D extends any[], T>({\n  use: hook,\n  inject,\n}: HookFactoryParams<P, D, T>): (p: P) => T {\n  return (p: P) => {\n    const componentModule = useComponentModule();\n\n    const deps = useMemo(() => {\n      if (inject.length === 0) {\n        throw new InjectionHookFactoryError(componentModule, `The 'deps' property array is missing!`);\n      }\n\n      return componentModule.getMany(...inject);\n    }, [inject]);\n\n    return hook({ ...p, deps: [...deps] } as any);\n  };\n}\n\nexport interface HookFactoryParams<P extends HookParams, D extends any[], T> {\n  use: HookWithProviderModuleDependencies<P, D, T>;\n  inject: ProviderToken[];\n}\n\nexport type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;\n\nexport type HookWithDeps<P extends HookParams, D extends any[]> = P & {\n  /** Array containing the resolved dependencies from the component context. */\n  deps: D;\n};\n\ntype HookParams = Record<string, any> | void;\n","import { InjectionProviderModuleError } from '@adimm/x-injection';\n\nexport class InjectionHookFactoryError extends InjectionProviderModuleError {\n  override name = InjectionHookFactoryError.name;\n}\n"],"mappings":"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","names":["REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","createContext","AppModule","import_react","useComponentModule","useContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useInject","provider","options","componentModule","useComponentModule","get","isOptional","useInjectMany","deps","componentModule","useComponentModule","getMany","import_x_injection","ComponentProviderModule","ProviderModule","originalIdentifier","hasContextualizedImports","initializedFromComponent","constructor","options","identifier","Symbol","description","contextualizeImports","markAsGlobal","contextualizedImportsCache","Map","undefined","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Singleton","imports","map","imp","module","ctxModule","_createContextualizedComponentInstance","set","toString","dynamicExports","_","exports","exp","cachedCtxModule","get","toNaked","clone","_options","clonedModule","isAppModule","isMarkedAsGlobal","replace","native","onReady","onDispose","importedProvidersMap","providers","dispose","parentIdentifier","import_react","import_react","import_react","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","module","toNaked","isMarkedAsGlobal","_createContextualizedComponentInstance","useEffectOnce","dispose","import_x_injection","ComponentProviderModuleHelpers","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","ComponentRenderer","React","memo","_ComponentRenderer","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","ComponentProviderModuleHelpers","forwardPropsWithModule","import_react","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","component","useMemo","React","cloneElement","ComponentProviderModuleHelpers","forwardPropsWithModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","import_react","import_x_injection","InjectionHookFactoryError","InjectionProviderModuleError","name","hookFactory","use","hook","inject","p","componentModule","useComponentModule","deps","useMemo","length","InjectionHookFactoryError","getMany"]}

package/dist/index.d.cts

@@ -1,16 +1,42 @@
 import * as React from 'react';
 import React__default from 'react';
-import { IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule, ProviderModuleOptions, CloneParams } from '@adimm/x-injection';
+import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+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;
+    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(): IComponentProviderModule;
+    _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
 }
 
 interface IComponentProviderModule extends IProviderModule {
@@ -25,7 +51,7 @@ interface IComponentProviderModule extends IProviderModule {
      *
      * _eg: When changing page, removable components and so on._
      */
-    dispose(): void;
+    dispose(): Promise<void>;
 }
 
 type PropsWithModule<P extends Record<string, any>> = P & {
@@ -74,17 +100,19 @@ declare function useComponentModule(): IComponentProviderModule;
 
 /** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
 declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
-    protected readonly _initializedFromComponent: IComponentProviderModuleNaked['_initializedFromComponent'];
-    constructor(options: ProviderModuleOptions);
+    protected readonly originalIdentifier: symbol;
+    protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];
+    protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];
+    constructor(options: ComponentProviderModuleOptions);
     toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    clone(options?: CloneParams): IComponentProviderModule;
-    dispose(): void;
+    clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule;
+    dispose(): Promise<void>;
     /**
      * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**
      *
      * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.
      */
-    protected _createContextualizedComponentInstance(): IComponentProviderModule;
+    protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
 }
 
 /**
@@ -97,9 +125,9 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  *   lastName: string;
  * }
  *
- * export const MyComponent = provideModuleToComponent(
+ * export const MyComponent = provideModuleToComponent<MyComponentProps>(
  *   MyComponentModule,
- *   ({ firstName, lastName }: MyComponentProps) => {
+ *   ({ firstName, lastName }) => {
  *     const service = useInject(MyComponentService);
  *
  *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>
@@ -164,4 +192,4 @@ type HookWithDeps<P extends HookParams, D extends any[]> = P & {
 };
 type HookParams = Record<string, any> | void;
 
-export { ComponentProviderModule, 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 { 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 };

package/dist/index.d.ts

@@ -1,16 +1,42 @@
 import * as React from 'react';
 import React__default from 'react';
-import { IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule, ProviderModuleOptions, CloneParams } from '@adimm/x-injection';
+import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+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;
+    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(): IComponentProviderModule;
+    _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
 }
 
 interface IComponentProviderModule extends IProviderModule {
@@ -25,7 +51,7 @@ interface IComponentProviderModule extends IProviderModule {
      *
      * _eg: When changing page, removable components and so on._
      */
-    dispose(): void;
+    dispose(): Promise<void>;
 }
 
 type PropsWithModule<P extends Record<string, any>> = P & {
@@ -74,17 +100,19 @@ declare function useComponentModule(): IComponentProviderModule;
 
 /** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
 declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
-    protected readonly _initializedFromComponent: IComponentProviderModuleNaked['_initializedFromComponent'];
-    constructor(options: ProviderModuleOptions);
+    protected readonly originalIdentifier: symbol;
+    protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];
+    protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];
+    constructor(options: ComponentProviderModuleOptions);
     toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked;
-    clone(options?: CloneParams): IComponentProviderModule;
-    dispose(): void;
+    clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule;
+    dispose(): Promise<void>;
     /**
      * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**
      *
      * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.
      */
-    protected _createContextualizedComponentInstance(): IComponentProviderModule;
+    protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule;
 }
 
 /**
@@ -97,9 +125,9 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  *   lastName: string;
  * }
  *
- * export const MyComponent = provideModuleToComponent(
+ * export const MyComponent = provideModuleToComponent<MyComponentProps>(
  *   MyComponentModule,
- *   ({ firstName, lastName }: MyComponentProps) => {
+ *   ({ firstName, lastName }) => {
  *     const service = useInject(MyComponentService);
  *
  *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>
@@ -164,4 +192,4 @@ type HookWithDeps<P extends HookParams, D extends any[]> = P & {
 };
 type HookParams = Record<string, any> | void;
 
-export { ComponentProviderModule, 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 { 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 };

package/dist/index.js

@@ -27,25 +27,38 @@ t(s, "useComponentModule"), t(a, "useInject"), t(m, "useInjectMany");
 
 import { InjectionScope as c, ProviderModule as p, ProviderModuleHelpers as d } from "@adimm/x-injection";
 
-var u = class e extends p {
+var u, l = class e extends p {
     static {
         t(this, "ComponentProviderModule");
     }
-    _initializedFromComponent;
+    originalIdentifier;
+    hasContextualizedImports;
+    initializedFromComponent;
     constructor(e) {
+        const o = Symbol(`Component${e.identifier.description}`), n = !e.markAsGlobal && (e.contextualizeImports ?? !0), r = n ? new Map : void 0;
         super(d.buildInternalConstructorParams({
             ...e,
             defaultScope: e.defaultScope ?? c.Singleton,
-            identifier: Symbol(`Component${e.identifier.description}`)
-        })), this._initializedFromComponent = !1;
+            identifier: o,
+            imports: n ? e.imports?.map((e => {
+                const t = "function" == typeof e ? e() : e;
+                return n ? () => {
+                    const e = t._createContextualizedComponentInstance(o);
+                    return r.set(t.originalIdentifier.toString(), e), e;
+                } : t;
+            })) : e.imports,
+            dynamicExports: t(((e, t) => n ? t.map((e => {
+                if (!(e instanceof p)) return e;
+                return r.get(e.originalIdentifier.toString());
+            })) : t), "dynamicExports")
+        })), this.originalIdentifier = e.identifier, this.hasContextualizedImports = n, 
+        this.initializedFromComponent = !1;
     }
     toNaked() {
         return this;
     }
     clone(t) {
-        let o = [ ...this.providers ];
-        t?.providersMap && (o = o.map((e => t.providersMap(e, this))));
-        const n = new e(d.buildInternalConstructorParams({
+        const o = t, n = new e(d.buildInternalConstructorParams({
             isAppModule: this.isAppModule,
             markAsGlobal: this.isMarkedAsGlobal,
             identifier: Symbol(this.identifier.description.replace("Component", "")),
@@ -53,40 +66,42 @@ var u = class e extends p {
             dynamicExports: this.dynamicExports,
             onReady: this.onReady,
             onDispose: this.onDispose,
-            importedProvidersMap: t?.importedProvidersMap,
+            contextualizeImports: this.hasContextualizedImports,
+            importedProvidersMap: this.importedProvidersMap,
             imports: [ ...this.imports ],
-            providers: o,
-            exports: [ ...this.exports ]
+            providers: [ ...this.providers ],
+            exports: [ ...this.exports ],
+            ...o
         }));
-        return n._initializedFromComponent = this._initializedFromComponent, n;
+        return n.initializedFromComponent = this.initializedFromComponent, n;
     }
-    dispose() {
-        this._dispose();
+    async dispose() {
+        await super.dispose();
     }
-    _createContextualizedComponentInstance() {
-        if (this._initializedFromComponent) return this;
-        const e = this.clone().toNaked();
-        return e.identifier = Symbol(`Contextualized${e.identifier.description}`), e._initializedFromComponent = !0, 
-        e;
+    _createContextualizedComponentInstance(e) {
+        if (this.initializedFromComponent) return this;
+        const t = this.clone().toNaked();
+        return t.identifier = Symbol(`${e ? `[Parent:${e.description ?? "Unknown"}]` : ""}Contextualized${t.identifier.description}`), 
+        t.initializedFromComponent = !0, t;
     }
 };
 
-import l from "react";
+import f from "react";
 
-import { useMemo as f } from "react";
+import { useMemo as h } from "react";
 
-import { useEffect as h, useRef as v, useState as C } from "react";
+import { useEffect as C, useRef as x, useState as y } from "react";
 
 function M(e) {
-    const t = v(void 0), o = v(!1), n = v(!1), [, r] = C(0);
-    o.current && (n.current = !0), h((() => (o.current || (t.current = e(), o.current = !0), 
+    const t = x(void 0), o = x(!1), n = x(!1), [, r] = y(0);
+    o.current && (n.current = !0), C((() => (o.current || (t.current = e(), o.current = !0), 
     r((e => e + 1)), () => {
         n.current && t.current?.();
     })), []);
 }
 
-function y(e, t) {
-    const o = f((() => {
+function v(e, t) {
+    const o = h((() => {
         const o = (t ?? e).toNaked();
         return o.isMarkedAsGlobal ? o : o._createContextualizedComponentInstance();
     }), [ e, t ]);
@@ -95,28 +110,29 @@ function y(e, t) {
     })), o;
 }
 
-t(M, "useEffectOnce"), t(y, "useContextualizedModule");
+t(M, "useEffectOnce"), t(v, "useContextualizedModule");
 
-import { isFunction as x } from "@adimm/x-injection";
+import { isFunction as I } from "@adimm/x-injection";
 
-function P(e, t, o) {
-    const n = {
-        ...t
-    };
-    return ("object" == typeof e && "type" in e && x(e.type) || x(e)) && (n.module = o), 
-    n;
-}
-
-t(P, "forwardPropsWithModule");
+!function(e) {
+    function o(e, t, o) {
+        const n = {
+            ...t
+        };
+        return ("object" == typeof e && "type" in e && I(e.type) || I(e)) && (n.module = o), 
+        n;
+    }
+    t(o, "forwardPropsWithModule"), e.forwardPropsWithModule = o;
+}(u || (u = {}));
 
-var b = l.memo(z);
+var z = f.memo(g);
 
-function j(e, t) {
+function P(e, t) {
     return o => {
-        const n = y(e, o.module);
-        return l.createElement(r.Provider, {
+        const n = v(e, o.module);
+        return f.createElement(r.Provider, {
             value: n
-        }, l.createElement(b, {
+        }, f.createElement(z, {
             module: n,
             componentProps: o,
             component: t
@@ -124,37 +140,37 @@ function j(e, t) {
     };
 }
 
-function z({module: e, component: t, componentProps: o}) {
-    return l.createElement(l.Fragment, null, t(P(t, o, e)));
+function g({module: e, component: t, componentProps: o}) {
+    return f.createElement(f.Fragment, null, t(u.forwardPropsWithModule(t, o, e)));
 }
 
-t(j, "provideModuleToComponent"), t(z, "_ComponentRenderer");
+t(P, "provideModuleToComponent"), t(g, "_ComponentRenderer");
 
-import _, { useMemo as E } from "react";
+import b, { useMemo as E } from "react";
 
-function F({module: e, children: t}) {
-    const o = t.props ?? {}, n = y(e, o.module), i = E((() => _.cloneElement(t, P(t, o, n))), [ o, n ]);
-    return _.createElement(r.Provider, {
+function j({module: e, children: t}) {
+    const o = t.props ?? {}, n = v(e, o.module), i = E((() => b.cloneElement(t, u.forwardPropsWithModule(t, o, n))), [ o, n ]);
+    return b.createElement(r.Provider, {
         value: n
     }, i);
 }
 
-t(F, "ProvideModule");
+t(j, "ProvideModule");
 
-import { useMemo as g } from "react";
+import { useMemo as k } from "react";
 
-import { InjectionProviderModuleError as k } from "@adimm/x-injection";
+import { InjectionProviderModuleError as w } from "@adimm/x-injection";
 
-var S = class e extends k {
+var S = class e extends w {
     static {
         t(this, "InjectionHookFactoryError");
     }
     name=e.name;
 };
 
-function I({use: e, inject: t}) {
+function F({use: e, inject: t}) {
     return o => {
-        const n = s(), r = g((() => {
+        const n = s(), r = k((() => {
             if (0 === t.length) throw new S(n, "The 'deps' property array is missing!");
             return n.getMany(...t);
         }), [ t ]);
@@ -165,6 +181,6 @@ function I({use: e, inject: t}) {
     };
 }
 
-t(I, "hookFactory");
+t(F, "hookFactory");
 
-export { u as ComponentProviderModule, F as ProvideModule, r as REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, I as hookFactory, j as provideModuleToComponent, s as useComponentModule, a as useInject, m as useInjectMany };//# sourceMappingURL=index.js.map
+export { l as ComponentProviderModule, j as ProvideModule, r as REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, F as hookFactory, P as provideModuleToComponent, s as useComponentModule, a as useInject, m as useInjectMany };//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/react-context.ts","../src/core/hooks/use-component-module.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many.ts","../src/core/component-provider-module.ts","../src/core/provide-module/provide-module.arrow-function.tsx","../src/helpers/hooks/use-contextualized-module.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/forward-props-with-module.ts","../src/core/provide-module/provide-module.provider.tsx","../src/core/hook-factory.ts","../src/errors/hook-factory.ts"],"sourcesContent":["import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../types';\n\nexport const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT = createContext<IComponentProviderModule>(AppModule as any);\n","import { useContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */\nexport function useComponentModule(): IComponentProviderModule {\n  return useContext(REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve a single dependency from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectOptions}.\n * @returns The resolved {@link T | dependency}.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useComponentModule();\n\n  return componentModule.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve multiple dependencies at once from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(\n  ...deps: D | unknown[]\n): ProviderModuleGetManySignature<D> {\n  const componentModule = useComponentModule();\n\n  return componentModule.getMany(...deps);\n}\n","import {\n  InjectionScope,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type CloneParams,\n  type IProviderModuleNaked,\n  type ProviderModuleOptions,\n} from '@adimm/x-injection';\n\nimport type { IComponentProviderModule, IComponentProviderModuleNaked } from '../types';\n\n/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */\nexport class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {\n  protected readonly _initializedFromComponent: IComponentProviderModuleNaked['_initializedFromComponent'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        defaultScope: options.defaultScope ?? InjectionScope.Singleton,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  override clone(options?: CloneParams): IComponentProviderModule {\n    let providers = [...this.providers];\n\n    if (options?.providersMap) {\n      providers = providers.map((provider) => options.providersMap!(provider, this));\n    }\n\n    const clonedModule = new ComponentProviderModule(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        isAppModule: this.isAppModule,\n        markAsGlobal: this.isMarkedAsGlobal,\n        identifier: Symbol(this.identifier.description!.replace('Component', '')),\n        defaultScope: this.defaultScope.native,\n        dynamicExports: this.dynamicExports,\n        onReady: this.onReady,\n        onDispose: this.onDispose,\n        importedProvidersMap: options?.importedProvidersMap,\n        imports: [...this.imports],\n        providers,\n        exports: [...this.exports],\n      })\n    );\n\n    //@ts-expect-error Read-only method.\n    clonedModule._initializedFromComponent = this._initializedFromComponent;\n\n    return clonedModule;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  //#region IComponentProviderModuleNaked methods\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.\n   */\n  protected _createContextualizedComponentInstance(): IComponentProviderModule {\n    if (this._initializedFromComponent) return this;\n\n    const ctxModule = this.clone().toNaked();\n\n    //@ts-expect-error Read-only property\n    ctxModule.identifier = Symbol(`Contextualized${ctxModule.identifier.description}`);\n    ctxModule._initializedFromComponent = true;\n\n    return ctxModule;\n  }\n\n  //#endregion\n}\n","import React from 'react';\n\nimport { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\nconst ComponentRenderer = React.memo(_ComponentRenderer);\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * export const MyComponent = provideModuleToComponent(\n *   MyComponentModule,\n *   ({ firstName, lastName }: MyComponentProps) => {\n *     const service = useInject(MyComponentService);\n *\n *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n *   }\n * );\n *\n * function App() {\n *   return <MyComponent firstName={'John'} lastName={'Doe'} />;\n * }\n * ```\n *\n * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function provideModuleToComponent<\n  P extends Record<string, any>,\n  C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>,\n>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C {\n  return ((componentProps: PropsWithModule<P>) => {\n    const moduleCtx = useContextualizedModule(module, componentProps.module);\n\n    return (\n      <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n        <ComponentRenderer module={moduleCtx} componentProps={componentProps} component={component as any} />\n      </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n    );\n  }) as any;\n}\n\nfunction _ComponentRenderer<P extends Record<string, any>>({\n  module,\n  component,\n  componentProps,\n}: {\n  module: IComponentProviderModule;\n  component: ReactElementWithProviderModule<P>;\n  componentProps: P;\n}) {\n  return <>{component(forwardPropsWithModule(component, componentProps, module))}</>;\n}\n\nexport type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;\n","import { useMemo } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { useEffectOnce } from './use-effect-once';\n\nexport function useContextualizedModule(\n  originalModule: IComponentProviderModule,\n  forwardedModule?: IComponentProviderModule\n): IComponentProviderModule {\n  const ctxModule = useMemo(() => {\n    const module = (forwardedModule ?? originalModule).toNaked();\n\n    if (module.isMarkedAsGlobal) return module;\n\n    return module._createContextualizedComponentInstance();\n  }, [originalModule, forwardedModule]);\n\n  useEffectOnce(() => {\n    return () => {\n      ctxModule.dispose();\n    };\n  });\n\n  return ctxModule;\n}\n","import { useEffect, useRef, useState } from 'react';\n\n// Credits: https://stackoverflow.com/a/74000921\n\n/** Custom {@link useEffect} hook which will be run once. _(In `StrictMode` as well)_ */\nexport function useEffectOnce(effect: () => React.EffectCallback) {\n  const destroyFunc = useRef<React.EffectCallback>(undefined);\n  const effectCalled = useRef(false);\n  const renderAfterCalled = useRef(false);\n  const [, forceRerender] = useState(0);\n\n  if (effectCalled.current) renderAfterCalled.current = true;\n\n  useEffect(() => {\n    // only execute the effect first time around\n    if (!effectCalled.current) {\n      destroyFunc.current = effect();\n      effectCalled.current = true;\n    }\n\n    // this forces one render after the effect is run\n    forceRerender((x) => x + 1);\n\n    return () => {\n      // if the comp didn't render since the useEffect was called,\n      // we know it's the dummy React cycle\n      if (!renderAfterCalled.current) return;\n\n      destroyFunc.current?.();\n    };\n  }, []);\n}\n","import { isFunction } from '@adimm/x-injection';\n\nimport type { ReactElementWithProviderModule } from '../core';\nimport type { IComponentProviderModule, PropsWithModule } from '../types';\n\nexport function forwardPropsWithModule<P extends Record<string, any>>(\n  component: ReactElementWithProviderModule<P> | React.ReactElement,\n  props: Record<string, any>,\n  module: IComponentProviderModule\n): PropsWithModule<P> {\n  const isReactElement = typeof component === 'object' && 'type' in component;\n\n  const result = {\n    ...props,\n  } as any;\n\n  if ((isReactElement && isFunction(component.type)) || isFunction(component)) {\n    result['module'] = module;\n  }\n\n  return result;\n}\n","import React, { useMemo } from 'react';\n\nimport { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * function MyComponent({ firstName, lastName }: MyComponentProps) {\n *   const service = useInject(MyComponentService);\n *\n *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n * }\n *\n * function App() {\n *   return (\n *     <ProvideModule module={MyComponentModule}>\n *       <MyComponent firstName={'John'} lastName={'Doe'} />\n *     </ProvideModule>\n *   );\n * }\n * ```\n *\n * @param param0 See {@link ProvideModuleFunctionParams}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function ProvideModule({ module, children }: ProvideModuleFunctionParams) {\n  /* istanbul ignore next */\n  const componentProps = (children.props ?? {}) as any;\n  const moduleCtx = useContextualizedModule(module, componentProps.module);\n  const component = useMemo(\n    () => React.cloneElement(children, forwardPropsWithModule(children, componentProps, moduleCtx)),\n    [componentProps, moduleCtx]\n  );\n\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {component}\n    </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n  );\n}\n\nexport interface ProvideModuleFunctionParams {\n  /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */\n  module: IComponentProviderModule;\n\n  children: React.ReactElement;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useMemo } from 'react';\n\nimport { InjectionHookFactoryError } from '../errors';\nimport { useComponentModule } from './hooks';\n\nexport function hookFactory<P extends HookParams, D extends any[], T>({\n  use: hook,\n  inject,\n}: HookFactoryParams<P, D, T>): (p: P) => T {\n  return (p: P) => {\n    const componentModule = useComponentModule();\n\n    const deps = useMemo(() => {\n      if (inject.length === 0) {\n        throw new InjectionHookFactoryError(componentModule, `The 'deps' property array is missing!`);\n      }\n\n      return componentModule.getMany(...inject);\n    }, [inject]);\n\n    return hook({ ...p, deps: [...deps] } as any);\n  };\n}\n\nexport interface HookFactoryParams<P extends HookParams, D extends any[], T> {\n  use: HookWithProviderModuleDependencies<P, D, T>;\n  inject: ProviderToken[];\n}\n\nexport type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;\n\nexport type HookWithDeps<P extends HookParams, D extends any[]> = P & {\n  /** Array containing the resolved dependencies from the component context. */\n  deps: D;\n};\n\ntype HookParams = Record<string, any> | void;\n","import { InjectionProviderModuleError } from '@adimm/x-injection';\n\nexport class InjectionHookFactoryError extends InjectionProviderModuleError {\n  override name = InjectionHookFactoryError.name;\n}\n"],"mappings":"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","names":["AppModule","createContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useContext","useComponentModule","useContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useInject","provider","options","componentModule","useComponentModule","get","isOptional","useInjectMany","deps","componentModule","useComponentModule","getMany","InjectionScope","ProviderModule","ProviderModuleHelpers","ComponentProviderModule","ProviderModule","_initializedFromComponent","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Singleton","identifier","Symbol","description","toNaked","clone","providers","providersMap","map","provider","clonedModule","isAppModule","markAsGlobal","isMarkedAsGlobal","replace","native","dynamicExports","onReady","onDispose","importedProvidersMap","imports","exports","dispose","_dispose","_createContextualizedComponentInstance","ctxModule","React","useMemo","useEffect","useRef","useState","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","module","toNaked","isMarkedAsGlobal","_createContextualizedComponentInstance","useEffectOnce","dispose","isFunction","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","ComponentRenderer","React","memo","_ComponentRenderer","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","forwardPropsWithModule","React","useMemo","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","component","useMemo","React","cloneElement","forwardPropsWithModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","useMemo","InjectionProviderModuleError","InjectionHookFactoryError","InjectionProviderModuleError","name","hookFactory","use","hook","inject","p","componentModule","useComponentModule","deps","useMemo","length","InjectionHookFactoryError","getMany"]}
+{"version":3,"sources":["../src/core/react-context.ts","../src/core/hooks/use-component-module.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many.ts","../src/core/component-provider-module.ts","../src/core/provide-module/provide-module.arrow-function.tsx","../src/helpers/hooks/use-contextualized-module.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/component-provider-module.ts","../src/core/provide-module/provide-module.provider.tsx","../src/core/hook-factory.ts","../src/errors/hook-factory.ts"],"sourcesContent":["import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../types';\n\nexport const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT = createContext<IComponentProviderModule>(AppModule as any);\n","import { useContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/** Can be used to retrieve the {@link IComponentProviderModule} from the current context. */\nexport function useComponentModule(): IComponentProviderModule {\n  return useContext(REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve a single dependency from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectOptions}.\n * @returns The resolved {@link T | dependency}.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useComponentModule();\n\n  return componentModule.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useComponentModule } from './use-component-module';\n\n/**\n * Low-level hook which can be used to resolve multiple dependencies at once from the current\n * context module.\n *\n * **Note:** _In order to better modularize your code-base, you should strive to create custom hooks by using the_\n * _`hookFactory` method to compose a custom hook._\n *\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(\n  ...deps: D | unknown[]\n): ProviderModuleGetManySignature<D> {\n  const componentModule = useComponentModule();\n\n  return componentModule.getMany(...deps);\n}\n","import {\n  InjectionScope,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type IProviderModule,\n  type IProviderModuleNaked,\n  type ProviderModuleOptionsInternal,\n} from '@adimm/x-injection';\n\nimport type { ComponentProviderModuleOptions, IComponentProviderModule, IComponentProviderModuleNaked } from '../types';\n\n/** A superset of the {@link ProviderModule} used to integrate within a `React` component. */\nexport class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {\n  protected readonly originalIdentifier: symbol;\n  protected readonly hasContextualizedImports: IComponentProviderModuleNaked['hasContextualizedImports'];\n  protected readonly initializedFromComponent: IComponentProviderModuleNaked['initializedFromComponent'];\n\n  constructor(options: ComponentProviderModuleOptions) {\n    const identifier = Symbol(`Component${options.identifier.description}`);\n    const contextualizeImports = options.markAsGlobal ? false : options.contextualizeImports ?? true;\n    const contextualizedImportsCache: Map<string, IProviderModule> | undefined = contextualizeImports\n      ? new Map()\n      : undefined;\n\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        defaultScope: options.defaultScope ?? InjectionScope.Singleton,\n        identifier: identifier,\n        imports: !contextualizeImports\n          ? options.imports\n          : options.imports?.map((imp) => {\n              const module = (typeof imp === 'function' ? imp() : imp) as IComponentProviderModuleNaked;\n              /* istanbul ignore next */\n              if (!contextualizeImports) return module;\n\n              return () => {\n                const ctxModule = module._createContextualizedComponentInstance(identifier);\n\n                contextualizedImportsCache!.set(module.originalIdentifier.toString(), ctxModule);\n\n                return ctxModule;\n              };\n            }),\n        dynamicExports: (_, exports) => {\n          if (!contextualizeImports) return exports;\n\n          return exports.map((exp) => {\n            if (!(exp instanceof ProviderModule)) return exp;\n\n            const cachedCtxModule = contextualizedImportsCache!.get(\n              (exp as unknown as IComponentProviderModuleNaked).originalIdentifier.toString()\n            )!;\n\n            return cachedCtxModule;\n          });\n        },\n      })\n    );\n\n    this.originalIdentifier = options.identifier;\n    this.hasContextualizedImports = contextualizeImports;\n    this.initializedFromComponent = false;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  override clone(options?: Partial<ComponentProviderModuleOptions>): IComponentProviderModule {\n    const _options = options as ProviderModuleOptionsInternal;\n\n    const clonedModule = new ComponentProviderModule(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        isAppModule: this.isAppModule,\n        markAsGlobal: this.isMarkedAsGlobal,\n        identifier: Symbol(this.identifier.description!.replace('Component', '')),\n        defaultScope: this.defaultScope.native,\n        dynamicExports: this.dynamicExports,\n        onReady: this.onReady,\n        onDispose: this.onDispose,\n        contextualizeImports: this.hasContextualizedImports,\n        importedProvidersMap: this.importedProvidersMap,\n        imports: [...this.imports],\n        providers: [...this.providers],\n        exports: [...this.exports],\n        ..._options,\n      } as ComponentProviderModuleOptions)\n    );\n\n    //@ts-expect-error Read-only method.\n    clonedModule.initializedFromComponent = this.initializedFromComponent;\n\n    return clonedModule;\n  }\n\n  /* istanbul ignore next */\n  override async dispose(): Promise<void> {\n    await super.dispose();\n  }\n\n  //#region IComponentProviderModuleNaked methods\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._createContextualizedComponentInstance}.\n   */\n  protected _createContextualizedComponentInstance(parentIdentifier?: symbol): IComponentProviderModule {\n    if (this.initializedFromComponent) return this;\n\n    const ctxModule = this.clone().toNaked();\n\n    /* istanbul ignore next */\n    //@ts-expect-error Read-only property\n    ctxModule.identifier = Symbol(\n      `${parentIdentifier ? `[Parent:${parentIdentifier.description ?? 'Unknown'}]` : ''}Contextualized${ctxModule.identifier.description}`\n    );\n    ctxModule.initializedFromComponent = true;\n\n    return ctxModule;\n  }\n\n  //#endregion\n}\n","import React from 'react';\n\nimport { ComponentProviderModuleHelpers, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\nconst ComponentRenderer = React.memo(_ComponentRenderer);\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * export const MyComponent = provideModuleToComponent<MyComponentProps>(\n *   MyComponentModule,\n *   ({ firstName, lastName }) => {\n *     const service = useInject(MyComponentService);\n *\n *     return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n *   }\n * );\n *\n * function App() {\n *   return <MyComponent firstName={'John'} lastName={'Doe'} />;\n * }\n * ```\n *\n * @param module The {@link IComponentProviderModule | Module} which should be consumed by the {@link component}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function provideModuleToComponent<\n  P extends Record<string, any>,\n  C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>,\n>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C {\n  return ((componentProps: PropsWithModule<P>) => {\n    const moduleCtx = useContextualizedModule(module, componentProps.module);\n\n    return (\n      <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n        <ComponentRenderer module={moduleCtx} componentProps={componentProps} component={component as any} />\n      </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n    );\n  }) as any;\n}\n\nfunction _ComponentRenderer<P extends Record<string, any>>({\n  module,\n  component,\n  componentProps,\n}: {\n  module: IComponentProviderModule;\n  component: ReactElementWithProviderModule<P>;\n  componentProps: P;\n}) {\n  return <>{component(ComponentProviderModuleHelpers.forwardPropsWithModule(component, componentProps, module))}</>;\n}\n\nexport type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;\n","import { useMemo } from 'react';\n\nimport type { IComponentProviderModule } from '../../types';\nimport { useEffectOnce } from './use-effect-once';\n\nexport function useContextualizedModule(\n  originalModule: IComponentProviderModule,\n  forwardedModule?: IComponentProviderModule\n): IComponentProviderModule {\n  const ctxModule = useMemo(() => {\n    const module = (forwardedModule ?? originalModule).toNaked();\n\n    if (module.isMarkedAsGlobal) return module;\n\n    return module._createContextualizedComponentInstance();\n  }, [originalModule, forwardedModule]);\n\n  useEffectOnce(() => {\n    return () => {\n      ctxModule.dispose();\n    };\n  });\n\n  return ctxModule;\n}\n","import { useEffect, useRef, useState } from 'react';\n\n// Credits: https://stackoverflow.com/a/74000921\n\n/** Custom {@link useEffect} hook which will be run once. _(In `StrictMode` as well)_ */\nexport function useEffectOnce(effect: () => React.EffectCallback) {\n  const destroyFunc = useRef<React.EffectCallback>(undefined);\n  const effectCalled = useRef(false);\n  const renderAfterCalled = useRef(false);\n  const [, forceRerender] = useState(0);\n\n  if (effectCalled.current) renderAfterCalled.current = true;\n\n  useEffect(() => {\n    // only execute the effect first time around\n    if (!effectCalled.current) {\n      destroyFunc.current = effect();\n      effectCalled.current = true;\n    }\n\n    // this forces one render after the effect is run\n    forceRerender((x) => x + 1);\n\n    return () => {\n      // if the comp didn't render since the useEffect was called,\n      // we know it's the dummy React cycle\n      if (!renderAfterCalled.current) return;\n\n      destroyFunc.current?.();\n    };\n  }, []);\n}\n","import { isFunction } from '@adimm/x-injection';\n\nimport type { ReactElementWithProviderModule } from '../core';\nimport type { IComponentProviderModule, PropsWithModule } from '../types';\n\nexport namespace ComponentProviderModuleHelpers {\n  export function forwardPropsWithModule<P extends Record<string, any>>(\n    component: ReactElementWithProviderModule<P> | React.ReactElement,\n    props: Record<string, any>,\n    module: IComponentProviderModule\n  ): PropsWithModule<P> {\n    const isReactElement = typeof component === 'object' && 'type' in component;\n\n    const result = {\n      ...props,\n    } as any;\n\n    if ((isReactElement && isFunction(component.type)) || isFunction(component)) {\n      result['module'] = module;\n    }\n\n    return result;\n  }\n}\n","import React, { useMemo } from 'react';\n\nimport { ComponentProviderModuleHelpers, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule } from '../../types';\nimport { REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT } from '../react-context';\n\n/**\n * Can be used to easily provide a {@link module} to any component.\n *\n * @example\n * ```tsx\n * interface MyComponentProps {\n *   firstName: string;\n *   lastName: string;\n * }\n *\n * function MyComponent({ firstName, lastName }: MyComponentProps) {\n *   const service = useInject(MyComponentService);\n *\n *   return <h1>Hello {service.computeUserName(firstName, lastName)}!</h1>\n * }\n *\n * function App() {\n *   return (\n *     <ProvideModule module={MyComponentModule}>\n *       <MyComponent firstName={'John'} lastName={'Doe'} />\n *     </ProvideModule>\n *   );\n * }\n * ```\n *\n * @param param0 See {@link ProvideModuleFunctionParams}.\n * @returns The provided {@link toComponent | Component}.\n */\nexport function ProvideModule({ module, children }: ProvideModuleFunctionParams) {\n  /* istanbul ignore next */\n  const componentProps = (children.props ?? {}) as any;\n  const moduleCtx = useContextualizedModule(module, componentProps.module);\n  const component = useMemo(\n    () =>\n      React.cloneElement(\n        children,\n        ComponentProviderModuleHelpers.forwardPropsWithModule(children, componentProps, moduleCtx)\n      ),\n    [componentProps, moduleCtx]\n  );\n\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {component}\n    </REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider>\n  );\n}\n\nexport interface ProvideModuleFunctionParams {\n  /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */\n  module: IComponentProviderModule;\n\n  children: React.ReactElement;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useMemo } from 'react';\n\nimport { InjectionHookFactoryError } from '../errors';\nimport { useComponentModule } from './hooks';\n\nexport function hookFactory<P extends HookParams, D extends any[], T>({\n  use: hook,\n  inject,\n}: HookFactoryParams<P, D, T>): (p: P) => T {\n  return (p: P) => {\n    const componentModule = useComponentModule();\n\n    const deps = useMemo(() => {\n      if (inject.length === 0) {\n        throw new InjectionHookFactoryError(componentModule, `The 'deps' property array is missing!`);\n      }\n\n      return componentModule.getMany(...inject);\n    }, [inject]);\n\n    return hook({ ...p, deps: [...deps] } as any);\n  };\n}\n\nexport interface HookFactoryParams<P extends HookParams, D extends any[], T> {\n  use: HookWithProviderModuleDependencies<P, D, T>;\n  inject: ProviderToken[];\n}\n\nexport type HookWithProviderModuleDependencies<P extends HookParams, D extends any[], T> = (p: HookWithDeps<P, D>) => T;\n\nexport type HookWithDeps<P extends HookParams, D extends any[]> = P & {\n  /** Array containing the resolved dependencies from the component context. */\n  deps: D;\n};\n\ntype HookParams = Record<string, any> | void;\n","import { InjectionProviderModuleError } from '@adimm/x-injection';\n\nexport class InjectionHookFactoryError extends InjectionProviderModuleError {\n  override name = InjectionHookFactoryError.name;\n}\n"],"mappings":"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","names":["AppModule","createContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useContext","useComponentModule","useContext","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","useInject","provider","options","componentModule","useComponentModule","get","isOptional","useInjectMany","deps","componentModule","useComponentModule","getMany","InjectionScope","ProviderModule","ProviderModuleHelpers","ComponentProviderModule","ProviderModule","originalIdentifier","hasContextualizedImports","initializedFromComponent","constructor","options","identifier","Symbol","description","contextualizeImports","markAsGlobal","contextualizedImportsCache","Map","undefined","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Singleton","imports","map","imp","module","ctxModule","_createContextualizedComponentInstance","set","toString","dynamicExports","_","exports","exp","cachedCtxModule","get","toNaked","clone","_options","clonedModule","isAppModule","isMarkedAsGlobal","replace","native","onReady","onDispose","importedProvidersMap","providers","dispose","parentIdentifier","React","useMemo","useEffect","useRef","useState","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","module","toNaked","isMarkedAsGlobal","_createContextualizedComponentInstance","useEffectOnce","dispose","isFunction","ComponentProviderModuleHelpers","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","ComponentRenderer","React","memo","_ComponentRenderer","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","ComponentProviderModuleHelpers","forwardPropsWithModule","React","useMemo","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","component","useMemo","React","cloneElement","ComponentProviderModuleHelpers","forwardPropsWithModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","useMemo","InjectionProviderModuleError","InjectionHookFactoryError","InjectionProviderModuleError","name","hookFactory","use","hook","inject","p","componentModule","useComponentModule","deps","useMemo","length","InjectionHookFactoryError","getMany"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adimm/x-injection-reactjs",
   "description": "ReactJS integration of the `xInjection` library.",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "author": "Adi-Marian Mutu",
   "homepage": "https://github.com/AdiMarianMutu/x-injection-reactjs#readme",
   "bugs": "https://github.com/AdiMarianMutu/x-injection-reactjs/issues",
@@ -38,7 +38,7 @@
     "v:bump-major": "npm version major -m \"chore: update lib major version %s\""
   },
   "dependencies": {
-    "@adimm/x-injection": "^0.6.4",
+    "@adimm/x-injection": "^0.7.0",
     "react": ">=18.0.0"
   },
   "devDependencies": {