feat(react): support universal web components in v0.9 renderer

[josemontespg]

Summary

Enables the A2UI React Renderer (@a2ui/react) to optionally render canonical W3C Custom Element Web Components from @a2ui/web_core alongside existing native React components, maintaining 100% backwards compatibility by defaulting to native React components (useUniversalComponents: false).

Key Changes

1. Multi-Catalog Architecture (@a2ui/react/v0_9):

   • NativeBasicCatalog: Populated with native React component implementations.
   • UniversalBasicCatalog: Populated with universal W3C Custom Elements from @a2ui/web_core.
   • BasicCatalog: Dynamic catalog selecting between native and universal based on the useUniversalComponents option.
   • Default basicCatalog instance preserves native React rendering as the default behavior.

2. React to Web Component Bridge (toWebComponent):

   • Idempotently converts React components into W3C Custom Elements.
   • Manages React Root lifecycle safely with microtask-deferred unmounting to prevent teardown during DOM re-parenting.
   • Forwards ComponentContext and buildChild to allow custom React components to host and be hosted within universal container elements.

3. Global React Configuration (A2UIProvider & useA2UI):

   • Introduced <A2UIProvider useUniversalComponents={boolean}> context provider and useA2UI() hook for global renderer configuration.

4. Surface Host Component Dual-Mode Rendering (A2uiSurface.tsx):

   • ResolvedChild dynamically resolves both ReactComponentImplementation (JSX render function) and WebComponentImplementation (W3C Custom Element tag with context binding).

5. React Explorer Query Parameter Support (a2ui_explorer):

   • Supports ?useUniversalComponent=true or ?useUniversalComponents=true query parameter to test both modes interactively.

Pre-launch Checklist

• I read the [Contributors Guide].
• I read the [Style Guide].
• My code changes have tests.

[gemini-code-assist]

Code Review

This pull request introduces support for universal W3C Custom Element components alongside native React components, adding the toWebComponent adapter, A2UIProvider context, and a multi-catalog architecture (BasicCatalog, NativeBasicCatalog, UniversalBasicCatalog). The review feedback highlights several critical improvements: adding SSR guards and handling tag name collisions in toWebComponent, optimizing WebComponentNode to prevent ref callback thrashing, and ensuring that overridden components in both NativeBasicCatalog and UniversalBasicCatalog have their names aligned with their override keys to prevent silent rendering failures.

[josemontespg]

Move this to the previous PR that is adding the keyboard shortcuts

[josemontespg]

🤖 Rebased PR #2283 onto PR #2282; all Angular explorer sidebar components are in PR #2282.