@cloudcome/utils-core 1.17.0 → 1.18.1
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/dist/emitter.cjs +17 -0
- package/dist/emitter.cjs.map +1 -1
- package/dist/emitter.d.ts +11 -1
- package/dist/emitter.mjs +17 -0
- package/dist/emitter.mjs.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/version.cjs +15 -6
- package/dist/version.cjs.map +1 -1
- package/dist/version.mjs +15 -6
- package/dist/version.mjs.map +1 -1
- package/package.json +1 -1
package/dist/emitter.cjs
CHANGED
|
@@ -19,6 +19,23 @@ class Emitter {
|
|
|
19
19
|
this.#events.set(event, /* @__PURE__ */ new Set([listener]));
|
|
20
20
|
}
|
|
21
21
|
}
|
|
22
|
+
/**
|
|
23
|
+
* 注册事件监听器，仅触发一次
|
|
24
|
+
* @param event - 要监听的事件名称
|
|
25
|
+
* @param listener - 事件监听器函数
|
|
26
|
+
* @example
|
|
27
|
+
* emitter.once('click', (x, y) => {
|
|
28
|
+
* console.log(`Clicked at (${x}, ${y})`);
|
|
29
|
+
* });
|
|
30
|
+
*/
|
|
31
|
+
once(event, listener) {
|
|
32
|
+
const onceListener = (...payloads) => {
|
|
33
|
+
const result = listener(...payloads);
|
|
34
|
+
this.off(event, onceListener);
|
|
35
|
+
return result;
|
|
36
|
+
};
|
|
37
|
+
this.on(event, onceListener);
|
|
38
|
+
}
|
|
22
39
|
/**
|
|
23
40
|
* 移除事件监听器，有三种使用方式：
|
|
24
41
|
* 1. 移除特定事件的特定监听器
|
package/dist/emitter.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"emitter.cjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/**\n * 事件类型映射，key 为事件名称，value 为事件参数类型数组\n */\nexport type EmitterMap = Record<string, unknown[]>;\n\n/**\n * 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n */\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false | unknown;\n\n/**\n * 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n *\n * @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n *\n * const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n */\nexport class Emitter<E extends EmitterMap
|
|
1
|
+
{"version":3,"file":"emitter.cjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/**\n * 事件类型映射，key 为事件名称，value 为事件参数类型数组\n */\nexport type EmitterMap = Record<string, unknown[]>;\n\n/**\n * 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n */\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false | unknown;\n\n/**\n * 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n *\n * @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n *\n * const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n */\nexport class Emitter<E extends EmitterMap = Record<string | symbol, unknown[]>> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /**\n * 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n */\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /**\n * 注册事件监听器，仅触发一次\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.once('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n */\n once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n const result = listener(...payloads);\n this.off(event, onceListener);\n return result;\n };\n this.on(event, onceListener);\n }\n\n /**\n * 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n *\n * // 移除特定事件的所有监听器\n * emitter.off('click');\n *\n * // 移除所有事件的所有监听器\n * emitter.off();\n */\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /**\n * 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> | undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":";;AA8BO,MAAM,QAAmE;AAAA,EAC9E,8BAA8C,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,WAAA,QAAQ,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYF,KAAwB,OAAU,UAAiC;AAC3D,UAAA,eAAe,IAAI,aAAgD;AACjE,YAAA,SAAS,SAAS,GAAG,QAAQ;AAC9B,WAAA,IAAI,OAAO,YAAY;AACrB,aAAA;AAAA,IACT;AACK,SAAA,GAAG,OAAO,YAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB7B,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,WAAA,aAAa,OAAO,QAAQ;AAAA,eACxB,OAAO;AAChB,WAAK,UAAU,KAAK;AAAA,IAAA,OACf;AACL,WAAK,QAAQ;AAAA,IAAA;AAAA,EACf;AAAA,EAGF,UAAU;AACR,SAAK,QAAQ,MAAM;AAAA,EAAA;AAAA,EAGrB,UAA6B,OAAU;AAChC,SAAA,QAAQ,OAAO,KAAK;AAAA,EAAA;AAAA,EAG3B,aAAgC,OAAU,UAAiC;AACzE,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,WAAW;AACb,gBAAU,OAAO,QAAQ;AAAA,IAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaF,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;;"}
|
package/dist/emitter.d.ts
CHANGED
|
@@ -24,7 +24,7 @@ export type EmitterListener<E extends EmitterMap, K extends keyof E> = (...paylo
|
|
|
24
24
|
* });
|
|
25
25
|
* emitter.emit('click', 10, 20);
|
|
26
26
|
*/
|
|
27
|
-
export declare class Emitter<E extends EmitterMap
|
|
27
|
+
export declare class Emitter<E extends EmitterMap = Record<string | symbol, unknown[]>> {
|
|
28
28
|
#private;
|
|
29
29
|
/**
|
|
30
30
|
* 注册事件监听器
|
|
@@ -36,6 +36,16 @@ export declare class Emitter<E extends EmitterMap> {
|
|
|
36
36
|
* });
|
|
37
37
|
*/
|
|
38
38
|
on<K extends keyof E>(event: K, listener: EmitterListener<E, K>): void;
|
|
39
|
+
/**
|
|
40
|
+
* 注册事件监听器，仅触发一次
|
|
41
|
+
* @param event - 要监听的事件名称
|
|
42
|
+
* @param listener - 事件监听器函数
|
|
43
|
+
* @example
|
|
44
|
+
* emitter.once('click', (x, y) => {
|
|
45
|
+
* console.log(`Clicked at (${x}, ${y})`);
|
|
46
|
+
* });
|
|
47
|
+
*/
|
|
48
|
+
once<K extends keyof E>(event: K, listener: EmitterListener<E, K>): void;
|
|
39
49
|
/**
|
|
40
50
|
* 移除事件监听器，有三种使用方式：
|
|
41
51
|
* 1. 移除特定事件的特定监听器
|
package/dist/emitter.mjs
CHANGED
|
@@ -17,6 +17,23 @@ class Emitter {
|
|
|
17
17
|
this.#events.set(event, /* @__PURE__ */ new Set([listener]));
|
|
18
18
|
}
|
|
19
19
|
}
|
|
20
|
+
/**
|
|
21
|
+
* 注册事件监听器，仅触发一次
|
|
22
|
+
* @param event - 要监听的事件名称
|
|
23
|
+
* @param listener - 事件监听器函数
|
|
24
|
+
* @example
|
|
25
|
+
* emitter.once('click', (x, y) => {
|
|
26
|
+
* console.log(`Clicked at (${x}, ${y})`);
|
|
27
|
+
* });
|
|
28
|
+
*/
|
|
29
|
+
once(event, listener) {
|
|
30
|
+
const onceListener = (...payloads) => {
|
|
31
|
+
const result = listener(...payloads);
|
|
32
|
+
this.off(event, onceListener);
|
|
33
|
+
return result;
|
|
34
|
+
};
|
|
35
|
+
this.on(event, onceListener);
|
|
36
|
+
}
|
|
20
37
|
/**
|
|
21
38
|
* 移除事件监听器，有三种使用方式：
|
|
22
39
|
* 1. 移除特定事件的特定监听器
|
package/dist/emitter.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"emitter.mjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/**\n * 事件类型映射，key 为事件名称，value 为事件参数类型数组\n */\nexport type EmitterMap = Record<string, unknown[]>;\n\n/**\n * 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n */\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false | unknown;\n\n/**\n * 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n *\n * @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n *\n * const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n */\nexport class Emitter<E extends EmitterMap
|
|
1
|
+
{"version":3,"file":"emitter.mjs","sources":["../src/emitter.ts"],"sourcesContent":["import type { AnyFunction, AnyObject } from './types';\n\n/**\n * 事件类型映射，key 为事件名称，value 为事件参数类型数组\n */\nexport type EmitterMap = Record<string, unknown[]>;\n\n/**\n * 事件监听器函数类型\n * @template E - EmitterMap 类型\n * @template K - 事件名称类型\n */\nexport type EmitterListener<E extends EmitterMap, K extends keyof E> = (...payloads: E[K]) => false | unknown;\n\n/**\n * 事件发射器类，用于管理事件监听和触发\n * @template E - 事件类型映射\n *\n * @example\n * type MyEvents = {\n * 'click': [x: number, y: number];\n * 'change': [value: string];\n * };\n *\n * const emitter = new Emitter<MyEvents>();\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n * emitter.emit('click', 10, 20);\n */\nexport class Emitter<E extends EmitterMap = Record<string | symbol, unknown[]>> {\n #events: Map<keyof E, Set<AnyFunction>> = new Map();\n\n /**\n * 注册事件监听器\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.on('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n */\n on<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n if (listeners) {\n listeners.add(listener);\n } else {\n this.#events.set(event, new Set([listener]));\n }\n }\n\n /**\n * 注册事件监听器，仅触发一次\n * @param event - 要监听的事件名称\n * @param listener - 事件监听器函数\n * @example\n * emitter.once('click', (x, y) => {\n * console.log(`Clicked at (${x}, ${y})`);\n * });\n */\n once<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const onceListener = (...payloads: Parameters<EmitterListener<E, K>>) => {\n const result = listener(...payloads);\n this.off(event, onceListener);\n return result;\n };\n this.on(event, onceListener);\n }\n\n /**\n * 移除事件监听器，有三种使用方式：\n * 1. 移除特定事件的特定监听器\n * 2. 移除特定事件的所有监听器\n * 3. 移除所有事件的所有监听器\n * @param event - 要移除的事件名称（可选）\n * @param listener - 要移除的监听器函数（可选）\n * @example\n * // 移除特定事件的特定监听器\n * emitter.off('click', clickHandler);\n *\n * // 移除特定事件的所有监听器\n * emitter.off('click');\n *\n * // 移除所有事件的所有监听器\n * emitter.off();\n */\n off<K extends keyof E>(event?: K, listener?: EmitterListener<E, K>) {\n if (event && listener) {\n this.#offListener(event, listener);\n } else if (event) {\n this.#offEvent(event);\n } else {\n this.#offAll();\n }\n }\n\n #offAll() {\n this.#events.clear();\n }\n\n #offEvent<K extends keyof E>(event: K) {\n this.#events.delete(event);\n }\n\n #offListener<K extends keyof E>(event: K, listener: EmitterListener<E, K>) {\n const listeners = this.#events.get(event);\n\n if (listeners) {\n listeners.delete(listener);\n }\n }\n\n /**\n * 触发指定事件，调用所有注册的监听器\n * @param event - 要触发的事件名称\n * @param payloads - 传递给监听器的参数\n * @remarks\n * 监听器会按照注册的顺序依次执行，如果某个监听器返回 false，\n * 则后续监听器将不会被执行\n * @example\n * emitter.emit('click', 10, 20);\n */\n emit<K extends keyof E>(event: K, ...payloads: Parameters<EmitterListener<E, K>>) {\n const listeners = this.#events.get(event) as Set<EmitterListener<E, K>> | undefined;\n\n if (!listeners) return;\n\n // 避免在 emit、on 的过程中改变 listeners 从而影响本次 emit\n for (const listener of [...listeners]) {\n if (listener(...payloads) === false) {\n break;\n }\n }\n }\n}\n"],"names":[],"mappings":"AA8BO,MAAM,QAAmE;AAAA,EAC9E,8BAA8C,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWlD,GAAsB,OAAU,UAAiC;AAC/D,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AACxC,QAAI,WAAW;AACb,gBAAU,IAAI,QAAQ;AAAA,IAAA,OACjB;AACA,WAAA,QAAQ,IAAI,OAAO,oBAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYF,KAAwB,OAAU,UAAiC;AAC3D,UAAA,eAAe,IAAI,aAAgD;AACjE,YAAA,SAAS,SAAS,GAAG,QAAQ;AAC9B,WAAA,IAAI,OAAO,YAAY;AACrB,aAAA;AAAA,IACT;AACK,SAAA,GAAG,OAAO,YAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB7B,IAAuB,OAAW,UAAkC;AAClE,QAAI,SAAS,UAAU;AAChB,WAAA,aAAa,OAAO,QAAQ;AAAA,eACxB,OAAO;AAChB,WAAK,UAAU,KAAK;AAAA,IAAA,OACf;AACL,WAAK,QAAQ;AAAA,IAAA;AAAA,EACf;AAAA,EAGF,UAAU;AACR,SAAK,QAAQ,MAAM;AAAA,EAAA;AAAA,EAGrB,UAA6B,OAAU;AAChC,SAAA,QAAQ,OAAO,KAAK;AAAA,EAAA;AAAA,EAG3B,aAAgC,OAAU,UAAiC;AACzE,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,WAAW;AACb,gBAAU,OAAO,QAAQ;AAAA,IAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaF,KAAwB,UAAa,UAA6C;AAChF,UAAM,YAAY,KAAK,QAAQ,IAAI,KAAK;AAExC,QAAI,CAAC,UAAW;AAGhB,eAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,UAAI,SAAS,GAAG,QAAQ,MAAM,OAAO;AACnC;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;"}
|
package/dist/index.cjs
CHANGED
package/dist/index.mjs
CHANGED
package/dist/version.cjs
CHANGED
|
@@ -1,15 +1,24 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
+
const regexp = require("./regexp.cjs");
|
|
3
4
|
const type = require("./type.cjs");
|
|
4
|
-
function internal_numerical(
|
|
5
|
-
|
|
5
|
+
function internal_numerical(pos, str) {
|
|
6
|
+
if (type.isUndefined(str)) throw new Error(`${pos}不存在`);
|
|
7
|
+
if (!regexp.isInteger(str)) throw new Error(`${pos}不是整数`);
|
|
8
|
+
const num = Number(str);
|
|
9
|
+
if (num < 0) throw new Error(`${pos}不是正整数`);
|
|
10
|
+
return num;
|
|
6
11
|
}
|
|
7
12
|
function versionParse(version) {
|
|
8
|
-
const
|
|
13
|
+
const parts = version.split(".");
|
|
14
|
+
if (parts.length !== 3) {
|
|
15
|
+
throw new Error("版本号格式不正确");
|
|
16
|
+
}
|
|
17
|
+
const [major, minor, patch] = parts;
|
|
9
18
|
return {
|
|
10
|
-
major: internal_numerical(major),
|
|
11
|
-
minor: internal_numerical(minor),
|
|
12
|
-
patch: internal_numerical(patch)
|
|
19
|
+
major: internal_numerical("主版本号", major),
|
|
20
|
+
minor: internal_numerical("次版本号", minor),
|
|
21
|
+
patch: internal_numerical("修订号", patch)
|
|
13
22
|
};
|
|
14
23
|
}
|
|
15
24
|
function versionCompare(version1, version2) {
|
package/dist/version.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n /**\n * 主版本号，当有不兼容的API修改时递增\n */\n major: number;\n /**\n * 次版本号，当有向下兼容的功能新增时递增\n */\n minor: number;\n /**\n * 修订号，当有向下兼容的问题修正时递增\n */\n patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param n -
|
|
1
|
+
{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import { isInteger, isNumerical } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n /**\n * 主版本号，当有不兼容的API修改时递增\n */\n major: number;\n /**\n * 次版本号，当有向下兼容的功能新增时递增\n */\n minor: number;\n /**\n * 修订号，当有向下兼容的问题修正时递增\n */\n patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n if (isUndefined(str)) throw new Error(`${pos}不存在`);\n if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n const num = Number(str);\n if (num < 0) throw new Error(`${pos}不是正整数`);\n return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n const parts = version.split('.');\n\n if (parts.length !== 3) {\n throw new Error('版本号格式不正确');\n }\n\n const [major, minor, patch] = parts;\n\n return {\n major: internal_numerical('主版本号', major),\n minor: internal_numerical('次版本号', minor),\n patch: internal_numerical('修订号', patch),\n };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n const vo1 = versionParse(version1);\n const vo2 = versionParse(version2);\n const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n for (const key of order) {\n const n1 = vo1[key];\n const n2 = vo2[key];\n\n if (n1 > n2) {\n return 1;\n }\n\n if (n1 < n2) {\n return -1;\n }\n }\n\n return 0;\n}\n"],"names":["isUndefined","isInteger"],"mappings":";;;;AA2BA,SAAS,mBAAmB,KAAa,KAAc;AACjD,MAAAA,KAAA,YAAY,GAAG,EAAG,OAAM,IAAI,MAAM,GAAG,GAAG,KAAK;AAC7C,MAAA,CAACC,OAAAA,UAAU,GAAG,SAAS,IAAI,MAAM,GAAG,GAAG,MAAM;AAC3C,QAAA,MAAM,OAAO,GAAG;AACtB,MAAI,MAAM,EAAG,OAAM,IAAI,MAAM,GAAG,GAAG,OAAO;AACnC,SAAA;AACT;AAQO,SAAS,aAAa,SAAgC;AACrD,QAAA,QAAQ,QAAQ,MAAM,GAAG;AAE3B,MAAA,MAAM,WAAW,GAAG;AAChB,UAAA,IAAI,MAAM,UAAU;AAAA,EAAA;AAG5B,QAAM,CAAC,OAAO,OAAO,KAAK,IAAI;AAEvB,SAAA;AAAA,IACL,OAAO,mBAAmB,QAAQ,KAAK;AAAA,IACvC,OAAO,mBAAmB,QAAQ,KAAK;AAAA,IACvC,OAAO,mBAAmB,OAAO,KAAK;AAAA,EACxC;AACF;AASgB,SAAA,eAAe,UAAkB,UAA0B;AACnE,QAAA,MAAM,aAAa,QAAQ;AAC3B,QAAA,MAAM,aAAa,QAAQ;AACjC,QAAM,QAAiC,CAAC,SAAS,SAAS,OAAO;AAEjE,aAAW,OAAO,OAAO;AACjB,UAAA,KAAK,IAAI,GAAG;AACZ,UAAA,KAAK,IAAI,GAAG;AAElB,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAGT,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAAA,EACT;AAGK,SAAA;AACT;;;"}
|
package/dist/version.mjs
CHANGED
|
@@ -1,13 +1,22 @@
|
|
|
1
|
+
import { isInteger } from "./regexp.mjs";
|
|
1
2
|
import { isUndefined } from "./type.mjs";
|
|
2
|
-
function internal_numerical(
|
|
3
|
-
|
|
3
|
+
function internal_numerical(pos, str) {
|
|
4
|
+
if (isUndefined(str)) throw new Error(`${pos}不存在`);
|
|
5
|
+
if (!isInteger(str)) throw new Error(`${pos}不是整数`);
|
|
6
|
+
const num = Number(str);
|
|
7
|
+
if (num < 0) throw new Error(`${pos}不是正整数`);
|
|
8
|
+
return num;
|
|
4
9
|
}
|
|
5
10
|
function versionParse(version) {
|
|
6
|
-
const
|
|
11
|
+
const parts = version.split(".");
|
|
12
|
+
if (parts.length !== 3) {
|
|
13
|
+
throw new Error("版本号格式不正确");
|
|
14
|
+
}
|
|
15
|
+
const [major, minor, patch] = parts;
|
|
7
16
|
return {
|
|
8
|
-
major: internal_numerical(major),
|
|
9
|
-
minor: internal_numerical(minor),
|
|
10
|
-
patch: internal_numerical(patch)
|
|
17
|
+
major: internal_numerical("主版本号", major),
|
|
18
|
+
minor: internal_numerical("次版本号", minor),
|
|
19
|
+
patch: internal_numerical("修订号", patch)
|
|
11
20
|
};
|
|
12
21
|
}
|
|
13
22
|
function versionCompare(version1, version2) {
|
package/dist/version.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.mjs","sources":["../src/version.ts"],"sourcesContent":["import { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n /**\n * 主版本号，当有不兼容的API修改时递增\n */\n major: number;\n /**\n * 次版本号，当有向下兼容的功能新增时递增\n */\n minor: number;\n /**\n * 修订号，当有向下兼容的问题修正时递增\n */\n patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param n -
|
|
1
|
+
{"version":3,"file":"version.mjs","sources":["../src/version.ts"],"sourcesContent":["import { isInteger, isNumerical } from './regexp';\nimport { isUndefined } from './type';\n\n/**\n * 表示包含主版本号、次版本号和修订号的对象\n */\nexport type VersionObject = {\n /**\n * 主版本号，当有不兼容的API修改时递增\n */\n major: number;\n /**\n * 次版本号，当有向下兼容的功能新增时递增\n */\n minor: number;\n /**\n * 修订号，当有向下兼容的问题修正时递增\n */\n patch: number;\n};\n\n/**\n * 将数字转换为安全的数值，如果输入为NaN则返回0\n * @param pos - 位置描述，用于错误提示\n * @param str - 要转换的数字字符串\n * @returns 安全的数字（如果输入为NaN则返回0）\n */\nfunction internal_numerical(pos: string, str?: string) {\n if (isUndefined(str)) throw new Error(`${pos}不存在`);\n if (!isInteger(str)) throw new Error(`${pos}不是整数`);\n const num = Number(str);\n if (num < 0) throw new Error(`${pos}不是正整数`);\n return num;\n}\n\n/**\n * 将语义化版本号字符串解析为VersionObject对象\n * @param version - 要解析的版本号字符串 (例如 \"1.2.3\")\n * @returns 包含主版本号、次版本号和修订号的对象\n * @throws 如果版本号字符串格式无效将抛出错误\n */\nexport function versionParse(version: string): VersionObject {\n const parts = version.split('.');\n\n if (parts.length !== 3) {\n throw new Error('版本号格式不正确');\n }\n\n const [major, minor, patch] = parts;\n\n return {\n major: internal_numerical('主版本号', major),\n minor: internal_numerical('次版本号', minor),\n patch: internal_numerical('修订号', patch),\n };\n}\n\n/**\n * 比较两个语义化版本号字符串\n * @param version1 - 要比较的第一个版本号字符串\n * @param version2 - 要比较的第二个版本号字符串\n * @returns 如果version1较大返回1，version2较大返回-1，相等返回0\n * @throws 如果任一版本号字符串格式无效将抛出错误\n */\nexport function versionCompare(version1: string, version2: string): number {\n const vo1 = versionParse(version1);\n const vo2 = versionParse(version2);\n const order: (keyof VersionObject)[] = ['major', 'minor', 'patch'];\n\n for (const key of order) {\n const n1 = vo1[key];\n const n2 = vo2[key];\n\n if (n1 > n2) {\n return 1;\n }\n\n if (n1 < n2) {\n return -1;\n }\n }\n\n return 0;\n}\n"],"names":[],"mappings":";;AA2BA,SAAS,mBAAmB,KAAa,KAAc;AACjD,MAAA,YAAY,GAAG,EAAG,OAAM,IAAI,MAAM,GAAG,GAAG,KAAK;AAC7C,MAAA,CAAC,UAAU,GAAG,SAAS,IAAI,MAAM,GAAG,GAAG,MAAM;AAC3C,QAAA,MAAM,OAAO,GAAG;AACtB,MAAI,MAAM,EAAG,OAAM,IAAI,MAAM,GAAG,GAAG,OAAO;AACnC,SAAA;AACT;AAQO,SAAS,aAAa,SAAgC;AACrD,QAAA,QAAQ,QAAQ,MAAM,GAAG;AAE3B,MAAA,MAAM,WAAW,GAAG;AAChB,UAAA,IAAI,MAAM,UAAU;AAAA,EAAA;AAG5B,QAAM,CAAC,OAAO,OAAO,KAAK,IAAI;AAEvB,SAAA;AAAA,IACL,OAAO,mBAAmB,QAAQ,KAAK;AAAA,IACvC,OAAO,mBAAmB,QAAQ,KAAK;AAAA,IACvC,OAAO,mBAAmB,OAAO,KAAK;AAAA,EACxC;AACF;AASgB,SAAA,eAAe,UAAkB,UAA0B;AACnE,QAAA,MAAM,aAAa,QAAQ;AAC3B,QAAA,MAAM,aAAa,QAAQ;AACjC,QAAM,QAAiC,CAAC,SAAS,SAAS,OAAO;AAEjE,aAAW,OAAO,OAAO;AACjB,UAAA,KAAK,IAAI,GAAG;AACZ,UAAA,KAAK,IAAI,GAAG;AAElB,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAGT,QAAI,KAAK,IAAI;AACJ,aAAA;AAAA,IAAA;AAAA,EACT;AAGK,SAAA;AACT;"}
|