@allmaps/stdlib/dist/options.js

Allmaps Standard Library

/* eslint-disable @typescript-eslint/no-explicit-any */
export function mergeOptions(options0, options1) {
    // In general options1 extends options0
    // Using this over mergePartialOption() assures that the output type will be at least Option0
    // This function serves two purposes:
    // 1) Speedup: spreading is a little expensive, so it checks if necessary first
    // (e.g. it was previously executed for every point in transform,
    // where this was a 50% speed increase when transforming a lot of points
    // 2) It allows option1 to be undefined, which simplifies handing over a simple spread
    if (!options1) {
        return options0;
    }
    return {
        ...options0,
        ...options1
    };
}
export function mergeOptionsUnlessUndefined(options0, options1) {
    if (!options1) {
        return options0;
    }
    // Only overwrite properties that are not undefined
    for (const key in options1) {
        const value = options1[key];
        if (value !== undefined) {
            ;
            options0[key] = value;
        }
    }
    return options0;
}
// // Saving this here, may be useful later
// export function mergeOptionsDeep<
//   Option0 extends Record<string, any>,
//   Option1 extends Record<string, any>
// >(option0: Option0, option1: Option1): Option0 & Option1 {
//   // Create a new object to avoid mutating either input
//   const output = { ...option0 } as Record<string, any>
//   if (isObject(option0) && isObject(option1)) {
//     Object.keys(option1).forEach((key) => {
//       const sourceValue = option1[key as keyof Option1]
//       if (isObject(sourceValue)) {
//         // If both target and source have the same key and both are objects, recursively merge
//         if (key in option0 && isObject(option0[key as keyof Option0])) {
//           output[key] = mergeOptionsDeep(
//             option0[key as keyof Option0] as Record<string, any>,
//             sourceValue as Record<string, any>
//           )
//         } else {
//           // Otherwise just clone the source object
//           output[key] = { ...sourceValue }
//         }
//       } else {
//         // For non-object values, simply copy from source
//         output[key] = sourceValue
//       }
//     })
//   }
//   return output as Option0 & Option1
// }
export function mergePartialOptions(...partialOptionsArray) {
    const definedPartialOptionsArray = partialOptionsArray.filter((partialOptions) => partialOptions !== undefined && partialOptions !== null);
    if (definedPartialOptionsArray.length === 0) {
        return {};
    }
    else if (definedPartialOptionsArray.length === 1) {
        return definedPartialOptionsArray[0];
    }
    else {
        // This spreads out eacht of the partialOptions
        return Object.assign({}, ...definedPartialOptionsArray);
    }
}