# externals

Externals resolution primitives: `package.json` scanning and globals validation for IIFE / UMD bundles.

`resolveExternals({ packageJsonPath, additional, isWorkspacePackage, bundleWorkspaceDeps })` reads the project's `package.json` and combines its [`dependencies`](https://www.hyperfrontend.dev/docs/libraries/builder/models/#api-PackageJson-prop-dependencies), [`peerDependencies`](https://www.hyperfrontend.dev/docs/libraries/builder/models/#api-PackageJson-prop-peerDependencies), and the caller-supplied [`additional`](https://www.hyperfrontend.dev/docs/libraries/builder/bundle/externals/#api-ResolveExternalsOptions-prop-additional) list into a sorted, de-duplicated external list, stripping workspace-internal entries when [`bundleWorkspaceDeps`](https://www.hyperfrontend.dev/docs/libraries/builder/bundle/externals/#api-ResolveExternalsOptions-prop-bundleWorkspaceDeps) is `true`. `validateExternalsConfig(external, globals)` fails fast when an IIFE / UMD bundle declares an external package without a corresponding global variable name.

---

Canonical page: https://www.hyperfrontend.dev/docs/libraries/builder/bundle/externals/
This file: https://www.hyperfrontend.dev/docs/libraries/builder/bundle/externals.md
Documentation index: https://www.hyperfrontend.dev/llms.txt