docs: fix import paths in JSDoc examples

Correct package name from @socketsecurity/registry to @socketsecurity/lib
in all @example blocks across utility modules.

Author: jdalton

src/memoization.ts

@@ -41,7 +41,7 @@ type CacheEntry<T> = {
  * @returns Memoized version of the function
  *
  * @example
- * import { memoize } from '@socketsecurity/registry/lib/memoization'
+ * import { memoize } from '@socketsecurity/lib/memoization'
  *
  * const expensiveOperation = memoize((n: number) => {
  *   // Heavy computation
@@ -130,7 +130,7 @@ export function memoize<Args extends unknown[], Result>(
  * @returns Memoized version of the async function
  *
  * @example
- * import { memoizeAsync } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeAsync } from '@socketsecurity/lib/memoization'
  *
  * const fetchUser = memoizeAsync(async (id: string) => {
  *   const response = await fetch(`/api/users/${id}`)
@@ -233,7 +233,7 @@ export function memoizeAsync<Args extends unknown[], Result>(
  * @returns Modified descriptor with memoized method
  *
  * @example
- * import { Memoize } from '@socketsecurity/registry/lib/memoization'
+ * import { Memoize } from '@socketsecurity/lib/memoization'
  *
  * class Calculator {
  *   @Memoize()
@@ -279,7 +279,7 @@ export function clearAllMemoizationCaches(): void {
  * @returns Memoized version using WeakMap
  *
  * @example
- * import { memoizeWeak } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeWeak } from '@socketsecurity/lib/memoization'
  *
  * const processConfig = memoizeWeak((config: Config) => {
  *   return expensiveTransform(config)
@@ -316,7 +316,7 @@ export function memoizeWeak<K extends object, Result>(
  * @returns Memoized version that only executes once
  *
  * @example
- * import { once } from '@socketsecurity/registry/lib/memoization'
+ * import { once } from '@socketsecurity/lib/memoization'
  *
  * const initialize = once(() => {
  *   console.log('Initializing…')
@@ -352,7 +352,7 @@ export function once<Result>(fn: () => Result): () => Result {
  * @returns Debounced memoized function
  *
  * @example
- * import { memoizeDebounced } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeDebounced } from '@socketsecurity/lib/memoization'
  *
  * const search = memoizeDebounced(
  *   (query: string) => performSearch(query),

src/performance.ts

@@ -36,7 +36,7 @@ function isPerfEnabled(): boolean {
  * @returns Stop function that completes the timing
  *
  * @example
- * import { perfTimer } from '@socketsecurity/registry/lib/performance'
+ * import { perfTimer } from '@socketsecurity/lib/performance'
  *
  * const stop = perfTimer('api-call')
  * await fetchData()
@@ -78,7 +78,7 @@ export function perfTimer(
  * @returns Result of the function and duration
  *
  * @example
- * import { measure } from '@socketsecurity/registry/lib/performance'
+ * import { measure } from '@socketsecurity/lib/performance'
  *
  * const { result, duration } = await measure('fetch-packages', async () => {
  *   return await fetchPackages()
@@ -116,7 +116,7 @@ export async function measure<T>(
  * @returns Result of the function and duration
  *
  * @example
- * import { measureSync } from '@socketsecurity/registry/lib/performance'
+ * import { measureSync } from '@socketsecurity/lib/performance'
  *
  * const { result, duration } = measureSync('parse-json', () => {
  *   return JSON.parse(data)
@@ -151,7 +151,7 @@ export function measureSync<T>(
  * @returns Array of performance metrics
  *
  * @example
- * import { getPerformanceMetrics } from '@socketsecurity/registry/lib/performance'
+ * import { getPerformanceMetrics } from '@socketsecurity/lib/performance'
  *
  * const metrics = getPerformanceMetrics()
  * console.log(metrics)
@@ -164,7 +164,7 @@ export function getPerformanceMetrics(): PerformanceMetrics[] {
  * Clear all collected performance metrics.
  *
  * @example
- * import { clearPerformanceMetrics } from '@socketsecurity/registry/lib/performance'
+ * import { clearPerformanceMetrics } from '@socketsecurity/lib/performance'
  *
  * clearPerformanceMetrics()
  */
@@ -179,7 +179,7 @@ export function clearPerformanceMetrics(): void {
  * @returns Summary of metrics grouped by operation
  *
  * @example
- * import { getPerformanceSummary } from '@socketsecurity/registry/lib/performance'
+ * import { getPerformanceSummary } from '@socketsecurity/lib/performance'
  *
  * const summary = getPerformanceSummary()
  * console.log(summary)
@@ -251,7 +251,7 @@ export function getPerformanceSummary(): Record<
  * Only prints when DEBUG=perf is enabled.
  *
  * @example
- * import { printPerformanceSummary } from '@socketsecurity/registry/lib/performance'
+ * import { printPerformanceSummary } from '@socketsecurity/lib/performance'
  *
  * printPerformanceSummary()
  * // Performance Summary:
@@ -292,7 +292,7 @@ export function printPerformanceSummary(): void {
  * @param metadata - Optional metadata
  *
  * @example
- * import { perfCheckpoint } from '@socketsecurity/registry/lib/performance'
+ * import { perfCheckpoint } from '@socketsecurity/lib/performance'
  *
  * perfCheckpoint('start-scan')
  * // ... do work ...
@@ -328,7 +328,7 @@ export function perfCheckpoint(
  * @returns Memory usage in MB
  *
  * @example
- * import { trackMemory } from '@socketsecurity/registry/lib/performance'
+ * import { trackMemory } from '@socketsecurity/lib/performance'
  *
  * const memBefore = trackMemory('before-operation')
  * await heavyOperation()
@@ -368,7 +368,7 @@ export function trackMemory(label: string): number {
  * @returns Formatted performance report
  *
  * @example
- * import { generatePerformanceReport } from '@socketsecurity/registry/lib/performance'
+ * import { generatePerformanceReport } from '@socketsecurity/lib/performance'
  *
  * console.log(generatePerformanceReport())
  * // ╔═══════════════════════════════════════════════╗

src/spinner.ts

@@ -142,7 +142,7 @@ export type ShimmerInfo = ShimmerState & {
  *
  * @example
  * ```ts
- * import { Spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner({ text: 'Loading…' })
  * spinner.start()
@@ -433,7 +433,7 @@ let _defaultSpinner: SpinnerStyle | undefined
  *
  * @example
  * ```ts
- * import { Spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner } from '@socketsecurity/lib/spinner'
  *
  * // Basic usage
  * const spinner = Spinner({ text: 'Loading data…' })
@@ -1307,7 +1307,7 @@ let _spinner: ReturnType<typeof Spinner> | undefined
  *
  * @example
  * ```ts
- * import { getDefaultSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = getDefaultSpinner()
  * spinner.start('Loading…')
@@ -1328,11 +1328,11 @@ export function getDefaultSpinner(): ReturnType<typeof Spinner> {
  * @example
  * ```ts
  * // Old (deprecated):
- * import { spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { spinner } from '@socketsecurity/lib/spinner'
  * spinner.start('Loading…')
  *
  * // New (recommended):
- * import { getDefaultSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner } from '@socketsecurity/lib/spinner'
  * const spinner = getDefaultSpinner()
  * spinner.start('Loading…')
  * ```
@@ -1382,7 +1382,7 @@ export type WithSpinnerOptions<T> = {
  *
  * @example
  * ```ts
- * import { Spinner, withSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner, withSpinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner()
  *
@@ -1452,7 +1452,7 @@ export type WithSpinnerRestoreOptions<T> = {
  *
  * @example
  * ```ts
- * import { getDefaultSpinner, withSpinnerRestore } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner, withSpinnerRestore } from '@socketsecurity/lib/spinner'
  *
  * const spinner = getDefaultSpinner()
  * const wasSpinning = spinner.isSpinning
@@ -1517,7 +1517,7 @@ export type WithSpinnerSyncOptions<T> = {
  *
  * @example
  * ```ts
- * import { Spinner, withSpinnerSync } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner, withSpinnerSync } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner()
  *

src/suppress-warnings.ts

@@ -48,7 +48,7 @@ function setupSuppression(): void {
  * This is useful in tests or scripts where multiple listeners are expected.
  *
  * @example
- * import { suppressMaxListenersWarning } from '@socketsecurity/registry/lib/suppress-warnings'
+ * import { suppressMaxListenersWarning } from '@socketsecurity/lib/suppress-warnings'
  *
  * suppressMaxListenersWarning()
  */
@@ -63,7 +63,7 @@ export function suppressMaxListenersWarning(): void {
  * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')
  *
  * @example
- * import { suppressWarningType } from '@socketsecurity/registry/lib/suppress-warnings'
+ * import { suppressWarningType } from '@socketsecurity/lib/suppress-warnings'
  *
  * suppressWarningType('ExperimentalWarning')
  */
@@ -90,7 +90,7 @@ export function suppressWarningType(warningType: string): void {
  * @param maxListeners - Maximum number of listeners (defaults to 10, the Node.js default)
  *
  * @example
- * import { setMaxEventTargetListeners } from '@socketsecurity/registry/lib/suppress-warnings'
+ * import { setMaxEventTargetListeners } from '@socketsecurity/lib/suppress-warnings'
  *
  * const controller = new AbortController()
  * setMaxEventTargetListeners(controller.signal)
@@ -133,7 +133,7 @@ export function restoreWarnings(): void {
  * @returns The result of the callback
  *
  * @example
- * import { withSuppressedWarnings } from '@socketsecurity/registry/lib/suppress-warnings'
+ * import { withSuppressedWarnings } from '@socketsecurity/lib/suppress-warnings'
  *
  * const result = await withSuppressedWarnings('ExperimentalWarning', async () => {
  *   // Code that triggers experimental warnings

src/tables.ts

@@ -59,7 +59,7 @@ function padText(
  * @returns Formatted table string
  *
  * @example
- * import { formatTable } from '@socketsecurity/registry/lib/tables'
+ * import { formatTable } from '@socketsecurity/lib/tables'
  * import colors from 'yoctocolors-cjs'
  *
  * const data = [
@@ -146,7 +146,7 @@ export function formatTable(
  * @returns Formatted table string
  *
  * @example
- * import { formatSimpleTable } from '@socketsecurity/registry/lib/tables'
+ * import { formatSimpleTable } from '@socketsecurity/lib/tables'
  * import colors from 'yoctocolors-cjs'
  *
  * const data = [