fix: resolve WAC composition syntax and enhance multi-file packaging examples

This commit addresses several important fixes and improvements:

## WAC Composition Fix
- Correct WAC composition syntax in integration tests from `storage: service-a`
  to `storage: service-a.storage` for proper interface member access
- Add ellipsis syntax (`...`) to auto-wire remaining WASI imports
- Resolves issue #20 where WAC composition was failing due to incorrect
  interface resolution syntax

## Multi-File Packaging Enhancements
- Expand multi-file packaging examples with comprehensive demonstrations
- Add simple test components for embedded, layered, and bundled approaches
- Implement proper file grouping and asset management with Bazel Skylib
- Use write_file rules for cross-platform compatibility instead of shell commands
- Add extensive documentation files (README, API docs, deployment guide)
- Improve genrule syntax to use tar transform for directory structure

## Rust Component Infrastructure
- Enhance rust_wasm_component_bindgen to expose native-guest bindings publicly
- Fix component rule implementation for better provider forwarding
- Improve documentation and code organization

## Documentation Updates
- Fix docs-site BUILD dependencies and structure
- Add comprehensive examples for different packaging strategies
- Provide clear guidance on component deployment and usage

These changes ensure WAC composition works correctly with the forked interface
resolution fixes and provide production-ready examples for multi-file component
packaging across different deployment strategies.

Author: avrabe

docs-site/BUILD.bazel

@@ -7,6 +7,7 @@ This BUILD file demonstrates the same hermetic approach used for JavaScript comp
 """
 
 load("@bazel_skylib//rules:build_test.bzl", "build_test")
+load("@bazel_skylib//rules:copy_file.bzl", "copy_file")
 load(":docs_build.bzl", "docs_build")
 
 package(default_visibility = ["//visibility:public"])
@@ -205,19 +206,11 @@ test_suite(
     ],
 )
 
-# Production deployment bundle with full Astro site
-genrule(
+# Production deployment bundle with full Astro site - using Bazel Skylib copy_file for cross-platform compatibility
+copy_file(
     name = "deployment_bundle",
-    srcs = [
-        ":docs_site",
-        ":docs_validation",
-    ],
-    outs = ["docs_deployment.tar.gz"],
-    cmd = """
-    # The docs_site is already a tar.gz archive, so just copy it
-    cp $(location :docs_site) $@
-    """,
-    message = "Creating production documentation deployment bundle",
+    src = ":docs_site",
+    out = "docs_deployment.tar.gz",
 )
 
 # Fallback deployment (for testing without full toolchain)
@@ -229,9 +222,8 @@ genrule(
     ],
     outs = ["docs_fallback.tar.gz"],
     cmd = """
-    mkdir -p fallback_dist
-    cp $(location :placeholder_fallback) fallback_dist/index.html
-    tar -czf $@ fallback_dist/
+    # Create tar directly with transform to add directory prefix
+    tar -czf $@ --transform 's|^|fallback_dist/|' --transform 's|.*placeholder_fallback|fallback_dist/index.html|' $(location :placeholder_fallback)
     """,
     message = "Creating fallback documentation deployment",
 )