@helpers4/version 2.0.0-alpha.2 → 2.0.0-alpha.21

package/README.md

@@ -9,21 +9,26 @@ A set of helpers for working with URLs.
 
 ## Documentation
 
-[https://helpers4.js.org/version](https://helpers4.js.org/version)
+[https://helpers4.dev/typescript/categories/version/](https://helpers4.dev/typescript/categories/version/)
 
 <!-- AUTOMATIC-METHODS -->
-- stripV
 - compare
-- satisfiesRange
 - increment
+- isPrerelease
+- parse
+- satisfiesRange
+- stringify
+- stripV
 <!-- /AUTOMATIC-METHODS -->
 
 ## See
 
 <!-- AUTOMATIC-SIBLINGS -->
 - [array](../array)
+- [commit](../commit)
 - [date](../date)
 - [function](../function)
+- [math](../math)
 - [number](../number)
 - [object](../object)
 - [observable](../observable)
@@ -39,14 +44,16 @@ A set of helpers for working with URLs.
 | Name | Package | Source Code | Description |
 |------|---------|-------------|-------------|
 | array | [@helpers4/array](https://www.npmjs.com/package/@helpers4/array) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/array) | Array manipulation utilities |
-| date | [@helpers4/date](https://www.npmjs.com/package/@helpers4/date) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/date) | date utilities |
+| commit | [@helpers4/commit](https://www.npmjs.com/package/@helpers4/commit) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/commit) | Conventional Commits parsing and analysis |
+| date | [@helpers4/date](https://www.npmjs.com/package/@helpers4/date) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/date) | Date and time utility functions |
 | function | [@helpers4/function](https://www.npmjs.com/package/@helpers4/function) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/function) | Function utilities and type guards |
-| number | [@helpers4/number](https://www.npmjs.com/package/@helpers4/number) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/number) | number utilities |
+| math | [@helpers4/math](https://www.npmjs.com/package/@helpers4/math) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/math) | Mathematical utility functions and calculations |
+| number | [@helpers4/number](https://www.npmjs.com/package/@helpers4/number) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/number) | Number utility functions and validation |
 | object | [@helpers4/object](https://www.npmjs.com/package/@helpers4/object) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/object) | Object manipulation utilities |
 | observable | [@helpers4/observable](https://www.npmjs.com/package/@helpers4/observable) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/observable) | Observable utilities and combinators |
 | promise | [@helpers4/promise](https://www.npmjs.com/package/@helpers4/promise) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/promise) | Promise utilities and error handling |
 | string | [@helpers4/string](https://www.npmjs.com/package/@helpers4/string) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/string) | String manipulation and formatting utilities |
-| type | [@helpers4/type](https://www.npmjs.com/package/@helpers4/type) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/type) | type utilities |
+| type | [@helpers4/type](https://www.npmjs.com/package/@helpers4/type) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/type) | Type checking and validation utilities |
 | url | [@helpers4/url](https://www.npmjs.com/package/@helpers4/url) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/url) | URL parsing and manipulation utilities |
 | version | [@helpers4/version](https://www.npmjs.com/package/@helpers4/version) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/version) | Version string manipulation utilities |
 <!-- /AUTOMATIC-CATEGORIES-TABLE -->

package/lib/index.d.ts

@@ -1,4 +1,192 @@
-export declare function stripV(version: string): string; export function stripV(version: null): null; export function stripV(version: undefined): undefined; export function stripV(version: string | null | undefined): string | null | undefined;
-export declare function compare(version1: string, version2: string): number;
-export declare function satisfiesRange(version: string, range: string): boolean;
-export declare function increment(version: string, type: 'major' | 'minor' | 'patch'): string;
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+/**
+ * Compares two semantic version strings according to SemVer 2.0.0 specification
+ *
+ * Supports:
+ * - Core version: MAJOR.MINOR.PATCH
+ * - Pre-release: -alpha, -beta.1, -rc.1, etc.
+ * - Build metadata: +build, +sha.abc123 (ignored in comparison per spec)
+ * - Optional 'v' prefix
+ *
+ * @param version1 - First version string
+ * @param version2 - Second version string
+ * @returns -1 if version1 < version2, 0 if equal, 1 if version1 > version2
+ * @example
+ * compare('1.0.0', '2.0.0') // -1
+ * compare('1.0.0-alpha', '1.0.0') // -1 (prerelease < release)
+ * compare('1.0.0-alpha', '1.0.0-beta') // -1
+ * compare('1.0.0-alpha.1', '1.0.0-alpha.2') // -1
+ * compare('1.0.0+build1', '1.0.0+build2') // 0 (build metadata ignored)
+ * @since 1.9.0
+ */
+declare function compare(version1: string, version2: string): number;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+/**
+ * Increments a semantic version
+ * @param version - The version to increment
+ * @param type - The increment type ('major', 'minor', 'patch')
+ * @returns Incremented version string
+ * @since 1.9.0
+ */
+declare function increment(version: string, type: 'major' | 'minor' | 'patch'): string;
+declare function increment(version: undefined, type: 'major' | 'minor' | 'patch'): undefined;
+declare function increment(version: null, type: 'major' | 'minor' | 'patch'): null;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+/**
+ * Represents a parsed semantic version according to SemVer 2.0.0 specification
+ * @since 2.0.0
+ */
+interface ParsedVersion {
+    /** Major version number */
+    major: number;
+    /** Minor version number */
+    minor: number;
+    /** Patch version number */
+    patch: number;
+    /** Pre-release identifiers (e.g., ['alpha', '1'] for -alpha.1) */
+    prerelease: string[];
+    /** Build metadata identifiers (e.g., ['build', '123'] for +build.123) */
+    build: string[];
+}
+/**
+ * Parses a semantic version string into its components according to SemVer 2.0.0 specification
+ *
+ * Supports:
+ * - Core version: MAJOR.MINOR.PATCH
+ * - Pre-release: -alpha, -beta.1, -rc.1, -0.3.7, -x.7.z.92
+ * - Build metadata: +build, +sha.abc123, +20130313144700
+ * - Optional 'v' prefix (commonly used in git tags)
+ *
+ * @param version - Version string to parse
+ * @returns Parsed version object with major, minor, patch, prerelease, and build
+ * @example
+ * parse('1.2.3') // { major: 1, minor: 2, patch: 3, prerelease: [], build: [] }
+ * parse('v1.0.0-alpha.1') // { major: 1, minor: 0, patch: 0, prerelease: ['alpha', '1'], build: [] }
+ * parse('2.0.0+build.123') // { major: 2, minor: 0, patch: 0, prerelease: [], build: ['build', '123'] }
+ * parse('1.0.0-beta+exp.sha.5114f85') // { major: 1, minor: 0, patch: 0, prerelease: ['beta'], build: ['exp', 'sha', '5114f85'] }
+ * @since 2.0.0
+ */
+declare function parse(version: string): ParsedVersion;
+declare function parse(version: undefined): undefined;
+declare function parse(version: null): null;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+
+/**
+ * Returns `true` when the version string has a prerelease suffix
+ * (i.e. contains a `-` after the core `MAJOR.MINOR.PATCH`).
+ *
+ * @param version - A semantic version string (e.g. `'2.0.0-alpha.1'`, `'1.0.0'`).
+ * @returns `true` if the version is a prerelease, `false` otherwise.
+ * @example
+ * isPrerelease('2.0.0-alpha.1') // true
+ * isPrerelease('1.0.0-rc.0')   // true
+ * isPrerelease('1.0.0')        // false
+ * isPrerelease('2.1.0')        // false
+ * @since next
+ */
+declare function isPrerelease(version: string): boolean;
+/**
+ * Returns `true` when the parsed version has at least one prerelease identifier.
+ *
+ * @param version - A {@link ParsedVersion} object (as returned by {@link parse}).
+ * @returns `true` if `version.prerelease` is non-empty, `false` otherwise.
+ * @example
+ * isPrerelease(parse('2.0.0-alpha.1')) // true
+ * isPrerelease(parse('1.0.0'))         // false
+ * @since next
+ */
+declare function isPrerelease(version: ParsedVersion): boolean;
+declare function isPrerelease(version: undefined): undefined;
+declare function isPrerelease(version: null): null;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+/**
+ * Checks if a version satisfies a range (simple implementation)
+ * @param version - Version to check
+ * @param range - Range pattern (e.g., ">=1.0.0", "~1.2.0", "^1.0.0")
+ * @returns True if version satisfies the range
+ * @since 1.9.0
+ */
+declare function satisfiesRange(version: string, range: string): boolean;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+
+/**
+ * Reconstruct a semantic version string from a {@link ParsedVersion} object.
+ *
+ * This is the inverse of {@link parse}:
+ * `stringify(parse(v)) === stripV(v)` for any valid SemVer string `v`.
+ *
+ * @param parsed - A parsed semantic version object.
+ * @returns The reconstructed version string (without leading `v`).
+ * @example
+ * stringify({ major: 1, minor: 2, patch: 3, prerelease: [], build: [] })
+ * // => '1.2.3'
+ * @example
+ * stringify({ major: 2, minor: 0, patch: 0, prerelease: ['alpha', '1'], build: [] })
+ * // => '2.0.0-alpha.1'
+ * @example
+ * stringify({ major: 1, minor: 0, patch: 0, prerelease: ['beta'], build: ['exp', 'sha', '5114f85'] })
+ * // => '1.0.0-beta+exp.sha.5114f85'
+ * @since next
+ */
+declare function stringify(parsed: ParsedVersion): string;
+declare function stringify(parsed: undefined): undefined;
+declare function stringify(parsed: null): null;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+/**
+ * Strip the leading "v" from a version string if it exists.
+ *
+ * @param version - The version string to process
+ * @returns The version string without leading "v", or the original value if it's not a string or doesn't start with "v"
+ *
+ * @example
+ * ```typescript
+ * stripV("v1.2.3")     // "1.2.3"
+ * stripV("1.2.3")      // "1.2.3"
+ * stripV("v20.1.0")    // "20.1.0"
+ * stripV(null)         // null
+ * stripV(undefined)    // undefined
+ * stripV("")           // ""
+ * stripV("1.0.0-beta") // "1.0.0-beta"
+ * ```
+ * @since 1.9.0
+ */
+declare function stripV(version: string): string;
+declare function stripV(version: null): null;
+declare function stripV(version: undefined): undefined;
+
+export { compare, increment, isPrerelease, parse, satisfiesRange, stringify, stripV };
+export type { ParsedVersion };

package/lib/index.js

@@ -1,108 +1,182 @@
-// helpers/version/stripV.ts
-function stripV(version) {
-  return typeof version === "string" && version.startsWith("v") ? version.slice(1) : version;
+//#region helpers/version/parse.ts
+function parse(version) {
+	if (version === void 0 || version === null) return version;
+	const [versionWithPrerelease, buildString] = version.replace(/^v/, "").split("+");
+	const build = buildString ? buildString.split(".") : [];
+	const [coreVersion, prereleaseString] = versionWithPrerelease.split("-");
+	const prerelease = prereleaseString ? prereleaseString.split(".") : [];
+	const parts = coreVersion.split(".").map(Number);
+	return {
+		major: parts[0] || 0,
+		minor: parts[1] || 0,
+		patch: parts[2] || 0,
+		prerelease,
+		build
+	};
+}
+//#endregion
+//#region helpers/version/compare.ts
+/**
+* This file is part of helpers4.
+* Copyright (C) 2025 baxyz
+* SPDX-License-Identifier: LGPL-3.0-or-later
+*/
+/**
+* Compares two prerelease identifier arrays according to SemVer spec
+* Rules:
+* - Numeric identifiers are compared as integers
+* - Alphanumeric identifiers are compared lexically (ASCII)
+* - Numeric identifiers have lower precedence than alphanumeric
+* - A larger set of prerelease fields has higher precedence if all preceding are equal
+* @param pre1 - First prerelease array
+* @param pre2 - Second prerelease array
+* @returns -1, 0, or 1
+*/
+function comparePrerelease(pre1, pre2) {
+	if (pre1.length === 0 && pre2.length === 0) return 0;
+	if (pre1.length === 0) return 1;
+	if (pre2.length === 0) return -1;
+	const maxLength = Math.max(pre1.length, pre2.length);
+	for (let i = 0; i < maxLength; i++) {
+		if (i >= pre1.length) return -1;
+		if (i >= pre2.length) return 1;
+		const id1 = pre1[i];
+		const id2 = pre2[i];
+		const isNum1 = /^\d+$/.test(id1);
+		const isNum2 = /^\d+$/.test(id2);
+		if (isNum1 && isNum2) {
+			const num1 = parseInt(id1, 10);
+			const num2 = parseInt(id2, 10);
+			if (num1 < num2) return -1;
+			if (num1 > num2) return 1;
+		} else if (isNum1) return -1;
+		else if (isNum2) return 1;
+		else {
+			if (id1 < id2) return -1;
+			if (id1 > id2) return 1;
+		}
+	}
+	return 0;
 }
-// helpers/version/compare.ts
+/**
+* Compares two semantic version strings according to SemVer 2.0.0 specification
+*
+* Supports:
+* - Core version: MAJOR.MINOR.PATCH
+* - Pre-release: -alpha, -beta.1, -rc.1, etc.
+* - Build metadata: +build, +sha.abc123 (ignored in comparison per spec)
+* - Optional 'v' prefix
+*
+* @param version1 - First version string
+* @param version2 - Second version string
+* @returns -1 if version1 < version2, 0 if equal, 1 if version1 > version2
+* @example
+* compare('1.0.0', '2.0.0') // -1
+* compare('1.0.0-alpha', '1.0.0') // -1 (prerelease < release)
+* compare('1.0.0-alpha', '1.0.0-beta') // -1
+* compare('1.0.0-alpha.1', '1.0.0-alpha.2') // -1
+* compare('1.0.0+build1', '1.0.0+build2') // 0 (build metadata ignored)
+* @since 1.9.0
+*/
 function compare(version1, version2) {
-  const normalize = (v) => v.replace(/^v/, "");
-  const v1 = normalize(version1);
-  const v2 = normalize(version2);
-  const parts1 = v1.split(".").map(Number);
-  const parts2 = v2.split(".").map(Number);
-  const maxLength = Math.max(parts1.length, parts2.length);
-  for (let i = 0;i < maxLength; i++) {
-    const part1 = parts1[i] || 0;
-    const part2 = parts2[i] || 0;
-    if (part1 < part2)
-      return -1;
-    if (part1 > part2)
-      return 1;
-  }
-  return 0;
+	const v1 = parse(version1);
+	const v2 = parse(version2);
+	if (v1.major !== v2.major) return v1.major < v2.major ? -1 : 1;
+	if (v1.minor !== v2.minor) return v1.minor < v2.minor ? -1 : 1;
+	if (v1.patch !== v2.patch) return v1.patch < v2.patch ? -1 : 1;
+	return comparePrerelease(v1.prerelease, v2.prerelease);
+}
+//#endregion
+//#region helpers/version/increment.ts
+function increment(version, type) {
+	if (version === void 0 || version === null) return version;
+	const hasV = version.startsWith("v");
+	const parts = version.replace(/^v/, "").split(".").map(Number);
+	while (parts.length < 3) parts.push(0);
+	let [major, minor, patch] = parts;
+	switch (type) {
+		case "major":
+			major++;
+			minor = 0;
+			patch = 0;
+			break;
+		case "minor":
+			minor++;
+			patch = 0;
+			break;
+		case "patch":
+			patch++;
+			break;
+		default: throw new Error(`Invalid increment type: ${type}`);
+	}
+	const result = `${major}.${minor}.${patch}`;
+	return hasV ? `v${result}` : result;
 }
-// helpers/version/satisfiesRange.ts
+//#endregion
+//#region helpers/version/isPrerelease.ts
+function isPrerelease(version) {
+	if (version === void 0 || version === null) return version;
+	if (typeof version === "string") return version.split("+")[0].includes("-");
+	return version.prerelease.length > 0;
+}
+//#endregion
+//#region helpers/version/satisfiesRange.ts
+/**
+* This file is part of helpers4.
+* Copyright (C) 2025 baxyz
+* SPDX-License-Identifier: LGPL-3.0-or-later
+*/
+/**
+* Checks if a version satisfies a range (simple implementation)
+* @param version - Version to check
+* @param range - Range pattern (e.g., ">=1.0.0", "~1.2.0", "^1.0.0")
+* @returns True if version satisfies the range
+* @since 1.9.0
+*/
 function satisfiesRange(version, range) {
-  const normalize = (v) => v.replace(/^v/, "");
-  const normalizedVersion = normalize(version);
-  if (!range.match(/[~^<>=]/)) {
-    return normalizedVersion === normalize(range);
-  }
-  if (range.startsWith(">=")) {
-    const targetVersion = normalize(range.slice(2));
-    return compareVersionsSimple(normalizedVersion, targetVersion) >= 0;
-  }
-  if (range.startsWith(">")) {
-    const targetVersion = normalize(range.slice(1));
-    return compareVersionsSimple(normalizedVersion, targetVersion) > 0;
-  }
-  if (range.startsWith("<=")) {
-    const targetVersion = normalize(range.slice(2));
-    return compareVersionsSimple(normalizedVersion, targetVersion) <= 0;
-  }
-  if (range.startsWith("<")) {
-    const targetVersion = normalize(range.slice(1));
-    return compareVersionsSimple(normalizedVersion, targetVersion) < 0;
-  }
-  if (range.startsWith("^")) {
-    const targetVersion = normalize(range.slice(1));
-    const [targetMajor] = targetVersion.split(".").map(Number);
-    const [versionMajor] = normalizedVersion.split(".").map(Number);
-    return versionMajor === targetMajor && compareVersionsSimple(normalizedVersion, targetVersion) >= 0;
-  }
-  if (range.startsWith("~")) {
-    const targetVersion = normalize(range.slice(1));
-    const [targetMajor, targetMinor] = targetVersion.split(".").map(Number);
-    const [versionMajor, versionMinor] = normalizedVersion.split(".").map(Number);
-    return versionMajor === targetMajor && versionMinor === targetMinor && compareVersionsSimple(normalizedVersion, targetVersion) >= 0;
-  }
-  return false;
+	const normalizedVersion = version.replace(/^v/, "");
+	if (!range.match(/[~^<>=]/)) return normalizedVersion === range.replace(/^v/, "");
+	if (range.startsWith(">=")) return compareVersionsSimple(normalizedVersion, range.slice(2).replace(/^v/, "")) >= 0;
+	if (range.startsWith(">")) return compareVersionsSimple(normalizedVersion, range.slice(1).replace(/^v/, "")) > 0;
+	if (range.startsWith("<=")) return compareVersionsSimple(normalizedVersion, range.slice(2).replace(/^v/, "")) <= 0;
+	if (range.startsWith("<")) return compareVersionsSimple(normalizedVersion, range.slice(1).replace(/^v/, "")) < 0;
+	if (range.startsWith("^")) {
+		const targetVersion = range.slice(1).replace(/^v/, "");
+		const [targetMajor] = targetVersion.split(".").map(Number);
+		const [versionMajor] = normalizedVersion.split(".").map(Number);
+		return versionMajor === targetMajor && compareVersionsSimple(normalizedVersion, targetVersion) >= 0;
+	}
+	if (range.startsWith("~")) {
+		const targetVersion = range.slice(1).replace(/^v/, "");
+		const [targetMajor, targetMinor] = targetVersion.split(".").map(Number);
+		const [versionMajor, versionMinor] = normalizedVersion.split(".").map(Number);
+		return versionMajor === targetMajor && versionMinor === targetMinor && compareVersionsSimple(normalizedVersion, targetVersion) >= 0;
+	} else return false;
 }
 function compareVersionsSimple(version1, version2) {
-  const parts1 = version1.split(".").map(Number);
-  const parts2 = version2.split(".").map(Number);
-  const maxLength = Math.max(parts1.length, parts2.length);
-  for (let i = 0;i < maxLength; i++) {
-    const part1 = parts1[i] || 0;
-    const part2 = parts2[i] || 0;
-    if (part1 < part2)
-      return -1;
-    if (part1 > part2)
-      return 1;
-  }
-  return 0;
+	const parts1 = version1.split(".").map(Number);
+	const parts2 = version2.split(".").map(Number);
+	const maxLength = Math.max(parts1.length, parts2.length);
+	for (let i = 0; i < maxLength; i++) {
+		const part1 = parts1[i] || 0;
+		const part2 = parts2[i] || 0;
+		if (part1 < part2) return -1;
+		if (part1 > part2) return 1;
+	}
+	return 0;
 }
-// helpers/version/increment.ts
-function increment(version, type) {
-  const normalize = (v) => v.replace(/^v/, "");
-  const hasV = version.startsWith("v");
-  const normalizedVersion = normalize(version);
-  const parts = normalizedVersion.split(".").map(Number);
-  while (parts.length < 3) {
-    parts.push(0);
-  }
-  let [major, minor, patch] = parts;
-  switch (type) {
-    case "major":
-      major++;
-      minor = 0;
-      patch = 0;
-      break;
-    case "minor":
-      minor++;
-      patch = 0;
-      break;
-    case "patch":
-      patch++;
-      break;
-    default:
-      throw new Error(`Invalid increment type: ${type}`);
-  }
-  const result = `${major}.${minor}.${patch}`;
-  return hasV ? `v${result}` : result;
+//#endregion
+//#region helpers/version/stringify.ts
+function stringify(parsed) {
+	if (parsed === void 0 || parsed === null) return parsed;
+	return `${`${parsed.major}.${parsed.minor}.${parsed.patch}`}${parsed.prerelease.length > 0 ? `-${parsed.prerelease.join(".")}` : ""}${parsed.build.length > 0 ? `+${parsed.build.join(".")}` : ""}`;
+}
+//#endregion
+//#region helpers/version/stripV.ts
+function stripV(version) {
+	return typeof version === "string" && version.startsWith("v") ? version.slice(1) : version;
 }
-export {
-  stripV,
-  satisfiesRange,
-  increment,
-  compare
-};
+//#endregion
+export { compare, increment, isPrerelease, parse, satisfiesRange, stringify, stripV };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../helpers/version/parse.ts","../../../helpers/version/compare.ts","../../../helpers/version/increment.ts","../../../helpers/version/isPrerelease.ts","../../../helpers/version/satisfiesRange.ts","../../../helpers/version/stringify.ts","../../../helpers/version/stripV.ts"],"sourcesContent":["/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Represents a parsed semantic version according to SemVer 2.0.0 specification\n * @since 2.0.0\n */\nexport interface ParsedVersion {\n  /** Major version number */\n  major: number;\n  /** Minor version number */\n  minor: number;\n  /** Patch version number */\n  patch: number;\n  /** Pre-release identifiers (e.g., ['alpha', '1'] for -alpha.1) */\n  prerelease: string[];\n  /** Build metadata identifiers (e.g., ['build', '123'] for +build.123) */\n  build: string[];\n}\n\n/**\n * Parses a semantic version string into its components according to SemVer 2.0.0 specification\n *\n * Supports:\n * - Core version: MAJOR.MINOR.PATCH\n * - Pre-release: -alpha, -beta.1, -rc.1, -0.3.7, -x.7.z.92\n * - Build metadata: +build, +sha.abc123, +20130313144700\n * - Optional 'v' prefix (commonly used in git tags)\n *\n * @param version - Version string to parse\n * @returns Parsed version object with major, minor, patch, prerelease, and build\n * @example\n * parse('1.2.3') // { major: 1, minor: 2, patch: 3, prerelease: [], build: [] }\n * parse('v1.0.0-alpha.1') // { major: 1, minor: 0, patch: 0, prerelease: ['alpha', '1'], build: [] }\n * parse('2.0.0+build.123') // { major: 2, minor: 0, patch: 0, prerelease: [], build: ['build', '123'] }\n * parse('1.0.0-beta+exp.sha.5114f85') // { major: 1, minor: 0, patch: 0, prerelease: ['beta'], build: ['exp', 'sha', '5114f85'] }\n * @since 2.0.0\n */\nexport function parse(version: string): ParsedVersion;\nexport function parse(version: undefined): undefined;\nexport function parse(version: null): null;\nexport function parse(version: string | undefined | null): ParsedVersion | undefined | null {\n  if (version === undefined || version === null) return version;\n  // Remove optional 'v' prefix\n  const normalized = version.replace(/^v/, '');\n\n  // Split build metadata first (everything after +)\n  const [versionWithPrerelease, buildString] = normalized.split('+');\n  const build = buildString ? buildString.split('.') : [];\n\n  // Split prerelease (everything after -)\n  const [coreVersion, prereleaseString] = versionWithPrerelease.split('-');\n  const prerelease = prereleaseString ? prereleaseString.split('.') : [];\n\n  // Parse core version\n  const parts = coreVersion.split('.').map(Number);\n\n  return {\n    major: parts[0] || 0,\n    minor: parts[1] || 0,\n    patch: parts[2] || 0,\n    prerelease,\n    build,\n  };\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\nimport { parse } from './parse';\n\n/**\n * Compares two prerelease identifier arrays according to SemVer spec\n * Rules:\n * - Numeric identifiers are compared as integers\n * - Alphanumeric identifiers are compared lexically (ASCII)\n * - Numeric identifiers have lower precedence than alphanumeric\n * - A larger set of prerelease fields has higher precedence if all preceding are equal\n * @param pre1 - First prerelease array\n * @param pre2 - Second prerelease array\n * @returns -1, 0, or 1\n */\nfunction comparePrerelease(pre1: string[], pre2: string[]): number {\n  // No prerelease has higher precedence than prerelease\n  // e.g., 1.0.0 > 1.0.0-alpha\n  if (pre1.length === 0 && pre2.length === 0) return 0;\n  if (pre1.length === 0) return 1; // No prerelease > prerelease\n  if (pre2.length === 0) return -1; // prerelease < no prerelease\n\n  const maxLength = Math.max(pre1.length, pre2.length);\n\n  for (let i = 0; i < maxLength; i++) {\n    // A larger set has higher precedence if all preceding are equal\n    if (i >= pre1.length) return -1;\n    if (i >= pre2.length) return 1;\n\n    const id1 = pre1[i];\n    const id2 = pre2[i];\n\n    const isNum1 = /^\\d+$/.test(id1);\n    const isNum2 = /^\\d+$/.test(id2);\n\n    // Both numeric: compare as integers\n    if (isNum1 && isNum2) {\n      const num1 = parseInt(id1, 10);\n      const num2 = parseInt(id2, 10);\n      if (num1 < num2) return -1;\n      if (num1 > num2) return 1;\n      // num1 === num2, continue to next identifier\n    }\n    // Numeric has lower precedence than alphanumeric\n    else if (isNum1) {\n      return -1;\n    } else if (isNum2) {\n      return 1;\n    }\n    // Both alphanumeric: compare lexically (ASCII sort)\n    else {\n      if (id1 < id2) return -1;\n      if (id1 > id2) return 1;\n      // id1 === id2, continue to next identifier\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Compares two semantic version strings according to SemVer 2.0.0 specification\n *\n * Supports:\n * - Core version: MAJOR.MINOR.PATCH\n * - Pre-release: -alpha, -beta.1, -rc.1, etc.\n * - Build metadata: +build, +sha.abc123 (ignored in comparison per spec)\n * - Optional 'v' prefix\n *\n * @param version1 - First version string\n * @param version2 - Second version string\n * @returns -1 if version1 < version2, 0 if equal, 1 if version1 > version2\n * @example\n * compare('1.0.0', '2.0.0') // -1\n * compare('1.0.0-alpha', '1.0.0') // -1 (prerelease < release)\n * compare('1.0.0-alpha', '1.0.0-beta') // -1\n * compare('1.0.0-alpha.1', '1.0.0-alpha.2') // -1\n * compare('1.0.0+build1', '1.0.0+build2') // 0 (build metadata ignored)\n * @since 1.9.0\n */\nexport function compare(version1: string, version2: string): number {\n  const v1 = parse(version1);\n  const v2 = parse(version2);\n\n  // Compare major, minor, patch\n  if (v1.major !== v2.major) return v1.major < v2.major ? -1 : 1;\n  if (v1.minor !== v2.minor) return v1.minor < v2.minor ? -1 : 1;\n  if (v1.patch !== v2.patch) return v1.patch < v2.patch ? -1 : 1;\n\n  // Compare prerelease (build metadata is ignored per SemVer spec)\n  return comparePrerelease(v1.prerelease, v2.prerelease);\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Increments a semantic version\n * @param version - The version to increment\n * @param type - The increment type ('major', 'minor', 'patch')\n * @returns Incremented version string\n * @since 1.9.0\n */\nexport function increment(version: string, type: 'major' | 'minor' | 'patch'): string;\nexport function increment(version: undefined, type: 'major' | 'minor' | 'patch'): undefined;\nexport function increment(version: null, type: 'major' | 'minor' | 'patch'): null;\nexport function increment(\n  version: string | undefined | null,\n  type: 'major' | 'minor' | 'patch'\n): string | undefined | null {\n  if (version === undefined || version === null) return version;\n  const hasV = version.startsWith('v');\n  const normalizedVersion = version.replace(/^v/, '');\n\n  const parts = normalizedVersion.split('.').map(Number);\n\n  // Ensure we have at least major.minor.patch\n  while (parts.length < 3) {\n    parts.push(0);\n  }\n\n  let [major, minor, patch] = parts;\n\n  switch (type) {\n    case 'major':\n      major++;\n      minor = 0;\n      patch = 0;\n      break;\n    case 'minor':\n      minor++;\n      patch = 0;\n      break;\n    case 'patch':\n      patch++;\n      break;\n    default:\n      throw new Error(`Invalid increment type: ${type}`);\n  }\n\n  const result = `${major}.${minor}.${patch}`;\n  return hasV ? `v${result}` : result;\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\nimport type { ParsedVersion } from './parse';\n\n/**\n * Returns `true` when the version string has a prerelease suffix\n * (i.e. contains a `-` after the core `MAJOR.MINOR.PATCH`).\n *\n * @param version - A semantic version string (e.g. `'2.0.0-alpha.1'`, `'1.0.0'`).\n * @returns `true` if the version is a prerelease, `false` otherwise.\n * @example\n * isPrerelease('2.0.0-alpha.1') // true\n * isPrerelease('1.0.0-rc.0')   // true\n * isPrerelease('1.0.0')        // false\n * isPrerelease('2.1.0')        // false\n * @since next\n */\nexport function isPrerelease(version: string): boolean;\n/**\n * Returns `true` when the parsed version has at least one prerelease identifier.\n *\n * @param version - A {@link ParsedVersion} object (as returned by {@link parse}).\n * @returns `true` if `version.prerelease` is non-empty, `false` otherwise.\n * @example\n * isPrerelease(parse('2.0.0-alpha.1')) // true\n * isPrerelease(parse('1.0.0'))         // false\n * @since next\n */\nexport function isPrerelease(version: ParsedVersion): boolean;\nexport function isPrerelease(version: undefined): undefined;\nexport function isPrerelease(version: null): null;\nexport function isPrerelease(version: string | ParsedVersion | undefined | null): boolean | undefined | null {\n  if (version === undefined || version === null) return version;\n  if (typeof version === 'string') return version.split('+')[0].includes('-');\n  return version.prerelease.length > 0;\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Checks if a version satisfies a range (simple implementation)\n * @param version - Version to check\n * @param range - Range pattern (e.g., \">=1.0.0\", \"~1.2.0\", \"^1.0.0\")\n * @returns True if version satisfies the range\n * @since 1.9.0\n */\nexport function satisfiesRange(version: string, range: string): boolean {\n  const normalizedVersion = version.replace(/^v/, '');\n\n  // Handle exact match\n  if (!range.match(/[~^<>=]/)) {\n    return normalizedVersion === range.replace(/^v/, '');\n  }\n\n  // Handle >= operator\n  if (range.startsWith('>=')) {\n    const targetVersion = range.slice(2).replace(/^v/, '');\n    return compareVersionsSimple(normalizedVersion, targetVersion) >= 0;\n  }\n\n  // Handle > operator\n  if (range.startsWith('>')) {\n    const targetVersion = range.slice(1).replace(/^v/, '');\n    return compareVersionsSimple(normalizedVersion, targetVersion) > 0;\n  }\n\n  // Handle <= operator\n  if (range.startsWith('<=')) {\n    const targetVersion = range.slice(2).replace(/^v/, '');\n    return compareVersionsSimple(normalizedVersion, targetVersion) <= 0;\n  }\n\n  // Handle < operator\n  if (range.startsWith('<')) {\n    const targetVersion = range.slice(1).replace(/^v/, '');\n    return compareVersionsSimple(normalizedVersion, targetVersion) < 0;\n  }\n\n  // Handle caret range (^1.2.3 allows patch and minor updates)\n  if (range.startsWith('^')) {\n    const targetVersion = range.slice(1).replace(/^v/, '');\n    const [targetMajor] = targetVersion.split('.').map(Number);\n    const [versionMajor] = normalizedVersion.split('.').map(Number);\n\n    return versionMajor === targetMajor &&\n      compareVersionsSimple(normalizedVersion, targetVersion) >= 0;\n  }\n\n  // Handle tilde range (~1.2.3 allows patch updates)\n  if (range.startsWith('~')) {\n    const targetVersion = range.slice(1).replace(/^v/, '');\n    const [targetMajor, targetMinor] = targetVersion.split('.').map(Number);\n    const [versionMajor, versionMinor] = normalizedVersion.split('.').map(Number);\n\n    return versionMajor === targetMajor &&\n      versionMinor === targetMinor &&\n      compareVersionsSimple(normalizedVersion, targetVersion) >= 0;\n  } else {\n    // Unsupported range format\n    return false;\n  }\n}\n\nfunction compareVersionsSimple(version1: string, version2: string): number {\n  const parts1 = version1.split('.').map(Number);\n  const parts2 = version2.split('.').map(Number);\n\n  const maxLength = Math.max(parts1.length, parts2.length);\n\n  for (let i = 0; i < maxLength; i++) {\n    const part1 = parts1[i] || 0;\n    const part2 = parts2[i] || 0;\n\n    if (part1 < part2) return -1;\n    if (part1 > part2) return 1;\n  }\n\n  return 0;\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\nimport type { ParsedVersion } from './parse';\n\n/**\n * Reconstruct a semantic version string from a {@link ParsedVersion} object.\n *\n * This is the inverse of {@link parse}:\n * `stringify(parse(v)) === stripV(v)` for any valid SemVer string `v`.\n *\n * @param parsed - A parsed semantic version object.\n * @returns The reconstructed version string (without leading `v`).\n * @example\n * stringify({ major: 1, minor: 2, patch: 3, prerelease: [], build: [] })\n * // => '1.2.3'\n * @example\n * stringify({ major: 2, minor: 0, patch: 0, prerelease: ['alpha', '1'], build: [] })\n * // => '2.0.0-alpha.1'\n * @example\n * stringify({ major: 1, minor: 0, patch: 0, prerelease: ['beta'], build: ['exp', 'sha', '5114f85'] })\n * // => '1.0.0-beta+exp.sha.5114f85'\n * @since next\n */\nexport function stringify(parsed: ParsedVersion): string;\nexport function stringify(parsed: undefined): undefined;\nexport function stringify(parsed: null): null;\nexport function stringify(parsed: ParsedVersion | undefined | null): string | undefined | null {\n  if (parsed === undefined || parsed === null) return parsed;\n  const base = `${parsed.major}.${parsed.minor}.${parsed.patch}`;\n  const prerelease = parsed.prerelease.length > 0 ? `-${parsed.prerelease.join('.')}` : '';\n  const build = parsed.build.length > 0 ? `+${parsed.build.join('.')}` : '';\n  return `${base}${prerelease}${build}`;\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Strip the leading \"v\" from a version string if it exists.\n * \n * @param version - The version string to process\n * @returns The version string without leading \"v\", or the original value if it's not a string or doesn't start with \"v\"\n * \n * @example\n * ```typescript\n * stripV(\"v1.2.3\")     // \"1.2.3\"\n * stripV(\"1.2.3\")      // \"1.2.3\"\n * stripV(\"v20.1.0\")    // \"20.1.0\"\n * stripV(null)         // null\n * stripV(undefined)    // undefined\n * stripV(\"\")           // \"\"\n * stripV(\"1.0.0-beta\") // \"1.0.0-beta\"\n * ```\n * @since 1.9.0\n */\nexport function stripV(version: string): string;\nexport function stripV(version: null): null;\nexport function stripV(version: undefined): undefined;\nexport function stripV(version: string | null | undefined): string | null | undefined {\n  return typeof version === \"string\" && version.startsWith(\"v\") ? version.slice(1) : version;\n}\n"],"mappings":"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"}