ts-data-forge 3.3.1 → 4.1.0

package/dist/collections/queue.mjs

@@ -1,5 +1,5 @@
-import { Optional } from '../functional/optional.mjs';
-import '../functional/result.mjs';
+import { none } from '../functional/optional/impl/optional-none.mjs';
+import { some } from '../functional/optional/impl/optional-some.mjs';
 import { range } from '../iterator/range.mjs';
 import '../number/branded-types/finite-number.mjs';
 import '../number/branded-types/int.mjs';
@@ -99,14 +99,14 @@ class QueueClass {
      */
     dequeue() {
         if (this.isEmpty) {
-            return Optional.none;
+            return none;
         }
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         const element = this.#buffer[this.#head];
         this.#buffer[this.#head] = undefined; // Clear reference for garbage collection
         this.#head = (this.#head + 1) % this.#capacity;
         this.#mut_size -= 1;
-        return Optional.some(element);
+        return some(element);
     }
     /**
      * Adds an element to the back of the queue (FIFO).

package/dist/collections/queue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queue.mjs","sources":["../../src/collections/queue.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"queue.mjs","sources":["../../src/collections/queue.mts"],"sourcesContent":[null],"names":["Optional.none","Optional.some"],"mappings":"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"}

package/dist/collections/stack.d.mts

@@ -1,4 +1,3 @@
-import { Optional } from '../functional/index.mjs';
 /**
  * Interface for a high-performance stack with LIFO (Last-In, First-Out)
  * behavior.

package/dist/collections/stack.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"stack.d.mts","sourceRoot":"","sources":["../../src/collections/stack.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAInD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,GAAG,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC1B,CAAC,CAAC;AAwIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAG,gBAAgB,SAAS,CAAC,EAAE,KAAG,KAAK,CAAC,CAAC,CACpC,CAAC"}
+{"version":3,"file":"stack.d.mts","sourceRoot":"","sources":["../../src/collections/stack.mts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,GAAG,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC1B,CAAC,CAAC;AAwIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAG,gBAAgB,SAAS,CAAC,EAAE,KAAG,KAAK,CAAC,CAAC,CACpC,CAAC"}

package/dist/collections/stack.mjs

@@ -1,5 +1,5 @@
-import { Optional } from '../functional/optional.mjs';
-import '../functional/result.mjs';
+import { none } from '../functional/optional/impl/optional-none.mjs';
+import { some } from '../functional/optional/impl/optional-some.mjs';
 import { range } from '../iterator/range.mjs';
 import '../number/branded-types/finite-number.mjs';
 import '../number/branded-types/int.mjs';
@@ -92,13 +92,13 @@ class StackClass {
      */
     pop() {
         if (this.isEmpty) {
-            return Optional.none;
+            return none;
         }
         this.#mut_size = Uint32.sub(this.#mut_size, 1);
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         const element = this.#buffer[this.#mut_size];
         this.#buffer[this.#mut_size] = undefined; // Clear reference for garbage collection
-        return Optional.some(element);
+        return some(element);
     }
     /**
      * Adds an element to the top of the stack (LIFO).

package/dist/collections/stack.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stack.mjs","sources":["../../src/collections/stack.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgKA;;;;;;;;;;;AAWG;AACH,MAAM,UAAU,CAAA;;AAEd,IAAA,OAAO;;AAGP,IAAA,SAAS;;AAGT,IAAA,SAAS;;AAGT,IAAA,OAAgB,iBAAiB,GAAG,CAAC;AAErC;;;;AAIG;AACH,IAAA,WAAA,CAAY,gBAA8B,EAAE,EAAA;AAC1C,QAAA,MAAM,eAAe,GAAG,QAAQ,CAC9B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CACjE;AAED,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CACvB,EAAE,MAAM,EAAE,eAAe,EAAE,EAC3B,MAAM,SAAS,CAChB;AACD,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC;AAC5B,QAAA,IAAI,CAAC,SAAS,GAAG,eAAe;;AAGhC,QAAA,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE;AACjC,YAAA,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAClB;IACF;;AAGA,IAAA,IAAI,OAAO,GAAA;AACT,QAAA,OAAO,IAAI,CAAC,SAAS,KAAK,CAAC;IAC7B;;AAGA,IAAA,IAAI,IAAI,GAAA;AACN,QAAA,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;IACjC;AAEA;;;;;;;;;;;;;AAaG;IACH,GAAG,GAAA;AACD,QAAA,IAAI,IAAI,CAAC,OAAO,EAAE;YAChB,OAAO,QAAQ,CAAC,IAAI;QACtB;AAEA,QAAA,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;;QAE9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAE;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;AAEzC,QAAA,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;IAC/B;AAEA;;;;;;;;;;;;;;;;AAgBG;AACH,IAAA,IAAI,CAAC,KAAQ,EAAA;;QAEX,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE;YACrC,IAAI,CAAC,OAAO,EAAE;QAChB;QAEA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK;AACpC,QAAA,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD;AAEA;;;;AAIG;IACH,OAAO,GAAA;QACL,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;AAChD,QAAA,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,EAAE,MAAM,EAAE,WAAW,EAAE,EACvB,MAAM,SAAS,CAChB;;QAGD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;YACrC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAChC;AAEA,QAAA,IAAI,CAAC,OAAO,GAAG,SAAS;AACxB,QAAA,IAAI,CAAC,SAAS,GAAG,WAAW;IAC9B;;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDG;AACI,MAAM,WAAW,GAAG,CAAK,aAA4B,KAC1D,IAAI,UAAU,CAAI,aAAa;;;;"}
+{"version":3,"file":"stack.mjs","sources":["../../src/collections/stack.mts"],"sourcesContent":[null],"names":["Optional.none","Optional.some"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgKA;;;;;;;;;;;AAWG;AACH,MAAM,UAAU,CAAA;;AAEd,IAAA,OAAO;;AAGP,IAAA,SAAS;;AAGT,IAAA,SAAS;;AAGT,IAAA,OAAgB,iBAAiB,GAAG,CAAC;AAErC;;;;AAIG;AACH,IAAA,WAAA,CAAY,gBAA8B,EAAE,EAAA;AAC1C,QAAA,MAAM,eAAe,GAAG,QAAQ,CAC9B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CACjE;AAED,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CACvB,EAAE,MAAM,EAAE,eAAe,EAAE,EAC3B,MAAM,SAAS,CAChB;AACD,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC;AAC5B,QAAA,IAAI,CAAC,SAAS,GAAG,eAAe;;AAGhC,QAAA,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE;AACjC,YAAA,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAClB;IACF;;AAGA,IAAA,IAAI,OAAO,GAAA;AACT,QAAA,OAAO,IAAI,CAAC,SAAS,KAAK,CAAC;IAC7B;;AAGA,IAAA,IAAI,IAAI,GAAA;AACN,QAAA,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;IACjC;AAEA;;;;;;;;;;;;;AAaG;IACH,GAAG,GAAA;AACD,QAAA,IAAI,IAAI,CAAC,OAAO,EAAE;YAChB,OAAOA,IAAa;QACtB;AAEA,QAAA,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;;QAE9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAE;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;AAEzC,QAAA,OAAOC,IAAa,CAAC,OAAO,CAAC;IAC/B;AAEA;;;;;;;;;;;;;;;;AAgBG;AACH,IAAA,IAAI,CAAC,KAAQ,EAAA;;QAEX,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE;YACrC,IAAI,CAAC,OAAO,EAAE;QAChB;QAEA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK;AACpC,QAAA,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD;AAEA;;;;AAIG;IACH,OAAO,GAAA;QACL,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;AAChD,QAAA,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,EAAE,MAAM,EAAE,WAAW,EAAE,EACvB,MAAM,SAAS,CAChB;;QAGD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;YACrC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAChC;AAEA,QAAA,IAAI,CAAC,OAAO,GAAG,SAAS;AACxB,QAAA,IAAI,CAAC,SAAS,GAAG,WAAW;IAC9B;;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDG;AACI,MAAM,WAAW,GAAG,CAAK,aAA4B,KAC1D,IAAI,UAAU,CAAI,aAAa;;;;"}

package/dist/entry-point.d.mts

@@ -1,3 +1,4 @@
 export * from './array/index.mjs';
+export * from './functional/index.mjs';
 export * from './index.mjs';
 //# sourceMappingURL=entry-point.d.mts.map

package/dist/entry-point.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.d.mts","sourceRoot":"","sources":["../src/entry-point.mts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"entry-point.d.mts","sourceRoot":"","sources":["../src/entry-point.mts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC"}

package/dist/entry-point.mjs

@@ -1,5 +1,13 @@
 import * as index from './array/impl/index.mjs';
 export { index as Arr };
+export { match } from './functional/match.mjs';
+import * as index$1 from './functional/optional/impl/index.mjs';
+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';
@@ -7,10 +15,6 @@ export { ISet } from './collections/iset.mjs';
 export { createQueue } from './collections/queue.mjs';
 export { createStack } from './collections/stack.mjs';
 export { expectType } from './expect-type.mjs';
-export { match } from './functional/match.mjs';
-export { Optional } from './functional/optional.mjs';
-export { pipe } from './functional/pipe.mjs';
-export { Result } from './functional/result.mjs';
 export { hasKey } from './guard/has-key.mjs';
 export { isNonEmptyString } from './guard/is-non-empty-string.mjs';
 export { isNonNullObject } from './guard/is-non-null-object.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

@@ -1,5 +1,6 @@
 export * from './match.mjs';
-export * from './optional.mjs';
+export * from './optional/index.mjs';
 export * from './pipe.mjs';
-export * from './result.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,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,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

@@ -1,5 +1,9 @@
 export { match } from './match.mjs';
-export { Optional } from './optional.mjs';
+import * as index from './optional/impl/index.mjs';
+export { index as Optional };
 export { pipe } from './pipe.mjs';
-export { Result } from './result.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/optional/impl/index.d.mts

@@ -0,0 +1,18 @@
+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-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

@@ -0,0 +1 @@
+{"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,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

@@ -0,0 +1,17 @@
+export { expectToBe } from './optional-expect-to-be.mjs';
+export { filter } from './optional-filter.mjs';
+export { flatMap } from './optional-flat-map.mjs';
+export { fromNullable } from './optional-from-nullable.mjs';
+export { isNone } from './optional-is-none.mjs';
+export { isOptional } from './optional-is-optional.mjs';
+export { isSome } from './optional-is-some.mjs';
+export { map } from './optional-map.mjs';
+export { none } from './optional-none.mjs';
+export { orElse } from './optional-or-else.mjs';
+export { some } from './optional-some.mjs';
+export { toNullable } from './optional-to-nullable.mjs';
+export { unwrapOr } from './optional-unwrap-or.mjs';
+export { unwrapThrow } from './optional-unwrap-throw.mjs';
+export { unwrap } from './optional-unwrap.mjs';
+export { zip } from './optional-zip.mjs';
+//# sourceMappingURL=index.mjs.map

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

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

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

@@ -0,0 +1,29 @@
+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(Optional.expectToBe(optionalValue, 'value expected') === 'data');
+ *
+ * const expectValue = Optional.expectToBe<string>('missing optional');
+ *
+ * assert.throws(() => expectValue(Optional.none), /missing optional/u);
+ * assert(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<S>(message: string): (optional: Optional<S>) => S;
+//# sourceMappingURL=optional-expect-to-be.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-expect-to-be.mjs","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAqCM,SAAU,UAAU,CACxB,GAAG,IAA0E,EAAA;AAE7E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI;AAChC,YAAA,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC1C;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YACtB,OAAO,CAAC,QAA6B,KACnC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QACrC;;AAEJ;AAEA,MAAM,cAAc,GAAG,CACrB,QAAW,EACX,OAAe,KACF;AACb,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;AACpB,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}

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

@@ -0,0 +1,29 @@
+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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-filter.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-filter.mts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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

@@ -0,0 +1,28 @@
+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';
+
+function filter(...args) {
+    switch (args.length) {
+        case 2: {
+            const [optional, predicate] = args;
+            return filterImpl(optional, predicate);
+        }
+        case 1: {
+            // Curried version: first argument is predicate function
+            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;
+};
+
+export { filter };
+//# sourceMappingURL=optional-filter.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-filter.mjs","sources":["../../../../src/functional/optional/impl/optional-filter.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAyCM,SAAU,MAAM,CACpB,GAAG,IAEoD,EAAA;AAEvD,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI;AAClC,YAAA,OAAO,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;QACxC;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;YACxB,OAAO,CAAC,QAAW,KAAK,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;QACzD;;AAEJ;AAEA,MAAM,UAAU,GAAG,CACjB,QAAW,EACX,SAAwC,KACjB;AACvB,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;AACpB,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC9B,QAAA,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI;IAC9C;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;;;;"}

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

@@ -0,0 +1,33 @@
+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 = Number.parseInt(input, 10);
+ *   return Number.isNaN(num) ? Optional.none : Optional.some(num);
+ * };
+ *
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-flat-map.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-flat-map.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-flat-map.mjs","sources":["../../../../src/functional/optional/impl/optional-flat-map.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AA4CM,SAAU,OAAO,CACrB,GAAG,IAEyD,EAAA;AAE5D,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI;AAClC,YAAA,OAAO,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;QACzC;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;YACxB,OAAO,CAAC,QAAW,KAAK,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC1D;;AAEJ;AAEA,MAAM,WAAW,GAAG,CAClB,QAAW,EACX,SAA6C,MAC3B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;;;;"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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

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

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

@@ -0,0 +1,29 @@
+import { none } from './optional-none.mjs';
+import { some } from './optional-some.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`.
+ */
+const fromNullable = (value) => (value == null ? none : some(value));
+
+export { fromNullable };
+//# sourceMappingURL=optional-from-nullable.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-from-nullable.mjs","sources":["../../../../src/functional/optional/impl/optional-from-nullable.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACI,MAAM,YAAY,GAAG,CAC1B,KAA2B,MACG,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;;;;"}

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

@@ -0,0 +1,22 @@
+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
+ *   assert.ok(true); // optionalValue is 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

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

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

@@ -0,0 +1,25 @@
+import { NoneTypeTagName } from './tag.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
+ *   assert.ok(true); // optionalValue is 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.
+ */
+const isNone = (optional) => optional.$$tag === NoneTypeTagName;
+
+export { isNone };
+//# sourceMappingURL=optional-is-none.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-is-none.mjs","sources":["../../../../src/functional/optional/impl/optional-is-none.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;AAkBG;AACI,MAAM,MAAM,GAAG,CACpB,QAAW,KACqB,QAAQ,CAAC,KAAK,KAAK;;;;"}

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

@@ -0,0 +1,18 @@
+/**
+ * Checks if the given value is an {@link Optional}.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeOptional = Optional.some('value');
+ * const notOptional = { $$tag: 'ts-data-forge::Optional.some' };
+ *
+ * assert.ok(Optional.isOptional(maybeOptional));
+ * assert.notOk(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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-is-optional.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-is-optional.mts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,GACrB,eAAe,OAAO,KACrB,aAAa,IAAI,QAAQ,CAAC,OAAO,CAKW,CAAC"}

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

@@ -0,0 +1,27 @@
+import { isRecord } from '../../../guard/is-record.mjs';
+import { SomeTypeTagName, NoneTypeTagName } from './tag.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' };
+ *
+ * assert.ok(Optional.isOptional(maybeOptional));
+ * assert.notOk(Optional.isOptional(notOptional));
+ * ```
+ *
+ * @param maybeOptional The value to check.
+ * @returns `true` if the value is an {@link Optional}, otherwise `false`.
+ */
+const isOptional = (maybeOptional) => isRecord(maybeOptional) &&
+    Object.hasOwn(maybeOptional, '$$tag') &&
+    ((maybeOptional['$$tag'] === SomeTypeTagName &&
+        Object.hasOwn(maybeOptional, 'value')) ||
+        maybeOptional['$$tag'] === NoneTypeTagName);
+
+export { isOptional };
+//# sourceMappingURL=optional-is-optional.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional-is-optional.mjs","sources":["../../../../src/functional/optional/impl/optional-is-optional.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,UAAU,GAAG,CACxB,aAAsB,KAEtB,QAAQ,CAAC,aAAa,CAAC;AACvB,IAAA,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC;AACrC,KAAC,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,eAAe;AAC1C,QAAA,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC;AACrC,QAAA,aAAa,CAAC,OAAO,CAAC,KAAK,eAAe;;;;"}

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

@@ -0,0 +1,22 @@
+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(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

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