WIP components (as built)

docs/components/237-citation-badge.md

@@ -0,0 +1,39 @@
+# 237 CitationBadge 引用编号
+
+## 用途
+
+行内引用编号；悬停预览来源；点击定位来源。
+
+## 最小示例
+
+```go
+var cites mujica.CitationState
+src := mujica.Source{Title: "The Palace of Versailles", URL: "https://example.com/versailles"}
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if mujica.CitationBadge(c, 1, src, &cites).Changed() {
+		fmt.Println("show source", cites.Active)
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+`n` 为从 1 开始的引用编号；`src.Title`、`src.URL` 必填；`st` 为与来源卡片共享的 CitationState；`Active=0` 表示尚未选中。
+
+## 状态
+
+默认、悬停、键盘焦点与祖先禁用；业务状态由调用方提供。
+
+## 事件
+
+每次点击或键盘激活触发 ChoiceResult.Changed() 并定位来源；重复激活同一引用也会重新定位。
+
+## 键盘操作
+
+Tab 到引用；Enter、Space 定位；悬停或键盘焦点 500 毫秒后预览；Escape 关闭预览。
+
+## 限制
+
+编号按调用方引用顺序映射；预览内容来自调用方。