requirejs-esm 4.2.0 → 4.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2025 Ferdinand Prantl
+Copyright (c) 2022-2026 Ferdinand Prantl
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -123,9 +123,14 @@ The `esm` plugin supports configuration with the following defaults:
     mixedAmdAndEsm: false,
     // Suppress transpiling even if an optimized module has not been loaded yet.
     onlyAmd: false,
+    // Assume AMD/UMD if there're no import or export statements.
+    skipIfNoImportExport: false,
     // Do not insert `"use strict"` expression to the AMD modules. You'd set it
     // to `false` if your bundler inserts `"use strict"` to the outer scope.
     useStrict: true,
+    // Split `export default class A {}` to `class A {}; export default A`
+    // to trade easier AST manipulation for 100% code compatibility.
+    splitDefaultNamedDeclarations: false,
     // Enable source maps, can be an object with booleans { inline, content }.
     // If set to true, the object will be set to { inline: true, content: true }.
     sourceMap: false,
@@ -182,13 +187,21 @@ The returned object:
 }
 ```
 
+## Skipping and Forcing Transformation
+
+If the option `skipIfNoImportExport` of `transform` is set to `true` and the input source contains neither `import` nor `export` statements, the input source won't be enclosed in the AMD wrapper. The input will be assumed to be in AMD/UMD format already.
+
+If the input source contains a line "// requirejs-esm-skip-file" among the first 10 lines shorter than 100 characters, the input file will not be transformed.
+
+If the input source contains a line "// requirejs-esm-process-file" among the first 10 lines shorter than 100 characters and the `transform` option `skipIfNoImportExport` is set to `true`, the input will be transformed nevertheless. The comment has a higher priority than the option.
+
 ## Contributing
 
 In lieu of a formal styleguide, take care to maintain the existing coding style. Lint and test your code.
 
 ## License
 
-Copyright (c) 2022-2025 Ferdinand Prantl
+Copyright (c) 2022-2026 Ferdinand Prantl
 
 Licensed under the MIT license.
 

package/bin/esm2requirejs.js

@@ -3,7 +3,7 @@
 // Require module dependencies.
 const { Command } = require('commander')
 const glob = require('tiny-glob')
-const { readFile, writeFile } = require('fs/promises')
+const { readFile, writeFile } = require('node:fs/promises')
 const { transform } = require('../dist/api')
 
 // Define the command-line interface.
@@ -16,9 +16,11 @@ program.description('Transforms an ESM module to AMD or adapts an AMD module for
   .option('-o, --output <file>', 'write the adapted module source to a file')
   .option('-r, --rewrite', 'rewrite the input files with the adapted output')
   .option('-s, --source-map', 'write inline source maps to the adapted output')
+  .option('-a, --skip-if-no-import-export', 'assume AMD/UMD if there\'re no import or export statements')
+  .option('-d, --split-default-named-declarations', 'split default named export to declaration and export')
   .option('-v, --verbose', 'print progress and call stack in case of error')
   .argument('[files...]')
-  .on('--help', function () {
+  .on('--help', () => {
     console.log()
     console.log('You can use one or more file names or one or more glob patterns to specify one')
     console.log('or more files. If you set the plugin name to an empty string, modules already')
@@ -35,6 +37,8 @@ const {
   /*ecma: ecmaVersion,*/
   plugin: pluginName,
   sourceMap,
+  skipIfNoImportExport,
+  splitDefaultNamedDeclarations,
   output: outputFile,
   rewrite,
   verbose
@@ -45,7 +49,7 @@ if (!args.length) {
 }
 
 // Main entry point.
-(async function () {
+((async () => {
   try {
     const files = (await Promise.all(args.map(arg => glob(arg)))).flat()
     if (!files.length) {
@@ -57,6 +61,8 @@ if (!args.length) {
         /*ecmaVersion,*/
         pluginName,
         sourceMap,
+        skipIfNoImportExport,
+        splitDefaultNamedDeclarations,
         verbose
       })
       if (updated) {
@@ -75,4 +81,4 @@ if (!args.length) {
     console.error((!verbose && error.message) || error)
     process.exitCode = 1
   }
-}())
+})())