Repository files navigation

Rollup plugin for imports resolution using enhanced Node.js algorithm.

Could be used as an alternative to bothrollup-plugin-node-resolve androllup-plugin-node-resolve-angular modules.

• Resolves imported modules usingNode.js Resolution Algorithm

• Doesn't implement the resolution on it's own, but instead delegatesthis complex task to a well supported module:browserify/resolve

• Has a well-structured architecture and doesn't mix the concepts likerollup-plugin-node-resolvedoes.Module resolution andembedding conditionals are two separate concepts

• Allows flexibility in control of which modules will be embedded and which externalizedusing glob patterns on module ids (more flexible and convenient solution)

• Supportsmain/module/es2015 fields ofpackage.jsonfor differentbuild targets

• Reliable: written in TypeScript and automatically tested

• Deduplicates dependencies by resolving symlinks in paths (useful in monorepo projects)

// rollup.config.jsimportnodeResolveNextfrom'rollup-plugin-node-resolve-next';exportdefault{input:'main.js',output:{file:'bundle.js',format:'es',},plugins:[nodeResolveNext({mode:'ESM2015',embed:{mode:'EMBED_MATCHED',patterns:['@lodash/*','tslib',],},extensions:['.js','.jsx'],}),],};

options.mode[enum/string] — controls the build target.See theBuild Targets section for more details

options.embed.mode[enum/string] — controls the module embedding mode, possible values are:

• EMBED_EVERYTHING — embeds all imported modules to the bundle
• EMBED_MATCHED — embeds only matched modules
• EMBED_UNMATCHED — embeds only non-matched modules

options.embed.patterns[Array<string>] — list of glob patterns used to configure the matching.Used only inEMBED_MATCHED andEMBED_UNMATCHED modes.

options.extensions[Array<string>] — list of allowed extensions (['.js'] by default).

options.resolveSymlinks[boolean] — Whether to resolve symlinks in the destination paths.This will help to deduplicate dependencies in monorepo projects or in projects wherenpm link is used.

The plugin supports variousmain fields frompackage.json manifestsof the imported modules for different build targets:

• InNORMAL mode only themain field is used(this is the default)
• InESM5 mode themodule field is used with fallback tomain
• InESM2015 mode thees2015 field is used with fallback tomodule ormain

—Slava Fomin II

Copyright (c) 2018—2019 Slava Fomin II

Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.