@legendapp/state 3.0.0-beta.4 → 3.0.0-beta.40

package/README.md

@@ -72,7 +72,7 @@ Legend-State includes a powerful [sync and persistence system](../../usage/persi
 Local persistence plugins for the browser and React Native are included, with sync plugins for [Keel](https://www.keel.so), [Supabase](https://www.supabase.com), [TanStack Query](https://tanstack.com/query), and `fetch`.
 
 ```js
-const state$ = observable(
+const state$ = observable({
     users: syncedKeel({
         list: queries.getUsers,
         create: mutations.createUsers,
@@ -87,7 +87,7 @@ const state$ = observable(
     }),
     // direct link to my user within the users observable
     me: () => state$.users['myuid']
-)
+})
 
 observe(() => {
     // get() activates through to state$.users and starts syncing.

package/config/enableReactComponents.js

@@ -4,7 +4,9 @@ var react = require('@legendapp/state/react');
 
 // src/config/enableReactComponents.ts
 function enableReactComponents() {
-  const bindInfo = { value: { handler: "onChange", getValue: (e) => e.target.value, defaultValue: "" } };
+  const bindInfo = {
+    value: { handler: "onChange", getValue: (e) => e.target.value, defaultValue: "" }
+  };
   const bindInfoInput = Object.assign(
     { checked: { handler: "onChange", getValue: (e) => e.target.checked } },
     bindInfo

package/config/enableReactComponents.mjs

@@ -2,7 +2,9 @@ import { configureReactive } from '@legendapp/state/react';
 
 // src/config/enableReactComponents.ts
 function enableReactComponents() {
-  const bindInfo = { value: { handler: "onChange", getValue: (e) => e.target.value, defaultValue: "" } };
+  const bindInfo = {
+    value: { handler: "onChange", getValue: (e) => e.target.value, defaultValue: "" }
+  };
   const bindInfoInput = Object.assign(
     { checked: { handler: "onChange", getValue: (e) => e.target.checked } },
     bindInfo

package/config/enableReactTracking.d.mts

@@ -1,7 +1,8 @@
 interface ReactTrackingOptions {
     auto?: boolean;
     warnUnobserved?: boolean;
+    warnMissingUse?: boolean;
 }
-declare function enableReactTracking({ auto, warnUnobserved }: ReactTrackingOptions): void;
+declare function enableReactTracking({ auto, warnUnobserved, warnMissingUse }: ReactTrackingOptions): void;
 
 export { enableReactTracking };

package/config/enableReactTracking.d.ts

@@ -1,7 +1,8 @@
 interface ReactTrackingOptions {
     auto?: boolean;
     warnUnobserved?: boolean;
+    warnMissingUse?: boolean;
 }
-declare function enableReactTracking({ auto, warnUnobserved }: ReactTrackingOptions): void;
+declare function enableReactTracking({ auto, warnUnobserved, warnMissingUse }: ReactTrackingOptions): void;
 
 export { enableReactTracking };

package/config/enableReactTracking.js

@@ -6,32 +6,51 @@ var react$1 = require('@legendapp/state/react');
 var react = require('react');
 
 // src/config/enableReactTracking.ts
-function enableReactTracking({ auto, warnUnobserved }) {
+function enableReactTracking({ auto, warnUnobserved, warnMissingUse }) {
   const { get } = state.internal;
-  if (auto || process.env.NODE_ENV === "development" && warnUnobserved) {
+  if (auto || process.env.NODE_ENV === "development" && (warnUnobserved || warnMissingUse)) {
     const ReactRenderContext = react.createContext(0);
-    const needsSelector = () => {
-      if (!state.tracking.current) {
-        try {
-          const dispatcher = react.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
-          if (dispatcher) {
-            react.useContext(ReactRenderContext);
-            return true;
-          }
-        } catch (e) {
+    const isInRender = () => {
+      try {
+        const dispatcher = react.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
+        if (dispatcher) {
+          react.useContext(ReactRenderContext);
+          return true;
         }
+      } catch (e) {
+      }
+      return false;
+    };
+    const isObserved = () => {
+      return !!state.tracking.current;
+    };
+    const needsSelector = () => {
+      if (!isObserved()) {
+        return isInRender();
       }
       return false;
     };
     configureLegendState.configureLegendState({
       observableFunctions: {
         get: (node, options) => {
-          if (needsSelector()) {
+          if (process.env.NODE_ENV === "development" && warnMissingUse) {
+            if (isInRender()) {
+              if (isObserved()) {
+                console.warn(
+                  "[legend-state] Detected a `get()` call in an observer component. It is recommended to use the `use$` hook instead to be compatible with React Compiler: https://legendapp.com/open-source/state/v3/react/react-api/#use$"
+                );
+              } else {
+                console.warn(
+                  "[legend-state] Detected a `get()` call in a component. You likely want to use the `use$` hook to be reactive to it changing, or change `get()` to `peek()` to get the value without tracking: https://legendapp.com/open-source/state/v3/react/react-api/#use$"
+                );
+              }
+            }
+          } else if (needsSelector()) {
             if (auto) {
               return react$1.useSelector(() => get(node, options), state.isObject(options) ? options : void 0);
             } 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"
+                "[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/v3/react/react-api/#observer"
               );
             }
           }

package/config/enableReactTracking.mjs

@@ -4,32 +4,51 @@ import { useSelector } from '@legendapp/state/react';
 import { createContext, __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED, useContext } from 'react';
 
 // src/config/enableReactTracking.ts
-function enableReactTracking({ auto, warnUnobserved }) {
+function enableReactTracking({ auto, warnUnobserved, warnMissingUse }) {
   const { get } = internal;
-  if (auto || process.env.NODE_ENV === "development" && warnUnobserved) {
+  if (auto || process.env.NODE_ENV === "development" && (warnUnobserved || warnMissingUse)) {
     const ReactRenderContext = createContext(0);
-    const needsSelector = () => {
-      if (!tracking.current) {
-        try {
-          const dispatcher = __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
-          if (dispatcher) {
-            useContext(ReactRenderContext);
-            return true;
-          }
-        } catch (e) {
+    const isInRender = () => {
+      try {
+        const dispatcher = __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentDispatcher.current;
+        if (dispatcher) {
+          useContext(ReactRenderContext);
+          return true;
         }
+      } catch (e) {
+      }
+      return false;
+    };
+    const isObserved = () => {
+      return !!tracking.current;
+    };
+    const needsSelector = () => {
+      if (!isObserved()) {
+        return isInRender();
       }
       return false;
     };
     configureLegendState({
       observableFunctions: {
         get: (node, options) => {
-          if (needsSelector()) {
+          if (process.env.NODE_ENV === "development" && warnMissingUse) {
+            if (isInRender()) {
+              if (isObserved()) {
+                console.warn(
+                  "[legend-state] Detected a `get()` call in an observer component. It is recommended to use the `use$` hook instead to be compatible with React Compiler: https://legendapp.com/open-source/state/v3/react/react-api/#use$"
+                );
+              } else {
+                console.warn(
+                  "[legend-state] Detected a `get()` call in a component. You likely want to use the `use$` hook to be reactive to it changing, or change `get()` to `peek()` to get the value without tracking: https://legendapp.com/open-source/state/v3/react/react-api/#use$"
+                );
+              }
+            }
+          } else if (needsSelector()) {
             if (auto) {
               return useSelector(() => get(node, options), isObject(options) ? options : void 0);
             } 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"
+                "[legend-state] Detected a `get()` call in an unobserved component. You may want to wrap it in observer: https://legendapp.com/open-source/state/v3/react/react-api/#observer"
               );
             }
           }

package/index.d.mts

@@ -1,4 +1,4 @@
-type Primitive$1 = string | number | boolean | symbol | bigint | undefined | null | Date;
+type Primitive$1 = string | number | boolean | symbol | bigint | undefined | null | Date | OpaqueObject<unknown>;
 type ArrayOverrideFnNames = 'find' | 'findIndex' | 'every' | 'some' | 'filter' | 'reduce' | 'reduceRight' | 'forEach' | 'map' | 'sort';
 type RemoveIndex<T> = {
     [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
@@ -7,7 +7,7 @@ type BuiltIns = String | Boolean | Number | Date | Error | RegExp | Array<any> |
 type IsUserDefinedObject<T> = T extends Function | BuiltIns | any[] ? false : T extends object ? true : false;
 type RemoveObservables<T> = T extends ImmutableObservableBase<infer t> ? t : T extends ImmutableObservableBase<infer t>[] ? t[] : IsUserDefinedObject<T> extends true ? {
     [K in keyof T]: RemoveObservables<T[K]>;
-} : T extends ImmutableObservableBase<infer TObs> ? TObs : T extends () => infer TRet ? RemoveObservables<TRet> & T : T extends (key: infer TKey extends string | number) => infer TRet ? Record<TKey, RemoveObservables<TRet>> & T : T;
+} : T extends ImmutableObservableBase<infer TObs> ? TObs : T extends () => infer TRet ? RemoveObservables<TRet> & T : T extends (key: infer TKey extends string | number) => infer TRet ? Record<TKey, RemoveObservables<TRet>> & T : T extends OpaqueObject<infer TObj> ? TObj : T;
 interface ObservableArray<T, U> extends ObservablePrimitive<T>, Pick<Array<Observable<U>>, ArrayOverrideFnNames>, Omit<RemoveIndex<Array<U>>, ArrayOverrideFnNames> {
 }
 interface ObservableObjectFns<T> {
@@ -108,14 +108,17 @@ declare function getNode(value$: ObservableParam): NodeInfo;
 declare function setNodeValue(node: NodeInfo, newValue: any): {
     prevValue: any;
     newValue: any;
+    parentValue: any;
 };
 declare function getNodeValue(node: NodeInfo): any;
+declare function getChildNode(node: NodeInfo, key: string, asFunction?: Function): NodeInfo;
 declare function ensureNodeValue(node: NodeInfo): any;
 declare function findIDKey(obj: unknown | undefined, node: NodeInfo): string | ((value: any) => string) | undefined;
+declare function getKeys(obj: Record<any, any> | Array<any> | undefined, isArr: boolean, isMap: boolean, isSet: boolean): string[];
 
 type TrackingType = undefined | true | symbol;
 interface GetOptions {
-    shallow: boolean;
+    shallow?: boolean;
 }
 type OpaqueObject<T> = T & {
     [symbolOpaque]: true;
@@ -146,12 +149,13 @@ interface Change {
 type RecordValue<T> = T extends Record<string, infer t> ? t : never;
 type ArrayValue<T> = T extends Array<infer t> ? t : never;
 type ObservableValue<T> = T extends Observable<infer t> ? t : never;
-type Selector<T> = ObservableParam<T> | ObservableEvent | (() => T) | T;
+type Selector<T> = ObservableParam<T> | ObservableEvent | (() => ObservableParam<T>) | (() => T) | T;
 type ClassConstructor<I, Args extends any[] = any[]> = new (...args: Args) => I;
 type ObservableListenerDispose = () => void;
 interface ObservableRoot {
     _: any;
     set?: (value: any) => void;
+    isLoadingLocal?: boolean;
 }
 type Primitive = boolean | string | number | Date;
 type NotPrimitive<T> = T extends Primitive ? never : T;
@@ -187,6 +191,7 @@ interface BaseNodeInfo {
     numListenersRecursive: number;
     state?: Observable<ObservableSyncState>;
     activated?: boolean;
+    isPlain?: boolean;
     recursivelyAutoActivated?: boolean;
     activationState?: LinkedOptions & {
         onError?: () => void;
@@ -246,12 +251,20 @@ interface UpdateFnParams<T = any> {
     value: T;
     mode?: GetMode;
     lastSync?: number | undefined;
+    changes?: Change[];
+}
+interface UpdateSetFnParams<T = any> extends UpdateFnParams<T> {
+    lastSync?: never;
 }
 type UpdateFn<T = any> = (params: UpdateFnParams<T>) => void;
+type UpdateSetFn<T = any> = (params: UpdateSetFnParams<T>) => void;
 type Linked<T> = T;
 interface ObserveOptions {
     immediate?: boolean;
 }
+interface ObservableSyncStateOptions {
+    resetLastSync?: boolean;
+}
 interface ObservableSyncStateBase {
     isPersistLoaded: boolean;
     isPersistEnabled: boolean;
@@ -262,7 +275,7 @@ interface ObservableSyncStateBase {
     isSetting?: boolean;
     numPendingGets?: number;
     numPendingSets?: number;
-    sync: () => Promise<void>;
+    sync: (options?: ObservableSyncStateOptions) => Promise<void>;
     getPendingChanges: () => Record<string, {
         p: any;
         v?: any;
@@ -288,12 +301,15 @@ interface RetryOptions {
 declare const ObservableHint: {
     opaque: <T extends object>(value: T) => OpaqueObject<T>;
     plain: <T extends object>(value: T) => PlainObject<T>;
+    function: <T extends object>(value: T) => PlainObject<T>;
 };
 
 declare function getProxy(node: NodeInfo, p?: string, asFunction?: Function): Observable;
 declare function set(node: NodeInfo, newValue?: any): void;
 declare function get(node: NodeInfo, options?: TrackingType | GetOptions): any;
 declare function peek(node: NodeInfo): any;
+declare function deactivateNode(node: NodeInfo): void;
+declare function reactivateNode(node: NodeInfo, lazyFn: Function): void;
 declare function isObserved(node: NodeInfo): boolean;
 declare function shouldIgnoreUnobserved(node: NodeInfo, refreshFn: () => void): true | undefined;
 
@@ -307,7 +323,7 @@ declare function computed<T, T2 = T>(get: (() => RecursiveValueOrFunction<T>) |
 
 declare function event(): ObservableEvent;
 
-declare function computeSelector<T>(selector: Selector<T>, e?: ObserveEvent<T>, retainObservable?: boolean): T;
+declare function computeSelector<T>(selector: Selector<T>, getOptions?: GetOptions, e?: ObserveEvent<T>, retainObservable?: boolean): T;
 declare function getObservableIndex(value$: ObservableParam): number;
 declare function opaqueObject<T extends object>(value: T): OpaqueObject<T>;
 declare function getValueAtPath(obj: Record<string, any>, path: string[]): any;
@@ -357,7 +373,7 @@ declare function proxy<T>(get: (key: string) => T): Observable<Record<string, T>
 
 declare function syncState(obs: ObservableParam): Observable<ObservableSyncState>;
 
-declare function trackSelector<T>(selector: Selector<T>, update: (params: ListenerParams) => void, observeEvent?: ObserveEvent<T>, observeOptions?: ObserveOptions, createResubscribe?: boolean): {
+declare function trackSelector<T>(selector: Selector<T>, update: (params: ListenerParams) => void, getOptions?: GetOptions, observeEvent?: ObserveEvent<T>, observeOptions?: ObserveOptions, createResubscribe?: boolean): {
     nodes: Map<NodeInfo, TrackingNode> | undefined;
     value: T;
     dispose: (() => void) | undefined;
@@ -381,13 +397,33 @@ interface ObservablePrimitiveState {
 }
 declare function ObservablePrimitiveClass<T>(this: ObservablePrimitive<T> & ObservablePrimitiveState, node: NodeInfo): void;
 
+type MiddlewareEventType = 'listener-added' | 'listener-removed' | 'listeners-cleared';
+interface MiddlewareEvent {
+    type: MiddlewareEventType;
+    node: NodeInfo;
+    listener?: NodeListener;
+    timestamp: number;
+}
+type MiddlewareHandler = (event: MiddlewareEvent) => void;
+/**
+ * Register a middleware handler for a specific node and event type
+ * @param node The node to register the middleware handler for
+ * @param type The event type to handle
+ * @param handler The middleware handler function
+ * @returns A function to remove the handler
+ */
+declare function registerMiddleware(node: NodeInfo, type: MiddlewareEventType, handler: MiddlewareHandler): () => void;
+
 declare const internal: {
     createPreviousHandler: typeof createPreviousHandler;
     clone: typeof clone;
+    deactivateNode: typeof deactivateNode;
     deepMerge: typeof deepMerge;
     ensureNodeValue: typeof ensureNodeValue;
     findIDKey: typeof findIDKey;
     get: typeof get;
+    getChildNode: typeof getChildNode;
+    getKeys: typeof getKeys;
     getNode: typeof getNode;
     getNodeValue: typeof getNodeValue;
     getPathType: typeof getPathType;
@@ -414,6 +450,8 @@ declare const internal: {
     observableFns: Map<string, (node: NodeInfo, ...args: any[]) => any>;
     optimized: symbol;
     peek: typeof peek;
+    reactivateNode: typeof reactivateNode;
+    registerMiddleware: typeof registerMiddleware;
     safeParse: typeof safeParse;
     safeStringify: typeof safeStringify;
     set: typeof set;
@@ -426,4 +464,4 @@ declare const internal: {
     };
 };
 
-export { type ArrayValue, type Change, type ChildNodeInfo, type ClassConstructor, type GetMode, type GetOptions, type ImmutableObservableBase, type Linked, type LinkedOptions, type ListenerFn, type ListenerParams, type NodeInfo, type NodeListener, type NotPrimitive, type Observable, type ObservableBoolean, type ObservableEvent, ObservableHint, type ObservableListenerDispose, type ObservableMap, type ObservableObject, type ObservableObjectFns, type ObservableParam, type ObservablePrimitive, type ObservableRoot, type ObservableState, type ObservableSyncState, type ObservableSyncStateBase, type ObservableValue, type ObserveEvent, type ObserveEventCallback, type ObserveOptions, type OpaqueObject, type PlainObject, type Primitive, type RecordValue, type RecursiveValueOrFunction, type RemoveObservables, type RetryOptions, type RootNodeInfo, type Selector, type SetParams, type TrackingNode, type TrackingState, type TrackingType, type TypeAtPath, type UpdateFn, type UpdateFnParams, type WaitForSet, type WaitForSetFnParams, applyChange, applyChanges, batch, beginBatch, computeSelector, computed, constructObjectWithPath, deconstructObjectWithPath, endBatch, event, getObservableIndex, hasOwnProperty, internal, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNullOrUndefined, isNumber, isObject, isObservable, isObservableValueReady, isObserved, isPlainObject, isPrimitive, isPromise, isSet, isString, isSymbol, linked, mergeIntoObservable, observable, observablePrimitive, observe, opaqueObject, proxy, setAtPath, setSilently, shouldIgnoreUnobserved, syncState, trackSelector, when, whenReady };
+export { type ArrayValue, type Change, type ChildNodeInfo, type ClassConstructor, type GetMode, type GetOptions, type ImmutableObservableBase, type Linked, type LinkedOptions, type ListenerFn, type ListenerParams, type NodeInfo, type NodeListener, type NotPrimitive, type Observable, type ObservableBoolean, type ObservableEvent, ObservableHint, type ObservableListenerDispose, type ObservableMap, type ObservableObject, type ObservableObjectFns, type ObservableParam, type ObservablePrimitive, type ObservableRoot, type ObservableState, type ObservableSyncState, type ObservableSyncStateBase, type ObservableSyncStateOptions, type ObservableValue, type ObserveEvent, type ObserveEventCallback, type ObserveOptions, type OpaqueObject, type PlainObject, type Primitive, type RecordValue, type RecursiveValueOrFunction, type RemoveObservables, type RetryOptions, type RootNodeInfo, type Selector, type SetParams, type TrackingNode, type TrackingState, type TrackingType, type TypeAtPath, type UpdateFn, type UpdateFnParams, type UpdateSetFn, type UpdateSetFnParams, type WaitForSet, type WaitForSetFnParams, applyChange, applyChanges, batch, beginBatch, computeSelector, computed, constructObjectWithPath, deconstructObjectWithPath, endBatch, event, getObservableIndex, hasOwnProperty, internal, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNullOrUndefined, isNumber, isObject, isObservable, isObservableValueReady, isObserved, isPlainObject, isPrimitive, isPromise, isSet, isString, isSymbol, linked, mergeIntoObservable, observable, observablePrimitive, observe, opaqueObject, proxy, setAtPath, setSilently, shouldIgnoreUnobserved, syncState, trackSelector, when, whenReady };

package/index.d.ts

@@ -1,4 +1,4 @@
-type Primitive$1 = string | number | boolean | symbol | bigint | undefined | null | Date;
+type Primitive$1 = string | number | boolean | symbol | bigint | undefined | null | Date | OpaqueObject<unknown>;
 type ArrayOverrideFnNames = 'find' | 'findIndex' | 'every' | 'some' | 'filter' | 'reduce' | 'reduceRight' | 'forEach' | 'map' | 'sort';
 type RemoveIndex<T> = {
     [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
@@ -7,7 +7,7 @@ type BuiltIns = String | Boolean | Number | Date | Error | RegExp | Array<any> |
 type IsUserDefinedObject<T> = T extends Function | BuiltIns | any[] ? false : T extends object ? true : false;
 type RemoveObservables<T> = T extends ImmutableObservableBase<infer t> ? t : T extends ImmutableObservableBase<infer t>[] ? t[] : IsUserDefinedObject<T> extends true ? {
     [K in keyof T]: RemoveObservables<T[K]>;
-} : T extends ImmutableObservableBase<infer TObs> ? TObs : T extends () => infer TRet ? RemoveObservables<TRet> & T : T extends (key: infer TKey extends string | number) => infer TRet ? Record<TKey, RemoveObservables<TRet>> & T : T;
+} : T extends ImmutableObservableBase<infer TObs> ? TObs : T extends () => infer TRet ? RemoveObservables<TRet> & T : T extends (key: infer TKey extends string | number) => infer TRet ? Record<TKey, RemoveObservables<TRet>> & T : T extends OpaqueObject<infer TObj> ? TObj : T;
 interface ObservableArray<T, U> extends ObservablePrimitive<T>, Pick<Array<Observable<U>>, ArrayOverrideFnNames>, Omit<RemoveIndex<Array<U>>, ArrayOverrideFnNames> {
 }
 interface ObservableObjectFns<T> {
@@ -108,14 +108,17 @@ declare function getNode(value$: ObservableParam): NodeInfo;
 declare function setNodeValue(node: NodeInfo, newValue: any): {
     prevValue: any;
     newValue: any;
+    parentValue: any;
 };
 declare function getNodeValue(node: NodeInfo): any;
+declare function getChildNode(node: NodeInfo, key: string, asFunction?: Function): NodeInfo;
 declare function ensureNodeValue(node: NodeInfo): any;
 declare function findIDKey(obj: unknown | undefined, node: NodeInfo): string | ((value: any) => string) | undefined;
+declare function getKeys(obj: Record<any, any> | Array<any> | undefined, isArr: boolean, isMap: boolean, isSet: boolean): string[];
 
 type TrackingType = undefined | true | symbol;
 interface GetOptions {
-    shallow: boolean;
+    shallow?: boolean;
 }
 type OpaqueObject<T> = T & {
     [symbolOpaque]: true;
@@ -146,12 +149,13 @@ interface Change {
 type RecordValue<T> = T extends Record<string, infer t> ? t : never;
 type ArrayValue<T> = T extends Array<infer t> ? t : never;
 type ObservableValue<T> = T extends Observable<infer t> ? t : never;
-type Selector<T> = ObservableParam<T> | ObservableEvent | (() => T) | T;
+type Selector<T> = ObservableParam<T> | ObservableEvent | (() => ObservableParam<T>) | (() => T) | T;
 type ClassConstructor<I, Args extends any[] = any[]> = new (...args: Args) => I;
 type ObservableListenerDispose = () => void;
 interface ObservableRoot {
     _: any;
     set?: (value: any) => void;
+    isLoadingLocal?: boolean;
 }
 type Primitive = boolean | string | number | Date;
 type NotPrimitive<T> = T extends Primitive ? never : T;
@@ -187,6 +191,7 @@ interface BaseNodeInfo {
     numListenersRecursive: number;
     state?: Observable<ObservableSyncState>;
     activated?: boolean;
+    isPlain?: boolean;
     recursivelyAutoActivated?: boolean;
     activationState?: LinkedOptions & {
         onError?: () => void;
@@ -246,12 +251,20 @@ interface UpdateFnParams<T = any> {
     value: T;
     mode?: GetMode;
     lastSync?: number | undefined;
+    changes?: Change[];
+}
+interface UpdateSetFnParams<T = any> extends UpdateFnParams<T> {
+    lastSync?: never;
 }
 type UpdateFn<T = any> = (params: UpdateFnParams<T>) => void;
+type UpdateSetFn<T = any> = (params: UpdateSetFnParams<T>) => void;
 type Linked<T> = T;
 interface ObserveOptions {
     immediate?: boolean;
 }
+interface ObservableSyncStateOptions {
+    resetLastSync?: boolean;
+}
 interface ObservableSyncStateBase {
     isPersistLoaded: boolean;
     isPersistEnabled: boolean;
@@ -262,7 +275,7 @@ interface ObservableSyncStateBase {
     isSetting?: boolean;
     numPendingGets?: number;
     numPendingSets?: number;
-    sync: () => Promise<void>;
+    sync: (options?: ObservableSyncStateOptions) => Promise<void>;
     getPendingChanges: () => Record<string, {
         p: any;
         v?: any;
@@ -288,12 +301,15 @@ interface RetryOptions {
 declare const ObservableHint: {
     opaque: <T extends object>(value: T) => OpaqueObject<T>;
     plain: <T extends object>(value: T) => PlainObject<T>;
+    function: <T extends object>(value: T) => PlainObject<T>;
 };
 
 declare function getProxy(node: NodeInfo, p?: string, asFunction?: Function): Observable;
 declare function set(node: NodeInfo, newValue?: any): void;
 declare function get(node: NodeInfo, options?: TrackingType | GetOptions): any;
 declare function peek(node: NodeInfo): any;
+declare function deactivateNode(node: NodeInfo): void;
+declare function reactivateNode(node: NodeInfo, lazyFn: Function): void;
 declare function isObserved(node: NodeInfo): boolean;
 declare function shouldIgnoreUnobserved(node: NodeInfo, refreshFn: () => void): true | undefined;
 
@@ -307,7 +323,7 @@ declare function computed<T, T2 = T>(get: (() => RecursiveValueOrFunction<T>) |
 
 declare function event(): ObservableEvent;
 
-declare function computeSelector<T>(selector: Selector<T>, e?: ObserveEvent<T>, retainObservable?: boolean): T;
+declare function computeSelector<T>(selector: Selector<T>, getOptions?: GetOptions, e?: ObserveEvent<T>, retainObservable?: boolean): T;
 declare function getObservableIndex(value$: ObservableParam): number;
 declare function opaqueObject<T extends object>(value: T): OpaqueObject<T>;
 declare function getValueAtPath(obj: Record<string, any>, path: string[]): any;
@@ -357,7 +373,7 @@ declare function proxy<T>(get: (key: string) => T): Observable<Record<string, T>
 
 declare function syncState(obs: ObservableParam): Observable<ObservableSyncState>;
 
-declare function trackSelector<T>(selector: Selector<T>, update: (params: ListenerParams) => void, observeEvent?: ObserveEvent<T>, observeOptions?: ObserveOptions, createResubscribe?: boolean): {
+declare function trackSelector<T>(selector: Selector<T>, update: (params: ListenerParams) => void, getOptions?: GetOptions, observeEvent?: ObserveEvent<T>, observeOptions?: ObserveOptions, createResubscribe?: boolean): {
     nodes: Map<NodeInfo, TrackingNode> | undefined;
     value: T;
     dispose: (() => void) | undefined;
@@ -381,13 +397,33 @@ interface ObservablePrimitiveState {
 }
 declare function ObservablePrimitiveClass<T>(this: ObservablePrimitive<T> & ObservablePrimitiveState, node: NodeInfo): void;
 
+type MiddlewareEventType = 'listener-added' | 'listener-removed' | 'listeners-cleared';
+interface MiddlewareEvent {
+    type: MiddlewareEventType;
+    node: NodeInfo;
+    listener?: NodeListener;
+    timestamp: number;
+}
+type MiddlewareHandler = (event: MiddlewareEvent) => void;
+/**
+ * Register a middleware handler for a specific node and event type
+ * @param node The node to register the middleware handler for
+ * @param type The event type to handle
+ * @param handler The middleware handler function
+ * @returns A function to remove the handler
+ */
+declare function registerMiddleware(node: NodeInfo, type: MiddlewareEventType, handler: MiddlewareHandler): () => void;
+
 declare const internal: {
     createPreviousHandler: typeof createPreviousHandler;
     clone: typeof clone;
+    deactivateNode: typeof deactivateNode;
     deepMerge: typeof deepMerge;
     ensureNodeValue: typeof ensureNodeValue;
     findIDKey: typeof findIDKey;
     get: typeof get;
+    getChildNode: typeof getChildNode;
+    getKeys: typeof getKeys;
     getNode: typeof getNode;
     getNodeValue: typeof getNodeValue;
     getPathType: typeof getPathType;
@@ -414,6 +450,8 @@ declare const internal: {
     observableFns: Map<string, (node: NodeInfo, ...args: any[]) => any>;
     optimized: symbol;
     peek: typeof peek;
+    reactivateNode: typeof reactivateNode;
+    registerMiddleware: typeof registerMiddleware;
     safeParse: typeof safeParse;
     safeStringify: typeof safeStringify;
     set: typeof set;
@@ -426,4 +464,4 @@ declare const internal: {
     };
 };
 
-export { type ArrayValue, type Change, type ChildNodeInfo, type ClassConstructor, type GetMode, type GetOptions, type ImmutableObservableBase, type Linked, type LinkedOptions, type ListenerFn, type ListenerParams, type NodeInfo, type NodeListener, type NotPrimitive, type Observable, type ObservableBoolean, type ObservableEvent, ObservableHint, type ObservableListenerDispose, type ObservableMap, type ObservableObject, type ObservableObjectFns, type ObservableParam, type ObservablePrimitive, type ObservableRoot, type ObservableState, type ObservableSyncState, type ObservableSyncStateBase, type ObservableValue, type ObserveEvent, type ObserveEventCallback, type ObserveOptions, type OpaqueObject, type PlainObject, type Primitive, type RecordValue, type RecursiveValueOrFunction, type RemoveObservables, type RetryOptions, type RootNodeInfo, type Selector, type SetParams, type TrackingNode, type TrackingState, type TrackingType, type TypeAtPath, type UpdateFn, type UpdateFnParams, type WaitForSet, type WaitForSetFnParams, applyChange, applyChanges, batch, beginBatch, computeSelector, computed, constructObjectWithPath, deconstructObjectWithPath, endBatch, event, getObservableIndex, hasOwnProperty, internal, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNullOrUndefined, isNumber, isObject, isObservable, isObservableValueReady, isObserved, isPlainObject, isPrimitive, isPromise, isSet, isString, isSymbol, linked, mergeIntoObservable, observable, observablePrimitive, observe, opaqueObject, proxy, setAtPath, setSilently, shouldIgnoreUnobserved, syncState, trackSelector, when, whenReady };
+export { type ArrayValue, type Change, type ChildNodeInfo, type ClassConstructor, type GetMode, type GetOptions, type ImmutableObservableBase, type Linked, type LinkedOptions, type ListenerFn, type ListenerParams, type NodeInfo, type NodeListener, type NotPrimitive, type Observable, type ObservableBoolean, type ObservableEvent, ObservableHint, type ObservableListenerDispose, type ObservableMap, type ObservableObject, type ObservableObjectFns, type ObservableParam, type ObservablePrimitive, type ObservableRoot, type ObservableState, type ObservableSyncState, type ObservableSyncStateBase, type ObservableSyncStateOptions, type ObservableValue, type ObserveEvent, type ObserveEventCallback, type ObserveOptions, type OpaqueObject, type PlainObject, type Primitive, type RecordValue, type RecursiveValueOrFunction, type RemoveObservables, type RetryOptions, type RootNodeInfo, type Selector, type SetParams, type TrackingNode, type TrackingState, type TrackingType, type TypeAtPath, type UpdateFn, type UpdateFnParams, type UpdateSetFn, type UpdateSetFnParams, type WaitForSet, type WaitForSetFnParams, applyChange, applyChanges, batch, beginBatch, computeSelector, computed, constructObjectWithPath, deconstructObjectWithPath, endBatch, event, getObservableIndex, hasOwnProperty, internal, isArray, isBoolean, isDate, isEmpty, isFunction, isMap, isNullOrUndefined, isNumber, isObject, isObservable, isObservableValueReady, isObserved, isPlainObject, isPrimitive, isPromise, isSet, isString, isSymbol, linked, mergeIntoObservable, observable, observablePrimitive, observe, opaqueObject, proxy, setAtPath, setSilently, shouldIgnoreUnobserved, syncState, trackSelector, when, whenReady };