@deepstorm/cli 0.11.0 → 0.11.1

package/dist/skills/reef-style-frontend/fragments/test/vitest-vue/quick-reference.md

@@ -4,8 +4,8 @@
 
 ```typescript
 // vitest.config.ts
-import { defineConfig } from 'vitest/config'
-import vue from '@vitejs/plugin-vue'
+import { defineConfig } from 'vitest/config';
+import vue from '@vitejs/plugin-vue';
 
 export default defineConfig({
   plugins: [vue()],
@@ -26,12 +26,12 @@ export default defineConfig({
       },
     },
   },
-})
+});
 ```
 
 ```typescript
 // src/test/setup.ts
-import '@testing-library/jest-dom'
+import '@testing-library/jest-dom';
 ```
 
 ## 通用原则
@@ -44,18 +44,18 @@ import '@testing-library/jest-dom'
 ## 组件测试（Vue Test Utils）
 
 ```typescript
-import { mount } from '@vue/test-utils'
-import { describe, it, expect } from 'vitest'
+import { mount } from '@vue/test-utils';
+import { describe, it, expect } from 'vitest';
 
 // ✅ 正确：通过文本寻找元素
-const wrapper = mount(MyComponent)
-expect(wrapper.text()).toContain('提交')
+const wrapper = mount(MyComponent);
+expect(wrapper.text()).toContain('提交');
 
 // ✅ 正确：模拟用户交互
-await wrapper.find('button').trigger('click')
+await wrapper.find('button').trigger('click');
 
 // ✅ 正确：通过 findComponent 查找子组件
-expect(wrapper.findComponent({ name: 'AButton' }).exists()).toBe(true)
+expect(wrapper.findComponent({ name: 'AButton' }).exists()).toBe(true);
 
 // ❌ 避免：通过 CSS 类名选择
 // wrapper.find('.btn-primary') // 禁止
@@ -64,19 +64,19 @@ expect(wrapper.findComponent({ name: 'AButton' }).exists()).toBe(true)
 ## Hook / 组合式函数测试
 
 ```typescript
-import { describe, it, expect } from 'vitest'
+import { describe, it, expect } from 'vitest';
 
 describe('useCounter', () => {
   it('should increment count', () => {
-    const { result } = renderHook(() => useCounter())
+    const { result } = renderHook(() => useCounter());
 
     act(() => {
-      result.current.increment()
-    })
+      result.current.increment();
+    });
 
-    expect(result.current.count).toBe(1)
-  })
-})
+    expect(result.current.count).toBe(1);
+  });
+});
 ```
 
 ## 测试文件命名与位置
@@ -88,22 +88,22 @@ describe('useCounter', () => {
 ## Mock 策略
 
 ```typescript
-import { vi } from 'vitest'
+import { vi } from 'vitest';
 
 // Mock fetch
-global.fetch = vi.fn()
+global.fetch = vi.fn();
 
 // Mock 模块
 vi.mock('ant-design-vue', async () => {
-  const actual = await vi.importActual('ant-design-vue')
+  const actual = await vi.importActual('ant-design-vue');
   return {
     ...actual,
     message: {
       success: vi.fn(),
       error: vi.fn(),
     },
-  }
-})
+  };
+});
 
 // Mock 组合式函数
 vi.mock('@/composables/useUsers', () => ({
@@ -113,7 +113,7 @@ vi.mock('@/composables/useUsers', () => ({
     error: null,
     refresh: vi.fn(),
   }),
-}))
+}));
 ```
 
 ## 异步测试
@@ -124,39 +124,39 @@ it('should load and display users', async () => {
   const mockUsers = [
     { id: '1', username: 'alice', email: 'alice@example.com', role: 'ADMIN' },
     { id: '2', username: 'bob', email: 'bob@example.com', role: 'EDITOR' },
-  ]
+  ];
 
   // 模拟 API 响应
   const mockFetch = vi.fn().mockResolvedValue({
     ok: true,
     json: () => Promise.resolve({ content: mockUsers, totalElements: 2 }),
-  })
-  global.fetch = mockFetch
+  });
+  global.fetch = mockFetch;
 
   // Act
-  const wrapper = mount(UserList)
+  const wrapper = mount(UserList);
 
   // Assert — 等待异步渲染完成
-  await nextTick()
-  expect(wrapper.text()).toContain('alice')
-})
+  await nextTick();
+  expect(wrapper.text()).toContain('alice');
+});
 
 // @testing-library/vue 方案（自动等待）
-import { render, screen } from '@testing-library/vue'
+import { render, screen } from '@testing-library/vue';
 
 it('should display users with testing-library', async () => {
-  render(UserList)
-  expect(await screen.findByText('alice')).toBeInTheDocument()
-})
+  render(UserList);
+  expect(await screen.findByText('alice')).toBeInTheDocument();
+});
 ```
 
 ## Pinia 测试
 
 ```typescript
-import { mount } from '@vue/test-utils'
-import { createTestingPinia } from '@pinia/testing'
-import { describe, it, expect, vi } from 'vitest'
-import UserList from '@/views/UserList.vue'
+import { mount } from '@vue/test-utils';
+import { createTestingPinia } from '@pinia/testing';
+import { describe, it, expect, vi } from 'vitest';
+import UserList from '@/views/UserList.vue';
 
 describe('UserList with Pinia', () => {
   it('renders loading state', () => {
@@ -171,11 +171,11 @@ describe('UserList with Pinia', () => {
           }),
         ],
       },
-    })
+    });
 
-    expect(wrapper.findComponent({ name: 'ASpin' }).exists()).toBe(true)
-  })
-})
+    expect(wrapper.findComponent({ name: 'ASpin' }).exists()).toBe(true);
+  });
+});
 ```
 
 ## 覆盖率要求

package/dist/skills/reef-style-frontend/fragments/ts-config/strict/quick-reference.md

@@ -42,19 +42,19 @@ interface Dict {
   [key: string]: string;
 }
 
-const dict: Dict = { a: "1" };
+const dict: Dict = { a: '1' };
 
 // ❌ 错误 — dict["b"] 可能是 undefined
-console.log(dict["b"].toString());
+console.log(dict['b'].toString());
 
 // ✅ 正确
-const b = dict["b"];
+const b = dict['b'];
 if (b) {
   console.log(b.toString());
 }
 
 // 或用可选链
-console.log(dict["b"]?.toString());
+console.log(dict['b']?.toString());
 ```
 
 ### noImplicitOverride
@@ -63,15 +63,21 @@ console.log(dict["b"]?.toString());
 
 ```typescript
 class Base {
-  save(): void { /* ... */ }
+  save(): void {
+    /* ... */
+  }
 }
 
 class Derived extends Base {
   // ❌ 错误 — 缺少 override
-  save(): void { /* ... */ }
+  save(): void {
+    /* ... */
+  }
 
   // ✅ 正确
-  override save(): void { /* ... */ }
+  override save(): void {
+    /* ... */
+  }
 }
 ```
 
@@ -80,14 +86,14 @@ class Derived extends Base {
 ### 数组查找
 
 ```typescript
-const items: string[] = ["a", "b", "c"];
+const items: string[] = ['a', 'b', 'c'];
 
 // ❌ 错误 — find 返回 T | undefined
-const item = items.find(x => x === "d");
+const item = items.find((x) => x === 'd');
 console.log(item.length);
 
 // ✅ 正确
-const item = items.find(x => x === "d");
+const item = items.find((x) => x === 'd');
 if (item) {
   console.log(item.length);
 }

package/dist/skills/reef-style-frontend/fragments/ui-lib/antd/examples/ui-components.md

@@ -3,40 +3,40 @@
 ## 完整数据表格（搜索 + 分页 + 操作列）
 
 ```tsx
-import { useState, useEffect } from 'react'
-import { Table, Button, Space, Input, Tag, Modal, message } from 'antd'
-import { SearchOutlined, PlusOutlined, EditOutlined, DeleteOutlined } from '@ant-design/icons'
-import type { ColumnsType, TablePaginationConfig } from 'antd/es/table'
-import type { User, PageResponse } from '../types/user'
-import { userService } from '../services/userService'
+import { useState, useEffect } from 'react';
+import { Table, Button, Space, Input, Tag, Modal, message } from 'antd';
+import { SearchOutlined, PlusOutlined, EditOutlined, DeleteOutlined } from '@ant-design/icons';
+import type { ColumnsType, TablePaginationConfig } from 'antd/es/table';
+import type { User, PageResponse } from '../types/user';
+import { userService } from '../services/userService';
 
 const UserManagement: React.FC = () => {
-  const [users, setUsers] = useState<User[]>([])
-  const [loading, setLoading] = useState(false)
-  const [pagination, setPagination] = useState({ current: 1, pageSize: 20, total: 0 })
-  const [search, setSearch] = useState('')
+  const [users, setUsers] = useState<User[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [pagination, setPagination] = useState({ current: 1, pageSize: 20, total: 0 });
+  const [search, setSearch] = useState('');
 
   const fetchUsers = async (page: number, size: number, keyword?: string) => {
-    setLoading(true)
+    setLoading(true);
     try {
-      const data: PageResponse<User> = await userService.list({ page, size, search: keyword })
-      setUsers(data.content)
-      setPagination(prev => ({ ...prev, current: data.number, total: data.totalElements }))
+      const data: PageResponse<User> = await userService.list({ page, size, search: keyword });
+      setUsers(data.content);
+      setPagination((prev) => ({ ...prev, current: data.number, total: data.totalElements }));
     } catch {
-      message.error('加载用户列表失败')
+      message.error('加载用户列表失败');
     } finally {
-      setLoading(false)
+      setLoading(false);
     }
-  }
+  };
 
   useEffect(() => {
-    fetchUsers(pagination.current, pagination.pageSize, search)
-  }, [pagination.current, pagination.pageSize])
+    fetchUsers(pagination.current, pagination.pageSize, search);
+  }, [pagination.current, pagination.pageSize]);
 
   const handleSearch = (value: string) => {
-    setSearch(value)
-    setPagination(prev => ({ ...prev, current: 1 }))
-  }
+    setSearch(value);
+    setPagination((prev) => ({ ...prev, current: 1 }));
+  };
 
   const handleDelete = (id: string) => {
     Modal.confirm({
@@ -45,12 +45,12 @@ const UserManagement: React.FC = () => {
       okText: '删除',
       okType: 'danger',
       onOk: async () => {
-        await userService.delete(id)
-        message.success('删除成功')
-        fetchUsers(pagination.current, pagination.pageSize, search)
+        await userService.delete(id);
+        message.success('删除成功');
+        fetchUsers(pagination.current, pagination.pageSize, search);
       },
-    })
-  }
+    });
+  };
 
   const columns: ColumnsType<User> = [
     { title: '用户名', dataIndex: 'username', key: 'username' },
@@ -60,39 +60,36 @@ const UserManagement: React.FC = () => {
       dataIndex: 'role',
       key: 'role',
       render: (role: string) => {
-        const color = role === 'ADMIN' ? 'red' : role === 'EDITOR' ? 'blue' : 'default'
-        return <Tag color={color}>{role}</Tag>
+        const color = role === 'ADMIN' ? 'red' : role === 'EDITOR' ? 'blue' : 'default';
+        return <Tag color={color}>{role}</Tag>;
       },
     },
     {
       title: '状态',
       dataIndex: 'active',
       key: 'active',
-      render: (active: boolean) => (
-        <Tag color={active ? 'green' : 'default'}>{active ? '活跃' : '停用'}</Tag>
-      ),
+      render: (active: boolean) => <Tag color={active ? 'green' : 'default'}>{active ? '活跃' : '停用'}</Tag>,
     },
     {
       title: '操作',
       key: 'action',
       render: (_, record) => (
         <Space>
-          <Button type="link" icon={<EditOutlined />} onClick={() => handleEdit(record)}>编辑</Button>
-          <Button type="link" danger icon={<DeleteOutlined />} onClick={() => handleDelete(record.id)}>删除</Button>
+          <Button type="link" icon={<EditOutlined />} onClick={() => handleEdit(record)}>
+            编辑
+          </Button>
+          <Button type="link" danger icon={<DeleteOutlined />} onClick={() => handleDelete(record.id)}>
+            删除
+          </Button>
         </Space>
       ),
     },
-  ]
+  ];
 
   return (
     <div>
       <div style={{ marginBottom: 16, display: 'flex', justifyContent: 'space-between' }}>
-        <Input.Search
-          placeholder="搜索用户名/邮箱"
-          allowClear
-          onSearch={handleSearch}
-          style={{ width: 300 }}
-        />
+        <Input.Search placeholder="搜索用户名/邮箱" allowClear onSearch={handleSearch} style={{ width: 300 }} />
         <Button type="primary" icon={<PlusOutlined />} onClick={handleCreate}>
           新增用户
         </Button>
@@ -109,32 +106,32 @@ const UserManagement: React.FC = () => {
           showTotal: (total) => `共 ${total} 条`,
         }}
         onChange={(pag: TablePaginationConfig) => {
-          setPagination(prev => ({
+          setPagination((prev) => ({
             ...prev,
             current: pag.current ?? 1,
             pageSize: pag.pageSize ?? 20,
-          }))
+          }));
         }}
       />
     </div>
-  )
-}
+  );
+};
 ```
 
 ## 表单弹窗（创建/编辑）
 
 ```tsx
 interface UserFormModalProps {
-  open: boolean
-  editingUser?: User | null
-  onClose: () => void
-  onSuccess: () => void
+  open: boolean;
+  editingUser?: User | null;
+  onClose: () => void;
+  onSuccess: () => void;
 }
 
 const UserFormModal: React.FC<UserFormModalProps> = ({ open, editingUser, onClose, onSuccess }) => {
-  const [form] = Form.useForm()
-  const [saving, setSaving] = useState(false)
-  const isEditing = !!editingUser
+  const [form] = Form.useForm();
+  const [saving, setSaving] = useState(false);
+  const isEditing = !!editingUser;
 
   useEffect(() => {
     if (open) {
@@ -143,35 +140,35 @@ const UserFormModal: React.FC<UserFormModalProps> = ({ open, editingUser, onClos
           displayName: editingUser.displayName,
           email: editingUser.email,
           role: editingUser.role,
-        })
+        });
       } else {
-        form.resetFields()
+        form.resetFields();
       }
     }
-  }, [open, editingUser, form])
+  }, [open, editingUser, form]);
 
   const handleSubmit = async () => {
     try {
-      const values = await form.validateFields()
-      setSaving(true)
+      const values = await form.validateFields();
+      setSaving(true);
       if (isEditing) {
-        await userService.update(editingUser!.id, values)
-        message.success('用户信息已更新')
+        await userService.update(editingUser!.id, values);
+        message.success('用户信息已更新');
       } else {
-        await userService.create(values)
-        message.success('用户创建成功')
+        await userService.create(values);
+        message.success('用户创建成功');
       }
-      onSuccess()
-      onClose()
+      onSuccess();
+      onClose();
     } catch (err) {
       // Form validateFields 校验失败会自动聚焦到错误字段，不需要额外处理
       if (err instanceof Error) {
-        message.error(err.message)
+        message.error(err.message);
       }
     } finally {
-      setSaving(false)
+      setSaving(false);
     }
-  }
+  };
 
   return (
     <Modal
@@ -183,16 +180,8 @@ const UserFormModal: React.FC<UserFormModalProps> = ({ open, editingUser, onClos
       destroyOnClose
       okText={isEditing ? '保存' : '创建'}
     >
-      <Form
-        form={form}
-        layout="vertical"
-        autoComplete="off"
-      >
-        <Form.Item
-          name="displayName"
-          label="显示名称"
-          rules={[{ required: true, message: '请输入显示名称' }]}
-        >
+      <Form form={form} layout="vertical" autoComplete="off">
+        <Form.Item name="displayName" label="显示名称" rules={[{ required: true, message: '请输入显示名称' }]}>
           <Input placeholder="请输入显示名称" />
         </Form.Item>
 
@@ -207,11 +196,7 @@ const UserFormModal: React.FC<UserFormModalProps> = ({ open, editingUser, onClos
           <Input placeholder="请输入邮箱" />
         </Form.Item>
 
-        <Form.Item
-          name="role"
-          label="角色"
-          rules={[{ required: true, message: '请选择角色' }]}
-        >
+        <Form.Item name="role" label="角色" rules={[{ required: true, message: '请选择角色' }]}>
           <Select placeholder="请选择角色">
             <Select.Option value="ADMIN">管理员</Select.Option>
             <Select.Option value="EDITOR">编辑</Select.Option>
@@ -220,15 +205,15 @@ const UserFormModal: React.FC<UserFormModalProps> = ({ open, editingUser, onClos
         </Form.Item>
       </Form>
     </Modal>
-  )
-}
+  );
+};
 ```
 
 ## 响应式布局
 
 ```tsx
-import { Row, Col, Card, Statistic } from 'antd'
-import { UserOutlined, FileTextOutlined, AuditOutlined } from '@ant-design/icons'
+import { Row, Col, Card, Statistic } from 'antd';
+import { UserOutlined, FileTextOutlined, AuditOutlined } from '@ant-design/icons';
 
 const Dashboard: React.FC = () => {
   return (
@@ -252,6 +237,6 @@ const Dashboard: React.FC = () => {
         </Col>
       </Row>
     </div>
-  )
-}
+  );
+};
 ```

package/dist/skills/reef-style-frontend/fragments/ui-lib/antd/quick-reference.md

@@ -10,6 +10,7 @@
 ## 常用组件规范
 
 ### Button（按钮）
+
 - 主要操作使用 `type="primary"`，次要操作默认
 - 危险操作使用 `danger` 属性
 - 异步操作必须设置 `loading` 状态防重复提交
@@ -24,6 +25,7 @@
 ```
 
 ### Table（表格）
+
 - 始终指定 `rowKey` 为唯一标识字段（如 `id`）
 - 列表格使用 `pagination` 属性控制分页
 - 长列表开启 `virtual` 虚拟滚动（>= 1000 行）
@@ -44,14 +46,15 @@
     showTotal: (total) => `共 ${total} 条`,
   }}
   onChange={(pagination) => {
-    setPage(pagination.current)
-    setPageSize(pagination.pageSize)
+    setPage(pagination.current);
+    setPageSize(pagination.pageSize);
   }}
   locale={{ emptyText: <Empty description="暂无数据" /> }}
 />
 ```
 
 ### Form（表单）
+
 - 使用 `layout="vertical"` 默认垂直布局
 - 所有校验规则集中在 `rules` 中定义，避免使用自定义 `validator`（除非复杂业务）
 - `Form.Item` 的 `name` 必须与提交数据结构的字段名一致
@@ -59,12 +62,7 @@
 - 全局校验信息通过 `ConfigProvider` 的 `form.validateMessages` 统一配置
 
 ```tsx
-<Form
-  form={form}
-  layout="vertical"
-  onFinish={handleSubmit}
-  autoComplete="off"
->
+<Form form={form} layout="vertical" onFinish={handleSubmit} autoComplete="off">
   <Form.Item
     name="email"
     label="邮箱"
@@ -79,6 +77,7 @@
 ```
 
 ### Modal（弹窗）
+
 - 表单弹窗用 `destroyOnClose` 确保关闭后重置状态
 - `afterClose` 用于关闭后的清理回调
 - 确认弹窗用 `Modal.confirm()` 快捷方法
@@ -94,7 +93,7 @@
   afterClose={() => form.resetFields()}
 >
   <UserForm form={form} user={editingUser} />
-</Modal>
+</Modal>;
 
 // 确认弹窗
 Modal.confirm({
@@ -103,29 +102,34 @@ Modal.confirm({
   okText: '确认删除',
   okType: 'danger',
   onOk: () => deleteUser(id),
-})
+});
 ```
 
 ### Select（选择器）
+
 - 选项少时直接写 `<Select.Option>`；选项多时使用 `options` 数组属性
 - 远程搜索使用 `showSearch` + `onSearch` + `filterOption` 自定义
 - 多选用 `mode="multiple"`
 
 ### DatePicker（日期选择器）
+
 - 使用 `format` 指定显示格式
 - 表单中配合 `Form.Item` 使用，值类型为 `dayjs` 对象
 - 范围选择用 `DatePicker.RangePicker`
 
 ### Space（间距）
+
 - 组件间间距优先使用 `<Space>` 包裹，避免手动 `margin`
 - 默认间距为 `size="small"`（8px），可根据上下文调整
 
 ### message / notification（消息提示）
+
 - 操作反馈使用 `message.success()` / `message.error()` 轻量提示
 - 重要通知使用 `notification.open()` / `notification.info()`
 - 不要在组件中手动创建 message 实例 — 使用静态方法即可
 
 ### Spin（加载中）
+
 - 页面级加载使用 `Spin` 包裹内容区域
 - 组件级加载使用 Spin 组件的 `spinning` 属性
 - 全局加载状态使用 `Spin` + Suspense（React.lazy 场景）