@qin-ui/vant-pro 1.0.4 → 1.1.0

package/src/index.ts

@@ -0,0 +1,62 @@
+import type { App } from 'vue';
+import ProForm from './components/form';
+import ProComponentProvider from './components/component-provider';
+
+export * from './components/form';
+export * from './components/component-provider';
+
+/**
+ * Schema 驱动的表单组件，基于 vant Form 封装
+ *
+ * @description 通过声明式 JSON Schema 配置即可快速生成表单，
+ * 提供极致的 TypeScript 类型推导与组件库插槽扩展能力。
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { ProForm, useForm } from '@qin-ui/vant-pro'
+ * const form = useForm<User>({ name: '' }, [
+ *   { path: 'name', label: '姓名', component: 'input' }
+ * ])
+ * </script>
+ * <template>
+ *   <ProForm :form="form" />
+ * </template>
+ * ```
+ *
+ * 组件提供者，用于全局配置 ProForm 的默认行为
+ *
+ * @description 通过 `ProComponentProvider` 包裹应用根组件，
+ * 可以全局覆盖组件的默认属性。
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <ProComponentProvider :component-props="customProps">
+ *     <App />
+ *   </ProComponentProvider>
+ * </template>
+ * ```
+ */
+export { ProForm, ProComponentProvider };
+
+export default {
+  /**
+   * @qin-ui/vant-pro 安装方法
+   * @description 全局注册所有组件（ProForm、ProComponentProvider）
+   *
+   * @param {App} app - Vue 应用实例
+   *
+   * @example
+   * ```ts
+   * import { createApp } from 'vue'
+   * import ProComponents from '@qin-ui/vant-pro'
+   * const app = createApp(App)
+   * app.use(ProComponents)
+   * ```
+   */
+  install(app: App) {
+    app.component(ProForm.name, ProForm);
+    app.component(ProComponentProvider.name!, ProComponentProvider);
+  },
+};

package/src/shared/core/index.ts

@@ -0,0 +1,37 @@
+/**
+ * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容，
+ * 避免直接散列依赖 @qin-ui/pro-components-core，便于将来统一维护。
+ */
+export {
+  // hooks
+  useForm,
+  useTable,
+  useFields,
+  useFormData,
+  useFormRef,
+  // injection keys
+  InjectionFormKey,
+  InjectionPathKey,
+  // utils
+  getObject,
+  toPath,
+  camelizeProperties,
+  cloneDeep,
+  omit,
+  pick,
+  isPlainObject,
+  // types
+  type Data,
+  type Path,
+  type Paths,
+  type KeyExpandString,
+  type ExtendWithAny,
+  type DeepPartial,
+  type PageParam,
+  type Fields,
+  type Form,
+  type Table,
+  type UseFieldsReturn,
+  type UseFormDataReturn,
+  type UseFormRefReturn,
+} from '@qin-ui/pro-components-core';

package/src/shared/ui/index.ts

@@ -0,0 +1,26 @@
+export {
+  Form,
+  Field,
+  Button,
+  Popup,
+  Picker,
+  DatePicker,
+  TimePicker,
+  Cascader,
+  Area,
+  Signature,
+  Switch,
+  Stepper,
+  Rate,
+  Slider,
+  Uploader,
+  CheckboxGroup,
+  Checkbox,
+  RadioGroup,
+  Radio,
+  Space,
+  type FormProps,
+  type FormInstance,
+  type FieldInstance,
+  type FieldProps,
+} from 'vant';

package/es/core/index-B5vvm4Fj.js

@@ -1,236 +0,0 @@
-import { ref, inject, reactive, provide, camelize } from "vue";
-import { i as isPlainObject, s as set, g as get, t as toPath } from "../vendor/utils/lodash-es-DN4QDiDm.js";
-const InjectionFormKey = Symbol("form");
-const InjectionPathKey = Symbol("path");
-function getObject(val) {
-  return isPlainObject(val) ? val : {};
-}
-function camelizeProperties(obj) {
-  return Object.fromEntries(
-    Object.entries(obj).map(([key, value]) => [camelize(key), value])
-  );
-}
-const useFields = (initFields) => {
-  const fields = ref([]);
-  fields.value = initFields || [];
-  const _map = /* @__PURE__ */ new Map();
-  const cacheMatch = (pathStr, updater) => {
-    var _a;
-    const fieldPath = _map.get(pathStr) || [];
-    if (fieldPath.length === 0) return false;
-    const fieldIndex = fieldPath[fieldPath.length - 1];
-    const parentField = fieldPath.length === 1 ? fields.value : get(fields.value, fieldPath.slice(0, -2));
-    const field = (_a = parentField == null ? void 0 : parentField.fields) == null ? void 0 : _a[fieldIndex];
-    const _path = toPath((field == null ? void 0 : field.name) ?? (field == null ? void 0 : field.path)).join(".");
-    if (_path === pathStr) {
-      updater({ field, fieldIndex, parentField });
-      return true;
-    }
-    return false;
-  };
-  const updaterMatch = (path, updater, options = {}) => {
-    if (!path) return;
-    const pathStr = typeof path === "function" ? "" : toPath(path).join(".");
-    const { all = typeof path === "function" } = options;
-    if (pathStr && _map.has(pathStr) && !all) {
-      const bool = cacheMatch(pathStr, updater);
-      if (bool) return;
-    }
-    const queue = fields.value.map((field, i) => ({
-      field,
-      fieldPath: [i],
-      parentField: { fields: fields.value }
-    }));
-    while (queue.length) {
-      const { field, fieldPath, parentField } = queue.shift();
-      let matched = false;
-      const _path = toPath(field.name ?? field.path).join(".");
-      if (_path) _map.set(_path, fieldPath);
-      if (typeof path === "function") {
-        matched = path(field);
-      } else if (_path) {
-        matched = pathStr === _path;
-      }
-      if (matched) {
-        const fieldIndex = fieldPath[fieldPath.length - 1];
-        updater({ field, fieldIndex, parentField });
-        if (!all) return;
-      }
-      if (Array.isArray(field.fields)) {
-        field.fields.forEach((f, i) => {
-          queue.push({
-            field: f,
-            fieldPath: [...fieldPath, "fields", i],
-            parentField: field
-          });
-        });
-      }
-    }
-  };
-  function getField(path, options) {
-    if (!path) return void 0;
-    const res = [];
-    updaterMatch(
-      path,
-      ({ field }) => {
-        res.push(field);
-      },
-      options
-    );
-    return (options == null ? void 0 : options.all) ? res : res[0];
-  }
-  function setField(path, field, options) {
-    if (!path) return;
-    const { updateType = "merge", ...rest } = options || {};
-    updaterMatch(
-      path,
-      ({ field: preField, fieldIndex, parentField }) => {
-        let value = field;
-        if (typeof field === "function") {
-          value = field(preField);
-        }
-        if (!value) return;
-        if (updateType === "rewrite") {
-          parentField.fields[fieldIndex] = value;
-        } else {
-          Object.assign(preField, value);
-        }
-      },
-      rest
-    );
-  }
-  function deleteField(path, options) {
-    if (!path) return;
-    updaterMatch(
-      path,
-      ({ fieldIndex, parentField }) => {
-        parentField.fields.splice(fieldIndex, 1);
-      },
-      options
-    );
-  }
-  function appendField(path, field, options) {
-    const newFields = Array.isArray(field) ? field : [field];
-    addFields(path, newFields, options, "after");
-  }
-  function prependField(path, field, options) {
-    const newFields = Array.isArray(field) ? field : [field];
-    addFields(path, newFields, options, "before");
-  }
-  function getParentField(path, options) {
-    if (!path) return void 0;
-    const res = [];
-    updaterMatch(
-      path,
-      ({ parentField }) => {
-        res.push(parentField);
-      },
-      options
-    );
-    return (options == null ? void 0 : options.all) ? res : res[0];
-  }
-  function addFields(path, newFields, options, placement) {
-    if (newFields.length === 0) return;
-    if (path) {
-      updaterMatch(
-        path,
-        ({ fieldIndex, parentField }) => {
-          const index = placement === "after" ? fieldIndex + 1 : fieldIndex;
-          parentField.fields.splice(index, 0, ...newFields);
-        },
-        options
-      );
-    } else if (placement === "after") {
-      fields.value.push(...newFields);
-    } else {
-      fields.value.unshift(...newFields);
-    }
-  }
-  return {
-    fields,
-    getField,
-    setField,
-    deleteField,
-    appendField,
-    prependField,
-    getParentField
-  };
-};
-const InjectionFormDataKey = Symbol("form-data");
-const useFormData = (initFormData) => {
-  if (!initFormData) {
-    const injectFormDataStore = inject(InjectionFormDataKey, void 0);
-    if (injectFormDataStore) return injectFormDataStore;
-  }
-  const formData = reactive(initFormData ?? {});
-  function getFormData(path) {
-    if (!path) return void 0;
-    return get(formData, path);
-  }
-  function setFormData(...args) {
-    let path;
-    let value;
-    if (args.length >= 2) {
-      [path, value] = args;
-      if (!path) return;
-    } else {
-      [value] = args;
-    }
-    if (path) {
-      if (typeof value === "function") {
-        const preValue = getFormData(path);
-        value = value(preValue);
-      }
-      set(formData, path, value);
-    } else {
-      if (typeof value === "function") {
-        const preValue = formData;
-        value = value(preValue);
-      }
-      if (!isPlainObject(value)) return;
-      Object.keys(formData).forEach((key) => {
-        delete formData[key];
-      });
-      Object.assign(formData, value);
-    }
-  }
-  const formDataStore = { formData, getFormData, setFormData };
-  provide(InjectionFormDataKey, formDataStore);
-  return formDataStore;
-};
-const useFormRef = () => {
-  const formRef = ref();
-  const setFormRef = (inst) => {
-    formRef.value = inst;
-  };
-  return { formRef, setFormRef };
-};
-function useForm(...args) {
-  let initFormData = {}, initFields = [], root = true;
-  if (args.length === 1) {
-    root = args[0];
-  } else if (args.length >= 2) {
-    initFormData = args[0] ?? {};
-    initFields = args[1];
-    root = args[2] ?? root;
-  }
-  if (!root) {
-    const injectForm = inject(InjectionFormKey);
-    if (injectForm) return injectForm;
-  }
-  return {
-    ...useFormData(initFormData),
-    ...useFields(initFields),
-    ...useFormRef()
-  };
-}
-export {
-  InjectionPathKey as I,
-  InjectionFormKey as a,
-  useFields as b,
-  camelizeProperties as c,
-  useFormRef as d,
-  useFormData as e,
-  getObject as g,
-  useForm as u
-};