shelving 1.18.0 → 1.19.0

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.18.0",
+	"version": "1.19.0",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",

package/schema/AllowSchema.d.ts

@@ -0,0 +1,19 @@
+import { Schema } from "./Schema.js";
+/** Specify a specific list of allowed values. */
+export declare type AllowedOptions<T extends string> = ReadonlyArray<T> | {
+    readonly [K in T]: string;
+};
+/** Validate a value against a specific set of allowed values. */
+export declare function validateAllowed<T extends string>(unsafeString: string, allowed: AllowedOptions<T>): T;
+/** Define a valid string from an allowed set of strings. */
+export declare class AllowSchema<T extends string> extends Schema<T> {
+    readonly allow: AllowedOptions<T>;
+    readonly value: T | null;
+    constructor({ allow, value, ...options }: ConstructorParameters<typeof Schema>[0] & {
+        allow: AllowedOptions<T>;
+        value?: T | null;
+    });
+    validate(unsafeValue?: unknown): T;
+}
+/** Valid string from an allowed set of strings. */
+export declare const ALLOW: <T extends string>(allow: AllowedOptions<T>) => AllowSchema<T>;

package/schema/{AllowedSchema.js → AllowSchema.js}

@@ -14,15 +14,15 @@ export function validateAllowed(unsafeString, allowed) {
     throw new InvalidFeedback("Unknown value", { value: unsafeString });
 }
 /** Define a valid string from an allowed set of strings. */
-export class AllowedSchema extends Schema {
-    constructor({ allow, ...options }) {
+export class AllowSchema extends Schema {
+    constructor({ allow, value = null, ...options }) {
         super(options);
         this.allow = allow;
+        this.value = value;
     }
-    validate(unsafeValue) {
-        const unsafeString = toString(unsafeValue);
-        return validateAllowed(unsafeString, this.allow);
+    validate(unsafeValue = this.value) {
+        return validateAllowed(toString(unsafeValue), this.allow);
     }
 }
 /** Valid string from an allowed set of strings. */
-export const ALLOW = (allow) => new AllowedSchema({ allow });
+export const ALLOW = (allow) => new AllowSchema({ allow: allow });

package/schema/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./Schema.js";
-export * from "./AllowedSchema.js";
+export * from "./AllowSchema.js";
 export * from "./ArraySchema.js";
 export * from "./BooleanSchema.js";
 export * from "./ColorSchema.js";

package/schema/index.js

@@ -1,5 +1,5 @@
 export * from "./Schema.js";
-export * from "./AllowedSchema.js";
+export * from "./AllowSchema.js";
 export * from "./ArraySchema.js";
 export * from "./BooleanSchema.js";
 export * from "./ColorSchema.js";

package/schema/AllowedSchema.d.ts

@@ -1,17 +0,0 @@
-import { Schema } from "./Schema.js";
-/** Specify a specific list of allowed values. */
-export declare type Allowed<T extends string> = ReadonlyArray<T> | {
-    readonly [K in T]: string;
-};
-/** Validate a value against a specific set of allowed values. */
-export declare function validateAllowed<T extends string>(unsafeString: string, allowed: Allowed<T>): T;
-/** Define a valid string from an allowed set of strings. */
-export declare class AllowedSchema<T extends string> extends Schema<T> {
-    readonly allow: Allowed<T>;
-    constructor({ allow, ...options }: ConstructorParameters<typeof Schema>[0] & {
-        allow: Allowed<T>;
-    });
-    validate(unsafeValue: unknown): T;
-}
-/** Valid string from an allowed set of strings. */
-export declare const ALLOW: <T extends string>(allow: Allowed<T>) => AllowedSchema<T>;