halo-fe-plugin 1.0.0

package/dist/forceAsset404.js

@@ -0,0 +1,48 @@
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * 默认的静态资源后缀列表
+ */
+const DEFAULT_EXTENSIONS = [
+    'js', 'css', 'png', 'jpg', 'jpeg', 'gif', 'svg', 'ico',
+    'json', 'woff', 'woff2', 'ttf', 'eot', 'map', 'webp',
+    'mp3', 'mp4', 'webm', 'pdf', 'zip', 'rar'
+];
+/**
+ * 强制静态资源返回 404 的 Vite 插件
+ *
+ * 解决问题：Vite SPA 模式会将不存在的静态资源也回退到 index.html
+ *
+ * @param extensions - 需要检查的文件后缀列表
+ *
+ * @example
+ * ```ts
+ * import {forceAsset404} from 'halo-fe-plugin'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), forceAsset404()]
+ * })
+ * ```
+ */
+export function forceAsset404(extensions = DEFAULT_EXTENSIONS) {
+    const extensionPattern = new RegExp(`\\.(${extensions.join('|')})$`, 'i');
+    let root;
+    return {
+        name: 'halo:force-asset-404',
+        configResolved(config) {
+            root = config.root;
+        },
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                const url = (req.url || '').split('?')[0];
+                if (extensionPattern.test(url) && !existsSync(resolve(root, 'public', url.slice(1)))) {
+                    res.statusCode = 404;
+                    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+                    res.end(`404 Not Found: ${url}`);
+                    return;
+                }
+                next();
+            });
+        }
+    };
+}

package/dist/htmlTransform.js

@@ -0,0 +1,35 @@
+/**
+ * 首页 VITE 变量替换插件
+ *
+ * 将 index.html 中的 {{VITE_XXX}} 变量替换为实际环境变量值
+ * 同时自动注入 {{VITE_RUNTIME_VERSION}} 为当前构建时间
+ *
+ * @param env - 环境变量对象
+ *
+ * @example
+ * ```ts
+ * import {htmlTransform} from 'halo-fe-plugin'
+ *
+ * export default defineConfig(({mode}) => {
+ *   const env = loadEnv(mode, process.cwd())
+ *   return {
+ *     plugins: [vue(), htmlTransform(env)]
+ *   }
+ * })
+ * ```
+ */
+export function htmlTransform(env) {
+    // 把 UTC 时间转换成东八区时间
+    const time = new Date().toLocaleString('zh-cn', { timeZone: 'Asia/Shanghai' });
+    const version = time.replace(/[/:]/g, '').replace(/ /g, '_');
+    return {
+        name: 'halo:html-transform',
+        transformIndexHtml(html) {
+            const keys = Object.keys(env);
+            for (const key of keys) {
+                html = html.replaceAll(`{{${key}}}`, env[key]);
+            }
+            return html.replace(/{{\s*VITE_RUNTIME_VERSION\s*}}/, version);
+        }
+    };
+}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Halo 前端框架 - Vite 插件集合
+ *
+ * @example
+ * ```ts
+ * import {forceAsset404, htmlTransform} from 'halo-fe-plugin'
+ * ```
+ */
+export { forceAsset404 } from './forceAsset404';
+export { htmlTransform } from './htmlTransform';

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "halo-fe-plugin",
+  "version": "1.0.0",
+  "description": "Halo 前端框架 开发服务器 插件集合",
+  "type": "module",
+  "module": "./src/index.ts",
+  "types": "./esm/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "halo-fe-plugin:install": "pnpm install",
+    "halo-fe-plugin:tsc": "vue-tsc",
+    "halo-fe-plugin:build": "tsc",
+    "halo-fe-plugin:publish": "tsc && npm publish"
+  },
+  "author": "jay.zhou <869758965@qq.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "25.2.2",
+    "typescript": "5.9.3",
+    "vite": "7.3.1",
+    "vue-tsc": "3.2.4"
+  }
+}