node-karin 1.12.0 → 1.12.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## [1.12.1](https://github.com/KarinJS/Karin/compare/core-v1.12.0...core-v1.12.1) (2025-10-17)
+
+
+### 🐛 Bug Fixes
+
+* Support all semantic versioning formats in changelog parser ([#566](https://github.com/KarinJS/Karin/issues/566)) ([de6b397](https://github.com/KarinJS/Karin/commit/de6b397ebb9fdba85d8b5999a96ed29bb1da9dd8))
+
 ## [1.12.0](https://github.com/KarinJS/Karin/compare/core-v1.11.6...core-v1.12.0) (2025-10-15)
 
 

package/dist/index.d.ts

@@ -8327,28 +8327,36 @@ declare const lock: {
 
 /**
  * 提取指定版本号的更新日志
- * @param version 版本号
- * @param data `CHANGELOG.md`文件内容
- * @returns 更新日志
+ * @param version 版本号，可包含预发布/构建元数据（如 `-beta`）
+ * @param data `CHANGELOG.md` 文件内容
+ * @returns 命中的更新日志字符串；无法定位返回 `null`
+ * @description
+ * - 先将版本规范化为稳定版 `x.y.z`；
+ * - 不存在时按新 -> 旧顺序回退到不超过目标稳定版的最新版本。
  */
 declare const log: (version: string, data: string) => string | null;
 /**
- * 提取指定范围版本号的更新日志
+ * 从指定版本开始提取连续的更新日志
  * @param version 起始版本号
- * @param data `CHANGELOG.md`文件内容
- * @param length 提取长度
- * @param reverse 是否反向提取 默认为`false`向后提取
+ * @param data `CHANGELOG.md` 文件内容
+ * @param length 提取条数，默认为 1
+ * @param reverse 是否反向提取；`false` 向后，`true` 向前
+ * @returns 拼接后的更新日志字符串；找不到起始版本返回空字符串
+ * @description
+ * - 起始版本会规范化并回退到不超过目标稳定版的最新版本；
+ * - 切片范围将做边界裁剪以避免越界。
  */
 declare const logs: (version: string, data: string, length?: number, reverse?: boolean) => string;
 /**
- * 提取指定版本号之间的更新日志
- * @param data `CHANGELOG.md`文件内容
- * @param startVersion 起始版本号
- * @param endVersion 结束版本号
+ * 提取指定版本区间的更新日志
+ * @param data `CHANGELOG.md` 文件内容
+ * @param startVersion 起始版本号（较旧）
+ * @param endVersion 结束版本号（较新）
+ * @returns 拼接后的更新日志字符串；若任一版本无法定位返回空字符串
  * @description
- * - `CHANGELOG.md`的版本号排序约定为从新到旧
- * - 也就是说 结束版本号应该比起始版本号新
- * - 举例: `range(data, '1.0.0', '2.0.0')` 提取`1.0.0`到`2.0.0`之间的更新日志
+ * - CHANGELOG 的版本排序约定为从新到旧；
+ * - 若传入版本不存在，将回退到不超过目标稳定版的最新版本；
+ * - 当 `start > end` 时会自动调整为有效区间。
  */
 declare const range: (data: string, startVersion: string, endVersion: string) => string;
 /**

package/dist/index.mjs

@@ -1960,11 +1960,15 @@ __export(changelog_exports, {
   parseChangelog: () => parseChangelog,
   range: () => range
 });
-var log, logs, range, parseChangelog;
+var escapeRegex, log, logs, range, parseChangelog, normalizeStableVersion, parseSemverParts, compareSemver, findFallbackVersionKey;
 var init_changelog = __esm({
   "src/utils/fs/changelog.ts"() {
+    escapeRegex = (str) => {
+      return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    };
     log = (version2, data) => {
-      const regex = new RegExp(`## \\[${version2}\\](.|\\n)*?(?=## \\[|$)`, "g");
+      const escapedVersion = escapeRegex(version2);
+      const regex = new RegExp(`## \\[${escapedVersion}\\](.|\\n)*?(?=## \\[|$)`, "g");
       const match = data.match(regex);
       return match ? match[0] : null;
     };
@@ -1974,17 +1978,24 @@ var init_changelog = __esm({
       }
       const list2 = parseChangelog(data);
       const keys = Object.keys(list2);
-      const index5 = keys.indexOf(version2);
+      const startKey = findFallbackVersionKey(keys, version2);
+      if (!startKey) return "";
+      const index5 = keys.indexOf(startKey);
       const start3 = reverse ? index5 - length : index5;
       const end = reverse ? index5 : index5 + length;
-      const versions = keys.slice(start3, end).map((key) => list2[key] ? list2[key] : "");
+      const sliceStart = Math.max(0, start3);
+      const sliceEnd = Math.min(keys.length, end);
+      const versions = keys.slice(sliceStart, sliceEnd).map((key) => list2[key] ? list2[key] : "");
       return versions.join("");
     };
     range = (data, startVersion, endVersion) => {
       const list2 = parseChangelog(data);
       const keys = Object.keys(list2);
-      const start3 = keys.indexOf(startVersion);
-      const end = keys.indexOf(endVersion);
+      const startKey = findFallbackVersionKey(keys, startVersion);
+      const endKey = findFallbackVersionKey(keys, endVersion);
+      if (!startKey || !endKey) return "";
+      const start3 = keys.indexOf(startKey);
+      const end = keys.indexOf(endKey);
       if (start3 > end) {
         const versions2 = keys.slice(end, start3).map((key) => list2[key] ? list2[key] : "");
         return versions2.join("");
@@ -2002,6 +2013,38 @@ var init_changelog = __esm({
       }
       return changelog;
     };
+    normalizeStableVersion = (ver) => {
+      const m = ver.match(/(\d+)\.(\d+)\.(\d+)/);
+      return m ? `${m[1]}.${m[2]}.${m[3]}` : ver;
+    };
+    parseSemverParts = (ver) => {
+      const v = normalizeStableVersion(ver);
+      const m = v.match(/^(\d+)\.(\d+)\.(\d+)$/);
+      return m ? [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)] : null;
+    };
+    compareSemver = (a, b) => {
+      const pa = parseSemverParts(a);
+      const pb = parseSemverParts(b);
+      if (!pa && !pb) return 0;
+      if (!pa) return -1;
+      if (!pb) return 1;
+      if (pa[0] !== pb[0]) return pa[0] - pb[0];
+      if (pa[1] !== pb[1]) return pa[1] - pb[1];
+      if (pa[2] !== pb[2]) return pa[2] - pb[2];
+      return 0;
+    };
+    findFallbackVersionKey = (keys, input2) => {
+      if (keys.includes(input2)) return input2;
+      const target = normalizeStableVersion(input2);
+      if (keys.includes(target)) return target;
+      for (const key of keys) {
+        const kval = normalizeStableVersion(key);
+        if (compareSemver(kval, target) <= 0) {
+          return key;
+        }
+      }
+      return null;
+    };
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "Lightweight, efficient, concise, and stable robot framework.",
   "keywords": [
     "node",