seitu 0.8.0 → 0.9.0

package/dist/core/debounce-fn.d.ts

@@ -0,0 +1,21 @@
+import type { Readable, Subscribable } from './subscription';
+export interface DebouncedFn<A extends unknown[], R> extends Readable<R | undefined>, Subscribable<R | undefined> {
+    (...args: A): void;
+}
+/**
+ * Wraps a plain function in a debounced callable that also acts as a subscribable.
+ *
+ * Each call resets the debounce timer. When the timer fires, the wrapped function
+ * is invoked and its return value becomes the current state, notifying subscribers.
+ *
+ * @example
+ * ```ts twoslash
+ * import { createDebounceFn } from 'seitu'
+ *
+ * const search = createDebounceFn((query: string) => fetch(`/api?q=${query}`), 300)
+ * search.subscribe(result => console.log('result:', result))
+ * search('hello') // debounced — fires after 300ms of inactivity
+ * search.get() // latest return value (undefined until first call)
+ * ```
+ */
+export declare function createDebounceFn<A extends unknown[], R>(fn: (...args: A) => R, wait: number): DebouncedFn<A, R>;

package/dist/core/debounce.d.ts

@@ -0,0 +1,19 @@
+import type { Readable, Subscribable } from './subscription';
+export interface Debounced<T> extends Readable<T>, Subscribable<T> {
+}
+/**
+ * Creates a debounced readable that delays updates from a source subscribable.
+ *
+ * The debounced store will only emit the latest value after `wait` milliseconds
+ * of inactivity from the source.
+ *
+ * @example
+ * ```ts twoslash
+ * import { createStore, createDebounce } from 'seitu'
+ *
+ * const store = createStore('')
+ * const debounced = createDebounce(store, 300)
+ * debounced.subscribe(value => console.log('debounced:', value))
+ * ```
+ */
+export declare function createDebounce<T>(source: Readable<T> & Subscribable<T>, wait: number): Debounced<T>;

package/dist/core/index.d.ts

@@ -1,4 +1,8 @@
 export * from './computed';
+export * from './debounce';
+export * from './debounce-fn';
 export * from './schema-store';
 export * from './store';
 export * from './subscription';
+export * from './throttle';
+export * from './throttle-fn';

package/dist/core/throttle-fn.d.ts

@@ -0,0 +1,23 @@
+import type { Readable, Subscribable } from './subscription';
+export interface ThrottledFn<A extends unknown[], R> extends Readable<R | undefined>, Subscribable<R | undefined> {
+    (...args: A): void;
+}
+/**
+ * Wraps a plain function in a throttled callable that also acts as a subscribable.
+ *
+ * The first call fires immediately. Subsequent calls within the `wait` window are
+ * batched — only the last one fires when the interval elapses. The return value of
+ * the wrapped function becomes the current state, notifying subscribers.
+ *
+ * @example
+ * ```ts twoslash
+ * import { createThrottleFn } from 'seitu'
+ *
+ * const log = createThrottleFn((msg: string) => console.log(msg), 300)
+ * log.subscribe(result => console.log('result:', result))
+ * log('hello') // fires immediately
+ * log('world') // throttled — fires after 300ms
+ * log.get() // latest return value (undefined until first call)
+ * ```
+ */
+export declare function createThrottleFn<A extends unknown[], R>(fn: (...args: A) => R, wait: number): ThrottledFn<A, R>;

package/dist/core/throttle.d.ts

@@ -0,0 +1,19 @@
+import type { Readable, Subscribable } from './subscription';
+export interface Throttled<T> extends Readable<T>, Subscribable<T> {
+}
+/**
+ * Creates a throttled readable that rate-limits updates from a source subscribable.
+ *
+ * Emits the latest value at most once every `wait` milliseconds. The first update
+ * fires immediately, then subsequent updates are batched until the interval elapses.
+ *
+ * @example
+ * ```ts twoslash
+ * import { createStore, createThrottle } from 'seitu'
+ *
+ * const store = createStore('')
+ * const throttled = createThrottle(store, 300)
+ * throttled.subscribe(value => console.log('throttled:', value))
+ * ```
+ */
+export declare function createThrottle<T>(source: Readable<T> & Subscribable<T>, wait: number): Throttled<T>;

package/dist/core-vtgV_plC.js

@@ -0,0 +1,187 @@
+//#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/core.js

@@ -1,2 +1,2 @@
-import { a as e, n as t, o as n, r, t as i } from "./core-C93PiIy9.js";
-export { e as createComputed, t as createSchemaStore, r as createSchemaStoreMemoryProvider, i as createStore, n as createSubscription };
+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 };

package/dist/web.js

@@ -1,4 +1,4 @@
-import { i as e, o as t } from "./core-C93PiIy9.js";
+import { o as e, u as t } from "./core-vtgV_plC.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)), () => {
@@ -43,9 +43,9 @@ function r(n) {
 				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.error("[createWebStorage] Returned value invalid, returned default value instead", JSON.stringify(t.issues, null, 2), { cause: t.issues }) : r[i] = t.value;
+					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, returned default value instead", JSON.stringify(s.issues, null, 2), { cause: s.issues }), r[i] = n.defaultValues[i];
+			} 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;
@@ -113,10 +113,10 @@ function a(n) {
 						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.error("Returned value invalid, returned default value instead", JSON.stringify(e.issues, null, 2), { cause: e.issues });
+							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(JSON.stringify(e.issues, null, 2), { cause: e.issues });
+					} 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;

package/package.json

@@ -2,7 +2,7 @@
   "name": "seitu",
   "displayName": "Seitu",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "private": false,
   "author": "Valerii Strilets",
   "license": "MIT",

package/dist/core-C93PiIy9.js

@@ -1,94 +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/utils.ts
-function n(e) {
-	if (typeof e != "string") return e;
-	try {
-		return JSON.parse(e);
-	} catch {
-		return e;
-	}
-}
-//#endregion
-//#region src/core/schema-store.ts
-function r(t) {
-	let { subscribe: r, notify: a } = e(), o = { ...t.defaultValues }, s = t.provider ?? i(), c = () => {
-		let e = { ...o };
-		for (let [r, i] of Object.entries(t.schemas)) {
-			let t = s.get()[r], a = i["~standard"].validate(n(t));
-			if (a instanceof Promise) throw TypeError("[createStorage] Validation schema should not return a Promise.");
-			a.issues && console.warn(JSON.stringify(a.issues, null, 2), { cause: a.issues }), e[r] = a.issues ? o[r] : a.value;
-		}
-		return e;
-	};
-	return {
-		get: c,
-		set: (e) => {
-			let t = typeof e == "function" ? e(c()) : e;
-			s.set(t), a();
-		},
-		getDefaultValue: (e) => o[e],
-		subscribe: (e, t) => r(() => e(c()), t),
-		"~": {
-			output: null,
-			notify: a
-		}
-	};
-}
-function i() {
-	let e = a({});
-	return {
-		get: () => e.get(),
-		set: (t) => {
-			e.set(t);
-		}
-	};
-}
-//#endregion
-//#region src/core/store.ts
-function a(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
-export { t as a, n as i, r as n, e as o, i as r, a as t };