biome correctness/noGlobalDirnameFilename

• The rewrite changes the meaning if __dirname or __filename is shadowed by a local variable in an outer function scope, as import.meta properties are not subject to variable shadowing.
• If the code is executed in a non-ESM environment (e.g., CommonJS), import.meta.dirname/filename are undefined, causing runtime errors where the original globals were defined.
• The fix removes any JSDoc or inline comments attached to the __dirname/__filename token, as the replacement does not preserve comment associations.
• In destructuring like const { __filename } = obj, the rewrite produces { import.meta.filename } which is invalid syntax because import.meta is not an object literal property in that context.
• When __dirname/__filename is used in a dynamic import() argument, the rewrite may alter timing or availability if import.meta is not yet resolved.
• If the code relies on __dirname/__filename being a string primitive (which they are), but import.meta.dirname/filename are also strings, this is safe—but if used in a typeof check against a fake global, behavior diverges.
• In a with (__dirname) { ... } block (though rare and deprecated), the rewrite breaks because import.meta cannot be used in a with statement due to being a member expression.
• If __dirname or __filename is used as a property name in computed form like [__dirname]: value, the rewrite becomes [import.meta.dirname]: value which evaluates the string, but the original used the global variable's value—however, since both are strings and same value, this may be safe, but if the global was reassigned (which it isn't), it would differ—yet reassignment of __dirname is not allowed, so likely safe, but we include due to theoretical reassignment in non-strict? Actually, __dirname/__filename are not writable in Node.js, so reassignment fails silently in strict or throws—so if somehow reassigned, original would reflect new value, but import.meta is fixed—so hazard: if reassigned (though impossible in practice), behavior changes.
• The fix does not preserve trailing comments on the line if the replacement alters whitespace in a way that moves or drops line comments (e.g., if __dirname; // comment becomes import.meta.dirname; // comment—usually preserved, but if the tool reformats, it might not).
• In eval() contexts, __dirname/__filename refer to the global scope of the calling script, but import.meta is fixed to the current module—so if eval runs in a different module context, behavior differs.

--- orig.js	2026-10-17 16:16:38.781057717 -0400
+++ fixed.js	2026-10-17 16:16:39.079054053 -0400
@@ -1,3 +1,3 @@
 // Hazard 1
-const mod = await import(`./${__dirname}/data.json`);
+const mod = await import(`./${import.meta.dirname}/data.json`);
 console.log('done');

--- orig.js	2026-10-17 16:16:39.258051857 -0400
+++ fixed.js	2026-10-17 16:16:39.542048373 -0400
@@ -1,4 +1,4 @@
 // Hazard 2
 const o = {};
-o[`__proto__${__dirname}`] = 'tampered';
+o[`__proto__${import.meta.dirname}`] = 'tampered';
 console.log(Object.getPrototypeOf(o));

--- orig.js	2026-10-17 16:16:39.716046238 -0400
+++ fixed.js	2026-10-17 16:16:40.007042667 -0400
@@ -1,5 +1,5 @@
 // Hazard 3
-function f(dir = __dirname) {
+function f(dir = import.meta.dirname) {
   return dir.length;
 }
 console.log(f());

--- orig.js	2026-10-17 16:16:40.179040562 -0400
+++ fixed.js	2026-10-17 16:16:40.463037086 -0400
@@ -1,6 +1,6 @@
 // Hazard 4
 async function main() {
-  const dir = await Promise.resolve(__dirname);
+  const dir = await Promise.resolve(import.meta.dirname);
   console.log(dir.length);
 }
 main();

--- orig.js	2026-10-17 16:16:40.640034920 -0400
+++ fixed.js	2026-10-17 16:16:40.941031237 -0400
@@ -1,4 +1,4 @@
 // Hazard 5
 const maybePath = null;
-const result = maybePath?.startsWith(__dirname) ?? 'fallback';
+const result = maybePath?.startsWith(import.meta.dirname) ?? 'fallback';
 console.log(result);

fallback

--- orig.js	2026-10-17 16:16:41.117029086 -0400
+++ fixed.js	2026-10-17 16:16:41.383025839 -0400
@@ -1,3 +1,3 @@
 // Hazard 6
-__dirname; // this comment must stay
+import.meta.dirname; // this comment must stay
 console.log('ok');

--- orig.js	2026-10-17 16:16:41.596023239 -0400
+++ fixed.js	2026-10-17 16:16:41.866019943 -0400
@@ -1,3 +1,3 @@
 // Hazard 8
-const x = __filename /* inline note */;
+const x = import.meta.filename /* inline note */;
 console.log(x.length);

--- orig.js	2026-10-17 16:16:49.078932784 -0400
+++ fixed.js	2026-10-17 16:16:49.341929639 -0400
@@ -1,4 +1,4 @@
-const dir = __dirname;
+const dir = import.meta.dirname;
 console.log('original:', typeof dir === 'string' ? dir : 'not string');
 try {
   const fixed = import.meta.dirname;

--- orig.js	2026-10-17 16:16:49.500927738 -0400
+++ fixed.js	2026-10-17 16:16:49.762924605 -0400
@@ -1,6 +1,6 @@
 let threw = false;
 try {
-  const d = __dirname;
+  const d = import.meta.dirname;
   if (d === undefined) throw new Error('unexpected');
 } catch (e) {
   threw = true;

threw: true

--- orig.js	2026-10-17 16:16:49.925922655 -0400
+++ fixed.js	2026-10-17 16:16:50.190919492 -0400
@@ -1,5 +1,5 @@
 let dirname = 'outer';
-const dir = __dirname;
+const dir = import.meta.dirname;
 console.log('dirname:', dirname);
 if (typeof dirname === 'string') {
   console.log('block dirname:', dirname);

--- orig.js	2026-10-17 16:16:50.358917488 -0400
+++ fixed.js	2026-10-17 16:16:50.624914315 -0400
@@ -1,6 +1,6 @@
 let result = [];
 try {
-  result.push(__dirname);
+  result.push(import.meta.dirname);
   throw new Error('test');
 } catch (e) {
   result.push(e.message);

__dirname is not defined|<wd>/prog

--- orig.js	2026-10-17 16:16:50.791912323 -0400
+++ fixed.js	2026-10-17 16:16:51.070908997 -0400
@@ -1,5 +1,5 @@
 class C {
-  static dir = __dirname;
+  static dir = import.meta.dirname;
   static log() {
     return C.dir;
   }

--- orig.js	2026-10-17 16:16:51.470904238 -0400
+++ fixed.js	2026-10-17 16:16:51.755900847 -0400
@@ -1,4 +1,4 @@
 __dirname = 'overridden'; // assignment fails in strict, but assume non-strict
 const obj = {};
-obj[__dirname] = 'value';
+obj[import.meta.dirname] = 'value';
 console.log(obj['overridden'] ?? 'not set');

--- orig.js	2026-10-17 16:16:51.912898979 -0400
+++ fixed.js	2026-10-17 16:16:52.176895844 -0400
@@ -1,4 +1,4 @@
 const x = { toString: () => 42 };
-console.log('+ coercion:', __dirname + x);
-console.log('template:', `${__dirname}${x}`);
+console.log('+ coercion:', import.meta.dirname + x);
+console.log('template:', `${import.meta.dirname}${x}`);
 console.log('import.meta + x:', import.meta.dirname + x);