rolldown-require 2.0.3 → 2.0.4

package/dist/index.d.ts

@@ -10,25 +10,25 @@ interface CacheEvent {
 }
 interface CacheOptions {
     /**
-     * Enable persistent cache. Pass an object to configure.
+     * 启用持久化缓存，可传入对象进行配置。
      */
     enabled?: boolean;
     /**
-     * Optional cache directory. Defaults to nearest `node_modules/.rolldown-require-cache`
-     * or `os.tmpdir()/rolldown-require-cache`.
+     * 可选缓存目录。默认使用最近的 `node_modules/.rolldown-require-cache`
+     * 或 `os.tmpdir()/rolldown-require-cache`。
      */
     dir?: string;
     /**
-     * Clear any existing cache entry before writing a new one.
+     * 写入新缓存前清理已有条目。
      */
     reset?: boolean;
     /**
-     * Also keep a process-local in-memory cache to skip filesystem hits.
-     * Defaults to true when persistent cache is enabled.
+     * 同时保留进程内缓存以减少文件系统访问。
+     * 启用持久化缓存时默认 true。
      */
     memory?: boolean;
     /**
-     * Receive cache events for debugging/metrics.
+     * 接收缓存事件，用于调试或指标统计。
      */
     onEvent?: (event: CacheEvent) => void;
 }
@@ -36,62 +36,60 @@ type GetOutputFile = (filepath: string, format: 'esm' | 'cjs') => string;
 interface Options {
     cwd?: string;
     /**
-     * The filepath to bundle and require
+     * 需要打包并 require 的文件路径。
      */
     filepath: string;
     /**
-     * The `require` function that is used to load the output file
-     * Default to the global `require` function
-     * This function can be asynchronous, i.e. returns a Promise
+     * 用于加载输出文件的 `require` 方法。
+     * 默认为全局 `require`。
+     * 可为异步函数（返回 Promise）。
      */
     require?: RequireFunction;
     /**
-     * esbuild options
-     *
+     * Rolldown 构建选项。
      */
     rolldownOptions?: {
         input?: InputOptions;
         output?: OutputOptions;
     };
     /**
-     * Get the path to the output file
-     * By default we simply replace the extension with `.bundled_{randomId}.js`
+     * 获取输出文件路径。
+     * 默认仅替换扩展名为 `.bundled_{randomId}.js`。
      */
     getOutputFile?: GetOutputFile;
     /**
-     * Enable watching and call the callback after each rebuild
+     * 启用监听并在每次重建后触发回调。
      */
-    /** External packages */
+    /** 外部依赖（external） */
     external?: ExternalOption;
-    /** Not external packages */
+    /** 非 external 的依赖 */
     /**
-     * Automatically mark node_modules as external
-     * @default true - `false` when `filepath` is in node_modules
+     * 自动将 node_modules 标记为 external。
+     * @default true - 当 `filepath` 位于 node_modules 时为 false
      */
     /**
-     * A custom tsconfig path to read `paths` option
+     * 自定义 tsconfig 路径，用于读取 `paths` 配置。
      *
-     * Set to `false` to disable tsconfig
+     * 设为 `false` 以禁用 tsconfig。
      */
     tsconfig?: string | false;
     /**
-     * Preserve compiled temporary file for debugging
-     * Default to `process.env.BUNDLE_REQUIRE_PRESERVE`
+     * 保留编译后的临时文件便于调试。
+     * 默认为 `process.env.BUNDLE_REQUIRE_PRESERVE`。
      */
     preserveTemporaryFile?: boolean;
     /**
-     * Provide bundle format explicitly
-     * to skip the default format inference
+     * 显式指定 bundle 格式，跳过默认推断。
      */
     format?: 'cjs' | 'esm';
     /**
-     * Enable source maps for debugging.
-     * - `true` will default to inline source maps.
-     * - `'inline'` forces inline source maps.
+     * 启用 source map 便于调试。
+     * - `true` 默认使用内联 source map。
+     * - `'inline'` 强制内联 source map。
      */
     sourcemap?: boolean | 'inline';
     /**
-     * Persistent cache for bundled output to speed up repeated loads.
+     * 持久化缓存打包结果，加速重复加载。
      */
     cache?: boolean | CacheOptions;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rolldown-require",
   "type": "module",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "bundle and require a file using rolldown!",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",