Conditional exports to simplify ECMAScript import

[shadowspawn]

Pull Request

Problem

We are currently using a subpath for ECMAScript imports.

import { Command } from 'commander/esm.mjs';

Node.js has added support for conditional imports which allows using same path for CommonJs and ECMAScript imports:

• https://nodejs.org/dist/latest-v14.x/docs/api/packages.html#packages_conditional_exports

but the combination of ECMAScript without a warning and the conditional export support are only available from Node.js v12.20.0.

Node.js v12 is still LTS until 2022-04-30:

• https://nodejs.org/en/about/releases/

Related: #1284

Solution

Add conditional exports to package.json for unqualified import. Still support the old subpath import. Update required Node.js version to v12.20.0.

v12.20.0 was released 2020-11-24, so by the time Commander v9 is released it will have been available for over a year.

Or we could just wait until after Node 12 is EOL before adopting conditional exports in Commander v10?!

ChangeLog

• added: simpler ECMAScript import
• changed: Commander 9 requires Node.js v14 or higher, or Node.js v12.x from v12.20.0 or higher

[abetomo]

👍

[shadowspawn]

Commander v9 has been released.