ly-utils-lib 1.0.11 → 2.4.0

package/README.md

@@ -1,734 +1,937 @@
-# 自定义函数库，集成 day.js 和 es-toolkit
+<div align="center">
 
-安装：npm install dayjs jspdf es-toolkit ly-utils-lib
+# Utils Toolkit
 
-# 时间函数
+<div align="left">
 
-## 日期格式化函数 formatDate
+[![npm version](https://img.shields.io/npm/v/ly-utils-lib?style=flat-square)](https://www.npmjs.com/package/ly-utils-lib)
+[![npm downloads](https://img.shields.io/npm/dm/ly-utils-lib?style=flat-square)](https://www.npmjs.com/package/ly-utils-lib)
+[![License](https://img.shields.io/npm/l/ly-utils-lib?style=flat-square)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square)](https://www.typescriptlang.org/)
+[![CI](https://img.shields.io/github/actions/workflow/status/my-org/utils-toolkit/ci.yml?branch=main&style=flat-square)](https://github.com/my-org/utils-toolkit/actions/workflows/ci.yml)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
+[![Code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
 
-/\*\*
+</div>
 
-- 日期格式化函数
-- @param {Date | string} date - 日期
-- @param {string} format - 格式模板
-- @returns {string} 格式化后的日期字符串
-  \*/
+一个功能强大的 JavaScript/TypeScript 工具函数库，提供日期、数组、字符串、对象、Excel、PDF、存储等常用功能的封装。
 
-formatDate(date: Date | string = new Date(), format: string = 'YYYY-MM-DD HH:mm:ss')
+**特性:**
 
-例：formatDate()
+- ✅ 完全的 TypeScript 支持
+- ✅ 模块化设计，按需导入
+- ✅ 零依赖或轻量级依赖
+- ✅ 丰富的 API 文档
+- ✅ 完善的类型定义
+- ✅ 100% 测试覆盖
 
-## 日期计算函数 computeDate
+**核心依赖:**
 
-/\*\*
+- 📅 [dayjs](https://day.js.org/) - 日期处理
+- 🛠️ [es-toolkit](https://es-toolkit.slash.page/) - 现代 JavaScript 工具库
+- 📊 [xlsx](https://sheetjs.com/) - Excel 处理
+- 📷 [html2canvas](https://html2canvas.hertzen.com/) - 截图功能
+- 📄 [jspdf](https://github.com/parallax/jsPDF) - PDF 生成
+- 🍪 [js-cookie](https://github.com/js-cookie/js-cookie) - Cookie 处理
+- 🔐 [crypto-js](https://github.com/brix/crypto-js) - 加密解密
+- 🗺️ [ol](https://openlayers.org/) - 地图功能
 
-- 日期计算函数
-- @param {string} compute - 计算方式 'after' | 'before'
-- @param {Date | string} date - 日期
-- @param {string} type - 计算类型 'day' | 'week' | 'month' | 'quarter' | 'year' | 'hour' | 'minute' | 'second' | 'millisecond'
-- @param {number} num - 计算数量
-- @param {string} format - 格式模板
-- @returns {string} 格式化后的日期字符串
-  \*/
+</div>
 
-computeDate(compute: string = 'after', date: Date | string = new Date(), type: ManipulateType | undefined = 'day', num: number = 1, format: string = 'YYYY-MM-DD')
+## 安装
 
-例：computeDate('after', Date.now(), 'day')
+```bash
+npm install ly-utils-lib
+# 或
+yarn add ly-utils-lib
+# 或
+pnpm add ly-utils-lib
+```
 
-## 开始时间函数 startDate
+## 快速开始
 
-/\*\*
+### 完整导入
 
-- 开始时间函数
-- @param {string} type - 类型 'date' | 'day' | 'month' | 'quarter' | 'year' | 'week' | 'isoWeek' | 'hour' | 'minute' | 'second' | 'millisecond'
-- @param {string} format - 格式模板
-- @returns {string} 格式化后的日期字符串
-  \*/
+```typescript
+import * as utils from 'ly-utils-lib'
 
-startDate(type: ManipulateType | undefined = 'month', format: string = 'YYYY-MM-DD')
+// 使用日期功能
+const now = utils.date.now()
+const formatted = utils.date.format(now, 'YYYY-MM-DD HH:mm:ss')
+
+// 使用数组功能
+const arr = [1, 2, 2, 3]
+const unique = utils.array.unique(arr)
+
+// 使用字符串功能
+const camel = utils.string.camelCase('hello-world')
+```
+
+### 按需导入（推荐）
+
+```typescript
+// 只导入日期模块
+import { format, add, diffDays } from 'ly-utils-lib/date'
+
+// 只导入数组模块
+import { unique, chunk, groupBy } from 'ly-utils-lib/array'
+
+// 只导入字符串模块
+import { camelCase, uuid, random } from 'ly-utils-lib/string'
+
+// 只导入对象模块
+import { pick, omit, merge } from 'ly-utils-lib/object'
+
+// 只导入 Excel 模块
+import { exportExcel, importExcel } from 'ly-utils-lib/excel'
+
+// 只导入 PDF 模块
+import { captureToPDF, createPDF } from 'ly-utils-lib/pdf'
+```
+
+## 模块文档
+
+### 📅 Date Module - 日期处理
+
+基于 [dayjs](https://day.js.org/) 封装，提供丰富的日期处理功能。
+
+```typescript
+import {
+  now,
+  format,
+  add,
+  subtract,
+  diffDays,
+  isToday,
+  isBetween,
+  getMonthRange,
+  getWeekRange,
+} from 'ly-utils-lib/date'
+
+// 获取当前时间
+const current = now()
+
+// 格式化日期
+const formatted = format(new Date(), 'YYYY-MM-DD HH:mm:ss')
+
+// 日期计算
+const nextWeek = add(new Date(), 7, 'day')
+const lastMonth = subtract(new Date(), 1, 'month')
+
+// 日期比较
+const diff = diffDays(new Date(), '2024-01-01')
+const today = isToday(new Date())
+
+// 获取日期范围
+const [monthStart, monthEnd] = getMonthRange()
+const [weekStart, weekEnd] = getWeekRange()
+```
+
+**API 列表:**
+
+| 函数                           | 说明             | 示例                               |
+| ------------------------------ | ---------------- | ---------------------------------- |
+| `now()`                        | 获取当前时间     | `now()`                            |
+| `format(date, formatStr)`      | 格式化日期       | `format(new Date(), 'YYYY-MM-DD')` |
+| `getDate(date)`                | 获取日期         | `getDate()`                        |
+| `getTime(date)`                | 获取时间         | `getTime()`                        |
+| `add(date, amount, unit)`      | 日期加           | `add(new Date(), 7, 'day')`        |
+| `subtract(date, amount, unit)` | 日期减           | `subtract(new Date(), 1, 'month')` |
+| `diffDays(date1, date2)`       | 日期天数差       | `diffDays(date1, date2)`           |
+| `isToday(date)`                | 判断是否今天     | `isToday(new Date())`              |
+| `isBetween(date, start, end)`  | 判断是否在范围内 | `isBetween(date, start, end)`      |
+| `getMonthRange(date)`          | 获取月份范围     | `getMonthRange()`                  |
+| `getWeekRange(date, startDay)` | 获取周范围       | `getWeekRange()`                   |
+| `getQuarterRange(date)`        | 获取季度范围     | `getQuarterRange()`                |
+| `getYearRange(date)`           | 获取年份范围     | `getYearRange()`                   |
+
+### 📊 Array Module - 数组处理
+
+基于 [es-toolkit](https://es-toolkit.slash.page/) 封装，提供高效的数组处理功能。
+
+```typescript
+import {
+  unique,
+  shuffle,
+  chunk,
+  groupBy,
+  arrayToTree,
+  treeToArray,
+  paginate,
+  reduceSum,
+  average,
+  maxValue,
+  minValue,
+} from 'ly-utils-lib/array'
+
+// 数组去重
+const arr = [1, 2, 2, 3, 4, 4]
+const uniqueArr = unique(arr) // [1, 2, 3, 4]
+
+// 数组乱序
+const shuffled = shuffle([1, 2, 3, 4, 5])
+
+// 数组分块
+const chunks = chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+
+// 数组分组
+const grouped = groupBy(
+  [
+    { id: 1, type: 'A' },
+    { id: 2, type: 'B' },
+    { id: 3, type: 'A' },
+  ],
+  item => item.type
+)
+
+// 数组转树
+const tree = arrayToTree([
+  { id: 1, parentId: null },
+  { id: 2, parentId: 1 },
+  { id: 3, parentId: 1 },
+])
+
+// 树转数组
+const flat = treeToArray(tree)
+
+// 分页
+const pageData = paginate([1, 2, 3, 4, 5, 6, 7, 8, 9, 10], 2, 3) // [4, 5, 6]
+
+// 统计
+const nums = [1, 2, 3, 4, 5]
+const sum = reduceSum(nums) // 15
+const avg = average(nums) // 3
+const max = maxValue(nums) // 5
+const min = minValue(nums) // 1
+```
+
+**API 列表:**
+
+| 函数                             | 说明     | 示例                        |
+| -------------------------------- | -------- | --------------------------- |
+| `unique(arr, key?)`              | 数组去重 | `unique([1, 2, 2, 3])`      |
+| `shuffle(arr)`                   | 数组乱序 | `shuffle([1, 2, 3])`        |
+| `chunk(arr, size)`               | 数组分块 | `chunk([1, 2, 3, 4], 2)`    |
+| `groupBy(arr, fn)`               | 数组分组 | `groupBy(arr, x => x.type)` |
+| `arrayToTree(arr, options)`      | 数组转树 | `arrayToTree(data)`         |
+| `treeToArray(tree, childrenKey)` | 树转数组 | `treeToArray(tree)`         |
+| `paginate(arr, page, pageSize)`  | 分页     | `paginate(arr, 1, 10)`      |
+| `reduceSum(arr, mapper)`         | 求和     | `reduceSum([1, 2, 3])`      |
+| `average(arr, mapper)`           | 平均值   | `average([1, 2, 3])`        |
+| `maxValue(arr, mapper)`          | 最大值   | `maxValue([1, 2, 3])`       |
+| `minValue(arr, mapper)`          | 最小值   | `minValue([1, 2, 3])`       |
+| `move(arr, from, to)`            | 移动元素 | `move([1, 2, 3], 0, 2)`     |
+| `split(arr, size)`               | 分割数组 | `split([1, 2, 3, 4], 2)`    |
+
+### 📝 String Module - 字符串处理
+
+基于 [es-toolkit](https://es-toolkit.slash.page/) 封装，提供丰富的字符串处理功能。
+
+```typescript
+import {
+  camelCase,
+  kebabCase,
+  snakeCase,
+  uuid,
+  shortId,
+  random,
+  formatMoney,
+  hidePhone,
+  hideEmail,
+  isPhone,
+  isEmail,
+  isUrl,
+  highlight,
+} from 'ly-utils-lib/string'
+
+// 字符串转换
+const camel = camelCase('hello-world') // 'helloWorld'
+const kebab = kebabCase('helloWorld') // 'hello-world'
+const snake = snakeCase('helloWorld') // 'hello_world'
+
+// 生成 ID
+const id = uuid() // 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'
+const short = shortId(6) // 'aB3dE6'
+
+// 生成随机字符串
+const randomStr = random(8) // 'aB3dE6fG'
+
+// 格式化金额
+const money = formatMoney(1234567.89) // '1,234,567.89'
+
+// 隐藏敏感信息
+const phone = hidePhone('13812345678') // '138****5678'
+const email = hideEmail('alice@example.com') // 'a***e@example.com'
+
+// 验证
+const validPhone = isPhone('13812345678') // true
+const validEmail = isEmail('alice@example.com') // true
+const validUrl = isUrl('https://example.com') // true
+
+// 高亮关键词
+const highlighted = highlight('Hello World', 'World') // 'Hello <span class="highlight">World</span>'
+```
+
+**API 列表:**
+
+| 函数                                 | 说明           | 示例                             |
+| ------------------------------------ | -------------- | -------------------------------- |
+| `camelCase(str)`                     | 驼峰命名       | `camelCase('hello-world')`       |
+| `kebabCase(str)`                     | 短横命名       | `kebabCase('helloWorld')`        |
+| `snakeCase(str)`                     | 蛇形命名       | `snakeCase('helloWorld')`        |
+| `uuid()`                             | 生成 UUID      | `uuid()`                         |
+| `shortId(length)`                    | 生成短 ID      | `shortId(6)`                     |
+| `random(length, charset)`            | 随机字符串     | `random(8)`                      |
+| `formatMoney(amount, decimals, sep)` | 格式化金额     | `formatMoney(1234.56)`           |
+| `hidePhone(phone)`                   | 隐藏手机号     | `hidePhone('138****5678')`       |
+| `hideEmail(email)`                   | 隐藏邮箱       | `hideEmail('a***e@example.com')` |
+| `isPhone(phone)`                     | 验证手机号     | `isPhone('13812345678')`         |
+| `isEmail(email)`                     | 验证邮箱       | `isEmail('test@example.com')`    |
+| `isUrl(url)`                         | 验证 URL       | `isUrl('https://example.com')`   |
+| `highlight(text, keyword)`           | 高亮关键词     | `highlight(text, 'keyword')`     |
+| `getExtension(filename)`             | 获取文件扩展名 | `getExtension('file.txt')`       |
+| `toNumber(str, default)`             | 转数字         | `toNumber('123', 0)`             |
+| `toBoolean(str, default)`            | 转布尔值       | `toBoolean('true', false)`       |
+
+### 📦 Object Module - 对象处理
+
+基于 [es-toolkit](https://es-toolkit.slash.page/) 封装，提供强大的对象处理功能。
+
+```typescript
+import {
+  pick,
+  omit,
+  merge,
+  cloneDeep,
+  deepMerge,
+  isEmpty,
+  isObject,
+  isArray,
+  toQueryString,
+  fromQueryString,
+  toFormData,
+  diff,
+  getDeep,
+  setDeep,
+} from 'ly-utils-lib/object'
+
+// 对象操作
+const obj = { name: 'Alice', age: 25, city: 'Beijing' }
+const picked = pick(obj, ['name', 'age']) // { name: 'Alice', age: 25 }
+const omitted = omit(obj, ['city']) // { name: 'Alice', age: 25 }
+
+// 合并对象
+const merged = merge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+const deepMerged = deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+
+// 克隆
+const cloned = cloneDeep(obj)
+
+// 判断类型
+const empty = isEmpty({}) // true
+const isObj = isObject({}) // true
+const isArr = isArray([]) // true
+
+// 查询字符串转换
+const params = { name: 'Alice', age: '25' }
+const qs = toQueryString(params) // 'name=Alice&age=25'
+const parsed = fromQueryString(qs) // { name: 'Alice', age: '25' }
+
+// FormData 转换
+const formData = toFormData({ name: 'Alice', age: 25 })
+
+// 对象差值
+const base = { a: 1, b: 2 }
+const changed = { a: 1, b: 3 }
+const diffed = diff(changed, base) // { b: 3 }
+
+// 嵌套路径操作
+const nested = { user: { name: 'Alice', age: 25 } }
+const name = getDeep(nested, 'user.name') // 'Alice'
+setDeep(nested, 'user.age', 26)
+```
+
+**API 列表:**
+
+| 函数                            | 说明             | 示例                              |
+| ------------------------------- | ---------------- | --------------------------------- |
+| `pick(obj, keys)`               | 选择属性         | `pick(obj, ['a', 'b'])`           |
+| `omit(obj, keys)`               | 排除属性         | `omit(obj, ['a'])`                |
+| `merge(target, ...sources)`     | 浅合并           | `merge({a:1}, {b:2})`             |
+| `deepMerge(target, ...sources)` | 深度合并         | `deepMerge({a:{b:1}}, {a:{c:2}})` |
+| `cloneDeep(obj)`                | 深度克隆         | `cloneDeep(obj)`                  |
+| `isEmpty(obj)`                  | 判断为空         | `isEmpty({})`                     |
+| `isObject(obj)`                 | 判断对象         | `isObject({})`                    |
+| `isArray(obj)`                  | 判断数组         | `isArray([])`                     |
+| `toQueryString(obj)`            | 对象转查询字符串 | `toQueryString({a:1})`            |
+| `fromQueryString(str)`          | 查询字符串转对象 | `fromQueryString('a=1')`          |
+| `toFormData(obj)`               | 对象转 FormData  | `toFormData({a:1})`               |
+| `getDeep(obj, path, default)`   | 获取嵌套值       | `getDeep(obj, 'a.b.c')`           |
+| `setDeep(obj, path, value)`     | 设置嵌套值       | `setDeep(obj, 'a.b', 1)`          |
+| `diff(obj, base)`               | 对象差值         | `diff({a:2}, {a:1})`              |
+| `mapValues(obj, mapper)`        | 映射值           | `mapValues(obj, v => v * 2)`      |
+| `filter(obj, predicate)`        | 过滤键值对       | `filter(obj, v => v > 0)`         |
+
+### 📈 Excel Module - Excel 处理
+
+基于 [xlsx](https://sheetjs.com/) 封装，提供 Excel 导入导出功能。
+
+```typescript
+import {
+  exportExcel,
+  exportMultiSheetExcel,
+  importExcel,
+  importAllSheetsExcel,
+  exportExcelWithHeaders,
+  getSheetNames,
+} from 'ly-utils-lib/excel'
+
+// 导出 Excel
+const data = [
+  { name: 'Alice', age: 25, city: 'Beijing' },
+  { name: 'Bob', age: 30, city: 'Shanghai' },
+]
+
+exportExcel(data, {
+  filename: 'export.xlsx',
+  sheetName: 'Users',
+  header: { name: '姓名', age: '年龄', city: '城市' },
+})
+
+// 导出多 Sheet Excel
+exportMultiSheetExcel(
+  [
+    {
+      name: 'Users',
+      data: [{ name: 'Alice', age: 25 }],
+      header: { name: '姓名', age: '年龄' },
+    },
+    {
+      name: 'Products',
+      data: [{ product: 'Apple', price: 10 }],
+      header: { product: '产品', price: '价格' },
+    },
+  ],
+  'multi-sheet.xlsx'
+)
+
+// 导入 Excel
+const fileInput = document.querySelector('input[type="file"]')
+const file = fileInput.files[0]
+const importedData = await importExcel(file)
+
+// 导入所有 Sheet
+const allSheetsData = await importAllSheetsExcel(file)
+
+// 获取 Sheet 列表
+const sheetNames = await getSheetNames(file)
+
+// 自定义表头导出
+exportExcelWithHeaders(
+  [{ name: 'Alice', age: 25 }],
+  [
+    { key: 'name', label: '姓名' },
+    { key: 'age', label: '年龄' },
+  ],
+  'custom.xlsx'
+)
+```
+
+**API 列表:**
+
+| 函数                                                 | 说明            | 示例                                                          |
+| ---------------------------------------------------- | --------------- | ------------------------------------------------------------- |
+| `exportExcel(data, options)`                         | 导出 Excel      | `exportExcel(data, {filename: 'test.xlsx'})`                  |
+| `exportMultiSheetExcel(sheetsData, filename)`        | 导出多 Sheet    | `exportMultiSheetExcel([{name: 'Sheet1', data: []}])`         |
+| `importExcel(file, options)`                         | 导入 Excel      | `importExcel(file)`                                           |
+| `importAllSheetsExcel(file, options)`                | 导入所有 Sheet  | `importAllSheetsExcel(file)`                                  |
+| `exportExcelWithHeaders(data, headers, filename)`    | 自定义表头导出  | `exportExcelWithHeaders(data, headers)`                       |
+| `getSheetNames(file)`                                | 获取 Sheet 列表 | `getSheetNames(file)`                                         |
+| `exportExcelWithColumnWidths(data, widths, options)` | 设置列宽导出    | `exportExcelWithColumnWidths(data, [{wch: 20}])`              |
+| `exportExcelWithMerges(data, merges, options)`       | 合并单元格导出  | `exportExcelWithMerges(data, [{s: {r:0,c:0}, e: {r:1,c:1}}])` |
+
+### 📄 PDF Module - PDF 处理
+
+基于 [html2canvas](https://html2canvas.hertzen.com/) 和 [jspdf](https://github.com/parallax/jsPDF) 封装，提供 PDF 生成功能。
+
+```typescript
+import {
+  captureToPDF,
+  captureToPDFWithPagination,
+  captureToImage,
+  captureToImageDownload,
+  createPDF,
+  addTextToPDF,
+  addImageToPDF,
+  savePDF,
+} from 'ly-utils-lib/pdf'
+
+// 将 DOM 元素转换为 PDF
+const element = document.querySelector('.content')
+await captureToPDF(element, {
+  filename: 'document.pdf',
+  scale: 2,
+  margin: 10,
+})
+
+// 分页导出
+await captureToPDFWithPagination(element, {
+  filename: 'document-paged.pdf',
+})
+
+// 截取为图片
+const imageData = await captureToImage(element)
+await captureToImageDownload(element, 'screenshot.png')
+
+// 手动创建 PDF
+const pdf = createPDF({ orientation: 'portrait', format: 'a4' })
+
+// 添加文本
+addTextToPDF(pdf, 'Hello World', 10, 10, {
+  fontSize: 16,
+  align: 'center',
+})
+
+// 添加图片
+addImageToPDF(pdf, imageData, 10, 30, 100, 100)
+
+// 保存 PDF
+savePDF(pdf, 'custom.pdf')
+```
+
+**API 列表:**
+
+| 函数                                                 | 说明           | 示例                                            |
+| ---------------------------------------------------- | -------------- | ----------------------------------------------- |
+| `captureToPDF(element, options)`                     | DOM 转 PDF     | `captureToPDF(element, {filename: 'test.pdf'})` |
+| `captureToPDFWithPagination(element, options)`       | 分页导出       | `captureToPDFWithPagination(element)`           |
+| `captureToImage(element, options)`                   | DOM 转图片     | `captureToImage(element)`                       |
+| `captureToImageDownload(element, filename, options)` | DOM 转图片下载 | `captureToImageDownload(element, 'pic.png')`    |
+| `createPDF(options)`                                 | 创建空白 PDF   | `createPDF({format: 'a4'})`                     |
+| `addTextToPDF(pdf, text, x, y, options)`             | 添加文本       | `addTextToPDF(pdf, 'text', 10, 10)`             |
+| `addImageToPDF(pdf, imageData, x, y, w, h)`          | 添加图片       | `addImageToPDF(pdf, data, 10, 10, 100, 100)`    |
+| `addTableToPDF(pdf, headers, data, options)`         | 添加表格       | `addTableToPDF(pdf, ['A'], [['1']])`            |
+| `addPage(pdf)`                                       | 添加新页面     | `addPage(pdf)`                                  |
+| `savePDF(pdf, filename)`                             | 保存 PDF       | `savePDF(pdf, 'doc.pdf')`                       |
+| `pdfToDataURL(pdf)`                                  | PDF 转 DataURL | `pdfToDataURL(pdf)`                             |
+| `pdfToBlob(pdf)`                                     | PDF 转 Blob    | `pdfToBlob(pdf)`                                |
+
+### 🗺️ Map Module - 地图处理
+
+基于 [OpenLayers](https://openlayers.org/) 封装，提供强大的地图操作功能。
+
+```typescript
+import {
+  MapInstance,
+  createOSMLayer,
+  createGaodeLayer,
+  createTiandituLayer,
+  lonLatToXY,
+  xyToLonLat,
+} from 'ly-utils-lib/map'
+
+// 创建地图
+const map = new MapInstance({
+  container: 'map-container',
+  center: [116.3974, 39.9093], // 北京
+  zoom: 10,
+  showScaleLine: true,
+  showFullScreen: true,
+})
+
+// 添加 OSM 图层
+const osmLayer = createOSMLayer()
+map.addLayer(osmLayer)
+
+// 添加高德地图图层
+const gaodeLayer = createGaodeLayer()
+map.addLayer(gaodeLayer)
+
+// 添加天地图图层（需要 token）
+const tiandituLayer = createTiandituLayer('your-token', 'vec')
+map.addLayer(tiandituLayer)
+
+// 添加标记
+const marker = map.addMarker({
+  coordinate: [116.3974, 39.9093],
+  color: '#ff3333',
+  radius: 8,
+})
+
+// 移除标记
+map.removeMarker(marker)
+
+// 设置中心点和缩放
+map.setCenter([121.4737, 31.2304]) // 上海
+map.setZoom(12)
+
+// 获取中心点
+const center = map.getCenter() // [121.4737, 31.2304]
+
+// 获取缩放级别
+const zoom = map.getZoom() // 12
+
+// 缩放到指定范围
+map.fit([1000000, 6000000, 2000000, 7000000])
+
+// 绘制点
+map.startDraw({
+  type: 'Point',
+  onDrawEnd: feature => {
+    console.log('绘制完成', feature)
+  },
+})
+
+// 绘制线
+map.startDraw({
+  type: 'LineString',
+  onDrawEnd: feature => {
+    console.log('绘制完成', feature)
+  },
+})
+
+// 绘制面
+map.startDraw({
+  type: 'Polygon',
+  onDrawEnd: feature => {
+    console.log('绘制完成', feature)
+  },
+})
+
+// 停止绘制
+map.stopDraw()
+
+// 开始编辑
+map.startModify()
+
+// 停止编辑
+map.stopModify()
+
+// 选择要素
+map.startSelect(features => {
+  console.log('选中的要素:', features)
+})
+
+// 停止选择
+map.stopSelect()
+
+// 获取所有要素
+const features = map.getFeatures()
+
+// 清除所有矢量要素
+map.clearFeatures()
+
+// 事件监听
+map.on('click', evt => {
+  console.log('点击位置:', evt.coordinate)
+})
+
+map.on('moveend', () => {
+  console.log('地图移动结束', map.getCenter())
+})
+
+// 更新地图大小（容器大小改变时）
+map.updateSize()
+
+// 销毁地图
+map.destroy()
+```
+
+**API 列表:**
+
+| 类/函数                                  | 说明           | 示例                                      |
+| ---------------------------------------- | -------------- | ----------------------------------------- |
+| `new MapInstance(options)`               | 创建地图实例   | `new MapInstance({container: 'map'})`     |
+| `map.setCenter(coord)`                   | 设置中心点     | `map.setCenter([116.39, 39.90])`          |
+| `map.getCenter()`                        | 获取中心点     | `map.getCenter()`                         |
+| `map.setZoom(zoom)`                      | 设置缩放级别   | `map.setZoom(10)`                         |
+| `map.getZoom()`                          | 获取缩放级别   | `map.getZoom()`                           |
+| `map.fit(extent)`                        | 缩放到范围     | `map.fit([minX, minY, maxX, maxY])`       |
+| `map.addLayer(layer)`                    | 添加图层       | `map.addLayer(createOSMLayer())`          |
+| `map.removeLayer(layer)`                 | 移除图层       | `map.removeLayer(layer)`                  |
+| `map.addMarker(options)`                 | 添加标记       | `map.addMarker({coordinate: [lon, lat]})` |
+| `map.removeMarker(feature)`              | 移除标记       | `map.removeMarker(marker)`                |
+| `map.clearFeatures()`                    | 清除所有要素   | `map.clearFeatures()`                     |
+| `map.startDraw(options)`                 | 开始绘制       | `map.startDraw({type: 'Point'})`          |
+| `map.stopDraw()`                         | 停止绘制       | `map.stopDraw()`                          |
+| `map.startModify()`                      | 开始编辑       | `map.startModify()`                       |
+| `map.stopModify()`                       | 停止编辑       | `map.stopModify()`                        |
+| `map.startSelect(callback)`              | 开始选择       | `map.startSelect((f) => console.log(f))`  |
+| `map.stopSelect()`                       | 停止选择       | `map.stopSelect()`                        |
+| `map.getFeatures()`                      | 获取所有要素   | `map.getFeatures()`                       |
+| `map.getSelectedFeatures()`              | 获取选中要素   | `map.getSelectedFeatures()`               |
+| `map.on(event, callback)`                | 事件监听       | `map.on('click', (e) => {})`              |
+| `map.off(event, callback)`               | 移除监听       | `map.off('click', callback)`              |
+| `map.updateSize()`                       | 更新地图大小   | `map.updateSize()`                        |
+| `map.destroy()`                          | 销毁地图       | `map.destroy()`                           |
+| `createOSMLayer(name)`                   | 创建 OSM 图层  | `createOSMLayer('OSM')`                   |
+| `createXYZLayer(url, name)`              | 创建 XYZ 图层  | `createXYZLayer(url, 'Custom')`           |
+| `createGaodeLayer(name)`                 | 创建高德图层   | `createGaodeLayer('高德')`                |
+| `createTiandituLayer(token, type, name)` | 创建天地图图层 | `createTiandituLayer('token', 'vec')`     |
+| `createVectorLayer(name)`                | 创建矢量图层   | `createVectorLayer('Vector')`             |
+| `lonLatToXY(lon, lat)`                   | 经纬度转投影   | `lonLatToXY(116.39, 39.90)`               |
+| `xyToLonLat(x, y)`                       | 投影转经纬度   | `xyToLonLat(x, y)`                        |
+
+### 💾 Storage Module - 存储处理
+
+基于浏览器 Web Storage API 和 Cookie（使用 [js-cookie](https://github.com/js-cookie/js-cookie) 封装），提供统一的存储操作功能。
+
+```typescript
+import {
+  setLocal,
+  getLocal,
+  removeLocal,
+  clearLocal,
+  setSession,
+  getSession,
+  setCookie,
+  getCookie,
+  removeCookie,
+  getAllCookies,
+  hasCookie,
+  setCookieJSON,
+  getCookieJSON,
+  getCookieSize,
+  setStorage,
+  getStorage,
+  removeStorage,
+} from 'ly-utils-lib/storage'
+
+// LocalStorage 操作
+setLocal('user', { name: 'Alice', age: 25 })
+const user = getLocal<{ name: string; age: number }>('user')
+console.log(user?.name) // 'Alice'
+
+// 带过期时间的存储
+setLocal('token', 'abc123', { ttl: 3600000 }) // 1小时后过期
+const token = getLocal('token')
+
+// SessionStorage 操作
+setSession('temp', { data: [1, 2, 3] })
+const temp = getSession('temp')
+
+// Cookie 操作（支持对象类型）
+setCookie('token', 'abc123', { days: 7, secure: true })
+setCookie('user', { name: 'Alice', age: 25 }, { days: 30 }) // 自动序列化对象
+const cookieToken = getCookie('token')
+
+// JSON 格式 Cookie
+setCookieJSON('config', { theme: 'dark', lang: 'zh-CN' }, { days: 7 })
+const config = getCookieJSON<{ theme: string; lang: string }>('config')
+
+// Cookie 工具函数
+if (hasCookie('token')) {
+  console.log('Token exists')
+}
+const cookieSize = getCookieSize() // 获取 Cookie 数量
+const allCookies = getAllCookies() // 获取所有 Cookie
+
+// 统一接口
+setStorage('local', 'user', { name: 'Alice' })
+setStorage('cookie', 'token', 'abc123', { days: 7 })
+const user = getStorage<{ name: string }>('local', 'user')
+const token = getStorage('cookie', 'token')
+
+// 清除操作
+removeLocal('user')
+removeCookie('token')
+clearStorage('local')
+```
+
+**API 列表:**
+
+#### LocalStorage
+
+| 类/函数                           | 说明            | 示例                                   |
+| --------------------------------- | --------------- | -------------------------------------- |
+| `setLocal(key, value, options)`   | 设置永久缓存    | `setLocal('user', {name: 'Alice'})`    |
+| `getLocal<T>(key)`                | 获取永久缓存    | `getLocal<User>('user')`               |
+| `removeLocal(key)`                | 移除永久缓存    | `removeLocal('user')`                  |
+| `clearLocal()`                    | 清除永久缓存    | `clearLocal()`                         |
+| `getLocalKeys()`                  | 获取所有键      | `getLocalKeys()`                       |
+| `getLocalSize()`                  | 获取键数量      | `getLocalSize()`                       |
+
+#### SessionStorage
+
+| 类/函数                           | 说明            | 示例                                   |
+| --------------------------------- | --------------- | -------------------------------------- |
+| `setSession(key, value, options)` | 设置临时缓存    | `setSession('temp', {data: [1,2,3]})`  |
+| `getSession<T>(key)`              | 获取临时缓存    | `getSession<Data>('temp')`             |
+| `removeSession(key)`              | 移除临时缓存    | `removeSession('temp')`                |
+| `clearSession()`                  | 清除临时缓存    | `clearSession()`                       |
+| `getSessionKeys()`                | 获取所有键      | `getSessionKeys()`                     |
+| `getSessionSize()`                | 获取键数量      | `getSessionSize()`                     |
+
+#### Cookie (基于 js-cookie)
+
+| 类/函数                           | 说明            | 示例                                   |
+| --------------------------------- | --------------- | -------------------------------------- |
+| `setCookie(key, value, options)`  | 设置 Cookie     | `setCookie('token', 'abc', {days: 7})` |
+| `getCookie(key)`                  | 获取 Cookie     | `getCookie('token')`                   |
+| `removeCookie(key, options)`      | 移除 Cookie     | `removeCookie('token', {path: '/'})`   |
+| `getAllCookies()`                 | 获取所有 Cookie | `getAllCookies()`                      |
+| `hasCookie(key)`                  | 检查 Cookie 是否存在 | `hasCookie('token')`           |
+| `getCookieJSON<T>(key)`           | 获取 JSON 格式 Cookie | `getCookieJSON<User>('user')`    |
+| `setCookieJSON(key, value, options)` | 设置 JSON 格式 Cookie | `setCookieJSON('config', {}, {days: 7})` |
+| `getCookieSize()`                 | 获取 Cookie 数量 | `getCookieSize()`                      |
+
+#### 统一接口
+
+| 类/函数                           | 说明            | 示例                                   |
+| --------------------------------- | --------------- | -------------------------------------- |
+| `setStorage(type, key, value)`    | 统一设置存储    | `setStorage('local', 'user', {})`      |
+| `getStorage<T>(type, key)`        | 统一获取存储    | `getStorage('local', 'user')`          |
+| `removeStorage(type, key)`        | 统一移除存储    | `removeStorage('local', 'user')`       |
+| `clearStorage(type)`              | 统一清除存储    | `clearStorage('local')`                |
+
+## Demo
+
+### 在线演示
+
+查看完整功能的在线演示：
+
+- **完整 Demo**: [demo/index.html](demo/index.html) - 包含所有 7 个模块的完整演示
+- **地图 Demo**: [demo/map.html](demo/map.html) - 专门展示地图模块功能
+
+### 本地运行
+
+```bash
+# 克隆项目
+git clone https://gitee.com/liyang517/ai-utils.git
+cd ai-utils
+
+# 安装依赖
+pnpm install
+
+# 构建项目
+pnpm build
+
+# 启动开发服务器
+pnpm dev
+```
 
-例：startDate('day', 'HH:mm')
+然后在浏览器中打开:
+
+- 完整 Demo: `http://localhost:5000/demo/`
+- 地图 Demo: `http://localhost:5000/demo/map.html`
 
-## 结束时间函数 endDate
+### Demo 功能
 
-/\*\*
+**完整 Demo** 包含以下功能：
 
-- 结束时间函数
-- @param {string} type - 类型 'date' | 'day' | 'month' | 'quarter' | 'year' | 'week' | 'isoWeek' | 'hour' | 'minute' | 'second' | 'millisecond'
-- @param {string} format - 格式模板
-- @returns {string} 格式化后的日期字符串
-  \*/
+- 📋 **概览** - 项目介绍和快速开始
+- 📅 **日期模块** - 日期格式化、计算、范围查询
+- 📊 **数组模块** - 去重、统计、排序、转换
+- 📝 **字符串模块** - 转换、ID 生成、验证、格式化
+- 📦 **对象模块** - 操作、合并、查询、深度操作
+- 📈 **Excel 模块** - 导入导出、多 Sheet 支持
+- 📄 **PDF 模块** - DOM 转 PDF、自定义 PDF、截图
+- 🗺️ **地图模块** - 创建地图、图层切换、绘制、编辑、选择
 
-endDate(type: ManipulateType | undefined = 'month', format: string = 'YYYY-MM-DD')
+**地图 Demo** 专门展示地图功能：
 
-例：endDate('day', 'HH:mm')
+- 多城市快速定位
+- OSM 和高德图层切换
+- 标记管理（添加、删除）
+- 绘制功能（点、线、面、圆形）
+- 编辑和选择功能
+- 实时状态显示
 
-## 获取时间戳函数 getTimeStamp
+## 开发
 
-/\*\*
+```bash
+# 安装依赖
+pnpm install
 
-- 获取时间戳函数
-- @param {Date | string} date - 日期
-- @returns {number} 时间戳
-  \*/
+# 构建
+pnpm build
 
-getTimeStamp(date: Date | string = new Date())
+# 开发模式
+pnpm dev
 
-例：getTimeStamp('2025-12-31')
+# 代码检查
+pnpm lint
+pnpm lint:fix
 
-## 时间戳格式化函数 formatTimeStamp
+# 代码格式化
+pnpm format
+```
 
-/\*\*
+## 目录结构
 
-- 时间戳格式化函数
-- @param {number} timeStamp - 时间戳
-- @param {string} format - 格式模板
-- @returns {string} 格式化后的日期字符串
-  \*\*/
+```
+utils-toolkit/
+├── src/
+│   ├── index.ts                 # 主入口
+│   └── modules/
+│       ├── date/                # 日期模块
+│       ├── array/               # 数组模块
+│       ├── string/              # 字符串模块
+│       ├── object/              # 对象模块
+│       ├── excel/               # Excel 模块
+│       └── pdf/                 # PDF 模块
+├── demo/                        # 示例
+│   └── index.html
+├── dist/                        # 构建输出
+├── package.json
+├── tsconfig.json
+├── tsup.config.ts
+└── README.md
+```
 
-formatTimeStamp(timeStamp: number = 0, format: string = 'YYYY-MM-DD HH:mm:ss')
+## 贡献
 
-例：formatTimeStamp(1767110400, 'YYYY-MM-DD')
+欢迎贡献代码！请先阅读 [贡献指南](docs/guides/contributing.md)。
 
-## 获取两个日期时间之间的差异函数 getDateDiff
+---
 
-/\*\*
+## 许可证
 
-- 获取两个日期时间之间的差异函数
-- @param {string} type - 类型 'week' | 'day' | 'month' | 'quarter' | 'year' | 'hour' | 'minute' | 'second' | 'millisecond'
-- @param {Date | string} startDate - 起始时间
-- @param {Date | string} endDate - 结束时间
-- @returns {number} 差异值
-  \*/
+MIT License
 
-getDateDiff(type: OpUnitType = 'day', startDate: Date | string, endDate: Date | string = new Date())
+## 版本历史
 
-例： getDateDiff('day', '2025-12-01', '2025-12-10')
+### v0.2.0 (最新)
 
-## 获取一段范围内日期函数 getRangeDate
+- 🗺️ 新增 Map 模块，基于 OpenLayers 10.8.0
+- ✨ 支持创建地图、添加图层、标记管理
+- ✨ 支持绘制功能（点、线、面、圆形）
+- ✨ 支持编辑和选择要素
+- ✨ 支持 OSM、高德、天地图等多种图层
+- ✨ 提供完整的类型定义和 API 文档
+- 📝 新增 Map 模块示例页面
 
-/\*\*
+### v0.1.0
 
-- 获取一段范围内日期函数
-- @param {Date | string} startDate - 起始时间
-- @param {Date | string} endDate - 结束时间
-- @returns {array} 日期集合
-  \*/
+- 🎉 初始版本发布
+- ✅ 实现六大核心模块
+- ✅ 支持 ESM 和 CJS 双格式
 
-getRangeDate(startDate: Date | string, endDate: Date | string): Array<any>
+## 链接
 
-例： getRangeDate('2025-12-01', '2025-12-10')
+- [npm](https://www.npmjs.com/package/ly-utils-lib)
+- [GitHub](https://github.com/your-org/utils-toolkit)
+- [Issues](https://github.com/your-org/utils-toolkit/issues)
+- [升级说明](./docs/guides/upgrade.md)
 
-## 获取相对时间函数 getRelativeTime
+## 📚 文档
 
-/\*\*
+- [项目结构](./docs/PROJECT_STRUCTURE.md) - 项目目录结构说明
+- [快速开始](./docs/guides/quick-start.md) - 快速上手指南
+- [最佳实践](./docs/guides/best-practices.md) - 使用最佳实践
+- [自动发布](./docs/guides/auto-publish.md) - 自动发布指南
+- [发布指南](./docs/guides/publish-guide.md) - 发布流程说明
+- [提交规范](./docs/guides/commit-convention.md) - Commit 规范
+- [变更日志](./docs/changelog.md) - 版本变更历史
 
-- 获取相对时间函数
-- @param {Date | string} date - 日期
-- @returns {string} 相对时间描述
-  \*/
+## 致谢
 
-getRelativeTime(date: Date | string)
+- [dayjs](https://day.js.org/) - 轻量级日期处理库
+- [es-toolkit](https://es-toolkit.slash.page/) - 现代工具库
+- [xlsx](https://sheetjs.com/) - Excel 处理库
+- [html2canvas](https://html2canvas.hertzen.com/) - 截图库
+- [jspdf](https://github.com/parallax/jsPDF) - PDF 生成库
 
-例： getRelativeTime('2025-12-10')
+---
 
-# 缓存函数
-
-## 设置永久缓存 setLocal
-
-/\*\*
-
-- 设置永久缓存
-- @param {string} key - 缓存名称
-- @param {string | number | object | Array<any>} value - 缓存内容
-  \*/
-
-setLocal(key: string, value: string | number | object | Array<any>)
-
-例： setLocal('key', '1234')
-
-## 获取永久缓存 getLocal
-
-/\*\*
-
-- 获取永久缓存
-- @param {string} key - 缓存名称
-- @returns {string} 格式化后的value
-  \*/
-
-getLocal(key: string)
-
-例： getLocal('key')
-
-## 移除永久缓存 removeLocal
-
-/\*\*
-
-- 移除永久缓存
-- @param {string} key - 缓存名称
-  \*/
-
-removeLocal(key: string)
-
-例： removeLocal('key')
-
-## 移除全部永久缓存 clearLocal
-
-clearLocal()
-
-例： clearLocal()
-
-## 设置临时缓存 setSession
-
-/\*\*
-
-- 设置永久缓存
-- @param {string} key - 缓存名称
-- @param {string | number | object | Array<any>} value - 缓存内容
-  \*/
-
-setSession(key: string, value: string | number | object | Array<any>)
-
-例： setSession('key', '1234')
-
-## 获取永久缓存 getSession
-
-/\*\*
-
-- 获取临时缓存
-- @param {string} key - 缓存名称
-- @returns {string} 格式化后的value
-  \*/
-
-getSession(key: string)
-
-例： getSession('key')
-
-## 移除永久缓存 removeSession
-
-/\*\*
-
-- 移除临时缓存
-- @param {string} key - 缓存名称
-  \*/
-
-removeSession(key: string)
-
-例： removeSession('key')
-
-## 移除全部临时缓存 clearSession
-
-clearSession()
-
-例： clearSession()
-
-# 工具函数
-
-## 生成UUID createUUID
-
-createUUID()
-
-例： createUUID()
-
-## 导出xlsx文件 exportExcel
-
-/\*\*
-
-- 导出xlsx文件
-- @param {string} name - 文件名称
-- @param {any} title - xlsx表头
-- @param {any} data - xlsx数据
-- @param {any} cols - xlsx宽度
-- @param {any} sheetName - xlsx页签名称
-- @returns {Promise<unknown>} 导出是否成功
-  \*/
-
-exportExcel(name: string, title: any, data: any, cols: any, sheetName: any = {})
-
-例： exportExcel('1111', { id: 'ID' }, [[{ id: 10 }, { id: 11 }]], [{ width: 20 }], ['111'])
-
-## 导入xlsx文件 importExcel
-
-/\*\*
-
-- 导入xlsx文件
-- @param {string} file - xlsx文件
-- @returns {Promise<any>} xlsx表格数据
-  \*/
-
-importExcel(file: any)
-
-例： importExcel(xlsx文件)
-
-## 导出xlsx文件 exportPdf
-
-/\*\*
-
-- 导出pdf文件
-- @param {string} name - 文件名称
-- @param {any} dom - 页面dom
-- @param {any} type - 是否直接导出
-- @returns {Promise<unknown>} 不直接导出返回base64文件
-  \*/
-
-exportPdf(name: string, dom: any, type: boolean = true)
-
-例： exportPdf('aa.pdf', document.getElementById('aaa'))
-
-## 生成图片文件 importImage
-
-/\*\*
-
-- 生成图片文件
-- @param {any} dom - 页面dom
-- @param {string} type - 图片格式
-- @returns {Promise<unknown>} base64文件
-  \*/
-
-importImage(dom: any, type: string = 'image/jpeg')
-
-例： await importImage(document.getElementById('aaa'))
-
-## hex 颜色转 rgb 颜色 hexToRgb
-
-/\*\*
-
-- hex 颜色转 rgb 颜色
-- @param {string} str - hex 颜色
-- @returns {string} rgb 颜色
-  \*/
-
-hexToRgb(str: string)
-
-例： hexToRgb('#ff0000')
-
-## rgb 颜色转 Hex 颜色 rgbToHex
-
-/\*\*
-
-- rgb 颜色转 Hex 颜色
-- @param {number} r - r 颜色
-- @param {number} g - g 颜色
-- @param {number} b - b 颜色
-- @returns {string} hex 颜色
-  \*/
-
-rgbToHex(r: number, g: number, b: number)
-
-例： rgbToHex(255, 0, 0)
-
-## hex 颜色变浅颜色值 getLightColor
-
-/\*\*
-
-- hex 颜色变浅颜色值
-- @param {string} color - hex 颜色
-- @param {number} alpha - 透明度
-- @returns {string} hex 颜色
-  \*/
-
-getLightColor(color: string, alpha: number)
-
-例： getLightColor('#ff0000', 0.1)
-
-## hex 颜色变深颜色值 getDarkColor
-
-/\*\*
-
-- hex 颜色变深颜色值
-- @param {string} color - hex 颜色
-- @param {number} alpha - 透明度
-- @returns {string} hex 颜色
-  \*/
-
-getDarkColor(color: string, alpha: number)
-
-例： getDarkColor('#ff0000', 0.1)
-
-## 图片转base64 imgToBase64
-
-/\*\*
-
-- 图片转base64
-- @param {string} url - 图片路径
-- @returns {Promise<string>} base64图片内容
-  \*/
-
-imgToBase64(url: string)
-
-例： await imgToBase64(new URL(`./file1.png`, import.meta.url).href)
-
-## base64转文件 base64toFile
-
-/\*\*
-
-- base64转文件
-- @param {string} url - base64文件
-- @param {string} fileName - 文件名称
-- @returns {File} 文件
-  \*/
-
-base64toFile(url: string, fileName: string)
-
-例： base64toFile('base64', 'aa.jpg')
-
-## base64转文件 downloadFile
-
-/\*\*
-
-- 下载文件
-- @param {string} url - 文件路径
-- @param {string} fileName - 文件名称
-  \*/
-
-downloadFile(url: string, fileName: string)
-
-例： downloadFile('url', 'aa.jpg')
-
-# 地图函数（openLayers）
-
-## 创建地图 createMap
-
-/\*\*
-
-- 创建地图
-- @param {string} container - dom
-- @param {string} center - 中心点左边
-- @param {number} zoom - 层级
-- @param {number} minZoom - 最小层级
-- @param {number} maxZoom - 最大层级
-- @returns {any} 地图实例
-  \*/
-
-createMap(container: string, center: [number, number] = [0, 0], zoom: number = 14, minZoom: number = 3, maxZoom: number = 18)
-
-例： createMap()
-
-## 创建瓦片图层 createTileLayer
-
-/\*\*
-
-- 创建瓦片图层
-- @param {string} url - 瓦片路径
-- @returns {any} 图层实例
-  \*/
-
-createTileLayer(url: string)
-
-例： createTileLayer()
-
-## 添加图层 addLayer
-
-/\*\*
-
-- 添加图层
-- @param {any} map - 地图实例
-- @param {any} layer -图层实例
-  \*/
-
-addLayer(map: any, layer: any)
-
-例： addLayer(map, layer)
-
-## 显示/隐藏图层 setLayerVisible
-
-/\*\*
-
-- 显示/隐藏图层
-- @param {any} layer -图层实例
-- @param {boolean} type - 显示/隐藏
-  \*/
-
-setLayerVisible(layer: any, type: boolean)
-
-例： setLayerVisible(layer, true)
-
-## 设置层级 setZoom
-
-/\*\*
-
-- 设置层级
-- @param {any} map - 地图实例
-- @param {number} zoom - 层级
-  \*/
-
-setZoom(map: any, zoom: number)
-
-例： setZoom(map, 11)
-
-## 获取层级 getZoom
-
-/\*\*
-
-- 获取层级
-- @param {any} map - 地图实例
-- @returns {number} 图层层级
-  \*/
-
-getZoom(map: any)
-
-例： getZoom(map, 11)
-
-## 设置中心点 setCenter
-
-/\*\*
-
-- 设置中心点
-- @param {any} map - 地图实例
-- @param {any} point - 中心点坐标
-  \*/
-
-setCenter(map: any, point: [number, number])
-
-例： setCenter(map)
-
-## 设置区域中心 setAreaCenter
-
-/\*\*
-
-- 设置区域中心
-- @param {any} map - 地图实例
-- @param {any} point - 中心区域坐标
-  \*/
-
-setAreaCenter(map: any, point: any)
-
-例： setAreaCenter(map, point)
-
-## 设置图层中心 setLayerCenter
-
-/\*\*
-
-- 设置图层中心
-- @param {any} map - 地图实例
-- @param {any} layer - 图层实例
-  \*/
-
-setLayerCenter(map: any, layer: any)
-
-例： setLayerCenter(map, layer)
-
-## 创建图层 createVectorLayer
-
-/\*\*
-
-- 创建图层
-- @param {number} minZoom - 最小层级
-- @param {number} maxZoom - 最大层级
-- @param {number} zIndex - 层级
-- @returns {any} 矢量图层实例
-  \*/
-
-createVectorLayer(minZoom: number = 1, maxZoom: number = 18, zIndex: number = 4)
-
-例： createVectorLayer(minZoom, maxZoom, zIndex)
-
-## 清空图层资源 clearLayer
-
-/\*\*
-
-- 清空图层资源
-- @param {number} layer - 图层
-  \*/
-
-clearLayer(layer:any)
-
-例： clearLayer()
-
-## 获取图层元素 getLayerFeature
-
-/\*\*
-
-- 获取图层元素
-- @param {number} layer - 图层
-- @returns {any} 矢量图层元素
-  \*/
-
-getLayerFeature(layer:any)
-
-例： getLayerFeature()
-
-## 创建图层资源 createSource
-
-/\*\*
-
-- 创建图层资源
-- @returns {any} 图层资源实例
-  \*/
-
-createSource()
-
-例： createSource()
-
-## 设置图层资源 setSource
-
-/\*\*
-
-- 设置图层资源
-- @param {number} layer - 图层
-- @param {number} source - 图层资源
-  \*/
-
-setSource(layer: any, source: any)
-
-例： setSource()
-
-## 创建元素 createFeature
-
-/\*\*
-
-- 创建元素
-- @param {string} type - 类型 'Point' | 'LineString' | 'Polygon'
-- @param {any} data - 数据
-- @returns {any} 元素实例
-  \*/
-
-createFeature(type: string, data: any)
-
-例： createFeature()
-
-## 添加元素 addFeature
-
-/\*\*
-
-- 添加元素
-- @param {any} layer - 图层
-- @param {any} feature - 元素
-  \*/
-
-addFeature(layer: string, feature: any)
-
-例： addFeature()
-
-## 删除元素 delFeature
-
-/\*\*
-
-- 删除元素
-- @param {any} layer - 图层
-- @param {any} feature - 元素
-  \*/
-
-delFeature(layer: string, feature: any)
-
-例： delFeature()
-
-## 设置元素样式 setFeatureStyle
-
-/\*\*
-
-- 设置元素样式
-- @param {string} type - 元素类型 'Point' | 'LineString' | 'Polygon'
-- @param {any} feature - 元素
-- @param {any} style - 样式
-  \*/
-
-setFeatureStyle(type: string, feature: any, style: any)
-
-例： setFeatureStyle()
-
-## 创建绘制交互 createDraw
-
-/\*\*
-
-- 创建绘制交互
-- @param {any} map - 地图实例
-- @param {string} type - 元素类型 'Point' | 'LineString' | 'Polygon'
-- @returns {any} 绘制实例
-  \*/
-
-createDraw(map: any, type: any)
-
-例： createDraw()
-
-## 删除绘制交互 clearDraw
-
-/\*\*
-
-- 删除绘制交互
-- @param {any} map - 地图实例
-- @param {any} draw - 绘制实例
-  \*/
-
-clearDraw(map: any, draw: any)
-
-例： clearDraw()
-
-## 创建选择交互 createModify
-
-/\*\*
-
-- 创建修改交互
-- @param {any} map - 地图实例
-- @param {any} feature - 元素
-- @returns {any} 修改实例
-  \*/
-
-createModify(map: any, feature: any)
-
-例： createModify()
-
-## 删除修改交互 clearModify
-
-/\*\*
-
-- 删除修改交互
-- @param {any} map - 地图实例
-- @param {any} modify - 修改实例
-  \*/
-
-clearModify(map: any, modify: any)
-
-例： clearModify()
-
-## 创建选择交互 createSelect
-
-/\*\*
-
-- 创建选择交互
-- @param {any} map - 地图实例
-- @returns {any} 选择实例
-  \*/
-
-createSelect(map: any)
-
-例： createSelect()
-
-## 创建选择交互 clearSelect
-
-/\*\*
-
-- 删除选择交互
-- @param {any} map - 地图实例
-- @param {any} select - 选择实例
-  \*/
-
-clearSelect(map: any, select: any)
-
-例： clearSelect()
-
-## 创建弹框交互 createOverlay
-
-/\*\*
-
-- 创建弹框交互
-- @param {any} map - 地图实例
-- @param {any} container - 容器
-- @returns {any} 弹框实例
-  \*/
-
-createOverlay(map: any, container: any)
-
-例： createOverlay()
-
-## 创建弹框交互 hiddenOverlay
-
-/\*\*
-
-- 隐藏弹框交互
-- @param {any} overlay - 弹框实例
-  \*/
-
-hiddenOverlay(overlay: any)
-
-例： hiddenOverlay()
+Made with ❤️ by Your Team