feat: fix Go component WIT world limitations and add TinyGo documentation

- Fixed GO111MODULE=on for proper Go module resolution in TinyGo compilation
- Integrated wit-bindgen-go tool installation in TinyGo toolchain setup
- Added calculator_simple_binding.go example demonstrating WIT interface usage
- Updated WIT file path resolution to preserve original filenames
- Created GitHub issue #80 documenting TinyGo WIT world limitations
- Applied pre-commit formatting fixes across codebase
- Identified TinyGo PR #4934 as upstream solution for custom WIT worlds

Key technical changes:
- go/defs.bzl: Changed GO111MODULE from "off" to "on"
- toolchains/tinygo_toolchain.bzl: Added wit-bindgen-go installation
- tools/bazel_helpers/file_ops_actions.bzl: Fixed WIT file copying
- examples/go_component/: Added simple WIT binding example

Root cause: TinyGo hardcodes wasi:cli/command world, ignoring custom WIT interfaces.
Solution pending: TinyGo PR #4934 will add custom WIT world support.

Author: avrabe

MODULE.bazel.lock

@@ -175,6 +175,7 @@ def _cpp_component_impl(ctx):
     # Standard library control
     if ctx.attr.nostdlib:
         compile_args.add("-nostdlib")
+
         # When using nostdlib, we need to be more selective about what we link
         compile_args.add("-Wl,--no-entry")  # Don't expect a main function
 
@@ -290,7 +291,7 @@ def _cpp_component_impl(ctx):
     else:
         binding_compile_args.add("-O0")
         binding_compile_args.add("-g")
-    
+
     # Exception handling for binding compilation (if C++ exceptions are enabled)
     if ctx.attr.language == "cpp" and ctx.attr.enable_exceptions:
         binding_compile_args.add("-fexceptions")
@@ -325,7 +326,7 @@ def _cpp_component_impl(ctx):
     if ctx.attr.language == "cpp" and not ctx.attr.nostdlib:
         compile_args.add("-lc++")
         compile_args.add("-lc++abi")
-        
+
         # Add exception handling support if enabled
         # Note: Exception handling symbols are typically in libc++abi which we already link
 
@@ -385,7 +386,7 @@ def _cpp_component_impl(ctx):
                 "$1" validate --features component-model "$2" >> "$3" 2>&1
                 exit 1
             fi
-            
+
             # Extract WIT interface for documentation
             echo "=== COMPONENT VALIDATION PASSED ===" > "$3"
             echo "Component is valid WebAssembly with component model" >> "$3"
@@ -397,7 +398,7 @@ def _cpp_component_impl(ctx):
             inputs = [component_wasm],
             outputs = [validation_log],
             tools = [wasm_tools],
-            mnemonic = "ValidateWasmComponent", 
+            mnemonic = "ValidateWasmComponent",
             progress_message = "Validating WebAssembly component for %s" % ctx.label,
         )
 

cpp/defs.bzl

@@ -36,7 +36,7 @@ wit_bindgen(
 
 # Enhanced wit-bindgen with advanced features
 wit_bindgen(
-    name = "advanced_bindings", 
+    name = "advanced_bindings",
     language = "rust",
     wit = ":api_interfaces",
     ownership = "borrowing",                        # Memory optimization
@@ -54,12 +54,12 @@ The example demonstrates different interface mapping strategies:
 wit_bindgen(
     name = "wasi_mapped_bindings",
     language = "rust",
-    wit = ":wasi_demo_interfaces", 
+    wit = ":wasi_demo_interfaces",
     with_mappings = {
         # Map WASI interfaces to existing ecosystem crates
         "wasi:io/streams": "wasi::io::streams",
         "wasi:io/poll": "wasi::io::poll",
-        
+
         # Generate custom interfaces fresh
         "example:wasi-demo/file-processor": "generate",
     },
@@ -88,7 +88,7 @@ wit_bindgen(
 **Development-Friendly Service:**
 ```starlark
 wit_bindgen(
-    name = "service_bindings", 
+    name = "service_bindings",
     ownership = "borrowing-duplicate-if-necessary",  # Balanced approach
     additional_derives = ["Clone", "Debug", "PartialEq"],  # Full debugging
     format_code = True,
@@ -168,19 +168,19 @@ package example:[email protected];
 world wasi-demo {
     import wasi:io/[email protected];
     import wasi:io/[email protected];
-    
+
     export file-processor;
 }
 
 interface file-processor {
     use wasi:io/streams.{input-stream, output-stream};
     use wasi:io/poll.{pollable};
-    
+
     process-stream: func(
         input: borrow<input-stream>,
         output: borrow<output-stream>
     ) -> result<u64, string>;
-    
+
     wait-for-ready: func(pollable: borrow<pollable>) -> bool;
     get-processor-version: func() -> string;
 }
@@ -256,10 +256,10 @@ fn test_custom_derives_available() {
 
     // Test Clone derive
     let config2 = config1.clone();
-    
+
     // Test PartialEq derive
     assert_eq!(config1, config2);
-    
+
     // Test Debug derive
     let debug_output = format!("{:?}", config1);
     assert!(debug_output.contains("ApiConfig"));
@@ -280,7 +280,7 @@ fn test_borrowing_ownership() {
 
     // This should work with borrowing ownership model
     let _connection = Connection::new(&config);
-    
+
     // We can still use config after borrowing it
     assert_eq!(config.endpoint, "test");
 }
@@ -433,7 +433,7 @@ wit_bindgen(
     name = "existing_bindings",
     language = "rust",
     wit = ":existing_interfaces",
-    
+
     # Add basic debugging support
     additional_derives = ["Debug"],
     format_code = True,
@@ -447,7 +447,7 @@ wit_bindgen(
     name = "optimized_bindings",
     language = "rust",
     wit = ":interfaces",
-    
+
     # Add performance optimization
     ownership = "borrowing-duplicate-if-necessary",
     additional_derives = ["Debug", "Clone"],
@@ -462,7 +462,7 @@ wit_bindgen(
     name = "mapped_bindings",
     language = "rust",
     wit = ":interfaces",
-    
+
     with_mappings = {
         "wasi:io/streams": "wasi::io::streams",  # Start with one mapping
         "my:custom/api": "generate",
@@ -480,4 +480,4 @@ This comprehensive example demonstrates how the enhanced `wit_bindgen` rule enab
 
 - **[WIT Bindgen Interface Mapping](/guides/wit-bindgen-interface-mapping)**: Detailed guide on interface mapping concepts and strategies
 - **[WIT Bindgen Advanced Concepts](/guides/wit-bindgen-advanced-concepts)**: Language-specific implications and architectural patterns
-- **[WIT Bindgen Troubleshooting](/guides/wit-bindgen-troubleshooting)**: Common issues and debugging techniques
+- **[WIT Bindgen Troubleshooting](/guides/wit-bindgen-troubleshooting)**: Common issues and debugging techniques