programmatic start

examples/app-react-ts/package.json

@@ -12,4 +12,4 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   }
-}
+}

examples/app-react/package.json

@@ -12,4 +12,4 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   }
-}
+}

examples/html-circular-dependencies/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-commonjs-in-html/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-commonjs-nested/package.json

@@ -12,4 +12,4 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   }
-}
+}

examples/html-css-in-html/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-css-in-js/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-esm-dynamic-in-html/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-esm-in-html-simple/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-esm-in-html/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-json-in-js/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-multi-entry-same-js/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/html-ts-in-html/package.json

@@ -12,4 +12,4 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   }
-}
+}

examples/js-commonjs/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/js-simple/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/plugins-nodejs-resolver-noop/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

examples/plugins-nodejs-transformer-txt/package.json

@@ -8,4 +8,4 @@
     "@alshdavid/mach": "workspace:*",
     "http-server": "*"
   }
-}
+}

mach/src/cmd/build/config.rs

@@ -108,6 +108,16 @@ pub fn parse_config(command: BuildCommand) -> Result<MachConfigSync, String> {
     vars
   };
 
+  let diagnostic_port: Option<usize> = 'block: {
+    let Ok(value) = std::env::var("MACH_DIAGNOSTIC_PORT") else {
+      break 'block None;
+    };
+    let Ok(value) = value.parse::<usize>() else {
+      break 'block None;
+    };
+    Some(value)
+  };
+
   return Ok(Arc::new(MachConfig {
     start_time,
     entry_point,
@@ -126,6 +136,7 @@ pub fn parse_config(command: BuildCommand) -> Result<MachConfigSync, String> {
     optimize: !command.no_optimize,
     env,
     debug: command.debug,
+    diagnostic_port,
   }));
 }
 

mach/src/cmd/build/main.rs

@@ -8,9 +8,11 @@ use crate::platform::config::load_plugins;
 use crate::platform::emit::emit;
 use crate::platform::packaging::package;
 use crate::platform::transformation::resolve_and_transform;
+use crate::public::programmatic::ProgrammaticReporter;
 use crate::public::AssetGraphSync;
 use crate::public::AssetMapSync;
 use crate::public::BundleGraphSync;
+use crate::public::BundleManifestSync;
 use crate::public::BundleMapSync;
 use crate::public::DependencyMapSync;
 use crate::public::OutputsSync;
@@ -28,7 +30,14 @@ pub fn main(command: BuildCommand) -> Result<(), String> {
   let asset_graph = AssetGraphSync::default();
   let bundles = BundleMapSync::default();
   let bundle_graph = BundleGraphSync::default();
+  let bundle_manifest = BundleManifestSync::default();
   let outputs = OutputsSync::default();
+  let programmatic_reporter = ProgrammaticReporter::new(
+    config.clone(),
+    asset_map.clone(),
+    bundles.clone(),
+    bundle_manifest.clone(),
+  );
   let nodejs_adapter = NodejsAdapter::new(NodejsAdapterOptions {
     workers: config.node_workers.clone() as u8,
   })?;
@@ -100,6 +109,7 @@ pub fn main(command: BuildCommand) -> Result<(), String> {
     dependency_map.clone(),
     bundles.clone(),
     bundle_graph.clone(),
+    bundle_manifest.clone(),
     outputs.clone(),
   )?;
 
@@ -112,5 +122,6 @@ pub fn main(command: BuildCommand) -> Result<(), String> {
 
   reporter.print_emit_stats();
   reporter.print_finished_stats();
+  programmatic_reporter.emit_build_report();
   Ok(())
 }

mach/src/cmd/build/reporter.rs

@@ -128,7 +128,7 @@ impl AppReporter {
     let bundles = self.bundles.read().unwrap();
     let time_bundle = self.config.time_elapsed();
     let mut bundle_kinds = HashMap::<String, usize>::new();
-    for bundle in bundles.iter() {
+    for bundle in bundles.values() {
       if !bundle_kinds.contains_key(&bundle.kind) {
         bundle_kinds.insert(bundle.kind.clone(), 0);
       }

mach/src/platform/packaging/html/package_html.rs

@@ -17,7 +17,7 @@ use crate::public::AssetGraphSync;
 use crate::public::AssetMapSync;
 use crate::public::Bundle;
 use crate::public::BundleGraphSync;
-use crate::public::BundleManifest;
+use crate::public::BundleManifestSync;
 use crate::public::BundleMapSync;
 use crate::public::DependencyMapSync;
 use crate::public::Output;
@@ -31,13 +31,14 @@ pub fn package_html(
   bundle_graph: BundleGraphSync,
   outputs: Arc<RwLock<Outputs>>,
   bundle: Bundle,
-  bundle_manifest: &BundleManifest,
+  bundle_manifest: BundleManifestSync,
   js_runtime_factory: Arc<RuntimeFactory>,
 ) {
   let asset_graph = asset_graph.read().unwrap();
   let dependency_map = dependency_map.read().unwrap();
   let bundle_map = bundle_map.read().unwrap();
   let bundle_graph = bundle_graph.read().unwrap();
+  let bundle_manifest = bundle_manifest.read().unwrap();
 
   let entry_asset = bundle.entry_asset.as_ref().unwrap();
   let Some(dependencies) = asset_graph.get_dependencies(&entry_asset) else {
@@ -131,7 +132,7 @@ pub fn package_html(
 
     let bundle_id = bundle_graph.get(&dependency.id).unwrap();
     let bundle_hash = bundle_map
-      .iter()
+      .values()
       .find(|b| &b.id == bundle_id)
       .unwrap()
       .content_hash();
@@ -148,7 +149,7 @@ pub fn package_html(
     html::set_attribute(script_node, "src", file_path);
   }
 
-  for bundle in bundle_map.iter() {
+  for bundle in bundle_map.values() {
     if bundle.kind == "css" {
       let elm = html::create_element(html::CreateElementOptions {
         tag_name: "link",

mach/src/platform/packaging/javascript/package_javascript.rs

@@ -22,7 +22,7 @@ use crate::public::AssetId;
 use crate::public::AssetMapSync;
 use crate::public::Bundle;
 use crate::public::BundleGraphSync;
-use crate::public::BundleManifest;
+use crate::public::BundleManifestSync;
 use crate::public::BundleMapSync;
 use crate::public::DependencyMapSync;
 use crate::public::MachConfigSync;
@@ -39,9 +39,10 @@ pub fn package_javascript<'a>(
   outputs: Arc<RwLock<Outputs>>,
   runtime_factory: Arc<RuntimeFactory>,
   bundle: Bundle,
-  bundle_manifest: Arc<BundleManifest>,
+  bundle_manifest: BundleManifestSync,
 ) {
   let bundle_map = bundle_map.read().unwrap();
+  let bundle_manifest = bundle_manifest.read().unwrap();
   let bundle_graph = bundle_graph.read().unwrap();
   let source_map = Arc::new(SourceMap::default());
 

mach/src/platform/packaging/package.rs

@@ -10,7 +10,7 @@ use super::javascript::runtime_factory::RuntimeFactory;
 use crate::public::AssetGraphSync;
 use crate::public::AssetMapSync;
 use crate::public::BundleGraphSync;
-use crate::public::BundleManifest;
+use crate::public::BundleManifestSync;
 use crate::public::BundleMapSync;
 use crate::public::DependencyMapSync;
 use crate::public::MachConfigSync;
@@ -24,22 +24,22 @@ pub fn package(
   dependency_map: DependencyMapSync,
   bundle_map: BundleMapSync,
   bundle_graph: BundleGraphSync,
+  bundle_manifest: BundleManifestSync,
   outputs: OutputsSync,
 ) -> Result<(), String> {
   let asset_map = asset_map;
   let source_map = Arc::new(SourceMap::default());
-  let runtime_factory = Arc::new(RuntimeFactory::new(source_map.clone()));
+  let js_runtime_factory = Arc::new(RuntimeFactory::new(source_map.clone()));
 
-  let bundle_manifest = {
-    let mut bundle_manifest = BundleManifest::new();
+  {
+    let mut bundle_manifest = bundle_manifest.write().unwrap();
 
-    for bundle in bundle_map.read().unwrap().iter() {
+    for bundle in bundle_map.read().unwrap().values() {
       bundle_manifest.insert(bundle.content_hash(), bundle.name.clone());
     }
-    Arc::new(bundle_manifest)
   };
 
-  for bundle in bundle_map.read().unwrap().iter() {
+  for bundle in bundle_map.read().unwrap().values() {
     let bundle = bundle.clone();
     let bundle_manifest = bundle_manifest.clone();
 
@@ -52,7 +52,7 @@ pub fn package(
         bundle_map.clone(),
         bundle_graph.clone(),
         outputs.clone(),
-        runtime_factory.clone(),
+        js_runtime_factory.clone(),
         bundle,
         bundle_manifest,
       );
@@ -67,8 +67,8 @@ pub fn package(
         bundle_graph.clone(),
         outputs.clone(),
         bundle,
-        &bundle_manifest,
-        runtime_factory.clone(),
+        bundle_manifest,
+        js_runtime_factory.clone(),
       );
     }
   }

mach/src/public/bundle_manifest.rs

@@ -1,3 +1,6 @@
 use std::collections::HashMap;
+use std::sync::Arc;
+use std::sync::RwLock;
 
+pub type BundleManifestSync = Arc<RwLock<HashMap<String, String>>>;
 pub type BundleManifest = HashMap<String, String>;

mach/src/public/bundle_map.rs

@@ -1,3 +1,4 @@
+use std::collections::hash_map::Iter;
 use std::collections::hash_map::Values;
 use std::collections::HashMap;
 use std::sync::Arc;
@@ -21,10 +22,14 @@ impl BundleMap {
     self.bundles.insert(bundle.id.clone(), bundle);
   }
 
-  pub fn iter(&self) -> Values<'_, BundleId, Bundle> {
+  pub fn values(&self) -> Values<'_, BundleId, Bundle> {
     self.bundles.values()
   }
 
+  pub fn iter(&self) -> Iter<'_, BundleId, Bundle> {
+    self.bundles.iter()
+  }
+
   pub fn len(&self) -> usize {
     self.bundles.len()
   }

mach/src/public/config.rs

@@ -30,6 +30,7 @@ pub struct MachConfig {
   pub bundle_splitting: bool,
   pub env: HashMap<String, String>,
   pub debug: bool,
+  pub diagnostic_port: Option<usize>,
 }
 
 impl MachConfig {

mach/src/public/mod.rs

@@ -23,6 +23,7 @@ mod mutable_asset;
 pub mod nodejs;
 mod package_json;
 mod packages;
+pub mod programmatic;
 mod resolver;
 mod specifier_type;
 mod transformer;

mach/src/public/programmatic/action.rs

@@ -0,0 +1,10 @@
+use serde::Deserialize;
+use serde::Serialize;
+
+use super::BuildReport;
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub enum ProgrammaticAction {
+  BuildReport { data: BuildReport },
+}

mach/src/public/programmatic/build_report.rs

@@ -0,0 +1,11 @@
+use std::collections::HashMap;
+
+use serde::Deserialize;
+use serde::Serialize;
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct BuildReport {
+  pub bundle_manifest: HashMap<String, String>,
+  pub entries: HashMap<String, String>,
+}

mach/src/public/programmatic/mod.rs

@@ -0,0 +1,7 @@
+mod action;
+mod build_report;
+mod programmatic_reporter;
+
+pub use self::action::*;
+pub use self::build_report::*;
+pub use self::programmatic_reporter::*;