fix(node): prefer Module#registerHooks instead of Module#register

Author: WarningImHack3r

packages/@tailwindcss-node/package.json

@@ -29,10 +29,6 @@
       "./require-cache": {
         "types": "./dist/require-cache.d.ts",
         "default": "./dist/require-cache.js"
-      },
-      "./esm-cache-loader": {
-        "types": "./dist/esm-cache.loader.d.mts",
-        "default": "./dist/esm-cache.loader.mjs"
       }
     }
   },
@@ -46,10 +42,6 @@
       "types": "./src/require-cache.ts",
       "import": "./src/require-cache.ts",
       "require": "./src/require-cache.cts"
-    },
-    "./esm-cache-loader": {
-      "types": "./src/esm-cache.loader.mts",
-      "default": "./src/esm-cache.loader.mts"
     }
   },
   "dependencies": {

packages/@tailwindcss-node/src/esm-cache.loader.mts

@@ -1,22 +1,36 @@
-import { isBuiltin, type ResolveHook } from 'node:module'
+import {
+  isBuiltin,
+  type ResolveFnOutput,
+  type ResolveHook,
+  type ResolveHookContext,
+  type ResolveHookSync,
+} from 'node:module'
 
 export let resolve: ResolveHook = async (specifier, context, nextResolve) => {
   let result = await nextResolve(specifier, context)
+  return processResolve(context, result)
+}
+
+export let resolveSync: ResolveHookSync = (specifier, context, nextResolve) => {
+  let result = nextResolve(specifier, context)
+  return processResolve(context, result)
+}
 
-  if (result.url === import.meta.url) return result
-  if (isBuiltin(result.url)) return result
-  if (!context.parentURL) return result
+function processResolve(context: ResolveHookContext, resolve: ResolveFnOutput) {
+  if (resolve.url === import.meta.url) return resolve
+  if (isBuiltin(resolve.url)) return resolve
+  if (!context.parentURL) return resolve
 
   let parent = new URL(context.parentURL)
 
   let id = parent.searchParams.get('id')
-  if (id === null) return result
+  if (id === null) return resolve
 
-  let url = new URL(result.url)
+  let url = new URL(resolve.url)
   url.searchParams.set('id', id)
 
   return {
-    ...result,
+    ...resolve,
     url: `${url}`,
   }
 }

packages/@tailwindcss-node/src/index.cts

@@ -1,6 +1,7 @@
 import * as Module from 'node:module'
 import { pathToFileURL } from 'node:url'
 import * as env from './env'
+import { resolveSync } from './esm-cache.loader.mjs'
 export * from './compile'
 export * from './instrumentation'
 export * from './normalize-path'
@@ -12,8 +13,14 @@ export { env }
 // not necessary.
 if (!process.versions.bun) {
   // `Module#register` was added in Node v18.19.0 and v20.6.0
+  // `Module#registerHooks` was added in Node v22.15.0 and v23.5.0 and is the preferred API since v25.9.0,
+  // runtime-deprecating `Module#register` since v26
   //
   // Not calling it means that while ESM dependencies don't get reloaded, the
   // actual included files will because they cache bust directly via `?id=…`
-  Module.register?.(pathToFileURL(require.resolve('@tailwindcss/node/esm-cache-loader')))
+  if (Module.registerHooks) {
+    Module.registerHooks({ resolve: resolveSync })
+  } else {
+    Module.register?.('./esm-cache.loader.mjs', pathToFileURL(__filename))
+  }
 }

packages/@tailwindcss-node/src/index.ts

@@ -1,6 +1,6 @@
 import * as Module from 'node:module'
-import { pathToFileURL } from 'node:url'
 import * as env from './env'
+import { resolveSync } from './esm-cache.loader.mjs'
 export * from './compile'
 export * from './instrumentation'
 export * from './normalize-path'
@@ -11,11 +11,15 @@ export { env }
 // In Bun, ESM modules will also populate `require.cache`, so the module hook is
 // not necessary.
 if (!process.versions.bun) {
-  let localRequire = Module.createRequire(import.meta.url)
-
   // `Module#register` was added in Node v18.19.0 and v20.6.0
+  // `Module#registerHooks` was added in Node v22.15.0 and v23.5.0 and is the preferred API since v25.9.0,
+  // runtime-deprecating `Module#register` since v26
   //
   // Not calling it means that while ESM dependencies don't get reloaded, the
   // actual included files will because they cache bust directly via `?id=…`
-  Module.register?.(pathToFileURL(localRequire.resolve('@tailwindcss/node/esm-cache-loader')))
+  if (Module.registerHooks) {
+    Module.registerHooks({ resolve: resolveSync })
+  } else {
+    Module.register?.('./esm-cache.loader.mjs', import.meta.url)
+  }
 }