@rickosborne/guard 2024.12.32 → 2024.12.34

package/README.md

@@ -1,6 +1,7 @@
 # @rickosborne/guard
 
 Basic type guards building on [@rickosborne/typical](https://www.npmjs.com/package/@rickosborne/typical).
+
 ***
 
 ## API
@@ -12,17 +13,23 @@ Basic type guards building on [@rickosborne/typical](https://www.npmjs.com/packa
 <a id="api-assertdefined"></a>
 
 ```typescript
-declare function assertDefined<T>(value: T, messageOrError: MessageOrError): asserts value is NonNullable<T>;
+ function assertDefined<T>(value: T, messageOrError: MessageOrError): asserts value is NonNullable<T>;
 ```
 
+Assert the given value is not null or undefined. Throws with the given message or error, otherwise.
+
+
 #### assertInt
 
 <a id="api-assertint"></a>
 
 ```typescript
-declare function assertInt(value: unknown, messageOrError: MessageOrError): asserts value is number;
+ function assertInt(value: unknown, messageOrError: MessageOrError): asserts value is number;
 ```
 
+Throw if the given value is not an integer.
+
+
 #### errorFromMessageOrError
 
 <a id="api-errorfrommessageorerror"></a>
@@ -34,6 +41,17 @@ errorFromMessageOrError: (messageOrError: MessageOrError, defaultConstructor?: (
 Helper for guards which expect text or an error, or can generate one when needed.
 
 
+#### expectDefined
+
+<a id="api-expectdefined"></a>
+
+```typescript
+expectDefined: <T>(obj: T, messageOrError: MessageOrError) => NonNullable<T>
+```
+
+Coerce a value's type to exclude null or undefined, or throw if it actually is null or undefined.
+
+
 #### expectInt
 
 <a id="api-expectint"></a>
@@ -42,12 +60,15 @@ Helper for guards which expect text or an error, or can generate one when needed
 expectInt: (obj: unknown, messageOrError: MessageOrError) => number
 ```
 
+Coerce a value's type to a number, throwing if it's not an integer.
+
+
 #### hasArray
 
 <a id="api-hasarray"></a>
 
 ```typescript
-declare function hasArray<Name extends string>(obj: unknown, name: Name, predicate?: undefined): obj is {
+ function hasArray<Name extends string>(obj: unknown, name: Name, predicate?: undefined): obj is {
     [K in Name]: unknown[];
 };
 ```
@@ -60,7 +81,7 @@ Guard for whether the given value is an object which has a property with its own
 <a id="api-hasarray"></a>
 
 ```typescript
-declare function hasArray<Name extends string, Item>(obj: unknown, name: Name, predicate?: (item: unknown, index: number, items: unknown[]) => item is Item): obj is {
+ function hasArray<Name extends string, Item>(obj: unknown, name: Name, predicate?: (item: unknown, index: number, items: unknown[]) => item is Item): obj is {
     [K in Name]: Item[];
 };
 ```
@@ -76,26 +97,46 @@ Guard for whether the given value is an object which has a property with its own
 hasNumber: <Name extends string>(obj: unknown, name: Name) => obj is { [k in Name]: string; }
 ```
 
+Guard for whether an object has a property with the given name and a numeric value.
+
+
 #### hasOwn
 
 <a id="api-hasown"></a>
 
 ```typescript
-declare function hasOwn<Name extends string>(obj: unknown, name: Name): obj is {
+ function hasOwn<Name extends string>(obj: unknown, name: Name): obj is {
     [K in Name]: unknown;
 };
 ```
 
+Guard for whether the given value is an object with a property with the given name. This variant does not check the value, only that the property exists.
+
+
 #### hasOwn
 
 <a id="api-hasown"></a>
 
 ```typescript
-declare function hasOwn<Name extends string, T>(obj: unknown, name: Name, predicate: (value: unknown) => value is T): obj is {
+ function hasOwn<Name extends string, T>(obj: unknown, name: Name, predicate: (value: unknown) => value is T): obj is {
     [K in Name]: T;
 };
 ```
 
+Guard for whether the given value is an object with a property with the given name. This variant checks the value against the given predicate.
+
+
+#### isDefined
+
+<a id="api-isdefined"></a>
+
+```typescript
+isDefined: <T>(obj: T) => obj is NonNullable<T>
+```
+
+Guard to filter out null or undefined values.
+
+
 #### isInt
 
 <a id="api-isint"></a>
@@ -104,6 +145,9 @@ declare function hasOwn<Name extends string, T>(obj: unknown, name: Name, predic
 isInt: (obj: unknown) => obj is number
 ```
 
+Check whether the given value is not just numeric, but is also an integer.
+
+
 #### isListOf
 
 <a id="api-islistof"></a>
@@ -112,6 +156,9 @@ isInt: (obj: unknown) => obj is number
 isListOf: <T>(list: unknown, predicate: (item: unknown, index: number, items: unknown[]) => item is T) => list is T[]
 ```
 
+Guard to check if the given value is an array where all the items match the given predicate.
+
+
 #### isObject
 
 <a id="api-isobject"></a>
@@ -120,6 +167,9 @@ isListOf: <T>(list: unknown, predicate: (item: unknown, index: number, items: un
 isObject: (obj: unknown) => obj is NonNullable<object>
 ```
 
+Guard to check that the given value is defined and object-like.
+
+
 #### isPlainObject
 
 <a id="api-isplainobject"></a>
@@ -128,6 +178,9 @@ isObject: (obj: unknown) => obj is NonNullable<object>
 isPlainObject: (obj: unknown) => obj is Record<never, never>
 ```
 
+Guard to check that the given value is defined, is an object, and seems to be a "plain" object, descending directly from Object. This won't prevent all shenanigans, but is a low-effort check.
+
+
 #### isUnaryPredicate
 
 <a id="api-isunarypredicate"></a>
@@ -139,6 +192,29 @@ isUnaryPredicate: (obj: unknown) => obj is UnaryPredicate<unknown>
 Tests whether the given object is a function and takes at least one parameter, and could maybe act as a unary predicate. Warning! Since no type information is available at runtime, it may not actually act as a predicate!
 
 
+#### maybeInt
+
+<a id="api-maybeint"></a>
+
+```typescript
+maybeInt: (text: string) => number | undefined
+```
+
+Convert to an integer, if it seems like it could be done safely. See [decimal separator on Wikipedia](https://en.wikipedia.org/wiki/Decimal_separator) for details on how this is probably very wrong in many countries.
+
+
+#### scrubStackTrace
+
+<a id="api-scrubstacktrace"></a>
+
+```typescript
+scrubStackTrace: <E extends Error>(err: E, removeIf?: Predicate<string> | RegExp | string | undefined) => E
+```
+
+Wrap an Error in a proxy which cleans up the stack trace to be more human-readable. It filters out lines from third-party code, so you can quickly see your own code in the call stack. May optionally include some way of indicating additional lines which should be removed, so a guard function could make itself transparent, making it seem like the caller threw the error.
+
+
+
 ### TypeAliases
 
 #### MessageOrError

package/cjs/index.js

@@ -14,13 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ts/assert-defined.js"), exports);
 __exportStar(require("./ts/error-from-message.js"), exports);
 __exportStar(require("./ts/has-array.js"), exports);
 __exportStar(require("./ts/has-number.js"), exports);
 __exportStar(require("./ts/has-own.js"), exports);
+__exportStar(require("./ts/is-defined.js"), exports);
 __exportStar(require("./ts/is-int.js"), exports);
 __exportStar(require("./ts/is-list-of.js"), exports);
 __exportStar(require("./ts/is-object.js"), exports);
 __exportStar(require("./ts/is-predicate.js"), exports);
+__exportStar(require("./ts/scrub-stack-trace.js"), exports);
 //# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,6DAA2C;AAC3C,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC;AAChC,iDAA+B;AAC/B,qDAAmC;AACnC,oDAAkC;AAClC,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC;AAChC,qDAAmC;AACnC,iDAA+B;AAC/B,qDAAmC;AACnC,oDAAkC;AAClC,uDAAqC;AACrC,4DAA0C"}

package/cjs/ts/error-from-message.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.errorFromMessageOrError = void 0;
+const scrub_stack_trace_js_1 = require("./scrub-stack-trace.js");
 /**
  * Helper for guards which expect text or an error, or
  * can generate one when needed.
@@ -20,7 +21,7 @@ const errorFromMessageOrError = (messageOrError, defaultConstructor = Error) =>
     else {
         error = stringOrError;
     }
-    return error;
+    return (0, scrub_stack_trace_js_1.scrubStackTrace)(error, " at errorFromMessageOrError ");
 };
 exports.errorFromMessageOrError = errorFromMessageOrError;
 //# sourceMappingURL=error-from-message.js.map

package/cjs/ts/error-from-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-from-message.js","sourceRoot":"","sources":["../../../ts/error-from-message.ts"],"names":[],"mappings":";;;AAKA;;;GAGG;AACI,MAAM,uBAAuB,GAAG,CACtC,cAA8B,EAC9B,qBAAuD,KAAK,EACpD,EAAE;IACV,IAAI,aAA6B,CAAC;IAClC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC1C,aAAa,GAAG,cAAc,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACP,aAAa,GAAG,cAAc,CAAC;IAChC,CAAC;IACD,IAAI,KAAY,CAAC;IACjB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,GAAG,IAAI,kBAAkB,CAAC,YAAa,aAAc,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAjBW,QAAA,uBAAuB,2BAiBlC"}
+{"version":3,"file":"error-from-message.js","sourceRoot":"","sources":["../../../ts/error-from-message.ts"],"names":[],"mappings":";;;AAAA,iEAAyD;AAOzD;;;GAGG;AACI,MAAM,uBAAuB,GAAG,CACtC,cAA8B,EAC9B,qBAAuD,KAAK,EACpD,EAAE;IACV,IAAI,aAA6B,CAAC;IAClC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC1C,aAAa,GAAG,cAAc,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACP,aAAa,GAAG,cAAc,CAAC;IAChC,CAAC;IACD,IAAI,KAAY,CAAC;IACjB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,GAAG,IAAI,kBAAkB,CAAC,YAAa,aAAc,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,IAAA,sCAAe,EAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;AAC/D,CAAC,CAAC;AAjBW,QAAA,uBAAuB,2BAiBlC"}

package/cjs/ts/has-number.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasNumber = void 0;
 const has_own_js_1 = require("./has-own.js");
+/**
+ * Guard for whether an object has a property with the given name
+ * and a numeric value.
+ */
 const hasNumber = (obj, name) => {
     return (0, has_own_js_1.hasOwn)(obj, name) && typeof obj[name] === "number";
 };

package/cjs/ts/has-number.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-number.js","sourceRoot":"","sources":["../../../ts/has-number.ts"],"names":[],"mappings":";;;AAAA,6CAAsC;AAE/B,MAAM,SAAS,GAAG,CAAsB,GAAY,EAAE,IAAU,EAAgC,EAAE;IACxG,OAAO,IAAA,mBAAM,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC;AAC3D,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}
+{"version":3,"file":"has-number.js","sourceRoot":"","sources":["../../../ts/has-number.ts"],"names":[],"mappings":";;;AAAA,6CAAsC;AAEtC;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAsB,GAAY,EAAE,IAAU,EAAkC,EAAE;IAC1G,OAAO,IAAA,mBAAM,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,GAAG,CAAE,IAAI,CAAE,KAAK,QAAQ,CAAC;AAC7D,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}

package/cjs/ts/has-own.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasOwn = hasOwn;
 const is_object_js_1 = require("./is-object.js");
+/**
+ * Guard for whether the given value is an object with a property
+ * with the given name.
+ */
 function hasOwn(obj, name, predicate) {
     if (!(0, is_object_js_1.isObject)(obj) || !Object.hasOwn(obj, name)) {
         return false;

package/cjs/ts/has-own.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../ts/has-own.ts"],"names":[],"mappings":";;AAIA,wBAKC;AATD,iDAA0C;AAI1C,SAAgB,MAAM,CAAyB,GAAY,EAAE,IAAU,EAAE,SAA0C;IAClH,IAAI,CAAC,IAAA,uBAAQ,EAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,IAAwB,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../ts/has-own.ts"],"names":[],"mappings":";;AAkBA,wBAKC;AAvBD,iDAA0C;AAc1C;;;GAGG;AACH,SAAgB,MAAM,CAAyB,GAAY,EAAE,IAAU,EAAE,SAA0C;IAClH,IAAI,CAAC,IAAA,uBAAQ,EAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,GAAG,CAAE,IAAwB,CAAE,CAAC,CAAC;AACxE,CAAC"}

package/cjs/ts/is-defined.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectDefined = exports.isDefined = void 0;
+exports.assertDefined = assertDefined;
+const error_from_message_js_1 = require("./error-from-message.js");
+/**
+ * Assert the given value is not null or undefined.
+ * Throws with the given message or error, otherwise.
+ */
+function assertDefined(value, messageOrError) {
+    if (value != null) {
+        return;
+    }
+    throw (0, error_from_message_js_1.errorFromMessageOrError)(messageOrError, RangeError);
+}
+/**
+ * Guard to filter out null or undefined values.
+ */
+const isDefined = (obj) => obj != null;
+exports.isDefined = isDefined;
+/**
+ * Coerce a value's type to exclude null or undefined, or throw
+ * if it actually is null or undefined.
+ */
+const expectDefined = (obj, messageOrError) => {
+    assertDefined(obj, messageOrError);
+    return obj;
+};
+exports.expectDefined = expectDefined;
+//# sourceMappingURL=is-defined.js.map

package/cjs/ts/is-defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-defined.js","sourceRoot":"","sources":["../../../ts/is-defined.ts"],"names":[],"mappings":";;;AAMA,sCAQC;AAdD,mEAAuF;AAEvF;;;GAGG;AACH,SAAgB,aAAa,CAC5B,KAAQ,EACR,cAA8B;IAE9B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO;IACR,CAAC;IACD,MAAM,IAAA,+CAAuB,EAAC,cAAc,EAAE,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACI,MAAM,SAAS,GAAG,CAAI,GAAM,EAAyB,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC;AAA9D,QAAA,SAAS,aAAqD;AAE3E;;;GAGG;AACI,MAAM,aAAa,GAAG,CAC5B,GAAM,EACN,cAA8B,EACb,EAAE;IACnB,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AANW,QAAA,aAAa,iBAMxB"}

package/cjs/ts/is-int.js

@@ -1,18 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expectInt = exports.isInt = void 0;
+exports.maybeInt = exports.expectInt = exports.isInt = void 0;
 exports.assertInt = assertInt;
 const error_from_message_js_1 = require("./error-from-message.js");
+/**
+ * Check whether the given value is not just numeric, but is
+ * also an integer.
+ */
 const isInt = (obj) => typeof obj === "number" && !isNaN(obj) && Math.trunc(obj) === obj && obj !== Infinity && obj !== -Infinity;
 exports.isInt = isInt;
+/**
+ * Throw if the given value is not an integer.
+ */
 function assertInt(value, messageOrError) {
     if (!(0, exports.isInt)(value)) {
         throw (0, error_from_message_js_1.errorFromMessageOrError)(messageOrError, TypeError);
     }
 }
+/**
+ * Coerce a value's type to a number, throwing if it's not an integer.
+ */
 const expectInt = (obj, messageOrError) => {
     assertInt(obj, messageOrError);
     return obj;
 };
 exports.expectInt = expectInt;
+/**
+ * Convert to an integer, if it seems like it could be done safely.
+ * See {@link https://en.wikipedia.org/wiki/Decimal_separator | decimal separator on Wikipedia}
+ * for details on how this is probably very wrong in many countries.
+ */
+const maybeInt = (text) => {
+    let sign = 1;
+    let clean = text.trim();
+    // This just makes the patterns below a little easier.
+    if (text.startsWith("-")) {
+        sign = -1;
+        clean = clean.substring(1);
+    }
+    clean = clean
+        .replace(/(?<=\d)[_  ](?=\d)/g, "")
+        .replace(/^0+[,'.·]0*$/, "0")
+        .replace(/^(\d+(?:,\d+)+)[.·]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d+(?:'\d+)+)[.,]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d+(?:\.\d+)+)[,']0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d{4,})[,'.·]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""));
+    if (/^-?(0|[1-9][0-9]*)$/.test(clean)) {
+        return parseInt(clean, 10) * sign;
+    }
+    return undefined;
+};
+exports.maybeInt = maybeInt;
 //# sourceMappingURL=is-int.js.map

package/cjs/ts/is-int.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-int.js","sourceRoot":"","sources":["../../../ts/is-int.ts"],"names":[],"mappings":";;;AAIA,8BAIC;AARD,mEAAuF;AAEhF,MAAM,KAAK,GAAG,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;AAApJ,QAAA,KAAK,SAA+I;AAEjK,SAAgB,SAAS,CAAC,KAAc,EAAE,cAA8B;IACvE,IAAI,CAAC,IAAA,aAAK,EAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAA,+CAAuB,EAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAEM,MAAM,SAAS,GAAG,CACxB,GAAY,EACZ,cAA8B,EACrB,EAAE;IACX,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB"}
+{"version":3,"file":"is-int.js","sourceRoot":"","sources":["../../../ts/is-int.ts"],"names":[],"mappings":";;;AAWA,8BAIC;AAfD,mEAAuF;AAEvF;;;GAGG;AACI,MAAM,KAAK,GAAG,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;AAApJ,QAAA,KAAK,SAA+I;AAEjK;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAc,EAAE,cAA8B;IACvE,IAAI,CAAC,IAAA,aAAK,EAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAA,+CAAuB,EAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;GAEG;AACI,MAAM,SAAS,GAAG,CACxB,GAAY,EACZ,cAA8B,EACrB,EAAE;IACX,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB;AAEF;;;;GAIG;AACI,MAAM,QAAQ,GAAG,CACvB,IAAY,EACS,EAAE;IACvB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACxB,sDAAsD;IACtD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,CAAC,CAAC;QACV,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,GAAG,KAAK;SACX,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAClC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3F,OAAO,CAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3F,OAAO,CAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC5F,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CACxF;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC;AAtBW,QAAA,QAAQ,YAsBnB"}

package/cjs/ts/is-list-of.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isListOf = void 0;
+/**
+ * Guard to check if the given value is an array where all the
+ * items match the given predicate.
+ */
 const isListOf = (list, predicate) => {
     return Array.isArray(list) && list.every(predicate);
 };

package/cjs/ts/is-list-of.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-list-of.js","sourceRoot":"","sources":["../../../ts/is-list-of.ts"],"names":[],"mappings":";;;AAAO,MAAM,QAAQ,GAAG,CACvB,IAAa,EACb,SAAwE,EAC1D,EAAE;IAChB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACrD,CAAC,CAAC;AALW,QAAA,QAAQ,YAKnB"}
+{"version":3,"file":"is-list-of.js","sourceRoot":"","sources":["../../../ts/is-list-of.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,QAAQ,GAAG,CACvB,IAAa,EACb,SAAwE,EAC1D,EAAE;IAChB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACrD,CAAC,CAAC;AALW,QAAA,QAAQ,YAKnB"}

package/cjs/ts/is-object.js

@@ -1,10 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPlainObject = exports.isObject = void 0;
+/**
+ * Guard to check that the given value is defined and object-like.
+ */
 const isObject = (obj) => {
     return obj != null && typeof obj === "object";
 };
 exports.isObject = isObject;
+/**
+ * Guard to check that the given value is defined, is an object,
+ * and seems to be a "plain" object, descending directly from Object.
+ * This won't prevent all shenanigans, but is a low-effort check.
+ */
 const isPlainObject = (obj) => {
     if (!(0, exports.isObject)(obj)) {
         return false;

package/cjs/ts/is-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-object.js","sourceRoot":"","sources":["../../../ts/is-object.ts"],"names":[],"mappings":";;;AAAO,MAAM,QAAQ,GAAG,CAAC,GAAY,EAA8B,EAAE;IACpE,OAAO,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC;AAC/C,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAEK,MAAM,aAAa,GAAG,CAAC,GAAY,EAA8B,EAAE;IACzE,IAAI,CAAC,IAAA,gBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACpD,CAAC,CAAC;AANW,QAAA,aAAa,iBAMxB"}
+{"version":3,"file":"is-object.js","sourceRoot":"","sources":["../../../ts/is-object.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACI,MAAM,QAAQ,GAAG,CAAC,GAAY,EAA8B,EAAE;IACpE,OAAO,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC;AAC/C,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAEF;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,GAAY,EAA8B,EAAE;IACzE,IAAI,CAAC,IAAA,gBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACpD,CAAC,CAAC;AANW,QAAA,aAAa,iBAMxB"}

package/cjs/ts/scrub-stack-trace.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scrubStackTrace = void 0;
+const defaultKeepIf = (line) => {
+    return !line.includes("node:internal")
+        && (!line.includes("/node_modules/") || line.includes("@rickosborne/"));
+};
+/**
+ * Wrap an Error in a proxy which cleans up the stack trace to be
+ * more human-readable.  It filters out lines from third-party code,
+ * so you can quickly see your own code in the call stack.
+ * May optionally include some way of indicating additional lines
+ * which should be removed, so a guard function could make itself
+ * transparent, making it seem like the caller threw the error.
+ * @param err - Some kind of Error.
+ * @param removeIf - A matcher to indicate whether a line should be removed (not kept!).
+ *    Generally, you'll pass in the name of the calling function, calling file, or similar.
+ */
+const scrubStackTrace = (err, removeIf) => {
+    let keepIf;
+    if (typeof removeIf === "string") {
+        keepIf = (line) => !line.includes(removeIf);
+    }
+    else if (removeIf instanceof RegExp) {
+        keepIf = (line) => !removeIf.test(line);
+    }
+    else if (typeof removeIf === "function") {
+        keepIf = (line) => !removeIf(line);
+    }
+    else {
+        keepIf = () => true;
+    }
+    let scrubbedStack;
+    return new Proxy(err, {
+        get(target, p) {
+            var _a;
+            if (p !== "stack") {
+                return target[p];
+            }
+            if (scrubbedStack == null) {
+                scrubbedStack = (_a = target.stack) === null || _a === void 0 ? void 0 : _a.split("\n").filter(defaultKeepIf).filter(keepIf).join("\n");
+            }
+            return scrubbedStack;
+        },
+    });
+};
+exports.scrubStackTrace = scrubStackTrace;
+//# sourceMappingURL=scrub-stack-trace.js.map

package/cjs/ts/scrub-stack-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrub-stack-trace.js","sourceRoot":"","sources":["../../../ts/scrub-stack-trace.ts"],"names":[],"mappings":";;;AAEA,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;IAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;WAClC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACI,MAAM,eAAe,GAAG,CAC9B,GAAM,EACN,QAA0D,EACtD,EAAE;IACN,IAAI,MAAyB,CAAC;IAC9B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,QAAQ,YAAY,MAAM,EAAE,CAAC;QACvC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC3C,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACP,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,IAAI,aAAiC,CAAC;IACtC,OAAO,IAAI,KAAK,CAAI,GAAG,EAAE;QACxB,GAAG,CAAC,MAAS,EAAE,CAAkB;;YAChC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACnB,OAAO,MAAM,CAAE,CAAY,CAAE,CAAC;YAC/B,CAAC;YACD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC3B,aAAa,GAAG,MAAA,MAAM,CAAC,KAAK,0CAAE,KAAK,CAAC,IAAI,EACtC,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,MAAM,EACb,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,CAAC;YACD,OAAO,aAAa,CAAC;QACtB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC,CAAC;AA7BW,QAAA,eAAe,mBA6B1B"}

package/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../index.ts","../../ts/assert-defined.ts","../../ts/error-from-message.ts","../../ts/has-array.ts","../../ts/has-number.ts","../../ts/has-own.ts","../../ts/is-int.ts","../../ts/is-list-of.ts","../../ts/is-object.ts","../../ts/is-predicate.ts"],"version":"5.7.2"}
+{"root":["../../index.ts","../../ts/error-from-message.ts","../../ts/has-array.ts","../../ts/has-number.ts","../../ts/has-own.ts","../../ts/is-defined.ts","../../ts/is-int.ts","../../ts/is-list-of.ts","../../ts/is-object.ts","../../ts/is-predicate.ts","../../ts/scrub-stack-trace.ts"],"version":"5.7.2"}

package/esm/index.js

@@ -1,10 +1,11 @@
-export * from "./ts/assert-defined.js";
 export * from "./ts/error-from-message.js";
 export * from "./ts/has-array.js";
 export * from "./ts/has-number.js";
 export * from "./ts/has-own.js";
+export * from "./ts/is-defined.js";
 export * from "./ts/is-int.js";
 export * from "./ts/is-list-of.js";
 export * from "./ts/is-object.js";
 export * from "./ts/is-predicate.js";
+export * from "./ts/scrub-stack-trace.js";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/esm/ts/error-from-message.js

@@ -1,3 +1,4 @@
+import { scrubStackTrace } from "./scrub-stack-trace.js";
 /**
  * Helper for guards which expect text or an error, or
  * can generate one when needed.
@@ -17,6 +18,6 @@ export const errorFromMessageOrError = (messageOrError, defaultConstructor = Err
     else {
         error = stringOrError;
     }
-    return error;
+    return scrubStackTrace(error, " at errorFromMessageOrError ");
 };
 //# sourceMappingURL=error-from-message.js.map

package/esm/ts/error-from-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-from-message.js","sourceRoot":"","sources":["../../../ts/error-from-message.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,cAA8B,EAC9B,qBAAuD,KAAK,EACpD,EAAE;IACV,IAAI,aAA6B,CAAC;IAClC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC1C,aAAa,GAAG,cAAc,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACP,aAAa,GAAG,cAAc,CAAC;IAChC,CAAC;IACD,IAAI,KAAY,CAAC;IACjB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,GAAG,IAAI,kBAAkB,CAAC,YAAa,aAAc,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"error-from-message.js","sourceRoot":"","sources":["../../../ts/error-from-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,cAA8B,EAC9B,qBAAuD,KAAK,EACpD,EAAE;IACV,IAAI,aAA6B,CAAC;IAClC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC1C,aAAa,GAAG,cAAc,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACP,aAAa,GAAG,cAAc,CAAC;IAChC,CAAC;IACD,IAAI,KAAY,CAAC;IACjB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,GAAG,IAAI,kBAAkB,CAAC,YAAa,aAAc,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,eAAe,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;AAC/D,CAAC,CAAC"}

package/esm/ts/has-number.js

@@ -1,4 +1,8 @@
 import { hasOwn } from "./has-own.js";
+/**
+ * Guard for whether an object has a property with the given name
+ * and a numeric value.
+ */
 export const hasNumber = (obj, name) => {
     return hasOwn(obj, name) && typeof obj[name] === "number";
 };

package/esm/ts/has-number.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-number.js","sourceRoot":"","sources":["../../../ts/has-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAsB,GAAY,EAAE,IAAU,EAAgC,EAAE;IACxG,OAAO,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC;AAC3D,CAAC,CAAC"}
+{"version":3,"file":"has-number.js","sourceRoot":"","sources":["../../../ts/has-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAsB,GAAY,EAAE,IAAU,EAAkC,EAAE;IAC1G,OAAO,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,GAAG,CAAE,IAAI,CAAE,KAAK,QAAQ,CAAC;AAC7D,CAAC,CAAC"}

package/esm/ts/has-own.js

@@ -1,4 +1,8 @@
 import { isObject } from "./is-object.js";
+/**
+ * Guard for whether the given value is an object with a property
+ * with the given name.
+ */
 export function hasOwn(obj, name, predicate) {
     if (!isObject(obj) || !Object.hasOwn(obj, name)) {
         return false;

package/esm/ts/has-own.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../ts/has-own.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,MAAM,UAAU,MAAM,CAAyB,GAAY,EAAE,IAAU,EAAE,SAA0C;IAClH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,IAAwB,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../ts/has-own.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAc1C;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAyB,GAAY,EAAE,IAAU,EAAE,SAA0C;IAClH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,CAAC,GAAG,CAAE,IAAwB,CAAE,CAAC,CAAC;AACxE,CAAC"}

package/esm/ts/is-defined.js

@@ -0,0 +1,24 @@
+import { errorFromMessageOrError } from "./error-from-message.js";
+/**
+ * Assert the given value is not null or undefined.
+ * Throws with the given message or error, otherwise.
+ */
+export function assertDefined(value, messageOrError) {
+    if (value != null) {
+        return;
+    }
+    throw errorFromMessageOrError(messageOrError, RangeError);
+}
+/**
+ * Guard to filter out null or undefined values.
+ */
+export const isDefined = (obj) => obj != null;
+/**
+ * Coerce a value's type to exclude null or undefined, or throw
+ * if it actually is null or undefined.
+ */
+export const expectDefined = (obj, messageOrError) => {
+    assertDefined(obj, messageOrError);
+    return obj;
+};
+//# sourceMappingURL=is-defined.js.map

package/esm/ts/is-defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-defined.js","sourceRoot":"","sources":["../../../ts/is-defined.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC5B,KAAQ,EACR,cAA8B;IAE9B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO;IACR,CAAC;IACD,MAAM,uBAAuB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,GAAM,EAAyB,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC5B,GAAM,EACN,cAA8B,EACb,EAAE;IACnB,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC"}

package/esm/ts/is-int.js

@@ -1,12 +1,47 @@
 import { errorFromMessageOrError } from "./error-from-message.js";
+/**
+ * Check whether the given value is not just numeric, but is
+ * also an integer.
+ */
 export const isInt = (obj) => typeof obj === "number" && !isNaN(obj) && Math.trunc(obj) === obj && obj !== Infinity && obj !== -Infinity;
+/**
+ * Throw if the given value is not an integer.
+ */
 export function assertInt(value, messageOrError) {
     if (!isInt(value)) {
         throw errorFromMessageOrError(messageOrError, TypeError);
     }
 }
+/**
+ * Coerce a value's type to a number, throwing if it's not an integer.
+ */
 export const expectInt = (obj, messageOrError) => {
     assertInt(obj, messageOrError);
     return obj;
 };
+/**
+ * Convert to an integer, if it seems like it could be done safely.
+ * See {@link https://en.wikipedia.org/wiki/Decimal_separator | decimal separator on Wikipedia}
+ * for details on how this is probably very wrong in many countries.
+ */
+export const maybeInt = (text) => {
+    let sign = 1;
+    let clean = text.trim();
+    // This just makes the patterns below a little easier.
+    if (text.startsWith("-")) {
+        sign = -1;
+        clean = clean.substring(1);
+    }
+    clean = clean
+        .replace(/(?<=\d)[_  ](?=\d)/g, "")
+        .replace(/^0+[,'.·]0*$/, "0")
+        .replace(/^(\d+(?:,\d+)+)[.·]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d+(?:'\d+)+)[.,]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d+(?:\.\d+)+)[,']0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""))
+        .replace(/^(\d{4,})[,'.·]0*$/, (_all, digits) => digits.replace(/[^-0-9]/g, ""));
+    if (/^-?(0|[1-9][0-9]*)$/.test(clean)) {
+        return parseInt(clean, 10) * sign;
+    }
+    return undefined;
+};
 //# sourceMappingURL=is-int.js.map

package/esm/ts/is-int.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-int.js","sourceRoot":"","sources":["../../../ts/is-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;AAEjK,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,cAA8B;IACvE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,uBAAuB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,GAAY,EACZ,cAA8B,EACrB,EAAE;IACX,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC"}
+{"version":3,"file":"is-int.js","sourceRoot":"","sources":["../../../ts/is-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;AAEjK;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,cAA8B;IACvE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,uBAAuB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,GAAY,EACZ,cAA8B,EACrB,EAAE;IACX,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,IAAY,EACS,EAAE;IACvB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACxB,sDAAsD;IACtD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,CAAC,CAAC;QACV,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,GAAG,KAAK;SACX,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAClC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3F,OAAO,CAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3F,OAAO,CAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC5F,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CACxF;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC"}

package/esm/ts/is-list-of.js

@@ -1,3 +1,7 @@
+/**
+ * Guard to check if the given value is an array where all the
+ * items match the given predicate.
+ */
 export const isListOf = (list, predicate) => {
     return Array.isArray(list) && list.every(predicate);
 };