@tendaui/react 1.1.2 → 1.1.4

package/es/tag-input/type.d.ts

@@ -1,235 +0,0 @@
-import { InputProps } from "../input";
-import { TagProps } from "../tag";
-import { TNode, TElement, SizeEnum } from "../common";
-import { MouseEvent, KeyboardEvent, ClipboardEvent, FocusEvent, FormEvent, CompositionEvent } from "react";
-export interface TdTagInputProps {
-    /**
-     * 宽度随内容自适应
-     * @default false
-     */
-    autoWidth?: boolean;
-    /**
-     * 无边框模式
-     * @default false
-     */
-    borderless?: boolean;
-    /**
-     * 是否可清空
-     * @default false
-     */
-    clearable?: boolean;
-    /**
-     * 标签过多的情况下，折叠项内容，默认为 `+N`。如果需要悬浮就显示其他内容，可以使用 collapsedItems 自定义。`value` 表示当前存在的所有标签，`collapsedSelectedItems` 表示折叠的标签，`count` 表示折叠的数量，`onClose` 表示移除标签的事件回调
-     */
-    collapsedItems?: TNode<{
-        value: TagInputValue;
-        collapsedSelectedItems: TagInputValue;
-        count: number;
-        onClose: (context: {
-            index: number;
-            e?: MouseEvent;
-        }) => void;
-    }>;
-    /**
-     * 是否禁用标签输入框
-     */
-    disabled?: boolean;
-    /**
-     * 拖拽调整标签顺序
-     * @default false
-     */
-    dragSort?: boolean;
-    /**
-     * 标签超出时的呈现方式，有两种：横向滚动显示 和 换行显示
-     * @default break-line
-     */
-    excessTagsDisplayType?: "scroll" | "break-line";
-    /**
-     * 标签最大换行数
-     * @default 1
-     */
-    maxRows?: number;
-    /**
-     * 透传 Input 输入框组件全部属性
-     */
-    inputProps?: InputProps;
-    /**
-     * 输入框的值
-     * @default ''
-     */
-    inputValue?: string;
-    /**
-     * 输入框的值，非受控属性
-     * @default ''
-     */
-    defaultInputValue?: string;
-    /**
-     * 左侧文本
-     */
-    label?: TNode;
-    /**
-     * 最大允许输入的标签数量
-     */
-    max?: number;
-    /**
-     * 最小折叠数量，用于标签数量过多的情况下折叠选中项，超出该数值的选中项折叠。值为 0 则表示不折叠
-     * @default 0
-     */
-    minCollapsedNum?: number;
-    /**
-     * 占位符
-     */
-    placeholder?: string;
-    /**
-     * 组件前置图标
-     */
-    prefixIcon?: TElement;
-    /**
-     * 只读状态，值为真会隐藏标签移除按钮和输入框
-     * @default false
-     */
-    readonly?: boolean;
-    /**
-     * 组件尺寸
-     * @default medium
-     */
-    size?: SizeEnum;
-    /**
-     * 输入框状态
-     */
-    status?: "default" | "success" | "warning" | "error";
-    /**
-     * 后置图标前的后置内容
-     */
-    suffix?: TNode;
-    /**
-     * 组件后置图标
-     */
-    suffixIcon?: TElement;
-    /**
-     * 自定义标签的内部内容，每一个标签的当前值。注意和 `valueDisplay` 区分，`valueDisplay`  是用来定义全部标签内容，而非某一个标签
-     */
-    tag?: string | TNode<{
-        value: string | number;
-    }>;
-    /**
-     * 透传 Tag 组件全部属性
-     */
-    tagProps?: TagProps;
-    /**
-     * 输入框下方提示文本，会根据不同的 `status` 呈现不同的样式
-     */
-    tips?: TNode;
-    /**
-     * 值
-     * @default []
-     */
-    value?: TagInputValue;
-    /**
-     * 值，非受控属性
-     * @default []
-     */
-    defaultValue?: TagInputValue;
-    /**
-     * 自定义值呈现的全部内容，参数为所有标签的值
-     */
-    valueDisplay?: string | TNode<{
-        value: TagInputValue;
-        onClose: (index: number, item?: string | number) => void;
-    }>;
-    /**
-     * 失去焦点时触发
-     */
-    onBlur?: (value: TagInputValue, context: {
-        inputValue: string;
-        e: FocusEvent<HTMLInputElement>;
-    }) => void;
-    /**
-     * 值变化时触发，参数 `context.trigger` 表示数据变化的触发来源；`context.index` 指当前变化项的下标；`context.item` 指当前变化项；`context.e` 表示事件参数
-     */
-    onChange?: (value: TagInputValue, context: TagInputChangeContext) => void;
-    /**
-     * 清空按钮点击时触发
-     */
-    onClear?: (context: {
-        e: MouseEvent<SVGSVGElement>;
-    }) => void;
-    /**
-     * 点击组件时触发
-     */
-    onClick?: (context: {
-        e: MouseEvent<HTMLDivElement>;
-    }) => void;
-    /**
-     * 【开发中】拖拽排序时触发
-     */
-    onDragSort?: (context: TagInputDragSortContext) => void;
-    /**
-     * 按键按下 Enter 时触发
-     */
-    onEnter?: (value: TagInputValue, context: {
-        e: KeyboardEvent<HTMLDivElement>;
-        inputValue: string;
-    }) => void;
-    /**
-     * 聚焦时触发
-     */
-    onFocus?: (value: TagInputValue, context: {
-        inputValue: string;
-        e: FocusEvent<HTMLInputElement>;
-    }) => void;
-    /**
-     * 输入框值发生变化时触发，`context.trigger` 表示触发输入框值变化的来源：文本输入触发、清除按钮触发、回车键触发等
-     */
-    onInputChange?: (value: string, context?: InputValueChangeContext) => void;
-    /**
-     * 进入输入框时触发
-     */
-    onMouseenter?: (context: {
-        e: MouseEvent<HTMLDivElement>;
-    }) => void;
-    /**
-     * 离开输入框时触发
-     */
-    onMouseleave?: (context: {
-        e: MouseEvent<HTMLDivElement>;
-    }) => void;
-    /**
-     * 粘贴事件，`pasteValue` 表示粘贴板的内容
-     */
-    onPaste?: (context: {
-        e: ClipboardEvent<HTMLDivElement>;
-        pasteValue: string;
-    }) => void;
-    /**
-     * 移除单个标签时触发
-     */
-    onRemove?: (context: TagInputRemoveContext) => void;
-}
-export type TagInputValue = Array<string | number>;
-export interface TagInputChangeContext {
-    trigger: TagInputTriggerSource;
-    index?: number;
-    item?: string | number;
-    e?: MouseEvent<SVGSVGElement> | KeyboardEvent<HTMLInputElement>;
-}
-export type TagInputTriggerSource = "enter" | "tag-remove" | "backspace" | "clear";
-export interface TagInputDragSortContext {
-    newTags: TagInputValue;
-    currentIndex: number;
-    current: string | number;
-    targetIndex: number;
-    target: string | number;
-}
-export interface InputValueChangeContext {
-    e?: FormEvent<HTMLInputElement> | MouseEvent<HTMLElement | SVGElement> | CompositionEvent<HTMLDivElement> | KeyboardEvent<HTMLInputElement>;
-    trigger: "input" | "clear" | "enter" | "blur";
-}
-export interface TagInputRemoveContext {
-    value: TagInputValue;
-    index: number;
-    item: string | number;
-    e?: MouseEvent<SVGSVGElement> | KeyboardEvent<HTMLInputElement>;
-    trigger: TagInputRemoveTrigger;
-}
-export type TagInputRemoveTrigger = "tag-remove" | "backspace";

package/es/tag-input/useTagList.d.ts

@@ -1,30 +0,0 @@
-import React, { MouseEvent, KeyboardEvent, ReactNode } from "react";
-import { TagInputChangeContext, TagInputValue, TdTagInputProps } from "./type";
-import { InputValue } from "../input";
-import { DragSortInnerProps } from "../hooks/useDragSorter";
-export type ChangeParams = [TagInputChangeContext];
-interface TagInputProps extends TdTagInputProps, DragSortInnerProps {
-    options?: unknown[];
-}
-export default function useTagList(props: TagInputProps): {
-    tagValue: TagInputValue;
-    clearAll: (context: {
-        e: MouseEvent<SVGSVGElement>;
-    }) => void;
-    onClose: (p: {
-        e?: MouseEvent<SVGSVGElement>;
-        index: number;
-    }) => void;
-    onInnerEnter: (value: InputValue, context: {
-        e: KeyboardEvent<HTMLInputElement>;
-    }) => void;
-    onInputBackspaceKeyDown: (value: InputValue, context: {
-        e: KeyboardEvent<HTMLInputElement>;
-    }) => void;
-    onInputBackspaceKeyUp: () => void;
-    renderLabel: ({ displayNode, label }: {
-        displayNode: ReactNode;
-        label: ReactNode;
-    }) => React.JSX.Element[];
-};
-export {};

package/es/utils/composeRefs.d.ts

@@ -1,2 +0,0 @@
-import { Ref } from "react";
-export default function composeRefs<T>(...refs: Ref<T>[]): (instance: T) => void;

package/es/utils/dom.d.ts

@@ -1,7 +0,0 @@
-export declare const canUseDocument: boolean;
-export declare const getWindowSize: () => {
-    width: number;
-    height: number;
-};
-export declare const getAttach: (node: string | HTMLElement | (() => string | HTMLElement) | null | undefined) => HTMLElement | null;
-export declare const isWindow: (obj: unknown) => obj is Window;

package/es/utils/forwardRefWithStatics.d.ts

@@ -1,2 +0,0 @@
-import React, { RefAttributes } from "react";
-export default function forwardRefWithStatics<P, T = HTMLElement, S = Record<string, unknown>>(component: React.ForwardRefRenderFunction<T, P>, statics?: S): React.FunctionComponent<P & RefAttributes<T>> & S;

package/es/utils/getScrollbarWidth.d.ts

@@ -1,6 +0,0 @@
-/**
- * @description: Calculate scroll bar width
- * @param container  Container used to calculate scrollbar width
- * @default container: document.body
- */
-export declare function getScrollbarWidth(container?: HTMLElement): number;

package/es/utils/helper.d.ts

@@ -1,46 +0,0 @@
-export declare function omit(obj: object, fields: string[]): object;
-export declare function removeEmptyAttrs<T>(obj: T): Partial<T>;
-export declare function getTabElementByValue(tabs: Array<{
-    id: string;
-    [key: string]: unknown;
-}>, value: string): {
-    id: string;
-    [key: string]: unknown;
-} | null;
-export declare function firstUpperCase(str: string): string;
-export type Gradients = {
-    [percent: string]: string;
-};
-export type FromTo = {
-    from: string;
-    to: string;
-};
-export type LinearGradient = {
-    direction?: string;
-} & (Gradients | FromTo);
-export declare function getBackgroundColor(color: string | string[] | LinearGradient): string;
-export declare function getPropsApiByEvent(eventName: string): string;
-/**
- * 兼容样式中支持 number/string 类型的传值 得出最后的结果。
- * @param param number 或 string 类型的可用于样式上的值
- * @returns 可使用的样式值。
- */
-export declare function pxCompat(param: string | number): string;
-/**
- * 获取元素相对于容器(祖先)的偏移量
- * @param element 目标元素
- * @param container 容器元素
- * @returns 相对于容器的偏移量
- */
-export declare function getOffsetTopToContainer(element: HTMLElement, container: HTMLElement): number;
-export declare function getIEVersion(): number;
-/**
- * 计算字符串字符的长度并可以截取字符串。
- * @param str 传入字符串
- * @param maxCharacter 规定最大字符串长度
- * @returns 当没有传入maxCharacter时返回字符串字符长度，当传入maxCharacter时返回截取之后的字符串和长度。
- */
-export declare function getCharacterLength(str: string, maxCharacter?: number): number | {
-    length: number;
-    characters: string;
-};

package/es/utils/input-number/large-number.d.ts

@@ -1,85 +0,0 @@
-export type InputNumberDecimalPlaces = number | {
-    enableRound: boolean;
-    places: number;
-};
-export declare function fillZero(length: number): string;
-/**
- * 大数，是否是一个数字，数字字符包括 - . e [0-9]
- */
-export declare function isInputNumber(num: number | string): boolean;
-export declare function removeInvalidZero(num: string, decimal?: boolean): string;
-/**
- * 大数加法，仅支持正整数（没有精度问题）
- * @param num1 被加数
- * @param num2 加数
- */
-export declare function largeIntNumberAdd(num1: string, num2: string, decimal?: boolean): string;
-/**
- * 大数加法，支持小数和整数（没有精度问题）
- * @param num1 被加数
- * @param num2 加数
- */
-export declare function largePositiveNumberAdd(num1: string, num2: string): string;
-/**
- * 2e3 => 2000
- * 0.2e3 => 200
- */
-export declare function formatENumber(num: string): string;
-/**
- * 比较两个大数的大小
- */
-export declare function compareLargeNumber(num1: string, num2: string): 1 | -1 | 0;
-export declare function isInfinity(num: number | string): boolean;
-export declare function isSafeNumber(num: string | number): boolean;
-/**
- * 比较两个数的大小
- */
-export declare function compareNumber(num1: string | number, num2: string | number, largeNumber?: boolean): 0 | 1 | -1;
-/**
- * 大数减法，仅支持整数
- * @param num1 被减数
- * @param num2 减数
- * @param decimal 是否为小数位相减
- */
-export declare function largeIntegerNumberSubtract(num1: string, num2: string, p?: {
-    decimal?: boolean;
-    stayZero?: boolean;
-}): string;
-/**
- * 大数减法，支持整数和小数（无精度问题）
- * @param num1 被减数
- * @param num2 减数
- * @param decimal 是否为小数位相减
- */
-export declare function largePositiveNumberSubtract(num1: string, num2: string): string;
-/**
- * -0.6 - 0.8        =>  -(0.6 + 0.8)
- * -0.6 - (-0.8)     =>  0.8 - 0.6
- * 0.6 - (-0.8)      => 0.6 + 0.8
- * 0.6 - 0.8         => 0.6 - 0.8
- */
-export declare function largeNumberSubtract(num1: string, num2: string): string;
-/**
- * -0.6 + 0.8        =>  0.8 - 0.6
- * -0.6 + (-0.8)     =>  -(0.6 + 0.8)
- * 0.6 + (-0.8)      => 0.6 - 0.8
- * 0.6 + 0.8         => 0.6 + 0.8
- */
-export declare function largeNumberAdd(num1: string, num2: string): string;
-/**
- * 格式化小数，并且可以控制小数点后的位数和是否进行四舍五入。
- *
- * @param {number} num - 要格式化的数字。
- * @param {number} places - 小数点后的位数。
- * @param {boolean} rounding - 是否进行四舍五入。
- * @returns {string} 格式化后的数字字符串。
- */
-export declare function formatDecimal(num: number, places: number, enableRound?: boolean): string;
-export declare function decimalPlacesToFixedNum(num: number, decimalPlaces: InputNumberDecimalPlaces): string;
-/**
- * 大数保留 N 位小数（没有精度问题）
- * @param {String} number 大数（只能使用字符串表示）
- * @param {Number} decimalPlaces 保留的小数位数
- * @param {Boolean} largeNumber 是否为大数
- */
-export declare function largeNumberToFixed(number: string | number, decimalPlaces?: InputNumberDecimalPlaces, largeNumber?: boolean): string;

package/es/utils/input-number/number.d.ts

@@ -1,81 +0,0 @@
-import type { InputNumberDecimalPlaces } from "./large-number";
-export * from "./large-number";
-export type NumberType = number | string;
-export declare function canAddNumber(num: NumberType, max: NumberType, largeNumber?: boolean): boolean;
-export declare function canReduceNumber(num: NumberType, min: NumberType, largeNumber?: boolean): boolean;
-/**
- * 将数字控制在 max 和 min 之间
- */
-export declare function putInRangeNumber(val: NumberType, params: {
-    max?: NumberType;
-    min?: NumberType;
-    lastValue?: NumberType;
-    largeNumber?: boolean;
-}): NumberType;
-/**
- * 仅支持正数，小数加法精度处理，小数部分和整数部分分开处理
- */
-export declare function positiveAdd(num1: number, num2: number): number;
-/**
- * 正数，小数减法精度处理，小数部分和整数部分分开处理
- */
-export declare function positiveSubtract(num1: number, num2: number): number;
-/**
- * 支持正数、负数、小数等全部数字的加法
- * -0.766 + 1       =>   1 - 0.766
- * -1 + (-0.766)    =>   - (1 + 0.766)
- * 1 + (-0.766)     =>   1 - 0.766
- * 1 + 0.766        =>   1 + 0.766
- */
-export declare function add(num1: number, num2: number): number;
-/**
- * 支持正数、负数、小数等全部数字的减法
- * -0.766 - 1       =>   - (1 + 0.766)
- * -1 - (-0.766)    =>   0.766 - 1
- * 1 - (-0.766)     =>   1 + 0.766
- * 1 - 0.766        =>   1 - 0.766
- */
-export declare function subtract(num1: number, num2: number): number;
-export declare function getStepValue(p: {
-    op: "add" | "reduce";
-    step: NumberType;
-    max?: NumberType;
-    min?: NumberType;
-    lastValue?: NumberType;
-    largeNumber?: boolean;
-}): any;
-export type InputNumberErrorType = "exceed-maximum" | "below-minimum" | undefined;
-/**
- * 最大值和最小值校验
- */
-export declare function getMaxOrMinValidateResult(p: {
-    largeNumber: boolean;
-    value: NumberType;
-    max: NumberType;
-    min: NumberType;
-}): InputNumberErrorType;
-export declare const specialCode: string[];
-/**
- * 是否允许输入当前字符，输入字符校验
- * 1.23E+08 就表示 1.23 乘 10 的 8 次方
- * 2e3 表示 2 乘 10 的 3 次方
- */
-export declare function canInputNumber(number: string | undefined | null, largeNumber?: boolean): boolean;
-/**
- * 是否允许设置组件新值，触发 onChange 事件
- */
-export declare function canSetValue(number: string, lastNumber: number): boolean;
-/**
- * 1. 格式化未输入完成的数字，如：如：2e/2+/2.等
- * 2. 处理小数点 decimalPlaces
- * 3. 格式化大数字 formatENumber
- */
-export declare function formatUnCompleteNumber(number: string, extra?: {
-    decimalPlaces?: InputNumberDecimalPlaces;
-    largeNumber?: boolean;
-    isToFixed?: boolean;
-}): number | string;
-/**
- * 对千分位进行处理 111,111,222 -> 111111222
- */
-export declare function formatThousandths(number: string): string;

package/es/utils/isFragment.d.ts

@@ -1,4 +0,0 @@
-/**
- * Compatible with React 18 or 19 to check if node is a Fragment.
- */
-export default function isFragment(object: React.ReactElement | null | undefined): boolean;

package/es/utils/listener.d.ts

@@ -1,4 +0,0 @@
-type EventHandler = (element: Node, event: string, handler: EventListenerOrEventListenerObject) => void;
-export declare const on: EventHandler;
-export declare const off: EventHandler;
-export {};

package/es/utils/log/index.d.ts

@@ -1,2 +0,0 @@
-import log from './log';
-export default log;

package/es/utils/log/log.d.ts

@@ -1,3 +0,0 @@
-import { Log } from './types';
-declare const log: Log;
-export default log;

package/es/utils/log/types.d.ts

@@ -1,8 +0,0 @@
-export type LogFunction = (componentName: string, message: string) => void;
-export interface Log {
-    warn: LogFunction;
-    warnOnce: LogFunction;
-    error: LogFunction;
-    errorOnce: LogFunction;
-    info: LogFunction;
-}

package/es/utils/noop.d.ts

@@ -1,2 +0,0 @@
-declare const noop: () => void;
-export default noop;

package/es/utils/number.d.ts

@@ -1,7 +0,0 @@
-export declare const numberToPercent: (number: number) => string;
-/**
- * 精确加法函数，避免 JavaScript 浮点误差
- * - 浮点运算会导致类似 0.1 + 0.2 = 0.30000000000000004 的问题
- * - 该函数通过将数字放大为整数进行运算，再缩小回原精度，得到更精确的结果
- */
-export declare function accAdd(num1: number, num2: number): number;

package/es/utils/parentTNode.d.ts

@@ -1,10 +0,0 @@
-import React, { ReactNode } from "react";
-import { TNode } from "../common";
-export default function parseTNode<T = unknown>(renderNode: TNode | TNode<T> | undefined, renderParams?: T, defaultNode?: ReactNode): ReactNode;
-/**
- * 解析各种数据类型的 TNode
- * 函数类型：content={(props) => <Icon></Icon>}
- * 组件类型：content={<Button>click me</Button>} 这种方式可以避免函数重复渲染，对应的 props 已经注入
- * 字符类型
- */
-export declare function parseContentTNode<T>(tnode: TNode<T>, props: T): React.ReactNode;

package/es/utils/parseTNode.d.ts

@@ -1,10 +0,0 @@
-import React, { ReactNode } from "react";
-import { TNode } from "../common";
-export default function parseTNode<T = Record<string, unknown>>(renderNode: TNode<T> | undefined, renderParams?: T, defaultNode?: ReactNode): ReactNode;
-/**
- * 解析各种数据类型的 TNode
- * 函数类型：content={(props) => <Icon></Icon>}
- * 组件类型：content={<Button>click me</Button>} 这种方式可以避免函数重复渲染，对应的 props 已经注入
- * 字符类型
- */
-export declare function parseContentTNode<T>(tnode: TNode<T>, props: T): React.ReactNode;

package/es/utils/react-render.d.ts

@@ -1,16 +0,0 @@
-import type * as React from "react";
-import type { Root } from "react-dom/client";
-type CreateRoot = (container: ContainerType) => Root;
-declare const MARK = "__td_react_root__";
-type ContainerType = (Element | DocumentFragment) & {
-    [MARK]?: Root;
-};
-export declare function render(node: React.ReactElement, container: ContainerType): void;
-export declare function unmount(container: ContainerType): Promise<void>;
-/**
- * @deprecated Set React render function for compatible usage.
- * This is internal usage only compatible with React 19.
- * And will be removed in next major version.
- */
-export declare function renderAdapter(render?: CreateRoot): void;
-export {};

package/es/utils/ref.d.ts

@@ -1 +0,0 @@
-export declare function getRefDom<T = HTMLElement>(domRef: React.RefObject<T>): unknown;

package/es/utils/refs.d.ts

@@ -1,13 +0,0 @@
-export declare const supportRef: (nodeOrComponent: unknown) => boolean;
-export declare function getRefDom<T = HTMLElement>(domRef: React.RefObject<T>): HTMLElement | T;
-interface RefAttributes<T> extends React.Attributes {
-    ref: React.Ref<T>;
-}
-export declare const supportNodeRef: <T = HTMLElement>(node: React.ReactNode) => node is React.ReactElement & RefAttributes<T>;
-/**
- * In React 19. `ref` is not a property from node.
- * But a property from `props.ref`.
- * To check if `props.ref` exist or fallback to `ref`.
- */
-export declare const getNodeRef: <T = HTMLElement>(node: React.ReactNode) => React.Ref<T> | null;
-export {};

package/es/utils/scroll.d.ts

@@ -1,3 +0,0 @@
-export declare function hasBodyScrollbar(): boolean;
-export declare function getScrollbarWidthWithCSS(): number;
-export declare function getScrollbarWidth(container?: HTMLElement): number;

package/es/utils/style.d.ts

@@ -1,4 +0,0 @@
-export declare const getCssVarsValue: (name: string, element?: HTMLElement) => string;
-export declare function hasClass(el: Element, cls: string): boolean;
-export declare const addClass: (el: Element, cls: string) => void;
-export declare const removeClass: (el: Element, cls: string) => void;

package/es/utils/transition.d.ts

@@ -1,20 +0,0 @@
-export interface IAnimationTransitionParams {
-    classPrefix: string;
-    expandAnimation?: boolean;
-    fadeAnimation?: boolean;
-}
-export declare const getTransitionParams: ({ classPrefix, expandAnimation, fadeAnimation }: IAnimationTransitionParams) => {
-    classNames?: undefined;
-} | {
-    classNames: {
-        appear: string;
-        appearActive: string;
-        appearDone: string;
-        enter: string;
-        enterActive: string;
-        enterDone: string;
-        exit: string;
-        exitActive: string;
-        exitDone: string;
-    };
-};