@pactor-app/ui 1.2.0 → 1.7.0

package/dist/components/index.d.cts

@@ -558,6 +558,79 @@ interface DataTableProps {
  */
 declare function DataTable({ columns, rows, rowKey, pagination, sort, onSort, onPageChange, className, style, }: DataTableProps): React.JSX.Element;
 
+/** range 模式值（ISO yyyy-MM-dd 对） */
+interface DateRangeValue {
+    start: string;
+    end: string;
+}
+/** 内置预设 key（计算与文案由框架提供，label 可覆盖） */
+type DatePickerPresetKey = 'today' | 'thisWeek' | 'thisMonth';
+/**
+ * presets 数组项的三种形态：
+ * - `{ key, label? }`：内置项（today / thisWeek / thisMonth），label 覆盖内置 i18n 文案
+ * - `{ label, days: N }`：最近 N 天（含今天）
+ * - `{ label, range: { start, end } }`：显式 ISO 区间
+ */
+type DatePickerPreset = {
+    key: DatePickerPresetKey;
+    label?: string;
+} | {
+    label: string;
+    days: number;
+} | {
+    label: string;
+    range: DateRangeValue;
+};
+interface DatePickerCommonProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 占位文案（缺省取 i18n key，按 mode 区分 single/range） */
+    placeholder?: string;
+    disabled?: boolean;
+    /**
+     * 快捷预设栏：未提供时 range 模式缺省为内置三项（今天/本周/本月），
+     * single 模式不渲染；`false` 显式关闭
+     */
+    presets?: DatePickerPreset[] | false;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+interface DatePickerSingleProps extends DatePickerCommonProps {
+    /** 选择模式（缺省 single） */
+    mode?: 'single';
+    /** 受控值（ISO 日期字符串 yyyy-MM-dd）；Form 内作为字段初始值 */
+    value?: string;
+    /** 选中日期事件，传出 ISO 日期字符串（yyyy-MM-dd），清除传 undefined */
+    onChange?: (value: string | undefined) => void;
+}
+interface DatePickerRangeProps extends DatePickerCommonProps {
+    mode: 'range';
+    /** 受控值（{ start, end } ISO 对）；Form 内作为字段初始值 */
+    value?: DateRangeValue;
+    /** 范围选定事件，仅两端齐备时触发，传出 { start, end } ISO 对象 */
+    onChange?: (value: DateRangeValue | undefined) => void;
+}
+type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
+/**
+ * DatePicker 适配器（shadcn kit）：input 风格触发器 + 受控 Popover 内嵌
+ * vendored Calendar（react-day-picker）。`mode: 'single' | 'range'`；
+ * 值契约：single 为 ISO 字符串（yyyy-MM-dd），range 为 `{ start, end }`
+ * ISO 对象（仅两端齐备才触发 onChange）。range 为左右双面板（两个
+ * `mode="single"` 日历，各自受控月份与导航箭头），选择语义为
+ * 「任意面板两次点击」：首击设开始日并清空结束日，第二击不早于开始日
+ * 即提交、早于则重新开始，已有完整区间再点击开始新一轮。
+ * presets 快捷选择（除定位型「今天」外点击即完成选择、触发 onChange、
+ * 不关浮层）；默认文案走 `pactor.datePicker.*` i18n key，日历本体按
+ * useI18n().locale 映射 date-fns locale。Form 内声明 `name` 自动成为表单项。
+ */
+declare function DatePicker(props: DatePickerProps): React.JSX.Element;
+
 interface DialogProps {
     /** 对话框标题 */
     title?: string;
@@ -685,7 +758,11 @@ interface FlexProps {
     style?: CSSProperties;
     children?: ReactNode;
 }
-/** Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联 */
+/**
+ * Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联。
+ * gap 未指定时应用默认间距令牌 `--flex-gap`（命名档位读
+ * `--flex-gap-sm/md/lg`），均可被皮肤 CSS 覆盖；`gap: 0` 显式关闭。
+ */
 declare function Flex({ direction, gap, justify, align, className, style, children, }: FlexProps): React.JSX.Element;
 
 interface FooterProps {
@@ -733,7 +810,7 @@ declare function Form({ name, layout, initialValues, className, style, children,
 interface GridProps {
     /** 列数，默认 1；每列等宽（columns 取整下限 1） */
     columns?: number;
-    /** 栏间距 */
+    /** 栏间距（px）；未指定时应用默认间距令牌 `--grid-gap`，`gap: 0` 显式关闭 */
     gap?: number;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
@@ -1030,6 +1107,13 @@ interface MenuProps {
     mode?: 'inline' | 'horizontal';
     /** 受控选中项 key（可绑 `${state.x}`） */
     selectedKey?: string;
+    /**
+     * 可折叠子菜单（仅 inline 模式生效，缺省 false）：含 children 的目录项
+     * 点击展开/收起（不触发 onSelect），右端 chevron 指示
+     */
+    collapsible?: boolean;
+    /** 初始展开的目录 key（与 selectedKey 祖先链合并；展开状态非受控） */
+    defaultExpandedKeys?: string[];
     /** 选中变化事件，传出选中项 key */
     onSelect?: (key: string) => void;
     /** 通用：根节点 class（与内置样式合并） */
@@ -1042,8 +1126,11 @@ interface MenuProps {
  * 不直接读取外壳层 MenuRegistry；选中态受控（selectedKey + onSelect
  * 闭环，典型接 navigate 动作）。在 Sidebar 内且侧栏折叠（icon rail）
  * 时自动降级为仅图标（label / badge / dot / 分组隐藏，hover 经 RailTooltip 展示）。
+ * `collapsible`（仅 inline 模式）使含 children 的目录项可展开/收起：
+ * 点击目录项只 toggle 不触发 onSelect，右端 chevron 展开时旋转 180°；
+ * 展开状态内部维护，初始为 defaultExpandedKeys ∪ selectedKey 祖先链。
  */
-declare function Menu({ items, mode, selectedKey, onSelect, className, style, }: MenuProps): React.JSX.Element;
+declare function Menu({ items, mode, selectedKey, collapsible, defaultExpandedKeys, onSelect, className, style, }: MenuProps): React.JSX.Element;
 
 /** 菜单项（叶子）；value 为 onSelect 传出值 */
 interface MenubarLeafItem {
@@ -1203,6 +1290,12 @@ interface ResizablePanelData {
     children?: DslNode[];
     /** 默认尺寸（百分比，0-100） */
     defaultSize?: number;
+    /** 默认尺寸（像素；与 defaultSize 同时提供时优先生效） */
+    defaultSizePx?: number;
+    /** 最小尺寸（像素） */
+    minSizePx?: number;
+    /** 最大尺寸（像素） */
+    maxSizePx?: number;
 }
 interface ResizableProps {
     /** 面板列表（相邻面板间渲染拖拽手柄） */
@@ -1217,7 +1310,8 @@ interface ResizableProps {
 /**
  * Resizable 适配器（shadcn kit）：基于 vendored Resizable
  * （react-resizable-panels）；panels 声明面板，相邻面板间为可拖拽手柄；
- * DSL 的 defaultSize 统一按百分比解释。
+ * DSL 的 defaultSize 统一按百分比解释，defaultSizePx/minSizePx/maxSizePx
+ * 按像素解释（像素优先级高于百分比）。
  */
 declare function Resizable({ panels, direction, className, style, }: ResizableProps): React.JSX.Element;
 
@@ -1335,7 +1429,7 @@ interface SidebarProps {
     content?: ReactNode;
     /** 侧栏底部固定区（渲染在滚动区之后，不随内容滚动；未提供不渲染容器） */
     sidebarFooter?: ReactNode;
-    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（64px，导航仅图标） */
+    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（导航仅图标） */
     collapsible?: boolean;
     /** 折叠状态变化事件，传出 boolean */
     onCollapse?: (collapsed: boolean) => void;
@@ -1350,21 +1444,28 @@ interface SidebarProps {
     /** 主内容区 */
     children?: ReactNode;
 }
+/**
+ * 侧栏抽屉 context（向后兼容）：侧栏内容（如 Menu）经 `useSidebarDrawer()` 取
+ * `close()`（导航后关闭移动端抽屉）与 `collapsed`（桌面 icon rail 状态）；
+ * 不在 Sidebar 内时返回 null。
+ *
+ * 内部桥接 shadcn Sidebar 的 useSidebar context。
+ */
 declare function useSidebarDrawer(): {
     close: () => void;
     collapsed: boolean;
 } | null;
 /**
  * Sidebar 页面级组合（shadcn kit）：品牌区 + 侧栏（items 嵌套导航或
- * content 自由内容槽）+ children 主内容区组成的页面外壳；样式取
- * sidebar 系列语义令牌。
+ * content 自由内容槽）+ children 主内容区组成的页面外壳。
  *
- * - 桌面（≥768px）：侧栏与主区 flex 同行；collapsible 时折叠触发器把
- *   侧栏收窄为 icon rail（64px，导航仅图标、hover 经 RailTooltip 展示）；
- * - 移动端（<768px，drawer 缺省开启）：侧栏退出文档流变为左侧覆盖
- *   抽屉——顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化
- *   关闭，关闭时容器 inert；移动端不渲染折叠触发器；
+ * 内部组合 shadcn Sidebar 原语（SidebarProvider / Sidebar / SidebarInset）：
+ * - 桌面（≥768px）：侧栏与主区同行；collapsible 时折叠触发器把
+ *   侧栏收窄为 icon rail（导航仅图标、hover 经 Tooltip 展示）；
+ * - 移动端（<768px，drawer 缺省开启）：侧栏变为 Sheet 覆盖抽屉——
+ *   顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化关闭；
  * - 侧栏内容可经 useSidebarDrawer() 取 close / collapsed 自行适配。
+ * - ⌘B / Ctrl+B 键盘快捷键切换侧栏（shadcn SidebarProvider 内建）。
  */
 declare function Sidebar({ brand, items, content, sidebarFooter, collapsible, onCollapse, locationKey, drawer, className, style, children, }: SidebarProps): React.JSX.Element;
 
@@ -1773,6 +1874,7 @@ declare const builtinComponents: {
     readonly Tooltip: typeof Tooltip;
     readonly HoverCard: typeof HoverCard;
     readonly Calendar: typeof Calendar;
+    readonly DatePicker: typeof DatePicker;
     readonly InputOTP: typeof InputOTP;
     readonly Combobox: typeof Combobox;
     readonly Carousel: typeof Carousel;
@@ -1835,4 +1937,4 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-export { Accordion, type AccordionItemData, type AccordionProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, AspectRatio, type AspectRatioProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeVariant, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Chart, type ChartProps, type ChartType, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, Dialog, type DialogProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderUser, type HeaderUserItem, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, Link, type LinkProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Page, type PageProps, Pagination, type PaginationProps, Popover, type PopoverProps, Progress, type ProgressProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Resizable, type ResizablePanelData, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Typography, type TypographyProps, type TypographyVariant, builtinComponents, createComponentRegistry, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };
+export { Accordion, type AccordionItemData, type AccordionProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, AspectRatio, type AspectRatioProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeVariant, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Chart, type ChartProps, type ChartType, ChatInput, type ChatInputProps, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Dialog, type DialogProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderUser, type HeaderUserItem, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, Link, type LinkProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Page, type PageProps, Pagination, type PaginationProps, Popover, type PopoverProps, Progress, type ProgressProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Resizable, type ResizablePanelData, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Typography, type TypographyProps, type TypographyVariant, builtinComponents, createComponentRegistry, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };

package/dist/components/index.d.ts

@@ -558,6 +558,79 @@ interface DataTableProps {
  */
 declare function DataTable({ columns, rows, rowKey, pagination, sort, onSort, onPageChange, className, style, }: DataTableProps): React.JSX.Element;
 
+/** range 模式值（ISO yyyy-MM-dd 对） */
+interface DateRangeValue {
+    start: string;
+    end: string;
+}
+/** 内置预设 key（计算与文案由框架提供，label 可覆盖） */
+type DatePickerPresetKey = 'today' | 'thisWeek' | 'thisMonth';
+/**
+ * presets 数组项的三种形态：
+ * - `{ key, label? }`：内置项（today / thisWeek / thisMonth），label 覆盖内置 i18n 文案
+ * - `{ label, days: N }`：最近 N 天（含今天）
+ * - `{ label, range: { start, end } }`：显式 ISO 区间
+ */
+type DatePickerPreset = {
+    key: DatePickerPresetKey;
+    label?: string;
+} | {
+    label: string;
+    days: number;
+} | {
+    label: string;
+    range: DateRangeValue;
+};
+interface DatePickerCommonProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 占位文案（缺省取 i18n key，按 mode 区分 single/range） */
+    placeholder?: string;
+    disabled?: boolean;
+    /**
+     * 快捷预设栏：未提供时 range 模式缺省为内置三项（今天/本周/本月），
+     * single 模式不渲染；`false` 显式关闭
+     */
+    presets?: DatePickerPreset[] | false;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+interface DatePickerSingleProps extends DatePickerCommonProps {
+    /** 选择模式（缺省 single） */
+    mode?: 'single';
+    /** 受控值（ISO 日期字符串 yyyy-MM-dd）；Form 内作为字段初始值 */
+    value?: string;
+    /** 选中日期事件，传出 ISO 日期字符串（yyyy-MM-dd），清除传 undefined */
+    onChange?: (value: string | undefined) => void;
+}
+interface DatePickerRangeProps extends DatePickerCommonProps {
+    mode: 'range';
+    /** 受控值（{ start, end } ISO 对）；Form 内作为字段初始值 */
+    value?: DateRangeValue;
+    /** 范围选定事件，仅两端齐备时触发，传出 { start, end } ISO 对象 */
+    onChange?: (value: DateRangeValue | undefined) => void;
+}
+type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
+/**
+ * DatePicker 适配器（shadcn kit）：input 风格触发器 + 受控 Popover 内嵌
+ * vendored Calendar（react-day-picker）。`mode: 'single' | 'range'`；
+ * 值契约：single 为 ISO 字符串（yyyy-MM-dd），range 为 `{ start, end }`
+ * ISO 对象（仅两端齐备才触发 onChange）。range 为左右双面板（两个
+ * `mode="single"` 日历，各自受控月份与导航箭头），选择语义为
+ * 「任意面板两次点击」：首击设开始日并清空结束日，第二击不早于开始日
+ * 即提交、早于则重新开始，已有完整区间再点击开始新一轮。
+ * presets 快捷选择（除定位型「今天」外点击即完成选择、触发 onChange、
+ * 不关浮层）；默认文案走 `pactor.datePicker.*` i18n key，日历本体按
+ * useI18n().locale 映射 date-fns locale。Form 内声明 `name` 自动成为表单项。
+ */
+declare function DatePicker(props: DatePickerProps): React.JSX.Element;
+
 interface DialogProps {
     /** 对话框标题 */
     title?: string;
@@ -685,7 +758,11 @@ interface FlexProps {
     style?: CSSProperties;
     children?: ReactNode;
 }
-/** Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联 */
+/**
+ * Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联。
+ * gap 未指定时应用默认间距令牌 `--flex-gap`（命名档位读
+ * `--flex-gap-sm/md/lg`），均可被皮肤 CSS 覆盖；`gap: 0` 显式关闭。
+ */
 declare function Flex({ direction, gap, justify, align, className, style, children, }: FlexProps): React.JSX.Element;
 
 interface FooterProps {
@@ -733,7 +810,7 @@ declare function Form({ name, layout, initialValues, className, style, children,
 interface GridProps {
     /** 列数，默认 1；每列等宽（columns 取整下限 1） */
     columns?: number;
-    /** 栏间距 */
+    /** 栏间距（px）；未指定时应用默认间距令牌 `--grid-gap`，`gap: 0` 显式关闭 */
     gap?: number;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
@@ -1030,6 +1107,13 @@ interface MenuProps {
     mode?: 'inline' | 'horizontal';
     /** 受控选中项 key（可绑 `${state.x}`） */
     selectedKey?: string;
+    /**
+     * 可折叠子菜单（仅 inline 模式生效，缺省 false）：含 children 的目录项
+     * 点击展开/收起（不触发 onSelect），右端 chevron 指示
+     */
+    collapsible?: boolean;
+    /** 初始展开的目录 key（与 selectedKey 祖先链合并；展开状态非受控） */
+    defaultExpandedKeys?: string[];
     /** 选中变化事件，传出选中项 key */
     onSelect?: (key: string) => void;
     /** 通用：根节点 class（与内置样式合并） */
@@ -1042,8 +1126,11 @@ interface MenuProps {
  * 不直接读取外壳层 MenuRegistry；选中态受控（selectedKey + onSelect
  * 闭环，典型接 navigate 动作）。在 Sidebar 内且侧栏折叠（icon rail）
  * 时自动降级为仅图标（label / badge / dot / 分组隐藏，hover 经 RailTooltip 展示）。
+ * `collapsible`（仅 inline 模式）使含 children 的目录项可展开/收起：
+ * 点击目录项只 toggle 不触发 onSelect，右端 chevron 展开时旋转 180°；
+ * 展开状态内部维护，初始为 defaultExpandedKeys ∪ selectedKey 祖先链。
  */
-declare function Menu({ items, mode, selectedKey, onSelect, className, style, }: MenuProps): React.JSX.Element;
+declare function Menu({ items, mode, selectedKey, collapsible, defaultExpandedKeys, onSelect, className, style, }: MenuProps): React.JSX.Element;
 
 /** 菜单项（叶子）；value 为 onSelect 传出值 */
 interface MenubarLeafItem {
@@ -1203,6 +1290,12 @@ interface ResizablePanelData {
     children?: DslNode[];
     /** 默认尺寸（百分比，0-100） */
     defaultSize?: number;
+    /** 默认尺寸（像素；与 defaultSize 同时提供时优先生效） */
+    defaultSizePx?: number;
+    /** 最小尺寸（像素） */
+    minSizePx?: number;
+    /** 最大尺寸（像素） */
+    maxSizePx?: number;
 }
 interface ResizableProps {
     /** 面板列表（相邻面板间渲染拖拽手柄） */
@@ -1217,7 +1310,8 @@ interface ResizableProps {
 /**
  * Resizable 适配器（shadcn kit）：基于 vendored Resizable
  * （react-resizable-panels）；panels 声明面板，相邻面板间为可拖拽手柄；
- * DSL 的 defaultSize 统一按百分比解释。
+ * DSL 的 defaultSize 统一按百分比解释，defaultSizePx/minSizePx/maxSizePx
+ * 按像素解释（像素优先级高于百分比）。
  */
 declare function Resizable({ panels, direction, className, style, }: ResizableProps): React.JSX.Element;
 
@@ -1335,7 +1429,7 @@ interface SidebarProps {
     content?: ReactNode;
     /** 侧栏底部固定区（渲染在滚动区之后，不随内容滚动；未提供不渲染容器） */
     sidebarFooter?: ReactNode;
-    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（64px，导航仅图标） */
+    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（导航仅图标） */
     collapsible?: boolean;
     /** 折叠状态变化事件，传出 boolean */
     onCollapse?: (collapsed: boolean) => void;
@@ -1350,21 +1444,28 @@ interface SidebarProps {
     /** 主内容区 */
     children?: ReactNode;
 }
+/**
+ * 侧栏抽屉 context（向后兼容）：侧栏内容（如 Menu）经 `useSidebarDrawer()` 取
+ * `close()`（导航后关闭移动端抽屉）与 `collapsed`（桌面 icon rail 状态）；
+ * 不在 Sidebar 内时返回 null。
+ *
+ * 内部桥接 shadcn Sidebar 的 useSidebar context。
+ */
 declare function useSidebarDrawer(): {
     close: () => void;
     collapsed: boolean;
 } | null;
 /**
  * Sidebar 页面级组合（shadcn kit）：品牌区 + 侧栏（items 嵌套导航或
- * content 自由内容槽）+ children 主内容区组成的页面外壳；样式取
- * sidebar 系列语义令牌。
+ * content 自由内容槽）+ children 主内容区组成的页面外壳。
  *
- * - 桌面（≥768px）：侧栏与主区 flex 同行；collapsible 时折叠触发器把
- *   侧栏收窄为 icon rail（64px，导航仅图标、hover 经 RailTooltip 展示）；
- * - 移动端（<768px，drawer 缺省开启）：侧栏退出文档流变为左侧覆盖
- *   抽屉——顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化
- *   关闭，关闭时容器 inert；移动端不渲染折叠触发器；
+ * 内部组合 shadcn Sidebar 原语（SidebarProvider / Sidebar / SidebarInset）：
+ * - 桌面（≥768px）：侧栏与主区同行；collapsible 时折叠触发器把
+ *   侧栏收窄为 icon rail（导航仅图标、hover 经 Tooltip 展示）；
+ * - 移动端（<768px，drawer 缺省开启）：侧栏变为 Sheet 覆盖抽屉——
+ *   顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化关闭；
  * - 侧栏内容可经 useSidebarDrawer() 取 close / collapsed 自行适配。
+ * - ⌘B / Ctrl+B 键盘快捷键切换侧栏（shadcn SidebarProvider 内建）。
  */
 declare function Sidebar({ brand, items, content, sidebarFooter, collapsible, onCollapse, locationKey, drawer, className, style, children, }: SidebarProps): React.JSX.Element;
 
@@ -1773,6 +1874,7 @@ declare const builtinComponents: {
     readonly Tooltip: typeof Tooltip;
     readonly HoverCard: typeof HoverCard;
     readonly Calendar: typeof Calendar;
+    readonly DatePicker: typeof DatePicker;
     readonly InputOTP: typeof InputOTP;
     readonly Combobox: typeof Combobox;
     readonly Carousel: typeof Carousel;
@@ -1835,4 +1937,4 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-export { Accordion, type AccordionItemData, type AccordionProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, AspectRatio, type AspectRatioProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeVariant, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Chart, type ChartProps, type ChartType, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, Dialog, type DialogProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderUser, type HeaderUserItem, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, Link, type LinkProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Page, type PageProps, Pagination, type PaginationProps, Popover, type PopoverProps, Progress, type ProgressProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Resizable, type ResizablePanelData, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Typography, type TypographyProps, type TypographyVariant, builtinComponents, createComponentRegistry, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };
+export { Accordion, type AccordionItemData, type AccordionProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, AspectRatio, type AspectRatioProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeVariant, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Chart, type ChartProps, type ChartType, ChatInput, type ChatInputProps, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Dialog, type DialogProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderUser, type HeaderUserItem, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, Link, type LinkProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Page, type PageProps, Pagination, type PaginationProps, Popover, type PopoverProps, Progress, type ProgressProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Resizable, type ResizablePanelData, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Typography, type TypographyProps, type TypographyVariant, builtinComponents, createComponentRegistry, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };

package/dist/components/index.js

@@ -12,6 +12,7 @@ import {
   Card,
   Carousel,
   Chart,
+  ChatInput,
   Checkbox,
   Collapsible,
   Combobox,
@@ -19,6 +20,7 @@ import {
   Content,
   ContextMenu,
   DataTable,
+  DatePicker,
   Dialog,
   Drawer,
   DropdownMenu,
@@ -69,7 +71,7 @@ import {
   createComponentRegistry,
   registerBuiltinComponents,
   useFormContext
-} from "../chunk-LMEJ242M.js";
+} from "../chunk-PMYLC26E.js";
 import {
   ICONS,
   Icon,
@@ -78,11 +80,11 @@ import {
   Sidebar,
   normalizeIconName,
   useSidebarDrawer
-} from "../chunk-HJPHJKVA.js";
-import "../chunk-Q5NUGUJG.js";
-import "../chunk-F3H23KYG.js";
-import "../chunk-2LYMCWEJ.js";
-import "../chunk-RQHJBTEU.js";
+} from "../chunk-ZM3WJZZ7.js";
+import "../chunk-E2TD6JD2.js";
+import "../chunk-F42SGQNW.js";
+import "../chunk-L4Z7MNYY.js";
+import "../chunk-WKJUCGV4.js";
 export {
   Accordion,
   Alert,
@@ -97,6 +99,7 @@ export {
   Card,
   Carousel,
   Chart,
+  ChatInput,
   Checkbox,
   Collapsible,
   Combobox,
@@ -104,6 +107,7 @@ export {
   Content,
   ContextMenu,
   DataTable,
+  DatePicker,
   Dialog,
   Drawer,
   DropdownMenu,