unplugin-package
v1.3.0
Published
Bundler plugins for copying manifest files into output.
Maintainers
Readme
Unplugin Package
用于将静态资源文件从根目录复制到输出目录的通用插件(unplugin),常用于打包和发布NPM库时将所有需要打包的内容输出到Git忽略的输出目录,以避免复杂的.npmignore等配置的使用场景,也适合用于精简VSCode等扩展的打包体积。
使用方法
- 此库仅支持ESModule(esm),不支持CommonJS(cjs)。
- 具体配置直接读相关文档注释。本库很简单,推荐直接读源码。
- 可参考
example目录下的例子。
import unpluginPackage from "unplugin-package"
unpluginPackage.vite() // 作为vite插件使用
unpluginPackage.rollup() // 作为rollup插件使用
unpluginPackage.rolldown() // 作为rolldown插件使用
unpluginPackage.webpack() // 作为webpack插件使用
unpluginPackage.rspack() // 作为rspack插件使用
unpluginPackage.esbuild() // 作为esbuild插件使用
unpluginPackage.farm() // 作为farm插件使用举例说明
import { join } from "node:path"
const root = import.meta.dirname
const outdir = join(root, "out")
// 将这里的xxx替换为具体的bundler名称,如vite、rollup、rolldown等。
unpluginPackage.xxx({
root,
outdir,
emptyOutdir: true,
copyFiles: [...defaultFilesToCopy, "addition-file", "not-exist-file"],
manifestOverride(raw) {
const manifest = defaultManifestOverride(raw)
manifest["homepage"] = "https://yourproject.example.com/xxx"
return manifest
},
})