@unicom-cloud/ui 0.8.101 → 0.8.103

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

@@ -0,0 +1,113 @@
+import type { CSSProperties } from 'react';
+/**
+ * 颜色配置类型，支持纯色和渐变色
+ */
+export 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;
+}

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

@@ -1,61 +1,4 @@
-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>;
+import React from 'react';
+import type { MarqueeProps } from './interface';
+declare const Marquee: React.ForwardRefExoticComponent<MarqueeProps & React.RefAttributes<HTMLDivElement>>;
 export default Marquee;

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

@@ -0,0 +1,95 @@
+import { CSSProperties, ReactNode, type AnimationEventHandler } from 'react';
+/**
+ * @title Marquee
+ */
+export interface MarqueeProps {
+    style?: CSSProperties;
+    className?: string | string[];
+    /**
+     * @zh 是否自动用子元素的副本填充空白空间
+     * @en Whether to automatically fill blank space with copies of child elements
+     * @defaultValue false
+     */
+    autoFill?: boolean;
+    /**
+     * @zh 是否播放跑马灯
+     * @en Whether to play the marquee
+     * @defaultValue true
+     */
+    play?: boolean;
+    /**
+     * @zh 悬停时是否暂停
+     * @en Whether to pause on hover
+     * @defaultValue false
+     */
+    pauseOnHover?: boolean;
+    /**
+     * @zh 点击时是否暂停
+     * @en Whether to pause on click
+     * @defaultValue false
+     */
+    pauseOnClick?: boolean;
+    /**
+     * @zh 跑马灯滑动方向
+     * @en Marquee scroll direction
+     * @defaultValue left
+     */
+    direction?: 'left' | 'right' | 'up' | 'down';
+    /**
+     * @zh 速度(像素/秒)
+     * @en Scroll speed (pixels/second)
+     * @defaultValue 50
+     */
+    speed?: number;
+    /**
+     * @zh 动画延迟时间(秒)
+     * @en Animation delay time (seconds)
+     * @defaultValue 0
+     */
+    delay?: number;
+    /**
+     * @zh 循环次数，0表示无限循环
+     * @en Number of loops, 0 means infinite loop
+     * @defaultValue 0
+     */
+    loop?: number;
+    /**
+     * @zh 渐变遮罩配置，false表示不显示
+     * @en Gradient overlay configuration, false means not shown
+     * @defaultValue false
+     */
+    gradient?: false | {
+        /**
+         * @zh 渐变颜色
+         * @en Gradient color
+         * @defaultValue white
+         */
+        color?: string;
+        /**
+         * @zh 渐变尺寸
+         * @en Gradient size
+         * @defaultValue 50
+         */
+        size?: number | string;
+    };
+    /**
+     * @zh 子元素
+     * @en Children elements
+     */
+    children?: ReactNode;
+    /**
+     * @zh 动画完成时的回调(仅在loop不为0时调用)
+     * @en Callback when animation completes (only called when loop is not 0)
+     */
+    onFinish?: AnimationEventHandler<HTMLDivElement>;
+    /**
+     * @zh 每次循环完成时的回调
+     * @en Callback when each cycle completes
+     */
+    onCycleComplete?: AnimationEventHandler<HTMLDivElement>;
+    /**
+     * @zh 组件挂载后的回调
+     * @en Callback after component mounts
+     */
+    onMount?: () => void;
+}

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { MarqueeProps } from './interface';
+/**
+ * 跑马灯组件
+ * 实现所有方向完美无缝循环运动
+ */
+declare const Marquee: React.FC<MarqueeProps>;
+export default Marquee;

package/types/pc/marquee-/interface.d.ts

@@ -0,0 +1,56 @@
+import { ReactNode, type CSSProperties } from 'react';
+/**
+ * @title MarqueeProps
+ */
+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;
+    /**
+     * 是否显示边缘渐变遮罩，设置为 false 将隐藏
+     * @default { size: 50; color: 0xffffff }
+     */
+    gradient?: {
+        size: number;
+        color: string;
+    } | boolean;
+    /**
+     * 循环次数（0表示无限循环）
+     * @default 0
+     * @example
+     * <Marquee loop={3}>循环3次</Marquee>
+     */
+    loop?: number;
+    /**
+     * 循环完成回调（仅在loop>0时触发）
+     */
+    onComplete?: () => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+}

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

@@ -1,34 +1,4 @@
 import React from 'react';
-export interface QRCodeProps {
-    /** 二维码内容 (必填) */
-    value: string;
-    /** 渲染模式 */
-    renderAs?: 'svg' | 'canvas';
-    /** 二维码尺寸（像素） */
-    size?: number;
-    /** 是否显示边框 */
-    bordered?: boolean;
-    /** 容错级别 */
-    errorLevel?: 'L' | 'M' | 'Q' | 'H';
-    /** 前景色（二维码点颜色） */
-    fgColor?: string;
-    /** 背景色 */
-    bgColor?: string;
-    /** 边距大小（像素） */
-    marginSize?: number;
-    /** 中心图标设置 */
-    imageSettings?: {
-        src: string;
-        height: number;
-        width: number;
-        excavate: boolean;
-        x?: number;
-        y?: number;
-    };
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: React.CSSProperties;
-}
+import type { QRCodeProps } from './interface';
 declare const QRCode: React.FC<QRCodeProps>;
 export default QRCode;

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

@@ -1,39 +1,32 @@
+import type React from 'react';
 export interface QRCodeProps {
-    /**
-     * 二维码内容
-     */
-    value?: string;
-    /**
-     * 二维码尺寸（像素）
-     * @default 160
-     */
+    /** 二维码内容 (必填) */
+    value: string;
+    /** 渲染模式 */
+    renderAs?: 'svg' | 'canvas';
+    /** 二维码尺寸（像素） */
     size?: number;
-    /**
-     * 二维码颜色
-     * @default '#000000'
-     */
-    color?: string;
-    /**
-     * 二维码背景色
-     * @default '#ffffff'
-     */
-    bgColor?: string;
-    /**
-     * 是否有边框
-     * @default true
-     */
+    /** 是否显示边框 */
     bordered?: boolean;
-    /**
-     * 容错级别
-     * @default 'M'
-     */
+    /** 容错级别 */
     errorLevel?: 'L' | 'M' | 'Q' | 'H';
-    /**
-     * 自定义样式
-     */
-    style?: React.CSSProperties;
-    /**
-     * 自定义类名
-     */
+    /** 前景色（二维码点颜色） */
+    fgColor?: string;
+    /** 背景色 */
+    bgColor?: string;
+    /** 边距大小（像素） */
+    marginSize?: number;
+    /** 中心图标设置 */
+    imageSettings?: {
+        src: string;
+        height: number;
+        width: number;
+        excavate: boolean;
+        x?: number;
+        y?: number;
+    };
+    /** 自定义类名 */
     className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
 }

package/types/pc/splitter/SplitBar.d.ts

@@ -3,7 +3,6 @@ export interface SplitBarProps {
     index: number;
     active: boolean;
     prefixCls?: string;
-    resizable: boolean;
     startCollapsible: boolean;
     endCollapsible: boolean;
     onOffsetStart: (index: number) => void;

package/types/pc/splitter/hooks/useResizable.d.ts

@@ -1,6 +1,5 @@
 import type { ItemType } from './useItems';
 export type ResizableInfo = {
-    resizable: boolean;
     startCollapsible: boolean;
     endCollapsible: boolean;
 };

package/types/pc/splitter/hooks/useResize.d.ts

@@ -1,4 +1,3 @@
 import type { ItemType } from './useItems';
-import type { ResizableInfo } from './useResizable';
-declare function useResize(items: ItemType[], resizableInfos: ResizableInfo[], percentSizes: number[], containerSize: number | undefined, updateSizes: (sizes: number[]) => void, isRTL: boolean | undefined): readonly [(index: number) => void, (index: number, offset: number) => number[], () => void, (index: number, type: "start" | "end") => number[], number | undefined];
+declare function useResize(items: ItemType[], percentSizes: number[], containerSize: number | undefined, updateSizes: (sizes: number[]) => void, isRTL: boolean | undefined): readonly [(index: number) => void, (index: number, offset: number) => number[], () => void, (index: number, type: "start" | "end") => number[], number | undefined];
 export default useResize;

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

@@ -92,12 +92,6 @@ export interface PanelProps {
         /** @zh 结束边是否可折叠 */
         end?: boolean;
     };
-    /**
-     * @zh 是否可调整大小
-     * @defaultValue true
-     * @en Whether resizable
-     */
-    resizable?: boolean;
     /**
      * @zh 默认尺寸（像素或百分比字符串）
      * @en Default size (pixels or percentage string)
@@ -192,8 +186,6 @@ export interface UseCollapsible {
  * 可调整大小信息接口
  */
 export interface ResizableInfo {
-    /** @zh 是否可调整大小 */
-    resizable: boolean;
     /** @zh 起始边是否可折叠 */
     startCollapsible: boolean;
     /** @zh 结束边是否可折叠 */

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

@@ -1,47 +1,4 @@
-import { CSSProperties } from 'react';
-type Placement = 'top' | 'bottom' | 'left' | 'right';
-type TourType = 'default' | 'primary';
-export interface TourStep {
-    /** 目标元素 (选择器字符串或DOM元素) */
-    target: string | HTMLElement;
-    /** 标题内容 */
-    title?: React.ReactNode;
-    /** 描述内容 */
-    description?: React.ReactNode;
-    /** 初始弹出位置 (会自动调整) */
-    placement?: Placement;
-}
-export interface TourProps {
-    /** 自定义样式 */
-    style?: CSSProperties;
-    /** 自定义类名 */
-    className?: string | string[];
-    /** 引导步骤数组 */
-    steps: TourStep[];
-    /** 是否显示引导 */
-    open?: boolean;
-    /** 关闭回调 */
-    onClose?: () => void;
-    /** 是否显示遮罩 */
-    mask?: boolean;
-    /** 点击遮罩是否关闭 */
-    maskClosable?: boolean;
-    /** 引导类型 (default/primary) */
-    type?: TourType;
-    /** 默认弹出位置 */
-    placement?: Placement;
-    /** 是否显示箭头 */
-    arrow?: boolean;
-    /** 是否显示关闭按钮 */
-    closable?: boolean;
-    /** 层级 */
-    zIndex?: number;
-    /** 当前步骤索引 */
-    current?: number;
-    /** 完成回调 */
-    onFinish?: () => void;
-    /** 步骤改变回调 */
-    onStepChange?: (current: number) => void;
-}
+import React from 'react';
+import type { TourProps } from './interface';
 declare function Tour(baseProps: TourProps): React.ReactElement | null;
 export default Tour;

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

@@ -0,0 +1,46 @@
+import type React from 'react';
+import type { CSSProperties } from 'react';
+export type Placement = 'top' | 'bottom' | 'left' | 'right';
+export type TourType = 'default' | 'primary';
+export interface TourStep {
+    /** 目标元素 (选择器字符串或DOM元素) */
+    target: string | HTMLElement;
+    /** 标题内容 */
+    title?: React.ReactNode;
+    /** 描述内容 */
+    description?: React.ReactNode;
+    /** 初始弹出位置 (会自动调整) */
+    placement?: Placement;
+}
+export interface TourProps {
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 自定义类名 */
+    className?: string | string[];
+    /** 引导步骤数组 */
+    steps: TourStep[];
+    /** 是否显示引导 */
+    open?: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 是否显示遮罩 */
+    mask?: boolean;
+    /** 点击遮罩是否关闭 */
+    maskClosable?: boolean;
+    /** 引导类型 (default/primary) */
+    type?: TourType;
+    /** 默认弹出位置 */
+    placement?: Placement;
+    /** 是否显示箭头 */
+    arrow?: boolean;
+    /** 是否显示关闭按钮 */
+    closable?: boolean;
+    /** 层级 */
+    zIndex?: number;
+    /** 当前步骤索引 */
+    current?: number;
+    /** 完成回调 */
+    onFinish?: () => void;
+    /** 步骤改变回调 */
+    onStepChange?: (current: number) => void;
+}

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

@@ -256,6 +256,7 @@ export interface UploadListProps {
     renderUploadItem?: (originNode: ReactNode, file: UploadItem, fileList: UploadItem[]) => ReactNode;
     renderUploadList?: (fileList: UploadItem[], uploadListProps: Omit<UploadListProps, 'renderUploadList'>) => ReactNode;
     prefixCls?: string;
+    onChange?: (o: object) => void;
 }
 /**
  * @title UploadItem

package/types/pc/utils/constant.d.ts

@@ -1,4 +1,3 @@
-export { UI_PC_KEY, UI_PC_THEME_DARK_CLASS_NAME, } from '@unicom-cloud/utils/constant/ui';
-export { NOOP } from '../../common/utils/constant';
+export { NOOP, UI_PC_KEY, UI_PC_THEME_DARK_CLASS_NAME, } from '../../common/utils/constant';
 export declare function newArray(length: number): any[];
 export declare function pickTriggerPropsFromRest(rest: object): Pick<object, never>;

package/types/pc/utils/dayjs.d.ts

@@ -1 +1,2 @@
-export { dayjs, getDayjsValue, getNow, getSortedDayjsArray, getTimeFormat, getValueWithTime, isDayjsArrayChange, isDayjsChange, isValidTimeString, methods, timezoneToOffset, toLocal, toTimezone, } from '../../common/utils/dayjs';
+export * from '../../common/utils/dayjs';
+export { default } from '../../common/utils/dayjs';

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

@@ -1,10 +1,8 @@
+export * from '@unicom-cloud/utils/date';
 export * from './caseName';
 export * from './className';
-export * from './color';
-export * from './computeScrollIntoView';
 export * from './constant';
 export * from './contextHolder';
-export * from './convertToDurationBasedOnTimeUnits';
 export * from './copy';
 export * from './dayjs';
 export * from './dom';
@@ -33,13 +31,12 @@ export * from './resizeObserver';
 export * from './responsiveObserve';
 export * from './saveAs';
 export * from './screenfull';
-export * from './scrollIntoView';
+export * from './scrollIntoViewIfNeeded';
 export * from './setDarkTheme';
 export * from './setPrimaryColor';
 export * from './setTheme';
 export * from './style';
 export * from './throttleByRaf';
-export * from './tinycolor';
 export * from './toArray';
 export * from './tree';
 export * from './tween';

package/types/pc/utils/responsiveObserve.d.ts

@@ -1,12 +1,16 @@
 export type Breakpoint = 'xxxl' | 'xxl' | 'xl' | 'lg' | 'md' | 'sm' | 'xs';
-export type BreakpointMap = Partial<Record<Breakpoint, string>>;
+export type BreakpointMap = Record<Breakpoint, string>;
 export type ScreenMap = Partial<Record<Breakpoint, boolean>>;
 export declare const responsiveArray: Breakpoint[];
 export declare const responsiveMap: BreakpointMap;
-type SubscribeFunc = (screens: ScreenMap, breakpointChecked: Breakpoint) => void;
+type SubscribeFunc = (screens: ScreenMap, breakpointChecked: Breakpoint | null) => void;
+type MatchHandler = {
+    mql: MediaQueryList;
+    listener: (this: MediaQueryList, ev: MediaQueryListEvent) => void;
+};
 declare const responsiveObserve: {
-    matchHandlers: {};
-    dispatch(pointMap: ScreenMap, breakpointChecked: Breakpoint): boolean;
+    matchHandlers: Record<string, MatchHandler>;
+    dispatch(pointMap: ScreenMap, breakpointChecked: Breakpoint | null): boolean;
     subscribe(func: SubscribeFunc): string;
     unsubscribe(token: string): void;
     unregister(): void;

package/types/pc/utils/scrollIntoViewIfNeeded.d.ts

@@ -0,0 +1,3 @@
+import scrollIntoView, { compute, scrollIntoViewIfNeeded, scrollIntoViewIfNeededSmooth, smoothScrollIntoViewIfNeeded } from '../../common/utils/scrollIntoViewIfNeeded';
+export { compute, scrollIntoView, scrollIntoViewIfNeeded, scrollIntoViewIfNeededSmooth, smoothScrollIntoViewIfNeeded, };
+export default scrollIntoView;

package/types/pc/utils/tree.d.ts

@@ -1 +1,2 @@
-export { default, findNodeBy, getChildWithParentBy, getItemBy, getItemBy2, getItemBy3, getItemByID, getLabelFromDictionaryByValue, } from '@unicom-cloud/utils/tree';
+export * from '../../common/utils/tree';
+export { default } from '../../common/utils/tree';

package/types/pc/utils/tween.d.ts

@@ -1 +1 @@
-export { default, easing, default as tween } from '@unicom-cloud/tween';
+export { default, easing, Tween } from '../../common/utils/tween';