refactor: add explicit undefined to optional properties

Update optional property types to include explicit | undefined for
exactOptionalPropertyTypes TypeScript compliance.

Author: jdalton

src/package-url.ts

@@ -59,12 +59,12 @@ export type PackageURLComponentValue = string | QualifiersObject | undefined
  * Contains all package URL components as properties.
  */
 export type PackageURLObject = {
-  type?: string
-  namespace?: string
-  name?: string
-  version?: string
-  qualifiers?: QualifiersObject
-  subpath?: string
+  type?: string | undefined
+  namespace?: string | undefined
+  name?: string | undefined
+  version?: string | undefined
+  qualifiers?: QualifiersObject | undefined
+  subpath?: string | undefined
 }
 
 // Pattern to match URLs with schemes other than "pkg".

src/validate.ts

@@ -21,7 +21,7 @@ function validateEmptyByType(
   type: string,
   name: string,
   value: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const { throws = false } =
@@ -41,7 +41,7 @@ function validateEmptyByType(
  */
 function validateName(
   name: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -56,7 +56,7 @@ function validateName(
  */
 function validateNamespace(
   namespace: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -69,7 +69,7 @@ function validateNamespace(
  */
 function validateQualifierKey(
   key: string,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -116,7 +116,7 @@ function validateQualifierKey(
  */
 function validateQualifiers(
   qualifiers: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -157,7 +157,7 @@ function validateQualifiers(
 function validateRequired(
   name: string,
   value: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const { throws = false } =
@@ -179,7 +179,7 @@ function validateRequiredByType(
   type: string,
   name: string,
   value: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const { throws = false } =
@@ -200,7 +200,7 @@ function validateRequiredByType(
 function validateStartsWithoutNumber(
   name: string,
   value: string,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const { throws = false } =
@@ -224,7 +224,7 @@ function validateStartsWithoutNumber(
 function validateStrings(
   name: string,
   value: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const { throws = false } =
@@ -244,7 +244,7 @@ function validateStrings(
  */
 function validateSubpath(
   subpath: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -257,7 +257,7 @@ function validateSubpath(
  */
 function validateType(
   type: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options
@@ -307,7 +307,7 @@ function validateType(
  */
 function validateVersion(
   version: unknown,
-  options?: { throws?: boolean } | boolean,
+  options?: { throws?: boolean | undefined } | boolean | undefined,
 ): boolean {
   // Support both legacy boolean parameter and new options object for backward compatibility.
   const opts = typeof options === 'boolean' ? { throws: options } : options