@mi-avalon/libs 0.0.20 → 0.0.22

package/dist/utils/version.js

@@ -0,0 +1,192 @@
+/**
+ * 版本号工具类
+ * 支持语义化版本 (SemVer) 和基本版本号比较
+ */
+export class VersionUtil {
+    /**
+     * 验证版本号格式是否有效
+     * @param version 版本号字符串
+     * @returns 是否有效
+     */
+    static isValid(version) {
+        const semverRegex = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/i;
+        return semverRegex.test(version);
+    }
+    /**
+     * 比较两个版本号
+     * @param v1 版本号1
+     * @param v2 版本号2
+     * @returns 比较结果: 1(v1>v2), 0(v1=v2), -1(v1<v2)
+     */
+    static compare(v1, v2) {
+        if (!this.isValid(v1) || !this.isValid(v2)) {
+            throw new Error('Invalid version format');
+        }
+        // 去除前缀v并分割版本号
+        const normalize = (v) => v.replace(/^v/, '').split(/[-+]/)[0].split('.');
+        const parts1 = normalize(v1);
+        const parts2 = normalize(v2);
+        for (let i = 0; i < 3; i++) {
+            const num1 = parseInt(parts1[i] || '0', 10);
+            const num2 = parseInt(parts2[i] || '0', 10);
+            if (num1 > num2)
+                return 1;
+            if (num1 < num2)
+                return -1;
+        }
+        // 比较预发布版本
+        const preRelease1 = v1.match(/-(.+)/);
+        const preRelease2 = v2.match(/-(.+)/);
+        if (preRelease1 && !preRelease2)
+            return -1;
+        if (!preRelease1 && preRelease2)
+            return 1;
+        if (preRelease1 && preRelease2) {
+            return preRelease1[1].localeCompare(preRelease2[1]);
+        }
+        return 0;
+    }
+    /**
+     * 检查版本号是否满足范围要求
+     * @param version 要检查的版本
+     * @param range 版本范围 (如 ">=1.0.0 <2.0.0") 支持: >, >=, <, <=, ^, ~, ==, =
+     * @returns 是否满足
+     */
+    static satisfies(version, range) {
+        if (!this.isValid(version))
+            return false;
+        const rangeRegex = /([<>]=?|==?|\^|~)?\s*v?([0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+)?)/g;
+        const ranges = range.match(rangeRegex);
+        if (!ranges || ranges.length === 0)
+            return false;
+        return ranges.every(r => {
+            const match = r.match(/([<>]=?|==?|\^|~)?\s*(v?[0-9].*)/);
+            if (!match)
+                return false;
+            const operator = match[1] || '==';
+            const rangeVersion = match[2];
+            if (!this.isValid(rangeVersion))
+                return false;
+            const comparison = this.compare(version, rangeVersion);
+            switch (operator) {
+                case '>':
+                    return comparison > 0;
+                case '>=':
+                    return comparison >= 0;
+                case '<':
+                    return comparison < 0;
+                case '<=':
+                    return comparison <= 0;
+                case '^':
+                    return this.caretRange(version, rangeVersion);
+                case '~':
+                    return this.tildeRange(version, rangeVersion);
+                case '=':
+                case '==':
+                default:
+                    return comparison === 0;
+            }
+        });
+    }
+    /**
+     * 处理 ^ 范围 (允许不修改最左边的非零数字)
+     * @param version 版本号
+     * @param range 范围版本
+     * @returns 是否匹配
+     */
+    static caretRange(version, range) {
+        const normalize = (v) => v.replace(/^v/, '').split(/[-+]/)[0].split('.');
+        const vParts = normalize(version);
+        const rParts = normalize(range);
+        // 找到第一个非零部分
+        let firstNonZero = 0;
+        for (let i = 0; i < rParts.length; i++) {
+            if (parseInt(rParts[i], 10) !== 0) {
+                firstNonZero = i;
+                break;
+            }
+        }
+        for (let i = 0; i <= firstNonZero; i++) {
+            const vNum = parseInt(vParts[i] || '0', 10);
+            const rNum = parseInt(rParts[i] || '0', 10);
+            if (vNum !== rNum)
+                return false;
+        }
+        return this.compare(version, range) >= 0;
+    }
+    /**
+     * 处理 ~ 范围 (允许修改最后一位数字)
+     * @param version 版本号
+     * @param range 范围版本
+     * @returns 是否匹配
+     */
+    static tildeRange(version, range) {
+        const normalize = (v) => v.replace(/^v/, '').split(/[-+]/)[0].split('.');
+        const vParts = normalize(version);
+        const rParts = normalize(range);
+        for (let i = 0; i < rParts.length - 1; i++) {
+            const vNum = parseInt(vParts[i] || '0', 10);
+            const rNum = parseInt(rParts[i] || '0', 10);
+            if (vNum !== rNum)
+                return false;
+        }
+        const lastVNum = parseInt(vParts[rParts.length - 1] || '0', 10);
+        const lastRNum = parseInt(rParts[rParts.length - 1] || '0', 10);
+        return lastVNum >= lastRNum;
+    }
+    /**
+     * 获取主版本号 (major)
+     * @param version 版本号
+     * @returns 主版本号
+     */
+    static getMajor(version) {
+        if (!this.isValid(version))
+            throw new Error('Invalid version format');
+        const parts = version.replace(/^v/, '').split('.');
+        return parseInt(parts[0], 10);
+    }
+    /**
+     * 获取次版本号 (minor)
+     * @param version 版本号
+     * @returns 次版本号
+     */
+    static getMinor(version) {
+        if (!this.isValid(version))
+            throw new Error('Invalid version format');
+        const parts = version.replace(/^v/, '').split('.');
+        return parseInt(parts[1] || '0', 10);
+    }
+    /**
+     * 获取修订号 (patch)
+     * @param version 版本号
+     * @returns 修订号
+     */
+    static getPatch(version) {
+        if (!this.isValid(version))
+            throw new Error('Invalid version format');
+        const parts = version.replace(/^v/, '').split('.');
+        return parseInt(parts[2] || '0', 10);
+    }
+    /**
+     * 获取预发布版本标识
+     * @param version 版本号
+     * @returns 预发布标识 (无则返回null)
+     */
+    static getPrerelease(version) {
+        if (!this.isValid(version))
+            throw new Error('Invalid version format');
+        const match = version.match(/-([^+]+)/);
+        return match ? match[1] : null;
+    }
+    /**
+     * 获取构建元数据
+     * @param version 版本号
+     * @returns 构建元数据 (无则返回null)
+     */
+    static getBuildMetadata(version) {
+        if (!this.isValid(version))
+            throw new Error('Invalid version format');
+        const match = version.match(/\+([^]+)/);
+        return match ? match[1] : null;
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@mi-avalon/libs",
 	"private": false,
-	"version": "0.0.20",
+	"version": "0.0.22",
 	"type": "module",
 	"main": "./dist/index.umd.js",
 	"module": "./dist/index.es.js",
@@ -9,10 +9,14 @@
 	"files": [
 		"dist"
 	],
+	"publishConfig": {
+		"access": "public"
+	},
 	"scripts": {
 		"dev": "vite",
 		"build": "vite build && tsc",
-		"preview": "vite preview"
+		"preview": "vite preview",
+		"pub": "npm run build && npm publish"
 	},
 	"devDependencies": {
 		"@types/node": "^20.0.0",

package/dist/components/utils.d.ts

@@ -1 +0,0 @@
-export declare const getClassName: (key1: string, key2: string) => string;

package/dist/components/utils.js

@@ -1,16 +0,0 @@
-// 生成类名
-export const getClassName = (key1, key2) => {
-    const cn = key1;
-    let str = key1;
-    if (key2.includes(' ')) {
-        str = '';
-        const nArr = key2?.split(' ');
-        for (const i of nArr) {
-            str += ` ${cn}-${i}`;
-        }
-    }
-    else if (key2) {
-        str = `${key1}-${key2}`;
-    }
-    return str;
-};