refactor(types): improve type annotations for better type coverage

Add explicit type annotations to improve type coverage:
- UNDEFINED_TOKEN: explicit undefined type
- globs.ts: typed matcherCache Map, typed require() calls
- signal-exit.ts: typed __signal_exit_emitter__
- sorts.ts: typed semver and fastSort require() imports

These changes help move toward 99%+ type coverage goal.

Author: jdalton

src/constants/core.ts

@@ -18,7 +18,7 @@ export const EMPTY_FILE = '/* empty */\n'
 export const EMPTY_VALUE = '<value>'
 
 // Undefined token.
-export const UNDEFINED_TOKEN = undefined
+export const UNDEFINED_TOKEN: undefined = undefined
 
 // Miscellaneous.
 export const V = 'v'

src/globs.ts

@@ -104,8 +104,12 @@ let _fastGlob: typeof import('fast-glob') | undefined
 /*@__NO_SIDE_EFFECTS__*/
 function getFastGlob() {
   if (_fastGlob === undefined) {
-    const globExport = /*@__PURE__*/ require('./external/fast-glob')
-    _fastGlob = globExport.default || globExport
+    const globExport = /*@__PURE__*/ require('./external/fast-glob') as
+      | (typeof import('fast-glob') & { default?: typeof import('fast-glob') })
+      | typeof import('fast-glob')
+    _fastGlob = (
+      'default' in globExport ? globExport.default : globExport
+    ) as typeof import('fast-glob')
   }
   return _fastGlob as typeof import('fast-glob')
 }
@@ -129,18 +133,15 @@ export function globStreamLicenses(
     '**/*.{cjs,cts,js,json,mjs,mts,ts}',
   ]
   if (ignoreOriginals) {
-    ignore.push(
-      /*@__INLINE__*/ require('#constants/paths')
-        .LICENSE_ORIGINAL_GLOB_RECURSIVE,
-    )
+    const { LICENSE_ORIGINAL_GLOB_RECURSIVE } =
+      /*@__INLINE__*/ require('#constants/paths') as typeof import('#constants/paths')
+    ignore.push(LICENSE_ORIGINAL_GLOB_RECURSIVE)
   }
   const fastGlob = getFastGlob()
+  const paths =
+    /*@__INLINE__*/ require('#constants/paths') as typeof import('#constants/paths')
   return fastGlob.globStream(
-    [
-      recursive
-        ? /*@__INLINE__*/ require('#constants/paths').LICENSE_GLOB_RECURSIVE
-        : /*@__INLINE__*/ require('#constants/paths').LICENSE_GLOB,
-    ],
+    [recursive ? paths.LICENSE_GLOB_RECURSIVE : paths.LICENSE_GLOB],
     {
       __proto__: null,
       absolute: true,
@@ -152,7 +153,7 @@ export function globStreamLicenses(
   )
 }
 
-const matcherCache = new Map()
+const matcherCache = new Map<string, (path: string) => boolean>()
 /**
  * Get a cached glob matcher function.
  */
@@ -163,7 +164,7 @@ export function getGlobMatcher(
 ): (path: string) => boolean {
   const patterns = Array.isArray(glob) ? glob : [glob]
   const key = JSON.stringify({ patterns, options })
-  let matcher = matcherCache.get(key)
+  let matcher: ((path: string) => boolean) | undefined = matcherCache.get(key)
   if (matcher) {
     return matcher
   }
@@ -187,7 +188,7 @@ export function getGlobMatcher(
   matcher = picomatch(
     positivePatterns.length > 0 ? positivePatterns : patterns,
     matchOptions,
-  )
+  ) as (path: string) => boolean
 
   matcherCache.set(key, matcher)
   return matcher

src/signal-exit.ts

@@ -36,7 +36,7 @@
 const ReflectApply = Reflect.apply
 const globalProcess = globalThis.process as
   | (NodeJS.Process & {
-      __signal_exit_emitter__?: any
+      __signal_exit_emitter__?: import('node:events').EventEmitter
       reallyExit?: (code?: number | undefined) => never
     })
   | undefined

src/sorts.ts

@@ -56,12 +56,13 @@ export function naturalSorter<T>(
   arrayToSort: T[],
 ): ReturnType<FastSortFunction> {
   if (_naturalSorter === undefined) {
-    const fastSort = /*@__PURE__*/ require('./external/fast-sort')
-    _naturalSorter = (fastSort as any).createNewSortInstance({
+    const fastSort =
+      /*@__PURE__*/ require('./external/fast-sort') as typeof import('fast-sort')
+    _naturalSorter = fastSort.createNewSortInstance({
       comparer: naturalCompare,
-    })
+    }) as FastSortFunction
   }
-  return _naturalSorter?.(arrayToSort)
+  return (_naturalSorter as FastSortFunction)(arrayToSort)
 }
 
 /**
@@ -77,9 +78,10 @@ export function compareStr(a: string, b: string): number {
  */
 /*@__NO_SIDE_EFFECTS__*/
 export function compareSemver(a: string, b: string): number {
-  const semver = /*@__PURE__*/ require('./external/semver')
-  const validA = semver.valid(a)
-  const validB = semver.valid(b)
+  const semver =
+    /*@__PURE__*/ require('./external/semver') as typeof import('semver')
+  const validA: string | null = semver.valid(a)
+  const validB: string | null = semver.valid(b)
 
   if (!validA && !validB) {
     return 0
@@ -90,5 +92,5 @@ export function compareSemver(a: string, b: string): number {
   if (!validB) {
     return 1
   }
-  return (semver as any).compare(a, b)
+  return semver.compare(a, b) as number
 }