seitu 0.2.5 → 0.4.0

package/dist/core/index.d.ts

@@ -1,2 +1,3 @@
 export * from './schema-store';
+export * from './store';
 export * from './subscription';

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

@@ -5,6 +5,14 @@ export interface SchemaStoreProvider<S extends SchemaStoreSchema> {
     get: () => SchemaStoreOutput<S>;
     set: (value: Partial<SchemaStoreOutput<S>>) => void;
 }
+/**
+ * Creates an in-memory provider for a schema store. Use as the state backing when you don't
+ * need persistence (e.g. for testing or ephemeral UI state).
+ *
+ * @example
+ * const provider = createSchemaStoreMemoryProvider<typeof schemas>()
+ * const store = createSchemaStore({ schemas, defaultValues, provider })
+ */
 export declare function createSchemaStoreMemoryProvider<S extends SchemaStoreSchema>(): SchemaStoreProvider<S>;
 export type SchemaStoreSchema = Record<string, StandardSchemaV1<unknown, unknown>>;
 export type SchemaStoreOutput<S extends SchemaStoreSchema> = Simplify<{
@@ -18,4 +26,20 @@ export interface SchemaStoreOptions<S extends Record<string, StandardSchemaV1>>
     defaultValues: SchemaStoreOutput<S>;
     provider: SchemaStoreProvider<S>;
 }
+/**
+ * Creates a reactive schema store: state is validated on read, supports partial `set`, and
+ * falls back to default values when validation fails.
+ *
+ * @example
+ * const provider = createSchemaStoreMemoryProvider()
+ * const store = createSchemaStore({
+ *   schemas: { count: z.number(), name: z.string() },
+ *   defaultValues: { count: 0, name: '' },
+ *   provider,
+ * })
+ * store.get()
+ * store.set({ count: 1 })
+ * store.getDefaultValue('count') // 0
+ * store.subscribe(console.log)
+ */
 export declare function createSchemaStore<S extends Record<string, StandardSchemaV1>>(options: SchemaStoreOptions<S>): SchemaStore<SchemaStoreOutput<S>>;

package/dist/core/store.d.ts

@@ -0,0 +1,28 @@
+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).
+ *
+ * - **Standalone**: use `get()`, `set(value | updater)`, `subscribe(callback)` for any state.
+ * - **With schema-store**: use as the state backing for a memory provider.
+ *
+ * @example
+ * const store = createStore({ count: 0 })
+ * store.set(prev => ({ ...prev, count: prev.count + 1 }))
+ * store.subscribe(state => console.log(state))
+ */
+export declare function createStore<T>(initial: T): Store<T>;
+export type Computed<T> = Readable<T> & Subscribable<T>;
+/**
+ * Creates a computed (derived) store from a source store. The computed value is
+ * updated whenever the source updates; it is read-only (no set).
+ *
+ * @example
+ * const count = createStore({ a: 1, b: 2 })
+ * const sum = createComputed(count, s => s.a + s.b)
+ * sum.get() // 3
+ * count.set({ a: 2, b: 2 })
+ * sum.get() // 4
+ */
+export declare function createComputed<T, R>(source: Readable<T> & Subscribable<T>, transform: (value: T) => R): Computed<R>;

package/dist/core/store.test.d.ts

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

package/dist/{core-CO_rFBtK.js → core-DllnjYYg.js}

@@ -7,12 +7,11 @@ function e(e) {
 	}
 }
 function t() {
-	let e = new Map();
+	let e = i({});
 	return {
-		get: () => Object.fromEntries(e.entries()),
+		get: () => e.get(),
 		set: (t) => {
-			e.clear();
-			for (let [n, r] of Object.entries(t)) e.set(n, r);
+			e.set(t);
 		}
 	};
 }
@@ -55,4 +54,34 @@ function r() {
 		}
 	};
 }
-export { e as i, n, t as r, r as t };
+function i(e) {
+	let t = e, { subscribe: n, notify: i } = r(), a = () => t;
+	return {
+		get: a,
+		set: (e) => {
+			let n = typeof e == "function" ? e(t) : e;
+			n !== t && (t = n, i());
+		},
+		subscribe(e) {
+			return n(() => e(a()));
+		},
+		"~": {
+			output: null,
+			notify: i
+		}
+	};
+}
+function a(e, t) {
+	let { subscribe: n, notify: i } = r(), a = () => t(e.get());
+	return e.subscribe(() => i()), {
+		get: a,
+		subscribe(e) {
+			return n(() => e(a()));
+		},
+		"~": {
+			output: null,
+			notify: i
+		}
+	};
+}
+export { t as a, n as i, i as n, e as o, r, a as t };

package/dist/core.js

@@ -1,2 +1,2 @@
-import { n as e, r as t, t as n } from "./core-CO_rFBtK.js";
-export { e as createSchemaStore, t as createSchemaStoreMemoryProvider, n as createSubscription };
+import { a as e, i as t, n, r, t as i } from "./core-DllnjYYg.js";
+export { i as createComputed, t as createSchemaStore, e as createSchemaStoreMemoryProvider, n as createStore, r as createSubscription };

package/dist/react/components.d.ts

@@ -0,0 +1,56 @@
+import type { Readable, Subscribable } from '../core';
+import type { UseSubscriptionOptions } from './hooks';
+export interface SubscriptionProps<S extends Subscribable<any> & Readable<any>, R = S['~']['output']> extends Pick<UseSubscriptionOptions<S, R>, 'selector'> {
+    value: S;
+    children: (value: R) => React.ReactNode;
+}
+/**
+ * Declarative component that subscribes to a reactive value and passes it to a render function.
+ * Re-renders when the value (or selected value) changes. Use when you prefer a component API
+ * over the useSubscription hook.
+ *
+ * @example Basic usage
+ * ```tsx twoslash title="/app/page.tsx"
+ * 'use client'
+ *
+ * import { createSessionStorage } from 'seitu/web'
+ * import { Subscription } 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() {
+ *   return (
+ *     <Subscription value={sessionStorage}>
+ *       {(value) => <div>{value.count}</div>}
+ *     </Subscription>
+ *   )
+ * }
+ * ```
+ *
+ * @example With selector
+ * ```tsx twoslash title="/app/page.tsx"
+ * 'use client'
+ *
+ * import { createSessionStorage } from 'seitu/web'
+ * import { Subscription } 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() {
+ *   return (
+ *     <Subscription value={sessionStorage} selector={(v) => v.count}>
+ *       {(count) => <div>{count}</div>}
+ *     </Subscription>
+ *   )
+ * }
+ * ```
+ */
+export declare function Subscription<S extends Subscribable<any> & Readable<any>, R = S['~']['output']>({ value, selector, children, }: SubscriptionProps<S, R>): import("react").ReactNode;

package/dist/react/components.test.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';

package/dist/react/index.d.ts

@@ -1 +1,2 @@
+export * from './components';
 export * from './hooks';

package/dist/react.js

@@ -278,4 +278,7 @@ function L(t, n) {
 		return e(l.get()), t;
 	}, [l, r]), u;
 }
-export { L as useSubscription };
+function R({ value: e, selector: t, children: n }) {
+	return n(L(e, { selector: t }));
+}
+export { R as Subscription, L as useSubscription };

package/dist/web.js

@@ -1,13 +1,13 @@
-import { i as e, n as t, t as n } from "./core-CO_rFBtK.js";
+import { i as e, o as t, r as n } from "./core-DllnjYYg.js";
 function r(n) {
-	let { kind: r, ...i } = n, a = t({
+	let { kind: r, ...i } = n, a = e({
 		...i,
 		provider: {
 			get: () => {
 				if (typeof window > "u") return i.defaultValues;
-				let t = window[r], n = { ...i.defaultValues };
+				let e = window[r], n = { ...i.defaultValues };
 				for (let r in n) {
-					let a = e(t.getItem(r)), o = i.schemas[r]["~standard"].validate(a);
+					let a = t(e.getItem(r)), o = i.schemas[r]["~standard"].validate(a);
 					if (o instanceof Promise) throw TypeError("[createWebSchemaStore] Validation schema should not return a Promise.");
 					o.issues && console.warn(JSON.stringify(o.issues, null, 2), { cause: o.issues }), n[r] = o.issues ? i.defaultValues[r] : o.value;
 				}
@@ -38,21 +38,21 @@ function i(e) {
 		...e
 	});
 }
-function a(t) {
-	let r = "storage" in t ? t.storage["~"].kind : t.kind, i = `${r}Value`;
-	if ("schema" in t && t.defaultValue === void 0) throw Error(`[${i}] Default value is required`);
-	if (t.key === void 0) throw Error(`[${i}] Key is required`);
-	if (!("schema" in t || "storage" in t)) throw Error(`[${i}] Either schema or storage must be provided`);
-	let a = ("schema" in t ? t.defaultValue : t.storage.getDefaultValue(t.key)) ?? null, { subscribe: o, notify: s } = n(), c = () => {
+function a(e) {
+	let r = "storage" in e ? e.storage["~"].kind : e.kind, i = `${r}Value`;
+	if ("schema" in e && e.defaultValue === void 0) throw Error(`[${i}] Default value is required`);
+	if (e.key === void 0) throw Error(`[${i}] Key is required`);
+	if (!("schema" in e || "storage" in e)) throw Error(`[${i}] Either schema or storage must be provided`);
+	let a = ("schema" in e ? e.defaultValue : e.storage.getDefaultValue(e.key)) ?? null, { subscribe: o, notify: s } = n(), c = () => {
 		if (typeof window > "u") return a;
-		let n = window[r].getItem(t.key);
+		let n = window[r].getItem(e.key);
 		if (n === null) return a;
-		let i = e(n);
+		let i = t(n);
 		try {
-			if ("schema" in t) {
-				let e = t.schema["~standard"].validate(i);
-				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 }), a) : e.value;
+			if ("schema" in e) {
+				let t = e.schema["~standard"].validate(i);
+				if (t instanceof Promise) throw TypeError("Validation schema should not return a Promise.");
+				return t.issues ? (console.error(JSON.stringify(t.issues, null, 2), { cause: t.issues }), a) : t.value;
 			} else return i;
 		} catch {
 			return a !== void 0 && typeof a != "string" ? a : i;
@@ -60,14 +60,14 @@ function a(t) {
 	};
 	return {
 		get: c,
-		set: (e) => {
+		set: (t) => {
 			if (typeof window > "u") return;
-			let n = window[r], i = typeof e == "function" ? e(c()) : e;
-			n.setItem(t.key, typeof i == "string" ? i : JSON.stringify(i)), window.dispatchEvent(new Event("storage")), s();
+			let n = window[r], i = typeof t == "function" ? t(c()) : t;
+			n.setItem(e.key, typeof i == "string" ? i : JSON.stringify(i)), window.dispatchEvent(new Event("storage")), s();
 		},
-		subscribe: (e) => {
-			let n = o(() => e(c())), r = (n) => {
-				n.key === t.key && e(c());
+		subscribe: (t) => {
+			let n = o(() => t(c())), r = (n) => {
+				n.key === e.key && t(c());
 			};
 			return typeof window < "u" && window.addEventListener("storage", r), () => {
 				n(), typeof window < "u" && window.removeEventListener("storage", r);

package/package.json

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