@unicom-cloud/ui 0.8.98 → 0.8.100

package/types/pc/liquid-fill/index.d.ts

@@ -1,2 +1,115 @@
-import LiquidFill from './LiquidFill';
+import React, { type CSSProperties } from 'react';
+/**
+ * 颜色配置类型，支持纯色和渐变色
+ */
+type ColorType = string | {
+    /** 渐变起始颜色 */
+    from: string;
+    /** 渐变结束颜色 */
+    to: string;
+    /**
+     * 渐变方向
+     * @default 'vertical' 垂直渐变
+     */
+    direction?: 'horizontal' | 'vertical';
+};
+/**
+ * 水球填充组件的属性接口
+ */
+export interface LiquidFillProps {
+    /** 自定义容器样式 */
+    style?: CSSProperties;
+    /** 自定义类名 */
+    className?: string | string[];
+    /**
+     * 当前填充比例 (0-1)
+     * @default 0.5
+     */
+    value: number;
+    /**
+     * 组件尺寸 (像素)
+     * @default 200
+     */
+    size?: number;
+    /**
+     * 字体大小
+     * @default size * 0.15
+     */
+    fontSize?: number | string;
+    /**
+     * 波浪颜色，支持纯色或渐变色
+     * @default 'rgb(var(--pqb-blue-6))'
+     */
+    waveColor?: ColorType;
+    /**
+     * 背景颜色，支持纯色或渐变色
+     * @default 'var(--pqb-color-neutral-1)'
+     */
+    backgroundColor?: ColorType;
+    /**
+     * 文字颜色
+     * @default 'var(--pqb-color-neutral-8)'
+     */
+    textColor?: string;
+    /**
+     * 是否显示百分比
+     * @default true
+     */
+    showPercent?: boolean;
+    /**
+     * 动画持续时间(毫秒)
+     * @default 2000
+     */
+    duration?: number;
+    /**
+     * 波浪数量
+     * @default 3
+     */
+    waveCount?: number;
+    /**
+     * 波浪振幅
+     * @default 10
+     */
+    waveAmplitude?: number;
+    /**
+     * 内层边框颜色
+     * @default 'var(--pqb-color-neutral-4)'
+     */
+    borderColor?: string;
+    /**
+     * 内层边框宽度
+     * @default 2
+     */
+    borderWidth?: number;
+    /**
+     * 外层边框颜色（默认使用内层边框颜色但透明度30%）
+     */
+    outerBorderColor?: string;
+    /**
+     * 外层边框宽度
+     * @default 0（不显示）
+     */
+    outerBorderWidth?: number;
+    /**
+     * 内外层边框间距
+     * @default 2
+     */
+    borderGap?: number;
+    /**
+     * 百分比显示的小数位数
+     * @default 0（整数）
+     */
+    decimalPlaces?: number;
+    /**
+     * 百分号相对于数字的缩放比例
+     * @default 0.5
+     */
+    percentFontScale?: number;
+    /**
+     * 波浪速度变化系数（值越大速度差异越大）
+     * @default 0.5
+     */
+    waveSpeedVariation?: number;
+}
+declare const LiquidFill: React.FC<LiquidFillProps>;
 export default LiquidFill;

package/types/pc/list/interface.d.ts

@@ -77,7 +77,6 @@ export interface ListProps<T = any> {
     /**
      * @zh 列表栅格配置
      * @en The grid type of list
-     * @version `column` in 2.20.0
      */
     grid?: ListGridProps;
     /**
@@ -88,7 +87,6 @@ export interface ListProps<T = any> {
     /**
      * @zh 列表项是否可悬浮
      * @en Whether list items have hover style
-     * @version 2.9.0
      */
     hoverable?: boolean;
     /**
@@ -117,7 +115,6 @@ export interface ListProps<T = any> {
     /**
      * @zh 当前列表的引用
      * @en Reference to the current list
-     * @version 2.20.0
      */
     listRef?: MutableRefObject<ListHandle>;
     /**
@@ -138,7 +135,6 @@ export interface ListProps<T = any> {
     /**
      * @zh 传递虚拟列表属性，传入此参数以开启虚拟滚动
      * @en Pass the virtual-list properties, pass in this parameter to turn on virtual scrolling
-     * @version 2.11.0
      */
     virtualListProps?: AvailableVirtualListProps;
 }

package/types/pc/marquee/index.d.ts

@@ -0,0 +1,61 @@
+import React, { type CSSProperties, type ReactNode } from 'react';
+export interface MarqueeProps {
+    /**
+     * 运动内容（支持文本或React节点）
+     * @example
+     * <Marquee>这是运动内容</Marquee>
+     */
+    children?: ReactNode;
+    /**
+     * 运动速度（像素/秒）
+     * @default 50
+     * @range 1-200
+     */
+    speed?: number;
+    /**
+     * 运动方向
+     * @default 'left'
+     * @enum ['left', 'right', 'up', 'down']
+     */
+    direction?: 'left' | 'right' | 'up' | 'down';
+    /**
+     * 鼠标悬停时是否暂停
+     * @default false
+     */
+    pauseOnHover?: boolean;
+    /**
+     * 是否显示边缘渐变遮罩
+     * @default true
+     */
+    gradient?: boolean;
+    /**
+     * 循环次数（0表示无限循环）
+     * @default 0
+     * @example
+     * <Marquee loop={3}>循环3次</Marquee>
+     */
+    loop?: number;
+    /**
+     * 循环完成回调（仅在loop>0时触发）
+     */
+    onComplete?: () => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 渐变遮罩尺寸（像素）
+     * @default 50
+     */
+    gradientSize?: number;
+}
+/**
+ * 跑马灯组件
+ * 实现所有方向完美无缝循环运动
+ */
+declare const Marquee: React.FC<MarqueeProps>;
+export default Marquee;

package/types/pc/menu/context.d.ts

@@ -5,7 +5,7 @@ export type HotkeyInfo = {
     type: 'sibling' | 'generation' | 'enter';
 };
 export type ResetHotkeyInfo = (activeKey?: string) => void;
-declare const MenuContext: import("react").Context<Pick<MenuProps, "theme" | "mode" | "collapse" | "icons" | "triggerProps" | "inDropdown" | "tooltipProps" | "levelIndent" | "selectedKeys" | "openKeys" | "autoScrollIntoView" | "scrollConfig"> & {
+declare const MenuContext: import("react").Context<Pick<MenuProps, "theme" | "collapse" | "mode" | "icons" | "triggerProps" | "inDropdown" | "tooltipProps" | "levelIndent" | "selectedKeys" | "openKeys" | "autoScrollIntoView" | "scrollConfig"> & {
     id?: string;
     prefixCls?: string;
     onClickMenuItem?: (key: string, e: any) => void;

package/types/pc/menu/interface.d.ts

@@ -63,7 +63,6 @@ export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'classNa
      * @zh 水平菜单是否自动溢出省略
      * @en Whether the horizontal menu automatically collapses when it overflows
      * @defaultValue true
-     * @version 2.24.0
      */
     ellipsis?: boolean | {
         text?: ReactNode;
@@ -101,13 +100,11 @@ export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'classNa
     /**
      * @zh 点击菜单项的回调
      * @en Click menu item callback
-     * @version `event` in 2.15.0, `keyPath` in 2.19.0
      */
     onClickMenuItem?: (key: string, event: any, keyPath: string[]) => any;
     /**
      * @zh 点击子菜单标题的回调
      * @en Callback when click sub menu
-     * @version `keyPath` in 2.19.0
      */
     onClickSubMenu?: (key: string, openKeys: string[], keyPath: string[]) => void;
     /**
@@ -118,7 +115,6 @@ export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'classNa
     /**
      * @zh 水平菜单自动超出省略发生变化时的回调
      * @en Callback when horizontal-menu ellipsis status changed
-     * @version 2.57.0
      */
     onEllipsisChange?: (status: {
         lastVisibleIndex: number;
@@ -172,13 +168,11 @@ export interface MenuSubMenuProps extends Omit<HTMLAttributes<HTMLElement>, 'tit
     /**
      * @zh 是否强制使用弹出模式，`level` 表示当前子菜单的层级
      * @en Whether to force the use of popup mode, parameter `level` indicates the level of current subMenu.
-     * @version 2.8.0
      */
     popup?: boolean | ((level: number) => boolean);
     /**
      * @zh 弹出模式下可接受所有 `Trigger` 的 `Props`
      * @en Pass all `Trigger` component properties
-     * @version 2.19.0
      */
     triggerProps?: Partial<TriggerProps>;
 }
@@ -221,13 +215,11 @@ export interface MenuItemProps extends Omit<HTMLAttributes<HTMLElement>, 'classN
      * @zh 配置最外层标签，可以是 html 标签或是组件
      * @en Configure the outermost label, which can be a html label or a component
      * @defaultValue div
-     * @version 2.16.0
      */
     wrapper?: string | React.FC<any> | React.ComponentClass<any>;
     /**
      * @zh 菜单折叠时，指定在 Tooltip 中展示的菜单项节点
      * @en Set the menu item displayed in Tooltip when menu is collapsed
-     * @version 2.51.0
      */
     renderItemInTooltip?: () => ReactNode;
 }

package/types/pc/message/interface.d.ts

@@ -15,7 +15,6 @@ export interface MessageProps {
      * @zh 动画持续时间，见 react-transition-group 的 `timeout`
      * @en timeout of `react-transition-group` of the message pop-up animation, see `timeout`
      * @defaultValue {enter: 100, exit: 300}
-     * @version 2.43.0
      */
     transitionTimeout?: {
         enter?: number;
@@ -67,7 +66,6 @@ export interface MessageProps {
     /**
      * @zh 自定义右上角关闭按钮
      * @en Custom the close button on top-right of the drawer dialog
-     * @version 2.50.0
      */
     closeIcon?: ReactNode;
     type?: string;

package/types/pc/modal/interface.d.ts

@@ -77,7 +77,6 @@ export interface ModalProps {
     /**
      * @zh 自定义页脚，传入 null 则不显示
      * @en Custom `footer`. if it is null, the footer will not be displayed.
-     * @version 2.12.0
      */
     footer?: ReactNode | ((cancelButtonNode: ReactNode, okButtonNode: ReactNode) => ReactNode);
     /**
@@ -88,7 +87,6 @@ export interface ModalProps {
     /**
      * @zh 自定义右上角的关闭按钮节点
      * @en Customize the close icon
-     * @version 2.21.0
      */
     closeIcon?: ReactNode;
     /**
@@ -100,7 +98,6 @@ export interface ModalProps {
     /**
      * @zh 蒙层的样式
      * @en The style of mask
-     * @version 2.6.0
      */
     maskStyle?: CSSProperties;
     /**
@@ -149,14 +146,12 @@ export interface ModalProps {
     /**
      * @zh 弹出框外层样式
      * @en The style of the wrapped dom
-     * @version 2.16.0
      */
     wrapStyle?: CSSProperties;
     hideCancel?: boolean;
     /**
      * @zh 自定义渲染对话框
      * @en Custom the render of Modal
-     * @version 2.2.0
      */
     modalRender?: (modalNode: ReactNode) => ReactNode;
     prefixCls?: string;

package/types/pc/notification/interface.d.ts

@@ -61,7 +61,6 @@ export interface NotificationProps {
     /**
      * @zh 自定义右上角关闭按钮
      * @en Custom the close button on top-right of the drawer dialog
-     * @version 2.50.0
      */
     closeIcon?: ReactNode;
     type?: string;

package/types/pc/pagination/interface.d.ts

@@ -49,7 +49,6 @@ export interface PaginationProps {
     /**
      * @zh 是否在只有一页的情况下隐藏
      * @en Whether to hide when there is only one page
-     * @version 2.6.0
      */
     hideOnSinglePage?: boolean;
     /**
@@ -81,7 +80,6 @@ export interface PaginationProps {
      * @zh `current` 页与 `...` 之间的页码个数
      * @en the number of pages between the `current` page and `...`
      * @defaultValue 2
-     * @version 2.32.0
      */
     bufferSize?: number;
     /**

package/types/pc/popconfirm/interface.d.ts

@@ -19,20 +19,18 @@ export interface PopconfirmProps {
      */
     position?: 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br' | 'left' | 'lt' | 'lb' | 'right' | 'rt' | 'rb';
     /**
-     * @zh 标题。 函数类型在 `2.48.0` 支持
-     * @en Title of Popconfirm. Function types are supported in `2.48.0`
+     * @zh 标题
+     * @en Title of Popconfirm.
      */
     title?: ReactNode | (() => ReactNode);
     /**
-     * @zh 内容.函数类型在 `2.48.0` 支持
-     * @en Content of Popconfirm   Function types are supported in `2.48.0`
-     * @version 2.44.0
+     * @zh 内容
+     * @en Content of Popconfirm
      */
     content?: ReactNode | (() => ReactNode);
     /**
      * @zh 是否禁用
      * @en whether to disabled
-     * @version 2.11.0
      */
     disabled?: boolean;
     /**
@@ -62,13 +60,13 @@ export interface PopconfirmProps {
      */
     cancelButtonProps?: ButtonProps;
     /**
-     * @zh 点击确认按钮的回调函数。回调函数 `event` 参数在 `2.29.0` 支持
-     * @en Callback when click the ok button. Callback `event` params is supported in `2.29.0`
+     * @zh 点击确认按钮的回调函数。
+     * @en Callback when click the ok button.
      */
     onOk?: (e: React.MouseEvent) => Promise<any> | void;
     /**
-     * @zh 点击取消按钮的回调函数。 回调函数 `event` 参数在 `2.29.0` 支持
-     * @en Callback when click the cancel button. Callback `event` params is supported in `2.29.0`
+     * @zh 点击取消按钮的回调函数。
+     * @en Callback when click the cancel button.
      */
     onCancel?: (e: React.MouseEvent) => void;
     /**

package/types/pc/popover/interface.d.ts

@@ -14,7 +14,6 @@ export interface PopoverProps extends Omit<TooltipProps, 'mini'> {
     /**
      * @zh 是否禁用
      * @en Whether to disabled
-     * @version 2.11.0
      */
     disabled?: boolean;
 }

package/types/pc/progress/interface.d.ts

@@ -14,7 +14,6 @@ export interface ProgressProps {
     /**
      * @zh 显示步骤进度条
      * @en Show step progress
-     * @version 2.10.0
      */
     steps?: number;
     /**
@@ -25,13 +24,11 @@ export interface ProgressProps {
     /**
      * @zh 进度条状态
      * @en Progress status.
-     * @version 2.16.0
      */
     status?: 'success' | 'error' | 'normal' | 'warning';
     /**
      * @zh 进度条颜色，优先级高于 `status`。传入对象时，会显示渐变色进度条。
      * @en Progress color, priority is higher than `status`
-     * @version 2.10.0
      */
     color?: string | {
         [key: string]: string;

package/types/pc/qr-code/index.d.ts

@@ -21,7 +21,7 @@ export interface QRCodeProps {
         src: string;
         height: number;
         width: number;
-        excavate?: boolean;
+        excavate: boolean;
         x?: number;
         y?: number;
     };

package/types/pc/rate/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import { RateProps } from './interface';
-declare const RateComponent: React.ForwardRefExoticComponent<RateProps & React.RefAttributes<unknown>>;
-export default RateComponent;
+declare const Rate: React.ForwardRefExoticComponent<RateProps & React.RefAttributes<unknown>>;
+export default Rate;
 export type { RateProps };

package/types/pc/resize-box/interface.d.ts

@@ -8,13 +8,11 @@ export interface ResizeBoxProps {
     /**
      * @zh 宽度，受控属性
      * @en The width of ResizeBox
-     * @version 2.7.0
      */
     width?: number;
     /**
      * @zh 高度，受控属性
      * @en The height of ResizeBox
-     * @version 2.7.0
      */
     height?: number;
     /**
@@ -59,7 +57,6 @@ export interface ResizeBoxProps {
     /**
      * @zh 拖拽中的回调
      * @en Callback when resizing
-     * @version `size` in `2.7.0`
      */
     onMoving?: (e: MouseEvent, size: {
         width: number;
@@ -87,7 +84,6 @@ export interface SplitProps {
      * @zh 分割方向分为水平 `horizontal` 和垂直 `vertical`，默认是水平分割
      * @en The direction of Split. It can be `horizontal` and `vertical`
      * @defaultValue horizontal
-     * @version `reverse` in `2.35.0`
      */
     direction?: 'horizontal' | 'vertical' | 'horizontal-reverse' | 'vertical-reverse';
     /**
@@ -134,7 +130,6 @@ export interface SplitProps {
     /**
      * @zh 拖拽中的回调
      * @en Callback when moving
-     * @version `size` in `2.14.0`
      */
     onMoving?: (e: MouseEvent, size: number | string) => void;
     /**
@@ -145,12 +140,11 @@ export interface SplitProps {
     /**
      * @zh 面板大小变化的回调
      * @en Callback when pane resized
-     * @version 2.25.0
      */
     onPaneResize?: (paneContainers: HTMLElement[]) => void;
 }
 /**
- * @title ResizeBox.SplitGroup in `2.27.0`
+ * @title ResizeBox.SplitGroup
  */
 export interface SplitGroupProps {
     style?: CSSProperties;

package/types/pc/segmented/index.d.ts

@@ -0,0 +1,8 @@
+import type { SegmentedProps } from './interface';
+/**
+ * Segmented 分段控制器组件
+ *
+ * 支持多种样式变体、方向、尺寸和交互模式
+ */
+declare const Segmented: import("react").ForwardRefExoticComponent<SegmentedProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Segmented;

package/types/pc/segmented/interface.d.ts

@@ -0,0 +1,88 @@
+import { CSSProperties, ReactNode } from 'react';
+/**
+ * 分段控制器选项类型
+ */
+export interface SegmentedOption {
+    /** 选项值 */
+    value: string;
+    /** 显示文本，不设置则只显示图标 */
+    label?: ReactNode;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 图标元素 */
+    icon?: ReactNode;
+    /** 自定义渲染函数 */
+    render?: (option: SegmentedOption, isActive: boolean) => ReactNode;
+}
+/**
+ * @title Segmented 分段控制器
+ */
+export interface SegmentedProps {
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 自定义类名 */
+    className?: string | string[];
+    /**
+     * 分段控制器选项
+     * @description 可以是字符串数组或 SegmentedOption 对象数组
+     */
+    options: (SegmentedOption | string)[];
+    /**
+     * 默认选中的值
+     * @description 非受控模式下使用
+     */
+    defaultValue?: string;
+    /**
+     * 当前选中的值
+     * @description 受控模式下使用
+     */
+    value?: string;
+    /**
+     * 变化时的回调函数
+     * @param value - 当前选中的值
+     */
+    onChange?: (value: string) => void;
+    /**
+     * 尺寸
+     * @defaultValue 'medium'
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * 样式类型
+     * @defaultValue 'default'
+     * @enumDescription
+     *   - default: 默认样式
+     *   - pill: 胶囊样式 (圆形)
+     */
+    mode?: 'default' | 'pill';
+    /**
+     * 是否禁用整个组件
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否撑满容器宽度
+     * @defaultValue false
+     */
+    block?: boolean;
+    /**
+     * 布局方向
+     * @defaultValue 'horizontal'
+     */
+    direction?: 'horizontal' | 'vertical';
+    /**
+     * 是否显示选中指示器
+     * @defaultValue true
+     */
+    showIndicator?: boolean;
+    /**
+     * 动画持续时间（毫秒）
+     * @defaultValue 300
+     */
+    animationDuration?: number;
+    /**
+     * 为内部的 input 元素设置相同的 name 属性
+     * @description 用于表单提交和键盘导航
+     */
+    name?: string;
+}

package/types/pc/select/interface.d.ts

@@ -42,13 +42,11 @@ export interface SelectProps extends SelectViewCommonProps {
     mode?: 'multiple' | 'tags';
     /**
      * @zh 是否开启全选选项，仅在多选模式时才生效
-     * 潘启宝添加
      */
     allowCheckAll?: boolean;
     /**
      * @zh 指定可选项
      * @en Select options
-     * @version `extra` in 2.2.0
      */
     options?: (string | number | {
         label: ReactNode | string;
@@ -84,7 +82,6 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 是否允许通过输入创建新的选项。
      * @en Whether to allow new options to be created by input.
-     * @version 2.13.0, `{ formatter }` in 2.54.0
      */
     allowCreate?: boolean | {
         formatter: (inputValue: string, creating: boolean) => SelectProps['options'][number];
@@ -98,13 +95,11 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 下拉框是否默认打开。
      * @en Whether to show dropdown by default.
-     * @version 2.14.0
      */
     defaultPopupVisible?: boolean;
     /**
      * @zh 控制下拉框是否打开。
      * @en Whether to show dropdown.
-     * @version 2.6.0
      */
     popupVisible?: boolean;
     /**
@@ -131,7 +126,6 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 自定义触发元素。
      * @en The trigger element which executes the dropdown action.
-     * @version `() => ReactNode` in 2.31.0
      */
     triggerElement?: ReactNode | ((params: {
         value: unknown;
@@ -160,7 +154,6 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 传递虚拟滚动属性。
      * @en Pass properties used by VirtualList.
-     * @version 2.1.0
      */
     virtualListProps?: AvailableVirtualListProps;
     /**
@@ -171,7 +164,6 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 选中选项时触发的回调，(只在 `multiple` 模式下触发)。
      * @en Called when an option is selected. Only called for `multiple` mode.
-     * @version 2.52.0
      */
     onSelect?: (value: string | number | LabeledValue, option: OptionInfo) => void;
     /**
@@ -212,13 +204,11 @@ export interface SelectProps extends SelectViewCommonProps {
     /**
      * @zh 输入框文本改变的回调。
      * @en Callback when the value of input is changed.
-     * @version 2.3.0
      */
     onInputValueChange?: (value: string, reason: InputValueChangeReason) => void;
     /**
      * @zh 输入框文本粘贴的回调。
      * @en Callback when the you paste text in input box.
-     * @version 2.9.0
      */
     onPaste?: (e: any) => void;
 }
@@ -246,7 +236,6 @@ export interface OptionProps extends Omit<HTMLAttributes<HTMLLIElement>, 'classN
     /**
      * @zh 携带任意自定义数据。
      * @en Any data you want to pass to Option.
-     * @version 2.2.0
      */
     extra?: unknown;
     isSelectOption?: boolean;
@@ -315,7 +304,6 @@ export type SelectHandle = {
     /**
      * @zh 将下拉列表滚动至指定选项
      * @en Scroll the drop-down list to the specified option
-     * @version 2.46.0
      */
     scrollIntoView: (value: OptionProps['value'], options?: ScrollIntoViewOptions) => void;
 };