@doki-land/dejavu-engine 0.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/dejavu.mjs +379 -0
- package/dist/index.d.ts +1445 -0
- package/dist/index.js +3465 -0
- package/package.json +41 -0
- package/readme.md +112 -0
package/package.json
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@doki-land/dejavu-engine",
|
|
3
|
+
"version": "0.0.0",
|
|
4
|
+
"description": "DejaVu Engine - 模板引擎",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"module": "./dist/index.js",
|
|
8
|
+
"types": "./dist/index.d.ts",
|
|
9
|
+
"bin": {
|
|
10
|
+
"dejavu": "./bin/dejavu.mjs"
|
|
11
|
+
},
|
|
12
|
+
"exports": {
|
|
13
|
+
".": {
|
|
14
|
+
"types": "./dist/index.d.ts",
|
|
15
|
+
"import": "./dist/index.js"
|
|
16
|
+
}
|
|
17
|
+
},
|
|
18
|
+
"files": [
|
|
19
|
+
"dist",
|
|
20
|
+
"bin"
|
|
21
|
+
],
|
|
22
|
+
"keywords": [],
|
|
23
|
+
"author": "",
|
|
24
|
+
"license": "MIT",
|
|
25
|
+
"devDependencies": {
|
|
26
|
+
"@types/node": "^25.4.0",
|
|
27
|
+
"jsdom": "^29.0.0",
|
|
28
|
+
"terser": "^5.46.1",
|
|
29
|
+
"tsup": "^8.0.0",
|
|
30
|
+
"typescript": "^5.0.0",
|
|
31
|
+
"vite": "^5.0.0",
|
|
32
|
+
"vitest": "^2.1.8"
|
|
33
|
+
},
|
|
34
|
+
"scripts": {
|
|
35
|
+
"build": "tsup src/index.ts --format esm",
|
|
36
|
+
"build:dts": "tsup src/index.ts --format esm --dts",
|
|
37
|
+
"dev": "tsup src/index.ts --format esm --watch",
|
|
38
|
+
"test": "vitest run",
|
|
39
|
+
"typecheck": "tsc --noEmit"
|
|
40
|
+
}
|
|
41
|
+
}
|
package/readme.md
ADDED
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
|
|
2
|
+
# DejaVu Tools (TypeScript)
|
|
3
|
+
|
|
4
|
+
Déjà-Vu 模板引擎的 TypeScript 工具库，提供各种通用的工具函数、类型定义、错误处理和配置管理功能。
|
|
5
|
+
|
|
6
|
+
## 定位
|
|
7
|
+
|
|
8
|
+
- **TypeScript 工具库**：提供 DejaVu 前端开发所需的通用工具
|
|
9
|
+
- **完整的工具集**：包含工具函数、错误处理、配置管理等
|
|
10
|
+
- **核心功能**：
|
|
11
|
+
- 通用工具函数（空值检查、延迟、重试等）
|
|
12
|
+
- 类型定义（文件路径、环境变量等）
|
|
13
|
+
- 错误处理系统
|
|
14
|
+
- 事件发射器
|
|
15
|
+
- 缓存系统
|
|
16
|
+
- 配置管理
|
|
17
|
+
|
|
18
|
+
## 特性
|
|
19
|
+
|
|
20
|
+
- 完全 TypeScript 编写，类型安全
|
|
21
|
+
- 零运行时依赖
|
|
22
|
+
- 模块化设计，按需导入
|
|
23
|
+
- 提供丰富的工具函数
|
|
24
|
+
- 完整的错误处理机制
|
|
25
|
+
- 事件驱动架构支持
|
|
26
|
+
|
|
27
|
+
## 使用
|
|
28
|
+
|
|
29
|
+
### 安装
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
pnpm add dejavu-tools
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### 基本示例
|
|
36
|
+
|
|
37
|
+
```typescript
|
|
38
|
+
import {
|
|
39
|
+
isNil,
|
|
40
|
+
isEmpty,
|
|
41
|
+
delay,
|
|
42
|
+
deepClone,
|
|
43
|
+
uuidv4,
|
|
44
|
+
EventEmitter,
|
|
45
|
+
Cache,
|
|
46
|
+
ErrorLevel,
|
|
47
|
+
ToolException,
|
|
48
|
+
createDefaultToolsConfig,
|
|
49
|
+
ToolsConfigManager
|
|
50
|
+
} from 'dejavu-tools';
|
|
51
|
+
|
|
52
|
+
// 使用工具函数
|
|
53
|
+
if (isNil(value)) {
|
|
54
|
+
console.log('值为空');
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
// 使用事件发射器
|
|
58
|
+
const emitter = new EventEmitter();
|
|
59
|
+
emitter.on('data', (data) => console.log(data));
|
|
60
|
+
emitter.emit('data', 'hello');
|
|
61
|
+
|
|
62
|
+
// 使用缓存
|
|
63
|
+
const cache = new Cache<string, number>(60000);
|
|
64
|
+
cache.set('key', 123);
|
|
65
|
+
console.log(cache.get('key'));
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### 工具函数列表
|
|
69
|
+
|
|
70
|
+
#### 空值检查
|
|
71
|
+
- `isNil` - 检查值是否为 null 或 undefined
|
|
72
|
+
- `isNotNil` - 检查值不为 null 或 undefined
|
|
73
|
+
- `isEmpty` - 检查值是否为空
|
|
74
|
+
- `isNotEmpty` - 检查值不为空
|
|
75
|
+
|
|
76
|
+
#### 异步工具
|
|
77
|
+
- `delay` - 延迟执行
|
|
78
|
+
- `cancellableDelay` - 可取消的延迟
|
|
79
|
+
- `retry` - 重试操作
|
|
80
|
+
- `debounce` - 防抖函数
|
|
81
|
+
- `throttle` - 节流函数
|
|
82
|
+
- `memoize` - 记忆化函数
|
|
83
|
+
|
|
84
|
+
#### 对象工具
|
|
85
|
+
- `deepClone` - 深拷贝
|
|
86
|
+
- `deepEqual` - 深比较
|
|
87
|
+
- `safeJsonParse` - 安全的 JSON 解析
|
|
88
|
+
- `safeJsonStringify` - 安全的 JSON 序列化
|
|
89
|
+
|
|
90
|
+
#### 字符串工具
|
|
91
|
+
- `uniqueId` - 生成唯一 ID
|
|
92
|
+
- `uuidv4` - 生成 UUID v4
|
|
93
|
+
- `capitalize` - 首字母大写
|
|
94
|
+
- `camelCase` - 驼峰命名
|
|
95
|
+
- `kebabCase` - 短横线命名
|
|
96
|
+
- `snakeCase` - 下划线命名
|
|
97
|
+
- `truncate` - 截断字符串
|
|
98
|
+
|
|
99
|
+
#### 数组工具
|
|
100
|
+
- `unique` - 数组去重
|
|
101
|
+
- `chunk` - 数组分块
|
|
102
|
+
|
|
103
|
+
## 模块结构
|
|
104
|
+
|
|
105
|
+
- `types` - 类型定义
|
|
106
|
+
- `errors` - 错误处理
|
|
107
|
+
- `utils` - 工具函数
|
|
108
|
+
- `options` - 配置和选项
|
|
109
|
+
|
|
110
|
+
## 依赖关系
|
|
111
|
+
|
|
112
|
+
dejavu-tools (TypeScript) 是一个独立的前端工具库，无外部依赖。
|