import { None, Some, isOption, isSome } from './common'; /** * A type that defines the recursive unwrapping of a type `T` * such that all nested {@link Option} types are unwrapped. * * For each nested {@link Option} type, if the option is a {@link Some}, * it returns the type of its value, otherwise, it returns the provided * fallback type `U` which defaults to `null`. * * @category Utils — Options */ export type UnwrappedOption = T extends Some ? UnwrappedOption : T extends None ? U : T extends | string | number | boolean | symbol | bigint | undefined | null | Uint8Array | Date ? T : T extends object ? { [key in keyof T]: UnwrappedOption } : T extends Array ? Array> : T; /** * Recursively go through a type `T`such that all * nested {@link Option} types are unwrapped. * * For each nested {@link Option} type, if the option is a {@link Some}, * it returns its value, otherwise, it returns the provided fallback value * which defaults to `null`. * * @category Utils — Options */ export function unwrapOptionRecursively(input: T): UnwrappedOption; export function unwrapOptionRecursively( input: T, fallback: () => U ): UnwrappedOption; export function unwrapOptionRecursively( input: T, fallback?: () => U ): UnwrappedOption { // Types to bypass. if (!input || ArrayBuffer.isView(input)) { return input as UnwrappedOption; } const next = (x: X) => (fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x)) as UnwrappedOption; // Handle Option. if (isOption(input)) { if (isSome(input)) return next(input.value) as UnwrappedOption; return (fallback ? fallback() : null) as UnwrappedOption; } // Walk. if (Array.isArray(input)) { return input.map(next) as UnwrappedOption; } if (typeof input === 'object') { return Object.fromEntries( Object.entries(input).map(([k, v]) => [k, next(v)]) ) as UnwrappedOption; } return input as UnwrappedOption; }