ref: Reorganise lib code

- Move shared code into src/lib, leaving only features at the top level
- Move the throttle queue into a class to help with testing &
  multi-storage support later
- Add stubs for debounce queue

Author: franky47

packages/nuqs/src/adapters/custom.ts

@@ -1,4 +1,4 @@
-export { renderQueryString } from '../url-encoding'
+export { renderQueryString } from '../lib/url-encoding'
 export {
   createAdapterProvider as unstable_createAdapterProvider,
   type AdapterContext as unstable_AdapterContext

packages/nuqs/src/adapters/lib/context.ts

@@ -1,5 +1,5 @@
 import { createContext, createElement, useContext, type ReactNode } from 'react'
-import { error } from '../../errors'
+import { error } from '../../lib/errors'
 import type { UseAdapterHook } from './defs'
 
 export type AdapterContext = {

packages/nuqs/src/adapters/lib/patch-history.ts

@@ -1,6 +1,6 @@
 import type { Emitter } from 'mitt'
-import { debug } from '../../debug'
-import { error } from '../../errors'
+import { debug } from '../../lib/debug'
+import { error } from '../../lib/errors'
 
 export type SearchParamsSyncEmitter = Emitter<{ update: URLSearchParams }>
 

packages/nuqs/src/adapters/lib/react-router.ts

@@ -1,6 +1,6 @@
 import mitt from 'mitt'
 import { startTransition, useCallback, useEffect, useState } from 'react'
-import { renderQueryString } from '../../url-encoding'
+import { renderQueryString } from '../../lib/url-encoding'
 import { createAdapterProvider } from './context'
 import type { AdapterInterface, AdapterOptions } from './defs'
 import {

packages/nuqs/src/adapters/next/impl.app.ts

@@ -1,6 +1,6 @@
 import { useRouter, useSearchParams } from 'next/navigation'
 import { startTransition, useCallback, useOptimistic } from 'react'
-import { debug } from '../../debug'
+import { debug } from '../../lib/debug'
 import type { AdapterInterface, UpdateUrlFunction } from '../lib/defs'
 import { renderURL } from './shared'
 

packages/nuqs/src/adapters/next/impl.pages.ts

@@ -1,7 +1,7 @@
 import { useSearchParams } from 'next/navigation.js'
 import type { NextRouter } from 'next/router'
 import { useCallback } from 'react'
-import { debug } from '../../debug'
+import { debug } from '../../lib/debug'
 import { createAdapterProvider } from '../lib/context'
 import type { AdapterInterface, UpdateUrlFunction } from '../lib/defs'
 import { renderURL } from './shared'

packages/nuqs/src/adapters/next/shared.ts

@@ -1,4 +1,4 @@
-import { renderQueryString } from '../../url-encoding'
+import { renderQueryString } from '../../lib/url-encoding'
 
 export function renderURL(base: string, search: URLSearchParams) {
   const hashlessBase = base.split('#')[0] ?? ''

packages/nuqs/src/adapters/react.ts

@@ -1,8 +1,8 @@
 import mitt from 'mitt'
 import { useEffect, useState } from 'react'
-import { renderQueryString } from '../url-encoding'
+import { renderQueryString } from '../lib/url-encoding'
 import { createAdapterProvider } from './lib/context'
-import type { AdapterOptions } from './lib/defs'
+import type { AdapterInterface, AdapterOptions } from './lib/defs'
 import { patchHistory, type SearchParamsSyncEmitter } from './lib/patch-history'
 
 const emitter: SearchParamsSyncEmitter = mitt()
@@ -16,7 +16,7 @@ function updateUrl(search: URLSearchParams, options: AdapterOptions) {
   emitter.emit('update', search)
 }
 
-function useNuqsReactAdapter() {
+function useNuqsReactAdapter(): AdapterInterface {
   const [searchParams, setSearchParams] = useState(() => {
     if (typeof location === 'undefined') {
       return new URLSearchParams()

packages/nuqs/src/adapters/testing.ts

@@ -1,6 +1,6 @@
 import { createElement, type ReactNode } from 'react'
-import { resetQueue } from '../update-queue'
-import { renderQueryString } from '../url-encoding'
+import { globalThrottleQueue } from '../lib/queues/throttle'
+import { renderQueryString } from '../lib/url-encoding'
 import { context } from './lib/context'
 import type { AdapterInterface, AdapterOptions } from './lib/defs'
 
@@ -25,7 +25,7 @@ export function NuqsTestingAdapter({
   ...props
 }: TestingAdapterProps) {
   if (resetUrlUpdateQueueOnMount) {
-    resetQueue()
+    globalThrottleQueue.reset()
   }
   const useAdapter = (): AdapterInterface => ({
     searchParams: new URLSearchParams(props.searchParams),

packages/nuqs/src/cache.ts

@@ -1,7 +1,7 @@
 // @ts-ignore
 import { cache } from 'react'
 import type { SearchParams, UrlKeys } from './defs'
-import { error } from './errors'
+import { error } from './lib/errors'
 import { createLoader } from './loader'
 import type { inferParserType, ParserMap } from './parsers'