@effuse/store 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,698 @@
+import { Schema, Effect, Option } from 'effect';
+import { Signal } from '@effuse/core';
+import * as effect_Cause from 'effect/Cause';
+import * as effect_Types from 'effect/Types';
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const StoreOptionsSchema: Schema.Struct<{
+    persist: Schema.optional<typeof Schema.Boolean>;
+    storageKey: Schema.optional<typeof Schema.String>;
+    devtools: Schema.optional<typeof Schema.Boolean>;
+}>;
+type StoreOptions = Schema.Schema.Type<typeof StoreOptionsSchema>;
+type StoreState<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => R : Signal<T[K]>;
+};
+type StoreContext<T> = {
+    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? T[K] : Signal<T[K]>;
+};
+type StoreDefinition<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (this: StoreContext<T>, ...args: A) => R : T[K];
+};
+type ActionContext<T> = StoreContext<T>;
+type Middleware<T> = (state: T, action: string, args: unknown[]) => T | undefined;
+interface Store<T> {
+    readonly name: string;
+    readonly state: StoreState<T>;
+    subscribe: (callback: () => void) => () => void;
+    subscribeToKey: <K extends keyof T>(key: K, callback: (value: T[K]) => void) => () => void;
+    getSnapshot: () => {
+        [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? never : T[K];
+    };
+    computed: <R>(selector: (snapshot: Record<string, unknown>) => R) => Signal<R>;
+    batch: (updates: () => void) => void;
+    reset: () => void;
+    use: (middleware: Middleware<Record<string, unknown>>) => () => void;
+    toJSON: () => {
+        [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? never : T[K];
+    };
+    update: (updater: (draft: {
+        [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? never : T[K];
+    }) => void) => void;
+    select: <R>(selector: (snapshot: Record<string, unknown>) => R) => Signal<R>;
+}
+type InferStoreState<S> = S extends Store<infer T> ? {
+    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? never : T[K];
+} : never;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface StorageAdapter {
+    getItem: (key: string) => Effect.Effect<Option.Option<string>>;
+    setItem: (key: string, value: string) => Effect.Effect<void>;
+    removeItem: (key: string) => Effect.Effect<void>;
+}
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface CreateStoreOptions extends StoreOptions {
+    storage?: StorageAdapter;
+}
+declare const createStore: <T extends object>(name: string, definition: StoreDefinition<T>, options?: CreateStoreOptions) => Store<T> & StoreState<T>;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+interface AtomicState<T extends Record<string, unknown>> {
+    get: () => T;
+    set: (value: T) => void;
+    update: (fn: (state: T) => T) => void;
+}
+declare const createAtomicState: <T extends Record<string, unknown>>(initial: T) => AtomicState<T>;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const STORAGE_PREFIX = "effuse-store:";
+declare const ROOT_SCOPE_ID = "__root__";
+declare const SCOPE_PREFIX = "scope_";
+declare const DEFAULT_TIMEOUT_MS = 5000;
+declare const DEFAULT_RETRY_INITIAL_DELAY_MS = 100;
+declare const DEFAULT_RETRY_MAX_DELAY_MS = 5000;
+declare const DEFAULT_RETRY_BACKOFF_FACTOR = 2;
+declare const StoreConstants: {
+    readonly STORAGE_PREFIX: "effuse-store:";
+    readonly ROOT_SCOPE_ID: "__root__";
+    readonly SCOPE_PREFIX: "scope_";
+    readonly DEBUG_PREFIX: "[store]";
+    readonly DEVTOOLS_PREFIX: "Effuse:";
+    readonly DEFAULT_TIMEOUT_MS: 5000;
+};
+interface StoreConfigValues {
+    persistByDefault: boolean;
+    storagePrefix: string;
+    debug: boolean;
+    devtools: boolean;
+}
+declare const getStoreConfig: () => StoreConfigValues;
+declare const resetStoreConfigCache: () => void;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+type ScopeId = string;
+interface ScopeNode {
+    id: ScopeId;
+    parent: ScopeNode | null;
+    stores: Map<string, Store<unknown>>;
+}
+declare const createScope: (parentScope?: ScopeNode) => ScopeNode;
+declare const disposeScope: (scope: ScopeNode) => void;
+declare const enterScope: (scope: ScopeNode) => void;
+declare const exitScope: () => void;
+declare const getCurrentScope: () => ScopeNode;
+declare const getRootScope: () => ScopeNode;
+declare const registerScopedStore: <T>(name: string, store: Store<T>, scope?: ScopeNode) => void;
+declare const getScopedStore: <T>(name: string, scope?: ScopeNode) => Store<T> | null;
+declare const hasScopedStore: (name: string, scope?: ScopeNode) => boolean;
+declare const runInScope: <R>(scope: ScopeNode, fn: () => R) => R;
+declare const withScope: <R>(fn: (scope: ScopeNode) => R) => R;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface ActionResult<T> {
+    data: T | null;
+    error: Error | null;
+    loading: boolean;
+}
+interface AsyncAction<A extends unknown[], R> {
+    (...args: A): Promise<R>;
+    pending: boolean;
+}
+interface CancellableAction<A extends unknown[], R> {
+    (...args: A): Promise<R>;
+    pending: boolean;
+    cancel: () => void;
+}
+type ActionFn<A extends unknown[], R> = (...args: A) => Promise<R> | R;
+declare const createAsyncAction: <A extends unknown[], R>(fn: ActionFn<A, R>) => AsyncAction<A, R>;
+declare const createCancellableAction: <A extends unknown[], R>(fn: ActionFn<A, R>) => CancellableAction<A, R>;
+declare const withTimeout: <A extends unknown[], R>(fn: ActionFn<A, R>, timeoutMs: number) => ((...args: A) => Promise<R>);
+interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffFactor?: number;
+}
+declare const withRetry: <A extends unknown[], R>(fn: ActionFn<A, R>, config: RetryConfig) => ((...args: A) => Promise<R>);
+declare const takeLatest: <A extends unknown[], R>(fn: ActionFn<A, R>) => CancellableAction<A, R>;
+declare const takeFirst: <A extends unknown[], R>(fn: ActionFn<A, R>) => AsyncAction<A, R | undefined>;
+declare const debounceAction: <A extends unknown[], R>(fn: ActionFn<A, R>, delayMs: number) => ((...args: A) => Promise<R>);
+declare const throttleAction: <A extends unknown[], R>(fn: ActionFn<A, R>, intervalMs: number) => ((...args: A) => Promise<R | undefined>);
+declare const dispatch: <T>(store: Store<T>, actionName: keyof T, ...args: unknown[]) => Promise<unknown>;
+declare const dispatchSync: <T>(store: Store<T>, actionName: keyof T, ...args: unknown[]) => unknown;
+declare const withAbortSignal: <A extends unknown[], R>(fn: ActionFn<A, R>) => ((signal: AbortSignal, ...args: A) => Promise<R>);
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+declare const StoreNotFoundError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "StoreNotFoundError";
+} & Readonly<A>;
+declare class StoreNotFoundError extends StoreNotFoundError_base<{
+    readonly name: string;
+}> {
+    get message(): string;
+}
+declare const StoreAlreadyExistsError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "StoreAlreadyExistsError";
+} & Readonly<A>;
+declare class StoreAlreadyExistsError extends StoreAlreadyExistsError_base<{
+    readonly name: string;
+}> {
+    get message(): string;
+}
+declare const ActionNotFoundError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "ActionNotFoundError";
+} & Readonly<A>;
+declare class ActionNotFoundError extends ActionNotFoundError_base<{
+    readonly actionName: string;
+}> {
+}
+declare const TimeoutError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "TimeoutError";
+} & Readonly<A>;
+declare class TimeoutError extends TimeoutError_base<{
+    readonly ms: number;
+}> {
+    get message(): string;
+}
+declare const CancellationError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "CancellationError";
+} & Readonly<A>;
+declare class CancellationError extends CancellationError_base<{
+    readonly message: string;
+}> {
+}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "ValidationError";
+} & Readonly<A>;
+declare class ValidationError extends ValidationError_base<{
+    readonly errors: string[];
+}> {
+    get message(): string;
+}
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface CancellationToken {
+    readonly isCancelled: boolean;
+    cancel: () => void;
+    throwIfCancelled: () => void;
+    onCancel: (callback: () => void) => () => void;
+}
+declare const createCancellationToken: () => CancellationToken;
+interface CancellationScope {
+    readonly token: CancellationToken;
+    createChild: () => CancellationToken;
+    dispose: () => void;
+}
+declare const createCancellationScope: () => CancellationScope;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+type StateSchema<T> = Schema.Schema<T, T>;
+interface ValidationResult<T> {
+    success: boolean;
+    data: T | null;
+    errors: string[];
+}
+declare const validateState: <T>(schema: StateSchema<T>, state: unknown) => ValidationResult<T>;
+declare const validateStateAsync: <T>(schema: StateSchema<T>, state: unknown, timeoutMs?: number) => Promise<ValidationResult<T>>;
+declare const createValidatedSetter: <T extends Record<string, unknown>>(schema: StateSchema<T>, onValid: (state: T) => void, onInvalid?: (errors: string[]) => void) => ((state: unknown) => boolean);
+declare const createFieldValidator: <T>(schema: Schema.Schema<T, T>) => ((value: unknown) => T);
+declare const createSafeFieldSetter: <T>(schema: Schema.Schema<T, T>, setter: (value: T) => void) => ((value: unknown) => boolean);
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface ComposedStore<T, D extends readonly Store<unknown>[]> {
+    store: Store<T>;
+    dependencies: D;
+    computed: <R>(selector: (state: T, deps: {
+        [K in keyof D]: ReturnType<D[K]['getSnapshot']>;
+    }) => R) => Signal<R>;
+    computedAsync: <R>(asyncSelector: (state: T, deps: {
+        [K in keyof D]: ReturnType<D[K]['getSnapshot']>;
+    }, token: CancellationToken) => Promise<R>, initialValue: R) => Signal<R> & {
+        pending: Signal<boolean>;
+        cleanup: () => void;
+    };
+}
+declare const composeStores: <T, D extends readonly Store<unknown>[]>(mainStore: Store<T>, dependencies: D) => ComposedStore<T, D>;
+interface StoreSlice<T extends object, P extends object> {
+    create: (parent: Store<P>) => Store<T>;
+}
+declare const defineSlice: <T extends object, P extends object>(name: string, factory: (parent: Store<P>) => StoreDefinition<T>) => StoreSlice<T, P>;
+declare const mergeStores: <A, B>(storeA: Store<A>, storeB: Store<B>) => {
+    getSnapshot: () => ReturnType<Store<A>["getSnapshot"]> & ReturnType<Store<B>["getSnapshot"]>;
+    subscribe: (callback: () => void) => () => void;
+};
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const deriveFrom: <S extends Store<unknown>[], R>(stores: [...S], selector: (...snapshots: { [K in keyof S]: ReturnType<S[K]["getSnapshot"]>; }) => R) => Signal<R> & {
+    cleanup: () => void;
+};
+declare const deriveFromAsync: <S extends Store<unknown>[], R>(stores: [...S], asyncSelector: (snapshots: { [K in keyof S]: ReturnType<S[K]["getSnapshot"]>; }, token: CancellationToken) => Promise<R>, initialValue: R) => Signal<R> & {
+    cleanup: () => void;
+    pending: Signal<boolean>;
+};
+declare const serializeStores: () => string;
+declare const hydrateStoresSync: (serialized: string) => void;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface StoreStream<T> {
+    subscribe: (handler: (value: T) => void) => () => void;
+    map: <R>(fn: (value: T) => R) => StoreStream<R>;
+    filter: (predicate: (value: T) => boolean) => StoreStream<T>;
+    debounce: (ms: number) => StoreStream<T>;
+    throttle: (ms: number) => StoreStream<T>;
+    takeLatest: <R>(asyncHandler: (value: T, token: CancellationToken) => Promise<R>) => StoreStream<R>;
+}
+declare const createStoreStream: <T, K extends keyof T>(store: Store<T>, key: K) => StoreStream<T[K]>;
+declare const streamAll: <T>(store: Store<T>) => StoreStream<ReturnType<Store<T>["getSnapshot"]>>;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const shallowEqual: <T>(a: T, b: T) => boolean;
+type Selector<T, R> = (state: T) => R;
+type EqualityFn<T> = (a: T, b: T) => boolean;
+declare const createSelector: <T, R>(store: Store<T>, selector: Selector<ReturnType<Store<T>["getSnapshot"]>, R>, equalityFn?: EqualityFn<R>) => Signal<R>;
+type AsyncSelector<T, R> = (state: T, token: CancellationToken) => Promise<R>;
+declare const createSelectorAsync: <T, R>(store: Store<T>, asyncSelector: AsyncSelector<ReturnType<Store<T>["getSnapshot"]>, R>, initialValue: R) => Signal<R> & {
+    pending: Signal<boolean>;
+    cleanup: () => void;
+};
+declare const pick: <T, K extends keyof T>(store: Store<T>, keys: K[]) => Signal<Pick<T, K>>;
+declare const combineSelectors: <T, R extends Record<string, unknown>>(store: Store<T>, selectors: { [K in keyof R]: Selector<ReturnType<Store<T>["getSnapshot"]>, R[K]>; }) => Signal<R>;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+interface MiddlewareManager<T extends Record<string, unknown>> {
+    add: (middleware: Middleware<T>) => () => void;
+    remove: (middleware: Middleware<T>) => void;
+    execute: (state: T, action: string, args: unknown[]) => T;
+    getAll: () => readonly Middleware<T>[];
+}
+declare const createMiddlewareManager: <T extends Record<string, unknown>>() => MiddlewareManager<T>;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const hasDevTools: () => boolean;
+declare const connectDevTools: <T>(store: Store<T>, options?: {
+    name?: string;
+}) => (() => void);
+declare const devToolsMiddleware: <T>(storeName: string) => (state: T, action: string, args: unknown[]) => T | undefined;
+declare const createDevToolsMiddleware: <T>(storeName: string) => (state: T, action: string, args: unknown[]) => T | undefined;
+declare const disconnectDevTools: (storeName: string) => void;
+declare const disconnectAllDevTools: () => void;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+declare const getStore: <T>(name: string) => Store<T>;
+declare const hasStore: (name: string) => boolean;
+declare const removeStore: (name: string) => boolean;
+declare const clearStores: () => void;
+declare const getStoreNames: () => string[];
+
+export { type ActionContext, ActionNotFoundError, type ActionResult, type AsyncAction, type AsyncSelector, type AtomicState, type CancellableAction, CancellationError, type CancellationScope, type CancellationToken, type ComposedStore, type CreateStoreOptions, DEFAULT_RETRY_BACKOFF_FACTOR, DEFAULT_RETRY_INITIAL_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_TIMEOUT_MS, type EqualityFn, type InferStoreState, type Middleware, type MiddlewareManager, ROOT_SCOPE_ID, type RetryConfig, SCOPE_PREFIX, STORAGE_PREFIX, type ScopeId, type ScopeNode, type Selector, type StateSchema, type Store, StoreAlreadyExistsError, type StoreConfigValues, StoreConstants, type StoreContext, type StoreDefinition, StoreNotFoundError, type StoreOptions, type StoreSlice, type StoreState, type StoreStream, TimeoutError, ValidationError, type ValidationResult, clearStores, combineSelectors, composeStores, connectDevTools, createAsyncAction, createAtomicState, createCancellableAction, createCancellationScope, createCancellationToken, createDevToolsMiddleware, createFieldValidator, createMiddlewareManager, createSafeFieldSetter, createScope, createSelector, createSelectorAsync, createStore, createStoreStream, createValidatedSetter, debounceAction, defineSlice, deriveFrom, deriveFromAsync, devToolsMiddleware, disconnectAllDevTools, disconnectDevTools, dispatch, dispatchSync, disposeScope, enterScope, exitScope, getCurrentScope, getRootScope, getScopedStore, getStore, getStoreConfig, getStoreNames, hasDevTools, hasScopedStore, hasStore, hydrateStoresSync, mergeStores, pick, registerScopedStore, removeStore, resetStoreConfigCache, runInScope, serializeStores, shallowEqual, streamAll, takeFirst, takeLatest, throttleAction, validateState, validateStateAsync, withAbortSignal, withRetry, withScope, withTimeout };