orbcafe-ui 1.1.9 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +48 -5
  2. package/dist/index.js +16 -16
  3. package/dist/index.mjs +13 -13
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -25,6 +25,9 @@
25
25
  | `DetailInfo` | 标准详情页容器（信息块 + Tabs + 底部表格 + AI/搜索） | `src/components/DetailInfo` | `src/components/DetailInfo/README.md` |
26
26
  | `Kanban` | 标准看板模块（Bucket + Card + Drag/Drop + Detail 跳转） | `src/components/Kanban` | `src/components/Kanban/README.md` |
27
27
  | `PageLayout` | 页面壳层（Header + Navigation + Content） | `src/components/PageLayout` | `src/components/PageLayout/README.md` |
28
+ | `PivotTable` | 透视分析（拖拽维度/度量、图表联动、preset） | `src/components/PivotTable` | `src/components/PivotTable/README.md` |
29
+ | `AINav` | 语音导航与命令输入能力 | `src/components/AINav` | `src/components/AINav/README.md` |
30
+ | `Pad` | 平板触摸场景 UI（壳层、触摸表格、数字键盘、扫码） | `src/components/Pad` | `src/components/Pad/README.md` |
28
31
  | `AgentUI` | 聊天 UI 与 Copilot UI（StdChat / CopilotChat / AgentPanel） | `src/components/AgentUI` | `src/components/AgentUI/README.md` |
29
32
 
30
33
  ### 文档查阅顺序（推荐）
@@ -39,12 +42,33 @@
39
42
  - `GraphReport Hooks`：`src/components/GraphReport/Hooks/README.md`
40
43
  - `StdReport Hooks`：`src/components/StdReport/Hooks/README.md`
41
44
  - `PageLayout Hooks`：`src/components/PageLayout/Hooks/README.md`
45
+ - `Pad` 模块文档：`src/components/Pad/README.md`
46
+ - `Pad Hooks`：`src/components/Pad/Hooks/README.md`
42
47
  - `DetailInfo` 模块文档：`src/components/DetailInfo/README.md`
43
48
  - `Kanban` 模块文档：`src/components/Kanban/README.md`
44
49
  - `Kanban Hooks`：`src/components/Kanban/Hooks/README.md`
45
50
  - `Kanban Tools`：`src/components/Kanban/Utils/README.md`
46
51
  - `AgentUI` 模块文档：`src/components/AgentUI/README.md`
47
52
  - `AI 模块契约索引`：`skills/orbcafe-ui-component-usage/references/module-contracts.md`
53
+ - `Pad skill`：`skills/orbcafe-pad-workflow/SKILL.md`
54
+ - `组件通俗名映射（多语言）`：`skills/orbcafe-ui-component-usage/references/component-glossary-i18n.md`
55
+
56
+ ### 组件通俗名（Natural Name）对照
57
+
58
+ 用于“用户自然语言 -> 组件 canonical API”映射，避免只有英文技术名才可路由。
59
+
60
+ | Canonical API | English natural name | 中文通俗名 | German cues |
61
+ | --- | --- | --- | --- |
62
+ | `CTable` | Desktop table | 电脑端表格 | Desktop Tabelle |
63
+ | `CSmartFilter` | Smart filter bar | 智能筛选条 | Filterleiste |
64
+ | `PTable` | Pad/touch table | 平板触摸表格 | Tablet Tabelle |
65
+ | `PSmartFilter` | Pad filter bar | 平板筛选条 | Tablet Filter |
66
+ | `PBarcodeScanner` | Camera barcode scanner | 摄像头扫码控件 | Barcode Scanner |
67
+ | `PNumericKeypad` | On-screen numeric keypad | 屏幕数字小键盘 | Ziffernblock |
68
+ | `CAppPageLayout` | App shell layout | 应用壳层布局 | App Layout |
69
+ | `CDetailInfoPage` | Detail page | 详情页 | Detailseite |
70
+ | `CPivotTable` | Pivot table | 透视表 | Pivot Tabelle |
71
+ | `AgentPanel` | Agent chat panel | 智能体聊天面板 | Agent Chat Panel |
48
72
 
49
73
  ---
50
74
 
@@ -80,19 +104,38 @@ import {
80
104
 
81
105
  ---
82
106
 
107
+ ## Pad（平板触摸场景）
108
+
109
+ `Pad` 模块用于 iPad/平板仓储场景，核心是“保留标准报表能力 + 触摸友好交互”：
110
+
111
+ - `PAppPageLayout`: 平板壳层布局（顶部栏 + 导航 + workload）
112
+ - `PTable`: 触摸卡片式表格，兼容 layout/variant/分页/分组/汇总/quick actions
113
+ - `PSmartFilter`: 触摸友好筛选包装
114
+ - `PNumericKeypad`: 数字录入键盘
115
+ - `PBarcodeScanner`: 摄像头扫码弹窗，优先 `BarcodeDetector`，支持手动回退
116
+ - `usePadLayout` / `usePadRecordEditor`: 平板方向与记录编辑 hook
117
+
118
+ 参考：
119
+ - `src/components/Pad/README.md`
120
+ - `examples/app/_components/PadExampleClient.tsx`
121
+ - `examples/app/pad/page.tsx`
122
+
123
+ ---
124
+
83
125
  ## AI-First Integration
84
126
 
85
127
  如果目标是让 AI 在 vibe coding 场景里稳定使用 ORBCAFE UI，推荐遵循这条顺序：
86
128
 
87
- 1. 先用 `skills/orbcafe-ui-component-usage` 判定目标模块。
88
- 2. 再看 `skills/orbcafe-ui-component-usage/references/module-contracts.md`，确认：
129
+ 1. 先看 `skills/orbcafe-ui-component-usage/references/component-glossary-i18n.md`，把自然语言组件名映射到 canonical API。
130
+ 2. 再用 `skills/orbcafe-ui-component-usage` 判定目标模块。
131
+ 3. 再看 `skills/orbcafe-ui-component-usage/references/module-contracts.md`，确认：
89
132
  - 公共导出入口
90
133
  - 推荐标准组件
91
134
  - 是否公开 hooks
92
135
  - 最小状态结构
93
136
  - 标准 example
94
137
  - 验证与排障清单
95
- 3. 最后才看具体模块 README 和官方 examples。
138
+ 4. 最后才看具体模块 README 和官方 examples。
96
139
 
97
140
  ### 当前标准化原则
98
141
 
@@ -109,7 +152,7 @@ import {
109
152
 
110
153
  不是所有模块都以 hooks 为主入口。
111
154
 
112
- - `StdReport`、`DetailInfo`、`Kanban`、`PivotTable`、`AINav`、`PageLayout` 明确公开了 hooks。
155
+ - `StdReport`、`DetailInfo`、`Kanban`、`PivotTable`、`AINav`、`PageLayout`、`Pad` 明确公开了 hooks。
113
156
  - `AgentUI` 当前不公开自定义 hook，稳定入口是组件 props 和回调契约。
114
157
 
115
158
  这条规则对 AI 很重要，因为它决定了应该生成“hook 驱动代码”还是“组件 + callbacks 驱动代码”。
@@ -208,7 +251,7 @@ export default function HomeClientPage() {
208
251
 
209
252
  ## Next.js 16 兼容性说明（务必阅读）
210
253
 
211
- 官方 example 已按 Next.js `16.1.6` 调整，接入时请遵循以下规则：
254
+ 官方 example 已按 Next.js `16.2.0` 调整，接入时请遵循以下规则：
212
255
 
213
256
  ### 1. 动态路由参数必须在 Server Page 解包
214
257