@uni-helper/vite-plugin-uni-pages 0.3.23 → 0.4.0

package/dist/index.cjs

@@ -1,91 +1,111 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-const path = require('node:path');
-const process = require('node:process');
-const astKit = require('ast-kit');
-const chokidar = require('chokidar');
-const kolorist = require('kolorist');
-const MagicString = require('magic-string');
-const vite = require('vite');
-const fs = require('node:fs');
-const uniEnv = require('@uni-helper/uni-env');
-const commentJson = require('comment-json');
-const Debug = require('debug');
-const detectIndent = require('detect-indent');
-const detectNewline = require('detect-newline');
-const unconfig = require('unconfig');
-const promises = require('node:fs/promises');
-const fg = require('fast-glob');
-const lockfile = require('proper-lockfile');
-const writeFileAtomic = require('write-file-atomic');
-const node_module = require('node:module');
-const vm = require('node:vm');
-const babelGenerator = require('@babel/generator');
-const groupBy = require('lodash.groupby');
-const ts = require('typescript');
-const t = require('@babel/types');
-const compilerSfc = require('@vue/compiler-sfc');
-const JSON5 = require('json5');
-const yaml = require('yaml');
-
-function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
-
-function _interopNamespaceCompat(e) {
-  if (e && typeof e === 'object' && 'default' in e) return e;
-  const n = Object.create(null);
-  if (e) {
-    for (const k in e) {
-      n[k] = e[k];
-    }
-  }
-  n.default = e;
-  return n;
-}
-
-const path__default = /*#__PURE__*/_interopDefaultCompat(path);
-const process__default = /*#__PURE__*/_interopDefaultCompat(process);
-const chokidar__default = /*#__PURE__*/_interopDefaultCompat(chokidar);
-const MagicString__default = /*#__PURE__*/_interopDefaultCompat(MagicString);
-const fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
-const Debug__default = /*#__PURE__*/_interopDefaultCompat(Debug);
-const detectIndent__default = /*#__PURE__*/_interopDefaultCompat(detectIndent);
-const detectNewline__default = /*#__PURE__*/_interopDefaultCompat(detectNewline);
-const fg__default = /*#__PURE__*/_interopDefaultCompat(fg);
-const lockfile__default = /*#__PURE__*/_interopDefaultCompat(lockfile);
-const writeFileAtomic__default = /*#__PURE__*/_interopDefaultCompat(writeFileAtomic);
-const vm__default = /*#__PURE__*/_interopDefaultCompat(vm);
-const babelGenerator__default = /*#__PURE__*/_interopDefaultCompat(babelGenerator);
-const groupBy__default = /*#__PURE__*/_interopDefaultCompat(groupBy);
-const ts__namespace = /*#__PURE__*/_interopNamespaceCompat(ts);
-const t__namespace = /*#__PURE__*/_interopNamespaceCompat(t);
-const JSON5__default = /*#__PURE__*/_interopDefaultCompat(JSON5);
-
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+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 __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+let node_process = require("node:process");
+node_process = __toESM(node_process, 1);
+let ast_kit = require("ast-kit");
+let chokidar = require("chokidar");
+chokidar = __toESM(chokidar, 1);
+let magic_string = require("magic-string");
+magic_string = __toESM(magic_string, 1);
+let vite = require("vite");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
+let _uni_helper_uni_env = require("@uni-helper/uni-env");
+let comment_json = require("comment-json");
+let debug = require("debug");
+debug = __toESM(debug, 1);
+let detect_indent = require("detect-indent");
+detect_indent = __toESM(detect_indent, 1);
+let detect_newline = require("detect-newline");
+detect_newline = __toESM(detect_newline, 1);
+let unconfig = require("unconfig");
+let node_fs_promises = require("node:fs/promises");
+let proper_lockfile = require("proper-lockfile");
+proper_lockfile = __toESM(proper_lockfile, 1);
+let tinyglobby = require("tinyglobby");
+let write_file_atomic = require("write-file-atomic");
+write_file_atomic = __toESM(write_file_atomic, 1);
+let node_module = require("node:module");
+let node_vm = require("node:vm");
+node_vm = __toESM(node_vm, 1);
+let _babel_generator = require("@babel/generator");
+_babel_generator = __toESM(_babel_generator, 1);
+let lodash_groupby = require("lodash.groupby");
+lodash_groupby = __toESM(lodash_groupby, 1);
+let typescript = require("typescript");
+typescript = __toESM(typescript, 1);
+let _babel_types = require("@babel/types");
+_babel_types = __toESM(_babel_types, 1);
+let _vue_compiler_sfc = require("@vue/compiler-sfc");
+let _uni_helper_uni_pages_types = require("@uni-helper/uni-pages-types");
+//#region src/constant.ts
+/** Virtual module identifier for Vite module resolution */
 const MODULE_ID_VIRTUAL = "virtual:uni-pages";
+/** Resolved virtual module identifier with \0 prefix to avoid conflicts with other modules */
 const RESOLVED_MODULE_ID_VIRTUAL = `\0${MODULE_ID_VIRTUAL}`;
+/** Output filename, the uni-app page configuration file */
 const OUTPUT_NAME = "pages.json";
-const FILE_EXTENSIONS = ["vue", "nvue", "uvue"];
-
+/** Supported page file extensions */
+const FILE_EXTENSIONS = [
+	"vue",
+	"nvue",
+	"uvue"
+];
+//#endregion
+//#region ../../node_modules/.pnpm/@antfu+utils@9.3.0/node_modules/@antfu/utils/dist/index.mjs
 function slash(str) {
-  return str.replace(/\\/g, "/");
+	return str.replace(/\\/g, "/");
 }
-
+//#endregion
+//#region src/declaration.ts
+/**
+* Generate TypeScript declaration file content
+* Provide type hints for uni-app navigation APIs (navigateTo, redirectTo, switchTab, reLaunch)
+* Ensure page paths get type checking at compile time
+*
+* @param ctx - Page context instance
+* @returns Declaration file code string
+*/
 function getDeclaration(ctx) {
-  const subPagesPath = ctx.subPageMetaData.map((sub) => {
-    return sub.pages.map((v) => `"/${vite.normalizePath(path.join(sub.root, v.path))}"`);
-  }).flat();
-  const tabsPagesPath = ctx.pagesGlobConfig?.tabBar?.list?.map((v) => {
-    return `"/${v.pagePath}"`;
-  }) ?? [];
-  const allPagesPath = [...ctx.pageMetaData.filter((page) => !tabsPagesPath.includes(page.path)).map((v) => `"/${v.path}"`), ...subPagesPath];
-  const code = `/* eslint-disable */
+	const subPagesPath = ctx.subPageMetaData.map((sub) => {
+		return sub.pages.map((v) => `"/${(0, vite.normalizePath)((0, node_path.join)(sub.root, v.path))}"`);
+	}).flat();
+	const tabsPagesPath = ctx.pagesGlobConfig?.tabBar?.list?.map((v) => {
+		return `"/${v.pagePath}"`;
+	}) ?? [];
+	return `/* eslint-disable */
 /* prettier-ignore */
 // @ts-nocheck
 // Generated by vite-plugin-uni-pages
 
 type _LocationUrl =
-  ${allPagesPath.join(" |\n  ")};
+  ${[...ctx.pageMetaData.filter((page) => !tabsPagesPath.includes(page.path)).map((v) => `"/${v.path}"`), ...subPagesPath].join(" |\n  ")};
 
 interface NavigateToOptions {
   url: _LocationUrl;
@@ -109,1111 +129,1212 @@ declare module "virtual:uni-pages" {
   export type LocationUrl = _LocationUrl;
 }
 `;
-  return code;
 }
+/**
+* Write file, automatically create directories
+* @param filePath - File path
+* @param content - File content
+*/
 async function writeFile(filePath, content) {
-  await promises.mkdir(path.dirname(filePath), { recursive: true });
-  return await promises.writeFile(filePath, content, "utf-8");
+	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(filePath), { recursive: true });
+	return await (0, node_fs_promises.writeFile)(filePath, content, "utf-8");
 }
+/**
+* Write declaration file to disk
+* Only writes when content changes to avoid unnecessary file operations
+*
+* @param ctx - Page context instance
+* @param filepath - Declaration file output path
+*/
 async function writeDeclaration(ctx, filepath) {
-  const originalContent = fs.existsSync(filepath) ? await promises.readFile(filepath, "utf-8") : "";
-  const code = getDeclaration(ctx);
-  if (!code)
-    return;
-  if (code !== originalContent)
-    await writeFile(filepath, code);
+	const originalContent = (0, node_fs.existsSync)(filepath) ? await (0, node_fs_promises.readFile)(filepath, "utf-8") : "";
+	const code = getDeclaration(ctx);
+	if (!code) return;
+	if (code !== originalContent) await writeFile(filepath, code);
 }
-
+//#endregion
+//#region src/utils.ts
+/**
+* Invalidate virtual module to trigger HMR update
+* When page configuration changes, the virtual module needs to be invalidated to regenerate content
+*
+* @param server - Vite dev server instance
+*/
 function invalidatePagesModule(server) {
-  const { moduleGraph } = server;
-  const mods = moduleGraph.getModulesByFile(RESOLVED_MODULE_ID_VIRTUAL);
-  if (mods) {
-    const seen = /* @__PURE__ */ new Set();
-    mods.forEach((mod) => {
-      moduleGraph.invalidateModule(mod, seen);
-    });
-  }
+	const { moduleGraph } = server;
+	const mods = moduleGraph.getModulesByFile(RESOLVED_MODULE_ID_VIRTUAL);
+	if (mods) {
+		const seen = /* @__PURE__ */ new Set();
+		mods.forEach((mod) => {
+			moduleGraph.invalidateModule(mod, seen);
+		});
+	}
 }
-const debug = {
-  hmr: Debug__default("vite-plugin-uni-pages:hmr"),
-  routeBlock: Debug__default("vite-plugin-uni-pages:routeBlock"),
-  options: Debug__default("vite-plugin-uni-pages:options"),
-  pages: Debug__default("vite-plugin-uni-pages:pages"),
-  subPages: Debug__default("vite-plugin-uni-pages:subPages"),
-  error: Debug__default("vite-plugin-uni-pages:error"),
-  cache: Debug__default("vite-plugin-uni-pages:cache"),
-  declaration: Debug__default("vite-plugin-uni-pages:declaration"),
-  definePage: Debug__default("vite-plugin-uni-pages:definePage")
+/**
+* Debug logging utility
+* Uses debug package for leveled log output
+* Enable via environment variable DEBUG=vite-plugin-uni-pages:*
+*/
+const debug$1 = {
+	/** HMR related logs */
+	hmr: (0, debug.default)("vite-plugin-uni-pages:hmr"),
+	/** Configuration options related logs */
+	options: (0, debug.default)("vite-plugin-uni-pages:options"),
+	/** Main package page scanning logs */
+	pages: (0, debug.default)("vite-plugin-uni-pages:pages"),
+	/** Sub-package page scanning logs */
+	subPages: (0, debug.default)("vite-plugin-uni-pages:subPages"),
+	/** Error logs */
+	error: (0, debug.default)("vite-plugin-uni-pages:error"),
+	/** Cache related logs */
+	cache: (0, debug.default)("vite-plugin-uni-pages:cache"),
+	/** Declaration file generation logs */
+	declaration: (0, debug.default)("vite-plugin-uni-pages:declaration"),
+	/** definePage macro parsing logs */
+	definePage: (0, debug.default)("vite-plugin-uni-pages:definePage")
 };
+/**
+* Convert file extensions array to glob pattern
+* @param extensions - File extensions array
+* @returns Glob pattern string
+*/
 function extsToGlob(extensions) {
-  return extensions.length > 1 ? `{${extensions.join(",")}}` : extensions[0] || "";
+	return extensions.length > 1 ? `{${extensions.join(",")}}` : extensions[0] || "";
 }
-function isTargetFile(path2) {
-  const ext = path2.split(".").pop();
-  return FILE_EXTENSIONS.includes(ext);
+/**
+* Check if file is a target page file
+* Determine if the file extension is in the supported page file types list
+*
+* @param path - File path
+* @returns Whether it's a target file
+*/
+function isTargetFile(path) {
+	const ext = path.split(".").pop();
+	return FILE_EXTENSIONS.includes(ext);
 }
+/**
+* merge page meta data array by path and assign style
+* @param pageMetaData  page meta data array
+* TODO: support merge middleware
+*/
 function mergePageMetaDataArray(pageMetaData) {
-  const pageMetaDataObj = groupBy__default(pageMetaData, "path");
-  const result = [];
-  for (const path2 in pageMetaDataObj) {
-    const _pageMetaData = pageMetaDataObj[path2];
-    const options = _pageMetaData[0];
-    for (const page of _pageMetaData) {
-      options.style = Object.assign(options.style ?? {}, page.style ?? {});
-      Object.assign(options, page);
-    }
-    result.push(options);
-  }
-  return result;
+	const pageMetaDataObj = (0, lodash_groupby.default)(pageMetaData, "path");
+	const result = [];
+	for (const path in pageMetaDataObj) {
+		const _pageMetaData = pageMetaDataObj[path];
+		const options = _pageMetaData[0];
+		for (const page of _pageMetaData) {
+			options.style = Object.assign(options.style ?? {}, page.style ?? {});
+			Object.assign(options, page);
+		}
+		result.push(options);
+	}
+	return result;
 }
+/**
+* Convert TypeScript / JavaScript script code to object/function
+*
+* @param options - Configuration required for script execution
+* @param options.imports - List of module import statements to include
+* @param options.code - TypeScript code content to execute
+* @param options.filename - Script filename for error location and context
+* @returns Script execution result, if export is a function then execute and return its return value
+*/
 async function parseCode(options) {
-  const { imports = [], code, filename } = options;
-  let jsCode = "";
-  try {
-    const tmpCode = `${imports.join("\n")}
- export default ${code}`;
-    jsCode = ts__namespace.transpileModule(tmpCode, {
-      compilerOptions: {
-        module: ts__namespace.ModuleKind.CommonJS,
-        // 生成的模块格式为 CommonJS（Node.js 默认格式）
-        target: ts__namespace.ScriptTarget.ES2022,
-        // 编译后的 JavaScript 目标版本
-        noEmit: true,
-        // 不生成输出文件
-        strict: false,
-        // 关闭所有严格类型检查选项
-        noImplicitAny: false,
-        // 允许表达式和 any 类型
-        strictNullChecks: false,
-        // 关闭严格的 null 和 undefined 检查
-        strictFunctionTypes: false,
-        // 关闭函数参数的严格逆变比较
-        strictBindCallApply: false,
-        // 关闭对 bind、call 和 apply 方法的严格类型检查
-        strictPropertyInitialization: false,
-        // 关闭类属性初始化的严格检查
-        noImplicitThis: false,
-        // 允许 this 表达式具有隐式的 any 类型
-        alwaysStrict: false,
-        // 不以严格模式解析并为每个源文件生成 "use strict" 指令
-        allowJs: true,
-        // 允许编译 JavaScript 文件
-        checkJs: false,
-        // 不检查 JavaScript 文件中的类型
-        skipLibCheck: true,
-        // 跳过对 TypeScript 声明文件 (*.d.ts) 的类型检查
-        esModuleInterop: true,
-        // 启用 ES 模块互操作性，允许使用 import 导入 CommonJS 模块
-        removeComments: true
-        // 删除注释
-      },
-      jsDocParsingMode: ts__namespace.JSDocParsingMode.ParseNone
-      // 不解析 JSDoc
-    }).outputText;
-    const dir = path__default.dirname(filename);
-    const vmContext = {
-      module: {},
-      exports: {},
-      __filename: filename,
-      __dirname: dir,
-      require: node_module.createRequire(dir),
-      import: (id) => import(id),
-      // 定时器相关
-      setTimeout,
-      clearTimeout,
-      setInterval,
-      clearInterval,
-      setImmediate,
-      clearImmediate,
-      // 控制台相关
-      console,
-      // URL 处理
-      URL,
-      URLSearchParams,
-      // 进程和性能相关
-      performance,
-      // 全局对象引用
-      global: globalThis,
-      globalThis
-    };
-    const script = new vm__default.Script(jsCode, { filename });
-    await script.runInNewContext(vmContext, {
-      timeout: 1e3
-      // 设置超时避免长时间运行
-    });
-    const result = vmContext.exports.default || vmContext.exports;
-    return result;
-  } catch (error) {
-    throw new Error(`EXEC SCRIPT FAIL IN ${filename}: ${error.message} 
-
-${jsCode}
-
-`);
-  }
+	const { imports = [], code, filename } = options;
+	let jsCode = "";
+	try {
+		const tmpCode = `${imports.join("\n")}\n export default ${code}`;
+		jsCode = typescript.transpileModule(tmpCode, {
+			compilerOptions: {
+				module: typescript.ModuleKind.CommonJS,
+				target: typescript.ScriptTarget.ES2022,
+				noEmit: true,
+				strict: false,
+				noImplicitAny: false,
+				strictNullChecks: false,
+				strictFunctionTypes: false,
+				strictBindCallApply: false,
+				strictPropertyInitialization: false,
+				noImplicitThis: false,
+				alwaysStrict: false,
+				allowJs: true,
+				checkJs: false,
+				skipLibCheck: true,
+				esModuleInterop: true,
+				removeComments: true
+			},
+			jsDocParsingMode: typescript.JSDocParsingMode.ParseNone
+		}).outputText;
+		const dir = node_path.default.dirname(filename);
+		const vmContext = {
+			module: {},
+			exports: {},
+			__filename: filename,
+			__dirname: dir,
+			require: (0, node_module.createRequire)(dir),
+			import: (id) => import(id),
+			setTimeout,
+			clearTimeout,
+			setInterval,
+			clearInterval,
+			setImmediate,
+			clearImmediate,
+			console,
+			URL,
+			URLSearchParams,
+			performance,
+			global: globalThis,
+			globalThis
+		};
+		await new node_vm.default.Script(jsCode, { filename }).runInNewContext(vmContext, { timeout: 1e3 });
+		return vmContext.exports.default || vmContext.exports;
+	} catch (error) {
+		throw new Error(`EXEC SCRIPT FAIL IN ${filename}: ${error.message} \n\n${jsCode}\n\n`);
+	}
 }
+/**
+* Async sleep function
+* @param ms - Sleep duration in milliseconds
+* @returns Promise object
+*/
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+	return new Promise((resolve) => setTimeout(resolve, ms));
 }
+/**
+* Get default export of a module
+* Compatible with CommonJS and ES Module export styles
+*
+* @param expr - Module object
+* @returns Default export value
+*/
 function getDefaultExport(expr) {
-  return expr.default === void 0 ? expr : expr.default;
+	return expr.default === void 0 ? expr : expr.default;
 }
-const babelGenerate = getDefaultExport(babelGenerator__default);
-
+/** Babel code generator for converting AST back to code */
+const babelGenerate = getDefaultExport(_babel_generator.default);
+function stripType(item) {
+	const { type, ...rest } = item;
+	return rest;
+}
+//#endregion
+//#region src/files.ts
+/**
+* Resolves the files that are valid pages for the given context.
+*/
 function getPageFiles(path, options) {
-  const { exclude } = options;
-  const ext = extsToGlob(FILE_EXTENSIONS);
-  const files = fg__default.sync(`**/*.${ext}`, {
-    ignore: exclude,
-    onlyFiles: true,
-    cwd: path
-  });
-  return files;
+	const { exclude } = options;
+	return (0, tinyglobby.globSync)(`**/*.${extsToGlob(FILE_EXTENSIONS)}`, {
+		ignore: exclude,
+		onlyFiles: true,
+		cwd: path
+	});
 }
+/**
+* Check the pages.json file at the specified path, create an empty pages.json file if it doesn't exist or is not a valid file
+* @param path - File path to check
+* @returns boolean - Whether the operation was successful
+*/
 function checkPagesJsonFileSync(path) {
-  const createEmptyFile = (path2) => {
-    try {
-      fs__default.writeFileSync(
-        path2,
-        JSON.stringify({ pages: [{ path: "" }] }, null, 2),
-        { encoding: "utf-8" }
-      );
-      return true;
-    } catch {
-      return false;
-    }
-  };
-  const unlinkFile = (path2) => {
-    try {
-      fs__default.unlinkSync(path2);
-      return true;
-    } catch {
-      return false;
-    }
-  };
-  try {
-    try {
-      fs__default.accessSync(path, fs__default.constants.F_OK);
-    } catch {
-      return createEmptyFile(path);
-    }
-    const stat = fs__default.statSync(path);
-    if (!stat.isFile()) {
-      if (!unlinkFile(path)) {
-        return false;
-      }
-      return createEmptyFile(path);
-    }
-    try {
-      fs__default.accessSync(path, fs__default.constants.R_OK | fs__default.constants.W_OK);
-      return true;
-    } catch {
-      if (!unlinkFile(path)) {
-        return false;
-      }
-      return createEmptyFile(path);
-    }
-  } catch {
-    return createEmptyFile(path);
-  }
+	/**
+	* Create an empty pages.json file
+	* @param path - File path
+	* @returns boolean - Whether the creation was successful
+	*/
+	const createEmptyFile = (path) => {
+		try {
+			node_fs.default.writeFileSync(path, JSON.stringify({ pages: [{ path: "" }] }, null, 2), { encoding: "utf-8" });
+			return true;
+		} catch {
+			return false;
+		}
+	};
+	/**
+	* Delete the file at the specified path
+	* @param path - File path
+	* @returns boolean - Whether the deletion was successful
+	*/
+	const unlinkFile = (path) => {
+		try {
+			node_fs.default.unlinkSync(path);
+			return true;
+		} catch {
+			return false;
+		}
+	};
+	try {
+		try {
+			node_fs.default.accessSync(path, node_fs.default.constants.F_OK);
+		} catch {
+			return createEmptyFile(path);
+		}
+		if (!node_fs.default.statSync(path).isFile()) {
+			if (!unlinkFile(path)) return false;
+			return createEmptyFile(path);
+		}
+		try {
+			node_fs.default.accessSync(path, node_fs.default.constants.R_OK | node_fs.default.constants.W_OK);
+			return true;
+		} catch {
+			if (!unlinkFile(path)) return false;
+			return createEmptyFile(path);
+		}
+	} catch {
+		return createEmptyFile(path);
+	}
 }
+/**
+* Safely write file using file lock
+* Avoid data corruption caused by concurrent writes through file lock
+* Use atomic write to ensure file write integrity
+*
+* @param path - File path
+* @param content - File content
+* @param retry - Number of retries when lock acquisition fails, defaults to 3
+*/
 async function writeFileWithLock(path, content, retry = 3) {
-  if (retry <= 0) {
-    debug.error(`${path} \u83B7\u53D6\u6587\u4EF6\u9501\u5931\u8D25\uFF0C\u5199\u5165\u5931\u8D25`);
-    return;
-  }
-  let release;
-  try {
-    try {
-      release = await lockfile__default.lock(path, { realpath: false });
-    } catch {
-      await sleep(500);
-      return writeFileWithLock(path, content, retry - 1);
-    }
-    await writeFileAtomic__default(path, content);
-  } finally {
-    if (release) {
-      await release();
-    }
-  }
+	if (retry <= 0) {
+		debug$1.error(`${path} Failed to acquire file lock, write failed`);
+		return;
+	}
+	let release;
+	try {
+		try {
+			release = await proper_lockfile.default.lock(path, { realpath: false });
+		} catch {
+			await sleep(500);
+			return writeFileWithLock(path, content, retry - 1);
+		}
+		await (0, write_file_atomic.default)(path, content);
+	} finally {
+		if (release) await release();
+	}
 }
-
-function resolveOptions(userOptions, viteRoot = process__default.cwd()) {
-  const {
-    dts = true,
-    configSource = "pages.config",
-    homePage = ["pages/index", "pages/index/index"],
-    mergePages = true,
-    dir = "src/pages",
-    subPackages = [],
-    outDir = "src",
-    exclude = ["node_modules", ".git", "**/__*__/**"],
-    routeBlockLang = "json5",
-    minify = false,
-    debug = false,
-    onBeforeLoadUserConfig = () => {
-    },
-    onAfterLoadUserConfig = () => {
-    },
-    onBeforeScanPages = () => {
-    },
-    onAfterScanPages = () => {
-    },
-    onBeforeMergePageMetaData = () => {
-    },
-    onAfterMergePageMetaData = () => {
-    },
-    onBeforeWriteFile = () => {
-    },
-    onAfterWriteFile = () => {
-    }
-  } = userOptions;
-  const root = viteRoot || slash(process__default.env.VITE_ROOT_DIR || process__default.cwd());
-  const resolvedDirs = resolvePageDirs(dir, root, exclude);
-  const resolvedSubDirs = subPackages.map((dir2) => slash(dir2));
-  const resolvedHomePage = typeof homePage === "string" ? [homePage] : homePage;
-  const resolvedConfigSource = typeof configSource === "string" ? [{ files: configSource }] : configSource;
-  const resolvedDts = !dts ? false : typeof dts === "string" ? dts : path.resolve(viteRoot, "uni-pages.d.ts");
-  const resolvedOptions = {
-    dts: resolvedDts,
-    configSource: Array.isArray(resolvedConfigSource) ? resolvedConfigSource : [resolvedConfigSource],
-    homePage: resolvedHomePage,
-    mergePages,
-    dirs: resolvedDirs,
-    subPackages: resolvedSubDirs,
-    outDir,
-    exclude,
-    routeBlockLang,
-    root,
-    minify,
-    debug,
-    onBeforeLoadUserConfig,
-    onAfterLoadUserConfig,
-    onBeforeScanPages,
-    onAfterScanPages,
-    onBeforeMergePageMetaData,
-    onAfterMergePageMetaData,
-    onBeforeWriteFile,
-    onAfterWriteFile
-  };
-  return resolvedOptions;
+//#endregion
+//#region src/options.ts
+/**
+* Resolve user configuration options
+* Merge user-provided configuration with default values and handle path resolution
+*
+* @param userOptions - User configuration options
+* @param viteRoot - Vite project root directory
+* @returns Resolved configuration options
+*/
+function resolveOptions(userOptions, viteRoot = node_process.default.cwd()) {
+	const { dts = true, configSource = "pages.config", homePage = ["pages/index", "pages/index/index"], mergePages = true, dir = "src/pages", subPackages = [], outDir = "src", exclude = [
+		"node_modules",
+		".git",
+		"**/__*__/**"
+	], minify = false, debug = false, onBeforeLoadUserConfig = () => {}, onAfterLoadUserConfig = () => {}, onBeforeScanPages = () => {}, onAfterScanPages = () => {}, onBeforeMergePageMetaData = () => {}, onAfterMergePageMetaData = () => {}, onBeforeWriteFile = () => {}, onAfterWriteFile = () => {} } = userOptions;
+	const root = viteRoot || slash(node_process.default.env.VITE_ROOT_DIR || node_process.default.cwd());
+	const resolvedDirs = resolvePageDirs(dir, root, exclude);
+	const resolvedSubDirs = subPackages.map((dir) => slash(dir));
+	const resolvedHomePage = typeof homePage === "string" ? [homePage] : homePage;
+	const resolvedConfigSource = typeof configSource === "string" ? [{ files: configSource }] : configSource;
+	return {
+		dts: !dts ? false : typeof dts === "string" ? dts : (0, node_path.resolve)(viteRoot, "uni-pages.d.ts"),
+		configSource: Array.isArray(resolvedConfigSource) ? resolvedConfigSource : [resolvedConfigSource],
+		homePage: resolvedHomePage,
+		mergePages,
+		dirs: resolvedDirs,
+		subPackages: resolvedSubDirs,
+		outDir,
+		exclude,
+		root,
+		minify,
+		debug,
+		onBeforeLoadUserConfig,
+		onAfterLoadUserConfig,
+		onBeforeScanPages,
+		onAfterScanPages,
+		onBeforeMergePageMetaData,
+		onAfterMergePageMetaData,
+		onBeforeWriteFile,
+		onAfterWriteFile
+	};
 }
+/**
+* Resolves the page dirs for its for its given globs
+*/
 function resolvePageDirs(dir, root, exclude) {
-  const dirs = fg__default.sync(slash(dir), {
-    ignore: exclude,
-    onlyDirectories: true,
-    dot: true,
-    unique: true,
-    cwd: root
-  });
-  return dirs;
-}
-
-function parseCustomBlock(block, filePath, routeBlockLang) {
-  const lang = block.lang ?? routeBlockLang;
-  const attr = {
-    type: "page",
-    ...block.attrs
-  };
-  let content;
-  debug.routeBlock(`use ${lang} parser`);
-  if (lang === "json5") {
-    try {
-      content = JSON5__default.parse(block.content);
-    } catch (err) {
-      throw new Error(
-        `Invalid JSON5 format of <${block.type}> content in ${filePath}
-${err.message}`
-      );
-    }
-  } else if (lang === "jsonc") {
-    try {
-      content = commentJson.parse(block.content);
-    } catch (err) {
-      throw new Error(
-        `Invalid JSONC format of <${block.type}> content in ${filePath}
-${err.message}`
-      );
-    }
-  } else if (lang === "json") {
-    try {
-      content = JSON.parse(block.content);
-    } catch (err) {
-      throw new Error(
-        `Invalid JSON format of <${block.type}> content in ${filePath}
-${err.message}`
-      );
-    }
-  } else if (lang === "yaml" || lang === "yml") {
-    try {
-      content = yaml.parse(block.content);
-    } catch (err) {
-      throw new Error(
-        `Invalid YAML format of <${block.type}> content in ${filePath}
-${err.message}`
-      );
-    }
-  }
-  return {
-    attr,
-    content: content ?? {}
-  };
-}
-function getRouteSfcBlock(sfc) {
-  return sfc?.customBlocks.find((b) => b.type === "route");
+	return (0, tinyglobby.globSync)(slash(dir), {
+		ignore: exclude,
+		onlyDirectories: true,
+		expandDirectories: false,
+		dot: true,
+		cwd: root
+	});
 }
-function getRouteBlock(path, blockStr, routeBlockLang) {
-  if (!blockStr)
-    return;
-  return parseCustomBlock(blockStr, path, routeBlockLang);
-}
-
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => {
-  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
+//#endregion
+//#region src/page.ts
+/**
+* Page class representing a Vue page file
+*
+* Responsibilities:
+* 1. Read page file content
+* 2. Parse page metadata defined by definePage macro
+* 3. Provide tabBar configuration information
+* 4. Track page file change status
+*/
+var Page = class {
+	/** Page context instance */
+	ctx;
+	/** Page path information containing relative and absolute paths */
+	path;
+	/** Page URI used for pages.json path field */
+	uri;
+	/** Whether the page has changed, used for incremental update judgment */
+	changed = true;
+	/** Raw JSON string of page metadata for change detection */
+	raw = "";
+	/** Parsed page metadata */
+	meta;
+	/**
+	* Create a page instance
+	* @param ctx - Page context instance
+	* @param path - Page path information
+	*/
+	constructor(ctx, path) {
+		this.ctx = ctx;
+		this.path = path;
+		this.uri = (0, vite.normalizePath)(path.relativePath.replace((0, node_path.extname)(path.relativePath), ""));
+	}
+	/**
+	* Get page metadata
+	* Parse configuration defined by definePage macro and return metadata for pages.json
+	*
+	* @param forceUpdate - Whether to force update, ignoring cache
+	* @returns Page metadata object
+	*/
+	async getPageMeta(forceUpdate = false) {
+		if (forceUpdate || !this.meta) await this.read();
+		const { path, tabBar: _, ...others } = this.meta || {};
+		return {
+			path: path ?? this.uri,
+			...others
+		};
+	}
+	/**
+	* Get page tabBar configuration
+	* Extract tabBar related configuration from definePage macro
+	*
+	* @param forceUpdate - Whether to force update, ignoring cache
+	* @returns tabBar configuration object, or undefined if page doesn't define tabBar
+	*/
+	async getTabBar(forceUpdate = false) {
+		if (forceUpdate || !this.meta) await this.read();
+		const { tabBar } = this.meta || {};
+		if (tabBar === void 0) return;
+		return {
+			...tabBar,
+			pagePath: tabBar.pagePath || this.uri,
+			index: tabBar.index ?? 0
+		};
+	}
+	/**
+	* Check if the page has changed
+	* @returns Whether the page has changed
+	*/
+	hasChanged() {
+		return this.changed;
+	}
+	/**
+	* Read page file and parse metadata
+	* Extract configuration defined by definePage macro from Vue SFC
+	*/
+	async read() {
+		let meta;
+		try {
+			meta = await this.readPageMetaFromFile();
+		} catch (err) {
+			debug$1.error(err);
+			return;
+		}
+		let raw = "";
+		try {
+			raw = JSON.stringify(meta);
+		} catch {}
+		this.changed = this.raw !== raw;
+		this.meta = meta;
+		this.raw = raw;
+	}
+	async readPageMetaFromFile() {
+		try {
+			const meta = await tryPageMetaFromMacro(parseSFC(await node_fs.default.promises.readFile(this.path.absolutePath, { encoding: "utf-8" }), { filename: this.path.absolutePath }));
+			if (meta) return meta;
+			return { type: "page" };
+		} catch (err) {
+			throw new Error(`Read page meta fail in ${this.path.relativePath}\n${err.message}`);
+		}
+	}
 };
-class Page {
-  constructor(ctx, path$1) {
-    __publicField$1(this, "ctx");
-    __publicField$1(this, "path");
-    __publicField$1(this, "uri");
-    __publicField$1(this, "changed", true);
-    __publicField$1(this, "raw", "");
-    __publicField$1(this, "meta");
-    this.ctx = ctx;
-    this.path = path$1;
-    this.uri = vite.normalizePath(path$1.relativePath.replace(path.extname(path$1.relativePath), ""));
-  }
-  async getPageMeta(forceUpdate = false) {
-    if (forceUpdate || !this.meta) {
-      await this.read();
-    }
-    const { path, tabBar: _, ...others } = this.meta || {};
-    return {
-      path: path ?? this.uri,
-      ...others
-    };
-  }
-  async getTabBar(forceUpdate = false) {
-    if (forceUpdate || !this.meta) {
-      await this.read();
-    }
-    const { tabBar } = this.meta;
-    if (tabBar === void 0) {
-      return void 0;
-    }
-    return {
-      ...tabBar,
-      pagePath: tabBar.pagePath || this.uri,
-      index: tabBar.index || 0
-    };
-  }
-  hasChanged() {
-    return this.changed;
-  }
-  async read() {
-    let meta;
-    try {
-      meta = await this.readPageMetaFromFile();
-    } catch (err) {
-      debug.error(err);
-      return;
-    }
-    let raw = "";
-    try {
-      raw = JSON.stringify(meta);
-    } catch {
-    }
-    this.changed = this.raw !== raw;
-    this.meta = meta;
-    this.raw = raw;
-  }
-  async readPageMetaFromFile() {
-    try {
-      const content = await fs__default.promises.readFile(this.path.absolutePath, { encoding: "utf-8" });
-      const sfc = parseSFC(content, { filename: this.path.absolutePath });
-      const meta = await tryPageMetaFromMacro(sfc);
-      if (meta) {
-        return meta;
-      }
-      return tryPageMetaFromCustomBlock(sfc, this.ctx.options.routeBlockLang);
-    } catch (err) {
-      throw new Error(`Read page meta fail in ${this.path.relativePath}
-${err.message}`);
-    }
-  }
-}
+/**
+* Parse Vue Single File Component (SFC)
+* Compatible with different versions of @vue/compiler-sfc
+*
+* @param code - Vue SFC source code
+* @param options - Parse options
+* @returns SFC descriptor object
+*/
 function parseSFC(code, options) {
-  return compilerSfc.parse(code, {
-    pad: "space",
-    ...options
-  }).descriptor || compilerSfc.parse({
-    source: code,
-    ...options
-  });
+	return (0, _vue_compiler_sfc.parse)(code, {
+		pad: "space",
+		...options
+	}).descriptor || (0, _vue_compiler_sfc.parse)({
+		source: code,
+		...options
+	});
 }
+/**
+* Try to extract page metadata defined by definePage macro from SFC
+* Support using definePage in script setup or regular script
+*
+* @param sfc - Vue SFC descriptor
+* @returns Page metadata object, or undefined if definePage is not found
+*/
 async function tryPageMetaFromMacro(sfc) {
-  const sfcScript = sfc.scriptSetup || sfc.script;
-  if (!sfcScript) {
-    return void 0;
-  }
-  const ast = astKit.babelParse(sfcScript.content, sfcScript.lang || "js", {
-    plugins: [["importAttributes", { deprecatedAssertSyntax: true }]]
-  });
-  const macro = findMacro(ast.body, sfc.filename);
-  if (macro) {
-    const imports = findImports(ast.body).filter((imp) => !!imp.specifiers.length).map((imp) => babelGenerate(imp).code);
-    const [macroOption] = macro.arguments;
-    const code = babelGenerate(macroOption).code;
-    const parsed = await parseCode({
-      imports,
-      code,
-      filename: sfc.filename
-    });
-    const res = typeof parsed === "function" ? await Promise.resolve(parsed()) : await Promise.resolve(parsed);
-    return {
-      type: "page",
-      ...res
-    };
-  }
-  return void 0;
-}
-async function tryPageMetaFromCustomBlock(sfc, routeBlockLang) {
-  const block = getRouteSfcBlock(sfc);
-  const routeBlock = getRouteBlock(sfc.filename, block, routeBlockLang);
-  const pageMeta = {
-    type: routeBlock?.attr.type ?? "page"
-  };
-  if (routeBlock) {
-    try {
-      commentJson.assign(pageMeta, routeBlock.content);
-    } catch {
-    }
-  }
-  return pageMeta;
+	const sfcScript = sfc.scriptSetup || sfc.script;
+	if (!sfcScript) return;
+	const ast = (0, ast_kit.babelParse)(sfcScript.content, sfcScript.lang || "js", { plugins: [["importAttributes", { deprecatedAssertSyntax: true }]] });
+	const macro = findMacro(ast.body, sfc.filename);
+	if (macro) {
+		const imports = findImports(ast.body).filter((imp) => !!imp.specifiers.length).map((imp) => babelGenerate(imp).code);
+		const [macroOption] = macro.arguments;
+		const code = babelGenerate(macroOption).code;
+		const parsed = await parseCode({
+			imports,
+			code,
+			filename: sfc.filename
+		});
+		return {
+			type: "page",
+			...typeof parsed === "function" ? await Promise.resolve(parsed()) : await Promise.resolve(parsed)
+		};
+	}
 }
+/**
+* Find definePage macro call in AST
+* Support function expressions, arrow functions and object expressions as arguments
+*
+* @param stmts - AST statement array
+* @param filename - Filename for error reporting
+* @returns definePage call expression, or undefined if not found
+*/
 function findMacro(stmts, filename) {
-  let macro;
-  for (const stmt of stmts) {
-    let node = stmt;
-    if (stmt.type === "ExpressionStatement")
-      node = stmt.expression;
-    if (astKit.isCallOf(node, "definePage")) {
-      macro = node;
-      break;
-    }
-  }
-  if (!macro)
-    return;
-  const [opt] = macro.arguments;
-  if (opt && !t__namespace.isFunctionExpression(opt) && !t__namespace.isArrowFunctionExpression(opt) && !t__namespace.isObjectExpression(opt)) {
-    debug.definePage(`definePage() \u53C2\u6570\u4EC5\u652F\u6301\u51FD\u6570\u6216\u5BF9\u8C61\uFF1A${filename}`);
-    return;
-  }
-  return macro;
+	let macro;
+	for (const stmt of stmts) {
+		let node = stmt;
+		if (stmt.type === "ExpressionStatement") node = stmt.expression;
+		if ((0, ast_kit.isCallOf)(node, "definePage")) {
+			macro = node;
+			break;
+		}
+	}
+	if (!macro) return;
+	const [opt] = macro.arguments;
+	if (opt && !_babel_types.isFunctionExpression(opt) && !_babel_types.isArrowFunctionExpression(opt) && !_babel_types.isObjectExpression(opt)) {
+		debug$1.definePage(`definePage() 参数仅支持函数或对象：${filename}`);
+		return;
+	}
+	return macro;
 }
+/**
+* Extract all import declarations from AST
+* Used to provide necessary imports when executing definePage arguments
+*
+* @param stmts - AST statement array
+* @returns Import declaration array
+*/
 function findImports(stmts) {
-  const imports = [];
-  for (const stmt of stmts) {
-    if (t__namespace.isImportDeclaration(stmt)) {
-      imports.push(stmt);
-    }
-  }
-  return imports;
+	const imports = [];
+	for (const stmt of stmts) if (_babel_types.isImportDeclaration(stmt)) imports.push(stmt);
+	return imports;
 }
-
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
+//#endregion
+//#region src/context.ts
+/**
+* Page context class responsible for page scanning, config loading, page metadata merging and pages.json generation
+*
+* Core responsibilities:
+* 1. Scan page directories and collect page files
+* 2. Load user configuration files (pages.config.ts, etc.)
+* 3. Parse page metadata (definePage macro)
+* 4. Merge page configurations and generate pages.json
+* 5. Provide virtual module and HMR support
+*/
+var PageContext = class {
+	_server;
+	/** Parsed configuration object from user config file (pages.config.ts) */
+	pagesGlobConfig;
+	/** Source path list of user configuration files */
+	pagesConfigSourcePaths = [];
+	/** Main package page map, key is the absolute path of the page file */
+	pages = /* @__PURE__ */ new Map();
+	/** Sub-package page map, key is the sub-package root directory, value is the page map under that sub-package */
+	subPages = /* @__PURE__ */ new Map();
+	/** Main package page metadata array for generating pages.json pages field */
+	pageMetaData = [];
+	/** Sub-package page metadata array for generating pages.json subPackages field */
+	subPageMetaData = [];
+	/** Generated pages.json file path */
+	resolvedPagesJSONPath = "";
+	resolvedPagesJSONIndent;
+	resolvedPagesJSONNewline;
+	resolvedPagesJSONEofNewline;
+	/** Original options passed by the user */
+	rawOptions;
+	/** Project root directory */
+	root;
+	/** Resolved configuration options */
+	options;
+	logger;
+	/** Whether to work with vite-plugin-uni-platform plugin */
+	withUniPlatform = false;
+	/** Cached previous pages.json content to avoid redundant writes */
+	lastPagesJson = "";
+	/**
+	* Create a PageContext instance
+	* @param userOptions - User configuration options
+	* @param viteRoot - Vite project root directory, defaults to current working directory
+	*/
+	constructor(userOptions, viteRoot = node_process.default.cwd()) {
+		this.rawOptions = userOptions;
+		this.root = slash(viteRoot);
+		debug$1.options("root", this.root);
+		this.options = resolveOptions(userOptions, this.root);
+		const debugOption = this.options.debug;
+		if (debugOption) {
+			const prefix = "vite-plugin-uni-pages:";
+			const suffix = typeof debugOption === "boolean" ? "*" : debugOption;
+			debug.default.enable(`${prefix}${suffix}`);
+		}
+		this.resolvedPagesJSONPath = node_path.default.join(this.root, this.options.outDir, OUTPUT_NAME);
+		debug$1.options(this.options);
+	}
+	/**
+	* Set the Vite logger
+	* @param logger - Vite logger instance
+	*/
+	setLogger(logger) {
+		this.logger = logger;
+	}
+	/**
+	* Load user page configuration file (e.g. pages.config.ts)
+	* Uses unconfig to load configuration, supporting multiple config file formats
+	*/
+	async loadUserPagesConfig() {
+		const configSource = this.options.configSource;
+		const { config, sources } = await (0, unconfig.loadConfig)({
+			cwd: this.root,
+			sources: configSource,
+			defaults: {}
+		});
+		this.pagesGlobConfig = config.default || config;
+		this.pagesConfigSourcePaths = sources;
+		debug$1.options(this.pagesGlobConfig);
+	}
+	/**
+	* Scan main package page directories and collect all page file paths
+	* Scan corresponding directories based on the configured dirs option
+	*/
+	async scanPages() {
+		const paths = this.options.dirs.map((dir) => {
+			return {
+				dir,
+				files: getPagePaths(dir, this.options)
+			};
+		}).map((page) => page.files).flat();
+		debug$1.pages(paths);
+		const pages = /* @__PURE__ */ new Map();
+		for (const path of paths) {
+			const page = this.pages.get(path.absolutePath) || new Page(this, path);
+			pages.set(path.absolutePath, page);
+		}
+		this.pages = pages;
+	}
+	/**
+	* Scan sub-package page directories and collect all sub-package page file paths
+	* Scan corresponding directories based on the configured subPackages option
+	*/
+	async scanSubPages() {
+		const paths = {};
+		const subPages = /* @__PURE__ */ new Map();
+		for (const dir of this.options.subPackages) {
+			const pagePaths = getPagePaths(dir, this.options);
+			paths[dir] = pagePaths;
+			const pages = /* @__PURE__ */ new Map();
+			for (const path of pagePaths) {
+				const page = this.subPages.get(dir)?.get(path.absolutePath) || new Page(this, path);
+				pages.set(path.absolutePath, page);
+			}
+			subPages.set(dir, pages);
+		}
+		debug$1.subPages(JSON.stringify(paths, null, 2));
+		this.subPages = subPages;
+	}
+	/**
+	* Set up Vite dev server for HMR and file watching
+	* @param server - Vite dev server instance
+	*/
+	setupViteServer(server) {
+		if (this._server === server) return;
+		this._server = server;
+		this.setupWatcher(server.watcher);
+	}
+	/**
+	* Set up file watcher to monitor page file and config file changes
+	* Automatically update pages.json when page files or config files change
+	* @param watcher - chokidar file watcher instance
+	*/
+	async setupWatcher(watcher) {
+		watcher.add(this.pagesConfigSourcePaths);
+		const targetDirs = [...this.options.dirs, ...this.options.subPackages].map((v) => slash(node_path.default.resolve(this.root, v)));
+		const isInTargetDirs = (filePath) => targetDirs.some((v) => slash(node_path.default.resolve(this.root, filePath)).startsWith(v));
+		watcher.on("add", async (path) => {
+			path = slash(path);
+			if (!isTargetFile(path)) return;
+			if (!isInTargetDirs(path)) return;
+			debug$1.pages(`File added: ${path}`);
+			if (await this.updatePagesJSON()) this.onUpdate();
+		});
+		watcher.on("change", async (path) => {
+			path = slash(path);
+			if (!isTargetFile(path)) return;
+			if (!isInTargetDirs(path)) return;
+			debug$1.pages(`File changed: ${path}`);
+			debug$1.pages(targetDirs);
+			debug$1.pages(isInTargetDirs(path));
+			if (await this.updatePagesJSON(path)) this.onUpdate();
+		});
+		watcher.on("change", async (path) => {
+			if (this.pagesConfigSourcePaths.includes(path)) {
+				debug$1.pages(`Config source changed: ${path}`);
+				if (await this.updatePagesJSON()) this.onUpdate();
+			}
+		});
+		watcher.on("unlink", async (path) => {
+			path = slash(path);
+			if (!isTargetFile(path)) return;
+			if (!isInTargetDirs(path)) return;
+			debug$1.pages(`File removed: ${path}`);
+			if (await this.updatePagesJSON()) this.onUpdate();
+		});
+	}
+	/**
+	* Page update callback, triggered when page files or configuration changes
+	* Responsible for invalidating virtual modules and notifying the browser to do a full reload
+	*/
+	onUpdate() {
+		if (!this._server) return;
+		invalidatePagesModule(this._server);
+		debug$1.hmr("Reload generated pages.");
+		this._server.ws.send({ type: "full-reload" });
+	}
+	/**
+	* parse pages rules && set page type
+	* @param pages page path array
+	* @param type  page type
+	* @param overrides custom page config
+	* @returns pages rules
+	*/
+	async parsePages(pages, type, overrides) {
+		const jobs = [];
+		for (const [_, page] of pages) jobs.push(page.getPageMeta());
+		const generatedPageMetaData = await Promise.all(jobs);
+		const customPageMetaData = overrides || [];
+		const result = customPageMetaData.length ? mergePageMetaDataArray(generatedPageMetaData.concat(customPageMetaData)) : generatedPageMetaData;
+		const parseMeta = Array.from(result.reduce((map, page) => {
+			map.set(page.path, page);
+			return map;
+		}, /* @__PURE__ */ new Map()).values());
+		return type === "main" ? this.setHomePage(parseMeta) : parseMeta;
+	}
+	/**
+	* set home page
+	* @param result pages rules array
+	* @returns pages rules
+	*/
+	setHomePage(result) {
+		if (!result.some(({ type }) => type === "home")) {
+			const basePath = slash(node_path.default.join(this.options.root, this.options.outDir));
+			const resolvedHomePages = this.options.homePage.map((v) => {
+				return slash(node_path.default.relative(basePath, slash(node_path.default.resolve(basePath, v))));
+			});
+			const matchHomePage = (itemPath, configPath) => {
+				if (itemPath === configPath) return true;
+				const normalizedItem = itemPath.replace(/\\/g, "/");
+				const normalizedConfig = configPath.replace(/\\/g, "/");
+				return normalizedItem.endsWith(`/${normalizedConfig}`);
+			};
+			if (!result.some((item) => {
+				const isFound = resolvedHomePages.some((expectedPath) => matchHomePage(item.path, expectedPath));
+				if (isFound) item.type = "home";
+				return isFound;
+			})) this.logger?.warn("No home page found, check the configuration of pages.config.ts, or add the `homePage` option to UniPages in vite.config.js, or add `definePage({ type: \"home\" })` in your vue page.", { timestamp: true });
+		}
+		result.sort((page) => page.type === "home" ? -1 : 0);
+		return result;
+	}
+	/**
+	* Merge main package page metadata
+	* Filter out pages belonging to sub-packages, then parse page metadata and merge user configuration
+	*/
+	async mergePageMetaData() {
+		const subPageAbsolutePaths = Array.from(this.subPages.values()).flatMap((v) => Array.from(v.keys()));
+		for (const subPageAbsolutePath of subPageAbsolutePaths) this.pages.delete(subPageAbsolutePath);
+		const pageMetaData = await this.parsePages(this.pages, "main", this.pagesGlobConfig?.pages);
+		this.pageMetaData = pageMetaData;
+		debug$1.pages(this.pageMetaData);
+	}
+	/**
+	* Merge sub-package page metadata
+	* Parse page metadata for each sub-package and handle sub-package configuration inheritance
+	* Preserves sub-package level properties like plugins from user config
+	*/
+	async mergeSubPageMetaData() {
+		const subPageMaps = {};
+		const subPlugins = {};
+		const subPackages = this.pagesGlobConfig?.subPackages || [];
+		for (const [dir, pages] of this.subPages) {
+			const basePath = slash(node_path.default.join(this.options.root, this.options.outDir));
+			const root = slash(node_path.default.relative(basePath, node_path.default.join(this.options.root, dir)));
+			const globPackage = subPackages?.find((v) => v.root === root);
+			subPageMaps[root] = await this.parsePages(pages, "sub", globPackage?.pages);
+			subPageMaps[root] = subPageMaps[root].map((page) => ({
+				...page,
+				path: slash(node_path.default.relative(root, page.path))
+			}));
+			if (globPackage?.plugins) subPlugins[root] = globPackage.plugins;
+		}
+		for (const { root, pages, plugins } of subPackages) if (root && !subPageMaps[root]) {
+			subPageMaps[root] = pages || [];
+			if (plugins) subPlugins[root] = plugins;
+		}
+		const subPageMetaData = Object.keys(subPageMaps).map((root) => ({
+			root,
+			pages: subPageMaps[root],
+			...subPlugins[root] && { plugins: subPlugins[root] }
+		})).filter((meta) => meta.pages.length > 0);
+		this.subPageMetaData = subPageMetaData;
+		debug$1.subPages(this.subPageMetaData);
+	}
+	/**
+	* Update pages.json file
+	* This is the core method responsible for coordinating the entire page configuration generation flow:
+	* 1. Check file changes (if filepath is specified)
+	* 2. Load user configuration
+	* 3. Scan page files
+	* 4. Merge page metadata
+	* 5. Generate and write pages.json
+	* @param filepath - Changed file path for incremental update judgment
+	* @returns Whether pages.json was successfully updated
+	*/
+	async updatePagesJSON(filepath) {
+		if (filepath) {
+			let page = this.pages.get(filepath);
+			if (!page) {
+				let subPage;
+				for (const [_, pages] of this.subPages) {
+					subPage = pages.get(filepath);
+					if (subPage) break;
+				}
+				page = subPage;
+			}
+			if (page) {
+				await page.read();
+				if (!page.hasChanged()) {
+					debug$1.cache(`The page meta on page ${filepath} did not send any changes, skipping`);
+					return false;
+				}
+			}
+		}
+		checkPagesJsonFileSync(this.resolvedPagesJSONPath);
+		this.options.onBeforeLoadUserConfig(this);
+		await this.loadUserPagesConfig();
+		this.options.onAfterLoadUserConfig(this);
+		if (this.options.mergePages) {
+			this.options.onBeforeScanPages(this);
+			await this.scanPages();
+			await this.scanSubPages();
+			this.options.onAfterScanPages(this);
+		}
+		this.options.onBeforeMergePageMetaData(this);
+		await this.mergePageMetaData();
+		await this.mergeSubPageMetaData();
+		this.options.onAfterMergePageMetaData(this);
+		const pagesMap = /* @__PURE__ */ new Map();
+		(this.withUniPlatform ? this.pageMetaData.filter((v) => !/\..*$/.test(v.path) || v.path.includes(_uni_helper_uni_env.platform)).map((v) => {
+			v.path = v.path.replace(/\..*$/, "");
+			return v;
+		}) : this.pageMetaData).forEach((v) => pagesMap.set(v.path, v));
+		this.pageMetaData = [...pagesMap.values()];
+		this.options.onBeforeWriteFile(this);
+		const pagesJson = (0, comment_json.stringify)(await this.genratePagesJSON(), null, this.options.minify ? void 0 : await this.getIndent()) + (await this.getEndOfLine() ? await this.getNewline() : "");
+		this.generateDeclaration();
+		if (this.lastPagesJson === pagesJson) {
+			debug$1.pages("PagesJson Not have change");
+			return false;
+		}
+		await writeFileWithLock(this.resolvedPagesJSONPath, pagesJson);
+		this.lastPagesJson = pagesJson;
+		this.options.onAfterWriteFile(this);
+		return true;
+	}
+	/**
+	* Generate virtual module content
+	* Returns JavaScript code containing pages and subPackages exports
+	* @returns Virtual module code string
+	*/
+	virtualModule() {
+		return [`export const pages = ${this.resolveRoutes()};`, `export const subPackages = ${this.resolveSubRoutes()};`].join("\n");
+	}
+	/**
+	* Resolve main package route data to JSON string
+	* @returns JSON string of main package page metadata
+	*/
+	resolveRoutes() {
+		return (0, comment_json.stringify)(this.pageMetaData.map(stripType), null, 2);
+	}
+	/**
+	* Resolve sub-package route data to JSON string
+	* @returns JSON string of sub-package page metadata
+	*/
+	resolveSubRoutes() {
+		return (0, comment_json.stringify)(this.subPageMetaData.map(({ pages, ...rest }) => ({
+			...rest,
+			pages: pages.map(stripType)
+		})), null, 2);
+	}
+	/**
+	* Resolve tabBar configuration
+	* Merges page-defined tabBar items with config-defined tabBar
+	* @returns Merged tabBar configuration object, or undefined if no tabBar exists
+	*/
+	async resolveTabBar() {
+		const tabBarItems = [];
+		for (const [_, page] of this.pages) {
+			const tabbar = await page.getTabBar();
+			if (tabbar) tabBarItems.push(tabbar);
+		}
+		if (tabBarItems.length === 0) return this.pagesGlobConfig?.tabBar;
+		const tabBar = {
+			...this.pagesGlobConfig?.tabBar,
+			list: this.pagesGlobConfig?.tabBar?.list || []
+		};
+		const pagePaths = /* @__PURE__ */ new Map();
+		for (const item of tabBar.list) pagePaths.set(item.pagePath, true);
+		tabBarItems.sort((a, b) => a.index - b.index);
+		for (const item of tabBarItems) if (!pagePaths.has(item.pagePath)) {
+			const { index: _, ...tabbar } = item;
+			tabBar.list.push(tabbar);
+		}
+		return tabBar;
+	}
+	/**
+	* Generate TypeScript declaration file
+	* Generate type definitions for page paths to provide type hints during navigation
+	*/
+	generateDeclaration() {
+		if (!this.options.dts) return;
+		debug$1.declaration("generating");
+		return writeDeclaration(this, this.options.dts);
+	}
+	async genratePagesJSON() {
+		const { pages: oldPages, subPackages: oldSubPackages, tabBar: oldTabBar } = (0, comment_json.parse)(await node_fs.default.promises.readFile(this.resolvedPagesJSONPath, { encoding: "utf-8" }).catch(() => "") || "{}");
+		const { pages: _pages, subPackages: _subPackages, tabBar: _tabBar, ...pageJson } = this.pagesGlobConfig || {};
+		const currentPlatform = _uni_helper_uni_env.platform.toUpperCase();
+		pageJson.pages = mergePlatformItems(oldPages, currentPlatform, this.pageMetaData, "path").map(stripType);
+		if (pageJson.pages && pageJson.pages.length > 0) {
+			const pagesArray = pageJson.pages;
+			const homeIndex = pagesArray.findIndex((page) => page.type === "home");
+			if (homeIndex > 0) {
+				const [homePage] = pagesArray.splice(homeIndex, 1);
+				pagesArray.unshift(homePage);
+			}
+		}
+		pageJson.subPackages = oldSubPackages || new comment_json.CommentArray();
+		const newSubPackages = /* @__PURE__ */ new Map();
+		for (const item of this.subPageMetaData) newSubPackages.set(item.root, item);
+		for (const existing of pageJson.subPackages) {
+			const sub = newSubPackages.get(existing.root);
+			if (sub) {
+				existing.pages = mergePlatformItems(existing.pages, currentPlatform, sub.pages, "path").map(stripType);
+				if (sub.plugins) existing.plugins = sub.plugins;
+				newSubPackages.delete(existing.root);
+			}
+		}
+		for (const [_, newSub] of newSubPackages) {
+			const subPackage = {
+				root: newSub.root,
+				pages: mergePlatformItems(void 0, currentPlatform, newSub.pages, "path").map(stripType)
+			};
+			if (newSub.plugins) subPackage.plugins = newSub.plugins;
+			pageJson.subPackages.push(subPackage);
+		}
+		const { list, ...tabBarOthers } = await this.resolveTabBar() || {};
+		if (list) {
+			const { list: oldList } = oldTabBar || {};
+			const newList = mergePlatformItems(oldList, currentPlatform, list, "pagePath");
+			pageJson.tabBar = {
+				...tabBarOthers,
+				list: newList
+			};
+		} else pageJson.tabBar = void 0;
+		return pageJson;
+	}
+	async readInfoFromPagesJSON() {
+		const resolvedPagesJSONContent = await node_fs.default.promises.readFile(this.resolvedPagesJSONPath, { encoding: "utf-8" }).catch(() => "");
+		this.resolvedPagesJSONIndent = (0, detect_indent.default)(resolvedPagesJSONContent).indent || "  ";
+		this.resolvedPagesJSONNewline = (0, detect_newline.default)(resolvedPagesJSONContent) || "\n";
+		this.resolvedPagesJSONEofNewline = (resolvedPagesJSONContent.at(-1) ?? "\n") === this.resolvedPagesJSONNewline;
+	}
+	async getIndent() {
+		if (!this.resolvedPagesJSONIndent) await this.readInfoFromPagesJSON();
+		return this.resolvedPagesJSONIndent;
+	}
+	async getNewline() {
+		if (!this.resolvedPagesJSONNewline) await this.readInfoFromPagesJSON();
+		return this.resolvedPagesJSONNewline;
+	}
+	async getEndOfLine() {
+		if (!this.resolvedPagesJSONEofNewline) await this.readInfoFromPagesJSON();
+		return this.resolvedPagesJSONEofNewline;
+	}
 };
-class PageContext {
-  constructor(userOptions, viteRoot = process__default.cwd()) {
-    __publicField(this, "_server");
-    __publicField(this, "pagesGlobConfig");
-    __publicField(this, "pagesConfigSourcePaths", []);
-    __publicField(this, "pages", /* @__PURE__ */ new Map());
-    // abs path -> Page
-    __publicField(this, "subPages", /* @__PURE__ */ new Map());
-    // root -> abs path -> page
-    __publicField(this, "pageMetaData", []);
-    __publicField(this, "subPageMetaData", []);
-    __publicField(this, "resolvedPagesJSONPath", "");
-    __publicField(this, "resolvedPagesJSONIndent");
-    // '  '
-    __publicField(this, "resolvedPagesJSONNewline");
-    // '\n'
-    __publicField(this, "resolvedPagesJSONEofNewline");
-    // true
-    __publicField(this, "rawOptions");
-    __publicField(this, "root");
-    __publicField(this, "options");
-    __publicField(this, "logger");
-    __publicField(this, "withUniPlatform", false);
-    __publicField(this, "lastPagesJson", "");
-    this.rawOptions = userOptions;
-    this.root = slash(viteRoot);
-    debug.options("root", this.root);
-    this.options = resolveOptions(userOptions, this.root);
-    const debugOption = this.options.debug;
-    if (debugOption) {
-      const prefix = "vite-plugin-uni-pages:";
-      const suffix = typeof debugOption === "boolean" ? "*" : debugOption;
-      Debug__default.enable(`${prefix}${suffix}`);
-    }
-    this.resolvedPagesJSONPath = path__default.join(this.root, this.options.outDir, OUTPUT_NAME);
-    debug.options(this.options);
-  }
-  setLogger(logger) {
-    this.logger = logger;
-  }
-  async loadUserPagesConfig() {
-    const configSource = this.options.configSource;
-    const { config, sources } = await unconfig.loadConfig({ cwd: this.root, sources: configSource, defaults: {} });
-    this.pagesGlobConfig = config.default || config;
-    this.pagesConfigSourcePaths = sources;
-    debug.options(this.pagesGlobConfig);
-  }
-  async scanPages() {
-    const pageDirFiles = this.options.dirs.map((dir) => {
-      return { dir, files: getPagePaths(dir, this.options) };
-    });
-    const paths = pageDirFiles.map((page) => page.files).flat();
-    debug.pages(paths);
-    const pages = /* @__PURE__ */ new Map();
-    for (const path2 of paths) {
-      const page = this.pages.get(path2.absolutePath) || new Page(this, path2);
-      pages.set(path2.absolutePath, page);
-    }
-    this.pages = pages;
-  }
-  async scanSubPages() {
-    const paths = {};
-    const subPages = /* @__PURE__ */ new Map();
-    for (const dir of this.options.subPackages) {
-      const pagePaths = getPagePaths(dir, this.options);
-      paths[dir] = pagePaths;
-      const pages = /* @__PURE__ */ new Map();
-      for (const path2 of pagePaths) {
-        const page = this.subPages.get(dir)?.get(path2.absolutePath) || new Page(this, path2);
-        pages.set(path2.absolutePath, page);
-      }
-      subPages.set(dir, pages);
-    }
-    debug.subPages(JSON.stringify(paths, null, 2));
-    this.subPages = subPages;
-  }
-  setupViteServer(server) {
-    if (this._server === server)
-      return;
-    this._server = server;
-    this.setupWatcher(server.watcher);
-  }
-  async setupWatcher(watcher) {
-    watcher.add(this.pagesConfigSourcePaths);
-    const targetDirs = [...this.options.dirs, ...this.options.subPackages].map((v) => slash(path__default.resolve(this.root, v)));
-    const isInTargetDirs = (filePath) => targetDirs.some((v) => slash(path__default.resolve(this.root, filePath)).startsWith(v));
-    watcher.on("add", async (path2) => {
-      path2 = slash(path2);
-      if (!isTargetFile(path2))
-        return;
-      if (!isInTargetDirs(path2))
-        return;
-      debug.pages(`File added: ${path2}`);
-      if (await this.updatePagesJSON())
-        this.onUpdate();
-    });
-    watcher.on("change", async (path2) => {
-      path2 = slash(path2);
-      if (!isTargetFile(path2))
-        return;
-      if (!isInTargetDirs(path2))
-        return;
-      debug.pages(`File changed: ${path2}`);
-      debug.pages(targetDirs);
-      debug.pages(isInTargetDirs(path2));
-      if (await this.updatePagesJSON(path2))
-        this.onUpdate();
-    });
-    watcher.on("change", async (path2) => {
-      if (this.pagesConfigSourcePaths.includes(path2)) {
-        debug.pages(`Config source changed: ${path2}`);
-        if (await this.updatePagesJSON())
-          this.onUpdate();
-      }
-    });
-    watcher.on("unlink", async (path2) => {
-      path2 = slash(path2);
-      if (!isTargetFile(path2))
-        return;
-      if (!isInTargetDirs(path2))
-        return;
-      debug.pages(`File removed: ${path2}`);
-      if (await this.updatePagesJSON())
-        this.onUpdate();
-    });
-  }
-  onUpdate() {
-    if (!this._server)
-      return;
-    invalidatePagesModule(this._server);
-    debug.hmr("Reload generated pages.");
-    this._server.ws.send({
-      type: "full-reload"
-    });
-  }
-  /**
-   * parse pages rules && set page type
-   * @param pages page path array
-   * @param type  page type
-   * @param overrides custom page config
-   * @returns pages rules
-   */
-  async parsePages(pages, type, overrides) {
-    const jobs = [];
-    for (const [_, page] of pages) {
-      jobs.push(page.getPageMeta());
-    }
-    const generatedPageMetaData = await Promise.all(jobs);
-    const customPageMetaData = overrides || [];
-    const result = customPageMetaData.length ? mergePageMetaDataArray(generatedPageMetaData.concat(customPageMetaData)) : generatedPageMetaData;
-    const parseMeta = Array.from(
-      result.reduce((map, page) => {
-        map.set(page.path, page);
-        return map;
-      }, /* @__PURE__ */ new Map()).values()
-    );
-    return type === "main" ? this.setHomePage(parseMeta) : parseMeta;
-  }
-  /**
-   * set home page
-   * @param result pages rules array
-   * @returns pages rules
-   */
-  setHomePage(result) {
-    const hasHome = result.some(({ type }) => type === "home");
-    if (!hasHome) {
-      const isFoundHome = result.some((item) => {
-        const isFound = this.options.homePage.find((v) => v === item.path);
-        if (isFound)
-          item.type = "home";
-        return isFound;
-      });
-      if (!isFoundHome) {
-        this.logger?.warn('No home page found, check the configuration of pages.config.ts, or add the `homePage` option to UniPages in vite.config.js, or add `type="home"` to the routeBlock of your vue page.', {
-          timestamp: true
-        });
-      }
-    }
-    result.sort((page) => page.type === "home" ? -1 : 0);
-    return result;
-  }
-  async mergePageMetaData() {
-    const subPageAbsolutePaths = Array.from(this.subPages.values()).flatMap((v) => Array.from(v.keys()));
-    for (const subPageAbsolutePath of subPageAbsolutePaths)
-      this.pages.delete(subPageAbsolutePath);
-    const pageMetaData = await this.parsePages(this.pages, "main", this.pagesGlobConfig?.pages);
-    this.pageMetaData = pageMetaData;
-    debug.pages(this.pageMetaData);
-  }
-  async mergeSubPageMetaData() {
-    const subPageMaps = {};
-    const subPackages = this.pagesGlobConfig?.subPackages || [];
-    for (const [dir, pages] of this.subPages) {
-      const basePath = slash(path__default.join(this.options.root, this.options.outDir));
-      const root = slash(path__default.relative(basePath, path__default.join(this.options.root, dir)));
-      const globPackage = subPackages?.find((v) => v.root === root);
-      subPageMaps[root] = await this.parsePages(pages, "sub", globPackage?.pages);
-      subPageMaps[root] = subPageMaps[root].map((page) => ({ ...page, path: slash(path__default.relative(root, page.path)) }));
-    }
-    for (const { root, pages } of subPackages) {
-      if (root && !subPageMaps[root])
-        subPageMaps[root] = pages || [];
-    }
-    const subPageMetaData = Object.keys(subPageMaps).map((root) => ({ root, pages: subPageMaps[root] })).filter((meta) => meta.pages.length > 0);
-    this.subPageMetaData = subPageMetaData;
-    debug.subPages(this.subPageMetaData);
-  }
-  async getTabBarMerged() {
-    const tabBarItems = [];
-    for (const [_, page] of this.pages) {
-      const tabbar = await page.getTabBar();
-      if (tabbar) {
-        tabBarItems.push(tabbar);
-      }
-    }
-    if (tabBarItems.length === 0) {
-      return this.pagesGlobConfig?.tabBar;
-    }
-    const tabBar = {
-      ...this.pagesGlobConfig?.tabBar,
-      list: this.pagesGlobConfig?.tabBar?.list || []
-    };
-    const pagePaths = /* @__PURE__ */ new Map();
-    for (const item of tabBar.list) {
-      pagePaths.set(item.pagePath, true);
-    }
-    tabBarItems.sort((a, b) => a.index - b.index);
-    for (const item of tabBarItems) {
-      if (!pagePaths.has(item.pagePath)) {
-        const { index: _, ...tabbar } = item;
-        tabBar.list.push(tabbar);
-      }
-    }
-    return tabBar;
-  }
-  async updatePagesJSON(filepath) {
-    if (filepath) {
-      let page = this.pages.get(filepath);
-      if (!page) {
-        let subPage;
-        for (const [_, pages2] of this.subPages) {
-          subPage = pages2.get(filepath);
-          if (subPage) {
-            break;
-          }
-        }
-        page = subPage;
-      }
-      if (page) {
-        await page.read();
-        if (!page.hasChanged()) {
-          debug.cache(`The route block on page ${filepath} did not send any changes, skipping`);
-          return false;
-        }
-      }
-    }
-    checkPagesJsonFileSync(this.resolvedPagesJSONPath);
-    this.options.onBeforeLoadUserConfig(this);
-    await this.loadUserPagesConfig();
-    this.options.onAfterLoadUserConfig(this);
-    if (this.options.mergePages) {
-      this.options.onBeforeScanPages(this);
-      await this.scanPages();
-      await this.scanSubPages();
-      this.options.onAfterScanPages(this);
-    }
-    this.options.onBeforeMergePageMetaData(this);
-    await this.mergePageMetaData();
-    await this.mergeSubPageMetaData();
-    this.options.onAfterMergePageMetaData(this);
-    const pagesMap = /* @__PURE__ */ new Map();
-    const pages = this.withUniPlatform ? this.pageMetaData.filter((v) => !/\..*$/.test(v.path) || v.path.includes(uniEnv.platform)).map((v) => {
-      v.path = v.path.replace(/\..*$/, "");
-      return v;
-    }) : this.pageMetaData;
-    pages.forEach((v) => pagesMap.set(v.path, v));
-    this.pageMetaData = [...pagesMap.values()];
-    this.options.onBeforeWriteFile(this);
-    const data = await this.genratePagesJSON();
-    const pagesJson = commentJson.stringify(
-      data,
-      null,
-      this.options.minify ? void 0 : await this.getIndent()
-    ) + (await this.getEndOfLine() ? await this.getNewline() : "");
-    this.generateDeclaration();
-    if (this.lastPagesJson === pagesJson) {
-      debug.pages("PagesJson Not have change");
-      return false;
-    }
-    await writeFileWithLock(this.resolvedPagesJSONPath, pagesJson);
-    this.lastPagesJson = pagesJson;
-    this.options.onAfterWriteFile(this);
-    return true;
-  }
-  virtualModule() {
-    const pages = `export const pages = ${this.resolveRoutes()};`;
-    const subPackages = `export const subPackages = ${this.resolveSubRoutes()};`;
-    return [pages, subPackages].join("\n");
-  }
-  resolveRoutes() {
-    return commentJson.stringify(this.pageMetaData, null, 2);
-  }
-  resolveSubRoutes() {
-    return commentJson.stringify(this.subPageMetaData, null, 2);
-  }
-  generateDeclaration() {
-    if (!this.options.dts)
-      return;
-    debug.declaration("generating");
-    return writeDeclaration(this, this.options.dts);
-  }
-  async genratePagesJSON() {
-    const content = await fs__default.promises.readFile(this.resolvedPagesJSONPath, { encoding: "utf-8" }).catch(() => "");
-    const { pages: oldPages, subPackages: oldSubPackages, tabBar: oldTabBar } = commentJson.parse(content || "{}");
-    const { pages: _, subPackages: __, tabBar: ___, ...pageJson } = this.pagesGlobConfig || {};
-    const currentPlatform = uniEnv.platform.toUpperCase();
-    pageJson.pages = mergePlatformItems(oldPages, currentPlatform, this.pageMetaData, "path");
-    pageJson.subPackages = oldSubPackages || new commentJson.CommentArray();
-    const newSubPackages = /* @__PURE__ */ new Map();
-    for (const item of this.subPageMetaData) {
-      newSubPackages.set(item.root, item);
-    }
-    for (const existing of pageJson.subPackages) {
-      const sub = newSubPackages.get(existing.root);
-      if (sub) {
-        existing.pages = mergePlatformItems(existing.pages, currentPlatform, sub.pages, "path");
-        newSubPackages.delete(existing.root);
-      }
-    }
-    for (const [_2, newSub] of newSubPackages) {
-      pageJson.subPackages.push({
-        root: newSub.root,
-        pages: mergePlatformItems(void 0, currentPlatform, newSub.pages, "path")
-      });
-    }
-    const { list, ...tabBarOthers } = await this.getTabBarMerged() || {};
-    if (list) {
-      const { list: oldList } = oldTabBar || {};
-      const newList = mergePlatformItems(oldList, currentPlatform, list, "pagePath");
-      pageJson.tabBar = {
-        ...tabBarOthers,
-        // 每次都直接更新除 list 外的其他属性
-        list: newList
-      };
-    } else {
-      pageJson.tabBar = void 0;
-    }
-    return pageJson;
-  }
-  async readInfoFromPagesJSON() {
-    const resolvedPagesJSONContent = await fs__default.promises.readFile(this.resolvedPagesJSONPath, { encoding: "utf-8" }).catch(() => "");
-    this.resolvedPagesJSONIndent = detectIndent__default(resolvedPagesJSONContent).indent || "  ";
-    this.resolvedPagesJSONNewline = detectNewline__default(resolvedPagesJSONContent) || "\n";
-    this.resolvedPagesJSONEofNewline = (resolvedPagesJSONContent.at(-1) ?? "\n") === this.resolvedPagesJSONNewline;
-  }
-  async getIndent() {
-    if (!this.resolvedPagesJSONIndent) {
-      await this.readInfoFromPagesJSON();
-    }
-    return this.resolvedPagesJSONIndent;
-  }
-  async getNewline() {
-    if (!this.resolvedPagesJSONNewline) {
-      await this.readInfoFromPagesJSON();
-    }
-    return this.resolvedPagesJSONNewline;
-  }
-  async getEndOfLine() {
-    if (!this.resolvedPagesJSONEofNewline) {
-      await this.readInfoFromPagesJSON();
-    }
-    return this.resolvedPagesJSONEofNewline;
-  }
-}
+/**
+* Get all page paths in the specified directory
+* @param dir - Page directory path
+* @param options - Resolved configuration options
+* @returns Page path array containing relative and absolute paths
+*/
 function getPagePaths(dir, options) {
-  const pagesDirPath = slash(path__default.resolve(options.root, dir));
-  const basePath = slash(path__default.join(options.root, options.outDir));
-  const files = getPageFiles(pagesDirPath, options);
-  debug.pages(dir, files);
-  const pagePaths = files.map((file) => slash(file)).map((file) => ({
-    relativePath: path__default.relative(basePath, slash(path__default.resolve(pagesDirPath, file))),
-    absolutePath: slash(path__default.resolve(pagesDirPath, file))
-  }));
-  return pagePaths;
+	const pagesDirPath = slash(node_path.default.resolve(options.root, dir));
+	const basePath = slash(node_path.default.join(options.root, options.outDir));
+	const files = getPageFiles(pagesDirPath, options);
+	debug$1.pages(dir, files);
+	return files.map((file) => slash(file)).map((file) => ({
+		relativePath: node_path.default.relative(basePath, slash(node_path.default.resolve(pagesDirPath, file))),
+		absolutePath: slash(node_path.default.resolve(pagesDirPath, file))
+	}));
 }
+/**
+* Merge multi-platform page configuration items
+* Handle conditional compilation comments (#ifdef / #endif), merge configuration items from different platforms into one array
+* Same configuration items will automatically merge platform identifiers, different configuration items will keep conditional compilation comments
+*
+* @param source - Existing configuration item array (from pages.json)
+* @param currentPlatform - Current platform identifier (e.g. H5, MP-WEIXIN)
+* @param items - New configuration item array
+* @param uniqueKeyName - Field name used to identify configuration item uniqueness (e.g. 'path' or 'pagePath')
+* @returns Merged configuration item array with conditional compilation comments
+*/
 function mergePlatformItems(source, currentPlatform, items, uniqueKeyName) {
-  const src = source || new commentJson.CommentArray();
-  currentPlatform = currentPlatform.toUpperCase();
-  let lastPlatforms = [];
-  for (const comment of src[Symbol.for("before:0")] || []) {
-    const trimed = comment.value.trim();
-    if (trimed.startsWith("GENERATED BY UNI-PAGES, PLATFORM:")) {
-      lastPlatforms = trimed.split(":")[1].split("||").map((s) => s.trim()).filter((s) => s !== currentPlatform).sort();
-    }
-  }
-  const tmpMap = /* @__PURE__ */ new Map();
-  for (let i = 0; i < src.length; i++) {
-    const item = src[i];
-    const uniqueKey = item[uniqueKeyName];
-    if (!uniqueKey) {
-      continue;
-    }
-    const beforeComments = src[Symbol.for(`before:${i}`)];
-    const ifdefComment = beforeComments?.find((c) => c.value.trim().startsWith("#ifdef"));
-    let platforms = [...lastPlatforms];
-    if (ifdefComment) {
-      const match = ifdefComment.value.match(/#ifdef\s+(.+)/);
-      if (match) {
-        platforms = match[1].split("||").map((p) => p.trim()).filter((s) => s !== currentPlatform).sort();
-      }
-    }
-    if (platforms.length === 0) {
-      continue;
-    }
-    const existing = tmpMap.get(uniqueKey) || [];
-    existing.push({ item, itemStr: JSON.stringify(item), platforms, platformStr: platforms.join(" || ") });
-    tmpMap.set(uniqueKey, existing);
-  }
-  for (const item of items) {
-    const newItem = item;
-    const uniqueKey = item[uniqueKeyName];
-    if (!uniqueKey) {
-      continue;
-    }
-    if (!tmpMap.has(uniqueKey)) {
-      tmpMap.set(uniqueKey, [{
-        item: newItem,
-        itemStr: JSON.stringify(newItem),
-        platforms: [currentPlatform],
-        platformStr: currentPlatform
-      }]);
-      continue;
-    }
-    const existing = tmpMap.get(uniqueKey);
-    const newItemStr = JSON.stringify(newItem);
-    const equalObj = existing.find((val) => val.itemStr === newItemStr);
-    if (equalObj) {
-      equalObj.platforms.push(currentPlatform);
-      equalObj.platforms.sort();
-      equalObj.platformStr = equalObj.platforms.join(" || ");
-    } else {
-      existing.push({
-        item: newItem,
-        itemStr: newItemStr,
-        platforms: [currentPlatform],
-        platformStr: currentPlatform
-      });
-    }
-  }
-  const result = new commentJson.CommentArray();
-  const platformUsage = {};
-  tmpMap.forEach((val) => {
-    Object.values(val).forEach((v) => {
-      platformUsage[v.platformStr] = (platformUsage[v.platformStr] || 0) + 1;
-    });
-  });
-  const usageKeys = Object.keys(platformUsage);
-  const defaultPlatformStr = usageKeys.length ? usageKeys.reduce((a, b) => platformUsage[a] > platformUsage[b] ? a : b) : currentPlatform;
-  result[Symbol.for("before:0")] = [{
-    type: "LineComment",
-    value: ` GENERATED BY UNI-PAGES, PLATFORM: ${defaultPlatformStr}`,
-    inline: false,
-    loc: {
-      start: { line: 0, column: 0 },
-      end: { line: 0, column: 0 }
-    }
-  }];
-  for (const [_, list] of tmpMap) {
-    for (const { item, platformStr } of list) {
-      result.push(item);
-      if (platformStr !== defaultPlatformStr) {
-        result[Symbol.for(`before:${result.length - 1}`)] = [{
-          type: "LineComment",
-          value: ` #ifdef ${platformStr}`,
-          inline: false,
-          loc: {
-            start: { line: 0, column: 0 },
-            end: { line: 0, column: 0 }
-          }
-        }];
-        result[Symbol.for(`after:${result.length - 1}`)] = [{
-          type: "LineComment",
-          value: " #endif",
-          inline: false,
-          loc: {
-            start: { line: 0, column: 0 },
-            end: { line: 0, column: 0 }
-          }
-        }];
-      }
-    }
-  }
-  return result;
+	const src = source || new comment_json.CommentArray();
+	currentPlatform = currentPlatform.toUpperCase();
+	let lastPlatforms = [];
+	for (const comment of src[Symbol.for("before:0")] || []) {
+		const trimed = comment.value.trim();
+		if (trimed.startsWith("GENERATED BY UNI-PAGES, PLATFORM:")) lastPlatforms = trimed.split(":")[1].split("||").map((s) => s.trim()).filter((s) => s !== currentPlatform).sort();
+	}
+	const tmpMap = /* @__PURE__ */ new Map();
+	for (let i = 0; i < src.length; i++) {
+		const item = src[i];
+		const uniqueKey = item[uniqueKeyName];
+		if (!uniqueKey) continue;
+		const ifdefComment = src[Symbol.for(`before:${i}`)]?.find((c) => c.value.trim().startsWith("#ifdef"));
+		let platforms = [...lastPlatforms];
+		if (ifdefComment) {
+			const match = ifdefComment.value.match(/#ifdef\s+(.+)/);
+			if (match) platforms = match[1].split("||").map((p) => p.trim()).filter((s) => s !== currentPlatform).sort();
+		}
+		if (platforms.length === 0) continue;
+		const existing = tmpMap.get(uniqueKey) || [];
+		existing.push({
+			item,
+			itemStr: JSON.stringify(item),
+			platforms,
+			platformStr: platforms.join(" || ")
+		});
+		tmpMap.set(uniqueKey, existing);
+	}
+	for (const item of items) {
+		const newItem = item;
+		const uniqueKey = item[uniqueKeyName];
+		if (!uniqueKey) continue;
+		if (!tmpMap.has(uniqueKey)) {
+			tmpMap.set(uniqueKey, [{
+				item: newItem,
+				itemStr: JSON.stringify(newItem),
+				platforms: [currentPlatform],
+				platformStr: currentPlatform
+			}]);
+			continue;
+		}
+		const existing = tmpMap.get(uniqueKey);
+		const newItemStr = JSON.stringify(newItem);
+		const equalObj = existing.find((val) => val.itemStr === newItemStr);
+		if (equalObj) {
+			equalObj.platforms.push(currentPlatform);
+			equalObj.platforms.sort();
+			equalObj.platformStr = equalObj.platforms.join(" || ");
+		} else existing.push({
+			item: newItem,
+			itemStr: newItemStr,
+			platforms: [currentPlatform],
+			platformStr: currentPlatform
+		});
+	}
+	const result = new comment_json.CommentArray();
+	const platformUsage = {};
+	tmpMap.forEach((val) => {
+		Object.values(val).forEach((v) => {
+			platformUsage[v.platformStr] = (platformUsage[v.platformStr] || 0) + 1;
+		});
+	});
+	const usageKeys = Object.keys(platformUsage);
+	const defaultPlatformStr = usageKeys.length ? usageKeys.reduce((a, b) => platformUsage[a] > platformUsage[b] ? a : b) : currentPlatform;
+	result[Symbol.for("before:0")] = [{
+		type: "LineComment",
+		value: ` GENERATED BY UNI-PAGES, PLATFORM: ${defaultPlatformStr}`,
+		inline: false,
+		loc: {
+			start: {
+				line: 0,
+				column: 0
+			},
+			end: {
+				line: 0,
+				column: 0
+			}
+		}
+	}];
+	for (const [_, list] of tmpMap) for (const { item, platformStr } of list) {
+		result.push(item);
+		if (platformStr !== defaultPlatformStr) {
+			result[Symbol.for(`before:${result.length - 1}`)] = [{
+				type: "LineComment",
+				value: ` #ifdef ${platformStr}`,
+				inline: false,
+				loc: {
+					start: {
+						line: 0,
+						column: 0
+					},
+					end: {
+						line: 0,
+						column: 0
+					}
+				}
+			}];
+			result[Symbol.for(`after:${result.length - 1}`)] = [{
+				type: "LineComment",
+				value: " #endif",
+				inline: false,
+				loc: {
+					start: {
+						line: 0,
+						column: 0
+					},
+					end: {
+						line: 0,
+						column: 0
+					}
+				}
+			}];
+		}
+	}
+	return result;
 }
-
+//#endregion
+//#region src/config/index.ts
+/**
+* Define uni-pages configuration
+* Used in pages.config.ts configuration file to provide type hints and validation
+*
+* @param config - Page configuration object
+* @returns Configuration object
+*/
 function defineUniPages(config) {
-  return config;
+	return config;
 }
-
+/**
+* vite-plugin-uni-pages plugin main entry
+*
+* Automatically scan page directories and generate pages.json configuration file
+* Support definePage macro for defining page metadata
+* Support multi-platform conditional compilation
+* Support sub-package configuration
+* Support TypeScript declaration file generation
+*
+* @param userOptions - User configuration options
+* @returns Vite plugin instance
+*/
 function VitePluginUniPages(userOptions = {}) {
-  let ctx;
-  const resolvedPagesJSONPath = path__default.join(
-    process__default.env.VITE_ROOT_DIR || process__default.cwd(),
-    userOptions.outDir ?? "src",
-    OUTPUT_NAME
-  );
-  checkPagesJsonFileSync(resolvedPagesJSONPath);
-  return {
-    name: "vite-plugin-uni-pages",
-    enforce: "pre",
-    async configResolved(config) {
-      ctx = new PageContext(userOptions, config.root);
-      if (config.plugins.some((v) => v.name === "vite-plugin-uni-platform"))
-        ctx.withUniPlatform = true;
-      const logger = vite.createLogger(void 0, {
-        prefix: "[vite-plugin-uni-pages]"
-      });
-      ctx.setLogger(logger);
-      await ctx.updatePagesJSON();
-      if (config.command === "build") {
-        if (config.build.watch)
-          ctx.setupWatcher(chokidar__default.watch([...ctx.options.dirs, ...ctx.options.subPackages]));
-      }
-    },
-    // Applet do not support custom route block, so we need to remove the route block here
-    async transform(code, id) {
-      if (!FILE_EXTENSIONS.find((ext) => id.endsWith(ext))) {
-        return null;
-      }
-      const sfc = parseSFC(code, { filename: id });
-      let macro;
-      if (sfc.scriptSetup) {
-        const ast = astKit.babelParse(sfc.scriptSetup.content, sfc.scriptSetup.lang || "js");
-        macro = findMacro(ast.body, sfc.filename);
-      }
-      if (!macro && sfc.script) {
-        const ast = astKit.babelParse(sfc.script.content, sfc.script.lang || "js");
-        macro = findMacro(ast.body, sfc.filename);
-      }
-      const routeBlock = sfc.customBlocks.find((block) => block.type === "route");
-      if (!macro && !routeBlock)
-        return null;
-      if (macro && routeBlock)
-        throw new Error(`\u4E0D\u652F\u6301\u6DF7\u5408\u4F7F\u7528 definePage() \u548C <route/> ${id}`);
-      const s = new MagicString__default(code);
-      if (macro)
-        s.remove(macro.start, macro.end);
-      if (routeBlock) {
-        console.log(kolorist.lightYellow("\u8B66\u544A\uFF1A"), `${kolorist.bold("<route/>")} \u6807\u7B7E\u5DF2\u5E9F\u5F03\uFF0C\u5C06\u5728\u4E0B\u4E00\u4E2A\u7248\u672C\u4E2D\u79FB\u9664\uFF0C\u8BF7\u4F7F\u7528 definePage() \u4EE3\u66FF\uFF1B${kolorist.link("\u67E5\u770B\u8FC1\u79FB\u6307\u5357", "https://uni-helper.js.org/vite-plugin-uni-pages/definePage")}\u3002`);
-        console.log(kolorist.dim(id));
-        console.log();
-        const routeBlockMatches = s.original.matchAll(
-          /<route[^>]*>([\s\S]*?)<\/route>/g
-        );
-        for (const match of routeBlockMatches) {
-          const index = match.index;
-          const length = match[0].length;
-          s.remove(index, index + length);
-        }
-      }
-      if (s.hasChanged()) {
-        return {
-          code: s.toString(),
-          map: s.generateMap({
-            source: id,
-            includeContent: true,
-            file: `${id}.map`
-          })
-        };
-      }
-    },
-    configureServer(server) {
-      ctx.setupViteServer(server);
-    },
-    resolveId(id) {
-      if (id === MODULE_ID_VIRTUAL)
-        return RESOLVED_MODULE_ID_VIRTUAL;
-    },
-    load(id) {
-      if (id === RESOLVED_MODULE_ID_VIRTUAL)
-        return ctx.virtualModule();
-    }
-  };
+	let ctx;
+	checkPagesJsonFileSync(node_path.default.join(node_process.default.env.VITE_ROOT_DIR || node_process.default.cwd(), userOptions.outDir ?? "src", OUTPUT_NAME));
+	return {
+		name: "vite-plugin-uni-pages",
+		enforce: "pre",
+		/**
+		* Vite configResolved hook
+		* Initialize PageContext, set logger, generate initial pages.json
+		*/
+		async configResolved(config) {
+			ctx = new PageContext(userOptions, config.root);
+			if (config.plugins.some((v) => v.name === "vite-plugin-uni-platform")) ctx.withUniPlatform = true;
+			const logger = (0, vite.createLogger)(void 0, { prefix: "[vite-plugin-uni-pages]" });
+			ctx.setLogger(logger);
+			await ctx.updatePagesJSON();
+			if (config.command === "build") {
+				if (config.build.watch) ctx.setupWatcher(chokidar.default.watch([...ctx.options.dirs, ...ctx.options.subPackages]));
+			}
+		},
+		/**
+		* Code transform hook
+		* Remove definePage macro calls from Vue SFC to avoid runtime errors
+		*/
+		async transform(code, id) {
+			if (!FILE_EXTENSIONS.some((ext) => id.endsWith(ext))) return null;
+			const sfc = parseSFC(code, { filename: id });
+			let macro;
+			if (sfc.scriptSetup) macro = findMacro((0, ast_kit.babelParse)(sfc.scriptSetup.content, sfc.scriptSetup.lang || "js").body, sfc.filename);
+			if (!macro && sfc.script) macro = findMacro((0, ast_kit.babelParse)(sfc.script.content, sfc.script.lang || "js").body, sfc.filename);
+			if (!macro) return null;
+			const s = new magic_string.default(code);
+			s.remove(macro.start, macro.end);
+			if (s.hasChanged()) return {
+				code: s.toString(),
+				map: s.generateMap({
+					source: id,
+					includeContent: true,
+					file: `${id}.map`
+				})
+			};
+		},
+		/**
+		* Configure server hook
+		* Set up file watching and HMR support
+		*/
+		configureServer(server) {
+			ctx.setupViteServer(server);
+		},
+		/**
+		* Module resolution hook
+		* Resolve virtual module identifier to internal path
+		*/
+		resolveId(id) {
+			if (id === "virtual:uni-pages") return RESOLVED_MODULE_ID_VIRTUAL;
+		},
+		/**
+		* Module load hook
+		* Return the code content of the virtual module
+		*/
+		load(id) {
+			if (id === RESOLVED_MODULE_ID_VIRTUAL) return ctx.virtualModule();
+		}
+	};
 }
-
+//#endregion
 exports.FILE_EXTENSIONS = FILE_EXTENSIONS;
 exports.MODULE_ID_VIRTUAL = MODULE_ID_VIRTUAL;
 exports.OUTPUT_NAME = OUTPUT_NAME;
@@ -1221,26 +1342,37 @@ exports.Page = Page;
 exports.PageContext = PageContext;
 exports.RESOLVED_MODULE_ID_VIRTUAL = RESOLVED_MODULE_ID_VIRTUAL;
 exports.VitePluginUniPages = VitePluginUniPages;
+exports.default = VitePluginUniPages;
 exports.babelGenerate = babelGenerate;
 exports.checkPagesJsonFileSync = checkPagesJsonFileSync;
-exports.debug = debug;
-exports.default = VitePluginUniPages;
+exports.debug = debug$1;
+Object.defineProperty(exports, "definePage", {
+	enumerable: true,
+	get: function() {
+		return _uni_helper_uni_pages_types.definePage;
+	}
+});
 exports.defineUniPages = defineUniPages;
 exports.extsToGlob = extsToGlob;
 exports.findImports = findImports;
 exports.findMacro = findMacro;
 exports.getPageFiles = getPageFiles;
-exports.getRouteBlock = getRouteBlock;
-exports.getRouteSfcBlock = getRouteSfcBlock;
 exports.invalidatePagesModule = invalidatePagesModule;
 exports.isTargetFile = isTargetFile;
 exports.mergePageMetaDataArray = mergePageMetaDataArray;
 exports.parseCode = parseCode;
-exports.parseCustomBlock = parseCustomBlock;
 exports.parseSFC = parseSFC;
 exports.resolveOptions = resolveOptions;
 exports.resolvePageDirs = resolvePageDirs;
 exports.sleep = sleep;
-exports.tryPageMetaFromCustomBlock = tryPageMetaFromCustomBlock;
+exports.stripType = stripType;
 exports.tryPageMetaFromMacro = tryPageMetaFromMacro;
 exports.writeFileWithLock = writeFileWithLock;
+Object.keys(_uni_helper_uni_pages_types).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _uni_helper_uni_pages_types[k];
+		}
+	});
+});