简体中文 | English
This plugin is aimed to remaining the exports from entry scripts that imported by entry HTML.
It is important for those micro frond-end project builded with ES-Module style.
Some micro frond-end framework, like IceStark, need each micro modules export two life-cycle: mount and unmount.
If entry scripts can't export those two life-cycle, the micro module would't been rendered to page.
npm i -D vite-plugin-remain-exports
yarn add -D vite-plugin-remain-exports
pnpm i -D vite-plugin-remain-exportsimport remainExports from 'vite-plugin-remain-exports'
// @see https://vitejs.dev/config/
export default defineConfig({
plugins: [
// ...other plugins
remainExports(),
],
})As follow, it is an entry html in vite project：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/src/favicon.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Vite App</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>And the entry scripts imported by entry html is /src/main.tsx.
By default, vite will transfer the entry html to the following js code:
import "vite/modulepreload-polyfill";
import "/src/main.tsx";The build process of vite is based on rollup. For the rollup project, entry html is the entry file. And in the build process, rollup will only remain the exports of entry file, then tree-shaking other depends.
So for remaining the entry scripts (main.tsx) exports, we need some magic. Here leading in a concept -- module double.
// index.ts
export * from 'another.ts'
// another.ts
export const demo = 1;For importers, index.ts and another.ts is working the same.
After introducing how entry html was handled by vite and the module double concept, we can modify the transfer result of entry html, as following:
export * from "vite/modulepreload-polyfill";
export * from "/src/main.tsx";Thus, for vite user, the entry scripts （main.tsx）work as the entry file, and the exports of them will can be remained.