feat: introduce source code maps (#88)

Co-authored-by: Claude <[email protected]>

Author: cakevm

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 # Huff Neo Compiler changelog
 
+## Unreleased
+
+## [1.3.1] - 2025-08-14
+- Add constructor and runtime source maps in Artifact structure.
+- Remove UUID field from FileSource struct for better WASM compatibility.
+- Fix span end to be inclusive at the end.
+
 ## [1.3.0] - 2025-08-12
 - Update rust to 1.89 and dependencies to the latest version.
 - **Breaking**: Implement proper label scoping to prevent label overwriting in macro invocations. (fixes #82)

Cargo.lock

@@ -11,7 +11,7 @@ license = "MIT OR Apache-2.0"
 readme = "README.md"
 repository = "https://github.com/cakevm/huff-neo"
 rust-version = "1.89"
-version = "1.3.0"
+version = "1.3.1"
 
 [workspace.dependencies]
 huff-neo-codegen = { path = "crates/codegen" }
@@ -38,7 +38,6 @@ thiserror = "2.0.14"
 tokio = "1.47.1"
 tracing = "0.1.41"
 tracing-subscriber = { version = "0.3.19", default-features = false, features = ["env-filter", "fmt"] }
-uuid = { version = "1.18.0", default-features = false, features = ["js", "v4"] }
 walkdir = "2.5.0"
 wasm-bindgen = "0.2.100"
 yansi = "1.0.1"
@@ -71,7 +70,6 @@ toml = { version = "0.8.23", default-features = false, features = ["parse"] }
 
 # dev
 criterion = "0.6.0"
-getrandom = { version = "0.3.3", features = ["wasm_js"] }
 rayon = "1.10.0"
 
 [profile.test]

Cargo.toml

@@ -55,6 +55,10 @@ doc:
 	RUSTDOCFLAGS="--show-type-layout --generate-link-to-definition --enable-index-page -D warnings -Z unstable-options" \
 	cargo +nightly doc --workspace --all-features --no-deps --document-private-items
 
+.PHONY: udeps
+udeps:
+	cargo install cargo-machete --locked && cargo-machete --with-metadata
+
 .PHONY: pre-release
 pre-release:
 	mdbook test

Makefile

@@ -29,7 +29,6 @@ serde.workspace = true
 shadow-rs.workspace = true
 tokio.workspace = true
 tracing.workspace = true
-uuid.workspace = true
 yansi.workspace = true
 
 [build-dependencies]

bin/hnc/Cargo.toml

@@ -295,13 +295,7 @@ fn main() {
                     .map(|s| Span {
                         start: 0,
                         end: 0,
-                        file: Some(Arc::new(FileSource {
-                            id: uuid::Uuid::new_v4(),
-                            path: s.clone(),
-                            source: None,
-                            access: None,
-                            dependencies: vec![],
-                        })),
+                        file: Some(Arc::new(FileSource { path: s.clone(), source: None, access: None, dependencies: vec![] })),
                     })
                     .collect::<Vec<Span>>(),
             ),

bin/hnc/src/main.rs

@@ -20,4 +20,3 @@ indexmap.workspace = true
 regex.workspace = true
 serde_json.workspace = true
 tracing.workspace = true
-uuid.workspace = true

crates/codegen/Cargo.toml

@@ -40,7 +40,7 @@ fn example() {
     let main_bytecode = "5f3560e01c8063a9059cbb1461004757806340c10f19146100d757806370a082311461014157806318160ddd1461015c578063095ea7b314610166578063dd62ed3e1461017d575b600435336024358160016000526000602001526040600020548082116100d3578190038260016000526000602001526040600020558281906001600052600060200152604060002054018360016000526000602001526040600020555f527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60205fa360015f5260205ff35b5f5ffd5b5f5433146100e3575f5ffd5b6004355f60243582819060016000526000602001526040600020540183600160005260006020015260406000205580600254016002555f527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60205fa35b60043560016000526000602001526040600020545f5260205ff35b6002545f5260205ff35b602435600435336000526000602001526040600020555b6024356004356000526000602001526040600020545f5260205ff3";
     let constructor_bytecode = "335f55";
     let inputs = vec![];
-    let churn_res = cg.churn(Arc::new(FileSource::default()), inputs, main_bytecode, constructor_bytecode, false);
+    let churn_res = cg.churn(Arc::new(FileSource::default()), inputs, main_bytecode, constructor_bytecode, false, None, None);
 
     // Validate the output bytecode
     assert_eq!(churn_res.unwrap().bytecode, "335f5561019980600d3d393df35f3560e01c8063a9059cbb1461004757806340c10f19146100d757806370a082311461014157806318160ddd1461015c578063095ea7b314610166578063dd62ed3e1461017d575b600435336024358160016000526000602001526040600020548082116100d3578190038260016000526000602001526040600020558281906001600052600060200152604060002054018360016000526000602001526040600020555f527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60205fa360015f5260205ff35b5f5ffd5b5f5433146100e3575f5ffd5b6004355f60243582819060016000526000602001526040600020540183600160005260006020015260406000205580600254016002555f527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60205fa35b60043560016000526000602001526040600020545f5260205ff35b6002545f5260205ff35b602435600435336000526000602001526040600020555b6024356004356000526000602001526040600020545f5260205ff3".to_lowercase());