A JavaScript bundler you can embed in your code.

Instead of running a CLI tool, call Fob as a library. Build meta-frameworks, custom build tools, or bundle dynamically at runtime.

npm install @fox-uni/fob

import { Fob } from '@fox-uni/fob';

const bundler = new Fob({
  entries: ['./src/index.ts'],
  outputDir: 'dist',
  format: 'esm',
});

const result = await bundler.bundle();
console.log(`Built ${result.stats.totalModules} modules`);

use fob_bundler::BuildOptions;

let result = BuildOptions::library("src/index.ts")
    .external(["react", "react-dom"])
    .build()
    .await?;

println!("Built {} modules", result.stats().module_count);

Bundle code directly without files — useful for dynamic code generation:

const bundler = new Fob({
  entries: [
    {
      content: "console.log('Hello!');",
      name: 'main.js',
    },
  ],
  outputDir: 'dist',
});

Traditional bundlers are CLI tools:

webpack --config webpack.config.js
rollup -c

Fob is a library you call from your code:

const result = await bundler.bundle();
// Inspect results, make decisions, bundle again

• Build meta-frameworks - Scan directories, bundle routes dynamically
• Custom build tools - Embed bundling in your toolchain
• Dynamic bundling - Bundle based on runtime conditions
• IDE extensions - Bundle in-process without spawning CLI
• Testing - Bundle test fixtures programmatically

interface Entry {
  content: string; // Inline JavaScript/TypeScript code
  name: string; // Virtual filename (e.g., "main.js", "app.ts")
  loader?: string; // "js", "ts", "jsx", "tsx" (inferred from name)
}

interface BundleResult {
  chunks: ChunkInfo[];
  stats: {
    totalModules: number;
    totalSize: number;
  };
  manifest: ManifestInfo;
  assets: AssetInfo[];
}

interface ChunkInfo {
  id: string;
  kind: 'entry' | 'async' | 'shared';
  fileName: string;
  code: string;
  sourceMap?: string;
  modules: ModuleInfo[];
  imports: string[];
  dynamicImports: string[];
  size: number;
}

• Library-first - Call from JavaScript or Rust
• Type-safe - Structured results, not strings to parse
• Cross-platform - Native bindings and WASM (browser/edge)
• Inline content - Bundle code without file I/O
• Task-based API - library(), app(), components() presets (Rust)

See the examples/ directory for complete examples:

• examples/js/fob-simple/ - Node.js examples
• examples/rust/ - Rust examples

MIT