docs: enhance documentation with custom logo and comprehensive rule reference

This commit significantly improves the project documentation with:

## New Custom Logo
- Replace generic Houston mascot with custom 3D LEGO-style logo
- Features 30+ colorful blocks representing different programming languages
- Dynamic 3D space composition with realistic shadows and effects
- Represents WebAssembly Component Model's modularity and composition
- Languages include: Rust, Go, JavaScript, C++, Python, Zig, Swift, C#, Java,
  AssemblyScript, Dart, OCaml, Haskell, Elixir, Kotlin, and more
- Cosmic atmosphere with energy trails showing component connections

## Documentation Structure Improvements
- Separate OCI Publishing from OCI Signing for clear distinction
- Add new RPC & Communication category for WRPC rules
- Restructure examples into Basic/Intermediate/Advanced categories
- Add comprehensive troubleshooting section
- New migration guides and multi-profile build documentation

## Rule Reference Enhancements
- Complete rule categorization by language and functionality
- Add missing npm_install rule documentation
- Update go_wit_bindgen as deprecated compatibility stub
- Include new WRPC rules: wrpc_bindgen, wrpc_serve, wrpc_invoke
- Auto-generated documentation now covers 30+ rules and providers

## Content Quality
- Fix documentation inconsistencies across all pages
- Update load statement references throughout examples
- Improve code formatting and remove trailing whitespace
- Add proper navigation structure to Astro configuration

The documentation now provides a comprehensive, well-organized reference
for all WebAssembly Component Model development with rules_wasm_component.

Author: avrabe

MODULE.bazel.lock

@@ -16,7 +16,7 @@ def _load_tool_checksums(tool_name):
 
     Returns:
         Dict: Tool data from embedded registry, or empty dict if not found
-        
+
     Note:
         This function uses embedded data rather than JSON file loading because
         Bazel rules don't have built-in JSON parsing capabilities. The embedded

checksums/registry.bzl

@@ -1,10 +1,16 @@
 """Unit tests for the checksum registry API"""
 
 load("@bazel_skylib//lib:unittest.bzl", "asserts", "unittest")
-load("//checksums:registry.bzl", 
-     "get_tool_checksum", "get_tool_info", "get_latest_version", 
-     "list_supported_platforms", "get_github_repo", "validate_tool_exists",
-     "list_available_tools")
+load(
+    "//checksums:registry.bzl",
+    "get_github_repo",
+    "get_latest_version",
+    "get_tool_checksum",
+    "get_tool_info",
+    "list_available_tools",
+    "list_supported_platforms",
+    "validate_tool_exists",
+)
 
 def _test_get_tool_checksum(ctx):
     """Test get_tool_checksum function"""
@@ -145,4 +151,4 @@ def registry_test_suite(name):
         get_github_repo_test,
         validate_tool_exists_test,
         list_available_tools_test,
-    )
+    )

checksums/registry_test.bzl

@@ -5,7 +5,7 @@
   "last_checked": "2025-08-18T00:00:00.000000Z",
   "supported_platforms": [
     "darwin_amd64",
-    "darwin_arm64", 
+    "darwin_arm64",
     "linux_amd64",
     "linux_arm64",
     "windows_amd64"
@@ -42,4 +42,4 @@
       }
     }
   }
-}
+}

checksums/tools/wizer.json

@@ -80,14 +80,19 @@ export default defineConfig({
 					label: 'Guides',
 					items: [
 						{ label: 'Advanced Features', slug: 'guides/advanced-features' },
+						{ label: 'Migration Guide', slug: 'guides/migration' },
 						{ label: 'Toolchain Configuration', slug: 'guides/toolchain-configuration' },
+						{ label: 'Multi-Profile Builds', slug: 'guides/multi-profile-builds' },
 						{ label: 'External WIT Dependencies', slug: 'guides/external-wit-dependencies' },
 					],
 				},
 				{
 					label: 'Examples',
 					items: [
 						{ label: 'Basic Component', slug: 'examples/basic' },
+						{ label: 'Basic Examples', slug: 'examples/basic-examples' },
+						{ label: 'Intermediate Examples', slug: 'examples/intermediate-examples' },
+						{ label: 'Advanced Examples', slug: 'examples/advanced-examples' },
 						{ label: 'Calculator (C++)', slug: 'examples/calculator' },
 						{ label: 'HTTP Service (Go)', slug: 'examples/http-service' },
 						{ label: 'Multi-Language System', slug: 'examples/multi-language' },
@@ -104,6 +109,7 @@ export default defineConfig({
 					label: 'Security',
 					items: [
 						{ label: 'Component Signing', slug: 'security/component-signing' },
+						{ label: 'OCI Component Signing', slug: 'security/oci-signing' },
 					],
 				},
 				{
@@ -114,6 +120,12 @@ export default defineConfig({
 						{ label: 'Performance Optimization', slug: 'production/performance' },
 					],
 				},
+				{
+					label: 'Troubleshooting',
+					items: [
+						{ label: 'Export Macro Visibility', slug: 'troubleshooting/export-macro-visibility' },
+					],
+				},
 				{
 					label: 'Reference',
 					items: [

docs-site/astro.config.mjs

@@ -15,7 +15,6 @@ def _docs_build_impl(ctx):
     source_files = ctx.files.srcs
     package_json = ctx.file.package_json
 
-
     # Prepare input files list
     input_file_args = []
     for src in source_files:
@@ -25,7 +24,7 @@ def _docs_build_impl(ctx):
     ctx.actions.run_shell(
         command = """
         set -euo pipefail
-        
+
         # Store execution root and output path
         EXEC_ROOT="$(pwd)"
         OUTPUT_TAR="$1"
@@ -42,7 +41,7 @@ def _docs_build_impl(ctx):
         # Copy all source files, maintaining docs-site structure
         for src_file in "$@"; do
             if [[ "$src_file" == docs-site/* ]]; then
-                # Remove docs-site/ prefix to get relative path  
+                # Remove docs-site/ prefix to get relative path
                 rel_path="${src_file#docs-site/}"
                 dest_file="$WORK_DIR/$rel_path"
                 dest_dir="$(dirname "$dest_file")"
@@ -103,10 +102,10 @@ docs_build = rule(
     toolchains = ["@rules_wasm_component//toolchains:jco_toolchain_type"],
     doc = """
     Builds documentation site using hermetic Node.js and npm from jco_toolchain.
-    
-    This rule follows the Bazel Way by properly using toolchains instead of 
+
+    This rule follows the Bazel Way by properly using toolchains instead of
     direct file references in genrules.
-    
+
     Example:
         docs_build(
             name = "site",

docs-site/docs_build.bzl

@@ -2,25 +2,25 @@
 
 def _docs_dev_server_impl(ctx):
     """Implementation of docs_dev_server rule for local development"""
-    
-    # Get jco toolchain for hermetic Node.js access  
+
+    # Get jco toolchain for hermetic Node.js access
     jco_toolchain = ctx.toolchains["@rules_wasm_component//toolchains:jco_toolchain_type"]
     node = jco_toolchain.node
     npm = jco_toolchain.npm
-    
+
     # Create runner script
     runner = ctx.actions.declare_file(ctx.attr.name + "_runner.sh")
-    
+
     # Input source files and package.json
     source_files = ctx.files.srcs
     package_json = ctx.file.package_json
-    
+
     # Prepare source file list
     source_paths = []
     for src in source_files:
         if src.path.startswith("docs-site/"):
             source_paths.append(src.path)
-    
+
     ctx.actions.write(
         output = runner,
         content = """#!/bin/bash
@@ -68,18 +68,18 @@ $NPM run dev
             npm = npm.path,
             copy_commands = "\n".join([
                 'if [[ "{src}" == docs-site/* ]]; then\n' +
-                '    rel_path="${{src#docs-site/}}"\n'.format(src=src) +
+                '    rel_path="${{src#docs-site/}}"\n'.format(src = src) +
                 '    dest_file="$WORK_DIR/$rel_path"\n' +
                 '    dest_dir="$(dirname "$dest_file")"\n' +
                 '    mkdir -p "$dest_dir"\n' +
-                '    cp "{src}" "$dest_file"\n'.format(src=src) +
-                'fi'
+                '    cp "{src}" "$dest_file"\n'.format(src = src) +
+                "fi"
                 for src in source_paths
-            ])
+            ]),
         ),
         is_executable = True,
     )
-    
+
     return [
         DefaultInfo(
             files = depset([runner]),
@@ -108,18 +108,18 @@ docs_dev_server = rule(
     executable = True,
     doc = """
     Runs a development server for the documentation site with live reload.
-    
+
     This rule starts an Astro dev server on http://localhost:4321 with hot module
     replacement for rapid documentation development.
-    
+
     Example:
         docs_dev_server(
             name = "docs_dev",
             srcs = glob(["src/**/*", "public/**/*", "*.json", "*.mjs"]),
             package_json = "package.json",
         )
-        
+
     Run with:
         bazel run //docs-site:docs_dev
     """,
-)
+)

docs-site/docs_dev.bzl

@@ -177,26 +177,46 @@ function generateRuleReference(schemas) {
     lines.push('> For the most up-to-date information, see the [source repository](https://github.com/pulseengine/rules_wasm_component).');
     lines.push('');
 
-    // Categorize rules
+    // Categorize rules by language and type
     const categories = {
         'WIT & Interface Rules': [],
-        'Component Rules': [],
+        'Rust Component Rules': [],
+        'Go Component Rules': [],
+        'JavaScript Component Rules': [],
+        'C++ Component Rules': [],
         'Composition Rules': [],
-        'Providers': [],
-        'Other Rules': []
+        'RPC & Communication': [],
+        'Component Tools': [],
+        'Security & Signing': [],
+        'Registry & Distribution': [],
+        'Providers': []
     };
 
     Object.entries(schemas).forEach(([name, data]) => {
         if (data.type === 'provider') {
             categories['Providers'].push({ name, data });
-        } else if (name.includes('wit_')) {
+        } else if (name.includes('wit_') && !name.includes('go_wit') && !name.includes('cpp_wit')) {
             categories['WIT & Interface Rules'].push({ name, data });
-        } else if (name.includes('wasm_component') || name.includes('rust_') || name.includes('go_') || name.includes('js_') || name.includes('cpp_')) {
-            categories['Component Rules'].push({ name, data });
+        } else if (name.includes('rust_') || name === 'rust_wasm_component' || name === 'rust_wasm_component_bindgen' || name === 'rust_wasm_component_test') {
+            categories['Rust Component Rules'].push({ name, data });
+        } else if (name.includes('go_') || name === 'go_wasm_component' || name === 'go_wit_bindgen') {
+            categories['Go Component Rules'].push({ name, data });
+        } else if (name.includes('js_') || name.includes('jco_') || name.includes('npm_') || name === 'js_component') {
+            categories['JavaScript Component Rules'].push({ name, data });
+        } else if (name.includes('cpp_') || name.includes('cc_') || name === 'cpp_component') {
+            categories['C++ Component Rules'].push({ name, data });
         } else if (name.includes('wac_') || name.includes('compose')) {
             categories['Composition Rules'].push({ name, data });
+        } else if (name.includes('wrpc_')) {
+            categories['RPC & Communication'].push({ name, data });
+        } else if (name.includes('wasm_component_new') || name.includes('wasm_component_wizer') || name.includes('wasm_validate')) {
+            categories['Component Tools'].push({ name, data });
+        } else if (name.includes('wasm_sign') || name.includes('wasm_verify') || name.includes('wasm_keygen')) {
+            categories['Security & Signing'].push({ name, data });
+        } else if (name.includes('wkg_') || name.includes('wasm_component_from_oci')) {
+            categories['Registry & Distribution'].push({ name, data });
         } else {
-            categories['Other Rules'].push({ name, data });
+            categories['Component Tools'].push({ name, data });
         }
     });