Struct PackBuilder 

pub struct PackBuilder<'a> { /* private fields */ }

Builds a release pack from a project’s assets/ directory.

use khora_io::asset::{PackBuilder, PackProgress};

let (tx, rx) = crossbeam_channel::unbounded::<PackProgress>();
std::thread::spawn(move || {
    while let Ok(ev) = rx.recv() { /* update UI */ }
});

let out = PackBuilder::new(&project_assets_dir, &dest_dir)
    .with_progress(tx)
    .build()?;

Implementations

impl<'a> PackBuilder<'a>

pub fn new(assets_root: &'a Path, dest_dir: &'a Path) -> PackBuilder<'a>

Creates a new builder. assets_root is the project’s assets/ directory (the same path that ProjectVfs watches in dev mode). dest_dir is where index.bin + data.pack will be written — created if missing.

pub fn with_progress(self, tx: Sender<PackProgress>) -> PackBuilder<'a>

Forwards incremental progress to tx. Drop the receiver to silently disable progress (the sends are best-effort and never block).

pub fn with_compression(self, compression: CompressionKind) -> PackBuilder<'a>

Sets the per-entry compression scheme. Default is [CompressionKind::None]. When set to LZ4, every asset is compressed individually so the runtime can decompress on demand (no global state, no streaming gzip).

pub fn with_manifest(self, enable: bool) -> PackBuilder<'a>

Emits a manifest.bin sidecar with BLAKE3 hashes of every uncompressed asset. The runtime opts in via RuntimeConfig::verify_integrity to detect corruption / tampering at load time.

pub fn build(self) -> Result<PackOutput, Error>

Performs the build. Side effects:

• creates <dest_dir>/ if missing,
• writes <dest_dir>/data.pack (concatenation of asset bytes),
• writes <dest_dir>/index.bin (bincode-encoded metadata).

The two files together are everything khora_runtime needs to load the project at runtime via crate::asset::PackLoader.