WIP components (as built)

docs/components/200-currency-converter.md

@@ -0,0 +1,44 @@
+# 200 CurrencyConverter
+
+## 用途
+
+货币换算。
+
+## 最小示例
+
+```go
+state := mujica.CurrencyConverterState{Amount: 100, From: "USD", To: "JPY"}
+currencies := []mujica.Currency{{Code: "USD", Name: "Dollar", Decimals: 2}, {Code: "JPY", Name: "Yen", Decimals: 0}}
+rate := 149.37
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	r := mujica.CurrencyConverter(c, &state, currencies, mujica.CurrencyConverterOptions{Rate: rate})
+	if r.PairChanged {
+		rate = 0
+		fmt.Println(state.From, state.To)
+	}
+}
+ui.Render(view, 960, 440, 1)
+```
+
+## 参数
+
+`RateFrom/RateTo` 指定汇率所属货币对，支持数值相同的刷新结果；货币小数位范围 0—12。
+
+`s` 保存金额及货币对；`currencies` 至少两种，Decimals 为最小单位精度。`Rate` 默认 0 表示待提供；`RateTime` 零值隐藏；`Disabled` 默认 false。
+
+## 状态
+
+默认；交互区域支持聚焦与选中，Disabled 参数控制禁用。
+
+## 事件
+
+if r.PairChanged { rate = 0; 调用方回调(state.From, state.To) }
+
+## 键盘操作
+
+Tab 到达金额、币种和互换；方向键步进、选择；Enter/Space 互换。
+
+## 限制
+
+币种切换产生 PairChanged，调用方立即将 Rate 置 0 并获取新汇率；结果按目标货币精度取整。