@fangxinyan/lumina 0.6.14 → 0.6.16

package/dist/index.d.cts

@@ -24,7 +24,10 @@ export { Alert, AlertProps, AlertTone } from './Alert.cjs';
 export { ExpandableConfig, PaginationConfig, RowKey, RowSelectionConfig, Table, TableColumn, TableColumnFilterItem, TableProps, TableScrollConfig, TableVariant } from './Table.cjs';
 export { TablePro, TableProProps } from './TablePro.cjs';
 export { Pagination, PaginationProps } from './Pagination.cjs';
+export { DatePicker, DatePickerFormat, DatePickerProps, DatePickerSize } from './DatePicker.cjs';
+export { DateTimePicker, DateTimePickerFormat, DateTimePickerProps, DateTimePickerSize } from './DateTimePicker.cjs';
 export { Calendar, CalendarProps } from './Calendar.cjs';
+export { TimePicker, TimePickerFormat, TimePickerProps, TimePickerSize, TimePickerValue } from './TimePicker.cjs';
 export { List, ListItem, ListProps } from './List.cjs';
 export { AppShell, AppShellProps, Sidebar, SidebarItem, SidebarProps, TitleBar, TitleBarProps, WindowControls, WindowControlsProps } from './AppShell.cjs';
 export { StatusBar, StatusBarItem, StatusBarItemProps, StatusBarProps } from './StatusBar.cjs';
@@ -49,6 +52,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.14";
+declare const VERSION = "0.6.16";
 
 export { VERSION };

package/dist/index.d.ts

@@ -24,7 +24,10 @@ export { Alert, AlertProps, AlertTone } from './Alert.js';
 export { ExpandableConfig, PaginationConfig, RowKey, RowSelectionConfig, Table, TableColumn, TableColumnFilterItem, TableProps, TableScrollConfig, TableVariant } from './Table.js';
 export { TablePro, TableProProps } from './TablePro.js';
 export { Pagination, PaginationProps } from './Pagination.js';
+export { DatePicker, DatePickerFormat, DatePickerProps, DatePickerSize } from './DatePicker.js';
+export { DateTimePicker, DateTimePickerFormat, DateTimePickerProps, DateTimePickerSize } from './DateTimePicker.js';
 export { Calendar, CalendarProps } from './Calendar.js';
+export { TimePicker, TimePickerFormat, TimePickerProps, TimePickerSize, TimePickerValue } from './TimePicker.js';
 export { List, ListItem, ListProps } from './List.js';
 export { AppShell, AppShellProps, Sidebar, SidebarItem, SidebarProps, TitleBar, TitleBarProps, WindowControls, WindowControlsProps } from './AppShell.js';
 export { StatusBar, StatusBarItem, StatusBarItemProps, StatusBarProps } from './StatusBar.js';
@@ -49,6 +52,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.14";
+declare const VERSION = "0.6.16";
 
 export { VERSION };

package/dist/index.js

@@ -1,8 +1,12 @@
-export { Tabs } from './chunk-ZTCRD2FL.js';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-3VSHGM54.js';
 export { Timeline } from './chunk-OTSDPQPV.js';
 export { Tooltip } from './chunk-MOZ52KN6.js';
 export { Link, Paragraph, Text, Title, Typography } from './chunk-6HF6UF73.js';
+export { TablePro } from './chunk-QNN3YV2P.js';
+export { Table } from './chunk-4YSGGZDB.js';
+export { Tabs } from './chunk-ZTCRD2FL.js';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-3VSHGM54.js';
+export { TimePicker } from './chunk-DU4VSUBF.js';
+export { Skeleton } from './chunk-R3DTXVP2.js';
 export { Slider } from './chunk-D7GK6H6V.js';
 export { Splitter } from './chunk-IZHH6CVY.js';
 export { StatusBar, StatusBarItem } from './chunk-TYLDISRK.js';
@@ -10,23 +14,22 @@ export { SURFACE_THEME_PRESETS, Surface } from './chunk-JFL2WMJZ.js';
 import './chunk-6SPMHY54.js';
 export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, FONT_STACKS, ThemeProvider, applyTheme, normalizeAccentInput, resolveThemeColorScheme, resolveThemeMode, useTheme, useThemeOptional } from './chunk-GNV6W4BN.js';
 export { Switch } from './chunk-PU7VXDAS.js';
-export { TablePro } from './chunk-QNN3YV2P.js';
-export { Table } from './chunk-4YSGGZDB.js';
+export { InputNumber } from './chunk-3VXGZ3SJ.js';
+export { List } from './chunk-YAFDVNXT.js';
 export { MessageContainer, ToastContainer, message, toast } from './chunk-P64NPZBG.js';
 export { Modal } from './chunk-BVQOJKRX.js';
 export { Pagination } from './chunk-6LC4QROE.js';
+export { Select } from './chunk-6PHPRZTT.js';
+export { Tag } from './chunk-6K5YI4ZE.js';
 export { Popover } from './chunk-I777JTTG.js';
 export { Progress } from './chunk-KMPFESEV.js';
 export { Radio, RadioGroup } from './chunk-KYV75JPQ.js';
-export { Select } from './chunk-6PHPRZTT.js';
-export { Tag } from './chunk-6K5YI4ZE.js';
-export { Skeleton } from './chunk-R3DTXVP2.js';
+export { DateTimePicker } from './chunk-YPE6CDXQ.js';
+export { Divider } from './chunk-HBO7ZDEQ.js';
 export { Drawer } from './chunk-WMGMIE2D.js';
 export { Empty } from './chunk-6MEOLYNQ.js';
 export { Form, FormItem, useForm } from './chunk-ZR4IMROK.js';
 export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-EQ4FPOQQ.js';
-export { InputNumber } from './chunk-3VXGZ3SJ.js';
-export { List } from './chunk-YAFDVNXT.js';
 export { Card } from './chunk-ARUPS7JH.js';
 export { Spin } from './chunk-FYSXJXNW.js';
 export { Cascader } from './chunk-4HJBF4GY.js';
@@ -35,7 +38,7 @@ export { Collapse } from './chunk-6LN4VVX7.js';
 export { ColorPicker } from './chunk-TJECLLN4.js';
 export { CommandPalette } from './chunk-5MOYKVB7.js';
 export { ContextMenu } from './chunk-AAPZLBHQ.js';
-export { Divider } from './chunk-HBO7ZDEQ.js';
+export { DatePicker } from './chunk-FKP5D5IS.js';
 export { Alert } from './chunk-A6O25EP2.js';
 export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-XCXUGHDF.js';
 export { AutoComplete } from './chunk-CFZVWY5N.js';
@@ -45,10 +48,10 @@ export { TextArea, Textarea } from './chunk-S7IHWY24.js';
 export { Avatar } from './chunk-RR2BKV65.js';
 export { Badge } from './chunk-DSLYWX4O.js';
 export { Button, IconButton } from './chunk-IPSNC5VZ.js';
-export { Calendar } from './chunk-XG5D777V.js';
+export { Calendar } from './chunk-I7TOBKJO.js';
 export { AimOutlined, AppstoreOutlined, BarChartOutlined, BlockOutlined, BorderOutlined, CameraOutlined, CaretDownOutlined, CaretUpOutlined, CheckCircleFilled, CheckCircleOutlined, CheckOutlined, ClockCircleFilled, CloseCircleOutlined, CloseOutlined, CopyOutlined, DashboardOutlined, DeleteOutlined, DownOutlined, EnvironmentOutlined, ExclamationCircleOutlined, FolderOpenOutlined, ICON_NAMES, Icon, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './chunk-FDZG27IG.js';
 
 // src/index.ts
-var VERSION = "0.6.14";
+var VERSION = "0.6.16";
 
 export { VERSION };

package/dist/styles.css

@@ -2568,6 +2568,249 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .skeleton-box .skeleton-row {
   display: block;
 }
+/* ============ DatePicker ============ */
+.date-picker {
+  position: relative;
+  display: inline-block;
+  width: 100%;
+  min-width: 180px;
+}
+.date-picker.disabled {
+  opacity: 0.55;
+  pointer-events: none;
+}
+.date-picker.readonly .input-wrap {
+  cursor: default;
+}
+.date-picker .input-wrap {
+  width: 100%;
+}
+.date-picker.open .input-wrap {
+  box-shadow: var(--neu-shadow-inset);
+}
+.date-picker-panel {
+  position: fixed;
+  z-index: 1000;
+  width: 344px;
+  padding: var(--gap-3);
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-float);
+  animation: menuIn var(--dur) var(--ease);
+}
+.date-picker-panel .calendar {
+  width: 100%;
+  padding: 0;
+  background: transparent;
+  box-shadow: none;
+}
+.date-picker-panel .calendar-head {
+  padding: 0 0 var(--gap-3);
+}
+.date-picker-footer {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-2);
+  margin-top: var(--gap-3);
+  padding-top: var(--gap-3);
+  border-top: 1px solid var(--divider);
+}
+.date-picker-footer-spacer {
+  flex: 1;
+  min-width: 0;
+}
+/* ============ DateTimePicker ============ */
+.date-time-picker {
+  position: relative;
+  display: inline-block;
+  width: 100%;
+  min-width: 220px;
+}
+.date-time-picker.disabled {
+  opacity: 0.55;
+  pointer-events: none;
+}
+.date-time-picker.readonly .input-wrap {
+  cursor: default;
+}
+.date-time-picker .input-wrap {
+  width: 100%;
+}
+.date-time-picker.open .input-wrap {
+  box-shadow: var(--neu-shadow-inset);
+}
+.date-time-picker-panel {
+  position: fixed;
+  z-index: 1000;
+  width: 476px;
+  padding: var(--gap-2) var(--gap-3);
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow:
+    0 calc(var(--shadow-offset) * 1.1) calc(var(--shadow-blur) * 1.3) color-mix(in oklch, var(--shadow-dark) 72%, transparent),
+    inset 0 0 0 1px var(--divider);
+  animation: menuIn var(--dur) var(--ease);
+}
+.date-time-picker-body {
+  display: grid;
+  grid-template-columns: 272px minmax(0, 168px);
+  gap: var(--gap-3);
+  align-items: start;
+}
+.date-time-picker-panel .calendar {
+  width: 100%;
+  padding: 0;
+  background: transparent;
+  box-shadow: none;
+}
+.date-time-picker-panel .calendar-head {
+  padding: 0 0 var(--gap-1);
+}
+.date-time-picker-panel .calendar-title {
+  padding: var(--gap-1) var(--gap-2);
+  font-size: var(--fs-sm);
+}
+.date-time-picker-panel .calendar-title-part {
+  padding: var(--gap-1) 6px;
+  font-size: var(--fs-sm);
+}
+.date-time-picker-panel .calendar-grid {
+  gap: 1px;
+  min-height: 222px;
+}
+.date-time-picker-panel .calendar-dow {
+  padding: var(--gap-1) 0;
+}
+.date-time-picker-panel .calendar-cell {
+  aspect-ratio: auto;
+  height: 32px;
+  font-size: var(--fs-xs);
+  border-radius: 7px;
+}
+.date-time-picker-panel .calendar-cell.today::after {
+  bottom: 3px;
+}
+.date-time-picker-panel .calendar-select-grid {
+  min-height: 222px;
+  gap: var(--gap-1);
+}
+.date-time-picker-panel .calendar-select-option {
+  height: 34px;
+  font-size: var(--fs-xs);
+}
+.date-time-picker-time {
+  min-width: 0;
+}
+.date-time-picker-time-columns {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  padding: 8px;
+  border-radius: var(--r-sm);
+  background: var(--bg);
+  box-shadow: inset 0 0 0 1px var(--divider);
+  overflow: hidden;
+}
+.date-time-picker-panel.without-second .date-time-picker-time-columns {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+.date-time-picker-time-column {
+  min-width: 0;
+}
+.date-time-picker-time-column + .date-time-picker-time-column {
+  border-left: 1px solid var(--divider);
+}
+.date-time-picker-time-label {
+  height: 20px;
+  display: grid;
+  place-items: center;
+  font-size: var(--fs-xs);
+  font-weight: 700;
+  color: var(--fg-muted);
+}
+.date-time-picker-time-list {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  height: 220px;
+  overflow-y: auto;
+  padding: calc((220px - 28px) / 2) 5px;
+  scroll-padding: calc((220px - 28px) / 2) 0;
+  scrollbar-width: none;
+  -webkit-mask-image: linear-gradient(to bottom, transparent 0, black 20px, black calc(100% - 20px), transparent 100%);
+  mask-image: linear-gradient(to bottom, transparent 0, black 20px, black calc(100% - 20px), transparent 100%);
+}
+.date-time-picker-time-list::-webkit-scrollbar {
+  width: 0;
+  height: 0;
+}
+.date-time-picker-time-option {
+  flex: 0 0 28px;
+  width: 100%;
+  height: 28px;
+  border: none;
+  border-radius: 7px;
+  background: transparent;
+  color: var(--fg);
+  cursor: pointer;
+  font: 600 var(--fs-md) var(--font-mono);
+  transition:
+    color var(--dur-fast) var(--ease),
+    background var(--dur-fast) var(--ease),
+    box-shadow var(--dur-fast) var(--ease);
+}
+.date-time-picker-time-option:hover:not(:disabled) {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-subtle);
+}
+.date-time-picker-time-option.selected {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-subtle);
+}
+.date-time-picker-time-option:disabled {
+  color: var(--fg-subtle);
+  cursor: not-allowed;
+  opacity: 0.45;
+}
+.date-time-picker-footer {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-2);
+  margin-top: var(--gap-2);
+  padding-top: var(--gap-2);
+  border-top: 1px solid var(--divider);
+}
+.date-time-picker-footer-spacer {
+  flex: 1;
+  min-width: 0;
+}
+.date-time-picker-footer .btn {
+  min-width: 54px;
+}
+@media (max-width: 640px) {
+  .date-time-picker-panel {
+    width: 332px;
+  }
+
+  .date-time-picker-body {
+    display: block;
+  }
+
+  .date-time-picker-time {
+    margin-top: var(--gap-3);
+  }
+
+  .date-time-picker-time-columns {
+    height: auto;
+  }
+
+  .date-time-picker-time-list {
+    height: 118px;
+    padding: calc((118px - 28px) / 2) 8px;
+    scroll-padding: calc((118px - 28px) / 2) 0;
+  }
+}
 /* ============ Calendar ============ */
 .calendar {
   background: var(--bg);
@@ -2589,6 +2832,36 @@ input, textarea, select { font-family: inherit; color: inherit; }
   transition: all var(--dur-fast) var(--ease);
 }
 .calendar-title:hover { background: var(--bg); box-shadow: var(--neu-shadow-subtle); }
+.calendar-title.static {
+  cursor: default;
+}
+.calendar-title.static:hover {
+  background: transparent;
+  box-shadow: none;
+}
+.calendar-title-group {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--gap-1);
+}
+.calendar-title-part {
+  border: none;
+  border-radius: var(--r-sm);
+  padding: 6px 8px;
+  background: transparent;
+  color: var(--fg);
+  cursor: pointer;
+  font: 600 14px var(--font-sans);
+  transition:
+    color var(--dur-fast) var(--ease),
+    background var(--dur-fast) var(--ease),
+    box-shadow var(--dur-fast) var(--ease);
+}
+.calendar-title-part:hover {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-subtle);
+}
 .calendar-grid {
   display: grid;
   grid-template-columns: repeat(7, 1fr);
@@ -2633,6 +2906,172 @@ input, textarea, select { font-family: inherit; color: inherit; }
 }
 .calendar-cell.disabled { color: var(--fg-subtle); opacity: 0.4; cursor: not-allowed; }
 .calendar-cell.disabled:hover { background: transparent; box-shadow: none; }
+.calendar-select-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: var(--gap-2);
+  min-height: 244px;
+  align-content: center;
+}
+.calendar-select-option {
+  height: 42px;
+  border: none;
+  border-radius: var(--r-sm);
+  background: transparent;
+  color: var(--fg);
+  cursor: pointer;
+  font: 600 var(--fs-md) var(--font-mono);
+  transition:
+    color var(--dur-fast) var(--ease),
+    background var(--dur-fast) var(--ease),
+    box-shadow var(--dur-fast) var(--ease);
+}
+.calendar-select-option:hover:not(:disabled) {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-subtle);
+}
+.calendar-select-option.selected {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-inset);
+}
+.calendar-select-option.disabled {
+  color: var(--fg-subtle);
+  cursor: not-allowed;
+  opacity: 0.4;
+}
+/* ============ TimePicker ============ */
+.time-picker {
+  position: relative;
+  display: inline-block;
+  width: 100%;
+  min-width: 180px;
+}
+.time-picker.disabled {
+  opacity: 0.55;
+  pointer-events: none;
+}
+.time-picker.readonly .input-wrap {
+  cursor: default;
+}
+.time-picker .input-wrap {
+  width: 100%;
+}
+.time-picker.open .input-wrap {
+  box-shadow: var(--neu-shadow-inset);
+}
+.time-picker-panel {
+  position: fixed;
+  z-index: 1000;
+  width: 300px;
+  padding: 10px;
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow:
+    0 calc(var(--shadow-offset) * 1.1) calc(var(--shadow-blur) * 1.3) color-mix(in oklch, var(--shadow-dark) 72%, transparent),
+    inset 0 0 0 1px var(--divider);
+  animation: menuIn var(--dur) var(--ease);
+}
+.time-picker-panel.without-second {
+  width: 228px;
+}
+.time-picker-columns {
+  position: relative;
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 0;
+  padding: 8px;
+  border-radius: var(--r-sm);
+  background: var(--bg);
+  box-shadow: inset 0 0 0 1px var(--divider);
+  overflow: hidden;
+}
+.time-picker-column + .time-picker-column {
+  border-left: 1px solid var(--divider);
+}
+.time-picker-panel.without-second .time-picker-columns {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+.time-picker-column {
+  min-width: 0;
+}
+.time-picker-column-label {
+  height: 22px;
+  position: relative;
+  z-index: 1;
+  display: grid;
+  place-items: center;
+  font-size: var(--fs-xs);
+  font-weight: 700;
+  color: var(--fg-muted);
+}
+.time-picker-list {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  height: 166px;
+  overflow-y: auto;
+  padding: calc((166px - 30px) / 2) 8px;
+  border-radius: 0;
+  background: transparent;
+  box-shadow: none;
+  scroll-padding: calc((166px - 30px) / 2) 0;
+  scrollbar-width: none;
+  -webkit-mask-image: linear-gradient(to bottom, transparent 0, black 24px, black calc(100% - 24px), transparent 100%);
+  mask-image: linear-gradient(to bottom, transparent 0, black 24px, black calc(100% - 24px), transparent 100%);
+}
+.time-picker-list::-webkit-scrollbar {
+  width: 0;
+  height: 0;
+}
+.time-picker-option {
+  position: relative;
+  z-index: 1;
+  flex: 0 0 30px;
+  width: 100%;
+  height: 30px;
+  border: none;
+  border-radius: 7px;
+  background: transparent;
+  color: var(--fg);
+  cursor: pointer;
+  font: 600 var(--fs-md) var(--font-mono);
+  transition:
+    color var(--dur-fast) var(--ease),
+    background var(--dur-fast) var(--ease),
+    box-shadow var(--dur-fast) var(--ease);
+}
+.time-picker-option:hover:not(:disabled) {
+  color: var(--accent-ink);
+  background: var(--bg);
+  box-shadow: var(--neu-shadow-subtle);
+}
+.time-picker-option.selected {
+  background: var(--bg);
+  color: var(--accent-ink);
+  box-shadow: var(--neu-shadow-subtle);
+}
+.time-picker-option:disabled {
+  color: var(--fg-subtle);
+  cursor: not-allowed;
+  opacity: 0.45;
+}
+.time-picker-footer {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-top: 8px;
+  padding: 8px 0 0;
+  border-top: 1px solid var(--divider);
+}
+.time-picker-footer-spacer {
+  flex: 1;
+  min-width: 0;
+}
+.time-picker-footer .btn {
+  min-width: 54px;
+}
 /* ============ Image ============ */
 .n-image {
   display: inline-block;

package/docs/llms/calendar.md

@@ -1,6 +1,6 @@
 # Calendar 日历
 
-> 查看与选择日期。
+> 查看与选择日期,支持快速切换年份和月份。
 
 ## 导入
 
@@ -35,6 +35,7 @@ import { Calendar } from "@fangxinyan/lumina";
 | Prop | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
 | value / defaultValue | `Date` | — | 受控/初始日期 |
+| viewDate | `Date` | — | 外部日期变化时同步可视月份 |
 | onChange | `(date: Date) => void` | — | 选择回调 |
 | min / max | `Date` | — | 可选范围 |
 | disabledDate | `(date: Date) => boolean` | — | 自定义禁用判断,返回 true 的日期不可选 |

package/docs/llms/datepicker.md

@@ -0,0 +1,69 @@
+# DatePicker 日期选择
+
+> 输入框触发的日期选择器,复用 Calendar 并支持范围、禁用日期和格式化。
+
+## 导入
+
+```tsx
+import { DatePicker } from "@fangxinyan/lumina";
+```
+
+## 示例
+
+### 基础用法
+
+```tsx
+<DatePicker defaultValue={new Date(2026, 4, 25)} />
+```
+
+### 受控
+
+value 使用 Date | null,onChange 同时返回 Date 和格式化字符串。
+
+```tsx
+const [date, setDate] = useState<Date | null>(new Date());
+<DatePicker value={date} onChange={setDate} allowClear />
+```
+
+### 限制范围
+
+min / max 与 disabledDate 会同步作用于 Calendar 单元格和手动输入。
+
+```tsx
+<DatePicker
+  value={workday}
+  onChange={setWorkday}
+  min={new Date(2026, 4, 1)}
+  max={new Date(2026, 4, 31)}
+  disabledDate={(date) => date.getDay() === 0 || date.getDay() === 6}
+/>
+```
+
+### 格式与尺寸
+
+```tsx
+<DatePicker size="sm" format="YYYY/MM/DD" />
+<DatePicker format="YYYY年MM月DD日" />
+<DatePicker size="lg" disabled />
+```
+
+## API
+
+**DatePicker**
+
+| Prop | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| value / defaultValue | `Date | null` | — | 受控/初始日期 |
+| onChange | `(date: Date | null, dateString: string) => void` | — | 选择或清空时触发 |
+| format | `"YYYY-MM-DD" | "YYYY/MM/DD" | "YYYY年MM月DD日" | ((date) => string)` | `"YYYY-MM-DD"` | 显示格式或自定义格式化函数 |
+| min / max | `Date` | — | 可选日期范围 |
+| disabledDate | `(date: Date) => boolean` | — | 自定义禁用日期 |
+| size | `"sm" | "md" | "lg"` | `"md"` | 输入框尺寸 |
+| allowClear | `boolean` | `false` | 允许清空 |
+| open / defaultOpen / onOpenChange | `—` | — | 受控浮层显隐 |
+| popupClassName / dropdownClassName | `string` | — | 浮层 className |
+| disabled / readOnly / invalid / placeholder | `—` | — | 常规输入状态 |
+
+
+---
+[← 回到索引](../llms.md)