feat(build): emit checked component refs

Generate ComponentRef constants for component-scoped APIs, include global component refs only when global_exports(true) is enabled, and document/use the checked component token.

req: component/003

slhx-core/src/lib.rs

@@ -186,6 +186,35 @@ impl core::fmt::Display for CssClass {
     }
 }
 
+/// A generated, checked component token.
+/// req: component/003
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Hash)]
+pub struct ComponentRef {
+    name: &'static str,
+}
+
+impl ComponentRef {
+    pub const fn new(name: &'static str) -> Self {
+        Self { name }
+    }
+
+    pub const fn as_str(self) -> &'static str {
+        self.name
+    }
+}
+
+impl AsRef<str> for ComponentRef {
+    fn as_ref(&self) -> &str {
+        self.name
+    }
+}
+
+impl core::fmt::Display for ComponentRef {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
+        f.write_str(self.name)
+    }
+}
+
 /// A generated, checked event token.
 /// req: codegen/006
 #[derive(Clone, Copy, Debug, Eq, PartialEq, Hash)]

slhx-core/tests/effect_batch.rs

@@ -1,7 +1,7 @@
 use slhx_core::{
     event, navigate, redirect, replace, Atom, AtomSnapshot, AtomState, BuildFingerprint,
-    CssClass, CssClasses, Effect, EffectBatch, Form, Handle, IntoEffect, KeyedSlot, NavigateMode,
-    Payload, ResourceKind, SafeHtml, ScopeKey, Slot,
+    ComponentRef, CssClass, CssClasses, Effect, EffectBatch, Form, Handle, IntoEffect, KeyedSlot,
+    NavigateMode, Payload, ResourceKind, SafeHtml, ScopeKey, Slot,
 };
 
 #[test]
@@ -93,6 +93,14 @@ fn slot_html_requires_explicit_safe_html() {
     assert_eq!(payload, Payload::Html(String::from("<strong>ok</strong>")));
 }
 
+#[test]
+fn component_refs_format_generated_component_names() {
+    // req: component/003
+    let component = ComponentRef::new("todo_list");
+    assert_eq!(component.as_str(), "todo_list");
+    assert_eq!(component.to_string(), "todo_list");
+}
+
 #[test]
 fn generated_handles_format_for_hemplate_dynamic_handle_attrs() {
     // req: public_api/001 req: public_api/002