Struct Bundler 

pub struct Bundler { /* private fields */ }

The bundle front-end for one runtime configuration: its options, the module table whose specifiers stay external, and the cache its compiles land in.

Implementations

impl Bundler

pub fn new( options: BundlerOptions, registry: Arc<ModuleRegistry>, cache: BytecodeCache, ) -> Self

A bundler for realms built over registry.

pub fn options(&self) -> &BundlerOptions

pub fn registry(&self) -> &Arc<ModuleRegistry>

pub fn cache(&self) -> &BytecodeCache

pub fn env_fingerprint(&self) -> u64

Everything outside the entry files that can change a bundle’s output for byte-identical sources: the options and the native module table. Every cache key folds this in.

pub fn cache_key(&self, kind: &str, entry_paths: &[PathBuf], cwd: &Path) -> u64

A cache key for entry_paths bundled from cwd under kind.

pub async fn bundle( &self, entry_paths: &[PathBuf], cwd: &Path, ) -> Result<BundledSource, ScriptError>

rolldown-bundle + tree-shake + transpile the entry files (and their node_modules / shared imports) into a single ESM module. Exposed for diagnostics and tests; Self::compile is the production path.

Errors

A bundle failure, rendered with the file and line it points at.

pub async fn compile( &self, entry_paths: &[PathBuf], cwd: &Path, module_name: &str, ) -> Result<CompiledModule, ScriptError>

Bundle the entry files (TypeScript ok; node_modules and shared helpers resolved + tree-shaken) into one ESM module and compile it to bytecode under module_name, which is what error locations and stack frames are labelled with. Done once; every realm links the result.

Errors

A bundle failure, or a module that fails to declare.

pub async fn compile_source( &self, code: &str, module_name: &str, source_map_json: Option<&str>, ) -> Result<CompiledModule, ScriptError>

Compile already-bundled ESM code to QuickJS bytecode.

Split out of Self::compile because bundling and compiling can happen in different processes: a client bundles (its working directory is the one relative imports resolve against) and a host compiles (its QuickJS build is the one that will load the bytecode), so bytecode never crosses the wire between differently- built binaries.

Does not touch the disk cache: the caller owns the key, because only it knows which inputs the code was built from.

Errors

ScriptError if the module fails to declare (a syntax error, or an import the native loader cannot resolve) or to serialize.

Trait Implementations

impl Clone for Bundler

fn clone(&self) -> Bundler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Bundler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.