guarden 1.0.0

package/dist/types/guards/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/guards/advanced.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAIvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQrD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAG1D;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAEtB;AAID;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAGjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAClD,MAAM,EAAE,CAAC,GACR,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAGlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAGtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAGtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GACzC,KAAK,CAAC,CAAC,CAAC,CAEV"}

package/dist/types/guards/combinators.d.ts

@@ -0,0 +1,120 @@
+import type { Guard, GuardType, ShapeGuardType } from '../utils/types.js';
+/**
+ * Combine two guards with AND logic (intersection).
+ * Value must satisfy both guards.
+ *
+ * @example
+ * ```ts
+ * const isPositiveInteger = and(isInteger, isPositiveNumber);
+ * ```
+ */
+export declare function and<A, B>(guardA: Guard<A>, guardB: Guard<B>): Guard<A & B>;
+/**
+ * Combine two guards with OR logic (union).
+ * Value must satisfy at least one guard.
+ *
+ * @example
+ * ```ts
+ * const isStringOrNumber = or(isString, isNumber);
+ * ```
+ */
+export declare function or<A, B>(guardA: Guard<A>, guardB: Guard<B>): Guard<A | B>;
+/**
+ * Negate a guard.
+ *
+ * @example
+ * ```ts
+ * const isNotNull = not(isNull);
+ * ```
+ */
+export declare function not<T>(guard: Guard<T>): (value: unknown) => boolean;
+/**
+ * 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 declare function shape<T extends Record<string, Guard<unknown>>>(schema: T): Guard<ShapeGuardType<T>>;
+/**
+ * Create a guard that validates a tuple.
+ *
+ * @example
+ * ```ts
+ * const isCoord = tuple(isNumber, isNumber);
+ * if (isCoord(data)) {
+ *   const [x, y] = data; // [number, number]
+ * }
+ * ```
+ */
+export declare function tuple<T extends Guard<unknown>[]>(...guards: T): Guard<{
+    [K in keyof T]: GuardType<T[K]>;
+}>;
+/**
+ * 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 declare function arrayOf<T>(guard: Guard<T>): Guard<T[]>;
+/**
+ * Create a guard that validates Map entries.
+ *
+ * @example
+ * ```ts
+ * const isStringNumberMap = mapOf(isString, isNumber);
+ * ```
+ */
+export declare function mapOf<K, V>(keyGuard: Guard<K>, valueGuard: Guard<V>): Guard<Map<K, V>>;
+/**
+ * Create a guard that validates Record (object) entries.
+ *
+ * @example
+ * ```ts
+ * const isScoreBoard = recordOf(isString, isNumber);
+ * ```
+ */
+export declare function recordOf<V>(valueGuard: Guard<V>): Guard<Record<string, V>>;
+/**
+ * Create a guard with a custom refinement predicate.
+ *
+ * @example
+ * ```ts
+ * const isEvenNumber = refine(isNumber, (n) => n % 2 === 0);
+ * ```
+ */
+export declare function refine<T>(guard: Guard<T>, predicate: (value: T) => boolean): Guard<T>;
+/**
+ * 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 declare function optional<T>(guard: Guard<T>): Guard<T | undefined>;
+/**
+ * Create a nullable guard — allows null in addition to the guarded type.
+ */
+export declare function nullable<T>(guard: Guard<T>): Guard<T | null>;
+//# sourceMappingURL=combinators.d.ts.map

package/dist/types/guards/combinators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.d.ts","sourceRoot":"","sources":["../../../src/guards/combinators.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EACtB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAChB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GACf,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAEd;AAED;;;;;;;;GAQG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EACrB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAChB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GACf,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAEd;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAEnE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,EAC5D,MAAM,EAAE,CAAC,GACR,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAU1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,EAAE,EAC9C,GAAG,MAAM,EAAE,CAAC,GACX,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAM5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAKtD;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EACxB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAClB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,GACnB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAQlB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,GACnB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAU1B;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAC/B,KAAK,CAAC,CAAC,CAAC,CAEV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAG5D"}

package/dist/types/guards/index.d.ts

@@ -0,0 +1,5 @@
+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.d.ts.map

package/dist/types/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/guards/index.ts"],"names":[],"mappings":"AAIA,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/types/guards/primitives.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Check if a value is a string.
+ *
+ * @example
+ * ```ts
+ * const val: unknown = "hello";
+ * if (isString(val)) {
+ *   val.toUpperCase(); // TypeScript knows val is string
+ * }
+ * ```
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Check if a value is a number (excludes NaN by default).
+ *
+ * @example
+ * ```ts
+ * isNumber(42)      // true
+ * isNumber(NaN)     // false
+ * isNumber("42")    // false
+ * ```
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Check if a value is a number, including NaN.
+ */
+export declare function isNumberIncludingNaN(value: unknown): value is number;
+/**
+ * Check if a value is a finite number (excludes NaN and Infinity).
+ */
+export declare function isFiniteNumber(value: unknown): value is number;
+/**
+ * Check if a value is a boolean.
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Check if a value is a bigint.
+ */
+export declare function isBigInt(value: unknown): value is bigint;
+/**
+ * Check if a value is a symbol.
+ */
+export declare function isSymbol(value: unknown): value is symbol;
+/**
+ * Check if a value is null.
+ */
+export declare function isNull(value: unknown): value is null;
+/**
+ * Check if a value is undefined.
+ */
+export declare function isUndefined(value: unknown): value is undefined;
+/**
+ * Check if a value is null or undefined.
+ *
+ * @example
+ * ```ts
+ * if (!isNullish(val)) {
+ *   // val is narrowed to exclude null | undefined
+ * }
+ * ```
+ */
+export declare function isNullish(value: unknown): value is null | undefined;
+/**
+ * Check if a value is NOT null and NOT undefined.
+ */
+export declare function isNonNullish<T>(value: T): value is NonNullable<T>;
+/**
+ * Check if a value is a function.
+ */
+export declare function isFunction(value: unknown): value is Function;
+/**
+ * Check if a value is a primitive type.
+ */
+export declare function isPrimitive(value: unknown): value is string | number | boolean | bigint | symbol | null | undefined;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/types/guards/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/guards/primitives.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAEjE;AAED;;GAEG;AAEH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAIzE"}

package/dist/types/guards/structures.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Check if a value is an array.
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * Check if a value is an object (excludes null and arrays).
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if a value is a plain object (created by `{}` or `Object.create(null)`).
+ * Excludes class instances, arrays, and other special objects.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if a value is a Map.
+ */
+export declare function isMap(value: unknown): value is Map<unknown, unknown>;
+/**
+ * Check if a value is a Set.
+ */
+export declare function isSet(value: unknown): value is Set<unknown>;
+/**
+ * Check if a value is a WeakMap.
+ */
+export declare function isWeakMap(value: unknown): value is WeakMap<object, unknown>;
+/**
+ * Check if a value is a WeakSet.
+ */
+export declare function isWeakSet(value: unknown): value is WeakSet<object>;
+/**
+ * Check if a value is a Date instance.
+ */
+export declare function isDate(value: unknown): value is Date;
+/**
+ * Check if a value is a valid Date (not Invalid Date).
+ */
+export declare function isValidDate(value: unknown): value is Date;
+/**
+ * Check if a value is a RegExp.
+ */
+export declare function isRegExp(value: unknown): value is RegExp;
+/**
+ * Check if a value is an Error instance.
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Check if a value is a Promise.
+ */
+export declare function isPromise(value: unknown): value is Promise<unknown>;
+/**
+ * Check if a value is an ArrayBuffer.
+ */
+export declare function isArrayBuffer(value: unknown): value is ArrayBuffer;
+/**
+ * Check if a value is a typed array (Uint8Array, Float32Array, etc.).
+ */
+export declare function isTypedArray(value: unknown): value is Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;
+//# sourceMappingURL=structures.d.ts.map

package/dist/types/guards/structures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structures.d.ts","sourceRoot":"","sources":["../../../src/guards/structures.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAE3D;AAED;;GAEG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAQnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,GACb,KAAK,IACJ,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,YAAY,GACZ,YAAY,CAEf"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+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';
+export { assert, assertDefined, assertNonNull, assertType, assertTruthy, invariant, unreachable, } from './assert/index.js';
+export { Ok, Err, ResultUtils, type Result, Some, None, OptionUtils, type Option, ResultAsync, OptionAsync, } from './result/index.js';
+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';
+export { createEnv, envString, envNumber, envBoolean, envEnum, EnvField, } from './env/index.js';
+export { GuardenError, AssertionError, InvariantError, CoercionError, EnvValidationError, EnvConfigError, UnreachableError, } from './utils/errors.js';
+export type { Guard, GuardType, Nullish, NonNullish, Primitive, PlainObject, AnyFunction, Brand, } from './utils/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,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;AAG3B,OAAO,EACL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,EAAE,EACF,GAAG,EACH,WAAW,EACX,KAAK,MAAM,EACX,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,KAAK,MAAM,EACX,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,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;AAG9B,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,KAAK,EACL,SAAS,EACT,OAAO,EACP,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,KAAK,GACN,MAAM,kBAAkB,CAAC"}

package/dist/types/result/async.d.ts

@@ -0,0 +1,72 @@
+import { type Result } from './result.js';
+import { type Option } from './option.js';
+/**
+ * A Result wrapped in a Promise, with chainable async operations.
+ *
+ * @example
+ * ```ts
+ * const result = ResultAsync.from(fetch('/api/user'))
+ *   .map(res => res.json())
+ *   .mapErr(err => new ApiError(err.message));
+ * ```
+ */
+export declare class ResultAsync<T, E> {
+    private readonly promise;
+    constructor(promise: Promise<Result<T, E>>);
+    /**
+     * Create from a Promise that may reject.
+     */
+    static from<T>(promise: Promise<T>): ResultAsync<T, Error>;
+    /**
+     * Create from a Result.
+     */
+    static fromResult<T, E>(result: Result<T, E>): ResultAsync<T, E>;
+    /**
+     * Create an Ok ResultAsync.
+     */
+    static ok<T>(value: T): ResultAsync<T, never>;
+    /**
+     * Create an Err ResultAsync.
+     */
+    static err<E>(error: E): ResultAsync<never, E>;
+    /** Transform the success value. */
+    map<U>(fn: (value: T) => U): ResultAsync<U, E>;
+    /** Transform the error value. */
+    mapErr<F>(fn: (error: E) => F): ResultAsync<T, F>;
+    /** Chain async operations. */
+    andThen<U>(fn: (value: T) => ResultAsync<U, E>): ResultAsync<U, E>;
+    /** Extract the underlying Promise<Result>. */
+    toPromise(): Promise<Result<T, E>>;
+    /** Unwrap or throw. */
+    unwrap(): Promise<T>;
+    /** Unwrap or return default. */
+    unwrapOr(defaultValue: T): Promise<T>;
+    /** Pattern match on the resolved Result. */
+    match<U>(handlers: {
+        ok: (value: T) => U;
+        err: (error: E) => U;
+    }): Promise<U>;
+}
+/**
+ * An Option wrapped in a Promise.
+ */
+export declare class OptionAsync<T> {
+    private readonly promise;
+    constructor(promise: Promise<Option<T>>);
+    /**
+     * Create from a Promise that resolves to a nullable value.
+     */
+    static from<T>(promise: Promise<T | null | undefined>): OptionAsync<T>;
+    static some<T>(value: T): OptionAsync<T>;
+    static none<T = never>(): OptionAsync<T>;
+    map<U>(fn: (value: T) => U): OptionAsync<U>;
+    andThen<U>(fn: (value: T) => OptionAsync<U>): OptionAsync<U>;
+    toPromise(): Promise<Option<T>>;
+    unwrap(): Promise<T>;
+    unwrapOr(defaultValue: T): Promise<T>;
+    match<U>(handlers: {
+        some: (value: T) => U;
+        none: () => U;
+    }): Promise<U>;
+}
+//# sourceMappingURL=async.d.ts.map

package/dist/types/result/async.d.ts.map

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

package/dist/types/result/index.d.ts

@@ -0,0 +1,4 @@
+export { Ok, Err, ResultUtils, type Result } from './result.js';
+export { Some, None, OptionUtils, type Option } from './option.js';
+export { ResultAsync, OptionAsync } from './async.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/result/option.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Represents a value that may or may not exist.
+ * Eliminates null/undefined bugs by making optionality explicit.
+ *
+ * @example
+ * ```ts
+ * const user = Option.from(getUserById(id));
+ * const name = user.map(u => u.name).unwrapOr('Anonymous');
+ * ```
+ */
+export type Option<T> = SomeOption<T> | NoneOption<T>;
+declare class SomeOption<T> {
+    readonly value: T;
+    readonly _tag: "Some";
+    constructor(value: T);
+    isSome(): this is SomeOption<T>;
+    isNone(): this is NoneOption<T>;
+    /** Transform the contained value. */
+    map<U>(fn: (value: T) => U): Option<U>;
+    /** Chain operations that return an Option (flatMap). */
+    andThen<U>(fn: (value: T) => Option<U>): Option<U>;
+    /** Return this Option if Some, otherwise return the other. */
+    orElse(_fn: () => Option<T>): Option<T>;
+    /** Get the value, or throw if None. */
+    unwrap(): T;
+    /** Get the value, or return a default. */
+    unwrapOr(_defaultValue: T): T;
+    /** Get the value, or compute a default. */
+    unwrapOrElse(_fn: () => T): T;
+    /** Pattern match on the Option. */
+    match<U>(handlers: {
+        some: (value: T) => U;
+        none: () => U;
+    }): U;
+    /** Filter: return None if the predicate fails. */
+    filter(predicate: (value: T) => boolean): Option<T>;
+    /** Apply a side-effect function if Some. */
+    tap(fn: (value: T) => void): Option<T>;
+    /** Zip with another Option. */
+    zip<U>(other: Option<U>): Option<[T, U]>;
+    toJSON(): {
+        tag: 'Some';
+        value: T;
+    };
+    toString(): string;
+}
+declare class NoneOption<T> {
+    readonly _tag: "None";
+    isSome(): this is SomeOption<T>;
+    isNone(): this is NoneOption<T>;
+    map<U>(_fn: (value: T) => U): Option<U>;
+    andThen<U>(_fn: (value: T) => Option<U>): Option<U>;
+    orElse(fn: () => Option<T>): Option<T>;
+    unwrap(): T;
+    unwrapOr(defaultValue: T): T;
+    unwrapOrElse(fn: () => T): T;
+    match<U>(handlers: {
+        some: (value: T) => U;
+        none: () => U;
+    }): U;
+    filter(_predicate: (value: T) => boolean): Option<T>;
+    tap(_fn: (value: T) => void): Option<T>;
+    zip<U>(_other: Option<U>): Option<[T, U]>;
+    toJSON(): {
+        tag: 'None';
+    };
+    toString(): string;
+}
+/**
+ * Create an Option containing a value.
+ */
+export declare function Some<T>(value: T): Option<T>;
+/**
+ * Create an empty Option.
+ */
+export declare function None<T = never>(): Option<T>;
+export declare const OptionUtils: {
+    /**
+     * Create an Option from a nullable value.
+     * null | undefined → None, everything else → Some.
+     *
+     * @example
+     * ```ts
+     * Option.from(null)      // None
+     * Option.from(undefined) // None
+     * Option.from(42)        // Some(42)
+     * Option.from('')        // Some('')  (empty string is still Some)
+     * ```
+     */
+    from<T>(value: T | null | undefined): Option<T>;
+    /**
+     * Create an Option from a predicate check.
+     */
+    fromPredicate<T>(value: T, predicate: (v: T) => boolean): Option<T>;
+    /**
+     * Check if a value is an Option.
+     */
+    isOption<T>(value: unknown): value is Option<T>;
+    /**
+     * Collect an array of Options into an Option of array.
+     * Returns None if any Option is None.
+     */
+    all<T>(options: Option<T>[]): Option<T[]>;
+};
+export {};
+//# sourceMappingURL=option.d.ts.map

package/dist/types/result/option.d.ts.map

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

package/dist/types/result/result.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Represents the result of an operation that can succeed (`Ok`) or fail (`Err`).
+ * Inspired by Rust's Result type — makes errors explicit in the type system.
+ *
+ * @example
+ * ```ts
+ * function divide(a: number, b: number): Result<number, string> {
+ *   if (b === 0) return Err('Division by zero');
+ *   return Ok(a / b);
+ * }
+ *
+ * const result = divide(10, 2);
+ * result.match({
+ *   ok: (value) => console.log(`Result: ${value}`),
+ *   err: (error) => console.error(`Error: ${error}`),
+ * });
+ * ```
+ */
+export type Result<T, E> = OkResult<T, E> | ErrResult<T, E>;
+declare class OkResult<T, E> {
+    readonly value: T;
+    readonly _tag: "Ok";
+    constructor(value: T);
+    isOk(): this is OkResult<T, E>;
+    isErr(): this is ErrResult<T, E>;
+    /** Transform the success value. */
+    map<U>(fn: (value: T) => U): Result<U, E>;
+    /** Transform the error value (no-op for Ok). */
+    mapErr<F>(_fn: (error: E) => F): Result<T, F>;
+    /** Chain operations that return a Result (flatMap). */
+    andThen<U>(fn: (value: T) => Result<U, E>): Result<U, E>;
+    /** Return this Result if Ok, otherwise return the other. */
+    orElse<F>(_fn: (error: E) => Result<T, F>): Result<T, F>;
+    /** Get the value, or throw if Err. */
+    unwrap(): T;
+    /** Get the value, or return a default. */
+    unwrapOr(_defaultValue: T): T;
+    /** Get the value, or compute a default from the error. */
+    unwrapOrElse(_fn: (error: E) => T): T;
+    /** Get the error, or throw if Ok. */
+    unwrapErr(): E;
+    /** Pattern match on the Result. */
+    match<U>(handlers: {
+        ok: (value: T) => U;
+        err: (error: E) => U;
+    }): U;
+    /** Convert to an Option, discarding the error. */
+    ok(): T | undefined;
+    /** Convert to an Option of the error (returns undefined for Ok). */
+    err(): E | undefined;
+    /** Apply a function to the value if Ok, used for side effects. */
+    tap(fn: (value: T) => void): Result<T, E>;
+    /** Apply a function to the error if Err (no-op for Ok). */
+    tapErr(_fn: (error: E) => void): Result<T, E>;
+    /** Convert to a JSON-friendly representation. */
+    toJSON(): {
+        tag: 'Ok';
+        value: T;
+    };
+    toString(): string;
+}
+declare class ErrResult<T, E> {
+    readonly error: E;
+    readonly _tag: "Err";
+    constructor(error: E);
+    isOk(): this is OkResult<T, E>;
+    isErr(): this is ErrResult<T, E>;
+    map<U>(_fn: (value: T) => U): Result<U, E>;
+    mapErr<F>(fn: (error: E) => F): Result<T, F>;
+    andThen<U>(_fn: (value: T) => Result<U, E>): Result<U, E>;
+    orElse<F>(fn: (error: E) => Result<T, F>): Result<T, F>;
+    unwrap(): T;
+    unwrapOr(defaultValue: T): T;
+    unwrapOrElse(fn: (error: E) => T): T;
+    unwrapErr(): E;
+    match<U>(handlers: {
+        ok: (value: T) => U;
+        err: (error: E) => U;
+    }): U;
+    ok(): T | undefined;
+    err(): E | undefined;
+    tap(_fn: (value: T) => void): Result<T, E>;
+    tapErr(fn: (error: E) => void): Result<T, E>;
+    toJSON(): {
+        tag: 'Err';
+        error: E;
+    };
+    toString(): string;
+}
+/**
+ * Create a successful Result.
+ */
+export declare function Ok<T>(value: T): Result<T, never>;
+/**
+ * Create a failed Result.
+ */
+export declare function Err<E>(error: E): Result<never, E>;
+/**
+ * Result namespace with static utility methods.
+ */
+export declare const ResultUtils: {
+    /**
+     * Wrap a function that may throw into a Result.
+     *
+     * @example
+     * ```ts
+     * const result = Result.from(() => JSON.parse(input));
+     * ```
+     */
+    from<T>(fn: () => T): Result<T, Error>;
+    /**
+     * Wrap a Promise into a ResultAsync.
+     */
+    fromPromise<T>(promise: Promise<T>): Promise<Result<T, Error>>;
+    /**
+     * Collect an array of Results into a Result of an array.
+     * Returns the first Err encountered, or Ok with all values.
+     */
+    all<T, E>(results: Result<T, E>[]): Result<T[], E>;
+    /**
+     * Check if a value is a Result.
+     */
+    isResult<T, E>(value: unknown): value is Result<T, E>;
+};
+export {};
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result/result.d.ts.map

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