unjs/externality

Externality

Externality is a set of utilities for handling identifying whether a given package or path should be considered an external package that can be imported at runtime, or whether is should be bundled in a build step.

It also contains a webpack and rollup plugin for encapsulating this functionality.

Install

Install using npm or yarn:

npm i externality
# or
yarn add externality

Rollup plugin

import { rollupExternals } from 'externality'

Webpack plugin

import { webpackExternals } from 'externality'

Utils

resolveId

This utility is powered by enhanced-resolve and will resolve a given module/path with support for extensions, CJS/ESM and more.

import { resolveId } from 'externality'

await resolveId('my-lib', { type: 'commonjs' })
// {
//   id: 'my-lib',
//   path: '/path/to/node_modules/my-lib/index.js',
//   type: 'commonjs'
// }

isExternal

import { isExternal } from 'externality'

await isExternal('my-lib', '.')
// {
//   id: 'my-lib',
//   external: true
// }

License

MIT

externality's Issues

issues with virtual/aliased imports

if importee is something like #build/app.vue then enhanced-resolve tries to load #build/app.vue/package.json and errors out.

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Warning

These dependencies are deprecated:

Datasource	Name	Replacement PR?
npm	@vitest/coverage-c8
npm	standard-version

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• chore(deps): replace devdependency standard-version with commit-and-tag-version ^9.5.0
• chore(deps): update all non-major dependencies (@types/node, @vitest/coverage-c8, enhanced-resolve, eslint, eslint-config-unjs, mlly, pathe, pnpm, rollup, typescript, ufo, vite, vitest, webpack)
• chore(deps): update devdependency c8 to v10
• chore(deps): update devdependency eslint to v9
• chore(deps): update devdependency vitest to v2
• chore(deps): update pnpm to v9
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

github-actions

.github/workflows/ci.yml

• actions/checkout v4
• actions/setup-node v4
• codecov/codecov-action v4

npm

package.json

• enhanced-resolve ^5.14.1
• mlly ^1.3.0
• pathe ^1.1.1
• ufo ^1.1.2
• @types/node ^20.2.5
• @vitest/coverage-c8 ^0.31.1
• allowlist ^0.1.1
• c8 ^9.1.0
• eslint ^8.41.0
• eslint-config-unjs ^0.1.0
• rollup ^4.1.4
• standard-version ^9.3.2
• typescript ^5.1.3
• unbuild ^2.0.0
• vite ^5.2.6
• vitest ^0.31.4
• webpack ^5.85.0
• pnpm 8.6.1

---

• Check this box to trigger a request for Renovate to run again on this repository