seitu 0.4.7 → 0.5.1

package/dist/core/store.d.ts

@@ -8,8 +8,13 @@ export interface Store<T> extends Readable<T>, Writable<T, T>, Subscribable<T> {
  * - **With schema-store**: use as the state backing for a memory provider.
  *
  * @example
+ * ```ts twoslash
+ * import { createStore } from 'seitu'
+ *
  * const store = createStore({ count: 0 })
  * store.set(prev => ({ ...prev, count: prev.count + 1 }))
  * store.subscribe(state => console.log(state))
+ * store.get() // { count: 0 }
+ * ```
  */
 export declare function createStore<T>(initial: T): Store<T>;

package/dist/web/index.d.ts

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

package/dist/web/is-online.d.ts

@@ -0,0 +1,33 @@
+import type { Destroyable, Readable, Subscribable } from '../core/index';
+export interface IsOnline extends Subscribable<boolean>, Readable<boolean>, Destroyable {
+}
+/**
+ * Creates a reactive handle for browser online status.
+ *
+ * @example Vanilla
+ * ```ts twoslash
+ * import { createIsOnline } from 'seitu/web'
+ *
+ * const isOnline = createIsOnline()
+ *
+ * isOnline.subscribe(value => {
+ *   console.log(value ? 'online' : 'offline')
+ * })
+ *
+ * console.log(isOnline.get())
+ * ```
+ *
+ * @example React
+ * ```tsx twoslash title="page.tsx"
+ * import { createIsOnline } from 'seitu/web'
+ * import { useSubscription } from 'seitu/react'
+ *
+ * const isOnline = createIsOnline()
+ *
+ * function Status() {
+ *   const online = useSubscription(isOnline)
+ *   return online ? 'Connected' : 'Disconnected'
+ * }
+ * ```
+ */
+export declare function createIsOnline(): IsOnline;

package/dist/web/is-online.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -6,11 +6,21 @@ export interface WebStorageValue<V> extends Subscribable<V>, Readable<V>, Writab
 export interface WebStorageValueOptionsWithStorage<Storage extends WebStorage<any>, K extends keyof Storage['~']['output']> {
     storage: Storage;
     key: K;
+    /**
+     * If true, the value will be cleared if the validation fails.
+     *
+     * @default true
+     */
+    clearOnValidationFailure?: boolean;
 }
 export interface WebStorageValueOptionsWithSchema<S extends StandardSchemaV1<unknown>> {
     schema: S;
     key: string;
     defaultValue: StandardSchemaV1.InferOutput<S>;
+    /**
+     * If true, the value will be cleared if the validation fails.
+     */
+    clearOnValidationFailure?: boolean;
 }
 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> & {

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

@@ -1,6 +1,12 @@
 import type { SchemaStore, SchemaStoreOptions, SchemaStoreOutput, SchemaStoreSchema } from '../core/index';
 export interface WebStorageOptions<S extends SchemaStoreSchema> extends Omit<SchemaStoreOptions<S>, 'provider'> {
     keyTransform?: (key: keyof S) => string;
+    /**
+     * If true, the stored value will be cleared if the validation fails.
+     *
+     * @default true
+     */
+    clearOnValidationFailure?: boolean;
 }
 export interface WebStorage<O extends Record<string, unknown>> extends SchemaStore<O> {
     '~': {

package/dist/web.js

@@ -1,7 +1,23 @@
 import { i as e, n as t, o as n } from "./core-3fd1NXIt.js";
+//#region src/web/is-online.ts
+function r() {
+	let { subscribe: e, notify: t } = n(), r = () => typeof navigator > "u" ? !0 : navigator.onLine, i = () => t();
+	return typeof window < "u" && (window.addEventListener("online", i), window.addEventListener("offline", i)), {
+		get: r,
+		subscribe: (t) => e(() => t(r())),
+		destroy: () => {
+			typeof window < "u" && (window.removeEventListener("online", i), window.removeEventListener("offline", i));
+		},
+		"~": {
+			output: null,
+			notify: t
+		}
+	};
+}
+//#endregion
 //#region src/web/web-storage.ts
-function r(n) {
-	let { kind: r, keyTransform: i, defaultValues: a, schemas: o } = n, s = !1, c = t({
+function i(n) {
+	let { kind: r, keyTransform: i, defaultValues: a, schemas: o, clearOnValidationFailure: s } = n, c = !1, l = t({
 		defaultValues: a,
 		schemas: o,
 		provider: {
@@ -9,68 +25,68 @@ function r(n) {
 				if (typeof window > "u") return a;
 				let t = window[r], n = { ...a };
 				for (let r in n) {
-					let s = t.getItem(i ? i(r) : r);
-					if (s === null) {
+					let c = t.getItem(i ? i(r) : r);
+					if (c === null) {
 						n[r] = a[r];
 						continue;
 					}
-					let c = e(s), l = o[r]["~standard"].validate(c);
-					if (l instanceof Promise) throw TypeError("[createWebSchemaStore] Validation schema should not return a Promise.");
-					l.issues && console.warn(JSON.stringify(l.issues, null, 2), { cause: l.issues }), n[r] = l.issues ? a[r] : l.value;
+					let l = e(c), u = o[r]["~standard"].validate(l);
+					if (u instanceof Promise) throw TypeError("[createWebSchemaStore] Validation schema should not return a Promise.");
+					u.issues && (s ? t.removeItem(i ? i(r) : r) : console.warn(JSON.stringify(u.issues, null, 2), { cause: u.issues })), n[r] = u.issues ? a[r] : u.value;
 				}
 				return n;
 			},
 			set: (e) => {
 				if (typeof window > "u") return;
 				let t = window[r];
-				s = !0, Object.entries(e).forEach(([e, n]) => {
+				c = !0, Object.entries(e).forEach(([e, n]) => {
 					let r = typeof n == "string" ? n : JSON.stringify(n);
 					t.setItem(i ? i(e) : e, r);
-				}), window.dispatchEvent(new Event("storage")), s = !1;
+				}), window.dispatchEvent(new Event("storage")), c = !1;
 			}
 		}
-	}), l = () => {
-		s || c["~"].notify();
+	}), u = () => {
+		c || l["~"].notify();
 	};
-	return typeof window < "u" && window.addEventListener("storage", l), {
-		...c,
+	return typeof window < "u" && window.addEventListener("storage", u), {
+		...l,
 		destroy: () => {
-			c.destroy?.(), typeof window < "u" && window.removeEventListener("storage", l);
+			l.destroy?.(), typeof window < "u" && window.removeEventListener("storage", u);
 		},
 		"~": {
 			kind: r,
-			...c["~"]
+			...l["~"]
 		}
 	};
 }
 //#endregion
 //#region src/web/local-storage.ts
-function i(e) {
-	return r({
+function a(e) {
+	return i({
 		kind: "localStorage",
 		...e
 	});
 }
 //#endregion
 //#region src/web/web-storage-value.ts
-function a(t) {
+function o(t) {
 	let r = "storage" in t ? t.storage["~"].kind : t.kind, i = !1, a = `${r}Value`;
 	if ("schema" in t && t.defaultValue === void 0) throw Error(`[${a}] Default value is required`);
 	if (t.key === void 0) throw Error(`[${a}] Key is required`);
 	if (!("schema" in t || "storage" in t)) throw Error(`[${a}] Either schema or storage must be provided`);
 	let o = ("schema" in t ? t.defaultValue : t.storage.getDefaultValue(t.key)) ?? null, { subscribe: s, notify: c } = n(), l = () => {
 		if (typeof window > "u") return o;
-		let n = window[r].getItem(t.key);
-		if (n === null) return o;
-		let i = e(n);
+		let n = window[r], i = n.getItem(t.key);
+		if (i === null) return o;
+		let a = e(i);
 		try {
 			if ("schema" in t) {
-				let e = t.schema["~standard"].validate(i);
+				let e = t.schema["~standard"].validate(a);
 				if (e instanceof Promise) throw TypeError("Validation schema should not return a Promise.");
-				return e.issues ? (console.error(JSON.stringify(e.issues, null, 2), { cause: e.issues }), o) : e.value;
-			} else return i;
+				return e.issues ? (t.clearOnValidationFailure ? n.removeItem(t.key) : console.warn(JSON.stringify(e.issues, null, 2), { cause: e.issues }), o) : e.value;
+			} else return a;
 		} catch {
-			return o !== void 0 && typeof o != "string" ? o : i;
+			return o !== void 0 && typeof o != "string" ? o : a;
 		}
 	}, u = (e) => {
 		i || e.key === t.key && c();
@@ -97,15 +113,15 @@ function a(t) {
 }
 //#endregion
 //#region src/web/local-storage-value.ts
-function o(e) {
-	return "storage" in e ? a(e) : a({
+function s(e) {
+	return "storage" in e ? o(e) : o({
 		...e,
 		kind: "localStorage"
 	});
 }
 //#endregion
 //#region src/web/media-query.ts
-function s(e) {
+function c(e) {
 	let { subscribe: t, notify: r } = n(), i = typeof window > "u" ? null : window.matchMedia(e.query), a = () => i?.matches ?? e.defaultMatches ?? !1, o = () => r();
 	return i?.addEventListener("change", o), {
 		get: a,
@@ -121,11 +137,11 @@ function s(e) {
 }
 //#endregion
 //#region src/web/scroll-state.ts
-var c = {
+var l = {
 	reached: !1,
 	remaining: 0
 };
-function l(e) {
+function u(e) {
 	let { direction: t = "both", threshold: r = 0 } = e, { subscribe: i, notify: a } = n(), o = typeof r == "number" ? {
 		top: r,
 		bottom: r,
@@ -136,31 +152,31 @@ 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 = () => {
+	}, s = () => typeof e.element == "function" ? e.element() : e.element, c = () => {
 		let e = s(), n = (e, t) => ({
 			reached: e,
 			remaining: Math.max(0, t)
 		});
 		if (!e) return {
-			top: c,
-			bottom: c,
-			left: c,
-			right: c
+			top: l,
+			bottom: l,
+			left: l,
+			right: l
 		};
-		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, i = e.scrollHeight - e.scrollTop - e.clientHeight, a = e.scrollLeft, c = e.scrollWidth - e.scrollLeft - e.clientWidth;
 		return {
-			top: t === "horizontal" ? c : n(r <= o.top, r),
-			bottom: t === "horizontal" ? c : n(i <= o.bottom, i),
-			left: t === "vertical" ? c : n(a <= o.left, a),
-			right: t === "vertical" ? c : n(l <= o.right, l)
+			top: t === "horizontal" ? l : n(r <= o.top, r),
+			bottom: t === "horizontal" ? l : n(i <= o.bottom, i),
+			left: t === "vertical" ? l : n(a <= o.left, a),
+			right: t === "vertical" ? l : n(c <= o.right, c)
 		};
 	};
 	return {
-		get: l,
+		get: c,
 		subscribe: (e) => {
 			let t = s();
-			if (!t) return e(l()), () => {};
-			let n = i(() => e(l())), r = () => e(l());
+			if (!t) return e(c()), () => {};
+			let n = i(() => e(c())), r = () => e(c());
 			return t.addEventListener("scroll", r, { passive: !0 }), () => {
 				n(), t.removeEventListener("scroll", r);
 			};
@@ -173,19 +189,19 @@ function l(e) {
 }
 //#endregion
 //#region src/web/session-storage.ts
-function u(e) {
-	return r({
+function d(e) {
+	return i({
 		kind: "sessionStorage",
 		...e
 	});
 }
 //#endregion
 //#region src/web/session-storage-value.ts
-function d(e) {
-	return "storage" in e ? a(e) : a({
+function f(e) {
+	return "storage" in e ? o(e) : o({
 		...e,
 		kind: "sessionStorage"
 	});
 }
 //#endregion
-export { i as createLocalStorage, o as createLocalStorageValue, s as createMediaQuery, l as createScrollState, u as createSessionStorage, d as createSessionStorageValue };
+export { r as createIsOnline, a as createLocalStorage, s as createLocalStorageValue, c as createMediaQuery, u as createScrollState, d as createSessionStorage, f as createSessionStorageValue };

package/package.json

@@ -2,7 +2,7 @@
   "name": "seitu",
   "displayName": "Seitu",
   "type": "module",
-  "version": "0.4.7",
+  "version": "0.5.1",
   "private": false,
   "author": "Valerii Strilets",
   "license": "MIT",
@@ -64,14 +64,14 @@
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.14",
-    "@vitejs/plugin-react": "^6.0.1",
-    "happy-dom": "^20.8.4",
+    "@vitejs/plugin-react": "^5.1.4",
+    "happy-dom": "^20.8.3",
     "react-dom": "^19.2.4",
     "type-fest": "^5.4.4",
     "typescript": "^5.9.3",
-    "vite": "^8.0.0",
+    "vite": "^8.0.0-beta.16",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.0",
+    "vitest": "^4.0.18",
     "zod": "^4.3.6"
   },
   "scripts": {