liferay-npm-bundler-plugin-namespace-packages
v2.32.0
Published
A liferay-npm-bundler plugin to namespace package names based on root project's name.
Downloads
29,420
Maintainers
Keywords
Readme
liferay-npm-bundler-plugin-namespace-packages
Namespace package names based on the root project's package name and version. This plugin prepends
<project-package-name>$
to each package name appearance in package.json files so that the packages are isolated per project and don't clash.
Installation
npm install --save-dev liferay-npm-bundler-plugin-inject-angular-dependencies
Usage
Add the following to your .npmbundlerrc
file:
Without options:
{
"*": {
"plugins": ["namespace-packages"]
}
}
Technical Details
This plugins rewrites package names in package.json
files to prepend the root project's name to them.
In case a module belongs to a scoped package, the root project's name is prepended to the scope name not including the @
. So, for example, @a-scope/a-package
would be converted to @my-project$a-scope/a-package
.
This plugin is normally used to sandbox dependencies of a whole project so that they are not shared with any other project. This, of course, disables the possibility of deduplication between different projects, but leads to better stability and predictability during runtime (specially when using peer dependencies).
When this plugin is used you are guaranteed that you will get the same dependencies during runtime as during development.
Please note that, if you intend to use this plugin with liferay-npm-bundler
, you should also use its counterpart babel-plugin-namespace-modules
which namespaces modules inside AMD define()
and require()
calls too.