iter(g206): rate 支持再次点击清除评分

packages/skin/ui/src/rate.ts

@@ -1,13 +1,13 @@
 import { effect, h, signal } from '@ui-arch/frame';
 import type { RateProps } from './types.js';
 
-/*** 评分：星标点选（allowHalf 可记半星），hover 预览移出还原，键盘 ←→/↑↓ 调节，value 信号双向绑定 ***/
+/*** 评分：星标点选（allowHalf 可记半星，allowClear 再点当前分清零），hover 预览移出还原，键盘 ←→/↑↓ 调节，value 信号双向绑定 ***/
 export function rate(props: RateProps): HTMLDivElement {
   const value = props.value;
   const max = props.max ?? 5; // 星标总数缺省 5
   const step = props.allowHalf ? 0.5 : 1; // 半星模式步进 0.5
   const hover = signal(0); // 预览值（1 基，0 表示无预览）
-  const emit = (v: number): void => { const n = Math.round(Math.min(max, Math.max(1, v)) * 2) / 2; const q = props.allowHalf ? n : Math.round(n); value(q); if (props.onChange) props.onChange(q); }; // 写回信号并回调（半星按 0.5 量化）
+  const emit = (v: number, allowZero = false): void => { const n = Math.round(Math.min(max, Math.max(allowZero ? 0 : 1, v)) * 2) / 2; const q = props.allowHalf ? n : Math.round(n); value(q); if (props.onChange) props.onChange(q); }; // 写回信号并回调（半星按 0.5 量化；清零仅在 allowZero 时放行）
 
   /*** 计算星标命中值：allowHalf 时左半区记 0.5 分 ***/
   const hitOf = (e: MouseEvent, i: number): number => props.allowHalf && e.offsetX < (e.currentTarget as HTMLElement).offsetWidth / 2 ? i - 0.5 : i;
@@ -29,11 +29,11 @@ export function rate(props: RateProps): HTMLDivElement {
         type: 'button',
         disabled: props.disabled,
         'aria-label': `${i} 星`,
-        onClick: (e: MouseEvent) => emit(hitOf(e, i)),
+        onClick: (e: MouseEvent) => { const hit = hitOf(e, i); if (props.allowClear && hit === value()) emit(0, true); else emit(hit); }, // 再点当前分清零（allowClear）
         onMouseMove: (e: MouseEvent) => hover(hitOf(e, i)), // 半星模式下按悬停位置细分预览
       }, '★'));
     }
-    const node = h('div', { class: 'ua-rate', role: 'slider', tabindex: '0', 'aria-label': '评分', 'aria-valuemin': 1, 'aria-valuemax': max, 'aria-valuenow': value(), onMouseLeave: () => hover(0) }, ...stars) as HTMLDivElement;
+    const node = h('div', { class: 'ua-rate', role: 'slider', tabindex: '0', 'aria-label': '评分', 'aria-valuemin': props.allowClear ? 0 : 1, 'aria-valuemax': max, 'aria-valuenow': value(), onMouseLeave: () => hover(0) }, ...stars) as HTMLDivElement;
     node.addEventListener('keydown', keyNav); // 每次渲染都挂：节点被替换后键盘仍可用
     return node;
   };

packages/skin/ui/src/types.ts

@@ -240,6 +240,7 @@ export interface RateProps {
   value: Signal<number>;  // 当前评分（1 基，allowHalf 时 0.5 步进），双向绑定（点击/键盘写回、外部赋值同步）
   max?: number;           // 星标总数；缺省 5
   allowHalf?: boolean;    // 允许半星：点击左半区记 0.5 分，键盘步进同为 0.5；缺省整数
+  allowClear?: boolean;   // 允许清除：再次点击当前分值清零；缺省不可清
   disabled?: boolean | Signal<boolean>; // 禁用态：布尔直接置位，传信号则动态同步
   onChange?: (value: number) => void;   // 评分变化回调
 }

packages/skin/ui/ua.manifest.json

@@ -1418,6 +1418,11 @@
             "t": "(value: number) => void",
             "k": 1,
             "d": "评分变化回调"
+          },
+          {
+            "n": "allowClear",
+            "t": "boolean",
+            "d": "允许清除：再次点击当前分值（半星须精确相等）清零；缺省不可清"
           }
         ],
         "example": "const score = signal(0); rate({ value: score, max: 5, onChange: (v) => console.log(v) })",