rolldown-require 1.0.5 → 2.0.0

package/README.md

@@ -119,6 +119,39 @@ This library is published as part of [weapp-vite](https://github.com/weapp-vite/
 
 The library is under active development. If you encounter any issues or have suggestions, please feel free to open an issue on [GitHub Issues](https://github.com/weapp-vite/weapp-vite/issues).
 
+## Benchmarks
+
+`pnpm --filter rolldown-require-bench benchmark` (10 cold iterations, local M3, Node 22.21.1):
+
+```
+Scenario: tiny-static (25 modules)
+rolldown-require  | avg 60.52ms | median 58.36ms | deps 26 | rssΔ median 1.02 MB
+unrun             | avg 61.16ms | median 61.32ms | deps 26 | rssΔ median 0.64 MB
+
+Scenario: medium-mixed (100 modules, dynamic import every 10)
+rolldown-require  | avg 49.85ms | median 46.38ms | deps 102 | rssΔ median 2.29 MB
+unrun             | avg 52.30ms | median 30.49ms | deps 101 | rssΔ median 1.44 MB
+
+Scenario: large-static (200 modules)
+rolldown-require  | avg 55.47ms | median 45.89ms | deps 201 | rssΔ median 2.86 MB
+unrun             | avg 64.54ms | median 50.02ms | deps 201 | rssΔ median 1.33 MB
+```
+
+Notes:
+
+- Fixtures are synthetic TS module graphs (static and mixed dynamic imports) generated in `packages/rolldown-require-bench/benchmark/index.mjs`.
+- Each unrun iteration clears `.unrun` caches to force cold runs. Use `BENCH_ITERATIONS` to change repetitions.
+
+### Takeaways
+
+- With 10 cold iterations on synthetic graphs, rolldown-require remains generally faster (avg/median) across scenarios; unrun shows lower RSS deltas.
+- Dependency counts align (same or near-same), indicating comparable graph coverage.
+- Numbers come from `packages/rolldown-require-bench/benchmark/index.mjs` on M3/Node 22.21.1; rerun on your workloads for final decisions.
+
+### Cache
+
+- `cache: true` or `{ enabled: true, dir?, reset?, onEvent? }` enables persistent bundled output (default dir: nearest `node_modules/.rolldown-require-cache` or OS tmp). Validates mtime/size of entry + deps before reuse; falls back to rebuild when stale.
+
 ## License
 
 MIT © [sonofmagic](https://github.com/sonofmagic)

package/dist/index.d.ts

@@ -3,6 +3,35 @@ import { InputOptions, OutputOptions, ExternalOption } from 'rolldown';
 type RequireFunction = (outfile: string, ctx: {
     format: 'cjs' | 'esm';
 }) => any;
+interface CacheEvent {
+    type: 'hit' | 'miss' | 'store' | 'skip-invalid';
+    key: string;
+    reason?: string;
+}
+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`.
+     */
+    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.
+     */
+    memory?: boolean;
+    /**
+     * Receive cache events for debugging/metrics.
+     */
+    onEvent?: (event: CacheEvent) => void;
+}
 type GetOutputFile = (filepath: string, format: 'esm' | 'cjs') => string;
 interface Options {
     cwd?: string;
@@ -55,6 +84,10 @@ interface Options {
      * to skip the default format inference
      */
     format?: 'cjs' | 'esm';
+    /**
+     * Persistent cache for bundled output to speed up repeated loads.
+     */
+    cache?: boolean | CacheOptions;
 }
 interface InternalOptions extends Omit<Options, 'cwd' | 'filepath'> {
     isESM: boolean;
@@ -67,11 +100,14 @@ declare const configDefaults: Readonly<{
         extensions: string[];
     };
 }>;
+
 declare function bundleFile(fileName: string, options: InternalOptions): Promise<{
     code: string;
     dependencies: string[];
 }>;
-declare function loadFromBundledFile(fileName: string, bundledCode: string, options: InternalOptions): Promise<any>;
+
+declare function loadFromBundledFile(fileName: string, bundledCode: string, options: InternalOptions, dependencies?: string[]): Promise<any>;
+
 declare function bundleRequire<T = any>(options: Options): Promise<{
     mod: T;
     dependencies: string[];