Switch to esm

.prettierrc.js

@@ -1,4 +1,4 @@
-const config = {
+export default {
   // plugins: ['prettier-plugin-jsdoc'],
   singleQuote: true,
   overrides: [
@@ -8,5 +8,3 @@ const config = {
     },
   ],
 };
-
-module.exports = config;

CHANGELOG.md

@@ -11,6 +11,11 @@ The version numbering does not follow semantic versioning but instead aligns wit
 
 ## [15.0.0] (2026-05-29)
 
+`@commander-js/extra-typings` 15 is ESM only. This is expected to be seamless for ESM consumers, but some CommonJS consumers may hit issues with tooling requiring configuration for ESM-only dependencies. See Migration Tips below.
+
+The release of `@commander-js/extra-typings` 15 moves version 14 into maintenance. `@commander-js/extra-typings` 14 will get security updates for
+12 months (to May 2027). For more info see [Release Policy](./docs/release-policy.md).
+
 ### Added
 
 - [Release Policy document](./docs/release-policy.md)
@@ -20,6 +25,17 @@ The version numbering does not follow semantic versioning but instead aligns wit
 - *Breaking:* peer dependency on Commander 15.0.x which requires Node.js 22.12 or higher
 - update dependencies
 - old major versions now supported for 12 months instead of just previous major version, to give predictable end-of-life date
+- now reexporting the global `program` singleton from Commander rather than creating a separate one
+
+### Migration Tips
+
+`@commander-js/extra-typings` 15 is ESM only, but this does not mean you need to migrate to ESM to use it. Importing ESM from CommonJS is
+supported by Node.js, and Bun, Deno, and TypeScript. Hopefully it Just Works for you! However, you may be using a different runtime or
+some other part of your setup that may not yet natively support importing ESM from CommonJS, such as your testing framework
+or bundler.
+
+If you have problems using `@commander-js/extra-typings` 15 in your environment, one option is stay on version 14 for now. `@commander-js/extra-typings` 14 will
+get security updates until May 2027 and things will hopefully improve for your setup in the meantime.
 
 ## [14.0.0] (2025-05-18)
 

eslint.config.js

@@ -1,14 +1,14 @@
-const globals = require('globals');
-const esLintjs = require('@eslint/js');
-const { defineConfig } = require('eslint/config');
-const tseslint = require('typescript-eslint');
-const eslintConfigPrettier = require('eslint-config-prettier/flat');
+import globals from 'globals';
+import esLintjs from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import eslintConfigPrettier from 'eslint-config-prettier';
 
 // Simpler setup than in Commander as not running TypeScript over .js files.
 const tsconfigTsFiles = ['**/*.{ts,mts}'];
 
 // Using tseslint.config adds some type safety and `extends` to simplify customising config array.
-module.exports = defineConfig(
+export default defineConfig(
   // Add recommended rules.
   esLintjs.configs.recommended,
   {

examples/assemble.ts

@@ -1,5 +1,5 @@
-import { createProgram, type ProgramOpts } from './assemble-program';
-import { createSub, type SubOpts } from './assemble-sub';
+import { createProgram, type ProgramOpts } from './assemble-program.js';
+import { createSub, type SubOpts } from './assemble-sub.js';
 
 // Example of strongly typed globals in a subcommand which is added to program using .addCommand().
 

index.js

@@ -1,23 +1 @@
-const commander = require('commander');
-
-exports = module.exports = {};
-
-// Return a different global program than commander,
-// and don't also return it as default export.
-exports.program = new commander.Command();
-
-/**
- * Expose classes. The FooT versions are just types, so return Commander original implementations!
- */
-
-exports.Argument = commander.Argument;
-exports.Command = commander.Command;
-exports.CommanderError = commander.CommanderError;
-exports.Help = commander.Help;
-exports.InvalidArgumentError = commander.InvalidArgumentError;
-exports.InvalidOptionArgumentError = commander.InvalidArgumentError; // Deprecated
-exports.Option = commander.Option;
-
-exports.createCommand = commander.createCommand;
-exports.createOption = commander.createOption;
-exports.createArgument = commander.createArgument;
+export * from 'commander';

package.json

@@ -2,7 +2,7 @@
   "name": "@commander-js/extra-typings",
   "version": "15.0.0",
   "description": "Infer strong typings for commander options and action handlers",
-  "main": "index.js",
+  "main": "./index.js",
   "scripts": {
     "check": "npm run check:type && npm run check:lint && npm run check:format",
     "check:format": "prettier --check .",
@@ -24,14 +24,13 @@
     "index.js",
     "index.d.ts"
   ],
-  "type": "commonjs",
+  "type": "module",
   "exports": {
     ".": {
-      "require": "./index.js",
-      "import": "./esm.mjs"
+      "types": "./index.d.ts",
+      "default": "./index.js"
     }
   },
-  "types": "index.d.ts",
   "tsd": {
     "directory": "tests"
   },

tests/arguments.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType, expectAssignable } from 'tsd';
-import { Command, Argument, OptionValues } from '..';
+import { Command, Argument, OptionValues } from '../index.js';
 
 // Reusing same program variable through tests for convenience.
 const program = new Command();

tests/assignment.test-d.ts

@@ -1,5 +1,5 @@
 import { expectAssignable, expectNotAssignable } from 'tsd';
-import { Command, CommandUnknownOpts, Option } from '..';
+import { Command, CommandUnknownOpts, Option } from '../index.js';
 
 // 'when assign Command to CommandUnknownOpts then no error'
 {

tests/command-unknown-opts.test-d.ts

@@ -1,4 +1,4 @@
-import { Command, CommandUnknownOpts } from '..';
+import { Command, CommandUnknownOpts } from '../index.js';
 import { expectType } from 'tsd';
 
 // Fallback location for CommandUnknownOpts if not better file for the test.

tests/commander.test-d.ts

@@ -1,4 +1,4 @@
-import * as commander from '../index';
+import * as commander from '../index.js';
 import { expectType, expectAssignable } from 'tsd';
 
 // This is a copy of the TypeScript tests in Commander to see

tests/create-argument.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command, createArgument } from '..';
+import { Command, createArgument } from '../index.js';
 
 // Doing end-to-end test, rather than checking created Argument directly.
 

tests/create-option.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command, createOption } from '..';
+import { Command, createOption } from '../index.js';
 
 // Doing end-to-end test, rather than checking created Option directly.
 

tests/help.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType, expectAssignable } from 'tsd';
-import { Help, Command, CommandUnknownOpts, Option } from '..';
+import { Help, Command, CommandUnknownOpts, Option } from '../index.js';
 
 // Still exploring when to use Command/CommandUnknownOpts in Help.
 //

tests/hook.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command } from '..';
+import { Command } from '../index.js';
 
 // 'when add preAction hook then thisCommand strongly typed'
 {

tests/literal-unions.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType, expectAssignable } from 'tsd';
-import { Command, Option, OptionValues } from '..';
+import { Command, Option, OptionValues } from '../index.js';
 
 const program = new Command();
 program.setOptionValueWithSource('key', 'value', 'cli'); // expected source used by Commander

tests/option-value.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command } from '..';
+import { Command } from '../index.js';
 
 // 'when getOptionValue is unknown then key is unknown'
 {

tests/options.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType, expectAssignable } from 'tsd';
-import { Command, Option, OptionValues } from '..';
+import { Command, Option, OptionValues } from '../index.js';
 
 function myParseInt(arg: string, previous: number): number {
   return parseInt(arg);

tests/processed-args.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command } from '..';
+import { Command } from '../index.js';
 
 // Doing a subset of the full tests in arguments.test-d.ts
 

tests/subclass.test-d.ts

@@ -1,5 +1,5 @@
 import { expectType } from 'tsd';
-import { Command, Option } from '..';
+import { Command, Option } from '../index.js';
 
 // Breaking: need to add type parameter for use in super constructor
 class MyOption<Usage extends string = ''> extends Option<Usage> {

tsconfig.json

@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
-    "module": "commonjs",
-    "lib": ["es6"],
+    "module": "nodenext",
+    "lib": ["ESNext"],
     "types": ["node"],
     "noImplicitAny": true,
     "noImplicitThis": true,