iter: d05 新增面包屑 breadcrumb 组件

packages/skin/ui/ua.manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "@ui-arch/ui",
   "type": "skin-dom",
-  "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / menu / radioGroup / accordion / card / badge / alert / toast / tooltip / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
+  "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / alert / toast / tooltip / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
   "tags": [
     "components",
     "dom",
@@ -22,6 +22,7 @@
       "menu(props)：下拉菜单，触发器 + 自绘弹层，条目支持禁用 / 危险 / 分隔线，↑↓ 环形导航，点外部 / Esc 关闭",
       "radioGroup(props)：单选组，options + value 信号双向绑定，disabled 整组禁用",
       "accordion(props)：折叠面板，标题按钮 + grid 行高过渡，单开（手风琴）或多开，支持禁用面板与 active 信号受控",
+      "breadcrumb(props)：面包屑，nav + ol 语义结构，末项为当前页（aria-current），有 href 走原生链接、无 href 交给 onNavigate",
       "card(props, ...children)：卡片容器",
       "badge(props)：徽标，variant = default | success | warning | danger",
       "alert(props)：提示条，variant = info | success | warning | danger",
@@ -49,6 +50,8 @@
       "MenuProps",
       "AccordionItem",
       "AccordionProps",
+      "BreadcrumbItem",
+      "BreadcrumbProps",
       "OptionItem",
       "CardProps",
       "BadgeProps",
@@ -75,7 +78,7 @@
     "语义色 variant 四档：default|info / success / warning / danger，一律来自令牌，禁止硬编码颜色"
   ],
   "docs": {
-    "intro": "22 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
+    "intro": "23 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
     "steps": [
       "安装依赖：pnpm add @ui-arch/ui @ui-arch/frame（workspace 内自动链接）",
       "引入样式：在应用入口 import '@ui-arch/ui/ui.css'，暗色主题在根元素设 data-theme='dark'",
@@ -422,6 +425,38 @@
           "内容区用 grid 行高 0fr → 1fr 过渡，无需测量高度；reduced-motion 用户自动静态切换"
         ]
       },
+      {
+        "id": "breadcrumb",
+        "title": "面包屑 Breadcrumb",
+        "demo": "sec-breadcrumb",
+        "props": [
+          {
+            "n": "items",
+            "t": "BreadcrumbItem[]",
+            "r": 1,
+            "d": "路径条目：{ label, href? }，末项自动视为当前页"
+          },
+          {
+            "n": "separator",
+            "t": "string",
+            "d": "分隔符；缺省 '/'",
+            "df": "/"
+          },
+          {
+            "n": "onNavigate",
+            "t": "(item, index) => void",
+            "k": 1,
+            "d": "无 href 条目的点击回调"
+          }
+        ],
+        "example": "breadcrumb({ items: [{ label: '首页', href: '/' }, { label: '设置' }, { label: '账户' }], onNavigate: (it) => console.log(it.label) })",
+        "steps": [
+          "按层级顺序准备 items，最后一项即当前页，自动渲染为不可点的灰色文字并带 aria-current='page'",
+          "需要真实跳转就给条目加 href（渲染 <a>）；单页应用想自行接管时不给 href，改用 onNavigate 回调",
+          "改分隔符传 separator，如 '›'；分隔符对读屏隐藏",
+          "语义结构为 nav + ol + li，可直接放进页头或卡片标题栏"
+        ]
+      },
       {
         "id": "card",
         "title": "卡片 Card",