@nasti-toolchain/nasti 2.5.0 → 2.5.2

package/dist/index.d.cts

@@ -1,84 +1,85 @@
-import { RenderedChunk, InputOptions, OutputOptions } from 'rolldown';
-import { IncomingMessage, ServerResponse } from 'node:http';
-import { SFCParseOptions, SFCScriptCompileOptions, SFCTemplateCompileOptions, SFCAsyncStyleCompileOptions } from '@vue/compiler-sfc';
-
+import { InputOptions, MinifyOptions, OutputOptions, RenderedChunk } from "rolldown";
+import { IncomingMessage, ServerResponse } from "node:http";
+import { SFCAsyncStyleCompileOptions, SFCParseOptions, SFCScriptCompileOptions, SFCTemplateCompileOptions } from "@vue/compiler-sfc";
+//#region src/core/logger.d.ts
 type LogType = 'error' | 'warn' | 'info';
 type LogLevel = LogType | 'silent';
 interface LogOptions {
-    /** 是否清屏（仅 allowClearScreen 且 TTY 下生效） */
-    clear?: boolean;
-    /** 是否带 HH:mm:ss 时间戳前缀 */
-    timestamp?: boolean;
-    /** 关联的 Error（用于 hasErrorLogged 去重） */
-    error?: Error | null;
+  /** 是否清屏（仅 allowClearScreen 且 TTY 下生效） */
+  clear?: boolean;
+  /** 是否带 HH:mm:ss 时间戳前缀 */
+  timestamp?: boolean;
+  /** 关联的 Error（用于 hasErrorLogged 去重） */
+  error?: Error | null;
 }
 interface Logger {
-    info(msg: string, options?: LogOptions): void;
-    warn(msg: string, options?: LogOptions): void;
-    /** 同一条 warn 整个进程只输出一次 */
-    warnOnce(msg: string, options?: LogOptions): void;
-    error(msg: string, options?: LogOptions): void;
-    clearScreen(type: LogType): void;
-    /** 该 Error 是否已经走 logger.error 输出过（避免 CLI 兜底重复打印） */
-    hasErrorLogged(error: Error): boolean;
-    hasWarned: boolean;
+  info(msg: string, options?: LogOptions): void;
+  warn(msg: string, options?: LogOptions): void;
+  /** 同一条 warn 整个进程只输出一次 */
+  warnOnce(msg: string, options?: LogOptions): void;
+  error(msg: string, options?: LogOptions): void;
+  clearScreen(type: LogType): void;
+  /** 该 Error 是否已经走 logger.error 输出过（避免 CLI 兜底重复打印） */
+  hasErrorLogged(error: Error): boolean;
+  hasWarned: boolean;
 }
 interface LoggerOptions {
-    prefix?: string;
-    allowClearScreen?: boolean;
-    customLogger?: Logger;
-    console?: Console;
+  prefix?: string;
+  allowClearScreen?: boolean;
+  customLogger?: Logger;
+  console?: Console;
 }
 declare const LogLevels: Record<LogLevel, number>;
 declare function createLogger(level?: LogLevel, options?: LoggerOptions): Logger;
 interface ServerUrls {
-    local: string[];
-    network: string[];
+  local: string[];
+  network: string[];
 }
 /** 打印 dev server 地址：➜ Local / Network，端口加粗 */
 declare function printServerUrls(urls: ServerUrls, info: Logger['info']): void;
-
+//#endregion
+//#region src/types.d.ts
 interface NastiConfig {
-    /** 项目根目录 */
-    root?: string;
-    /** 公共基础路径 */
-    base?: string;
-    /** 运行模式 */
-    mode?: 'development' | 'production';
-    /** 打包目标平台：web（默认）或 electron */
-    target?: 'web' | 'electron';
-    /** 框架自动检测或手动指定 */
-    framework?: 'react' | 'vue' | 'auto';
-    /** React JSX / Fast Refresh / Compiler 管线。仅在 framework 解析为 react 时生效。 */
-    react?: ReactOptions;
-    /** 路径解析配置 */
-    resolve?: ResolveConfig;
-    /** 插件列表 */
-    plugins?: NastiPlugin[];
-    /** 开发服务器配置 */
-    server?: ServerConfig;
-    /** 构建配置 */
-    build?: BuildConfig;
-    /** Electron 配置（当 target === 'electron' 时生效） */
-    electron?: ElectronConfig;
-    /** 环境变量前缀 */
-    envPrefix?: string | string[];
-    /** 日志级别 */
-    logLevel?: 'info' | 'warn' | 'error' | 'silent';
-    /** 启动/重启时是否允许清屏（CI/非 TTY 下自动禁用），默认 true */
-    clearScreen?: boolean;
-    /** 自定义 Logger（替换内置实现，logLevel 等选项由自定义实现自行处理） */
-    customLogger?: Logger;
-    /**
-     * 环境配置 map（Environment API，2.0）。默认注入 `{ client, ssr }`。
-     *
-     * `client` 环境与 top-level `resolve`/`build` **精确镜像**：对
-     * `environments.client` 的覆盖会写回 top-level（反之亦然），保证读 flat
-     * config 的既有插件与新 API 看到同一份配置。
-     */
-    environments?: Record<string, EnvironmentOptions>;
-    /** 实验特性（无稳定性保证，随时可能变更/移除） */
-    experimental?: ExperimentalOptions;
+  /** 项目根目录 */
+  root?: string;
+  /** 公共基础路径 */
+  base?: string;
+  /** 运行模式 */
+  mode?: 'development' | 'production';
+  /** 打包目标平台：web（默认）或 electron */
+  target?: 'web' | 'electron';
+  /** 框架自动检测或手动指定 */
+  framework?: 'react' | 'vue' | 'auto';
+  /** React JSX / Fast Refresh / Compiler 管线。仅在 framework 解析为 react 时生效。 */
+  react?: ReactOptions;
+  /** 路径解析配置 */
+  resolve?: ResolveConfig;
+  /** 插件列表 */
+  plugins?: NastiPlugin[];
+  /** 开发服务器配置 */
+  server?: ServerConfig;
+  /** 构建配置 */
+  build?: BuildConfig;
+  /** Electron 配置（当 target === 'electron' 时生效） */
+  electron?: ElectronConfig;
+  /** 环境变量前缀 */
+  envPrefix?: string | string[];
+  /** 日志级别 */
+  logLevel?: 'info' | 'warn' | 'error' | 'silent';
+  /** 启动/重启时是否允许清屏（CI/非 TTY 下自动禁用），默认 true */
+  clearScreen?: boolean;
+  /** 自定义 Logger（替换内置实现，logLevel 等选项由自定义实现自行处理） */
+  customLogger?: Logger;
+  /**
+   * 环境配置 map（Environment API，2.0）。默认注入 `{ client, ssr }`。
+   *
+   * `client` 环境与 top-level `resolve`/`build` **精确镜像**：对
+   * `environments.client` 的覆盖会写回 top-level（反之亦然），保证读 flat
+   * config 的既有插件与新 API 看到同一份配置。
+   */
+  environments?: Record<string, EnvironmentOptions>;
+  /** 实验特性（无稳定性保证，随时可能变更/移除） */
+  experimental?: ExperimentalOptions;
 }
 type ReactFileFilter = string | RegExp | Array<string | RegExp>;
 /**
@@ -86,502 +87,541 @@ type ReactFileFilter = string | RegExp | Array<string | RegExp>;
  * `oxc-transform-react`，无需让 Nasti 与编译器的快速迭代强耦合。
  */
 interface ReactCompilerOptions {
-    compilationMode?: 'infer' | 'syntax' | 'annotation' | 'all';
-    panicThreshold?: 'none' | 'critical_errors' | 'all_errors';
-    target?: '17' | '18' | '19' | {
-        kind: 'donotuse_meta_internal';
-        runtimeModule?: string;
-    };
-    gating?: {
-        source: string;
-        importSpecifierName: string;
-    };
-    dynamicGating?: {
-        source: string;
-    };
-    noEmit?: boolean;
-    outputMode?: 'client' | 'ssr' | 'lint';
-    sources?: string[];
-    [option: string]: unknown;
+  compilationMode?: 'infer' | 'syntax' | 'annotation' | 'all';
+  panicThreshold?: 'none' | 'critical_errors' | 'all_errors';
+  target?: '17' | '18' | '19' | {
+    kind: 'donotuse_meta_internal';
+    runtimeModule?: string;
+  };
+  gating?: {
+    source: string;
+    importSpecifierName: string;
+  };
+  dynamicGating?: {
+    source: string;
+  };
+  noEmit?: boolean;
+  outputMode?: 'client' | 'ssr' | 'lint';
+  sources?: string[];
+  [option: string]: unknown;
 }
 /** React 管线选项；命名与 @vitejs/plugin-react 保持一致。 */
 interface ReactOptions {
-    /** @default /\.[tj]sx?$/ */
-    include?: ReactFileFilter;
-    /** @default /node_modules/ */
-    exclude?: ReactFileFilter;
-    /** @default 'react' */
-    jsxImportSource?: string;
-    /** @default 'automatic' */
-    jsxRuntime?: 'automatic' | 'classic';
-    /** 可选的原生 React Compiler；只编译 client consumer。 */
-    compiler?: boolean | ReactCompilerOptions;
+  /** @default /\.[tj]sx?$/ */
+  include?: ReactFileFilter;
+  /** @default /node_modules/ */
+  exclude?: ReactFileFilter;
+  /** @default 'react' */
+  jsxImportSource?: string;
+  /** @default 'automatic' */
+  jsxRuntime?: 'automatic' | 'classic';
+  /** 可选的原生 React Compiler；只编译 client consumer。 */
+  compiler?: boolean | ReactCompilerOptions;
 }
 interface ResolvedReactOptions {
-    include: ReactFileFilter;
-    exclude: ReactFileFilter;
-    jsxImportSource: string;
-    jsxRuntime: 'automatic' | 'classic';
-    compiler: false | ReactCompilerOptions;
+  include: ReactFileFilter;
+  exclude: ReactFileFilter;
+  jsxImportSource: string;
+  jsxRuntime: 'automatic' | 'classic';
+  compiler: false | ReactCompilerOptions;
 }
 interface ExperimentalOptions {
-    /**
-     * dev 用 Rolldown `dev()` 引擎整体打包 client 环境后从内存服务
-     * （完整打包模式 / Full Bundle Mode）。HMR 由引擎的 patch 机制驱动，
-     * 动态 import 走懒编译端点。依赖 rolldown 实验 API（无 semver 保护，
-     * Nasti 会精确锁定经过验证的 Rolldown 版本）。unbundled 管线保持默认。
-     * @experimental
-     * @default false
-     */
-    bundledDev?: boolean;
+  /**
+   * dev 用 Rolldown `dev()` 引擎整体打包 client 环境后从内存服务
+   * （完整打包模式 / Full Bundle Mode）。HMR 由引擎的 patch 机制驱动，
+   * 动态 import 走懒编译端点。依赖 rolldown 实验 API（无 semver 保护，
+   * Nasti 会精确锁定经过验证的 Rolldown 版本）。unbundled 管线保持默认。
+   * @experimental
+   * @default false
+   */
+  bundledDev?: boolean;
 }
 /** 单个环境的可配置面（Environment API） */
 interface EnvironmentOptions {
-    /**
-     * 产物消费者：决定 per-env 的 resolve 行为与 `import.meta.env.SSR` 取值。
-     * 默认：环境名为 'client' → 'client'，其余 → 'server'。
-     */
-    consumer?: 'client' | 'server';
-    /**
-     * 该环境的构建入口（相对 root）。client 默认从 HTML 提取；显式配置后可覆盖。
-     * 非 client 环境只有声明 entry 或 driver 才会被 `nasti build` 构建。
-     */
-    entry?: string | string[];
-    /**
-     * HTML 入口（相对 root），仅 client consumer 使用。默认 `index.html`。
-     * Electron renderer 会把 `electron.renderer` 映射到这里。
-     */
-    html?: string;
-    /**
-     * 是否参与生产构建。默认 true；设为 false 可跳过默认 client，构建纯多环境应用。
-     * 仅影响 `nasti build`，不影响 dev server 中环境实例的可见性。
-     */
-    buildEnabled?: boolean;
-    /**
-     * 外部环境编译驱动标识。声明后由插件的 `createEnvironmentDriver` 提供实际实现，
-     * 可用于接入 Rspeedy 等不基于 Rolldown 的构建系统。
-     */
-    driver?: string;
-    /** per-env 路径解析（client 默认含 'browser' condition；server 走 node conditions） */
-    resolve?: ResolveConfig;
-    /** per-env 构建覆盖（未设置的字段回退 top-level build） */
-    build?: BuildConfig;
-    /**
-     * Vue SFC 编译扩展点。每个环境可独立设置 compiler-sfc 选项与源码变换，
-     * 同一个 SFC 的虚拟模块 id / scope id 不包含环境名，因而在多图之间保持稳定。
-     */
-    vue?: VueEnvironmentOptions;
+  /**
+   * 产物消费者：决定 per-env 的 resolve 行为与 `import.meta.env.SSR` 取值。
+   * 默认：环境名为 'client' → 'client'，其余 → 'server'。
+   */
+  consumer?: 'client' | 'server';
+  /**
+   * 该环境的构建入口（相对 root）。client 默认从 HTML 提取；显式配置后可覆盖。
+   * 非 client 环境只有声明 entry 或 driver 才会被 `nasti build` 构建。
+   */
+  entry?: string | string[];
+  /**
+   * HTML 入口（相对 root），仅 client consumer 使用。默认 `index.html`。
+   * Electron renderer 会把 `electron.renderer` 映射到这里。
+   */
+  html?: string;
+  /**
+   * 是否参与生产构建。默认 true；设为 false 可跳过默认 client，构建纯多环境应用。
+   * 仅影响 `nasti build`，不影响 dev server 中环境实例的可见性。
+   */
+  buildEnabled?: boolean;
+  /**
+   * 外部环境编译驱动标识。声明后由插件的 `createEnvironmentDriver` 提供实际实现，
+   * 可用于接入 Rspeedy 等不基于 Rolldown 的构建系统。
+   */
+  driver?: string;
+  /** per-env 路径解析（client 默认含 'browser' condition；server 走 node conditions） */
+  resolve?: ResolveConfig;
+  /** per-env 构建覆盖（未设置的字段回退 top-level build） */
+  build?: BuildConfig;
+  /**
+   * Vue SFC 编译扩展点。每个环境可独立设置 compiler-sfc 选项与源码变换，
+   * 同一个 SFC 的虚拟模块 id / scope id 不包含环境名，因而在多图之间保持稳定。
+   */
+  vue?: VueEnvironmentOptions;
 }
 interface VueSfcTransformContext {
-    filename: string;
-    environmentName: string;
-    type: 'sfc' | 'template' | 'style';
-    index?: number;
+  filename: string;
+  environmentName: string;
+  type: 'sfc' | 'template' | 'style';
+  index?: number;
 }
-type VueSfcSourceTransform = (source: string, context: VueSfcTransformContext) => string
+type VueSfcSourceTransform = (source: string, context: VueSfcTransformContext) => string |
 /**
  * Object results may provide a source map from `code` back to `source`.
  * Nasti composes it with compiler-sfc maps where that stage supports chaining.
  */
- | {
-    code: string;
-    map?: unknown;
+{
+  code: string;
+  map?: unknown;
 } | Promise<string | {
-    code: string;
-    map?: unknown;
+  code: string;
+  map?: unknown;
 }>;
 /** 直接透传给 `@vue/compiler-sfc` 对应阶段的 per-environment 选项。 */
 interface VueEnvironmentOptions {
-    parse?: SFCParseOptions;
-    script?: Partial<SFCScriptCompileOptions>;
-    template?: Partial<SFCTemplateCompileOptions>;
-    style?: Partial<SFCAsyncStyleCompileOptions>;
-    /**
-     * Vue 编译特性开关。
-     *
-     * `vapor`：将可强制进入 Vapor Mode 的 SFC（`<script setup>` / 纯 template）
-     * 统一按 Vapor 编译。单文件仍可通过 `<script setup vapor>` / `<template vapor>`
-     * 按需 opt-in。需要 `@vue/compiler-sfc` ≥ 3.6。
-     * @experimental
-     */
-    features?: {
-        vapor?: boolean;
-    };
-    transformSfc?: VueSfcSourceTransform;
-    transformTemplate?: VueSfcSourceTransform;
-    transformStyle?: VueSfcSourceTransform;
+  parse?: SFCParseOptions;
+  script?: Partial<SFCScriptCompileOptions>;
+  template?: Partial<SFCTemplateCompileOptions>;
+  style?: Partial<SFCAsyncStyleCompileOptions>;
+  /**
+   * Vue 编译特性开关。
+   *
+   * `vapor`：将可强制进入 Vapor Mode 的 SFC（`<script setup>` / 纯 template）
+   * 统一按 Vapor 编译。单文件仍可通过 `<script setup vapor>` / `<template vapor>`
+   * 按需 opt-in。需要 `@vue/compiler-sfc` ≥ 3.6。
+   * @experimental
+   */
+  features?: {
+    vapor?: boolean;
+  };
+  transformSfc?: VueSfcSourceTransform;
+  transformTemplate?: VueSfcSourceTransform;
+  transformStyle?: VueSfcSourceTransform;
 }
 /** 解析后的环境配置 */
 interface ResolvedEnvironmentOptions {
-    consumer: 'client' | 'server';
-    /** 是否参与生产构建 */
-    buildEnabled: boolean;
-    /** 环境构建入口（绝对路径）；client 未显式配置时为空并从 HTML 提取 */
-    entry: string[];
-    /** HTML 入口绝对路径（仅 client consumer 有值） */
-    html?: string;
-    /** 外部环境编译驱动标识 */
-    driver?: string;
-    resolve: Required<ResolveConfig>;
-    build: Required<BuildConfig>;
-    vue: VueEnvironmentOptions;
+  consumer: 'client' | 'server';
+  /** 是否参与生产构建 */
+  buildEnabled: boolean;
+  /** 环境构建入口（绝对路径）；client 未显式配置时为空并从 HTML 提取 */
+  entry: string[];
+  /** HTML 入口绝对路径（仅 client consumer 有值） */
+  html?: string;
+  /** 外部环境编译驱动标识 */
+  driver?: string;
+  resolve: Required<ResolveConfig>;
+  build: Required<BuildConfig>;
+  vue: VueEnvironmentOptions;
 }
 /** Electron 目标专用配置，支持 Electron 41+ */
 interface ElectronConfig {
-    /** 主进程入口文件，相对项目根目录 */
-    main?: string;
-    /** Preload 脚本入口，相对项目根目录。可传入多个 */
-    preload?: string | string[];
-    /** 渲染进程（Web）入口 HTML，默认沿用根目录 index.html */
-    renderer?: string;
-    /**
-     * 主进程与 preload 打包目标 Node 版本。
-     * Electron 41 捆绑 Node 22.x，默认为 'node22'
-     */
-    nodeTarget?: string;
-    /**
-     * 主进程输出格式：cjs（默认，兼容 Electron 加载器）或 esm
-     * （Electron 41+ 完整支持 ESM 主进程）
-     */
-    mainFormat?: 'cjs' | 'esm';
-    /** Preload 输出格式，默认 cjs（Electron contextIsolation 推荐） */
-    preloadFormat?: 'cjs' | 'esm';
-    /** Electron 可执行文件路径，默认从 node_modules/electron 查找 */
-    electronPath?: string;
-    /** 传递给 Electron 的命令行参数（dev 模式） */
-    electronArgs?: string[];
-    /** 开发时主/preload 文件变化后自动重启 Electron，默认 true */
-    autoRestart?: boolean;
-    /** 声明最低 Electron 版本，默认 41（低于此版本将警告） */
-    minVersion?: number;
-    /** 主进程/preload 的外部依赖（不参与打包，运行时 require） */
-    external?: string[];
+  /** 主进程入口文件，相对项目根目录 */
+  main?: string;
+  /** Preload 脚本入口，相对项目根目录。可传入多个 */
+  preload?: string | string[];
+  /** 渲染进程（Web）入口 HTML，默认沿用根目录 index.html */
+  renderer?: string;
+  /**
+   * 主进程与 preload 打包目标 Node 版本。
+   * Electron 41 捆绑 Node 22.x，默认为 'node22'
+   */
+  nodeTarget?: string;
+  /**
+   * 主进程输出格式：cjs（默认，兼容 Electron 加载器）或 esm
+   * （Electron 41+ 完整支持 ESM 主进程）
+   */
+  mainFormat?: 'cjs' | 'esm';
+  /** Preload 输出格式，默认 cjs（Electron contextIsolation 推荐） */
+  preloadFormat?: 'cjs' | 'esm';
+  /** Electron 可执行文件路径，默认从 node_modules/electron 查找 */
+  electronPath?: string;
+  /** 传递给 Electron 的命令行参数（dev 模式） */
+  electronArgs?: string[];
+  /** 开发时主/preload 文件变化后自动重启 Electron，默认 true */
+  autoRestart?: boolean;
+  /** 声明最低 Electron 版本，默认 41（低于此版本将警告） */
+  minVersion?: number;
+  /** 主进程/preload 的外部依赖（不参与打包，运行时 require） */
+  external?: string[];
 }
 interface ResolveConfig {
-    alias?: Record<string, string>;
-    extensions?: string[];
-    conditions?: string[];
-    mainFields?: string[];
+  alias?: Record<string, string>;
+  extensions?: string[];
+  conditions?: string[];
+  mainFields?: string[];
 }
 interface ServerConfig {
-    port?: number;
-    host?: string | boolean;
-    https?: boolean;
-    open?: boolean | string;
-    proxy?: Record<string, string | ProxyConfig>;
-    cors?: boolean;
-    hmr?: boolean | HmrConfig;
+  port?: number;
+  host?: string | boolean;
+  https?: boolean;
+  open?: boolean | string;
+  proxy?: Record<string, string | ProxyConfig>;
+  cors?: boolean;
+  hmr?: boolean | HmrConfig;
 }
 interface HmrConfig {
-    port?: number;
-    host?: string;
-    protocol?: 'ws' | 'wss';
-    overlay?: boolean;
+  port?: number;
+  host?: string;
+  protocol?: 'ws' | 'wss';
+  overlay?: boolean;
 }
 interface ProxyConfig {
-    target: string;
-    changeOrigin?: boolean;
-    rewrite?: (path: string) => string;
+  target: string;
+  changeOrigin?: boolean;
+  rewrite?: (path: string) => string;
 }
 interface BuildConfig {
-    outDir?: string;
-    assetsDir?: string;
-    minify?: boolean | 'oxc';
-    sourcemap?: boolean | 'inline' | 'hidden';
-    target?: string | string[];
-    /**
-     * 透传给 Rolldown 的底层选项，供生产应用手动控制代码拆分与 Tree-shaking。
-     *
-     * - input 侧（`treeshake`、`resolve`、`external`、`platform` 等）会合并进 `rolldown()`；
-     * - `output` 会合并进 `bundle.write()`，用于控制代码拆分
-     *   （`output.advancedChunks` / `output.codeSplitting`）、chunk 命名等。
-     *
-     * 注：`input` 与 `plugins` 由 Nasti 管理，故不在此暴露；`output.dir` 始终由
-     * `build.outDir` 决定（HTML 改写依赖产物路径），传入会被忽略。
-     */
-    rolldownOptions?: NastiRolldownOptions;
-    emptyOutDir?: boolean;
-    css?: CssConfig;
-    /** 体积表是否计算 gzip 压缩后大小（大产物可关闭以加速构建），默认 true */
-    reportCompressedSize?: boolean;
-    /** 触发大 chunk 警告的体积阈值（单位 kB，按压缩前 chunk 体积），默认 500 */
-    chunkSizeWarningLimit?: number;
-    /** 按 chunk 抽取 CSS 为独立 .css 文件（关闭则全部合并为单个 CSS 文件），默认 true */
-    cssCodeSplit?: boolean;
-    /** 是否压缩抽取出的 CSS（Lightning CSS，不可用时回退正则压缩），默认同 minify */
-    cssMinify?: boolean;
+  outDir?: string;
+  assetsDir?: string;
+  /**
+   * 产物压缩（Rolldown 内置 OXC Minifier）。
+   *
+   * - `true` / `false`：整体开关，默认 `true`；
+   * - `'oxc'`：历史写法，等同 `true`（Rolldown 只有 OXC 一个 minifier）；
+   * - `'dce-only'`：只做死代码消除，不重命名、不压缩语法；
+   * - {@link NastiMinifyOptions}：细粒度控制 `compress` / `mangle` / `codegen`。
+   *
+   * @example 保留类名（依赖 `Class.prototype.name` 做注册/绑定的框架需要）
+   * ```ts
+   * build: { minify: { mangle: { keepNames: { class: true, function: false } } } }
+   * ```
+   *
+   * @example 最小化类成员 / 属性名（Rolldown 1.2.6 · OXC 0.147 新增）
+   * ```ts
+   * build: { minify: { mangleProps: { include: /^_/ } } }
+   * ```
+   * `mangleProps` 与 `mangle` 平级，独立于标识符重命名之外单独处理属性名。
+   * 仅支持最终生成一个 JavaScript chunk；分包产生多个 JS chunk 时 Rolldown 会报错。
+   * 单入口可设置 `rolldownOptions.output.codeSplitting: false` 内联动态导入。
+   * 它只按名字匹配、不做类型分析，因此必须排除掉由未压缩代码、模块命名空间、
+   * 全局对象或宿主 API 持有的属性，否则会改坏访问路径。
+   */
+  minify?: MinifyOption;
+  sourcemap?: boolean | 'inline' | 'hidden';
+  target?: string | string[];
+  /**
+   * 透传给 Rolldown 的底层选项，供生产应用手动控制代码拆分与 Tree-shaking。
+   *
+   * - input 侧（`treeshake`、`resolve`、`external`、`platform` 等）会合并进 `rolldown()`；
+   * - `output` 会合并进 `bundle.write()`，用于控制代码拆分
+   *   （`output.advancedChunks` / `output.codeSplitting`）、chunk 命名等。
+   *
+   * 注：`input` 与 `plugins` 由 Nasti 管理，故不在此暴露；`output.dir` 始终由
+   * `build.outDir` 决定（HTML 改写依赖产物路径），传入会被忽略。
+   */
+  rolldownOptions?: NastiRolldownOptions;
+  emptyOutDir?: boolean;
+  css?: CssConfig;
+  /** 体积表是否计算 gzip 压缩后大小（大产物可关闭以加速构建），默认 true */
+  reportCompressedSize?: boolean;
+  /** 触发大 chunk 警告的体积阈值（单位 kB，按压缩前 chunk 体积），默认 500 */
+  chunkSizeWarningLimit?: number;
+  /** 按 chunk 抽取 CSS 为独立 .css 文件（关闭则全部合并为单个 CSS 文件），默认 true */
+  cssCodeSplit?: boolean;
+  /** 是否压缩抽取出的 CSS（Lightning CSS，不可用时回退正则压缩），默认同 minify */
+  cssMinify?: boolean;
 }
+/**
+ * Nasti 暴露的 OXC Minifier 选项，直接复用 Rolldown 的 `MinifyOptions`
+ * （`compress` / `mangle` / `codegen`）。
+ *
+ * 与类名最小化直接相关的两项：
+ * - `mangle.keepNames.class` / `.function` —— 是否保留类 / 函数的标识符名。
+ *   默认 `false`，即类名参与最小化；置 `true` 可让 `Class.prototype.name`
+ *   在压缩后仍然可用。
+ * - `mangleProps` —— 按 `include` / `exclude` 正则最小化属性名（含类成员），
+ *   与 `mangle` 平级，Rolldown 1.2.6 · OXC 0.147 起可用。
+ */
+type NastiMinifyOptions = MinifyOptions;
+/** {@link BuildConfig.minify} 的取值域。 */
+type MinifyOption = boolean | 'oxc' | 'dce-only' | NastiMinifyOptions;
+/** 归一化后交给 Rolldown `OutputOptions.minify` 的取值域（不含 `'oxc'` 别名）。 */
+type ResolvedMinifyOption = boolean | 'dce-only' | NastiMinifyOptions;
 /**
  * Nasti 暴露的 Rolldown 选项：在 Rolldown {@link InputOptions} 基础上去掉由 Nasti
  * 接管的 `input` / `plugins`，并补充一个 `output` 出口用于 `bundle.write()`。
  */
 type NastiRolldownOptions = Omit<InputOptions, 'input' | 'plugins'> & {
-    /** 传给 `bundle.write()` 的输出选项：代码拆分（`advancedChunks` / `codeSplitting`）、chunk 命名等 */
-    output?: OutputOptions;
+  /** 传给 `bundle.write()` 的输出选项：代码拆分（`advancedChunks` / `codeSplitting`）、chunk 命名等 */
+  output?: OutputOptions;
 };
 interface CssConfig {
-    /** CSP nonce to add to inline <style> tags (dev only since 2.0 — build emits real .css files) */
-    nonce?: string;
-    /**
-     * @deprecated 请改用 `css.emit` 控制是否写出 CSS 文件。控制拆分用
-     * `build.cssCodeSplit`，控制压缩用 `build.cssMinify`。
-     */
-    emitCssFile?: boolean;
-    /**
-     * 是否在浏览器运行时 / HTML 中注入 CSS。原生 client 环境可关闭注入，
-     * 同时继续保留 CSS 模块图与结构化元数据。
-     * @default true
-     */
-    inject?: boolean;
-    /**
-     * 是否写出 `.css` 文件。关闭后仍收集每个 chunk 的 CSS 所有权。
-     * @default true
-     */
-    emit?: boolean;
+  /** CSP nonce to add to inline <style> tags (dev only since 2.0 — build emits real .css files) */
+  nonce?: string;
+  /**
+   * @deprecated 请改用 `css.emit` 控制是否写出 CSS 文件。控制拆分用
+   * `build.cssCodeSplit`，控制压缩用 `build.cssMinify`。
+   */
+  emitCssFile?: boolean;
+  /**
+   * 是否在浏览器运行时 / HTML 中注入 CSS。原生 client 环境可关闭注入，
+   * 同时继续保留 CSS 模块图与结构化元数据。
+   * @default true
+   */
+  inject?: boolean;
+  /**
+   * 是否写出 `.css` 文件。关闭后仍收集每个 chunk 的 CSS 所有权。
+   * @default true
+   */
+  emit?: boolean;
 }
 interface NastiPlugin {
-    name: string;
-    enforce?: 'pre' | 'post';
-    /** 必须在当前插件 setup 前完成 setup 的插件名 */
-    pre?: string[];
-    /** 必须在当前插件 setup 后完成 setup 的插件名 */
-    post?: string[];
-    apply?: 'build' | 'serve' | ((config: ResolvedConfig, env: {
-        mode: string;
-        command: string;
-    }) => boolean);
-    /** 插件初始化与跨插件 API 注册；每次 resolveConfig 只执行一次 */
-    setup?: (api: PluginApi) => void | Promise<void>;
-    buildStart?: (this: PluginContext) => void | Promise<void>;
-    buildEnd?: (this: PluginContext, error?: Error) => void | Promise<void>;
-    /**
-     * Called once after `bundle.close()` in production builds, mirroring Rollup/Vite semantics.
-     * Plugins use this to emit final-stage artifacts that depend on the bundle being fully written
-     * (PWA manifests, service workers, sitemaps, etc.). Not invoked in dev.
-     */
-    closeBundle?: (this: PluginContext, error?: Error) => void | Promise<void>;
-    resolveId?: (this: PluginContext, source: string, importer: string | undefined, options: ResolveIdOptions) => ResolveIdResult | Promise<ResolveIdResult>;
-    load?: (this: PluginContext, id: string) => LoadResult | Promise<LoadResult>;
-    transform?: (this: PluginContext, code: string, id: string) => TransformResult | Promise<TransformResult>;
-    /**
-     * Rolldown output 阶段钩子：对每个 chunk 的最终代码做变换或按 chunk 收集产物。
-     * 仅在生产构建生效（dev unbundled 管线没有 chunk 概念）。
-     *
-     * `this` 是 Rolldown 真实的（Rollup 兼容）插件上下文，不是 PluginContext stub：
-     * `this.emitFile({type:'asset'})` 经 `output.assetFileNames` 产出带 hash 的文件，
-     * `this.getFileName(ref)` 可立即解析最终文件名。CSS per-chunk 抽取依赖这两点。
-     */
-    renderChunk?: (this: RenderChunkContext, code: string, chunk: RenderedChunk) => string | {
-        code: string;
-        map?: unknown;
-    } | null | undefined | Promise<string | {
-        code: string;
-        map?: unknown;
-    } | null | undefined>;
-    /** 向 chunk hash 折叠额外输入（如该 chunk 关联的 CSS 内容），保证缓存正确性 */
-    augmentChunkHash?: (this: RenderChunkContext, chunk: RenderedChunk) => string | void | Promise<string | void>;
-    /**
-     * Rolldown output 收尾钩子（write 前最后时机）。`this` 同 renderChunk，
-     * 可 emitFile 补充产物（如 cssCodeSplit:false 的合并 CSS、manifest 等）。
-     */
-    generateBundle?: (this: RenderChunkContext, options?: unknown, bundle?: Record<string, unknown>) => void | Promise<void>;
-    config?: (config: NastiConfig, env: {
-        mode: string;
-        command: string;
-    }) => NastiConfig | null | void | Promise<NastiConfig | null | void>;
-    configResolved?: (config: ResolvedConfig) => void | Promise<void>;
-    /**
-     * Environment API：在环境配置最终解析前调整单个环境的选项。
-     * 对每个环境名调用一次（含默认注入的 client/ssr）。
-     */
-    configEnvironment?: (name: string, options: EnvironmentOptions, env: {
-        mode: string;
-        command: string;
-    }) => EnvironmentOptions | null | void | Promise<EnvironmentOptions | null | void>;
-    /**
-     * Environment API：按环境过滤插件。返回 false 则该插件不进入此环境的
-     * 插件管线。未声明时插件应用于所有环境（与 Vite 默认一致）。
-     */
-    applyToEnvironment?: (environment: EnvironmentInstance) => boolean;
-    /**
-     * 为声明了 `environment.options.driver` 的环境提供外部编译驱动。
-     * 一个环境只能被一个插件接管；返回多个驱动会报错。
-     */
-    createEnvironmentDriver?: (environment: EnvironmentInstance, api: PluginApi) => EnvironmentDriver | null | undefined | Promise<EnvironmentDriver | null | undefined>;
-    /**
-     * 所有环境构建完成后的 app 级收尾钩子，用于跨环境聚合产物。
-     * Vue Lynx 原生后端可在这里组合 background/main-thread bundle。
-     */
-    afterBuildApp?: (results: Record<string, EnvironmentBuildResult>, api: PluginApi, context: BuildAppContext) => void | Promise<void>;
-    configureServer?: (server: DevServer) => void | (() => void) | Promise<void | (() => void)>;
-    transformIndexHtml?: (html: string) => string | HtmlTagDescriptor[] | {
-        html: string;
-        tags: HtmlTagDescriptor[];
-    } | Promise<string | HtmlTagDescriptor[] | {
-        html: string;
-        tags: HtmlTagDescriptor[];
-    }>;
-    handleHotUpdate?: (ctx: HmrContext) => void | ModuleNode[] | Promise<void | ModuleNode[]>;
-    /**
-     * 一个文件在所有 dev client 环境完成失效、插件 HMR 钩子与重新转换后调用一次。
-     * 多运行时工具链可据此只重编码受影响的 native section。
-     */
-    handleHotUpdateApp?: (ctx: AppHmrContext) => void | Promise<void>;
+  name: string;
+  enforce?: 'pre' | 'post';
+  /** 必须在当前插件 setup 前完成 setup 的插件名 */
+  pre?: string[];
+  /** 必须在当前插件 setup 后完成 setup 的插件名 */
+  post?: string[];
+  apply?: 'build' | 'serve' | ((config: ResolvedConfig, env: {
+    mode: string;
+    command: string;
+  }) => boolean);
+  /** 插件初始化与跨插件 API 注册；每次 resolveConfig 只执行一次 */
+  setup?: (api: PluginApi) => void | Promise<void>;
+  buildStart?: (this: PluginContext) => void | Promise<void>;
+  buildEnd?: (this: PluginContext, error?: Error) => void | Promise<void>;
+  /**
+   * Called once after `bundle.close()` in production builds, mirroring Rollup/Vite semantics.
+   * Plugins use this to emit final-stage artifacts that depend on the bundle being fully written
+   * (PWA manifests, service workers, sitemaps, etc.). Not invoked in dev.
+   */
+  closeBundle?: (this: PluginContext, error?: Error) => void | Promise<void>;
+  resolveId?: (this: PluginContext, source: string, importer: string | undefined, options: ResolveIdOptions) => ResolveIdResult | Promise<ResolveIdResult>;
+  load?: (this: PluginContext, id: string) => LoadResult | Promise<LoadResult>;
+  transform?: (this: PluginContext, code: string, id: string) => TransformResult | Promise<TransformResult>;
+  /**
+   * Rolldown output 阶段钩子：对每个 chunk 的最终代码做变换或按 chunk 收集产物。
+   * 仅在生产构建生效（dev unbundled 管线没有 chunk 概念）。
+   *
+   * `this` 是 Rolldown 真实的（Rollup 兼容）插件上下文，不是 PluginContext stub：
+   * `this.emitFile({type:'asset'})` 经 `output.assetFileNames` 产出带 hash 的文件，
+   * `this.getFileName(ref)` 可立即解析最终文件名。CSS per-chunk 抽取依赖这两点。
+   */
+  renderChunk?: (this: RenderChunkContext, code: string, chunk: RenderedChunk) => string | {
+    code: string;
+    map?: unknown;
+  } | null | undefined | Promise<string | {
+    code: string;
+    map?: unknown;
+  } | null | undefined>;
+  /** 向 chunk hash 折叠额外输入（如该 chunk 关联的 CSS 内容），保证缓存正确性 */
+  augmentChunkHash?: (this: RenderChunkContext, chunk: RenderedChunk) => string | void | Promise<string | void>;
+  /**
+   * Rolldown output 收尾钩子（write 前最后时机）。`this` 同 renderChunk，
+   * 可 emitFile 补充产物（如 cssCodeSplit:false 的合并 CSS、manifest 等）。
+   */
+  generateBundle?: (this: RenderChunkContext, options?: unknown, bundle?: Record<string, unknown>) => void | Promise<void>;
+  config?: (config: NastiConfig, env: {
+    mode: string;
+    command: string;
+  }) => NastiConfig | null | void | Promise<NastiConfig | null | void>;
+  configResolved?: (config: ResolvedConfig) => void | Promise<void>;
+  /**
+   * Environment API：在环境配置最终解析前调整单个环境的选项。
+   * 对每个环境名调用一次（含默认注入的 client/ssr）。
+   */
+  configEnvironment?: (name: string, options: EnvironmentOptions, env: {
+    mode: string;
+    command: string;
+  }) => EnvironmentOptions | null | void | Promise<EnvironmentOptions | null | void>;
+  /**
+   * Environment API：按环境过滤插件。返回 false 则该插件不进入此环境的
+   * 插件管线。未声明时插件应用于所有环境（与 Vite 默认一致）。
+   */
+  applyToEnvironment?: (environment: EnvironmentInstance) => boolean;
+  /**
+   * 为声明了 `environment.options.driver` 的环境提供外部编译驱动。
+   * 一个环境只能被一个插件接管；返回多个驱动会报错。
+   */
+  createEnvironmentDriver?: (environment: EnvironmentInstance, api: PluginApi) => EnvironmentDriver | null | undefined | Promise<EnvironmentDriver | null | undefined>;
+  /**
+   * 所有环境构建完成后的 app 级收尾钩子，用于跨环境聚合产物。
+   * Vue Lynx 原生后端可在这里组合 background/main-thread bundle。
+   */
+  afterBuildApp?: (results: Record<string, EnvironmentBuildResult>, api: PluginApi, context: BuildAppContext) => void | Promise<void>;
+  configureServer?: (server: DevServer) => void | (() => void) | Promise<void | (() => void)>;
+  transformIndexHtml?: (html: string) => string | HtmlTagDescriptor[] | {
+    html: string;
+    tags: HtmlTagDescriptor[];
+  } | Promise<string | HtmlTagDescriptor[] | {
+    html: string;
+    tags: HtmlTagDescriptor[];
+  }>;
+  handleHotUpdate?: (ctx: HmrContext) => void | ModuleNode[] | Promise<void | ModuleNode[]>;
+  /**
+   * 一个文件在所有 dev client 环境完成失效、插件 HMR 钩子与重新转换后调用一次。
+   * 多运行时工具链可据此只重编码受影响的 native section。
+   */
+  handleHotUpdateApp?: (ctx: AppHmrContext) => void | Promise<void>;
 }
 interface PluginContext {
-    resolve: (source: string, importer?: string) => Promise<ResolveIdResult>;
-    emitFile: (file: EmittedFile) => string;
-    getModuleInfo: (id: string) => ModuleInfo | null;
-    /**
-     * Environment API：当前钩子运行所在的环境（dev 管线中可用；
-     * 生产构建的 Rolldown 钩子注入在 Phase 2 接线）。
-     */
-    environment?: EnvironmentInstance;
+  resolve: (source: string, importer?: string) => Promise<ResolveIdResult>;
+  emitFile: (file: EmittedFile) => string;
+  getModuleInfo: (id: string) => ModuleInfo | null;
+  /**
+   * Environment API：当前钩子运行所在的环境（dev 管线中可用；
+   * 生产构建的 Rolldown 钩子注入在 Phase 2 接线）。
+   */
+  environment?: EnvironmentInstance;
 }
 type PluginApiKey = string | symbol;
 /** 插件 setup 与环境驱动共享的跨插件 API。 */
 interface PluginApi {
-    readonly config: ResolvedConfig;
-    readonly logger: Logger;
-    expose: <T>(key: PluginApiKey, value: T) => void;
-    useExposed: <T>(key: PluginApiKey) => T | undefined;
+  readonly config: ResolvedConfig;
+  readonly logger: Logger;
+  expose: <T>(key: PluginApiKey, value: T) => void;
+  useExposed: <T>(key: PluginApiKey) => T | undefined;
 }
 interface EnvironmentBuildOutput {
-    fileName: string;
-    type: string;
-    code?: string;
-    source?: Uint8Array | string;
-    map?: unknown;
-    name?: string;
-    names?: string[];
-    isEntry?: boolean;
-    isDynamicEntry?: boolean;
-    imports?: string[];
-    dynamicImports?: string[];
-    moduleIds?: string[];
+  fileName: string;
+  type: string;
+  code?: string;
+  source?: Uint8Array | string;
+  map?: unknown;
+  name?: string;
+  names?: string[];
+  isEntry?: boolean;
+  isDynamicEntry?: boolean;
+  imports?: string[];
+  dynamicImports?: string[];
+  moduleIds?: string[];
 }
 interface EnvironmentCssModule {
-    id: string;
-    source: string;
-    code: string;
+  id: string;
+  source: string;
+  code: string;
 }
 interface EnvironmentCssChunk {
-    fileName: string;
-    moduleIds: string[];
-    cssFileNames: string[];
+  fileName: string;
+  moduleIds: string[];
+  cssFileNames: string[];
 }
 interface EnvironmentCssMetadata {
-    modules: Record<string, EnvironmentCssModule>;
-    chunks: Record<string, EnvironmentCssChunk>;
+  modules: Record<string, EnvironmentCssModule>;
+  chunks: Record<string, EnvironmentCssChunk>;
 }
 interface EnvironmentChunkMetadata {
-    fileName: string;
-    name: string;
-    isEntry: boolean;
-    isDynamicEntry: boolean;
-    imports: string[];
-    dynamicImports: string[];
-    moduleIds: string[];
-    css: string[];
-    assets: string[];
+  fileName: string;
+  name: string;
+  isEntry: boolean;
+  isDynamicEntry: boolean;
+  imports: string[];
+  dynamicImports: string[];
+  moduleIds: string[];
+  css: string[];
+  assets: string[];
 }
 interface EnvironmentAssetMetadata {
-    fileName: string;
-    names: string[];
-    publicPath: string;
+  fileName: string;
+  names: string[];
+  publicPath: string;
 }
 /** 单个环境附加到标准构建结果上的结构化元数据。 */
 interface EnvironmentBuildMetadata {
-    entries?: Record<string, string>;
-    publicPath?: string;
-    manifest?: unknown;
-    stats?: unknown;
-    chunks?: Record<string, EnvironmentChunkMetadata>;
-    assets?: Record<string, EnvironmentAssetMetadata>;
-    css?: EnvironmentCssMetadata;
-    sourceMaps?: Record<string, unknown>;
+  entries?: Record<string, string>;
+  publicPath?: string;
+  manifest?: unknown;
+  stats?: unknown;
+  chunks?: Record<string, EnvironmentChunkMetadata>;
+  assets?: Record<string, EnvironmentAssetMetadata>;
+  css?: EnvironmentCssMetadata;
+  sourceMaps?: Record<string, unknown>;
 }
 /** 外部环境驱动或原生 Rolldown 环境返回的标准构建结果。 */
 interface EnvironmentBuildResult extends EnvironmentBuildMetadata {
-    output: EnvironmentBuildOutput[];
+  output: EnvironmentBuildOutput[];
 }
 /** app 级 finalizer 写出的聚合产物。 */
 interface AppBuildOutput extends EnvironmentBuildOutput {
-    type: 'asset';
-    source: Uint8Array | string;
+  type: 'asset';
+  source: Uint8Array | string;
 }
 /**
  * 所有环境完成后提供给 `afterBuildApp` 的只读查询与产物写出接口。
  * Lynx 等多运行时工具链可用它聚合 background/main-thread 结果，而无需读取磁盘目录。
  */
 interface BuildAppContext {
-    readonly config: ResolvedConfig;
-    readonly results: Readonly<Record<string, EnvironmentBuildResult>>;
-    readonly output: readonly AppBuildOutput[];
-    getResult: (environmentName: string) => EnvironmentBuildResult | undefined;
-    getArtifact: (environmentName: string, fileName: string) => EnvironmentBuildOutput | undefined;
-    getEntry: (environmentName: string, entryName: string) => EnvironmentBuildOutput | undefined;
-    getManifest: <T = unknown>(environmentName: string) => T | undefined;
-    getChunk: (environmentName: string, fileName: string) => EnvironmentChunkMetadata | undefined;
-    getCss: (environmentName: string) => EnvironmentCssMetadata | undefined;
-    getSourceMap: (environmentName: string, fileName: string) => unknown;
-    resolvePublicPath: (environmentName: string, fileName: string) => string | undefined;
-    /** 将聚合产物安全地写入 top-level `build.outDir`，并纳入 BuildResult.appOutput。 */
-    emitFile: (file: AppBuildOutput) => string;
+  readonly config: ResolvedConfig;
+  readonly results: Readonly<Record<string, EnvironmentBuildResult>>;
+  readonly output: readonly AppBuildOutput[];
+  getResult: (environmentName: string) => EnvironmentBuildResult | undefined;
+  getArtifact: (environmentName: string, fileName: string) => EnvironmentBuildOutput | undefined;
+  getEntry: (environmentName: string, entryName: string) => EnvironmentBuildOutput | undefined;
+  getManifest: <T = unknown>(environmentName: string) => T | undefined;
+  getChunk: (environmentName: string, fileName: string) => EnvironmentChunkMetadata | undefined;
+  getCss: (environmentName: string) => EnvironmentCssMetadata | undefined;
+  getSourceMap: (environmentName: string, fileName: string) => unknown;
+  resolvePublicPath: (environmentName: string, fileName: string) => string | undefined;
+  /** 将聚合产物安全地写入 top-level `build.outDir`，并纳入 BuildResult.appOutput。 */
+  emitFile: (file: AppBuildOutput) => string;
 }
 /** 外部环境驱动返回的开发服务信息。 */
 interface EnvironmentServeResult {
-    localUrls?: string[];
-    networkUrls?: string[];
-    middleware?: (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void;
+  localUrls?: string[];
+  networkUrls?: string[];
+  middleware?: (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void;
 }
 interface EnvironmentDriverContext {
-    environment: EnvironmentInstance;
-    config: ResolvedConfig;
-    api: PluginApi;
-    logger: Logger;
+  environment: EnvironmentInstance;
+  config: ResolvedConfig;
+  api: PluginApi;
+  logger: Logger;
 }
 interface EnvironmentDriverServeContext extends EnvironmentDriverContext {
-    server: DevServer;
+  server: DevServer;
 }
 interface EnvironmentDriver {
-    name: string;
-    build?: (context: EnvironmentDriverContext) => EnvironmentBuildResult | Promise<EnvironmentBuildResult>;
-    serve?: (context: EnvironmentDriverServeContext) => EnvironmentServeResult | void | Promise<EnvironmentServeResult | void>;
-    watchChange?: (file: string, event: 'add' | 'change' | 'unlink', context: EnvironmentDriverContext) => void | Promise<void>;
-    close?: (context: EnvironmentDriverContext) => void | Promise<void>;
+  name: string;
+  build?: (context: EnvironmentDriverContext) => EnvironmentBuildResult | Promise<EnvironmentBuildResult>;
+  serve?: (context: EnvironmentDriverServeContext) => EnvironmentServeResult | void | Promise<EnvironmentServeResult | void>;
+  watchChange?: (file: string, event: 'add' | 'change' | 'unlink', context: EnvironmentDriverContext) => void | Promise<void>;
+  close?: (context: EnvironmentDriverContext) => void | Promise<void>;
 }
 /**
  * 环境实例的公共面（核心实现见 core/environment.ts 的 NastiEnvironment）。
  * 插件经 `this.environment` / `applyToEnvironment(env)` 感知环境。
  */
 interface EnvironmentInstance {
-    name: string;
-    consumer: 'client' | 'server';
-    mode: 'dev' | 'build';
-    config: ResolvedConfig;
-    options: ResolvedEnvironmentOptions;
-    hot: HotChannel;
-    /** 声明 driver 后，由插件提供的外部环境编译驱动 */
-    driver?: EnvironmentDriver;
-    /** per-environment dev 模块图与插件列表。 */
-    moduleGraph: ModuleGraph$1;
-    plugins: NastiPlugin[];
-    /**
-     * 在该环境的独立 transform 管线中请求模块。仅 dev 环境在初始化后可用。
-     */
-    transformRequest: (url: string) => Promise<{
-        code: string;
-        map?: unknown;
-    } | null>;
-    /** 内置 CSS 管线登记模块；工具链通常读取 getCssModule(s)。 */
-    setCssModule: (module: EnvironmentCssModule) => void;
-    getCssModule: (id: string) => EnvironmentCssModule | undefined;
-    getCssModules: () => Readonly<Record<string, EnvironmentCssModule>>;
-    setAssetModule: (id: string, fileName: string) => void;
-    getAssetModules: () => Readonly<Record<string, string>>;
-    /** 由生产插件登记 entries / manifest / stats，构建完成后合并进环境结果。 */
-    setBuildMetadata: (metadata: EnvironmentBuildMetadata) => void;
+  name: string;
+  consumer: 'client' | 'server';
+  mode: 'dev' | 'build';
+  config: ResolvedConfig;
+  options: ResolvedEnvironmentOptions;
+  hot: HotChannel;
+  /** 声明 driver 后，由插件提供的外部环境编译驱动 */
+  driver?: EnvironmentDriver;
+  /** per-environment dev 模块图与插件列表。 */
+  moduleGraph: ModuleGraph$1;
+  plugins: NastiPlugin[];
+  /**
+   * 在该环境的独立 transform 管线中请求模块。仅 dev 环境在初始化后可用。
+   */
+  transformRequest: (url: string) => Promise<{
+    code: string;
+    map?: unknown;
+  } | null>;
+  /** 内置 CSS 管线登记模块；工具链通常读取 getCssModule(s)。 */
+  setCssModule: (module: EnvironmentCssModule) => void;
+  getCssModule: (id: string) => EnvironmentCssModule | undefined;
+  getCssModules: () => Readonly<Record<string, EnvironmentCssModule>>;
+  setAssetModule: (id: string, fileName: string) => void;
+  getAssetModules: () => Readonly<Record<string, string>>;
+  /** 由生产插件登记 entries / manifest / stats，构建完成后合并进环境结果。 */
+  setBuildMetadata: (metadata: EnvironmentBuildMetadata) => void;
 }
 /**
  * renderChunk / augmentChunkHash 的 `this`：Rolldown 真实插件上下文的最小可用面。
@@ -589,219 +629,220 @@ interface EnvironmentInstance {
  * referenceId，getFileName 能解析出带 hash 的最终文件名。
  */
 interface RenderChunkContext {
-    emitFile: (file: EmittedFile) => string;
-    getFileName: (referenceId: string) => string;
-    /** 当前生产钩子所属环境；BG/MT 同为 client consumer 时也可准确区分。 */
-    environment: EnvironmentInstance;
+  emitFile: (file: EmittedFile) => string;
+  getFileName: (referenceId: string) => string;
+  /** 当前生产钩子所属环境；BG/MT 同为 client consumer 时也可准确区分。 */
+  environment: EnvironmentInstance;
 }
 interface ResolveIdOptions {
-    isEntry?: boolean;
-    ssr?: boolean;
+  isEntry?: boolean;
+  ssr?: boolean;
 }
 type ResolveIdResult = string | null | undefined | {
-    id: string;
-    external?: boolean;
+  id: string;
+  external?: boolean;
 };
 type LoadResult = string | null | undefined | {
-    code: string;
-    map?: unknown;
+  code: string;
+  map?: unknown;
 };
 type TransformResult = string | null | undefined | {
-    code: string;
-    map?: unknown;
-    moduleType?: string;
-    /** 透传 Rolldown：'no-treeshake' 可保证模块不被摇出 chunk.moduleIds */
-    moduleSideEffects?: boolean | 'no-treeshake';
+  code: string;
+  map?: unknown;
+  moduleType?: string;
+  /** 透传 Rolldown：'no-treeshake' 可保证模块不被摇出 chunk.moduleIds */
+  moduleSideEffects?: boolean | 'no-treeshake';
 };
 interface EmittedFile {
-    type: 'asset' | 'chunk';
-    name?: string;
-    fileName?: string;
-    source?: string | Uint8Array;
+  type: 'asset' | 'chunk';
+  name?: string;
+  fileName?: string;
+  source?: string | Uint8Array;
 }
 interface ModuleInfo {
-    id: string;
-    importers: string[];
-    importedIds: string[];
+  id: string;
+  importers: string[];
+  importedIds: string[];
 }
 interface HtmlTagDescriptor {
-    tag: string;
-    attrs?: Record<string, string | boolean>;
-    children?: string | HtmlTagDescriptor[];
-    injectTo?: 'head' | 'body' | 'head-prepend' | 'body-prepend';
+  tag: string;
+  attrs?: Record<string, string | boolean>;
+  children?: string | HtmlTagDescriptor[];
+  injectTo?: 'head' | 'body' | 'head-prepend' | 'body-prepend';
 }
 interface ModuleNode {
-    id: string;
-    file: string | null;
-    url: string;
-    type: 'js' | 'css';
-    importers: Set<ModuleNode>;
-    importedModules: Set<ModuleNode>;
-    acceptedHmrDeps: Set<ModuleNode>;
-    transformResult: TransformResult | null;
-    lastHMRTimestamp: number;
-    /** 每次失效递增，防止较慢的旧转换覆盖较新的缓存。 */
-    invalidationVersion: number;
-    isSelfAccepting: boolean;
-    /** Environment API：节点所属环境名（per-env 模块图，默认 'client'） */
-    environment?: string;
+  id: string;
+  file: string | null;
+  url: string;
+  type: 'js' | 'css';
+  importers: Set<ModuleNode>;
+  importedModules: Set<ModuleNode>;
+  acceptedHmrDeps: Set<ModuleNode>;
+  transformResult: TransformResult | null;
+  lastHMRTimestamp: number;
+  /** 每次失效递增，防止较慢的旧转换覆盖较新的缓存。 */
+  invalidationVersion: number;
+  isSelfAccepting: boolean;
+  /** Environment API：节点所属环境名（per-env 模块图，默认 'client'） */
+  environment?: string;
 }
 interface ResolvedConfig {
-    root: string;
-    base: string;
-    mode: 'development' | 'production';
-    target: 'web' | 'electron';
-    /** `auto` 在配置解析阶段已收敛为具体框架 */
-    framework: 'react' | 'vue';
-    /** 解析后的 React 管线配置；Vue 项目仍保留该字段以简化插件读取。 */
-    react: ResolvedReactOptions;
-    command: 'build' | 'serve';
-    resolve: Required<ResolveConfig>;
-    plugins: NastiPlugin[];
-    server: Required<ServerConfig>;
-    build: Required<BuildConfig>;
-    electron: Required<ElectronConfig>;
-    envPrefix: string[];
-    logLevel: 'info' | 'warn' | 'error' | 'silent';
-    clearScreen: boolean;
-    /** 已接线 logLevel 的 Logger 实例，所有 Nasti 输出统一经此通道 */
-    logger: Logger;
-    /**
-     * 解析后的环境 map（默认 client + ssr）。`environments.client` 的
-     * resolve/build 与 top-level **同引用**（精确镜像，运行时有断言校验）。
-     */
-    environments: Record<string, ResolvedEnvironmentOptions>;
-    experimental: Required<ExperimentalOptions>;
+  root: string;
+  base: string;
+  mode: 'development' | 'production';
+  target: 'web' | 'electron';
+  /** `auto` 在配置解析阶段已收敛为具体框架 */
+  framework: 'react' | 'vue';
+  /** 解析后的 React 管线配置；Vue 项目仍保留该字段以简化插件读取。 */
+  react: ResolvedReactOptions;
+  command: 'build' | 'serve';
+  resolve: Required<ResolveConfig>;
+  plugins: NastiPlugin[];
+  server: Required<ServerConfig>;
+  build: Required<BuildConfig>;
+  electron: Required<ElectronConfig>;
+  envPrefix: string[];
+  logLevel: 'info' | 'warn' | 'error' | 'silent';
+  clearScreen: boolean;
+  /** 已接线 logLevel 的 Logger 实例，所有 Nasti 输出统一经此通道 */
+  logger: Logger;
+  /**
+   * 解析后的环境 map（默认 client + ssr）。`environments.client` 的
+   * resolve/build 与 top-level **同引用**（精确镜像，运行时有断言校验）。
+   */
+  environments: Record<string, ResolvedEnvironmentOptions>;
+  experimental: Required<ExperimentalOptions>;
 }
 interface DevServer {
-    config: ResolvedConfig;
-    middlewares: any;
-    /**
-     * client 环境模块图的别名（back-compat）。
-     * @deprecated 跟随 Vite 退役 flat `server.*` 的方向，2.x 移除；
-     * 新代码请用 `server.environments.client.moduleGraph`。
-     */
-    moduleGraph: ModuleGraph$1;
-    watcher: any;
-    ws: WebSocketServer;
-    /** Environment API：每个 client-consumer 环境都有独立的 transform/HMR 管线。 */
-    environments: Record<string, EnvironmentInstance>;
-    /** 外部环境驱动启动后返回的服务 URL / middleware 信息 */
-    environmentServices: Record<string, EnvironmentServeResult>;
-    listen: (port?: number) => Promise<DevServer>;
-    close: () => Promise<void>;
-    transformRequest: (url: string) => Promise<TransformResult>;
-    transformEnvironmentRequest: (environmentName: string, url: string) => Promise<TransformResult>;
-    /**
-     * SSR：在 server consumer 环境（默认 `ssr`）中加载并执行模块，返回其导出。
-     * Vite `server.ssrLoadModule` 的 back-compat shim（底层是 module runner +
-     * HotChannel invoke 桥）。模块经 moduleRunnerTransform 转换后在进程内求值，
-     * `import.meta.env.SSR === true`，bare import 外部化交给 node 解析。
-     */
-    ssrLoadModule: (url: string) => Promise<Record<string, unknown>>;
+  config: ResolvedConfig;
+  middlewares: any;
+  /**
+   * client 环境模块图的别名（back-compat）。
+   * @deprecated 跟随 Vite 退役 flat `server.*` 的方向，2.x 移除；
+   * 新代码请用 `server.environments.client.moduleGraph`。
+   */
+  moduleGraph: ModuleGraph$1;
+  watcher: any;
+  ws: WebSocketServer;
+  /** Environment API：每个 client-consumer 环境都有独立的 transform/HMR 管线。 */
+  environments: Record<string, EnvironmentInstance>;
+  /** 外部环境驱动启动后返回的服务 URL / middleware 信息 */
+  environmentServices: Record<string, EnvironmentServeResult>;
+  listen: (port?: number) => Promise<DevServer>;
+  close: () => Promise<void>;
+  transformRequest: (url: string) => Promise<TransformResult>;
+  transformEnvironmentRequest: (environmentName: string, url: string) => Promise<TransformResult>;
+  /**
+   * SSR：在 server consumer 环境（默认 `ssr`）中加载并执行模块，返回其导出。
+   * Vite `server.ssrLoadModule` 的 back-compat shim（底层是 module runner +
+   * HotChannel invoke 桥）。模块经 moduleRunnerTransform 转换后在进程内求值，
+   * `import.meta.env.SSR === true`，bare import 外部化交给 node 解析。
+   */
+  ssrLoadModule: (url: string) => Promise<Record<string, unknown>>;
 }
 interface ModuleGraph$1 {
-    getModuleByUrl: (url: string) => ModuleNode | undefined;
-    getModuleById: (id: string) => ModuleNode | undefined;
-    getModulesByFile: (file: string) => Set<ModuleNode> | undefined;
-    ensureEntryFromUrl: (url: string) => Promise<ModuleNode>;
-    invalidateModule: (mod: ModuleNode, timestamp?: number) => void;
-    invalidateModuleAndImporters: (mod: ModuleNode, timestamp?: number) => void;
-    getHmrBoundaries: (mod: ModuleNode) => Array<{
-        boundary: ModuleNode;
-        acceptedVia: ModuleNode;
-    }>;
-    invalidateAll: () => void;
+  getModuleByUrl: (url: string) => ModuleNode | undefined;
+  getModuleById: (id: string) => ModuleNode | undefined;
+  getModulesByFile: (file: string) => Set<ModuleNode> | undefined;
+  ensureEntryFromUrl: (url: string) => Promise<ModuleNode>;
+  invalidateModule: (mod: ModuleNode, timestamp?: number) => void;
+  invalidateModuleAndImporters: (mod: ModuleNode, timestamp?: number) => void;
+  getHmrBoundaries: (mod: ModuleNode) => Array<{
+    boundary: ModuleNode;
+    acceptedVia: ModuleNode;
+  }>;
+  invalidateAll: () => void;
 }
 interface WebSocketServer {
-    send: (payload: HmrPayload) => void;
-    close: () => void;
+  send: (payload: HmrPayload) => void;
+  close: () => void;
 }
 type HotChannelListener = (data: unknown, client: HotChannelClient) => void;
 interface HotChannelClient {
-    send: (payload: HmrPayload) => void;
+  send: (payload: HmrPayload) => void;
 }
 /** module runner 经 invoke 调用的 RPC 方法集（Vite DevEnvironment.hot.setInvokeHandler 同构） */
 interface HotChannelInvokeHandlers {
-    /** runner 回调 fetchModule → transformRequest → 求值 */
-    fetchModule: (id: string, importer?: string, options?: {
-        cached?: boolean;
-    }) => Promise<unknown>;
-    /** server 环境的内建模块清单（string/RegExp，序列化需对齐 runner 期望） */
-    getBuiltins?: () => Promise<Array<string | RegExp>> | Array<string | RegExp>;
-    /** 网络暴露的 transport 跳过文件系统存在性检查（安全相关，显式带上） */
-    _skipFsCheck?: boolean;
+  /** runner 回调 fetchModule → transformRequest → 求值 */
+  fetchModule: (id: string, importer?: string, options?: {
+    cached?: boolean;
+  }) => Promise<unknown>;
+  /** server 环境的内建模块清单（string/RegExp，序列化需对齐 runner 期望） */
+  getBuiltins?: () => Promise<Array<string | RegExp>> | Array<string | RegExp>;
+  /** 网络暴露的 transport 跳过文件系统存在性检查（安全相关，显式带上） */
+  _skipFsCheck?: boolean;
 }
 interface HotChannel {
-    /** 向该环境的所有客户端广播 */
-    send: (payload: HmrPayload) => void;
-    /** 监听客户端自定义事件（custom events / invoke transport） */
-    on?: (event: string, listener: HotChannelListener) => void;
-    off?: (event: string, listener: HotChannelListener) => void;
-    listen?: () => void;
-    close?: () => void | Promise<void>;
-    /** 注册 invoke 处理器（SSR runner 的 RPC 桥；Phase 1 仅定义契约） */
-    setInvokeHandler?: (handlers: HotChannelInvokeHandlers | undefined) => void;
+  /** 向该环境的所有客户端广播 */
+  send: (payload: HmrPayload) => void;
+  /** 监听客户端自定义事件（custom events / invoke transport） */
+  on?: (event: string, listener: HotChannelListener) => void;
+  off?: (event: string, listener: HotChannelListener) => void;
+  listen?: () => void;
+  close?: () => void | Promise<void>;
+  /** 注册 invoke 处理器（SSR runner 的 RPC 桥；Phase 1 仅定义契约） */
+  setInvokeHandler?: (handlers: HotChannelInvokeHandlers | undefined) => void;
 }
 interface HmrContext {
-    file: string;
-    timestamp: number;
-    modules: ModuleNode[];
-    read: () => string | Promise<string>;
-    server: DevServer;
-    environment: EnvironmentInstance;
+  file: string;
+  timestamp: number;
+  modules: ModuleNode[];
+  read: () => string | Promise<string>;
+  server: DevServer;
+  environment: EnvironmentInstance;
 }
 interface EnvironmentTransformedModule {
-    module: ModuleNode;
-    result: {
-        code: string;
-        map?: unknown;
-    } | null;
+  module: ModuleNode;
+  result: {
+    code: string;
+    map?: unknown;
+  } | null;
 }
 interface EnvironmentHotUpdateResult {
-    environment: EnvironmentInstance;
-    modules: ModuleNode[];
-    updates: HmrUpdate[];
-    transformed: EnvironmentTransformedModule[];
-    fullReload: boolean;
+  environment: EnvironmentInstance;
+  modules: ModuleNode[];
+  updates: HmrUpdate[];
+  transformed: EnvironmentTransformedModule[];
+  fullReload: boolean;
 }
 interface AppHmrContext {
-    file: string;
-    timestamp: number;
-    environments: Readonly<Record<string, EnvironmentHotUpdateResult>>;
-    server: DevServer;
+  file: string;
+  timestamp: number;
+  environments: Readonly<Record<string, EnvironmentHotUpdateResult>>;
+  server: DevServer;
 }
 type HmrPayload = ({
-    type: 'connected';
+  type: 'connected';
 } | {
-    type: 'update';
-    updates: HmrUpdate[];
+  type: 'update';
+  updates: HmrUpdate[];
 } | {
-    type: 'full-reload';
-    path?: string;
+  type: 'full-reload';
+  path?: string;
 } | {
-    type: 'prune';
-    paths: string[];
+  type: 'prune';
+  paths: string[];
 } | {
-    type: 'error';
-    err: {
-        message: string;
-        stack?: string;
-    };
+  type: 'error';
+  err: {
+    message: string;
+    stack?: string;
+  };
 } | {
-    type: 'custom';
-    event: string;
-    data?: unknown;
+  type: 'custom';
+  event: string;
+  data?: unknown;
 }) & {
-    environment?: string;
+  environment?: string;
 };
 interface HmrUpdate {
-    type: 'js-update' | 'css-update';
-    path: string;
-    acceptedPath: string;
-    timestamp: number;
+  type: 'js-update' | 'css-update';
+  path: string;
+  acceptedPath: string;
+  timestamp: number;
 }
-
+//#endregion
+//#region src/config/index.d.ts
 declare function defineConfig(config: NastiConfig): NastiConfig;
 /**
  * 将 framework:auto 收敛为具体框架。
@@ -820,156 +861,161 @@ declare function detectFramework(root: string): 'react' | 'vue';
  * @returns The fully resolved configuration with defaults applied, plugins filtered, and plugin hooks executed
  */
 declare function resolveConfig(inlineConfig: NastiConfig | undefined, command: 'build' | 'serve'): Promise<ResolvedConfig>;
-
+//#endregion
+//#region src/core/plugin-container.d.ts
 declare class PluginContainer {
-    private plugins;
-    private config;
-    private ctx;
-    private emittedFiles;
-    /** Environment API：容器所属环境（未传时为 undefined，行为同 1.x client） */
-    readonly environment?: EnvironmentInstance;
-    constructor(config: ResolvedConfig, environment?: EnvironmentInstance);
-    private createContext;
-    /** 返回所有通过 emitFile() 输出的文件 */
-    getEmittedFiles(): Array<{
-        fileName: string;
-        source: string | Uint8Array;
-    }>;
-    buildStart(): Promise<void>;
-    buildEnd(error?: Error): Promise<void>;
-    resolveId(source: string, importer?: string, options?: {
-        isEntry?: boolean;
-    }): Promise<ResolveIdResult>;
-    load(id: string): Promise<LoadResult>;
-    transform(code: string, id: string): Promise<TransformResult>;
-    /** 完整的模块处理管道: resolveId → load → transform */
-    processModule(source: string, importer?: string): Promise<{
-        id: string;
-        code: string;
-    } | null>;
-    getPlugins(): NastiPlugin[];
-}
-
+  private plugins;
+  private config;
+  private ctx;
+  private emittedFiles;
+  /** Environment API：容器所属环境（未传时为 undefined，行为同 1.x client） */
+  readonly environment?: EnvironmentInstance;
+  constructor(config: ResolvedConfig, environment?: EnvironmentInstance);
+  private createContext;
+  /** 返回所有通过 emitFile() 输出的文件 */
+  getEmittedFiles(): Array<{
+    fileName: string;
+    source: string | Uint8Array;
+  }>;
+  buildStart(): Promise<void>;
+  buildEnd(error?: Error): Promise<void>;
+  resolveId(source: string, importer?: string, options?: {
+    isEntry?: boolean;
+  }): Promise<ResolveIdResult>;
+  load(id: string): Promise<LoadResult>;
+  transform(code: string, id: string): Promise<TransformResult>;
+  /** 完整的模块处理管道: resolveId → load → transform */
+  processModule(source: string, importer?: string): Promise<{
+    id: string;
+    code: string;
+  } | null>;
+  getPlugins(): NastiPlugin[];
+}
+//#endregion
+//#region src/core/module-graph.d.ts
 declare class ModuleGraph {
-    readonly environmentName: string;
-    private urlToModuleMap;
-    private idToModuleMap;
-    private fileToModulesMap;
-    constructor(environmentName?: string);
-    getModuleByUrl(url: string): ModuleNode | undefined;
-    getModuleById(id: string): ModuleNode | undefined;
-    getModulesByFile(file: string): Set<ModuleNode> | undefined;
-    /**
-     * Modules whose registered entry file lives under `dir` (inclusive).
-     * Used when a non-entry source inside a prebundled workspace package changes:
-     * only the package entry was registered, so getModulesByFile(changedFile)
-     * misses — we invalidate every /@modules entry rooted in that package.
-     */
-    getModulesWithFileUnder(dir: string): Set<ModuleNode>;
-    ensureEntryFromUrl(url: string): Promise<ModuleNode>;
-    createModule(url: string, id?: string): ModuleNode;
-    /** 注册文件路径到模块的映射 */
-    registerModule(mod: ModuleNode, file: string): void;
-    /**
-     * Reindex a module under a plugin-provided canonical id (e.g. a `\0virtual:foo`
-     * id returned from `resolveId`). Plugins look up their own virtual modules via
-     * `getModuleById(RESOLVED_ID)` to invalidate them on watcher events; without
-     * this remap they'd never find the node because `ensureEntryFromUrl` keys by
-     * the public URL only.
-     */
-    setModuleId(mod: ModuleNode, id: string): void;
-    /** 更新模块依赖关系 */
-    updateModuleImports(mod: ModuleNode, importedIds: Set<string>): void;
-    /**
-     * 用一次转换得到的信息原子更新 import 与 HMR accept 关系。
-     * 依赖节点会在真正被浏览器请求前预先创建，这样入口模块先转换时也能建立完整图。
-     */
-    updateModuleInfo(mod: ModuleNode, importedUrls: Set<string>, acceptedUrls: Set<string>, isSelfAccepting: boolean, expectedInvalidationVersion?: number): Promise<Set<ModuleNode> | null>;
-    /** 使模块的转换缓存失效 */
-    invalidateModule(mod: ModuleNode, timestamp?: number): void;
-    /**
-     * 仅失效到 HMR 边界：显式接受依赖的模块本身不会重执行；自接受模块需要失效，
-     * 但不再继续影响其 importer。这样既能传播依赖时间戳，也不会隐式重复副作用。
-     */
-    invalidateModuleAndImporters(mod: ModuleNode, timestamp?: number, seen?: Set<ModuleNode>): void;
-    /** 使所有模块缓存失效 */
-    invalidateAll(): void;
-    /** 获取 HMR 传播边界 - 从变更模块向上遍历找到接受更新的边界 */
-    getHmrBoundaries(mod: ModuleNode): {
-        boundary: ModuleNode;
-        acceptedVia: ModuleNode;
-    }[];
-}
-
+  readonly environmentName: string;
+  private urlToModuleMap;
+  private idToModuleMap;
+  private fileToModulesMap;
+  constructor(environmentName?: string);
+  getModuleByUrl(url: string): ModuleNode | undefined;
+  getModuleById(id: string): ModuleNode | undefined;
+  getModulesByFile(file: string): Set<ModuleNode> | undefined;
+  /**
+   * Modules whose registered entry file lives under `dir` (inclusive).
+   * Used when a non-entry source inside a prebundled workspace package changes:
+   * only the package entry was registered, so getModulesByFile(changedFile)
+   * misses — we invalidate every /@modules entry rooted in that package.
+   */
+  getModulesWithFileUnder(dir: string): Set<ModuleNode>;
+  ensureEntryFromUrl(url: string): Promise<ModuleNode>;
+  createModule(url: string, id?: string): ModuleNode;
+  /** 注册文件路径到模块的映射 */
+  registerModule(mod: ModuleNode, file: string): void;
+  /**
+   * Reindex a module under a plugin-provided canonical id (e.g. a `\0virtual:foo`
+   * id returned from `resolveId`). Plugins look up their own virtual modules via
+   * `getModuleById(RESOLVED_ID)` to invalidate them on watcher events; without
+   * this remap they'd never find the node because `ensureEntryFromUrl` keys by
+   * the public URL only.
+   */
+  setModuleId(mod: ModuleNode, id: string): void;
+  /** 更新模块依赖关系 */
+  updateModuleImports(mod: ModuleNode, importedIds: Set<string>): void;
+  /**
+   * 用一次转换得到的信息原子更新 import 与 HMR accept 关系。
+   * 依赖节点会在真正被浏览器请求前预先创建，这样入口模块先转换时也能建立完整图。
+   */
+  updateModuleInfo(mod: ModuleNode, importedUrls: Set<string>, acceptedUrls: Set<string>, isSelfAccepting: boolean, expectedInvalidationVersion?: number): Promise<Set<ModuleNode> | null>;
+  /** 使模块的转换缓存失效 */
+  invalidateModule(mod: ModuleNode, timestamp?: number): void;
+  /**
+   * 仅失效到 HMR 边界：显式接受依赖的模块本身不会重执行；自接受模块需要失效，
+   * 但不再继续影响其 importer。这样既能传播依赖时间戳，也不会隐式重复副作用。
+   */
+  invalidateModuleAndImporters(mod: ModuleNode, timestamp?: number, seen?: Set<ModuleNode>): void;
+  /** 使所有模块缓存失效 */
+  invalidateAll(): void;
+  /** 获取 HMR 传播边界 - 从变更模块向上遍历找到接受更新的边界 */
+  getHmrBoundaries(mod: ModuleNode): {
+    boundary: ModuleNode;
+    acceptedVia: ModuleNode;
+  }[];
+}
+//#endregion
+//#region src/core/environment.d.ts
 interface NastiEnvironmentInit {
-    hot?: HotChannel;
-    mode?: 'dev' | 'build';
-    /** 环境的候选插件（init 时经 applyToEnvironment 过滤） */
-    plugins?: NastiPlugin[];
-    /** 配置解析阶段创建的共享插件 API；通常自动从 ResolvedConfig 获取 */
-    pluginApi?: PluginApi;
+  hot?: HotChannel;
+  mode?: 'dev' | 'build';
+  /** 环境的候选插件（init 时经 applyToEnvironment 过滤） */
+  plugins?: NastiPlugin[];
+  /** 配置解析阶段创建的共享插件 API；通常自动从 ResolvedConfig 获取 */
+  pluginApi?: PluginApi;
 }
 declare class NastiEnvironment implements EnvironmentInstance {
-    readonly name: string;
-    readonly consumer: 'client' | 'server';
-    readonly mode: 'dev' | 'build';
-    readonly config: ResolvedConfig;
-    readonly options: ResolvedEnvironmentOptions;
-    readonly hot: HotChannel;
-    driver?: EnvironmentDriver;
-    /** applyToEnvironment 过滤后的插件（init() 后可用） */
-    plugins: NastiPlugin[];
-    /** per-env 插件容器（init() 后可用；dev 管线使用） */
-    pluginContainer: PluginContainer | null;
-    /** per-env 模块图（dev 管线使用） */
-    moduleGraph: ModuleGraph;
-    private candidatePlugins;
-    private pluginApi;
-    private buildMetadata;
-    private cssModules;
-    private assetModules;
-    private transformRequestHandler?;
-    private initialized;
-    constructor(name: string, config: ResolvedConfig, init?: NastiEnvironmentInit);
-    /** 过滤插件并建 per-env PluginContainer */
-    init(): Promise<void>;
-    getDriverContext(): EnvironmentDriverContext;
-    configureDevPipeline(transformRequest: (url: string) => Promise<{
-        code: string;
-        map?: unknown;
-    } | null>): void;
-    transformRequest(url: string): Promise<{
-        code: string;
-        map?: unknown;
-    } | null>;
-    setCssModule(module: EnvironmentCssModule): void;
-    getCssModule(id: string): EnvironmentCssModule | undefined;
-    getCssModules(): Readonly<Record<string, EnvironmentCssModule>>;
-    setAssetModule(id: string, fileName: string): void;
-    getAssetModules(): Readonly<Record<string, string>>;
-    setBuildMetadata(metadata: EnvironmentBuildMetadata): void;
-    getBuildMetadata(): EnvironmentBuildMetadata;
-    close(): Promise<void>;
+  readonly name: string;
+  readonly consumer: 'client' | 'server';
+  readonly mode: 'dev' | 'build';
+  readonly config: ResolvedConfig;
+  readonly options: ResolvedEnvironmentOptions;
+  readonly hot: HotChannel;
+  driver?: EnvironmentDriver;
+  /** applyToEnvironment 过滤后的插件（init() 后可用） */
+  plugins: NastiPlugin[];
+  /** per-env 插件容器（init() 后可用；dev 管线使用） */
+  pluginContainer: PluginContainer | null;
+  /** per-env 模块图（dev 管线使用） */
+  moduleGraph: ModuleGraph;
+  private candidatePlugins;
+  private pluginApi;
+  private buildMetadata;
+  private cssModules;
+  private assetModules;
+  private transformRequestHandler?;
+  private initialized;
+  constructor(name: string, config: ResolvedConfig, init?: NastiEnvironmentInit);
+  /** 过滤插件并建 per-env PluginContainer */
+  init(): Promise<void>;
+  getDriverContext(): EnvironmentDriverContext;
+  configureDevPipeline(transformRequest: (url: string) => Promise<{
+    code: string;
+    map?: unknown;
+  } | null>): void;
+  transformRequest(url: string): Promise<{
+    code: string;
+    map?: unknown;
+  } | null>;
+  setCssModule(module: EnvironmentCssModule): void;
+  getCssModule(id: string): EnvironmentCssModule | undefined;
+  getCssModules(): Readonly<Record<string, EnvironmentCssModule>>;
+  setAssetModule(id: string, fileName: string): void;
+  getAssetModules(): Readonly<Record<string, string>>;
+  setBuildMetadata(metadata: EnvironmentBuildMetadata): void;
+  getBuildMetadata(): EnvironmentBuildMetadata;
+  close(): Promise<void>;
 }
 /** 按 applyToEnvironment 过滤环境插件（未声明 = 应用于所有环境） */
 declare function resolveEnvironmentPlugins(environment: EnvironmentInstance, plugins: NastiPlugin[]): NastiPlugin[];
-
+//#endregion
+//#region src/build/index.d.ts
 interface BuildResult {
-    /** client 环境的产物（back-compat：1.x 的 BuildResult 形态） */
-    output: EnvironmentBuildOutput[];
-    /** 全部已构建环境的产物（2.0 多环境 builder） */
-    environments?: Record<string, BuildResult['output']>;
-    /** 全部环境的完整结果（entries / manifest / stats 等） */
-    environmentResults?: Record<string, EnvironmentBuildResult>;
-    /** app 级 finalizer 聚合写出的产物（如 `.lynx.bundle`） */
-    appOutput?: AppBuildOutput[];
+  /** client 环境的产物（back-compat：1.x 的 BuildResult 形态） */
+  output: EnvironmentBuildOutput[];
+  /** 全部已构建环境的产物（2.0 多环境 builder） */
+  environments?: Record<string, BuildResult['output']>;
+  /** 全部环境的完整结果（entries / manifest / stats 等） */
+  environmentResults?: Record<string, EnvironmentBuildResult>;
+  /** app 级 finalizer 聚合写出的产物（如 `.lynx.bundle`） */
+  appOutput?: AppBuildOutput[];
 }
 declare function build(inlineConfig?: NastiConfig): Promise<BuildResult>;
-
+//#endregion
+//#region src/build/electron.d.ts
 interface ElectronBuildResult {
-    rendererOutDir: string;
-    mainFile: string;
-    preloadFiles: string[];
+  rendererOutDir: string;
+  mainFile: string;
+  preloadFiles: string[];
 }
 /**
  * Performs a full Electron build pipeline producing renderer, main, and preload artifacts.
@@ -988,12 +1034,14 @@ declare function buildElectron(inlineConfig?: NastiConfig): Promise<ElectronBuil
  * `./`，避免产物中的 `/assets/*` 被解析到文件系统根目录。
  */
 declare function createElectronRendererConfig(config: ResolvedConfig, inlineConfig?: NastiConfig, overrides?: Pick<NastiConfig, 'build'>): NastiConfig;
-
+//#endregion
+//#region src/server/index.d.ts
 declare function createServer(inlineConfig?: NastiConfig): Promise<DevServer>;
-
+//#endregion
+//#region src/server/electron-dev.d.ts
 interface ElectronDevOptions extends NastiConfig {
-    /** 不启动 Electron 进程，只编译主/preload（CI 场景） */
-    noSpawn?: boolean;
+  /** 不启动 Electron 进程，只编译主/preload（CI 场景） */
+  noSpawn?: boolean;
 }
 /**
  * Start an Electron-focused development workflow: run the renderer dev server, build the main and preload bundles into .nasti/, and optionally spawn Electron with automatic restarts.
@@ -1003,7 +1051,8 @@ interface ElectronDevOptions extends NastiConfig {
 declare function startElectronDev(inlineConfig?: ElectronDevOptions): Promise<void>;
 /** 将 renderer HTML 路径转换为 Electron 开发服务器 URL path。 */
 declare function electronRendererDevPath(renderer: string): string;
-
+//#endregion
+//#region src/plugins/electron.d.ts
 /**
  * Create a Vite/Rollup plugin that externalizes Electron and Node built-in imports according to the resolved config.
  *
@@ -1011,54 +1060,56 @@ declare function electronRendererDevPath(renderer: string): string;
  * @returns A plugin that marks `electron` and `electron/*` imports and Node built-in modules (including `node:`-prefixed names) as external.
  */
 declare function electronPlugin(config: ResolvedConfig): NastiPlugin;
-
+//#endregion
+//#region src/plugins/monaco-editor.d.ts
 type MonacoEditorLanguageWorker = 'editorWorkerService' | 'css' | 'html' | 'json' | 'typescript';
 interface MonacoCustomWorker {
-    label: string;
-    entry: string;
+  label: string;
+  entry: string;
 }
 interface MonacoEditorPluginOptions {
-    /** 启用的 Monaco 语言 Worker，默认启用全部 */
-    languageWorkers?: MonacoEditorLanguageWorker[];
-    /** 额外自定义 Worker（如 monaco-graphql/esm/graphql.worker） */
-    customWorkers?: MonacoCustomWorker[];
-    /** Worker 在 URL 上的公共路径，默认 'monacoeditorwork'。可填 CDN 绝对 URL */
-    publicPath?: string;
-    /** 是否将 Monaco API 暴露到 window.monaco（兼容 0.22 之前的 globalAPI 模式） */
-    globalAPI?: boolean;
-    /** publicPath 是 CDN 时仍强制本地打包 Worker 产物 */
-    forceBuildCDN?: boolean;
-    /** 自定义生产构建下 Worker 产物目录（绝对路径） */
-    customDistPath?: (root: string, outDir: string, base: string) => string;
+  /** 启用的 Monaco 语言 Worker，默认启用全部 */
+  languageWorkers?: MonacoEditorLanguageWorker[];
+  /** 额外自定义 Worker（如 monaco-graphql/esm/graphql.worker） */
+  customWorkers?: MonacoCustomWorker[];
+  /** Worker 在 URL 上的公共路径，默认 'monacoeditorwork'。可填 CDN 绝对 URL */
+  publicPath?: string;
+  /** 是否将 Monaco API 暴露到 window.monaco（兼容 0.22 之前的 globalAPI 模式） */
+  globalAPI?: boolean;
+  /** publicPath 是 CDN 时仍强制本地打包 Worker 产物 */
+  forceBuildCDN?: boolean;
+  /** 自定义生产构建下 Worker 产物目录（绝对路径） */
+  customDistPath?: (root: string, outDir: string, base: string) => string;
 }
 declare function monacoEditorPlugin(options?: MonacoEditorPluginOptions): NastiPlugin;
-
+//#endregion
+//#region src/plugins/rsc.d.ts
 interface RscPluginOptions {
-    /** Vite RSC 风格的三环境入口简写。 */
-    entries?: Partial<Record<'client' | 'ssr' | 'rsc', string | string[]>>;
-    /** 自定义环境名；默认 client / ssr / rsc。 */
-    environment?: Partial<Record<'client' | 'ssr' | 'rsc', string>>;
-    /** 扫描 client/server directive 的源码目录；默认扫描 app 与 src。 */
-    scanDirectories?: string[];
-    include?: ReactFileFilter;
-    exclude?: ReactFileFilter;
-    /** 可检查的引用清单；false 可关闭写出。 @default 'rsc-manifest.json' */
-    manifestFile?: string | false;
+  /** Vite RSC 风格的三环境入口简写。 */
+  entries?: Partial<Record<'client' | 'ssr' | 'rsc', string | string[]>>;
+  /** 自定义环境名；默认 client / ssr / rsc。 */
+  environment?: Partial<Record<'client' | 'ssr' | 'rsc', string>>;
+  /** 扫描 client/server directive 的源码目录；默认扫描 app 与 src。 */
+  scanDirectories?: string[];
+  include?: ReactFileFilter;
+  exclude?: ReactFileFilter;
+  /** 可检查的引用清单；false 可关闭写出。 @default 'rsc-manifest.json' */
+  manifestFile?: string | false;
 }
 interface RscManifestReference {
-    id: string;
-    name: string;
-    chunks: string[];
+  id: string;
+  name: string;
+  chunks: string[];
 }
 interface RscManifest {
-    version: 1;
-    environments: {
-        client: string;
-        ssr: string;
-        rsc: string;
-    };
-    clientReferences: Record<string, RscManifestReference>;
-    serverReferences: Record<string, RscManifestReference>;
+  version: 1;
+  environments: {
+    client: string;
+    ssr: string;
+    rsc: string;
+  };
+  clientReferences: Record<string, RscManifestReference>;
+  serverReferences: Record<string, RscManifestReference>;
 }
 /**
  * React Server Components 的低层生成器。
@@ -1068,7 +1119,8 @@ interface RscManifest {
  * 图生成 server reference proxy，并在 buildApp 收尾阶段写出稳定清单。
  */
 declare function rsc(options?: RscPluginOptions): NastiPlugin;
-
+//#endregion
+//#region src/core/hot-channel.d.ts
 /** 非 client 环境的占位通道（SSR/edge 可由 runner/driver 接上真实 transport） */
 declare function createNoopHotChannel(): HotChannel;
 /**
@@ -1076,16 +1128,18 @@ declare function createNoopHotChannel(): HotChannel;
  * 事件监听与 invoke 在现有 ws 协议上预留，payload 以 environment 字段分流。
  */
 declare function createWsHotChannel(ws: WebSocketServer, environmentName?: string): HotChannel;
-
+//#endregion
+//#region src/core/debug.d.ts
 type NastiDebugScope = `nasti:${string}`;
 interface DebuggerOptions {
-    /** 仅当 DEBUG 精确包含该命名空间（而非 nasti:* 通配）时才启用 */
-    onlyWhenFocused?: boolean | string;
+  /** 仅当 DEBUG 精确包含该命名空间（而非 nasti:* 通配）时才启用 */
+  onlyWhenFocused?: boolean | string;
 }
 declare function createDebugger(namespace: NastiDebugScope, options?: DebuggerOptions): ((...args: unknown[]) => void) | undefined;
-
+//#endregion
+//#region src/core/env.d.ts
 interface EnvRecord {
-    [key: string]: string;
+  [key: string]: string;
 }
 /**
  * 从 .env 文件加载环境变量，按优先级合并：
@@ -1104,5 +1158,6 @@ declare function loadEnv(mode: string, root: string, prefixes: string[]): EnvRec
 declare function buildEnvDefine(env: EnvRecord, mode: string, overrides?: Record<string, string>): Record<string, string>;
 /** 按环境 consumer 派生 import.meta.env.SSR 的 define 覆盖 */
 declare function ssrDefineOverrides(consumer: 'client' | 'server'): Record<string, string>;
-
-export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type ReactCompilerOptions, type ReactFileFilter, type ReactOptions, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type ResolvedReactOptions, type RscManifest, type RscManifestReference, type RscPluginOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, rsc, ssrDefineOverrides, startElectronDev };
+//#endregion
+export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type MinifyOption, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiMinifyOptions, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type ReactCompilerOptions, type ReactFileFilter, type ReactOptions, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type ResolvedMinifyOption, type ResolvedReactOptions, type RscManifest, type RscManifestReference, type RscPluginOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, rsc, ssrDefineOverrides, startElectronDev };
+//# sourceMappingURL=index.d.cts.map