@xfe-repo/web-app 1.6.4 → 2.0.0-beta.2

package/dist/root.mjs

@@ -0,0 +1,34 @@
+// src/root.tsx
+import { createElement } from "react";
+import { Links, Meta, Scripts, ScrollRestoration, useRouteError } from "react-router";
+import { DefaultErrorBoundary } from "@xfe-repo/web-router/errors";
+import { jsx, jsxs } from "react/jsx-runtime";
+function PageLoading() {
+  return /* @__PURE__ */ jsx("main", { role: "status", "aria-live": "polite", children: "\u6B63\u5728\u52A0\u8F7D\u9875\u9762\u2026" });
+}
+function Document({ children, lang = "zh-CN", themeColor }) {
+  return /* @__PURE__ */ jsxs("html", { lang, children: [
+    /* @__PURE__ */ jsxs("head", { children: [
+      /* @__PURE__ */ jsx("meta", { charSet: "utf-8" }),
+      /* @__PURE__ */ jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
+      themeColor && /* @__PURE__ */ jsx("meta", { name: "theme-color", content: themeColor }),
+      /* @__PURE__ */ jsx(Meta, {}),
+      /* @__PURE__ */ jsx(Links, {})
+    ] }),
+    /* @__PURE__ */ jsxs("body", { children: [
+      /* @__PURE__ */ jsx("noscript", { children: "\u8BF7\u5141\u8BB8 JavaScript \u8FD0\u884C\u3002" }),
+      children,
+      /* @__PURE__ */ jsx(ScrollRestoration, {}),
+      /* @__PURE__ */ jsx(Scripts, {})
+    ] })
+  ] });
+}
+function PageError({ view }) {
+  const error = useRouteError();
+  return view ? createElement(view, { error }) : createElement(DefaultErrorBoundary);
+}
+export {
+  Document,
+  PageError,
+  PageLoading
+};

package/dist/serve.d.mts

@@ -0,0 +1,10 @@
+import * as http from 'http';
+
+declare const serveClient: ({ directory, host, port, basename, }: {
+    directory: string;
+    host: string;
+    port: number;
+    basename?: string;
+}) => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+
+export { serveClient };

package/dist/serve.d.ts

@@ -0,0 +1,10 @@
+import * as http from 'http';
+
+declare const serveClient: ({ directory, host, port, basename, }: {
+    directory: string;
+    host: string;
+    port: number;
+    basename?: string;
+}) => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+
+export { serveClient };

package/dist/serve.js

@@ -0,0 +1,71 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/serve.ts
+var serve_exports = {};
+__export(serve_exports, {
+  serveClient: () => serveClient
+});
+module.exports = __toCommonJS(serve_exports);
+var import_node_fs = require("fs");
+var import_node_path = __toESM(require("path"));
+var import_express = __toESM(require("express"));
+var serveClient = ({
+  directory,
+  host,
+  port,
+  basename = "/"
+}) => {
+  const indexFile = import_node_path.default.join(directory, "index.html");
+  if (!(0, import_node_fs.existsSync)(indexFile)) throw new Error(`\u672A\u627E\u5230 SPA \u5165\u53E3 ${indexFile}\uFF0C\u8BF7\u5148\u6267\u884C xfe-web build`);
+  const app = (0, import_express.default)().disable("x-powered-by");
+  const router = import_express.default.Router();
+  app.use((_request, response, next) => {
+    response.setHeader("Access-Control-Allow-Origin", "*");
+    next();
+  });
+  app.use(
+    "/assets",
+    import_express.default.static(import_node_path.default.join(directory, "assets"), { immutable: true, maxAge: "1y" }),
+    (_request, response) => response.status(404).end()
+  );
+  app.use(import_express.default.static(directory));
+  router.get("/{*path}", (_request, response) => response.sendFile(indexFile));
+  app.use(basename, router);
+  const server = app.listen(port, host);
+  server.once("listening", () => {
+    const address = server.address();
+    console.log(`[xfe-web] SPA http://${host}:${typeof address === "object" && address ? address.port : port}${basename}`);
+  });
+  return server;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  serveClient
+});

package/dist/serve.mjs

@@ -0,0 +1,36 @@
+// src/serve.ts
+import { existsSync } from "fs";
+import path from "path";
+import express from "express";
+var serveClient = ({
+  directory,
+  host,
+  port,
+  basename = "/"
+}) => {
+  const indexFile = path.join(directory, "index.html");
+  if (!existsSync(indexFile)) throw new Error(`\u672A\u627E\u5230 SPA \u5165\u53E3 ${indexFile}\uFF0C\u8BF7\u5148\u6267\u884C xfe-web build`);
+  const app = express().disable("x-powered-by");
+  const router = express.Router();
+  app.use((_request, response, next) => {
+    response.setHeader("Access-Control-Allow-Origin", "*");
+    next();
+  });
+  app.use(
+    "/assets",
+    express.static(path.join(directory, "assets"), { immutable: true, maxAge: "1y" }),
+    (_request, response) => response.status(404).end()
+  );
+  app.use(express.static(directory));
+  router.get("/{*path}", (_request, response) => response.sendFile(indexFile));
+  app.use(basename, router);
+  const server = app.listen(port, host);
+  server.once("listening", () => {
+    const address = server.address();
+    console.log(`[xfe-web] SPA http://${host}:${typeof address === "object" && address ? address.port : port}${basename}`);
+  });
+  return server;
+};
+export {
+  serveClient
+};

package/dist/vite.d.mts

@@ -0,0 +1,10 @@
+import * as vite from 'vite';
+
+declare const adaptPageRoute: (code: string, options: string | {
+    id: string;
+    clientOnly?: boolean;
+}) => string | undefined;
+/** Node 入口按 basename 托管前端，构建与开发必须生成相同前缀的资源 URL。 */
+declare const _default: vite.UserConfigFnObject;
+
+export { adaptPageRoute, _default as default };

package/dist/vite.d.ts

@@ -0,0 +1,10 @@
+import * as vite from 'vite';
+
+declare const adaptPageRoute: (code: string, options: string | {
+    id: string;
+    clientOnly?: boolean;
+}) => string | undefined;
+/** Node 入口按 basename 托管前端，构建与开发必须生成相同前缀的资源 URL。 */
+declare const _default: vite.UserConfigFnObject;
+
+export { adaptPageRoute, _default as default };

package/dist/vite.js

@@ -0,0 +1,182 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  adaptPageRoute: () => adaptPageRoute,
+  default: () => vite_default
+});
+module.exports = __toCommonJS(vite_exports);
+var import_node_path2 = __toESM(require("path"));
+var import_node_fs2 = require("fs");
+var import_vite = require("@react-router/dev/vite");
+var import_vite2 = require("vite");
+
+// src/config.ts
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = __toESM(require("path"));
+var import_node_url = require("url");
+var import_yaml = __toESM(require("yaml"));
+var import_meta = {};
+var DEFAULT_BUILD_DIRECTORY = "dist";
+var protectedDirectories = /* @__PURE__ */ new Set(["src", "types", "public", "node_modules", ".git"]);
+var configDirectory = typeof __dirname === "string" ? __dirname : import_node_path.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url));
+var loadXfeConfig = (root = process.cwd()) => {
+  const xfeConfigPath = import_node_path.default.join(root, "xfe.json");
+  if (!import_node_fs.default.existsSync(xfeConfigPath)) {
+    throw new Error("xfe.json \u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5728\u9879\u76EE\u6839\u76EE\u5F55\u4E0B\u521B\u5EFA\u8BE5\u6587\u4EF6\u3002");
+  }
+  const xfeConfigContent = import_node_fs.default.readFileSync(xfeConfigPath, "utf8");
+  const config = JSON.parse(xfeConfigContent);
+  const renderMode = config.webapp?.renderMode;
+  if (renderMode !== void 0 && renderMode !== "client" && renderMode !== "server") {
+    throw new Error("xfe.json.webapp.renderMode \u53EA\u80FD\u4E3A client \u6216 server");
+  }
+  getBuildDirectory(root, config.webapp);
+  getServerEntry(root, config.webapp);
+  return config;
+};
+var getBuildDirectory = (projectRoot, webapp = {}) => {
+  const configured = webapp?.buildDirectory === void 0 ? DEFAULT_BUILD_DIRECTORY : webapp.buildDirectory;
+  if (typeof configured !== "string" || !configured.trim() || /[\0\r\n]/.test(configured)) {
+    throw new Error("xfe.json.webapp.buildDirectory \u5FC5\u987B\u662F\u975E\u7A7A\u7684\u5355\u884C\u5B57\u7B26\u4E32");
+  }
+  const directory = configured.trim().replaceAll("\\", "/");
+  const root = import_node_path.default.resolve(projectRoot);
+  const output = import_node_path.default.resolve(root, directory);
+  const relative = import_node_path.default.relative(root, output);
+  const [firstDirectory = ""] = relative.split(import_node_path.default.sep);
+  const escapesProject = import_node_path.default.isAbsolute(directory) || Boolean(import_node_path.default.win32.parse(directory).root) || firstDirectory === "..";
+  const overwritesInput = !relative || protectedDirectories.has(firstDirectory.toLowerCase());
+  if (escapesProject || overwritesInput) {
+    throw new Error("xfe.json.webapp.buildDirectory \u5FC5\u987B\u662F\u9879\u76EE\u5185\u72EC\u7ACB\u7684\u8F93\u51FA\u76EE\u5F55\uFF0C\u4E0D\u80FD\u8986\u76D6\u9879\u76EE\u3001\u6E90\u7801\u6216\u4F9D\u8D56");
+  }
+  let currentDirectory = root;
+  for (const segment of relative.split(import_node_path.default.sep)) {
+    currentDirectory = import_node_path.default.join(currentDirectory, segment);
+    if (import_node_fs.default.lstatSync(currentDirectory, { throwIfNoEntry: false })?.isSymbolicLink()) {
+      throw new Error("xfe.json.webapp.buildDirectory \u4E0D\u80FD\u7ECF\u8FC7\u7B26\u53F7\u94FE\u63A5\uFF0C\u4EE5\u514D\u6E05\u7406\u5176\u4ED6\u76EE\u5F55");
+    }
+  }
+  return output;
+};
+var getServerEntry = (projectRoot, webapp = {}) => {
+  const entry = webapp?.serverEntry;
+  if (entry === void 0) return;
+  if (typeof entry !== "string" || !entry.trim() || /[\0\r\n]/.test(entry)) {
+    throw new Error("xfe.json.webapp.serverEntry \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684 TypeScript / JavaScript \u76F8\u5BF9\u8DEF\u5F84");
+  }
+  const normalized = entry.trim().replaceAll("\\", "/");
+  const absolute = import_node_path.default.resolve(projectRoot, normalized);
+  const relative = import_node_path.default.relative(import_node_path.default.resolve(projectRoot), absolute);
+  const outside = Boolean(import_node_path.default.win32.parse(normalized).root) || relative.split(import_node_path.default.sep)[0] === "..";
+  if (outside || !/\.(?:[jt]sx?|m[jt]s)$/.test(relative)) {
+    throw new Error("xfe.json.webapp.serverEntry \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684 TypeScript / JavaScript \u76F8\u5BF9\u8DEF\u5F84");
+  }
+  return absolute;
+};
+
+// src/vite.ts
+var chromeDevToolsConfigPath = "/.well-known/appspecific/com.chrome.devtools.json";
+var adaptPageRoute = (code, options) => {
+  const { id, clientOnly = false } = typeof options === "string" ? { id: options } : options;
+  if (!/[\\/]pages[\\/].+\.(?:jsx?|tsx?)$/.test(id) || !/^\s*export\s+const\s+page\s*=/m.test(code)) return;
+  const fallback = clientOnly ? "" : "export const HydrateFallback = page.HydrateFallback\n";
+  return `${code}
+export default page.Component
+export const clientLoader = page.clientLoader
+${fallback}export const ErrorBoundary = page.ErrorBoundary
+export const meta = page.meta
+`;
+};
+var frameworkPlugin = (clientOnly) => ({
+  name: "xfe:framework",
+  enforce: "pre",
+  configureServer(server) {
+    server.middlewares.use(chromeDevToolsConfigPath, (_request, response) => response.writeHead(404).end());
+  },
+  transform(code, id) {
+    return adaptPageRoute(code, { id, clientOnly });
+  }
+});
+var vite_default = (0, import_vite2.defineConfig)(({ mode }) => {
+  const projectRoot = process.env.XFE_WEB_ROOT;
+  if (!projectRoot) throw new Error("\u7F3A\u5C11 XFE_WEB_ROOT\uFF0CVite \u5FC5\u987B\u901A\u8FC7 xfe-web \u542F\u52A8");
+  const env = (0, import_vite2.loadEnv)(mode, projectRoot, "");
+  const { webapp = {} } = loadXfeConfig(projectRoot);
+  const publicEnv = (key) => process.env[key] || env[key] || "";
+  return {
+    ...webapp.serverEntry ? { base: import_node_path2.default.posix.join(webapp.basename || "/", "/") } : {},
+    plugins: [frameworkPlugin(webapp.renderMode === "client"), (0, import_vite.reactRouter)()],
+    build: { emptyOutDir: true },
+    envDir: projectRoot,
+    envPrefix: ["VITE_", "REACT_APP_"],
+    publicDir: import_node_path2.default.join(projectRoot, "public"),
+    define: {
+      "import.meta.env.XFE_JWT_AUD": JSON.stringify(publicEnv("XFE_JWT_AUD")),
+      "import.meta.env.XFE_JWT_KEY_ID": JSON.stringify(publicEnv("XFE_JWT_KEY_ID")),
+      "process.env.REACT_APP_RELEASE": JSON.stringify(publicEnv("REACT_APP_RELEASE")),
+      "process.env.REACT_APP_API_ENV": JSON.stringify(publicEnv("REACT_APP_API_ENV")),
+      "process.env.REACT_APP_BUSINESS": JSON.stringify(publicEnv("REACT_APP_BUSINESS")),
+      "process.env.XFE_JWT_AUD": JSON.stringify(publicEnv("XFE_JWT_AUD")),
+      "process.env.XFE_JWT_KEY_ID": JSON.stringify(publicEnv("XFE_JWT_KEY_ID")),
+      "process.env.XFE_JWT_PRIVATE_KEY": "undefined"
+    },
+    css: {
+      preprocessorOptions: {
+        less: {
+          javascriptEnabled: true,
+          paths: [import_node_path2.default.join(projectRoot, "src")]
+        }
+      }
+    },
+    resolve: {
+      tsconfigPaths: true,
+      // workspace 和本地框架链接均使用消费应用的 React 与状态管理实例。
+      dedupe: ["react", "react-dom", "react-redux", "@reduxjs/toolkit"].filter(
+        (name) => (0, import_node_fs2.existsSync)(import_node_path2.default.join(projectRoot, "node_modules", name))
+      )
+    },
+    ssr: {
+      // 路由属于框架内部依赖，SSR/SPA 预渲染产物也不能要求业务项目直接安装它。
+      noExternal: ["react-router", "isbot", /^@xfe-repo\/web-/, /^@ant-design\//, /^@emotion\//, /^@rc-component\//, /^rc-/, "antd"]
+    },
+    server: {
+      cors: true,
+      fs: { allow: [projectRoot] },
+      host: env.HOST || webapp.host || "0.0.0.0",
+      port: Number(env.PORT || webapp.port) || 3e3
+    }
+  };
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  adaptPageRoute
+});

package/dist/vite.mjs

@@ -0,0 +1,146 @@
+// src/vite.ts
+import path2 from "path";
+import { existsSync } from "fs";
+import { reactRouter } from "@react-router/dev/vite";
+import { defineConfig, loadEnv } from "vite";
+
+// src/config.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import yaml from "yaml";
+var DEFAULT_BUILD_DIRECTORY = "dist";
+var protectedDirectories = /* @__PURE__ */ new Set(["src", "types", "public", "node_modules", ".git"]);
+var configDirectory = typeof __dirname === "string" ? __dirname : path.dirname(fileURLToPath(import.meta.url));
+var loadXfeConfig = (root = process.cwd()) => {
+  const xfeConfigPath = path.join(root, "xfe.json");
+  if (!fs.existsSync(xfeConfigPath)) {
+    throw new Error("xfe.json \u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5728\u9879\u76EE\u6839\u76EE\u5F55\u4E0B\u521B\u5EFA\u8BE5\u6587\u4EF6\u3002");
+  }
+  const xfeConfigContent = fs.readFileSync(xfeConfigPath, "utf8");
+  const config = JSON.parse(xfeConfigContent);
+  const renderMode = config.webapp?.renderMode;
+  if (renderMode !== void 0 && renderMode !== "client" && renderMode !== "server") {
+    throw new Error("xfe.json.webapp.renderMode \u53EA\u80FD\u4E3A client \u6216 server");
+  }
+  getBuildDirectory(root, config.webapp);
+  getServerEntry(root, config.webapp);
+  return config;
+};
+var getBuildDirectory = (projectRoot, webapp = {}) => {
+  const configured = webapp?.buildDirectory === void 0 ? DEFAULT_BUILD_DIRECTORY : webapp.buildDirectory;
+  if (typeof configured !== "string" || !configured.trim() || /[\0\r\n]/.test(configured)) {
+    throw new Error("xfe.json.webapp.buildDirectory \u5FC5\u987B\u662F\u975E\u7A7A\u7684\u5355\u884C\u5B57\u7B26\u4E32");
+  }
+  const directory = configured.trim().replaceAll("\\", "/");
+  const root = path.resolve(projectRoot);
+  const output = path.resolve(root, directory);
+  const relative = path.relative(root, output);
+  const [firstDirectory = ""] = relative.split(path.sep);
+  const escapesProject = path.isAbsolute(directory) || Boolean(path.win32.parse(directory).root) || firstDirectory === "..";
+  const overwritesInput = !relative || protectedDirectories.has(firstDirectory.toLowerCase());
+  if (escapesProject || overwritesInput) {
+    throw new Error("xfe.json.webapp.buildDirectory \u5FC5\u987B\u662F\u9879\u76EE\u5185\u72EC\u7ACB\u7684\u8F93\u51FA\u76EE\u5F55\uFF0C\u4E0D\u80FD\u8986\u76D6\u9879\u76EE\u3001\u6E90\u7801\u6216\u4F9D\u8D56");
+  }
+  let currentDirectory = root;
+  for (const segment of relative.split(path.sep)) {
+    currentDirectory = path.join(currentDirectory, segment);
+    if (fs.lstatSync(currentDirectory, { throwIfNoEntry: false })?.isSymbolicLink()) {
+      throw new Error("xfe.json.webapp.buildDirectory \u4E0D\u80FD\u7ECF\u8FC7\u7B26\u53F7\u94FE\u63A5\uFF0C\u4EE5\u514D\u6E05\u7406\u5176\u4ED6\u76EE\u5F55");
+    }
+  }
+  return output;
+};
+var getServerEntry = (projectRoot, webapp = {}) => {
+  const entry = webapp?.serverEntry;
+  if (entry === void 0) return;
+  if (typeof entry !== "string" || !entry.trim() || /[\0\r\n]/.test(entry)) {
+    throw new Error("xfe.json.webapp.serverEntry \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684 TypeScript / JavaScript \u76F8\u5BF9\u8DEF\u5F84");
+  }
+  const normalized = entry.trim().replaceAll("\\", "/");
+  const absolute = path.resolve(projectRoot, normalized);
+  const relative = path.relative(path.resolve(projectRoot), absolute);
+  const outside = Boolean(path.win32.parse(normalized).root) || relative.split(path.sep)[0] === "..";
+  if (outside || !/\.(?:[jt]sx?|m[jt]s)$/.test(relative)) {
+    throw new Error("xfe.json.webapp.serverEntry \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684 TypeScript / JavaScript \u76F8\u5BF9\u8DEF\u5F84");
+  }
+  return absolute;
+};
+
+// src/vite.ts
+var chromeDevToolsConfigPath = "/.well-known/appspecific/com.chrome.devtools.json";
+var adaptPageRoute = (code, options) => {
+  const { id, clientOnly = false } = typeof options === "string" ? { id: options } : options;
+  if (!/[\\/]pages[\\/].+\.(?:jsx?|tsx?)$/.test(id) || !/^\s*export\s+const\s+page\s*=/m.test(code)) return;
+  const fallback = clientOnly ? "" : "export const HydrateFallback = page.HydrateFallback\n";
+  return `${code}
+export default page.Component
+export const clientLoader = page.clientLoader
+${fallback}export const ErrorBoundary = page.ErrorBoundary
+export const meta = page.meta
+`;
+};
+var frameworkPlugin = (clientOnly) => ({
+  name: "xfe:framework",
+  enforce: "pre",
+  configureServer(server) {
+    server.middlewares.use(chromeDevToolsConfigPath, (_request, response) => response.writeHead(404).end());
+  },
+  transform(code, id) {
+    return adaptPageRoute(code, { id, clientOnly });
+  }
+});
+var vite_default = defineConfig(({ mode }) => {
+  const projectRoot = process.env.XFE_WEB_ROOT;
+  if (!projectRoot) throw new Error("\u7F3A\u5C11 XFE_WEB_ROOT\uFF0CVite \u5FC5\u987B\u901A\u8FC7 xfe-web \u542F\u52A8");
+  const env = loadEnv(mode, projectRoot, "");
+  const { webapp = {} } = loadXfeConfig(projectRoot);
+  const publicEnv = (key) => process.env[key] || env[key] || "";
+  return {
+    ...webapp.serverEntry ? { base: path2.posix.join(webapp.basename || "/", "/") } : {},
+    plugins: [frameworkPlugin(webapp.renderMode === "client"), reactRouter()],
+    build: { emptyOutDir: true },
+    envDir: projectRoot,
+    envPrefix: ["VITE_", "REACT_APP_"],
+    publicDir: path2.join(projectRoot, "public"),
+    define: {
+      "import.meta.env.XFE_JWT_AUD": JSON.stringify(publicEnv("XFE_JWT_AUD")),
+      "import.meta.env.XFE_JWT_KEY_ID": JSON.stringify(publicEnv("XFE_JWT_KEY_ID")),
+      "process.env.REACT_APP_RELEASE": JSON.stringify(publicEnv("REACT_APP_RELEASE")),
+      "process.env.REACT_APP_API_ENV": JSON.stringify(publicEnv("REACT_APP_API_ENV")),
+      "process.env.REACT_APP_BUSINESS": JSON.stringify(publicEnv("REACT_APP_BUSINESS")),
+      "process.env.XFE_JWT_AUD": JSON.stringify(publicEnv("XFE_JWT_AUD")),
+      "process.env.XFE_JWT_KEY_ID": JSON.stringify(publicEnv("XFE_JWT_KEY_ID")),
+      "process.env.XFE_JWT_PRIVATE_KEY": "undefined"
+    },
+    css: {
+      preprocessorOptions: {
+        less: {
+          javascriptEnabled: true,
+          paths: [path2.join(projectRoot, "src")]
+        }
+      }
+    },
+    resolve: {
+      tsconfigPaths: true,
+      // workspace 和本地框架链接均使用消费应用的 React 与状态管理实例。
+      dedupe: ["react", "react-dom", "react-redux", "@reduxjs/toolkit"].filter(
+        (name) => existsSync(path2.join(projectRoot, "node_modules", name))
+      )
+    },
+    ssr: {
+      // 路由属于框架内部依赖，SSR/SPA 预渲染产物也不能要求业务项目直接安装它。
+      noExternal: ["react-router", "isbot", /^@xfe-repo\/web-/, /^@ant-design\//, /^@emotion\//, /^@rc-component\//, /^rc-/, "antd"]
+    },
+    server: {
+      cors: true,
+      fs: { allow: [projectRoot] },
+      host: env.HOST || webapp.host || "0.0.0.0",
+      port: Number(env.PORT || webapp.port) || 3e3
+    }
+  };
+});
+export {
+  adaptPageRoute,
+  vite_default as default
+};

package/package.json

@@ -1,90 +1,44 @@
 {
   "name": "@xfe-repo/web-app",
-  "version": "1.6.4",
+  "version": "2.0.0-beta.2",
   "bin": {
     "xfe-web": "./bin/index.js"
   },
   "files": [
     "dist",
     "bin",
-    "config",
     "deploy",
-    "scripts",
     "tsconfig.json",
+    "client.d.ts",
     ".eslintrc.js"
   ],
+  "engines": {
+    "node": ">=22.22.0"
+  },
   "dependencies": {
-    "@babel/core": "^7.16.0",
-    "@babel/plugin-transform-private-property-in-object": "^7.21.11",
-    "@loadable/babel-plugin": "^5.15.3",
-    "@loadable/webpack-plugin": "^5.15.2",
-    "@pmmmwh/react-refresh-webpack-plugin": "^0.5.3",
-    "@svgr/webpack": "^5.5.0",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/minimist": "^1.2.5",
-    "@types/node": "^20.17.0",
-    "@types/react": "^18.0.0",
-    "babel-jest": "^30.2.0",
-    "babel-loader": "^8.2.3",
-    "babel-plugin-named-asset-import": "^0.3.8",
-    "babel-preset-react-app": "^10.0.1",
-    "bfj": "^7.0.2",
-    "browserslist": "^4.18.1",
-    "camelcase": "^6.2.1",
-    "case-sensitive-paths-webpack-plugin": "^2.4.0",
-    "css-loader": "^6.5.1",
-    "css-minimizer-webpack-plugin": "^3.2.0",
-    "dotenv": "^10.0.0",
-    "dotenv-expand": "^5.1.0",
-    "eslint": "8.57.1",
-    "eslint-config-react-app": "^7.0.1",
-    "eslint-webpack-plugin": "^3.1.1",
-    "file-loader": "^6.2.0",
-    "fs-extra": "^10.0.0",
-    "html-webpack-plugin": "^5.5.0",
-    "husky": "^9.1.6",
-    "identity-obj-proxy": "^3.0.0",
-    "ignore-loader": "^0.1.2",
-    "jest": "^30.2.0",
-    "jest-resolve": "^30.2.0",
-    "jest-watch-typeahead": "^3.0.1",
+    "@react-router/dev": "8.3.0",
+    "@react-router/express": "8.3.0",
+    "@react-router/serve": "8.3.0",
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.27.7",
+    "express": "5.2.1",
+    "isbot": "^5.1.36",
     "less": "^4.1.3",
-    "less-loader": "^11.1.0",
-    "mini-css-extract-plugin": "^2.4.5",
-    "minimist": "^1.2.8",
-    "nodemon": "^2.0.22",
-    "postcss": "^8.4.4",
-    "postcss-flexbugs-fixes": "^5.0.2",
-    "postcss-loader": "^6.2.1",
-    "postcss-normalize": "^10.0.1",
-    "postcss-preset-env": "^7.0.1",
-    "prompts": "^2.4.2",
-    "react-app-polyfill": "^3.0.0",
-    "react-dev-utils": "^12.0.1",
-    "react-refresh": "^0.11.0",
-    "resolve": "^1.20.0",
-    "resolve-url-loader": "^4.0.0",
-    "sass-loader": "^12.3.0",
-    "semver": "^7.3.5",
-    "source-map-loader": "^3.0.0",
-    "style-loader": "^3.3.1",
-    "tailwindcss": "^3.0.2",
-    "terser-webpack-plugin": "^5.2.5",
-    "web-vitals": "^2.1.4",
-    "webpack": "~5.64.4",
-    "webpack-bundle-analyzer": "^4.8.0",
-    "webpack-dev-server": "^4.6.0",
-    "webpack-manifest-plugin": "^4.0.2",
-    "workbox-webpack-plugin": "^7.0.0",
-    "yaml": "^2.3.4",
-    "@xfe-repo/typescript-config": "1.6.2",
-    "@xfe-repo/eslint-config": "1.6.0"
+    "react-router": "8.3.0",
+    "typescript": "~5.9.3",
+    "vite": "^8.2.1",
+    "yaml": "^2.4.2",
+    "tsx": "4.23.15",
+    "@xfe-repo/eslint-config": "2.0.0-beta.1",
+    "@xfe-repo/web-router": "2.0.0-beta.1",
+    "@xfe-repo/typescript-config": "2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/express": "5.0.6"
   },
   "peerDependencies": {
-    "react": "18.2.0",
-    "react-dom": "18.2.0"
+    "react": ">=19.2.7",
+    "react-dom": ">=19.2.7"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -93,6 +47,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "lint": "eslint \"src/**/*.ts*\" --fix",
-    "clean": "rm -rf .turbo coverage dist node_modules"
+    "clean": "rm -rf .turbo coverage dist node_modules",
+    "test": "pnpm build && node --test test/*.test.cjs"
   }
 }

package/tsconfig.json

@@ -1,11 +1,14 @@
 {
   "extends": "@xfe-repo/typescript-config/react.json",
   "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["node"],
     "paths": {
       "@/*": ["./*"],
       "@/types/*": ["../types/*"],
       "@common/services": ["../node_modules/@xfe-repo/web-service/dist/index"]
     }
   },
-  "exclude": ["node_modules", "build", "dist"]
+  "exclude": ["node_modules", "build", "dist", ".react-router"]
 }