@univa/core 0.0.7 → 0.0.9

package/THIRD-PARTY-NOTICES

@@ -0,0 +1,216 @@
+# Third-Party Notices
+
+This file contains acknowledgments for third-party software used in the Univa project.
+
+---
+
+## Vite
+
+- **License**: MIT
+- **Repository**: https://github.com/vitejs/vite
+- **Copyright**: Copyright (c) 2019-present, Yuxi (Evan) You and Vite contributors
+
+---
+
+## UnoCSS
+
+- **License**: MIT
+- **Repository**: https://github.com/unocss/unocss
+- **Copyright**: Copyright (c) 2021-PRESENT Anthony Fu
+
+---
+
+## uni-helper
+
+### @uni-helper/plugin-uni
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/plugin-uni
+
+### @uni-helper/vite-plugin-uni-pages
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/vite-plugin-uni-pages
+
+### @uni-helper/vite-plugin-uni-components
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/vite-plugin-uni-components
+
+### @uni-helper/vite-plugin-uni-layouts
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/vite-plugin-uni-layouts
+
+### @uni-helper/vite-plugin-uni-manifest
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/vite-plugin-uni-manifest
+
+### @uni-helper/unocss-preset-uni
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/unocss-preset-uni
+
+### @uni-helper/uni-types
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/uni-types
+
+### @uni-helper/uni-pages-types
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/uni-pages-types
+
+### @uni-helper/eslint-config
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/eslint-config
+
+---
+
+## unplugin-auto-import
+
+- **License**: MIT
+- **Repository**: https://github.com/unjs/unplugin-auto-import
+- **Copyright**: Copyright (c) 2021-PRESENT Anthony Fu
+
+---
+
+## @antfu/utils
+
+- **License**: MIT
+- **Repository**: https://github.com/antfu/utils
+- **Copyright**: Copyright (c) 2021-PRESENT Anthony Fu
+
+---
+
+## @antfu/eslint-config
+
+- **License**: MIT
+- **Repository**: https://github.com/antfu/eslint-config
+- **Copyright**: Copyright (c) 2019-PRESENT Anthony Fu
+
+---
+
+## Sass
+
+- **License**: MIT
+- **Repository**: https://github.com/sass/dart-sass
+- **Copyright**: Copyright (c) 2016 Google Inc.
+
+---
+
+## c12
+
+- **License**: MIT
+- **Repository**: https://github.com/unjs/c12
+- **Copyright**: Copyright (c) Pooya Parsa
+
+---
+
+## defu
+
+- **License**: MIT
+- **Repository**: https://github.com/unjs/defu
+- **Copyright**: Copyright (c) Pooya Parsa
+
+---
+
+## jiti
+
+- **License**: MIT
+- **Repository**: https://github.com/unjs/jiti
+- **Copyright**: Copyright (c) Pooya Parsa
+
+---
+
+## @dcloudio/types
+
+- **License**: Apache-2.0
+- **Repository**: https://github.com/dcloudio/uni-app
+
+---
+
+## @uni-ku/root
+
+- **License**: MIT
+- **Repository**: https://github.com/uni-ku/root
+
+---
+
+## vite-plugin-uni-polyfill
+
+- **License**: MIT
+- **Repository**: https://github.com/uni-helper/vite-plugin-uni-polyfill
+
+---
+
+## husky
+
+- **License**: MIT
+- **Repository**: https://github.com/typicode/husky
+- **Copyright**: Copyright (c) 2016-2023 Typicode
+
+---
+
+## lint-staged
+
+- **License**: MIT
+- **Repository**: https://github.com/lint-staged/lint-staged
+- **Copyright**: Copyright (c) 2011-2023 Andrey Okonetchnikov
+
+---
+
+## commitlint
+
+- **License**: MIT
+- **Repository**: https://github.com/conventional-changelog/commitlint
+- **Copyright**: Copyright (c) 2016-2023 by Mario Nebl and contributors
+
+---
+
+## standard-version
+
+- **License**: ISC
+- **Repository**: https://github.com/conventional-changelog/standard-version
+- **Copyright**: Copyright (c) 2017-2019, Mario Nebl and contributors
+
+---
+
+## ESLint
+
+- **License**: MIT
+- **Repository**: https://github.com/eslint/eslint
+- **Copyright**: Copyright OpenJS Foundation and other contributors
+
+---
+
+## inquirer
+
+- **License**: MIT
+- **Repository**: https://github.com/SBoudrias/Inquirer.js
+- **Copyright**: Copyright (c) 2016 Simon Boudrias
+
+---
+
+## TypeScript
+
+- **License**: Apache-2.0
+- **Repository**: https://github.com/microsoft/TypeScript
+- **Copyright**: Copyright (c) Microsoft Corporation
+
+---
+
+## tsup
+
+- **License**: MIT
+- **Repository**: https://github.com/egoist/tsup
+- **Copyright**: Copyright (c) 2018 EGOIST
+
+---
+
+## Vue
+
+- **License**: MIT
+- **Repository**: https://github.com/vuejs/core
+- **Copyright**: Copyright (c) 2018-present, Yuxi (Evan) You
+
+---
+
+## Acknowledgments
+
+This project stands on the shoulders of giants. We are grateful to all the open-source contributors who have made these amazing tools available to the community.
+
+If you believe any attribution is missing or incorrect, please submit an issue or pull request.

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;
 }