@knighted/module 1.0.0-rc.3 → 1.0.0-rc.5

package/README.md

@@ -151,6 +151,36 @@ See [docs/esm-to-cjs.md](docs/esm-to-cjs.md) for deeper notes on live bindings,
 > [!NOTE]
 > Known limitations: `with` and unshadowed `eval` are rejected when raising CJS to ESM because the rewrite would be unsound; bare specifiers are not rewritten—only relative specifiers participate in `rewriteSpecifier`.
 
+### Diagnostics callback example
+
+Pass a `diagnostics` callback to surface CJS→ESM edge cases (mixed `module.exports`/`exports`, top-level `return`, legacy `require.cache`/`require.extensions`, live-binding reassignments, string-literal export names):
+
+```ts
+import { transform } from '@knighted/module'
+
+const diagnostics: any[] = []
+
+await transform('./file.cjs', {
+  target: 'module',
+  diagnostics: diag => diagnostics.push(diag),
+})
+
+console.log(diagnostics)
+// [
+//   {
+//     level: 'warning',
+//     code: 'cjs-mixed-exports',
+//     message: 'Both module.exports and exports are assigned in this module; CommonJS shadowing may not match synthesized ESM exports.',
+//     filePath: './file.cjs',
+//     loc: { start: 12, end: 48 }
+//   },
+//   ...
+// ]
+```
+
+> [!WARNING]
+> When raising CommonJS to ESM, synthesized named exports rely on literal keys and `const` literal aliases (e.g., `const key = 'foo'; exports[key] = value`). `var`/`let` bindings used as export keys are not tracked, so prefer direct property names or `const` literals when exporting.
+
 ## Pre-`tsc` transforms for TypeScript diagnostics
 
 TypeScript reports asymmetric module-global errors (e.g., `import.meta` in CJS, `__dirname` in ESM) as tracked in [microsoft/TypeScript#58658](https://github.com/microsoft/TypeScript/issues/58658). You can mitigate this by running `@knighted/module` **before** `tsc` so the checker sees already-rewritten sources.

package/dist/cjs/format.cjs

@@ -370,6 +370,33 @@ const format = async (src, ast, opts) => {
     hasDefaultExportBeenReassigned: false,
     hasDefaultExportBeenAssigned: false
   };
+  const warned = new Set();
+  const emitDiagnostic = diag => {
+    if (opts.diagnostics) {
+      opts.diagnostics(diag);
+      return;
+    }
+    if (diag.level === 'warning') {
+      // eslint-disable-next-line no-console -- used for opt-in diagnostics
+      console.warn(diag.message);
+      return;
+    }
+
+    // eslint-disable-next-line no-console -- used for opt-in diagnostics
+    console.error(diag.message);
+  };
+  const warnOnce = (codeId, message, loc) => {
+    const key = `${codeId}:${loc?.start ?? ''}`;
+    if (warned.has(key)) return;
+    warned.add(key);
+    emitDiagnostic({
+      level: 'warning',
+      code: codeId,
+      message,
+      filePath: opts.filePath,
+      loc
+    });
+  };
   const moduleIdentifiers = await (0, _identifiers.collectModuleIdentifiers)(ast.program);
   const shadowedBindings = new Set([...moduleIdentifiers.entries()].filter(([, meta]) => meta.declare.length > 0).map(([name]) => name));
   if (opts.target === 'module' && opts.transformSyntax) {
@@ -378,6 +405,18 @@ const format = async (src, ast, opts) => {
     }
   }
   const exportTable = opts.target === 'module' ? await (0, _exports.collectCjsExports)(ast.program) : null;
+  if (opts.target === 'module' && exportTable) {
+    const hasExportsVia = [...exportTable.values()].some(entry => entry.via.has('exports'));
+    const hasModuleExportsVia = [...exportTable.values()].some(entry => entry.via.has('module.exports'));
+    if (hasExportsVia && hasModuleExportsVia) {
+      const firstExports = [...exportTable.values()].find(entry => entry.via.has('exports'))?.writes[0];
+      const firstModule = [...exportTable.values()].find(entry => entry.via.has('module.exports'))?.writes[0];
+      warnOnce('cjs-mixed-exports', 'Both module.exports and exports are assigned in this module; CommonJS shadowing may not match synthesized ESM exports.', {
+        start: firstModule?.start ?? 0,
+        end: firstExports?.end ?? 0
+      });
+    }
+  }
   const shouldCheckTopLevelAwait = opts.target === 'commonjs' && opts.transformSyntax;
   const containsTopLevelAwait = shouldCheckTopLevelAwait ? hasTopLevelAwait(ast.program) : false;
   const requireMainStrategy = opts.requireMainStrategy ?? 'import-meta-main';
@@ -412,6 +451,12 @@ const format = async (src, ast, opts) => {
   await (0, _walk.ancestorWalk)(ast.program, {
     async enter(node, ancestors) {
       const parent = ancestors[ancestors.length - 2] ?? null;
+      if (shouldRaiseEsm && node.type === 'ReturnStatement' && parent?.type === 'Program') {
+        warnOnce('top-level-return', 'Top-level return is not allowed in ESM; the transformed module will fail to parse.', {
+          start: node.start,
+          end: node.end
+        });
+      }
       if (shouldRaiseEsm && node.type === 'BinaryExpression') {
         const op = node.operator;
         const isEquality = op === '===' || op === '==' || op === '!==' || op === '!=';
@@ -525,7 +570,10 @@ const format = async (src, ast, opts) => {
           onRequireResolve: () => {
             if (shouldRaiseEsm) needsRequireResolveHelper = true;
           },
-          requireResolveName: '__requireResolve'
+          requireResolveName: '__requireResolve',
+          onDiagnostic: (codeId, message, loc) => {
+            if (shouldRaiseEsm) warnOnce(codeId, message, loc);
+          }
         });
       }
       if (shouldRaiseEsm && node.type === 'ThisExpression') {
@@ -579,21 +627,52 @@ const format = async (src, ast, opts) => {
     const isValidExportName = name => /^[$A-Z_a-z][$\w]*$/.test(name);
     const asExportName = name => isValidExportName(name) ? name : JSON.stringify(name);
     const accessProp = name => isValidExportName(name) ? `${_exports.exportsRename}.${name}` : `${_exports.exportsRename}[${JSON.stringify(name)}]`;
+    const exportValueFor = name => {
+      if (name === '__dirname') return 'import.meta.dirname';
+      if (name === '__filename') return 'import.meta.filename';
+      return name;
+    };
     const tempNameFor = name => {
       const sanitized = name.replace(/[^$\w]/g, '_') || 'value';
       const safe = /^[0-9]/.test(sanitized) ? `_${sanitized}` : sanitized;
       return `__export_${safe}`;
     };
+    for (const [key, entry] of exportTable) {
+      if (entry.reassignments.length) {
+        const loc = entry.reassignments[0];
+        warnOnce(`cjs-export-reassignment:${key}`, `Export '${key}' is reassigned after export; ESM live bindings may change consumer behavior.`, {
+          start: loc.start,
+          end: loc.end
+        });
+      }
+    }
     const lines = [];
     const defaultEntry = exportTable.get('default');
     if (defaultEntry) {
       const def = defaultEntry.fromIdentifier ?? _exports.exportsRename;
-      lines.push(`export default ${def};`);
+      const defExpr = exportValueFor(def);
+      if (defExpr !== def) {
+        const temp = tempNameFor(def);
+        lines.push(`const ${temp} = ${defExpr};`);
+        lines.push(`export default ${temp};`);
+      } else {
+        lines.push(`export default ${defExpr};`);
+      }
     }
     for (const [key, entry] of exportTable) {
       if (key === 'default') continue;
+      if (!isValidExportName(key)) {
+        warnOnce(`cjs-string-export:${key}`, `Synthesized string-literal export '${key}'. Some tooling may require bracket access to use it.`);
+      }
       if (entry.fromIdentifier) {
-        lines.push(`export { ${entry.fromIdentifier} as ${asExportName(key)} };`);
+        const resolved = exportValueFor(entry.fromIdentifier);
+        if (resolved !== entry.fromIdentifier) {
+          const temp = tempNameFor(entry.fromIdentifier);
+          lines.push(`const ${temp} = ${resolved};`);
+          lines.push(`export { ${temp} as ${asExportName(key)} };`);
+        } else {
+          lines.push(`export { ${resolved} as ${asExportName(key)} };`);
+        }
       } else {
         const temp = tempNameFor(key);
         lines.push(`const ${temp} = ${accessProp(key)};`);

package/dist/cjs/formatters/memberExpression.cjs

@@ -40,14 +40,31 @@ const memberExpression = (node, parent, src, options, shadowed, extras) => {
            * Can of worms here. ¯\_(ツ)_/¯
            * @see https://github.com/nodejs/help/issues/2806
            */
+          extras?.onDiagnostic?.('legacy-require-cache', 'Access to require.cache is not supported when raising to ESM; behavior may differ.', {
+            start,
+            end
+          });
           src.update(start, end, '{}');
           break;
+        case 'extensions':
+          extras?.onDiagnostic?.('legacy-require-extensions', 'Access to require.extensions is not supported when raising to ESM; use loaders instead.', {
+            start,
+            end
+          });
+          break;
       }
     }
     if (node.object.type === 'Identifier' && node.property.type === 'Identifier' && node.object.name === 'module' && node.property.name === 'require') {
       if (!shadowed?.has('module')) {
         src.update(node.start, node.end, 'require');
       }
+      return;
+    }
+    if (node.object.type === 'Identifier' && node.property.type === 'Identifier' && node.object.name === 'module' && (node.property.name === 'parent' || node.property.name === 'children')) {
+      extras?.onDiagnostic?.(`legacy-module-${node.property.name}`, `Access to module.${node.property.name} may not behave the same in ESM; consider loaders or explicit wiring instead.`, {
+        start: node.start,
+        end: node.end
+      });
     }
   }
 };

package/dist/cjs/memberExpression.d.cts

@@ -4,6 +4,10 @@ import type { FormatterOptions } from '../types.cjs';
 type MemberExpressionExtras = {
     onRequireResolve?: () => void;
     requireResolveName?: string;
+    onDiagnostic?: (code: string, message: string, loc?: {
+        start: number;
+        end: number;
+    }) => void;
 };
 export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions, shadowed?: Set<string>, extras?: MemberExpressionExtras) => void;
 export {};

package/dist/cjs/module.cjs

@@ -167,7 +167,8 @@ const defaultOptions = {
 const transform = async (filename, options = defaultOptions) => {
   const opts = {
     ...defaultOptions,
-    ...options
+    ...options,
+    filePath: filename
   };
   const appendMode = options?.appendJsExtension ?? (opts.target === 'module' ? 'relative-only' : 'off');
   const dirIndex = opts.appendDirectoryIndex === undefined ? 'index.js' : opts.appendDirectoryIndex;

package/dist/cjs/types.d.cts

@@ -34,11 +34,25 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
+    /** Optional diagnostics sink for warnings/errors emitted during transform. */
+    diagnostics?: (diag: Diagnostic) => void;
+    /** Optional source file path used for diagnostics context. */
+    filePath?: string;
     /** Output directory or file path when writing. */
     out?: string;
     /** Overwrite input files instead of writing to out. */
     inPlace?: boolean;
 };
+export type Diagnostic = {
+    level: 'warning' | 'error';
+    code: string;
+    message: string;
+    filePath?: string;
+    loc?: {
+        start: number;
+        end: number;
+    };
+};
 export type SpannedNode = Node & Span;
 export type ExportsMeta = {
     hasExportsBeenReassigned: boolean;

package/dist/format.js

@@ -363,6 +363,33 @@ const format = async (src, ast, opts) => {
     hasDefaultExportBeenReassigned: false,
     hasDefaultExportBeenAssigned: false
   };
+  const warned = new Set();
+  const emitDiagnostic = diag => {
+    if (opts.diagnostics) {
+      opts.diagnostics(diag);
+      return;
+    }
+    if (diag.level === 'warning') {
+      // eslint-disable-next-line no-console -- used for opt-in diagnostics
+      console.warn(diag.message);
+      return;
+    }
+
+    // eslint-disable-next-line no-console -- used for opt-in diagnostics
+    console.error(diag.message);
+  };
+  const warnOnce = (codeId, message, loc) => {
+    const key = `${codeId}:${loc?.start ?? ''}`;
+    if (warned.has(key)) return;
+    warned.add(key);
+    emitDiagnostic({
+      level: 'warning',
+      code: codeId,
+      message,
+      filePath: opts.filePath,
+      loc
+    });
+  };
   const moduleIdentifiers = await collectModuleIdentifiers(ast.program);
   const shadowedBindings = new Set([...moduleIdentifiers.entries()].filter(([, meta]) => meta.declare.length > 0).map(([name]) => name));
   if (opts.target === 'module' && opts.transformSyntax) {
@@ -371,6 +398,18 @@ const format = async (src, ast, opts) => {
     }
   }
   const exportTable = opts.target === 'module' ? await collectCjsExports(ast.program) : null;
+  if (opts.target === 'module' && exportTable) {
+    const hasExportsVia = [...exportTable.values()].some(entry => entry.via.has('exports'));
+    const hasModuleExportsVia = [...exportTable.values()].some(entry => entry.via.has('module.exports'));
+    if (hasExportsVia && hasModuleExportsVia) {
+      const firstExports = [...exportTable.values()].find(entry => entry.via.has('exports'))?.writes[0];
+      const firstModule = [...exportTable.values()].find(entry => entry.via.has('module.exports'))?.writes[0];
+      warnOnce('cjs-mixed-exports', 'Both module.exports and exports are assigned in this module; CommonJS shadowing may not match synthesized ESM exports.', {
+        start: firstModule?.start ?? 0,
+        end: firstExports?.end ?? 0
+      });
+    }
+  }
   const shouldCheckTopLevelAwait = opts.target === 'commonjs' && opts.transformSyntax;
   const containsTopLevelAwait = shouldCheckTopLevelAwait ? hasTopLevelAwait(ast.program) : false;
   const requireMainStrategy = opts.requireMainStrategy ?? 'import-meta-main';
@@ -405,6 +444,12 @@ const format = async (src, ast, opts) => {
   await ancestorWalk(ast.program, {
     async enter(node, ancestors) {
       const parent = ancestors[ancestors.length - 2] ?? null;
+      if (shouldRaiseEsm && node.type === 'ReturnStatement' && parent?.type === 'Program') {
+        warnOnce('top-level-return', 'Top-level return is not allowed in ESM; the transformed module will fail to parse.', {
+          start: node.start,
+          end: node.end
+        });
+      }
       if (shouldRaiseEsm && node.type === 'BinaryExpression') {
         const op = node.operator;
         const isEquality = op === '===' || op === '==' || op === '!==' || op === '!=';
@@ -518,7 +563,10 @@ const format = async (src, ast, opts) => {
           onRequireResolve: () => {
             if (shouldRaiseEsm) needsRequireResolveHelper = true;
           },
-          requireResolveName: '__requireResolve'
+          requireResolveName: '__requireResolve',
+          onDiagnostic: (codeId, message, loc) => {
+            if (shouldRaiseEsm) warnOnce(codeId, message, loc);
+          }
         });
       }
       if (shouldRaiseEsm && node.type === 'ThisExpression') {
@@ -572,21 +620,52 @@ const format = async (src, ast, opts) => {
     const isValidExportName = name => /^[$A-Z_a-z][$\w]*$/.test(name);
     const asExportName = name => isValidExportName(name) ? name : JSON.stringify(name);
     const accessProp = name => isValidExportName(name) ? `${exportsRename}.${name}` : `${exportsRename}[${JSON.stringify(name)}]`;
+    const exportValueFor = name => {
+      if (name === '__dirname') return 'import.meta.dirname';
+      if (name === '__filename') return 'import.meta.filename';
+      return name;
+    };
     const tempNameFor = name => {
       const sanitized = name.replace(/[^$\w]/g, '_') || 'value';
       const safe = /^[0-9]/.test(sanitized) ? `_${sanitized}` : sanitized;
       return `__export_${safe}`;
     };
+    for (const [key, entry] of exportTable) {
+      if (entry.reassignments.length) {
+        const loc = entry.reassignments[0];
+        warnOnce(`cjs-export-reassignment:${key}`, `Export '${key}' is reassigned after export; ESM live bindings may change consumer behavior.`, {
+          start: loc.start,
+          end: loc.end
+        });
+      }
+    }
     const lines = [];
     const defaultEntry = exportTable.get('default');
     if (defaultEntry) {
       const def = defaultEntry.fromIdentifier ?? exportsRename;
-      lines.push(`export default ${def};`);
+      const defExpr = exportValueFor(def);
+      if (defExpr !== def) {
+        const temp = tempNameFor(def);
+        lines.push(`const ${temp} = ${defExpr};`);
+        lines.push(`export default ${temp};`);
+      } else {
+        lines.push(`export default ${defExpr};`);
+      }
     }
     for (const [key, entry] of exportTable) {
       if (key === 'default') continue;
+      if (!isValidExportName(key)) {
+        warnOnce(`cjs-string-export:${key}`, `Synthesized string-literal export '${key}'. Some tooling may require bracket access to use it.`);
+      }
       if (entry.fromIdentifier) {
-        lines.push(`export { ${entry.fromIdentifier} as ${asExportName(key)} };`);
+        const resolved = exportValueFor(entry.fromIdentifier);
+        if (resolved !== entry.fromIdentifier) {
+          const temp = tempNameFor(entry.fromIdentifier);
+          lines.push(`const ${temp} = ${resolved};`);
+          lines.push(`export { ${temp} as ${asExportName(key)} };`);
+        } else {
+          lines.push(`export { ${resolved} as ${asExportName(key)} };`);
+        }
       } else {
         const temp = tempNameFor(key);
         lines.push(`const ${temp} = ${accessProp(key)};`);

package/dist/formatters/memberExpression.js

@@ -34,14 +34,31 @@ export const memberExpression = (node, parent, src, options, shadowed, extras) =
            * Can of worms here. ¯\_(ツ)_/¯
            * @see https://github.com/nodejs/help/issues/2806
            */
+          extras?.onDiagnostic?.('legacy-require-cache', 'Access to require.cache is not supported when raising to ESM; behavior may differ.', {
+            start,
+            end
+          });
           src.update(start, end, '{}');
           break;
+        case 'extensions':
+          extras?.onDiagnostic?.('legacy-require-extensions', 'Access to require.extensions is not supported when raising to ESM; use loaders instead.', {
+            start,
+            end
+          });
+          break;
       }
     }
     if (node.object.type === 'Identifier' && node.property.type === 'Identifier' && node.object.name === 'module' && node.property.name === 'require') {
       if (!shadowed?.has('module')) {
         src.update(node.start, node.end, 'require');
       }
+      return;
+    }
+    if (node.object.type === 'Identifier' && node.property.type === 'Identifier' && node.object.name === 'module' && (node.property.name === 'parent' || node.property.name === 'children')) {
+      extras?.onDiagnostic?.(`legacy-module-${node.property.name}`, `Access to module.${node.property.name} may not behave the same in ESM; consider loaders or explicit wiring instead.`, {
+        start: node.start,
+        end: node.end
+      });
     }
   }
 };

package/dist/memberExpression.d.cts

@@ -4,6 +4,10 @@ import type { FormatterOptions } from '../types.cjs';
 type MemberExpressionExtras = {
     onRequireResolve?: () => void;
     requireResolveName?: string;
+    onDiagnostic?: (code: string, message: string, loc?: {
+        start: number;
+        end: number;
+    }) => void;
 };
 export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions, shadowed?: Set<string>, extras?: MemberExpressionExtras) => void;
 export {};

package/dist/memberExpression.d.ts

@@ -4,6 +4,10 @@ import type { FormatterOptions } from '../types.js';
 type MemberExpressionExtras = {
     onRequireResolve?: () => void;
     requireResolveName?: string;
+    onDiagnostic?: (code: string, message: string, loc?: {
+        start: number;
+        end: number;
+    }) => void;
 };
 export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions, shadowed?: Set<string>, extras?: MemberExpressionExtras) => void;
 export {};

package/dist/module.js

@@ -164,7 +164,8 @@ const defaultOptions = {
 const transform = async (filename, options = defaultOptions) => {
   const opts = {
     ...defaultOptions,
-    ...options
+    ...options,
+    filePath: filename
   };
   const appendMode = options?.appendJsExtension ?? (opts.target === 'module' ? 'relative-only' : 'off');
   const dirIndex = opts.appendDirectoryIndex === undefined ? 'index.js' : opts.appendDirectoryIndex;

package/dist/src/formatters/memberExpression.d.ts

@@ -4,6 +4,10 @@ import type { FormatterOptions } from '../types.js';
 type MemberExpressionExtras = {
     onRequireResolve?: () => void;
     requireResolveName?: string;
+    onDiagnostic?: (code: string, message: string, loc?: {
+        start: number;
+        end: number;
+    }) => void;
 };
 export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions, shadowed?: Set<string>, extras?: MemberExpressionExtras) => void;
 export {};

package/dist/src/types.d.ts

@@ -34,11 +34,25 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
+    /** Optional diagnostics sink for warnings/errors emitted during transform. */
+    diagnostics?: (diag: Diagnostic) => void;
+    /** Optional source file path used for diagnostics context. */
+    filePath?: string;
     /** Output directory or file path when writing. */
     out?: string;
     /** Overwrite input files instead of writing to out. */
     inPlace?: boolean;
 };
+export type Diagnostic = {
+    level: 'warning' | 'error';
+    code: string;
+    message: string;
+    filePath?: string;
+    loc?: {
+        start: number;
+        end: number;
+    };
+};
 export type SpannedNode = Node & Span;
 export type ExportsMeta = {
     hasExportsBeenReassigned: boolean;

package/dist/types.d.cts

@@ -34,11 +34,25 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
+    /** Optional diagnostics sink for warnings/errors emitted during transform. */
+    diagnostics?: (diag: Diagnostic) => void;
+    /** Optional source file path used for diagnostics context. */
+    filePath?: string;
     /** Output directory or file path when writing. */
     out?: string;
     /** Overwrite input files instead of writing to out. */
     inPlace?: boolean;
 };
+export type Diagnostic = {
+    level: 'warning' | 'error';
+    code: string;
+    message: string;
+    filePath?: string;
+    loc?: {
+        start: number;
+        end: number;
+    };
+};
 export type SpannedNode = Node & Span;
 export type ExportsMeta = {
     hasExportsBeenReassigned: boolean;

package/dist/types.d.ts

@@ -34,11 +34,25 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
+    /** Optional diagnostics sink for warnings/errors emitted during transform. */
+    diagnostics?: (diag: Diagnostic) => void;
+    /** Optional source file path used for diagnostics context. */
+    filePath?: string;
     /** Output directory or file path when writing. */
     out?: string;
     /** Overwrite input files instead of writing to out. */
     inPlace?: boolean;
 };
+export type Diagnostic = {
+    level: 'warning' | 'error';
+    code: string;
+    message: string;
+    filePath?: string;
+    loc?: {
+        start: number;
+        end: number;
+    };
+};
 export type SpannedNode = Node & Span;
 export type ExportsMeta = {
     hasExportsBeenReassigned: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@knighted/module",
-  "version": "1.0.0-rc.3",
-  "description": "Transforms differences between ES modules and CommonJS.",
+  "version": "1.0.0-rc.5",
+  "description": "Bidirectional transform for ES modules and CommonJS.",
   "type": "module",
   "main": "dist/module.js",
   "exports": {
@@ -44,13 +44,12 @@
     "postpack": "node scripts/restoreImportsToSrc.js"
   },
   "keywords": [
-    "transform",
-    "es module",
+    "esm",
     "commonjs",
-    "require",
-    "require.resolve",
-    "import.meta.url",
-    "import.meta.dirname",
+    "transform",
+    "cjs-to-esm",
+    "esm-to-cjs",
+    "import.meta",
     "__dirname",
     "__filename"
   ],