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

package/dist/inspect/index.js

@@ -0,0 +1,63 @@
+/**
+ * `@oddkin/state/inspect` — bounded inspection of stores for development tools and tests. DOM-free.
+ * A separate import: stores carry only counters and an observer hook, never a log.
+ * Contract: docs/architecture/core-contracts.md §7.
+ */
+import { DEV } from '../internal/dev.js';
+import { OddkinError } from '@oddkin/core/diagnostics';
+import { INTERNALS, liveCounts } from '../store/store.js';
+/** Live stores (created and not disposed) and live `subscribe()` listeners, across all stores. */
+export function storeStats() {
+    return liveCounts();
+}
+/** Record a store's updates and their actions, keeping the most recent `limit`. */
+export function inspect(store, options) {
+    const internals = store[INTERNALS];
+    if (!internals) {
+        throw new OddkinError('state.inspect.unsupported', DEV
+            ? 'inspect() needs a store created by createStore() from this copy of @oddkin/state.'
+            : '');
+    }
+    const limit = options?.limit ?? 50;
+    if (!Number.isInteger(limit) || limit < 0) {
+        throw new OddkinError('state.inspect.limit', DEV ? `inspect() limit must be a whole number of updates (0 or more), not ${limit}.` : '');
+    }
+    const updates = [];
+    let recorded = 0;
+    let stopped = false;
+    const stop = internals.observe({
+        update(record) {
+            recorded++;
+            if (limit === 0)
+                return;
+            if (updates.length === limit)
+                updates.shift();
+            updates.push({ previous: record.previous, next: record.next, actions: record.actions });
+        },
+        dispose() {
+            stopped = true;
+        },
+    });
+    return {
+        store,
+        get updates() {
+            return [...updates];
+        },
+        get recorded() {
+            return recorded;
+        },
+        get subscribers() {
+            return internals.subscribers;
+        },
+        get stopped() {
+            return stopped || store.disposed;
+        },
+        dispose() {
+            if (stopped)
+                return;
+            stopped = true;
+            stop();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/inspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAmC,MAAM,mBAAmB,CAAC;AA6B3F,kGAAkG;AAClG,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAI,KAAe,EAAE,OAAwB;IAClE,MAAM,SAAS,GAAI,KAA8D,CAAC,SAAS,CAAC,CAAC;IAC7F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,2BAA2B,EAC3B,GAAG;YACD,CAAC,CAAC,mFAAmF;YACrF,CAAC,CAAC,EAAE,CACP,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,WAAW,CACnB,qBAAqB,EACrB,GAAG,CAAC,CAAC,CAAC,sEAAsE,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC;QAC7B,MAAM,CAAC,MAAM;YACX,QAAQ,EAAE,CAAC;YACX,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO;YACxB,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO;YACL,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,KAAK;QACL,IAAI,OAAO;YACT,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,WAAW;YACb,OAAO,SAAS,CAAC,WAAW,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC;QACnC,CAAC;QACD,OAAO;YACL,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,EAAE,CAAC;QACT,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/internal/dev.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Development-mode flag. The published production build (dist/prod, the default export condition)
+ * replaces it with false and removes dead branches; the development build keeps full messages.
+ */
+export declare const DEV: boolean;
+//# sourceMappingURL=dev.d.ts.map

package/dist/internal/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/internal/dev.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,OAAc,CAAC"}

package/dist/internal/dev.js

@@ -0,0 +1,6 @@
+/**
+ * Development-mode flag. The published production build (dist/prod, the default export condition)
+ * replaces it with false and removes dead branches; the development build keeps full messages.
+ */
+export const DEV = true;
+//# sourceMappingURL=dev.js.map

package/dist/internal/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/internal/dev.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAY,IAAI,CAAC"}

package/dist/persist/index.d.ts

@@ -0,0 +1,74 @@
+import { OddkinError } from '@oddkin/core/diagnostics';
+import { type Readable } from '@oddkin/core/reactive';
+import { type Store } from '../store/store.js';
+/** The part of the Web Storage API persistence uses; `localStorage` and `sessionStorage` fit. */
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** What is stored under the key: the persisted data and the version of its shape. */
+export interface PersistedEnvelope<P> {
+    readonly version: number;
+    readonly data: P;
+}
+/**
+ * `empty`: nothing was stored. `restored`: stored data was migrated if needed, validated, and
+ * applied. `rejected`: stored data could not be read, migrated, or validated; the store kept its
+ * state and the next change overwrites the entry. `blocked`: the stored version is newer than this
+ * code; nothing is written until `clear()`. `unavailable`: there is no usable storage; the store
+ * works in memory only.
+ */
+export type PersistStatus = 'empty' | 'restored' | 'rejected' | 'blocked' | 'unavailable';
+interface CommonOptions<P> {
+    /** Storage key. One persistence per key. */
+    key: string;
+    /** Version of the persisted shape: a whole number of 1 or more. */
+    version: number;
+    /** Storage, or a function returning it (default: `localStorage` when it can be reached). */
+    storage?: StorageLike | (() => StorageLike | null | undefined);
+    /** Migrations keyed by the version they produce: `{ 2: (v1Data) => v2Data }`. */
+    migrate?: Readonly<Record<number, (data: unknown) => unknown>>;
+    /** Accept restored data in the current version; return false (or throw) to reject it. */
+    validate?: (data: unknown) => boolean;
+    /** Decides whether a new selection must be written. Default `Object.is`. */
+    equals?: (previous: P, next: P) => boolean;
+    /** Default `JSON.stringify`. */
+    serialize?: (envelope: PersistedEnvelope<P>) => string;
+    /** Default `JSON.parse`. */
+    deserialize?: (text: string) => unknown;
+    /** Receives storage and data failures instead of the Oddkin error handler. */
+    onError?: (error: OddkinError) => void;
+}
+/** Persist the whole state; restoring replaces it unless `restore` merges. */
+export interface PersistStateOptions<T> extends CommonOptions<T> {
+    select?: undefined;
+    restore?: (state: T, saved: T) => T;
+}
+/** Persist a selection of the state; `restore` puts it back into the current state. */
+export interface PersistSelectionOptions<T, P> extends CommonOptions<P> {
+    select: (state: T) => P;
+    restore: (state: T, saved: P) => T;
+}
+export interface Persistence {
+    readonly key: string;
+    /** Outcome of the restore, then `empty` after `clear()`. */
+    readonly status: Readable<PersistStatus>;
+    readonly disposed: boolean;
+    /** Write the current selection now if it differs from what was last written or restored. */
+    flush(): void;
+    /** Remove the stored entry and allow writing again; the next change writes. */
+    clear(): void;
+    /** Write a pending change, then stop. Stored data stays. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Persist a store under `options.key`. Restores synchronously before returning (migrating,
+ * validating, and applying stored data as one update named `persist/restore`), then writes the
+ * selection after changes, coalesced to one write per microtask. Storage failures are reported and
+ * never reach the store, its subscribers, or the caller of `update()`.
+ */
+export declare function persist<T>(store: Store<T>, options: PersistStateOptions<T>): Persistence;
+export declare function persist<T, P>(store: Store<T>, options: PersistSelectionOptions<T, P>): Persistence;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/persist/index.js

@@ -0,0 +1,228 @@
+/**
+ * `@oddkin/state/persist` — an optional, versioned persistence adapter for one store
+ * (core-contracts.md §7.3). DOM-free: storage is reached only when `persist()` runs, and any Web
+ * Storage-like object works. Nothing is persisted unless it is selected explicitly or the whole
+ * store is opted in; no component property is ever persisted automatically.
+ */
+import { DEV } from '../internal/dev.js';
+import { OddkinError, reportOddkinError } from '@oddkin/core/diagnostics';
+import { computed, signal } from '@oddkin/core/reactive';
+import { action } from '../store/store.js';
+const NOTHING = Symbol('nothing written');
+function isEnvelope(value) {
+    if (typeof value !== 'object' || value === null || !('data' in value))
+        return false;
+    const version = value.version;
+    return typeof version === 'number' && Number.isInteger(version) && version >= 1;
+}
+export function persist(store, options) {
+    const { key, version } = options;
+    if (typeof key !== 'string' || key === '' || !Number.isInteger(version) || version < 1) {
+        throw new OddkinError('state.persist.options', DEV
+            ? `persist() needs a non-empty key and a whole-number version of 1 or more, not key ${JSON.stringify(key)} and version ${String(version)}.`
+            : '');
+    }
+    if (store.disposed) {
+        throw new OddkinError('state.store.disposed', DEV ? `persist() cannot follow a disposed store (key "${key}").` : '');
+    }
+    const select = (options.select ?? ((state) => state));
+    const restore = (options.restore ?? ((_state, saved) => saved));
+    const equals = (options.equals ?? Object.is);
+    const serialize = (options.serialize ?? JSON.stringify);
+    const deserialize = options.deserialize ?? JSON.parse;
+    const status = signal('empty');
+    const fail = (code, message, cause) => {
+        const error = new OddkinError(code, message, cause === undefined ? undefined : { cause });
+        if (!options.onError)
+            return reportOddkinError(error, { code, origin: key });
+        try {
+            options.onError(error);
+        }
+        catch (handlerError) {
+            reportOddkinError(handlerError, { code, origin: key });
+        }
+    };
+    const reject = (code, message, cause) => {
+        status.value = 'rejected';
+        fail(code, message, cause);
+    };
+    let storage;
+    try {
+        const source = options.storage ?? (() => globalThis.localStorage);
+        storage = (typeof source === 'function' ? source() : source) ?? undefined;
+        if (!storage) {
+            fail('state.persist.unavailable', DEV
+                ? `No storage for "${key}": localStorage does not exist here. Pass a storage option; the store keeps working in memory.`
+                : '');
+        }
+    }
+    catch (error) {
+        storage = undefined;
+        fail('state.persist.unavailable', DEV
+            ? `Storage for "${key}" cannot be reached (for example, storage is disabled or the page is sandboxed); the store keeps working in memory.`
+            : '', error);
+    }
+    let text = null;
+    if (storage) {
+        try {
+            text = storage.getItem(key);
+        }
+        catch (error) {
+            storage = undefined;
+            fail('state.persist.read', DEV ? `Reading "${key}" from storage failed; the store keeps working in memory.` : '', error);
+        }
+    }
+    if (!storage)
+        status.value = 'unavailable';
+    let blocked = false;
+    if (storage && text !== null) {
+        let envelope;
+        let parsed = true;
+        try {
+            envelope = deserialize(text);
+        }
+        catch (error) {
+            parsed = false;
+            reject('state.persist.parse', DEV ? `Stored data for "${key}" could not be parsed; it is ignored.` : '', error);
+        }
+        if (parsed && !isEnvelope(envelope)) {
+            reject('state.persist.parse', DEV
+                ? `Stored data for "${key}" is not a { version, data } envelope with a whole-number version; it is ignored.`
+                : '');
+        }
+        else if (parsed && isEnvelope(envelope) && envelope.version > version) {
+            blocked = true;
+            status.value = 'blocked';
+            fail('state.persist.version', DEV
+                ? `Stored data for "${key}" has version ${envelope.version}, newer than ${version}. It is not applied and not overwritten; call clear() to discard it.`
+                : '');
+        }
+        else if (parsed && isEnvelope(envelope)) {
+            let data = envelope.data;
+            let migrated = true;
+            for (let next = envelope.version + 1; next <= version && migrated; next++) {
+                const step = options.migrate?.[next];
+                if (!step) {
+                    migrated = false;
+                    reject('state.persist.migrate', DEV
+                        ? `Stored data for "${key}" has version ${envelope.version}, and there is no migration to version ${next}; it is ignored.`
+                        : '');
+                    break;
+                }
+                try {
+                    data = step(data);
+                }
+                catch (error) {
+                    migrated = false;
+                    reject('state.persist.migrate', DEV ? `Migrating "${key}" to version ${next} failed; the stored data is ignored.` : '', error);
+                }
+            }
+            if (migrated) {
+                let valid = true;
+                let cause;
+                try {
+                    valid = options.validate ? options.validate(data) : true;
+                }
+                catch (error) {
+                    valid = false;
+                    cause = error;
+                }
+                if (valid) {
+                    try {
+                        action('persist/restore', () => store.update((state) => restore(state, data)))();
+                        status.value = 'restored';
+                    }
+                    catch (error) {
+                        valid = false;
+                        cause = error;
+                    }
+                }
+                if (!valid) {
+                    reject('state.persist.invalid', DEV
+                        ? `Stored data for "${key}" was rejected by validate() or restore(); the store keeps its state.`
+                        : '', cause);
+                }
+            }
+        }
+    }
+    let written = select(store.getSnapshot());
+    let pending = false;
+    let failing = false;
+    let disposed = false;
+    const write = () => {
+        pending = false;
+        if (!storage || blocked)
+            return;
+        const selection = select(store.getSnapshot());
+        if (written !== NOTHING && equals(written, selection))
+            return;
+        let serialized;
+        try {
+            serialized = serialize({ version, data: selection });
+        }
+        catch (error) {
+            if (!failing)
+                fail('state.persist.serialize', DEV
+                    ? `The state for "${key}" could not be serialized (for example a cycle or a BigInt with JSON); it was not written.`
+                    : '', error);
+            failing = true;
+            return;
+        }
+        try {
+            storage.setItem(key, serialized);
+        }
+        catch (error) {
+            if (!failing)
+                fail('state.persist.write', DEV
+                    ? `Writing "${key}" to storage failed (for example the quota is exceeded); later changes try again.`
+                    : '', error);
+            failing = true;
+            return;
+        }
+        failing = false;
+        written = selection;
+    };
+    const unsubscribe = store.subscribe(() => {
+        if (pending || disposed)
+            return;
+        pending = true;
+        queueMicrotask(() => {
+            if (pending && !disposed)
+                write();
+        });
+    });
+    return {
+        key,
+        status: computed(() => status.value),
+        get disposed() {
+            return disposed;
+        },
+        flush() {
+            if (!disposed)
+                write();
+        },
+        clear() {
+            if (disposed || !storage)
+                return;
+            try {
+                storage.removeItem(key);
+            }
+            catch (error) {
+                fail('state.persist.write', DEV ? `Removing "${key}" from storage failed.` : '', error);
+                return;
+            }
+            blocked = false;
+            written = NOTHING;
+            status.value = 'empty';
+        },
+        dispose() {
+            if (disposed)
+                return;
+            if (pending)
+                write();
+            disposed = true;
+            unsubscribe();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/persist/index.js.map

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

package/dist/prod/context/context.js

@@ -0,0 +1,222 @@
+import { OddkinError, reportOddkinError } from "@oddkin/core/diagnostics";
+import { READABLE, batch, computed, isReadable, signal } from "@oddkin/core/reactive";
+function createContext(name) {
+  return Object.freeze({ name });
+}
+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 = !1) {
+    super("context-request", { bubbles: !0, composed: !0 }), this.context = context, this.contextTarget = contextTarget, this.callback = callback, this.subscribe = subscribe;
+  }
+}
+class ContextProviderEvent extends Event {
+  context;
+  contextTarget;
+  constructor(context, contextTarget) {
+    super("context-provider", { bubbles: !0, composed: !0 }), this.context = context, this.contextTarget = contextTarget;
+  }
+}
+const CONSUMER = /* @__PURE__ */ Symbol("oddkin.context.consumer"), ATTACH = /* @__PURE__ */ Symbol("oddkin.context.attach"), DETACH = /* @__PURE__ */ Symbol("oddkin.context.detach"), targetOf = (event) => event.contextTarget ?? event.composedPath()[0];
+class ConsumerImpl {
+  [READABLE] = !0;
+  context;
+  host;
+  #fallback;
+  #required;
+  #source = signal(void 0);
+  #view;
+  #callback;
+  #local;
+  #unsubscribe;
+  #connection;
+  #answered = !1;
+  constructor(host, context, options) {
+    this.host = host, this.context = context, this.#fallback = options?.fallback, this.#required = options?.required ?? !1, 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 !== void 0;
+  }
+  connect(scope) {
+    if (scope.disposed)
+      return;
+    this.#disconnect();
+    const connection = { scope, waiting: void 0 };
+    this.#connection = connection, scope.add(() => {
+      this.#connection === connection && this.#disconnect();
+    }, "context consumer"), this.#request(), this.#required && this.#source.peek() === void 0 && reportOddkinError(new OddkinError("state.context.missing", ""), { code: "state.context.missing", origin: this.host.localName });
+  }
+  resolve() {
+    this.#request();
+  }
+  [ATTACH](view, unsubscribe) {
+    this.#answered = !0, this.#switch(unsubscribe), this.#source.value = view, this.#stopWaiting();
+  }
+  [DETACH](unsubscribe) {
+    unsubscribe === this.#unsubscribe && (this.#unsubscribe = void 0, this.#source.value = void 0, this.host.isConnected && this.#request());
+  }
+  #receive(value, unsubscribe) {
+    this.#answered = !0, batch(() => {
+      this.#switch(unsubscribe), this.#local ? this.#local.value = value : 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 || (this.#answered = !1, this.host.dispatchEvent(new ContextRequestEvent(this.context, this.host, this.#callback, !0)), this.#answered || !this.#connection))
+      return;
+    const previous = this.#unsubscribe;
+    this.#unsubscribe = void 0, this.#source.value = void 0, previous?.(), this.#startWaiting();
+  }
+  #startWaiting() {
+    const connection = this.#connection;
+    !connection || connection.waiting || (connection.waiting = connection.scope.listen(this.host.ownerDocument, "context-provider", (event) => {
+      event.context === this.context && this.#request();
+    }));
+  }
+  #stopWaiting() {
+    const connection = this.#connection, release = connection?.waiting;
+    !connection || !release || (connection.waiting = void 0, release());
+  }
+  #disconnect() {
+    const connection = this.#connection;
+    if (!connection)
+      return;
+    this.#connection = void 0, connection.waiting?.();
+    const previous = this.#unsubscribe;
+    this.#unsubscribe = void 0, this.#source.value = void 0, previous?.();
+  }
+}
+class ProviderImpl {
+  context;
+  host;
+  #current;
+  #view;
+  #subscribers = /* @__PURE__ */ 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();
+    const connection = {};
+    this.#connection = connection, scope.add(() => {
+      this.#connection === connection && this.#disconnect();
+    }, "context provider"), scope.listen(this.host, "context-request", (event) => {
+      this.#connection === connection && this.#onRequest(event);
+    }), scope.listen(this.host, "context-provider", (event) => {
+      this.#connection === connection && this.#onProvider(event);
+    }), this.host.dispatchEvent(new ContextProviderEvent(this.context, this.host));
+  }
+  #readable(value) {
+    return isReadable(value) ? value : (this.#own ? this.#own.value = value : this.#own = signal(value), this.#own);
+  }
+  #onRequest(event) {
+    if (event.context !== this.context)
+      return;
+    const target = targetOf(event);
+    if (target === this.host)
+      return;
+    event.stopImmediatePropagation();
+    const callback = event.callback;
+    if (!event.subscribe) {
+      callback(this.#view.peek());
+      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);
+    }
+    subscription.consumer ? subscription.consumer[ATTACH](this.#view, subscription.unsubscribe) : (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)) {
+      event.stopPropagation();
+      for (const [callback, subscription] of [...this.#subscribers])
+        this.#subscribers.get(callback) === subscription && subscription.host.dispatchEvent(new ContextRequestEvent(this.context, subscription.host, callback, !0));
+    }
+  }
+  /** Other implementations' consumers receive values through their callbacks, each isolated. */
+  #watch() {
+    this.#foreign || (this.#foreign = this.#view.subscribe((value) => {
+      for (const [callback, subscription] of [...this.#subscribers])
+        if (!(subscription.consumer || this.#subscribers.get(callback) !== subscription))
+          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 && (this.#subscribers.delete(callback), !!this.#foreign)) {
+      for (const other of this.#subscribers.values())
+        if (!other.consumer)
+          return;
+      this.#foreign(), this.#foreign = void 0;
+    }
+  }
+  /** Stop providing: consumers look for the next provider up (or wait for one). */
+  #disconnect() {
+    if (!this.#connection)
+      return;
+    this.#connection = void 0, this.#foreign?.(), this.#foreign = void 0;
+    const subscriptions = [...this.#subscribers];
+    this.#subscribers.clear();
+    for (const [callback, subscription] of subscriptions)
+      subscription.consumer ? subscription.consumer[DETACH](subscription.unsubscribe) : subscription.host.isConnected && subscription.host.dispatchEvent(new ContextRequestEvent(this.context, subscription.host, callback, !0));
+  }
+}
+function provide(host, context, value) {
+  return new ProviderImpl(host, context, value);
+}
+function consume(host, context, options) {
+  return new ConsumerImpl(host, context, options);
+}
+export {
+  ContextProviderEvent,
+  ContextRequestEvent,
+  consume,
+  createContext,
+  provide
+};

package/dist/prod/context/index.js

@@ -0,0 +1,8 @@
+import { ContextProviderEvent, ContextRequestEvent, consume, createContext, provide } from "./context.js";
+export {
+  ContextProviderEvent,
+  ContextRequestEvent,
+  consume,
+  createContext,
+  provide
+};

package/dist/prod/index.js

@@ -0,0 +1,7 @@
+export * from "./store/index.js";
+export * from "./context/index.js";
+const packageName = "@oddkin/state", internalDependencies = ["@oddkin/core"];
+export {
+  internalDependencies,
+  packageName
+};