metascope 0.7.0 → 0.7.2

package/dist/lib/sources/processing-sketch-properties.js

@@ -13,34 +13,78 @@ const processingSketchPropertiesAuthorEntrySchema = z.object({
 	url: z.string().optional()
 });
 const processingSketchPropertiesSchema = z.object({
+	/**
+	* Parsed author entries with optional URLs. _Unofficial: borrowed from
+	* library.properties_
+	*/
 	authors: z.array(processingSketchPropertiesAuthorEntrySchema),
+	/** Contributed component type. */
 	component: nonEmptyString,
+	/** Direct download URL. _Unofficial: borrowed from library.properties_ */
 	download: optionalUrl,
+	/** Primary .pde filename for the sketch. */
 	main: nonEmptyString,
+	/** Android app label. From `manifest.label`. */
 	manifestLabel: nonEmptyString,
+	/**
+	* Android screen orientation, e.g. "unspecified". From
+	* `manifest.orientation`.
+	*/
 	manifestOrientation: nonEmptyString,
+	/** Android package name. From `manifest.package`. */
 	manifestPackage: nonEmptyString,
+	/** Android permission list. From `manifest.permissions`. */
 	manifestPermissions: z.array(z.string()),
+	/** Android minimum SDK level. From `manifest.sdk.min`. */
 	manifestSdkMin: z.number().optional(),
+	/** Android target SDK level. From `manifest.sdk.target`. */
 	manifestSdkTarget: z.number().optional(),
+	/** Android version code integer. From `manifest.version.code`. */
 	manifestVersionCode: z.number().optional(),
+	/** Android version name string. From `manifest.version.name`. */
 	manifestVersionName: nonEmptyString,
+	/**
+	* Maximum Processing revision, or 0 for no upper constraint. _Unofficial:
+	* borrowed from library.properties_
+	*/
 	maxRevision: z.number(),
+	/**
+	* Minimum Processing revision, or 0 for no lower constraint. _Unofficial:
+	* borrowed from library.properties_
+	*/
 	minRevision: z.number(),
+	/** Mode display name, e.g. "Java", "REPL Mode". */
 	mode: nonEmptyString,
+	/** Mode identifier, e.g. "processing.mode.java.JavaMode". From `mode.id`. */
 	modeId: nonEmptyString,
+	/** Sketch name. _Unofficial: borrowed from library.properties_ */
 	name: nonEmptyString,
+	/**
+	* Extended description paragraph. _Unofficial: borrowed from
+	* library.properties_
+	*/
 	paragraph: nonEmptyString,
+	/**
+	* Human-readable version string. _Unofficial: borrowed from
+	* library.properties_
+	*/
 	prettyVersion: nonEmptyString,
+	/** Raw key-value pairs. */
 	raw: z.record(z.string(), z.string()),
+	/** One-sentence description. _Unofficial: borrowed from library.properties_ */
 	sentence: nonEmptyString,
+	/** Templates string. */
 	templates: nonEmptyString,
+	/** Project URL. _Unofficial: borrowed from library.properties_ */
 	url: optionalUrl,
+	/** Integer release counter. _Unofficial: borrowed from library.properties_ */
 	version: z.number(),
+	/** Zip file name for contributed content. */
 	zipfilename: nonEmptyString
 });
 /**
-* Parse a Processing `sketch.properties` content string into a structured object.
+* Parse a Processing `sketch.properties` content string into a structured
+* object.
 */
 function parse(content) {
 	const raw = parseProperties(content);
@@ -89,13 +133,13 @@ function parse(content) {
 }
 /** 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;
 }
 /**
-* Strip trailing inline comments from a value.
-* Matches the pattern ` # comment text` (space-hash-space).
+* Strip trailing inline comments from a value. Matches the pattern ` # comment
+* text` (space-hash-space).
 */
 function stripInlineComment(value) {
 	const index = value.indexOf(" # ");
@@ -150,7 +194,7 @@ function parseAuthors(value) {
 	return results;
 }
 /**
-* Split plain text on ` and `, `,`, `&` to extract author names.
+* Split plain text on `and`, `,`, `&` to extract author names.
 */
 function addPlainAuthors(text, results) {
 	const parts = text.split(AUTHOR_SEPARATOR_REGEX).map((s) => s.trim()).filter((s) => s.length > 0 && s.toLowerCase() !== "others");
@@ -160,8 +204,8 @@ function addPlainAuthors(text, results) {
 	});
 }
 /**
-* Validate that a sketch.properties file is a Processing sketch.
-* Checks for at least one known Processing sketch key.
+* Validate that a sketch.properties file is a Processing sketch. Checks for at
+* least one known Processing sketch key.
 */
 function isProcessingSketchProperties(content) {
 	const raw = parseProperties(content);

package/dist/lib/sources/publiccode-yaml.d.ts

@@ -3,9 +3,9 @@ import { z } from "zod";
 
 //#region src/lib/sources/publiccode-yaml.d.ts
 declare const publiccodeSchema: z.ZodObject<{
-  applicationSuite: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  availableLanguages: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  categories: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  applicationSuite: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  availableLanguages: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  categories: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   contacts: z.ZodArray<z.ZodObject<{
     affiliation: z.ZodOptional<z.ZodString>;
     email: z.ZodOptional<z.ZodString>;
@@ -45,27 +45,27 @@ declare const publiccodeSchema: z.ZodObject<{
     longDescription: z.ZodOptional<z.ZodString>;
     shortDescription: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  developmentStatus: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  inputTypes: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  isBasedOn: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  landingUrl: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  developmentStatus: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  inputTypes: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  isBasedOn: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  landingUrl: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   localisationReady: z.ZodOptional<z.ZodBoolean>;
-  logo: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  mainCopyrightOwner: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintenanceType: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  monochromeLogo: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  outputTypes: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  platforms: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  publiccodeYmlVersion: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  releaseDate: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  repoOwner: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  roadmap: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  softwareType: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  softwareVersion: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  url: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  usedBy: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  logo: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  mainCopyrightOwner: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintenanceType: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  monochromeLogo: 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>>>;
+  outputTypes: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  platforms: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  publiccodeYmlVersion: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  releaseDate: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  repoOwner: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  roadmap: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  softwareType: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  softwareVersion: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  url: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  usedBy: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 type Publiccode = z.infer<typeof publiccodeSchema>;
 type PubliccodeYamlData = OneOrMany<SourceRecord<Publiccode>> | undefined;

package/dist/lib/sources/publiccode-yaml.js

@@ -10,8 +10,8 @@ import { parse } from "yaml";
 * Source and parser for `publiccode.yml` / `publiccode.yaml` files.
 *
 * Publiccode.yml is a metadata standard for public software repositories,
-* primarily used in Europe (Italy, Netherlands, etc.).
-* See: https://yml.publiccode.tools/
+* primarily used in Europe (Italy, Netherlands, etc.). See:
+* https://yml.publiccode.tools/
 *
 * Extracts project metadata including name, version, license, contacts,
 * multi-language descriptions, dependencies, and categorization.
@@ -48,34 +48,63 @@ const publiccodeDescriptionSchema = z.object({
 	shortDescription: z.string().optional()
 });
 const publiccodeSchema = z.object({
+	/** Application suite this software belongs to. */
 	applicationSuite: nonEmptyString,
+	/** Available localization languages (BCP 47). */
 	availableLanguages: stringArray,
+	/** Software categories (e.g. "it-security", "cloud-management"). */
 	categories: stringArray,
+	/** Maintenance contacts. */
 	contacts: z.array(publiccodeContactEntrySchema),
+	/** Maintenance contractors. */
 	contractors: z.array(publiccodeContractorEntrySchema),
+	/** Software dependencies (open, proprietary, hardware). */
 	dependencies: z.array(publiccodeDependencyEntrySchema),
+	/** Preferred description (English if available, else first language). */
 	description: publiccodeDescriptionSchema.optional(),
+	/** All localized descriptions keyed by language code. */
 	descriptions: z.record(z.string(), publiccodeDescriptionSchema),
+	/** Development status (concept, development, beta, stable, obsolete). */
 	developmentStatus: nonEmptyString,
+	/** Supported input MIME types. */
 	inputTypes: stringArray,
+	/** URL of upstream software this is based on. */
 	isBasedOn: optionalUrl,
+	/** Landing page URL. */
 	landingUrl: optionalUrl,
+	/** SPDX license expression. */
 	license: nonEmptyString,
+	/** Whether the software supports localization. */
 	localisationReady: z.boolean().optional(),
+	/** Path or URL to logo image. */
 	logo: optionalUrl,
+	/** Main copyright holder. */
 	mainCopyrightOwner: nonEmptyString,
+	/** Maintenance type (internal, community, contract, none). */
 	maintenanceType: nonEmptyString,
+	/** Path or URL to monochrome logo image. */
 	monochromeLogo: optionalUrl,
+	/** Software name. */
 	name: nonEmptyString,
+	/** Supported output MIME types. */
 	outputTypes: stringArray,
+	/** Supported platforms (e.g. "web", "linux", "mac"). */
 	platforms: stringArray,
+	/** The publiccode.yml schema version. */
 	publiccodeYmlVersion: nonEmptyString,
+	/** Release date (YYYY-MM-DD). */
 	releaseDate: nonEmptyString,
+	/** Repository owner name. */
 	repoOwner: nonEmptyString,
+	/** Roadmap URL. */
 	roadmap: optionalUrl,
+	/** Software type (e.g. "standalone/web", "standalone/other"). */
 	softwareType: nonEmptyString,
+	/** Software version string. */
 	softwareVersion: nonEmptyString,
+	/** Repository URL. */
 	url: optionalUrl,
+	/** Organizations using this software. */
 	usedBy: stringArray
 });
 /** Coerce YAML values that may be parsed as non-strings back to strings. */
@@ -115,8 +144,11 @@ function parseDescription(data) {
 }
 /**
 * Parse a publiccode.yml / publiccode.yaml file content.
+*
 * @param content - Raw YAML file content.
-* @returns Parsed publiccode metadata, or `undefined` if the content is invalid.
+*
+* @returns Parsed publiccode metadata, or `undefined` if the content is
+*   invalid.
 */
 function parse$1(content) {
 	let data;
@@ -125,8 +157,8 @@ function parse$1(content) {
 	} catch {
 		return;
 	}
-	if (!isPlainObject(data)) return void 0;
-	if (!isNonEmptyString(data.name) && !isNonEmptyString(data.url)) return void 0;
+	if (!isPlainObject(data)) return;
+	if (!isNonEmptyString(data.name) && !isNonEmptyString(data.url)) return;
 	const descriptions = {};
 	let description;
 	if (isPlainObject(data.description)) {

package/dist/lib/sources/python-pkg-info.d.ts

@@ -4,26 +4,26 @@ import { z } from "zod";
 //#region src/lib/sources/python-pkg-info.d.ts
 /** Parsed PKG-INFO / METADATA metadata */
 declare const pkgInfoDataSchema: z.ZodObject<{
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  author_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  classifiers: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  description_content_type: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  download_url: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  home_page: 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>>>;
+  author_email: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  classifiers: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  description_content_type: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  download_url: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  home_page: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  long_description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  metadata_version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  platforms: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  long_description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer_email: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  metadata_version: 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>>>;
+  platforms: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   project_urls: z.ZodRecord<z.ZodString, z.ZodString>;
-  requires_dist: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  requires_python: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  summary: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  requires_dist: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  requires_python: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  summary: 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 PkgInfo = z.infer<typeof pkgInfoDataSchema>;
 type PythonPkgInfoData = OneOrMany<SourceRecord<PkgInfo>> | undefined;

package/dist/lib/sources/python-pkg-info.js

@@ -51,8 +51,8 @@ const HEADER_MAP = {
 * Parse a PKG-INFO or METADATA file and return structured metadata.
 *
 * Handles RFC 822-style headers with multi-value fields (Classifier,
-* Requires-Dist, Project-URL, Platform), continuation lines, and
-* the body section as long_description.
+* Requires-Dist, Project-URL, Platform), continuation lines, and the body
+* section as long_description.
 */
 function parse(source) {
 	const headers = parseRfc822Headers(source);

package/dist/lib/sources/python-setup-cfg.d.ts

@@ -3,23 +3,23 @@ import { z } from "zod";
 
 //#region src/lib/sources/python-setup-cfg.d.ts
 declare const setupCfgDataSchema: z.ZodObject<{
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  author_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  classifiers: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  download_url: 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>>>;
+  author_email: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  classifiers: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  download_url: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   extras_require: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
-  install_requires: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  install_requires: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  long_description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  long_description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer_email: 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>>>;
   project_urls: z.ZodRecord<z.ZodString, z.ZodString>;
-  python_requires: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<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>>;
+  python_requires: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<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>;
 /** Parsed setup.cfg metadata */
 type SetupCfg = z.infer<typeof setupCfgDataSchema>;

package/dist/lib/sources/python-setup-cfg.js

@@ -43,8 +43,8 @@ const STRING_ATTRS = new Set([
 /**
 * Parse a setup.cfg file and return structured metadata.
 *
-* Extracts fields from the `[metadata]` and `[options]` sections,
-* including multi-line values like classifiers and install_requires.
+* Extracts fields from the `[metadata]` and `[options]` sections, including
+* multi-line values like classifiers and install_requires.
 */
 function parse(source) {
 	const sections = parseConfigparser(source);

package/dist/lib/sources/python-setup-py.d.ts

@@ -4,23 +4,23 @@ import { z } from "zod";
 //#region src/lib/sources/python-setup-py.d.ts
 /** Parsed setup.py metadata */
 declare const setupPyDataSchema: z.ZodObject<{
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  author_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  classifiers: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  download_url: 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>>>;
+  author_email: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  classifiers: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  download_url: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   extras_require: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
-  install_requires: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  install_requires: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  long_description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  maintainer_email: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  long_description: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  maintainer_email: 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>>>;
   project_urls: z.ZodRecord<z.ZodString, z.ZodString>;
-  python_requires: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<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>>;
+  python_requires: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<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 SetupPyData = z.infer<typeof setupPyDataSchema>;
 type PythonSetupPyData = OneOrMany<SourceRecord<SetupPyData>> | undefined;

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

@@ -8,7 +8,9 @@ import remarkParse from "remark-parse";
 import { unified } from "unified";
 //#region src/lib/sources/readme-file.ts
 const readmeSchema = z.object({
+	/** YAML frontmatter key-value pairs, if present. */
 	frontmatter: z.record(z.string(), z.unknown()).optional(),
+	/** Project name extracted from the first H1 heading. */
 	name: z.string()
 });
 /**
@@ -21,7 +23,10 @@ function extractText(nodes) {
 		return "";
 	}).join("").trim();
 }
-/** Reusable markdown parser — processor config is stateless, only the AST is per-call. */
+/**
+* Reusable markdown parser — processor config is stateless, only the AST is
+* per-call.
+*/
 const markdownParser = unified().use(remarkParse);
 /**
 * Extract the text content of the first H1 heading from markdown.
@@ -35,13 +40,15 @@ function extractFirstH1(markdown) {
 }
 /**
 * Parse a README file's content.
+*
 * @param content - Raw file content (markdown).
+*
 * @returns Parsed metadata, or `undefined` if no H1 heading is found.
 */
 function parse(content) {
 	const { content: markdown, data } = matter(content);
 	const name = extractFirstH1(markdown);
-	if (!name) return void 0;
+	if (!name) return;
 	return readmeSchema.parse({
 		frontmatter: Object.keys(data).length > 0 ? data : void 0,
 		name

package/dist/lib/sources/ruby-gemspec.d.ts

@@ -4,9 +4,9 @@ import { z } from "zod";
 //#region src/lib/sources/ruby-gemspec.d.ts
 /** @public */
 declare const gemSpecSchema: z.ZodObject<{
-  authors: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  bindir: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  cert_chain: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  authors: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  bindir: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  cert_chain: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   dependencies: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     requirements: z.ZodArray<z.ZodString>;
@@ -15,28 +15,28 @@ declare const gemSpecSchema: z.ZodObject<{
       runtime: "runtime";
     }>;
   }, z.core.$strip>>;
-  description: 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>>>;
   email: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-  executables: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  extensions: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  executables: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  extensions: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   extra: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-  extra_rdoc_files: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  files: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  homepage: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  licenses: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  extra_rdoc_files: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  files: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  homepage: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  licenses: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   metadata: z.ZodRecord<z.ZodString, z.ZodString>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  platform: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  post_install_message: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  rdoc_options: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  require_paths: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  required_ruby_version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  required_rubygems_version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  signing_key: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  summary: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  test_files: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  version: 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>>>;
+  platform: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  post_install_message: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  rdoc_options: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  require_paths: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  required_ruby_version: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  required_rubygems_version: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  signing_key: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  summary: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  test_files: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  version: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
 }, z.core.$strip>;
 type GemSpec = z.infer<typeof gemSpecSchema>;
 type RubyGemspecData = OneOrMany<SourceRecord<GemSpec>> | undefined;

package/dist/lib/sources/ruby-gemspec.js

@@ -21,6 +21,7 @@ const gemSpecSchema = z.object({
 	email: z.union([z.string(), z.array(z.string())]).optional(),
 	executables: stringArray,
 	extensions: stringArray,
+	/** Any attributes not explicitly modeled above */
 	extra: z.record(z.string(), z.unknown()),
 	extra_rdoc_files: stringArray,
 	files: stringArray,

package/dist/lib/sources/rust-cargo-toml.d.ts

@@ -11,28 +11,28 @@ declare const cargoTomlSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  categories: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  categories: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
   dependencies: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  description: 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>>>;
   devDependencies: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  documentation: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  edition: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  homepage: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  keywords: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  license: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  licenseFile: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  readme: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  repository: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  rustVersion: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  version: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  workspaceMembers: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+  documentation: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  edition: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  homepage: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  keywords: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  license: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  licenseFile: 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>>>;
+  readme: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  repository: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  rustVersion: 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>>>;
+  workspaceMembers: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 type CargoToml = z.infer<typeof cargoTomlSchema>;
 type RustCargoTomlData = OneOrMany<SourceRecord<CargoToml>> | undefined;