Blame · versionNumbers.ts

b69ab31	1	/**
b69ab31	2	* Copyright (c) Meta Platforms, Inc. and affiliates.
b69ab31	3	*
b69ab31	4	* This source code is licensed under the MIT license found in the
b69ab31	5	* LICENSE file in the root directory of this source tree.
b69ab31	6	*/
b69ab31	7
b69ab31	8	/** An array of parts of the version, like [Major, Minor, Subminor] */
b69ab31	9	export type ParsedVersion = Array<number>;
b69ab31	10
b69ab31	11	/** Comparator for parsed version. Return -1 if a < b, 1 if a > b, and 0 if a == b */
b69ab31	12	export function compareVersions(a: ParsedVersion, b: ParsedVersion): -1 \| 0 \| 1 {
b69ab31	13	if (a.length === 0 && b.length === 0) {
b69ab31	14	return 0;
b69ab31	15	}
b69ab31	16	if (b.length === 0) {
b69ab31	17	return 1;
b69ab31	18	}
b69ab31	19	if (a.length === 0) {
b69ab31	20	return -1;
b69ab31	21	}
b69ab31	22
b69ab31	23	return a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : compareVersions(a.slice(1), b.slice(1));
b69ab31	24	}
b69ab31	25
b69ab31	26	/**
b69ab31	27	* Given a version ordinal label like V1, V0.1, V0.10 etc, extract the parts like [1], [0, 1], [0, 10] etc
b69ab31	28	* This IGNORES any leading/trailing non-numeric parts.
b69ab31	29	*/
b69ab31	30	export function parseVersionParts(ordinal: string): ParsedVersion {
b69ab31	31	try {
b69ab31	32	const numbers = /^[a-zA-Z\-_](\d+(?:\.\d+))[a-zA-Z\-_]*$/.exec(ordinal);
b69ab31	33	return numbers?.[1].split('.').map(part => parseInt(part, 10)) ?? [];
b69ab31	34	} catch {
b69ab31	35	return [];
b69ab31	36	}
b69ab31	37	}