guarden 1.0.0

package/dist/cjs/guards/combinators.js

@@ -0,0 +1,195 @@
+"use strict";
+// ============================================================================
+// Guarden — Guard Combinators
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.and = and;
+exports.or = or;
+exports.not = not;
+exports.shape = shape;
+exports.tuple = tuple;
+exports.arrayOf = arrayOf;
+exports.mapOf = mapOf;
+exports.recordOf = recordOf;
+exports.refine = refine;
+exports.optional = optional;
+exports.nullable = nullable;
+/**
+ * Combine two guards with AND logic (intersection).
+ * Value must satisfy both guards.
+ *
+ * @example
+ * ```ts
+ * const isPositiveInteger = and(isInteger, isPositiveNumber);
+ * ```
+ */
+function and(guardA, guardB) {
+    return (value) => guardA(value) && guardB(value);
+}
+/**
+ * Combine two guards with OR logic (union).
+ * Value must satisfy at least one guard.
+ *
+ * @example
+ * ```ts
+ * const isStringOrNumber = or(isString, isNumber);
+ * ```
+ */
+function or(guardA, guardB) {
+    return (value) => guardA(value) || guardB(value);
+}
+/**
+ * Negate a guard.
+ *
+ * @example
+ * ```ts
+ * const isNotNull = not(isNull);
+ * ```
+ */
+function not(guard) {
+    return (value) => !guard(value);
+}
+/**
+ * Create a guard that validates an object shape.
+ * Each property is validated by its corresponding guard.
+ *
+ * @example
+ * ```ts
+ * const isUser = shape({
+ *   name: isString,
+ *   age: isNumber,
+ *   email: isEmail,
+ * });
+ *
+ * if (isUser(data)) {
+ *   data.name;  // string
+ *   data.age;   // number
+ *   data.email; // string
+ * }
+ * ```
+ */
+function shape(schema) {
+    return (value) => {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const obj = value;
+        for (const key in schema) {
+            if (!Object.prototype.hasOwnProperty.call(schema, key))
+                continue;
+            if (!schema[key](obj[key]))
+                return false;
+        }
+        return true;
+    };
+}
+/**
+ * Create a guard that validates a tuple.
+ *
+ * @example
+ * ```ts
+ * const isCoord = tuple(isNumber, isNumber);
+ * if (isCoord(data)) {
+ *   const [x, y] = data; // [number, number]
+ * }
+ * ```
+ */
+function tuple(...guards) {
+    return (value) => {
+        if (!Array.isArray(value))
+            return false;
+        if (value.length !== guards.length)
+            return false;
+        return guards.every((guard, i) => guard(value[i]));
+    };
+}
+/**
+ * Create a guard that validates each element of an array.
+ *
+ * @example
+ * ```ts
+ * const isStringArray = arrayOf(isString);
+ * if (isStringArray(data)) {
+ *   data.forEach(s => s.toUpperCase()); // string[]
+ * }
+ * ```
+ */
+function arrayOf(guard) {
+    return (value) => {
+        if (!Array.isArray(value))
+            return false;
+        return value.every((item) => guard(item));
+    };
+}
+/**
+ * Create a guard that validates Map entries.
+ *
+ * @example
+ * ```ts
+ * const isStringNumberMap = mapOf(isString, isNumber);
+ * ```
+ */
+function mapOf(keyGuard, valueGuard) {
+    return (value) => {
+        if (!(value instanceof Map))
+            return false;
+        for (const [k, v] of value) {
+            if (!keyGuard(k) || !valueGuard(v))
+                return false;
+        }
+        return true;
+    };
+}
+/**
+ * Create a guard that validates Record (object) entries.
+ *
+ * @example
+ * ```ts
+ * const isScoreBoard = recordOf(isString, isNumber);
+ * ```
+ */
+function recordOf(valueGuard) {
+    return (value) => {
+        if (typeof value !== 'object' || value === null || Array.isArray(value))
+            return false;
+        const obj = value;
+        for (const key in obj) {
+            if (!Object.prototype.hasOwnProperty.call(obj, key))
+                continue;
+            if (!valueGuard(obj[key]))
+                return false;
+        }
+        return true;
+    };
+}
+/**
+ * Create a guard with a custom refinement predicate.
+ *
+ * @example
+ * ```ts
+ * const isEvenNumber = refine(isNumber, (n) => n % 2 === 0);
+ * ```
+ */
+function refine(guard, predicate) {
+    return (value) => guard(value) && predicate(value);
+}
+/**
+ * Create an optional guard — allows undefined in addition to the guarded type.
+ *
+ * @example
+ * ```ts
+ * const isOptionalString = optional(isString);
+ * isOptionalString(undefined) // true
+ * isOptionalString("hello")   // true
+ * isOptionalString(42)        // false
+ * ```
+ */
+function optional(guard) {
+    return (value) => value === undefined || guard(value);
+}
+/**
+ * Create a nullable guard — allows null in addition to the guarded type.
+ */
+function nullable(guard) {
+    return (value) => value === null || guard(value);
+}
+//# sourceMappingURL=combinators.js.map

package/dist/cjs/guards/combinators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.js","sourceRoot":"","sources":["../../../src/guards/combinators.ts"],"names":[],"mappings":"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"}

package/dist/cjs/guards/index.js

@@ -0,0 +1,68 @@
+"use strict";
+// ============================================================================
+// Guarden — Guards Module Barrel Export
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tuple = exports.shape = exports.not = exports.or = exports.and = exports.isInstanceOf = exports.isMaxLength = exports.isMinLength = exports.isMatch = exports.isOneOf = exports.isInRange = exports.isNonEmptyArray = exports.isSafeInteger = exports.isInteger = exports.isNegativeNumber = exports.isPositiveNumber = exports.isHexColor = exports.isJSONString = exports.isISO8601 = exports.isUUID = exports.isURL = exports.isEmail = exports.isNonEmptyString = exports.isTypedArray = exports.isArrayBuffer = exports.isPromise = exports.isError = exports.isRegExp = exports.isValidDate = exports.isDate = exports.isWeakSet = exports.isWeakMap = exports.isSet = exports.isMap = exports.isPlainObject = exports.isObject = exports.isArray = exports.isPrimitive = exports.isFunction = exports.isNonNullish = exports.isNullish = exports.isUndefined = exports.isNull = exports.isSymbol = exports.isBigInt = exports.isBoolean = exports.isFiniteNumber = exports.isNumberIncludingNaN = exports.isNumber = exports.isString = void 0;
+exports.nullable = exports.optional = exports.refine = exports.recordOf = exports.mapOf = exports.arrayOf = void 0;
+var primitives_js_1 = require("./primitives.js");
+Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return primitives_js_1.isString; } });
+Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return primitives_js_1.isNumber; } });
+Object.defineProperty(exports, "isNumberIncludingNaN", { enumerable: true, get: function () { return primitives_js_1.isNumberIncludingNaN; } });
+Object.defineProperty(exports, "isFiniteNumber", { enumerable: true, get: function () { return primitives_js_1.isFiniteNumber; } });
+Object.defineProperty(exports, "isBoolean", { enumerable: true, get: function () { return primitives_js_1.isBoolean; } });
+Object.defineProperty(exports, "isBigInt", { enumerable: true, get: function () { return primitives_js_1.isBigInt; } });
+Object.defineProperty(exports, "isSymbol", { enumerable: true, get: function () { return primitives_js_1.isSymbol; } });
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return primitives_js_1.isNull; } });
+Object.defineProperty(exports, "isUndefined", { enumerable: true, get: function () { return primitives_js_1.isUndefined; } });
+Object.defineProperty(exports, "isNullish", { enumerable: true, get: function () { return primitives_js_1.isNullish; } });
+Object.defineProperty(exports, "isNonNullish", { enumerable: true, get: function () { return primitives_js_1.isNonNullish; } });
+Object.defineProperty(exports, "isFunction", { enumerable: true, get: function () { return primitives_js_1.isFunction; } });
+Object.defineProperty(exports, "isPrimitive", { enumerable: true, get: function () { return primitives_js_1.isPrimitive; } });
+var structures_js_1 = require("./structures.js");
+Object.defineProperty(exports, "isArray", { enumerable: true, get: function () { return structures_js_1.isArray; } });
+Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return structures_js_1.isObject; } });
+Object.defineProperty(exports, "isPlainObject", { enumerable: true, get: function () { return structures_js_1.isPlainObject; } });
+Object.defineProperty(exports, "isMap", { enumerable: true, get: function () { return structures_js_1.isMap; } });
+Object.defineProperty(exports, "isSet", { enumerable: true, get: function () { return structures_js_1.isSet; } });
+Object.defineProperty(exports, "isWeakMap", { enumerable: true, get: function () { return structures_js_1.isWeakMap; } });
+Object.defineProperty(exports, "isWeakSet", { enumerable: true, get: function () { return structures_js_1.isWeakSet; } });
+Object.defineProperty(exports, "isDate", { enumerable: true, get: function () { return structures_js_1.isDate; } });
+Object.defineProperty(exports, "isValidDate", { enumerable: true, get: function () { return structures_js_1.isValidDate; } });
+Object.defineProperty(exports, "isRegExp", { enumerable: true, get: function () { return structures_js_1.isRegExp; } });
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return structures_js_1.isError; } });
+Object.defineProperty(exports, "isPromise", { enumerable: true, get: function () { return structures_js_1.isPromise; } });
+Object.defineProperty(exports, "isArrayBuffer", { enumerable: true, get: function () { return structures_js_1.isArrayBuffer; } });
+Object.defineProperty(exports, "isTypedArray", { enumerable: true, get: function () { return structures_js_1.isTypedArray; } });
+var advanced_js_1 = require("./advanced.js");
+Object.defineProperty(exports, "isNonEmptyString", { enumerable: true, get: function () { return advanced_js_1.isNonEmptyString; } });
+Object.defineProperty(exports, "isEmail", { enumerable: true, get: function () { return advanced_js_1.isEmail; } });
+Object.defineProperty(exports, "isURL", { enumerable: true, get: function () { return advanced_js_1.isURL; } });
+Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return advanced_js_1.isUUID; } });
+Object.defineProperty(exports, "isISO8601", { enumerable: true, get: function () { return advanced_js_1.isISO8601; } });
+Object.defineProperty(exports, "isJSONString", { enumerable: true, get: function () { return advanced_js_1.isJSONString; } });
+Object.defineProperty(exports, "isHexColor", { enumerable: true, get: function () { return advanced_js_1.isHexColor; } });
+Object.defineProperty(exports, "isPositiveNumber", { enumerable: true, get: function () { return advanced_js_1.isPositiveNumber; } });
+Object.defineProperty(exports, "isNegativeNumber", { enumerable: true, get: function () { return advanced_js_1.isNegativeNumber; } });
+Object.defineProperty(exports, "isInteger", { enumerable: true, get: function () { return advanced_js_1.isInteger; } });
+Object.defineProperty(exports, "isSafeInteger", { enumerable: true, get: function () { return advanced_js_1.isSafeInteger; } });
+Object.defineProperty(exports, "isNonEmptyArray", { enumerable: true, get: function () { return advanced_js_1.isNonEmptyArray; } });
+Object.defineProperty(exports, "isInRange", { enumerable: true, get: function () { return advanced_js_1.isInRange; } });
+Object.defineProperty(exports, "isOneOf", { enumerable: true, get: function () { return advanced_js_1.isOneOf; } });
+Object.defineProperty(exports, "isMatch", { enumerable: true, get: function () { return advanced_js_1.isMatch; } });
+Object.defineProperty(exports, "isMinLength", { enumerable: true, get: function () { return advanced_js_1.isMinLength; } });
+Object.defineProperty(exports, "isMaxLength", { enumerable: true, get: function () { return advanced_js_1.isMaxLength; } });
+Object.defineProperty(exports, "isInstanceOf", { enumerable: true, get: function () { return advanced_js_1.isInstanceOf; } });
+var combinators_js_1 = require("./combinators.js");
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return combinators_js_1.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return combinators_js_1.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return combinators_js_1.not; } });
+Object.defineProperty(exports, "shape", { enumerable: true, get: function () { return combinators_js_1.shape; } });
+Object.defineProperty(exports, "tuple", { enumerable: true, get: function () { return combinators_js_1.tuple; } });
+Object.defineProperty(exports, "arrayOf", { enumerable: true, get: function () { return combinators_js_1.arrayOf; } });
+Object.defineProperty(exports, "mapOf", { enumerable: true, get: function () { return combinators_js_1.mapOf; } });
+Object.defineProperty(exports, "recordOf", { enumerable: true, get: function () { return combinators_js_1.recordOf; } });
+Object.defineProperty(exports, "refine", { enumerable: true, get: function () { return combinators_js_1.refine; } });
+Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return combinators_js_1.optional; } });
+Object.defineProperty(exports, "nullable", { enumerable: true, get: function () { return combinators_js_1.nullable; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/guards/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;;;;AAE/E,iDAcyB;AAbvB,yGAAA,QAAQ,OAAA;AACR,yGAAA,QAAQ,OAAA;AACR,qHAAA,oBAAoB,OAAA;AACpB,+GAAA,cAAc,OAAA;AACd,0GAAA,SAAS,OAAA;AACT,yGAAA,QAAQ,OAAA;AACR,yGAAA,QAAQ,OAAA;AACR,uGAAA,MAAM,OAAA;AACN,4GAAA,WAAW,OAAA;AACX,0GAAA,SAAS,OAAA;AACT,6GAAA,YAAY,OAAA;AACZ,2GAAA,UAAU,OAAA;AACV,4GAAA,WAAW,OAAA;AAGb,iDAeyB;AAdvB,wGAAA,OAAO,OAAA;AACP,yGAAA,QAAQ,OAAA;AACR,8GAAA,aAAa,OAAA;AACb,sGAAA,KAAK,OAAA;AACL,sGAAA,KAAK,OAAA;AACL,0GAAA,SAAS,OAAA;AACT,0GAAA,SAAS,OAAA;AACT,uGAAA,MAAM,OAAA;AACN,4GAAA,WAAW,OAAA;AACX,yGAAA,QAAQ,OAAA;AACR,wGAAA,OAAO,OAAA;AACP,0GAAA,SAAS,OAAA;AACT,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AAGd,6CAmBuB;AAlBrB,+GAAA,gBAAgB,OAAA;AAChB,sGAAA,OAAO,OAAA;AACP,oGAAA,KAAK,OAAA;AACL,qGAAA,MAAM,OAAA;AACN,wGAAA,SAAS,OAAA;AACT,2GAAA,YAAY,OAAA;AACZ,yGAAA,UAAU,OAAA;AACV,+GAAA,gBAAgB,OAAA;AAChB,+GAAA,gBAAgB,OAAA;AAChB,wGAAA,SAAS,OAAA;AACT,4GAAA,aAAa,OAAA;AACb,8GAAA,eAAe,OAAA;AACf,wGAAA,SAAS,OAAA;AACT,sGAAA,OAAO,OAAA;AACP,sGAAA,OAAO,OAAA;AACP,0GAAA,WAAW,OAAA;AACX,0GAAA,WAAW,OAAA;AACX,2GAAA,YAAY,OAAA;AAGd,mDAY0B;AAXxB,qGAAA,GAAG,OAAA;AACH,oGAAA,EAAE,OAAA;AACF,qGAAA,GAAG,OAAA;AACH,uGAAA,KAAK,OAAA;AACL,uGAAA,KAAK,OAAA;AACL,yGAAA,OAAO,OAAA;AACP,uGAAA,KAAK,OAAA;AACL,0GAAA,QAAQ,OAAA;AACR,wGAAA,MAAM,OAAA;AACN,0GAAA,QAAQ,OAAA;AACR,0GAAA,QAAQ,OAAA"}

package/dist/cjs/guards/primitives.js

@@ -0,0 +1,123 @@
+"use strict";
+// ============================================================================
+// Guarden — Primitive Type Guards
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isString = isString;
+exports.isNumber = isNumber;
+exports.isNumberIncludingNaN = isNumberIncludingNaN;
+exports.isFiniteNumber = isFiniteNumber;
+exports.isBoolean = isBoolean;
+exports.isBigInt = isBigInt;
+exports.isSymbol = isSymbol;
+exports.isNull = isNull;
+exports.isUndefined = isUndefined;
+exports.isNullish = isNullish;
+exports.isNonNullish = isNonNullish;
+exports.isFunction = isFunction;
+exports.isPrimitive = isPrimitive;
+/**
+ * Check if a value is a string.
+ *
+ * @example
+ * ```ts
+ * const val: unknown = "hello";
+ * if (isString(val)) {
+ *   val.toUpperCase(); // TypeScript knows val is string
+ * }
+ * ```
+ */
+function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Check if a value is a number (excludes NaN by default).
+ *
+ * @example
+ * ```ts
+ * isNumber(42)      // true
+ * isNumber(NaN)     // false
+ * isNumber("42")    // false
+ * ```
+ */
+function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+/**
+ * Check if a value is a number, including NaN.
+ */
+function isNumberIncludingNaN(value) {
+    return typeof value === 'number';
+}
+/**
+ * Check if a value is a finite number (excludes NaN and Infinity).
+ */
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/**
+ * Check if a value is a boolean.
+ */
+function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Check if a value is a bigint.
+ */
+function isBigInt(value) {
+    return typeof value === 'bigint';
+}
+/**
+ * Check if a value is a symbol.
+ */
+function isSymbol(value) {
+    return typeof value === 'symbol';
+}
+/**
+ * Check if a value is null.
+ */
+function isNull(value) {
+    return value === null;
+}
+/**
+ * Check if a value is undefined.
+ */
+function isUndefined(value) {
+    return value === undefined;
+}
+/**
+ * Check if a value is null or undefined.
+ *
+ * @example
+ * ```ts
+ * if (!isNullish(val)) {
+ *   // val is narrowed to exclude null | undefined
+ * }
+ * ```
+ */
+function isNullish(value) {
+    return value === null || value === undefined;
+}
+/**
+ * Check if a value is NOT null and NOT undefined.
+ */
+function isNonNullish(value) {
+    return value !== null && value !== undefined;
+}
+/**
+ * Check if a value is a function.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+function isFunction(value) {
+    return typeof value === 'function';
+}
+/**
+ * Check if a value is a primitive type.
+ */
+function isPrimitive(value) {
+    if (value === null || value === undefined)
+        return true;
+    const t = typeof value;
+    return t === 'string' || t === 'number' || t === 'boolean' || t === 'bigint' || t === 'symbol';
+}
+//# sourceMappingURL=primitives.js.map

package/dist/cjs/guards/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/guards/primitives.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;;AAa/E,4BAEC;AAYD,4BAEC;AAKD,oDAEC;AAKD,wCAEC;AAKD,8BAEC;AAKD,4BAEC;AAKD,4BAEC;AAKD,wBAEC;AAKD,kCAEC;AAYD,8BAEC;AAKD,oCAEC;AAMD,gCAEC;AAKD,kCAMC;AApHD;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAI,KAAQ;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,sEAAsE;AACtE,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,CAAC;AACjG,CAAC"}

package/dist/cjs/guards/structures.js

@@ -0,0 +1,113 @@
+"use strict";
+// ============================================================================
+// Guarden — Structure Type Guards
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isArray = isArray;
+exports.isObject = isObject;
+exports.isPlainObject = isPlainObject;
+exports.isMap = isMap;
+exports.isSet = isSet;
+exports.isWeakMap = isWeakMap;
+exports.isWeakSet = isWeakSet;
+exports.isDate = isDate;
+exports.isValidDate = isValidDate;
+exports.isRegExp = isRegExp;
+exports.isError = isError;
+exports.isPromise = isPromise;
+exports.isArrayBuffer = isArrayBuffer;
+exports.isTypedArray = isTypedArray;
+/**
+ * Check if a value is an array.
+ */
+function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Check if a value is an object (excludes null and arrays).
+ */
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Check if a value is a plain object (created by `{}` or `Object.create(null)`).
+ * Excludes class instances, arrays, and other special objects.
+ */
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Check if a value is a Map.
+ */
+function isMap(value) {
+    return value instanceof Map;
+}
+/**
+ * Check if a value is a Set.
+ */
+function isSet(value) {
+    return value instanceof Set;
+}
+/**
+ * Check if a value is a WeakMap.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+function isWeakMap(value) {
+    return value instanceof WeakMap;
+}
+/**
+ * Check if a value is a WeakSet.
+ */
+function isWeakSet(value) {
+    return value instanceof WeakSet;
+}
+/**
+ * Check if a value is a Date instance.
+ */
+function isDate(value) {
+    return value instanceof Date;
+}
+/**
+ * Check if a value is a valid Date (not Invalid Date).
+ */
+function isValidDate(value) {
+    return value instanceof Date && !Number.isNaN(value.getTime());
+}
+/**
+ * Check if a value is a RegExp.
+ */
+function isRegExp(value) {
+    return value instanceof RegExp;
+}
+/**
+ * Check if a value is an Error instance.
+ */
+function isError(value) {
+    return value instanceof Error;
+}
+/**
+ * Check if a value is a Promise.
+ */
+function isPromise(value) {
+    return (value instanceof Promise ||
+        (typeof value === 'object' &&
+            value !== null &&
+            'then' in value &&
+            typeof value['then'] === 'function'));
+}
+/**
+ * Check if a value is an ArrayBuffer.
+ */
+function isArrayBuffer(value) {
+    return value instanceof ArrayBuffer;
+}
+/**
+ * Check if a value is a typed array (Uint8Array, Float32Array, etc.).
+ */
+function isTypedArray(value) {
+    return ArrayBuffer.isView(value) && !(value instanceof DataView);
+}
+//# sourceMappingURL=structures.js.map

package/dist/cjs/guards/structures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structures.js","sourceRoot":"","sources":["../../../src/guards/structures.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;;AAK/E,0BAEC;AAKD,4BAEC;AAMD,sCAIC;AAKD,sBAEC;AAKD,sBAEC;AAMD,8BAEC;AAKD,8BAEC;AAKD,wBAEC;AAKD,kCAEC;AAKD,4BAEC;AAKD,0BAEC;AAKD,8BAQC;AAKD,sCAEC;AAKD,oCAaC;AArHD;;GAEG;AACH,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAY,CAAC;IACtD,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,sEAAsE;AACtE,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,KAAK,YAAY,OAAO;QACxB,CAAC,OAAO,KAAK,KAAK,QAAQ;YACxB,KAAK,KAAK,IAAI;YACd,MAAM,IAAI,KAAK;YACf,OAAQ,KAAiC,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAC1B,KAAc;IAWd,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,CAAC;AACnE,CAAC"}