metascope 0.6.3 → 0.7.1

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

@@ -32,24 +32,40 @@ const CANONICAL_CATEGORIES = [
 const CATEGORY_MAP = new Map(CANONICAL_CATEGORIES.map((cat) => [cat.replaceAll(/[^a-z]/gi, "").toLowerCase(), cat]));
 CATEGORY_MAP.set("sensor", "Sensors");
 const arduinoLibraryPropertiesSchema = z.object({
+	/** Comma-separated architecture identifiers, or ["*"] for all. */
 	architectures: stringArray,
+	/** Parsed author entries. */
 	authors: z.array(arduinoLibraryPropertiesPersonEntrySchema),
+	/** Normalized category, or undefined if invalid/empty. */
 	category: z.enum(CANONICAL_CATEGORIES).optional(),
+	/** Parsed dependency entries. */
 	depends: z.array(arduinoLibraryPropertiesDependencyEntrySchema),
+	/** Top-level email field (non-standard, used in some fixtures). */
 	email: nonEmptyString,
+	/** Comma-separated header files. */
 	includes: stringArray,
+	/** License value (non-standard field). */
 	license: nonEmptyString,
+	/** Parsed maintainer entry. */
 	maintainer: arduinoLibraryPropertiesPersonEntrySchema.optional(),
+	/** Library name. */
 	name: nonEmptyString,
+	/** Extended description paragraph. */
 	paragraph: nonEmptyString,
+	/** Raw key-value pairs. */
 	raw: z.record(z.string(), z.string()),
+	/** Repository URL (non-standard field). */
 	repository: optionalUrl,
+	/** One-sentence description. */
 	sentence: nonEmptyString,
+	/** Project URL. */
 	url: optionalUrl,
+	/** Library version. */
 	version: nonEmptyString
 });
 /**
-* Parse an Arduino `library.properties` content string into a structured object.
+* Parse an Arduino `library.properties` content string into a structured
+* object.
 */
 function parse(content) {
 	const raw = parseProperties(content);
@@ -78,19 +94,20 @@ function get(raw, key) {
 }
 /** Return a trimmed string, or undefined if empty/whitespace-only. */
 function nonEmpty(value) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }
 /**
-* Normalize a category string to the canonical Arduino category.
-* Strips all non-letter characters, lowercases, and matches against the canonical map.
-* For comma-separated values (e.g. "Sensors, Timing"), takes the first valid match.
+* Normalize a category string to the canonical Arduino category. Strips all
+* non-letter characters, lowercases, and matches against the canonical map. For
+* comma-separated values (e.g. "Sensors, Timing"), takes the first valid
+* match.
 */
 function normalizeCategory(value) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	const trimmed = value.trim();
-	if (trimmed.length === 0) return void 0;
+	if (trimmed.length === 0) return;
 	for (const part of trimmed.split(",")) {
 		const key = part.replaceAll(/[^a-z]/gi, "").toLowerCase();
 		if (key.length === 0) continue;
@@ -128,9 +145,9 @@ function parsePersonList(value) {
 	return results;
 }
 /**
-* Parse a comma-separated list of dependencies with optional version constraints.
-* e.g. "ArduinoHttpClient (>=1.0.0), ArduinoJson" →
-*   [{ name: "ArduinoHttpClient", versionConstraint: ">=1.0.0" }, ...]
+* Parse a comma-separated list of dependencies with optional version
+* constraints. e.g. "ArduinoHttpClient (>=1.0.0), ArduinoJson" → [{ name:
+* "ArduinoHttpClient", versionConstraint: ">=1.0.0" }, ...]
 */
 function parseDependencies(value) {
 	const trimmed = value.trim();
@@ -162,8 +179,8 @@ function parseDependencies(value) {
 	return results;
 }
 /**
-* Arduino-specific fields that distinguish library.properties from
-* Processing's identically-named format.
+* Arduino-specific fields that distinguish library.properties from Processing's
+* identically-named format.
 */
 const ARDUINO_SPECIFIC_FIELDS = new Set([
 	"architectures",
@@ -178,9 +195,9 @@ const PROCESSING_EXCLUSIVE_FIELDS = new Set([
 	"prettyversion"
 ]);
 /**
-* Validate that a library.properties file is Arduino (not Processing).
-* Requires name=, version=, author= and either an Arduino-specific field
-* or no Processing-exclusive fields.
+* Validate that a library.properties file is Arduino (not Processing). Requires
+* name=, version=, author= and either an Arduino-specific field or no
+* Processing-exclusive fields.
 */
 function isArduinoLibraryProperties(content) {
 	const raw = parseProperties(content);

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

@@ -18,16 +18,27 @@ import { XMLParser } from "fast-xml-parser";
 * Uses `fast-xml-parser` with attribute parsing enabled.
 */
 const cinderCinderblockSchema = z.object({
+	/** Block author name(s), split from comma-separated values. */
 	author: stringArray,
+	/** Git repository URL. */
 	git: optionalUrl,
+	/** Block identifier (e.g. "info.v002.syphon"). */
 	id: nonEmptyString,
+	/** Library or libraryUrl reference link. */
 	library: optionalUrl,
+	/** License identifier. */
 	license: nonEmptyString,
+	/** Block display name. */
 	name: nonEmptyString,
+	/** Software dependencies from `<requires>` elements. */
 	requires: stringArray,
+	/** Block summary / description. */
 	summary: nonEmptyString,
+	/** Supported operating systems from `<supports os="...">` elements. */
 	supports: stringArray,
+	/** Project URL. */
 	url: optionalUrl,
+	/** Version string. */
 	version: nonEmptyString
 });
 /**
@@ -40,8 +51,8 @@ const OS_MAP = {
 	msw: "Windows"
 };
 /**
-* Parse a `cinderblock.xml` content string into a structured object.
-* Returns undefined if the XML is malformed or missing the expected structure.
+* Parse a `cinderblock.xml` content string into a structured object. Returns
+* undefined if the XML is malformed or missing the expected structure.
 */
 function parse(content) {
 	const parser = new XMLParser({
@@ -52,14 +63,14 @@ function parse(content) {
 	let data;
 	try {
 		const parsed = parser.parse(content);
-		if (!is.plainObject(parsed)) return void 0;
+		if (!is.plainObject(parsed)) return;
 		data = parsed;
 	} catch {
 		return;
 	}
-	if (!is.plainObject(data.cinder)) return void 0;
+	if (!is.plainObject(data.cinder)) return;
 	const { cinder } = data;
-	if (!is.plainObject(cinder.block)) return void 0;
+	if (!is.plainObject(cinder.block)) return;
 	const { block } = cinder;
 	return cinderCinderblockSchema.parse({
 		author: splitCommaSeparated(getAttribute(block, "author")),
@@ -76,17 +87,18 @@ function parse(content) {
 	});
 }
 /**
-* Get a trimmed string attribute from a parsed XML element.
-* fast-xml-parser stores attributes with the `@_` prefix.
+* Get a trimmed string attribute from a parsed XML element. fast-xml-parser
+* stores attributes with the `@_` prefix.
 */
 function getAttribute(element, name) {
 	const value = element[`@_${name}`];
-	if (typeof value !== "string") return void 0;
+	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }
 /**
-* Extract deduplicated, mapped operating system names from `<supports os="...">` elements.
+* Extract deduplicated, mapped operating system names from `<supports
+* os="...">` elements.
 */
 function parseOperatingSystems(block) {
 	const results = [];

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

@@ -12,15 +12,17 @@ import { z } from "zod";
 * CodeMeta JSON metadata source.
 *
 * Reads a codemeta.json file (v1, v2, or v3) and normalizes it into a
-* consistent shape with predictable types. No enrichment, no JSON-LD
-* expansion — just an honest representation of what's in the file.
+* consistent shape with predictable types. No enrichment, no JSON-LD expansion
+* — just an honest representation of what's in the file.
 *
 * Uses Zod preprocess schemas to handle v1/v2/v3 normalization:
-*   - `@`-prefixed JSON-LD keys stripped, v1 property names remapped
-*   - `{"@type": "xsd:anyURI", "@value": "..."}` unwrapped to plain strings
-*   - Person/org objects normalized (`@type`→`type`, `@id`→`id`, affiliation-as-object)
-*   - Comma-separated strings split to arrays, `{"name":"..."}` objects unwrapped
-*   - Dependencies normalized (string → `{name: string}`)
+*
+* - `@`-prefixed JSON-LD keys stripped, v1 property names remapped
+* - `{"@type": "xsd:anyURI", "@value": "..."}` unwrapped to plain strings
+* - Person/org objects normalized (`@type`→`type`, `@id`→`id`,
+*   affiliation-as-object)
+* - Comma-separated strings split to arrays, `{"name":"..."}` objects unwrapped
+* - Dependencies normalized (string → `{name: string}`)
 */
 /**
 * A string that also unwraps `{"@value": "..."}` JSON-LD typed values.
@@ -37,9 +39,11 @@ const codeMetaUrl = z.preprocess((value) => {
 }, optionalUrl);
 /**
 * A string array that handles CodeMeta's polymorphic inputs:
-*   - Single comma-separated string → split to array (common in v1)
-*   - Array of strings → pass through
-*   - Array of `{"name":"..."}` objects → extract name strings (e.g. programmingLanguage)
+*
+* - Single comma-separated string → split to array (common in v1)
+* - Array of strings → pass through
+* - Array of `{"name":"..."}` objects → extract name strings (e.g.
+*   programmingLanguage)
 */
 const codeMetaStringArray = z.preprocess((value) => {
 	if (value === void 0 || value === null) return;
@@ -72,9 +76,9 @@ const codeMetaPersonOrOrgSchema = z.object({
 	url: optionalUrl
 });
 /**
-* Preprocess a raw person/org value into a normalized shape.
-* Handles: plain string → {name: string}, `@type`→`type`, `@id`→`id`,
-* affiliation-as-object → affiliation string.
+* Preprocess a raw person/org value into a normalized shape. Handles: plain
+* string → {name: string}, `@type`→`type`, `@id`→`id`, affiliation-as-object →
+* affiliation string.
 */
 function preprocessPersonOrOrg(value) {
 	if (typeof value === "string") return { name: value };
@@ -96,8 +100,8 @@ function preprocessPersonOrOrg(value) {
 	if (result.name ?? result.givenName ?? result.familyName ?? result.email) return result;
 }
 /**
-* A person/org array that normalizes single values to arrays,
-* and each element through `preprocessPersonOrOrg`.
+* A person/org array that normalizes single values to arrays, and each element
+* through `preprocessPersonOrOrg`.
 */
 const codeMetaPersonArray = z.preprocess((value) => {
 	if (value === void 0 || value === null) return;
@@ -111,8 +115,8 @@ const codeMetaDependencySchema = z.object({
 	version: nonEmptyString
 });
 /**
-* Preprocess a raw dependency value into a normalized shape.
-* Handles: plain string → {name: string}.
+* Preprocess a raw dependency value into a normalized shape. Handles: plain
+* string → {name: string}.
 */
 function preprocessDependency(value) {
 	if (typeof value === "string") return { name: value };
@@ -125,8 +129,8 @@ function preprocessDependency(value) {
 	if (dep.name ?? dep.identifier) return dep;
 }
 /**
-* A dependency array that normalizes single values to arrays,
-* and each element through `preprocessDependency`.
+* A dependency array that normalizes single values to arrays, and each element
+* through `preprocessDependency`.
 */
 const codeMetaDependencyArray = z.preprocess((value) => {
 	if (value === void 0 || value === null) return;
@@ -191,7 +195,7 @@ const v1PropertyMap = {
 */
 function parse(content) {
 	const raw = parseJsonRecord(content);
-	if (!raw) return void 0;
+	if (!raw) return;
 	const migrated = migrateV1Properties(raw);
 	if (migrated.datePublished === void 0 && typeof migrated.dateReleased === "string") migrated.datePublished = migrated.dateReleased;
 	return codeMetaJsonDataSchema.parse(migrated);

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

@@ -1,9 +1,8 @@
 import { log } from "../log.js";
 import { defineSource } from "../source.js";
-import { exec } from "tinyexec";
 import { z } from "zod";
-import { fileURLToPath } from "node:url";
 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({
@@ -14,19 +13,11 @@ const depSchema = z.object({
 });
 const updatesOutputSchema = z.object({ results: z.record(z.string(), z.record(z.string(), z.record(z.string(), depSchema))) });
 /**
-* Resolve the path to the `updates` CLI binary.
+* Parse an age string from the `updates` CLI (via the `timerel` library) into
+* fractional years.
 *
-* Consumers that bundle metascope must externalize it (e.g. via `neverBundle`)
-* so that `import.meta.resolve` can find the `updates` dependency.
-*/
-function resolveUpdatesBinary() {
-	return fileURLToPath(import.meta.resolve("updates/dist/index.js"));
-}
-/**
-* Parse an age string from the `updates` CLI (via the `timerel` library) into fractional years.
-*
-* Possible formats: "now", "<n> sec(s)", "<n> min(s)", "<n> hour(s)",
-* "<n> day(s)", "<n> week(s)", "<n> month(s)", "<n> year(s)"
+* Possible formats: "now", "<n> sec(s)", "<n> min(s)", "<n> hour(s)", "<n>
+* day(s)", "<n> week(s)", "<n> month(s)", "<n> year(s)"
 */
 function parseAgeToYears(age) {
 	if (age === "now") return 0;
@@ -52,8 +43,8 @@ function parseAgeToYears(age) {
 	}
 }
 /**
-* Classify a version bump as major, minor, or patch using semver.
-* Falls back to 'major' for non-semver versions (e.g. GitHub Actions tags).
+* Classify a version bump as major, minor, or patch using semver. Falls back to
+* 'major' for non-semver versions (e.g. GitHub Actions tags).
 */
 function classifyBump(oldVersion, newVersion) {
 	const oldSemver = coerce(oldVersion);
@@ -72,15 +63,13 @@ const dependencyUpdatesSource = defineSource({
 	key: "dependencyUpdates",
 	async parse(input) {
 		log.debug("Extracting dependency update information via updates...");
-		const result = await exec("node", [
-			resolveUpdatesBinary(),
-			"--file",
-			input,
-			"--json"
-		]);
+		const result = await updates({
+			files: [input],
+			json: true
+		});
 		let parsed;
 		try {
-			parsed = updatesOutputSchema.parse(JSON.parse(result.stdout));
+			parsed = updatesOutputSchema.parse(result);
 		} catch {
 			log.debug("No dependency files found for updates analysis.");
 			return;

package/dist/lib/sources/git-stats.js

@@ -48,7 +48,7 @@ const gitStatsSource = defineSource({
 				}
 			}).then((sizes) => sizes.reduce((sum, size) => sum + size, 0)),
 			(async () => {
-				if (!tagNameLatest) return void 0;
+				if (!tagNameLatest) return;
 				try {
 					return (await git.raw([
 						"log",

package/dist/lib/sources/github-actions.js

@@ -39,12 +39,19 @@ const workflowRunConclusion = z.enum([
 	"timed_out"
 ]);
 const githubActionSchema = z.object({
+	/** Relative path to the workflow file. */
 	file: z.string(),
+	/** ISO 8601 timestamp of the latest completed run on the default branch. */
 	lastRunAt: z.string().optional(),
+	/** Conclusion of the latest run on the default branch. */
 	lastRunConclusion: workflowRunConclusion.optional(),
+	/** Duration of the latest run in milliseconds. */
 	lastRunDurationMs: z.number().optional(),
+	/** Status of the latest run on the default branch. */
 	lastRunStatus: workflowRunStatus.optional(),
+	/** URL of the latest run on GitHub. */
 	lastRunUrl: z.string().optional(),
+	/** Workflow name from the `name` field. */
 	name: z.string()
 });
 /** Resolve owner/repo from git config remotes in context. */
@@ -93,7 +100,7 @@ async function fetchWorkflowRuns(octokit, owner, repo, defaultBranch) {
 const githubActionsSource = {
 	async extract(context) {
 		const inputs = await getMatches(context.options, [".github/workflows/*.{yml,yaml}"]);
-		if (inputs.length === 0) return void 0;
+		if (inputs.length === 0) return;
 		const records = [];
 		for (const input of inputs) try {
 			const parsed = parse(await readFile(input, "utf8"));
@@ -112,7 +119,7 @@ const githubActionsSource = {
 		} catch (error) {
 			log.warn(`Failed to parse workflow "${input}": ${error instanceof Error ? error.message : String(error)}`);
 		}
-		if (records.length === 0) return void 0;
+		if (records.length === 0) return;
 		if (context.options.offline) log.debug("Skipping GitHub Actions run data (offline mode)");
 		else try {
 			const ownerRepo = await resolveOwnerRepo(context);

package/dist/lib/sources/github.js

@@ -218,7 +218,7 @@ async function checkHasPages(octokit, owner, repo) {
 }
 async function getUpstreamComparison(octokit, owner, repo, defaultBranch, parent) {
 	const parentBranch = parent.defaultBranchRef?.name;
-	if (!parentBranch) return void 0;
+	if (!parentBranch) return;
 	try {
 		const response = await octokit.rest.repos.compareCommitsWithBasehead({
 			basehead: `${parent.owner.login}:${parentBranch}...${owner}:${defaultBranch}`,

package/dist/lib/sources/go-goreleaser-yaml.js

@@ -43,7 +43,8 @@ function isNonEmptyString(value) {
 }
 /**
 * Get the first non-empty string value of a given field from an array of
-* package-manager section entries. Skips Go template strings (containing `{{`).
+* package-manager section entries. Skips Go template strings (containing
+* `{{`).
 */
 function firstString(sections, field) {
 	for (const section of sections) if (isPlainObject(section)) {
@@ -52,8 +53,8 @@ function firstString(sections, field) {
 	}
 }
 /**
-* Collect all section entries for a given key, handling both v1 singular
-* and v2 plural forms.
+* Collect all section entries for a given key, handling both v1 singular and v2
+* plural forms.
 */
 function collectSections(data, ...keys) {
 	const result = [];
@@ -78,7 +79,7 @@ function parse$1(source) {
 	} catch {
 		return;
 	}
-	if (!isPlainObject(data)) return void 0;
+	if (!isPlainObject(data)) return;
 	const result = {
 		description: void 0,
 		homepage: void 0,

package/dist/lib/sources/java-pom-xml.js

@@ -38,28 +38,46 @@ const pomXmlOrganizationSchema = z.object({
 	url: z.string().optional()
 });
 const pomXmlSchema = z.object({
+	/** Maven artifactId. */
 	artifactId: nonEmptyString,
+	/** CI management URL. */
 	ciManagementUrl: optionalUrl,
+	/** Project contributors. */
 	contributors: z.array(pomXmlPersonEntrySchema),
+	/** Runtime dependencies (non-test scope). */
 	dependencies: z.array(pomXmlDependencyEntrySchema),
+	/** Project description. */
 	description: nonEmptyString,
+	/** Test-scope dependencies. */
 	devDependencies: z.array(pomXmlDependencyEntrySchema),
+	/** Project developers / authors. */
 	developers: z.array(pomXmlPersonEntrySchema),
+	/** Maven groupId. */
 	groupId: nonEmptyString,
+	/** Combined identifier (groupId.artifactId). */
 	identifier: nonEmptyString,
+	/** Year of project inception. */
 	inceptionYear: nonEmptyString,
+	/** Issue tracker URL. */
 	issueManagementUrl: optionalUrl,
+	/** Java version from properties. */
 	javaVersion: nonEmptyString,
+	/** Project licenses. */
 	licenses: z.array(pomXmlLicenseEntrySchema),
+	/** Project name (with Maven variables resolved). */
 	name: nonEmptyString,
+	/** Producer organization. */
 	organization: pomXmlOrganizationSchema.optional(),
+	/** SCM (source code management) URL. */
 	scmUrl: optionalUrl,
+	/** Project URL / homepage. */
 	url: optionalUrl,
+	/** Project version. */
 	version: nonEmptyString
 });
 /**
-* Parse a Maven `pom.xml` content string into a structured object.
-* Returns undefined if the XML is malformed or missing the `<project>` root element.
+* Parse a Maven `pom.xml` content string into a structured object. Returns
+* undefined if the XML is malformed or missing the `<project>` root element.
 */
 function parse(content) {
 	const parser = new XMLParser({
@@ -70,12 +88,12 @@ function parse(content) {
 	let data;
 	try {
 		const parsed = parser.parse(content);
-		if (!is.plainObject(parsed)) return void 0;
+		if (!is.plainObject(parsed)) return;
 		data = parsed;
 	} catch {
 		return;
 	}
-	if (!is.plainObject(data.project)) return void 0;
+	if (!is.plainObject(data.project)) return;
 	const { project } = data;
 	const groupId = getString(project.groupId);
 	const artifactId = getString(project.artifactId);
@@ -102,13 +120,13 @@ function parse(content) {
 	});
 }
 /**
-* Get a trimmed non-empty string from a parsed XML value.
-* Returns undefined for empty strings, non-strings, whitespace-only, or Maven variable references.
+* Get a trimmed non-empty string from a parsed XML value. Returns undefined for
+* empty strings, non-strings, whitespace-only, or Maven variable references.
 */
 function getString(value) {
-	if (typeof value !== "string") return void 0;
+	if (typeof value !== "string") return;
 	const trimmed = value.trim();
-	if (trimmed.length === 0) return void 0;
+	if (trimmed.length === 0) return;
 	return trimmed;
 }
 /**
@@ -116,7 +134,7 @@ function getString(value) {
 */
 function getCleanString(value) {
 	const s = getString(value);
-	if (s?.includes("$")) return void 0;
+	if (s?.includes("$")) return;
 	return s;
 }
 /**
@@ -124,18 +142,19 @@ function getCleanString(value) {
 */
 function resolveName(project, groupId, artifactId) {
 	const name = getString(project.name);
-	if (!name) return void 0;
+	if (!name) return;
 	let resolved = name;
 	if (groupId) resolved = resolved.replaceAll("${project.groupId}", groupId);
 	if (artifactId) resolved = resolved.replaceAll("${project.artifactId}", artifactId);
 	return resolved;
 }
 /**
-* Extract a URL from a nested object (e.g. `<ciManagement><url>...</url></ciManagement>`).
-* Filters out Maven variable references.
+* Extract a URL from a nested object (e.g.
+* `<ciManagement><url>...</url></ciManagement>`). Filters out Maven variable
+* references.
 */
 function getNestedUrl(container) {
-	if (!is.plainObject(container)) return void 0;
+	if (!is.plainObject(container)) return;
 	return getCleanString(container.url);
 }
 /**
@@ -207,27 +226,27 @@ function parseDependencies(project) {
 * Parse SCM URL, filtering out Maven variable references.
 */
 function parseScmUrl(project) {
-	if (!is.plainObject(project.scm)) return void 0;
+	if (!is.plainObject(project.scm)) return;
 	return getCleanString(project.scm.url);
 }
 /**
 * Parse organization from `<organization>` element.
 */
 function parseOrganization(project) {
-	if (!is.plainObject(project.organization)) return void 0;
+	if (!is.plainObject(project.organization)) return;
 	const name = getString(project.organization.name);
-	if (!name) return void 0;
+	if (!name) return;
 	return {
 		name,
 		url: getString(project.organization.url)
 	};
 }
 /**
-* Extract Java version from project properties.
-* Checks `java.version`, `maven.compiler.source`, and `java.compiler.source`.
+* Extract Java version from project properties. Checks `java.version`,
+* `maven.compiler.source`, and `java.compiler.source`.
 */
 function parseJavaVersion(project) {
-	if (!is.plainObject(project.properties)) return void 0;
+	if (!is.plainObject(project.properties)) return;
 	return getCleanString(project.properties["java.version"]) ?? getCleanString(project.properties["maven.compiler.source"]) ?? getCleanString(project.properties["java.compiler.source"]);
 }
 const javaPomXmlSource = defineSource({

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

@@ -1,10 +1,7 @@
 import { OneOrMany, SourceRecord } from "../source.js";
+import { LicenseMatch } from "../utilities/license-identification.js";
 
 //#region src/lib/sources/license-file.d.ts
-type LicenseMatch = {
-  /** Match confidence between 0 and 1. */confidence: number; /** SPDX license identifier (e.g. "MIT"). */
-  spdxId: string;
-};
 type LicenseFileData = OneOrMany<SourceRecord<LicenseMatch>> | undefined;
 //#endregion
 export { LicenseFileData };

package/dist/lib/sources/license-file.js

@@ -13,10 +13,7 @@ const licenseFileSource = defineSource({
 		const match = identifyLicense(await readFile(resolve(context.options.path, input), "utf8"));
 		if (!match) return;
 		return {
-			data: {
-				confidence: match.confidence,
-				spdxId: match.spdxId
-			},
+			data: match,
 			source: input
 		};
 	},

package/dist/lib/sources/metadata-file.js

@@ -9,27 +9,30 @@ import { z } from "zod";
 import { parse } from "yaml";
 //#region src/lib/sources/metadata-file.ts
 /**
-* Source and parser for custom `metadata.json` / `metadata.yaml` / `metadata.yml` files.
+* Source and parser for custom `metadata.json` / `metadata.yaml` /
+* `metadata.yml` files.
 *
-* This is a simple custom format with synonymous field names for common
-* project metadata. It supports JSON and YAML formats.
+* This is a simple custom format with synonymous field names for common project
+* metadata. It supports JSON and YAML formats.
 *
-* Field mapping (with fallback chains):
-*   description                                        → description
-*   homepage | url | repository (normalized) | website → homepage
-*   keywords | tags | topics                           → keywords
-*   repository (normalized)                            → repository
+* Field mapping (with fallback chains): description → description homepage |
+* url | repository (normalized) | website → homepage keywords | tags | topics →
+* keywords repository (normalized) → repository
 */
 const metadataSchema = z.object({
+	/** Project description. */
 	description: nonEmptyString,
+	/** Project homepage URL (resolved from homepage, url, repository, or website). */
 	homepage: optionalUrl,
+	/** Keyword list (resolved from keywords, tags, or topics). */
 	keywords: stringArray,
+	/** Repository URL (normalized, stripped of git+ prefix and .git suffix). */
 	repository: optionalUrl
 });
 /**
-* Parse a metadata file content string into a structured object.
-* The `format` parameter determines whether to parse as JSON or YAML.
-* Returns undefined if the content is malformed or not an object.
+* Parse a metadata file content string into a structured object. The `format`
+* parameter determines whether to parse as JSON or YAML. Returns undefined if
+* the content is malformed or not an object.
 */
 function parse$1(content, format) {
 	let data;
@@ -53,7 +56,7 @@ function parse$1(content, format) {
 }
 /** Return a trimmed string if the value is a non-empty string, else undefined. */
 function nonEmpty(value) {
-	if (typeof value !== "string") return void 0;
+	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }

package/dist/lib/sources/node-npm-registry.js

@@ -64,7 +64,7 @@ const npmDownloadsSchema = z.object({ downloads: z.number() });
 async function fetchDownloads(packageName, period) {
 	try {
 		const response = await fetchWithRetry(`https://api.npmjs.org/downloads/point/${period}/${encodeURIComponent(packageName)}`);
-		if (!response.ok) return void 0;
+		if (!response.ok) return;
 		return npmDownloadsSchema.parse(await response.json()).downloads;
 	} catch {
 		return;