@sap-ux/create 0.13.138 → 0.13.140

package/dist/cli/add/index.js

@@ -20,27 +20,16 @@ const variants_config_1 = require("./variants-config");
  */
 function getAddCommands() {
     const addCommands = new commander_1.Command('add');
-    // create-fiori add mockserver-config
     (0, mockserver_config_1.addAddMockserverConfigCommand)(addCommands);
-    // create-fiori add smartlinks-config
     (0, smartlinks_config_1.addAddSmartLinksConfigCommand)(addCommands);
-    // create-fiori add cds-plugin-ui5
     (0, cds_plugin_ui_1.addAddCdsPluginUi5Command)(addCommands);
-    // create-fiori add inbound-navigation-config
     (0, navigation_config_1.addInboundNavigationConfigCommand)(addCommands);
-    // create-fiori add cards-editor
     (0, cards_generator_1.addCardsEditorConfigCommand)(addCommands);
-    // create-fiori add model
     (0, new_model_1.addNewModelCommand)(addCommands);
-    // create-fiori add annotations-to-odata
     (0, annotations_to_odata_1.addAnnotationsToOdataCommand)(addCommands);
-    // create-fiori add html
     (0, html_1.addAddHtmlFilesCmd)(addCommands);
-    // create-fiori add component-usages
     (0, component_usages_1.addComponentUsagesCommand)(addCommands);
-    // create-fiori add deploy-config
     (0, deploy_config_1.addDeployConfigCommand)(addCommands);
-    // create-fiori add variants-config
     (0, variants_config_1.addAddVariantsConfigCommand)(addCommands);
     return addCommands;
 }

package/dist/cli/change/index.js

@@ -10,10 +10,9 @@ const change_inbound_1 = require("./change-inbound");
  * @returns - commander command containing change <feature> commands
  */
 function getChangeCommands() {
-    const addCommands = new commander_1.Command('change');
-    // create-fiori change data-source
-    (0, change_data_source_1.addChangeDataSourceCommand)(addCommands);
-    (0, change_inbound_1.addChangeInboundCommand)(addCommands);
-    return addCommands;
+    const changeCommands = new commander_1.Command('change');
+    (0, change_data_source_1.addChangeDataSourceCommand)(changeCommands);
+    (0, change_inbound_1.addChangeInboundCommand)(changeCommands);
+    return changeCommands;
 }
 //# sourceMappingURL=index.js.map

package/dist/cli/generate/index.js

@@ -8,7 +8,6 @@ const adaptation_project_1 = require("./adaptation-project");
  */
 function getGenerateCommands() {
     const genCommands = new commander_1.Command('generate');
-    // create-fiori generate adaptation-project
     (0, adaptation_project_1.addGenerateAdaptationProjectCommand)(genCommands);
     return genCommands;
 }

package/dist/cli/index.d.ts

@@ -1,7 +1,15 @@
+import { Command } from 'commander';
 /**
  * Run the command line interface.
  *
  * @param argv - arguments, typically 'process.argv'
  */
 export declare function handleCreateFioriCommand(argv: string[]): void;
+/**
+ * Generates the full MCP specification for a top-level commander program.
+ *
+ * @param cmd - The main Commander program instance.
+ * @returns A JSON string representing the CLI's capabilities.
+ */
+export declare function generateJsonSpec(cmd: Command): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleCreateFioriCommand = handleCreateFioriCommand;
+exports.generateJsonSpec = generateJsonSpec;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const commander_1 = require("commander");
@@ -42,26 +43,108 @@ function handleCreateFioriCommand(argv) {
  * @returns - commander program
  */
 function getCommanderProgram() {
+    const logger = (0, tracing_1.getLogger)();
     const program = new commander_1.Command();
     const version = getVersion();
     program.description(`Configure features for Fiori applications and projects. (${version})`);
+    program.addHelpText('after', `\nExample Usage:
+  'npx --yes @sap-ux/create@latest add --help'              Get available subcommands for the 'add' command.
+  'npx --yes @sap-ux/create@latest add html --help'         Get available options for the 'add html' command.
+  'npx --yes @sap-ux/create@latest add html --simulate'     Execute the 'add html' command using the 'simulate' option.\n`);
+    program.option('--generateJsonSpec', 'Output the command structure as JSON');
+    program.action((options) => {
+        if (options.generateJsonSpec) {
+            logger.info(generateJsonSpec(program));
+        }
+        else if (options.V || options.version) {
+            logger.info(version);
+        }
+        else {
+            program.outputHelp();
+        }
+    });
     program.version(version);
     // Handler for create-fiori generate <feature> ..
-    program.addCommand((0, generate_1.getGenerateCommands)());
+    const genCommands = (0, generate_1.getGenerateCommands)();
+    genCommands.description(`Generate adaptation projects.
+                    Available Subcommands: ${getFeatureSummary(genCommands.commands)}\n`);
+    program.addCommand(genCommands);
     // Handler for create-fiori add <feature> ..
-    program.addCommand((0, add_1.getAddCommands)());
+    const addCommands = (0, add_1.getAddCommands)();
+    addCommands.description(`Add features to an SAP Fiori app.
+                    Available Subcommands: ${getFeatureSummary(addCommands.commands)}\n`);
+    program.addCommand(addCommands);
     // Handler for create-fiori convert <feature> ..
-    program.addCommand((0, convert_1.getConvertCommands)());
+    const convertCommands = (0, convert_1.getConvertCommands)();
+    convertCommands.description(`Convert existing SAP Fiori applications.
+                    Available Subcommands: ${getFeatureSummary(convertCommands.commands)}\n`);
+    program.addCommand(convertCommands);
     // Handler for create-fiori remove <feature> ..
-    program.addCommand((0, remove_1.getRemoveCommands)());
+    const removeCommands = (0, remove_1.getRemoveCommands)();
+    removeCommands.description(`Remove features from existing SAP Fiori applications.
+                    Available Subcommands: ${getFeatureSummary(removeCommands.commands)}\n`);
+    program.addCommand(removeCommands);
     // Handler for create-fiori change <feature> ..
-    program.addCommand((0, change_1.getChangeCommands)());
-    // Override exit so calling this command without arguments does not result in an exit code 1, which causes an error message when running from npm init
-    program.exitOverride();
+    const changeCommands = (0, change_1.getChangeCommands)();
+    changeCommands.description(`Change existing adaptation projects.
+                    Available Subcommands: ${getFeatureSummary(changeCommands.commands)}`);
+    program.addCommand(changeCommands);
     return program;
 }
 /**
- * Return the version from package.json.
+ * Return a summary of the subcommands from the provided commands.
+ *
+ * @param commands - List of commands
+ * @returns - Summary of the subcommands
+ */
+function getFeatureSummary(commands) {
+    const subCommandNames = commands.map((cmd) => cmd.name());
+    return subCommandNames.join(', ');
+}
+/**
+ * Parses a commander.Option object into a simpler format for the JSON spec.
+ *
+ * @param {Option} opt - The Commander Option object.
+ * @returns {object} A simplified option object.
+ */
+function parseOption(opt) {
+    return {
+        name: opt.flags,
+        description: opt.description,
+        required: opt.required,
+        ...(opt.defaultValue !== undefined && { defaultValue: opt.defaultValue })
+    };
+}
+/**
+ * Recursively parses a commander.Command object and its subcommands.
+ *
+ * @param cmd - The Commander Command object to parse.
+ * @returns A structured object representing the command.
+ */
+function parseCommand(cmd) {
+    const options = 'options' in cmd ? cmd.options : [];
+    return {
+        name: cmd.name(),
+        description: cmd.description(),
+        ...(options?.length > 0 && { options: options.map(parseOption) }),
+        ...(cmd.commands?.length > 0 && { subcommands: cmd.commands.map(parseCommand) })
+    };
+}
+/**
+ * Generates the full MCP specification for a top-level commander program.
+ *
+ * @param cmd - The main Commander program instance.
+ * @returns A JSON string representing the CLI's capabilities.
+ */
+function generateJsonSpec(cmd) {
+    const spec = {
+        description: cmd.description(),
+        commands: cmd.commands.map(parseCommand)
+    };
+    return JSON.stringify(spec, null, 2);
+}
+/**
+ * Return the version from the package.json file.
  *
  *  @returns - version from package.json
  */

package/dist/cli/remove/index.js

@@ -10,7 +10,6 @@ const mockserver_config_1 = require("./mockserver-config");
  */
 function getRemoveCommands() {
     const removeCommands = new commander_1.Command('remove');
-    // create-fiori remove mockserver-config
     (0, mockserver_config_1.addRemoveMockserverConfigCommand)(removeCommands);
     return removeCommands;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sap-ux/create",
   "description": "SAP Fiori tools module to add or remove features",
-  "version": "0.13.138",
+  "version": "0.13.140",
   "repository": {
     "type": "git",
     "url": "https://github.com/SAP/open-ux-tools.git",
@@ -30,19 +30,19 @@
     "mem-fs": "2.1.0",
     "mem-fs-editor": "9.4.0",
     "prompts": "2.4.2",
-    "@sap-ux/abap-deploy-config-inquirer": "1.6.32",
     "@sap-ux/abap-deploy-config-writer": "0.2.23",
-    "@sap-ux/adp-tooling": "0.16.6",
-    "@sap-ux/app-config-writer": "0.6.46",
+    "@sap-ux/adp-tooling": "0.16.7",
+    "@sap-ux/abap-deploy-config-inquirer": "1.6.32",
     "@sap-ux/cap-config-writer": "0.12.16",
+    "@sap-ux/app-config-writer": "0.6.46",
     "@sap-ux/logger": "0.7.0",
     "@sap-ux/mockserver-config-writer": "0.9.21",
     "@sap-ux/odata-service-writer": "0.27.25",
-    "@sap-ux/preview-middleware": "0.23.29",
+    "@sap-ux/preview-middleware": "0.23.30",
     "@sap-ux/project-access": "1.32.4",
     "@sap-ux/system-access": "0.6.21",
     "@sap-ux/ui5-config": "0.29.8",
-    "@sap-ux/flp-config-inquirer": "0.4.41"
+    "@sap-ux/flp-config-inquirer": "0.4.42"
   },
   "devDependencies": {
     "@types/diff": "5.0.9",