deepMerge() — tailwindcss Function Reference

Architecture documentation for the deepMerge() function in deep-merge.ts from the tailwindcss codebase.

Function typescript CompilerEngine ModuleResolution calls 1 called by 2

Entity Profile

CompilerEngine→ ModuleResolution→ deepMerge() — tailwindcss Function Reference

Dependency Diagram

graph TD
  982d7e72_5afc_4832_dfcb_f221e9d52c64["deepMerge()"]
  9c6a3a4b_953d_4928_2f26_12c610c5c0e4["mergeTheme()"]
  9c6a3a4b_953d_4928_2f26_12c610c5c0e4 -->|calls| 982d7e72_5afc_4832_dfcb_f221e9d52c64
  1ea8fd4a_634f_c2f0_5465_01d387d5207b["createThemeFn()"]
  1ea8fd4a_634f_c2f0_5465_01d387d5207b -->|calls| 982d7e72_5afc_4832_dfcb_f221e9d52c64
  44ea0add_f78b_a0da_1851_38236796bf32["isPlainObject()"]
  982d7e72_5afc_4832_dfcb_f221e9d52c64 -->|calls| 44ea0add_f78b_a0da_1851_38236796bf32
  style 982d7e72_5afc_4832_dfcb_f221e9d52c64 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/tailwindcss/src/compat/config/deep-merge.ts lines 10–40

export function deepMerge<T extends object>(
  target: T,
  sources: (Partial<T> | null | undefined)[],
  customizer: (a: any, b: any, keypath: (keyof T)[]) => any,
  path: (keyof T)[] = [],
) {
  type Key = keyof T
  type Value = T[Key]

  for (let source of sources) {
    if (source === null || source === undefined) {
      continue
    }

    for (let k of Reflect.ownKeys(source) as Key[]) {
      path.push(k)
      let merged = customizer(target[k], source[k], path)

      if (merged !== undefined) {
        target[k] = merged
      } else if (!isPlainObject(target[k]) || !isPlainObject(source[k])) {
        target[k] = source[k] as Value
      } else {
        target[k] = deepMerge({}, [target[k], source[k]], customizer, path as any) as Value
      }
      path.pop()
    }
  }

  return target
}