metascope 0.8.4 → 0.9.0

package/dist/lib/parsers/setup-py-parser.js

@@ -1,7 +1,7 @@
 import { splitCommaSeparated } from "../utilities/template-helpers.js";
 import { getPythonLanguage, initParser } from "../utilities/tree-sitter-wasm.js";
 //#region src/lib/parsers/setup-py-parser.ts
-const STRING_PREFIX_REGEX = /^[bfru]*/i;
+const STRING_PREFIX_REGEX = /^[bfru]*/iv;
 /** Filter nulls from web-tree-sitter's `namedChildren` array. */
 function children(node) {
 	return node.namedChildren.filter((c) => c !== null);
@@ -65,7 +65,7 @@ function extractStringDict(node) {
 		if (!key || !value) continue;
 		const k = extractString(key);
 		const v = extractString(value);
-		if (k && v) result[k] = v;
+		if (k !== void 0 && k !== "" && v !== void 0 && v !== "") result[k] = v;
 	}
 	return result;
 }
@@ -79,7 +79,7 @@ function extractStringListDict(node) {
 		const value = pair.childForFieldName("value");
 		if (!key || !value) continue;
 		const k = extractString(key);
-		if (k) result[k] = extractStringList(value);
+		if (k !== void 0 && k !== "") result[k] = extractStringList(value);
 	}
 	return result;
 }
@@ -127,30 +127,34 @@ async function parseSetupPy(source) {
 			if (value !== void 0) Object.assign(data, { [argumentName]: value });
 			continue;
 		}
-		switch (argumentName) {
-			case "classifiers":
-				data.classifiers = extractStringList(valueNode);
-				break;
-			case "extras_require":
-				data.extras_require = extractStringListDict(valueNode);
-				break;
-			case "install_requires":
-				data.install_requires = extractStringList(valueNode);
-				break;
-			case "keywords":
-				if (valueNode.type === "list" || valueNode.type === "tuple") data.keywords = extractStringList(valueNode);
-				else {
-					const string_ = extractString(valueNode);
-					if (string_) data.keywords = splitCommaSeparated(string_);
-				}
-				break;
-			case "project_urls":
-				data.project_urls = extractStringDict(valueNode);
-				break;
-		}
+		applyListAttribute(data, argumentName, valueNode);
 	}
 	return data;
 }
+/** Apply a list/dict-valued setup() keyword argument to the data object. */
+function applyListAttribute(data, argumentName, valueNode) {
+	switch (argumentName) {
+		case "classifiers":
+			data.classifiers = extractStringList(valueNode);
+			break;
+		case "extras_require":
+			data.extras_require = extractStringListDict(valueNode);
+			break;
+		case "install_requires":
+			data.install_requires = extractStringList(valueNode);
+			break;
+		case "keywords":
+			if (valueNode.type === "list" || valueNode.type === "tuple") data.keywords = extractStringList(valueNode);
+			else {
+				const string_ = extractString(valueNode);
+				if (string_ !== void 0 && string_ !== "") data.keywords = splitCommaSeparated(string_);
+			}
+			break;
+		case "project_urls":
+			data.project_urls = extractStringDict(valueNode);
+			break;
+	}
+}
 /**
 * Recursively find the setup() or setuptools.setup() call in the AST.
 */

package/dist/lib/source.d.ts

@@ -1,3 +1,4 @@
+import "./metadata-types.js";
 //#region src/lib/source.d.ts
 /**
  * A value that is either a single item or an array of items.
@@ -10,8 +11,11 @@ type OneOrMany<T> = T | T[];
  * @template E The shape of any additional computed/derived fields.
  */
 type SourceRecord<D extends Record<string, unknown> = Record<string, unknown>, E extends Record<string, unknown> = Record<string, unknown>> = {
-  /** Primary structured data from this source. */data: D; /** Additional computed or derived fields not present in the raw source. */
-  extra?: E; /** The file path or URL from which the data was derived. */
+  /** Primary structured data from this source. */
+  data: D;
+  /** Additional computed or derived fields not present in the raw source. */
+  extra?: E;
+  /** The file path or URL from which the data was derived. */
   source: string;
 };
 //#endregion

package/dist/lib/sources/arduino-library-properties.d.ts

@@ -1,6 +1,5 @@
 import { OneOrMany, SourceRecord } from "../source.js";
 import { z } from "zod";
-
 //#region src/lib/sources/arduino-library-properties.d.ts
 declare const arduinoLibraryPropertiesSchema: z.ZodObject<{
   architectures: z.ZodDefault<z.ZodPreprocess<z.ZodArray<z.ZodString>>>;

package/dist/lib/sources/arduino-library-properties.js

@@ -29,8 +29,7 @@ const CANONICAL_CATEGORIES = [
 	"Uncategorized"
 ];
 /** Map from letters-only lowercase to canonical category form. */
-const CATEGORY_MAP = new Map(CANONICAL_CATEGORIES.map((cat) => [cat.replaceAll(/[^a-z]/gi, "").toLowerCase(), cat]));
-CATEGORY_MAP.set("sensor", "Sensors");
+const CATEGORY_MAP = new Map([...CANONICAL_CATEGORIES.map((cat) => [cat.replaceAll(/[^a-z]/giv, "").toLowerCase(), cat]), ["sensor", "Sensors"]]);
 const arduinoLibraryPropertiesSchema = z.object({
 	/** Comma-separated architecture identifiers, or ["*"] for all. */
 	architectures: stringArray,
@@ -76,7 +75,7 @@ function parse(content) {
 		category: normalizeCategory(get(raw, "category")),
 		depends: parseDependencies(get(raw, "depends") ?? get(raw, "dependencies") ?? ""),
 		email: nonEmpty(get(raw, "email")),
-		includes: includesValue ? splitCommaSeparated(includesValue) : [],
+		includes: includesValue !== void 0 && includesValue !== "" ? splitCommaSeparated(includesValue) : [],
 		license: nonEmpty(get(raw, "license")),
 		maintainer: parsePersonList(get(raw, "maintainer") ?? "")[0],
 		name: nonEmpty(get(raw, "name")),
@@ -109,10 +108,10 @@ function normalizeCategory(value) {
 	const trimmed = value.trim();
 	if (trimmed.length === 0) return;
 	for (const part of trimmed.split(",")) {
-		const key = part.replaceAll(/[^a-z]/gi, "").toLowerCase();
+		const key = part.replaceAll(/[^a-z]/giv, "").toLowerCase();
 		if (key.length === 0) continue;
 		const canonical = CATEGORY_MAP.get(key);
-		if (canonical) return canonical;
+		if (canonical !== void 0) return canonical;
 	}
 }
 /**
@@ -214,10 +213,10 @@ const arduinoLibraryPropertiesSource = defineSource({
 	key: "arduinoLibraryProperties",
 	async parse(input, context) {
 		const content = await readFile(resolve(context.options.path, input), "utf8");
-		if (isArduinoLibraryProperties(content)) return {
+		return isArduinoLibraryProperties(content) ? {
 			data: parse(content),
 			source: input
-		};
+		} : void 0;
 	},
 	phase: 1
 });

package/dist/lib/sources/cinder-cinderblock-xml.d.ts

@@ -1,6 +1,5 @@
 import { OneOrMany, SourceRecord } from "../source.js";
 import { z } from "zod";
-
 //#region src/lib/sources/cinder-cinderblock-xml.d.ts
 declare const cinderCinderblockSchema: z.ZodObject<{
   author: z.ZodDefault<z.ZodPreprocess<z.ZodArray<z.ZodString>>>;

package/dist/lib/sources/cinder-cinderblock-xml.js

@@ -106,7 +106,7 @@ function parseOperatingSystems(block) {
 	for (const support of ensureArray(block.supports)) {
 		if (!is.plainObject(support)) continue;
 		const os = getAttribute(support, "os");
-		if (os) {
+		if (os !== void 0) {
 			const mapped = OS_MAP[os.toLowerCase()] ?? os;
 			if (!seen.has(mapped)) {
 				seen.add(mapped);
@@ -121,9 +121,9 @@ function parseOperatingSystems(block) {
 */
 function parseDependencies(block) {
 	const results = [];
-	for (const dep of ensureArray(block.requires)) {
-		if (typeof dep !== "string") continue;
-		const trimmed = dep.trim();
+	for (const dependency of ensureArray(block.requires)) {
+		if (typeof dependency !== "string") continue;
+		const trimmed = dependency.trim();
 		if (trimmed.length > 0) results.push(trimmed);
 	}
 	return results;
@@ -135,7 +135,7 @@ const cinderCinderblockXmlSource = defineSource({
 	key: "cinderCinderblockXml",
 	async parse(input, context) {
 		const data = parse(await readFile(resolve(context.options.path, input), "utf8"));
-		if (data !== void 0) return {
+		return data === void 0 ? void 0 : {
 			data,
 			source: input
 		};

package/dist/lib/sources/code-stats.d.ts

@@ -1,12 +1,13 @@
 import { OneOrMany, SourceRecord } from "../source.js";
 import { Language, LanguageInfo } from "@kitschpatrol/tokei";
-
 //#region src/lib/sources/code-stats.d.ts
 type CodeStatsTotals = Omit<LanguageInfo, 'language' | 'reports'> & {
   languages: Language[];
 };
 type CodeStatsFields = {
-  /** Per-language line count perLanguage, sorted by lines of code descending. */perLanguage?: LanguageInfo[]; /** Aggregate line counts across all languages. */
+  /** Per-language line count perLanguage, sorted by lines of code descending. */
+  perLanguage?: LanguageInfo[];
+  /** Aggregate line counts across all languages. */
   total?: CodeStatsTotals;
 };
 type CodeStatsData = OneOrMany<SourceRecord<CodeStatsFields>> | undefined;

package/dist/lib/sources/codemeta-json.d.ts

@@ -1,6 +1,5 @@
 import { OneOrMany, SourceRecord } from "../source.js";
 import { z } from "zod";
-
 //#region src/lib/sources/codemeta-json.d.ts
 declare const codeMetaJsonDataSchema: z.ZodObject<{
   applicationCategory: z.ZodOptional<z.ZodPreprocess<z.ZodOptional<z.ZodPreprocess<z.ZodOptional<z.ZodString>>>>>;

package/dist/lib/sources/codemeta-json.js

@@ -30,12 +30,12 @@ import { z } from "zod";
 */
 const codeMetaString = z.preprocess((value) => {
 	if (typeof value === "string") return value;
-	if (is.plainObject(value) && typeof value["@value"] === "string") return value["@value"];
+	return is.plainObject(value) && typeof value["@value"] === "string" ? value["@value"] : void 0;
 }, nonEmptyString).optional();
 /** Same as codeMetaString but semantically a URL field. */
 const codeMetaUrl = z.preprocess((value) => {
 	if (typeof value === "string") return value;
-	if (is.plainObject(value) && typeof value["@value"] === "string") return value["@value"];
+	return is.plainObject(value) && typeof value["@value"] === "string" ? value["@value"] : void 0;
 }, optionalUrl).optional();
 /**
 * A string array that handles CodeMeta's polymorphic inputs:
@@ -48,7 +48,8 @@ const codeMetaUrl = z.preprocess((value) => {
 const codeMetaStringArray = z.preprocess((value) => {
 	if (value === void 0 || value === null) return;
 	if (typeof value === "string") return value.includes(",") ? splitCommaSeparated(value) : [value];
-	if (Array.isArray(value)) return value.map((item) => {
+	if (!Array.isArray(value)) return;
+	return value.map((item) => {
 		if (typeof item === "string") return item.trim();
 		if (is.plainObject(item)) return typeof item.name === "string" ? item.name.trim() : "";
 		log.warn("Invalid type found in codemeta json parser");
@@ -60,10 +61,9 @@ const codeMetaStringArray = z.preprocess((value) => {
 */
 const codeMetaLicense = z.preprocess((value) => {
 	if (typeof value === "string") return value;
-	if (Array.isArray(value)) {
-		const filtered = value.filter((l) => typeof l === "string");
-		return filtered.length > 0 ? filtered : void 0;
-	}
+	if (!Array.isArray(value)) return;
+	const filtered = value.filter((l) => typeof l === "string");
+	return filtered.length > 0 ? filtered : void 0;
 }, z.union([z.string(), z.array(z.string())]).optional()).optional();
 const codeMetaPersonOrOrgSchema = z.object({
 	affiliation: nonEmptyString,
@@ -97,7 +97,8 @@ function preprocessPersonOrOrg(value) {
 	if (typeof value.url === "string") result.url = value.url;
 	if (typeof value.affiliation === "string") result.affiliation = value.affiliation;
 	else if (is.plainObject(value.affiliation) && typeof value.affiliation.name === "string") result.affiliation = value.affiliation.name;
-	if (result.name ?? result.givenName ?? result.familyName ?? result.email) return result;
+	const identifyingValue = result.name ?? result.givenName ?? result.familyName ?? result.email;
+	if (identifyingValue !== void 0 && identifyingValue !== "") return result;
 }
 /**
 * A person/org array that normalizes single values to arrays, and each element
@@ -121,12 +122,13 @@ const codeMetaDependencySchema = z.object({
 function preprocessDependency(value) {
 	if (typeof value === "string") return { name: value };
 	if (!is.plainObject(value)) return;
-	const dep = {};
-	if (typeof value.name === "string") dep.name = value.name;
-	if (typeof value.identifier === "string") dep.identifier = value.identifier;
-	if (typeof value.version === "string") dep.version = value.version;
-	if (typeof value.runtimePlatform === "string") dep.runtimePlatform = value.runtimePlatform;
-	if (dep.name ?? dep.identifier) return dep;
+	const dependency = {};
+	if (typeof value.name === "string") dependency.name = value.name;
+	if (typeof value.identifier === "string") dependency.identifier = value.identifier;
+	if (typeof value.version === "string") dependency.version = value.version;
+	if (typeof value.runtimePlatform === "string") dependency.runtimePlatform = value.runtimePlatform;
+	const dependencyKey = dependency.name ?? dependency.identifier;
+	if (dependencyKey !== void 0 && dependencyKey !== "") return dependency;
 }
 /**
 * A dependency array that normalizes single values to arrays, and each element
@@ -148,10 +150,9 @@ const codeMetaJsonDataSchema = z.object({
 	copyrightHolder: codeMetaPersonArray,
 	copyrightYear: z.preprocess((v) => {
 		if (typeof v === "number") return v;
-		if (typeof v === "string") {
-			const parsed = Number.parseInt(v, 10);
-			return Number.isNaN(parsed) ? void 0 : parsed;
-		}
+		if (typeof v !== "string") return;
+		const parsed = Number.parseInt(v, 10);
+		return Number.isNaN(parsed) ? void 0 : parsed;
 	}, z.number().optional()).optional(),
 	dateCreated: codeMetaString,
 	dateModified: codeMetaString,
@@ -208,7 +209,7 @@ function migrateV1Properties(raw) {
 	for (const [key, value] of Object.entries(raw)) {
 		if (key.startsWith("@")) continue;
 		const mappedKey = v1PropertyMap[key] ?? key;
-		if (!(mappedKey in result)) result[mappedKey] = value;
+		if (!Object.hasOwn(result, mappedKey)) result[mappedKey] = value;
 	}
 	return result;
 }
@@ -219,7 +220,7 @@ const codemetaJsonSource = defineSource({
 	key: "codemetaJson",
 	async parse(input, context) {
 		const data = parse(await readFile(resolve(context.options.path, input), "utf8"));
-		if (data !== void 0) return {
+		return data === void 0 ? void 0 : {
 			data,
 			source: input
 		};

package/dist/lib/sources/dependency-updates.d.ts

@@ -1,20 +1,29 @@
 import { OneOrMany, SourceRecord } from "../source.js";
-
 //#region src/lib/sources/dependency-updates.d.ts
 type DependencyUpdatesPackage = {
-  /** Human-readable age of the update (e.g. "3 months"). */age?: string; /** Additional info about the update (e.g. deprecation notice). */
-  info?: string; /** Package name. */
-  name: string; /** Latest available version. */
-  new: string; /** Currently installed version. */
+  /** Human-readable age of the update (e.g. "3 months"). */
+  age?: string;
+  /** Additional info about the update (e.g. deprecation notice). */
+  info?: string;
+  /** Package name. */
+  name: string;
+  /** Latest available version. */
+  new: string;
+  /** Currently installed version. */
   old: string;
 };
 type DependencyUpdatesFields = {
-  /** Packages with available major version updates. */major?: DependencyUpdatesPackage[]; /** Packages with available minor version updates. */
-  minor?: DependencyUpdatesPackage[]; /** Packages with available patch version updates. */
+  /** Packages with available major version updates. */
+  major?: DependencyUpdatesPackage[];
+  /** Packages with available minor version updates. */
+  minor?: DependencyUpdatesPackage[];
+  /** Packages with available patch version updates. */
   patch?: DependencyUpdatesPackage[];
 };
 type DependencyUpdatesExtra = {
-  /** Total dependency staleness in libyears. */libyears?: number; /** Total number of outdated packages. */
+  /** Total dependency staleness in libyears. */
+  libyears?: number;
+  /** Total number of outdated packages. */
   total?: number;
 };
 type DependencyUpdatesData = OneOrMany<SourceRecord<DependencyUpdatesFields, DependencyUpdatesExtra>> | undefined;

package/dist/lib/sources/dependency-updates.js

@@ -4,14 +4,14 @@ import { z } from "zod";
 import { coerce, diff } from "semver";
 import { updates } from "updates";
 //#region src/lib/sources/dependency-updates.ts
-const AGE_VALUE_UNIT_REGEX = /^(\d+)\s+(\w+)$/;
-const depSchema = z.object({
+const AGE_VALUE_UNIT_REGEX = /^(\d+)\s+(\w+)$/v;
+const dependencySchema = z.object({
 	age: z.string().optional(),
 	info: z.string().optional(),
 	new: z.string(),
 	old: z.string()
 });
-const updatesOutputSchema = z.object({ results: z.record(z.string(), z.record(z.string(), z.record(z.string(), depSchema))) });
+const updatesOutputSchema = z.object({ results: z.record(z.string(), z.record(z.string(), z.record(z.string(), dependencySchema))) });
 /**
 * Parse an age string from the `updates` CLI (via the `timerel` library) into
 * fractional years.
@@ -24,7 +24,9 @@ function parseAgeToYears(age) {
 	const match = AGE_VALUE_UNIT_REGEX.exec(age.trim());
 	if (!match) return 0;
 	const value = Number(match[1]);
-	switch (match[2]) {
+	const unit = match[2];
+	if (unit === void 0) return 0;
+	switch (unit) {
 		case "day":
 		case "days": return value / 365.25;
 		case "hour":
@@ -51,11 +53,33 @@ function classifyBump(oldVersion, newVersion) {
 	const newSemver = coerce(newVersion);
 	if (!oldSemver || !newSemver) return "major";
 	const result = diff(oldSemver, newSemver);
-	if (!result) return "major";
-	if (result.startsWith("major") || result === "premajor") return "major";
-	if (result.startsWith("minor") || result === "preminor") return "minor";
+	if (result === null) return "major";
+	if (result === "premajor" || result.startsWith("major")) return "major";
+	if (result === "preminor" || result.startsWith("minor")) return "minor";
 	return "patch";
 }
+/**
+* Classify each dependency in a group into the appropriate bucket, skipping
+* `@types/node` and packages already seen. Returns the libyears contributed by
+* this group.
+*/
+function collectDependencyUpdates(dependencyGroup, buckets, seen) {
+	let libyears = 0;
+	for (const [name, dependency] of Object.entries(dependencyGroup)) {
+		if (name === "@types/node" || seen.has(name)) continue;
+		seen.add(name);
+		if (dependency.age !== void 0 && dependency.age !== "") libyears += parseAgeToYears(dependency.age);
+		const packageStatus = {
+			name,
+			new: dependency.new,
+			old: dependency.old
+		};
+		if (dependency.age !== void 0 && dependency.age !== "") packageStatus.age = dependency.age;
+		if (dependency.info !== void 0 && dependency.info !== "") packageStatus.info = dependency.info;
+		buckets[classifyBump(dependency.old, dependency.new)].push(packageStatus);
+	}
+	return libyears;
+}
 const dependencyUpdatesSource = defineSource({
 	async discover(context) {
 		return [context.options.path];
@@ -74,35 +98,15 @@ const dependencyUpdatesSource = defineSource({
 			log.debug("No dependency files found for updates analysis.");
 			return;
 		}
-		const major = [];
-		const minor = [];
-		const patch = [];
+		const buckets = {
+			major: [],
+			minor: [],
+			patch: []
+		};
 		const seen = /* @__PURE__ */ new Set();
 		let libyears = 0;
-		for (const mode of Object.values(parsed.results)) for (const depGroup of Object.values(mode)) for (const [name, dep] of Object.entries(depGroup)) {
-			if (name === "@types/node") continue;
-			if (seen.has(name)) continue;
-			seen.add(name);
-			if (dep.age) libyears += parseAgeToYears(dep.age);
-			const packageStatus = {
-				name,
-				new: dep.new,
-				old: dep.old
-			};
-			if (dep.age) packageStatus.age = dep.age;
-			if (dep.info) packageStatus.info = dep.info;
-			switch (classifyBump(dep.old, dep.new)) {
-				case "major":
-					major.push(packageStatus);
-					break;
-				case "minor":
-					minor.push(packageStatus);
-					break;
-				case "patch":
-					patch.push(packageStatus);
-					break;
-			}
-		}
+		for (const mode of Object.values(parsed.results)) for (const dependencyGroup of Object.values(mode)) libyears += collectDependencyUpdates(dependencyGroup, buckets, seen);
+		const { major, minor, patch } = buckets;
 		return {
 			data: {
 				major,

package/dist/lib/sources/file-stats.d.ts

@@ -1,10 +1,13 @@
 import { OneOrMany, SourceRecord } from "../source.js";
-
 //#region src/lib/sources/file-stats.d.ts
 type FileStats = {
-  /** Name of repo folder, possibly useful as a name fallback */folderName?: string; /** Total number of directories (recursive). */
-  totalDirectoryCount?: number; /** Total number of files (recursive). */
-  totalFileCount?: number; /** Total size of all files in bytes. */
+  /** Name of repo folder, possibly useful as a name fallback */
+  folderName?: string;
+  /** Total number of directories (recursive). */
+  totalDirectoryCount?: number;
+  /** Total number of files (recursive). */
+  totalFileCount?: number;
+  /** Total size of all files in bytes. */
   totalSizeBytes?: number;
 };
 type FileStatsData = OneOrMany<SourceRecord<FileStats>> | undefined;

package/dist/lib/sources/git-config.d.ts

@@ -1,6 +1,5 @@
 import { OneOrMany, SourceRecord } from "../source.js";
 import { GitConfig } from "pkg-types";
-
 //#region src/lib/sources/git-config.d.ts
 type GitConfigInfo = GitConfig;
 type GitConfigData = OneOrMany<SourceRecord<GitConfigInfo>> | undefined;

package/dist/lib/sources/git-stats.d.ts

@@ -1,33 +1,56 @@
 import { OneOrMany, SourceRecord } from "../source.js";
-
 //#region src/lib/sources/git-stats.d.ts
 type GitStatsInfo = {
-  /** Total number of local branches. */branchCount?: number; /** Name of the currently checked-out branch. */
-  branchCurrent?: string; /** Total number of commits in the current branch. */
-  commitCount?: number; /** ISO 8601 date of the repository's first commit. */
-  commitDateFirst?: string; /** ISO 8601 date of the most recent commit. */
-  commitDateLast?: string; /** Number of unique commit author emails. */
-  contributorCount?: number; /** Whether the repo uses Git LFS. */
-  hasLfs?: boolean; /** Whether the working tree has no uncommitted changes. */
-  isClean?: boolean; /** Whether the working tree has uncommitted changes. */
-  isDirty?: boolean; /** Whether any remote is ahead of the local branch. */
-  isRemoteAhead?: boolean; /** Number of configured remotes. */
-  remoteCount?: number; /** Per-remote ahead/behind commit counts relative to HEAD. */
+  /** Total number of local branches. */
+  branchCount?: number;
+  /** Name of the currently checked-out branch. */
+  branchCurrent?: string;
+  /** Total number of commits in the current branch. */
+  commitCount?: number;
+  /** ISO 8601 date of the repository's first commit. */
+  commitDateFirst?: string;
+  /** ISO 8601 date of the most recent commit. */
+  commitDateLast?: string;
+  /** Number of unique commit author emails. */
+  contributorCount?: number;
+  /** Whether the repo uses Git LFS. */
+  hasLfs?: boolean;
+  /** Whether the working tree has no uncommitted changes. */
+  isClean?: boolean;
+  /** Whether the working tree has uncommitted changes. */
+  isDirty?: boolean;
+  /** Whether any remote is ahead of the local branch. */
+  isRemoteAhead?: boolean;
+  /** Number of configured remotes. */
+  remoteCount?: number;
+  /** Per-remote ahead/behind commit counts relative to HEAD. */
   remoteStatus?: Record<string, {
     ahead: number;
     behind: number;
-  }>; /** Number of registered git submodules. */
-  submoduleCount?: number; /** Total number of tags. */
-  tagCount?: number; /** ISO 8601 date of the most recent tag. */
-  tagDateLatest?: string; /** Name of the most recent tag. */
-  tagNameLatest?: string; /** Number of tags matching a version pattern (e.g. v1.2.3). */
-  tagReleaseCount?: number; /** ISO 8601 date of the most recent version tag. */
-  tagVersionDateLatest?: string; /** Most recent version tag, without the leading "v". */
-  tagVersionLatest?: string; /** Total commits ahead of all remotes combined. */
-  totalAhead?: number; /** Total commits behind all remotes combined. */
-  totalBehind?: number; /** Number of files tracked by git. */
-  trackedFileCount?: number; /** Total size in bytes of all tracked files. */
-  trackedSizeBytes?: number; /** Number of files with staged or unstaged changes. */
+  }>;
+  /** Number of registered git submodules. */
+  submoduleCount?: number;
+  /** Total number of tags. */
+  tagCount?: number;
+  /** ISO 8601 date of the most recent tag. */
+  tagDateLatest?: string;
+  /** Name of the most recent tag. */
+  tagNameLatest?: string;
+  /** Number of tags matching a version pattern (e.g. v1.2.3). */
+  tagReleaseCount?: number;
+  /** ISO 8601 date of the most recent version tag. */
+  tagVersionDateLatest?: string;
+  /** Most recent version tag, without the leading "v". */
+  tagVersionLatest?: string;
+  /** Total commits ahead of all remotes combined. */
+  totalAhead?: number;
+  /** Total commits behind all remotes combined. */
+  totalBehind?: number;
+  /** Number of files tracked by git. */
+  trackedFileCount?: number;
+  /** Total size in bytes of all tracked files. */
+  trackedSizeBytes?: number;
+  /** Number of files with staged or unstaged changes. */
   uncommittedFileCount?: number;
 };
 type GitStatsData = OneOrMany<SourceRecord<GitStatsInfo>> | undefined;