react-obsidian 2.30.0 → 2.31.0-alpha.1

package/dist/src/decorators/LifecycleBound.d.ts

@@ -1,5 +1,6 @@
 type Options = {
     scope?: 'component' | 'feature' | (string & {});
+    inactiveBehavior?: 'unmount' | 'retain';
 };
 export declare function lifecycleBound(options?: Options): (constructor: any) => any;
 export {};

package/dist/src/decorators/LifecycleBound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LifecycleBound.d.ts","sourceRoot":"","sources":["../../../src/decorators/LifecycleBound.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IACb,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;CACjD,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,iBACzB,GAAG,SAKzB"}
+{"version":3,"file":"LifecycleBound.d.ts","sourceRoot":"","sources":["../../../src/decorators/LifecycleBound.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IACb,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAChD,gBAAgB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACzC,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,iBACzB,GAAG,SAMzB"}

package/dist/src/decorators/LifecycleBound.js

@@ -4,9 +4,10 @@ exports.lifecycleBound = lifecycleBound;
 const reflect_1 = require("../utils/reflect");
 function lifecycleBound(options) {
     return (constructor) => {
-        var _a;
+        var _a, _b;
         reflect_1.Reflect.defineMetadata('isLifecycleBound', true, constructor);
         reflect_1.Reflect.defineMetadata('lifecycleScope', (_a = options === null || options === void 0 ? void 0 : options.scope) !== null && _a !== void 0 ? _a : 'feature', constructor);
+        reflect_1.Reflect.defineMetadata('inactiveBehavior', (_b = options === null || options === void 0 ? void 0 : options.inactiveBehavior) !== null && _b !== void 0 ? _b : 'unmount', constructor);
         return constructor;
     };
 }

package/dist/src/decorators/LifecycleBound.js.map

@@ -1 +1 @@
-{"version":3,"file":"LifecycleBound.js","sourceRoot":"","sources":["../../../src/decorators/LifecycleBound.ts"],"names":[],"mappings":";;AAMA,wCAMC;AAZD,8CAAyC;AAMzC,SAAgB,cAAc,CAAC,OAAiB;IAC9C,OAAO,CAAC,WAAgB,EAAE,EAAE;;QAC1B,iBAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC9D,iBAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,SAAS,EAAE,WAAW,CAAC,CAAC;QACnF,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"LifecycleBound.js","sourceRoot":"","sources":["../../../src/decorators/LifecycleBound.ts"],"names":[],"mappings":";;AAOA,wCAOC;AAdD,8CAAyC;AAOzC,SAAgB,cAAc,CAAC,OAAiB;IAC9C,OAAO,CAAC,WAAgB,EAAE,EAAE;;QAC1B,iBAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC9D,iBAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,SAAS,EAAE,WAAW,CAAC,CAAC;QACnF,iBAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,gBAAgB,mCAAI,SAAS,EAAE,WAAW,CAAC,CAAC;QAChG,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/graph/ObjectGraph.d.ts

@@ -4,6 +4,7 @@ import { CircularDependenciesDetector } from './CircularDependenciesDetector';
 export declare abstract class ObjectGraph<T = unknown> implements Graph {
     protected _props?: T | undefined;
     private propertyRetriever;
+    get inactiveBehavior(): 'unmount' | 'retain';
     get name(): string;
     constructor(_props?: T | undefined);
     retrieve<Dependency>(property: string, receiver?: unknown, detector?: CircularDependenciesDetector): Dependency | undefined;

package/dist/src/graph/ObjectGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectGraph.d.ts","sourceRoot":"","sources":["../../../src/graph/ObjectGraph.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAI9E,8BAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK;IAajD,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAZhC,OAAO,CAAC,iBAAiB,CAA+B;IAExD,IAAI,IAAI,IAAI,MAAM,CAQjB;gBAEqB,MAAM,CAAC,EAAE,CAAC,YAAA;IAIhC,QAAQ,CAAC,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,4BAA4B,GACtC,UAAU,GAAG,SAAS;IAQzB,WAAW,CAAC,UAAU,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,4BAA4B,GACtC,UAAU,GAAG,SAAS;IAQzB,MAAM,CAAC,OAAO,EAAE,GAAG;CAGpB;AAID,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC,CAEtG"}
+{"version":3,"file":"ObjectGraph.d.ts","sourceRoot":"","sources":["../../../src/graph/ObjectGraph.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAI9E,8BAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK;IAiBjD,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAhBhC,OAAO,CAAC,iBAAiB,CAA+B;IAExD,IAAI,gBAAgB,IAAI,SAAS,GAAG,QAAQ,CAE3C;IAED,IAAI,IAAI,IAAI,MAAM,CAQjB;gBAEqB,MAAM,CAAC,EAAE,CAAC,YAAA;IAIhC,QAAQ,CAAC,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,4BAA4B,GACtC,UAAU,GAAG,SAAS;IAQzB,WAAW,CAAC,UAAU,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,4BAA4B,GACtC,UAAU,GAAG,SAAS;IAQzB,MAAM,CAAC,OAAO,EAAE,GAAG;CAGpB;AAID,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC,CAEtG"}

package/dist/src/graph/ObjectGraph.js

@@ -11,6 +11,10 @@ const PropertyRetriever_1 = __importDefault(require("./properties/PropertyRetrie
 const reflect_1 = require("../utils/reflect");
 const object_1 = require("../utils/object");
 class ObjectGraph {
+    get inactiveBehavior() {
+        var _a;
+        return (_a = reflect_1.Reflect.getMetadata('inactiveBehavior', this.constructor)) !== null && _a !== void 0 ? _a : 'unmount';
+    }
     get name() {
         const target = (0, object_1.getConstructorOrParentConstructor)(this.constructor, ObjectGraph.name);
         if (reflect_1.Reflect.hasMetadata('memoizedName', target)) {

package/dist/src/graph/ObjectGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectGraph.js","sourceRoot":"","sources":["../../../src/graph/ObjectGraph.ts"],"names":[],"mappings":";;;;;;AAyDA,0BAEC;AA3DD,gDAA6C;AAC7C,qDAAiD;AAEjD,uFAA+D;AAG/D,8CAA2C;AAC3C,4CAAoE;AAEpE,MAAsB,WAAW;IAG/B,IAAI,IAAI;QACN,MAAM,MAAM,GAAG,IAAA,0CAAiC,EAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,iBAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO,iBAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,IAAI,GAAG,IAAA,mBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,iBAAO,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAsB,MAAU;QAAV,WAAM,GAAN,MAAM,CAAI;QAZxB,sBAAiB,GAAG,IAAI,2BAAiB,CAAC,IAAI,CAAC,CAAC;QAatD,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,CACN,QAAgB,EAChB,QAAkB,EAClB,QAAuC;QAEvC,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CACpC,QAAQ,EACR,QAAQ,EACR,QAAQ,CACiB,CAAC;IAC9B,CAAC;IAED,WAAW,CACT,QAAgB,EAChB,QAAkB,EAClB,QAAuC;QAEvC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CACvC,QAAQ,EACR,QAAQ,EACR,QAAQ,CACiB,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,OAAY;IAEnB,CAAC;CACF;AA5CD,kCA4CC;AAED,iBAAO,CAAC,GAAG,CAAC,WAAW,EAAE,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7D,SAAgB,OAAO,CAAC,MAAwC;IAC9D,OAAO,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,aAAa,CAAC;AACpE,CAAC"}
+{"version":3,"file":"ObjectGraph.js","sourceRoot":"","sources":["../../../src/graph/ObjectGraph.ts"],"names":[],"mappings":";;;;;;AA6DA,0BAEC;AA/DD,gDAA6C;AAC7C,qDAAiD;AAEjD,uFAA+D;AAG/D,8CAA2C;AAC3C,4CAAoE;AAEpE,MAAsB,WAAW;IAG/B,IAAI,gBAAgB;;QAClB,OAAO,MAAA,iBAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,mCAAI,SAAS,CAAC;IAChF,CAAC;IAED,IAAI,IAAI;QACN,MAAM,MAAM,GAAG,IAAA,0CAAiC,EAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,iBAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO,iBAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,IAAI,GAAG,IAAA,mBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,iBAAO,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAsB,MAAU;QAAV,WAAM,GAAN,MAAM,CAAI;QAhBxB,sBAAiB,GAAG,IAAI,2BAAiB,CAAC,IAAI,CAAC,CAAC;QAiBtD,IAAA,8BAAa,EAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,CACN,QAAgB,EAChB,QAAkB,EAClB,QAAuC;QAEvC,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CACpC,QAAQ,EACR,QAAQ,EACR,QAAQ,CACiB,CAAC;IAC9B,CAAC;IAED,WAAW,CACT,QAAgB,EAChB,QAAkB,EAClB,QAAuC;QAEvC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CACvC,QAAQ,EACR,QAAQ,EACR,QAAQ,CACiB,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,OAAY;IAEnB,CAAC;CACF;AAhDD,kCAgDC;AAED,iBAAO,CAAC,GAAG,CAAC,WAAW,EAAE,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7D,SAAgB,OAAO,CAAC,MAAwC;IAC9D,OAAO,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,aAAa,CAAC;AACpE,CAAC"}

package/dist/src/injectors/components/ComponentInjector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentInjector.d.ts","sourceRoot":"","sources":["../../../../src/injectors/components/ComponentInjector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,MAAM,CAAC,CAAC,EACN,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAClC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,GAC9C,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAMtC,OAAO,CAAC,aAAa;CAoBtB"}
+{"version":3,"file":"ComponentInjector.d.ts","sourceRoot":"","sources":["../../../../src/injectors/components/ComponentInjector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,MAAM,CAAC,CAAC,EACN,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAClC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,GAC9C,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAMtC,OAAO,CAAC,aAAa;CAwBtB"}

package/dist/src/injectors/components/ComponentInjector.js

@@ -1,12 +1,46 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const react_1 = __importDefault(require("react"));
+const react_1 = __importStar(require("react"));
 const hoist_non_react_statics_1 = __importDefault(require("hoist-non-react-statics"));
 const PropsInjector_1 = __importDefault(require("./PropsInjector"));
 const useGraph_1 = __importDefault(require("./useGraph"));
+const useGraphContainer_1 = __importDefault(require("./useGraphContainer"));
 const React_1 = require("../../utils/React");
 const graphContext_1 = require("./graphContext");
 const useInjectionToken_1 = require("./useInjectionToken");
@@ -22,9 +56,12 @@ class ComponentInjector {
         const compare = isMemoized ? InjectionCandidate.compare : undefined;
         return (0, React_1.genericMemo)((passedProps) => {
             const injectionToken = (0, useInjectionToken_1.useInjectionToken)(keyOrGraph);
-            const graph = (0, useGraph_1.default)(keyOrGraph, Target, passedProps, injectionToken);
+            const containerRef = (0, react_1.useRef)(null);
+            const graph = (0, useGraph_1.default)(keyOrGraph, Target, passedProps, injectionToken, containerRef);
+            const Container = (0, useGraphContainer_1.default)(graph);
             const proxiedProps = new PropsInjector_1.default(graph).inject(passedProps);
-            return (react_1.default.createElement(graphContext_1.GraphContext.Provider, { value: { injectionToken } }, Target(proxiedProps)));
+            return (react_1.default.createElement(graphContext_1.GraphContext.Provider, { value: { injectionToken } },
+                react_1.default.createElement(Container, { ref: containerRef }, Target(proxiedProps))));
         }, compare);
     }
 }

package/dist/src/injectors/components/ComponentInjector.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentInjector.js","sourceRoot":"","sources":["../../../../src/injectors/components/ComponentInjector.tsx"],"names":[],"mappings":";;;;;AAAA,kDAAiD;AACjD,sFAA2D;AAE3D,oEAA4C;AAC5C,0DAAkC;AAElC,6CAAqE;AACrE,iDAA8C;AAC9C,2DAAwD;AAExD,MAAqB,iBAAiB;IACpC,MAAM,CACJ,MAAkC,EAClC,UAA+C;QAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvD,IAAA,iCAAoB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CACnB,kBAA8C,EAC9C,UAA+C;QAE/C,MAAM,UAAU,GAAG,IAAA,2BAAmB,EAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACzE,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,OAAO,IAAA,mBAAW,EAAC,CAAC,WAAc,EAAE,EAAE;YACpC,MAAM,cAAc,GAAG,IAAA,qCAAiB,EAAC,UAAU,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,IAAA,kBAAQ,EAAI,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;YAC3E,MAAM,YAAY,GAAG,IAAI,uBAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAElE,OAAO,CACL,8BAAC,2BAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAC,cAAc,EAAC,IAC3C,MAAM,CAAC,YAA+C,CAAC,CAClC,CACzB,CAAC;QACJ,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;CACF;AA9BD,oCA8BC"}
+{"version":3,"file":"ComponentInjector.js","sourceRoot":"","sources":["../../../../src/injectors/components/ComponentInjector.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAyD;AACzD,sFAA2D;AAE3D,oEAA4C;AAC5C,0DAAkC;AAClC,4EAAoD;AAEpD,6CAAqE;AACrE,iDAA8C;AAC9C,2DAAwD;AAExD,MAAqB,iBAAiB;IACpC,MAAM,CACJ,MAAkC,EAClC,UAA+C;QAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvD,IAAA,iCAAoB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CACnB,kBAA8C,EAC9C,UAA+C;QAE/C,MAAM,UAAU,GAAG,IAAA,2BAAmB,EAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACzE,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,OAAO,IAAA,mBAAW,EAAC,CAAC,WAAc,EAAE,EAAE;YACpC,MAAM,cAAc,GAAG,IAAA,qCAAiB,EAAC,UAAU,CAAC,CAAC;YACrD,MAAM,YAAY,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,IAAA,kBAAQ,EAAI,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;YACzF,MAAM,SAAS,GAAG,IAAA,2BAAiB,EAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,IAAI,uBAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAElE,OAAO,CACL,8BAAC,2BAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAC,cAAc,EAAC;gBAC5C,8BAAC,SAAS,IAAC,GAAG,EAAE,YAAY,IACzB,MAAM,CAAC,YAA+C,CAAC,CAC9C,CACU,CACzB,CAAC;QACJ,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;CACF;AAlCD,oCAkCC"}

package/dist/src/injectors/components/useGraph.d.ts

@@ -1,5 +1,6 @@
+import React from 'react';
 import { Constructable } from '../../types';
 import { ObjectGraph } from '../../graph/ObjectGraph';
-declare const _default: <P>(keyOrGraph: string | Constructable<ObjectGraph>, target: any, props?: Partial<P>, injectionToken?: string) => ObjectGraph<unknown>;
+declare const _default: <P>(keyOrGraph: string | Constructable<ObjectGraph>, target: any, props?: Partial<P>, injectionToken?: string, containerRef?: React.RefObject<any>) => ObjectGraph<unknown>;
 export default _default;
 //# sourceMappingURL=useGraph.d.ts.map

package/dist/src/injectors/components/useGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGraph.d.ts","sourceRoot":"","sources":["../../../../src/injectors/components/useGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;yBAItC,CAAC,cACH,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,UACvC,GAAG,UACH,OAAO,CAAC,CAAC,CAAC,mBACD,MAAM;AAJzB,wBAiBE"}
+{"version":3,"file":"useGraph.d.ts","sourceRoot":"","sources":["../../../../src/injectors/components/useGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;yBAItC,CAAC,cACH,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,UACvC,GAAG,UACH,OAAO,CAAC,CAAC,CAAC,mBACD,MAAM,iBACR,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;AALrC,wBAyBE"}

package/dist/src/injectors/components/useGraph.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = require("react");
 const GraphRegistry_1 = __importDefault(require("../../graph/registry/GraphRegistry"));
 const ReferenceCounter_1 = __importDefault(require("../../ReferenceCounter"));
-exports.default = (keyOrGraph, target, props, injectionToken) => {
+exports.default = (keyOrGraph, target, props, injectionToken, containerRef) => {
     const [graph] = (0, react_1.useState)(() => {
         const resolvedGraph = GraphRegistry_1.default.resolve(keyOrGraph, 'lifecycleOwner', props, injectionToken);
         resolvedGraph.onBind(target);
@@ -14,7 +14,14 @@ exports.default = (keyOrGraph, target, props, injectionToken) => {
     });
     (0, react_1.useEffect)(() => {
         ReferenceCounter_1.default.retain(graph);
-        return () => ReferenceCounter_1.default.release(graph, (g) => GraphRegistry_1.default.clear(g));
+        return () => {
+            const isCleanupCalledDueToActivityPause = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
+            ReferenceCounter_1.default.release(graph, (g) => {
+                if (!isCleanupCalledDueToActivityPause) {
+                    GraphRegistry_1.default.clear(g);
+                }
+            });
+        };
     }, [graph]);
     return graph;
 };

package/dist/src/injectors/components/useGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGraph.js","sourceRoot":"","sources":["../../../../src/injectors/components/useGraph.ts"],"names":[],"mappings":";;;;;AAAA,iCAA4C;AAG5C,uFAA+D;AAC/D,8EAAsD;AAEtD,kBAAe,CACb,UAA+C,EAC/C,MAAW,EACX,KAAkB,EAClB,cAAuB,EACvB,EAAE;IAEF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,gBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,aAAa,GAAG,uBAAa,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,0BAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE,CAAC,0BAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"useGraph.js","sourceRoot":"","sources":["../../../../src/injectors/components/useGraph.ts"],"names":[],"mappings":";;;;;AAAA,iCAAmD;AAGnD,uFAA+D;AAC/D,8EAAsD;AAEtD,kBAAe,CACb,UAA+C,EAC/C,MAAW,EACX,KAAkB,EAClB,cAAuB,EACvB,YAAmC,EACnC,EAAE;IAEF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,gBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,aAAa,GAAG,uBAAa,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,0BAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,MAAM,iCAAiC,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,CAAC;YAChE,0BAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;gBACpC,IAAI,CAAC,iCAAiC,EAAE,CAAC;oBACvC,uBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/src/injectors/components/useGraphContainer.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { ObjectGraph } from '../../graph/ObjectGraph';
+export default function useGraphContainer(graph: ObjectGraph): React.ForwardRefExoticComponent<{
+    children?: React.ReactNode | undefined;
+} & React.RefAttributes<any>>;
+//# sourceMappingURL=useGraphContainer.d.ts.map

package/dist/src/injectors/components/useGraphContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphContainer.d.ts","sourceRoot":"","sources":["../../../../src/injectors/components/useGraphContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwC,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAetD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,KAAK,EAAE,WAAW;;8BAE3D"}

package/dist/src/injectors/components/useGraphContainer.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = useGraphContainer;
+const react_1 = __importStar(require("react"));
+const reactNativeAvailability_1 = require("../../utils/reactNativeAvailability");
+const isRN = (0, reactNativeAvailability_1.isReactNativeAvailable)();
+// eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
+const Element = isRN ? require('react-native').View : 'div';
+const RetainContainer = (0, react_1.forwardRef)((props, ref) => (react_1.default.createElement(Element, { ref: ref, style: isRN ? undefined : { display: 'contents' } }, props.children)));
+const PassthroughContainer = (0, react_1.forwardRef)((props) => (react_1.default.createElement(react_1.default.Fragment, null, props.children)));
+function useGraphContainer(graph) {
+    return graph.inactiveBehavior === 'retain' ? RetainContainer : PassthroughContainer;
+}
+//# sourceMappingURL=useGraphContainer.js.map

package/dist/src/injectors/components/useGraphContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphContainer.js","sourceRoot":"","sources":["../../../../src/injectors/components/useGraphContainer.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,oCAEC;AAlBD,+CAA6D;AAE7D,iFAA6E;AAE7E,MAAM,IAAI,GAAG,IAAA,gDAAsB,GAAE,CAAC;AACtC,iFAAiF;AACjF,MAAM,OAAO,GAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAEjE,MAAM,eAAe,GAAG,IAAA,kBAAU,EAAyB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CACzE,8BAAC,OAAO,IAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAG,KAAK,CAAC,QAAQ,CAAW,CACjG,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAA,kBAAU,EAAyB,CAAC,KAAK,EAAE,EAAE,CAAC,CACzE,8DAAG,KAAK,CAAC,QAAQ,CAAI,CACtB,CAAC,CAAC;AAEH,SAAwB,iBAAiB,CAAC,KAAkB;IAC1D,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACtF,CAAC"}

package/dist/src/utils/packageAvailability.d.ts

@@ -0,0 +1,2 @@
+export declare function isPackageAvailable(name: string): boolean;
+//# sourceMappingURL=packageAvailability.d.ts.map

package/dist/src/utils/packageAvailability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageAvailability.d.ts","sourceRoot":"","sources":["../../../src/utils/packageAvailability.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUxD"}

package/dist/src/utils/packageAvailability.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPackageAvailable = isPackageAvailable;
+const cache = new Map();
+function isPackageAvailable(name) {
+    if (cache.has(name))
+        return cache.get(name);
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
+        require(name);
+        cache.set(name, true);
+    }
+    catch (_a) {
+        cache.set(name, false);
+    }
+    return cache.get(name);
+}
+//# sourceMappingURL=packageAvailability.js.map

package/dist/src/utils/packageAvailability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageAvailability.js","sourceRoot":"","sources":["../../../src/utils/packageAvailability.ts"],"names":[],"mappings":";;AAEA,gDAUC;AAZD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEzC,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IAC7C,IAAI,CAAC;QACH,iFAAiF;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,WAAM,CAAC;QACP,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;AAC1B,CAAC"}

package/dist/src/utils/reactAvailability.d.ts

@@ -4,9 +4,4 @@ export declare function isReactAvailable(): boolean;
  * Used to provide helpful error messages for React-dependent features.
  */
 export declare function createReactRequiredError<T = any>(featureName: string): T;
-/**
- * Creates a class constructor that throws an error when instantiated if React is not available.
- * Used for features like Model that need to be constructable.
- */
-export declare function createReactRequiredClass<T = any>(className: string): T;
 //# sourceMappingURL=reactAvailability.d.ts.map

package/dist/src/utils/reactAvailability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactAvailability.d.ts","sourceRoot":"","sources":["../../../src/utils/reactAvailability.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,IAAI,OAAO,CAc1C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,CAOxE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAStE"}
+{"version":3,"file":"reactAvailability.d.ts","sourceRoot":"","sources":["../../../src/utils/reactAvailability.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,CAOxE"}

package/dist/src/utils/reactAvailability.js

@@ -2,21 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isReactAvailable = isReactAvailable;
 exports.createReactRequiredError = createReactRequiredError;
-exports.createReactRequiredClass = createReactRequiredClass;
-let reactAvailableCache;
+const packageAvailability_1 = require("./packageAvailability");
 function isReactAvailable() {
-    if (reactAvailableCache !== undefined) {
-        return reactAvailableCache;
-    }
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
-        require('react');
-        reactAvailableCache = true;
-    }
-    catch (_a) {
-        reactAvailableCache = false;
-    }
-    return reactAvailableCache;
+    return (0, packageAvailability_1.isPackageAvailable)('react');
 }
 /**
  * Creates a function that throws an error when called if React is not available.
@@ -28,16 +16,4 @@ function createReactRequiredError(featureName) {
             + `Please install React: npm install react`);
     };
 }
-/**
- * Creates a class constructor that throws an error when instantiated if React is not available.
- * Used for features like Model that need to be constructable.
- */
-function createReactRequiredClass(className) {
-    return class ReactRequiredStub {
-        constructor() {
-            throw new Error(`${className} requires React to be installed. `
-                + `Please install React: npm install react`);
-        }
-    };
-}
 //# sourceMappingURL=reactAvailability.js.map

package/dist/src/utils/reactAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactAvailability.js","sourceRoot":"","sources":["../../../src/utils/reactAvailability.ts"],"names":[],"mappings":";;AAEA,4CAcC;AAMD,4DAOC;AAMD,4DASC;AA5CD,IAAI,mBAAwC,CAAC;AAE7C,SAAgB,gBAAgB;IAC9B,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,iFAAiF;QACjF,OAAO,CAAC,OAAO,CAAC,CAAC;QACjB,mBAAmB,GAAG,IAAI,CAAC;IAC7B,CAAC;IAAC,WAAM,CAAC;QACP,mBAAmB,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAU,WAAmB;IACnE,OAAO,SAAS,iBAAiB,CAAC,GAAG,KAAY;QAC/C,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,mCAAmC;cAC/C,yCAAyC,CAC5C,CAAC;IACJ,CAAM,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAU,SAAiB;IACjE,OAAO,MAAM,iBAAiB;QAC5B;YACE,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,mCAAmC;kBAC7C,yCAAyC,CAC5C,CAAC;QACJ,CAAC;KACG,CAAC;AACT,CAAC"}
+{"version":3,"file":"reactAvailability.js","sourceRoot":"","sources":["../../../src/utils/reactAvailability.ts"],"names":[],"mappings":";;AAEA,4CAEC;AAMD,4DAOC;AAjBD,+DAA2D;AAE3D,SAAgB,gBAAgB;IAC9B,OAAO,IAAA,wCAAkB,EAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAU,WAAmB;IACnE,OAAO,SAAS,iBAAiB,CAAC,GAAG,KAAY;QAC/C,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,mCAAmC;cAC/C,yCAAyC,CAC5C,CAAC;IACJ,CAAM,CAAC;AACT,CAAC"}

package/dist/src/utils/reactNativeAvailability.d.ts

@@ -0,0 +1,2 @@
+export declare function isReactNativeAvailable(): boolean;
+//# sourceMappingURL=reactNativeAvailability.d.ts.map

package/dist/src/utils/reactNativeAvailability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativeAvailability.d.ts","sourceRoot":"","sources":["../../../src/utils/reactNativeAvailability.ts"],"names":[],"mappings":"AAIA,wBAAgB,sBAAsB,IAAI,OAAO,CAQhD"}

package/dist/src/utils/reactNativeAvailability.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReactNativeAvailable = isReactNativeAvailable;
+const packageAvailability_1 = require("./packageAvailability");
+let cache;
+function isReactNativeAvailable() {
+    if (cache !== undefined)
+        return cache;
+    if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+        cache = true;
+        return cache;
+    }
+    cache = (0, packageAvailability_1.isPackageAvailable)('react-native');
+    return cache;
+}
+//# sourceMappingURL=reactNativeAvailability.js.map

package/dist/src/utils/reactNativeAvailability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativeAvailability.js","sourceRoot":"","sources":["../../../src/utils/reactNativeAvailability.ts"],"names":[],"mappings":";;AAIA,wDAQC;AAZD,+DAA2D;AAE3D,IAAI,KAA0B,CAAC;AAE/B,SAAgB,sBAAsB;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QAC5E,KAAK,GAAG,IAAI,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,GAAG,IAAA,wCAAkB,EAAC,cAAc,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/test/fixtures/RetainedLifecycleBoundGraph.d.ts

@@ -0,0 +1,7 @@
+import { ObjectGraph } from '../../src';
+export declare class RetainedLifecycleBoundGraph extends ObjectGraph<Record<string, any>> {
+    static timesCreated: number;
+    constructor(props?: Record<string, any>);
+    doesNotRequireProps(): string;
+}
+//# sourceMappingURL=RetainedLifecycleBoundGraph.d.ts.map

package/dist/test/fixtures/RetainedLifecycleBoundGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetainedLifecycleBoundGraph.d.ts","sourceRoot":"","sources":["../../../test/fixtures/RetainedLifecycleBoundGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAGZ,MAAM,WAAW,CAAC;AAEnB,qBACa,2BAA4B,SAAQ,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,CAAC,YAAY,SAAK;gBAEZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAM3C,mBAAmB,IAAI,MAAM;CAG9B"}

package/dist/test/fixtures/RetainedLifecycleBoundGraph.js

@@ -0,0 +1,78 @@
+"use strict";
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetainedLifecycleBoundGraph = void 0;
+const src_1 = require("../../src");
+let RetainedLifecycleBoundGraph = (() => {
+    let _classDecorators = [(0, src_1.lifecycleBound)({ inactiveBehavior: 'retain' }), (0, src_1.graph)()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = src_1.ObjectGraph;
+    let _instanceExtraInitializers = [];
+    let _doesNotRequireProps_decorators;
+    var RetainedLifecycleBoundGraph = _classThis = class extends _classSuper {
+        constructor(props = {}) {
+            super(props);
+            __runInitializers(this, _instanceExtraInitializers);
+            RetainedLifecycleBoundGraph.timesCreated++;
+        }
+        doesNotRequireProps() {
+            return 'A string that does not require props';
+        }
+    };
+    __setFunctionName(_classThis, "RetainedLifecycleBoundGraph");
+    (() => {
+        var _a;
+        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create((_a = _classSuper[Symbol.metadata]) !== null && _a !== void 0 ? _a : null) : void 0;
+        _doesNotRequireProps_decorators = [(0, src_1.provides)()];
+        __esDecorate(_classThis, null, _doesNotRequireProps_decorators, { kind: "method", name: "doesNotRequireProps", static: false, private: false, access: { has: obj => "doesNotRequireProps" in obj, get: obj => obj.doesNotRequireProps }, metadata: _metadata }, null, _instanceExtraInitializers);
+        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+        RetainedLifecycleBoundGraph = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+    })();
+    _classThis.timesCreated = 0;
+    (() => {
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return RetainedLifecycleBoundGraph = _classThis;
+})();
+exports.RetainedLifecycleBoundGraph = RetainedLifecycleBoundGraph;
+//# sourceMappingURL=RetainedLifecycleBoundGraph.js.map

package/dist/test/fixtures/RetainedLifecycleBoundGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetainedLifecycleBoundGraph.js","sourceRoot":"","sources":["../../../test/fixtures/RetainedLifecycleBoundGraph.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAKmB;IAGN,2BAA2B;4BADvC,IAAA,oBAAc,EAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAA,WAAK,GAAE;;;;sBACP,iBAAW;;;wDAAnB,SAAQ,WAAgC;QAG/E,YAAY,QAA6B,EAAE;YACzC,KAAK,CAAC,KAAK,CAAC,CAAC;YAJJ,mDAA2B;YAKpC,2BAA2B,CAAC,YAAY,EAAE,CAAC;SAC5C;QAGD,mBAAmB;YACjB,OAAO,sCAAsC,CAAC;QAChD,CAAC;;;;;;2CAHA,IAAA,cAAQ,GAAE;QACX,kNAAA,mBAAmB,6DAElB;QAXH,6KAYC;;;;IAXQ,uBAAY,GAAG,CAAC,AAAJ,CAAK;;QADb,uDAA2B;;;;AAA3B,kEAA2B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-obsidian",
-  "version": "2.30.0",
+  "version": "2.31.0-alpha.1",
   "description": "Dependency injection framework for React and React Native applications",
   "scripts": {
     "prepack": "yarn lint && tsc --project tsconfig.prod.json",
@@ -39,6 +39,7 @@
     "@babel/preset-typescript": "7.26.0",
     "@babel/types": "7.24.5",
     "@stylistic/eslint-plugin": "^1.7.0",
+    "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "14.x.x",
     "@types/hoist-non-react-statics": "^3.3.1",
     "@types/jest": "^30.0.0",

package/src/decorators/LifecycleBound.ts

@@ -2,12 +2,14 @@ import {Reflect} from '../utils/reflect';
 
 type Options = {
   scope?: 'component' | 'feature' | (string & {});
+  inactiveBehavior?: 'unmount' | 'retain';
 };
 
 export function lifecycleBound(options?: Options) {
   return (constructor: any) => {
     Reflect.defineMetadata('isLifecycleBound', true, constructor);
     Reflect.defineMetadata('lifecycleScope', options?.scope ?? 'feature', constructor);
+    Reflect.defineMetadata('inactiveBehavior', options?.inactiveBehavior ?? 'unmount', constructor);
     return constructor;
   };
 }

package/src/graph/ObjectGraph.ts

@@ -10,6 +10,10 @@ import { getConstructorOrParentConstructor } from '../utils/object';
 export abstract class ObjectGraph<T = unknown> implements Graph {
   private propertyRetriever = new PropertyRetriever(this);
 
+  get inactiveBehavior(): 'unmount' | 'retain' {
+    return Reflect.getMetadata('inactiveBehavior', this.constructor) ?? 'unmount';
+  }
+
   get name(): string {
     const target = getConstructorOrParentConstructor(this.constructor, ObjectGraph.name);
     if (Reflect.hasMetadata('memoizedName', target)) {

package/src/injectors/components/ComponentInjector.tsx

@@ -1,8 +1,9 @@
-import React, { PropsWithChildren } from 'react';
+import React, { PropsWithChildren, useRef } from 'react';
 import hoistNonReactStatics from 'hoist-non-react-statics';
 import { ObjectGraph } from '../../graph/ObjectGraph';
 import PropsInjector from './PropsInjector';
 import useGraph from './useGraph';
+import useGraphContainer from './useGraphContainer';
 import { Constructable } from '../../types';
 import { genericMemo, isMemoizedComponent } from '../../utils/React';
 import { GraphContext } from './graphContext';
@@ -28,12 +29,16 @@ export default class ComponentInjector {
 
     return genericMemo((passedProps: P) => {
       const injectionToken = useInjectionToken(keyOrGraph);
-      const graph = useGraph<P>(keyOrGraph, Target, passedProps, injectionToken);
+      const containerRef = useRef(null);
+      const graph = useGraph<P>(keyOrGraph, Target, passedProps, injectionToken, containerRef);
+      const Container = useGraphContainer(graph);
       const proxiedProps = new PropsInjector(graph).inject(passedProps);
 
       return (
         <GraphContext.Provider value={{injectionToken}}>
-          {Target(proxiedProps as unknown as PropsWithChildren<P>)}
+          <Container ref={containerRef}>
+            {Target(proxiedProps as unknown as PropsWithChildren<P>)}
+          </Container>
         </GraphContext.Provider>
       );
     }, compare);

package/src/injectors/components/useGraph.ts

@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import React, { useEffect, useState } from 'react';
 import { Constructable } from '../../types';
 import { ObjectGraph } from '../../graph/ObjectGraph';
 import graphRegistry from '../../graph/registry/GraphRegistry';
@@ -9,6 +9,7 @@ export default <P>(
   target: any,
   props?: Partial<P>,
   injectionToken?: string,
+  containerRef?: React.RefObject<any>,
 ) => {
 
   const [graph] = useState(() => {
@@ -18,7 +19,14 @@ export default <P>(
   });
   useEffect(() => {
     referenceCounter.retain(graph);
-    return () => referenceCounter.release(graph, (g) => graphRegistry.clear(g));
+    return () => {
+      const isCleanupCalledDueToActivityPause = containerRef?.current;
+      referenceCounter.release(graph, (g) => {
+        if (!isCleanupCalledDueToActivityPause) {
+          graphRegistry.clear(g);
+        }
+      });
+    };
   }, [graph]);
   return graph;
 };

package/src/injectors/components/useGraphContainer.tsx

@@ -0,0 +1,19 @@
+import React, { forwardRef, PropsWithChildren } from 'react';
+import { ObjectGraph } from '../../graph/ObjectGraph';
+import { isReactNativeAvailable } from '../../utils/reactNativeAvailability';
+
+const isRN = isReactNativeAvailable();
+// eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
+const Element: any = isRN ? require('react-native').View : 'div';
+
+const RetainContainer = forwardRef<any, PropsWithChildren>((props, ref) => (
+  <Element ref={ref} style={isRN ? undefined : { display: 'contents' }}>{props.children}</Element>
+));
+
+const PassthroughContainer = forwardRef<any, PropsWithChildren>((props) => (
+  <>{props.children}</>
+));
+
+export default function useGraphContainer(graph: ObjectGraph) {
+  return graph.inactiveBehavior === 'retain' ? RetainContainer : PassthroughContainer;
+}

package/src/utils/packageAvailability.ts

@@ -0,0 +1,13 @@
+const cache = new Map<string, boolean>();
+
+export function isPackageAvailable(name: string): boolean {
+  if (cache.has(name)) return cache.get(name)!;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
+    require(name);
+    cache.set(name, true);
+  } catch {
+    cache.set(name, false);
+  }
+  return cache.get(name)!;
+}

package/src/utils/reactAvailability.ts

@@ -1,19 +1,7 @@
-let reactAvailableCache: boolean | undefined;
+import { isPackageAvailable } from './packageAvailability';
 
 export function isReactAvailable(): boolean {
-  if (reactAvailableCache !== undefined) {
-    return reactAvailableCache;
-  }
-
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
-    require('react');
-    reactAvailableCache = true;
-  } catch {
-    reactAvailableCache = false;
-  }
-
-  return reactAvailableCache;
+  return isPackageAvailable('react');
 }
 
 /**
@@ -28,18 +16,3 @@ export function createReactRequiredError<T = any>(featureName: string): T {
     );
   } as T;
 }
-
-/**
- * Creates a class constructor that throws an error when instantiated if React is not available.
- * Used for features like Model that need to be constructable.
- */
-export function createReactRequiredClass<T = any>(className: string): T {
-  return class ReactRequiredStub {
-    constructor() {
-      throw new Error(
-        `${className} requires React to be installed. `
-        + `Please install React: npm install react`,
-      );
-    }
-  } as T;
-}

package/src/utils/reactNativeAvailability.ts

@@ -0,0 +1,13 @@
+import { isPackageAvailable } from './packageAvailability';
+
+let cache: boolean | undefined;
+
+export function isReactNativeAvailable(): boolean {
+  if (cache !== undefined) return cache;
+  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+    cache = true;
+    return cache;
+  }
+  cache = isPackageAvailable('react-native');
+  return cache;
+}