guarden 1.0.0

package/dist/esm/guards/advanced.js

@@ -0,0 +1,170 @@
+// ============================================================================
+// Guarden — Advanced Type Guards
+// ============================================================================
+// -- String guards ----------------------------------------------------------
+/**
+ * Check if a value is a non-empty string.
+ */
+export function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Check if a value is a string matching an email pattern.
+ */
+export function isEmail(value) {
+    if (typeof value !== 'string')
+        return false;
+    // RFC 5322 simplified pattern
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+/**
+ * Check if a value is a valid URL string.
+ */
+export function isURL(value) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a value is a valid UUID (v1-v5).
+ */
+export function isUUID(value) {
+    if (typeof value !== 'string')
+        return false;
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+/**
+ * Check if a value is a valid ISO 8601 date string.
+ */
+export function isISO8601(value) {
+    if (typeof value !== 'string')
+        return false;
+    const date = new Date(value);
+    return !Number.isNaN(date.getTime()) && /^\d{4}-\d{2}-\d{2}/.test(value);
+}
+/**
+ * Check if a value is a valid JSON string.
+ */
+export function isJSONString(value) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a value is a string matching a hex color (#fff or #ffffff).
+ */
+export function isHexColor(value) {
+    if (typeof value !== 'string')
+        return false;
+    return /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(value);
+}
+// -- Number guards ----------------------------------------------------------
+/**
+ * Check if a value is a positive number (> 0).
+ */
+export function isPositiveNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value) && value > 0;
+}
+/**
+ * Check if a value is a negative number (< 0).
+ */
+export function isNegativeNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value) && value < 0;
+}
+/**
+ * Check if a value is an integer.
+ */
+export function isInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value);
+}
+/**
+ * Check if a value is a safe integer (within Number.MAX_SAFE_INTEGER bounds).
+ */
+export function isSafeInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value);
+}
+// -- Array guards -----------------------------------------------------------
+/**
+ * Check if a value is a non-empty array.
+ */
+export function isNonEmptyArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+// -- Factory guards ---------------------------------------------------------
+/**
+ * Create a guard that checks if a number is within a range [min, max].
+ *
+ * @example
+ * ```ts
+ * const isPercent = isInRange(0, 100);
+ * isPercent(50)   // true
+ * isPercent(150)  // false
+ * ```
+ */
+export function isInRange(min, max) {
+    return (value) => typeof value === 'number' && !Number.isNaN(value) && value >= min && value <= max;
+}
+/**
+ * Create a guard that checks if a value is one of the specified values.
+ *
+ * @example
+ * ```ts
+ * const isDirection = isOneOf(['up', 'down', 'left', 'right'] as const);
+ * if (isDirection(input)) {
+ *   // input is 'up' | 'down' | 'left' | 'right'
+ * }
+ * ```
+ */
+export function isOneOf(values) {
+    const valueSet = new Set(values);
+    return (value) => valueSet.has(value);
+}
+/**
+ * Create a guard that checks if a string matches a pattern.
+ *
+ * @example
+ * ```ts
+ * const isSlug = isMatch(/^[a-z0-9-]+$/);
+ * isSlug("hello-world") // true
+ * isSlug("Hello World") // false
+ * ```
+ */
+export function isMatch(pattern) {
+    return (value) => typeof value === 'string' && pattern.test(value);
+}
+/**
+ * Create a guard that checks if a string has a minimum length.
+ */
+export function isMinLength(min) {
+    return (value) => typeof value === 'string' && value.length >= min;
+}
+/**
+ * Create a guard that checks if a string has a maximum length.
+ */
+export function isMaxLength(max) {
+    return (value) => typeof value === 'string' && value.length <= max;
+}
+/**
+ * Check if a value is an instance of a given class.
+ *
+ * @example
+ * ```ts
+ * const isMyError = isInstanceOf(TypeError);
+ * ```
+ */
+export function isInstanceOf(constructor) {
+    return (value) => value instanceof constructor;
+}
+//# sourceMappingURL=advanced.js.map

package/dist/esm/guards/advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.js","sourceRoot":"","sources":["../../../src/guards/advanced.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAI/E,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,8BAA8B;IAC9B,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,4EAA4E,CAAC,IAAI,CACtF,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,6CAA6C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,OAAO,CAAC,KAAc,EAAmB,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACtF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACrB,MAAS;IAET,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAU,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAc,EAAsB,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,KAAc,EAAmB,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CAAC,KAAc,EAAmB,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CAAC,KAAc,EAAmB,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,WAA0C;IAE1C,OAAO,CAAC,KAAc,EAAc,EAAE,CAAC,KAAK,YAAY,WAAW,CAAC;AACtE,CAAC"}

package/dist/esm/guards/combinators.js

@@ -0,0 +1,182 @@
+// ============================================================================
+// Guarden — Guard Combinators
+// ============================================================================
+/**
+ * Combine two guards with AND logic (intersection).
+ * Value must satisfy both guards.
+ *
+ * @example
+ * ```ts
+ * const isPositiveInteger = and(isInteger, isPositiveNumber);
+ * ```
+ */
+export 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);
+ * ```
+ */
+export function or(guardA, guardB) {
+    return (value) => guardA(value) || guardB(value);
+}
+/**
+ * Negate a guard.
+ *
+ * @example
+ * ```ts
+ * const isNotNull = not(isNull);
+ * ```
+ */
+export 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
+ * }
+ * ```
+ */
+export 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]
+ * }
+ * ```
+ */
+export 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[]
+ * }
+ * ```
+ */
+export 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);
+ * ```
+ */
+export 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);
+ * ```
+ */
+export 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);
+ * ```
+ */
+export 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
+ * ```
+ */
+export function optional(guard) {
+    return (value) => value === undefined || guard(value);
+}
+/**
+ * Create a nullable guard — allows null in addition to the guarded type.
+ */
+export function nullable(guard) {
+    return (value) => value === null || guard(value);
+}
+//# sourceMappingURL=combinators.js.map

package/dist/esm/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/esm/guards/index.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// Guarden — Guards Module Barrel Export
+// ============================================================================
+export { isString, isNumber, isNumberIncludingNaN, isFiniteNumber, isBoolean, isBigInt, isSymbol, isNull, isUndefined, isNullish, isNonNullish, isFunction, isPrimitive, } from './primitives.js';
+export { isArray, isObject, isPlainObject, isMap, isSet, isWeakMap, isWeakSet, isDate, isValidDate, isRegExp, isError, isPromise, isArrayBuffer, isTypedArray, } from './structures.js';
+export { isNonEmptyString, isEmail, isURL, isUUID, isISO8601, isJSONString, isHexColor, isPositiveNumber, isNegativeNumber, isInteger, isSafeInteger, isNonEmptyArray, isInRange, isOneOf, isMatch, isMinLength, isMaxLength, isInstanceOf, } from './advanced.js';
+export { and, or, not, shape, tuple, arrayOf, mapOf, recordOf, refine, optional, nullable, } from './combinators.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EACb,KAAK,EACL,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,eAAe,EACf,SAAS,EACT,OAAO,EACP,OAAO,EACP,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,GAAG,EACH,EAAE,EACF,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,GACT,MAAM,kBAAkB,CAAC"}

package/dist/esm/guards/primitives.js

@@ -0,0 +1,108 @@
+// ============================================================================
+// Guarden — Primitive Type Guards
+// ============================================================================
+/**
+ * Check if a value is a string.
+ *
+ * @example
+ * ```ts
+ * const val: unknown = "hello";
+ * if (isString(val)) {
+ *   val.toUpperCase(); // TypeScript knows val is string
+ * }
+ * ```
+ */
+export 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
+ * ```
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+/**
+ * Check if a value is a number, including NaN.
+ */
+export function isNumberIncludingNaN(value) {
+    return typeof value === 'number';
+}
+/**
+ * Check if a value is a finite number (excludes NaN and Infinity).
+ */
+export function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/**
+ * Check if a value is a boolean.
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Check if a value is a bigint.
+ */
+export function isBigInt(value) {
+    return typeof value === 'bigint';
+}
+/**
+ * Check if a value is a symbol.
+ */
+export function isSymbol(value) {
+    return typeof value === 'symbol';
+}
+/**
+ * Check if a value is null.
+ */
+export function isNull(value) {
+    return value === null;
+}
+/**
+ * Check if a value is undefined.
+ */
+export 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
+ * }
+ * ```
+ */
+export function isNullish(value) {
+    return value === null || value === undefined;
+}
+/**
+ * Check if a value is NOT null and NOT undefined.
+ */
+export 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
+export function isFunction(value) {
+    return typeof value === 'function';
+}
+/**
+ * Check if a value is a primitive type.
+ */
+export 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/esm/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;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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/esm/guards/structures.js

@@ -0,0 +1,97 @@
+// ============================================================================
+// Guarden — Structure Type Guards
+// ============================================================================
+/**
+ * Check if a value is an array.
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Check if a value is an object (excludes null and arrays).
+ */
+export 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.
+ */
+export 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.
+ */
+export function isMap(value) {
+    return value instanceof Map;
+}
+/**
+ * Check if a value is a Set.
+ */
+export function isSet(value) {
+    return value instanceof Set;
+}
+/**
+ * Check if a value is a WeakMap.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export function isWeakMap(value) {
+    return value instanceof WeakMap;
+}
+/**
+ * Check if a value is a WeakSet.
+ */
+export function isWeakSet(value) {
+    return value instanceof WeakSet;
+}
+/**
+ * Check if a value is a Date instance.
+ */
+export function isDate(value) {
+    return value instanceof Date;
+}
+/**
+ * Check if a value is a valid Date (not Invalid Date).
+ */
+export function isValidDate(value) {
+    return value instanceof Date && !Number.isNaN(value.getTime());
+}
+/**
+ * Check if a value is a RegExp.
+ */
+export function isRegExp(value) {
+    return value instanceof RegExp;
+}
+/**
+ * Check if a value is an Error instance.
+ */
+export function isError(value) {
+    return value instanceof Error;
+}
+/**
+ * Check if a value is a Promise.
+ */
+export 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.
+ */
+export function isArrayBuffer(value) {
+    return value instanceof ArrayBuffer;
+}
+/**
+ * Check if a value is a typed array (Uint8Array, Float32Array, etc.).
+ */
+export function isTypedArray(value) {
+    return ArrayBuffer.isView(value) && !(value instanceof DataView);
+}
+//# sourceMappingURL=structures.js.map

package/dist/esm/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;AAE/E;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAc;IAWd,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,CAAC;AACnE,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,17 @@
+// ============================================================================
+// Guarden — Main Entry Point
+// TypeScript-First Runtime Safety Toolkit
+// ============================================================================
+// Guards
+export { isString, isNumber, isNumberIncludingNaN, isFiniteNumber, isBoolean, isBigInt, isSymbol, isNull, isUndefined, isNullish, isNonNullish, isFunction, isPrimitive, isArray, isObject, isPlainObject, isMap, isSet, isWeakMap, isWeakSet, isDate, isValidDate, isRegExp, isError, isPromise, isArrayBuffer, isTypedArray, isNonEmptyString, isEmail, isURL, isUUID, isISO8601, isJSONString, isHexColor, isPositiveNumber, isNegativeNumber, isInteger, isSafeInteger, isNonEmptyArray, isInRange, isOneOf, isMatch, isMinLength, isMaxLength, isInstanceOf, and, or, not, shape, tuple, arrayOf, mapOf, recordOf, refine, optional, nullable, } from './guards/index.js';
+// Assert
+export { assert, assertDefined, assertNonNull, assertType, assertTruthy, invariant, unreachable, } from './assert/index.js';
+// Result & Option
+export { Ok, Err, ResultUtils, Some, None, OptionUtils, ResultAsync, OptionAsync, } from './result/index.js';
+// Transform
+export { pipe, flow, toNumber, toString, toBoolean, toDate, toArray, toInteger, trim, trimStart, trimEnd, lowercase, uppercase, capitalize, titleCase, camelCase, kebabCase, snakeCase, stripHtml, escapeHtml, unescapeHtml, truncate, slugify, removeWhitespace, collapseWhitespace, padStart, padEnd, reverse, countOccurrences, } from './transform/index.js';
+// Env
+export { createEnv, envString, envNumber, envBoolean, envEnum, EnvField, } from './env/index.js';
+// Errors
+export { GuardenError, AssertionError, InvariantError, CoercionError, EnvValidationError, EnvConfigError, UnreachableError, } from './utils/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6BAA6B;AAC7B,0CAA0C;AAC1C,+EAA+E;AAE/E,SAAS;AACT,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,QAAQ,EACR,aAAa,EACb,KAAK,EACL,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,eAAe,EACf,SAAS,EACT,OAAO,EACP,OAAO,EACP,WAAW,EACX,WAAW,EACX,YAAY,EACZ,GAAG,EACH,EAAE,EACF,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,SAAS;AACT,OAAO,EACL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,EAAE,EACF,GAAG,EACH,WAAW,EAEX,IAAI,EACJ,IAAI,EACJ,WAAW,EAEX,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,IAAI,EACJ,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,MAAM,EACN,OAAO,EACP,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM;AACN,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,SAAS;AACT,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}