@salesforce/plugin-command-reference 3.1.107 → 3.1.109

package/lib/markdown/toc.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MarkdownBase } from './markdown-base.js';
+const STATE_LABELS = {
+    beta: 'Beta',
+    preview: 'Developer Preview',
+    closedPilot: 'Closed Pilot',
+    openPilot: 'Open Pilot',
+    deprecated: 'Deprecated',
+};
+export class MarkdownToc extends MarkdownBase {
+    topicEntries;
+    constructor(topicEntries, outputDir) {
+        super('sfclireference-toc.yml', outputDir);
+        this.topicEntries = topicEntries;
+    }
+    static file() {
+        return 'sfclireference-toc.yml';
+    }
+    // eslint-disable-next-line class-methods-use-this
+    generate() {
+        const lines = [
+            '- title: Salesforce CLI Command Reference',
+            '  link: cli_reference.md',
+            '- title: Release Notes',
+            '  link: cli_reference_release_notes.md',
+            '- title: Deprecation Policy',
+            '  link: cli_reference_deprecation.md',
+        ];
+        const sorted = [...this.topicEntries].sort((a, b) => a.topic.localeCompare(b.topic));
+        for (const { topic, commandIds } of sorted) {
+            lines.push(`- title: ${topic} Commands`);
+            lines.push(`  link: ${topic}/cli_reference_${topic}.md`);
+            lines.push('  topics:');
+            for (const { id, state, deprecated } of [...commandIds].sort((a, b) => a.id.localeCompare(b.id))) {
+                const commandWithUnderscores = id.replace(/:/g, '_');
+                const commandWithSpaces = id.replace(/:/g, ' ');
+                const stateLabel = deprecated
+                    ? ' (Deprecated)'
+                    : state && STATE_LABELS[state]
+                        ? ` (${STATE_LABELS[state]})`
+                        : '';
+                const isTopicLevelCommand = !id.includes(':');
+                const linkTarget = isTopicLevelCommand
+                    ? `cli_reference_${commandWithUnderscores}_command.md`
+                    : `cli_reference_${commandWithUnderscores}.md`;
+                lines.push(`    - title: ${commandWithSpaces}${stateLabel}`);
+                lines.push(`      link: ${topic}/${linkTarget}`);
+            }
+        }
+        lines.push('');
+        return Promise.resolve(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=toc.js.map

package/lib/markdown/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../src/markdown/toc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,mBAAmB;IAC5B,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,YAAY;IAChB;IAA3B,YAA2B,YAA6B,EAAE,SAAiB;QACzE,KAAK,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;QADlB,iBAAY,GAAZ,YAAY,CAAiB;IAExD,CAAC;IAEM,MAAM,CAAU,IAAI;QACzB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,kDAAkD;IACxC,QAAQ;QAChB,MAAM,KAAK,GAAa;YACtB,2CAA2C;YAC3C,0BAA0B;YAC1B,wBAAwB;YACxB,wCAAwC;YACxC,6BAA6B;YAC7B,sCAAsC;SACvC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAErF,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,MAAM,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,WAAW,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,kBAAkB,KAAK,KAAK,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjG,MAAM,sBAAsB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACrD,MAAM,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAChD,MAAM,UAAU,GAAG,UAAU;oBAC3B,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC;wBAC9B,CAAC,CAAC,KAAK,YAAY,CAAC,KAAK,CAAC,GAAG;wBAC7B,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,mBAAmB,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC9C,MAAM,UAAU,GAAG,mBAAmB;oBACpC,CAAC,CAAC,iBAAiB,sBAAsB,aAAa;oBACtD,CAAC,CAAC,iBAAiB,sBAAsB,KAAK,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,gBAAgB,iBAAiB,GAAG,UAAU,EAAE,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/lib/markdown/topic-commands.d.ts

@@ -0,0 +1,8 @@
+import { SfTopic } from '../utils.js';
+import { MarkdownBase } from './markdown-base.js';
+export declare class MarkdownTopicCommands extends MarkdownBase {
+    private topic;
+    private topicMeta;
+    constructor(topic: string, topicMeta: SfTopic, outputDir: string);
+    protected generate(): Promise<string>;
+}

package/lib/markdown/topic-commands.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { join } from 'node:path';
+import { MarkdownBase } from './markdown-base.js';
+export class MarkdownTopicCommands extends MarkdownBase {
+    topic;
+    topicMeta;
+    constructor(topic, topicMeta, outputDir) {
+        const filename = MarkdownBase.file(`cli_reference_${topic}_commands`);
+        super(filename, outputDir);
+        this.topic = topic;
+        this.topicMeta = topicMeta;
+        this.destination = join(outputDir, topic, filename);
+    }
+    generate() {
+        const lines = [];
+        lines.push('');
+        lines.push(`# ${this.topic} Commands`);
+        lines.push('');
+        if (this.topicMeta.description) {
+            lines.push(this.topicMeta.description);
+            lines.push('');
+        }
+        return Promise.resolve(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=topic-commands.js.map

package/lib/markdown/topic-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-commands.js","sourceRoot":"","sources":["../../src/markdown/topic-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAC1B;IAAuB;IAAlD,YAA2B,KAAa,EAAU,SAAkB,EAAE,SAAiB;QACrF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,iBAAiB,KAAK,WAAW,CAAC,CAAC;QACtE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAFF,UAAK,GAAL,KAAK,CAAQ;QAAU,cAAS,GAAT,SAAS,CAAS;QAGlE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAES,QAAQ;QAChB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/lib/markdown/topic-index.d.ts

@@ -0,0 +1,9 @@
+import { CommandClass, SfTopic } from '../utils.js';
+import { MarkdownBase } from './markdown-base.js';
+export declare class MarkdownTopicIndex extends MarkdownBase {
+    private topic;
+    private commands;
+    private topicMeta;
+    constructor(topic: string, commands: CommandClass[], topicMeta: SfTopic, outputDir: string);
+    protected generate(): Promise<string>;
+}

package/lib/markdown/topic-index.js

@@ -0,0 +1,80 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { join } from 'node:path';
+import { punctuate } from '../utils.js';
+import { MarkdownBase } from './markdown-base.js';
+function resolveStateLabel(command) {
+    const deprecated = Boolean(command.deprecated);
+    const state = command.state;
+    if (deprecated)
+        return 'Deprecated';
+    if (state === 'beta')
+        return 'Beta';
+    if (state === 'preview')
+        return 'Developer Preview';
+    if (state === 'closedPilot' || state === 'openPilot')
+        return 'Pilot';
+    return null;
+}
+export class MarkdownTopicIndex extends MarkdownBase {
+    topic;
+    commands;
+    topicMeta;
+    constructor(topic, commands, topicMeta, outputDir) {
+        const filename = MarkdownBase.file(`cli_reference_${topic}`);
+        super(filename, outputDir);
+        this.topic = topic;
+        this.commands = commands;
+        this.topicMeta = topicMeta;
+        this.destination = join(outputDir, topic, filename);
+    }
+    generate() {
+        const lines = [];
+        lines.push('<!-- prettier-ignore-start -->');
+        lines.push('');
+        lines.push(`# ${this.topic} Commands`);
+        lines.push('');
+        if (this.topicMeta.description) {
+            lines.push(this.topicMeta.description);
+            lines.push('');
+        }
+        const sortedCommands = [...this.commands].sort((a, b) => a.id.localeCompare(b.id));
+        for (const command of sortedCommands) {
+            const id = command.id;
+            const commandWithUnderscores = id.replace(/:/g, '_');
+            const commandWithSpaces = id.replace(/:/g, ' ');
+            const isTopicLevelCommand = !id.includes(':');
+            const linkTarget = isTopicLevelCommand
+                ? `cli_reference_${commandWithUnderscores}_command.md`
+                : `cli_reference_${commandWithUnderscores}.md`;
+            const stateLabel = resolveStateLabel(command);
+            const commandDisplay = stateLabel ? `${commandWithSpaces} (${stateLabel})` : commandWithSpaces;
+            const summary = punctuate(command.summary);
+            if (summary) {
+                lines.push(`- **[${commandDisplay}](./${linkTarget})**<br>`);
+                lines.push(`  ${summary}`);
+            }
+            else {
+                lines.push(`- **[${commandDisplay}](./${linkTarget})**`);
+            }
+        }
+        lines.push('');
+        lines.push('<!-- prettier-ignore-end -->');
+        lines.push('');
+        return Promise.resolve(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=topic-index.js.map

package/lib/markdown/topic-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-index.js","sourceRoot":"","sources":["../../src/markdown/topic-index.ts"],"names":[],"mappings":"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"}

package/lib/utils.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from 'node:events';
 import { Command, Interfaces } from '@oclif/core';
 import { AnyJson } from '@salesforce/ts-types';
-export type CommandClass = Pick<Command.Class, 'id' | 'hidden' | 'description' | 'plugin' | 'state' | 'examples' | 'summary' | 'flags' | 'pluginName'> & {
+export type CommandClass = Pick<Command.Class, 'id' | 'hidden' | 'description' | 'plugin' | 'state' | 'examples' | 'summary' | 'flags' | 'pluginName' | 'aliases'> & {
     topic: string;
     subtopic: string;
     longDescription?: string;

package/messages/main.md

@@ -28,7 +28,11 @@ fail the command if there are any warnings
 
 # flags.ditamap-suffix.summary
 
-unique suffix to append to generated ditamap
+unique suffix to append to generated DITA files
+
+# flags.output-format.summary
+
+output format for generated documentation; 'dita' (default) generates DITA XML files, 'markdown' generates Markdown files
 
 # flags.config-path.summary
 

package/npm-shrinkwrap.json

@@ -1,18 +1,18 @@
 {
   "name": "@salesforce/plugin-command-reference",
-  "version": "3.1.107",
+  "version": "3.1.109",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/plugin-command-reference",
-      "version": "3.1.107",
+      "version": "3.1.109",
       "license": "Apache-2.0",
       "dependencies": {
         "@oclif/core": "^4",
         "@salesforce/core": "^8.31.0",
         "@salesforce/kit": "^3.2.6",
-        "@salesforce/sf-plugins-core": "^12.2.22",
+        "@salesforce/sf-plugins-core": "^12.2.24",
         "@salesforce/ts-types": "^2.0.11",
         "chalk": "^5.6.2",
         "debug": "^4.4.3",
@@ -4969,13 +4969,13 @@
       "license": "BSD-3-Clause"
     },
     "node_modules/@salesforce/sf-plugins-core": {
-      "version": "12.2.22",
-      "resolved": "https://registry.npmjs.org/@salesforce/sf-plugins-core/-/sf-plugins-core-12.2.22.tgz",
-      "integrity": "sha512-ApuAXxIwpbJ8i+QooQF8L7z4nz+yJNlkaktbUBxG7LF2KSLKhVgvZjv42Ok1gNPtDnQN9P/hyvVBwDkfSz+6hw==",
+      "version": "12.2.24",
+      "resolved": "https://registry.npmjs.org/@salesforce/sf-plugins-core/-/sf-plugins-core-12.2.24.tgz",
+      "integrity": "sha512-+lc7QMRz19Uk9f3lJO442LrUMvrRrfX6+xe1w42PihWjjoXpF9fZfZ7zk7H2WDF56PTo5SMJMrb5PjneiIrH3Q==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@inquirer/confirm": "^6.0.12",
-        "@inquirer/password": "^5.0.13",
+        "@inquirer/confirm": "^6.1.1",
+        "@inquirer/password": "^5.1.1",
         "@oclif/core": "^4.11.4",
         "@oclif/table": "^0.5.9",
         "@salesforce/core": "^8.31.0",
@@ -4990,25 +4990,25 @@
       }
     },
     "node_modules/@salesforce/sf-plugins-core/node_modules/@inquirer/ansi": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@inquirer/ansi/-/ansi-2.0.5.tgz",
-      "integrity": "sha512-doc2sWgJpbFQ64UflSVd17ibMGDuxO1yKgOgLMwavzESnXjFWJqUeG8saYosqKpHp4kWiM5x1nXvEjbpx90gzw==",
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@inquirer/ansi/-/ansi-2.0.7.tgz",
+      "integrity": "sha512-3eTuUO1vH2cZm2ZKHeQxnOqlTi9EfZDGgIe3BL3I4u+rJHocr9Fz86M4fjYABPvFnQG/gGK551HqDiIcETwU6Q==",
       "license": "MIT",
       "engines": {
-        "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+        "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
       }
     },
     "node_modules/@salesforce/sf-plugins-core/node_modules/@inquirer/confirm": {
-      "version": "6.0.12",
-      "resolved": "https://registry.npmjs.org/@inquirer/confirm/-/confirm-6.0.12.tgz",
-      "integrity": "sha512-h9FgGun3QwVYNj5TWIZZ+slii73bMoBFjPfVIGtnFuL4t8gBiNDV9PcSfIzkuxvgquJKt9nr1QzszpBzTbH8Og==",
+      "version": "6.1.1",
+      "resolved": "https://registry.npmjs.org/@inquirer/confirm/-/confirm-6.1.1.tgz",
+      "integrity": "sha512-eb8DBZcz/2qHWQda4rk2JiQk5h9QV/cVHi1yjt0f69WFZMRFn0sJTye3EAP8icut8UDMjQPsaH5KbcOogefrFQ==",
       "license": "MIT",
       "dependencies": {
-        "@inquirer/core": "^11.1.9",
-        "@inquirer/type": "^4.0.5"
+        "@inquirer/core": "^11.2.1",
+        "@inquirer/type": "^4.0.7"
       },
       "engines": {
-        "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+        "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
       },
       "peerDependencies": {
         "@types/node": ">=18"
@@ -5020,21 +5020,21 @@
       }
     },
     "node_modules/@salesforce/sf-plugins-core/node_modules/@inquirer/core": {
-      "version": "11.1.9",
-      "resolved": "https://registry.npmjs.org/@inquirer/core/-/core-11.1.9.tgz",
-      "integrity": "sha512-BDE4fG22uYh1bGSifcj7JSx119TVYNViMhMu85usp4Fswrzh6M0DV3yld64jA98uOAa2GSQ4Bg4bZRm2d2cwSg==",
+      "version": "11.2.1",
+      "resolved": "https://registry.npmjs.org/@inquirer/core/-/core-11.2.1.tgz",
+      "integrity": "sha512-Qd6GJT1yVyrZZCfN8W2qKF5ApmqryXRhRKCuip8h01x2w/esJQ2XIYc6f9abMIHgKQdBfFTSOdbHRLAhuM09UA==",
       "license": "MIT",
       "dependencies": {
-        "@inquirer/ansi": "^2.0.5",
-        "@inquirer/figures": "^2.0.5",
-        "@inquirer/type": "^4.0.5",
+        "@inquirer/ansi": "^2.0.7",
+        "@inquirer/figures": "^2.0.7",
+        "@inquirer/type": "^4.0.7",
         "cli-width": "^4.1.0",
         "fast-wrap-ansi": "^0.2.0",
         "mute-stream": "^3.0.0",
         "signal-exit": "^4.1.0"
       },
       "engines": {
-        "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+        "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
       },
       "peerDependencies": {
         "@types/node": ">=18"
@@ -5046,21 +5046,21 @@
       }
     },
     "node_modules/@salesforce/sf-plugins-core/node_modules/@inquirer/figures": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@inquirer/figures/-/figures-2.0.5.tgz",
-      "integrity": "sha512-NsSs4kzfm12lNetHwAn3GEuH317IzpwrMCbOuMIVytpjnJ90YYHNwdRgYGuKmVxwuIqSgqk3M5qqQt1cDk0tGQ==",
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@inquirer/figures/-/figures-2.0.7.tgz",
+      "integrity": "sha512-aJ8TBPOGB6f/2qziPfElISTCEd5XOYTFckA2SGjhNmiKzfK/u4ot3v0DUzGVdUnKjN10EqnnEPck36BkyfLnJw==",
       "license": "MIT",
       "engines": {
-        "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+        "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
       }
     },
     "node_modules/@salesforce/sf-plugins-core/node_modules/@inquirer/type": {
-      "version": "4.0.5",
-      "resolved": "https://registry.npmjs.org/@inquirer/type/-/type-4.0.5.tgz",
-      "integrity": "sha512-aetVUNeKNc/VriqXlw1NRSW0zhMBB0W4bNbWRJgzRl/3d0QNDQFfk0GO5SDdtjMZVg6o8ZKEiadd7SCCzoOn5Q==",
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/@inquirer/type/-/type-4.0.7.tgz",
+      "integrity": "sha512-t28inv14nMQ1PhKpsJPY+kEs/c00qzeCOS2gTNRyTjG5d6qsVA2fItxW4hkvGZ5lvanGLdtCzVIx5dwdRpN1+g==",
       "license": "MIT",
       "engines": {
-        "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+        "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
       },
       "peerDependencies": {
         "@types/node": ">=18"

package/oclif.lock

@@ -971,11 +971,6 @@
   resolved "https://registry.yarnpkg.com/@inquirer/ansi/-/ansi-1.0.2.tgz#674a4c4d81ad460695cb2a1fc69d78cd187f337e"
   integrity sha512-S8qNSZiYzFd0wAcyG5AXCvUHC5Sr7xpZ9wZ2py9XR88jUz8wooStVx5M6dRzczbBWjic9NP7+rY0Xi7qqK/aMQ==
 
-"@inquirer/ansi@^2.0.5":
-  version "2.0.5"
-  resolved "https://registry.yarnpkg.com/@inquirer/ansi/-/ansi-2.0.5.tgz#7b7e121f6a0c40128711daf20325e6ff2cdff8b7"
-  integrity sha512-doc2sWgJpbFQ64UflSVd17ibMGDuxO1yKgOgLMwavzESnXjFWJqUeG8saYosqKpHp4kWiM5x1nXvEjbpx90gzw==
-
 "@inquirer/ansi@^2.0.7":
   version "2.0.7"
   resolved "https://registry.yarnpkg.com/@inquirer/ansi/-/ansi-2.0.7.tgz#86de22810cac3ed406ec10f8d66016815b8226b4"
@@ -1019,13 +1014,13 @@
     "@inquirer/core" "^10.3.2"
     "@inquirer/type" "^3.0.10"
 
-"@inquirer/confirm@^6.0.12":
-  version "6.0.12"
-  resolved "https://registry.yarnpkg.com/@inquirer/confirm/-/confirm-6.0.12.tgz#7a317aec813214cec2f5339b9fa0926c20bf0dbe"
-  integrity sha512-h9FgGun3QwVYNj5TWIZZ+slii73bMoBFjPfVIGtnFuL4t8gBiNDV9PcSfIzkuxvgquJKt9nr1QzszpBzTbH8Og==
+"@inquirer/confirm@^6.1.1":
+  version "6.1.1"
+  resolved "https://registry.yarnpkg.com/@inquirer/confirm/-/confirm-6.1.1.tgz#9c6a7d79c6132b2af57fdb75747f056204e55356"
+  integrity sha512-eb8DBZcz/2qHWQda4rk2JiQk5h9QV/cVHi1yjt0f69WFZMRFn0sJTye3EAP8icut8UDMjQPsaH5KbcOogefrFQ==
   dependencies:
-    "@inquirer/core" "^11.1.9"
-    "@inquirer/type" "^4.0.5"
+    "@inquirer/core" "^11.2.1"
+    "@inquirer/type" "^4.0.7"
 
 "@inquirer/core@^10.3.2":
   version "10.3.2"
@@ -1041,19 +1036,6 @@
     wrap-ansi "^6.2.0"
     yoctocolors-cjs "^2.1.3"
 
-"@inquirer/core@^11.1.9":
-  version "11.1.9"
-  resolved "https://registry.yarnpkg.com/@inquirer/core/-/core-11.1.9.tgz#97f099f5217f50f168c12db00ac07f51ab550fbb"
-  integrity sha512-BDE4fG22uYh1bGSifcj7JSx119TVYNViMhMu85usp4Fswrzh6M0DV3yld64jA98uOAa2GSQ4Bg4bZRm2d2cwSg==
-  dependencies:
-    "@inquirer/ansi" "^2.0.5"
-    "@inquirer/figures" "^2.0.5"
-    "@inquirer/type" "^4.0.5"
-    cli-width "^4.1.0"
-    fast-wrap-ansi "^0.2.0"
-    mute-stream "^3.0.0"
-    signal-exit "^4.1.0"
-
 "@inquirer/core@^11.2.1":
   version "11.2.1"
   resolved "https://registry.yarnpkg.com/@inquirer/core/-/core-11.2.1.tgz#54ccd8f7d47852140b6066cbd77d63b2c2b168fd"
@@ -1122,11 +1104,6 @@
   resolved "https://registry.yarnpkg.com/@inquirer/figures/-/figures-1.0.13.tgz#ad0afd62baab1c23175115a9b62f511b6a751e45"
   integrity sha512-lGPVU3yO9ZNqA7vTYz26jny41lE7yoQansmqdMLBEfqaGsmdg7V3W9mK9Pvb5IL4EVZ9GnSDGMO/cJXud5dMaw==
 
-"@inquirer/figures@^2.0.5":
-  version "2.0.5"
-  resolved "https://registry.yarnpkg.com/@inquirer/figures/-/figures-2.0.5.tgz#d12f4889ac6ea7731ebc52bd9c066ca51d8fdee7"
-  integrity sha512-NsSs4kzfm12lNetHwAn3GEuH317IzpwrMCbOuMIVytpjnJ90YYHNwdRgYGuKmVxwuIqSgqk3M5qqQt1cDk0tGQ==
-
 "@inquirer/figures@^2.0.7":
   version "2.0.7"
   resolved "https://registry.yarnpkg.com/@inquirer/figures/-/figures-2.0.7.tgz#f5cc5843732a81304d06a0db4b53cc7dbda15541"
@@ -1165,7 +1142,7 @@
     "@inquirer/core" "^10.3.2"
     "@inquirer/type" "^3.0.10"
 
-"@inquirer/password@^5.0.13":
+"@inquirer/password@^5.1.1":
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/@inquirer/password/-/password-5.1.1.tgz#f21efb614da9c905095262f51781fd2a721fceac"
   integrity sha512-3XBfF7DAsp5qeDsvN5Rd1HmbNokVvEQoUM0QLrRcybC9nX96w3Pbmu7qUsb3IT3J3jBvs2+mTXaKHOUsgHMLzg==
@@ -1243,11 +1220,6 @@
   resolved "https://registry.yarnpkg.com/@inquirer/type/-/type-3.0.10.tgz#11ed564ec78432a200ea2601a212d24af8150d50"
   integrity sha512-BvziSRxfz5Ov8ch0z/n3oijRSEcEsHnhggm4xFZe93DHcUCTlutlq9Ox4SVENAfcRD22UQq7T/atg9Wr3k09eA==
 
-"@inquirer/type@^4.0.5":
-  version "4.0.5"
-  resolved "https://registry.yarnpkg.com/@inquirer/type/-/type-4.0.5.tgz#a02d90e5da8a36dce27ac8e7237a50c99a9003a3"
-  integrity sha512-aetVUNeKNc/VriqXlw1NRSW0zhMBB0W4bNbWRJgzRl/3d0QNDQFfk0GO5SDdtjMZVg6o8ZKEiadd7SCCzoOn5Q==
-
 "@inquirer/type@^4.0.7":
   version "4.0.7"
   resolved "https://registry.yarnpkg.com/@inquirer/type/-/type-4.0.7.tgz#9c6f0d857fe6ad549a3a932343b64e76acb34b10"
@@ -1625,13 +1597,13 @@
   resolved "https://registry.yarnpkg.com/@salesforce/prettier-config/-/prettier-config-0.0.3.tgz#ba648d4886bb38adabe073dbea0b3a91b3753bb0"
   integrity sha512-hYOhoPTCSYMDYn+U1rlEk16PoBeAJPkrdg4/UtAzupM1mRRJOwEPMG1d7U8DxJFKuXW3DMEYWr2MwAIBDaHmFg==
 
-"@salesforce/sf-plugins-core@^12", "@salesforce/sf-plugins-core@^12.2.17", "@salesforce/sf-plugins-core@^12.2.22", "@salesforce/sf-plugins-core@^12.2.6":
-  version "12.2.22"
-  resolved "https://registry.yarnpkg.com/@salesforce/sf-plugins-core/-/sf-plugins-core-12.2.22.tgz#55e6be65e6289e454220065b3554871452da34af"
-  integrity sha512-ApuAXxIwpbJ8i+QooQF8L7z4nz+yJNlkaktbUBxG7LF2KSLKhVgvZjv42Ok1gNPtDnQN9P/hyvVBwDkfSz+6hw==
+"@salesforce/sf-plugins-core@^12", "@salesforce/sf-plugins-core@^12.2.17", "@salesforce/sf-plugins-core@^12.2.24", "@salesforce/sf-plugins-core@^12.2.6":
+  version "12.2.24"
+  resolved "https://registry.yarnpkg.com/@salesforce/sf-plugins-core/-/sf-plugins-core-12.2.24.tgz#ead41c7e4b49a60bc72a52737a2eaacc686ec35c"
+  integrity sha512-+lc7QMRz19Uk9f3lJO442LrUMvrRrfX6+xe1w42PihWjjoXpF9fZfZ7zk7H2WDF56PTo5SMJMrb5PjneiIrH3Q==
   dependencies:
-    "@inquirer/confirm" "^6.0.12"
-    "@inquirer/password" "^5.0.13"
+    "@inquirer/confirm" "^6.1.1"
+    "@inquirer/password" "^5.1.1"
     "@oclif/core" "^4.11.4"
     "@oclif/table" "^0.5.9"
     "@salesforce/core" "^8.31.0"

package/oclif.manifest.json

@@ -63,7 +63,7 @@
         "ditamap-suffix": {
           "char": "s",
           "name": "ditamap-suffix",
-          "summary": "unique suffix to append to generated ditamap",
+          "summary": "unique suffix to append to generated DITA files",
           "default": "unified",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -92,6 +92,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "output-format": {
+          "name": "output-format",
+          "summary": "output format for generated documentation; 'dita' (default) generates DITA XML files, 'markdown' generates Markdown files",
+          "default": "dita",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "dita",
+            "markdown"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -169,5 +181,5 @@
       ]
     }
   },
-  "version": "3.1.107"
+  "version": "3.1.109"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-command-reference",
   "description": "Generate the Salesforce CLI command reference guide",
-  "version": "3.1.107",
+  "version": "3.1.109",
   "author": "Salesforce",
   "bugs": "https://github.com/salesforcecli/plugin-command-reference/issues",
   "type": "module",
@@ -9,7 +9,7 @@
     "@oclif/core": "^4",
     "@salesforce/core": "^8.31.0",
     "@salesforce/kit": "^3.2.6",
-    "@salesforce/sf-plugins-core": "^12.2.22",
+    "@salesforce/sf-plugins-core": "^12.2.24",
     "@salesforce/ts-types": "^2.0.11",
     "chalk": "^5.6.2",
     "debug": "^4.4.3",
@@ -196,6 +196,19 @@
         "messages/**/*.md"
       ],
       "output": []
+    },
+    "test:command-reference-markdown": {
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" commandreference generate --plugins auth --plugins user --output-format markdown --output-dir test/tmp-md",
+      "files": [
+        "src/**/*.ts",
+        "messages/**",
+        "package.json"
+      ],
+      "output": [
+        "test/tmp-md"
+      ],
+      "clean": "if-file-deleted",
+      "cache": false
     }
   }
 }