shelving 1.34.0 → 1.35.0

package/package.json

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

package/util/number.d.ts

@@ -11,6 +11,11 @@ export declare const IS_NUMBER: (v: unknown) => v is number;
  * - Everything else returns `null`
  */
 export declare function toNumber(value: unknown): number | null;
+/**
+ * Assertively convert an unknown value to a finite number.
+ * @throws `AssertionError` if the value cannot be converted.
+ */
+export declare function getNumber(value: unknown): number;
 /**
  * Round numbers to a given step.
  *

package/util/number.js

@@ -21,6 +21,16 @@ export function toNumber(value) {
     return null;
 }
 const NUMERIC = /[^0-9-.]/g;
+/**
+ * Assertively convert an unknown value to a finite number.
+ * @throws `AssertionError` if the value cannot be converted.
+ */
+export function getNumber(value) {
+    const num = toNumber(value);
+    if (num === null)
+        throw new AssertionError("Must be number", value);
+    return num;
+}
 /**
  * Round numbers to a given step.
  *