vxui-react 1.3.6 → 1.3.8

package/README.en.md

@@ -1,4 +1,4 @@
-# VXUI React · v1.3.6
+# VXUI React · v1.3.8
 
 **Website**: [ui.vx.link](https://ui.vx.link)  |  **GitHub**: [tmplink/vxui_react](https://github.com/tmplink/vxui_react)  |  [中文](README.md)
 
@@ -6,12 +6,90 @@ VXUI React is a general-purpose React UI component library designed for admin pa
 
 ## 🚀 Changelog
 
+> **v1.3.8** — 2026-06
+> - Dialog: add onConfirm/onCancel/confirmLabel/cancelLabel/confirmVariant props, built-in confirm/cancel button support
+> - Remove AlertDialog component (merged into Dialog)
+> - Remove demo build config (vite.demo.config.ts)
+>
 > **v1.3.6** — 2025-05
 > - Update createPortal calls in components to support dialogContentRef as target element
 > - Update test cases, optimize user interaction simulation, enhance component availability verification
 
 See full changelog at [GitHub Releases](https://github.com/tmplink/vxui_react/releases).
 
+### v1.3.8 Migration Guide
+
+#### New Dialog Props
+
+v1.3.7 adds built-in confirm/cancel button support to [`Dialog`](src/components/Dialog.tsx):
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `onConfirm` | `() => void` | — | Callback when confirm button is clicked |
+| `onCancel` | `() => void` | — | Callback when cancel button is clicked |
+| `confirmLabel` | `string` | `'Confirm'` | Confirm button text |
+| `cancelLabel` | `string` | `'Cancel'` | Cancel button text |
+| `confirmVariant` | `'solid' \| 'danger'` | `'solid'` | Confirm button style variant |
+
+**Usage example:**
+
+```tsx
+import { Dialog, useToast } from 'vxui-react';
+
+function DeleteConfirm() {
+  const { push } = useToast();
+
+  return (
+    <Dialog
+      trigger={<Button variant="danger">Delete Project</Button>}
+      title="Confirm Deletion"
+      description="This action cannot be undone."
+      onConfirm={() => {
+        // Execute delete logic
+        push({ tone: 'success', title: 'Deleted' });
+      }}
+      onCancel={() => {}}
+      confirmLabel="Delete"
+      cancelLabel="Cancel"
+      confirmVariant="danger"
+    >
+      <p>All related data will be permanently removed.</p>
+    </Dialog>
+  );
+}
+```
+
+#### AlertDialog Removal
+
+v1.3.7 removes the standalone `AlertDialog` component. Use Dialog with `confirmVariant="danger"` for destructive actions:
+
+**Before (v1.3.6):**
+```tsx
+import { AlertDialog } from 'vxui-react';
+
+<AlertDialog
+  trigger={<Button variant="danger">Delete</Button>}
+  title="Confirm Delete"
+  onConfirm={() => {}}
+/>
+```
+
+**After (v1.3.7):**
+```tsx
+import { Dialog, Button } from 'vxui-react';
+
+<Dialog
+  trigger={<Button variant="danger">Delete</Button>}
+  title="Confirm Delete"
+  confirmVariant="danger"
+  onConfirm={() => {}}
+/>
+```
+
+#### Demo Build Config Removal
+
+`vite.demo.config.ts` has been removed. Use `npm run dev` to run the demo site.
+
 The documentation follows the conventions of popular UI frameworks: installation first, then a minimal working example, then scenario-specific component code.
 
 ## Installation
@@ -232,6 +310,4 @@ npm run typecheck
 # Build component library (for npm publish)
 npm run build
 
-# Build demo site (for Pages deployment, output to dist-demo/)
-npm run build:demo
 ```

package/README.md

@@ -1,4 +1,4 @@
-# VXUI React · v1.3.6
+# VXUI React · v1.3.8
 
 **官网**：[ui.vx.link](https://ui.vx.link)  |  **GitHub**：[tmplink/vxui_react](https://github.com/tmplink/vxui_react)  |  [English](README.en.md)
 
@@ -6,12 +6,92 @@ VXUI React 是一套适合后台、运营台、仪表盘和内部工具的通用
 
 ## 🚀 更新公告
 
+> **v1.3.8** — 2026-06
+> - Dialog: 新增 onConfirm/onCancel/confirmLabel/cancelLabel/confirmVariant 属性，内置确认/取消按钮支持
+> - 移除 AlertDialog 独立组件，功能已合并至 Dialog
+> - 移除 demo 构建配置 (vite.demo.config.ts)
+>
 > **v1.3.6** — 2025-05
 > - 优化组件中的 createPortal 调用，支持使用 dialogContentRef 作为目标元素
 > - 更新测试用例，优化用户交互模拟，增强组件可用性验证
 
 查看完整更新日志请访问 [GitHub Releases](https://github.com/tmplink/vxui_react/releases)。
 
+### v1.3.8 适配指南
+
+#### Dialog 组件新增属性
+
+v1.3.7 为 [`Dialog`](src/components/Dialog.tsx) 组件新增了内置确认/取消按钮支持，无需再手动实现：
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `onConfirm` | `() => void` | — | 点击确认按钮时的回调 |
+| `onCancel` | `() => void` | — | 点击取消按钮时的回调 |
+| `confirmLabel` | `string` | `'确认'` | 确认按钮文本 |
+| `cancelLabel` | `string` | `'取消'` | 取消按钮文本 |
+| `confirmVariant` | `'solid' \| 'danger'` | `'solid'` | 确认按钮样式变体 |
+
+**使用示例：**
+
+```tsx
+import { Dialog, useToast } from 'vxui-react';
+
+function DeleteConfirm() {
+  const { push } = useToast();
+
+  return (
+    <Dialog
+      trigger={<Button variant="danger">删除项目</Button>}
+      title="确认删除"
+      description="此操作不可撤销，确定要继续吗？"
+      onConfirm={() => {
+        // 执行删除逻辑
+        push({ tone: 'success', title: '已删除' });
+      }}
+      onCancel={() => {
+        // 取消逻辑
+      }}
+      confirmLabel="确认删除"
+      cancelLabel="暂不删除"
+      confirmVariant="danger"
+    >
+      <p>删除后所有相关数据将被永久移除。</p>
+    </Dialog>
+  );
+}
+```
+
+#### AlertDialog 移除
+
+v1.3.7 移除了独立的 `AlertDialog` 组件。如需危险操作确认对话框，请使用 Dialog 的 `confirmVariant="danger"`：
+
+**迁移前（v1.3.6）：**
+```tsx
+import { AlertDialog } from 'vxui-react';
+
+<AlertDialog
+  trigger={<Button variant="danger">删除</Button>}
+  title="确认删除"
+  onConfirm={() => {}}
+/>
+```
+
+**迁移后（v1.3.7）：**
+```tsx
+import { Dialog, Button } from 'vxui-react';
+
+<Dialog
+  trigger={<Button variant="danger">删除</Button>}
+  title="确认删除"
+  confirmVariant="danger"
+  onConfirm={() => {}}
+/>
+```
+
+#### demo 构建配置移除
+
+`vite.demo.config.ts` 已从项目中移除。如需运行演示站点，使用标准的 `npm run dev` 命令即可。
+
 文档内容现在按流行 UI 框架的写法组织：先给安装方式，再给最小可运行示例，最后给分场景的组件代码。
 
 ## 安装
@@ -234,6 +314,4 @@ npm run typecheck
 # 构建组件库（用于 npm publish）
 npm run build
 
-# 构建演示站（用于 Pages 部署，输出至 dist-demo/）
-npm run build:demo
 ```