@pactor-app/ui 0.1.0 → 1.1.0

package/dist/components/index.d.ts

@@ -1,7 +1,36 @@
 import { ComponentRegistry } from '@pactor-app/runtime';
 import * as React from 'react';
-import { ReactNode } from 'react';
-import { DslNode } from '@pactor-app/core';
+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';
+import { VariantProps } from 'class-variance-authority';
+import 'class-variance-authority/types';
+import '@base-ui/react/toggle';
+
+/** 手风琴面板；`children` 为 DSL 子树，经 Renderer children 机制渲染 */
+interface AccordionItemData {
+    key: string;
+    title: string;
+    children?: DslNode[];
+}
+interface AccordionProps {
+    /** 面板列表（可含表达式解析后的数组） */
+    items?: AccordionItemData[];
+    /** 允许收起全部面板（契约兼容字段；Base UI single 模式天然允许收起） */
+    collapsible?: boolean;
+    /** 允许多个面板同时展开 */
+    multiple?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Accordion 适配器（shadcn kit）：items 声明面板，pane 内容经
+ * renderChildren 渲染 DSL 子树；multiple 切换单开/多开模式。
+ */
+declare function Accordion({ items, multiple, className, style, }: AccordionProps): React.JSX.Element;
 
 /** DSL Alert 变体 */
 type AlertVariant = 'success' | 'info' | 'warning' | 'error';
@@ -12,9 +41,105 @@ interface AlertProps {
     description?: string;
     /** 变体，默认 info */
     variant?: AlertVariant;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
 }
 /** Alert 适配器（shadcn kit）：message → AlertTitle，description → AlertDescription */
-declare function Alert({ message, description, variant }: AlertProps): React.JSX.Element;
+declare function Alert({ message, description, variant, className, style }: AlertProps): React.JSX.Element;
+
+interface AlertDialogProps {
+    /** 标题 */
+    title?: string;
+    /** 说明内容 */
+    description?: string;
+    /** 确认按钮文案（缺省取 i18n `pactor.alertDialog.confirm`，与 InteractionProvider confirm 一致） */
+    confirmText?: string;
+    /** 取消按钮文案（缺省取 i18n `pactor.alertDialog.cancel`） */
+    cancelText?: string;
+    /** 受控开关（可绑表达式）；缺省时由 trigger 自管理 */
+    open?: boolean;
+    /** 确认事件：点击确认按钮触发，且弹层关闭 */
+    onConfirm?: () => void;
+    /** 取消事件：点击取消按钮触发，且弹层关闭 */
+    onCancel?: () => void;
+    /** 触发元素（DSL 子树，非受控用法下点击打开） */
+    trigger?: DslNode;
+    /** 通用：根节点 class（挂在弹层内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * AlertDialog 适配器（shadcn kit）：确认/取消按钮语义化封装——
+ * 点击确认先执行 onConfirm 再关闭（Action 为 Base UI Close，
+ * 关闭由原语完成）；取消同理执行 onCancel。与 vendored dialog
+ * 共享 Backdrop/Popup，视觉与 OverlayHost modal 一致（design D4）。
+ */
+declare function AlertDialog({ title, description, confirmText, cancelText, open, onConfirm, onCancel, trigger, className, style, }: AlertDialogProps): React.JSX.Element;
+
+interface AspectRatioProps {
+    /** 宽高比（如 16/9，数字或 `'16/9'` 字符串），默认 1 */
+    ratio?: number | string;
+    /** 内容（DSL 子树，经 Renderer children 机制渲染，按比例约束） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** AspectRatio 适配器（shadcn kit）：ratio → CSS aspect-ratio 容器 */
+declare function AspectRatio({ ratio, children, className, style }: AspectRatioProps): React.JSX.Element;
+
+interface AvatarProps {
+    /** 图片地址 */
+    src?: string;
+    /** 图片替代文本 */
+    alt?: string;
+    /** 加载失败或缺省时的占位文本（如首字母） */
+    fallback?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Avatar 适配器（shadcn kit）：src / alt / fallback → vendored Avatar */
+declare function Avatar({ src, alt, fallback, className, style }: AvatarProps): React.JSX.Element;
+
+/** DSL Badge 变体 */
+type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline';
+interface BadgeProps {
+    /** 徽标文本 */
+    text?: string;
+    /** 变体，默认 default */
+    variant?: BadgeVariant;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Badge 适配器（shadcn kit）：text / variant → vendored Badge */
+declare function Badge({ text, variant, className, style }: BadgeProps): React.JSX.Element;
+
+/** 面包屑项；href 缺省时渲染为纯文本 */
+interface BreadcrumbItemData {
+    label: string;
+    href?: string;
+}
+interface BreadcrumbProps {
+    /** 路径项（可含表达式解析后的数组）；末项始终为当前页纯文本 */
+    items?: BreadcrumbItemData[];
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Breadcrumb 适配器（shadcn kit）：items 声明路径，带 href 的非末项
+ * 渲染为可点击链接，末项渲染为当前页纯文本（aria-current="page"）。
+ */
+declare function Breadcrumb({ items, className, style }: BreadcrumbProps): React.JSX.Element;
 
 /** DSL Button 变体（框架级协议） */
 type ButtonVariant = 'default' | 'primary' | 'dashed' | 'link' | 'text';
@@ -34,6 +159,10 @@ interface ButtonProps {
     submit?: boolean;
     /** 点击事件（Renderer 绑定 events.onClick） */
     onClick?: () => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
     children?: ReactNode;
 }
 /**
@@ -42,17 +171,504 @@ interface ButtonProps {
  * Form 的提交按钮（type=submit）；danger 映射 destructive（link/text
  * 变体保持原样、文字标红）；loading 显示旋转图标并禁用。
  */
-declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, children, }: ButtonProps): React.JSX.Element;
+declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
+
+interface ButtonGroupProps {
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    /** 若干 Button（渲染好的 ReactNode） */
+    children?: ReactNode;
+}
+/** ButtonGroup 适配器（shadcn kit）：children 为若干 Button，渲染为相连按钮组 */
+declare function ButtonGroup({ className, style, children }: ButtonGroupProps): React.JSX.Element;
+
+/** DSL 校验规则（框架级协议，当前支持 required + message） */
+interface FieldRule {
+    required?: boolean;
+    message?: string;
+}
+interface InputProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string;
+    /** 输入类型：password 时掩码输入（缺省 text） */
+    type?: 'text' | 'password';
+    placeholder?: string;
+    disabled?: boolean;
+    /** 输入事件，传出 string 值（非原生 event，设计决策 D2） */
+    onChange?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Input 适配器（shadcn kit，语义对齐 antd 版）：
+ * 在 Form 内且声明 `name` 时自动成为表单项（label / rules 生效，
+ * 值由 Form 上下文托管）；否则渲染独立受控控件，onChange 传出 string。
+ * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
+ * `<label htmlFor>` 与控件 `useId` 关联。
+ */
+declare function Input({ name, label, rules, value, type, placeholder, disabled, onChange, className, style, }: InputProps): React.JSX.Element;
+
+interface CalendarProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选择模式（当前仅支持 single） */
+    mode?: 'single';
+    /** 受控值（ISO 日期字符串 yyyy-MM-dd）；Form 内作为字段初始值 */
+    value?: string;
+    disabled?: boolean;
+    /** 选中日期事件，传出 ISO 日期字符串（yyyy-MM-dd），清除传 undefined */
+    onChange?: (value: string | undefined) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Calendar 适配器（shadcn kit）：基于 vendored Calendar（react-day-picker）；
+ * DSL 值为 ISO 日期字符串（yyyy-MM-dd），onChange 同样传出 ISO 字符串
+ * （DSL 语义值，非 Date 对象）；Form 内声明 `name` 自动成为表单项。
+ */
+declare function Calendar({ name, label, rules, mode, value, disabled, onChange, className, style, }: CalendarProps): React.JSX.Element;
 
 interface CardProps {
     /** 卡片标题，可选 */
     title?: string;
     /** 是否有边框，默认 true（false 去边框与阴影） */
     bordered?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（布局逃逸口，如 `{ flex: 1 }`） */
+    style?: CSSProperties;
     children?: ReactNode;
 }
 /** Card 适配器（shadcn kit）：可选标题 + 边框开关（bordered=false 去边框与阴影） */
-declare function Card({ title, bordered, children }: CardProps): React.JSX.Element;
+declare function Card({ title, bordered, className, style, children }: CardProps): React.JSX.Element;
+
+/** 轮播图片项 */
+interface CarouselImage {
+    src: string;
+    alt?: string;
+}
+/** Carousel items 元素：图片对象或 DSL 子树 */
+type CarouselItemData = CarouselImage | DslNode;
+interface CarouselProps {
+    /** 轮播项：图片 `{ src, alt }` 数组或 DSL 子树数组（经 renderChildren 渲染） */
+    items?: CarouselItemData[];
+    /** 循环滚动 */
+    loop?: boolean;
+    /** 自动播放：true 用默认间隔（3000ms），数字为间隔毫秒数 */
+    autoplay?: boolean | number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Carousel 适配器（shadcn kit）：基于 vendored Carousel（embla-carousel-react）；
+ * items 支持图片对象或 DSL 子树；`loop` 映射 embla loop；
+ * `autoplay` 以定时器驱动 scrollNext（loop 时回绕），不引入额外插件依赖。
+ */
+declare function Carousel({ items, loop, autoplay, className, style, }: CarouselProps): React.JSX.Element;
+
+interface CheckboxProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 勾选框旁的标签文本 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: boolean;
+    disabled?: boolean;
+    /** 勾选变化事件，传出 boolean */
+    onChange?: (checked: boolean) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Checkbox 适配器（shadcn kit）：基于 vendored Checkbox（Base UI）；
+ * label 渲染在勾选框旁并与之关联；onChange 传出 boolean。
+ */
+declare function Checkbox({ name, label, rules, value, disabled, onChange, className, style, }: CheckboxProps): React.JSX.Element;
+
+interface CollapsibleProps {
+    /** 触发区标题 */
+    title?: string;
+    /** 受控开关（可绑 `${state.x}` 表达式）；缺省内部自管理 */
+    open?: boolean;
+    /** 折叠内容（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Collapsible 适配器（shadcn kit）：title 触发区 + children 折叠内容；
+ * open 受控（缺省内部自管理）。
+ */
+declare function Collapsible({ title, open, children, className, style, }: CollapsibleProps): React.JSX.Element;
+
+/** Combobox 选项（支持表达式解析后的数组） */
+interface ComboboxOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+}
+interface ComboboxProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选项列表 */
+    options?: ComboboxOption[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string | number;
+    placeholder?: string;
+    /** 是否可搜索过滤（缺省 true） */
+    searchable?: boolean;
+    disabled?: boolean;
+    /** 选中变化事件，传出选中项的原始 value */
+    onChange?: (value: string | number | undefined) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Combobox 适配器（shadcn kit）：vendored Combobox（Popover + Command 组合）；
+ * 支持搜索过滤；onChange 传出选中项原始 value（DSL 语义值）；
+ * Form 内声明 `name` 自动成为表单项。
+ */
+declare function Combobox({ name, label, rules, options, value, placeholder, searchable, disabled, onChange, className, style, }: ComboboxProps): React.JSX.Element;
+
+/** Command 命令项 */
+interface CommandItemData {
+    label: string;
+    value: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+    disabled?: boolean;
+}
+/** Command 分组 */
+interface CommandGroupData {
+    heading?: string;
+    items: CommandItemData[];
+}
+interface CommandProps {
+    /** 分组列表 */
+    groups?: CommandGroupData[];
+    /** 搜索框占位文本 */
+    placeholder?: string;
+    /** 空结果文案（缺省取 i18n `pactor.command.empty`） */
+    emptyText?: string;
+    /** 选中事件，传出选中项 value */
+    onSelect?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Command 适配器（shadcn kit）：基于 vendored Command（cmdk）；
+ * 支持搜索过滤（按 value 与 label 匹配）；onSelect 传出选中项 value
+ * （DSL 语义值）。
+ */
+declare function Command({ groups, placeholder, emptyText, onSelect, className, style, }: CommandProps): React.JSX.Element;
+
+/** 图表类型 */
+type ChartType = 'line' | 'bar' | 'area' | 'pie';
+interface ChartProps {
+    /** 图表类型：line / bar / area / pie */
+    chartType: ChartType;
+    /** 数据数组（通常为 `${data.xxx}` 表达式解析结果） */
+    data?: Record<string, unknown>[];
+    /** 类目/名称字段（pie 时为切片 name 字段） */
+    xKey?: string;
+    /** 数值字段（多系列传多个；pie 取第一个作为 value 字段） */
+    yKeys?: string[];
+    /** 系列颜色（按序循环），缺省使用 chart-1..5 语义令牌 */
+    colors?: string[];
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Chart 适配器（shadcn kit，recharts 薄封装）：以受限框架级 props
+ * （chartType / data / xKey / yKeys / colors）渲染 line/bar/area/pie
+ * 图表，不透传 recharts 自由组合 API；缺省配色取 chart-1..5 令牌；
+ * 多系列（yKeys > 1）或 pie 时渲染 Legend。
+ */
+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;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Content 主内容区（shadcn kit，语义对齐 antd Layout.Content）：
+ * 纯语义容器，`flex: 1` 占据 Layout 中的剩余空间。
+ */
+declare function Content({ className, style, children }: ContentProps): React.JSX.Element;
+
+/** 菜单项；danger 项以 destructive 语义呈现 */
+interface ContextMenuItemData {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    danger?: boolean;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+}
+interface ContextMenuProps {
+    /** 菜单项（可含表达式解析后的数组） */
+    items?: ContextMenuItemData[];
+    /** 选中事件，传出选中项 value */
+    onSelect?: (value: string) => void;
+    /** 右键作用区域（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在弹出内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * ContextMenu 适配器（shadcn kit）：children 为右键作用区域；
+ * 菜单项点击触发 onSelect 并传出该项 value。
+ */
+declare function ContextMenu({ items, onSelect, children, className, style, }: ContextMenuProps): React.JSX.Element;
+
+/**
+ * 列定义；`children`（别名 `renderChildren`）为单元格自定义渲染 DSL 子树，
+ * 经 Renderer 子作用域渲染，作用域注入 `row`（当前行记录）与 `rowIndex`
+ * （当前页内序号），语义与 Table 的 `cell` 一致。
+ */
+interface DataTableColumn {
+    key: string;
+    title?: string;
+    /** 可排序：点击表头切换升/降序（客户端排序 + onSort 回调） */
+    sortable?: boolean;
+    /** 可筛选：表头提供筛选输入（客户端包含匹配） */
+    filterable?: boolean;
+    children?: DslNode[];
+    /** 契约兼容别名：同 children */
+    renderChildren?: DslNode[];
+}
+/** 排序方向 */
+type DataTableSortOrder = 'asc' | 'desc';
+/** 排序状态（onSort 事件参数同形） */
+interface DataTableSort {
+    key: string;
+    order: DataTableSortOrder;
+}
+/** DSL 分页配置：false 关闭，`{ pageSize }` 简化映射 */
+type DataTablePagination = false | {
+    pageSize?: number;
+};
+interface DataTableProps {
+    columns?: DataTableColumn[];
+    /** 数据行（通常为 `${data.xxx}` 表达式解析结果） */
+    rows?: Record<string, unknown>[];
+    /** 行 key 字段，默认 'id' */
+    rowKey?: string;
+    pagination?: DataTablePagination;
+    /** 受控初始排序（后续点击表头内部维护） */
+    sort?: DataTableSort;
+    /** 排序变化事件，传出 `{ key, order }` */
+    onSort?: (sort: DataTableSort) => void;
+    /** 分页变化事件，传出页码 number */
+    onPageChange?: (page: number) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * DataTable 适配器（shadcn kit）：在既有 Table 语义之上的一体化数据表——
+ * sortable 列表头点击切换升/降序（客户端排序 + onSort 传 `{ key, order }`）、
+ * filterable 列提供表头筛选输入（客户端包含匹配）、分页复用 Table 分页行为
+ * （onPageChange 传页码）；cell 自定义渲染沿用 row/rowIndex 作用域语义。
+ */
+declare function DataTable({ columns, rows, rowKey, pagination, sort, onSort, onPageChange, className, style, }: DataTableProps): React.JSX.Element;
+
+interface DialogProps {
+    /** 对话框标题 */
+    title?: string;
+    /** 辅助说明 */
+    description?: string;
+    /** 受控开关（可绑 `${state.x}` 表达式）；缺省时由 trigger 自管理 */
+    open?: boolean;
+    /** 关闭事件（X / 遮罩 / Escape 任一途径关闭时触发） */
+    onClose?: () => void;
+    /** 触发元素（DSL 子树，非受控用法下点击打开） */
+    trigger?: DslNode;
+    /** 内容（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在弹层内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Dialog 适配器（shadcn kit）：受控 `open`（表达式绑定）+ `onClose`；
+ * 非受控时可用 `trigger` DSL 子树作触发元素。与交互层 OverlayHost
+ * 的 modal 共用同一套 vendored dialog 原语（design D4）。
+ */
+declare function Dialog({ title, description, open, onClose, trigger, children, className, style, }: DialogProps): React.JSX.Element;
+
+type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
+interface DrawerProps {
+    /** 抽屉标题 */
+    title?: string;
+    /** 受控开关（可绑 `${state.x}` 表达式） */
+    open?: boolean;
+    /** 滑出方向，缺省 right */
+    placement?: DrawerPlacement;
+    /** 关闭事件（遮罩 / Escape / 拖拽关闭时触发） */
+    onClose?: () => void;
+    /** 内容（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在抽屉内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Drawer 适配器（shadcn kit，vaul 原语）：受控 `open` + `placement`
+ * 四方向；与交互层 OverlayHost 的 drawer 共用同一套 vendored
+ * drawer 原语（design D4）。
+ */
+declare function Drawer({ title, open, placement, onClose, children, className, style, }: DrawerProps): React.JSX.Element;
+
+/** 菜单项；danger 项以 destructive 语义呈现 */
+interface DropdownMenuItemData {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    danger?: boolean;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+}
+interface DropdownMenuProps {
+    /** 菜单项（可含表达式解析后的数组） */
+    items?: DropdownMenuItemData[];
+    /** 选中事件，传出选中项 value */
+    onSelect?: (value: string) => void;
+    /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在弹出内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * DropdownMenu 适配器（shadcn kit）：children 为触发元素（以 span
+ * 包装接入 Base UI Trigger，避免按钮嵌套按钮）；菜单项点击触发
+ * onSelect 并传出该项 value。
+ */
+declare function DropdownMenu({ items, onSelect, children, className, style, }: DropdownMenuProps): React.JSX.Element;
+
+interface EmptyProps {
+    /** 空状态标题 */
+    title?: string;
+    /** 辅助说明文案 */
+    description?: string;
+    /** 操作区（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Empty 适配器（shadcn kit）：title / description + 可选 children 操作区 */
+declare function Empty({ title, description, children, className, style }: EmptyProps): React.JSX.Element;
+
+interface FieldProps {
+    /** 表单项标签 */
+    label?: string;
+    /** 辅助说明文案 */
+    description?: string;
+    /** 错误文案（声明式展示，如校验失败信息） */
+    error?: string;
+    /** 控件 DSL 子树（经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Field 适配器（shadcn kit）：通用表单项容器（Base UI Field 封装）；
+ * label / description / error 为框架级 props，error 声明式强制展示。
+ */
+declare function Field({ label, description, error, children, className, style }: FieldProps): React.JSX.Element;
 
 interface FlexProps {
     /** 主轴方向，默认 horizontal */
@@ -63,10 +679,27 @@ interface FlexProps {
     justify?: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly';
     /** 交叉轴对齐 */
     align?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（布局逃逸口，如 `{ flex: 1 }`；与数字 gap 合并） */
+    style?: CSSProperties;
     children?: ReactNode;
 }
 /** Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联 */
-declare function Flex({ direction, gap, justify, align, children, }: FlexProps): React.JSX.Element;
+declare function Flex({ direction, gap, justify, align, className, style, children, }: FlexProps): React.JSX.Element;
+
+interface FooterProps {
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Footer 底部区域（shadcn kit，语义对齐 antd Layout.Footer）：
+ * 纯语义容器，默认居中、弱化的辅助文本样式。
+ */
+declare function Footer({ className, style, children }: FooterProps): React.JSX.Element;
 
 interface FormProps {
     /** 表单名（缺省 'default'）：`form.setValues` 联动动作按名寻址 */
@@ -75,6 +708,10 @@ interface FormProps {
     layout?: 'horizontal' | 'vertical' | 'inline';
     /** 表单初始值（创建时生效；字段级 value 优先于 initialValues[name]） */
     initialValues?: Record<string, unknown>;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
     children?: ReactNode;
     /** 提交事件（校验通过后触发），参数为表单 values */
     onSubmit?: (values: Record<string, unknown>) => void;
@@ -91,63 +728,522 @@ interface FormProps {
  * 2. 校验通过把 values 写入 runtime state 的 `form` 路径（`${form.<field>}` 可用）
  * 3. 以 values 调用 onSubmit（Renderer 把它放入 `event` 作用域）
  */
-declare function Form({ name, layout, initialValues, children, onSubmit, onValuesChange, }: FormProps): React.JSX.Element;
+declare function Form({ name, layout, initialValues, className, style, children, onSubmit, onValuesChange, }: FormProps): React.JSX.Element;
 
 interface GridProps {
     /** 列数，默认 1；每列等宽（columns 取整下限 1） */
     columns?: number;
     /** 栏间距 */
     gap?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（布局逃逸口；与 columns / gap 生成的样式合并，同键后者优先） */
+    style?: CSSProperties;
     children?: ReactNode;
 }
 /**
  * Grid 均分栏布局（shadcn kit）：CSS grid。
  * 列数为运行时动态值，无法用 Tailwind 静态类表达，经 inline style 设置。
  */
-declare function Grid({ columns, gap, children }: GridProps): React.JSX.Element;
+declare function Grid({ columns, gap, className, style, children }: GridProps): React.JSX.Element;
 
-/** DSL 校验规则（框架级协议，当前支持 required + message） */
-interface FieldRule {
-    required?: boolean;
-    message?: string;
+/** 品牌区位置（缺省 'left'） */
+type HeaderBrandPosition = 'left' | 'right';
+/** 通用下拉项 */
+interface HeaderDropdownItem {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
 }
-interface InputProps {
+/** 通用下拉区配置 */
+interface HeaderDropdown {
+    label: string;
+    items: HeaderDropdownItem[];
+    /** 渲染位置（缺省 'left'） */
+    position?: 'left' | 'right';
+}
+/** 菜单项；`children` 为弹出式子菜单 */
+interface HeaderMenuItem {
+    key: string;
+    label: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+    children?: HeaderMenuItem[];
+}
+/** 用户区菜单项 */
+interface HeaderUserItem {
+    label: string;
+    value: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+}
+/** 用户区配置；`items` 缺省或为空时退化为纯展示（无下拉） */
+interface HeaderUser {
+    name: string;
+    avatar?: string;
+    items?: HeaderUserItem[];
+}
+/** 语言选项 */
+interface HeaderLocale {
+    label: string;
+    value: string;
+}
+interface HeaderProps {
+    /** 品牌区 logo 图片地址（可含表达式） */
+    logo?: string;
+    /** 品牌区标题文本 */
+    title?: string;
+    /** 品牌区位置（缺省 'left'） */
+    brandPosition?: HeaderBrandPosition;
+    /** 通用下拉区 */
+    dropdown?: HeaderDropdown;
+    /** 横向菜单（可含表达式），语义复用 horizontal Menu（含子菜单） */
+    menu?: HeaderMenuItem[];
+    /** 用户区 */
+    user?: HeaderUser;
+    /** 国际化切换选项 */
+    locales?: HeaderLocale[];
+    /** 菜单选中事件，传出选中项 key */
+    onMenuSelect?: (key: string) => void;
+    /** 通用下拉选中事件，传出选中项 value */
+    onDropdownSelect?: (value: string) => void;
+    /** 用户区菜单选中事件，传出选中项 value */
+    onUserSelect?: (value: string) => void;
+    /** 语言切换事件，传出选中的 locale 值 */
+    onLocaleChange?: (locale: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Header 顶部区域（shadcn kit，语义对齐 antd Layout.Header）：
+ * 横向 flex、垂直居中、默认下边框。除 children 外可携带五个可选结构
+ * 区域（品牌区 / 通用下拉 / 横向菜单 / 用户区 / 国际化切换）；全部区域
+ * props 缺省时退化为纯容器。
+ *
+ * 排布固定：左区（品牌?→下拉?→菜单?）— flex-1 中区（children）—
+ * 右区（下拉?→品牌?→locales→user）。区域内部直接组合 src/ui 原语
+ * （dropdown-menu / avatar），事件值透传给 Header 自身的事件 props。
+ */
+declare function Header({ logo, title, brandPosition, dropdown, menu, user, locales, onMenuSelect, onDropdownSelect, onUserSelect, onLocaleChange, className, style, children, }: HeaderProps): React.JSX.Element;
+
+interface HoverCardProps {
+    /** 悬浮卡片内容：DSL 子树（对象，原样保留至渲染层求值）或纯文本 */
+    content?: DslNode | string;
+    /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在卡片浮层根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * HoverCard 适配器（shadcn kit）：children 为触发元素（span 包装接入
+ * Base UI Trigger），悬浮显示 content 富内容卡片（支持 DSL 子树）。
+ */
+declare function HoverCard({ content, children, className, style }: HoverCardProps): React.JSX.Element;
+
+/**
+ * 常用图标白名单（lucide-react 静态导入，可 tree-shake）：
+ * key 为 kebab-case 名（DSL 侧同时接受 PascalCase，见 normalizeIconName）。
+ * 未列出的图标按需在此补充一行导入 + 一行映射。
+ */
+declare const ICONS: Record<string, LucideIcon>;
+/** DSL Icon 尺寸（数字直接作 px） */
+type IconSize = 'sm' | 'default' | 'lg' | number;
+interface IconProps {
+    /** 图标名：kebab-case（如 'arrow-right'）或 PascalCase（如 'ArrowRight'），见 ICONS 白名单 */
+    name?: string;
+    /** 尺寸：'sm' 16 / 'default' 20 / 'lg' 24，或数字 px（缺省 default） */
+    size?: IconSize;
+    /** 颜色（CSS 颜色值，缺省 currentColor 跟随文本色） */
+    color?: string;
+    /** 描边宽度（lucide 缺省 2） */
+    strokeWidth?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** kebab-case / camelCase / PascalCase 统一归一为 kebab-case 白名单键 */
+declare function normalizeIconName(name: string): string;
+/**
+ * Icon 适配器（shadcn kit）：按 name 从 lucide 白名单渲染图标。
+ * 未知名渲染占位图标（help-circle）并标 `data-unknown`，不抛错
+ * （与 chat messageActions 图标白名单同约定）。
+ */
+declare function Icon({ name, size, color, strokeWidth, className, style, }: IconProps): React.JSX.Element;
+
+interface InputGroupProps {
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    /** Input 与前后缀元素（Text/Button，渲染好的 ReactNode） */
+    children?: ReactNode;
+}
+/**
+ * InputGroup 适配器（shadcn kit）：children 为 Input 与前后缀元素
+ * （Text/Button），渲染为组合输入框；内部 Input 的边框/焦点环由
+ * 容器样式消化。
+ */
+declare function InputGroup({ className, style, children }: InputGroupProps): React.JSX.Element;
+
+interface InputOTPProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
     name?: string;
     /** 表单项标签 */
     label?: string;
     /** 校验规则 */
     rules?: FieldRule[];
-    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    /** OTP 位数（缺省 6） */
+    length?: number;
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值 */
     value?: string;
-    /** 输入类型：password 时掩码输入（缺省 text） */
-    type?: 'text' | 'password';
-    placeholder?: string;
     disabled?: boolean;
-    /** 输入事件，传出 string 值（非原生 event，设计决策 D2） */
+    /** 输入事件，传出当前字符串 */
     onChange?: (value: string) => void;
+    /** 输入满 length 位时触发，传出完整 OTP 字符串 */
+    onComplete?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
 }
 /**
- * Input 适配器（shadcn kit，语义对齐 antd 版）：
- * 在 Form 内且声明 `name` 时自动成为表单项（label / rules 生效，
- * 值由 Form 上下文托管）；否则渲染独立受控控件，onChange 传出 string。
- * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
- * `<label htmlFor>` 与控件 `useId` 关联。
+ * InputOTP 适配器（shadcn kit）：基于 vendored InputOTP（input-otp）；
+ * onChange 传出当前字符串、onComplete 传出完整 OTP（DSL 语义值）；
+ * Form 内声明 `name` 自动成为表单项。独立渲染时内部维护输入态
+ * （value prop 作为初始值/受控镜像）。
+ */
+declare function InputOTP({ name, label, rules, length, value, disabled, onChange, onComplete, className, style, }: InputOTPProps): React.JSX.Element;
+
+interface ItemProps {
+    /** 标题 */
+    title?: string;
+    /** 描述文本 */
+    description?: string;
+    /** 媒体区（DSL 子树，经 renderChildren 渲染） */
+    media?: DslNode | DslNode[];
+    /** 操作区（DSL 子树，经 renderChildren 渲染） */
+    actions?: DslNode[];
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Item 适配器（shadcn kit）：media / title+description / actions 三段式
+ * 列表项；media 与 actions 为 DSL 子树，经 renderChildren 渲染。
+ */
+declare function Item({ title, description, media, actions, className, style, }: ItemProps): React.JSX.Element;
+
+interface KbdProps {
+    /** 按键文本（如 ⌘K） */
+    text?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Kbd 适配器（shadcn kit）：text → vendored Kbd */
+declare function Kbd({ text, className, style }: KbdProps): React.JSX.Element;
+
+interface LabelProps {
+    /** 标签文本 */
+    text?: string;
+    /** 关联控件 id（label htmlFor） */
+    htmlFor?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Label 适配器（shadcn kit）：独立使用的表单标签 */
+declare function Label({ text, htmlFor, className, style }: LabelProps): React.JSX.Element;
+
+interface LayoutProps {
+    /**
+     * 主轴方向；缺省按直接子节点推导：含 Sider 时为 horizontal，
+     * 否则 vertical（对齐 antd Layout 语义）；显式提供时覆盖推导
+     */
+    direction?: 'horizontal' | 'vertical';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    /** 内部：withScope 注册时由 Renderer 传入的原始 DSL 子树（可为动态引用） */
+    dslChildren?: DslChildren;
+}
+/**
+ * Layout 布局容器（shadcn kit，语义对齐 antd Layout）：flex 容器。
+ * 方向推导基于直接子节点的 DSL 类型；`component` 引用解析到子树根类型
+ * （页面级命名组件里放 Sider 同样计入推导）。动态引用（DslSourceRef）
+ * 形态无法静态推导方向，按 vertical 处理（可用 direction 显式指定）。
+ */
+declare function Layout({ direction, className, style, dslChildren }: LayoutProps): React.JSX.Element;
+
+interface LinkProps {
+    /** 链接地址（可含表达式） */
+    href?: string;
+    /** 链接文本；也可用 children */
+    text?: string;
+    /** 打开方式（`_blank` 新窗口等） */
+    target?: '_blank' | '_self' | '_parent' | '_top';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Link 链接（shadcn kit）：渲染原生 `<a href>`——自然跳转，
+ * 目标可以是宿主任意路由（嵌入模式的主要跳转方式，见
+ * spec: embedded-page-view 的「自然跳转」）。
  */
-declare function Input({ name, label, rules, value, type, placeholder, disabled, onChange, }: InputProps): React.JSX.Element;
+declare function Link({ href, text, target, className, style, children }: LinkProps): React.JSX.Element;
+
+/** 菜单项；`children` 为子菜单（inline 模式下缩进展示） */
+interface MenuItem {
+    key: string;
+    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 {
+    /** 菜单项（可含表达式，如 `${data.menus}`） */
+    items?: MenuItem[];
+    /** 展示模式：inline（Sider 内纵向，缺省）| horizontal（Header 内横向） */
+    mode?: 'inline' | 'horizontal';
+    /** 受控选中项 key（可绑 `${state.x}`） */
+    selectedKey?: string;
+    /** 选中变化事件，传出选中项 key */
+    onSelect?: (key: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Menu 导航菜单（shadcn kit）：哑渲染组件——items 经表达式注入，
+ * 不直接读取外壳层 MenuRegistry；选中态受控（selectedKey + onSelect
+ * 闭环，典型接 navigate 动作）。在 Sidebar 内且侧栏折叠（icon rail）
+ * 时自动降级为仅图标（label / badge / dot / 分组隐藏，hover 经 RailTooltip 展示）。
+ */
+declare function Menu({ items, mode, selectedKey, onSelect, className, style, }: MenuProps): React.JSX.Element;
+
+/** 菜单项（叶子）；value 为 onSelect 传出值 */
+interface MenubarLeafItem {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+}
+/** 一级菜单（嵌套叶子项） */
+interface MenubarMenuData {
+    label: string;
+    items: MenubarLeafItem[];
+}
+interface MenubarProps {
+    /** 菜单组（可含表达式解析后的数组） */
+    menus?: MenubarMenuData[];
+    /** 选中事件，传出选中项 value */
+    onSelect?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Menubar 适配器（shadcn kit）：menus 声明嵌套菜单，叶子项点击
+ * 触发 onSelect 并传出该项 value（DSL 语义值，非 DOM 事件）。
+ */
+declare function Menubar({ menus, onSelect, className, style }: MenubarProps): React.JSX.Element;
+
+/** 子链接项 */
+interface NavigationMenuChildItem {
+    label: string;
+    href: string;
+    description?: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+}
+/** 导航项：href 直链，或 children 下拉面板 */
+interface NavigationMenuItemData {
+    label: string;
+    href?: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+    children?: NavigationMenuChildItem[];
+}
+interface NavigationMenuProps {
+    /** 导航项（可含表达式解析后的数组） */
+    items?: NavigationMenuItemData[];
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * NavigationMenu 适配器（shadcn kit）：items 声明一级导航；
+ * 含 children 的项渲染为触发器 + 下拉面板（链接含 description），
+ * 仅含 href 的项渲染为直链。
+ */
+declare function NavigationMenu({ items, className, style }: NavigationMenuProps): React.JSX.Element;
 
 interface PageProps {
     /** 页面标题，可选 */
     title?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（布局逃逸口） */
+    style?: CSSProperties;
     children?: ReactNode;
 }
 /** Page 容器（shadcn kit）：可选标题 + 内容区（纵向节奏 space-y-5） */
-declare function Page({ title, children }: PageProps): React.JSX.Element;
+declare function Page({ title, className, style, children }: PageProps): React.JSX.Element;
+
+interface PaginationProps {
+    /** 总条数（可绑表达式解析后的数字） */
+    total?: number;
+    /** 每页条数，缺省 10 */
+    pageSize?: number;
+    /** 受控当前页（可绑 `${state.x}`）；缺省内部自管理 */
+    page?: number;
+    /** 翻页事件，传出目标页码（number） */
+    onChange?: (page: number) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Pagination 适配器（shadcn kit）：total/pageSize 推页数；page 受控
+ * （缺省内部自管理）；onChange 传出目标页码 number。上一页/下一页
+ * 与页码点击均走同一 onChange。
+ */
+declare function Pagination({ total, pageSize, page, onChange, className, style, }: PaginationProps): React.JSX.Element;
+
+interface PopoverProps {
+    /** 浮层内容：DSL 子树（对象，原样保留至渲染层求值）或纯文本 */
+    content?: DslNode | string;
+    /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在浮层内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Popover 适配器（shadcn kit）：children 为触发元素（span 包装接入
+ * Base UI Trigger）；content 支持 DSL 子树或纯文本。
+ */
+declare function Popover({ content, children, className, style }: PopoverProps): React.JSX.Element;
+
+interface ProgressProps {
+    /** 百分比（0-100，可为表达式解析后的数字）；undefined / null 为不确定态 */
+    value?: number | null;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Progress 适配器（shadcn kit）：value（0-100）→ vendored Progress（Base UI） */
+declare function Progress({ value, className, style }: ProgressProps): React.JSX.Element;
+
+/** RadioGroup 选项 */
+interface RadioGroupOption {
+    label: string;
+    value: string | number | boolean;
+    /** 单个选项禁用 */
+    disabled?: boolean;
+}
+interface RadioGroupProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选项列表 */
+    options?: RadioGroupOption[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string | number | boolean;
+    disabled?: boolean;
+    /** 选中变化事件，传出选中项的 value */
+    onChange?: (value: string | number | boolean) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * RadioGroup 适配器（shadcn kit）：基于 vendored RadioGroup（Base UI）；
+ * Base UI RadioGroup 的 value 原生支持 string/number/boolean，
+ * onChange 传出选中项原始 value。
+ */
+declare function RadioGroup({ name, label, rules, options, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
+
+/** 可拖拽面板；`children` 为 DSL 子树，经 renderChildren 渲染 */
+interface ResizablePanelData {
+    children?: DslNode[];
+    /** 默认尺寸（百分比，0-100） */
+    defaultSize?: number;
+}
+interface ResizableProps {
+    /** 面板列表（相邻面板间渲染拖拽手柄） */
+    panels?: ResizablePanelData[];
+    /** 排列方向（缺省 horizontal） */
+    direction?: 'horizontal' | 'vertical';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Resizable 适配器（shadcn kit）：基于 vendored Resizable
+ * （react-resizable-panels）；panels 声明面板，相邻面板间为可拖拽手柄；
+ * DSL 的 defaultSize 统一按百分比解释。
+ */
+declare function Resizable({ panels, direction, className, style, }: ResizableProps): React.JSX.Element;
+
+interface ScrollAreaProps {
+    /** 最大高度（px 或 CSS 长度），超出后出现自定义滚动条 */
+    maxHeight?: number | string;
+    /** 最大宽度（px 或 CSS 长度） */
+    maxWidth?: number | string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * ScrollArea 适配器（shadcn kit）：基于 vendored ScrollArea（Base UI）；
+ * maxHeight/maxWidth 尺寸约束 + children 内容，自定义滚动条。
+ */
+declare function ScrollArea({ maxHeight, maxWidth, className, style, children, }: ScrollAreaProps): React.JSX.Element;
 
 /** Select 选项（支持表达式解析后的数组） */
 interface SelectOption {
     label: string;
     value: string | number | boolean;
+    /** 单个选项禁用 */
+    disabled?: boolean;
 }
 interface SelectProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
@@ -165,6 +1261,10 @@ interface SelectProps {
     allowClear?: boolean;
     /** 选中变化事件，传出选中的 value */
     onChange?: (value: unknown) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
 }
 /**
  * Select 适配器（shadcn kit，语义对齐 antd 版）：
@@ -176,7 +1276,200 @@ interface SelectProps {
  * popup 时（如表单初始值回填），Trigger 同样显示 label（对齐原 Radix 坑
  * 的对应场景，见 design D2/风险表）。
  */
-declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, }: SelectProps): React.JSX.Element;
+declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, className, style, }: SelectProps): React.JSX.Element;
+
+interface SeparatorProps {
+    /** 方向，默认 horizontal */
+    orientation?: 'horizontal' | 'vertical';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Separator 适配器（shadcn kit）：orientation → vendored Separator */
+declare function Separator({ orientation, className, style }: SeparatorProps): React.JSX.Element;
+
+type SheetSide = 'left' | 'right' | 'top' | 'bottom';
+interface SheetProps {
+    /** 面板标题 */
+    title?: string;
+    /** 受控开关（可绑 `${state.x}` 表达式） */
+    open?: boolean;
+    /** 滑出方向，缺省 right */
+    side?: SheetSide;
+    /** 关闭事件（X / 遮罩 / Escape 任一途径关闭时触发） */
+    onClose?: () => void;
+    /** 内容（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在面板内容根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Sheet 适配器（shadcn kit）：受控 `open` + `side` 四边滑入；
+ * 基于 vendored sheet 原语（dialog 同源），与 OverlayHost 视觉
+ * 一致（design D4）。
+ */
+declare function Sheet({ title, open, side, onClose, children, className, style, }: SheetProps): React.JSX.Element;
+
+/** 品牌区：标题 + 可选 logo（图片地址）；也可直接传 ReactNode 自定义 */
+interface SidebarBrand {
+    title: string;
+    logo?: string;
+}
+/** 导航项；`children` 为子菜单（缩进展示） */
+interface SidebarNavItem {
+    label: string;
+    href?: string;
+    /** 图标名（Icon 白名单，kebab/Pascal 均可），渲染于文字前 */
+    icon?: string;
+    children?: SidebarNavItem[];
+}
+interface SidebarProps {
+    /** 品牌区（{ title, logo } 对象或任意 ReactNode）；移动端渲染在顶栏，桌面端渲染在侧栏顶部品牌行 */
+    brand?: SidebarBrand | ReactNode;
+    /** 导航项（可含嵌套 children，可含表达式）；content 槽提供时不渲染 */
+    items?: SidebarNavItem[];
+    /** 侧栏自由内容槽（提供时替代 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）：品牌区 + 侧栏（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, content, sidebarFooter, collapsible, onCollapse, locationKey, drawer, className, style, children, }: SidebarProps): React.JSX.Element;
+
+interface SiderProps {
+    /** 展开宽度（px），默认 200 */
+    width?: number;
+    /** 是否渲染底部折叠触发器 */
+    collapsible?: boolean;
+    /** 受控折叠态（可绑 `${state.x}`，配合 onCollapse 回写） */
+    collapsed?: boolean;
+    /** 折叠后的宽度（px），默认 64 */
+    collapsedWidth?: number;
+    /** 折叠状态变化事件，传出 boolean */
+    onCollapse?: (collapsed: boolean) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Sider 侧边区域（shadcn kit，语义对齐 antd Layout.Sider）：
+ * 纯容器（内容完全由 children DSL 声明）+ 可选折叠触发器；
+ * 折叠为受控 prop（props 绑 state + onCollapse 回写的闭环）。
+ */
+declare function Sider({ width, collapsible, collapsed, collapsedWidth, onCollapse, className, style, children, }: SiderProps): React.JSX.Element;
+
+/** DSL Skeleton 形状 */
+type SkeletonShape = 'line' | 'circle' | 'rect';
+interface SkeletonProps {
+    /** 形状：line（文本行）/ circle（圆形）/ rect（矩形），默认 line */
+    shape?: SkeletonShape;
+    /** 宽度（px 或 CSS 长度） */
+    width?: number | string;
+    /** 高度（px 或 CSS 长度） */
+    height?: number | string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Skeleton 适配器（shadcn kit）：shape + width / height → vendored Skeleton */
+declare function Skeleton({ shape, width, height, className, style }: SkeletonProps): React.JSX.Element;
+
+interface SliderProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: number;
+    /** 最小值，默认 0 */
+    min?: number;
+    /** 最大值，默认 100 */
+    max?: number;
+    /** 步长，默认 1 */
+    step?: number;
+    disabled?: boolean;
+    /** 拖动变化事件，传出 number */
+    onChange?: (value: number) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Slider 适配器（shadcn kit）：基于 vendored Slider（Base UI，单值形态）；
+ * onChange 传出 number（DSL 语义值，非 DOM 事件）。
+ */
+declare function Slider({ name, label, rules, value, min, max, step, disabled, onChange, className, style, }: SliderProps): React.JSX.Element;
+
+interface SonnerProps {
+    /** 通用：挂载点容器 class */
+    className?: string;
+    /** 通用：挂载点容器内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Sonner 适配器（shadcn kit，Base UI Toast 薄封装）：
+ * DSL 组件形态仅作全局 toast 挂载点（渲染 Toaster）；同时在 mount 时
+ * 向运行时动作注册表注册 `toast` 动作——DSL events 可写
+ * `{ action: 'toast', params: { message, description?, variant? } }`
+ * （variant: success/error/info）。
+ *
+ * 接线方式说明：runtime 动作注册表（Registry）天然支持外部扩展
+ * （同 registerInteractionActions 的先例），无需修改 runtime；
+ * 动作经本挂载组件注册，复用 vendored toast 原语的模块级
+ * ToastManager（命令式 API 与 Toaster 共用同一实例）。
+ */
+declare function Sonner({ className, style }: SonnerProps): React.JSX.Element;
+
+/** DSL Spinner 尺寸 */
+type SpinnerSize = 'sm' | 'default' | 'lg';
+interface SpinnerProps {
+    /** 尺寸，默认 default */
+    size?: SpinnerSize;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Spinner 适配器（shadcn kit）：size → vendored Spinner（纯 CSS 旋转） */
+declare function Spinner({ size, className, style }: SpinnerProps): React.JSX.Element;
 
 interface StatisticProps {
     /** 指标标题 */
@@ -187,9 +1480,36 @@ interface StatisticProps {
     precision?: number;
     /** 后缀（如单位） */
     suffix?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
 }
 /** Statistic 适配器（shadcn kit）：标题 + 数值（precision 精度 / suffix 后缀） */
-declare function Statistic({ title, value, precision, suffix }: StatisticProps): React.JSX.Element;
+declare function Statistic({ title, value, precision, suffix, className, style }: StatisticProps): React.JSX.Element;
+
+interface SwitchProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 开关旁的标签文本 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: boolean;
+    disabled?: boolean;
+    /** 开关变化事件，传出 boolean */
+    onChange?: (checked: boolean) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Switch 适配器（shadcn kit）：基于 vendored Switch（Base UI）；
+ * onChange 传出 boolean（DSL 语义值，非 DOM 事件）。
+ */
+declare function Switch({ name, label, rules, value, disabled, onChange, className, style, }: SwitchProps): React.JSX.Element;
 
 /**
  * 列定义；`cell` 为行模板 DSL 子树，每个单元格经 Renderer 子作用域
@@ -221,6 +1541,10 @@ interface TableProps {
     pagination?: TablePagination;
     /** 分页 / 排序变化事件，传出 pagination 信息 */
     onChange?: (pagination: TablePaginationInfo) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
 }
 /**
  * Table 适配器（shadcn kit，语义对齐 antd 版）：vendored shadcn Table 原语
@@ -228,7 +1552,7 @@ interface TableProps {
  * （pageSize）/ 空态；`cell` 行模板经 renderChildren 注入
  * `{ row, rowIndex }`（rowIndex 为当前页内序号）。
  */
-declare function Table({ columns, dataSource, rowKey, loading, pagination, onChange, }: TableProps): React.JSX.Element;
+declare function Table({ columns, dataSource, rowKey, loading, pagination, onChange, className, style, }: TableProps): React.JSX.Element;
 
 /** Tabs 页签定义；`children` 为 DSL 子树，经 Renderer children 机制渲染 */
 interface TabItem {
@@ -242,13 +1566,149 @@ interface TabsProps {
     activeKey?: string;
     /** 页签切换事件，传出新激活的 key */
     onChange?: (key: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
 }
 /**
  * Tabs 容器（shadcn kit，语义对齐 antd 版）：
  * 基于 vendored shadcn Tabs（@base-ui/react），每个 pane 的内容经
  * renderChildren 渲染；未传 activeKey 时缺省激活第一个页签。
  */
-declare function Tabs({ items, activeKey, onChange }: TabsProps): React.JSX.Element;
+declare function Tabs({ items, activeKey, onChange, className, style }: TabsProps): React.JSX.Element;
+
+/** DSL Text 语义类型 */
+type TextType = 'default' | 'secondary' | 'success' | 'warning' | 'danger';
+interface TextProps {
+    /** 文本内容（可含表达式）；也可用 children 渲染 */
+    text?: string;
+    /** 语义类型（颜色） */
+    type?: TextType;
+    /** 加粗 */
+    strong?: boolean;
+    /** 删除线 */
+    delete?: boolean;
+    /** 下划线 */
+    underline?: boolean;
+    /** 斜体 */
+    italic?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/** Text 适配器（shadcn kit）：普通文本渲染，语义类型 + 修饰（粗体/删除线/下划线/斜体） */
+declare function Text({ text, type, strong, delete: del, underline, italic, className, style, children, }: TextProps): React.JSX.Element;
+
+interface TextareaProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string;
+    placeholder?: string;
+    /** 行数（缺省由内容自适应） */
+    rows?: number;
+    disabled?: boolean;
+    /** 输入事件，传出 string 值 */
+    onChange?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Textarea 适配器（shadcn kit）：Form 内声明 `name` 自动成为表单项；
+ * onChange 传出 string（非原生 event）。
+ */
+declare function Textarea({ name, label, rules, value, placeholder, rows, disabled, onChange, className, style, }: TextareaProps): React.JSX.Element;
+
+interface ToggleProps {
+    /** 按钮文本 */
+    text?: string;
+    /** 受控按下态 */
+    pressed?: boolean;
+    /** 样式变体 */
+    variant?: VariantProps<typeof toggleVariants>['variant'];
+    /** 尺寸 */
+    size?: VariantProps<typeof toggleVariants>['size'];
+    disabled?: boolean;
+    /** 按下态变化事件，传出 boolean */
+    onChange?: (pressed: boolean) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Toggle 适配器（shadcn kit）：基于 vendored Toggle（Base UI）；
+ * pressed 受控（未传时为非受控）；onChange 传出 boolean（DSL 语义值）。
+ */
+declare function Toggle({ text, pressed, variant, size, disabled, onChange, className, style, }: ToggleProps): React.JSX.Element;
+
+/** ToggleGroup 选项 */
+interface ToggleGroupOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+interface ToggleGroupProps {
+    /** 选项列表 */
+    options?: ToggleGroupOption[];
+    /** 受控选中值：单选传 value，多选传数组 */
+    value?: string | string[];
+    /** 多选模式（缺省单选） */
+    multiple?: boolean;
+    disabled?: boolean;
+    /** 选中变化事件：单选传出选中 value（取消选中传 undefined），多选传出值数组 */
+    onChange?: (value: string | string[] | undefined) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ToggleGroup 适配器（shadcn kit）：基于 vendored ToggleGroup（Base UI）；
+ * Base UI 统一以数组表达选中态，适配层按 multiple 收敛为
+ * 单值/数组（DSL 语义值）。
+ */
+declare function ToggleGroup({ options, value, multiple, disabled, onChange, className, style, }: ToggleGroupProps): React.JSX.Element;
+
+interface TooltipProps {
+    /** 提示文案 */
+    content?: string;
+    /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（挂在提示浮层根节点，与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Tooltip 适配器（shadcn kit）：children 为触发元素（span 包装接入
+ * Base UI Trigger），悬浮显示 content 提示浮层。
+ */
+declare function Tooltip({ content, children, className, style }: TooltipProps): React.JSX.Element;
+
+/** Typography 排版变体 */
+type TypographyVariant = NonNullable<VariantProps<typeof typographyVariants>['variant']>;
+interface TypographyProps {
+    /** 排版变体（缺省 p） */
+    variant?: TypographyVariant;
+    /** 文本内容（可含表达式） */
+    text?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Typography 适配器（shadcn kit）：按 variant 渲染排版样式文本 */
+declare function Typography({ variant, text, className, style, }: TypographyProps): React.JSX.Element;
 
 /**
  * shadcn kit 组件表：DSL 类型名 → 组件适配器。
@@ -268,12 +1728,83 @@ declare const shadcnComponents: {
     readonly Form: typeof Form;
     readonly Input: typeof Input;
     readonly Select: typeof Select;
+    readonly Layout: {
+        readonly component: typeof Layout;
+        readonly withScope: true;
+    };
+    readonly Header: typeof Header;
+    readonly Sider: typeof Sider;
+    readonly Content: typeof Content;
+    readonly Footer: typeof Footer;
+    readonly Menu: typeof Menu;
+    readonly Link: typeof Link;
+    readonly Text: typeof Text;
+    readonly Badge: typeof Badge;
+    readonly Avatar: typeof Avatar;
+    readonly Skeleton: typeof Skeleton;
+    readonly Separator: typeof Separator;
+    readonly Kbd: typeof Kbd;
+    readonly Spinner: typeof Spinner;
+    readonly Empty: typeof Empty;
+    readonly AspectRatio: typeof AspectRatio;
+    readonly Progress: typeof Progress;
+    readonly Textarea: typeof Textarea;
+    readonly Checkbox: typeof Checkbox;
+    readonly RadioGroup: typeof RadioGroup;
+    readonly Switch: typeof Switch;
+    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;
+    readonly NavigationMenu: typeof NavigationMenu;
+    readonly DropdownMenu: typeof DropdownMenu;
+    readonly ContextMenu: typeof ContextMenu;
+    readonly Dialog: typeof Dialog;
+    readonly AlertDialog: typeof AlertDialog;
+    readonly Drawer: typeof Drawer;
+    readonly Sheet: typeof Sheet;
+    readonly Popover: typeof Popover;
+    readonly Sonner: typeof Sonner;
+    readonly Accordion: typeof Accordion;
+    readonly Collapsible: typeof Collapsible;
+    readonly Tooltip: typeof Tooltip;
+    readonly HoverCard: typeof HoverCard;
+    readonly Calendar: typeof Calendar;
+    readonly InputOTP: typeof InputOTP;
+    readonly Combobox: typeof Combobox;
+    readonly Carousel: typeof Carousel;
+    readonly Command: typeof Command;
+    readonly Resizable: typeof Resizable;
+    readonly ScrollArea: typeof ScrollArea;
+    readonly Toggle: typeof Toggle;
+    readonly ToggleGroup: typeof ToggleGroup;
+    readonly ButtonGroup: typeof ButtonGroup;
+    readonly InputGroup: typeof InputGroup;
+    readonly Item: typeof Item;
+    readonly Typography: typeof Typography;
+    readonly Sidebar: typeof Sidebar;
+    readonly DataTable: typeof DataTable;
+    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;
 
+/**
+ * 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 / 校验错误
  * 并经 React Context 下发；Input / Select 据此判断自身是否在表单内。
@@ -304,4 +1835,4 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-export { Alert, type AlertProps, type AlertVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type FieldRule, Flex, type FlexProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Input, type InputProps, Page, type PageProps, Select, type SelectOption, type SelectProps, Statistic, type StatisticProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, createShadcnComponentRegistry, 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, createShadcnComponentRegistry, normalizeIconName, registerShadcnComponents, shadcnComponents, useFormContext, useSidebarDrawer };