shelving 1.191.1 → 1.192.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shelving",
-	"version": "1.191.1",
+	"version": "1.192.0",
 	"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/schema/AddressSchema.d.ts

@@ -1,5 +1,7 @@
-import { type AddressData } from "../util/geo.js";
+import { type AddressData, formatAddress } from "../util/geo.js";
 import { DataSchema, type DataSchemaOptions } from "./DataSchema.js";
+export type { AddressData };
+export { formatAddress };
 /** Allowed options for `AddressSchema` */
 export interface AddressSchemaOptions extends Omit<DataSchemaOptions<AddressData>, "props"> {
 }

package/schema/AddressSchema.js

@@ -3,11 +3,12 @@ import { COUNTRY } from "./CountrySchema.js";
 import { DataSchema } from "./DataSchema.js";
 import { NULLABLE } from "./NullableSchema.js";
 import { StringSchema } from "./StringSchema.js";
+export { formatAddress };
 const ADDRESS_PROPS = {
     address1: new StringSchema({ title: "Address 1", max: 60, min: 1 }),
     address2: new StringSchema({ title: "Address 2", max: 60, min: 0 }),
     city: new StringSchema({ title: "City", min: 1, max: 60 }),
-    state: new StringSchema({ title: "State", min: 1, max: 60 }),
+    state: new StringSchema({ title: "State", min: 0, max: 60 }),
     postcode: new StringSchema({ title: "Postcode", min: 1, max: 12, case: "upper" }),
     country: COUNTRY,
 };

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.

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.