orbcafe-ui 1.1.9 → 1.2.1
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.
- package/README.md +26 -2
- 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,15 @@
|
|
|
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`
|
|
48
54
|
|
|
49
55
|
---
|
|
50
56
|
|
|
@@ -80,6 +86,24 @@ import {
|
|
|
80
86
|
|
|
81
87
|
---
|
|
82
88
|
|
|
89
|
+
## Pad（平板触摸场景）
|
|
90
|
+
|
|
91
|
+
`Pad` 模块用于 iPad/平板仓储场景，核心是“保留标准报表能力 + 触摸友好交互”：
|
|
92
|
+
|
|
93
|
+
- `PAppPageLayout`: 平板壳层布局（顶部栏 + 导航 + workload）
|
|
94
|
+
- `PTable`: 触摸卡片式表格，兼容 layout/variant/分页/分组/汇总/quick actions
|
|
95
|
+
- `PSmartFilter`: 触摸友好筛选包装
|
|
96
|
+
- `PNumericKeypad`: 数字录入键盘
|
|
97
|
+
- `PBarcodeScanner`: 摄像头扫码弹窗，优先 `BarcodeDetector`，支持手动回退
|
|
98
|
+
- `usePadLayout` / `usePadRecordEditor`: 平板方向与记录编辑 hook
|
|
99
|
+
|
|
100
|
+
参考：
|
|
101
|
+
- `src/components/Pad/README.md`
|
|
102
|
+
- `examples/app/_components/PadExampleClient.tsx`
|
|
103
|
+
- `examples/app/pad/page.tsx`
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
83
107
|
## AI-First Integration
|
|
84
108
|
|
|
85
109
|
如果目标是让 AI 在 vibe coding 场景里稳定使用 ORBCAFE UI，推荐遵循这条顺序：
|
|
@@ -109,7 +133,7 @@ import {
|
|
|
109
133
|
|
|
110
134
|
不是所有模块都以 hooks 为主入口。
|
|
111
135
|
|
|
112
|
-
- `StdReport`、`DetailInfo`、`Kanban`、`PivotTable`、`AINav`、`PageLayout` 明确公开了 hooks。
|
|
136
|
+
- `StdReport`、`DetailInfo`、`Kanban`、`PivotTable`、`AINav`、`PageLayout`、`Pad` 明确公开了 hooks。
|
|
113
137
|
- `AgentUI` 当前不公开自定义 hook，稳定入口是组件 props 和回调契约。
|
|
114
138
|
|
|
115
139
|
这条规则对 AI 很重要，因为它决定了应该生成“hook 驱动代码”还是“组件 + callbacks 驱动代码”。
|
|
@@ -208,7 +232,7 @@ export default function HomeClientPage() {
|
|
|
208
232
|
|
|
209
233
|
## Next.js 16 兼容性说明（务必阅读）
|
|
210
234
|
|
|
211
|
-
官方 example 已按 Next.js `16.
|
|
235
|
+
官方 example 已按 Next.js `16.2.0` 调整，接入时请遵循以下规则：
|
|
212
236
|
|
|
213
237
|
### 1. 动态路由参数必须在 Server Page 解包
|
|
214
238
|
|