@oddkin/state 0.0.0-stage → 1.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Brady
+
+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

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# @oddkin/state
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional stores, selectors, context, persistence, and inspection. Reusable components never need it: an application feature owns a store and hands values to components as properties.
+
+**Status:** M6 in progress. Implemented: `./store` and `./context` (both re-exported from the root entry), `./inspect`, and `./persist`. Contract: [core-contracts.md §7](../../docs/architecture/core-contracts.md); entries: [packages.md](../../docs/architecture/packages.md).
+
+## Stores (`@oddkin/state/store`, DOM-free)
+
+```js
+import { action, createStore, shallowEqual } from '@oddkin/state/store';
+
+const cart = createStore({ items: [], coupon: '' }, { name: 'cart' });
+const count = cart.select((state) => state.items.length); // memoized readable
+const summary = cart.select((s) => ({ count: s.items.length, coupon: s.coupon }), {
+  equals: shallowEqual,
+});
+
+export const addItem = action('cart/add', (item) => {
+  cart.update((state) => ({ ...state, items: [...state.items, item] }));
+});
+```
+
+- `cart.state` and selectors are ordinary Oddkin readables: bind them in templates (`${count}`), read them in effects, combine them with other signals. A selector follows the store only while something observes it, and notifies only when the selected value changes.
+- `cart.getSnapshot` and `cart.subscribe` are the shared external-store contract, so `useSyncExternalStore(cart.subscribe, cart.getSnapshot)` in React and `fromExternal(cart)` in Oddkin take the store as is. Subscribers are notified once per `batch()` or `action()`.
+- Every snapshot's plain objects and arrays are frozen in both builds, so mutating one throws. Build the next snapshot instead and keep unchanged parts by reference; replace maps and sets (`new Map(map).set(key, value)`). `createStore(initial, { freeze: false })` opts out.
+- `reset()` returns to the initial snapshot; `dispose()` releases every subscriber, after which updates throw `state.store.disposed`.
+
+## Context (`@oddkin/state/context`)
+
+```js
+import { consume, createContext, provide } from '@oddkin/state/context';
+
+export const cartContext = createContext('cart');
+
+// An application shell or any ancestor element provides a value (or a readable to follow):
+class ShopShell extends OddkinElement {
+  #provider = provide(this, cartContext, cart);
+  connected(scope) {
+    scope.use(this.#provider);
+  }
+}
+
+// A descendant reads the nearest provider's value as a readable:
+class CartBadge extends OddkinElement {
+  cart = consume(this, cartContext, { required: true });
+  connected(scope) {
+    scope.use(this.cart);
+  }
+}
+```
+
+Requests use the community context protocol (`context-request` events), so they cross shadow roots and interoperate with other implementations such as Lit's. The nearest provider wins; a consumer moved elsewhere, or whose provider stops, finds the next provider; a provider that connects later is found too. `required: true` reports `state.context.missing` when nothing answers.
+
+## Persistence (`@oddkin/state/persist`, DOM-free)
+
+```js
+import { persist } from '@oddkin/state/persist';
+
+const persistence = persist(settings, {
+  key: 'settings',
+  version: 2,
+  select: (state) => state.preferences, // nothing is stored unless selected (or the whole state)
+  restore: (state, preferences) => ({ ...state, preferences }),
+  migrate: { 2: (v1) => ({ ...v1, density: 'comfortable' }) },
+  validate: (data) => preferencesModel.validate(data).ok,
+});
+persistence.status.value; // 'empty' | 'restored' | 'rejected' | 'blocked' | 'unavailable'
+```
+
+Stored data is restored, migrated, and validated before `persist()` returns; changes are written once per microtask when the selection changed. Quota errors, unreachable storage, and bad stored data are reported (once per failing streak) and never reach the store or its subscribers. Data from a newer version is left alone until `clear()`.
+
+## Inspection (`@oddkin/state/inspect`)
+
+```js
+import { inspect, storeStats } from '@oddkin/state/inspect';
+
+const inspector = inspect(cart, { limit: 20 });
+addItem({ id: 'tea' });
+inspector.updates; // [{ previous, next, actions: ['cart/add'] }]
+storeStats(); // { stores, subscriptions } — live counts for leak tests
+```
+
+Stores carry only counters and one observer hook; nothing is recorded unless a store is inspected.

package/dist/context/context.d.ts

@@ -0,0 +1,77 @@
+import { type Readable } from '@oddkin/core/reactive';
+import type { Controller } from '@oddkin/core/scope';
+/**
+ * A typed context key. Providers and consumers match keys by identity, so each `createContext()`
+ * call creates a distinct context. Structurally compatible with the community protocol's
+ * `Context<Key, Value>`.
+ */
+export interface Context<T> {
+    /** Name used in diagnostics. */
+    readonly name: string;
+    /** Carries the value type for TypeScript; absent at runtime (community context protocol). */
+    readonly __context__: T;
+}
+/** The value type of a context. */
+export type ContextType<C> = C extends Context<infer T> ? T : never;
+/** Receives a provided value; `unsubscribe` is passed when the request subscribed. */
+export type ContextCallback<T> = (value: T, unsubscribe?: () => void) => void;
+/** Create a context key with a name for diagnostics. */
+export declare function createContext<T>(name: string): Context<T>;
+/** A consumer asks for a context (community context protocol). Bubbles and is composed. */
+export declare class ContextRequestEvent<T> extends Event {
+    readonly context: Context<T>;
+    /** The requesting element; `target` is retargeted across shadow roots. */
+    readonly contextTarget: Element;
+    readonly callback: ContextCallback<T>;
+    /** True when the callback may be called again as the value changes. */
+    readonly subscribe: boolean;
+    constructor(context: Context<T>, contextTarget: Element, callback: ContextCallback<T>, subscribe?: boolean);
+}
+/** A provider announces itself, so enclosing providers and waiting consumers can re-request. */
+export declare class ContextProviderEvent<T> extends Event {
+    readonly context: Context<T>;
+    readonly contextTarget: Node;
+    constructor(context: Context<T>, contextTarget: Node);
+}
+export interface ConsumeOptions<T> {
+    /** The value while no provider supplies one. Default `undefined`. */
+    fallback?: T;
+    /** Report `state.context.missing` when no provider answers as the consumer connects. */
+    required?: boolean;
+}
+/** A readable of the nearest provider's value, activated with `scope.use()`. */
+export interface ContextConsumer<V> extends Readable<V>, Controller {
+    readonly context: Context<unknown>;
+    readonly host: Element;
+    /** True while a provider supplies the value. Tracked like `value`. */
+    readonly provided: boolean;
+    /** Ask again for the nearest provider, e.g. from `moved()` after a state-preserving move. */
+    resolve(): void;
+}
+/** Provides a value to consumers below its host, activated with `scope.use()`. */
+export interface ContextProvider<T> extends Controller {
+    readonly context: Context<T>;
+    readonly host: Node;
+    /** The provided value. Assign a value, or a readable to follow it. */
+    get value(): T;
+    set value(next: T | Readable<T>);
+    /** Consumers currently subscribed to this provider. */
+    readonly consumers: number;
+}
+/**
+ * Provide `value` (or follow a readable) to consumers of `context` below `host`, which may be an
+ * element, a shadow root, or a document. Activate it with `scope.use(provider)`; disposing that
+ * scope stops providing, and its consumers look for the next provider up.
+ */
+export declare function provide<T>(host: Node, context: Context<T>, value: T | Readable<T>): ContextProvider<T>;
+/**
+ * Read `context` from the nearest provider above `host`. Activate it with `scope.use(consumer)`,
+ * usually in `connected(scope)`; the subscription ends with that scope. Until a provider answers,
+ * the value is `fallback` and `provided` is false; a provider that connects later is found when it
+ * announces itself.
+ */
+export declare function consume<T>(host: Element, context: Context<T>, options: ConsumeOptions<T> & {
+    fallback: T;
+}): ContextConsumer<T>;
+export declare function consume<T>(host: Element, context: Context<T>, options?: ConsumeOptions<T>): ContextConsumer<T | undefined>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"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"}

package/dist/context/context.js

@@ -0,0 +1,335 @@
+/**
+ * Context (core-contracts.md §7.2): typed values from the nearest provider in the composed tree,
+ * over the community context protocol (`context-request` events with `context`, `contextTarget`,
+ * `callback`, and `subscribe`; providers stop immediate propagation), so Oddkin providers and
+ * consumers interoperate with other implementations such as Lit's `@lit/context`. A provider also
+ * announces itself with a `context-provider` event so waiting consumers and enclosing providers can
+ * hand consumers over. Between Oddkin peers the provider hands over its readable itself, so a
+ * consumer reads through one reactive graph; other peers receive values through the callback.
+ *
+ * Imports without DOM globals (it only extends `Event`); providers and consumers need a DOM.
+ */
+import { DEV } from '../internal/dev.js';
+import { OddkinError, reportOddkinError } from '@oddkin/core/diagnostics';
+import { READABLE, batch, computed, isReadable, signal, } from '@oddkin/core/reactive';
+/** Create a context key with a name for diagnostics. */
+export function createContext(name) {
+    return Object.freeze({ name });
+}
+/** A consumer asks for a context (community context protocol). Bubbles and is composed. */
+export class ContextRequestEvent extends Event {
+    context;
+    /** The requesting element; `target` is retargeted across shadow roots. */
+    contextTarget;
+    callback;
+    /** True when the callback may be called again as the value changes. */
+    subscribe;
+    constructor(context, contextTarget, callback, subscribe = false) {
+        super('context-request', { bubbles: true, composed: true });
+        this.context = context;
+        this.contextTarget = contextTarget;
+        this.callback = callback;
+        this.subscribe = subscribe;
+    }
+}
+/** A provider announces itself, so enclosing providers and waiting consumers can re-request. */
+export class ContextProviderEvent extends Event {
+    context;
+    contextTarget;
+    constructor(context, contextTarget) {
+        super('context-provider', { bubbles: true, composed: true });
+        this.context = context;
+        this.contextTarget = contextTarget;
+    }
+}
+/** Oddkin consumers tag their callback so an Oddkin provider can hand over its readable. */
+const CONSUMER = Symbol('oddkin.context.consumer');
+const ATTACH = Symbol('oddkin.context.attach');
+const DETACH = Symbol('oddkin.context.detach');
+const targetOf = (event) => event.contextTarget ?? event.composedPath()[0];
+class ConsumerImpl {
+    [READABLE] = true;
+    context;
+    host;
+    #fallback;
+    #required;
+    #source = signal(undefined);
+    #view;
+    #callback;
+    #local;
+    #unsubscribe;
+    #connection;
+    #answered = false;
+    constructor(host, context, options) {
+        this.host = host;
+        this.context = context;
+        this.#fallback = options?.fallback;
+        this.#required = options?.required ?? false;
+        this.#view = computed(() => {
+            const source = this.#source.value;
+            return source ? source.value : this.#fallback;
+        });
+        const callback = (value, unsubscribe) => this.#receive(value, unsubscribe);
+        callback[CONSUMER] = this;
+        this.#callback = callback;
+    }
+    get value() {
+        return this.#view.value;
+    }
+    peek() {
+        return this.#view.peek();
+    }
+    subscribe = (onChange) => this.#view.subscribe(onChange);
+    get provided() {
+        return this.#source.value !== undefined;
+    }
+    connect(scope) {
+        if (scope.disposed)
+            return;
+        this.#disconnect(); // one connection at a time
+        const connection = { scope, waiting: undefined };
+        this.#connection = connection;
+        scope.add(() => {
+            if (this.#connection === connection)
+                this.#disconnect();
+        }, 'context consumer');
+        this.#request();
+        if (this.#required && this.#source.peek() === undefined) {
+            reportOddkinError(new OddkinError('state.context.missing', DEV
+                ? `<${this.host.localName}> requires context "${this.context.name}", but no provider answered when it connected. Provide it on an ancestor that connects first (provide() with scope.use(), or the application's provide), or give the consumer a fallback.`
+                : ''), { code: 'state.context.missing', origin: this.host.localName });
+        }
+    }
+    resolve() {
+        this.#request();
+    }
+    [ATTACH](view, unsubscribe) {
+        this.#answered = true;
+        this.#switch(unsubscribe);
+        this.#source.value = view;
+        this.#stopWaiting();
+    }
+    [DETACH](unsubscribe) {
+        if (unsubscribe !== this.#unsubscribe)
+            return;
+        this.#unsubscribe = undefined;
+        this.#source.value = undefined;
+        if (this.host.isConnected)
+            this.#request();
+    }
+    #receive(value, unsubscribe) {
+        this.#answered = true;
+        batch(() => {
+            this.#switch(unsubscribe);
+            if (this.#local)
+                this.#local.value = value;
+            else
+                this.#local = signal(value);
+            this.#source.value = this.#local;
+        });
+        this.#stopWaiting();
+    }
+    /** Adopt a provider's unsubscribe function, leaving the previous provider. */
+    #switch(unsubscribe) {
+        if (unsubscribe === this.#unsubscribe)
+            return;
+        const previous = this.#unsubscribe;
+        this.#unsubscribe = unsubscribe;
+        previous?.();
+    }
+    #request() {
+        if (!this.#connection)
+            return;
+        this.#answered = false;
+        this.host.dispatchEvent(new ContextRequestEvent(this.context, this.host, this.#callback, true));
+        if (this.#answered || !this.#connection)
+            return;
+        // Nobody answered: leave any previous provider and wait for one to announce itself.
+        const previous = this.#unsubscribe;
+        this.#unsubscribe = undefined;
+        this.#source.value = undefined;
+        previous?.();
+        this.#startWaiting();
+    }
+    #startWaiting() {
+        const connection = this.#connection;
+        if (!connection || connection.waiting)
+            return;
+        connection.waiting = connection.scope.listen(this.host.ownerDocument, 'context-provider', (event) => {
+            if (event.context === this.context)
+                this.#request();
+        });
+    }
+    #stopWaiting() {
+        const connection = this.#connection;
+        const release = connection?.waiting;
+        if (!connection || !release)
+            return;
+        connection.waiting = undefined;
+        release();
+    }
+    #disconnect() {
+        const connection = this.#connection;
+        if (!connection)
+            return;
+        this.#connection = undefined;
+        connection.waiting?.();
+        const previous = this.#unsubscribe;
+        this.#unsubscribe = undefined;
+        this.#source.value = undefined;
+        previous?.();
+    }
+}
+class ProviderImpl {
+    context;
+    host;
+    #current;
+    #view;
+    #subscribers = new Map();
+    #own;
+    #foreign;
+    #connection;
+    constructor(host, context, value) {
+        this.host = host;
+        this.context = context;
+        this.#current = signal(this.#readable(value));
+        this.#view = computed(() => this.#current.value.value);
+    }
+    get value() {
+        return this.#view.value;
+    }
+    set value(next) {
+        this.#current.value = this.#readable(next);
+    }
+    get consumers() {
+        return this.#subscribers.size;
+    }
+    connect(scope) {
+        if (scope.disposed)
+            return;
+        this.#disconnect(); // one connection at a time
+        const connection = {};
+        this.#connection = connection;
+        // Registered first, so it runs after the listeners below are removed.
+        scope.add(() => {
+            if (this.#connection === connection)
+                this.#disconnect();
+        }, 'context provider');
+        scope.listen(this.host, 'context-request', (event) => {
+            if (this.#connection === connection)
+                this.#onRequest(event);
+        });
+        scope.listen(this.host, 'context-provider', (event) => {
+            if (this.#connection === connection)
+                this.#onProvider(event);
+        });
+        this.host.dispatchEvent(new ContextProviderEvent(this.context, this.host));
+    }
+    #readable(value) {
+        if (isReadable(value))
+            return value;
+        if (this.#own)
+            this.#own.value = value;
+        else
+            this.#own = signal(value);
+        return this.#own;
+    }
+    #onRequest(event) {
+        if (event.context !== this.context)
+            return;
+        const target = targetOf(event);
+        if (target === this.host)
+            return; // the host's own request goes to an enclosing provider
+        event.stopImmediatePropagation();
+        const callback = event.callback;
+        if (!event.subscribe) {
+            callback(this.#view.peek()); // one value; never retained
+            return;
+        }
+        let subscription = this.#subscribers.get(callback);
+        if (!subscription) {
+            const created = {
+                host: target,
+                consumer: callback[CONSUMER],
+                unsubscribe: () => this.#remove(callback, created),
+            };
+            subscription = created;
+            this.#subscribers.set(callback, created);
+        }
+        if (subscription.consumer) {
+            subscription.consumer[ATTACH](this.#view, subscription.unsubscribe);
+        }
+        else {
+            this.#watch();
+            callback(this.#view.peek(), subscription.unsubscribe);
+        }
+    }
+    /** A provider appeared below this one: consumers now closer to it move there. */
+    #onProvider(event) {
+        if (event.context !== this.context || targetOf(event) === this.host)
+            return;
+        event.stopPropagation();
+        for (const [callback, subscription] of [...this.#subscribers]) {
+            if (this.#subscribers.get(callback) !== subscription)
+                continue;
+            subscription.host.dispatchEvent(new ContextRequestEvent(this.context, subscription.host, callback, true));
+        }
+    }
+    /** Other implementations' consumers receive values through their callbacks, each isolated. */
+    #watch() {
+        if (this.#foreign)
+            return;
+        this.#foreign = this.#view.subscribe((value) => {
+            for (const [callback, subscription] of [...this.#subscribers]) {
+                if (subscription.consumer || this.#subscribers.get(callback) !== subscription)
+                    continue;
+                try {
+                    callback(value, subscription.unsubscribe);
+                }
+                catch (error) {
+                    reportOddkinError(error, { code: 'state.context.callback', origin: this.context.name });
+                }
+            }
+        });
+    }
+    #remove(callback, subscription) {
+        if (this.#subscribers.get(callback) !== subscription)
+            return;
+        this.#subscribers.delete(callback);
+        if (!this.#foreign)
+            return;
+        for (const other of this.#subscribers.values())
+            if (!other.consumer)
+                return;
+        this.#foreign();
+        this.#foreign = undefined;
+    }
+    /** Stop providing: consumers look for the next provider up (or wait for one). */
+    #disconnect() {
+        if (!this.#connection)
+            return;
+        this.#connection = undefined;
+        this.#foreign?.();
+        this.#foreign = undefined;
+        const subscriptions = [...this.#subscribers];
+        this.#subscribers.clear();
+        for (const [callback, subscription] of subscriptions) {
+            if (subscription.consumer)
+                subscription.consumer[DETACH](subscription.unsubscribe);
+            else if (subscription.host.isConnected)
+                subscription.host.dispatchEvent(new ContextRequestEvent(this.context, subscription.host, callback, true));
+        }
+    }
+}
+/**
+ * Provide `value` (or follow a readable) to consumers of `context` below `host`, which may be an
+ * element, a shadow root, or a document. Activate it with `scope.use(provider)`; disposing that
+ * scope stops providing, and its consumers look for the next provider up.
+ */
+export function provide(host, context, value) {
+    return new ProviderImpl(host, context, value);
+}
+export function consume(host, context, options) {
+    return new ConsumerImpl(host, context, options);
+}
+//# sourceMappingURL=context.js.map

package/dist/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"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"}

package/dist/context/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@oddkin/state/context` — typed values from the nearest provider in the composed tree, over the
+ * community context protocol. Imports without DOM globals; providers and consumers need a DOM.
+ * Contract: docs/architecture/core-contracts.md §7.2.
+ */
+export { ContextProviderEvent, ContextRequestEvent, consume, createContext, provide, } from './context.js';
+export type { ConsumeOptions, Context, ContextCallback, ContextConsumer, ContextProvider, ContextType, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,OAAO,EACP,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,7 @@
+/**
+ * `@oddkin/state/context` — typed values from the nearest provider in the composed tree, over the
+ * community context protocol. Imports without DOM globals; providers and consumers need a DOM.
+ * Contract: docs/architecture/core-contracts.md §7.2.
+ */
+export { ContextProviderEvent, ContextRequestEvent, consume, createContext, provide, } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,OAAO,GACR,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@oddkin/state` root entry: re-exports the store (`./store`) and context (`./context`).
+ * Inspection (`./inspect`) and, when it lands, persistence stay separate imports. Imports without
+ * DOM globals.
+ */
+export * from './store/index.js';
+export * from './context/index.js';
+/**
+ * Package marker read by the plain-HTML example and the docs app skeleton.
+ * @internal
+ */
+export declare const packageName = "@oddkin/state";
+/** @internal Internal packages this package is allowed to depend on. */
+export declare const internalDependencies: readonly string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@oddkin/state` root entry: re-exports the store (`./store`) and context (`./context`).
+ * Inspection (`./inspect`) and, when it lands, persistence stay separate imports. Imports without
+ * DOM globals.
+ */
+export * from './store/index.js';
+export * from './context/index.js';
+/**
+ * Package marker read by the plain-HTML example and the docs app skeleton.
+ * @internal
+ */
+export const packageName = '@oddkin/state';
+/** @internal Internal packages this package is allowed to depend on. */
+export const internalDependencies = ['@oddkin/core'];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,cAAc,CAAC,CAAC"}

package/dist/inspect/index.d.ts

@@ -0,0 +1,33 @@
+import { type Store } from '../store/store.js';
+/** One recorded update. */
+export interface StoreUpdate<T> {
+    readonly previous: T;
+    readonly next: T;
+    /** Names of the actions running when the update was made, outermost first; empty outside an action. */
+    readonly actions: readonly string[];
+}
+export interface InspectOptions {
+    /** Most recent updates kept (default 50). `0` counts updates without keeping them. */
+    limit?: number;
+}
+export interface StoreInspector<T> {
+    readonly store: Store<T>;
+    /** The most recent updates since inspection started, oldest first; at most `limit`. */
+    readonly updates: readonly StoreUpdate<T>[];
+    /** Updates seen since inspection started, including those no longer kept. */
+    readonly recorded: number;
+    /** Live `subscribe()` listeners of the store. */
+    readonly subscribers: number;
+    /** True once inspection stopped, by `dispose()` or because the store was disposed. */
+    readonly stopped: boolean;
+    /** Stop recording. What was recorded stays readable. Idempotent. */
+    dispose(): void;
+}
+/** Live stores (created and not disposed) and live `subscribe()` listeners, across all stores. */
+export declare function storeStats(): {
+    readonly stores: number;
+    readonly subscriptions: number;
+};
+/** Record a store's updates and their actions, keeping the most recent `limit`. */
+export declare function inspect<T>(store: Store<T>, options?: InspectOptions): StoreInspector<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/inspect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAyB,KAAK,KAAK,EAAuB,MAAM,mBAAmB,CAAC;AAE3F,2BAA2B;AAC3B,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,kGAAkG;AAClG,wBAAgB,UAAU,IAAI;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAExF;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,CAmDvF"}