@cldemo/ui-kit 1.0.0

package/docs/components/Web/Table.md

@@ -0,0 +1,78 @@
+# ClTable Table
+
+> 数据表格组件，支持排序、筛选、固定列、合计行、行展开、单选/多选
+
+- **标签名**: `<cl-table>`
+- **引入**: `import { ClTable } from '@cldemo/library'`
+
+## Props
+
+| 参数 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| className | `String` | `` | 否 |  |
+| columns | `ColumnsInfo[]` | `() => []` | 是 |  |
+| list | `Array` | `() => []` | 否 |  |
+| totalLength | `Number` | `` | 否 |  |
+| totalData | `Object` | `() => ({})` | 否 |  |
+| isServer | `Boolean` | `true` | 否 |  |
+| isParamTriggerServer | `Boolean` | `false` | 否 |  |
+| isDisabled | `Boolean` | `false` | 否 |  |
+| isLoading | `Boolean` | `true` | 否 |  |
+| isShowInitLoadIng | `Boolean` | `true` | 否 |  |
+| isPaginate | `Boolean` | `true` | 否 |  |
+| pageOffset | `Number` | `0` | 否 |  |
+| isPaginateLimit | `Boolean` | `true` | 否 |  |
+| paginateLimit | `Number` | `10` | 否 |  |
+| paginateLimitData | `Array` | `` | 否 |  |
+| isOrder | `Boolean` | `false` | 否 |  |
+| orderSort | `Array` | `() => []` | 否 |  |
+| selectValue | `String, Number` | `` | 否 |  |
+| checkedRowType | `String` | `'none'` | 否 |  |
+| isShowCheckboxAll | `Boolean` | `true` | 否 |  |
+| isScrollX | `Boolean` | `false` | 否 |  |
+| isScrollXBottom | `Boolean` | `false` | 否 |  |
+| isFixedHead | `Boolean` | `false` | 否 |  |
+| scrollY | `Number` | `-1` | 否 |  |
+| fixedColumnLeftIndex | `Number` | `-1` | 否 |  |
+| fixedColumnRightIndex | `Number` | `-1` | 否 |  |
+| isClickRowLinkage | `Boolean` | `false` | 否 |  |
+| isElastic | `Boolean` | `false` | 否 |  |
+| isElasticLoad | `Boolean` | `true` | 否 |  |
+| rowClickKeyInvalid | `String` | `'.tr-click-invalid'` | 否 |  |
+| rowClickKeyElastic | `String` | `'.tr-click-elastic'` | 否 |  |
+| elasticIconCls | `Array` | `() => []` | 否 |  |
+| elasticType | `String` | `'default'` | 否 |  |
+| elasticData | `Object` | `() => ({})` | 否 |  |
+| trIntervalNum | `Number` | `-1` | 否 |  |
+| emptyText | `String` | `` | 否 |  |
+| isHead | `Boolean` | `true` | 否 |  |
+
+## Slots
+
+| 名称 | 说明 |
+|------|------|
+| skTh | skTh 插槽 |
+| skTotal | skTotal 插槽 |
+| skTd | skTd 插槽 |
+| skTdElastic | skTdElastic 插槽 |
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| getParamInfo() |  |
+| refresh() | 刷新 |
+| getData() |  |
+| getSelectData() |  |
+| loadStart() |  |
+| loadStop() |  |
+| loadElasticStart() |  |
+| loadElasticStop() |  |
+| closeElastic() |  |
+| refreshResize() |  |
+
+## 基础用法
+
+```vue
+<cl-table></cl-table>
+```

package/docs/components/Web/Tabs.md

@@ -0,0 +1,47 @@
+# ClTabs Tabs
+
+> 标签页组件，支持选项卡切换
+
+- **标签名**: `<cl-tabs>`
+- **引入**: `import { ClTabs } from '@cldemo/library'`
+
+## Props
+
+| 参数 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| className | `String` | `` | 否 |  |
+| classContent | `String` | `` | 否 |  |
+| theme | `String` | `'default'` | 否 |  |
+| active | `String` | `` | 否 |  |
+| list | `Array` | `() => []` | 否 |  |
+| disabledData | `Array` | `() => []` | 否 |  |
+| hideData | `Array` | `() => []` | 否 |  |
+| prefixName | `String` | `` | 否 |  |
+| isShowRemove | `Boolean` | `false` | 否 |  |
+| removeReserve | `Number` | `1` | 否 |  |
+| isShowAdd | `Boolean` | `false` | 否 |  |
+| addBtnText | `String` | `` | 否 |  |
+| tabMinNum | `Number` | `1` | 否 |  |
+| tabMaxNum | `Number` | `0` | 否 |  |
+| isHideTabHead | `Boolean` | `false` | 否 |  |
+| getAddInfo | `Function` | `` | 否 |  |
+| checkChangeBefore | `Function` | `` | 否 |  |
+
+## Slots
+
+| 名称 | 说明 |
+|------|------|
+| default | 默认插槽 |
+| nav_add | nav_add 插槽 |
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| getValue() | 获取当前值 |
+
+## 基础用法
+
+```vue
+<cl-tabs></cl-tabs>
+```

package/docs/components/Web/Tree.md

@@ -0,0 +1,44 @@
+# ClTree Tree
+
+> 树形组件，支持展开/折叠、勾选、拖拽排序
+
+- **标签名**: `<cl-tree>`
+- **引入**: `import { ClTree } from '@cldemo/library'`
+
+## Props
+
+| 参数 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| value | `String` | `` | 否 |  |
+| list | `any[]` | `() => []` | 否 |  |
+| className | `String` | `` | 否 |  |
+| disabled | `Boolean` | `false` | 否 |  |
+| multiple | `Boolean` | `false` | 否 |  |
+| isSingleSelectParent | `Boolean` | `false` | 否 |  |
+| textFormat | `String` | `` | 否 |  |
+| isOutMerge | `Boolean` | `true` | 否 |  |
+| parentKey | `String` | `'parentId'` | 否 |  |
+| topParentValue | `String` | `'0'` | 否 |  |
+| shrinkColorBg | `String` | `'#FFFFFF'` | 否 |  |
+
+## Events
+
+| 事件名 | 说明 |
+|--------|------|
+| update:value |  |
+| onChange | 值改变事件 |
+| onInit | 初始化完成事件 |
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| getValue() | 获取当前值 |
+| getValueData() | 获取当前值对应的数据对象 |
+| setValue() | 设置值 |
+
+## 基础用法
+
+```vue
+<cl-tree></cl-tree>
+```

package/docs/components/Web/Weekhour.md

@@ -0,0 +1,29 @@
+# ClWeekhour Weekhour
+
+> 周小时选择器，按周和小时维度选择时间段
+
+- **标签名**: `<cl-weekhour>`
+- **引入**: `import { ClWeekhour } from '@cldemo/library'`
+
+## Props
+
+| 参数 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| value | `String` | `` | 否 |  |
+| className | `String` | `` | 否 |  |
+| disabled | `Boolean` | `false` | 否 |  |
+| isOneDay | `Boolean` | `false` | 否 |  |
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| getValue() | 获取当前值 |
+| getValueData() | 获取当前值对应的数据对象 |
+| setValue() | 设置值 |
+
+## 基础用法
+
+```vue
+<cl-weekhour></cl-weekhour>
+```

package/docs/components/Web/Xeditable.md

@@ -0,0 +1,52 @@
+# ClXeditable Xeditable
+
+> 行内编辑组件，点击文本直接编辑
+
+- **标签名**: `<cl-xeditable>`
+- **引入**: `import { ClXeditable } from '@cldemo/library'`
+
+## Props
+
+| 参数 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| className | `String` | `` | 否 |  |
+| classNameLabel | `String` | `` | 否 |  |
+| value | `String, Number` | `` | 否 |  |
+| label | `String` | `` | 否 |  |
+| subUnitOptions | `Object` | `` | 否 |  |
+| subUnitList | `Array` | `` | 否 |  |
+| submitCallback | `Function` | `` | 否 |  |
+| isUseOnSubmitCheck | `Boolean` | `false` | 否 |  |
+| appendContainer | `String` | `` | 否 |  |
+| isCheckValidate | `Boolean` | `false` | 否 |  |
+| validateRules | `Array` | `` | 否 |  |
+| checkValidateCallback | `Function` | `` | 否 |  |
+| isUseEllipsis | `Boolean` | `false` | 否 |  |
+| classNameEllipsis | `String` | `` | 否 |  |
+| isAutoTooltip | `Boolean` | `true` | 否 |  |
+| clickEditPoint | `String` | `'value'` | 否 |  |
+| isShowEditValue | `Boolean` | `true` | 否 |  |
+| isShowEditIcon | `Boolean` | `false` | 否 |  |
+| editIcon | `String` | `'clIconFont clIcon-edit'` | 否 |  |
+| isSubmitCleanValue | `Boolean` | `false` | 否 |  |
+
+## Slots
+
+| 名称 | 说明 |
+|------|------|
+| iconLabel | iconLabel 插槽 |
+| customForm | customForm 插槽 |
+| label | label 插槽 |
+| dropdown | 下拉内容插槽 |
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| setOnSubmitResult() |  |
+
+## 基础用法
+
+```vue
+<cl-xeditable></cl-xeditable>
+```

package/docs/tools/CommonAxios.md

@@ -0,0 +1,17 @@
+# CommonAxios
+
+> HTTP 请求封装：自动取消重复请求、超时重试
+
+- **引入**: `import { CommonAxios } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `initGet(options: any)` | GET 请求 |
+| `initPost(options: any)` | POST 请求（JSON 格式） |
+| `initPut(options: any)` | PUT 请求 |
+| `initDelete(options: any)` | DELETE 请求 |
+| `initFile(options: any)` | 文件上传（FormData） |
+| `initFileDownLoad(options: any)` | 文件下载（自动触发浏览器下载） |
+

package/docs/tools/CommonBase.md

@@ -0,0 +1,79 @@
+# CommonBase
+
+> 基础工具类：类型判断、JSON操作、数组/字符串格式化
+
+- **引入**: `import { CommonBase } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `getTypeof(value: any)` |  |
+| `isUndefined(value: any)` | 判断是否 undefined |
+| `isBoolean(value: any)` | 判断是否布尔值 |
+| `isString(value: any)` | 判断是否字符串 |
+| `isFunction(value: any)` | 判断是否函数 |
+| `isObject(value: any)` | 判断是否对象 |
+| `isBlob(value: any)` |  |
+| `isFile(value: any)` |  |
+| `isNumber(value: any)` | 判断是否数字（含数字格式校验） |
+| `isInt(value: number)` | 判断是否整数 |
+| `isHtml(value: string)` | 判断是否 HTML 字符串 |
+| `isJson(value: any)` | 判断是否 JSON 字符串 |
+| `isWindow(obj: any)` |  |
+| `isArray(value: any)` | 判断是否数组 |
+| `isLocationLngLat(value: any)` | 判断经纬度格式 [lng, lat] |
+| `isEmpty(value: any, def?: any)` | 判断 null/undefined/空串/空数组/空对象 |
+| `isEqual(value1: any, value2: any)` | 深度比较两个值是否相等 |
+| `isEqualArr(arr1: any[], arr2: any[], isInOrder = false)` | 比较两个数组（可选是否按顺序） |
+| `isEqualList(list1: any[], list2: any[], key = ["id"])` | 按 key 比较两个对象列表 |
+| `isContainArr(arr1: any[], arr2: any[])` | arr1 是否包含 arr2 所有元素 |
+| `isExistValue(value: any, key: string)` | 数组中是否存在指定值 |
+| `isExistJsonKey(json: any, key: string)` | JSON 中是否存在指定 key |
+| `osType()` | 返回 { isPc, isMobile, isIOS, isAndroid, isTablet } |
+| `trim(value: any)` | 去首尾空格 |
+| `split(str: string, sign = ",")` | 分割字符串（兼容中文逗号 `，` → `,`） |
+| `kebabCase(value: string)` | 大驼峰转 kebab-case |
+| `getByteLen(str: string)` | 获取字符串字节长度 |
+| `getJsonClone()` | 浅/深拷贝，opt 支持 excludeKeys |
+| `getJsonCloneByKeyArr(sourceJson: any, keyArr: string[])` | 按指定 key 克隆 |
+| `getJsonCloneByKeyJson(sourceJson: any, keyJson: any)` |  |
+| `getJsonCloneByRemoveArr(sourceJson: any, removeArr: string[])` | 去除指定 key 后克隆 |
+| `getJsonMerge(...target: any)` | 浅合并多个 JSON |
+| `getJsonReversal(json: any)` | key-value 反转 |
+| `getJsonMergeDeep(...target: any)` | 深度合并多个 JSON |
+| `getJsonMap(json: any, map: any, isDef = false)` | 按映射规则转换 JSON |
+| `getJsonByList(list: any, key?: string, isFormat = false)` | 列表转 JSON（以 key 为键） |
+| `getJsonByArr(arr: string[])` | 数组转 JSON（值为 true） |
+| `getGroupByList(list: any, key: string)` | 按 key 分组 |
+| `getJsonByBlob(blob: any)` | Blob 转 JSON |
+| `getBase64ByFile(files: any)` | File 转 Base64 |
+| `getTreeList(list: any[])` | 列表转树形结构 |
+| `getTreeLastParent(id: string, json: any, isShowSelf = true)` | 查找末级父节点链 |
+| `getListByTree()` | 树转列表 |
+| `getListClone(list: any, isDeep = false)` | 复制列表 |
+| `getListMergeDeep(newList: any[], oldList: any[], key = "id")` | 深度合并列表 |
+| `getRecursionParentList(json: any, pId: [string, number], pKey = "parentId")` | 递归获取所有父级 |
+| `getListExistValue(list: any, value: string, key = "id")` | 查找列表中指定值 |
+| `getArrClone(arr: any)` | 复制数组 |
+| `getArrByList(list: any[], key = "id")` | 提取 list 指定字段为数组 |
+| `getArrRemoveById(arr: any, ids: any)` | 按 id 移除元素 |
+| `getArrByMinMax(min = 1, max: number)` | 生成范围数组 |
+| `getArrUnique(arr: any)` | 数组去重 |
+| `getArrConvertJson(arr: any[])` | 数组转 JSON（键为数组值） |
+| `getArrAsc(arr: any, type: string)` | 升序排序（date/number/string） |
+| `getArrDesc(arr: any, type: string)` | 降序排序 |
+| `getZeroCount(len: number)` | 生成指定长度的零字符串 |
+| `getFillZero(value: any, len = 2, around = "l")` | 补零（l 左 / r 右） |
+| `getRandom(len = 3)` | 固定长度随机数 |
+| `getRandomRange(min: number, max: number, isRound = true)` | 范围随机数 |
+| `getCaptcha(len = 6)` | 生成验证码 |
+| `getValueByFormat()` | 统一格式化入口（num/int/float/float2/date/string） |
+| `getHourInterval(start: any, end: any = "")` | 小时区间格式化 |
+| `getFormatThousands(value: any)` | 千分位格式化 |
+| `getNumCeil()` | 进位/舍入处理 |
+| `removeReplace(value: any, key = ",")` | 移除字符串中指定字符 |
+| `conversionEmptyZero(json: any, mapKey: string[], optExt?: any)` | 空值转 0 |
+| `conversionPercentage(json: any, mapKey: string[], isMultiply = true)` | 百分比转换 |
+| `convertStringFormat(strFormat: string, json: any)` | `${key}` 模板替换 |
+

package/docs/tools/CommonDay.md

@@ -0,0 +1,18 @@
+# CommonDay
+
+> 日期时间工具：格式化、时区、农历、时间运算
+
+- **引入**: `import { CommonDay } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `initDay(d?: any)` | 将值转为 dayjs 时区对象 |
+| `getDayjsObject(day: any)` | 将 string/number/Date/dayjs 转为 dayjs 对象 |
+| `initFormat(options?: any)` | 格式化日期，默认格式 YYYY-MM-DD |
+| `addTime(time: any, num: number, type = "days")` | 时间加法 |
+| `subtractTime(time: any, num: number, type = "days")` | 时间减法 |
+| `diffTime(time1: any, timeDiff2: any, type = "millisecond")` | 时间差值计算 |
+| `lunar(value: string)` | 获取农历信息 |
+

package/docs/tools/CommonEchart.md

@@ -0,0 +1,19 @@
+# CommonEchart
+
+> ECharts 图表辅助：快速生成折线/柱状/散点图配置
+
+- **引入**: `import { CommonEchart } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `getBaseOptions(opts: any)` | 获取基础 ECharts option |
+| `getOptionAxis(chartParam: any)` | 获取基础坐标轴配置 |
+| `getBaseData()` | 将列表转换为图表数据 |
+| `getLineOption()` | 折线图配置 |
+| `getBarOption()` | 柱状图配置 |
+| `getScatterOption()` | 散点图配置 |
+| `getLineMultiOption()` | 多系列折线图配置 |
+| `getBarMultiOption()` | 多系列柱状图配置 |
+

package/docs/tools/CommonElement.md

@@ -0,0 +1,42 @@
+# CommonElement
+
+> DOM 元素工具：位置计算、样式操作、事件绑定
+
+- **引入**: `import { CommonElement } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `onListener(element: any, eventName: string, eventFun: any, useCapture = false)` | 添加事件监听 |
+| `offListener(element: any, eventName: string, eventFun: any, useCapture = false)` | 移除事件监听 |
+| `getTextWidth(text: string, font = "normal 12px Microsoft YaHei")` | Canvas 测量文字宽度 |
+| `getAddClass(...classs: any)` | 条件添加 CSS class（去重） |
+| `getRemoveClass(classTotal: string, classs: string)` | 移除 CSS class |
+| `checkHasClass(classTotal: string, className: string)` | 检查是否存在 CSS class |
+| `isElementHtml(el: any)` | 是否 HTML 元素 |
+| `isElementBody(el: any)` | 是否 body 元素 |
+| `getWinScrollTop()` | 获取窗口滚动量 |
+| `getWinWidth()` | 获取窗口宽度 |
+| `getWinHeight()` | 获取窗口高度 |
+| `getStyle(el: any)` | 获取元素 computed style |
+| `isHidden(element: any)` | 元素是否隐藏 |
+| `isHiddenParent(element: any)` | 父级元素是否隐藏 |
+| `getParentCheckBody(el: any, parent: any, isCheckContains = true)` | 获取父级并排除 body |
+| `getParent(el: any, parentAttr: any, elUpperLimit?: any, isLimitReturnSelf = true)` | 向上查找匹配 attr 的父级元素 |
+| `getParentList(el: any, parentAttr: any)` | 获取所有匹配父级的列表 |
+| `getParentScrollList(el: any, parentAttr: any, isContainsSelf = true)` |  |
+| `getOffset(el: any, viewEl: any = null)` | 获取相对 window/容器的偏移量 |
+| `getPositionView(el: any, viewEl: any = null)` | 获取相对指定容器的位置信息（含宽高） |
+| `getPosition(el: any, parentAttr: any = null)` | 获取相对父级的位置 |
+| `getElementIndex(el: any)` | 获取同级元素中的索引 |
+| `getPrev(el: any)` | 获取前一个同级元素 |
+| `getPrevAll(el: any)` | 获取所有前面的同级元素 |
+| `getNext(el: any)` | 获取后一个同级元素 |
+| `insertAfter(targetEl: any, newEl: any)` | 在目标元素之后插入 |
+| `getFocusSelection(targetEl: any)` | 获取输入框光标位置 |
+| `setFocusSelection(el: any, start: number, end: number)` | 设置输入框光标位置 |
+| `calculationDropdownPosition(controlEl: any, textEl: any, dropDownEl: any, arrowEl: any, containerEl: any)` | 计算下拉定位（自动判断方向） |
+| `getElementData(json: any)` |  |
+| `getClientXY(e: Event | MouseEvent | TouchEvent)` | 从 MouseEvent/TouchEvent 提取 clientX/Y |
+

package/docs/tools/CommonElementEvent.md

@@ -0,0 +1,30 @@
+# CommonElementEvent
+
+> 拖拽事件封装，兼容鼠标和触摸
+
+- **引入**: `import { CommonElementEvent } from '@cldemo/library/common'`
+
+## Drag — 拖拽事件封装，兼容鼠标和触摸
+
+```js
+new CommonElementEvent.Drag(element, {
+  start: (e, clientXYInfo) => { /* 开始 */ },
+  ing: (e, clientXYInfo) => { /* 进行中 */ },
+  end: (e, clientXYInfo) => { /* 结束 */ },
+})
+```
+
+`clientXYInfo` 包含 `{ clientX, clientY }`，同时兼容鼠标和触摸事件。
+
+## Resize — 元素缩放事件封装
+
+```js
+new CommonElementEvent.Resize(element, {
+  start: (e, clientXYInfo) => { /* 开始 */ },
+  ing: (e, clientXYInfo) => { /* 进行中 */ },
+  end: (e, clientXYInfo) => { /* 结束 */ },
+})
+```
+
+`clientXYInfo` 包含 `{ clientX, clientY }`，同时兼容鼠标和触摸事件。
+

package/docs/tools/CommonI18n.md

@@ -0,0 +1,18 @@
+# CommonI18n
+
+> 国际化语言包管理，支持中英文切换
+
+- **引入**: `import { CommonI18n } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `initMerge(options: any)` | 初始化/合并语言包 |
+| `getType()` | 获取当前语言类型 |
+| `getAll()` | 获取当前语言全部数据 |
+| `getCommon()` | 获取公共翻译数据 |
+| `getValue(key: string)` | 按 key 获取翻译文本（支持 a.b.c 路径） |
+| `getPage(key: string)` | 获取页面翻译数据（自动合并 common） |
+| `setType(type: string)` | 切换语言 |
+

package/docs/tools/CommonPromise.md

@@ -0,0 +1,16 @@
+# CommonPromise
+
+> Promise 辅助：并行执行、结果收集
+
+- **引入**: `import { CommonPromise } from '@cldemo/library/common'`
+
+## 方法
+
+| 方法 | 说明 |
+|------|------|
+| `promise(result: any)` | 将值包装为 Promise.resolve |
+| `promiseFun(callback: any)` | 创建 Promise，回调中可拿到 resolve |
+| `resolve(result: any)` | Promise.resolve 快捷调用 |
+| `all(promises: any)` | Promise.all 包装 |
+| `allByJson()` | 按 key 并行执行，返回 { result, errors } |
+

package/docs/tools/CommonTools.md

@@ -0,0 +1,43 @@
+# CommonTools
+
+> Cookie 操作（自动 JSON 解析）
+
+- **引入**: `import { CommonTools } from '@cldemo/library/common'`
+
+## Cookie — Cookie 操作（自动 JSON 解析）
+
+| 方法 | 说明 |
+|------|------|
+| `getItem(key: string)` | 读取 cookie（自动 JSON.parse） |
+| `setItem(key: string, data: any)` | 写入 cookie（自动 JSON.stringify） |
+| `removeItem(key: string)` | 删除单个 cookie |
+| `removeList(arr: string[])` | 批量删除 cookie |
+| `clearAll()` | 清除所有 cookie |
+
+## LocalStorage — localStorage 操作（自动 JSON 解析）
+
+| 方法 | 说明 |
+|------|------|
+| `getItem(key: string)` | 读取 localStorage（自动 JSON.parse） |
+| `setItem(key: string, data: any)` | 写入 localStorage（自动 JSON.stringify） |
+| `removeItem(key: string)` | 删除单个 |
+| `removeList(arr: string[])` | 批量删除 |
+| `clearAll()` | 清除全部 |
+
+## CommNumber — 高精度计算（基于 decimal.js）
+
+| 方法 | 说明 |
+|------|------|
+| `initDecimal(n: number)` | 创建 Decimal 实例 |
+| `add(n1: number, n2: number)` | 高精度加法 |
+| `sub(n1: number, n2: number)` | 高精度减法 |
+| `mul(n1: number, n2: number)` | 高精度乘法 |
+| `div(n1: number, n2: number)` | 高精度除法 |
+
+## DelayFun — 防抖函数
+
+| 方法 | 说明 |
+|------|------|
+| `stopRun()` | 取消等待中的执行 |
+| `run(cb?: any)` | 触发延迟执行 |
+

package/docs/tools/CommonTooltip.md

@@ -0,0 +1,38 @@
+# CommonTooltip
+
+> 浮层提示：基于 Popper.js，支持多种触发方式
+
+- **引入**: `import { CommonTooltip } from '@cldemo/library/common'`
+- **实例化**: `new Tooltip(...)`
+
+## 构造参数
+
+| 方法 | 说明 |
+|------|------|
+| `init()` |  |
+| `getEventType()` |  |
+| `setEventListener(eventInfo: any)` |  |
+| `listenerOn(e: any)` |  |
+| `listenerOff(e: any)` |  |
+| `show()` | 显示浮层 |
+| `operateShow()` | 执行显示逻辑（创建/更新 Popper） |
+| `createElement()` |  |
+| `setContentBody(body: string)` | 更新浮层内容 |
+| `setInitShow(isInitShow: boolean)` | 设置是否允许显示 |
+| `setContentHeader(header: string)` | 更新浮层标题 |
+| `getWrapElement()` |  |
+| `hide(e: any)` | 隐藏浮层（接收 Event 对象） |
+| `listenerRelatedMouseLeave(e: any)` |  |
+| `operateHide()` | 执行隐藏逻辑（销毁 Popper） |
+| `listenerHide()` |  |
+| `setRunTrigger(isRunTrigger: boolean)` | 设置是否响应触发 |
+| `dispose()` | 销毁实例 |
+| `clShow()` | 公开：显示浮层 |
+| `clHide()` | 公开：隐藏浮层 |
+| `clToggle()` | 公开：切换显示/隐藏 |
+| `clSetContentBody(body: string)` | 公开：更新浮层内容 |
+| `clSetContentHeader(header: string)` | 公开：更新浮层标题 |
+| `clSetRunTrigger(isRunTrigger: boolean)` | 公开：设置触发开关 |
+| `clSetInitShow(isInitShow: boolean)` | 公开：设置初始显示 |
+| `clDispose()` | 公开：销毁实例 |
+