zcw-shared 1.2.0

package/README.md

@@ -0,0 +1,610 @@
+# Shared Package 编码规范
+
+本文档定义了 shared package 中的编码规范和最佳实践，所有开发人员必须严格遵循执行。
+
+**重要说明**: 本库是环境无关的纯TypeScript库，所有函数必须保持环境无关性，仅通过TypeScript引用声明环境依赖。
+
+**例外说明**: `scripts/` 目录下的文件为构建脚本，不会被打包到最终产物中，因此可以直接导入Node.js环境模块，不需要遵循环境无关性规则。playground是一个子项目，有自己的规则，你完全忽略此文件夹。
+
+## 目录结构
+
+```
+src/
+├── functions/          # 纯函数，按功能分类组织
+├── hooks/             # Vue/React hooks
+references/            # 仅供TypeScript引用的环境类型定义
+types/                 # 可导出的公共类型定义
+scripts/               # 构建脚本（不会被打包，可直接使用Node.js模块）
+```
+
+## TypeScript 类型声明规范
+
+### 1. 类型定义文件组织
+
+- **统一类型定义**: 将重复的类型定义提取到 `types/` 目录下的专用文件中
+- **避免重复**: 不要在多个文件中重复定义相同的接口或类型
+- **模块化**: 按功能模块组织类型定义文件
+- **环境分离**: 严格区分不同环境的类型定义，避免混合使用
+- **接口导出**: 所有可复用的接口必须正确导出
+- **命名空间统一**: 同一文件内的类型定义应使用统一的命名空间设计
+
+### 2. 环境类型定义规范
+
+#### 2.1 环境分离原则
+
+**✅ 正确的环境分离**:
+
+```typescript
+// browser.d.ts - 纯浏览器环境
+export interface BrowserEnvironment {
+  window: WindowLike
+  globalThis: any
+  console: ConsoleInterface
+  URLSearchParams: URLSearchParamsConstructor
+  localStorage: Storage
+}
+
+// node.d.ts - 纯Node.js环境
+export interface NodeEnvironment {
+  process: NodeProcess
+  fs: NodeFileSystem
+  path: NodePath
+  childProcess: NodeChildProcess
+  util: NodeUtil
+  Buffer: NodeBufferConstructor
+  console: ConsoleInterface
+  setImmediate: typeof setImmediate
+  clearImmediate: typeof clearImmediate
+  __DEV__?: boolean
+}
+```
+
+**❌ 错误的环境混合**:
+```typescript
+// 禁止在同一接口中混合不同环境的API
+interface MixedEnvironment {
+  window: Window      // 浏览器API
+  process: Process    // Node.js API - 错误！
+}
+```
+
+#### 2.2 类型安全性要求
+
+- **减少any类型**: 优先使用具体的类型定义，避免过度使用 `any`
+- **接口完整性**: 接口应包含必要的属性和方法，提供完整的类型信息
+- **泛型支持**: 适当使用泛型提高类型的灵活性和复用性
+
+**✅ 类型安全的接口设计**:
+```typescript
+// 具体的类型定义
+export interface VNode<T> {
+  type: string | Component | symbol
+  children: VNodeChildren
+  props: Record<string, any> | null
+  key: string | number | symbol | null
+  ref: VNodeRef<T> | null
+}
+
+// 避免过度使用any
+export interface Component {
+  name?: string
+  setup?: (props: any, ctx: any) => any
+  render?: () => VNode
+  template?: string
+}
+```
+
+#### 2.3 类型文件组织和导入规范
+
+**📁 类型文件组织原则**:
+- **`references/` 目录**: 存放环境相关和第三方库的类型定义（浏览器、Node.js、Sharp、Vue、微信小程序等）
+- **`types/` 目录**: 存放通用的、需要提供给外部使用的公共类型定义
+
+**✅ 统一的导入方式**:
+```typescript
+// 环境相关和第三方库类型从 references 目录导入（使用.d后缀）
+import type { NodePath, NodeFileSystem } from '../../../references/node.d'
+import type { BrowserEnvironment } from '../../../references/browser.d'
+import type { Sharp } from '../../../references/sharp.d'
+import type { WebAssembly } from '../../../references/webassembly.d'
+
+// 通用公共类型从 types 目录导入（使用.d后缀）
+import type { GeometryPoint, Rectangle } from '../../../types/geometry.d'
+import type { DeepPartial, Optional } from '../../../types/util.d'
+```
+
+**📝 导入路径规范**:
+- **使用.d后缀**: 导入类型定义时使用 `.d` 后缀，不要使用 `.d.ts` 或 `.ts`
+- **相对路径**: 使用相对路径导入，确保路径正确性
+- **一致性**: 项目内所有导入路径保持一致的格式
+- **显式导入**: 所有类型都通过显式导入使用，避免全局声明污染
+
+**❌ 禁止的做法**:
+```typescript
+// 禁止将环境相关和第三方库类型放在 types 目录
+// types/browser.d.ts  // ❌ 错误位置
+
+// 禁止将通用类型放在 references 目录
+// references/geometry.d.ts  // ❌ 错误位置
+
+// 禁止使用 declare global 模式
+declare global {
+  namespace WebAssembly {
+    // ❌ 已废弃的全局声明方式
+  }
+}
+```
+
+#### 2.4 类型声明和导出规范
+
+- **直接导出**: 使用 `export` 声明直接导出类型，避免 `declare` 声明
+- **命名空间导出**: 对于复杂的类型结构，使用 `export namespace` 进行组织
+- **清晰导出**: 提供清晰的类型别名导出
+- **避免全局声明**: 不使用 `declare global` 模式，所有类型通过显式导入使用
+
+**✅ 现代化的类型声明方式**:
+```typescript
+// node.d.ts - 使用 export namespace
+export namespace Node {
+  interface FileSystem { /* ... */ }
+  interface Path { /* ... */ }
+  interface Process { /* ... */ }
+  interface Buffer { /* ... */ }
+}
+
+// 直接导出类型别名
+export type NodeFileSystem = Node.FileSystem
+export type NodePath = Node.Path
+export type NodeProcess = Node.Process
+export type NodeBuffer = Node.Buffer
+
+// webassembly.d.ts - 直接导出命名空间
+export namespace WebAssembly {
+  interface Module { /* ... */ }
+  interface Instance { /* ... */ }
+  interface Memory { /* ... */ }
+  // ...
+}
+
+// fetch.d.ts - 直接导出接口和函数
+export interface Headers { /* ... */ }
+export interface Request { /* ... */ }
+export interface Response { /* ... */ }
+export declare function fetch(input: RequestInfo, init?: RequestInit): Promise<Response>
+```
+
+### 3. 环境依赖声明规范
+
+**✅ 正确做法 - 使用类型导入**:
+```typescript
+// 推荐使用 import type 导入环境类型
+import type { NodeFileSystem, NodePath } from '../../../references/node.d'
+import type { WindowLike } from '../../../references/browser.d'
+import type { WebAssembly } from '../../../references/webassembly.d'
+
+// 函数通过参数接收环境依赖，保持环境无关性
+export async function myFunction(
+  inputPath: string,
+  fs: NodeFileSystem,
+  path: NodePath,
+  webAssembly: typeof WebAssembly,
+  window?: WindowLike
+) {
+  // 所有环境模块都通过参数传入，函数本身环境无关
+  const module = await webAssembly.compile(wasmBytes)
+  const instance = await webAssembly.instantiate(module)
+}
+```
+
+**说明**: `references/` 目录包含环境相关和第三方库的类型定义文件，推荐使用 `import type` 导入这些类型。这些文件使用现代化的 `export` 声明方式，避免了 `declare global` 模式的全局污染。所有类型都通过显式导入使用，确保类型安全和模块化。`types/` 目录包含可导出的公共类型定义。
+
+**❌ 错误做法 - 任何形式的直接依赖**:
+```typescript
+// ❌ 禁止任何形式的直接导入或声明
+import fs from 'fs'
+declare const fs: NodeFileSystem
+const window = globalThis.window
+```
+
+### 4. 接口功能完整性规范
+
+#### 4.1 避免功能单一的接口
+
+**✅ 功能完整的接口设计**:
+```typescript
+// 完整的Base64编码接口
+export interface Base64Encoder {
+  btoa(data: string): string
+  atob(data: string): string  // 新增解码功能
+}
+
+// 完整的定时器API
+export interface TimerAPI {
+  setTimeout(callback: () => void, delay: number): number
+  clearTimeout(id: number): void
+  setInterval(callback: () => void, delay: number): number
+  clearInterval(id: number): void
+}
+```
+
+**❌ 功能不完整的接口**:
+```typescript
+// 功能过于单一
+interface IncompleteEncoder {
+  btoa(data: string): string  // 只有编码，缺少解码
+}
+```
+
+#### 4.2 接口导出规范
+
+- **必须导出**: 所有定义的接口都必须正确导出，确保可以在其他地方使用
+- **导出一致性**: 保持导出方式的一致性
+
+**✅ 正确的接口导出**:
+```typescript
+// sharp.d.ts
+export interface SharpInstance {
+  resize(width: number, height: number): SharpInstance
+  toBuffer(): Promise<Buffer>
+}
+
+export interface Sharp {
+  (input: Buffer): SharpInstance
+}
+```
+
+### 5. Sharp 图像处理库规范
+
+- 使用统一的 `references/sharp.d.ts` 类型定义
+- Sharp 实例作为函数参数传入，不使用全局声明
+- 所有图像处理函数都应该接收 `sharp: Sharp` 参数
+- 确保 Sharp 相关接口正确导出
+
+## Functions 目录规范
+
+本目录包含项目中使用的纯函数，所有函数必须遵循以下规范：
+
+### 基本要求
+
+#### 1. 纯函数原则
+- 所有函数必须是**纯函数**
+- 相同的输入必须产生相同的输出
+- 不能有副作用（不修改外部状态、不进行 I/O 操作等）
+- 不依赖外部可变状态
+
+#### 2. 文件组织
+- 按照**模块进行划分文件夹**
+- 每个文件中**只能包含一个函数**
+- 文件名应该与函数名保持一致
+- 使用 `export` 导出函数（推荐使用具名导出）
+- **❌ 严禁创建 index.ts 入口文件**：每个函数文件都需要单独打包，不允许使用统一入口文件
+- **❌ 子模块不要创建 README 文件**：避免文档冗余，统一在根目录的 README 中说明规范
+
+#### 3. 目录结构
+- 按功能模块划分子目录
+- 每个子目录包含相关的函数文件
+- 可以包含模块专用的类型定义和说明文档
+
+### Functions 代码规范
+
+#### 1. 导出方式
+推荐使用具名导出：
+```typescript
+export function functionName(params: Type): ReturnType {
+  // 函数实现
+}
+```
+
+也可以使用默认导出：
+```typescript
+const functionName = (params: Type): ReturnType => {
+  // 函数实现
+}
+
+export default functionName
+```
+
+#### 2. 类型定义
+- **函数专用类型**：如果类型只被当前函数使用，应该在同一个文件中定义
+- **通用类型**：只有被多个函数或模块共享的类型，才应该放在 `types/` 目录中
+- 优先原则：保持函数的独立性，避免不必要的外部依赖
+
+#### 3. 文档注释
+每个函数都应该包含 JSDoc 注释：
+```typescript
+/**
+ * 函数描述
+ * @param param1 参数1描述
+ * @param param2 参数2描述
+ * @returns 返回值描述
+ */
+export function functionName(param1: Type1, param2: Type2): ReturnType {
+  // 实现
+}
+```
+
+### Functions 注意事项
+
+1. **避免副作用**：不要在函数中进行文件操作、网络请求、修改全局变量等
+2. **保持简单**：每个函数应该职责单一，易于测试和维护
+3. **类型安全**：充分利用 TypeScript 的类型系统，确保类型安全
+4. **可测试性**：纯函数天然易于测试，编写函数时考虑测试场景
+5. **单独打包**：每个函数文件都会被单独打包到 package.json 的 exports 字段中，因此不能使用 index.ts 等入口文件进行统一导出
+6. **明确导入**：使用者需要明确导入具体的函数模块，如 `import { functionName } from 'shared/functions/module/functionName'`
+
+### Functions 示例
+
+#### 正确示例
+```typescript
+// functions/module/functionName.ts
+/**
+ * 函数功能描述
+ * @param param 参数描述
+ * @returns 返回值描述
+ */
+export function functionName(param: InputType): OutputType {
+  // 纯函数实现，无副作用
+  return processedResult
+}
+```
+
+#### 错误示例
+```typescript
+// ❌ 包含副作用
+export function functionWithSideEffect(data: string): void {
+  // 副作用：文件操作、网络请求等
+}
+
+// ❌ 依赖外部状态
+let globalState = 0
+export function dependsOnGlobalState(): number {
+  return ++globalState // 依赖外部可变状态
+}
+
+// ❌ 一个文件包含多个函数
+export function firstFunction(): void {}
+export function secondFunction(): void {}
+
+// ❌ 创建 index.ts 入口文件
+// functions/module/index.ts
+export { functionA } from './functionA'
+export { functionB } from './functionB'
+// 这种做法会影响单独打包，严禁使用
+
+// ❌ 在子模块中创建 README 文件
+// functions/module/README.md
+// 子模块不需要单独的 README 文件，会造成文档冗余
+```
+
+## 函数设计原则
+
+### 1. 依赖注入与环境无关性
+
+- 所有环境依赖都必须通过参数传入，确保函数保持环境无关性
+- 函数不能直接导入任何环境模块（如 fs、path、sharp 等）
+- 仅通过 TypeScript 引用声明环境类型，实例通过参数传入
+- 函数实现完全依赖传入的参数，保持环境无关
+
+### 2. 类型安全
+
+- 所有函数参数都应该有明确的类型声明
+- 使用 TypeScript 的严格模式
+- 避免使用 `any` 类型，优先使用具体的类型定义
+
+### 3. 纯函数与环境无关性
+
+- `functions/` 目录下的函数必须是环境无关的纯函数
+- 函数不能直接访问任何环境变量或全局对象
+- 所有环境依赖通过参数传入，确保函数可在任意环境中运行
+- 按功能模块组织函数（如 dom/、image/、debug/ 等）
+- 环境无关的纯函数更容易测试、维护和跨环境复用
+
+### 4. 错误处理规范
+
+#### 4.1 错误信息格式
+
+- **中文错误信息**: 面向用户的错误信息使用中文，提供清晰的错误描述
+- **状态码包含**: 网络请求相关错误应包含具体的状态码信息
+- **上下文信息**: 错误信息应包含足够的上下文，帮助定位问题
+
+**✅ 正确的错误处理**:
+```typescript
+// 网络请求错误
+reject(new Error(`下载失败，状态码: ${res.statusCode}`));
+
+// 参数验证错误
+throw new Error('文件路径不能为空');
+
+// 业务逻辑错误
+reject(new Error(`应用验证失败: ${validationMessage}`));
+```
+
+**❌ 错误的错误处理**:
+```typescript
+// 错误信息过于简单
+reject(new Error('failed'));
+
+// 缺少上下文信息
+throw new Error('error');
+
+// 使用英文错误信息（面向用户时）
+reject(new Error('Download failed'));
+```
+
+#### 4.2 错误处理一致性
+
+- **Promise 错误**: 异步函数使用 `reject(new Error(...))` 抛出错误
+- **同步错误**: 同步函数使用 `throw new Error(...)` 抛出错误
+- **错误类型**: 统一使用 `Error` 类型，避免抛出字符串或其他类型
+- **错误传递**: 适当时保留原始错误信息，避免错误信息丢失
+
+### 5. JSDoc 文档规范
+
+- **强制要求**: 每个导出的函数都必须包含完整的 JSDoc 注释
+- **禁止生成**: 不要为函数模块生成单独的 README.md 文件
+- **文档内容**: JSDoc 必须包含函数描述、参数说明、返回值说明和使用示例
+- **类型信息**: 充分利用 TypeScript 类型系统，JSDoc 中重点描述业务逻辑
+
+#### 5.1 JSDoc 格式要求
+
+```typescript
+// 正确的类型导入方式
+import type { EnvironmentType1, EnvironmentType2 } from '../../../references/environment.d'
+import type { CommonType } from '../../../types/common.d'
+
+/**
+ * 函数的简要描述
+ * 
+ * 详细描述函数的功能、用途和注意事项
+ * 
+ * @param paramName - 参数描述，说明参数的用途和要求
+ * @param envDependency - 环境依赖参数，通过参数注入
+ * @returns 返回值描述，说明返回内容的含义
+ */
+export async function myFunction(
+  paramName: string,
+  envDependency: EnvironmentType1
+): Promise<CommonType> {
+  // 函数实现
+}
+```
+
+## 文件引用规范
+
+### 6. 导入限制
+
+**✅ 允许的导入**:
+- 本包内的类型和函数（使用相对路径）
+- 环境相关和第三方库类型（从 `references/` 目录导入）
+- 通用公共类型（从 `types/` 目录导入）
+
+```typescript
+// 允许导入本包内的类型和函数
+import type { SoftwareConfig, Platform } from './types'
+import { helperFunction } from '../utils/helper'
+
+// 环境相关和第三方库类型从 references 目录导入
+import type { NodeFileSystem, NodePath } from '../../../references/node.d'
+import type { Sharp } from '../../../references/sharp.d'
+import type { WebAssembly } from '../../../references/webassembly.d'
+
+// 通用公共类型从 types 目录导入
+import type { GeometryPoint, Rectangle } from '../../../types/geometry.d'
+```
+
+**❌ 禁止的导入和声明**:
+- 任何环境模块的直接导入或声明
+- 第三方npm包的导入
+- 全局变量的直接访问
+
+```typescript
+// ❌ 禁止任何形式的环境依赖
+import fs from 'fs'                    // 禁止导入
+import path from 'path'                // 禁止导入
+import sharp from 'sharp'              // 禁止导入
+import lodash from 'lodash'            // 禁止导入
+declare const fs: NodeFileSystem       // 禁止声明
+const win = globalThis.window          // 禁止全局访问
+process.env.NODE_ENV                   // 禁止直接使用
+```
+
+**✅ 唯一允许的环境依赖方式**:
+```typescript
+import type { NodeBuffer, NodeFileSystem } from '../../../references/node.d'
+import type { Sharp } from '../../../references/sharp.d'
+import type { WebAssembly } from '../../../references/webassembly.d'
+
+// 仅通过TypeScript引用声明类型，所有实例通过参数传入
+export function processFile(
+  content: string,
+  fs: NodeFileSystem,
+  sharp: Sharp,
+  webAssembly: typeof WebAssembly
+): Promise<NodeBuffer> {
+  // 函数实现保持环境无关
+}
+```
+
+### 6.1 相对路径
+
+- 使用相对路径引用类型定义文件
+- 保持路径的一致性和可维护性
+
+## 代码质量检查清单
+
+在提交代码前，请确保通过以下检查清单：
+
+### TypeScript 类型检查
+- [ ] 所有接口都已正确导出
+- [ ] 环境类型定义严格分离（浏览器 vs Node.js）
+- [ ] 减少 `any` 类型的使用，提供具体类型定义
+- [ ] 导入方式保持一致（优先使用 `import type`）
+- [ ] 命名空间设计统一
+- [ ] 接口功能完整，避免过于单一的设计
+
+### 环境无关性检查
+- [ ] 函数不直接导入任何环境模块
+- [ ] 所有环境依赖通过参数传入
+- [ ] 仅使用 TypeScript 引用声明环境类型
+- [ ] 函数可在任意环境中运行
+
+### 错误处理检查
+- [ ] 错误信息使用中文，提供清晰的错误描述
+- [ ] 网络请求错误包含具体的状态码信息
+- [ ] 错误信息包含足够的上下文信息
+- [ ] 异步函数使用 `reject(new Error(...))` 抛出错误
+- [ ] 同步函数使用 `throw new Error(...)` 抛出错误
+- [ ] 统一使用 `Error` 类型，避免抛出其他类型
+
+### JSDoc 文档检查
+- [ ] 每个导出函数都有完整的 JSDoc 注释
+- [ ] JSDoc 包含函数描述、参数说明、返回值说明
+- [ ] 没有生成单独的 README.md 文件
+- [ ] JSDoc 格式符合规范要求
+
+### 代码组织检查
+- [ ] 按功能模块组织代码结构
+- [ ] 类型定义提取到合适的位置
+- [ ] 文件路径和引用路径正确
+- [ ] 避免重复的类型定义
+- [ ] 函数遵循单一职责原则
+- [ ] 每个文件只包含一个函数（functions目录下）
+
+## 最佳实践总结
+
+1. **环境无关性**: 本库是纯TypeScript库，所有函数必须保持环境无关，可在任意环境中运行
+2. **严格导入控制**: 只允许导入本包内容和TypeScript引用，禁止任何环境模块的直接导入或声明
+3. **依赖注入**: 所有环境依赖通过参数传入，确保函数的环境无关性和可测试性
+4. **现代化类型声明**: 使用 `export` 声明直接导出类型，避免 `declare global` 模式的全局污染
+5. **类型引用规范**: 环境类型统一通过 `import type` 导入，使用 `.d` 后缀
+6. **环境分离**: 严格区分浏览器和Node.js环境的类型定义，避免混合使用
+7. **统一类型定义**: 重复的类型定义提取到公共文件中，保持命名空间设计的一致性
+8. **类型安全**: 使用具体的类型定义，减少 `any` 的使用，提供完整的接口功能
+9. **接口导出**: 确保所有可复用的接口正确导出，保持导出方式的一致性
+10. **显式导入**: 所有类型都通过显式导入使用，确保类型安全和模块化
+11. **模块化**: 按功能组织代码和类型定义，保持清晰的项目结构
+12. **错误处理**: 使用中文错误信息，包含足够的上下文和状态码，统一使用 Error 类型
+13. **JSDoc 文档**: 每个导出函数必须有完整的 JSDoc 注释，包含描述、参数、返回值和使用示例
+14. **代码质量**: 遵循 TypeScript 严格模式，使用 ESLint 和 Prettier 保持代码风格一致
+15. **文档化**: 重要的设计决策和规范要有文档记录，提供代码质量检查清单
+
+## 代码组织和文档要求
+
+### 7. 函数组织原则
+
+- 按功能模块组织函数到不同的目录（如 dom/、image/、debug/ 等）
+- 每个函数文件专注于单一功能领域
+- 保持函数的单一职责原则
+- 优先考虑函数的复用性和可测试性
+
+### 7.1 文档要求
+
+- **JSDoc 优先**: 每个函数必须有完整的 JSDoc 注释，不生成单独的 README 文件
+- **类型安全**: 充分利用 TypeScript 类型系统提供类型信息
+- **文档完整性**: JSDoc 必须包含函数描述、参数说明和返回值说明
+
+### 7.2 代码质量要求
+
+- 遵循 TypeScript 严格模式
+- 函数复杂度控制在合理范围内
+- 保持函数职责单一，易于测试和维护

package/assets/logo-colorful.svg

@@ -0,0 +1,18 @@
+<svg width="1024.000000" height="1024.000000" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+	<desc>
+			Created with Pixso.
+	</desc>
+	<defs>
+		<clipPath id="clip2_7">
+			<rect id="logo-transparent.svg" width="1024.000000" height="1024.000000" fill="white" fill-opacity="0"/>
+		</clipPath>
+		<linearGradient x1="211.999863" y1="57.000076" x2="666.000061" y2="722.499939" id="paint_linear_2_12_0" gradientUnits="userSpaceOnUse">
+			<stop offset="0.003135" stop-color="#F41F1F"/>
+			<stop offset="0.488260" stop-color="#FF5340"/>
+			<stop offset="1.000000" stop-color="#FF68CF"/>
+		</linearGradient>
+	</defs>
+	<g clip-path="url(#clip2_7)">
+		<path id="矢量 1" d="M701.17 222.36L406.96 142L287 462.9L737 492.76L530.71 881L287 643.71" stroke="url(#paint_linear_2_12_0)" stroke-opacity="1.000000" stroke-width="120.000000"/>
+	</g>
+</svg>

package/assets/logo-name.svg

@@ -0,0 +1,7 @@
+<svg width="226.605591" height="69.890625" viewBox="0 0 226.606 69.8906" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+	<desc>
+			Created with Pixso.
+	</desc>
+	<defs/>
+	<path id="矢量 2" d="M26.69 69.89Q18.53 69.89 12.46 66.44Q10.07 65.07 8.12 63.23L8.12 63.23Q5.15 60.41 3.21 56.5Q0 50.01 0 40.99Q0 31.63 3.39 23.74Q4.21 21.85 5.22 20.03Q8.54 14.09 13.32 9.77L13.32 9.77Q16.08 7.29 19.33 5.34Q22.9 3.19 26.75 1.91Q32.49 0 38.88 0Q43.59 0 48.32 1.07Q53.08 2.13 56.34 3.93L52.89 15.65Q44.34 11.81 37.24 11.81Q30.65 11.81 25.75 14.68L25.75 14.68Q25.02 15.11 24.32 15.6Q22.8 16.69 21.49 17.99L21.49 17.99Q18.22 21.23 16.26 25.8Q13.54 32.17 13.54 39.84Q13.54 50.37 18.75 54.83Q22.56 58.1 29.17 58.1Q36.28 58.1 46.07 54.25L45.39 65.95Q41.57 67.78 36.42 68.83Q31.28 69.89 26.69 69.89ZM55.26 65.9L55.26 65.9L55.26 65.9Q54.3 65.47 53.36 64.99L57.2 50.97Q60.67 54.07 65.5 56.08Q70.35 58.1 76.21 58.1Q84.85 58.1 87.47 54.13L87.47 54.13Q88.61 52.4 88.61 49.92Q88.61 47.16 87.34 45.24Q86.71 44.29 85.77 43.54Q82.94 41.29 75.84 38.78Q70.35 36.86 67 34.71Q64.53 33.12 62.92 30.91L62.92 30.91L62.91 30.9Q62.34 30.11 61.87 29.25Q60.09 25.92 60.09 20.92Q60.09 16.94 61.48 13.52L61.48 13.52Q62.2 11.76 63.3 10.14Q63.76 9.46 64.28 8.82L64.28 8.82L64.28 8.82L64.28 8.82Q67.36 5 72.32 2.69Q78.13 0 85.82 0Q92.34 0 97.92 1.54Q103.49 3.09 106.94 5.2L103.49 17.76Q98.2 14.6 93.98 13.17Q89.76 11.71 84.86 11.71Q79.49 11.71 76.17 13.64Q74.69 14.49 73.87 15.77L73.87 15.77Q72.86 17.36 72.86 19.59Q72.86 21.42 73.66 22.79L73.66 22.79Q74.32 23.92 75.53 24.72Q78.23 26.5 84.09 28.52Q90.04 30.53 93.79 32.46Q94.81 32.98 95.75 33.63L95.75 33.63L95.75 33.63L95.75 33.63Q98.24 35.36 100.12 37.99Q102.72 41.57 102.72 47.34Q102.72 49.99 102.14 52.52L102.14 52.52Q101.46 55.47 99.98 58.24Q97.24 63.37 90.95 66.63Q84.67 69.89 74.78 69.89Q64.13 69.89 55.26 65.9ZM113.75 55.02L134.21 55.02L133.35 61.18L112.93 61.18L112.13 66.31L139.23 66.31Q139.81 66.31 140.35 66.15L140.35 66.15Q141.21 65.9 141.96 65.25Q142.62 64.67 142.99 63.95L142.99 63.95Q143.29 63.35 143.38 62.64L147.22 35.59L116.45 35.59L113.75 55.02ZM173.9 55.02L153.44 55.02L156.14 35.59L186.91 35.59L183.07 62.64Q182.98 63.35 182.68 63.95Q182.31 64.67 181.65 65.25Q180.9 65.9 180.04 66.15Q179.5 66.31 178.92 66.31L151.82 66.31L152.62 61.18L173.04 61.18L173.9 55.02ZM193.13 55.02L213.59 55.02L212.73 61.18L192.31 61.18L191.51 66.31L218.61 66.31Q219.19 66.31 219.73 66.15Q220.59 65.9 221.34 65.25Q222 64.67 222.37 63.95Q222.67 63.35 222.76 62.64L226.6 35.59L195.83 35.59L193.13 55.02ZM124.65 49.89L126.01 40.66L136.27 40.66L134.96 49.89L124.65 49.89ZM165.7 40.66L164.34 49.89L174.65 49.89L175.96 40.66L165.7 40.66ZM204.03 49.89L205.39 40.66L215.65 40.66L214.34 49.89L204.03 49.89Z" fill="#000000" fill-opacity="1.000000" fill-rule="evenodd"/>
+</svg>

package/assets/logo-transparent.svg

@@ -0,0 +1,14 @@
+<svg width="1024.000000" height="1024.000000" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+	<desc>
+			Created with Pixso.
+	</desc>
+	<defs>
+		<clipPath id="clip2_7">
+			<rect id="logo-transparent.svg" width="1024.000000" height="1024.000000" fill="white" fill-opacity="0"/>
+		</clipPath>
+	</defs>
+	<g clip-path="url(#clip2_7)">
+		<path id="矢量 1" d="" fill="#000000" fill-opacity="1.000000" fill-rule="nonzero"/>
+		<path id="矢量 1" d="M701.17 222.36L406.96 142L287 462.9L737 492.76L530.71 881L287 643.71" stroke="#FFFFFF" stroke-opacity="1.000000" stroke-width="120.000000"/>
+	</g>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,8 @@
+<svg width="1024.000000" height="1024.000000" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+	<desc>
+			Created with Pixso.
+	</desc>
+	<defs/>
+	<rect id="矩形 1" width="1024.000000" height="1024.000000" fill="#1D90ED" fill-opacity="1.000000"/>
+	<path id="矢量 1" d="M686.5 246L415.5 172L305 467.5L719.5 495L529.5 852.5L305 634" stroke="#FFFFFF" stroke-opacity="1.000000" stroke-width="120.000000"/>
+</svg>

package/dist/functions/ag-grid/generateLicense.d.ts

@@ -0,0 +1,4 @@
+import type { CryptoJS } from '../../../references/crypto.d';
+import type { Base64Encoder } from '../../../references/browser.d';
+declare const _default: (crypto: CryptoJS, base64Encoder: Base64Encoder) => string;
+export default _default;

package/dist/functions/ag-grid/generateLicense.js

@@ -0,0 +1,12 @@
+export default (crypto, base64Encoder) => {
+    let expiredDate = new Date();
+    expiredDate.setFullYear(expiredDate.getFullYear() + 99);
+    const milliSeconds = expiredDate.getTime();
+    const expired = base64Encoder.btoa(milliSeconds.toString());
+    const license = `[v3][RELEASE][0102]_${expired}`;
+    const hashResult = crypto.MD5(license);
+    const hash = typeof hashResult === 'string' ? hashResult : hashResult.toString();
+    const licenseKey = `${license}${hash}`;
+    return licenseKey;
+};
+//# sourceMappingURL=generateLicense.js.map

package/dist/functions/ag-grid/generateLicense.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateLicense.js","sourceRoot":"","sources":["../../../src/functions/ag-grid/generateLicense.ts"],"names":[],"mappings":"AASA,eAAe,CAAC,MAAgB,EAAE,aAA4B,EAAE,EAAE;IAChE,IAAI,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;IAC5B,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAA;IACvD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,CAAA;IAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,uBAAuB,OAAO,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA;IAChF,MAAM,UAAU,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAA;IACtC,OAAO,UAAU,CAAA;AACnB,CAAC,CAAA"}