@alloc/resolve.exports

An improved version of the acclaimed resolve.exports package.

• written in TypeScript
• prefer readability over code golfing
• only 50% larger than the original package (+1.5kB, unminified)
• tests use Vitest (100% test coverage)
• code formatted with Prettier

 

API differences

This package exports a resolveExports function, whose type signature is incompatible with the original resolve.exports package. A few options have been removed or renamed to better fit the needs of Vite.

This package has no legacy function export.

This package only throws errors for invalid exports syntax. It returns an empty array if no modules are matched.

Fallback arrays

To support the "fallback array" feature (useful for glob patterns), the resolveExports function will always return an array of paths. If no matches are found, the array will be empty.

Renamed options

The require was renamed to isRequire to match the resolve options used by Vite internals. This allows Vite to avoid creating a new object for every call to resolveExports.

Removed options

The unsafe and browser options have been removed. There is no way to replicate the behavior of unsafe in this package. The browser option was removed because I want to leave room for future platform conditions (beyond just browser and node).

Bug fixes

The following issues from resolve.exports are fixed by this package:

• https://github.com/lukeed/resolve.exports/issues/7
• https://github.com/lukeed/resolve.exports/issues/9
• https://github.com/lukeed/resolve.exports/issues/16
• https://github.com/lukeed/resolve.exports/issues/17
• https://github.com/lukeed/resolve.exports/issues/19

 

Type definitions

1type ExportMapping = null | string | PackageExports | readonly ExportMapping[]
2export type PackageExports = {
3  [key: string]: ExportMapping
4}
5export type PackageJson = {
6  name?: string
7  exports?: ExportMapping
8}
9export interface ResolveExports {
10  (
11    pkg: PackageJson,
12    entry: string,
13    options?: ResolveExports.Options,
14    inlineConditions?: string[]
15  ): string[]
16}
17export namespace ResolveExports {
18  export type Options = {
19    /**
20     * Custom conditions to match with.
21     *
22     * @example ['node']
23     */
24    conditions?: readonly string[]
25    /**
26     * When true, the `production` condition is used. Otherwise, the
27     * `development` condition is used.
28     */
29    isProduction?: boolean
30    /**
31     * When true, the `require` condition is used. Otherwise, the
32     * `import` condition is used.
33     */
34    isRequire?: boolean
35  }
36}