fix: correct Rust rule names throughout documentation

Resolves #23 - Critical documentation inconsistency where all tutorials
and examples used the wrong rule name.

## Changes Made
- **All tutorial/example docs**: `rust_wasm_component` → `rust_wasm_component_bindgen`
- **Load statements**: Updated to import correct rule
- **BUILD examples**: Updated to use high-level rule with automatic WIT binding generation
- **Attribute cleanup**: Removed deprecated attributes, use `profiles` for optimization

## Files Updated
- getting-started.mdx: Fixed main onboarding example
- first-component.md: Fixed step-by-step tutorial
- index.mdx: Fixed homepage examples
- examples/basic.md: Fixed basic example documentation
- workflow/development-flow.mdx: Fixed workflow examples
- composition/wac.md: Fixed composition examples
- guides/external-wit-dependencies.mdx: Fixed dependency examples
- languages/rust.md: Fixed Rust language guide
- docs-site/BUILD.bazel: Fixed embedded examples
- examples/using_external_wit_BUILD_example: Fixed example BUILD file

## Rule Clarification
- `rust_wasm_component_bindgen`: High-level rule with automatic WIT binding generation (recommended for users)
- `rust_wasm_component`: Lower-level rule requiring manual bindings (documented in reference/rules.mdx)

All user-facing documentation now uses the correct high-level rule that matches working examples.

Author: avrabe

docs-site/BUILD.bazel

@@ -127,9 +127,9 @@ genrule(
     <div class="feature">
         <h3>📦 Quick Start Example</h3>
         <div class="example">
-<pre><code>load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+<pre><code>load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "hello_component",
     srcs = ["src/lib.rs"],
     wit = "component.wit",

docs-site/src/content/docs/composition/wac.md

@@ -39,7 +39,7 @@ Let's start with a simple example to understand the fundamentals of component co
 
 ```python title="BUILD.bazel"
 load("@rules_wasm_component//wac:defs.bzl", "wac_compose")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 load("@rules_wasm_component//wit:defs.bzl", "wit_library")
 
 # Frontend component
@@ -49,11 +49,10 @@ wit_library(
     package_name = "frontend:[email protected]",
 )
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "frontend_component",
     srcs = ["src/frontend.rs"],
     wit = ":frontend_interfaces",
-    deps = ["@crates//:wit-bindgen"],
 )
 
 # Backend component
@@ -63,11 +62,10 @@ wit_library(
     package_name = "backend:[email protected]",
 )
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "backend_component",
     srcs = ["src/backend.rs"],
     wit = ":backend_interfaces",
-    deps = ["@crates//:wit-bindgen"],
 )
 
 # Compose them together

docs-site/src/content/docs/examples/basic.md

@@ -62,7 +62,7 @@ Think of this as defining a microservice API, but one that works across any lang
 
 ```python title="BUILD.bazel"
 load("@rules_wasm_component//wit:defs.bzl", "wit_library")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
 # Define WIT library target
 wit_library(
@@ -72,13 +72,10 @@ wit_library(
 )
 
 # Build Rust WebAssembly component
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "basic_component",
     srcs = ["src/lib.rs"],
     wit = ":hello_interfaces",
-    deps = [
-        "@crates//:wit-bindgen",
-    ],
 )
 
 # Test the component
@@ -91,7 +88,7 @@ rust_wasm_component_test(
 **What each target does:**
 
 - **`wit_library`** - Processes your WIT file and validates the interface
-- **`rust_wasm_component`** - Compiles your Rust code into a WebAssembly component
+- **`rust_wasm_component_bindgen`** - Compiles your Rust code into a WebAssembly component
 - **`rust_wasm_component_test`** - Creates tests for your component
 
 The build system handles all the complexity: downloading toolchains, generating bindings, compiling to WebAssembly, and packaging as a component.

docs-site/src/content/docs/first-component.md

@@ -118,7 +118,7 @@ Set up your `BUILD.bazel`:
 
 ```python title="BUILD.bazel"
 load("@rules_wasm_component//wit:defs.bzl", "wit_library")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component", "rust_wasm_component_test")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen", "rust_wasm_component_test")
 
 # WIT interface library
 wit_library(
@@ -128,13 +128,10 @@ wit_library(
 )
 
 # Rust WebAssembly component
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "greeting_component",
     srcs = ["src/lib.rs"],
     wit = ":greeting_interfaces",
-    deps = [
-        "@crates//:wit-bindgen",
-    ],
 )
 
 # Component test

docs-site/src/content/docs/getting-started.mdx

@@ -108,7 +108,7 @@ This defines a "world" (think of it as an API) with one function: `greet` that t
 
 <CodeFromFile file="examples/basic/BUILD.bazel" title="examples/basic/BUILD.bazel" />
 
-The `wit_library` creates the interface definitions, and `rust_wasm_component` compiles your Rust code into a WebAssembly component that implements that interface.
+The `wit_library` creates the interface definitions, and `rust_wasm_component_bindgen` compiles your Rust code into a WebAssembly component that implements that interface.
 
 ### 3. Implement the Component
 

docs-site/src/content/docs/guides/external-wit-dependencies.mdx

@@ -775,7 +775,7 @@ Reference external dependencies in your build targets:
 
 ```starlark title="BUILD.bazel"
 load("@rules_wasm_component//wit:defs.bzl", "wit_library", "wit_markdown")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
 # WIT library with external dependencies
 wit_library(
@@ -797,10 +797,9 @@ wit_markdown(
 )
 
 # Build component with all dependencies resolved
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "my_service",
     srcs = ["src/lib.rs"],
-    world = "my-service-world",
     wit = ":my_service_wit",
 )
 ```

docs-site/src/content/docs/index.mdx

@@ -47,7 +47,7 @@ The **WebAssembly Component Model** is a revolutionary approach to building port
 Building WebAssembly components traditionally involves complex toolchains and manual configuration. **rules_wasm_component** makes it as easy as:
 
 ```python
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "my_service",
     srcs = ["src/lib.rs"],
     wit = ":my_interfaces",
@@ -103,15 +103,15 @@ Create your first WebAssembly component in just a few steps:
 
 ```python title="BUILD.bazel"
 load("@rules_wasm_component//wit:defs.bzl", "wit_library")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
 wit_library(
     name = "hello_interfaces",
     srcs = ["hello.wit"],
     package_name = "hello:[email protected]",
 )
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "hello_component",
     srcs = ["src/lib.rs"],
     wit = ":hello_interfaces",

docs-site/src/content/docs/languages/rust.md

@@ -55,22 +55,18 @@ world calculator {
 
 ```python title="BUILD.bazel"
 load("@rules_wasm_component//wit:defs.bzl", "wit_library")
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
 wit_library(
     name = "calculator_interfaces",
     srcs = ["wit/calculator.wit"],
     package_name = "calculator:[email protected]",
 )
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "calculator_component",
     srcs = ["src/lib.rs"],
     wit = ":calculator_interfaces",
-    deps = [
-        "@crates//:wit-bindgen",
-        "@crates//:anyhow",  # For error handling
-    ],
     # Multiple build profiles
     profiles = ["debug", "release"],
 )
@@ -238,15 +234,11 @@ bazel build //:calculator_component_release
 ### Custom Profile
 
 ```python title="BUILD.bazel"
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "calculator_optimized",
     srcs = ["src/lib.rs"],
     wit = ":calculator_interfaces",
-    rustc_flags = [
-        "-C", "opt-level=3",
-        "-C", "lto=fat",
-        "-C", "codegen-units=1",
-    ],
+    profiles = ["release"],  # Use release profile for optimization
 )
 ```
 
@@ -371,7 +363,7 @@ calculator_component_bindings::export!(Calculator with_types_in calculator_compo
 
 ```bash
 # Check available profiles
-bazel query 'kind(rust_wasm_component, //...)'
+bazel query 'kind(rust_wasm_component_bindgen, //...)'
 ```
 
 <div class="demo-buttons">

docs-site/src/content/docs/workflow/development-flow.mdx

@@ -139,16 +139,11 @@ bazel build //examples/wizer_example:optimized_component
 ### Build Optimizations
 
 ```python
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "optimized_component",
     srcs = ["lib.rs"],
     wit = ":interfaces",
-    # Release optimizations
-    compilation_mode = "opt",
-    # Link-time optimization
-    rustc_flags = ["-C", "lto=fat"],
-    # Size optimization
-    wasm_opt = True,
+    profiles = ["release"],  # Release optimizations
 )
 ```
 

examples/using_external_wit_BUILD_example

@@ -21,11 +21,10 @@ wit_markdown(
 )
 
 # Use in your actual component build
-load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component")
+load("@rules_wasm_component//rust:defs.bzl", "rust_wasm_component_bindgen")
 
-rust_wasm_component(
+rust_wasm_component_bindgen(
     name = "my_component",
     srcs = ["src/lib.rs"],
-    world = "my-component-world",
     wit = ":my_component_wit",  # All dependencies automatically included
 )