feat!: esm, core7 (#600)

* chore: updates from devScripts

* feat: esm

* chore: linkinator

* chore: bin/run for generate

* chore: core 7

* test: use bin/dev

* chore: bump plugin-auth

* chore: bump oclif/core, etc

* ci: no ts-noe for cmd-ref

* test: windows ut via node command

* chore: bump plugin-auth for new plugin-info

---------

Co-authored-by: svc-cli-bot <[email protected]>

Author: mshanemc

.mocharc.json

@@ -1,7 +1,8 @@
 {
-  "require": "ts-node/register,source-map-support/register",
+  "require": ["ts-node/register"],
   "watch-extensions": "ts",
   "recursive": true,
   "reporter": "spec",
-  "timeout": 15000
+  "timeout": 15000,
+  "node-option": ["loader=ts-node/esm"]
 }

.sfdevrc.json

@@ -4,7 +4,7 @@
   },
   "wireit": {
     "test:command-reference": {
-      "command": "ts-node \"./bin/dev.js\" commandreference:generate --plugins auth --outputdir test/tmp",
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning  \"./bin/dev.js\" commandreference generate --plugins auth --outputdir test/tmp",
       "files": ["src/**/*.ts", "messages/**", "package.json"],
       "output": ["test/tmp"]
     },

bin/dev.js

@@ -1,6 +1,8 @@
-#!/usr/bin/env ts-node
-// eslint-disable-next-line node/shebang, unicorn/prefer-top-level-await
-(async () => {
-  const oclif = await import('@oclif/core');
-  await oclif.execute({ development: true, dir: __dirname });
-})();
+#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ development: true, dir: import.meta.url });
+}
+
+await main();

bin/run.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
-// eslint-disable-next-line unicorn/prefer-top-level-await
-(async () => {
-  const oclif = await import('@oclif/core');
-  await oclif.execute({ development: false, dir: __dirname });
-})();
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ dir: import.meta.url });
+}
+
+await main();

commitlint.config.js commitlint.config.cjscommitlint.config.js renamed to commitlint.config.cjs

@@ -4,30 +4,29 @@
   "version": "3.0.75",
   "author": "Salesforce",
   "bugs": "https://github.com/salesforcecli/plugin-command-reference/issues",
+  "type": "module",
   "dependencies": {
-    "@oclif/core": "^3.26.0",
-    "@salesforce/core": "^6.7.6",
+    "@oclif/core": "^3.26.2",
+    "@salesforce/core": "^7.1.0",
     "@salesforce/kit": "^3.1.0",
-    "@salesforce/sf-plugins-core": "^5.0.13",
+    "@salesforce/sf-plugins-core": "^9.0.1",
     "@salesforce/ts-types": "^2.0.9",
-    "chalk": "^4",
+    "chalk": "^5.3.0",
     "debug": "^4.3.4",
-    "handlebars": "^4.7.8",
-    "tslib": "^2"
+    "handlebars": "^4.7.8"
   },
   "devDependencies": {
-    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-help": "^6.0.20",
     "@salesforce/dev-scripts": "^8.5.0",
-    "@salesforce/plugin-auth": "^2.8.26",
+    "@salesforce/plugin-auth": "^3.6.1",
     "@types/debug": "^4.1.12",
-    "@types/ejs": "^3.1.5",
-    "eslint-plugin-sf-plugin": "^1.17.5",
-    "oclif": "^4",
+    "eslint-plugin-sf-plugin": "^1.18.0",
+    "oclif": "^4.8.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.4.4"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "files": [
     "/lib",
@@ -44,6 +43,7 @@
   "license": "BSD-3-Clause",
   "oclif": {
     "commands": "./lib/commands",
+    "flexibleTaxonomy": true,
     "bin": "sf",
     "topicSeparator": " ",
     "topics": {
@@ -157,7 +157,7 @@
       ]
     },
     "test:command-reference": {
-      "command": "ts-node \"./bin/dev.js\" commandreference:generate --plugins auth --outputdir test/tmp",
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning  \"./bin/dev.js\" commandreference generate --plugins auth --outputdir test/tmp",
       "files": [
         "src/**/*.ts",
         "messages/**",

package.json

@@ -5,21 +5,21 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 
-import * as os from 'node:os';
+import os from 'node:os';
 import { resolve } from 'node:path';
 import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
 // eslint-disable-next-line sf-plugin/no-oclif-flags-command-import
 import { Command, Config, Interfaces } from '@oclif/core';
 import { Messages, SfError } from '@salesforce/core';
 import { AnyJson, ensure } from '@salesforce/ts-types';
-import chalk = require('chalk');
+import chalk from 'chalk';
 import { PJSON } from '@oclif/core/lib/interfaces';
-import { Ditamap } from '../../ditamap/ditamap';
-import { Docs } from '../../docs';
-import { CliMeta, CommandClass, events, SfTopic, SfTopics } from '../../utils';
+import { Ditamap } from '../../ditamap/ditamap.js';
+import { Docs } from '../../docs.js';
+import { CliMeta, CommandClass, events, SfTopic, SfTopics } from '../../utils.js';
 
 // Initialize Messages with the current plugin directory
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-command-reference', 'main');
 
 export type CommandReferenceGenerateResults = {
@@ -156,7 +156,7 @@ export default class CommandReferenceGenerate extends SfCommand<CommandReference
     await docs.build(commands);
     this.log(`\nWrote generated doc to ${Ditamap.outputDir}`);
 
-    if (flags.erroronwarnings && warnings.length > 0) {
+    if (flags['error-on-warnings'] && warnings.length > 0) {
       throw new SfError(`Found ${warnings.length} warnings.`);
     }
 

src/commands/commandreference/generate.ts

@@ -7,9 +7,9 @@
 
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
-import * as chalk from 'chalk';
+import chalk from 'chalk';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-command-reference', 'jit.install');
 
 export default class JitInstall extends SfCommand<void> {

src/commands/jit/install.ts

@@ -5,7 +5,7 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 
-import { Ditamap } from './ditamap';
+import { Ditamap } from './ditamap.js';
 
 export class BaseDitamap extends Ditamap {
   public constructor(topics: string[]) {

src/ditamap/base-ditamap.ts

@@ -5,7 +5,7 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 
-import { Ditamap } from './ditamap';
+import { Ditamap } from './ditamap.js';
 
 export class CLIReference extends Ditamap {
   public constructor() {