metascope 0.7.0 → 0.7.2

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

@@ -3,8 +3,8 @@ import { z } from "zod";
 
 //#region src/lib/sources/java-pom-xml.d.ts
 declare const pomXmlSchema: z.ZodObject<{
-  artifactId: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  ciManagementUrl: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  artifactId: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  ciManagementUrl: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   contributors: z.ZodArray<z.ZodObject<{
     email: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -16,7 +16,7 @@ declare const pomXmlSchema: z.ZodObject<{
     groupId: 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<{
     artifactId: z.ZodString;
     groupId: z.ZodString;
@@ -28,23 +28,23 @@ declare const pomXmlSchema: z.ZodObject<{
     organization: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  groupId: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  identifier: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  inceptionYear: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  issueManagementUrl: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  javaVersion: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  groupId: 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>>>;
+  inceptionYear: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  issueManagementUrl: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  javaVersion: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   licenses: z.ZodArray<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  name: 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>>>;
   organization: z.ZodOptional<z.ZodObject<{
     name: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  scmUrl: 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>>;
+  scmUrl: 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 PomXml = z.infer<typeof pomXmlSchema>;
 type JavaPomXmlData = OneOrMany<SourceRecord<PomXml>> | undefined;

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/metadata-file.d.ts

@@ -3,10 +3,10 @@ import { z } from "zod";
 
 //#region src/lib/sources/metadata-file.d.ts
 declare const metadataSchema: z.ZodObject<{
-  description: 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>>;
-  repository: 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>>>;
+  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>>>;
+  repository: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
 }, z.core.$strip>;
 type Metadata = z.infer<typeof metadataSchema>;
 type MetadataFileData = OneOrMany<SourceRecord<Metadata>> | undefined;

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;

package/dist/lib/sources/openframeworks-addon-config-mk.d.ts

@@ -3,13 +3,13 @@ import { z } from "zod";
 
 //#region src/lib/sources/openframeworks-addon-config-mk.d.ts
 declare const openframeworksAddonConfigSchema: z.ZodObject<{
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  dependencies: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  platformSections: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  tags: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  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>>>;
+  dependencies: 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>>>;
+  name: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  platformSections: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  tags: 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>>>;
 }, z.core.$strip>;
 type OpenframeworksAddonConfig = z.infer<typeof openframeworksAddonConfigSchema>;
 type OpenframeworksAddonConfigMkData = OneOrMany<SourceRecord<OpenframeworksAddonConfig>> | undefined;

package/dist/lib/sources/openframeworks-addon-config-mk.js

@@ -7,12 +7,19 @@ import { resolve } from "node:path";
 import { z } from "zod";
 //#region src/lib/sources/openframeworks-addon-config-mk.ts
 const openframeworksAddonConfigSchema = z.object({
+	/** `ADDON_AUTHOR` from `meta:` section. */
 	author: nonEmptyString,
+	/** `ADDON_DEPENDENCIES` from `common:` section (space-separated addon names). */
 	dependencies: stringArray,
+	/** `ADDON_DESCRIPTION` from `meta:` section. */
 	description: nonEmptyString,
+	/** `ADDON_NAME` from `meta:` section. */
 	name: nonEmptyString,
+	/** Platform section names that contain at least one variable assignment. */
 	platformSections: stringArray,
+	/** `ADDON_TAGS` from `meta:` section (quote-aware tokenized). */
 	tags: stringArray,
+	/** `ADDON_URL` from `meta:` section. */
 	url: optionalUrl
 });
 /**

package/dist/lib/sources/openframeworks-install-xml.d.ts

@@ -3,16 +3,16 @@ import { z } from "zod";
 
 //#region src/lib/sources/openframeworks-install-xml.d.ts
 declare const openframeworksInstallXmlSchema: z.ZodObject<{
-  author: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  codeUrl: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  description: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  downloadUrl: 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>>;
-  requirements: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-  siteUrl: 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>>;
+  author: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  codeUrl: 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>>>;
+  downloadUrl: 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>>>;
+  requirements: z.ZodDefault<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
+  siteUrl: 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 OpenframeworksInstallXml = z.infer<typeof openframeworksInstallXmlSchema>;
 type OpenframeworksInstallXmlData = OneOrMany<SourceRecord<OpenframeworksInstallXml>> | undefined;

package/dist/lib/sources/openframeworks-install-xml.js

@@ -19,19 +19,29 @@ import { XMLParser } from "fast-xml-parser";
 * content is actually an openFrameworks addon by checking for the `<install>`
 * root element and the presence of "addons" in the file content.
 *
-* Uses `fast-xml-parser` with attribute parsing enabled to read `<lib os="...">`
-* attributes for operating system inference.
+* Uses `fast-xml-parser` with attribute parsing enabled to read `<lib
+* os="...">` attributes for operating system inference.
 */
 const openframeworksInstallXmlSchema = z.object({
+	/** Addon author name. */
 	author: nonEmptyString,
+	/** Source code repository URL. */
 	codeUrl: optionalUrl,
+	/** Description of the addon. */
 	description: nonEmptyString,
+	/** Download URL. */
 	downloadUrl: optionalUrl,
+	/** Addon display name. */
 	name: nonEmptyString,
+	/** Supported operating systems from `<lib os="...">` attributes. */
 	operatingSystems: stringArray,
+	/** Software dependencies from `<requires>` elements. */
 	requirements: stringArray,
+	/** Website URL. */
 	siteUrl: optionalUrl,
+	/** Generic URL (used when no code_url / site_url provided). */
 	url: optionalUrl,
+	/** Version string. */
 	version: nonEmptyString
 });
 /**
@@ -43,9 +53,9 @@ const LIB_OS_MAP = {
 	win32: "Windows"
 };
 /**
-* Parse a legacy openFrameworks `install.xml` content string into a structured object.
-* Returns undefined if the XML is malformed, missing the `<install>` root element,
-* or does not appear to be an openFrameworks addon.
+* Parse a legacy openFrameworks `install.xml` content string into a structured
+* object. Returns undefined if the XML is malformed, missing the `<install>`
+* root element, or does not appear to be an openFrameworks addon.
 */
 function parse(content) {
 	if (!content.toLowerCase().includes("addons")) return;
@@ -58,12 +68,12 @@ function parse(content) {
 	let data;
 	try {
 		const parsed = parser.parse(fixedContent);
-		if (!is.plainObject(parsed)) return void 0;
+		if (!is.plainObject(parsed)) return;
 		data = parsed;
 	} catch {
 		return;
 	}
-	if (!is.plainObject(data.install)) return void 0;
+	if (!is.plainObject(data.install)) return;
 	const { install } = data;
 	return openframeworksInstallXmlSchema.parse({
 		author: getString(install.author),
@@ -79,17 +89,17 @@ function parse(content) {
 	});
 }
 /**
-* Get a trimmed non-empty string from a parsed XML value.
-* Returns undefined for empty strings, non-strings, or whitespace-only values.
+* Get a trimmed non-empty string from a parsed XML value. Returns undefined for
+* empty strings, non-strings, or whitespace-only values.
 */
 function getString(value) {
-	if (typeof value !== "string") return void 0;
+	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : void 0;
 }
 /**
-* Extract software requirements from `<requires>`.
-* Handles three variants:
+* Extract software requirements from `<requires>`. Handles three variants:
+*
 * 1. Empty — skip
 * 2. Free text — emit as-is
 * 3. Structured `<addon>` children — emit each separately
@@ -112,8 +122,8 @@ function parseRequirements(install) {
 	return [];
 }
 /**
-* Extract operating system information from `<lib os="...">` attributes
-* found within `<add><link>` sections.
+* Extract operating system information from `<lib os="...">` attributes found
+* within `<add><link>` sections.
 */
 function parseOperatingSystems(install) {
 	if (!is.plainObject(install.add)) return [];

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

@@ -25,17 +25,17 @@ declare const processingLibraryPropertiesSchema: z.ZodObject<{
     Typography: "Typography";
     "Video & Vision": "Video & Vision";
   }>>;
-  download: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  id: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  download: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  id: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   maxRevision: z.ZodNumber;
   minRevision: z.ZodNumber;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  paragraph: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  prettyVersion: 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>>>;
+  paragraph: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  prettyVersion: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   raw: z.ZodRecord<z.ZodString, z.ZodString>;
-  sentence: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  type: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  url: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  sentence: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  type: 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.ZodNumber;
 }, z.core.$strip>;
 type ProcessingLibraryProperties = z.infer<typeof processingLibraryPropertiesSchema>;

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

@@ -35,23 +35,38 @@ const CANONICAL_CATEGORIES = [
 const CATEGORY_MAP = new Map(CANONICAL_CATEGORIES.map((cat) => [cat.replaceAll(/[^a-z]/gi, "").toLowerCase(), cat]));
 CATEGORY_MAP.set("3d", "3D");
 const processingLibraryPropertiesSchema = z.object({
+	/** Parsed author entries with optional URLs. */
 	authors: z.array(processingLibraryPropertiesAuthorEntrySchema),
+	/** Normalized categories. */
 	categories: z.array(z.enum(CANONICAL_CATEGORIES)),
+	/** Direct download URL for the .zip distribution. */
 	download: optionalUrl,
+	/** Numeric identifier assigned by Processing contribution manager. */
 	id: nonEmptyString,
+	/** Maximum Processing revision, or 0 for no upper constraint. */
 	maxRevision: z.number(),
+	/** Minimum Processing revision, or 0 for no lower constraint. */
 	minRevision: z.number(),
+	/** Library name. */
 	name: nonEmptyString,
+	/** Extended description paragraph. */
 	paragraph: nonEmptyString,
+	/** Human-readable version string. */
 	prettyVersion: nonEmptyString,
+	/** Raw key-value pairs. */
 	raw: z.record(z.string(), z.string()),
+	/** One-sentence description. */
 	sentence: nonEmptyString,
+	/** Contribution type (library, tool, mode, examples). */
 	type: nonEmptyString,
+	/** Project URL. */
 	url: optionalUrl,
+	/** Integer release counter. */
 	version: z.number()
 });
 /**
-* Parse a Processing `library.properties` content string into a structured object.
+* Parse a Processing `library.properties` content string into a structured
+* object.
 */
 function parse(content) {
 	const raw = parseProperties(content);
@@ -86,28 +101,28 @@ 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;
 }
 /**
-* 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(" # ");
 	return index === -1 ? value : value.slice(0, index).trim();
 }
 /**
-* Unescape backslash-escaped colons in URLs.
-* Some Processing fixtures use `https\://` instead of `https://`.
+* Unescape backslash-escaped colons in URLs. Some Processing fixtures use
+* `https\://` instead of `https://`.
 */
 function unescapeUrl(value) {
 	return value.replaceAll(String.raw`\:`, ":");
 }
 /**
-* Parse a Processing authors/authorList value into AuthorEntry[].
-* Preserves original order of appearance.
+* Parse a Processing authors/authorList value into AuthorEntry[]. Preserves
+* original order of appearance.
 */
 function parseAuthors(value) {
 	const trimmed = value.trim();
@@ -149,8 +164,8 @@ function parseAuthors(value) {
 	return results;
 }
 /**
-* Split plain text on ` and `, `,`, `&` to extract author names.
-* Filters out bare "others" entries.
+* Split plain text on `and`, `,`, `&` to extract author names. Filters out bare
+* "others" entries.
 */
 function addPlainAuthors(text, results) {
 	const parts = text.split(AUTHOR_SEPARATOR_REGEX).map((s) => s.trim()).filter((s) => s.length > 0 && s.toLowerCase() !== "others");

package/dist/lib/sources/processing-sketch-properties.d.ts

@@ -7,30 +7,30 @@ declare const processingSketchPropertiesSchema: z.ZodObject<{
     name: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
-  component: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  download: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  main: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  manifestLabel: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  manifestOrientation: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  manifestPackage: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  component: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  download: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  main: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  manifestLabel: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  manifestOrientation: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  manifestPackage: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   manifestPermissions: z.ZodArray<z.ZodString>;
   manifestSdkMin: z.ZodOptional<z.ZodNumber>;
   manifestSdkTarget: z.ZodOptional<z.ZodNumber>;
   manifestVersionCode: z.ZodOptional<z.ZodNumber>;
-  manifestVersionName: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  manifestVersionName: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   maxRevision: z.ZodNumber;
   minRevision: z.ZodNumber;
-  mode: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  modeId: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  name: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  paragraph: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  prettyVersion: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  mode: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  modeId: 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>>>;
+  paragraph: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  prettyVersion: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
   raw: z.ZodRecord<z.ZodString, z.ZodString>;
-  sentence: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  templates: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
-  url: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  sentence: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
+  templates: 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.ZodNumber;
-  zipfilename: z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+  zipfilename: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | undefined, unknown>, z.ZodOptional<z.ZodString>>>;
 }, z.core.$strip>;
 type ProcessingSketchProperties = z.infer<typeof processingSketchPropertiesSchema>;
 type ProcessingSketchPropertiesData = OneOrMany<SourceRecord<ProcessingSketchProperties>> | undefined;