@carbon/cli 11.32.0-rc.0 → 11.32.0-rc.1

package/bin/carbon-cli.js

@@ -7,11 +7,12 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
 // Inspired by Create React App
 // https://github.com/facebook/create-react-app/blob/next/packages/create-react-app/index.js
 
+import chalk from 'chalk';
+import { main } from '../src/cli.js';
+
 // Makes the script crash on unhandled rejections instead of silently
 // ignoring them. In the future, promise rejections that are not handled will
 // terminate the Node.js process with a non-zero exit code.
@@ -19,11 +20,9 @@ process.on('unhandledRejection', (error) => {
   console.error(error);
 });
 
-var chalk = require('chalk');
-
-var currentNodeVersion = process.versions.node;
-var semver = currentNodeVersion.split('.');
-var major = semver[0];
+const currentNodeVersion = process.versions.node;
+const semver = currentNodeVersion.split('.');
+const major = semver[0];
 
 if (major < 8) {
   console.error(
@@ -36,8 +35,6 @@ if (major < 8) {
   process.exit(1);
 }
 
-var main = require('../src/cli');
-
 main(process).catch((error) => {
   console.error(error);
   process.exit(1);

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@carbon/cli",
   "description": "Task automation for working with the Carbon Design System",
-  "version": "11.32.0-rc.0",
+  "version": "11.32.0-rc.1",
   "license": "Apache-2.0",
+  "type": "module",
   "bin": {
     "carbon-cli": "./bin/carbon-cli.js"
   },
@@ -28,7 +29,7 @@
   },
   "dependencies": {
     "@babel/core": "^7.27.3",
-    "@carbon/cli-reporter": "^10.7.0",
+    "@carbon/cli-reporter": "^10.7.1-rc.0",
     "@ibm/telemetry-js": "^1.5.0",
     "@octokit/plugin-retry": "^3.0.7",
     "@octokit/plugin-throttling": "^4.0.0",
@@ -36,25 +37,25 @@
     "@rollup/plugin-babel": "^6.0.0",
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-node-resolve": "^15.0.0",
-    "chalk": "^4.1.1",
-    "change-case": "^4.1.2",
+    "chalk": "^5.4.1",
+    "change-case-all": "^2.1.0",
     "child-process-promise": "^2.2.1",
-    "clipboardy": "^2.1.0",
-    "enquirer": "^2.3.6",
-    "fast-glob": "^3.2.7",
-    "fs-extra": "^11.0.0",
-    "inquirer": "^6.4.1",
+    "clipboardy": "^4.0.0",
+    "enquirer": "^2.4.1",
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^12.5.0",
     "klaw-sync": "^6.0.0",
     "lodash.template": "^4.5.0",
     "prettier": "^3.3.3",
     "prettier-config-carbon": "^0.12.0",
     "progress-estimator": "^0.3.0",
-    "remark": "^10.0.1",
-    "replace-in-file": "^7.0.0",
+    "remark": "^15.0.1",
+    "replace-in-file": "^8.3.0",
     "rollup": "^4.41.1",
     "sass": "^1.77.7",
     "typescript-config-carbon": "^0.5.0",
-    "yargs": "^17.0.1"
+    "yargs": "^17.7.2"
   },
-  "gitHead": "babd7a9692f8c0595b67877417d7ebf915e19b20"
+  "gitHead": "573fc72ac30bc2d71ebb90644b803ba8408fe82e"
 }

package/src/changelog.js

@@ -1,14 +1,12 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const { default: parse } = require('@commitlint/parse');
-const execa = require('execa');
+import { default as parse } from '@commitlint/parse';
+import { execa } from 'execa';
 
 // We keep a list of commits that are process-oriented that we never want to
 // show up in generated changelogs
@@ -36,7 +34,7 @@ const headerDenyList = new Set([
  * @param {string} latestTag
  * @returns {string}
  */
-async function generate(packages, lastTag, latestTag) {
+export async function generate(packages, lastTag, latestTag) {
   const packageCommitsInRange = await Promise.all(
     packages.map((pkg) => getCommitsInRange(pkg, `${lastTag}...${latestTag}`))
   );
@@ -211,7 +209,3 @@ async function getCommitsInRange(pkg, range) {
     commits,
   };
 }
-
-module.exports = {
-  generate,
-};

package/src/cli.js

@@ -5,17 +5,55 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { createRequire } from 'module';
+
+// Import commands explicitly since yargs commandDir() doesn't support ESM yet
+import * as bundle from './commands/bundle.js';
+import * as check from './commands/check.js';
+import * as ciCheck from './commands/ci-check.js';
+import * as changelog from './commands/changelog.js';
+import * as component from './commands/component.js';
+import * as contribute from './commands/contribute.js';
+import * as inline from './commands/inline.js';
+import * as publish from './commands/publish.js';
+import * as release from './commands/release.js';
+import * as sync from './commands/sync.js';
+
+const require = createRequire(import.meta.url);
 
-const cli = require('yargs');
 const packageJson = require('../package.json');
 
-async function main({ argv }) {
-  cli
+// Create yargs command config with optional properties
+function createCommand(cmd) {
+  const config = {
+    command: cmd.command,
+    desc: cmd.desc,
+    handler: cmd.handler,
+  };
+  if (cmd.builder) {
+    config.builder = cmd.builder;
+  }
+  return config;
+}
+
+export async function main({ argv }) {
+  yargs(hideBin(argv))
     .scriptName(packageJson.name)
     .version(packageJson.version)
     .usage('Usage: $0 [options]')
-    .commandDir('commands')
+    // Add commands explicitly
+    .command(createCommand(bundle))
+    .command(createCommand(check))
+    .command(createCommand(ciCheck))
+    .command(createCommand(changelog))
+    .command(createCommand(component))
+    .command(createCommand(contribute))
+    .command(createCommand(inline))
+    .command(createCommand(publish))
+    .command(createCommand(release))
+    .command(createCommand(sync))
     .strict()
     .fail((message, error, yargs) => {
       if (error) {
@@ -32,5 +70,3 @@ async function main({ argv }) {
     })
     .parse(argv.slice(2));
 }
-
-module.exports = main;

package/src/commands/bundle/bundlers.js

@@ -1,18 +1,16 @@
 /**
- * Copyright IBM Corp. 2018, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const javascript = require('./javascript');
-const typescript = require('./typescript');
+import javascript from './javascript.js';
+import typescript from './typescript.js';
 
 const bundlers = new Map([
   ['.js', javascript],
   ['.ts', typescript],
 ]);
 
-module.exports = bundlers;
+export default bundlers;

package/src/commands/bundle/javascript.js

@@ -1,25 +1,23 @@
 /**
- * Copyright IBM Corp. 2018, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const { babel } = require('@rollup/plugin-babel');
-const commonjs = require('@rollup/plugin-commonjs');
-const { nodeResolve } = require('@rollup/plugin-node-resolve');
-const fs = require('fs-extra');
-const path = require('path');
-const { rollup } = require('rollup');
-const {
+import { babel } from '@rollup/plugin-babel';
+import commonjs from '@rollup/plugin-commonjs';
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import fs from 'fs-extra';
+import path from 'path';
+import { rollup } from 'rollup';
+import {
   formatGlobals,
   findPackageFolder,
   formatDependenciesIntoGlobals,
-} = require('./utils');
+} from './utils.js';
 
-async function bundle(entrypoint, options) {
+export default async function bundle(entrypoint, options) {
   const globals = options.globals ? formatGlobals(options.globals) : {};
   const { name } = options;
   const packageFolder = await findPackageFolder(entrypoint);
@@ -98,5 +96,3 @@ async function bundle(entrypoint, options) {
     })
   );
 }
-
-module.exports = bundle;

package/src/commands/bundle/typescript.js

@@ -1,27 +1,25 @@
 /**
- * Copyright IBM Corp. 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const { babel } = require('@rollup/plugin-babel');
-const commonjs = require('@rollup/plugin-commonjs');
-const { nodeResolve } = require('@rollup/plugin-node-resolve');
-const typescript = require('@rollup/plugin-typescript');
-const fs = require('fs-extra');
-const path = require('path');
-const { rollup } = require('rollup');
-const { loadBaseTsCompilerOpts } = require('typescript-config-carbon');
-const {
+import { babel } from '@rollup/plugin-babel';
+import commonjs from '@rollup/plugin-commonjs';
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import typescript from '@rollup/plugin-typescript';
+import fs from 'fs-extra';
+import path from 'path';
+import { rollup } from 'rollup';
+import { loadBaseTsCompilerOpts } from 'typescript-config-carbon';
+import {
   formatGlobals,
   findPackageFolder,
   formatDependenciesIntoGlobals,
-} = require('./utils');
+} from './utils.js';
 
-async function bundle(entrypoint, options) {
+export default async function bundle(entrypoint, options) {
   const globals = options.globals ? formatGlobals(options.globals) : {};
   const { name } = options;
   const packageFolder = await findPackageFolder(entrypoint);
@@ -114,5 +112,3 @@ async function bundle(entrypoint, options) {
     })
   );
 }
-
-module.exports = bundle;

package/src/commands/bundle/utils.js

@@ -1,17 +1,15 @@
 /**
- * Copyright IBM Corp. 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
+import path from 'path';
+import fs from 'fs-extra';
+import { pascalCase } from 'change-case';
 
-const path = require('path');
-const fs = require('fs-extra');
-const { pascalCase } = require('change-case');
-
-function formatGlobals(string) {
+export function formatGlobals(string) {
   const mappings = string.split(',').map((mapping) => {
     return mapping.split('=');
   });
@@ -24,7 +22,7 @@ function formatGlobals(string) {
   );
 }
 
-function formatDependenciesIntoGlobals(dependencies) {
+export function formatDependenciesIntoGlobals(dependencies) {
   return Object.keys(dependencies).reduce((acc, key) => {
     const parts = key.split('/').map((identifier, i) => {
       if (i === 0) {
@@ -40,7 +38,7 @@ function formatDependenciesIntoGlobals(dependencies) {
   }, {});
 }
 
-async function findPackageFolder(entrypoint) {
+export async function findPackageFolder(entrypoint) {
   let packageFolder = entrypoint;
 
   while (packageFolder !== '/' && path.dirname(packageFolder) !== '/') {
@@ -54,9 +52,3 @@ async function findPackageFolder(entrypoint) {
 
   return packageFolder;
 }
-
-module.exports = {
-  formatGlobals,
-  formatDependenciesIntoGlobals,
-  findPackageFolder,
-};

package/src/commands/bundle.js

@@ -1,15 +1,13 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const path = require('path');
-const { createLogger } = require('../logger');
-const bundlers = require('./bundle/bundlers');
+import path from 'path';
+import { createLogger } from '../logger.js';
+import bundlers from './bundle/bundlers.js';
 
 const logger = createLogger('bundle');
 
@@ -41,27 +39,25 @@ async function bundle({ entrypoint, name, globals }) {
   logger.stop();
 }
 
-module.exports = {
-  command: 'bundle <entrypoint>',
-  desc: 'bundle the given .js entrypoint',
-  builder(yargs) {
-    yargs.positional('entrypoint', {
-      type: 'string',
-      describe: 'the entrypoint Javascript file',
-    });
+export const builder = (yargs) => {
+  yargs.positional('entrypoint', {
+    type: 'string',
+    describe: 'the entrypoint Javascript file',
+  });
 
-    yargs.options({
-      n: {
-        alias: 'name',
-        describe: 'the name of the module for the UMD build',
-        type: 'string',
-      },
-      g: {
-        alias: 'globals',
-        describe: 'global module names',
-        type: 'string',
-      },
-    });
-  },
-  handler: bundle,
+  yargs.options({
+    n: {
+      alias: 'name',
+      describe: 'the name of the module for the UMD build',
+      type: 'string',
+    },
+    g: {
+      alias: 'globals',
+      describe: 'global module names',
+      type: 'string',
+    },
+  });
 };
+export const command = 'bundle <entrypoint>';
+export const desc = 'bundle the given .js entrypoint';
+export const handler = bundle;

package/src/commands/changelog.js

@@ -1,18 +1,16 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const clipboard = require('clipboardy');
-const { prompt } = require('inquirer');
-const { generate } = require('../changelog');
-const { fetchLatestFromUpstream } = require('../git');
-const { createLogger, displayBanner } = require('../logger');
-const { getPackages } = require('../workspace');
+import clipboard from 'clipboardy';
+import inquirer from 'inquirer';
+import { generate } from '../changelog.js';
+import { fetchLatestFromUpstream } from '../git.js';
+import { createLogger, displayBanner } from '../logger.js';
+import { getPackages } from '../workspace.js';
 
 const logger = createLogger('changelog');
 
@@ -52,7 +50,7 @@ async function changelog({ range, noPrompt = false }) {
 
   let response;
   if (!noPrompt) {
-    response = await prompt([
+    response = await inquirer.prompt([
       {
         type: 'confirm',
         name: 'copy',
@@ -69,21 +67,19 @@ async function changelog({ range, noPrompt = false }) {
   }
 }
 
-module.exports = {
-  command: 'changelog <range>',
-  desc: 'generate the changelog for the given git tag range',
-  builder(yargs) {
-    yargs.positional('range', {
-      describe: 'the git tag range to generate a changelog for',
-      type: 'string',
-    });
-    yargs.options({
-      n: {
-        alias: 'noPrompt',
-        describe: 'disables copy to clipboard prompt',
-        type: 'boolean',
-      },
-    });
-  },
-  handler: changelog,
+export const builder = (yargs) => {
+  yargs.positional('range', {
+    describe: 'the git tag range to generate a changelog for',
+    type: 'string',
+  });
+  yargs.options({
+    n: {
+      alias: 'noPrompt',
+      describe: 'disables copy to clipboard prompt',
+      type: 'boolean',
+    },
+  });
 };
+export const command = 'changelog <range>';
+export const desc = 'generate the changelog for the given git tag range';
+export const handler = changelog;

package/src/commands/check.js

@@ -1,16 +1,14 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const glob = require('fast-glob');
-const path = require('path');
-const { createLogger } = require('../logger');
-const compile = require('../compile');
+import glob from 'fast-glob';
+import path from 'path';
+import { createLogger } from '../logger.js';
+import compile from '../compile.js';
 
 const logger = createLogger('check');
 
@@ -51,27 +49,25 @@ async function check({ glob: pattern, ignore = [], list = false }) {
   }
 }
 
-module.exports = {
-  command: 'check <glob>',
-  desc: 'check that each file can be compiled',
-  builder(yargs) {
-    yargs.positional('glob', {
-      type: 'string',
-      describe: 'glob pattern for files to check',
-    });
+export const builder = (yargs) => {
+  yargs.positional('glob', {
+    type: 'string',
+    describe: 'glob pattern for files to check',
+  });
 
-    yargs.options({
-      i: {
-        alias: 'ignore',
-        describe: 'provide a glob pattern of files to ignore',
-        type: 'string',
-      },
-      l: {
-        alias: 'list',
-        describe: 'list all the files that were compiled',
-        type: 'boolean',
-      },
-    });
-  },
-  handler: check,
+  yargs.options({
+    i: {
+      alias: 'ignore',
+      describe: 'provide a glob pattern of files to ignore',
+      type: 'string',
+    },
+    l: {
+      alias: 'list',
+      describe: 'list all the files that were compiled',
+      type: 'boolean',
+    },
+  });
 };
+export const command = 'check <glob>';
+export const desc = 'check that each file can be compiled';
+export const handler = check;

package/src/commands/ci-check.js

@@ -1,15 +1,13 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const { reporter } = require('@carbon/cli-reporter');
-const { exec } = require('child-process-promise');
-const { workspace } = require('../workspace');
+import { reporter } from '@carbon/cli-reporter';
+import { exec } from 'child-process-promise';
+import { workspace } from '../workspace.js';
 
 async function check(args, env) {
   reporter.info('Running checks in CI...');
@@ -41,9 +39,7 @@ async function check(args, env) {
   }
 }
 
-module.exports = {
-  command: 'ci-check',
-  desc: 'run CI checks',
-  builder: {},
-  handler: workspace(check),
-};
+export const builder = {};
+export const command = 'ci-check';
+export const desc = 'run CI checks';
+export const handler = workspace(check);

package/src/commands/component.js

@@ -1,18 +1,16 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-const { paramCase } = require('change-case');
-const fs = require('fs-extra');
-const { prompt } = require('enquirer');
-const path = require('path');
-const { loadTemplates } = require('../component');
-const { createLogger } = require('../logger');
+import { paramCase } from 'change-case';
+import fs from 'fs-extra';
+import inquirer from 'inquirer';
+import path from 'path';
+import { loadTemplates } from '../component/index.js';
+import { createLogger } from '../logger.js';
 
 const logger = createLogger('component');
 
@@ -64,7 +62,7 @@ async function component() {
   ];
 
   clearConsole();
-  const answers = await prompt(questions);
+  const answers = await inquirer.prompt(questions);
 
   logger.start('Generating component...');
 
@@ -123,8 +121,6 @@ async function component() {
   logger.stop();
 }
 
-module.exports = {
-  command: 'component',
-  desc: '[EXPERIMENTAL] Scaffold a component in React',
-  handler: component,
-};
+export const command = 'component';
+export const desc = '[EXPERIMENTAL] Scaffold a component in React';
+export const handler = component;