yc-pro-components 0.0.11 → 0.0.13

package/es/components/yc-plus-page/src/index.vue.mjs

@@ -1,6 +1,6 @@
 import _sfc_main from './index.vue2.mjs';
 import _export_sfc from '../../../_virtual/_plugin-vue_export-helper.mjs';
 
-var YcPlusPageComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-4486eb75"], ["__file", "index.vue"]]);
+var YcPlusPageComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-7c1490fd"], ["__file", "index.vue"]]);
 
 export { YcPlusPageComponent as default };

package/es/components/yc-plus-page/src/index.vue2.mjs

@@ -146,7 +146,10 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
           hasUnfold: false,
           rowProps: { gutter: 0 },
           colProps: { span: getSpanByCount(searchableFieldsCount.value) },
-          labelSuffix: ""
+          labelSuffix: "",
+          labelPosition: "right",
+          searchIcon: null,
+          resetIcon: null
         };
         return merge({}, defaultSearchConfig, props.search);
       }
@@ -154,7 +157,10 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
         hasUnfold: false,
         rowProps: { gutter: 0 },
         colProps: { span: getSpanByCount(searchableFieldsCount.value) },
-        labelSuffix: ""
+        labelSuffix: "",
+        labelPosition: "right",
+        searchIcon: null,
+        resetIcon: null
       };
     });
     const mergedSearchCardProps = computed(() => {

package/es/components/yc-segmented/index.d.ts

@@ -54,12 +54,12 @@ export declare const YcSegmentedWithInstall: SFCWithInstall<DefineComponent<{
         default: boolean;
     };
 }>> & {
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }, {
-    modelValue: string | number;
     disabled: boolean;
     options: YcSegmentedOption[];
+    modelValue: string | number;
     resize: boolean;
     block: boolean;
 }, {}>>;

package/es/components/yc-segmented/src/index.d.ts

@@ -62,12 +62,12 @@ declare const _default: DefineComponent<{
         default: boolean;
     };
 }>> & {
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }, {
-    modelValue: string | number;
     disabled: boolean;
     options: YcSegmentedOption[];
+    modelValue: string | number;
     resize: boolean;
     block: boolean;
 }, {}>;

package/es/components/yc-select-v2/src/index.vue.d.ts

@@ -44,14 +44,14 @@ declare const _default: DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToRunt
     initialOptions: () => never[];
     allSelect: boolean;
 }>>> & {
-    "onUpdate:modelValue"?: ((value: FieldValueType) => any) | undefined;
     onChange?: ((value: SelectValueType) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: FieldValueType) => any) | undefined;
 }, {
-    modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
-    filterable: boolean;
     disabled: boolean;
+    filterable: boolean;
     options: SelectOption[];
     pageSize: number;
+    modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
     multiple: boolean;
     clearable: boolean;
     placeholder: string;

package/es/components/yc-status-dialog/src/index.vue.d.ts

@@ -28,9 +28,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
     onCancel?: (() => any) | undefined;
     onConfirm?: (() => any) | undefined;
 }, {
+    content: string;
     title: string;
     width: string | number;
-    content: string;
     visible: boolean;
     status: StatusType;
     cancelText: string;

package/es/components/yc-tabs-with-filter/index.d.ts

@@ -5,14 +5,14 @@ import { default as YcTabsWithFilter } from './src/index.vue';
 /** 带筛选按钮的 Tabs 组件 */
 export declare const YcTabsWithFilterWithInstall: SFCWithInstall<{
     new (...args: any[]): CreateComponentPublicInstance<Readonly< ExtractPropTypes<{
-        filterText: {
-            type: PropType<string>;
-            default: undefined;
-        };
         modelValue: {
             type: PropType<string>;
             required: true;
         };
+        filterText: {
+            type: PropType<string>;
+            default: undefined;
+        };
         showFilter: {
             type: PropType<boolean>;
             default: boolean;
@@ -38,14 +38,14 @@ export declare const YcTabsWithFilterWithInstall: SFCWithInstall<{
         "update:modelValue": (value: string) => void;
         "filter-toggle": (visible: boolean) => void;
     }, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-        filterText: {
-            type: PropType<string>;
-            default: undefined;
-        };
         modelValue: {
             type: PropType<string>;
             required: true;
         };
+        filterText: {
+            type: PropType<string>;
+            default: undefined;
+        };
         showFilter: {
             type: PropType<boolean>;
             default: boolean;
@@ -79,14 +79,14 @@ export declare const YcTabsWithFilterWithInstall: SFCWithInstall<{
         M: {};
         Defaults: {};
     }, Readonly< ExtractPropTypes<{
-        filterText: {
-            type: PropType<string>;
-            default: undefined;
-        };
         modelValue: {
             type: PropType<string>;
             required: true;
         };
+        filterText: {
+            type: PropType<string>;
+            default: undefined;
+        };
         showFilter: {
             type: PropType<boolean>;
             default: boolean;
@@ -119,14 +119,14 @@ export declare const YcTabsWithFilterWithInstall: SFCWithInstall<{
     __isTeleport?: undefined;
     __isSuspense?: undefined;
 } & ComponentOptionsBase<Readonly< ExtractPropTypes<{
-    filterText: {
-        type: PropType<string>;
-        default: undefined;
-    };
     modelValue: {
         type: PropType<string>;
         required: true;
     };
+    filterText: {
+        type: PropType<string>;
+        default: undefined;
+    };
     showFilter: {
         type: PropType<boolean>;
         default: boolean;

package/es/components/yc-text/src/index.vue.d.ts

@@ -9,7 +9,7 @@ interface TippyOptions {
 declare const _default: __VLS_WithTemplateSlots< DefineComponent<{
     /** 行数限制 */
     lineClamp: {
-        type: (NumberConstructor | StringConstructor)[];
+        type: (StringConstructor | NumberConstructor)[];
     };
     /** Tippy 配置 */
     tippyProps: {
@@ -19,7 +19,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<{
 }, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 行数限制 */
     lineClamp: {
-        type: (NumberConstructor | StringConstructor)[];
+        type: (StringConstructor | NumberConstructor)[];
     };
     /** Tippy 配置 */
     tippyProps: {

package/es/constants/dict.d.ts

@@ -0,0 +1,78 @@
+import { OptionsRow } from 'yc-pro-components/es/types';
+import { InjectionKey } from 'vue';
+
+/**
+ * 字典 Store 标准接口
+ * @description 所有项目的字典 Store 必须实现此接口才能使用自动字典注入功能
+ * @version v0.2.0
+ * @example
+ * ```ts
+ * import type { DictStoreInterface } from 'yc-components'
+ *
+ * export const useDictStore = defineStore('dict', () => {
+ *   const getDictData = (field: string): OptionsRow[] => {
+ *     // 返回字典数据
+ *     return dictData.value[field] || []
+ *   }
+ *
+ *   const hasDict = (field: string): boolean => {
+ *     return !!dictData.value[field]
+ *   }
+ *
+ *   const getDictLabel = (field: string, value: string | number): string => {
+ *     const items = dictData.value[field] || []
+ *     const item = items.find(item => item.value === value)
+ *     return item?.label || String(value)
+ *   }
+ *
+ *   return { getDictData, hasDict, getDictLabel }
+ * })
+ * ```
+ */
+export interface DictStoreInterface {
+    /**
+     * 根据字段名或字典 code 获取字典数据
+     * @param field 字段名（如 "status"）或字典 code（如 "ORDER_STATUS"）
+     * @returns 字典选项数组
+     * @description 此方法是核心方法，必须实现
+     */
+    getDictData: (field: string) => OptionsRow[];
+    /**
+     * 检查字段是否有字典映射
+     * @param field 字段名或字典 code
+     * @returns 是否存在字典数据
+     * @description 可选方法，用于优化性能
+     */
+    hasDict?: (field: string) => boolean;
+    /**
+     * 获取字典标签
+     * @param field 字段名或字典 code
+     * @param value 字典值
+     * @returns 字典标签
+     * @description 可选方法，用于显示字典标签
+     */
+    getDictLabel?: (field: string, value: string | number) => string;
+}
+/**
+ * 字典 Store 注入 Key
+ * @description 用于 provide/inject 传递字典 Store 实例
+ * @version v0.2.0
+ * @example
+ * ```ts
+ * // 提供字典 Store
+ * import { provide } from 'vue'
+ * import { DictStoreInjectionKey } from 'yc-components'
+ *
+ * const dictStore = useDictStore()
+ * provide(DictStoreInjectionKey, dictStore)
+ * ```
+ *
+ * ```ts
+ * // 注入字典 Store
+ * import { inject } from 'vue'
+ * import { DictStoreInjectionKey } from 'yc-components'
+ *
+ * const dictStore = inject(DictStoreInjectionKey)
+ * ```
+ */
+export declare const DictStoreInjectionKey: InjectionKey<DictStoreInterface>;

package/es/constants/dict.mjs

@@ -0,0 +1,3 @@
+const DictStoreInjectionKey = Symbol("DictStore");
+
+export { DictStoreInjectionKey };

package/es/constants/index.d.ts

@@ -1,3 +1,4 @@
 export * from './page';
 export * from './form';
 export * from './display-item';
+export * from './dict';

package/es/constants/index.mjs

@@ -1,3 +1,4 @@
 export { DefaultPageInfo, DefaultPageSizeList } from './page.mjs';
 export { DatePickerValueIsArrayList, TableFormFieldRefInjectionKey, TableFormRefInjectionKey, TableFormRowInfoInjectionKey, ValueIsArrayList, ValueIsBooleanList, ValueIsNumberList } from './form.mjs';
 export { selectValueTypeList } from './display-item.mjs';
+export { DictStoreInjectionKey } from './dict.mjs';

package/es/hooks/index.d.ts

@@ -6,3 +6,4 @@ export * from './usePlusProConfig';
 export * from './useSortableDrag';
 export * from './usePlusFormReset';
 export * from './useSelectWithPagination';
+export * from './useDictInjection';

package/es/hooks/index.mjs

@@ -6,3 +6,4 @@ export { providePlusProConfig, useDialogFormConfig, useDrawerFormConfig, usePlus
 export { useSortableDrag } from './useSortableDrag.mjs';
 export { usePlusFormClearValidate, usePlusFormFullReset, usePlusFormReset } from './usePlusFormReset.mjs';
 export { useSelectWithPagination } from './useSelectWithPagination.mjs';
+export { useDictInjection } from './useDictInjection.mjs';

package/es/hooks/useDictInjection.d.ts

@@ -0,0 +1,38 @@
+import { DictStoreInterface } from 'yc-pro-components/es/constants';
+
+/**
+ * 提供字典 Store 给子组件
+ * @param dictStore 字典 Store 实例，必须实现 DictStoreInterface 接口
+ * @description 在父组件中调用此函数，将字典 Store 提供给所有子组件使用
+ * @version v0.2.0
+ * @example
+ * ```vue
+ * <!-- 在父组件中提供字典 Store -->
+ * <script setup lang="ts">
+ * import { useDictInjection } from 'yc-components'
+ * import { useFieldCatalogStore } from '@/store/modules/fieldCatalog'
+ *
+ * const fieldCatalogStore = useFieldCatalogStore()
+ *
+ * // 提供字典 Store 给所有子组件
+ * useDictInjection(fieldCatalogStore)
+ * </script>
+ *
+ * <template>
+ *   <PlusPage :columns="columns" />
+ * </template>
+ * ```
+ *
+ * ```ts
+ * // 子组件中使用 autoDict
+ * const columns: PlusColumn[] = [
+ *   {
+ *     label: '状态',
+ *     prop: 'status',
+ *     valueType: 'select',
+ *     autoDict: true  // 自动从父组件注入的 dictStore 获取
+ *   }
+ * ]
+ * ```
+ */
+export declare function useDictInjection(dictStore: DictStoreInterface): void;

package/es/hooks/useDictInjection.mjs

@@ -0,0 +1,18 @@
+import { provide } from 'vue';
+import { DictStoreInjectionKey } from '../constants/dict.mjs';
+
+function useDictInjection(dictStore) {
+  if (!dictStore) {
+    console.warn("[yc-components] useDictInjection: dictStore is required");
+    return;
+  }
+  if (typeof dictStore.getDictData !== "function") {
+    console.error(
+      "[yc-components] useDictInjection: dictStore must implement getDictData method. Please ensure your dictStore implements DictStoreInterface."
+    );
+    return;
+  }
+  provide(DictStoreInjectionKey, dictStore);
+}
+
+export { useDictInjection };

package/es/hooks/useGetOptions.mjs

@@ -1,4 +1,5 @@
-import { ref, isRef, isReactive, watch } from 'vue';
+import { ref, inject, isRef, isReactive, watch } from 'vue';
+import { DictStoreInjectionKey } from '../constants/dict.mjs';
 import { isPlainObject, isArray, isFunction, isPromise, toRawType } from '../components/utils/is.mjs';
 
 const throwError = (data) => {
@@ -27,27 +28,53 @@ const getOptionsByOptionsMap = (options, props) => {
 const useGetOptions = (props) => {
   const options = ref([]);
   const optionsIsReady = ref(false);
-  if (!props.options) {
+  const injectedDictStore = inject(DictStoreInjectionKey, null);
+  const hasValidOptions = props.options && (!isArray(props.options) || props.options.length > 0);
+  if (hasValidOptions) {
+    handleOptions();
+  } else if (props.autoDict) {
+    handleAutoDict();
+  } else {
     options.value = [];
     optionsIsReady.value = true;
-  } else if (isRef(props.options) || isReactive(props.options) || isArray(props.options)) {
-    watch(
-      () => props.options,
-      (val) => {
-        const value = isRef(val) ? val.value : val;
-        options.value = getOptionsByOptionsMap(value, props);
+  }
+  function handleOptions() {
+    if (!props.options) {
+      options.value = [];
+      optionsIsReady.value = true;
+      return;
+    }
+    if (isRef(props.options) || isReactive(props.options) || isArray(props.options)) {
+      watch(
+        () => props.options,
+        (val) => {
+          const value = isRef(val) ? val.value : val;
+          options.value = getOptionsByOptionsMap(value, props);
+          optionsIsReady.value = true;
+        },
+        {
+          immediate: true,
+          deep: true
+        }
+      );
+    } else if (isFunction(props.options)) {
+      const getValue = props.options;
+      const result = getValue(props);
+      if (isPromise(result)) {
+        result.then((value) => {
+          options.value = getOptionsByOptionsMap(value, props);
+          optionsIsReady.value = true;
+          throwError(options.value);
+        }).catch((err) => {
+          throw err;
+        });
+      } else {
+        options.value = getOptionsByOptionsMap(result, props);
         optionsIsReady.value = true;
-      },
-      {
-        immediate: true,
-        deep: true
       }
-    );
-  } else if (isFunction(props.options)) {
-    const getValue = props.options;
-    const result = getValue(props);
-    if (isPromise(result)) {
-      result.then((value) => {
+    } else if (isPromise(props.options)) {
+      const getValue = props.options;
+      getValue.then((value) => {
         options.value = getOptionsByOptionsMap(value, props);
         optionsIsReady.value = true;
         throwError(options.value);
@@ -55,21 +82,82 @@ const useGetOptions = (props) => {
         throw err;
       });
     } else {
-      options.value = getOptionsByOptionsMap(result, props);
       optionsIsReady.value = true;
+      throwError(props.options);
     }
-  } else if (isPromise(props.options)) {
-    const getValue = props.options;
-    getValue.then((value) => {
-      options.value = getOptionsByOptionsMap(value, props);
+  }
+  function handleAutoDict() {
+    if (isFunction(props.autoDict)) {
+      const autoDictFn = props.autoDict;
+      watch(
+        () => {
+          return autoDictFn(props);
+        },
+        (result) => {
+          if (isPromise(result)) {
+            result.then((value) => {
+              options.value = getOptionsByOptionsMap(value, props);
+              optionsIsReady.value = true;
+            }).catch((err) => {
+              console.error("[yc-components] autoDict function error:", err);
+              options.value = [];
+              optionsIsReady.value = true;
+            });
+          } else {
+            options.value = getOptionsByOptionsMap(result, props);
+            optionsIsReady.value = true;
+          }
+        },
+        { immediate: true }
+      );
+    } else if (typeof props.autoDict === "object" && props.autoDict !== null) {
+      const { store, method = "getDictData", transform, dictCode } = props.autoDict;
+      const dictStore = store || injectedDictStore;
+      const fieldOrCode = dictCode || props.prop;
+      if (dictStore && isFunction(dictStore[method])) {
+        watch(
+          () => dictStore[method](fieldOrCode),
+          (val) => {
+            try {
+              const data = transform && isFunction(transform) ? transform(val) : val;
+              options.value = getOptionsByOptionsMap(data, props);
+              optionsIsReady.value = true;
+            } catch (err) {
+              console.error("[yc-components] autoDict transform error:", err);
+              options.value = [];
+              optionsIsReady.value = true;
+            }
+          },
+          { immediate: true }
+        );
+      } else {
+        console.warn(
+          `[yc-components] autoDict: DictStore or method "${method}" not found for field "${fieldOrCode}"`
+        );
+        options.value = [];
+        optionsIsReady.value = true;
+      }
+    } else if (props.autoDict === true) {
+      if (injectedDictStore && isFunction(injectedDictStore.getDictData)) {
+        watch(
+          () => injectedDictStore.getDictData(props.prop),
+          (val) => {
+            options.value = getOptionsByOptionsMap(val, props);
+            optionsIsReady.value = true;
+          },
+          { immediate: true }
+        );
+      } else {
+        console.warn(
+          `[yc-components] autoDict: DictStore not provided via inject for field "${props.prop}". Please use useDictInjection() in parent component.`
+        );
+        options.value = [];
+        optionsIsReady.value = true;
+      }
+    } else {
+      options.value = [];
       optionsIsReady.value = true;
-      throwError(options.value);
-    }).catch((err) => {
-      throw err;
-    });
-  } else {
-    optionsIsReady.value = true;
-    throwError(props.options);
+    }
   }
   return { customOptions: options, customOptionsIsReady: optionsIsReady };
 };