@legendapp/state 2.2.0-next.71 → 2.2.0-next.73

package/config/enableReactTracking.js

@@ -4,43 +4,45 @@ var state = require('@legendapp/state');
 var react$1 = require('@legendapp/state/react');
 var react = require('react');
 
-const ReactRenderContext = react.createContext(0);
-function needsSelector() {
-    // If we're already tracking then we definitely don't need useSelector
-    if (!state.tracking.current) {
-        try {
-            // If there's no dispatcher we're definitely not in React
-            // This is an optimization to not need to run useContext. If in a future React version
-            // this works differently we can change it or just remove it.
-            const dispatcher = react.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
-            if (dispatcher) {
-                // If there's a dispatcher then we may be inside of a hook.
-                // Attempt a useContext hook, which will throw an error if outside of render.
-                react.useContext(ReactRenderContext);
-                return true;
-            }
-        }
-        catch (_a) { } // eslint-disable-line no-empty
-    }
-    return false;
-}
 function enableReactTracking({ auto, warnUnobserved }) {
     const { get } = state.internal;
-    state.configureLegendState({
-        observableFunctions: {
-            get: (node, options) => {
-                if (needsSelector()) {
-                    if (auto) {
-                        return react$1.useSelector(() => get(node, options), state.isObject(options) ? options : undefined);
-                    }
-                    else if (process.env.NODE_ENV === 'development' && warnUnobserved) {
-                        console.warn('[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/react-api/#observer-hoc');
+    if (auto || (process.env.NODE_ENV === 'development' && warnUnobserved)) {
+        const ReactRenderContext = react.createContext(0);
+        const needsSelector = () => {
+            // If we're already tracking then we definitely don't need useSelector
+            if (!state.tracking.current) {
+                try {
+                    // If there's no dispatcher we're definitely not in React
+                    // This is an optimization to not need to run useContext. If in a future React version
+                    // this works differently we can change it or just remove it.
+                    const dispatcher = react.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
+                    if (dispatcher) {
+                        // If there's a dispatcher then we may be inside of a hook.
+                        // Attempt a useContext hook, which will throw an error if outside of render.
+                        react.useContext(ReactRenderContext);
+                        return true;
                     }
                 }
-                return get(node, options);
+                catch (_a) { } // eslint-disable-line no-empty
+            }
+            return false;
+        };
+        state.configureLegendState({
+            observableFunctions: {
+                get: (node, options) => {
+                    if (needsSelector()) {
+                        if (auto) {
+                            return react$1.useSelector(() => get(node, options), state.isObject(options) ? options : undefined);
+                        }
+                        else if (process.env.NODE_ENV === 'development' && warnUnobserved) {
+                            console.warn('[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/react-api/#observer-hoc');
+                        }
+                    }
+                    return get(node, options);
+                },
             },
-        },
-    });
+        });
+    }
 }
 
 exports.enableReactTracking = enableReactTracking;

package/config/enableReactTracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"enableReactTracking.js","sources":["../src/config/enableReactTracking.ts"],"sourcesContent":[null],"names":["createContext","tracking","ReactInternals","useContext","internal","configureLegendState","useSelector","isObject"],"mappings":";;;;;;AAcA,MAAM,kBAAkB,GAAGA,mBAAa,CAAC,CAAC,CAAC,CAAC;AAE5C,SAAS,aAAa,GAAA;;AAElB,IAAA,IAAI,CAACC,cAAQ,CAAC,OAAO,EAAE;AACnB,QAAA,IAAI;;;;AAIA,YAAA,MAAM,UAAU,GAAGC,wDAAc,CAAC,sBAAsB,CAAC,OAAO,CAAC;YACjE,IAAI,UAAU,EAAE;;;gBAGZC,gBAAU,CAAC,kBAAkB,CAAC,CAAC;AAC/B,gBAAA,OAAO,IAAI,CAAC;aACf;SACJ;AAAC,QAAA,OAAA,EAAA,EAAM,GAAE;KACb;AACD,IAAA,OAAO,KAAK,CAAC;AACjB,CAAC;SAOe,mBAAmB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAwB,EAAA;AAC9E,IAAA,MAAM,EAAE,GAAG,EAAE,GAAGC,cAAQ,CAAC;AAEzB,IAAAC,0BAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA0D,KAAI;gBACjF,IAAI,aAAa,EAAE,EAAE;oBACjB,IAAI,IAAI,EAAE;wBACN,OAAOC,mBAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAEC,cAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;qBACzF;yBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,EAAE;AACjE,wBAAA,OAAO,CAAC,IAAI,CACR,yKAAyK,CAC5K,CAAC;qBACL;iBACJ;AACD,gBAAA,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aAC7B;AACJ,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}
+{"version":3,"file":"enableReactTracking.js","sources":["../src/config/enableReactTracking.ts"],"sourcesContent":[null],"names":["internal","createContext","tracking","ReactInternals","useContext","configureLegendState","useSelector","isObject"],"mappings":";;;;;;SAmBgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAwB,EAAA;AAC9E,IAAA,MAAM,EAAE,GAAG,EAAE,GAAGA,cAAQ,CAAC;AAEzB,IAAA,IAAI,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,CAAC,EAAE;AACpE,QAAA,MAAM,kBAAkB,GAAGC,mBAAa,CAAC,CAAC,CAAC,CAAC;QAE5C,MAAM,aAAa,GAAG,MAAK;;AAEvB,YAAA,IAAI,CAACC,cAAQ,CAAC,OAAO,EAAE;AACnB,gBAAA,IAAI;;;;AAIA,oBAAA,MAAM,UAAU,GAAGC,wDAAc,CAAC,sBAAsB,CAAC,OAAO,CAAC;oBACjE,IAAI,UAAU,EAAE;;;wBAGZC,gBAAU,CAAC,kBAAkB,CAAC,CAAC;AAC/B,wBAAA,OAAO,IAAI,CAAC;qBACf;iBACJ;AAAC,gBAAA,OAAA,EAAA,EAAM,GAAE;aACb;AACD,YAAA,OAAO,KAAK,CAAC;AACjB,SAAC,CAAC;AAEF,QAAAC,0BAAoB,CAAC;AACjB,YAAA,mBAAmB,EAAE;AACjB,gBAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA0D,KAAI;oBACjF,IAAI,aAAa,EAAE,EAAE;wBACjB,IAAI,IAAI,EAAE;4BACN,OAAOC,mBAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAEC,cAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;yBACzF;6BAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,EAAE;AACjE,4BAAA,OAAO,CAAC,IAAI,CACR,yKAAyK,CAC5K,CAAC;yBACL;qBACJ;AACD,oBAAA,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;iBAC7B;AACJ,aAAA;AACJ,SAAA,CAAC,CAAC;KACN;AACL;;;;"}

package/config/enableReactTracking.mjs

@@ -1,44 +1,46 @@
-import { configureLegendState, isObject, tracking, internal } from '@legendapp/state';
+import { configureLegendState, isObject, internal, tracking } from '@legendapp/state';
 import { useSelector } from '@legendapp/state/react';
 import { createContext, __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED, useContext } from 'react';
 
-const ReactRenderContext = createContext(0);
-function needsSelector() {
-    // If we're already tracking then we definitely don't need useSelector
-    if (!tracking.current) {
-        try {
-            // If there's no dispatcher we're definitely not in React
-            // This is an optimization to not need to run useContext. If in a future React version
-            // this works differently we can change it or just remove it.
-            const dispatcher = __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
-            if (dispatcher) {
-                // If there's a dispatcher then we may be inside of a hook.
-                // Attempt a useContext hook, which will throw an error if outside of render.
-                useContext(ReactRenderContext);
-                return true;
-            }
-        }
-        catch (_a) { } // eslint-disable-line no-empty
-    }
-    return false;
-}
 function enableReactTracking({ auto, warnUnobserved }) {
     const { get } = internal;
-    configureLegendState({
-        observableFunctions: {
-            get: (node, options) => {
-                if (needsSelector()) {
-                    if (auto) {
-                        return useSelector(() => get(node, options), isObject(options) ? options : undefined);
-                    }
-                    else if (process.env.NODE_ENV === 'development' && warnUnobserved) {
-                        console.warn('[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/react-api/#observer-hoc');
+    if (auto || (process.env.NODE_ENV === 'development' && warnUnobserved)) {
+        const ReactRenderContext = createContext(0);
+        const needsSelector = () => {
+            // If we're already tracking then we definitely don't need useSelector
+            if (!tracking.current) {
+                try {
+                    // If there's no dispatcher we're definitely not in React
+                    // This is an optimization to not need to run useContext. If in a future React version
+                    // this works differently we can change it or just remove it.
+                    const dispatcher = __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
+                    if (dispatcher) {
+                        // If there's a dispatcher then we may be inside of a hook.
+                        // Attempt a useContext hook, which will throw an error if outside of render.
+                        useContext(ReactRenderContext);
+                        return true;
                     }
                 }
-                return get(node, options);
+                catch (_a) { } // eslint-disable-line no-empty
+            }
+            return false;
+        };
+        configureLegendState({
+            observableFunctions: {
+                get: (node, options) => {
+                    if (needsSelector()) {
+                        if (auto) {
+                            return useSelector(() => get(node, options), isObject(options) ? options : undefined);
+                        }
+                        else if (process.env.NODE_ENV === 'development' && warnUnobserved) {
+                            console.warn('[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/react-api/#observer-hoc');
+                        }
+                    }
+                    return get(node, options);
+                },
             },
-        },
-    });
+        });
+    }
 }
 
 export { enableReactTracking };

package/config/enableReactTracking.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"enableReactTracking.mjs","sources":["../src/config/enableReactTracking.ts"],"sourcesContent":[null],"names":["ReactInternals"],"mappings":";;;;AAcA,MAAM,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAE5C,SAAS,aAAa,GAAA;;AAElB,IAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;AACnB,QAAA,IAAI;;;;AAIA,YAAA,MAAM,UAAU,GAAGA,kDAAc,CAAC,sBAAsB,CAAC,OAAO,CAAC;YACjE,IAAI,UAAU,EAAE;;;gBAGZ,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC/B,gBAAA,OAAO,IAAI,CAAC;aACf;SACJ;AAAC,QAAA,OAAA,EAAA,EAAM,GAAE;KACb;AACD,IAAA,OAAO,KAAK,CAAC;AACjB,CAAC;SAOe,mBAAmB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAwB,EAAA;AAC9E,IAAA,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;AAEzB,IAAA,oBAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA0D,KAAI;gBACjF,IAAI,aAAa,EAAE,EAAE;oBACjB,IAAI,IAAI,EAAE;wBACN,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;qBACzF;yBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,EAAE;AACjE,wBAAA,OAAO,CAAC,IAAI,CACR,yKAAyK,CAC5K,CAAC;qBACL;iBACJ;AACD,gBAAA,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aAC7B;AACJ,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}
+{"version":3,"file":"enableReactTracking.mjs","sources":["../src/config/enableReactTracking.ts"],"sourcesContent":[null],"names":["ReactInternals"],"mappings":";;;;SAmBgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAwB,EAAA;AAC9E,IAAA,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;AAEzB,IAAA,IAAI,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,CAAC,EAAE;AACpE,QAAA,MAAM,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAE5C,MAAM,aAAa,GAAG,MAAK;;AAEvB,YAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;AACnB,gBAAA,IAAI;;;;AAIA,oBAAA,MAAM,UAAU,GAAGA,kDAAc,CAAC,sBAAsB,CAAC,OAAO,CAAC;oBACjE,IAAI,UAAU,EAAE;;;wBAGZ,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC/B,wBAAA,OAAO,IAAI,CAAC;qBACf;iBACJ;AAAC,gBAAA,OAAA,EAAA,EAAM,GAAE;aACb;AACD,YAAA,OAAO,KAAK,CAAC;AACjB,SAAC,CAAC;AAEF,QAAA,oBAAoB,CAAC;AACjB,YAAA,mBAAmB,EAAE;AACjB,gBAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA0D,KAAI;oBACjF,IAAI,aAAa,EAAE,EAAE;wBACjB,IAAI,IAAI,EAAE;4BACN,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;yBACzF;6BAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,cAAc,EAAE;AACjE,4BAAA,OAAO,CAAC,IAAI,CACR,yKAAyK,CAC5K,CAAC;yBACL;qBACJ;AACD,oBAAA,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;iBAC7B;AACJ,aAAA;AACJ,SAAA,CAAC,CAAC;KACN;AACL;;;;"}

package/config/enableReactUse.js

@@ -3,11 +3,18 @@
 var state = require('@legendapp/state');
 var react = require('@legendapp/state/react');
 
-// TODO: Deprecate
+// TODO: Deprecated, remove in v4
+let didWarn = false;
 function enableReactUse() {
     state.configureLegendState({
         observableFunctions: {
-            use: (node, options) => react.useSelector(state.internal.getProxy(node), options),
+            use: (node, options) => {
+                if (process.env.NODE_ENV === 'development' && !didWarn) {
+                    didWarn = true;
+                    console.warn('[legend-state] enableReactUse() is deprecated. Please switch to using get() with observer, which is safer and more efficient. See https://legendapp.com/open-source/state/v3/react/react-api/');
+                }
+                return react.useSelector(state.internal.getProxy(node), options);
+            },
         },
     });
 }

package/config/enableReactUse.js.map

@@ -1 +1 @@
-{"version":3,"file":"enableReactUse.js","sources":["../src/config/enableReactUse.ts"],"sourcesContent":[null],"names":["configureLegendState","useSelector","internal"],"mappings":";;;;;AAGA;SAEgB,cAAc,GAAA;AAC1B,IAAAA,0BAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA4B,KAAKC,iBAAW,CAACC,cAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;AACxG,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}
+{"version":3,"file":"enableReactUse.js","sources":["../src/config/enableReactUse.ts"],"sourcesContent":[null],"names":["configureLegendState","useSelector","internal"],"mappings":";;;;;AAGA;AACA,IAAI,OAAO,GAAG,KAAK,CAAC;SAEJ,cAAc,GAAA;AAC1B,IAAAA,0BAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA4B,KAAI;gBACnD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,OAAO,EAAE;oBACpD,OAAO,GAAG,IAAI,CAAC;AACf,oBAAA,OAAO,CAAC,IAAI,CACR,+LAA+L,CAClM,CAAC;iBACL;gBACD,OAAOC,iBAAW,CAACC,cAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;aACxD;AACJ,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}

package/config/enableReactUse.mjs

@@ -1,11 +1,18 @@
 import { configureLegendState, internal } from '@legendapp/state';
 import { useSelector } from '@legendapp/state/react';
 
-// TODO: Deprecate
+// TODO: Deprecated, remove in v4
+let didWarn = false;
 function enableReactUse() {
     configureLegendState({
         observableFunctions: {
-            use: (node, options) => useSelector(internal.getProxy(node), options),
+            use: (node, options) => {
+                if (process.env.NODE_ENV === 'development' && !didWarn) {
+                    didWarn = true;
+                    console.warn('[legend-state] enableReactUse() is deprecated. Please switch to using get() with observer, which is safer and more efficient. See https://legendapp.com/open-source/state/v3/react/react-api/');
+                }
+                return useSelector(internal.getProxy(node), options);
+            },
         },
     });
 }

package/config/enableReactUse.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"enableReactUse.mjs","sources":["../src/config/enableReactUse.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;SAEgB,cAAc,GAAA;AAC1B,IAAA,oBAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA4B,KAAK,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;AACxG,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}
+{"version":3,"file":"enableReactUse.mjs","sources":["../src/config/enableReactUse.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;AACA,IAAI,OAAO,GAAG,KAAK,CAAC;SAEJ,cAAc,GAAA;AAC1B,IAAA,oBAAoB,CAAC;AACjB,QAAA,mBAAmB,EAAE;AACjB,YAAA,GAAG,EAAE,CAAC,IAAe,EAAE,OAA4B,KAAI;gBACnD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,OAAO,EAAE;oBACpD,OAAO,GAAG,IAAI,CAAC;AACf,oBAAA,OAAO,CAAC,IAAI,CACR,+LAA+L,CAClM,CAAC;iBACL;gBACD,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;aACxD;AACJ,SAAA;AACJ,KAAA,CAAC,CAAC;AACP;;;;"}

package/index.d.ts

@@ -18,7 +18,7 @@ export { when, whenReady } from './src/when';
 import { get, getProxy, peek, set } from './src/ObservableObject';
 import { createPreviousHandler } from './src/batching';
 import { clone, ensureNodeValue, findIDKey, getNode, getNodeValue, getPathType, safeParse, safeStringify, setNodeValue } from './src/globals';
-import { initializePathType, setAtPath } from './src/helpers';
+import { getValueAtPath, initializePathType, setAtPath } from './src/helpers';
 import { runWithRetry } from './src/retry';
 export declare const internal: {
     createPreviousHandler: typeof createPreviousHandler;
@@ -30,6 +30,7 @@ export declare const internal: {
     getNodeValue: typeof getNodeValue;
     getPathType: typeof getPathType;
     getProxy: typeof getProxy;
+    getValueAtPath: typeof getValueAtPath;
     globalState: {
         isLoadingLocal: boolean;
         isMerging: boolean;

package/index.js

@@ -147,7 +147,7 @@ function setNodeValue(node, newValue) {
     // Compute newValue if newValue is a function or an observable
     newValue = !parentNode.isAssigning && isFunc && !isFunction(prevValue) ? newValue(prevValue) : newValue;
     if (!globalState.isMerging ||
-        prevValue === undefined ||
+        isNullOrUndefined(prevValue) ||
         isFunction(prevValue) ||
         !((_c = (_b = node.parent) === null || _b === void 0 ? void 0 : _b.functions) === null || _c === void 0 ? void 0 : _c.get(key))) {
         try {
@@ -547,6 +547,14 @@ function opaqueObject(value) {
     }
     return value;
 }
+function getValueAtPath$1(obj, path) {
+    let o = obj;
+    for (let i = 0; o && i < path.length; i++) {
+        const p = path[i];
+        o = o[p];
+    }
+    return o;
+}
 function setAtPath(obj, path, pathTypes, value, mode, fullObj, restore) {
     let o = obj;
     let oFull = fullObj;
@@ -1414,6 +1422,7 @@ const proxyHandler = {
                     updateTracking(node);
                     return function (cbOrig, thisArg) {
                         const isReduce = p === 'reduce';
+                        // Callbacks are given the Proxy rather than the underlying data
                         const cbWrapped = isReduce
                             ? (previousValue, currentValue, currentIndex, array) => {
                                 return cbOrig(previousValue, getProxy(node, currentIndex + '', currentValue), currentIndex, array);
@@ -1429,6 +1438,7 @@ const proxyHandler = {
                         for (let i = 0; i < value.length; i++) {
                             if (cbWrapped(value[i], i, value)) {
                                 const proxy = getProxy(node, i + '');
+                                // find returns the first match, otherwise it returns an array
                                 if (isFind) {
                                     return proxy;
                                 }
@@ -2228,6 +2238,7 @@ const internal = {
     getNodeValue,
     getPathType,
     getProxy,
+    getValueAtPath: getValueAtPath$1,
     globalState,
     initializePathType,
     observableFns,