docs: enhance documentation, specifications, and types across core modules

- Update @moduledoc documentation for Phoenix.React, Server, Cache, Helper, Runtime, and Monitoring modules
- Add comprehensive examples, configuration guides, and performance considerations
- Improve function documentation with detailed parameters and return values
- Add proper @SPEC type specifications for all public functions
- Include production deployment guidance and Telemetry integration examples
- Document bundle size optimization achievements (67% reduction)
- Enhance error handling and monitoring documentation
- Add comprehensive usage patterns and best practices

BREAKING CHANGE: None - documentation only updates

Author: GSMLG-BOT

lib/phoenix/mix/build/bun.ex

@@ -17,7 +17,9 @@ defmodule Mix.Tasks.Phx.React.Bun.Bundle do
   @shortdoc "Bundle components into server.js"
   def run(args) do
     {opts, _argv} =
-      OptionParser.parse!(args, strict: [component_base: :string, output: :string, cd: :string, development: :boolean])
+      OptionParser.parse!(args,
+        strict: [component_base: :string, output: :string, cd: :string, development: :boolean]
+      )
 
     component_base = Keyword.get(opts, :component_base)
     base_dir = Path.absname(component_base, File.cwd!()) |> Path.expand()
@@ -65,15 +67,17 @@ defmodule Mix.Tasks.Phx.React.Bun.Bundle do
     ]
 
     # Add production optimizations unless in development mode
-    build_args = if is_dev do
-      build_args
-    else
-      build_args ++ [
-        "--minify",
-        "--sourcemap=external",
-        "--define=process.env.NODE_ENV=\"production\""
-      ]
-    end
+    build_args =
+      if is_dev do
+        build_args
+      else
+        build_args ++
+          [
+            "--minify",
+            "--sourcemap=external",
+            "--define=process.env.NODE_ENV=\"production\""
+          ]
+      end
 
     {out, code} = System.cmd("bun", build_args, cd: cd)
 

lib/phoenix/mix/build/deno.ex

@@ -96,7 +96,20 @@ defmodule Mix.Tasks.Phx.React.Deno.Bundle do
       # Deno 2.x removed bundle, use compile instead
       # Add node-modules-dir flag for better npm package support
       {out, code} =
-        System.cmd("deno", ["compile", "--output", output, "--allow-read", "--allow-env", "--allow-net", "--allow-write", tmp_file], cd: cd)
+        System.cmd(
+          "deno",
+          [
+            "compile",
+            "--output",
+            output,
+            "--allow-read",
+            "--allow-env",
+            "--allow-net",
+            "--allow-write",
+            tmp_file
+          ],
+          cd: cd
+        )
 
       # Clean up deno.json after compilation
       File.rm!(deno_json_path)