ts-data-forge 14.6.3 → 14.7.0

package/dist/functional/optional/impl/index.d.mts

@@ -1,19 +0,0 @@
-export * from './optional-expect-to-be.mjs';
-export * from './optional-filter.mjs';
-export * from './optional-flat-map.mjs';
-export * from './optional-from-nullable.mjs';
-export * from './optional-is-none.mjs';
-export * from './optional-is-optional.mjs';
-export * from './optional-is-some.mjs';
-export * from './optional-map.mjs';
-export * from './optional-match.mjs';
-export * from './optional-none.mjs';
-export * from './optional-or-else.mjs';
-export * from './optional-some.mjs';
-export * from './optional-to-nullable.mjs';
-export * from './optional-unwrap-or.mjs';
-export * from './optional-unwrap-throw.mjs';
-export * from './optional-unwrap.mjs';
-export * from './optional-zip.mjs';
-export * from './types.mjs';
-//# sourceMappingURL=index.d.mts.map

package/dist/functional/optional/impl/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/index.mts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/functional/optional/impl/index.mjs

@@ -1,19 +0,0 @@
-export * from './optional-expect-to-be.mjs';
-export * from './optional-filter.mjs';
-export * from './optional-flat-map.mjs';
-export * from './optional-from-nullable.mjs';
-export * from './optional-is-none.mjs';
-export * from './optional-is-optional.mjs';
-export * from './optional-is-some.mjs';
-export * from './optional-map.mjs';
-export * from './optional-match.mjs';
-export * from './optional-none.mjs';
-export * from './optional-or-else.mjs';
-export * from './optional-some.mjs';
-export * from './optional-to-nullable.mjs';
-export * from './optional-unwrap-or.mjs';
-export * from './optional-unwrap-throw.mjs';
-export * from './optional-unwrap.mjs';
-export * from './optional-zip.mjs';
-export * from './types.mjs';
-//# sourceMappingURL=index.mjs.map

package/dist/functional/optional/impl/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/index.mts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/functional/optional/impl/optional-expect-to-be.d.mts

@@ -1,37 +0,0 @@
-import { type Optional, type UnknownOptional } from '../optional.mjs';
-import { type Unwrap } from './types.mjs';
-/**
- * Unwraps an `Optional`, returning the contained value or throwing an error
- * with the provided message.
- *
- * @example
- *
- * ```ts
- * const optionalValue = Optional.some('data');
- *
- * assert.isTrue(
- *   Optional.expectToBe(optionalValue, 'value expected') === 'data',
- * );
- *
- * const expectValue = Optional.expectToBe('missing optional');
- *
- * const throwTest = (): void => {
- *   expectValue(Optional.none);
- * };
- *
- * assert.throws(throwTest, /missing optional/u);
- *
- * assert.isTrue(expectValue(Optional.some('present')) === 'present');
- * ```
- *
- * @template O The `UnknownOptional` type to unwrap.
- * @param optional The `Optional` to unwrap.
- * @param message The error message to throw if the `Optional` is
- *   `None`.
- * @returns The contained value if `Some`.
- * @throws Error with the provided message if the `Optional` is
- *   `None`.
- */
-export declare function expectToBe<O extends UnknownOptional>(optional: O, message: string): Unwrap<O>;
-export declare function expectToBe(message: string): <O>(optional: Optional<O>) => O;
-//# sourceMappingURL=optional-expect-to-be.d.mts.map

package/dist/functional/optional/impl/optional-expect-to-be.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAClD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,CAAC,CAAC,CAAC;AAGb,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-expect-to-be.mjs

@@ -1,22 +0,0 @@
-import { isSome } from './optional-is-some.mjs';
-import { unwrap } from './optional-unwrap.mjs';
-export function expectToBe(...args) {
-    switch (args.length) {
-        case 2: {
-            const [optional, message] = args;
-            return expectToBeImpl(optional, message);
-        }
-        case 1: {
-
-            const [message] = args;
-            return (optional) => expectToBeImpl(optional, message);
-        }
-    }
-}
-const expectToBeImpl = (optional, message) => {
-    if (isSome(optional)) {
-        return unwrap(optional);
-    }
-    throw new Error(message);
-};
-//# sourceMappingURL=optional-expect-to-be.mjs.map

package/dist/functional/optional/impl/optional-expect-to-be.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-expect-to-be.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA2C/C,MAAM,UAAU,UAAU,CACxB,GAAG,IAA0E;IAE7E,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;YAEjC,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,EAAE,CAAC;YACP,6CAA6C;YAC7C,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;YAEvB,OAAO,CAAC,QAA6B,EAAa,EAAE,CAClD,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,CACrB,QAAW,EACX,OAAe,EACJ,EAAE;IACb,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-filter.d.mts

@@ -1,33 +0,0 @@
-import { type Optional, type UnknownOptional } from '../optional.mjs';
-import { type Unwrap } from './types.mjs';
-/**
- * Filters an `Optional` based on a predicate. If the `Optional` is `Some` and
- * the predicate returns true, returns the original `Optional`. Otherwise
- * returns `None`.
- *
- * @example
- *
- * ```ts
- * const even = Optional.filter(Optional.some(4), (value) => value % 2 === 0);
- *
- * const odd = Optional.filter(Optional.some(3), (value) => value % 2 === 0);
- *
- * assert.deepStrictEqual(even, Optional.some(4));
- *
- * assert.deepStrictEqual(odd, Optional.none);
- *
- * const filterEven = Optional.filter((value: number) => value % 2 === 0);
- *
- * assert.deepStrictEqual(filterEven(Optional.some(6)), Optional.some(6));
- *
- * assert.deepStrictEqual(filterEven(Optional.some(5)), Optional.none);
- * ```
- *
- * @template O The input `UnknownOptional` type.
- * @param optional The `Optional` to filter.
- * @param predicate The predicate function.
- * @returns The filtered `Optional`.
- */
-export declare function filter<O extends UnknownOptional>(optional: O, predicate: (value: Unwrap<O>) => boolean): Optional<Unwrap<O>>;
-export declare function filter<S>(predicate: (value: S) => boolean): (optional: Optional<S>) => Optional<S>;
-//# sourceMappingURL=optional-filter.d.mts.map

package/dist/functional/optional/impl/optional-filter.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-filter.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-filter.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKtE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,eAAe,EAC9C,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,GACvC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAGvB,wBAAgB,MAAM,CAAC,CAAC,EACtB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAC/B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-filter.mjs

@@ -1,25 +0,0 @@
-import { isSome } from './optional-is-some.mjs';
-import { none } from './optional-none.mjs';
-import { some } from './optional-some.mjs';
-import { unwrap } from './optional-unwrap.mjs';
-export function filter(...args) {
-    switch (args.length) {
-        case 2: {
-            const [optional, predicate] = args;
-            return filterImpl(optional, predicate);
-        }
-        case 1: {
-
-            const [predicate] = args;
-            return (optional) => filterImpl(optional, predicate);
-        }
-    }
-}
-const filterImpl = (optional, predicate) => {
-    if (isSome(optional)) {
-        const value = unwrap(optional);
-        return predicate(value) ? some(value) : none;
-    }
-    return none;
-};
-//# sourceMappingURL=optional-filter.mjs.map

package/dist/functional/optional/impl/optional-filter.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-filter.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-filter.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAyC/C,MAAM,UAAU,MAAM,CACpB,GAAG,IAEoD;IAEvD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;YAEnC,OAAO,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,EAAE,CAAC;YACP,wDAAwD;YACxD,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YAEzB,OAAO,CAAC,QAAW,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,QAAW,EACX,SAAwC,EACnB,EAAE;IACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE/B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-flat-map.d.mts

@@ -1,39 +0,0 @@
-import { type Optional, type UnknownOptional } from '../optional.mjs';
-import { type Unwrap } from './types.mjs';
-/**
- * Applies a function that returns an `Optional` to the value in an
- * `Some`. If the input is `None`, returns `None`.
- * This is the monadic bind operation for `Optional`.
- *
- * @example
- *
- * ```ts
- * const parseNumber = (input: string): Optional<number> => {
- *   const num = Num.safeParseInt(input);
- *
- *   return Result.isErr(num) ? Optional.none : Optional.some(num.value);
- * };
- *
- * const parsed = Optional.flatMap(Optional.some('10'), parseNumber);
- *
- * assert.deepStrictEqual(parsed, Optional.some(10));
- *
- * const flatMapParse = Optional.flatMap(parseNumber);
- *
- * assert.deepStrictEqual(flatMapParse(Optional.some('5')), Optional.some(5));
- *
- * assert.deepStrictEqual(
- *   flatMapParse(Optional.some('invalid')),
- *   Optional.none,
- * );
- * ```
- *
- * @template O The input `UnknownOptional` type.
- * @template S2 The value type of the `Optional` returned by the function.
- * @param optional The `Optional` to flat map.
- * @param flatMapFn The function to apply that returns an `Optional`.
- * @returns The result of applying the function, or `None`.
- */
-export declare function flatMap<O extends UnknownOptional, S2>(optional: O, flatMapFn: (value: Unwrap<O>) => Optional<S2>): Optional<S2>;
-export declare function flatMap<S, S2>(flatMapFn: (value: S) => Optional<S2>): (optional: Optional<S>) => Optional<S2>;
-//# sourceMappingURL=optional-flat-map.d.mts.map

package/dist/functional/optional/impl/optional-flat-map.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-flat-map.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-flat-map.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAItE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EACnD,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,GAC5C,QAAQ,CAAC,EAAE,CAAC,CAAC;AAGhB,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAC3B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,GACpC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-flat-map.mjs

@@ -1,18 +0,0 @@
-import { isSome } from './optional-is-some.mjs';
-import { none } from './optional-none.mjs';
-import { unwrap } from './optional-unwrap.mjs';
-export function flatMap(...args) {
-    switch (args.length) {
-        case 2: {
-            const [optional, flatMapFn] = args;
-            return flatMapImpl(optional, flatMapFn);
-        }
-        case 1: {
-
-            const [flatMapFn] = args;
-            return (optional) => flatMapImpl(optional, flatMapFn);
-        }
-    }
-}
-const flatMapImpl = (optional, flatMapFn) => (isSome(optional) ? flatMapFn(unwrap(optional)) : none);
-//# sourceMappingURL=optional-flat-map.mjs.map

package/dist/functional/optional/impl/optional-flat-map.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-flat-map.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-flat-map.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA+C/C,MAAM,UAAU,OAAO,CACrB,GAAG,IAEyD;IAE5D,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;YAEnC,OAAO,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,EAAE,CAAC;YACP,kBAAkB;YAClB,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YAEzB,OAAO,CAAC,QAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAG,CAClB,QAAW,EACX,SAA6C,EAC/B,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-from-nullable.d.mts

@@ -1,27 +0,0 @@
-import { type Optional } from '../optional.mjs';
-/**
- * Converts a nullable value to an `Optional`.
- *
- * This is the primary way to lift nullable values (null or undefined) into
- * the Optional type system. The function treats both `null` and `undefined`
- * as empty values, converting them to `None`.
- *
- * @example
- *
- * ```ts
- * const present = Optional.fromNullable('hello');
- *
- * const absent = Optional.fromNullable<string | null>(null);
- *
- * assert.deepStrictEqual(present, Optional.some('hello'));
- *
- * assert.deepStrictEqual(absent, Optional.none);
- * ```
- *
- * @template T The type of the nullable value.
- * @param value The nullable value to convert.
- * @returns `Some<NonNullable<T>>` if the value is not null or
- *   undefined, otherwise `None`.
- */
-export declare const fromNullable: <T>(value: T | null | undefined) => Optional<NonNullable<T>>;
-//# sourceMappingURL=optional-from-nullable.d.mts.map

package/dist/functional/optional/impl/optional-from-nullable.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-from-nullable.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-from-nullable.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SACrB,CAAC,GAAG,IAAI,GAAG,SAAS,KAC1B,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAyC,CAAC"}

package/dist/functional/optional/impl/optional-from-nullable.mjs

@@ -1,28 +0,0 @@
-import { none } from './optional-none.mjs';
-import { some } from './optional-some.mjs';
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-export const fromNullable = (value) => (value == null ? none : some(value));
-//# sourceMappingURL=optional-from-nullable.mjs.map

package/dist/functional/optional/impl/optional-from-nullable.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-from-nullable.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-from-nullable.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAA2B,EACD,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-is-none.d.mts

@@ -1,23 +0,0 @@
-import { type UnknownOptional } from '../optional.mjs';
-import { type NarrowToNone } from './types.mjs';
-/**
- * Checks if an {@link Optional} is {@link None}. Acts as a type guard.
- *
- * @example
- *
- * ```ts
- * const optionalValue = Optional.none as Optional<number>;
- *
- * if (Optional.isNone(optionalValue)) {
- *   // Type narrowed to None
- *   expectType<typeof optionalValue, None>('=');
- * }
- * ```
- *
- * @template O The {@link UnknownOptional} type to check.
- * @param optional The {@link Optional} to check.
- * @returns `true` if the {@link Optional} is {@link None}, `false`
- *   otherwise.
- */
-export declare const isNone: <O extends UnknownOptional>(optional: O) => optional is NarrowToNone<O>;
-//# sourceMappingURL=optional-is-none.d.mts.map

package/dist/functional/optional/impl/optional-is-none.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-none.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-none.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,eAAe,YACpC,CAAC,KACV,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAuC,CAAC"}

package/dist/functional/optional/impl/optional-is-none.mjs

@@ -1,22 +0,0 @@
-import { NoneTypeTagName } from './tag.mjs';
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-export const isNone = (optional) => optional.$$tag === NoneTypeTagName;
-//# sourceMappingURL=optional-is-none.mjs.map

package/dist/functional/optional/impl/optional-is-none.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-none.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-none.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,QAAW,EACkB,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,eAAe,CAAC"}

package/dist/functional/optional/impl/optional-is-optional.d.mts

@@ -1,21 +0,0 @@
-import { type Optional } from '../optional.mjs';
-/**
- * Checks if the given value is an {@link Optional}.
- *
- * @example
- *
- * ```ts
- * const maybeOptional = Optional.some('value');
- *
- * const notOptional = { $$tag: 'ts-data-forge::Optional.some' } as const;
- *
- * assert.isTrue(Optional.isOptional(maybeOptional));
- *
- * assert.isFalse(Optional.isOptional(notOptional));
- * ```
- *
- * @param maybeOptional The value to check.
- * @returns `true` if the value is an {@link Optional}, otherwise `false`.
- */
-export declare const isOptional: (maybeOptional: unknown) => maybeOptional is Optional<unknown>;
-//# sourceMappingURL=optional-is-optional.d.mts.map

package/dist/functional/optional/impl/optional-is-optional.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-optional.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-optional.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,kBACN,OAAO,KACrB,aAAa,IAAI,QAAQ,CAAC,OAAO,CAKQ,CAAC"}

package/dist/functional/optional/impl/optional-is-optional.mjs

@@ -1,26 +0,0 @@
-import { hasKey, isRecord } from '../../../guard/index.mjs';
-import { NoneTypeTagName, SomeTypeTagName } from './tag.mjs';
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-export const isOptional = (maybeOptional) => isRecord(maybeOptional) &&
-    hasKey(maybeOptional, '$$tag') &&
-    ((maybeOptional.$$tag === SomeTypeTagName &&
-        hasKey(maybeOptional, 'value')) ||
-        maybeOptional.$$tag === NoneTypeTagName);
-//# sourceMappingURL=optional-is-optional.mjs.map

package/dist/functional/optional/impl/optional-is-optional.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-optional.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-optional.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,aAAsB,EACc,EAAE,CACtC,QAAQ,CAAC,aAAa,CAAC;IACvB,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC;IAC9B,CAAC,CAAC,aAAa,CAAC,KAAK,KAAK,eAAe;QACvC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC/B,aAAa,CAAC,KAAK,KAAK,eAAe,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-is-some.d.mts

@@ -1,24 +0,0 @@
-import { type UnknownOptional } from '../optional.mjs';
-import { type NarrowToSome } from './types.mjs';
-/**
- * Checks if an {@link Optional} is {@link Some}. Acts as a type guard.
- *
- * @example
- *
- * ```ts
- * const optionalNumber = Optional.some(42);
- *
- * if (Optional.isSome(optionalNumber)) {
- *   const value: number = optionalNumber.value;
- *
- *   assert.isTrue(value === 42);
- * }
- * ```
- *
- * @template O The {@link UnknownOptional} type to check.
- * @param optional The {@link Optional} to check.
- * @returns `true` if the {@link Optional} is {@link Some}, `false`
- *   otherwise.
- */
-export declare const isSome: <O extends UnknownOptional>(optional: O) => optional is NarrowToSome<O>;
-//# sourceMappingURL=optional-is-some.d.mts.map

package/dist/functional/optional/impl/optional-is-some.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-some.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-some.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,eAAe,YACpC,CAAC,KACV,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAuC,CAAC"}

package/dist/functional/optional/impl/optional-is-some.mjs

@@ -1,23 +0,0 @@
-import { SomeTypeTagName } from './tag.mjs';
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-export const isSome = (optional) => optional.$$tag === SomeTypeTagName;
-//# sourceMappingURL=optional-is-some.mjs.map

package/dist/functional/optional/impl/optional-is-some.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-is-some.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-some.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,QAAW,EACkB,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,eAAe,CAAC"}

package/dist/functional/optional/impl/optional-map.d.mts

@@ -1,34 +0,0 @@
-import { type Optional, type UnknownOptional } from '../optional.mjs';
-import { type Unwrap } from './types.mjs';
-/**
- * Maps an {@link Optional}<S> to {@link Optional}<S2> by applying a function to
- * a contained value. If the {@link Optional} is {@link None}, it
- * returns {@link Optional.none}. Otherwise, it applies the `mapFn` to the
- * value in `Some` and returns a new `Some` with the result.
- *
- * @example
- *
- * ```ts
- * const numberOptional = Optional.some(21);
- *
- * const mapped = Optional.map(numberOptional, (value) => value * 2);
- *
- * assert.deepStrictEqual(mapped, Optional.some(42));
- *
- * const mapToLength = Optional.map((text: string) => text.length);
- *
- * assert.deepStrictEqual(mapToLength(Optional.some('abc')), Optional.some(3));
- *
- * assert.deepStrictEqual(mapToLength(Optional.none), Optional.none);
- * ```
- *
- * @template O The input `UnknownOptional` type.
- * @template S2 The type of the value returned by the mapping function.
- * @param optional The `Optional` to map.
- * @param mapFn The function to apply to the value if it exists.
- * @returns A new `Optional<S2>` resulting from the mapping, or
- *   `None` if the input was `None`.
- */
-export declare function map<O extends UnknownOptional, S2>(optional: O, mapFn: (value: Unwrap<O>) => S2): Optional<S2>;
-export declare function map<S, S2>(mapFn: (value: S) => S2): <O extends UnknownOptional>(optional: Unwrap<O> extends S ? O : never) => Optional<S2>;
-//# sourceMappingURL=optional-map.d.mts.map

package/dist/functional/optional/impl/optional-map.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-map.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-map.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKtE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAC/C,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,GAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC;AAgBhB,wBAAgB,GAAG,CAAC,CAAC,EAAE,EAAE,EACvB,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,GACtB,CAAC,CAAC,SAAS,eAAe,EAC3B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,KACtC,QAAQ,CAAC,EAAE,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-map.mjs

@@ -1,22 +0,0 @@
-import { isSome } from './optional-is-some.mjs';
-import { none } from './optional-none.mjs';
-import { some } from './optional-some.mjs';
-import { unwrap } from './optional-unwrap.mjs';
-export function map(...args) {
-    switch (args.length) {
-        case 2: {
-            const [optional, mapFn] = args;
-            return mapImpl(optional, mapFn);
-        }
-        case 1: {
-
-            const [mapFn] = args;
-            return (optional) => mapImpl(optional, mapFn);
-        }
-    }
-}
-const mapImpl = (optional, mapFn) => isSome(optional)
-    ?
-        some(mapFn(unwrap(optional)))
-    : none;
-//# sourceMappingURL=optional-map.mjs.map

package/dist/functional/optional/impl/optional-map.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-map.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-map.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAyD/C,MAAM,UAAU,GAAG,CACjB,GAAG,IAE2C;IAE9C,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;YAE/B,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,EAAE,CAAC;YACP,sDAAsD;YACtD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAErB,OAAO,CAAC,QAAW,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,CACd,QAAW,EACX,KAA+B,EACjB,EAAE,CAChB,MAAM,CAAC,QAAQ,CAAC;IACd,CAAC,CAAC,oEAAoE;QACpE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAE,CAAC,CAAC;IAChC,CAAC,CAAC,IAAI,CAAC"}

package/dist/functional/optional/impl/optional-match.d.mts

@@ -1,48 +0,0 @@
-import { type UnknownOptional } from '../optional.mjs';
-import { type Unwrap } from './types.mjs';
-/**
- * Folds an {@link Optional} into a plain value by applying one of two case
- * handlers: `some` if the {@link Optional} contains a value, `none`
- * otherwise. This is the function form of pattern matching on an
- * {@link Optional}.
- *
- * Unlike {@link Optional.map}, the result is not wrapped in an
- * {@link Optional} — both branches produce the final value directly.
- *
- * @example
- *
- * ```ts
- * const doubledOrZero = Optional.match(Optional.some(21), {
- *   some: (value) => value * 2,
- *   none: () => 0,
- * });
- *
- * assert.deepStrictEqual(doubledOrZero, 42);
- *
- * const matcher = Optional.match({
- *   some: (value: number) => `value: ${value}`,
- *   none: () => 'none',
- * });
- *
- * assert.deepStrictEqual(matcher(Optional.some(3)), 'value: 3');
- *
- * assert.deepStrictEqual(matcher(Optional.none), 'none');
- * ```
- *
- * @template O The input `UnknownOptional` type.
- * @template S2 The type returned by the `some` case.
- * @template N2 The type returned by the `none` case.
- * @param optional The `Optional` to match on.
- * @param cases An object with a `some` handler receiving the contained value
- *   and a `none` handler receiving nothing.
- * @returns The value produced by whichever case handler was applied.
- */
-export declare function match<O extends UnknownOptional, S2, N2>(optional: O, cases: Readonly<{
-    some: (value: Unwrap<O>) => S2;
-    none: () => N2;
-}>): N2 | S2;
-export declare function match<S, S2, N2>(cases: Readonly<{
-    some: (value: S) => S2;
-    none: () => N2;
-}>): <O extends UnknownOptional>(optional: Unwrap<O> extends S ? O : never) => N2 | S2;
-//# sourceMappingURL=optional-match.d.mts.map

package/dist/functional/optional/impl/optional-match.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-match.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-match.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,EACrD,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,QAAQ,CAAC;IACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC,GACD,EAAE,GAAG,EAAE,CAAC;AAQX,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAC7B,KAAK,EAAE,QAAQ,CAAC;IACd,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC,GACD,CAAC,CAAC,SAAS,eAAe,EAC3B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,KACtC,EAAE,GAAG,EAAE,CAAC"}

package/dist/functional/optional/impl/optional-match.mjs

@@ -1,20 +0,0 @@
-import { isSome } from './optional-is-some.mjs';
-import { unwrap } from './optional-unwrap.mjs';
-export function match(...args) {
-    switch (args.length) {
-        case 2: {
-            const [optional, cases] = args;
-            return matchImpl(optional, cases);
-        }
-        case 1: {
-
-            const [cases] = args;
-            return (optional) => matchImpl(optional, cases);
-        }
-    }
-}
-const matchImpl = (optional, cases) => isSome(optional)
-    ?
-        cases.some(unwrap(optional))
-    : cases.none();
-//# sourceMappingURL=optional-match.mjs.map

package/dist/functional/optional/impl/optional-match.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"optional-match.mjs","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-match.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA+D/C,MAAM,UAAU,KAAK,CACnB,GAAG,IAaE;IAEL,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;YAE/B,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,EAAE,CAAC;YACP,0DAA0D;YAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAErB,OAAO,CAAC,QAAW,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG,CAChB,QAAW,EACX,KAGE,EACO,EAAE,CACX,MAAM,CAAC,QAAQ,CAAC;IACd,CAAC,CAAC,oEAAoE;QACpE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAE,CAAC;IAC/B,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC"}