vxui-react 1.3.2 → 1.3.3

package/README.en.md

@@ -1,10 +1,17 @@
-# VXUI React · v1.3.2
+# VXUI React · v1.3.3
 
 **Website**: [ui.vx.link](https://ui.vx.link)  |  **GitHub**: [tmplink/vxui_react](https://github.com/tmplink/vxui_react)  |  [中文](README.md)
 
 VXUI React is a general-purpose React UI component library designed for admin panels, ops dashboards, internal tools, and data-heavy interfaces.
 
-> **Tip**: An `llms.txt` file is provided in the root directory to help AI assistants (like ChatGPT or GitHub Copilot) quickly grasp the framework's API and structure.
+## 🚀 Changelog
+
+> **v1.3.3** — 2025-05
+> - Added [`llms.txt`](llms.txt) — AI knowledge base file for AI tools to read component documentation directly
+> - Bundle size optimization, removed redundant dependencies
+> - Fixed style compatibility issues across multiple components
+
+See full changelog at [GitHub Releases](https://github.com/tmplink/vxui_react/releases).
 
 The documentation follows the conventions of popular UI frameworks: installation first, then a minimal working example, then scenario-specific component code.
 
@@ -186,6 +193,26 @@ Use `useTheme()` at runtime to read the current theme or call `setTheme('ocean')
 - **Forms**: Input, Select, Checkbox, Radio, Textarea, Slider, Switch, NumberInput, TagInput, ColorPicker, DatePicker, FileUpload, Form, Rating
 - **Feedback**: Alert, AlertDialog, Toast, Progress, Skeleton, Spinner, Stepper, Timeline, EmptyState
 - **Overlay**: Dialog, Sheet, Popover, DropdownMenu, ContextMenu, Tooltip, HoverCard, CommandPalette, Menubar, NavigationMenu
+
+### Dialog Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| trigger | ReactNode | **required** | Element that triggers opening the dialog |
+| title | string | **required** | Dialog title |
+| description | string | — | Optional description below the title |
+| children | ReactNode | **required** | Dialog body content |
+| footer | ReactNode | — | Footer action area |
+| size | 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full' | 'md' | Width preset |
+| placement | 'center' \| 'top' \| 'right' \| 'bottom' \| 'left' \| 'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right' \| 'top-half' \| 'right-half' \| 'bottom-half' \| 'left-half' | 'center' | Screen position (desktop only) |
+| padding | 'none' \| 'sm' \| 'md' \| 'lg' | 'md' | Inner padding preset |
+| scrollable | boolean | true | Enable scroll when content overflows |
+| closable | boolean | true | Show close button (×) |
+| **fullscreen** | **boolean** | **false** | **Fullscreen mode: occupies the entire viewport, ideal for mobile devices** |
+| className | string | — | Additional CSS class |
+| defaultOpen | boolean | false | Whether the dialog is open by default |
+| open | boolean | — | Controlled open state |
+| onOpenChange | (open: boolean) => void | — | Open state change handler |
 - **Data Display**: Avatar, Table, Badge, Tabs, Accordion, TreeView, Carousel, Calendar
 - **Typography**: Heading, Text, Label, CodeBlock
 - **Mobile**: MobileShell, BottomNav, ActionSheet, MobileDrawer, MobileList

package/README.md

@@ -1,10 +1,17 @@
-# VXUI React · v1.3.2
+# VXUI React · v1.3.3
 
 **官网**：[ui.vx.link](https://ui.vx.link)  |  **GitHub**：[tmplink/vxui_react](https://github.com/tmplink/vxui_react)  |  [English](README.en.md)
 
 VXUI React 是一套适合后台、运营台、仪表盘和内部工具的通用 UI 组件库。
 
-> **提示**：根目录下提供了 `llms.txt`，供正在协助开发的 AI（如 ChatGPT、GitHub Copilot）快速读取并理解本项目的大纲与使用指南，欢迎查阅。
+## 🚀 更新公告
+
+> **v1.3.3** — 2025-05
+> - 新增 [`llms.txt`](llms.txt) — AI 知识库文件，AI 工具可直接读取以获取组件文档
+> - 包体积优化，移除了冗余依赖
+> - 修复了多个组件的样式兼容性问题
+
+查看完整更新日志请访问 [GitHub Releases](https://github.com/tmplink/vxui_react/releases)。
 
 文档内容现在按流行 UI 框架的写法组织：先给安装方式，再给最小可运行示例，最后给分场景的组件代码。
 
@@ -188,6 +195,26 @@ export function Root({ children }: { children: React.ReactNode }) {
 - **Forms**: Input、Select、Checkbox、Radio、Textarea、Slider、Switch、NumberInput、TagInput、ColorPicker、DatePicker、FileUpload、Form、Rating
 - **Feedback**: Alert、AlertDialog、Toast、Progress、Skeleton、Spinner、Stepper、Timeline、EmptyState
 - **Overlay**: Dialog、Sheet、Popover、DropdownMenu、ContextMenu、Tooltip、HoverCard、CommandPalette、Menubar、NavigationMenu
+
+### Dialog 属性
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| trigger | ReactNode | 必填 | 触发打开对话框的元素 |
+| title | string | 必填 | 对话框标题 |
+| description | string | — | 标题下方的描述文字 |
+| children | ReactNode | 必填 | 对话框内容 |
+| footer | ReactNode | — | 底部操作区 |
+| size | 'sm' \| 'md' \| 'lg' \| 'xl' \| 'full' | 'md' | 宽度预设 |
+| placement | 'center' \| 'top' \| 'right' \| 'bottom' \| 'left' \| 'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right' \| 'top-half' \| 'right-half' \| 'bottom-half' \| 'left-half' | 'center' | 屏幕位置（仅桌面端） |
+| padding | 'none' \| 'sm' \| 'md' \| 'lg' | 'md' | 内边距预设 |
+| scrollable | boolean | true | 内容溢出时是否可滚动 |
+| closable | boolean | true | 是否显示关闭按钮（×） |
+| **fullscreen** | **boolean** | **false** | **全屏模式：启用后对话框将占据整个视口，适用于移动设备** |
+| className | string | — | 额外 CSS 类名 |
+| defaultOpen | boolean | false | 默认是否打开 |
+| open | boolean | — | 受控打开状态 |
+| onOpenChange | (open: boolean) => void | — | 打开状态变化回调 |
 - **Data Display**: Avatar、Table、Badge、Tabs、Accordion、TreeView、Carousel、Calendar
 - **Typography**: Heading、Text、Label、CodeBlock
 - **Mobile**: MobileShell、BottomNav、ActionSheet、MobileDrawer、MobileList