weifuwu 0.63.1 → 0.64.1

package/dist/components/style.css

@@ -702,6 +702,28 @@ code {
 }
 }
 
+@layer layout {
+/* popup — 浮层基类（usePopup.portal 自动附加；Modal/Drawer 等手动浮层可选用）
+ *
+ * 宽度视口 clamp：任何浮层默认不横向溢出（375px 屏也能完整操作）。
+ * usePopup 已内联 maxWidth；本类兜底组件手动引用场景（audit 规则的目标选择器）。
+ */
+.wf-popup {
+  max-width: min(var(--wf-popup-max, 480px), calc(100vw - 32px));
+  box-sizing: border-box;
+}
+}
+
+@layer layout {
+/* safe-area — iOS 刘海屏/Home 条安全区工具（env() 未生效环境自动为 0） */
+.wf-safe-bottom {
+  padding-bottom: env(safe-area-inset-bottom);
+}
+.wf-safe-top {
+  padding-top: env(safe-area-inset-top);
+}
+}
+
 @layer layout {
 /* anchor — 定位锚点容器 */
 .wf-anchor {
@@ -2049,6 +2071,14 @@ code {
   color: var(--wf-color-text-tertiary);
 }
 
+/* 触屏（coarse）：月份切换按钮 44px 命中区 */
+@media (pointer: coarse) {
+  .wf-calendar-nav-btn {
+    min-height: 44px;
+    min-width: 44px;
+  }
+}
+
 /* weifuwu/components — Card */
 
 .wf-card {
@@ -2187,6 +2217,25 @@ code {
   transform: scale(1.25);
 }
 
+/* 触屏（coarse）：箭头 44px；圆点保持视觉 8px，用 ::after 扩展命中区（视觉不变） */
+@media (pointer: coarse) {
+  .wf-carousel-arrow {
+    width: 44px;
+    height: 44px;
+    min-width: 44px;
+    min-height: 44px;
+  }
+  .wf-carousel-dot {
+    position: relative;
+  }
+  .wf-carousel-dot::after {
+    content: '';
+    position: absolute;
+    inset: -14px;
+    border-radius: 50%;
+  }
+}
+
 /* weifuwu/components — Cascader */
 
 .wf-cascader-wrap {
@@ -3240,6 +3289,34 @@ code {
   padding: 0 2px;
 }
 
+/* ── 移动端适配（P0）：面板宽度视口 clamp + range 窄屏纵向堆叠 ── */
+
+.wf-datepicker-dropdown {
+  max-width: calc(100vw - 32px);
+}
+
+.wf-time-picker {
+  max-width: calc(100vw - 32px);
+}
+
+.wf-datepicker-range-wrap {
+  max-width: calc(100vw - 32px);
+}
+
+/* range 双面板（240px×2 ≈ 500px）在 375px 屏溢出 → 窄屏纵向堆叠 */
+@media (max-width: 639px) {
+  .wf-datepicker-range-wrap {
+    flex-direction: column;
+    max-height: 80vh;
+    overflow-y: auto;
+  }
+}
+
+/* 时间选择列（时/分/秒）窄屏横向滚动 */
+.wf-time-body {
+  overflow-x: auto;
+}
+
 /* weifuwu/components — Descriptions */
 
 .wf-descriptions {
@@ -3477,6 +3554,14 @@ code {
   border-top: var(--wf-border-width, 1px) solid var(--wf-color-border);
 }
 
+/* 移动端适配（P2）：小屏抽屉全宽（底部安全区） */
+@media (max-width: 639px) {
+  .wf-drawer-panel {
+    width: 100vw;
+    max-width: 100vw;
+  }
+}
+
 /* weifuwu/components — Dropdown */
 
 .wf-dropdown {
@@ -3843,6 +3928,14 @@ code {
   border-top: 1px solid var(--wf-color-border);
 }
 
+/* 触屏（coarse）：工具栏按钮 44px 命中区 */
+@media (pointer: coarse) {
+  .wf-editor-toolbar button {
+    min-height: 44px;
+    min-width: 44px;
+  }
+}
+
 /* weifuwu/components — EmptyState */
 
 .wf-empty {
@@ -4915,6 +5008,25 @@ code {
   border-top: var(--wf-border-width) solid var(--wf-color-border);
 }
 
+/* ── 移动端适配（P2）：min-width 视口 clamp（修 375px 屏 400px 溢出）+ 小屏 bottom-sheet ── */
+
+.wf-modal-content {
+  min-width: min(var(--wf-modal-width, 400px), calc(100vw - 32px));
+}
+
+@media (max-width: 639px) {
+  .wf-modal {
+    align-items: flex-end; /* bottom-sheet 形态 */
+  }
+  .wf-modal-content {
+    width: 100%;
+    max-width: 100vw;
+    max-height: 85vh;
+    border-radius: var(--wf-radius-lg) var(--wf-radius-lg) 0 0;
+    padding-bottom: env(safe-area-inset-bottom);
+  }
+}
+
 /* weifuwu/components — Notification */
 
 .wf-notification-container {
@@ -5111,6 +5223,23 @@ code {
   color: var(--wf-color-text-tertiary);
 }
 
+/* 触屏（coarse）：页码 44px 命中区（覆盖全局 button min-height） */
+@media (pointer: coarse) {
+  .wf-pagination-item {
+    min-height: 44px;
+    min-width: 44px;
+  }
+}
+
+/* 移动端适配（P2）：窄屏页码横向滚动兜底（44px 命中区 + 折叠后仍可能溢出） */
+.wf-pagination {
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+.wf-pagination::-webkit-scrollbar {
+  display: none;
+}
+
 /* weifuwu/components — PasswordInput（复用 Input 基础类） */
 
 .wf-password {
@@ -5816,6 +5945,15 @@ code {
   border-radius: var(--wf-radius-sm);
 }
 
+/* 触屏（coarse）：搜索选项行 44px 命中区（非 button 元素，需显式覆盖） */
+@media (pointer: coarse) {
+  .wf-select-search-opt {
+    min-height: 44px;
+    display: flex;
+    align-items: center;
+  }
+}
+
 /* weifuwu/components — Skeleton */
 
 .wf-skeleton {
@@ -6277,6 +6415,15 @@ code {
   padding-top: var(--wf-space-md);
 }
 
+/* 移动端适配（P2）：窄屏标签横向滚动（隐藏滚动条） */
+.wf-tab-list {
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+.wf-tab-list::-webkit-scrollbar {
+  display: none;
+}
+
 /* weifuwu/components — Tag */
 
 .wf-tag {
@@ -7065,6 +7212,23 @@ code {
   cursor: not-allowed;
 }
 
+/* 触屏（coarse）：移动按钮 44px 命中区 */
+@media (pointer: coarse) {
+  .wf-transfer-btn {
+    width: 44px;
+    height: 44px;
+    min-width: 44px;
+    min-height: 44px;
+  }
+}
+
+/* 移动端适配（P2）：窄屏双栏纵向堆叠（操作钮居中） */
+@media (max-width: 767px) {
+  .wf-transfer {
+    flex-direction: column;
+  }
+}
+
 /* weifuwu/components — Tree */
 
 .wf-tree {

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export type { EmailOptions, EmailMessage, EmailResult, EmailAdapter, EmailInject
 export { sendSmtp } from './email/smtp.ts';
 export type { SmtpConfig } from './email/smtp.ts';
 export { userSystem } from './user/index.ts';
+export { hashPassword, verifyPassword } from './user/password.ts';
 export { messager } from './messager/index.ts';
 export type { UserSystemOptions, UserInjected, AuthApi, RegisterInput } from './user/index.ts';
 export type { MessagerOptions, MessagerInjected, MessagerClient, MessagerSystem, Message, Conversation } from './messager/index.ts';

package/dist/index.js

@@ -6035,6 +6035,7 @@ export {
   created,
   email,
   forbidden,
+  hashPassword,
   messager,
   noContent,
   notFound,
@@ -6055,5 +6056,6 @@ export {
   uiSsr,
   unauthorized,
   unprocessable,
-  userSystem
+  userSystem,
+  verifyPassword
 };

package/dist/layout/weifuwu-layout.css

@@ -702,6 +702,28 @@ code {
 }
 }
 
+@layer layout {
+/* popup — 浮层基类（usePopup.portal 自动附加；Modal/Drawer 等手动浮层可选用）
+ *
+ * 宽度视口 clamp：任何浮层默认不横向溢出（375px 屏也能完整操作）。
+ * usePopup 已内联 maxWidth；本类兜底组件手动引用场景（audit 规则的目标选择器）。
+ */
+.wf-popup {
+  max-width: min(var(--wf-popup-max, 480px), calc(100vw - 32px));
+  box-sizing: border-box;
+}
+}
+
+@layer layout {
+/* safe-area — iOS 刘海屏/Home 条安全区工具（env() 未生效环境自动为 0） */
+.wf-safe-bottom {
+  padding-bottom: env(safe-area-inset-bottom);
+}
+.wf-safe-top {
+  padding-top: env(safe-area-inset-top);
+}
+}
+
 @layer layout {
 /* anchor — 定位锚点容器 */
 .wf-anchor {

package/docs/components-map.md

@@ -0,0 +1,153 @@
+# weifuwu/components 组件速查（对应 antd / Element Plus / shadcn-ui）
+
+> **开发者迁移速查**：从 antd / Element Plus / shadcn-ui 迁到 weifuwu，按功能找到对应组件。
+> 左侧是 **weifuwu 组件**（已提供），右侧是对应的三库组件 + 差异备注。
+> 真实未实现清单（仅 4 项）：见文末「weifuwu 尚未实现」。
+
+## 通用基础
+
+| 功能 | weifuwu | antd | Element Plus | shadcn-ui | 差异说明 |
+|------|---------|------|-------------|-----------|---------|
+| 按钮 | `<Button variant size loading block>` | Button | Button | Button | 命名基本一致；weifuwu `variant`=primary/secondary/ghost/danger |
+| 图标 | `<Icon name>`（自研 30+ stroke SVG） | Icon | Icon | lucide-react | weifuwu 零依赖、currentColor、1em 随字号；组件内部统一走 Icon |
+| 文本排版 | `<Title/Text/Paragraph>` | Typography | Typography | — | 语义标签 + 语义色 `-text` 变体 + mark/code/删除线 |
+| 分割线 | `<Divider>`（horizontal/vertical/带文字） | Divider | Divider | Separator | 等价 |
+| 头像 | `<Avatar name src color size>` | Avatar | Avatar | Avatar | weifuwu 支持名字哈希色 + 指定色 |
+| 头像组 | `<AvatarGroup items max size>` | Avatar.Group | 手动组合 | 手动组合 | weifuwu 独立组件，`max` 溢出显示 +N |
+| 标签/标签组 | `<Label>`（required 星号）/ `<TagsInput>`（回车/逗号/去重） | Form.Item 标签 / Select tags | — | Label | Label 独立组件 |
+
+## 导航
+
+| 功能 | weifuwu | antd | Element Plus | shadcn-ui | 差异说明 |
+|------|---------|------|-------------|-----------|---------|
+| 菜单/侧栏 | `<Menu items group activeKey onSelect>`（方向键导航） | Menu | Menu | NavigationMenu / Sidebar | 分组 group 已支持；**子菜单/折叠未实现** |
+| 面包屑 | `<Breadcrumb items>` | Breadcrumb | Breadcrumb | Breadcrumb | 等价 |
+| 标签页 | `<Tabs items active onChange>`（方向键 + 移动端横向滚动） | Tabs | Tabs | Tabs | 等价 |
+| 分页 | `<Pagination total page onChange>`（页码折叠 + 移动端 44px） | Pagination | Pagination | Pagination | 等价 |
+| 步骤条 | `<Steps items current>` | Steps | Steps | — | 等价 |
+| 下拉菜单 | `<Dropdown items>`（danger variant） | Dropdown | Dropdown | DropdownMenu | 等价（usePopup：外部点击/Escape 关闭） |
+| 水平菜单栏 | `<Menubar menus>`（←→↓ 键盘 + 触屏） | Menu 水平 | Menu | Menubar | 等价 |
+| 页面标题 | `<PageHeader title sub>` | PageHeader（v5 移除） | PageHeader | — | weifuwu 保留独立组件 |
+| 回到顶部 | `<BackTop threshold>` | FloatButton / BackTop | Backtop | — | 滚动超阈值显示 |
+| 固定定位 | `<Affix offsetTop>` | Affix | Affix | — | useScrollPosition 实现 |
+| 锚点 | 未实现 | Anchor | Anchor | — | 待补 |
+
+## 表单
+
+| 功能 | weifuwu | antd | Element Plus | shadcn-ui | 差异说明 |
+|------|---------|------|-------------|-----------|---------|
+| 输入框 | `<Input label error hint variant>` | Input | Input | Input | weifuwu 自带 label/error/hint 包装（antd 需 Form.Item）；`variant="borderless"` 内联编辑 |
+| 文本域 | `<Textarea rows showCount maxLength>` | Input.TextArea | Input textarea | Textarea | weifuwu 独立组件 + 字数统计 |
+| 选择器 | `<Select options searchable multiple>` | Select | Select | Select / Combobox | **searchable + 键盘 ↑↓ + multiple 已实现**（近 Combobox） |
+| 复选框 | `<Checkbox checked label>` | Checkbox | Checkbox | Checkbox | 等价 |
+| 复选组 | `<CheckboxGroup options value>` | Checkbox.Group | Checkbox 组 | — | 数组受控 + 栅格列数 |
+| 单选 | `<RadioGroup options value>` | Radio.Group | Radio | RadioGroup | 等价 |
+| 开关 | `<Switch checked>` | Switch | Switch | Switch | 等价 |
+| 滑块 | `<Slider min max step>` | Slider | Slider | Slider | 等价 |
+| 数字输入 | `<InputNumber min max step precision>`（增减按钮+clamp） | InputNumber | InputNumber | — | 等价 |
+| 密码输入 | `<PasswordInput>`（眼睛切换） | Input.Password | Input show-password | — | weifuwu 独立组件 |
+| 日期选择 | `<DatePicker mode="date\|datetime\|time\|range">`（四合一） | DatePicker / TimePicker / RangePicker | DatePicker / DateTimePicker / TimePicker | Calendar + DatePicker 组合 | **一个组件覆盖三库四个**；移动端 range 自动堆叠 |
+| 评分 | `<Rate value>`（键盘方向键） | Rate | Rate | — | allowClear/readOnly |
+| 验证码 | `<PinInput length>`（粘贴/回退/自动聚焦） | — | — | InputOTP | 等价 |
+| 颜色选择 | `<ColorPicker value>`（预设色板 + hex） | ColorPicker | ColorPicker | — | Popover 弹层 |
+| 标签输入 | `<TagsInput value onChange>`（回车/逗号/去重） | Select mode="tags" | 手动组合 | — | weifuwu 独立组件 |
+| 搜索框 | `<SearchInput>` | Input.Search | Input search | — | weifuwu 独立组件 |
+| 分段控件 | `<SegmentedControl options value>` | Segmented | — | ToggleGroup 近似 | weifuwu 独立组件 |
+| 切换按钮 | `<Toggle>/<ToggleGroup>`（single/multiple） | — | — | ToggleGroup | shadcn 对齐 |
+| 表单 | `<Form>` + `<Field label error>`（校验规则） | Form + Form.Item | Form + Form.Item | Form | weifuwu Field 轻量（无 Provider 样板） |
+| 文件上传 | `<FileUpload drag multiple accept maxSize>` | Upload | Upload | — | 拖拽已支持；文件列表/预览/进度待增强 |
+
+## 数据展示
+
+| 功能 | weifuwu | antd | Element Plus | shadcn-ui | 差异说明 |
+|------|---------|------|-------------|-----------|---------|
+| 表格 | `<Table columns data sortable onSort>` | Table | Table | Table | 列排序 + **行选择/筛选/列宽已实现**；虚拟表格待补 |
+| 卡片 | `<Card clickable hover padding>` | Card | Card | Card | clickable/hover 抬升/active 选中态 |
+| 标签 | `<Tag variant closable>` | Tag | Tag | Badge（variant） | closable 已支持 |
+| 徽标 | `<Badge variant dot>`（8px 状态点） | Badge | Badge | Badge | `dot` = 状态点 |
+| 列表 | `<List items renderItem empty>` | List | 手动 v-for | — | 通用列表 |
+| 时间线 | `<Timeline items status>` | Timeline | Timeline | — | 节点状态色 + 图标 |
+| 描述列表 | `<Descriptions items column bordered>`（dl/dt/dd 语义） | Descriptions | Descriptions | — | 等价 |
+| 统计卡片 | `<StatCard label value trend animate>` | Statistic | Statistic | — | 卡片形态 + 点击 + 动画 |
+| 图片 | `<Img src fallback lazy preview>` | Image | Image | — | **preview 点击放大已实现** |
+| 图表 | `<Chart type data>`（自研零依赖） | — | — | Chart（recharts 包装） | 自研 line/bar/pie，无运行时依赖 |
+| 骨架屏 | `<Skeleton variant count>` | Skeleton | Skeleton | Skeleton | 等价 |
+| 空状态 | `<EmptyState icon text hint>` | Empty | Empty | — | icon 用 emoji/Icon + 操作区 |
+| 结果页 | `<Result status title desc extra>` | Result | Result | — | 等价（success/error/warning/info） |
+| 搜索高亮 | `<Highlight text query>`（`<mark>` 分词） | — | — | — | weifuwu 独有（配 SearchInput/Table） |
+| 树 | `<Tree data checkable checkedKeys>` | Tree | Tree | — | 勾选父子联动 + indeterminate |
+| 级联 | `<Cascader options value>` | Cascader | Cascader | — | 多列面板逐级推进 |
+| 穿梭框 | `<Transfer data targetKeys>` | Transfer | Transfer | — | 双列表 + 移动；移动端自动堆叠 |
+| 月历 | `<Calendar month year events>` | Calendar | Calendar | — | 事件点 + 月切换 |
+| 虚拟列表 | `<VirtualList height itemHeight>` | — | — | — | spacer + 可见窗口，200 条只渲染 ~12 |
+
+## 反馈
+
+| 功能 | weifuwu | antd | Element Plus | shadcn-ui | 差异说明 |
+|------|---------|------|-------------|-----------|---------|
+| 提示条 | `<Alert variant closable>` | Alert | Alert | Alert | 等价 |
+| 模态框 | `<Modal open title onClose width>` | Modal | Dialog | Dialog | `open/onClose`（antd v5 同）；焦点 trap + 归还；移动端 bottom-sheet |
+| 确认框 | `<Confirm>` + `await confirm()` 命令式 | Popconfirm / Modal.confirm | Popconfirm / MessageBox | AlertDialog | 声明式 + 命令式双模式 |
+| 抽屉 | `<Drawer position="left\|right\|top\|bottom">` | Drawer | Drawer | Sheet / Drawer | **四方向覆盖 shadcn Sheet + Drawer**；移动端全宽 |
+| 气泡 | `<Popover position>`（视口夹紧） | Popover | Popover | Popover | 等价（usePopup：外部点击/Escape/tap 降级） |
+| 悬浮提示 | `<Tooltip content position>`（string） | Tooltip | Tooltip | Tooltip | usePopup：桌面 hover / 触屏 tap |
+| 悬停卡 | `<HoverCard content>`（富内容 + 延迟） | — | — | HoverCard | shadcn 对齐；触屏 tap |
+| 右键菜单 | `<ContextMenu items>` | Dropdown context | — | ContextMenu | 桌面右键 + **触屏长按**双通道 |
+| 消息 | `<Toast>` + `toast()` 命令式 | message | Message | Sonner | 命令式 `toast('已保存','success')` |
+| 通知 | `<Notification>` + `notification.success()` | notification | Notification | — | 队列式通知 |
+| 加载 | `<Loading>` | Spin | Loading | — | 等价 |
+| 进度条 | `<ProgressBar value>` | Progress | Progress | Progress | 等价（线性） |
+| 折叠 | `<Collapse items active>`（异步 loading + extra） | Collapse | Collapse | Collapse | 行内折叠（区别于 Accordion） |
+| 手风琴 | `<Accordion items>` | Collapse accordion | Collapse accordion | Accordion | 单开折叠 |
+| 复制按钮 | `<CopyButton value>`（clipboard + 降级 + 成功态） | — | — | — | Chat/CodeBlock 证据驱动 |
+| 水印 | `<Watermark text>`（canvas 平铺 + overlay） | Watermark | — | — | 自研 |
+| 二维码 | `<QRCode value>`（Reed-Solomon + 8 掩码） | QRCode | QRCode | — | **自研编码零依赖** |
+| 轮播 | `<Carousel autoplay>`（箭头/圆点/循环 + 触摸） | Carousel | Carousel | — | 触摸滑动 + 触屏命中区 |
+| 分割面板 | `<Resizable defaultSize>`（拖拽 + 键盘 + clamp） | Splitter | — | Resizable | 指针 + 方向键 |
+| 回到顶部按钮 | `<BackTop>` | FloatButton.BackTop | Backtop | — | 滚动监听 |
+
+## AI / 特色（三库无，weifuwu 独有）
+
+| 组件 | 说明 |
+|------|------|
+| `<AiChat>` | 完整 AI 对话界面（流式 token/工具卡/审批卡/自动滚动），配 `ctx.ui.useChat()`；移动端 `raiseOnKeyboard` |
+| `<Markdown content>` | 零依赖安全子集 parser（无 raw HTML 注入，VNode 渲染天然转义） |
+| `<CodeBlock code lang>` | 代码块 + 语言标签 + 复制按钮 |
+| `<MessageBubble role status>` | 聊天气泡（独立复用，AiChat 抽取） |
+| `<ToolCallCard>` | AI 工具调用状态机（running/ok/error） |
+| `<ApprovalCard>` | HITL 人工审批卡片（pending/approved/rejected/timeout） |
+| `<Editor>` | 富文本编辑器（contentEditable + 工具栏/表格/图片，零依赖） |
+| `<ThemeSwitch>` | 明暗主题切换（CSS 变量驱动，配 `data-theme`） |
+| `<InView>` | 交叉观察（进入视口触发，可做无限滚动） |
+| `<AspectRatio>` | 宽高比容器（内容填满） |
+| `<CopyButton>` | 复制（clipboard + execCommand 降级 + 成功状态机） |
+
+## 快速迁移路径（三库 → weifuwu）
+
+```tsx
+// antd / shadcn 开发者
+<Modal open={show} onClose={f}>…</Modal>          // antd v5 同命名，直接迁移
+<Select options={opts} value={v} onChange={f} />   // 同命名
+<Button variant="primary">保存</Button>            // antd type="primary" → variant
+
+// Element Plus 开发者（v-model 模板语法 → value/onChange）
+<Input :value="v" @input="f" />                    // → <Input value={v} onInput={f} />
+<ElDialog :visible="s" @close="f" />               // → <Modal open={s} onClose={f} />
+<ElMessage>成功</ElMessage>                        // → toast('成功','success')
+
+// shadcn 开发者（原子组合 → 成品）
+<Dialog><DialogTrigger/>…</Dialog>                 // → <Modal open onClose> 一体组件
+<Sheet><SheetTrigger/>…</Sheet>                    // → <Drawer position="bottom">
+<Badge variant="secondary">x</Badge>               // → <Tag variant="secondary">x</Tag>
+```
+
+## weifuwu 尚未实现（三库有）→ 待补清单
+
+仅 4 项：
+
+- **Anchor**（锚点导航，三库均有）
+- **Menu 子菜单/折叠**（分组 group 已支持，子级/折叠待补）
+- **FileUpload 增强**（拖拽已支持；文件列表/预览/进度待补）
+- **VirtualTable**（VirtualList 已有，表格虚拟化待补）
+
+> 难度阶梯（L1-L6）与验证的 client 能力点：见 `design/components-cdd.md`；三库 → weifuwu 覆盖矩阵：见 `design/components-migration.md`。