@fangzhongya/fang-ui 0.1.38 → 0.1.40

package/dist/directives/stick/index.js

@@ -3,12 +3,6 @@ import { pressEvent } from "@fangzhongya/utils/dom/getShiftEvent";
 import { attrValueSort } from "@fangzhongya/utils/basic/object/attrValueSort";
 function setDom(dom, el, value) {
   if (dom) {
-    let getDirection = function(obj2) {
-      return attrValueSort(
-        obj2,
-        value.directions || ["left", "right", "top", "bottom"]
-      )[0];
-    };
     const obj = {
       position: "fixed",
       display: "flex",
@@ -21,6 +15,12 @@ function setDom(dom, el, value) {
     obj[key] = "0";
     obj["flex-direction"] = key == "left" || key == "right" ? "column" : "row";
     setCss(el, obj);
+    const getDirection = (obj2) => {
+      return attrValueSort(
+        obj2,
+        value.directions || ["left", "right", "top", "bottom"]
+      )[0];
+    };
     const bodyStyle = document.body.style;
     const cursor = bodyStyle.cursor;
     const setValue = (event) => {
@@ -28,8 +28,8 @@ function setDom(dom, el, value) {
       key = getDirection({
         left: event.clientX,
         top: event.clientY,
-        right: window.innerWidth - event.clientX,
-        bottom: window.innerHeight - event.clientY
+        right: globalThis.innerWidth - event.clientX,
+        bottom: globalThis.innerHeight - event.clientY
       });
       setCss(el, {
         [key]: "0",
@@ -59,6 +59,11 @@ function setDom(dom, el, value) {
 }
 const vStick = {
   name: "Stick",
+  /**
+   * Vue指令的mounted钩子函数，用于在元素挂载时设置DOM相关属性
+   * @param el - 指令绑定的DOM元素
+   * @param binding - 指令绑定的相关信息对象
+   */
   mounted(el, binding) {
     const value = binding.value;
     let dom;

package/dist/hooks/attrs-default/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * 获取全局配置参数设置默认属性
- * @param key
- * @param attrs
- * @returns
+ * 根据全局配置决定是否使用默认属性值合并
+ *
+ * @param key - 配置项的键名，用于从默认配置中获取对应默认值
+ * @param attrs - 当前传入的属性对象，将与默认值进行合并
+ * @returns 如果全局配置禁用默认属性则直接返回原属性对象，否则返回合并后的属性对象
  */
 export declare function useAttrsDefault<T extends Record<string | symbol, unknown>>(key: string, attrs: T): T;

package/dist/hooks/compons/index.d.ts

@@ -2,6 +2,19 @@ import { Component } from 'vue';
 type Compons = {
     [key: string]: Component;
 };
+/**
+ * 自定义组合式API函数，用于处理组件合并和提供注入功能
+ * @param key - 用于provide/inject的键值，默认使用comkey常量
+ * @param props - 组件属性对象，包含isCompons和compons属性
+ * @param arrs - 可变参数数组，包含需要合并的组件配置
+ * @returns 返回合并后的组件对象
+ */
 export declare function useCompons(key: string | undefined, props: ObjAny, ...arrs: Compons[]): Compons;
+/**
+ * 获取组件配置信息的自定义Hook函数
+ * @param key - 用于注入依赖的键名，默认值为comkey常量
+ * @param value - 默认的组件配置对象，默认为空对象
+ * @returns 返回合并后的组件配置对象
+ */
 export declare function useComponsGet(key?: string, value?: Compons): Compons;
 export {};

package/dist/hooks/cssname/index.cjs

@@ -27,7 +27,7 @@ function getName() {
     return "";
   }
 }
-function connected(block, blockSuffix, element, modifier) {
+function connected(block = "", blockSuffix, element, modifier) {
   let cls = block;
   if (blockSuffix) {
     cls += `${com.common}${blockSuffix}`;

package/dist/hooks/cssname/index.d.ts

@@ -1,6 +1,27 @@
+/**
+ * 根据BEM命名规范生成CSS类名
+ * @param block - 组件名称，作为类名的基础部分
+ * @param blockSuffix - 子样式名称，可选参数，用于扩展组件基础样式
+ * @param element - 元素名称，可选参数，表示组件内的元素，使用下标样式(__)连接
+ * @param modifier - 修饰符名称，可选参数，表示组件或元素的不同状态，使用后缀样式(--)连接
+ * @returns 返回按照BEM规范组合生成的完整CSS类名字符串
+ */
 declare function connected(// 组件名称
-block: string, blockSuffix?: string, element?: string, modifier?: string): string;
+block?: string, blockSuffix?: string, element?: string, modifier?: string): string;
+/**
+ * 获取组件的完整类名
+ * @param block - 组件名称
+ * @param blockSuffix - 子样式名称
+ * @param element - 下标样式 __
+ * @param modifier - 后缀样式 --
+ * @returns 完整的类名字符串
+ */
 declare function getClassName(block: string, blockSuffix?: string, element?: string, modifier?: string): string;
+/**
+ * 自定义 Hook，用于生成 CSS 类名和相关样式变量。
+ * @param block - 基础模块名称，通常表示一个组件或功能块。
+ * @returns 返回一组工具函数和属性，用于构建符合 BEM 规范的类名及 CSS 变量。
+ */
 export declare const useCssName: (block: string) => {
     name: string;
     cn: typeof getClassName;

package/dist/hooks/cssname/index.js

@@ -25,7 +25,7 @@ function getName() {
     return "";
   }
 }
-function connected(block, blockSuffix, element, modifier) {
+function connected(block = "", blockSuffix, element, modifier) {
   let cls = block;
   if (blockSuffix) {
     cls += `${com.common}${blockSuffix}`;

package/dist/hooks/default-config/index.d.ts

@@ -1,2 +1,12 @@
+/**
+ * 设置默认配置的自定义hook函数
+ * @param key - 配置项的键名或包含多个配置项的对象
+ * @param keys - 子配置项的键名或包含多个子配置项的对象，默认为空对象
+ * @param value - 配置项的值，可选参数
+ */
 export declare function useDefaultConfig(key: string | ObjAny, keys?: string | ObjAny, value?: any): void;
+/**
+ * 设置默认配置项
+ * @param value 配置对象，包含需要设置的默认配置项
+ */
 export declare function useDefaultConfigs(value: ObjAny): void;

package/dist/hooks/expose/index.cjs

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const useExpose = (obj, elRef) => {
   return new Proxy(obj, {
+    // 拦截属性读取操作
     get: (target, key) => {
       var _a;
       if (key in target) return target[key];
       return (_a = elRef.value) == null ? void 0 : _a[key];
     },
+    // 拦截 in 操作符，判断属性是否存在
     has: (target, key) => {
       if (key in target) return true;
       return key in (elRef.value || {});

package/dist/hooks/expose/index.d.ts

@@ -1,2 +1,8 @@
 import { Ref } from 'vue';
+/**
+ * 创建一个代理对象，用于暴露目标对象和元素引用的属性
+ * @param obj - 目标对象，优先访问此对象的属性
+ * @param elRef - 元素引用，当目标对象中不存在属性时，会尝试从该引用的value中查找
+ * @returns 返回一个代理对象，可以同时访问目标对象和元素引用中的属性
+ */
 export declare const useExpose: (obj: ObjAny, elRef: Ref) => ObjAny;

package/dist/hooks/expose/index.js

@@ -1,10 +1,12 @@
 const useExpose = (obj, elRef) => {
   return new Proxy(obj, {
+    // 拦截属性读取操作
     get: (target, key) => {
       var _a;
       if (key in target) return target[key];
       return (_a = elRef.value) == null ? void 0 : _a[key];
     },
+    // 拦截 in 操作符，判断属性是否存在
     has: (target, key) => {
       if (key in target) return true;
       return key in (elRef.value || {});

package/dist/hooks/full-screen/index.d.ts

@@ -1,4 +1,10 @@
 import { Ref } from 'vue';
+/**
+ * 提供全屏控制功能的组合式函数（Composable）
+ *
+ * 返回一组用于控制页面或元素全屏状态的方法和响应式数据。
+ * 支持现代浏览器及部分旧版浏览器（如 IE、Firefox、Safari）的全屏 API 兼容处理。
+ */
 export declare function useFullscreen(): {
     isFullscreen: Ref<boolean, boolean>;
     enter: (el?: HTMLElement) => Promise<void>;

package/dist/hooks/global-config/index.d.ts

@@ -8,6 +8,22 @@ export declare function useGlobalConfig(): Ref<DataProps>;
  * @param obj
  * @param key
  */
+/**
+ * 设置全局配置项
+ * @param obj - 配置对象或配置项的值
+ * @param key - 配置项的键名，可选参数
+ */
 export declare function setGlobalConfig(obj: DataProps | DataProps[keyof DataProps], key?: keyof DataProps): void;
+/**
+ * 设置全局配置对象
+ * @param obj - 包含配置数据的对象
+ */
 export declare function setGlobalConfigs(obj: DataProps): void;
+/**
+ * 提供全局配置功能，用于在应用中设置和合并全局配置
+ * @param config - 要提供的配置数据，可以是响应式引用或普通对象
+ * @param app - 可选的应用实例，用于提供配置到特定应用上下文
+ * @param global - 是否设置为全局配置，默认为false
+ * @returns 返回计算属性，包含合并后的配置值
+ */
 export declare function provideGlobalConfig(config: MaybeRef<DataProps>, app?: App, global?: boolean): ComputedRef<Readonly<DataProps>>;

package/dist/hooks/inherit/index.cjs

@@ -18,11 +18,13 @@ const useInherit = (attrs = vue.useAttrs(), name) => {
     }
   }
   return {
+    // root代理：普通属性访问代理
     root: new Proxy(root, {
       get(_target, k) {
         return _target[k];
       }
     }),
+    // assem代理：具有特殊属性访问逻辑的代理
     assem: new Proxy(assem, {
       get(_target, k) {
         if (k == "__B") {

package/dist/hooks/inherit/index.d.ts

@@ -3,6 +3,14 @@ export interface Assem {
     __B: (key: string) => boolean;
 }
 type Data = Record<string | symbol, unknown>;
+/**
+ * 自定义hook，用于继承和处理组件属性
+ * @param attrs - 组件属性对象，默认使用useAttrs()获取
+ * @param name - 组件名称，可选参数
+ * @returns 返回包含root和assem两个代理对象的结果对象
+ *          root: 包含根属性的对象
+ *          assem: 包含其他属性的对象，具有特殊的属性访问逻辑
+ */
 export declare const useInherit: (attrs?: {
     [x: string]: unknown;
 }, name?: string) => {

package/dist/hooks/inherit/index.js

@@ -16,11 +16,13 @@ const useInherit = (attrs = useAttrs(), name) => {
     }
   }
   return {
+    // root代理：普通属性访问代理
     root: new Proxy(root, {
       get(_target, k) {
         return _target[k];
       }
     }),
+    // assem代理：具有特殊属性访问逻辑的代理
     assem: new Proxy(assem, {
       get(_target, k) {
         if (k == "__B") {

package/dist/hooks/locale/index.d.ts

@@ -1,8 +1,24 @@
 import { Locale, Translator } from '../../types/locale';
 import { MaybeRef } from '../../types/hooks';
 import { ComputedRef, Ref } from 'vue';
+/**
+ * 构建一个翻译器函数
+ * @param locale - 包含语言环境数据的响应式引用对象
+ * @returns 返回一个翻译函数，该函数可以根据路径获取对应的翻译文本并支持参数替换
+ */
 export declare function buildTranslator(locale: MaybeRef<Locale>): Translator;
+/**
+ * 构建一个用于拼接本地化字符串的函数
+ * @param locale 本地化数据对象，可能为响应式引用
+ * @param lang 语言标识的计算属性引用
+ * @returns 返回一个函数，该函数接收多个字符串参数并根据语言设置拼接对应的本地化值
+ */
 export declare function buildLocaleAdd(locale: MaybeRef<Locale>, lang: ComputedRef<string>): (...arr: string[]) => string;
+/**
+ * 构建本地化上下文对象
+ * @param locale - 本地化配置信息，可以是响应式引用或普通对象
+ * @returns 包含语言信息和本地化相关方法的上下文对象
+ */
 export declare function buildLocaleContext(locale: MaybeRef<Locale>): {
     lang: ComputedRef<string>;
     locale: Ref<{
@@ -29,6 +45,14 @@ export declare function buildLocaleContext(locale: MaybeRef<Locale>): {
     getLocale: Translator;
     getLocaleAdd: (...arr: string[]) => string;
 };
+/**
+ * 获取并构建本地化上下文
+ *
+ * 该函数用于根据全局配置中的locale值来构建对应的本地化上下文，
+ * 支持英文和简体中文两种语言，默认使用简体中文。
+ *
+ * @returns 返回构建好的本地化上下文对象
+ */
 export declare function useLocale(): {
     lang: ComputedRef<string>;
     locale: Ref<{

package/dist/hooks/props-default/index.d.ts

@@ -1,11 +1,20 @@
+/**
+ * 获取处理后的属性配置对象
+ *
+ * @template T - 属性对象的类型，必须是键值对形式的对象
+ * @param props - 原始属性配置对象
+ * @returns 处理后的属性配置对象，如果全局配置禁用则直接返回原对象
+ */
 export declare function getProps<T extends Record<string, any>>(props: T): T;
 /**
  * 获取全局配置参数默认参数
- * @param key
- * @param props
- * @param keyObj
- * @param dataProps
- * @returns
+ * 根据全局配置状态处理props默认值的自定义hook函数
+ *
+ * @param key - 配置项的键名，用于从默认配置中获取对应配置
+ * @param props - 原始props对象
+ * @param dataProps - 数据props，默认为空对象
+ * @param keyObj - 键值映射对象，可选参数
+ * @returns 返回处理后的props代理对象
  */
 export declare function usePropsDefault<T extends Record<string | symbol, any>>(key: string, props: T, dataProps?: ObjAny, keyObj?: ObjAny): T;
 /**

package/dist/icons/iconify.d.ts

@@ -1,5 +1,12 @@
 import { App } from 'vue';
 import { InstallOptions } from './config';
+/**
+ * 将图标配置转换为Vue组件并注册到应用中
+ * @param app - Vue应用实例，用于注册组件
+ * @param ify - 图标配置对象，包含前缀、尺寸和图标数据
+ * @param options - 安装选项，可选参数
+ * @param options.prefix - 组件名称前缀，默认使用defaultPrefix
+ */
 export declare const iconify: (app: App, ify: {
     [key: string]: any;
 }, { prefix }?: InstallOptions) => void;

package/dist/icons/iconifyCss.d.ts

@@ -1,3 +1,9 @@
+/**
+ * 将图标集数据转换为 CSS 样式字符串数组。
+ *
+ * @param ifys - 图标集对象或数组，每个元素应包含图标的前缀(prefix)和图标定义(icons)
+ * @returns 返回一个包含CSS规则字符串的数组，每个规则用于渲染对应的SVG图标
+ */
 export declare const iconifyCss: (ifys: {
     [key: string]: any;
 }) => string[];

package/dist/icons/index.json

@@ -1,7 +1,7 @@
 {
     "prefix": "fang-ui",
     "info": {},
-    "lastModified": 1764162535212,
+    "lastModified": 1764388705761,
     "icons": {
         "bar": {
             "body": " <path fill=\"currentColor\" d=\"M128 544h768a32 32 0 1 0 0-64H128a32 32 0 0 0 0 64z\" ></path> "

package/dist/index.css

@@ -49,6 +49,24 @@
   display: grid;
 }
 
+.forms-items {
+  width: 100%;
+}
+.forms-items.row {
+  display: flex;
+  flex-direction: row;
+}
+.forms-items.column {
+  display: flex;
+  flex-direction: column;
+}
+.forms-items-li.no-error {
+  --el-color-danger: var(--el-border-color);
+}
+.forms-items-li.no-error .el-input__wrapper.is-focus {
+  --el-color-danger: var(--el-input-focus-border);
+}
+
 .double {
   width: 100%;
   display: inline-flex;

package/dist/locale/en.cjs

@@ -9,7 +9,8 @@ const En = {
       delete: "Delete",
       import: "Please enter",
       select: "Please select",
-      verif: "Verification failed"
+      verif: "Verification failed",
+      all: "All"
     },
     modify: "Modify",
     close: "Close",

package/dist/locale/en.d.ts

@@ -8,6 +8,7 @@ declare const _default: {
             import: string;
             select: string;
             verif: string;
+            all: string;
         };
         modify: string;
         close: string;

package/dist/locale/en.js

@@ -7,7 +7,8 @@ const En = {
       delete: "Delete",
       import: "Please enter",
       select: "Please select",
-      verif: "Verification failed"
+      verif: "Verification failed",
+      all: "All"
     },
     modify: "Modify",
     close: "Close",

package/dist/locale/zh-cn.cjs

@@ -9,7 +9,8 @@ const ZhCn = {
       delete: "删除",
       import: "请输入",
       select: "请选择",
-      verif: "校验失败"
+      verif: "校验失败",
+      all: "全部"
     },
     modify: "修改",
     close: "关闭",

package/dist/locale/zh-cn.d.ts

@@ -8,6 +8,7 @@ declare const _default: {
             import: string;
             select: string;
             verif: string;
+            all: string;
         };
         modify: string;
         close: string;

package/dist/locale/zh-cn.js

@@ -7,7 +7,8 @@ const ZhCn = {
       delete: "删除",
       import: "请输入",
       select: "请选择",
-      verif: "校验失败"
+      verif: "校验失败",
+      all: "全部"
     },
     modify: "修改",
     close: "关闭",

package/dist/type.d.ts

@@ -67,6 +67,14 @@ type ListObj = {
 	 */
 	compon?: string | object;
 
+	/**
+	 * 组件的插槽
+	 */
+	slots?:
+		| string
+		| VNode
+		| { [key: string]: () => string | VNode | undefined };
+
 	/**
 	 * 默认值
 	 */

package/dist/utils/css.cjs

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const setObjStyle = require("@fangzhongya/utils/css/setObjStyle");
 const getCss = require("@fangzhongya/utils/css/getCss");
+function getCssNumber(str = "") {
+  return Number(String(str).replaceAll(/[^0-9.-]/g, ""));
+}
 Object.defineProperty(exports, "setObjStyle", {
   enumerable: true,
   get: () => setObjStyle.setObjStyle
@@ -10,3 +13,4 @@ Object.defineProperty(exports, "getCss", {
   enumerable: true,
   get: () => getCss.getCss
 });
+exports.getCssNumber = getCssNumber;

package/dist/utils/css.d.ts

@@ -1,2 +1,3 @@
 export { setObjStyle } from '@fangzhongya/utils/css/setObjStyle';
 export { getCss } from '@fangzhongya/utils/css/getCss';
+export declare function getCssNumber(str?: string): number;

package/dist/utils/css.js

@@ -1,6 +1,10 @@
 import { setObjStyle } from "@fangzhongya/utils/css/setObjStyle";
 import { getCss } from "@fangzhongya/utils/css/getCss";
+function getCssNumber(str = "") {
+  return Number(String(str).replaceAll(/[^0-9.-]/g, ""));
+}
 export {
   getCss,
+  getCssNumber,
   setObjStyle
 };

package/dist/utils/local.cjs

@@ -13,7 +13,8 @@ function getKey(key, isCom) {
 function setLocal(key, value = "", isCom = false) {
   try {
     localStorage.setItem(getKey(key, isCom), JSON.stringify(value));
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function getLocal(key, isCom = false) {
@@ -23,7 +24,8 @@ function getLocal(key, isCom = false) {
     if (obj && obj !== "null" && obj !== "undefined") {
       e = JSON.parse(obj);
     }
-  } catch (f) {
+  } catch (error) {
+    console.log("error", error);
   }
   return e;
 }
@@ -34,13 +36,15 @@ function clearLocal(key, isCom = false) {
     } else {
       localStorage.clear();
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function setSession(key, value = "", isCom = false) {
   try {
     sessionStorage.setItem(getKey(key, isCom), JSON.stringify(value));
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function getSession(key, isCom = false) {
@@ -50,7 +54,8 @@ function getSession(key, isCom = false) {
     if (obj && obj !== "null" && obj !== "undefined") {
       v = JSON.parse(obj);
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
   return v;
 }
@@ -61,7 +66,8 @@ function clearSession(key, isCom = false) {
     } else {
       sessionStorage.clear();
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 exports.clearLocal = clearLocal;

package/dist/utils/local.js

@@ -11,7 +11,8 @@ function getKey(key, isCom) {
 function setLocal(key, value = "", isCom = false) {
   try {
     localStorage.setItem(getKey(key, isCom), JSON.stringify(value));
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function getLocal(key, isCom = false) {
@@ -21,7 +22,8 @@ function getLocal(key, isCom = false) {
     if (obj && obj !== "null" && obj !== "undefined") {
       e = JSON.parse(obj);
     }
-  } catch (f) {
+  } catch (error) {
+    console.log("error", error);
   }
   return e;
 }
@@ -32,13 +34,15 @@ function clearLocal(key, isCom = false) {
     } else {
       localStorage.clear();
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function setSession(key, value = "", isCom = false) {
   try {
     sessionStorage.setItem(getKey(key, isCom), JSON.stringify(value));
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 function getSession(key, isCom = false) {
@@ -48,7 +52,8 @@ function getSession(key, isCom = false) {
     if (obj && obj !== "null" && obj !== "undefined") {
       v = JSON.parse(obj);
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
   return v;
 }
@@ -59,7 +64,8 @@ function clearSession(key, isCom = false) {
     } else {
       sessionStorage.clear();
     }
-  } catch (g) {
+  } catch (error) {
+    console.log("error", error);
   }
 }
 export {

package/dist/utils/util.cjs

@@ -28,23 +28,25 @@ function processFatherObject(obj, currentValue, is, row) {
     return row;
   }
   if (!obj.prop) {
-    return currentValue ?? {};
+    return currentValue;
   }
   const nextValue = getNextValue(obj, currentValue);
   if (is) {
+    const rv = nextValue ?? {};
     if (obj.pars) {
-      objValue.setObjValue(currentValue, obj.prop, nextValue);
+      objValue.setObjValue(currentValue, obj.prop, rv);
     } else {
-      currentValue[obj.prop] = nextValue;
+      currentValue[obj.prop] = rv;
     }
+    return rv;
   }
   return nextValue;
 }
 function getNextValue(obj, currentValue) {
   if (obj.pars) {
-    return objValue.getObjValue(obj.prop, currentValue) ?? obj.default ?? {};
+    return objValue.getObjValue(obj.prop, currentValue) ?? obj.default;
   }
-  return currentValue[obj.prop] ?? obj.default ?? {};
+  return currentValue[obj.prop] ?? obj.default;
 }
 function executionMethod(fun, ...arr) {
   var _a;