@univa/core 0.0.7 → 0.0.8

package/dist/global.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="@dcloudio/types" />
+/// <reference types="vite/client" />
+/// <reference types="@uni-helper/vite-plugin-uni-pages/client" />
+/// <reference types="@uni-helper/uni-types" />

package/dist/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AutoImport: () => import_vite3.default,
+  AutoImport: () => import_vite4.default,
   PageContext: () => import_vite_plugin_uni_pages2.PageContext,
   UniKuRoot: () => import_root2.default,
   Univa: () => plugins_default,
@@ -56,12 +56,13 @@ var import_plugin_uni = __toESM(require("@uni-helper/plugin-uni"), 1);
 var import_vite_plugin_uni_components = __toESM(require("@uni-helper/vite-plugin-uni-components"), 1);
 var import_vite_plugin_uni_layouts = require("@uni-helper/vite-plugin-uni-layouts");
 var import_root = __toESM(require("@uni-ku/root"), 1);
-var import_vite = __toESM(require("unocss/vite"), 1);
-var import_vite2 = __toESM(require("unplugin-auto-import/vite"), 1);
+var import_vite2 = __toESM(require("unocss/vite"), 1);
+var import_vite3 = __toESM(require("unplugin-auto-import/vite"), 1);
 
 // src/constant.ts
 var ID = "univa";
 var UNIVA_DIR_NAME = `.${ID}`;
+var ROOT_NAME = `${ID}.root`;
 
 // src/utils/fs.ts
 var import_node_fs = require("fs");
@@ -80,11 +81,22 @@ function ensureUnivaDir(cwd) {
   return dir;
 }
 
+// src/utils/logger.ts
+var debugMode = false;
+function setDebug(enabled) {
+  debugMode = enabled;
+}
+function log(message, ...args) {
+  if (debugMode) {
+    console.log(`[${ID}]`, message, ...args);
+  }
+}
+
 // src/plugins/context.ts
-var import_node_fs3 = require("fs");
-var import_node_path3 = require("path");
+var import_node_fs4 = require("fs");
+var import_node_path4 = require("path");
 var import_utils = require("@antfu/utils");
-var import_c12 = require("c12");
+var import_c122 = require("c12");
 var import_jiti = require("jiti");
 
 // src/utils/merge.ts
@@ -96,12 +108,115 @@ var mergeWithArrayOverride = (0, import_defu.createDefu)((originObj, key, update
   }
 });
 
-// src/plugins/pages.ts
+// src/plugins/manifest.ts
 var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
+var import_node_process = __toESM(require("process"), 1);
+var import_vite_plugin_uni_manifest = require("@uni-helper/vite-plugin-uni-manifest");
+var import_c12 = require("c12");
+var import_vite = require("vite");
+function resolveOptions(userOptions) {
+  return {
+    minify: false,
+    insertFinalNewline: false,
+    cwd: import_node_process.default.env.VITE_ROOT_DIR,
+    merge: true,
+    ...userOptions
+  };
+}
+function writeManifestJson(config = {}, opts) {
+  const path = resolveManifestJsonPath();
+  let mergeContent = {};
+  if (opts?.merge && (0, import_node_fs2.existsSync)(path)) {
+    try {
+      const content2 = (0, import_node_fs2.readFileSync)(path, "utf-8");
+      mergeContent = JSON.parse(content2);
+    } catch (error) {
+      log(`manifest.json parse error: ${error}`);
+    }
+  }
+  const content = JSON.stringify(opts?.merge ? mergeWithArrayOverride(config, mergeContent) : config, null, opts?.minify ? 0 : 2) + (opts?.insertFinalNewline ? "\n" : "");
+  if ((0, import_node_fs2.existsSync)(path) && (0, import_node_fs2.readFileSync)(path, "utf-8") === content) {
+    return;
+  }
+  (0, import_node_fs2.writeFileSync)(path, content);
+}
+function resolveManifestJsonPath() {
+  return (0, import_vite.normalizePath)(
+    (0, import_node_path2.resolve)(import_node_process.default.env.UNI_INPUT_DIR || `${import_node_process.default.cwd()}/src`, "manifest.json")
+  );
+}
+var ManifestContext = class {
+  options;
+  unwatch;
+  constructor(options) {
+    this.options = resolveOptions(options);
+  }
+  /**
+   * Start watching config sources and perform initial write.
+   * Must be called after construction.
+   */
+  async setup() {
+    log(`manifest cwd: ${this.options.cwd}`);
+    const { config, unwatch } = await (0, import_c12.watchConfig)({
+      cwd: this.options.cwd,
+      name: "manifest",
+      rcFile: false,
+      packageJson: false,
+      onUpdate: (config2) => {
+        writeManifestJson(config2.newConfig.config, this.options);
+      }
+    });
+    writeManifestJson(config, this.options);
+    this.unwatch = unwatch;
+  }
+};
+function VitePluginUniManifest(userOptions = {}) {
+  let ctx;
+  return {
+    name: "vite-plugin-uni-manifest",
+    // Run before other plugins to ensure manifest.json is ready
+    enforce: "pre",
+    async configResolved() {
+      (0, import_vite_plugin_uni_manifest.ensureManifestJsonExists)();
+      ctx = new ManifestContext(userOptions);
+      await ctx.setup();
+    },
+    buildEnd: () => ctx?.unwatch()
+  };
+}
+function generateManifestConfigContent(content = {}) {
+  return `// Auto-generated by @univa/core
+export default ${JSON.stringify(content, null, 2)}
+  `;
+}
+function generateManifestConfigFile(content = {}, root) {
+  const configPath = getManifestConfigPath(root);
+  const newContent = generateManifestConfigContent(content);
+  if ((0, import_node_fs2.existsSync)(configPath)) {
+    const existingContent = (0, import_node_fs2.readFileSync)(configPath, "utf-8");
+    if (existingContent === newContent) {
+      return;
+    }
+  }
+  (0, import_node_fs2.writeFileSync)(configPath, newContent, "utf-8");
+}
+function getManifestConfigPath(root) {
+  return (0, import_node_path2.join)(getUnivaDir(root), "manifest.config.ts");
+}
+function createManifestPlugin(userOptions = {}) {
+  return VitePluginUniManifest({
+    cwd: (0, import_node_path2.join)(import_node_process.default.env.VITE_ROOT_DIR || "", UNIVA_DIR_NAME),
+    ...userOptions
+  });
+}
+
+// src/plugins/pages.ts
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
 var import_vite_plugin_uni_pages = require("@uni-helper/vite-plugin-uni-pages");
 function getPagesConfigPath(root) {
-  return (0, import_node_path2.join)(getUnivaDir(root), "pages-config.ts");
+  return (0, import_node_path3.join)(getUnivaDir(root), "pages-config.ts");
 }
 function generatePagesConfigContent(content) {
   const { pages, subPackages, ...rest } = content;
@@ -115,13 +230,13 @@ export default ${JSON.stringify(rest, null, 2)}
 function generatePagesConfigFile(content, root) {
   const pagesConfigPath = getPagesConfigPath(root);
   const newContent = generatePagesConfigContent(content);
-  if ((0, import_node_fs2.existsSync)(pagesConfigPath)) {
-    const existingContent = (0, import_node_fs2.readFileSync)(pagesConfigPath, "utf-8");
+  if ((0, import_node_fs3.existsSync)(pagesConfigPath)) {
+    const existingContent = (0, import_node_fs3.readFileSync)(pagesConfigPath, "utf-8");
     if (existingContent === newContent) {
       return;
     }
   }
-  (0, import_node_fs2.writeFileSync)(pagesConfigPath, newContent, "utf-8");
+  (0, import_node_fs3.writeFileSync)(pagesConfigPath, newContent, "utf-8");
 }
 function createPagesPlugin(pluginOptions) {
   const result = (0, import_vite_plugin_uni_pages.VitePluginUniPages)({
@@ -134,23 +249,11 @@ function createPagesPlugin(pluginOptions) {
 }
 
 // src/plugins/context.ts
-var DEFAULT_ROOT_FILE_NAME = "App.ku.vue";
 var APP_KU_VUE_TEMPLATE = `<!-- Auto-generated by @univa/core -->
-<!-- UniKuRoot \u865A\u62DF\u6839\u7EC4\u4EF6\uFF0C\u53EF\u5728\u6B64\u6DFB\u52A0\u5168\u5C40\u7EC4\u4EF6\uFF08\u5982 Toast\u3001ConfigProvider \u7B49\uFF09 -->
 <template>
   <KuRootView />
 </template>
 `;
-function ensureRootComponent(config, root) {
-  const srcDir = config?.srcDir || "src";
-  const rootFileName = config?.overrides?.root?.rootFileName || DEFAULT_ROOT_FILE_NAME;
-  const rootComponentPath = (0, import_node_path3.join)(root, srcDir, rootFileName);
-  if ((0, import_node_fs3.existsSync)(rootComponentPath)) {
-    return;
-  }
-  (0, import_node_fs3.writeFileSync)(rootComponentPath, APP_KU_VUE_TEMPLATE, "utf-8");
-  console.log(`[univa] \u5DF2\u751F\u6210\u865A\u62DF\u6839\u7EC4\u4EF6\uFF1A${(0, import_utils.slash)(rootComponentPath)}`);
-}
 var UnivaContext = class {
   _server;
   config;
@@ -159,12 +262,32 @@ var UnivaContext = class {
   constructor(options) {
     this.root = options.root;
   }
+  /**
+   * 确保虚拟根组件文件存在
+   *
+   * UniKuRoot 插件依赖 src 下的虚拟根组件文件（默认 App.ku.vue）。
+   * 若不存在则生成最小模板，避免插件注入 import 时解析失败。
+   *
+   * 必须在 Vite 启动前调用（Univa() 初始化阶段），
+   * 否则在 configResolved 阶段创建 src 下新文件会触发 watcher add 事件，
+   * 导致 Vite 重编译与 VitePluginUniPages 的 pages.json 写入冲突（EPERM）。
+   */
+  ensureRootComponent(fileName) {
+    const srcDir = this.config?.srcDir || "src";
+    const rootFileName = this.config?.overrides?.root?.rootFileName || fileName;
+    const rootComponentPath = (0, import_node_path4.join)(this.root, srcDir, rootFileName);
+    if ((0, import_node_fs4.existsSync)(rootComponentPath)) {
+      return;
+    }
+    (0, import_node_fs4.writeFileSync)(rootComponentPath, APP_KU_VUE_TEMPLATE, "utf-8");
+    log(`\u5DF2\u751F\u6210\u865A\u62DF\u6839\u7EC4\u4EF6\uFF1A${(0, import_utils.slash)(rootComponentPath)}`);
+  }
   /**
    * 同步加载用户配置（univa.config.ts）
    */
   loadUserConfigSync() {
     const jiti = (0, import_jiti.createJiti)(this.root);
-    const configFile = (0, import_node_path3.join)(this.root, `${ID}.config`);
+    const configFile = (0, import_node_path4.join)(this.root, `${ID}.config`);
     try {
       const configModule = jiti(configFile);
       const userConfig = configModule?.default || configModule;
@@ -177,7 +300,7 @@ var UnivaContext = class {
    * 异步加载用户配置（c12 支持更多格式与合并能力）
    */
   async loadUserConfigAsync() {
-    const { config: userConfig, configFile } = await (0, import_c12.loadConfig)({
+    const { config: userConfig, configFile } = await (0, import_c122.loadConfig)({
       name: ID,
       cwd: this.root,
       defaults: this.config || {},
@@ -223,26 +346,33 @@ var UnivaContext = class {
    * 更新生成的文件
    *
    * 读取 univa.config.ts 的 pages 字段（应用级配置），
-   * 生成 .univa/pages.ts 供 VitePluginUniPages 消费。
-   * 同时确保 UniKuRoot 虚拟根组件文件存在。
+   * 生成 .univa/pages-config.ts 供 VitePluginUniPages 消费。
+   *
+   * 注意：不在此处生成 src/App.ku.vue，避免在 configResolved 阶段
+   * 创建 src 下新文件触发 watcher add 事件，导致 Vite 重编译
+   * 与 VitePluginUniPages 的 pages.json 写入冲突（EPERM）。
+   * App.ku.vue 的生成在 Univa() 初始化阶段完成。
    */
   updateGeneratedFiles() {
     const pagesConfig = this.config?.pages;
     if (pagesConfig) {
       generatePagesConfigFile(pagesConfig, this.root);
     }
+    const manifestConfig = this.config?.manifest;
+    if (manifestConfig) {
+      generateManifestConfigFile(manifestConfig, this.root);
+    }
     const pagesTsPath = getPagesConfigPath(this.root);
     const emptyContent = `// Auto-generated by @univa/core
 export default {}
 `;
-    if (!(0, import_node_fs3.existsSync)(pagesTsPath)) {
-      (0, import_node_fs3.writeFileSync)(pagesTsPath, emptyContent, "utf-8");
+    if (!(0, import_node_fs4.existsSync)(pagesTsPath)) {
+      (0, import_node_fs4.writeFileSync)(pagesTsPath, emptyContent, "utf-8");
     } else if (!pagesConfig) {
-      if ((0, import_node_fs3.readFileSync)(pagesTsPath, "utf-8") !== emptyContent) {
-        (0, import_node_fs3.writeFileSync)(pagesTsPath, emptyContent, "utf-8");
+      if ((0, import_node_fs4.readFileSync)(pagesTsPath, "utf-8") !== emptyContent) {
+        (0, import_node_fs4.writeFileSync)(pagesTsPath, emptyContent, "utf-8");
       }
     }
-    ensureRootComponent(this.config, this.root);
   }
   /**
    * 更新回调
@@ -268,7 +398,7 @@ var DEFAULT_IMPORTS = {
   apis: ["vue", "uni-app", "composables/**", "stores/**", "hooks/**", "constants/**"],
   components: ["components/**", "components-biz/**"]
 };
-function resolveOptions(userOptions) {
+function resolveOptions2(userOptions) {
   const srcDir = userOptions.srcDir || "src";
   const dirs = {
     pages: userOptions.dirs?.pages ?? DEFAULT_DIRS.pages,
@@ -341,7 +471,9 @@ function createUnivaPlugins(resolved) {
     ...resolved.overrides?.layouts
   }));
   plugins.push((0, import_root.default)({
+    enabledVirtualHost: true,
     enabledGlobalRef: true,
+    rootFileName: ROOT_NAME,
     excludePages: [
       "components-async/**/*.*"
     ],
@@ -354,10 +486,13 @@ function createUnivaPlugins(resolved) {
     directoryAsNamespace: true,
     ...resolved.overrides?.components
   }));
+  plugins.push(createManifestPlugin({
+    ...resolved.overrides?.manifest
+  }));
   plugins.push(...(0, import_plugin_uni.default)());
-  plugins.push(...(0, import_vite.default)());
+  plugins.push(...(0, import_vite2.default)());
   const { presets, dirs } = resolveApiSources(resolved.imports.apis, srcDir);
-  const autoImportPlugin = (0, import_vite2.default)({
+  const autoImportPlugin = (0, import_vite3.default)({
     imports: presets,
     dirs,
     dts: `${UNIVA_DIR_NAME}/auto-imports.d.ts`,
@@ -376,8 +511,10 @@ function Univa() {
   });
   ensureUnivaDir(context.root);
   context.loadUserConfigSync();
-  const resolved = resolveOptions(context.config || {});
-  console.log("[univa] \u5DF2\u52A0\u8F7D\u914D\u7F6E\uFF1A", context.configPath || "\u9ED8\u8BA4\u914D\u7F6E");
+  setDebug(context.config?.debug ?? false);
+  context.ensureRootComponent(`${ROOT_NAME}.vue`);
+  const resolved = resolveOptions2(context.config || {});
+  log("\u5DF2\u52A0\u8F7D\u914D\u7F6E\uFF1A", context.configPath || "\u9ED8\u8BA4\u914D\u7F6E");
   return createUnivaPlugins(resolved);
 }
 var plugins_default = Univa;
@@ -389,7 +526,7 @@ var import_vite_plugin_uni_components3 = __toESM(require("@uni-helper/vite-plugi
 var import_vite_plugin_uni_layouts2 = require("@uni-helper/vite-plugin-uni-layouts");
 var import_vite_plugin_uni_pages2 = require("@uni-helper/vite-plugin-uni-pages");
 var import_root2 = __toESM(require("@uni-ku/root"), 1);
-var import_vite3 = __toESM(require("unplugin-auto-import/vite"), 1);
+var import_vite4 = __toESM(require("unplugin-auto-import/vite"), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AutoImport,

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import { PagesConfig } from '@uni-helper/uni-pages-types';
 export { Condition, EasyCom, GlobalStyle, PageMetaDatum, PagesConfig, SubPackage, TabBar, TabBarItem } from '@uni-helper/uni-pages-types';
 import { Options } from '@uni-helper/vite-plugin-uni-components';
 export { ComponentInfo, ComponentResolver, Options as ComponentsOptions, ResolvedOptions as ComponentsResolvedOptions, ImportInfo, default as VitePluginUniComponents, camelCase, kebabCase, pascalCase } from '@uni-helper/vite-plugin-uni-components';
+import { UserManifestConfig } from '@uni-helper/vite-plugin-uni-manifest';
 import { UserOptions } from '@uni-helper/vite-plugin-uni-pages';
 export { PageContext, PagePath, UserOptions as PagesPluginOptions, ResolvedOptions as PagesResolvedOptions, SubPageMetaDatum, VitePluginUniPages, definePage } from '@uni-helper/vite-plugin-uni-pages';
 import { Options as Options$1 } from 'unplugin-auto-import/types';
@@ -12,6 +13,32 @@ export { VitePluginUniLayouts } from '@uni-helper/vite-plugin-uni-layouts';
 export { default as UniKuRoot } from '@uni-ku/root';
 export { default as AutoImport } from 'unplugin-auto-import/vite';
 
+interface ManifestOptions {
+    /**
+     * minify the `manifest.json`
+     * @default false
+     */
+    minify: boolean;
+    /**
+     * insert newline at the end of the `manifest.json`
+     * @default false
+     */
+    insertFinalNewline: boolean;
+    /**
+     * Resolve configuration from this working directory.
+     * @default process.env.VITE_ROOT_DIR
+     */
+    cwd?: string;
+    /**
+     * Merge the manifest config with the default config.
+     * @default false
+     */
+    merge?: boolean;
+}
+/** User-facing options — all fields are optional. */
+interface UserManifestOptions extends Partial<ManifestOptions> {
+}
+
 /**
  * Univa 类型定义统一导出
  *
@@ -115,6 +142,8 @@ interface UnivaOverrides {
     autoImport?: Options$1;
     /** unocss/vite 完整选项 */
     unocss?: UnoCSSOptions;
+    /** @uni-helper/vite-plugin-uni-manifest 完整选项 */
+    manifest?: UserManifestOptions;
 }
 /**
  * Univa 统一配置接口（工程级约定）
@@ -124,6 +153,8 @@ interface UnivaOverrides {
 interface UnivaOptions {
     /** 源码目录，相对 Vite root，默认 'src' */
     srcDir?: string;
+    /** 开启调试日志，默认 false */
+    debug?: boolean;
     /** 目录约定，相对 srcDir */
     dirs?: UnivaDirs;
     /** 自动导入配置 */
@@ -137,6 +168,8 @@ interface UnivaOptions {
      * 注意：pages / subPackages 由目录扫描自动填充，请勿在此手写。
      */
     pages?: Partial<PagesConfig>;
+    /** 应用级 manifest.json 配置 */
+    manifest?: Partial<UserManifestConfig>;
     /** 底层插件逃生口（覆盖融合层默认，高级用户使用） */
     overrides?: UnivaOverrides;
 }

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { PagesConfig } from '@uni-helper/uni-pages-types';
 export { Condition, EasyCom, GlobalStyle, PageMetaDatum, PagesConfig, SubPackage, TabBar, TabBarItem } from '@uni-helper/uni-pages-types';
 import { Options } from '@uni-helper/vite-plugin-uni-components';
 export { ComponentInfo, ComponentResolver, Options as ComponentsOptions, ResolvedOptions as ComponentsResolvedOptions, ImportInfo, default as VitePluginUniComponents, camelCase, kebabCase, pascalCase } from '@uni-helper/vite-plugin-uni-components';
+import { UserManifestConfig } from '@uni-helper/vite-plugin-uni-manifest';
 import { UserOptions } from '@uni-helper/vite-plugin-uni-pages';
 export { PageContext, PagePath, UserOptions as PagesPluginOptions, ResolvedOptions as PagesResolvedOptions, SubPageMetaDatum, VitePluginUniPages, definePage } from '@uni-helper/vite-plugin-uni-pages';
 import { Options as Options$1 } from 'unplugin-auto-import/types';
@@ -12,6 +13,32 @@ export { VitePluginUniLayouts } from '@uni-helper/vite-plugin-uni-layouts';
 export { default as UniKuRoot } from '@uni-ku/root';
 export { default as AutoImport } from 'unplugin-auto-import/vite';
 
+interface ManifestOptions {
+    /**
+     * minify the `manifest.json`
+     * @default false
+     */
+    minify: boolean;
+    /**
+     * insert newline at the end of the `manifest.json`
+     * @default false
+     */
+    insertFinalNewline: boolean;
+    /**
+     * Resolve configuration from this working directory.
+     * @default process.env.VITE_ROOT_DIR
+     */
+    cwd?: string;
+    /**
+     * Merge the manifest config with the default config.
+     * @default false
+     */
+    merge?: boolean;
+}
+/** User-facing options — all fields are optional. */
+interface UserManifestOptions extends Partial<ManifestOptions> {
+}
+
 /**
  * Univa 类型定义统一导出
  *
@@ -115,6 +142,8 @@ interface UnivaOverrides {
     autoImport?: Options$1;
     /** unocss/vite 完整选项 */
     unocss?: UnoCSSOptions;
+    /** @uni-helper/vite-plugin-uni-manifest 完整选项 */
+    manifest?: UserManifestOptions;
 }
 /**
  * Univa 统一配置接口（工程级约定）
@@ -124,6 +153,8 @@ interface UnivaOverrides {
 interface UnivaOptions {
     /** 源码目录，相对 Vite root，默认 'src' */
     srcDir?: string;
+    /** 开启调试日志，默认 false */
+    debug?: boolean;
     /** 目录约定，相对 srcDir */
     dirs?: UnivaDirs;
     /** 自动导入配置 */
@@ -137,6 +168,8 @@ interface UnivaOptions {
      * 注意：pages / subPackages 由目录扫描自动填充，请勿在此手写。
      */
     pages?: Partial<PagesConfig>;
+    /** 应用级 manifest.json 配置 */
+    manifest?: Partial<UserManifestConfig>;
     /** 底层插件逃生口（覆盖融合层默认，高级用户使用） */
     overrides?: UnivaOverrides;
 }

package/dist/index.js

@@ -14,6 +14,7 @@ import AutoImport from "unplugin-auto-import/vite";
 // src/constant.ts
 var ID = "univa";
 var UNIVA_DIR_NAME = `.${ID}`;
+var ROOT_NAME = `${ID}.root`;
 
 // src/utils/fs.ts
 import { existsSync, mkdirSync } from "fs";
@@ -32,9 +33,20 @@ function ensureUnivaDir(cwd) {
   return dir;
 }
 
+// src/utils/logger.ts
+var debugMode = false;
+function setDebug(enabled) {
+  debugMode = enabled;
+}
+function log(message, ...args) {
+  if (debugMode) {
+    console.log(`[${ID}]`, message, ...args);
+  }
+}
+
 // src/plugins/context.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join4 } from "path";
 import { slash } from "@antfu/utils";
 import { loadConfig } from "c12";
 import { createJiti } from "jiti";
@@ -48,12 +60,115 @@ var mergeWithArrayOverride = createDefu((originObj, key, updates) => {
   }
 });
 
-// src/plugins/pages.ts
+// src/plugins/manifest.ts
 import { existsSync as existsSync2, readFileSync, writeFileSync } from "fs";
-import { join as join2 } from "path";
+import { join as join2, resolve } from "path";
+import process2 from "process";
+import { ensureManifestJsonExists } from "@uni-helper/vite-plugin-uni-manifest";
+import { watchConfig } from "c12";
+import { normalizePath } from "vite";
+function resolveOptions(userOptions) {
+  return {
+    minify: false,
+    insertFinalNewline: false,
+    cwd: process2.env.VITE_ROOT_DIR,
+    merge: true,
+    ...userOptions
+  };
+}
+function writeManifestJson(config = {}, opts) {
+  const path = resolveManifestJsonPath();
+  let mergeContent = {};
+  if (opts?.merge && existsSync2(path)) {
+    try {
+      const content2 = readFileSync(path, "utf-8");
+      mergeContent = JSON.parse(content2);
+    } catch (error) {
+      log(`manifest.json parse error: ${error}`);
+    }
+  }
+  const content = JSON.stringify(opts?.merge ? mergeWithArrayOverride(config, mergeContent) : config, null, opts?.minify ? 0 : 2) + (opts?.insertFinalNewline ? "\n" : "");
+  if (existsSync2(path) && readFileSync(path, "utf-8") === content) {
+    return;
+  }
+  writeFileSync(path, content);
+}
+function resolveManifestJsonPath() {
+  return normalizePath(
+    resolve(process2.env.UNI_INPUT_DIR || `${process2.cwd()}/src`, "manifest.json")
+  );
+}
+var ManifestContext = class {
+  options;
+  unwatch;
+  constructor(options) {
+    this.options = resolveOptions(options);
+  }
+  /**
+   * Start watching config sources and perform initial write.
+   * Must be called after construction.
+   */
+  async setup() {
+    log(`manifest cwd: ${this.options.cwd}`);
+    const { config, unwatch } = await watchConfig({
+      cwd: this.options.cwd,
+      name: "manifest",
+      rcFile: false,
+      packageJson: false,
+      onUpdate: (config2) => {
+        writeManifestJson(config2.newConfig.config, this.options);
+      }
+    });
+    writeManifestJson(config, this.options);
+    this.unwatch = unwatch;
+  }
+};
+function VitePluginUniManifest(userOptions = {}) {
+  let ctx;
+  return {
+    name: "vite-plugin-uni-manifest",
+    // Run before other plugins to ensure manifest.json is ready
+    enforce: "pre",
+    async configResolved() {
+      ensureManifestJsonExists();
+      ctx = new ManifestContext(userOptions);
+      await ctx.setup();
+    },
+    buildEnd: () => ctx?.unwatch()
+  };
+}
+function generateManifestConfigContent(content = {}) {
+  return `// Auto-generated by @univa/core
+export default ${JSON.stringify(content, null, 2)}
+  `;
+}
+function generateManifestConfigFile(content = {}, root) {
+  const configPath = getManifestConfigPath(root);
+  const newContent = generateManifestConfigContent(content);
+  if (existsSync2(configPath)) {
+    const existingContent = readFileSync(configPath, "utf-8");
+    if (existingContent === newContent) {
+      return;
+    }
+  }
+  writeFileSync(configPath, newContent, "utf-8");
+}
+function getManifestConfigPath(root) {
+  return join2(getUnivaDir(root), "manifest.config.ts");
+}
+function createManifestPlugin(userOptions = {}) {
+  return VitePluginUniManifest({
+    cwd: join2(process2.env.VITE_ROOT_DIR || "", UNIVA_DIR_NAME),
+    ...userOptions
+  });
+}
+
+// src/plugins/pages.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
 import { VitePluginUniPages } from "@uni-helper/vite-plugin-uni-pages";
 function getPagesConfigPath(root) {
-  return join2(getUnivaDir(root), "pages-config.ts");
+  return join3(getUnivaDir(root), "pages-config.ts");
 }
 function generatePagesConfigContent(content) {
   const { pages, subPackages, ...rest } = content;
@@ -67,13 +182,13 @@ export default ${JSON.stringify(rest, null, 2)}
 function generatePagesConfigFile(content, root) {
   const pagesConfigPath = getPagesConfigPath(root);
   const newContent = generatePagesConfigContent(content);
-  if (existsSync2(pagesConfigPath)) {
-    const existingContent = readFileSync(pagesConfigPath, "utf-8");
+  if (existsSync3(pagesConfigPath)) {
+    const existingContent = readFileSync2(pagesConfigPath, "utf-8");
     if (existingContent === newContent) {
       return;
     }
   }
-  writeFileSync(pagesConfigPath, newContent, "utf-8");
+  writeFileSync2(pagesConfigPath, newContent, "utf-8");
 }
 function createPagesPlugin(pluginOptions) {
   const result = VitePluginUniPages({
@@ -86,23 +201,11 @@ function createPagesPlugin(pluginOptions) {
 }
 
 // src/plugins/context.ts
-var DEFAULT_ROOT_FILE_NAME = "App.ku.vue";
 var APP_KU_VUE_TEMPLATE = `<!-- Auto-generated by @univa/core -->
-<!-- UniKuRoot \u865A\u62DF\u6839\u7EC4\u4EF6\uFF0C\u53EF\u5728\u6B64\u6DFB\u52A0\u5168\u5C40\u7EC4\u4EF6\uFF08\u5982 Toast\u3001ConfigProvider \u7B49\uFF09 -->
 <template>
   <KuRootView />
 </template>
 `;
-function ensureRootComponent(config, root) {
-  const srcDir = config?.srcDir || "src";
-  const rootFileName = config?.overrides?.root?.rootFileName || DEFAULT_ROOT_FILE_NAME;
-  const rootComponentPath = join3(root, srcDir, rootFileName);
-  if (existsSync3(rootComponentPath)) {
-    return;
-  }
-  writeFileSync2(rootComponentPath, APP_KU_VUE_TEMPLATE, "utf-8");
-  console.log(`[univa] \u5DF2\u751F\u6210\u865A\u62DF\u6839\u7EC4\u4EF6\uFF1A${slash(rootComponentPath)}`);
-}
 var UnivaContext = class {
   _server;
   config;
@@ -111,12 +214,32 @@ var UnivaContext = class {
   constructor(options) {
     this.root = options.root;
   }
+  /**
+   * 确保虚拟根组件文件存在
+   *
+   * UniKuRoot 插件依赖 src 下的虚拟根组件文件（默认 App.ku.vue）。
+   * 若不存在则生成最小模板，避免插件注入 import 时解析失败。
+   *
+   * 必须在 Vite 启动前调用（Univa() 初始化阶段），
+   * 否则在 configResolved 阶段创建 src 下新文件会触发 watcher add 事件，
+   * 导致 Vite 重编译与 VitePluginUniPages 的 pages.json 写入冲突（EPERM）。
+   */
+  ensureRootComponent(fileName) {
+    const srcDir = this.config?.srcDir || "src";
+    const rootFileName = this.config?.overrides?.root?.rootFileName || fileName;
+    const rootComponentPath = join4(this.root, srcDir, rootFileName);
+    if (existsSync4(rootComponentPath)) {
+      return;
+    }
+    writeFileSync3(rootComponentPath, APP_KU_VUE_TEMPLATE, "utf-8");
+    log(`\u5DF2\u751F\u6210\u865A\u62DF\u6839\u7EC4\u4EF6\uFF1A${slash(rootComponentPath)}`);
+  }
   /**
    * 同步加载用户配置（univa.config.ts）
    */
   loadUserConfigSync() {
     const jiti = createJiti(this.root);
-    const configFile = join3(this.root, `${ID}.config`);
+    const configFile = join4(this.root, `${ID}.config`);
     try {
       const configModule = jiti(configFile);
       const userConfig = configModule?.default || configModule;
@@ -175,26 +298,33 @@ var UnivaContext = class {
    * 更新生成的文件
    *
    * 读取 univa.config.ts 的 pages 字段（应用级配置），
-   * 生成 .univa/pages.ts 供 VitePluginUniPages 消费。
-   * 同时确保 UniKuRoot 虚拟根组件文件存在。
+   * 生成 .univa/pages-config.ts 供 VitePluginUniPages 消费。
+   *
+   * 注意：不在此处生成 src/App.ku.vue，避免在 configResolved 阶段
+   * 创建 src 下新文件触发 watcher add 事件，导致 Vite 重编译
+   * 与 VitePluginUniPages 的 pages.json 写入冲突（EPERM）。
+   * App.ku.vue 的生成在 Univa() 初始化阶段完成。
    */
   updateGeneratedFiles() {
     const pagesConfig = this.config?.pages;
     if (pagesConfig) {
       generatePagesConfigFile(pagesConfig, this.root);
     }
+    const manifestConfig = this.config?.manifest;
+    if (manifestConfig) {
+      generateManifestConfigFile(manifestConfig, this.root);
+    }
     const pagesTsPath = getPagesConfigPath(this.root);
     const emptyContent = `// Auto-generated by @univa/core
 export default {}
 `;
-    if (!existsSync3(pagesTsPath)) {
-      writeFileSync2(pagesTsPath, emptyContent, "utf-8");
+    if (!existsSync4(pagesTsPath)) {
+      writeFileSync3(pagesTsPath, emptyContent, "utf-8");
     } else if (!pagesConfig) {
-      if (readFileSync2(pagesTsPath, "utf-8") !== emptyContent) {
-        writeFileSync2(pagesTsPath, emptyContent, "utf-8");
+      if (readFileSync3(pagesTsPath, "utf-8") !== emptyContent) {
+        writeFileSync3(pagesTsPath, emptyContent, "utf-8");
       }
     }
-    ensureRootComponent(this.config, this.root);
   }
   /**
    * 更新回调
@@ -220,7 +350,7 @@ var DEFAULT_IMPORTS = {
   apis: ["vue", "uni-app", "composables/**", "stores/**", "hooks/**", "constants/**"],
   components: ["components/**", "components-biz/**"]
 };
-function resolveOptions(userOptions) {
+function resolveOptions2(userOptions) {
   const srcDir = userOptions.srcDir || "src";
   const dirs = {
     pages: userOptions.dirs?.pages ?? DEFAULT_DIRS.pages,
@@ -293,7 +423,9 @@ function createUnivaPlugins(resolved) {
     ...resolved.overrides?.layouts
   }));
   plugins.push(UniKuRoot({
+    enabledVirtualHost: true,
     enabledGlobalRef: true,
+    rootFileName: ROOT_NAME,
     excludePages: [
       "components-async/**/*.*"
     ],
@@ -306,6 +438,9 @@ function createUnivaPlugins(resolved) {
     directoryAsNamespace: true,
     ...resolved.overrides?.components
   }));
+  plugins.push(createManifestPlugin({
+    ...resolved.overrides?.manifest
+  }));
   plugins.push(...Uni());
   plugins.push(...UnoCSS());
   const { presets, dirs } = resolveApiSources(resolved.imports.apis, srcDir);
@@ -328,8 +463,10 @@ function Univa() {
   });
   ensureUnivaDir(context.root);
   context.loadUserConfigSync();
-  const resolved = resolveOptions(context.config || {});
-  console.log("[univa] \u5DF2\u52A0\u8F7D\u914D\u7F6E\uFF1A", context.configPath || "\u9ED8\u8BA4\u914D\u7F6E");
+  setDebug(context.config?.debug ?? false);
+  context.ensureRootComponent(`${ROOT_NAME}.vue`);
+  const resolved = resolveOptions2(context.config || {});
+  log("\u5DF2\u52A0\u8F7D\u914D\u7F6E\uFF1A", context.configPath || "\u9ED8\u8BA4\u914D\u7F6E");
   return createUnivaPlugins(resolved);
 }
 var plugins_default = Univa;

package/dist/use.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/use.ts
+var use_exports = {};
+__export(use_exports, {
+  usePageContext: () => usePageContext
+});
+module.exports = __toCommonJS(use_exports);
+
+// src/hooks/usePageContext.ts
+var import_vue = require("vue");
+function usePageContext() {
+  const rootRef = (0, import_vue.shallowRef)(null);
+  (0, import_vue.onMounted)(() => {
+    const pagesStack = getCurrentPages();
+    const pageStack = pagesStack[pagesStack.length - 1];
+    if (!pageStack?.$vm?.$refs?.uniKuRoot) {
+      throw new Error("[usePageContext] Root not found.");
+    }
+    rootRef.value = pageStack.$vm.$refs.uniKuRoot;
+  });
+  return {
+    rootRef
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  usePageContext
+});

package/dist/use.d.cts

@@ -0,0 +1,9 @@
+import { ShallowRef } from 'vue';
+
+interface PageContext {
+    rootRef: ShallowRef;
+}
+
+declare function usePageContext(): PageContext;
+
+export { usePageContext };

package/dist/use.d.ts

@@ -0,0 +1,9 @@
+import { ShallowRef } from 'vue';
+
+interface PageContext {
+    rootRef: ShallowRef;
+}
+
+declare function usePageContext(): PageContext;
+
+export { usePageContext };

package/dist/use.js

@@ -0,0 +1,19 @@
+// src/hooks/usePageContext.ts
+import { onMounted, shallowRef } from "vue";
+function usePageContext() {
+  const rootRef = shallowRef(null);
+  onMounted(() => {
+    const pagesStack = getCurrentPages();
+    const pageStack = pagesStack[pagesStack.length - 1];
+    if (!pageStack?.$vm?.$refs?.uniKuRoot) {
+      throw new Error("[usePageContext] Root not found.");
+    }
+    rootRef.value = pageStack.$vm.$refs.uniKuRoot;
+  });
+  return {
+    rootRef
+  };
+}
+export {
+  usePageContext
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@univa/core",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "🚀 开箱即用的 uni-app Vite 插件集，提供完整的开发体验",
   "author": "lianghang <libre1103@163.com>",
   "license": "MIT",
@@ -29,8 +29,18 @@
         "default": "./dist/index.cjs"
       }
     },
-    "./client": {
-      "types": "./src/client.d.ts"
+    "./use": {
+      "import": {
+        "types": "./dist/use.d.ts",
+        "default": "./dist/use.js"
+      },
+      "require": {
+        "types": "./dist/use.d.cts",
+        "default": "./dist/use.cjs"
+      }
+    },
+    "./global": {
+      "types": "./dist/global.d.ts"
     }
   },
   "main": "./dist/index.cjs",
@@ -39,9 +49,7 @@
   "files": [
     "LICENSE",
     "README.md",
-    "dist",
-    "src/client.d.ts",
-    "src/global.d.ts"
+    "dist"
   ],
   "engines": {
     "node": ">=20.0.0"
@@ -51,19 +59,24 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "node scripts/build.mjs",
     "dev": "tsup --watch"
   },
+  "peerDependencies": {
+    "vite": "^5.2.8"
+  },
   "dependencies": {
     "@antfu/utils": "catalog:",
-    "@uni-helper/eslint-config": "0.7.3",
+    "@dcloudio/types": "3.4.28",
+    "@uni-helper/eslint-config": "0.7.4",
     "@uni-helper/plugin-uni": "0.1.0",
-    "@uni-helper/uni-pages-types": "^0.4.4",
-    "@uni-helper/uni-types": "1.0.0-alpha.8",
+    "@uni-helper/uni-pages-types": "0.4.6",
+    "@uni-helper/uni-types": "1.1.0",
     "@uni-helper/unocss-preset-uni": "0.2.11",
-    "@uni-helper/vite-plugin-uni-components": "0.2.10",
+    "@uni-helper/vite-plugin-uni-components": "0.3.2",
     "@uni-helper/vite-plugin-uni-layouts": "0.1.11",
-    "@uni-helper/vite-plugin-uni-pages": "0.4.4",
+    "@uni-helper/vite-plugin-uni-manifest": "0.4.1",
+    "@uni-helper/vite-plugin-uni-pages": "0.4.6",
     "@uni-ku/root": "1.4.1",
     "@unocss/eslint-plugin": "66.6.7",
     "@unocss/preset-legacy-compat": "66.0.0",
@@ -78,6 +91,7 @@
   },
   "devDependencies": {
     "@dcloudio/uni-app": "catalog:",
+    "@types/node": "catalog:",
     "tsup": "catalog:",
     "typescript": "catalog:",
     "vite": "catalog:",