@nokecy/qc-ui 1.0.58 → 1.0.60

package/dist/cjs/standardFormDialog/types.d.ts

@@ -0,0 +1,107 @@
+/// <reference types="react" />
+import { ISchema } from '@formily/react';
+import { ButtonProps } from 'antd';
+/**
+ * API配置接口
+ */
+export interface FormApiConfig {
+    /** 获取单条记录的API */
+    get?: (params: {
+        id: string | number;
+    }) => Promise<any>;
+    /** 创建记录的API */
+    create: (values: any) => Promise<any>;
+    /** 更新记录的API */
+    update: (params: {
+        id: string | number;
+    }, values: any) => Promise<any>;
+}
+/**
+ * 外部Schema配置接口
+ */
+export interface ExternalSchemaConfig {
+    /** 表单布局配置 */
+    form: Record<string, any>;
+    /** Schema定义 */
+    schema: ISchema;
+}
+/**
+ * Schema配置接口
+ */
+export interface FormSchemaConfig {
+    /** 表单ID */
+    formId: string;
+    /** 表单配置 */
+    form: Record<string, any>;
+    /** Schema定义 */
+    schema: ISchema;
+}
+/**
+ * 标准化FormDialog配置接口
+ */
+export interface StandardFormDialogConfig {
+    /** Schema配置 */
+    schemaConfig: FormSchemaConfig;
+    /** API配置 */
+    apiConfig: FormApiConfig;
+    /** 对话框宽度 */
+    width?: number;
+    /** 实体ID（编辑时） */
+    entityId?: string | number;
+    /** 标题 */
+    title?: string;
+    /** 按钮属性 */
+    buttonProps?: ButtonProps;
+    /** 提交成功后的回调 */
+    onAfterSubmit?: () => void;
+    /** 子元素 */
+    children?: React.ReactNode;
+    /** 门户ID前缀 */
+    portalIdPrefix?: string;
+    /** 自定义初始化逻辑 */
+    customInitializer?: (form: any, entityId?: string | number) => Promise<void>;
+    /** 自定义提交逻辑 */
+    customSubmitHandler?: (values: any, isEdit: boolean) => Promise<void>;
+    /** 是否启用统一错误处理 */
+    useUnifiedErrorHandling?: boolean;
+}
+/**
+ * withStandardForm配置接口
+ */
+export interface WithStandardFormConfig {
+    /** 表单ID */
+    formId: string;
+    /** 业务字段配置 - 当未提供externalSchema时必需 */
+    businessFields?: Record<string, any>;
+    /** 外部Schema配置 - 支持schema.ts文件导入 */
+    externalSchema?: ExternalSchemaConfig;
+    /** API配置 */
+    apiConfig: {
+        get?: (params: any) => Promise<any>;
+        create: (data: any) => Promise<any>;
+        update: (params: any, data: any) => Promise<any>;
+    };
+    /** 默认对话框配置 */
+    defaultDialogConfig?: {
+        width?: number;
+        title?: string;
+    };
+    /** 自定义表单处理器 */
+    customHandlers?: {
+        initializer?: (form: any, entityId?: string | number) => Promise<void>;
+        submitHandler?: (values: any, isEdit: boolean) => Promise<void>;
+    };
+}
+/**
+ * StandardFormDialog组件属性接口
+ */
+export interface StandardFormDialogProps extends Omit<StandardFormDialogConfig, 'schemaConfig'> {
+    /** Schema配置 */
+    schemaConfig?: FormSchemaConfig;
+    /** 或者直接传入formId和schema */
+    formId?: string;
+    formSchema?: {
+        form: Record<string, any>;
+        schema: ISchema;
+    };
+}

package/dist/cjs/standardFormDialog/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/standardFormDialog/useStandardFormSchema.d.ts

@@ -0,0 +1,68 @@
+import { FormSchemaConfig } from './types';
+/**
+ * 标准表单Schema Hook
+ *
+ * 提供便捷的Schema创建和管理功能
+ */
+export declare const useStandardFormSchema: (formId: string, businessSchema: Record<string, any>, formConfig?: Record<string, any>) => FormSchemaConfig;
+/**
+ * 创建标准Grid Schema的工具函数
+ */
+export declare const createGridSchema: (properties: Record<string, any>, maxColumns?: number, strictAutoFit?: boolean) => Record<string, any>;
+/**
+ * 创建表单字段的工具函数
+ */
+export declare const createFormField: (title: string, component?: string, options?: {
+    type?: string | undefined;
+    required?: boolean | undefined;
+    placeholder?: string | undefined;
+    maxLength?: number | undefined;
+    rows?: number | undefined;
+    gridSpan?: number | undefined;
+    componentProps?: Record<string, any> | undefined;
+    decoratorProps?: Record<string, any> | undefined;
+} | undefined) => any;
+/**
+ * 创建选择字段的工具函数
+ */
+export declare const createSelectField: (title: string, options: Array<{
+    label: string;
+    value: any;
+}>, fieldOptions?: {
+    required?: boolean | undefined;
+    placeholder?: string | undefined;
+    gridSpan?: number | undefined;
+    mode?: "multiple" | "tags" | undefined;
+} | undefined) => any;
+/**
+ * 快速创建常用字段的工具函数集合
+ */
+export declare const FieldCreators: {
+    /**
+     * 创建输入框字段
+     */
+    input: (title: string, required?: boolean, gridSpan?: number) => any;
+    /**
+     * 创建文本域字段
+     */
+    textarea: (title: string, rows?: number, gridSpan?: number) => any;
+    /**
+     * 创建数字输入框字段
+     */
+    number: (title: string, required?: boolean, gridSpan?: number) => any;
+    /**
+     * 创建选择框字段
+     */
+    select: (title: string, options: Array<{
+        label: string;
+        value: any;
+    }>, required?: boolean) => any;
+    /**
+     * 创建日期字段
+     */
+    date: (title: string, required?: boolean, gridSpan?: number) => any;
+    /**
+     * 创建日期时间字段
+     */
+    datetime: (title: string, required?: boolean, gridSpan?: number) => any;
+};

package/dist/cjs/standardFormDialog/useStandardFormSchema.js

@@ -0,0 +1,197 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useStandardFormSchema = exports.createSelectField = exports.createGridSchema = exports.createFormField = exports.FieldCreators = void 0;
+var _react = require("react");
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 标准表单Schema Hook
+ * 
+ * 提供便捷的Schema创建和管理功能
+ */
+var useStandardFormSchema = exports.useStandardFormSchema = function useStandardFormSchema(formId, businessSchema, formConfig) {
+  return (0, _react.useMemo)(function () {
+    var defaultFormConfig = {
+      labelCol: 6,
+      wrapperCol: 18,
+      labelWidth: "120px",
+      feedbackLayout: "none"
+    };
+    var finalFormConfig = _objectSpread(_objectSpread({}, defaultFormConfig), formConfig);
+    var schema = {
+      type: "object",
+      properties: businessSchema
+    };
+    return {
+      formId: formId,
+      form: finalFormConfig,
+      schema: schema
+    };
+  }, [formId, businessSchema, formConfig]);
+};
+
+/**
+ * 创建标准Grid Schema的工具函数
+ */
+var createGridSchema = exports.createGridSchema = function createGridSchema(properties) {
+  var maxColumns = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  var strictAutoFit = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  return {
+    grid: {
+      type: "void",
+      "x-component": "FormGrid",
+      "x-component-props": {
+        maxColumns: maxColumns,
+        strictAutoFit: strictAutoFit
+      },
+      properties: properties
+    }
+  };
+};
+
+/**
+ * 创建表单字段的工具函数
+ */
+var createFormField = exports.createFormField = function createFormField(title) {
+  var component = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'Input';
+  var options = arguments.length > 2 ? arguments[2] : undefined;
+  var _ref = options || {},
+    _ref$type = _ref.type,
+    type = _ref$type === void 0 ? 'string' : _ref$type,
+    _ref$required = _ref.required,
+    required = _ref$required === void 0 ? false : _ref$required,
+    placeholder = _ref.placeholder,
+    maxLength = _ref.maxLength,
+    rows = _ref.rows,
+    _ref$gridSpan = _ref.gridSpan,
+    gridSpan = _ref$gridSpan === void 0 ? 1 : _ref$gridSpan,
+    _ref$componentProps = _ref.componentProps,
+    componentProps = _ref$componentProps === void 0 ? {} : _ref$componentProps,
+    _ref$decoratorProps = _ref.decoratorProps,
+    decoratorProps = _ref$decoratorProps === void 0 ? {} : _ref$decoratorProps;
+  var field = {
+    type: type,
+    title: title,
+    "x-decorator": "FormItem",
+    "x-component": component,
+    "x-component-props": _objectSpread({
+      placeholder: placeholder || "\u8BF7\u8F93\u5165".concat(title)
+    }, componentProps),
+    "x-decorator-props": _objectSpread({
+      gridSpan: gridSpan
+    }, decoratorProps)
+  };
+  if (required) {
+    field.required = true;
+  }
+  if (maxLength) {
+    field["x-component-props"].maxLength = maxLength;
+  }
+  if (rows && (component === 'Input.TextArea' || component === 'TextArea')) {
+    field["x-component-props"].rows = rows;
+  }
+  return field;
+};
+
+/**
+ * 创建选择字段的工具函数
+ */
+var createSelectField = exports.createSelectField = function createSelectField(title, options, fieldOptions) {
+  var _ref2 = fieldOptions || {},
+    _ref2$required = _ref2.required,
+    required = _ref2$required === void 0 ? false : _ref2$required,
+    placeholder = _ref2.placeholder,
+    _ref2$gridSpan = _ref2.gridSpan,
+    gridSpan = _ref2$gridSpan === void 0 ? 1 : _ref2$gridSpan,
+    mode = _ref2.mode;
+  return createFormField(title, 'Select', {
+    required: required,
+    placeholder: placeholder || "\u8BF7\u9009\u62E9".concat(title),
+    gridSpan: gridSpan,
+    componentProps: {
+      options: options,
+      mode: mode
+    }
+  });
+};
+
+/**
+ * 快速创建常用字段的工具函数集合
+ */
+var FieldCreators = exports.FieldCreators = {
+  /**
+   * 创建输入框字段
+   */
+  input: function input(title) {
+    var required = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var gridSpan = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+    return createFormField(title, 'Input', {
+      required: required,
+      gridSpan: gridSpan
+    });
+  },
+  /**
+   * 创建文本域字段
+   */
+  textarea: function textarea(title) {
+    var rows = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 3;
+    var gridSpan = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 2;
+    return createFormField(title, 'Input.TextArea', {
+      rows: rows,
+      gridSpan: gridSpan
+    });
+  },
+  /**
+   * 创建数字输入框字段
+   */
+  number: function number(title) {
+    var required = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var gridSpan = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+    return createFormField(title, 'NumberPicker', {
+      type: 'number',
+      required: required,
+      gridSpan: gridSpan
+    });
+  },
+  /**
+   * 创建选择框字段
+   */
+  select: function select(title, options) {
+    var required = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    return createSelectField(title, options, {
+      required: required
+    });
+  },
+  /**
+   * 创建日期字段
+   */
+  date: function date(title) {
+    var required = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var gridSpan = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+    return createFormField(title, 'DatePicker', {
+      required: required,
+      gridSpan: gridSpan
+    });
+  },
+  /**
+   * 创建日期时间字段
+   */
+  datetime: function datetime(title) {
+    var required = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var gridSpan = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+    return createFormField(title, 'DatePicker', {
+      required: required,
+      gridSpan: gridSpan,
+      componentProps: {
+        showTime: true
+      }
+    });
+  }
+};

package/dist/cjs/standardFormDialog/withStandardForm.d.ts

@@ -0,0 +1,193 @@
+import React from 'react';
+import { StandardFormDialogProps, WithStandardFormConfig, ExternalSchemaConfig } from './types';
+/**
+ * 标准表单配置接口 - 向后兼容
+ * @deprecated 请使用 WithStandardFormConfig 类型
+ */
+export interface StandardFormConfig extends WithStandardFormConfig {
+}
+/**
+ * 重新导出类型以保持向后兼容性
+ */
+export type { ExternalSchemaConfig, WithStandardFormConfig };
+/**
+ * 创建带有标准表单的高阶组件
+ *
+ * 这个工厂函数创建一个标准化的表单对话框组件，包含：
+ * - 支持外部Schema文件导入或自动Schema构建
+ * - 标准的 API 调用逻辑
+ * - 统一的错误处理
+ * - 可配置的业务字段
+ *
+ * @param config 标准表单配置
+ * @returns 标准表单对话框组件
+ *
+ * @example
+ * // 使用businessFields（内部构建schema）
+ * const FormDialog = withStandardForm({
+ *   formId: 'Common.Materials',
+ *   businessFields: {
+ *     code: FieldCreators.input('物料编码', true),
+ *     name: FieldCreators.input('物料名称', true)
+ *   },
+ *   apiConfig: { get: GetAsync, create: CreateAsync }
+ * });
+ *
+ * @example
+ * // 使用外部schema文件
+ * import { form, schema } from './schema';
+ * const FormDialog = withStandardForm({
+ *   formId: 'Common.Materials',
+ *   externalSchema: { form, schema },
+ *   apiConfig: { get: GetAsync, create: CreateAsync }
+ * });
+ */
+export declare const withStandardForm: (config: WithStandardFormConfig) => React.FC<Partial<StandardFormDialogProps> & {
+    entityId?: string | undefined;
+    title?: string | undefined;
+    onAfterSubmit?: (() => void) | undefined;
+    children?: React.ReactNode;
+    buttonProps?: any;
+}>;
+/**
+ * 字段创建器工具函数集合
+ * 提供常用字段类型的快速创建方法
+ */
+export declare const FieldCreators: {
+    /**
+     * 输入框字段
+     */
+    input: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 数字输入字段
+     */
+    number: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 文本域字段
+     */
+    textarea: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 日期字段
+     */
+    date: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 日期时间字段
+     */
+    datetime: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 开关字段
+     */
+    switch: (title: string, defaultValue?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        default: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 选择字段
+     */
+    select: (title: string, required?: boolean, props?: any) => {
+        type: string;
+        title: string;
+        required: boolean;
+        'x-component': string;
+        'x-component-props': any;
+    };
+    /**
+     * 隐藏字段
+     */
+    hidden: (defaultValue?: any) => {
+        type: string;
+        default: any;
+        'x-component': string;
+        'x-display': string;
+    };
+};
+/**
+ * 创建选择字段
+ */
+export declare const createSelectField: (title: string, options: {
+    [key: string]: any;
+    label: string;
+    value: any;
+}[], config?: {
+    required?: boolean | undefined;
+    multiple?: boolean | undefined;
+    allowClear?: boolean | undefined;
+    showSearch?: boolean | undefined;
+    placeholder?: string | undefined;
+}) => {
+    type: string;
+    title: string;
+    required: boolean;
+    enum: any[];
+    'x-component': string;
+    'x-component-props': {
+        placeholder: string;
+        style: {
+            width: string;
+        };
+        allowClear: boolean;
+        showSearch: boolean;
+        mode: string | undefined;
+        options: {
+            label: string;
+            value: any;
+        }[];
+    };
+};
+/**
+ * 创建级联选择字段
+ */
+export declare const createCascaderField: (title: string, options: any[], config?: {
+    required?: boolean | undefined;
+    changeOnSelect?: boolean | undefined;
+    expandTrigger?: "hover" | "click" | undefined;
+    placeholder?: string | undefined;
+}) => {
+    type: string;
+    title: string;
+    required: boolean;
+    'x-component': string;
+    'x-component-props': {
+        placeholder: string;
+        style: {
+            width: string;
+        };
+        options: any[];
+        changeOnSelect: boolean;
+        expandTrigger: "hover" | "click";
+    };
+};
+export default withStandardForm;