@fangxinyan/lumina 0.9.4 → 0.9.5

package/dist/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
 var chunkRXITGNPX_cjs = require('./chunk-RXITGNPX.cjs');
-var chunkXHKSUKKL_cjs = require('./chunk-XHKSUKKL.cjs');
-var chunk3D5RJA7R_cjs = require('./chunk-3D5RJA7R.cjs');
-var chunkV6DY7J2Z_cjs = require('./chunk-V6DY7J2Z.cjs');
-var chunkG5ENSJBS_cjs = require('./chunk-G5ENSJBS.cjs');
+var chunkLQKP7MEA_cjs = require('./chunk-LQKP7MEA.cjs');
+var chunkUOXJH4AR_cjs = require('./chunk-UOXJH4AR.cjs');
+var chunkJNDATLOY_cjs = require('./chunk-JNDATLOY.cjs');
+var chunkD5HLHN5N_cjs = require('./chunk-D5HLHN5N.cjs');
 var chunkAEY76EAH_cjs = require('./chunk-AEY76EAH.cjs');
 require('./chunk-HYJSMFZA.cjs');
-var chunkAQN3PD24_cjs = require('./chunk-AQN3PD24.cjs');
-var chunkZT7ZWAF2_cjs = require('./chunk-ZT7ZWAF2.cjs');
+var chunkLDZCDOMW_cjs = require('./chunk-LDZCDOMW.cjs');
+var chunk5OQB5UUT_cjs = require('./chunk-5OQB5UUT.cjs');
 var chunkRA5BULQ3_cjs = require('./chunk-RA5BULQ3.cjs');
 var chunkZBRFGD3I_cjs = require('./chunk-ZBRFGD3I.cjs');
 var chunkMV56FOAD_cjs = require('./chunk-MV56FOAD.cjs');
@@ -18,37 +18,37 @@ var chunkG5LCOBOT_cjs = require('./chunk-G5LCOBOT.cjs');
 var chunkUQF7E32V_cjs = require('./chunk-UQF7E32V.cjs');
 var chunk6WEXRX7K_cjs = require('./chunk-6WEXRX7K.cjs');
 var chunkZ6AG7O4B_cjs = require('./chunk-Z6AG7O4B.cjs');
-var chunkTPFY5SKB_cjs = require('./chunk-TPFY5SKB.cjs');
-var chunkSOAGRYM3_cjs = require('./chunk-SOAGRYM3.cjs');
-var chunkA5MLLFKT_cjs = require('./chunk-A5MLLFKT.cjs');
-var chunk562P5YMO_cjs = require('./chunk-562P5YMO.cjs');
+var chunkL6ELDWUX_cjs = require('./chunk-L6ELDWUX.cjs');
+var chunkZNSTIRSE_cjs = require('./chunk-ZNSTIRSE.cjs');
+var chunk757JNNLH_cjs = require('./chunk-757JNNLH.cjs');
+var chunkXPFAAATJ_cjs = require('./chunk-XPFAAATJ.cjs');
 var chunkVNP5WB6M_cjs = require('./chunk-VNP5WB6M.cjs');
-var chunk3J7HOTD6_cjs = require('./chunk-3J7HOTD6.cjs');
+var chunkBCQIVYL6_cjs = require('./chunk-BCQIVYL6.cjs');
 var chunkPYCAGTO7_cjs = require('./chunk-PYCAGTO7.cjs');
 var chunkQTMI4ZA4_cjs = require('./chunk-QTMI4ZA4.cjs');
-var chunk7IWUBBYX_cjs = require('./chunk-7IWUBBYX.cjs');
+var chunkHPNZDAXF_cjs = require('./chunk-HPNZDAXF.cjs');
 var chunk76CTKBXD_cjs = require('./chunk-76CTKBXD.cjs');
-var chunk7ZMUCSCJ_cjs = require('./chunk-7ZMUCSCJ.cjs');
+var chunkM4GXFACD_cjs = require('./chunk-M4GXFACD.cjs');
 var chunk4LYJRFD2_cjs = require('./chunk-4LYJRFD2.cjs');
-var chunkZGZLEJKA_cjs = require('./chunk-ZGZLEJKA.cjs');
-var chunk4ZSFMWLF_cjs = require('./chunk-4ZSFMWLF.cjs');
+var chunkQV4SPR4Z_cjs = require('./chunk-QV4SPR4Z.cjs');
+var chunkBM2J5QAE_cjs = require('./chunk-BM2J5QAE.cjs');
 var chunkZCAYS4KR_cjs = require('./chunk-ZCAYS4KR.cjs');
 var chunkTTRU4TLQ_cjs = require('./chunk-TTRU4TLQ.cjs');
-var chunkAE5XWZ24_cjs = require('./chunk-AE5XWZ24.cjs');
+var chunk5PGRAEGA_cjs = require('./chunk-5PGRAEGA.cjs');
 var chunkKPBZKHCS_cjs = require('./chunk-KPBZKHCS.cjs');
 var chunk33YRXHVK_cjs = require('./chunk-33YRXHVK.cjs');
-var chunkHJGPUE67_cjs = require('./chunk-HJGPUE67.cjs');
-var chunkRWM44VCZ_cjs = require('./chunk-RWM44VCZ.cjs');
-var chunkQI6BJJXM_cjs = require('./chunk-QI6BJJXM.cjs');
-var chunkGW77XQEF_cjs = require('./chunk-GW77XQEF.cjs');
-require('./chunk-35RCCUGO.cjs');
+var chunkNALBGFHY_cjs = require('./chunk-NALBGFHY.cjs');
+var chunkOA3O5S7X_cjs = require('./chunk-OA3O5S7X.cjs');
+var chunkU5B2JLNE_cjs = require('./chunk-U5B2JLNE.cjs');
+var chunk73IEJLSD_cjs = require('./chunk-73IEJLSD.cjs');
+require('./chunk-ELKGV3NA.cjs');
 var chunk2XDLXAZT_cjs = require('./chunk-2XDLXAZT.cjs');
 var chunkADPXWCTK_cjs = require('./chunk-ADPXWCTK.cjs');
-var chunkAR3MT2ZT_cjs = require('./chunk-AR3MT2ZT.cjs');
-require('./chunk-FJB3243S.cjs');
+var chunkIM47JR57_cjs = require('./chunk-IM47JR57.cjs');
+require('./chunk-6A5KEWVU.cjs');
 var chunkGFGMGJ5A_cjs = require('./chunk-GFGMGJ5A.cjs');
 var chunkCNV7R2OZ_cjs = require('./chunk-CNV7R2OZ.cjs');
-require('./chunk-HSDMJUB6.cjs');
+require('./chunk-BN44QG2B.cjs');
 var chunk53I3PWRH_cjs = require('./chunk-53I3PWRH.cjs');
 var chunkOBNGHJ3N_cjs = require('./chunk-OBNGHJ3N.cjs');
 var chunkM3JYP3V4_cjs = require('./chunk-M3JYP3V4.cjs');
@@ -58,7 +58,7 @@ require('./chunk-V6BLBIY6.cjs');
 var chunkI4GJZLJU_cjs = require('./chunk-I4GJZLJU.cjs');
 
 // src/index.ts
-var VERSION = "0.9.4";
+var VERSION = "0.9.5";
 
 Object.defineProperty(exports, "Timeline", {
   enumerable: true,
@@ -66,35 +66,35 @@ Object.defineProperty(exports, "Timeline", {
 });
 Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
-  get: function () { return chunkXHKSUKKL_cjs.Tooltip; }
+  get: function () { return chunkLQKP7MEA_cjs.Tooltip; }
 });
 Object.defineProperty(exports, "Link", {
   enumerable: true,
-  get: function () { return chunk3D5RJA7R_cjs.Link; }
+  get: function () { return chunkUOXJH4AR_cjs.Link; }
 });
 Object.defineProperty(exports, "Paragraph", {
   enumerable: true,
-  get: function () { return chunk3D5RJA7R_cjs.Paragraph; }
+  get: function () { return chunkUOXJH4AR_cjs.Paragraph; }
 });
 Object.defineProperty(exports, "Text", {
   enumerable: true,
-  get: function () { return chunk3D5RJA7R_cjs.Text; }
+  get: function () { return chunkUOXJH4AR_cjs.Text; }
 });
 Object.defineProperty(exports, "Title", {
   enumerable: true,
-  get: function () { return chunk3D5RJA7R_cjs.Title; }
+  get: function () { return chunkUOXJH4AR_cjs.Title; }
 });
 Object.defineProperty(exports, "Typography", {
   enumerable: true,
-  get: function () { return chunk3D5RJA7R_cjs.Typography; }
+  get: function () { return chunkUOXJH4AR_cjs.Typography; }
 });
 Object.defineProperty(exports, "TablePro", {
   enumerable: true,
-  get: function () { return chunkV6DY7J2Z_cjs.TablePro; }
+  get: function () { return chunkJNDATLOY_cjs.TablePro; }
 });
 Object.defineProperty(exports, "Table", {
   enumerable: true,
-  get: function () { return chunkG5ENSJBS_cjs.Table; }
+  get: function () { return chunkD5HLHN5N_cjs.Table; }
 });
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
@@ -102,19 +102,19 @@ Object.defineProperty(exports, "Tabs", {
 });
 Object.defineProperty(exports, "THEME_PANEL_DEFAULT_PRESET_OPTIONS", {
   enumerable: true,
-  get: function () { return chunkAQN3PD24_cjs.THEME_PANEL_DEFAULT_PRESET_OPTIONS; }
+  get: function () { return chunkLDZCDOMW_cjs.THEME_PANEL_DEFAULT_PRESET_OPTIONS; }
 });
 Object.defineProperty(exports, "THEME_PANEL_DEFAULT_THEME_PRESETS", {
   enumerable: true,
-  get: function () { return chunkAQN3PD24_cjs.THEME_PANEL_DEFAULT_THEME_PRESETS; }
+  get: function () { return chunkLDZCDOMW_cjs.THEME_PANEL_DEFAULT_THEME_PRESETS; }
 });
 Object.defineProperty(exports, "ThemePanel", {
   enumerable: true,
-  get: function () { return chunkAQN3PD24_cjs.ThemePanel; }
+  get: function () { return chunkLDZCDOMW_cjs.ThemePanel; }
 });
 Object.defineProperty(exports, "TimePicker", {
   enumerable: true,
-  get: function () { return chunkZT7ZWAF2_cjs.TimePicker; }
+  get: function () { return chunk5OQB5UUT_cjs.TimePicker; }
 });
 Object.defineProperty(exports, "Skeleton", {
   enumerable: true,
@@ -170,31 +170,31 @@ Object.defineProperty(exports, "List", {
 });
 Object.defineProperty(exports, "MessageContainer", {
   enumerable: true,
-  get: function () { return chunkTPFY5SKB_cjs.MessageContainer; }
+  get: function () { return chunkL6ELDWUX_cjs.MessageContainer; }
 });
 Object.defineProperty(exports, "ToastContainer", {
   enumerable: true,
-  get: function () { return chunkTPFY5SKB_cjs.ToastContainer; }
+  get: function () { return chunkL6ELDWUX_cjs.ToastContainer; }
 });
 Object.defineProperty(exports, "message", {
   enumerable: true,
-  get: function () { return chunkTPFY5SKB_cjs.message; }
+  get: function () { return chunkL6ELDWUX_cjs.message; }
 });
 Object.defineProperty(exports, "toast", {
   enumerable: true,
-  get: function () { return chunkTPFY5SKB_cjs.toast; }
+  get: function () { return chunkL6ELDWUX_cjs.toast; }
 });
 Object.defineProperty(exports, "Modal", {
   enumerable: true,
-  get: function () { return chunkSOAGRYM3_cjs.Modal; }
+  get: function () { return chunkZNSTIRSE_cjs.Modal; }
 });
 Object.defineProperty(exports, "Pagination", {
   enumerable: true,
-  get: function () { return chunkA5MLLFKT_cjs.Pagination; }
+  get: function () { return chunk757JNNLH_cjs.Pagination; }
 });
 Object.defineProperty(exports, "Select", {
   enumerable: true,
-  get: function () { return chunk562P5YMO_cjs.Select; }
+  get: function () { return chunkXPFAAATJ_cjs.Select; }
 });
 Object.defineProperty(exports, "Tag", {
   enumerable: true,
@@ -202,7 +202,7 @@ Object.defineProperty(exports, "Tag", {
 });
 Object.defineProperty(exports, "Popover", {
   enumerable: true,
-  get: function () { return chunk3J7HOTD6_cjs.Popover; }
+  get: function () { return chunkBCQIVYL6_cjs.Popover; }
 });
 Object.defineProperty(exports, "Progress", {
   enumerable: true,
@@ -218,7 +218,7 @@ Object.defineProperty(exports, "RadioGroup", {
 });
 Object.defineProperty(exports, "DateTimePicker", {
   enumerable: true,
-  get: function () { return chunk7IWUBBYX_cjs.DateTimePicker; }
+  get: function () { return chunkHPNZDAXF_cjs.DateTimePicker; }
 });
 Object.defineProperty(exports, "Divider", {
   enumerable: true,
@@ -226,7 +226,7 @@ Object.defineProperty(exports, "Divider", {
 });
 Object.defineProperty(exports, "Drawer", {
   enumerable: true,
-  get: function () { return chunk7ZMUCSCJ_cjs.Drawer; }
+  get: function () { return chunkM4GXFACD_cjs.Drawer; }
 });
 Object.defineProperty(exports, "Empty", {
   enumerable: true,
@@ -234,31 +234,31 @@ Object.defineProperty(exports, "Empty", {
 });
 Object.defineProperty(exports, "Form", {
   enumerable: true,
-  get: function () { return chunkZGZLEJKA_cjs.Form; }
+  get: function () { return chunkQV4SPR4Z_cjs.Form; }
 });
 Object.defineProperty(exports, "FormItem", {
   enumerable: true,
-  get: function () { return chunkZGZLEJKA_cjs.FormItem; }
+  get: function () { return chunkQV4SPR4Z_cjs.FormItem; }
 });
 Object.defineProperty(exports, "useForm", {
   enumerable: true,
-  get: function () { return chunkZGZLEJKA_cjs.useForm; }
+  get: function () { return chunkQV4SPR4Z_cjs.useForm; }
 });
 Object.defineProperty(exports, "Image", {
   enumerable: true,
-  get: function () { return chunk4ZSFMWLF_cjs.Image; }
+  get: function () { return chunkBM2J5QAE_cjs.Image; }
 });
 Object.defineProperty(exports, "ImageGrid", {
   enumerable: true,
-  get: function () { return chunk4ZSFMWLF_cjs.ImageGrid; }
+  get: function () { return chunkBM2J5QAE_cjs.ImageGrid; }
 });
 Object.defineProperty(exports, "LayeredImage", {
   enumerable: true,
-  get: function () { return chunk4ZSFMWLF_cjs.LayeredImage; }
+  get: function () { return chunkBM2J5QAE_cjs.LayeredImage; }
 });
 Object.defineProperty(exports, "SpriteImage", {
   enumerable: true,
-  get: function () { return chunk4ZSFMWLF_cjs.SpriteImage; }
+  get: function () { return chunkBM2J5QAE_cjs.SpriteImage; }
 });
 Object.defineProperty(exports, "Card", {
   enumerable: true,
@@ -270,7 +270,7 @@ Object.defineProperty(exports, "Spin", {
 });
 Object.defineProperty(exports, "Cascader", {
   enumerable: true,
-  get: function () { return chunkAE5XWZ24_cjs.Cascader; }
+  get: function () { return chunk5PGRAEGA_cjs.Cascader; }
 });
 Object.defineProperty(exports, "Checkbox", {
   enumerable: true,
@@ -282,19 +282,19 @@ Object.defineProperty(exports, "Collapse", {
 });
 Object.defineProperty(exports, "ColorPicker", {
   enumerable: true,
-  get: function () { return chunkHJGPUE67_cjs.ColorPicker; }
+  get: function () { return chunkNALBGFHY_cjs.ColorPicker; }
 });
 Object.defineProperty(exports, "CommandPalette", {
   enumerable: true,
-  get: function () { return chunkRWM44VCZ_cjs.CommandPalette; }
+  get: function () { return chunkOA3O5S7X_cjs.CommandPalette; }
 });
 Object.defineProperty(exports, "ContextMenu", {
   enumerable: true,
-  get: function () { return chunkQI6BJJXM_cjs.ContextMenu; }
+  get: function () { return chunkU5B2JLNE_cjs.ContextMenu; }
 });
 Object.defineProperty(exports, "DatePicker", {
   enumerable: true,
-  get: function () { return chunkGW77XQEF_cjs.DatePicker; }
+  get: function () { return chunk73IEJLSD_cjs.DatePicker; }
 });
 Object.defineProperty(exports, "Alert", {
   enumerable: true,
@@ -318,7 +318,7 @@ Object.defineProperty(exports, "WindowControls", {
 });
 Object.defineProperty(exports, "AutoComplete", {
   enumerable: true,
-  get: function () { return chunkAR3MT2ZT_cjs.AutoComplete; }
+  get: function () { return chunkIM47JR57_cjs.AutoComplete; }
 });
 Object.defineProperty(exports, "Input", {
   enumerable: true,

package/dist/index.d.cts

@@ -54,6 +54,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.9.4";
+declare const VERSION = "0.9.5";
 
 export { VERSION };

package/dist/index.d.ts

@@ -54,6 +54,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.9.4";
+declare const VERSION = "0.9.5";
 
 export { VERSION };

package/dist/index.js

@@ -1,12 +1,12 @@
 export { Timeline } from './chunk-U7V2FOIM.js';
-export { Tooltip } from './chunk-TALNKJQ2.js';
-export { Link, Paragraph, Text, Title, Typography } from './chunk-2COQYOVG.js';
-export { TablePro } from './chunk-T422LYTL.js';
-export { Table } from './chunk-QITKDNCX.js';
+export { Tooltip } from './chunk-WOE73NDO.js';
+export { Link, Paragraph, Text, Title, Typography } from './chunk-QVDW32F2.js';
+export { TablePro } from './chunk-PK5ZMOW6.js';
+export { Table } from './chunk-S6KPLYLT.js';
 export { Tabs } from './chunk-4JANYBXO.js';
 import './chunk-EE7IJ3MB.js';
-export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-IU6PLLEL.js';
-export { TimePicker } from './chunk-SXT672KF.js';
+export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-MAXOCM5I.js';
+export { TimePicker } from './chunk-ZP4ROQEZ.js';
 export { Skeleton } from './chunk-MFJHI472.js';
 export { Slider } from './chunk-Y3WFWA52.js';
 export { Splitter } from './chunk-J7D5CQDK.js';
@@ -16,37 +16,37 @@ export { LUMINA_THEME_PRESETS, cloneLuminaThemePreset, pickLuminaThemePresets }
 export { Switch } from './chunk-O6PRE6MZ.js';
 export { InputNumber } from './chunk-RYF5ADJW.js';
 export { List } from './chunk-LACXN5CI.js';
-export { MessageContainer, ToastContainer, message, toast } from './chunk-2V6RQQRI.js';
-export { Modal } from './chunk-RJCPXAZ3.js';
-export { Pagination } from './chunk-3SUMCW2F.js';
-export { Select } from './chunk-OKGODC5A.js';
+export { MessageContainer, ToastContainer, message, toast } from './chunk-G4E5QA2M.js';
+export { Modal } from './chunk-XXCKQSWD.js';
+export { Pagination } from './chunk-6EHKQDMX.js';
+export { Select } from './chunk-ROCX6JDG.js';
 export { Tag } from './chunk-OGMI3TO5.js';
-export { Popover } from './chunk-A34P5CU7.js';
+export { Popover } from './chunk-KJG44Z5J.js';
 export { Progress } from './chunk-BOBT7JUB.js';
 export { Radio, RadioGroup } from './chunk-D2N7OXMK.js';
-export { DateTimePicker } from './chunk-MKVONDTB.js';
+export { DateTimePicker } from './chunk-G62HAXAL.js';
 export { Divider } from './chunk-ISK2RW7F.js';
-export { Drawer } from './chunk-BDPJ2BPN.js';
+export { Drawer } from './chunk-QS4GORDY.js';
 export { Empty } from './chunk-KFCWDFBW.js';
-export { Form, FormItem, useForm } from './chunk-INCTDROH.js';
-export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-QK3E6FAQ.js';
+export { Form, FormItem, useForm } from './chunk-XX7YYKIJ.js';
+export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-K4P45V67.js';
 export { Card } from './chunk-7NKNQRK6.js';
 export { Spin } from './chunk-L2NEYHYG.js';
-export { Cascader } from './chunk-CFKAKB2B.js';
+export { Cascader } from './chunk-UNUFUTFQ.js';
 export { Checkbox } from './chunk-QSLXUNLM.js';
 export { Collapse } from './chunk-XFJTJVWD.js';
-export { ColorPicker } from './chunk-MEBAE7DB.js';
-export { CommandPalette } from './chunk-7PUYEPLK.js';
-export { ContextMenu } from './chunk-TNQJA5JF.js';
-export { DatePicker } from './chunk-DQMG4XPX.js';
-import './chunk-RC6ULCQP.js';
+export { ColorPicker } from './chunk-AEMDX4S7.js';
+export { CommandPalette } from './chunk-4K6PQCWU.js';
+export { ContextMenu } from './chunk-7QKSXVN3.js';
+export { DatePicker } from './chunk-VSIBZ7VH.js';
+import './chunk-SW3KEFIA.js';
 export { Alert } from './chunk-5VLANZAJ.js';
 export { AppShell, Sidebar, TitleBar, WindowControls } from './chunk-2NXLVPF4.js';
-export { AutoComplete } from './chunk-Z7GKR4LL.js';
-import './chunk-3QXP2ZNP.js';
+export { AutoComplete } from './chunk-5PDEOGFV.js';
+import './chunk-NKIXCDZC.js';
 export { Input, InputPassword } from './chunk-TUXF2G2O.js';
 export { TextArea, Textarea } from './chunk-AXZNZ2IH.js';
-import './chunk-2A4GYSN4.js';
+import './chunk-BZB45GGK.js';
 export { Avatar } from './chunk-6OVWY63D.js';
 export { Badge } from './chunk-427CDZDU.js';
 export { Button, IconButton } from './chunk-563SQXH7.js';
@@ -56,6 +56,6 @@ import './chunk-5HLNFDV4.js';
 export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, DEFAULT_THEME_COLORS, FONT_STACKS, ThemeProvider, applyTheme, componentTokensToStyle, deriveThemeColors, normalizeAccentInput, resolveThemeColorScheme, resolveThemeColors, resolveThemeMode, resolveVisualThemeSnapshot, themeColorsToStyle, themeTokenToKebabCase, useTheme, useThemeOptional, visualThemeToStyle } from './chunk-CPVUDSIY.js';
 
 // src/index.ts
-var VERSION = "0.9.4";
+var VERSION = "0.9.5";
 
 export { VERSION };

package/docs/llms/datepicker.md

@@ -16,6 +16,31 @@ import { DatePicker } from "@fangxinyan/lumina";
 <DatePicker defaultValue={new Date(2026, 4, 25)} />
 ```
 
+### 关闭与焦点归还
+
+确定、选中日期、今天、清空或 Esc 关闭后，焦点回到输入框并保持关闭。可重复点击、按 Enter / ↓ 或通过 Tab 重新进入；点击外部控件后焦点留在该控件。
+
+```tsx
+<DatePicker defaultValue={new Date(2027, 6, 7)} allowClear />
+```
+
+### 弹窗内受控日期与显隐
+
+value 与 open 分别受控。关闭日期浮层后可继续键盘操作，再按 Esc 关闭父弹窗。
+
+```tsx
+const [date, setDate] = useState<Date | null>(new Date());
+const [modalOpen, setModalOpen] = useState(false);
+const [open, setOpen] = useState(false);
+<>
+  <Button onClick={() => setModalOpen(true)}>打开日期表单</Button>
+  <Modal open={modalOpen} title="日期表单" footer={null}
+    onCancel={() => { setModalOpen(false); setOpen(false); }}>
+    <DatePicker value={date} onChange={setDate} open={open} onOpenChange={setOpen} allowClear />
+  </Modal>
+</>
+```
+
 ### 受控
 
 value 使用 Date | null,onChange 同时返回 Date 和格式化字符串。
@@ -67,7 +92,7 @@ min / max 与 disabledDate 会同步作用于 Calendar 单元格和手动输入
 | disabledDate | `(date: Date) => boolean` | — | 自定义禁用日期 |
 | size | `"sm" | "md" | "lg"` | `"md"` | 输入框尺寸 |
 | allowClear | `boolean` | `false` | 允许清空 |
-| open / defaultOpen / onOpenChange | `—` | — | 受控浮层显隐 |
+| open / defaultOpen / onOpenChange | `—` | — | 受控/初始显隐及变化回调；关闭后的焦点归还不会再次请求打开 |
 | popupClassName / dropdownClassName | `string` | — | 浮层 className |
 | disabled / readOnly / invalid / placeholder | `—` | — | 常规输入状态 |
 

package/docs/llms/datetimepicker.md

@@ -12,6 +12,8 @@ import { DateTimePicker } from "@fangxinyan/lumina";
 
 ### 基础用法
 
+确认或 Esc 关闭后焦点回到输入框并保持关闭；再次点击、Enter / ↓ 或 Tab 重新进入可展开。
+
 ```tsx
 <DateTimePicker defaultValue={new Date(2026, 4, 25, 9, 30)} />
 ```
@@ -81,7 +83,7 @@ const [startAt, setStartAt] = useState<Date | null>(new Date(2026, 4, 25, 9, 30)
 | disabledTime | `(time: TimePickerValue, date: Date) => boolean` | — | 按当前日期禁用具体时间 |
 | size | `"sm" | "md" | "lg"` | `"md"` | 输入框尺寸 |
 | allowClear | `boolean` | `false` | 允许清空 |
-| open / defaultOpen / onOpenChange | `—` | — | 受控浮层显隐 |
+| open / defaultOpen / onOpenChange | `—` | — | 受控/初始显隐及变化回调；关闭后的焦点归还不会再次请求打开 |
 | popupClassName / dropdownClassName | `string` | — | 浮层 className |
 | disabled / readOnly / invalid / placeholder | `—` | — | 常规输入状态 |
 

package/docs/llms/timepicker.md

@@ -12,6 +12,8 @@ import { TimePicker } from "@fangxinyan/lumina";
 
 ### 基础用法
 
+确认或 Esc 关闭后焦点回到输入框并保持关闭；再次点击、Enter / ↓ 或 Tab 重新进入可展开。
+
 ```tsx
 <TimePicker defaultValue="09:30" />
 ```
@@ -72,7 +74,7 @@ const [time, setTime] = useState<string | null>("09:30");
 | disabledTime | `(time: TimePickerValue) => boolean` | — | 自定义禁用时间 |
 | size | `"sm" | "md" | "lg"` | `"md"` | 输入框尺寸 |
 | allowClear | `boolean` | `false` | 允许清空 |
-| open / defaultOpen / onOpenChange | `—` | — | 受控浮层显隐 |
+| open / defaultOpen / onOpenChange | `—` | — | 受控/初始显隐及变化回调；关闭后的焦点归还不会再次请求打开 |
 | popupClassName / dropdownClassName | `string` | — | 浮层 className |
 | disabled / readOnly / invalid / placeholder | `—` | — | 常规输入状态 |
 

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.9.4`
+- **版本**: `0.9.5`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fangxinyan/lumina",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",