ts-data-forge 4.0.0 → 4.1.0

package/dist/entry-point.mjs

@@ -6,6 +6,8 @@ export { index$1 as Optional };
 export { pipe } from './functional/pipe.mjs';
 import * as index$2 from './functional/result/impl/index.mjs';
 export { index$2 as Result };
+import * as index$3 from './functional/ternary-result/impl/index.mjs';
+export { index$3 as TernaryResult };
 export { IMapMapped } from './collections/imap-mapped.mjs';
 export { IMap } from './collections/imap.mjs';
 export { ISetMapped } from './collections/iset-mapped.mjs';

package/dist/entry-point.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/functional/index.d.mts

@@ -2,4 +2,5 @@ export * from './match.mjs';
 export * from './optional/index.mjs';
 export * from './pipe.mjs';
 export * from './result/index.mjs';
+export * from './ternary-result/index.mjs';
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/functional/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/functional/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/functional/index.mjs

@@ -4,4 +4,6 @@ export { index as Optional };
 export { pipe } from './pipe.mjs';
 import * as index$1 from './result/impl/index.mjs';
 export { index$1 as Result };
+import * as index$2 from './ternary-result/impl/index.mjs';
+export { index$2 as TernaryResult };
 //# sourceMappingURL=index.mjs.map

package/dist/functional/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/dist/functional/ternary-result/impl/index.d.mts

@@ -0,0 +1,29 @@
+export * from './ternary-result-err.mjs';
+export * from './ternary-result-expect-to-be.mjs';
+export * from './ternary-result-flat-map.mjs';
+export * from './ternary-result-fold.mjs';
+export * from './ternary-result-from-promise.mjs';
+export * from './ternary-result-from-throwable.mjs';
+export * from './ternary-result-is-err.mjs';
+export * from './ternary-result-is-ok.mjs';
+export * from './ternary-result-is-ternary-result.mjs';
+export * from './ternary-result-is-warn.mjs';
+export * from './ternary-result-map-err.mjs';
+export * from './ternary-result-map-warn.mjs';
+export * from './ternary-result-map.mjs';
+export * from './ternary-result-ok.mjs';
+export * from './ternary-result-or-else.mjs';
+export * from './ternary-result-to-optional.mjs';
+export * from './ternary-result-unwrap-err-or.mjs';
+export * from './ternary-result-unwrap-err-throw.mjs';
+export * from './ternary-result-unwrap-err.mjs';
+export * from './ternary-result-unwrap-ok-or.mjs';
+export * from './ternary-result-unwrap-ok.mjs';
+export * from './ternary-result-unwrap-throw.mjs';
+export * from './ternary-result-unwrap-warn-or.mjs';
+export * from './ternary-result-unwrap-warn-throw.mjs';
+export * from './ternary-result-unwrap-warn.mjs';
+export * from './ternary-result-warn.mjs';
+export * from './ternary-result-zip.mjs';
+export * from './types.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/functional/ternary-result/impl/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/index.mts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}

package/dist/functional/ternary-result/impl/index.mjs

@@ -0,0 +1,28 @@
+export { err } from './ternary-result-err.mjs';
+export { expectToBe } from './ternary-result-expect-to-be.mjs';
+export { flatMap } from './ternary-result-flat-map.mjs';
+export { fold } from './ternary-result-fold.mjs';
+export { fromPromise } from './ternary-result-from-promise.mjs';
+export { fromThrowable } from './ternary-result-from-throwable.mjs';
+export { isErr } from './ternary-result-is-err.mjs';
+export { isOk } from './ternary-result-is-ok.mjs';
+export { isTernaryResult } from './ternary-result-is-ternary-result.mjs';
+export { isWarn } from './ternary-result-is-warn.mjs';
+export { mapErr } from './ternary-result-map-err.mjs';
+export { mapWarn } from './ternary-result-map-warn.mjs';
+export { map } from './ternary-result-map.mjs';
+export { ok } from './ternary-result-ok.mjs';
+export { orElse } from './ternary-result-or-else.mjs';
+export { toOptional } from './ternary-result-to-optional.mjs';
+export { unwrapErrOr } from './ternary-result-unwrap-err-or.mjs';
+export { unwrapErrThrow } from './ternary-result-unwrap-err-throw.mjs';
+export { unwrapErr } from './ternary-result-unwrap-err.mjs';
+export { unwrapOkOr } from './ternary-result-unwrap-ok-or.mjs';
+export { unwrapOk } from './ternary-result-unwrap-ok.mjs';
+export { unwrapThrow } from './ternary-result-unwrap-throw.mjs';
+export { unwrapWarnOr } from './ternary-result-unwrap-warn-or.mjs';
+export { unwrapWarnThrow } from './ternary-result-unwrap-warn-throw.mjs';
+export { unwrapWarn } from './ternary-result-unwrap-warn.mjs';
+export { warn } from './ternary-result-warn.mjs';
+export { zip } from './ternary-result-zip.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/functional/ternary-result/impl/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/functional/ternary-result/impl/tag.d.mts

@@ -0,0 +1,7 @@
+/** @internal Tag identifying the Ok variant. */
+export declare const OkTypeTagName: TernaryOk<unknown>['$$tag'];
+/** @internal Tag identifying the Warn variant. */
+export declare const WarnTypeTagName: TernaryWarn<unknown, unknown>['$$tag'];
+/** @internal Tag identifying the Err variant. */
+export declare const ErrTypeTagName: TernaryErr<unknown>['$$tag'];
+//# sourceMappingURL=tag.d.mts.map

package/dist/functional/ternary-result/impl/tag.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/tag.mts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAC1B,CAAC;AAE7B,kDAAkD;AAClD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CACrC,CAAC;AAE/B,iDAAiD;AACjD,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAC3B,CAAC"}

package/dist/functional/ternary-result/impl/tag.mjs

@@ -0,0 +1,9 @@
+/** @internal Tag identifying the Ok variant. */
+const OkTypeTagName = 'ts-data-forge::Result.ok';
+/** @internal Tag identifying the Warn variant. */
+const WarnTypeTagName = 'ts-data-forge::Result.warn';
+/** @internal Tag identifying the Err variant. */
+const ErrTypeTagName = 'ts-data-forge::Result.err';
+
+export { ErrTypeTagName, OkTypeTagName, WarnTypeTagName };
+//# sourceMappingURL=tag.mjs.map

package/dist/functional/ternary-result/impl/tag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.mjs","sources":["../../../../src/functional/ternary-result/impl/tag.mts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACO,MAAM,aAAa,GACxB;AAEF;AACO,MAAM,eAAe,GAC1B;AAEF;AACO,MAAM,cAAc,GACzB;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-err.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Creates a `TernaryResult.Err` containing the provided error value.
+ *
+ * @example
+ *
+ * ```ts
+ * const failure = TernaryResult.err(new Error('missing data'));
+ *
+ * assert.strictEqual(failure.$$tag, 'ts-data-forge::Result.err');
+ * assert.ok(TernaryResult.isErr(failure));
+ * ```
+ */
+export declare const err: <E>(value: E) => TernaryErr<E>;
+//# sourceMappingURL=ternary-result-err.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-err.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-err.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-err.mts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,EAAG,OAAO,CAAC,KAAG,UAAU,CAAC,CAAC,CAG7C,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-err.mjs

@@ -0,0 +1,21 @@
+import { ErrTypeTagName } from './tag.mjs';
+
+/**
+ * Creates a `TernaryResult.Err` containing the provided error value.
+ *
+ * @example
+ *
+ * ```ts
+ * const failure = TernaryResult.err(new Error('missing data'));
+ *
+ * assert.strictEqual(failure.$$tag, 'ts-data-forge::Result.err');
+ * assert.ok(TernaryResult.isErr(failure));
+ * ```
+ */
+const err = (value) => ({
+    $$tag: ErrTypeTagName,
+    value,
+});
+
+export { err };
+//# sourceMappingURL=ternary-result-err.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-err.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-err.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-err.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;;AAWG;MACU,GAAG,GAAG,CAAK,KAAQ,MAAqB;AACnD,IAAA,KAAK,EAAE,cAAc;IACrB,KAAK;AACN,CAAA;;;;"}

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

@@ -0,0 +1,18 @@
+import { type UnwrapOk } from './types.mjs';
+/**
+ * Unwraps the Ok value or throws with the provided message.
+ *
+ * @example
+ *
+ * ```ts
+ * const okValue = TernaryResult.ok('ready');
+ *
+ * assert.strictEqual(TernaryResult.expectToBe(okValue, 'missing'), 'ready');
+ * const expectResult = TernaryResult.expectToBe<string>('needs value');
+ *
+ * assert.throws(() => expectResult(TernaryResult.err('oops')), /needs value/u);
+ * ```
+ */
+export declare function expectToBe<R extends UnknownTernaryResult>(result: R, message: string): UnwrapOk<R>;
+export declare function expectToBe<S>(message: string): <W, E>(result: TernaryResult<S, E, W>) => S;
+//# sourceMappingURL=ternary-result-expect-to-be.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,oBAAoB,EACvD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CAAC;AAGf,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.mjs

@@ -0,0 +1,24 @@
+import { isOk } from './ternary-result-is-ok.mjs';
+import { unwrapOk } from './ternary-result-unwrap-ok.mjs';
+
+function expectToBe(...args) {
+    switch (args.length) {
+        case 2: {
+            const [result, message] = args;
+            return expectImpl(result, message);
+        }
+        case 1: {
+            const [message] = args;
+            return (result) => expectImpl(result, message);
+        }
+    }
+}
+const expectImpl = (result, message) => {
+    if (isOk(result)) {
+        return unwrapOk(result);
+    }
+    throw new Error(message);
+};
+
+export { expectToBe };
+//# sourceMappingURL=ternary-result-expect-to-be.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-expect-to-be.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AA4BM,SAAU,UAAU,CACxB,GAAG,IAAwE,EAAA;AAE3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;AAC9B,YAAA,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACpC;QACA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YACtB,OAAO,CAAC,MAAS,KAAK,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACnD;;AAEJ;AAEA,MAAM,UAAU,GAAG,CACjB,MAAS,EACT,OAAe,KACA;AACf,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;AAChB,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-flat-map.d.mts

@@ -0,0 +1,29 @@
+import { type UnwrapErr, type UnwrapOk, type UnwrapWarn } from './types.mjs';
+/**
+ * Applies a function returning a `TernaryResult` to the Ok variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const parse = (value: string): TernaryResult<number, string, string> =>
+ *   Number.isNaN(Number(value))
+ *     ? TernaryResult.err('NaN')
+ *     : TernaryResult.ok(Number(value));
+ *
+ * const doubled = TernaryResult.flatMap(TernaryResult.ok('3'), (text) =>
+ *   TernaryResult.map(parse(text), (num) => num * 2),
+ * );
+ * const warnPassthrough = TernaryResult.flatMap(
+ *   TernaryResult.warn('3', 'retry'),
+ *   parse,
+ * );
+ * const errPassthrough = TernaryResult.flatMap(TernaryResult.err('oops'), parse);
+ *
+ * assert.deepStrictEqual(doubled, TernaryResult.ok(6));
+ * assert.deepStrictEqual(warnPassthrough, TernaryResult.warn(3, 'retry'));
+ * assert.deepStrictEqual(errPassthrough, TernaryResult.err('oops'));
+ * ```
+ */
+export declare function flatMap<R extends UnknownTernaryResult, S2, W2, E2>(result: R, flatMapFn: (value: UnwrapOk<R>) => TernaryResult<S2, E2, W2>): TernaryResult<S2, E2 | UnwrapErr<R>, W2 | UnwrapWarn<R>>;
+export declare function flatMap<S, S2, W2, E2>(flatMapFn: (value: S) => TernaryResult<S2, E2, W2>): <W, E>(result: TernaryResult<S, E, W>) => TernaryResult<S2, E | E2, W | W2>;
+//# sourceMappingURL=ternary-result-flat-map.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-flat-map.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-flat-map.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-flat-map.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,oBAAoB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAChE,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAC3D,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAG5D,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EACnC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GACjD,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-flat-map.mjs

@@ -0,0 +1,41 @@
+import { isOk } from './ternary-result-is-ok.mjs';
+import { isWarn } from './ternary-result-is-warn.mjs';
+import { warn } from './ternary-result-warn.mjs';
+
+function flatMap(...args) {
+    switch (args.length) {
+        case 2: {
+            const [result, flatMapFn] = args;
+            return flatMapImpl(result, flatMapFn);
+        }
+        case 1: {
+            const [flatMapFn] = args;
+            return (result) => flatMapImpl(result, flatMapFn);
+        }
+    }
+}
+const flatMapImpl = (result, flatMapFn) => {
+    if (isOk(result)) {
+        // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+        return flatMapFn(result.value);
+    }
+    if (isWarn(result)) {
+        const next = flatMapFn(
+        // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+        result.value);
+        if (isOk(next)) {
+            return warn(next.value, 
+            // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+            result.warning);
+        }
+        if (isWarn(next)) {
+            return warn(next.value, next.warning);
+        }
+        return next;
+    }
+    // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+    return result;
+};
+
+export { flatMap };
+//# sourceMappingURL=ternary-result-flat-map.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-flat-map.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-flat-map.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-flat-map.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAwCM,SAAU,OAAO,CACrB,GAAG,IAKwE,EAAA;AAI3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;AAChC,YAAA,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;QACvC;QACA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;YACxB,OAAO,CAAC,MAAS,KAAK,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;QACtD;;AAEJ;AAEA,MAAM,WAAW,GAAG,CAClB,MAAS,EACT,SAA4D,KACA;AAC5D,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;;AAEhB,QAAA,OAAO,SAAS,CAAC,MAAM,CAAC,KAAoB,CAAC;IAC/C;AAEA,IAAA,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,IAAI,GAAG,SAAS;;QAEpB,MAAM,CAAC,KAAoB,CAC5B;AAED,QAAA,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE;AACd,YAAA,OAAO,IAAI,CACT,IAAI,CAAC,KAAK;;YAEV,MAAM,CAAC,OAAwB,CAChC;QACH;AAEA,QAAA,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE;YAChB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAoC,CAAC;QACpE;AAEA,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,OAAO,MAAuC;AAChD,CAAC;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-fold.d.mts

@@ -0,0 +1,27 @@
+import { type UnwrapErr, type UnwrapOk, type UnwrapWarn } from './types.mjs';
+/**
+ * Applies the provided mapper based on the current variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const okFold = TernaryResult.fold(
+ *   TernaryResult.ok(2),
+ *   (value) => value * 2,
+ *   (warn: string) => warn.length,
+ *   (error: string) => error.toUpperCase(),
+ * );
+ * const warnFold = TernaryResult.fold(
+ *   TernaryResult.warn(2, 'spike'),
+ *   (value: number) => value,
+ *   (warn: string) => warn.toUpperCase(),
+ *   (error: string) => error,
+ * );
+ *
+ * assert.deepStrictEqual(okFold, TernaryResult.ok(4));
+ * assert.deepStrictEqual(warnFold, TernaryResult.warn(2, 'SPIKE'));
+ * ```
+ */
+export declare function fold<R extends UnknownTernaryResult, S2, W2, E2>(result: R, mapOk: (value: UnwrapOk<R>) => S2, mapWarn: (value: UnwrapWarn<R>) => W2, mapErr: (error: UnwrapErr<R>) => E2): TernaryResult<S2, E2, W2>;
+export declare function fold<S, W, E, S2, W2, E2>(mapOk: (value: S) => S2, mapWarn: (value: W) => W2, mapErr: (error: E) => E2): (result: TernaryResult<S, E, W>) => TernaryResult<S2, E2, W2>;
+//# sourceMappingURL=ternary-result-fold.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-fold.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-fold.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-fold.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,oBAAoB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAC7D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EACjC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,EACrC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,GAClC,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAG7B,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EACtC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EACvB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EACzB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,GACvB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-fold.mjs

@@ -0,0 +1,36 @@
+import { err } from './ternary-result-err.mjs';
+import { isOk } from './ternary-result-is-ok.mjs';
+import { isWarn } from './ternary-result-is-warn.mjs';
+import { ok } from './ternary-result-ok.mjs';
+import { warn } from './ternary-result-warn.mjs';
+
+function fold(...args) {
+    switch (args.length) {
+        case 4: {
+            const [result, mapOk, mapWarn, mapErr] = args;
+            return foldImpl(result, mapOk, mapWarn, mapErr);
+        }
+        case 3: {
+            const [mapOk, mapWarn, mapErr] = args;
+            return (result) => foldImpl(result, mapOk, mapWarn, mapErr);
+        }
+    }
+}
+const foldImpl = (result, mapOk, mapWarnFn, mapErrFn) => {
+    if (isOk(result)) {
+        // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+        return ok(mapOk(result.value));
+    }
+    if (isWarn(result)) {
+        return warn(
+        // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+        mapOk(result.value), 
+        // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+        mapWarnFn(result.warning));
+    }
+    // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+    return err(mapErrFn(result.value));
+};
+
+export { fold };
+//# sourceMappingURL=ternary-result-fold.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-fold.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-fold.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-fold.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AA4CM,SAAU,IAAI,CAClB,GAAG,IAWE,EAAA;AAEL,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;YAC7C,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;QACjD;QACA,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;AACrC,YAAA,OAAO,CAAC,MAAS,KAAK,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;QAChE;;AAEJ;AAEA,MAAM,QAAQ,GAAG,CACf,MAAS,EACT,KAAiC,EACjC,SAAyC,EACzC,QAAqC,KACR;AAC7B,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;;QAEhB,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAoB,CAAC,CAAC;IAC/C;AAEA,IAAA,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE;AAClB,QAAA,OAAO,IAAI;;AAET,QAAA,KAAK,CAAC,MAAM,CAAC,KAAoB,CAAC;;AAElC,QAAA,SAAS,CAAC,MAAM,CAAC,OAAwB,CAAC,CAC3C;IACH;;IAGA,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAqB,CAAC,CAAC;AACpD,CAAC;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-from-promise.d.mts

@@ -0,0 +1,20 @@
+/** @internal Utility type extracting the resolved value from a Promise. */
+type UnwrapPromise<P extends Promise<unknown>> = P extends Promise<infer V> ? V : never;
+/**
+ * Converts a Promise into a Promise that resolves to a `TernaryResult`.
+ *
+ * @example
+ *
+ * ```ts
+ * const resolved = await TernaryResult.fromPromise(Promise.resolve('ok'));
+ * const rejected = await TernaryResult.fromPromise(
+ *   Promise.reject(new Error('fail')),
+ * );
+ *
+ * assert.deepStrictEqual(resolved, TernaryResult.ok('ok'));
+ * assert.ok(TernaryResult.isErr(rejected));
+ * ```
+ */
+export declare const fromPromise: <P extends Promise<unknown>>(promise: P) => Promise<TernaryResult<UnwrapPromise<P>, unknown, never>>;
+export {};
+//# sourceMappingURL=ternary-result-from-promise.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-from-promise.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-from-promise.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-from-promise.mts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,KAAK,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,IAC3C,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EACpD,SAAS,CAAC,KACT,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAEoB,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-from-promise.mjs

@@ -0,0 +1,24 @@
+import { err } from './ternary-result-err.mjs';
+import { ok } from './ternary-result-ok.mjs';
+
+/**
+ * Converts a Promise into a Promise that resolves to a `TernaryResult`.
+ *
+ * @example
+ *
+ * ```ts
+ * const resolved = await TernaryResult.fromPromise(Promise.resolve('ok'));
+ * const rejected = await TernaryResult.fromPromise(
+ *   Promise.reject(new Error('fail')),
+ * );
+ *
+ * assert.deepStrictEqual(resolved, TernaryResult.ok('ok'));
+ * assert.ok(TernaryResult.isErr(rejected));
+ * ```
+ */
+const fromPromise = (promise) => 
+// eslint-disable-next-line total-functions/no-unsafe-type-assertion
+promise.then((value) => ok(value)).catch(err);
+
+export { fromPromise };
+//# sourceMappingURL=ternary-result-from-promise.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-from-promise.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-from-promise.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-from-promise.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;AAcG;AACI,MAAM,WAAW,GAAG,CACzB,OAAU;AAEV;AACA,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,CAAgC,CAAC,CAAC,KAAK,CAAC,GAAG;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-from-throwable.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Wraps a potentially-throwing function in a `TernaryResult`.
+ *
+ * @example
+ *
+ * ```ts
+ * const success = TernaryResult.fromThrowable(() => 1 + 1);
+ * const failure = TernaryResult.fromThrowable(() => {
+ *   throw new Error('boom');
+ * });
+ *
+ * assert.deepStrictEqual(success, TernaryResult.ok(2));
+ * assert.ok(TernaryResult.isErr(failure));
+ * ```
+ */
+export declare const fromThrowable: <T>(fn: () => T) => TernaryResult<T, Error, never>;
+//# sourceMappingURL=ternary-result-from-throwable.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-from-throwable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-from-throwable.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-from-throwable.mts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,IAAI,MAAM,CAAC,KACV,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAS/B,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-from-throwable.mjs

@@ -0,0 +1,33 @@
+import { unknownToString } from '../../../others/unknown-to-string.mjs';
+import { err } from './ternary-result-err.mjs';
+import { ok } from './ternary-result-ok.mjs';
+
+/**
+ * Wraps a potentially-throwing function in a `TernaryResult`.
+ *
+ * @example
+ *
+ * ```ts
+ * const success = TernaryResult.fromThrowable(() => 1 + 1);
+ * const failure = TernaryResult.fromThrowable(() => {
+ *   throw new Error('boom');
+ * });
+ *
+ * assert.deepStrictEqual(success, TernaryResult.ok(2));
+ * assert.ok(TernaryResult.isErr(failure));
+ * ```
+ */
+const fromThrowable = (fn) => {
+    try {
+        return ok(fn());
+    }
+    catch (error) {
+        if (Error.isError(error)) {
+            return err(error);
+        }
+        return err(new Error(unknownToString(error)));
+    }
+};
+
+export { fromThrowable };
+//# sourceMappingURL=ternary-result-from-throwable.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-from-throwable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-from-throwable.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-from-throwable.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;AAcG;AACI,MAAM,aAAa,GAAG,CAC3B,EAAW,KACuB;AAClC,IAAA,IAAI;AACF,QAAA,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;IACjB;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,YAAA,OAAO,GAAG,CAAC,KAAK,CAAC;QACnB;QACA,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C;AACF;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-is-err.d.mts

@@ -0,0 +1,20 @@
+import { type NarrowToErr } from './types.mjs';
+/**
+ * Type guard for the Err variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeErr = TernaryResult.err('boom') as TernaryResult<
+ *   number,
+ *   string,
+ *   string
+ * >;
+ *
+ * if (TernaryResult.isErr(maybeErr)) {
+ *   assert.strictEqual(maybeErr.value, 'boom');
+ * }
+ * ```
+ */
+export declare const isErr: <R extends UnknownTernaryResult>(result: R) => result is NarrowToErr<R>;
+//# sourceMappingURL=ternary-result-is-err.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-is-err.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-is-err.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-is-err.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,oBAAoB,EAClD,QAAQ,CAAC,KACR,MAAM,IAAI,WAAW,CAAC,CAAC,CAAoC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-is-err.mjs

@@ -0,0 +1,23 @@
+import { ErrTypeTagName } from './tag.mjs';
+
+/**
+ * Type guard for the Err variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeErr = TernaryResult.err('boom') as TernaryResult<
+ *   number,
+ *   string,
+ *   string
+ * >;
+ *
+ * if (TernaryResult.isErr(maybeErr)) {
+ *   assert.strictEqual(maybeErr.value, 'boom');
+ * }
+ * ```
+ */
+const isErr = (result) => result.$$tag === ErrTypeTagName;
+
+export { isErr };
+//# sourceMappingURL=ternary-result-is-err.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-is-err.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-is-err.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-is-err.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,KAAK,GAAG,CACnB,MAAS,KACoB,MAAM,CAAC,KAAK,KAAK;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-is-ok.d.mts

@@ -0,0 +1,21 @@
+import { type NarrowToOk } from './types.mjs';
+/**
+ * Type guard for the Ok variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeNumber = TernaryResult.ok(42) as TernaryResult<
+ *   number,
+ *   string,
+ *   string
+ * >;
+ *
+ * if (TernaryResult.isOk(maybeNumber)) {
+ *   const value: number = maybeNumber.value;
+ *   assert.strictEqual(value, 42);
+ * }
+ * ```
+ */
+export declare const isOk: <R extends UnknownTernaryResult>(result: R) => result is NarrowToOk<R>;
+//# sourceMappingURL=ternary-result-is-ok.d.mts.map

package/dist/functional/ternary-result/impl/ternary-result-is-ok.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-is-ok.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-is-ok.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,oBAAoB,EACjD,QAAQ,CAAC,KACR,MAAM,IAAI,UAAU,CAAC,CAAC,CAAmC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-is-ok.mjs

@@ -0,0 +1,24 @@
+import { OkTypeTagName } from './tag.mjs';
+
+/**
+ * Type guard for the Ok variant.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeNumber = TernaryResult.ok(42) as TernaryResult<
+ *   number,
+ *   string,
+ *   string
+ * >;
+ *
+ * if (TernaryResult.isOk(maybeNumber)) {
+ *   const value: number = maybeNumber.value;
+ *   assert.strictEqual(value, 42);
+ * }
+ * ```
+ */
+const isOk = (result) => result.$$tag === OkTypeTagName;
+
+export { isOk };
+//# sourceMappingURL=ternary-result-is-ok.mjs.map

package/dist/functional/ternary-result/impl/ternary-result-is-ok.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-result-is-ok.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-is-ok.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;AAiBG;AACI,MAAM,IAAI,GAAG,CAClB,MAAS,KACmB,MAAM,CAAC,KAAK,KAAK;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-is-ternary-result.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Checks whether the provided value is a {@link TernaryResult}.
+ *
+ * @example
+ *
+ * ```ts
+ * const okValue = TernaryResult.ok('done');
+ * const warnValue = TernaryResult.warn('done', 'retry later');
+ * const notResult = { $$tag: 'ts-data-forge::Result.ok' };
+ *
+ * assert.ok(TernaryResult.isTernaryResult(okValue));
+ * assert.ok(TernaryResult.isTernaryResult(warnValue));
+ * assert.ok(!TernaryResult.isTernaryResult(notResult));
+ * ```
+ */
+export declare const isTernaryResult: (maybeResult: unknown) => maybeResult is UnknownTernaryResult;
+//# sourceMappingURL=ternary-result-is-ternary-result.d.mts.map