rc-js-util/src/dictionary/impl/dictionary-clone-extend.ts

A collection of TS and C++ utilities to help writing performant and correct applications, achieved through strict typing and (removable) invariant checking.

import { dictionaryOverwrite } from "./dictionary-overwrite.js";

/**
 * @public
 * Creates an object which is extended sequentially by two additional objects.
 * @param base - The object to apply first.
 * @param extension - The object to apply second.
 *
 * @remarks
 * See {@link dictionaryCloneExtend}.
 */
export function dictionaryCloneExtend<T extends object, U extends object>
(
    base: T,
    extension: U
)
    : T & U
{
    const extended = {} as T & U;
    dictionaryOverwrite(extended, base);
    dictionaryOverwrite(extended, extension);

    return extended;
}