metascope 0.7.0 → 0.7.1

package/dist/lib/sources/xcode-info-plist.js

@@ -11,9 +11,10 @@ import plist from "plist";
 * Source and parser for Apple `Info.plist` files.
 *
 * Handles three flavors of Info.plist:
-*   - Standard Apple app/framework bundles (CFBundle* keys)
-*   - Alfred workflow plists (name, createdby, bundleid, etc.)
-*   - TextMate bundle plists (name, contactName, contactEmailRot13, etc.)
+*
+* - Standard Apple app/framework bundles (CFBundle* keys)
+* - Alfred workflow plists (name, createdby, bundleid, etc.)
+* - TextMate bundle plists (name, contactName, contactEmailRot13, etc.)
 *
 * Uses the `plist` npm package to parse XML plist format.
 */
@@ -23,23 +24,38 @@ const ALL_RIGHTS_RESERVED_REGEX = /\.\s*all\s+rights\s+reserved\.?/i;
 const TRAILING_PUNCTUATION_REGEX = /[.,;]+$/;
 const PROCESSOR_ARCH_REGEX = /^(?:arm|x86|i386)/i;
 const infoPlistSchema = z.object({
+	/** Application category (humanized from UTI). */
 	applicationCategory: nonEmptyString,
+	/** Author / creator name. */
 	author: nonEmptyString,
+	/** Author email (decoded from ROT13 for TextMate bundles). */
 	authorEmail: nonEmptyString,
+	/** Copyright holder name. */
 	copyrightHolder: nonEmptyString,
+	/** Copyright year. */
 	copyrightYear: nonEmptyString,
+	/** Description / readme text. */
 	description: nonEmptyString,
+	/** Bundle identifier (e.g. "com.example.app"). */
 	identifier: nonEmptyString,
+	/** Display name of the app or bundle. */
 	name: nonEmptyString,
+	/** Inferred operating systems. */
 	operatingSystems: stringArray,
+	/** Processor architecture requirements (e.g. "armv7"). */
 	processorRequirements: stringArray,
+	/** Homepage URL. */
 	url: optionalUrl,
+	/** Version string. */
 	version: nonEmptyString
 });
 /** Xcode build variable pattern: $(VAR) or ${VAR}. */
 const XCODE_VARIABLE_RE = /\$[({][^)}]+[)}]/;
+/** XML comment, including malformed ones with `--` inside. */
+const XML_COMMENT_RE = /<!--[\s\S]*?-->/g;
 /**
-* Map DTPlatformName / CFBundleSupportedPlatforms values to human-readable OS names.
+* Map DTPlatformName / CFBundleSupportedPlatforms values to human-readable OS
+* names.
 */
 const PLATFORM_NAME_MAP = {
 	appletvos: "tvOS",
@@ -52,18 +68,12 @@ const PLATFORM_NAME_MAP = {
 	xros: "visionOS"
 };
 /**
-* Parse an `Info.plist` content string into a structured object.
-* Returns undefined if the plist is malformed or not a dictionary.
+* Parse an `Info.plist` content string into a structured object. Returns
+* undefined if the plist is malformed or not a dictionary.
 */
 function parse(content) {
-	let data;
-	try {
-		const parsed = plist.parse(content);
-		if (!is.plainObject(parsed)) return;
-		data = parsed;
-	} catch {
-		return;
-	}
+	const data = tryParsePlist(content) ?? tryParsePlist(content.replaceAll(XML_COMMENT_RE, "").trimStart());
+	if (!data) return;
 	const name = getString(data, "CFBundleDisplayName") ?? getString(data, "CFBundleName") ?? getString(data, "name");
 	const description = getString(data, "description");
 	const version = getString(data, "CFBundleShortVersionString") ?? getString(data, "version") ?? getString(data, "CFBundleVersion");
@@ -90,15 +100,27 @@ function parse(content) {
 	});
 }
 /**
-* Get a string value from a plist dict, returning undefined for
-* empty strings, whitespace-only strings, and Xcode variable placeholders.
+* Run `plist.parse` and return the result only if it is a plain-object dict.
+* Returns undefined on any throw or non-dict root.
+*/
+function tryParsePlist(content) {
+	try {
+		const parsed = plist.parse(content);
+		return is.plainObject(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Get a string value from a plist dict, returning undefined for empty strings,
+* whitespace-only strings, and Xcode variable placeholders.
 */
 function getString(data, key) {
 	const value = data[key];
-	if (typeof value !== "string") return void 0;
+	if (typeof value !== "string") return;
 	const trimmed = value.trim();
-	if (trimmed.length === 0) return void 0;
-	if (XCODE_VARIABLE_RE.test(trimmed)) return void 0;
+	if (trimmed.length === 0) return;
+	if (XCODE_VARIABLE_RE.test(trimmed)) return;
 	return trimmed;
 }
 /**
@@ -111,8 +133,8 @@ function rot13(value) {
 	});
 }
 /**
-* Convert an Apple UTI application category to a human-readable string.
-* e.g. "public.app-category.developer-tools" → "Developer Tools"
+* Convert an Apple UTI application category to a human-readable string. e.g.
+* "public.app-category.developer-tools" → "Developer Tools"
 */
 function humanizeCategory(uti) {
 	if (!uti.startsWith("public.app-category.")) return uti;
@@ -123,11 +145,12 @@ function humanizeCategory(uti) {
 */
 function parseApplicationCategory(data) {
 	const category = getString(data, "LSApplicationCategoryType");
-	if (!category) return void 0;
+	if (!category) return;
 	return humanizeCategory(category);
 }
 /**
-* Parse copyright information from NSHumanReadableCopyright or CFBundleGetInfoString.
+* Parse copyright information from NSHumanReadableCopyright or
+* CFBundleGetInfoString.
 */
 function parseCopyright(data) {
 	const copyrightSource = getString(data, "NSHumanReadableCopyright") ?? getString(data, "CFBundleGetInfoString");
@@ -177,7 +200,8 @@ function parseOperatingSystems(data) {
 	return results;
 }
 /**
-* Extract processor architecture requirements from UIRequiredDeviceCapabilities.
+* Extract processor architecture requirements from
+* UIRequiredDeviceCapabilities.
 */
 function parseProcessorRequirements(data) {
 	const capabilities = data.UIRequiredDeviceCapabilities;

package/dist/lib/sources/xcode-project-pbxproj.js

@@ -9,13 +9,14 @@ import { PBXNativeTarget, XCRemoteSwiftPackageReference, XcodeProject } from "@b
 /**
 * Source and parser for Xcode `.pbxproj` project files.
 *
-* Uses the `@bacons/xcode` package to parse the binary/ASCII plist format
-* and navigate the Xcode project object graph.
+* Uses the `@bacons/xcode` package to parse the binary/ASCII plist format and
+* navigate the Xcode project object graph.
 *
 * Extracts metadata from:
-*   - Project-level attributes (organizationName)
-*   - Build settings on the main app target (Release config preferred)
-*   - Swift Package Manager dependencies
+*
+* - Project-level attributes (organizationName)
+* - Build settings on the main app target (Release config preferred)
+* - Swift Package Manager dependencies
 */
 const COPYRIGHT_YEAR_REGEX = /(?:©|\(c\)|copyright)\s*(\d{4})/i;
 const COPYRIGHT_HOLDER_REGEX = /(?:©|\(c\)|copyright)\s*\d{4}\s*(.+)/i;
@@ -23,14 +24,23 @@ const ALL_RIGHTS_RESERVED_REGEX = /\.\s*all\s+rights\s+reserved\.?/i;
 const TRAILING_PUNCTUATION_REGEX = /[.,;]+$/;
 const pbxprojDependencySchema = z.object({ url: z.string() });
 const pbxprojSchema = z.object({
+	/** Copyright holder name. */
 	copyrightHolder: nonEmptyString,
+	/** Copyright year. */
 	copyrightYear: nonEmptyString,
+	/** Swift Package Manager dependencies. */
 	dependencies: z.array(pbxprojDependencySchema),
+	/** Bundle identifier (e.g. "com.example.app"). */
 	identifier: nonEmptyString,
+	/** Display name of the app or target. */
 	name: nonEmptyString,
+	/** Inferred operating systems with deployment targets. */
 	operatingSystems: stringArray,
+	/** Organization name from project attributes. */
 	organizationName: nonEmptyString,
+	/** Detected programming language (Swift or Objective-C). */
 	programmingLanguage: nonEmptyString,
+	/** Marketing version string. */
 	version: nonEmptyString
 });
 /** Xcode build variable pattern: $(VAR) or ${VAR}. */
@@ -71,8 +81,8 @@ const DEPLOYMENT_TARGETS = [
 	}
 ];
 /**
-* Parse a `.pbxproj` file into a structured object.
-* Returns undefined if the file is malformed or cannot be parsed.
+* Parse a `.pbxproj` file into a structured object. Returns undefined if the
+* file is malformed or cannot be parsed.
 */
 function parse(filePath) {
 	let project;
@@ -123,15 +133,15 @@ function parse(filePath) {
 	});
 }
 /**
-* Get a string build setting, filtering out empty strings and unresolved
-* Xcode variable placeholders. Handles both string and numeric values.
+* Get a string build setting, filtering out empty strings and unresolved Xcode
+* variable placeholders. Handles both string and numeric values.
 */
 function cleanString(value) {
 	if (typeof value === "number") return String(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 (XCODE_VARIABLE_RE.test(trimmed)) return void 0;
+	if (trimmed.length === 0) return;
+	if (XCODE_VARIABLE_RE.test(trimmed)) return;
 	return trimmed;
 }
 /**

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

@@ -2,11 +2,10 @@ import { Template } from "../metadata-types.js";
 //#region src/lib/templates/codemeta-json.d.ts
 type TemplateDataCodemetaJson = ReturnType<typeof codemetaJson>;
 /**
- * A JSON-friendly derivation of the `codemeta` template.
- * Produces the same aggregated metadata but parses it through a strict
- * schema,stripping JSON-LD artifacts (like `@context` and `@type`) to yield
- * plain JSON suitable for consumption by tools that don't care to understand
- * JSON-LD.
+ * A JSON-friendly derivation of the `codemeta` template. Produces the same
+ * aggregated metadata but parses it through a strict schema,stripping JSON-LD
+ * artifacts (like `@context` and `@type`) to yield plain JSON suitable for
+ * consumption by tools that don't care to understand JSON-LD.
  *
  * This template also provides a handy baseline normalization abstraction for
  * the other templates.

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

@@ -3,11 +3,10 @@ import { codeMetaJsonDataSchema } from "../sources/codemeta-json.js";
 import { codemeta } from "./codemeta.js";
 //#region src/lib/templates/codemeta-json.ts
 /**
-* A JSON-friendly derivation of the `codemeta` template.
-* Produces the same aggregated metadata but parses it through a strict
-* schema,stripping JSON-LD artifacts (like `@context` and `@type`) to yield
-* plain JSON suitable for consumption by tools that don't care to understand
-* JSON-LD.
+* A JSON-friendly derivation of the `codemeta` template. Produces the same
+* aggregated metadata but parses it through a strict schema,stripping JSON-LD
+* artifacts (like `@context` and `@type`) to yield plain JSON suitable for
+* consumption by tools that don't care to understand JSON-LD.
 *
 * This template also provides a handy baseline normalization abstraction for
 * the other templates.

package/dist/lib/templates/codemeta.js

@@ -13,14 +13,14 @@ import is from "@sindresorhus/is";
 * ## Cascade strategy
 *
 * For **ecosystem-derived fields** (name, version, description, author,
-* license, dependencies, keywords, …) the ecosystem manifest is canonical.
-* This keeps the output fresh when e.g. a new dependency is added to
-* package.json, and makes the round-trip stable: generate → save as
-* codemeta.json → regenerate → identical output.
+* license, dependencies, keywords, …) the ecosystem manifest is canonical. This
+* keeps the output fresh when e.g. a new dependency is added to package.json,
+* and makes the round-trip stable: generate → save as codemeta.json →
+* regenerate → identical output.
 *
 * For **codemeta-specific fields** that only exist in codemeta.json
-* (developmentStatus, funding, buildInstructions, …) the existing
-* codemeta.json is the source of truth.
+* (developmentStatus, funding, buildInstructions, …) the existing codemeta.json
+* is the source of truth.
 *
 * ## Software type inference
 *
@@ -287,7 +287,6 @@ const codemeta = defineTemplate(({ arduinoLibraryProperties, cinderCinderblockXm
 	const releaseNotes = cm?.data.releaseNotes;
 	const installUrl = cm?.data.installUrl;
 	const relatedLink = cm?.data.relatedLink;
-	const targetProduct = void 0;
 	return stripUndefined({
 		"@context": "https://w3id.org/codemeta/3.0",
 		"@type": "SoftwareSourceCode",
@@ -325,15 +324,14 @@ const codemeta = defineTemplate(({ arduinoLibraryProperties, cinderCinderblockXm
 		softwareHelp,
 		softwareRequirements,
 		softwareSuggestions,
-		targetProduct,
+		targetProduct: void 0,
 		url,
 		version
 	});
 });
 /**
-* Extract authors from a gemspec record.
-* Gemspec has `authors: string[]` and a separate `email: string | string[]`.
-* We pair them by index where possible.
+* Extract authors from a gemspec record. Gemspec has `authors: string[]` and a
+* separate `email: string | string[]`. We pair them by index where possible.
 */
 function gemspecAuthors(gem) {
 	if (gem === void 0) return [];
@@ -344,9 +342,9 @@ function gemspecAuthors(gem) {
 	}));
 }
 /**
-* Takes ecosystem persons (which may include undefined) and codemeta fallback persons.
-* Uses ecosystem if any are present, otherwise falls back.
-* Always deduplicates by name.
+* Takes ecosystem persons (which may include undefined) and codemeta fallback
+* persons. Uses ecosystem if any are present, otherwise falls back. Always
+* deduplicates by name.
 */
 function resolvePersonsOrOrgs(ecosystemPersons, fallbackPersons) {
 	const ecosystem = ecosystemPersons.filter((p) => p !== void 0);
@@ -389,11 +387,12 @@ function collectDevelopmentDeps(sources) {
 * Convert a Record<name, version> dependency map to CodemetaDependencyLd[].
 */
 function objectEntriesToDeps(deps) {
-	if (deps === void 0) return void 0;
+	if (deps === void 0) return;
 	return Object.entries(deps).map(([depName, depVersion]) => toDependencyLd(depName, depVersion));
 }
 /**
-* Parse a PEP 508 dependency string ("package>=1.0") into a CodemetaDependencyLd.
+* Parse a PEP 508 dependency string ("package>=1.0") into a
+* CodemetaDependencyLd.
 */
 function parsePep508Dep(dep) {
 	const trimmed = dep.trim();
@@ -408,7 +407,7 @@ function parsePep508Dep(dep) {
 * Extract URL from package.json repository field (string or {url}).
 */
 function repositoryUrlFromPackageJson(repository) {
-	if (repository === void 0) return void 0;
+	if (repository === void 0) return;
 	if (typeof repository === "string") return repository;
 	return repository.url;
 }
@@ -416,7 +415,7 @@ function repositoryUrlFromPackageJson(repository) {
 * Extract URL from package.json bugs field.
 */
 function bugsUrlFromPackageJson(bugs) {
-	if (bugs === void 0) return void 0;
+	if (bugs === void 0) return;
 	return bugs.url;
 }
 /**
@@ -427,11 +426,11 @@ function firstPomLicense(pom) {
 	return pomLicense?.name ?? pomLicense?.url;
 }
 /**
-* Resolve Python pyproject.toml license field to a string.
-* Can be a string (SPDX ID) or `{ spdx?: string; text?: string; file?: string }`.
+* Resolve Python pyproject.toml license field to a string. Can be a string
+* (SPDX ID) or `{ spdx?: string; text?: string; file?: string }`.
 */
 function resolvePythonLicense(pythonLicense) {
-	if (pythonLicense === void 0) return void 0;
+	if (pythonLicense === void 0) return;
 	if (typeof pythonLicense === "string") return pythonLicense;
 	return pythonLicense.spdx ?? pythonLicense.text;
 }
@@ -439,7 +438,7 @@ function resolvePythonLicense(pythonLicense) {
 * Resolve codemeta license field (string or string[]) to first string.
 */
 function resolveCmLicense(cmLicense) {
-	if (cmLicense === void 0) return void 0;
+	if (cmLicense === void 0) return;
 	return Array.isArray(cmLicense) ? cmLicense[0] : cmLicense;
 }
 /**
@@ -454,10 +453,11 @@ function deduplicateStrings(strings) {
 	return [...seen.values()];
 }
 /**
-* Case-insensitive lookup in a string record (e.g. pyproject.toml `[project.urls]`).
+* Case-insensitive lookup in a string record (e.g. pyproject.toml
+* `[project.urls]`).
 */
 function caseInsensitiveLookup(record, key) {
-	if (record === void 0) return void 0;
+	if (record === void 0) return;
 	const lowerKey = key.toLowerCase();
 	for (const [k, v] of Object.entries(record)) if (k.toLowerCase() === lowerKey) return v;
 }
@@ -466,7 +466,7 @@ function caseInsensitiveLookup(record, key) {
 * homepage URLs derived from repository URLs.
 */
 function stripReadmeFragment(url) {
-	if (url === void 0) return void 0;
+	if (url === void 0) return;
 	return url.endsWith("#readme") ? url.slice(0, -7) : url;
 }
 /**
@@ -474,19 +474,19 @@ function stripReadmeFragment(url) {
 * CodeMeta dates are `schema:Date`, not `schema:DateTime`.
 */
 function toDateOnly(value) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	if (DATE_ONLY_REGEX.test(value)) return value;
 	const match = DATETIME_DATE_REGEX.exec(value);
 	if (match) return match[1];
 	return value;
 }
 /**
-* Build a URL for the project's README.
-* Prefers a web URL on the remote service (e.g. GitHub blob link) when a
-* code repository URL is available, otherwise falls back to the local source path.
+* Build a URL for the project's README. Prefers a web URL on the remote service
+* (e.g. GitHub blob link) when a code repository URL is available, otherwise
+* falls back to the local source path.
 */
 function readmeUrl(readmeRecord, repoUrl, defaultBranch, basePath) {
-	if (readmeRecord === void 0) return void 0;
+	if (readmeRecord === void 0) return;
 	const repoRelativePath = basePath === void 0 ? basename(readmeRecord.source) : relative(basePath, readmeRecord.source).replaceAll("\\", "/");
 	if (is.nonEmptyStringAndNotWhitespace(repoUrl) && repoUrl.includes("github.com")) {
 		const branch = defaultBranch ?? "main";

package/dist/lib/templates/metadata.d.ts

@@ -2,8 +2,8 @@ import { Template } from "../metadata-types.js";
 //#region src/lib/templates/metadata.d.ts
 type TemplateDataMetadata = ReturnType<typeof metadata>;
 /**
- * A minimal metadata template for populating a GitHub repository's
- * description, homepage, and topics via metadata.json / metadata.yaml.
+ * A minimal metadata template for populating a GitHub repository's description,
+ * homepage, and topics via metadata.json / metadata.yaml.
  *
  * Builds on the codemeta template for baseline values, then lets any
  * metadata.json source fields override the result.

package/dist/lib/templates/metadata.js

@@ -6,15 +6,15 @@ import { codemetaJson } from "./codemeta-json.js";
 * Strip `git+` prefix and `.git` suffix from a URL.
 */
 function normalizeGitUrl(url) {
-	if (url === void 0) return void 0;
+	if (url === void 0) return;
 	let normalized = url;
 	if (normalized.startsWith("git+")) normalized = normalized.slice(4);
 	if (normalized.endsWith(".git")) normalized = normalized.slice(0, -4);
 	return normalized;
 }
 /**
-* A minimal metadata template for populating a GitHub repository's
-* description, homepage, and topics via metadata.json / metadata.yaml.
+* A minimal metadata template for populating a GitHub repository's description,
+* homepage, and topics via metadata.json / metadata.yaml.
 *
 * Builds on the codemeta template for baseline values, then lets any
 * metadata.json source fields override the result.

package/dist/lib/utilities/codemeta-helpers.d.ts

@@ -2,8 +2,9 @@
 /**
  * Helpers for building codemeta JSON-LD objects.
  *
- * Provides type-safe constructors for Person/Organization and SoftwareApplication
- * dependency nodes, plus deduplication and license URL normalization.
+ * Provides type-safe constructors for Person/Organization and
+ * SoftwareApplication dependency nodes, plus deduplication and license URL
+ * normalization.
  */
 /**
  * An Organization node in codemeta JSON-LD.

package/dist/lib/utilities/codemeta-helpers.js

@@ -3,12 +3,14 @@ import is from "@sindresorhus/is";
 /**
 * Helpers for building codemeta JSON-LD objects.
 *
-* Provides type-safe constructors for Person/Organization and SoftwareApplication
-* dependency nodes, plus deduplication and license URL normalization.
+* Provides type-safe constructors for Person/Organization and
+* SoftwareApplication dependency nodes, plus deduplication and license URL
+* normalization.
 */
 /**
-* Build a codemeta JSON-LD Person or Organization from flexible inputs.
-* Returns undefined if no identifying information (name, givenName+familyName, or email) is present.
+* Build a codemeta JSON-LD Person or Organization from flexible inputs. Returns
+* undefined if no identifying information (name, givenName+familyName, or
+* email) is present.
 *
 * Works with person shapes from any metascope source — the caller maps
 * source-specific field names into this common parameter object.
@@ -18,7 +20,7 @@ function toPersonOrOrgLd(options) {
 	const hasGivenName = is.nonEmptyStringAndNotWhitespace(options.givenName);
 	const hasFamilyName = is.nonEmptyStringAndNotWhitespace(options.familyName);
 	const hasEmail = is.nonEmptyStringAndNotWhitespace(options.email);
-	if (!hasName && !hasGivenName && !hasFamilyName && !hasEmail) return void 0;
+	if (!hasName && !hasGivenName && !hasFamilyName && !hasEmail) return;
 	const person = { "@type": options.type ?? "Person" };
 	if (is.nonEmptyStringAndNotWhitespace(options.id)) person["@id"] = options.id;
 	if (hasName) person.name = options.name;
@@ -33,9 +35,9 @@ function toPersonOrOrgLd(options) {
 	return person;
 }
 /**
-* Deduplicate persons by name (case-insensitive, trimmed).
-* Keeps the first occurrence, so callers should place higher-priority sources first.
-* Returns undefined if the result is empty.
+* Deduplicate persons by name (case-insensitive, trimmed). Keeps the first
+* occurrence, so callers should place higher-priority sources first. Returns
+* undefined if the result is empty.
 */
 function deduplicatePersonsOrOrgs(persons) {
 	const seen = /* @__PURE__ */ new Map();
@@ -60,8 +62,8 @@ function toDependencyLd(name, version, identifier, runtimePlatform) {
 	return dep;
 }
 /**
-* Deduplicate dependencies by name (case-insensitive).
-* Keeps the first occurrence. Returns undefined if the result is empty.
+* Deduplicate dependencies by name (case-insensitive). Keeps the first
+* occurrence. Returns undefined if the result is empty.
 */
 function deduplicateDependencies(deps) {
 	const seen = /* @__PURE__ */ new Map();
@@ -73,8 +75,8 @@ function deduplicateDependencies(deps) {
 	return result.length > 0 ? result : void 0;
 }
 /**
-* Normalize a license identifier to an SPDX URL.
-* Handles bare SPDX IDs ("MIT") and existing SPDX URLs.
+* Normalize a license identifier to an SPDX URL. Handles bare SPDX IDs ("MIT")
+* and existing SPDX URLs.
 */
 function toSpdxLicenseUrl(spdxId) {
 	return `https://spdx.org/licenses/${spdxId.replace("https://spdx.org/licenses/", "").replace("http://spdx.org/licenses/", "")}`;

package/dist/lib/utilities/fetch.js

@@ -1,8 +1,8 @@
 import { log } from "../log.js";
 //#region src/lib/utilities/fetch.ts
 /**
-* Fetch with automatic retries and exponential backoff.
-* Retries on network errors and 429/5xx responses.
+* Fetch with automatic retries and exponential backoff. Retries on network
+* errors and 429/5xx responses.
 */
 async function fetchWithRetry(url, options, maxRetries = 5) {
 	let lastError;

package/dist/lib/utilities/formatting.js

@@ -3,9 +3,10 @@ import { relative } from "node:path";
 //#region src/lib/utilities/formatting.ts
 const URL_PROTOCOL_REGEX = /^[a-z]+:\/\//i;
 /**
-* Format an absolute path as either absolute or relative, based on the `absolute` option.
-* When relative, paths identical to `basePath` are returned as `'.'`.
-* Correctly handles Windows paths (normalizes to POSIX) and ignores URLs.
+* Format an absolute path as either absolute or relative, based on the
+* `absolute` option. When relative, paths identical to `basePath` are returned
+* as `'.'`. Correctly handles Windows paths (normalizes to POSIX) and ignores
+* URLs.
 */
 function formatPath(absolutePath, basePath, absolute = DEFAULT_GET_METADATA_OPTIONS.absolute) {
 	if (URL_PROTOCOL_REGEX.test(absolutePath)) return absolutePath;

package/dist/lib/utilities/github.js

@@ -4,11 +4,11 @@ import gitUrlParse from "git-url-parse";
 * Shared GitHub utilities used across multiple sources.
 */
 /**
-* Extract a GitHub owner/repo from git config remote URLs.
-* Prefers the "origin" remote, falls back to the first GitHub remote found.
+* Extract a GitHub owner/repo from git config remote URLs. Prefers the "origin"
+* remote, falls back to the first GitHub remote found.
 */
 function getGitHubRemoteFromConfig(remotes) {
-	if (!remotes) return void 0;
+	if (!remotes) return;
 	const sorted = Object.entries(remotes).toSorted(([a], [b]) => {
 		if (a === "origin") return -1;
 		if (b === "origin") return 1;

package/dist/lib/utilities/license-identification.d.ts

@@ -15,7 +15,9 @@
  * - YAML front matter stripping
  */
 type LicenseMatch = {
-  /** Dice coefficient confidence score (0–1). */confidence: number; /** SPDX license identifier (e.g. "MIT", "Apache-2.0"). */
+  /** Dice coefficient confidence score (0–1). */confidence: number; /** Full license name (e.g. "MIT License", "Apache License 2.0"). */
+  name: string; /** Whether the license is OSI approved. */
+  osiApproved: boolean; /** SPDX license identifier (e.g. "MIT", "Apache-2.0"). */
   spdxId: string; /** SPDX license URL. */
   spdxUrl: string;
 };