@airpower/enum 0.0.1

package/docs/helper.md

@@ -0,0 +1,118 @@
+# 工具库
+
+**AirPower** 提供了一些常用的工具类，你可以直接使用。
+
+## CryptoUtil 编码和加解密
+
+内置了 `AES加解密`、`SHA1`、`MD5`、`Base64` 等前端常用算法，可直接使用。
+
+```typescript
+CryptoUtil.aesEncrypt()
+CryptoUtil.aesDecrypt()
+CryptoUtil.sha1()
+CryptoUtil.md5()
+CryptoUtil.base64Encode()
+CryptoUtil.base64Decode()
+```
+
+## DateTimeUtil 时间与日期
+
+提供了日期时间在前端常用的一些转换方法：
+
+```typescript
+// 休眠
+await DateTimeUtil.sleep(3000)
+
+// 格式化到Unix秒时间戳(默认当前时间)
+DateTimeUtil.getUnixTimeStamps('2022-02-02 23:59:59')
+
+// 格式化到毫秒时间戳(默认当前时间)
+DateTimeUtil.getMilliTimeStamps('2022-02-02 23:59:59')
+
+// 格式化到友好字符串显示
+DateTimeUtil.getFriendlyDateTime('2022-02-02 23:59:59') // 三天前
+
+// 使用指定的模板格式化
+DateTimeFormatter.YYYY_MM_DD_HH_mm_ss.formatXXX(xxx)
+```
+
+## DecoratorUtil 装饰器
+
+装饰器助手类提供了一些设置和读取配置项的方法：
+
+```typescript
+// 反射添加属性
+DecoratorUtil.setProperty()
+
+// 设置一个类配置项
+DecoratorUtil.setClassConfig()
+
+// 递归获取指定类的配置项
+DecoratorUtil.getClassConfig()
+
+// 设置一个属性配置项
+DecoratorUtil.setFieldConfig()
+
+// 获取类指定属性的指定类型的配置
+DecoratorUtil.getFieldConfig()
+
+// 获取类标记了装饰器的属性列表
+DecoratorUtil.getFieldList()
+
+// 获取目标类指定属性列表的配置项列表
+DecoratorUtil.getFieldConfigList()
+
+// 获取目标类上指定属性的某个配置的值
+DecoratorUtil.getFieldConfigValue()
+```
+
+## FileUtil 文件
+
+提供了一些常用文件处理方法
+
+```typescript
+// 字节数转可读文件大小
+FileUtil.getFileSizeFriendly()
+
+// 获取静态文件的绝对地址
+FileUtil.getAbsoluteFileUrl()
+```
+
+## RandomUtil 随机生成
+
+提供了一些常用随机生成方法
+
+```typescript
+// 指定范围内获取随机整数
+RandomUtil.getRandNumber()
+
+// 获取随机数字字符串
+RandomUtil.getRandNumberString()
+
+// 获取随机字母字符串
+RandomUtil.getRandCharString()
+
+// 获取大小写混合随机字母字符串
+RandomUtil.getRandMixedCharString()
+
+// 获取字母加数字随机字符串
+RandomUtil.getRandNumberAndCharString()
+
+// 获取大小写字母加数字随机字符串
+RandomUtil.getRandNumberAndMixedCharString()
+```
+
+## StringUtil 字符串常见处理
+
+提供了一些字符串处理的常见方法
+
+```typescript
+// 获取字符串可视化长度
+StringUtil.getLength()
+
+// 获取字符串可视化位置的内容
+StringUtil.get()
+
+// 字符串可视化截取
+StringUtil.slice()
+```

package/docs/i18n.md

@@ -0,0 +1,7 @@
+# 📖 i18n 国际化
+
+这个可能和你在其他地方见过的不太一样。
+
+文档先欠着吧，可以先阅读这篇文章：
+
+[i18n国际化前端解决方案引发的关于魔法值的思考](https://juejin.cn/post/7345071716680990720)

package/docs/transformer.md

@@ -0,0 +1,90 @@
+# 📖 数据转换
+
+这一篇是需要重点讲的部分。
+
+## 强制类型和数组
+
+可以通过为 `@Field` 标记 `type` 来强制类型转换。
+
+```typescript
+class User extends AirPower {
+  @Field({
+    type: Number // 强制转换为数字类型
+  })
+  age!: number
+
+  @Field({
+    type: Role // 强制是Role类型
+  })
+  role!: Role
+
+  @Field({
+    type: Department, // 强制是Department类型
+    array: true // 指定是数组
+  })
+  departmentList: Department[] = []
+}
+```
+
+那么，如果使用 `User.fromJson(json)`，那么 `json` 中的数据就会按照标记的装饰器类型进行类型转换。
+
+**请注意，如果非简单类型，一定要标记 `type`，否则无法进行递归转换**
+
+## 别名转换
+
+别名转换适用于突然属性名称的变更，如 `nickname` -> `nickName`
+
+```typescript
+class User extends AirPower {
+  @Field({
+    alias: 'nickName'
+  })
+  nickname!: string
+}
+```
+
+## 固定前缀
+
+有时候，后端提供的数据都带了统一的属性前缀：
+
+```json
+{
+  "user_id": 123,
+  "user_name": "userName",
+  "user_age": 18
+}
+```
+
+此时，我们可以通过类的装饰器 `@Model` 来配置属性前缀：
+
+```typescript
+
+@Model({
+  prefix: 'user_'
+})
+class User extends AirPower {
+  id!: number
+  name!: string
+  age!: number
+}
+```
+
+如果，其中的某个属性不需要前缀，可以通过 `@Field` 的 `ignorePrefix` 来忽略：
+
+```typescript
+
+@Model({
+  prefix: 'user_'
+})
+class User extends AirPower {
+  // 其他需要前缀的属性
+  @Field({
+    ignorePrefix: true
+  })
+  bio!: string
+}
+```
+
+## 自定义转换
+
+`@ToJson` `@ToModel` 可完成自定义转换

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@airpower/enum",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "AirPower-Enum 是一个基于 TypeScript 的封装的类似 Java 枚举类的枚举字典处理工具。",
+  "author": {
+    "name": "Hamm",
+    "email": "admin@hamm.cn",
+    "url": "https://github.com/HammCn"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/AirPowerTeam/AirPower-Enum#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AirPowerTeam/AirPower-Enum.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AirPowerTeam/AirPower-Enum/issues"
+  },
+  "keywords": [
+    "AirPower",
+    "typescript",
+    "java",
+    "enum",
+    "dictionary",
+    "oop",
+    "class"
+  ],
+  "main": "dist/main.js",
+  "module": "dist/main.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "docs"
+  ],
+  "scripts": {
+    "build": "tsc && vite build",
+    "lint": "eslint src --ext .ts",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^4.11.0",
+    "@types/node": "^22.13.14",
+    "eslint": "^9.23.0",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}