gjendje 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Charlie Beckstrand
+
+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,143 @@
+<img src="https://raw.githubusercontent.com/charliebeckstrand/habitat/main/logo.png" alt="Screenshot" width="100" />
+
+# stead
+
+**stead** brings state management to multiple storage backends through one consistent API.
+
+## Install
+
+```sh
+pnpm add stead
+```
+
+## Examples
+
+#### localStorage
+```ts
+import { state } from 'stead'
+
+const theme = state('theme', {
+  default: 'light',
+  scope: 'local',
+  ssr: true // optional AsyncLocalStorage
+})
+
+theme.get()
+theme.set('dark')
+```
+
+#### Storage Buckets
+```ts
+import { state } from 'stead'
+
+const settings = state('settings', {
+  default: { notifications: true, theme: 'light' },
+  scope: 'bucket',
+  bucket: {
+    name: 'app-settings',
+  },
+})
+
+await settings.ready
+
+settings.set(prev => ({ ...prev, notifications: false }))
+```
+
+## Configure
+
+```ts
+configure(config: SteadConfig): void
+```
+
+Sets global defaults for all state instances. Call once at app startup before creating any state.
+
+#### Settings
+
+- `defaultScope` — `'render'`
+- `keyPattern`
+- `logLevel` — `'warn'`
+- `maxKeys`
+- `prefix`
+- `requireValidation`
+- `ssr`
+- `sync`
+- `warnOnDuplicate`
+
+#### Lifecycle hooks
+
+- `onDestroy`
+- `onError`
+- `onHydrate`
+- `onMigrate`
+- `onQuotaExceeded`
+- `onRegister`
+- `onSync`
+
+[Full configure reference](https://github.com/charliebeckstrand/habitat/blob/main/docs/configure.md) — all options, validation, error handling, and examples.
+
+## Scopes
+
+|Scope      |Description                                             |
+|-----------|--------------------------------------------------------|
+|`render`   | `memory` |
+|`local`    |`localStorage`                      |
+|`server`   |`AsyncLocalStorage`                            |
+|`bucket`   | `Storage Buckets` |
+|`url`      |`URLSearchParams` |
+|`tab`      |`sessionStorage` |
+
+## API
+
+Every `state()` instance exposes the same interface regardless of scope.
+
+#### `get()`
+Returns the current value. Reactive — triggers tracking in `computed` and `effect`.
+
+#### `set(value)` / `set(prev => next)`
+Replaces the current value. Accepts a direct value or an updater function that receives the previous value.
+
+#### `subscribe(fn)`
+Calls `fn` on every change. Returns an `unsubscribe` function.
+
+#### `watch(key, fn)`
+Like `subscribe`, but scoped to a single key within an object value. Only fires when that key changes.
+
+#### `intercept(fn)`
+Receives `(next, prev)` before each update. Return the value to store, or return `prev` to reject the change. Returns an `unsubscribe` function.
+
+[Full API reference](https://github.com/charliebeckstrand/habitat/blob/main/docs/api.md) — all methods, promise lifecycle, options, and types.
+
+## Middleware
+
+Primitives that plug into the update pipeline of any state instance.
+
+#### `intercept(fn)`
+Runs **before** a value is stored. Receives `(next, prev)` and returns the value to actually persist. Return `prev` to reject the update. Multiple interceptors run in registration order.
+
+#### `use(fn)`
+Runs **after** a value is stored. Receives `(next, prev)`. Return value is ignored. Useful for logging, analytics, or syncing external systems.
+
+## Derived state
+
+Primitives that build on top of `state` to handle computed values, collections, and side effects.
+
+#### `computed(deps, fn)`
+Derives a reactive, read-only value from one or more state dependencies. Recomputes only when a dependency changes and caches the result between changes. Returns a `ReadonlyInstance` — no `set()` or `reset()`.
+
+#### `collection(key, options)`
+Reactive array with first-class mutation methods — `add`, `remove`, `update`, `find`, `findAll`, `has`, `clear`. Supports all the same scopes, persistence, validation, and migration as `state`.
+
+#### `effect(deps, fn)`
+Runs a side effect immediately and re-runs whenever any dependency changes. The callback can return a cleanup function that runs before the next execution and on `stop()`. Returns an `EffectHandle` with a `stop()` method.
+
+## React
+
+[Full React API reference](https://github.com/charliebeckstrand/habitat/blob/main/docs/react.md)
+
+## License
+
+MIT
+
+## Icon
+
+Created by [Gulraiz](https://www.flaticon.com/authors/gulraiz)