@sladg/apex-state 3.11.2 → 3.11.4

package/dist/index.d.ts

@@ -509,7 +509,7 @@ type ConcernRegistrationMap<DATA extends object, CONCERNS extends readonly any[]
  * 1. `{ path: string, fn }` — scope defaults to path → scoped state
  * 2. `{ path: string, scope: null, fn }` — explicit null scope → full DATA
  * 3. `{ path: string, scope: string, fn }` — scope must be prefix of path
- * 4. `{ path: null, fn }` — watch everything, scope defaults to null → full DATA
+ * 4. `{ path: null, fn }` — always fires on any change, scope defaults to null → full DATA
  * 5. `{ path: null, scope: null, fn }` — same as above, explicit
  *
  * **Inline fn restriction**: Fns with untyped (any) parameters are rejected.
@@ -928,6 +928,17 @@ interface PipelineObserver {
     concernEval: (path: string, name: string, value: unknown, result: unknown) => void;
     destroy: () => void;
 }
+interface DevToolsInstance {
+    init: (state: unknown) => void;
+    send: (action: {
+        type: string;
+    }, state: unknown) => void;
+    unsubscribe: () => void;
+}
+interface DevToolsRef {
+    prefix: string;
+    pipeline: DevToolsInstance | null;
+}
 
 /**
  * Debug Timing Utilities
@@ -1221,6 +1232,8 @@ interface DebugTrack {
     clear: () => void;
 }
 interface StoreConfig {
+    /** Human-readable store name for DevTools (default: "store"). Auto-incremented ID is appended. */
+    name?: string;
     /** Error storage path (default: "_errors") */
     errorStorePath?: string;
     /** Max iterations for change processing (default: 100) */
@@ -1281,12 +1294,22 @@ type OnStateListener<DATA extends object = object, SUB_STATE = DATA, META extend
  *     // state: p.123.g.abc object
  *   }
  * }
+ *
+ * // Watch ALL changes (always fires), get full state
+ * {
+ *   path: null,
+ *   scope: null,
+ *   fn: (changes, state) => {
+ *     // changes: [['user.profile.name', 'Alice', {}], ['count', 5, {}]] - FULL paths, all depths
+ *     // state: full DATA object
+ *   }
+ * }
  * ```
  */
 interface ListenerRegistration<DATA extends object = object, META extends GenericMeta = GenericMeta, Depth extends number = DefaultDepth> {
     /**
      * Path to watch - only changes under this path will trigger the listener
-     * null = watch all top-level paths
+     * null = watch all paths (receives every change)
      */
     path: DeepKey<DATA, Depth> | null;
     /**
@@ -1329,6 +1352,8 @@ interface InternalState<DATA extends object = object, META extends GenericMeta =
     timing: Timing;
     observer: PipelineObserver;
     config: DeepRequired<StoreConfig>;
+    /** Redux DevTools state — prefix for naming + shared connection instance. */
+    _devtools: DevToolsRef;
     /** Per-store WASM pipeline instance (null when using legacy implementation). */
     pipeline: WasmPipeline | null;
     /** Pending deferred destroy timer — cancelled on StrictMode re-mount. */
@@ -1622,6 +1647,15 @@ type ClearPathRule<DATA extends object, Depth extends number = DefaultDepth> = [
  *         // state: p.123.g.abc object
  *         return [['data.computed', computed, {}]]  // SCOPED path (relative to scope)
  *       }
+ *     },
+ *     {
+ *       path: null,   // Always fires — receives ALL changes at any depth
+ *       scope: null,  // Get full state
+ *       fn: (changes, state) => {
+ *         // changes: [['user.profile.name', 'Alice', {}]]  // FULL paths, all depths
+ *         // state: full DATA object
+ *         return undefined
+ *       }
  *     }
  *   ]
  * })