metascope 0.7.0 → 0.7.2

package/dist/lib/sources/rust-cargo-toml.js

@@ -8,12 +8,13 @@ import { z } from "zod";
 import { parse } from "smol-toml";
 //#region src/lib/sources/rust-cargo-toml.ts
 /**
-* Source for Rust `Cargo.toml` manifest files.
-* These are TOML files used by the Cargo package manager. Metadata lives
-* primarily in the `[package]` table, with dependencies in `[dependencies]`,
-* `[dev-dependencies]`, and `[build-dependencies]`.
+* Source for Rust `Cargo.toml` manifest files. These are TOML files used by the
+* Cargo package manager. Metadata lives primarily in the `[package]` table,
+* with dependencies in `[dependencies]`, `[dev-dependencies]`, and
+* `[build-dependencies]`.
 *
 * Uses `smol-toml` for TOML parsing.
+*
 * @see https://doc.rust-lang.org/cargo/reference/manifest.html
 */
 const cargoTomlAuthorEntrySchema = z.object({
@@ -25,34 +26,52 @@ const cargoTomlDependencyEntrySchema = z.object({
 	version: z.string().optional()
 });
 const cargoTomlSchema = z.object({
+	/** Parsed author entries from `package.authors`. */
 	authors: z.array(cargoTomlAuthorEntrySchema),
+	/** Build dependency names and versions from `[build-dependencies]`. */
 	buildDependencies: z.array(cargoTomlDependencyEntrySchema),
+	/** Category strings from `package.categories`. */
 	categories: stringArray,
+	/** Dependencies from `[dependencies]`. */
 	dependencies: z.array(cargoTomlDependencyEntrySchema),
+	/** Description from `package.description`. */
 	description: nonEmptyString,
+	/** Dev dependency names and versions from `[dev-dependencies]`. */
 	devDependencies: z.array(cargoTomlDependencyEntrySchema),
+	/** Documentation URL from `package.documentation`. */
 	documentation: optionalUrl,
+	/** Rust edition from `package.edition`. */
 	edition: nonEmptyString,
+	/** Homepage URL from `package.homepage`. */
 	homepage: optionalUrl,
+	/** Keywords from `package.keywords`. */
 	keywords: stringArray,
+	/** License identifier from `package.license`. */
 	license: nonEmptyString,
+	/** License file path from `package.license-file`. */
 	licenseFile: nonEmptyString,
+	/** Package name from `package.name`. */
 	name: nonEmptyString,
+	/** Readme file path from `package.readme`. */
 	readme: nonEmptyString,
+	/** Repository URL from `package.repository`. */
 	repository: optionalUrl,
+	/** Minimum Rust version from `package.rust-version`. */
 	rustVersion: nonEmptyString,
+	/** Version string from `package.version`. */
 	version: nonEmptyString,
+	/** Workspace members from `[workspace]`. */
 	workspaceMembers: stringArray
 });
 /**
-* Parse a `Cargo.toml` content string into a structured object.
-* Returns undefined if the TOML is malformed.
+* Parse a `Cargo.toml` content string into a structured object. Returns
+* undefined if the TOML is malformed.
 */
 function parse$1(content) {
 	let data;
 	try {
 		const parsed = parse(content);
-		if (!is.plainObject(parsed)) return void 0;
+		if (!is.plainObject(parsed)) return;
 		data = parsed;
 	} catch {
 		return;
@@ -82,7 +101,7 @@ function parse$1(content) {
 }
 /** Return a trimmed string, or undefined if not a non-empty string. */
 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;
 }
@@ -122,8 +141,8 @@ function parseAuthors(value) {
 	return results;
 }
 /**
-* Parse a dependencies table into name/version entries.
-* Handles both `dep = "version"` and `dep = { version = "..." }` forms.
+* Parse a dependencies table into name/version entries. Handles both `dep =
+* "version"` and `dep = { version = "..." }` forms.
 */
 function parseDependencies(table) {
 	const results = [];

package/dist/lib/sources/xcode-info-plist.d.ts

@@ -3,18 +3,18 @@ import { z } from "zod";
 
 //#region src/lib/sources/xcode-info-plist.d.ts
 declare const infoPlistSchema: z.ZodObject<{
-  applicationCategory: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  authorEmail: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  copyrightHolder: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  copyrightYear: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  identifier: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  operatingSystems: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  processorRequirements: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  url: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  applicationCategory: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  author: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  authorEmail: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  copyrightHolder: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  copyrightYear: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  identifier: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  name: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  operatingSystems: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  processorRequirements: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  url: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  version: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
 }, z.core.$strip>;
 type InfoPlist = z.infer<typeof infoPlistSchema>;
 type XcodeInfoPlistData = OneOrMany<SourceRecord<InfoPlist>> | undefined;

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.d.ts

@@ -3,17 +3,17 @@ import { z } from "zod";
 
 //#region src/lib/sources/xcode-project-pbxproj.d.ts
 declare const pbxprojSchema: z.ZodObject<{
-  copyrightHolder: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  copyrightYear: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  copyrightHolder: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  copyrightYear: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   dependencies: z.ZodArray<z.ZodObject<{
     url: z.ZodString;
   }, z.core.$strip>>;
-  identifier: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  operatingSystems: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  organizationName: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  programmingLanguage: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  identifier: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  name: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  operatingSystems: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  organizationName: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  programmingLanguage: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  version: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
 }, z.core.$strip>;
 type Pbxproj = z.infer<typeof pbxprojSchema>;
 type XcodeProjectPbxprojData = OneOrMany<SourceRecord<Pbxproj>> | undefined;

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.