@teamix-evo/skills 0.11.0 → 0.11.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.
@@ -1,94 +0,0 @@
1
- # 高级筛选列表页 (advanced-filter)
2
-
3
- > 路由自 `../SKILL.md`
4
- > 布局模式: 模式D+ (高级筛选)
5
- > 核心差异: 可展开的高级筛选面板 + 多条件组合
6
-
7
- ## 1. 布局骨架
8
-
9
- ```
10
- ┌──────────┬──────────────────────────────────────────────┤
11
- │ Sidebar │ PageHeader: 标题(18px/medium) [描述*] │
12
- │ │ ───────────────────────── │
13
- │ │ ActionToolbar: [创建] + [全部▼][输入...]🔍 [高级筛选▾]│
14
- │ │ ───────────────────────── │
15
- │ │ ┌─── AdvancedFilterPanel ───────────────┐ │
16
- │ │ │ 条件1: [Select] [Input] │ │
17
- │ │ │ 条件2: [Select] [Input] │ │
18
- │ │ │ 条件3: [Select] [Input] │ │
19
- │ │ │ [确认] [清空] │ │
20
- │ │ └───────────────────────────────────────┘ │
21
- │ │ ───────────────────────── │
22
- │ │ DataTable (固定列: 左选择框+ID, 右操作) │
23
- │ │ ───────────────────────── │
24
- │ │ BulkActionBar (选中时内嵌显示) │
25
- │ │ ───────────────────────── │
26
- │ │ Pagination │
27
- └──────────┴──────────────────────────────────────────────┘
28
- ```
29
-
30
- ## 2. 核心差异
31
-
32
- | 维度 | 标准列表 | 高级筛选列表 |
33
- |------|----------|-------------|
34
- | 筛选方式 | SearchCombo | **SearchCombo + AdvancedFilterPanel** |
35
- | 筛选条件数 | 1个维度 | **多条件组合(通常2-5个)** |
36
- | AdvancedFilterPanel | 无 | **必需** |
37
- | FilterTag | 可选 | **必需**(展示已选条件) |
38
-
39
- ## 3. AdvancedFilterPanel 交互规范
40
-
41
- | 交互 | 行为 |
42
- |------|------|
43
- | 打开面板 | 点击"高级筛选"按钮,展开面板 |
44
- | 关闭面板 | 收起面板,恢复基础 SearchCombo |
45
- | 添加条件 | 点击"添加条件",新增一行筛选条件 |
46
- | 删除条件 | 点击条件行右侧 ×,移除该条件 |
47
- | 条件间关系 | **AND 关系**(所有条件同时生效) |
48
- | 确认筛选 | 点击"确认",应用所有条件,刷新列表 |
49
- | 清空筛选 | 点击"清空",清除所有条件 |
50
- | 面板位置 | ActionToolbar 下方,DataTable 上方 |
51
-
52
- ## 4. FilterTag 管理
53
-
54
- - 已选筛选项以 **FilterTag** 形式展示在 ActionToolbar 区域
55
- - 每个 FilterTag 可单独移除(点击 ×)
56
- - 筛选条件清空后,FilterTag 区域隐藏(display: none)
57
- - 高级筛选条件的 FilterTag 支持"清空全部"操作
58
-
59
- ## 5. 引用共享规则
60
-
61
- | 共享规则 | 路径 | 说明 |
62
- |----------|------|------|
63
- | 表格列元规则 | `../_shared/column-meta-rules.md` | 列元规则(显隐/拖拽/排序)
64
- | 产品列定义 | `products/{产品}/columns.json` | 具体列名/宽度/类型 |
65
- | 操作列规范 | `../_shared/action-column-spec.md` | 操作列结构、行为 |
66
- | 状态-操作模式 | `../_shared/state-action-pattern.md` | 状态驱动操作元规则
67
- | 产品状态机 | `products/{产品}/states.json` | 具体状态/操作可用性 |
68
-
69
- > DataTable、BulkActionBar、Pagination、ActionToolbar(不含高级筛选按钮)等组件及交互行为与标准列表页一致,不再重复。
70
-
71
- ## 6. 与 PageContainer 模式对照
72
-
73
- > 布局模式定义见 `../../../rules/layout-rules.json`
74
-
75
- 高级筛选列表使用 **模式D+**:
76
- ```
77
- PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilterPanel(可展开) + DataTable + BulkActionBar + Pagination
78
- ```
79
-
80
- - "高级筛选"按钮位于 ActionToolbar 右侧
81
- - 展开后显示多条件组合面板(条件1/2/3 + 确认/清空)
82
- - 收起后恢复基础 SearchCombo
83
-
84
- ## 7. 验证清单
85
-
86
- > 通用检查项见 `../../../docs/validation-workflow.md` 验证清单。此处仅列出本模式差异项。
87
-
88
- | 验证项 | 检查点 | 目标 |
89
- |--------|--------|------|
90
- | AdvancedFilterPanel | 展开/收起正常 | 正确 |
91
- | 多条件组合 | AND 关系 | 正确 |
92
- | 条件添加/删除 | 增删条件行正常 | 正确 |
93
- | 确认/清空 | 确认后刷新,清空后恢复 | 正确 |
94
- | FilterTag | 展示已选条件,可单独移除 | 正确 |
@@ -1,76 +0,0 @@
1
- # 抽屉中列表页 (drawer)
2
-
3
- > 路由自 `../SKILL.md`
4
- > 布局模式: 模式D (内嵌 Sheet/Dialog)
5
- > 核心差异: 列表嵌入在 Sheet 中,用于选择关联数据
6
-
7
- ## 1. 布局骨架
8
-
9
- ```
10
- ┌──────────────────────────────────────────────────────────────────────┐
11
- │ 主页面内容 (ListPage / FormPage / DetailPage) │
12
- │ ... │
13
- │ ┌───────────────────────────────────────────┐ │
14
- │ │ Sheet (右侧滑出, 宽度 600-900px) │ │
15
- │ │ ┌───── SheetHeader ──────────────────┐ │ │
16
- │ │ │ 选择关联实例 [× 关闭] │ │ │
17
- │ │ ├─────────────────────────────────────┤ │ │
18
- │ │ │ ActionToolbar (SearchCombo 等) │ │ │
19
- │ │ │ ──┬──────────────────────────┬── │ │ │
20
- │ │ │ DataTable (含选择框) │ │ │
21
- │ │ │ ☑|ID|名称|状态|...|操作 │ │ │
22
- │ │ │ ☐|i-xxx|test|●运行中|...|选择 │ │ │
23
- │ │ │ ────────────────────────────── │ │ │
24
- │ │ │ Pagination │ │ │
25
- │ │ ├─────────────────────────────────────┤ │ │
26
- │ │ │ [取消] [确定] (底部操作栏) │ │ │
27
- │ │ └─────────────────────────────────────┘ │ │
28
- │ └───────────────────────────────────────────┘ │
29
- └──────────────────────────────────────────────────────────────────────┘
30
- ```
31
-
32
- ## 2. 核心差异
33
-
34
- | 维度 | 标准列表 | 抽屉中列表 |
35
- |------|----------|-----------|
36
- | 容器 | PageContainer | **Sheet** |
37
- | 触发方式 | 直接访问 URL | **点击按钮/链接打开 Sheet** |
38
- | 选择返回 | 跳转页面 | **选择后点击确定关闭 Sheet,返回选中数据** |
39
- | 宽度 | 全宽/自适应 | **固定宽度 (600-900px)** |
40
- | 关闭方式 | 浏览器返回/面包屑 | **点击 × / 遮罩层 / Esc** |
41
- | 底部操作栏 | 无 | **必需 [取消] [确定]** |
42
-
43
- ## 3. Sheet 交互规范
44
-
45
- | 交互 | 行为 |
46
- |------|------|
47
- | 打开 Sheet | 点击触发按钮,从右侧滑出,宽度 600-900px |
48
- | 选择数据 | 勾选选择框,支持单选/多选(由业务决定) |
49
- | 确认选择 | 点击"确定"关闭 Sheet,返回选中数据到主页面 |
50
- | 取消选择 | 点击"取消"关闭 Sheet,不返回数据 |
51
- | 关闭 Sheet | 点击 × / 遮罩层 / Esc,丢弃未确认的选择 |
52
- | 搜索/筛选 | 在 Sheet 内执行搜索/筛选,不跳转页面 |
53
- | 分页 | 在 Sheet 内分页,不影响主页面 |
54
-
55
- ## 4. 引用共享规则
56
-
57
- | 共享规则 | 路径 | 说明 |
58
- |----------|------|------|
59
- | 表格列元规则 | `../_shared/column-meta-rules.md` | 列元规则(显隐/拖拽/排序)
60
- | 产品列定义 | `products/{产品}/columns.json` | 具体列名/宽度/类型 |
61
- | 操作列规范 | `../_shared/action-column-spec.md` | 操作列结构 |
62
-
63
- > DataTable、Pagination、ActionToolbar 等组件与标准列表页一致,不再重复。
64
- > 操作列中"管理/查看"等页面跳转操作在抽屉中通常禁用或隐藏。
65
-
66
- ## 5. 验证清单
67
-
68
- > 通用检查项见 `../../../docs/validation-workflow.md` 验证清单。此处仅列出本模式差异项。
69
-
70
- | 验证项 | 检查点 | 目标 |
71
- |--------|--------|------|
72
- | Sheet滑出 | 右侧滑出,宽度600-900px | 正确 |
73
- | 遮罩层 | 半透明遮罩,点击关闭 | 正确 |
74
- | 选择反馈 | 选中行高亮 | 正确 |
75
- | 确定/取消 | 确定返回数据,取消丢弃 | 正确 |
76
- | Esc关闭 | Esc关闭Sheet | 正确 |
@@ -1,70 +0,0 @@
1
- # 可展开列表页 (expandable)
2
-
3
- > 路由自 `../SKILL.md`
4
- > 布局模式: 模式D
5
- > 核心差异: DataTable 行内展开显示子数据/详情
6
-
7
- ## 1. 布局骨架
8
-
9
- 在标准列表页(standard-list.md)基础上,DataTable 支持行内展开:
10
-
11
- ```
12
- ┌──────────────────────────────────────────────────────────────────────┐
13
- │ PageHeader + ActionToolbar (同标准列表页) │
14
- │ ──┬────────────────────────────────────────────────────────────┬── │
15
- │ DataTable (行内展开) │
16
- │ ☑|ID|名称|状态|标签|...|操作 │
17
- │ ▶|i-xxx|test|●运行中|🏷|...|管理|... │
18
- │ ┌─────────────────────────────────────────────────────────┐ │
19
- │ │ 子项1: 详情A | 详情B | 详情C │ │
20
- │ │ 子项2: 详情D | 详情E │ │
21
- │ └─────────────────────────────────────────────────────────┘ │
22
- │ ▶|i-yyy|prod|●运行中|🏷|...|管理|... │
23
- │ ───────────────────────────────────────────────────────────── │
24
- │ BulkActionBar + Pagination (同标准列表页) │
25
- └──────────────────────────────────────────────────────────────────────┘
26
- ```
27
-
28
- ## 2. 核心差异
29
-
30
- | 维度 | 标准列表 | 可展开列表 |
31
- |------|----------|-----------|
32
- | 行展开 | 不支持 | **支持** |
33
- | 展开触发 | — | **点击行首展开图标(▶) 或 点击行** |
34
- | 展开方式 | — | **行内展开,不弹出 Dialog/Sheet** |
35
- | 展开高度 | — | **自适应,最大高度 200px** |
36
- | 展开状态持久化 | — | **翻页后保持展开状态** |
37
-
38
- ## 3. 行内展开交互规范
39
-
40
- | 交互 | 行为 |
41
- |------|------|
42
- | 点击展开图标(▶) | 展开/收起该行,展开图标变为 ▼ |
43
- | 点击行(非操作区) | 同展开图标,切换展开状态 |
44
- | 同时展开 | 支持多行同时展开 |
45
- | 展开内容 | 子数据表格 / 详情描述列表 / 关联信息 |
46
- | 收起所有 | 提供"收起全部"按钮(可选) |
47
- | 翻页行为 | 展开状态持久化,翻回原页时保持 | 待确认: 参考文档为"换页不保留" |
48
-
49
- ## 4. 引用共享规则
50
-
51
- | 共享规则 | 路径 | 说明 |
52
- |----------|------|------|
53
- | 表格列元规则 | `../_shared/column-meta-rules.md` | 列元规则(显隐/拖拽/排序)
54
- | 产品列定义 | `products/{产品}/columns.json` | 具体列名/宽度/类型 |
55
- | 操作列规范 | `../_shared/action-column-spec.md` | 操作列结构、行为 |
56
- | 状态-操作模式 | `../_shared/state-action-pattern.md` | 状态驱动操作元规则
57
- | 产品状态机 | `products/{产品}/states.json` | 具体状态/操作可用性 |
58
-
59
- > DataTable(不含展开行为)、BulkActionBar、Pagination、ActionToolbar 等组件及交互行为与标准列表页一致,不再重复。
60
-
61
- ## 5. 验证清单
62
-
63
- > 通用检查项见 `../../../docs/validation-workflow.md` 验证清单。此处仅列出本模式差异项。
64
-
65
- | 验证项 | 检查点 | 目标 |
66
- |--------|--------|------|
67
- | 展开图标 | ▶/▼ 切换正确 | 正确 |
68
- | 行内展开 | 不弹出新窗口/Dialog | 正确 |
69
- | 多行展开 | 支持同时展开多行 | 正确 |
70
- | 翻页持久化 | 翻回原页时展开状态保持 | 正确 |
@@ -1,73 +0,0 @@
1
- # 带 L2 导航列表页 (l2-sidebar)
2
-
3
- > 路由自 `../SKILL.md`
4
- > 布局模式: 模式D + Sidebar(TWO_COL)
5
- > 核心差异: 左侧 240px 分类导航 + 右侧标准列表
6
-
7
- ## 1. 布局骨架
8
-
9
- 在标准列表页(standard-list.md)基础上,页面采用 **TWO_COL** 布局:
10
-
11
- ```
12
- ┌──────────┬──────────────────────────────────────────────┤
13
- │ │ PageHeader + ActionToolbar + DataTable │
14
- │ Sidebar │ + BulkActionBar + Pagination │
15
- │ (240px) │ (同标准列表页完整结构) │
16
- │ │ │
17
- │ [分类A] │ │
18
- │ [分类B] │ │
19
- │ [分类C] │ │
20
- │ ── │ │
21
- │ [子分类] │ │
22
- │ [子分类] │ │
23
- └──────────┴──────────────────────────────────────────────┘
24
- ```
25
-
26
- ## 2. 核心差异
27
-
28
- | 维度 | 标准列表 | L2 导航列表 |
29
- |------|----------|-------------|
30
- | 布局 | SINGLE_COL / TWO_COL | **TWO_COL** |
31
- | Sidebar | 可选 | **必需** |
32
- > Sidebar 收起/展开、交互规范、色彩全部引用 `rules/design-tokens.json` sidebarRules(统一规范)。
33
-
34
- ## 3. Sidebar 交互规范
35
-
36
- | 交互 | 行为 |
37
- |------|------|
38
- | 点击分类 | 刷新右侧列表数据,保持当前页码 |
39
- | 展开/收起 | 切换子分类列表,动画过渡 |
40
- | 收起 Sidebar | 宽度缩至 68px,仅显示图标(详见 design-tokens.json sidebarRules.collapseBehavior) |
41
- | 选中态 | 灰色背景 var(--sidebar-active)(详见 design-tokens.json sidebarRules.colors.menuItem.active) |
42
- | 手风琴 | 打开一个分组自动关闭其他分组 |
43
- | 收起态 Tooltip | Hover显示节点名称 |
44
- | 展开持久化 | 展开/收起状态持久化 |
45
- | 计数徽章 | 每项右侧显示数据量(灰色 12px),数据驱动,实时刷新 |
46
- | 状态指示灯 | 菜单项前圆点(8px)+文字,颜色对应状态(绿/灰/蓝脉冲) |
47
- | 约束 | 最大 20 项 / 最大 2 级嵌套 |
48
-
49
- ## 4. 引用共享规则
50
-
51
- 与标准列表页共享相同的规则文件:
52
-
53
- | 共享规则 | 路径 | 说明 |
54
- |----------|------|------|
55
- | 表格列元规则 | `../_shared/column-meta-rules.md` | 列元规则(显隐/拖拽/排序)
56
- | 产品列定义 | `products/{产品}/columns.json` | 具体列名/宽度/类型 |
57
- | 操作列规范 | `../_shared/action-column-spec.md` | 操作列结构、行为 |
58
- | 状态-操作模式 | `../_shared/state-action-pattern.md` | 状态驱动操作元规则
59
- | 产品状态机 | `products/{产品}/states.json` | 具体状态/操作可用性 |
60
-
61
- > DataTable、BulkActionBar、Pagination、ActionToolbar 等组件及交互行为与标准列表页一致,不再重复。
62
-
63
- ## 5. 验证清单
64
-
65
- > 通用检查项见 `../../../docs/validation-workflow.md` 验证清单。此处仅列出本模式差异项。
66
-
67
- | 验证项 | 检查点 | 目标 |
68
- |--------|--------|------|
69
- | Sidebar 规格 | 展开240px/收起68px(详见 design-tokens.json sidebarRules) | 正确 |
70
- | 分类选中态 | 灰色背景 var(--sidebar-active) | 正确 |
71
- | 分类切换 | 右侧列表刷新 | 正确 |
72
- | 计数徽章 | 每项右侧显示数据量(灰色12px) | 正确 |
73
- | 状态指示灯 | 圆点(8px)+文字,颜色对应状态 | 正确 |