fat-design 0.0.1-beta.20250505154859

package/types/0buildTypes/form2/form-types.d.ts

@@ -0,0 +1,386 @@
+export interface ResponsiveGridProps {
+    prefix?: string;
+    className?: any;
+    device?: string;
+    rows?: number | string;
+    columns?: number | string;
+    gap?: number | number[];
+    component?: any;
+    dense?: boolean;
+    style?: any;
+}
+export interface FloatLayoutProps {
+    className?: any;
+    itemWidth: number;
+}
+type IFunc = (e: any, e2?: any) => any;
+type IReactElement = any;
+type IReactComponent = any;
+type IObject = any;
+export declare enum SizeEnum {
+    large = "large",
+    small = "small",
+    medium = "medium"
+}
+export declare enum LayoutEnum {
+    responsive = "responsive",
+    float = "float",
+    custom = "custom",
+    null = "null"
+}
+export declare enum LabelAlignEnum {
+    top = "top",
+    left = "left",
+    inset = "inset"
+}
+export declare enum LabelTextAlignEnum {
+    left = "left",
+    right = "right"
+}
+export declare enum FormItemStateEnum {
+    error = "error",
+    warning = "warning",
+    ok = "ok"
+}
+export interface ILabelValue {
+    label: string;
+    value: string;
+}
+export interface IItemState {
+    errors: IValidateStateError[];
+    display: boolean;
+    disabled: boolean;
+    isPreview: boolean;
+}
+/**
+ * 存储在Store中的
+ */
+export interface FormItemStateSaved {
+    errors?: any[];
+    required: boolean;
+    display: boolean;
+    disabled: boolean;
+    isPreview: boolean;
+    label: string;
+    xProps?: any;
+    forceUpdateTick?: number;
+}
+/**
+ * 数据计算使用的
+ */
+export interface FormItemState extends FormItemStateSaved {
+    value: any;
+    state?: string;
+    stateMessage?: string;
+}
+export interface FormItemValidateRule {
+    message?: string;
+    trigger?: string;
+    validator?: FnValidator;
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+}
+export interface CustomLayoutProps {
+    layoutComponent: any;
+}
+export interface TableLayoutCellProps {
+    rowSpan: number;
+    colSpan: number;
+    children: any;
+}
+export interface FnFormOnChangeParams {
+    values: any;
+    stateMap: any;
+    storeData: any;
+    formStore: any;
+    formActions: any;
+    defaultValues: any;
+    runtimeParams: any;
+    valuesOfOnSearch: any;
+    eventArgs?: any[];
+}
+export interface FnValidatorObjRes {
+    message: string;
+}
+export type FnGetStateBool = (values: any, storeData: any) => boolean;
+export type FnGetXProps = (values: any, storeData: any) => any;
+export type FnGetEnums = (childProps: any, params: FnFormOnChangeParams) => ILabelValue[] | Promise<ILabelValue[]>;
+export type FnValidator = (rule: FormItemValidateRule, value: any) => Promise<string | FnValidatorObjRes> | string | FnValidatorObjRes | null;
+export type FnFormOnCreated = (values: any, params: FnFormOnChangeParams) => any;
+export type FnFormOnChange = (values: any, params: FnFormOnChangeParams) => any;
+export type FnFormItemOnChange = (value: any, params: FnFormOnChangeParams) => any;
+export type FnFormOnSubmit = (values: any, params: FnFormOnChangeParams) => any;
+export type TypeHelpPos = "tip" | 'always' | 'bottom';
+export interface FormItemSchema {
+    id?: string;
+    label?: string | IReactElement;
+    size?: SizeEnum | string;
+    labelCol?: any;
+    wrapperCol?: any;
+    hasFeedback?: boolean;
+    help?: IFunc;
+    component?: string | IReactComponent;
+    labelAlign?: LabelAlignEnum;
+    labelTextAlign?: LabelTextAlignEnum;
+    labelWidth?: number;
+    device?: string;
+    colon?: boolean;
+    children?: any;
+    xProps?: any | FnGetXProps;
+    /**
+     * 布局方式
+     */
+    layout?: LayoutEnum | string;
+    cellProps?: any | TableLayoutCellProps;
+    className?: string;
+    style?: any;
+    prefix?: string;
+    fullWidth?: boolean;
+    render?: (value: any, childProps: any) => any;
+    renderPreview?: (value: any, childProps: any) => any;
+    renderExtra?: (value: any, wrapFormItemProps: any) => any;
+    previewPlaceholder?: string;
+    isPreview?: boolean | FnGetStateBool;
+    display?: boolean | FnGetStateBool;
+    disabled?: boolean | FnGetStateBool;
+    deps?: string[];
+    enums?: ILabelValue[] | FnGetEnums;
+    autoValidate?: boolean;
+    max?: number;
+    min?: number;
+    format?: string;
+    pattern?: string;
+    required?: boolean | FnGetStateBool;
+    requiredMessage?: string;
+    length?: number;
+    maxLength?: number;
+    minLength?: number;
+    validator?: FnValidator;
+    errorMessageName?: string;
+    useLabelForErrorMessage?: boolean;
+    rules?: FormItemValidateRule[];
+    helpPos?: TypeHelpPos;
+    onChange?: FnFormItemOnChange;
+    description?: string;
+}
+export interface FormItemProps extends FormItemSchema {
+    name: string;
+}
+export interface FormSchema {
+    type: string;
+    properties: Record<string, FormItemSchema>;
+}
+/**
+ * 表单Props
+ */
+export interface FormProps {
+    /**
+     * 是否显示默认的提交按钮。默认 false
+     */
+    submitter?: boolean;
+    /**
+     * 样式前缀
+     */
+    prefix?: string;
+    /**
+     * 内联表单
+     */
+    inline?: boolean;
+    /**
+     * 单个 Item 的 size 自定义，优先级高于 Form 的 size, 并且当组件与 Item 一起使用时，组件自身设置 size 属性无效。
+     * @enumdesc 大, 中, 小
+     */
+    size?: string | SizeEnum;
+    /**
+     * 单个 Item 中表单类组件宽度是否是100%
+     */
+    fullWidth?: boolean;
+    /**
+     * 标签的位置, 如果不设置 labelCol 和 wrapperCol 那么默认是标签在上
+     * @enumdesc 上, 左, 内
+     */
+    labelAlign?: string | LabelAlignEnum;
+    /**
+     * 标签的左右对齐方式
+     * @enumdesc 左, 右
+     */
+    labelTextAlign?: string | LabelTextAlignEnum;
+    /**
+     * 控制第一级 Item 的 labelCol
+     */
+    labelCol?: IObject;
+    /**
+     * 控制第一级 Item 的 wrapperCol
+     */
+    wrapperCol?: IObject;
+    /**
+     * FormSubmit按钮会触发
+     */
+    onSubmit?: FnFormOnSubmit;
+    /**
+     * FormSubmit按钮会触发
+     */
+    onReset?: FnFormOnSubmit;
+    /**
+     * 组件创建完毕
+     */
+    onCreated?: FnFormOnCreated;
+    /**
+     * 表单变化回调
+     */
+    onChange?: FnFormOnChange;
+    /**
+     * 异步枚举值加载完成
+     */
+    onAsyncEnums?: FnGetEnums;
+    /**
+     * 子元素
+     */
+    children?: any;
+    /**
+     * 子元素schema模式
+     */
+    schema?: FormSchema | null;
+    /**
+     * 扩展class
+     */
+    className?: string;
+    /**
+     * 自定义内联样式
+     */
+    style?: IObject;
+    /**
+     * 是否是从从右往左的布局样式
+     */
+    rtl?: boolean;
+    /**
+     * 布局方式
+     */
+    layout?: LayoutEnum | null;
+    /**
+     * 布局组件使用的参数
+     */
+    layoutProps?: ResponsiveGridProps | CustomLayoutProps | FloatLayoutProps | null;
+    /**
+     * 是否使用 label 替换校验信息的 name 字段
+     */
+    useLabelForErrorMessage?: boolean;
+    /**
+     * 表示是否显示 label 后面的冒号
+     */
+    colon?: boolean;
+    /**
+     * 渲染设备。可选值：phone、desktop
+     */
+    device?: string;
+    /**
+     * 表单默认值
+     */
+    defaultValues?: any;
+    /**
+     * Form内可以使用的组件定义components
+     */
+    components?: Record<string, IReactComponent>;
+    /**
+     * 是否处于预览状态， 默认： false
+     */
+    isPreview?: boolean | FnGetStateBool;
+    /**
+     * 是否处于禁用状态，默认：false
+     */
+    disabled?: boolean | FnGetStateBool;
+    /**
+     * 是否处于显示状态，默认 true
+     */
+    display?: boolean | FnGetStateBool;
+    /**
+     * 自定义预览状态渲染
+     */
+    renderPreview?: IFunc;
+    /**
+     * 在预览状态下，对于空值的占位符，默认： --
+     */
+    previewPlaceholder?: string;
+    /**
+     * 错误提示显示位置： tip，bottom（default）
+     */
+    helpPos?: string;
+    /**
+     * 是否表单创建完成后，自动触发校验。
+     */
+    autoValidateOnCreated?: boolean;
+    /**
+     * 自动校验
+     */
+    autoValidate?: boolean;
+    /**
+     * 表单内部的多语言配置对象
+     */
+    locale?: any;
+}
+export interface IValidateStateError {
+    message: string;
+}
+export interface IFormStoreValues {
+    stateMap: Record<string, IItemState>;
+    defaultValues: Record<string, any>;
+    values: Record<string, any>;
+    runtimeParams: any;
+    valuesOfOnSearch: any;
+}
+export interface IFormContext {
+    formProps: FormProps;
+    formStore: any;
+    formActions: any;
+    formComponents: any;
+    formOnChange: any;
+}
+export interface WrapFormItemProps {
+    formItemProps: FormItemProps;
+    formItemState: FormItemState;
+    formContext: IFormContext;
+}
+export interface FormStoreExtData1 {
+    propsMap: Record<string, any>;
+}
+export interface IFormSectionProps extends FormProps {
+    useCard?: boolean;
+    title?: string;
+}
+export interface IFormSectionContext {
+    sectionProps: IFormSectionProps;
+}
+export interface BaseBtnProps {
+    type?: any;
+    onClick?: any;
+    children?: any;
+    text?: string;
+    bizCallback?: any;
+    localKey: string;
+    xProps?: any;
+}
+export interface ResetProps extends BaseBtnProps {
+    toDefault?: boolean;
+    names?: string[] | string;
+    exclude?: string[];
+}
+export interface SubmitProps extends BaseBtnProps {
+    validate?: boolean;
+    showToast?: boolean;
+}
+export interface FormButtonGroupBtn extends Record<string, any> {
+    component: string | any;
+}
+export interface FormButtonGroupProps {
+    id: string;
+    buttons: FormButtonGroupBtn[];
+    className?: string;
+}
+export interface IFormItemCardProps {
+    title?: string;
+    children?: any;
+    prefix?: string;
+}
+export {};

package/types/0buildTypes/form2/form.d.ts

@@ -0,0 +1,36 @@
+import React from "react";
+import FormItem from './form-item';
+import { FormProps } from "./form-types";
+declare function Form(formProps: FormProps): React.JSX.Element;
+declare namespace Form {
+    var defaultProps: {
+        prefix: string;
+        onSubmit: typeof import("../util/func").preventDefault;
+        size: string;
+        labelAlign: string;
+        onChange: () => void;
+        component: string;
+        device: string;
+        locale: any;
+        colon: boolean;
+        autoValidate: boolean;
+        useLabelForErrorMessage: boolean;
+        helpPos: string;
+        disabled: boolean;
+        isPreview: boolean;
+        display: boolean;
+        autoValidateOnCreated: boolean;
+        previewPlaceholder: string;
+    };
+    var displayName: string;
+    var Item: typeof FormItem;
+    var Section: any;
+    var Reset: any;
+    var Submit: any;
+    var Button: any;
+    var ButtonGroup: any;
+    var ItemCard: any;
+    var schemaToFormItems: (schema: any) => React.JSX.Element[];
+    var useFormChildren: (props: FormProps) => any[];
+}
+export default Form;

package/types/0buildTypes/form2/helper/buildParams.d.ts

@@ -0,0 +1,5 @@
+import { PreciseStore } from "../../hooks/usePreciseStore";
+import { FormActions } from "../form-actions";
+import { FnFormOnChangeParams } from "../form-types";
+declare const buildFnFormOnChangeParams: (formStore: PreciseStore, formActions: FormActions) => FnFormOnChangeParams;
+export { buildFnFormOnChangeParams };

package/types/0buildTypes/form2/helper/constants.d.ts

@@ -0,0 +1,24 @@
+declare const formDefaultProps: {
+    prefix: string;
+    onSubmit: typeof import("../../util/func").preventDefault;
+    size: string;
+    labelAlign: string;
+    onChange: () => void;
+    component: string;
+    device: string;
+    locale: any;
+    colon: boolean;
+    autoValidate: boolean;
+    useLabelForErrorMessage: boolean;
+    helpPos: string;
+    disabled: boolean;
+    isPreview: boolean;
+    display: boolean;
+    autoValidateOnCreated: boolean;
+    previewPlaceholder: string;
+};
+export declare const FORM_ITEM_TYPE_MARK: string;
+export declare const FORM_SUBMIT_TYPE_MARK: string;
+export declare const FORM_RESET_TYPE_MARK: string;
+export declare const FORM_BUTTON_TYPE_MARK: string;
+export { formDefaultProps };

package/types/0buildTypes/form2/helper/fixItemProps.d.ts

@@ -0,0 +1,16 @@
+import { FormItemProps, FormItemStateSaved, IFormContext, IFormSectionContext } from "../form-types";
+/**
+ * 使用继承关系，设置FormItemProps
+ * @param props0
+ * @param formContext
+ * @param formSectionContext
+ * @param runtimeId
+ */
+declare function fixItemPropsByInherit(props0: FormItemProps, formContext: IFormContext, formSectionContext: IFormSectionContext, runtimeId: string): FormItemProps;
+/**
+ * 使用状态，设置FormItemProps
+ * @param props
+ * @param itemState
+ */
+declare function fixItemPropsByState(props: FormItemProps, itemState: FormItemStateSaved): FormItemStateSaved;
+export { fixItemPropsByInherit, fixItemPropsByState };

package/types/0buildTypes/form2/helper/fnInheritProps.d.ts

@@ -0,0 +1,2 @@
+declare function inheritFormProps(props: any, formProps: any): any;
+export { inheritFormProps };

package/types/0buildTypes/form2/helper/linkageFormState.d.ts

@@ -0,0 +1,16 @@
+import { PreciseStore } from "../../hooks/usePreciseStore";
+import { FormItemProps } from "../form-types";
+import { FormActions } from "../form-actions";
+/**
+ * 对单个formItem的状态进行联动计算
+ * @param formStore
+ * @param itemProps
+ */
+declare function linkageFormItemState(formStore: PreciseStore, itemProps: FormItemProps): void;
+/**
+ * 对所有formItem的状态进行联动计算
+ * @param formStore
+ * @param formActions
+ */
+declare function linkageFormState(formStore: PreciseStore, formActions: FormActions): void;
+export { linkageFormState, linkageFormItemState };

package/types/0buildTypes/form2/helper/useDataSource.d.ts

@@ -0,0 +1,14 @@
+import { IFormContext } from "../form-types";
+/**
+ * dataSource 字段数据来源：
+ *  1. enums 是一个异步函数，可以异步返回
+ *  2. enums 是一个同步函数，可以直接返回
+ *  3. enums 是一个数组
+ * @param enums
+ * @param childProps
+ * @param xProps
+ * @param formContext
+ * @param forceUpdateTick
+ */
+declare function useDataSource(enums: any, childProps: any, xProps: any, formContext: IFormContext, forceUpdateTick?: number): any;
+export { useDataSource };

package/types/0buildTypes/form2/helper/useFormChildren.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import { FormProps } from "../form-types";
+declare function schemaToFormItems(schema: any, FormItem: any): React.JSX.Element[];
+declare function useFormChildren(props: FormProps, FormItem: any): any[];
+export { useFormChildren, schemaToFormItems };

package/types/0buildTypes/form2/helper/useFormItemState.d.ts

@@ -0,0 +1,3 @@
+import { FormItemProps, FormItemState, IFormContext } from "../form-types";
+declare function useFormItemState(props: FormItemProps, formContext: IFormContext): FormItemState;
+export { useFormItemState };

package/types/0buildTypes/form2/helper/useGetXProps.d.ts

@@ -0,0 +1,3 @@
+import { FormItemProps, FormItemState, IFormContext } from "../form-types";
+declare function useGetXProps(formItemProps: FormItemProps, formItemState: FormItemState, formContext: IFormContext): any;
+export { useGetXProps };

package/types/0buildTypes/form2/index.d.ts

@@ -0,0 +1,20 @@
+import React from "react";
+import FormItem from './form-item';
+import { FormButton, FormButtonGroup, Reset, Submit } from './form-buttons';
+import { FormProps } from "./form-types";
+import { FormSection } from "./form-section";
+import { FormItemCard } from "./form-item-card";
+declare class Form extends React.Component<FormProps, any> {
+    static Item: typeof FormItem;
+    static ItemCard: typeof FormItemCard;
+    static Section: typeof FormSection;
+    static Submit: typeof Submit;
+    static Reset: typeof Reset;
+    static Button: typeof FormButton;
+    static ButtonGroup: typeof FormButtonGroup;
+    static schemaToFormItems: (schema: any) => React.JSX.Element[];
+    static useFormChildren: (props: FormProps) => any[];
+    render(): React.JSX.Element;
+}
+declare const _default: typeof Form;
+export default _default;

package/types/0buildTypes/form2/layout/from-float-layout.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+declare function FromFloatLayout(props: any): React.JSX.Element;
+export { FromFloatLayout };

package/types/0buildTypes/hooks/index.d.ts

@@ -0,0 +1,16 @@
+import { useCreatePreciseStore, useGetPreciseStore, usePreciseValue, usePreciseTick, PreciseStore } from './usePreciseStore';
+import { useCurrentState, useCurrentState2 } from './useCurrentState';
+import { useOnKeyPressCtrl, useOnKeyPressSave } from "./useOnKeyPressSave";
+declare const _default: {
+    PreciseStore: typeof PreciseStore;
+    useCreatePreciseStore: typeof useCreatePreciseStore;
+    useGetPreciseStore: typeof useGetPreciseStore;
+    usePreciseValue: typeof usePreciseValue;
+    usePreciseTick: typeof usePreciseTick;
+    useUniqueId: () => string;
+    useCurrentState: typeof useCurrentState;
+    useCurrentState2: typeof useCurrentState2;
+    useOnKeyPressCtrl: typeof useOnKeyPressCtrl;
+    useOnKeyPressSave: typeof useOnKeyPressSave;
+};
+export default _default;

package/types/0buildTypes/hooks/useCurrentState.d.ts

@@ -0,0 +1,11 @@
+/**
+ * state 可以是任何值
+ * @param initialState
+ */
+declare function useCurrentState(initialState: any): any[];
+/**
+ * state 必须是个对象
+ * @param initialState
+ */
+declare function useCurrentState2(initialState?: any): any[];
+export { useCurrentState, useCurrentState2, };

package/types/0buildTypes/hooks/useOnKeyPressSave.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 响应键盘 Ctrl + XXXX 事件
+ * @param fn
+ * @param keyCode
+ */
+declare function useOnKeyPressCtrl(fn: any, keyCode: number): void;
+/**
+ * 响应键盘 Ctrl + S 事件
+ * @param fn
+ */
+declare function useOnKeyPressSave(fn: any): void;
+export { useOnKeyPressCtrl, useOnKeyPressSave };

package/types/0buildTypes/hooks/usePersistFn.d.ts

@@ -0,0 +1,3 @@
+declare function usePersistFn(fn: any): any;
+declare const useMemoizedFn: typeof usePersistFn;
+export { usePersistFn, useMemoizedFn };

package/types/0buildTypes/hooks/usePreciseStore.d.ts

@@ -0,0 +1,53 @@
+import { CompareFn } from "../util/isStateEquals";
+export type AnyType = any;
+export declare const KEY_SAVED_TICK_COUNT = "KEY_SAVED_TICK_COUNT";
+export type WatcherFn = (nextValue: any, preValue: any, storage: PreciseStore) => void;
+export interface Watcher {
+    watchPath: string;
+    watcher: WatcherFn;
+    preValue: any;
+}
+type UpdateFn<A> = (nextValue: A) => void;
+type GetFn<A> = () => A;
+declare class PreciseStore {
+    readonly storeData: Record<string, any>;
+    private watcherManager;
+    private updatedBuffer;
+    private tickCount;
+    compareFn: CompareFn;
+    linkageFn: any;
+    extData1: any;
+    extData2: any;
+    constructor(initialValues: Record<any, any>, compareFn?: CompareFn, linkageFn?: any);
+    getValue(path: string): any;
+    setValue(path: string, value: any): void;
+    commit(): void;
+    setValueAndCommit(path: string, value: any): void;
+    watch(path: string, watcher: WatcherFn): void;
+    unwatch(path: string, watcher: WatcherFn): void;
+    notifyWatcher(): void;
+}
+/**
+ * 创建一个PreciseStore
+ * @param initialValues
+ * @param compareFn
+ * @param linkageFn
+ */
+declare function useCreatePreciseStore(initialValues: any, compareFn?: CompareFn, linkageFn?: any): PreciseStore;
+/**
+ * 从Context中获取PreciseStore
+ * @param context
+ */
+declare function useGetPreciseStore(context: any): PreciseStore;
+/**
+ * 订阅并获取value的变化
+ * @param store
+ * @param path
+ */
+declare function usePreciseValue(store: PreciseStore, path: string): [any, UpdateFn<AnyType>, GetFn<AnyType>, PreciseStore];
+/**
+ * 监听任何一次变更
+ * @param store
+ */
+declare function usePreciseTick(store: PreciseStore): [AnyType, UpdateFn<AnyType>, GetFn<AnyType>, PreciseStore];
+export { PreciseStore, useCreatePreciseStore, useGetPreciseStore, usePreciseValue, usePreciseTick, };

package/types/0buildTypes/hooks/useSize.d.ts

@@ -0,0 +1,6 @@
+export interface UseSizeRes {
+    width: number;
+    height: number;
+}
+declare function useSize(target: any): UseSizeRes;
+export { useSize };

package/types/0buildTypes/hooks/useUniqueId.d.ts

@@ -0,0 +1,2 @@
+declare const useUniqueId: () => string;
+export { useUniqueId, };

package/types/0buildTypes/hooks/useValueOnChange.d.ts

@@ -0,0 +1,2 @@
+declare function useValueOnChange(props: any): any[];
+export { useValueOnChange };