@bquery/bquery 1.2.0 → 1.4.0

package/dist/store/index.d.ts

@@ -1,288 +1,12 @@
 /**
- * Minimal state management built on signals.
- *
- * This module provides a lightweight store pattern inspired by Pinia/Vuex
- * but built entirely on bQuery's reactive primitives. Features include:
- * - Signal-based reactive state
- * - Computed getters
- * - Actions with async support
- * - Devtools hooks for debugging
- * - Plugin system for extensions
- *
- * @module bquery/store
- *
- * @example
- * ```ts
- * import { createStore } from 'bquery/store';
- * import { effect } from 'bquery/reactive';
- *
- * const counterStore = createStore({
- *   id: 'counter',
- *   state: () => ({ count: 0 }),
- *   getters: {
- *     doubled: (state) => state.count * 2,
- *     isPositive: (state) => state.count > 0,
- *   },
- *   actions: {
- *     increment() {
- *       this.count++;
- *     },
- *     async fetchAndSet(url: string) {
- *       const response = await fetch(url);
- *       const data = await response.json();
- *       this.count = data.count;
- *     },
- *   },
- * });
- *
- * effect(() => {
- *   console.log('Count:', counterStore.count);
- *   console.log('Doubled:', counterStore.doubled);
- * });
- *
- * counterStore.increment();
- * ```
- */
-/**
- * Store state factory function.
- */
-export type StateFactory<S> = () => S;
-/**
- * Getter definition - derives computed values from state.
- */
-export type Getters<S, G> = {
-    [K in keyof G]: (state: S, getters: G) => G[K];
-};
-/**
- * Action definition - methods that can modify state.
- */
-export type Actions<S, A> = {
-    [K in keyof A]: A[K] extends (...args: infer P) => infer R ? (this: S & A, ...args: P) => R : never;
-};
-/**
- * Store definition for createStore.
- */
-export type StoreDefinition<S extends Record<string, unknown> = Record<string, unknown>, G extends Record<string, unknown> = Record<string, unknown>, A extends Record<string, (...args: any[]) => any> = Record<string, never>> = {
-    /** Unique store identifier for devtools */
-    id: string;
-    /** State factory function */
-    state: StateFactory<S>;
-    /** Computed getters */
-    getters?: Getters<S, G>;
-    /** Action methods */
-    actions?: A;
-};
-/**
- * The returned store instance with state, getters, and actions merged.
- */
-export type Store<S extends Record<string, unknown>, G extends Record<string, unknown>, A extends Record<string, (...args: any[]) => any>> = S & G & A & {
-    /** Store identifier */
-    $id: string;
-    /** Reset state to initial values */
-    $reset: () => void;
-    /** Subscribe to state changes */
-    $subscribe: (callback: (state: S) => void) => () => void;
-    /** Patch multiple state properties at once (shallow) */
-    $patch: (partial: Partial<S> | ((state: S) => void)) => void;
-    /**
-     * Patch with deep reactivity support.
-     * Unlike $patch, this method deep-clones nested objects before mutation,
-     * ensuring that all changes trigger reactive updates.
-     */
-    $patchDeep: (partial: Partial<S> | ((state: S) => void)) => void;
-    /** Get raw state object (non-reactive snapshot) */
-    $state: S;
-};
-/**
- * Plugin that can extend store functionality.
- */
-export type StorePlugin<S = unknown> = (context: {
-    store: Store<any, any, any>;
-    options: StoreDefinition<any, any, any>;
-}) => Partial<S> | void;
-/** @internal Devtools hook */
-declare global {
-    interface Window {
-        __BQUERY_DEVTOOLS__?: {
-            stores: Map<string, unknown>;
-            onStoreCreated?: (id: string, store: unknown) => void;
-            onStateChange?: (id: string, state: unknown) => void;
-        };
-    }
-}
-/**
- * Creates a reactive store with state, getters, and actions.
- *
- * @template S - State type
- * @template G - Getters type
- * @template A - Actions type
- * @param definition - Store definition
- * @returns The reactive store instance
- *
- * @example
- * ```ts
- * import { createStore } from 'bquery/store';
- *
- * // Simple counter store
- * const useCounter = createStore({
- *   id: 'counter',
- *   state: () => ({ count: 0, step: 1 }),
- *   getters: {
- *     doubled: (state) => state.count * 2,
- *     next: (state) => state.count + state.step,
- *   },
- *   actions: {
- *     increment() {
- *       this.count += this.step;
- *     },
- *     decrement() {
- *       this.count -= this.step;
- *     },
- *     setStep(newStep: number) {
- *       this.step = newStep;
- *     },
- *     async loadFromServer() {
- *       const res = await fetch('/api/counter');
- *       const data = await res.json();
- *       this.count = data.count;
- *     },
- *   },
- * });
- *
- * // Use the store
- * useCounter.increment();
- * console.log(useCounter.count); // 1
- * console.log(useCounter.doubled); // 2
- * ```
- */
-export declare const createStore: <S extends Record<string, unknown>, G extends Record<string, unknown> = Record<string, never>, A extends Record<string, (...args: any[]) => any> = Record<string, never>>(definition: StoreDefinition<S, G, A>) => Store<S, G, A>;
-/**
- * Retrieves an existing store by its ID.
- *
- * @param id - The store identifier
- * @returns The store instance or undefined if not found
- *
- * @example
- * ```ts
- * import { getStore } from 'bquery/store';
- *
- * const counter = getStore('counter');
- * if (counter) {
- *   counter.increment();
- * }
- * ```
- */
-export declare const getStore: <T = unknown>(id: string) => T | undefined;
-/**
- * Lists all registered store IDs.
- *
- * @returns Array of store IDs
- *
- * @example
- * ```ts
- * import { listStores } from 'bquery/store';
- *
- * console.log('Active stores:', listStores());
- * ```
- */
-export declare const listStores: () => string[];
-/**
- * Removes a store from the registry.
- *
- * @param id - The store identifier
- *
- * @example
- * ```ts
- * import { destroyStore } from 'bquery/store';
- *
- * destroyStore('counter');
- * ```
- */
-export declare const destroyStore: (id: string) => void;
-/**
- * Registers a plugin that extends all stores.
- *
- * @param plugin - The plugin function
- *
- * @example
- * ```ts
- * import { registerPlugin } from 'bquery/store';
- *
- * // Add localStorage persistence
- * registerPlugin(({ store, options }) => {
- *   const key = `bquery-store-${options.id}`;
- *
- *   // Load saved state
- *   const saved = localStorage.getItem(key);
- *   if (saved) {
- *     store.$patch(JSON.parse(saved));
- *   }
- *
- *   // Save on changes
- *   store.$subscribe((state) => {
- *     localStorage.setItem(key, JSON.stringify(state));
- *   });
- * });
- * ```
- */
-export declare const registerPlugin: (plugin: StorePlugin) => void;
-/**
- * Creates a store with automatic persistence to localStorage.
- *
- * @param definition - Store definition
- * @param storageKey - Optional custom storage key
- * @returns The reactive store instance
- *
- * @example
- * ```ts
- * import { createPersistedStore } from 'bquery/store';
- *
- * const settings = createPersistedStore({
- *   id: 'settings',
- *   state: () => ({
- *     theme: 'dark',
- *     language: 'en',
- *   }),
- * });
- *
- * // State is automatically saved/loaded from localStorage
- * settings.theme = 'light';
- * ```
- */
-export declare const createPersistedStore: <S extends Record<string, unknown>, G extends Record<string, unknown> = Record<string, never>, A extends Record<string, (...args: unknown[]) => unknown> = Record<string, never>>(definition: StoreDefinition<S, G, A>, storageKey?: string) => Store<S, G, A>;
-/**
- * Maps store state properties to a reactive object for use in components.
- *
- * @param store - The store instance
- * @param keys - State keys to map
- * @returns Object with mapped properties
- *
- * @example
- * ```ts
- * import { mapState } from 'bquery/store';
- *
- * const counter = useCounter();
- * const { count, step } = mapState(counter, ['count', 'step']);
- * ```
- */
-export declare const mapState: <S extends Record<string, unknown>, K extends keyof S>(store: S, keys: K[]) => Pick<S, K>;
-/**
- * Maps store actions to an object for easier destructuring.
- *
- * @param store - The store instance
- * @param keys - Action keys to map
- * @returns Object with mapped actions
- *
- * @example
- * ```ts
- * import { mapActions } from 'bquery/store';
- *
- * const counter = useCounter();
- * const { increment, decrement } = mapActions(counter, ['increment', 'decrement']);
- *
- * // Use directly
- * increment();
- * ```
- */
-export declare const mapActions: <A extends Record<string, (...args: unknown[]) => unknown>, K extends keyof A>(store: A, keys: K[]) => Pick<A, K>;
+ * Store module exports.
+ */
+export type { Actions, Getters, StateFactory, Store, StoreDefinition, StorePatch, StorePlugin, StoreSubscriber, } from './types';
+export { createStore } from './create-store';
+export { defineStore } from './define-store';
+export { mapActions, mapGetters, mapState } from './mapping';
+export { createPersistedStore } from './persisted';
+export { registerPlugin } from './plugins';
+export { destroyStore, getStore, listStores } from './registry';
+export { watchStore } from './watch';
 //# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,OAAO,EACP,OAAO,EACP,YAAY,EACZ,KAAK,EACL,eAAe,EACf,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/store/mapping.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Mapping helpers for store state and actions.
+ */
+/**
+ * Maps store state properties to a reactive object for use in components.
+ *
+ * @param store - The store instance
+ * @param keys - State keys to map
+ * @returns Object with mapped properties
+ */
+export declare const mapState: <S extends Record<string, unknown>, K extends keyof S>(store: S, keys: K[]) => Pick<S, K>;
+/**
+ * Maps store getters to a reactive object for use in components.
+ *
+ * @param store - The store instance
+ * @param keys - Getter keys to map
+ * @returns Object with mapped getters
+ */
+export declare const mapGetters: <G extends Record<string, unknown>, K extends keyof G>(store: G, keys: K[]) => Pick<G, K>;
+/**
+ * Maps store actions to an object for easier destructuring.
+ *
+ * @param store - The store instance
+ * @param keys - Action keys to map
+ * @returns Object with mapped actions
+ */
+export declare const mapActions: <A extends Record<string, (...args: unknown[]) => unknown>, K extends keyof A>(store: A, keys: K[]) => Pick<A, K>;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/store/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/store/mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAC3E,OAAO,CAAC,EACR,MAAM,CAAC,EAAE,KACR,IAAI,CAAC,CAAC,EAAE,CAAC,CAWX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAC7E,OAAO,CAAC,EACR,MAAM,CAAC,EAAE,KACR,IAAI,CAAC,CAAC,EAAE,CAAC,CAWX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,EAEjB,OAAO,CAAC,EACR,MAAM,CAAC,EAAE,KACR,IAAI,CAAC,CAAC,EAAE,CAAC,CASX,CAAC"}

package/dist/store/persisted.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Store persistence helpers.
+ */
+import type { Store, StoreDefinition } from './types';
+/**
+ * Creates a store with automatic persistence to localStorage.
+ *
+ * @param definition - Store definition
+ * @param storageKey - Optional custom storage key
+ * @returns The reactive store instance
+ */
+export declare const createPersistedStore: <S extends Record<string, unknown>, G extends Record<string, unknown> = Record<string, never>, A extends Record<string, (...args: unknown[]) => unknown> = Record<string, never>>(definition: StoreDefinition<S, G, A>, storageKey?: string) => Store<S, G, A>;
+//# sourceMappingURL=persisted.d.ts.map

package/dist/store/persisted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/store/persisted.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEjF,YAAY,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACpC,aAAa,MAAM,KAClB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAuCf,CAAC"}

package/dist/store/plugins.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Store plugins API.
+ */
+import type { Store, StoreDefinition, StorePlugin } from './types';
+/**
+ * Registers a plugin that extends all stores.
+ *
+ * @param plugin - The plugin function
+ */
+export declare const registerPlugin: (plugin: StorePlugin) => void;
+/** @internal */
+export declare const applyPlugins: (store: Store<any, any, any>, options: StoreDefinition<any, any, any>) => void;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/store/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/store/plugins.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKnE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,WAAW,KAAG,IAEpD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,YAAY,GAEvB,OAAO,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAE3B,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,KACtC,IAOF,CAAC"}

package/dist/store/registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Store registry utilities.
+ */
+import type { Store } from './types';
+/** @internal */
+export declare const hasStore: (id: string) => boolean;
+/** @internal */
+export declare const registerStore: (id: string, store: Store<any, any, any>) => void;
+/**
+ * Retrieves an existing store by its ID.
+ *
+ * @param id - The store identifier
+ * @returns The store instance or undefined if not found
+ */
+export declare const getStore: <T = unknown>(id: string) => T | undefined;
+/**
+ * Lists all registered store IDs.
+ *
+ * @returns Array of store IDs
+ */
+export declare const listStores: () => string[];
+/**
+ * Removes a store from the registry.
+ *
+ * @param id - The store identifier
+ */
+export declare const destroyStore: (id: string) => void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/store/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/store/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrC,gBAAgB;AAChB,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAAgC,CAAC;AAEvE,gBAAgB;AAChB,eAAO,MAAM,aAAa,GACxB,IAAI,MAAM,EAEV,OAAO,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,KAC1B,IAEF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO,EAAE,IAAI,MAAM,KAAG,CAAC,GAAG,SAEtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAAM,EAEnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,KAAG,IAGzC,CAAC"}

package/dist/store/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Store types for bQuery's state module.
+ * @module bquery/store
+ */
+/**
+ * Store state factory function.
+ */
+export type StateFactory<S> = () => S;
+/**
+ * Getter definition - derives computed values from state.
+ */
+export type Getters<S, G> = {
+    [K in keyof G]: (state: S, getters: G) => G[K];
+};
+/**
+ * Action definition - methods that can modify state.
+ * The `this` context includes state, getters, and other actions.
+ */
+export type Actions<S, G, A> = {
+    [K in keyof A]: A[K] extends (...args: infer P) => infer R ? (this: S & G & A, ...args: P) => R : never;
+};
+/**
+ * Store definition for createStore.
+ */
+export type StoreDefinition<S extends Record<string, unknown> = Record<string, unknown>, G extends Record<string, unknown> = Record<string, unknown>, A extends Record<string, (...args: any[]) => any> = Record<string, never>> = {
+    /** Unique store identifier for devtools */
+    id: string;
+    /** State factory function */
+    state: StateFactory<S>;
+    /** Computed getters */
+    getters?: Getters<S, G>;
+    /** Action methods */
+    actions?: Actions<S, G, A>;
+};
+/**
+ * Store subscriber callback.
+ */
+export type StoreSubscriber<S> = (state: S) => void;
+/**
+ * Patch payload for store updates.
+ */
+export type StorePatch<S> = Partial<S> | ((state: S) => void);
+/**
+ * The returned store instance with state, getters, and actions merged.
+ */
+export type Store<S extends Record<string, unknown>, G extends Record<string, unknown>, A extends Record<string, (...args: any[]) => any>> = S & G & A & {
+    /** Store identifier */
+    $id: string;
+    /** Reset state to initial values */
+    $reset: () => void;
+    /** Subscribe to state changes */
+    $subscribe: (callback: StoreSubscriber<S>) => () => void;
+    /** Patch multiple state properties at once (shallow) */
+    $patch: (partial: StorePatch<S>) => void;
+    /**
+     * Patch with deep reactivity support.
+     * Unlike $patch, this method deep-clones nested objects before mutation,
+     * ensuring that all changes trigger reactive updates.
+     */
+    $patchDeep: (partial: StorePatch<S>) => void;
+    /** Get raw state object (non-reactive snapshot) */
+    $state: S;
+};
+/**
+ * Plugin that can extend store functionality.
+ */
+export type StorePlugin<S = unknown> = (context: {
+    store: Store<any, any, any>;
+    options: StoreDefinition<any, any, any>;
+}) => Partial<S> | void;
+//# sourceMappingURL=types.d.ts.map

package/dist/store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"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"}

package/dist/store/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Internal utilities for the store module.
+ * @internal
+ */
+/**
+ * Check if a value is a plain object (not array, null, Date, etc.).
+ * @internal
+ */
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Deep clones an object. Used for deep reactivity support.
+ * @internal
+ */
+export declare const deepClone: <T>(obj: T) => T;
+/**
+ * Compares two values for deep equality.
+ * @internal
+ */
+export declare const deepEqual: (a: unknown, b: unknown) => boolean;
+/**
+ * Detects if nested objects were mutated but the reference stayed the same.
+ * Returns the keys where nested mutations were detected.
+ * @internal
+ */
+export declare const detectNestedMutations: <S extends Record<string, unknown>>(before: S, after: S, signalValues: Map<keyof S, unknown>) => Array<keyof S>;
+/** @internal Flag to enable/disable development warnings */
+export declare const isDev: boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/store/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/store/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAI7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,KAAK,CAAC,KAAG,CA0BrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OA+ClD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,QAAQ,CAAC,EACT,OAAO,CAAC,EACR,cAAc,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,KAClC,KAAK,CAAC,MAAM,CAAC,CAoBf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,KAAK,SAQd,CAAC"}

package/dist/store/watch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Store watch helpers.
+ */
+import type { Store } from './types';
+export type WatchStoreOptions<T> = {
+    /** Call the callback immediately with the current value. */
+    immediate?: boolean;
+    /** Use deep comparison when determining changes. */
+    deep?: boolean;
+    /** Custom equality check for selected values. */
+    equals?: (a: T, b: T) => boolean;
+};
+/**
+ * Watch a selected slice of store state.
+ *
+ * @param store - The store instance
+ * @param selector - Function to select the watched value
+ * @param callback - Called when the selected value changes
+ * @param options - Watch options
+ * @returns Unsubscribe function
+ */
+export declare const watchStore: <S extends Record<string, unknown>, G extends Record<string, unknown>, A extends Record<string, (...args: unknown[]) => unknown>, T>(store: Store<S, G, A>, selector: (state: S) => T, callback: (value: T, previous: T | undefined) => void, options?: WatchStoreOptions<T>) => (() => void);
+//# sourceMappingURL=watch.d.ts.map

package/dist/store/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/store/watch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,EAED,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrB,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EACzB,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,UAAS,iBAAiB,CAAC,CAAC,CAAM,KACjC,CAAC,MAAM,IAAI,CAgBb,CAAC"}