@tendaui/react 1.1.4 → 1.1.5

package/es/form/FormContext.d.ts

@@ -0,0 +1,59 @@
+import React from "react";
+import { TdFormProps, TdFormListProps, NamePath } from "./type";
+import { FormItemInstance } from "./FormItem";
+import { InternalFormInstance } from "./hooks/interface";
+declare const FormContext: React.Context<{
+    form?: InternalFormInstance;
+    labelWidth?: TdFormProps["labelWidth"];
+    statusIcon?: TdFormProps["statusIcon"];
+    labelAlign: TdFormProps["labelAlign"];
+    layout: TdFormProps["layout"];
+    colon: TdFormProps["colon"];
+    initialData: TdFormProps["initialData"];
+    requiredMark: TdFormProps["requiredMark"];
+    requiredMarkPosition: TdFormProps["requiredMarkPosition"];
+    scrollToFirstError: TdFormProps["scrollToFirstError"];
+    showErrorMessage: TdFormProps["showErrorMessage"];
+    resetType: TdFormProps["resetType"];
+    disabled: TdFormProps["disabled"];
+    rules: TdFormProps["rules"];
+    errorMessage: TdFormProps["errorMessage"];
+    formMapRef: React.RefObject<Map<NamePath, React.RefObject<FormItemInstance>>>;
+    floatingFormDataRef: React.RefObject<Record<string, unknown>>;
+    onFormItemValueChange: (changedValue: Record<string, unknown>) => void;
+}>;
+export declare const useFormContext: () => {
+    form?: InternalFormInstance;
+    labelWidth?: TdFormProps["labelWidth"];
+    statusIcon?: TdFormProps["statusIcon"];
+    labelAlign: TdFormProps["labelAlign"];
+    layout: TdFormProps["layout"];
+    colon: TdFormProps["colon"];
+    initialData: TdFormProps["initialData"];
+    requiredMark: TdFormProps["requiredMark"];
+    requiredMarkPosition: TdFormProps["requiredMarkPosition"];
+    scrollToFirstError: TdFormProps["scrollToFirstError"];
+    showErrorMessage: TdFormProps["showErrorMessage"];
+    resetType: TdFormProps["resetType"];
+    disabled: TdFormProps["disabled"];
+    rules: TdFormProps["rules"];
+    errorMessage: TdFormProps["errorMessage"];
+    formMapRef: React.RefObject<Map<NamePath, React.RefObject<FormItemInstance>>>;
+    floatingFormDataRef: React.RefObject<Record<string, unknown>>;
+    onFormItemValueChange: (changedValue: Record<string, unknown>) => void;
+};
+export default FormContext;
+export declare const FormListContext: React.Context<{
+    name: NamePath;
+    rules: TdFormListProps["rules"];
+    formListMapRef: React.RefObject<Map<NamePath, React.RefObject<FormItemInstance>>>;
+    initialData: TdFormListProps["initialData"];
+    form?: InternalFormInstance;
+}>;
+export declare const useFormListContext: () => {
+    name: NamePath;
+    rules: TdFormListProps["rules"];
+    formListMapRef: React.RefObject<Map<NamePath, React.RefObject<FormItemInstance>>>;
+    initialData: TdFormListProps["initialData"];
+    form?: InternalFormInstance;
+};

package/es/form/FormItem.d.ts

@@ -0,0 +1,23 @@
+import React from "react";
+import { StyledProps } from "../common";
+import type { FormInstanceFunctions, NamePath, TdFormItemProps, ValueType } from "./type";
+export interface FormItemProps extends TdFormItemProps, StyledProps {
+    children?: React.ReactNode | React.ReactNode[] | ((form: FormInstanceFunctions) => React.ReactElement);
+}
+export interface FormItemInstance {
+    name?: NamePath;
+    isUpdated?: boolean;
+    value?: ValueType;
+    getValue?: (...args: unknown[]) => unknown;
+    setValue?: (...args: unknown[]) => unknown;
+    setField?: (...args: unknown[]) => unknown;
+    validate?: (...args: unknown[]) => unknown;
+    resetField?: (...args: unknown[]) => unknown;
+    setValidateMessage?: (...args: unknown[]) => unknown;
+    getValidateMessage?: (...args: unknown[]) => unknown;
+    resetValidate?: (...args: unknown[]) => unknown;
+    validateOnly?: (...args: unknown[]) => unknown;
+    isFormList?: boolean;
+}
+declare const FormItem: React.ForwardRefExoticComponent<FormItemProps & React.RefAttributes<FormItemInstance>>;
+export default FormItem;

package/es/form/FormList.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { TdFormListProps } from "./type";
+declare const FormList: React.FC<TdFormListProps>;
+export default FormList;

package/es/form/const.d.ts

@@ -0,0 +1,6 @@
+export declare const enum ValidateStatus {
+    SUCCESS = "success",
+    WARNING = "warning",
+    ERROR = "error",
+    VALIDATING = "validating"
+}

package/es/form/defaultProps.d.ts

@@ -0,0 +1,3 @@
+import { TdFormProps, TdFormItemProps } from "./type";
+export declare const formDefaultProps: TdFormProps;
+export declare const formItemDefaultProps: TdFormItemProps;

package/es/form/easing.d.ts

@@ -0,0 +1,2 @@
+export type EasingFunction = (t: number, b: number, c: number, d: number) => number;
+export declare const easeInOutCubic: EasingFunction;

package/es/form/formModel.d.ts

@@ -0,0 +1,37 @@
+import isDate from "validator/lib/isDate";
+import isEmail from "validator/lib/isEmail";
+import isURL from "validator/lib/isURL";
+import { CustomValidator, FormRule, ValueType, AllValidateResult } from "./type";
+export declare function isValueEmpty(val: ValueType): boolean;
+declare const VALIDATE_MAP: {
+    date: typeof isDate;
+    url: typeof isURL;
+    email: typeof isEmail;
+    required: (val: ValueType) => boolean;
+    whitespace: (val: ValueType) => boolean;
+    boolean: (val: ValueType) => boolean;
+    max: (val: ValueType, num: number) => boolean;
+    min: (val: ValueType, num: number) => boolean;
+    len: (val: ValueType, num: number) => boolean;
+    number: (val: ValueType) => boolean;
+    enum: (val: ValueType, strs: Array<string>) => boolean;
+    idcard: (val: ValueType) => boolean;
+    telnumber: (val: ValueType) => boolean;
+    pattern: (val: ValueType, regexp: RegExp) => boolean;
+    validator: (val: ValueType, validate: CustomValidator) => ReturnType<CustomValidator>;
+};
+export type ValidateFuncType = (typeof VALIDATE_MAP)[keyof typeof VALIDATE_MAP];
+/**
+ * 校验某一条数据的某一条规则，一种校验规则不满足则不再进行校验。
+ * @param value 值
+ * @param rule 校验规则
+ * @returns 两种校验结果，一种是内置校验规则的校验结果，二种是自定义校验规则（validator）的校验结果
+ */
+export declare function validateOneRule(value: ValueType, rule: FormRule): Promise<AllValidateResult>;
+export declare function validate(value: ValueType, rules: Array<FormRule>): Promise<AllValidateResult[]>;
+/**
+ * Replace with template.
+ * `${name} is wrong` + { name: 'password' } = password is wrong
+ */
+export declare function parseMessage(template: string, options: Record<string, string>): string;
+export {};

package/es/form/hooks/interface.d.ts

@@ -0,0 +1,16 @@
+import type { NamePath, FormInstanceFunctions } from "../type";
+export type Store = Record<string, unknown>;
+export type WatchCallBack = (values: Store, namePathList: NamePath) => void;
+export interface InternalHooks {
+    notifyWatch: (name: NamePath) => void;
+    registerWatch: (callback: WatchCallBack) => () => void;
+    getPrevStore: () => Store;
+    setPrevStore: (store: Store) => void;
+    flashQueue: () => void;
+    setForm: (form: FormInstanceFunctions) => void;
+}
+export interface InternalFormInstance extends FormInstanceFunctions {
+    _init?: boolean;
+    store?: Store;
+    getInternalHooks?: (secret: string) => InternalHooks | null;
+}

package/es/form/hooks/useForm.d.ts

@@ -0,0 +1,3 @@
+import type { InternalFormInstance } from "./interface";
+export declare const HOOK_MARK = "TD_FORM_INTERNAL_HOOKS";
+export default function useForm(form?: InternalFormInstance): InternalFormInstance[];

package/es/form/hooks/useFormItemInitialData.d.ts

@@ -0,0 +1,9 @@
+import { FormItemProps } from "../FormItem";
+export declare const ctrlKeyMap: Map<any, any>;
+export declare const initialDataMap: Map<any, any>;
+export default function useFormItemInitialData(name: FormItemProps["name"]): {
+    getDefaultInitialData: ({ children, initialData }: {
+        children: FormItemProps["children"];
+        initialData: FormItemProps["initialData"];
+    }) => any;
+};

package/es/form/hooks/useFormItemStyle.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+export default function useFormItemStyle(props: any): {
+    formItemClass: string;
+    formItemLabelClass: string;
+    contentClass: () => string;
+    labelStyle: {};
+    contentStyle: {};
+    helpNode: React.JSX.Element;
+    extraNode: React.JSX.Element;
+};

package/es/form/hooks/useInstance.d.ts

@@ -0,0 +1,16 @@
+import type { TdFormProps, FormValidateResult, FormResetParams, FormValidateMessage, NamePath } from "../type";
+import type { FormItemInstance } from "../FormItem";
+export default function useInstance(props: TdFormProps, formRef: any, formMapRef: React.MutableRefObject<Map<NamePath, React.RefObject<FormItemInstance>>>, floatingFormDataRef: React.RefObject<Record<string, unknown>>): {
+    submit: (e?: React.FormEvent<HTMLFormElement>) => void;
+    reset: (params: FormResetParams<FormData>) => void;
+    validate: (param?: Record<string, unknown>) => Promise<FormValidateResult<FormData>>;
+    validateOnly: (param?: Record<string, unknown>) => Promise<FormValidateResult<FormData>>;
+    clearValidate: (fields?: Array<keyof FormData>) => void;
+    setFields: (fields?: any[]) => void;
+    setFieldsValue: (fields?: {}) => void;
+    setValidateMessage: (message: FormValidateMessage<FormData>) => void;
+    getValidateMessage: (fields?: Array<keyof FormData>) => {};
+    getFieldValue: (name: NamePath) => unknown;
+    getFieldsValue: (nameList: string[] | boolean) => {};
+    getCurrentElement: () => any;
+};

package/es/form/hooks/useWatch.d.ts

@@ -0,0 +1,3 @@
+import type { NamePath } from "../type";
+import type { InternalFormInstance } from "./interface";
+export default function useWatch(name: NamePath, form: InternalFormInstance): any;

package/es/form/index.d.ts

@@ -0,0 +1,7 @@
+import "./style/index.js";
+export type { FormProps } from "./Form";
+export type { FormItemProps } from "./FormItem";
+export * from "./type";
+export * from "./hooks/interface";
+export declare const Form: import("react").FunctionComponent<import("./Form").FormProps & import("react").RefAttributes<import("./type").FormInstanceFunctions<import("./type").Data>>> & Record<string, unknown>;
+export default Form;

package/es/form/scroll.d.ts

@@ -0,0 +1,39 @@
+import { ScrollContainer, ScrollContainerElement } from "../common";
+import { EasingFunction } from "./easing";
+export declare function hasBodyScrollbar(): boolean;
+export declare const isNodeOverflow: (ele: Element | Element[]) => boolean;
+/**
+ * 获取滚动容器
+ * 因为 document 不存在 scroll 等属性, 因此排除 document
+ * window | HTMLElement
+ * @param {ScrollContainerElement} [container='body']
+ * @returns {ScrollContainer}
+ */
+export declare const getScrollContainer: (container?: ScrollContainer) => ScrollContainerElement;
+/**
+ * 获取滚动距离
+ *
+ * @export
+ * @param {ScrollTarget} target
+ * @param {boolean} isLeft true 为获取 scrollLeft, false 为获取 scrollTop
+ * @returns {number}
+ */
+export declare function getScroll(target: ScrollTarget, isLeft?: boolean): number;
+export type ScrollTarget = HTMLElement | Window | Document;
+interface ScrollTopOptions {
+    container?: ScrollTarget;
+    duration?: number;
+    easing?: EasingFunction;
+}
+export declare function scrollTo(target: number, opt: ScrollTopOptions): Promise<unknown>;
+/**
+ * 获取当前视图滑动的距离
+ * @returns { scrollTop: number, scrollLeft: number }
+ */
+export declare function getWindowScroll(): {
+    scrollTop: number;
+    scrollLeft: number;
+};
+export type AnchorContainer = HTMLElement | Window;
+export declare function getOffsetTop(target: HTMLElement, container: AnchorContainer): number;
+export {};

package/es/form/style/css.d.ts

@@ -0,0 +1 @@
+export {};

package/es/form/style/index.d.ts

@@ -0,0 +1 @@
+export {};