fix(design): M69 r1 —— SEARCH_BAR 内边距语义收口 + ComponentRadius 取值口上闸

P2-1（语义缝隙）：`SEARCH_BAR` 的 pad_start / pad_end 原为 16，与
icon_offset = 4 按字面相加得 20，比官方图标可视边 16 多 4px（越过 rubric
±2px 容差）；而被加数的 12 不在 CM 里，消费方只能自己写 12.0 —— 正是 G10
要消灭的字面量。改为 12（文本框内容内边距，Space::X3）+ 4，两侧同式：
图标可视边 = pad + icon_offset = 16。字段文档写明求和公式；测试钉死
pad + offset == 16 且 pad != 16（防有人把 16 写回 pad 再叠加）。
顺带给 SEARCH_BAR.gap 补 [估] 出处（官方无图标↔文字 token）。

P2-2（绕过路径）：ComponentRadius::dp() 收成 pub(crate)。它不看尺寸、
无条件返回 2.0，公开等于把 D32 的尺寸闸交给自觉。对外唯一取值口是
radius_px(size) -> Option<f32>；ALL 只暴露变体名、不暴露数值。
tokext_pins 原用 dp()，改为紧邻的 radius_px(20.0) == Some(2.0)，覆盖不丢。

顺手：修掉本轮新引入的 rustdoc warning（component_map 文档链到私有模块
metrics，改指 ComponentMetrics）；Divider 行标注 motion/duration 为占位，
并在 ComponentSpec 的 text / motion 字段文档写明「无文字 / 无动效的组件
这里是占位值，消费方不得据此排版 / 排动效」。

门禁：test 165 全绿、fmt --check、clippy -D warnings、check --workspace
--all-targets、doc（warning 2 → 1，只剩既有的 typography→emphasized 一条）。

crates/design/src/component_map/metrics.rs

@@ -46,13 +46,14 @@ pub struct ComponentMetrics {
     pub inner_dot: f32,
     /// 控件相对容器的外距（dp）：drawer 项 = 12，决定选中指示器左右各内缩 12。
     pub inset: f32,
-    /// 内容起始侧内边距（dp）。
+    /// 内容起始侧内边距（dp）。**图标不算在内**：图标可视边 = `pad_start + icon_offset`。
     pub pad_start: f32,
-    /// 内容结束侧内边距（dp）。
+    /// 内容结束侧内边距（dp）。同起始侧，图标可视边 = `pad_end + icon_offset`。
     pub pad_end: f32,
     /// 图标边长（dp；`0.0` = 无图标）。
     pub icon: f32,
-    /// 图标相对内边距的**额外**偏移（dp）。
+    /// 图标相对内边距的**额外**偏移（dp）。图标可视边 = 内边距 + 本值（search bar：12 + 4 = 16），
+    /// **不要**把内边距本身当图标边用，也不要再手抄那个 12 / 16。
     pub icon_offset: f32,
     /// 图标与文字（或相邻元素）的间距（dp）。
     pub gap: f32,
@@ -107,9 +108,14 @@ impl ComponentMetrics {
     ///
     /// 高度与宽度**不在这里**：条高 56 是骨架级（`LayoutMetrics::search_bar_height`），
     /// 最小宽 360 同样属骨架级（尚未进 LM，M69 报告里登记为待办）。这里只装画进 bar 里的几何：
-    /// 图标 24（`IconSize::Toolbar`）、可视左缘 16 = 文本框默认 12 + `SearchBarIconOffsetX = 4`、
-    /// 右端同样 16（§20.4）。圆角走 `ShapeScale::Full`（56 → 28 = 官方 `SearchBarCornerRadius`），
+    /// 图标 24（`IconSize::Toolbar`）、**图标可视边 = `pad_start + icon_offset`** = 12 + 4 = **16**
+    /// （右侧同式为 16，§20.4）、圆角走 `ShapeScale::Full`（56 → 28 = 官方 `SearchBarCornerRadius`），
     /// 所以 `radius` 是 `None`。
+    ///
+    /// 为什么要拆成 12 + 4 而不是直接写 16：官方 = 文本框内容内边距 **12**（`TextFieldImpl` 默认）
+    /// 加上 `SearchBarIconOffsetX = 4`。拆开才能让「文本从 12 起、图标从 16 起」都被消费方拿到；
+    /// 只写 16 的话文本内边距没有落点，消费方只能自己写 `12.0`——正是 G10 要消灭的字面量。
+    /// 图标位置一律按 `pad + icon_offset` 求和，不要单独把 `pad` 当图标边用。
     pub const SEARCH_BAR: Self = Self {
         width: 0.0,
         height: 0.0,
@@ -118,10 +124,12 @@ impl ComponentMetrics {
         state_layer: 0.0,
         inner_dot: 0.0,
         inset: 0.0,
-        pad_start: Space::X4.dp(),
-        pad_end: Space::X4.dp(),
+        pad_start: Space::X3.dp(),
+        pad_end: Space::X3.dp(),
         icon: IconSize::Toolbar.px(),
         icon_offset: 4.0,
+        // 图标 ↔ 文本 8 是**团队口径 [估]**：`research/15` §20.4 只给了图标尺寸/位置与 48 命中框，
+        // 没有「图标 ↔ 文字」的 token（Compose 由 `TextFieldImpl` 内部排版决定）。
         gap: Space::X2.dp(),
     };