@deepstorm/cli 0.10.2 → 0.11.1

package/dist/skills/reef-style-frontend/variants/angular/examples/component-types-pipes.md

@@ -4,14 +4,31 @@
 
 ```typescript
 type FormControl = TextControl | NumberControl | ChoiceControl;
-interface TextControl { type: 'TextControl'; label: string; maxLength?: number; }
-interface NumberControl { type: 'NumberControl'; min?: number; max?: number; }
-interface ChoiceControl { type: 'ChoiceControl'; options: Option[]; }
+interface TextControl {
+  type: 'TextControl';
+  label: string;
+  maxLength?: number;
+}
+interface NumberControl {
+  type: 'NumberControl';
+  min?: number;
+  max?: number;
+}
+interface ChoiceControl {
+  type: 'ChoiceControl';
+  options: Option[];
+}
 
 // Answer 多态（对应 Java 子类）
 type Answer = UuidAnswer | TextAnswer | ChoiceAnswer | TableAnswer;
-interface UuidAnswer { type: 'UuidAnswer'; value: string | null; }
-interface TextAnswer { type: 'TextAnswer'; value: string | null; }
+interface UuidAnswer {
+  type: 'UuidAnswer';
+  value: string | null;
+}
+interface TextAnswer {
+  type: 'TextAnswer';
+  value: string | null;
+}
 ```
 
 ## 2. 日期 Pipe

package/dist/skills/reef-style-frontend/variants/angular/examples/entity-types.md

@@ -5,13 +5,27 @@
 实体接口镜像后端实体层次，定义在 `shared/base.ts`：
 
 ```typescript
-export interface ImmutableEntity { id: number; createdAt: LocalDateTime; }
-export interface Entity extends ImmutableEntity { lastModifiedAt: LocalDateTime; }
-export interface ImmutableAuditable<T> extends ImmutableEntity { createdBy: T; }
-export interface Auditable<T> extends Entity { createdBy: T; lastModifiedBy: T; }
+export interface ImmutableEntity {
+  id: number;
+  createdAt: LocalDateTime;
+}
+export interface Entity extends ImmutableEntity {
+  lastModifiedAt: LocalDateTime;
+}
+export interface ImmutableAuditable<T> extends ImmutableEntity {
+  createdBy: T;
+}
+export interface Auditable<T> extends Entity {
+  createdBy: T;
+  lastModifiedBy: T;
+}
 
 // UserSummary（审计字段常用类型）
-export interface UserSummary { id: number; username: string; fullName: string; }
+export interface UserSummary {
+  id: number;
+  username: string;
+  fullName: string;
+}
 ```
 
 > `LocalDateTime` 来自 `@js-joda/core`，配合 `iso8601Interceptor` 自动从 JSON 反序列化。
@@ -39,7 +53,11 @@ export interface FormResponse extends Auditable<UserSummary> {
 ## 3. 分页响应
 
 ```typescript
-export interface PageRequest { page: number; size: number; sort: string; }
+export interface PageRequest {
+  page: number;
+  size: number;
+  sort: string;
+}
 export interface PagedResponse<T extends ImmutableEntity> {
   items: T[];
   totalItems: number;
@@ -63,9 +81,7 @@ export class DataObjectInstanceService {
   list(objectId: signal<number | undefined>) {
     return httpResource<PagedResponse<DataObjectInstance>>(() => {
       const id = objectId();
-      return id !== undefined
-        ? `/api/v1/apps/${this.appService.appId()}/objects/${id}/instances`
-        : undefined;
+      return id !== undefined ? `/api/v1/apps/${this.appService.appId()}/objects/${id}/instances` : undefined;
     });
   }
 }
@@ -76,25 +92,39 @@ export class DataObjectInstanceService {
 ```typescript
 // 用户类型（字符串字面量 discrimination）
 interface BaseUser extends Entity {
-  type: string; username: string; fullName: string; role: Role; disabled: boolean;
+  type: string;
+  username: string;
+  fullName: string;
+  role: Role;
+  disabled: boolean;
+}
+export interface InternalUser extends BaseUser {
+  type: 'InternalUser';
+}
+export interface CdyxUser extends BaseUser {
+  type: 'CdyxUser';
 }
-export interface InternalUser extends BaseUser { type: 'InternalUser'; }
-export interface CdyxUser extends BaseUser { type: 'CdyxUser'; }
 export type User = InternalUser | CdyxUser;
 
 // 字段值类型（按 type 字段分发）
 export type FieldValue = TextValue | NumberValue | BooleanValue;
-export interface TextValue { type: 'text'; value: string | null; }
-export interface NumberValue { type: 'number'; value: number | null; }
+export interface TextValue {
+  type: 'text';
+  value: string | null;
+}
+export interface NumberValue {
+  type: 'number';
+  value: number | null;
+}
 ```
 
 ## 5. 关键规则
 
-| 规则 | 说明 |
-|------|------|
-| **interface，不是 class** | 实体全是 `interface`，没有 `class` |
-| **类型参数 `T`** | 审计字段的 `T` 通常是 `UserSummary` |
-| **必要字段** | 字段不设可选（`?`），后端保证返回 |
-| **枚举用 union** | 状态字段用 literal union，不用 TypeScript `enum` |
-| **字段注释** | Entity/接口字段加 `/** */` 注释；简单的 DTO 不加 |
-| **参数顺序** | `appId` → 父级 ID → 自身 ID → name/描述 |
+| 规则                      | 说明                                             |
+| ------------------------- | ------------------------------------------------ |
+| **interface，不是 class** | 实体全是 `interface`，没有 `class`               |
+| **类型参数 `T`**          | 审计字段的 `T` 通常是 `UserSummary`              |
+| **必要字段**              | 字段不设可选（`?`），后端保证返回                |
+| **枚举用 union**          | 状态字段用 literal union，不用 TypeScript `enum` |
+| **字段注释**              | Entity/接口字段加 `/** */` 注释；简单的 DTO 不加 |
+| **参数顺序**              | `appId` → 父级 ID → 自身 ID → name/描述          |

package/dist/skills/reef-style-frontend/variants/angular/examples/forms-layer.md

@@ -12,18 +12,9 @@ import { form, FormField, FormRoot, required } from '@angular/forms/signals';
   imports: [Button, Dialog, FormField, FormRoot, InputText],
   template: `
     <p-button label="创建" (onClick)="onCreate()" />
-    <p-dialog
-      [(visible)]="visible"
-      [header]="isEditing() ? '编辑' : '创建'"
-      modal
-      (onHide)="onHide()"
-    >
+    <p-dialog [(visible)]="visible" [header]="isEditing() ? '编辑' : '创建'" modal (onHide)="onHide()">
       <form [formRoot]="form" (submit)="submitted.set(true)">
-        <input
-          pInputText
-          [formField]="form.name"
-          [pInvalid]="submitted() && form.name().invalid()"
-        />
+        <input pInputText [formField]="form.name" [pInvalid]="submitted() && form.name().invalid()" />
         @if (submitted() && form.name().invalid()) {
           <app-error-messages [errors]="form.name().errors()" />
         }
@@ -40,15 +31,21 @@ export class CrudDialogComponent {
   readonly isEditing = signal(false);
   readonly submitted = signal(false);
 
-  readonly form = form(signal({ name: '' }), (path) => {
-    required(path.name, { message: '名称不能为空' });
-  }, {
-    submission: { action: async () => {
-      await lastValueFrom(this.service.create(this.form().value()));
-      this.messageService.add({ severity: 'success', summary: '创建成功' });
-      this.visible.set(false);
-    }},
-  });
+  readonly form = form(
+    signal({ name: '' }),
+    (path) => {
+      required(path.name, { message: '名称不能为空' });
+    },
+    {
+      submission: {
+        action: async () => {
+          await lastValueFrom(this.service.create(this.form().value()));
+          this.messageService.add({ severity: 'success', summary: '创建成功' });
+          this.visible.set(false);
+        },
+      },
+    },
+  );
 
   onCreate() {
     this.isEditing.set(false);

package/dist/skills/reef-style-frontend/variants/angular/examples/service-routing.md

@@ -15,15 +15,11 @@ export class ItemService {
 
   /** 写操作：HttpClient + finalize reload */
   create(request: { name: string }) {
-    return this.http.post<Item>('/api/v1/items', request).pipe(
-      finalize(() => this.itemsResource.reload()),
-    );
+    return this.http.post<Item>('/api/v1/items', request).pipe(finalize(() => this.itemsResource.reload()));
   }
 
   delete(id: number) {
-    return this.http.delete(`/api/v1/items/${id}`).pipe(
-      finalize(() => this.itemsResource.reload()),
-    );
+    return this.http.delete(`/api/v1/items/${id}`).pipe(finalize(() => this.itemsResource.reload()));
   }
 }
 ```
@@ -59,7 +55,7 @@ export const routes: Routes = [
       {
         path: 'dashboard',
         title: '仪表盘',
-        loadComponent: () => import('./dashboard/dashboard.component').then(m => m.DashboardComponent),
+        loadComponent: () => import('./dashboard/dashboard.component').then((m) => m.DashboardComponent),
       },
     ],
   },
@@ -72,24 +68,25 @@ export const routes: Routes = [
       {
         path: 'users',
         title: '用户管理',
-        loadComponent: () => import('./admin/user-list/user-list.component').then(m => m.UserListComponent),
+        loadComponent: () => import('./admin/user-list/user-list.component').then((m) => m.UserListComponent),
       },
       {
         path: 'role-mappings',
         canActivate: [authGuard],
         data: { requiredAuthority: 'ADMIN', requireRootTenant: true },
-        loadComponent: () => import('./admin/role-mappings/role-mappings.component').then(m => m.RoleMappingsComponent),
+        loadComponent: () =>
+          import('./admin/role-mappings/role-mappings.component').then((m) => m.RoleMappingsComponent),
       },
     ],
   },
   {
     path: 'login',
-    loadComponent: () => import('./login/login.component').then(m => m.LoginComponent),
+    loadComponent: () => import('./login/login.component').then((m) => m.LoginComponent),
     canActivate: [authGuard],
   },
   {
     path: '**',
-    loadComponent: () => import('./page-not-found/page-not-found.component').then(m => m.PageNotFoundComponent),
+    loadComponent: () => import('./page-not-found/page-not-found.component').then((m) => m.PageNotFoundComponent),
   },
 ];
 ```

package/dist/skills/reef-style-frontend/variants/angular/quick-reference.md

@@ -6,14 +6,14 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 新建组件 | Standalone + OnPush + inline template + inject() |
-| 新建表单 | Signal Forms（`form()`），非 Reactive Forms |
-| 读数据 | `httpResource()` |
-| 写数据 | `HttpClient` + `finalize(() => resource.reload())` |
-| Service 职责 | 只负责网络请求，不管理 UI 状态 |
-| 路由 | `loadComponent` 懒加载 |
+| 场景         | 决策                                               |
+| ------------ | -------------------------------------------------- |
+| 新建组件     | Standalone + OnPush + inline template + inject()   |
+| 新建表单     | Signal Forms（`form()`），非 Reactive Forms        |
+| 读数据       | `httpResource()`                                   |
+| 写数据       | `HttpClient` + `finalize(() => resource.reload())` |
+| Service 职责 | 只负责网络请求，不管理 UI 状态                     |
+| 路由         | `loadComponent` 懒加载                             |
 
 ## 新建组件
 
@@ -31,13 +31,13 @@ export class ExampleComponent {
 }
 ```
 
-| 规则 | 要求 |
-| --- | --- |
-| Standalone | 禁止 NgModule，`imports: []` 显式导入 |
-| `OnPush` | 模板中所有输入 immutable |
-| `inject()` | 禁止构造函数注入 |
-| `output()` | 禁止 `@Output()` + `EventEmitter` |
-| `host` | 容器样式用 `host: { class: '...' }`，不包裹 `<div>` |
+| 规则       | 要求                                                |
+| ---------- | --------------------------------------------------- |
+| Standalone | 禁止 NgModule，`imports: []` 显式导入               |
+| `OnPush`   | 模板中所有输入 immutable                            |
+| `inject()` | 禁止构造函数注入                                    |
+| `output()` | 禁止 `@Output()` + `EventEmitter`                   |
+| `host`     | 容器样式用 `host: { class: '...' }`，不包裹 `<div>` |
 
 ## Signal 状态
 
@@ -86,10 +86,10 @@ readonly form = form(signal({ name: '', email: '' }), (path) => {
 
 ## 注释规则
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **类型定义** | 复杂类型加行内注释说明字段含义 |
-| **Service** | 简要说明每个方法的功能和返回类型 |
+| 文件类型      | 注释要求                                 |
+| ------------- | ---------------------------------------- |
+| **类型定义**  | 复杂类型加行内注释说明字段含义           |
+| **Service**   | 简要说明每个方法的功能和返回类型         |
 | **Component** | 关键组件加注释说明用途；复杂逻辑行内注释 |
 
 ## 前端实体类型
@@ -98,11 +98,11 @@ readonly form = form(signal({ name: '', email: '' }), (path) => {
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| Blob 下载 | 后端返回 JSON 时 err.error 被包装为 Blob | `err.error.text().then(text => JSON.parse(text))` |
-| httpResource 初始化 | URL 返回 undefined 时 res.value() 为 undefined | `computed(() => res.value()?.items ?? [])` |
-| `form().reset()` | 只传部分字段，缺失字段不被重置 | `form().reset({ name: '' })` 补全所有字段 |
-| Service 状态泄漏 | 在 Service 中放 signal 管理 UI 状态 | Service 只做网络请求，状态放在 Component 中 |
-| `model()` vs `output()` | 需双向绑定时用了 output() | 用 `model()`，父组件 `[(visible)]="xxx"` |
-| submit handler | 未阻止默认提交行为 | 用 `FormRoot` 指令，或 `(submit)="check()"` + 检查 valid |
+| 场景                    | 问题                                           | 正确做法                                                 |
+| ----------------------- | ---------------------------------------------- | -------------------------------------------------------- |
+| Blob 下载               | 后端返回 JSON 时 err.error 被包装为 Blob       | `err.error.text().then(text => JSON.parse(text))`        |
+| httpResource 初始化     | URL 返回 undefined 时 res.value() 为 undefined | `computed(() => res.value()?.items ?? [])`               |
+| `form().reset()`        | 只传部分字段，缺失字段不被重置                 | `form().reset({ name: '' })` 补全所有字段                |
+| Service 状态泄漏        | 在 Service 中放 signal 管理 UI 状态            | Service 只做网络请求，状态放在 Component 中              |
+| `model()` vs `output()` | 需双向绑定时用了 output()                      | 用 `model()`，父组件 `[(visible)]="xxx"`                 |
+| submit handler          | 未阻止默认提交行为                             | 用 `FormRoot` 指令，或 `(submit)="check()"` + 检查 valid |

package/dist/skills/reef-style-frontend/variants/react/examples/code-wrapping.md

@@ -44,47 +44,34 @@
 
 ```tsx
 // ✅ 简单的三元表达式保持行内
-return <div>{loading ? <Spin /> : <UserTable users={users} />}</div>
+return <div>{loading ? <Spin /> : <UserTable users={users} />}</div>;
 
 // ✅ 复杂条件使用 && 或三元换行
 return (
   <div>
-    {error && (
-      <Alert
-        type="error"
-        message={error.message}
-        closable
-        onClose={clearError}
-      />
-    )}
+    {error && <Alert type="error" message={error.message} closable onClose={clearError} />}
     {!loading && !error && <UserTable users={users} />}
   </div>
-)
+);
 ```
 
 ## Hook 声明
 
 ```tsx
 // ✅ Hook 声明连续排列，按逻辑分组
-const [users, setUsers] = useState<User[]>([])
-const [loading, setLoading] = useState(true)
-const [search, setSearch] = useState('')
+const [users, setUsers] = useState<User[]>([]);
+const [loading, setLoading] = useState(true);
+const [search, setSearch] = useState('');
 
 // useEffect 依赖较长时换行
 useEffect(() => {
-  fetchUsers(search)
-}, [search]) // 短依赖数组行内
+  fetchUsers(search);
+}, [search]); // 短依赖数组行内
 
 // ✅ 长依赖数组换行
 useEffect(() => {
-  fetchFilteredUsers({ search, role, status, page, size })
-}, [
-  search,
-  role,
-  status,
-  page,
-  size,
-])
+  fetchFilteredUsers({ search, role, status, page, size });
+}, [search, role, status, page, size]);
 ```
 
 ## 函数 Props 换行
@@ -114,11 +101,11 @@ useEffect(() => {
 ```tsx
 // ✅ Props 类型每个属性一行
 interface UserFormProps {
-  user?: User
-  onSubmit: (values: CreateUserRequest) => Promise<void>
-  onCancel: () => void
+  user?: User;
+  onSubmit: (values: CreateUserRequest) => Promise<void>;
+  onCancel: () => void;
 }
 
 // ✅ 联合类型换行
-type UserStatus = 'active' | 'inactive' | 'locked' | 'pending'
+type UserStatus = 'active' | 'inactive' | 'locked' | 'pending';
 ```

package/dist/skills/reef-style-frontend/variants/react/examples/component-types-pipes.md

@@ -9,26 +9,29 @@ Angular Pipe 在 React 中用自定义 Hook 或纯函数替代：
 ```tsx
 // ✅ 方案1: 纯函数（无状态转换）
 function formatDate(date: string | Date, format: 'short' | 'long' = 'short'): string {
-  const d = typeof date === 'string' ? new Date(date) : date
+  const d = typeof date === 'string' ? new Date(date) : date;
   if (format === 'short') {
-    return d.toLocaleDateString('zh-CN')
+    return d.toLocaleDateString('zh-CN');
   }
   return d.toLocaleDateString('zh-CN', {
-    year: 'numeric', month: 'long', day: 'numeric',
-    hour: '2-digit', minute: '2-digit',
-  })
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+  });
 }
 
 function formatCurrency(amount: number, currency = 'CNY'): string {
   return new Intl.NumberFormat('zh-CN', {
     style: 'currency',
     currency,
-  }).format(amount)
+  }).format(amount);
 }
 
 // 使用
 const UserList: React.FC = () => {
-  const { users } = useUsers()
+  const { users } = useUsers();
   return (
     <Table
       dataSource={users}
@@ -37,18 +40,16 @@ const UserList: React.FC = () => {
         { title: '金额', dataIndex: 'amount', render: (v: number) => formatCurrency(v) },
       ]}
     />
-  )
-}
+  );
+};
 
 // ✅ 方案2: 自定义 Hook（有状态转换 — 如搜索/过滤）
 function useUserFilter(users: User[], search: string): User[] {
   return useMemo(() => {
-    if (!search.trim()) return users
-    const q = search.toLowerCase()
-    return users.filter(
-      u => u.username.toLowerCase().includes(q) || u.email.toLowerCase().includes(q)
-    )
-  }, [users, search])
+    if (!search.trim()) return users;
+    const q = search.toLowerCase();
+    return users.filter((u) => u.username.toLowerCase().includes(q) || u.email.toLowerCase().includes(q));
+  }, [users, search]);
 }
 ```
 
@@ -57,32 +58,29 @@ function useUserFilter(users: User[], search: string): User[] {
 ```tsx
 // hoc/withAuth.tsx
 interface WithAuthProps {
-  requiredRole?: UserRole
+  requiredRole?: UserRole;
 }
 
-export function withAuth<P extends object>(
-  Component: React.ComponentType<P>,
-  options?: WithAuthProps
-) {
+export function withAuth<P extends object>(Component: React.ComponentType<P>, options?: WithAuthProps) {
   const AuthenticatedComponent: React.FC<P> = (props) => {
-    const { user, loading } = useAuth()
+    const { user, loading } = useAuth();
 
-    if (loading) return <Spin />
-    if (!user) return <Navigate to="/login" replace />
+    if (loading) return <Spin />;
+    if (!user) return <Navigate to="/login" replace />;
 
     if (options?.requiredRole && user.role !== options.requiredRole) {
-      return <Result status="403" title="无权限访问" />
+      return <Result status="403" title="无权限访问" />;
     }
 
-    return <Component {...props} />
-  }
+    return <Component {...props} />;
+  };
 
-  AuthenticatedComponent.displayName = `withAuth(${Component.displayName || Component.name})`
-  return AuthenticatedComponent
+  AuthenticatedComponent.displayName = `withAuth(${Component.displayName || Component.name})`;
+  return AuthenticatedComponent;
 }
 
 // 使用
-const AdminDashboard = withAuth(Dashboard, { requiredRole: UserRole.Admin })
+const AdminDashboard = withAuth(Dashboard, { requiredRole: UserRole.Admin });
 ```
 
 ## 组件组合模式
@@ -128,33 +126,33 @@ Card.Footer = ({ children }) => (
 ```tsx
 // 数据获取 Render Props（复用数据加载逻辑）
 interface DataLoaderProps<T> {
-  fetchFn: () => Promise<T>
-  children: (result: { data: T | null; loading: boolean; error: Error | null }) => React.ReactNode
+  fetchFn: () => Promise<T>;
+  children: (result: { data: T | null; loading: boolean; error: Error | null }) => React.ReactNode;
 }
 
 function DataLoader<T>({ fetchFn, children }: DataLoaderProps<T>) {
-  const [data, setData] = useState<T | null>(null)
-  const [loading, setLoading] = useState(true)
-  const [error, setError] = useState<Error | null>(null)
+  const [data, setData] = useState<T | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
 
   useEffect(() => {
     fetchFn()
       .then(setData)
       .catch(setError)
-      .finally(() => setLoading(false))
-  }, [])
+      .finally(() => setLoading(false));
+  }, []);
 
-  return <>{children({ data, loading, error })}</>
+  return <>{children({ data, loading, error })}</>;
 }
 
 // 使用
 <DataLoader fetchFn={() => userService.getById(id)}>
   {({ data: user, loading, error }) => {
-    if (loading) return <Skeleton active />
-    if (error) return <Alert type="error" message={error.message} />
-    return <UserForm user={user} />
+    if (loading) return <Skeleton active />;
+    if (error) return <Alert type="error" message={error.message} />;
+    return <UserForm user={user} />;
   }}
-</DataLoader>
+</DataLoader>;
 ```
 
 ## Discriminated Union 组件模式
@@ -164,12 +162,12 @@ function DataLoader<T>({ fetchFn, children }: DataLoaderProps<T>) {
 type NotificationCardProps =
   | { type: 'success'; message: string }
   | { type: 'error'; message: string; errorCode?: string }
-  | { type: 'confirm'; message: string; onConfirm: () => void; onCancel: () => void }
+  | { type: 'confirm'; message: string; onConfirm: () => void; onCancel: () => void };
 
 const NotificationCard: React.FC<NotificationCardProps> = (props) => {
   switch (props.type) {
     case 'success':
-      return <Alert type="success" message={props.message} showIcon />
+      return <Alert type="success" message={props.message} showIcon />;
     case 'error':
       return (
         <Alert
@@ -178,18 +176,13 @@ const NotificationCard: React.FC<NotificationCardProps> = (props) => {
           description={props.errorCode ? `错误码: ${props.errorCode}` : undefined}
           showIcon
         />
-      )
+      );
     case 'confirm':
       return (
-        <Modal
-          open
-          title="确认"
-          onOk={props.onConfirm}
-          onCancel={props.onCancel}
-        >
+        <Modal open title="确认" onOk={props.onConfirm} onCancel={props.onCancel}>
           <p>{props.message}</p>
         </Modal>
-      )
+      );
   }
-}
+};
 ```