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

package/dist/config.mjs

@@ -1,2 +1,124 @@
-import { configDeploy, getJwtEnv, loadXfeConfig } from "./chunk-75BJNL7E.mjs";
-export { configDeploy, getJwtEnv, loadXfeConfig };
+// 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 BUILD_DIRECTORY_ARGUMENT = "XFE_BUILD_DIRECTORY";
+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;
+};
+var configDeploy = () => {
+  const xfeConfig = loadXfeConfig();
+  if (!xfeConfig?.deploy) return;
+  const projectRoot = process.cwd();
+  const buildDirectory = path.relative(projectRoot, getBuildDirectory(projectRoot, xfeConfig.webapp)).replaceAll(path.sep, "/");
+  const droneConfigFilePath = path.resolve(configDirectory, "../deploy/.drone.yml");
+  const droneTarget = path.resolve(projectRoot, xfeConfig.deploy.droneConfigPath || "./.drone.yml");
+  const defaultArgument = JSON.stringify(`${BUILD_DIRECTORY_ARGUMENT}=${DEFAULT_BUILD_DIRECTORY}`);
+  const configuredArgument = JSON.stringify(`${BUILD_DIRECTORY_ARGUMENT}=${buildDirectory}`);
+  const droneConfig = fs.readFileSync(droneConfigFilePath, "utf8").replace(defaultArgument, configuredArgument);
+  fs.mkdirSync(path.dirname(droneTarget), { recursive: true });
+  fs.writeFileSync(droneTarget, droneConfig);
+  const valuesYamlFilePath = path.resolve(configDirectory, "../deploy/helm/values.yaml");
+  const valuesYamlFile = fs.readFileSync(valuesYamlFilePath, "utf8");
+  const valuesYaml = yaml.parse(valuesYamlFile);
+  if (!valuesYaml.virtualService) valuesYaml.virtualService = {};
+  if (!valuesYaml.virtualService.hosts) valuesYaml.virtualService.hosts = { test: [], stage: [], prod: [] };
+  const {
+    virtualServiceEnabled = true,
+    hostsProd = [],
+    hostsStage = [],
+    hostsTest = [],
+    gateways = ["common-gateway-eshetang"]
+  } = xfeConfig.deploy;
+  const { targetK8s = "saas", targetNamespace = "" } = xfeConfig.deploy;
+  valuesYaml.virtualService.enabled = virtualServiceEnabled;
+  valuesYaml.virtualService.gateways = gateways;
+  valuesYaml.virtualService.hosts.prod = hostsProd;
+  valuesYaml.virtualService.hosts.stage = hostsStage;
+  valuesYaml.virtualService.hosts.test = hostsTest;
+  valuesYaml.targetK8s = targetK8s;
+  valuesYaml.namespace = targetNamespace;
+  const valuesYamlStr = yaml.stringify(valuesYaml, { defaultStringType: "QUOTE_SINGLE", defaultKeyType: "PLAIN" });
+  fs.writeFileSync(valuesYamlFilePath, valuesYamlStr, "utf8");
+};
+var getJwtEnv = async () => {
+  const xfeConfig = loadXfeConfig();
+  if (!xfeConfig?.jwt) return {};
+  const { aud = "" } = xfeConfig.jwt;
+  if (!aud) throw new Error("xfe.json \u4E2D\u7684 jwt \u914D\u7F6E\u4E0D\u5B8C\u6574\uFF0C\u8BF7\u786E\u4FDD\u5305\u542B aud \u5B57\u6BB5\u3002");
+  const jwkRes = await fetch(`https://app.eshetang.com/jwk?appId=${aud}`);
+  if (!jwkRes.ok) {
+    throw new Error(`\u8FDC\u7A0B\u83B7\u53D6\u5BC6\u94A5\u5931\u8D25: ${jwkRes.status} ${jwkRes.statusText}`);
+  }
+  let JwkResponseJson;
+  try {
+    JwkResponseJson = await jwkRes.json();
+  } catch (err) {
+    throw new Error(`\u8FDC\u7A0B\u83B7\u53D6\u5BC6\u94A5\u5931\u8D25\uFF0C\u54CD\u5E94\u89E3\u6790\u9519\u8BEF: ${err.message}, response text: ${await jwkRes.text()}`);
+  }
+  const { keyId, privateKeyPkcs8 } = JwkResponseJson?.data || {};
+  if (!keyId || !privateKeyPkcs8) throw new Error(`\u672A\u83B7\u53D6\u5230\u9879\u76EE\u7B7E\u540D\u5BC6\u94A5, \u8BF7\u68C0\u67E5aud\u662F\u5426\u6B63\u786E: ${aud}`);
+  return { XFE_JWT_AUD: aud, XFE_JWT_KEY_ID: keyId, XFE_JWT_PRIVATE_KEY: privateKeyPkcs8 };
+};
+export {
+  configDeploy,
+  getBuildDirectory,
+  getJwtEnv,
+  getServerEntry,
+  loadXfeConfig
+};

package/dist/framework.d.mts

@@ -0,0 +1,10 @@
+type FrameworkPaths = {
+    appDirectory: string;
+    rootDirectory: string;
+    viteConfig: string;
+    typeScriptConfig: string;
+};
+declare const getFrameworkRoot: (projectRoot: string) => string;
+declare const prepareFramework: (projectRoot?: string) => FrameworkPaths;
+
+export { type FrameworkPaths, getFrameworkRoot, prepareFramework };

package/dist/framework.d.ts

@@ -0,0 +1,10 @@
+type FrameworkPaths = {
+    appDirectory: string;
+    rootDirectory: string;
+    viteConfig: string;
+    typeScriptConfig: string;
+};
+declare const getFrameworkRoot: (projectRoot: string) => string;
+declare const prepareFramework: (projectRoot?: string) => FrameworkPaths;
+
+export { type FrameworkPaths, getFrameworkRoot, prepareFramework };

package/dist/framework.js

@@ -0,0 +1,220 @@
+"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/framework.ts
+var framework_exports = {};
+__export(framework_exports, {
+  getFrameworkRoot: () => getFrameworkRoot,
+  prepareFramework: () => prepareFramework
+});
+module.exports = __toCommonJS(framework_exports);
+var import_node_fs2 = __toESM(require("fs"));
+var import_node_module = require("module");
+var import_node_path2 = __toESM(require("path"));
+var import_node_url2 = require("url");
+
+// 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/framework.ts
+var import_meta2 = {};
+var frameworkDirectory = typeof __dirname === "string" ? __dirname : import_node_path2.default.dirname((0, import_node_url2.fileURLToPath)(import_meta2.url));
+var requireFromFramework = (0, import_node_module.createRequire)(import_node_path2.default.join(frameworkDirectory, "framework.js"));
+var extensions = [".tsx", ".ts", ".jsx", ".js"];
+var findSource = (directory, name) => extensions.map((extension) => import_node_path2.default.join(directory, `${name}${extension}`)).find(import_node_fs2.default.existsSync);
+var findValueExports = (file) => [...import_node_fs2.default.readFileSync(file, "utf8").matchAll(/^\s*export\s+(?:async\s+)?(?:const|let|var|function|class)\s+([A-Za-z_$][\w$]*)/gm)].map(
+  ([, name]) => name
+);
+var importPath = (from, target) => {
+  const relative = import_node_path2.default.relative(from, target).replace(import_node_path2.default.extname(target), "").replaceAll(import_node_path2.default.sep, "/");
+  return relative.startsWith(".") ? relative : `./${relative}`;
+};
+var writeGenerated = (file, content) => {
+  if (import_node_fs2.default.existsSync(file) && import_node_fs2.default.readFileSync(file, "utf8") === content) return;
+  import_node_fs2.default.writeFileSync(file, content);
+};
+var defaultRootSource = (projectRoot, appDirectory) => {
+  const { webapp = {} } = loadXfeConfig(projectRoot);
+  const layoutSource = findSource(import_node_path2.default.join(projectRoot, "src"), "layout");
+  const layoutExports = layoutSource ? findValueExports(layoutSource) : [];
+  const hasErrorView = layoutExports.includes("ErrorView");
+  const layoutImport = layoutSource ? `import AppLayout${hasErrorView ? ", { ErrorView }" : ""} from ${JSON.stringify(importPath(appDirectory, layoutSource))}
+` : "";
+  return `import { createElement, type ReactNode } from 'react'
+import { Outlet } from 'react-router'
+import { Document, PageError, PageLoading } from '@xfe-repo/web-app/dist/root.mjs'
+${layoutImport}
+export const meta = () => [{ title: ${JSON.stringify(webapp.title || "XFE App")} }]
+export const Layout = ({ children }: { children: ReactNode }) => createElement(Document, { children, lang: ${JSON.stringify(webapp.lang || "zh-CN")}, themeColor: ${JSON.stringify(webapp.themeColor)} })
+export default function Root() { return ${layoutSource ? "createElement(AppLayout, { children: createElement(Outlet) })" : "createElement(Outlet)"} }
+export function ErrorBoundary() { return createElement(PageError, { ${hasErrorView ? "view: ErrorView" : ""} }) }
+export function HydrateFallback() { return createElement(PageLoading) }
+`;
+};
+var getFrameworkRoot = (projectRoot) => import_node_path2.default.join(projectRoot, "node_modules/.cache/xfe-web/react-router");
+var prepareFramework = (projectRoot = process.cwd()) => {
+  const sourceDirectory = import_node_path2.default.join(projectRoot, "src");
+  const rootSource = findSource(sourceDirectory, "root");
+  const appServerSource = findSource(sourceDirectory, "app.server");
+  const pagesSource = import_node_path2.default.join(sourceDirectory, "pages");
+  if (!import_node_fs2.default.existsSync(pagesSource)) throw new Error("\u672A\u627E\u5230 src/pages");
+  const rootDirectory = getFrameworkRoot(projectRoot);
+  const appDirectory = import_node_path2.default.join(rootDirectory, "app");
+  import_node_fs2.default.mkdirSync(appDirectory, { recursive: true });
+  const routerDirectory = import_node_path2.default.dirname(requireFromFramework.resolve("react-router/package.json"));
+  const routerLink = import_node_path2.default.join(rootDirectory, "node_modules/react-router");
+  import_node_fs2.default.mkdirSync(import_node_path2.default.dirname(routerLink), { recursive: true });
+  if (!import_node_fs2.default.lstatSync(routerLink, { throwIfNoEntry: false })?.isSymbolicLink() || import_node_fs2.default.readlinkSync(routerLink) !== routerDirectory) {
+    import_node_fs2.default.rmSync(routerLink, { force: true });
+    import_node_fs2.default.symlinkSync(routerDirectory, routerLink, "junction");
+  }
+  const rootTarget = import_node_path2.default.join(appDirectory, "root.tsx");
+  const rootImport = rootSource ? importPath(appDirectory, rootSource) : "";
+  const rootExports = rootSource ? findValueExports(rootSource).filter((name) => name !== "middleware" || !appServerSource) : [];
+  const namedExports = rootExports.length ? `export { ${rootExports.join(", ")} } from ${JSON.stringify(rootImport)}
+` : "";
+  const errorBoundaryExport = rootExports.includes("ErrorBoundary") ? "" : "export { DefaultErrorBoundary as ErrorBoundary } from '@xfe-repo/web-router/errors'\n";
+  const middlewareExport = appServerSource ? `export { middleware } from ${JSON.stringify(importPath(appDirectory, appServerSource))}
+` : "";
+  writeGenerated(
+    rootTarget,
+    rootSource ? `export * from ${JSON.stringify(rootImport)}
+export { default } from ${JSON.stringify(rootImport)}
+${namedExports}${errorBoundaryExport}${middlewareExport}` : `${defaultRootSource(projectRoot, appDirectory)}${middlewareExport}`
+  );
+  const pagesLink = import_node_path2.default.join(appDirectory, "pages");
+  if (!import_node_fs2.default.existsSync(pagesLink)) import_node_fs2.default.symlinkSync(import_node_path2.default.relative(appDirectory, pagesSource), pagesLink, "dir");
+  writeGenerated(
+    import_node_path2.default.join(rootDirectory, "react-router.config.js"),
+    "export { default } from '@xfe-repo/web-app/dist/react-router-config.mjs'\n"
+  );
+  writeGenerated(
+    import_node_path2.default.join(appDirectory, "routes.js"),
+    `import { collectPageRoutes } from '@xfe-repo/web-router/routes'
+export default collectPageRoutes(${JSON.stringify(appDirectory)})
+`
+  );
+  const defaultsDirectory = import_node_path2.default.join(import_node_path2.default.dirname(requireFromFramework.resolve("@react-router/dev/package.json")), "dist/config/defaults");
+  writeGenerated(
+    import_node_path2.default.join(appDirectory, "entry.server.tsx"),
+    `export { default, streamTimeout } from ${JSON.stringify(importPath(appDirectory, import_node_path2.default.join(defaultsDirectory, "entry.server.web.tsx")))}
+`
+  );
+  const typeScriptConfig = import_node_path2.default.join(rootDirectory, "tsconfig.json");
+  writeGenerated(
+    typeScriptConfig,
+    JSON.stringify(
+      {
+        extends: import_node_path2.default.join(projectRoot, "tsconfig.json"),
+        compilerOptions: { rootDirs: [projectRoot, rootDirectory, import_node_path2.default.join(rootDirectory, ".react-router/types")] },
+        include: [
+          import_node_path2.default.join(sourceDirectory, "**/*"),
+          import_node_path2.default.join(projectRoot, "types/**/*"),
+          import_node_path2.default.join(appDirectory, "*.tsx"),
+          import_node_path2.default.join(rootDirectory, ".react-router/types/**/*")
+        ],
+        exclude: []
+      },
+      null,
+      2
+    )
+  );
+  return {
+    appDirectory,
+    rootDirectory,
+    viteConfig: import_node_path2.default.resolve(frameworkDirectory, "vite.mjs"),
+    typeScriptConfig
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getFrameworkRoot,
+  prepareFramework
+});

package/dist/framework.mjs

@@ -0,0 +1,182 @@
+// src/framework.ts
+import fs2 from "fs";
+import { createRequire } from "module";
+import path2 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// 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/framework.ts
+var frameworkDirectory = typeof __dirname === "string" ? __dirname : path2.dirname(fileURLToPath2(import.meta.url));
+var requireFromFramework = createRequire(path2.join(frameworkDirectory, "framework.js"));
+var extensions = [".tsx", ".ts", ".jsx", ".js"];
+var findSource = (directory, name) => extensions.map((extension) => path2.join(directory, `${name}${extension}`)).find(fs2.existsSync);
+var findValueExports = (file) => [...fs2.readFileSync(file, "utf8").matchAll(/^\s*export\s+(?:async\s+)?(?:const|let|var|function|class)\s+([A-Za-z_$][\w$]*)/gm)].map(
+  ([, name]) => name
+);
+var importPath = (from, target) => {
+  const relative = path2.relative(from, target).replace(path2.extname(target), "").replaceAll(path2.sep, "/");
+  return relative.startsWith(".") ? relative : `./${relative}`;
+};
+var writeGenerated = (file, content) => {
+  if (fs2.existsSync(file) && fs2.readFileSync(file, "utf8") === content) return;
+  fs2.writeFileSync(file, content);
+};
+var defaultRootSource = (projectRoot, appDirectory) => {
+  const { webapp = {} } = loadXfeConfig(projectRoot);
+  const layoutSource = findSource(path2.join(projectRoot, "src"), "layout");
+  const layoutExports = layoutSource ? findValueExports(layoutSource) : [];
+  const hasErrorView = layoutExports.includes("ErrorView");
+  const layoutImport = layoutSource ? `import AppLayout${hasErrorView ? ", { ErrorView }" : ""} from ${JSON.stringify(importPath(appDirectory, layoutSource))}
+` : "";
+  return `import { createElement, type ReactNode } from 'react'
+import { Outlet } from 'react-router'
+import { Document, PageError, PageLoading } from '@xfe-repo/web-app/dist/root.mjs'
+${layoutImport}
+export const meta = () => [{ title: ${JSON.stringify(webapp.title || "XFE App")} }]
+export const Layout = ({ children }: { children: ReactNode }) => createElement(Document, { children, lang: ${JSON.stringify(webapp.lang || "zh-CN")}, themeColor: ${JSON.stringify(webapp.themeColor)} })
+export default function Root() { return ${layoutSource ? "createElement(AppLayout, { children: createElement(Outlet) })" : "createElement(Outlet)"} }
+export function ErrorBoundary() { return createElement(PageError, { ${hasErrorView ? "view: ErrorView" : ""} }) }
+export function HydrateFallback() { return createElement(PageLoading) }
+`;
+};
+var getFrameworkRoot = (projectRoot) => path2.join(projectRoot, "node_modules/.cache/xfe-web/react-router");
+var prepareFramework = (projectRoot = process.cwd()) => {
+  const sourceDirectory = path2.join(projectRoot, "src");
+  const rootSource = findSource(sourceDirectory, "root");
+  const appServerSource = findSource(sourceDirectory, "app.server");
+  const pagesSource = path2.join(sourceDirectory, "pages");
+  if (!fs2.existsSync(pagesSource)) throw new Error("\u672A\u627E\u5230 src/pages");
+  const rootDirectory = getFrameworkRoot(projectRoot);
+  const appDirectory = path2.join(rootDirectory, "app");
+  fs2.mkdirSync(appDirectory, { recursive: true });
+  const routerDirectory = path2.dirname(requireFromFramework.resolve("react-router/package.json"));
+  const routerLink = path2.join(rootDirectory, "node_modules/react-router");
+  fs2.mkdirSync(path2.dirname(routerLink), { recursive: true });
+  if (!fs2.lstatSync(routerLink, { throwIfNoEntry: false })?.isSymbolicLink() || fs2.readlinkSync(routerLink) !== routerDirectory) {
+    fs2.rmSync(routerLink, { force: true });
+    fs2.symlinkSync(routerDirectory, routerLink, "junction");
+  }
+  const rootTarget = path2.join(appDirectory, "root.tsx");
+  const rootImport = rootSource ? importPath(appDirectory, rootSource) : "";
+  const rootExports = rootSource ? findValueExports(rootSource).filter((name) => name !== "middleware" || !appServerSource) : [];
+  const namedExports = rootExports.length ? `export { ${rootExports.join(", ")} } from ${JSON.stringify(rootImport)}
+` : "";
+  const errorBoundaryExport = rootExports.includes("ErrorBoundary") ? "" : "export { DefaultErrorBoundary as ErrorBoundary } from '@xfe-repo/web-router/errors'\n";
+  const middlewareExport = appServerSource ? `export { middleware } from ${JSON.stringify(importPath(appDirectory, appServerSource))}
+` : "";
+  writeGenerated(
+    rootTarget,
+    rootSource ? `export * from ${JSON.stringify(rootImport)}
+export { default } from ${JSON.stringify(rootImport)}
+${namedExports}${errorBoundaryExport}${middlewareExport}` : `${defaultRootSource(projectRoot, appDirectory)}${middlewareExport}`
+  );
+  const pagesLink = path2.join(appDirectory, "pages");
+  if (!fs2.existsSync(pagesLink)) fs2.symlinkSync(path2.relative(appDirectory, pagesSource), pagesLink, "dir");
+  writeGenerated(
+    path2.join(rootDirectory, "react-router.config.js"),
+    "export { default } from '@xfe-repo/web-app/dist/react-router-config.mjs'\n"
+  );
+  writeGenerated(
+    path2.join(appDirectory, "routes.js"),
+    `import { collectPageRoutes } from '@xfe-repo/web-router/routes'
+export default collectPageRoutes(${JSON.stringify(appDirectory)})
+`
+  );
+  const defaultsDirectory = path2.join(path2.dirname(requireFromFramework.resolve("@react-router/dev/package.json")), "dist/config/defaults");
+  writeGenerated(
+    path2.join(appDirectory, "entry.server.tsx"),
+    `export { default, streamTimeout } from ${JSON.stringify(importPath(appDirectory, path2.join(defaultsDirectory, "entry.server.web.tsx")))}
+`
+  );
+  const typeScriptConfig = path2.join(rootDirectory, "tsconfig.json");
+  writeGenerated(
+    typeScriptConfig,
+    JSON.stringify(
+      {
+        extends: path2.join(projectRoot, "tsconfig.json"),
+        compilerOptions: { rootDirs: [projectRoot, rootDirectory, path2.join(rootDirectory, ".react-router/types")] },
+        include: [
+          path2.join(sourceDirectory, "**/*"),
+          path2.join(projectRoot, "types/**/*"),
+          path2.join(appDirectory, "*.tsx"),
+          path2.join(rootDirectory, ".react-router/types/**/*")
+        ],
+        exclude: []
+      },
+      null,
+      2
+    )
+  );
+  return {
+    appDirectory,
+    rootDirectory,
+    viteConfig: path2.resolve(frameworkDirectory, "vite.mjs"),
+    typeScriptConfig
+  };
+};
+export {
+  getFrameworkRoot,
+  prepareFramework
+};

package/dist/node-dev.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/node-dev.d.ts

@@ -0,0 +1,2 @@
+
+export {  }