feat: add lazy dependency loaders and test utilities

Author: jdalton

registry/src/lib/dependencies/build-tools.ts

@@ -0,0 +1,82 @@
+/** @fileoverview Build and utility tool dependency registry. */
+
+export interface FastSort {
+  createNewSortInstance(options: {
+    comparer: (a: string, b: string) => number
+  }): <T>(arr: T[]) => {
+    asc(prop?: ((item: T) => unknown) | keyof T): T[]
+    by(sorts: Array<{ asc?: string; desc?: string }>): T[]
+    desc(prop?: ((item: T) => unknown) | keyof T): T[]
+  }
+  sort<T>(arr: T[]): {
+    asc(prop?: ((item: T) => unknown) | keyof T): T[]
+    by(sorts: Array<{ asc?: string; desc?: string }>): T[]
+    desc(prop?: ((item: T) => unknown) | keyof T): T[]
+  }
+}
+
+export interface Semver {
+  clean(version: string): string | null
+  coerce(version: string): { version: string } | null
+  compare(v1: string, v2: string): number
+  gte(v1: string, v2: string): boolean
+  intersects(r1: string, r2: string): boolean
+  lte(v1: string, v2: string): boolean
+  maxSatisfying(versions: string[], range: string): string | null
+  minVersion(range: string): { version: string } | null
+  parse(version: string): unknown
+  satisfies(version: string, range: string): boolean
+  valid(version: string): string | null
+}
+
+interface BuildToolsDependencies {
+  fastSort: FastSort | undefined
+  semver: Semver | undefined
+}
+
+const dependencies: BuildToolsDependencies = {
+  fastSort: undefined,
+  semver: undefined,
+}
+
+/**
+ * Get fast-sort instance, lazily loading if not set.
+ */
+export function getFastSort(): FastSort {
+  if (!dependencies.fastSort) {
+    dependencies.fastSort = require('../../external/fast-sort')
+  }
+  return dependencies.fastSort!
+}
+
+/**
+ * Get semver instance, lazily loading if not set.
+ */
+export function getSemver(): Semver {
+  if (!dependencies.semver) {
+    dependencies.semver = require('../../external/semver')
+  }
+  return dependencies.semver!
+}
+
+/**
+ * Set fast-sort instance (useful for testing).
+ */
+export function setFastSort(fastSort: FastSort): void {
+  dependencies.fastSort = fastSort
+}
+
+/**
+ * Set semver instance (useful for testing).
+ */
+export function setSemver(semver: Semver): void {
+  dependencies.semver = semver
+}
+
+/**
+ * Reset all build tool dependencies to undefined (forces reload on next access).
+ */
+export function resetBuildToolsDependencies(): void {
+  dependencies.fastSort = undefined
+  dependencies.semver = undefined
+}

registry/src/lib/dependencies/file-system.ts

@@ -0,0 +1,108 @@
+/** @fileoverview File system dependency registry. */
+
+export type Cacache = typeof import('cacache')
+
+export type FastGlob = typeof import('fast-glob')
+
+export type Picomatch = typeof import('picomatch')
+
+export type Del = {
+  deleteAsync: (
+    patterns: string | string[],
+    options?: unknown,
+  ) => Promise<string[]>
+  deleteSync: (patterns: string | string[], options?: unknown) => string[]
+}
+
+interface FileSystemDependencies {
+  cacache: Cacache | undefined
+  del: Del | undefined
+  fastGlob: FastGlob | undefined
+  picomatch: Picomatch | undefined
+}
+
+const dependencies: FileSystemDependencies = {
+  cacache: undefined,
+  del: undefined,
+  fastGlob: undefined,
+  picomatch: undefined,
+}
+
+/**
+ * Get cacache instance, lazily loading if not set.
+ */
+export function getCacache(): Cacache {
+  if (!dependencies.cacache) {
+    dependencies.cacache = require('../../external/cacache')
+  }
+  return dependencies.cacache!
+}
+
+/**
+ * Get del instance, lazily loading if not set.
+ */
+export function getDel(): Del {
+  if (!dependencies.del) {
+    dependencies.del = require('../../external/del')
+  }
+  return dependencies.del!
+}
+
+/**
+ * Get fast-glob instance, lazily loading if not set.
+ */
+export function getFastGlob(): FastGlob {
+  if (!dependencies.fastGlob) {
+    const globExport = require('../../external/fast-glob')
+    dependencies.fastGlob = globExport.default || globExport
+  }
+  return dependencies.fastGlob!
+}
+
+/**
+ * Get picomatch instance, lazily loading if not set.
+ */
+export function getPicomatch(): Picomatch {
+  if (!dependencies.picomatch) {
+    dependencies.picomatch = require('../../external/picomatch')
+  }
+  return dependencies.picomatch!
+}
+
+/**
+ * Set cacache instance (useful for testing or custom implementations).
+ */
+export function setCacache(cacache: Cacache): void {
+  dependencies.cacache = cacache
+}
+
+/**
+ * Set del instance (useful for testing).
+ */
+export function setDel(del: Del): void {
+  dependencies.del = del
+}
+
+/**
+ * Set fast-glob instance (useful for testing).
+ */
+export function setFastGlob(fastGlob: FastGlob): void {
+  dependencies.fastGlob = fastGlob
+}
+
+/**
+ * Set picomatch instance (useful for testing).
+ */
+export function setPicomatch(picomatch: Picomatch): void {
+  dependencies.picomatch = picomatch
+}
+
+/**
+ * Reset all file system dependencies to undefined (forces reload on next access).
+ */
+export function resetFileSystemDependencies(): void {
+  dependencies.cacache = undefined
+  dependencies.del = undefined
+  dependencies.fastGlob = undefined
+  dependencies.picomatch = undefined
+}

registry/src/lib/dependencies/index.ts

@@ -0,0 +1,32 @@
+/** @fileoverview Central dependency registry for all external dependencies. */
+
+import { resetBuildToolsDependencies } from './build-tools'
+import { resetFileSystemDependencies } from './file-system'
+import { resetLoggingDependencies } from './logging'
+import { resetNpmToolsDependencies } from './npm-tools'
+import { resetPromptsDependencies } from './prompts'
+import { resetSystemDependencies } from './system'
+import { resetValidationDependencies } from './validation'
+
+// Re-export all types and functions from sub-modules
+export * from './build-tools'
+export * from './file-system'
+export * from './logging'
+export * from './npm-tools'
+export * from './prompts'
+export * from './system'
+export * from './validation'
+
+/**
+ * Reset all dependencies to undefined (forces reload on next access).
+ * Useful for testing to ensure clean state between tests.
+ */
+export function resetDependencies(): void {
+  resetBuildToolsDependencies()
+  resetFileSystemDependencies()
+  resetLoggingDependencies()
+  resetNpmToolsDependencies()
+  resetPromptsDependencies()
+  resetSystemDependencies()
+  resetValidationDependencies()
+}