huibo-ui 0.4.0 → 0.6.0

package/dist/types/components.d.ts

@@ -22,7 +22,7 @@ import { SegmentedOption } from "./components/Segmented/Segmented";
 import { SelectOption } from "./components/Select/Select";
 import { SliderMark } from "./components/Slider/Slider";
 import { StepStatus } from "./components/Steps/Steps";
-import { SortDirection, TableAction, TableColumn, TableTreeProps } from "./components/Table/Table";
+import { SortDirection, TableAction, TableColumn, TablePagination, TableTreeProps } from "./components/Table/Table";
 import { TimelineItem } from "./components/Timeline/Timeline";
 import { TourStep } from "./components/Tour/Tour";
 import { TransferDataItem } from "./components/Transfer/Transfer";
@@ -46,7 +46,7 @@ export { SegmentedOption } from "./components/Segmented/Segmented";
 export { SelectOption } from "./components/Select/Select";
 export { SliderMark } from "./components/Slider/Slider";
 export { StepStatus } from "./components/Steps/Steps";
-export { SortDirection, TableAction, TableColumn, TableTreeProps } from "./components/Table/Table";
+export { SortDirection, TableAction, TableColumn, TablePagination, TableTreeProps } from "./components/Table/Table";
 export { TimelineItem } from "./components/Timeline/Timeline";
 export { TourStep } from "./components/Tour/Tour";
 export { TransferDataItem } from "./components/Transfer/Transfer";
@@ -493,8 +493,13 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * 唯一标识（手风琴模式协调用）
+          * 唯一标识（手风琴模式协调用）。 O3：推荐用 itemKey。保留 key 作为向后兼容别名（key 是 Stencil/React 保留 prop， 通过 JSX 设置时可能被 vdom 拦截；HTML 属性 key="..." 仍可工作）。
          */
+        "itemKey": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "item-key"?: string;
         "key": string;
         /**
           * 标题
@@ -922,6 +927,7 @@ export namespace Components {
      * - 触发器 role=button + aria-haspopup=menu + aria-expanded
      * - 菜单 role=menu，菜单项 role=menuitem + aria-disabled
      * - 键盘：trigger 上 Enter/Space/↓ 打开；菜单内 ↑↓ 导航、Enter/Space 选中、Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbDropdown {
         /**
@@ -994,6 +1000,10 @@ export namespace Components {
           * 是否禁用
          */
         "disabled": boolean;
+        /**
+          * F1：初始值（非受控）。挂载后把这些值写到对应字段的子控件 modelValue。 key = FormItem 的 prop。
+         */
+        "initialValues"?: Record<string, any>;
         /**
           * 是否行内表单
          */
@@ -1018,6 +1028,18 @@ export namespace Components {
           * 表单数据对象
          */
         "model": Record<string, any>;
+        /**
+          * F2：提交且校验通过后的回调。参数为各字段当前值组成的对象。 由表单 submit（form onSubmit）触发——表单内放 type="submit" 的按钮即可。
+         */
+        "onFinish"?: (values: Record<string, any>) => void;
+        /**
+          * F2：提交且校验失败后的回调。
+         */
+        "onFinishFailed"?: (errors: { prop: string; errors: string[] }[]) => void;
+        /**
+          * F3：任意字段值变化时的回调。参数为 { prop, value, values }。 由子控件冒泡的 hbChange 触发。
+         */
+        "onValuesChange"?: (info: { prop: string; value: any; values: Record<string, any> }) => void;
         /**
           * 重置表单
          */
@@ -1035,6 +1057,10 @@ export namespace Components {
           * @returns 是否验证通过
          */
         "validate": () => Promise<boolean>;
+        /**
+          * F4：校验提示模板。覆盖默认的「{label}不能为空」「{label}格式不正确」等文案。 支持 {label} 占位符。仅对未在 rule.message 显式指定消息的规则生效。
+         */
+        "validateMessages"?: { required?: string; pattern?: string; email?: string; min?: string; max?: string };
     }
     /**
      * FormItem 表单项组件
@@ -1042,10 +1068,22 @@ export namespace Components {
      */
     interface HbFormItem {
         "getValue": () => any;
+        /**
+          * F6：手动错误/帮助文案（配合 validateStatus='error' 显示自定义提示）
+         */
+        "help"?: string;
         /**
           * 标签文本
          */
         "label": string;
+        /**
+          * F7：标签栅格占比（1-24）。未设置时用 labelWidth。 对齐 antd labelCol（简化为纯数字栅格，labelCol.span）。
+         */
+        "labelCol"?: number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-col"?: number;
         /**
           * 标签宽度
          */
@@ -1075,6 +1113,14 @@ export namespace Components {
           * 验证此字段
          */
         "validate": () => Promise<string[]>;
+        /**
+          * F6：手动校验态（'success' | 'warning' | 'error' | 'validating' | ''）。 设置后覆盖内部校验结果驱动的错误显示（对齐 antd validateStatus）。
+         */
+        "validateStatus"?: '' | 'success' | 'warning' | 'error' | 'validating';
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "validate-status"?: '' | 'success' | 'warning' | 'error' | 'validating';
     }
     /**
      * Container Header 组件
@@ -1594,8 +1640,13 @@ export namespace Components {
          */
         "icon"?: string;
         /**
-          * 唯一标识
+          * 唯一标识。 O3：推荐用 itemKey。保留 key 作为向后兼容别名（key 是 Stencil/React 保留 prop， 通过 JSX 设置时可能被 vdom 拦截；HTML 属性 key="..." 仍可工作）。
+         */
+        "itemKey": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
          */
+        "item-key"?: string;
         "key": string;
     }
     /**
@@ -1748,6 +1799,7 @@ export namespace Components {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
      * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
      * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+     * 进出场动画：用 leaving state 延迟卸载。
      */
     interface HbPopconfirm {
         "cancelButtonText": string;
@@ -1771,6 +1823,7 @@ export namespace Components {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
      * - 浮层 role=dialog + aria-labelledby（title）
      * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbPopover {
         "disabled": boolean;
@@ -2090,6 +2143,14 @@ export namespace Components {
           * @default false
          */
         "disabled": boolean;
+        /**
+          * V1：下拉最大高度(px)。virtual=true 时必填（定义视口高度）。默认 256。
+         */
+        "dropdownMaxHeight": number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "dropdown-max-height"?: number;
         /**
           * 自定义过滤方法
          */
@@ -2132,6 +2193,18 @@ export namespace Components {
           * 输入框尺寸
          */
         "size": 'large' | 'default' | 'small';
+        /**
+          * V1：是否开启虚拟滚动（1000+ 选项时推荐）。默认 false。 开启后下拉仅渲染可见窗口内的选项，DOM 节点数恒定。
+         */
+        "virtual": boolean;
+        /**
+          * V1：虚拟滚动每项预估高度(px)。默认 34。
+         */
+        "virtualItemHeight": number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "virtual-item-height"?: number;
     }
     /**
      * Skeleton 骨架屏组件
@@ -2513,6 +2586,14 @@ export namespace Components {
          * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
          */
         "max-height"?: string;
+        /**
+          * 内置分页配置（T1）。传入后 Table 自动对 data 切片并在底部渲染 <hb-pagination>。 不传则不分页（向后兼容）。
+         */
+        "pagination"?: TablePagination;
+        /**
+          * 行 className（函数，按行返回附加 class，T8）
+         */
+        "rowClassName"?: (row: Record<string, any>, index: number) => string;
         /**
           * 行数据的 Key
          */
@@ -2772,6 +2853,7 @@ export namespace Components {
      * - 浮层 role=tooltip
      * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
      * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbTooltip {
         /**
@@ -3698,6 +3780,7 @@ declare global {
      * - 触发器 role=button + aria-haspopup=menu + aria-expanded
      * - 菜单 role=menu，菜单项 role=menuitem + aria-disabled
      * - 键盘：trigger 上 Enter/Space/↓ 打开；菜单内 ↑↓ 导航、Enter/Space 选中、Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HTMLHbDropdownElement extends Components.HbDropdown, HTMLStencilElement {
         addEventListener<K extends keyof HTMLHbDropdownElementEventMap>(type: K, listener: (this: HTMLHbDropdownElement, ev: HbDropdownCustomEvent<HTMLHbDropdownElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -4051,6 +4134,7 @@ declare global {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
      * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
      * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+     * 进出场动画：用 leaving state 延迟卸载。
      */
     interface HTMLHbPopconfirmElement extends Components.HbPopconfirm, HTMLStencilElement {
     }
@@ -4064,6 +4148,7 @@ declare global {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
      * - 浮层 role=dialog + aria-labelledby（title）
      * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HTMLHbPopoverElement extends Components.HbPopover, HTMLStencilElement {
     }
@@ -4323,6 +4408,8 @@ declare global {
         "hbAction": { row: Record<string, any>; index: number; action: string };
         "hbExpandChange": { expanded: boolean; row: Record<string, any> };
         "hbCellChange": { row: Record<string, any>; prop: string; value: any };
+        "hbPageChange": { current: number; pageSize: number };
+        "hbFilterChange": { prop: string; values: (string | number)[] };
     }
     /**
      * Table 表格组件
@@ -4455,6 +4542,7 @@ declare global {
      * - 浮层 role=tooltip
      * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
      * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HTMLHbTooltipElement extends Components.HbTooltip, HTMLStencilElement {
     }
@@ -5141,8 +5229,13 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * 唯一标识（手风琴模式协调用）
+          * 唯一标识（手风琴模式协调用）。 O3：推荐用 itemKey。保留 key 作为向后兼容别名（key 是 Stencil/React 保留 prop， 通过 JSX 设置时可能被 vdom 拦截；HTML 属性 key="..." 仍可工作）。
+         */
+        "itemKey"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
          */
+        "item-key"?: string;
         "key"?: string;
         /**
           * 标题
@@ -5620,6 +5713,7 @@ declare namespace LocalJSX {
      * - 触发器 role=button + aria-haspopup=menu + aria-expanded
      * - 菜单 role=menu，菜单项 role=menuitem + aria-disabled
      * - 键盘：trigger 上 Enter/Space/↓ 打开；菜单内 ↑↓ 导航、Enter/Space 选中、Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbDropdown {
         /**
@@ -5700,6 +5794,10 @@ declare namespace LocalJSX {
           * 是否禁用
          */
         "disabled"?: boolean;
+        /**
+          * F1：初始值（非受控）。挂载后把这些值写到对应字段的子控件 modelValue。 key = FormItem 的 prop。
+         */
+        "initialValues"?: Record<string, any>;
         /**
           * 是否行内表单
          */
@@ -5724,6 +5822,18 @@ declare namespace LocalJSX {
           * 表单数据对象
          */
         "model"?: Record<string, any>;
+        /**
+          * F2：提交且校验通过后的回调。参数为各字段当前值组成的对象。 由表单 submit（form onSubmit）触发——表单内放 type="submit" 的按钮即可。
+         */
+        "onFinish"?: (values: Record<string, any>) => void;
+        /**
+          * F2：提交且校验失败后的回调。
+         */
+        "onFinishFailed"?: (errors: { prop: string; errors: string[] }[]) => void;
+        /**
+          * F3：任意字段值变化时的回调。参数为 { prop, value, values }。 由子控件冒泡的 hbChange 触发。
+         */
+        "onValuesChange"?: (info: { prop: string; value: any; values: Record<string, any> }) => void;
         /**
           * 重置表单
          */
@@ -5741,6 +5851,10 @@ declare namespace LocalJSX {
           * @returns 是否验证通过
          */
         "validate"?: () => Promise<boolean>;
+        /**
+          * F4：校验提示模板。覆盖默认的「{label}不能为空」「{label}格式不正确」等文案。 支持 {label} 占位符。仅对未在 rule.message 显式指定消息的规则生效。
+         */
+        "validateMessages"?: { required?: string; pattern?: string; email?: string; min?: string; max?: string };
     }
     /**
      * FormItem 表单项组件
@@ -5748,10 +5862,22 @@ declare namespace LocalJSX {
      */
     interface HbFormItem {
         "getValue"?: () => any;
+        /**
+          * F6：手动错误/帮助文案（配合 validateStatus='error' 显示自定义提示）
+         */
+        "help"?: string;
         /**
           * 标签文本
          */
         "label"?: string;
+        /**
+          * F7：标签栅格占比（1-24）。未设置时用 labelWidth。 对齐 antd labelCol（简化为纯数字栅格，labelCol.span）。
+         */
+        "labelCol"?: number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-col"?: number;
         /**
           * 标签宽度
          */
@@ -5781,6 +5907,14 @@ declare namespace LocalJSX {
           * 验证此字段
          */
         "validate"?: () => Promise<string[]>;
+        /**
+          * F6：手动校验态（'success' | 'warning' | 'error' | 'validating' | ''）。 设置后覆盖内部校验结果驱动的错误显示（对齐 antd validateStatus）。
+         */
+        "validateStatus"?: '' | 'success' | 'warning' | 'error' | 'validating';
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "validate-status"?: '' | 'success' | 'warning' | 'error' | 'validating';
     }
     /**
      * Container Header 组件
@@ -6356,8 +6490,13 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * 唯一标识
+          * 唯一标识。 O3：推荐用 itemKey。保留 key 作为向后兼容别名（key 是 Stencil/React 保留 prop， 通过 JSX 设置时可能被 vdom 拦截；HTML 属性 key="..." 仍可工作）。
          */
+        "itemKey"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "item-key"?: string;
         "key"?: string;
     }
     /**
@@ -6526,6 +6665,7 @@ declare namespace LocalJSX {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
      * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
      * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+     * 进出场动画：用 leaving state 延迟卸载。
      */
     interface HbPopconfirm {
         "cancelButtonText"?: string;
@@ -6549,6 +6689,7 @@ declare namespace LocalJSX {
      * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
      * - 浮层 role=dialog + aria-labelledby（title）
      * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbPopover {
         "disabled"?: boolean;
@@ -6868,6 +7009,14 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * V1：下拉最大高度(px)。virtual=true 时必填（定义视口高度）。默认 256。
+         */
+        "dropdownMaxHeight"?: number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "dropdown-max-height"?: number;
         /**
           * 自定义过滤方法
          */
@@ -6918,6 +7067,18 @@ declare namespace LocalJSX {
           * 输入框尺寸
          */
         "size"?: 'large' | 'default' | 'small';
+        /**
+          * V1：是否开启虚拟滚动（1000+ 选项时推荐）。默认 false。 开启后下拉仅渲染可见窗口内的选项，DOM 节点数恒定。
+         */
+        "virtual"?: boolean;
+        /**
+          * V1：虚拟滚动每项预估高度(px)。默认 34。
+         */
+        "virtualItemHeight"?: number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "virtual-item-height"?: number;
     }
     /**
      * Skeleton 骨架屏组件
@@ -7323,6 +7484,14 @@ declare namespace LocalJSX {
           * 树形行展开/收起事件
          */
         "onHbExpandChange"?: (event: HbTableCustomEvent<{ expanded: boolean; row: Record<string, any> }>) => void;
+        /**
+          * T3 筛选变化事件 { prop, values }
+         */
+        "onHbFilterChange"?: (event: HbTableCustomEvent<{ prop: string; values: (string | number)[] }>) => void;
+        /**
+          * T1 分页变化事件 { current, pageSize }
+         */
+        "onHbPageChange"?: (event: HbTableCustomEvent<{ current: number; pageSize: number }>) => void;
         /**
           * 行点击事件
          */
@@ -7335,6 +7504,14 @@ declare namespace LocalJSX {
           * 排序变化事件
          */
         "onHbSortChange"?: (event: HbTableCustomEvent<{ prop: string; order: SortDirection }>) => void;
+        /**
+          * 内置分页配置（T1）。传入后 Table 自动对 data 切片并在底部渲染 <hb-pagination>。 不传则不分页（向后兼容）。
+         */
+        "pagination"?: TablePagination;
+        /**
+          * 行 className（函数，按行返回附加 class，T8）
+         */
+        "rowClassName"?: (row: Record<string, any>, index: number) => string;
         /**
           * 行数据的 Key
          */
@@ -7614,6 +7791,7 @@ declare namespace LocalJSX {
      * - 浮层 role=tooltip
      * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
      * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+     * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
      */
     interface HbTooltip {
         /**
@@ -8139,6 +8317,7 @@ declare module "@stencil/core" {
              * - 触发器 role=button + aria-haspopup=menu + aria-expanded
              * - 菜单 role=menu，菜单项 role=menuitem + aria-disabled
              * - 键盘：trigger 上 Enter/Space/↓ 打开；菜单内 ↑↓ 导航、Enter/Space 选中、Esc 关闭
+             * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
              */
             "hb-dropdown": LocalJSX.HbDropdown & JSXBase.HTMLAttributes<HTMLHbDropdownElement>;
             "hb-empty": LocalJSX.HbEmpty & JSXBase.HTMLAttributes<HTMLHbEmptyElement>;
@@ -8250,6 +8429,7 @@ declare module "@stencil/core" {
              * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
              * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
              * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+             * 进出场动画：用 leaving state 延迟卸载。
              */
             "hb-popconfirm": LocalJSX.HbPopconfirm & JSXBase.HTMLAttributes<HTMLHbPopconfirmElement>;
             /**
@@ -8258,6 +8438,7 @@ declare module "@stencil/core" {
              * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
              * - 浮层 role=dialog + aria-labelledby（title）
              * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+             * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
              */
             "hb-popover": LocalJSX.HbPopover & JSXBase.HTMLAttributes<HTMLHbPopoverElement>;
             "hb-progress": LocalJSX.HbProgress & JSXBase.HTMLAttributes<HTMLHbProgressElement>;
@@ -8384,6 +8565,7 @@ declare module "@stencil/core" {
              * - 浮层 role=tooltip
              * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
              * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+             * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
              */
             "hb-tooltip": LocalJSX.HbTooltip & JSXBase.HTMLAttributes<HTMLHbTooltipElement>;
             /**

package/dist/types/utils/a11y.d.ts

@@ -7,6 +7,15 @@
  */
 /** 判定按键是否为「激活」键（Enter / Space），用于自定义可聚焦元素的点击替代 */
 export declare function isActivationKey(key: string | undefined): boolean;
+/**
+ * 生成一个 keydown 处理器：当按下激活键（Enter/Space）时触发元素 click。
+ * 用于给 `role="button"` 的 `<span>`/`<div>` 补齐键盘可达性（A3）。
+ *
+ * 用法：`onKeyDown={activationClickHandler}`
+ * 它会读 `event.currentTarget`（即绑定 onKeyDown 的元素）并调 .click()，
+ * 并 preventDefault 避免空格滚动页面。
+ */
+export declare function activationClickHandler(e: KeyboardEvent): void;
 export declare function getFocusableElements(container: HTMLElement): HTMLElement[];
 /** 焦点陷阱选项 */
 export interface FocusTrapOptions {

package/dist/types/utils/transition.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 弹层进出场动画编排工具
+ *
+ * 问题背景：Stencil 声明式渲染里 `{visible && <El/>}` 会在关闭瞬间卸载 DOM，
+ * CSS 离场动画没机会播放——出现"打开有动画、关闭瞬间消失"的体验缺陷。
+ *
+ * 方案：组件维护一个 `leaving` state，关闭时先设 leaving=true 播放离场动画，
+ * 动画时长（默认 200ms）后再 leaving=false 真正卸载。`shouldRender = visible || leaving`。
+ *
+ * 用法（在组件里）：
+ *   ```ts
+ *   private leave = createLeaveScheduler(() => this.leaving, (v) => this.leaving = v, 200);
+ *   // visible 变 false 时：this.leave.start(() => 真正关闭的清理);
+ *   // render 里：{this.shouldRender && <El class={{ '--leaving': this.leaving }}/>}
+ *   ```
+ */
+export type LeavingSetter = (leaving: boolean) => void;
+export type LeavingGetter = () => boolean;
+export interface LeaveScheduler {
+    /** 开始离场：设 leaving=true，duration 后回调 onDone 并 leaving=false */
+    start(onDone?: () => void): void;
+    /** 取消挂起的离场（用于关闭中途又打开的场景） */
+    cancel(): void;
+    /** disconnectedCallback 时调用，避免组件卸载后还在 setState */
+    dispose(): void;
+}
+export declare function createLeaveScheduler(getLeaving: LeavingGetter, setLeaving: LeavingSetter, duration?: number): LeaveScheduler;

package/dist/types/utils/virtual-scroll.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 通用虚拟滚动工具（V1，包2）。
+ *
+ * 从 Table 的虚拟滚动逻辑提取，供 Select/Cascader/Tree/TreeSelect/Menu 复用。
+ * 仅渲染「可见窗口 + 上下缓冲」范围的项，而非全量列表——1000+ 选项时 DOM 节点数恒定。
+ *
+ * 用法（组件内）：
+ *   1. 维护 scrollTop state（onScroll 回调更新）
+ *   2. 调 getVirtualRange({ total, itemHeight, viewportHeight, scrollTop, buffer }) 得 [start, end)
+ *   3. 仅渲染 list.slice(start, end)，用 getOffsetTop(start, itemHeight) 撑出顶部空白
+ */
+export interface VirtualRangeOptions {
+    /** 列表总项数 */
+    total: number;
+    /** 每项高度(px)，>0 */
+    itemHeight: number;
+    /** 视口高度(px) */
+    viewportHeight: number;
+    /** 当前滚动位置(px) */
+    scrollTop: number;
+    /** 上下缓冲行数（默认 5） */
+    buffer?: number;
+}
+export interface VirtualRange {
+    /** 起始索引（含） */
+    startIndex: number;
+    /** 结束索引（不含） */
+    endIndex: number;
+}
+/**
+ * 计算可见窗口 [startIndex, endIndex)。
+ * startIndex 夹到 [0, total)，endIndex 夹到 [0, total]。
+ */
+export declare function getVirtualRange(opts: VirtualRangeOptions): VirtualRange;
+/** 撑出顶部空白高度(px)，用于偏移可见窗口到正确滚动位置。 */
+export declare function getOffsetTop(startIndex: number, itemHeight: number): number;
+/** 容器总高度(px)，用于撑出滚动条。 */
+export declare function getTotalHeight(total: number, itemHeight: number): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "huibo-ui",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Stencil Component Starter",
   "main": "dist/index.cjs.js",

package/dist/cjs/a11y-802de67a.js.map

@@ -1 +0,0 @@
-{"file":"a11y-802de67a.js","mappings":";;AAAA;;;;;;;AAQA;SACgB,eAAe,CAAC,GAAuB;IACrD,OAAO,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,UAAU,CAAC;AAC9D,CAAC;AAED;AACA,MAAM,kBAAkB,GAAG;IACzB,SAAS;IACT,wBAAwB;IACxB,0BAA0B;IAC1B,uBAAuB;IACvB,wBAAwB;IACxB,iCAAiC;IACjC,0BAA0B;CAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAEI,oBAAoB,CAAC,SAAsB;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAc,kBAAkB,CAAC,CAAC,CAAC,MAAM,CACnF,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CACjF,CAAC;AACJ,CAAC;AAoBD;;;;;SAKgB,eAAe,CAAC,OAAyB;IACvD,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC/D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,iBAAiB,GAAuB,IAAI,CAAC;IAEjD,MAAM,aAAa,GAAG,CAAC,CAAgB;QACrC,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO;QAC5B,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;YAC1B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO;SACR;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC,CAAC,QAAQ,EAAE;YACd,IAAI,QAAQ,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBACvD,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;aACd;SACF;aAAM;YACL,IAAI,QAAQ,KAAK,IAAI,EAAE;gBACrB,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,KAAK,CAAC,KAAK,EAAE,CAAC;aACf;SACF;KACF,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,iBAAiB,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAuB,CAAC;QACpF,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE;YACb,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAClD,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;SACrC;KACF,CAAC;IAEF,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,KAAK,CAAC;QACf,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,iBAAiB,IAAI,OAAO,iBAAiB,CAAC,KAAK,KAAK,UAAU,EAAE;YACtE,iBAAiB,CAAC,KAAK,EAAE,CAAC;SAC3B;QACD,iBAAiB,GAAG,IAAI,CAAC;KAC1B,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAmBD;;;;;;;SAOgB,kBAAkB,CAAC,KAAoB,EAAE,OAA4B;IACnF,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACxD,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAE5C,MAAM,KAAK,GAAG,CAAC,GAAW,KAAK,CAAC,GAAG,GAAG,SAAS,IAAI,SAAS,CAAC;IAC7D,MAAM,MAAM,GAAG,CAAC,GAAW,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IAE1E,QAAQ,KAAK,CAAC,GAAG;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,SAAS,CAAC;QACf,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxC,KAAK,KAAK;YACR,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,OAAO,CAAC;QACb,KAAK,GAAG,CAAC;QACT,KAAK,UAAU;YACb,OAAO,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACtF,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B;YACE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAC3B;AACH;;;;;;","names":[],"sources":["src/utils/a11y.ts"],"sourcesContent":["/**\n * 无障碍（a11y）工具集\n * 统一 ARIA 属性辅助、焦点陷阱、列表键盘导航等在交互组件（Dialog / Drawer / Menu /\n * Dropdown / Select 等）中重复出现且容易写错的可访问性逻辑。\n *\n * 参考标准：WAI-ARIA Authoring Practices 1.2。\n */\n\n/** 判定按键是否为「激活」键（Enter / Space），用于自定义可聚焦元素的点击替代 */\nexport function isActivationKey(key: string | undefined): boolean {\n  return key === 'Enter' || key === ' ' || key === 'Spacebar';\n}\n\n/** 查询容器内可聚焦的元素顺序（tabindex >= 0 的语义元素） */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'textarea:not([disabled])',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n].join(',');\n\nexport function getFocusableElements(container: HTMLElement): HTMLElement[] {\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n    (el) => el.getAttribute('aria-hidden') !== 'true' && el.style.display !== 'none',\n  );\n}\n\n/** 焦点陷阱选项 */\nexport interface FocusTrapOptions {\n  /** 焦点受限的容器元素 */\n  container: HTMLElement;\n  /** 打开时是否自动聚焦容器内首个可聚焦元素 */\n  autoFocus?: boolean;\n  /** 容器激活前的元素（用于关闭时归还焦点） */\n  returnFocusTo?: HTMLElement | null;\n}\n\n/** 焦点陷阱句柄 */\nexport interface FocusTrap {\n  /** 启用：绑定 Tab 拦截，可选自动聚焦 */\n  connect: () => void;\n  /** 关闭：解除拦截，归还焦点 */\n  disconnect: () => void;\n}\n\n/**\n * 创建焦点陷阱（Dialog / Drawer 打开时把 Tab 循环限制在容器内）。\n * 关键点：Tab 与 Shift+Tab 在容器边界时回环到另一端，防止焦点逃逸到背景。\n * 返回句柄，组件在打开时 connect()、关闭时 disconnect()。\n */\nexport function createFocusTrap(options: FocusTrapOptions): FocusTrap {\n  const { container, autoFocus = true, returnFocusTo } = options;\n  let active = false;\n  let previouslyFocused: HTMLElement | null = null;\n\n  const handleKeydown = (e: KeyboardEvent) => {\n    if (e.key !== 'Tab') return;\n    const focusable = getFocusableElements(container);\n    if (focusable.length === 0) {\n      e.preventDefault();\n      container.focus();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const activeEl = document.activeElement;\n\n    if (e.shiftKey) {\n      if (activeEl === first || !container.contains(activeEl)) {\n        e.preventDefault();\n        last.focus();\n      }\n    } else {\n      if (activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const connect = () => {\n    if (active) return;\n    active = true;\n    previouslyFocused = (returnFocusTo ?? document.activeElement) as HTMLElement | null;\n    container.addEventListener('keydown', handleKeydown);\n    if (autoFocus) {\n      const focusable = getFocusableElements(container);\n      (focusable[0] ?? container).focus();\n    }\n  };\n\n  const disconnect = () => {\n    if (!active) return;\n    active = false;\n    container.removeEventListener('keydown', handleKeydown);\n    if (previouslyFocused && typeof previouslyFocused.focus === 'function') {\n      previouslyFocused.focus();\n    }\n    previouslyFocused = null;\n  };\n\n  return { connect, disconnect };\n}\n\n/** 列表键盘导航产生的动作 */\nexport type ListKeyAction =\n  | { type: 'navigate'; index: number }\n  | { type: 'select'; index: number }\n  | { type: 'close' }\n  | { type: 'none' };\n\n/** 列表键盘导航参数 */\nexport interface ListKeyboardOptions {\n  /** 当前高亮项索引（-1 表示无高亮） */\n  activeIndex: number;\n  /** 列表项总数 */\n  itemCount: number;\n  /** 是否允许循环（首尾跳转） */\n  loop?: boolean;\n}\n\n/**\n * 列表 / 菜单 / 下拉选项的键盘导航核心逻辑（listbox / menu / combobox 通用）。\n * 返回应执行的动作，由调用方据此更新 activeIndex / 触发选中 / 关闭。\n *\n * 支持：ArrowDown/ArrowUp（竖排）/ArrowRight/ArrowLeft（横排）移动、Home/End 跳首尾、\n * Enter/Space 选中、Escape 关闭。\n */\nexport function handleListKeyboard(event: KeyboardEvent, options: ListKeyboardOptions): ListKeyAction {\n  const { activeIndex, itemCount, loop = true } = options;\n  if (itemCount <= 0) return { type: 'none' };\n\n  const clamp = (idx: number) => (idx + itemCount) % itemCount;\n  const within = (idx: number) => Math.max(0, Math.min(idx, itemCount - 1));\n\n  switch (event.key) {\n    case 'ArrowDown':\n    case 'ArrowRight':\n      return { type: 'navigate', index: loop ? clamp(activeIndex + 1) : within(activeIndex + 1) };\n    case 'ArrowUp':\n    case 'ArrowLeft':\n      return { type: 'navigate', index: loop ? clamp(activeIndex - 1) : within(activeIndex - 1) };\n    case 'Home':\n      return { type: 'navigate', index: 0 };\n    case 'End':\n      return { type: 'navigate', index: itemCount - 1 };\n    case 'Enter':\n    case ' ':\n    case 'Spacebar':\n      return activeIndex >= 0 ? { type: 'select', index: activeIndex } : { type: 'none' };\n    case 'Escape':\n      return { type: 'close' };\n    default:\n      return { type: 'none' };\n  }\n}\n\n/**\n * 为元素批量设置 ARIA 属性（不可变：返回新映射，但直接操作 DOM 属性是 a11y 的固有需求）。\n * 组件挂载后调用一次即可，避免每次 render 重复写 setAttribute。\n */\nexport function applyAria(el: HTMLElement, attrs: Record<string, string | boolean | undefined>): void {\n  Object.entries(attrs).forEach(([key, value]) => {\n    if (value === undefined || value === null) {\n      el.removeAttribute(`aria-${key}`);\n    } else {\n      el.setAttribute(`aria-${key}`, String(value));\n    }\n  });\n}\n"],"version":3}

package/dist/cjs/date-helpers-1ffddc59.js.map

@@ -1 +0,0 @@
-{"file":"date-helpers-1ffddc59.js","mappings":"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","names":[],"sources":["src/utils/date-helpers.ts"],"sourcesContent":["/**\n * 日历和日期工具函数\n * 从 DatePicker / DateTimePicker / DatePickerPane 中提取的共享逻辑\n */\n\nexport interface CalendarDay {\n  date: Date;\n  isCurrentMonth: boolean;\n  isToday: boolean;\n  isSelected: boolean;\n}\n\n/** 判断两个日期是否为同一天 */\nexport function isSameDay(date1: Date, date2: Date): boolean {\n  return (\n    date1.getFullYear() === date2.getFullYear() &&\n    date1.getMonth() === date2.getMonth() &&\n    date1.getDate() === date2.getDate()\n  );\n}\n\n/** 生成 42 天（6 周）的日历网格数据 */\nexport function getCalendarDays(\n  viewDate: Date,\n  selectedDate?: Date,\n  today: Date = new Date(),\n  firstDayOfWeek: number = 0\n): CalendarDay[] {\n  const days: CalendarDay[] = [];\n  const year = viewDate.getFullYear();\n  const month = viewDate.getMonth();\n\n  const firstDay = new Date(year, month, 1);\n  const lastDay = new Date(year, month + 1, 0);\n  const firstDayWeek = firstDay.getDay();\n  const daysInMonth = lastDay.getDate();\n\n  // 按 firstDayOfWeek 计算需要补多少上月天数。\n  // 默认 firstDayOfWeek=0（周日为首列）时，offset = firstDayWeek；\n  // firstDayOfWeek=1（周一为首列）时，周日的 offset 多 1、周一的 offset 为 0。\n  const offset = ((firstDayWeek - firstDayOfWeek) + 7) % 7;\n\n  // 上月填充\n  const prevMonth = new Date(year, month - 1, 0);\n  for (let i = offset - 1; i >= 0; i--) {\n    const date = new Date(year, month - 1, prevMonth.getDate() - i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 当月日期\n  for (let i = 1; i <= daysInMonth; i++) {\n    const date = new Date(year, month, i);\n    days.push({\n      date,\n      isCurrentMonth: true,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 下月填充（补齐 42 天）\n  const remainingDays = 42 - days.length;\n  for (let i = 1; i <= remainingDays; i++) {\n    const date = new Date(year, month + 1, i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  return days;\n}\n\n/**\n * 格式化日期为指定格式字符串\n * 支持：YYYY, MM, DD, HH, mm, ss\n */\nexport function formatDate(date: Date, format: string): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  const hours = String(date.getHours()).padStart(2, '0');\n  const minutes = String(date.getMinutes()).padStart(2, '0');\n  const seconds = String(date.getSeconds()).padStart(2, '0');\n\n  return format\n    .replace('YYYY', String(year))\n    .replace('MM', month)\n    .replace('DD', day)\n    .replace('HH', hours)\n    .replace('mm', minutes)\n    .replace('ss', seconds);\n}\n\n/** 安全解析日期值 */\nexport function parseDate(value: string | Date | undefined): Date | undefined {\n  if (!value) return undefined;\n  const date = value instanceof Date ? value : new Date(value);\n  if (isNaN(date.getTime())) return undefined;\n  return date;\n}\n\n/** 月份偏移，返回新日期对象（不可变） */\nexport function addMonths(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setMonth(result.getMonth() + delta);\n  return result;\n}\n\n/** 年份偏移，返回新日期对象（不可变） */\nexport function addYears(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setFullYear(result.getFullYear() + delta);\n  return result;\n}\n\n/**\n * 生成 years 视图的 12 年档数据（每档 12 年）。\n * 以 viewDate 所在年份向下取整到 12 的倍数作为起点。\n */\nexport interface CalendarYear {\n  year: number;\n  isCurrentYearRange: boolean;\n  isSelected: boolean;\n}\n\nexport function getCalendarYears(\n  viewDate: Date,\n  selectedDate?: Date,\n  startYearBase?: number\n): CalendarYear[] {\n  const year = viewDate.getFullYear();\n  const rangeStart = startYearBase ?? year - (year % 12);\n  const years: CalendarYear[] = [];\n  for (let i = 0; i < 12; i++) {\n    const y = rangeStart + i;\n    years.push({\n      year: y,\n      isCurrentYearRange: y === year,\n      isSelected: !!selectedDate && selectedDate.getFullYear() === y,\n    });\n  }\n  return years;\n}\n\n/** 获取 years 视图标题所显示的年份档区间起点 */\nexport function getYearRangeStart(viewDate: Date): number {\n  const year = viewDate.getFullYear();\n  return year - (year % 12);\n}\n\n/** 中文月份名称 */\nexport const MONTH_NAMES = [\n  '一月', '二月', '三月', '四月', '五月', '六月',\n  '七月', '八月', '九月', '十月', '十一月', '十二月',\n];\n\n/** 中文星期名称 */\nexport const WEEK_DAY_NAMES = ['日', '一', '二', '三', '四', '五', '六'];\n"],"version":3}

package/dist/components/p-08b4005c.js.map

@@ -1 +0,0 @@
-{"file":"p-08b4005c.js","mappings":"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","names":[],"sources":["src/utils/date-helpers.ts"],"sourcesContent":["/**\n * 日历和日期工具函数\n * 从 DatePicker / DateTimePicker / DatePickerPane 中提取的共享逻辑\n */\n\nexport interface CalendarDay {\n  date: Date;\n  isCurrentMonth: boolean;\n  isToday: boolean;\n  isSelected: boolean;\n}\n\n/** 判断两个日期是否为同一天 */\nexport function isSameDay(date1: Date, date2: Date): boolean {\n  return (\n    date1.getFullYear() === date2.getFullYear() &&\n    date1.getMonth() === date2.getMonth() &&\n    date1.getDate() === date2.getDate()\n  );\n}\n\n/** 生成 42 天（6 周）的日历网格数据 */\nexport function getCalendarDays(\n  viewDate: Date,\n  selectedDate?: Date,\n  today: Date = new Date(),\n  firstDayOfWeek: number = 0\n): CalendarDay[] {\n  const days: CalendarDay[] = [];\n  const year = viewDate.getFullYear();\n  const month = viewDate.getMonth();\n\n  const firstDay = new Date(year, month, 1);\n  const lastDay = new Date(year, month + 1, 0);\n  const firstDayWeek = firstDay.getDay();\n  const daysInMonth = lastDay.getDate();\n\n  // 按 firstDayOfWeek 计算需要补多少上月天数。\n  // 默认 firstDayOfWeek=0（周日为首列）时，offset = firstDayWeek；\n  // firstDayOfWeek=1（周一为首列）时，周日的 offset 多 1、周一的 offset 为 0。\n  const offset = ((firstDayWeek - firstDayOfWeek) + 7) % 7;\n\n  // 上月填充\n  const prevMonth = new Date(year, month - 1, 0);\n  for (let i = offset - 1; i >= 0; i--) {\n    const date = new Date(year, month - 1, prevMonth.getDate() - i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 当月日期\n  for (let i = 1; i <= daysInMonth; i++) {\n    const date = new Date(year, month, i);\n    days.push({\n      date,\n      isCurrentMonth: true,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 下月填充（补齐 42 天）\n  const remainingDays = 42 - days.length;\n  for (let i = 1; i <= remainingDays; i++) {\n    const date = new Date(year, month + 1, i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  return days;\n}\n\n/**\n * 格式化日期为指定格式字符串\n * 支持：YYYY, MM, DD, HH, mm, ss\n */\nexport function formatDate(date: Date, format: string): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  const hours = String(date.getHours()).padStart(2, '0');\n  const minutes = String(date.getMinutes()).padStart(2, '0');\n  const seconds = String(date.getSeconds()).padStart(2, '0');\n\n  return format\n    .replace('YYYY', String(year))\n    .replace('MM', month)\n    .replace('DD', day)\n    .replace('HH', hours)\n    .replace('mm', minutes)\n    .replace('ss', seconds);\n}\n\n/** 安全解析日期值 */\nexport function parseDate(value: string | Date | undefined): Date | undefined {\n  if (!value) return undefined;\n  const date = value instanceof Date ? value : new Date(value);\n  if (isNaN(date.getTime())) return undefined;\n  return date;\n}\n\n/** 月份偏移，返回新日期对象（不可变） */\nexport function addMonths(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setMonth(result.getMonth() + delta);\n  return result;\n}\n\n/** 年份偏移，返回新日期对象（不可变） */\nexport function addYears(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setFullYear(result.getFullYear() + delta);\n  return result;\n}\n\n/**\n * 生成 years 视图的 12 年档数据（每档 12 年）。\n * 以 viewDate 所在年份向下取整到 12 的倍数作为起点。\n */\nexport interface CalendarYear {\n  year: number;\n  isCurrentYearRange: boolean;\n  isSelected: boolean;\n}\n\nexport function getCalendarYears(\n  viewDate: Date,\n  selectedDate?: Date,\n  startYearBase?: number\n): CalendarYear[] {\n  const year = viewDate.getFullYear();\n  const rangeStart = startYearBase ?? year - (year % 12);\n  const years: CalendarYear[] = [];\n  for (let i = 0; i < 12; i++) {\n    const y = rangeStart + i;\n    years.push({\n      year: y,\n      isCurrentYearRange: y === year,\n      isSelected: !!selectedDate && selectedDate.getFullYear() === y,\n    });\n  }\n  return years;\n}\n\n/** 获取 years 视图标题所显示的年份档区间起点 */\nexport function getYearRangeStart(viewDate: Date): number {\n  const year = viewDate.getFullYear();\n  return year - (year % 12);\n}\n\n/** 中文月份名称 */\nexport const MONTH_NAMES = [\n  '一月', '二月', '三月', '四月', '五月', '六月',\n  '七月', '八月', '九月', '十月', '十一月', '十二月',\n];\n\n/** 中文星期名称 */\nexport const WEEK_DAY_NAMES = ['日', '一', '二', '三', '四', '五', '六'];\n"],"version":3}