@adimm/x-injection-reactjs 0.2.1 → 0.2.3

package/README.md

@@ -26,6 +26,8 @@ xInjection ReactJS <a href="https://www.npmjs.com/package/@adimm/x-injection-rea
   - [Hook Injection](#hook-injection)
 - [Examples](#examples)
   - [Composable components](#composable-components)
+- [Common Mistakes](#common-mistakes)
+  - [Global ComponentModule](#global-componentmodule)
 - [Unit Tests](#unit-tests)
 - [Documentation](#documentation)
 - [Contributing](#contributing)
@@ -218,7 +220,7 @@ export function UserInfo({ firstName, lastName }: UserInfoProps) {
 
 In a real world scenario, you'll definitely have custom components which render other custom components and so on... _(like a [Matryoshka doll](https://en.wikipedia.org/wiki/Matryoshka_doll))_
 
-So you may find yourself wanting to be able to control a dependency/service of a child component from a parent component, with `xInject` this is very easy to achieve thanks to the `ProviderModule` architecture, because each `module` can `import` and `export` other dependencies _(or modules)_ it fits in perfectly within the [declarative programming](https://en.wikipedia.org/wiki/Declarative_programming) world!
+So you may find yourself wanting to be able to control a dependency/service of a child component from a parent component, with `xInjection` this is very easy to achieve thanks to the `ProviderModule` architecture, because each `module` can `import` and `export` other dependencies _(or modules)_ it fits in perfectly within the [declarative programming](https://en.wikipedia.org/wiki/Declarative_programming) world!
 
 In this example, we'll build 4 components, each with its own purpose. However, the `autocomplete` component will be the one capable of accessing the services of all of them.
 
@@ -467,6 +469,44 @@ This should cover the fundamentals of how you can build a scalable UI by using t
 
 > **Note:** _Keep in mind that both library ([xInjection](https://www.npmjs.com/package/@adimm/x-injection) & [xInjection ReactJS](https://www.npmjs.com/package/@adimm/x-injection-reactjs)) are still young and being developed, therefore the internals and public API may change in the near future._
 
+## Common Mistakes
+
+### Global ComponentModule
+
+When creating a _global_ component module, you may do a subtle mistake which may lead to an unexpected "bug", to better understand see the below example:
+
+```tsx
+const ModalModule = new ComponentProviderModule({
+  identifier: Symbol('ModalModule'),
+  markAsGlobal: true,
+  provides: [ModalService],
+  exports: [ModalService],
+});
+
+const ModalComponent = provideModuleToComponent(ModalModule, () => {
+  const modalService = useInject(ModalService);
+});
+```
+
+The mistake here is wrapping the `ModalComponent` within a module provider _(either the `provideModuleToComponent` HOF or the `ProvideModule` HOC)_, because when you'll use the `useInject` hook, it'll resolve from the _contextualized_ `ModalModule` rather than from the `AppModule`, therefore the resolved `modalService` within the `ModalComponent` will not be the same instance as the one which has been resolved directly from the `AppModule`!
+
+The correct code:
+
+```tsx
+const ModalModule = new ComponentProviderModule({
+  identifier: Symbol('ModalModule'),
+  markAsGlobal: true,
+  provides: [ModalService],
+  exports: [ModalService],
+});
+
+const ModalComponent = () => {
+  const modalService = useInject(ModalService);
+};
+```
+
+Now the `useInject` hook will correctly resolve the `ModalService` from the `AppModule` instead.
+
 ## Unit Tests
 
 It is very easy to create mock modules so you can provide them to your components in your unit tests.
@@ -506,11 +546,10 @@ const ApiModuleMocked = new ComponentProviderModule({
   ],
 });
 
+// Now all the dependencies used inside the `RealComponent` will be automatically resolved from the `ApiModuleMocked` component module.
 await act(async () => render(<RealComponent module={ApiModuleMocked} />));
 ```
 
-Now what you have to do is just to provide the `ApiModuleMocked` instead of the `ApiModule` 😎
-
 ## Documentation
 
 Comprehensive, auto-generated documentation is available at:

package/dist/index.cjs

@@ -3,57 +3,60 @@
 var e, t = Object.create, o = Object.defineProperty, r = Object.getOwnPropertyDescriptor, n = Object.getOwnPropertyNames, i = Object.getPrototypeOf, u = Object.prototype.hasOwnProperty, s = (e, t) => o(e, "name", {
     value: t,
     configurable: !0
-}), c = (e, t, i, s) => {
-    if (t && "object" == typeof t || "function" == typeof t) for (let c of n(t)) u.call(e, c) || c === i || o(e, c, {
-        get: () => t[c],
-        enumerable: !(s = r(t, c)) || s.enumerable
+}), a = (e, t, i, s) => {
+    if (t && "object" == typeof t || "function" == typeof t) for (let a of n(t)) u.call(e, a) || a === i || o(e, a, {
+        get: () => t[a],
+        enumerable: !(s = r(t, a)) || s.enumerable
     });
     return e;
-}, a = {};
+}, c = (e, r, n) => (n = null != e ? t(i(e)) : {}, a(!r && e && e.__esModule ? n : o(n, "default", {
+    value: e,
+    enumerable: !0
+}), e)), d = {};
 
 ((e, t) => {
     for (var r in t) o(e, r, {
         get: t[r],
         enumerable: !0
     });
-})(a, {
-    ComponentProviderModule: () => C,
-    ProvideModule: () => I,
+})(d, {
+    ComponentProviderModule: () => h,
+    ProvideModule: () => q,
     REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: () => p,
-    hookFactory: () => q,
-    provideModuleToComponent: () => x,
-    useComponentModule: () => m,
-    useInject: () => f,
-    useInjectMany: () => v
-}), module.exports = (e = a, c(o({}, "__esModule", {
+    hookFactory: () => w,
+    provideModuleToComponent: () => I,
+    useComponentModule: () => f,
+    useInject: () => v,
+    useInjectMany: () => M
+}), module.exports = (e = d, a(o({}, "__esModule", {
     value: !0
 }), e));
 
-var d = require("@adimm/x-injection"), p = (0, require("react").createContext)(d.AppModule), l = require("react");
+var l = require("@adimm/x-injection"), p = (0, require("react").createContext)(l.AppModule), m = require("react");
 
-function m() {
-    return (0, l.useContext)(p);
+function f() {
+    return (0, m.useContext)(p);
 }
 
-function f(e, t) {
-    return m().get(e, t?.isOptional);
+function v(e, t) {
+    return f().get(e, t?.isOptional);
 }
 
-function v(...e) {
-    return m().getMany(...e);
+function M(...e) {
+    return f().getMany(...e);
 }
 
-s(m, "useComponentModule"), s(f, "useInject"), s(v, "useInjectMany");
+s(f, "useComponentModule"), s(v, "useInject"), s(M, "useInjectMany");
 
-var M = require("@adimm/x-injection"), C = class e extends M.ProviderModule {
+var C = require("@adimm/x-injection"), h = class e extends C.ProviderModule {
     static {
         s(this, "ComponentProviderModule");
     }
     _initializedFromComponent;
     constructor(e) {
-        super(M.ProviderModuleHelpers.buildInternalConstructorParams({
+        super(C.ProviderModuleHelpers.buildInternalConstructorParams({
             ...e,
-            defaultScope: e.defaultScope ?? M.InjectionScope.Singleton,
+            defaultScope: e.defaultScope ?? C.InjectionScope.Singleton,
             identifier: Symbol(`Component${e.identifier.description}`)
         })), this._initializedFromComponent = !1;
     }
@@ -63,7 +66,7 @@ var M = require("@adimm/x-injection"), C = class e extends M.ProviderModule {
     clone(t) {
         let o = [ ...this.providers ];
         t?.providersMap && (o = o.map((e => t.providersMap(e, this))));
-        const r = new e(M.ProviderModuleHelpers.buildInternalConstructorParams({
+        const r = new e(C.ProviderModuleHelpers.buildInternalConstructorParams({
             isAppModule: this.isAppModule,
             identifier: Symbol(this.identifier.description.replace("Component", "")),
             defaultScope: this.defaultScope.native,
@@ -86,42 +89,46 @@ var M = require("@adimm/x-injection"), C = class e extends M.ProviderModule {
         return e.identifier = Symbol(`Contextualized${e.identifier.description}`), e._initializedFromComponent = !0, 
         e;
     }
-}, h = require("react"), y = require("react");
+}, y = c(require("react"), 1), P = require("react"), j = require("react");
 
-function P(e) {
-    const t = (0, y.useRef)(void 0), o = (0, y.useRef)(!1), r = (0, y.useRef)(!1), [, n] = (0, 
-    y.useState)(0);
-    o.current && (r.current = !0), (0, y.useEffect)((() => (o.current || (t.current = e(), 
+function _(e) {
+    const t = (0, j.useRef)(void 0), o = (0, j.useRef)(!1), r = (0, j.useRef)(!1), [, n] = (0, 
+    j.useState)(0);
+    o.current && (r.current = !0), (0, j.useEffect)((() => (o.current || (t.current = e(), 
     o.current = !0), n((e => e + 1)), () => {
         r.current && t.current?.();
     })), []);
 }
 
-function j(e, t) {
-    const o = (0, h.useMemo)((() => (t ?? e).toNaked()._createContextualizedComponentInstance()), [ e, t ]);
-    return P((() => () => {
+function b(e, t) {
+    const o = (0, P.useMemo)((() => (t ?? e).toNaked()._createContextualizedComponentInstance()), [ e, t ]);
+    return _((() => () => {
         o.dispose();
     })), o;
 }
 
-s(P, "useEffectOnce"), s(j, "useContextualizedModule");
+s(_, "useEffectOnce"), s(b, "useContextualizedModule");
 
-var b = require("@adimm/x-injection");
+var x = require("@adimm/x-injection");
 
-function _(e, t, o) {
+function E(e, t, o) {
     const r = {
         ...t
     };
-    return ("object" == typeof e && "type" in e && (0, b.isFunction)(e.type) || (0, 
-    b.isFunction)(e)) && (r.module = o), r;
+    return ("object" == typeof e && "type" in e && (0, x.isFunction)(e.type) || (0, 
+    x.isFunction)(e)) && (r.module = o), r;
 }
 
-function x(e, t) {
+s(E, "forwardPropsWithModule");
+
+var O = y.default.memo(g);
+
+function I(e, t) {
     return o => {
-        const r = j(e, o.module);
-        return React.createElement(p.Provider, {
+        const r = b(e, o.module);
+        return y.default.createElement(p.Provider, {
             value: r
-        }, React.createElement(E, {
+        }, y.default.createElement(O, {
             module: r,
             componentProps: o,
             component: t
@@ -129,37 +136,34 @@ function x(e, t) {
     };
 }
 
-function E({module: e, component: t, componentProps: o}) {
-    return React.createElement(React.Fragment, null, t(_(t, o, e)));
+function g({module: e, component: t, componentProps: o}) {
+    return y.default.createElement(y.default.Fragment, null, t(E(t, o, e)));
 }
 
-s(_, "forwardPropsWithModule"), s(x, "provideModuleToComponent"), s(E, "ComponentRenderer");
+s(I, "provideModuleToComponent"), s(g, "_ComponentRenderer");
 
-var O = ((e, r, n) => (n = null != e ? t(i(e)) : {}, c(!r && e && e.__esModule ? n : o(n, "default", {
-    value: e,
-    enumerable: !0
-}), e)))(require("react"), 1);
+var F = c(require("react"), 1);
 
-function I({module: e, children: t}) {
-    const o = t.props ?? {}, r = j(e, o.module);
-    return O.default.createElement(p.Provider, {
+function q({module: e, children: t}) {
+    const o = t.props ?? {}, r = b(e, o.module), n = (0, F.useMemo)((() => F.default.cloneElement(t, E(t, o, r))), [ o, r ]);
+    return F.default.createElement(p.Provider, {
         value: r
-    }, O.default.cloneElement(t, _(t, o, r)));
+    }, n);
 }
 
-s(I, "ProvideModule");
+s(q, "ProvideModule");
 
-var g = require("react"), R = require("@adimm/x-injection"), F = class e extends R.InjectionProviderModuleError {
+var z = require("react"), S = require("@adimm/x-injection"), R = class e extends S.InjectionProviderModuleError {
     static {
         s(this, "InjectionHookFactoryError");
     }
     name=e.name;
 };
 
-function q({use: e, inject: t}) {
+function w({use: e, inject: t}) {
     return o => {
-        const r = m(), n = (0, g.useMemo)((() => {
-            if (0 === t.length) throw new F(r, "The 'deps' property array is missing!");
+        const r = f(), n = (0, z.useMemo)((() => {
+            if (0 === t.length) throw new R(r, "The 'deps' property array is missing!");
             return r.getMany(...t);
         }), [ t ]);
         return e({
@@ -169,4 +173,4 @@ function q({use: e, inject: t}) {
     };
 }
 
-s(q, "hookFactory");//# sourceMappingURL=index.cjs.map
+s(w, "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/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.arrow-function.tsx","../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        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 { 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    return (forwardedModule ?? originalModule).toNaked()._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 { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } 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 * 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} />\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 React 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\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {React.cloneElement(children, forwardPropsWithModule(children, componentProps, moduleCtx))}\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","_initializedFromComponent","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Singleton","identifier","Symbol","description","toNaked","clone","providers","providersMap","map","provider","clonedModule","isAppModule","replace","native","dynamicExports","onReady","onDispose","importedProvidersMap","imports","exports","dispose","_dispose","_createContextualizedComponentInstance","ctxModule","import_react","import_react","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","toNaked","_createContextualizedComponentInstance","useEffectOnce","dispose","import_x_injection","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","ComponentRenderer","forwardPropsWithModule","import_react","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","React","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","cloneElement","forwardPropsWithModule","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/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        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    return (forwardedModule ?? originalModule).toNaked()._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":["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","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","toNaked","_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"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import * as react from 'react';
-import react__default from 'react';
+import * as React from 'react';
+import React__default from 'react';
 import { IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule, ProviderModuleOptions, CloneParams } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -38,7 +38,7 @@ type PropsWithModule<P extends Record<string, any>> = P & {
     module?: IComponentProviderModule;
 };
 
-declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: react.Context<IComponentProviderModule>;
+declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponentProviderModule>;
 
 /**
  * Low-level hook which can be used to resolve a single dependency from the current
@@ -115,7 +115,7 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  * @returns The provided {@link toComponent | Component}.
  */
 declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C;
-type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;
+type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React__default.ReactNode;
 
 /**
  * Can be used to easily provide a {@link module} to any component.
@@ -149,7 +149,7 @@ declare function ProvideModule({ module, children }: ProvideModuleFunctionParams
 interface ProvideModuleFunctionParams {
     /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */
     module: IComponentProviderModule;
-    children: react__default.ReactElement;
+    children: React__default.ReactElement;
 }
 
 declare function hookFactory<P extends HookParams, D extends any[], T>({ use: hook, inject, }: HookFactoryParams<P, D, T>): (p: P) => T;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import * as react from 'react';
-import react__default from 'react';
+import * as React from 'react';
+import React__default from 'react';
 import { IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule, ProviderModuleOptions, CloneParams } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -38,7 +38,7 @@ type PropsWithModule<P extends Record<string, any>> = P & {
     module?: IComponentProviderModule;
 };
 
-declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: react.Context<IComponentProviderModule>;
+declare const REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT: React.Context<IComponentProviderModule>;
 
 /**
  * Low-level hook which can be used to resolve a single dependency from the current
@@ -115,7 +115,7 @@ declare class ComponentProviderModule extends ProviderModule implements ICompone
  * @returns The provided {@link toComponent | Component}.
  */
 declare function provideModuleToComponent<P extends Record<string, any>, C extends ReactElementWithProviderModule<P> = ReactElementWithProviderModule<P>>(module: IComponentProviderModule, component: ReactElementWithProviderModule<P>): C;
-type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React.ReactNode;
+type ReactElementWithProviderModule<P extends Record<string, any>> = (p: PropsWithModule<P>) => React__default.ReactNode;
 
 /**
  * Can be used to easily provide a {@link module} to any component.
@@ -149,7 +149,7 @@ declare function ProvideModule({ module, children }: ProvideModuleFunctionParams
 interface ProvideModuleFunctionParams {
     /** The {@link IComponentProviderModule | Module} which should be consumed by the {@link children | component}. */
     module: IComponentProviderModule;
-    children: react__default.ReactElement;
+    children: React__default.ReactElement;
 }
 
 declare function hookFactory<P extends HookParams, D extends any[], T>({ use: hook, inject, }: HookFactoryParams<P, D, T>): (p: P) => T;

package/dist/index.js

@@ -15,7 +15,7 @@ function s() {
     return i(r);
 }
 
-function c(e, t) {
+function m(e, t) {
     return s().get(e, t?.isOptional);
 }
 
@@ -23,9 +23,9 @@ function a(...e) {
     return s().getMany(...e);
 }
 
-t(s, "useComponentModule"), t(c, "useInject"), t(a, "useInjectMany");
+t(s, "useComponentModule"), t(m, "useInject"), t(a, "useInjectMany");
 
-import { InjectionScope as m, ProviderModule as p, ProviderModuleHelpers as d } from "@adimm/x-injection";
+import { InjectionScope as c, ProviderModule as p, ProviderModuleHelpers as d } from "@adimm/x-injection";
 
 var u = class e extends p {
     static {
@@ -35,7 +35,7 @@ var u = class e extends p {
     constructor(e) {
         super(d.buildInternalConstructorParams({
             ...e,
-            defaultScope: e.defaultScope ?? m.Singleton,
+            defaultScope: e.defaultScope ?? c.Singleton,
             identifier: Symbol(`Component${e.identifier.description}`)
         })), this._initializedFromComponent = !1;
     }
@@ -70,43 +70,49 @@ var u = class e extends p {
     }
 };
 
-import { useMemo as l } from "react";
+import l from "react";
 
-import { useEffect as f, useRef as h, useState as v } from "react";
+import { useMemo as f } from "react";
 
-function C(e) {
-    const t = h(void 0), o = h(!1), n = h(!1), [, r] = v(0);
-    o.current && (n.current = !0), f((() => (o.current || (t.current = e(), o.current = !0), 
+import { useEffect as h, useRef as v, useState as C } from "react";
+
+function y(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), 
     r((e => e + 1)), () => {
         n.current && t.current?.();
     })), []);
 }
 
-function y(e, t) {
-    const o = l((() => (t ?? e).toNaked()._createContextualizedComponentInstance()), [ e, t ]);
-    return C((() => () => {
+function M(e, t) {
+    const o = f((() => (t ?? e).toNaked()._createContextualizedComponentInstance()), [ e, t ]);
+    return y((() => () => {
         o.dispose();
     })), o;
 }
 
-t(C, "useEffectOnce"), t(y, "useContextualizedModule");
+t(y, "useEffectOnce"), t(M, "useContextualizedModule");
 
-import { isFunction as M } from "@adimm/x-injection";
+import { isFunction as x } from "@adimm/x-injection";
 
-function x(e, t, o) {
+function P(e, t, o) {
     const n = {
         ...t
     };
-    return ("object" == typeof e && "type" in e && M(e.type) || M(e)) && (n.module = o), 
+    return ("object" == typeof e && "type" in e && x(e.type) || x(e)) && (n.module = o), 
     n;
 }
 
-function P(e, t) {
+t(P, "forwardPropsWithModule");
+
+var j = l.memo(_);
+
+function z(e, t) {
     return o => {
-        const n = y(e, o.module);
-        return React.createElement(r.Provider, {
+        const n = M(e, o.module);
+        return l.createElement(r.Provider, {
             value: n
-        }, React.createElement(j, {
+        }, l.createElement(j, {
             module: n,
             componentProps: o,
             component: t
@@ -114,38 +120,38 @@ function P(e, t) {
     };
 }
 
-function j({module: e, component: t, componentProps: o}) {
-    return React.createElement(React.Fragment, null, t(x(t, o, e)));
+function _({module: e, component: t, componentProps: o}) {
+    return l.createElement(l.Fragment, null, t(P(t, o, e)));
 }
 
-t(x, "forwardPropsWithModule"), t(P, "provideModuleToComponent"), t(j, "ComponentRenderer");
+t(z, "provideModuleToComponent"), t(_, "_ComponentRenderer");
 
-import z from "react";
+import E, { useMemo as F } from "react";
 
-function E({module: e, children: t}) {
-    const o = t.props ?? {}, n = y(e, o.module);
-    return z.createElement(r.Provider, {
+function b({module: e, children: t}) {
+    const o = t.props ?? {}, n = M(e, o.module), i = F((() => E.cloneElement(t, P(t, o, n))), [ o, n ]);
+    return E.createElement(r.Provider, {
         value: n
-    }, z.cloneElement(t, x(t, o, n)));
+    }, i);
 }
 
-t(E, "ProvideModule");
+t(b, "ProvideModule");
 
-import { useMemo as F } from "react";
+import { useMemo as g } from "react";
 
-import { InjectionProviderModuleError as _ } from "@adimm/x-injection";
+import { InjectionProviderModuleError as S } from "@adimm/x-injection";
 
-var b = class e extends _ {
+var I = class e extends S {
     static {
         t(this, "InjectionHookFactoryError");
     }
     name=e.name;
 };
 
-function g({use: e, inject: t}) {
+function k({use: e, inject: t}) {
     return o => {
-        const n = s(), r = F((() => {
-            if (0 === t.length) throw new b(n, "The 'deps' property array is missing!");
+        const n = s(), r = g((() => {
+            if (0 === t.length) throw new I(n, "The 'deps' property array is missing!");
             return n.getMany(...t);
         }), [ t ]);
         return e({
@@ -155,6 +161,6 @@ function g({use: e, inject: t}) {
     };
 }
 
-t(g, "hookFactory");
+t(k, "hookFactory");
 
-export { u as ComponentProviderModule, E as ProvideModule, r as REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, g as hookFactory, P as provideModuleToComponent, s as useComponentModule, c as useInject, a as useInjectMany };//# sourceMappingURL=index.js.map
+export { u as ComponentProviderModule, b as ProvideModule, r as REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT, k as hookFactory, z as provideModuleToComponent, s as useComponentModule, m as useInject, a 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/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.arrow-function.tsx","../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        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 { 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    return (forwardedModule ?? originalModule).toNaked()._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 { forwardPropsWithModule, useContextualizedModule } from '../../helpers';\nimport type { IComponentProviderModule, PropsWithModule } 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 * 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} />\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 React 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\n  return (\n    <REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT.Provider value={moduleCtx}>\n      {React.cloneElement(children, forwardPropsWithModule(children, componentProps, moduleCtx))}\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,SAASA,iBAAiB;AAC1B,SAASC,qBAAqB;AAIvB,IAAMC,4CAA4CD,cAAwCD,SAAAA;;;ACLjG,SAASG,kBAAkB;AAMpB,SAASC,qBAAAA;AACd,SAAOC,WAAWC,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,SACEK,gBACAC,gBACAC,6BAIK;AAKA,IAAMC,0BAAN,MAAMA,iCAAgCC,eAAAA;EAZ7C,OAY6CA;;;EACxBC;EAEnBC,YAAYC,SAAgC;AAC1C,UACEC,sBAAsBC,+BAA+B;MACnD,GAAGF;MACHG,cAAcH,QAAQG,gBAAgBC,eAAeC;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,sBAAsBC,+BAA+B;MACnDc,aAAa,KAAKA;MAClBV,YAAYC,OAAO,KAAKD,WAAWE,YAAaS,QAAQ,aAAa,EAAA,CAAA;MACrEd,cAAc,KAAKA,aAAae;MAChCC,gBAAgB,KAAKA;MACrBC,SAAS,KAAKA;MACdC,WAAW,KAAKA;MAChBC,sBAAsBtB,SAASsB;MAC/BC,SAAS;WAAI,KAAKA;;MAClBZ;MACAa,SAAS;WAAI,KAAKA;;IACpB,CAAA,CAAA;AAIFT,iBAAajB,4BAA4B,KAAKA;AAE9C,WAAOiB;EACT;;EAGAU,UAAgB;AACd,SAAKC,SAAQ;EACf;;;;;;;EASUC,yCAAmE;AAC3E,QAAI,KAAK7B,0BAA2B,QAAO;AAE3C,UAAM8B,YAAY,KAAKlB,MAAK,EAAGD,QAAO;AAGtCmB,cAAUtB,aAAaC,OAAO,iBAAiBqB,UAAUtB,WAAWE,WAAW,EAAE;AACjFoB,cAAU9B,4BAA4B;AAEtC,WAAO8B;EACT;AAGF;;;ACrFA,SAASC,eAAe;;;ACAxB,SAASC,WAAWC,QAAQC,gBAAgB;AAKrC,SAASC,cAAcC,QAAkC;AAC9D,QAAMC,cAAcC,OAA6BC,MAAAA;AACjD,QAAMC,eAAeF,OAAO,KAAA;AAC5B,QAAMG,oBAAoBH,OAAO,KAAA;AACjC,QAAM,CAAA,EAAGI,aAAAA,IAAiBC,SAAS,CAAA;AAEnC,MAAIH,aAAaI,QAASH,mBAAkBG,UAAU;AAEtDC,YAAU,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,YAAYC,QAAQ,MAAA;AACxB,YAAQF,mBAAmBD,gBAAgBI,QAAO,EAAGC,uCAAsC;EAC7F,GAAG;IAACL;IAAgBC;GAAgB;AAEpCK,gBAAc,MAAA;AACZ,WAAO,MAAA;AACLJ,gBAAUK,QAAO;IACnB;EACF,CAAA;AAEA,SAAOL;AACT;AAfgBH;;;AELhB,SAASS,kBAAkB;AAKpB,SAASC,uBACdC,WACAC,OACAC,QAAgC;AAEhC,QAAMC,iBAAiB,OAAOH,cAAc,YAAY,UAAUA;AAElE,QAAMI,SAAS;IACb,GAAGH;EACL;AAEA,MAAKE,kBAAkBE,WAAWL,UAAUM,IAAI,KAAMD,WAAWL,SAAAA,GAAY;AAC3EI,WAAO,QAAA,IAAYF;EACrB;AAEA,SAAOE;AACT;AAhBgBL;;;AC0BT,SAASQ,yBAGdC,QAAkCC,WAA4C;AAC9E,SAAQ,CAACC,mBAAAA;AACP,UAAMC,YAAYC,wBAAwBJ,QAAQE,eAAeF,MAAM;AAEvE,WACE,sBAAA,cAACK,0CAA0CC,UAAQ;MAACC,OAAOJ;OACzD,sBAAA,cAACK,mBAAAA;MAAkBR,QAAQG;MAAWD;MAAgCD;;EAG5E;AACF;AAbgBF;AAehB,SAASS,kBAAiD,EACxDR,QACAC,WACAC,eAAc,GAKf;AACC,SAAO,sBAAA,cAAA,MAAA,UAAA,MAAGD,UAAUQ,uBAAuBR,WAAWC,gBAAgBF,MAAAA,CAAAA,CAAAA;AACxE;AAVSQ;;;AC9CT,OAAOE,YAAW;AAkCX,SAASC,cAAc,EAAEC,QAAQC,SAAQ,GAA+B;AAE7E,QAAMC,iBAAkBD,SAASE,SAAS,CAAC;AAC3C,QAAMC,YAAYC,wBAAwBL,QAAQE,eAAeF,MAAM;AAEvE,SACE,gBAAAM,OAAA,cAACC,0CAA0CC,UAAQ;IAACC,OAAOL;KACxDE,gBAAAA,OAAMI,aAAaT,UAAUU,uBAAuBV,UAAUC,gBAAgBE,SAAAA,CAAAA,CAAAA;AAGrF;AAVgBL;;;ACjChB,SAASa,WAAAA,gBAAe;;;ACDxB,SAASC,oCAAoC;AAEtC,IAAMC,4BAAN,MAAMA,mCAAkCC,6BAAAA;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,OAAOC,SAAQ,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":["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","replace","native","dynamicExports","onReady","onDispose","importedProvidersMap","imports","exports","dispose","_dispose","_createContextualizedComponentInstance","ctxModule","useMemo","useEffect","useRef","useState","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContextualizedModule","originalModule","forwardedModule","ctxModule","useMemo","toNaked","_createContextualizedComponentInstance","useEffectOnce","dispose","isFunction","forwardPropsWithModule","component","props","module","isReactElement","result","isFunction","type","provideModuleToComponent","module","component","componentProps","moduleCtx","useContextualizedModule","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","ComponentRenderer","forwardPropsWithModule","React","ProvideModule","module","children","componentProps","props","moduleCtx","useContextualizedModule","React","REACT_X_INJECTION_PROVIDER_MODULE_CONTEXT","Provider","value","cloneElement","forwardPropsWithModule","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/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        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    return (forwardedModule ?? originalModule).toNaked()._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","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","toNaked","_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"]}

package/package.json

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