@adimm/x-injection-reactjs 0.1.0 → 0.1.2

package/README.md

@@ -88,9 +88,16 @@ export const RandomNumberComponentModule = new ComponentProviderModule({
 });
 
 export function RandomNumberComponent(props: RandomNumberComponentProps) {
-  const service = useInject(RandomNumberService);
-
-  return <h1>A random number: {service.generate()}</h1>;
+  return (
+    <ModuleProvider
+      module={RandomNumberComponentModule}
+      render={() => {
+        const service = useInject(RandomNumberService);
+
+        return <h1>A random number: {service.generate()}</h1>;
+      }}
+    />
+  );
 }
 ```
 
@@ -113,13 +120,18 @@ export const RandomNumberComponentModule = new ComponentProviderModule({
 });
 
 export function RandomNumberComponent(props: RandomNumberComponentProps) {
-  // This hook is necessary in order to expose the component instance
-  // context up to the parent component
-  useExposeComponentModuleContext();
-
-  const service = useInject(RandomNumberService);
-
-  return <h1>A random number: {service.generate()}</h1>;
+  <ModuleProvider
+    module={RandomNumberComponentModule}
+    render={() => {
+      // This hook is necessary in order to expose the component instance
+      // context up to the parent component
+      useExposeComponentModuleContext();
+
+      const service = useInject(RandomNumberService);
+
+      return <h1>A random number: {service.generate()}</h1>;
+    }}
+  />;
 }
 
 ////////////////////////////////////////
@@ -139,39 +151,46 @@ export const ParentServiceComponentModule = new ComponentProviderModule({
 });
 
 export function ParentComponent(props: ParentComponentProps) {
-  const service = useInject(ParentService);
-
   return (
-    <>
-      <TapIntoComponent
-        // By using the fluid syntax
-        contextInstance={() => ({
-          // If one of the children did expose the `RandomNumberComponentModule`
-          // module, we'll be able to access its instance.
-          tryGet: RandomNumberComponentModule,
-          thenDo: (ctx) => {
-            const randomNumberService_FromComponentInstance = ctx.get(RandomNumberComponentModule);
-
-            service.injectRandomNumberService(randomNumberService_FromComponentInstance);
-          },
-        })}>
-        <RandomNumberComponent />
-      </TapIntoComponent>
-
-      <TapIntoComponent
-        // By accessing the entire underlying context map which may contain even more
-        // modules exposed by more children down the tree.
-        contextInstance={(ctxMap) => {
-          const ctx = ctxMap.get(RandomNumberComponentModule.toString());
-          if (!ctx) return;
-
-          const randomNumberService_FromComponentInstance = ctx.get(RandomNumberComponentModule);
-
-          service.injectRandomNumberService(randomNumberService_FromComponentInstance);
-        }}>
-        <RandomNumberComponent />
-      </TapIntoComponent>
-    </>
+    <ModuleProvider
+      module={ParentServiceComponentModule}
+      render={() => {
+        const service = useInject(ParentService);
+
+        return (
+          <>
+            <TapIntoComponent
+              // By using the fluid syntax
+              contextInstance={() => ({
+                // If one of the children did expose the `RandomNumberComponentModule`
+                // module, we'll be able to access its instance.
+                tryGet: RandomNumberComponentModule,
+                thenDo: (ctx) => {
+                  const randomNumberService_FromComponentInstance = ctx.get(RandomNumberComponentModule);
+
+                  service.injectRandomNumberService(randomNumberService_FromComponentInstance);
+                },
+              })}>
+              <RandomNumberComponent />
+            </TapIntoComponent>
+
+            <TapIntoComponent
+              // By accessing the entire underlying context map which may contain even more
+              // modules exposed by more children down the tree.
+              contextInstance={(ctxMap) => {
+                const ctx = ctxMap.get(RandomNumberComponentModule.toString());
+                if (!ctx) return;
+
+                const randomNumberService_FromComponentInstance = ctx.get(RandomNumberComponentModule);
+
+                service.injectRandomNumberService(randomNumberService_FromComponentInstance);
+              }}>
+              <RandomNumberComponent />
+            </TapIntoComponent>
+          </>
+        );
+      }}
+    />
   );
 }
 ```
@@ -183,32 +202,57 @@ or introduce unknown bugs, please use it carefully and with diligence!
 
 ```tsx
 export function ParentComponent(props: ParentComponentProps) {
-  // By using this hook, the component will always re-render whenever
-  // a child using a ProviderModule which is also imported into the parent ProviderModule,
-  // has mounted and rendered!
-  useRerenderOnChildrenModuleContextLoaded();
-
-  // We should use the `useInjectOnRender` instead of the default `useInject`
-  // hook which re-uses the same instance of the injected dependency
-  // between re-renders.
-  //
-  // Note: It may still work with the `useInject` hook too, but it may not be predictable.
-  const service = useInjectOnRender(ParentService);
-
-  // At this point the `service.randomNumberService` instance should be the one
-  // from the `RandomNumberComponent` below.
-  //
-  // Note: Expect during the 1st render cycle to not be the same instance as the one used by the child component!
-  // The `xInjection` container will still supply the correct provider to the
-  // constructor parameter, but it'll be a new transient instance.
-  console.log(service.randomNumberService.generate());
-
-  // As we are now using the `useRerenderOnChildrenModuleContextLoaded` hook
-  // there's no need anymore for the `TapIntoComponent` wrapper.
-  return <RandomNumberComponent />;
+  return (
+    <ModuleProvder
+      module={ParentServiceComponentModule}
+      render={() => {
+        // By using this hook, the component will always re-render whenever
+        // a child using a ProviderModule which is also imported into the parent ProviderModule,
+        // has mounted and rendered!
+        useRerenderOnChildrenModuleContextLoaded();
+
+        // We should use the `useInjectOnRender` instead of the default `useInject`
+        // hook which re-uses the same instance of the injected dependency
+        // between re-renders.
+        //
+        // Note: It may still work with the `useInject` hook too, but it may not be predictable.
+        const service = useInjectOnRender(ParentService);
+
+        // At this point the `service.randomNumberService` instance should be the one
+        // from the `RandomNumberComponent` below.
+        //
+        // Note: Expect during the 1st render cycle to not be the same instance as the one used by the child component!
+        // The `xInjection` container will still supply the correct provider to the
+        // constructor parameter, but it'll be a new transient instance.
+        console.log(service.randomNumberService.generate());
+
+        // As we are now using the `useRerenderOnChildrenModuleContextLoaded` hook
+        // there's no need anymore for the `TapIntoComponent` wrapper.
+        return <RandomNumberComponent />;
+      }}
+    />
+  );
+}
+```
+
+The `ModuleProvider` component also accepts the `children` prop, this means you can also use it like this:
+
+```tsx
+export function Component() {
+  return <h1>Hello World!</h1>;
+}
+
+function MyApp() {
+  return (
+    <ModuleProvider module={ComponentModule}>
+      <Component />
+    </ModuleProvider>
+  );
 }
 ```
 
+> **Note:** You don't have to wrap your entire application with a `ModuleProvider` which provides the `AppModule`, the global container is already available to use and all your `ComponentProviderModule` know ouf-of-the-box how to access it when you provide them with providers registered into the `AppModule`.
+
 ## Documentation
 
 Comprehensive, auto-generated documentation is available at:

package/dist/index.cjs

@@ -1,30 +1,29 @@
 "use strict";
 
-var e, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, o = Object.getOwnPropertyNames, r = Object.prototype.hasOwnProperty, i = (e, n) => t(e, "name", {
+var e, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, o = Object.prototype.hasOwnProperty, i = (e, n) => t(e, "name", {
     value: n,
     configurable: !0
 }), u = {};
 
 ((e, n) => {
-    for (var o in n) t(e, o, {
-        get: n[o],
+    for (var r in n) t(e, r, {
+        get: n[r],
         enumerable: !0
     });
 })(u, {
-    ComponentProviderModule: () => S,
-    ModuleProvider: () => M,
-    REACT_X_INJECTION_CONTEXT: () => m,
-    REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: () => f,
-    REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE: () => O,
+    ComponentProviderModule: () => q,
+    ModuleProvider: () => P,
+    REACT_X_INJECTION_CONTEXT: () => a,
+    REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: () => d,
     TapIntoComponent: () => b,
     useExposeComponentModuleContext: () => h,
-    useInject: () => E,
-    useInjectMany: () => N,
-    useInjectManyOnRender: () => R,
-    useInjectOnRender: () => v,
+    useInject: () => v,
+    useInjectMany: () => R,
+    useInjectManyOnRender: () => _,
+    useInjectOnRender: () => M,
     useRerenderOnChildrenModuleContextLoaded: () => y
 }), module.exports = (e = u, ((e, i, u, s) => {
-    if (i && "object" == typeof i || "function" == typeof i) for (let c of o(i)) r.call(e, c) || c === u || t(e, c, {
+    if (i && "object" == typeof i || "function" == typeof i) for (let c of r(i)) o.call(e, c) || c === u || t(e, c, {
         get: () => i[c],
         enumerable: !(s = n(i, c)) || s.enumerable
     });
@@ -33,101 +32,73 @@ var e, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, o = Objec
     value: !0
 }), e));
 
-var s = require("react");
+var s = require("@adimm/x-injection"), c = require("react"), a = (0, c.createContext)(s.AppModule), d = (0, 
+c.createContext)(new Map), l = require("react");
 
-function c(e) {
-    const t = (0, s.useRef)(null);
+function p(e) {
+    const t = (0, l.useRef)(null);
     return null === t.current && (t.current = {
         value: e()
     }), t.current?.value;
 }
 
-i(c, "useOnce");
+i(p, "useOnce");
 
-var a = require("react");
+var m = require("react");
 
-function d(e) {
-    const t = (0, a.useRef)(void 0), n = (0, a.useRef)(!1), o = (0, a.useRef)(!1), [, r] = (0, 
-    a.useState)(0);
-    n.current && (o.current = !0), (0, a.useEffect)((() => (n.current || (t.current = e(), 
-    n.current = !0), r((e => e + 1)), () => {
-        o.current && t.current?.();
+function C(e) {
+    const t = (0, m.useRef)(void 0), n = (0, m.useRef)(!1), r = (0, m.useRef)(!1), [, o] = (0, 
+    m.useState)(0);
+    n.current && (r.current = !0), (0, m.useEffect)((() => (n.current || (t.current = e(), 
+    n.current = !0), o((e => e + 1)), () => {
+        r.current && t.current?.();
     })), []);
 }
 
-i(d, "useEffectOnce");
+i(C, "useEffectOnce");
 
-var l = require("react"), p = require("@adimm/x-injection"), C = require("react"), m = (0, 
-C.createContext)(p.AppModule), f = (0, C.createContext)(new Map), O = (0, C.createContext)({
-    r: 0
-}), x = require("react");
+var f = require("react");
 
-function M({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: o}) {
-    const r = t.toNaked().isAppModule, i = {
-        ctx: (0, x.useMemo)((() => r ? t : t.toNaked()._convertToContextualizedComponentInstance()), [ e, t, n, o ])
-    };
-    return React.createElement(m.Provider, {
-        value: i
-    }, React.createElement(O.Provider, {
-        value: {
-            r: 0
-        }
-    }, React.createElement(_, {
-        children: e,
-        module: i,
-        tryReInitModuleOnMount: n,
-        disposeModuleOnUnmount: o
-    })));
+function O() {
+    const [, e] = (0, f.useState)(0);
+    return () => e((e => e + 1));
 }
 
-function _({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: o = !1}) {
-    const r = (0, x.useContext)(f), i = (0, x.useContext)(O);
-    return d((() => {
-        const e = t.ctx.toNaked();
-        if (r) {
-            const e = t.ctx.toNaked().imports.map((e => r.get(e.toString())?.toString() === e.toString() ? r.get(e.toString()) : e));
-            e.length > 0 && (t.ctx.toNaked()._lazyInit({
-                ...t.ctx.toNaked()._initialOptions,
-                imports: e
-            }), i.r++);
-        }
-        return e.isDisposed && n && e._lazyInit(n), () => {
-            o && !e.isDisposed && e._dispose();
-        };
-    })), e;
-}
+i(O, "useRerender");
 
-function v(e, t) {
-    return (0, l.useContext)(m).ctx.get(e, t?.isOptional);
+var x = require("react");
+
+function M(e, t) {
+    return (0, x.useContext)(a).ctx.get(e, t?.isOptional);
 }
 
-function E(e, t) {
-    return c((() => v(e, t)));
+function v(e, t) {
+    return p((() => M(e, t)));
 }
 
-i(M, "ModuleProvider"), i(_, "XInjectionChildrenRenderer"), i(v, "useInjectOnRender"), 
-i(E, "useInject");
+i(M, "useInjectOnRender"), i(v, "useInject");
 
 var I = require("react");
 
-function R({deps: e}) {
-    return (0, I.useContext)(m).ctx.getMany(...e);
+function _({deps: e}) {
+    return (0, I.useContext)(a).ctx.getMany(...e);
 }
 
-function N({deps: e, options: t}) {
-    return c((() => R({
+function R({deps: e, options: t}) {
+    return p((() => _({
         options: t,
         deps: e
     })));
 }
 
-i(R, "useInjectManyOnRender"), i(N, "useInjectMany");
+i(_, "useInjectManyOnRender"), i(R, "useInjectMany");
 
-var g = require("react");
+var E = require("react");
 
 function h() {
-    const e = (0, g.useContext)(m);
-    (0, g.useContext)(f).set(e.ctx.toString(), e.ctx);
+    const e = (0, E.useContext)(a);
+    if (e.ctx.toNaked().isAppModule) return;
+    (0, E.useContext)(d).set(e.ctx.toString(), e.ctx);
 }
 
 i(h, "useExposeComponentModuleContext");
@@ -135,24 +106,58 @@ i(h, "useExposeComponentModuleContext");
 var j = require("react");
 
 function y() {
-    const e = (0, j.useContext)(O), [, t] = (0, j.useState)(0);
+    const e = (0, j.useContext)(a), t = (0, j.useContext)(d), n = O();
     (0, j.useEffect)((() => {
-        t((e => e + 1));
-    }), [ e.r ]);
+        const r = e.ctx.toNaked(), o = r.imports.map((e => {
+            const n = e.toString();
+            return t.get(n)?.toString() === n ? t.get(n) : e;
+        }));
+        o.length > 0 && (r._lazyInit({
+            ...r._initialOptions,
+            imports: o
+        }), n());
+    }), [ e, t ]);
 }
 
 i(y, "useRerenderOnChildrenModuleContextLoaded");
 
-var P = require("@adimm/x-injection"), S = class e extends P.ProviderModule {
+var g = require("react");
+
+function P({children: e, render: t, module: n, tryReInitModuleOnMount: r, disposeModuleOnUnmount: o}) {
+    const i = n.toNaked().isAppModule, u = (0, g.useCallback)((() => t?.()), []), s = {
+        ctx: i ? n : n.toNaked()._convertToContextualizedComponentInstance()
+    };
+    return React.createElement(a.Provider, {
+        value: s
+    }, React.createElement(N, {
+        children: e ?? React.createElement(u, null),
+        module: s,
+        tryReInitModuleOnMount: r,
+        disposeModuleOnUnmount: o
+    }));
+}
+
+function N({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: r = !1}) {
+    return C((() => {
+        const e = t.ctx.toNaked();
+        return e.isDisposed && n && e._lazyInit(n), () => {
+            r && !e.isDisposed && e._dispose();
+        };
+    })), e;
+}
+
+i(P, "ModuleProvider"), i(N, "XInjectionChildrenRenderer");
+
+var S = require("@adimm/x-injection"), q = class e extends S.ProviderModule {
     static {
         i(this, "ComponentProviderModule");
     }
     _initializedFromComponent;
     _initialOptions;
     constructor(e) {
-        super(P.ProviderModuleHelpers.buildInternalConstructorParams({
+        super(S.ProviderModuleHelpers.buildInternalConstructorParams({
             ...e,
-            defaultScope: e.defaultScope ?? P.InjectionScope.Transient,
+            defaultScope: e.defaultScope ?? S.InjectionScope.Request,
             identifier: Symbol(`Component${e.identifier.description}`)
         })), this._initializedFromComponent = !1, this._initialOptions = e;
     }
@@ -164,8 +169,8 @@ var P = require("@adimm/x-injection"), S = class e extends P.ProviderModule {
     }
     _convertToContextualizedComponentInstance() {
         if (this.isAppModule || this.isDisposed) return this;
-        const t = this._getProviders().map((e => (0, P.isClassOrFunction)(e) ? (0, P.isClass)(e) ? {
-            scope: P.InjectionScope.Singleton,
+        const t = this._getProviders().map((e => (0, S.isClassOrFunction)(e) ? (0, S.isClass)(e) ? {
+            scope: S.InjectionScope.Singleton,
             provide: e,
             useClass: e
         } : {
@@ -173,7 +178,7 @@ var P = require("@adimm/x-injection"), S = class e extends P.ProviderModule {
             useValue: e
         } : {
             ...e,
-            scope: P.InjectionScope.Singleton
+            scope: S.InjectionScope.Singleton
         })), n = new e({
             ...this._initialOptions,
             providers: t
@@ -184,21 +189,21 @@ var P = require("@adimm/x-injection"), S = class e extends P.ProviderModule {
 
 function b({children: e, contextInstance: t}) {
     const n = (0, T.useMemo)((() => new Map), []);
-    return React.createElement(f.Provider, {
+    return React.createElement(d.Provider, {
         value: n
-    }, React.createElement(q, {
+    }, React.createElement(k, {
         contextInstance: t
     }), e);
 }
 
-function q({contextInstance: e}) {
-    const t = (0, T.useContext)(f);
+function k({contextInstance: e}) {
+    const t = (0, T.useContext)(d);
     return (0, T.useEffect)((() => {
         const n = e?.(t);
         if (!n) return;
-        const o = t.get(n.tryGet.toString());
-        o && n.thenDo(o);
+        const r = t.get(n.tryGet.toString());
+        r && n.thenDo(r);
     }), [ t ]), null;
 }
 
-i(b, "TapIntoComponent"), i(q, "CtxExposer");//# sourceMappingURL=index.cjs.map
+i(b, "TapIntoComponent"), i(k, "CtxExposer");//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/helpers/hooks/use-once.ts","../src/helpers/hooks/use-effect-once.ts","../src/core/hooks/use-inject-on-render.ts","../src/core/providers/module-provider/react-context.ts","../src/core/providers/module-provider/module.provider.tsx","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many-on-render.ts","../src/core/hooks/use-inject-many.ts","../src/core/hooks/use-expose-component-module-context.ts","../src/core/hooks/use-rerender-on-children-module-context-loaded.ts","../src/core/component-provider-module.ts","../src/core/utils/tap-into-component-context/tap-into-component-context.tsx"],"sourcesContent":["export * from './core';\nexport type * from './types';\n","import { useRef } from 'react';\n\nexport function useOnce<T>(fn: () => T): T {\n  const ref = useRef<OnceValue<T> | null>(null);\n\n  if (ref.current === null) {\n    ref.current = { value: fn() };\n  }\n\n  return ref.current?.value;\n}\n\ntype OnceValue<T> = { value: T };\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 type { ProviderToken } from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../providers';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected on each re-render process._\n * _If you need to inject the dependency only once, you must use the `useInject` hook._\n * _It basically acts like a `Transient` scope, ensuring that a new dependency is injected on each re-render._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInjectOnRender<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = UseInjectSharedOptions & {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../../types';\n\n/**\n * The `React.Context` value to be provided to a `React.Provider`.\n *\n * Its default value is a reference to the {@link AppModule}.\n */\nexport const REACT_X_INJECTION_CONTEXT = createContext<{ ctx: IComponentProviderModule }>(AppModule as any);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT = createContext<Map<string, IComponentProviderModule>>(\n  new Map()\n);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE = createContext<{ r: number }>({ r: 0 });\n","import { useContext, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { useEffectOnce } from '../../../helpers';\nimport type { IComponentProviderModule, IComponentProviderModuleNaked } from '../../../types';\nimport type { ModuleProviderProps } from './models';\nimport {\n  REACT_X_INJECTION_CONTEXT,\n  REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT,\n  REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE,\n} from './react-context';\n\nexport function ModuleProvider({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount,\n}: ModuleProviderProps) {\n  const isAppModule = module.toNaked().isAppModule;\n\n  const moduleCtxReference = {\n    ctx: useMemo(() => {\n      return isAppModule ? module : module.toNaked()._convertToContextualizedComponentInstance();\n    }, [children, module, tryReInitModuleOnMount, disposeModuleOnUnmount]),\n  };\n\n  return (\n    <REACT_X_INJECTION_CONTEXT.Provider value={moduleCtxReference}>\n      <REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE.Provider value={{ r: 0 }}>\n        <XInjectionChildrenRenderer\n          children={children}\n          module={moduleCtxReference}\n          tryReInitModuleOnMount={tryReInitModuleOnMount}\n          disposeModuleOnUnmount={disposeModuleOnUnmount}\n        />\n      </REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE.Provider>\n    </REACT_X_INJECTION_CONTEXT.Provider>\n  );\n}\n\nfunction XInjectionChildrenRenderer({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount = false,\n}: Except<ModuleProviderProps, 'module'> & { module: { ctx: IComponentProviderModule } }) {\n  const componentModuleInstance = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n  const rerenderParentCtx = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE);\n\n  // We use the `useEffectOnce` custom hook in order\n  // to make sure that if the developer is providing the\n  // `tryReInitModuleOnMount` and/or `disposeModuleOnUnmount` options\n  // we do not early dispose the module when React double re-renders the\n  // component while StrictMode is enabled.\n  // This hook guarantees that the same behavior is expected with or without StrictMode.\n  //\n  // https://react.dev/reference/react/StrictMode\n  useEffectOnce(() => {\n    // ON MOUNT\n\n    const moduleNaked = module.ctx.toNaked();\n\n    if (componentModuleInstance) {\n      const contextualizedImportedModules = module.ctx.toNaked().imports.map((importedModule) => {\n        const shouldReplaceImportedModuleWithContextualized =\n          componentModuleInstance.get(importedModule.toString())?.toString() === importedModule.toString();\n\n        /* istanbul ignore next */\n        if (!shouldReplaceImportedModuleWithContextualized)\n          return importedModule as unknown as IComponentProviderModuleNaked;\n\n        return componentModuleInstance.get(importedModule.toString()) as IComponentProviderModuleNaked;\n      });\n\n      if (contextualizedImportedModules.length > 0) {\n        module.ctx.toNaked()._lazyInit({\n          ...module.ctx.toNaked()._initialOptions,\n          imports: contextualizedImportedModules,\n        });\n\n        // This will force the parent to re-render when using the `useRerenderOnChildrenModuleContextLoaded` hook.\n        rerenderParentCtx.r++;\n      }\n    }\n\n    /* istanbul ignore next */\n    if (moduleNaked.isDisposed && tryReInitModuleOnMount) {\n      /* istanbul ignore next */\n      moduleNaked._lazyInit(tryReInitModuleOnMount);\n    }\n\n    return () => {\n      // ON UNMOUNT\n\n      if (!disposeModuleOnUnmount || moduleNaked.isDisposed) return;\n\n      moduleNaked._dispose();\n    };\n  });\n\n  return children;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport { useInjectOnRender, type UseInjectOptions } from './use-inject-on-render';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected only once after the first component mount process._\n * _If you need to re-inject the dependency on each re-render, you must use the `useInjectOnRender` hook._\n * _It basically acts like a `Request` scope, ensuring that even a `Transient` dependency does not mutate during re-renders._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  return useOnce(() => useInjectOnRender(provider, options));\n}\n","import type {\n  ProviderModuleGetManyParam,\n  ProviderModuleGetManySignature,\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  ProviderToken,\n} from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../providers';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected on each re-render process._\n * _If you need to inject the dependencies only once, you must use the `useInjectMany` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectManyOnRender<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>({\n  deps,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.getMany(...deps);\n}\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport type { UseInjectSharedOptions } from '../../types';\nimport { useInjectManyOnRender } from './use-inject-many-on-render';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected only once after the first component mount process._\n * _If you need to re-inject the dependencies on each re-render, you must use the `useInjectManyOnRender` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\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,\n  options,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  return useOnce(() => useInjectManyOnRender({ options, deps }));\n}\n","import { useContext } from 'react';\n\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../providers';\n\nexport function useExposeComponentModuleContext(): void {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  const exposed = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  exposed.set(componentModule.ctx.toString(), componentModule.ctx);\n}\n","import { useContext, useEffect, useState } from 'react';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE } from '../providers';\n\n/**\n * This is an **experimental** hook which can be used to make sure that a component will re-render when a children\n * exposes its internal context module.\n *\n * It works best with the `useInjectOnRender` hook, as it'll re-resolve all the required dependencies\n * of the injected ProviderToken.\n *\n * **Use it carefully as it may lead to unnecessary re-render cycles or it may even not work as expected!**\n * **It's safer to use the `TapIntoComponent` wrapper component with the `contextInstance` to manually inject the**\n * **contextualized dependencies of the children into a parent component service!**\n *\n * @experimental\n */\nexport function useRerenderOnChildrenModuleContextLoaded(): void {\n  const rerenderParentCtx = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE);\n  const [, setRerender] = useState(0);\n\n  useEffect(() => {\n    setRerender((x) => x + 1);\n  }, [rerenderParentCtx.r]);\n}\n","import {\n  InjectionScope,\n  isClass,\n  isClassOrFunction,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type DependencyProvider,\n  type IProviderModuleNaked,\n  type ProviderClassToken,\n  type ProviderModuleOptions,\n  type ProviderValueToken,\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  protected readonly _initialOptions: IComponentProviderModuleNaked['_initialOptions'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        // By default components should have all their providers\n        // defined as transient because a component may have more than one instance of itself.\n        defaultScope: options.defaultScope ?? InjectionScope.Transient,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n    this._initialOptions = options;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._convertToContextualizedComponentInstance}.\n   */\n  /* istanbul ignore next */\n  protected _convertToContextualizedComponentInstance(): IComponentProviderModule {\n    if (this.isAppModule || this.isDisposed) return this;\n\n    const contextualizedProviders = this._getProviders().map((provider) => {\n      if (!isClassOrFunction(provider)) {\n        return {\n          ...provider,\n          scope: InjectionScope.Singleton,\n        } as DependencyProvider;\n      }\n\n      if (isClass(provider)) {\n        return {\n          scope: InjectionScope.Singleton,\n          provide: provider,\n          useClass: provider,\n        } as ProviderClassToken<any>;\n      }\n\n      return {\n        provide: provider,\n        useValue: provider,\n      } as ProviderValueToken<any>;\n    });\n\n    const componentModule = new ComponentProviderModule({\n      ...this._initialOptions,\n      providers: contextualizedProviders,\n    });\n\n    //@ts-expect-error Read-only property.\n    componentModule._initializedFromComponent = true;\n\n    return componentModule;\n  }\n}\n","import { useContext, useEffect, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../../providers';\nimport type { TapIntoComponentContextProps } from './interfaces';\n\n/**\n * This component is the standard way to \"tap into\" an instance of the component\n * in order to get access to its scoped module container and its _(exposed)_ dependencies _instances_.\n *\n * @param contextInstance See {@link TapIntoComponentContextProps.contextInstance}.\n * @param exposed See {@link TapIntoComponentContextProps.exposed}.\n */\nexport function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps) {\n  const moduleContextMap = useMemo(() => new Map(), []);\n\n  return (\n    <REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider value={moduleContextMap}>\n      <CtxExposer contextInstance={contextInstance} />\n      {children}\n    </REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider>\n  );\n}\n\nfunction CtxExposer({ contextInstance }: Except<TapIntoComponentContextProps, 'children'>) {\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  useEffect(() => {\n    const fluidSyntax = contextInstance?.(ctxMap);\n    if (!fluidSyntax) return;\n\n    const moduleCtx = ctxMap.get(fluidSyntax.tryGet.toString());\n    /* istanbul ignore next */\n    if (!moduleCtx) return;\n\n    fluidSyntax.thenDo(moduleCtx);\n  }, [ctxMap]);\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;ACAA,mBAAuB;AAEhB,SAASA,QAAWC,IAAW;AACpC,QAAMC,UAAMC,qBAA4B,IAAA;AAExC,MAAID,IAAIE,YAAY,MAAM;AACxBF,QAAIE,UAAU;MAAEC,OAAOJ,GAAAA;IAAK;EAC9B;AAEA,SAAOC,IAAIE,SAASC;AACtB;AARgBL;;;ACFhB,IAAAM,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;;;ACJhB,IAAAY,gBAA2B;;;ACD3B,yBAA0B;AAC1B,IAAAC,gBAA8B;AASvB,IAAMC,gCAA4BC,6BAAiDC,4BAAAA;AAEnF,IAAMC,yDAAqDF,6BAChE,oBAAIG,IAAAA,CAAAA;AAGC,IAAMC,iEAA6DJ,6BAA6B;EAAEK,GAAG;AAAE,CAAA;;;AChB9G,IAAAC,gBAAoC;AAY7B,SAASC,eAAe,EAC7BC,UACAC,QAAAA,SACAC,wBACAC,uBAAsB,GACF;AACpB,QAAMC,cAAcH,QAAOI,QAAO,EAAGD;AAErC,QAAME,qBAAqB;IACzBC,SAAKC,uBAAQ,MAAA;AACX,aAAOJ,cAAcH,UAASA,QAAOI,QAAO,EAAGI,0CAAyC;IAC1F,GAAG;MAACT;MAAUC;MAAQC;MAAwBC;KAAuB;EACvE;AAEA,SACE,sBAAA,cAACO,0BAA0BC,UAAQ;IAACC,OAAON;KACzC,sBAAA,cAACO,2DAA2DF,UAAQ;IAACC,OAAO;MAAEE,GAAG;IAAE;KACjF,sBAAA,cAACC,4BAAAA;IACCf;IACAC,QAAQK;IACRJ;IACAC;;AAKV;AA1BgBJ;AA4BhB,SAASgB,2BAA2B,EAClCf,UACAC,QAAAA,SACAC,wBACAC,yBAAyB,MAAK,GACwD;AACtF,QAAMa,8BAA0BC,0BAAWC,kDAAAA;AAC3C,QAAMC,wBAAoBF,0BAAWJ,0DAAAA;AAUrCO,gBAAc,MAAA;AAGZ,UAAMC,cAAcpB,QAAOM,IAAIF,QAAO;AAEtC,QAAIW,yBAAyB;AAC3B,YAAMM,gCAAgCrB,QAAOM,IAAIF,QAAO,EAAGkB,QAAQC,IAAI,CAACC,mBAAAA;AACtE,cAAMC,gDACJV,wBAAwBW,IAAIF,eAAeG,SAAQ,CAAA,GAAKA,SAAAA,MAAeH,eAAeG,SAAQ;AAGhG,YAAI,CAACF,8CACH,QAAOD;AAET,eAAOT,wBAAwBW,IAAIF,eAAeG,SAAQ,CAAA;MAC5D,CAAA;AAEA,UAAIN,8BAA8BO,SAAS,GAAG;AAC5C5B,QAAAA,QAAOM,IAAIF,QAAO,EAAGyB,UAAU;UAC7B,GAAG7B,QAAOM,IAAIF,QAAO,EAAG0B;UACxBR,SAASD;QACX,CAAA;AAGAH,0BAAkBL;MACpB;IACF;AAGA,QAAIO,YAAYW,cAAc9B,wBAAwB;AAEpDmB,kBAAYS,UAAU5B,sBAAAA;IACxB;AAEA,WAAO,MAAA;AAGL,UAAI,CAACC,0BAA0BkB,YAAYW,WAAY;AAEvDX,kBAAYY,SAAQ;IACtB;EACF,CAAA;AAEA,SAAOjC;AACT;AA7DSe;;;AFvBF,SAASmB,kBAAqBC,UAA4BC,SAA0B;AACzF,QAAMC,sBAAkBC,0BAAWC,yBAAAA;AAEnC,SAAOF,gBAAgBG,IAAIC,IAAIN,UAAUC,SAASM,UAAAA;AACpD;AAJgBR;;;AGDT,SAASS,UAAaC,UAA4BC,SAA0B;AACjF,SAAOC,QAAQ,MAAMC,kBAAkBH,UAAUC,OAAAA,CAAAA;AACnD;AAFgBF;;;ACVhB,IAAAK,gBAA2B;AAepB,SAASC,sBAAqF,EACnGC,KAAI,GAIL;AACC,QAAMC,sBAAkBC,0BAAWC,yBAAAA;AAEnC,SAAOF,gBAAgBG,IAAIC,QAAO,GAAIL,IAAAA;AACxC;AATgBD;;;ACLT,SAASO,cAA6E,EAC3FC,MACAC,QAAO,GAIR;AACC,SAAOC,QAAQ,MAAMC,sBAAsB;IAAEF;IAASD;EAAK,CAAA,CAAA;AAC7D;AARgBD;;;AChBhB,IAAAK,gBAA2B;AAIpB,SAASC,kCAAAA;AACd,QAAMC,sBAAkBC,0BAAWC,yBAAAA;AACnC,QAAMC,cAAUF,0BAAWG,kDAAAA;AAE3BD,UAAQE,IAAIL,gBAAgBM,IAAIC,SAAQ,GAAIP,gBAAgBM,GAAG;AACjE;AALgBP;;;ACJhB,IAAAS,gBAAgD;AAiBzC,SAASC,2CAAAA;AACd,QAAMC,wBAAoBC,0BAAWC,0DAAAA;AACrC,QAAM,CAAA,EAAGC,WAAAA,QAAeC,wBAAS,CAAA;AAEjCC,+BAAU,MAAA;AACRF,gBAAY,CAACG,MAAMA,IAAI,CAAA;EACzB,GAAG;IAACN,kBAAkBO;GAAE;AAC1B;AAPgBR;;;ACjBhB,IAAAS,sBAWO;AAKA,IAAMC,0BAAN,MAAMA,iCAAgCC,mCAAAA;EAhB7C,OAgB6CA;;;EACxBC;EACAC;EAEnBC,YAAYC,SAAgC;AAC1C,UACEC,0CAAsBC,+BAA+B;MACnD,GAAGF;;;MAGHG,cAAcH,QAAQG,gBAAgBC,mCAAeC;MACrDC,YAAYC,OAAO,YAAYP,QAAQM,WAAWE,WAAW,EAAE;IACjE,CAAA,CAAA;AAGF,SAAKX,4BAA4B;AACjC,SAAKC,kBAAkBE;EACzB;EAESS,UAAgE;AACvE,WAAO;EACT;;EAGAC,UAAgB;AACd,SAAKC,SAAQ;EACf;;;;;;;EAQUC,4CAAsE;AAC9E,QAAI,KAAKC,eAAe,KAAKC,WAAY,QAAO;AAEhD,UAAMC,0BAA0B,KAAKC,cAAa,EAAGC,IAAI,CAACC,aAAAA;AACxD,UAAI,KAACC,uCAAkBD,QAAAA,GAAW;AAChC,eAAO;UACL,GAAGA;UACHE,OAAOhB,mCAAeiB;QACxB;MACF;AAEA,cAAIC,6BAAQJ,QAAAA,GAAW;AACrB,eAAO;UACLE,OAAOhB,mCAAeiB;UACtBE,SAASL;UACTM,UAAUN;QACZ;MACF;AAEA,aAAO;QACLK,SAASL;QACTO,UAAUP;MACZ;IACF,CAAA;AAEA,UAAMQ,kBAAkB,IAAI/B,yBAAwB;MAClD,GAAG,KAAKG;MACR6B,WAAWZ;IACb,CAAA;AAGAW,oBAAgB7B,4BAA4B;AAE5C,WAAO6B;EACT;AACF;;;ACrFA,IAAAE,gBAA+C;AAaxC,SAASC,iBAAiB,EAAEC,UAAUC,gBAAe,GAAgC;AAC1F,QAAMC,uBAAmBC,uBAAQ,MAAM,oBAAIC,IAAAA,GAAO,CAAA,CAAE;AAEpD,SACE,sBAAA,cAACC,mDAAmDC,UAAQ;IAACC,OAAOL;KAClE,sBAAA,cAACM,YAAAA;IAAWP;MACXD,QAAAA;AAGP;AATgBD;AAWhB,SAASS,WAAW,EAAEP,gBAAe,GAAoD;AACvF,QAAMQ,aAASC,0BAAWL,kDAAAA;AAE1BM,+BAAU,MAAA;AACR,UAAMC,cAAcX,kBAAkBQ,MAAAA;AACtC,QAAI,CAACG,YAAa;AAElB,UAAMC,YAAYJ,OAAOK,IAAIF,YAAYG,OAAOC,SAAQ,CAAA;AAExD,QAAI,CAACH,UAAW;AAEhBD,gBAAYK,OAAOJ,SAAAA;EACrB,GAAG;IAACJ;GAAO;AAEX,SAAO;AACT;AAfSD;","names":["useOnce","fn","ref","useRef","current","value","import_react","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","import_react","import_react","REACT_X_INJECTION_CONTEXT","createContext","AppModule","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","r","import_react","ModuleProvider","children","module","tryReInitModuleOnMount","disposeModuleOnUnmount","isAppModule","toNaked","moduleCtxReference","ctx","useMemo","_convertToContextualizedComponentInstance","REACT_X_INJECTION_CONTEXT","Provider","value","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","r","XInjectionChildrenRenderer","componentModuleInstance","useContext","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","rerenderParentCtx","useEffectOnce","moduleNaked","contextualizedImportedModules","imports","map","importedModule","shouldReplaceImportedModuleWithContextualized","get","toString","length","_lazyInit","_initialOptions","isDisposed","_dispose","useInjectOnRender","provider","options","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","get","isOptional","useInject","provider","options","useOnce","useInjectOnRender","import_react","useInjectManyOnRender","deps","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","getMany","useInjectMany","deps","options","useOnce","useInjectManyOnRender","import_react","useExposeComponentModuleContext","componentModule","useContext","REACT_X_INJECTION_CONTEXT","exposed","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","set","ctx","toString","import_react","useRerenderOnChildrenModuleContextLoaded","rerenderParentCtx","useContext","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","setRerender","useState","useEffect","x","r","import_x_injection","ComponentProviderModule","ProviderModule","_initializedFromComponent","_initialOptions","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Transient","identifier","Symbol","description","toNaked","dispose","_dispose","_convertToContextualizedComponentInstance","isAppModule","isDisposed","contextualizedProviders","_getProviders","map","provider","isClassOrFunction","scope","Singleton","isClass","provide","useClass","useValue","componentModule","providers","import_react","TapIntoComponent","children","contextInstance","moduleContextMap","useMemo","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Provider","value","CtxExposer","ctxMap","useContext","useEffect","fluidSyntax","moduleCtx","get","tryGet","toString","thenDo"]}
+{"version":3,"sources":["../src/index.ts","../src/core/react-context.ts","../src/helpers/hooks/use-once.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/hooks/use-rerender.ts","../src/core/hooks/use-inject-on-render.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many-on-render.ts","../src/core/hooks/use-inject-many.ts","../src/core/hooks/use-expose-component-module-context.ts","../src/core/hooks/use-rerender-on-children-module-context-loaded.ts","../src/core/providers/module-provider/module.provider.tsx","../src/core/component-provider-module.ts","../src/core/utils/tap-into-component-context/tap-into-component-context.tsx"],"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\n/**\n * The `React.Context` value to be provided to a `React.Provider`.\n *\n * Its default value is a reference to the {@link AppModule}.\n */\nexport const REACT_X_INJECTION_CONTEXT = createContext<{ ctx: IComponentProviderModule }>(AppModule as any);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT = createContext<Map<string, IComponentProviderModule>>(\n  new Map()\n);\n","import { useRef } from 'react';\n\nexport function useOnce<T>(fn: () => T): T {\n  const ref = useRef<OnceValue<T> | null>(null);\n\n  if (ref.current === null) {\n    ref.current = { value: fn() };\n  }\n\n  return ref.current?.value;\n}\n\ntype OnceValue<T> = { value: T };\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 { useState } from 'react';\n\nexport function useRerender(): () => void {\n  const [, setRerender] = useState(0);\n\n  return () => setRerender((x) => x + 1);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../react-context';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected on each re-render process._\n * _If you need to inject the dependency only once, you must use the `useInject` hook._\n * _It basically acts like a `Transient` scope, ensuring that a new dependency is injected on each re-render._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInjectOnRender<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = UseInjectSharedOptions & {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport { useInjectOnRender, type UseInjectOptions } from './use-inject-on-render';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected only once after the first component mount process._\n * _If you need to re-inject the dependency on each re-render, you must use the `useInjectOnRender` hook._\n * _It basically acts like a `Request` scope, ensuring that even a `Transient` dependency does not mutate during re-renders._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  return useOnce(() => useInjectOnRender(provider, options));\n}\n","import type {\n  ProviderModuleGetManyParam,\n  ProviderModuleGetManySignature,\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  ProviderToken,\n} from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../react-context';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected on each re-render process._\n * _If you need to inject the dependencies only once, you must use the `useInjectMany` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectManyOnRender<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>({\n  deps,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.getMany(...deps);\n}\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport type { UseInjectSharedOptions } from '../../types';\nimport { useInjectManyOnRender } from './use-inject-many-on-render';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected only once after the first component mount process._\n * _If you need to re-inject the dependencies on each re-render, you must use the `useInjectManyOnRender` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\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,\n  options,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  return useOnce(() => useInjectManyOnRender({ options, deps }));\n}\n","import { useContext } from 'react';\n\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../react-context';\n\nexport function useExposeComponentModuleContext(): void {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  if (componentModule.ctx.toNaked().isAppModule) return;\n\n  const exposed = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  exposed.set(componentModule.ctx.toString(), componentModule.ctx);\n}\n","import { useContext, useEffect } from 'react';\n\nimport { useRerender } from '../../helpers';\nimport type { IComponentProviderModuleNaked } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../react-context';\n\n/**\n * This is an **experimental** hook which can be used to make sure that a component will re-render when a children\n * exposes its internal context module.\n *\n * It works best with the `useInjectOnRender` hook, as it'll re-resolve all the required dependencies\n * of the injected ProviderToken.\n *\n * **Use it carefully as it may lead to unnecessary re-render cycles or it may even not work as expected!**\n * **It's safer to use the `TapIntoComponent` wrapper component with the `contextInstance` to manually inject the**\n * **contextualized dependencies of the children into a parent component service!**\n *\n * @experimental\n */\nexport function useRerenderOnChildrenModuleContextLoaded(): void {\n  const parentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  const rerenderComponent = useRerender();\n\n  useEffect(() => {\n    const parentModuleNaked = parentModule.ctx.toNaked();\n\n    const contextualizedImportedModules = parentModuleNaked.imports.map((importedModule) => {\n      const importedModuleId = importedModule.toString();\n\n      const shouldReplaceImportedModuleWithContextualized =\n        ctxMap.get(importedModuleId)?.toString() === importedModuleId;\n\n      /* istanbul ignore next */\n      if (!shouldReplaceImportedModuleWithContextualized)\n        return importedModule as unknown as IComponentProviderModuleNaked;\n\n      return ctxMap.get(importedModuleId) as IComponentProviderModuleNaked;\n    });\n\n    if (contextualizedImportedModules.length > 0) {\n      parentModuleNaked._lazyInit({\n        ...parentModuleNaked._initialOptions,\n        imports: contextualizedImportedModules,\n      });\n\n      rerenderComponent();\n    }\n  }, [parentModule, ctxMap]);\n}\n","import { useCallback } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { useEffectOnce } from '../../../helpers';\nimport type { IComponentProviderModule } from '../../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../../react-context';\nimport type { ModuleProviderProps } from './models';\n\nexport function ModuleProvider({\n  children,\n  render,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount,\n}: ModuleProviderProps) {\n  const isAppModule = module.toNaked().isAppModule;\n  const Renderer = useCallback(() => render?.(), []);\n\n  const moduleCtxReference = {\n    ctx: isAppModule ? module : module.toNaked()._convertToContextualizedComponentInstance(),\n  };\n\n  return (\n    <REACT_X_INJECTION_CONTEXT.Provider value={moduleCtxReference}>\n      <XInjectionChildrenRenderer\n        children={children ?? <Renderer />}\n        module={moduleCtxReference}\n        tryReInitModuleOnMount={tryReInitModuleOnMount}\n        disposeModuleOnUnmount={disposeModuleOnUnmount}\n      />\n    </REACT_X_INJECTION_CONTEXT.Provider>\n  );\n}\n\nfunction XInjectionChildrenRenderer({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount = false,\n}: Except<ModuleProviderProps, 'module'> & { module: { ctx: IComponentProviderModule } }) {\n  // We use the `useEffectOnce` custom hook in order\n  // to make sure that if the developer is providing the\n  // `tryReInitModuleOnMount` and/or `disposeModuleOnUnmount` options\n  // we do not early dispose the module when React double re-renders the\n  // component while StrictMode is enabled.\n  // This hook guarantees that the same behavior is expected with or without StrictMode.\n  //\n  // https://react.dev/reference/react/StrictMode\n  useEffectOnce(() => {\n    // ON MOUNT\n\n    const moduleNaked = module.ctx.toNaked();\n\n    /* istanbul ignore next */\n    if (moduleNaked.isDisposed && tryReInitModuleOnMount) {\n      /* istanbul ignore next */\n      moduleNaked._lazyInit(tryReInitModuleOnMount);\n    }\n\n    return () => {\n      // ON UNMOUNT\n\n      if (!disposeModuleOnUnmount || moduleNaked.isDisposed) return;\n\n      moduleNaked._dispose();\n    };\n  });\n\n  return children;\n}\n","import {\n  InjectionScope,\n  isClass,\n  isClassOrFunction,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type DependencyProvider,\n  type IProviderModuleNaked,\n  type ProviderClassToken,\n  type ProviderModuleOptions,\n  type ProviderValueToken,\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  protected readonly _initialOptions: IComponentProviderModuleNaked['_initialOptions'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        // By default components should have all their providers\n        // defined as transient because a component may have more than one instance of itself.\n        defaultScope: options.defaultScope ?? InjectionScope.Request,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n    this._initialOptions = options;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._convertToContextualizedComponentInstance}.\n   */\n  /* istanbul ignore next */\n  protected _convertToContextualizedComponentInstance(): IComponentProviderModule {\n    if (this.isAppModule || this.isDisposed) return this;\n\n    const contextualizedProviders = this._getProviders().map((provider) => {\n      if (!isClassOrFunction(provider)) {\n        return {\n          ...provider,\n          scope: InjectionScope.Singleton,\n        } as DependencyProvider;\n      }\n\n      if (isClass(provider)) {\n        return {\n          scope: InjectionScope.Singleton,\n          provide: provider,\n          useClass: provider,\n        } as ProviderClassToken<any>;\n      }\n\n      return {\n        provide: provider,\n        useValue: provider,\n      } as ProviderValueToken<any>;\n    });\n\n    const componentModule = new ComponentProviderModule({\n      ...this._initialOptions,\n      providers: contextualizedProviders,\n    });\n\n    //@ts-expect-error Read-only property.\n    componentModule._initializedFromComponent = true;\n\n    return componentModule;\n  }\n}\n","import { useContext, useEffect, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../../react-context';\nimport type { TapIntoComponentContextProps } from './interfaces';\n\n/**\n * This component is the standard way to \"tap into\" an instance of the component\n * in order to get access to its scoped module container and its _(exposed)_ dependencies _instances_.\n *\n * @param contextInstance See {@link TapIntoComponentContextProps.contextInstance}.\n * @param exposed See {@link TapIntoComponentContextProps.exposed}.\n */\nexport function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps) {\n  const moduleContextMap = useMemo(() => new Map(), []);\n\n  return (\n    <REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider value={moduleContextMap}>\n      <CtxExposer contextInstance={contextInstance} />\n      {children}\n    </REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider>\n  );\n}\n\nfunction CtxExposer({ contextInstance }: Except<TapIntoComponentContextProps, 'children'>) {\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  useEffect(() => {\n    const fluidSyntax = contextInstance?.(ctxMap);\n    if (!fluidSyntax) return;\n\n    const moduleCtx = ctxMap.get(fluidSyntax.tryGet.toString());\n    /* istanbul ignore next */\n    if (!moduleCtx) return;\n\n    fluidSyntax.thenDo(moduleCtx);\n  }, [ctxMap]);\n\n  return null;\n}\n"],"mappings":"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","names":["REACT_X_INJECTION_CONTEXT","createContext","AppModule","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Map","import_react","useOnce","fn","ref","useRef","current","value","import_react","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","import_react","useRerender","setRerender","useState","x","import_react","useInjectOnRender","provider","options","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","get","isOptional","useInject","provider","options","useOnce","useInjectOnRender","import_react","useInjectManyOnRender","deps","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","getMany","useInjectMany","deps","options","useOnce","useInjectManyOnRender","import_react","useExposeComponentModuleContext","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","toNaked","isAppModule","exposed","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","set","toString","import_react","useRerenderOnChildrenModuleContextLoaded","parentModule","useContext","REACT_X_INJECTION_CONTEXT","ctxMap","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","rerenderComponent","useRerender","useEffect","parentModuleNaked","ctx","toNaked","contextualizedImportedModules","imports","map","importedModule","importedModuleId","toString","shouldReplaceImportedModuleWithContextualized","get","length","_lazyInit","_initialOptions","import_react","ModuleProvider","children","render","module","tryReInitModuleOnMount","disposeModuleOnUnmount","isAppModule","toNaked","Renderer","useCallback","moduleCtxReference","ctx","_convertToContextualizedComponentInstance","REACT_X_INJECTION_CONTEXT","Provider","value","XInjectionChildrenRenderer","useEffectOnce","moduleNaked","isDisposed","_lazyInit","_dispose","import_x_injection","ComponentProviderModule","ProviderModule","_initializedFromComponent","_initialOptions","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Request","identifier","Symbol","description","toNaked","dispose","_dispose","_convertToContextualizedComponentInstance","isAppModule","isDisposed","contextualizedProviders","_getProviders","map","provider","isClassOrFunction","scope","Singleton","isClass","provide","useClass","useValue","componentModule","providers","import_react","TapIntoComponent","children","contextInstance","moduleContextMap","useMemo","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Provider","value","CtxExposer","ctxMap","useContext","useEffect","fluidSyntax","moduleCtx","get","tryGet","toString","thenDo"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react from 'react';
+import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface IComponentProviderModuleNaked extends IComponentProviderModule {
@@ -33,6 +33,16 @@ interface IComponentProviderModule extends IProviderModule {
 interface UseInjectSharedOptions {
 }
 
+/**
+ * The `React.Context` value to be provided to a `React.Provider`.
+ *
+ * Its default value is a reference to the {@link AppModule}.
+ */
+declare const REACT_X_INJECTION_CONTEXT: react.Context<{
+    ctx: IComponentProviderModule;
+}>;
+declare const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: react.Context<Map<string, IComponentProviderModule>>;
+
 /**
  * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.
  *
@@ -110,21 +120,9 @@ declare function useExposeComponentModuleContext(): void;
  */
 declare function useRerenderOnChildrenModuleContextLoaded(): void;
 
-/**
- * The `React.Context` value to be provided to a `React.Provider`.
- *
- * Its default value is a reference to the {@link AppModule}.
- */
-declare const REACT_X_INJECTION_CONTEXT: react.Context<{
-    ctx: IComponentProviderModule;
-}>;
-declare const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: react.Context<Map<string, IComponentProviderModule>>;
-declare const REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE: react.Context<{
-    r: number;
-}>;
-
 interface ModuleProviderProps {
-    children: React.ReactNode;
+    children?: React.ReactNode;
+    render?: () => React.ReactNode;
     /** The {@link IComponentProviderModule | ComponentProviderModule} instance which must be accessible by this component. */
     module: IComponentProviderModule;
     /**
@@ -150,7 +148,7 @@ interface ModuleProviderProps {
     disposeModuleOnUnmount?: boolean;
 }
 
-declare function ModuleProvider({ children, module, tryReInitModuleOnMount, disposeModuleOnUnmount, }: ModuleProviderProps): react_jsx_runtime.JSX.Element;
+declare function ModuleProvider({ children, render, module, tryReInitModuleOnMount, disposeModuleOnUnmount, }: ModuleProviderProps): react_jsx_runtime.JSX.Element;
 
 /** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
 declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
@@ -242,4 +240,4 @@ interface WithComponentInstanceCtxFluidSyntax {
  */
 declare function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps): react_jsx_runtime.JSX.Element;
 
-export { ComponentProviderModule, type IComponentProviderModule, type IComponentProviderModuleNaked, ModuleProvider, REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE, TapIntoComponent, type TapIntoComponentContextProps, type UseInjectOptions, type UseInjectSharedOptions, type WithComponentInstanceCtxFluidSyntax, useExposeComponentModuleContext, useInject, useInjectMany, useInjectManyOnRender, useInjectOnRender, useRerenderOnChildrenModuleContextLoaded };
+export { ComponentProviderModule, type IComponentProviderModule, type IComponentProviderModuleNaked, ModuleProvider, REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, TapIntoComponent, type TapIntoComponentContextProps, type UseInjectOptions, type UseInjectSharedOptions, type WithComponentInstanceCtxFluidSyntax, useExposeComponentModuleContext, useInject, useInjectMany, useInjectManyOnRender, useInjectOnRender, useRerenderOnChildrenModuleContextLoaded };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react from 'react';
+import { ProviderModuleOptions, IProviderModule, IProviderModuleNaked, ProviderToken, ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderModule } from '@adimm/x-injection';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface IComponentProviderModuleNaked extends IComponentProviderModule {
@@ -33,6 +33,16 @@ interface IComponentProviderModule extends IProviderModule {
 interface UseInjectSharedOptions {
 }
 
+/**
+ * The `React.Context` value to be provided to a `React.Provider`.
+ *
+ * Its default value is a reference to the {@link AppModule}.
+ */
+declare const REACT_X_INJECTION_CONTEXT: react.Context<{
+    ctx: IComponentProviderModule;
+}>;
+declare const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: react.Context<Map<string, IComponentProviderModule>>;
+
 /**
  * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.
  *
@@ -110,21 +120,9 @@ declare function useExposeComponentModuleContext(): void;
  */
 declare function useRerenderOnChildrenModuleContextLoaded(): void;
 
-/**
- * The `React.Context` value to be provided to a `React.Provider`.
- *
- * Its default value is a reference to the {@link AppModule}.
- */
-declare const REACT_X_INJECTION_CONTEXT: react.Context<{
-    ctx: IComponentProviderModule;
-}>;
-declare const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT: react.Context<Map<string, IComponentProviderModule>>;
-declare const REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE: react.Context<{
-    r: number;
-}>;
-
 interface ModuleProviderProps {
-    children: React.ReactNode;
+    children?: React.ReactNode;
+    render?: () => React.ReactNode;
     /** The {@link IComponentProviderModule | ComponentProviderModule} instance which must be accessible by this component. */
     module: IComponentProviderModule;
     /**
@@ -150,7 +148,7 @@ interface ModuleProviderProps {
     disposeModuleOnUnmount?: boolean;
 }
 
-declare function ModuleProvider({ children, module, tryReInitModuleOnMount, disposeModuleOnUnmount, }: ModuleProviderProps): react_jsx_runtime.JSX.Element;
+declare function ModuleProvider({ children, render, module, tryReInitModuleOnMount, disposeModuleOnUnmount, }: ModuleProviderProps): react_jsx_runtime.JSX.Element;
 
 /** A superset of the {@link ProviderModule} used to integrate within a `React` component. */
 declare class ComponentProviderModule extends ProviderModule implements IComponentProviderModule {
@@ -242,4 +240,4 @@ interface WithComponentInstanceCtxFluidSyntax {
  */
 declare function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps): react_jsx_runtime.JSX.Element;
 
-export { ComponentProviderModule, type IComponentProviderModule, type IComponentProviderModuleNaked, ModuleProvider, REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE, TapIntoComponent, type TapIntoComponentContextProps, type UseInjectOptions, type UseInjectSharedOptions, type WithComponentInstanceCtxFluidSyntax, useExposeComponentModuleContext, useInject, useInjectMany, useInjectManyOnRender, useInjectOnRender, useRerenderOnChildrenModuleContextLoaded };
+export { ComponentProviderModule, type IComponentProviderModule, type IComponentProviderModuleNaked, ModuleProvider, REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, TapIntoComponent, type TapIntoComponentContextProps, type UseInjectOptions, type UseInjectSharedOptions, type WithComponentInstanceCtxFluidSyntax, useExposeComponentModuleContext, useInject, useInjectMany, useInjectManyOnRender, useInjectOnRender, useRerenderOnChildrenModuleContextLoaded };

package/dist/index.js

@@ -3,134 +3,138 @@ var e = Object.defineProperty, t = (t, n) => e(t, "name", {
     configurable: !0
 });
 
-import { useRef as n } from "react";
+import { AppModule as n } from "@adimm/x-injection";
 
-function o(e) {
-    const t = n(null);
+import { createContext as o } from "react";
+
+var r = o(n), i = o(new Map);
+
+import { useRef as s } from "react";
+
+function c(e) {
+    const t = s(null);
     return null === t.current && (t.current = {
         value: e()
     }), t.current?.value;
 }
 
-t(o, "useOnce");
+t(c, "useOnce");
 
-import { useEffect as r, useRef as i, useState as s } from "react";
+import { useEffect as u, useRef as a, useState as d } from "react";
 
-function c(e) {
-    const t = i(void 0), n = i(!1), o = i(!1), [, c] = s(0);
-    n.current && (o.current = !0), r((() => (n.current || (t.current = e(), n.current = !0), 
-    c((e => e + 1)), () => {
+function p(e) {
+    const t = a(void 0), n = a(!1), o = a(!1), [, r] = d(0);
+    n.current && (o.current = !0), u((() => (n.current || (t.current = e(), n.current = !0), 
+    r((e => e + 1)), () => {
         o.current && t.current?.();
     })), []);
 }
 
-t(c, "useEffectOnce");
-
-import { useContext as u } from "react";
-
-import { AppModule as a } from "@adimm/x-injection";
-
-import { createContext as d } from "react";
+t(p, "useEffectOnce");
 
-var p = d(a), l = d(new Map), m = d({
-    r: 0
-});
-
-import { useContext as f, useMemo as x } from "react";
+import { useState as l } from "react";
 
-function C({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: o}) {
-    const r = t.toNaked().isAppModule, i = {
-        ctx: x((() => r ? t : t.toNaked()._convertToContextualizedComponentInstance()), [ e, t, n, o ])
-    };
-    return React.createElement(p.Provider, {
-        value: i
-    }, React.createElement(m.Provider, {
-        value: {
-            r: 0
-        }
-    }, React.createElement(v, {
-        children: e,
-        module: i,
-        tryReInitModuleOnMount: n,
-        disposeModuleOnUnmount: o
-    })));
+function m() {
+    const [, e] = l(0);
+    return () => e((e => e + 1));
 }
 
-function v({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: o = !1}) {
-    const r = f(l), i = f(m);
-    return c((() => {
-        const e = t.ctx.toNaked();
-        if (r) {
-            const e = t.ctx.toNaked().imports.map((e => r.get(e.toString())?.toString() === e.toString() ? r.get(e.toString()) : e));
-            e.length > 0 && (t.ctx.toNaked()._lazyInit({
-                ...t.ctx.toNaked()._initialOptions,
-                imports: e
-            }), i.r++);
-        }
-        return e.isDisposed && n && e._lazyInit(n), () => {
-            o && !e.isDisposed && e._dispose();
-        };
-    })), e;
-}
+t(m, "useRerender");
 
-function M(e, t) {
-    return u(p).ctx.get(e, t?.isOptional);
+import { useContext as f } from "react";
+
+function x(e, t) {
+    return f(r).ctx.get(e, t?.isOptional);
 }
 
-function h(e, t) {
-    return o((() => M(e, t)));
+function C(e, t) {
+    return c((() => x(e, t)));
 }
 
-t(C, "ModuleProvider"), t(v, "XInjectionChildrenRenderer"), t(M, "useInjectOnRender"), 
-t(h, "useInject");
+t(x, "useInjectOnRender"), t(C, "useInject");
 
-import { useContext as I } from "react";
+import { useContext as M } from "react";
 
-function O({deps: e}) {
-    return I(p).ctx.getMany(...e);
+function v({deps: e}) {
+    return M(r).ctx.getMany(...e);
 }
 
-function g({deps: e, options: t}) {
-    return o((() => O({
+function h({deps: e, options: t}) {
+    return c((() => v({
         options: t,
         deps: e
     })));
 }
 
-t(O, "useInjectManyOnRender"), t(g, "useInjectMany");
+t(v, "useInjectManyOnRender"), t(h, "useInjectMany");
 
-import { useContext as _ } from "react";
+import { useContext as I } from "react";
+
+function O() {
+    const e = I(r);
+    if (e.ctx.toNaked().isAppModule) return;
+    I(i).set(e.ctx.toString(), e.ctx);
+}
 
-function R() {
-    const e = _(p);
-    _(l).set(e.ctx.toString(), e.ctx);
+t(O, "useExposeComponentModuleContext");
+
+import { useContext as R, useEffect as g } from "react";
+
+function _() {
+    const e = R(r), t = R(i), n = m();
+    g((() => {
+        const o = e.ctx.toNaked(), r = o.imports.map((e => {
+            const n = e.toString();
+            return t.get(n)?.toString() === n ? t.get(n) : e;
+        }));
+        r.length > 0 && (o._lazyInit({
+            ...o._initialOptions,
+            imports: r
+        }), n());
+    }), [ e, t ]);
 }
 
-t(R, "useExposeComponentModuleContext");
+t(_, "useRerenderOnChildrenModuleContextLoaded");
 
-import { useContext as S, useEffect as y, useState as E } from "react";
+import { useCallback as y } from "react";
 
-function j() {
-    const e = S(m), [, t] = E(0);
-    y((() => {
-        t((e => e + 1));
-    }), [ e.r ]);
+function E({children: e, render: t, module: n, tryReInitModuleOnMount: o, disposeModuleOnUnmount: i}) {
+    const s = n.toNaked().isAppModule, c = y((() => t?.()), []), u = {
+        ctx: s ? n : n.toNaked()._convertToContextualizedComponentInstance()
+    };
+    return React.createElement(r.Provider, {
+        value: u
+    }, React.createElement(S, {
+        children: e ?? React.createElement(c, null),
+        module: u,
+        tryReInitModuleOnMount: o,
+        disposeModuleOnUnmount: i
+    }));
+}
+
+function S({children: e, module: t, tryReInitModuleOnMount: n, disposeModuleOnUnmount: o = !1}) {
+    return p((() => {
+        const e = t.ctx.toNaked();
+        return e.isDisposed && n && e._lazyInit(n), () => {
+            o && !e.isDisposed && e._dispose();
+        };
+    })), e;
 }
 
-t(j, "useRerenderOnChildrenModuleContextLoaded");
+t(E, "ModuleProvider"), t(S, "XInjectionChildrenRenderer");
 
-import { InjectionScope as P, isClass as k, isClassOrFunction as z, ProviderModule as N, ProviderModuleHelpers as b } from "@adimm/x-injection";
+import { InjectionScope as j, isClass as z, isClassOrFunction as P, ProviderModule as k, ProviderModuleHelpers as N } from "@adimm/x-injection";
 
-var D = class e extends N {
+var b = class e extends k {
     static {
         t(this, "ComponentProviderModule");
     }
     _initializedFromComponent;
     _initialOptions;
     constructor(e) {
-        super(b.buildInternalConstructorParams({
+        super(N.buildInternalConstructorParams({
             ...e,
-            defaultScope: e.defaultScope ?? P.Transient,
+            defaultScope: e.defaultScope ?? j.Request,
             identifier: Symbol(`Component${e.identifier.description}`)
         })), this._initializedFromComponent = !1, this._initialOptions = e;
     }
@@ -142,8 +146,8 @@ var D = class e extends N {
     }
     _convertToContextualizedComponentInstance() {
         if (this.isAppModule || this.isDisposed) return this;
-        const t = this._getProviders().map((e => z(e) ? k(e) ? {
-            scope: P.Singleton,
+        const t = this._getProviders().map((e => P(e) ? z(e) ? {
+            scope: j.Singleton,
             provide: e,
             useClass: e
         } : {
@@ -151,7 +155,7 @@ var D = class e extends N {
             useValue: e
         } : {
             ...e,
-            scope: P.Singleton
+            scope: j.Singleton
         })), n = new e({
             ...this._initialOptions,
             providers: t
@@ -160,19 +164,19 @@ var D = class e extends N {
     }
 };
 
-import { useContext as T, useEffect as w, useMemo as F } from "react";
+import { useContext as D, useEffect as w, useMemo as A } from "react";
 
-function U({children: e, contextInstance: t}) {
-    const n = F((() => new Map), []);
-    return React.createElement(l.Provider, {
+function F({children: e, contextInstance: t}) {
+    const n = A((() => new Map), []);
+    return React.createElement(i.Provider, {
         value: n
-    }, React.createElement(A, {
+    }, React.createElement(T, {
         contextInstance: t
     }), e);
 }
 
-function A({contextInstance: e}) {
-    const t = T(l);
+function T({contextInstance: e}) {
+    const t = D(i);
     return w((() => {
         const n = e?.(t);
         if (!n) return;
@@ -181,6 +185,6 @@ function A({contextInstance: e}) {
     }), [ t ]), null;
 }
 
-t(U, "TapIntoComponent"), t(A, "CtxExposer");
+t(F, "TapIntoComponent"), t(T, "CtxExposer");
 
-export { D as ComponentProviderModule, C as ModuleProvider, p as REACT_X_INJECTION_CONTEXT, l as REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, m as REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE, U as TapIntoComponent, R as useExposeComponentModuleContext, h as useInject, g as useInjectMany, O as useInjectManyOnRender, M as useInjectOnRender, j as useRerenderOnChildrenModuleContextLoaded };//# sourceMappingURL=index.js.map
+export { b as ComponentProviderModule, E as ModuleProvider, r as REACT_X_INJECTION_CONTEXT, i as REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT, F as TapIntoComponent, O as useExposeComponentModuleContext, C as useInject, h as useInjectMany, v as useInjectManyOnRender, x as useInjectOnRender, _ as useRerenderOnChildrenModuleContextLoaded };//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/helpers/hooks/use-once.ts","../src/helpers/hooks/use-effect-once.ts","../src/core/hooks/use-inject-on-render.ts","../src/core/providers/module-provider/react-context.ts","../src/core/providers/module-provider/module.provider.tsx","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many-on-render.ts","../src/core/hooks/use-inject-many.ts","../src/core/hooks/use-expose-component-module-context.ts","../src/core/hooks/use-rerender-on-children-module-context-loaded.ts","../src/core/component-provider-module.ts","../src/core/utils/tap-into-component-context/tap-into-component-context.tsx"],"sourcesContent":["import { useRef } from 'react';\n\nexport function useOnce<T>(fn: () => T): T {\n  const ref = useRef<OnceValue<T> | null>(null);\n\n  if (ref.current === null) {\n    ref.current = { value: fn() };\n  }\n\n  return ref.current?.value;\n}\n\ntype OnceValue<T> = { value: T };\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 type { ProviderToken } from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../providers';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected on each re-render process._\n * _If you need to inject the dependency only once, you must use the `useInject` hook._\n * _It basically acts like a `Transient` scope, ensuring that a new dependency is injected on each re-render._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInjectOnRender<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = UseInjectSharedOptions & {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../../../types';\n\n/**\n * The `React.Context` value to be provided to a `React.Provider`.\n *\n * Its default value is a reference to the {@link AppModule}.\n */\nexport const REACT_X_INJECTION_CONTEXT = createContext<{ ctx: IComponentProviderModule }>(AppModule as any);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT = createContext<Map<string, IComponentProviderModule>>(\n  new Map()\n);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE = createContext<{ r: number }>({ r: 0 });\n","import { useContext, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { useEffectOnce } from '../../../helpers';\nimport type { IComponentProviderModule, IComponentProviderModuleNaked } from '../../../types';\nimport type { ModuleProviderProps } from './models';\nimport {\n  REACT_X_INJECTION_CONTEXT,\n  REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT,\n  REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE,\n} from './react-context';\n\nexport function ModuleProvider({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount,\n}: ModuleProviderProps) {\n  const isAppModule = module.toNaked().isAppModule;\n\n  const moduleCtxReference = {\n    ctx: useMemo(() => {\n      return isAppModule ? module : module.toNaked()._convertToContextualizedComponentInstance();\n    }, [children, module, tryReInitModuleOnMount, disposeModuleOnUnmount]),\n  };\n\n  return (\n    <REACT_X_INJECTION_CONTEXT.Provider value={moduleCtxReference}>\n      <REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE.Provider value={{ r: 0 }}>\n        <XInjectionChildrenRenderer\n          children={children}\n          module={moduleCtxReference}\n          tryReInitModuleOnMount={tryReInitModuleOnMount}\n          disposeModuleOnUnmount={disposeModuleOnUnmount}\n        />\n      </REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE.Provider>\n    </REACT_X_INJECTION_CONTEXT.Provider>\n  );\n}\n\nfunction XInjectionChildrenRenderer({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount = false,\n}: Except<ModuleProviderProps, 'module'> & { module: { ctx: IComponentProviderModule } }) {\n  const componentModuleInstance = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n  const rerenderParentCtx = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE);\n\n  // We use the `useEffectOnce` custom hook in order\n  // to make sure that if the developer is providing the\n  // `tryReInitModuleOnMount` and/or `disposeModuleOnUnmount` options\n  // we do not early dispose the module when React double re-renders the\n  // component while StrictMode is enabled.\n  // This hook guarantees that the same behavior is expected with or without StrictMode.\n  //\n  // https://react.dev/reference/react/StrictMode\n  useEffectOnce(() => {\n    // ON MOUNT\n\n    const moduleNaked = module.ctx.toNaked();\n\n    if (componentModuleInstance) {\n      const contextualizedImportedModules = module.ctx.toNaked().imports.map((importedModule) => {\n        const shouldReplaceImportedModuleWithContextualized =\n          componentModuleInstance.get(importedModule.toString())?.toString() === importedModule.toString();\n\n        /* istanbul ignore next */\n        if (!shouldReplaceImportedModuleWithContextualized)\n          return importedModule as unknown as IComponentProviderModuleNaked;\n\n        return componentModuleInstance.get(importedModule.toString()) as IComponentProviderModuleNaked;\n      });\n\n      if (contextualizedImportedModules.length > 0) {\n        module.ctx.toNaked()._lazyInit({\n          ...module.ctx.toNaked()._initialOptions,\n          imports: contextualizedImportedModules,\n        });\n\n        // This will force the parent to re-render when using the `useRerenderOnChildrenModuleContextLoaded` hook.\n        rerenderParentCtx.r++;\n      }\n    }\n\n    /* istanbul ignore next */\n    if (moduleNaked.isDisposed && tryReInitModuleOnMount) {\n      /* istanbul ignore next */\n      moduleNaked._lazyInit(tryReInitModuleOnMount);\n    }\n\n    return () => {\n      // ON UNMOUNT\n\n      if (!disposeModuleOnUnmount || moduleNaked.isDisposed) return;\n\n      moduleNaked._dispose();\n    };\n  });\n\n  return children;\n}\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport { useInjectOnRender, type UseInjectOptions } from './use-inject-on-render';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected only once after the first component mount process._\n * _If you need to re-inject the dependency on each re-render, you must use the `useInjectOnRender` hook._\n * _It basically acts like a `Request` scope, ensuring that even a `Transient` dependency does not mutate during re-renders._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  return useOnce(() => useInjectOnRender(provider, options));\n}\n","import type {\n  ProviderModuleGetManyParam,\n  ProviderModuleGetManySignature,\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  ProviderToken,\n} from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../providers';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected on each re-render process._\n * _If you need to inject the dependencies only once, you must use the `useInjectMany` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectManyOnRender<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>({\n  deps,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.getMany(...deps);\n}\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport type { UseInjectSharedOptions } from '../../types';\nimport { useInjectManyOnRender } from './use-inject-many-on-render';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected only once after the first component mount process._\n * _If you need to re-inject the dependencies on each re-render, you must use the `useInjectManyOnRender` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\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,\n  options,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  return useOnce(() => useInjectManyOnRender({ options, deps }));\n}\n","import { useContext } from 'react';\n\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../providers';\n\nexport function useExposeComponentModuleContext(): void {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  const exposed = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  exposed.set(componentModule.ctx.toString(), componentModule.ctx);\n}\n","import { useContext, useEffect, useState } from 'react';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE } from '../providers';\n\n/**\n * This is an **experimental** hook which can be used to make sure that a component will re-render when a children\n * exposes its internal context module.\n *\n * It works best with the `useInjectOnRender` hook, as it'll re-resolve all the required dependencies\n * of the injected ProviderToken.\n *\n * **Use it carefully as it may lead to unnecessary re-render cycles or it may even not work as expected!**\n * **It's safer to use the `TapIntoComponent` wrapper component with the `contextInstance` to manually inject the**\n * **contextualized dependencies of the children into a parent component service!**\n *\n * @experimental\n */\nexport function useRerenderOnChildrenModuleContextLoaded(): void {\n  const rerenderParentCtx = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE);\n  const [, setRerender] = useState(0);\n\n  useEffect(() => {\n    setRerender((x) => x + 1);\n  }, [rerenderParentCtx.r]);\n}\n","import {\n  InjectionScope,\n  isClass,\n  isClassOrFunction,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type DependencyProvider,\n  type IProviderModuleNaked,\n  type ProviderClassToken,\n  type ProviderModuleOptions,\n  type ProviderValueToken,\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  protected readonly _initialOptions: IComponentProviderModuleNaked['_initialOptions'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        // By default components should have all their providers\n        // defined as transient because a component may have more than one instance of itself.\n        defaultScope: options.defaultScope ?? InjectionScope.Transient,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n    this._initialOptions = options;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._convertToContextualizedComponentInstance}.\n   */\n  /* istanbul ignore next */\n  protected _convertToContextualizedComponentInstance(): IComponentProviderModule {\n    if (this.isAppModule || this.isDisposed) return this;\n\n    const contextualizedProviders = this._getProviders().map((provider) => {\n      if (!isClassOrFunction(provider)) {\n        return {\n          ...provider,\n          scope: InjectionScope.Singleton,\n        } as DependencyProvider;\n      }\n\n      if (isClass(provider)) {\n        return {\n          scope: InjectionScope.Singleton,\n          provide: provider,\n          useClass: provider,\n        } as ProviderClassToken<any>;\n      }\n\n      return {\n        provide: provider,\n        useValue: provider,\n      } as ProviderValueToken<any>;\n    });\n\n    const componentModule = new ComponentProviderModule({\n      ...this._initialOptions,\n      providers: contextualizedProviders,\n    });\n\n    //@ts-expect-error Read-only property.\n    componentModule._initializedFromComponent = true;\n\n    return componentModule;\n  }\n}\n","import { useContext, useEffect, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../../providers';\nimport type { TapIntoComponentContextProps } from './interfaces';\n\n/**\n * This component is the standard way to \"tap into\" an instance of the component\n * in order to get access to its scoped module container and its _(exposed)_ dependencies _instances_.\n *\n * @param contextInstance See {@link TapIntoComponentContextProps.contextInstance}.\n * @param exposed See {@link TapIntoComponentContextProps.exposed}.\n */\nexport function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps) {\n  const moduleContextMap = useMemo(() => new Map(), []);\n\n  return (\n    <REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider value={moduleContextMap}>\n      <CtxExposer contextInstance={contextInstance} />\n      {children}\n    </REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider>\n  );\n}\n\nfunction CtxExposer({ contextInstance }: Except<TapIntoComponentContextProps, 'children'>) {\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  useEffect(() => {\n    const fluidSyntax = contextInstance?.(ctxMap);\n    if (!fluidSyntax) return;\n\n    const moduleCtx = ctxMap.get(fluidSyntax.tryGet.toString());\n    /* istanbul ignore next */\n    if (!moduleCtx) return;\n\n    fluidSyntax.thenDo(moduleCtx);\n  }, [ctxMap]);\n\n  return null;\n}\n"],"mappings":"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","names":["useRef","useOnce","fn","ref","useRef","current","value","useEffect","useRef","useState","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useContext","AppModule","createContext","REACT_X_INJECTION_CONTEXT","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","r","useContext","useMemo","ModuleProvider","children","module","tryReInitModuleOnMount","disposeModuleOnUnmount","isAppModule","toNaked","moduleCtxReference","ctx","useMemo","_convertToContextualizedComponentInstance","REACT_X_INJECTION_CONTEXT","Provider","value","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","r","XInjectionChildrenRenderer","componentModuleInstance","useContext","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","rerenderParentCtx","useEffectOnce","moduleNaked","contextualizedImportedModules","imports","map","importedModule","shouldReplaceImportedModuleWithContextualized","get","toString","length","_lazyInit","_initialOptions","isDisposed","_dispose","useInjectOnRender","provider","options","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","get","isOptional","useInject","provider","options","useOnce","useInjectOnRender","useContext","useInjectManyOnRender","deps","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","getMany","useInjectMany","deps","options","useOnce","useInjectManyOnRender","useContext","useExposeComponentModuleContext","componentModule","useContext","REACT_X_INJECTION_CONTEXT","exposed","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","set","ctx","toString","useContext","useEffect","useState","useRerenderOnChildrenModuleContextLoaded","rerenderParentCtx","useContext","REACT_X_INJECTION_EXPOSED_COMPONENT_RERENDER_ON_CTX_CHANGE","setRerender","useState","useEffect","x","r","InjectionScope","isClass","isClassOrFunction","ProviderModule","ProviderModuleHelpers","ComponentProviderModule","ProviderModule","_initializedFromComponent","_initialOptions","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Transient","identifier","Symbol","description","toNaked","dispose","_dispose","_convertToContextualizedComponentInstance","isAppModule","isDisposed","contextualizedProviders","_getProviders","map","provider","isClassOrFunction","scope","Singleton","isClass","provide","useClass","useValue","componentModule","providers","useContext","useEffect","useMemo","TapIntoComponent","children","contextInstance","moduleContextMap","useMemo","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Provider","value","CtxExposer","ctxMap","useContext","useEffect","fluidSyntax","moduleCtx","get","tryGet","toString","thenDo"]}
+{"version":3,"sources":["../src/core/react-context.ts","../src/helpers/hooks/use-once.ts","../src/helpers/hooks/use-effect-once.ts","../src/helpers/hooks/use-rerender.ts","../src/core/hooks/use-inject-on-render.ts","../src/core/hooks/use-inject.ts","../src/core/hooks/use-inject-many-on-render.ts","../src/core/hooks/use-inject-many.ts","../src/core/hooks/use-expose-component-module-context.ts","../src/core/hooks/use-rerender-on-children-module-context-loaded.ts","../src/core/providers/module-provider/module.provider.tsx","../src/core/component-provider-module.ts","../src/core/utils/tap-into-component-context/tap-into-component-context.tsx"],"sourcesContent":["import { AppModule } from '@adimm/x-injection';\nimport { createContext } from 'react';\n\nimport type { IComponentProviderModule } from '../types';\n\n/**\n * The `React.Context` value to be provided to a `React.Provider`.\n *\n * Its default value is a reference to the {@link AppModule}.\n */\nexport const REACT_X_INJECTION_CONTEXT = createContext<{ ctx: IComponentProviderModule }>(AppModule as any);\n\nexport const REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT = createContext<Map<string, IComponentProviderModule>>(\n  new Map()\n);\n","import { useRef } from 'react';\n\nexport function useOnce<T>(fn: () => T): T {\n  const ref = useRef<OnceValue<T> | null>(null);\n\n  if (ref.current === null) {\n    ref.current = { value: fn() };\n  }\n\n  return ref.current?.value;\n}\n\ntype OnceValue<T> = { value: T };\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 { useState } from 'react';\n\nexport function useRerender(): () => void {\n  const [, setRerender] = useState(0);\n\n  return () => setRerender((x) => x + 1);\n}\n","import type { ProviderToken } from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../react-context';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected on each re-render process._\n * _If you need to inject the dependency only once, you must use the `useInject` hook._\n * _It basically acts like a `Transient` scope, ensuring that a new dependency is injected on each re-render._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInjectOnRender<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.get(provider, options?.isOptional);\n}\n\nexport type UseInjectOptions = UseInjectSharedOptions & {\n  /** When set to `false` _(default)_ an exception will be thrown when the `providerOrIdentifier` isn't bound. */\n  isOptional?: boolean;\n};\n","import type { ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport { useInjectOnRender, type UseInjectOptions } from './use-inject-on-render';\n\n/**\n * React `hook` which can be used inside a component to inject the required {@link provider | dependency}.\n *\n * **Note:** _By using this hook, the dependency will be injected only once after the first component mount process._\n * _If you need to re-inject the dependency on each re-render, you must use the `useInjectOnRender` hook._\n * _It basically acts like a `Request` scope, ensuring that even a `Transient` dependency does not mutate during re-renders._\n *\n * @param provider The {@link ProviderToken}.\n * @param options See {@link UseInjectSharedOptions}.\n * @returns Either the {@link T | dependency} or `undefined` if {@link isOptional} is set to `true`.\n */\nexport function useInject<T>(provider: ProviderToken<T>, options?: UseInjectOptions): T {\n  return useOnce(() => useInjectOnRender(provider, options));\n}\n","import type {\n  ProviderModuleGetManyParam,\n  ProviderModuleGetManySignature,\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  ProviderToken,\n} from '@adimm/x-injection';\nimport { useContext } from 'react';\n\nimport type { UseInjectSharedOptions } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../react-context';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected on each re-render process._\n * _If you need to inject the dependencies only once, you must use the `useInjectMany` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\n * @param deps Either one or more {@link ProviderToken}.\n * @returns Tuple containing the {@link D | dependencies}.\n */\nexport function useInjectManyOnRender<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>({\n  deps,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n\n  return componentModule.ctx.getMany(...deps);\n}\n","import type { ProviderModuleGetManyParam, ProviderModuleGetManySignature, ProviderToken } from '@adimm/x-injection';\n\nimport { useOnce } from '../../helpers';\nimport type { UseInjectSharedOptions } from '../../types';\nimport { useInjectManyOnRender } from './use-inject-many-on-render';\n\n/**\n * Can be used to retrieve many resolved `dependencies` from the module container at once.\n *\n * **Note:** _By using this hook, the dependencies will be injected only once after the first component mount process._\n * _If you need to re-inject the dependencies on each re-render, you must use the `useInjectManyOnRender` hook._\n *\n * @param options See {@link UseInjectSharedOptions}.\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,\n  options,\n}: {\n  deps: [...(D | unknown[])];\n  options?: UseInjectSharedOptions;\n}): ProviderModuleGetManySignature<D> {\n  return useOnce(() => useInjectManyOnRender({ options, deps }));\n}\n","import { useContext } from 'react';\n\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../react-context';\n\nexport function useExposeComponentModuleContext(): void {\n  const componentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  if (componentModule.ctx.toNaked().isAppModule) return;\n\n  const exposed = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  exposed.set(componentModule.ctx.toString(), componentModule.ctx);\n}\n","import { useContext, useEffect } from 'react';\n\nimport { useRerender } from '../../helpers';\nimport type { IComponentProviderModuleNaked } from '../../types';\nimport { REACT_X_INJECTION_CONTEXT, REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../react-context';\n\n/**\n * This is an **experimental** hook which can be used to make sure that a component will re-render when a children\n * exposes its internal context module.\n *\n * It works best with the `useInjectOnRender` hook, as it'll re-resolve all the required dependencies\n * of the injected ProviderToken.\n *\n * **Use it carefully as it may lead to unnecessary re-render cycles or it may even not work as expected!**\n * **It's safer to use the `TapIntoComponent` wrapper component with the `contextInstance` to manually inject the**\n * **contextualized dependencies of the children into a parent component service!**\n *\n * @experimental\n */\nexport function useRerenderOnChildrenModuleContextLoaded(): void {\n  const parentModule = useContext(REACT_X_INJECTION_CONTEXT);\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  const rerenderComponent = useRerender();\n\n  useEffect(() => {\n    const parentModuleNaked = parentModule.ctx.toNaked();\n\n    const contextualizedImportedModules = parentModuleNaked.imports.map((importedModule) => {\n      const importedModuleId = importedModule.toString();\n\n      const shouldReplaceImportedModuleWithContextualized =\n        ctxMap.get(importedModuleId)?.toString() === importedModuleId;\n\n      /* istanbul ignore next */\n      if (!shouldReplaceImportedModuleWithContextualized)\n        return importedModule as unknown as IComponentProviderModuleNaked;\n\n      return ctxMap.get(importedModuleId) as IComponentProviderModuleNaked;\n    });\n\n    if (contextualizedImportedModules.length > 0) {\n      parentModuleNaked._lazyInit({\n        ...parentModuleNaked._initialOptions,\n        imports: contextualizedImportedModules,\n      });\n\n      rerenderComponent();\n    }\n  }, [parentModule, ctxMap]);\n}\n","import { useCallback } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { useEffectOnce } from '../../../helpers';\nimport type { IComponentProviderModule } from '../../../types';\nimport { REACT_X_INJECTION_CONTEXT } from '../../react-context';\nimport type { ModuleProviderProps } from './models';\n\nexport function ModuleProvider({\n  children,\n  render,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount,\n}: ModuleProviderProps) {\n  const isAppModule = module.toNaked().isAppModule;\n  const Renderer = useCallback(() => render?.(), []);\n\n  const moduleCtxReference = {\n    ctx: isAppModule ? module : module.toNaked()._convertToContextualizedComponentInstance(),\n  };\n\n  return (\n    <REACT_X_INJECTION_CONTEXT.Provider value={moduleCtxReference}>\n      <XInjectionChildrenRenderer\n        children={children ?? <Renderer />}\n        module={moduleCtxReference}\n        tryReInitModuleOnMount={tryReInitModuleOnMount}\n        disposeModuleOnUnmount={disposeModuleOnUnmount}\n      />\n    </REACT_X_INJECTION_CONTEXT.Provider>\n  );\n}\n\nfunction XInjectionChildrenRenderer({\n  children,\n  module,\n  tryReInitModuleOnMount,\n  disposeModuleOnUnmount = false,\n}: Except<ModuleProviderProps, 'module'> & { module: { ctx: IComponentProviderModule } }) {\n  // We use the `useEffectOnce` custom hook in order\n  // to make sure that if the developer is providing the\n  // `tryReInitModuleOnMount` and/or `disposeModuleOnUnmount` options\n  // we do not early dispose the module when React double re-renders the\n  // component while StrictMode is enabled.\n  // This hook guarantees that the same behavior is expected with or without StrictMode.\n  //\n  // https://react.dev/reference/react/StrictMode\n  useEffectOnce(() => {\n    // ON MOUNT\n\n    const moduleNaked = module.ctx.toNaked();\n\n    /* istanbul ignore next */\n    if (moduleNaked.isDisposed && tryReInitModuleOnMount) {\n      /* istanbul ignore next */\n      moduleNaked._lazyInit(tryReInitModuleOnMount);\n    }\n\n    return () => {\n      // ON UNMOUNT\n\n      if (!disposeModuleOnUnmount || moduleNaked.isDisposed) return;\n\n      moduleNaked._dispose();\n    };\n  });\n\n  return children;\n}\n","import {\n  InjectionScope,\n  isClass,\n  isClassOrFunction,\n  ProviderModule,\n  ProviderModuleHelpers,\n  type DependencyProvider,\n  type IProviderModuleNaked,\n  type ProviderClassToken,\n  type ProviderModuleOptions,\n  type ProviderValueToken,\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  protected readonly _initialOptions: IComponentProviderModuleNaked['_initialOptions'];\n\n  constructor(options: ProviderModuleOptions) {\n    super(\n      ProviderModuleHelpers.buildInternalConstructorParams({\n        ...options,\n        // By default components should have all their providers\n        // defined as transient because a component may have more than one instance of itself.\n        defaultScope: options.defaultScope ?? InjectionScope.Request,\n        identifier: Symbol(`Component${options.identifier.description}`),\n      })\n    );\n\n    this._initializedFromComponent = false;\n    this._initialOptions = options;\n  }\n\n  override toNaked(): IComponentProviderModuleNaked & IProviderModuleNaked {\n    return this as any;\n  }\n\n  /* istanbul ignore next */\n  dispose(): void {\n    this._dispose();\n  }\n\n  /**\n   * **Publicly visible when the instance is casted to {@link IComponentProviderModuleNaked}.**\n   *\n   * See {@link IComponentProviderModuleNaked._convertToContextualizedComponentInstance}.\n   */\n  /* istanbul ignore next */\n  protected _convertToContextualizedComponentInstance(): IComponentProviderModule {\n    if (this.isAppModule || this.isDisposed) return this;\n\n    const contextualizedProviders = this._getProviders().map((provider) => {\n      if (!isClassOrFunction(provider)) {\n        return {\n          ...provider,\n          scope: InjectionScope.Singleton,\n        } as DependencyProvider;\n      }\n\n      if (isClass(provider)) {\n        return {\n          scope: InjectionScope.Singleton,\n          provide: provider,\n          useClass: provider,\n        } as ProviderClassToken<any>;\n      }\n\n      return {\n        provide: provider,\n        useValue: provider,\n      } as ProviderValueToken<any>;\n    });\n\n    const componentModule = new ComponentProviderModule({\n      ...this._initialOptions,\n      providers: contextualizedProviders,\n    });\n\n    //@ts-expect-error Read-only property.\n    componentModule._initializedFromComponent = true;\n\n    return componentModule;\n  }\n}\n","import { useContext, useEffect, useMemo } from 'react';\nimport type { Except } from 'type-fest';\n\nimport { REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT } from '../../react-context';\nimport type { TapIntoComponentContextProps } from './interfaces';\n\n/**\n * This component is the standard way to \"tap into\" an instance of the component\n * in order to get access to its scoped module container and its _(exposed)_ dependencies _instances_.\n *\n * @param contextInstance See {@link TapIntoComponentContextProps.contextInstance}.\n * @param exposed See {@link TapIntoComponentContextProps.exposed}.\n */\nexport function TapIntoComponent({ children, contextInstance }: TapIntoComponentContextProps) {\n  const moduleContextMap = useMemo(() => new Map(), []);\n\n  return (\n    <REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider value={moduleContextMap}>\n      <CtxExposer contextInstance={contextInstance} />\n      {children}\n    </REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT.Provider>\n  );\n}\n\nfunction CtxExposer({ contextInstance }: Except<TapIntoComponentContextProps, 'children'>) {\n  const ctxMap = useContext(REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT);\n\n  useEffect(() => {\n    const fluidSyntax = contextInstance?.(ctxMap);\n    if (!fluidSyntax) return;\n\n    const moduleCtx = ctxMap.get(fluidSyntax.tryGet.toString());\n    /* istanbul ignore next */\n    if (!moduleCtx) return;\n\n    fluidSyntax.thenDo(moduleCtx);\n  }, [ctxMap]);\n\n  return null;\n}\n"],"mappings":"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","names":["AppModule","createContext","REACT_X_INJECTION_CONTEXT","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Map","useRef","useOnce","fn","ref","useRef","current","value","useEffect","useRef","useState","useEffectOnce","effect","destroyFunc","useRef","undefined","effectCalled","renderAfterCalled","forceRerender","useState","current","useEffect","x","useState","useRerender","setRerender","useState","x","useContext","useInjectOnRender","provider","options","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","get","isOptional","useInject","provider","options","useOnce","useInjectOnRender","useContext","useInjectManyOnRender","deps","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","getMany","useInjectMany","deps","options","useOnce","useInjectManyOnRender","useContext","useExposeComponentModuleContext","componentModule","useContext","REACT_X_INJECTION_CONTEXT","ctx","toNaked","isAppModule","exposed","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","set","toString","useContext","useEffect","useRerenderOnChildrenModuleContextLoaded","parentModule","useContext","REACT_X_INJECTION_CONTEXT","ctxMap","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","rerenderComponent","useRerender","useEffect","parentModuleNaked","ctx","toNaked","contextualizedImportedModules","imports","map","importedModule","importedModuleId","toString","shouldReplaceImportedModuleWithContextualized","get","length","_lazyInit","_initialOptions","useCallback","ModuleProvider","children","render","module","tryReInitModuleOnMount","disposeModuleOnUnmount","isAppModule","toNaked","Renderer","useCallback","moduleCtxReference","ctx","_convertToContextualizedComponentInstance","REACT_X_INJECTION_CONTEXT","Provider","value","XInjectionChildrenRenderer","useEffectOnce","moduleNaked","isDisposed","_lazyInit","_dispose","InjectionScope","isClass","isClassOrFunction","ProviderModule","ProviderModuleHelpers","ComponentProviderModule","ProviderModule","_initializedFromComponent","_initialOptions","constructor","options","ProviderModuleHelpers","buildInternalConstructorParams","defaultScope","InjectionScope","Request","identifier","Symbol","description","toNaked","dispose","_dispose","_convertToContextualizedComponentInstance","isAppModule","isDisposed","contextualizedProviders","_getProviders","map","provider","isClassOrFunction","scope","Singleton","isClass","provide","useClass","useValue","componentModule","providers","useContext","useEffect","useMemo","TapIntoComponent","children","contextInstance","moduleContextMap","useMemo","Map","REACT_X_INJECTION_EXPOSED_COMPONENT_MODULE_CONTEXT","Provider","value","CtxExposer","ctxMap","useContext","useEffect","fluidSyntax","moduleCtx","get","tryGet","toString","thenDo"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adimm/x-injection-reactjs",
   "description": "ReactJS integration of the `xInjection` library.",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "author": "Adi-Marian Mutu",
   "homepage": "https://github.com/AdiMarianMutu/x-injection-reactjs#readme",
   "bugs": "https://github.com/AdiMarianMutu/x-injection-reactjs/issues",