@fangxinyan/lumina 0.6.18 → 0.7.0

package/dist/Avatar.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkTBNPJPYG_cjs = require('./chunk-TBNPJPYG.cjs');
+var chunkFMUHLIHB_cjs = require('./chunk-FMUHLIHB.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Avatar", {
   enumerable: true,
-  get: function () { return chunkTBNPJPYG_cjs.Avatar; }
+  get: function () { return chunkFMUHLIHB_cjs.Avatar; }
 });

package/dist/Avatar.d.cts

@@ -1,7 +1,10 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, ComponentThemeProps {
     src?: string;
+    /** 主图片失败后的备用图片地址。 */
+    fallbackSrc?: string;
     alt?: string;
     /** Initials if no image. Auto-derived from `alt` if omitted. */
     initials?: string;
@@ -10,8 +13,9 @@ interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "childr
     shape?: "circle" | "square";
     /** Status dot. */
     status?: "online" | "busy" | "away" | "offline";
+    /** 图片最终加载失败时触发。 */
+    onImageError?: (event: React.SyntheticEvent<HTMLImageElement>) => void;
 }
-/** `Avatar` — user image or initials chip. */
 declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Avatar, type AvatarProps };

package/dist/Avatar.d.ts

@@ -1,7 +1,10 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, ComponentThemeProps {
     src?: string;
+    /** 主图片失败后的备用图片地址。 */
+    fallbackSrc?: string;
     alt?: string;
     /** Initials if no image. Auto-derived from `alt` if omitted. */
     initials?: string;
@@ -10,8 +13,9 @@ interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "childr
     shape?: "circle" | "square";
     /** Status dot. */
     status?: "online" | "busy" | "away" | "offline";
+    /** 图片最终加载失败时触发。 */
+    onImageError?: (event: React.SyntheticEvent<HTMLImageElement>) => void;
 }
-/** `Avatar` — user image or initials chip. */
 declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Avatar, type AvatarProps };

package/dist/Avatar.js

@@ -1 +1,3 @@
-export { Avatar } from './chunk-RR2BKV65.js';
+export { Avatar } from './chunk-ALAG4ZUH.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/Badge-DBWJEV4C.css

@@ -0,0 +1,22 @@
+/* ============ Badge ============ */
+.badge {
+  display: inline-flex;
+  align-items: center; justify-content: center;
+  min-width: 18px; height: 18px;
+  padding: 0 6px;
+  border-radius: 999px;
+  font-size: 10px;
+  font-weight: 700;
+  background: var(--lmn-badge-danger, var(--danger));
+  color: var(--lmn-badge-bg, var(--bg));
+  box-shadow: 0 1px 4px color-mix(in oklch, var(--lmn-badge-shadow-dark, var(--shadow-dark)) 35%, transparent);
+  font-variant-numeric: tabular-nums;
+}
+.badge.dot { min-width: 10px; height: 10px; padding: 0; }
+.badge.accent  { background: var(--lmn-badge-accent, var(--accent));  box-shadow: 0 1px 4px var(--lmn-badge-accent-glow, var(--accent-glow)); }
+.badge.info    { background: var(--lmn-badge-info, var(--info));    box-shadow: 0 1px 4px color-mix(in oklch, var(--lmn-badge-info, var(--info)) 35%, transparent); }
+.badge.success { background: var(--lmn-badge-success, var(--success)); box-shadow: 0 1px 4px color-mix(in oklch, var(--lmn-badge-success, var(--success)) 35%, transparent); }
+.badge.warning { background: var(--lmn-badge-warning, var(--warning)); box-shadow: 0 1px 4px color-mix(in oklch, var(--lmn-badge-warning, var(--warning)) 35%, transparent); }
+.badge.neutral { background: var(--lmn-badge-fg-muted, var(--fg-muted)); box-shadow: 0 1px 4px color-mix(in oklch, var(--lmn-badge-shadow-dark, var(--shadow-dark)) 35%, transparent); }
+.badge-wrap { position: relative; display: inline-block; }
+.badge-wrap > .badge { position: absolute; top: -4px; right: -4px; }

package/dist/Badge.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkFQJY4D3T_cjs = require('./chunk-FQJY4D3T.cjs');
+var chunkEUTK2ZRJ_cjs = require('./chunk-EUTK2ZRJ.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Badge", {
   enumerable: true,
-  get: function () { return chunkFQJY4D3T_cjs.Badge; }
+  get: function () { return chunkEUTK2ZRJ_cjs.Badge; }
 });

package/dist/Badge.d.cts

@@ -1,19 +1,23 @@
 import * as React from 'react';
 import { TagTone } from './Tag.cjs';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 import './Icon.cjs';
 import 'react/jsx-runtime';
 
-interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, ComponentThemeProps {
     /** Numeric count — renders as "max+" if greater than `max`. */
     count?: number;
     /** Maximum number to display before adding "+". */
     max?: number;
     /** Show a tiny dot instead of a number. */
     dot?: boolean;
+    /** count 为 0 时仍显示数字徽标。 */
+    showZero?: boolean;
+    /** 覆盖徽标的可访问文本。 */
+    statusLabel?: string;
     tone?: TagTone;
     children?: React.ReactNode;
 }
-/** `Badge` — notification dot / count. Wrap around another element. */
 declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
 
 export { Badge, type BadgeProps };

package/dist/Badge.d.ts

@@ -1,19 +1,23 @@
 import * as React from 'react';
 import { TagTone } from './Tag.js';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 import './Icon.js';
 import 'react/jsx-runtime';
 
-interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, ComponentThemeProps {
     /** Numeric count — renders as "max+" if greater than `max`. */
     count?: number;
     /** Maximum number to display before adding "+". */
     max?: number;
     /** Show a tiny dot instead of a number. */
     dot?: boolean;
+    /** count 为 0 时仍显示数字徽标。 */
+    showZero?: boolean;
+    /** 覆盖徽标的可访问文本。 */
+    statusLabel?: string;
     tone?: TagTone;
     children?: React.ReactNode;
 }
-/** `Badge` — notification dot / count. Wrap around another element. */
 declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
 
 export { Badge, type BadgeProps };

package/dist/Badge.js

@@ -1 +1,3 @@
-export { Badge } from './chunk-DSLYWX4O.js';
+export { Badge } from './chunk-ARUN2DMD.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Button-TUMZUQLI.css → Button-ILNZUX2N.css}

@@ -1,5 +1,6 @@
 /* ============ Button ============ */
 .btn {
+  --button-bg: var(--lmn-button-bg, var(--bg));
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -11,9 +12,9 @@
   font-size: var(--fs-md);
   font-weight: 500;
   font-family: inherit;
-  color: var(--fg);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
+  color: var(--lmn-button-fg, var(--fg));
+  background: var(--button-bg);
+  box-shadow: var(--lmn-button-neu-shadow-control, var(--neu-shadow-control));
   cursor: pointer;
   user-select: none;
   white-space: nowrap;
@@ -45,43 +46,45 @@
 }
 
 .btn.primary {
-  color: var(--accent-ink);
-  background: color-mix(in oklch, var(--accent-soft) 62%, var(--bg));
+  --button-bg: color-mix(in oklch, var(--lmn-button-accent-soft, var(--accent-soft)) 62%, var(--lmn-button-bg, var(--bg)));
+  color: var(--lmn-button-accent-ink, var(--accent-ink));
+  background: var(--button-bg);
   font-weight: 600;
 }
 
 .btn.ghost {
   background: transparent;
   box-shadow: none;
-  color: var(--fg-muted);
+  color: var(--lmn-button-fg-muted, var(--fg-muted));
 }
 
-.btn.danger { color: var(--danger); }
+.btn.danger { color: var(--lmn-button-danger, var(--danger)); }
 
 .btn:hover {
-  box-shadow: var(--neu-shadow-panel);
+  background: var(--lmn-button-hover-background, var(--button-bg));
+  box-shadow: var(--lmn-button-neu-shadow-panel, var(--neu-shadow-panel));
 }
 .btn.ghost:hover {
-  background: var(--bg);
+  background: var(--lmn-button-hover-background, var(--lmn-button-bg, var(--bg)));
   border-color: transparent;
-  box-shadow: var(--neu-shadow-subtle);
-  color: var(--fg);
+  box-shadow: var(--lmn-button-neu-shadow-subtle, var(--neu-shadow-subtle));
+  color: var(--lmn-button-fg, var(--fg));
 }
 .btn.danger:hover {
-  color: var(--danger);
+  color: var(--lmn-button-danger, var(--danger));
 }
 .btn:active,
 .btn.pressed {
-  box-shadow: var(--neu-shadow-inset-strong);
+  box-shadow: var(--lmn-button-neu-shadow-inset-strong, var(--neu-shadow-inset-strong));
 }
 .btn.ghost:active,
 .btn.ghost.pressed {
-  background: var(--bg);
-  color: var(--fg);
+  background: var(--lmn-button-bg, var(--bg));
+  color: var(--lmn-button-fg, var(--fg));
 }
 .btn.danger:active,
 .btn.danger.pressed {
-  color: var(--danger);
+  color: var(--lmn-button-danger, var(--danger));
 }
 
 .btn.icon { width: var(--ctrl-h); padding: 0; }
@@ -93,17 +96,17 @@
 .btn.block { width: 100%; flex-shrink: 1; }
 
 .btn[disabled], .btn.disabled, .btn:disabled {
-  color: var(--fg-subtle);
+  color: var(--lmn-button-fg-subtle, var(--fg-subtle));
   cursor: not-allowed;
   border-color: transparent;
-  box-shadow: var(--neu-shadow-subtle);
+  box-shadow: var(--lmn-button-neu-shadow-subtle, var(--neu-shadow-subtle));
   transform: none;
 }
 .btn[disabled]:hover, .btn:disabled:hover, .btn.disabled:hover {
-  color: var(--fg-subtle);
-  background: var(--bg);
+  color: var(--lmn-button-fg-subtle, var(--fg-subtle));
+  background: var(--lmn-button-bg, var(--bg));
   border-color: transparent;
-  box-shadow: var(--neu-shadow-subtle);
+  box-shadow: var(--lmn-button-neu-shadow-subtle, var(--neu-shadow-subtle));
   transform: none;
 }
 
@@ -116,3 +119,7 @@
   animation: spin 0.8s linear infinite;
   display: inline-block;
 }
+
+@media (prefers-reduced-motion: reduce) {
+  .btn .spinner { animation: none; }
+}

package/dist/Button.cjs

@@ -1,15 +1,17 @@
 'use strict';
 
-var chunkSW2HMNCA_cjs = require('./chunk-SW2HMNCA.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkT4RR6NVU_cjs = require('./chunk-T4RR6NVU.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Button", {
   enumerable: true,
-  get: function () { return chunkSW2HMNCA_cjs.Button; }
+  get: function () { return chunkT4RR6NVU_cjs.Button; }
 });
 Object.defineProperty(exports, "IconButton", {
   enumerable: true,
-  get: function () { return chunkSW2HMNCA_cjs.IconButton; }
+  get: function () { return chunkT4RR6NVU_cjs.IconButton; }
 });

package/dist/Button.d.cts

@@ -1,10 +1,11 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.cjs';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 import 'react/jsx-runtime';
 
 type ButtonVariant = "default" | "primary" | "ghost" | "danger";
 type ButtonSize = "sm" | "md" | "lg";
-interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> {
+interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type">, ComponentThemeProps {
     /** Visual variant. `primary` uses the accent color; `ghost` is borderless; `danger` is red. */
     variant?: ButtonVariant;
     /** Control height preset. */
@@ -32,20 +33,7 @@ interface IconButtonProps extends Omit<ButtonProps, "children" | "iconOnly" | "t
     icon: IconSlot;
     children?: never;
 }
-/**
- * `Button` — the primary action surface.
- *
- * @example
- * <Button variant="primary" icon="plus">新建</Button>
- * <Button variant="ghost" loading>保存</Button>
- */
 declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
-/**
- * `IconButton` — square icon-only command button.
- *
- * @example
- * <IconButton icon="settings" tip="设置" />
- */
 declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, IconButton, type IconButtonProps };

package/dist/Button.d.ts

@@ -1,10 +1,11 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.js';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 import 'react/jsx-runtime';
 
 type ButtonVariant = "default" | "primary" | "ghost" | "danger";
 type ButtonSize = "sm" | "md" | "lg";
-interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> {
+interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type">, ComponentThemeProps {
     /** Visual variant. `primary` uses the accent color; `ghost` is borderless; `danger` is red. */
     variant?: ButtonVariant;
     /** Control height preset. */
@@ -32,20 +33,7 @@ interface IconButtonProps extends Omit<ButtonProps, "children" | "iconOnly" | "t
     icon: IconSlot;
     children?: never;
 }
-/**
- * `Button` — the primary action surface.
- *
- * @example
- * <Button variant="primary" icon="plus">新建</Button>
- * <Button variant="ghost" loading>保存</Button>
- */
 declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
-/**
- * `IconButton` — square icon-only command button.
- *
- * @example
- * <IconButton icon="settings" tip="设置" />
- */
 declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, IconButton, type IconButtonProps };

package/dist/Button.js

@@ -1,2 +1,4 @@
-export { Button, IconButton } from './chunk-IPSNC5VZ.js';
-import './chunk-FDZG27IG.js';
+export { Button, IconButton } from './chunk-JHM7MN3G.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Calendar-I6NHCXIB.css → Calendar-QJ5HWEJQ.css}

@@ -1,9 +1,9 @@
 /* ============ Calendar ============ */
 .calendar {
-  background: var(--bg);
+  background: var(--lmn-calendar-bg, var(--bg));
   border-radius: var(--r-lg);
   padding: var(--gap-4);
-  box-shadow: var(--neu-shadow-panel);
+  box-shadow: var(--lmn-calendar-neu-shadow-panel, var(--neu-shadow-panel));
   width: 320px;
 }
 .calendar-head {
@@ -14,11 +14,11 @@
   font-size: 14px; font-weight: 600;
   display: inline-flex; align-items: center; gap: 8px;
   cursor: pointer; padding: 6px 10px; border-radius: var(--r-sm);
-  border: none; background: transparent; color: var(--fg);
+  border: none; background: transparent; color: var(--lmn-calendar-fg, var(--fg));
   font-family: inherit;
   transition: all var(--dur-fast) var(--ease);
 }
-.calendar-title:hover { background: var(--bg); box-shadow: var(--neu-shadow-subtle); }
+.calendar-title:hover { background: var(--lmn-calendar-bg, var(--bg)); box-shadow: var(--lmn-calendar-neu-shadow-subtle, var(--neu-shadow-subtle)); }
 .calendar-title.static {
   cursor: default;
 }
@@ -36,7 +36,7 @@
   border-radius: var(--r-sm);
   padding: 6px 8px;
   background: transparent;
-  color: var(--fg);
+  color: var(--lmn-calendar-fg, var(--fg));
   cursor: pointer;
   font: 600 14px var(--font-sans);
   transition:
@@ -45,9 +45,9 @@
     box-shadow var(--dur-fast) var(--ease);
 }
 .calendar-title-part:hover {
-  color: var(--accent-ink);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-subtle);
+  color: var(--lmn-calendar-accent-ink, var(--accent-ink));
+  background: var(--lmn-calendar-bg, var(--bg));
+  box-shadow: var(--lmn-calendar-neu-shadow-subtle, var(--neu-shadow-subtle));
 }
 .calendar-grid {
   display: grid;
@@ -58,7 +58,7 @@
   text-align: center;
   font-size: 10px;
   font-weight: 600;
-  color: var(--fg-subtle);
+  color: var(--lmn-calendar-fg-subtle, var(--fg-subtle));
   text-transform: uppercase;
   letter-spacing: 0.06em;
   padding: 8px 0;
@@ -68,7 +68,7 @@
   aspect-ratio: 1;
   display: grid; place-items: center;
   font-size: 12px;
-  color: var(--fg);
+  color: var(--lmn-calendar-fg, var(--fg));
   border-radius: var(--r-sm);
   cursor: pointer;
   border: none;
@@ -76,22 +76,22 @@
   font-family: inherit;
   transition: all var(--dur-fast) var(--ease);
 }
-.calendar-cell.out { color: var(--fg-subtle); opacity: 0.5; }
-.calendar-cell:hover { background: var(--bg); box-shadow: var(--neu-shadow-subtle); }
-.calendar-cell.today { font-weight: 700; color: var(--accent-ink); }
+.calendar-cell.out { color: var(--lmn-calendar-fg-subtle, var(--fg-subtle)); opacity: 0.5; }
+.calendar-cell:hover { background: var(--lmn-calendar-bg, var(--bg)); box-shadow: var(--lmn-calendar-neu-shadow-subtle, var(--neu-shadow-subtle)); }
+.calendar-cell.today { font-weight: 700; color: var(--lmn-calendar-accent-ink, var(--accent-ink)); }
 .calendar-cell.today::after {
   content: ""; position: absolute; bottom: 4px; left: 50%;
   width: 4px; height: 4px; border-radius: 999px;
-  background: var(--accent);
+  background: var(--lmn-calendar-accent, var(--accent));
   transform: translateX(-50%);
 }
 .calendar-cell.selected {
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
-  color: var(--accent-ink);
+  background: var(--lmn-calendar-bg, var(--bg));
+  box-shadow: var(--lmn-calendar-neu-shadow-inset, var(--neu-shadow-inset));
+  color: var(--lmn-calendar-accent-ink, var(--accent-ink));
   font-weight: 600;
 }
-.calendar-cell.disabled { color: var(--fg-subtle); opacity: 0.4; cursor: not-allowed; }
+.calendar-cell.disabled { color: var(--lmn-calendar-fg-subtle, var(--fg-subtle)); opacity: 0.4; cursor: not-allowed; }
 .calendar-cell.disabled:hover { background: transparent; box-shadow: none; }
 .calendar-select-grid {
   display: grid;
@@ -105,7 +105,7 @@
   border: none;
   border-radius: var(--r-sm);
   background: transparent;
-  color: var(--fg);
+  color: var(--lmn-calendar-fg, var(--fg));
   cursor: pointer;
   font: 600 var(--fs-md) var(--font-mono);
   transition:
@@ -114,17 +114,17 @@
     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);
+  color: var(--lmn-calendar-accent-ink, var(--accent-ink));
+  background: var(--lmn-calendar-bg, var(--bg));
+  box-shadow: var(--lmn-calendar-neu-shadow-subtle, var(--neu-shadow-subtle));
 }
 .calendar-select-option.selected {
-  color: var(--accent-ink);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  color: var(--lmn-calendar-accent-ink, var(--accent-ink));
+  background: var(--lmn-calendar-bg, var(--bg));
+  box-shadow: var(--lmn-calendar-neu-shadow-inset, var(--neu-shadow-inset));
 }
 .calendar-select-option.disabled {
-  color: var(--fg-subtle);
+  color: var(--lmn-calendar-fg-subtle, var(--fg-subtle));
   cursor: not-allowed;
   opacity: 0.4;
 }

package/dist/Calendar.cjs

@@ -1,11 +1,13 @@
 'use strict';
 
-var chunk4KDABJSY_cjs = require('./chunk-4KDABJSY.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkQNQSNVCU_cjs = require('./chunk-QNQSNVCU.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Calendar", {
   enumerable: true,
-  get: function () { return chunk4KDABJSY_cjs.Calendar; }
+  get: function () { return chunkQNQSNVCU_cjs.Calendar; }
 });

package/dist/Calendar.d.cts

@@ -1,11 +1,16 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
-    value?: Date;
-    defaultValue?: Date;
+interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange">, ComponentThemeProps {
+    /** 受控日期；传 null 表示当前没有选中日期。 */
+    value?: Date | null;
+    /** 非受控初始日期；传 null 时仍以今天作为初始可视月份。 */
+    defaultValue?: Date | null;
     onChange?: (date: Date) => void;
     /** Sync the visible month to this date when it changes. */
     viewDate?: Date;
+    /** 可视月份变化时触发，返回该月第一天。 */
+    onViewChange?: (date: Date) => void;
     /** Min selectable date. */
     min?: Date;
     /** Max selectable date. */
@@ -20,7 +25,6 @@ interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defa
     disabledDate?: (date: Date) => boolean;
     className?: string;
 }
-/** `Calendar` — month-view date picker. */
 declare const Calendar: React.ForwardRefExoticComponent<CalendarProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Calendar, type CalendarProps };

package/dist/Calendar.d.ts

@@ -1,11 +1,16 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
-    value?: Date;
-    defaultValue?: Date;
+interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange">, ComponentThemeProps {
+    /** 受控日期；传 null 表示当前没有选中日期。 */
+    value?: Date | null;
+    /** 非受控初始日期；传 null 时仍以今天作为初始可视月份。 */
+    defaultValue?: Date | null;
     onChange?: (date: Date) => void;
     /** Sync the visible month to this date when it changes. */
     viewDate?: Date;
+    /** 可视月份变化时触发，返回该月第一天。 */
+    onViewChange?: (date: Date) => void;
     /** Min selectable date. */
     min?: Date;
     /** Max selectable date. */
@@ -20,7 +25,6 @@ interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defa
     disabledDate?: (date: Date) => boolean;
     className?: string;
 }
-/** `Calendar` — month-view date picker. */
 declare const Calendar: React.ForwardRefExoticComponent<CalendarProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Calendar, type CalendarProps };

package/dist/Calendar.js

@@ -1,2 +1,4 @@
-export { Calendar } from './chunk-I7TOBKJO.js';
-import './chunk-FDZG27IG.js';
+export { Calendar } from './chunk-3DKFS44V.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';