programmatic usage

README.md

@@ -47,6 +47,25 @@ $ mach build ./src/index.html
 $ mach dev ./src/index.html #todo
 ```
 
+## Programatic Usage
+
+```javascript
+import { Mach } from '@alshdavid/mach'
+
+// Create a Mach instance
+const mach = new Mach()
+
+// Listen to build events
+mach.subscribe('build_event', event => console.log(event))
+
+// Build a target
+const report = await mach.build({
+  projectRoot: process.cwd(),
+  outFolder: 'dist',
+  entries: ['src/index.js']
+})
+```
+
 ## Supported Types
 
 Mach comes preconfigured with sensible defaults and does not need configuration. Mach ships with built-in support for the most common source files in web development.

npm/mach/lib/index.js

@@ -5,6 +5,7 @@ class MachInitError extends Error {
   }
 }
 
+export * from './mach.js'
 export const Resolver = globalThis.Mach?.Resolver || MachInitError
 export const Transformer = globalThis.Mach?.Transformer || MachInitError
 export const Dependency = globalThis.Mach?.Dependency || MachInitError

npm/mach/lib/mach.js

@@ -71,13 +71,18 @@ export class Mach {
 
     if (options.bundleSplitting)
       cli_args.push('--bundle-splitting', `${options.bundleSplitting}`)
-    if (options.clean) cli_args.push('--clean', `${options.clean}`)
+    if (options.clean) cli_args.push('--clean')
     if (options.nodeWorkers)
       cli_args.push('--node-workers', `${options.nodeWorkers}`)
     if (options.optimize) cli_args.push('--no-optimize', `${!options.optimize}`)
     if (options.outFolder) cli_args.push('--dist', options.outFolder)
     if (options.threads) cli_args.push('--threads', `${options.threads}`)
 
+    for (const entry of options.entries) {
+      cli_args.push(entry)
+    }
+
+    console.log(cli_args.join(' '))
     const child = child_process.spawn(BIN_PATH, cli_args, {
       shell: true,
       cwd: options.projectRoot ?? process.cwd(),
@@ -136,4 +141,9 @@ export class Mach {
       setTimeout(() => subscriber(event), 0)
     }
   }
+
+  static build(options) {
+    const mach = new Mach(options)
+    return mach.build(options)
+  }
 }

npm/mach/types/mach.d.ts

@@ -29,7 +29,7 @@ export type BuildProgress = {}
 
 export type BuildReport = {
   bundleManifest: Record<string, string>
-  output: Record<string, string>
+  entries: Record<string, string>
 }
 
 export declare class Mach {

testing/tests/javascript.ts

@@ -8,12 +8,14 @@ describe('javascript', { concurrency: true }, () => {
   test('synchronous passing test', async (t) => {    
     const report = await Mach.build({
       projectRoot: FIXTURES('js-commonjs'),
+      clean: true,
+      outFolder: 'dist',
       entries: ['src/index.js']
     })
 
     await using nodejs = new NodejsContext({ type: 'commonjs' })
 
-    await nodejs.import(FIXTURES('js-commonjs', report.output['src/index.js']))
+    await nodejs.import(FIXTURES('js-commonjs', 'dist', report.entries['src/index.js']))
     await nodejs.get_global('onready')
 
     const values = {