@q1travel/design-system 0.22.0 → 0.24.0

package/dist-pkg/design-system.d.ts

@@ -214,6 +214,22 @@ export declare function BrowserTabs({ tabs, className }: {
 
 export declare type BrowserVariant = 'light' | 'dark';
 
+export declare function Bubble({ direction, avatar, name, time, children, status, pending, error, retry, onRetry, actions, className, ...props }: BubbleProps): JSX.Element;
+
+export declare type BubbleProps = Omit<ComponentPropsWithoutRef<'article'>, 'children'> & {
+    direction?: 'incoming' | 'outgoing';
+    avatar?: ReactNode;
+    name?: ReactNode;
+    time?: ReactNode;
+    children: ReactNode;
+    status?: 'default' | 'pending' | 'error';
+    pending?: ReactNode;
+    error?: ReactNode;
+    retry?: ReactNode;
+    onRetry?: () => void;
+    actions?: ReactNode;
+};
+
 export declare function Button(props: ButtonProps): JSX.Element;
 
 declare type ButtonAccessibleName = {
@@ -315,13 +331,12 @@ export declare type ButtonSize = 'sm' | 'md' | 'lg';
 
 export declare type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'warning' | 'danger';
 
-/** 标准日期区间选择器；复用 RangeField 的草稿、弹层和键盘行为。 */
+/** 标准日期与区间选择器；复用 RangeField 的草稿、弹层和键盘行为。 */
 export declare function Calendar(props: CalendarProps): JSX.Element;
 
-export declare function CalendarGrid({ value, onChange, size, minValue, maxValue, today, }: {
-    value: RangeValue;
-    onChange: (next: RangeValue) => void;
+export declare function CalendarGrid(props: CalendarSelectionProps & {
     size?: CalendarSize;
+    withTime?: boolean;
     minValue?: Date;
     maxValue?: Date;
     today?: Date;
@@ -334,6 +349,16 @@ export declare type CalendarPreset = {
 
 export declare type CalendarProps = ComponentProps<typeof RangeField>;
 
+export declare type CalendarSelectionProps = {
+    mode?: 'range';
+    value: RangeValue;
+    onChange: (next: RangeValue) => void;
+} | {
+    mode: 'single';
+    value: Date | null;
+    onChange: (next: Date | null) => void;
+};
+
 export declare type CalendarSize = 'large' | 'small';
 
 export declare function Card(props: CardProps): JSX.Element;
@@ -393,7 +418,7 @@ export declare type ChartProps = {
     className?: string;
 };
 
-export declare function Checkbox({ ...props }: CheckboxProps): JSX.Element;
+export declare function Checkbox({ shape, tone, size, ...props }: CheckboxProps): JSX.Element;
 
 declare type CheckboxOnlyProps = {
     /** 半选：视觉态而非第三个值，由父级逻辑驱动（如"部分子项已选"）。AT 读作 mixed。 */
@@ -401,7 +426,14 @@ declare type CheckboxOnlyProps = {
 };
 
 /** Checkbox 的完整 props。消费方包一层时用它标注，无需知道内部由哪几块组合而成。 */
-export declare type CheckboxProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & CheckboxOnlyProps & ControlOptionNativeInputProps;
+export declare type CheckboxProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & FieldLabelVisibilityProps & CheckboxOnlyProps & {
+    /** 圆形仅用于任务与清单完成；表单多选保留默认方形。 */
+    shape?: 'square' | 'circle';
+    /** 仅圆形生效；业务方自行映射优先级。 */
+    tone?: 'neutral' | 'info' | 'warning' | 'danger';
+    /** 圆形清单 sm / 详情 md；默认 sm。 */
+    size?: 'sm' | 'md';
+} & Omit<ControlOptionNativeInputProps, 'size'>;
 
 export declare function Choicebox({ type, label, description, extra, className, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': ariaDescribedBy, ...rest }: ChoiceboxProps): JSX.Element;
 
@@ -596,7 +628,11 @@ export declare type CommandMenuSection = {
     items: CommandMenuItem[];
 };
 
-export declare function Composer({ onSubmit, onAttach, attachments, mentions, disabled, }: ComposerProps): JSX.Element;
+export declare function Composer({ onSubmit, onAttach, attachments, mentions, onMentionQuery, placeholder, hint, commands, onCommand, disabled, }: ComposerProps): JSX.Element;
+
+export declare type ComposerCommand = ComposerMention & {
+    keywords?: string[];
+};
 
 export declare type ComposerMention = {
     id: string;
@@ -606,9 +642,14 @@ export declare type ComposerMention = {
 
 export declare type ComposerProps = {
     onSubmit: (submission: ComposerSubmission) => void;
-    onAttach?: () => void;
+    onAttach?: (() => void) | ((files: File[]) => void);
+    commands?: ComposerCommand[];
+    onCommand?: (id: string, argumentText: string) => void;
     attachments?: ReactNode;
     mentions?: ComposerMention[];
+    onMentionQuery?: MentionQuery;
+    placeholder?: string;
+    hint?: ReactNode;
     disabled?: boolean;
 };
 
@@ -760,7 +801,7 @@ export declare type ContextSwitcherSearch = {
     noResults: ContextSwitcherEmptyState;
 };
 
-export declare function ControlOption({ id, label, description, error, indeterminate, ref, type, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, onClick, ...rest }: ControlOptionProps): JSX.Element;
+export declare function ControlOption({ id, label, labelHidden, description, error, indeterminate, ref, type, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, onClick, ...rest }: ControlOptionProps): JSX.Element;
 
 declare type ControlOptionNativeInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'id' | 'type'>;
 
@@ -772,7 +813,7 @@ declare type ControlOptionOwnProps = {
 };
 
 /** ControlOption 的完整 props（Checkbox / Radio 的共同底座，须显式给 type）。 */
-export declare type ControlOptionProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & CheckboxOnlyProps & {
+export declare type ControlOptionProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & FieldLabelVisibilityProps & CheckboxOnlyProps & {
     type: 'checkbox' | 'radio';
 } & ControlOptionNativeInputProps;
 
@@ -830,14 +871,18 @@ export declare type DocsPaginationProps = {
     next?: DocsPageLink;
 };
 
-export declare function DotsMenu({ entries, size, disabled, align, }: {
+export declare function DotsMenu({ entries, size, disabled, align, label, }: {
     entries: DotsMenuEntry[];
+    label?: string;
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;
     align?: 'start' | 'end';
 }): JSX.Element;
 
 export declare type DotsMenuEntry = {
+    type: 'separator';
+} | {
+    type?: 'item';
     label: string;
     disabled?: boolean;
     danger?: boolean;
@@ -865,6 +910,9 @@ export declare function EmptyState({ icon, title, description, actions, headingL
     headingLevel?: 2 | 3 | 4 | 5 | 6;
 }): JSX.Element;
 
+/** Public host for consumer-owned sibling portals. Package overlays share this Foundation root. */
+export declare function ensurePopoverRoot(): HTMLElement | null;
+
 export declare function Entity({ leading, title, subtitle, trailing, }: {
     leading?: ReactNode;
     title: string;
@@ -926,6 +974,14 @@ declare type FieldBareProps = {
     error?: never;
 };
 
+export declare type FieldLabelVisibilityProps = {
+    label: string;
+    labelHidden?: boolean;
+} | {
+    label?: never;
+    labelHidden?: never;
+};
+
 export declare function Fieldset({ title, subtitle, tone, footerStatus, footerAction, disabled, children, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, }: {
     title?: string;
     subtitle: string;
@@ -963,23 +1019,60 @@ export declare type FileTreeNode = {
 };
 
 /** 筛选选择器入口；弹层、筛选值与 expanded 状态归调用方。 */
-export declare function FilterChip({ label, value, onClear, disabled, className, ...props }: FilterChipProps): JSX.Element;
+export declare const FilterChip: ForwardRefExoticComponent<    {
+label: string;
+/** 可选同高尺寸；默认 sm（32px）胶囊。 */
+size?: ButtonSize;
+/** undefined 表示未设置；0、空字符串和 null 仍是已设置。 */
+value?: ReactNode;
+onClear?: () => void;
+} & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "value"> & RefAttributes<HTMLButtonElement>>;
 
 export declare type FilterChipProps = {
     label: string;
+    /** 可选同高尺寸；默认 sm（32px）胶囊。 */
+    size?: ButtonSize;
     /** undefined 表示未设置；0、空字符串和 null 仍是已设置。 */
     value?: ReactNode;
     onClear?: () => void;
 } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'value'>;
 
-export declare function FormField({ controlId, label, description, error, wide, children, }: {
-    controlId: string;
+export declare type FilterOption = {
+    value: string;
     label: string;
     description?: string;
+    keywords?: string[];
+    disabled?: boolean;
+};
+
+/** 可搜索单选内容；调用方通过 Popover 管理关闭和入口焦点。每次打开时面板自行把焦点放进搜索框，无需向 Popover 传 initialFocus。 */
+export declare function FilterOptionPanel({ options, value, onSelect, label, searchPlaceholder, loading, error, onRetry, emptyText, noMatchText, filter, query: controlledQuery, onQueryChange }: FilterOptionPanelProps): JSX.Element;
+
+export declare type FilterOptionPanelProps = {
+    options: FilterOption[];
+    value?: string;
+    onSelect: (value: string) => void;
+    /** 搜索框与列表的可访问名称。 */
+    label: string;
+    searchPlaceholder?: string;
+    loading?: boolean;
+    error?: ReactNode;
+    onRetry?: () => void;
+    emptyText?: ReactNode;
+    noMatchText?: (query: string) => ReactNode;
+    filter?: (options: FilterOption[], query: string) => FilterOption[];
+    query?: string;
+    onQueryChange?: (query: string) => void;
+};
+
+export declare function FormField({ controlId, label, labelHidden, description, error, wide, children, }: {
+    controlId: string;
+    label?: string;
+    description?: string;
     error?: string;
     wide?: boolean;
     children: ReactNode;
-}): JSX.Element;
+} & FieldLabelVisibilityProps): JSX.Element;
 
 export declare function Gauge({ value, size, showValue, tone, toneDirection, label, indeterminate, }: {
     value?: number;
@@ -998,6 +1091,21 @@ export declare type GaugeToneDirection = 'quota' | 'health';
 /** One coordinator per document, shared with all package overlays. Null during SSR. */
 export declare function getOverlayCoordinator(doc?: Document | null): OverlayCoordinator | null;
 
+/** Hoverable supplemental information; activation belongs to the trigger. */
+export declare function HoverCard({ trigger, children, openDelay, closeDelay, side, align, className }: HoverCardProps): JSX.Element;
+
+export declare type HoverCardProps = {
+    /** A named native button, or a component forwarding native button attributes. */
+    trigger: ReactElement<ButtonHTMLAttributes<HTMLButtonElement>>;
+    /** Supplemental, noninteractive content; essential information belongs in the page. */
+    children: ReactNode;
+    openDelay?: number;
+    closeDelay?: number;
+    side?: PopoverSide;
+    align?: PopoverAlign;
+    className?: string;
+};
+
 export declare function IconButton({ 'aria-label': canonicalAriaLabel, ariaLabel: legacyAriaLabel, 'aria-pressed': ariaPressed, disabled, loading, onClick, onBlur, onKeyDown, onPointerCancel, onPointerDown, onPointerLeave, onPointerUp, onLostPointerCapture, ...rest }: IconButtonProps): JSX.Element;
 
 declare type IconButtonAccessibleName = {
@@ -1033,7 +1141,7 @@ export declare type IconButtonProps = IconButtonAccessibleName & IconButtonBaseP
     ref?: Ref<HTMLButtonElement>;
 };
 
-export declare function Input({ id, label, description, error, invalid, errorId, ref, prefix, suffix, prefixStyling, suffixStyling, rounded, wide, size, className, revealable, revealed, onRevealedChange, revealLabel, hideLabel, disabled, ...rest }: {
+export declare function Input({ id, label, labelHidden, description, error, invalid, errorId, ref, prefix, suffix, prefixStyling, suffixStyling, rounded, wide, size, className, revealable, revealed, onRevealedChange, revealLabel, hideLabel, disabled, ...rest }: {
     /** 可选：未传时内部 useId 兜底（对齐 Combobox）；显式传入时行为同 0.3.0。 */
     id?: string;
     /** 置 aria-invalid 的业务校验态，不渲染文案；与壳模式 error 并轨（invalid || Boolean(error)）。 */
@@ -1070,9 +1178,9 @@ export declare function Input({ id, label, description, error, invalid, errorId,
     rounded?: boolean;
     wide?: boolean;
     size?: FieldSize;
-} & (FieldShellProps | FieldBareProps) & Omit<InputHTMLAttributes<HTMLInputElement>, 'id' | 'size' | 'prefix'>): JSX.Element;
+} & (FieldShellProps | FieldBareProps) & FieldLabelVisibilityProps & Omit<InputHTMLAttributes<HTMLInputElement>, 'id' | 'size' | 'prefix'>): JSX.Element;
 
-export declare function InputOTP({ id, name, value, onValueChange, disabled, readOnly, required, invalid, errorId, size, separator, ref, label, description, error, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': describedBy, }: InputOTPProps): JSX.Element;
+export declare function InputOTP({ id, name, value, onValueChange, disabled, readOnly, required, invalid, errorId, size, separator, ref, label, labelHidden, description, error, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': describedBy, }: InputOTPProps): JSX.Element;
 
 export declare type InputOTPProps = {
     id?: string;
@@ -1090,7 +1198,7 @@ export declare type InputOTPProps = {
     separator?: boolean;
     ref?: Ref<HTMLInputElement>;
     'aria-describedby'?: string;
-} & ((FieldShellProps & {
+} & FieldLabelVisibilityProps & ((FieldShellProps & {
     'aria-label'?: never;
     'aria-labelledby'?: never;
 }) | (FieldBareProps & ({
@@ -1193,7 +1301,7 @@ export declare function Marker({ actor, time, variant, children, }: MarkerProps)
 export declare type MarkerProps = {
     actor?: ReactNode;
     time?: ReactNode;
-    variant?: 'default' | 'separator';
+    variant?: 'default' | 'separator' | 'unread';
     children: ReactNode;
 };
 
@@ -1203,8 +1311,14 @@ export declare type MentionProps = {
     children: ReactNode;
 };
 
-export declare function Menu({ label, entries, withChevron, align, triggerContent }: {
+declare type MentionQuery = (query: string, options: {
+    signal: AbortSignal;
+}) => Promise<ComposerMention[]>;
+
+export declare function Menu({ label, entries, withChevron, align, triggerContent, size }: {
     label: string;
+    /** 文字触发器尺寸，默认 md；图标触发器保留原尺寸。 */
+    size?: ButtonSize;
     entries: MenuEntry[];
     withChevron?: boolean;
     align?: 'start' | 'end';
@@ -1265,7 +1379,7 @@ declare type MenuLinkBase = {
     suffix?: ReactNode;
 };
 
-export declare function Message({ author, avatar, time, children, attachments, actions, status, onRetry, }: MessageProps): JSX.Element;
+export declare function Message({ author, avatar, time, children, attachments, actions, acknowledgements, status, onRetry, }: MessageProps): JSX.Element;
 
 export declare type MessageProps = {
     author: ReactNode;
@@ -1274,10 +1388,31 @@ export declare type MessageProps = {
     children: ReactNode;
     attachments?: ReactNode;
     actions?: ReactNode;
+    acknowledgements?: ReactNode;
     status?: 'default' | 'pending' | 'failed';
     onRetry?: () => void;
 };
 
+export declare function MessageScroller({ label, items, conversationKey, nearBottomThreshold, announcement, jumpLabel, before, empty, className, style }: MessageScrollerProps): JSX.Element;
+
+export declare type MessageScrollerItem = {
+    id: string | number;
+    content: ReactNode;
+};
+
+export declare type MessageScrollerProps = {
+    label: string;
+    items: readonly MessageScrollerItem[];
+    conversationKey?: string | number;
+    nearBottomThreshold?: number;
+    announcement?: string;
+    jumpLabel?: string;
+    before?: ReactNode;
+    empty?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+};
+
 export declare function MiddleTruncate({ text, tailLength, mono }: {
     text: string;
     tailLength?: number;
@@ -1520,8 +1655,60 @@ export declare type PillProps = {
     title?: string;
 } & AnchorHTMLAttributes<HTMLAnchorElement>;
 
+export declare function Popover({ open: controlledOpen, defaultOpen, onOpenChange, onClose, trigger, anchorRef, children, side, align, placement: requestedPlacement, modal, ariaModal, role: requestedRole, ariaLabel, ariaLabelledBy, ariaDescribedBy, offset, matchWidth, selectedValue, initialFocus, id: suppliedId, className, dismissExcludeRefs }: PopoverProps): JSX.Element;
+
+export declare type PopoverAlign = 'start' | 'center' | 'end';
+
+export declare type PopoverInitialFocus = 'first' | 'last' | 'none';
+
 export declare type PopoverLayout = 'vertical' | 'horizontal';
 
+export declare type PopoverPlacement = 'auto' | 'auto-end' | 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+
+export declare type PopoverProps = PopoverSharedProps & (({
+    trigger: ReactNode;
+    anchorRef?: never;
+    open?: boolean;
+    defaultOpen?: boolean;
+} & ({
+    ariaLabel: string;
+    ariaLabelledBy?: never;
+} | {
+    ariaLabel?: never;
+    ariaLabelledBy: string;
+})) | {
+    trigger?: never;
+    anchorRef: RefObject<HTMLElement | null>;
+    open: boolean;
+    defaultOpen?: never;
+    ariaLabel?: string;
+    ariaLabelledBy?: string;
+});
+
+export declare type PopoverRole = 'dialog' | 'menu' | 'listbox';
+
+declare type PopoverSharedProps = {
+    children: ReactNode;
+    onOpenChange?: (open: boolean) => void;
+    onClose?: () => void;
+    placement?: PopoverPlacement;
+    side?: PopoverSide;
+    align?: PopoverAlign;
+    role?: PopoverRole;
+    modal?: boolean;
+    ariaModal?: boolean;
+    ariaDescribedBy?: string;
+    offset?: number;
+    matchWidth?: boolean | number;
+    selectedValue?: string | number;
+    initialFocus?: PopoverInitialFocus;
+    id?: string;
+    className?: string;
+    dismissExcludeRefs?: ReadonlyArray<RefObject<HTMLElement | null>>;
+};
+
+export declare type PopoverSide = 'bottom' | 'top' | 'left' | 'right';
+
 export declare function ProductLockup({ name, icon, brand, size, className, 'aria-label': ariaLabel, ...rest }: ProductLockupProps): JSX.Element;
 
 export declare type ProductLockupProps = {
@@ -1575,9 +1762,9 @@ export declare function Q1travelSymbol(props: SVGProps<SVGSVGElement>): JSX.Elem
 export declare function Radio({ ...props }: RadioProps): JSX.Element;
 
 /** Radio 的完整 props。 */
-export declare type RadioProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & ControlOptionNativeInputProps;
+export declare type RadioProps = ControlOptionOwnProps & (FieldShellProps | FieldBareProps) & FieldLabelVisibilityProps & ControlOptionNativeInputProps;
 
-export declare function RangeField({ layout, trigger, size, fieldSize, minValue, maxValue, pinnedTimezone, today, value, onChange, }: {
+export declare function RangeField(props: CalendarSelectionProps & {
     layout?: PopoverLayout;
     trigger?: TriggerKind;
     size?: CalendarSize;
@@ -1586,18 +1773,18 @@ export declare function RangeField({ layout, trigger, size, fieldSize, minValue,
     minValue?: Date;
     maxValue?: Date;
     pinnedTimezone?: string;
-    /** 透传给内部 CalendarGrid（默认真实当前日期）；文档 demo 传固定值保持演示可控。 */
     today?: Date;
-    value: RangeValue;
-    onChange: (next: RangeValue) => void;
+    /** 显式启用本地 24 小时时间编辑；默认仅选择日期。 */
+    withTime?: boolean;
 }): JSX.Element;
 
-export declare function RangeInputs({ value, onApply, pinnedTimezone, }: {
+export declare function RangeInputs(props: (CalendarSelectionProps | {
+    mode?: 'range';
     value: RangeValue;
-    /** 兼容保留；当前组件不提供时间值或时间编辑能力。 */
+    onChange?: (next: RangeValue) => void;
+}) & {
     withTime: boolean;
     onApply: () => void;
-    /** 固定时区：传入时时区从可选 select 变只读文本、不可切换。 */
     pinnedTimezone?: string;
 }): JSX.Element;
 
@@ -1685,10 +1872,12 @@ export declare type SearchDialogTriggerProps = {
     'aria-controls': string;
 };
 
-export declare function SearchInput({ id, ariaLabel, value: controlledValue, defaultValue, onValueChange, loading, kbdHint, icon, ref, className, disabled, readOnly, autoComplete, spellCheck, onKeyDown: onInputKeyDown, ...inputProps }: SearchInputProps): JSX.Element;
+export declare function SearchInput({ id, size, ariaLabel, value: controlledValue, defaultValue, onValueChange, loading, kbdHint, icon, ref, className, disabled, readOnly, autoComplete, spellCheck, onKeyDown: onInputKeyDown, ...inputProps }: SearchInputProps): JSX.Element;
 
 export declare type SearchInputProps = {
     id: string;
+    /** 与 Button 同高，默认 md；数字保留原生 input 的字符宽度语义。 */
+    size?: ButtonSize | number;
     /** 无可见 label 时的可访问名；与 FormField 或外部 label 组合时留空。 */
     ariaLabel?: string;
     value?: string;
@@ -1701,11 +1890,11 @@ export declare type SearchInputProps = {
     icon?: ReactNode;
     /** React 19 ref-as-prop，指向原生 search input。 */
     ref?: Ref<HTMLInputElement>;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, 'aria-label' | 'defaultValue' | 'id' | 'onChange' | 'ref' | 'type' | 'value'>;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'aria-label' | 'defaultValue' | 'id' | 'onChange' | 'ref' | 'type' | 'value'>;
 
-export declare function Select({ id, label, description, error, ref, wide, size, prefix, suffix, className, children, value, defaultValue, multiple, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, ...rest }: {
+export declare function Select({ id, label, labelHidden, description, error, ref, wide, size, prefix, suffix, className, children, value, defaultValue, multiple, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, ...rest }: {
     id: string;
-    label: string;
+    label?: string;
     description?: string;
     error?: string;
     /** 指向原生 select（React 19 ref-as-prop），供表单校验后聚焦等场景。 */
@@ -1713,7 +1902,7 @@ export declare function Select({ id, label, description, error, ref, wide, size,
     wide?: boolean;
     size?: FieldSize;
     prefix?: ReactNode;
-    /** 装饰性后缀图标（aria-hidden），渲染在下拉箭头左侧；跟 prefix 前缀一样不承载信息，可访问名称仍完全来自 label。 */
+    /** 装饰性后缀图标（aria-hidden），渲染在下拉箭头左侧；跟 prefix 前缀一样不承载信息，可访问名称来自可见 label 或消费方提供的 ARIA / 外部 label。 */
     suffix?: ReactNode;
     children: ReactNode;
     /** Select 只接受单一值；多值选择使用 MultiSelect。 */
@@ -1722,7 +1911,7 @@ export declare function Select({ id, label, description, error, ref, wide, size,
     defaultValue?: string | number;
     /** Select 是单选字段；多值选择使用 MultiSelect。 */
     multiple?: never;
-} & Omit<SelectHTMLAttributes<HTMLSelectElement>, 'id' | 'children' | 'size' | 'prefix' | 'multiple' | 'value' | 'defaultValue'>): JSX.Element;
+} & FieldLabelVisibilityProps & Omit<SelectHTMLAttributes<HTMLSelectElement>, 'id' | 'children' | 'size' | 'prefix' | 'multiple' | 'value' | 'defaultValue'>): JSX.Element;
 
 export declare function Separator({ orientation, decorative, className, }: {
     orientation?: SeparatorOrientation;
@@ -1732,13 +1921,15 @@ export declare function Separator({ orientation, decorative, className, }: {
 
 export declare type SeparatorOrientation = 'horizontal' | 'vertical';
 
-export declare function Sheet({ open, onClose, title, side, size, dismissable, children, footer }: {
+export declare function Sheet({ open, onClose, title, side, size, dismissable, mobileFullscreen, children, footer }: {
     open: boolean;
     onClose: () => void;
     title: string;
     side?: SheetSide;
     size?: SheetSize;
     dismissable?: boolean;
+    /** 窄屏全视口面板；默认保留浮层间距。 */
+    mobileFullscreen?: boolean;
     children: ReactNode;
     footer?: ReactNode;
 }): ReactNode;
@@ -2011,7 +2202,7 @@ export declare function Tabs({ tabs, ariaLabel, variant, value, defaultValue, on
     onValueChange?: (id: string) => void;
 }): JSX.Element | null;
 
-export declare function Textarea({ id, label, description, error, invalid, errorId, ref, wide, size, className, maxLength, onInput, ...rest }: TextareaProps): JSX.Element;
+export declare function Textarea({ id, label, labelHidden, description, error, invalid, errorId, ref, wide, size, className, maxLength, onInput, ...rest }: TextareaProps): JSX.Element;
 
 /** Textarea 的完整 props。消费方包一层时用它标注，无需知道内部由哪几块组合而成。 */
 export declare type TextareaProps = {
@@ -2025,7 +2216,7 @@ export declare type TextareaProps = {
     ref?: Ref<HTMLTextAreaElement>;
     wide?: boolean;
     size?: FieldSize;
-} & (FieldShellProps | FieldBareProps) & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'id'>;
+} & (FieldShellProps | FieldBareProps) & FieldLabelVisibilityProps & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'id'>;
 
 export declare function TextWithCopyButton({ text, copyValue, successMessage, size, }: {
     text: string;
@@ -2051,6 +2242,13 @@ export declare type ThresholdTone = 'primary' | 'success' | 'warning' | 'danger'
 
 export declare function Timeline({ className, ...props }: TimelineProps): JSX.Element;
 
+export declare function TimelineCollapsedGroup({ summary, children }: TimelineCollapsedGroupProps): JSX.Element;
+
+export declare type TimelineCollapsedGroupProps = {
+    summary: ReactNode;
+    children: ReactNode;
+};
+
 export declare function TimelineItem({ tone, indicator, children, className, ...props }: TimelineItemProps): JSX.Element;
 
 export declare type TimelineItemProps = HTMLAttributes<HTMLLIElement> & {
@@ -2107,6 +2305,42 @@ export declare function Toggle({ checked, defaultOn, onChange, disabled, size, o
     ariaLabel?: string;
 }): JSX.Element;
 
+export declare function ToggleGroup(props: ToggleGroupProps): JSX.Element;
+
+declare type ToggleGroupBaseProps = {
+    items: ToggleGroupItem[];
+    ariaLabel: string;
+    size?: ButtonSize;
+    disabled?: boolean;
+};
+
+export declare type ToggleGroupItem = {
+    value: string;
+    disabled?: boolean;
+} & ({
+    label: string;
+    icon?: ReactNode;
+    ariaLabel?: string;
+} | {
+    label?: never;
+    icon: ReactNode;
+    ariaLabel: string;
+});
+
+export declare type ToggleGroupProps = ToggleGroupBaseProps & ({
+    type: 'single';
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    allowEmpty?: boolean;
+} | {
+    type: 'multiple';
+    value?: string[];
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+    allowEmpty?: never;
+});
+
 export declare type ToggleSize = 'sm' | 'md' | 'lg';
 
 export declare function Toolbar({ 'aria-label': ariaLabel, orientation, children, className, }: ToolbarProps): JSX.Element;