@minar-kotonoha/vite-plugin-bootstrap 0.1.1

package/README.md

@@ -0,0 +1,34 @@
+# @minar-kotonoha/vite-plugin-bootstrap
+
+虚拟模块 `virtual:bootstrap` — 自动发现项目的 `index.ts` 默认导出，将 Vue App 实例作为参数传入。
+
+## 用法
+
+```ts
+// vite.config.ts
+import { bootstrapPlugin } from '@minar-kotonoha/vite-plugin-bootstrap'
+
+export default defineConfig({
+  plugins: [bootstrapPlugin()]  // 默认读取项目根 index.ts
+})
+```
+
+可通过 `entryFile` 参数指定自定义启动入口：
+
+```ts
+plugins: [bootstrapPlugin('app.ts')]  // 读取 app.ts 而非 index.ts
+```
+
+在项目根目录的入口文件（默认 `index.ts`）中：
+
+```ts
+import type { App } from 'vue'
+import type { Router } from 'vue-router'
+
+export default (app: App, router: Router) => {
+  // 在此处初始化你的应用
+  app.use(createPinia())
+}
+```
+
+插件会将 `virtual:bootstrap` 解析为该默认导出，这样 `template/main.ts` 就可以通过 `import { bootstrap } from 'virtual:bootstrap'` 加载，无需硬编码项目路径。

package/index.ts

@@ -0,0 +1,32 @@
+import { resolve } from 'node:path'
+import { exists } from 'fs-extra'
+import type { PluginOption } from 'vite'
+
+const virtualModuleId = 'virtual:bootstrap'
+
+/**
+ * virtual:bootstrap 插件
+ *
+ * 搜索项目根目录的启动文件（默认 index.ts）的默认导出，
+ * 将 Vue App 实例作为参数传入。
+ *
+ * @param entryFile 启动入口文件名（相对于 cwd），默认 'index.ts'
+ */
+export function bootstrapPlugin(entryFile?: string) {
+  const entry = entryFile || 'index.ts'
+  return {
+    name: '@minar-kotonoha/vite-plugin-bootstrap',
+    resolveId(id: string, importer: string | undefined) {
+      if (importer && id === virtualModuleId) {
+        return `\0${id}`
+      }
+    },
+    load: async (id: string) => {
+      if (id.startsWith(`\0${virtualModuleId}`)) {
+        return (await exists(resolve(process.cwd(), entry)))
+          ? `import * as Index from '@/index';export const bootstrap = Index.default ?? (() => {});`
+          : `export const bootstrap = () =>{};`
+      }
+    },
+  } satisfies PluginOption
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@minar-kotonoha/vite-plugin-bootstrap",
+  "version": "0.1.1",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "vite": "catalog:"
+  },
+  "dependencies": {
+    "fs-extra": "^11.3.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "strict": true,
+    "types": ["node"]
+  },
+  "include": ["index.ts"]
+}