@pactor-app/ui 1.0.0 → 1.2.0

package/dist/components/index.d.cts

@@ -1,6 +1,6 @@
 import { ComponentRegistry } from '@pactor-app/runtime';
 import * as React from 'react';
-import { CSSProperties, ReactNode } from 'react';
+import { CSSProperties, ReactNode, ReactElement } from 'react';
 import { DslNode, DslChildren } from '@pactor-app/core';
 import { LucideIcon } from 'lucide-react';
 import { t as toggleVariants, b as typographyVariants } from '../typography-DsGdDBc2.cjs';
@@ -420,6 +420,51 @@ interface ChartProps {
  */
 declare function Chart({ chartType, data, xKey, yKeys, colors, className, style, }: ChartProps): React.JSX.Element;
 
+interface ChatInputProps {
+    /** 受控值（提供即受控：变更只经 onChange 传出，显示值取自 props） */
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 最小行数（高度随内容自适应，rows 为下限；缺省 3） */
+    rows?: number;
+    /**
+     * 隐藏内建发送钮（工具栏右端完全自定义的场景）；
+     * hideSend 且左右槽均未提供时工具栏行整体零渲染
+     */
+    hideSend?: boolean;
+    /** 工具栏左端槽（DslNode 子树，经 Renderer children 机制渲染） */
+    toolbarStart?: DslNode;
+    /** 工具栏右端槽（发送钮之前） */
+    toolbarEnd?: DslNode;
+    /** 顶部区槽（提供时渲染在 textarea 上方，与 footer 对称；附件卡片、上下文 chips 等输入上下文展示） */
+    header?: DslNode;
+    /** 底部区槽（提供时渲染，与工具栏以分隔线相隔） */
+    footer?: DslNode;
+    /** 输入事件，传出 string 值 */
+    onChange?: (value: string) => void;
+    /** 发送事件（点击发送钮或 Enter），传出当前文本 */
+    onSubmit?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ChatInput 适配器（shadcn kit）：AI 对话输入框的通用结构构件
+ * （spec: shadcn-extended-components / ChatInput）——外层圆角容器
+ * （focus-within 高亮）内依次承载自适应高度 textarea（输入区最小
+ * 高度 60px）、工具栏行与可选底部区；工具栏与底部区内容完全由
+ * DSL 槽位自定义；工具栏行在左右槽均未提供且 hideSend 时整体零渲染。
+ *
+ * 发送语义：点击发送钮或 Enter（Shift+Enter 换行；IME 合成中 Enter
+ * 不发送；trim 后空白禁发且发送钮禁用）；非受控发送后自动清空，
+ * 受控模式由调用方在 onSubmit 闭环里清空。
+ *
+ * 定位为通用结构构件：transport / 附件 / 提及等对话领域能力请使用
+ * @pactor-app/chat 的 Composer。
+ */
+declare function ChatInput({ value, placeholder, disabled, rows, hideSend, toolbarStart, toolbarEnd, header, footer, onChange, onSubmit, className, style, }: ChatInputProps): React.JSX.Element;
+
 interface ContentProps {
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
@@ -968,6 +1013,14 @@ interface MenuItem {
     label: string;
     /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
     icon?: string;
+    /** label 后的角标（inline 模式右对齐展示） */
+    badge?: string | number;
+    /** label 右侧的 danger 系状态圆点（与 badge 可共存） */
+    dot?: boolean;
+    /** 分组标题（inline 模式顶层；相邻同组项只渲染一次） */
+    group?: string;
+    /** 置灰不可选，点击不触发 onSelect */
+    disabled?: boolean;
     children?: MenuItem[];
 }
 interface MenuProps {
@@ -981,13 +1034,14 @@ interface MenuProps {
     onSelect?: (key: string) => void;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
-    /** 通用：根节点内联样式 */
+    /** 通用：根节点内联样式（同 className 挂载规则） */
     style?: CSSProperties;
 }
 /**
  * Menu 导航菜单（shadcn kit）：哑渲染组件——items 经表达式注入，
  * 不直接读取外壳层 MenuRegistry；选中态受控（selectedKey + onSelect
- * 闭环，典型接 navigate 动作）。
+ * 闭环，典型接 navigate 动作）。在 Sidebar 内且侧栏折叠（icon rail）
+ * 时自动降级为仅图标（label / badge / dot / 分组隐藏，hover 经 RailTooltip 展示）。
  */
 declare function Menu({ items, mode, selectedKey, onSelect, className, style, }: MenuProps): React.JSX.Element;
 
@@ -1259,7 +1313,7 @@ interface SheetProps {
  */
 declare function Sheet({ title, open, side, onClose, children, className, style, }: SheetProps): React.JSX.Element;
 
-/** 品牌区：标题 + 可选 logo（图片地址） */
+/** 品牌区：标题 + 可选 logo（图片地址）；也可直接传 ReactNode 自定义 */
 interface SidebarBrand {
     title: string;
     logo?: string;
@@ -1273,27 +1327,46 @@ interface SidebarNavItem {
     children?: SidebarNavItem[];
 }
 interface SidebarProps {
-    /** 品牌区（标题 + 可选 logo） */
-    brand?: SidebarBrand;
-    /** 导航项（可含嵌套 children，可含表达式） */
+    /** 品牌区（{ title, logo } 对象或任意 ReactNode）；移动端渲染在顶栏，桌面端渲染在侧栏顶部品牌行 */
+    brand?: SidebarBrand | ReactNode;
+    /** 导航项（可含嵌套 children，可含表达式）；content 槽提供时不渲染 */
     items?: SidebarNavItem[];
-    /** 是否渲染折叠触发器（折叠态内部维护，经 onCollapse 传出） */
+    /** 侧栏自由内容槽（提供时替代 items 导航；DSL 子树经 Renderer 渲染） */
+    content?: ReactNode;
+    /** 侧栏底部固定区（渲染在滚动区之后，不随内容滚动；未提供不渲染容器） */
+    sidebarFooter?: ReactNode;
+    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（64px，导航仅图标） */
     collapsible?: boolean;
     /** 折叠状态变化事件，传出 boolean */
     onCollapse?: (collapsed: boolean) => void;
+    /** 路由 / 会话切换标识：值变化时移动端抽屉在渲染期关闭 */
+    locationKey?: string;
+    /** 移动端（<768px）侧栏变为覆盖抽屉（缺省 true）；false 时各端均为 flex 行布局 */
+    drawer?: boolean;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
-    /** 通用：根节点内联样式 */
+    /** 通用：根节点内联样式（同 className 挂载规则） */
     style?: CSSProperties;
     /** 主内容区 */
     children?: ReactNode;
 }
+declare function useSidebarDrawer(): {
+    close: () => void;
+    collapsed: boolean;
+} | null;
 /**
- * Sidebar 页面级组合（shadcn kit）：品牌区 + 嵌套导航（href 渲染为锚点、
- * 子菜单缩进展示）的侧栏与 children 主内容区组成的整页布局；样式取
- * sidebar 系列语义令牌；collapsible 时提供折叠触发器。
+ * Sidebar 页面级组合（shadcn kit）：品牌区 + 侧栏（items 嵌套导航或
+ * content 自由内容槽）+ children 主内容区组成的页面外壳；样式取
+ * sidebar 系列语义令牌。
+ *
+ * - 桌面（≥768px）：侧栏与主区 flex 同行；collapsible 时折叠触发器把
+ *   侧栏收窄为 icon rail（64px，导航仅图标、hover 经 RailTooltip 展示）；
+ * - 移动端（<768px，drawer 缺省开启）：侧栏退出文档流变为左侧覆盖
+ *   抽屉——顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化
+ *   关闭，关闭时容器 inert；移动端不渲染折叠触发器；
+ * - 侧栏内容可经 useSidebarDrawer() 取 close / collapsed 自行适配。
  */
-declare function Sidebar({ brand, items, collapsible, onCollapse, className, style, children, }: SidebarProps): React.JSX.Element;
+declare function Sidebar({ brand, items, content, sidebarFooter, collapsible, onCollapse, locationKey, drawer, className, style, children, }: SidebarProps): React.JSX.Element;
 
 interface SiderProps {
     /** 展开宽度（px），默认 200 */
@@ -1638,11 +1711,11 @@ interface TypographyProps {
 declare function Typography({ variant, text, className, style, }: TypographyProps): React.JSX.Element;
 
 /**
- * shadcn kit 组件表：DSL 类型名 → 组件适配器。
- * 类型名集合与 pactor-components 的 builtinComponents 完全一致；
+ * 内置组件表：DSL 类型名 → 组件适配器。
+ * 类型名集合即 spec: builtin-components 的内置组件清单；
  * 容器组件（Tabs / Table）经 `useRenderer().renderChildren` 渲染 DSL 子树。
  */
-declare const shadcnComponents: {
+declare const builtinComponents: {
     readonly Page: typeof Page;
     readonly Grid: typeof Grid;
     readonly Flex: typeof Flex;
@@ -1682,6 +1755,7 @@ declare const shadcnComponents: {
     readonly Slider: typeof Slider;
     readonly Label: typeof Label;
     readonly Field: typeof Field;
+    readonly ChatInput: typeof ChatInput;
     readonly Breadcrumb: typeof Breadcrumb;
     readonly Pagination: typeof Pagination;
     readonly Menubar: typeof Menubar;
@@ -1716,10 +1790,20 @@ declare const shadcnComponents: {
     readonly Chart: typeof Chart;
     readonly Icon: typeof Icon;
 };
-/** 把全部 V1 内置组件（shadcn 实现）按 DSL 类型名注册到给定 ComponentRegistry */
-declare function registerShadcnComponents(registry: ComponentRegistry): void;
-/** 创建并返回注册了全部 V1 内置组件（shadcn 实现）的新 ComponentRegistry */
-declare function createShadcnComponentRegistry(): ComponentRegistry;
+/** 把全部 V1 内置组件按 DSL 类型名注册到给定 ComponentRegistry */
+declare function registerBuiltinComponents(registry: ComponentRegistry): void;
+/** 创建并返回注册了全部 V1 内置组件的新 ComponentRegistry */
+declare function createComponentRegistry(): ComponentRegistry;
+
+/**
+ * icon rail 提示（Sidebar 折叠态：Sidebar items 与 Menu 共用）：
+ * 触发元素本身经 render 合并为 TooltipTrigger（aria/ref/事件不丢失），
+ * 提示浮层显示在图标右侧；仅折叠态使用，展开态无原生 title 干扰。
+ */
+declare function RailTooltip({ label, children, }: {
+    label: string;
+    children: ReactElement;
+}): ReactNode;
 
 /**
  * Form 容器上下文（shadcn kit）：Form 组件维护受控 values / 校验错误
@@ -1751,4 +1835,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, 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, createShadcnComponentRegistry, normalizeIconName, registerShadcnComponents, shadcnComponents, useFormContext };
+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 };

package/dist/components/index.d.ts

@@ -1,6 +1,6 @@
 import { ComponentRegistry } from '@pactor-app/runtime';
 import * as React from 'react';
-import { CSSProperties, ReactNode } from 'react';
+import { CSSProperties, ReactNode, ReactElement } from 'react';
 import { DslNode, DslChildren } from '@pactor-app/core';
 import { LucideIcon } from 'lucide-react';
 import { t as toggleVariants, b as typographyVariants } from '../typography-DsGdDBc2.js';
@@ -420,6 +420,51 @@ interface ChartProps {
  */
 declare function Chart({ chartType, data, xKey, yKeys, colors, className, style, }: ChartProps): React.JSX.Element;
 
+interface ChatInputProps {
+    /** 受控值（提供即受控：变更只经 onChange 传出，显示值取自 props） */
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 最小行数（高度随内容自适应，rows 为下限；缺省 3） */
+    rows?: number;
+    /**
+     * 隐藏内建发送钮（工具栏右端完全自定义的场景）；
+     * hideSend 且左右槽均未提供时工具栏行整体零渲染
+     */
+    hideSend?: boolean;
+    /** 工具栏左端槽（DslNode 子树，经 Renderer children 机制渲染） */
+    toolbarStart?: DslNode;
+    /** 工具栏右端槽（发送钮之前） */
+    toolbarEnd?: DslNode;
+    /** 顶部区槽（提供时渲染在 textarea 上方，与 footer 对称；附件卡片、上下文 chips 等输入上下文展示） */
+    header?: DslNode;
+    /** 底部区槽（提供时渲染，与工具栏以分隔线相隔） */
+    footer?: DslNode;
+    /** 输入事件，传出 string 值 */
+    onChange?: (value: string) => void;
+    /** 发送事件（点击发送钮或 Enter），传出当前文本 */
+    onSubmit?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ChatInput 适配器（shadcn kit）：AI 对话输入框的通用结构构件
+ * （spec: shadcn-extended-components / ChatInput）——外层圆角容器
+ * （focus-within 高亮）内依次承载自适应高度 textarea（输入区最小
+ * 高度 60px）、工具栏行与可选底部区；工具栏与底部区内容完全由
+ * DSL 槽位自定义；工具栏行在左右槽均未提供且 hideSend 时整体零渲染。
+ *
+ * 发送语义：点击发送钮或 Enter（Shift+Enter 换行；IME 合成中 Enter
+ * 不发送；trim 后空白禁发且发送钮禁用）；非受控发送后自动清空，
+ * 受控模式由调用方在 onSubmit 闭环里清空。
+ *
+ * 定位为通用结构构件：transport / 附件 / 提及等对话领域能力请使用
+ * @pactor-app/chat 的 Composer。
+ */
+declare function ChatInput({ value, placeholder, disabled, rows, hideSend, toolbarStart, toolbarEnd, header, footer, onChange, onSubmit, className, style, }: ChatInputProps): React.JSX.Element;
+
 interface ContentProps {
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
@@ -968,6 +1013,14 @@ interface MenuItem {
     label: string;
     /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
     icon?: string;
+    /** label 后的角标（inline 模式右对齐展示） */
+    badge?: string | number;
+    /** label 右侧的 danger 系状态圆点（与 badge 可共存） */
+    dot?: boolean;
+    /** 分组标题（inline 模式顶层；相邻同组项只渲染一次） */
+    group?: string;
+    /** 置灰不可选，点击不触发 onSelect */
+    disabled?: boolean;
     children?: MenuItem[];
 }
 interface MenuProps {
@@ -981,13 +1034,14 @@ interface MenuProps {
     onSelect?: (key: string) => void;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
-    /** 通用：根节点内联样式 */
+    /** 通用：根节点内联样式（同 className 挂载规则） */
     style?: CSSProperties;
 }
 /**
  * Menu 导航菜单（shadcn kit）：哑渲染组件——items 经表达式注入，
  * 不直接读取外壳层 MenuRegistry；选中态受控（selectedKey + onSelect
- * 闭环，典型接 navigate 动作）。
+ * 闭环，典型接 navigate 动作）。在 Sidebar 内且侧栏折叠（icon rail）
+ * 时自动降级为仅图标（label / badge / dot / 分组隐藏，hover 经 RailTooltip 展示）。
  */
 declare function Menu({ items, mode, selectedKey, onSelect, className, style, }: MenuProps): React.JSX.Element;
 
@@ -1259,7 +1313,7 @@ interface SheetProps {
  */
 declare function Sheet({ title, open, side, onClose, children, className, style, }: SheetProps): React.JSX.Element;
 
-/** 品牌区：标题 + 可选 logo（图片地址） */
+/** 品牌区：标题 + 可选 logo（图片地址）；也可直接传 ReactNode 自定义 */
 interface SidebarBrand {
     title: string;
     logo?: string;
@@ -1273,27 +1327,46 @@ interface SidebarNavItem {
     children?: SidebarNavItem[];
 }
 interface SidebarProps {
-    /** 品牌区（标题 + 可选 logo） */
-    brand?: SidebarBrand;
-    /** 导航项（可含嵌套 children，可含表达式） */
+    /** 品牌区（{ title, logo } 对象或任意 ReactNode）；移动端渲染在顶栏，桌面端渲染在侧栏顶部品牌行 */
+    brand?: SidebarBrand | ReactNode;
+    /** 导航项（可含嵌套 children，可含表达式）；content 槽提供时不渲染 */
     items?: SidebarNavItem[];
-    /** 是否渲染折叠触发器（折叠态内部维护，经 onCollapse 传出） */
+    /** 侧栏自由内容槽（提供时替代 items 导航；DSL 子树经 Renderer 渲染） */
+    content?: ReactNode;
+    /** 侧栏底部固定区（渲染在滚动区之后，不随内容滚动；未提供不渲染容器） */
+    sidebarFooter?: ReactNode;
+    /** 是否渲染折叠触发器：折叠后桌面侧栏收窄为 icon rail（64px，导航仅图标） */
     collapsible?: boolean;
     /** 折叠状态变化事件，传出 boolean */
     onCollapse?: (collapsed: boolean) => void;
+    /** 路由 / 会话切换标识：值变化时移动端抽屉在渲染期关闭 */
+    locationKey?: string;
+    /** 移动端（<768px）侧栏变为覆盖抽屉（缺省 true）；false 时各端均为 flex 行布局 */
+    drawer?: boolean;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
-    /** 通用：根节点内联样式 */
+    /** 通用：根节点内联样式（同 className 挂载规则） */
     style?: CSSProperties;
     /** 主内容区 */
     children?: ReactNode;
 }
+declare function useSidebarDrawer(): {
+    close: () => void;
+    collapsed: boolean;
+} | null;
 /**
- * Sidebar 页面级组合（shadcn kit）：品牌区 + 嵌套导航（href 渲染为锚点、
- * 子菜单缩进展示）的侧栏与 children 主内容区组成的整页布局；样式取
- * sidebar 系列语义令牌；collapsible 时提供折叠触发器。
+ * Sidebar 页面级组合（shadcn kit）：品牌区 + 侧栏（items 嵌套导航或
+ * content 自由内容槽）+ children 主内容区组成的页面外壳；样式取
+ * sidebar 系列语义令牌。
+ *
+ * - 桌面（≥768px）：侧栏与主区 flex 同行；collapsible 时折叠触发器把
+ *   侧栏收窄为 icon rail（64px，导航仅图标、hover 经 RailTooltip 展示）；
+ * - 移动端（<768px，drawer 缺省开启）：侧栏退出文档流变为左侧覆盖
+ *   抽屉——顶栏菜单按钮开启，遮罩点击 / Escape / locationKey 变化
+ *   关闭，关闭时容器 inert；移动端不渲染折叠触发器；
+ * - 侧栏内容可经 useSidebarDrawer() 取 close / collapsed 自行适配。
  */
-declare function Sidebar({ brand, items, collapsible, onCollapse, className, style, children, }: SidebarProps): React.JSX.Element;
+declare function Sidebar({ brand, items, content, sidebarFooter, collapsible, onCollapse, locationKey, drawer, className, style, children, }: SidebarProps): React.JSX.Element;
 
 interface SiderProps {
     /** 展开宽度（px），默认 200 */
@@ -1638,11 +1711,11 @@ interface TypographyProps {
 declare function Typography({ variant, text, className, style, }: TypographyProps): React.JSX.Element;
 
 /**
- * shadcn kit 组件表：DSL 类型名 → 组件适配器。
- * 类型名集合与 pactor-components 的 builtinComponents 完全一致；
+ * 内置组件表：DSL 类型名 → 组件适配器。
+ * 类型名集合即 spec: builtin-components 的内置组件清单；
  * 容器组件（Tabs / Table）经 `useRenderer().renderChildren` 渲染 DSL 子树。
  */
-declare const shadcnComponents: {
+declare const builtinComponents: {
     readonly Page: typeof Page;
     readonly Grid: typeof Grid;
     readonly Flex: typeof Flex;
@@ -1682,6 +1755,7 @@ declare const shadcnComponents: {
     readonly Slider: typeof Slider;
     readonly Label: typeof Label;
     readonly Field: typeof Field;
+    readonly ChatInput: typeof ChatInput;
     readonly Breadcrumb: typeof Breadcrumb;
     readonly Pagination: typeof Pagination;
     readonly Menubar: typeof Menubar;
@@ -1716,10 +1790,20 @@ declare const shadcnComponents: {
     readonly Chart: typeof Chart;
     readonly Icon: typeof Icon;
 };
-/** 把全部 V1 内置组件（shadcn 实现）按 DSL 类型名注册到给定 ComponentRegistry */
-declare function registerShadcnComponents(registry: ComponentRegistry): void;
-/** 创建并返回注册了全部 V1 内置组件（shadcn 实现）的新 ComponentRegistry */
-declare function createShadcnComponentRegistry(): ComponentRegistry;
+/** 把全部 V1 内置组件按 DSL 类型名注册到给定 ComponentRegistry */
+declare function registerBuiltinComponents(registry: ComponentRegistry): void;
+/** 创建并返回注册了全部 V1 内置组件的新 ComponentRegistry */
+declare function createComponentRegistry(): ComponentRegistry;
+
+/**
+ * icon rail 提示（Sidebar 折叠态：Sidebar items 与 Menu 共用）：
+ * 触发元素本身经 render 合并为 TooltipTrigger（aria/ref/事件不丢失），
+ * 提示浮层显示在图标右侧；仅折叠态使用，展开态无原生 title 干扰。
+ */
+declare function RailTooltip({ label, children, }: {
+    label: string;
+    children: ReactElement;
+}): ReactNode;
 
 /**
  * Form 容器上下文（shadcn kit）：Form 组件维护受控 values / 校验错误
@@ -1751,4 +1835,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, 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, createShadcnComponentRegistry, normalizeIconName, registerShadcnComponents, shadcnComponents, useFormContext };
+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 };

package/dist/components/index.js

@@ -38,7 +38,6 @@ import {
   Label,
   Layout,
   Link,
-  Menu,
   Menubar,
   NavigationMenu,
   Page,
@@ -51,7 +50,6 @@ import {
   Select,
   Separator,
   Sheet,
-  Sidebar,
   Sider,
   Skeleton,
   Slider,
@@ -67,19 +65,23 @@ import {
   ToggleGroup,
   Tooltip,
   Typography,
-  createShadcnComponentRegistry,
-  registerShadcnComponents,
-  shadcnComponents,
+  builtinComponents,
+  createComponentRegistry,
+  registerBuiltinComponents,
   useFormContext
-} from "../chunk-FVZMNP5P.js";
+} from "../chunk-LMEJ242M.js";
 import {
   ICONS,
   Icon,
-  normalizeIconName
-} from "../chunk-UR3I4WXQ.js";
-import "../chunk-TUXCPXPA.js";
+  Menu,
+  RailTooltip,
+  Sidebar,
+  normalizeIconName,
+  useSidebarDrawer
+} from "../chunk-HJPHJKVA.js";
+import "../chunk-Q5NUGUJG.js";
 import "../chunk-F3H23KYG.js";
-import "../chunk-GL7IO22L.js";
+import "../chunk-2LYMCWEJ.js";
 import "../chunk-RQHJBTEU.js";
 export {
   Accordion,
@@ -131,6 +133,7 @@ export {
   Popover,
   Progress,
   RadioGroup,
+  RailTooltip,
   Resizable,
   ScrollArea,
   Select,
@@ -152,9 +155,10 @@ export {
   ToggleGroup,
   Tooltip,
   Typography,
-  createShadcnComponentRegistry,
+  builtinComponents,
+  createComponentRegistry,
   normalizeIconName,
-  registerShadcnComponents,
-  shadcnComponents,
-  useFormContext
+  registerBuiltinComponents,
+  useFormContext,
+  useSidebarDrawer
 };