shelving 1.191.0 → 1.191.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shelving",
-	"version": "1.191.0",
+	"version": "1.191.2",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"repository": {
 		"type": "git",

package/react/useStore.js

@@ -1,5 +1,4 @@
 import { useSyncExternalStore } from "react";
-import { NONE } from "../util/constants.js";
 import { BLACKHOLE } from "../util/function.js";
 import { runSequence } from "../util/sequence.js";
 import { useProps } from "./useProps.js";
@@ -9,7 +8,7 @@ export function useStore(store) {
     // Update `internals` if `store` changes.
     if (store !== internals.store || !internals.subscribe || !internals.getSnapshot) {
         internals.subscribe = onStoreChange => (store ? runSequence(store, onStoreChange, onStoreChange) : BLACKHOLE);
-        internals.getSnapshot = () => (!store ? undefined : store.loading ? NONE : store.value);
+        internals.getSnapshot = () => store?.snapshot;
         internals.store = store;
     }
     useSyncExternalStore(internals.subscribe, internals.getSnapshot);

package/store/Store.d.ts

@@ -34,6 +34,10 @@ export type StoreReducer<I, O, A extends Arguments = []> = (value: O, ...args: A
 export declare class Store<T, TT = T> implements AsyncIterable<T, void, void>, AsyncDisposable {
     /** Deferred sequence this store uses to issue values as they change. */
     readonly next: DeferredSequence<T, void, void>;
+    /**
+     * Snapshot returns either the current reason or the current value (or `NONE` if reason is unset).
+     */
+    get snapshot(): unknown;
     /**
      * Store is considered to be "loading" if it has no value or error.
      * - Calling `this.value` will throw `this.reason` if there's an error reason set, or a `Promise` if there's no value set.
@@ -106,20 +110,24 @@ export declare class Store<T, TT = T> implements AsyncIterable<T, void, void>, A
     through(sequence: AsyncIterable<TT>): AsyncIterable<TT>;
     /**
      * Call a callback and save the returned value to this store.
+     * - If the callback returns an async value, it is awaited and values/errors will be saved.
      */
     call<A extends Arguments>(callback: StoreCallback<TT, A>, ...args: A): Promise<boolean> | boolean;
     /**
      * Send the current value to a callback and save the returned value to this store.
+     * - If the callback returns an async value, it is awaited and values/errors will be saved.
      */
     reduce<A extends Arguments>(reducer: StoreReducer<TT, T, A>, ...args: A): Promise<boolean> | boolean;
     /**
      * Run a callback and ignore any returned value.
+     * - If the callback returns an async value, it is awaited and errors will be saved.
      */
-    run<A extends Arguments>(callback: (...args: A) => void | PromiseLike<void>, ...args: A): Promise<boolean> | boolean;
+    run<A extends Arguments>(callback: (...args: A) => void, ...args: A): Promise<boolean> | boolean;
     /**
      * Send the current value to a callback and ignore any returned value.
+     * - If the callback returns an async value, it is awaited and errors will be saved.
      */
-    send<A extends Arguments>(callback: (value: T, ...args: A) => void | PromiseLike<void>, ...args: A): Promise<boolean> | boolean;
+    send<A extends Arguments>(callback: (value: T, ...args: A) => void, ...args: A): Promise<boolean> | boolean;
     /**
      * Await an async value and save it to this store.
      * - Saves the resolved value.

package/store/Store.js

@@ -26,6 +26,12 @@ import { getStarter } from "../util/start.js";
 export class Store {
     /** Deferred sequence this store uses to issue values as they change. */
     next = new DeferredSequence();
+    /**
+     * Snapshot returns either the current reason or the current value (or `NONE` if reason is unset).
+     */
+    get snapshot() {
+        return this._reason !== undefined ? this._reason : this._value;
+    }
     /**
      * Store is considered to be "loading" if it has no value or error.
      * - Calling `this.value` will throw `this.reason` if there's an error reason set, or a `Promise` if there's no value set.
@@ -165,6 +171,7 @@ export class Store {
     }
     /**
      * Call a callback and save the returned value to this store.
+     * - If the callback returns an async value, it is awaited and values/errors will be saved.
      */
     call(callback, ...args) {
         try {
@@ -181,18 +188,21 @@ export class Store {
     }
     /**
      * Send the current value to a callback and save the returned value to this store.
+     * - If the callback returns an async value, it is awaited and values/errors will be saved.
      */
     reduce(reducer, ...args) {
         return this.call(reducer, this.value, ...args);
     }
     /**
      * Run a callback and ignore any returned value.
+     * - If the callback returns an async value, it is awaited and errors will be saved.
      */
     run(callback, ...args) {
         return this.call(_callSkipped, callback, ...args);
     }
     /**
      * Send the current value to a callback and ignore any returned value.
+     * - If the callback returns an async value, it is awaited and errors will be saved.
      */
     send(callback, ...args) {
         return this.call(_callSkipped, callback, this.value, ...args);