seitu 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Valerii Strilets
+
+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.

package/README.md

@@ -0,0 +1,48 @@
+# Seitu
+
+[![npm version](https://badge.fury.io/js/seitu.svg)](https://npmjs.com/package/seitu)
+![You need Seitu](https://img.shields.io/badge/You_need-Seitu-purple)
+
+Seitu is a lightweight, framework-agnostic, type-safe utilities library for JavaScript applications on the client and server sides.
+
+## Documentation
+
+You can find the documentation [here](https://seitu.letstri.dev).
+
+## Example
+
+To quick start you only need to write the following code:
+
+```tsx
+import { useSubscription } from 'seitu/react'
+import { sessionStorageValue } from 'seitu/web'
+import * as z from 'zod'
+
+const value = sessionStorageValue({
+  key: 'test',
+  defaultValue: 0,
+  schema: z.number(),
+})
+
+value.get() // 0
+value.set(1)
+value.remove()
+value.subscribe(v => console.log(v))
+
+function Counter() {
+  const count = useSubscription(value)
+
+  return (
+    <div>
+      <span>{count}</span>
+      <button onClick={() => value.set(c => c + 1)}>Increment</button>
+    </div>
+  )
+}
+```
+
+Seitu has other powerful features, so check out the [docs](https://seitu.letstri.dev/docs) or the [examples](https://github.com/letstri/seitu/tree/main/examples) directory.
+
+## License
+
+MIT License - see the [LICENSE](https://github.com/letstri/seitu/blob/main/LICENSE) file for details

package/dist/core/index.d.ts

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

package/dist/core/subscription.d.ts

@@ -0,0 +1,19 @@
+export interface Subscribable<V> {
+    'subscribe': (callback: (value: V) => any) => () => void;
+    '~types': {
+        output: V;
+    };
+}
+export interface Readable<T> {
+    get: () => T;
+}
+export interface Writable<T, P extends Partial<T> = T> {
+    set: (value: T | ((prev: P) => T)) => any;
+}
+export interface Removable {
+    remove: () => void;
+}
+export declare function createSubscription<V>(): {
+    subscribe: (callback: (value: V) => any) => () => void;
+    notify: (value: V) => void;
+};

package/dist/core.js

@@ -0,0 +1,14 @@
+function e() {
+	let e = new Set();
+	return {
+		subscribe(t) {
+			return e.add(t), () => {
+				e.delete(t);
+			};
+		},
+		notify(t) {
+			e.forEach((e) => e(t));
+		}
+	};
+}
+export { e as createSubscription };

package/dist/react/hooks.d.ts

@@ -0,0 +1,71 @@
+import type { Readable, Subscribable } from '../core/subscription';
+/**
+ * Use this hook to access a subscription for any function that implements the Subscription interface.
+ *
+ * @kind hook
+ *
+ * @example
+ * ```tsx twoslash title="/app/page.tsx"
+ * 'use client'
+ *
+ * import { sessionStorageValue } from 'seitu/web'
+ * import { useSubscription } from 'seitu/react'
+ * import * as z from 'zod'
+ *
+ * export default function Page() {
+ *   const value = useSubscription(sessionStorageValue({
+ *     key: 'test',
+ *     defaultValue: 0,
+ *     schema: z.number(),
+ *   }))
+ *
+ *   return <div>{value}</div>
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx twoslash title="/app/page.tsx"
+ * 'use client'
+ *
+ * import { sessionStorageValue } from 'seitu/web'
+ * import { useSubscription } from 'seitu/react'
+ * import * as z from 'zod'
+ *
+ * const sessionStorage = sessionStorageValue({
+ *   key: 'test',
+ *   defaultValue: 0,
+ *   schema: z.number(),
+ * })
+ *
+ * export default function Page() {
+ *   const value = useSubscription(sessionStorage)
+ *
+ *   return <div>{value}</div>
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx twoslash title="/app/page.tsx"
+ * 'use client'
+ *
+ * import { createSessionStorage, sessionStorageValue } 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: '' },
+ * })
+ *
+ * // Usage with selector, re-renders only when count changes
+ * export default function Page() {
+ *   const count = useSubscription(sessionStorage, value => value.count)
+ *
+ *   return <div>{count}</div>
+ * }
+ * ```
+ */
+export declare function useSubscription<S extends Subscribable<any> & Readable<any>, R = S['~types']['output']>(subscription: S, selector?: (value: S['~types']['output']) => R): R;

package/dist/react/index.d.ts

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