@ms-cloudpack/package-utilities 7.7.1 → 7.8.1

package/lib/flattenExportsMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flattenExportsMap.d.ts","sourceRoot":"","sources":["../src/flattenExportsMap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAM/F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BxB"}
+{"version":3,"file":"flattenExportsMap.d.ts","sourceRoot":"","sources":["../src/flattenExportsMap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAO/F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB"}

package/lib/flattenExportsMap.js

@@ -1,6 +1,7 @@
 import path from 'path';
 import { cleanEntry } from './cleanEntry.js';
 import glob from 'fast-glob';
+import { mergeArrayDefaults } from './mergeArrayDefaults.js';
 const defaultConditions = ['browser', 'module', 'import', 'default'];
 /**
  * Given a package definition and applicable conditions, return a flat map of package import to physical (relative) path.
@@ -18,16 +19,7 @@ const defaultConditions = ['browser', 'module', 'import', 'default'];
  */
 export function flattenExportsMap(exportsMap, options = {}) {
     const { requiredConditions, packagePath } = options;
-    let { conditions } = options;
-    if (conditions) {
-        const defaultIndex = conditions.indexOf('...');
-        if (defaultIndex !== -1) {
-            conditions = [...conditions.slice(0, defaultIndex), ...defaultConditions, ...conditions.slice(defaultIndex + 1)];
-        }
-    }
-    else {
-        conditions = defaultConditions;
-    }
+    const conditions = mergeArrayDefaults(options.conditions, defaultConditions);
     if (typeof exportsMap === 'string' && conditions.includes('default')) {
         return {
             '.': cleanEntry(exportsMap),

package/lib/flattenExportsMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"flattenExportsMap.js","sourceRoot":"","sources":["../src/flattenExportsMap.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport type { PackageJsonExportsObject, PackageJsonExports } from '@ms-cloudpack/common-types';\nimport { cleanEntry } from './cleanEntry.js';\nimport glob from 'fast-glob';\n\nconst defaultConditions = ['browser', 'module', 'import', 'default'];\n\n/**\n * Given a package definition and applicable conditions, return a flat map of package import to physical (relative) path.\n * Optionally return the exports map fully qualified with conditions intact using the `fullExports` option.\n * Optionally takes in a `packagePath` to resolve entries and values that end in `/` and with wildcards `*`.\n *\n * Notes:\n * - This diverges from the behavior of Node in that conditions are considered in order of\n *   the `conditions` array, NOT in the order keys are defined in the exports map.\n * - Null export values are supported only for generated config. A null export signals to Cloudpack\n *   that the entry should be completely dropped from the flattened exports map.\n * - Following the behavior of Node, for perf reasons, we do NOT verify whether any entries\n *   exist on disk except wildcard or trailing slash exports since it is required.\n *   (This differs from the behavior of typescript and webpack.)\n */\nexport function flattenExportsMap(\n  exportsMap: PackageJsonExports,\n  options: {\n    conditions?: string[];\n    requiredConditions?: string[];\n    packagePath?: string;\n  } = {},\n): Record<string, string> {\n  const { requiredConditions, packagePath } = options;\n  let { conditions } = options;\n\n  if (conditions) {\n    const defaultIndex = conditions.indexOf('...');\n    if (defaultIndex !== -1) {\n      conditions = [...conditions.slice(0, defaultIndex), ...defaultConditions, ...conditions.slice(defaultIndex + 1)];\n    }\n  } else {\n    conditions = defaultConditions;\n  }\n\n  if (typeof exportsMap === 'string' && conditions.includes('default')) {\n    return {\n      '.': cleanEntry(exportsMap),\n    };\n  }\n\n  return extractExports({\n    exports: exportsMap,\n    conditions,\n    requiredConditions,\n    flatExports: {},\n    importMatch: '.',\n    matchedConditions: [],\n    packagePath,\n  });\n}\n\n/**\n * Extract the exports from an exports object or sub-object and add them to the flat exports map.\n *\n * @returns The cumulative flat exports map.\n */\nfunction extractExports({\n  exports,\n  conditions,\n  requiredConditions,\n  flatExports = {},\n  importMatch = '.',\n  matchedConditions = [],\n  packagePath = undefined,\n}: {\n  /** The exports object to extract or a sub-object. */\n  exports: PackageJsonExports;\n  /** The conditions to check for in the exports object. */\n  conditions: string[];\n  /** The conditions that must be matched to add the export. */\n  requiredConditions?: string[];\n  /** The cumulative flat exports map to add the exports to. */\n  flatExports?: Record<string, string>;\n  /** The import path to match (default `.`). */\n  importMatch?: string;\n  /** The conditions that have been matched so far. */\n  matchedConditions?: string[];\n  /** The path to the package. */\n  packagePath?: string | undefined;\n}) {\n  if (\n    typeof exports === 'string' &&\n    (!requiredConditions || requiredConditions.every((condition) => matchedConditions.includes(condition)))\n  ) {\n    addExportsEntry({ flatExports, key: importMatch, value: exports, packagePath });\n  } else if (Array.isArray(exports)) {\n    for (const exportEntry of exports) {\n      extractExports({\n        exports: exportEntry,\n        conditions,\n        requiredConditions,\n        flatExports,\n        importMatch,\n        matchedConditions,\n        packagePath,\n      });\n    }\n  } else if (exports && typeof exports === 'object') {\n    // Iterate through condition matches and go deeper if a match is found.\n    for (const condition of conditions) {\n      const exportsObject = (exports as PackageJsonExportsObject)[condition];\n\n      if (exportsObject) {\n        extractExports({\n          exports: exportsObject as PackageJsonExports,\n          conditions,\n          requiredConditions,\n          flatExports,\n          importMatch,\n          matchedConditions: matchedConditions.concat(condition),\n          packagePath,\n        });\n        // Stop at the first match.\n        return flatExports;\n      }\n    }\n\n    // No conditions are available. Check for import entries.\n    for (const [key, value] of Object.entries(exports)) {\n      if (key.startsWith('.')) {\n        importMatch = key;\n\n        if (typeof value === 'string') {\n          if (!flatExports[importMatch] && (!requiredConditions || requiredConditions?.includes(key))) {\n            addExportsEntry({ flatExports, key: importMatch, value, packagePath });\n          }\n        } else if (value) {\n          extractExports({\n            exports: value,\n            conditions,\n            requiredConditions,\n            flatExports,\n            importMatch,\n            matchedConditions: [...matchedConditions, key],\n            packagePath,\n          });\n        } else {\n          delete flatExports[key];\n        }\n      }\n    }\n  }\n\n  return flatExports;\n}\n\n/**\n * Add an entry to the flattened exports map if the key and value are valid\n * and the key is not already in the map.\n *\n * Does nothing if the key contains a wildcard or a trailing slash and the value does not, such as it being `null`.\n */\nfunction addExportsEntry({\n  flatExports,\n  key,\n  value,\n  packagePath,\n}: {\n  /** The path to the package. */\n  flatExports: Record<string, string>;\n  /** The flattened exports map. */\n  key: string;\n  /** The key to add to the map. */\n  value: string;\n  /** The relative physical path to add to the map. */\n  packagePath: string | undefined;\n}) {\n  const basename = path.basename(value);\n  const isValid = basename !== '' && basename !== '.';\n  const isMany = value.endsWith('/') || value.indexOf('*') !== -1 || key.indexOf('*') !== -1 || key.endsWith('/');\n\n  // Skip if the key is already in the map.\n  if (flatExports[key]) return;\n\n  if (isValid && !isMany) {\n    flatExports[key] = cleanEntry(value);\n    return;\n  }\n\n  if (value === null) {\n    // Debug log for null values in the exports map.\n    console.debug(`Skipping null value for key \"${key}\" in exports map${packagePath ? ` of \"${packagePath}\"` : ''}.`);\n    return;\n  }\n\n  // Debug log for export patterns found in the exports map.\n  console.debug(`Found export patterns in ${packagePath ? `\"${packagePath}\" ` : ''}exports map: \"${key}\": \"${value}\"`);\n\n  // A package path is required to resolve entries and values that end in `/` or that include a wildcard `*`.\n  if (!packagePath) return;\n\n  // Check for wildcards in the key and value.\n  // The wildcards\n  const keyWildcard = key.indexOf('*', 1);\n  const valueWildcard = value.indexOf('*', 1);\n\n  if ((key.endsWith('/') && value.endsWith('/')) || (keyWildcard !== -1 && valueWildcard !== -1)) {\n    const searchGlob = valueToGlob(value, valueWildcard);\n    const keySplit = splitByGlob(key, keyWildcard);\n    const valueSplit = splitByGlob(value, valueWildcard);\n    if (!searchGlob || !keySplit || !valueSplit) return;\n    // We only want to search for files.\n    const matches = glob.sync(searchGlob, { cwd: packagePath, onlyFiles: true });\n    for (const match of matches) {\n      // Skip files that don't have an extension or have a `.` extension.\n      if (path.extname(match).length <= 1) continue;\n      // Get the glob match shared between the key and value.\n      const globMatch = match.substring(\n        // Globs that start with `./` don't return matches with `./` in the beginning.\n        match.startsWith(valueSplit.start) ? valueSplit.start.length : 0,\n        match.length - valueSplit.end.length,\n      );\n      // Replace the glob match in the key with the resolved glob match in the value.\n      const matchKey = keySplit.start + globMatch + keySplit.end;\n      if (!flatExports[matchKey]) {\n        flatExports[matchKey] = cleanEntry(match);\n      }\n    }\n  }\n}\n\n/**\n * Convert a value to a glob pattern.\n *\n * @param value The value to convert.\n * @param valueWildcard The index of the wildcard in the value.\n * @returns A value converted to a glob pattern.\n */\nfunction valueToGlob(value: string, valueWildcard: number = value.indexOf('*', 1)) {\n  if (value.endsWith('/')) {\n    return value + '**/*';\n  } else if (valueWildcard !== -1) {\n    return value.substring(0, valueWildcard) + '**/*' + value.substring(valueWildcard + 1);\n  }\n}\n\n/**\n * Split a value by the location of the trailing slash or wildcard.\n *\n * @param value The value to split.\n * @param valueWildcard The index of the wildcard in the value.\n * @returns An object with the start and end substring of the split value.\n */\nfunction splitByGlob(value: string, valueWildcard: number = value.indexOf('*', 1)) {\n  if (value.endsWith('/')) {\n    return { start: value, end: '' };\n  } else if (valueWildcard !== -1) {\n    return {\n      start: value.substring(0, valueWildcard),\n      end: value.substring(valueWildcard + 1),\n    };\n  }\n}\n"]}
+{"version":3,"file":"flattenExportsMap.js","sourceRoot":"","sources":["../src/flattenExportsMap.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport type { PackageJsonExportsObject, PackageJsonExports } from '@ms-cloudpack/common-types';\nimport { cleanEntry } from './cleanEntry.js';\nimport glob from 'fast-glob';\nimport { mergeArrayDefaults } from './mergeArrayDefaults.js';\n\nconst defaultConditions = ['browser', 'module', 'import', 'default'];\n\n/**\n * Given a package definition and applicable conditions, return a flat map of package import to physical (relative) path.\n * Optionally return the exports map fully qualified with conditions intact using the `fullExports` option.\n * Optionally takes in a `packagePath` to resolve entries and values that end in `/` and with wildcards `*`.\n *\n * Notes:\n * - This diverges from the behavior of Node in that conditions are considered in order of\n *   the `conditions` array, NOT in the order keys are defined in the exports map.\n * - Null export values are supported only for generated config. A null export signals to Cloudpack\n *   that the entry should be completely dropped from the flattened exports map.\n * - Following the behavior of Node, for perf reasons, we do NOT verify whether any entries\n *   exist on disk except wildcard or trailing slash exports since it is required.\n *   (This differs from the behavior of typescript and webpack.)\n */\nexport function flattenExportsMap(\n  exportsMap: PackageJsonExports,\n  options: {\n    conditions?: string[];\n    requiredConditions?: string[];\n    packagePath?: string;\n  } = {},\n): Record<string, string> {\n  const { requiredConditions, packagePath } = options;\n\n  const conditions = mergeArrayDefaults(options.conditions, defaultConditions);\n\n  if (typeof exportsMap === 'string' && conditions.includes('default')) {\n    return {\n      '.': cleanEntry(exportsMap),\n    };\n  }\n\n  return extractExports({\n    exports: exportsMap,\n    conditions,\n    requiredConditions,\n    flatExports: {},\n    importMatch: '.',\n    matchedConditions: [],\n    packagePath,\n  });\n}\n\n/**\n * Extract the exports from an exports object or sub-object and add them to the flat exports map.\n *\n * @returns The cumulative flat exports map.\n */\nfunction extractExports({\n  exports,\n  conditions,\n  requiredConditions,\n  flatExports = {},\n  importMatch = '.',\n  matchedConditions = [],\n  packagePath = undefined,\n}: {\n  /** The exports object to extract or a sub-object. */\n  exports: PackageJsonExports;\n  /** The conditions to check for in the exports object. */\n  conditions: string[];\n  /** The conditions that must be matched to add the export. */\n  requiredConditions?: string[];\n  /** The cumulative flat exports map to add the exports to. */\n  flatExports?: Record<string, string>;\n  /** The import path to match (default `.`). */\n  importMatch?: string;\n  /** The conditions that have been matched so far. */\n  matchedConditions?: string[];\n  /** The path to the package. */\n  packagePath?: string | undefined;\n}) {\n  if (\n    typeof exports === 'string' &&\n    (!requiredConditions || requiredConditions.every((condition) => matchedConditions.includes(condition)))\n  ) {\n    addExportsEntry({ flatExports, key: importMatch, value: exports, packagePath });\n  } else if (Array.isArray(exports)) {\n    for (const exportEntry of exports) {\n      extractExports({\n        exports: exportEntry,\n        conditions,\n        requiredConditions,\n        flatExports,\n        importMatch,\n        matchedConditions,\n        packagePath,\n      });\n    }\n  } else if (exports && typeof exports === 'object') {\n    // Iterate through condition matches and go deeper if a match is found.\n    for (const condition of conditions) {\n      const exportsObject = (exports as PackageJsonExportsObject)[condition];\n\n      if (exportsObject) {\n        extractExports({\n          exports: exportsObject as PackageJsonExports,\n          conditions,\n          requiredConditions,\n          flatExports,\n          importMatch,\n          matchedConditions: matchedConditions.concat(condition),\n          packagePath,\n        });\n        // Stop at the first match.\n        return flatExports;\n      }\n    }\n\n    // No conditions are available. Check for import entries.\n    for (const [key, value] of Object.entries(exports)) {\n      if (key.startsWith('.')) {\n        importMatch = key;\n\n        if (typeof value === 'string') {\n          if (!flatExports[importMatch] && (!requiredConditions || requiredConditions?.includes(key))) {\n            addExportsEntry({ flatExports, key: importMatch, value, packagePath });\n          }\n        } else if (value) {\n          extractExports({\n            exports: value,\n            conditions,\n            requiredConditions,\n            flatExports,\n            importMatch,\n            matchedConditions: [...matchedConditions, key],\n            packagePath,\n          });\n        } else {\n          delete flatExports[key];\n        }\n      }\n    }\n  }\n\n  return flatExports;\n}\n\n/**\n * Add an entry to the flattened exports map if the key and value are valid\n * and the key is not already in the map.\n *\n * Does nothing if the key contains a wildcard or a trailing slash and the value does not, such as it being `null`.\n */\nfunction addExportsEntry({\n  flatExports,\n  key,\n  value,\n  packagePath,\n}: {\n  /** The path to the package. */\n  flatExports: Record<string, string>;\n  /** The flattened exports map. */\n  key: string;\n  /** The key to add to the map. */\n  value: string;\n  /** The relative physical path to add to the map. */\n  packagePath: string | undefined;\n}) {\n  const basename = path.basename(value);\n  const isValid = basename !== '' && basename !== '.';\n  const isMany = value.endsWith('/') || value.indexOf('*') !== -1 || key.indexOf('*') !== -1 || key.endsWith('/');\n\n  // Skip if the key is already in the map.\n  if (flatExports[key]) return;\n\n  if (isValid && !isMany) {\n    flatExports[key] = cleanEntry(value);\n    return;\n  }\n\n  if (value === null) {\n    // Debug log for null values in the exports map.\n    console.debug(`Skipping null value for key \"${key}\" in exports map${packagePath ? ` of \"${packagePath}\"` : ''}.`);\n    return;\n  }\n\n  // Debug log for export patterns found in the exports map.\n  console.debug(`Found export patterns in ${packagePath ? `\"${packagePath}\" ` : ''}exports map: \"${key}\": \"${value}\"`);\n\n  // A package path is required to resolve entries and values that end in `/` or that include a wildcard `*`.\n  if (!packagePath) return;\n\n  // Check for wildcards in the key and value.\n  // The wildcards\n  const keyWildcard = key.indexOf('*', 1);\n  const valueWildcard = value.indexOf('*', 1);\n\n  if ((key.endsWith('/') && value.endsWith('/')) || (keyWildcard !== -1 && valueWildcard !== -1)) {\n    const searchGlob = valueToGlob(value, valueWildcard);\n    const keySplit = splitByGlob(key, keyWildcard);\n    const valueSplit = splitByGlob(value, valueWildcard);\n    if (!searchGlob || !keySplit || !valueSplit) return;\n    // We only want to search for files.\n    const matches = glob.sync(searchGlob, { cwd: packagePath, onlyFiles: true });\n    for (const match of matches) {\n      // Skip files that don't have an extension or have a `.` extension.\n      if (path.extname(match).length <= 1) continue;\n      // Get the glob match shared between the key and value.\n      const globMatch = match.substring(\n        // Globs that start with `./` don't return matches with `./` in the beginning.\n        match.startsWith(valueSplit.start) ? valueSplit.start.length : 0,\n        match.length - valueSplit.end.length,\n      );\n      // Replace the glob match in the key with the resolved glob match in the value.\n      const matchKey = keySplit.start + globMatch + keySplit.end;\n      if (!flatExports[matchKey]) {\n        flatExports[matchKey] = cleanEntry(match);\n      }\n    }\n  }\n}\n\n/**\n * Convert a value to a glob pattern.\n *\n * @param value The value to convert.\n * @param valueWildcard The index of the wildcard in the value.\n * @returns A value converted to a glob pattern.\n */\nfunction valueToGlob(value: string, valueWildcard: number = value.indexOf('*', 1)) {\n  if (value.endsWith('/')) {\n    return value + '**/*';\n  } else if (valueWildcard !== -1) {\n    return value.substring(0, valueWildcard) + '**/*' + value.substring(valueWildcard + 1);\n  }\n}\n\n/**\n * Split a value by the location of the trailing slash or wildcard.\n *\n * @param value The value to split.\n * @param valueWildcard The index of the wildcard in the value.\n * @returns An object with the start and end substring of the split value.\n */\nfunction splitByGlob(value: string, valueWildcard: number = value.indexOf('*', 1)) {\n  if (value.endsWith('/')) {\n    return { start: value, end: '' };\n  } else if (valueWildcard !== -1) {\n    return {\n      start: value.substring(0, valueWildcard),\n      end: value.substring(valueWildcard + 1),\n    };\n  }\n}\n"]}

package/lib/index.d.ts

@@ -23,4 +23,6 @@ export { findProjectRoot } from './findProjectRoot.js';
 export { shouldExternalizePackage } from './shouldExternalizePackage.js';
 export { ensurePackageJsonDependencies } from './ensurePackageJsonDependencies.js';
 export { getSourceEntry } from './getSourceEntry.js';
+export { mergeArrayDefaults } from './mergeArrayDefaults.js';
+export { mergeObjects } from './mergeObjects.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/index.js

@@ -24,4 +24,7 @@ export { findProjectRoot } from './findProjectRoot.js';
 export { shouldExternalizePackage } from './shouldExternalizePackage.js';
 export { ensurePackageJsonDependencies } from './ensurePackageJsonDependencies.js';
 export { getSourceEntry } from './getSourceEntry.js';
+// Object utilities which could be moved to a separate package if we add more of them
+export { mergeArrayDefaults } from './mergeArrayDefaults.js';
+export { mergeObjects } from './mergeObjects.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAG1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAkC,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,8BAA8B;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAA+D,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["// Package definition parsing\nexport { PackageDefinitions } from './PackageDefinitions.js';\n\n// ResolveMap creation\nexport { createResolveMap } from './createResolveMap/createResolveMap.js';\nexport type { ResolveMap } from './types/ResolveMap.js';\nexport type { ResolveMapEntry } from './types/ResolveMapEntry.js';\nexport { findResolveMapEntry } from './findResolveMapEntry.js';\nexport type { DiffResolveMapsChanges, DiffResolveMapsStats } from './createResolveMap/diffResolveMaps.js';\nexport { diffResolveMaps } from './createResolveMap/diffResolveMaps.js';\nexport type { LinkedPath } from './types/LinkedPath.js';\n\n// ExportsMap parsing and creation\nexport { flattenExportsMap } from './flattenExportsMap.js';\nexport { createExportsMap } from './createExportsMap.js';\nexport { addExportsMapEntry, type AddExportsMapEntryOptions } from './addExportsMapEntry.js';\nexport { getExportsMap } from './getExportsMap.js';\nexport { ensureResolveMapEntry } from './ensureResolveMapEntry.js';\n\n// Import resolution utilities\nexport { resolve } from './resolve.js';\n\n// Other package utilities\nexport { detectModuleType } from './detectModuleType.js';\nexport { isExternalPackage } from './isExternalPackage.js';\nexport { findFileInPackage, type FindFileInPackageOptions, type FindFileInPackageResult } from './findFileInPackage.js';\nexport { getDisplayVersion } from './getDisplayVersion.js';\nexport { getVersion } from './getVersion.js';\nexport { getDependencies } from './getDependencies.js';\nexport { getUnusedDependencies } from './getUnusedDependencies.js';\nexport { findProjectRoot } from './findProjectRoot.js';\nexport { shouldExternalizePackage } from './shouldExternalizePackage.js';\nexport { ensurePackageJsonDependencies } from './ensurePackageJsonDependencies.js';\nexport { getSourceEntry } from './getSourceEntry.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAG1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAkC,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,8BAA8B;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAA+D,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qFAAqF;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["// Package definition parsing\nexport { PackageDefinitions } from './PackageDefinitions.js';\n\n// ResolveMap creation\nexport { createResolveMap } from './createResolveMap/createResolveMap.js';\nexport type { ResolveMap } from './types/ResolveMap.js';\nexport type { ResolveMapEntry } from './types/ResolveMapEntry.js';\nexport { findResolveMapEntry } from './findResolveMapEntry.js';\nexport type { DiffResolveMapsChanges, DiffResolveMapsStats } from './createResolveMap/diffResolveMaps.js';\nexport { diffResolveMaps } from './createResolveMap/diffResolveMaps.js';\nexport type { LinkedPath } from './types/LinkedPath.js';\n\n// ExportsMap parsing and creation\nexport { flattenExportsMap } from './flattenExportsMap.js';\nexport { createExportsMap } from './createExportsMap.js';\nexport { addExportsMapEntry, type AddExportsMapEntryOptions } from './addExportsMapEntry.js';\nexport { getExportsMap } from './getExportsMap.js';\nexport { ensureResolveMapEntry } from './ensureResolveMapEntry.js';\n\n// Import resolution utilities\nexport { resolve } from './resolve.js';\n\n// Other package utilities\nexport { detectModuleType } from './detectModuleType.js';\nexport { isExternalPackage } from './isExternalPackage.js';\nexport { findFileInPackage, type FindFileInPackageOptions, type FindFileInPackageResult } from './findFileInPackage.js';\nexport { getDisplayVersion } from './getDisplayVersion.js';\nexport { getVersion } from './getVersion.js';\nexport { getDependencies } from './getDependencies.js';\nexport { getUnusedDependencies } from './getUnusedDependencies.js';\nexport { findProjectRoot } from './findProjectRoot.js';\nexport { shouldExternalizePackage } from './shouldExternalizePackage.js';\nexport { ensurePackageJsonDependencies } from './ensurePackageJsonDependencies.js';\nexport { getSourceEntry } from './getSourceEntry.js';\n\n// Object utilities which could be moved to a separate package if we add more of them\nexport { mergeArrayDefaults } from './mergeArrayDefaults.js';\nexport { mergeObjects } from './mergeObjects.js';\n"]}

package/lib/mergeArrayDefaults.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Replace a '...' in an array with the provided defaults.
+ * Returns a new array regardless of whether a replacement was made.
+ * If `values` is undefined, returns a copy of the defaults array.
+ */
+export declare function mergeArrayDefaults<T>(values: (T | '...')[] | undefined, defaults: T[]): T[];
+//# sourceMappingURL=mergeArrayDefaults.d.ts.map

package/lib/mergeArrayDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeArrayDefaults.d.ts","sourceRoot":"","sources":["../src/mergeArrayDefaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAU3F"}

package/lib/mergeArrayDefaults.js

@@ -0,0 +1,17 @@
+/**
+ * Replace a '...' in an array with the provided defaults.
+ * Returns a new array regardless of whether a replacement was made.
+ * If `values` is undefined, returns a copy of the defaults array.
+ */
+export function mergeArrayDefaults(values, defaults) {
+    if (!values) {
+        return [...defaults];
+    }
+    values = [...values];
+    const defaultsIndex = values.indexOf('...');
+    if (defaultsIndex > -1) {
+        values.splice(defaultsIndex, 1, ...defaults);
+    }
+    return values;
+}
+//# sourceMappingURL=mergeArrayDefaults.js.map

package/lib/mergeArrayDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeArrayDefaults.js","sourceRoot":"","sources":["../src/mergeArrayDefaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAI,MAAiC,EAAE,QAAa;IACpF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACrB,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAa,CAAC;AACvB,CAAC","sourcesContent":["/**\n * Replace a '...' in an array with the provided defaults.\n * Returns a new array regardless of whether a replacement was made.\n * If `values` is undefined, returns a copy of the defaults array.\n */\nexport function mergeArrayDefaults<T>(values: (T | '...')[] | undefined, defaults: T[]): T[] {\n  if (!values) {\n    return [...defaults];\n  }\n  values = [...values];\n  const defaultsIndex = values.indexOf('...');\n  if (defaultsIndex > -1) {\n    values.splice(defaultsIndex, 1, ...defaults);\n  }\n  return values as T[];\n}\n"]}

package/lib/mergeObjects.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Recursively merge objects.
+ * Array values are concatenated by default, but this is configurable.
+ * Assumes that the types of any defined keys stay consistent across all objects;
+ * if this isn't true, provide a `customMerge` function for that key.
+ * (`customMerge` must also be used to customize merging for nested objects.)
+ */
+export declare function mergeObjects<T extends object>(objects: T[], options?: {
+    /**
+     * Whether to concatenate all arrays (default) or overwrite with new values.
+     * Applies to top-level and nested objects.
+     */
+    arrayMerge?: 'concat' | 'overwrite';
+    /**
+     * Overwrite the values of these object or array keys instead of merging.
+     * Applies to the top-level object only.
+     */
+    overwriteKeys?: (keyof T)[];
+    /**
+     * Custom merging for key values. The function should return the merged value.
+     * Applies to the top-level object only.
+     */
+    customMerge?: {
+        [K in keyof T]?: (prev: T[K] | undefined, curr: T[K]) => T[K];
+    };
+}): T;
+//# sourceMappingURL=mergeObjects.d.ts.map

package/lib/mergeObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeObjects.d.ts","sourceRoot":"","sources":["../src/mergeObjects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,GAAE;IACP;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE;SACX,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC9D,CAAC;CACE,GACL,CAAC,CAkCH"}

package/lib/mergeObjects.js

@@ -0,0 +1,42 @@
+/**
+ * Recursively merge objects.
+ * Array values are concatenated by default, but this is configurable.
+ * Assumes that the types of any defined keys stay consistent across all objects;
+ * if this isn't true, provide a `customMerge` function for that key.
+ * (`customMerge` must also be used to customize merging for nested objects.)
+ */
+export function mergeObjects(objects, options = {}) {
+    // NOTE: If other options are added, consider whether they should apply recursively,
+    // and if so, update the mergeObjects() recursive call.
+    const { customMerge, arrayMerge = 'concat', overwriteKeys } = options;
+    const acc = {};
+    for (const obj of objects) {
+        if (!obj || typeof obj !== 'object') {
+            throw new Error('mergeObjects: all arguments must be objects');
+        }
+        for (const pair of Object.entries(obj)) {
+            const key = pair[0];
+            const val = pair[1];
+            const customMergeKey = customMerge?.[key];
+            if (customMergeKey) {
+                acc[key] = customMergeKey(acc[key], val);
+            }
+            else if (overwriteKeys?.includes(key)) {
+                acc[key] = val;
+            }
+            else if (Array.isArray(val)) {
+                acc[key] = arrayMerge === 'concat' ? [...(acc[key] || []), ...val] : val;
+            }
+            else if (val && typeof val === 'object') {
+                // Recursively merge objects. arrayMerge makes sense to apply recursively, but customMerge
+                // and overwriteKeys are specific to the keys of the top-level object.
+                acc[key] = mergeObjects([(acc[key] || {}), val], { arrayMerge });
+            }
+            else {
+                acc[key] = val;
+            }
+        }
+    }
+    return acc;
+}
+//# sourceMappingURL=mergeObjects.js.map

package/lib/mergeObjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeObjects.js","sourceRoot":"","sources":["../src/mergeObjects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAY,EACZ,UAkBI,EAAE;IAEN,oFAAoF;IACpF,uDAAuD;IACvD,MAAM,EAAE,WAAW,EAAE,UAAU,GAAG,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAEtE,MAAM,GAAG,GAAG,EAAO,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAY,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAkB,CAAC;YACrC,MAAM,cAAc,GAAG,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;YAE1C,IAAI,cAAc,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACjB,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,GAAG,CAAE,GAAG,CAAC,GAAG,CAAe,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,CAAgB,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1G,CAAC;iBAAM,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC1C,0FAA0F;gBAC1F,sEAAsE;gBACtE,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAe,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * Recursively merge objects.\n * Array values are concatenated by default, but this is configurable.\n * Assumes that the types of any defined keys stay consistent across all objects;\n * if this isn't true, provide a `customMerge` function for that key.\n * (`customMerge` must also be used to customize merging for nested objects.)\n */\nexport function mergeObjects<T extends object>(\n  objects: T[],\n  options: {\n    /**\n     * Whether to concatenate all arrays (default) or overwrite with new values.\n     * Applies to top-level and nested objects.\n     */\n    arrayMerge?: 'concat' | 'overwrite';\n    /**\n     * Overwrite the values of these object or array keys instead of merging.\n     * Applies to the top-level object only.\n     */\n    overwriteKeys?: (keyof T)[];\n    /**\n     * Custom merging for key values. The function should return the merged value.\n     * Applies to the top-level object only.\n     */\n    customMerge?: {\n      [K in keyof T]?: (prev: T[K] | undefined, curr: T[K]) => T[K];\n    };\n  } = {},\n): T {\n  // NOTE: If other options are added, consider whether they should apply recursively,\n  // and if so, update the mergeObjects() recursive call.\n  const { customMerge, arrayMerge = 'concat', overwriteKeys } = options;\n\n  const acc = {} as T;\n\n  for (const obj of objects) {\n    if (!obj || typeof obj !== 'object') {\n      throw new Error('mergeObjects: all arguments must be objects');\n    }\n\n    for (const pair of Object.entries(obj)) {\n      const key = pair[0] as keyof T;\n      const val = pair[1] as T[typeof key];\n      const customMergeKey = customMerge?.[key];\n\n      if (customMergeKey) {\n        acc[key] = customMergeKey(acc[key], val);\n      } else if (overwriteKeys?.includes(key)) {\n        acc[key] = val;\n      } else if (Array.isArray(val)) {\n        acc[key] = arrayMerge === 'concat' ? ([...((acc[key] as unknown[]) || []), ...val] as typeof val) : val;\n      } else if (val && typeof val === 'object') {\n        // Recursively merge objects. arrayMerge makes sense to apply recursively, but customMerge\n        // and overwriteKeys are specific to the keys of the top-level object.\n        acc[key] = mergeObjects([(acc[key] || {}) as typeof val, val], { arrayMerge });\n      } else {\n        acc[key] = val;\n      }\n    }\n  }\n\n  return acc;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/package-utilities",
-  "version": "7.7.1",
+  "version": "7.8.1",
   "description": "Utilities for resolving/parsing packages and their imports.",
   "license": "MIT",
   "type": "module",
@@ -14,11 +14,11 @@
     }
   },
   "dependencies": {
-    "@ms-cloudpack/common-types": "^0.9.0",
+    "@ms-cloudpack/common-types": "^0.10.0",
     "@ms-cloudpack/json-utilities": "^0.1.4",
-    "@ms-cloudpack/package-overrides": "^0.9.6",
+    "@ms-cloudpack/package-overrides": "^0.9.8",
     "@ms-cloudpack/path-string-parsing": "^1.2.3",
-    "@ms-cloudpack/path-utilities": "^2.7.21",
+    "@ms-cloudpack/path-utilities": "^2.7.22",
     "@ms-cloudpack/task-reporter": "^0.14.1",
     "acorn": "^8.11.2",
     "acorn-walk": "^8.2.1",