seitu 0.9.1 → 0.10.0

package/dist/core/schema-store.d.ts

@@ -1,16 +1,14 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { Simplify } from '../utils';
+import type { ValidationObjectSchemas, ValidationObjectSchemasOutput } from '../validate';
 import type { Readable, Subscribable, Writable } from './index';
-export type SchemaStoreSchema = Record<string, StandardSchemaV1<unknown, unknown>>;
-export type SchemaStoreOutput<S extends SchemaStoreSchema> = Simplify<{
-    [K in keyof S]: StandardSchemaV1.InferOutput<S[K]>;
-}>;
 export interface SchemaStore<O extends Record<string, unknown>> extends Subscribable<O>, Readable<O>, Writable<Partial<O>, O> {
-    getDefaultValue: <K extends keyof O>(key: K) => O[K];
+    '~': {
+        getDefaultValue: <K extends keyof O>(key: K) => O[K];
+    } & Subscribable<O>['~'];
 }
 export interface SchemaStoreOptions<S extends Record<string, StandardSchemaV1>> {
     schemas: S;
-    defaultValues: SchemaStoreOutput<S>;
+    defaultValues: ValidationObjectSchemasOutput<S>;
     /**
      * The provider to use for the schema store. If not provided, the schema store will
      * use an in-memory provider.
@@ -35,10 +33,10 @@ export interface SchemaStoreOptions<S extends Record<string, StandardSchemaV1>>
  * store.subscribe(console.log)
  * ```
  */
-export declare function createSchemaStore<S extends Record<string, StandardSchemaV1>>(options: SchemaStoreOptions<S>): SchemaStore<SchemaStoreOutput<S>>;
-export interface SchemaStoreProvider<S extends SchemaStoreSchema> {
-    get: () => SchemaStoreOutput<S>;
-    set: (value: Partial<SchemaStoreOutput<S>>) => void;
+export declare function createSchemaStore<S extends Record<string, StandardSchemaV1>>(options: SchemaStoreOptions<S>): SchemaStore<ValidationObjectSchemasOutput<S>>;
+export interface SchemaStoreProvider<S extends ValidationObjectSchemas> {
+    get: () => ValidationObjectSchemasOutput<S>;
+    set: (value: Partial<ValidationObjectSchemasOutput<S>>) => void;
 }
 /**
  * Creates an in-memory provider for a schema store. Use as the state backing when you don't
@@ -56,4 +54,4 @@ export interface SchemaStoreProvider<S extends SchemaStoreSchema> {
  * })
  * ```
  */
-export declare function createSchemaStoreMemoryProvider<S extends SchemaStoreSchema>(): SchemaStoreProvider<S>;
+export declare function createSchemaStoreMemoryProvider<S extends ValidationObjectSchemas>(): SchemaStoreProvider<S>;

package/dist/core/store.d.ts

@@ -2,7 +2,7 @@ import type { Readable, Subscribable, Writable } from './subscription';
 export interface Store<T> extends Readable<T>, Writable<T, T>, Subscribable<T> {
 }
 /**
- * Creates a simple reactive store (minimal TanStack Store–style API).
+ * Creates a simple reactive store (minimal TanStack Store-style API).
  *
  * - **Standalone**: use `get()`, `set(value | updater)`, `subscribe(callback)` for any state.
  * - **With schema-store**: use as the state backing for a memory provider.

package/dist/core/subscription.d.ts

@@ -26,6 +26,7 @@ export interface Writable<T, P = T> {
 export interface Removable {
     remove: () => void;
 }
+export declare function createReadableSubscription<T>(get: () => T, subscribe: (callback: () => any, options?: SubscribeOptions) => () => void, notify: () => void): Readable<T> & Subscribable<T>;
 export declare function createSubscription(options?: {
     onFirstSubscribe?: () => (void | (() => void));
 }): {

package/dist/core-Dldv77Xv.js

@@ -0,0 +1,167 @@
+//#region src/core/subscription.ts
+function e(e, t, n) {
+	return {
+		get: e,
+		subscribe(n, r) {
+			return t(() => n(e()), r);
+		},
+		"~": {
+			output: null,
+			notify: n
+		}
+	};
+}
+function t(e) {
+	let t = /* @__PURE__ */ new Set(), n = () => t.forEach((e) => e()), r;
+	return {
+		subscribe(n, i) {
+			return t.size === 0 && e?.onFirstSubscribe && (r = e.onFirstSubscribe() ?? void 0), i?.immediate && n(), t.add(n), () => {
+				t.delete(n), t.size === 0 && (r?.(), r = void 0);
+			};
+		},
+		notify: n
+	};
+}
+//#endregion
+//#region src/core/computed.ts
+function n(n, r) {
+	let i = Array.isArray(n) ? n : [n], a = !Array.isArray(n), { subscribe: o, notify: s } = t({ onFirstSubscribe() {
+		let e = i.map((e) => e.subscribe(() => s()));
+		return () => e.forEach((e) => e());
+	} });
+	return e(() => r(a ? i[0].get() : i.map((e) => e.get())), o, s);
+}
+//#endregion
+//#region src/core/debounce.ts
+function r(n, r) {
+	let i = n.get(), a, { subscribe: o, notify: s } = t({ onFirstSubscribe() {
+		let e = n.subscribe(() => {
+			clearTimeout(a), a = setTimeout(() => {
+				i = n.get(), s();
+			}, r);
+		});
+		return () => {
+			clearTimeout(a), e();
+		};
+	} });
+	return e(() => i, o, s);
+}
+//#endregion
+//#region src/core/debounce-fn.ts
+function i(n, r) {
+	let i, a, { subscribe: o, notify: s } = t();
+	return Object.assign((...e) => {
+		clearTimeout(a), a = setTimeout(() => {
+			i = n(...e), s();
+		}, r);
+	}, e(() => i, o, s));
+}
+//#endregion
+//#region src/utils.ts
+function a(e) {
+	if (typeof e != "string") return e;
+	try {
+		return JSON.parse(e);
+	} catch {
+		return e;
+	}
+}
+//#endregion
+//#region src/validate.ts
+function o(e, t, n) {
+	let r = a(t), i = e["~standard"].validate(r);
+	if (i instanceof Promise) throw TypeError(`[${n.label}] Validation schema should not return a Promise.`);
+	if (!i.issues) return i.value;
+	if (n.onError) {
+		let t = n.onError(i.issues, r);
+		if (t !== void 0) {
+			let r = e["~standard"].validate(t);
+			if (r instanceof Promise) throw TypeError(`[${n.label}] Validation schema should not return a Promise.`);
+			if (r.issues) console.warn(`[${n.label}] Returned value invalid, returned default value instead`, JSON.stringify(r.issues, null, 2), { cause: r.issues });
+			else return r.value;
+		}
+	} else console.warn(`[${n.label}] Returned value invalid, returned default value instead`, JSON.stringify(i.issues, null, 2), { cause: i.issues });
+	return n.defaultValue;
+}
+//#endregion
+//#region src/core/schema-store.ts
+function s(n) {
+	let { subscribe: r, notify: i } = t(), a = { ...n.defaultValues }, s = n.provider ?? c(), l = () => {
+		let e = { ...a };
+		for (let [t, r] of Object.entries(n.schemas)) e[t] = o(r, s.get()[t], {
+			defaultValue: a[t],
+			label: `createSchemaStore:${String(t)}`
+		});
+		return e;
+	}, u = e(l, r, i);
+	return {
+		...u,
+		set: (e) => {
+			let t = typeof e == "function" ? e(l()) : e;
+			s.set(t), i();
+		},
+		"~": {
+			...u["~"],
+			getDefaultValue: (e) => a[e]
+		}
+	};
+}
+function c() {
+	let e = l({});
+	return {
+		get: () => e.get(),
+		set: (t) => {
+			e.set(t);
+		}
+	};
+}
+//#endregion
+//#region src/core/store.ts
+function l(n) {
+	let r = n, { subscribe: i, notify: a } = t();
+	return {
+		...e(() => r, i, a),
+		set: (e) => {
+			let t = typeof e == "function" ? e(r) : e;
+			t !== r && (r = t, a());
+		}
+	};
+}
+//#endregion
+//#region src/core/throttle.ts
+function u(n, r) {
+	let i = n.get(), a, o = !1, { subscribe: s, notify: c } = t({ onFirstSubscribe() {
+		let e = n.subscribe(() => {
+			if (a) {
+				o = !0;
+				return;
+			}
+			i = n.get(), c(), a = setTimeout(() => {
+				a = void 0, o && (o = !1, i = n.get(), c());
+			}, r);
+		});
+		return () => {
+			clearTimeout(a), a = void 0, o = !1, e();
+		};
+	} });
+	return e(() => i, s, c);
+}
+//#endregion
+//#region src/core/throttle-fn.ts
+function d(n, r) {
+	let i, a, o, { subscribe: s, notify: c } = t();
+	return Object.assign((...e) => {
+		if (a) {
+			o = e;
+			return;
+		}
+		i = n(...e), c(), a = setTimeout(() => {
+			if (a = void 0, o) {
+				let e = o;
+				o = void 0, i = n(...e), c();
+			}
+		}, r);
+	}, e(() => i, s, c));
+}
+//#endregion
+export { c as a, n as c, s as i, e as l, u as n, i as o, l as r, r as s, d as t, t as u };

package/dist/core.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, r as a, s as o, t as s, u as c } from "./core-vtgV_plC.js";
-export { r as createComputed, t as createDebounce, o as createDebounceFn, n as createSchemaStore, e as createSchemaStoreMemoryProvider, a as createStore, c as createSubscription, i as createThrottle, s as createThrottleFn };
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "./core-Dldv77Xv.js";
+export { t as createComputed, s as createDebounce, a as createDebounceFn, r as createReadableSubscription, n as createSchemaStore, e as createSchemaStoreMemoryProvider, o as createStore, l as createSubscription, i as createThrottle, c as createThrottleFn };

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './validation';

package/dist/utils/validation.d.ts

@@ -0,0 +1,27 @@
+import type { ValidationSchemaErrorProps } from '../validate';
+/**
+ * Repair broken web storage value object if value was object but not all keys are in the default value object.
+ *
+ * @returns A new object with the existing keys in the value object that are not in the default value object.
+ *
+ * @example
+ * ```ts
+ * import { createWebStorageValue } from 'seitu/web'
+ * import { repairWebStorageValueObjectWithDefault } from 'seitu/utils'
+ * import * as z from 'zod'
+ *
+ * const value = createWebStorageValue({
+ *   type: 'localStorage',
+ *   schema: z.object({ a: z.number(), b: z.string() }),
+ *   key: 'storage-key',
+ *   defaultValue: { a: 0, b: 'default' },
+ *   onValidationError: repairWebStorageValueObjectWithDefault,
+ * })
+ * value.get() // { a: 0, b: 'default' }
+ * window.localStorage.setItem('storage-key', JSON.stringify({ a: 1 }))
+ * value.get() // { a: 1, b: 'default' }
+ * ```
+ */
+export declare function repairWebStorageValueObjectWithDefault<O extends Record<string, unknown>>(props: ValidationSchemaErrorProps<O>): O & {
+    [k: string]: any;
+};

package/dist/validate.d.ts

@@ -0,0 +1,23 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { Simplify } from './utils';
+export type ValidationObjectSchemas = Record<string, StandardSchemaV1<unknown, unknown>>;
+export type ValidationObjectSchemasOutput<S extends ValidationObjectSchemas> = Simplify<{
+    [K in keyof S]: StandardSchemaV1.InferOutput<S[K]>;
+}>;
+export interface ValidationSchemaErrorProps<O> {
+    defaultValue: O;
+    issues: StandardSchemaV1.Issue[];
+    value: unknown;
+}
+export interface ValidationSchemasErrorProps<O extends Record<string, unknown>> {
+    defaultValue: O[keyof O];
+    issues: StandardSchemaV1.Issue[];
+    value: unknown;
+    key: keyof O;
+}
+export interface ValidateSchemaOptions {
+    defaultValue: unknown;
+    label: string;
+    onError?: (issues: readonly StandardSchemaV1.Issue[], parsed: unknown) => unknown;
+}
+export declare function validateSchema(schema: StandardSchemaV1, value: unknown, options: ValidateSchemaOptions): unknown;

package/dist/web/index.d.ts

@@ -1,7 +1,3 @@
 export * from './is-online';
-export * from './local-storage';
-export * from './local-storage-value';
 export * from './media-query';
 export * from './scroll-state';
-export * from './session-storage';
-export * from './session-storage-value';

package/dist/web/web-storage-value.d.ts

@@ -1,26 +1,74 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import type { Readable, Removable, Subscribable, Writable } from '../core/index';
+import type { ValidationSchemaErrorProps, ValidationSchemasErrorProps } from '../validate';
 import type { WebStorage } from './web-storage';
 export interface WebStorageValue<V> extends Subscribable<V>, Readable<V>, Writable<V>, Removable {
 }
 export interface WebStorageValueOptionsWithStorage<Storage extends WebStorage<any>, K extends keyof Storage['~']['output']> {
     storage: Storage;
     key: K;
-    onValidationError?: (props: {
-        issues: StandardSchemaV1.Issue[];
-        value: unknown;
-    }) => void;
+    onValidationError?: (props: ValidationSchemasErrorProps<Storage['~']['output']>) => void;
 }
 export interface WebStorageValueOptionsWithSchema<S extends StandardSchemaV1<unknown>> {
+    type: 'localStorage' | 'sessionStorage';
     schema: S;
     key: string;
     defaultValue: StandardSchemaV1.InferOutput<S>;
-    onValidationError?: (props: {
-        issues: StandardSchemaV1.Issue[];
-        value: unknown;
-    }) => void | StandardSchemaV1.InferOutput<S>;
+    /**
+     * Handle validation errors.
+     *
+     * If returns a value, it will be used as the value to validate and return.
+     * If returns undefined, the default value will be returned.
+     */
+    onValidationError?: (props: ValidationSchemaErrorProps<StandardSchemaV1.InferOutput<S>>) => void | StandardSchemaV1.InferOutput<S>;
 }
+/**
+ * Creates a reactive handle for a localStorage or sessionStorage instance.
+ *
+ * @example Vanilla
+ * ```ts twoslash title="session-storage.ts"
+ * import { createWebStorage } from 'seitu/web'
+ * import * as z from 'zod'
+ *
+ * const sessionStorage = createWebStorage({
+ *   type: 'sessionStorage',
+ *   schemas: {
+ *     token: z.string().nullable(),
+ *     preferences: z.object({ theme: z.enum(['light', 'dark']) }),
+ *   },
+ *   defaultValues: { token: null, preferences: { theme: 'light' } },
+ * })
+ *
+ * sessionStorage.get() // { token: null, preferences: { theme: 'light' } }
+ * sessionStorage.set({ token: 'abc' })
+ * sessionStorage.get() // { token: 'abc', preferences: { theme: 'light' } }
+ * sessionStorage.subscribe(console.log)
+ * ```
+ *
+ * @example React
+ * ```tsx twoslash title="page.tsx"
+ * 'use client'
+ *
+ * import { createWebStorage } from 'seitu/web'
+ * import { useSubscription } from 'seitu/react'
+ * import * as z from 'zod'
+ *
+ * const sessionStorage = createWebStorage({
+ *   type: 'sessionStorage',
+ *   schemas: { count: z.number(), name: z.string() },
+ *   defaultValues: { count: 0, name: '' },
+ * })
+ *
+ * export default function Page() {
+ *   const value = useSubscription(sessionStorage)
+ *   return (
+ *     <div>
+ *       <span>{value.count}</span>
+ *       <span>{value.name}</span>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
 export declare function createWebStorageValue<Storage extends WebStorage<any>, K extends keyof Storage['~']['output']>(options: WebStorageValueOptionsWithStorage<Storage, K>): WebStorageValue<Storage['~']['output'][K]>;
-export declare function createWebStorageValue<S extends StandardSchemaV1<unknown>>(options: WebStorageValueOptionsWithSchema<S> & {
-    kind: 'sessionStorage' | 'localStorage';
-}): WebStorageValue<StandardSchemaV1.InferOutput<S>>;
+export declare function createWebStorageValue<S extends StandardSchemaV1<unknown>>(options: WebStorageValueOptionsWithSchema<S>): WebStorageValue<StandardSchemaV1.InferOutput<S>>;

package/dist/web/web-storage.d.ts

@@ -1,18 +1,63 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { SchemaStore, SchemaStoreOptions, SchemaStoreOutput, SchemaStoreSchema } from '../core/index';
-export interface WebStorageOptions<S extends SchemaStoreSchema> extends Omit<SchemaStoreOptions<S>, 'provider'> {
+import type { SchemaStore, SchemaStoreOptions } from '../core/index';
+import type { ValidationObjectSchemas, ValidationObjectSchemasOutput, ValidationSchemasErrorProps } from '../validate';
+export interface WebStorageOptions<S extends ValidationObjectSchemas> extends Omit<SchemaStoreOptions<S>, 'provider'> {
+    type: 'localStorage' | 'sessionStorage';
     keyTransform?: (key: keyof S) => string;
-    onValidationError?: <K extends keyof S>(props: {
-        issues: StandardSchemaV1.Issue[];
-        key: K;
-        value: unknown;
-    }) => void | StandardSchemaV1.InferOutput<S[K]>;
+    onValidationError?: (props: ValidationSchemasErrorProps<ValidationObjectSchemasOutput<S>>) => void | StandardSchemaV1.InferOutput<S[keyof S]>;
 }
 export interface WebStorage<O extends Record<string, unknown>> extends SchemaStore<O> {
     '~': {
-        kind: 'sessionStorage' | 'localStorage';
+        getDefaultValue: <K extends keyof O>(key: K) => O[K];
+        type: 'localStorage' | 'sessionStorage';
     } & SchemaStore<O>['~'];
 }
-export declare function createWebStorage<S extends SchemaStoreSchema>(options: WebStorageOptions<S> & {
-    kind: 'sessionStorage' | 'localStorage';
-}): WebStorage<SchemaStoreOutput<S>>;
+/**
+ * Creates a reactive handle for a localStorage or sessionStorage instance.
+ *
+ * @example Vanilla
+ * ```ts twoslash title="session-storage.ts"
+ * import { createWebStorage } from 'seitu/web'
+ * import * as z from 'zod'
+ *
+ * const sessionStorage = createWebStorage({
+ *   type: 'sessionStorage',
+ *   schemas: {
+ *     token: z.string().nullable(),
+ *     preferences: z.object({ theme: z.enum(['light', 'dark']) }),
+ *   },
+ *   defaultValues: { token: null, preferences: { theme: 'light' } },
+ * })
+ *
+ * sessionStorage.get() // { token: null, preferences: { theme: 'light' } }
+ * sessionStorage.set({ token: 'abc' })
+ * sessionStorage.get() // { token: 'abc', preferences: { theme: 'light' } }
+ * sessionStorage.subscribe(console.log)
+ * ```
+ *
+ * @example React
+ * ```tsx twoslash title="page.tsx"
+ * 'use client'
+ *
+ * import { createWebStorage } from 'seitu/web'
+ * import { useSubscription } from 'seitu/react'
+ * import * as z from 'zod'
+ *
+ * const sessionStorage = createWebStorage({
+ *   type: 'sessionStorage',
+ *   schemas: { count: z.number(), name: z.string() },
+ *   defaultValues: { count: 0, name: '' },
+ * })
+ *
+ * export default function Page() {
+ *   const value = useSubscription(sessionStorage)
+ *   return (
+ *     <div>
+ *       <span>{value.count}</span>
+ *       <span>{value.name}</span>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function createWebStorage<S extends ValidationObjectSchemas>(options: WebStorageOptions<S>): WebStorage<ValidationObjectSchemasOutput<S>>;

package/dist/web.js

@@ -1,181 +1,27 @@
-import { o as e, u as t } from "./core-vtgV_plC.js";
+import { l as e, u as t } from "./core-Dldv77Xv.js";
 //#region src/web/is-online.ts
 function n() {
-	let { subscribe: e, notify: n } = t({ onFirstSubscribe: () => (typeof window < "u" && (window.addEventListener("online", n), window.addEventListener("offline", n)), () => {
-		typeof window < "u" && (window.removeEventListener("online", n), window.removeEventListener("offline", n));
-	}) }), r = () => typeof navigator > "u" ? !0 : navigator.onLine;
-	return {
-		get: r,
-		subscribe: (t, n) => e(() => t(r()), n),
-		"~": {
-			output: null,
-			notify: n
-		}
-	};
-}
-//#endregion
-//#region src/web/web-storage.ts
-function r(n) {
-	let r = !1, { subscribe: i, notify: a } = t({ onFirstSubscribe: () => {
-		let e = () => {
-			r || a();
-		};
-		return typeof window < "u" && window.addEventListener("storage", e), () => {
-			typeof window < "u" && window.removeEventListener("storage", e);
-		};
-	} }), o = { ...n.defaultValues }, s = () => {
-		if (typeof window > "u") return n.defaultValues;
-		let t = window[n.kind], r = { ...n.defaultValues };
-		for (let i in r) {
-			let a = t.getItem(n.keyTransform ? n.keyTransform(i) : i);
-			if (a === null) {
-				r[i] = n.defaultValues[i];
-				continue;
-			}
-			let o = e(a), s = n.schemas[i]["~standard"].validate(o);
-			if (s instanceof Promise) throw TypeError("[createWebStorage] Validation schema should not return a Promise.");
-			if (s.issues) if (n.onValidationError) {
-				let e = n.onValidationError({
-					issues: [...s.issues],
-					key: i,
-					value: o
-				});
-				if (e !== void 0) {
-					let t = n.schemas[i]["~standard"].validate(e);
-					if (t instanceof Promise) throw TypeError("[createWebStorage] Validation schema should not return a Promise.");
-					t.issues ? console.warn(`[createWebStorage] Returned value invalid for key ${i}, returned default value instead`, JSON.stringify(t.issues, null, 2), { cause: t.issues }) : r[i] = t.value;
-				}
-			} else console.warn(`[createWebStorage] Returned value invalid for key ${i}, returned default value instead`, JSON.stringify(s.issues, null, 2), { cause: s.issues }), r[i] = n.defaultValues[i];
-			else r[i] = s.value;
-		}
-		return r;
-	};
-	return {
-		get: s,
-		set: (e) => {
-			let t = typeof e == "function" ? e(s()) : e;
-			if (typeof window > "u") return;
-			let i = window[n.kind];
-			r = !0, Object.entries(t).forEach(([e, t]) => {
-				let r = typeof t == "string" ? t : JSON.stringify(t);
-				i.setItem(n.keyTransform ? n.keyTransform(e) : e, r), window.dispatchEvent(new StorageEvent("storage", {
-					key: n.keyTransform ? n.keyTransform(e) : e,
-					newValue: r
-				}));
-			}), r = !1, a();
-		},
-		getDefaultValue: (e) => o[e],
-		subscribe: (e, t = {}) => i(() => e(s()), t),
-		"~": {
-			kind: n.kind,
-			output: null,
-			notify: a
-		}
-	};
-}
-//#endregion
-//#region src/web/local-storage.ts
-function i(e) {
-	return r({
-		kind: "localStorage",
-		...e
-	});
-}
-//#endregion
-//#region src/web/web-storage-value.ts
-function a(n) {
-	let r = "storage" in n ? n.storage["~"].kind : n.kind, i = !1, a = `${r}Value`;
-	if ("schema" in n && n.defaultValue === void 0) throw Error(`[${a}] Default value is required`);
-	if (n.key === void 0) throw Error(`[${a}] Key is required`);
-	if (!("schema" in n || "storage" in n)) throw Error(`[${a}] Either schema or storage must be provided`);
-	let o = ("schema" in n ? n.defaultValue : n.storage.getDefaultValue(n.key)) ?? null, { subscribe: s, notify: c } = t({ onFirstSubscribe: () => {
-		let e = (e) => {
-			i || e.key === n.key && c();
-		};
-		return typeof window < "u" && window.addEventListener("storage", e), () => {
-			typeof window < "u" && window.removeEventListener("storage", e);
-		};
-	} }), l = () => {
-		if (typeof window > "u") return o;
-		let t = window[r].getItem(n.key);
-		if (t === null) return o;
-		let i = e(t);
-		try {
-			if ("schema" in n) {
-				let e = n.schema["~standard"].validate(i);
-				if (e instanceof Promise) throw TypeError("Validation schema should not return a Promise.");
-				if (e.issues) {
-					if (n.onValidationError) {
-						let t = n.onValidationError({
-							issues: [...e.issues],
-							value: i
-						});
-						if (t !== void 0) {
-							let e = n.schema["~standard"].validate(t);
-							if (e instanceof Promise) throw TypeError("Validation schema should not return a Promise.");
-							if (e.issues) console.warn(`[${a}] Returned value invalid for key ${n.key}, returned default value instead`, JSON.stringify(e.issues, null, 2), { cause: e.issues });
-							else return e.value;
-						}
-					} else console.warn(`[${a}] Returned value invalid for key ${n.key}, returned default value instead`, JSON.stringify(e.issues, null, 2), { cause: e.issues });
-					return o;
-				}
-				return e.value;
-			} else return i;
-		} catch {
-			return o !== void 0 && typeof o != "string" ? o : i;
-		}
-	};
-	return {
-		get: l,
-		set: (e) => {
-			if (typeof window > "u") return;
-			let t = window[r], a = typeof e == "function" ? e(l()) : e;
-			i = !0, t.setItem(n.key, typeof a == "string" ? a : JSON.stringify(a)), window.dispatchEvent(new StorageEvent("storage", {
-				key: n.key,
-				newValue: a
-			})), i = !1, c();
-		},
-		subscribe: (e, t = {}) => s(() => e(l()), t),
-		remove: () => {
-			typeof window > "u" || window[r].removeItem(n.key);
-		},
-		"~": {
-			output: null,
-			notify: c
-		}
-	};
-}
-//#endregion
-//#region src/web/local-storage-value.ts
-function o(e) {
-	return "storage" in e ? a(e) : a({
-		...e,
-		kind: "localStorage"
-	});
+	let { subscribe: n, notify: r } = t({ onFirstSubscribe: () => (typeof window < "u" && (window.addEventListener("online", r), window.addEventListener("offline", r)), () => {
+		typeof window < "u" && (window.removeEventListener("online", r), window.removeEventListener("offline", r));
+	}) });
+	return e(() => typeof navigator > "u" ? !0 : navigator.onLine, n, r);
 }
 //#endregion
 //#region src/web/media-query.ts
-function s(e) {
-	let n = typeof window > "u" ? null : window.matchMedia(e.query), { subscribe: r, notify: i } = t({ onFirstSubscribe: () => (n?.addEventListener("change", i), () => {
-		n?.removeEventListener("change", i);
-	}) }), a = () => n?.matches ?? e.defaultMatches ?? !1;
-	return {
-		get: a,
-		subscribe: (e, t = {}) => r(() => e(a()), t),
-		"~": {
-			output: null,
-			notify: i
-		}
-	};
+function r(n) {
+	let r = typeof window > "u" ? null : window.matchMedia(n.query), { subscribe: i, notify: a } = t({ onFirstSubscribe: () => (r?.addEventListener("change", a), () => {
+		r?.removeEventListener("change", a);
+	}) });
+	return e(() => r?.matches ?? n.defaultMatches ?? !1, i, a);
 }
 //#endregion
 //#region src/web/scroll-state.ts
-var c = {
+var i = {
 	reached: !1,
 	remaining: 0
 };
-function l(e) {
-	let { direction: n = "both", threshold: r = 0 } = e, { subscribe: i, notify: a } = t(), o = typeof r == "number" ? {
+function a(e) {
+	let { direction: n = "both", threshold: r = 0 } = e, a = typeof r == "number" ? {
 		top: r,
 		bottom: r,
 		left: r,
@@ -185,56 +31,38 @@ function l(e) {
 		bottom: r.bottom ?? 0,
 		left: r.left ?? 0,
 		right: r.right ?? 0
-	}, s = () => typeof e.element == "function" ? e.element() : e.element, l = () => {
-		let e = s(), t = (e, t) => ({
+	}, o = () => typeof e.element == "function" ? e.element() : e.element, s = () => {
+		let e = o(), t = (e, t) => ({
 			reached: e,
 			remaining: Math.max(0, t)
 		});
 		if (!e) return {
-			top: c,
-			bottom: c,
-			left: c,
-			right: c
+			top: i,
+			bottom: i,
+			left: i,
+			right: i
 		};
-		let r = e.scrollTop, i = e.scrollHeight - e.scrollTop - e.clientHeight, a = e.scrollLeft, l = e.scrollWidth - e.scrollLeft - e.clientWidth;
+		let r = e.scrollTop, s = e.scrollHeight - e.scrollTop - e.clientHeight, c = e.scrollLeft, l = e.scrollWidth - e.scrollLeft - e.clientWidth;
 		return {
-			top: n === "horizontal" ? c : t(r <= o.top, r),
-			bottom: n === "horizontal" ? c : t(i <= o.bottom, i),
-			left: n === "vertical" ? c : t(a <= o.left, a),
-			right: n === "vertical" ? c : t(l <= o.right, l)
+			top: n === "horizontal" ? i : t(r <= a.top, r),
+			bottom: n === "horizontal" ? i : t(s <= a.bottom, s),
+			left: n === "vertical" ? i : t(c <= a.left, c),
+			right: n === "vertical" ? i : t(l <= a.right, l)
 		};
-	};
+	}, { subscribe: c, notify: l } = t({ onFirstSubscribe() {
+		let e = o();
+		if (!e) return;
+		let t = () => l();
+		return e.addEventListener("scroll", t, { passive: !0 }), () => e.removeEventListener("scroll", t);
+	} });
 	return {
-		get: l,
-		subscribe: (e, t = {}) => {
-			let n = s();
-			if (!n) return e(l()), () => {};
-			let r = i(() => e(l()), t), a = () => e(l());
-			return n.addEventListener("scroll", a, { passive: !0 }), () => {
-				r(), n.removeEventListener("scroll", a);
-			};
-		},
+		get: s,
+		subscribe: (e, t = {}) => o() ? c(() => e(s()), t) : (e(s()), () => {}),
 		"~": {
 			output: null,
-			notify: a
+			notify: l
 		}
 	};
 }
 //#endregion
-//#region src/web/session-storage.ts
-function u(e) {
-	return r({
-		kind: "sessionStorage",
-		...e
-	});
-}
-//#endregion
-//#region src/web/session-storage-value.ts
-function d(e) {
-	return "storage" in e ? a(e) : a({
-		...e,
-		kind: "sessionStorage"
-	});
-}
-//#endregion
-export { n as createIsOnline, i as createLocalStorage, o as createLocalStorageValue, s as createMediaQuery, l as createScrollState, u as createSessionStorage, d as createSessionStorageValue };
+export { n as createIsOnline, r as createMediaQuery, a as createScrollState };

package/package.json

@@ -2,7 +2,7 @@
   "name": "seitu",
   "displayName": "Seitu",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "private": false,
   "author": "Valerii Strilets",
   "license": "MIT",
@@ -39,6 +39,10 @@
     "./vue": {
       "types": "./dist/vue/index.d.ts",
       "import": "./dist/vue.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils.js"
     }
   },
   "main": "./dist/core.js",

package/dist/core-vtgV_plC.js

@@ -1,187 +0,0 @@
-//#region src/core/subscription.ts
-function e(e) {
-	let t = /* @__PURE__ */ new Set(), n = () => t.forEach((e) => e()), r;
-	return {
-		subscribe(n, i) {
-			return t.size === 0 && e?.onFirstSubscribe && (r = e.onFirstSubscribe() ?? void 0), i?.immediate && n(), t.add(n), () => {
-				t.delete(n), t.size === 0 && (r?.(), r = void 0);
-			};
-		},
-		notify: n
-	};
-}
-//#endregion
-//#region src/core/computed.ts
-function t(t, n) {
-	let { subscribe: r, notify: i } = e(), a = Array.isArray(t) ? t : [t], o = !Array.isArray(t), s = () => n(o ? a[0].get() : a.map((e) => e.get()));
-	for (let e of a) e.subscribe(() => i());
-	return {
-		get: s,
-		subscribe(e, t) {
-			return r(() => e(s()), t);
-		},
-		"~": {
-			output: null,
-			notify: i
-		}
-	};
-}
-//#endregion
-//#region src/core/debounce.ts
-function n(t, n) {
-	let r = t.get(), i, { subscribe: a, notify: o } = e({ onFirstSubscribe() {
-		let e = t.subscribe(() => {
-			clearTimeout(i), i = setTimeout(() => {
-				r = t.get(), o();
-			}, n);
-		});
-		return () => {
-			clearTimeout(i), e();
-		};
-	} }), s = () => r;
-	return {
-		get: s,
-		subscribe(e, t) {
-			return a(() => e(s()), t);
-		},
-		"~": {
-			output: null,
-			notify: o
-		}
-	};
-}
-//#endregion
-//#region src/core/debounce-fn.ts
-function r(t, n) {
-	let r, i, { subscribe: a, notify: o } = e(), s = () => r;
-	return Object.assign((...e) => {
-		clearTimeout(i), i = setTimeout(() => {
-			r = t(...e), o();
-		}, n);
-	}, {
-		get: s,
-		subscribe: (e, t) => a(() => e(s()), t),
-		"~": {
-			output: void 0,
-			notify: o
-		}
-	});
-}
-//#endregion
-//#region src/utils.ts
-function i(e) {
-	if (typeof e != "string") return e;
-	try {
-		return JSON.parse(e);
-	} catch {
-		return e;
-	}
-}
-//#endregion
-//#region src/core/schema-store.ts
-function a(t) {
-	let { subscribe: n, notify: r } = e(), a = { ...t.defaultValues }, s = t.provider ?? o(), c = () => {
-		let e = { ...a };
-		for (let [n, r] of Object.entries(t.schemas)) {
-			let t = s.get()[n], o = r["~standard"].validate(i(t));
-			if (o instanceof Promise) throw TypeError("[createStorage] Validation schema should not return a Promise.");
-			o.issues && console.warn(`[createSchemaStore] Returned value invalid for key ${String(n)}, returned default value instead`, JSON.stringify(o.issues, null, 2), { cause: o.issues }), e[n] = o.issues ? a[n] : o.value;
-		}
-		return e;
-	};
-	return {
-		get: c,
-		set: (e) => {
-			let t = typeof e == "function" ? e(c()) : e;
-			s.set(t), r();
-		},
-		getDefaultValue: (e) => a[e],
-		subscribe: (e, t) => n(() => e(c()), t),
-		"~": {
-			output: null,
-			notify: r
-		}
-	};
-}
-function o() {
-	let e = s({});
-	return {
-		get: () => e.get(),
-		set: (t) => {
-			e.set(t);
-		}
-	};
-}
-//#endregion
-//#region src/core/store.ts
-function s(t) {
-	let n = t, { subscribe: r, notify: i } = e(), a = () => n;
-	return {
-		get: a,
-		set: (e) => {
-			let t = typeof e == "function" ? e(n) : e;
-			t !== n && (n = t, i());
-		},
-		subscribe(e, t) {
-			return r(() => e(a()), t);
-		},
-		"~": {
-			output: null,
-			notify: i
-		}
-	};
-}
-//#endregion
-//#region src/core/throttle.ts
-function c(t, n) {
-	let r = t.get(), i, a = !1, { subscribe: o, notify: s } = e({ onFirstSubscribe() {
-		let e = t.subscribe(() => {
-			if (i) {
-				a = !0;
-				return;
-			}
-			r = t.get(), s(), i = setTimeout(() => {
-				i = void 0, a && (a = !1, r = t.get(), s());
-			}, n);
-		});
-		return () => {
-			clearTimeout(i), i = void 0, a = !1, e();
-		};
-	} }), c = () => r;
-	return {
-		get: c,
-		subscribe(e, t) {
-			return o(() => e(c()), t);
-		},
-		"~": {
-			output: null,
-			notify: s
-		}
-	};
-}
-//#endregion
-//#region src/core/throttle-fn.ts
-function l(t, n) {
-	let r, i, a, { subscribe: o, notify: s } = e(), c = () => r;
-	return Object.assign((...e) => {
-		if (i) {
-			a = e;
-			return;
-		}
-		r = t(...e), s(), i = setTimeout(() => {
-			if (i = void 0, a) {
-				let e = a;
-				a = void 0, r = t(...e), s();
-			}
-		}, n);
-	}, {
-		get: c,
-		subscribe: (e, t) => o(() => e(c()), t),
-		"~": {
-			output: void 0,
-			notify: s
-		}
-	});
-}
-//#endregion
-export { o as a, n as c, a as i, t as l, c as n, i as o, s as r, r as s, l as t, e as u };

package/dist/web/local-storage-value.d.ts

@@ -1,68 +0,0 @@
-import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { LocalStorage } from './local-storage';
-import type { WebStorageValue as LocalStorageValue, WebStorageValueOptionsWithSchema as LocalStorageValueOptionsWithSchema, WebStorageValueOptionsWithStorage as LocalStorageValueOptionsWithStorage } from './web-storage-value';
-export type { LocalStorageValue, LocalStorageValueOptionsWithSchema, LocalStorageValueOptionsWithStorage, };
-/**
- * Creates a reactive handle for a single localStorage value.
- *
- * Two modes:
- * - **Schema mode** (`schema`, `key`, `defaultValue`): standalone key with validation. Missing or
- *   invalid stored data returns `defaultValue`.
- * - **Storage mode** (`storage`, `key`): binds to one key of a `createLocalStorage` instance.
- *   Type and default come from that storage.
- *
- * @example Vanilla
- * ```ts twoslash title="local-storage-value.ts"
- * import { createLocalStorageValue } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const value = createLocalStorageValue({
- *   key: 'count',
- *   defaultValue: 0,
- *   schema: z.number(),
- * })
- * value.get() // 0
- * value.set(1)
- * value.set(v => v + 1)
- * value.subscribe(v => console.log(v))
- * ```
- *
- * @example Storage mode
- * ```ts twoslash title="local-storage-value.ts"
- * import { createLocalStorage, createLocalStorageValue } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const storage = createLocalStorage({
- *   schemas: { count: z.number(), name: z.string() },
- *   defaultValues: { count: 0, name: '' },
- * })
- * const count = createLocalStorageValue({ storage, key: 'count' })
- * count.set(5)
- * storage.get().count === 5 // true
- * ```
- *
- * @example React
- * ```tsx twoslash title="page.tsx"
- * 'use client'
- *
- * import { createLocalStorageValue } from 'seitu/web'
- * import { useSubscription } from 'seitu/react'
- * import * as z from 'zod'
- *
- * export default function Page() {
- *   const count = useSubscription(() => createLocalStorageValue({
- *     key: 'count',
- *     defaultValue: 0,
- *     schema: z.number(),
- *   }))
- *
- *   return (
- *     <div>
- *       <span>{count}</span>
- *     </div>
- *   )
- * }
- * ```
- */
-export declare function createLocalStorageValue<Storage extends LocalStorage<any>, K extends keyof Storage['~']['output']>(options: LocalStorageValueOptionsWithStorage<Storage, K>): LocalStorageValue<Storage['~']['output'][K]>;
-export declare function createLocalStorageValue<S extends StandardSchemaV1<unknown>>(options: LocalStorageValueOptionsWithSchema<S>): LocalStorageValue<StandardSchemaV1.InferOutput<S>>;

package/dist/web/local-storage.d.ts

@@ -1,50 +0,0 @@
-import type { SchemaStoreOutput, SchemaStoreSchema } from '../core/index';
-import type { WebStorage as LocalStorage, WebStorageOptions as LocalStorageOptions } from './web-storage';
-export type { LocalStorage, LocalStorageOptions };
-/**
- * Creates a reactive handle for a localStorage instance.
- *
- * @example Vanilla
- * ```ts twoslash title="local-storage.ts"
- * import { createLocalStorage } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const localStorage = createLocalStorage({
- *   schemas: {
- *     token: z.string().nullable(),
- *     preferences: z.object({ theme: z.enum(['light', 'dark']) }),
- *   },
- *   defaultValues: { token: null, preferences: { theme: 'light' } },
- * })
- *
- * localStorage.get() // { token: null, preferences: { theme: 'light' } }
- * localStorage.set({ token: 'abc' })
- * localStorage.get() // { token: 'abc', preferences: { theme: 'light' } }
- * localStorage.subscribe(console.log)
- * ```
- *
- * @example React
- * ```tsx twoslash title="page.tsx"
- * 'use client'
- *
- * import { createLocalStorage } from 'seitu/web'
- * import { useSubscription } from 'seitu/react'
- * import * as z from 'zod'
- *
- * const localStorage = createLocalStorage({
- *   schemas: { count: z.number(), name: z.string() },
- *   defaultValues: { count: 0, name: '' },
- * })
- *
- * export default function Page() {
- *   const value = useSubscription(localStorage)
- *   return (
- *     <div>
- *       <span>{value.count}</span>
- *       <span>{value.name}</span>
- *     </div>
- *   )
- * }
- * ```
- */
-export declare function createLocalStorage<S extends SchemaStoreSchema>(options: LocalStorageOptions<S>): LocalStorage<SchemaStoreOutput<S>>;

package/dist/web/session-storage-value.d.ts

@@ -1,68 +0,0 @@
-import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { SessionStorage } from './session-storage';
-import type { WebStorageValue as SessionStorageValue, WebStorageValueOptionsWithSchema as SessionStorageValueOptionsWithSchema, WebStorageValueOptionsWithStorage as SessionStorageValueOptionsWithStorage } from './web-storage-value';
-export type { SessionStorageValue, SessionStorageValueOptionsWithSchema, SessionStorageValueOptionsWithStorage, };
-/**
- * Creates a reactive handle for a single sessionStorage value.
- *
- * Two modes:
- * - **Schema mode** (`schema`, `key`, `defaultValue`): standalone key with validation. Missing or
- *   invalid stored data returns `defaultValue`.
- * - **Storage mode** (`storage`, `key`): binds to one key of a `createSessionStorage` instance.
- *   Type and default come from that storage.
- *
- * @example Vanilla
- * ```ts twoslash title="session-storage-value.ts"
- * import { createSessionStorageValue } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const value = createSessionStorageValue({
- *   key: 'count',
- *   defaultValue: 0,
- *   schema: z.number(),
- * })
- * value.get() // 0
- * value.set(1)
- * value.set(v => v + 1)
- * value.subscribe(v => console.log(v))
- * ```
- *
- * @example Storage mode
- * ```ts twoslash title="session-storage-value.ts"
- * import { createSessionStorage, createSessionStorageValue } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const storage = createSessionStorage({
- *   schemas: { count: z.number(), name: z.string() },
- *   defaultValues: { count: 0, name: '' },
- * })
- * const count = createSessionStorageValue({ storage, key: 'count' })
- * count.set(5)
- * storage.get().count === 5 // true
- * ```
- *
- * @example React
- * ```tsx twoslash title="page.tsx"
- * 'use client'
- *
- * import { createSessionStorageValue } from 'seitu/web'
- * import { useSubscription } from 'seitu/react'
- * import * as z from 'zod'
- *
- * export default function Page() {
- *   const count = useSubscription(() => createSessionStorageValue({
- *     key: 'count',
- *     defaultValue: 0,
- *     schema: z.number(),
- *   }))
- *
- *   return (
- *     <div>
- *       <span>{count}</span>
- *     </div>
- *   )
- * }
- * ```
- */
-export declare function createSessionStorageValue<Storage extends SessionStorage<any>, K extends keyof Storage['~']['output']>(options: SessionStorageValueOptionsWithStorage<Storage, K>): SessionStorageValue<Storage['~']['output'][K]>;
-export declare function createSessionStorageValue<S extends StandardSchemaV1<unknown>>(options: SessionStorageValueOptionsWithSchema<S>): SessionStorageValue<StandardSchemaV1.InferOutput<S>>;

package/dist/web/session-storage.d.ts

@@ -1,50 +0,0 @@
-import type { SchemaStoreOutput, SchemaStoreSchema } from '../core/index';
-import type { WebStorage as SessionStorage, WebStorageOptions as SessionStorageOptions } from './web-storage';
-export type { SessionStorage, SessionStorageOptions };
-/**
- * Creates a reactive handle for a sessionStorage instance.
- *
- * @example Vanilla
- * ```ts twoslash title="session-storage.ts"
- * import { createSessionStorage } from 'seitu/web'
- * import * as z from 'zod'
- *
- * const sessionStorage = createSessionStorage({
- *   schemas: {
- *     token: z.string().nullable(),
- *     preferences: z.object({ theme: z.enum(['light', 'dark']) }),
- *   },
- *   defaultValues: { token: null, preferences: { theme: 'light' } },
- * })
- *
- * sessionStorage.get() // { token: null, preferences: { theme: 'light' } }
- * sessionStorage.set({ token: 'abc' })
- * sessionStorage.get() // { token: 'abc', preferences: { theme: 'light' } }
- * sessionStorage.subscribe(console.log)
- * ```
- *
- * @example React
- * ```tsx twoslash title="page.tsx"
- * 'use client'
- *
- * import { createSessionStorage } from 'seitu/web'
- * import { useSubscription } from 'seitu/react'
- * import * as z from 'zod'
- *
- * const sessionStorage = createSessionStorage({
- *   schemas: { count: z.number(), name: z.string() },
- *   defaultValues: { count: 0, name: '' },
- * })
- *
- * export default function Page() {
- *   const value = useSubscription(sessionStorage)
- *   return (
- *     <div>
- *       <span>{value.count}</span>
- *       <span>{value.name}</span>
- *     </div>
- *   )
- * }
- * ```
- */
-export declare function createSessionStorage<S extends SchemaStoreSchema>(options: SessionStorageOptions<S>): SessionStorage<SchemaStoreOutput<S>>;